DSH Remote Runtime
English | 简体中文
在 Linux 主机上运行一套隔离的官方 DeepSeek Harness，并通过 OpenSSH 管理。 这是面向 DSH 0.1.0-rc.8 Web UI 的独立社区插件，提供远端配置、Doctor、已校验运行时安装、隧道、工作区、凭据和 Session 历史；不修改 Harness 源码。
SSH、文件、进程与秘密全部留在插件 Host 侧。浏览器只接收有界 JSON 摘要，永远不会读回已保存凭据。
真实演示
素材来自真实 OpenSSH 托管运行时，并使用了真实 DeepSeek API 凭据。Key 在录制前由 Host 导入，从未进入浏览器、截图、GIF、日志或仓库。
<p align="center"> <img src="docs/assets/readme/remote-runtime-demo.gif" alt="已连接配置、Doctor、凭据状态、工作区、真实 DeepSeek Session 与远端 Harness 界面" width="960"> </p>
<details> <summary><strong>更多截图</strong></summary>
<table> <tr> <td><img src="docs/assets/readme/connected-profile.png" alt="已连接配置"><br><sub>已连接配置与运行时</sub></td> <td><img src="docs/assets/readme/doctor-install.png" alt="Doctor 检查"><br><sub>只读 Doctor 检查</sub></td> </tr> <tr> <td><img src="docs/assets/readme/credential-configured.png" alt="已配置凭据"><br><sub>只写凭据状态</sub></td> <td><img src="docs/assets/readme/workspaces.png" alt="远端工作区"><br><sub>已保存及 Harness workspace</sub></td> </tr> <tr> <td><img src="docs/assets/readme/sessions-real-deepseek.png" alt="真实 DeepSeek 记录"><br><sub>官方 Session 历史与提示界面</sub></td> <td><img src="docs/assets/readme/remote-ui-real-deepseek.png" alt="远端 Harness 界面"><br><sub>经 loopback 隧道打开完整 DSH UI</sub></td> </tr> <tr> <td><img src="docs/assets/readme/profile-wizard-host.png" alt="Host 向导"><br><sub>Host 与隔离 workspace</sub></td> <td><img src="docs/assets/readme/profile-wizard-egress.png" alt="出网向导"><br><sub>Remote-direct 或 client-proxy</sub></td> </tr> </table>
</details>
安装
npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile web add `
@artificialnotimbecile/dsh-remote-runtime@latest
npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.8 web安装、更新或移除插件后，请重启已经运行的 Web profile。
<details> <summary><strong>从本地代码构建</strong></summary>
corepack pnpm install --frozen-lockfile --ignore-scripts
corepack pnpm run check
corepack pnpm pack --pack-destination test-results
npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile web add `
.\test-results\artificialnotimbecile-dsh-remote-runtime-0.1.2.tgz</details>
使用
打开 Settings → 远程运行时：
1. 添加 OpenSSH host 和可选远端 workspace。 2. 选择创建后不可修改的 remote-direct 或 client-proxy。 3. 运行只读 Doctor，再明确安装已校验运行时。 4. 通过只写表单导入 DeepSeek Key。 5. 启动运行时并打开 loopback 隧道地址。 6. 浏览 workspace、Session 历史，并发送或取消提示。
Disconnect 只断开连接，远端 Harness 继续运行；Stop 是独立操作。删除本地配置也不会删除远端 runtime 或 Session 数据。
主要能力
- 每个 profile UUID 拥有独立远端
DSH_HOME，隔离凭据、Session、workspace 与进程状态。 - 使用系统 OpenSSH，保留 SSH config、
IdentityFile、ssh-agent 与ProxyJump。 - 内容寻址运行时包含 Node 22.19 与官方 DSH rc.8；外层制品和每个解包文件都经过 SHA-256 校验。
- Workspace、Session、history、prompt 与 cancel 全部使用官方 DSH Host API。
- 凭据以 mode
0600写入，不返回浏览器状态、日志、快照或进程参数。 - 认证 client-proxy 只允许公网 HTTP(S)；私网、loopback、link-local、CGNAT、metadata、multicast、文档地址及 IPv6 本地范围全部 fail closed。
兼容与安全
- 本地 DSH：精确版本
0.1.0-rc.8；界面：Web profile。 - 客户端：Windows、macOS 或 Linux；Node
^22.19.0 || >=24；系统ssh。 - 远端：Linux x64、glibc 2.28+、Bash、
tar、gzip、sha256sum与可写 HOME。 - 所有隧道只监听 loopback；远端 DSH Web API 不会暴露到
0.0.0.0。 - SSH 是访问控制边界。需要隔离同 UID 进程时，请使用独立远端 OS 账号。
DeepSeek Harness 仍处于预发布阶段。只有 peer 版本、Typert 生成、组装 profile CI 和真实验收一起迁移并通过后，才会支持后续 DSH 版本。
开发
corepack pnpm run typecheck
corepack pnpm run test
corepack pnpm run build
corepack pnpm run pack:check托管运行时需在 Linux 或 WSL 中构建；执行它需要 glibc 2.28+。生成的 archive、profile、截图和 live log 位于忽略的 runtime/artifacts/ 与 test-results/。
许可证
MIT。独立社区插件，与 DeepSeek 无隶属或背书关系。第三方说明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。