文档手册

HQ VISU Designer 现场排障

按照故障现象进入核查步骤。建议先确认菜单右侧 Status，再分别检查菜单响应、授权状态、导出结果和脚本执行情况。

Status 自检授权与导出脚本错误

基础核查

开始排障前的三项确认

打开 PowerPoint 顶部 HQ VISU Designer 菜单右侧 Status，确认插件版本、PowerPoint 版本和授权状态。

CHECK 1. 确认 Status 信息

确认插件版本、PPT 版本、授权状态均已读取。授权不可用时先处理授权。

CHECK 2. 明确故障类型

将问题归类为菜单响应、授权状态、导出结果或脚本执行，再进入对应小节处理。

CHECK 3. 单项调整并复测

每次仅调整一项配置或操作条件，返回 PowerPoint 复测，并记录现象变化。

Case 1

确认插件已连接当前 PowerPoint 会话，再检查授权状态、初始化状态和窗口响应。

Case 2

确认授权类型，再检查服务地址、账号状态、离线证书与当前机器环境是否匹配。

读取 Status 授权状态

Status 显示未授权或不可用时，先进入授权中心处理授权；在线授权状态异常时，再检查授权服务是否可达。

在线授权检查项

确认授权服务地址、账号状态和网络连通。服务端吊销后，插件会失效并关闭相关窗口。

离线授权检查项

离线证书必须匹配当前机器和当前用户环境。证书不匹配时，重新导出离线请求，再签发新证书。

Case 3

确认导出方式，再检查页面对象、模板实例、图片资源和共享资源是否已重新导出。

确认整包导出或当前页导出

整包导出适合正式发布或大改；当前页导出适合局部替换。共享结构、全局脚本或整体资源改动后，使用整包导出。

图片和页面不一致

确认本次改动属于页面对象、模板实例还是图片资源。对象改动可重导当前页；共享资源或结构改动使用整包导出。

发布前复核

正式替换前做一次整包导出，再做一次当前页导出。两种导出都通过后，再替换服务器文件。

Case 4

确认脚本所在位置，再检查当前输入框支持完整 JS、同步表达式还是纯 JSON。

确认当前脚本位置

页面脚本、全局脚本、点击脚本、悬停脚本可以填写完整 JS；动画表达式、颜色表达式、条件表达式仅支持同步可求值表达式，不应写入整段异步逻辑。

fetch 可用位置

fetch 放在页面脚本、全局脚本、点击脚本、悬停脚本里；Move、Rotate、Scale、Script Color、Condition 只填写同步表达式。

保存时报错

确认当前编辑框是否为 JSON 文档，再检查回调参数和变量名作用域。JSON 位置只能填写合法 JSON。

稳定写法

初始化逻辑优先放在 qteditPageReady 或 qteditGlobalReady；需要复用的函数放在全局脚本；按钮动作优先使用内置行为，超出内置能力时再使用脚本扩展。