ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness 工作区的三个身份:目录路径、项目标识与沙箱写入根怎么区分

概念与架构发布于 2026-11-18作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugin工作区沙箱工作目录
工作区在 DeepSeek Harness 里同时是目录路径、项目标识与沙箱写入根,三者不是同一个值。本文拆开三个身份,解释换工作目录后谁变谁不变,并给三个典型故障例。

「工作区」在 DeepSeek Harness 里至少有三个身份:你看到的目录路径、会话归属用的项目标识、权限比较用的沙箱写入根。 官方对工作目录的说明很明确:它提供用户上下文与执行路径,但不改变原始项目标识、沙箱写入根或已有进程目录(来源)。三者混在一起,就会出现「路径对但写不进去」「切了目录会话却还挂在旧项目」这类问题。

DeepSeek Harness 三个身份不是同一个路径

三个身份分别回答不同问题:在哪、属于谁、能写哪。 先把它们分开(来源):

身份回答的问题由谁使用
目录路径用户看到的项目在哪界面、配置、用户操作
项目标识会话属于哪个项目会话归属、恢复、归档
沙箱写入根权限允许写哪里沙箱、审批、执行器

很多「工作区问题」本质是把三者当成一个值。路径改了,就以为项目标识也改了;路径看起来在范围内,就以为沙箱写入根也允许。

三个身份可以一致,也可以不一致。一致时最省心,不一致时就需要知道每个操作到底看哪一个。

DeepSeek Harness 目录路径:用户看到的项目位置

目录路径是最外层,也是最容易变的一层。 你在界面里选择目录、在命令行 cd 到项目、在配置里写绝对路径,改的都是这一层。(来源)

路径的作用是「告诉系统和用户,项目在哪里」。它影响展示、选择与启动位置,但不自动决定会话归属,也不自动扩大写入范围。

路径有三个常见变体:绝对路径、相对路径、符号链接。相对路径依赖当前工作目录,符号链接指向真实路径;两者都可能导致「看起来是同一个目录,实际解析不同」。

一个实用原则:配置与会话里尽量用绝对路径,避免相对路径在不同启动目录下指向不同位置。符号链接要确认解析后的真实路径是否在沙箱写入根内。

DeepSeek Harness 项目标识:会话归属与恢复

项目标识是「这段会话属于哪个项目」,不是「项目在哪个目录」。 官方说明工作目录不改变原始项目标识,这意味着移动目录、切换目录、甚至从另一个路径打开,都不应让会话突然归属到另一个项目(来源)。

项目标识的作用有三处:

  1. 会话归属 — 会话列表、归档、恢复按项目聚合;
  2. 工作区记录 — 工作区保存会话 id 列表与置顶顺序;
  3. 恢复路径 — 重开项目时找回相关会话。

如果项目标识被错误改写,表现是「会话还在,但归到了另一个项目」或「工作区里看不到原来的会话」。这类问题不要先删数据,先检查记录。

项目标识通常比路径稳定,但也不是不可变。复制项目、重命名目录、跨机器迁移,都可能产生新的标识;这时要按迁移流程处理,而不是假设「路径一样就是同一个项目」。

DeepSeek Harness 沙箱写入根:权限比较的位置

沙箱写入根是权限真正比较的值,路径字符串只是它的展示。 工作目录可以提供执行路径,但权限判断看的是沙箱写入根;两者不一致时,路径再对也可能写不进去(来源)。

三个常见错位:

  • 工作目录在根内,写入根在别处 — 读得到,写被拒;
  • 符号链接指向根外 — 看起来在项目里,实际写到外面;
  • 大小写或规范化差异 — Windows 与大小写不敏感文件系统上,字符串不同但指向同一位置。

沙箱写入根还与权限预设绑定。workspace-write 把可写范围限制在工作区内,越界写入触发审批;切到更宽的预设,写入根可能变化,但工作目录不变。

排查「路径对但写不进去」时,先确认当前权限预设,再确认沙箱写入根,最后确认路径解析后的真实位置。三步都比看界面路径可靠。

DeepSeek Harness 换工作目录后谁变谁不变

换工作目录,变的是执行路径,不变的是项目标识、沙箱写入根和已有进程目录。 官方把这条边界写得很清楚(来源)。

对象换工作目录后
当前执行路径变
原始项目标识不变
沙箱写入根不变
已有进程目录不变

这张表解释了两个常见现象:切到子目录后,会话仍归在原项目;切到项目外后,命令可能读得到,但写入仍被原写入根限制。

已有进程目录不变,意味着已经启动的 shell 不会因为你切目录而改变。新命令可能用新目录,旧进程还在旧目录;排查时要分清「新起的命令」与「已在跑的进程」。

如果确实需要改变写入范围,应该改权限预设或沙箱配置,而不是只改工作目录。改目录只改变执行位置,不改变权限边界。

DeepSeek Harness 三个故障例与验证

三个故障例分别对应三个身份错位。 对照现象,先判断是哪一层(来源):

  1. 切目录后会话不见了 — 项目标识没变,但界面按新目录过滤;回到原项目或按项目标识查找。
  2. 路径对但写入被拒 — 沙箱写入根与当前路径不一致;检查预设与真实路径。
  3. 工作区列表全空 — 工作区记录损坏或未挂载;会话文件可能仍在,先备份再修记录。

三个例子的共同点是「不要先删数据」。工作区记录、项目标识、会话日志是三层数据,删掉一层可能让另外两层无法恢复。

验证方法:用一条只读任务确认能读到当前目录;再用一条写入任务确认写入落在预期位置;最后切换目录,确认会话归属没有意外改变。三步都过,三个身份基本对齐。

旧文 dsh-workspace-explained 讲工作区概念,develop-workspace-package 讲包结构,fix-workspace-disappeared 讲记录修复;本篇补的是三个身份的拆分。先分清在哪、属于谁、能写哪,再谈工作区配置。

三个身份对齐之后,工作区问题就不再是「玄学」:每个现象都能落到具体一层。

路径是入口,标识是归属,写入根是权限,三者不能互相替代。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

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 Harness 官方文档 - 工作目录

来源