批量整理与导出：把页面成果安全地带出 PowerPoint

1 个 PPT 对应 1 个画面包

当前交付单位是 1 PPT = 1 screen package。一个 PPT 项目导出后应作为一个完整画面包交给 HQControl 管理。包内通常包含页面 HTML、页面 SVG、页级脚本、页级 JSON、公共样式、图片资源、运行清单和导出清单。不要把画面包拆成零散文件长期维护。

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

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

整包导出适合阶段性发布、正式交付和完整归档；当前页导出适合局部预览、单页迭代和快速替换。公共脚本、公共配置、共享样式、页面新增、页面删除、页面重命名或导航结构变化时，应使用整包导出。常见误区是：仅修改单页却反复整包导出，或正式交付时只导出单页。

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

提前确定导出位置

输出目录不仅决定文件保存位置，还会影响版本管理、交付传递和资源替换效率。建议项目初期就约定统一的导出目录结构，避免每次导出时重新选择位置，从而降低后期查找历史版本的成本。

• 统一约定导出目录和版本规则
• 区分预览导出和正式导出目录
• 交付目录尽量保持可追溯

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。

• 只改几个对象：先选中对象再打开窗口。
• 改当前页：不要跨页选择对象，确认 Scope 显示 Current page。
• 改颜色：使用 Find 或 Replace with 旁的颜色选择器，并启用 Colors 类别。
• 预览出现不该改的字段：取消对应类别并重新 Apply filter。
• Replace 后回到 PowerPoint 抽查文本、Tag、脚本、链接和颜色。
• 替换范围不对时先撤销 PowerPoint 修改，再缩小 Scope 重新执行。

Export History 只记录路径，不承担版本管理

Export History 用于记录最近导出的目录，便于快速回到常用路径。它不是版本管理器，也不会判断目录属于正式版还是预览版，清理历史记录也不会删除真实导出文件。版本规划仍应通过明确的目录规则管理。