Xraytest/exneo-useful-dsh-workshop--plugins-dsh-device-mesh ↗★ 0

dsh-device-mesh

设备网格:把装了本插件的其它 DSH 接入当前设备(令牌 + 每请求签名),会话按「设备 → 工作区 → 会话」三级汇总;支持工作区多工作路径与跨设备执行命令。

Package
dsh-device-mesh
Compatibility
Unverified
Harness peer range
^0.2.0-rc.1
Cordis peer range
^4.0.1
Version
1.0.0
License
MIT
Last updated
Nov 12, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add 'github:Xraytest/exneo-useful-dsh-workshop#00eac4b561264144529fef6704283cd044bdccae&path:plugins/dsh-device-mesh'

9. 配置

写在 profile patch 的那一行 config 里,可运行期改的项在 UI「配置」页也能改。

键缺省说明
deviceName''设备显示名;空 = 用 identity.json 里的名字(首次取 os.hostname())
workspaceRoles{}按工作区声明角色:{ [路径]: { owner, session, mesh } }。owner = 属主/执行侧(文件与命令真正跑在那台),session = 会话侧(在那台驱动会话),mesh = 是否作为互联会话(缺省 false = 纯本地,一律本机落地)。语义与判定表见 §4.1;界面标识与路由共用 mesh 这一个开关
allowInboundtrue是否接受其它设备接入
requireTokentrue入站是否必须带令牌 + 签名
allowRemoteExecfalse跨设备执行总开关
execTrust'grant-required'谁可以执行:grant-required | any-authenticated
exportRoots[]额外导出的绝对路径
exportWorkspacePathstrue自动把本机工作区路径加进导出根
execTimeoutMs120000单条命令最大时长(调用方只能要更短)
execCommandLimit32768单条命令正文的字符上限
listLimit500目录列举的条目上限
requestSkewMs300000签名时间戳允许的偏差
replayCacheMax8192nonce 防重放缓存容量
execOutputLimitBytes262144stdout / stderr 各自上限
execMaxConcurrent4并发执行数上限
execAudittrue审计是否落盘(关掉只留内存最近 200 条)
inventoryTtlMs5000(本 profile 配 20000)清单快照 TTL;实际决定后台刷新频率
pushIntervalMs / heartbeatMs30000 / 20000推送与心跳间隔
mirrorIntervalMs60000拉一跳总览的间隔
titleFoldBudget / titleFoldBudgetMs40 / 2500标题日志折叠的条数与时间预算
maxSessionsPerWorkspace500单工作区列出上限(超出截断并标注)
maxDevices64接入设备数上限
includeSubagents / includeArchivedtrue / false清单是否含子代理 / 已归档会话
nodeStaleMs / nodeOfflineMs90000 / 600000活跃度阈值
authFailMax / authFailWindowMs40 / 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 或同路径)说明对端也在用这个工作区,单独不足以定方向
4config.workspaceRoles[path] = {owner, session, mesh}人工声明的角色声明,不随运行时变化;对端离线时仍然有效。mesh 是标识与路由共用的开关(见 §4.1):没声明 mesh 的工作区是纯本地,不标

方向由「会话侧是不是本机」决定:会话侧 = 本机 → 本机在跑 agent(命令可能发到别处), 不标;会话侧 = 远端 → 会话在远端执行、命令会到属主侧,执行端要标的就是它。 再与 mesh 取交集:remote = mesh && 会话侧不是本机,所以「界面标了远端执行」 与「命令真的会发到属主」永远一致(§4.1)。