总览: HQ VISU Designer 是什么：产品定位与整体流程
HQ VISU Designer 是装在 PowerPoint 里的画面制作与导出工具。工程人员可照常使用 PowerPoint 绘制页面，再给图形绑定数据和行为，最后导出成一个画面包，交给 HQControl 运行。本节说明产品定位、适用角色、产品价值，以及从画图到上线的完整流程。
产品定位与价值
HQ VISU Designer（即 HQ VISU PowerPoint）是运行在 Microsoft PowerPoint 中的可视化画面制作与导出工具。它的目标不是制作普通演示文稿，而是将 PowerPoint 页面整理为可运行的 HQ VISU 画面包。安装后，PowerPoint 功能区会出现 HQ VISU 标签页。产品由四部分组成：PowerPoint 插件（提供编辑入口）、行为浏览器（可视化配置组件、行为、脚本、属性）、模板与页面编辑器（配置输入框、按键、表格等模板）、导出器（将 PPT 导出为 HTML + SVG + JS + JSON + IMG 画面包）。
它面向最终使用人员、现场实施、配置调试和验收培训人员。价值在于：在熟悉的 PowerPoint 环境中绘制工业画面，通过拖拽和字段配置让图形连接 PLC 标签与交互逻辑，而不需要重新开发完整前端；同一设备画面可保存为模板并重复复用。
在整条产品线中，它负责“画面设计与画面资产交付”这一段：HQ VISU Designer 负责画面、模板、交互和导出打包；HQ Scan 负责绑定前的 IO/Tag/点位数据整理；HQControl 负责画面运行、导航、权限、授权和部署。
使用方法：四步流程与编辑器里填什么
整体流程是四步，对应 HQ VISU 标签页里的几个分组：
1）在 PowerPoint 里画页面，并用 Page Settings 确定导出尺寸（如 16:9 Wide 960x540、Full HD 1920x1080）。
2）打开 Behavior Browser，从右侧行为目录把行为拖到左侧组件节点上完成绑定，再双击该行为打开编辑器填字段；必要时在 Page Script / Global Script 补脚本。
3）用 Export HTML 把整个 PPT 导成一个画面包。
4）把画面包交给 HQControl 运行。
行为编辑器中实际填写的字段（不同行为取其所需）：
- Definition：准备区，读标签、定义变量、做中间计算（如 var running = ReadTagInteger(...)）
- Condition / Value / Text：返回行为真正使用的结果（条件、写入值、显示文本）
- Fill / Border / Visibility：填充色、边框色、显示隐藏（Script Color 等视觉行为）
- Tag Expression / Default / Invert / BitNr / Action：直接读写标签或某一位（Write Tag、Write Tag Bit）
- Variable / Value：点击时写运行时变量（Set Variable on Click，变量名不要加引号）
- 目标对象：keypad 需选当前页的目标输入模板；Open Diagnosis 填 PLC / ID / DiagnosisControl / GroupRightIndex
// Definition（准备）
var running = ReadTagInteger("PLC1.PUMP.RUN", 0);
var alarm = ReadTagBoolean("PLC1.PUMP.ALARM", false);
// Condition（输出，State Color 等用它判断真/假态）
running === 1 && !alarm
适用场景
当项目需要制作可在 HQControl 中运行、并随 PLC 数据变化的工业监控画面时，可使用 HQ VISU Designer。典型场景包括：
- 做设备运行画面：画好泵/阀图形，绑 State Color 或 Blink Color，在 Definition 里读运行/报警标签，导出后到 HQControl 上看实时状态。
- 做带输入和按键的操作区：插入 input 模板绑运行时变量或 PLC 标签，再加 keypad 模板指定目标输入框，让现场能直接写值。
上手前要知道的几条边界
以下是常见配置误区，提前确认可减少返工：
- 绑定行为只能“拖拽到左侧组件节点”，双击右侧行为目录不会绑定，只会提示 Drag a behavior onto a component node to bind it.
- 发布单位是“1 个 PPT = 1 个画面包”；改了全局脚本、全局 JSON、共享样式或导航结构时必须整包重导，Current Page 只适合纯页级改动。
- 写标签是否成功由宿主机（HQControl）决定，可能有权限校验、确认框、原因输入或异步写入，不要假设“点了就一定成功”。
- 跨画面包跳转用 screen-code（qtedit.openScreen(...)），同包跳转用 qtedit.openPage(...)；不要用 ../../xxx.html 这种相对磁盘路径做正式跳转。
