源码版本索引
本站内容基于对三个仓库当前源码的只读审计，不是从 README 转写。这一页记录「依据哪一版、审计了什么、没验证什么」。
审计基线
| 项目 | 仓库 | 默认分支 | 审计 commit | 提交时间 |
|---|---|---|---|---|
| 核心程序 | wess09/AzurPilot | master | 7de6bb914da5798e76ef34a85a75648a526d319f | 2026-10-20 |
| Android 宿主 | wess09/AzurPilot-for-Android | main | 1235c0a6d2d1f1bc334545e246eee2d93db756fa | 2026-10-20 |
| 桌面启动器 | wess09/AzurPilotLauncher | main | 44a8715afef5c5be02184d9c7a08bf10a7b6c89f | 2026-10-19 |
默认分支不统一
核心用 master，另外两个用 main。旧文章里的 /blob/main/ 链接指向核心仓库会 404。
审计方法
- 以
--depth 1克隆三个仓库，记录 HEAD。 - 读取
AGENTS.md/CLAUDE.md/ README 各语言版本。 - 枚举目录结构，扫描
module/、frontend/、app/、rootfs/、server/、src/。 - 读取
docs/modules/（54 篇模块文档）、doc/（Android 31 篇、启动器 1 篇）。 - 解析
task.yaml、argument.yaml、args.json、i18n/zh-CN.json、contract.json。 - 读取
.github/workflows/与.cnb/的 CI 配置。 - 用脚本生成任务表（102 项）与 API 表（72 项），避免手抄错误。
覆盖统计
| 维度 | 数量 | 来源 |
|---|---|---|
| 任务命令 | 102 | args.json |
| 选项组 | 167 | argument.yaml |
| WebSocket 方法 | 72 | frontend/src/api/contract.json |
| MCP 工具 | 18 | mcp_server_sse.py |
| 核心模块文档 | 54 篇 | docs/modules/ |
| Python 测试文件 | 209 | tests/ |
已验证与未验证
已做（静态验证）
- 源码结构、配置字段、接口契约、CI 工作流的一致性核对。
- 文档内所有代码命令均来自仓库脚本或
AGENTS.md。 - 本站自身的构建、类型检查、链接、SEO、响应式与交互测试：31 项浏览器用例、112 个断点组合、5 页无障碍扫描。明细见站点仓库的
docs-audit/validation-report.md。
未做（需要真实环境）
| 事项 | 原因 |
|---|---|
| 真实游戏任务执行 | 需要账号、模拟器与游戏客户端，且会消耗资源 |
| 模拟器兼容性矩阵 | 需要逐款模拟器实测，仓库只提供默认 Serial |
| Android 真机全量回归 | 需要多台设备覆盖 OEM 差异；仓库只记录了 Redmi Note 10 Pro 的验证 |
| NPU 加速效果 | 依赖具体 SoC 与驱动，仓库文档明确「以实际初始化结果为准」 |
| 远程 Tunnel 连通性 | 依赖 Cloudflare 与网络环境 |
| 启动器三平台实机 | 仓库 CI 覆盖构建与单测，不覆盖真实桌面环境 |
文档不把推测写成事实
涉及上述内容时，页面会标注「待核实」或直接说明未验证，而不是给出看似确定的结论。
事实冲突的处理
| 冲突 | 采用 |
|---|---|
| 源码 vs README | 源码优先 |
| 配置 schema / 测试 vs 文档 | schema 与测试优先 |
| 两个仓库文档互相矛盾 | 标注差异并以代码为准（例如 Android 版本号基线） |
素材来源
| 素材 | 来源 | 许可 |
|---|---|---|
| Android 截图 | AzurPilot-for-Android/docs/screenshots/ | AGPL-3.0 |
| 启动器截图 | AzurPilotLauncher/screenshots/ | GPL-3.0 |
| WebUI 截图 | AzurPilot/doc/GUI.png | GPL-3.0 |
| 项目 Logo | AzurPilot/doc/logo.webp | GPL-3.0 |
| 架构图 | 本站原创 SVG | Apache-2.0 |
| 图标 | 本站原创 SVG / Lucide | ISC |
未使用任何游戏内美术素材。界面截图中出现的游戏画面属于原权利方。
文档更新策略
- 三个仓库更新后，重新跑
scripts/extract-tasks.py、scripts/extract-api.py、scripts/extract-config.py。 - 对比生成数据的 diff，人工判断哪些行为变化需要改文案。
- 更新本页的 commit 与日期。
- 不在未读源码的情况下根据 Issue 或群聊补文档。
审计记录
站点仓库的 docs-audit/ 下保存：
| 文件 | 内容 |
|---|---|
source-inventory.md | 三仓库目录与关键文件清单 |
coverage-matrix.md | 功能 → 源码 → 文档 → 验证状态 |
source-versions.json | 机器可读的版本记录 |
unresolved-items.md | 待核实清单 |
validation-report.md | 构建、浏览器、SEO 验收结果 |