🎉 init: 小龙的工作空间

research/hermes-agent-study.md

@@ -0,0 +1,72 @@
+# Hermes Agent 深挖笔记（第二层）
+
+> 2026-05-31 下午
+> 重点：委派系统 / Curator / Kanban / 记忆插件实现
+
+## 1. 委派（Subagent）系统 — delegate_tool.py
+
+**设计思想：**
+
+- **嵌套深度控制**（max_spawn_depth = 1-3），防止无限递归委派
+- **Orchestrator 角色**：深度-1 的子 Agent 也可以产生自己的 Worker
+- **心跳监控**：每 30s 父进程检查子 Agent 活跃状态，450s 空闲或 1200s 卡住一个工具 → 标记为 stale
+- **受限工具集**：子 Agent 永远不能访问 delegate_task / clarify / memory / send_message / execute_code
+- **工具集继承+扩展**：父工具的 composite toolset 自动展开匹配子任务请求
+- **ThreadPoolExecutor** 实现并行执行
+
+**迁移价值**：高。这是真正的多 Agent 协作模式，比我的简单"拆解"更深一层——它明确了 Agent 间的信任边界和监控机制。
+
+## 2. Curator 后台维护系统 — agent/curator.py
+
+**设计思想：**
+
+- **空闲触发**（不是 cron 定时），Agent 空闲时自动运行
+- **Skill 生命周期管理**：pin（固定）/ archive（归档）/ consolidate（合并）/ patch（打补丁）
+- **永不删除** — 只归档，可恢复
+- **独立客户端** — 不接触主会话的 prompt cache，用 auxiliary client
+- **持久状态** — last_run_at、时长、summary 存储在 `.curator_state`
+
+**迁移价值**：中高。后台维护模式很适合"自改进循环"的自动化。
+
+## 3. Kanban 项目追踪系统 — hermes_cli/kanban_db.py
+
+**设计思想：**
+
+- **SQLite 多板** — 不同项目用不同 board，完全隔离
+- **CAS 并发控制**（Compare-and-Swap）— WAL 模式 + BEGIN IMMEDIATE，多 Worker 同时认领任务不会冲突
+- **多 Profile 协调** — 不同 Hermes profile 共享同一个 board
+- **Env 解析链**：参数 > 环境变量 > 配置文件 > 默认值
+- **Worker 隔离** — 子 Agent 只看到自己的 board
+
+**迁移价值**：中。对于大项目的进度追踪很有参考价值。
+
+## 4. 真实记忆插件实现 — plugins/memory/
+
+**验证了 MemoryProvider 抽象基类模式：**
+
+| 插件 | 特点 | 数据存储 |
+|------|------|----------|
+| Honcho | AI-native 记忆，语义搜索、peer profile、dialectic Q&A、conclusions | 远程 API |
+| Hindsight | 基于时间线的记忆回顾 | SQLite 本地 |
+| Mem0 | 新一代 AI 记忆 | 远程 API |
+| Supermemory | 记忆管理 | 本地文件 |
+| Byterover | 字节级记忆 | 自定义格式 |
+| OpenViking | 维京记忆系统 | SQLite |
+| RetainDB | 持久化数据库 | SQLite |
+| Holographic | 全息记忆（向量存储 + 检索） | 本地 + 向量 |
+
+**共同模式：**
+- 都实现了 MemoryProvider ABC（initialize / prefetch / sync_turn / get_tool_schemas / shutdown）
+- 配置解析链：profile-local > global > env var
+- Profile 隔离：每个 Hermes profile 有独立身份
+
+**迁移价值**：高。验证了我的记忆系统插件化方向是对的。
+
+## 5. 值得移植到我的系统的模式
+
+1. **子 Agent 心跳监控** — 委派任务不应盲目等待，需要超时 + 活跃检测
+2. **Orchestrator 角色** — 不是所有 Agent 都平级，可以有"组长 Agent"来协调
+3. **空闲触发后台任务** — 不是所有维护都需要定时，空闲时运行更省心
+4. **永不删除只归档** — 技能、记忆、项目的安全策略
+5. **CAS 并发控制** — 多 Agent 同时操作同一资源时的协调模式
+6. **配置解析链** — 参数 > 环境变量 > 文件 > 默认，确定的优先级