# 策展 · X (Twitter) 🔥

> 作者：Patrick Loeber (@patloeber) · 平台：X (Twitter) · 日期：2026-03-27

> 原始來源：https://x.com/patloeber/status/2037120306939101317

## 中文摘要

Google-gemini 推出 Gemini API 開源工具。

Google-gemini GitHub 組織提供多個實用程式庫，包括 `gemini-skills`（Gemini API skills library）、`gemini-cli`（終端 AI Agent）、`cookbook`（Gemini 指南）、`gemma-cookbook`（Gemma 指南）及 `genai-processors`（高效 AI 管線 Python 程式庫）。這些工具解決 LLM 知識截止問題，讓 Agent 透過輕量 skills 補充最新 API 最佳實務，Gemini 3 Flash 正確率達 87%、Gemini 3 Pro 達 96%。

**Gemini API Skills 程式庫**
此程式庫為 Gemini API、SDK 及模型互動提供 skills，彌補 LLM 無法跟上軟體開發快速變化的知識缺口，如新程式庫每日推出及最佳實務演進。Skills 是輕量技術，為 Agent 添加相關 context，repo 包含 Gemini API 相關應用 skills。
- `gemini-api-dev`（`skills/gemini-api-dev`）：Gemini API 應用開發最佳實務。
- `vertex-ai-api-dev`（`skills/vertex-ai-api-dev`）：Google Cloud Vertex AI 上 Gemini 應用開發，涵蓋 tools、多模態生成、快取、批次預測。
- `gemini-live-api-dev`（`skills/gemini-live-api-dev`）：Gemini Live API 即時雙向串流應用，包含 WebSocket 音頻/影片/文字串流、語音活動偵測、原生音頻功能、函數呼叫、會話管理。
- `gemini-interactions-api`（`skills/gemini-interactions-api`）：Gemini Interactions API 應用，涵蓋文字生成、多輪聊天、串流、函數呼叫、結構化輸出、影像生成、Deep Research Agent、已停用模型守則、Python 及 TypeScript SDKs。

安裝使用 [Vercel skills CLI](https://skills.sh) 或 [Context7 skills CLI](https://context7.com)：
```sh
# Vercel：互動式瀏覽並安裝
npx skills add google-gemini/gemini-skills --list

# 安裝特定 skill
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global
```
```sh
# Context7：互動式瀏覽並安裝
npx ctx7 skills install /google-gemini/gemini-skills

# 安裝特定 skill
npx ctx7 skills install /google-gemini/gemini-skills vertex-ai-api-dev
```
注意：非 Google 官方支援產品，不符合 [Google Open Source Software Vulnerability Rewards Program](https://bughunters.google.com/open-source-security)。

**Gemini CLI 終端 AI Agent**
Gemini CLI 是開源 AI Agent（Apache 2.0），將 Gemini 直接帶入終端，提供輕量存取，從 prompt 到模型的最直接路徑。文件見 [geminicli.com/docs](https://geminicli.com/docs/)，Wiki 見 [codewiki](https://codewiki.google/github.com/google-gemini/gemini-cli?utm_source=badge&utm_medium=github&utm_campaign=github.com/google-gemini/gemini-cli)。
- 免費額度：60 req/min、1,000 req/day（個人 Google 帳號）。
- Gemini 3 模型：改善推理、1M token context window。
- 內建工具：Google Search grounding、檔案操作、shell 指令、網頁擷取。
- 可擴展：MCP（Model Context Protocol）支援自訂整合。
- 終端優先：適合終端生活的使用者。
- 開源：Apache 2.0。

快速安裝：
```bash
# npx（無需安裝）
npx @google/gemini-cli
```
```bash
npm install -g @google/gemini-cli
```
```bash
brew install gemini-cli  # macOS/Linux Homebrew
```
```bash
sudo port install gemini-cli  # macOS MacPorts
```
```bash
# Anaconda（受限環境）
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli
```

發行節奏（詳見 `docs/releases.md`）：
- Preview：每周二 UTC 23:59，未完全驗證，可能有 regressions。
  ```bash
  npm install -g @google/gemini-cli@preview
  ```
- Stable：每周二 UTC 20:00，上周 preview 完整升級 + bug 修復。
  ```bash
  npm install -g @google/gemini-cli@latest
  ```
- Nightly：每日 UTC 00:00，main branch 變化，可能有待修問題。
  ```bash
  npm install -g @google/gemini-cli@nightly
  ```

主要功能：
- **程式碼理解與生成**：查詢/編輯大型程式庫、從 PDF/影像/草圖生成應用（多模態）、自然語言除錯。
- **自動化與整合**：自動化 PR/rebases 查詢、MCP 伺服器如 [media generation with Imagen, Veo or Lyria](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)、非互動腳本。
- **進階功能**：內建 [Google Search](https://ai.google.dev/gemini-api/docs/grounding) grounding、對話檢查點、自訂 `GEMINI.md` 檔案。
- **GitHub 整合**：使用 [**Gemini CLI GitHub Action**](https://github.com/google-github-actions/run-gemini-cli) 進行 PR 審核、issue 分類、提及 `@gemini-cli`、自訂工作流程。

驗證方式：
1. **Google 登入**（個人/ Gemini Code Assist License 最佳）：免費 60 req/min、1,000 req/day；Gemini 3 1M tokens；無 API key。見 [quota limits](https://cloud.google.com/gemini/docs/quotas)。
   ```bash
   gemini  # 選擇 Sign in with Google
   export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"  # 若用付費 Code Assist
   gemini
   ```
2. **Gemini API Key**（模型控制/付費額度最佳）：免費 1000 req/day。取得 key：[aistudio.google.com/apikey](https://aistudio.google.com/apikey)。
   ```bash
   export GEMINI_API_KEY="YOUR_API_KEY"
   gemini
   ```
3. **Vertex AI**（企業/生產）：進階安全、高額度。見 `docs/get-started/authentication.md`。
   ```bash
   export GOOGLE_API_KEY="YOUR_API_KEY"
   export GOOGLE_GENAI_USE_VERTEXAI=true
   gemini
   ```

入門指令：
```bash
gemini  # 目前目錄
gemini --include-directories ../lib,../docs
gemini -m gemini-2.5-flash
gemini -p "Explain the architecture of this codebase"  # 非互動
gemini -p "Explain the architecture of this codebase" --output-format json
gemini -p "Run tests and deploy" --output-format stream-json  # 串流事件
```

範例：
- 建立 Discord bot 使用 FAQ.md 回答問題：
  ```bash
  cd new-project/
  gemini
  > Write me a Discord bot that answers questions using a FAQ.md file I will provide
  ```
- 分析昨日程式碼變更：
  ```bash
  git clone https://github.com/google-gemini/gemini-cli
  cd gemini-cli
  gemini
  > Give me a summary of all of the changes that went in yesterday
  ```

文件涵蓋 `docs/get-started/index.md`（快速入門）、`docs/reference/commands.md`（指令如 `/help`、`/chat`）、`docs/cli/gemini-md.md`（context 檔案）、`docs/tools/mcp-server.md`（MCP 伺服器）、`ROADMAP.md` 等。MCP 配置於 `~/.gemini/settings.json`，如 `@github List my open pull requests`。

**Gemini Cookbook 實作指南**
提供 Gemini API 結構化學習路徑，聚焦教程與範例。完整文件：[ai.google.dev](https://ai.google.dev/gemini-api/docs)。Gemini 3 更新見 [Get Started Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Get_started.ipynb#gemini3) 及 [thinking Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Get_started_thinking.ipynb#gemini3)，包含遷移指南。

新功能：
- **Lyria 3**：音樂生成，30s 片段、全歌、image-to-music。[Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Get_started_Lyria.ipynb)
- **Nano-Banana 2**：影像生成，512px、thinking、search/image grounding。[Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Get_Started_Nano_Banana.ipynb#nano-banana-pro)
- **Veo 3.1**：影片生成、image-to-video、video extension。[Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Get_started_Veo.ipynb)
- **Gemini Robotics-ER 1.5**：空間理解與推理，用於機器人。[Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/gemini-robotics-er.ipynb)
- **File Search**：RAG grounding。[Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/File_Search.ipynb)
- **Google Maps Grounding**：[Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Grounding.ipynb)
- **Batch API**：大批量請求，最高 90% 折扣。[Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Batch_mode.ipynb)

Quickstarts 與 Examples 涵蓋驗證（`quickstarts/Authentication.ipynb`）、Live API、Veo/Imagen、Grounding、Code Execution 等；Examples 如 Browser as a tool（`examples/Browser_as_a_tool.ipynb`）、Animated Story（`examples/Animated_Story_Video_Generation_gemini.ipynb`）。Demos 包括 Gemini CLI、[Multimodal Live API Web Console](https://github.com/google-gemini/multimodal-live-api-web-console) 等。SDKs：Python、Go、Node.js 等。求助：[Google AI Developer Forum](https://discuss.ai.google.dev/)。

**Gemma Cookbook 開源模型指南**
Gemma 是 Google DeepMind 開發者導向開源模型，使用與 Gemini 相同技術，可能產生幻覺。模型家族：
- Core：Gemma、[Gemma 2](https://ai.google.dev/gemma/docs/core/model_card_2)（2B/9B/27B）、[Gemma 3](https://ai.google.dev/gemma/docs/core/model_card_3)（1B/4B/12B/27B，長 context）、[Gemma 3n](https://ai.google.dev/gemma/docs/gemma-3n/model_card)（低資源裝置）。
- Variants：[CodeGemma](https://ai.google.dev/gemma/docs/codegemma)、[MedGemma](https://developers.google.com/health-ai-developer-foundations/medgemma)（4B 多模態/27B 文字，醫療）、[PaliGemma 2](https://ai.google.dev/gemma/docs/paligemma/model-card-2)、[ShieldGemma 2](https://ai.google.dev/gemma/docs/shieldgemma/model_card_2) 等。

Notebook 見各 README.md，MedGemma 額外 notebook：[Google-Health](https://github.com/Google-Health/medgemma/tree/main/notebooks)。GCP 額外 notebook：[generative-ai/open-models](https://github.com/GoogleCloudPlatform/generative-ai/tree/main/open-models)。求助：[developer forum](https://discuss.ai.google.dev/c/gemma/10) 或 [issues](https://github.com/google-gemini/gemma-cookbook/issues)；翻譯版：[繁體中文](https://github.com/doggy8088/gemma-cookbook)、[簡體中文](https://github.com/xiaoxiong1006/gemma-cookbook)。

**GenAI Processors 程式庫**
輕量 Python 程式庫（Apache 2.0，PyPI `genai-processors`），建構模組化、非同步、可組合 AI 管線，解決 LLM API 碎片化問題。文件：[google-gemini.github.io/genai-processors](https://google-gemini.github.io/genai-processors/)。核心 `Processor` 雙介面處理非同步多模態資料串流。

範例 `EchoProcessor`：
```python
from typing import AsyncIterable
from genai_processors import content_api
from genai_processors import processor

class EchoProcessor(processor.Processor):
  async def call(
      self, content: content_api.ProcessorStream
  ) -> AsyncIterable[content_api.ProcessorPartTypes]:
      async for part in content:
          yield part
```

消費者介面：
```python
# 輸入自動轉 Parts
input_content = ["Hello ", content_api.ProcessorPart("World")]

# 收集輸出
result: content_api.ProcessorContent = await simple_text_processor(input_content).gather()

# 僅文字
print(await simple_text_processor(input_content).text())

# 串流
async for part in simple_text_processor(input_content):
  print(part.text, end="")
```

特點：
- 模組化：`Processor`/`PartProcessor` 以 `+` 鏈結、`//` 平行。
- 整合 GenAI API：`GenaiModel` 輪次呼叫、`LiveProcessor` 即時串流。
- 擴展：繼承基類或函數裝飾器。
- 豐富內容：`ProcessorPart` 包裝 `genai.types.Part`，支援文字/影像/音頻/JSON。
- 非同步：基於 `asyncio`。
- 串流管理：分割/串接/合併。

安裝（Python 3.10+）：
```bash
pip install genai-processors
```

入門 Colabs：
- [Content API](https://colab.research.google.com/github/google-gemini/genai-processors/blob/main/notebooks/content_api_intro.ipynb)
- [Processor Intro](https://colab.research.google.com/github/google-gemini/genai-processors/blob/main/notebooks/processor_intro.ipynb)
- [Create Processor](https://colab.research.google.com/github/google-gemini/genai-processors/blob/main/notebooks/create_your_own_processor.ipynb)
- [Live API](https://colab.research.google.com/github/google-gemini/genai-processors/blob/main/notebooks/live_processor_intro.ipynb)

範例：`examples/realtime_simple_cli.py`（即時音頻 Agent）、`examples/live_commentator/README.md`（即時評論 Agent）。使用 Gemini 時審閱 [Terms of Service](https://ai.google.dev/gemini-api/terms)。

## 標籤

Gemini Cli, CLI, SDK, 教學資源, 新產品, 開源專案, Gemini, Google, Gemma