会话标题摘要xiaochaZ/dsh-session-title-summary

dsh-session-title-summary — 滚动会话摘要 + 当前任务标题

GitHub stars
License
DSH

一个纯 host 端的 DeepSeek Harness (DSH) 插件：每轮对话结束后，把会话的工作总结成
滚动式的"大问题 - 小问题"大纲，并把会话重命名为"会话总体目标 - 当前正在处理的具体
事项"。完全基于官方 NPM SDK 实现——不改动 DSH 源码。

工作原理

- 插件监听每个存活顶层 agent 的 agent/turn-stopping 事件（与 dsh-auto-memory
相同的事件）。
- 会话收尾后，派生一个子代理（以当前 agent 为 parent），子代理继承同一模型路由
与工作区，主对话不被阻塞、不被打扰。
- 子代理收到"上次的滚动摘要 + 本轮新事件的摘要"（用户消息、助手回复、工具名/参数/
结果），以结构化对象返回更新后的摘要与新标题。
- 摘要按会话原子写入
$DSH_HOME/dsh-session-title-summary/.json，并通过官方 sessionTitle
服务完成会话重命名。

摘要格式："大问题 - 小问题"

摘要以简洁大纲覆盖整个会话。大问题是用户在推进的会话级目标（如"开发标题自动
总结功能"）；小问题是该目标下的具体事项（如"修复子代理输出token上限"）。每行
形如"大问题 - 小问题"，同一大问题的行聚在一起、不同大问题空行分隔。当前大问题条目
最多，旧大问题各保留一条简短条目。

标题跟随当前工作

标题使用同样的形式，例如"开发标题自动总结功能 - 修复子代理输出token上限"。它基于
摘要末尾的最新工作生成，绝不以会话开头的内容为准——会话演进时标题始终跟随当前任务。

缓存安全

session/title 事件是纯日志事件：它从不进入 deriveMessages()、系统提示词、工具
schema 或请求前缀，因此重命名不会影响输入缓存命中率或 KV 缓存。总结在独立子代理中
执行、使用独立提示词——不与主对话共享前缀。

安装

从 npm（发布后）
dsh plugin --profile  add @xiaochaz/dsh-session-title-summary@latest

从仓库（开发）
git clone
cd xiaochaz-session-title-summary
pnpm install && pnpm build
dsh plugin --profile  add link:$(pwd)

安装后重启 dsh web。插件在下一轮对话结束后生效。

配置

Web 设置界面会渲染本插件的配置区：

| 键 | 默认 | 含义 |
| --- | --- | --- |
| enabled | true | 总开关。关闭后标题不再被自动修改（插件不再做任何事）。 |
| targetWords | 6 | 提示词中非 CJK 标题的目标词数；实际硬上限由显示宽度决定。 |
| targetCjkCharacters | 10 | 标题宽度硬上限（CJK 字数；2 个 ASCII/半角字符算 1 个 CJK）。 |
| provider / model | 会话路由 | 可选显式 LLM 路由覆盖；默认跟随会话当前模型。 |
| timeoutMs | 90000 | 每次折叠的子代理超时。 |

数据

- 滚动摘要：$DSH_HOME/dsh-session-title-summary/.json
（带版本号的 JSON，原子写入；lastSeq 是已折叠的最大事件 seq）。

开发

pnpm install
pnpm test
pnpm build

已知限制

- 总结子代理有固定 8192 token 的输出预算，摘要本身限制在 1000 字符以内；折叠仍失败时
只推进游标、不重命名，避免同一批事件被反复重喂。
- 开启状态下，用户手动改过的标题也会在下一轮被插件更新（关掉开关即停止）。
- 子会话（subagent）被跳过，只管理其父会话的标题。

License

BSD-3-Clause.