60+ AI 编码代理的会话检索与成本统计：AgentsView 上手指南-育师

60+ AI 编码代理的会话检索与成本统计：AgentsView 上手指南

【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview

半夜又遇到一个调试了半天才修好的报错，你隐约记得几周前解决过一次，却翻不到那次对话在哪里。AgentsView 把散落在各处的 AI 编码代理会话汇成一个本地检索库，一次装好就能做会话检索与成本统计，数据始终留在你自己的机器上。

它解决什么问题

会话散落在十几个目录里。Claude Code 存在~/.claude/projects/，Cursor 在~/.cursor/projects/，Codex 又在~/.codex/sessions/。想回忆"上次那个部署失败是怎么修的"，只能在每个工具的历史记录里挨个翻，时间越久越找不到。

花费算不清楚。多个代理、多个模型各自计费，月底想核对每个模型烧了多少 token、哪几天开销异常，没有现成的跨代理口径，只能对着账单猜。

工作模式看不见。代理到底在什么时段跑得最密集、有没有大量时间耗在长会话里反复试错、缓存是否真的省了钱，凭感觉回答不了。

快速上手

安装只保留两条路径：一键脚本和源码构建。macOS 与 Linux 用主路径：

curl -fsSL https://agentsview.io/install.sh | bash

Windows 用户可在 PowerShell 里执行irm https://agentsview.io/install.ps1 | iex。想自己编译的话，备份路径是克隆仓库后执行make build && make install（源码构建需要 Go 1.27+ 与 Node.js）。

跑通只需要一条命令：

agentsview serve

首次运行会自动发现本机所有受支持代理的会话目录，把 JSONL 会话文件解析进本地 SQLite 数据库~/.agentsview/sessions.db，并在http://127.0.0.1:8080打开 Web 界面。你会直接看到跨代理的会话列表、成本趋势图和活跃度视图，不需要任何配置文件。

核心能力

🔍 会话检索：全文与语义双引擎

全文搜索覆盖所有消息内容，基于 SQLite FTS5 索引并带中日韩分词支持，几个月后讨论某个报错的对话也能秒级定位
语义搜索为可选开关，接入任意 OpenAI 兼容的 embedding 端点后按"意思"匹配，每个结果都标注出处对话片段，配置见 docs/semantic-search.md
键盘优先导航（j/k切换、Cmd+K全局搜索），活跃会话通过 SSE 实时推送新消息，会话可一键导出为 HTML

📊 成本与时间分析：预建索引，查询不用重解析

agentsview usage daily输出近 30 天每日成本汇总，--breakdown按模型拆分，usage statusline给出一行摘要可直接嵌入 shell 状态栏
定价自动采用 LiteLLM 与 OpenRouter 费率（含离线回退），并做提示缓存感知的成本计算；单会话用agentsview session usage <id>查看 token 与费用
agentsview activity report --preset week --json给出峰值并发、活跃时长与代理分钟数，Web 端还有按项目、代理、机器过滤的活动仪表板
agentsview stats输出会话原型分布（快问快答/标准/深度/马拉松）、时长分布与缓存经济学等窗口统计

🔌 历史扩展：MCP 服务器与多后端协作

agentsview mcp启动一个只读 MCP 服务器，向助手客户端暴露 16 个工具（检索会话、读取消息、汇总用量、查询质量信号等），让助手在对话里回答"这个错以前解决过吗"，工具清单见 docs/mcp.md
多机协作不必上 PostgreSQL：session_sources配置即可把其他机器的原生会话目录汇入主实例
可选后端：pg push把数据推送到共享 PostgreSQL 供团队只读查询，duckdb push生成便携的 DuckDB 分析文件，两者都保持本地 SQLite 为主存档

一条完整工作流

早上agentsview sync补一次增量（守护进程的文件监听平时已自动同步新消息）。打开 Web 界面搜索"deploy failed"，全文索引直接返回上个月讨论该问题的两条对话。从命中的会话里用session usage看它花了多少 token，再用usage daily核对本周总花费。写代码时，编辑器里的助手通过 MCP 服务器查询历史，回答"这个报错以前怎么修的"并附出处消息。周末用agentsview activity report --preset week回顾各代理的时间分布，顺手pg push --watch让团队共享库保持最新。

兼容与生态

维度	支持范围
编码代理	60+ 款（Claude Code、Codex、Cursor、Gemini CLI、Windsurf、Qwen Code、Kimi 等），Aider 需设置`AIDER_DIR`启用
存储后端	SQLite 主存档；PostgreSQL 团队共享；DuckDB 镜像；ClickHouse 推送
平台	macOS / Windows / Linux 的 CLI，以及 Tauri 桌面应用（自动更新，与 CLI 共享`~/.agentsview/`）
界面语言	含简中、繁中、日、韩、西语在内的 8 种

覆盖范围随版本持续扩展，各代理的目录约定与覆盖限制见 docs/configuration.md。

隐私与安全边界

全部会话数据留在本地~/.agentsview/，服务器默认只绑定127.0.0.1
唯一外发数据是极简的匿名daemon_active遥测（不含会话、项目或文件路径），AGENTSVIEW_TELEMETRY_ENABLED=0可整体关闭
更新检查是可选行为，--no-update-check可禁用
若需把 UI 暴露到 loopback 之外，应同时启用--require-auth