NoelJudeNoel/dshost-plugin

dshost-plugin

npm version
license
node
GitHub

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

DSHost（dshost.me）官方远程云中继插件：安全地从任何地方访问你的
dsh Web UI。

特性

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

快速开始

1. 申请 Token

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

2. 一键安装（推荐）

macOS / Linux
curl -fsSL https://dshost.me/install.sh | RELAY_HOST=dshost.me bash
Windows (PowerShell)
$env:RELAY_HOST='dshost.me'; irm https://dshost.me/install.ps1 | iex

脚本会安装 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: dshost-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.5-（已实证 0.1.5-rc.1） / 0.1.4- / 0.1.3- | ✔ |
| 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。

许可证

MIT © 2026 dsh-remote contributors