FirstMate：助手工作组、持久证据与交付授权
先做只读 FirstMate 证据面板，再考虑自动化控制
设计展示任务身份、观察来源和合并凭据的学习项目，避免状态页面悄悄变成未获授权的控制台。
你将学会
- 从证据视图开始，不急着放控制按钮
- 复用身份匹配知识，不夸大兼容范围
- 测试页面能否拒绝编造确定性
开始前需要
- 理解 Git 工作树与拉取请求
- 理解终端助手和凭据权限范围
定义交付约定，检查状态与授权证据，并避免宣称未经验证的运行保证。
先看结论
- 只读证据视图必须保留未知状态。
- 合成凭据测试不验证真实 home 解析。
- 控制动作需要单独设计授权流程。
从证据视图开始，不急着放控制按钮
一个有价值的学习扩展，是为合成任务记录制作本地只读面板，显示任务身份、运行代次、端点观察、语义判定和最近消费的唤醒证据。这是我们的项目建议，不是宣称 FirstMate 已经提供的功能，也不代表上游路线图。
不要仅依据终端存在就显示统一的绿色状态。应展示未知观察及时间，并区分等待审阅的报告和已交付修改。对于合并活动，在证据支持时分别显示已接受、已排队、已落地和未确认，不要推断缺失的状态转换。
复用身份匹配知识，不夸大兼容范围
配套 JavaScript 教学模型解析授权辅助库的六行结构，并匹配规范请求元组。可以输入匹配与错配的合成凭据，让陈旧归因变得可见。模型刻意不是文件读取器，也不是 FirstMate 全部私有状态结构的验证器。
真正集成前，需要版本化解析器、安全路径处理、快照一致性和访问控制，再考虑读取敏感 home；还必须遵守记录生产者的锁约定。不能因为合成测试通过，就把这个学习原型直接指向正在工作的真实工作组。
测试页面能否拒绝编造确定性
安排旧代次、缺失语义记录、请求编号错配和已接受但未确认合并等案例。视图应保留原观察并解释为何无法得出结论。未来如果增加控制按钮，需要独立授权与生命周期设计，不能作为只读查看器的一项顺手便利被混入。
静态表格和二维 SVG 足以解释这些关系。Three.js 工作组场景可以作为未来可选展示，但关键证据必须在没有动画时仍能以文字读取。第一里程碑是忠实解释状态，而不是制造更精致的进度观感。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
创建合成任务及凭据记录。
- 2
分别显示身份、观察来源和不确定性。
- 3
测试过期与矛盾观察。
- 4
第一阶段不提供任何修改入口。
可复制示例
{
"项目建议": true,
"输入": "合成快照",
"模式": "只读",
"显示未知状态": true,
"访问真实Home": false,
"控制按钮": false
}常见问题
上游已经带有这个面板吗？
没有。这是本系列提出的学习扩展。
教学模型能安全解析整个真实 home 吗？
不能。它只处理合成凭据字符串，不实现文件系统、锁或完整状态结构检查。
资料来源
- FirstMate / docs/architecture.md来源核查 2026-09-14
- FirstMate / docs/configuration.md来源核查 2026-09-14
- FirstMate / bin/fm-merge-authority-lib.sh来源核查 2026-09-14