DeepSeek Harness 的 Agent 每次会话都是从零开始：上一轮踩过的坑、用户明确说过的偏好、验证过的好方法，全都会丢。把长期记忆塞进 AGENTS.md 又会无界膨胀，最后淹没在噪声里。
这个插件提供一条可维护的记忆通道——写入有来源与可信度分级，读取按重要性和新鲜度加权，容量不足时按分数淘汰而不是静默截断。
核心功能¶
插件通过分级与加权机制管理 Agent 的长期记忆与经验沉淀。
- 记忆机制：支持跨会话记忆，按工作区分库存放；记忆分为
fact（事实）、preference（偏好）、lesson（教训）、resource（资源）、method（方法）五类。读取时按重要性、新鲜度、命中次数加权。 - 治理与安全：具备记忆治理能力，支持双时态失效（标记不删）、自动合并去重、超限时按行丢弃；内置投毒防护，写入时隔离指令性语句，注入期二次检测；记忆注入走系统提示，零上下文成本。
- 复盘与进化：支持出错即时复盘、会话结束复盘、睡眠期巩固。复盘产物可沉淀为 SOP 技能库（真正的 skill，渐进披露）或改进提案，形成闭环。
- 可靠性：具备防丢失落盘能力，运行中增量快照，进程重启自动恢复；支持会话交接，自动处理未完成会话。
安装¶
作为 DSH profile 插件安装：
dsh plugin add /path/to/dsh-self-improvement
将本目录放入 ~/.dsh/plugins-src/ 下，由 cordis.patch.yml 注册进 profile 层栈。安装后重启 dsh web（或对应的 profile 进程）即可生效。
使用方法¶
插件加载后会自动开始工作，通常不需要额外操作。常用入口如下：
- 对话中直接说偏好：模型会调用
remember工具记下。 /selfip：查看当前经验范围与配置文件位置。/selfip scope both：切换经验复用范围。/memory <关键词>：检索记忆。/forget <关键词>：作废匹配的条目（打失效标记，保留历史）。/retro：立即对本会话做一次复盘。/promote：手动把通用条目提升到全局库。/proposals：查看/处理待批的改进提案。
配置与范围¶
记忆默认按工作区分库。需要跨工作区复用时改 scope：
workspace（默认）：只读写本工作区库，经验不跨工作区。global：统一写入全局库，所有工作区共用同一份经验。both：本工作区照常积累，同时读取全局库，并在会话结束时把通用条目提升到全局库。
配置来源优先级：环境变量 > 工作区配置 > 全局配置 > 默认值。
配置文件位置：
* 全局配置：${DSH_HOME}/self-improvement/config.json
* 工作区配置：<工作区>/self-improvement/config.json
改完无需重启，下一次记忆刷新即生效。
提升规则：自动提升保守，避免把一个工作区的偏见广播给所有工作区。只提升 user/agent 来源或无来源标记的条目；系统临时目录下的工作区不参与广播；按 重要性 + 新鲜度 + 命中次数 择优，每次会话结束最多 3 条，低于 10 分不提升。
工具¶
插件提供以下工具供模型调用：
remember：记录一条持久事实/偏好/教训。memory_search：按关键词检索记忆。playbook_use：记录一次 SOP 的使用结果，用于统计成功率。selfip_proposal：查看/处理待用户确认的改进提案。selfip_config：查看或设置经验复用范围。selfip_status：插件自诊断（各工作区记忆库状态、沙箱策略、写入/读取错误与运行计数）。
数据位置¶
记忆与配置文件存储在以下目录：
<工作区>/self-improvement/
config.json 本工作区配置
memory/ 记忆（facts / lessons / methods / resources / principles / hypotheses）
quarantine/ 被隔离的可疑内容
logs/ 会话日志、快照、交接简报、待复盘队列、自诊断状态
playbooks/ SOP（带使用统计与 front-matter）
proposals/ 改进提案与状态
全局库目录结构相同。
适用场景¶
- 需要跨会话保持上下文的 DSH Agent 开发。
- 需要自动沉淀与复用经验、SOP 的长期运行场景。
- 需要安全治理与记忆管理的复杂应用。
注意：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
