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

正式导出前按这个顺序做

先保存所有页面和模板，再执行一次 Batch Replace 整理，然后决定本次使用单页导出还是整包导出，随后确认输出目录，最后在导出后检查首页、弹窗页和交互页。该顺序适合交付前收尾。

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

导出前先做批量整理

项目持续迭代后，页面中可能出现命名不统一、局部文本未更新、部分字段保留阶段性占位值的情况。批量替换适合在导出前做统一整理，避免将项目残留内容带入正式交付包。

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

典型画面包结构

画面包结构用于保证页面、脚本、样式、JSON 和图片资源能被运行端一致加载。手工复制文件时，不能只看 HTML 是否存在，还要确认同名 SVG、页级 JS、json/pages、图片资源和清单文件是否同步。

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

导出前最后检查什么

至少检查四件事：页面范围是否正确、关键页面是否已经保存、资源和模板是否已更新、当前导出目标是预览包还是正式发布包。持续执行该检查可以降低交付风险。

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

Batch Replace 真正能替换哪些内容

Batch Replace 不只修改普通文本。它会按当前范围扫描可替换项，并在窗口中列出类型、对象、替换字段、当前文本和替换后预览。常见可替换内容包括普通显示文本、Language Key、Default Text，以及模板实例中的 Template Variable。因此，它既可以统一页面显示文本，也可以批量整理模板实例中的 <NAME> 对应值。

• 会先显示 Scope 和 Detected Variables
• 表格里会显示 Type / Object / Replace In / Current Text / After Replace
• 模板变量会以 <变量名> 的形式单独列出来

模板变量和普通文本替换要分清

需要修改模板实例中的动态变量时，窗口通常会将其列为 Template Variable，字段名类似 <PLC>、<RUN_TAG>。如果修改普通文本、多语言键或默认文案，类型和字段会不同。该区分决定本次操作是在修改模板实例参数，还是在修改页面显示文案。