必须完成插件安装与百度账号登录两步才能启用comate全部功能；需在vs code扩展市场搜索“文心快码”或“baidu comate”，认准baidu官方发布者后安装，安装后须彻底重启vs code而非仅重载窗口，再通过浏览器登录百度账号并切回vs code等待状态栏显示“comate已就绪”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 VS Code 里启用百度 Comate 的 AI 补全、代码解释、单测生成等核心能力，必须完成插件安装 + 百度账号登录两步；没登录就只是个哑巴补全框，连 Ctrl+Space 都不弹建议，更别提智能聊天和多模态理解。
VS Code 中搜索安装 Comate 插件
打开 VS Code，按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）唤出扩展面板。
在搜索框输入 文心快码 或 Baidu Comate，认准发布者为 Baidu 官方——第三方仿冒插件图标模糊、评分低、更新停滞，点错会导致认证失败或功能缺失。
点击 Install 按钮安装插件。这一步操作起来很简单，直接点就行。
安装后必须彻底重启 VS Code
安装完成后，不要点“重新加载窗口”，而是关闭所有 VS Code 窗口（包括后台进程），再双击图标重新启动程序。
⚠️ 若只点“重载窗口”，Comate 插件不会初始化认证模块，右上角根本不会弹出登录浮层——后续所有登录操作都无效。
重启后，右上角自动弹出登录浮层，点击「跳转浏览器」；用手机号注册的普通百度账号登录（企业邮箱或教育域账号常因权限未开通而失败）。
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
浏览器登录后切回 VS Code 完成激活
第一步：浏览器登录成功后，千万别关掉该标签页——Comate 插件靠轮询检测认证状态，关掉就断连。
第二步：按下 Alt+Tab（Windows/Linux）或 Cmd+Tab（macOS）手动切回 VS Code 窗口。
第三步：等待 3～5 秒，右下角状态栏出现绿色 「Comate 已就绪」 提示，即表示激活完成。
若仍显示“未登录”：进入 VS Code 设置（Ctrl+,），搜索 proxy，把 HTTP 代理设为 none——Comate 不走系统代理，开着代理反而卡住认证。
离线安装（插件市场打不开时用）
方法一：拖拽安装（最稳，推荐首选）
把未解压的 .vsix 文件直接拖进 VS Code 主编辑区（即代码显示区域，不是侧边栏、不是设置页），松手即弹出确认框。此方式绕过 CLI 依赖，不校验 PATH，成功率最高。
方法二：命令行安装
打开终端，执行：
code --install-extension /path/to/comate-3.2.1.vsix
⚠️ 路径必须为绝对路径；Windows 含空格路径需加英文双引号；若提示 command not found: code，先按 Ctrl+Shift+P → 输入「Shell Command: Install 'code' command in PATH」并回车执行。
安装后同样需彻底重启 VS Code，再按前述步骤完成浏览器登录与窗口切换。
