第 4 卷

**Qwen Code / GLM CLI / Grok CLI**：各家模型的终端 agent——模型绑定是它们的天然属性。dsh 模型无关（官方适配 DeepSeek，可接 OpenAI 兼容），更适合想"模型可换"的

人。

<!-- [style] 子标题编号统一：去掉残留旧编号 -->

一张图理解 dsh 的差异化位置

定制深度（可改的东西）高 │dsh（运行时 + 插件生态）││自建框架（LangGraph 等）││OpenCode（客户端 + 配置）│低 │Claude

Code / Codex / Gemini / Kimi（产品即运行时）└────────────────────────────────────── 低开箱即用程度高

• **右上**：dsh——可定制面最大，但"开箱即用"需生态补足
• **左上**：自建框架——完全自由但全要自己搭
• **右下**：产品型 agent——最好用但最封闭

<!-- [style] 子标题编号统一：去掉残留旧编号 -->

案例对比：同一个任务，不同的打开方式

**任务**：让 Agent 在仓库里"找到所有调用某个函数的地方，并统一改一个参数"。

Agent你会怎么做体验

dsh（web）dsh web → 输入指令 →Web UI + 右侧插件侧边模型用 Grep/Read/Edit栏（可加 Git 面板）

工具完成

入指令

Devin网页里建任务 → 云上完托管、有浏览器、数据出成本机

**差异点在哪**：同样一句话，**dsh 让你多了一个选择维度——界面和工具链都可以换**。

其他 Agent 的界面/工具链是官方定的，dsh 是你可以拼的。

<!-- [style] 子标题编号统一：去掉残留旧编号 -->

案例对比：真实工作流（我们的实测）

以下是我们**真实开发 dsh 生态**时的对比观察（2026-08-13）：

下文注入）→ 热缓存 ~1s

> 同模型 × 不同 Agent 的严格对比见 [Benchmark 附录](./benchmark.md)（omp 36s / dsh 85s / opencode 114s）。

1.5 什么时候用 dsh（选型决策）

**✅ 推荐入场**：

• 你要做**模型无关、界面可选、行为可改**的 Agent 底座
• 你想成为 **dsh 生态早期贡献者**（先发优势，官方点名鼓励）
• 你要在**服务器/CI** 跑 Agent（headless profile）
• 你对**成本敏感**（DeepSeek 模型 + 开源生态）

**⏸ 暂时观望**：

• 只要"开箱即用的编码助手"——Claude Code 等更成熟
• 不能接受 rc 阶段的破坏性变更——等 `0.1.0` 正式版
• 重度依赖某模型独有能力（如 Claude artifacts）——模型绑定场景

1.6 常见问题（FAQ）

**Q1：dsh 是模型吗？**

不是。dsh 是运行时/框架，模型通过 `llm` 插件接入（官方适配 DeepSeek V4 系，理论上可接其他 OpenAI 兼容模型）。

**Q2：dsh 和 OpenCode 什么关系？**

都是开源 Agent 客户端，但定位不同：OpenCode 是"客户端 + 配置"，dsh 是"运行时 + 官方插件生态"（有官方后端 bundle 与 60+ 官方包）。dsh 更底层、可定制面更大。

**Q3：没写过 TypeScript 能玩吗？**

能。使用（第 2 章）不需要编程；写插件（第 4 章）需要基础 TS，但教程给完整代码。

**Q4：dsh 稳定吗？**

当前 rc 阶段（0.1.0-rc.6），迭代快、有破坏性变更。生产核心依赖建议等正式版；玩生态现在正是时机。

**Q5：为什么现在学 dsh 值得？**

生态零日 + 官方点名鼓励社区 + 中文教程空白——**每个早期生态都有"第一个吃螃蟹的人"的红利**，现在是入场窗口。

---

**下一章**：[第 2 章：五分钟快速上手](./02-quickstart.md) —— 装起来，跑起来。

---

动手练习（检验你是否真懂了）

1. **一句话测试**：向不懂技术的人解释"dsh 是什么"（不能用"Agent/harness/插

件"这些词）

1. **对比测试**：说出 dsh 和 Claude Code 的 3 个本质区别（不是功能列表）
2. **选型测试**：给下面场景选工具并说明理由：

• 场景 A：想要开箱即用的终端编码助手
• 场景 B：想做一个"模型无关、界面自定义"的公司内部 Agent 平台
• 场景 C：想在 CI 里每天自动跑一个数据分析任务

1. **架构测试**：画出"profile → 插件 → 扩展点"的关系图（不看原文）
2. **FAQ 测试**：回答"dsh 是模型吗？""没写过 TS 能玩吗？"

> 完成练习后，进 [第 2 章](./02-quickstart.md) 动手装起来。