会话命名优化 fantasy123246/dsh-session-namer

dsh-session-namer

更好的会话名。DSH 默认的会话标题服务商只用第一条人类消息取名，而且它的 system prompt 里有一句 still return a short best-effort title, such as Greeting——所以一个以「你好」开头的会话就永久叫「打招呼」「简单问候」「Greeting in Chinese」。

这个插件替换掉那个服务商，并额外提供两个手动入口（模型工具 + 界面按钮）。

它做什么

1. 替换标题服务商。automatic: 'first-prompt'，但 prompt 完全不同：删掉 such as Greeting，改成「标题是列表里的路标，不是摘要」「以主语开头」「名词短语、2-4 个词」「禁止用问候类标签」no "Greeting", "打招呼", "你好", "问候", "New chat", "闲聊", "简单问候"，并把 工作目录、agent preset 和 会话实际做了什么 一起喂给模型。
2. 喂「会话做了什么」而不只是「人说了什么」。这是覆盖面问题的解：一条几千事件的长会话，人类消息加起来可能只有一两千字节，而 tool/call + job/registered 里藏着主语。digest 只取工具名、文件名（basename）、脚本名及其出现次数，不取任何工具输出、不取 assistant 正文，所以体积小（约 300 字节）且全是有信息的名词：
{"toolsUsed":["pwsh×166","read×89","write×74"],
"filesTouched":["adapter.js×47","serialize.js×20","AGENTS.md×13"],
"scriptsRun":["_probe_variant.mjs×10","_scan_logs.py×8"]}

只出现一次的不带 ×1。
3. 有界的自我修订。一轮结束后，如果人类说了当前标题尚未引用的新内容，就 sessionTitle.refresh() 重跑一次（默认最多 4 次，两次之间至少隔 120 秒），让标题跟上实际工作。
只对本插件自己命名的会话生效：装插件前就已有标题的会话不会进入这张表，而 first-prompt 语义上也不会让服务把「已有标题的会话」交给本插件 ⇒ 历史会话名永远不会被改写。
4. 长度按显示宽度算，不是字数。CJK 字符算 2 格、拉丁字母算 1 格，所以同一个预算下中文标题更短。超出上限时按边界截断：切在拉丁单词中间会退回词首，切在 CJK 串中间会退回最近的分隔符（否则会留下「产品 宣」这种半个词）。
5. 被拒的答案重来一次。模型偶尔还是会返回「你好」（旧 prompt 教出来的习惯），或者超宽到必须截断。这两种情况会把拒稿理由追加进请求再问一次（只对这两种硬失败：略超目标宽度是正常的，不值得为它花第二次模型调用）。
6. 手动入口（用户点了才跑）：
- 模型工具 session_title：对话里说一句「给这个会话重新取个名字」即可。
- 对话头部按钮「重新取名」：只作用于当前打开的会话。

不做什么

不批量修历史会话名，不改写任何已有的 session.v4.jsonl.zstd，不刷新投影缓存。
打开一个旧会话再点按钮属于显式用户动作，那一刻它是活会话，走的是
sessionTitle.refresh() —— 和自动流程无关。

安装

把插件目录放到任意位置（例如 ~/.dsh/plugins/dsh-session-namer），然后：
dsh plugin --profile desktop add link:C:/Users/<you>/.dsh/plugins/dsh-session-namer

装完完全退出 DSH（含托盘）再启动。宿主半边在启动时注册服务商， cordis.patch.yml 里 session-title-llm: disabled 会同时生效。

改完 lib/index.js 想立刻生效：宿主有 dsh-hmr 在盯着插件目录，touch 一下文件等几秒即可， GET /dsh-session-namer/status 的 revision 字段会变成源码里的 REVISION 常量。

配置

在插件自己的 cordis.patch.yml 里 config: 段（或在 profile 的 cordis.patch.yml 覆盖同名条目）。全部可选：

| 键 | 默认 | 说明 |
| targetTitleWidth | 16 | 目标显示宽度（格）；CJK 字符 2 格、拉丁字母 1 格，即 8 个汉字或 16 个字母 |
| maxTitleWidth | 24 | 硬上限；超出按边界截断 |
| maxInputBytes | 8192 | 送给模型的输入字节上限（超了从最旧的消息开始丢） |
| maxOutputTokens | 1024 | 输出上限；推理模型会先花 token 思考 |
| timeoutMs | 45000 | 单次取名超时 |
| maxRefinements | 4 | 自驱动修订上限；0 = 只取一次名，之后不再自动改 |
| refineGapMs | 120000 | 同一会话两次修订之间的最小间隔，防止连着几个短回合就刷一串模型调用 |
| includeCwd | true | 是否把工作目录作为主语素材 |
| includeActivity | true | 是否把「会话做了什么」的 digest 一起发 |
| provider / model | 空 | 显式路由覆盖，两个必须同时给；留空则用会话已记录的 route |

手动入口的行为

- 工具：exec.agent.session → sessionTitle.refresh()，返回 {ok, title, previous, changed}；失败返回 {ok: false, message}，不会抛到模型。
- 按钮：POST /dsh-session-namer/refresh {sessionId, hint?}，返回 {ok, title, previous, changed, source, model, status}。
GET /dsh-session-namer/status 查看 revision、生效配置、最近一次生成结果与失败原因。
会话不在内存里时返回 400「该会话当前没有打开」——不碰冷会话。
- hint 可以给一句话强调，例如 偏向备份脚本。

测试

node tests/smoke.mjs # 端到端，全部 stub，不联网
node tests/clamp.mjs # 截断行为
node tests/replay.mjs <plain.jsonl> # 回放真实会话日志，打印实际会发出的 prompt
node tests/eval.mjs <out.json> <plain.jsonl>... # 批量导出 prompt

session.v4.jsonl.zstd 是多帧 zstd，node 的 zstdDecompressSync 只解第一帧会截断，所以 tests/unpack.py 用 Python 的 zstandard.stream_reader 走完全部帧。

为什么不能 import @deepseek-ai/*

安装配置档时，官方包不会交给三方插件（profiles/<name>/node_modules/@deepseek-ai 里只有 cosmokit 和 schemastery）。所以宿主半边只用 node 内建模块，工具定义手写， LLM 流自己累加（只认 text-delta 与 finish）。

已知边界

- sessionTitle 同时只允许一个 provider；装本插件必须让 session-title-llm 保持 disabled，否则服务会报 session-title provider "..." is already registered。
- 会话若被用户手动改过名（source.kind === 'user'），refinement 会立刻放弃该会话，只有显式点按钮/调工具才会覆盖——这是刻意的。
- refresh() 只对内存中的活会话可用（session "${id}" is not live in this store）。

License

MIT