获取 AX Code · 免费文档

本页译自英文文档。命令、标识符和示例保持原样。运行时 7.24.4 · SDK 2.6.7。 英文原文

运行报告

状态:生效
范围:当前状态
最近审阅:2026-08-18
负责人:ax-code 运行时

运行报告是内置 HTTP 服务器提供的本地网页:一份工作区总览,加上按会话下钻。可以从 TUI 侧栏打开(分析 → 运行报告,打开当前会话的报告),用命令面板的 session.report.web 打开,或用 CLI 的 ax-code run-report [--index] [--open] 打开。AX Code Desktop 嵌入同样的页面。

工作区总览(/run-report)

当前项目的工作区总览,覆盖最近 30 天:

  • 用量 — 会话、消息、总令牌,以及缓存占比(缓存读取令牌占全部输入读取的比例;占比越高,表示重复读取越少)。
  • 活动 — 最近 14 天每天的令牌;悬停柱形可看精确日期、令牌数和会话数。
  • 模型用量 — 按令牌排列的主要模型,并带消息数。
  • 工具用量 — 按调用次数排列的主要工具。
  • 会话健康 — 近期会话的平均风险、就绪度分解和验证通过率。
  • 会话 — 近期会话,带令牌、风险和就绪度标记;查看 → 打开按会话的报告。

会话报告(/run-report/session/<id>)

按会话下钻。排序让每个会话都有数据的部分排在前面:

  1. 用量 — 输入、输出、推理和缓存令牌,缓存占比,时长,以及按模型的分解。
  2. 摘要 — agent 决定了什么、做了什么,并带步骤、工具和错误计数。
  3. 变更 — 按文件的变更表,带风险和差异统计。
  4. 时间线 — 执行甘特图(展开后渲染)。
  5. 活动 — 最慢的步骤、工具耗时、参与的 agent,以及回滚点。
  6. 信任部分(结论、风险、验证、分支)仅在会话对这些部分有实质内容时渲染——纯聊天或小到可以忽略的会话不会渲染空的 0/100 仪表或记分卡。只有记录了验证命令时才出现验证;只有会话存在可比较的同级分支时才出现分支。

数据来源

所有数字都来自本地 SQLite 存储:会话与消息令牌计数、按会话的事件日志(步骤、工具、时长、错误),以及风险评估。模型目录不捆绑定价数据,因此仪表板报告令牌和缓存效率,而不是估算费用。页面通过服务器发送事件实时更新,并在相关会话变化时重新加载。

  • ax-code stats — 终端令牌用量报告,带 --days、--models 和 --tools 过滤器。
  • 受支持的提供商与模型 — 连接那些模型会出现在用量分解中的提供商。