第 43 卷

• **文档生成**（T4 读数据 → 写报告 → 自复核）：agent 间差距**最小**（omp 21s /

dsh 26s / opencode 30s，约 1.4×）。报告生成是"读一次 + 写一次长文本"的回路，耗时主要由模型**输出 token 数**主导，Agent 工程层能优化的工具往返很少，故三家

趋同。

1. **反直觉点：T5（重构+测试）普遍比 T4（写报告）更快**（dsh 19s<26s、omp

13s<21s；仅 opencode 28s≈30s）。原因：重构是"短文本代码编辑 + 秒级 `python main.py` 验证"的回路，每步模型思考短；而写 markdown 报告需要一次较长文本生成，

输出时间占比高——与第 6 章"工具链任务 90% 时间在模型思考/生成"的性能模型一致。

1. **omp 的领先幅度随任务类型变化**：搜索统计类最大（T2 为 opencode 的

3.4×），文档生成类最小（T4 仅 1.4×）。说明 omp 的优势主要在**轮次少、工具调用快**，而非模型本身；当任务由长文本生成主导时，任何 agent 的工程层都难再压缩模

型输出时间。

1. **波动性提示**：opencode 在 T4 第 2 轮出现 49s 离群（其余两轮 30s），dsh 在

T3 波动最大（27→74s）。多轮中位数能吸收这类网络/工具链抖动，单轮比较需谨慎。

1. **dsh 定位**：dsh 居中，且 headless 是"运行时 + 插件生态"——**同样的模型，

通过插件（如提速插件降推理档）可进一步优化耗时**（见第 6 章）；T5 实测已接近 omp，说明多文件重构类任务是其相对强项。

1. **样本警示**：3 轮 × 5 任务，同网关同 key，含网络抖动——方向可信，绝对值会

随环境波动。

可复现

# 三个 agent 的命令（独立目录） dsh --profile headless "任务" opencode run "任务" --model opencode-go/deepseek-v4-flash omp "任务" --model deepseek-v4-flash --print

T4/T5 任务原文（T1-T3 见上一版本记录）：

<!-- [style] 任务原文代码块统一补 text 语言标签 -->

T4: 读取当前目录 data.json 中的数据，生成 markdown 报告 report.md：包含每行数据的表格（产品/销量 /单价三列）和汇总（总销量、总营收、最畅销产品），生成后自己复核汇总数字与 data.json 一致，完成后回

复已生成 T5: 重构 mathops.py：把 multiply 函数内的乘法逻辑提取为私有辅助函数 _multiply(a, b)， multiply 改为调用 _multiply；main.py 依赖 mathops.py 并包含断言测试，不得改动 main.py；重构后运

行 python main.py 验证所有断言通过，完成后回复已重构

> 完整任务定义、合成数据与产物：`~/agent-bench/bench-ext/`（T4/T5 每 agent 独立目录）；

T1-T3 见 `~/agent-bench/`。白皮书仓库内 `benchmark/` 目录规划中。

一页速查卡（Cheatsheet）

> 打印/收藏这张卡，日常用 dsh 不用翻书。

安装与启动

npx -y @deepseek-ai/dsh --version# 免安装运行 npm i -g @deepseek-ai/dsh# 全局安装 dsh web# Web UI → http://127.0.0.1:3080 dsh --

profile headless "任务"# 一次性任务（脚本/CI）

配置（~/.dsh/settings.yaml）

<!-- [fix] 技术准确性核验：官方 DeepSeek 适配器（默认 provider=deepseek-official）仅接受 off / high / max；`low` 为 pi-ai（opencode-go）网关档位 -->

agent-default-model:model: deepseek-v4-flash# 或 deepseek-v4-proreasoningEffort:

high# off（关闭思考/最快）/ high（默认）/ max（最强）

推理档位

档位用途备注

位（替代 low）

> 工具链任务 90% 时间在思考——降档是最快提速。

核心命令

命令用途

dsh webWeb UI

dsh --profile headless "任务"一次性任务

dsh --dump-config看合成配置

dsh plugin --profile <n> add装插件 <pkg>

插件挂载（两步）

# package.json 加依赖 "my-plugin": "link:C:\\path\\to\\my-plugin" # cordis.patch.yml 加挂载

• insert:- id: my-pluginname: my-plugin

cd ~/.dsh/profiles/web && pnpm install && dsh web

提示词黄金法则

1. **写验收标准**：`"运行验证通过"` > `"写个脚本"`
2. **给上下文**：文件在哪、数据长啥样、读者是谁
3. **一次一个任务**：小闭环比巨型任务可靠

缓存省钱

• 长任务保持会话延续（别频繁新建）
• prompt 前缀稳定（别老改配置）
• 看 Web UI 底部"缓存命中 %"（实测可到 97%）

排障速查

现象解法

术语（速记）

`profile` 形态 · `bundle` 插件组 · `host/client 半` 服务端/界面 · `扩展点` 官方钩子 · `waterfall` 请求链 · `compaction` 上下文压缩 · `headless` 一次性 CLI · `locations` 产物路径

---

完整教程见 [dsh-handbook 白皮书](https://github.com/Electricitysheep/dshhandbook) · [配置参考](./config-reference.md) · [术语表与命令速查](./appendix-

glossary.md)