前言¶

如果你在用 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