Hermes 项目路由与工程体系重构 — 全景说明
解决三大困扰：Discord 项目上下文聚焦 · USER/MEMORY 防暴涨 · hermes/CC/codex 各司其职
设计定稿 2026-08-26
实施未开始（等你确认）
hermes 运行中未受影响
〇、待你确认（睡醒先看这 4 项，其余都按设计定稿）
⏰ 4 个决策项状态（2026-08-26 深夜确认）
- ① Discord 频道清单：待你睡醒后逐个定（操作表见第三节）
- ② 有效期：✅ 已确认 会话 24h + Discord 线程归档 3 天
- ③ 升级冻结：✅ 已确认 实施+观测期间不升级 hermes
- ④ 项目处置：✅ 已确认 全按建议（电子员工合并暂缓 / web-security 归档 / ai-game+tri-terminal 留观 / dsh 持续关注）
睡醒后另需你逐项处理的（不阻塞实施）：⑤历史线程 44 条逐个勾决（见第五节）⑥天气 cron×3 删除确认 ⑦skills 目录 git init 确认 ⑧观测阈值 7 点位定稿。
一、主线概览
困扰 ① 聚焦难
频道=项目、线程=迭代、会话 24h 自动重置、STATE.md困扰 ② 记忆暴涨
写入判定问句 + 项目内容下沉工程目录 + governor 每周治理 + 水位告警困扰 ③ 越权
单通道执行：一切工程任务走 CC，hermes 无工程判定（违规模式结构性消失）五条不变量（任何档位不豁免）
① 工程任务必委派 CC② 必有任务卡③ 必 codex 审查④ 必更新 STATE.md⑤ 交付必实测
档位（CC 判定、codex 审档、hermes 不判）
| 档 | 适用 | 流程 |
|---|---|---|
| T1 | 小改动（不影响需求/设计事实） | 卡内一句话设计，不碰活文档 |
| T2 | 常规迭代（多数工作） | 卡 + 活文档增量补丁（验收标准含"文档同步条"） |
| T3 | 建档/架构/多方案裁决/调研毕业 | 全流程 + worktree |
蜂群模式保留：任务可拆 ≥4 低耦合 slot 时，并行 CC worker + collector.py 程序化汇合（禁止 LLM 转述中间结果）。
二、工作原理（全景时序）
2.1 一次迭代的完整时序
你（Discord）
项目频道开新线程线程名 = 迭代名
如 2026-08-26-登录重构
→
hermes ①
频道→项目映射命中线程名→迭代目录
不存在则建 features/<name>/
回执确认 + STATE.md 登记
→
hermes ②
写任务卡（目标/背景/验收标准
不判档）
cc-delegate 后台委派
→
CC
读卡 → 判档并记录理由T3 才开 worktree
≥4 slot 时蜂群并行
完成=代码+文档补丁+done 报告
→
codex
审查三件：①验收标准达成
②档位判定恰当
③文档同步一致
→
hermes ③
复核 STATE.md 更新收尾摘要 ≤200 字
通知你结果
→
归档
worktree 合并删除feature→archive/
全局 REQ/DF 整合
产物→deliverables/
2.2 消息如何映射到项目（确定性解析，不用关键词猜）
消息 → 频道 ID → project-index 频道列 = 本地项目路径
→ 线程名 → 迭代目录名 → features/<name>/（事实）+ worktree（代码）
→ 无迭代线程：新需求→建迭代；闲聊→只答不建
2.3 会话丢失恢复流
24h 闲置 → hermes 会话自动重置（notify 通知你：线程里发消息 + 上下文提示）
→ 你说"列出迭代"或直接报项目名 → hermes 读 STATE.md feature 列表
→ 你选一个 → hermes 读该迭代 REQ/DF + worktree 事实 → 继续
2.4 hermes 的 USER.md / MEMORY.md 工作期间记什么、何时清
| 时刻 | USER.md | MEMORY.md |
|---|---|---|
| 迭代工作中 | 基本不动（仅你纠正偏好时写） | 写入判定问句 |
| 每轮注入 | 全文 | 全文（所以必须瘦） |
| 每周日 21:00 | governor | |
| 水位 ≥80% | 周报页黄色告警条（不自动删） | |
| 会话 24h 重置 | 不清 memory——memory 是持久层，会话才是耗材 | |
2.5 工程目录内容变化时序
迭代启动 hermes：features/<name>/{raw, REQUIREMENTS, DESIGN} + STATE.md 登记行
执行中 CC：worktree 代码 + feature 分支 REQ/DF 增量 + .cc/tasks/ 卡
收尾 hermes：STATE.md 进度；CC：全局 REQ/DF 补丁
归档 CC：worktree 合并删除；hermes：feature→archive/；产物→deliverables/
三、Discord 结构操作表
| 层级 | 映射 | 命名格式 | 谁来设 | 有效期 |
|---|---|---|---|---|
| 频道 | 项目 | 项目名（如 ai-collection-call） | 你建（Discord UI） | 永久 |
| 线程（子区） | 迭代 | YYYY-MM-DD-<feature>，与迭代目录同名 | 你开线程命名；hermes 回执确认 | 闲置 3 天归档（服务器设置，你改） |
| 会话 | 工作记忆 | —（自动） | hermes 配置（我改） | 闲置 24h 自动重置（notify 通知） |
你的 Discord 操作步骤（频道确认后执行）
- ① Discord 服务器设置 → 线程自动归档：改为 3 天
- ② 新建项目频道（清单见〇-①）
- ③ 每个新频道发一句："绑定项目 X" → hermes 写入 project-index 频道列
- ④ 新迭代：在项目频道开线程，名字按迭代格式；hermes 回执后即绑定
- ⑤ 旧迭代恢复：在项目频道开同名线程 → hermes 按名找到迭代目录续上
四、项目盘点（11 项处置，④已确认全按建议）
| 项目 | 处置建议 | 频道 | 说明 |
|---|---|---|---|
| ai-collection-call（车贷催收·公司） | 继续做 | ✅ 建 | 活跃工程，D10 迭代进行中 |
| wechat-qa-bot（保时捷问答·公司） | 继续做 | ✅ 建 | 活跃工程 |
| swim-member-manager（游泳馆·个人客户） | 继续做 | ✅ 建 | 活跃工程，双端并行 |
| taste-extractor | 升级立项 | 可选 | 决策偏好基础设施：埋点+提取+确认三组件，T3 立项 |
| hermes-evolution | 正式项目化 | 可选 | 本次改造=其第一 feature；观测/治理/升级管理归属之 |
| ai-employee-research + 电销自动化/数字员工 | 合并暂缓 | 不建 | 合并为"电子员工"项目，下一阶段重点 |
| ai-game-farming | 留观 | 不建 | 后续可能立项赚钱小游戏 |
| tri-terminal-work-phone | 留观 | 不建 | 后续出报告方案（deliverables 内容） |
| deepseek-harness-research | 持续关注 | 不建 | hermini + 北京 VPS 试用 |
| web-security-plan | 归档 | 不建 | 33 场景方案已交付 |
| 天气 cron×3 / 其他系统项 | 待确认删除 | — | 体检 P12，睡醒后确认 |
五、历史线程盘点（44 条，⑤逐个勾决）
处置说明
- 废弃=你在 Discord 删除线程（无内容价值）
- 归档=留在原地自然归档（有内容但已完成，不搬）
- 合并=摘要落进对应项目文档后删除（关联项目的旧迭代）
- 重新激活=在对应项目频道开同名线程，hermes 恢复流续上（进行中的迭代）
| 线程 | 最后活跃 | 消息 | 建议处置 | 去向 |
|---|
数据源：state.db 会话聚合（2026-08-26 实测）。处置建议为初判，你勾决时以实际记忆为准。
六、实施工作清单（12 项）
| # | 事项 | 谁 | 时机/状态 |
|---|---|---|---|
| 1 | 设计文档 + HTML 全景（本页）+ 项目/线程盘点表 | 我（MBP 零干扰） | 已完成 |
| 2 | metrics-observer.py + cron（baseline 采集先行） | 我 | 闲置窗口 |
| 3 | config：session_reset 24h+notify；auxiliary 显式配 v4-flash | 我 | 闲置窗口（②确认后） |
| 4 | venv 装 websockets；cc-switch smoke 落盘 stderr | 我 | 闲置窗口 |
| 5 | blueprint v3 修订 + USER/MEMORY 条目修订 | 我 | 闲置窗口（避开 hermes 写 memory） |
| 6 | Discord：建频道 + 线程归档 3 天 | 你 | ①确认后 |
| 7 | 频道绑定（"绑定项目 X"） | 你+hermes | 频道建好后 |
| 8 | 历史线程勾决执行 | 你决策/分工执行 | 盘点表交付后 |
| 9 | 项目补齐（只对"继续做"项目） | 我（委派 CC 逐卡） | ④确认后 |
| 10 | 工作台页面 + 项目状态总览 cron | 我 | 第 2 批 |
| 11 | 观察期：baseline → 改造 → 对比 → B4 硬拦截决策 | 观测自动+你决策 | 第 4 批 |
| 12 | 哨兵修复、bak/cron 清理、request_dump 清理、update-check 误报修复 | 我 | 第 4 批（部分需你确认） |
七、观测体系（埋点先于改造，baseline 1 周）
| # | 点位 | 目标 | 异常阈值（草案） |
|---|---|---|---|
| ① | memory 水位+日增量 | 验证写入判定 | 日增量 >200 字符 ×3 天 |
| ② | 拒绝写入/项目关键词违规写入 | 验证纪律 | 违规 >2 次/周 |
| ③ | 委派合规率（hermes 直接改工程文件 vs 委派） | 验证单通道 | 合规率 <90% ×2 天 |
| ④ | 会话数量/重置/压缩次数 | 验证 TTL+聚焦 | 重置后 24h 内再重置 |
| ⑤ | T1/T2/T3 分布 + codex 档位驳回率 | 验证判档质量 | 驳回率 >30% |
| ⑥ | 响应耗时分布 | 验证"快" | P95 >300s |
| ⑦ | 错误分类趋势 | 全系统健康 | 单类 >50 条/天 |
闭环：异常 → 自动生成进化提案 Pxxxx + 周报页标红 + hermes 通知 → 你确认 → 实施。观察者=脚本，决策者=你。
八、版本与升级策略
✅ 无新版可升：PyPI 最新 = 0.19.0 = 已安装。0.19.0（首 token 延迟 -80%）的收益在 08-25 cwd 遮蔽修复后已生效。
🔒 升级冻结：实施（~1 周）+ 观测（~2-3 周）期间不升级（已确认无自动升级机制）。
📋 未来升级：观测评估完成后，作为 hermes-evolution 独立 T3 任务（08-14 预验证 playbook）。
🐛 附带：check_hermes_update 误报 v0.0.0 的 bug，归属 hermes-evolution 升级管理修复。
附录A · 设计文档
完整设计（含体检报告 P1-P14、四法论证、覆盖矩阵）：
docs/superpowers/specs/2026-08-26-hermes-project-routing-redesign-design.md
hermes-ops 仓库已提交。原始材料将落 hermes-evolution/features/2026-08-26-hermes-routing-redesign/raw/。
附录B · 术语表
| 术语 | 解释 |
|---|---|
| 迭代（feature） | 一次版本级开发任务，对应一个线程 + 一个 features/YYYY-MM-DD-<name>/ 目录 |
| 活文档 | REQUIREMENTS.md + DESIGN.md，随迭代增量补丁，始终全局最新 |
| STATE.md | 项目状态真相源（.cc/），含 feature 列表（+worktree 路径+状态） |
| worktree | git 工作树副本，每个进行中 feature 开一个，隔离开发 |
| governor | memory-governor.py 每周治理：删死指针/去重/下沉/提案 |
| 写入判定问句 | "这条是否约束未来推理？"否→不写 memory |
| 单通道 | 所有工程任务一律走 CC，hermes 无工程判定权 |
| 档位 T1/T2/T3 | CC 判定的任务深度：小改动/常规迭代/建档级 |
| 蜂群模式 | swarm-execution：≥4 低耦合 slot 并行 CC worker + collector 汇合 |
| TTL | Time To Live：会话闲置 24h 重置；线程闲置 3 天归档 |
| deliverables/ | 对外输出的中间/非主线产物（原型/流程图/演示页） |
| 哨兵 | sentinel.json 模型切换状态（当前已死 13 天，第 4 批修复） |
| 四法 | 第一性原理 + 对抗性验证 + 剃刀原理 + 双向钢人 |