Addi — Extend Your VS Code Copilot

为 GitHub Copilot 添加自定义 AI 供应商与模型的 VS Code 扩展

目录 Table of Contents

• 目录 Table of Contents
• 简介 Introduction
• 特性 Features
• 快速开始 Quick Start
• 安装 Installation
  • 插件市场 Marketplace
  • 本地 VSIX
• 使用概览 Usage Overview
• 供应商与模型管理 Provider & Model Management
  • 添加供应商 Add Provider
  • 添加模型 Add Model
  • 快速编辑 Edit API Key
  • 切换模型 Switch Model
• 命令 Commands
• 配置项 Settings Items
• 配置文件格式 Config Format
• 调试游乐场 Debug Playground
• 常见问题 FAQ
  • Q: 为什么我添加的模型在 Copilot 中不可见？
  • Q: 如何知道我的模型是否正在使用中？
  • Q: 我可以添加多少个供应商和模型？
• 故障排除 Troubleshooting
• 开发 Development
  • 环境准备
  • 开发命令
  • 清理缓存
• 许可证 License
• 免责声明 Disclaimer
• 致谢 Thanks

简介 Introduction

Addi 让你在 VS Code 中为 GitHub Copilot 添加自定义 / 第三方 / 自建 AI Provider 与模型，并在 Copilot 原生模型选择器中一键切换。它既是一个模型管理器，也是一个交互式调试 Playground。

[!Tip] 虽然 vscode 官方有支持自定义模型的计划，但目前仍未开放给大众用户，Addi 作为一个临时解决方案，可以帮助你快速上手并测试各种模型。详见 Bring Your Own Language Model 以及 Use an OpenAI-Compatible Model。

特性 Features

快速开始 Quick Start

1. 安装扩展（市场或本地 VSIX）
2. 打开侧边栏 “Addi”
3. 添加 Provider（填写端点与 API Key）
4. 为该 Provider 添加模型（id / token 限制等）
5. 在 Copilot → 模型下拉 → 管理模型 → 勾选你的模型
6. 返回聊天界面，选择并使用它！

安装 Installation

插件市场 Marketplace

搜索 “Addi” 并安装；或命令面板输入：ext install addi。

本地 VSIX

npm install; npm run package
code --install-extension addi.vsix
# 或在 VS Code 文件列表中右键安装

使用概览 Usage Overview

Activity Bar 中的 Addi 图标 → 展开树：

• Provider 节点：右侧 ＋ 图标可快速添加模型 / 编辑密钥
• Model 节点：右键 “Use Model” 在 Copilot 中启用
• 顶部视图标题按钮：Add Provider / Export / Import / Settings

[!Warning] 完整利用自定义模型的 Edit / Agent 模式可能需要 GitHub Copilot Pro 级别订阅；Free 版本目前测试仅支持用于 Ask 模式使用自定义模型。请确保账户权限满足需求。

供应商与模型管理 Provider & Model Management

添加供应商 Add Provider

1. 点击 “Add Provider”
2. 填写：名称 / 描述 / 网站 / API Endpoint / API Key / 接口类型(OpenAI 兼容等)
3. 保存后出现在列表

添加模型 Add Model

1. 选中 Provider → Add Model
2. 填写：id / 名称(可选) / maxInputTokens / maxOutputTokens / 视觉支持 / 工具支持
3. 保存后挂载在对应 Provider 下

模型验证 Model Verification

在添加或编辑模型时，点击底部的 "Verify & Detect" 按钮可以自动测试：

• 连通性：检查 API Key 和 Endpoint 是否有效
• 视觉能力：自动检测模型是否支持图片输入
• 工具调用：自动检测模型是否支持 Function Calling
• Token 限制：自动探测并填充 Max Input / Output Tokens (使用二分查找与参数估算，不消耗真实 Token)

[!Tip] 如果不确定模型的 Token 限制，可以将 Max Input Tokens 和 Max Output Tokens 留空（或设为?），点击 Verify & Detect 后 Addi 会自动探测并填入建议值。 所有附属能力（视觉 / 工具调用）也会在验证过程中自动测试并更新勾选（不适配则会自动去除勾选）。

快速编辑 Edit API Key

Provider 节点右侧钥匙图标 → 输入密钥 → 保存。

复制 Copy

在 Provider 或 Model 节点上右键点击 "Copy"，可以快速复制一份配置（名称会自动添加 "Copy" 后缀），便于快速创建相似配置。

切换模型 Switch Model

Copilot 侧边栏 → 模型下拉 → 管理模型 → 选择 Addi → 勾选自定义模型 → 返回选择该模型。

命令 Commands

Show Logs 将在 VS Code 的 输出 (Output) 面板中定位 “Addi” 通道，可随时查看调试信息。通过 Set Log Level 或在设置中修改 addi.logLevel，即可在 off / error / warn / info / debug 之间切换输出详细程度。 日志内容会自动脱敏，并额外记录模型解析、请求选项等关键上下文，便于排查问题。

这些命令大多通过树视图右键或标题按钮触发，命令面板默认隐藏。

配置项 Settings Items

更改方法：VS Code 设置搜索 “addi” 或在视图标题中点击 Settings。

配置文件格式 Config Format

配置文件以 JSON 多维数组存储，每个供应商包含其模型列表：

[
  {
    "id": "provider-id",
    "name": "OpenAI",
    "providerType": "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
        }
      }
    ]
  }
]

调试游乐场 Debug Playground

提供交互式调试界面，发送消息、调节参数、查看日志。现阶段主要用于测试与调试自定义模型，未来可能集成更多功能。

支持设定参数：Temperature / Top P / Max Output Tokens / Presence Penalty / Frequency Penalty / System Prompt。参数在 workspaceState 中持久化。OpenAI 兼容端点支持 SSE 流式增量输出，可中途取消（AbortController）。不支持流的 Provider 自动回退普通请求。

后续扩展方向：

• 更多 Provider 流式适配（Anthropic / Google 等）
• Markdown 渲染 + 代码高亮
• Token 消耗统计与速率提示
• 多参数 Profile 切换

常见问题 FAQ

Q: 为什么我添加的模型在 Copilot 中不可见？

A: 请确保：

1. 您已为供应商配置了 API 密钥
2. 您使用的是 GitHub Copilot 个人计划
3. 模型已正确添加并保存

Q: 如何知道我的模型是否正在使用中？

A: 当您成功切换模型后，会收到确认消息。此外，您可以在 Copilot 聊天界面的模型选择器中查看当前选中的模型。

Q: 我可以添加多少个供应商和模型？

A: 扩展对供应商和模型数量没有硬性限制，但建议根据您的实际需求合理添加。

故障排除 Troubleshooting

许可证 License

MIT © 2025-present deepwn — 详见 LICENSE。

免责声明 Disclaimer

本扩展仅提供客户端功能，使用第三方 / 自建 API 带来的数据与安全风险由使用者自行承担。我们不对直接或间接损失负责。

开发 Development

环境准备

git clone https://github.com/deepwn/addi.git
cd addi
npm install

开发命令

# 编译
npm run compile

# 开发模式监听
npm run watch

# 运行测试
npm test

# 打包扩展
npm run package

# 清理缓存和构建文件
npm run clean

# 快速清理（无详细信息）
npm run clean:fast

清理缓存

项目包含清理命令来节省磁盘空间：

npm run clean  # 完整清理，显示详细信息
npm run clean:fast  # 快速清理

详细说明请参考 CLEANING.md。

致谢 Thanks

• GitHub Copilot 团队与 VS Code 扩展生态
• OpenAI / Anthropic / Google 等公共 API 生态
• 所有提交 Issue / PR 的贡献者 🙌

欢迎 Star 支持项目，如果它对你有帮助！