一、系统硬性要求
设备系统需为 Win7 及以上版本，软件不支持虚拟机环境、其他非标系统安装使用。
二、提示管理员运行
- 安装路径选择桌面或除系统盘以外其他磁盘；
- 安装程序右键选择以管理员身份运行。
三、旧版本残留异常处理
若电脑已在其他文件夹安装过软件：
- 完整删除原有安装目录文件夹；
- 更换全新路径重装，安装目录全程禁用中文、特殊字符，仅使用字母 + 数字命名；
- 重装完成后重启电脑重试。
四、目录路径规范排查
1. 安装目录查找
右键桌面软件图标→打开文件所在位置，查看文件夹名称；
2. 数据目录路径
默认路径：
\Documents\TouchSpriteUltENT_Files\（系统文档文件夹内）；安装目录、数据目录文件夹含中文 / 特殊符号时，重命名为纯英文、数字后重试。
五、首次打开启动失败处理
首次安装未登录即报错：查找档目录
\Documents\TouchSpriteUltENT_Files\runtime\，缺失文件夹则按目录层级手动逐层新建文件夹，完成后重启软件。六、版本升级后启动故障处理
新版升级后打不开：打开文档目录
\Documents\TouchSpriteUltENT_Files，对file_cache文件夹改名或直接删除，重新升级安装。七、控制台闪退
1. 双击启动 bat 文件
- 进入软件安装目录，双击文件：
run-控制台闪退时请用双击这里启动.bat； - 弹出 loading 页面卡死：再次双击该 bat 文件，第二次启动大多可正常运行。
2. 检查 db 文件
- 查找档目录
\Documents\TouchSpriteUltENT_Files\user_info文件，此文件中 user_id 对应的就是账号 ID。 - 打开 user_database 文件夹，找到账号 ID 对应名称的 db 文件，将文件剪切到其他位置，重新打开看是否正常；
- 如果正常说明这个 db 文件已损坏，需要重新添加设备、分组等操作。
- 如果仍不能打开说明不是此文件问题，需要将之前的 db 文件迁回。
八、数据目录迁移 & 系统环境变量修复
- 核查路径
\Documents\TouchSpriteUltENT_Files\runtime\，目录存在则将整体数据目录迁移至其他磁盘（参考文档：http://www.touchsprite.com/docs/5257）； - 迁移后无法自动生成数据文件夹：按下
Win+R输入 cmd 回车，执行tasklist：- 正常显示进程列表：系统环境变量无误；
- 提示命令不存在：按下方步骤配置系统 PATH 环境变量1）此电脑右键→属性→高级系统设置；2）选择【环境变量】；3）系统变量点击【新建】，变量名：
PATH，变量值：C:\Windows\System32；4）逐级保存确定，重启电脑生效。
九、防火墙联网权限放行设置
需放行
ent_lua、Node.js两个程序防火墙权限：- 打开 Windows 防火墙→允许应用通过防火墙；
- 点击更改设置，在应用列表勾选 ent_lua、Node.js 的专用 / 公用网络选项；
- 列表找不到程序：点击【允许其他应用】→浏览，进入安装目录
\TouchSpriteUltENT\bin\win32\，依次选中win_node.exe、ent_lua.exe添加至列表，勾选权限后保存，重启中控。
十、反馈渠道
以上方案全部无效，加入触动企业版用户 2 群：515866088，联系客服；
反馈材料：打包\Documents\TouchSpriteUltENT_Files\runtime\内全部日志文件，文件夹缺失则手动创建后收集日志。
