AgentsView 会话智能闭环：把 Agent 的原始会话数据变成可检索、可复用的本地知识库

AgentsView 会话智能闭环把 Agent 的原始会话数据变成可检索、可复用的本地知识库【免费下载链接】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/agentsviewAgentsView 的官方文档把整套工作流概括为“九站五分钟”的会话智能闭环the session intelligence loopAgent 写出原始会话数据AgentsView 把它变成可搜索的本地 SQLite 归档再让 Agent 在下一次运行时消费这些答案。本文按照 官方指南 的九个站点逐一展开并结合仓库中的 parser、sync、mcp、recall 等实现源码说明每个站点背后“数据从哪来、存在哪、怎么被消费”帮助你在 5 分钟内跑通整个闭环并理解其实现边界。01. Capture every session捕获所有会话指南第一站的核心主张是守护进程会自动发现 60 多种 Agent 格式包括 Claude Code、Codex、Cursor、Copilot、Gemini 等的会话目录把它们同步进一个带全文索引的本地 SQLite 归档并持续监听让归档在你工作时保持最新。源格式覆盖仓库里支撑这一点的证据是 internal/parser 目录它包含约 380 个文件其中 56 个*_provider.go文件对应各 Agent 格式的解析器例如 claude_provider.go、codex_provider.go、cursor_provider.go、copilot_provider.go 等另含 s3_provider.go 用于 S3 兼容源。README 的“Supported Agents”表格列出了完整的会话目录对照表Claude Code 在~/.claude/projects/Codex 在~/.codex/sessions/Cursor 在~/.cursor/projects/等每个目录都可用对应环境变量覆盖例如CLAUDE_PROJECTS_DIR、CODEX_SESSIONS_DIRAider 因为没有中央会话目录而需要显式设置AIDER_DIR或agents.aider.dirs才会被扫描。同步机制同步与监听由 internal/sync 包驱动核心是engine.go与 Web UI、API、文件监听共享同一个守护进程——这就是 README 中“daemon is the server”的含义。本地导入使用持久化的 installation ID 标记机器身份主机名变化或升级不会把同一个会话拆成多条身份记录旧归档可用agentsview db adopt-machine选择本机历史会话详见 configuration 文档。跑通第一站的命令见 Quick Startagentsview serve # 前台启动服务器 agentsview daemon start # 或以后台守护进程方式启动首次运行会在~/.agentsview/sessions.db初始化 SQLite 库发现并同步本机所有受支持 Agent 的会话随后开始监听会话目录变化并在http://127.0.0.1:8080启动 Web UI。02. Browse the full conversation浏览完整对话第二站强调归档中保留了每个 Agent 记录的用户提示词、助手回复、推理thinking与工具调用并支持按项目、Agent、日期、消息数过滤子 Agent 树、resume 链和编辑过的文件都与其父会话保持关联。Usage Guide 给出了 Web 界面的完整走查仪表盘头部提供项目过滤typeahead、命令面板CmdK、手动同步、主题切换与 Chat Import 入口底部状态栏展示会话数、消息数、项目数、上次同步时间和构建版本。会话列表页session list 有对应端到端测试支持上述四类过滤器。从源码结构看子 Agent 与父会话的关联在解析层完成internal/parser中的 claude_lineage.go 维护 Claude 会话的血缘关系Codex 有独立的 codex_metadata.go 等元数据文件归档库internal/db据此把 subagent 树和 fork/resume 链挂回父会话——这正是指南所说的“Subagent trees, resume chains, and edited files stay connected to their parent session”。03. Monitor the fleet监控整个 Agent 车队第三站是 Activity 仪表盘展示 Agent 何时运行、工作量如何重叠、花了多少钱——包括峰值并发及其发生的精确时刻、活跃/空闲时长、任意时间窗口内的 agent-minutes并且可以点击时间桶查看该时段具体哪些会话在运行。Activity 文档 对此有完整定义可直接对照实现概览卡片Interactive peak同一时刻最多的交互会话数附峰值时刻、Active活跃墙钟时长 空闲时长、Agent-minutes并发 Agent 合计的活跃分钟数、Sessions区分交互式/子 Agent/自动化/无时间戳、Projects 与 Models 去重计数、Total Cost优先用权威上报值否则用价格目录估算。并发图堆叠柱状图蓝色 Interactive、紫色 Subagents、橙色 Automated柱子高度是该时间桶的合计并发峰值悬浮可看每桶的 token、成本明细还可用 All-session overlay 叠加 Tokens/Cost 趋势线。下钻点击某个时间桶Sessions 表即过滤为该时段活跃的会话支持拖拽选区间、键盘操作Enter/Space 选择、Shift方向键扩展、Escape 清除。实现上Activity 报表由 internal/activity 包的共享聚合器构建报表、桶下钻都走同一聚合逻辑下钻结果以有界分页返回浏览器不再下载全部原始活动区间PostgreSQL 侧有对等的 activityreport.go 实现保证本地与团队视图口径一致。报表默认包含 one-shot 与自动化会话并可用 Project / Agent / Machine / Automation 四个过滤器收窄筛选状态写入 URL 查询参数preset、date、from、to等便于分享。04. Meter tokens and cost计量 token 与成本第四站是用量报表展示已记录 token 与估算成本包括 prompt cache 的写入与读取。报表复用已保存的归档数据升级或同步后的第一个请求可能需要时间准备缓存。指南提到三个消费面均有明确出处CLI——终端直接回答无需常驻服务也能读归档agentsview usage daily # 每日成本汇总默认近 30 天 agentsview usage daily --breakdown # 按模型拆分 agentsview usage daily --agent claude --since 2026-04-01 agentsview usage statusline # 编辑器 statusline 的单行输出 agentsview session usage id # 单会话 token 与成本--json输出可供脚本消费价格来自 LiteLLM/OpenRouter 费率并带离线回退成本计算感知 prompt cache 的创建/读取 tokentoken usage 文档。Statusline——在编辑器内显示今日开销即上面的usage statusline命令。One-shot capture——对一次非交互的claude -p或codex exec --jsonCI 运行用agentsview capture run保留子进程流与退出码写出独立的版本化用量结果且不启动任何 daemon、Web 服务或监听器one-shot capture 文档实现位于 internal/capture。此外agentsview stats提供窗口级统计总量、原型automation vs quick/standard/deep/marathon、会话时长/消息数/峰值上下文/每轮工具数分布、缓存经济学、工具/模型/Agent 组合--format json输出带版本化 v1 schemaGit 派生指标commits/LOC因可能较慢而默认关闭需显式--include-git-outcomes。05. Search by words or by meaning按字面或按语义搜索第五站全文检索能在几个月后帮你找到“讨论过某个函数或某个报错”的那段对话可选opt-in的语义与混合检索按“含义”匹配对话单元conversation units每条结果都标注来源单元并可按需拉取周边上下文。实现分两层均可在仓库中验证全文检索基于 SQLite FTS5构建需fts5build tag并对中文、日文、韩文提供 CJK 字符与短语检索支持——internal/db/cjk_fts_runtime.go 与 cjk_fts_search.go 负责 CJK 分词中文走simple/cppjieba 分词search_content.go 是内容检索主体。语义/混合检索是可选功能配置任一 OpenAI 兼容 embeddings 端点后用agentsview session search --semantic或--hybrid按含义检索每条内容匹配都会引用它来自哪个对话单元。原理细节见 semantic search 文档 与 semantic search internals向量化调度入口在 embed_scheduler.go 与 internal/vector。06. Assess session health评估会话健康度第六站会话智能session intelligence直接从转录文本分类结果outcome并打分健康度信号来源包括工具调用失败、上下文压力和循环信号确定性的质量规则把重复出现的模式变成建议且每条建议都回溯到触发它的源会话。Session Intelligence 文档 明确了四个暴露面会话详情页头部健康等级徽章、仪表盘 Session Health 区块分数、结果、工具失败率、compaction、趋势、Agent/项目拆分、程序化接口agentsview session get/session list暴露健康与结果字段支持--health-grade、--outcome、--min-tool-failures等过滤以及 CLI 健康视图agentsview health列表或单会话详细信号。文档同时声明这些信号是启发式而非地面真值用于分诊和找模式不替代你自己对会话是否成功的判断。源码侧打分与规则逻辑在 internal/insight如 summary.go、prompt.goCLI 入口对应 health.go仪表盘侧的聚合查询见 internal/db/insights.go。07. Keep what the sessions learned沉淀会话学到的东西第七站是 Recall实验性从归档中收集可复用的经验事实、流程、偏好、警告每条 entry 都带指向支撑消息的证据链接模型生成的 Insights 则在显式会话范围之上生成报告。Recall 文档 给出了当前实现边界与 CLI 面agentsview recall list # 浏览蒸馏出的条目 agentsview recall get # 查看单条 agentsview recall stats # 覆盖与生成状态 agentsview recall query # lexical默认/ vector / hybrid 排序检索 agentsview recall brief # 打包成可信的任务简报 agentsview recall extract # 可选的模型辅助抽取 agentsview recall extract preview # 预览确定性的会话切块 agentsview recall import --dry-run # 校验已审阅的 JSONL 候选Web 端的 Recall 页面分 Corpus 与证据浏览两个标签可从条目跳到支撑它的转录消息。实现位于 internal/recall类型定义 types.go、排序 rank.go与归档库的 recall.go、recall_vector.go。文档明确警告Recall 处于活跃研究阶段schema、评分与信任策略可能变化升级时新表可能需要重建会话归档始终是权威数据不能为了重置 Recall 而删除或重建它。它与语义检索的分工是语义检索在转录原文里找段落Recall 检索的是已抽取的条目。08. Give your agents the archive让 Agent 读自己的历史指南认为闭环在“Agent 读取自己的历史”这一刻闭合Agent 可以检查上一次运行试过什么避免重复踩坑。AgentsView 提供三条通道。MCP serverMCP 文档 对应的实现是 internal/mcpserver.go 构建 stdio 或 StreamableHTTP 两种传输的服务器暴露一组只读检索工具包括search_sessions全文搜索默认排除最近 10 分钟内的活跃会话以避免“找到自己”、query_recall、list_sessions、get_session_overview、get_messages、search_content、get_usage_summary。tools.go 的头部注释点明了实现哲学这些工具是 internal/service 中SessionService的薄适配器与 CLI 和 HTTP handler 共用同一条服务缝seam保证三条通道口径一致。REST API 与 CLIREST APIsession API 文档面向脚本与 hook例如GET /api/v1/sessions/{id}/usage返回单会话的total_output_tokens、peak_context_tokens、cost机器可读金额为整数微美元对象等字段CLI 则覆盖session list/get/messages/search/export等只读命令命令参考见 commands 文档。SSE 实时流SSE 把活跃会话的新消息实时推给前端会话侧边栏在全局 SSE 事件流上自动更新繁忙同步期间做去抖仪表盘等重查询页面则配合手动刷新按钮不随每次同步事件重取——这是 Usage Guide 中说明的更新策略。09. Extend beyond one machine扩展到单机之外第九站回答“多台机器怎么办”。指南给出四种方式并且强调磁盘上的 SQLite 始终是本地的权威归档archive of record其余都是可选投影。PostgreSQL 同步团队视图把各机器的归档推送到共享 PostgreSQL合并成团队视图pg sync 文档agentsview pg push # 推送到默认 PG 目标 agentsview pg push archive # 推送到指定命名目标 agentsview pg push --all # 依次推送所有已配置目标 agentsview pg serve # 从 PG 目标只读服务 Web UI agentsview pg push --watch --debounce 1m # 后台自动推送事件驱动 兜底周期 agentsview pg service install # 注册为 launchd / systemd --user 服务多目标用[pg.NAME]块加default_pg配置README 有完整示例命名目标名大小写不敏感all、local等保留名不可用。推送与团队侧实现分别在 cmd/agentsview/pg.go 与 internal/postgres/push.go。DuckDB 镜像分析查询DuckDB 是镜像后端而非 SQLite 归档的替代品agentsview serve仍然主写 SQLiteDuckDB 用于获得可移植的分析文件、只读本地服务或通过 Quack 协议做远程只读访问duckdb 文档agentsview duckdb push # 从 SQLite 镜像到 DuckDB agentsview duckdb status agentsview duckdb serve # 只读 Web UI agentsview duckdb quack serve # 以 Quack 暴露本地 DuckDB 文件Quack 默认保守本地绑定回环、要求 token、非回环明文 HTTP 必须显式--allow-insecure。镜像后端入口在 internal/duckdb 与 cmd/agentsview/duckdb.go。文件系统与 S3 源、托管原始数据两种“读源文件”的扩展通过[[session_sources]]把其它机器复制或挂载来的原生会话目录并入主归档filesystem sync 文档用 peer 的telemetry-install-id标注来源机器[[session_sources]] agent copilot dir /srv/session-archive/buildbox/copilot machine 0123456789abcdef0123456789abcdef # Peer installation ID以及对 Claude、Codex、Cursor 把自定义根直接配成s3://URIS3 兼容源 说明对象布局与同步行为[agents.claude] dirs [s3://agent-archive/laptop/raw/claude]最后hosted raw sync 文档 覆盖把原始会话文件留在托管存储的场景。小结五分钟走完九站站点能力主要入口01 捕获60 Agent 格式 → 本地 SQLite 归档agentsview serve/daemon start02 浏览完整对话、过滤、父子会话关联Web UI 会话列表03 监控峰值并发、agent-minutes、成本/activity页04 计量token 与成本、statusline、CI 捕获agentsview usage daily05 搜索FTS5 全文 可选语义/混合检索agentsview session search06 健康健康分、结果分类、质量规则agentsview health07 沉淀Recall 经验条目 Insights 报告实验性agentsview recall query08 闭环MCP 工具、REST API、CLI、SSEinternal/mcp09 扩展PG 团队视图、DuckDB 镜像、文件系统/S3 源pg push/duckdb push整条链路的架构约束从源码结构看是一致的所有消费者Web UI、CLI、MCP、报表都通过 internal/service 与 internal/db 的统一服务层读取同一份归档SQLite 是权威源PostgreSQL/DuckDB/托管存储只是可选投影。这也解释了为什么 README 反复强调“local-first”除非你主动启用某个共享功能会话数据始终留在你的机器上。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考