7.3 完整实战
本节目标
把全书知识串起来，走一遍完整的实战流程：从装好环境到让 dsh 完成一个真实项目任务。
实战任务
这一节我们完成一个真实的小项目任务：给一个已有项目生成一份 README。它用到全书的主线能力：工作区、会话、工具调用、目标、审阅。
任务目标：
分析当前工作区的项目，生成一份 README.md，包含项目简介、主要功能和使用说明。
第一步：确认环境
开工前确认三件事，缺一不可：
- 环境：dsh 已经启动，浏览器能打开界面（0.2 节）
- 模型：底部输入区显示可用的模型（1.1 节）
- 工作区：侧边栏已有你的项目工作区，输入框可用（2.2 节）
三样都齐，开始。
第二步：新建会话，设定目标
点新会话，先设定目标，防止 agent 跑偏：
设定目标：为当前工作区的项目生成 README.md，只做这一件事。
第三步：发出任务指令
把任务说清楚：
分析这个项目是做什么的，然后生成一份 README.md，包含项目简介、主要功能和使用说明。先读一下项目的关键文件再动笔。
注意指令里的三个要点：做什么（生成 README）、产出在哪（README.md）、怎么干（先读关键文件再动笔）。指令越具体，结果越可控。
第四步：观察它干活
发送后，盯住消息流的工具调用树（3.2 节）：
- Pwsh / Bash：列目录、看文件
- Glob：找 README、package.json、源码入口
- Read：读关键文件，了解项目
- Think：组织 README 的结构
整个过程你可能看到它反复"读一下、想一下、再读一下"，这是正常的，它正在理解你的项目。
第五步：审阅结果
agent 完成后，对话区出现 README 的草稿，工作区里多了 README.md 文件。别急着收工，做两件事：
- 看文件：打开 README.md 检查内容，简介、功能、使用说明是不是都到位了
- 提修改：不满意就直接说，比如"把使用说明写详细点，加一个安装步骤"，agent 会改
第六步：收尾
满意后，这单任务就完成了。你可以：
- 顺手做一次总结："总结一下这次任务的过程"（顺便看看轨迹视图，4.10 节讲过怎么切）
- 把会话归档（5.1 节），保持侧边栏干净
- 开新会话，干下一件事
这个实战用到了什么
| 环节 | 用到的能力 | 章节 |
|---|---|---|
| 环境确认 | 启动、模型、工作区 | Part 0-2 |
| 防跑偏 | 目标 | 4.5 |
| 指挥干活 | 会话与指令 | Part 3 |
| 观察过程 | 工具调用树 | 3.2 |
| 安全边界 | 权限模式 | 4.4 |
| 收尾管理 | 归档、轨迹 | 5.1、4.10 |
一本教程的主线，在这个小任务里全部用上了。
扩展：进阶实战方向
做完这个小任务，你可以往这些方向继续：
- 计划模式跑大改造（4.6 节）：重构前先让 agent 出方案
- 子代理并行调研（4.7 节）：多方向同时查
- 后台任务跑长活（4.8 节）：构建、批量处理不堵对话
小结
- 实战六步：确认环境、设目标、发指令、看工具树、审阅结果、收尾归档
- 指令三要素：做什么、产出在哪、怎么干
- 一本书的主线能力，一个小任务全用上
到这里，你已经是 dsh 的熟练用户了。最后一节，把全书最常见的坑汇总一下。