前言¶

如果你在用 Claude Code、Codex、Antigravity 或 Grok 做編排，同時又想借助 DeepSeek Harness（DSH）的工具、沙箱、預設和會話歷史來跑具體任務，常見做法是繞開宿主界面，單獨起一個 DSH 進程或手寫橋接腳本。這樣編排器看不到子任務的即時進度，檔位和失敗重試也要自己維護。

下面介紹 DSH Crew。它把 DSH agent 以原生子代理的形式掛進宿主任務面板，orchestrator 的模型不變，活由真正的 DSH agent 執行；在 DSH Web 開着時，worker 還會作爲一等會話出現在 Web UI 裏。

這是什麼¶

DSH Crew 是 DSH 的工作流類插件，npm 包名爲 @zseven-w/dsh-crew，由 ZSeven-W 維護。SkillHub 目錄頁當前版本爲 0.1.0-rc.6；README 寫明已在 DSH 0.1.1-rc.1 上驗證。GitHub 倉庫約 103 stars、4 forks。

它解決的核心問題是：從 Claude Code / Codex / Antigravity / Grok 派發任務給 DSH agent，同時保留宿主原生的子代理進度 UI，並在需要時爲純文本的 DSH 模型補上視覺描述與生圖能力。

核心功能¶

原生子代理進度¶

worker 在宿主裏顯示爲普通子代理。派發數量、當前步驟、工具調用和 token 消耗出現在宿主任務面板；Claude Code 還可通過 claude-hud 狀態欄段查看運行檔位與耗時，例如 ⚙dsh 1▶pro 2m14s 21.7k/606 ✓3。

檔位策略與失敗升檔¶

flash 面向機械性任務，pro 面向需要推理的任務，effort 可從 off 調到 max。tier_policy 可在工具層把所有派發收斂到某一檔；escalate_on_failure 會在 flash 任務失敗後自動用 pro 重試一次，依據執行結果而非事前猜測難度。檔位對應 DSH 已配置的 DeepSeek V4 Flash 與 V4 Pro；DSH 側換模型時，插件側無需改動。

DSH 會話進宿主¶

bundle 裝進 DSH profile 後，每個 worker 是一等 DSH 會話：出現在 Web UI、按工作目錄歸組，並按檔位掛上指定的 Agent 預設。DSH 未運行時，派發回落到獨立的 dsh-jsonrpc-agent runtime，CI 與無界面環境仍可使用。

派發護欄與任務看板¶

每次派發在拉起進程前過檢查：worker→worker 嵌套默認限制在 origin chain 深度 3，環路會被拒絕；同一 workspace 已有運行中任務時，第二個 worker 會被拒絕並返回持有者信息，不會靜默排隊。DSH Crew 設置面板同時充當任務看板，列出運行中與已結束任務的檔位、effort、進度和 token；中途消失的任務會顯示爲孤兒 ghost。

視覺與生圖橋接¶

DSH 模型爲純文本。describe_image 在可用時優先調用 DeepSeek 視覺模型 deepseek-v4-flash-vision-exp，失敗再回落到本機已登錄的 Claude、Codex、Grok、Antigravity CLI，或用戶配置的 OpenAI 兼容 API。generate_image 借用同樣這些 CLI 的生圖能力。會話中粘貼的圖片會保留顯示，模型側收到轉寫文本。

一鍵安裝宿主集成¶

設置頁或命令行安裝器可爲 Claude Code、Codex、Antigravity、Grok 註冊 MCP、權限白名單、HUD 接線和絕對路徑；改動前會自動備份配置文件。

工作方式¶

先做編排，再通過 MCP 派活。整體鏈路如下：

Claude Code / Codex / Antigravity / Grok（orchestrator，模型不變）
  └─ ds-flash / ds-pro  ← 原生子代理殼（進度出現在宿主任務 UI）
       └─ MCP: dsh_run_worker(tier, effort, cwd, worker=)
            ├─ worker="agy"/"grok" → 由該外部 CLI 幹活（顯式 opt-in）
            ├─ hub 可達 → DSH 內的會話（Web UI 可見，按 cwd 歸組）
            └─ 否則     → dsh-jsonrpc-agent 獨立 runtime（worker.cordis.yml）
                 └─ DeepSeek V4 Flash / Pro（DSH SDK，事件流 → 進度與 token 統計）

安裝與啓用¶

裝進 DSH profile¶

從 npm 安裝到 web profile，然後打開 DSH Web：

dsh plugin --profile web add @zseven-w/dsh-crew@latest
dsh web

本地開發可直接鏈到源碼樹，改完重建即時可見：

dsh plugin --profile web add link:/path/to/dsh-crew
dsh web

配置 DeepSeek 憑據（僅 standalone）¶

hub 模式下 worker 使用 DSH 實例已有的 DeepSeek 憑據，無需額外配置。僅當從宿主派發且沒有 DSH 實例在跑時，才需要爲 standalone runtime 準備 key：從 platform.deepseek.com 獲取 API key，寫入 ~/.config/dsh-crew/.env：

DEEPSEEK_API_KEY=sk-...

自檢¶

安裝後可跑 smoke 測試，驗證 hub 或 standalone 路徑是否可用：

node scripts/smoke.mjs

十幾秒內出現 smoke test passed — configuration OK 即表示配置通過。

安裝宿主集成¶

打開 DSH 設置 → DSH Crew，或在倉庫目錄執行：

node src/install/cli.mjs claude   # Claude Code：marketplace + 權限白名單 + HUD
node src/install/cli.mjs codex    # Codex agent + prompt
node src/install/cli.mjs agy      # Antigravity MCP + agent + skill
node src/install/cli.mjs grok     # Grok MCP + agent + 命令
node src/install/cli.mjs all      # 四個宿主一次裝齊

Claude Code 側安裝後需重啓會話生效。

典型用法¶

Claude Code¶

在對話中直接說「把 X 派給 ds-flash」或「把 X 派給 ds-pro」。可用會話命令管理默認值與狀態：

超長任務可讓 orchestrator 用 dsh_spawn_worker 異步派發，再用 dsh_worker_result(wait_seconds) 輪詢結果，避免 MCP 調用超時。

Codex¶

交互 TUI 裏選「spawn ds-pro to …」派發；codex exec 也可直接調 dsh_run_worker。角色文件需設置 default_tools_approval_mode = "approve"，否則 exec 模式下工具調用會被自動取消。

MCP 工具一覽¶

進度同時寫入 ~/.config/dsh-crew/status.d/，供 statusline 或外部監控讀取。

適用場景與注意¶

適合誰： 已在用 Claude Code、Codex、Antigravity 或 Grok 做編排，又希望把具體執行交給 DSH agent，並在宿主面板裏看到即時進度的開發者；本地跑着 DSH Web 時，還可在 Web UI 裏圍觀 worker 會話。

權限與安全： 插件以當前 DSH 進程權限運行。安裝前應閱讀 GitHub 源碼 與 MIT 許可證。Antigravity worker 以 full approval 運行；Grok worker 以 bypassPermissions 運行，deny 規則與 hooks 仍生效。

生態背景： DSH 採用「一切皆插件」的架構；SkillHub 是社區目錄，與 DeepSeek / 幻方無官方從屬關係。

已知限制： DeepSeek 模型本身不支持圖片輸入與生圖，相關能力通過外借 CLI 或自定義 provider 實現；生圖輸出爲平面位圖。Codex 角色必須配置工具審批模式，否則派發無法正常工作。

結尾¶

經過上面的步驟，你可以在熟悉的編排環境裏把任務派給 DSH agent，同時保留原生進度 UI、檔位策略、派發護欄和多模態橋接。更多細節見項目 README 與設置頁。

• SkillHub 目錄頁：https://www.skillhub.cn/plugins/ZSeven-W/dsh-crew
• GitHub 倉庫：https://github.com/ZSeven-W/dsh-crew