ModelSpan
ModelSpan 现在是一个轻量级 VS Code Chat 原生自定义模型分组配置助手。它不再注册自有模型 Provider，也不再代理模型请求；所有模型调用、API Key 保存、协议适配和模型选择都交给 VS Code 内置的 Language Models / BYOK 能力处理。
主要功能
- 提供 Webview 编辑器，用于可视化编辑用户级
chatLanguageModels.json 中 vendor: "customendpoint" 的自定义模型分组。
- 自动隐藏并保留其它
vendor 配置，避免误改 VS Code 原生或其它扩展管理的模型来源。
- 打开 VS Code 原生 Manage Language Models 管理器，用于密钥和原生提供方管理。
- 快速打开原始
chatLanguageModels.json。
- 通过 API 根地址和一次性 API Key 拉取模型列表，也支持手动添加模型。
- 可设置默认思考等级；模型会按 VS Code 原生格式声明支持全部思考等级。
- 对自定义模型分组做基础结构校验，并在 Problems 面板显示问题。
- 保持零代理、零遥测、零请求正文处理。
快速开始
- 单击状态栏中的 ModelSpan，或执行 ModelSpan: 打开语言模型编辑器。
- 在 Webview 中添加/编辑自定义模型分组、模型、端点 URL、能力、Token 上限和默认思考等级。
- 可输入 API 根地址和 API Key 点击 加载模型；该 API Key 仅用于本次拉取模型列表，不会写入 JSON。
- 如需创建或更新长期 API Key，点击 原生保存 API Key 或 原生管理器，使用 VS Code 原生 Language Models 管理能力保存 secret 引用。
- 如需查看原始文件，执行 ModelSpan: 打开语言模型配置 或点击 打开 JSON。
- 保存
chatLanguageModels.json 后，在 VS Code Chat 模型选择器中选择对应模型。
chatLanguageModels.json 示例
[
{
"name": "自定义模型分组",
"vendor": "customendpoint",
"apiKey": "${input:chat.lm.secret.example}",
"apiType": "chat-completions",
"settings": {
"gpt-5.5": {
"reasoningEffort": "medium"
}
},
"models": [
{
"id": "gpt-5.5",
"name": "GPT-5.5",
"url": "https://api.example.com/v1/chat/completions",
"toolCalling": true,
"vision": true,
"maxInputTokens": 128000,
"maxOutputTokens": 16000,
"thinking": true,
"supportsReasoningEffort": ["none", "minimal", "low", "medium", "high", "xhigh", "max"]
}
]
}
]
常用字段：
vendor: 固定为 customendpoint；ModelSpan 只管理该来源。name: 在模型选择器中显示的分组名。apiType: chat-completions、responses 或 messages。settings[模型 ID].reasoningEffort: 默认思考等级。models[].id: 发送给 API 的模型 ID。models[].name: 模型选择器显示名。models[].url: 完整模型端点 URL。toolCalling: 是否支持工具调用。vision: 是否支持图片输入。thinking: 是否支持思考能力。supportsReasoningEffort: 支持的思考等级；开启思考能力时默认声明全部等级。maxInputTokens / maxOutputTokens: 上下文窗口展示与请求限制参考值。requestHeaders: 额外请求头。不要在这里写入认证凭据。
安全说明
- ModelSpan 不发起模型请求，不读取提示词，不处理响应正文。
- API Key 应使用 VS Code 原生 Language Models 管理器保存为 secret 引用；Webview 不保存密钥。
chatLanguageModels.json 可能参与 Settings Sync；不要把明文 API Key 写入该文件。- 第三方模型服务的数据处理、可用性和费用由对应服务方负责。
使用要求
- VS Code 1.120 或更高版本。
- 需要 VS Code 原生 Chat / Language Models 功能可用。
反馈与支持
ModelSpan 使用 MIT License。
