四个工具让 DSH 会话之间互发消息:给另一会话发消息(关着会自动叫醒)、回信给发起方、列出会话并给出稳定的 cs_ 别名、只读查看最近消息而不唤醒。投递统一走宿主的 sessionController.prompt,冷唤醒的会话能力集与 GUI 打开的完全一致。
安装
# npm 包(预构建)
dsh plugin --profile web add @lzlrt/dsh-cross-session
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:lzlrt/dsh-cross-session
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
四个工具,只做一件事:让 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 截断(防止把上下文撑爆)。
链接
同类插件
ranxianglei/billion-context★ 7661
billion-context官方版:上下文压缩插件,兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。
Minglink/dsh-infinite-gen-4★ 4374
DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投影在输入框上方显示实时破甲状态徽标。
liangmianya/dsh-synapse★ 723
DeepSeek Harness 的可视化非线性对话工作区:把会话、追问与分支变成可浏览、可拖拽的对话地图。
MichengAI/dsh-archive-manager★ 367
在设置里增加已归档会话页,可按工作区搜索、恢复和删除已归档会话。
Nwflower/dsh-chat-import★ 317
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
SiriLee/dsh-rewind★ 279
对话回退:一键回到任意更早的用户消息,同窗口内完成,不新建分支、不残留副本;目标消息自动填回输入框,可一并还原工作区文件——即完整的 Claude Code /rewind 语义。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。