dsh-bridge

dsh plugin --profile web add dsh-bridge

<div align="center">

<img src="docs/assets/hero.svg" alt="DSH Bridge" width="100%" />

DSH Bridge

[English](README.md) · [简体中文](README.zh.md)

  

</div>

让同一 DeepSeek Harness 主机内的会话发现彼此并交换消息。Bridge 是 Chat 房间和受信任 Weave 投递共用的本地基础层。

三个工具，连接本机会话

工具 · 用途

session_list · 查看会话及当前状态。

session_send · 按准确会话 ID 或可读标题发送消息。

session_messages · 读取有界的近期投递记录。

快速开始

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

请 Agent 先列出会话，再给目标会话发送消息。Bridge 直接提供工具，没有独立设置页。

session_send 的 mode: auto 先匹配 ID，再匹配标题；id、name 可以指定一种方式。标题匹配不区分大小写，重名时返回候选 ID，不会自行选择收件人。

遵循会话状态投递

flowchart LR
  Send[发送消息] --> Resolve[解析目标]
  Resolve --> Live[活跃会话]
  Resolve --> Cold[恢复持久会话]
  Live --> Queue[加入后续任务队列]
  Cold --> Queue

• 空闲 Agent 会被唤醒，运行中的 Agent 接收排队任务。
• 持久会话按记录中的 preset 和模型恢复。
• 并发请求共用同一冷会话恢复过程。
• 已归档会话拒绝投递，不会被唤醒。
• 恢复期间取消会阻止迟到的后续任务，即使共享加载最终完成。

投递确认表示会话接受了后续任务，不表示模型已经处理消息或完成工作。

配置

字段 · 默认值 · 用途

recentMessages · 1000 · 每台主机保留的近期消息数。

dedupeCapacity · 10000 · 记住的外部消息 ID 数量。

maxMessagesPerRead · 100 · 单次读取的消息上限。

插件集成

公开服务是 ctx.dshBridge。受信任传输层调用 deliverExternal()，让本地与外部投递使用相同的 follow-up 和审计路径；可选的 signal 将取消传递到会话解析。

DSH Weave 提供跨主机传输，DSH Chat 提供房间和 Web 对话界面。本地消息功能无需安装它们。

保留范围与边界

Bridge 作用于一个主机进程。近期消息和去重表保存在内存中，插件卸载或重载后会清空，不是持久邮箱。旧的 ctx.sessionMessaging 访问器暂时保留作兼容别名。

开发与反馈

npm ci
npm run check

提交问题 · [版本记录](RELEASES.md) · [MIT 许可证](LICENSE)