📊 agentprof 可视化指南

用 Rust 写的开源 token profiler — 给 AI agent 用的 perf flamegraph + ROI 报告器。

从 cargo install 到第一次跑 analyze — 5 分钟跑出第一张火焰图。

5 种 export 格式怎么挑 — md / tui / html / json / speedscope；如何读 Turn Summary、Tool Rank、Cache 段。

不止看一次 session — list 最近 sessions、aggregate 跨 model / tool / day 聚合，看 7-30 天 token 趋势。

从 grep + cron 升级到 Grafana — agentprof serve 拉起 localhost HTTP 看板，5 个视图 5 秒轮询自动刷新。

从 grep 单文件到 SQLite 持久化 + OTLP push gateway — 接入 Claude Code / Codex 实时数据。

5 crate 依赖图 + L1/L2/L3 文档体系 + 24 份 ADR 索引 — 整个项目的全景图。

Event → Episode → AnalysisReport 三层关系 + 关键字段表 — agentprof 数据流的核心类型。

Adapter trait 接口 + AgentKind 枚举 + CopilotAdapter 案例 + 写 Claude / Codex adapter 的 6 步指南。

analyze() 流水线 + turn_summary / tool_rank / hook_rank / CacheMetrics 公式 + MCP waste 计算 — agentprof 的核心 ROI 算法。

ADR-0019 hybrid cache/store + SQLite schema (sessions / tools_loaded / turn_buckets) + dual-path 选择 — agentprof 怎么持久化 session 数据。

ADR-0021 架构 (receiver → router → buffer → flush sink → upsert → SQLite) + ADR-0022 4 层防御 (subtle 常时间 bearer / per-signal size caps / LRU cap=1024 / 256-byte session.id 上限)。

ADR-0024 全 7 决策 (D-1..D-7) + chunk-endpoint pattern + axum + askama + vanilla JS poller — agentprof serve 的实现全景。

Conventional Commits + 9 阶段 pipeline (brainstorming → spec → ADR → plan → TDD → CI → review) + 怎么开 PR / 加 ADR / 通过 CI。