DSH Web 提供了會話級別的交互能力,但缺乏持久化的項目概念。開發者在協作或長期維護複雜任務時,需要將項目指令、文件上下文與特定工作目錄綁定。dsh-projects 插件引入了 Cowork/WorkBuddy 風格的項目管理機制,解決了在 DSH Web 中缺乏結構化項目入口和文件夾記憶的問題。
dsh-projects 是 DeepSeek Harness Web 的一個記憶類插件,旨在爲 DSH Web 提供類似 Cowork 或 WorkBuddy 的項目中心。它支持創建綁定真實文件夾的項目,管理項目指令,並通過雙向同步機制與 CLAUDE.md 保持一致。該插件由用戶 alwaysmid-19990 維護,採用 MIT 許可證。
安裝與啓用¶
插件通過 DSH 的插件管理器安裝。安裝後需要重啓 DSH Web 服務以加載側邊欄入口。
dsh plugin --profile web add github:alwaysmid-19990/dsh-projects
安裝完成後,無需額外配置,插件會通過自帶的 cordis.patch.yml 自動註冊。
核心功能¶
該插件提供了一整套項目管理工作流,主要包含以下功能:
- 側邊欄入口:在 DSH Web 側邊欄添加項目入口。如果安裝了
dsh-automation,該入口位於 Automations 下方;若未安裝,則位於 task-board/SSH/skill-explorer 附近。 - 項目卡片網格:展示所有已創建項目的卡片,包含項目名稱、描述、更新時間和文件夾標識,支持搜索。
- 新建項目:支持定義項目名稱、設置項目指令(Prompt),並將項目綁定到本地現有文件夾。
- 項目詳情:在項目詳情頁可編輯指令、瀏覽關聯文件夾文件、手動置頂關鍵文件,並支持修改關聯文件夾。
- CLAUDE.md 雙向同步:支持將項目指令導出爲
CLAUDE.md中的 fenced section,或從文件夾載入現有的CLAUDE.md作爲項目指令。 - 數據持久化:項目數據以 JSON 格式存儲在本地,便於備份和版本控制。
典型用法¶
下面介紹使用該插件進行項目創建和管理的典型步驟。
- 進入項目中心:點擊側邊欄的「項目」入口,打開項目卡片網格。
- 創建項目:點擊「+ 新項目」,輸入項目名稱和指令,然後點擊「選擇文件夾」鏈接現有的工作目錄。
- 管理項目:打開項目卡片進入詳情頁,在此處可以繼續編輯指令、瀏覽文件列表或通過「選擇文件」置頂關鍵文件。
- 記憶同步:在保存項目時,可以勾選「同步到 CLAUDE.md」將指令寫入文件夾的
CLAUDE.md文件中;或者點擊「載入爲項目說明」將文件夾中已有的CLAUDE.md內容讀入項目指令。同步功能默認關閉,僅在保存時按需啓用。
注意事項¶
- 數據存儲:項目數據存儲在
~/.dsh/dsh-projects/projects.json。 - 依賴環境:插件依賴 Node.js 環境版本 >= 18.0.0。
- 權限與安全:插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證。
- 同步機制:默認情況下,編輯指令不會自動修改
CLAUDE.md,只有保存時手動啓用同步纔會寫入文件。
dsh-projects 通過提供結構化的項目管理和記憶同步能力,使 DSH Web 更適合處理長期、多文件的開發任務。相關源碼與文檔可參考 GitHub 倉庫。