dsh-rename-title-after-first-turn
中文 ｜ English
主会话「第一轮对话结束后，自动总结命名一次」的 host-only DSH 插件（不改 app.asar，无 client 半边）。
⛔ 已退役（2026-10-04）· Retired
中文：DSH 0.2.0 起，会话标题变成可插拔提供方 seam（ctx.sessionTitle.register(provider)），
官方随包就带提供方；本插件原先靠"停用官方 provider + 自己 append session/title"来实现，
继续维护的收益不足。因此已从本机 profile 停用：cordis.patch.yml 里那段 insert 已整块注释掉，
同时恢复启用官方 session-title-llm（原来那条 disabled: true 已删除）。
代码与全部测试原样保留，需要时可回退（去掉 insert 注释 + 重启 DSH）。
审计：Day1\reports\dsh-0.2.0升级-自建资产覆盖度审计-20261004.md。
English: As of DSH 0.2.0 session titles are a pluggable provider seam
(ctx.sessionTitle.register(provider)) with providers shipped in the box, so this plugin is retired:
its profile insert is commented out and the official session-title-llm provider is re-enabled.
The code and its test suite are kept unchanged for rollback.
中文
它解决什么
DSH 自带的兜底命名是「首条消息截到 40 字节」，经常读起来不像个标题；而内置的 first-prompt 标题 provider 在本机近乎必失败。本插件在第一轮真正结束之后（已有提问、已有回答）用一次模型调用总结出标题，此后永久不再改。
行为
- 触发：
turn/end 且 turn >= 1。turn === 1 是第一次机会；成功落库后永久冻结（后续轮次被幂等守卫跳过）。第一次机会失败时，允许在后续轮次重试，上限 maxAttempts。
- 只碰主会话：
session.header 必须是对象、parentSession 为空、且 delegationDepth 缺失或为 0；subagent / teammate 会话一律不动。判据是 fail-closed（形状不认识就不碰），因为它是兑现这条硬要求的唯一守卫。
- 素材：第一轮的「首条人类提问 +
turn === 1 的所有助手 text 块」（reasoning 与工具调用一律排除）。重试时素材仍只取第一轮。
- 落库：
session.append("session/title", { title, messageSeqs: [首条人类消息 seq], source: { kind: "provider", provider: "session-title-first-turn", model } })。宿主按 higher-seq-wins 推给客户端 ⇒ 侧栏自动改名，无需刷新页面。
- 用户手改的名字永不覆盖。
- 失败一律降级为「保持 DSH 自带兜底名」，只记一行
warn，绝不外抛（插件跑在宿主 Node 进程里，抛错会波及整个应用）。
安装
dsh plugin --profile <你的 profile> add dsh-rename-title-after-first-turn
包内声明了 dsh.bundle.patch，所以 dsh plugin 会自动把它记进 dsh.profile.bundles，无需手工编辑 profile 文件。然后重启 DSH（打包版没有「刷新页面」）。
手动兜底（不用 dsh plugin 时）：pnpm add dsh-rename-title-after-first-turn，再在 cordis.patch.yml 追加
- insert:
- id: session-title-first-turn
name: "dsh-rename-title-after-first-turn"
可选：想让本插件独占命名权，同时停用内置的 first-prompt provider（把 - id: session-title-llm + disabled: true 加进 profile 补丁）。包里的 cordis.patch.yml 有这两行的注释版本——默认不启用，因为它会改变别人的默认行为。
配置（profile 那条 insert 的 config，全部可选）
| 键 | 默认 | 允许范围 | 含义 |
|---|
targetCjkCharacters | 12 | 1–60 | 中文目标字数 |
targetWords | 6 | 1–30 | 非中文目标词数 |
maxInputBytes | 8192 | 256–1000000 | 素材字节上限（分数向下取整） |
maxOutputTokens | 2048 | 32–32000 | 输出上限（内置 provider 是 64，疑似被推理 token 吃光 ⇒ 本机 28/30 失败） |
timeoutMs | 60000 | 1000–900000 | 端到端超时；是硬边界（Promise.race），适配器不看 signal 也会返回 |
maxAttempts | 3 | 1–10 | 每个会话最多尝试次数（1 = 只试第一轮）。含「无路由」那种没打到模型的尝试 |
maxTitleBytes | 80 | 8–512 | 落库标题的 UTF-8 字节上限 |
非法/越界值一律回退缺省，不抛错。
兼容性
- 实测环境：DSH 桌面壳
0.1.7-rc.2（Windows）。
- host-only：没有 client 半边 ⇒ 不参与渲染端「每条 client entry 必须 active」的全有全无启动门禁。
- 用到的服务：
llm（ctx.llm.stream）；订阅 session/event、session/disposed。
- 零 npm 依赖、无安装脚本、无构建步骤。
合规（按官方 cordis-plugin-development 对齐）
- bundle 形态：
package.json 声明 dsh.bundle.patch（官方交付单位；缺它 install_bundle 会回滚整次安装）。
- 不 import 任何
@deepseek-ai/* 运行时包（只读 ctx 上的服务）。
- 不 append 新的 session 事件类型：只 append 官方的
session/title，并带 source.kind = "provider"，满足宿主「provider 来源必须 cite 更早的 user 消息」这条不变量。
apply 与所有回调绝不外抛，出错只记一行 warn。
测试
⚠️ 本机沙箱禁止命名管道 ⇒ node --test 会 spawn EPERM 并给出误导性的 # fail 1。逐文件跑（任意 cwd）：
Get-ChildItem test -Filter '*.test.mjs' | ForEach-Object { node $_.FullName; "exit=$LASTEXITCODE $($_.Name)" }
期望合计 47 pass / 0 fail（normalize 5 / first-turn 4 / stream 7 / prompt 10 / guard 7 / plugin-core 14）。
三个变异点（去掉 text 块过滤 / isMainSession 恒 true / messageSeqs 置空）都会让对应断言变红。
已知取舍
- 路由长期不可用 ⇒
maxAttempts 用尽后该会话静默永久放弃（只剩历史 warn 可查）。
- 超时用
Promise.race 保证调用方不被挂住、in-flight 一定释放；被放弃的那次迭代若适配器永不结束，仍会在后台悬着。
attempts / inFlight 只在 session/disposed 时清理（与首方 dsh-session-title 同形）。- 素材信封固定 128 字节：
maxInputBytes < 128 时返回值会略超预算、128 ≤ 预算 ≲ 173 时返回空信封（配置下限 256，正常不可达）。
停用 / 卸载
- 按包名装的：
dsh plugin --profile <你的 profile> remove dsh-rename-title-after-first-turn
- 按绝对路径 insert 装的：从
~\.dsh\profiles\<profile>\cordis.patch.yml 删掉 id: session-title-first-turn 那条 insert
- 两种都要重启 DSH（已加载插件文件的内容改动不热重载）。
English
A host-only DSH plugin that names a main session once, right after its first turn ends — and never touches it again.
- Trigger:
turn/end with turn >= 1. Turn 1 is the first chance; once a title lands the session is frozen (idempotent guard). A failed first attempt may retry up to maxAttempts.
- Main sessions only:
session.header must be an object, parentSession empty, delegationDepth absent or 0. Subagent and teammate sessions are never touched — the predicate is fail-closed, since it is the only guard for that hard requirement.
- Material: the first turn's first human question plus every assistant
text block of turn === 1 (reasoning and tool calls excluded). Retries still feed turn 1 only.
- Persist:
session.append("session/title", …) with source.kind = "provider", so the sidebar renames itself (higher-seq-wins) without a page reload. Manual renames are never overwritten.
- Failures degrade to DSH's built-in fallback name with a single
warn line; apply never throws.
Install
dsh plugin --profile <your-profile> add dsh-rename-title-after-first-turn
The package declares dsh.bundle.patch, so dsh plugin also records it in dsh.profile.bundles — no profile file editing. Restart DSH afterwards.
Config (all optional)
targetCjkCharacters 12 · targetWords 6 · maxInputBytes 8192 · maxOutputTokens 2048 · timeoutMs 60000 · maxAttempts 3 · maxTitleBytes 80. Out-of-range values fall back to defaults instead of throwing.
Compatibility
Tested on DSH desktop 0.1.7-rc.2 (Windows). Uses llm (ctx.llm.stream) and subscribes to session/event / session/disposed. No npm dependencies, no build step, and — being host-only — it takes no part in the renderer's all-or-nothing "every client entry must activate" boot gate.
Tests
Get-ChildItem test -Filter '*.test.mjs' | ForEach-Object { node $_.FullName; "exit=$LASTEXITCODE $($_.Name)" }
Expected: 47 pass / 0 fail. Do not use node --test on Windows sandboxes that forbid named pipes — the runner fails with a misleading # fail 1.
License
MIT
