DeepSeek Harness 工作区的三个身份:目录路径、项目标识与沙箱写入根怎么区分
「工作区」在 DeepSeek Harness 里至少有三个身份:你看到的目录路径、会话归属用的项目标识、权限比较用的沙箱写入根。 官方对工作目录的说明很明确:它提供用户上下文与执行路径,但不改变原始项目标识、沙箱写入根或已有进程目录(来源)。三者混在一起,就会出现「路径对但写不进去」「切了目录会话却还挂在旧项目」这类问题。
DeepSeek Harness 三个身份不是同一个路径
三个身份分别回答不同问题:在哪、属于谁、能写哪。 先把它们分开(来源):
| 身份 | 回答的问题 | 由谁使用 |
|---|---|---|
| 目录路径 | 用户看到的项目在哪 | 界面、配置、用户操作 |
| 项目标识 | 会话属于哪个项目 | 会话归属、恢复、归档 |
| 沙箱写入根 | 权限允许写哪里 | 沙箱、审批、执行器 |
很多「工作区问题」本质是把三者当成一个值。路径改了,就以为项目标识也改了;路径看起来在范围内,就以为沙箱写入根也允许。
三个身份可以一致,也可以不一致。一致时最省心,不一致时就需要知道每个操作到底看哪一个。
DeepSeek Harness 目录路径:用户看到的项目位置
目录路径是最外层,也是最容易变的一层。 你在界面里选择目录、在命令行 cd 到项目、在配置里写绝对路径,改的都是这一层。(来源)
路径的作用是「告诉系统和用户,项目在哪里」。它影响展示、选择与启动位置,但不自动决定会话归属,也不自动扩大写入范围。
路径有三个常见变体:绝对路径、相对路径、符号链接。相对路径依赖当前工作目录,符号链接指向真实路径;两者都可能导致「看起来是同一个目录,实际解析不同」。
一个实用原则:配置与会话里尽量用绝对路径,避免相对路径在不同启动目录下指向不同位置。符号链接要确认解析后的真实路径是否在沙箱写入根内。
DeepSeek Harness 项目标识:会话归属与恢复
项目标识是「这段会话属于哪个项目」,不是「项目在哪个目录」。 官方说明工作目录不改变原始项目标识,这意味着移动目录、切换目录、甚至从另一个路径打开,都不应让会话突然归属到另一个项目(来源)。
项目标识的作用有三处:
- 会话归属 — 会话列表、归档、恢复按项目聚合;
- 工作区记录 — 工作区保存会话 id 列表与置顶顺序;
- 恢复路径 — 重开项目时找回相关会话。
如果项目标识被错误改写,表现是「会话还在,但归到了另一个项目」或「工作区里看不到原来的会话」。这类问题不要先删数据,先检查记录。
项目标识通常比路径稳定,但也不是不可变。复制项目、重命名目录、跨机器迁移,都可能产生新的标识;这时要按迁移流程处理,而不是假设「路径一样就是同一个项目」。
DeepSeek Harness 沙箱写入根:权限比较的位置
沙箱写入根是权限真正比较的值,路径字符串只是它的展示。 工作目录可以提供执行路径,但权限判断看的是沙箱写入根;两者不一致时,路径再对也可能写不进去(来源)。
三个常见错位:
- 工作目录在根内,写入根在别处 — 读得到,写被拒;
- 符号链接指向根外 — 看起来在项目里,实际写到外面;
- 大小写或规范化差异 — Windows 与大小写不敏感文件系统上,字符串不同但指向同一位置。
沙箱写入根还与权限预设绑定。workspace-write 把可写范围限制在工作区内,越界写入触发审批;切到更宽的预设,写入根可能变化,但工作目录不变。
排查「路径对但写不进去」时,先确认当前权限预设,再确认沙箱写入根,最后确认路径解析后的真实位置。三步都比看界面路径可靠。
DeepSeek Harness 换工作目录后谁变谁不变
换工作目录,变的是执行路径,不变的是项目标识、沙箱写入根和已有进程目录。 官方把这条边界写得很清楚(来源)。
| 对象 | 换工作目录后 |
|---|---|
| 当前执行路径 | 变 |
| 原始项目标识 | 不变 |
| 沙箱写入根 | 不变 |
| 已有进程目录 | 不变 |
这张表解释了两个常见现象:切到子目录后,会话仍归在原项目;切到项目外后,命令可能读得到,但写入仍被原写入根限制。
已有进程目录不变,意味着已经启动的 shell 不会因为你切目录而改变。新命令可能用新目录,旧进程还在旧目录;排查时要分清「新起的命令」与「已在跑的进程」。
如果确实需要改变写入范围,应该改权限预设或沙箱配置,而不是只改工作目录。改目录只改变执行位置,不改变权限边界。
DeepSeek Harness 三个故障例与验证
三个故障例分别对应三个身份错位。 对照现象,先判断是哪一层(来源):
- 切目录后会话不见了 — 项目标识没变,但界面按新目录过滤;回到原项目或按项目标识查找。
- 路径对但写入被拒 — 沙箱写入根与当前路径不一致;检查预设与真实路径。
- 工作区列表全空 — 工作区记录损坏或未挂载;会话文件可能仍在,先备份再修记录。
三个例子的共同点是「不要先删数据」。工作区记录、项目标识、会话日志是三层数据,删掉一层可能让另外两层无法恢复。
验证方法:用一条只读任务确认能读到当前目录;再用一条写入任务确认写入落在预期位置;最后切换目录,确认会话归属没有意外改变。三步都过,三个身份基本对齐。
旧文 dsh-workspace-explained 讲工作区概念,develop-workspace-package 讲包结构,fix-workspace-disappeared 讲记录修复;本篇补的是三个身份的拆分。先分清在哪、属于谁、能写哪,再谈工作区配置。
三个身份对齐之后,工作区问题就不再是「玄学」:每个现象都能落到具体一层。
路径是入口,标识是归属,写入根是权限,三者不能互相替代。
常见问题
DeepSeek Harness 里不是这样。DeepSeek Harness 的工作区路径是用户看到的目录位置,项目标识用于会话归属与恢复;改变工作目录不会自动改变原始项目标识。
DeepSeek Harness 里,不会自动跟着变。DeepSeek Harness 的工作目录提供用户上下文与执行路径,但原始项目标识、沙箱写入根和已有进程目录保持不变。
DeepSeek Harness 里,可能是沙箱写入根与当前路径不一致。DeepSeek Harness 的权限比较的是沙箱写入根,不是你看到的目录字符串;路径看起来对,不代表在可写范围内。
DeepSeek Harness 里,通常还在。DeepSeek Harness 的工作区记录与会话数据分开存储,记录损坏或未挂载会让界面看起来全消失,但文件往往仍在盘上,先不要删数据。
相关术语
- 工作区路径
- 工作区路径是用户在界面或配置中看到的项目目录位置,用于展示与选择,不等同于项目标识或沙箱写入根。— DeepSeek Harness 官方文档 - 工作区
- 项目标识
- 项目标识是 DeepSeek Harness 用于会话归属与恢复的稳定身份,改变工作目录不会自动改变它。— DeepSeek Harness 官方文档 - 工作目录
- 沙箱写入根
- 沙箱写入根是 DeepSeek Harness 权限策略实际比较的路径范围,决定哪些写入被允许、哪些需要审批。— DeepSeek Harness 官方文档 - 工作目录
- 工作目录
- 工作目录是 DeepSeek Harness 提供给用户上下文与执行路径的目录,不改变原始项目标识、沙箱写入根或已有进程目录。— DeepSeek Harness 官方文档 - 工作目录
来源
- DeepSeek Harness 官方文档 - 工作区· deepseek-harness
- DeepSeek Harness 官方文档 - 工作目录· deepseek-ai