Skip to content

dsh-bridge

Verified

dsh-bridge · v0.1.0-rc.17 · MIT

Local session messaging for DeepSeek Harness

Install

dsh plugin add dsh-bridge

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Readme

DSH Bridge

DSH Bridge

English · 简体中文

npm License: MIT DSH plugin

让同一 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

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