蝉标AI排版引擎技术解析
蝉标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 | 混合 | 改普 | 改精 |
|---|---|---|---|---|---|
| 排版入口 | 排版页 | Modal | Modal/排版页 | 排版页 | 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
更多推荐



所有评论(0)