Agent Summary

Agent 摘要台（agent-summary）

扫描本机 AI 编程 Agent（Claude Code / Codex CLI / ZCode）的会话记录，落库到 SQLite， 提取重要内容（关键决定、待办、涉及文件），用 LLM（可选）生成每日总结，并导出 Markdown 日报到指定文件夹。 自带一个深色 IDE 风格的本地 Web 界面。

功能

• 多来源扫描：读取 11 类本地会话数据，无需 hook、不改变 Agent 行为
  • Claude Code：~/.claude/projects/**/*.jsonl
  • Codex CLI：~/.codex/sessions/**/rollout-*.jsonl
  • ZCode：~/.zcode/cli/db/db.sqlite（只读）
  • Pi：~/.pi/agent/sessions/**/*.jsonl
  • Hermes：~/.hermes/sessions/*.jsonl 与 session_*.json（含 cron 定时会话）
  • OpenCode：~/.local/share/opencode/opencode.db（只读）
  • Kimi CLI：~/.kimi/sessions/**/wire.jsonl
  • Gemini CLI / Qwen Code / iFlow CLI：~/.gemini、~/.qwen、~/.iflow 的 tmp//chats/session-.json
  • OpenClaw：~/.openclaw（内部为 pi 格式会话，跑起来后自动收录）
  • 自报 Inbox：~/.agent-summary/inbox/*.jsonl（agent 主动写入的结构化摘要，最高信任级）
  • 未安装的来源自动为空；路径都可在设置页修改或关闭
• 落库：会话表 + 消息表 + 每日总结表（SQLite，位于 data/），重复扫描自动去重
• 重点提取：规则引擎（无 LLM 也可用）从会话中抽「关键决定 / 待办 / 涉及文件」
• LLM 日总结（可选）：配置任意 OpenAI 兼容接口（GLM / DeepSeek / OpenAI…）， 一键生成「今日总结 + 要点 + 跨会话决定 + 待办 + 风险」；调用失败自动退回规则提取
• 导出：把某天的日报写成 {输出文件夹}/agent-summary-YYYY-MM-DD.md，文件夹在设置里指定
• 界面：日期导航、按 Agent 过滤、会话列表、消息时间线（工具调用可展开）、设置页
• 自动化：服务运行中按间隔自动扫描当天；命令行可挂 cron

快速开始

npm install

# 开发模式（服务 :8787 + 前端 :5175）
npm run dev

# 或生产模式：构建后单进程运行（页面由 :8787 直接托管）
npm run build
npm start

打开 http://localhost:8787 （开发模式打开 http://localhost:5175）。

首次使用建议在「设置 → 数据来源」点一次 **全量导入历史会话**，之后每天增量扫描即可。

命令行 / 定时任务

全局安装一次（`npm run build && npm link`），之后任何 agent/终端都能用 `asum`：

asum search "关键词"              # 全文搜索历史会话与消息（FTS5 trigram，<50ms）
asum day [YYYY-MM-DD]            # 某天日报
asum session   # 会话完整时间线
asum context                     # 记忆块：最近日报+决定+待办（供 agent 注入）
asum scan --summarize --export   # 扫描 + 总结 + 导出（--day 指定日期，--all 全量导入）
asum backfill-days               # 重刷全部历史日报
npm run mcp                      # MCP server（stdio）

挂 crontab（每天 21:30 自动总结并导出）：

30 21 * * * cd /path/to/agent-summary && npm run cl