跨会话传信 f123y/dsh-session-message

dsh-session-message

DSH（DeepSeek Harness）跨会话消息插件。

让不同会话（session）之间的 agent 互相发送消息。在一个会话里让 agent 调用 session_message_send，消息会投递到目标会话，目标会话的 agent 会把它当作一条新的用户消息，在下一轮开始处理并回复；它也可以再用 session_message_send 回信，形成跨会话对话。

兼容性：在 dsh / @deepseek-ai/dsh- 0.1.6-alpha.1 上测试通过。
（0.1.0-rc.6 请使用本插件的 0.1.0 版本）

工具

| 工具 | 说明 |
| session_message_send(target_session, content) | 向另一个会话投递一条消息（支持在线和已持久化的会话，自动 resume 目标）。可选 priority: "immediate" 在目标当前回合的下一步注入，更快。成功返回 { delivered: true, target_session, message_id }，失败返回 { delivered: false, code, message }。空内容、向当前会话自发都会被拒绝（invalid_args）。 |
| session_message_list(query?, limit?, live_only?) | 列出会话（在线 + 已持久化，经 ctx.sessionQuery 统一获取），最新在前，默认最多 30 条（上限 200）：会话 id、标题（含已持久化会话，批量折叠）、工作目录 cwd、创建时间、origin、agent 状态（idle/running）、是否当前会话/在线/已持久化、分组信息。query 对 id/标题/cwd/分组做不区分大小写的子串过滤；live_only: true 只列在线会话。 |
| session_message_create(title?, first_message?, group?) | 创建新会话（自动启动 agent、继承调用方预设的完整工具集、自动归入当前工作区），可选：title 设置自定义显示标题——侧栏里显示的名字，经 session-title 服务钉住，之后自动起名不会覆盖（还可在 GUI 里再改名）；first_message 同时投递首条消息；group 指定分组。成功返回 { created: true, session_id, title? }。注意 title（会话显示名）与 group（插件私有分组标注）是两回事。 |

| session_message_queue(target_session, action?, message_id?, queue?) | 查看并管理其他会话要排队处理的消息：next_turn（排到下一轮的普通消息）与 next_step（priority: "immediate" 插进当前步骤的紧急消息）两条有序列表，附 agent 状态与 pending_count 总数；每条只含发送方与前 120 字预览（插件消息自动剥掉框架头直取内容）。action: "view"（默认）只查看；"remove" 按 message_id 撤下一条待处理消息；"promote" 把 next_turn 里的一条提到 next_step 队首（人工插队）；"clear" 清空队列（queue 可选 next_turn/next_step/both，默认 both）。变更写 agent/inbox/spliced 事件、立即持久化，返回改后的队列视图。只对在线会话有意义——离线会话收件箱未挂载，返回 live: false 并附说明。数据来自 harness 的 sessionProjections 服务 inbox 投影。 |

失败码：invalid_args、session_not_found、agent_not_live、resume_failed、create_failed、aborted。

项目组编排（Playbooks）

想让多个会话组成项目组干活？看 playbooks/：一套「项目经理 + 工人会话」提示词模板——PM 会话吃下 goal 后自动建组、拆任务、派活、验收、催办；附开发与渗透测试（仅限授权场景）两个实例包，含工人守则、急件写法、静默失联巡检等实战铁律。

工作原理

- 插件在 agent/created 时向每个 agent 的 scoped 上下文注册上述四个工具（与 @deepseek-ai/dsh-schedule 同一模式，含 WeakSet 去重与停机防护）。
- 投递走目标 agent 的 inbox 队列：默认 agent.followup（下一轮），priority: "immediate" 时用 agent.steer（当前回合的下一步）。先在目标会话日志中持久化 agent/inbox/spliced，目标循环 claim 后以 user/message（surfaceOp: append）追加并响应。队列状态经 sessionProjections.stateOf(session, "inbox") 可查——这正是 session_message_queue 的数据来源。
- 不打断目标正在进行的回合，消息可持久化、可恢复。
- 发送到已持久化但未打开的会话时，自动 resume 目标（加载 + 启动 agent）后再投递。model selection 与 agent preset 一律在 setup 回调内安装（resume 返回时循环已启动，事后安装有时序窗口）；模型路由优先取目标会话自己日志里记录的那份（部署默认模型 → 调用方路由仅作兜底），预设缺失时挂载默认预设——跨会话投递不会把发送方的模型强加给目标，也不会让目标丢掉自己的工具组合。
- 创建新会话时用 agentPresets.composeFrom() 绑定调用方同一份 standing composition（同一代插件实例与工具注册），并安装 model selection，使系统提示的 {{provider}}/{{model}} 变量可解析；创建前确保 cwd 目录存在，创建后若被中止会 dispose 掉已创建的 agent，不留孤儿会话。指定 title 时经 sessionTitle.rename() 以 user 来源追加 session/title 事件并钉住标题（后续自动起名不再触发，GUI 可再改名；改名失败只告警、回退自动起名）。
- 新会话自动附加到当前工作区（workspace），不会出现在"未分组"。
- 分组信息持久化到 $DSH_HOME/storages/session-message-groups.json，重启不丢失（注意：这是本插件私有的标注，只有 session_message_list 会读它；GUI 侧栏的分组来自 workspace）。

安装

前置条件：dsh 命令行可用；全局安装 pnpm（npm i -g pnpm，dsh plugin 命令直接转发给 pnpm）。

从 GitHub 安装（pnpm 9+ 需要 -w，pnpm 8 也兼容）
dsh plugin --profile web add -w github:f123y/dsh-session-message

或从本地开发目录安装
dsh plugin --profile web add -w /path/to/dsh-session-message

然后在 $DSH_HOME/profiles/web/cordis.patch.yml 中启用（换成你自己的 profile 名）：

- insert:
- id: session-message
name: dsh-session-message
config:
framing: true

⚠️ 注意：新初始化的 profile，该文件末尾有一行占位符 []——要替换这一行，不能在其后追加，否则 YAML 非法、profile 启动失败。

重启 dsh web。重启后新（重新）打开的会话都会获得工具。

没有 GUI 开关可以添加插件条目——必须编辑 patch 文件（设置页只读展示当前条目）。

配置

| 字段 | 默认 | 说明 |
| framing | true | 投递时在消息前附加归属框架（[跨会话消息 来自会话 / Cross-session message from session ]），提示目标把它当作普通消息而非指令。设为 false 时原样投递。 |
| includeSubagents | true | false 时只给顶层 agent（ctx.agents.roots()）注册工具，子 agent（subagent）不再获得这四个工具。 |

使用示例

1. 在 Web UI 打开两个会话（A、B）。
2. 在 A 中对 agent 说："用 session_message_list 看看有哪些会话，然后把「请检查一下 B 任务的进度」发给会话 B。"*
3. A 投递成功，B 的 agent 收到消息并开始处理、回复。
4. 在 B 中让 agent 用 session_message_send 回信，形成对话闭环。
5. 也可用 session_message_create 创建新会话并指定分组和首条消息。

开发

dsh-session-message/
├── package.json # ESM；依赖 @deepseek-ai/dsh-tools + dsh-agent（锁定 0.1.6-alpha.1） ├── lib/index.js # 插件本体：name / inject / apply + 工具实现 ├── LICENSE # MIT └── README.md

- 修改 lib/index.js 无需构建；如果 profile 用 link: 安装，改完重启 dsh web 即生效。
- 仅使用公开 harness API：ctx.agents / ctx.sessions / ctx.sessionQuery（统一列出在线+持久化会话与批量标题）/ ctx.workspaceRegistry / ctx.agentPresets（composeFrom 继承父会话 composition）/ agent.followup/agent.steer 与 @deepseek-ai/dsh-tools 的 defineTool。
- cordis 的 inject 全部是必需依赖（任一缺失整个插件不激活且不报错），所以只声明 ["agents", "sessions", "tools"]；sessionQuery / sessionTitle / sessionPersistence / workspaceRegistry / agentPresets / agentDefaultModel 一律 ctx.get() 按需取用，缺失时优雅降级。
- npm 包名 dsh-session-message 尚未被占用，未来可 npm publish 以便直接安装。

License

MIT © 2026 f123y (咩了个咩)