第 6 篇 收尾 · 附錄 C
來源與版本驗證清單
發布 Gemini CLI 教學前，用這份清單確認內容仍符合官方文件、目前 CLI 行為、套件版本、帳號路線、CI 權限與本地頁面品質。重點不是追求一次寫死，而是保留可重複驗證的證據。
版本敏感區域
Gemini CLI、Antigravity 轉換訊息、Gemini 3.6／3.5 Flash-Lite、登入、quota、context caching、headless 格式、安全預設、GitHub Action inputs、MCP、skills/hooks/subagents/extensions 與外部 agent 榜單都可能快速變動。這次研究的查證基準是 2026-07-26；2026-06-18 仍保留為 Gemini CLI 個人路線轉型事件日，不能代替本次模型／API checkpoint。
摘要
每次發布前至少做四件事：確認官方文件與 GitHub release/changelog、用本機 gemini --help 與互動式 /help 對照教學、檢查價格/限制/快取/認證路線、跑一次本地連結與 copy button QA。若任一項無法驗證，正文應改成「依版本確認」而不是寫成永久事實。
驗證矩陣
| 項目 | 要驗證什麼 | 證據 |
|---|---|---|
| 官方文件 | 安裝、設定、指令、headless、commands、MCP 與安全描述是否仍成立。 | 官方 docs URL、頁面日期、截圖或摘錄筆記。 |
| GitHub repo | README、releases、tags、changelog、issues 中是否有破壞性變更。 | commit/tag/release 編號。 |
| npm/package manager | 套件名稱、安裝命令、版本、Node 需求與全域/一次性執行方式。 | npm view 或套件頁版本。 |
| CLI help | gemini --help、互動式 /help、旗標、slash commands 與 exit 行為。 | 本機版本與 help 輸出日期。 |
| 模型/帳號/認證 | Google login、API key、Vertex/Cloud、企業帳號與模型路由是否描述正確。 | 實測登入路線與環境變數清單。 |
| Antigravity | 是否仍有 Gemini CLI、Antigravity 或產品定位轉換公告；以 2026-06-18 作保守檢查點。 | Google 官方 blog/公告連結。 |
| Gemini 3.6／3.5 Flash-Lite | model ID、GA／Preview、1M context、64K output、thinking default、價格與 API migration 是否仍與正文一致。 | latest-model、model page、pricing、changelog；記錄查證日。 |
| API migration | temperature／top_p／top_k、thinking_level、candidate_count、prefilled model turn、thought signatures、function response 與 Interactions steps schema。 | 模型專屬 migration、GenerateContent migration、Interactions breaking guide。 |
| Agent surface | Gemini App、Antigravity 2.0 standalone app、Antigravity CLI、managed agent、open-source Gemini CLI、AI Studio、Gemini API、Vertex AI direct、Gemini Enterprise Agent Platform、Gemini Enterprise app 是否被清楚分開；3.6 default 是否有一手證據。 | 各產品官方 model／release／help 頁；缺證據標 UNVERIFIED。 |
| 外部 agent 榜單 | Arena Agent Leaderboard 的名稱、方法、snapshot date、rank／score、樣本與 harness 邊界；不要拿來當綜合智力或價格排行。 | Arena Agent page 與官方 methodology；動態頁定期重查。 |
| 價格與限制 | Gemini API pricing、rate limits、context caching 成本與可用地區。 | pricing、rate-limit、caching 官方頁。 |
| GitHub Action | run-gemini-cli inputs、secrets、GITHUB_TOKEN permissions、log redaction。 | Action README、範例 workflow、實測 run。 |
| MCP | config 位置、server 啟動、resources/tools 顯示方式與權限邊界。 | 設定檔、/mcp 或 help 輸出。 |
| Headless | 輸出格式、JSON/文字模式、stdin、exit codes、錯誤處理。 | 小型 smoke test 與 exit code 紀錄。 |
| 安全治理 | sandbox、approval、tool permissions、檔案/網路/package/deploy 權限。 | 設定截圖、測試案例與拒絕案例。 |
| 擴充能力 | skills、hooks、subagents、extensions、custom commands 的支援度與版本差異。 | 官方文件與本機最小範例。 |
| 頁面 QA | 本地連結、側欄 active、pager、CSS/JS、code-block/copy-button 數量。 | 本地腳本輸出與瀏覽器檢查。 |
發布前清單
Gemini CLI tutorial release checklist
- [ ] Verify official Gemini CLI docs: overview, config, headless and commands.
- [ ] Check GitHub repo README, releases, tags and changelog.
- [ ] Confirm npm/package manager install command and latest version.
- [ ] Capture gemini --version, gemini --help and interactive /help.
- [ ] Re-test model/account/auth route: Google login, API key or Vertex.
- [ ] Check Antigravity transition notice; record 2026-06-18 as the event date, not the current model checkpoint.
- [ ] Verify Gemini 3.6 Flash / 3.5 Flash-Lite: model IDs, GA status, 1M/64K limits, thinking defaults and dated pricing.
- [ ] Run the API migration checklist: sampling params, thinking level, candidate count, prefilled turns, signatures, function response and Interactions steps.
- [ ] Separate Gemini App, Antigravity 2.0/CLI, managed agent, open-source Gemini CLI, AI Studio, Gemini API and Vertex/Enterprise; mark undocumented defaults UNVERIFIED.
- [ ] Capture the Arena Agent Leaderboard snapshot date, visible model names, ranks, scores and methodology; schedule a recheck because the page is dynamic.
- [ ] Re-check Gemini API pricing, rate limits and context caching.
- [ ] Verify run-gemini-cli Action inputs, secrets and GITHUB_TOKEN permissions.
- [ ] Validate MCP config, resources and tools with a minimal server.
- [ ] Smoke-test headless output formats, stderr and exit codes.
- [ ] Confirm sandbox, approval and tool permission examples.
- [ ] Mark skills/hooks/subagents/extensions as version-sensitive where needed.
- [ ] Run local link QA, sidebar active QA, pager QA and copy-button QA.本地驗證命令
gemini --version
gemini --help
gemini -p "Return only: ok"
echo $?短版發布紀錄範本
Release note: Gemini CLI tutorial verification
Date:
Verifier:
Gemini CLI version:
Package version/source:
Official docs checked:
Repo release/changelog checked:
Auth route tested:
Pricing/rate limit/caching checked:
GitHub Action checked:
MCP/headless/security checked:
Local link and copy-button QA:
Known version-sensitive notes:官方參考連結
Gemini CLI repo、Gemini CLI model selection、Gemini CLI docs、configuration、headless、commands、Google Antigravity transition、Gemini 3.6 latest-model migration、GenerateContent migration、Interactions breaking changes、Gemini API pricing、rate limits、context caching、Arena Agent Leaderboard、Arena methodology、run-gemini-cli GitHub Action、OpenAI Codex docs、Anthropic Claude Code docs