ComPDF AI 更新说明

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 请求头。