Refraction

Refraction(refraction.dev)是 Refraction AI Inc. 2023 年推出的 AI 代码助手,定位是”AI 代码重构 + 自动测试 + 文档生成 + 多语言支持的一体化平台”。Refraction 提供 IDE 插件 + Web 界面,基于 LiteLLM 支持多种底层 LLM。截至 2026 年 7 月,Refraction 用户 10 万+,被独立开发者、小型团队广泛使用。Refraction 与 Sourcery、Codacy、Codiga、AskCodi 是同赛道竞品,差异在于 Refraction 强调”重构 + 测试 + 文档一体化 + 多 LLM 支持”,适合独立开发者、小型团队、追求多功能一体化。

一、工具介绍

Refraction 的核心定位是”代码质量一体化 AI 助手”,区别于单功能工具(Sourcery 偏重构,Codacy 偏审查),Refraction 把”代码重构 + 自动测试生成 + 文档生成 + 代码风格检查”整合在一个工具。Refraction 基于 LiteLLM 统一接口,支持 GPT-4o/Claude/Gemini 等多种底层模型,用户可灵活选择。

二、核心功能

• 代码重构:选中代码,智能重构建议
• 自动测试生成:为函数生成单元测试
• 文档生成:自动生成函数/类文档
• 代码风格:多种语言风格转换(Python2→Python3)
• 语言转换:代码转不同语言(JS→TS)
• Bug 修复:错误诊断 + 修复建议
• 多 LLM 支持:OpenAI/Anthropic/Google/Ollama
• 多 IDE:VS Code/JetBrains/Sublime
• Web 界面:Refraction Studio Web 版
• 团队共享:协作 + 共享规则
• 多语言:Python/JS/TS/Java/C++/Go/Ruby/C#
• API:REST API,集成到自定义工作流
• 离线模式:支持 Ollama 本地模型

三、使用场景

• 独立开发者:多功能一体化,无需多工具
• 小型团队:轻量级代码质量工具
• 重构项目:老旧代码现代化
• 测试覆盖率提升:自动生成测试
• API 文档自动生成:Sphinx/OpenAPI 自动生成
• 代码审查:PR 自动评论建议
• 多 LLM 实验:不绑定单一模型
• 教学:学生代码改进 + 测试生成
• 快速原型:AI 辅助 + 测试验证

四、价格方案

五、功能特点

• 一体化(重构+测试+文档)
• 多 LLM 自由选择
• 多语言支持(10+ 语言)
• Web + IDE 双重
• API 集成
• 离线模式(Ollama)
• 价格亲民($10/月)
• 适合独立开发者

六、上手指南

1. 注册:访问 refraction.dev,GitHub 登录
2. 装 IDE 插件:
– VS Code:Extension 搜 “Refraction”
– JetBrains:Plugin 搜 “Refraction”
3. 配置 LLM:
– Settings → Model
– 选 OpenAI/Anthropic/Ollama,填 API Key
4. 代码重构:
– 选中代码 → 右键 → “Refactor with Refraction”
– 选类型(简化/重命名/提取函数)
– AI 给出建议,点 “Apply” 应用
5. 测试生成:
– 选中函数 → “Generate Tests”
– 选测试框架(pytest/jest/junit)
– 自动生成并插入
6. 文档生成:
– 选中函数 → “Generate Doc”
– 选风格(Google/NumPy/Sphinx)
– AI 自动插入 docstring
7. 语言转换:
– 文件 → Convert
– 选源语言 + 目标语言
8. Web 界面:refraction.dev/studio,在线用

七、常见问题

Refraction 和 Sourcery 比哪个好?

Sourcery 偏 Python 重构 + 审查。Refraction 偏多语言 + 多功能。Python 专用选 Sourcery,多语言多功能选 Refraction。

Refraction 支持本地模型吗?

支持。Refraction 集成 Ollama,完全离线。数据敏感场景友好。

Refraction 自动测试好用吗?

中等。AI 生成的测试覆盖主要路径,边界情况/异常处理建议人工补充。建议审查后用。

Refraction 的 LLM 选择?

默认 GPT-4o 质量最好。可选 Claude 3.5(长上下文)、Gemini(多模态)、Ollama(离线)。不同任务可配不同模型。

Refraction 适合大企业吗?

中等。Refraction 偏独立开发者/小团队,企业级功能不如 SonarQube/Codacy 全面。100+ 人企业建议 SonarQube。