diffpilot

🔍 DiffPilot

推送前的本地 AI 代码审查

---

💡 为什么选择 DiffPilot？

创建 PR 前，在本地审查代码。 DiffPilot 是一个 MCP 服务，可让你：

1. 创建 PR 前自我审查 - 在推送前，对上次提交后的本地更改运行 AI 代码审查
2. 审查者工作流 - 作为代码审查者，在本地检出源分支并获取 AI 辅助审查
3. 自动检测分支 - 无需指定 main，DiffPilot 会自动查找基础分支

🔒 100% 本地运行 - 无云服务，无外部 API。适用于 Azure DevOps、TFS 和隔离网络环境。

---

🚀 快速开始

安装

# VS Code Marketplace
ext install BurakKalafat.diffpilot

# Or NuGet (.NET tool)
dotnet tool install -g DiffPilot

配合 GitHub Copilot 使用

# Review my changes (auto-detects base branch)
@workspace #review_pr_changes

# Review with focus areas
@workspace #review_pr_changes focus on security and error handling

# Generate commit message
@workspace #generate_commit_message

# Scan for secrets before committing
@workspace #scan_secrets

---

🛠️ 9 个 MCP 工具

PR 审查工具

工具	提示词示例
#get_pr_diff	“显示我的分支与 main 之间的差异”
#review_pr_changes	“审查我的 PR 是否存在安全问题”
#generate_pr_title	“生成符合规范的 PR 标题”
#generate_pr_description	“创建包含检查清单的 PR 描述”

开发者工具

工具	提示词示例
#generate_commit_message	“为暂存的更改生成提交消息”
#scan_secrets	“检查我的更改中是否包含 API 密钥”
#diff_stats	“显示更改统计信息”
#suggest_tests	“我应该编写哪些测试？”
#generate_changelog	“根据提交生成变更日志”

---

✨ 主要功能

功能	描述
🔄 自动检测分支	自动查找 main、master 或 develop
🔐 密钥扫描	检测 API 密钥、密码、令牌和 JWT
📊 差异统计	添加/删除的行数，以及按类型划分的文件明细
🧪 测试建议	基于模式的测试用例建议
📝 Conventional Commits	生成 feat:、fix:、refactor: 消息
🛡️ 企业级安全	银行级输入验证、速率限制和输出清理

---

🛡️ 安全性

DiffPilot 提供企业级安全功能：

安全功能	描述
输入验证	根据严格模式验证所有参数
注入防护	防止命令注入和路径遍历
输出清理	自动从工具输出中隐藏密钥
速率限制	防止 DoS 攻击（120 次请求/分钟）
安全错误处理	不向客户端泄露内部详情
审计日志	将安全事件记录到 stderr

自动隐藏的模式： API 密钥、AWS 凭据、GitHub/Slack 令牌、JWT、密码、私钥、连接字符串。

完整文档请参阅 SECURITY.md。

---

📋 使用场景

1. 创建 PR 前自我审查

# After finishing your work, before creating PR:
@workspace #review_pr_changes

# AI reviews your changes and provides feedback
# Fix issues locally, then push with confidence

2. 代码审查者工作流

# Checkout the feature branch locally
git checkout feature/user-auth

# Use DiffPilot to review
@workspace #review_pr_changes focus on security

# Get structured review with AI assistance

3. 提交前密钥检查

@workspace #scan_secrets

# Catches API keys, passwords, tokens before they're committed

---

⚙️ 配置

{
  "diffpilot.defaultBaseBranch": "main",
  "diffpilot.prTitleStyle": "conventional",
  "diffpilot.commitMessageStyle": "conventional"
}

---

📦 安装选项

方法	命令
VS Code	ext install BurakKalafat.diffpilot
NuGet	dotnet tool install -g DiffPilot
手动	git clone + dotnet build

要求： .NET 9 SDK、VS Code 1.101+、Git

---

📜 版本历史

1.2.0 (2025-12-09)

• 安全加固 - 银行级安全功能
  • 输入验证（CWE-20）
  • 防止命令注入（CWE-78）
  • 路径遍历防护（CWE-22）
  • 输出清理 - 自动隐藏机密信息（CWE-200）
  • 速率限制（CWE-400）
  • 安全错误处理
• 新增 SECURITY.md 文档
• 新增 80 个安全单元测试

1.1.5 (2025-12-08)

• 更新 README，加入用例和 #tool 提示词
• 突出显示自动分支检测功能

1.1.4 (2025-12-07)

• 优化图标

1.1.3 (2025-12-07)

• 新扩展图标（带加号/减号的镜头）

1.1.2 (2025-12-07)

• 优化软件包大小

1.1.1 (2025-12-07)

• 更新扩展图标

1.1.0 (2025-12-07)

• 改进工具文档

1.0.9 (2025-12-07)

• 修复：服务使用工作区文件夹执行 git 操作

1.0.8 (2025-12-07)

• 缩短工具描述，让界面更简洁

1.0.7 (2025-12-07)

• 修复：打包的服务包含 TargetFramework

1.0.6 (2025-12-07)

• 修复：为 VS Code 1.101+ 自动注册 MCP

1.0.5 (2025-12-07)

• 发布到 NuGet 和 MCP Registry

1.0.0 (2025-12-06)

• 首次发布，包含 9 个 MCP 工具

---

📄 许可证

MIT License - Burak Kalafat

---

GitHub • VS Code Marketplace • NuGet

⭐ 如果觉得有用，请点个 Star！