dsh-rename-title-after-first-turn
DSH 仅主机插件：在主会话首次回合结束后为其命名一次。子代理和队友会话不受影响。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:apherchin/dsh-rename-title-after-first-turn#059625a52ff61648318f236771282694bcf8c2eaRename Title After First Turn 以 dsh-rename-title-after-first-turn 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
主会话「第一轮对话结束后，自动总结命名一次」的 host-only DSH 插件（不改 app.asar，无 client 半边）。
⛔ 已退役（2026-10-04）· Retired
中文：DSH 0.2.0 起，会话标题变成可插拔提供方 seam（
ctx.sessionTitle.register(provider)）， 官方随包就带提供方；本插件原先靠"停用官方 provider + 自己 appendsession/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 profileinsertis commented out and the officialsession-title-llmprovider 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 推给客户端 ⇒ 侧栏自动改名，无需刷新页面。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有这两行的注释版本——默认不启用，因为它会改变别人的默认行为。
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 字节上限 |
非法/越界值一律回退缺省，不抛错。
0.1.7-rc.2（Windows）。llm（ctx.llm.stream）；订阅 session/event、session/disposed。cordis-plugin-development 对齐）package.json 声明 dsh.bundle.patch（官方交付单位；缺它 install_bundle 会回滚整次安装）。@deepseek-ai/* 运行时包（只读 ctx 上的服务）。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 同形）。maxInputBytes < 128 时返回值会略超预算、128 ≤ 预算 ≲ 173 时返回空信封（配置下限 256，正常不可达）。dsh plugin --profile <你的 profile> remove dsh-rename-title-after-first-turn~\.dsh\profiles\<profile>\cordis.patch.yml 删掉 id: session-title-first-turn 那条 insertA host-only DSH plugin that names a main session once, right after its first turn ends — and never touches it again.
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.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.text block of turn === 1 (reasoning and tool calls excluded). Retries still feed turn 1 only.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.warn line; apply never throws.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.
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.
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.
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.
MIT