Skip to content

v5.1.0

Choose a tag to compare

View all tags
@326sun 326sun released this 26 Jun 11:21
· 50 commits to main since this release
v5.1.0
8fc430b

v5.1.0 — 反馈信号、只读 Agent 图与安装验证版本

这是 Hanako Runtime Learner 在 v5.0.0 基础上的一次正式增强版本。本版本完成了 v5.1 开发周期中的主要实验能力收口，并通过 Hanako v0.345.x GUI 真实安装冒烟测试。

主要更新

1. 新增 M5 反馈信号机制

本版本新增了本地反馈信号记录能力，用于后续评估记忆注入质量和学习效果。

新增信号包括：

  • feedback.memory_injected：记录记忆被成功注入后的信号；
  • feedback.injection_revoked：记录已注入记忆后续被撤销或标记问题的信号；
  • feedback.memory_closed：记录用户手动关闭某条记忆或模式的信号。

这些信号只写入本地 append-only event-log，不外发、不记录完整用户原文、不记录完整记忆内容。

2. 新增 feedback_summary 只读诊断入口

通过现有 self_learning_control 增加只读 action：

{ "action": "feedback_summary" }

该入口用于查看反馈信号统计，例如：

  • 记忆注入次数；
  • 注入撤销次数；
  • 用户关闭记忆次数；
  • proposal applied / rejected 统计；
  • pattern approved / rejected 统计。

该入口只读，不修改配置、不修改记忆、不参与当前策略决策。

3. 新增 M5 自适应阈值最小外壳

本版本加入了 adaptive threshold 的最小安全实现，但默认关闭。

关键边界：

  • adaptiveThresholdsEnabled 默认值为 false；
  • 只生成 recommendation；
  • 不自动 apply；
  • 不修改 runtime-config；
  • 不接入搜索、注入、advisor 等热路径；
  • 不改变现有阈值默认行为。

该能力用于为未来版本提供安全的自适应阈值基础，但 v5.1.0 不启用自动调参。

4. 新增 M4 只读 Agent Graph 骨架

本版本新增 experimental read-only agent graph，用于只读规划和诊断。

允许节点：

  • Observe
  • Plan
  • Policy
  • Verify
  • Learn
  • Finalize

明确禁止：

  • Execute
  • Repair
  • Rollback
  • 自动修改源码
  • 自动运行命令
  • 自动 apply
  • HumanApproval 后自动执行

该能力目前只作为只读实验骨架，不具备真实执行能力。

5. 新增 agent_graph_preview 只读诊断入口

通过现有 self_learning_control 增加只读 action：

{
  "action": "agent_graph_preview",
  "context": {},
  "plan": {
    "nodes": []
  }
}

该入口会返回只读 graph report，用于预览 Observe → Plan → Policy → Verify → Learn → Finalize 流程。

安全约束：

  • readonly: true
  • sideEffects: []
  • 不写 event-log
  • 不写 config
  • 不写 memory
  • 不运行 shell
  • 不执行任何节点副作用

6. 修复 Windows 并行测试竞态

修复了 Windows 下并行测试时 build/dist 测试可能出现 cancelled 的问题。

修复方式：

  • build/dist 测试改为使用独立临时目录；
  • 避免多个测试 worker 同时读写共享 dist/；
  • 不使用 retry 掩盖竞态。

修复后测试门禁稳定为：

  • 0 fail
  • 0 cancelled

7. M1 本地 embedding 正式延后

M1 本地 embedding / 本地语义检索没有进入本版本主线。

原因：

本地 embedding PoC 技术可行，但检索收益未达到正式化阈值。

实测结果：

  • MRR 提升：+2.3%
  • recall@3 提升：+0.0%
  • recall@5 提升：+6.7pp
  • 原目标：MRR 至少 +8%，且 recall@3 有非平凡提升

因此，本版本保留现有 BM25/RRF 检索作为主线能力，不接入 local embedding，不启用 localSemanticEnabled，不修改 tools/search.js。

M1 状态为：正式 deferred，不是功能完成，也不是性能通过。

安全边界

v5.1.0 不引入自动执行能力。

本版本明确不包含：

  • M1 local embedding 主线接入；
  • M4 Execute / Repair / Rollback；
  • 自动修改源码；
  • 自动运行命令；
  • M5 adaptive threshold 自动 apply；
  • 自动修改 runtime-config；
  • 任何新的高风险外发路径。

新增能力均为以下类型之一：

  • 本地反馈信号；
  • 只读诊断；
  • 默认关闭；
  • recommendation-only；
  • experimental readonly。

安装注意事项

正式安装 v5.1.0 时，建议替换旧的 v5.0.0 安装，而不是让 v5.1.0 dev slot 与旧版社区插件并存。

如果旧版 v5.0.0 与 v5.1.0 并存，宿主可能仍暴露旧版 tool schema，导致新 action 无法通过普通 tool call 触发，例如：

  • feedback_summary
  • agent_graph_preview

正式安装时应确认 self_learning_control 的 action 列表中包含上述新 action。

验证结果

v5.1.0 已通过完整门禁：

  • npm run check：通过
  • npm test：827 tests，0 fail，0 cancelled
  • npm run build：通过
  • npm run complexity:check：通过
  • npm run benchmark：通过
  • npm run perf：通过
  • npm run release:check：ready / Score 100

真实 Hanako GUI 冒烟测试通过：

  • Hanako v0.345.x GUI 安装成功；
  • 插件 onload 成功；
  • 8 个 self_learning_* 工具全部可见；
  • feedback_summary 只读 action 可用；
  • agent_graph_preview 只读 action 可用；
  • agent_graph_preview 返回 readonly: true 与 sideEffects: []；
  • Doctor 无 failed 状态；
  • 无 error 级别日志。

版本定位

v5.1.0 是 v5.0.0 之后的正式增强版本，重点是：

  • 建立反馈信号闭环；
  • 增加只读诊断能力；
  • 引入安全的 adaptive threshold recommendation shell；
  • 引入 experimental read-only Agent Graph；
  • 保持无自动执行、无自动 apply 的安全边界。
Assets 3
Loading