文档手册

导出与发布：画面包内容、整包导出与当前页

导出与发布是将 PPT 页面转换为可在宿主机运行的“画面包”的最后一步。功能区 HQ VISU 标签页里的 Export 分组有三个按钮：Export HTML（将整个 PPT 导出成一个画面包）、Current Page（只导出当前页，用于页级小更新）、Export History（管理当前电脑上最近使用过的导出目录）。导出物是一个自包含文件夹，包含页面 HTML、每页的 SVG 图形、JS（页面数据与脚本）、JSON（全局与页级配置数据）和 IMG 图片。官方规则是“1 个 PPT = 1 个画面包”：一个业务画面就是一个 PPT，可以包含一个主页面和若干同包子页面。导出后将该文件夹上传到 HQControl，由宿主机按画面编码（screenCode）管理和运行。宿主机和开发机通常不是同一台机器；发布对象是画面包，不是开发机上的本地 PPT 路径。

功能

功能: 导出与发布：画面包内容、整包导出与当前页

把完成配置的 PPT 导出成一个 HQ VISU 画面包（HTML + SVG + JS + JSON + IMG），再上传到 HQControl 宿主机运行。一个 PPT 对应一个画面包，正式交付时应按包整体替换。

功能说明

使用方法：三个按钮和导出包内容

在 Export 分组里按需选择导出方式，导出目录可从历史里挑或新建。导出后得到的画面包典型结构如下（HTML 留在包根目录，生成的样式和脚本集中到 css/ 和 js/）：

Export HTML：整包导出。改了全局脚本、全局 JSON、共享样式，或者新增/删除/重命名了页面、改了导航结构，都必须用它整包导出。
Current Page：只导当前页资源。只适合「当前页图形 / 当前页脚本 / 当前页 JSON / 当前页组件行为」这类页级变化。
Export History：查看最近导出目录、删除选中目录、清空所有历史。它只清理本机记录，不会删除磁盘上真实的导出文件。
包内容：<page>.html（页面，首页文件名跟随该页在 PPT 里配置的导出文件名）、<page>.svg（每页图形）、css/app.css（共享样式）、js/<page>.js（页面数据与脚本）、json/global.json 与 json/pages/<page>.json（配置数据）、img/（图片）。

<screen-package>/
  <page>.html
  <page>.svg
  css/
    app.css
  js/
    <page>.js
  json/
    global.json
    pages/
      <page>.json
  img/
    ...

适用场景

按改动范围选导出方式，再上传到 HQControl：

只改了一个画面里某一页的图形/脚本/数据：打开那个 PPT，用 Current Page 导出，做页级替换。
改了全局脚本、全局 JSON、共享样式，或加页/删页/改页名/改导航：用 Export HTML 整包导出（只导当前页这些变化带不上）。
正式发布：整包导出 → 上传到宿主机 → 让宿主机按包整体替换，必要时保留一份 backup；宿主机按 screenCode 管理，不要长期把不同日期的零散文件混在一个目录里。

边界与常见误区

常见误区：

导出前 PPT 有未保存改动会弹提示，建议先选「Save and Export」（保存并导出）；选「Export Without Saving」（不保存直接导出）生成的文件可能跟最新编辑对不上。
页面新增、删除、重命名属于整包级变化，不能用 Current Page，必须整包导出，否则宿主机里会残留旧页、链接打开已删除的页。
Export History 里删除/清空只是清本机历史记录，不会删除真实导出文件夹。
正式交付的跨页跳转用 qtedit.openPage / 跨包用 qtedit.openScreen，不要用 ../../xxx.html 这种相对磁盘路径，宿主机包路径会变，相对路径会失效。

HQ VISU Designer 导出 HTML 目录选择 — **图示 1: 导出 HTML**
选择导出目录或从最近位置里挑，把整个 PPT 导出成一个画面包。