AgentsView 会话档案
在本机统一搜索编码代理会话，并查看令牌用量、成本和活动分析。
- Star 数
- ★ 6.1k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Go
- FA 评分
- 68/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时使用 Claude Code、Codex 等工具的开发者，想在一个本地界面搜索和回看会话。
- 不适合
- 需要 IDE 内直接查看会话的开发者
- 需要把游标归因统计同步到 PostgreSQL 的团队
- 源码审查
- 68/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
AgentsView 是一个本地优先的编码代理会话浏览与分析工具，包含 Go CLI、由 Go 服务端提供的 Web UI，以及 macOS 和 Windows 桌面应用。首次运行时，它会从已支持代理的会话目录发现数据，将其同步到本地 SQLite 档案，并在默认的 127.0.0.1:8080 提供界面。CLI 可搜索和列出会话、汇总令牌与成本，并输出窗口化统计；Web UI 提供全文搜索、会话查看、成本仪表板和活动分析。可选的 PostgreSQL、ClickHouse 和 DuckDB 目标通过推送或镜像共享、查询档案，远程后端的界面为只读。会话内容默认留在本机；遥测可关闭，启用语义搜索、导出到 GitHub Gist 或配置远程同步时则涉及相应的外部服务。
AgentsView 从 Claude Code、Codex 及其他受支持工具的本机会话目录读取会话文件，并将解析后的会话与消息写入 SQLite。运行 agentsview serve 会启动服务、Web UI、同步和文件监听；后台模式可用 agentsview daemon start。agentsview session list、agentsview usage daily 和 agentsview stats 可读取档案并返回会话列表、成本摘要和统计；agentsview session search 可全文搜索，也可在配置嵌入端点后选择语义或混合搜索。Web UI 展示消息、令牌用量、成本、热力图和工具使用情况；REST API 提供单会话用量端点 /api/v1/sessions/{id}/usage。可选的 pg push、clickhouse push 和 duckdb push 将 SQLite 档案复制到对应目标，供只读服务或分析使用。
- 同时使用 Claude Code、Codex 等工具的开发者，想在一个本地界面搜索和回看会话。
- 个人开发者想按天或模型比较多个编码代理的令牌用量与估算成本。
- 团队想把本机会话档案推送到 PostgreSQL，供共享只读仪表板查看。
- 数据分析人员想将 SQLite 档案镜像到 DuckDB，或推送到 ClickHouse 做只读查询。
- 需要自动化汇总的用户想通过 CLI JSON 输出、统计结果或单会话 REST API 接入脚本。
如何安装或部署这个 Agent？
macOS 和 Linux 可用安装脚本安装 CLI：
curl -fsSL https://agentsview.io/install.sh | bashWindows PowerShell：
powershell -ExecutionPolicy ByPass -c "irm https://agentsview.io/install.ps1 | iex"也可在 macOS 或 Windows 安装桌面应用，或在 macOS 使用 Homebrew：
brew install --cask agentsviewDocker 镜像也可运行；挂载代理会话目录并设置对应环境变量后，容器才能发现这些会话：
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如何使用这个 Agent？
首次运行会扫描受支持的会话来源、同步到 SQLite，并在本机启动 Web UI：
agentsview serve在浏览器打开 http://127.0.0.1:8080。常用 CLI 命令：
agentsview daemon start
agentsview session list
agentsview usage daily
agentsview stats --format json要搜索会话，可使用 agentsview session search；语义搜索需要配置 OpenAI 兼容的嵌入端点。单会话用量可通过 CLI 或 REST API 获取：
agentsview session usage <id>
curl http://127.0.0.1:8080/api/v1/sessions/<id>/usage日用量报告读取已保存档案；要纳入来源目录的新变更，先运行 agentsview sync。
这个 Agent 有哪些优点和局限？
- 将 20 多种编码代理的本地会话汇集到 SQLite，支持 FTS5 全文搜索和项目、日期筛选。
- 用量、成本和统计覆盖所有受支持代理，并提供 CLI、JSON 和单会话 REST API 输出。
- 本地 SQLite 是主档案；PostgreSQL、ClickHouse 和 DuckDB 是可选的推送或只读镜像后端。
- 提供 macOS、Windows 桌面应用，以及 CLI、Web UI 和 Docker 部署路径。
- 每种代理需要可访问的本机会话目录；Docker 部署还必须显式挂载目录并配置对应环境变量。
- 语义搜索需配置 OpenAI 兼容的嵌入端点；成本估算依赖可用定价数据，部分专有模型可能无价格。
- PostgreSQL、ClickHouse 和 DuckDB 功能需要额外后端配置；远程访问还需处理认证、TLS 或可信代理。
- README 未说明桌面应用的具体系统版本要求；开发构建则要求 Go 1.27+（CGO）和 Node.js 24.11+。
这个 Agent 与同类方案有什么区别？
README 将 SQLite 描述为主档案，并将 PostgreSQL、ClickHouse 和 DuckDB 描述为可选的共享或镜像后端：SQLite 支持写入与 FTS5 搜索，远程后端以只读方式提供服务。DuckDB 搜索使用子串或正则回退，SQLite FTS5 是索引搜索路径。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AgentsView 会话档案 当前 | 68 · 存在缺口 | 命令行工具免费 | ★ 6.1k | 今天 | Go | Codex · Claude Code |
| LeanCTX 上下文智能层 | 75 · 表现良好 | 命令行工具免费 + 模型费 | ★ 3.8k | 12 天前 | Rust | Codex · Claude Code · OpenAI API · Claude API |
| Agent Deck | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 1k | 2 天前 | Go | Codex · Claude Code |
| ccxray | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 296 | 9 天前 | JavaScript | Claude Code · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
默认仅绑定 loopback，说明 Host/CORS/CSP 防护、认证边界、远程同步及外发连接；PostgreSQL 非本机默认要求 TLS，LiteLLM 与更新请求说明不发送会话内容。秘密默认遮蔽、数据存储及删除限制也有披露。扣分原因：归档仍以明文保存且权限依赖 umask，检测并非完整防泄漏；部分外发/导出及永久删除不可撤回或不保证彻底清除，且风险操作没有普遍确认机制。依赖清单充分但未提供漏洞审计证据；发布者身份未验证，维护者私密漏洞报告渠道仍是 TODO。
README 对 daemon、serve、sync 和不同数据后端的职责与启动行为有较详细说明，安全文档也说明威胁假设。扣分原因：提供的材料没有依赖可用性或离线保障的整体证据，只有 LiteLLM 定价的离线回退说明；失败信息策略和恢复路径未充分说明。CI 配置展示了定向测试任务，但不能据此声称执行结果或整体可靠性。
明确面向单用户开发者工作站，列出大量支持的编码代理、平台目录、Docker、SSH 转发、远程部署和 CI 一次性捕获场景。扣分原因：共享主机、多用户隔离及强删除保证明确排除；部分能力有具体前置条件，例如 Aider 需显式配置、Amp 已弃用，配置细节主要指向外部文档。
README 按安装、快速开始、远程访问、成本统计、浏览器和代理支持组织，并提供命令示例；MIT 许可证完整。安装说明覆盖多平台，但关键安装方式使用远程脚本管道，未在所给文件中呈现校验步骤。版本号和变更日志入口存在，但当前描述指向 main，不能完全固定到本次修订；维护责任和私密安全报告联系方式尚不清楚。
搜索、成本统计、分析仪表板、跨代理会话浏览和脚本 JSON 输出针对编码代理会话归档提供了直接用途，也指出语义搜索为可选功能。扣分原因：产品读取和保存大量敏感会话内容，部署与维护数据后端、守护进程及可选同步会带来额外成本；部分指标依赖可选 Git/GitHub 查询，文档提示其可能缓慢或脆弱。
README 对命令、数据路径、API 字段和安全边界给出不少可核对细节，SECURITY.md 分别说明数据静态存储、外发连接与防护假设，CI 工作流展示具体测试命令。扣分原因：不少功能和安全行为仍是文档陈述，未提供实现文件供逐项核实；CI 配置不是测试通过的证据；安全文档自称基础性描述，部分内容待提案决定。
- 会话归档包含提示、工具参数、命令输出及可能的秘密，且以明文存储；请限制数据目录访问，并将导出、远程同步和外部数据库视为额外副本。
- 启用非本机访问时需正确配置认证与可信来源；Quack 的非 loopback 明文连接以及 PostgreSQL 的 allow_insecure 会削弱传输保护。
- 秘密检测只是尽力而为，永久删除不保证清理 WAL、SQLite 页面、备份或外部副本；安全问题的私密报告渠道尚未配置。
常见问题
使用 AgentsView 是否需要付费模型或 API 密钥？
会话内容会上传到云端吗？
AGENTSVIEW_TELEMETRY_ENABLED=0 或 TELEMETRY_ENABLED=0 关闭；共享后端、语义搜索端点和 Gist 导出是可选的外部路径。为什么某个代理或会话没有出现在界面？
AIDER_DIR 或 agents.aider.dirs；Docker 中也必须挂载来源目录。成本数据会与账单完全一致吗？
能从远程浏览器访问本机服务吗？
--public-url 或受信任来源以适配转发或代理；若将界面暴露到 loopback 之外，还应启用 --require-auth。这些设置不会自动创建外部监听器或代理。