ChatGPTClaudeGrok / X / CursorGemini

DSH plugin 的 sameWorkspace 怎么用:宿主为什么不该比较自己没收到的路径

插件开发发布于 2026-11-10作者: DeepSeek Plugin 插件市场
DSH pluginDeepSeek Harness会话引用sameWorkspacecwd
sameWorkspace 只在源会话 cwd 已记录且等于请求方 cwd 时为真。本文讲它的真值表、为什么不能自己比较路径、cwd 缺失时怎么分组,以及三种可复现的验证场景。

在 DSH plugin(DSH插件) 里,sameWorkspace 不是「看起来像同一个项目」,而是一个严格的三态压缩:cwd 已记录且相等为 true,其他情况一律 false。 你的宿主拿它做分组可以,但拿它推断「一定不同项目」就会误判。

DSH plugin 标「同项目」时的尴尬

候选里有的带 cwd,有的不带,前端无法统一比较。(来源) 现场:

text
候选 1  cwd=/repo/app    sameWorkspace=true
候选 2  cwd=/repo/docs   sameWorkspace=false
候选 3  cwd 缺失          sameWorkspace=false

如果前端自己写 candidate.cwd === currentCwd,候选 3 会得到 undefined === '/repo/app',结果是 false,看起来和候选 2 一样。

但两者的含义完全不同:候选 2 是「确实不同」,候选 3 是「不知道」。UI 上把「不知道」混进「不同」,会让用户以为那个会话在别的项目。

DSH plugin sameWorkspace 的真值表

只有一种情况为真,其余两种为假。(来源) 真值表:

源会话 cwd与请求方 cwd 关系sameWorkspace
已记录相等true
已记录不等false
缺失无法比较false

官方注释有一句关键说明:只展示区分位置的宿主,读这个字段,而不是比较自己从未收到的路径。

这句话点出了设计动机:有些宿主根本拿不到对方 cwd,只想要一个「同不同」的答案。

DSH plugin 里为什么不能自己比较路径

三个原因,分别是缺失、规范化和权限。(来源) 拆开看:

  1. 缺失 — 对方 cwd 可能没记录,比较没有意义;
  2. 规范化 — 尾部斜杠、相对路径、大小写在不同平台上不等价;
  3. 越权假设 — 路径相同不代表权限相同,比较结果容易被误用。

第一点是硬约束:没有值就不能比较。第二点决定即使有值,也不该由前端做字符串相等。

所以 sameWorkspace 的价值不是「省一行代码」,而是把「能不能比较」这件事交给知道答案的一层。

DSH plugin 里 cwd 缺失意味着什么

意味着这条候选仍然可用,只是位置未知。(来源) 缺失不等于会话损坏,也不等于会话不在本地。

可能的来源包括:历史会话迁移、创建时未记录、来源本身不提供路径。官方对候选字段的描述是「when recorded」,说明缺失是预期状态。

处理原则:

  • 不要因为 cwd 缺失就过滤掉候选;
  • 不要把缺失渲染成「其他项目」;
  • 需要展示时,用「位置未知」这类中性文案。

这三条能避免用户误删或误选。

DSH plugin 候选分组的三种做法

按信息量从少到多,选一种就够。(来源) 对照:

做法依据适合
两分组sameWorkspace只要「当前项目/其他」
三分组sameWorkspace + cwd 是否存在需要区分「未知」
完整路径分组cwd需要按目录树组织

三分组是多数产品的平衡点:同目录、其他目录、未知目录。它不会泄露完整路径,也不会把未知混进其他。

如果选了完整路径分组,仍然要处理 cwd 缺失,否则会出现一个空的「undefined」分组。

DSH plugin sameWorkspace 的验证

三种候选各造一个,真值必须对得上。 步骤:

  1. 构造与请求方同 cwd 的会话,确认 sameWorkspace 为 true;
  2. 构造不同 cwd 的会话,确认为 false,且 cwd 有值;
  3. 构造无 cwd 的会话,确认为 false,且 cwd 为空;
  4. 把三种候选放进同一列表,确认分组不会把 2 和 3 合并。

第 4 步是 UI 层断言:如果 2 和 3 显示在同一组,说明分组只用了布尔值,没有看 cwd 是否存在。

另外要在文档里写清:sameWorkspace 只说明目录相同,不代表权限相同。跨机器上的同名目录也可能为 true,不能拿它当访问控制的依据。

候选里的 cwd 只用于展示与分组,不要原样写进面向用户的日志,路径里可能带有用户名。

位置判断之后,下一步是顺序。读 DSH plugin 会话候选的排序与 self 排除;想看候选名怎么选,读 DSH plugin 会话候选名怎么选;想先看全貌,读 DSH plugin 怎么完整实现会话引用。

来源:DeepSeek Harness 官方参考 - 会话引用、session-reference/src/types.ts

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DSH plugin 的 sameWorkspace 为 false,是不是说明两个会话一定在不同项目?

不一定,DSH plugin 的 false 包含两种情况。DSH plugin 只在源会话 cwd 已记录且等于请求方 cwd 时才返回 true;cwd 缺失时同样是 false,所以 false 包含「不同目录」和「没有记录」两种情况。

DSH plugin 里宿主为什么不能自己比较 cwd,字符串相等不就行了?

因为宿主往往拿不到对方的 cwd,DSH plugin 的候选可能不带这个字段。DSH plugin 的候选可能不带 cwd,这种情况下任何比较都基于缺失值;sameWorkspace 就是给这类宿主准备的现成判断。

DSH plugin 的 sameWorkspace 能用来判断权限或安全边界吗?

不能,DSH plugin 的 sameWorkspace 只表示目录是否一致。DSH plugin 的这个字段只表示工作目录是否一致,不表示访问权限;把它当安全判断会让界面展示与真实权限脱节。

DSH plugin 候选列表要分组时,应该用 sameWorkspace 还是 cwd?

要看 DSH plugin 的分组目的:只判断是否同目录就用 sameWorkspace,需要具体路径再用 cwd。DSH plugin 允许 cwd 缺失,分组逻辑必须先处理缺失,再做展示。

相关术语

sameWorkspace
sameWorkspace 是会话候选上的布尔字段,表示源会话 cwd 已记录且等于请求方 agent 的 cwd。— DeepSeek Harness 官方参考 - 会话引用
请求方 agent
请求方 agent 是发起候选发现的智能体,它的 cwd 作为比较基准。— DeepSeek Harness 官方参考 - 会话引用
cwd 缺失
cwd 缺失是源会话没有记录工作目录的状态,此时候选仍可用,但无法判断是否同目录。— DeepSeek Harness 官方参考 - 会话引用
分组展示(grouped display)
分组展示是按同一工作目录、其他目录、未知目录等类别组织候选列表的界面做法。— DeepSeek Harness 官方参考 - 会话引用

来源