前言¶
DeepSeek Harness (DSH) 提供了基于 Web 的操作界面。本地访问通常仅限于 localhost。dsh-plugin-remote-access 插件解决了这个问题，允许将 DSH 的 Web GUI 暴露给选定的 CIDR 范围（默认为 Tailscale 的 100.64.0.0/10），以便通过手机或远程机器访问。
插件概述¶
- 名称：
dsh-plugin-remote-access - 作者：Mzy123l
- 许可证：MIT
- 核心价值：在 DSH 0.2.1+ 上将本机的 DSH Web GUI 暴露给选定的 CIDR 范围（例如 Tailscale），支持可选的数字访问代码、仅适用于远程页面的手机布局、手机端资源缓存、手机端 Enter 键换行以及仅适用于远程页面的外观/字体偏好设置。配置仅存在于每个 Windows 用户的
$DSH_HOME/remote-access-config中（插件不读也不写共享 profile）；当端口忙时会自动回退到空闲端口并记住。
核心功能¶
- 网段暴露：将 DSH GUI 暴露给选定的 CIDR 范围（默认 Tailscale 100.64.0.0/10）。
- 安全监听：仅监听允许的地址；对其他地址返回 403。
- 无硬编码：网段、监听地址、端口、上游和文件路径均为可配置项，无硬编码。
- 访问方式：提供两种访问方法：复制令牌 URL 或设置数字密码（输入一次后 30 天免密）。
- 远程 UI 布局：支持移动端/桌面端/自动远程 UI 布局选项。
- 远程专用设置：UI 设置仅适用于远程页面；外观和字体大小仅影响远程页面。
- DSH 0.2.1 适配：自动读取源、系统端口和 HTTPS；适配 DSH 0.2.1+。
- 热重载：支持设置页面的热重载，无需重启 DSH。
- 配置管理：配置来源为
$DSH_HOME/remote-access-config.json（v1.5.0 起，仅限单用户文件）。 - 端口自动回退：当端口忙时会自动回退到空闲端口并记住。
安装与启用¶
- 确保你的 DSH 版本符合要求。
- 执行安装命令。
安装命令：
dsh plugin --profile desktop add dsh-plugin-remote-access
版本要求：
* DSH 0.2.1+（1.4.0+ 版本）。
* DSH 0.2.0 需要插件版本 1.3.8。
配置与访问¶
插件配置存储在 $DSH_HOME/remote-access-config 中。更改参数通过设置页面完成，保存后无需重启 DSH 即可热重载。
访问方式：
* 令牌 URL：复制并粘贴到浏览器。
* 数字密码：设置后，输入一次即可在 30 天内免密访问。
适用场景与注意¶
- 配置位置：配置仅存在于每个 Windows 用户的
$DSH_HOME/remote-access-config中。插件不读也不写共享 profile。 - 端口冲突：当端口忙时会自动回退到空闲端口并记住。
- 版本兼容性：确保 DSH 版本匹配（0.2.1+）。
