第 23 卷

第 23 / 43 卷作者：Un-named日期：2026-08-17

9.5 社区生态示例（2026-08-13 快照）

官方 Discussion 里已出现的社区项目：

`dsh-plugin-cost-tracker`——实时追踪 token 成本（插件/MCP 形态）
插件开发/提速类（如本白皮书第 4 章的示例提速插件）

生态正在快速生长——**现在是进场搭积木的好时候**。

9.6 MCP 接入配置示例

以下给出在 `cordis.patch.yml` 中挂载 MCP 客户端的**配置片段**（语法与第 3 章 3.2 节一致，以社区 token 追踪插件为例）：

- insert:	- id: mcp-client	name: '@deepseek-ai/dsh-mcp-client'	config:
servers:	- name: cost-tracker	command: npx	args: ['-y',
'dsh-plugin-cost-tracker']		env: DSH_API_KEY: '${DSH_API_KEY}'

**字段说明**：`id`（cordis 链标识）、`name`（npm 包名）、`config.servers`（服务器列表，每服务器独立进程）、`command`/`args`（启动命令与参数）、`env`（环境变量，支持

`${VAR}` 引用宿主变量）。

> ⚠️ 上述配置基于 `packages/mcp/` 目录结构与 cordis 挂载语法推断，具体字段以官方文档为准（rc 阶段可能变动）。验证思路（推断，待实测）：挂载后重启 `dsh web`，发涉及 token 计

数的任务，观察日志是否出现 MCP 调用记录。

9.7 子代理配置示例

并行子代理通过 `packages/subagent/*` 提供。以下是在 `cordis.patch.yml` 中**启用子代理能力**的配置片段：

insert:- id: subagentname: '@deepseek-ai/dsh-subagent'config:

maxConcurrency: 3timeout: 120000

**适用场景与并发策略**：

场景	子代理数	父代理职责	子代理职责
大仓库多模块调研	3-5个	划分模块边界、汇	各模块独立调研

总结论

长任务分解2-3 个拆分子任务、校验各子任务独立执行完整性

独立验证1-2 个提供结论与验证标交叉检查准

多文件并行编辑2-4 个锁定文件范围、避各子代理写不同文免冲突件

> ⚠️ `maxConcurrency` 与 `timeout` 基于包名与 cordis 惯例推断（推断，待实测）。上下文隔离机制需查阅官方 `packages/subagent/README.md`。

9.8 工作流 YAML 示例

以下是一个**确定性工作流**的 `cordis.patch.yml` 片段，模拟"数据拉取 → 清洗 → 报表 → 校验"四步（参考第 10 章案例 A 的任务结构）：

insert:- id: workflowname: '@deepseek-ai/dsh-workflow'config:

steps:- id: fetchtool: bashcommand: 'curl -o raw.json https://api.example.com/data'- id: cleantool: bash

command: 'python clean.py raw.json cleaned.json'dependsOn: [fetch]- id: reporttool: bashcommand: 'python visualize.py cleaned.json

chart.png'dependsOn: [clean]- id: validatetool: bash command: 'python verify.py cleaned.json'dependsOn: [report]

**与案例 A 的对应**：工作流 `dependsOn` 显式定义顺序，而案例 A 的"多轮对话"由模型自由决定工具。工作流适合"步骤固定"；自由对话适合"探索性"。

> ⚠️ `steps`/`dependsOn` 基于 `packages/workflow/` 包名与常见 DSL 推断（推断，待实测）。

官方 `packages/examples/` 有可运行示例，建议以其为准。

9.9 三者对比表

维度	MCP	子代理	工作流
适用场景	接入外部系统（数	大任务并行分解	确定性流水线（拉
	据库/浏览器/内部	（调研/验证/多模	取→清洗→报表→
	API）	块）	校验）
复杂度	中（需配置服务器	高（需任务分解设	低-中（YAML配
	+理解协议）	计+结果汇总）	置，调试依赖图较

繁琐）

失败处理	服务器崩溃→重连	单个子代理失败→	单步失败→可选暂
	或报错（推断，待	父代理决定重试/忽	停/跳过/回滚（推
	实测）	略/终止	断，待实测）
性能开销	额外进程通信开销	并发节省墙钟时	串行执行，无额外
	（stdio/sse）	间，但增加协调开	模型开销，但无并
		销	行收益

**决策建议**：有明确工具缺口 → MCP；任务能拆成互不依赖的几块 → 子代理；步骤固定、需严格按序 → 工作流。三者可组合：子代理并行调研 → 内部用 MCP 查数据库 → 工作流汇

总报告。

9.10 踩坑补充

#	坑	现象	解法
1	MCP连接失败	挂载后启动报错或	检查
		MCP工具无响应	command/args；

先手动跑 npx -y xxx 验证（推断，待

实测）

2子代理上下文隔离子代理看不到父父代理委派时把关 Agent 历史，导致键上下文写进任务

重复提问描述（推断，待实测）

3工作流单步失败某步 bash 返回非配置 onError:

零，后续步骤继续pause 或每步后加执行校验脚本（推断，

待实测）

4子代理文件冲突多个子代理同时写父代理规划时划分同一个文件文件边界（推断，

待实测）

5	MCP环境变量未注	${DSHAPIKEY}解	确认宿主shell已
	入	析为空	export；或写死

（仅本地测试）

（推断，待实测）

> 所有标注"推断，待实测"的内容均基于 `packages/` 目录结构与 cordis 配置惯例推断，非本白皮书实机验证结果。rc 阶段请以官方文档为准。

9.11 四阶段新手路径（含验收标准）

把 9.4 节的"四阶段"扩展为**每阶段有明确验收标准**的升级路径：

阶段能力验收标准（怎么知参考章节道自己该进入下一

阶段）

阶段一单 Agent + 内置工能独立完成：创建第 2-5 章具文件 → 搜索 → 编

辑 → 运行验证，全程不卡壳

阶段二+ MCP成功挂载一个 MCP9.1 节 + 9.6 节服务器，任务中调

用其工具且日志证明调用发生

阶段三+ 子代理成功发起一次并行9.2 节 + 9.7 节子代理任务（如同

时调研 2 个模块），父代理能汇

总结果

阶段四+ 工作流成功配置并执行一9.3 节 + 9.8 节个 3 步以上工作

流，每步按

全站分卷索引 · 43 卷