dsh-remote-picker
远程访问场景下 DeepSeek Harness 目录选择器的修复插件：当 Web GUI 服务于远程浏览器（tailscale serve / cloudflared / 反向代理 + --trusted-host）时，强制使用浏览器内 browse 交互，而不是会在无人值守主机上弹出、远程浏览器无法驱动的 native OS 对话框。
> 关联上游讨论：deepseek-ai/deepseek-harness#discussions/2713
> 官方 directory-picker-auto 组件自身也承认该缺陷（Playwright smoke 用 overlay 绕过：apps/web/tests/pin-browse-picker.overlay.yml）。
本插件服务的远程流程
这个插件只在一个特定的远程访问流程中有意义。先看清这条链路，再决定是否需要安装：
手机 / 笔记本浏览器（任意网络：4G、公司网、家里 WiFi）
│ https://<你的主机名>.ts.net （或 cloudflared 公网域名）
▼
tailscale serve / cloudflared ── HTTPS 反向代理（TLS 终结，仅网内可达）
│ 转发到本机
▼
dsh web ── 绑定 127.0.0.1:3080，启动参数带 --trusted-host <你的主机名>
流程各环节与责任：
| 环节 | 做什么 | 与本插件的关系 |
|---|---|---|
① dsh web --trusted-host <主机名> |
保持回环绑定（安全），并把远程域名加入 /api 白名单（防 DNS rebinding 围栏） |
前提：没有它远程页面能开但 API 全 403 |
② tailscale serve --bg 3080（或 cloudflared） |
把 https://<主机名>.ts.net 反代到本机 3080；HTTPS 是必须的（明文 HTTP 下浏览器没有 crypto.randomUUID，DSH 的 RPC 全挂） |
前提：提供远程入口 |
| ③ 手机浏览器打开远程地址 | 日常对话、查看任务、发消息 | 正常，无需本插件 |
| ④ 设置 → 工作区 → 选择目录 | 远程用户挑选/创建工作区文件夹 | 本插件接管的位置：原生对话框在电脑上弹出，手机看不到；插件强制浏览器内目录树 |
| ⑤ 设置页/API Key 管理 | 官方设计仅回环可用（403） | 与本插件无关，请在本机浏览器操作 |
一句话：如果你的使用方式符合"①+②+③"（通过 tailscale serve 或 cloudflared 从手机/远程浏览器使用 DSH），那你一定会在④遇到目录选择器故障——这个插件就是为④准备的。如果只在电脑本机用（http://127.0.0.1:3080），不需要装。
问题
dsh web 默认绑定 127.0.0.1，通过 tailscale serve / cloudflared 等反代对外提供 HTTPS 入口。@deepseek-ai/dsh-host-directory-picker-auto 的启动判定是：回环绑定 + darwin/win32 → native 后端。反代场景下浏览器是远程的（手机/笔记本），native 对话框会弹在电脑屏幕上——远程用户看不到、无法操作，工作区目录选择直接失败。
修复方式
本插件的 bundle patch（dsh.bundle.patch 机制）在启动组合中：
- 禁用 官方
directory-picker（auto）行； - 挂载 browse 后端 + 客户端界面（
@deepseek-ai/dsh-host-directory-picker-browse+@deepseek-ai/dsh-client-ui-directory-picker-browse）——即 seam 文档化的切换点； - 附带
remote-picker自检行：启动后验证 browse 能力已装载，异常时输出警告（fail loud）。
浏览器内 browse 选择器通过 /api 目录树浏览工作区文件夹，远程可用、本地可用，全平台一致。
安装
dsh plugin --profile web add dsh-remote-picker
或手动（profile 是 pnpm workspace）：
cd ~/.dsh/profiles/web
npx -y pnpm@11 add -w dsh-remote-picker
安装后重启 dsh web 生效。
> ⚠️ 若你的 cordis.patch.yml 已手工加过同款 disable+insert（远程访问排查期的常见做法），先移除那段，避免重复装载。
验证
- 启动日志出现
dsh-remote-picker: in-browser browse directory picker active - 远程浏览器（手机/另一台电脑）：设置 → 工作区 → 选择目录 → 出现可浏览的目录树
- 本地浏览器
http://127.0.0.1:3080同样可用（browse 是处处可用的交互）
与本包相关的上游补丁
完整的 trustedHosts 信号修复（auto 组件自动判定 browse）已整理为补丁提交到上游讨论区，等待官方采纳；本插件是其插件形态的等价物，无需等待上游。
License
MIT
