@deepseek-ai/dsh-host-directory-picker-auto

English | 中文

目录选择 seam 的自适应选择器：一个只有 node 半侧的插件，在启动时一次性判定宿主处境，并把匹配的双面后端——-native 或 -browse——作为真实的 Loader 条目挂进内存根树（绝不持久化到配置文件；根树的 write() 是 no-op）。由于后端以普通条目的形式到达，其 browser half 被 client 模块表发现的方式与配置行完全相同，因此对判定出的选择，seam 的“一行同时换两面”不变式依然成立。卸载该选择器会再次移除该条目，连同两面一起卸载。

判定是一次纯函数的启动时采样（resolveDirectoryPickerBackend），已导出供复用。native 要求“操作者看得到宿主屏幕、且 native 后端能服务它”的全部信号：仅回环的绑定（从注入的 webServer 读取；全网卡绑定会接入任何 OS 选择器都触及不到的远程浏览器）；非 SSH 启动（SSH_CONNECTION／SSH_TTY 未设置或为空——SSH 端口转发下选择器会弹在无人值守的服务器上）；以及可服务的显示会话——darwin／win32 上视为存在；linux 上要求 DISPLAY／WAYLAND_DISPLAY，外加 PATH 上有 zenity 或 kdialog 二进制（该探查是又一项启动时事实）；其余任何平台上都不成立，因为 native 后端驱动的平台恰为 darwin／win32／linux。任何含糊情形都判定为处处可用的 browse。采样每次启动恰好发生一次，因此挂载的能力在服务生命周期内保持稳定，符合 seam 的要求。固定某种交互在这里不是配置字段——直接组合 -native 或 -browse 行来替代本行，那才是 seam 文档化的切换点；同时挂载选择器和某个后端行会明确报错（重复的 directoryPicker 服务、single 类 slot 中的重复 client 流程）。

模型体验

无。该选择器仅组合 GUI 宿主的目录选择；这里没有任何内容进入模型请求。

KV Cache 影响

无；该包既不组装也不发送提供方请求。

已知限制与暂缓事项

• 探测是从启动上下文推断操作者位置，而任何启动侧信号都无法证明这一点——从 SSH 启动中脱离的 tmux 会话会丢失 SSH_* 标记；Aqua 会话之外的 Darwin 进程仍被算作有显示；在工作站本地启动、之后经 ssh -L 访问时，请求会从 127.0.0.1 到达，系统会判定 native，并把选择器弹在无人值守的工作站上。错误的 native 选择会退化为后端既有的可重试失败对话框，而对这类部署，直接组合 -browse 即选择安全的交互。
• Linux 选择器探查只读 PATH——以其他途径可用的 zenity／kdialog（shell 别名、未装在 PATH 上）仍判定为 browse；把任一二进制装到 PATH 上，下次启动即恢复 native 资格。
• 仅在启动时判定——一次判定服务本次启动的所有客户端；按连接自适应（同一台服务器，本地浏览器用 native、远程浏览器用 browse）需要按客户端的能力对象以及 seam 有意删除的协议通告，等到出现同时服务两种形态的部署再做。