dsh-session-title-summary

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

English | 中文

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

工作原理

• 插件监听每个存活顶层 agent 的 agent/turn-stopping 事件（与 dsh-auto-memory 相同的事件）。
• 会话收尾后，派生一个子代理（以当前 agent 为 parent），子代理继承同一模型路由 与工作区，主对话不被阻塞、不被打扰。
• 子代理收到"上次的滚动摘要 + 本轮新事件的摘要"（用户消息、助手回复、工具名/参数/ 结果），以结构化对象返回更新后的摘要与新标题。
• 摘要按会话原子写入 $DSH_HOME/dsh-session-title-summary/<sessionId>.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 设置界面会渲染本插件的配置区：

数据

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

开发

pnpm install
pnpm test
pnpm build

已知限制

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

License

BSD-3-Clause.