前言¶
想在本機跑 DeepSeek Harness（下文簡稱 dsh，npm 包 @deepseek-ai/dsh）的人，通常要自己走一遍完整鏈路：確認 Node 環境、拉包、填 API Key、啓動、處理端口占用。鏈路不長，但每一步都可能卡住——尤其是在 Windows 本機：npx 緩存和全局包擠佔 C 盤空間、Node 由系統託管導致命令不可用、Git Bash 下路徑轉換出錯，都是常見死法。
下面介紹的這個 Skill 把這些步驟固化成了一條可執行流程。它面向 workbuddy 場景，作用是在 workbuddy 裏一鍵安裝、啓動、配置和排障 dsh，並把 Windows 本機的坑提前處理掉。
這是什麼¶
Skill 名稱：DeepSeek Harness 在workbuddy 一鍵安裝，座標 @user_b4bc8872/deepseek-harness-dsh，版本 1.0.1。
它解決的問題很具體：用戶說「幫我安裝 / 啓動 / 配置 DeepSeek Harness、dsh、deepseek harness、npx @deepseek-ai/dsh、DSH Web UI」，或遇到 dsh 無法啓動、端口占用、API Key 配置等問題時，由 Skill 接管後續操作，而不是讓用戶自己對着命令行排查。
需要說清楚的一點：dsh 本身是 DeepSeek 官方開源的 Agent 運行框架；這個 Skill 是社區來源（community），由發佈者 user_b4bc8872 維護，它只是把 dsh 的安裝運維流程打包成了 skill。
核心功能¶
根據 SkillHub 頁面上的簡介，這個 Skill 的能力有四項：
- 一鍵安裝 DeepSeek Harness，即完成 dsh 的安裝與啓動；
- 主動生成桌面快捷方式，裝完不用手動找入口；
- 主動避坑，重點是 Windows 本機的三類問題：C 盤空間緊張、託管 Node、Git Bash 路徑轉換；
- 主動提醒填寫 API Key，因爲 dsh 運行需要 DeepSeek API Key（Skill 標籤爲
requires_api_key=true）。
它對應的觸發場景是：安裝 / 啓動 / 配置 dsh，訪問 DSH Web UI（默認地址 http://127.0.0.1:3080），以及排障（無法啓動、端口占用、API Key 配置）。
安裝與啓用¶
第一步，在 SkillHub 安裝這個 Skill。頁面地址：
https://www.skillhub.cn/skills/user_b4bc8872/deepseek-harness-dsh
或 API 地址：
https://api.skillhub.cn/user_b4bc8872/deepseek-harness-dsh
座標爲 @user_b4bc8872/deepseek-harness-dsh，來源 community，分類 ai-agent。按 SkillHub 的安裝方式把 Skill 加到 workbuddy 後，在對話裏提出需求即可。
第二步，讓 Skill 幹活。在 workbuddy 裏直接說需求，例如「幫我安裝 DeepSeek Harness」或「dsh 啓動不了，端口 3080 被佔了」。Skill 觸發後會按內置流程執行安裝、配置和排障，包括生成桌面快捷方式、提示填寫 API Key。
第三步，確認 dsh 本體已就位。dsh 是 npm 包，官方啓動命令是：
npx @deepseek-ai/dsh
啓動後打開瀏覽器訪問默認 Web UI 地址：
http://127.0.0.1:3080
如果 3080 被佔用，按 Skill 的排障流程處理（換端口或釋放佔用），不必手動改配置。
典型用法¶
以下用法來自 Skill 的觸發條件描述，是可復現的最小路徑：
- 安裝：在 workbuddy 裏說「安裝 DeepSeek Harness」，Skill 完成安裝並生成桌面快捷方式，隨後提醒你填寫 API Key；
- 啓動：說「啓動 dsh」或「打開 DSH Web UI」，Skill 執行啓動命令，你訪問
http://127.0.0.1:3080使用； - 配置：說「配置 DeepSeek Harness」，Skill 引導你完成 API Key 等配置項；
- 排障：說「dsh 無法啓動」「端口占用」「API Key 配置有問題」，Skill 按內置的 Windows 踩坑清單逐項排查。
適用場景與注意¶
適合的人：想在 Windows 本機快速跑起 dsh、不希望手動查資料解決 Node 和路徑問題、已經在用 workbuddy 的開發者。
需要注意的地方：
- 這個 Skill 是社區來源，不是 DeepSeek 官方出品；它操作的 dsh 纔是官方開源框架。
- 運行 dsh 需要有效的 DeepSeek API Key，Skill 會提醒，但 Key 本身要在 DeepSeek 開放平臺申請，Skill 不代發。
- Windows 上的三類坑（C 盤空間、託管 Node、Git Bash 路徑）是 Skill 聲明覆蓋的場景；如果你的環境不是這三類，排障仍可能要自己動手。
- Skill 頁面顯示安裝數爲 0、來源爲 community，屬於較新且未經大規模驗證的 Skill，介意的話可以先在測試環境跑一遍。頁面上的評分和下載量以 SkillHub 實時數據爲準。
結尾¶
這個 Skill 的價值在於把「裝 dsh」從一次手工排查變成一次對話。官方地址：
https://www.skillhub.cn/skills/user_b4bc8872/deepseek-harness-dsh
或 API 地址：
https://api.skillhub.cn/user_b4bc8872/deepseek-harness-dsh
