AI卡皮巴拉插件无法正常使用时，需依次检查：一、插件是否已安装并启用；二、API密钥与endpoint是否正确配置；三、通过Ctrl+Enter测试基础交互；四、启用项目级上下文（.kapi-config.json）；五、排查网络、代理及防火墙问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在VS Code中安装了AI卡皮巴拉插件但无法正常使用，则可能是由于插件未正确激活、API密钥未配置或网络访问受限。以下是解决此问题的步骤：
一、确认插件已成功安装并启用
VS Code必须识别并加载AI卡皮巴拉插件，才能调用其功能。插件若处于禁用状态或安装中断，将无法响应任何指令。
1、启动VS Code，点击左侧活动栏的扩展图标（或按 Ctrl+Shift+X）。
2、在搜索框中输入 AI卡皮巴拉，确认插件名称完全匹配且状态显示为“已启用”。
3、若显示“已禁用”，请点击右侧齿轮图标，选择“启用”；若未列出该插件，请重新安装。
4、关闭并重新打开VS Code，确保插件完成初始化加载。
二、配置有效API密钥与服务端点
AI卡皮巴拉依赖后端AI服务提供代码生成能力，必须通过合法API密钥认证身份，否则所有请求将被拒绝。
1、访问AI卡皮巴拉官方控制台（如 https://kapi.bara.dev/dashboard），登录开发者账号。
2、进入“API密钥管理”页面，点击“创建新密钥”，复制生成的密钥字符串（以 kp-xxx 开头）。
3、在VS Code中按下 Ctrl+, 打开设置，切换到“扩展”→“AI卡皮巴拉”，在 apiKey 输入框中粘贴密钥。
4、检查 endpoint 字段是否为默认值 https://api.kapi.bara.dev/v1；如使用国内镜像服务，需替换为对应地址。
三、验证基础交互功能是否正常
配置完成后需通过最小可行操作验证插件是否真正就绪，避免因上下文未触发导致误判失效。
1、新建一个空白文件，保存为 test.py（文件名和语言模式影响上下文识别）。
2、在编辑器中输入自然语言注释，例如：// 写一个函数，接收列表返回最大值和索引。
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
3、将光标置于该行末尾，按下快捷键 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）。
4、观察右下角状态栏是否出现“AI卡皮巴拉：正在生成…”提示，并在光标下方插入代码块。
四、启用项目级上下文感知支持
AI卡皮巴拉在分析单文件时能力有限，启用项目上下文可显著提升补全准确性与逻辑连贯性。
1、在当前工作区根目录下新建文件 .kapi-config.json。
2、写入以下内容并保存：
{
"contextDepth": 4,
"includePatterns": ["*.py", "*.js", "*.ts"],
"excludePatterns": ["node_modules/", "dist/", "__pycache__/"]
}
3、重启VS Code，或执行命令面板（Ctrl+Shift+P）中输入 AI卡皮巴拉: Reload Configuration 并回车。
4、在任意源码文件中使用 Alt+K 快捷键唤出上下文增强补全面板。
五、排查常见网络与代理问题
国内用户常因网络策略限制导致API请求超时或被重置，需针对性检查通信链路是否畅通。
1、在VS Code内置终端中运行：curl -I https://api.kapi.bara.dev/health（Linux/macOS）或 curl -I https://api.kapi.bara.dev/health（Windows PowerShell）。
2、若返回 HTTP/2 200，说明基础连通正常；若报错 Could not resolve host，则DNS解析失败。
3、如企业网络使用代理，在VS Code设置中搜索 proxy，填写 http.proxy 和 http.proxyStrictSSL 值。
4、临时禁用防火墙或安全软件，测试是否拦截 code.exe 的出站HTTPS连接。
