首页 / 开源热榜 / AgentsView / 使用教程

AgentsView 中文教程：先建立一份可检查的本地会话档案

官方资料核对：2026-09-23 · 文档核对，未下载或运行二进制

AgentsView 把 Claude Code、Codex 等编码代理留下的本地会话解析到 SQLite，再用 Web、桌面端、CLI、REST API 和 MCP 查询同一份档案。它适合找回历史和看成本，不负责替代理执行代码任务。

当前版本：官方 README 在 2026-09-23 标明 latest release 为 v0.44.0。搜索缓存中的 Release 页面仍可能显示更早的 v0.39.0；安装后应先运行 agentsview version，再读对应 tag 的变更说明。

1. 选择容易核对的安装方式

macOS 可以从 Homebrew cask 开始：

brew install --cask agentsview

CLI 还可用 pip install agentsview 或 uvx agentsview。Windows、Linux 和其他架构可从 GitHub Releases 下载桌面包或压缩包。官方 shell installer 会下载 release 并验证 SHA-256，但执行远程脚本前仍应先保存并阅读内容。

从源码构建的当前要求是 Go 1.27+、CGO 和 Node.js 22+。CGO 用于 SQLite 驱动，全文搜索还需要 fts5 build tag；普通用户没有必要为了试用而走源码构建。

2. 第一次只开放一个测试目录

会话日志可能包含提示词、代码、命令输出、文件路径，甚至误写入的凭据。先准备一个内容可检查的测试会话目录，让 AgentsView 只看到这部分。Docker 方案更直观：容器只能读取你显式挂载的目录，而且官方示例使用只读挂载。

确认解析结果和字段符合预期后，再加入真实的 Claude Code、Codex 或其他代理目录。集中索引虽然方便搜索，也会把原本分散的数据放进一个数据库，所以本机文件权限和备份策略要一起处理。

3. 在本机启动并看第一份报告

agentsview version
agentsview serve
# 浏览器打开 http://127.0.0.1:8080
agentsview session list
agentsview usage daily

首次运行会发现支持的会话目录、同步到 SQLite，并启动本地界面。列表里先核对代理、项目和工作目录是否正确，再看 daily 报告。费用有时来自上游日志，有时由 token 与价格表估算；用同一段时间的原始记录或供应商账单抽查，才能知道误差。

4. 默认本地不等于所有功能都不联网

服务器默认绑定 127.0.0.1，SQLite 是本地事实源。官方也说明 daemon 默认每 24 小时发送一次不含会话内容的匿名存活事件，可这样关闭：

export AGENTSVIEW_TELEMETRY_ENABLED=0
agentsview serve

PostgreSQL/DuckDB 镜像、远程访问、GitHub 发布、托管 raw sync 和 Generated Insights 都会改变数据边界。若要从其他设备访问，应在配置中启用 require_auth = true，再改变监听地址，并把反向代理、TLS 和防火墙一起纳入检查。

5. 相比 ccusage，应该选哪个

ccusage 是一次性本地报表 CLI，直接读取现有日志，重点是 daily、weekly、monthly、session 与成本计算模式，官方强调只读且不上传。AgentsView 增加了常驻 daemon、SQLite、完整会话搜索、Web/桌面界面、API、MCP 和镜像后端。只想在终端看 token 与费用，ccusage 更轻；需要跨代理检索长期档案，再承担 AgentsView 的存储与权限维护。

6. 验证状态与验证边界

验证状态：本轮只阅读官方仓库、Quick Start、使用指南、远程访问、架构概览、许可证和 Releases。未下载、安装或运行 AgentsView。

未验证：自动发现覆盖率、各代理解析正确率、成本精度、迁移与自动更新、Docker 卷、远程鉴权、MCP、遥测关闭和大数据量性能。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

近期变化与关注原因

开发者同时使用多个编码代理后，会话散落在不同目录和格式里，成本口径也不一致。AgentsView 用一个本地档案统一这些记录，并把查询、图表、API 和 MCP 放到同一数据源上。

适合谁用

适合在一台机器上同时使用多种编码代理的人统一搜索历史、按项目回看会话、核对 token 和成本、生成日常报告，或通过 API/MCP 让其他工具查询档案。团队共享、跨机器同步和语义 Insights 会扩大数据边界，应先用脱敏样本验证权限、保留期与远端存储。

采用建议

AgentsView 适合已经积累大量本地编码代理会话、确实需要搜索和统一成本视图的人。第一次应只索引一个测试目录，检查数据库里出现了哪些内容，关闭不需要的遥测与共享功能；确认隐私边界后，再扩大到完整会话库。

原教程未展开的系统信息

核心功能

多代理会话归档
后台 daemon 发现本机代理会话目录，解析六十多种格式并写入 SQLite。Web UI、CLI、API 和 MCP 都读取同一份档案，减少各工具重复扫描原始日志。
用量与成本统计
usage、session usage 和 stats 命令按日期、模型、代理或项目汇总 token、缓存与估算成本；有上游原生费用字段时会优先采用，例如 Copilot CLI 报告的账单值。估算仍可能与最终账单不同。
本地搜索与分析界面
本地服务器默认绑定 127.0.0.1:8080，提供会话浏览、全文搜索、项目过滤、活动图表和导出。远程访问需要显式修改监听地址，并应同时启用 bearer token。

技术栈和运行条件

语言

Go 后端、Svelte 5/TypeScript 前端与 Rust/Tauri 桌面包装

框架

本地 daemon + SQLite/FTS5 + 嵌入式 Web UI + CLI/REST/MCP

关键依赖

SQLite 与 FTS5
可选 PostgreSQL、DuckDB 和 ClickHouse 镜像
从源码构建需要 Go 1.27+、CGO、Node.js 22+

运行环境

提供 Homebrew cask、PyPI/uvx、GitHub Release 桌面包、校验和安装脚本与多架构 Docker 镜像；MIT 许可

常见问题

AgentsView 会把所有会话上传到云端吗？

默认不会。SQLite 档案保存在本机，服务默认绑定 127.0.0.1。但托管 raw sync、远程数据库、GitHub 发布和 Generated Insights 等可选功能会改变数据路径，开启前要分别检查。

AgentsView 的费用数字等于最终账单吗？

不一定。它会使用日志中的 token、价格表和可用的上游费用字段计算或展示成本。缺失事件、模型映射和价格变动都会造成差异，应把结果用于趋势与对账，不当作付款凭证。

AgentsView 为什么能看到不同编码代理的历史？

daemon 会扫描各代理的本地会话目录，把不同格式解析成统一记录并写入 SQLite。它只能读取实际存在且有权限访问的日志，Docker 还必须显式挂载这些目录。

怎样关闭 AgentsView 遥测？

官方说明 daemon 会发送不含会话内容的匿名存活事件。设置 AGENTSVIEW_TELEMETRY_ENABLED=0 或 TELEMETRY_ENABLED=0 可关闭；安装后应结合网络策略自行核对。

AgentsView 和 ccusage 怎么选？

只要快速查看本地 token 和成本报表，ccusage 更轻。需要持续同步、完整会话搜索、Web UI、API 或 MCP 时，AgentsView 的长期档案结构更合适。