ComPDF AI Release Notes

v2.6.2 (2026-08-20)

Release Overview

• Added the WorkFlow intelligent document extraction workspace, including template-driven extraction, task management, result review, and export.
• Added Service API Key, Webhook, and v2 Open API capabilities for secure third-party integration.
• Added the message center and reminder rules with in-app, email, and Webhook notifications.
• Added output conversion and validation for extracted fields, and improved organization permissions, subscription assets, and operation auditing.

WorkFlow Intelligent Document Extraction

• Supports two processing modes:
  • LayoutExtract: performs layout parsing before field extraction, with traceability for layout and extraction results.
  • VisualExtract: performs direct visual extraction for standard, single-page, and handwritten documents.
• Supports batch upload, asynchronous processing, task and file status management, retry, cancellation, re-extraction, and classification adjustment.
• Supports file history, file details, source preview, extraction-result editing, confirmation, and confirmation revocation.
• Added a results workspace with search and filtering, configurable columns, exception markers, and structured result export.
• Improved extraction lifecycle handling with normalized result formats, retry behavior, processing status, review status, and legacy-result compatibility.

Template and Output Configuration

• Supports organization and default template views, template status management, ordering, group-template associations, and resumable personal drafts.
• Supports template sample upload, AI-assisted template configuration, Visual/Integrated extraction testing, and test-artifact download.
• Added output configuration for text, number, date, and enumeration fields:
  • Formatting, normalization, replacement, regular-expression extraction, numeric units, date conversion, and enumeration conversion.
  • Export field-name configuration and duplicate-name validation.
  • Required, format, and comparison validation.
  • Field-level exception markers in results.
• Improved template-deletion safeguards with permission validation, default-template protection, and explicit handling of associated files.

Open API and System Integration

• Aligned the WorkFlow v2 Open APIs with the PRD, covering files, templates, batches, tasks, extraction results, and assets.
• Supports Service API Key authentication through X-API-Key, Api-Key, or Authorization: Bearer {key}.
• Derives organization identity from the API Key for organization data isolation; Open APIs remain separate from browser login-session APIs.
• Supports metadata pass-through during upload, processing, result queries, and Webhook callbacks.
• Added public reminder-rule CRUD endpoints at /api/v2/rules, using public DTOs and ISO 8601 UTC timestamps; creation returns HTTP 201 and deletion returns HTTP 204.
• Standardized error responses with stable error_code values while preserving existing HTTP status codes and business code values.

API Key and Webhook Management

• Supports API Key creation, listing, name filtering, editing, enable/disable, deletion, copying, expiry, usage records, encrypted storage, and verification.
• API Key lists use masked previews and never return complete secrets.
• Supports Webhook creation, listing, editing, enable/disable, deletion, signing-secret copying, encrypted storage, event subscription, delivery records, retries, and latest-response queries.
• Supports batch and file lifecycle callbacks, as well as internal HMAC event authentication between Java WorkFlow and the Python platform.
• Improved handling of historical Webhook records with undecryptable secrets so that one invalid record cannot interrupt other pending deliveries.

Reminder Rules and Message Center

• Supports reminder-rule creation, editing, copying, enable/disable, deletion, scheduled evaluation, and event-driven evaluation.
• Supports template-field conditions, system-status conditions, AND/OR logic, and rule-name conflict validation.
• Added system fields available for condition matching:
  • review_status: pending, confirmed.
  • processing_status: lifecycle states including parsing, classification, extraction, failure, cancellation, and completion.
• Provides inferred status values for legacy WorkFlow events: extract_complete maps to pending review/extraction completed, while confirm_result maps to confirmed review/extraction completed.
• file_name, template_name, and detail_url remain available as notification-template variables and message links; they are no longer exposed as system condition fields.
• Supports in-app, email, and selected-Webhook delivery. Email recipients can be organization members, direct email addresses, or extracted-field bindings; addresses are split, validated, and deduplicated, while invalid values are skipped without blocking other channels.
• Added email/Webhook delivery retries, delivery diagnostics, trigger records, event-level idempotency, and rule-level deduplication. A successfully updated rule resets its own deduplication records; deleting a rule removes its deduplication records.
• The message center presents system messages, system announcements, and user reminder rules; rule messages are grouped by rule name for directory counts.
• Added system notifications for asset quota, plan expiry, and subscription activation, and standardized platform-generated notification text in English.

Organization, Permissions, and Knowledge Base

• When an administrator invites a regular member, the new member inherits enabled business permissions; personnel-management permissions are not inherited automatically.
• Added frontend-recognizable error codes for login failures, duplicate users, and related cases.
• Reminder-rule recipients can include organization members; regular members can read and select existing organization Webhooks.
• Supports organization-member queries for knowledge-base member configuration while preserving the existing knowledge-base membership query.
• Restored runtime compatibility for legacy knowledge-base prompts that omit the {knowledge} placeholder.

Assets, Subscriptions, and Auditing

• Supports subscription asset allocation and asset-account state synchronization.
• Supports asset-expiry scanning, low-quota alerts, and plan-expiry notifications.
• Improved compatibility for expired legacy asset accounts and standardized subscription-expiry display.
• Added operation logs for API Keys, Webhooks, reminder rules, templates, files, tasks, results, and exports.
• Added WorkFlow audit-log persistence and queries. Logs are written in an independent transaction after the primary transaction commits, and write failures are recorded without affecting the primary business transaction.

Documentation and Release Package

• Updated the Chinese user guide, Open API reference, WorkFlow interface reference, error-code reference, and release-package documentation.
• The release package includes Docker Compose, service configuration, Nginx configuration, initialization SQL, and API documentation.
• The public Open API contains only the 23 formal APIs defined by the PRD; test and template helper endpoints are excluded from the public API reference.

Upgrade Notes

• Run the applicable initialization or migration SQL before starting the services.
• Java WorkFlow and the Python platform must use the same REMINDER_INTERNAL_EVENT_SECRET for internal reminder and Webhook callback authentication.
• Before enabling email notifications, fully configure notification_email in the Python service configuration.
• Configure the Gateway to route /api/v2/rules/** to the Python service before matching the generic Java /api/v2/** route, and preserve the Service API Key request headers.