Skip to content

2.2 添加选择与创建

本节目标

动手添加你的第一个工作区:找到入口、选择目录、确认添加,最后在侧边栏看到它。

入口在哪

工作区有两个添加入口,都在主界面上:

  1. 对话区顶部的选择工作区按钮。全新安装的 dsh,打开后对话区会提示选择工作区,点它即可
  2. 侧边栏工作区分区的添加按钮。分区标题右侧常驻有添加工作区图标,点它也行

两个入口殊途同归,都会打开系统目录选择器(就是你在资源管理器里选文件夹的那个对话框)。

第一步:选择目录

点击添加入口后,系统弹出目录选择对话框:

  1. 找到你想让 agent 干活的项目目录,比如 my-project
  2. 选中这个文件夹(注意是选文件夹本身,不是进到里面选某个文件)
  3. 点确定

选哪个目录合适

选项目根目录最合适,比如你的仓库根目录、网站源码目录。这样 agent 能读到你项目里的所有文件。别选 C 盘用户主目录 这种大而全的目录,范围太大会让 agent 找东西很慢,误操作风险也高。

第二步:确认添加

目录选好后,dsh 会自动完成两件事:

  1. 在工作区列表里创建一条记录,显示名称默认取目录名
  2. 自动选中这个工作区,让它成为当前工作区

回到主界面,看左侧边栏工作区分区下面,你的项目目录名已经出现了。把鼠标悬停在它上面,可以看到完整的目录路径。

工作区出现在侧边栏

同时你会发现,底部会话输入框已经解锁,可以开始发指令了。

管理工作区

工作区出现在列表后,悬停在工作区行上会出现操作菜单,有两个:

操作干什么注意
重命名改显示名称只是改界面显示名,不影响真实目录名
删除从列表移除该工作区有确认弹窗,不会删除你的文件和会话,会话会归入"未分组"

归档会话去哪了

会话的归档操作不在工作区行上,而是在会话行上(5.1 节会讲)。归档只是把会话从列表隐藏,当前版本没有恢复或查看已归档会话的入口,归档前想清楚。

多工作区切换

如果你有多个项目,就再走一遍添加流程,每个项目一个工作区。之后点侧边栏里的任意工作区名,就能切换当前工作区,对应会话也会跟着切换。

每个工作区是独立的,这个项目里的会话不会混进另一个项目。

常见问题

问:添加后侧边栏没显示?

先看对话框是否真的点确定了。添加成功后,工作区行会立即出现,如果没出现,检查是不是选了文件而不是文件夹。

问:删除了工作区,我的文件还在吗?

在,而且会话也都在。删除工作区只是移除界面上的分组记录,你的项目文件一个都不会动,之前的会话会保留在"未分组"里。

问:同一个目录能添加两次吗?

不能。dsh 会对目录路径做规范化处理,同一个目录只会有一条工作区记录。

小结

  • 两个入口都能添加:对话区选择按钮、侧边栏工作区分区添加按钮
  • 选项目根目录,显示名默认取目录名,添加后自动选中
  • 工作区可重命名、删除(不删文件和会话)、可加多个并随意切换

工作区就绪,下一节我们发出第一条指令,让 agent 真正开始干活。

发现错误?提交反馈 · 欢迎 提 PR 改进本书