一、工具介绍
Twinny 是一款开源的 VS Code AI 编程助手插件，定位”任意 API + 完全开源 + 完全本地化”。它把 VS Code 与 OpenAI 兼容 API 协议对接，用户可以接入 OpenAI、Anthropic、DeepSeek、Qwen、Ollama 等任意模型，也可以跑本地大模型做代码补全与对话。注：Twinny 官方已宣布项目归档（ARCHIVED），不再持续更新。 新用户应评估社区维护状态与潜在安全风险。
二、核心功能
- 代码补全：行内代码自动补全，支持多语言。
- 对话式编程：侧栏对话窗口，可针对当前文件提问、要求重构、生成测试。
- 任意 API 接入：兼容 OpenAI API 协议，支持 OpenAI/Anthropic/DeepSeek/Qwen 等商业模型。
- 本地模型支持：通过 Ollama/vLLM 接入本地 Llama 3、Qwen、DeepSeek Coder 等开源模型。
- 多模型切换：同一插件内配置多个模型，按场景切换。
- 代码上下文管理：可指定项目内文件作为对话上下文。
- 开源可定制：MIT 协议，源码可读可改。
三、使用场景
- 个人独立开发者：希望获得 AI 辅助但不愿被单一商业产品锁定。
- 隐私敏感型企业：金融、医疗、政务场景禁止代码上云，用 Twinny + 本地 Ollama 实现”代码不出公司，AI 仍在场”。
- 开源项目维护者：需要 AI 帮忙写测试、写文档、写 commit 信息。
- 模型”尝鲜者”：想在 GPT-4o、Claude 3.5、DeepSeek、Qwen 之间灵活切换。
- 预算受限的初创团队：接入免费层 API 或本地小模型，零成本实现 AI 编程。
- 教育与培训场景：高校计算机课程演示 AI 编程原理。
四、价格方案
| 套餐 | 价格 | 适用人群 |
|---|---|---|
| Twinny 本身 | 完全免费 | 开源可商用 |
| OpenAI API | 按 token 计费 | 商业模型 |
| Anthropic API | 按 token 计费 | Claude 系列 |
| Ollama 本地模型 | 免费（自备 GPU） | 本地推理 |
| DeepSeek/Qwen API | 按 token 计费 | 国内模型 |
五、功能特点
- 完全开源（GitHub: rjmacarthy/twinny）
- 兼容 OpenAI API 协议
- 支持本地模型部署
- VS Code 原生集成
- 多模型配置并存
- 项目已归档，新功能停滞
六、上手指南
1. 在 VS Code 扩展市场搜索 Twinny 并安装
2. 配置 OpenAI 兼容 API 端点与 key，或安装 Ollama 并下载模型
3. 打开代码文件，行内触发补全或侧栏打开对话窗口
七、常见问题
Twinny 还在更新吗？
官方已宣布归档（ARCHIVED），不再发布新版本；社区 fork 可继续维护。
适合生产环境吗？
项目已归档，新用户应评估社区维护状态；建议生产环境用 Continue.dev、Cursor、Cody 等活跃维护的同类工具。
本地模型性能如何？
取决于硬件配置——7B 模型在 24GB 显存的 GPU 上流畅运行；更大模型需要更多显存。
和 GitHub Copilot 比如何？
Copilot 体验更稳定但闭源收费；Twinny 完全开源可定制，但缺乏持续维护与商业支持。
现在应该用 Twinny 吗？
作为学习材料或实验场仍可使用；新项目建议选择 Continue.dev 或 Cursor 等活跃维护的替代品。
归档后的替代品
项目归档后建议评估以下活跃维护的开源/商业替代品：
- Continue.dev：开源 VS Code/JetBrains AI 插件，支持任意 OpenAI 兼容 API，持续更新
- Cursor：基于 VS Code 的 AI IDE，深度集成 GPT-4o/Claude 3.5，免费版可用
- Cody：Sourcegraph 出品，企业级代码理解与补全
- Tabby：完全本地化的 AI 代码补全工具，自带模型管理
如需”完全开源 + 任意模型 + 完全本地化”路线，Continue.dev 是当前最贴近 Twinny 设计的活跃替代品。
技术栈：基于 VS Code Extension API + TypeScript 实现，支持 macOS / Linux / Windows 全平台；本地模型通过 Ollama 或 vLLM 启动 HTTP 端点后由 Twinny 调用。
如何配置本地模型？
安装 Ollama → 拉取模型（如 ollama pull qwen:7b）→ 在 Twinny 设置里填入 http://localhost:11434/v1 作为 API 端点。
学习价值：Twinny 的源码（GitHub: rjmacarthy/twinny）是学习 VS Code 插件开发与 OpenAI 兼容 API 集成的优秀案例，即使不再用于生产环境，也值得 AI 编程方向的开发者阅读其代码理解整体架构。
总结：Twinny 是开源 AI 编程工具发展史上的一个重要里程碑——它证明了”任意 API + 完全开源 + 完全本地化”路线的可行性，也为后续 Continue.dev 等活跃工具提供了设计参考。
项目作者已转向新项目 mia.run 的开发。
