GengDaPeng/dsh-agent-message 预览 preview

GengDaPeng/dsh-agent-message

Plugin插件 Native原生 ⭐ 6 MIT Sessions & Context会话与上下文

DeepSeek Harness 跨会话 Agent 通信插件|支持离线投递、回执及会话导航的跨会话 Agent 间消息传递功能。

Project Overview项目介绍

dsh-agent-message is a purpose-built plugin for DeepSeek Harness that enables cross-session communication between separate agent sessions running within the same DSH process. It adds three core tools to every active session: list_peer_agents to enumerate all valid, unarchived target sessions, send_agent_message to deliver messages to a specified session, and check_delivery to query the status of a previously sent message. The simplest installation method is a single CLI command: dsh plugin --profile web add dsh-agent-message, which automatically registers the plugin after installation with no extra configuration required.

To use the plugin, you can either select a target session via Harness's native @ session reference menu or have your agent call list_peer_agents to get a full list of valid session IDs. After sending a message, the plugin will report whether the message was accepted for delivery, and you can check its status at any time using check_delivery. Common use cases include task orchestration where an orchestrator agent assigns work to worker agents, collaborative task handoffs between multiple agents, and monitoring multiple worker sessions from a supervisor agent.

The plugin is verified to work with Node.js 24.x and DeepSeek Harness version 0.1.1-rc.2, and it is released under the permissive MIT open source license. It has several documented limitations: it only works with unarchived local sessions, it enforces a rate limit of 10 messages per 60 seconds between any pair of sessions, and it does not support cross-process or cross-machine communication. Offline sessions are automatically restored with the default model when a message is sent to them, but any custom model configuration for the target session will not be inherited.

这是一个专为 DeepSeek Harness 开发的原生插件,实现了同进程内不同 Agent 会话之间的跨会话通信功能。它为每个会话提供三个可用工具,分别用于列出所有可发送消息的独立未归档会话、向指定目标会话投递消息,以及查询已发送消息的送达状态,还支持离线会话自动恢复后投递。

典型使用场景包括编排型 Agent 给开发 Agent 分配任务、多个 Agent 协作接力完成工作、主会话向测试会话发送测试指令,以及监督型 Agent 监控多个工作会话的运行状态。安装方式非常简单,推荐使用一行 dsh plugin --profile web add dsh-agent-message 命令完成安装,安装后自动注册,无需额外配置。

该插件兼容 Node.js 24.x 版本和 DeepSeek Harness 0.1.1-rc.2 及以上版本,采用 MIT 许可证开源,不收取任何使用费用。它存在一些使用限制,比如仅支持未归档的本地会话,同一对会话 60 秒内最多投递 10 条消息,不支持跨进程或跨机器通信。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:GengDaPeng/dsh-agent-message

把 GengDaPeng/dsh-agent-message 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-agent-message

English | 中文

DeepSeek Harness 的跨会话 Agent 通信插件:让运行在同一个进程里的不同 Agent 会话,像发消息一样互相收发信息。

License


这是什么

在 DeepSeek Harness 里,一个进程会同时挂着多个 Agent 会话。本插件给每个会话装上三个工具,让它们能互相"发消息":

  • 发消息前,先列出所有可发送的独立会话(未归档、排除真实子代理,含离线未打开的),按标题找到目标;
  • 找到后,把消息投递到目标会话——普通消息统一进入独立的新 turn;目标离线(进程重启后还没打开)时,插件通过 Harness 公开接口恢复会话、投递,并保持加载供后续通信,插件卸载时再释放 handle;
  • 需要时,可以按需查询某条消息的送达状态(排队中/已认领/被丢弃/未知),并单独查看目标是否正在运行,供监督场景使用。

典型场景:编排者 Agent 给开发 Agent 派活、两个 Agent 协作接力、主会话给测试会话发指令、监督者 Agent 盯梢多个 worker。

功能

能力 说明
list_peer_agents 列出所有可发送的独立会话:未归档、排除真实子代理;普通 fork 保留。返回 id、标题、工作目录和运行状态
send_agent_message 给指定会话 ID 发消息;默认使用 followup 创建独立的新 turn,离线时自动恢复后投递;显式支持 followup、inject、steer
check_delivery 按需查询消息回执(pending/claimed/discarded/unknown);发送成功时先返回 accepted,接纳前失败由工具错误表示;指定消息 ID 时支持重启后恢复查询
Harness 原生 @ 会话引用 直接复用 Harness 的结构化 Session Reference;选择后当前 Agent 获得稳定 Session ID 和一份有界、只读、标记为不可信的会话快照。引用本身不会发送消息或唤醒目标
可见的 Agent 消息卡片 relay 仍保留真实的插件来源,但 Client 将它显示为左侧 Agent 消息卡片;From Session · <名称>: 可点击或通过键盘打开发送方会话,文案跟随 Harness 语言设置
复制会话 ID 会话头部新增「复制ID」按钮,一键复制当前会话 ID
投递卡片设置 在设置 → 插件配置中,可切换是否显示投递模式和目标运行状态;messageId 始终显示

发送方导航示例

可点击的发送者消息头示例

当前 relay 消息显示为可见的 Agent 消息卡片;点击消息头即可跳转到发送方会话。持久化来源仍是插件 relay,不会伪装成人类输入。完整会话 ID 同时保留在 typed source 和 Host 生成的模型可见协议头中,避免接收 Agent 猜测发送方。

投递模式(send_agent_message 的 mode 参数)

mode 含义
(默认,不传) followup:给目标创建独立的新 turn;离线时自动 resume 后投递
followup 与默认相同;在线直接排队,离线自动恢复后排队
steer 立即介入对方当前工作(仅 running 会话)
inject 不打断当前目标,静默补充下一步上下文(仅 running 会话)

归档会话和真实子代理一律拒绝发送;普通 fork 仍是独立会话,可以发送。发给自己也会被拒绝。

安装

方式一:一行命令(推荐)

dsh plugin --profile web add dsh-agent-message

装完即自动注册,无需任何额外配置。

兼容范围:Node.js 24、DeepSeek Harness >=0.1.1-rc.2 <0.2.0;当前验证版本为 Node.js 24.x、Harness 0.1.1-rc.2。

方式二:从 GitHub 安装

dsh plugin --profile web add github:GengDaPeng/dsh-agent-message

方式三:直接发给你的 Agent

打开任意一个 DSH 会话,把下面这句话发给它:

帮我安装跨会话通信插件,执行:dsh plugin --profile web add dsh-agent-message

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-service 下一个 Next dsh-lark-bridge →