ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Kilo 团队用量分析(Analytics)完全指南:从仪表盘指标到项目级成本归因

2026/9/13 0:19:54 拓冰建站 浏览量
Kilo 团队用量分析(Analytics)完全指南:从仪表盘指标到项目级成本归因 Kilo 团队用量分析Analytics完全指南从仪表盘指标到项目级成本归因【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocodeKilo 的 Enterprise 或 Teams 订阅配合 Kilo Code 扩展使用 Kilo Gateway provider 时会记录详细的用量分析数据帮助组织监控和理解 AI 使用模式、成本与活动。本文基于 packages/kilo-docs/pages/collaborate/teams/analytics.md 整理并结合仓库源码如 packages/core/src/project.ts、packages/core/src/git.ts、packages/kilo-gateway/src/api/models.ts剖析项目归因、成本计算等底层原理。读完本文你将掌握如何通过Usage Details面板监控团队开销、按天/按模型/按项目下钻分析以及如何配置项目标识符实现精确的成本归因。Analytics Dashboard 概览在组织仪表盘的Usage Details用量明细区域可以访问全部用量分析数据。该面板展示的是团队使用Kilo Gateway provider的完整用量统计。用量范围说明Usage Scope此用量概览仅包含通过 Kilo Gateway provider 产生的全部用量不包含Kilo Code 扩展通过其他非 Kilo Code provider 产生的用量。扩展程序主设置页面main settings中可以自由选择使用哪个 API provider。这意味着只有通过 Kilo 官方网关即 Enterprise/Teams 订阅所绑定的 provider发起的请求才会进入本分析面板团队若在扩展中配置了其他厂商的 API key其用量不会混入本面板便于财务与成本的清晰归因。顶部核心指标Summary Metrics仪表盘顶部展示五项核心指标用于快速掌握团队在选定时间段内的整体状况指标含义Total Spent所选时间段内的总花费Total Requests发起的 API 请求总数Avg Cost per Request单次请求的平均成本Total Tokens处理的 Token 总量输入 输出Active Users发起过请求的团队成员数量从源码看成本计算依赖模型定价与 token 用量在 packages/kilo-gateway/src/api/models.ts 中网关会把 API 返回的$/token价格统一转换为$/M tokens乘以 1,000,000以便下游getUsage按每百万 token 定价计算费用同文件 models.ts#L275-L276 分别解析pricing.prompt输入价格与pricing.completion输出价格对应面板中 input/output token 的计价。当模型采用动态/自动路由定价pricing 为负值时网关会按 models.test.ts 的测试逻辑省略 cost 字段避免产生错误成本。时间范围筛选Time Period Filters面板提供四种时间范围选项Past Week最近 7 天用量Past Month最近 30 天用量Past Year最近 365 天用量All全部历史用量时间筛选作用于所有视图与指标切换后顶部五项核心指标会同步刷新为该时间窗口内的聚合值。用量视图选项Usage View OptionsOnly my usage 个人/团队切换通过Only my usage开关过滤数据范围启用仅显示你自己的个人用量数据禁用显示包含所有成员在内的团队级用量数据该开关适合个人自查单日/单模型开销或管理员查看团队整体情况。三种数据下钻视图面板提供两种日期粒度视图和一种项目视图均支持点击行展开查看明细By Day按天视图按日期聚合展示用量列包括DATE具体日期COST当日总花费REQUESTS当日 API 请求数TOKENS当日处理的 Token 总量悬停可查看 input 与 output Token 的拆分USERS当日活跃用户数查看团队数据时点击任意日期行可展开当日各成员的用量明细展示每位成员的用量、成本、请求数与 Token 数。By Model Day按模型 × 天视图按 AI 模型与日期进行细粒度拆分列包括DATE具体日期MODEL所使用的 AI 模型如anthropic/claude-sonnet-4、openai/gpt-4COST该模型在该日期的成本REQUESTS对该模型的请求数TOKENS该模型处理的 Token 量悬停可查看 input/output 拆分USERS使用过该模型的用户数点击任意行可展开查看当天使用该模型的具体团队成员及其个人用量统计。该视图最利于识别高成本模型 × 高用量日期的组合从而决定是否调整模型路由策略。By Project按项目视图除日期维度外面板还支持按项目查看用量项目名称自动从项目.git/config中名为origin的 remote 解析得到。例如若.git/config内容如下[remote origin] url gitgithub.com:example-co/example-repo.git fetch refs/heads/*:refs/remotes/origin/*则项目名解析为example-repo。从源码看这一remote → 项目标识的逻辑在核心层有完整实现packages/core/src/project.ts 中的remote函数调用git.remote.get(repo)获取 origin 的 URL再经 project.ts#L81-L103 的url/parts归一化既支持https://形式的 URL也支持githost:org/repo.git形式的 SCP 语法正则^([^/:])?([^/:]):(.)$并统一去除路径前缀、尾部斜杠与.git后缀最终以host/repo形式生成稳定的项目 ID。而git.remote.get底层执行git remote get-url origin见 packages/core/src/git.ts#L205-L209。项目 ID 的解析优先级见 project.ts#L114-L115remoteorigin URL 哈希→previous仓库缓存中的旧 ID→root首个根提交哈希若均不可用则回退到全局 ID。同时 project.ts#L124-L126 的commit方法会把解析出的 ID 写入仓库的kilo缓存文件供后续会话复用。手动覆盖项目名称如果自动解析出的项目名不符合预期例如多个仓库共用同一 origin或希望按业务线归组可以在项目的.kilo/config.json中手动覆盖项目名称旧的.kilocode/config.json仍作为回退被读取。要将项目标识符设置为my-project创建.kilo/config.json{ project: { id: my-project } }配置后该项目的用量将统一归因到my-project名下适合企业内部按产品线/部门维度聚合成本。理解数据Understanding the Data模型信息Model Information分析面板会记录不同 AI 模型的用量展示模型标识符例如anthropic/claude-sonnet-4openai/gpt-5x-ai/grok-code-fast-1mistralai/codestral-2508这些标识符采用供应商/模型的命名规范与 Kilo Gateway 的模型路由保持一致。值得注意的是网关会依据模型的output_modalities判断是否支持图像输出见 models.ts#L138-L151从而在用量统计中正确归类多模态请求。用户归因User Attribution查看团队数据时可以获取展开行中的单个团队成员用量用于识别用户的邮箱地址每位用户的成本、请求数与 Token 拆分用户维度的下钻是团队成本治理的关键管理员可以快速定位高消耗个体并结合 团队角色与权限管理 进行配额或权限调整。成本跟踪Cost Tracking所有成本均以USD美元显示并保留精细精度可帮助你监控随时间变化的支出模式识别高用量时段或高成本模型跟踪单个团队成员对成本的贡献下一步与最佳实践管理团队账单设置Manage team billing settings配置团队角色与权限Configure team roles and permissions综合建议先看 By Model Day识别成本最高的模型与用量峰值日期评估是否需要切换更经济的模型或调整路由结合 By Project 治理成本为每个业务仓库配置.kilo/config.json中的project.id让成本归因粒度对齐组织架构定期关注 Active Users结合团队规模核对活跃度避免闲置席位浪费订阅费用注意用量范围边界面板只统计 Kilo Gateway provider 的用量跨 provider 的成本对比需在扩展设置中切换 provider 后另行核对。用量分析为优化团队 AI 使用提供了所需洞察让成本与活动模式始终处于可见状态。结合上述源码机制你可以更精准地利用这些数据驱动团队级决策。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考