DSH plugin 的 sameWorkspace 怎么用:宿主为什么不该比较自己没收到的路径
在 DSH plugin(DSH插件) 里,sameWorkspace 不是「看起来像同一个项目」,而是一个严格的三态压缩:cwd 已记录且相等为 true,其他情况一律 false。 你的宿主拿它做分组可以,但拿它推断「一定不同项目」就会误判。
DSH plugin 标「同项目」时的尴尬
候选里有的带 cwd,有的不带,前端无法统一比较。(来源) 现场:
候选 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 里为什么不能自己比较路径
三个原因,分别是缺失、规范化和权限。(来源) 拆开看:
- 缺失 — 对方 cwd 可能没记录,比较没有意义;
- 规范化 — 尾部斜杠、相对路径、大小写在不同平台上不等价;
- 越权假设 — 路径相同不代表权限相同,比较结果容易被误用。
第一点是硬约束:没有值就不能比较。第二点决定即使有值,也不该由前端做字符串相等。
所以 sameWorkspace 的价值不是「省一行代码」,而是把「能不能比较」这件事交给知道答案的一层。
DSH plugin 里 cwd 缺失意味着什么
意味着这条候选仍然可用,只是位置未知。(来源) 缺失不等于会话损坏,也不等于会话不在本地。
可能的来源包括:历史会话迁移、创建时未记录、来源本身不提供路径。官方对候选字段的描述是「when recorded」,说明缺失是预期状态。
处理原则:
- 不要因为 cwd 缺失就过滤掉候选;
- 不要把缺失渲染成「其他项目」;
- 需要展示时,用「位置未知」这类中性文案。
这三条能避免用户误删或误选。
DSH plugin 候选分组的三种做法
按信息量从少到多,选一种就够。(来源) 对照:
| 做法 | 依据 | 适合 |
|---|---|---|
| 两分组 | sameWorkspace | 只要「当前项目/其他」 |
| 三分组 | sameWorkspace + cwd 是否存在 | 需要区分「未知」 |
| 完整路径分组 | cwd | 需要按目录树组织 |
三分组是多数产品的平衡点:同目录、其他目录、未知目录。它不会泄露完整路径,也不会把未知混进其他。
如果选了完整路径分组,仍然要处理 cwd 缺失,否则会出现一个空的「undefined」分组。
DSH plugin sameWorkspace 的验证
三种候选各造一个,真值必须对得上。 步骤:
- 构造与请求方同 cwd 的会话,确认
sameWorkspace为 true; - 构造不同 cwd 的会话,确认为 false,且 cwd 有值;
- 构造无 cwd 的会话,确认为 false,且 cwd 为空;
- 把三种候选放进同一列表,确认分组不会把 2 和 3 合并。
第 4 步是 UI 层断言:如果 2 和 3 显示在同一组,说明分组只用了布尔值,没有看 cwd 是否存在。
另外要在文档里写清:sameWorkspace 只说明目录相同,不代表权限相同。跨机器上的同名目录也可能为 true,不能拿它当访问控制的依据。
候选里的 cwd 只用于展示与分组,不要原样写进面向用户的日志,路径里可能带有用户名。
位置判断之后,下一步是顺序。读 DSH plugin 会话候选的排序与 self 排除;想看候选名怎么选,读 DSH plugin 会话候选名怎么选;想先看全貌,读 DSH plugin 怎么完整实现会话引用。
来源:DeepSeek Harness 官方参考 - 会话引用、session-reference/src/types.ts
常见问题
不一定,DSH plugin 的 false 包含两种情况。DSH plugin 只在源会话 cwd 已记录且等于请求方 cwd 时才返回 true;cwd 缺失时同样是 false,所以 false 包含「不同目录」和「没有记录」两种情况。
因为宿主往往拿不到对方的 cwd,DSH plugin 的候选可能不带这个字段。DSH plugin 的候选可能不带 cwd,这种情况下任何比较都基于缺失值;sameWorkspace 就是给这类宿主准备的现成判断。
不能,DSH plugin 的 sameWorkspace 只表示目录是否一致。DSH plugin 的这个字段只表示工作目录是否一致,不表示访问权限;把它当安全判断会让界面展示与真实权限脱节。
要看 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 官方参考 - 会话引用
来源
- DeepSeek Harness 官方参考 - 会话引用· deepseek-ai
- session-reference/src/types.ts· deepseek-ai