Libiao Copilot
立镖机器人的 OpenAI 兼容模型供应商扩展，为 GitHub Copilot Chat 提供模型支持
本扩展基于 OAI Compatible Provider for Copilot 构建，采用 MIT 许可分发，详见 NOTICE.md。
✨ 功能特性
- 模型实时发现：配置模型不再跳过供应商列表。已配置模型与供应商端点实时核对，供应商新上线的模型自动出现，同事无需任何操作
- 模型列表 TTL 缓存：默认 10 分钟缓存（
libiaoCopilot.modelCacheTtlMinutes），减少网关请求；刷新失败时自动使用过期缓存兜底
- 原生上下文/思考强度选择：在 Copilot 模型配置菜单直接选择上下文大小（256K / 512K / 1M）与思考强度，无需编辑 JSON
- 模型健康检查：启动时自动检查已配置模型可用性（每 24 小时限一次），也可随时手动检查
- 多 API 支持：OpenAI / OpenAI Responses / Ollama / Anthropic / Gemini 五种协议（ModelScope、SiliconFlow、DeepSeek 等）
- 视觉模型：完整支持图像理解能力
- 多供应商管理：同时配置多个供应商，独立管理各自 API 密钥
- 同模型多配置：通过
configId 为同一模型定义不同参数配置（如开启/关闭思维链）
- 可视化配置界面：直观管理供应商与模型，支持配置导入/导出
- 自动重试：处理 API 错误（429、500、502、503、504），支持指数退避
- Token 用量：状态栏实时显示上下文 token 用量
- Git 集成：源代码管理面板一键生成提交信息，默认简体中文
- 思维链展示：在对话界面查看模型推理过程
环境要求
- VS Code 1.120.0 或更高版本
- OpenAI 兼容供应商的基础地址与 API 密钥
⚡ 快速开始
- 从 Visual Studio Marketplace 安装（或在 VS Code 扩展面板搜索 Libiao Copilot），安装后重新加载窗口。
- 若已启用
johnny-zhao.oai-compatible-copilot，请先禁用，避免模型重复。
- 打开设置，配置
libiaoCopilot.baseUrl（公司网关地址，由管理员提供）。
- 运行命令面板中的
Libiao Copilot: 设置 API Key，输入个人密钥。
- 打开 GitHub Copilot Chat，选择 Libiao Copilot 提供的模型即可开始对话。
- 使用模型配置按钮选择上下文大小与思考强度。
扩展默认不内置任何供应商地址。未配置 baseUrl 时不会拉取模型列表。
配置示例
"libiaoCopilot.baseUrl": "https://your-gateway.com/v1",
"libiaoCopilot.models": [
{
"id": "deepseek-v4-pro",
"owned_by": "your-provider",
"context_length": 1000000,
"context_sizes": [262144, 524288, 1000000],
"default_context_size": 524288,
"max_tokens": 384000,
"reasoning_effort": "max",
"reasoning_efforts": ["low", "high", "xhigh", "max"]
}
]
✨ 模型发现机制
- 已配置模型仅作为元数据层：每个模型与其自身端点（
baseUrl/apiMode，未设置时回退全局配置）的模型列表核对，供应商侧已下线的配置模型会被移除。
- 供应商新增但配置中没有的模型，会以默认元数据自动展示。
- 端点无法查询（未配置地址或 API Key、地址错误、密钥错误、网络错误）时，不展示该端点的任何模型——列表只出现经过核实的模型。全部端点都无法查询时，选择器保留 Libiao Copilot 分区，并以一个不可选的占位条目说明原因。网关短暂故障时由 TTL 内的过期缓存兜底。
- 结果带 TTL 缓存；修改模型配置、baseUrl、TTL 设置或 API Key 会自动清空缓存。
✨ 可视化配置界面
命令面板运行 Libiao Copilot: 打开配置界面，或点击状态栏 token 计数项即可打开，可管理全局设置、供应商与模型，支持配置导入导出。
✨ 多 API 模式
通过模型配置的 apiMode 参数指定协议：
| 模式 |
端点 |
适用场景 |
openai（默认） |
/chat/completions |
大多数 OpenAI 兼容供应商 |
openai-responses |
/responses |
OpenAI 官方 Responses API |
ollama |
/api/chat |
本地 Ollama 实例 |
anthropic |
/v1/messages |
Anthropic Claude |
gemini |
/v1beta/models/{model}:streamGenerateContent?alt=sse |
Google Gemini |
混合配置示例
"libiaoCopilot.models": [
{
"id": "GLM-4.6",
"owned_by": "modelscope"
},
{
"id": "llama3.2",
"owned_by": "ollama",
"baseUrl": "http://localhost:11434",
"apiMode": "ollama"
},
{
"id": "claude-3-5-sonnet-20241022",
"owned_by": "anthropic",
"baseUrl": "https://api.anthropic.com",
"apiMode": "anthropic"
}
]
✨ 多供应商与多配置
owned_by（别名 provider / provide）用于分组供应商级 API 密钥，存储键为 libiaoCopilot.apiKey.<供应商小写>。命令面板 Libiao Copilot: 设置供应商 API Key 可分别配置。- 同一模型 ID 可用
configId 区分多份配置（如 glm-4.6::thinking 与 glm-4.6::no-thinking），在模型选择器中各自独立展示。
模型参数
每个模型支持的配置字段（详见 VS Code 设置界面）：
id（必填）：模型标识owned_by（必填）：模型供应商displayName：Copilot 界面显示名称configId：配置 ID，用于同模型多配置baseUrl：模型级基础地址，未提供时用全局 libiaoCopilot.baseUrlapiMode：API 协议模式family：模型家族（如 'gpt-4'、'claude-3'），用于启用 Copilot 专属优化context_length：模型上下文长度，默认 128000context_sizes / default_context_size：Copilot 配置菜单中的上下文档位max_tokens / max_completion_tokens：最大输出 token 数，默认 4096vision：是否支持视觉，默认 falsereasoning_effort / reasoning_efforts：默认推理强度与可选档位enable_thinking / thinking_budget / thinking：思维链开关与预算temperature / top_p / top_k / min_p 等：采样参数frequency_penalty / presence_penalty / repetition_penalty：惩罚参数headers：自定义请求头extra：额外请求体透传参数include_reasoning_in_request：助手消息中是否回传 reasoning_content（deepseek-v3.2 等）delay：模型级请求间隔（毫秒），未设置时回退全局 libiaoCopilot.delayuseForCommitGeneration：是否用于 Git 提交信息生成（不支持 gemini 模式）cache_control：Anthropic 提示词缓存断点开关（仅 anthropic 模式）
常见问题
Q：配置了模型后还能看到网关新模型吗？
A：能。配置只作为元数据层，供应商新模型会自动出现（默认元数据）；想要完整的上下文/思考强度选择，在 libiaoCopilot.models 里补一条配置即可。
Q：改了配置没生效？
A：修改设置会自动清空模型缓存；如仍无变化，重新加载 VS Code 窗口。
Q：模型选择器是空的？
A：检查 libiaoCopilot.baseUrl 与 API Key 是否已配置。未配置时扩展静默不拉取模型。
致谢
许可
MIT License，详见 LICENSE 与 NOTICE.md。
