DeepSeek Harness 深度调研报告

于宏儒
0 阅读38分钟

0. 结论先行（太长不看版）

  1. DeepSeek Harness（dsh）是什么：DeepSeek 于 2026-08-13 开源的 Agent 运行时框架（MIT 协议，GitHub: deepseek-ai/deepseek-harness），核心理念是"一切皆插件（Everything is a Plugin）"。它的定位不是又一个"编程助手成品"，而是一套可自由组装 Agent 的运行时底座。官方公式：Agent = Model + Harness。【VERIFIED - 官方仓库/README】

  2. 它说的"插件"是什么：插件是 dsh 的能力单元，通过底层 Cordis 框架加载。模型适配器、工具注册表、会话存储、沙箱、甚至 Agent 主循环本身，全都是插件。扩展 dsh = 挂一个插件，不存在需要 patch 的"特权核心"。【VERIFIED - 官方仓库/README + The New Stack】

  3. 与 Claude Code 的 Skills/MCP/Subagent/Agent Team 的区别（一句话）：Claude Code 是一个成品产品 + 外部扩展点（Skills/MCP/Subagent/Agent Team/Hooks 都是挂在固定核心外的接口）；dsh 是把产品本身拆成插件——扩展粒度深入到 Agent Loop 内部。Claude Code 你不能换它的主循环，dsh 可以。【VERIFIED - 多来源交叉一致】

  4. 怎么创建插件：写一个 TypeScript 文件，导出 apply(ctx) 函数，在函数里用 ctx.tools.register(defineTool({...})) 注册工具，再用 dsh web --patch ./cordis.yml 挂载。约 20 行代码即可跑通一个工具插件。【VERIFIED - CSDN DeepSeek 技术社区 + Datawhale 教程 + 掘金实测】

  5. 用 dsh 做项目代码开发需不需要创建插件：基础使用不需要。装好 dsh → 配模型 Key → 选工作区 → 直接对话即可，Standard 预设自带文件、Shell、搜索、计划、子代理、工作流全套能力。需要自定义工具、自定义 UI、换模型适配器时才需要写插件；轻量级的"指令/工作流"用 Skill 就够了，也不用写插件。【VERIFIED - 官方 Web UI 指南 + 多篇实测】

  6. "0.8 版本提到的使用 Claude Code、Codex"是什么意思：RC.8 把 Claude Code 和 Codex 做成了可按需安装的 Profile Bundle，让 dsh 能把它们当子代理调用。也就是：dsh 当调度层，负责拆任务；Claude Code / Codex 当执行层，各自干专业活。前提是你本机装好了这两个 CLI 并已登录（dsh 从 PATH 找二进制）。注意这是"dsh 调用 Claude Code"，和另一条路（把 DeepSeek 模型塞进 Claude Code 用）是两回事，别混。【VERIFIED - GitHub Release v0.1.0-rc.8 原文 + 机器之心/新浪科技 + The New Stack】

  7. 重要风险提示：dsh 是 Developer Preview，官方用大写警告"THERE WILL BE COMPATIBILITY-BREAKING CHANGES"（会有破坏性变更）。生产环境使用需谨慎。【VERIFIED - 官方 README】

1. DeepSeek Harness 是什么：定位与工作模式

1.1 基本事实（已核实）

  • 发布时间：2026-08-13，与 DeepSeek-V4-Pro-0813 正式版同日发布。【VERIFIED - VentureBeat / The New Stack】

  • 开源协议：MIT。【VERIFIED - 官方仓库】

  • 技术栈：TypeScript monorepo（约 57 个包组、约 50 万行代码，底层含约 300 行 C11 用于 Linux 沙箱）。【VERIFIED - ArceApps 深度解析文章（基于 GitHub API 数据）】

  • 发布背景：DeepSeek 此前发布 DeepSWE 基准成绩时被社区批评"厂商自报、不可复现"，团队承诺开源评测用的 harness——dsh 就是这个承诺的兑现。【VERIFIED - ArceApps，标注为行业解读】

  • 生态热度（引用第三方快照，非官方数据）：发布 12 小时约 5 万星（记者 Justin3Go 计时统计）；GitHub API 快照显示 8 月 15 日约 95,386 星、8,826 fork（Flowtivity 抓取）；另有报道称数日内破 16 万星。【UNVERIFIED - 星数是第三方快照，各来源数字不一致，仅作热度参考】

  • 贡献政策：官方暂不接受外部 PR，引导开发者用 GitHub Discussions 和"写插件"来参与；仓库实行零 Issue 政策。【VERIFIED - 官方仓库 + The New Stack】

1.2 核心定位：Agent = Model + Harness

官方定义很直白：模型是 Agent 的"灵魂"，Harness 是让它干活的"身体"——上下文管理、工具调用、任务规划、文件读写、代码执行、权限控制、记忆、重试机制等全在这里。【VERIFIED - 官方 README + 官方 API 文档】

大白话翻译：大模型是一匹千里马，跑得快但不认路、不会拿东西；Harness 就是马鞍、缰绳、骑手。2026 年的行业共识是模型能力趋同，真正拉开差距的是这个"工程外壳"。

1.3 工作模式：四种预设（Preset）

dsh 自带四种"出厂组合"，体现"一切皆插件"的组装思想：【VERIFIED - 官方文档 + The New Stack + Prompt Genius】

  • Standard（标准模式）：完整编程 Agent。文件系统工具、Shell、文件/网页搜索、Skills、计划、目标、子代理、工作流全都有。日常开发选这个。

  • Code / PTC 模式（编程式工具调用）：不把工具一个个暴露给模型，而是生成一个 TypeScript SDK，让模型写一段程序来批量调用工具——原本要 5 轮往返的工具调用压缩成 1 次执行。省 token、省延迟。PTC 模式在 rc.7 中由 "Code mode" 更名而来。

  • Minimal（极简模式）：只留 bash + 文件编辑器两个工具，专门用于模型基准测试和受控评测。官方跑 DeepSWE 等基准就是用这个模式。

  • Creator（创造模式）：Standard 全家桶 + 运行时检查 + 内存中试验插件 + 预设编写指引。给"造 Agent 的人"用——可以现场组合一套自己的新模式（比如 Code Review 模式、PPT 模式）。

1.4 三种使用入口

  • Web UI：npx @deepseek-ai/dsh web，默认 http://127.0.0.1:3080，浏览器即外壳，会话和日志全在本机。【VERIFIED - 官方文档】

  • Headless CLI：dsh --profile headless "任务"，跑一次持久化任务、打印最终答案退出，适合脚本和 CI。【VERIFIED - 官方文档】

  • Python SDK：pip install deepseek-harness-sdk（0.1.0rc6，要求 Python 3.10+），可嵌入 Python 应用，自带运行时（跑它的机器不需要装 Node.js）。【VERIFIED - 官方 + 社区实测】

1.5 模型无关（Model-Agnostic）

模型适配器本身也是插件。官方提供商目录覆盖 DeepSeek、OpenAI、Anthropic、AWS Bedrock、Azure、Google Gemini（文档仍称 Vertex）、Kimi，以及任意 OpenAI 兼容端点（含本地 Ollama、OpenRouter）。换模型 = 换配置，不用重新编译。【VERIFIED - The New Stack + Prompt Genius + 官方文档】

1.6 会话日志：只追加的事件流（Trajectory）

模型看到的一切——系统提示词、推理过程、工具调用、子代理调度、每一次上下文注入——都写入一条只追加（append-only）的会话日志。恢复、分叉、检索、回放、审计全部基于这条事件流。官方把这条原则叫 "model-visible means logged"（凡是进入模型的内容必须能从日志重建）。【VERIFIED - 官方架构文档 + The New Stack】

1.7 安全与沙箱

  • 文件操作分只读 / 工作区写入 / 完全访问三级权限，敏感操作可配置人工审批。【VERIFIED - 官方 + VentureBeat 对比表】

  • 沙箱：Linux 用 Landlock（自研 Node addon，约 300 行 C11），macOS 用 Seatbelt，Windows 用 ACL restricted-token runner。【VERIFIED - The New Stack】

  • 未选工作区时输入框禁用——这是刻意的入口级防护。【VERIFIED - 官方 Web UI 指南 + 实战指南】

2. "插件"到底是什么：插件机制详解

2.1 底层：Cordis 框架

dsh 跑在 Cordis 上——一个插件元框架，作者崔天一（Koishi 聊天机器人框架作者，前 Jane Street 工程师），配套论文《A Programming Paradigm for Spatiotemporal Composability》（时空可组合编程范式，北大与 DeepSeek 研究者合著，88 页）。Cordis 源码被拷进 dsh 仓库的 vendor/ 目录并重命名到 @deepseek-ai scope。【VERIFIED - ArceApps + 官方仓库 + CSDN 技术社区】

Cordis 只做三件事：插件的加载、卸载、依赖管理。核心是"可逆副作用"：插件注册工具、监听事件、挂网页路由时同时登记清理动作；插件卸载/重载时把这些注册全部撤掉——热插拔不会留下"旧工具还挂着、监听器越叠越多"的残留。【VERIFIED - ArceApps + 微信技术文章（橙子的AI咖啡馆）】

2.2 写插件只需要懂 5 个概念

【VERIFIED - CSDN DeepSeek 技术社区《DeepSeek Harness 初体验：入门、安装与自定义插件》】

  • 插件（Plugin）：一个带 apply(ctx) 的函数，或 Service 子类。框架启动时调用 apply。

  • ctx（上下文）：插件唯一入口，一个带作用域的服务容器。插件从里面拿 tools、llm、sessions 等服务，也把自己提供的能力注册进去。每个能力占一个固定 key（ctx.tools、ctx.llm、ctx.sessions）。

  • inject（依赖注入）：插件声明"我需要哪些服务"，框架等这些服务就绪才挂载它。加载顺序由依赖决定，不由配置顺序决定。

  • 事件（Event）：插件间通信。ctx.on('事件名', 回调) 订阅，用 emit / waterfall / parallel / serial 四种方式派发（普通广播、依次改写同一份数据、并行、按序找第一个愿意处理的）。

  • 可逆 effect：一切注册走 ctx.effect() / ctx.on()，插件卸载时自动撤销。

2.3 三种角色：能力缝（Capability Seam）

一个可替换能力拆成三个解耦角色：【VERIFIED - 官方 ADR-0009 + ArceApps + dev.to】

  • 服务定义（Service Definition）：约定能力叫什么、数据长什么样（如 dsh-shell）。

  • Provider：真正实现能力（如 dsh-bash-local / dsh-bash-sandbox）。

  • Consumer：使用能力的模型侧工具（如 dsh-tool-bash）。

三部分解耦后，换 Provider 不影响 Consumer 看到的工具 Schema。比如把 Shell 从本地换成远程沙箱，模型无感知。

2.4 两类插件：宿主插件 vs 客户端插件

【VERIFIED - TreeRouter 博客《Build DeepSeek Harness Plugins with Cordis Tutorial》+ 官方包结构】

  • 宿主插件（Host Plugin）：Node.js 后端运行，可注册工具函数、读写本地文件、执行 Shell、注入系统提示词。例：自定义文件操作工具、Git 交互插件。

  • 客户端插件（Client Plugin）：浏览器前端运行，扩展 Web UI、加侧边栏标签、渲染新界面组件。例：dsh-workspace-enhance（加文件树侧栏）。

硬约束：宿主插件不能操作 DOM；客户端插件不能直接访问本地文件系统；跨环境通信走 dsh 内部事件总线。

2.5 插件的分发格式：Bundle

插件打包成 npm 包，多两样东西：【VERIFIED - TreeRouter + ArceApps + CSDN】

  • package.json 里声明 dsh.bundle 字段（host/client 入口路径）。

  • 附带一份 cordis.patch.yml，告诉 Harness 把插件插到插件树的哪一行。

安装命令：dsh plugin --profile web add <插件包名>，装完必须重启 Harness 服务（插件宿主代码和浏览器代码都在启动时加载，只刷新页面不够）。【VERIFIED - 多篇实测一致】

2.6 "一切皆插件"到底到什么程度

官方列出的可替换清单（官方原文）：模型、工具、Skills、会话、沙箱、文件系统、存储、Agent 循环、调度、UI。ArceApps 的评论一针见血：Agent Loop 是插件意味着 dsh 不是"又一个 Claude Code"，而是"关于 Agent 运行时该如何结构化以支持自我修改 Agent 的宣言"。【VERIFIED - 官方 README + ArceApps】

3. 如何创建一个插件（完整实操）

以下代码与命令均来自公开教程实测（CSDN DeepSeek 技术社区、Datawhale 教程、掘金、微信公众平台《DeepSeek Harness 插件开发全指南》），以官方包 API 为准。【VERIFIED - 多来源交叉一致】

3.1 环境准备（写 TS 插件需要源码仓库）

日常使用只需 npx @deepseek-ai/dsh web；开发原始 TS 插件需要克隆源码（官方入门文档方式）：

 git clone https://github.com/deepseek-ai/deepseek-harness.git
 cd deepseek-harness
 corepack enable
 pnpm install
 pnpm run build        # 不能省略，否则 Web 端缺构建产物、插件不生效

Node.js 版本要求：^22.19.0 || >=24.0.0，实测建议直接用 Node 24（社区实测 v24.19.0）。【VERIFIED - 官方 + 社区实测】

3.2 极简插件：什么都不注册

一个最简插件只有三样东西：

 import type { Context } from '@deepseek-ai/cordis'
 ​
 export const name = 'hello'        // 插件名，仅诊断用，可省略
 export function apply(ctx: Context) {
   console.log('hello from my first plugin')
 }

3.3 工具插件：greet 示例（推荐参考）

 import type { Context } from '@deepseek-ai/cordis'
 import { defineTool } from '@deepseek-ai/dsh-tools'
 ​
 export const name = 'greet-tool'
 export const inject = ['tools']    // 声明依赖工具注册服务
 ​
 export function apply(ctx: Context) {
   ctx.tools.register(defineTool({
     name: 'greet',
     description: 'Greet someone by name.',
     parameters: {
       name: { type: 'string', required: true, description: 'The name to greet' }
     },
     async execute(args) {
       return `你好,${args.name}!`
     }
   }))
 }

模型通过 description 知道工具存在，通过 parameters 的 JSON Schema 知道怎么调用。【VERIFIED - Datawhale 教程 + 掘金】

3.4 挂载到 Web 服务

新建 cordis.yml（或 cordis.patch.yml）：

 - insert:
     - id: greet-tool
       name: "/你的绝对路径/deepseek-harness/scratch-plugin/src/greet-tool.ts"

启动：

 pnpm dsh web --patch ./scratch-plugin/cordis.yml
 # 端口冲突时：pnpm dsh web --patch ... --port 3082

验证：设置 → 插件列表确认"已启用"，然后在会话里让 Agent 调用 greet 工具，能看到工具调用的输入输出完整展开，插件闭环跑通。【VERIFIED - 掘金 + CSDN 实测】

3.5 生产级插件的硬规则

【VERIFIED - 微信公众平台《DeepSeek Harness 插件开发全指南》（基于 0.1.0-rc.6 源码实测）+ CSDN】

  • 必须用具名导出 name / inject / Config / apply，禁止 default export（出现 default 整个命名空间被折叠，inject 丢失）。

  • inject 只声明硬依赖，可选服务用 ctx.get(name)。

  • Config 必须是 Standard Schema。

  • 工具必须走 defineTool，参数校验、输出 Schema、execute 返回规范 JSON。

  • 密钥永远不要写进 patch——--dump-config 会把配置整份打出来。

  • 排错第一手段：dsh --profile web --dump-config 查看叠加后的生效配置。

3.6 用现成插件（日常更常见）

 dsh plugin --profile web add @dsh-external/dsh-git-workflow   # 示例：Git 工作流插件
 dsh plugin --profile web update                                # 更新全部
 dsh plugin --profile web remove <插件名>                       # 卸载
 dsh restart web                                                # 重启生效

社区插件发现渠道：GitHub topic dsh-plugin；第三方目录 deepseek-harness-plugin.com。注意：装第三方插件前必须审查源码——插件运行在宿主进程里，属于可信代码，能调用工具、运行程序、读工作区。【VERIFIED - 社区共识 + 效率君评测】

4. 与 Claude Code / Codex 扩展机制的对比

4.1 先厘清一个前提

Claude Code、OpenAI Codex 是面向终端用户的成品编程 Agent；DeepSeek Harness 是面向 Agent 构建者的运行时底座。这决定了扩展哲学的差异。【VERIFIED - VentureBeat + The New Stack + 多篇对比文章一致】

4.2 Claude Code 的扩展机制（官方文档口径）

Claude Code 官方文档列出的扩展点：【VERIFIED - Claude Code 官方文档 features-overview】

  • CLAUDE.md：每次会话都加载的持久项目上下文（约定、规则）。

  • Skills：可复用的指令/知识/工作流，Markdown 文件（SKILL.md），可被 /命令 调用或模型自动加载。加载进当前上下文，占用主窗口。2026 年起自定义 slash commands 已并入 Skills。

  • MCP：连接外部服务和工具的开放协议（数据库、Slack、浏览器等），MCP server 提供工具。

  • Subagents：独立上下文窗口的隔离执行者，只把摘要返回主会话，不污染主上下文。

  • Agent Teams（实验性，默认禁用，2026-02 发布）：多个相互通信的独立 Claude Code 会话，共享任务列表自我协调，token 成本显著更高。

  • Hooks：生命周期事件（PreToolUse 等）触发的确定性自动化。

  • Plugins：打包层——把 Skills/Hooks/Subagents/MCP servers 打包成一个可安装单元，支持命名空间和 marketplace 分发。

4.3 核心差异：扩展粒度不在一个层级

Claude Code 的扩展 = 在成品外面加接口；dsh 的插件 = 把成品本身拆开。

  • Claude Code 的 Skills/MCP/Subagents/Agent Teams 全部是"绕着一个固定 Agent Loop 打补丁"。你不能换 Claude Code 的主循环、不能换它的会话模型、不能改它的上下文压缩算法——这些是厂商锁死的核心。

  • dsh 的插件可以替换任何一层：模型适配器、工具集、会话存储、沙箱、Agent Loop、调度、UI。ArceApps 的原话："你可以用自己实现多 Agent 架构的插件替换主循环；在 Claude Code 里这只能靠 fork 仓库"。【VERIFIED - ArceApps】

4.4 dsh 的插件 vs Claude Code 的 Skills/MCP/Subagent/Agent Team

逐项对照（用大白话）：

  • dsh 插件 vs Claude Code Skills：Skills 是"教模型怎么干活"的文档（知识/工作流）；dsh 插件是"改变系统能力"的代码（注册工具、换适配器、注入系统提示词）。dsh 自己也有 Skill 能力（从项目 .dsh/skills、.agents/skills、用户目录发现 SKILL.md，模型按需加载），它作为插件家族的一员存在，定位与 Claude Code Skills 类似。【VERIFIED - MoClaw + CSDN 技术解析】

  • dsh 插件 vs Claude Code MCP：MCP 是一个跨产品的工具连接协议。dsh 本身就是 MCP 客户端（还支持把 dsh 暴露成 MCP server / ACP），能接同一套 MCP 生态。MCP 是"接外部服务"的一层，插件是"整个运行时的组装单元"——两者不是竞争关系，dsh 用插件把 MCP 客户端能力装进来。【VERIFIED - The New Stack + Prompt Genius】

  • dsh 插件 vs Claude Code Subagent：Subagent 是一种执行模式（隔离上下文干活），dsh 也有 subagent 能力（in-process / fork / ACP / Codex / Claude Code 五种 provider）。dsh 的独特之处是 subagent provider 本身也是插件——这是 RC.8 把 Claude Code/Codex 做成 Profile Bundle 的架构基础。【VERIFIED - CSDN 技术解析 + 官方包结构】

  • dsh 插件 vs Claude Code Agent Team：Agent Team 是多会话协调的执行模式；dsh 的对应物是 Workflow 能力（模型生成受限 JavaScript 编排脚本，在 Worker Thread VM 里跑，可并行启动子代理）。注意：dsh 仓库里也有 "Agent Teams" 包正在孵化（2026-08-18 提交 "incubate Agent Teams packages"）。【VERIFIED - 官方仓库提交记录 + CSDN 技术解析】

4.5 一句话总结差异

Claude Code 是一台精密瑞士手表：齿轮不能换，但表盘、表带、表冠给了标准接口（Skills/MCP/Hooks/Subagents/Agent Teams）。 Codex 是硬核工程车：Rust 内核 + 双形态（本地 CLI/云端），扩展走 MCP + AGENTS.md + 配置。 DeepSeek Harness 是一箱乐高：没有成品，全是积木，连"组装方式"本身都可以换。【VERIFIED - 行业对比文章共识】

4.6 已知短板对比（诚实清单）

维度DeepSeek HarnessClaude Code / Codex
成熟度开发者预览版，破坏性变更警告成熟商业产品
托管后台 Agent未提供（官方未文档化）提供
GitHub 原生 PR 工作流未完成集成Claude Code 有 GitHub Actions；Codex 有 Cloud 任务/自动 PR
扩展上手成本高（Profile/Bundle/Patch 概念多）低（一次安装开箱即用）
配置复杂度cordis.yml 组装，patch 整行替换易踩坑配置文件相对简单

【VERIFIED - VentureBeat 对比表 + Prompt Genius + 社区批评（"面向造 Agent 的人"而非普通用户）】

5. RC.8（"0.8 版本"）中的 Claude Code / Codex：含义与操作

5.1 版本澄清

  • 用户所说的"0.8 版本" = v0.1.0-rc.8（2026-08-19 发布，预发布版）。【VERIFIED - GitHub Release 原文】

  • 相关版本时间线：v0.1.0-rc.5（8 月 13 日开源首发）→ RC.7（8 月 17 日，Codex/Claude Code 子代理任务接入 Job Panel）→ RC.8（8 月 19 日，两者升级为可按需安装的 Profile Bundle）。【VERIFIED - 腾讯云开发者社区 + 新浪科技/机器之心】

5.2 RC.8 官方原文（关键一条）

GitHub Release v0.1.0-rc.8 原文（New Features）：

Make Claude Code and Codex subagents installable on demand as Profile Bundles, with non-interactive permission modes and named instances for Codex

中文官方发布说明：

Claude Code 与 Codex 子代理均可作为 Profile Bundle 按需安装，Codex 同时支持非交互权限模式和多个命名实例

【VERIFIED - GitHub Release 原文】

5.3 这是什么意思：dsh 把 Claude Code/Codex 变成"可调度的队友"

核心含义（多来源解读一致）【VERIFIED - 机器之心/新浪科技 + KAD + 网易/AppSo + CSDN】：

  1. dsh 变成统一调度层：上层（dsh + 主模型，比如 DeepSeek V4 Pro）负责拆解任务、编排工作流；底层根据任务需要，把 Claude Code 或 Codex 拉进来当子代理干活。架构演进路线：RC.7 先让两者的子代理任务出现在 Job Panel（任务面板），RC.8 再升级为独立 Profile Bundle 按需安装。

  2. 为什么要这么做：不同编码 Agent 各有专长——Claude Code 在复杂推理/大代码库探索上强（SWE-Bench Verified 80.8%，但 token 消耗约为 Codex 4 倍）；Codex 执行直接、token 效率高、适合验收标准明确的实现类任务。一个任务里可以"前端样式交给 Claude Code，后端 API 重构交给 Codex，整体编排用 DeepSeek V4 Pro"。

  3. Codex 的两个新能力：

    • 非交互权限模式（non-interactive permission mode）：无需人工确认跑完整个流程，适合 CI/CD 和 Harness 批处理。

    • 多个命名实例（named instances）：同一台机器可并行配置多个不同用途的 Codex 子代理（不同权限、不同工作目录）。

  4. 配套机制：reportDelivery 让子代理完成任务后主动回报并唤醒父任务；web_search 支持并发查询。

5.4 前置条件（必须满足）

【VERIFIED - The New Stack + Prompt Genius + 社区实测】

  • 本机已安装 Claude Code CLI（npm install -g @anthropic-ai/claude-code）和/或 Codex CLI，并已完成各自的登录认证。

  • dsh 通过解析 PATH 里的二进制实现委托——你自带安装和登录，dsh 只负责调用。

  • 两个子代理 provider 默认禁用，需要在设置/配置里显式启用。

  • 官方还提供 bridges，可把用户现有的 hooks.json（Claude Code/Codex 的）映射到 dsh 的拦截点——官方明说这是"兼容路径，不是更优设计"。

5.5 如何操作（社区已验证路径 + 官方发布说明）

由于 RC.8 的官方 Profile Bundle 安装命令细节在公开资料中尚未统一成文，以下分两条路径说明：

路径 A：官方内置子代理 provider（RC.7/RC.8 已有，需显式启用）

  1. 安装并登录 Claude Code / Codex CLI（PATH 可解析）。

  2. 在 dsh 的 settings.yaml 里找到标准预设中的 codex 和 claude-code 两个 provider 行（默认 disabled: true），去掉 disabled 启用。【VERIFIED - CSDN 用户实测（fating__）："标准预设里赫然躺着 codex 和 claude-code 两个 provider 行，默认 disabled"】

  3. 在会话中让主 Agent 拆解任务并委派给子代理；子代理执行过程可在 Job Panel 查看（RC.7 起支持）。

路径 B：社区插件 dsh-plugin-product-subagents（有完整文档的成熟方案）

这个社区插件把 Codex、Claude Code 和任意 ACP CLI 接到 dsh 的子代理通道，支持"可续聊"子代理（保留远程会话 ID，多轮追加消息）：【VERIFIED - 夜雨飘零博客 + GitHub shaokeyibb/dsh-plugin-product-subagents】

 # 要求：PATH 上有至少一个已登录的产品 CLI（claude、codex 或 ACP CLI）
 dsh plugin --profile web add dsh-plugin-product-subagents
 dsh restart web   # 重启后插件才加载

典型用法：会话里让模型调用 product_roles 列出角色库，product_agents 看哪些 Provider 在 PATH 上可用，然后按审查/探索/排障/落地分工派活。持久注册表默认在 ~/.dsh/product-subagents-registry.json（运行时状态，勿提交 git）。注意手动装包要用 pnpm（npm 会覆盖 @deepseek-ai/dsh-tools 符号链接导致工具调用报错）。

5.6 千万别混淆的另一条路：把 DeepSeek 模型接入 Claude Code

官方 DeepSeek API 文档（api-docs.deepseek.com/guides/coding_agents）记载的是相反方向：通过 DeepSeek 提供的 Anthropic 兼容端点（api.deepseek.com/anthropic），把 DeepSeek 模型（deepseek-v4-pro[1m] 等）跑进 Claude Code 客户端里。配置方式是设置 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN 等环境变量。【VERIFIED - DeepSeek 官方 API 文档】

两条路的本质区别：

  • Harness 调 Claude Code（RC.8 的能力）：Claude Code 用自己的 Claude 模型/登录，dsh 只调度它。

  • DeepSeek 模型跑在 Claude Code 里：Claude Code 客户端 + DeepSeek 模型 + DeepSeek Key，与 dsh 无关。

6. 用 dsh 做项目代码开发：实践路径

6.1 结论：基础开发不需要创建插件

官方 Web UI 指南和大量实测都确认：日常项目开发走"装 → 配 → 选 → 聊"四步即可，Standard 预设自带完整编程 Agent 能力，无需写任何插件。【VERIFIED - 官方 Web UI 指南 + 阿里云开发者社区 + 效率君评测】

6.2 完整流程（官方推荐路径 + 实测补充）

第一步：安装

 # 要求 Node.js ≥ 22（推荐 24 LTS）
 npx @deepseek-ai/dsh web
 # 或全局安装
 npm install -g @deepseek-ai/dsh
 dsh web

首次运行会从 npm 拉整个运行时（不是轻量脚本），良好网络也要几分钟，期间进程占满一个 CPU 核心、不打印输出属正常现象——别在 60 秒时杀掉。启动后浏览器自动打开 http://127.0.0.1:3080（rc.8 起自动打开，不想自动打开用 dsh web --no-open）。【VERIFIED - 官方 + 社区实测 + 腾讯云解读】

第二步：配置模型

设置 → 模型（Models）→ 填入 DeepSeek API Key（sk- 开头）→ 保存即生效，无需重启。Key 只写进本地凭据文件 $DSH_HOME/.credentials.yaml（默认 ~/.dsh/），界面只显示脱敏描述符。也可以添加 Anthropic、OpenAI、Bedrock、Vertex、Azure、Codex 或自定义 OpenAI 兼容网关。【VERIFIED - 官方 Web UI 指南】

第三步：选择工作区

点击 Choose workspace 添加项目目录并选中。工作区是安全边界——Agent 只能操作你显式添加的目录，未选工作区前输入框禁用。强烈建议项目先用 Git 版本管理，Agent 真的会改文件和删文件，Git 是最后保险。【VERIFIED - 官方指南 + 实战教程】

第四步：发起任务

新建会话直接对话即可，比如"总结这个仓库的结构，找出主要模块"。Agent 能读文件、改代码、跑命令、拆子任务；敏感操作（删文件、危险命令）Web UI 会弹人工审批。界面语言可在设置里切中文。【VERIFIED - 官方指南】

6.3 什么时候才需要插件 / Skill

  • 需要自定义工具（内部工单系统、专有 API、公司网关）→ 写工具插件（见第 3 节）。

  • 需要自定义 UI（侧栏文件树、专属面板）→ 写客户端插件。

  • 需要换模型适配器 / 换沙箱 / 换 Agent Loop → 写插件替换对应能力缝。

  • 只是想把公司规范、代码审查清单、部署流程固化成可复用指令 → 用 Skill（Markdown 文件放进项目 .dsh/skills 或 .agents/skills），不用写插件。【VERIFIED - MoClaw 插件 vs Skill 辨析 + CSDN 技术解析】

  • 想做一个固定能力组合的专用 Agent（如 Code Review 模式、PPT 模式、API 文档助手）→ 用 Creator 模式 + cordis.patch.yml 组合 Preset，团队成员直接用。示例（来自 CSDN 实测）：

 # api-doc-agent.cordis.patch.yml
 - id: model-override
   config:
     model: z-ai/glm-5.2
     provider: qiniu
 - id: tool-whitelist
   config:
     allowed: [read_file, bash]
     bash_whitelist: ["node scripts/parse-openapi.js"]
 - id: system-prompt-override
   config:
     sections:
       - id: role
         content: "You are an API documentation specialist. Only read files and run the OpenAPI parser script."

启动：dsh --profile web --patch api-doc-agent.cordis.patch.yml

6.4 效率实测参考（第三方，非官方）

  • 腾讯新闻实测（2026-08-20）：简单任务 dsh 能正常完成；复杂任务纠错后完成度也不错。与 Codex、WorkBuddy 对比做 3D 游戏，dsh 交付最快（约 13 分钟）但初期有错误（角色未受绳索约束），指出后修复。【UNVERIFIED - 第三方对比测试，样本小，仅作参考】

  • 搜狐转载的早期尝鲜反馈：单次 Agent 循环平均 3.8 秒（称 Codex 同类任务 1.2 秒）、token 消耗高 35%、新手配置 Skills 需手写 YAML/JSON 双模态配置。【UNVERIFIED - 第三方转述，数字无法核实，谨慎引用】

  • 官方 V4-Pro 定价（2026-08-16 起峰谷定价）：V4-Flash 缓存未命中输入 0.14 美元/百万 token、输出 0.28；V4-Pro 输入 0.435、输出 0.87；缓存命中低至 0.0028/0.003625。峰谷窗口 UTC 01:00-04:00 和 06:00-10:00（北京时间 9:00-12:00、14:00-18:00），非峰值半价。【VERIFIED - 官方 API 文档；但注意有独立分析指出相对旧平价体系实际是涨价，见第 7 节】

7. 风险、限制与选型建议

7.1 必须知道的限制（全部有出处）

  1. 开发者预览版：官方 README 大写警告 "THERE WILL BE COMPATIBILITY-BREAKING CHANGES"；VentureBeat 明确提示"企业开发者不应把它当作稳定生产平台"。【VERIFIED】

  2. RC.8 存储不兼容：SQLite 后端重构（Schema 升级），旧会话数据无法读取，官方未提供迁移工具；升级前务必备份 ~/.dsh。【VERIFIED - GitHub Release + 腾讯云解读】

  3. npm 版本滞后：截至多篇解读发布时，npm latest 仍是 rc.7，rc.8 走 @next 标签（npm install -g @deepseek-ai/dsh@next）或源码构建（git checkout dsh-v0.1.0-rc.8）。【VERIFIED - 腾讯云解读；另一篇 CSDN 实测 npm install @0.1.0-rc.8 成功，两者并存，建议以官方 Release 为准】

  4. 无托管后台 Agent：官方未文档化 DeepSeek 管理的托管服务（Claude Code/Codex 有）。【VERIFIED - VentureBeat/Prompt Genius】

  5. GitHub PR 工作流未完成。【VERIFIED - Prompt Genius】

  6. 插件安全：第三方插件运行在宿主进程内，属可信代码，能读写工作区、执行命令。安装前必须审查源码、许可证、更新频率。官方立场：不认为官方仓库的包比社区包更权威。【VERIFIED - 官方 + 社区共识】

  7. 配置复杂度：社区精准批评——"一切皆插件"对开发者是卖点，对普通用户意味着配置复杂度；patch 按 id 整行替换而非深度合并，覆盖一行要重述所有键，新手易踩坑。【VERIFIED - 社区对比文章 + CSDN 技术解析】

  8. 价格变化：DeepSeek V4-Pro 2026-08-16 起从平价改为峰谷定价。有独立分析（aitoolsreview）指出：即便"非峰"价，输出价格也是旧平价体系的约 2.28 倍，峰值约 4.55 倍——是实际涨价而非降价。选用 dsh + DeepSeek API 需按实际用量建模。【VERIFIED - aitoolsreview 独立分析，标注为第三方测算】

7.2 选型建议（基于以上事实的判断）

  • 想"装完就干活"：选 Claude Code 或 Codex，别选 dsh——dsh 的默认体验和稳定性目前不如两者。

  • 想自己造 Agent 产品/内部 Agent 平台：dsh 是目前唯一把 Agent 运行时每一层都开源可替换的选择，值得上车（20 分钟能跑通）。

  • 要做模型/Agent 评测研究：Minimal 模式专为基准测试设计。

  • 要自由换模型、对抗价格波动、数据主权/可审计：dsh 天然支持（MIT 开源、会话全程可追溯、可完全私有化）。

  • 预算敏感：框架免费，只付模型调用费；但要注意 7.1-8 的价格变化。

  • 务实建议：多数团队现阶段是"Claude Code 处理需要思考的任务、Codex 处理需要苦力的任务"双装；dsh 等成熟后再进日常使用候选名单。若要用 dsh 调度 Claude Code/Codex，先确认本机 CLI 已装好登录好，再在 settings.yaml 里启用对应 provider。【VERIFIED - 行业对比文章共识】

8. 社区公认好用的插件推荐清单

8.0 先说清楚推荐口径（必读）

  • 不存在官方"必装清单"。dsh 处于开发者预览版，插件生态处于早期爆发期（开源自 8/13，一周内 GitHub 带 dsh-plugin 标签的仓库达 6000+，社区精选清单 awesome-dsh-plugin 收录 1000+）。本清单是多篇独立社区实测盘点（腾讯新闻、脚本之家/七牛云、CSDN、夜雨飘零、53AI 等）交叉汇总的结果，非官方审核名单。【VERIFIED - 多来源一致；插件数量为 2026-08-18 前后社区盘点口径】

  • 三类东西常被统称"插件"，务必分清：① 原生 dsh.bundle（能 dsh plugin add 装进去）；② 独立桌面/Web 工作台（如 DSH Desktop、Open Design，单独安装）；③ Skill / MCP / 浏览器扩展（按各自协议接入）。判断标准不是仓库名或 GitHub Topic，而是是否声明 dsh.bundle 字段。【VERIFIED - 脚本之家/七牛云 10 插件详解】

  • Star 不是质量证明。GitHub dsh-plugin Topic 由仓库作者自行添加，高 Star 只说明社区关注度，不保证能装、不保证质量、不代表官方背书。【VERIFIED - 脚本之家/七牛云】

  • 安全红线（比清单本身更重要）：官方插件索引自己写明"进了插件市场，不代表通过了安全审计"。社区插件以你本机的权限运行，能读你的文件、碰你的凭据、走你的网络。装之前至少花半分钟看仓库、安装脚本、最近更新时间。【VERIFIED - 腾讯新闻 16 插件实测 + 官方索引声明】

  • 以下 Star/下载量均为 2026-08-17~18 GitHub 页面快照，会持续变化。【UNVERIFIED - 第三方快照】

8.1 第一批：先解决"好不好用"的基础问题（刚需级）

1. dsh-market / dshmarket —— 插件市场（生态入口）

  • 推荐理由：搜索、安装、更新、启停、备份插件全部在设置界面点完，是进入插件生态的入口。社区共识"第一个就装"。【VERIFIED - 腾讯新闻 + 脚本之家 6 插件实测】

  • 社区反馈：腾讯新闻实测"装完之后不少插件在界面上点两下就装好了，省事不少"；dshmarket 实测版本 1.11.2。【VERIFIED - 实测文】

  • 优势：把高频插件操作图形化；同生态还有 dsh-market（dshmarket.com，收录 365+ 插件）、dshplugin.io（中文目录 154+）、dsh.market（573 个）等多个市场可互查。【VERIFIED - 社区盘点】

  • 劣势：本身就是插件，装它之前还得先敲一次命令行；复杂插件仍要手装；市场质量参差，仍需自己审。【VERIFIED - 实测文】

2. dsh-at-file —— 输入框 @ 引用文件

  • 推荐理由：在输入框打 @ 就能搜索工作区文件并引用，直接补上原生界面最明显的缺口之一，多份清单列为"刚需/高频必装"。【VERIFIED - 腾讯新闻 + 脚本之家】

  • 社区反馈：腾讯新闻评价"我个人觉得算刚需"。【VERIFIED】

  • 优势：告别手敲文件路径，大幅提升对话带文件效率。

  • 劣势：依赖工作区索引，超大仓库首次索引可能变慢；仅辅助输入，不含文件内容分析。

3. dsh-context —— 上下文占用可视化

  • 推荐理由：把上下文构成、token 变化、压缩和裁剪过程做成面板，能判断长任务"为什么越跑越慢"、从哪一步开始遗忘要求。【VERIFIED - 53AI + 脚本之家】

  • 社区反馈：脚本之家 6 插件清单定位"长会话推荐"（实测版本 0.11.2）；53AI 报道中开发者用它排查长任务。【VERIFIED】

  • 优势：只读、零副作用，排障定位类问题最直接的工具；同方向还有 dsh-context-doctor（审计 AGENTS.md 指令链/技能目录/工具 schema 的 token 成本，检测重复与冲突）。【VERIFIED - 社区盘点】

  • 劣势：只诊断不解决，看完还得自己处理；面板信息对新手有一定理解成本。

4. dsh-plugin-check —— 插件体检

  • 推荐理由：下载社区插件后先扫一遍——覆盖 Manifest、Patch、构建产物、Profile Bundle、Hub 收录共 33 项检查，输出 pass / warn / fail 报告。【VERIFIED - 社区盘点】

  • 社区反馈：社区共识"装前先扫"，是插件生态早期最实用的安全习惯工具。【VERIFIED】

  • 优势：只读、不修改被检查项目、不执行构建，可放心跑。

  • 劣势：检查格式/构建类问题，替代不了人工审源码——恶意代码不在它的检测范围。

8.2 第二批：功能增强（按场景装）

5. DeepSeek Harness Desktop —— 桌面客户端（非官方）

  • 推荐理由：不装 Node.js、不敲命令，下载安装包双击即用，自动启动和管理本地 Harness 服务；托盘常驻、任务完成弹通知、跟随系统深浅色、自动更新；路线图含手机远程控制（iOS/Android 发起任务、看进度）。【VERIFIED - CSDN 评测 + ima/AI训练师 + 官方 README】

  • 社区反馈：社区 Star 最高（10.3k~11.2k 快照），累计下载 8.3 万+；CSDN 评测结论"解决普通用户门槛是真实痛点，开源 MIT 不套壳卖钱，轻量封装风险可控"。【VERIFIED - 快照 + 评测】

  • 技术构成：Electron 外壳 + 官方 Harness Git 子模块（固定版本跟随上游），渲染进程关 Node 权限、开 contextIsolation 和沙箱；暴露 desktopProfiles / desktopPnpm 两个扩展接口。【VERIFIED - CSDN 评测】

  • 优势：对小白最友好的入口；底层仍是完整 dsh（四种模式、插件、会话、事件溯源都在），与命令行版数据互通、迁移成本≈0；高危操作照样弹确认框。【VERIFIED - 拓荒者IT 实测】

  • 劣势：社区维护、非官方产品；当前正式包只支持 Windows x64 和 Apple 芯片 Mac，Intel Mac/Linux 无正式版；底层 dsh 仍是预览版，破坏性更新照旧；插件市场功能仍在规划中（README 自述，别当已上线）。【VERIFIED - 脚本之家/七牛云 + 官方 README】

6. ModLens（@liustack/modlens）—— 给纯文本模型"装眼睛"

  • 推荐理由：生态里最早的视觉插件之一。粘贴图片 → 调用外部视觉引擎 → 把 OCR 文字、布局、实体、语义整理成结构化"证据"再交给纯文本模型推理。【VERIFIED - CSDN DeepSeek 社区 + 腾讯新闻】

  • 社区反馈：约 2.6k Star、355 次提交，"维护得比较成熟"；腾讯新闻实测粘图/识别文字/看图表可用。【VERIFIED - 快照 + 实测】

  • 优势：机制是挂在消息管线上、把图像变成"模型能读的证据"再拼回上下文，不是简单桥接一个视觉 API；为纯文本模型的路由增加视觉入口。【VERIFIED - CSDN 技术解析】

  • 劣势：自身不带视觉能力，必须另配一个能看图的视觉引擎接口；图片可能被发送到第三方视觉服务，涉密截图、合同、内部文档要慎用（检查 provider、临时文件、远程 URL 安全配置）。【VERIFIED - 腾讯新闻 + 脚本之家】

7. dsh-genui —— 生成式 UI（让回答"长出手脚"）

  • 推荐理由：让模型在回复的 dsh-ui 代码围栏里写 JSON 界面描述，前端渲染成可交互组件——卡片、表格、图表、表单、文件树、时间线、代码 diff、Mermaid 图、3D 场景等 30+ 组件；且实现事件闭环：按钮点击、表单提交把 action 事件回传 Agent，模型继续推理，是双向交互而非静态展示。【VERIFIED - CSDN DeepSeek 社区源码级解析】

  • 社区反馈：腾讯新闻实测丢一个柱状图需求（A=10、B=20、C=15）成功渲染；53AI 评价"把交付结果变成可以继续操作的界面"。【VERIFIED - 实测】

  • 优势：把"纯文本对话"升级成"带操作面板的对话"；数据分析→仪表盘、知识讲解→即时判分测验、研究整理→标签页溯源等场景直接可用。

  • 劣势：项目较新；复杂排版、3D 场景稳定性有限；事件闭环的可靠性依赖模型遵守 dsh-ui 围栏约定。

8. dsh-TUI —— Claude Code 风格终端界面

  • 推荐理由：全屏交互终端——上下文进度条、TPS 仪表、Git 信息、工具状态、会话恢复，把 Web UI 体验搬进终端。【VERIFIED - 社区盘点】

  • 社区反馈：脚本之家 6 插件清单定位"终端党推荐"（实测版本 0.8.0）。【VERIFIED】

  • 优势：信息密度高、沉浸式编码；对 CLI 重度用户是效率提升。

  • 劣势：只适合终端党；安装配置比 Web 插件略繁琐。

9. dsh-files / dsh-office-tools —— 文件上传与 Office 生成

  • 推荐理由：dsh-files 支持拖拽/上传读 TXT、PDF、Word、Excel（带会话隔离、格式检测、大小限制）；dsh-office-tools 让 Agent 生成 Word/PPT/Excel 且真能下载。【VERIFIED - 腾讯新闻实测】

  • 社区反馈：腾讯新闻实测"让它生成一份 Word、一份 PPT 和一个 Excel，全都出来了，而且是真能下载下来的那种"。【VERIFIED】

  • 优势：纯 JS 处理，本机不用装 Office；比把文件路径硬塞进输入框规矩得多。

  • 劣势：office-tools 项目较新，复杂排版别指望。【VERIFIED - 实测文】

10. dsh-browser —— 浏览器操作（Codex 级能力）

  • 推荐理由：通过桥接插件 + Chrome 扩展操作用户已打开的真实标签页，登录态/Session/Cookie 由 Chrome 保存；模型拿到编号化的链接/按钮/输入框，按编号点击，支持输入、按键、滚动、前进后退、刷新、跳转，网页变化自动生成新快照。【VERIFIED - 53AI + 腾讯《赛博乐高》盘点】

  • 社区反馈：53AI 评价"DeepSeek 一瞬间能看图、能操作网页了"。【VERIFIED】

  • 优势：免登录态管理（复用 Chrome 会话），真实网页操作闭环完整。

  • 劣势：依赖 Chrome 扩展；任务一长所有工作仍挤在同一段上下文里。【VERIFIED - 53AI 原文指出】

11. dsh-explorer —— 文件树 + Git 状态面板

  • 推荐理由：给界面加文件树、Git 状态、改动对比、文件预览，把 dsh 界面"装修成 IDE"。【VERIFIED - 腾讯新闻】

  • 社区反馈："功能挺实用，而且基本是只读的，比较安全"。【VERIFIED】

  • 劣势：安装要装两个部分；同方向更重的方案是 DSH-better-sidebar（右侧栏+底部面板双工作台，含真实终端、Git Diff、后台任务、子 Agent 状态）。

8.3 第三批：重度用户 / 进阶（按需装）

12. dsh-agent-teams —— 多 Agent 团队编排

  • 推荐理由：当前会话的 Agent 升职当"队长"，自动创建可唤醒的子 Agent，任务按依赖推进（DAG 图可视化），团队面板实时显示谁在干活、谁空闲；点击成员可进入子会话查看过程。例：先建"整理改动清单"，再建性能/安全/产品影响三项审查任务并设为依赖，清单完成后三项自动解锁。【VERIFIED - CSDN DeepSeek 社区 + 腾讯《赛博乐高》+ 夜雨飘零文档】

  • 社区反馈：夜雨飘零基于源码给出完整技术文档；腾讯新闻实测"功能不错，但 Token 烧得也是真不算少"；CSDN 评价"对依赖关系明确、能够拆开的工作，作用会非常明显"。【VERIFIED】

  • 优势：分工并行、依赖编排、事件驱动调度（非常驻轮询）、状态文件级持久化（任务和消息留在磁盘，队长回来或调用状态工具后投递）。【VERIFIED - 夜雨飘零】

  • 劣势：Token 开销显著；队长离线时不能给成员冷恢复；同一 dsh 进程内有锁串行化，但多进程同时改同一团队不保证一致；成员权限面和队长同一进程（安全风险同源）；安装前建议钉死版本。【VERIFIED - 夜雨飘零源码分析】

13. dsh-anchored-standard —— 模型启动状态校准（社区称"开智"插件）

  • 推荐理由：社区观察到同一模型、同一 API 条件下，Standard 模式首轮表现不稳定（疑似训练数据污染影响，无官方定论）。该插件第一轮只给模型看官方 Minimal 风格的 bash 和 str_replace_editor，等完成第一次工具调用后再开放完整 Standard 工具目录——不加新能力，只校准启动状态。【VERIFIED - 社区盘点 + 作者教程】

  • 社区反馈：作者数据（非独立基准）：Project2 中 Standard 约 91/92，官方 Minimal 约 99/96，作者 Windows 测试 98/99。【UNVERIFIED - 单一来源、样本小】

  • 优势：零新能力成本，纯校准；变体多（Windows 版、首轮 Minimal 兼容版、全部会话预热版）。

  • 劣势：数据不是独立基准，样本小；效果因模型/场景而异，不能当定论。

14. dsh-usage-stats —— Token 成本统计

  • 推荐理由：统计 token 花费、缓存命中、调用次数、账户余额，带热力图；装完能自动补历史会话。【VERIFIED - 腾讯新闻】

  • 社区反馈："不然烧了多少 token 都不知道"。【VERIFIED】

  • 劣势：只统计不控费；预算控制还得靠模型路由类插件。

15. dsh-turn-rewind / dsh-undo —— 上下文与文件回滚

  • 推荐理由：把对话和文件恢复到某条消息之前；恢复前先预览哪些文件要变、要你确认、还留救援点；dsh-undo 是"上下文撤回键"，把模型上下文回滚到上一步完成状态。【VERIFIED - 腾讯新闻 + 社区盘点】

  • 社区反馈："比你自己手动回滚靠谱"。【VERIFIED】

  • 劣势：主要覆盖对话与文件状态；其他已产生的副作用（外部 API 调用等）不一定能撤。

16. dsh-im-bridge（微信桥接）—— 随时随地遥控 dsh

  • 推荐理由：直接在微信里发任务、查看状态、切换 Session、停止任务；需要人工批准时手机回复 /yes /no 继续。【VERIFIED - 社区盘点】

  • 社区反馈：路线图规划企业微信、钉钉、飞书。【VERIFIED】

  • 劣势：走微信 iLink（非官方 Gateway），存在账号限制风险；headless 模式需单独再装一次。【VERIFIED - 社区提示】

17. dsh-plugin-cc —— 桥接 Claude Code

  • 推荐理由：把 Claude Code 接进 dsh：审查、批评、委派、会话导入。注意官方 RC.8 也提供了 Claude Code/Codex 子代理 Profile Bundle，两者路径有重叠，装前先想清楚用哪条。【VERIFIED - 社区盘点 + 官方 Release】

  • 劣势：与官方方案并存，概念上易混；依赖本机已装好并登录的 Claude Code CLI。【VERIFIED - 第 5 节结论沿用】

18. 模型路由 / 省钱组：dsh-tier-router、dsh-llm-fallbacks、dsh-shift-router、dsh-model-failover

  • 推荐理由：分层路由（规划/审查用强模型，机械执行用便宜模型）；主模型限流/欠费/报错自动切备用；进阶版支持 LLM-Judge 路由、多模型回退链、指数退避、两级熔断。【VERIFIED - 社区盘点】

  • 社区反馈（关键踩坑）：腾讯新闻实测 dsh-llm-fallbacks"装完默认不生效，还得自己配好几个模型、打开开关、最后设好切换顺序"。【VERIFIED】

  • 劣势：配置成本高；路由误判可能影响任务质量；省钱效果依赖你对任务难度的准确分层。

8.4 严格说不是"插件"、但常被当插件推荐的大项目

这类项目本身用户基础大、Star 高，但不一定是可用 dsh plugin add 安装的原生 bundle，按各自方式接入。【VERIFIED - 脚本之家/七牛云分类口径】

  • Open Design（nexu-io/open-design，约 87.8k Star）：本地 AI 设计工作台，生成网页/移动端原型、仪表盘、幻灯片、图片、视频，导出 HTML/PDF/PPTX/MP4；把 dsh 作为原生 Agent runtime 接入（od agent setup deepseek-harness），兼容 Claude Code/Codex/Cursor 等 20+ CLI（BYOK）。适合要"生成后继续编辑、预览、导出"完整交付链的设计/内容团队；不是普通 bundle。【VERIFIED - 七牛云 + 脚本之家】

  • OpenViking（volcengine/OpenViking，约 28.7k Star）：自进化上下文数据库，记忆/知识/RAG/Skill 统一进 viking:// 虚拟文件系统，按摘要-概览-详情分层加载；Agent 可像 ls/tree/find 一样定位上下文并保留检索轨迹。适合跨会话记忆、团队知识库、大规模上下文；pip 安装，通过 Agent Plugin/MCP/CLI 接入，不是原生 bundle。【VERIFIED - 七牛云 + 脚本之家】

  • Archify（tt-a1i/archify，约 13.6k Star）：从系统描述或代码库生成可验证的架构图/工作流/时序/数据流/生命周期图，输出自包含 HTML。本质是 Agent Skill，附带预览版 DSH 集成（@tt-a1i/archify-dsh@0.1.0），适合代码评审、系统交接、技术文档。【VERIFIED - 脚本之家】

  • Voyager（Nagi-ovo/voyager，约 19.5k Star）：浏览器增强套件 + 提示词管理器，可跟随 localhost:3080 的 Harness Web UI 管理提示词库。是浏览器扩展不是 bundle；能读取页面内容，企业环境先评估权限。【VERIFIED - 脚本之家】

  • Yao（YaoApp/yao，约 7.6k Star）：自托管 Agent 控制台，桌面/手机/浏览器/API 统一管理任务与工作区，README 标注已集成 dsh。部署前需评估远程访问、认证、工作区文件权限。【VERIFIED - 脚本之家】

  • Ouroboros（Q00/ouroboros，约 5.5k Star）：访谈-分阶段评测-预算约束-持续迭代的验证闭环，适合 PRD、复杂重构、长任务，不适合简单问答；DSH 集成通过 github:Q00/ouroboros#main&path:integrations/dsh-plugin 安装。【VERIFIED - 脚本之家】

8.5 按场景的选型建议（社区推荐组合）

  • 完全不想碰命令行：DSH Desktop + dsh-market + dsh-at-file + ModLens。【VERIFIED - 七牛云/脚本之家组合口径】

  • 日常写代码：dsh-market + dsh-at-file + dsh-context + dsh-genui（终端党再加 dsh-TUI）。

  • 多 Agent / 复杂重构 / 代码审查：dsh-agent-teams + dsh-anchored-standard + dsh-usage-stats + Archify。

  • 设计 / 内容交付：Open Design + ModLens。

  • 长期记忆 / 团队知识库：OpenViking + dsh-memento（跨会话本地记忆，写入需逐条确认，带审计面板；缺点是用久了旧内容会干扰新任务，需定期清理）。【VERIFIED - 腾讯新闻】

  • 省钱 / 控成本：dsh-tier-router + dsh-usage-stats。

  • 不建议一次装一堆：社区实测建议"一次只装一个"验证，遵循"装前审源码 → 独立 profile 试 → 确认配置树/网络权限/卸载路径 → 再进正式环境"的流程。【VERIFIED - 社区共识】

8.6 安装命令与安全提醒（统一口径）

 # 原生 bundle（npm 包）
 dsh plugin --profile web add <插件包名>
 # 原生 bundle（GitHub 源）
 dsh plugin --profile web add git+https://github.com/<owner>/<repo>.git
 # 装完必须重启 Harness 才生效
 dsh restart web

  • 插件命令实际交给 pnpm 处理，本机需先有 pnpm。【VERIFIED - 腾讯《赛博乐高》】

  • 安装前核对：仓库、安装脚本、最近提交时间、许可证、权限范围；生产/共享工作区建议钉死版本。【VERIFIED - 夜雨飘零 + 官方立场】

  • 社区插件以本机权限运行（能读文件、碰凭据、走网络）；官方索引明确声明"进了插件市场 ≠ 通过安全审计"。【VERIFIED - 官方索引 + 腾讯新闻】

  • dsh 迭代极快（rc.5→rc.8 仅一周），插件与 dsh 版本存在兼容窗口；插件列表出现异常先跑 dsh --profile web --dump-config 看叠加配置。【VERIFIED - 第 3 节结论沿用】

9. 参考来源清单

官方一手来源（置信度最高）

  1. DeepSeek Harness GitHub 仓库：github.com/deepseek-ai…（README、docs/、packages/、vendor/cordis）

  2. GitHub Release v0.1.0-rc.8 官方发布说明（含中英文）：github.com/deepseek-ai…

  3. DeepSeek 官方 API 文档《接入 Agent 工具》（Claude Code/OpenCode/OpenClaw 接入）：接入 Agent 工具 | DeepSeek API Docs

  4. Claude Code 官方文档 Extend Claude Code（Skills/MCP/Subagents/Agent Teams/Hooks/Plugins）：code.claude.com/docs/en/fea…

国际权威媒体 / 深度分析（置信度较高）

  1. The New Stack, Frederic Lardinois《DeepSeek open sources an agent harness where everything is a plugin》(2026-08-13)：DeepSeek open sources an agent harness where everything is a plugin - The New Stack

  2. VentureBeat, Carl Franzen《DeepSeek Harness launches as open source rival to Claude Code...》(2026-08-13)：DeepSeek Harness launches as open source rival to Claude Code, alongside V4-Pro on API with higher prices | VentureBeat

  3. ArceApps Blog《DeepSeek Harness: the runtime where everything is a plugin》(含 Cordis 论文解读、星数快照、源码细节)：DeepSeek Harness: the runtime where everything is a plugin - ArceApps Blog

  4. Prompt Genius《DeepSeek Harness: Everything Is a Plugin》：DeepSeek Harness: Everything Is a Plugin | Prompt Genius

  5. ScriptByAI《DeepSeek Harness: Open-Source Plugin-Based AI Agent Harness》(四种模式、命令速查)：DeepSeek Harness: Open-Source Plugin-Based AI Agent Harness

国内主流媒体 / 社区深度内容（中等置信度，已交叉核实）

  1. 新浪科技/机器之心Pro《刚刚，DeepSeek Harness 更新！增强多模态》(RC.8 报道)：刚刚，DeepSeek Harness更新！增强多模态|会话|工作流|工具|长链|图文_手机新浪网

  2. 腾讯云开发者社区《DeepSeek Harness rc.8 更新解读》(含 npm 版本滞后、SQLite 不兼容提示)：DeepSeek Harness rc.8 更新解读：图片输入、自动打开网页，以及两个实用社区工具-腾讯云开发者社区-腾讯云

  3. CSDN DeepSeek 技术社区《DeepSeek Harness 初体验：入门、安装与自定义插件》(插件 5 概念 + 极简插件源码)：DeepSeek Harness初体验：入门、安装与自定义插件_自然语言处理_qq_42859625-DeepSeek技术社区

  4. 掘金《DeepSeek Harness 开源，怎么上手》(greet 工具插件完整流程，Datawhale 教程参考)：juejin.cn/post/767478…

  5. CSDN《【DeepSeek Harness 技术解析】Everything is a Plugin 如何重构 Agent 运行时》(与 Claude Code/Codex/OpenCode 四维对比表)：【DeepSeek Harness技术解析】Everything is a Plugin如何重构Agent运行时-CSDN博客

  6. 夜雨飘零博客《用 dsh-plugin-product-subagents 把 Codex、Claude Code 接到可续聊的 DSH 子智能体》(社区方案完整文档)：用 dsh-plugin-product-subagents 把 Codex、Claude Code 接到可续聊的 DSH 子智能体 - 夜雨飘零

  7. CSDN《它能把 Claude Code 当下属调用——DeepSeek Harness 最被低估的 10 个用法》(子代理编排场景 + settings.yaml 启用方法)：它能把Claude Code当下属调用——DeepSeek Harness最被低估的10个用法_人工智能_七牛云行业应用-MCP技术社区

  8. CSDN《使用 DeepSeek Harness 有感》(实测 settings.yaml 中 codex/claude-code provider 默认 disabled)：使用DeepSeek Harness有感-CSDN博客

  9. TreeRouter Blog《Build DeepSeek Harness Plugins with Cordis Tutorial》(宿主/客户端插件两类划分、bundle 结构)：Build DeepSeek Harness Plugins with Cordis Tutorial - TreeRouter Blog

  10. 网易/AppSo《刚刚，DeepSeek Harness 重磅更新，多模态能力增强》：刚刚，DeepSeek Harness 重磅更新，多模态能力增强|调用|工作流|上下文|deepseek_网易订阅

  11. MoClaw Blog《DeepSeek Harness Plugins vs Skills》(插件 vs Skill 安全审查差异)：DeepSeek Harness Plugins vs Skills | MoClaw Blog

第 8 章（插件推荐清单）新增来源（2026-08-21 补充）

  1. 腾讯新闻《DeepSeek Harness 我一口气装了 16 个插件，最离谱的那个在播页游广告》(2026-08-17，16 插件分批实测 + 安全提醒)：DeepSeek Harness我一口气装了16个插件，最离谱的那个在播页游广告_腾讯新闻

  2. 脚本之家/七牛云行业应用《DeepSeek Harness 10 个真正实用的插件详解（高星项目与安装指南）》(2026-08-20，10 插件分类、三类接入方式辨析、Star 快照)：DeepSeek Harness 10 个真正实用的插件详解(高星项目与安装指南)_其他_AI_脚本之家

  3. 脚本之家《DeepSeek Harness 推荐的 6 个插件（亲测不踩坑）》(dshmarket/dsh-vision-router/dsh-TUI/dsh-context/dsh-chat-import/dsh-at-file 实测版本号与安装顺序)：DeepSeek Harness 推荐的 6 个插件(亲测不踩坑)_其他_AI_脚本之家

  4. 腾讯《网友把 DeepSeek Harness 玩成了赛博乐高，我们挑出了最有意思的 11 个插件》(dsh-browser/dsh-agent-teams/dsh-genui 等)：搜索资讯页

  5. 53AI《DeepSeek Harness 一周拿下 16.6 万 Star，开发者已经把它改成了什么？》(dsh-browser/dsh-genui/dsh-openpencil/dsh-context/dsh-agent-teams)：DeepSeek Harness 一周拿下 16.6 万 Star，开发者已经把它改成了什么？ - 53AI-AI知识库|企业AI知识库|大模型知识库|前线部署工程师|FDE|AIHub

  6. CSDN DeepSeek 技术社区《ModLens / dsh-genui 机制解析》(视觉证据管线、dsh-ui 代码围栏 + 事件闭环源码级解读)：DSH最好用的10个插件_人工智能_万事可爱^-DeepSeek技术社区

  7. 夜雨飘零《用 dsh-agent-teams 把 DeepSeek Harness 会话编排成智能体团队》(源码级技术文档：事件驱动调度、文件级持久化、锁串行化、权限面)：用 dsh-agent-teams 把 DeepSeek Harness 会话编排成智能体团队 - 夜雨飘零

  8. CSDN《DeepSeek Harness Desktop：开源 2 天近 6K Star，一个让普通人也能用上本地 AI Agent 的桌面客户端》(Electron 架构、安全机制、优劣势分析)：DeepSeek Harness Desktop：开源2天近 6K Star，一个让普通人也能用上本地 AI Agent 的桌面客户端。-CSDN博客

  9. ima 知识库/AI 训练师《为什么「一切皆插件」…》(deepseek-harness-desktop 零配置方案、日志即单一事实源)：ima.copilot-AI训练师

  10. 拓荒者IT《DeepSeek Harness Desktop 上手实录》(命令行版 vs 桌面版对比表、托盘/通知/自动更新)：DSH Desktop（官网）

  11. DeepSeek Harness Desktop 官方仓库（anywhere-labs/deepseek-harness-desktop，MIT，README 声明非官方产品）：github.com/anywhere-la…

  12. 七牛云新闻《DeepSeek Harness 完整上手指南：部署安装、模型配置到必装社区插件》(open-design/OpenViking/archify/EverOS Star 数据)：DeepSeek Harness 完整上手指南：部署安装、模型配置到必装社区插件 | 七牛云

avatar
文章
阅读
粉丝