From e4b33a9c987a2f715fe39598b8597f92c010cc9f Mon Sep 17 00:00:00 2001
From: zijunchiang <miyu@kasugano.cn>
Date: Thu, 17 Sep 2026 01:40:33 +0800
Subject: [PATCH] =?UTF-8?q?docs(tasks):=20=E8=AE=B0=E5=BD=95=20v0.2.0=20?=
 =?UTF-8?q?=E6=95=B4=E5=8C=85=E4=B8=8A=E4=BC=A0=E7=9A=84=E4=B8=A4=E9=98=B6?=
 =?UTF-8?q?=E6=AE=B5=E5=AE=9E=E6=B5=8B=EF=BC=88IIS=20=E5=B7=B2=E6=94=BE?=
 =?UTF-8?q?=E5=BC=80=EF=BC=8CGitea=20=E4=BE=A7=E4=BB=8D=20500=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

按文档 §5.7 硬性要求 4 记录实测上限：
- IIS 未放开时 30.5 / 40 MB 返回 413；
- IIS 放开后，38,245,661 字节的整包请求体被**完整接收**（115 s），
  但 Gitea 返回 HTTP 500（API 错误信封 message 为空）；
- 同接口边界：914 KB 与 16,372,427 B 通过，16,400,000 B 及以上失败；
  多次大包失败后连 100 KB 都会在 0.3 秒内 500 —— 更像上传临时目录 /
  数据盘写满（Gitea 先写 data/tmp），而不是体积上限。

结论：只放开 IIS 不足以放行 38 MB 整包，还需清理/扩容 Gitea 数据盘
并调整 app.ini 的 [attachment] MAX_SIZE；详见
opendance-web/deploy/proxy/README.md 第九节。
---
 tasks/014-full-package.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/tasks/014-full-package.md b/tasks/014-full-package.md
index 635b192..bf89a44 100644
--- a/tasks/014-full-package.md
+++ b/tasks/014-full-package.md
@@ -62,6 +62,22 @@ SHA256SUMS.txt
 | 下载后可直接解压运行（`OpenDance.exe` + `.pck` 同目录），无需拼接 | ✅ 脚本解压自检覆盖 |
 | `sha256sum -c SHA256SUMS` 通过 | ✅ 脚本打包后立即在同一目录自校验 |
 
+## 实测记录（v0.2.0 发布时）
+
+| 上传体积 | 结果 | 说明 |
+|--|--|--|
+| 14 MB | 通过（HTTP 201） | 分卷时代的对照 |
+| 30.5 MB / 40 MB | **HTTP 413** | IIS 默认 `maxAllowedContentLength` 未放开 |
+| **38,245,661 B（本整包）** | 请求体被**完整接收**（115 s），但 **Gitea 返回 HTTP 500** | IIS 上限已放开，瓶颈转移到 Gitea 侧 |
+
+放开 IIS 之后同接口的边界测量：914 KB 与 16,372,427 B 通过；
+16,400,000 B 及以上失败；**在若干次大包失败之后，连 100 KB 都会在 0.3 秒内 500** ——
+更像**上传临时目录 / 数据盘写满**（Gitea 先写 `data/tmp`），而不是体积上限。
+
+→ 结论：**只放开 IIS 不足以放行 38 MB 整包**，还需要
+①清理/扩容 Gitea 数据盘（尤其 `data/tmp`）②`app.ini` 的 `[attachment] MAX_SIZE`。
+详见 `opendance-web/deploy/proxy/README.md` 第九节。
+
 ## 上传前检查清单
 
 ```