前言¶
DeepSeek Harness (DSH) 旨在通过插件化架构实现功能的无限扩展。在分布式智能体开发场景中，跨主机的连接、信任建立以及会话管理是常见痛点。DSH Weave 专注于解决这一问题，它通过 Iroh 协议层，为多个 DSH 实例提供加密、可信的连接通道，并统一管理主机身份和可达性。
插件介绍¶
DSH Weave 是一个连接明确信任的 DeepSeek Harness 主机的插件。它基于 Iroh 实现 QUIC 加密传输，负责主机信任、端点刷新、可达性检测以及认证请求的传递。插件的核心职责包括身份的持久化存储和受信任对等方的管理。
核心功能¶
该插件主要提供以下能力：
* 持久化身份：主机身份在重启后保持一致，无需重复初始化。
* 明确配对：通过交换票据并在本地明确信任对方，建立安全连接。
* 加密传输：利用 Iroh 提供 QUIC 连接、直连路径和中继回退机制，确保传输安全。
* 远程目录：发现并访问已配对主机上的工作区和会话。
* 可见状态：主机可达性与 DSH Agent 的空闲/运行/离线状态是分离的。
* 原生设置：提供分组管理的身份和配对控制，包含复制反馈和移除确认。
安装与启用¶
在目标主机上执行以下命令进行安装：
dsh plugin --profile web add dsh-weave@latest
安装完成后，运行 dsh web 启动 Web 界面。
典型用法¶
- 在参与连接的每台主机上分别执行上述安装命令。
- 在每台主机上启动 DSH Web：
dsh web。 - 在两台主机的 Web 界面中，分别打开 Settings -> Weave。
- 通过一个双方都信任的渠道（如安全聊天或终端）交换两台主机的票据。
- 在每台主机的 Weave 设置中，添加并明确信任对方提供的票据。
- 配对完成后，使用 DSH Chat 等插件选择远程会话进行操作。
适用场景与注意¶
DSH Weave 以当前 DSH 进程的权限运行。安装前应检查源码与许可证（MIT）。
- 前置条件：需要 Node.js >= 22。
- 数据存储：身份和受信任的对等方存储在
$DSH_HOME/dsh-weave（默认为~/.dsh），仅限所有者权限。 - 连接行为：取消请求会关闭连接，接收端的监听器会收到断开通知。取消操作不会将主机标记为离线。
- 当前版本状态：当前版本为传输 MVP（最小可行性产品），主要提供配对、目录访问和认证请求投递。尚未实现通用的远程任务审批工作流，也不具备持久化传输出站消息或断线重连重放机制。
- 生态背景：该插件是 DSH 生态系统的一部分，社区目录与 DeepSeek 官方无从属关系。
结尾¶
DSH Weave 为 DSH 多机协作提供了基础的信任传输层。通过 Iroh 的加密和持久化能力，开发者可以更安全地管理分布式智能体的连接。更多详情可查阅社区目录或 GitHub 仓库。
