dsh-plugin-immune：为 DeepSeek Harness 提供自进化避坑记忆

它是做什么的？

它是 DeepSeek Harness（DSH）的自进化避坑免疫插件，把 Agent「踩坑—修好」的过程自动提炼成可复用的抗体。它解决同一个坑反复踩、静态文档没人维护很快过期的问题：工具失败与随后的成功被配对、蒸馏成一条规则，按项目隔离存入本地数据库。下次会话出现相同文件名或命令时，相关抗体先一步注入模型上下文，让 Agent 在重犯之前就想起教训。

核心功能

• 失败—成功配对蒸馏：自动识别工具调用失败后又修好的回合，把现场经验提炼成一条抗体，无需人工写文档。
• 按项目隔离的抗体库：抗体存入本地 SQLite 并启用 FTS5 全文检索，不同项目的经验互不污染。
• 双通道检索：3 字以上走 FTS5 trigram，2 字中文词（跨域、端口、权限、死锁等）走参数化 LIKE 兜底，避免短词整段漏检。
• 抗体生命周期管理：支持列出、导出为技能文档、删除单条、撤销上一回合刚学的一条，以及退役或物理清除长期未命中的抗体。
• 本地仪表盘：可搜索触发词、症状与处方，逐条退役、恢复或删除，浏览不计入命中数，统计不被点击污染。
• 双宿主适配：同一份核心代码同时服务 DSH 与 ZCode，DSH 侧还提供设置页内的原生标签页。

怎么使用这个插件？

在 DSH 中启用后正常干活即可：踩坑、修好，下一回合插件会自动提炼抗体，之后问到含相同文件名或命令的内容时，上下文里会出现对应提示。用 /immune 可自检是否挂载成功并列出全部抗体，加 --all 可查看已退役条目；/immune-export 把经过验证的抗体导出成技能文档；/immune-forget 删除指定抗体，--last 撤销上一回合刚学的那条，--prune 退役超过 14 天从未命中的抗体，--purge 则物理删除。需要可视化时启动本地仪表盘，默认端口 7788，被占用会自动顺延；它只绑定本机回环地址，每次启动生成随机令牌，所有接口请求都需携带。ZCode 侧命令名带插件前缀，功能一致，安装后需新建任务才生效。

报错怎么排查？

插件装好后命令无响应，通常是宿主进程未重启——组合包在启动时装配，运行中的进程不会自行加载，重启后可用自检命令确认是否返回「暂无抗体」。若通过 git 形式安装失败，多因包管理器默认阻止依赖的构建脚本执行，需按官方说明把对应构建项加入允许列表，或改用打包好的分发包。设置页里看不到免疫标签页时，先确认当前 profile 是否带 web 服务：该标签页依赖可选能力注册，纯命令行或桌面 profile 下插件照常工作，只是不显示入口。