MetonaTeam/metona-ollama-desktop
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: 根据 v5.1.3 实际代码更新全部 docs 文件

Browse Source 
- BUILD.md: checkout 分支 v5.1.1→v5.1.3，any 计数修正
- DEVELOPMENT.md: 目录结构更新（tool-handlers 拆分、新服务文件），
  工具数 25→38，数据库 6→7 表，新增 browser/mcp/skill/cron/sub-agent
- OPENCLAW-HERMES-ANALYSIS.md: 10 个路线图功能标记已实现状态，
  更新优先级表和待实施清单
- HERMES-AGENT-DEEP-STUDY.md: 对比表更新（记忆/工具/Agent Loop），
  P0-P2 改进清单标记实施状态
This commit is contained in:
thzxx
2026-04-19 18:52:23 +08:00
parent 4fac36b941
commit b81bb4dd60
4 changed files with 159 additions and 300 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/HERMES-AGENT-DEEP-STUDY.md
+40 -38
View File
@@ -49,7 +49,7 @@
| API 模式 | 3 种（chat_completions / codex_responses / anthropic_messages） | 1 种（Ollama chat） |
| 工具执行 | 单工具主线程，多工具 ThreadPoolExecutor 并行 | 同一批次 Promise.all 并行 |
| 中断机制 | 后景线程 + interrupt event | AbortController |
| 迭代预算 | 90 轮（可配置） | 15 轮（硬编码） |
| 迭代预算 | 90 轮（可配置） | ✅ 默认 85 轮，设置面板可配（v5.1.1） |
| 上下文压缩 | context_compressor.py 摘要中间轮次 | context-manager.ts 滑动窗口 |
| Prompt 缓存 | Anthropic prompt caching 支持 | 无 |
| 消息交替 | 严格 user→assistant 交替 | Ollama 自动处理 |
@@ -83,18 +83,18 @@ class ToolRegistry:
| 维度 | Hermes | Metona |
|------|--------|------|
| 注册方式 | 每个文件 import 时自动 register() | 集中式 getToolDefinitions() |
| 工具数量 | 47 个 + 19 个 toolset | 34 个内置 |
| 工具数量 | 47 个 + 19 个 toolset | 38 个内置 + MCP 动态注册 |
| Toolset | 工具分组，可按组启用/禁用 | 无分组，全部启用 |
| Shadowing 防护 | MCP 不能覆盖内置工具 | 无此机制 |
| Shadowing 防护 | MCP 不能覆盖内置工具 | ✅ 已实现（v5.1.2） |
| 工具发现 | AST 扫描自动发现 | 手动导入 |
| 结果截断 | max_result_size_chars 每工具可配 | web_fetch 统一 15000 字符 |
| 结果截断 | max_result_size_chars 每工具可配 | ✅ 按工具独立配置（v5.1.0） |
| 安全审批 | tools/approval.py 危险命令检测 + 用户确认 | tool-security.ts 路径/命令检查 |
### Metona 可借鉴
1. **Toolset 分组**：将 34 个工具分为文件系统/系统网络/记忆会话/浏览器/MCP 等组，用户可按组启用/禁用
2. **结果截断按工具配置**：不同工具设置不同的 max_result_size_chars
3. **Shadowing 防护**：MCP 工具注册时检查是否与内置工具重名
1. ✅ **结果截断按工具配置**：不同工具设置不同的 max_result_size_chars（v5.1.0 已实现）
2. ✅ **Shadowing 防护**：MCP 工具注册时检查是否与内置工具重名（v5.1.2 已实现）
3. ❌ **Toolset 分组**：将 38 个工具分为文件系统/系统网络/记忆会话/浏览器/MCP 等组，用户可按组启用/禁用
---
@@ -105,21 +105,21 @@ class ToolRegistry:
| 维度 | Hermes | Metona |
|------|--------|--------|
| 存储方式 | 2 个 Markdown 文件（MEMORY.md + USER.md） | SQLite（memories 表 + FTS5） |
| 容量限制 | MEMORY.md 2200 字符，USER.md 1375 字符 | 无限制 |
| 容量限制 | MEMORY.md 2200 字符，USER.md 1375 字符 | ✅ 上限 500 条，超限自动清理（v5.1.2） |
| 注入方式 | 会话开始时冻结快照注入 system prompt | 每次用户消息时检索注入 |
| 管理方式 | Agent 通过 memory tool 自主管理 | Agent 通过 memory_search/memory_add 工具 |
| 操作 | add / replace / remove（子串匹配） | search / add |
| 操作 | add / replace / remove（子串匹配） | ✅ search / add / replace / remove（v5.1.0） |
| 会话搜索 | session_search（FTS5 + Gemini 摘要） | session_read（原始内容） |
| 外部提供者 | 8 个插件（Honcho / Mem0 / OpenViking 等） | 无 |
| 安全扫描 | 注入检测 + 凭证外泄检测 | 无 |
| 安全扫描 | 注入检测 + 凭证外泄检测 | ✅ prompt injection / 敏感信息 / 不可见字符检测（v5.1.0） |
### Metona 可借鉴
1. **记忆容量限制**：给 memories 表加容量限制（如 2200 字符），超限时 Agent 自动合并旧条目
2. **冻结快照模式**：会话开始时一次性注入记忆，不随对话变化（保护 LLM cache）
3. **replace/remove 操作**：记忆工具支持修改和删除，不只能添加
4. **安全扫描**：记忆条目写入前检查 prompt injection / 凭证外泄模式
5. **记忆区分层**：MEMORY.md（环境/工作流）vs USER.md（用户画像）清晰分离
1. ✅ **记忆容量限制**：上限 500 条，超限自动清理低价值条目（v5.1.2 已实现）
2. ✅ **replace/remove 操作**：记忆工具支持修改和删除（v5.1.0 已实现）
3. ✅ **安全扫描**：记忆条目写入前检查 prompt injection / 凭证外泄模式（v5.1.0 已实现）
4. ❌ **冻结快照模式**：会话开始时一次性注入记忆，不随对话变化（保护 LLM cache）
5. ❌ **记忆区分层**：MEMORY.md（环境/工作流）vs USER.md（用户画像）清晰分离
---
@@ -210,32 +210,32 @@ prompt_builder.py 组装顺序：
按优先级排序，基于 Metona 现状和投入产出比：
### P0 — 立即实施
### P0 — 已实施
| 改进 | 来源 | 复杂度 | 改动文件 |
|------|------|--------|----------|
| 迭代预算可配置 | Hermes Agent Loop | 低 | agent-engine.ts |
| 记忆 replace/remove 操作 | Hermes Memory | 中 | memory-manager.ts + tool-registry.ts |
| 记忆安全扫描 | Hermes Memory | 低 | memory-manager.ts |
| 工具结果截断按工具配置 | Hermes Tool Registry | 低 | tool-registry.ts |
| 改进 | 来源 | 复杂度 | 改动文件 | 状态 |
|------|------|--------|----------|------|
| 迭代预算可配置 | Hermes Agent Loop | 低 | agent-engine.ts | ✅ v5.1.1（默认 85 轮，设置面板可配） |
| 记忆 replace/remove 操作 | Hermes Memory | 中 | memory-manager.ts + tool-registry.ts | ✅ v5.1.0 |
| 记忆安全扫描 | Hermes Memory | 低 | memory-manager.ts | ✅ v5.1.0 |
| 工具结果截断按工具配置 | Hermes Tool Registry | 低 | tool-registry.ts | ✅ v5.1.0 |
### P1 — 近期实施
| 改进 | 来源 | 复杂度 | 改动文件 |
|------|------|--------|----------|
| Skill 渐进式加载 | Hermes Skills | 中 | skill-manager.ts + agent-engine.ts |
| Skill patch 更新 | Hermes Skills | 中 | skill-manager.ts + tool-registry.ts |
| Toolset 分组管理 | Hermes Toolset | 中 | tool-registry.ts + settings-modal.ts |
| LLM 摘要压缩 | Hermes Context | 高 | context-manager.ts + agent-engine.ts |
| 改进 | 来源 | 复杂度 | 改动文件 | 状态 |
|------|------|--------|----------|------|
| Skill 渐进式加载 | Hermes Skills | 中 | skill-manager.ts + agent-engine.ts | ❌ 当前 Level 0，全文注入 |
| Skill patch 更新 | Hermes Skills | 中 | skill-manager.ts + tool-registry.ts | ❌ 仅 create |
| Toolset 分组管理 | Hermes Toolset | 中 | tool-registry.ts + settings-modal.ts | ❌ 未实现 |
| LLM 摘要压缩 | Hermes Context | 高 | context-manager.ts + agent-engine.ts | ❌ 未实现（仍用滑动窗口） |
### P2 — 中期规划
| 改进 | 来源 | 复杂度 |
|------|------|--------|
| Skill 条件激活 | Hermes Skills | 中 |
| Session 谱系跟踪 | Hermes Session | 中 |
| 预算警告临时层 | Hermes Prompt | 低 |
| Shadowing 防护 | Hermes Registry | 低 |
| 改进 | 来源 | 复杂度 | 状态 |
|------|------|--------|------|
| Skill 条件激活 | Hermes Skills | 中 | ❌ 未实现 |
| Session 谱系跟踪 | Hermes Session | 中 | ❌ 未实现 |
| 预算警告临时层 | Hermes Prompt | 低 | ✅ v5.1.2（≤5 轮 warning，≤2 轮 critical） |
| Shadowing 防护 | Hermes Registry | 低 | ✅ v5.1.2（MCP 工具注册时自动检测重名） |
---
@@ -254,9 +254,11 @@ Metona = 本地 Electron 桌面 Agent
✅ 系统托盘 + 原生文件对话框
✅ 工作空间面板（终端 + 文件浏览器）
✅ 暖色调 UI
❌ 技能系统较原始
❌ 记忆无容量管理
❌ 上下文管理粗糙
✅ MCP 协议支持（v5.0.0）
✅ 技能自动生成（v5.1.0）
✅ 记忆容量管理 + 安全扫描（v5.1.0 / v5.1.2）
❌ 技能渐进式加载（Level 0，全文注入）
❌ 上下文管理粗糙（滑动窗口，无 LLM 压缩）
互补方向：
Metona 吸收 Hermes 的学习进化能力
@@ -265,4 +267,4 @@ Metona = 本地 Electron 桌面 Agent
---
*最后更新：2026-04-18*
*最后更新：2026-04-19（根据 v5.1.3 实际代码更新实施状态）*