前言¶
DeepSeek Harness（DSH）在 dsh web 模式下会在本机跑一套带聊天、终端、文件和设置的 Web 界面。开发或排障时，常见需求是离开工位后仍能操作同一套环境；自行搭反向代理或开端口，往往还要维护证书和访问控制。
下面介绍社区插件 @uumit-ai/dsh-uumit-remote：在 DSH 进程内接入 UUMit 隧道，无需再装桌面客户端，即可通过 UUMit 分配的应用 URL 远程使用与本机相同的 DSH。插件由 uumit-ai 维护，在 GitHub 上开源（MIT），当前为 Beta 预览版（npm beta 标签）。
这是什么¶
@uumit-ai/dsh-uumit-remote 是面向 DSH Web 的远程访问插件。它在 DSH 进程内运行，直接连 UUMit 隧道，不下载或启动其他程序，也不在电脑上额外开端口。
连接成功后，你（以及你授权的人）在浏览器打开类似 https://dsh--<your-computer>.<UUMit 地址域名>/ 的地址，得到的界面与本机 DSH 一致：会话、终端、文件和设置可用，设置会写回这台电脑。
环境与前提¶
资料中的要求如下：
- 使用
dsh web；DeepSeek Harness 0.2.1-rc.2 或更高。DSH 桌面应用不内置 Web 服务，不支持本插件。 - Node.js 22.19 或更高（与 DSH 一致）。
- 需要 UUMit 账号。
插件界面目前为简体中文；侧栏入口为「远程访问」（收起侧栏时为地球图标）。
安装与启用¶
在 Web 配置档下安装（命令来自官方 README）：
dsh plugin --profile web add @uumit-ai/dsh-uumit-remote@beta
安装后重启 dsh web。
DSH 通过 pnpm 安装插件，默认会跳过过去 24 小时内发布的版本。新版本刚发布时，@beta 可能仍指向上一版；若要立刻装指定版本，可写明版本号，例如：
dsh plugin --profile web add @uumit-ai/dsh-uumit-remote@0.1.0-beta.3
若使用 npmmirror 等镜像且提示找不到匹配版本，可从官方 registry 安装：
dsh plugin --profile web add @uumit-ai/dsh-uumit-remote@beta --registry=https://registry.npmjs.org/
卸载：
dsh plugin --profile web remove @uumit-ai/dsh-uumit-remote
插件为纯 JavaScript，无运行时依赖、无构建步骤。
典型用法¶
- 在本机打开 DSH，点击侧栏底部设置按钮旁的 远程访问。面板在 DSH 页面内打开，不弹新窗口。若入口未出现，可访问
<dsh web 地址>/uumit-remote/作为备用页。 - 点击 连接到 UUMit，在打开的页面登录 UUMit，核对面板中的 连接码 与页面一致后确认。若确认页未打开，可在 UUMit 网站生成 8 位配对码，在面板中手动输入。
- 连接成功后，DSH 会以应用名
dsh出现在你的 UUMit 地址下。在 谁能用 中选择：
- 仅自己：仅你已登录 UUMit 的账号；
- 我和我邀请的人：邀请链接或手机号授权，可随时撤销；
- 所有人：持有 URL 的匿名访问者可以以你的身份完整操作 DSH，面板会要求确认；
- 关闭。 - 在任意设备浏览器打开面板中的 应用网址。
- 不再需要远程时，点击 断开这台电脑，该电脑会从 UUMit 设备列表移除。
DSH Agent 也可协助：插件注册了工具 uumit_remote_access（查看状态、开始连接、说明管理入口）。Agent 不能修改「谁能用」策略。
配置项¶
可在配置档的 cordis.patch.yml 中通过 id: uumit-remote 覆盖整条配置（省略项会恢复默认）。
| 选项 | 默认值 | 说明 |
|---|---|---|
apiBase |
https://api.uumit.com |
平台 API；环境变量 UUMIT_API_BASE 优先。非 HTTPS 仅允许回环与私网地址 |
serviceName |
dsh |
注册到 UUMit 的应用名 |
deviceName |
<hostname> · DSH |
UUMit 上显示的设备名；也可用 UUMIT_DEVICE_NAME |
autoConnect |
true |
DSH 启动时若已配对则自动上线；不会单独发起配对 |
home |
$DSH_HOME/uumit-remote |
本地状态目录 |
测试用环境变量：UUMIT_TUNNEL_INSECURE_TLS=1 跳过隧道节点证书校验；UUMIT_TUNNEL_CA_FILE 指定节点 CA；UUMIT_WEB_BASE 指定网站基址。
安全与权限说明¶
- 访问控制由 UUMit 网关决定；插件对每条请求按相同规则二次校验，拒绝缺失或非法请求。
- 远程浏览器不会拿到 DSH 自身的登录凭据；插件在本地交换内部凭据，仅保存在内存中，并附加到转发给 DSH 的请求。撤销授权后，对方下一次请求会被拒绝。
- 管理面板只接受本机已打开 DSH 的浏览器；经 UUMit 打开的远程页面无法访问该面板。
- 设备凭据存放在
$DSH_HOME/uumit-remote/credentials.json，仅本用户可读，不会出现在日志或页面中。 - 远程访客通过页内浏览器选目录，不会在你屏幕上弹出系统文件对话框；会在本机打开文件或应用的能力对远程访客隐藏。
- 选择 所有人 意味着匿名访客可以以你的身份使用终端和文件，仅在充分理解风险时使用。
安全问题请通过 GitHub Security Advisory 私下报告，勿公开 Issue。
适用场景与注意¶
适合需要在手机、平板或其他电脑上继续用同一台机器上的 dsh web 的开发者：配对、邀请与「谁能用」由 UUMit 与面板统一管理，不必自建穿透服务。
使用前请注意：
- 插件以当前 DSH 进程的用户权限运行；安装前建议阅读源码与 MIT 许可证。
- 当前为 Beta（
0.1.0-beta.3等），行为与配置可能在 1.0 前调整。 - 仅支持
dsh web，不支持 DSH 桌面版作为 Web 服务端。
DeepSeek Harness 生态强调「一切皆插件」；社区目录站点与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区插件，非官方应用商店条目。
