办公小浣熊插件在VS Code中安装中断，需卸载残留、清理缓存、安全模式重装，并检查网络与拦截策略，登录卡顿则需重连服务或配置代理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
办公小浣熊（即“代码小浣熊”或“Raccoon”插件）安装中断，通常不是指独立客户端安装失败，而是指在 VS Code 中安装插件时卡在下载、激活或初始化阶段——比如进度条停滞、提示“安装失败”、“扩展主机已终止”，或图标未出现在侧边栏。它本身不走传统桌面程序安装流程，因此不存在“断点续传”机制，但可通过清理缓存、重置状态、绕过拦截等方式快速恢复。
清理 VS Code 插件缓存与残留状态
VS Code 的插件安装依赖临时下载目录和扩展存储区，中断后可能留下损坏的包或锁文件，导致重复安装失败。
- 打开 VS Code 的扩展面板（Ctrl+Shift+X 或 Cmd+Shift+X），找到“Raccoon”或“代码小浣熊”，右键选择 “卸载”（即使显示为未安装，也尝试点击卸载按钮）。
- 关闭 VS Code 全部窗口（包括后台进程），按快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Developer: Toggle Developer Tools，切换到 Console 标签页，确认无报错残留。 - 手动清理本地缓存：
- Windows：删除
%USERPROFILE%\.vscode\extensions\下所有含raccoon或xiaohuanxiong的文件夹； - macOS：删除
~/Library/Application Support/Code/Extensions/中对应文件夹； - Linux：删除
~/.vscode/extensions/中相关目录。
- Windows：删除
以干净模式重启 VS Code 并重装
避免其他插件或策略干扰安装过程，启用纯净环境再试。
- 按住
Shift键（Windows/macOS/Linux 均适用）双击 VS Code 图标启动，会弹出“是否以安全模式启动？”提示，选 是； - 安全模式下打开扩展市场，搜索 “Raccoon”，点击安装；
- 安装完成后，关闭安全模式，正常重启 VS Code；
- 若仍失败，可尝试在命令行中强制重装：
code --install-extension xiaohuanxiong.raccoon
检查网络与系统拦截策略
小浣熊插件需从官网（xiaohuanxiong.com）拉取服务端资源，若网络不稳定或被防火墙/杀软拦截，会导致初始化中断。
- 确认能正常访问 https://www.php.cn/link/1ad0dce67acc73c0f76a45b3c8b04e69 及其 API 域名（如
api.xiaohuanxiong.com）； - 临时关闭 Windows Defender 实时保护、360、腾讯电脑管家等安全软件；
- macOS 用户若提示“已损坏，无法打开”，需在终端执行：
sudo xattr -r -d com.apple.quarantine /Applications/Visual\ Studio\ Code.app
（此操作解除 Gatekeeper 对 VS Code 本身的隔离，间接保障插件加载权限）
登录与激活环节卡住的应对方式
安装成功但登录页打不开、扫码无响应、或提示“初始化失败”，说明前端连接未就绪。
- 点击侧边栏小浣熊图标后，若页面空白或加载转圈，先检查 VS Code 右下角状态栏是否有“Raccoon: Ready”提示；
- 没有提示则点击状态栏中的 Raccoon 图标，选择 “重新连接服务” 或 “导出诊断日志”；
- 日志中若出现
network error或timeout，可手动配置代理（如有）：在 VS Code 设置中搜索raccoon.proxy，填入 HTTP 代理地址； - 也可跳过插件界面，直接访问 https://www.php.cn/link/1ad0dce67acc73c0f76a45b3c8b04e69 完成账号注册与绑定，再返回 VS Code 刷新侧边栏。
不复杂但容易忽略
