必须区分三类系统环境差异：Windows需完全重启IDE才能加载插件；macOS需注意M1/M2芯片下GPU加速可能导致Webview白屏，应关闭该选项；Linux则常因snap沙箱或PATH未配置导致安装失败，推荐用.deb包及code --install-extension命令安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Windows、macOS和Linux三类系统上成功安装Fitten Code插件，必须区分底层环境差异——Windows依赖图形化IDE重启逻辑，macOS对命令行权限更敏感，Linux则常需手动处理PATH和扩展依赖链。
Windows平台：图形界面主导的安装路径
打开VS Code或Visual Studio，确保版本≥1.68.0；若未安装，需先从官网下载最新稳定版并勾选“添加到PATH”和“注册为默认编辑器”选项。
点击左侧扩展图标（Ctrl+Shift+X）→在搜索框输入“Fitten Code”→点击“安装”按钮。
安装完成后【必须完全关闭并重新启动IDE】，否则插件不会加载到侧边栏，状态栏也不会显示激活提示。
启动后检查左下角状态栏是否出现Fitten Code图标，或点击侧边栏新出现的Fitten Code面板确认登录态。
macOS平台：命令行与GUI混合验证
方法一：原生插件市场安装（推荐新手）
启动VS Code → Ctrl+Shift+X → 搜索“Fitten Code” → 安装 → 重启IDE → 点击左下角状态栏图标完成登录。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
方法二：通过命令面板强制刷新（适用于插件未响应）
Cmd+Shift+P → 输入“Developer: Reload Window” → 回车执行 → 再次点击Fitten Code面板触发初始化。
注意：若使用M1/M2芯片Mac且插件无反应，需在VS Code设置中关闭“GPU加速”（设置搜索“disable gpu”并勾选），否则Webview组件可能白屏卡死。
Linux平台：终端驱动型安装流程
第一步：确认已安装VS Code且支持命令行调用
终端输入 code --version，若返回版本号（如1.90.0），说明PATH配置正确；若提示“command not found”，需运行 sudo ln -s /usr/share/code/bin/code /usr/local/bin/code 建立软链接。
第二步：选择任一安装方式
方式①：终端直装（推荐Ubuntu/Debian系）
code --install-extension fitten.code
方式②：图形界面安装（适合GNOME/KDE用户）
打开VS Code → 扩展市场搜索 → 安装 → 重启 → 终端执行 code --list-extensions | grep fitten 验证是否注册成功。
第三步：解决常见权限阻断
若安装后插件显示“disabled”，大概率是snap版VS Code沙箱限制所致——卸载snap包，改用.deb或.tar.gz官方包重新安装。
