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 進程權限運行，安裝前應檢查源碼與許可證。
