2.1 什么是工作区
本节目标
理解工作区这个概念:它是什么、为什么必须先选它、它管着哪些东西。
一个比喻
想象你雇了一位远程助理,他住在线上,看不到你的电脑。你要让他帮你干活,第一件事是什么?告诉他你的项目在哪。要不然他不知道去哪个文件夹翻文件,也不知道改完的东西放哪。
工作区就是这个"项目在哪"的答案。
工作区的官方定义
在 dsh 里,工作区是一个项目目录的持久化记录。它记着三样东西:
- 目录路径:你让 agent 干活的那个文件夹的真实位置
- 显示名称:界面上显示的名字,默认取目录名
- 会话归属:在这个工作区里开过的所有会话
一句话:工作区 = 目录 + 名字 + 它的会话清单。
为什么必须先选工作区
因为 dsh 的所有"动手"都建立在工作区上:
| 动作 | 依赖工作区的地方 |
|---|---|
| 读文件 | 在哪个目录里找文件 |
| 改代码 | 改完写回哪个目录 |
| 跑命令 | 在哪个目录下执行命令 |
| 会话归属 | 这次对话算哪个项目的 |
不选工作区,agent 就没有"地盘",自然没法真正干活。这也是为什么主界面上,选中工作区之前,会话输入框是锁着的。
一个目录一个工作区,可以有很多个
- 一个工作区对应一个目录,路径会做规范化处理,同一个目录不会重复创建
- 可以添加多个工作区,对应你手头的多个项目
- 工作区和你的文件系统是引用关系:添加工作区不会复制、移动你的任何文件,删掉工作区也不会删除你的文件,只是把这条"记录"从界面上去掉
工作区在界面上长什么样
打开 dsh 主界面,左侧边栏有一个工作区分区(在新建会话按钮下方):

分区里会列出你添加过的工作区,每个工作区下面展开属于它的会话。你添加的第一个工作区,会在下一节出现。
小结
- 工作区是"项目目录 + 显示名 + 会话清单"的记录
- agent 读文件、跑命令、归属会话都依赖工作区,所以它是界面的第一道解锁
- 一个目录一个工作区,可加多个,删除工作区不会删你的文件
概念清楚了,下一节动手添加你的第一个工作区。