# 智能体观测中心

本地多引擎 AI 会话管理工具 — 浏览、搜索、复制恢复命令，支持 **Codex · Claude · Agy** 三引擎。

## 快速开始

```bash
# 安装依赖
npm run install:all

# 启动开发环境（后端 :3721 + 前端 :3722）
npm run dev
```

> **端口冲突**：后端 3721 被占用时会启动失败（需先释放端口）；
> 前端端口被占用时会自动切换到下一个可用端口（3723、3724 ...），
> 终端日志会显示实际端口。

```bash
# 生产构建
npm run build
npm start
```

## 功能

- **三引擎会话列表** — 按引擎筛选（全部/Codex/Claude/Agy），搜索 ID、短 ID、路径、摘要
- **会话详情** — 引擎专属元数据、消息时间线、工具调用统计
- **短 ID 解析** — 输入部分 ID（如 `019f448b`）自动匹配
- **一键恢复** — 复制引擎对应的恢复命令（`codex resume` / `claude --resume` / `agy --conversation`）
- **工具排行** — 全引擎工具调用聚合排行，附技能/插件/缓存清单
- **效能分析** — 会话趋势图、状态分布、异常率
- **移动端适配** — 390px ~ 2560px 响应式布局

## 数据来源

| 引擎 | 数据位置 | 会话数 | 恢复命令 |
|---|---|---|---|
| Codex | `~/.codex/state_5.sqlite` + `sessions/` | ~560 | `codex resume <id>` |
| Claude | `~/.claude/projects/**/*.jsonl` | ~170 | `claude --resume <id>` |
| Agy | `~/.gemini/antigravity-cli/conversation_summaries.db` | ~80 | `agy --conversation <id>` |

## API

| 路径 | 说明 |
|---|---|
| `GET /api/health` | 服务状态 + 三引擎健康 |
| `GET /api/sessions?engine=all\|codex\|claude\|agy` | 会话列表 |
| `GET /api/sessions/:engine/:id` | 会话详情 |
| `GET /api/sessions/:engine/:id/tools` | 会话内工具统计 |
| `GET /api/tools?engine=...` | 全局工具排行 |
| `GET /api/resolve/:prefix?engine=...` | 短 ID 解析 |
| `POST /api/refresh` | 刷新缓存 |

## 环境变量

- `CODEX_HOME` — Codex 根目录（默认 `~/.codex`）
- `AGY_DATA_DIR` — Agy 数据目录（默认 `~/.gemini/antigravity-cli`）
- `PORT` — 后端端口（默认 `3721`）