- Home
- Plugin
- Sessioni e messaggi
- dsh-cross-session
dsh-cross-session
lzlrt/dsh-cross-session
Four tools that let DSH sessions message each other: send to another session (waking it if closed), reply to the sender, list sessions with stable cs_ aliases, and read recent messages without waking. Delivery goes through the host sessionController.prompt, so a cold-woken session gets the same capabilities as one opened in the GUI.
Installazione
dsh plugin --profile web add github:lzlrt/dsh-cross-sessionREADME
@lzlrt/dsh-cross-session — 跨会话协同
四个工具,只做一件事:让 DSH 的会话之间能互相说话。
| 工具 | 作用 |
|---|---|
session_send | 给另一个会话发消息(该会话关着就自动叫醒它再去送) |
session_reply | 回信给发消息的那个会话 |
session_list | 列出所有会话(名字、状态、别名、模型) |
session_read | 看某个会话最近说了什么(不叫醒它) |
典型用法:一个会话接到大任务,拆开,开几个会话分头做(写代码 / 查资料 / 跑测试),做的过程中可以随时互相问、互相补料,做完回信汇总。
安装
dsh plugin --profile web add @lzlrt/dsh-cross-session
装完重启 DSH。bundle patch 会自动把 cross-session 这一行插进组合。
测试
两个测试都依赖宿主包 @deepseek-ai/dsh-tools(插件本身是宿主 bundle,
lib/index.js 要从宿主取 defineTool)。所以必须在能解析到 DSH node_modules
的位置运行,通常是 profile 目录:
cd ~/.dsh/profiles/web
node node_modules/@lzlrt/dsh-cross-session/test/run.mjs # 31 项逻辑测试
node node_modules/@lzlrt/dsh-cross-session/test/integration.mjs # 宿主级集成验证
test/run.mjs—— 用最小假宿主覆盖四个工具全部逻辑(别名派生、标识解析、 投递路径、归档过滤、工作区过滤、UTF-8 截断边界)。不连真实 DSH,但仍需 宿主包存在才能import插件本体。test/integration.mjs—— 用最小 cordis 应用加载插件,验证inject声明的 服务名与真实宿主一致、apply()真被调用、四工具真注册进tools注册表。 专治「插件装上了但工具没出现」这类静默失败。
在 DSH 之外单独 clone 后想跑测试,先装宿主依赖:
npm i @deepseek-ai/dsh-tools
为什么只有四个工具
没有审批桥,没有危险命令判定,没有权限夹紧——那些属于「安全边界」,不属于「让人和会话之间说话」。本插件只调用宿主自己的 sessionController:
- 发消息 →
sessionController.prompt(),与 GUI 输入框走同一条路 - 冷会话唤醒 →
prompt()内部resolveAgent()自动恢复,preset 由宿主composeAgent解析
因此宿主怎么给 GUI 会话配能力,就怎么给这里叫醒的会话配能力,本插件没有任何机会拼出一个「只有插件工具、没有读写文件能力」的空壳会话。
工具说明
session_send
session_send({ session_id: "cs_XXXXXXXXXX", message: "帮我把 tools/memctl.py 的 check 命令跑一遍" })
session_id:session_list给出的cs_别名,或真实session-<uuid>message:要发的内容mode:steer(默认,插队)/followup(等它这轮结束)reply_to:让它做完回信给谁(默认就是你自己)
目标会话没打开时自动唤醒。唤醒失败会明确报错,不会假装发出去了。
session_reply
session_reply({ to: "cs_XXXXXXXXXX", text: "跑完了,3 个问题,详情如下……" })
任务会话干完活用它回话。to 一般取自任务消息里附带的「回信给 cs_xxx」。
session_list
session_list({ limit: 20 })
给出别名、标题、是否在运行、模型、所属目录。用过期的别名会报错并提示重新 list,不会串到别的会话。
session_read
session_read({ session_id: "cs_XXXXXXXXXX", tail: 20 })
看对方最近的消息,不唤醒。用于「它到底干到哪了」。
别名
会话真 ID 是 session-<uuid>,在模型可见文本里会被显示层替换成占位符,复制回来没法用。所以每个 ID 派生一个 cs_ + 10 位 base62 的短别名(FNV-1a 确定性派生,重启不变,不落盘)。
| 输入 | 行为 |
|---|---|
cs_XXXXXXXXXX | 在会话列表里查找并还原成真 ID |
session-<uuid> | 原样透传 |
| 被遮蔽的占位符 | 拒绝,并提示改用别名 |
| 找不到的别名 | 报错,不猜 |
配合 dsh-auto-wake 使用
两个插件可以共存于同一个会话,因为它们都通过宿主的 sessionController.prompt() 投递。
dsh-auto-wake负责定时/按条件唤醒指定会话- 本插件为该会话提供跨会话发送/回复能力
- 被 auto-wake 唤醒的会话,若它所在 preset 加载了本插件,就可以主动调用
session_send去唤醒或通知其他会话
这是该会话自己的行为,不是 auto-wake 的自动联动。 auto-wake 只负责把一段 唤醒文本投递进来,不做任何转发;它的唤醒正文里也不带来源会话信息。
两者投递形态不同
| 正文末尾 | 能否回信 | |
|---|---|---|
session_send | 「以上消息来自会话 cs_xxxx」+ 回信指引 | ✅ 可 session_reply |
auto-wake 唤醒 | 「[auto-wake] 触发规则「…」,请接着没做完的部分继续」 | ❌ 无来源,无处可回 |
两者都是「有人发了条消息」,但不能因此认为行为一致 —— 接收方能拿到的信息不同。
⚠️ 组合使用时注意额度:auto-wake 自带限流(冷却、小时/天额度、熔断), 但本插件的
session_send没有任何限流 —— 每一次发送都是真实prompt()、真实消耗。 两个会话互相发送时会形成不经过 auto-wake 配额的环,只能靠消息里写明「不要回信」来规避。
已知限制
- 跨工作区:
session_list默认只列当前工作区。要跨项目用all_workspaces: true。别名解析基于全量列表,所以跨工作区也能寻址。 - 归档会话不可写:归档的会话发消息会被宿主拦住,先取消归档。
- 同名标题不唯一:只认别名/ID,不认标题。
- 消息正文按 32 KiB UTF-8 截断(防止把上下文撑爆)。
Plugin correlati
billion-context
ranxianglei/billion-context
dsh-web-ui (dsh-chat-recovery)
zhu1090093659/dsh-web-ui
dsh-synapse
liangmianya/dsh-synapse
dsh-archive-manager
michengai/dsh-archive-manager