dshost-plugin

DSHost 官方 DSH 远程中继插件 — 在你的 dsh（DeepSeek Harness）实例上运行一个 Agent， 通过 wss 主动外连 DSHost 中继，让你在世界任何地方用浏览器安全访问自己的 dsh Web UI， 无需公网 IP、无需端口映射。

Official remote cloud relay plugin for DSHost (dshost.me): securely access your dsh Web UI from anywhere.

特性

• 零公网 IP：Agent 主动外连中继（wss://dshost.me/agent），本机不开任何入站端口
• 零破坏性多版本兼容：同时支持 dsh 0.0.1-rc.* / 0.1.0-rc.* / 0.1.1-* / 0.1.2-*
• 安全：中继层 Host/Origin 重写遵守 dsh 信任栅栏；settings.describe 密钥脱敏下发； 生产环境强制 wss://
• 随 dsh 启动：以 cordis 插件身份随 dsh web 加载，自动重连、休眠省流

快速开始

1. 申请 Token

在 dshost.me 注册/登录（支持 GitHub OAuth），创建实例获得 dsh_ 开头的接入 Token。

2. 一键安装（推荐）

curl -fsSL https://dshost.me/install.sh | bash

脚本会安装 pnpm、通过 dsh plugin add dshost-plugin 把插件装入当前 profile， 并写入 profile 的 cordis.patch.yml。

3. 手动安装

# 装入 dsh profile（等价于在 profile 目录执行 pnpm add dshost-plugin）
dsh plugin add dshost-plugin

然后在 profile 的 cordis.patch.yml 里声明插件（新增行必须放在 - insert: 块内）：

- insert:
    - id: dsh-remote-agent
      name: 'dshost-plugin'
      config:
        token: dsh_your_token_here
        relayUrl: wss://dshost.me/agent
        autoConnect: true

4. 重启 dsh

sudo systemctl restart dsh   # 或你的启动方式

启动后控制台（dshost.me）应看到实例上线。

配置项

字段	必填	说明
token	✔	中继接入 Token（dsh_ 前缀，在 dshost.me 申请）
relayUrl	✔	中继 WebSocket 地址，生产必须 wss://
autoConnect	✕	默认 true；启动即连接
dshHost / dshPort	✕	本机 dsh web 地址，默认 127.0.0.1:3080

兼容性

dsh 版本	支持
0.1.2-*（含 --trusted-host、BrowserAuth、remote.mux）	✔
0.1.1-* / 0.1.0-rc.7+（insert 块 patch 格式）	✔
0.1.0-rc.2 ~ rc.6 / 0.0.1-rc.*	✔（旧包名 @noeljude/dsh-remote-plugin 亦可解析）

仓库结构

├── package.json         # npm 包定义（dsh.bundle.patch 指向 cordis.patch.yml）
├── cordis.patch.yml     # bundle patch（有意为空：插件入口由用户 profile 声明）
├── lib/index.js         # 插件入口（cordis apply）
├── agent/core.js        # Agent 引擎（与独立 agent 共享的唯一源）
├── common/protocol.js   # 中继协议
└── scripts/prepack.mjs  # npm pack 时物化 lib/core.js + lib/protocol.js

prepack.mjs 是布局自适应的：在本 monorepo（源码位于 src/agent、src/common）与 本仓库独立检出（agent/、common/ 位于包根）下均可运行，支持 npm i github:NoelJudeNoel/dshost-plugin 的 git 直装（经 prepare 构建）。

发布流程

npm 与 GitHub 同步发布：改动主仓源码 → bump version → npm publish → bash scripts/publish-github.sh（同步 GitHub、打 vX.Y.Z tag、刷新 topics）。 完整标准规则见 docs/github-release-sop.md。

License

MIT © 2026 dsh-remote contributors