0.1 这本书讲什么
本节目标
搞清楚 dsh 是什么、能做什么、和你用过的 ChatGPT 网页版有什么区别，然后决定要不要继续读下去。
一个场景
你有没有想过，让 AI 不只是回答你的问题，而是真正动手帮你把活干完？
比如你说一句"帮我把这个项目里所有没用的 import 清理掉，顺便跑一遍测试"，然后它就真的打开你的项目目录，找到代码文件，一行一行改好，再打开终端把测试跑给你看。中间它卡住了还会回头问你"这一步要不要继续"。
dsh 就是干这个的。
dsh 是什么
dsh 的全称是 DeepSeek Harness，由 DeepSeek AI 开源。它是一个 agent Harness驾驭装置、运行框架。指让 AI 在真实电脑环境里干活的整套运行系统。，翻译成人话就是智能体运行框架：一个让 AI 助手能读写你的文件、执行命令、调用工具、按流程干活的"驾驶舱"。
它有四个很实在的特点：
- 图形化界面。运行一条命令后打开网页，所有的配置、对话、工具调用过程都看得见，鼠标点点就能用，不需要写代码。
- 一切皆插件可插拔的功能模块，dsh 的一切能力都通过插件装配。。底层用 Cordis 框架组装，读文件、跑命令、查网页、调大模型，每一块能力都是可插拔的插件，想要什么就装什么。
- 安全可控。agent 想动你的文件、执行命令时，会先征求你的同意，每一步都清清楚楚。
- 开源免费。MIT 协议，代码托管在 GitHub，可以自己部署、改造、二次开发。
能做什么
装好之后，你可以让 dsh 帮你干这些类型的活：
| 场景 | 一句话指令 |
|---|---|
| 读懂代码 | "总结这个仓库是干什么的，有哪些主要模块" |
| 改代码 | "把登录接口的错误提示统一改成中文" |
| 跑任务 | "运行测试，把失败的用例列出来并修掉" |
| 查资料 | "查一下 VitePress 最新版怎么配置本地搜索" |
| 写文档 | "根据这个项目的 README 生成一份发布说明" |
| 干杂活 | "把这批图片压缩到 200KB 以下" |
关键是它工作在你的真实电脑上，读的是你的文件、跑的是你的命令，而不是一个封闭的聊天框。
和 ChatGPT 网页版有什么不一样
这是初学者最容易混淆的地方，用一张表说清楚：
| 对比项 | ChatGPT 网页版 | dsh |
|---|---|---|
| 能不能看到你的文件 | 不能，只能聊 | 能，选中工作区agent 干活的项目目录，包含路径、显示名和归属的会话。后真实读写 |
| 能不能执行命令 | 不能 | 能，跑测试、装依赖、起服务 |
| 改完的代码在哪 | 在聊天记录里 | 直接改在你的项目里 |
| 过程透不透明 | 只给结论 | 工具调用树全程可见 |
| 要不要审批 | 不需要 | 敏感操作会先问你 |
| 能不能扩展 | 不能 | 插件随便装 |
一句话总结：网页版是"问它"，dsh 是"让它干"。
你需要什么基础
不多，两条就够：
- 会安装软件。本书会带你装 Node.js 和 dsh，跟着步骤点就行。
- 会打开终端敲一行命令。不需要会写代码，不需要懂 AI 原理。
这本书怎么带你入门
这本书的章节顺序就是 dsh 图形化界面的使用顺序。你打开界面后先看到什么、先要点什么，书就先讲什么：
- 配置模型，让 dsh 有"大脑"可用
- 选择工作区，告诉 dsh 在哪个地盘干活
- 发出第一条指令，看它怎么干活
- 逐个点亮会话里的进阶功能
- 最后学会设置、CLI 和常见问题
跟着界面走一遍，整本书就学完了。
先看一眼真身
这是 dsh 启动后的主界面，先混个脸熟：
左边是工作区与会话导航，中间是对话区，底部是输入区，左下角是设置入口。具体每个区域干什么，我们在 0.3 节详细拆解。
小结
- dsh 是 DeepSeek 开源的 agent 运行框架，带图形化界面
- 它能真实读写你的文件、执行命令，且过程透明、操作需审批
- 和 ChatGPT 网页版的区别是"问它"和"让它干"
- 不需要编程基础，跟着界面顺序学即可
下一节，我们开始动手，先把运行环境准备好。