review

对变更、提交或文件执行 AI 驱动的代码审查。

语法:

gcop-rs review [OPTIONS] <COMMAND>

命令:

命令	语法	说明
变更	gcop-rs review changes	审查未暂存工作区变更（index → working tree，类似 git diff）
提交	gcop-rs review commit <HASH>	审查特定提交
范围	gcop-rs review range <RANGE>	审查提交范围（如 HEAD~3..HEAD）
文件	gcop-rs review file <PATH>	审查单个文件（当前不支持目录）

选项:

选项	说明
--format <FORMAT>, -f	输出格式: text（默认）、json 或 markdown
--json	--format json 的快捷方式
--provider <NAME>, -p	使用特定的 provider

示例:

# 审查工作区变更（未暂存）
gcop-rs review changes

# 审查最后一次提交
gcop-rs review commit HEAD
gcop-rs review commit abc123

# 审查最近 3 次提交
gcop-rs review range HEAD~3..HEAD

# 审查单个文件
gcop-rs review file src/auth.rs

# 输出为 JSON 用于自动化
gcop-rs review --format json changes > review.json

# 输出为 markdown 用于文档
gcop-rs review --format markdown changes > REVIEW.md

注意：--format / --json 是 review 命令本身的选项，必须写在目标子命令之前（例如：review --format json changes）。

注意：当前 review changes 只会审查未暂存的变更（类似 git diff），不会包含已暂存的变更。

注意：review file <PATH> 当前仅支持文件（不支持目录）。

注意：当审查输入过大时，发送给 LLM 前会被截断。可通过配置中的 [llm].max_diff_size 调整上限。

注意：review.min_severity 当前仅对 --format text 生效；JSON 与 Markdown 输出会保留完整问题列表。

输出格式 (text):

ℹ 审查: 工作区未暂存变更

📝 总结:
添加了 JWT 认证和适当的错误处理。
整体代码质量良好。

🔍 发现的问题:

  1. WARNING: 令牌刷新中缺少错误处理
     位置: src/auth.rs:45

  2. INFO: 考虑添加速率限制
     位置: src/middleware.rs:12

💡 建议:
  • 为边界情况添加单元测试
  • 记录令牌验证逻辑
  • 考虑将验证提取到单独的函数

提示:

• 提交前使用以尽早发现问题
• 使用 --format json 集成到 CI/CD
• 在配置中设置 min_severity 可减少 text 输出噪音

参考

• 命令总览
• 故障排除