Xraytest/exneo-useful-dsh-workshop--plugins-dsh-device-mesh ↗★ 0
dsh-device-mesh
设备网格:把装了本插件的其它 DSH 接入当前设备(令牌 + 每请求签名),会话按「设备 → 工作区 → 会话」三级汇总;支持工作区多工作路径与跨设备执行命令。
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add 'github:Xraytest/exneo-useful-dsh-workshop#00eac4b561264144529fef6704283cd044bdccae&path:plugins/dsh-device-mesh'說明文件
閱讀完整 README ↗9. 配置
写在 profile patch 的那一行 config 里,可运行期改的项在 UI「配置」页也能改。
| 键 | 缺省 | 说明 |
|---|---|---|
deviceName | '' | 设备显示名;空 = 用 identity.json 里的名字(首次取 os.hostname()) |
workspaceRoles | {} | 按工作区声明角色:{ [路径]: { owner, session, mesh } }。owner = 属主/执行侧(文件与命令真正跑在那台),session = 会话侧(在那台驱动会话),mesh = 是否作为互联会话(缺省 false = 纯本地,一律本机落地)。语义与判定表见 §4.1;界面标识与路由共用 mesh 这一个开关 |
allowInbound | true | 是否接受其它设备接入 |
requireToken | true | 入站是否必须带令牌 + 签名 |
allowRemoteExec | false | 跨设备执行总开关 |
execTrust | 'grant-required' | 谁可以执行:grant-required | any-authenticated |
exportRoots | [] | 额外导出的绝对路径 |
exportWorkspacePaths | true | 自动把本机工作区路径加进导出根 |
execTimeoutMs | 120000 | 单条命令最大时长(调用方只能要更短) |
execCommandLimit | 32768 | 单条命令正文的字符上限 |
listLimit | 500 | 目录列举的条目上限 |
requestSkewMs | 300000 | 签名时间戳允许的偏差 |
replayCacheMax | 8192 | nonce 防重放缓存容量 |
execOutputLimitBytes | 262144 | stdout / stderr 各自上限 |
execMaxConcurrent | 4 | 并发执行数上限 |
execAudit | true | 审计是否落盘(关掉只留内存最近 200 条) |
inventoryTtlMs | 5000(本 profile 配 20000) | 清单快照 TTL;实际决定后台刷新频率 |
pushIntervalMs / heartbeatMs | 30000 / 20000 | 推送与心跳间隔 |
mirrorIntervalMs | 60000 | 拉一跳总览的间隔 |
titleFoldBudget / titleFoldBudgetMs | 40 / 2500 | 标题日志折叠的条数与时间预算 |
maxSessionsPerWorkspace | 500 | 单工作区列出上限(超出截断并标注) |
maxDevices | 64 | 接入设备数上限 |
includeSubagents / includeArchived | true / false | 清单是否含子代理 / 已归档会话 |
nodeStaleMs / nodeOfflineMs | 90000 / 600000 | 活跃度阈值 |
authFailMax / authFailWindowMs | 40 / 60000 | 认证失败限流 |
storeDir | '' | 数据目录;空 = $DSH_HOME/device-mesh |
数据目录
$DSH_HOME/device-mesh/
identity.json 设备身份(deviceId 稳定;改名不会换 id)
tokens.json 入站令牌(**含明文 secret**,0600)
links.json 出站接入点(**含明文 secret**,0600)
nodes.json 已接入节点 + 它们上报的清单快照
workspace-paths.json 工作区附加路径账目
exec-audit.jsonl 执行审计(追加式,超 8 MB 轮转 .1)
全部 0600 / 目录 0700,原子写(同目录临时文件 + fsync + rename)。
读失败不猜不删:保留原文件、回落默认值、把原因写进 /status 的 problems。
secret 为什么是明文:HMAC 是对称的,验签方必须持有密钥本身,只存哈希就退化成 「明文 token 比对」了(失去防重放)。要「接入点也不知道密钥」得换成非对称签名, 那是另一个协议版本。
判据(运行时证据优先,配置声明兜底)
| # | 来源 | 含义 | 强度 |
|---|---|---|---|
| 1 | 会话镜像索引 session-replica/index.json | 该工作区的会话历史被推到了本机 | 硬:只有转发执行的会话才会被镜像(§12.6) |
| 2 | 入站执行审计 exec-audit.jsonl(direction=in) | 远端真的把命令发到本机跑过 | 最强:不是「可能」,是「已经发生」。inboundExec 含非零退出/超时/取消(跑失败同样是既成事实),被四道门拒绝的另计 inboundDenied |
| 3 | 对端清单里的 localMatch | 对端报了同一个工作区(同 id 或同路径) | 说明对端也在用这个工作区,单独不足以定方向 |
| 4 | config.workspaceRoles[path] = {owner, session, mesh} | 人工声明的角色 | 声明,不随运行时变化;对端离线时仍然有效。mesh 是标识与路由共用的开关(见 §4.1):没声明 mesh 的工作区是纯本地,不标 |
方向由「会话侧是不是本机」决定:会话侧 = 本机 → 本机在跑 agent(命令可能发到别处),
不标;会话侧 = 远端 → 会话在远端执行、命令会到属主侧,执行端要标的就是它。
再与 mesh 取交集:remote = mesh && 会话侧不是本机,所以「界面标了远端执行」
与「命令真的会发到属主」永远一致(§4.1)。