前言¶

用智能體協作開發時，一個常見的麻煩是：這次會話裏定下的技術選型、約束和踩過的坑，下次會話就丟了。要麼每次重新解釋一遍，要麼讓模型自己往記憶文件裏寫——後者的風險是沒有校驗，模型寫入的內容可能早已和當前代碼對不上。

dsh-project-memory 針對的就是這個問題：把持久性的決策、約束、約定、經驗教訓和事實變成版本化的項目記錄，但模型只能提案，能否入庫由人決定。DeepSeek Harness（DSH）的理念是「一切皆插件」，這個插件就是沿這個思路對記憶能力的擴展。

這是什麼¶

dsh-project-memory 的定位一句話可以說清：爲 DeepSeek Harness 提供「有證據支撐、需人工批准」的項目記憶（Evidence-backed, human-approved project memory）。作者是 luoyuejun9，MIT © 2026 許可證，插件版本 0.1.0，面向 Harness 0.1.0-rc.6。需要說明的是，DeepSeek Harness 目前處於開發者預覽階段，隨着 Harness API 演進，插件可能需要跟進更新。

核心設計¶

人工審批是硬邊界¶

模型工具無法批准或歸檔記憶。插件向模型暴露的工具中，搜索、讀取、校驗都是隻讀的，只有一個寫受限的提案工具。候選記憶提升爲已批准記憶的唯一途徑，是人執行 /memory approve。

證據可校驗¶

每條記憶附帶證據引用，記錄項目相對路徑、精確行範圍、可選符號和 SHA-256 哈希。源碼片段本身不會複製進記憶，記憶裏存的是「哪個文件、哪幾行、當時的哈希是多少」。源碼變更後執行 /memory validate，會逐條報告證據狀態是 verified、stale 還是 missing。

衝突處理¶

存在衝突的活動記憶時，需要通過 supersedes 聲明替代關係，或用顯式的 --keep-both 同時保留，不允許含糊地並存。

本地、確定性¶

搜索是確定性的本地搜索，沒有 embeddings，不依賴雲數據庫或後臺服務。已批准條目是 Git 友好的 JSON。

安裝與啓用¶

dsh plugin --profile web add dsh-project-memory

安裝完成後需要重啓所選的 Harness profile。

環境要求：Node >=22.19。peer 依賴爲 @deepseek-ai/dsh-agent、@deepseek-ai/dsh-commands、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-tools（0.1.0-rc.6），以及 @deepseek-ai/cordis（4.0.1）。

命令與典型流程¶

插件提供的命令：

/memory capture [note]
/memory candidates
/memory approve <candidate-id> [--keep-both]
/memory reject <candidate-id> [reason]
/memory search <query>
/memory show <memory-id>
/memory validate [memory-id]
/memory archive <memory-id>
/memory timeline

日常流程大致是：

1、會話裏出現值得沉澱的決策或教訓時，用 /memory capture [note] 提交一條候選記憶。
2、/memory candidates 查看候選列表。
3、人工審查後，/memory approve <candidate-id> 批准，或 /memory reject <candidate-id> [reason] 拒絕並註明原因；有衝突時按上面的規則選擇 supersedes 或 --keep-both。

後續維護：/memory search <query> 檢索，/memory show <memory-id> 查看詳情，/memory validate 在源碼變更後校驗證據狀態，/memory archive <memory-id> 歸檔，/memory timeline 查看時間線。

存儲與團隊共享¶

存儲路徑：

.dsh/project.json
.dsh/memory/index.json
.dsh/memory/entries/memory_*.json
.dsh/memory/candidates/candidate_*.json

團隊需要共享記憶時，把 .dsh/project.json、.dsh/memory/index.json 和 .dsh/memory/entries/ 提交進倉庫即可；候選文件在審查通過前可以只留在本地。

適用場景與注意¶

適合的場景：長期演進的項目需要跨會話保留決策和約束；團隊希望用 Git 共享一份經過人工把關的記憶；對記憶內容要求可追溯到源碼、且不希望引入 embeddings 或雲服務的環境。

幾點注意：

1、DeepSeek Harness 還是開發者預覽版，本插件面向 0.1.0-rc.6，Harness API 變動後插件可能需要更新。
2、插件以當前 dsh 進程的權限運行，安裝前建議先閱讀源碼和許可證（MIT）。倉庫裏給出了開發命令，可在本地執行 npm install、npm run check、npm pack --dry-run 做驗證。

結尾¶

dsh-project-memory 把「記憶」拆成了兩步：模型負責提案並引用證據，人負責批准，SHA-256 校驗負責發現過期。對於在意記憶可靠性的 DSH 用戶，值得一看。

• GitHub：https://github.com/luoyuejun9/dsh-project-memory
• 插件目錄頁：https://www.skillhub.cn/plugins/luoyuejun9/dsh-project-memory

目錄頁是社區維護的獨立站點，與 DeepSeek、幻方沒有官方從屬關係。