惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

C
Check Point Blog
罗磊的独立博客
量子位
Microsoft Azure Blog
Microsoft Azure Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
J
Java Code Geeks
M
MIT News - Artificial intelligence
月光博客
月光博客
IT之家
IT之家
D
DataBreaches.Net
A
About on SuperTechFans
博客园 - 三生石上(FineUI控件)
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
Last Week in AI
Last Week in AI
D
Docker
The GitHub Blog
The GitHub Blog
B
Blog
V
Visual Studio Blog
博客园 - Franky
N
Netflix TechBlog - Medium
博客园 - 【当耐特】
Martin Fowler
Martin Fowler
博客园 - 聂微东
U
Unit 42

BlogFinder

日常漫步 Vol.24 之漫步前山河 - 雅余 周报 #1-聊聊本周的收获 - Edwin's Blog 我的OpenCode必装插件与Skill Write Something 掌中之物未必在掌握之中 · CRIVU PiliNara,一个更顺手的 PiliPlus 分支 「NekoEcho」:做一个必有回响的猫娘主题博客 2026-05 书影音总结 简化博客主题 - 安迪 我第一次发布 npm 包 拾花小记#45:中考前的二三事 – 小改学习志 黛西花园5月游 #18 枇杷又熟了的五月月报 一些奇奇怪怪的需求?word仿方正书版的几个小操作 - Xiobb's Blog 0419 御温泉之旅 修复了一些bug,网站基本上趋于稳定了 - 新锐博客 又回到四十年前 如何定义成功 迷鹿屋2026已重新上线 科技冰火两重天+一周回顾 ${title} 热度退了,我反而用得更深了-咕咚同学 我到底该不该换个域名? 随身WIFI折腾记 - 安迪 博客撰写体验提升——hexo pro插件 为什么不用相机把屏幕上的接关密码拍下来? 国清寺与天台山 – Ouroboros ★★★★☆《挽救计划》——久违的经济上行感 - Davidの3号基地 删除右键“打开方式”里多余选项 第三周刊_No.53|一切都会被支付两次
AgentsView:一站式 AI 编程助手成本追踪与分析平台
Cheman · 2026-06-13 · via BlogFinder

今天在 GitHub Trending 上看到一个有意思的项目:AgentsView,它是一款专注于 AI 编程助手的成本追踪与分析平台,能够帮助开发者一站式管理所有 AI 编程工具的使用记录和成本开销。

一、项目概述

AgentsView 是一个开源的本地优先工具,用于浏览、搜索和追踪所有 AI 编程助手的成本。它的核心价值在于:

  • 统一管理:支持 Claude Code、Cursor、Copilot、Codex、Gemini CLI 等 25+ 主流 AI 编程工具
  • 本地优先:所有数据存储在本地 SQLite 数据库,无需账户,完全隐私
  • 实时分析:提供成本仪表盘、活动热力图、会话浏览器等可视化功能
  • 高性能查询:基于 SQLite FTS5 的全文搜索,比重新解析会话文件的工具快 100 倍以上

项目采用 Go + Svelte 技术栈开发,提供 CLI、Web UI 和桌面应用三种使用方式,支持 macOS、Linux 和 Windows 平台。

二、技术原理

2.1 架构设计

AgentsView 采用典型的三层架构:

前端(Svelte 5 SPA) ←→ Go HTTP Server ←→ SQLite/DuckDB/PostgreSQL

核心组件包括:

  • 会话解析器(Parser):自动发现并解析各 AI 编程工具的会话目录
  • 同步引擎(Sync):监控会话文件变化,实时同步到数据库
  • 存储层(Store):抽象接口支持 SQLite、DuckDB、PostgreSQL 三种后端
  • Web Server:基于 Huma v2 框架的 REST API + SSE 实时推送

2.2 多后端存储设计

项目巧妙地实现了存储后端的抽象:

// 存储接口抽象
type Store interface {
    ListSessions(ctx context.Context, opts ListOptions) ([]Session, error)
    GetSession(ctx context.Context, id string) (*Session, error)
    GetMessages(ctx context.Context, sessionID string) ([]Message, error)
    // ...
}

// 三种后端实现
type SQLiteStore struct { ... }
type DuckDBStore struct { ... }
type PostgresStore struct { ... }
  • SQLite:主存储,支持写入和 FTS5 全文搜索
  • DuckDB:只读镜像,适合大数据量分析和 Quack 协议远程访问
  • PostgreSQL:团队共享后端,支持多用户协作

2.3 成本计算引擎

成本追踪的核心是 LiteLLM 定价数据:

// 成本计算逻辑
func (c *CostCalculator) Calculate(usage TokenUsage) float64 {
    inputCost := usage.InputTokens * c.inputPrice
    outputCost := usage.OutputTokens * c.outputPrice
    
    // 缓存令牌特殊处理
    cacheCreateCost := usage.CacheCreationTokens * c.cacheCreatePrice
    cacheReadCost := usage.CacheReadTokens * c.cacheReadPrice
    
    return inputCost + outputCost + cacheCreateCost + cacheReadCost
}

关键设计:

  • 自动从 LiteLLM 获取最新定价,离线时使用内置缓存
  • 支持 Prompt Caching 成本计算(Claude 特有)
  • 按模型细分的成本明细,支持 --breakdown 参数

2.4 会话自动发现

项目通过环境变量配置各 AI 工具的会话目录:

var agentPaths = map[string]string{
    "claude":     os.Getenv("CLAUDE_PROJECTS_DIR"),
    "cursor":     os.Getenv("CURSOR_PROJECTS_DIR"),
    "copilot":    os.Getenv("COPILOT_DIR"),
    "codex":      os.Getenv("CODEX_SESSIONS_DIR"),
    // ... 25+ agents
}

首次运行时自动扫描所有已配置目录,解析 JSON/JSONL 格式的会话文件,同步到本地数据库。

三、安装与快速开始

3.1 安装方式

macOS / Linux(推荐):

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

macOS Homebrew:

brew install --cask agentsview

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://agentsview.io/install.ps1 | iex"

Docker:

docker run --rm -p 127.0.0.1:8080:8080 \
  -v agentsview-data:/data \
  -v "$HOME/.claude/projects:/agents/claude:ro" \
  -e CLAUDE_PROJECTS_DIR=/agents/claude \
  ghcr.io/kenn-io/agentsview:latest

3.2 快速启动

# 启动 Web UI
agentsview serve

# 查看每日成本摘要
agentsview usage daily

# 按模型细分成本
agentsview usage daily --breakdown

# JSON 输出(用于脚本)
agentsview usage daily --all --json

首次运行会自动发现所有支持的 AI 编程工具会话,同步完成后自动打开 http://127.0.0.1:8080

四、使用方法与实战

4.1 成本追踪

每日成本概览:

输出示例:

Date        Input      Output    Cache    Cost (USD)
2026-06-13  1.2M       340K      890K     $12.45
2026-06-12  980K       290K      720K     $10.23
2026-06-11  1.5M       420K      1.1M     $15.67

按模型细分:

agentsview usage daily --breakdown

筛选特定工具和日期:

agentsview usage daily --agent claude --since 2026-06-01

状态栏集成:

# 一行摘要,适合 shell prompt
agentsview usage statusline

4.2 会话浏览与搜索

Web UI 提供强大的会话管理功能:

  • 全文搜索:基于 FTS5,支持中英文混合搜索
  • 活动热力图:可视化编程活动分布
  • Token 使用仪表盘:每会话、每模型的成本明细
  • 实时更新:通过 SSE 监听活跃会话的变化
  • 键盘导航j/k 切换会话,Cmd+K 全局搜索,? 查看快捷键

4.3 PostgreSQL 团队共享

对于团队协作场景,可配置 PostgreSQL 后端:

# 配置 PostgreSQL 连接
export AGENTSVIEW_PG_URL="postgres://user:pass@host:5432/agentsview"

# 推送本地数据
agentsview pg push

# 从 PostgreSQL 启动只读 Web UI
agentsview pg serve

自动同步守护进程:

# 后台自动推送
agentsview pg push --watch --debounce 1m

4.4 DuckDB 分析镜像

适合大数据量离线分析:

# 同步到 DuckDB
agentsview duckdb push

# 从 DuckDB 启动只读服务
agentsview duckdb serve

# 通过 Quack 协议远程访问
agentsview duckdb quack serve --token "$QUACK_TOKEN"

五、常见问题与解决方案

5.1 远程访问 403 Forbidden

问题:通过 SSH 端口转发或远程开发环境访问时,API 返回 403。

原因:服务端验证 Host 头防止 DNS 重绑定攻击。

解决方案

# 指定浏览器访问的 URL
agentsview serve --public-url http://127.0.0.1:18080

# 或信任多个来源
agentsview serve --public-origin https://workspace.exe.dev

5.2 Antigravity CLI 加密会话无法读取

问题:旧版 Antigravity CLI 使用 AES-GCM 加密的 .pb 文件。

解决方案

# 安装解密工具
go install github.com/mjacobs/agy-reader@latest

# 同步生成 sidecar 文件
agy-reader --sync

# 或持续监听
agy-reader --watch

5.3 Docker 容器无法发现某些 Agent

问题:容器化部署后,部分 AI 编程工具未出现在 UI。

原因:容器无法访问宿主机会话目录。

解决方案

docker run --rm -p 127.0.0.1:8080:8080 \
  -v agentsview-data:/data \
  -v "$HOME/.claude/projects:/agents/claude:ro" \
  -v "$HOME/.cursor/projects:/agents/cursor:ro" \
  -e CLAUDE_PROJECTS_DIR=/agents/claude \
  -e CURSOR_PROJECTS_DIR=/agents/cursor \
  ghcr.io/kenn-io/agentsview:latest

5.4 隐私与数据安全

Q: 数据是否会上传到云端?

不会。所有会话数据存储在本地 SQLite 数据库,服务默认绑定 127.0.0.1

Q: 遥测数据包含什么?

仅包含应用版本、操作系统、CPU 架构等匿名信息,不含会话内容、项目路径或账户信息。

禁用遥测:

export AGENTSVIEW_TELEMETRY_ENABLED=0

六、总结

AgentsView 是一款设计精良、功能完善的 AI 编程助手成本追踪工具。它通过本地优先的架构、多后端存储支持和强大的搜索分析能力,帮助开发者精准掌控 AI 编程开支。

核心优势:

  • 广覆盖:支持 25+ 主流 AI 编程工具
  • 高性能:SQLite FTS5 全文搜索,查询速度比同类工具快 100 倍
  • 多部署:CLI、Web、桌面、Docker 四种部署方式
  • 可扩展:支持 PostgreSQL 团队共享和 DuckDB 分析镜像

对于使用多个 AI 编程工具的开发者,AgentsView 是一款不可多得的效率提升工具。项目开源在 GitHub(kenn-io/agentsview),欢迎 Star 和贡献代码。