悟空浏览器无法读取本地HTML文件是因file://协议被默认禁用、权限未开放、编码未声明及路径非法等多重限制；需启用文件系统访问权限、放宽同源策略、强制指定正确编码格式。
悟空浏览器扫描本地文件时无法读取HTML文档，是因为浏览器默认禁用file://协议下的脚本执行与跨文件资源加载，同时系统权限未开放、编码未声明、路径含非法字符等多重限制叠加，导致HTML文件双击打开后空白、报错或直接跳转失败。
启用本地文件系统访问权限
这是所有后续操作的前提，缺此一步，HTML连基础解析都无法启动。
1、在悟空浏览器地址栏输入 wukong://settings/content/file 并回车，直达本地文件权限设置页。
2、找到【允许网站访问文件系统】开关，点击开启（状态变为蓝色/ON）。
3、【必须彻底重启浏览器：打开任务管理器，结束所有WukongBrowser.exe进程，再重新启动】，否则该设置永不生效——很多用户卡在这一步，反复修改却无反应。
放宽同源策略对file://协议的拦截
本地HTML若引用了同目录下的CSS、JS或图片，浏览器会因file://无origin而拒绝加载资源，页面只剩骨架。
方法一：命令行启动（调试首选）
1、完全退出悟空浏览器所有窗口。
2、Windows按Win+R → 输入cmd → 回车，执行以下命令：
start "" "C:\Program Files\WukongBrowser\WukongBrowser.exe" --unsafely-treat-insecure-origin-as-secure="file://" --user-data-dir="C:/wukong-local-test"
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
该命令新建一个独立配置实例，不干扰日常使用，且自动赋予file://协议完整信任链。
方法二：修改桌面快捷方式（长期固定方案）
右键悟空浏览器桌面图标 → 属性 → 在“目标”末尾加一个空格，再粘贴：--unsafely-treat-insecure-origin-as-secure="file://" → 点击确定保存。以后从此快捷方式打开，即默认启用本地安全上下文。
强制指定HTML文件编码格式
中文HTML若未声明charset或保存为GBK编码，悟空浏览器常误判为UTF-8，导致解析中断、标签闭合错乱、script标签被截断，最终白屏。
第一步：检查HTML头部是否含正确声明
用记事本或VS Code打开该HTML文件，在
内确认存在：第二步：若无声明或编码不匹配，手动添加对应meta标签并保存为对应编码格式（UTF-8无BOM最稳妥）。
第三步：仍乱码？在浏览器控制台（F12）中执行：document.charset='GBK';location.reload(); —— 这能强制重解码并刷新，适用于临时救急。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
