Skip to content

dsh-lan-peers

Verified

dsh-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