内容
# quickai
**Claude 代码分析工具.** 精确查看您的 tokens、资金和时间花费情况 —
按任务、子代理、模型分类 — 直接从 Claude Code 已写入磁盘的记录中获取。无需任何监控或遥测数据，不会离开您的机器。
大多数 Claude Code 用户都使用**固定订阅**，因此 quickai 主要关注 **tokens**（和时间），而不是美元。 `$` 符号表示 **API 等价值**（这些 tokens 按需付费的成本）— 用于衡量**数据量和投资回报率**，而不是账单。
- **资金/tokens 花费情况** — 任务、项目、模型、代理类型排行榜
- **时间花费情况** — 实际时间 vs 空闲时间，按任务时间线划分，"为什么运行缓慢？"
- **行为分析** — 工具使用率和错误率、缓存命中率、任务循环、浪费资源
- **项目报告** 和独立的 **HTML 报告**，可在浏览器中打开
- **MCP 服务器** — 直接在聊天中询问上述问题
---
## 1. 安装
### Homebrew（macOS / Linux）
```sh
brew install AlexGladkov/tap/quickai
```
### 作为 Claude Code 插件（添加 MCP 服务器，可在聊天中提问）
```shell
/plugin marketplace add AlexGladkov/claude
/plugin install quickai@alexgladkov
```
插件注册了 `quickai` MCP 服务器，因此您只需在聊天中说 *"分析 my-app 项目"* 即可。它调用 `quickai` 二进制文件 — 请先安装它（使用上面的 Homebrew 或 `cargo install --git https://github.com/AlexGladkov/quickai`），确保它在您的 `PATH` 中。
> 为 Apple Silicon 预编译（约 1 秒安装）；Intel-mac / Linux 从源代码编译（需要 Rust）。
### 从源代码编译
需要 **Rust**（1.75+）。SQLite 已捆绑 — 无需系统依赖。
```sh
git clone https://github.com/AlexGladkov/quickai.git
cd quickai
cargo build --release
# 二进制文件：./target/release/quickai （可选：cp 到 ~/.local/bin）
```
### 首次运行
从 `~/.claude/projects/**/*.jsonl` 构建索引：
```sh
quickai index
```
索引存储在 `~/.claude/quickai.db`（纯粹从记录中导出 —
可以随时删除并重新构建）。重新运行 `index` 以获取最新数据；它是**增量式**的（仅读取更改文件的尾部）。
---
## 2. 示例
```sh
# 总体统计（tokens 优先，$ 为 API 等价值）
quickai stats
# 您的实际提示，按 tokens 排名
quickai tasks --by tokens --limit 20
# 为什么运行缓慢？实际时间 vs 空闲时间
quickai slow
# 生成完整的 HTML 报告并在浏览器中打开
quickai report
# 单个项目的报告
quickai report --project my-app
```
`quickai stats` 输出:
```
quickai — 索引摘要
项目： 18
会话： 97
任务： 3182
子代理： 1988 （已解析类型为 981 — 49%）
轮次： 185699
── tokens ──
总计： 40709.4M （输入+输出+缓存）
新鲜（输入+输出）： 135.2M
输入： 31.4M
输出： 103.8M
缓存读取： 39461.8M （96% 吞吐量 — 上下文重新读取）
≈ API 等价值： $32042.66 （列表价格；订阅为固定 — 此为数据量，非账单）
```
---
## 3. 截图
**报告 — 摘要和分类**（深色 Notion 风格主题，项目名称在顶部）：
**行为分析** — 工具错误率、缓存命中率、任务循环、浪费资源、缓慢任务
（问题数量一目了然）：
**按任务细分** — 点击任意任务以展开其子代理，显示成本/轮次/实际时间：
---
## 4. 您可以使用
### CLI 命令
| 命令 | 显示内容 |
|---|---|
| `quickai index [--rebuild]` | 构建/刷新索引（增量式） |
| `quickai stats` | 总体统计 — tokens、子代理、API 等价值 |
| `quickai tasks [--by time\|tokens\|cost] [--project X]` | 您的提示，按分类显示 |
| `quickai usage` | 终端单屏报告（分页） |
| `quickai report [--project X]` | **HTML 报告** → 浏览器（可选按项目） |
| `quickai top --group task\|agent\|agenttype\|project\|model` | 最高消费者 |
| `quickai task <promptId>` | 单个任务：主代理 + 所有子代理 + 计时 |
| `quickai bench <agentType>` | 随时间变化的单个代理类型 |
| `quickai cache` | 会话的缓存命中率（查找缓存冲突） |
| `quickai latency` | 模型轮次延迟 + 子代理并行因子 |
| `quickai spin` | 任务循环（多轮，低输出/轮） |
| `quickai tools` | 工具使用率和错误率 |
| `quickai waste` | `stop_reason` 分布（截断，拒绝） |
| `quickai slow` | 按实际时间 + **空闲百分比** 排列的缓慢任务（为什么运行缓慢） |
| `quickai mcp` | 运行 MCP 服务器（标准输入/输出） |
### HTML 报告包含
摘要卡片 · 按模型/项目/代理类型分类 · 工具配置文件 · 延迟 · 并行度 ·
缓存命中率 · 任务循环 · 浪费资源 · **缓慢任务及其空闲百分比** · 以及每个任务的可搜索、排序表格和可展开的子代理分解。
### MCP（在聊天中提问）
```sh
claude mcp add quickai -- /absolute/path/to/target/release/quickai mcp
```
然后询问诸如 *"分析 **my-app** 项目"*、*"本周消耗最多的是什么"*、
*"分解任务 X"*、*"为什么运行缓慢"*。大多数工具都接受 `project` 过滤器，因此 "分析此项目" 直接生效。工具：`quickai_stats`、`quickai_top`、`quickai_tasks`、
`quickai_usage`、`quickai_task`、`quickai_bench`、`quickai_cache`、`quickai_latency`、
`quickai_spin`、`quickai_tools`、`quickai_waste`、`quickai_slow`。
---
## 备注
- **资金** 是 API 等价值（列表价格 × tokens），不是账单 — 在订阅中，
没有按 token 计费。 这是一个数据量/投资回报率信号。
- **无 "% of subscription capacity"** — Anthropic 不公布固定的 token 限制
（限制是分窗口和计量不透明的），因此任何此类百分比都是虚构的。
- **目前仅支持 Claude Code**。核心（模式、查询、报告）是源代码无关的 —
只有解析层是 Claude 特有的，因此可以通过适配器添加其他 CLI。
架构和数据模型：[ARCHITECTURE.md](ARCHITECTURE.md).
## License
MIT — 见 [LICENSE](LICENSE).
