Initial commit

2026-07-16 15:42:50 +08:00
commit 535b03712e
33 changed files with 7893 additions and 0 deletions
@@ -0,0 +1,59 @@
+# 智能体观测中心
+
+本地多引擎 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`）