baixianger/dsh-weave

DSH Weave

English · 简体中文

通过 Iroh 连接明确受信任的 DeepSeek Harness 主机。由一个传输层统一处理配对、身份、可达状态和远程会话目录。

主要能力

能力	行为
持久身份	重启后保持同一个主机身份。
明确配对	交换 endpoint ticket，并在本机信任对端。
加密传输	Iroh 提供 QUIC 连接、直连路径和中继回退。
远程目录	查看配对主机的工作区与会话。
可见状态	区分主机可达性与 Agent 的空闲、运行、离线状态。
原生设置	分组展示身份与配对操作，提供复制反馈和移除确认。

快速开始

在每台主机执行：

dsh plugin --profile web add dsh-weave@latest
dsh web

1. 在两台主机打开 设置 → Weave。
2. 通过可信渠道交换双方 ticket。
3. 在各自页面添加并明确相信对方的 ticket。
4. 在 DSH Chat 等上层插件中选择远程会话。

如果消息需要到达接收主机上的本地 Agent，再安装 DSH Bridge。传输层启动不强制依赖 Bridge。

各层职责

flowchart LR
  A[主机 A · Bridge] --> WA[Weave]
  WA <-->|Iroh · QUIC| WB[Weave]
  WB --> B[主机 B · Bridge]

Iroh 负责加密连接；Weave 负责主机信任、endpoint 刷新、可达状态和认证请求；Chat 负责房间、成员和房间权限。仅知道 ticket 不代表获得信任或 Agent 访问权限。

配置

字段	默认值	用途
hostName	系统主机名	主机显示名称。
relayMode	default	Iroh 默认中继选择，或 disabled。
persistIdentity / persistPeers	true	重启后保留身份与受信任主机。
acknowledgementTimeoutMs	10000	默认确认等待期限。
maxConcurrentInbound	64	入站请求并发上限。
shutdownTimeoutMs	1000	传输层关闭等待上限。

身份和信任记录保存在 $DSH_HOME/dsh-weave，默认位于 ~/.dsh，仅所有者可访问。可以通过 identityPath、peersPath 指定位置。

取消与投递

出站请求接受取消信号。取消会关闭连接；对端断开时，接收侧监听器也会收到通知。取消单次请求不会把仍可达的主机误判为离线。Chat 的较长轮询会使用匹配的确认等待期限。

当前是 传输 MVP，提供配对、目录访问和认证请求投递。通用远程任务审批、持久传输 outbox 和重连回放尚未实现；应用级持久化由使用它的插件负责。

协议与架构

架构 · 协议 · 安全模型 · 房间权威主机

设计文档包含规划中的能力；当前行为以本 README 和版本记录为准。

开发与反馈

npm ci
npm run check

提交问题 · 版本记录 · MIT 许可证