本地模型自进化记忆 pk14742952-AD/dsh-host-rsi

中文（默认） · English

🧠 DSH HOST RSI 记忆

让本地大模型「越用越强、不再死循环」的宿主插件

它是什么？ 一个给 DSH（DeepSeek Harness）用的宿主侧记忆 / 自进化插件：安静地观察每次会话——模型自检结论、工具成败、用户纠正与长期偏好——把高价值经验沉淀为「可信教训」，下次遇到相似任务自动注入，让本地大模型越用越强。

🎯 它解决什么问题？

| 痛点 😵 | 插件怎么治 ✨ |
| 死循环 / 卡住 / 雷霆大思考：已通过的测试反复验证、空交付、只给计划不给结果 | 内置编码循环收敛 + 五态交付护栏，检测到就注入收敛提示、催出完整闭合的交付物 |
| 金鱼记忆：同样的错误反复犯 | 高价值经验沉淀为可信教训，下次相似任务自动想起 |
| 调参困难：不同本地模型表现差异大 | 通用模式，无需为特定任务写评分器，兼容 API 与本地模型 |
| 记忆污染：系统提示、任务回声混进记忆 | 来源闸门 + 检索净化，只留真正可信的用户纠正 |

✨ 核心特性

- 🧠 自进化：L1 可验证检查 / L2 自反问 / L3 用户末拍，三级信号阶梯可靠性加权
- 🔁 收敛导引：检测到死循环自动注入收敛提示，把时间省回真正的工作
- 🛡️ 五态交付护栏：EMPTY / TRUNCATED / FIXED_POINT / SAME_PLAN / SHELL_LOOP 全拦截
- 💾 持久记忆：内存缓存读 + 后台防抖写，崩溃自愈、不丢数据
- 🔌 零侵入：纯宿主插件，不碰模型权重，最小资源占用

🚀 快速开始

1. 一键安装：DSH「设置 → 插件」安装 dsh-host-rsi
2. 看效果：重启 DSH →「设置 → 插件 → DSH HOST RSI记忆 → 打开仪表板」，实时查看捕获 / 注入 / 拦截
3. 独立体验（无需 DSH）：node demo-serve.mjs → 打开 <http://127.0.0.1:8788>

📢 更新公告

v0.2.6（2026-10-12）— 实例级二道防线 + 收敛窗口化

- 实例级最终通牒（二道防线）：此前单轮纠正预算（maxRetries/maxPerSession）耗尽后，会话会被记为"未交付"并放弃——这正是实测报告里 3/50 实例空手交付的形态。现在在即将标记未交付之前，先发出每会话一次的最终通牒（guardFinalChancePrompt）：点名被拒状态、禁止继续调工具/沉默/复读、要求直接给一个紧凑的真实交付物或一行阻塞说明；随后只要给出可交付内容仍算"救回"。软开关：guard.finalChance（默认 true），仅在有 followup 通道时触发，每会话至多一次。
- 收敛检测窗口化（滑动窗口）：重复通过检测从"累计直方图"改为环形窗口——报告 S1 的教训是环形窗口才"治愈"验证循环、累计计数只能"打断"。observeShell 新增 windowSize=8 默认参数，只统计窗口内的重复；fingerprintCounts 保留为累计诊断。原约定不变：连续 3 次重复仍然触发，只是很久以前的重复不再误触发 SOFT_STEER。
- 新遥测 runtime.guard.finalChances：仪表板新增"最后通牒"卡片、状态文字报告同步展示。
- 对照验证：scripts/compare-baseline.mjs 三列对照（v0.2.5 基线/工作区/已安装 profile）19/19 场景逐行一致，零行为回归；测试套件 146 项全通过。

v0.2.5（2026-10-12）— 仪表板补齐"救回"量度

- 仪表板新增"救回"卡片：护栏价值的最核心量度——报告实测 206 次空响应 100% 被一轮纠正救回（issue#3 §2.3）。此前 GUI 只有触发/重试/未交付，缺"救回"；现在仪表板卡片与运行摘要均展示 guard.rescued，并新增测试防止再次丢失。
- 测试套件 141 项全通过。

v0.2.4（2026-10-12）— 烧穿预算的针对性纠正 + 对照收尾

- 针对性纠正话术：finish_reason=length 且内容为空（思考预算烧穿、零交付）时，打回话术明确告诉模型"上一轮把预算烧在内部思考上了，请直接在可见回复中输出交付物"，与 3188 轮实测报告（issue#3）验证过的守卫代理话术一致；普通 EMPTY 保持通用话术。
- 对照测试收尾：compare-baseline.mjs 新增 4 个护栏校准场景，20 场景三列对照（旧基线/工作区/已安装 profile）逐行一致（仅 2 个目标校准点与旧基线不同），确认不影响其它插件、profile 与源码同步。
- 测试套件 140 项全通过。

v0.2.3（2026-10-12）— 护栏阈值按真实负载校准

- EMPTY 判定不再误伤对话短答：默认只抓"完全空交付"；原先 400 字符阈值会误伤正常短答（如"好的"），已按 3188 轮 SWE-bench 实测报告（ninfer-fusion-kvmem issue#3 的校准结论）改为默认 0，交付类任务仍按 2000 字符文件门槛检查。
- 烧穿思考预算的空输出单独归类：finish_reason=length 且内容为空 = 「预算烧完但没交付」，按 EMPTY 纠正话术处理（实测 3188 轮中 206 轮、占 6.5% 的主退化形态），非截断。
- 测试套件 139 项全通过。

v0.2.2（2026-10-11）— 让插件真正发挥作用

- 修复系统自污染：系统横幅 / <goal_round> / skill-catalog 等不再被误记为「用户纠正」注入无关任务。
- 用户 REFUTED 现在被信任：用户指出「你错了」是最强纠正信号，按 L3 可信注入（之前被隔离）。
- SHELL_LOOP 误判修复：三条不同命令不再被误判为死循环（按 name:command 身份比较）。
- 收敛判定修复：3 passed; 0 failed 不再误判为失败；BUILD FAILED 不再误判为通过。
- 存储原子写 + 损坏自愈：index.json 崩溃不再全丢、损坏后自动备份重建，不再永久降级。
- 检索注入净化：任务回声过滤、中文 token 估算修正、L1 之外真正注入 fix。
- 对照测试见 COMPARISON-0.2.2.md，测试套件 138 项全通过。

更早版本见 CHANGELOG.md · 本版本 GitHub Release：<https://github.com/pk14742952-AD/dsh-host-rsi/releases/tag/v0.2.2>

📚 深入阅读

- PRINCIPLES.md — 技术原理：信号阶梯 / 反思循环 / 触发与效率 / 索引机制 / 复刻清单（逐点标注源码行号）
- COMPARISON-0.2.2.md — 修复前后对照测试
- CHANGELOG.md — 完整更新日志

如果发现 bug 或有改进想法，欢迎提交 Issue / PR；觉得好用就点个 ⭐ Star，谢谢支持！

原理来源（致谢 / Principle Source）

本项目的核心原理源自并致敬以下公开研究成果：

- AREX-2（arXiv:2609.38288，BAAI 2026）——自我进化智能体框架。本项目把它落地为「本地、增量、可用即学」的 DSH 宿主插件；逐点技术对应见 PRINCIPLES.md。
- 递归自我改进（Recursive Self-Improvement, RSI）与持续学习（Continual Learning）——每次运行把成功/失败经验沉淀为可检索、可反驳、可自动升级的经验条目；可信经验下轮注入上下文，实现「越用越强」。这是本项目记忆层信号阶梯与升级策略的原理基础。

GUI 说明：本项目此前缺少 GUI，本次补齐。仪表板「设置页里点一下即开网页」的显示方式参考了 DSH 插件 billion-context（MIT）——仅参考其展示思路，代码为独立重写，并非复制其代码（详见 client.js 与 lib/dashboard.js）。

仪表板 / GUI

DSH 重启后：「设置」→「插件」→ 「DSH HOST RSI记忆」 →「打开仪表板」，即可在浏览器查看插件运行状态（启用中/降级、可信/隔离/轨迹、最近记录）。页面每 5 秒轮询 status.json，并显示触发诊断：已处理事件、注入、捕获、失败信号、拦截噪声、最近触发事件与原因。
也可在本机直接跑独立 demo（不依赖 DSH）：
node demo-serve.mjs # 本机回环 + 示例记录（默认端口 8788）
RSI_DEMO_PORT=9000 node demo-serve.mjs

设计目标（本次优化重点）

- 不影响大模型 / DSH 正常工作：所有读走内存缓存；磁盘 I/O 只在后台防抖写入时发生，热路径（pre-step / turn-end）永不阻塞。
- 更强的自动触发：宿主侧同时监听 pre-step / turn-end / message 的多个常见事件名（agent/pre-step、message、chat/message 等），谁存在就用谁，并用事件对象/内容去重，避免一轮触发两次。
- 立刻能看到的反馈：设置页和仪表板显示实时触发计数（事件/注入/捕获/失败）；即使尚未产生可信教训，普通工具失败也会留下隔离记录，让用户确认插件确实在工作。
- 诊断与体验工具：模型或用户可调用 rsi_events 查看触发诊断；rsi_demo_capture 可写一条示例教训，用于快速验证仪表板/设置页。
- 用户纠正与长期指令会被记住：当用户在一轮回复后给出明确纠正或新指令（例如「不要用 requests，改用 httpx」），插件会把它记为 L3 可信教训。明确的长期偏好 / 规则（「以后都用 httpx」「请记住输出用简洁列表」）也会在用户提出时记录为 user-instruction 可信教训；普通一次性任务请求只记隔离 Q 记录，不会进入注入，避免污染未来上下文。
- 来源闸门，防止系统内容污染记忆：只有 source.kind === 'user' 的真实用户消息才会被捕获； DSH 运行时横幅、其他插件注入的指令、以及本插件的自检块都会被拦截并计入「拦截噪声」，每条用户记录还会带上 sourceKind 字段方便自查。
- 指令按项目去重，防止记忆库膨胀：用户指令会尽量按项目/工作区分组（从指令里的路径或会话上下文提取，取不到则归到全局），同项目内近义/重复指令会被 hasDuplicate 门槛拦截；不同项目出现相似指令不会被误合并。
- 教训后台自动搜集到本地插件目录：addLesson/addTrajectory 立即写内存、批量后台落盘 （flushMs 防抖）；目录不可写时降级为纯内存（store.disabled），插件不崩、照常工作。
- 最小资源占用：index.json+termindex.json 仅在打开时读一次，之后全内存；写入合并批处理；防抖计时器 unref，不占用事件循环 / 不拖住进程退出。
- 最大兼容性：纯逻辑层零宿主依赖（可 npm test）；宿主侧每个 DSH 调用都带 ?. 防御 + try/catch，形状错了就空操作，绝不向宿主抛错。

收敛 + 交付护栏（v0.2.0）

- 编码循环收敛：移植自 dsh-bonsai-fast / pi-extension-convergence。同一轮通过检查（pytest / npm test / build / API）连续重复，或已有多类检查全部通过时，插件通过 tools/post-execute 注入强/软收敛提示，避免「测试通过后继续反复验证」；任何 edit / write 会重置计数。默认对所有 DSH 可运行的模型生效；如需只收敛 27B，把 convergence.models 设为 ["27b"] 即可。
- L3 交付护栏：参考 D:\ninfer 04/05 防治方案，在宿主侧识别五态失败： EMPTY（空交付/正文过短）、TRUNCATED（代码块或 SVG 未闭合、finish_reason=length）、 FIXED_POINT（与上一轮逐字相同）、SAME_PLAN（只重复计划）、SHELL_LOOP（只调工具无正文）。
命中失败态会自动 agent.followup 一轮「立即输出完整闭合交付物」；每轮最多 maxRetries 次、每会话最多 maxPerSession 次，耗尽后写入隔离轨迹供查看。工具实际写文件后只给短结论的回合不会被误判（长度门槛只对未跑工具的内联交付生效）。

进化机制（可靠性加权信号阶梯）

任务 + 答案 ├─ L1 有可验证检查？（代码测试 / 数学== / SQL 匹配 / schema 合法） │ → 跑它。L1 失败 = 高价值纠正型教训。（决定性 → 停） └─ 无 L1 → 内联自反问：模型输出 [VERIFY: CONFIRMED|REFUTED|UNCERTAIN; conf=..; lesson=..; fix=..; reason=..] ├─ CONFIRMED 且 conf≥thr → 可信 L2，结束（不开批评） ├─ REFUTED → 自动批评轮（重推 fix）→ 纠正型教训 ├─ UNCERTAIN / 无标签 / 低 conf → 自动批评轮 └─ 用户 rsi_verify 强制 → 自动批评轮批评后仍不确定 → 进隔离区（被更强信号证实后才注入）

自动但高效： 每条重路径都有门控。无相关时全空操作；只在带结果信号的轮次（出错 / 跑工具 / 产出物 / 决策 / 自选标签）捕获；便宜方法失败才开批评；每会话预算封顶成本。

目录结构

dsh-host-rsi/ # 插件包（代码） index.js # DSH 宿主入口：apply() + rsi_status 工具 + __RSI__ 注入 + /rsi/* 路由 client.js # 浏览器客户端：DSH 设置页「DSH HOST RSI记忆」标签（展示方式参考 billion-context，代码独立重写） demo-serve.mjs # 本机独立 demo（不依赖 DSH，loopback + 示例记录） cordis.patch.yml # DSH 宿主 bundle 补丁（插入 dsh-host-rsi） config.default.json # 默认配置 icon.svg # 设置页图标 lib/ # 纯逻辑（可单测，零宿主依赖） capture.js # 把一轮编排为"已分类教训 + 轨迹" convergence.js # 编码循环收敛（移植自 dsh-bonsai-fast / pi-extension-convergence） dashboard.js # dashboardHtml + /rsi/* webserver handler + 本机 dashboard server guard.js # L3 交付护栏（EMPTY/TRUNCATED/FIXED_POINT/SAME_PLAN/SHELL_LOOP 五态） interrogate.js # 自检指令、[VERIFY] 标签解析、批评 prompt、自一致 policy.js # 触发 + 升级 + 预算门控 + 来源/系统内容过滤 retrieve.js # 相关度排序 + token 预算 scorers.js # L1 可验证检查（code/math/sql/schema 自动探测） signal.js # 信号阶梯判定（L1/L3/REFUTED/CONFIRMED + 权重） store.js # 文件存储 + 倒排索引（内存缓存 + 后台防抖写入 + 优雅降级） status.js # 快照 + records + formatStatusReport locale/ # 设置标签 i18n（zh/en） test/ # node:test 套件（含 webserver/client 宿主集成测试） ~/.dsh/rsi-memory/ # 数据目录（人可读的权威源；DSH_HOME 环境变量可覆盖） index.json termindex.json lessons/<domain>.md # 可信，可人工策展 quarantined/<domain>.md# 未验证，日后转正 trajectories/.jsonl # 原始轨迹（供日后 LoRA 蒸馏）

一键部署 / DSH 安装教程

本地快速体验（不需要 DSH）

git clone https://github.com/pk14742952-AD/dsh-host-rsi
cd dsh-host-rsi
node demo-serve.mjs

然后用浏览器打开控制台输出的回环地址，就能看到仪表板和示例记忆。

在 DSH 中安装

宿主专用 bundle。从 GitHub 安装：

dsh plugin add github:pk14742952-AD/dsh-host-rsi

如果你的 DSH 使用非默认 profile，请按需追加 --profile <你的profile>。
插件尚未发布到 npm，当前请使用上面的 GitHub 安装方式，或对本地目录执行 plugin_manager install_bundle。

安装完成后重启 DSH 即可生效，没有构建步骤。

模型适配

插件是 模型无关的宿主侧逻辑，不依赖具体模型参数量，本质上 DSH 能驱动的模型都可以用：

- 本地 27B 模型（如 Qwen3.8-27B）：当前默认设置按此调优，是项目重点验证对象。
- 本地轻量/Flash 模型（如 Qwen3.8 Flash）：可以运行，若上下文窗口偏小建议降低 inject.topK / inject.tokenBudget / capture.maxPerSession。
- API 或云端模型：同样可用，因为它只注入文本和读取宿主事件，不改模型权重；较大的上下文模型可适当调高 inject.topK / inject.tokenBudget 获得更完整的记忆复用。

如果你的模型参数量或上下文差异较大，只需要调整 config.default.json 里的注入预算，不需要改插件代码。

首启验证

index.js 里 ctx 事件载荷形状是"文档名 + 防御假设"（agent/pre-step、turn/end、agent.followup）。
首启用 cordis_inspect_query（Event/Service）确认：
- turn/end 事件暴露胶水所需的 任务 + 助手文本 + 工具结果；
- 你的 profile 里 agent.followup / agent.inject 是否存在（不存在则这些路径安全空操作）。

然后运行：

cd dsh-host-rsi
npm test # 纯逻辑 + 数据层套件（node --test test/.test.js，不会碰需要本地模型的 e2e）

配置（bundle 行 config）

见 config.default.json：
- enabled（总开关，false=完全空操作）、dir（数据目录）、flushMs（后台写入防抖 ms）；
- inject.{topK,tokenBudget,candCap,enabled,includeQuarantined,oncePerTask,selfCheck,maxInjectsPerTask,reinjectOn,compactTopK,compactTokenBudget}； selfCheck=false 时不再注入强制 [VERIFY: ...] 尾行，适合结构化输出 / schema 约束场景；
- capture.{enabled,maxPerSession,minChars,dedupeThreshold,captureUserCorrections,captureUserInstructions}；
- escalate.{enabled,maxCriticsPerSession,selfConsistency,threshold}；
- convergence.{enabled,repeatThreshold,models}：重复通过阈值与生效模型，默认 []=全部模型，可设 ["27b"] 等白名单；
- guard.{enabled,maxRetries,maxPerSession,thresholdEmpty,thresholdFile,sameToolStreak,fileTurnRe,tasksRe,recordTrajectory}：交付护栏阈值与重试预算；
- embeddings（预留，默认 null；规模大了可换成嵌入近邻）。

默认值对本地模型偏保守。

评估与已知边界

- 跨会话记忆已做端到端复现：同一批隐藏任务，无插件 0/5，插件 5/5（Fisher 精确检验
p=0.0079），说明可信教训确实能跨会话注入并改变行为。
- 自检（[VERIFY] 反问尾行）在一套大样本评估（deepseek-v4.1-flash，约 350 轮/组）中未见显著准确率提升；该结果不是最终结论，因为目标模型仍是本地 27B（Qwen3.8-27B），需要等本地 27B 实机复测。
- 如果你使用 JSON Schema / 结构化输出，请把 inject.selfCheck 设为 false，避免强制尾行把正确结果变成不可解析输出（详见 #3 / #4）。
- 原始评估报告：issue #4。

开源协议（License 合规）

- 本项目（dsh-host-rsi）采用 MIT 协议，见 LICENSE。
- 原项目 DSH（@deepseek-ai，MIT，Copyright 2026 DeepSeek）：本项目是 DSH 的宿主插件，不修改、不分发 DSH 源码，仅通过 DSH 的宿主 API（ctx.on / ctx.inject / webServer.register / 页面注入）与其协作。MIT 为宽松许可、支持第三方插件与其共存并独立发布；本项目未复制 DSH 代码，故无随附 DSH 版权声明的强制义务（此处主动注明，以示合规）。
- billion-context（MIT，Copyright 2026 ranxianglei）：仅参考其「设置页内嵌网页」的展示思路并独立重写代码（非逐字复制）；按 MIT 惯例在此致谢。

结论：原项目 DSH 采用 MIT 宽松协议、支持第三方插件，故本项目可合规发布；本项目同为 MIT，并显式致谢 DSH 与 billion-context。

可选下一步：权重级进化

trajectories/ + trusted 教训是干净的训练集。周期性导出后在 Qwen3.8-27B 上做小 LoRA 蒸馏（loss 只落在"前进型决策"上），把元技能烤进权重——这是运行时记忆环路的批量、安全补充。