agentsview 是什么?

AgentsView 是一个本地优先的 AI 编码代理会话档案与分析工具。它把 Claude Code、Codex 等六十多种会话格式解析进本地 SQLite,再通过 Web UI、桌面应用、CLI、REST API 和 MCP 提供搜索、成本统计、活动分析与会话回看。它读取现有会话记录,不是负责执行编码任务的代理。

⭐ 3,225 Stars 🍴 263 Forks Go MIT 作者: kenn-io
来源:github.com/kenn-io/agentsview;https://github.com/kenn-io/agentsview/b… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

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

来源:github.com/kenn-io/agentsview;https://github.com/kenn-io/agentsview/b…

核心功能

多代理会话归档

后台 daemon 发现本机代理会话目录,解析六十多种格式并写入 SQLite。Web UI、CLI、API 和 MCP 都读取同一份档案,减少各工具重复扫描原始日志。

来源:github.com/kenn-io/agentsview/blob/main/docs/index.md
用量与成本统计

usage、session usage 和 stats 命令按日期、模型、代理或项目汇总 token、缓存与估算成本;有上游原生费用字段时会优先采用,例如 Copilot CLI 报告的账单值。估算仍可能与最终账单不同。

来源:github.com/kenn-io/agentsview
本地搜索与分析界面

本地服务器默认绑定 127.0.0.1:8080,提供会话浏览、全文搜索、项目过滤、活动图表和导出。远程访问需要显式修改监听地址,并应同时启用 bearer token。

来源:github.com/kenn-io/agentsview/blob/main/docs/usage.md;https://github.…
可选镜像与共享能力

SQLite 是本地事实源;PostgreSQL、DuckDB 等后端作为可选镜像。发布到 GitHub、远程 DuckDB、托管 raw sync 或生成 Insights 等功能可能让数据离开本机,需逐项开启并审查。

来源:github.com/kenn-io/agentsview/blob/main/docs/index.md

技术架构

核心 daemon 负责目录发现、格式解析、文件监听、SQLite 写入和本地 HTTP 服务;Svelte 前端嵌入 Go 二进制,桌面端用 Tauri 包装同一后端。CLI 的常规查询可连接正在运行的 daemon,必要时也能从 SQLite 读取。PostgreSQL、DuckDB 和其他远端后端是镜像或分析目标,不取代本地档案。Docker 运行时只能看到显式只读挂载进容器的会话目录。

来源:github.com/kenn-io/agentsview;https://github.com/kenn-io/agentsview/b…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) SQLite 与 FTS5 可选 PostgreSQL、DuckDB 和 ClickHouse 镜像可选 PostgreSQ… 从源码构建需要 Go 1.27+、CGO、Node.js 22+从源码构建需要 G… 多代理会话归档 用量与成本统计 本地搜索与分析界面 可选镜像与共享能力 agentsview 项目本体 核心功能 关键依赖

技术栈

语言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 许可
来源:github.com/kenn-io/agentsview/blob/main/docs/quickstart.md;https://gi…

快速上手

macOS 可先用 brew install --cask agentsview,其他平台从 GitHub Releases 下载签名或带 SHA-256 的对应包。CLI 也可用 pip install agentsview 或 uvx agentsview。首次启动运行 agentsview serve,再打开 http://127.0.0.1:8080;先核对它发现了哪些会话目录,再运行 agentsview usage daily。不要直接把服务监听到 0.0.0.0;确需远程访问时先设置 require_auth=true。
来源:github.com/kenn-io/agentsview/blob/main/docs/quickstart.md;https://gi…

使用场景

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

来源:github.com/kenn-io/agentsview;https://github.com/kenn-io/agentsview/b…

优势与局限

优势

  • 同一份本地档案同时服务 Web、CLI、API 和 MCP
  • 覆盖的代理格式多,适合跨工具检索和成本归档
  • 默认监听回环地址,SQLite 为本地事实源
  • 安装形态完整,发布包提供 SHA-256,MIT 许可

局限

  • 成本依赖日志完整性与价格表,只能作为估算或对账线索
  • 会话日志可能包含提示词、代码、文件路径和密钥片段,集中索引会放大本地数据暴露面
  • 项目有内容为空的匿名 daemon_active 遥测,默认启用,可用 AGENTSVIEW_TELEMETRY_ENABLED=0 关闭
  • 远程访问、PostgreSQL/DuckDB 镜像、GitHub 发布、托管同步与 Generated Insights 会改变本地优先边界
  • 主分支文档会领先已安装版本,操作时应以 agentsview version 和对应 tag 文档为准
来源:github.com/kenn-io/agentsview

最新版本

2026-09-23 核对时,官方 README 声明最新 release 为 v0.44.0。早期搜索缓存仍可能把 v0.39.0 标为 Latest,因此本页以仓库当前 README 为准;安装后应运行 agentsview version,并查看对应 tag 的 changelog,而不是把 main 文档直接套到旧二进制。

来源:github.com/kenn-io/agentsview;https://github.com/kenn-io/agentsview/r…

实测与证据

status: docs_only_official_sources_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 阅读 kenn-io/agentsview 官方 README、Quick Start、使用、远程访问、架构概览、许可证与 Releases 页面;未下载或运行二进制。  |  limitations: 没有验证自动目录发现、解析覆盖率、成本准确性、数据库迁移、桌面自动更新、Docker 挂载、远程鉴权、MCP、遥测关闭或大规模档案性能。  |  observed_output: 官方 README 当前声明 latest release 为 v0.44.0;Quick Start 写明从源码构建需要 Go 1.27+、CGO 和 Node.js 22+,默认 UI 地址为 127.0.0.1:8080,许可证为 MIT。

来源:github.com/kenn-io/agentsview;https://github.com/kenn-io/agentsview/b…

同类项目对比

相比 ccusage,AgentsView 更像长期会话档案:有 daemon、SQLite、全文搜索、Web/桌面界面、API、MCP 和可选远端镜像。ccusage 更像一次性本地报表 CLI,直接读取现有日志,重点是 daily、weekly、monthly、session 与成本模式,官方强调只读且不上传。只想在终端看用量可先用 ccusage;需要跨代理检索完整会话和持续索引时再选 AgentsView。

来源:github.com/kenn-io/agentsview;https://github.com/ccusage/ccusage/blob…

总结评价

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

来源:github.com/kenn-io/agentsview;https://github.com/kenn-io/agentsview/b…

常见问题

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 的长期档案结构更合适。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件