FirstMate：助手工作组、持久证据与交付授权
FirstMate 部署：区分代码目录、私有 home 和会话后端
把它作为代理运行环境部署，而非普通网站服务；明确私有状态、凭据范围和版本升级方式。
你将学会
- 部署的是运行环境，不是网站端口
- 把能力选择和私有数据分开管理
- 升级和恢复时保留证据
开始前需要
- 理解 Git 工作树与拉取请求
- 理解终端助手和凭据权限范围
定义交付约定，检查状态与授权证据，并避免宣称未经验证的运行保证。
先看结论
- 代码检出与私有运行 home 的职责不同。
- 固定版本中各后端成熟度并不一致。
- 远程路径失效不授权创建本地替身。
部署的是运行环境，不是网站端口
仅仅克隆 FirstMate，并不会产生一个需要对外开放 HTTP 端口的应用服务。文档基线为 macOS 或 Linux、Git、已认证的 GitHub CLI，以及具备后端依赖的受支持助手。参考后端是 tmux，不能因为脚本看起来通用，就推断原生 Windows 也受支持。
受 Git 跟踪的代码根目录保存共享指令和脚本，每个有效 FM_HOME 则承载私有运行目录。配置文档把持久记录归到 data，运行协调归到 state，本地选择归到 config，项目克隆归到 projects。因此，仅备份代码并不能保存整个工作组的运行历史。
把能力选择和私有数据分开管理
应把有效 home 当作敏感目录：任务说明、报告、元数据和可选 Relay 产物都可能暴露项目细节。不要把私有状态纳入公开仓库，并制定访问和保留规则。文档中的 gitignore 布局有助于避免误跟踪，但不等于加密，也不是完整备份策略。
试用时明确选定后端并记录身份。架构文档把 tmux 作为参考实现，Herdr 拥有必需的 CI 测试通道，而 zellij、Orca 和 cmux 仍属于实验性任务启动适配器。这些上游覆盖等级不能互换；本版本也不能把 Codex App 选作运行后端。
升级和恢复时保留证据
把代码提交号、有效 home 和后端一起记录。升级前按本地规则保存可恢复的私有状态快照，并在任务静止时审阅变更。不要为了清除一个看不懂的状态直接删除 home 或工作树，任务所有权和未落地改动可能仍依赖其中记录。
可选二副使用隔离 home，可以位于本机或 SSH 可达主机。远程路径不可用时，不能悄悄用一个本地 home 替代。先验证本地运行，再单独测试远程故障。本篇没有执行远程配置、回滚或备份恢复，相关内容属于部署准备指导。
如何选择
| 比较维度 | 方案 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
确认有效 home 并保护私有状态。
- 3
升级前记录版本及恢复证据。
- 4
把远程验证与本地基础试用分开。
可复制示例
{
"部署记录示例": true,
"源码版本": "b182d0f908b78d08c7ccb8dce3775bdca8c5d657",
"有效Home": "自行选择私有路径",
"后端": "tmux",
"开启远程二副": false,
"已测试恢复": false
}常见问题
需要开放哪个服务端口？
发行目录本身不是网站服务部署；可选集成需要另行评估。
gitignore 能保护机密报告吗？
它帮助避免跟踪文件，但不会加密内容或限制机器访问。
资料来源
- FirstMate / README.md来源核查 2026-09-14
- FirstMate / docs/configuration.md来源核查 2026-09-14
- FirstMate / docs/architecture.md来源核查 2026-09-14