第 14 卷

运营与内容

• **任务**：周报月报、数据看板说明、内容选题、SEO 摘要
• **示例**：`dsh --profile headless "读取本周数据文件，生成运营周报（含图表代码）"`
• **dsh 优势**：数据 + 文档 + 自动化的组合

研究与综述（学术/技术）

• **任务**：论文要点提取、技术调研、文献对比
• **示例**：`dsh --profile headless "对比这 3 篇论文的方法与结论，输出对比表"`
• **dsh 优势**：长文档处理 + 结构化输出（1M 上下文）

⚠️ 合规提醒

医疗诊断、法律意见、财务建议等**高风险场景**：dsh 输出需人工审核，不能直接用于决策 ——工具执行有沙箱，但**内容责任在使用者**。

第 6 章：进阶与性能调优

> 本章目标：从"能跑"到"跑得好"——推理档位策略、工具调用耗时分析、真实踩坑清单。

TL;DR（本章核心，30 秒版）

1. **时间花在哪**：模型思考占 ~90%，工具执行 <1%，网络/渲染 ~10%——优化思

考时间是性价比最高的提速

1. **三档策略**：`low`（简单/批量轮次）、`high`（日常默认）、`max`（复杂推

理/debug）——手动 UI 选或插件自动调

1. **耗时可视化**：Web UI 底部统计行（LLM Xs / 工具调用 Ys）是最快的瓶颈定位手

段

1. **8 个真实坑**：rc.1 依赖断裂、插件缺 main、next() 忘 await、事件类型不识别、

client 测试跑不了、缓存命中误判、端口占用、推理序列化丢 reasoning（#739）

1. **评测三问**：谁测的、什么 harness、验证器多严——跑分要带条件看

<details><summary>本章导航</summary>

• [6.1 性能模型：dsh 的时间花在哪](#61-性能模型dsh-的时间花在哪)
• [6.2 reasoning_effort 策略（官方三档）](#62-reasoning_effort-策略官方三档)
• [6.3 工具调用耗时可视化](#63-工具调用耗时可视化)
• [6.4 常见坑清单（真实踩过，含解法）](#64-常见坑清单真实踩过含解法)
• [6.5 评测视角：官方成绩单 vs 独立实测](#65-评测视角官方成绩单-vs-独立实测)
• [6.6 缓存策略：让每次调用都更便宜](#66-缓存策略让每次调用都更便宜)

</details>

6.1 性能模型：dsh 的时间花在哪

实测一个"创建文件"任务的耗时分布：

阶段占比说明

4m8s / 工具 29m17s）

**推论**：

• 简单任务 → 优化思考时间（降推理档）
• 长工具链任务 → 每步都省思考时间，累计收益最大
• 工具本身慢（搜索/大文件）→ 优化工具实现，不是调档

6.2 reasoning_effort 策略（官方三档）

<!-- [fix] 技术准确性核验："官方三档"在默认 DeepSeek 适配器（deepseek-official）下为 off / high / max；low 是 pi-ai（opencode-go）网关档位（本白皮书实测环境，即

benchmark 所走网关）。工具链降档叙事在网关环境下成立，settings.yaml 对默认 provider 请用 off -->

档位场景建议

low简单/确定性轮次：文件操作、批量、工具链中的廉价步

high日常 Agent 任务（默认）

max复杂推理、长链规划、debug

**手动**：UI 的"推理等级"选择器，或 `~/.dsh/settings.yaml` 的 `reasoningEffort`。

**自动**：插件按工具轮次动态降档（示例提速插件，第 4 章）。

6.3 工具调用耗时可视化

dsh 的会话统计行（Web UI 底部）显示：`N 轮 · M 步 | LLM Xs · 工具调用 Ys | 首 token 平均 ...`——这是最快的瓶颈定位手段。

进阶：host 插件监听工具事件做 per-tool 计时（提速插件示例已内置 host 日志版本），把"哪个工具最慢"暴露出来。

6.4 常见坑清单（真实踩过，含解法）

等从未发布）

2插件缺 mainNo "exports" main暴露 . 入 defined口；"main":

"src/index.ts" 可被 tsx 加载

3next 忘 awaitprovider/model 丢agent/request 的失报错next 返回