dsh-lanbuddy-pair
dsh 扫码配对页 + 局域网网关（loopback 实例也能被手机访问）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lrxG/dsh-app#062df125cfcc2ba3c48269c626c38de3be9d2b9f
Lanbuddy Pair 以 dsh-lanbuddy-pair 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 | English
手机装上 App、电脑装上本插件，扫一次码，就能在手机上继续 PC 上的 dsh 会话。
这个仓库有两套源码，不是二选一，是配套使用的两半：
| 分支 | 是什么 | 装在哪 | 语言 |
|---|---|---|---|
main（当前页） | PC 端 dsh 插件「扫码配对」：出二维码、起局域网网关、管配对设备 | 电脑 | Node / JavaScript |
app | Android 客户端：会话、聊天、审批、通知、附件 | 手机 | Dart / Flutter |
安装包永远在 Releases，源码树里没有 APK。
装好插件并重启 dsh 后：dsh → 设置 → 扫码配对，二维码就在这里
1. 装 App（手机）
到 Releases 下载 dsh-app-release.apk（Android 8+）安装。
2. 装插件（电脑）
git clone https://github.com/lrxG/dsh-app dsh-plugin
然后 dsh → 插件 → 添加插件，粘贴 dsh-plugin 的绝对路径，按提示重启 dsh。（本包声明了 dsh.bundle，插件管理器才会接受它。）
插件管理器需要
pnpm。没装过的话，先装 Node.js LTS（一路 Next），再在 PowerShell 里执行：npm install -g pnpm关掉重开一个 PowerShell，
pnpm -v能打印版本号即可。官方说明：pnpm.io/installation。
3. 配对
token 每次启动 dsh 都会轮换，但 App 持有 30 天签名 cookie，所以重启不用重扫。
| 你要做什么 | 拿哪份 | 命令 |
|---|---|---|
| 改 PC 插件 / 自己接线 | main（本页） | git clone https://github.com/lrxG/dsh-app |
| 改 Android App / 自己编译 APK | app 分支 | git clone -b app https://github.com/lrxG/dsh-app |
package.json + lib/ + cordis.patch.yml），App 是 Flutter 工程（pubspec.yaml + lib/ + android/）。settings.section）GET /lanbuddy/pair —— 独立二维码页GET /lanbuddy/pair/qr.svg —— 二维码图片（no-store）GET /lanbuddy/pair/info —— {url, host, port, loopback, lan, gateway}POST /lanbuddy/devices/revoke —— 轮换签名密钥（所有手机重新配对）所有路由都过 ctx.connection.admit()，和 /api 同一套 Host/cookie 围栏；匿名请求一律 401。
二维码取自 ctx.connection.authenticatedUrl()，也就是 dsh 启动时打印的当前 launch token，永远是最新有效的。
dsh 只监听回环（桌面应用）时，插件绑定 <局域网IP>:3080（被占用就顺延）并把 HTTP + WebSocket 转发给本机 dsh，同时把 Host/Origin 重写为 localhost。无端口号的回环 authority 能让 cookie 在桌面重启后继续有效。
lanGateway: false 可关闭；lanHost / lanPort 可改地址端口--host：整个 dsh 面暴露到局域网，由 token/cookie 把关New-Item -ItemType Junction `
-Path "$env:USERPROFILE\.dsh\profiles\<profile>\node_modules\dsh-pair" `
-Target "D:\path\to\dsh-plugin"
# cordis.patch.yml
- insert:
- id: lanbuddy-pair
name: "dsh-lanbuddy-pair"
然后重启 dsh。
cache-control: no-storeclient-connection/browser-session 凭据（重启后生效）| 现象 | 处理 |
|---|---|
| 设置里没有「扫码配对」 | 插件没加载——看 dsh 日志，重启 |
| 手机提示连接被拒绝 | 扫到了回环地址，或网关没起来——重启 dsh |
提示 not-a-bundle | 包缺 dsh.bundle；确认用的是 main 分支 |
EADDRINUSE | 端口被另一个实例占用；网关会自动顺延 |
| 重启后要重扫吗 | 不用，cookie 30 天；只有换 IP、过期或点了「解除所有设备」才重扫 |
在插件管理器里移除，或删掉 patch 条目与 junction，然后重启 dsh。
| 会话 | 与 PC 工作区分组一致 · 归档/恢复 · 置顶 · 重命名 · 搜索 · 子任务 · 后台任务 |
| 聊天 | 流式回复 · 思考折叠 · 工具调用芯片 · 停止 · 图片/文件附件 |
| 模型 | 读取 PC 目录 · 模型 → 思考深度两级选择 · 选择写回 PC |
| 交互 | 审批弹窗 · 提问卡片（选项/多选/自由输入/跳过）· 后台完成通知 |
| 多设备 | 保存多台 PC，一键切换 |
| 更新 | App 内检查 GitHub 最新版、校验 SHA-256、调起系统安装器 |
后台通知只针对主会话：子智能体结束不会单独弹，整棵 agent 树空闲后才提醒一次；上滑清掉 App 后进程内连接断开，这段时间的通知会漏，重开 App 会补齐。
App 源码、构建方法、协议笔记都在 app 分支（docs/PROTOCOL.md）。
MIT，见 LICENSE。