DeepSeek HarnessHub
提交插件

AKHYui/DSH-Remote-plugin ↗★ 0

dsh-remote-bridge

提供外发桥接中继，允许移动端应用控制桌面端 适合需要通过手机等移动设备远程连接并操控本地桌面端会话的用户。

界面扩展服务集成效率工具
包名
dsh-remote-bridge
兼容性
待验证
版本
0.1.0
许可证
MIT
最近更新
2026年10月4日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:AKHYui/DSH-Remote-plugin

说明文档

阅读完整 README ↗

3. 写配置

向 ~/.dsh/profiles/desktop/cordis.patch.yml 追加（键名与 src/config.js 的 DEFAULT_CONFIG 一致）：

- id: remote-bridge
  name: dsh-remote-bridge
  config:
    serverUrl: 'wss://relay.example.com:58443/api/v1/attach'
    connectorToken: ''
    deviceId: 'home-pc'
    deviceName: 'home-pc'
    tlsCaFile: '/etc/dsh-remote-bridge/ca.crt'
    autoConnect: true
    reconnect: true
    heartbeatMs: 30000
    approvalTimeoutMs: 90000
    allowedSessions: []
    hideArchivedSessions: true
    allowInsecure: false
    logLevel: info
    debugLog: '/tmp/dsh-remote-bridge.log'
  • serverUrl 必须是中继的 attach 端点；写成 https:// 或 http:// 会被自动改写为 wss:// / ws://。
  • tlsCaFile 指向签发中继证书的 CA（PEM），放在 DSH 进程可读的位置；插件在拨号前会把它并入进程信任库。
  • connectorToken 是密钥：也可以不写进文件，改用环境变量 DSH_REMOTE_BRIDGE_TOKEN（环境变量优先于此项）。
  • 任何键都可以用对应的 DSH_REMOTE_BRIDGE_* 环境变量覆盖，见下方「配置」。
  • debugLog 指向一个 DSH 进程可写的文件，插件才会写诊断日志；写入失败会被静默忽略。

Windows: 路径写 Windows 形式，例如 tlsCaFile: 'D:\dsh-remote-bridge\certs\ca.crt'（单引号内反斜杠是字面量）。

配置

profile patch 的 config: 与同名环境变量可二选一或并用（环境变量优先）。

键环境变量默认说明
serverUrlDSH_REMOTE_BRIDGE_SERVER_URL空必填。中继 attach 地址，wss://:/api/v1/attach
connectorTokenDSH_REMOTE_BRIDGE_TOKEN空必填。中继签发的连接器令牌（密钥）。推荐用环境变量
deviceIdDSH_REMOTE_BRIDGE_DEVICE_ID空必填。这台机器的稳定标识，手机用它寻址；同一中继上必须唯一
deviceNameDSH_REMOTE_BRIDGE_DEVICE_NAMEdeviceId展示名
autoConnectDSH_REMOTE_BRIDGE_AUTO_CONNECTtrue加载后是否立即拨号；false 时插件已装载但不发任何流量
reconnectDSH_REMOTE_BRIDGE_RECONNECTtrue断线后是否重连（指数退避：1s 起、×2、上限 30s、±20% 抖动）
reconnectOnReplaced无false被同 deviceId 的新连接接管（闭码 4001）后是否抢回
heartbeatMsDSH_REMOTE_BRIDGE_HEARTBEAT_MS30000保活间隔；最小 5000
approvalTimeoutMsDSH_REMOTE_BRIDGE_APPROVAL_TIMEOUT_MS90000等手机作答的上限，超时后回落桌面应答器；最小 1000
allowedSessionsDSH_REMOTE_BRIDGE_ALLOWED_SESSIONS[]会话白名单（数组，或逗号分隔字符串）。空 = 全部放行；同时作用于 op 目标与审批 / 提问的转发
hideArchivedSessionsDSH_REMOTE_BRIDGE_HIDE_ARCHIVED_SESSIONStrue把已归档会话从 session.list 里剔掉；设 false 可重新列出
allowInsecureDSH_REMOTE_BRIDGE_ALLOW_INSECUREfalse允许 ws://。仅本地开发：令牌会明文传输，启动时打印一条 WARNING
tlsCaFileDSH_REMOTE_BRIDGE_TLS_CA_FILE空签发中继证书的 CA（PEM 文件路径）
logLevelDSH_REMOTE_BRIDGE_LOG_LEVELinfodebug / info / warn / error / silent
debugLogDSH_REMOTE_BRIDGE_DEBUG_LOG空（关）诊断日志文件路径；默认关

布尔键接受 1/true/yes/on 与 0/false/no/off（大小写不敏感）；allowedSessions 接受数组或逗号分隔字符串； heartbeatMs、approvalTimeoutMs 低于下限会被拒绝启动。