Files

115 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 回执 · 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 上跑
```