Diffron 是一个 Git 提交信息与 PR 描述生成器，通过 lemonade-python-sdk 调用 AMD Lemonade 本地 LLM 服务器完成生成。它是提交给 AMD Lemonade Developer Challenge 2026 的生产级参考实现，属于 Tetramatrix 生态，与 Aicono、TabNeuron、Sorana、RyzenPilot 和 Lemonade-Python-SDK 并列。
主要能力
- 自动提交信息：根据暂存的改动生成 Conventional Commits 格式的提交信息。
- PR 描述：根据分支差异生成详细的 PR 标题和描述。
- Lemonade 集成：与本地 Lemonade LLM 服务器配合工作，无需云端。
- 跨平台：支持 Windows、Linux 和 macOS，并兼容 GitHub Desktop 3.5.5+。
- 自动检测：自动发现正在运行的 Lemonade 实例。
- 精选模型：提供针对不同任务推荐的模型，便于选择。
- AI 感知：当 AI 编程代理（Claude、Copilot、Cursor、Aider、MiMo、Kilo、Qwen 等）进行提交时自动跳过。
使用方式
- 安装 AMD Lemonade Server：从 AMD Lemonade Releases 下载安装程序，运行 Lemonade_Server_Installer.exe，从桌面快捷方式启动 Lemonade Server，并通过 Lemonade UI 下载模型（例如 qwen3.5-0.8b-gguf）。
- 安装 lemonade-python-sdk：源码位于 github.com/Tetramatrix/lemonade-python-sdk。
- 配置环境：设置 Lemonade Server URL（永久或临时）。
- 安装 Diffron。
- 设置模型：Diffron 自带精选模型，默认模型开箱即用（默认模型：qwen2.5-it-3b-FLM，随 Lemonade 提供）。可通过 Python API 或环境变量手动指定其他模型。
- 安装 Git Hooks。
GitHub Desktop 工作流
- 修改文件。
- 打开 GitHub Desktop。
- 输入任意提交信息（例如 "auto"）。
- 点击 "Commit to main"。
- Diffron 会将你的信息替换为 AI 生成的信息。
AI 代理检测 Diffron 会自动检测 AI 编程代理（Claude、Copilot、Cursor、Aider、Codex、Kilo、Mimo、Hermes、OpenCode、FreeBuff 等）是否正在提交，并跳过信息生成——因为代理本身已生成良好的信息。检测分三层：
- 环境变量：扫描所有环境变量中的 AI 代理关键词（CLAUDE、COPILOT、CURSOR、AIDER、CODEX、OPENAI、AGENT、BOT 等）。
- Git 配置：检查 user.name 和 user.email 中的 AI 模式（例如 "Claude"、"Copilot"、"ai@anthropic.com"）。
- 信息质量：如果提交信息已符合 Conventional Commits 格式（feat:、fix: 等），Diffron 会跳过。 可添加自定义检测模式，或通过 git config 配置，也可手动测试。
适用场景 适用于希望在本地、无需云端的情况下自动生成规范 Git 提交信息和 PR 描述的开发者，尤其适合使用 AMD Ryzen AI PC 与 Lemonade 本地 LLM 服务器的用户，以及使用 GitHub Desktop 的工作流。
限制与说明
- 需要先安装并运行 AMD Lemonade Server，且需下载模型。
- 依赖 lemonade-python-sdk。
- 当检测到 AI 编程代理环境变量或提交信息已符合 Conventional Commits 格式时会跳过生成。
- 已知问题包括：Lemonade 未被检测到、Hooks 不工作、模型未找到（404）、使用了错误的模型（DIFFRON_MODEL 环境变量会覆盖默认值）、Diffron 不生成信息（检测到 AI 代理）。完整故障排除见 docs/SETUP.md。
- 采用 MIT 许可证。
- 版本：0.1.9，最后更新：2026-07-11。
