Local AI Code Reviewer 🔍

Local AI Code Reviewer 🔍

site icon
2025.02.20 3
TypeScript代码审查AI辅助开发开发效率
Local AI Code Reviewer 是一个轻量级的本地优先代码审查工具,利用AI技术为代码变更提供快速反馈。它基于TypeScript构建,由Ollama提供支持,能够分析git差异并提供可操作的代码改进建议。
View on GitHub

Overview

基本能力

产品定位

Local AI Code Reviewer 是一个本地优先的代码审查工具,旨在为开发者提供快速的代码反馈,帮助改进代码质量。

核心功能

  • 🚀 本地优先:完全在本地运行,无需API密钥或互联网连接
  • 📝 Git集成:自动分析未提交的代码变更
  • 🤖 AI驱动:使用deepseek-coder模型进行智能代码审查
  • 🎨 丰富输出:清晰、彩色的终端输出,提供可操作的建议
  • 快速:快速设置和即时反馈
  • 🔒 隐私保护:代码永远不会离开您的机器

适用场景

  • 快速获取代码变更的反馈
  • 个人项目开发
  • 学习和实验

工具列表

  • Ollama:用于运行deepseek-coder模型
  • Node.js:运行环境
  • npm:包管理器

常见问题解答

  1. Ollama无响应
  2. 检查Ollama是否在系统托盘中运行
  3. 使用ollama list验证
  4. 必要时重启Ollama

  5. 模型问题

  6. 确保已安装deepseek-coder:ollama pull deepseek-coder:latest
  7. 检查可用内存(建议至少8GB)
  8. 关闭不必要的应用程序

  9. Node版本错误

  10. 更新Node.js到v22+:node -v
  11. 更新npm到v11+:npm -v

使用教程

使用依赖

  • Windows 11
  • Node.js v22.0.0或更高版本
  • npm v11.0.0或更高版本
  • Ollama 已安装

安装教程

  1. 克隆仓库: bash git clone <repository-url> cd code-reviewer

  2. 安装依赖: bash npm install

  3. 拉取所需模型: bash ollama pull deepseek-coder:latest

  4. 验证安装: bash ollama list # 应显示deepseek-coder

调试方式

  1. 在项目中做一些变更

  2. 运行审查工具: bash npx tsx src/index.ts /path/to/your/project

  3. 在终端中查看建议

示例输出:

🔍 Code Review Assistant
─────────────────────
Reviewing project: /path/to/your/project

📋 Summary
Found 3 issues in your changes...

🎯 Detailed Analysis
[app.ts]
❌ ERROR (line 15)
   Unused variable 'config'
   → Impact: Increases code size and reduces maintainability
   → Fix: Remove unused variable or implement intended usage

...

许可证

该项目遵循 MIT 开源许可条款。