使用前准备

两台电脑均已安装并能正常打开 DeepSeek Harness 的 Web 界面或桌面客户端。
两台电脑网络可达，主机中继端口可访问。
插件提供可直接加载的 JavaScript，无需自行编译。
插件使用 DSH 的 Web 服务与客户端扩展接口，目前未声明最低兼容版本；旧版宿主遇到加载问题时，请先更新并检查实际使用的 profile。

配置参考

日常配对、角色切换、共享开关、本机名称和本机 / 远程切换可在设置页完成。高级配置由宿主的插件配置提供。

状态文件位于 $DSH_HOME/dsh-remote-desktop.json；未设置 DSH_HOME 时使用 ~/.dsh/dsh-remote-desktop.json。

配置项	默认值	说明
`role`	`""`	自动选择；也可设为 `host`、`client` 或 `off`
`host`	`""`	从机连接的主机地址
`token`	自动生成	配对令牌，两端需一致
`name`	系统主机名	本机显示名称
`bind` / `port`	`0.0.0.0` / `9527`	主机中继监听地址与端口
`share`	见下文	主机共享开关
`localPort`	`9528`	从机本地代理端口，仅监听 `127.0.0.1`
`autoOpen`	`true`	从机自动进入远程界面
`mode`	`""`	跟随保存的模式；可显式设为 `remote` 或 `local`
`advertise`	`""`	展示的主机对外地址
`allow`	`[]`	来源 IP 白名单；为空时仍需令牌
`tlsCert` / `tlsKey`	`""`	主机 HTTPS 证书与私钥路径
`caFile`	`""`	从机使用的自定义 CA 证书路径
`insecure`	`false`	从机是否跳过 TLS 证书校验，仅供调试
`dshPort`	自动探测	主机本地 DSH Web 端口，探测失败时可指定
`secret`	自动读取	高级选项：主机 browser-session 密钥
`stateFile`	默认状态文件	自定义状态文件路径

持久化与优先级： 设置页保存的地址、令牌、角色等优先于配置初始值；role: off 始终停用插件，显式 mode 优先于保存的模式。全新状态且未显式设置 role / share 时共享关闭；已有状态或显式配置角色时，请同时检查 share，其配置默认值为 true。

高级配置示例（调整已有插件行的 config，不要重复插入）：

- id: dsh-remote-desktop
  name: '@local/dsh-remote-desktop'
  config:
    role: host
    share: false
    bind: 0.0.0.0
    port: 9527
    advertise: https://dsh.example.com

@local/dsh-remote-desktop

Install

README

使用前准备

配置参考