DeepSeek Harness 的設計理念是「一切皆插件」。在使用 DSH 構建智能體時，會話記憶往往需要單獨的 MCP 服務器來管理。這種方式存在侷限性：MCP 服務器通常是「拉取」模式，模型必須主動調用工具才能寫入記憶；且記憶邏輯與 DSH 的會話日誌、權限系統是割裂的。dsh-statecore 插件解決了這個問題，它將 StateCore 的記憶引擎直接掛載到 DSH 的插件上下文中，使記憶管理像其他原生能力一樣參與會話流程。
這是一個用於 DeepSeek Harness 的原生記憶插件，由 yul761 維護。它基於 StateCore 技術，提供可審計的事實和證據鏈。插件採用 MIT 協議，主要解決智能體會話記憶的自動攝入、注入與持久化問題。
核心功能¶
- 自動攝入：在會話過程中自動將
user/message和assistant/message轉入項目記憶，無需模型主動調用寫工具。插件會識別機器生成的消息（如上下文注入、壓縮檢查點）並將其跳過，確保記憶庫只包含真實對話內容。 - 自動注入：在
agent/pre-step階段自動將項目記憶摘要注入模型上下文。 - 壓縮保護：在會話壓縮後，立即對已攝入的記憶進行摘要處理，確保壓縮後不會丟失關鍵事實。
- Web 管理界面：在
dsh web的設置頁面中提供「StateCore Memory」區域，可查看分組事實、打開證據鏈（why）或執行兩步審覈的遺忘操作。 - 五個原生工具：通過
dsh-tools註冊remember、recall、facts、why、forget工具。這些工具擁有誠實的 JSON schema，支持在 Code Mode 中通過await tools.why({factId})獲取結構化證據鏈，並遵循 DSH 的權限和展示流程。
安裝與啓用¶
安裝該插件使用以下命令：
dsh plugin --profile web add -w dsh-statecore
啓動服務：
dsh --profile web
典型用法¶
- 共享數據流：該插件存儲的數據庫與
statecore-mcp共享~/.statecore目錄。在 DSH 會話中記住的事實會同步出現在 Claude Code 的facts工具中。 - 模型調用：記憶摘要（Digest）運行在 DSH 主機已配置的模型上，不需要單獨配置 API Key。
- 本地存儲：默認情況下，數據存儲在用戶主目錄下的
.statecoreSQLite 文件中。
注意事項¶
- 非 MCP 服務器：這是一個掛載在 DSH 插件上下文上的插件，而非獨立的 MCP 服務器。
- 數據隔離：默認
url未設置時，除模型調用外，所有讀寫操作均針對本地嵌入式 SQLite 存儲。 - 生命週期：插件在銷燬時會乾淨地註銷工具，支持熱更新（HMR）。
- 數據共享：與
statecore-mcp共享同一套存儲數據。
dsh-statecore 通過將記憶引擎集成到 DSH 的原生上下文中，提供了比傳統 MCP 服務器更緊密的集成度和更強的可審計性。適合需要在 DSH 會話中建立長期、可追溯記憶的智能體開發場景。
