会话唤醒 TiFu799/dsh-wake-up

dsh-wake-up

按需叫醒休眠的会话 —— 带模型路由、不重复、不调模型。

English · 简体中文

它解决什么

DSH 关掉再开，之前打开过的会话不会自己活着。只有你在 GUI 里点开的那一间才会被实例化，其余的都在磁盘上睡觉。于是任何「外部把消息投进某间会话」的集成 —— QQ 通道、定时任务、webhook、别的插件 —— 都会撞上同一句话：

那间会话现在没活着（0e4e241e），先把它打开

这个插件把「叫醒」做成可复用的能力：会话休眠时，带着它上次用的模型路由把它 resume 回来，外部消息就能正常投递。

三个入口

1. 端点（给脚本用）

curl -X POST http://127.0.0.1:<GUI 端口>/dsh-wake-up/wake \
-H 'content-type: application/json' \
-H 'origin: http://127.0.0.1:<GUI 端口>' \
-d '{"会话":"session-0e4e241e-…"}' {"ok":true,"说":"已拉起 0e4e241e","路由":{"provider":"deepseek-account","model":"deepseek-flash","reasoningEffort":"max"}}

GET /dsh-wake-up/state 返回盘上的会话、哪些活着、哪些读到了路由，以及最近日志。

2. 工具（给模型用）

wake_session({ session: "session-0e4e241e-…" })

模型需要往一间没打开的会话投消息时，自己调它。

3. 服务（给别的插件用）

export const inject = ['wakeUp']

export function apply(ctx) {
if (await ctx.wakeUp.resume(id)) { /* 现在可以把消息投进去了 */ }
ctx.wakeUp.isAwake(id) // 已经在活着吗
ctx.wakeUp.route(id) // 这间会话会带什么路由去唤醒
ctx.wakeUp.state() // 概况
}

安装

市场收录之后：在市场里搜 dsh-wake-up 一键装（命令行 dsh plugin add dsh-wake-up --profile desktop 等价）。

收录之前：市场只接受已收录的插件，想先试就在本仓库里打包再装进 profile：

pnpm pack # 产出 dsh-wake-up-0.1.0.tgz
cd ~/.dsh/profiles/desktop && pnpm add <上面的 tgz 路径>

然后把下面这段加进 profile 的 cordis.patch.yml（插件本身按 dsh.bundle.patch 自动挂载，这一步只是让它被 profile 认识）：

- insert:
- id: wake-up
name: dsh-wake-up

装完刷新页面即可，不需要重启。

配置（可选）

写进 profile 的 cordis.patch.yml：

- id: wake-up
name: dsh-wake-up
config:
开机唤醒: # 插件加载 3 秒后先叫醒这几间，默认空
- session-0e4e241e-…
日志上限: 40 # 最近日志留多少条

两个必须知道的细节

1. resume 必须带路由。 不带 agentOptions（provider / model）时，恢复出来的 agent 没有模型路由，提示词里 deployment:persona-prefix 的 {{model}} 就组装不出来，整轮直接报 prompt variable "{{model}}" has no value for this assembly。本插件从会话的 modelSelection 投影里读上次用的路由，读不到再退回 profile 的 agent-default-model。

2. resume 不调用模型。 它只把会话历史读回内存 —— 空闲时 0 次模型请求，和你在 GUI 里点开会话的开销一样。模型请求只发生在这一轮真的需要出字的时候。

兼容性

- DSH >= 0.2.1-rc.2（自带 ctx.agents.resume 的版本）。
- 无前端、无依赖、不写任何配置文件，只用 agents / webServer / tools 三个宿主服务。
- 在没有 agents.resume 的宿主上会安静地降级为「叫不醒」，不会报错崩掉。

许可

MIT。

按需叫醒休眠的 DSH 会话 —— 带上它上次用的 provider/model 路由，已经活着的会话绝不重复叫醒，自己也不花一次模型请求。

DSH 重启之后，只有你在 GUI 里打开过的会话是活的，其余的都在磁盘上。任何往会话里投消息的集成（聊天桥、调度器、webhook、别的插件）都会撞上 that session is not alive — open it first。这个插件改为把它 resume 回来。

- POST /dsh-wake-up/wake {"会话" | "session": "session-<uuid>"} → {ok, 说, 路由}
- GET /dsh-wake-up/state → 盘上的会话、哪些活着、哪些有路由
- 工具 wake_session({session})
- 服务 ctx.wakeUp（resume / isAwake / route / state）
- 配置：开机唤醒（加载时唤醒这些会话）、日志上限

恢复会话时如果不传 agentOptions，人格前缀就会失效（{{model}} 取不到值），所以路由改为从会话的 modelSelection 投影读取，读不到再回退到配置档的 agent-default-model。恢复只把历史读进内存，不会调用模型，除非该会话随后真的作答。

MIT 许可。