跨会话消息 BigBugy/dsh-tool-session-message

dsh-tool-session-message

给 DeepSeek Harness（DSH）加跨会话消息能力：按 session id 把一条 user 消息发给另一个会话——问问另一个窗口在做什么，或者把新情况交给它。

给 DSH 加一个工具 session_send(session_id, message, mode?)：把一条 user 消息投递到另一个会话（比如另一个窗口），让对方开始一轮或插话。每条消息自动带上发送方 Session ID，方便多窗口互相认证身份、接续任务。

功能

- session_send(session_id, message, mode?) —— 把消息投递给同一 DSH 主机里的任意会话。
- 身份头 —— 每条投递的消息自动加上前缀：【跨会话消息 · session_send】 from: session-xxxxxxxx-... reply: session_send(session_id="session-xxxxxxxx-...", message="...")

接收方由此知道是谁发的、该怎么回。
- mode: "followup"（默认，排进目标会话的下一轮 user 消息）或 "steer"（注入正在运行的一轮）。
- 返回主机的确认信息，结构化 JSON（ok、from、to、mode、requestId、result）。

环境要求

- DSH 0.2.1-rc.5 或兼容版本（用到 sessionController 服务）。
- 目标会话必须位于同一个 DSH 主机进程（同一个桌面应用的多个窗口满足这一条件）。

安装

在 DSH 桌面应用里（推荐）

Settings → Plugins → Add plugin，然后粘贴：

github:BigBugy/dsh-tool-session-message

插件管理器接受 npm 包名、GitHub 仓库和本地目录。
本包没有发布到 npm —— 请用 github: 写法（或下面的本地路径）。

用 DSH 命令行（仅限命令行部署）

dsh plugin --profile <profile> add github:BigBugy/dsh-tool-session-message

桌面应用不带 dsh 命令；桌面用户请走 Settings → Plugins 安装。

手动安装（本地开发）

1. 把本包放到 <profile>/node_modules/dsh-tool-session-message（<profile> 例如 ~/.dsh/profiles/desktop）。
2. 把它加进该配置档的 package.json： {
"dependencies": { "dsh-tool-session-message": "link:<path-to-this-package>" },
"dsh": { "profile": { "bundles": [ "...", "dsh-tool-session-message" ] } }
}

3. 本包自带 cordis.patch.yml，其中含 dsh.bundle.patch，因此工具会插入到整个进程。
4. 重启 DSH（主机插件在启动时加载）。

用法

让模型调用，或直接调用：

session_send(session_id="session-0e8596c3-...", message="What are you working on? Reply briefly.")

接收方看到带装饰的消息，可以这样回复：

session_send(session_id="<the id in from:>", message="...")

工作原理

- DSH 使用 Cordis 插件框架。插件是一个 ESM 模块，导出 { name, inject, apply }（可选 Config）。
- 本插件注入 ["tools", "sessionController"]，并通过 ctx.tools.register({...}) 注册工具（普通对象 —— 不依赖 @deepseek-ai/dsh-tools）。
- 投递时调用 ctx.sessionController.prompt({ sessionId, content: [{ type: "text", text }], mode, requestId }, signal)：
- requestId 必填，缺了它宿主会拒绝，报 prompt rejected。
- 会话 id 必须保留 session- 前缀。

实现要点与坑

1. parameters 必须是完整的 JSON Schema 根。 ctx.tools.register() 只校验 output.schema；parameters 会原样投影给模型。如果只给一个扁平属性表、不带 { "type": "object" }，整个模型请求会失败： Invalid schema for function 'session_send': schema must be a JSON Schema of 'type": "object"', got 'type": null'。
2. DSH 支持的 schema 子集：type / oneOf / properties / required / additionalProperties / items / enum / const，外加注解 description / title / default / examples。属性级 required: true 不是合法 JSON Schema。
3. requestId：每次调用生成一个（crypto.randomUUID()），否则宿主会拒绝提示词。
4. 加载：签名错误、导入错误只在宿主进程日志里出现；插件在 DSH 启动时加载，所以改完代码要重启。
5. Bundle 元数据：想在插件管理器界面里显示，第三方插件应在 package.json 里声明 dsh.bundle.patch，并列入配置档的 dependencies + dsh.profile.bundles。

安全说明

- 这个工具让模型把用户提示词注入其他会话，可能在这些会话里开启新一轮对话。按特权自动化对待：只在你掌控的配置档里启用。
- 不访问网络，不写文件，不调 shell，只调用宿主的会话控制器。
- 消息会作为普通用户消息存进目标会话的 transcript。

兼容性

| DSH 版本 | 状态 |
| 0.2.1-rc.5 | 已测试 |
| 更早版本 | 未知，sessionController 服务可能不存在 |

许可证

MIT