docs(proxy): 更正「Gitea 附件通道坏了/磁盘写满」的误判 —— 实际是上传字段名写错

排查 Windows 整包上传时的 500 曾被判成"Gitea 宿主机磁盘写满"。**这个结论是错的**,
本次用对照实验确认并更正:Gitea 的 Release 附件接口 multipart 字段名是
**`attachment`**,用 `file=` 会得到

  HTTP 500 {"message":"","url":"https://gitea.kasugano.cn/api/swagger"}

空消息,极易误判成服务器故障。同一 1 KB 文件、同一 Release 的实测对照:
  -F "attachment=@probe.bin"                      → 201
  --data-binary @probe.bin (+?name=)              → 201
  -F "file=@probe.bin"                            → 500(空消息)

**仍然真实存在、且是唯一限制的是 IIS `maxAllowedContentLength`(默认 30,000,000 字节)**:
927 KB / 14 MB / 16,372,427 B 通过;30.5 MB / 38,245,602 B / 40 MB 一律 HTTP 413。

文档更正:
- deploy/proxy/README.md 第九节重写 9.1(含"误判更正"小节)与 9.3(复验命令改用
  正确字段名),并给出两种可直接照抄的上传写法;
- DSH 开发文档 v1.6 §5.7 的"阶段二"表格改为"误判更正"记录;
- opendance-windows/tasks/014-full-package.md 同步更正并附正确上传命令;
- 本仓库 README.md/.txt 的 v0.7.3 说明补第 6 条。

验证:npm run verify 通过(22 文件 / 281 项测试 + 启动冒烟);重新打包
opendance-web-v0.7.3.tar.gz(sha256 见 dist-release/SHA256SUMS)。
This commit is contained in:
2026-09-17 03:39:36 +08:00
parent 828c7cea49
commit 74332e20d8
3 changed files with 70 additions and 42 deletions
+7
View File
@@ -28,6 +28,13 @@ v0.7.3 修订 - 场景表不可用不再拖垮整站(生产事故修复)
pending, 默认模型由审核通过时 setPrimary=true 或 /primary 设定),
冒烟脚本的错误预期已同步修正。
5. 新增 6 项测试。
6. 更正一次误判: Gitea 附件接口的 HTTP 500 空消息("message":"")曾被我判成宿主机
磁盘写满, 实际是**上传写法错误** -- 该接口 multipart 字段名是 attachment,
用 file= 就会得到空消息 500。正确写法两种(attachment=@... 或
--data-binary + ?name=)已写进 deploy/proxy/README.md 第九节。
仍然真实存在的唯一限制是 IIS maxAllowedContentLength(默认 30,000,000 字节):
927KB/14MB/16.4MB 通过, 30.5MB/38.2MB/40MB 一律 413。
v0.7.2 修订 - 修复产物"装得上、起不来" + /health 报错版本号
1. CatalogModule 漏 import ScenesModule(致命): CatalogService 注入