企业官网建设流程全解析

AgentsView 版本演进全景解析：从 0.1.0 到 0.43.0 的发布节奏、核心能力与源码印证

【免费下载链接】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

AgentsView 的 Changelog 记录了项目自 2026 年 2 月首次发布（0.1.0）至当前最新稳定版 0.43.0（2026-09-14）的完整演进：一个面向 Claude Code、Codex 等 20 余种编码 Agent 的本地优先（local-first）会话搜索、分析、洞察与 Token 用量统计工具。本文以该发布记录为主线，梳理五个关键演进阶段（基础搭建、多 Agent 扩展、成本分析、多存储后端、搜索与安全），并对最新版本的每一项新特性给出仓库内的源码级印证，帮助读者在升级、配置或排查问题时快速定位对应的实现与文档。

一、Changelog 的组织方式与阅读方法

docs/changelog.md 按版本倒序排列，每个版本固定包含四个部分：

• New features：新增功能，通常附带命令、配置键与文档链接；
• Improvements：性能与体验优化，常给出可量化的指标；
• Bug fixes：缺陷修复，部分条目会说明根因与影响范围；
• Acknowledgements：按贡献者维度致谢，可视为“哪些人推动了哪些子系统”的索引。

这种“功能—优化—修复—归属”的四段式结构，使 Changelog 不仅是更新日志，还承担了子系统归属图的角色：例如 Wes McKinney（wesm）的条目长期覆盖 daemon 生命周期、同步可靠性与发布文档，Marius van Niekerk 的条目集中在前端稳定性与数据库性能，Rod Boev 的条目覆盖各 Agent 解析器修复。阅读时可以先用 Acknowledgements 定位子系统负责人，再回溯对应的功能条目。

与仓库其他部分的对应关系：

二、版本纪律：SemVer、补丁位与“事故版本”

从 Changelog 可以归纳出项目一贯的版本纪律，对需要跟随升级的读者有实际价值：

1. 次版本（minor）承载功能，补丁位（patch）只修缺陷。0.16.1、0.17.1、0.22.1、0.23.5、0.37.2–0.37.5、0.41.1 等均为纯修复或小增强，升级风险低。
2. 发布事故会如实记录。0.37.0 的 Linux 构建因 sqlite-vec cgo 绑定头文件问题“从未产出二进制”，因此正式发布为 0.37.1，Changelog 中明确写道：“This is why the release ships as 0.37.1: the 0.37.0 tag never produced binaries.”——这种透明记录是判断版本可信度的重要依据。
3. 解析器数据版本（dataVersion）驱动自动重解析。多个版本（0.26.0、0.32.1、0.33.0 等）提到dataVersion递增：解析逻辑变化后，既有归档会在下次同步时自动重解析并自我修正，无需手工删库。理解这一机制，能解释“升级后首次 sync 特别慢”的现象。
4. Docker 镜像采用三标签策略（0.36.0 起）：stable始终指向最近一个打了 tag 的发布，latest跟踪 main 分支，精确版本标签不可变。
5. 构建工具链随版本前进：0.25.0 起源码构建要求 Go 1.26+（含 CGO），0.42.0 要求 Go 1.27+ 并切换到 Go 的 JSON v2 序列化行为；当前 go.mod 声明module go.kenn.io/agentsview且go 1.27.0，与 Changelog 记录一致。

三、阶段一（0.1.0 → 0.10.0，2026-02）：从分析仪表盘到会话浏览器

• 0.1.0（02-21）：Go 后端 + Svelte 前端的集成应用首次发布，分析页为首页，含汇总卡片、活动时间线、按项目/小时-星期热力图、工具感知分析、CSV 导出与自更新脚本；同期接入 Gemini CLI 会话摄取。
• 0.4.x–0.5.0：多 Claude 项目目录（含 Windows/WSL 混合环境）、应用内 resync、Copilot CLI 与 OpenCode 会话支持、可复制的 Session ID、符号链接跟随。
• 0.6.0–0.8.0：会话过滤器、postMessage主题控制、会话 DAG 视图（检测 fork 与分支关系）、可过滤项目 typeahead。
• 0.10.0：Amp、VS Code Copilot、OpenClaw 三个新 Agent；Tauri 桌面壳进入开发；s键星标、消息布局切换（Default/Compact/Stream，l键）、按 Agent 折叠侧边栏、按块类型过滤、行内子代理转录查看（Task/Agent 工具调用按需加载完整子对话）。

这一阶段确立了 AgentsView 的基本形态：SQLite 本地归档 + 文件监听增量同步 + Web 浏览界面。

四、阶段二（0.11.0 → 0.19.0，2026-03）：CLI 化、远程访问与桌面分发

• 0.11.0：新增agentsview sync（不启动 HTTP 服务即可灌库，--full强制全量重同步）；会话重命名、软删除（回收站+撤销）、置顶消息、星标持久化到 SQLite；单轮会话默认过滤。
• 0.13.0：集中式 Settings 页；远程访问（bearer token 认证、可信公网 origin、托管 Caddy 反向代理模式）；子代理/团队树形视图。
• 0.14.0：会话内搜索（Cmd+F/Ctrl+F）、Zencoder CLI、GitHub Copilot CLI 恢复（resume）、Linux 桌面以 AppImage 交付。
• 0.15.0：agentsview token-use机器可读 Token 用量命令。
• 0.16.0：会话 URL 深链、多主机标签与过滤、Focused 转录模式、Del键删除、Kimi 支持，以及里程碑式的PostgreSQL 推送同步与只读服务（pg push/pg serve）；开始向 PyPI 发布平台轮子。
• 0.17.0–0.17.1：活动小地图（可点击跳转）、可拖拽侧边栏、Codex 子代理结果事件；pg serve启动时自动执行 PostgreSQL schema 迁移，降低升级摩擦。
• 0.18.0：Claude.ai / ChatGPT 导出包导入（含图片）；Token 指标进入面包屑、分析页与 CSV 导出；roborev 自动化会话默认过滤。
• 0.19.0：Warp、Hermes（CLI/Discord/webhook/cron 多平台分组）、Cortex Code、Kiro CLI/IDE（含 unified diff 渲染）、Cursor 历史与--resume；pg push增加--projects/--exclude-projects/--all-projects项目过滤，agentsview projects命令列出项目与会话数。

从源码结构看，这一阶段的pg push/pg serve对应 internal/postgres 目录下的 140 余个 Go 文件，是该版本之后最活跃的子系统之一。

五、阶段三（0.20.0 → 0.27.0，2026-04）：成本分析与 Token 计费体系成型

这是与“钱和 Token”直接相关的阶段，命令行参数值得逐条继承：

• 0.20.0：agentsview usage daily（按天报告 Token 与估算成本，定价来自 LiteLLM 目录并内置离线回退）与agentsview usage statusline（当前日用量）；OpenHands CLI（浅层监听模式，避免 inotify 耗尽）与 Positron Assistant 支持。
• 0.21.0：Web 端/usageToken 用量仪表盘——汇总卡片、成本时序图、按项目/模型/Agent 切换的成本 treemap、按成本 Top 会话、缓存效率面板；过滤状态写回 URL 便于分享。
• 0.22.0：成本跟踪扩展到 OpenCode 与 Pi；修复 Claude 流式消息被重复记录导致历史输入 Token 约 2 倍膨胀的问题（升级后首次usage触发全量重算）。
• 0.23.0：Server-Sent Events 实时刷新；会话智能（健康信号、结果分类、评分徽章）；agentsview sessionCLI（列表/查看/导出/同步/监视的编程界面）；/api/v1/sessions/{id}/mdMarkdown 导出；SSH 远程同步；PostgreSQL 后端用量报告；实验性agentsview stats窗口报告。
• 0.24.0：OpenCodestorage/布局自动识别；自定义模型定价（~/.agentsview/config.toml中[custom_model_pricing.<model>]表）；自动化会话模式（[automated] prefixes、substrings、exact_matches，配合分类器哈希在启动时重打标签）。
• 0.26.0：Trends 页（最多 12 个词条、cat|cats变体、日/周/月粒度、按消息量归一化）；Session Vital Signs 面板（总时长、最慢调用、分类时间线、可内联展开的子代理）；默认日期窗口改为滚动窗口；全量重同步性能从约 1 分 17 秒降至约 34 秒（批量写入 + savepoint + 单次 FTS 重建）。
• 0.27.0：官方 Docker 镜像（多架构，Dockerfile+docker-entrypoint.sh+docker-compose.prod.yaml，PG_SERVE=1切换只读模式）；会话状态指示器（termination_status列，六种视觉状态：working/waiting/idle/stale/unclean/quiet，支持?termination=URL 过滤）；Copilot CLI 使用workspace.yaml的name作为会话标题。

计费体系的关键实现细节散布在 internal/db/pricing.go、internal/pricing 与 cmd/agentsview/usage.go 中；Changelog 中反复出现的“点号模型名回退为连字符目录键”（0.32.1 修复，如claude-opus-4.7→claude-opus-4-7）说明模型 ID 归一化是成本正确性的前置条件。

六、阶段四（0.28.0 → 0.35.0，2026-04/05）：存储后端矩阵——PostgreSQL、DuckDB 与共享同步

• 0.28.0：Forge（.forge.dbSQLite，9 个专有工具名映射到统一分类学）；折叠工具块头部预览最有意义字段（TodoWrite/TaskCreate/Skill 等）；Codexspawn_agent链接到子代理会话；agentsview stats的 git 结果指标改为显式--include-git-outcomes/--include-github-outcomes。
• 0.29.0：Piebald（app.db只读解析，sub_agent_chat_id内联子代理）；worktree 项目映射（按机器隔离的worktree_project_mappings表，可回溯应用于已导入会话）。
• 0.30.0：本阶段最重要的安全与检索升级：
  • 会话内容搜索：agentsview session search <pattern>，支持子串、RE2 正则与 FTS5 分词三种模式，覆盖消息体、工具输入与工具结果；HTTP 端点GET /api/v1/search/content；片段各带约 60 字符上下文并按 rune 边界对齐；命中密钥规则的值默认脱敏，仅 localhost 可加--reveal。
  • 密钥扫描：internal/secrets规则包（AWS、sk-ant-…、ghp_…、github_pat_…、Slack、Stripe、Google API、PEM 私钥等确定级规则 + 可选候选级：basic-auth URL、JWT、高熵赋值）；agentsview secrets命令组；会话携带secret_leak_count摘要，session list --has-secret过滤。
  • agentsview session usage <id>：单会话 Token 与成本报告（输出/峰值上下文 +~$X.XX估算，--format json），复用 LiteLLM 表与custom_model_pricing，无 daemon 时按需同步目标会话。
  • Google Antigravity IDE/CLI、Qwen Code、QClaw、WorkBuddy（内联子代理<sessionId>:subagent:<subagentId>）、Kiro CLI SQLite 存储、PostgreSQL 策展元数据（starred_sessions、pinned_messages两表，pin 以source_uuid对齐以抵御重解析导致的 ordinal 漂移）。
• 0.31.0：Antigravity 解密轨迹旁车（agy-reader 进程外解密写出的<uuid>.trajectory.json），作为不可信输入处理（未知步类型跳过、读取限量）；密钥规则再扩 6 条（OpenAIsk-proj-/sk-svcacct-/sk-admin-、GitLabglpat-、npmnpm_、PyPI macaroon、Hugging Facehf_、SendGridSG.）；CLI 摘要区分 definite/candidate 两级计数。
• 0.32.0：Antigravity CLI SQLite 会话（.db-wal/.db-shm纳入变更检测）；Copilot CLI Token 用量（assistant.message输出 Token +session.shutdown的modelMetrics汇总）；GET /api/v1/sessions/{id}/usageREST 端点；pg push --watch前台推送监视器（--debounce合并文件变更、--interval周期下限、瞬断重连）与agentsview pg service（macOS 上安装为 per-user launchd 服务、Linux 上为systemd --user服务）。
• 0.33.0：DuckDB 镜像后端——duckdb push把本地 SQLite 归档单向镜像到~/.agentsview/sessions.duckdb，duckdb serve从镜像跑只读 Web UI，duckdb quack serve通过 Quack 远程协议暴露；[duckdb]配置节；除windows/arm64（上游绑定无预编译库）外所有二进制都链接 DuckDB 驱动。同期：Command Code、Zed 支持；秘密 Gist 发布（未列明但需注明 secret gist 无访问控制）；原生 Windows ARM64 构建；[[remote_hosts]]配置节（裸agentsview sync依次 SSH 同步全部主机，失败主机报告并跳过）；会话头部成本徽章（<$0.01下限，$100 以下两位小数）；Shiki 语法高亮（12 语言内置，>50KB 或 >800 行跳过，按需懒加载）。
• 0.35.0：HTTP daemon 远程同步（远程主机经本地 daemon 同步而非每次 CLI 直接操作）；pg serve支持策展与洞察；只读agentsview mcp服务器（MCP 客户端可搜索会话、查看消息窗口、汇总用量）；Recent Edits顶层信息流（跨会话文件编辑 + 跳回发起编辑的消息）；批量选择/删除；S3 兼容对象存储发现（S3/MinIO/R2/OSS，先支持 Claude 与 Codex）；中文本地化；UI 字号缩放与高对比度；分析页模型过滤；洞察导出/发布；IcodeMate；Cursor 管理员用量摄取；Kimi 成本估算；每远程主机独立同步间隔；命名 PostgreSQL 推送目标（各目标独立连接与水位线）；离线 LiteLLM 定价回退数据。

对应仓库中的实现入口：internal/duckdb（73 个 Go 文件的 DuckDB/Quack 子系统）、internal/postgres、cmd/agentsview/duckdb.go、cmd/agentsview/pg.go、cmd/agentsview/pg_service.go 及按平台拆分的 pg_service_launchd.go / pg_service_systemd.go，docs/duckdb.md、docs/pg-sync.md 分别给出完整部署说明。

七、阶段五（0.36.0 → 0.43.0，2026-06 → 09）：语义检索、Recall 知识与托管原始同步

• 0.36.0：任意两个项目/模型切片的成本对比（GET /api/v1/usage/pairwise-comparison）；畸形行徽章（parser_malformed_lines计数）；繁体中文；Claude 从任意消息 fork（把转录渲染到选定点生成临时 prompt 并在会话工作目录启动claude）；Git 分支过滤（GET /api/v1/branches返回带不透明 token 的(project, branch)对，project 级 token 区分同名分支）；Antigravity 未知 schema 的Unverified schema徽章（agy-schema:<prefix>指纹 +decode_confidence: "low"）。
• 0.37.4：首次 HTTP 同步后的增量远程同步（远端清单对比逐主机持久镜像，不足一半需拉取时才拉取；远端删除只清镜像不删归档会话）；GPT-5.6 全系（基础别名与 Sol/Terra/Luna 变体）内置回退定价；session list默认排除项在 stderr 上可见（结构化 stdout 不变）。
• 0.38.0：桌面深链（在 Codex Desktop / Claude Code 中打开本地线程）+ macOS 菜单栏常驻；agentsview daemon start|status|restart|stop生命周期命令（只管理可写 SQLite daemon，不触碰只读 PG/DuckDB 服务，报告启动状态、URL、PID、运行中版本与运行时长）；实验性 Recall（词法查询、任务简报、转录证据校验、审查状态、取代关系、度量事件、dry-run 提取）；pgvector 语义/混合搜索（pg push复制当前嵌入代次的变更块，pg vectors list|drop管理代次）；命令面板选择 Semantic/Hybrid/Full text 三种模式；阅读进度记忆与Shift+J/Shift+K用户 prompt 导航；嵌入构建全程可视（阶段/模型/维度/块进度/吞吐/预计完成）；Matryoshka 降维（request_dimensions进入代次指纹并逐条校验响应）；Skill 用量趋势；Grok Build、ZCode 会话；稳定的 v1agentsview version --json契约；无内容的会话证据导出（0.38.0/0.38.1 误标为 v1，现更正为 v2）。
• 0.39.0：Poolside Agent CLI、RooCode、Kilo (legacy)、Trae（旧版内联消息可读，新加密布局返回不支持提示）；Recall 提取实验特性（可选调度的本地模型处理、代次管理、证据校验、关键词/语义/混合检索、只读证据面板；保持本地且仅 SQLite）；法语；命令面板内完成语义搜索配置与索引构建；agentsview usage daily --json --breakdown按机器拆分；子代理成本计入父会话；实验性可移植会话格式奠基（本版本无对应导入导出命令）。
• 0.40.0：顶层Data 工作区（项目目录、归档级项目重分配预览、按机器 worktree 映射管理）；Recall 语料库浏览（按项目/类型/代次/审查状态过滤，证据链回跳转录）；agentsview sync --target共享文件夹工件交换（各归档记录进度、导入对端发布的修订；手工流程，不含原始 provider 文件与可变策展，无调度器）；版本化报告导出export hour/export day/export digest（闭 UTC 小时 + 内容摘要，客户端可检测修正并整小时替换）；[[session_sources]]来源机器标签；Omnigent 与 Kimi Work 会话；服务端图表色板选择；sessionKind/promptSource元数据保留。工程层面：金额以整数微美元（microdollar）存储消除浮点舍入，版本化 JSON 报告使用微美元对象；LiteLLM 目录每日自动刷新。
• 0.41.0：DeepSeek Harness、TraeX (TRAE CLI 2.0)、Codebuff/Freebuff、Prime Agent（保留 Pi 系 fork 与递归 LLM 调用用量）、Goose；Gemini Apps 导入（agentsview import --type gemini-apps，Takeout 导出，每条Prompted记录为单轮会话且保留导出时区）；OpenAI 兼容/chat/completions洞察端点；工具结果 raw/Markdown 切换；Recall 生成洞察（Generated insights）与规则化发现（Quality 页）分离；agentsview session usage <id> --own-only（只报本会话直接用量）；agentsview usage statusline --json版本化 JSON。
• 0.42.0：agentsview raw-sync watch（多机原始会话文件持续上传，断点续传 + 本地检查点；设备注册/服务端解析/服务端嵌入仍属预览外的运维预置能力）；agentsview capture run/capture report（一次性自动 Claude/Codex 运行的用量测量，保留源文件与子进程退出状态，输出带版本用量报告，中断后可恢复）；Cursor IDE 与 IcodeMate CLI 会话；Posit Assistant 缓存预热/分类器请求计入成本；S3 发现开放给更多 provider（受“单对象装下一次会话”约束）；日语界面；OpenRouter 定价目录；按事件发生时的历史费率估算成本（当日有带日期目录价时）；include_source=true在 API 响应中可选返回来源路径；Recall 提取策略[recall.extract] candidate_findings = "allow"（确定级发现仍阻断，默认"block"两类都阻断）。

0.43.0（2026-09-14）：最新稳定版特性全解

0.43.0 是当前最新发布，新增特性均可在仓库中找到实现或配置入口，逐项说明如下：

新特性（完整清单）

1. Tau、Evener v2 与 Open Code Review 会话：支持浏览与搜索，含已记录推理、工具结果与 Token 用量；Open Code Review 还包含结构化评审意见与 resume 链接。

2. OpenCode 2.0 beta 对话导入：跨升级保留历史；工具结果保留内嵌图片与文件；PDF 保留在原始结果中（无预览）。

3. Cursor CLI 子代理转录：显示在发起它们的会话之下（含从 S3 导入的转录）。只跑用量命令的用户需执行agentsview sync导入既有子会话。

4. 桌面会话深链：agentsview://sessions/<session-id>打开桌面会话；追加?msg=<ordinal|last>跳转到指定消息。

5. 远程 resume 命令复制：“Copy command” 复制受支持远程会话的恢复命令，粘贴到持有该转录的机器 shell 中执行。

6. 归档内容策略archive_content（config.toml）：

   • full（默认）：存全部已解析字段；
   • transcripts：保留消息文本、推理文本与标题，省略工具输入/输出；
   • usage：只保留用量核算所需的会话与消息行，不含对话文本。

   对既有数据应用更严格策略：重启 daemon 后执行agentsview sync --full；已删除内容的恢复依赖源文件。

   源码印证：internal/config/config.go 中ArchiveContent类型定义三个取值并带校验错误信息archive_content must be "full", "transcripts", or "usage"，默认值在 L1082 设为ArchiveContentFull；OmitsToolContent()/UsageOnly()两个判定方法被 internal/recall/extract/manager.go 等下游消费。

7. 工具结果图片三态策略（Settings 中选择 Keep / Drop / Offload）：Offload 把支持的图片存为独立资产并保留本地图片访问；改动后需重启 daemon，备份时需连同资产目录一起归档。

8. 归档内联图片预览与清理（Settings 内，支持项目与日期过滤）；agentsview db migrate --images可把图片迁移为独立资产而非删除。

9. agentsview db compact：回收未用归档空间；--dry-run预览节省量，--keep-backup保留原档；使用--staging-dir指定暂存目录前必须先停 daemon。源码印证：cmd/agentsview/db_compact.go 中--staging-dir在非直连归档路由下会报错"--staging-dir requires direct archive access; stop the daemon before using it"，与 Changelog 的运维提示完全一致；底层实现在 internal/db/compact.go。

10. Agent home 目录多注册：Settings 或配置中为 Claude/Codex/Pi 追加 home 目录；目录设置改为[agents.<id>]表，启动时自动转换旧键。HTTP 同步对端需成对升级。

11. Pi 会话发现环境变量：本地与 SSH 均识别PI_CODING_AGENT_DIR与PI_CODING_AGENT_SESSION_DIR；PI_DIR仍保持优先。

12. CJK 全文检索（可选 SQLite 扩展）：make install-cjk-fts安装。中文查询走分词，日语假名与韩语查询保留字符顺序与邻接。源码印证：Makefile 中install-cjk-fts目标依赖install simple-fts，由scripts/build-simple-fts.sh从钉住的 upstream 提交构建原生 tokenizer sidecar（libsimple.so/.dylib/dll+ jieba 词典文件），安装到与agentsview可执行文件平级的lib/agentsview/simple树；检索逻辑在 internal/db/cjk_fts_search.go 与 internal/db/cjk_fts_runtime.go。

13. 联合维度用量导出（schema 4，需显式选用）：按项目 × 模型 × Agent 联合分组；--project-key选择项目、--bucket指定活动间隔——间隔必须是一小时的整除分钟数，默认5m；导出含仓库身份信息。schema 3 仍是默认；使用 schema 1/2 的集成方必须更新并刷新已保存摘要。

14. MCPsearch_sessions日期过滤：date_from/date_to（含边界）。

15. agentsview mcp status --json：发现运行中的 HTTP MCP 监听器，含绑定端口、后端目标与 token 文件路径。实现入口 cmd/agentsview/mcp_status.go。

改进（0.43.0 摘要，完整条目见原文档）

• 会话内搜索能在折叠块与嵌套滚动区内揭示选中文字；计数与导航跟随当前过滤；带结果列表与概览；下划线ab切换整词匹配。
• Activity 页在计数、分钟、成本与徽章上区分交互会话/子代理/自动化会话；并发图将三者同时活动堆叠到每个时间区间的一根柱中。
• Claude Code 与 Codex 会话头部显示已记录推理强度（reasoning effort）；升级会重同步既有会话以回填（大归档耗时）。
• 缩放偏好统一入口：Appearance、桌面快捷键或桌面状态栏；config.toml的zoom_level只提供默认值，保留各客户端本地选择。
• “System boundaries” 块过滤器可隐藏续传/resume/中断/任务通知卡片。
• Appearance 中“未知 XML 块按预格式化文本渲染”，保留未知块内标签、空白与字面行。
• 本地 Cursor CLI 会话在有匹配 chat 数据库时可读取助手推理与记录时间戳。
• 导出会话携带archive_id（跨数据库重建追踪）以及transcript_revision、local_modified_at（区分修正与会话活动）。
• 内容搜索支持可重复的--exclude-session排除特定会话。
• agentsview usage daily构建缓存时显示准备阶段与耗时；日报使用已保存归档数据，纳入新源变更需先agentsview sync。
• 大归档下 Activity 报告与工具/Skill 分析加载更省（首次启动为建索引可能更慢）。
• 单结果事件的调用不再二次存储工具输出（tool_result_events取代tool_calls.result_content中的重复内容；既有归档重同步，PostgreSQL 镜像每会话重推一次）。
• Codex/Claude 增长中的会话同步减少重复解析；大导入内存占用更低；共享 OpenCode 数据库支持更多会话并发解析。
• 同步后刷新语义索引不再重读无关消息内容；Linux glibc daemon 重复查询内存占用更低。
• 升级后回收闲置用量缓存磁盘空间（保留在用缓存）。
• 托管 raw-sync 启动时解释缺失的数据库权限：既有运行角色还需raw_ingest_jobs表上的SELECT与UPDATE（详见 docs/hosted-raw-sync.md 的 HTTP 控制面一节）。

缺陷修复（0.43.0 摘要）：修复duckdb serve下转录空白（0.42.0 回归）；活动会话写入时用量报告可完成且允许更长的缓存准备；Windows 日用量/活动报告改用正确本地时区；Copilot 用量纳入关停前观察到的逐次 Token 并在缺少关停汇总时采用已知输出 Token；成本估算识别 Codexgpt-reserve为 GPT-5.6 Luna、Bedrock 模型名套用 Bedrock 费率、Ollama Cloud 标签解析到基础模型价（自定义覆盖仍优先）；search_sessions之外还修复了两字符 CJK 查询、非 localhost 生成报告、Recall 混合检索越过向量搜索上限、Ollama Metal runner 失败回退 CPU、Cursor 遗留工具结果文本与用户轮时间戳、Claude 无/rename时用最新生成标题、Codex guardian 评审会话挂到父线程、陈旧安装锁自动恢复、缺失会话显示可重试 not-found、SQLite 归档因 AgentsView 自身读取而循环重同步、本地增量同步 daemon 忙时可见等待（取消等待不中断既有工作）等数十项。

八、从 Changelog 能读出的工程质量信号

1. 性能数据是写进发布记录的。可复核的代表性数字：0.26.0 全量重同步 1m17s → 34s（26.7k 会话）；0.32.1 冷同步项目解析 4m31s → 1m14s（约 35.7k 会话，用廉价.git文件系统行走替代逐会话 shell 出git）；0.27.0 修复 PostgreSQL 内容三元组索引fastupdate=off（GIN 默认设置导致大归档索引膨胀“数个数量级”）。这些条目都附带了机制解释，便于读者判断自己是否受影响。
2. 测试与基准门槛随仓库交付。Makefile 提供test-short、bench-backends、bench-gate等目标，scripts/check-timing-budgets 做计时预算检查，internal/backendbench 提供跨后端基准——Changelog 中“降低空闲 CPU”“减少重复解析”这类条目大多对应此类门槛约束下的改动。
3. 解析器健壮性是被反复验证的。0.37.0 提到解析器 fuzz 加固，internal/parser 目录含 400 余个文件（含 34 个 JSON 与 24 个 JSONL 夹具），每个 Agent 的布局变化（Kimi.kimi-code、Kiro SQLite、OpenCode storage 布局、Antigravity.db/.pb/旁车等）都以“发现路径 + 优先规则 + 回退链”的方式记录在 Changelog 中，构成了一份事实上的各 Agent 存储格式演化史。
4. 安全姿态有独立文档。0.31.0 引入的 SECURITY.md 描述威胁模型、信任边界、出站通道与静态数据敏感性；密钥扫描默认脱敏、--reveal仅限 localhost、桌面更新器验证签名（0.35.1）等条目与之呼应。
5. 遥测默认开但最小化（0.33.0）：每日存活 ping（版本、commit、OS、架构、随机安装 ID），不含会话数据/路径/主机名/提示词，AGENTSVIEW_TELEMETRY_ENABLED=0关闭。

九、如何把 Changelog 与文档体系配合使用

Changelog 条目中的内链都指向分篇文档，升级前建议按主题查阅对应篇目：

十、结语

docs/changelog.md 呈现的是一条清晰的演进路径：本地 SQLite 归档与多 Agent 解析（0.1–0.16）→CLI 编程面与远程访问（0.11–0.19）→Token/成本核算体系（0.20–0.27）→PostgreSQL/DuckDB 多存储矩阵（0.28–0.35）→语义检索、Recall 知识沉淀与托管原始同步（0.36–0.43）。对运维者而言，三条最实用的行动建议是：升级跨“解析器数据版本”的次版本后预期一次更慢的首次同步（dataVersion 自动重解析）；收紧archive_content或调整工具结果图片策略后必须重启 daemon 并视需要执行agentsview sync --full；使用db compact --staging-dir前先停 daemon。这些约束既写在 Changelog 里，也能在 internal/config/config.go、cmd/agentsview/db_compact.go 与 Makefile 中得到逐条印证。

【免费下载链接】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