外观
10. 故障排查
先按界面上看得到的症状找到对应条目。修改源项目或向导参数后，保存项目并重新打包。
看不到打包入口或无法进入编辑器
可能原因： 发布者账号未登录或登录状态已失效。
处理： 重新完成编辑器登录，进入项目编辑器后再找顶部 打包。这与成品启动时的卡密验证是两套不同入口。
提示项目、目录或清单无效
可能原因： 项目尚未保存，项目目录不可用，或项目清单缺失。
处理： 回到项目编辑器保存项目并确认可以正常重新打开，再按打包前检查重试。
提示没有活动页面或成品界面不对
可能原因： 未选中页面，或打包前选中了错误页面。
处理： 在页面列表中选中准备交付的页面，确认画布内容和尺寸，再保存并重新打包。只有当前页面成为运行程序可见界面。
提示窗口匹配信息为空
可能原因： 当前 PC 连接配置中的窗口标题和窗口类名都为空。
处理： 按绑定 PC 窗口重新获取或填写至少一项匹配信息。
提示星链没有入口或编译失败
可能原因： 缺少开始节点、节点字段不完整、连线无效，或跳转引用页面不可用。
处理： 回到星链编辑器修正错误并完成一次运行调试。字段规则见节点配置参考。
图标不能使用
可能原因： 图标为空、格式不受支持、输入数据超过 8 MiB，或普通图片超过约 6400 万像素。
处理： 重新选择 PNG、JPG/JPEG 或 ICO 文件，并按填写基础信息检查限制。
打包名称或版本号报错
可能原因： 名称为空、含 Windows 非法字符、使用保留名称，或版本号去除首尾空格后不在 1 至 32 个 UTF-8 字节内。
处理： 使用简短名称并修正版本号。版本号不必强制写成三段数字。
输出路径报错
可能原因： 路径为空、目录不存在，或目录位于编辑器安装目录或源项目目录内部。
处理： 新建一个独立输出根目录，例如 D:\LXW-Output，再通过目录选择器选中它。详细规则见设置输出选项。
在 template 或 runtime 阶段失败
可能原因： 独立运行程序模板或 Resource/runtime/ 运行库不完整。
处理： 保留完整错误信息，确认编辑器文件没有被移动、删减或隔离，再从完整环境重试。不要从其他成品目录拼接运行文件。
在 resources 阶段失败
可能原因： 星链引用的模板图片、OCR 模型、YOLO 模型或字库已移动、删除，或不在允许的项目资源目录中。
处理： 回到源项目修复引用并重新保存。打包只复制脚本实际引用的资源，不要在成品中手工补文件。
DM 项目校验失败
可能原因： 全局 DM 凭据、插件路径或运行配置不完整。
处理： 回到编辑器检查本机 DM 配置，确认所选插件和凭据有效，再重新打包。
应用配置同步失败
可能原因： 当前网络不可用、登录状态失效，或应用配置无法同步。
处理： 检查网络和编辑器登录状态，重新进入项目并发起打包。不要把同步失败后的目录当作成品。
打包失败后找不到新目录
原因： 构建失败时，系统会删除本次新建的不完整目录。
处理： 根据弹窗显示的阶段修正问题后重新打包。已有成功成品不会被覆盖。
成品提示缺少 DLL 或资源
可能原因： 只复制了 EXE，或交付过程中改变了目录结构。
处理： 重新交付完整成品目录，并从该目录内启动 EXE。
##运行程序启动后界面空白或立即退出
处理： 确认成品目录完整并记录屏幕错误提示；如果 logs/runtime.log 已生成，再查看其中的致命错误，并核对运行程序模板、运行库和引用资源。最早期校验失败可能只显示错误框，当前运行程序也没有编辑器同款日志按钮。
卡密界面反复出现或运行被阻断
可能原因： 卡密失效、验证被拒绝、缓存不可用，或连续 3 次网络或临时失败。
处理： 恢复网络后点击 重新验证。如果随后回到卡密输入界面，确认卡密有效并点击 验证。缓存不会让成品离线通过验证。
验证成功后标题没有到期时间或时间不符合预期
可能原因： 当前成品未启用卡密验证、验证尚未成功，或电脑本地时区设置不正确。
处理： 先确认已进入运行页面，再核对 Windows 日期、时间和时区。心跳返回新的到期时间后标题会刷新；授权阻断不会清空最后一次已验证时间。
配置不能重命名或删除
原因： 该配置来自打包时的编辑器项目，属于锁定配置。
处理： 可以修改控件值并保存；需要可重命名或删除的配置时，在运行程序中新建配置。
关闭运行程序时提示保存失败
可能原因： data.json 无法写入，磁盘不可用，或文件被其他程序占用。
处理： 不要强制结束进程。释放文件占用、确认成品目录可写并留有空间，再保存和关闭。