"Gemini CLI 使用教程：Google 命令行 AI 助手完全指南"

# 确保已安装 Node.js 18+
node --version

# 全局安装 Gemini CLI
npm install -g @anthropic-ai/gemini-cli

# 或使用 npx 直接运行（无需安装）
npx @google/gemini-cli

# 克隆仓库
git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli

# 安装依赖
npm install

# 构建
npm run build

# 链接到全局
npm link

gemini --version
gemini --help

gemini

# 选择认证方式：
# 1. Google 账号登录（推荐，有免费额度）
# 2. API Key（使用 Google AI Studio 的 key）
# 3. Vertex AI（企业用户）

# 启动后选择 "Login with Google"
# 浏览器会打开认证页面
# 登录后自动获得每日免费额度

# 设置环境变量
export GEMINI_API_KEY="your-api-key"

# 或在配置文件中设置
echo '{"apiKey": "your-api-key"}' > ~/.gemini/config.json

# 设置 Crazyrouter 作为 API 端点
export GEMINI_API_KEY="your-crazyrouter-key"
export GEMINI_API_BASE="https://api.crazyrouter.com/v1"

# 启动交互模式
gemini

# 在提示符中输入问题
> 解释一下 Python 的 GIL 是什么？

# 多行输入（按 Shift+Enter 换行）
> 帮我写一个 Python 脚本，要求：
  1. 读取 CSV 文件
  2. 过滤掉空行
  3. 按第二列排序
  4. 输出为新的 CSV

# 直接提问（非交互模式）
gemini "解释 Docker 和 Kubernetes 的区别"

# 管道输入
cat error.log | gemini "分析这个错误日志，找出根本原因"

# 文件输入
gemini "审查这段代码的安全性" < main.py

# 分析单个文件
gemini "解释这个文件的功能" -f src/auth.py

# 分析多个文件
gemini "这两个文件之间的关系是什么？" -f src/api.py -f src/models.py

# 分析整个目录
gemini "总结这个项目的架构" -f src/

# 审查 Git 变更
git diff | gemini "审查这些代码变更，指出潜在问题"

# 审查特定提交
git show HEAD | gemini "审查这个提交，评估代码质量"

# 审查 PR
git diff main..feature-branch | gemini "审查这个 PR 的所有变更"

# 生成代码
gemini "用 Go 写一个 HTTP 中间件，实现请求限流（令牌桶算法）"

# 生成测试
gemini "为这个函数生成单元测试" -f src/utils.py

# 生成文档
gemini "为这个 API 生成 OpenAPI 文档" -f src/routes/

# 理解项目结构
gemini "分析这个项目的目录结构和技术栈" -f .

# 查找特定功能
gemini "用户认证逻辑在哪些文件中？" -f src/

# 依赖分析
gemini "分析 package.json 中的依赖，哪些可以升级？" -f package.json

# 分析错误
gemini "这个错误是什么意思？如何修复？" <<EOF
TypeError: Cannot read properties of undefined (reading 'map')
    at UserList (src/components/UserList.jsx:15:23)
    at renderWithHooks (node_modules/react-dom/...)
EOF

# 分析性能问题
gemini "分析这个 SQL 查询的性能问题" -f slow_query.sql

# 分析日志
tail -100 /var/log/app.log | gemini "分析最近的错误模式"

# 使用自定义角色
gemini --system "你是一个资深 Go 开发者，专注于高性能后端开发" \
  "设计一个高并发的消息队列系统"

# 使用配置文件中的预设
# ~/.gemini/presets/code-reviewer.json
{
  "system": "你是一个严格的代码审查者。关注：安全性、性能、可维护性。",
  "temperature": 0.3
}

# 分析 Docker 容器状态
docker ps -a | gemini "哪些容器有问题？"

# 分析系统资源
top -bn1 | gemini "系统资源使用情况如何？有什么建议？"

# 分析网络连接
netstat -tlnp | gemini "分析当前的网络连接，有没有异常？"

# 为所有 Python 文件添加类型注解建议
for f in src/*.py; do
  echo "=== $f ==="
  gemini "为这个文件建议类型注解" -f "$f"
done

# 自动生成 commit message
git diff --staged | gemini "根据这些变更生成一个简洁的 commit message"

# 生成 changelog
git log --oneline v1.0..v2.0 | gemini "根据这些提交生成 changelog"

# 结合 jq 分析 JSON
curl -s https://api.example.com/status | jq . | gemini "分析这个 API 响应"

# 结合 ripgrep 搜索
rg "TODO|FIXME" --json | gemini "总结所有待办事项"