- store.py(新):卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态进 <DATA_DIR>/ys.db; 第一次启动自动建库并导入旧 JSON(旧文件不动),admin.py db check/backup/export - server.py / admin.py 存取换到库上,路由与接口字段不变;calls.jsonl 照旧追加 - 管理接口新增 calls / call-done / retry,codes 支持 q 搜索 - ys_admin.py 页面重写:待处理 / 订单 / 卡密 / 福利券 / 呼叫·反馈 / 开单工具 - tests/数据库测试.py(37 条,假数据);回归 27 条照旧全过 - 交接说明(数据库一节、面板一节)、回执第二轮、交付清单更新 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
回执 · 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 第三节 ②)