Files

11 KiB
Raw Permalink Blame History

回执 · 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(两把令牌明文)留在本机 <TMP_OUT> 和 VM <TMP_WORK> 里,部署完不删 每次部署 令牌在两台机器的临时目录里长期躺着 建议:推完就删 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 绑定 <ALL-INTERFACES> 面板监听所有网卡 那台电脑接到公共 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/<name>.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)看过再决定要不要合。


第二轮(2026-10-05 晚)· 开单后台页面重写

改动 4 · ys_admin.py 页面按功能重排 + 补按钮

文件 / 函数:ys_admin.py 的 PAGE(整页 HTML / CSS / JS 重写);do_GET / do_POST 加了 6 个转发
为什么改:老页面一长条五张卡,要处理的事(待激活、失败、呼叫)跟生成表单混在一起;
          服务器早有的「写备注」「改卡密 / 停用」在面板上没有按钮;失败的单和呼叫记录在面板上处理不了
改成什么:待处理(默认)/ 订单 / 卡密 / 福利券 / 呼叫·反馈 / 开单工具 六页;样子跟 2026 版网站一致;
          订单、卡密能搜;失败的单能退回重渲;呼叫能标「处理过了」;卡密能停用 / 启用 / 改张数
⚠️ 有没有动接口:面板本机接口**新增** /api/codes /api/calls /api/retry /api/note /api/code-edit /api/call-done,
          老接口和 PIN 锁逻辑一个没动;新按钮用到服务器这次新加的管理接口,**服务器要先升级**
你怎么验证的:现编假数据起真服务器 + 真面板,headless 浏览器在电脑宽 / 手机宽各点一遍全部页面和主要操作,
          无报错、无横向滚动(详见 交接说明.md 第三节 ②)

改动 5 · 本机开单页面(local.html)重写

文件 / 函数:local.html(整页);ys_local.py 没动
为什么改:暗色老样子;分辨率选择和次按钮没写样式;「清空」按钮没绑事件(点了没反应);
          拖偏了浏览器会把工具页换成那张图
改成什么:跟网站 / 开单后台同一套样子,左皮肤右模板;补上分辨率样式、清空、整页接收拖拽、出图顺序标号、预计耗时
⚠️ 有没有动接口:没有。/api/status /api/render /api/job /api/file /api/openfolder /api/quit 的请求和字段照旧
你怎么验证的:假本机服务 + headless 浏览器(电脑宽 / 手机宽)走完整流程;没在真 Blender 上跑