dsh-mesh
Discovered★ 19dsh-mesh:把你自己多台电脑/手机上的 DSH 连成一个 AI 网络——局域网优先、跨机文件传输、AI 互相委托(Windows 优先,Early 0.x)。 | LAN-first multi-node AI network for DeepSeek Harness: cross-machine file transfer and agent-to-agent delegation.
dsh-mesh
把你自己几台电脑(和手机)上的 DSH 连成一个 AI 网络:互相看见、互相读文件、互相派任务。
A multi-node AI network for DeepSeek Harness: turn your PCs and phones into one mesh where agents can see each other, transfer files, and delegate work across devices.
状态:早期版本(0.x preview)。能日常使用,但接口和配置格式还会变。适合愿意自己动手的开发者;不适合对稳定性/商业支持有要求的人。请先看 适合谁 / 不适合谁。

「AI 网络」左侧栏页面:拓扑、链路类型(局域网/公网/内网穿透)、节点健康、通道地址与离线状态。公网 IP/域名默认隐藏,可在页头手动显示。
目录
- 它解决什么问题
- 用上之后可以做到什么(包括但不限于)
- 适合谁 / 不适合谁
- 安装前需要准备什么
- 安装
- 5 分钟上手(两台机器)
- 界面里有什么
- 架构
- 安全与隐私
- 已知限制
- 让 AI 自己安装
- 文档
- English TL;DR
- Contributing
- License
它解决什么问题
多台电脑各装一个 DSH,但它们互相看不见:公司机上的 AI 不知道你家里那台的文件,你也没法让它把任务交给另一台机器跑。
dsh-mesh 让每台装了 DSH 的设备成为网络里的一个对等节点:
- 互相看得见:一个侧栏页面看到所有节点、链路类型、延迟、版本、实例状态
- 跨机读/传文件:让 AI 从对端读文件,或走 mesh 文件传输(分块 + 大小/哈希校验)
- AI 之间互相派任务:委托协议(任务信封 + 状态机 + 结果落盘),不是靠人转发
- 局域网优先:同一网段直接连;跨公网时用你自己的 frp/樱花/Tailscale,不经过任何第三方云
核心不是"远程控制",而是AI 之间互相调用:你负责配对一次和看状态,搬运交给它们。
用上之后可以做到什么(包括但不限于)
下面是我自己每天在用的工作流,不是演示。它们都建立在同一件事上:AI 之间能互相委托。
1. 让 DSH 维护 DSH(双开互改)
同一台机器双开两个 DSH,一个改代码/装插件,另一个验证、回滚;两边通过 mesh 互相调用,形成"AI 改 AI、AI 验 AI"的闭环。
严格说,这一步不用插件、靠人在两个窗口之间传话也能做;但有 mesh 之后人可以彻底退出这条链路:升级、重启、验证、回滚都交给 DSH 自己,人只做最后验收。
2. 多设备仓库同步,把"漂移"在发生前消掉
公司电脑和家里电脑往往有同一批仓库:谁先提交、谁落后、冲突怎么解,过去靠人比对。
现在可以让两端的 DSH 互相委托:一端说"把对端仓库拉到最新、有冲突就按约定解决并推送",另一端的 DSH 在本地执行、发起端验收。仓库漂移、版本不一致、忘记 pull 这类问题在发生前就被处理掉。
一个我每天在用的实际场景:公司 DSH 设一个"下班后"的定时任务,自动同步并推送代码到线上(GitHub),同时委托家里的 DSH 拉取、同步到最新;"上班前"家里 DSH 反向执行,推送后委托公司 DSH 同步。以前用 GitHub + 计划任务也能做定时 push/pull,但冲突和合并还得人来处理;现在 DSH 已经知道我的开发偏好和习惯,只要大方向不变,它基本能自己解决冲突、完成合并。
3. 插件 / DSH 升级:一处发现,全网委托
看到好用的插件或新版本,不用每台机器手动装:在任意一台发起委托,让其他设备的 DSH 自己安装、升级、验证。
让 DSH 写自己的升级提示词,通常比人手写更细——它知道自己的版本、配置和踩过的坑;而且 DeepSeek 的缓存机制下,多台设备做同样的事缓存命中率很高,成本比想象低。
4. 手机就是控制台
手机上的 dsh-go 配合 Shizuku 之类提权、樱花穿透/自建隧道和各项权限后,出门只带手机也能随时发起委托,例如:
"把插件 XX 装到所有设备,并同步配置。"
人在外面,网络里的 DSH 照样干活;回到电脑前只需要验收结果。
前提:设备已配对、ACL 允许对应工具、隧道/局域网可达。它不是"无人值守魔法"——网络断了、权限没开、对端 DSH 挂了也会失败;好在失败会留下状态和日志,便于定位。
适合谁 / 不适合谁
✅ 适合
- 有 2 台以上自己长期开机的电脑/手机,都跑 DSH
- 愿意用命令行装插件、配端口/防火墙,或愿意用 frp / 樱花 / Tailscale 打通网络
- 想让 AI 跨机器读文件、传文件、派任务
- 能接受早期软件:偶尔要人肉排障、看日志、提 issue
❌ 不适合
- 只有 1 台电脑、也不打算加第二台(装了只能看到自己)
- 完全不想碰命令行(现阶段没有一键安装器)
- 机器在不可信网络(公司公共网、合租、咖啡厅)又不愿配置配对码 + ACL
- 需要商业 SLA / 安全认证
- 想要通用"远程桌面 / SSH 替代品"(桌面直控是可选能力且默认关闭,不是它的定位)
- 主力 macOS / Linux / 手机(Windows 10/11 验证最充分,其他平台能跑但别指望零坑)
- 介意"DSH 插件是 in-process JS,权限等于你的用户权限"(所有插件都是这个模型)
安装前需要准备什么
每台机器
- 系统:Windows 10/11 x64(主力);macOS / Linux 可跑服务端与桥,但自启等部分功能未验证
- DSH:
0.2.2-rc.1(兼容0.2.0-rc.2~0.2.x;多台机器尽量同版本) - Node:
22.19+或24+(DSH 自带运行时) - 权限:管理员权限(装插件、防火墙、开机自启)
- 磁盘/内存占用很小(1–2 GB 足够)
网络(二选一或都配)
- 同一局域网(最简单):两台机器能互访
8124/tcp - 跨网络:每台机器需要一个公网 TCP 入口,常见做法:
- 自建 frps(作者用法,见 docs/SELF-HOST-RELAY.md)
- 樱花内网穿透(SakuraFrp)
- Cloudflare Tunnel / Tailscale 等,原理相同:把
127.0.0.1:8124映射出去
端口
| 端口 | 用途 |
|---|---|
8124/tcp | mesh 服务(节点间通信;需要时绑 0.0.0.0) |
9100 / 9101 / 9102 | 各 DSH 实例宿主桥(只监听 127.0.0.1,不用对外开放) |
8129/udp | 局域网发现(可选;被拦就手动填 IP) |
7000+(示例) | 你自己的 frp 公网端口 |
安装
一条命令装齐(推荐):UI 页面 + mesh 服务端 + 宿主桥 + 自启守护
dsh plugin --profile web add @linyanzhi/dsh-mesh
装完 重启这个 DSH 实例(只刷新页面不生效),左侧栏会出现 AI 网络。
也提供分包安装(进阶/旧方式):
| 包 | 作用 |
|---|---|
@linyanzhi/dsh-mesh | 一条命令装齐(推荐) |
dsh-mesh-ui | 「AI 网络」侧栏页 |
dsh-mesh-host | DSH 宿主桥(每个实例一个,loopback) |
dsh-mesh-node | mesh 服务端 / 节点传输 |
dsh-mesh-autostart | 引擎重启后保持 mesh 服务存活 |
5 分钟上手(两台机器)
1. 两台都装
dsh plugin --profile web add @linyanzhi/dsh-mesh
分别重启各自的 DSH 实例。
2. 确认入口
左侧栏出现 AI 网络。点开能看到本机实例、对端节点、右侧面板(局域网连接/公网连接/内网穿透/节点管理/文件传输/委托台账/告警/诊断)。
3. 被访问端生成配对码
「AI 网络」→「局域网连接」→ 生成我的配对码,得到一次性配对码(默认 10 分钟有效)。
跨网络时,先把监听地址改成 0.0.0.0:8124,再用 frp/隧道映射出 域名:端口。
4. 另一台配对
「AI 网络」→「局域网连接」:
- 点 扫描局域网 找到对方 → 填配对码 → 用此节点配对
- 或手动填
https://IP:8124+ 配对码
配对成功后拓扑里出现对端,token 存在各自 ~/.dsh-mesh/(不进 git、不上传)。
5. 验证
对 AI 说「看一下 AI 网络状态,列出所有节点」;或命令行:
dsh-mesh host status # 宿主桥是否在 DSH 内存活
dsh-mesh cluster status # 本机 + 已配对节点的实例/延迟
如果你是从源码仓库(
dsh-mesh开发仓)运行,还能用node scripts/mesh-health.mjs --fast等脚本。
更多细节见 docs/INSTALL.md 和 docs/QUICKSTART.md。
界面里有什么
「AI 网络」页面(独立侧栏页,不再挤在设置里):
- 拓扑图:本机居中,其它设备扇形排开;连线 = 通道
- 通道类型:局域网(绿实线)/ 公网(蓝虚线)/ 内网穿透如樱花(紫虚线);离线通道变红
- 悬浮设备卡:每条通道的地址与状态,断开的标红「离线」
- 右侧面板:局域网连接(扫描/配对)、公网连接、内网穿透、节点管理、文件传输(本机/全网记录)、委托台账、告警历史、诊断建议、权限设置
- 隐私:公网 IP/域名默认显示「公网地址已隐藏」,页头开关可展开并记忆
- 多实例:一个 DSH 实例一个宿主桥(9100+),面板里逐实例展示
架构
+------------------------------+
| Relay(可选,自建 frps) |
+--------------+---------------+
TLS + per-peer token |
+---------------+--------+------+--------+---------------+
| | | | |
+--+---+ +---+--+ +--+---+ +---+--+ +----+----+
| PC 1 |<----->| PC 2 | | PC 3 |<----->| PC 4 |<----->| Phone |
| DSH | | DSH | | DSH | | DSH | | dsh-go |
+------+ +------+ +------+ +------+ +---------+
每个节点 = DSH 引擎 + mesh server + host bridge(+ 可选桌面 helper)
- mesh server:每节点一个 MCP-over-HTTPS 服务,把本机能力暴露给 peer
- host bridge:DSH 宿主插件,让 mesh server 能创建会话、发消息、调用本机工具
- relay:可选;同局域网不需要。跨 NAT 时用自建 frps/隧道
- 桌面直控(可选,默认关闭):
pc_action/pc_app/pc_window/pc_browser
安全与隐私
- 发现不等于连接:局域网扫描只列节点;建立连接必须一方生成一次性配对码、另一方兑换
- 节点间 TLS(自签证书 + 指纹固定),每个 peer 独立 token(服务端只存哈希),可随时撤销
- 默认 ACL:允许读/检索/写对端
~/Code、读会话历史与日志、委托任务;shell_run、频道消息、远程桌面、修复类操作默认关闭 /api/dsh-mesh/*只接受本机回环请求- 没有云端:数据只在你自己的机器和你的隧道之间
- 桌面直控默认关闭,需要显式开启;不建议在不可信网络裸奔
- 详细安全模型与风险:SECURITY.md · 权限说明:docs/ARCHITECTURE.md
- 只读安全自检(不联网、不改配置):
node tools/security-audit.mjs
已知限制
- 0.x 早期:接口、配置格式可能变化,升级前看 CHANGELOG.md
- Windows 优先:开机自启、远程重启等只做了 Windows
- 手机节点:Android + proot 可跑,属实验性;樱花客户端需自己保证常驻
- 版本一致:多台机器建议锁同版本 DSH + 插件;不一致时部分工具不可用
- 需要动手:端口、防火墙、frp、证书、重启都可能要你亲自处理
- 不是通用远程桌面/SSH 替代品;桌面控制是可选能力且默认关闭
- 没有多用户/团队权限:这是给一个人自己的几台机器用的
让 AI 自己安装
把这段发给你的 DSH AI(也就是「模板 1」,更多模板见 docs/AI-PROMPTS.md):
请帮我安装 dsh-mesh,按下面的文档与检查单执行:
- https://github.com/LinYanZhi/dsh-mesh/blob/main/docs/AI-CHECKLIST.md
- https://github.com/LinYanZhi/dsh-mesh/blob/main/docs/INSTALL-FOR-AGENTS.md
0) 先做只读检查:node tools/ai-install.mjs --json(本机没有仓库就从 GitHub 下载这个脚本)
1) 确认 Node >= 22.19、dsh >= 0.2.0-rc.2,找到我正在用的 DSH profile(web/desktop)
2) 安装 @linyanzhi/dsh-mesh,并验证包已落地、profile patch 有条目
3) 装完停下来告诉我重启 DSH;等我重启后再确认左侧栏「AI 网络」可见
4) 不要自动重启、不要 kill 进程、不要开启远程桌面控制;需要 UAC/管理员时停下
5) 每一步报验证结果;同一步失败两次就停下报告原文
文档
| 想知道什么 | 去哪 |
|---|---|
| 一步步安装(给人看) | docs/INSTALL.md |
| 最短快速开始 | docs/QUICKSTART.md |
| 让 AI 自己装 | docs/INSTALL-FOR-AGENTS.md |
| AI 一页检查单 | docs/AI-CHECKLIST.md |
| 复制给 AI 的提示词模板 | docs/AI-PROMPTS.md |
| AI 友好的安装/验机脚本 | node tools/ai-install.mjs --json |
| 出问题怎么查 | docs/TROUBLESHOOTING.zh.md |
| 架构 / 权限 / 组件 | docs/ARCHITECTURE.md |
| 开发历程(为什么这样设计) | docs/HISTORY.md |
| 公网中继(自建 frps) | docs/SELF-HOST-RELAY.md |
| 安全模型 / 风险 | SECURITY.md |
| 安全自检脚本(只读) | node tools/security-audit.mjs(源码见 tools/security-audit.mjs) |
| 版本变更 | CHANGELOG.md |
| 发布流程(Trusted Publishing) | docs/RELEASE.md |
| 参与开发 | CONTRIBUTING.md · AGENTS.md |
本仓库用于发布说明、安装文档与 AI 安装指南;实际代码以 npm 包形式发布(
@linyanzhi/dsh-mesh等)。
English TL;DR
dsh-mesh connects your own DSH instances (PCs and phones) into one AI network: sidebar topology with link types, cross-machine file transfer, and task delegation between agents. LAN-first; bring your own relay (frp/Sakura/Tailscale) only when crossing networks. No cloud relay, no accounts.
Requires Windows 10/11 (primary), DSH 0.2.2-rc.1 (compatible 0.2.0-rc.2–0.2.x), reachable TCP 8124, admin rights. Early 0.x preview; not a general remote-desktop/SSH replacement; desktop-control tools are opt-in and off by default.
dsh plugin --profile web add @linyanzhi/dsh-mesh
# restart DSH, then open "AI 网络" in the left sidebar
Contributing
See CONTRIBUTING.md. 中文 / English both welcome.
License
MIT — see LICENSE.
Comments
Loading…
Similar plugins
by peng456
Discovers other DSH instances on the local network by UDP multicast or port scan, lists them in a sidebar panel together with the capabilities each one reports, and dispatches tasks between machines i
★ 8
↓ 816/wk
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-plugin-meshby FxRayHughes
Link DeepSeek Harness (DSH) instances on the LAN: delegate subagents to another machine's DSH, continue its sessions, with signed auto-discovery and a visual settings page
★ 0
NOASSERTION
JavaScript
Oct 23, 2026
dsh plugin --profile web add @local/dsh-peer-linkby liaosiliangCodeLife
Connects the DeepSeek Harness agent running on your own computer to the HarnessMate platform, so you can chat with it, exchange files and approve its tool calls from a phone or a browser.
★ 0
MIT
JavaScript
Oct 29, 2026
dsh plugin --profile web add harness-mateby Nono-neko
An AI-native browser workspace for DeepSeek Harness (DSH), combining multi-tab browsing, live page annotations, lightweight code editing, workspace previews, and Agent-assisted iteration across Web an
★ 14
↓ 564/wk
Apache-2.0
TypeScript
Oct 30, 2026
dsh plugin --profile web add @nono-neko/dsh-browserby Leon0555
一个DSH局域网内访问插件:让 DeepSeek Harness 可在局域网内被其他设备访问的 DSH 插件。同一局域网下,手机/平板/电脑打开浏览器即可直接访问你某台设备上的 DSH——无需 SSH、无需内网穿透,npm 一键安装。
★ 13
↓ 472/wk
MIT
JavaScript
Nov 2, 2026
dsh plugin --profile web add dsh-lan-accessby winlin926
把电脑上的 DeepSeek Harness 会话漫游到手机:浏览器扫码即用,AI-HUB App 共用同一地址和配对码。
★ 1
MIT
TypeScript
Oct 24, 2026
dsh plugin --profile web add dsh-roam