GCMP - 提供多个国内原生大模型提供商支持的扩展

Codex CLI - OpenAI Codex

OpenAI 官方编程助手 Codex 的命令行工具，支持通过 codex CLI 进行身份验证（需要本地安装 codex CLI）。

npm install -g @openai/codex@latest

• 支持模型：GPT-5.5、GPT-5.4-mini、GPT-5.4、GPT-5.3-Codex、GPT-5.2
• 用量查询：已支持状态栏显示 ChatGPT 订阅周期剩余用量，可查看订阅余量信息。

Gemini - Gemini CLI

Google 官方 Gemini API 命令行工具，支持通过 Gemini CLI 进行 Login with Google 认证（需要本地安装 Gemini CLI）。

npm install -g @google/gemini-cli@latest

• 支持模型：Gemini 2.5 Pro、Gemini 2.5 Flash、Gemini 2.5 Flash Lite
• 预览模型：Gemini 3.1 Pro (Preview)、Gemini 3.1 Pro (Custom Tools)、Gemini 3 Pro (Preview)、Gemini 3 Flash (Preview)

通用模型参数 及 额外支持功能 配置

{
    "gcmp.maxTokens": 32000, // 32-256000
    "gcmp.retry.maxAttempts": 3, // 1-5，仅对可重试错误生效
    "gcmp.zhipu.search.enableMCP": true // 启用`联网搜索MCP`（Coding Plan专属）
}

• gcmp.retry.maxAttempts 默认值为 3，用于控制 429、限流和临时过载类错误的最大自动重试次数。
• 当前重试延迟序列为 1s → 3s → 6s → 10s → 15s，达到上限后会直接抛出最后一次错误。

配置示例：

{
    "gcmp.providerOverrides": {
        "dashscope": {
            "models": [
                {
                    "id": "deepseek-v3.2",
                    "name": "Deepseek-V3.2",
                    "maxInputTokens": 128000,
                    "maxOutputTokens": 16000,
                    "capabilities": {
                        "toolCalling": true,
                        "imageInput": false
                    }
                }
            ]
        }
    }
}

提供商配置覆盖

GCMP 支持通过 gcmp.providerOverrides 配置项来覆盖提供商的默认设置，包括 baseUrl、customHeader、模型配置等。

配置示例：

{
    "gcmp.providerOverrides": {
        "dashscope": {
            "models": [
                {
                    "id": "deepseek-v3.2", // 增加额外模型：不在提示可选选项，但允许自定义新增
                    "name": "Deepseek-V3.2 (阿里云百炼)",
                    "tooltip": "DeepSeek-V3.2是引入DeepSeek Sparse Attention（一种稀疏注意力机制）的正式版模型，也是DeepSeek推出的首个将思考融入工具使用的模型，同时支持思考模式与非思考模式的工具调用。",
                    // "sdkMode": "openai", // 阿里云百炼已默认继承提供商设置，其他提供商模型可按需设置
                    // "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
                    "maxInputTokens": 128000,
                    "maxOutputTokens": 16000,
                    "capabilities": {
                        "toolCalling": true,
                        "imageInput": false
                    }
                }
            ]
        }
    }
}

自定义模型内置已知提供商ID及显示名称列表

聚合转发类型的提供商可提供内置特殊适配，不作为单一提供商提供。
若需要内置或特殊适配的请通过 Issue 提供相关信息。

配置示例：

{
    "gcmp.compatibleModels": [
        {
            "id": "glm-4.6",
            "name": "GLM-4.6",
            "provider": "zhipu",
            "model": "glm-4.6",
            "sdkMode": "openai",
            "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4",
            // "sdkMode": "anthropic",
            // "baseUrl": "https://open.bigmodel.cn/api/anthropic",
            "maxInputTokens": 128000,
            "maxOutputTokens": 4096,
            "capabilities": {
                "toolCalling": true, // Agent模式下模型必须支持工具调用
                "imageInput": false
            },
            // customHeader 和 extraBody 可按需设置
            "customHeader": {
                "X-Model-Specific": "value",
                "X-Custom-Key": "${APIKEY}"
            },
            "extraBody": {
                "temperature": 0.1,
                "top_p": 0.9,
                // "top_p": null, // 部分提供商不支持同时设置 temperature 和 top_p
                "thinking": { "type": "disabled" }
            }
        }
    ]
}

实验性功能：sdkMode（OpenAI Responses / Gemini SSE）

gcmp.compatibleModels[*].sdkMode 用于指定兼容层的请求/流式解析方式。除 openai / anthropic 标准模式外，以下两项为实验性能力：

• openai-responses：OpenAI Responses API 模式（实验性）

  • 使用 OpenAI SDK 的 Responses API（/responses）进行请求与流式处理。
  • 参数：默认不传递 max_output_tokens，若需设置通过 extraBody 单独设置
  • Codex：默认通过请求头传递 conversation_id、session_id，请求体传递 prompt_cache_key（火山方舟传递 previous_response_id 除外）。
  • 注意：并非所有 OpenAI 兼容服务都实现 /responses；若报 404/不兼容，请切回 openai 或 openai-sse。
  • useInstructions（仅对 openai-responses 生效）：是否使用 Responses API 的 instructions 参数传递系统指令。
    • false：用“用户消息”承载系统指令（默认，兼容性更好）
    • true：用 instructions 传递系统指令（部分网关可能不支持）

• gemini-sse：Gemini HTTP SSE 模式（实验性）

  • 使用纯 HTTP + SSE（data:）/ JSON 行流解析，不依赖 Google SDK，主要用于兼容第三方 Gemini 网关。
  • 适用：你的网关对外暴露 Gemini :streamGenerateContent 风格接口（通常需要 alt=sse）。
  • 工具参数会自动做 Schema 清理与 Gemini 方言转换，兼容 const、$ref、可空联合类型以及空对象 / 空数组等常见写法。

FIM / NES 内联补全建议模型配置

FIM 和 NES 补全都使用单独的模型配置，可以分别通过 gcmp.fimCompletion.modelConfig 和 gcmp.nesCompletion.modelConfig 进行设置。

• 启用 FIM 补全模式（推荐 DeepSeek、Qwen 等支持 FIM 的模型）：
  • 已测试支持 DeepSeek、硅基流动，特殊支持 阿里云百炼。

{
    "gcmp.fimCompletion.enabled": true, // 启用 FIM 补全功能
    "gcmp.fimCompletion.debounceMs": 500, // 自动触发补全的防抖延迟
    "gcmp.fimCompletion.timeoutMs": 5000, // FIM 补全的请求超时时间
    "gcmp.fimCompletion.modelConfig": {
        "provider": "deepseek", // 提供商ID，其他请先添加 OpenAI Compatible 自定义模型 provider 并设置 ApiKey
        "baseUrl": "https://api.deepseek.com/beta", // ⚠️ DeepSeek FIM 必须使用 beta 端点才支持
        // "baseUrl": "https://api.siliconflow.cn/v1", // 硅基流动(provider:`siliconflow`)
        // "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", // 阿里云百炼(provider:`dashscope`)
        "model": "deepseek-chat",
        "maxTokens": 100
        // "extraBody": { "top_p": 0.9 }
    }
}

• 启用 NES 手动补全模式：

{
    "gcmp.nesCompletion.enabled": true, // 启用 NES 补全功能
    "gcmp.nesCompletion.debounceMs": 500, // 自动触发补全的防抖延迟
    "gcmp.nesCompletion.timeoutMs": 10000, // NES 补全请求超时时间
    "gcmp.nesCompletion.manualOnly": true, // 启用手动 `Alt+/` 快捷键触发代码补全提示
    "gcmp.nesCompletion.modelConfig": {
        "provider": "zhipu", // 提供商ID，其他请先添加 OpenAI Compatible 自定义模型 provider 并设置 ApiKey
        "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4", // OpenAI Chat Completion Endpoint 的 BaseUrl 地址
        "model": "glm-4.6", // 推荐使用性能较好的模型，留意日志输出是否包含 ``` markdown 代码符
        "maxTokens": 200,
        "extraBody": {
            // GLM-4.6 默认启用思考，补全场景建议关闭思考以加快响应
            "thinking": { "type": "disabled" }
        }
    }
}

• 混合使用 FIM + NES 补全模式：

• 自动触发 + manualOnly: false：根据光标位置智能选择提供者
  • 光标在行尾 → 使用 FIM（适合补全当前行）
  • 光标不在行尾 → 使用 NES（适合编辑代码中间部分）
  • 如果使用 NES 提供无结果或补全无意义，则自动回退到 FIM
• 自动触发 + manualOnly: true：仅发起 FIM 请求（NES 需手动触发）
• 手动触发（按 Alt+/）：直接调用 NES，不发起 FIM
• 模式切换（按 Shift+Alt+/）：在自动/手动间切换（仅影响 NES）

MistralAI Coding FIM 配置示例

{
    "gcmp.compatibleModels": [
        {
            "id": "codestral-latest",
            "name": "codestral-latest",
            "provider": "mistral",
            "baseUrl": "https://codestral.mistral.ai/v1",
            "sdkMode": "openai",
            "maxInputTokens": 32000,
            "maxOutputTokens": 4096,
            "capabilities": {
                "toolCalling": true,
                "imageInput": false
            }
        }
    ],
    "gcmp.fimCompletion.enabled": true,
    "gcmp.fimCompletion.debounceMs": 500,
    "gcmp.fimCompletion.timeoutMs": 5000,
    "gcmp.fimCompletion.modelConfig": {
        "provider": "mistral",
        "baseUrl": "https://codestral.mistral.ai/v1/fim",
        "model": "codestral-latest",
        "extraBody": { "code_annotations": null },
        "maxTokens": 100
    }
}

快捷键与操作

主要特性

• 实时监控：状态栏实时显示当前会话的上下文窗口占用比例
• 详细统计：悬停状态栏可查看详细的上下文占用信息，包括：
  • 系统提示：系统提示词占用的 token 数量
  • 可用工具：工具及MCP定义占用的 token 数量
  • 环境信息：编辑器环境信息占用的 token 数量
  • 压缩消息：经过压缩的历史消息占用的 token 数量
  • 历史消息：历史对话消息占用的 token 数量
  • 思考内容：会话思考过程占用的 token 数量
  • 本轮图片：当前会话图片附件的 token 数量
  • 本轮消息：当前会话消息占用的 token 数量

主要特性

• 持久化记录：基于文件系统的日志记录，无存储限制，支持长期数据保存
• 用量统计：记录每次 API 请求的模型和用量信息，包括：
  • 模型信息（提供商、模型 ID、模型名称）
  • Token 用量（预估输入、实际输入、输出、缓存、推理等）
  • 请求状态（预估/完成/失败）
• 多维度统计：按日期、提供商、模型、小时等多维度查看统计数据
  • 小时统计详情：支持按小时、提供商、模型三层嵌套显示
    • ⏰ 小时级别：显示该小时的总计数据
    • 📦 提供商级别：显示该提供商在该小时的汇总数据
    • ├─ 模型级别：显示该模型在该小时的详细数据
    • 提供商和模型按请求数降序排列，无有效请求的提供商和模型不显示
• 实时状态栏：状态栏实时显示今日 Token 用量，30秒自动刷新
• 可视化视图：WebView 详细视图支持查看历史记录、分页显示请求记录

使用方式

• 查看统计：点击状态栏的 Token 用量显示，或通过命令面板执行 GCMP: 查看今日 Token 消耗统计详情 命令
• 历史记录：在详细视图中可查看任意日期的统计记录
• 数据管理：支持打开日志存储目录进行手动管理

配置选项

{
    "gcmp.usages.retentionDays": 100 // 历史数据保留天数（0表示永久保留）
}

系统要求

• vscode.git 扩展：该功能依赖 VS Code 内置的 vscode.git 扩展来访问 Git 仓库信息
  • 扩展会自动检测 Git 可用性，当 Git 不可用时相关按钮将自动隐藏
  • 如果你的环境中禁用了 vscode.git 扩展，Commit 消息生成功能将不可用

使用入口：Git仓库管理视图

• 仓库标题栏按钮：生成提交消息
• 更改分组栏按钮：
  • 在“暂存的更改”上生成：生成提交消息 - 暂存的更改
  • 在“更改”上生成 生成提交消息 - 未暂存的更改

生成范围说明（staged / working tree）

• 生成提交消息：默认行为，同时分析 staged + working tree（tracked + untracked）。
• 生成提交消息 - 暂存的更改：仅分析 staged，适合“分步提交/拆分提交”。
• 生成提交消息 - 未暂存的更改：仅分析 working tree（tracked + untracked），不包含 staged。

多仓库工作区：如果当前工作区包含多个 Git 仓库，GCMP 会尝试根据你点击的 SCM 区域推断仓库；无法推断时会弹出仓库选择。

模型选择与配置

该功能基于 VS Code Language Model API 调用模型。

• 第一次使用或未配置模型时，会自动引导选择模型（也可手动运行 GCMP: 选择 Commit 消息生成模型）。
• 相关配置项：

{
    "gcmp.commit.language": "chinese", // 生成语言：chinese / english（auto 模式语言不明确时的回退值）
    "gcmp.commit.format": "auto", // 提交消息格式：auto(默认) / 见下方 format 说明
    "gcmp.commit.customInstructions": "", // 自定义指令（仅当 format=custom 时生效）
    "gcmp.commit.model": {
        "provider": "zhipu", // 生成模型的提供商（providerKey，例如 zhipu / minimax / compatible）
        "model": "glm-4.6" // 生成模型的 ID（对应 VS Code Language Model 的 model.id）
    }
}

gcmp.commit.format 格式说明与示例

说明：以下示例仅用于展示格式形态；实际内容会根据你的 diff 自动生成。

• auto：自动推断（会参考仓库历史的语言/风格；不明确时回退为 plain + gcmp.commit.language），默认推荐。

• plain：简洁一句话，不含 type/scope/emoji（适合快速提交）。

• custom：完全由你的自定义指令控制（gcmp.commit.customInstructions）。

• conventional：Conventional Commits（可带 scope，常见写法是“标题 + 可选正文要点”）。

feat(commit): 新增提交消息生成

- 支持 staged / 未暂存分别生成
- 自动补充相关历史提交作为参考

• angular：Angular 风格（type(scope): summary，语义上接近 conventional）。

feat(commit): 新增 SCM 入口

- 在仓库标题栏与更改分组栏增加入口

• karma：Karma 风格（偏“单行”，保持短小）。

fix(commit): 修复多仓库选择

• semantic：语义化 type: message（不带 scope；也可以带正文要点）。

feat: 新增提交消息生成

- 自动识别本次变更的关键 diff

• emoji：Emoji 前缀（不带 type）。

✨ 新增提交消息生成

• emojiKarma：Emoji + Karma（emoji + type(scope): msg）。

✨ feat(commit): 新增提交消息生成

- 更贴合仓库既有提交习惯

• google：Google 风格（Type: Description）。

Feat: 新增提交消息生成

- 支持按仓库风格自动选择语言与格式

• atom：Atom 风格（:emoji: message）。

:sparkles: 新增提交消息生成