前言¶
DeepSeek Harness（DSH）支持插件化擴展。在使用 DSH 進行開發時，經常需要在不同會話間切換，或使用多個 CLI 工具協作。如何在會話之間保持項目上下文的一致性，以及如何規範地落盤項目記憶，是開發者常見的痛點。
dsh-project-manager 插件爲 DSH 提供了一個項目看板，並將「項目記憶」作爲落盤數據管理。它會將卡片關聯的項目記憶（STATE + 必讀文檔）自動加載到會話中，並支持按規則持久化、同名檢測、合併以及按組歸檔。
插件信息¶
- 名稱：dsh-project-manager
- 維護者：hoyyang
- 類別：記憶
- 許可：MIT
- 核心價值：項目看板 + 落盤記憶。從卡片打開的會話會自動加載完整、最新的項目記憶（STATE + 必讀文檔）。
安裝¶
安裝過程零配置，開箱即用。
dsh plugin add dsh-project-manager
數據默認讀寫 ~/.ai。寫入操作由插件自帶的 ai-memory 處理，需要 python3 環境（Windows 上此部分會自動關閉，看板功能照常）。
核心功能¶
1. 項目看板與會話自動加載¶
- 看板功能：支持卡片組、泳道（階段）和拖拽排序。
- 記憶自動加載：當從看板卡片新建會話時，插件會自動將該項目完整的 STATE 和標記爲
[必讀]的子文檔注入到會話上下文中。 - 會話信息卡：會話頂部顯示卡片資料、落盤項目詳情、next_action 和操作按鈕。
2. 規範化落盤與記憶持久化¶
- 持久化規則：支持同名檢測、合併、按組歸檔，且支持可撤銷的遷移。
- 防繞過保護：直接寫入
~/.ai的文件操作會被拒絕，寫入必須通過ai-memory，支持文件鎖和樂觀併發，確保多 CLI 共用同一記憶文件時不會覆蓋。 - 規範檢查：落盤時會進行版本化的檢查清單校驗，不符合規範的寫入會被拒絕。
3. Agent 工具¶
插件提供了四個工具，可在項目會話中操作看板（不傳 card 參數時作用於當前會話）：
* card_manage
* repo_manage
* phase_move
* task_manage
4. 其他特性¶
- 零配置：安裝後直接使用。
- 深色主題：跟隨 DSH 的深色主題。
- 文件索引：自動維護文件索引和文件夾組織。
典型用法¶
安裝插件¶
dsh plugin add dsh-project-manager
使用 Agent 工具¶
在會話中調用工具來管理項目狀態：
phase_move { "status": "verify" }
task_manage { "op": "add", "text": "修復登錄 bug" }
調用落盤工具¶
使用 landfill 工具進行記憶讀寫：
landfill { "op": "recall" }
landfill { "op": "persist", "content": "...", "drop": [...] }
環境依賴與注意事項¶
- 運行環境：需要 DSH 的 Web 界面支持（CLI
dsh web或 DSH Desktop）。 - 依賴要求：
- Python3（用於 ai-memory，Windows 上自動處理）。
- Peer dependencies：
@deepseek-ai/cordis >=4.0.1 <5、@deepseek-ai/dsh-tools >=0.1.5-rc <2、@deepseek-ai/dsh-client-ui-slots >=0.1.5-rc <2、@deepseek-ai/schemastery ^3.18.1。
- Agent 工具限制：Agent 工具僅在項目會話中且未指定
card參數時生效。
總結¶
dsh-project-manager 通過看板與落盤記憶的結合，解決了 DSH 中項目上下文管理和記憶持久化的痛點。它不僅提供了可視化的項目管理界面，還通過嚴格的規則和併發控制，確保了記憶數據的完整性和一致性。
