hong-review-cli

hong-review-cli 是一款为现代研发团队打造的、基于命令行与大模型驱动的极速代码审查与自动合并工具。

让 Code Review 回归代码层！无需离开终端，一键呼叫 AI 进行深度逻辑审查、找Bug、发评论并完美推送审查报告到你的手机！

🌟 核心理念与特性

• 🚀 零上下文切换：直接在写代码的终端一键跑查，告别繁琐的浏览器操作界面。
• 🧠 强 AI 深度分析：对接 OpenAI、GLM、DeepSeek 等顶级模型，自动理解所有文件的增删改查。
• 🤖 自动化挂机防守：支持静默化批处理模式，可被 CI/CD 或本地 Cron 调起，自动回复并合并安全代码。
• ⚡️ Telegram 极速推送通道：原生内置毫秒级直推 Telegram 能力，长篇大论的缺陷审查报告无需等待，极速触达个人或群组！

🚀 保姆级入门使用

环境要求：Node.js >= 14+

第一步：全局安装

npm install -g hong-review-cli

第二步：初始化资源绑定

安装成功后，在终端执行以下命令进行本地账号绑定：

hong-review login

根据向导提示填写您的 GitLab 服务器域名、GitLab 私人令牌（Token）与模型（API Key）。配置会安全地保存在本地 ~/.hong-review-config.json 中。

第三步：日常使用

当你不知道有什么审查任务时：

hong-review ls

系统将自动为您拉取目前分配给你的待处理 MR 列表，全键盘方向键直观选择进行审查。

当你知道确切的 MR 编号时：

hong-review mr <mr_id> -p <项目ID>

注：加上 -y 或 --yes 参数可以开启静默免打扰模式，跳过一切二次询问。

📱 进阶体验：极速接入 Telegram 直连通知与 OpenClaw 指令网关

想要在喝咖啡的时候，手机自动收到每一份新鲜出炉的代码审计报告？使用 setup 一键集成！

1. 准备工作

• 请确保本地已安装运行 OpenClaw 并在其配置中集成了 Telegram 机器人。

2. 运行一键嗅探配置

由于配置项繁多，为了达到“零门槛”的用户体验，CLI 提供了强大的配置自动提取功能。 在终端执行：

hong-review setup-openclaw

程序会自动寻找到你本机的 .openclaw/openclaw.json，聪明的它会自动阅读文件，并毫秒级提取出所有所需的 Webhook Token、Telegram Bot Token 以及 Chat ID，直接注入回 CLI，一步配平！

💡 架构亮点： 配置完成后，CLI 将启用极速直推架构。所有包含大段代码漏洞和建议的长报告文件，将完全绕过大模型的二次复述（打字机延迟），直接通过原生 Telegram 接口毫秒级发送到你的手机上。同时发送极其简短的存根日志留存到内部后台以供审计分析。

🛠 其他实用指令速查

你可以随时执行 hong-review --help 查看完整说明书：

• hong-review comment <mr_id> "<评论文本>" -p <pid> 快速向 GitLab 提交一条评审意见。
• hong-review merge <mr_id> -p <pid> 一键请求远端合并（支持检测是否发生冲突）。
• hong-review view <mr_id> -p <pid> 在纯命令行界面中分页彩印展示代码 Diff 详情。
• hong-review config list 列出系统当前的配置状态。

🪝 为极客准备的自定义 Hook 流水线

除了自带的 Telegram/OpenClaw 集成，你可以利用配置绑定任何第三方系统的本地可执行脚本去拦截生命周期。 修改本地的配置文件（通常在 ~/.hong-review-config.json）：

{
  "hooks": {
    "onReviewStart": "curl -X POST http://我的内部统计系统",
    "onReviewSuccess": "bash ./scripts/notify-wechat.sh",
    "onReviewFailed": "node ./scripts/dingtalk_error.js",
    "onMerged": "..."
  }
}

📄 协议

本项目基于 MIT 协议开发与开源。