fix(studio): unify source project limits

Author: Garming

frontend/README.md

@@ -238,7 +238,7 @@ server that `veadk frontend` launches — no separate backend.
   root `app.py` as the compatible default. Studio removes a single wrapping
   directory, rejects unsafe paths, and shows upload, image build, Runtime
   creation, and service publishing as separate deployment stages.
-- **Existing-project migration**: upload one local ZIP of at most 50 MiB from
+- **Existing-project migration**: upload one local ZIP of at most 20 MiB from
   the add-Agent menu. Studio creates one user-owned Dev Sandbox Session with a
   one-hour TTL, then asks the preinstalled Codex to perform read-only framework,
   entry-point, and migration-boundary analysis. Migration starts only after the

frontend/server/deployment_source.py

@@ -27,12 +27,16 @@
 from pathlib import Path, PurePosixPath
 
 import yaml
+from frontend.server.source_project_limits import (
+    SOURCE_PROJECT_MAX_BYTES,
+    SOURCE_PROJECT_MAX_FILES,
+)
 
 _DEFAULT_ENTRY_POINT = "app.py"
-_MAX_ARCHIVE_BYTES = 512 * 1024 * 1024
-_MAX_ARCHIVE_FILES = 20_000
-_MAX_EXPANDED_BYTES = 512 * 1024 * 1024
-_MAX_FILE_BYTES = 128 * 1024 * 1024
+_MAX_ARCHIVE_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_ARCHIVE_FILES = SOURCE_PROJECT_MAX_FILES
+_MAX_EXPANDED_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_FILE_BYTES = SOURCE_PROJECT_MAX_BYTES
 _MAX_PATH_BYTES = 4 * 1024
 _MAX_PATH_DEPTH = 64
 _SHA256_RE = re.compile(r"^[0-9a-f]{64}$")
@@ -225,7 +229,7 @@ def _manifest_files(manifest: object) -> tuple[dict[str, tuple[int, str]], str]:
             raise DeploymentSourceError("迁移产物文件清单格式无效。")
         expanded_bytes += size
         if expanded_bytes > _MAX_EXPANDED_BYTES:
-            raise DeploymentSourceError("迁移产物解压后超过 512 MiB。")
+            raise DeploymentSourceError("迁移产物解压后超过 20 MiB。")
         descriptors[relative] = (size, digest)
     _reject_path_collisions(set(descriptors))
     entry_point = _relative_path(

frontend/server/intelligent_development_projects/models.py

@@ -22,6 +22,11 @@
 
 from pydantic import BaseModel, ConfigDict, Field
 
+from frontend.server.source_project_limits import (
+    SOURCE_PROJECT_MAX_BYTES,
+    SOURCE_PROJECT_MAX_FILES,
+)
+
 SourceProjectOrigin = Literal["intelligent-development", "migration"]
 SourceVersionProducer = Literal["intelligent-development", "migration"]
 
@@ -75,8 +80,8 @@ class IntelligentDevelopmentVersion(BaseModel):
     validation_report_sha256: str = Field(
         alias="validationReportSha256", pattern=r"^[0-9a-f]{64}$"
     )
-    artifact_size: int = Field(alias="artifactSize", ge=1, le=512 * 1024 * 1024)
-    file_count: int = Field(alias="fileCount", ge=1, le=20_000)
+    artifact_size: int = Field(alias="artifactSize", ge=1, le=SOURCE_PROJECT_MAX_BYTES)
+    file_count: int = Field(alias="fileCount", ge=1, le=SOURCE_PROJECT_MAX_FILES)
     agent_name: str = Field(alias="agentName", min_length=1, max_length=256)
     entry_point: str = Field(alias="entryPoint", min_length=1, max_length=512)
     verified: bool

frontend/server/intelligent_development_projects/repository.py

@@ -26,6 +26,10 @@
 
 from pydantic import ValidationError
 
+from frontend.server.source_project_limits import (
+    SOURCE_PROJECT_MAX_BYTES,
+    SOURCE_PROJECT_MAX_REPORT_BYTES,
+)
 from frontend.server.storage import STUDIO_STORAGE_ROOT_PREFIX
 
 from .models import (
@@ -41,8 +45,8 @@
     r"/projects/(?P<project>[0-9a-f]{32})/versions/[0-9a-f]{32}/version\.json$"
 )
 _MAX_JSON_BYTES = 256 * 1024
-_MAX_ARTIFACT_BYTES = 512 * 1024 * 1024
-_MAX_REPORT_BYTES = 16 * 1024 * 1024
+_MAX_ARTIFACT_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_REPORT_BYTES = SOURCE_PROJECT_MAX_REPORT_BYTES
 T = TypeVar("T")
 logger = logging.getLogger(__name__)
 

frontend/server/intelligent_development_projects/service.py

@@ -27,6 +27,11 @@
 from frontend.server.intelligent_development import DeliveryReference, release_path
 from frontend.server.intelligent_development_task import IntentDecision
 from frontend.server.sandbox_remote import SandboxRemoteTransport
+from frontend.server.source_project_limits import (
+    SOURCE_PROJECT_MAX_BYTES,
+    SOURCE_PROJECT_MAX_FILES,
+    SOURCE_PROJECT_MAX_REPORT_BYTES,
+)
 from veadk.cli.frontend_sandbox import SandboxSessionUnavailableError
 
 from .models import (
@@ -43,8 +48,8 @@
     TosIntelligentDevelopmentProjectRepository,
 )
 
-_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024
-_MAX_REPORT_BYTES = 2 * 1024 * 1024
+_MAX_ARTIFACT_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_REPORT_BYTES = SOURCE_PROJECT_MAX_REPORT_BYTES
 logger = logging.getLogger(__name__)
 
 
@@ -208,8 +213,8 @@ async def restore_base_version(
             " with zipfile.ZipFile(archive) as package:\n"
             "  files=[item for item in package.infolist() if not item.is_dir()]\n"
             "  if len(files)!=expected_count: raise ValueError('file count mismatch')\n"
-            "  if len(files)>20000: raise ValueError('too many files')\n"
-            "  if sum(item.file_size for item in files)>512*1024*1024: raise ValueError('archive too large')\n"
+            f"  if len(files)>{SOURCE_PROJECT_MAX_FILES}: raise ValueError('too many files')\n"
+            f"  if sum(item.file_size for item in files)>{SOURCE_PROJECT_MAX_BYTES}: raise ValueError('archive too large')\n"
             "  for item in files:\n"
             "   path=PurePosixPath(item.filename)\n"
             "   if path.is_absolute() or not path.parts or '..' in path.parts: raise ValueError('unsafe path')\n"

frontend/server/intelligent_development_source.py

@@ -37,22 +37,27 @@
     IntelligentDevelopmentVersionNotFound,
 )
 from frontend.server.sandbox_remote import SandboxRemoteTransport
+from frontend.server.source_project_limits import (
+    SOURCE_PROJECT_MAX_BYTES,
+    SOURCE_PROJECT_MAX_FILES,
+    SOURCE_PROJECT_MAX_REPORT_BYTES,
+)
 from veadk.cli.frontend_sandbox import (
     SandboxConversationService,
     SandboxSessionNotFoundError,
     SandboxSessionUnavailableError,
 )
 
 _SHA256 = re.compile(r"^[0-9a-f]{64}$")
-_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024
-_MAX_EXPANDED_BYTES = 20 * 1024 * 1024
-_MAX_FILE_COUNT = 2_000
-_MAX_REPORT_BYTES = 2 * 1024 * 1024
+_MAX_ARTIFACT_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_EXPANDED_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_FILE_COUNT = SOURCE_PROJECT_MAX_FILES
+_MAX_REPORT_BYTES = SOURCE_PROJECT_MAX_REPORT_BYTES
 _MAX_DESCRIPTOR_BYTES = 256 * 1024
 _CURRENT_POINTER_BYTES = 4 * 1024
 _MAX_PREVIEW_FILE_BYTES = 2 * 1024 * 1024
-_MAX_PREVIEW_TOTAL_BYTES = 20 * 1024 * 1024
-_MAX_PREVIEW_FILES = 2_000
+_MAX_PREVIEW_TOTAL_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_PREVIEW_FILES = SOURCE_PROJECT_MAX_FILES
 _REQUIRED_GATES = {
     "local-checks",
     "service-probe",

frontend/server/migration/contracts.py

@@ -20,6 +20,11 @@
 from datetime import datetime
 from pathlib import PurePosixPath
 
+from frontend.server.source_project_limits import (
+    SOURCE_PROJECT_MAX_BYTES,
+    SOURCE_PROJECT_MAX_FILES,
+)
+
 from .models import (
     MIGRATION_FRAMEWORKS,
     STRUCTURED_MIGRATION_FRAMEWORKS,
@@ -30,12 +35,12 @@
 _MAX_PATH_BYTES = 4 * 1024
 _MAX_PATH_DEPTH = 64
 _MAX_TEXT_LENGTH = 20_000
-_MAX_DELIVERY_FILES = 20_000
-_MAX_DELIVERY_BYTES = 512 * 1024 * 1024
-_MAX_DELIVERY_FILE_BYTES = 128 * 1024 * 1024
-_MAX_ARTIFACT_BYTES = 512 * 1024 * 1024
-_MAX_SOURCE_BYTES = 50 * 1024 * 1024
-_MAX_SOURCE_EXPANDED_BYTES = 1024 * 1024 * 1024
+_MAX_DELIVERY_FILES = SOURCE_PROJECT_MAX_FILES
+_MAX_DELIVERY_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_DELIVERY_FILE_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_ARTIFACT_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_SOURCE_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_SOURCE_EXPANDED_BYTES = SOURCE_PROJECT_MAX_BYTES
 _SHA256_RE = re.compile(r"^[0-9a-f]{64}$")
 _FILE_MODE_RE = re.compile(r"^0[0-7]{1,3}$")
 _ENVIRONMENT_KEY_RE = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")

frontend/server/migration/routes.py

@@ -321,7 +321,7 @@ async def upload_source(
             if declared_bytes > MIGRATION_UPLOAD_MAX_BYTES:
                 too_large = MigrationError(
                     "MIGRATION_SOURCE_TOO_LARGE",
-                    "项目 ZIP 不能超过 50 MiB。",
+                    "项目 ZIP 不能超过 20 MiB。",
                     status_code=413,
                 )
                 raise HTTPException(
@@ -333,7 +333,7 @@ async def upload_source(
             if len(content) + len(chunk) > MIGRATION_UPLOAD_MAX_BYTES:
                 too_large = MigrationError(
                     "MIGRATION_SOURCE_TOO_LARGE",
-                    "项目 ZIP 不能超过 50 MiB。",
+                    "项目 ZIP 不能超过 20 MiB。",
                     status_code=413,
                 )
                 raise HTTPException(

frontend/server/migration/service.py

@@ -38,6 +38,11 @@
     DeploymentSourceError,
     extract_migration_source,
 )
+from frontend.server.source_project_limits import (
+    SOURCE_PROJECT_MAX_BYTES,
+    SOURCE_PROJECT_MAX_FILES,
+    SOURCE_PROJECT_MAX_REPORT_BYTES,
+)
 
 from .contracts import (
     MigrationContractError,
@@ -70,16 +75,16 @@
 
 MIGRATION_ROOT = "/home/gem/.studio/migration/v1"
 MIGRATION_SESSION_TTL_SECONDS = 60 * 60
-MIGRATION_UPLOAD_MAX_BYTES = 50 * 1024 * 1024
+MIGRATION_UPLOAD_MAX_BYTES = SOURCE_PROJECT_MAX_BYTES
 MIGRATION_CLI_MIN_VERSION = "0.52.1"
 MIGRATION_UNSUPPORTED_MODEL_IDS = frozenset({"deepseek-v4-pro-260425"})
-_MAX_EXPANDED_BYTES = 1024 * 1024 * 1024
-_MAX_ARCHIVE_FILES = 20_000
+_MAX_EXPANDED_BYTES = SOURCE_PROJECT_MAX_BYTES
+_MAX_ARCHIVE_FILES = SOURCE_PROJECT_MAX_FILES
 _MAX_ARCHIVE_PATH_BYTES = 4 * 1024
 _MAX_ARCHIVE_DEPTH = 64
-_MAX_JSON_BYTES = 16 * 1024 * 1024
+_MAX_JSON_BYTES = SOURCE_PROJECT_MAX_REPORT_BYTES
 _MAX_PROVENANCE_BYTES = 64 * 1024
-_MAX_ARTIFACT_BYTES = 512 * 1024 * 1024
+_MAX_ARTIFACT_BYTES = SOURCE_PROJECT_MAX_BYTES
 _MAX_PREVIEW_BYTES = 2 * 1024 * 1024
 _FILE_OPERATION_TIMEOUT_SECONDS = 300
 _TASK_ID_RE = re.compile(r"^migration-v1-[0-9a-f]{32}$")
@@ -797,7 +802,7 @@ def validate_source_archive(content: bytes) -> SourceArchiveSummary:
     if len(content) > MIGRATION_UPLOAD_MAX_BYTES:
         raise MigrationError(
             "MIGRATION_SOURCE_TOO_LARGE",
-            "项目 ZIP 不能超过 50 MiB。",
+            "项目 ZIP 不能超过 20 MiB。",
             status_code=413,
         )
     seen: set[str] = set()
@@ -857,7 +862,7 @@ def validate_source_archive(content: bytes) -> SourceArchiveSummary:
                 if expanded_bytes > _MAX_EXPANDED_BYTES:
                     raise MigrationError(
                         "MIGRATION_SOURCE_EXPANDED_TOO_LARGE",
-                        "项目 ZIP 解压后不能超过 1 GiB。",
+                        "项目 ZIP 解压后不能超过 20 MiB。",
                         status_code=413,
                     )
     except zipfile.BadZipFile as error:

frontend/server/source_project_limits.py

@@ -0,0 +1,25 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shared capacity limits for persisted Studio source projects."""
+
+SOURCE_PROJECT_MAX_BYTES = 20 * 1024 * 1024
+SOURCE_PROJECT_MAX_FILES = 2_000
+SOURCE_PROJECT_MAX_REPORT_BYTES = 2 * 1024 * 1024
+
+__all__ = [
+    "SOURCE_PROJECT_MAX_BYTES",
+    "SOURCE_PROJECT_MAX_FILES",
+    "SOURCE_PROJECT_MAX_REPORT_BYTES",
+]