"Gemini CLI 使用教程：开发者终端 AI 助手完全指南"

# 方法一：npm 全局安装
npm install -g @anthropic-ai/gemini-cli

# 方法二：直接使用 npx（无需安装）
npx gemini-cli

# 方法三：从源码安装
git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
npm install
npm link

# 方法一：环境变量（推荐）
export GEMINI_API_KEY="your-google-ai-studio-key"

# 方法二：使用 Crazyrouter 获取更便宜的访问
export GEMINI_API_KEY="your-crazyrouter-key"
export GEMINI_BASE_URL="https://crazyrouter.com/v1"

# 方法三：配置文件
echo '{"apiKey": "your-key", "model": "gemini-2.5-pro"}' > ~/.gemini/config.json

# 在项目目录中启动
cd your-project
gemini

# 带初始提示启动
gemini "解释这个项目的架构"

# 指定模型
gemini --model gemini-2.5-pro-preview-05-06

# 代码生成
gemini "创建一个 Express.js REST API，包含用户 CRUD 操作"

# 代码解释
gemini "解释 src/auth/middleware.ts 的工作原理"

# Bug 修复
gemini "运行测试并修复失败的用例"

# 重构
gemini "将 utils.js 重构为 TypeScript，添加类型定义"

# Git 操作
gemini "查看最近的改动，写一个有意义的 commit message"

# 不进入交互模式，直接执行任务
gemini --once "给 README.md 添加安装说明"

# 管道模式：接收 stdin
cat error.log | gemini "分析这个错误日志，找出根本原因"

# 结合其他命令
git diff | gemini "review 这些代码改动，指出潜在问题"

{
  "model": "gemini-2.5-pro",
  "context": {
    "include": ["src/**/*.ts", "package.json", "tsconfig.json"],
    "exclude": ["node_modules", "dist", ".env"],
    "maxFiles": 50
  },
  "instructions": "这是一个 Next.js 14 项目，使用 TypeScript 和 Tailwind CSS。遵循项目现有的代码风格。",
  "tools": {
    "allowShellCommands": true,
    "allowFileWrite": true,
    "requireConfirmation": ["rm", "git push", "npm publish"]
  }
}

# 创建项目级指令文件
cat > .gemini/instructions.md << 'EOF'
# 项目规范

## 代码风格
- 使用 TypeScript strict mode
- 函数优先于类
- 使用 zod 做输入验证
- 错误处理使用 Result 模式

## 测试
- 使用 Vitest
- 每个函数至少一个测试
- Mock 外部依赖

## Git
- Commit message 使用 Conventional Commits
- 每个功能一个分支
EOF

# 批量重构
gemini "将所有 .js 文件转换为 .ts，添加适当的类型注解"

# 生成测试
gemini "为 src/services/ 目录下的所有文件生成单元测试"

# 文档生成
gemini "为所有公开的 API 函数生成 JSDoc 注释"

# 智能 commit
gemini "查看 staged 的改动，生成 commit message 并提交"

# PR 描述
gemini "基于这个分支的所有 commits，写一个 PR 描述"

# Code review
gemini "review 最近 3 个 commits 的代码质量"

# 冲突解决
gemini "解决当前的 merge conflicts，保留两边的功能"

# 运行测试并修复
gemini "运行 npm test，分析失败原因，修复代码直到所有测试通过"

# 性能分析
gemini "分析 src/api/handler.ts 的性能瓶颈，提出优化方案并实现"

# 错误追踪
gemini "这个 TypeError 是什么原因？追踪调用链并修复：
$(cat error.log)"

# 1. 描述需求，让 Gemini 规划
gemini "我需要添加一个用户通知系统：
- 支持邮件和站内通知
- 用户可以配置通知偏好
- 需要一个通知队列
请先规划架构，然后逐步实现"

# 2. Gemini 会：
# - 分析现有代码结构
# - 提出架构方案
# - 创建必要的文件
# - 编写代码和测试
# - 运行测试确认通过

gemini "基于 prisma schema 中的 Product 模型，创建完整的 REST API：
- GET /api/products (分页、筛选、排序)
- GET /api/products/:id
- POST /api/products (验证)
- PUT /api/products/:id
- DELETE /api/products/:id
包含错误处理、输入验证和 OpenAPI 文档"

gemini "我需要给 users 表添加 subscription_tier 字段：
- 类型：enum (free, pro, enterprise)
- 默认值：free
- 需要迁移脚本
- 更新相关的 TypeScript 类型
- 更新 API 响应格式"

# 设置 Crazyrouter 作为后端
export GEMINI_API_KEY="your-crazyrouter-key"
export GEMINI_BASE_URL="https://crazyrouter.com/v1"

# 价格对比：
# Google 直连: $1.25/百万输入 token, $10/百万输出 token
# Crazyrouter: $0.50/百万输入 token, $4/百万输出 token
# 节省 60%