为 GitHub Copilot 添加自定义 AI 供应商与模型的 VS Code 扩展
- 目录 Table of Contents
- 简介 Introduction
- 特性 Features
- 快速开始 Quick Start
- 安装 Installation
- 使用概览 Usage Overview
- 供应商与模型管理 Provider & Model Management
- 命令 Commands
- 配置项 Settings Items
- 配置文件格式 Config Format
- 调试游乐场 Debug Playground
- 常见问题 FAQ
- 故障排除 Troubleshooting
- 许可证 License
- 免责声明 Disclaimer
- 致谢 Thanks
Addi 让你在 VS Code 中为 GitHub Copilot 添加自定义 / 第三方 / 自建 AI Provider 与模型，并在 Copilot 原生模型选择器中一键切换。它既是一个模型管理器，也是一个交互式调试 Playground。
Tip
虽然 vscode 官方有支持自定义模型的计划，但目前仍未开放给大众用户，Addi 作为一个临时解决方案，可以帮助你快速上手并测试各种模型。详见 Bring Your Own Language Model 以及 Use an OpenAI-Compatible Model。
| 类别 | 说明 |
|---|---|
| Provider 管理 | 添加 / 编辑 / 删除 / 快速编辑 API Key |
| 模型管理 | 绑定于 Provider 的模型定义与特性标记（视觉 / 工具调用支持等） |
| 模型切换 | 在 Copilot 模型选择器中勾选后即可切换自定义模型 |
| 配置导入导出 | JSON 结构备份 / 迁移到其他机器 |
| 可配置默认参数 | 默认 family / version / token 限制 |
| UI / 树视图 | 直观的 ActivityBar 侧边栏管理界面 |
| 右键上下文操作 | 针对 Provider / Model 的快捷操作 |
| Playground 调试 | 发送消息、调节参数、实时查看日志 |
| SSE 流式输出 | 支持 OpenAI 及兼容端点增量输出 |
| 参数持久化 | 最近一次 Playground 参数自动恢复 |
| 测试覆盖 | Streaming / 参数裁剪与持久化测试 |
1. 安装扩展（市场或本地 VSIX）
2. 打开侧边栏 “Addi”
3. 添加 Provider（填写端点与 API Key）
4. 为该 Provider 添加模型（id / token 限制等）
5. 在 Copilot → 模型下拉 → 管理模型 → 勾选你的模型
6. 返回聊天界面，选择并使用它！
搜索 “Addi” 并安装；或命令面板输入：ext install addi。
yarn install; yarn vsix
code --install-extension addi.vsix
# 或在 VS Code 文件列表中右键安装Activity Bar 中的 Addi 图标 → 展开树：
- Provider 节点：右侧 ＋ 图标可快速添加模型 / 编辑密钥
- Model 节点：右键 “Use Model” 在 Copilot 中启用
- 顶部视图标题按钮：Add Provider / Export / Import / Settings
Warning
完整利用自定义模型的 Edit / Agent 模式可能需要 GitHub Copilot Pro 级别订阅；Free 版本目前测试仅支持用于 Ask 模式使用自定义模型。请确保账户权限满足需求。
- 点击 “Add Provider”
- 填写：名称 / 描述 / 网站 / API Endpoint / API Key / 接口类型(OpenAI 兼容等)
- 保存后出现在列表
- 选中 Provider → Add Model
- 填写：id / 名称(可选) / maxInputTokens / maxOutputTokens / 视觉支持 / 工具支持
- 保存后挂载在对应 Provider 下
Provider 节点右侧钥匙图标 → 输入密钥 → 保存。
Copilot 侧边栏 → 模型下拉 → 管理模型 → 选择 Addi → 勾选自定义模型 → 返回选择该模型。
| Command ID | 标题 | 用途 |
|---|---|---|
addi.manage |
Management | 打开管理视图 |
addi.exportConfig |
Export Configuration | 导出配置 |
addi.importConfig |
Import Configuration | 导入配置 |
这些命令大多通过树视图右键或标题按钮触发，命令面板默认隐藏。
| Setting | 默认 | 说明 |
|---|---|---|
addi.defaultMaxInputTokens |
4096 | 默认最大输入 tokens |
addi.defaultMaxOutputTokens |
1024 | 默认最大输出 tokens |
addi.defaultModelFamily |
"Addi" | 默认模型 family |
addi.defaultModelVersion |
"1.0.0" | 默认模型 version |
addi.saveConfigToSettingsSync |
true | 是否保存到 VSCode Settings Sync 云端 |
更改方法：VS Code 设置搜索 “addi” 或在视图标题中点击 Settings。
配置文件以 JSON 多维数组存储，每个供应商包含其模型列表：
[
{
"id": "provider-id",
"name": "OpenAI",
"description": "提供 GPT 系列模型",
"website": "https://openai.com",
"apiEndpoint": "https://api.openai.com/v1",
"apiKey": "sk-...",
"models": [
{
"id": "gpt-4",
"name": "GPT-4",
"family": "Addi",
"version": "1.0.0",
"maxInputTokens": 8192,
"maxOutputTokens": 2048,
"capabilities": {
"imageInput": false,
"toolCalling": false
}
}
]
}
]提供交互式调试界面，发送消息、调节参数、查看日志。现阶段主要用于测试与调试自定义模型，未来可能集成更多功能。
支持设定参数：Temperature / Top P / Max Output Tokens / Presence Penalty / Frequency Penalty / System Prompt。参数在 workspaceState 中持久化。OpenAI 兼容端点支持 SSE 流式增量输出，可中途取消（AbortController）。不支持流的 Provider 自动回退普通请求。
后续扩展方向：
- 更多 Provider 流式适配（Anthropic / Google 等）
- Markdown 渲染 + 代码高亮
- Token 消耗统计与速率提示
- 多参数 Profile 切换
A: 请确保：
- 您已为供应商配置了 API 密钥
- 您使用的是 GitHub Copilot 个人计划
- 模型已正确添加并保存
A: 当您成功切换模型后，会收到确认消息。此外，您可以在 Copilot 聊天界面的模型选择器中查看当前选中的模型。
A: 扩展对供应商和模型数量没有硬性限制，但建议根据您的实际需求合理添加。
| 问题 | 排查步骤 |
|---|---|
| 无法切换模型 | 重启 VS Code / 确认 Provider Key / 重新勾选模型 |
| 请求失败 | 查看输出 & 控制台日志 / 校验 API Endpoint & Key |
| 流式不工作 | Provider 是否支持 SSE；禁用流后重试 |
| 配置未同步 | 检查 addi.saveConfigToSettingsSync 设置 |
MIT © 2024-present deepwn — 详见 LICENSE。
本扩展仅提供客户端功能，使用第三方 / 自建 API 带来的数据与安全风险由使用者自行承担。我们不对直接或间接损失负责。
- GitHub Copilot 团队与 VS Code 扩展生态
- OpenAI / Anthropic / Google 等公共 API 生态
- 所有提交 Issue / PR 的贡献者 🙌
欢迎 Star 支持项目，如果它对你有帮助！