Runtime Self-Learning v6.0.0 — Hana v2 App

Runtime Self-Learning v6.0.0

面向 HanaAgent 1.1.24-beta 的 v2 App。使用官方 SDK 与隔离数据目录，提供工作流观察、经验检索、审核、健康检查及相关提示注入。

安装

1. 下载 app-hanako-runtime-learner-6.0.0.zip，在 Hana 的“扩展 → 本地安装”导入，完成声明能力审查。
2. 停用旧 v1，避免重复采集。可以直接从空数据开始；如需保留旧记录，先阅读源码中的迁移说明。
3. 设置入口：左下角齿轮 → 应用 → 自学习。模型功能使用 Hana 的工具模型，默认关闭；后台计划须显式 enable。

普通用户无需安装 Node 或 npm。配套 .entry.json 供市场登记使用；GitHub 自动生成的源码 ZIP 不是安装包。

验证与限制

• 2026-10-18 在 Windows 11 / Hana 1.1.24-beta 本地安装：加载正常、7 个工具已注册、设置页可见。8 个安装文件与此 ZIP 的 SHA-256 一致。
• 自动测试 1009 项：1004 通过，5 项 Windows symlink 权限跳过，0 失败。官方 ZIP 静态及隔离启动检查通过；17 个基准场景、性能、语法、复杂度检查通过。
• tool-demo.json 是可复现的 SDK fixture 演示，不是真实模型会话；源码中运行 node scripts/demo-app.js 可复现。
• 未验收真实付费模型推理、长时间后台运行和其它系统。官方记忆文件直读、外部工作区自动执行、旧控制台和自配外部端点未在此隔离版启用。
• 包内 README 保留构建时“本地候选”的状态描述；本 Release 将同一份经本机安装验证的 ZIP 原样发布，没有替换包内运行文件。

ZIP SHA-256：e3b9b93d71fe8991b62168b680bc3f5892252d62324c60ae7fbed6003a0e2895

源码与授权：主体 MIT；内联官方 App SDK 为 Apache-2.0，随包附带许可说明。市场上架仍需维护者审核。

v5.1.10

Runtime Self-Learning v5.1.10

• Adds Hanako v0.374.3 preview compatibility coverage.
• Improves proposal recovery and cross-process state locking.
• Includes packaging, documentation, and release-readiness updates.

Validation completed: 994 tests (989 passed, 5 Windows capability skips), build, check, benchmark, performance, high-severity audit, and release readiness all passed.

Distribution SHA-256: 34cb408791d0dec01fbb479b50bcae6f654c0c149bc392a4e5a39ccc6c4e50b6

v5.1.8

Runtime Self-Learning v5.1.8

Clean patch release on top of v5.1.7. This does not overwrite the existing v5.1.7 release asset.

Changed

• Adds structured usage evidence for future usage:large_context:* and usage:failed_request:* patterns.
• Appends/deduplicates evidence when existing usage patterns are reinforced.
• Stops self_learning_doctor from counting rejected high-score patterns in evidence_missing diagnostics.
• Synchronizes the release test baseline to 950 tests.

Validation

• npm run build: passed
• npm run check: passed
• npm test: 950 tests, 945 passed, 5 skipped, 0 failed
• npm run benchmark: 17/17 scenarios passed
• npm run perf -- --json: passed, no threshold breaches
• npm run release:check: ready / Score 100
• npm audit: 0 vulnerabilities

Asset

• hanako-runtime-learner-dist.zip
• SHA256: 6490c5879fc1414dc39f4e7dda35355ce9f63c17fc38e88f12f0a40256edcf2f

v5.1.7

在已发布的 5.1.6 之上执行子系统级精简计划，完成全部 S0-S11 共 12 个子系统的审查。Phase A（S2 control 路由收敛）取得实质性精简成果；Phase B（S1 基础层 + S3 入口）完成低风险内聚与防回流规则自动化；Phase C（S4-S9 六个核心域）经严格审计确认边界健康、无精简机会；Phase D（S10 构建/发布基建）修复本轮自身引入的文档漂移。随后经三遍多角度代码审查（8 路并行 finder + 人工核实）确认零正确性缺陷，修复 3 项发现的维护性问题。全程零默认行为变化、零安全边界放宽、零测试回归。

• tools/control.js 从控制面聚合器收敛为路由器：533 LOC / 32 imports → 268 LOC / 18 imports（LOC −50%，imports −44%，达成并超过 <=20 目标）。status/proposal-review/maintenance 三个 handler 域下沉到 tools/control-handlers/{status,proposal-review,maintenance}.js（逐字迁移，行为等价），8 个 handler 域模块聚合为单一 tools/control-handlers/index.js。
• 防回流结构规则：新增 control_router_no_business_imports report-only 规则（lib/complexity.js），禁止 tools/control.js 重新直接 import 已下沉的 9 个 lib 模块；INDEX_BANNED_DIRECT_IMPORTS（入口聚合边界）与新增的 CONTROL_BANNED_DIRECT_IMPORTS 均获得自动化 drift 检测测试（对比真实源码 import，而非仅靠人工审计）。
• 基础层低风险内聚：lib/helpers.js 312 LOC / 18 exports → 277 LOC / 15 exports（脱离 export soft target）。3 个单消费者 helper 内聚到各自唯一调用方；1 处 P1 误判（sessionKeyFromNormalized 被内部 sessionIdentityKey 依赖）已发现并更正为不动。
• 代码审查修复：redactConfig/SENSITIVE_CONFIG_KEYS 曾在 status.js/maintenance.js 两处重复定义，已合并到 tools/control-summaries.js 单一实现；tools/control.js 一处预先存在的死 import（readPluginVersion）已清理。
• Phase C 六域审计（S4-S9）：观察/学习、记忆/检索、模型顾问/LLM、动作/agent、治理/审计、技能渲染——逐项以源码证据核实计划书列出的安全/正确性不变量（R2-R4 风险分类不可降级、agent-graph-readonly.js 架构级零 import、event-log hash 链完整性、SKILL.md 单一安全写入路径等），均确认无精简机会、无漂移。
• README 文档澄清（用户风险反馈跟进）：测试徽章增加环境依赖说明（本地 Windows 无 symlink 权限时实际为 943 passed/5 skipped，非缺陷）；补充 trust: full-access 与窄 permissions: ["usage.read"] 不对称的解释（引用 docs/HOST_PROTOCOL_NOTES.md 宿主契约）；self_learning_control 近 50 个 action 按代码层真实 side-effect 分类重新分组呈现（只读查询/产出报告/提案预审/外部模型调用/本地状态变更），替代原先未分级的平铺列表。
• 测试与发布门：测试总数 943 → 948（新增 5 个复杂度治理测试；当前 Windows 本机结果为 943 passed / 5 skipped / 0 failed，5 skip 为 symlink 权限能力探测，非缺陷）。npm run build、npm run check、npm test、npm run benchmark、npm run perf、npm run complexity:check、npm run release:check、npm audit --audit-level=high 均通过；complexity soft warnings 1（唯一剩余为与本轮无关的 lib module count 历史项），structural warnings 0。

v5.1.6

v5.1.6 - 文档统计修正发布

在已发布的 v5.1.5 之上修正测试统计漂移，不移动既有 v5.1.5 tag，使用 v5.1.6 作为干净补丁发布。

Changes

• 修正当前发布文档中的测试统计：943 tests / 943 passed / 0 skipped / 0 failed。
• 同步 package.json、package-lock.json、manifest.json、README、设计目标矩阵与验收记录到 5.1.6。
• 新增 docs/ACCEPTANCE-v5.1.6.md。

Verification

• npm run build: passed
• npm run check: passed
• npm test: 943 passed / 0 failed / 0 skipped
• npm run complexity:check: passed, 2 soft warnings, 0 structural warnings
• npm run release:check: ready / Score 100

Asset

• hanako-runtime-learner-dist.zip
• SHA256: F6AA2BBE4C08371F72EC6D43BBF57C401AC3073ADC0C452F135E7C9ECEEFFEA8

v5.1.5

结构收敛维护发布。

• README 能力状态矩阵精确化
• control action metadata 集中到 registry
• index runtime wiring 聚合拆分
• complexity report-only structural warnings
• 完整发布门通过：build/check/test/benchmark/perf/complexity/release/audit

Tests: 943 total / 938 passed / 5 skipped / 0 failed
Release zip SHA256: 44A53715E21DE5C0B468AB08FF46B53C2A2F1D424C4DE2778257A117DB7A5884

v5.1.4

v5.1.4 - 性能护栏 + 简化治理收口

在已发布的 v5.1.3 之上完成性能计划 P6-P10 与简化计划 S1-S6，并收口 C-005 复杂度预算决策。

Highlights

• index.js onload 从 552 行单函数拆为 27 行阶段链 + 17 个具名阶段函数。
• complexity:report/check 纳入 index.js / install.cjs 根入口文件扫描。
• tests/pattern-detector.test.js 按行为拆分，42 个用例总数不变。
• libModuleCount 预算调整为 hard 118 / soft 105，并固化“新建文件是最后手段”。
• 性能计划 P6-P10 收口：benchmark 17/17，perf 全部在阈值内。

Validation

• npm run build: passed
• npm run check: passed
• npm test: 938 tests, 933 passed, 5 skipped, 0 failed
• npm run benchmark: passed, 17/17 scenarios
• npm run perf: passed, all metrics within thresholds
• npm run release:check: ready / score 100
• npm audit --audit-level=high: found 0 vulnerabilities

Asset

• hanako-runtime-learner-dist.zip
• SHA256: 08C6F48A18998AD2F645F3DFF647E0660ED4AD12B0670713CF4C974F91EE92A1

v5.1.3

v5.1.3 — 配置一致性 + 设置面板即时生效

• profile 只治理 review/apply 姿态：安全闸门 includePendingPreferences 与能力/隐私/UX 开关（modelAdvisorEnabled / semanticSearchEnabled / llmExtractionEnabled / includeUsageInAdvisorPrompt / workStatusEnabled）移出 profile 模板，纯由设置面板 / set_config 掌控；doctor 不再就用户的显式能力选择误报 policy_inconsistent。
• 设置面板即时生效：订阅宿主 plugin_config_changed 事件，原地刷新运行时 config——改设置无需重载插件即生效。唯 learnFromUsage 仍需重载（已在面板用 reloadRequired 标注）。
• 降噪：code_patch 调查工单不再为环境性 / catch-all 错误桶（network_error / tool_error）生成。
• 仓库卫生：benchmark-results/ 生成产物取消 git 跟踪。

门禁：851 测试（846 passed / 5 skipped / 0 failed）、check / complexity / release:check ready · 100。真机 Hanako v0.345.x 复测 doctor Good / 88、policy_inconsistent 消失。

资产 hanako-runtime-learner-dist.zip
SHA-256: 538336c0ccf1320ad3e81e98ea40626450c315796883c0a3968c1d21f621212c

v5.1.2

v5.1.2 — 全面审计加固

在 v5.0 冻结的 API 表面之上，完成一轮 S1–S12 × 正确性 / 复杂度 / 性能三遍全面审计（36 单元格），修复审计发现的中/低危逻辑问题并治理复杂度热点。不改 official 架构、不新增工具、不引入网络副作用、不放宽安全边界。

本版同时收纳了未单独发布的 5.1.1（model advisor 可观测性补强）。已发布序列由 v5.1.0 直接进入 v5.1.2。

已修问题

• 中 lib/agent-controller.js：step 异常会逃逸且不落 FAILED；现强制落 FAILED + 写 state.crashed audit + 持久化。
• 中 tools/control.js：diagnose_bus 带 session target 时按 target 区分 external_side_effect vs read，不再误声明只读。
• 中 lib/release-readiness.js / lib/dist-verify.js：测试数默认统一到 843；新增 zip central directory root 校验（verifyZipRoot），杜绝错误 zip root 假绿。
• 低 lib/sample-text.js：sampleTextViaBus() 补传 ctx.pluginId，修正 usage attribution。
• 低 lib/agent-task-store.js：区分缺失文件（ENOENT/null）与损坏文件（throw corrupt）。

复杂度治理（等价重构，行为/导出面不变）

proposals.js 448→338、observer.js 501→452、scope-gate.js 428→274、agent-controller.js 332→161、audit-dashboard.js 308→196、tools/control.js 631→524（imports 34→30）。

门禁

check pass · npm test 843（838 pass / 5 skip / 0 fail）· complexity:check OK（3 soft / 0 hard）· release:check ready / Score 100 · benchmark 17/17 · perf 全阈值内 · npm audit 0 漏洞。

minAppVersion 保持 0.345.0。

资产

hanako-runtime-learner-dist.zip
SHA-256: 157d8bc9fedbc91f81c70eeed0d0304f79bf574a1af6b3a4b906a6a8b97a764f

v5.1.0

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 的安全边界。