# 回执 · Claude(受 ywsabc2 委托)· 2026-10-05 · 工具后端 > 范围:`backend-tools/`(ys_worker.py / ys_admin.py / ys_local.py / deploy.py,make_order.py 只扫了命名部分)。 > 网站后端那份更长、问题更多:`backend-site/回执-Claude.md`。两份里对 Q3/Q4/Q5 的回答是同一套,这里只写结论。 > 行号指交付时的原版(提交 `c6034e9`)。 ## 0. 一句话总结 渲染机这边**健壮性做得比服务器那边好**:心跳独立线程、看门狗连进程组一起杀、网络重试、进度按 `\r` 切,这些坑都踩明白了。 最该修的是两处**静默少交货**(大图回传超上限、收单时张数口径不一致),以及本机工具能被任意网页远程操纵(`ys_local.py`)。 前一处我在**服务器端**修好了(渲染机不用动),后一处直接改了 `ys_local.py`。 ## 1. 问题分析 | # | 严重度 | 位置(原版) | 问题是什么 | 触发条件 | 影响 | 状态 | |---|---|---|---|---|---|---| | 1 | 🟡(怀疑,强烈建议实测) | ys_worker.py `handle_order` 575 + 服务器 `MAX_BODY_WK=16MB` + nginx `/finish` 16m | 每个文件 base64 后整包 POST。4096×4096 的 16bit RGBA 原始数据是 128MB,PNG 压一半也还有几十 MB;2048 的无压缩也很可能超 12MB(base64 前) | 出 2048 / 4096 的单 | 服务器 / nginx 拒收 → 渲染机只记一条 errs 继续往下 → 最后 close → **订单「已完成」但少了无压缩版**,买家和金钻都不知道 | 「不再静默」已在服务器端修(见网站回执改动 11);**传输本身建议**改分块上传 | | 2 | 🟡 | ys_worker.py 596 收单不带 `total`;服务器按模板数算 | 渲染机的 total 是**文件数**(每模板 2 张),收单那一下服务器却按**模板数**判断收没收满 | 有模板失败或回传失败 | 少交的单被当成收满 → 静默 | 已修(服务器记住渲染机报过的 total) | | 3 | 🟡 | ys_worker.py 26 / 438 | 渲染机写死 `TERMS_VERSION = "2026-10-01.1"`,服务器派单又不给订单的版本 | 每一单 | 永久留档里的「条款版本」全是错的 | 已修(服务器 `/claim` 新增 `terms_v`,渲染机本来就先读它,**不用改渲染机**) | | 4 | 🟡 | ys_local.py `do_POST` 328 | 只监听回环,但**本机浏览器里任何网页**都能往 `localhost` 发 POST(text/plain 跨站 POST 不需要预检),原来照单全收 | 金钻开着本机工具时逛到一个恶意网页 | 往队列里塞任意多个渲染(**把机器顶满**)、往留档写没核验过的「皮肤」(本机工具不跑 pngcheck)、`/api/quit` 把工具关掉 | 已修 | | 5 | 🟡 | deploy.py `step()` / `main()` | 每一步的返回码都**没人检查**:scp 失败、安装脚本失败,后面照样往下走,最后打印一行状态 | 隧道抖一下、宿主没开、某个文件没传上 | 正是你们说的「脚本全程报成功、功能静默缺失」 | **建议**:任何一步 rc≠0 立刻退出并打印哪一步 | | 6 | 🟡 | deploy.py staging | `config.json`(**两把令牌明文**)留在本机 `` 和 VM `` 里,部署完不删 | 每次部署 | 令牌在两台机器的临时目录里长期躺着 | **建议**:推完就删 staging(VM 上那份也删) | | 7 | 🟡 | ys_worker.py `--once` | `--once` 不拿单实例锁;服务器 `claim` 会把开渲超过 45 分钟的单退回队列 | 计划任务那个 worker 正在渲一张大单(4096 × 多张超过 45 分钟),有人手动又跑了一次 `--once` | 退回的单被第二个进程又领走:**两个 Blender 同时跑** + 同一单重渲两遍 | **建议**:`--once` 也要拿锁(拿不到就提示「已经有一个在跑」) | | 8 | 🟢 | ys_admin.py PIN | 4~12 位数字 PIN 用「加盐 sha256」存:在线有冷却没问题,但 `pin.json` 一旦被拷走,离线几秒钟就能穷举完 | `pin.json` 泄露 | PIN 失效 | **建议**换 `hashlib.pbkdf2_hmac`(标准库,一行) | | 9 | 🟢 | ys_admin.py `/api/pinset` | 还没设过 PIN 时,**局域网里谁先打开谁就能设** | 新装 / 删了 pin.json 之后的空窗 | 别人设了 PIN、金钻反而进不去 | **建议**:首次设置只允许本机回环来源 | | 10 | 🟢 | ys_admin.py 绑定 `` | 面板监听所有网卡 | 那台电脑接到公共 Wi-Fi / 开了热点 | 面板暴露在别的网络里(还有 PIN 一道) | **建议**:只绑家里那张网卡的地址,或者 Windows 防火墙限定「专用网络」 | | 11 | 🟢 | ys_worker.py `http()` | `HTTPError` 一律不重试(包括 502 / 503 / 504 这类网关临时错误) | 服务器重启、nginx 偶发 502 | 那一张直接算回传失败 | **建议**:5xx 也按网络抖动重试 | ys_admin.py 的「令牌 + PIN + 自定义请求头」做法本身是对的:敏感接口都要求 `X-Pin` 头,跨站页面发不出来(需要预检,服务器又不响应 OPTIONS),所以它没有 ys_local.py 那个问题。 ## 2. 改正意见 | 对应 # | 建议改法 | 代价 / 风险 | 优先级 | |---|---|---|---| | 1 | **分块上传**:`/finish` 支持 `{oid, name, part, parts, data}` 一块 2~4MB,服务器按块追加到 `out/.part`,收齐再改名 + 校验 sha256。这样不受请求体上限限制,断了也只重传一块。**⚠️ 这是接口改动,两边要一起上线**(服务器先上、兼容老格式,渲染机后上) | 中(两边各几十行) | 高(如果实测证实大图超限) | | 1(临时) | 先量一下 2048 / 4096 的无压缩版实际多大;如果只是略超,可以把 nginx 和 `MAX_BODY_WK` 一起调到 64MB 先顶着(服务器内存要算:单个请求峰值约为体积的 3~4 倍) | 小,但吃内存 | 中 | | 5、6 | deploy.py:`step()` 返回非 0 就 `sys.exit`;最后 `finally` 里删掉本机和 VM 的 staging;部署成功的判定改成「心跳报上来的版本号 == 这次部署的版本号」(见网站回执 Q3) | 小 | 中 | | 7 | `--once` 也走 `single_instance()`;服务器那边 45 分钟的「中断回退」改成看**进度最后一次上报的时间**(`progress.at`),而不是开渲时间 —— 大单只要还在报进度就不会被误退 | 小 | 中 | | 8、9、10 | 见上表 | 都很小 | 低 | ## 3. 你改了什么 ### 改动 1 · 本机开单工具只认本机页面 ``` 文件 / 函数:ys_local.py 新增 H._same_site();do_POST() 开头调用 为什么改:问题 #4 改成什么:Host 必须是 localhost / 127.0.0.1 / [::1] 加本工具端口(挡 DNS 重绑定); 请求带了 Origin 就必须是本机这个端口;不满足回 403「只接受本机页面的请求」。GET(看页面、查进度、取图)不受影响。 ⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否] 本机页面 local.html 自己发的请求(render / openfolder / quit)两条都满足,用法不变 怎么验证的:单测 5 种请求头组合:本机 Host ✔、本机 Host+本机 Origin ✔、本机 Host+外站 Origin ✘、 外站 Host(重绑定)✘、Origin=null ✘,全部符合预期 有没有引入新的依赖:没有 ``` ### 改动 2、3(在服务器那份代码里,渲染机不用动) - 收单张数口径(#2)、部分失败通知 + 页面说实话(#1 的「不再静默」)、`/claim` 带 `terms_v`(#3)。 - 详见 `backend-site/回执-Claude.md` 第 3 节改动 11、12。**渲染机代码一行没改**;新服务器配老渲染机完全兼容。 ## 4. 你们拿不准的两件事 - **部署不生效(旧进程还在跑),除了先杀再起有没有更稳的?** 有:**让进程自己报版本**。部署时把版本号(git 提交号或文件 sha256)写进代码常量,心跳带上它,服务器存进 heartbeat.json、在 `/status` 和面板上显示;部署脚本**比对「期望版本 == 心跳报上来的版本」才算成功**。旧进程还活着会立刻看出来。 Windows 上用 NSSM / WinSW 把渲染机和面板装成**服务**,「重启」的语义是确定的(停、等它退出、再起),比计划任务的「运行」可靠。 - **单线程串行,要支持多单怎么不顶满机器?** 先**不加并发、先加吞吐**:同一个模板的多张皮肤放进**同一个 Blender 进程**连着渲(换贴图、再渲),省掉每张冷启动 + 加载工程的固定开销,峰值还不涨。 真要并发,瓶颈是**显存**:按模板估一个显存占用,用「显存预算」信号量决定同时开几个;Blender 设低于正常的优先级、限定 Cycles 线程数;白天一个槽、夜里两个槽。服务器的 `/claim` 本身是原子的,渲染机开两个消费线程各领各的就行,**服务器不用改**。 ## 5. 没验证的部分 - 没有 Windows + Blender 环境:ys_worker.py / ys_admin.py 没有实机跑,只做了代码阅读;ys_local.py 只单测了改动的那个函数。 - `make_order.py`、`.ps1` / `.bat` 只扫了命名和调用参数,没有逐行审。 - 大图回传超上限(#1)是按像素数和常见压缩比推算的,**没有真实成品验证**。 ## 6. 需要的材料 - 一份 2048、一份 4096 单的成品文件大小(标准版 + 无压缩)。 - 渲染机的 `worker.log` 里一次「部分失败」的片段(脱敏),用来核对收单流程。 --- *以上改动都还只在工作区,等你们(和 ywsabc2)看过再决定要不要合。*