dsh-interconnect

主要功能

• 通过 `/interconnect/link` WebSocket 端点在实例间双向推送消息与事件，内置心跳与指数退避重连。
• 提供 interconnect_send/list/ping/reply 四个模型工具，支持按 instanceId 寻址、列出对端 live session、探测活性、免地址回复。
• 共享密钥（DSH_INTERCONNECT_TOKEN）bearer 鉴权，fail-closed 且使用 timing-safe 比较。
• 支持通过 resume 参数唤醒对端已持久化但未运行的 session，并可选择 followup/steer/inject 三种投递模式控制是否及如何触发新回合。
• 自动识别并拒绝直投 subagent 拥有的 session，避免与其父 agent 抢占 inbox。
• 投递失败时返回细分原因（如 session-not-live、unreachable、resume-refused 等），便于调用方决定是否重试或换目标。

适合什么时候用

• 需要在多台机器或多个 DSH 实例之间转发用户消息、协调 agent 会话。
• 需要探测另一个 DSH 实例是否在线、枚举其当前活跃 session。
• 希望在一个实例的 agent 完成任务后，主动唤醒另一实例上闲置的 session 继续处理。

安装后会多出什么

使用前需要

• 需要配置共享密钥环境变量 DSH_INTERCONNECT_TOKEN 用于跨实例鉴权。
• 需要在 interconnect 行的 peers 配置中登记对端的可拨号 origin，才能按 instanceId 寻址。
• 依赖多个 DSH 官方包（@deepseek-ai/cordis、dsh-agent、dsh-api-remotes、dsh-credentials、dsh-llm、dsh-session、dsh-subagent、dsh-host-apiproxy、dsh-host-webserver、dsh-tools、dsh-invariants、schemastery）作为 peerDependencies。
• 唤醒离线 session（resume）功能需要部署 api-proxy 提供的 agent lookup，headless/无 api-proxy 部署会降级为 session-not-live。