远程工作区快建 wilsonchengassistant/dsh-quick-workspace

dsh-quick-workspace

当你在非宿主机上操作 DeepSeek Harness 网页界面时，让侧边栏的 Add workspace 按钮正常工作。

问题出在哪

默认流程会在宿主机上打开系统文件夹选择器。在 macOS 上，只要绑定地址是 127.0.0.1，dsh-host-directory-picker-auto 就会选用 native 后端，而这个后端执行的是无渲染的 osascript "choose folder with prompt …" 调用：它在宿主机屏幕上弹出 Finder 对话框，浏览器里什么都不显示。

所以从远程浏览器（Tailscale、局域网、手机）看，这个按钮完全没反应，而且比没反应更糟——隐藏对话框打开期间，WorkspacePickFlow 会一直持有 directoryBusy，而只要这个标志被设置，shortcutControls.add 就是空操作。之后每次点击都被静默忽略，不报错，屏幕上也没有任何提示。

这个插件做什么

它接管目录流程的两个入口——侧边栏标题栏按钮和输入框的 Choose workspace——换成一个名称对话框：

1. 你输入一个名称，
2. 对话框显示即将创建的完整路径，
3. DSH 创建文件夹并把它注册为工作区，然后打开它。

新文件夹落在部署默认工作区旁边。在这台机器上，如果工作区是 ~/Documents/deepseek-harness/default-workspace，那么默认工作区就是 ~/Documents/deepseek-harness/。

它以 priority: -100 注册，这是官方文档给出的做法，用来遮蔽单类型槽位的占用者：SlotCore.register 按优先级升序排列条目，优先级最低的负责渲染，于是它占住这个位置，而不会对 native/browse 选择器抛出 already has a registration。

安装

dsh plugin --profile web add file:/path/to/plugins/dsh-quick-workspace

然后重启 dsh web，让宿主机那一半重新导入（见下文）。

改这个插件时容易踩的两个坑

- lib/index.js 需要重启 dsh web。 客户端那一半会热重载，宿主机那一半不会。改完 lib/index.js 后，执行 rm -rf ~/.dsh/profiles/web/node_modules/dsh-quick-workspace 再重新添加，或者重启服务器。
- process.cwd() 是 /。 dsh web 以 launchd KeepAlive 代理运行，工作目录是文件系统根目录，mkdir("/<name>") 会失败，只抛出一个光秃秃的 EACCES，用户看不出任何信息。父目录改为从 workspaceRegistry 取，根目录则直接拒绝，报 quick-workspace/no-parent。

值得记住的通信格式

- ctx.connection.rpc.call("/api", "ns/method", payload) 解析出的是 {ok, value | error} 信封。直接读它的 .path 会得到 undefined，而且不会抛错——一定要先拆信封。
- Gateway 从 Host 方法的签名推导参数描述符。无参数的 describe() 必须发送 {args: {}}；{args: {request: {}}} 会被拒绝，报 gateway/arguments-invalid。

卸载

dsh plugin --profile web remove dsh-quick-workspace（或者在 Plugins 页面禁用它），然后重启 dsh web。自带的文件夹选择器就会恢复。