Yuuichu/dsh-remote-picker

dsh-remote-picker

npm version
npm downloads
License
dsh plugin

远程访问场景下 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 机制）在启动组合中：

1. 禁用 官方 directory-picker（auto）行；
2. 挂载 browse 后端 + 客户端界面（@deepseek-ai/dsh-host-directory-picker-browse + @deepseek-ai/dsh-client-ui-directory-picker-browse）——即 seam 文档化的切换点；
3. 附带 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）已整理为补丁提交到上游讨论区，等待官方采纳；本插件是其插件形态的等价物，无需等待上游。

许可证

MIT