AI 写码占比，除了看「接受率」，还能怎么量？试试 aicode-ratio
这段时间里，有多少提交、多少变更文件，是通过 AI 编程助手编辑的？ 或者借助 Tab 辅助的？
这可能是很多团队在月底复盘时，说不清的一个问题。 大家都说在使用 AI Agent 编程， 可能连 Hermes 工程都使用上了， 但是就是没有一个指标来量化这个占比。 虽然厂商提供了一些接受率相关的指标，但是接受率不等于ai代码占比。
于是我就自己开发了 aicode-ratio 这个工具，来解决这个问题。
aicode-ratio 用常见的 AI 编程助手提供的 Hooks 能力， 记录本机路径与时间，再与 Git 提交对齐，
输出 Markdown / JSON / CSV，口径透明、数据默认留在仓库侧，适合作为厂商面板之外的补充指标。
aicode-ratio 在解决什么问题？
AI 编程已经进了日常开发流程，但「量化」往往只有两类：
一是厂商自带的 Acceptance / 采纳率 漏斗，好看，但定义跟着产品走，也不一定和 Git 上的合并节奏 对齐；
二是靠感觉或口头描述——复盘会上很难对齐口径。
aicode-ratio 想做的是第三件事：在你自己的仓库与机器上，用一套可重复执行的流程，回答一个更贴近工程语境的问题——
在指定时间窗口、指定分支上，有多少比例的提交（或多少比例的不重复变更文件），曾在「该提交前后可配置的小时窗」内， 被编辑器侧 Agent / Tab 的保存/编辑行为命中？
它不是「谁写了哪一行」，而是路径级、时间对齐 Git 的粗粒度估计，适合月报、季度复盘、团队内对齐。
aicode-ratio 是怎么工作的？
- 安装：在 Git 仓库根执行初始化（例如
pnpm dlx aicode-ratio init）， 按需选择 Cursor、Claude Code、CodeBuddy、Qoder 等。 - 记日志：日常在编辑器里用 Agent / Tab 改代码时，Hooks 把文件路径与时间（及可选的本机 Git 用户信息） 追加到本地
jsonl；不记录源码正文、不记录提示词。 - 出报表：用
report子命令给出--since/--until（半开区间）， 工具读取日志与 Git 提交，按配置的时间窗做交集，输出 口径 A（按提交）、口径 B（按不重复变更文件）， 以及（在日志支持时）按本机 Git 用户维度的汇总。
输出格式支持 Markdown、JSON、CSV，方便你丢进飞书文档、内部看板或二次分析。
aicode-ratio 和厂商「接受率」是什么关系？
不互斥、不对标。 厂商指标多描述「产品内采纳行为」；aicode-ratio 描述的是「本机编辑链路与 Git 提交是否在同一时间窗内发生过关联」。
前者适合产品运营视角，后者适合研发效能、内控留痕、与发版节奏对齐的视角——数值不可直接对比，但可以在团队里并行使用。
aicode-ratio 适合谁用？
- 已经在用 Cursor / Claude Code / CodeBuddy / Qoder 等，并希望有一份能对 Git 解释的辅助报表；
- 希望指标口径可写在 README / 配置里，而不是只看一张黑箱仪表盘；
- 接受粗粒度（文件级、时间窗级），不追求行级作者鉴定的团队或个人。
aicode-ratio 的的局限性（负责任推广）
- 没有本机日志，就无法归因；换机器或未装 Hooks 的提交，工具无法「猜」是否经 AI。
- 不是行级归属；人机混写同一文件，整体仍按文件是否被触碰来计（后续会考虑增加这个能力）。
- 不能替代厂商官方 Acceptance；若需要合规意义上的「官方数字」，仍以各产品文档为准。
aicode-ratio 怎么上手
- 在仓库根：初始化
init（按文档选择编辑器与个人/团队模式）。 - 跑
doctor自检环境与 Hooks。 - 正常开发几天让日志有数据后，用
report指定时间区间出表；若使用编辑器里写入的/aicode-ratio-report， 请先与助手确认统计起止日期，再生成报表（避免默认月份与真实需求不一致）。
项目与安装方式：
- GitHub：https://github.com/ricoNext/aicode-ratio
- npm：https://www.npmjs.com/package/aicode-ratio
- 命令行短名：
acr（与aicode-ratio同一入口）
安装并初始化
pnpm dlx aicode-ratio init自检环境与 Hooks
pnpm dlx aicode-ratio doctor出报表 在使用的编辑器中，执行 /aicode-ratio-report 命令， 按照提示输入时间区间，即可生成报表。
高级用法： 团队模式
只需要在初始化时， 按照交互选择团队模式即可。
团队模式可以按开发者维度统计 AI 写码占比， 方便团队进行统计和分析。
如果你也在做 AI 辅助下的工程化度量，欢迎试用 aicode-ratio：它不会替你做所有判断，
但能给团队一张能说清边界、能复现、能对 Git 的「AI Code Ratio」底稿。
欢迎在 issue 里反馈你的场景（多仓库、CI、团队权限等），一起把「可审计的 AI 参与度」说清楚。