前言¶
DeepSeek Harness (DSH) 依靠插件體系構建擴展能力。對於依賴上下文的智能體而言，長期記憶是維持連貫性和提升準確性的關鍵，但單純存儲容易導致信息冗餘、衝突甚至污染。dsh-plastic-memory 是一款爲 DSH 提供記憶存儲、分類、檢索與治理能力的插件，旨在爲 Agent 賦予可塑的記憶能力與生命週期管理。
核心功能¶
該插件主要提供以下能力：
- 記憶分類與可擴展：內置
profile（身份）、preference（偏好）、knowledge（知識）、project（項目）、reference（參考）五類記憶。支持在基礎類型上通過配置模板擴展自定義類型。 - 工作區隔離與寫入保護：項目記憶在物理層面相互隔離，互不可見；全局記憶僅允許只讀訪問。模型無法直接寫入全局域，任何將項目記憶提升至全局的操作必須由用戶顯式確認，防止全局規則污染。
- 內建多層治理體系：提供記憶體檢機制，能夠攔截高危信息（如 API 密鑰），治理規則衝突，防止長期運行帶來的認知退化。
- 因果溯源：每條記憶均錨定原始對話軌跡切片，模型可調用工具回溯記憶產生的原始背景，防範幻覺。
- Markdown 文件存儲：記憶以標準 Markdown 文件形式持久化，支持透明查看與編輯。
安裝與啓用¶
該插件當前處於 Beta 階段（v0.1.1-beta.3）。
運行環境要求：
* Node.js ^22.19.0 || >=24
* DeepSeek Harness v0.1.7-rc.2 或更新
安裝命令：
dsh plugin --profile web add dsh-plastic-memory@0.1.1-beta.3
安裝後插件聲明將自動寫入對應 Profile 的配置文件，重啓 Profile 後生效。
工具集¶
插件提供以下工具，可用於日常交互與記憶治理：
日常交互工具¶
memory_save：沉澱或更新記憶。內置重複性校驗與密鑰嗅探，遇到近似內容時會主動引導更新或強制覆蓋。memory_search：多維全文檢索，支持按類型及作用域過濾。memory_forget：批量移除記憶。刪除前自動歸檔快照，14 天內可恢復。memory_snapshot：快照管理。支持手動打標、差異比對、歷史版本回滾與誤刪恢復。memory_source：因果溯源。回溯記憶提煉時的原始會話軌跡切片。
記憶健康治理工具¶
memory_health：評估全庫記憶質量，返回健康度評分（0-100）。memory_scan：全庫深度體檢。檢查規則層（密鑰、孤立引用、破損文件）和語義層（衝突、冗餘），並給出處置建議。memory_confirm：保質期刷新與處置決策。確認陳舊記憶的置信度以延長生命週期，或對沖突掃描結果進行人工仲裁。memory_promote：記憶提權流轉。將驗證過的項目專屬記憶提升至全局，該操作必須由用戶明確指令確認。
配置與存儲¶
配置項¶
在 Profile 的 cordis.patch.yml 中可調整 plastic-memory 配置。關鍵配置包括：
writeMode：寫入模式（當前爲proactive）。snapshotTokenBudget：注入上下文的最大 Token 預算上限。evidenceLookup：證據溯源模式（off/strict/active）。template：預設場景模板（coding/office/custom）。customTypes：自定義記憶類型定義字典。governance.enabled：是否啓用主動治理層。memoryRoot：存儲根路徑，默認爲${DSH_HOME:-~/.dsh}/memories。
存儲結構¶
記憶存儲在本地文件系統中，目錄結構如下：
<memoryRoot>/
global/ # 全局記憶（跨項目共享）
<id>.md # 獨立記憶詞條
MEMORY.md # 全局聚合索引
<項目slug>-<hash>/ # 項目記憶（工作區隔離）
.workspace # 關聯的本地絕對路徑標記
<id>.md
MEMORY.md
手動編輯注意事項¶
插件具備外部變更感知機制，調用工具前會自動重載。
手動編輯 Markdown 文件時，時間戳必須保持 2026-09-01T08:30:00.000Z 這種 UTC 毫秒格式。格式錯誤的文件會被隔離，不影響其他記憶加載，但在健康檢查中可見。
適用場景¶
該插件適合需要構建具備長期記憶能力的 DSH Profile 或智能體場景。它通過分類、隔離和治理機制，幫助開發者解決 Agent 長期運行中記憶混亂的問題。
