Skip to content

feat(session): 从首个用户消息提取 Session 标题并在 Dashboard 展示#245

Merged
ThreeFish-AI merged 2 commits into
feature/1.x.xfrom
ThreeFish-AI/session-title-from-first-message
May 25, 2026
Merged

feat(session): 从首个用户消息提取 Session 标题并在 Dashboard 展示#245
ThreeFish-AI merged 2 commits into
feature/1.x.xfrom
ThreeFish-AI/session-title-from-first-message

Conversation

@ThreeFish-AI

@ThreeFish-AI ThreeFish-AI commented May 25, 2026

Copy link
Copy Markdown
Owner

变更内容

Dashboard 的 Sessions 页面原本仅通过机器生成的 session_key 标识会话,用户难以直观识别每个会话对应的任务内容。本 PR 从 Claude Code 首次请求的首个 user 消息中提取文本(截取前 30 字)作为会话标题,并在 Dashboard 中展示。

核心变更

  1. 持久化层 (logging/db.py):新增 session_meta 表存储 session 级标题元数据,提供 set_session_title()(幂等写入)和 get_session_titles()(批量查询),query_recent_sessions() 自动关联标题返回
  2. 标题提取 (routing/executor.py):新增 _extract_session_title() 从规范化请求中提取首个 user 文本;session_manager.pyget_or_create_record() 返回 (record, is_new) 元组标识首次会话;usage_recorder.py 增加代理方法透传标题设置
  3. Dashboard UI (server/dashboard.py):Sessions 列表新增 Title 列(15% 宽度),展开详情行同步展示,标题为空时显示 占位
  4. 测试适配 (tests/test_router_executor.py):更新 get_or_create_record() 返回值解构,全部 1464 测试通过

设计决策

  • 独立 session_meta(非 compat_session TTL 表、非 usage_log 冗余列):兼顾持久性与职责正交,避免标题随 session 过期丢失或每行请求记录冗余存储
  • INSERT OR IGNORE 幂等写入:标题仅在首次请求时设置,后续请求不覆盖
  • 批量查询合并:聚合查询后一次性查标题合并到结果,API 层零改动透传

Test Plan

  • 单元测试验证标题提取:正常消息、超长截断(30 字)、空消息、assistant/user 混合消息
  • 现有 1464 测试全部通过,已适配返回值变更
  • 启动服务后发送 CC 请求,验证 Dashboard Sessions 页 Title 列显示正确

- 新增 session_meta 表持久化 session 级标题元数据
- 检测新 session 时从首个 user 消息提取文本截取前 30 字作为标题
- get_or_create_record() 返回 is_new 标志标识首次会话
- Dashboard Sessions 列表新增 Title 列,展开详情同步展示
- 更新相关测试适配返回值变更

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI ThreeFish-AI merged commit 83684fe into feature/1.x.x May 25, 2026
6 checks passed
@ThreeFish-AI ThreeFish-AI deleted the ThreeFish-AI/session-title-from-first-message branch May 25, 2026 08:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant