远程桌面桥接sincerity711/dsh-remote-desktop

dsh-remote-desktop

从一个本地 DSH 网页操作远程 DeepSeek Harness Web 会话。

dsh-remote-desktop 是一个双插件捆绑包：

- dsh-remote-desktop 运行在本地 DSH Web 配置中。它发现 SSH 主机、打开隧道、代理远程 DSH API，并用统一的本地/远程工作区浏览器替换本地工作区侧边栏。
- dsh-remote-desktop-companion 运行在每个远程 DSH Web 配置中。它验证来自本地页面的 iframe 控制消息、打开请求的远程会话，并隐藏嵌入的远程侧边栏。

最终结果是一个以项目为先的侧边栏，本地工作区和已连接的远程工作区出现在同一个列表中。远程项目会显示一个紧凑的主机标记，例如 win-wsl 或 xsn，远程会话则在隔离的 iframe 中打开。

功能特性

- 面向 DSH Web 的统一本地 + 远程工作区侧边栏。
- 基于 SSH 的主机发现，来自 ~/.ssh/config 中具体的 Host 条目。
- 每主机回环隧道和浏览器代理。
- 远程会话的打开、新建会话、重命名、分叉、归档、搜索以及工作区变更操作都会路由到所属主机。
- 添加远程工作区流程，带有从 SSH 用户主目录开始的远程目录选择器。
- 感知来源的未分组桶，包括每主机的 归档所有会话。
- 官方设置集成，用于远程桌面主机管理。

功能截图

以下所有截图均为合成图，使用匿名化的主机、用户、工作区和会话名称。

统一的本地 + 远程侧边栏

统一的本地和远程 DSH 侧边栏

远程工作区目录选择器

远程工作区目录选择器

远程桌面设置

远程桌面设置主机列表

安装

将本地控制器安装到本地 DSH Web 配置中：

dsh plugin --profile web add dsh-remote-desktop

将配套插件安装到每个需要从本地页面控制的远程 DSH Web 配置中：

dsh plugin --profile web add dsh-remote-desktop-companion

在发布到 npm 之前，请克隆此仓库并显式安装包目录：

git clone https://github.com/sincerity711/dsh-remote-desktop.git

dsh plugin --profile web add /path/to/dsh-remote-desktop/packages/local
在每个远程主机/配置上：
dsh plugin --profile web add /path/to/dsh-remote-desktop/packages/companion

如果使用 DeepSeek Harness 源码检出，请将 dsh 替换为检出包装器，例如 pnpm dsh。

远程主机设置

1. 在远程机器上启动 DSH Web，绑定到远程回环地址。
2. 在该远程 Web 配置中安装 dsh-remote-desktop-companion。
3. 在本地机器上添加一个具体的 SSH Host 别名。
4. 打开本地 DSH Web，进入 设置 → 远程桌面，然后连接该主机。

最小远程命令：

DSH_HOME=$HOME/.dsh-remote-desktop \
dsh --profile web \
--host 127.0.0.1 \
--port 30800 \
--trusted-host 127.0.0.1:30800

最小本地 SSH 配置：

Host win-wsl
HostName win-wsl
User your-user

完整设置清单请参见远程服务器设置。

架构参考

- 架构 — 包角色、SSH/代理生命周期、远程 API、iframe 桥接、侧边栏投影、添加工作区流程以及 fork 清单。
- 验收标准 — P0/P1/P2 验证范围以及隔离测试主目录规则。

社区插件发现

本仓库已为当前 DeepSeek Harness 社区插件发现流程做好准备。将以下 GitHub 主题添加到公共仓库：

dsh-plugin
deepseek-harness
dsh
remote-desktop
remote-workspace

可发布的包也带有匹配的 npm keywords。

开发

npm run build
npm run check

packages/*/lib/client.js 下的浏览器客户端发布文件是生成的。
请编辑 packages/local/src/client/ 或 packages/companion/src/client.js；静态门禁会拒绝过期的生成输出。

在 macOS 上进行本地验收时，请使用 Apple container：

npm run acceptance:container:up
npm run acceptance:container:p0
npm run acceptance:container:p1

启动一个保留的金丝雀系统，以便使用本地和远程种子会话进行手动试玩：

ollama pull minicpm-v4.6:1b
npm run acceptance:container:canary

该金丝雀需要宿主机的 Ollama 服务，并将 minicpm-v4.6:1b 配置为本地 DSH 实例和两个远程 DSH 实例的可路由默认模型。其隔离进程还会收到 DSH_RD_OLLAMA_API_KEY=ollama-canary-dummy-key，因为即使本地 Ollama 端点不验证凭据，OpenAI 兼容客户端也需要一个凭据。设置 DSH_RD_OLLAMA_MODEL、DSH_RD_OLLAMA_BASE_URL 或 DSH_RD_OLLAMA_API_KEY 可覆盖这些金丝雀值。

Apple container 远程实例会一直运行，直到被显式停止：

npm run acceptance:container:down
npm run acceptance:container:clean

在有意验证真实远程主机时，仍可使用外部 SSH 主机验收：

npm run acceptance:p0
npm run acceptance:p1