参数、批量与稳定性相关
1. 批量部署
单机定位，多块大屏的批量做法：
- 装第一台：安装后把场景、背景、字体全部配置到位（这些都在数据目录）；
- 提取数据目录：
settings.json+scenes/+assets/即为该大屏的完整内容档案； - 铺开：将其余大屏装好软件后停掉进程，把数据目录覆盖到各自的用户数据目录（Windows
%APPDATA%\foxdisplay，Linux~/.config/foxdisplay），再启动——所有大屏显示一致内容； - 差异化：只需要改每台的
settings.json中不影响展示的字段；显示内容各台可以不同（各自维护scenes/）。
注意：各台大屏的
currentSceneId引用的场景 id 必须存在于其scenes/或内置模板中，否则回退到首个可用场景。
2. 长时间运行（无人值守）
| 机制 | 说明 |
|---|---|
| 开机自启 | 系统设置打开后写入登录项；配合系统自动登录实现上电即展示 |
| 单实例 | 重复启动不会产生第二个进程，自动聚焦已有窗口 |
| 断电自恢复 | 场景与设置每次修改即写盘，上电后恢复最近状态 |
| Kiosk 模式 | 系统设置打开后锁定全屏（无托盘逃逸），适合无人值守大屏 |
| 服务监听 | 三端口随进程启动即监听，崩溃重启后自动恢复监听 |
建议组合：系统自动登录 + 开机自启 + Kiosk 全屏 + 访问密码（防误改）。
3. 权限与安全
| 项 | 说明 |
|---|---|
| 访问密码 | 系统设置中设置后，42301 的全部 API 需携带 token（查询参数 ?token= 或请求头 X-Fox-Token）；健康检查与验证接口除外 |
| 鉴权范围 | 管理后台静态页与 /assets/* 图片资产不设防；密码防的是「改内容」，不是「看内容」 |
| 中控通道 | TCP 42302 / UDP 42303 面向内网中控不做账号验证——依赖内网边界保护，不要把这两端口暴露到公网 |
| 密码修改 | 后台「系统设置」，修改/清除即时生效；清除密码的请求本身也需要当前密码通过鉴权 |
4. 性能与稳定性
- 渲染为 DOM/CSS 合成，20 个模板均为轻量元素，核显即可流畅；大图片背景建议控制在 10MB 内（上传限制）；
- 命令处理为本机内存操作，毫秒级；WebSocket 推送延迟通常低于 100ms；
- 运行日志为内存环形缓冲（500 条），不写磁盘、不膨胀；
- 长期运行无定时任务堆积；时钟元素每秒一次刷新，开销可忽略。
5. 离线环境部署
全程不需要公网：
- 在有网机器下载安装包与（可选的）背景图、字体文件；
- 拷贝到目标大屏安装；字体与背景在「资产中心」本地上传，不访问任何在线资源；
- 内置 20 模板与 30 张背景图随安装包自带，离线开箱即用；
- 升级：新安装包拷贝过去覆盖安装即可，用户数据（场景/资产/设置）保留。
6. 典型故障排查
| 现象 | 原因 | 处理 |
|---|---|---|
| 改了内容大屏没变 | 编辑的是 A 场景，大屏显示的是 B | 场景管理页确认「当前显示」徽标；或编辑器内点保存（保存即应用） |
| 浏览器打不开后台 | 不同网段 / IP 错 / 端口被改 | 大屏本机确认 IP；后台总览页（大屏本机打开）核对当前端口 |
| 提示「需要访问密码」 | 已设置访问密码 | 登录页输入密码；忘记密码可在数据目录 settings.json 中清空 password 字段后重启 |
| 命令通道无响应 | 42302/42303 未放行或 IP 不通 | 检查防火墙与网段；用后台「接口文档」页日志确认命令是否到达 |
| 字体上传后编辑器里找不到 | 字体名即文件名（去扩展名） | 资产中心确认已上传；编辑器「字体」面板按文件名查找 |
| 场景删除后大屏黑屏 | 删除的是当前场景且无其他场景 | 场景管理新建或从模板库新建后「显示」；极少发生（删当前场景会自动切到首个可用场景） |
| 双击文字无法编辑 | 元素处于选中但非文字类型 | 图片/形状无文字；仅文字与图标文字块支持就地改字 |
扫码在手机上打开，再用微信右上角的「···」发送给朋友或分享到朋友圈。