文档手册

批量整理、画面包导出与交付

导出前整理内容、确认范围与目录，发布后验证关键页面和交互。

导出

导出: 批量整理、画面包导出与交付

导出前整理内容、确认范围与目录，发布后验证关键页面和交互。

正式导出前按这个顺序做

保存页面和模板，按需批量整理，选择导出范围与目录，导出后检查首页、弹窗和交互页。

先保存页面和模板
再做 Batch Replace
再选单页或整包
导出后检查关键页面

1 个 PPT 对应 1 个画面包

1 PPT = 1 screen package。将 HTML、SVG、页级脚本与 JSON、公共样式、图片及清单作为完整画面包交付和维护。

同包页面跳转使用 hqVisuDesigner.openPage(...)。
跨包跳转使用 hqVisuDesigner.openScreen(screenCode)。
包内资源应保持目录结构完整。
正式交付和版本归档优先整包导出。

导出前先做批量整理

导出前用 Batch Replace 统一名称、术语和已确认的占位值，避免交付残留内容。

先统一命名和文本
再清理阶段性占位内容和值
导出前完成批量整理，可减少导出后的补救成本

整包导出和当前页导出选择规则

正式发布和归档使用整包导出。公共脚本、配置、样式、页面增删或重命名、导航结构变化均须整包导出；孤立的页级改动可用当前页导出。

正式交付优先整包导出
局部更新优先当前页导出
导出前先确认本次目标是预览还是发布
改动越过当前页边界时，不使用当前页导出

典型画面包结构

手工复制时须同步 HTML、对应 SVG、页级 JS、图片和清单，确保运行端完整加载。

<screen-package>/
  <page>.html
  <page>.svg
  js/
    hq-pagemap.js
    <page>.js
  img/
    ...
  screen.manifest.json
  hqVisuDesigner-export-report.json

提前确定导出位置

提前约定统一导出目录，以项目、版本和预览/发布用途区分，便于交付和回退。

导出前最后检查什么

核对页面范围、保存状态、资源与模板更新，以及导出目标是预览包还是正式发布包。

确认导出范围
确认页面和模板最新状态已保存
确认输出目录正确
确认是当前页导出还是整包导出

Batch Replace 真正能替换哪些内容

Batch Replace 按当前选区或当前页扫描六类内容：Bindings & tags、Animations & behaviors、Scripts、Targets & links、Page & shape text、Colors。窗口先生成只读预览，PowerPoint 文档只有在点击 Replace 后才会修改。查找是精确且区分大小写的，首尾空格会被忽略。

Scope：Selected content 表示当前选区，Current page 表示当前页。
Variables：显示当前范围检测到的模板变量。
Categories：勾选允许修改的类别，点击 Apply filter 刷新预览；Cancel filter 放弃待应用筛选。
预览列：Type、Object、Replace in、Current value、Replacement preview。
Find：输入要查找的精确文本；F3 或 Find next 跳到下一条命中。
Replace with：输入替换值；留空表示移除精确命中内容。

Batch Replace 从筛选到替换的完整步骤

先在 PowerPoint 选择目标对象；不选择对象时窗口使用当前页范围。打开 Batch Replace 后，先核对 Scope，再勾选需要修改的 Categories 并点击 Apply filter。输入 Find 和 Replace with，逐行检查 Replacement preview，必要时用 Find next 在 PowerPoint 中定位，确认无误后点击 Replace。