从 Xporter 迁移

Exportelier 提供的是引导式迁移，而不是 Xporter 兼容性。它能识别有限的一组常见 Xporter 风格占位符形态，以便解释或建议安全的改写方式，但绝不会执行 Xporter 的函数、过滤器、JQL 或脚本。

选择目标模式

迁移目标	推荐模式
保留现有的品牌 `.docx`，包括原生页眉、页脚、页码、样式和节设置	Word Template Mode
维护一个可导出为 PDF、Markdown 和 DOCX 的布局	可视化设计器
保留脚本或任意表达式	无直接对应目标——请使用安全绑定和固定结构重新设计

Xporter 风格的意图	Exportelier 对应方式
标量占位符，例如 `${Key}` 或 `${Summary}`	规范路径，例如 `${issue.key}` 和 `${issue.summary}`
重复的问题集合	Word 模式中的 `${#each collection as item}…${/each}`，或专用的设计器组件
存在性检查	Word 模式中的 `${#if path}…${#else}…${/if}`
日期、数字、用户或时长的格式化	固定的具名 Word 格式化器
模板内部的 JQL	改为通过导出上下文选择问题
函数调用、JavaScript、Groovy、Velocity 或 FreeMarker	不执行——请使用安全 token 或预先计算的 Jira 字段改写
仅限 PDF 的布局或签名行为	设计器的 PDF 投影和 PDF 导出设置

扫描器的具体分类、可识别的别名以及不受支持的结构记录在 Xporter 语法：哪些可用中。规范语法和绑定说明位于 Word Template Mode 和 token 参考。

在模板编辑器的 Word 选项卡中上传 .docx。每次上传都会运行迁移扫描器，并生成一份兼容性报告，将每项发现归入以下四类之一：

可自动转换的发现会附带可复制的替换 token。该扫描器仅供参考：报告结果干净并不能替代包安全校验、绑定校验，或使用代表性数据进行的真实导出测试。