源碼版本索引
本站內容基於對三個倉庫當前源碼的只讀審計，不是從 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 驗收結果 |