集中管理动态文档元数据并补充校验工作流

CONTRIBUTING.md

@@ -28,6 +28,13 @@
 - 用新数据更新基准测试
 - 修正不准确之处
 - 提高清晰度
+- 如果涉及动态指标（Stars、下载量、价格、验证日期），优先更新 `docs/data/agents-metadata.json`
+- 修改数据层前，先核对 `docs/data/SCHEMA.md`
+- 如果动态数据发生变更，同步更新 `docs/data/CHANGELOG.md`
+- 如果涉及证据完备度变化，同步更新 `docs/evidence-index.md`
+- 提交前优先运行统一检查：`python3 scripts/check_all.py`
+- 如需单独执行，可运行：`python3 scripts/check_data_schema.py`、`python3 scripts/check_repo_consistency.py` 和 `python3 scripts/check_stale_data.py`
+- `check_stale_data.py` 目前为告警型检查，主要用于提示潜在漂移
 
 ### 3. 添加示例
 
@@ -160,6 +167,12 @@
 - [ ] 信息准确
 - [ ] 写作清晰中立
 - [ ] 无不必要的格式更改
+- [ ] 动态数据已同步到 `docs/data/agents-metadata.json`（如适用）
+- [ ] 已核对 `docs/data/SCHEMA.md`（如适用）
+- [ ] 动态数据变更已记录到 `docs/data/CHANGELOG.md`（如适用）
+- [ ] 证据状态已同步到 `docs/evidence-index.md`（如适用）
+- [ ] 已运行 `python3 scripts/check_all.py`
+- [ ] 如有需要，已分别运行 `python3 scripts/check_data_schema.py`、`python3 scripts/check_repo_consistency.py` 和 `python3 scripts/check_stale_data.py`
 
 ## 我们希望覆盖的领域
 

README.md

@@ -6,6 +6,8 @@
 
 **👉 [一页总结（选型速查）](./docs/SUMMARY.md)** — 给没时间看全部文档的人
 
+> **维护说明**：高频变化的数据（Stars、下载量、价格、验证日期）开始统一沉淀到 [`docs/data/`](./docs/data/README.md)。证据完备度与验证状态见 [`docs/evidence-index.md`](./docs/evidence-index.md)。
+
 ## 核心发现
 
 ### 源码分析纠正的"常识"
@@ -29,26 +31,21 @@
 
 > Rust 二进制（50ms）比 Node.js SEA（72ms）快 30%，比 npm 包（1.5s）快 **30 倍**。Qwen Code 作为 Gemini CLI 分叉，安装仅 48MB（上游 509MB 的 9%），启动快 2.5 倍。
 
-### 实际采用量（2026-03-26 API 实时查询）
-
-| Agent | npm 周下载 | 4 周趋势 | Stars | 版本数 | 首发 |
-|-------|-----------|---------|-------|-------|------|
-| **Claude Code** | **1,020 万** | 934→951→987→1,020 万 ↑ | 83k | 359 | 2025-02 |
-| **Codex CLI** | **368 万** | 214→275→356→368 万 ↑↑ | 68k | 1,543 | 2025-04 |
-| **Gemini CLI** | 74 万 | 76→66→73→74 万 → | **99k** | 539 | 2025-06 |
-| **Copilot CLI** | 64 万 | 19→25→42→64 万 **↑↑↑** | 10k | 588 | 2025-09 |
-| **Qwen Code** | 8.4 万 | 6→16→11→8.4 万 ↑ | 21k | 353 | 2025-07 |
+### 实际采用量（汇总入口）
 
-| Agent | PyPI 月下载 | Stars |
-|-------|-----------|-------|
-| **OpenHands** | **125 万** | 70k |
-| **Aider** | 78 万 | 42k |
-| **Kimi CLI** | 45 万 | 7k |
-| **OpenCode** | — | **~132k** |
+> 高频变化数据已集中维护在 [`docs/data/agents-metadata.json`](./docs/data/agents-metadata.json)。
+>
+> 当前 README 仅保留结论性摘要，详细数字、验证日期和证据状态请查看：
+> - [`docs/data/agents-metadata.json`](./docs/data/agents-metadata.json)
+> - [`docs/evidence-index.md`](./docs/evidence-index.md)
+> - [`docs/comparison/evolution-community.md`](./docs/comparison/evolution-community.md)
 
-> **Stars ≠ 采用**：Gemini CLI Stars（99k）是 Claude Code（83k）的 1.2 倍，但 npm 下载仅其 **7%**。Copilot CLI 增长最猛（4 周 ↑240%）。
+- Claude Code、Codex CLI 在 npm 生态采用量领先
+- Gemini CLI 社区热度高，但采用量与 Claude Code 不完全同步
+- Qwen Code、Kimi CLI 在中文开发者语境下增长明显
+- OpenHands、Aider 在 Python / research-oriented 场景保持稳定关注度
 
-*数据来源：[npm Registry API](https://api.npmjs.org/)、[PyPI Stats](https://pypistats.org/)、`gh api`*
+*数据来源：[npm Registry API](https://api.npmjs.org/)、[PyPI Stats](https://pypistats.org/)、`gh api`；具体数值请以 `docs/data/agents-metadata.json` 为准。*
 
 ---
 
@@ -59,7 +56,7 @@
 | **日常编码** | Claude Code 或 Aider | 最强推理 / 最好 Git 集成 |
 | **免费使用** | Qwen Code 或 Gemini CLI | 1000 次/天免费 OAuth / Google 账号 |
 | **多模型切换** | OpenCode 或 Goose | 100+ models.dev / 58+ 提供商 |
-| **VS Code 用户** | Cline 或 Continue | 59k Stars IDE 原生 / PR Checks |
+| **VS Code 用户** | Cline 或 Continue | IDE 原生集成 / PR Checks |
 | **中文开发者** | Qwen Code 或 Kimi CLI | 6 语言 UI / 月之暗面中文模型 |
 | **CI/CD 自动化** | SWE-agent 或 OpenHands | 批量评估 / Docker 沙箱 |
 | **安全沙箱** | Codex CLI 或 Gemini CLI | 三平台 OS 沙箱 / TOML 策略引擎 |
@@ -70,25 +67,27 @@
 
 ## 快速对比表
 
-| Agent | 开发者 | 许可证 | Stars | 语言 | 提供商 | 特色 |
-|------|--------|--------|-------|------|-------|------|
-| [OpenCode](./docs/tools/opencode/) | Anomaly | MIT | **~132k** | TypeScript（Bun） | 100+ | 多客户端（TUI+Web+桌面），37 LSP |
-| [Gemini CLI](./docs/tools/gemini-cli/) | Google | Apache-2.0 | **99k** | TypeScript | 1 | 8 策略模型路由，TOML 策略引擎 |
-| [Claude Code](./docs/tools/claude-code/) | Anthropic | 专有 | **83k** | Rust | 1 | 50ms 启动，24 Hook 事件，Channels |
-| [OpenHands](./docs/tools/openhands.md) | OpenHands | MIT | **70k** | Python | 100+ | Docker 沙箱，三层安全，多代理 |
-| [Codex CLI](./docs/tools/codex-cli/) | OpenAI | Apache-2.0 | **68k** | Rust | 1 | 三平台 OS 沙箱，Cloud 远程执行 |
-| [Cline](./docs/tools/cline.md) | Cline | Apache-2.0 | **59k** | TypeScript | 48+ | VS Code 原生，Git Checkpoint |
-| [Aider](./docs/tools/aider/) | Paul Gauthier | GPL-3.0 | **42k** | Python | 100+ | 14 编辑格式，三槽位模型，/undo |
-| [Goose](./docs/tools/goose/) | Block | Apache-2.0 | **34k** | Rust | 58+ | MCP 原生，11 Platform Extension，Recipe + Cron 调度 |
-| [Continue](./docs/tools/continue.md) | Continue | Apache-2.0 | **32k** | TypeScript | 60+ | PR Checks CI 审查，语义索引 |
-| [Warp](./docs/tools/warp.md) | Warp | 专有 | **26k** | Rust | 多种 | GPU 渲染终端，块结构输出 |
-| [Qwen Code](./docs/tools/qwen-code/) | 阿里云 | Apache-2.0 | **21k** | TypeScript | 6+ | 免费 1000 次/天，Arena 多模型竞争，41 命令 |
-| [SWE-agent](./docs/tools/swe-agent.md) | Princeton | MIT | **19k** | Python | 100+ | SWE-bench 评估，Docker 沙箱 |
-| [Copilot CLI](./docs/tools/copilot-cli/) | GitHub | 专有 | **10k** | Shell | 多种 | 67 GitHub 工具，增长 ↑240%/月 |
-| [Kimi CLI](./docs/tools/kimi-cli/) | 月之暗面 | Apache-2.0 | **7k** | Python | 6 | Wire 协议，D-Mail 时间回溯 |
-| [Cursor](./docs/tools/cursor-cli.md) | Cursor | 专有 | - | TypeScript | 多种 | AI 原生 IDE，Background Agent |
-| [Qoder CLI](./docs/tools/qoder-cli/) | QoderAI | 专有 | - | Go | 多种 | Quest 模式，Claude Code 兼容 |
-| [Oh My OpenAgent](./docs/tools/oh-my-openagent.md) | code-yeongyu | SUL-1.0 | **~44k** | TypeScript | 多种 | OpenCode Harness 层，7~10 Discipline Agent |
+> 为减少动态数字重复维护，Stars / 下载量 / 免费层等高频变化数据已迁移到 [`docs/data/agents-metadata.json`](./docs/data/agents-metadata.json)。
+
+| Agent | 开发者 | 许可证 | 语言 | 提供商 | 特色 |
+|------|--------|--------|------|-------|------|
+| [OpenCode](./docs/tools/opencode/) | Anomaly | MIT | TypeScript（Bun） | 100+ | 多客户端（TUI+Web+桌面），37 LSP |
+| [Gemini CLI](./docs/tools/gemini-cli/) | Google | Apache-2.0 | TypeScript | 1 | 8 策略模型路由，TOML 策略引擎 |
+| [Claude Code](./docs/tools/claude-code/) | Anthropic | 专有 | Rust | 1 | 50ms 启动，24 Hook 事件，Channels |
+| [OpenHands](./docs/tools/openhands.md) | OpenHands | MIT | Python | 100+ | Docker 沙箱，三层安全，多代理 |
+| [Codex CLI](./docs/tools/codex-cli/) | OpenAI | Apache-2.0 | Rust | 1 | 三平台 OS 沙箱，Cloud 远程执行 |
+| [Cline](./docs/tools/cline.md) | Cline | Apache-2.0 | TypeScript | 48+ | VS Code 原生，Git Checkpoint |
+| [Aider](./docs/tools/aider/) | Paul Gauthier | GPL-3.0 | Python | 100+ | 14 编辑格式，三槽位模型，/undo |
+| [Goose](./docs/tools/goose/) | Block | Apache-2.0 | Rust | 58+ | MCP 原生，11 Platform Extension，Recipe + Cron 调度 |
+| [Continue](./docs/tools/continue.md) | Continue | Apache-2.0 | TypeScript | 60+ | PR Checks CI 审查，语义索引 |
+| [Warp](./docs/tools/warp.md) | Warp | 专有 | Rust | 多种 | GPU 渲染终端，块结构输出 |
+| [Qwen Code](./docs/tools/qwen-code/) | 阿里云 | Apache-2.0 | TypeScript | 6+ | 免费 1000 次/天，Arena 多模型竞争，41 命令 |
+| [SWE-agent](./docs/tools/swe-agent.md) | Princeton | MIT | Python | 100+ | SWE-bench 评估，Docker 沙箱 |
+| [Copilot CLI](./docs/tools/copilot-cli/) | GitHub | 专有 | TypeScript | 多种 | 67 GitHub 工具，GitHub 生态集成 |
+| [Kimi CLI](./docs/tools/kimi-cli/) | 月之暗面 | Apache-2.0 | Python | 6 | Wire 协议，D-Mail 时间回溯 |
+| [Cursor](./docs/tools/cursor-cli.md) | Cursor | 专有 | TypeScript | 多种 | AI 原生 IDE，Background Agent |
+| [Qoder CLI](./docs/tools/qoder-cli/) | QoderAI | 专有 | Go | 多种 | Quest 模式，Claude Code 兼容 |
+| [Oh My OpenAgent](./docs/tools/oh-my-openagent.md) | code-yeongyu | SUL-1.0 | TypeScript | 多种 | OpenCode Harness 层，7~10 Discipline Agent |
 
 ---
 

docs/SUMMARY.md

@@ -1,6 +1,8 @@
 # 0. 一页总结：AI 编程 Code Agent 选型
 
 > 给没时间看 34,600+ 行文档的人。2026 年 3 月。
+>
+> **维护说明**：本页包含若干动态数据摘要。更新时请先核对 [`docs/data/agents-metadata.json`](./data/agents-metadata.json) 与 [`docs/evidence-index.md`](./evidence-index.md)。
 
 ## 一句话定位
 
@@ -10,8 +12,8 @@
 | **Copilot CLI** | GitHub 原生集成，读取所有主流指令文件（CLAUDE.md/GEMINI.md/AGENTS.md），67 个内置工具 | GitHub 重度用户和企业团队 |
 | **Codex CLI** | OpenAI 官方，三平台 OS 级沙箱（Seatbelt/Bubblewrap/Windows Tokens），Rust 核心 | 安全敏感场景和 OpenAI 生态用户 |
 | **Aider** | Git 原生老牌工具，14 种编辑格式，PageRank 仓库地图，99% 一人开发 | Git 重度用户和喜欢细粒度控制的开发者 |
-| **Gemini CLI** | Google 官方，Stars 最多（99k），TOML 策略引擎，四阶段压缩算法 | Google Cloud 用户和大团队 |
-| **Qwen Code** | Gemini CLI 分叉 + 阿里云生态，每天 1000 次免费，Arena 多模型竞争模式 | 中文开发者和成本敏感用户 |
+| **Gemini CLI** | Google 官方，TOML 策略引擎，四阶段压缩算法 | Google Cloud 用户和大团队 |
+| **Qwen Code** | Gemini CLI 分叉 + 阿里云生态，提供免费层，Arena 多模型竞争模式 | 中文开发者和成本敏感用户 |
 | **Kimi CLI** | 月之暗面出品，零遥测（隐私最佳），双模式交互（TUI + Shell） | 隐私敏感用户和国内开发者 |
 | **Goose** | Block 出品后捐赠 Linux 基金会，MCP 原生架构，398 个贡献者 | MCP 生态和开源社区 |
 | **OpenCode** | 多客户端（TUI+Web+桌面），37 个 LSP，100+ 模型提供商 | 需要多客户端和 IDE 集成的团队 |
@@ -24,7 +26,7 @@
 
 ├── 企业安全合规 → Claude Code（28 条 BLOCK + 5 层设置 + 沙箱）
 ├── GitHub 深度集成 → Copilot CLI（35 GitHub 工具 + Actions/PR/Issues）
-├── 完全免费 → Qwen Code（1000 次/天）或 Gemini CLI（1500 次/天）
+├── 完全免费 → Qwen Code 或 Gemini CLI（具体额度见 docs/data/agents-metadata.json）
 ├── 隐私零遥测 → Kimi CLI（零分析）或 OpenCode（零分析）
 ├── Git 工作流控制 → Aider（/commit /undo /diff /git + 自动提交归因）
 ├── 最大模型灵活性 → Goose（58+ 提供商）或 Aider（100+ via LiteLLM）
@@ -34,15 +36,14 @@
 
 ## 关键数字对比
 
+> 动态数字（Stars、免费层、验证日期）请以 [`docs/data/agents-metadata.json`](./data/agents-metadata.json) 为准。
+
 | | Claude Code | Copilot CLI | Codex CLI | Aider | Gemini CLI | Qwen Code | Kimi CLI |
 |---|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
-| **Stars** | 82k | 10k | 67k | 42k | 99k | 21k | 7k |
 | **命令数** | ~79 | 34 | 28 | 42 | 39 | 40+ | 28 |
 | **工具数** | 20+ | 67 | 9 | — | 23 | 18 | 18 |
 | **沙箱** | ✓ | ✗ | ✓ | ✗ | ✓ | ✓ | ✗ |
 | **遥测** | 782 事件 | 有 | 有 | opt-in 10% | 194 键 | 阿里 RUM | **零** |
-| **免费层** | ✗ | 有限 | ✗ | ✗ | 1500/天 | 1000/天 | 有限 |
-| **月费** | $20-200 | $0-39 | 按量 | 按量 | 按量 | 按量 | 按量 |
 
 ## 安全等级
 

docs/comparison/features.md

@@ -175,7 +175,7 @@
 | Copilot CLI | 订阅制 | 1 premium request | 1 premium request | Copilot 订阅含配额 |
 | Cursor | 订阅制 | 1 fast request | 多个 request | Pro $20/月 500 次 |
 | Goose | API 按量 | ~$0.02-0.10 | ~$0.50-3 | 多提供商 |
-| Gemini CLI | API 按量/免费 | 免费 | ~$0.10-1 | 有免费层级 |
+| Gemini CLI | API 按量/免费 | 免费 | ~$0.10-1 | 1500 次/天免费层 |
 | OpenHands | API 按量 | ~$0.05-0.20 | ~$2-10 | 多代理消耗更高 |
 | Qwen Code | 免费/API | 免费 | 免费 | 每日 1000 次 |
 | Kimi CLI | API 按量 | ~$0.01-0.05 | ~$0.20-1 | 国内模型成本低 |