前言¶
在 DeepSeek Harness（DSH）裏做具體任務時，往往要把工作目錄、系統指令、技能、規範以及 MCP 等能力綁在一起，並在不同會話間複用同一套組合。若只靠手工改配置或零散複製文件，換項目就要重來一遍，能力來源一多也不易統一管理。
下面介紹的 dsh-workbuddy-project（包名與倉庫名均爲 dsh-workbuddy-project，維護者 matiomlei）面向「按項目組織 DSH 能力」：綁定工作目錄與項目指令，選擇專家、技能、規範、連接器，保存並編譯爲 DSH preset；支持項目模板、本地與共享能力庫，並對已保存項目鎖定能力版本。個人使用不需要團隊賬號、管理平臺或 Git 倉庫；Git 同步與貢獻則需本機 Git 及倉庫訪問資格。
這是什麼¶
一句話：爲 DeepSeek Harness 按項目配置專家、技能、規則與連接器，複用項目模板，並可接入共享能力庫。
- 目錄頁：skillhub.cn 插件頁
- 源碼與說明：GitHub — matiomlei/dsh-workbuddy-project
- 正式版本：0.3.0（MIT 許可證）
- 運行要求：Node.js >= 22；需兼容
package.json中 peer 依賴範圍的 DSH（README 寫明本輪驗證使用 DSH 0.2.0-rc.2）
Web 界面提供「項目」「能力庫」兩個設置入口；命令和模型管理工具也支持無界面宿主。
核心功能¶
項目與 preset¶
- 綁定工作目錄、項目指令和所選能力，保存並編譯爲 DSH preset。
- 默認項目註冊與編譯目錄爲
<DSH_HOME>/projects；未設置DSH_HOME時使用~/.dsh/projects。可在插件配置中顯式指定projectsRoot。 - 工作目錄內的項目聲明保存在
.dsh/project.json。
專家¶
- 首位專家作爲主專家加載；其他專家提供按需方法論卡。
- 專家團按單個入口加載（README 說明：專家卡不代表獨立多智能體並行執行）。
完整能力包與能力庫¶
- 專家、技能、規範、連接器保留完整目錄及附帶文件；項目能力選擇器展示本地與共享來源。
- 能力庫統一展示本地、項目和共享來源，按來源與類型篩選；新建能力默認保存到本地，無需 Git 倉庫。
- 頂部共享資源庫橫欄僅顯示已連接庫數量與添加按鈕，具體配置在彈窗中完成；填寫 Git 地址後顯示同步設置。
- 固定版本：項目鎖定能力內容，資源庫同步不會自動升級已保存項目；顯式升級後使用新版內容。
連接器¶
- 支持 HTTP/stdio MCP 橋接、本機 DSH 連接器引用和 CLI 包；可檢查連接、授權要求與工具發現結果。
- 當前邊界：MCP 橋接支持 HTTP 與 stdio，SSE 不支持；OAuth 交互登錄尚未實現，可引用已授權的本地 DSH 連接器或使用本機環境變量憑據；CLI 包不自動安裝本機命令。
斜槓命令¶
庫同步與項目升級是兩個動作；保存現有項目保持已鎖定版本。
/project list
/project preview <id>
/project apply <id>
/project upgrade <id>
安裝與啓用¶
安裝命令須以倉庫 README 爲準。從正式 GitHub Release 製品安裝：
dsh plugin --profile web add -w https://github.com/matiomlei/dsh-workbuddy-project/releases/download/v0.3.0/dsh-workbuddy-project-0.3.0.tgz
也可從項目倉庫指定標籤安裝：
dsh plugin --profile web add -w github:matiomlei/dsh-workbuddy-project#v0.3.0
從 npm 安裝指定正式版本：
dsh plugin --profile web add -w dsh-workbuddy-project@0.3.0
若以 npx 運行 DSH，命令前綴可換爲 npx --no-install @deepseek-ai/dsh。安裝後重啓目標 DSH profile 並刷新界面。
本地打包安裝示例：
npm pack
dsh plugin --profile web add -w /absolute/path/dsh-workbuddy-project-0.3.0.tgz
注意：插件在當前 DSH 進程權限下運行；安裝前請自行查看源碼與 MIT 許可證。發佈版與舊開發插件應分別在不同 profile 驗證；二者都提供 /project 命令和項目 preset，避免在同一 profile 同時啓用。
典型用法¶
第一次使用¶
- 打開 設置 → 項目 → 新建項目，選擇已有工作目錄並填寫項目指令。
- 按需選擇專家、技能、規範和連接器；沒有能力包時，也可先創建僅含指令的項目。
- 保存並編譯；配置連接器的項目可點擊「檢查連接器」。
- 新建會話，在 preset 選擇器中選中該項目。已有會話保留創建時配置。
體驗示例模板¶
在 DSH 插件配置中，將 libraries 設爲（路徑替換爲本機實際位置）：
[{"name":"examples","path":"/absolute/path/to/dsh-workbuddy-project/examples/library"}]
隨後在「項目」新建頁面選擇「代碼評審」或「資料研究」模板。模板自帶專家，無外部連接器或憑據依賴。界面添加新 Git 資源庫時需要倉庫地址；預配置本地示例庫無需 Git 同步。
項目模板位於「項目」頁。能力庫同時發現本地能力、已註冊項目自有能力和共享資源庫；本地及項目能力可直接保存，外部已安裝來源爲只讀查看。能力包格式與運行約定見倉庫文檔 docs/capability-packages.md。
適用場景與當前邊界¶
適合誰
- 需要在 DSH 裏爲不同代碼庫或任務維護固定「工作目錄 + 指令 + 能力組合」，並通過 preset 在新會話中一鍵選用的開發者。
- 希望統一管理本地能力、項目內能力與可選 Git 共享庫，且不希望資源庫同步悄悄改掉已鎖定項目配置的使用者。
當前邊界（README 原文要點）
- 共享資源庫不提供成員角色、共享對話或任務協作服務。
- 包編輯器「提交爲 PR」目前創建並推送 Git 評審分支；不會自動在託管平臺建立 PR。
- 發現 WorkBuddy 包不代表導入其賬號授權。
結尾¶
dsh-workbuddy-project 把 DSH 的項目級配置、能力包目錄結構、連接器檢查與版本鎖定收進一套 Web 設置與 /project 命令，適合在「一切皆插件」的 DSH 生態裏做可復現的項目 preset，而不是每次會話手工拼能力。
