Deployment and upgradesOfficial documentation6 min readDeployment and upgrades

FastGPT 4.15.04 Key Code Improvement Changes

Plugin Service Monorepo Restructuring FastGPT 4.15.04 restructures the plugin service’s underlying architecture, replacing the legacy runtime structure wi…

Plugin Service Monorepo Restructuring

FastGPT 4.15.04 restructures the plugin service’s underlying architecture, replacing the legacy runtime structure with a pnpm workspace monorepo. The monorepo is split into seven standardized, modular packages, each with a dedicated purpose:

Package NameCore Purpose
HTTP Service EntryPrimary runtime entry point for handling incoming plugin HTTP requests
Domain ModelsCore business data structures governing plugin workflow state
Use CasesStandalone business logic implementations for core plugin operations
API AdaptersAbstraction layers for integrating with external APIs and services
InfrastructureLow-level system utilities and platform connectivity tools
SDKClient software development kit for building custom plugin extensions
CLICommand-line interface for managing plugin deployments and configurations

This modular structure improves maintainability, allows for targeted updates, and simplifies cross-team collaboration on plugin-related code.

Zod-Schema API Endpoint Validation & Docs

All application API endpoints have been fully rewritten using Zod schemas for strict, type-safe input and output validation. Official API documentation is automatically generated directly from the deployed Zod schemas, eliminating manual documentation updates and ensuring alignment between the codebase and published API specifications.

Image Processing Memory Optimization

The platform’s image processing pipeline has been updated to process images immediately in dedicated worker threads, rather than retaining base64-encoded image data in main memory during processing. This change removes the memory overhead of storing uncompressed base64 image data throughout the workflow, lowering overall system memory usage and improving stability during high-volume image operations.

Source: FastGPT official source

Applicability and version scope

Use this page for the documented Deployment and upgrades scenario. Confirm the FastGPT, dependency, API, and deployment versions in the official source before applying a change.

Safety guardrails

Use [REDACTED_CREDENTIAL] for credentials and private data. Confirm the documented environment and version before review.

Rollback guidance

Restore the prior technical-content authority snapshot. Restore saved configuration and data snapshots, then repeat the smallest verification scenario.