dsh-lan-peers
Verifieddsh-lan-peers · v0.8.4 · MIT · Web UI
局域网 DSH 协同:一次性配对互认、HMAC 签名 + AES-256-GCM 加密、agent 互派任务
Install
dsh plugin add dsh-lan-peers Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
局域网 DSH 协同插件 · dsh-lan-peers
让同一局域网内的多个 DeepSeek Harness (DSH) 实例互认并协同:一次性配对码建立双向密钥,之后一个 agent 可以直接把任务派给另一个 agent,并取回它的回复。
┌──────────────┐ 签名 + AES-256-GCM 加密 ┌──────────────┐
│ DSH (A) │ ───────────────────────────▶ │ DSH (B) │
│ lan_peer_ask │ POST /v1/ask │ :7788 │
│ │ ◀─────────────────────────── │ peer server │
└──────────────┘ GET /v1/answer (加密) └──────────────┘
能力
| 面 | 内容 |
|---|---|
| 模型工具 | lan_peers(列出伙伴 + 在线探测)、lan_peer_ask(给伙伴派单并取回结果) |
| 界面 | Web / 桌面窗口左下角的 🔗 伙伴 面板:改设备名、生成临时配对码、添加伙伴 |
| 认证 | 一次性 6 位配对码(10 分钟、单次),每对伙伴两把独立密钥 |
| 传输 | HMAC-SHA256 请求签名(±60s 时钟窗 + nonce 防重放),请求与响应体积用 AES-256-GCM 加密 |
| 隔离 | 默认拒绝远端派单;可配 CIDR 白名单;专用工作目录 |
环境要求
- DSH
>= 0.2.0-rc.2(已在 0.2.1-rc.2 的 Node 版与桌面版上验证) - Node.js 22 / 24(插件本身无第三方依赖,只用 Node 内置模块)
安装
1. 装包
# 从 tarball(releases 产出的 dsh-lan-peers-x.y.z.tgz)
dsh plugin --profile web add /path/to/dsh-lan-peers-0.3.0.tgz
# 或本地目录(开发时)
dsh plugin --profile web add link:/path/to/dsh-lan-peers
# 或发布 registry 之后
dsh plugin --profile web add dsh-lan-peers
这一步只把包放进 profile 的 node_modules 与 package.json。
2. 必须把插件登记为 profile bundle
最容易踩的坑:只写 cordis.patch.yml 的插件行,桌面版不会加载(网页版有时会,行为不一致)。把包名加进 profile 的 dsh.profile.bundles:
// ~/.dsh/profiles/web/package.json
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
// …
"dsh-lan-peers" // ← 加这一行
]
}
}
}
3. 配置
包自带的 cordis.patch.yml 会插入一行默认配置(端口 7788、拒绝远端派单)。要改就在 profile 的 cordis.patch.yml 里按 id 覆盖:
- id: lan-peers
name: dsh-lan-peers
config:
name: my-nas # 显示给伙伴的名字
listenPort: 7788 # 监听 0.0.0.0:<port>
stateDir: ~/.dsh/lan-peers # 身份与伙伴表位置
workspace: ~/.dsh/lan-peers/workspace # 远端派单会话的工作目录
allowRemotePrompts: false # 默认关;打开后才接受别人的派单
requireEncryption: true # 默认开;旧版本对端会被拒绝
trustedCidrs: ["192.168.1.0/24"] # 可选,限制来源网段
agentPreset: standard
各平台的参考覆盖片段在 overlays/:
overlays/web.patch.yml—— 网页版(浏览器访问)overlays/desktop.patch.yml—— 桌面版(Electron)
4. 重启 DSH
# 网页版:重启 dsh web
# 桌面版:退出并重新打开应用
重启后 http://<本机IP>:7788/v1/health 应返回 {"name":"…","capability":["ask","pair"]}。
桌面版 profile 由 Electron 独占管理,
dsh plugin --profile desktop会被拒绝。请按overlays/desktop.patch.yml手工编辑~/.dsh/profiles/desktop/{package.json,cordis.patch.yml},然后重启应用。
配对
界面:左下角 🔗 伙伴 → 「生成配对码」,把 6 位码给对方;对方在「添加伙伴」里填本机地址(如 192.168.1.10:7788)+ 码。两个方向各配一次,双方都能主动派单。
命令行:
npx dsh-lan-peers code --state-dir ~/.dsh/lan-peers
npx dsh-lan-peers pair --url http://192.168.1.10:7788 --code 123456 --name my-nas
npx dsh-lan-peers peers --probe
使用
模型侧(会话里直接说):
用 lan_peer_ask 问 my-nas:
/data/project下pwd输出什么?
命令行:
npx dsh-lan-peers ask --peer my-nas "在 /data/project 执行 pwd" --timeout 120
对端会在自己的 workspace 里建真实会话、由对端模型执行,然后把最终回复加密回传。
安全模型
- 配对码 6 位、10 分钟、一次性;每个伙伴两条独立密钥(我签给你的 / 你签给我的)。
- 每条认证请求验签:五行 canonical、±60s 时钟窗、nonce 防重放、定时安全比较。
- 报文加密:
/v1/ask、/v1/answer、/v1/peers的请求体与响应体用 AES-256-GCM 加密,密钥由该方向 HMAC 密钥经 HKDF 派生;缺X-Peer-Enc的请求返回400 encryption-required。 /v1/health公开;/v1/pair因尚无共享密钥仍是明文——只应在可信局域网内配对。- 管理接口(改名/发码/配对)只在
/api/lan-peers/*且要求 Host 为回环地址,局域网访问 403。 allowRemotePrompts默认false:装完不会自动被别人驱动。
故障排查
| 现象 | 原因 / 处理 |
|---|---|
| 装完没有 7788 监听、日志无输出 | 插件没进 dsh.profile.bundles(安装第 2 步) |
启动日志 is incompatible with dsh … |
插件 engines.dsh 高于本机运行时;升级 DSH 或改 engines |
EADDRINUSE ... :7788 |
同机跑了两个 DSH 实例;给其中一个改 listenPort |
| 面板看不到 | 注入只对 HTTP 页面生效;桌面窗口是 dsh-app://,走 lib/client.js 客户端插件,需重启应用 |
400 encryption-required |
对端是加密前的旧版本,两端都升级 |
401 bad-signature / clock-skew / replay |
两端时钟偏差超过 60s、密钥不一致,或 nonce 重放 |
开发
node --test host/test/auth.test.mjs host/test/api.test.mjs # 协议/端点
node --test lib/wire-crypto.test.mjs # 加密
node host/server.mjs --port 7799 --state-dir /tmp/lp # 独立 host(内存 runner)
许可
MIT