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 密钥

⚡ 快速开始

1. 从 Visual Studio Marketplace 安装（或在 VS Code 扩展面板搜索 Libiao Copilot），安装后重新加载窗口。
2. 若已启用 johnny-zhao.oai-compatible-copilot，请先禁用，避免模型重复。
3. 打开设置，配置 libiaoCopilot.baseUrl（公司网关地址，由管理员提供）。
4. 运行命令面板中的 Libiao Copilot: 设置 API Key，输入个人密钥。
5. 打开 GitHub Copilot Chat，选择 Libiao Copilot 提供的模型即可开始对话。
6. 使用模型配置按钮选择上下文大小与思考强度。

扩展默认不内置任何供应商地址。未配置 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 参数指定协议：

混合配置示例

"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.baseUrl
• apiMode：API 协议模式
• family：模型家族（如 'gpt-4'、'claude-3'），用于启用 Copilot 专属优化
• context_length：模型上下文长度，默认 128000
• context_sizes / default_context_size：Copilot 配置菜单中的上下文档位
• max_tokens / max_completion_tokens：最大输出 token 数，默认 4096
• vision：是否支持视觉，默认 false
• reasoning_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.delay
• useForCommitGeneration：是否用于 Git 提交信息生成（不支持 gemini 模式）
• cache_control：Anthropic 提示词缓存断点开关（仅 anthropic 模式）

常见问题

Q：配置了模型后还能看到网关新模型吗？ A：能。配置只作为元数据层，供应商新模型会自动出现（默认元数据）；想要完整的上下文/思考强度选择，在 libiaoCopilot.models 里补一条配置即可。

Q：改了配置没生效？ A：修改设置会自动清空模型缓存；如仍无变化，重新加载 VS Code 窗口。

Q：模型选择器是空的？ A：检查 libiaoCopilot.baseUrl 与 API Key 是否已配置。未配置时扩展静默不拉取模型。

致谢

• OAI Compatible Provider for Copilot（上游项目）
• VS Code Chat Provider API

许可

MIT License，详见 LICENSE 与 NOTICE.md。