所属产品: Mingcedar Studio DESIGNER

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

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

首次发布 2026-10-25T12:48:42.574643224Z 最近更新 2026-10-25T12:48:42.574642241Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="delivery">导出: 批量整理、画面包导出与交付</h2>

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

<h3 id="delivery-item-1">正式导出前按这个顺序做</h3>

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

<ul>

<li>先保存页面和模板</li>

<li>再做 Batch Replace</li>

<li>再选单页或整包</li>

<li>导出后检查关键页面</li>

</ul>

</article>

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

<ul>

<li>同包页面跳转使用 <code>hqVisuDesigner.openPage(...)</code>。</li>

<li>跨包跳转使用 <code>hqVisuDesigner.openScreen(screenCode)</code>。</li>

<li>包内资源应保持目录结构完整。</li>

<li>正式交付和版本归档优先整包导出。</li>

</ul>

</article>

<h3 id="delivery-item-3">导出前先做批量整理</h3>

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

<ul>

<li>先统一命名和文本</li>

<li>再清理阶段性占位内容和值</li>

<li>导出前完成批量整理，可减少导出后的补救成本</li>

</ul>

</article>

<h3 id="delivery-item-4">整包导出和当前页导出选择规则</h3>

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

<ul>

<li>正式交付优先整包导出</li>

<li>局部更新优先当前页导出</li>

<li>导出前先确认本次目标是预览还是发布</li>

<li>改动越过当前页边界时，不使用当前页导出</li>

</ul>

</article>

<h3 id="delivery-item-5">典型画面包结构</h3>

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

<span class="line"><span> hq-pagemap.js</span></span>

<span class="line"><span> screen.manifest.json</span></span>

<span class="line"><span> hqVisuDesigner-export-report.json</span></span></code></pre></div>

</article>

<h3 id="delivery-item-6">提前确定导出位置</h3>

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

<ul>

<li>统一约定导出目录和版本规则</li>

<li>区分预览导出和正式导出目录</li>

<li>交付目录尽量保持可追溯</li>

</ul>

</article>

<h3 id="delivery-item-7">导出前最后检查什么</h3>

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

<ul>

<li>确认导出范围</li>

<li>确认页面和模板最新状态已保存</li>

<li>确认输出目录正确</li>

<li>确认是当前页导出还是整包导出</li>

</ul>

</article>

<h3 id="delivery-item-8">Batch Replace 真正能替换哪些内容</h3>

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

<ul>

<li>Scope：Selected content 表示当前选区，Current page 表示当前页。</li>

<li>Variables：显示当前范围检测到的模板变量。</li>

<li>Categories：勾选允许修改的类别，点击 Apply filter 刷新预览；Cancel filter 放弃待应用筛选。</li>

<li>预览列：Type、Object、Replace in、Current value、Replacement preview。</li>

<li>Find：输入要查找的精确文本；F3 或 Find next 跳到下一条命中。</li>

<li>Replace with：输入替换值；留空表示移除精确命中内容。</li>

</ul>

</article>

<h3 id="delivery-item-9">Batch Replace 从筛选到替换的完整步骤</h3>

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

<ul>

<li>只改几个对象：先选中对象再打开窗口。</li>

<li>改当前页：不要跨页选择对象，确认 Scope 显示 Current page。</li>

<li>改颜色：使用 Find 或 Replace with 旁的颜色选择器，并启用 Colors 类别。</li>

<li>预览出现不该改的字段：取消对应类别并重新 Apply filter。</li>

<li>Replace 后回到 PowerPoint 抽查文本、Tag、脚本、链接和颜色。</li>

<li>替换范围不对时先撤销 PowerPoint 修改，再缩小 Scope 重新执行。</li>

</ul>

</article>

<h3 id="delivery-item-10">模板变量与显示文本替换</h3>

<p>Template Variable 表示实例参数，如 <PLC>、<RUN_TAG>；普通文本、多语言键和默认文案属于显示配置。替换前核对类型与字段。</p>

</article>

<h3 id="delivery-item-11">Export History 只记录路径，不承担版本管理</h3>

<p>Export History 只记录最近目录，不保存版本或区分预览与正式发布；清理记录不会删除文件。使用明确的版本目录管理交付。</p>

</article>

</div>

<p>先核对 Scope、Categories 和预览表；图中当前页列出了可搜索项，文档在点击 Replace 前不会更改。</p>

</figcaption>

</figure>

<p>当页面、模板、脚本和绑定都确认无误后，再执行正式导出更可靠。</p>

</figcaption>

</figure>

<strong>图示 3: 当前页导出</strong>

<p>适合单页迭代和局部替换，不必每次都整包导出。</p>

</figcaption>

</figure>

<p>统一的导出目录规划，会直接影响交付效率和后续版本管理。</p>

</figcaption>

</figure>

<p>窗口会显示导出状态、进度条和执行日志；出错时先保留导出目录和当前 PPT，便于排查。</p>

</figcaption>

</figure>

</div>