Skip to content

PDF 生成模板编辑器

开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。

查看 GitHub

ComPDF AI 更新说明 ​

v2.6.3(2026-10-23) ​

版本概览 ​

  • 新增租户切换、部门组织树、自定义角色和数据权限,完善企业团队协作与数据隔离。
  • 新增抽取置信度、风险等级和自动确认能力,提升结果核对效率。
  • 扩展模板多样本管理与分类画像,支持更灵活的模板配置和自动分类。
  • 新增 WorkFlow 回收站,完善文件恢复、永久删除和过期清理。
  • 完善私有化部署初始化、许可证管理、资源配额和操作审计。

租户、组织与权限 ​

  • 多租户部署支持同一账号关联多个租户,并在已关联的租户间切换;切换后按当前租户加载角色、权限和业务数据。
  • 新增部门组织树,支持部门创建、编辑、移动、删除及成员归属管理。
  • 支持成员新增、关联、编辑、启停、移除和 CSV 批量导入;导入支持预检及逐行结果反馈。
  • 新增自定义角色管理,支持角色创建、编辑、复制、启停和删除,以及成员多角色配置。
  • 支持按功能授权,并提供本人、当前部门及下级、指定部门及下级、全部数据等访问范围。
  • 统一列表、详情、下载、导出和修改操作的数据范围校验;成员、角色及部门变更后及时刷新权限。
  • 完善临时密码、首次登录改密和密码重置流程,重置密码后使原登录凭据失效。

WorkFlow 抽取与结果核对 ​

  • 为 VisualExtract 和 LayoutExtract 增加文件级及字段级置信度,并提供风险等级、评分状态和扣分原因。
  • 支持表格单元格评分,以及多页抽取结果的评分与字段定位。
  • 新增自动确认机制,综合评分完整性、置信度、风险及字段校验结果决定是否自动确认。
  • 支持结果编辑及人工确认后的重新评分;评分失败不会撤销已完成的人工确认。
  • 完善两种抽取模式的解析结果归档、查询和下载,并支持解析结果编辑。
  • 增加统一结果格式,规范多页字段、表格单元格及位置关联,同时保留既有结果格式兼容。

模板、样本与自动分类 ​

  • 每个模板支持最多 5 个样本文件,支持样本列表、上传、删除和替换。
  • 新增模板分类画像及版本管理;样本或分类配置变更后重建画像,支持失败重试。
  • 分类画像按租户、用户、模板及版本隔离,避免共享模板使用过程中的分类数据混用。
  • 模板测试和 AI 辅助配置支持指定本次使用的样本;未指定时保留原有取样规则。
  • 完善模板详情中的样本信息,以及样本缺失、删除和历史单样本数据的兼容处理。
  • 优化模板字段、输出配置与导出名称的关联,避免字段改名后出现重复列或新列空值。

文件管理与回收站 ​

  • 新增 WorkFlow 文件回收站,支持查询、筛选、恢复和永久删除。
  • 支持批量恢复、批量永久删除及大批量异步清空,并提供任务状态查询。
  • 支持按保留期限自动清理回收站文件。
  • 永久删除时处理关联结果、评分归档及存储对象;清理失败支持重试。
  • 回收站操作沿用租户与数据权限控制,避免恢复或删除其他租户的文件。

Open API 与结果导出 ​

  • 扩展模板样本、分类配置、解析结果编辑及相关任务接口,完善 Service API Key 场景下的权限校验。
  • 保持现有 /api/v2 路径及默认 v2 解析结果兼容;通过 Accept-Version: v3 显式获取精简后的解析结果。
  • 支持通过 result_format=unified 获取统一抽取结果格式,旧客户端可继续使用原有格式。
  • 新增自定义 JSON 导出配置,支持不同版本和目标系统的输出结构,并支持设置默认配置。
  • 完善 CSV、Excel 和 JSON 的逐文件及汇总导出,兼容历史模板和表格结果。
  • 抽取结果导出保留业务数据与既有格式,不附带置信度分数、风险、扣分原因等评分元数据;系统内部评分继续保留。

资源、通知与操作日志 ​

  • 完善租户资源摘要,统一展示已用额度、额度上限、剩余额度和有效期,并区分有限、无限及未配置状态。
  • 完善抽取任务的额度预占、成功结算和失败释放,降低并发处理及重复请求导致的用量异常。
  • 调整资产到期处理:保留登录、租户切换和历史数据管理能力,在需要消耗资产的业务操作前校验有效期及额度。
  • 提醒规则增加置信度相关条件,并完善资产额度、到期及订阅通知。
  • 统一 Python 平台与 Java WorkFlow 操作日志的查询、筛选和 CSV 导出。
  • 补充登录时间、来源 IP、租户和部门上下文,并提供标准化操作类型与详情编码,便于多语言接入。
  • 完善日志脱敏、CSV 编码和时间表示,提升审计数据的可读性与兼容性。

私有化部署与许可证 ​

  • 完善首次安装时的租户、管理员、权限及默认模板初始化,并支持安装中断后的继续执行。
  • 新增离线签名许可证校验,支持授权模块、有效期和成员人数限制。
  • 提供许可证状态查询及续期能力,并加强签名校验、时钟回拨检测和异常授权拦截。
  • 完善外部模型服务配置与连通方式,支持复用已有解析、抽取和向量模型服务。
  • 补充部署前检查、备份、升级和回退工具,以及相应配置与操作文档。

问题修复与兼容性优化 ​

  • 修复历史表格结果在统一结果中显示为空的问题。
  • 修复旧模板汇总导出失败、导出分组同名覆盖及字段映射不一致等问题。
  • 改善表格评分对象被直接写入导出文件,导致业务值和列结构异常的问题。
  • 完善样本切换、模板测试、分类画像更新和历史结果读取的兼容处理。
  • 修复部分账号在租户切换、角色变更及成员状态调整后权限或资源信息不一致的问题。
  • 改善邮件发送、操作日志查询及向量模型地址配置的异常处理。

升级注意事项 ​

  • 升级前备份数据库、对象存储、索引及部署配置;已有环境应执行适用的升级迁移,不得使用全新安装脚本覆盖现有数据。
  • 本版本涉及租户、成员、角色、数据权限、模板样本和回收站等数据结构,请按发布包说明协调升级相关服务。
  • 历史文件归属迁移需要明确的数据映射和审核,不应按当前登录租户自动推断归属。
  • 保留现有登录密钥、服务间认证配置和许可证文件;仅引入本版本要求的新配置,避免覆盖既有凭据。
  • 外部模型地址应从实际运行服务所在的网络环境验证;模型部署在其他服务器或容器时,不应直接使用 localhost 指向它。
  • 使用 Parser v3 或统一抽取结果格式前,应按对应接口文档确认客户端适配;未启用时继续沿用既有返回格式。
  • 回收站仅覆盖 WorkFlow 文件,不包含知识库文档;永久删除及到期清理后无法通过回收站恢复。

v2.6.2(2026-08-20) ​

版本概览 ​

  • 新增 WorkFlow 智能文档抽取工作台,覆盖模板驱动抽取、任务管理、结果核对与导出。
  • 新增 Service API Key、Webhook 和 v2 Open API,支持第三方系统安全集成。
  • 新增消息中心与提醒规则,支持站内信、邮件和 Webhook 通知。
  • 新增抽取字段的输出转换与校验能力,并完善组织权限、资产订阅和操作审计。

WorkFlow 智能文档抽取 ​

  • 支持两种处理模式:
    • LayoutExtract:先进行版面解析,再完成字段抽取;可追踪版面和抽取结果。
    • VisualExtract:面向常规、单页及手写文档的直接视觉抽取。
  • 支持批量上传、异步处理、任务与文件状态管理、重试、取消、重新抽取及分类调整。
  • 支持文件历史、文件详情、源文件预览、抽取结果编辑、确认及撤销确认。
  • 新增结果工作台:搜索筛选、可配置列、异常标记和结构化结果导出。
  • 完善抽取任务全生命周期处理:统一结果格式、重试行为、处理状态、核对状态及历史结果兼容。

模板与输出配置 ​

  • 支持组织模板与默认模板视图、模板状态管理、排序、分组关联和个人草稿续编。
  • 支持模板样本上传、AI 辅助模板配置、视觉/一体化抽取测试及测试文件下载。
  • 新增文本、数字、日期、枚举字段的输出配置:
    • 格式化、标准化、替换、正则提取、数字单位、日期与枚举转换;
    • 导出字段名配置及重名校验;
    • 必填、格式和比较校验;
    • 结果中展示字段级异常标记。
  • 完善模板删除保护:权限校验、默认模板保护,以及已关联文件的明确处理。

Open API 与系统集成 ​

  • 按 PRD 对齐 WorkFlow v2 Open API,覆盖文件、模板、批次、任务、抽取结果和资产能力。
  • 支持通过 X-API-Key、Api-Key 或 Authorization: Bearer {key} 使用 Service API Key 鉴权。
  • Open API 按 API Key 派生组织身份,实现组织数据隔离;与浏览器登录态接口分离。
  • 支持上传、处理、结果查询及 Webhook 回调过程中的元数据透传。
  • 新增公开提醒规则 CRUD:/api/v2/rules,使用公共 DTO、ISO 8601 UTC 时间;创建返回 HTTP 201,删除返回 HTTP 204。
  • 统一错误响应,新增稳定的 error_code,同时保持既有 HTTP 状态和业务 code 兼容。

API Key 与 Webhook 管理 ​

  • 支持 API Key 的创建、列表、名称筛选、编辑、启停、删除、复制、过期、使用记录、加密存储和验证。
  • API Key 列表支持安全掩码预览,避免回显完整密钥。
  • 支持 Webhook 的创建、列表、编辑、启停、删除、签名密钥复制、加密存储、事件订阅、投递记录、重试及最近响应查询。
  • 支持批次和文件生命周期事件回调,以及 Java WorkFlow 与 Python 平台之间的内部 HMAC 事件认证。
  • 优化历史 Webhook 密钥无法解密时的处理,单条异常记录不会中断其他待投递任务。

提醒规则与消息中心 ​

  • 支持提醒规则创建、编辑、复制、启停、删除、定时检查和事件触发检查。
  • 支持模板字段条件、系统状态条件、AND/OR 逻辑和规则名称冲突校验。
  • 新增可用于条件匹配的系统字段:
    • review_status(核对状态):pending、confirmed;
    • processing_status(处理状态):解析、分类、抽取、失败、取消和完成等生命周期状态。
  • 对历史 WorkFlow 事件兼容推导状态:extract_complete 对应待核对/抽取完成,confirm_result 对应已核对/抽取完成。
  • file_name、template_name、detail_url 保留为通知内容变量和跳转信息,不再作为规则条件的系统字段展示。
  • 支持站内信、邮件和指定 Webhook 投递。邮件收件人支持组织成员、直接邮箱及抽取字段绑定;字段邮箱自动拆分、校验、去重,非法值会跳过且不会阻断其他渠道。
  • 新增邮件/Webhook 投递重试、投递诊断、触发记录、事件级幂等和规则级去重;规则成功更新后重置自身去重记录,删除规则时清理其去重记录。
  • 消息中心统一展示系统消息、系统公告和用户提醒规则;规则消息按规则名称形成目录统计。
  • 新增资产额度、套餐到期和订阅生效系统通知,并统一平台生成消息的英文内容。

组织、权限与知识库 ​

  • 管理员邀请普通成员时,成员继承已启用的业务权限;人员管理权限不自动继承。
  • 补充登录失败、重复用户等前端可识别错误码。
  • 提醒规则收件人支持选择组织成员;普通成员可只读选择组织内已有 Webhook。
  • 支持知识库成员配置场景下的组织成员查询,同时保留原知识库成员查询。
  • 修复旧知识库提示词缺少 {knowledge} 占位符时的运行时兼容问题。

资产、订阅与审计 ​

  • 支持订阅资产分配与资产账户状态同步。
  • 支持资产到期扫描、低额度提醒和套餐到期通知。
  • 改善过期历史资产账户的兼容性,并统一订阅到期时间展示。
  • 补充 API Key、Webhook、提醒规则、模板、文件、任务、结果及导出操作日志。
  • 新增 WorkFlow 审计日志的持久化与查询,使用事务提交后的独立写入并记录写入失败日志,不影响主业务事务。

文档与发布包 ​

  • 更新中文使用指南、Open API 参考、WorkFlow 接口参考、错误码说明和发布包文档。
  • 发布包补充 Docker Compose、服务配置、Nginx 配置、初始化 SQL 及 API 文档。
  • 对外 Open API 仅包含 PRD 规定的 23 个正式接口;测试和模板辅助接口不纳入公开 API 参考。

升级注意事项 ​

  • 启动服务前执行适用的初始化或迁移 SQL。
  • Java WorkFlow 与 Python 平台必须配置相同的 REMINDER_INTERNAL_EVENT_SECRET,用于内部提醒和 Webhook 事件回调认证。
  • 启用邮件通知前,在 Python 服务配置中完整配置 notification_email。
  • Gateway 应优先将 /api/v2/rules/** 转发至 Python 服务,再匹配通用的 Java /api/v2/** 路由,并透传 Service API Key 请求头。