确认插件版本、PPT 版本、授权状态均已读取。授权不可用时先处理授权。
文档手册
Mingcedar Studio 现场排障
按故障现象检查安装与授权、导出与脚本、Tag 与变量、模板参数和视频接入。菜单可用时先查看 Status 中的版本和授权信息。
开始排障前的三项确认
菜单可用时查看 Mingcedar Studio 功能区右侧 Status。菜单未出现时，运行安装器中的 Doctor 检查环境，再按诊断结果修复安装。
按安装、授权、导出、脚本、数据绑定或视频问题进入对应小节。
每次调整一项，在 PowerPoint 复测并记录变化。
授权状态异常或已激活后不可用
确认授权类型，再检查服务地址、账号状态、离线证书与当前机器环境是否匹配。
Status 显示未授权或不可用时，先进入授权中心处理授权；在线授权状态异常时，再检查授权服务是否可达。
确认授权服务地址、账号状态和网络连通。服务端吊销后，插件会失效并关闭相关窗口。
离线证书必须匹配当前机器和当前用户环境。证书不匹配时，重新导出离线请求，再签发新证书。
- 更换电脑后重新生成离线请求
- 导入后再次查看菜单右侧 Status，确认授权状态为可用
- 正式环境使用正式授权服务配置
导出后页面不一致、当前页覆盖异常或图片未更新
确认导出方式，再检查页面对象、模板实例、图片资源和共享资源是否已重新导出。
整包导出适合正式发布或大改；当前页导出适合局部替换。共享结构、导航或整体资源改动后，使用整包导出。
确认本次改动属于页面对象、模板实例还是图片资源。对象改动可重导当前页；共享资源或结构改动使用整包导出。
使用目标 Mingcedar 环境验证画面包。静态预览可检查布局，实时数据、写值权限、报警、趋势和媒体服务需要在宿主运行环境中确认。
- 整包导出后确认目录结构和资源完整
- 使用当前页更新时检查目标页面与未修改页面
- 替换正式画面前，在目标 Mingcedar 中确认数据、权限和交互结果
脚本执行错误或配置后未生效
确认脚本所在位置，再检查当前输入框支持完整 JS、同步表达式还是纯 JSON。
Page Script、Click Script、Press/Release Script 和 Hover Script 可填写完整 JavaScript；动画、颜色和条件表达式应返回同步结果。Tag 写入仅可在真实用户点击、按下或释放动作中调用。
fetch 等异步逻辑放在页面或交互脚本中；Move、Rotate、Scale、Script Color 和 Condition 的表达式字段只返回同步结果。await 只能写在 async 函数内。
先检查语法诊断，再确认当前输入框需要完整脚本还是单个表达式。alarm.js 也是页面 JavaScript 文档。
同页复用函数放在页面脚本；按钮优先使用内置行为，需要扩展时再写脚本。
- 初始化放在 hqVisuDesignerPageReady
- 异步逻辑放在脚本字段，表达式返回同步结果
- WriteTag 仅在真实用户点击、按下或释放动作中调用；不用于 Page Script、Definition 或 Hover Script
名称被当成数值、模板未替换或计算 Tag 无法读取
先确认输入框需要名称还是值，再检查表达式返回类型、变量作用域和模板参数替换结果。
Target tag 等名称字段可填写完整固定 Tag 名称，例如 PLC_LINE01.TANK01.LEVEL。使用动态名称时，按字段说明填写表达式并返回名称字符串；Condition、Source value 等值字段需要布尔值或数值，读取 Tag 时使用对应的 ReadTag 方法。
前导 = 只在支持它的配置字段中标记表达式，不是 JavaScript API 参数语法。<PLC>、<TAG> 是模板替换参数，不能直接等同于运行变量。先确认模板实例的参数已替换，再检查最终字段内容。
使用 ReadCalculatedTag("Line01TotalFlow", null) 按宿主计算 Tag 名称读取，不加 PLC 前缀。检查 Mingcedar 中该计算 Tag 是否存在、启用且已产生结果；返回 null 时按所选回退策略处理。计算 Tag 不作为 Write Tag 或 PLC Tag 输入模板的写入目标。
Page Script 顶层只读取一次 Tag 时，得到的是初始化时的结果。实时行为应在每次求值时调用读取方法或同页读取函数；通过运行变量驱动时，应检查变量更新来源和作用域。
设计端可播放，发布后视频无法播放
从运行端检查媒体地址、文件部署、媒体通道、访问权限、编码和浏览器支持。
本地视频文件不会复制到画面包，并会阻止导出。请先将媒体部署到运行端可访问的位置，再把模板中的本地文件改为 HTTP(S) 媒体直链后导出；普通网页地址不能替代媒体直链。
使用 Mingcedar 媒体通道时，确认通道已启用且可访问。浏览器不能直接播放原始 RTSP 地址；按视频模板说明选择接入方式，并检查 HTTPS、跨域、播放权限和媒体编码。