dsh-remote-panel-ssh
在桌面应用中嵌入远程 DeepSeek Harness：通过 SSH 引导、按需安装远程 dsh、建立环回隧道，并使用同机网关将远程 UI 提供给面板 iframe。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-remote-panel-ssh@0.1.1Remote Panel Ssh 以 dsh-remote-panel-ssh 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把一台远程 Linux 机器上的 DeepSeek Harness 直接嵌进桌面应用的侧边栏面板：左侧一个「远程 DSH」入口，点开选主机，远端那套会话 / 工作区 / 文件都在面板里，就像本地的一样。
A DeepSeek Harness (DSH) plugin that runs a remote harness inside the desktop app's own window: SSH bootstrap, on-demand remote
dshinstall, loopback tunnel, and a same-machine gateway that serves the remote UI to a panel iframe.
DSH 桌面壳的页面来自自定义 scheme dsh-app://app，而远端 dsh web 是 http://127.0.0.1:<port>。直接把远端塞进 iframe 会遇到两个死结：
SameSite=Strict，在 dsh-app:// 的第三方上下文里根本不会被发送 → 页面 401；Set-Cookie 的 payload 里写着 127.0.0.1:<远端端口>，端口一变就失效。所以本插件不让浏览器碰 cookie：
桌面壳 (dsh-app://app)
└─ iframe → http://127.0.0.1:<网关端口>/ ← 本机 http，无需任何 cookie
└─ 网关（插件宿主进程内）
├─ 自己完成 ?token= → Set-Cookie 的换取
├─ 转发 HTTP（重写 Host/Origin/Referer，带上远端 cookie）
├─ 转发 WebSocket（/api/remote.mux，原样升级）
└─ 注入 Esc 桥接脚本（见下）
└─ 本地隧道 127.0.0.1:<随机> → 远端 127.0.0.1:<dsh web 端口>
└─ SSH 连接 → ssh2.forwardOut()
所有远程操作都走 SSH，因此远端只需要把 dsh web 绑在 127.0.0.1，不需要暴露到局域网，也不需要额外装任何 helper。
| 能力 | 说明 |
|---|---|
| 主机列表 | 自动复用 ~/.dsh/dsh-ssh.json 里已配置的 SSH 主机（标记「SSH 插件」），也可以在面板里自己添加（标记「本面板」） |
| 添加主机 | 名称、主机/IP、SSH 端口、用户名、密码、远端 dsh web 端口、安装用代理（可选） |
| 连接测试 | 只探测、不安装不启动：SSH 是否通、Node 版本、远端 dsh 版本是否与本地一致、远端 dsh web 是否在跑，并给出耗时 |
| 删除主机 | 本面板添加的直接删除；来自 SSH 插件的会在确认后同时从 ~/.dsh/dsh-ssh.json 移除 |
| 自动安装 | 远端没有 dsh 或版本不一致时，自动 npm i -g --prefix "$HOME/.local" @deepseek-ai/dsh@<本地版本>，安装过程有阶段提示与耗时 |
| 自动启动 | 确保远端 dsh web 在跑；没跑就 nohup ... --host 127.0.0.1 --port <webPort> --no-open 拉起来（最多等 40 秒） |
| 会话内嵌 | 面板里直接是远端 DSH，可重新加载 / 断开 |
| 放大 | 面板铺满整个窗口（保留 Windows 三个窗口按钮与任务栏），按 Esc 退出 |
| 剪贴板 | iframe 显式委派 clipboard-read; clipboard-write，远端「复制链接」可用；另外提供「在新窗口打开」作为兜底 |
| 自动恢复 | 远端 401（例如重启换了 token）时网关自动重读 token 并重试一次 |
dsh plugin --profile desktop add dsh-remote-panel-ssh
装完完全退出 DSH 桌面应用（托盘也要退）再打开，左侧出现「远程 DSH」。依赖 ssh2 由安装器一并装好。
名字是
dsh-remote-panel-ssh：registry 上的dsh-remote-panel属于另一位作者的另一个项目，dsh-remote-ssh/dsh-remote-desktop也都已被占用。
dsh plugin --profile desktop add github:1583477320/remote-dsh
国内网络直连 GitHub 可能超时；这种情况下优先用上面的 npm 方式。
git clone https://github.com/1583477320/remote-dsh.git
cd remote-dsh
dsh plugin --profile desktop add link:$(pwd)
link: 会建软链指向仓库目录：改代码后完全退出应用再打开即生效（客户端 bundle 带 rev，必须重启才会刷新）。
把本仓库放到 profile 的 node_modules 下：
cp -r . ~/.dsh/profiles/desktop/node_modules/dsh-remote-panel-ssh
在 ~/.dsh/profiles/desktop/cordis.patch.yml 末尾追加：
- insert:
- id: remote-dsh
name: dsh-remote-panel-ssh
完全退出 DSH 桌面应用（托盘也要退）后重新打开，左侧出现「远程 DSH」。
插件依赖
ssh2。若手动拷贝，请确认 profile 的node_modules里能解析到ssh2（dsh plugin add会自己装依赖）。
左侧点「远程 DSH」；
选一台主机，先点 测试 看环境（推荐，尤其新机器）：
SSH 正常 · Node v24.18.0 · dsh 未安装（连接时会自动安装） · 远端 dsh web 未运行（连接时会启动） · 842ms
点 连接，首次会经历：SSH → 检查环境 → 安装 dsh（如需）→ 启动 dsh web → 建立通道，面板会在每一步显示阶段与已用秒数；
连上后：重新加载 / 放大（Esc 退出）/ 在新窗口打开 / 断开；
远端 DSH 是独立登录态，第一次需要在那套界面里登录一次 DeepSeek 账号（或用 API key）。
| 字段 | 默认值 | 说明 |
|---|---|---|
label | 主机地址 | 列表里显示的名称 |
host / sshPort | — / 22 | SSH 目标 |
user / password | — | SSH 凭据（也支持复用 dsh-ssh 的密钥条目） |
webPort | 18080 | 远端 dsh web 监听端口（仅 127.0.0.1） |
installProxy | 空 | 自动安装时使用的 HTTP 代理；留空会尝试探测远端 127.0.0.1:7890 |
dshBin | ~/.local/bin/dsh | 远端 dsh 可执行文件（环境变量 DSH_BIN 可覆盖探测） |
webLog | ~/.dsh/logs/dsh-web.log | 远端 dsh web 日志（token 从这里读） |
| 变量 | 作用 |
|---|---|
DSH_REMOTE_HOST / DSH_REMOTE_PORT | 覆盖内置示例主机（仅调试用） |
DSH_REMOTE_STATE_URL | 覆盖远端 helper 地址（兼容早期的 /state 模式） |
DSH_BIN | 远端 dsh 路径 |
~/.dsh/remote-dsh.json，权限 0600，密码为明文（与 dsh-ssh 的 ~/.dsh/dsh-ssh.json 同一套信任模型）；dsh web 只监听 127.0.0.1，不暴露到局域网；127.0.0.1:<随机端口>，且自身持有远端 session cookie：访问该端口的本机进程等价于“已登录远端”，插件卸载/断开时随会话关闭；?token=）只在宿主进程内使用，从不下发到浏览器；^22.19 || >=24 与 npm；npm 默认跳过 install scripts 时，远端 DSH 的终端可能不可用（node-pty 原生模块未编译），Web UI 本身不受影响；Ctrl+C；Esc（网关注入的桥接会把远端页面里的 Esc 传回外层）；远端弹窗打开时 Esc 归弹窗使用。| 文件 | 职责 |
|---|---|
lib/index.js | 宿主入口：/api/remote-dsh/{hosts,connect,disconnect,state,test} 路由、连接任务与阶段状态 |
lib/hosts.js | 主机存储（remote-dsh.json）与 dsh-ssh.json 的读取/删除 |
lib/remote.js | 一次会话：SSH 连接 → 环境检查 → 自动安装 → 启动/复用 dsh web → 读 token → 隧道 → 网关 |
lib/gateway.js | 本机网关：cookie 换取、HTTP/WebSocket 转发、HTML 注入（Esc 桥接）、gzip 处理、401 自愈 |
lib/client.js | 浏览器半区：侧边栏入口、主机列表/表单、连接阶段轮询、iframe 内嵌、放大与 Esc |
window.__ModuleLoader__.load({ id, factory }) 包装，factory 里 require('react')，返回带 apply / inject 的 module.exports；lib/client.js 或宿主文件都需要完全退出应用再打开（客户端 bundle 带 rev，宿主在启动时加载插件）；ctx.slots.inject('sidebar.panellist', …) 与 ctx.slots.inject('main', …)。Apache-2.0