Skip to content

2.1 什么是工作区

本节目标

理解工作区这个概念:它是什么、为什么必须先选它、它管着哪些东西。

一个比喻

想象你雇了一位远程助理,他住在线上,看不到你的电脑。你要让他帮你干活,第一件事是什么?告诉他你的项目在哪。要不然他不知道去哪个文件夹翻文件,也不知道改完的东西放哪。

工作区就是这个"项目在哪"的答案。

工作区的官方定义

在 dsh 里,工作区是一个项目目录的持久化记录。它记着三样东西:

  • 目录路径:你让 agent 干活的那个文件夹的真实位置
  • 显示名称:界面上显示的名字,默认取目录名
  • 会话归属:在这个工作区里开过的所有会话

一句话:工作区 = 目录 + 名字 + 它的会话清单

为什么必须先选工作区

因为 dsh 的所有"动手"都建立在工作区上:

动作依赖工作区的地方
读文件在哪个目录里找文件
改代码改完写回哪个目录
跑命令在哪个目录下执行命令
会话归属这次对话算哪个项目的

不选工作区,agent 就没有"地盘",自然没法真正干活。这也是为什么主界面上,选中工作区之前,会话输入框是锁着的。

一个目录一个工作区,可以有很多个

  • 一个工作区对应一个目录,路径会做规范化处理,同一个目录不会重复创建
  • 可以添加多个工作区,对应你手头的多个项目
  • 工作区和你的文件系统是引用关系:添加工作区不会复制、移动你的任何文件,删掉工作区也不会删除你的文件,只是把这条"记录"从界面上去掉

工作区在界面上长什么样

打开 dsh 主界面,左侧边栏有一个工作区分区(在新建会话按钮下方):

主界面与侧边栏

分区里会列出你添加过的工作区,每个工作区下面展开属于它的会话。你添加的第一个工作区,会在下一节出现。

小结

  • 工作区是"项目目录 + 显示名 + 会话清单"的记录
  • agent 读文件、跑命令、归属会话都依赖工作区,所以它是界面的第一道解锁
  • 一个目录一个工作区,可加多个,删除工作区不会删你的文件

概念清楚了,下一节动手添加你的第一个工作区。

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