Omni精灵 是给「盒子」（客户手上的智能终端设备）安装应用、写入智能体和品牌内容的工具。 不用写脚本、不用敲命令，USB 接上、选好渠道，点一下就装完。
日常使用只有「装机」和「推送」两种场景，跟着下面的步骤走就行。
用 USB 线连接盒子，确认盒子已开启「USB 调试」。然后运行 Omni精灵.exe（不要再用旧的 bat 脚本）。
在顶栏下拉里选一个渠道（比如「无」「songxing」「pm」），侧栏「部署」页里能看到在线设备。
第一次装机 / 换机，点「安装」，会顺序装完所有设备。如果只是改了内容、不需要重装应用，点「推送」就够了。
所有可编辑内容都在 save/{channel}/ 目录下（channel 是 none / songxing / pm 等）。
改完文件，回到 Omni精灵 点「推送」即可生效 —— 不用重新安装应用。
每个智能体一个文件夹，写一份 SKILL.md，说明它的名字、简介、图标和正文。
一份 JSON 文件，列出对话里能匹配到的课件 / 链接，每条有唯一的 content_id。
三个字段：主标题、副标题、对话导师的名字，改完盒子界面就会跟着变。
先确认改的是当前渠道的 save/{channel}/，不是只读的 channel/ 示例目录；然后在 Omni精灵 顶栏点「推送」；推送后要完全退出盒子应用再重新打开。
不会。每个渠道都有自己独立的 save/{channel}/ 文件夹，顶栏切换渠道只是换了一个工作区，互不干扰。选「无」就是一个空白工作区。
先确认设备状态是 device（不是 unauthorized 或 offline），再看部署日志里「设备 i/n」对应哪一台出了问题，针对那一台重试。
检查是否设置了本机 Python 路径，本机是否装了 opencv-python 或 ffmpeg，以及 MP4 文件本身是否能正常播放。
把完整的 SongXingWY_xxxx 文件夹（包含 .weiyuan 和 songxing.manifest.json）放进 save/ 或部署根目录，再重新安装。