会话标题Session Titler

1. 点入口，只打开弹窗Clicking an entry only opens the dialog

   按钮与菜单项都调 store.open({ sessionId, currentTitle })；空白会话在按下之前就已经置灰，不会发请求。Both the button and the menu item call store.open({ sessionId, currentTitle }); an empty session is already disabled before you can press it, so no request goes out.

2. 一次只读的提案请求One read-only proposal request

   Client 发 POST /session-titler/propose { sessionId }；Host 读模型表面、选路由、组 transcript，再走 ctx.llm.stream({ …, purpose: 'session-title' })（优先 llm.stream，兜底 llm.prepareCall）。The client sends POST /session-titler/propose { sessionId }; the host reads the model surface, picks a route, builds the transcript, then calls ctx.llm.stream({ …, purpose: 'session-title' }) — llm.stream first, llm.prepareCall as the fallback.

3. 弹窗给你一份可改的提案The dialog hands you an editable proposal

   拿回 { ok:true, value:{ title, provider, model, fallback, messages, truncated } }，连同实际使用的模型一起显示。这时会话日志还没有任何变化。It gets back { ok:true, value:{ title, provider, model, fallback, messages, truncated } } and shows it together with the model actually used. At this point the session log is still untouched.

4. 确认才写入Confirming is what writes

   点「确认修改」→ ctx.sessions.using(id, { source:'workspaceOperation' }, ref => ref.binding.session.rename(title))，与官方「重命名」菜单同一条路径。“Apply” runs ctx.sessions.using(id, { source:'workspaceOperation' }, ref => ref.binding.session.rename(title)) — the same path as the official Rename menu command.

5. Host 追加标题事件The host appends a title event

   写入 session/title 事件（source: user）；左侧列表标题立即刷新，刷新页面也还在。A session/title event is appended (source: user); the sidebar title updates immediately and survives a page refresh.

顶栏按钮 / 会话行菜单
      │  store.open({ sessionId, currentTitle })
      ▼
Client store ──POST /session-titler/propose { sessionId }──► Host 路由（只读）
      ▲                                                      ├─ sessionQuery.readSurface(sessionId)
      │                                                      │    当前「模型表面」（已考虑压缩 / 替换）
      │                                                      ├─ 组装 transcript（32 KiB 预算，条目级截断）
      │                                                      ├─ 路由候选（新 → 旧）：requestHeader().config
      │                                                      │    → 日志每条 request/header → agentDefaultModel
      │                                                      │    候选须在 llm.listProviders() 里（探测失败不过滤）
      │                                                      └─ ctx.llm.stream({ …, purpose: 'session-title' })
      │  { ok:true, value:{ title, provider, model, fallback, messages, truncated } }
      ▼
确认弹窗（标题可编辑，「重新生成 / 取消」）
      │ 点「确认修改」
      ▼
ctx.sessions.using(id, { source:'workspaceOperation' }, ref => ref.binding.session.rename(title))
      ▼
Host 追加 session/title 事件（source: user）→ 列表标题刷新，刷新页面仍保持

卸载：dsh plugin --profile <profile> remove dsh-session-titler，或在插件页停用 / 卸载。Uninstall with dsh plugin --profile <profile> remove dsh-session-titler, or disable/uninstall it from the Plugins page.