dsh-project：DeepSeek Harness 項目管理插件

前言¶

DeepSeek Harness (DSH) 採用模塊化插件架構。現有的工作流通常依賴文件夾和會話，但缺乏一個聚合這些內容的“項目”概念。dsh-project 插件通過將多個文件夾、多個會話以及共享記憶/指令整合到一個項目實體中，作爲疊加層補齊了這一缺失的概念。

插件介紹¶

插件由 lanyun077 維護，採用 MIT 許可證。它作爲一個疊加層，在不修改 DSH 內核的情況下引入了“項目”概念。

核心功能¶

• 項目樹與收納性：側邊欄出現「項目」入口，展示項目樹（項目 → 文件夾 → 會話）。一個項目可掛載多個文件夾，每個文件夾自動註冊爲工作區，會話可在文件夾間拖入或移出。
• 會話管理：支持在項目的任意文件夾內一鍵新建會話，通過複用 workspaces.connectWorkspace 實現。
• 記憶互通：項目級 PROJECT.md 作爲共享記憶，所有會話開始時整體注入。Agent 可使用 project_memory_write 工具追加記憶，或使用 project_context 工具讀取概覽。
• 項目指令：項目級 AGENTS.md 會被注入到每個會話的 system-prompt 段中，支持熱重載。

安裝與啓用¶

本地插件，需遵循 DSH 插件裝載約定。

1. 讓 dsh-project 可被 profile 解析（例如作爲 file:../dsh-project 依賴，或通過 node_modules 軟鏈）。
2. 在 profile 的 cordis.patch.yml 中添加配置：

- insert:
    - id: project
      name: 'dsh-project'

3. 重啓 DSH web (dsh web)。

典型用法¶

• 在項目的任意文件夾裏點擊新建，即可創建並關聯到該項目的會話。
• 通過 workspaces.connectWorkspace 複用創建會話。
• 在 ~/.dsh/projects/<id>/ 目錄下管理 project.json、AGENTS.md 和 PROJECT.md 文件。
• 通過 project_memory_write 工具追加項目記憶，或通過 project_context 工具讀取概覽。

適用場景與注意¶

• 顯式歸屬：會話必須顯式歸屬項目（在「項目」面板創建或加入），插件不會根據目錄自動推斷項目歸屬。
• 記憶機制：PROJECT.md 目前爲整體注入（無向量檢索），保持精簡；結構化檢索計劃在 v2 實現。
• 版本限制：v1 不做項目級 MCP/技能/默認模型/跨會話子任務派發。

總結¶

dsh-project 提供了 DSH 生態中缺失的項目級抽象。通過樹形結構管理資源，利用 PROJECT.md 和 AGENTS.md 統一上下文和指令，它有助於維護複雜的 Agent 工作流。完整的文檔和源代碼可在 GitHub 上找到。