memoryweave/REPAIR-PLAN.md

5.1 KiB
Raw Permalink Blame History

织忆 v3.8 修复计划 — 分阶段执行

创建: 2026-05-30 01:30 状态: 🔴 未开始 当前阶段: F1将要开始


核心矛盾

代码框架完成度很高12,000+ 行 Go+Rust数据流从未真正跑通。 Hermes 插件没传 agent_id → commit 静默失败 → 系统里只有 3 条测试数据。 所有依赖数据的子系统(蒸馏/自优化/治理/评估/Skill/预取)全部处于空转状态。


阶段总览

阶段 名称 天数 当前状态
F1 打通端到端管道 1天 🔴 未开始
F2 存储层归位 + Recall 管线 2天 🔴 未开始
F3 蒸馏 + 自优化激活 2天 🔴 未开始
F4 治理 + 图谱修复 1天 🔴 未开始
F5 竞争性架构激活 2天 🔴 未开始
F6 部署固化 + 监控告警 1天 🔴 未开始

F1打通端到端管道

F1.1 修复 Hermes 插件 commit 静默失败

根因~/.hermes/plugins/zhiyi/__init__.pycommit() 没传 agent_idnamespace 修复payload 追加 "agent_id": "hermes-a06" + "namespace": "hermes-main" 验证memory_write → /stats total_memories +1

F1.2 修复 episodes 存储计数

根因commit 创建了 episode + memory但 stats 显示 episodes=0 修复:检查 core.go commit handler 的 episodes 表写入路径

F1.3 插件 recall 参数对齐

根因:插件用 top_kGo 端用 limit 修复Go 端 /api/v1/recall 同步支持 top_klimit

F1.4 打通后冒烟测试

  • memory_write 5 条 → total_memories ≥ 5
  • recall "牧尘" 返回 ≥ 1 条
  • /api/v1/graph/stats 节点增加

F2存储层归位 + Recall 管线

F2.1 切换存储后端到 LanceDB

现状STORAGE_BACKEND=sqlite — 设计要求 LanceDB 修复env 改为 lancedb验证 Rust sidecar 读写SQLite 降级为仅存图谱

F2.2 Recall 管线逐级修复

  • BGE 编码正常POST /v1/embeddings → 1024维
  • ANN 搜索命中LanceDB HNSW 索引)
  • Rerank 正常(模力方舟 API
  • MMR 去重正常diversity=0.5
  • 搜索缓存工作Redis TTL 1h

F2.3 知识图谱 query/navigate API 修复

根因graph/query 参数不匹配graph/navigate 与设计文档格式不同 修复:兼容新旧参数格式,返回对齐设计文档 schema

F2.4 新增 recall/debug 诊断端点(优化)

路径POST /api/v1/recall/debug 产出4 步诊断encode / ann_search / rerank / mmr各自延迟和状态


F3蒸馏 + 自优化激活

F3.1 蒸馏引擎联调

  • commit → trigger distill 触发
  • 硬规则过滤 → LLM 5 维评估 → distilled 写回
  • 知识图谱更新 → PassiveValidator

F3.2 Rust 蒸馏质量回溯

  • Go ↔ Rust IPC 通信正常
  • quality_backtrace 完成至少 1 次

F3.3 自优化仪表盘数据填充

  • 7 项指标至少有 5 项 > 0

F3.4 新增蒸馏手动触发命令(优化)

路径POST /api/v1/admin/distill/force

F3.5 遗忘策略首次运行

  • 衰减扫描覆盖 LanceDB
  • recency_factor 正确计算

F4治理 + 图谱修复

F4.1 冲突检测激活

  • 两条冲突事实 → /conflicts ≥ 1
  • 自动裁决 / ask_user

F4.2 知识缺口检测

  • 3 次 miss → /gaps ≥ 1
  • Type A/B/C/D 分类

F4.3 图谱自动扩展

  • 蒸馏后 → 实体抽取 → 节点/边增长

F4.4 PassiveValidator

  • 三层匹配P1/P2/P3正常

F5竞争性架构激活

F5.1 评估框架

  • /eval/generate → 12 个金标查询
  • /eval/run → recall@5 > 0.7

F5.2 V 值反向传播

  • trace 记录 + V 值计算

F5.3 Skill 结晶

  • ≥ 1 条 active skill

F5.4 记忆预取

  • CO_OCCURS 共现统计
  • prefetch map

F5.5 L3 世界模型升级

  • 蒸馏触发动态更新

F5.6 触发器退避机制

  • fail_count 递增 → 3 次失败自动停用

F6部署固化 + 监控告警

F6.1 本地 BGE

  • bge-embed.service 运行
  • recall 延迟 < 200ms

F6.2 WebSocket Agent 注册

  • Hermes WS 连接
  • 事件推送验证

F6.3 备份自动化

  • systemd timer 每天 3:00

F6.4 Prometheus 告警

  • 8 条告警规则加载

F6.5 Hermes 环境变量

  • ZHIYI_URL 配置

全局验收清单

功能 标准 阶段
memory_write 5 条写入成功 F1
memory_search 返回 ≥ 1 条 F1
Recall 延迟 < 200ms F2
存储后端 LanceDB F2
蒸馏 自动运行 F3
自优化仪表盘 5/7 有数据 F3
图谱 query 返回节点 F4
冲突检测 检测+裁决 F4
知识缺口 检测+关闭 F4
评估 recall@5 > 0.7 F5
Skill ≥ 1 active F5
V 值 trace+计算 F5
预取 共现统计 F5
L3 动态更新 F5
本地 BGE recall < 200ms F6
WS 推送 Hermes 连接 F6
备份 每天 3:00 F6
告警 8 条规则 F6