前言¶

在 DeepSeek Harness（DSH）智能體開發中，跨會話繼續任務時容易缺少項目上下文。dsh-project-memory 是一個 DSH 插件，用於把文檔、代碼符號、經驗記錄和任務狀態保存爲項目記憶，供後續會話召回。

下面介紹它的定位、核心能力、典型用法和注意事項。

這是什麼¶

dsh-project-memory 由 00080000 維護，分類爲 memory，許可證爲 MIT。它爲 dsh agents 提供持久項目記憶。

該插件按項目保存數據在磁盤上，不使用向量數據庫。運行時爲純 JavaScript，唯一 runtime dependency 是 pdfjs-dist，用於 PDF 文本提取。

核心能力¶

文檔與代碼符號記憶¶

插件支持 PDF、Markdown、plain text 文件記憶，條目帶 path:line citations，便於回源覈對。

它也記錄代碼符號，保留完整類型簽名。L1 regex 提取覆蓋 generics、parameter/return types、overloads、interfaces、type aliases。

如果用戶項目中安裝了 typescript，可以啓用可選的 TypeScript semantic enhancement（L2/L3）。啓用前可在項目內安裝 TypeScript：

npm i -D typescript

如果不需要該增強，可以關閉配置項：

enableTypeScript: false

自動刷新與讀取時記憶¶

插件通過 watch_repo 做內容哈希變化檢測，自動刷新新增或變更文件。

文件被模型 observed/read 時也會進行 read-time memorization，也就是說記憶隨正常開發讀取產生，而不是必須提前全量掃描。

文檔與代碼符號之間會建立 doc ↔ code cross-linking。

召回與經驗記錄¶

使用 query_memory 可搜索 documents、symbols、experience notes。召回基於 BM25，並帶有 CJK optimization。

召回結果帶 path:line citations，用於驗證來源。當命中 blind spot 時，query_memory 會給出 blindSpots-aware recall warnings，提示需要讀源文件。

經驗記錄使用 problem → solution superseding，避免相似問題重複堆積。經驗庫容量有界，project-size capacity 被限制在 100–2000。

跨會話任務¶

TaskBridge 用於跨會話開發任務。新會話繼續時，先 list_tasks，再 select_task 執行 bind、rename、unarchive。

query_memory 可以帶任務類型：

type: 'task'

如果使用 all 類型：

type: 'all'

結果會附加 task-count hint。

用戶側可以使用 /tasks 命令查看 task stack、step progress、involved files、current session binding。

典型用法¶

1、在當前會話中讀取項目文件。插件會在文件被模型 observed 時進行 read-time memorization。

2、需要查詢時調用 query_memory，查 documents、symbols 或 experience notes。

3、確認返回條目的 path:line citations，再回源文件覈對。

4、如果繼續上一輪開發任務，先調用 list_tasks，再調用 select_task 進行 bind、rename 或 unarchive。

5、用戶側用 /tasks 查看當前任務棧、步驟進度、涉及文件和當前會話綁定。

安裝與啓用¶

當前資料沒有提供可覈實的官方安裝命令，因此這裏不給出拼接命令。可以訪問插件目錄頁和 GitHub 倉庫查看插件信息：

https://dsh-plugin.org/plugins/00080000/dsh-project-memory

https://github.com/00080000/dsh-project-memory

運行環境要求 Node >=18。如果啓用 TypeScript semantic enhancement，需要在用戶項目安裝 typescript；如果不需要，可以設置 enableTypeScript: false。

適用場景與注意¶

適合在 DSH 智能體開發中使用，需要持久項目記憶、文檔/代碼符號召回、經驗記錄和跨會話任務的項目。

需要注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 所有數據保存在項目磁盤上，使用前應確認目錄權限和清理策略。
• TaskBridge auto-sync 需要 dsh build with session events + todo_write；已覈實資料提到 verified on 0.1.2-alpha.x。在 older hosts 上，task tools 仍可作爲 plain record list 使用。
• 召回警告提示 blind spot 時，應回到源文件確認，不要只依賴部分摘要。

相關鏈接¶

插件目錄頁：

https://dsh-plugin.org/plugins/00080000/dsh-project-memory

GitHub 倉庫：

https://github.com/00080000/dsh-project-memory