这个工具有什么用？

VS Code 内置的 Copilot Chat 默认只能使用 GitHub 官方的模型。本扩展把 Copilot Chat 变成通用的 AI 聊天入口，让你可以在同一个界面上使用：

• 本地模型：llama.cpp、Ollama、vLLM 等本地服务
• 云端模型：OpenAI、Anthropic、Gemini、DeepSeek 等 OpenAI 兼容接口

支持的功能：

• ✅ 工具调用 — 自动调用 Copilot 的工具（读文件、搜索代码、执行命令等）
• ✅ 视觉理解 — 直接发送图片给支持视觉的模型
• ✅ 思考/推理 — 支持带推理能力的模型，显示思考过程
• ✅ 多轮对话 — 正确处理工具结果与上下文
• ✅ 上下文管理 — 可配置历史消息数量、系统提示长度、上下文压缩

快速开始（以本地模型为例）

1. 启动本地模型服务

llama.cpp（推荐 Qwen 模型加 --jinja 参数）：

llama-server \
  --model /path/to/qwen3.6.gguf \
  --mmproj /path/to/mmproj-f16.gguf \
  --host 0.0.0.0 \
  --port 8080 \
  --n-gpu-layers 999 \
  --ctx-size 131072 \
  --jinja \
  --api-key sk-xxx

Ollama：

ollama serve

vLLM：

vllm serve Qwen/Qwen3-35B-A3B --port 11000

2. 在 VS Code 中配置模型

在 .vscode/settings.json（或用户设置）中添加：

{
  "laicopilot.models": [
    {
      "id": "qwen3.6",
      "owned_by": "llamacpp",
      "apiMode": "llamacpp",
      "displayName": "llama Model",
      "baseUrl": "http://localhost:8080",
      "vision": true,
      "context_length": 131072,
      "max_tokens": 65536,
      "thinking_budget": 1024,
      "extra": { "reasoning_watchdog_ms": 90000 }
    }
  ]
}

各字段含义：

3. 开始使用

1. 在 Copilot Chat 的模型下拉框中选择配置好的模型
2. 开始提问 — 模型会自动调用工具（读文件、搜索代码、分析项目等）

云端模型配置示例

{
  "laicopilot.models": [
    {
      "id": "gpt-4o",
      "owned_by": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiMode": "openai",
      "temperature": 0.7
    }
  ]
}

云端模型的 API Key 会在首次使用时弹出输入框，安全地存储在 VS Code 的密钥存储中。

其他设置

可视化配置界面 (ConfigView)

本扩展内置了 VS Code Webview UI，提供图形化的模型管理体验：

1. 打开方式：在 VS Code 命令面板中搜索 LAI: Open Configuration View
2. 功能：
   • 📋 添加/编辑/删除模型配置 — 无需手动编辑 JSON，通过表单完成所有设置项的填写与验证
   • 🔑 API Key 管理 — 在 UI 中直接输入和存储密钥（不写入配置文件），支持每个模型的独立 API Key
   • 🧪 一键测试连接 — 添加模型后点击 Test 按钮，扩展会发送一个简单请求并显示响应结果、延迟与 token 消耗
3. 配置视图在 VS Code Webview 中渲染 HTML/CSS/JS UI（位于 src/views/configView.ts），支持实时预览和表单验证

Git Commit Message Generation (GitLens)

本扩展集成了 GitLens 的 commit message generation API：在 VS Code 命令面板中执行 LAI: Generate Commit Message with Copilot，使用你配置的本地或云端模型自动生成 git commit message。支持自定义生成语言（默认英文）和 system prompt。

Retry Mechanism (自动重试)

对于 OpenAI / Anthropic / Gemini 等云模型的 API 错误（如 429, 500, 502, 503），扩展内置了指数退避的重试机制：

• 默认：最多尝试 3 次，间隔 1s；可自定义最大重试次数 (max_attempts)、间隔时间 (interval_ms)、以及需要合并的 HTTP status codes（如添加 "429", "503"）

Thinking Configuration (Zai Provider)

对于支持 Zai thinking mode 的模型：

• thinking.type = "enabled" — 启用链式思考模式，输出包含 reasoning_content 和思考过程文本；reasoning_effort: "none" / enable_thinking: false → 禁用该请求的所有思考过程。设为 "disabled" 时扩展同时发 thinking_budget_tokens: -1，跳过自适应预算计算
• include_reasoning_in_request = true — 开启后模型会在回复中包含 reasoning_content（如 deepseek-v3.2）

API Key Management (密钥管理)

云端模型的 API Key 不会硬编码在配置中。首次使用时 VS Code Copilot Chat 会弹出输入框，Key 安全存储在 VS Code Secret Storage（OS keychain / Windows Credential Manager）：

API Key 管理

云端模型的 API Key 不会硬编码在配置中。首次使用时 VS Code Copilot Chat 会弹出输入框，Key 安全存储在 VS Code Secret Storage（OS keychain / Windows Credential Manager）：

注意：本地服务（llama.cpp / Ollama / vLLM）不需要 API Key。若你的服务器启用了 --api-key sk-xxx，请在模型配置中设置 apiKey: "sk-xxx"。