fix(Session): 会话标题无语义占位符根治——质量门禁 SoT + prompt 去双用 + history 增强 + 存量回填 CLI

[ThreeFish-AI]

背景

Home / Studio 页 Session 列表中大量会话标题为无语义占位符（如「首次标题」「标题 v2」「会话标题自动生…」，截图实证「首次标题」重复 6 次），用户无法一眼看出对话内容。

根因（全链路排查确认）

非调度未触发——反应式 append_event → _schedule_title_generation 与巡检 session_title_inspect（enabled=True、300s）双路径均在跑。真正根因是「触发了但生成质量差」+「存量坏标题无法自愈」：

1. Prompt 双用缺陷：generate_title 把同一份指令文本同时塞进 system_instruction 与追加到 contents 末尾的 user message，弱模型在 history 文本稀薄时把「指令本身」当对话内容描述，输出元描述性标题；prompt 无 few-shot、无元词汇禁止。
2. 后处理质量门禁极弱：只 strip/截长度，无法识别并拒绝此类标题。
3. history 提取不充分：只取最近 6 条事件的 text part，长会话丢失首条主题消息、工具密集会话 text 极少。
4. 存量坏标题卡死：写回 title_source=auto 后，巡检刷新条件 max_seq - gen_seq >= 20 对短会话永不可达，叠加 _title_skip_reason 的 already_titled，坏标题无任何自愈路径。

生产代码无占位符字面量/无 mock 泄漏，失败时只累加计数不写 title，故这些坏标题确为 LLM 实际生成并写回 DB。

改动（生成质量门禁 + 存量治理两块闭环）

生成质量侧（源头根治）

• summarization.py：新增模块级纯函数 is_semantically_vacant_title 作为标题质量门禁单一事实源（SoT）——黑名单正则 + 剥离元词汇后实质 <3 + 复述指令检测；generate_title 后处理接入，命中返回 None（宁可不写也不写无语义标题）；重构 prompt 消除双用（system 承载全部指令含 few-shot + 元词汇禁止，contents 仅末尾极简触发句）。
• session_service.py：_generate_title_for_session 的 history 改为「首条 user + 最近 6 条」去重合并、保守纳入 functionCall/functionResponse 可读摘要、有效文本 <8 字符 return。

存量治理侧（清理卡死的坏标题）

• cli_backfill_titles.py（新增）+ cli.py：一次性回填 CLI negentropy backfill-session-titles——keyset 分页扫描 auto 标题、Python 侧复用 SoT 判 vacant、清空 title 及溯源字段、per-session advisory lock + UPDATE WHERE 二次校验 title_source='auto' 护栏、默认 dry-run、永不碰 manual/legacy、严禁 DELETE；交巡检下一 tick 自然重新生成。

验证

• test_summarization.py 38 例（含 35 条门禁表驱动，覆盖截图所有坏标题字面量 + 回归保护用例）全绿。
• test_session_title.py（+2 新增：首条消息保留 / 低内容跳过）、test_title_inspector.py、test_title_source.py、test_session_hard_delete.py 共 71 例全绿。
• CLI 端到端实测：dry-run 命中 6 条（含泛化识别「唯一标题」，证明规则 2 的泛化能力）；--apply --limit 2 成功清空并结构化日志 backfill_title_cleared，advisory lock + 护栏无报错。
• Ruff lint + format 全过；pre-commit hooks 全过。

部署时序（运维侧，不进本 PR）

1. 本 PR（生成侧门禁）合并部署到 live；
2. 运维执行 uv run negentropy backfill-session-titles（dry-run 评估 → 灰度 --user/--limit → 全量 --apply）；
3. 硬约束：门禁必须先于 --apply 上线，否则清空后巡检仍会再次生成坏标题。

关联

• issue 摘要：docs/.agents/issue.md ISSUE-151。
• 不改 model_resolver.py 硬编码默认（影响面过大）、不改 Thread.metadata_ 形状、不改前端 fallback 行为（Session <id> 兜底正确）。

🤖 Generated with Claude Code, CodeX, Gemini
Co-Authored-By: Aurelius Huangthreefish.ai@gmail.com