diff --git a/README.md b/README.md index 9c6b824..4afcd4d 100644 --- a/README.md +++ b/README.md @@ -190,7 +190,7 @@ python3 scripts/test-ai.py 服务账号的 GITEA_TOKEN 需同时允许 REST 仓库创建、HTTP Git 读写及 LFS 读写。凭据通过进程环境注入,只用于配置的 Gitea 地址;不写入 URL、命令参数、Git 配置或日志。Fork 接口继续同步返回,前端和反向代理读取超时至少400秒;AI 进入 forking 后切换专用预算并继续发送心跳。 -Fork 不受普通在线文件读取的10 MiB限制,文件浏览、下载和 LFS 在线展开能力仍维持原规则。失败时先核对响应 data.projectCode:明确失败为 FAILED,远端写入或数据库状态待核对为 CREATING;不会自动重发、删除远端仓库或 OSS 对象。完成后清理本地临时目录。使用 scripts/test-gitea.py 可执行显式真实 Gitea 联调,仅创建并清理本次测试专用仓库,不修改已有社区项目。 +Fork 不受普通在线文件读取的 50 MiB 限制,文件浏览、下载和 LFS 在线展开能力仍维持原规则。失败时先核对响应 data.projectCode:明确失败为 FAILED,远端写入或数据库状态待核对为 CREATING;不会自动重发、删除远端仓库或 OSS 对象。完成后清理本地临时目录。使用 scripts/test-gitea.py 可执行显式真实 Gitea 联调,仅创建并清理本次测试专用仓库,不修改已有社区项目。 ## 运行约定 diff --git a/docs/admin-api.md b/docs/admin-api.md index f37dd48..681472e 100644 --- a/docs/admin-api.md +++ b/docs/admin-api.md @@ -619,7 +619,7 @@ interface CommitInput { - CREATE_FILE、UPDATE_FILE 必须传原始文本 `content`,空文件传 `""`,不做 Base64 编码。 - DELETE_FILE、CREATE_DIRECTORY 不需要 content;不支持用 DELETE_FILE 删除整个目录。 - changes 为 1~500 项,同一次提交不能重复修改同一路径。 -- message 必填,1~1000 字符;文本单文件最多 1 MiB,提交内容合计最多 50 MiB。 +- message 必填,1~1000 字符;文本单文件最多 1 MiB,提交内容合计最多 200 MiB;整个 JSON 请求另受 64 MiB 默认上限约束,包含转义和结构开销。 - 成功返回新的 `commitSha` 和 `message`。更新本地工作区 SHA,再刷新目录/文件/历史。 版本冲突返回 409 `CONFLICT`。保留未保存的编辑内容,提示用户刷新并比对差异,不能直接换成最新 SHA 自动覆盖。 @@ -636,9 +636,9 @@ interface CommitInput { | files | 是 | 重复 append 的 File 字段,1~500 个 | | paths | 否 | 重复 append 的相对路径,与 files 数量相同且逐项对应;省略则用原文件名 | -单文件最多 **10 MiB**,一批文件合计最多 **50 MiB**;1 MiB = 1,048,576 字节。同名路径会更新已有文件。上传目录不自动解压 ZIP,超限时让用户减少文件或分批提交,每批使用上次返回的新 SHA。 +单文件最多 **50 MiB**,一批文件合计最多 **200 MiB**,最多 **500 个文件**;1 MiB = 1,048,576 字节。同名路径会更新已有文件。上传目录不自动解压 ZIP,超限时让用户减少文件或分批提交,每批使用上次返回的新 SHA。 -multipart 整个请求最多 **52 MiB**,表单项上限为 **1003**(500 个 files、500 个 paths、3 个公共字段)。不要为每个文件额外添加其他表单项。表单项数量超限返回 413 `UPLOAD_TOO_MANY_PARTS`,大小超限返回 `UPLOAD_TOO_LARGE` 或 `FILE_TOO_LARGE`。 +multipart 整个请求最多 **202 MiB**,其中预留 2 MiB 表单开销;表单项上限为 **1003**(500 个 files、500 个 paths、3 个公共字段)。不要为每个文件额外添加其他表单项。表单项数量超限返回 413 `UPLOAD_TOO_MANY_PARTS`,大小超限返回 `UPLOAD_TOO_LARGE` 或 `FILE_TOO_LARGE`。 ```ts interface SelectedFile { diff --git a/docs/admin-deployment.md b/docs/admin-deployment.md index 50f6e64..758b0ac 100644 --- a/docs/admin-deployment.md +++ b/docs/admin-deployment.md @@ -147,7 +147,7 @@ Redis 只监听内网或回环地址,启用认证;跨不可信网络使用 T | FILE_MAX_CONCURRENT | 4,单实例文件读取/目录/历史/提交/multipart 处理名额 | | FORK_MAX_CONCURRENT | 2,保持独立 Fork 执行名额 | -JSON 上限为实际线上请求字节数,包含转义和结构开销;业务单文件/总内容上限继续保留。Content-Length 和 chunked 均流式核验,超限返回 413 REQUEST_TOO_LARGE。multipart 仍为单文件 10MB、请求 52MB,原有 UPLOAD_TOO_LARGE/FILE_TOO_LARGE 错误保留;URDF 直传 OSS 不占用这类 multipart 名额。文件名额不足为 429 FILE_BUSY,不排队;Fork 繁忙仍为 FORK_BUSY。 +JSON 上限为实际线上请求字节数,包含转义和结构开销;业务单文件/总内容上限继续保留。Content-Length 和 chunked 均流式核验,超限返回 413 REQUEST_TOO_LARGE。仓库上传单文件最多 50 MiB、文件合计最多 200 MiB、每批最多 500 个文件,multipart 整个请求最多 202 MiB(预留 2 MiB 表单开销),原有 UPLOAD_TOO_LARGE/FILE_TOO_LARGE 错误保留;部署反向代理时同步确保请求体上限不低于 202 MiB。URDF 直传 OSS 不占用这类 multipart 名额。文件名额不足为 429 FILE_BUSY,不排队;Fork 繁忙仍为 FORK_BUSY。 API 和管理端均显式配置 `server.tomcat.max-part-count=1003`,允许 500 个 files、500 个 paths 及 3 个公共字段。Tomcat 默认的 50 项无法承载业务允许的批量上传;数量超限会被 Spring 包装成上传大小异常,现区分为 413 `UPLOAD_TOO_MANY_PARTS` 并记录安全诊断日志。部署时若覆盖该配置,需要与业务批量文件数对齐。 diff --git a/docs/vibemake-api.md b/docs/vibemake-api.md index 335c855..7a95fc4 100644 --- a/docs/vibemake-api.md +++ b/docs/vibemake-api.md @@ -645,7 +645,7 @@ URDF 替换或清除立即影响社区,不需要重新发布仓库。Fork 在 | 文件数量 | 500,`URDF_MAX_FILES=500` | | 对象键 | 最多 512 个 Java 字符且 UTF-8 最多 1023 字节;前缀占用也计入 | -URDF 直传不受仓库上传的 multipart 10 MiB / 52 MiB 限制影响。路径必须是唯一相对路径,不能包含绝对路径、空段、`.`、`..`、反斜杠、控制字符、`.git` 目录或冒号。系统不解析 URDF 语义、不执行 Xacro、不自动修复 `package://` 等引用;渲染器的资源解析由前端处理。 +URDF 直传不受仓库上传的 multipart 50 MiB / 202 MiB 限制影响。路径必须是唯一相对路径,不能包含绝对路径、空段、`.`、`..`、反斜杠、控制字符、`.git` 目录或冒号。系统不解析 URDF 语义、不执行 Xacro、不自动修复 `package://` 等引用;渲染器的资源解析由前端处理。 | HTTP / code | 提示与处理 | | --- | --- | @@ -862,13 +862,13 @@ entries 仅包含当前目录的直接子项,目录在前,名称升序。展 | 限制 | 数值 | | --- | --- | | 在线创建或编辑的单个文本内容 | 1 MiB,1048576 字节 | -| 上传或读取的单文件 | 10 MiB,10485760 字节 | -| 本次上传文件或提交内容总量 | 50 MiB,52428800 字节 | -| multipart 整个请求 | 52 MiB,包含传输开销 | +| 上传或读取的单文件 | 50 MiB,52428800 字节 | +| 本次上传文件或提交内容总量 | 200 MiB,209715200 字节 | +| multipart 整个请求 | 202 MiB,预留 2 MiB 表单开销 | | 单批变更或上传文件数量 | 500 | | multipart 表单项数量 | 1003,含 500 个 files、500 个 paths 和 3 个公共字段 | -大小按字节计算,文本使用 UTF-8 编码长度,不使用 JavaScript 字符串 length 计算文件体积。以上是当前默认配置,超限返回 413。后端调整业务上传大小时还需同步调整 multipart 配置。 +大小按字节计算,文本使用 UTF-8 编码长度,不使用 JavaScript 字符串 length 计算文件体积。以上是当前默认配置,超限返回 413。提交 JSON 请求另受 64 MiB 默认上限约束,包含转义和结构开销。后端调整业务上传大小时还需同步调整 multipart 配置。 ### 提交历史 @@ -943,7 +943,7 @@ commitSha 必须为当前 main 的完整 SHA,不能发布历史提交。成功 Fork 使用 Git 仓库级快照复制:冻结校验通过的 publishedCommitSha,保留该提交完整的文件树,在新私有仓库 main 上创建一个无父提交的初始版本,不继承源仓库的历史、其他分支或标签,不自动同步上游。允许同一用户及多个用户多次 Fork 同一来源。新副本的提交 SHA 与 sourceCommitSha 不同,应通过工作区 tree 接口获取新版本。 -复制保留普通文件、执行权限、符号链接、`.gitmodules` 和子模块引用;不递归下载子模块依赖。Git LFS 指针及发布快照引用的实体会完整复制,并从副本独立下载校验。缺失的 LFS 实体会导致 Fork 失败。复制不使用普通文件接口的 10 MiB 读取上限,在线文件浏览、下载及 LFS 展开能力仍受原限制。URDF 按受理时绑定的当前清单独立复制到新目录,复制时校验 ETag,封面继承原 URL;Git、LFS 和 OSS 全部完成后才返回 READY。 +复制保留普通文件、执行权限、符号链接、`.gitmodules` 和子模块引用;不递归下载子模块依赖。Git LFS 指针及发布快照引用的实体会完整复制,并从副本独立下载校验。缺失的 LFS 实体会导致 Fork 失败。复制不使用普通文件接口的 50 MiB 读取上限,在线文件浏览、下载及 LFS 展开能力仍受原限制。URDF 按受理时绑定的当前清单独立复制到新目录,复制时校验 ETag,封面继承原 URL;Git、LFS 和 OSS 全部完成后才返回 READY。 后端部署需要 Git 和 git-lfs。默认 Fork 总预算5分钟、单实例最多同时2次,每次临时磁盘上限5 GiB(含 Git 对象、LFS 源缓存和副本校验缓存)。配置分别为 FORK_TIMEOUT、FORK_MAX_CONCURRENT、FORK_MAX_TEMPORARY_BYTES;临时目录可通过 FORK_TEMPORARY_DIRECTORY 指定。依赖不可用或并发超限时,在创建项目记录前拒绝。普通创建和其他 API 不依赖 Fork 运行环境。 diff --git a/vibemake-adminapi/src/main/resources/application.yml b/vibemake-adminapi/src/main/resources/application.yml index 789360c..a871b0c 100644 --- a/vibemake-adminapi/src/main/resources/application.yml +++ b/vibemake-adminapi/src/main/resources/application.yml @@ -13,8 +13,9 @@ spring: mode: never servlet: multipart: - max-file-size: 10MB - max-request-size: 52MB + max-file-size: 50MB + # 文件合计最多 200 MiB,额外预留 2 MiB 表单开销。 + max-request-size: 202MB jackson: time-zone: UTC data: @@ -97,8 +98,8 @@ vibemake: captcha-ttl: 2m token-ttl: 8h max-text-bytes: 1048576 - max-file-bytes: 10485760 - max-request-bytes: 52428800 + max-file-bytes: 52428800 + max-request-bytes: 209715200 gitea: connect-timeout: 5s request-timeout: 30s diff --git a/vibemake-api/src/main/resources/application.yml b/vibemake-api/src/main/resources/application.yml index eaddc2d..9ae1d9f 100644 --- a/vibemake-api/src/main/resources/application.yml +++ b/vibemake-api/src/main/resources/application.yml @@ -13,8 +13,9 @@ spring: mode: never servlet: multipart: - max-file-size: 10MB - max-request-size: 52MB + max-file-size: 50MB + # 文件合计最多 200 MiB,额外预留 2 MiB 表单开销。 + max-request-size: 202MB jackson: time-zone: UTC data: @@ -91,8 +92,8 @@ vibemake: captcha-ttl: 2m token-ttl: 24h max-text-bytes: 1048576 - max-file-bytes: 10485760 - max-request-bytes: 52428800 + max-file-bytes: 52428800 + max-request-bytes: 209715200 gitea: connect-timeout: 5s request-timeout: 30s diff --git a/vibemake-common/src/test/java/com/linkerbot/vibemake/common/MultipartUploadTest.java b/vibemake-common/src/test/java/com/linkerbot/vibemake/common/MultipartUploadTest.java index 5c9ee9f..31f3300 100644 --- a/vibemake-common/src/test/java/com/linkerbot/vibemake/common/MultipartUploadTest.java +++ b/vibemake-common/src/test/java/com/linkerbot/vibemake/common/MultipartUploadTest.java @@ -39,10 +39,11 @@ class MultipartUploadTest { @ParameterizedTest @ValueSource(strings = {"vibemake-api", "vibemake-adminapi"}) - void applicationConfigurationAccepts34And500SmallFiles(String module) throws Exception { + void applicationConfigurationAcceptsSmallBatchesAndMaximumSizeFile(String module) throws Exception { try (ServletWebServerApplicationContext context = start(module)) { assertAccepted(upload(context, module, 34, 3000), 34, 102000); assertAccepted(upload(context, module, 500, 1), 500, 500); + assertAccepted(upload(context, module, 1, 50 * 1024 * 1024), 1, 50 * 1024 * 1024); } } @@ -51,7 +52,7 @@ class MultipartUploadTest { void excessivePartsAndOversizedFileHaveDifferentErrors(String module) throws Exception { try (ServletWebServerApplicationContext context = start(module)) { assertRejected(upload(context, module, 501, 1), "UPLOAD_TOO_MANY_PARTS"); - assertRejected(upload(context, module, 1, 10 * 1024 * 1024 + 1), "UPLOAD_TOO_LARGE"); + assertRejected(upload(context, module, 1, 50 * 1024 * 1024 + 1), "UPLOAD_TOO_LARGE"); } } diff --git a/vibemake-service/src/main/java/com/linkerbot/vibemake/service/config/VibemakeProperties.java b/vibemake-service/src/main/java/com/linkerbot/vibemake/service/config/VibemakeProperties.java index 2dc7094..700e182 100644 --- a/vibemake-service/src/main/java/com/linkerbot/vibemake/service/config/VibemakeProperties.java +++ b/vibemake-service/src/main/java/com/linkerbot/vibemake/service/config/VibemakeProperties.java @@ -17,8 +17,8 @@ import java.util.Map; public class VibemakeProperties { private Map types = defaultTypes(); private long maxTextBytes = 1024 * 1024; - private long maxFileBytes = 10 * 1024 * 1024; - private long maxRequestBytes = 50 * 1024 * 1024; + private long maxFileBytes = 50 * 1024 * 1024; + private long maxRequestBytes = 200 * 1024 * 1024; private Duration captchaTtl = Duration.ofMinutes(2); private Duration tokenTtl = Duration.ofHours(24); private Gitea gitea = new Gitea();