蝉标AI排版引擎技术解析:从参数化配置到Word/PPT导出的工程实践 原创

本文基于蝉标AI前端仓库全量源码梳理,聚焦「排版导出」核心功能模块,从代码层面拆解其参数化配置体系、多产品线架构与异步任务管理。


1. 背景:标书排版的工程化痛点

在招投标行业中,一份技术标书的排版往往占据制作周期的 30% 以上时间。传统流程的痛点非常清晰:

  • 排版效率低:Word 排版涉及字体、字号、行间距、段前段后、页眉页脚、分页符等几十项参数,纯手工调整极其耗时
  • 格式不统一:不同人制作的标书排版风格参差,企业难以标准化输出
  • 暗标适配难:暗标格式要求分散在招标文件中,人工逐条核对容易遗漏
  • 多格式输出复杂:同一方案可能需要 Word 和 PPT 两种输出格式,排版参数体系不同

蝉标AI通过排版引擎模块系统性地解决了这些问题。本文从前端源码视角,拆解这个模块的技术设计。


2. 排版产品线总览:双线架构设计

蝉标AI的排版能力覆盖两条独立产品线,这是一个关键的架构决策:

产品线路由定位门禁
技术方案排版/edit/:id → /select-format/:id方案生成后导出 Word/PPT无独立门禁
我的排版(独立工具)/filesetting → /edit_format/:id → /format_format/:id独立上传 docx 排版导出需标准 VIP / 尊享 VIP / 有效年卡

两者共用 ExportWordButton 组件与相似的用户体验版限制逻辑,但不共享精品/混合 Modal、PPT 导出、hybridStream 等高级逻辑。这种设计既保证了代码复用,又避免了业务逻辑耦合。

核心文件分布:

edit.tsx               → 导出入口(编辑页菜单)
format.tsx             → 排版页第一步 + 第二步确认弹窗
ExportWordButton.tsx   → Word 导出按钮组件
ExportPptButton.tsx    → PPT 导出按钮组件
PptExportWordFormatModal.tsx → 精品/混合 Word 导出弹窗
ScenarioExportScopeModal.tsx → 导出范围选择弹窗
scenarioExportFormatLists.ts → 公共选项值全集
scenarioExportConfig.ts      → 导出配置管理

3. 排版配置体系:两步走的参数化设计

排版页(format.tsx)的配置分两步走,这是整个排版引擎的核心设计。

3.1 第一步:全局排版样式选择

// 排版配置参数结构(简化)
interface FormatStep1Config {
  paperStyle: 0 | 1 | 2;      // 0=A4, 1=A3竖版, 2=A3横版
  layoutStyle: 0 | 1 | 2 | 3 | 4 | 5;  // 0=无排版, 1-5=区域表格样式
  colorScheme: string;         // 黑/蓝/绿/灰/橙 或自定义色
  headerFooter: 0 | 1 | 2 | 3 | 4 | 5;  // 六套页眉页脚模板
}

这里有个关键设计决策——颜色系统支持自定义。当用户选择自定义颜色时,可分别配置四个维度的色彩:

interface CustomColor {
  borderColor: string;      // 线条边框颜色
  headerBgColor: string;    // 头部底纹颜色
  titleBgColor: string;     // 标题底纹颜色
  titleFontColor: string;   // 标题字体颜色
  customName?: string;      // 自定义配色名称(最大8字)
}

混合标的「普通排版」路径有特殊约束:纸张跟随方案 A3/A4 锁定不可切换。

3.2 第二步:精细化格式配置

这一步的配置项极其丰富,覆盖了 Word 排版的几乎所有维度:

配置区块核心参数
页面格式上/下边距 0–10cm,左/右边距 0–5cm(默认上下 2.54,左右 3.18)
分页符全部不分页 / 一级 / 二级 / 三级(默认一级)
标题保留全部保留 / 一至六级 + 「后续标题与正文一致」开关
标题格式自动编号 / 非自动编号 + 5 套样式
各级标题(一至九级)字体、字号、对齐、加粗、标题样式、颜色、行间距、首行缩进、段前、段后
正文序号延续标题序号 / 保留原有序号 / 删除全部序号 / 重新设置序号
正文格式字体、字号、对齐、行间距、首行缩进、段前、段后
排版表格外框粗细 / 里框粗细
内嵌表格字体字号、列宽、边框、表头样式

3.3 公共选项值全集

scenarioExportFormatLists.ts 中定义了所有可选值,这套参数体系已经覆盖了绝大部分招投标行业的排版需求:

类别选项值
字体宋体 / 仿宋 / 微软雅黑 / 黑体
字号初号、小初、一号、小一、二号、小二、三号、小三、四号、小四、五号、小五
行间距单倍 / 1.32倍 / 1.5倍 / 两倍 / 固定值(固定值单位:磅/英寸/厘米/毫米)
段前段后单位磅 / 英寸 / 厘米 / 毫米 / 行
对齐左侧对齐 / 居中对齐 / 两端对齐
表格对齐中部两端对齐 / 水平居中 / 中部右对齐
正文序号格式一、二、三、;1. 2. 3.;(一)(二)(三);(1)(2)(3);1)2)3);①②③;a.b.c.;Ⅰ.Ⅱ.Ⅲ.;1、2、3、 等
标题样式第一章、/第一节、/第一条;多级 1.1.~1.1.1.1.1.1.1.1.1.1. 及顿号版等
表格列宽平均分配 / 根据内容自由调整
表格边框粗细无;0.25/0.5/0.75/1/1.5/2.25/3/4.5/6 磅

3.4 默认序号逻辑

系统根据排版状态智能设置默认序号规则:

// 默认序号逻辑
function getDefaultSerialNumber(layoutStyle): SerialNumberMode {
  if (layoutStyle === 0) {
    return '保留原有序号';  // 无排版时保留原文序号
  } else {
    return '删除全部序号';  // 有排版时删除原文序号,使用新编号
  }
}

以标改标场景有额外规则:改精默认「删除全部序号」;改普无排版默认「延续标题序号」,有排版默认「删除全部序号」。


4. 精品/混合标的差异化排版架构

普通技术标走 /select-format 完整排版页,而精品 PPT 和混合标走的是 PptExportWordFormatModal 弹窗模式。这是一个重要的架构分支:

// 精品/混合 Word 导出走 Modal 而非独立页面
// PptExportWordFormatModal 配置结构
interface PremiumExportConfig {
  pageMargin: 'common' | 'recommended' | 'wider' | 'binding';
  // A4 常用左右 3.18cm;推荐左右 1cm;稍宽 1.91cm;装订左 3.18/右 1

  titleFormat: {
    autoNumber: boolean;
    styleIndex: 0 | 1 | 2 | 3 | 4;  // 5套样式
    levels: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
    // 精品配1-5级,混合加6-9级
    perLevel: TitleLevelConfig;
  };

  titleColorMode: 'auto' | 'custom';  // 仅混合标支持
  // 自动时色板不可编辑

  // 仅混合额外配置:
  bodyFormat?: BodyFormatConfig;      // 正文格式
  bodySerial?: SerialNumberConfig;    // 正文序号
  embeddedTable?: TableConfig;        // 内嵌表格
}

4.1 混合标的独特能力:导出全部为普通排版

混合标有一个独特路径——脱离 PPT 走纯文字排版:

// 混合标可以脱离 PPT 走纯文字排版
// 路由: /select-format/{id}?hybridStream=1
// 纸张随方案 A3/A4 锁定不可切换
// 接口带 hybridStream: true

这个设计让混合标用户拥有了"降级导出"的能力——当不需要 PPT 级别的排版时,可以将全部内容按纯文字 Word 排版输出,大大提高了灵活性。

4.2 PPT 导出与页码管理

PPT 导出的页码询问逻辑体现了精细的场景区分:

场景页码行为说明
纯精品 PPT默认要页码,不弹窗精品独立按钮导出
混合/改精弹窗询问「需要页码」/「不需要页码」
弹窗提示—「仅影响本次导出结果,不会修改方案中已保存的 PPT 内容」

5. 暗标格式:AI 智能提取的差分填充

暗标场景下,排版配置有一个特殊的 AI 增强能力。当用户选择「无排版」样式时,系统会展示「暗标格式」+「AI 一键提取」入口:

用户粘贴招标文件中的暗标格式要求
        ↓
调用 AI 智能识别(通义千问API)
  弹窗:「AI 识别暗标格式」
  说明:「把招标文件里的暗标格式要求粘贴到下方」
  按钮:「开始识别」
  识别中:「AI 正在识别暗标格式」「请不要刷新或关闭页面,识别完成后会自动填入」
        ↓
识别结果以差分 patch 填入配置表单
  提醒:「AI 识别结果,请仔细核对!」
        ↓
用户核对后确认导出

关键设计:识别结果不是直接覆盖,而是以 diff patch 方式填入,用户可以逐项核对 AI 修改了哪些参数。默认携带「标题最多保留三级」+「延续标题序号」的基线配置,AI 可以覆盖这些默认值。

暗标 AI 提取的展示条件也有严格限制:

// 暗标格式展示条件
function shouldShowDarkBidAI(config): boolean {
  return (
    config.layoutStyle === 0 &&      // 排版样式=无排版
    !config.isMixed &&                // 非混合
    !config.isRewriteOrdinaryStream   // 非改精 ordinary-stream
  );
}

6. 导出范围与起始编号

6.1 导出范围弹窗(ScenarioExportScopeModal)

interface ExportScopeConfig {
  scope: 'all' | 'chapter';         // 全部章节 / 单个章节
  chapterId?: string;               // 选单章时的章节ID
  startNumber: number;              // 起始编号 1-999
}

起始编号是一个巧妙的 design——例如设为 2 时,一级标题「第一章」从「第二章」开始编号。这对于拼接多份方案的场景非常实用。

提示文案:「如果页数超过5000页,强烈建议分章节导出以减少等待时间和文件大小」。

6.2 各方案类型的导出入口差异

方案类型导出菜单说明
普通/改普「导出全部」「导出本章节」非叶子 disabled
精品 PPT独立「导出 PPT」+ Word「导出全部」Word 走 premium Modal
混合/改精「导出全部」「导出全部为普通排版」「导出全部PPT章节」+ 叶子级选项最丰富

混合/改精没有独立「导出 PPT」按钮,PPT 能力收在 Word 菜单内。


7. 导出任务状态机:完整的异步管理

排版导出是异步任务,前端实现了完整的状态机:

状态文案说明
进行中(编辑页)「正在导出 Word…」用户可见进度
进行中(排版页)「正在导出Word…」排版页独立文案
标题编号重置「正在重置标题编号…」标题编号变更时
PPT 进行中「正在导出 PPT…」PPT 独立进度
并行导出「已在后台启动 Word 导出(与当前 PPT 导出并行),完成后将提示」PPT 进行中再导 Word
并行完成「Word 导出已完成,正在下载」并行任务完成
Word 完成「方案生成成功」+「点击下载」生成下载链接
PPT 完成「PPT 生成成功」+「点击下载」PPT 下载链接
恢复进度「检测到进行中的 Word 导出,已恢复进度」页面刷新后恢复
失败兜底「导出任务已失效或失败,请重新操作」兜底提示
信息缺失「方案信息缺失,无法导出」数据异常
编号缺失「未获取到导出任务编号」任务创建失败
地址缺失「未获取到 Word/PPT 下载地址」下载地址获取失败

7.1 并行导出设计

并行导出是这个状态机中最精妙的设计——当 PPT 正在导出时,用户仍可以发起 Word 导出,两者并行执行:

// 并行导出的触发条件
function canParallelExport(scenario): boolean {
  return scenario.pptExportInProgress && !scenario.wordExportInProgress;
  // PPT 进行中且 Word 未在进行中时可触发
}

完成后分别提示,避免了用户等待 PPT 导出完毕才能导 Word 的串行瓶颈。

7.2 离开保护

// 离开确认
const leaveConfirm = "正在导出Word文档,确定要离开当前页面吗?";

导出进行中如果用户尝试离开页面,会弹出确认框,防止任务中断导致文件损坏。

7.3 disabled 条件矩阵

条件表现
progress < 100「导出全部」等主项、精品 PPT 按钮 disabled
Word/PPT 异步进行中对应「导出全部」类项 disabled
重写/改写中、标题重置中相关项 disabled
全部项 disabled整颗「导出方案」按钮 disabled

8. 体验版限制与商业化设计

8.1 体验版前五章限制

// 体验版判定逻辑
function isExperienceVersion(payStatus, techBidType): boolean {
  return payStatus === '0' &&
         techBidType !== 'ppt' &&
         techBidType !== 'mixed';
  // 纯精品/混合不走此前五章限制
}

体验版用户进排版页前会看到「提醒」弹窗:

  • 方案名称、方案字数
  • 红色提示:「体验版导出只支持前五个章节」
  • 选项:「购买方案」/「只导出前5个章节」

8.2 VIP 权益矩阵

VIP 类型排版能力价格引导
体验版前 5 章导出引导购买方案或开通 VIP
标准 VIP无限普通技术标排版包月/包年可选
尊享 VIP无限精品 PPT 排版 + Word 排版包月/包年,「强烈推荐」

充值弹窗中明确标注:「尊享VIP生效期间不可购买标准VIP,到期后可购买」。


9. 类型差异全景:一套代码适配五种方案

蝉标AI的排版系统需要同时支持五种方案类型,这是通过条件分支 + 配置驱动实现的:

能力普通精品 PPT混合改普改精
排版入口排版页ModalModal/排版页排版页Modal/排版页
独立导出PPT否是否否否
暗标AI识别无排版时否否无排版时hybridStream 时否
标题颜色模式固定固定自动/自定义固定部分路径
PPT页码询问—否(默认有)是—是
体验版前五章是否否是是
列表Word+PPT双下载否是否否否

这种矩阵式的差异管理,体现了蝉标AI在工程化层面的成熟度——一套核心引擎,通过配置参数和条件分支适配多种业务场景,而非为每种类型重写一套逻辑。


10. 我的排版:独立产品线的技术分离

「我的排版」是一个独立于技术方案的产品线,面向已有 docx 文件的用户:

// 我的排版产品线路由
/filesetting        → 排版项目列表(新建/删除)
/fileupload         → 上传 docx + 目录确认
/edit_format/:id    → 排版正文编辑(改章节、生成图表、导出)
/format_format/:id  → 样式与导出(选纸张样式色后导出 Word)

门禁设计:BidToolAccessGate 组件统一拦截,需标准 VIP / 尊享 VIP / 有效年卡,拦截标题「标书工具为 VIP 专享」。

与技术方案排版的共享部分:ExportWordButton 组件、体验版文案逻辑。

不共享部分:精品/混合 Modal、PPT 导出、hybridStream 逻辑。这种分离避免了无关业务逻辑的耦合,同时复用了核心组件。


总结

蝉标AI的排版引擎,从工程视角来看有三个值得借鉴的设计思路:

第一,配置驱动而非硬编码。 排版参数全部参数化——从纸张到字号到边框粗细,从 12 档字号到 10 档边框粗细到 14 种正文序号格式,前端只做"开关"和参数传递,具体渲染由后端完成。这种分层让前端轻量、后端可控,新增排版样式只需扩展配置项而非改代码逻辑。

第二,双线架构 + Modal 分流。 技术方案排版走独立页面,精品/混合走弹窗,两条产品线共享核心组件但隔离业务逻辑。混合标的「导出全部为普通排版」降级路径,以及并行 Word/PPT 导出设计,都体现了对用户场景的深入理解。

第三,异步任务的完整状态管理。 导出任务的状态机覆盖了进行中、并行、恢复、失败等所有场景,离开保护和 disabled 矩阵保证了操作的可靠性。暗标格式的 AI 差分填充设计,让 AI 辅助与人工核对有机结合。

对于招投标行业来说,蝉标AI的排版引擎已经将排版效率提升到了一个新的水平——从几十项参数的手工调整,变成两步配置 + 一键导出。如果你也在做标书相关工作,不妨试试蝉标AI的排版导出功能——标准 VIP 即可解锁完整排版能力,尊享 VIP 更可使用精品 PPT 排版和无限配图额度。官网地址:蝉标AI


本文基于蝉标AI前端仓库源码分析,仅描述用户可感知功能及前端工程设计,后端实现细节不展开。


标签:蝉标AI、标书排版、Word导出、技术标排版、招投标AI、PPT排版、暗标格式、异步任务管理、前端工程、TypeScript

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐