New API for Copilot Chat

用你自己 New API 站点上的模型驱动 Copilot Chat —— 不换界面，不放弃 Agent 模式

把 New API 这类 OpenAI 兼容网关接成 Copilot Chat 的 自带密钥（BYOK）语言模型供应商：没有新侧边栏、没有新聊天界面，只是模型选择器里多了一项

为什么用它？

• 不替换 Copilot，而是给它换个引擎 —— 模型选择器里多一项而已
• Agent 模式、工具调用、Instructions、MCP、Skills 照常工作 —— 接的是原生 provider API，整套能力栈直接复用
• 元数据是补齐出来的，不是猜的 —— 网关不返回时用随包数据表兜底，每个数值的来源写进 debug 日志
• 站点不认某个字段也不会直接失败 —— 上游点名了哪个可选字段，就去掉那个字段重试
• 密钥不进配置文件 —— API Key 由 VS Code 存入系统钥匙串，日志自动脱敏

功能特性

• 站点上的模型自动出现：读取站点的 /v1/models 并逐个注册；支持多个配置组（例如官方站 + 自建站），每组有独立的 HTTP 客户端与模型缓存
• 可读的模型名、可解释的元数据：选择器显示展示名（Claude Sonnet 4.5）而不是回传给站点的模型 ID（anthropic/claude-sonnet-4.5）；悬浮提示只列身份、规模与能力，逐项一行、键值分列，数值来源与校正原因写进 debug 日志
• 真实流式输出与思维链回显：正文逐块输出；思维链（reasoning_content / reasoning）可选回显，以 Markdown 引用块出现在回答前面（宿主提供专用「思考内容」部件时自动改用可折叠的思考块）
• 思考强度按模型可调：档位逐模型从数据表读取（某个模型可能是 max / high / low，另一个只有 xhigh / high），选项文字直接用上游原值，不翻译也不缩写
• 继承 Copilot 的整套能力（接入的是原生 provider API，这些不用本扩展实现）：Agent 模式、工具调用（文件编辑、终端、搜索、Git、测试，参数分片会正确合并）、Instructions 与 MCP、上下文窗口用量（回传上游 usage，「会话信息」里能看到 token 数与各分类占比）
• 安全优先：API Key 声明为 secret，由 VS Code 存入系统钥匙串（Windows 凭据管理器 / macOS 钥匙串 / Linux 密钥环），不写入 settings.json，也不进 Git 历史；日志一律脱敏
• 零运行时依赖：纯 VS Code API + Node.js 内置模块，没有 Python、没有 Docker、不需要额外的本地代理进程
• 站点不认某个可选字段时自动绕过：因 stream_options、temperature、reasoning_effort、tool_choice 或 extraBody 子字段返回 400 时，去掉被点名的那个字段再试一次（最多两轮）；上游没说清是哪个字段时不猜，原样报错
• DeepSeek 模型按官方形态发请求：思考能力显式开关（thinking）；宿主发起的辅助请求（起标题、写提交信息、生成分支名等）关掉思考；思考态的工具调用历史回填 reasoning_content；其余模型走恒等变换的兜底适配器
• 状态栏：显示连接状态与模型总数，悬停给出本次会话的输入输出与缓存命中，需要你处理的问题（配置不完整、站点连不上）逐组列出原因与建议

快速开始

前置条件

• VS Code 1.137 或更高版本（见 engines.vscode）
• 一个可用的 New API 站点（或任何 OpenAI 兼容网关）与它的 API Key
• 不需要 GitHub 提供的模型——本扩展走自带密钥（BYOK）

安装

当前版本以 .vsix 分发：

1. 打包：npm install 后执行 npm run package，仓库根目录得到 newapi-copilot-chat-<版本>.vsix
2. 安装：命令面板运行 Extensions: Install from VSIX...，选中该文件
3. 重新加载窗口——provider 跑在扩展宿主里，装完必须重载才生效

使用步骤

1. 打开 Copilot Chat 的模型选择器 → 管理模型（Manage Models）→ New API
2. 填入 站点地址（例如 https://api.example.com）与 API Key
   • 站点地址只填到根目录，/v1 与具体端点由扩展自动拼接
   • 密钥由 VS Code 存进系统钥匙串，配置文件里只留占位符引用
3. 确认后返回模型选择器，即可看到 New API 下的模型

需要接入第二个站点时，在「管理模型」里再建一个配置组即可，两组互不影响 状态栏显示模型总数与本会话用量，图标本身不带点击动作

模型与元数据

模型清单完全来自你的站点，因此没有固定的模型列表，扩展为每个模型补齐信息，优先级如下：

网关最清楚自己那条链路，所以窗口与能力以它为准；思考档位反过来以数据表为准——远端只可能说「支持」，说不清「支持哪些档位」

随包的 data/openrouter-models.json（约 340 条）覆盖主流厂商，由 npm run models:openrouter 从公开的模型目录抓取生成，扩展在激活时读取，不要手工编辑（重跑脚本会重写整个文件）

它是生成时的快照，厂商调整后可能滞后，数值不符时的处理顺序如下：数据表过时 → 重跑生成脚本；生成结果依然不对（上游数据失真或渠道差异）→ 改进脚本或向上游反馈

设置项

本扩展的设置位于 newapi-copilot-chat.* 之下，可在设置界面搜索 New API 找到 站点地址与 API Key 不是设置项 —— 它们在 VS Code 的「管理模型」界面里配置

常规

模型

请求

状态

思考强度不是设置项——它在 Copilot Chat 的模型选择器里按模型配置；其余设置可以直接写进 settings.json（键名整体是一个带点号的字符串，不要写成嵌套对象）：

{
  "newapi-copilot-chat.models.cacheTtl": 600000,
  "newapi-copilot-chat.request.temperature": 0.7,
  "newapi-copilot-chat.request.streamIdleTimeoutMs": 180000
}

思考强度

支持思考的模型会在模型选择器里出现思考强度控件，选择后扩展把对应的 reasoning_effort 写进请求体，由站点转给上游；三个需要注意的点：

• 预选不等于会发送：控件预选数据表里的 defaultReasoningEffort，但这个值不会被发出去（它本来就是站点自己在用的），只有改成别的档位才往请求里加 reasoning_effort；数据表没给默认档位的模型是空选中，此时选什么都算明确意图、照发
• 哪些模型有控件：① 站点返回值里有 reasoning / reasoning_effort 等参数，或数据表里标了 reasoning；② 数据表给出了该模型的可选档位（supportsReasoningEffort）；只有①时说明「它会思考，但我们不知道它能调哪些档」，这时不显示控件
• 档位逐模型、没有兜底、不经翻译：可用范围就是数据表里的 supportsReasoningEffort，因此不同模型不一样，例如 max / xhigh / high / medium / low 或只有 high / low；选项文字直接用上游原值（max / xhigh / minimal / none …），不翻译也不缩写；字段名固定为 reasoning_effort，站点若用别的叫法（例如 reasoning.effort）或需要嵌套形态，由适配器层改写——见 src/adapter/

配置来源

配置完全由 VS Code 的 provider 配置组提供：扩展在 package.json 里用 contributes.languageModelChatProviders[].configuration 声明一份 JSON Schema， VS Code 据此在「管理模型」界面生成本扩展的配置表单：

模型按配置组隔离（每组有独立的 HTTP 客户端与模型缓存，A 站的模型不会跑到 B 站去请求）、 配置变更自动生效（改完地址或密钥后，下一次模型发现就会重建对应会话，旧连接会被中断）、 状态按组汇总（状态栏显示合计的模型数，悬浮提示里逐组列出配置不完整或连不上的原因）

命令

配置站点与密钥请用模型选择器里的 管理模型，或命令面板的 Manage Language Models

开发

npm install
npm run watch          # 或 npm run compile
F5                     # 启动扩展开发宿主
npm run check          # 类型 + 分层约束
npm run lint
npm run package        # 产出 .vsix

npm run check 里的分层约束会校验「哪些文件允许依赖 VS Code 运行时」——名单在 scripts/check-layering.js 顶部，往名单外的文件里加运行时 import 'vscode' 会让它失败 （import type 不算），这样纯逻辑模块不必为了跑起来而启动一个 VS Code

致谢

本项目的设计与实现借鉴于两个同类扩展：

• ltmoerdani/opencode-copilot-chat
• Vizards/deepseek-v4-for-copilot

相关文档

• docs/ARCHITECTURE.md —— 架构说明，面向要修改本代码库的人
• Language Model Chat Provider API
• VS Code API Reference
• New API

许可证

本项目以 MIT 许可证发布，全文见仓库根目录的 LICENSE