最后更新：2026-03-02
| # | 功能 | 说明 |
|---|---|---|
| 1 | 三栏布局（拖拽 resize） | CSS + 鼠标事件，左/中固定宽度，右 flex-1，宽度持久化 localStorage |
| 2 | 左栏可折叠 | 折叠至 48px，CSS transition |
| 3 | 键盘导航 | ↑↓/Enter/Esc// |
| 4 | Shiki 代码高亮 | github-dark 主题，异步加载 |
| 5 | 分页加载 | 50 条/页，累积追加 |
| 6 | SSE 实时刷新 | 列表 + 当前 session 精确刷新 |
| 7 | 全文搜索 | /api/search，限定当前项目，snippet 高亮 |
| 8 | 导出 Markdown | Blob + a download |
| 9 | 复制消息 | hover 出现复制按钮，绿勾反馈 |
| 10 | 日期时间轴分组 | 消息按天分组 |
| 11 | Session 时长/消息统计 | 头部显示 Xh Ym + 用户↑ 助手↓ |
| 12 | JSONL 解析缓存 | mtime 比对 |
| 13 | Codex tool_call 展示 | reasoning / function_call / output |
| 14 | Claude Code tool_use 折叠展示 | ToolUseBlock / ToolResultBlock |
| 15 | 虚拟滚动 | @tanstack/react-virtual |
| 16 | 亮暗主题切换 | ThemeToggle + localStorage + 防 flash |
| 17 | 工具筛选 | 全部 / CC / Codex |
| 18 | 选中状态发光 | emerald 内发光 + 渐变 |
| 19 | 项目卡片 hover 预览 | tooltip 显示完整路径 |
| 20 | 消息气泡工具来源图标 | 助手消息左上角橙/蓝圆点 |
| # | 功能 | 状态 | 说明 |
|---|---|---|---|
| H1 | 日期筛选 + 快捷时间范围 | ✅ | 今天/近7天/近30天/全部；中间栏顶部按钮，前端过滤 |
| H2 | 正在进行中 session 高亮 | ✅ | SSE updated 事件提取 uuid，30s 超时清理；卡片绿色脉冲点 |
| H3 | session 文件变更摘要 | ✅ | 解析 tool_use 提取文件路径，详情头部显示 badge |
| H4 | 快速收藏/书签 | ✅ | localStorage sd-starred；卡片 hover 星标；左栏 ⭐ 收藏入口 |
| # | 功能 | 说明 |
|---|---|---|
| X1 | Token 用量统计 | /api/token-usage；session + 项目维度；ℹ 按钮打开 Modal |
| X2 | 多 session 对比视图 | 卡片 hover 对比按钮；选 2 个后右栏分左右两列并排 |
| # | 功能 | 状态 | 说明 |
|---|---|---|---|
| M1 | 统计图表 | ✅ | Dashboard 页 recharts 折线图（CC/Codex 每日趋势）+ Top5 项目进度条 |
| M2 | Cursor 适配器 | ✅ | better-sqlite3 读 state.vscdb，ItemTable 中提取 chatdata，前缀 csr- |
| M3 | Aider 适配器 | ✅ | 扫描常见开发目录 .aider.chat.history.md，解析 #### human/ai，前缀 adr- |
| M4 | 消息级别书签 | ✅ | localStorage sd-msg-bookmarks；气泡 hover 书签按钮；SessionDetail 跳转入口 |
| M5 | AI 生成 session 摘要 | ⏳ | 需要 ANTHROPIC_API_KEY；/api/summarize/[id]；结果缓存本地 JSON |
| M6 | 工程化发布链路（tsc + npm 发布） | 📝 | git push 前执行 TypeScript 校验；通过 GitHub Actions 自动构建 release 并发布到 npm；安装后可直接用 session-dashboard 命令启动 |
| # | 功能 | 状态 | 说明 |
|---|---|---|---|
| I1 | Session 叙事时间线 | 📝 | 将长 session 自动切分为需求澄清、实现、调试、重构、收尾等阶段，用时间轴展示工作流演进 |
| I2 | 个人 AI 开发画像 | 📝 | 按周/月汇总工具偏好、平均 session 时长、常用项目、典型工作模式，形成可回顾的长期画像 |
| I3 | 效率信号面板 | 📝 | 除 token 外增加修改文件数、工具调用数、持续时长、有效产出等指标，辅助判断投入产出比 |
| I4 | 调试路径回放 | 📝 | 自动识别搜索、读文件、报错、回退、再次修改等调试步骤，生成一次问题解决的路径视图 |
| # | 功能 | 状态 | 说明 |
|---|---|---|---|
| I5 | 自动工作日报 / 周报 | 📝 | 基于指定时间范围内的 session 自动生成完成事项、关键问题、下一步建议，支持按项目聚合 |
| I6 | Session 复盘助手 | 📝 | 每次 session 结束后生成复盘结论：做成了什么、卡点在哪里、如果重来可以如何更快 |
| I7 | 跨 Session 知识合并 | 📝 | 将多次相关 session 聚合为同一主题脉络，展示某个功能或问题在多天内的连续演进 |
| I8 | 下一步行动建议 | 📝 | 对未完成或中断的 session 给出建议动作，例如补测试、继续排查报错、整理重构收尾 |
| # | 功能 | 状态 | 说明 |
|---|---|---|---|
| I9 | 项目演进故事板 | 📝 | 把一段时间内的关键 session 串成可展示的故事板，适合汇报、复盘或作品集展示 |
| I10 | 可分享的只读快照 | 📝 | 导出脱敏后的 session / 项目只读页面，支持隐藏路径、敏感命令和潜在凭证片段 |
| I11 | 团队维度看板 | 📝 | 为未来多人场景预留：按成员、项目、问题类型汇总 AI 使用情况和热点分布 |
| I12 | Demo / 展览模式 | 📝 | 用更强视觉化的布局展示最近一段时间的人机协作轨迹，适合作为产品亮点页或演示页 |
| 阶段 | 优先项 | 说明 |
|---|---|---|
| 近期 | 自动工作日报 / 周报、个人 AI 开发画像 | 最容易建立“每天都值得打开”的使用价值，且可复用现有 session / token / 项目聚合能力 |
| 中期 | Session 叙事时间线、Session 复盘助手 | 明显提升智能感与产品差异化，让 Dashboard 从记录器升级为复盘工具 |
| 远期 | 项目演进故事板、可分享的只读快照 | 强化对外展示与协作能力，更适合成为大版本亮点功能 |
| # | 功能 | 状态 | 说明 |
|---|---|---|---|
| E1 | 发布前 TypeScript 守门 | 📝 | 在 git push 前通过 hook 强制执行 tsc --noEmit，避免未通过类型检查的改动进入远端 |
| E2 | GitHub Actions 自动发布 npm | 📝 | 基于 tag 或 release 触发 CI，执行安装、测试、构建、打包并发布到 npm 仓库 |
| E3 | 全局 CLI 启动入口 | 📝 | 提供 npm package 的 bin 命令，安装后可直接运行 session-dashboard 启动本地服务或打开 UI |
| 状态 | 问题 | 位置 |
|---|---|---|
| ✅ | JSONL 解析缓存 | lib/adapters/claude-code.ts |
| ✅ | Chokidar graceful shutdown | app/api/watch/route.ts |
| ✅ | React.memo for MessageBubble | MessageBubble.tsx |
| ✅ | 拖拽宽度持久化 | app/sessions/page.tsx |
| ✅ | JSON 本地索引层 | ~/.session-dashboard/index.json；mtime 增量更新；POST /api/index/rebuild 强制重建 |
| ✅ | Session ID 去重合并策略 | getSessions() 按 lastActivity 去重，getSession() 合并多文件消息 |