日常怎么用、常见操作怎么做
1. 两种状态
FoxKiosk 只有两个界面，理解了它们就会用了：
| 状态 | 是什么 | 怎么进 |
|---|---|---|
| 前台（业务页） | 全屏 WebView 加载主页 URL，用户看到的全部 | 启动自动进入；配置页点「退出配置」返回 |
| 配置页（管理端） | 内置 React 管理页，六个功能模块 | 长按屏幕右上角热区；或局域网浏览器打开 http://<终端IP>:19500 |
2. 前台（业务页）
- 前台就是业务网页本身，FoxKiosk 不添加任何可见元素（加载中有轻量加载指示）；
- 管理入口：屏幕右上角 50×50 像素隐形热区，长按进入配置页；
- 右键菜单与常见快捷键（Ctrl+N/T/W/R、F5、DevTools 组合键）按安全设置拦截；
- 窗口默认置顶、全屏，防止用户切出到其他程序；
- 开启「退出保护」后，业务页经 JS 桥请求退出时需输入退出密码。
3. 配置页六模块
3.1 基础设置
| 设置 | 说明 |
|---|---|
| 主页 URL | 前台加载的业务网址，必填（需含 http/https）；保存后前台立即跳转 |
| 服务端口 | 本地服务端口，默认 19500；启动时被占用会自动顺延 |
| 用户代理（UA） | 自定义 WebView UA，默认 FoxKiosk/1.0；业务系统可据此识别终端 |
3.2 屏幕设置
| 设置 | 说明 |
|---|---|
| 屏幕方向 | 横屏 / 竖屏 / 自动（移动端生效，桌面端随窗口） |
| 全屏 | 开关全屏模式，默认开 |
| 窗口置顶 | 桌面端窗口始终在最前，默认开 |
3.3 安全设置
| 设置 | 说明 |
|---|---|
| 禁用右键 | 前台与管理页统一禁用右键菜单，默认开 |
| 禁用快捷键 | 拦截刷新 / 新窗口 / DevTools 等常见快捷键，默认开 |
| 退出保护 | 开启后退出应用需输入退出密码 |
| 退出密码 | 默认空；设置后请妥善保管，遗忘需清除应用数据重置 |
3.4 文件管理
- 浏览、上传、重命名、删除终端本地的业务资源（图片 / 视频 / 静态网页等）；
- 支持创建目录与 zip 解压（批量资源先打包再上传，一键展开）；
- 上传的文件经
http://<终端IP>:19500/static/<路径>对局域网提供访问（实际以配置端口为准）。
3.5 缓存管理
- 查看 WebView 缓存占用；一键清理（业务页更新异常时先清缓存再看）。
3.6 系统日志
- 内存保留最近 1000 条，按级别（debug / info / warn / error）与关键字过滤；
- 支持导出 JSON 文件，发给技术支持可加速定位；
- 日志自动脱敏（密码、token 等敏感字段打码）。
4. 桌面端系统托盘
Windows / macOS / Linux 启动后出现托盘图标：
- 打开配置：前台加载配置页；
- 重载应用：重载当前页面；
- 退出：退出程序（受退出保护约束）。
5. 日常操作速查
| 要做什么 | 怎么做 |
|---|---|
| 换业务网址 | 配置页 → 基础设置 → 改 URL → 保存（立即生效） |
| 远程重启页面 | 浏览器进管理页，或调 /api/control/reload；管理页右上「重启应用」按钮亦可 |
| 传一批素材 | 文件管理 → 上传 zip → 解压 → 业务页用 /static/... 引用 |
| 查为什么白屏 | 系统日志 → 级别选 error，看最后几条 |
| 临时窗口化 | 配置页 → 屏幕设置 → 关「全屏」 |
扫码在手机上打开，再用微信右上角的「···」发送给朋友或分享到朋友圈。