2.2 添加选择与创建
本节目标
动手添加你的第一个工作区:找到入口、选择目录、确认添加,最后在侧边栏看到它。
入口在哪
工作区有两个添加入口,都在主界面上:
- 对话区顶部的选择工作区按钮。全新安装的 dsh,打开后对话区会提示选择工作区,点它即可
- 侧边栏工作区分区的添加按钮。分区标题右侧常驻有添加工作区图标,点它也行
两个入口殊途同归,都会打开系统目录选择器(就是你在资源管理器里选文件夹的那个对话框)。
第一步:选择目录
点击添加入口后,系统弹出目录选择对话框:
- 找到你想让 agent 干活的项目目录,比如
my-project - 选中这个文件夹(注意是选文件夹本身,不是进到里面选某个文件)
- 点确定
选哪个目录合适
选项目根目录最合适,比如你的仓库根目录、网站源码目录。这样 agent 能读到你项目里的所有文件。别选 C 盘、用户主目录 这种大而全的目录,范围太大会让 agent 找东西很慢,误操作风险也高。
第二步:确认添加
目录选好后,dsh 会自动完成两件事:
- 在工作区列表里创建一条记录,显示名称默认取目录名
- 自动选中这个工作区,让它成为当前工作区
回到主界面,看左侧边栏工作区分区下面,你的项目目录名已经出现了。把鼠标悬停在它上面,可以看到完整的目录路径。

同时你会发现,底部会话输入框已经解锁,可以开始发指令了。
管理工作区
工作区出现在列表后,悬停在工作区行上会出现操作菜单,有两个:
| 操作 | 干什么 | 注意 |
|---|---|---|
| 重命名 | 改显示名称 | 只是改界面显示名,不影响真实目录名 |
| 删除 | 从列表移除该工作区 | 有确认弹窗,不会删除你的文件和会话,会话会归入"未分组" |
归档会话去哪了
会话的归档操作不在工作区行上,而是在会话行上(5.1 节会讲)。归档只是把会话从列表隐藏,当前版本没有恢复或查看已归档会话的入口,归档前想清楚。
多工作区切换
如果你有多个项目,就再走一遍添加流程,每个项目一个工作区。之后点侧边栏里的任意工作区名,就能切换当前工作区,对应会话也会跟着切换。
每个工作区是独立的,这个项目里的会话不会混进另一个项目。
常见问题
问:添加后侧边栏没显示?
先看对话框是否真的点确定了。添加成功后,工作区行会立即出现,如果没出现,检查是不是选了文件而不是文件夹。
问:删除了工作区,我的文件还在吗?
在,而且会话也都在。删除工作区只是移除界面上的分组记录,你的项目文件一个都不会动,之前的会话会保留在"未分组"里。
问:同一个目录能添加两次吗?
不能。dsh 会对目录路径做规范化处理,同一个目录只会有一条工作区记录。
小结
- 两个入口都能添加:对话区选择按钮、侧边栏工作区分区添加按钮
- 选项目根目录,显示名默认取目录名,添加后自动选中
- 工作区可重命名、删除(不删文件和会话)、可加多个并随意切换
工作区就绪,下一节我们发出第一条指令,让 agent 真正开始干活。