workbuddy web界面异常需满足浏览器最低版本及渲染模式要求：chrome≥95、edge≥95、firefox≥91 esr/102、safari≥16.4；必须启用ie=edge标准模式，禁用兼容视图，并确保企业代理不篡改x-ua-compatible响应头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在浏览器中访问 WorkBuddy 的 Web 控制台、技能市场管理页或远程调试界面，但页面无法正常渲染或交互失灵，则可能是由于前端浏览器内核版本过低或未启用标准兼容模式。以下是满足 WorkBuddy 前端功能正常运行的浏览器版本与引擎适配要求：
一、主流桌面浏览器最低版本要求
WorkBuddy 的 Web 管理界面（如 workbuddy.cloud/settings、Claw 插件配置页）依赖现代 Web API（包括 Web Components、ResizeObserver、AbortController 与 WebRTC 数据通道），必须运行于支持 ES2020+ 语法及完整 Fetch API 的浏览器环境。低于以下版本将出现白屏、按钮无响应或技能加载失败。
1、Chrome 用户需使用 Chrome 95 及以上版本，旧版 Chrome（如 89–94）缺少对 atob() 在非 ASCII 字符串下的正确处理，会导致本地知识索引上传失败。
2、Edge 用户需使用 Edge 95（基于 Chromium）及以上版本，禁用 IE 兼容模式；若地址栏右侧显示“兼容性视图”图标，说明当前页面正以 IE11 模式渲染，必须手动关闭并刷新。
3、Firefox 用户需使用 Firefox 91 ESR 或 Firefox 102 及以上版本，低于此版本不支持 globalThis 全局对象，致使 Claw 远程指令解析模块初始化失败。
4、Safari 用户需使用 macOS Safari 16.4（对应 macOS 13.3）及以上版本，Safari 15.x 对 WebAssembly SIMD 指令支持不完整，将导致本地模型路由界面卡在“加载中”状态。
二、强制启用的标准渲染模式
WorkBuddy 前端资源包（HTML/JS/CSS）默认声明 <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> 并采用 HTML5 文档类型，拒绝任何 Quirks Mode 或旧版文档模式解析。若页面意外进入兼容模式，所有动态技能卡片与 MCP 协议调试器将不可见。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
1、在 Chrome 或 Edge 中，按 F12 打开开发者工具 → 切换至 Network 标签 → 刷新页面 → 查看 Response Headers 中的 X-UA-Compatible 字段值是否为 "IE=edge"；若为空或为 "IE=EmulateIE9"，说明企业组策略或本地 hosts 重写劫持了响应头。
2、在 Windows 系统中，检查注册表路径 HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION，确认 WorkBuddy.exe 或 chrome.exe 的 DWORD 值设为 0x00002af9（即 11001 十进制），否则 IE 内核宿主进程会强制降级渲染。
3、若使用企业代理或安全网关（如 Zscaler、深信服AD），需确保其 HTTPS 解密策略未重写 X-UA-Compatible 响应头，否则页面将被强制注入兼容性标记。
三、Webview 与嵌入式容器适配规范
WorkBuddy 桌面客户端内部集成 Chromium Embedded Framework（CEF）v115，其内置 Webview 不受系统浏览器版本影响，但第三方应用通过 WebView2 或 WKWebView 嵌入 WorkBuddy 控制面板时，必须匹配 CEF 的 JS 运行时能力边界，否则触发 SecurityError: Failed to execute 'postMessage' on 'Window' 异常。
1、Windows 应用调用 WebView2 加载 https://workbuddy.cloud/embed?mode=claw 时，需确保 WebView2 Runtime 版本 ≥ 115.0.1901.203，低于此版本不支持 SharedArrayBuffer，导致多 Agent 协同日志流中断。
2、macOS 应用使用 WKWebView 加载同一地址时，必须在 WKWebViewConfiguration 中启用 allowsInlineMediaPlayback = true 与 mediaTypesRequiringUserActionForPlayback = []，否则视频类 Skill 预览窗口无法自动播放。
3、Linux 环境下基于 QtWebEngine 构建的嵌入界面，需确认 QtWebEngineCore 版本 ≥ 5.15.13，并设置 QWebEngineSettings::setWebAttribute(QWebEngineSettings::JavascriptCanAccessClipboard, true)，否则剪贴板联动技能（如“提取微信聊天截图文字”）无法执行。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
