mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-10-15 12:15:16 +00:00
03d87a4e21
记录一次关于「主管式多仓库开发」的完整设计讨论，供接手者使用。
**状态是设计稿，尚未实现** —— 文档头部已明确标注。
## 为什么写这篇
用户提出：以后由 HomeAgent 作开发主管，人只与主管对接；主管通过一个
commondev 插件管理多平台凭据、项目/分支台账、临时工作目录，并把「拉起
编码 agent → 改 → 自审 → 复审 → 复核 → 提 PR」串起来。
## 已核实的事实（均有可复现命令，见文档 §10 自检清单）
- 本机有 Gitea 1.24.2；TrueAgent 自身 remote 为 gitcode + github
- 插件凭据现状：`config_<plugin>` 明文、`config.db` 权限 644
- **拉起 agent 的三条路**（关键）：
- `pi -p` ✓ cwd = 进程 cwd（已实测读出 marker）
- `dsh headless` 逻辑同 CLI，本机凭据失效
- `a2a_query`/`acp_query` ✗ **参数里没有 cwd**，且只对**已在运行**的
agent 生效 —— A2A/ACP 是长驻 agent 模型，与「按任务拉起」不匹配
- 端口 14010/14011 由 pi-web-sessiond 监听，**不是** general pi 的能力
- 内核 `spawn_child` 与本题无关（它是工作式轻量子，参数只有 task/max_turns）
- `core.agent.workdir` 是**全局单值**且只是 cmd_run 的 fallback ——
前序讨论中「给专属 agent 配它」的说法是错的
## 核心设计主张
1. **复核必须两步：正向 + 变异**。用户原话「我定义过单元测试后，插件复核即可」
隐含了「GREEN = 改对了」这个不成立的假设 —— 插件只能跑预先写下的判据，
判据没覆盖的 bug 照样打勾。自动化不会发现假绿，只会让假绿跑得更快更可信。
文档引用了本仓当日实证（协议判据 M5 首轮未报红）作为依据。
2. **主管复审审的是「判据够不够」，不是逐行读 diff** —— 否则主管会变成
更贵的高级码农。
3. **权限模型要让「必须有主管复审」成为机制而非礼貌**：执行侧凭据只能 push
`feat/*`、不能 push main；主管侧才能合 PR。
4. **落地顺序**：第 0 刀先修「能拉起 agent」（当前成功率存疑，与 QQ 会话中
agent 自身遭遇的 403/503 同源），再谈单平台单项目跑通一条真实链路；
测试模板库放最后（它最容易写，也最容易变成摆设）。
文档还列了 5 个需用户拍板的未决问题（独立仓库 vs worktree、主管自己的模型
可用性、判据落地形态、并行任务间依赖、责任边界）。