排障 · FreeCut Video Editor展示说明书架构日志
第 05 章

U0001F6E0️排障

进阶

1. 页面空白,控制台报 /assets/ 404

  • 原因:2026-11-03 前的旧缓存。已修复:展示站资源全部改 /s/freecut/ 前缀(快照 ecd8add8a6/775b42c683)。
  • 解决:硬刷新(Ctrl+Shift+R)或清空网站数据后重进。

2. /projects 显示“出了点问题 / Workspace root is not set”

  • 原因:编辑器需要浏览器文件系统权限(showDirectoryPicker/OPFS),http 下不可用(已验证:isSecureContext=false)。
  • 解决:改走 https 入口 https://leyon.top:8443/s/freecut/,选择工作区文件夹并授权。

3. 公网打开全站 502

  • 原因:119.145.17.34 公网隧道/反代故障,与 freecut 无关(内网直连正常)。
  • 解决:等隧道恢复后重试,或切内网 http://192.168.11.70:5070/s/freecut/ 看落地页。

4. “找不到页面 / Not Found”

  • 原因:旧版本安装的 PWA / 旧 SW 缓存,或直接访问了深层路甲(展示站无 SPA 回避,刷新深层页会 404)。
  • 解决:始终从 /s/freecut/ 首页进,站内导航不要刷新深层页。