diff --git a/backend/README.md b/backend/README.md new file mode 100644 index 0000000..f959df3 --- /dev/null +++ b/backend/README.md @@ -0,0 +1,125 @@ +# 交付包 · 卡密 / 自助渲染下单(后端 + 工具) + +> **交付方**:苏达(网站运维与技术提供) +> **收件方**:外部协作者 +> **日期**:2026-10-05 +> **本次交付由店主拍板,范围就是他圈定的**:网站后端 + 工具后端,全部脱敏,各配交接文档。 + +--- + +## 包里有什么(按店主划的交付范围) + +| 店主说的 | 落在哪 | 里面是什么 | 交接文档 | +|---|---|---|---| +| **网页后端 / 自助后端** | `backend-site/` | 网站服务端全部逻辑:下单、卡密生命周期、队列、支付回调、打包下载、小票 + 管理 CLI + PNG 结构核验 | `backend-site/交接说明.md` | +| **本地的自助管理后台** | `backend-tools/` | 局域网开单后台(带 PIN 锁)+ 纯本机开单工具 + 渲染机 + Blender 出图脚本 + 部署/启动脚本 | `backend-tools/交接说明.md` | +| **用于测试的工程** | `模板/` | 三个 Blender 模板工程(已脱敏,可直接打开渲染) | `模板/说明.md` | +| **其他需要的** | `deploy/` | 反向代理的路由与限流片段(部署层)+ 这一层的取舍说明 | `deploy/nginx-片段.md` | + +--- + +## ⭐ 我们要你回的东西(这次交付的主要目的) + +请你读完代码后,**各回一份**回执(就放在对应目录下,文件名 `回执-<你的名字>.md`), +每份包含三段: + +1. **问题分析** —— 你看到的问题/风险/坏味道,**分轻重**(会丢钱/丢数据/能被人打的排前面), + 尽量**指到具体函数或行**,并说清**什么条件下会踩到**。 +2. **改正意见** —— 每条给出你建议的改法,以及**代价**(改起来多大、会不会影响别处)。 +3. **你改了什么** —— 如果你直接动手改了,逐条列: + ``` + 文件 / 函数: 为什么改: 改成什么(一句话): + ⚠️ 有没有动接口路径 / 请求响应字段 / 数据格式: ← 这三样动了我们必须知道 + 你怎么验证的: + ``` + +> 两份交接文档里各有两个**我们自己拿不准的具体问题**,也请顺手回答一下。 + +**"你改了什么"为什么单独要一段**:这套系统是**两台机器上各跑一份代码** +(服务器一份、店里电脑一份),两边靠接口对齐。你只改了其中一份、 +或者改了字段名却没标出来,我们这边会**静默出不来图** —— 不报错、就是没图, +这种最难查。所以请务必标清楚。 + +--- + +## ⚠️ 三条纪律 + +1. **私有交付**:请勿外传、勿公开、勿镜像(含截图和片段)。 + 里面的**占位值**(域名、端口、路径、IP)请**保持原样**,不要替换成任何真实地址。 +2. **不要为了"跑起来"去补真实凭据**:这份代码**设计上就跑不起来**(见下), + 我们是给你**读**的,不是给你部署的。要看运行效果用 `模板/` 那三个工程。 +3. **有看不懂的先问再改**,别猜 —— 猜错的表现是"静默失效",不报错。 + +--- + +## 关于"跑不起来"这件事(不是疏漏,是刻意的) + +出站纪律要求:**任何离开我们机器的代码,先脱敏**。所以: + +- 站点/支付平台的**域名** → `example.com` 系列(RFC 2606 保留域,永远不会指向真站) +- **端口** → 中性数字(不是真端口) +- **目录、盘符路径** → `` / `` / `` 这类占位 +- **家里出口 IP、局域网 IP** → `` 这类占位 +- **密钥 / 令牌的值** → 代码里本来就**没有硬编码**(全走文件与环境变量),所以这一项是干净的 + +**保留未换的**(说明一下,免得你以为我们漏了): +- `localhost` —— 回环地址,通用值,不指向任何真实主机 +- `1000 / 1024 / 2048 / 4096` —— 是**出图分辨率**,业务常量,不是端口 +- **品牌笔名** —— 属公开署名,按我们的署名口径保留 + +--- + +## 关于 `模板/` 里那三个工程 + +渲染是**拿 Blender 模板工程 + 买家的皮肤贴图**渲出来的。要真跑一遍看效果, +你需要模板 —— 所以店主选了三个给你: + +| 文件 | 用途 | +|---|---| +| `1站立正反.blend` | 最基础的一个(站立,正反两面),**先用它把链路跑通** | +| `4海边自拍.blend` | 场景类的,带环境(测"场景重"的时候用) | +| `5不看爆炸.blend` | **另一个场景**(动感类),用来验证"换一个场景是不是也对" | + +> 三个合起来约 45MB。**名字前面那个数字就是模板编号**, +> 代码里 `TEMPLATES` 那张表就是靠编号对应的(一一对应,别改文件名)。 + +**渲染环境**:Blender 4.x,命令行后台模式(`-b --factory-startup`), +Windows 下用 `pythonw.exe` 起。具体参数看 `backend-tools/make_order.py` 顶部的用法说明。 + +--- + +## 我们的思路与方法(两份交接文档里各有一节详版) + +代码能看出"做了什么",看不出"为什么这么做、踩过什么坑"。所以两份交接文档里 +各加了一节**《我们的思路与方法》**,把这几样都摊开了,**请你连做法本身一起评**: + +- **给自己定的硬规矩** —— 例:正常买家一步都不许多加(防探测改动不能误伤付钱的人); + 收钱的数字一律以服务器为准;状态话术不许骗人;同一件事的逻辑只写一处。 +- **干活的方法** —— 例:改一处要顺着所有调用点核一遍;同一个东西存两处时, + 先问"读取方按哪个字段找";前端必须真在浏览器里点一遍(一批 bug 在接口层根本测不出来); + 部署完要核对"跑的是不是新代码"。 +- **付过学费的坑** —— 例:静默失败最贵(不报错、不崩、就是没效果); + 显示层会骗人(订单算对了但界面从另一个来源取数);"改完不生效"是这套系统最高频的坑。 + +每份最后还有**三个我们拿不准的"做法"**请你表态(要不要换技术栈、单机多单怎么设计、 +部署不生效有没有更稳的机制)。 + +> 我们更想要的是**对做法的批评**,不只是对某几行代码的。如果整套思路就是错的,请直说。 + +--- + +## 交付清单(自查用) + +- [x] 网站后端:`server.py` / `admin.py` / `pngcheck.py`,已脱敏 +- [x] 工具后端:19 个文件(含 `.bat` / `.ps1` / `.html` / 共用的 `skincheck.js` / Blender 脚本),已脱敏 +- [x] 两份交接文档(含《我们的思路与方法》) +- [x] 三个模板工程,已脱敏(等长替换,文件字节数未变) +- [x] 逐文件 SHA-256 清单(`交付清单.md`) +- [x] 机器逐类扫描:**0 命中**(域名含大小写变体 / 端口 / 各类路径 / IP / 邮箱 / 密钥特征 / + 分享链里夹的群号与授权参数 / 第三方人名 / 长数字串) +- [x] **独立第二双眼睛复查**(由另一个 agent 独立扫、不采信我们的自述结论) + —— **它抓出了 3 处我们漏的**(Windows 账户名从路径与 SSH 用户名两处漏出、 + 一处换过但仍像真路径的 `/srv`、一处把真端口换成了另一个像真端口的数) + **以及 2 处"引用了却没带上"的缺件**(共用的质检脚本、打包脚本),全部已修并复扫 0 命中。 +- [ ] **故意没带的**(不是漏):运行期的数据文件(卡密池、订单、皮肤、成品、心跳、 + 价格表、凭据文件等)—— 那些是**真实经营数据**,不在交付范围里。 diff --git a/backend/backend-site/admin.py b/backend/backend-site/admin.py new file mode 100644 index 0000000..f47be32 --- /dev/null +++ b/backend/backend-site/admin.py @@ -0,0 +1,537 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +金钻工坊 · 渲染下单 —— 管理工具(**只在本机跑**,不开公网入口) + + python3 admin.py gen 50 --batch 2026-09-30 --value 6 批量生成 50 个码(导出 CSV) + python3 admin.py gen 1 --tpl wheat --n-fix 3 张数卡密:这张码只能出 3 张 + python3 admin.py edit <卡密> --n-fix 5 / --unlimited / --lock-tpl / --off + 改一张还没用掉的卡密(张数/锁模板/停用) + python3 admin.py codes [--used|--unused] 看码库 + python3 admin.py ls [waiting|working|done|failed] 看订单 + python3 admin.py show <订单号> 看单详情 + python3 admin.py retry <订单号> 把单子退回队列重渲 + python3 admin.py calls 看「呼叫金钻」记录 + python3 admin.py sweep 清理超过保留期的成品 + python3 admin.py stat 概览 + python3 admin.py audit [行数] 看兑换码失败/被拒记录 +""" +import csv, json, os, shutil, sys, time +from datetime import datetime, timedelta + +sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) +import server as S # noqa: E402 + + +def cmd_gen(argv): + # ⚠️ 2026-10-01 实踩:`gen --help` 会被当成普通参数 → **直接生成 10 张真码**。 + # 管理工具绝不能"看个帮助就产生副作用"。 + if any(a in ("-h", "--help") for a in argv): + print("""gen 用法: + gen 50 生成 50 张(一张码一张图) + gen 20 --platform 爱发电 打平台标记(买家填码时会显示来源并预选模板) + gen 20 --n-fix 1 固定张数:这张码只能出 1 张 + gen 5 --n-free 不限张数 + gen 20 --unlimited --direct 不限张数 + 直发(不用确认收货,直接给原图) + gen 10 --tpl wheat 预选模板(买家填码自动勾上) + gen 20 --platform 爱发电 --n-fix 1 --export payplatform.txt + ★ 顺手导出「一行一码」纯文本,直接贴进爱发电的自动发货卡池""") + return 0 + n = int(argv[0]) if argv and argv[0].isdigit() else 10 + batch, value, platform, tpl, is_set, direct = "", 6, "", "", False, False + n_fix, n_max, lock_tpl, n_free, export = 0, 0, False, False, "" + for i, a in enumerate(argv): + if a == "--batch" and i + 1 < len(argv): + batch = argv[i + 1] + if a == "--value" and i + 1 < len(argv): + value = argv[i + 1] + # 第三方平台的标记:闲鱼 / B站工坊 …(金钻 2026-09-30) + # 买家填码时页面会显示「来自闲鱼 · 麦田萤火」并自动预选模板,不用他自己挑 + if a == "--platform" and i + 1 < len(argv): + platform = argv[i + 1] + # --export 文件名:导出一份「一行一码」的纯文本。 + # 金钻 2026-10-01(P4):爱发电的「自动发货」= 你填一池子卡密,买家付款它自己发一张。 + # 这里直接产出能整段粘进去的文本,省掉手工挑码。 + if a in ("--export", "--dlv") and i + 1 < len(argv): + export = argv[i + 1] + if a == "--tpl" and i + 1 < len(argv): + tpl = argv[i + 1] + # --set = 套装卡密:一张码管一整套(全部皮肤 × 全部模板) + if a == "--set": + is_set = True + # --direct = 金钻自己发的码(个人收款卖的):不用等确认收货,看完预览直接下 + if a == "--direct": + direct = True + # 张数卡密(金钻 2026-09-30 晚): + # --n-fix 3 → 这张码**只能出 3 张**(模板随便改,张数不能多也不能少) + # --n-max 10 → 最多 10 张(不限张数也可以封个顶) + # --lock-tpl → 码里带的模板锁死,买家不能改 + if a in ("--n-fix", "--n-max") and i + 1 < len(argv): + try: + if a == "--n-fix": + n_fix = int(argv[i + 1]) + else: + n_max = int(argv[i + 1]) + except ValueError: + print("❌ %s 要跟一个整数" % a) + return + if a == "--lock-tpl": + lock_tpl = True + # --unlimited → 不限张数(买家想出几张出几张;老规矩「一张码一张图」也解除) + if a == "--unlimited": + n_free = True + # --tpl 支持逗号分隔多个(套装卡密:一张码预选一组模板) + tpl_list = [x.strip() for x in tpl.split(",") if x.strip()] + bad = [x for x in tpl_list if x not in S.TPL_KEYS] + if bad: + print("❌ 模板 key 不认识:%s\n 可选:%s" % (",".join(bad), " / ".join(S.TPL_KEYS))) + return + tpl = ",".join(tpl_list) + if lock_tpl and not tpl: + print("❌ --lock-tpl 要跟 --tpl 一起用(没有模板,锁什么?)") + return + if n_free and n_fix: + print("❌「不限张数」和「固定张数」只能选一个") + return + made = S.gen_codes(n, batch, value, platform, tpl, is_set=is_set, direct=direct, + n_fix=n_fix, n_max=n_max, lock_tpl=lock_tpl, n_free=n_free) + stamp = S.now().strftime("%Y%m%d-%H%M%S") + out = os.path.join(S.ROOT, "exports", "codes-%s.csv" % stamp) + os.makedirs(os.path.dirname(out), exist_ok=True) + # ⚠️ 同一秒连开两批会撞名互相覆盖(2026-09-30 实踩)→ 撞了就在后面加 -2/-3 + n_dup = 1 + while os.path.exists(out): + n_dup += 1 + out = os.path.join(S.ROOT, "exports", "codes-%s-%d.csv" % (stamp, n_dup)) + with open(out, "w", newline="", encoding="utf-8-sig") as f: + w = csv.writer(f) + w.writerow(["兑换码", "面额", "批次", "平台", "模板", "固定张数", "不限张数", + "最多张数", "锁定模板"]) + for c in made: + w.writerow([c, value, batch, platform, tpl, n_fix or "", + "是" if n_free else "", n_max or "", "是" if lock_tpl else ""]) + print("已生成 %d 个兑换码(面额 ¥%s,批次 %s,平台 %s,模板 %s%s%s%s%s)" + % (len(made), value, batch or "-", platform or "-", tpl or "-", + ",★套装(一张管一整套)" if is_set else "", + ",◆直发(不用等收货)" if direct else "", + (",张数固定 %d 张" % n_fix) if n_fix + else ((",不限张数" if n_free else ",最多 %d 张" % n_max) if (n_free or n_max) else ",一张码一张图"), + ",🔒模板锁定不能改" if lock_tpl else "")) + for c in made: + print(" " + c) + print("\nCSV: %s" % out) + + # ---- 发卡文本(金钻 2026-10-01 P4:爱发电/闲鱼「自动发货」直接整段粘)---- + if export: + ex_dir = os.path.join(S.ROOT, "exports") + os.makedirs(ex_dir, exist_ok=True) + p = export if os.path.isabs(export) else os.path.join(ex_dir, export) + with open(p, "w", encoding="utf-8") as f: + f.write("\n".join(made) + "\n") + os.chmod(p, 0o640) + print(""" +发卡文本: %s (%d 行,一行一码,可直接整段粘贴) + ▸ 爱发电:创作中心 → 商品 → 编辑 → 发货方式「自动发货」→ 把那几行粘进去 → 保存 + 买家付款后爱发电自动发一张给他,他到 shop.example.com/order/ 点「卡密下单」填码就行 + ▸ 闲鱼/B站工坊:发货时复制一行发给买家 +⚠️ 这份文本等于钱,别发群里、别进公开仓库(已设 640 权限)""" % (p, len(made))) + return 0 + + +def cmd_codes(argv): + codes = S.load_codes() + flt = argv[0] if argv else "" + for c, v in sorted(codes.items()): + if flt == "--used" and not v.get("used"): + continue + if flt == "--unused" and v.get("used"): + continue + q = ("固定 %d 张" % v["n_fix"]) if v.get("n_fix") else \ + ("不限张数" if v.get("n_free") else (("最多 %d 张" % v["n_max"]) if v.get("n_max") else "1 码 1 张")) + stt = {"active": "可用", "bound": "已激活", "used": "已核销", + "inactive": "停用"}.get(S.code_state(v), "?") + tags = "%s%s%s%s" % ( + ("【%s】" % v["platform"]) if v.get("platform") else "", + ("【%s】" % v["tpl"]) if v.get("tpl") else "", + "🔒" if v.get("lock_tpl") else "", + "◆直发" if v.get("direct") else "") + print("%s %-6s 张数=%-8s %s 订单=%s %s" % ( + c, stt, q, tags, v.get("order") or "-", + v.get("ts") or v.get("bound_at") or "")) + stc = [S.code_state(v) for v in codes.values()] + print("\n合计 %d 张:可用 %d / 已激活 %d / 已核销 %d / 停用 %d" + % (len(codes), stc.count("active"), stc.count("bound"), + stc.count("used"), stc.count("inactive"))) + + +def cmd_edit(argv): + """改一张还没用掉的卡密(张数 / 锁定模板 / 直发 / 停用…)。 + + 金钻 2026-09-30 晚:「这个也给你开 api,方便我管理和你介入」 + 用法: + admin.py edit <卡密> --n-fix 5 固定出 5 张(不能多也不能少) + admin.py edit <卡密> --unlimited 改成不限张数 + admin.py edit <卡密> --n-max 20 封顶 20 张 + admin.py edit <卡密> --lock-tpl 模板锁死(要码里已有模板) + admin.py edit <卡密> --unlock-tpl 解锁模板 + admin.py edit <卡密> --tpl wheat,sakura 换一组模板 + admin.py edit <卡密> --off / --on 停用 / 启用 + """ + if not argv: + print(cmd_edit.__doc__) + return + code, p = argv[0], {} + for i, a in enumerate(argv): + nxt = argv[i + 1] if i + 1 < len(argv) else None + if a == "--n-fix" and nxt: + p["n_fix"] = nxt + elif a == "--n-max" and nxt: + p["n_max"] = nxt + elif a == "--unlimited": + p["unlimited"] = True + elif a == "--tpl" and nxt: + p["tpls"] = [x.strip() for x in nxt.split(",") if x.strip()] + elif a == "--lock-tpl": + p["lock_tpl"] = True + elif a == "--unlock-tpl": + p["lock_tpl"] = False + elif a == "--direct": + p["direct"] = True + elif a == "--no-direct": + p["direct"] = False + elif a == "--set": + p["set"] = True + elif a == "--no-set": + p["set"] = False + elif a == "--off": + p["state"] = "inactive" + elif a == "--on": + p["state"] = "active" + elif a == "--platform" and nxt: + p["platform"] = nxt + if not p: + print("没给要改什么 —— 看用法:") + print(cmd_edit.__doc__) + return + ok, e, info = S.edit_code(code, p) + if not ok: + print("❌ " + e) + return + print("✅ %s 改好了:张数 %s | 模板 %s%s | 直发 %s | 状态 %s" + % (info["code"], + (("固定 %d 张" % info["n_fix"]) if info["n_fix"] + else (("最多 %d 张" % info["n_max"]) if info["n_max"] else "不限")), + ",".join(info["tpls"]) or "自由选", + "(🔒锁定)" if info["lock_tpl"] else "", + "是" if info["direct"] else "否", info["state"])) + + +def cmd_ls(argv): + st = argv[0] if argv else None + rows = S.list_orders((st,) if st else None) + if not rows: + print("(没有订单)") + return + for m in sorted(rows, key=lambda x: x.get("created") or ""): + print("%-10s %-8s %-19s %d 张 %s %s" % ( + m["oid"], m.get("state"), m.get("created", ""), + len(m.get("templates") or []), m.get("arm"), + ",".join(m.get("templates") or []))) + print("\n共 %d 单" % len(rows)) + + +def cmd_show(argv): + if not argv: + sys.exit("用法: admin.py show <订单号>") + m = S.read_meta(argv[0]) + if not m: + sys.exit("没有这个订单") + m2 = dict(m) + m2.pop("token", None) + print(json.dumps(m2, ensure_ascii=False, indent=1)) + + +def cmd_retry(argv): + if not argv: + sys.exit("用法: admin.py retry <订单号>") + oid = argv[0] + m = S.read_meta(oid) + if not m: + sys.exit("没有这个订单") + m["state"] = "waiting" + m["note"] = "管理员退回重渲" + m["started"] = m["finished"] = None + S.write_meta(oid, m) + print("%s 已退回队列" % oid) + + +def cmd_calls(argv): + try: + for line in open(S.CALLS_FILE, encoding="utf-8"): + if line.strip(): + r = json.loads(line) + print("%s 订单=%s IP=%s %s" % (r["ts"], r.get("order") or "-", + r.get("ip"), "已通知" if r.get("notified") else "未通知")) + except OSError: + print("(没有呼叫记录)") + + +def cmd_sweep(argv): + """清过期成品 + **核销卡密**(金钻 2026-09-30 晚:「核销要等开放下载后 72 小时」)。 + + 到期口径改用 S.expire_at():确认收货/直发出图之后 72 小时(没开放下载的用创建时间兜底)。 + ⚠️ 删文件之前先把卡密核销 —— 否则文件没了、码还挂在「已激活」,账永远对不上。 + """ + n = freed = settled = 0 + for oid in list(os.listdir(S.ORDERS)): + d = os.path.join(S.ORDERS, oid) + m = S.read_meta(oid) + if not m: + continue + exp = S.expire_at(m) + if exp is None or exp > datetime.now(S.CST): + continue + settled += S.settle_codes(oid, "订单到期清理(开放下载满 %dh)" % S.KEEP_HOURS) + for root, _, files in os.walk(d): + for f in files: + try: + freed += os.path.getsize(os.path.join(root, f)) + except OSError: + pass + shutil.rmtree(d, ignore_errors=True) + n += 1 + # 文件还在、但开放下载已满 72 小时的,也一起核销 + settled += sum(x[1] for x in S.settle_due()) + print("清理 %d 单,释放 %.1f MB,核销卡密 %d 张" % (n, freed / 1048576, settled)) + + +def cmd_audit(argv): + n = int(argv[0]) if argv and argv[0].isdigit() else 40 + try: + lines = [l for l in open(S.LOG_FILE, encoding="utf-8").read().splitlines() + if ("兑换码失败" in l or "拒绝" in l)] + except OSError: + lines = [] + for l in lines[-n:]: + print(l) + print("\n共 %d 条异常记录" % len(lines)) + + +def cmd_activate(argv): + """网页下单:买家付了款,激活这一单 → 进队列开渲。""" + oid = (argv[0] if argv else "").strip().upper() + if not oid: + print("用法: activate <订单号>") + return + m = S.read_meta(oid) + if not m: + print("没有这个订单:%s" % oid) + return + st = m.get("state") + if st not in ("unpaid", "paid"): + print("订单 %s 现在是「%s」,不是待付款,没动它" % (oid, st)) + return + m["state"] = "waiting" + m["paid_at"] = S.now().isoformat(timespec="seconds") + with S.LOCK: + S.write_meta(oid, m) + print("✅ 订单 %s 已激活 → 进入排队" % oid) + print(" 模板:%s | 分辨率:%s | 码:%s" + % (",".join(m.get("templates") or []), m.get("res"), ",".join(m.get("codes") or []))) + + +def cmd_pending(argv): + """列出待付款的网页单(等你收钱激活的)""" + rows = S.list_orders(("unpaid", "paid")) + if not rows: + print("没有待付款 / 待激活的网页单") + return + for m in rows: + tag = "★买家已报付款" if m.get("state") == "paid" else "还没付款" + print("%s %-12s ¥%-5s %s 张 %s 码 %s" + % (m["oid"], tag, m.get("amount") or (S.PRICE_UNIT * len(m.get("templates") or [] or [1])), + len(m.get("templates") or []), ",".join(m.get("templates") or []), + ",".join(m.get("codes") or []))) + print("\n共 %d 单 —— 确认到账后跑:python3 admin.py activate <订单号>" % len(rows)) + + +def cmd_stat(argv): + codes = S.load_codes() + st = [S.code_state(v) for v in codes.values()] + print("卡密 %d 张(可用 %d / 已激活 %d / 已核销 %d / 停用 %d)" + % (len(codes), st.count("active"), st.count("bound"), + st.count("used"), st.count("inactive"))) + hb = S.heartbeat() + print("渲染机 %s 最后心跳 %s" % ("在线" if hb["online"] else "离线", hb["last_seen"])) + for st in ("unpaid", "paid", "waiting", "working", "done", "failed"): + print("订单 %-8s %d" % (st, len(S.list_orders((st,))))) + total = 0 + for root, _, files in os.walk(S.ROOT): + for f in files: + try: + total += os.path.getsize(os.path.join(root, f)) + except OSError: + pass + print("数据占用 %.1f MB" % (total / 1048576)) + + +def cmd_price(argv): + """价格档位(金钻 2026-10-01:「按张数和优惠设置专属购买价格链接」) + + 看: python3 admin.py price + 设: python3 admin.py price set 3 15 http + (第 3 档 = 买 3 张 ¥15,付款按钮就跳这个商品链接;链接可省 = 用总链接) + 删: python3 admin.py price rm 3 + 单价: python3 admin.py price per 6 (没配档位的张数按这个算) + """ + d = S.price_tiers() + tiers = d.get("tiers") or {} + if not argv: + print("单价(没配档位时):¥%g/张" % d["per"]) + print("%-6s %-8s %s" % ("张数", "价格", "专属商品链接")) + for k in sorted(tiers, key=lambda x: int(x) if x.isdigit() else 99): + t = tiers[k] or {} + print("%-6s ¥%-7s %s" % (k, t.get("price"), t.get("payplatform") or "(用总链接)")) + if not tiers: + print("(还没配任何档位)") + print("\n设一档:python3 admin.py price set 3 15 http") + return + sub = argv[0] + if sub == "per" and len(argv) > 1: + d["per"] = float(argv[1]) + elif sub == "set" and len(argv) > 2: + n, price = argv[1], argv[2] + if not n.isdigit() or int(n) < 1: + raise SystemExit("张数要正整数") + tiers[n] = {"price": float(price), "payplatform": (argv[3] if len(argv) > 3 else "").strip()} + elif sub == "rm" and len(argv) > 1: + tiers.pop(argv[1], None) + else: + raise SystemExit("用法:price / price per N / price set N 价格 [链接] / price rm N") + d["tiers"] = tiers + S.jsave(S.PRICES_FILE, d) + try: + os.chmod(S.PRICES_FILE, 0o644) + except OSError: + pass + print("改好了 —— 现在:") + cmd_price([]) + + +def cmd_gift(argv): + """福利券(金钻 2026-10-01「赛博鸡蛋」):一批**免费、免付费、只限张数**的码,买家自取。 + + 看: python3 admin.py gift + 开一批:python3 admin.py gift new 赛博鸡蛋 --count 50 --n-fix 1 + 加 --tpl sakura --lock → 只让领的人试这个新模板(试玩券) + 加 --days 7 → 7 天后自动收摊 + 加 --no-direct → 领到的券也要走「确认收货」才给原图(默认直发) + 补货:python3 admin.py gift add <批次id> --count 20 + 收摊:python3 admin.py gift off <批次id> (已领到手的券不受影响) + + ⚠️ 建/补/收的逻辑全在 server.py(gift_batch_new / gift_batch_add / gift_batch_off)—— + 金钻电脑上那块**面板**(ys_admin.py 的「免费码」区块)调的是同一批函数。 + **改规则只改 server.py 那一处**,别在这儿再写一遍(两边必漂移)。 + """ + + def show_all(): + rows = S.gift_batches()["batches"] # 每次现读:刚建/补完的批次要立刻看见 + if not rows: + print("(还没有福利券批次)") + return + print("%-16s %-16s %-6s %-6s %-8s %s" % ("批次", "名字", "总数", "已领", "还剩", "限制")) + for b in rows: + st = S.gift_stat(b["id"]) + lim = "%d 张/人" % int(b.get("each") or 1) + lim += ",锁模板 %s" % b["tpl"] if b.get("lock_tpl") else "" + lim += ",%s 到期" % b["expire"] if b.get("expire") else "" + if not b.get("enabled", True): + lim += "(已收摊)" + print("%-16s %-16s %-6d %-6d %-8d %s" + % (b["id"], b.get("name") or "", st["total"], st["claimed"], st["left"], lim)) + + if not argv: + show_all() + return + sub = argv[0] + if sub == "new" and len(argv) > 1: + name = argv[1] + op = {"count": 20, "n-fix": 1, "each": 1, "tpl": "", "lock": False, + "days": 0, "note": "", "direct": True, "kind": "render", "free": False} + i = 2 + while i < len(argv): + a = argv[i] + if a == "--count" and i + 1 < len(argv): + op["count"] = int(argv[i + 1]); i += 2 + elif a == "--n-fix" and i + 1 < len(argv): + op["n-fix"] = int(argv[i + 1]); i += 2 + elif a == "--each" and i + 1 < len(argv): + op["each"] = int(argv[i + 1]); i += 2 + elif a == "--tpl" and i + 1 < len(argv): + op["tpl"] = argv[i + 1]; i += 2 + elif a == "--days" and i + 1 < len(argv): + op["days"] = int(argv[i + 1]); i += 2 + elif a == "--note" and i + 1 < len(argv): + op["note"] = argv[i + 1]; i += 2 + elif a == "--lock": + op["lock"] = True; i += 1 + elif a == "--kind" and i + 1 < len(argv): + op["kind"] = argv[i + 1]; i += 2 # render/standee/keychain/poster… + elif a == "--n-free": + op["free"] = True; i += 1 # 不限张数 + elif a == "--no-direct": + op["direct"] = False; i += 1 + else: + i += 1 + try: + bid, codes = S.gift_batch_new( + name, count=op["count"], n_fix=op["n-fix"], n_free=op["free"], + tpl=op["tpl"], lock_tpl=op["lock"], days=op["days"], + note=op["note"], kind=op["kind"], direct=op["direct"], each=op["each"]) + except ValueError as e: + raise SystemExit(str(e)) + print("批次 id:%s(把这个贴给别人也行:福利页会自动列出来)" % bid) + print("生了 %d 张券。" % len(codes)) + show_all() + elif sub == "add" and len(argv) > 1: + bid = argv[1] + n, direct = 20, None + i = 2 + while i < len(argv): + if argv[i] == "--count" and i + 1 < len(argv): + n = int(argv[i + 1]); i += 2 + elif argv[i] == "--no-direct": + direct = False; i += 1 + elif argv[i] == "--direct": + direct = True; i += 1 + else: + i += 1 + try: + got = S.gift_batch_add(bid, n, direct=direct) + except ValueError as e: + raise SystemExit(str(e)) + print("补了 %d 张(批次 %s)" % (len(got), bid)) + show_all() + elif sub == "off" and len(argv) > 1: + try: + S.gift_batch_off(argv[1]) + except ValueError as e: + raise SystemExit(str(e)) + print("已收摊(已领到手的券照常用):%s" % argv[1]) + show_all() + else: + raise SystemExit("用法见文件头注释") + + +CMDS = {"gen": cmd_gen, "codes": cmd_codes, "ls": cmd_ls, "show": cmd_show, + "gift": cmd_gift, + "price": cmd_price, + "retry": cmd_retry, "calls": cmd_calls, "sweep": cmd_sweep, "stat": cmd_stat, + "audit": cmd_audit, "activate": cmd_activate, "pending": cmd_pending, + "edit": cmd_edit} + +if __name__ == "__main__": + if len(sys.argv) < 2 or sys.argv[1] not in CMDS: + print(__doc__) + sys.exit(1) + CMDS[sys.argv[1]](sys.argv[2:]) diff --git a/backend/backend-site/pngcheck.py b/backend/backend-site/pngcheck.py new file mode 100644 index 0000000..cc13c8b --- /dev/null +++ b/backend/backend-site/pngcheck.py @@ -0,0 +1,133 @@ +# -*- coding: utf-8 -*- +"""PNG 结构核验 —— 防「夹带私货」:有人在文件尾部或元数据块里塞任意数据, +改图看不出来,但能夹带任意字节(图片里藏文件 / 藏提示词 / 藏脚本)。 + +**只做结构判断,不解码像素** —— 零依赖、零成本、零误判。 + +判定分三档: + 拒(reject) + * 签名不对 / 没有 IHDR / 块结构损坏或截断 + * **IEND 之后还有字节** ← 最常见的尾部夹带 + * 未知的「关键块」(首字母大写且不在白名单)→ 后面可能跟着必须解析的语义 + * **APNG(acTL)** → 多帧能藏额外画面,剥掉 acTL 会留下孤儿 fcTL + 剥(strip,不算错) + * tEXt / zTXt / iTXt / eXIf / tIME → 元数据,很多编辑器会自动加,剥掉不影响成图 + 过(pass) + * IHDR / PLTE / IDAT / IEND / tRNS / gAMA / cHRM / sRGB / iCCP / bKGD / pHYs / sBIT + +⚠️ 这份逻辑在前端也有一份镜像(`skincheck.js` 的 `checkPngBytes`)。 + 两边必须一致 —— 前端负责**拦**(给人看的原因),后端负责**剥**(存下来的是干净字节)。 + 改一边记得改另一边,`tests/png_struct_test.py` 里有共享用例。 +""" + +import struct +import zlib + +SIG = b"\x89PNG\r\n\x1a\n" + +# 直接剥掉的辅助块(不报错) +STRIP = {b"tEXt", b"zTXt", b"iTXt", b"eXIf", b"tIME", b"sPLT", b"hIST"} + +# 允许出现的关键块 +CRITICAL_OK = {b"IHDR", b"PLTE", b"IDAT", b"IEND"} + +MAX_CHUNKS = 4096 # 防"超多小块"这种结构型 DoS + + +def scan(data): + """核验并清洗。 + + 返回 (ok, reason, clean_bytes, notes) + ok=False 时 clean 为 None + """ + notes = [] + + if not isinstance(data, (bytes, bytearray)): + return False, "数据格式不对", None, notes + data = bytes(data) + if len(data) < 8 + 25 or data[:8] != SIG: + return False, "不是 PNG 文件", None, notes + + off = 8 + out = bytearray(SIG) + n_chunks = 0 + seen_ihdr = False + seen_idat = False + seen_iend = False + + while off < len(data): + if n_chunks > MAX_CHUNKS: + return False, "PNG 结构异常(块数量过多)", None, notes + if off + 8 > len(data): + return False, "PNG 文件损坏(块头不完整)", None, notes + + (ln,) = struct.unpack(">I", data[off:off + 4]) + ctype = data[off + 4:off + 8] + end = off + 12 + ln + if ln > len(data) or end > len(data): + return False, "PNG 文件损坏(块数据不完整)", None, notes + + chunk = data[off:end] + n_chunks += 1 + + # CRC 自检(不一致只记一笔,不拒 —— 目标是防夹带,不是查完整性) + try: + want = struct.unpack(">I", chunk[-4:])[0] + got = zlib.crc32(chunk[4:-4]) & 0xFFFFFFFF + if want != got: + notes.append("块 %s 的 CRC 对不上" % ctype.decode("latin-1")) + except Exception: + pass + + if ctype == b"IHDR": + if len(out) != 8: + return False, "PNG 结构异常(IHDR 不在最前)", None, notes + seen_ihdr = True + out += chunk + + elif ctype == b"IEND": + seen_iend = True + tail = len(data) - end # ← 尾部夹带就在这里露馅 + if tail > 0: + return False, ("图片尾部夹带了 %d 字节额外数据(正常 PNG 到 IEND 就该结束)" % tail), None, notes + out += chunk + off = end + break + + elif ctype == b"acTL": + return False, "这是动画 PNG(APNG),请用普通静态 PNG", None, notes + + elif ctype == b"IDAT": + seen_idat = True + out += chunk + + elif ctype in (b"PLTE", b"tRNS", b"gAMA", b"cHRM", b"sRGB", b"iCCP", b"bKGD", b"pHYs", b"sBIT"): + out += chunk + + elif ctype in STRIP: + notes.append("已剥掉元数据块 %s" % ctype.decode("latin-1")) + + else: + critical = not (ctype[0] & 0x20) # PNG 规范:首字母大写 = 关键块 + if critical and ctype not in CRITICAL_OK: + return False, ("图片里有无法识别的内容块 %s" % ctype.decode("latin-1", "replace")), None, notes + notes.append("已剥掉附加块 %s" % ctype.decode("latin-1", "replace")) + + off = end + + if not seen_ihdr: + return False, "PNG 缺少 IHDR(不是完整图片)", None, notes + if not seen_idat: + return False, "PNG 缺少图像数据(IDAT)", None, notes + if not seen_iend: + return False, "PNG 没有正常结束(缺 IEND)", None, notes + + return True, "", bytes(out), notes + + +def size_of(data): + """只读 IHDR 拿宽高(不解码像素)。""" + if len(data) < 33 or data[:8] != SIG or data[12:16] != b"IHDR": + return None + w, h = struct.unpack(">II", data[16:24]) + return w, h diff --git a/backend/backend-site/server.py b/backend/backend-site/server.py new file mode 100644 index 0000000..d0ad6f9 --- /dev/null +++ b/backend/backend-site/server.py @@ -0,0 +1,3162 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +金钻工坊 · 渲染下单 —— 服务器端(订单登记 / 队列 / 兑换码 / 状态) + +设计要点 + * 纯标准库(http.server),零依赖、内存小 —— 这台机器只有 1.6G 内存 + * 队列就是文件系统:orders/<订单号>/meta.json 里 state 字段 = 状态 + * 渲染机主动出站拉单(宿主只能出站),服务器不主动连宿主 + * 管理操作全走本地 CLI(admin.py),**不开任何公网管理入口** + +监听 localhost:8080,由 nginx 反代 /order/api/ → 这里 +""" +import base64, subprocess, hashlib, hmac, json, os, random, re, secrets, shutil, struct, sys, tempfile, threading, time, zipfile +import urllib.request, urllib.error +from datetime import datetime, timedelta, timezone +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer +from urllib.parse import urlparse, parse_qs, unquote, quote + +ROOT = os.environ.get("YS_ROOT", "") +ORDERS = os.path.join(ROOT, "orders") +CODES_FILE = os.path.join(ROOT, "codes.json") +# 付款方式信息(爱发电链接 / 收款码图):金钻 2026-10-01 +PAYINFO_FILE = os.path.join(ROOT, "payinfo.json") +# ----------------------------------------------------------------- 爱发电 +# 金钻 2026-10-01:爱发电「自动发货 / 订单推送」对接。 +# 凭据放 /payplatform.json(640,www-data)—— 和 admin_token/worker_token 一个路子。 +# 为什么不验它的 RSA 签名:手头没有爱发电公钥,而**用开放接口反查这笔单**更硬 +# (查得到、状态=已付款、金额对得上,才发码)。社区 SDK 也是这么干的。 +PAYPLATFORM_CONF = os.path.join(ROOT, "payplatform.json") +PAYPLATFORM_MAP = os.path.join(ROOT, "payplatform-map.json") +PAYPLATFORM_LEDGER = os.path.join(ROOT, "payplatform-orders.json") # out_trade_no -> 记录(幂等:同一单重推不会重复发码) +PAYPLATFORM_LOG = os.path.join(ROOT, "payplatform-hook.log") + + +def payplatform_creds(): + try: + d = jload(PAYPLATFORM_CONF, {}) + return (d.get("user_id") or "").strip(), (d.get("token") or "").strip() + except Exception: + return "", "" + + +def payplatform_api(path, params=None): + """调爱发电开放接口。签名算法:md5(token + 'params' + params + 'ts' + ts + 'user_id' + user_id)。""" + uid, tok = payplatform_creds() + if not uid or not tok: + return {"ec": -1, "em": "没配爱发电凭据(/payplatform.json)"} + ps = json.dumps(params or {"page": 1}, ensure_ascii=False, separators=(",", ":")) + ts = str(int(time.time())) + sign = hashlib.md5(("%sparams%sts%suser_id%s" % (tok, ps, ts, uid)).encode("utf-8")).hexdigest() + body = json.dumps({"user_id": uid, "params": ps, "ts": int(ts), "sign": sign}).encode("utf-8") + req = urllib.request.Request("http" % path, data=body, + headers={"Content-Type": "application/json"}) + try: + with urllib.request.urlopen(req, timeout=20) as r: + return json.loads(r.read()) + except Exception as e: + return {"ec": -1, "em": "调用失败:%r" % e} + + +def payplatform_find_order(out_trade_no, pages=3): + """按订单号反查(确认这笔真的存在、真的付款了)。返回订单 dict 或 None。""" + for pg in range(1, pages + 1): + r = payplatform_api("query-order", {"page": pg}) + if r.get("ec") != 200: + return None + for o in ((r.get("data") or {}).get("list") or []): + if str(o.get("out_trade_no")) == str(out_trade_no): + return o + if pg >= int((r.get("data") or {}).get("total_page") or 1): + break + return None + + +def payplatform_img_count(order): + """这笔订单该发几张的码:先看规格名,再看金额,最后按 ÷单价 兜底。""" + m = jload(PAYPLATFORM_MAP, {}) or {} + sku_map = m.get("sku") or {} + amt_map = m.get("amount") or {} + for d in (order.get("sku_detail") or []): + nm = (d.get("name") or "").strip() + cnt = int(d.get("count") or 1) + if nm and nm in sku_map: + return max(1, int(sku_map[nm]) * cnt) + amt = str(order.get("show_amount") or order.get("total_amount") or "").strip() + try: + amt_f = float(amt) + except (TypeError, ValueError): + amt_f = 0.0 + if amt in amt_map: + return max(1, int(amt_map[amt])) + return max(1, int(round(amt_f / PRICE_UNIT)) or 1) + +HB_FILE = os.path.join(ROOT, "heartbeat.json") + + +def payplatform_paid(order): + """这笔爱发电订单**实际到手多少钱**(元)。金钻 2026-10-03 加的金额闸门用它。""" + try: + return float(str(order.get("show_amount") or order.get("total_amount") or "0").strip()) + except (TypeError, ValueError): + return 0.0 + + +def _yuan(x): + """把金额显示得像人话:20.0 → "20"、18.5 → "18.5"、0.1 → "0.1"。""" + try: + return "%g" % float(x) + except (TypeError, ValueError): + return str(x) + + + +CALLS_FILE = os.path.join(ROOT, "calls.jsonl") +# 每个模板「渲一张要多久」的历史样本(金钻 2026-10-04:给买家一个预计完成时间) +TPL_TIMES_FILE = os.path.join(ROOT, "tpl_times.json") +TOKEN_FILE = os.path.join(ROOT, "worker_token") +ADMIN_FILE = os.path.join(ROOT, "admin_token") # 管理后台令牌(金钻电脑上的面板用) +HB_IPS_FILE = os.path.join(ROOT, "home_ips.json") # 金钻家网络的出口 IP(渲染机心跳认出来的) +TMP_DIR = os.path.join(ROOT, "tmp") # 打包 zip 的临时目录(打完就删) +LOG_FILE = os.path.join(ROOT, "server.log") + +os.makedirs(ROOT, exist_ok=True) # 模块导入时就要保证目录存在(token 文件要写进去) + +HOST, PORT = "localhost", 8080 +KEEP_HOURS = 72 # 成品在服务器保留时长 +OFFLINE_AFTER = 1500 # 心跳超过这么多秒 = 离线 +# ⚠️ 必须 > 心跳间隔。渲染机 hb_every=600(10 分钟);1500 = 容许漏掉一次心跳, +# 否则网络抖一下就被误判离线。改 hb_every 必须一起改这里。 +# ⚠️ base64 会涨约 33%:10MB 的皮肤 → JSON 里约 13.4MB,所以请求体要留够 +MAX_BODY = 15 * 1024 * 1024 # 前台提交(含 base64 皮肤) +MAX_BODY_WK = 16 * 1024 * 1024 # 渲染机回传(一张成品一次) +MAX_SKIN = 10 * 1024 * 1024 # 单个皮肤文件上限(金钻 2026-10-02:4MB → 10MB) +MIN_SIDE, MAX_SIDE = 16, 4096 # 皮肤分辨率不是固定的:64 是基准,128/256/512/1024 都是 64 网格的整倍数放大 + +# 出图分辨率(金钻 2026-09-30):默认 1000 = 网易我的世界头图标准分辨率。 +# 4096 一张要渲约 10 分钟,所以高峰期让它**让路给后面的小单**,免得一张大图堵住一整队。 +ALLOWED_RES = (1000, 1024, 2048, 4096) +DEFAULT_RES = 1000 +HEAVY_RES = 4096 # 视为"重单"的分辨率 +HEAVY_WAIT_MIN = 30 # 重单最多让路这么久,超过就按到达顺序正常排(防饿死) +MAX_IMAGES = 10 # 一单最多几张 +STALE_MIN = 45 # 渲染机领单后超过这么久没交回 → 自动退回队列 +# 打包下载(金钻 2026-09-30「文件下载允许打包下载…挨个下太慢了」): +# zip 先落临时文件再边读边发,**不进内存**(这台机器只有 1.6G,MemoryMax=256M)。 +MAX_ZIP_BYTES = 600 * 1024 * 1024 # 一单成品合计超过这个数就拒绝打包,让他分开下 +ZIP_CHUNK = 64 * 1024 + +CST = timezone(timedelta(hours=8)) +LOCK = threading.Lock() +# 臂型中文名(小票/页面文案用,和前端 ARMTXT 保持一致) +ARMTXT = {"classic": "粗臂", "slim": "细臂", "auto": "自动判定"} + +# ---- 防滥用(金钻 2026-09-30 提出"会不会被暴力破解")---- +# 结论:码空间 31^12≈7.9e17,盲猜命中率 ~1e-15,**暴破本身打不进来**; +# 真正的风险是「刷接口 / 灌图占盘 / 拿订单号试探」。所以守这几条: +IP_FAILS = {} # ip -> [失败时间戳] 兑换码连续输错 → 冷却 +IP_SUBS = {} # ip -> [提交时间戳] 同一 IP 提交频率 +IP_SKINS = {} # ip -> [追补皮肤时间戳] 追补单独一档(买家可能一次补好几张皮肤) +FAIL_WIN = 600 # 失败统计窗口(秒) +FAIL_MAX = 15 # 窗口内失败上限 → 冷却 +FAIL_COOL = 900 # 冷却时长(秒) +SUB_WIN = 600 # 提交统计窗口 +SUB_MAX = 6 # 窗口内最多提交几单(正常买家够用) +DISK_FLOOR = 1024**3 # 剩余空间低于 1G 不再收新单 + +# 服务条款版本(2026-09-30 金钻定)。⚠️ 条款文案一改,这里必须跟着改 —— +# 订单里记下版本号,日后争议时才能证明"买家当时同意的是哪一版"。 +# 合法模板 key(与下单页 / 渲染机三方一致;airship 不是 air!) +TPL_KEYS = ("stand", "standb", "wheat", "beach", "boom", "sakura", "airship") +PRICE_UNIT = 6 # 一张图 ¥(金钻定,用于网页单计额) +# ----------------------------------------------------------------- 价格档位 +# 金钻 2026-10-01:「我想根据张数和优惠来设置针对的专属购买价格链接」 +# → 每档 = 张数 → {价格, 对应的爱发电商品链接}。买 3 张想给优惠价/专属链接,就写这一档。 +# 页面上「应付」和「去爱发电付款」按钮会**按买家选的张数自动切到对应档**。 +# 没配的档 = 按 PRICE_UNIT × 张数 算。 +PRICES_FILE = os.path.join(ROOT, "prices.json") +FEEDBACK_DIR = os.path.join(ROOT, "feedback") # 买家反馈(可带图) +# ----------------------------------------------------------------- 福利券(赛博鸡蛋) +# 金钻 2026-10-01:「偶尔搞点福利,发点渲染券 —— 不定期投送兑换码,**待激活**的,不需要付费 +# 就能领取,只限制张数、自由拿取;或者我开新模板,他们可以领来渲(限张数和次数)。」 +# → 券池 = 一批已激活、免付费的码;买家在福利页**自取**(先到先得),领到的码拿去「卡密下单」。 +GIFTS_FILE = os.path.join(ROOT, "gifts.json") + + +def gift_batches(): + """福利券批次(列表)。每条: + id/name/note/total/each/expire/enabled/created + n_fix(可出几张)/ tpl(锁定的模板 key,逗号分隔)/ lock_tpl(是否锁死模板) + kind(券的种类:render=渲染图 / standee=立牌 / keychain=钥匙扣 / …未来扩展) + shape(版式:square/横版 portrait…留字段,先不用) + """ + d = jload(GIFTS_FILE, {}) + if not isinstance(d, dict) or not isinstance(d.get("batches"), list): + d = {"batches": []} + return d + + +GIFT_KINDS = {"render": "渲染图", "standee": "立牌", "keychain": "钥匙扣", "poster": "海报"} + + +def gift_stat(bid): + """一批券的领取情况:总数 / 已领 / 还剩""" + cs = load_codes() + total = used = 0 + for c, r in cs.items(): + if r.get("gift") == bid: + total += 1 + if r.get("claim_token"): + used += 1 + return {"total": total, "claimed": used, "left": max(0, total - used)} + + +def gift_view(): + """给买家看的券池。**分三段**(金钻 2026-10-02:「没有了就变灰,点进去说已领完/暂无发放; + 有就显示剩余张数」): + open = 还能领的(带剩余张数) + gone = 领完了的 + closed = 收摊/过期的 + """ + today = now().strftime("%Y-%m-%d") + out = {"open": [], "gone": [], "closed": []} + for b in gift_batches()["batches"]: + st = gift_stat(b["id"]) + kind = b.get("kind") or "render" + item = {"id": b["id"], "name": b.get("name") or "福利券", "note": b.get("note") or "", + "each": 1, # 金钻定死:每设备 + 每 IP 各一张 + "n_max": int(b.get("n_fix") or 1), # 福利券口径:**最多**这么多张(可以少) + "n_fix": int(b.get("n_fix") or 1), # 兼容旧字段名 + "n_free": bool(b.get("n_free")), + "tpl": b.get("tpl") or "", "lock_tpl": bool(b.get("lock_tpl")), + "kind": kind, "kind_name": GIFT_KINDS.get(kind, kind), + "shape": b.get("shape") or "square", + "leave": st["left"], "total": st["total"], "expire": b.get("expire") or ""} + if not b.get("enabled", True): + item["why"] = "已收摊" + out["closed"].append(item) + elif b.get("expire") and str(b["expire"]) < today: + item["why"] = "已过期" + out["closed"].append(item) + elif st["left"] <= 0: + item["why"] = "已领完" + out["gone"].append(item) + else: + out["open"].append(item) + return out + + +def gift_public(): + """兼容老调用:只要"还能领的"那些""" + return gift_view()["open"] + + + +def gift_claim_days(): + """福利券领到后**多久必须用掉**(金钻 2026-10-02:领了不用要逾期)""" + try: + return max(1, int((jload(GIFTS_FILE, {}) or {}).get("claim_days") or 7)) + except (TypeError, ValueError): + return 7 + + +def gift_expire_text(iso_ts): + """把过期时间说成人话:还有 3 天 5 小时 / 已过期。""" + if not iso_ts: + return "" + try: + left = datetime.fromisoformat(iso_ts) - now() + except (TypeError, ValueError): + return "" + sec = int(left.total_seconds()) + if sec <= 0: + return "已过期" + d, h, m = sec // 86400, (sec % 86400) // 3600, (sec % 3600) // 60 + if d: + return "还有 %d 天 %d 小时" % (d, h) + if h: + return "还有 %d 小时 %d 分" % (h, m) + return "还有 %d 分钟" % max(1, m) + + +def coupon_status(c): + """一张券现在什么状态(给"我的卡券"用)。返回 dict。""" + cs = load_codes() + rec = cs.get(c) + if not rec: + return {"code": c, "status": "unknown", "text": "查不到这张券"} + st = code_state(rec) + exp = rec.get("claim_expire") or "" + # 老券(领的时间早于"逾期"功能上线)也要有到期时间:按 claim_ts + 默认天数补算 + if not exp and rec.get("claim_ts"): + try: + exp = (datetime.fromisoformat(rec["claim_ts"]) + + timedelta(days=gift_claim_days())).isoformat(timespec="seconds") + except (TypeError, ValueError): + exp = "" + left = gift_expire_text(exp) if exp else "" + if st == "used": + return {"code": c, "status": "used", "text": "已核销(成品也过期了)"} + if st == "bound": + return {"code": c, "status": "used", "text": "已用" + ("(订单 %s)" % rec.get("order") if rec.get("order") else "")} + if st == "inactive": + return {"code": c, "status": "unpaid", "text": "未激活(等付款)"} + if exp and left == "已过期": + return {"code": c, "status": "expired", "text": "已过期(领了没用掉)"} + kind = GIFT_KINDS.get(rec.get("gift_kind") or "", "") + # 到期时间要**写出来**(金钻 2026-10-02:「没标记过期时间」)—— + # 光说"还有 6 天"不够,得让他知道到底哪天几点到期 + exp_h = exp.replace("T", " ")[:16] if exp else "" + return {"code": c, "status": "ok", + "text": ("可以用" + (",%s 到期(%s)" % (exp_h, left) if exp_h else "")), + "expire_h": exp_h, + "n_max": int(rec.get("n_max") or rec.get("n_fix") or 1), + "n_free": bool(rec.get("n_free")), "tpl": rec.get("tpl") or "", + "lock_tpl": bool(rec.get("lock_tpl")), "kind_name": kind, + "expire": exp, "left": left} + + +def gift_claim(bid, token, ip): + """领一张:返回 (ok, 结果或错误信息)。 + + ⚠️ 规则(金钻 2026-10-01 定死:**每个设备 + 每个 IP 各只能领一张**,都是防刷的,别改): + · 同一批次:**每台设备 1 张**(设备标识存 localStorage,叫 GIFT_KEY) + · 同一批次:**每个 IP 1 张**(换了浏览器/清了缓存也一样拦得住) + · 先到先得 —— 剩 0 就没了,不补 + 换一批(比如新模板试玩)就是新的一轮,还能再领一张 ✔ + """ + tok = re.sub(r"[^0-9A-Za-z_-]", "", str(token or ""))[:40] + if not tok: + return False, "领不了:页面标识丢了,刷新一下再试" + bs = gift_batches()["batches"] + b = next((x for x in bs if x.get("id") == bid), None) + if not b or not b.get("enabled", True): + return False, "这一批福利已经收摊了" + today = now().strftime("%Y-%m-%d") + if b.get("expire") and str(b["expire"]) < today: + return False, "这批券过期了" + with LOCK: + cs = load_codes() + mine = [c for c, r in cs.items() if r.get("gift") == bid and r.get("claim_token") == tok] + if mine: + return False, "你已经领过啦 —— 这批每人限一张 😉 想多要就等下一波福利" + ip_n = len([c for c, r in cs.items() + if r.get("gift") == bid and r.get("claim_ip") == ip]) + if ip_n: + return False, "这台设备/这个网络已经领过了 —— 这批每人限一张" + pool = [c for c, r in cs.items() + if r.get("gift") == bid and not r.get("claim_token") and code_state(r) == "active"] + if not pool: + return False, "手慢了 —— 这批已经被领完啦" + pick = random.choice(pool) + cs[pick]["claim_token"] = tok + cs[pick]["claim_ip"] = ip + cs[pick]["claim_ts"] = now().isoformat(timespec="seconds") + # 领了要**用掉**:X 天内有效(金钻 2026-10-02:领了不用要逾期,逾期要提示还剩多久) + _days = gift_claim_days() + cs[pick]["claim_expire"] = (now() + timedelta(days=_days)).isoformat(timespec="seconds") + cs[pick]["gift_kind"] = b.get("kind") or "render" + jsave(CODES_FILE, cs) + log("福利券 %s 被领走:%s(%s)" % (bid, pick, ip)) + rec = load_codes().get(pick) or {} + mx = int(rec.get("n_max") or rec.get("n_fix") or 1) + _exp = (load_codes().get(pick) or {}).get("claim_expire") or "" + return True, {"code": pick, "n_max": mx, "n_fix": mx, + "free": bool(rec.get("n_free")), + "tpl": rec.get("tpl") or "", "lock_tpl": bool(rec.get("lock_tpl")), + "expire": _exp, "expire_text": gift_expire_text(_exp), + "left": gift_stat(bid)["left"]} + + +# ---------------------------------------------------- 福利券批次的 建/补/收 +# 金钻 2026-10-02:面板(金钻日常用的那块)也要能开/管免费码 —— 原来是 admin.py CLI 独有。 +# ⚠️ 逻辑只写这一处:admin.py 的 `gift new/add/off` 和面板的 /api/admin/gift/* 都调这里。 +# 两边各写一遍必然漂移(这库里的血泪教训)。 +GIFT_ID_ALPH = "abcdefghijkmnpqrstuvwxyz23456789" + + +def gift_batch_new(name, count=20, n_fix=1, n_free=False, tpl="", lock_tpl=False, + days=0, note="", kind="render", direct=True, each=1): + """建一批福利券(顺带把券一起生成了)。返回 (批次id, 新码列表);参数不对 raise ValueError。 + + 金钻 2026-10-01「赛博鸡蛋」:一批**免费、免付费、只限张数**的码,买家在福利页自取。 + * n_fix > 0 → **最多**出 n_fix 张(可以少,见 gift_batch_add 的注释) + * n_free → 不限张数 + * tpl + lock_tpl → 锁死模板(试玩券) + * days → N 天后自动收摊 + * kind → 券的种类:render=渲染图 / standee=立牌 / … + """ + name = (name or "").strip()[:40] + if not name: + raise ValueError("批次得有个名字") + try: + count = int(count) + except (TypeError, ValueError): + raise ValueError("张数不合法") + if not (1 <= count <= 500): + raise ValueError("一批 1~500 张") + try: + n_fix = int(n_fix or 0) + except (TypeError, ValueError): + raise ValueError("张数不合法") + if n_fix < 0 or n_fix > MAX_IMAGES: + raise ValueError("最多张数要在 0~%d 之间" % MAX_IMAGES) + if n_free and n_fix: + raise ValueError("「不限张数」和「最多 N 张」只能选一个") + tpls = [x.strip() for x in str(tpl or "").split(",") if x.strip()] + bad = [x for x in tpls if x not in TPL_KEYS] + if bad: + raise ValueError("模板不认识:%s" % "、".join(bad)) + if lock_tpl and not tpls: + raise ValueError("要锁模板,得先选模板") + kind = (kind or "render").strip()[:20] or "render" + try: + days = max(0, int(days or 0)) + except (TypeError, ValueError): + days = 0 + # ⚠️ 只按秒取 id 会撞车(同一秒建两批 → 同一个 id,券和批次全串了,2026-10-02 实踩)→ 补 3 个随机位 + bid = "g" + time.strftime("%m%d%H%M%S") + "".join( + random.choice(GIFT_ID_ALPH) for _ in range(3)) + d = gift_batches() + d["batches"].append({ + "id": bid, "name": name, "note": (note or "").strip()[:200], + "n_fix": n_fix, "n_free": bool(n_free), "kind": kind, + "each": max(1, int(each or 1)), "tpl": ",".join(tpls), + "lock_tpl": bool(lock_tpl) and bool(tpls), + "expire": (time.strftime("%Y-%m-%d", time.localtime(time.time() + days * 86400)) + if days else ""), + "enabled": True, "direct": bool(direct), + "created": now().isoformat(timespec="seconds"), + }) + jsave(GIFTS_FILE, d) + codes = gift_batch_add(bid, count, direct=direct) + log("福利券批次建好 %s「%s」%d 张(%s)" % ( + bid, name, len(codes), "不限张数" if n_free else "最多 %d 张" % n_fix)) + return bid, codes + + +def gift_batch_add(bid, count=20, direct=None): + """给现有批次补货(再生成 N 张)。返回新码列表;批次不存在/张数不对 raise ValueError。 + + direct=None → 沿用建批次时的直发设置(老批次没这个字段 → 默认直发)。 + """ + d = gift_batches() + b = next((x for x in d["batches"] if x.get("id") == bid), None) + if not b: + raise ValueError("没有这个批次:%s" % bid) + try: + count = int(count) + except (TypeError, ValueError): + raise ValueError("张数不合法") + if not (1 <= count <= 500): + raise ValueError("一次补 1~500 张") + if direct is None: + direct = bool(b.get("direct", True)) + # ⚠️ 福利券用 **n_max(最多 N 张、可以少)**,不用 n_fix(必须正好)—— + # 金钻 2026-10-02:「限可选数量的…指定张数内的,可以多张皮肤凑」。 + # 用 n_fix 的话,提交时(只有 1 张皮肤)就会被"必须正好 3 张"拦住,永远用不了。 + got = gen_codes(count, batch="福利-%s" % (b.get("name") or bid), value=0, + platform="福利", tpl=b.get("tpl") or "", + n_max=0 if b.get("n_free") else int(b.get("n_fix") or 1), + n_free=bool(b.get("n_free")), direct=bool(direct), + lock_tpl=bool(b.get("lock_tpl"))) + cs = load_codes() + for c in got: + cs[c]["gift"] = bid + jsave(CODES_FILE, cs) + log("福利券批次 %s 补货 %d 张" % (bid, len(got))) + return got + + +def gift_batch_off(bid): + """收摊(已领到手的券不受影响)。批次不存在 raise ValueError。""" + d = gift_batches() + b = next((x for x in d["batches"] if x.get("id") == bid), None) + if not b: + raise ValueError("没有这个批次:%s" % bid) + b["enabled"] = False + jsave(GIFTS_FILE, d) + log("福利券批次 %s 已收摊" % bid) + return b + + +def gift_admin_view(claims_limit=300, pool_limit=500): + """面板用:批次全貌 + 领取情况(谁在什么时候、哪个 IP 领了哪张)+ 剩余券池。 + + 统计一律复用 gift_stat(),不另写一套(会和买家看到的数不一致)。 + pool = 还没被领走的券 —— 面板每张卡上的「复制发卡文本」用它。 + """ + today = now().strftime("%Y-%m-%d") + cs = load_codes() + out = [] + for b in gift_batches()["batches"]: + st = gift_stat(b["id"]) + claims, pool = [], [] + for c, r in cs.items(): + if r.get("gift") != b["id"]: + continue + if r.get("claim_token"): + claims.append({"code": c, "ts": r.get("claim_ts") or "", + "ip": r.get("claim_ip") or "", + "state": code_state(r), "order": r.get("order") or ""}) + elif code_state(r) == "active": + pool.append(c) + claims.sort(key=lambda x: x["ts"] or "", reverse=True) + pool.sort() + kind = b.get("kind") or "render" + out.append({ + "id": b["id"], "name": b.get("name") or "福利券", "note": b.get("note") or "", + "each": int(b.get("each") or 1), "n_fix": int(b.get("n_fix") or 1), + "n_free": bool(b.get("n_free")), "tpl": b.get("tpl") or "", + "lock_tpl": bool(b.get("lock_tpl")), "kind": kind, + "kind_name": GIFT_KINDS.get(kind, kind), + "expire": b.get("expire") or "", "enabled": bool(b.get("enabled", True)), + "created": b.get("created") or "", + "expired": bool(b.get("expire") and str(b["expire"]) < today), + "total": st["total"], "claimed": st["claimed"], "left": st["left"], + "n_claims": len(claims), "claims": claims[:claims_limit], + "n_pool": len(pool), "pool": pool[:pool_limit], + }) + out.sort(key=lambda x: x.get("created") or "", reverse=True) + return {"ok": True, "batches": out, "tpl_keys": list(TPL_KEYS), + "kinds": GIFT_KINDS, "claim_days": gift_claim_days()} + + +def price_tiers(): + """读价格档位表。结构:{"per": 6, "tiers": {"1": {"price": 6, "payplatform": "..."}, ...}}""" + d = jload(PRICES_FILE, {}) or {} + if not isinstance(d.get("tiers"), dict): + d["tiers"] = {} + try: + d["per"] = float(d.get("per") or PRICE_UNIT) + except (TypeError, ValueError): + d["per"] = float(PRICE_UNIT) + return d + + +def price_for(n_img, tiers=None): + """n 张图该收多少(有档位用档位价,没有就按单价×张数)。""" + n = max(1, int(n_img or 1)) + t = (tiers or price_tiers()).get("tiers") or {} + rec = t.get(str(n)) + if isinstance(rec, dict) and rec.get("price") not in (None, ""): + try: + return int(round(float(rec["price"]))) + except (TypeError, ValueError): + pass + per = (tiers or price_tiers()).get("per") or PRICE_UNIT + return int(round(float(per) * n)) + + +def payplatform_link_for(n_img): + """n 张图该跳哪个爱发电商品;这档没配就回落到总链接。""" + t = (price_tiers().get("tiers") or {}).get(str(max(1, int(n_img or 1)))) + if isinstance(t, dict) and (t.get("payplatform") or "").strip(): + return t["payplatform"].strip() + d = jload(PAYINFO_FILE, {}) or {} + return (d.get("payplatform") or "").strip() +TERMS_VERSION = "2026-10-04.1" + + +def _recent(bucket, ip, win): + now_t = time.time() + lst = [t for t in bucket.get(ip, []) if now_t - t < win] + if lst: + bucket[ip] = lst + else: + bucket.pop(ip, None) + return lst + + +def ip_of(handler): + return (handler.headers.get("X-Real-IP") or handler.client_address[0] or "?").strip() + + +def too_many_fails(ip): + return len(_recent(IP_FAILS, ip, FAIL_WIN)) >= FAIL_MAX + + +def note_fail(ip): + IP_FAILS.setdefault(ip, []).append(time.time()) + + +def submit_allowed(ip): + return len(_recent(IP_SUBS, ip, SUB_WIN)) < SUB_MAX + + +def note_submit(ip): + IP_SUBS.setdefault(ip, []).append(time.time()) + + +def skin_allowed(ip): + """追补皮肤单独限流:10 分钟 20 次(一个买家补十张皮肤也够用)。""" + return len(_recent(IP_SKINS, ip, SUB_WIN)) < 20 + + +def note_skin(ip): + IP_SKINS.setdefault(ip, []).append(time.time()) + + +def order_rank(m): + """派单顺序(金钻 2026-09-30:「高峰阶段 4096 版本可能要延后排队」)。 + + 返回 (优先级, 到达时间),小的先派。 + * 普通单 → (0, created):按到达顺序,先来先渲 + * 重单(4096) → (1, created):先让路给后面的小单 + * 但重单等够 HEAVY_WAIT_MIN 之后恢复 (0, created) —— 它是队列里最早的, + 所以立刻会被派走。**任何情况下都不会被饿死**,这条必须有。 + """ + try: + created = datetime.fromisoformat(m.get("created")) + except (TypeError, ValueError): + created = now() - timedelta(days=365) # 时间坏了就当最老的,别把它卡死 + try: + heavy = int(m.get("res") or DEFAULT_RES) >= HEAVY_RES + except (TypeError, ValueError): + heavy = False + if heavy and (now() - created) < timedelta(minutes=HEAVY_WAIT_MIN): + return (1, created) + return (0, created) + + +def disk_ok(): + try: + return shutil.disk_usage(ROOT).free > DISK_FLOOR + except OSError: + return True +CODE_RE = re.compile(r"^YS-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$") +OID_ALPH = "23456789ABCDEFGHJKMNPQRSTUVWXYZ" # 去掉 0O1IL 等易混字符 + + +# ----------------------------------------------------------------- 小工具 +def now(): + return datetime.now(CST) + + +def log(*a): + line = "[%s] %s" % (now().strftime("%Y-%m-%d %H:%M:%S"), " ".join(str(x) for x in a)) + try: + with open(LOG_FILE, "a", encoding="utf-8") as f: + f.write(line + "\n") + except OSError: + pass + print(line, flush=True) + + +def jload(path, default): + try: + with open(path, encoding="utf-8") as f: + return json.load(f) + except (OSError, ValueError): + return default + + +def jsave(path, obj): + tmp = path + ".tmp" + with open(tmp, "w", encoding="utf-8") as f: + json.dump(obj, f, ensure_ascii=False, indent=1) + os.replace(tmp, path) + + +def worker_token(): + try: + t = open(TOKEN_FILE, encoding="utf-8").read().strip() + if t: + return t + except OSError: + pass + t = secrets.token_hex(24) + with open(TOKEN_FILE, "w", encoding="utf-8") as f: + f.write(t) + os.chmod(TOKEN_FILE, 0o600) + return t + + +WT = worker_token() + + +def admin_token(): + """管理令牌(金钻电脑上那块后台面板用)。和 worker_token 一个路子: + 文件在 /admin_token,600 权限,不在代码里、不进 git。""" + try: + t = open(ADMIN_FILE, encoding="utf-8").read().strip() + if t: + return t + except OSError: + pass + t = secrets.token_hex(24) + with open(ADMIN_FILE, "w", encoding="utf-8") as f: + f.write(t) + os.chmod(ADMIN_FILE, 0o600) + return t + + +AT = admin_token() + +HOME_IPS = (jload(HB_IPS_FILE, {}) or {}).get("ips") or [] # 重启后还记得上次认出的出口 IP + + +def note_home_ip(ip): + """记下渲染机的出口 IP。管理接口靠它把门 —— 公网别处扫到也是 403。""" + global HOME_IPS + if not ip or ip in ("?", "localhost"): + return + HOME_IPS = ([ip] + [x for x in HOME_IPS if x != ip])[:6] + + +def admin_ip_ok(ip): + """后门:本机回环永远放行(等于原来的 admin.py 本地 CLI)。""" + return ip in ("localhost", "::1", "localhost", "?") or ip in HOME_IPS + + +def new_oid(): + return "YS" + "".join(random.choice(OID_ALPH) for _ in range(6)) + + +def new_owner_token(): + return "".join(random.choice(OID_ALPH) for _ in range(14)) + + +# ----------------------------------------------------------------- 兑换码 +def load_codes(): + return jload(CODES_FILE, {}) + + +def gen_codes(n, batch="", value=6, platform="", tpl="", state="active", is_set=False, direct=False, + n_fix=0, n_max=0, lock_tpl=False, n_free=False): + """批量生成兑换码,返回新码列表 + + n_fix / n_max / lock_tpl = 金钻 2026-09-30 晚要的「张数卡密」: + * n_fix>0 → 这张码**只能出这么多张**(多一张少一张都不行),模板随便改 + * n_max>0 → 最多这么多张(通常「不限张数」再封个顶) + * n_free → **不限张数**(买家想出几张出几张,最多到单张上限 MAX_IMAGES) + * lock_tpl → 码里带的模板**锁死**,买家不能改(只出这套) + ⚠️ n_free 必须显式给:老规矩「一张码 = 一张图」还在,不能靠 n_fix=0 推。 + """ + with LOCK: + codes = load_codes() + made = [] + while len(made) < n: + c = "YS-" + "-".join( + "".join(random.choice(OID_ALPH) for _ in range(4)) for _ in range(3)) + if c in codes: + continue + # platform/tpl = 第三方平台的标记(闲鱼/B站工坊…)+ 预选模板;金钻 2026-09-30 + # state: active=能直接用 / inactive=等付款激活 / used=已核销 + codes[c] = {"used": False, "order": None, "ts": None, + "batch": batch, "value": value, + "platform": platform, "tpl": tpl, "state": state, + # 套装卡密(金钻 2026-09-30):一张码管**一整套**(全部皮肤 × 全部模板), + # 不是「一码一张图」。code_info 会把它带出去给前端。 + "set": bool(is_set), + # direct = 金钻自己发的码(不是平台单):**不用等确认收货**, + # 看完 512 预览就能直接下原图(2026-09-30 金钻定) + "direct": bool(direct), + # 张数 / 模板锁定(金钻 2026-09-30 晚) + "n_fix": int(n_fix or 0), "n_max": int(n_max or 0), + "lock_tpl": bool(lock_tpl), "n_free": bool(n_free)} + made.append(c) + jsave(CODES_FILE, codes) + return made + + +def code_state(rec): + """码的状态。兼容老记录(只有 used 布尔)。 + + 金钻 2026-09-30 晚把生命周期拆成三段: + active 可用 + bound **已激活** —— 提交订单那一刻(卡密的张数已被这一单占用,不能再用) + used **已核销** —— 终态:成品「开放下载」之后满 72 小时(见 settle_due) + inactive 停用(等付款) + ⚠️ 别把 bound 说成「已核销」:买家刚提交完就看到「已核销」会以为货已经交完了。 + """ + st = rec.get("state") + if st in ("active", "inactive", "used", "bound"): + return st + return "used" if rec.get("used") else "active" + + +def code_info(raw): + """查一个码 —— 给前端做「预填模板」。返回 dict 或 None。 + + ⚠️ 会回传 oid/token(已核销的码 = 买家的取件凭证)。码本身是 31^12 的随机串, + 暴力猜不中,所以可以这么用;但**不返回别的订单信息**。 + """ + c = (raw or "").strip().upper() + if not CODE_RE.match(c): + return None + rec = (load_codes() or {}).get(c) + if not rec: + return None + st = code_state(rec) + # tpl 可能是多个(套装:逗号分隔),统一回成列表给前端预选 + raw_tpl = (rec.get("tpl") or "") + tpls = [x.strip() for x in raw_tpl.split(",") if x.strip()] + out = {"ok": True, "code": c, "state": st, "set": bool(rec.get("set")), + "tpls": tpls, "direct": bool(rec.get("direct")), + "platform": rec.get("platform") or "", "tpl": rec.get("tpl") or "", + "batch": rec.get("batch") or "", "used": st == "used", + # 张数 / 模板锁定(金钻 2026-09-30 晚:「生成一个只能标记渲染多少个的卡密, + # 他可以自由修改,但是不能超过也不能少于这个数量」) + "n_fix": int(rec.get("n_fix") or 0), # >0 = 必须正好这么多张;0 = 不限 + "n_max": int(rec.get("n_max") or 0), # >0 = 最多这么多张(不限张数的码也可封顶) + "lock_tpl": bool(rec.get("lock_tpl")), # True = 模板锁定,买家不能改 + "n_free": bool(rec.get("n_free"))} # True = 不限张数(买家想出几张出几张) + # 已激活 / 已核销都回 oid+token —— 卡密本身就是取件凭证,点一下就带去订单页 + if st in ("used", "bound") and rec.get("order"): + m = read_meta(rec["order"]) + if m: + out["oid"] = rec["order"] + out["token"] = m.get("token") or "" + out["bound_at"] = rec.get("bound_at") + out["settled_at"] = rec.get("ts") + return out + + +def note_tpl_time(tpl, sec): + """记一张图的渲染耗时(按模板存最近 50 条)。渲染机在 /finish 里带上来的。""" + try: + sec = float(sec) + except (TypeError, ValueError): + return + if not tpl or sec <= 0 or sec > 3600: + return + try: + d = json.load(open(TPL_TIMES_FILE, encoding="utf-8")) + if not isinstance(d, dict): + d = {} + except Exception: + d = {} + arr = list(d.get(tpl) or []) + arr.append(round(sec, 1)) + d[tpl] = arr[-50:] + try: + tmp = TPL_TIMES_FILE + ".tmp" + with open(tmp, "w", encoding="utf-8") as f: + json.dump(d, f, ensure_ascii=False) + os.replace(tmp, TPL_TIMES_FILE) # 原子替换,断电不会写坏 + except OSError: + pass + + +def tpl_eta_sec(templates, n_img=1): + """这单大概要渲多久:按模板历史耗时求和;没样本的模板按每张 60 秒兜底,再加 20 秒收尾。""" + try: + d = json.load(open(TPL_TIMES_FILE, encoding="utf-8")) + if not isinstance(d, dict): + d = {} + except Exception: + d = {} + per = [] + for t in (templates or []): + a = sorted(x for x in (d.get(t) or []) if isinstance(x, (int, float))) + per.append(float(a[len(a) // 2]) if a else 60.0) # 中位数 + if not per: + per = [60.0] * max(1, int(n_img or 1)) + # 金钻 2026-10-04:「预计时间可以稍微夸大」—— 宁可信里说久一点。 + # 买家提前看到图是惊喜,等超了才是投诉。 + return int(sum(per) * 1.25) + 45 + + +def codes_rules(codes_list): + """汇总一单里几张卡密对「张数 / 模板」的限制(金钻 2026-09-30 晚)。 + + 张数口径 = **出图张数 = 皮肤数 × 模板数**(和金额、img_total 同一套算)。 + * n_fix:带固定张数的卡密,张数**必须正好等于它们的和**(不能多也不能少) + * n_max:带封顶的卡密,张数不能超过它们的和 + * lock_tpl:任一卡密锁了模板 → 提交的模板必须**正好是那一组**(不能增删) + """ + cs = load_codes() or {} + n_fix = n_max = 0 + any_fix = any_max = any_free = False + locks = [] + for c in codes_list or []: + r = cs.get((c or "").strip().upper()) or {} + if r.get("n_free"): + any_free = True + try: + f = int(r.get("n_fix") or 0) + x = int(r.get("n_max") or 0) + except (TypeError, ValueError): + f = x = 0 + if f > 0: + any_fix = True + n_fix += f + if x > 0: + any_max = True + n_max += x + if r.get("lock_tpl") and (r.get("tpl") or "").strip(): + locks.append([y for y in str(r["tpl"]).split(",") if y]) + return {"n_fix": (n_fix if any_fix else None), + "n_max": (n_max if any_max else None), + "n_free": any_free, + "lock_tpl": (locks[0] if locks else None)} + + +def check_rules(rl, n_img, templates): + """按规则校验张数与模板。返回错误文案或 None。""" + if rl.get("lock_tpl"): + want = set(rl["lock_tpl"]) + got = set(templates or []) + if rl.get("n_fix"): + # 带固定张数时可以只用锁定组里的**一部分**:金钻 2026-10-01 —— + # 两张皮肤都出「麦田萤火」= 2 张,也是合理用法(只要模板都在锁定组里) + if not got or not got.issubset(want): + return ("这张卡密锁定了模板,只能从 %s 里挑(现在选了 %s)" + % ("、".join(rl["lock_tpl"]), "、".join(templates or []) or "空")) + elif got != want: + return ("这张卡密锁定了模板,不能改:只能出 %s(现在选的是 %s)" + % ("、".join(rl["lock_tpl"]), "、".join(templates or []) or "空")) + if rl.get("n_fix") and int(n_img) != int(rl["n_fix"]): + return ("这张卡密固定出 %d 张,现在算下来是 %d 张 —— 出图张数 = 皮肤数 × 模板数," + "要正好等于 %d 张" % (rl["n_fix"], n_img, rl["n_fix"])) + if rl.get("n_max") and int(n_img) > int(rl["n_max"]): + return "这张卡密最多出 %d 张,现在算下来是 %d 张" % (rl["n_max"], n_img) + return None + + +def activate_order_paid(oid, code=None, source=""): + """**付款确认后激活这一单**(金钻 2026-10-01 定的状态机)。 + + 网页提交 → 发一张兑换码,状态 = `inactive`(**未激活**) + 付款确认 → 激活:订单进队列 + 那张码转 `bound`(**已激活**) + 开放下载满 72h → 转 `used`(**已核销**) + + ⚠️ 只有"钱到了"才能调这里 —— 别让买家点一下就把未激活的码变成能渲的单。 + 返回 (ok, msg)。 + """ + m = read_meta(oid) + if not m: + return False, "没有这个订单" + if m.get("state") not in ("unpaid", "paid"): + return False, "订单现在是「%s」,不用再激活" % m.get("state") + if code and code not in (m.get("codes") or []): + m["codes"] = (m.get("codes") or []) + [code] + m["state"] = "waiting" + m["paid_at"] = now().isoformat(timespec="seconds") + m["activated_by"] = source or "付款确认" + with LOCK: + write_meta(oid, m) + burn_codes(m.get("codes") or [], oid) # 未激活 → 已激活 + log("订单 %s 付款确认 → 激活进队列(%s)" % (oid, m["activated_by"])) + return True, "ok" + + +def redeem(codes_in): + """校验一批码;全部可用才通过。返回 (ok, err, codes_out)""" + with LOCK: + codes = load_codes() + seen, good = set(), [] + for raw in codes_in: + c = (raw or "").strip().upper() + if not CODE_RE.match(c): + return False, "卡密格式不对:%s" % c, None + if c in seen: + return False, "同一张卡密重复提交:%s" % c, None + seen.add(c) + rec = codes.get(c) + if rec is None: + return False, "卡密不存在:%s" % c, None + st = code_state(rec) + if st == "used": + return False, "这张卡密已经核销了(用过了):%s" % c, None + if st == "bound": + return False, ("这张卡密已经用来下过单了:%s —— 去「凭票取图」填卡密就能回到那一单" + % c), None + if st == "inactive": + return False, "这张卡密还没激活(网页下单的要等付款后激活):%s" % c, None + _exp = rec.get("claim_expire") or "" + if _exp and st == "active": + try: + overdue = datetime.fromisoformat(_exp) < now() + except (TypeError, ValueError): + overdue = False + if overdue: + return False, ("这张福利券过期了(领了没用掉)—— 找金钻要一张新的吧:%s" % c), None + good.append(c) + return True, None, good + + +def burn_codes(codes_list, oid): + """把卡密绑到订单上 —— ⚠️ 这只算**激活**,不是核销(金钻 2026-09-30 晚: + 「点击最后的提交才算激活;核销要等开放下载后 72 小时」)。 + + 激活后这张码不能再用于别的单,但状态还是 bound;等成品开放下载满 72 小时 + (或订单文件到期被清)才由 settle_codes() 转成 used(真·核销)。 + """ + with LOCK: + codes = load_codes() + for c in codes_list: + if c in codes: + codes[c]["state"] = "bound" + codes[c]["used"] = False + codes[c]["order"] = oid + codes[c]["bound_at"] = now().isoformat(timespec="seconds") + jsave(CODES_FILE, codes) + + +def settle_codes(oid, why=""): + """把这一单绑定的卡密**核销**(终态)。返回核销了几张。 + + 触发点(见 expire_at / settle_due / admin.py sweep): + * 成品「开放下载」之后满 72 小时 + * 订单文件到期被清(一直没确认收货的情况) + """ + n = 0 + with LOCK: + codes = load_codes() + for c, r in codes.items(): + if r.get("order") == oid and code_state(r) == "bound": + r["state"] = "used" + r["used"] = True + r["ts"] = now().isoformat(timespec="seconds") + if why: + r["settled"] = why + n += 1 + if n: + jsave(CODES_FILE, codes) + return n + + +def open_at(m): + """这单「开放下载」的时刻 —— 核销/保留期都从这儿起算(金钻 2026-09-30 晚)。 + + 确认收货单 = accepted_at(买家点了「确认收货」);直发单 = 渲完就能下,取 finished。 + 还没开放下载 → None。 + """ + if m.get("accepted_at"): + return m["accepted_at"] + if m.get("direct"): + return m.get("finished") or m.get("created") + return None + + +def expire_at(m): + """成品在服务器的到期时刻 = **开放下载之后 72 小时**;还没开放下载的先用创建时间兜底。 + + ⚠️ 老口径是「创建后 72 小时」:买家第 70 小时才点确认收货的话,文件两小时后就被清了, + 跟金钻说的「开放下载后 72 小时」对不上 —— 所以改成按开放下载顺延。 + """ + base = open_at(m) or m.get("created") + try: + return datetime.fromisoformat(base) + timedelta(hours=KEEP_HOURS) + except (TypeError, ValueError): + return None + + +def settle_due(talk=False): + """扫一遍:已经「开放下载满 72 小时」的订单,把它的卡密核销掉。返回 [(oid, 张数)]。 + + 只核销**文件还在**的单 —— 文件被清时由 sweep 顺手核销(命令在 admin.py)。 + """ + out = [] + for m in list_orders(("done",)): + exp = expire_at(m) + if exp and exp <= now(): + n = settle_codes(m["oid"], "开放下载满 %d 小时" % KEEP_HOURS) + if n: + out.append((m["oid"], n)) + if talk: + log("核销卡密 %s:%d 张(%s)" % (m["oid"], n, "开放下载满 72h")) + return out + + +# ----------------------------------------------------------------- 订单 +def order_dir(oid): + return os.path.join(ORDERS, oid) + + +def read_meta(oid): + p = os.path.join(order_dir(oid), "meta.json") + if not os.path.exists(p): + return None + return jload(p, None) + + +def write_meta(oid, meta): + jsave(os.path.join(order_dir(oid), "meta.json"), meta) + + +def list_orders(states=None): + out = [] + if not os.path.isdir(ORDERS): + return out + for oid in sorted(os.listdir(ORDERS)): + m = read_meta(oid) + if m and (states is None or m.get("state") in states): + out.append(m) + return out + + +import pngcheck # PNG 结构核验(防夹带)—— 同目录,零依赖 + + +def png_size(data): + """从 PNG 头读宽高,零依赖""" + if len(data) < 24 or data[:8] != b"\x89PNG\r\n\x1a\n": + return None + w, h = struct.unpack(">II", data[16:24]) + return w, h + + +def skins_of(m): + """取订单的皮肤列表。**兼容老订单**:以前只有一张 skin.png + 订单级 arm。 + + 多皮肤(金钻 2026-09-30):一张单可以有多张皮肤,每张**各自一个臂型** + (A 可能是 Steve 粗臂、B 可能是 Alex 细臂),出图 = 皮肤 × 模板 的组合。 + """ + sk = m.get("skins") + if sk: + return sk + # 老订单:没有 skins 字段,用旧的单皮肤字段凑一个 + return [{ + "id": "s1", + "fileName": m.get("fileName") or "skin.png", + "arm": m.get("arm") or "classic", + "arm_auto": m.get("arm_auto"), + "arm_certain": bool(m.get("arm_certain")), + "skin_size": m.get("skin_size") or [], + "path": "skin.png", + "added": m.get("created"), + }] + + +def skin_tpls(m, sk=None): + """某张皮肤要出的模板。**金钻 2026-10-01 纠正的口径**: + 「我可能这个皮肤用了这个模板,另一个皮肤用那个模板…怎么做乘法」 + → 每张皮肤各自带一份模板清单(skins[i].tpls)。 + 老单/没写 tpls 的,退回订单级 templates(单皮肤时结果一样)。""" + t = (sk or {}).get("tpls") + if t: + return list(t) + return list(m.get("templates") or []) + + +def sync_voucher_nfix(m): + """把「网页下单」那张取件凭证码的张数,同步成订单当前的实际张数(金钻 2026-10-01)。""" + cds = [c for c in (m.get("codes") or [])] + if not cds: + return + with LOCK: + cs = load_codes() + hit = False + for c in cds: + rec = cs.get(c) + if rec and rec.get("batch") == "网页下单": + rec["n_fix"] = img_total(m) + hit = True + if hit: + jsave(CODES_FILE, cs) + + +def img_total(m): + """这张单一共要出几张图 = **各皮肤自己挑的模板加起来**(不是皮肤数 × 模板数)""" + n = sum(len(skin_tpls(m, sk)) for sk in skins_of(m)) + return max(1, n) + + +def tpl_union(m): + """订单用到的模板并集(去重、保持顺序)—— 卡密锁定校验、页面展示用""" + out = [] + for sk in skins_of(m): + for k in skin_tpls(m, sk): + if k not in out: + out.append(k) + return out or list(m.get("templates") or []) + + +def queue_pos(oid): + """排队位置(前面还有几单)""" + waiting = [m["oid"] for m in list_orders(("waiting", "working"))] + try: + return waiting.index(oid) + 1 + except ValueError: + return 0 + + +# ⚠️ 金钻 2026-09-30:状态查询要冷却,别被刷爆。 +# 页面正常 10 分钟查一次;有人来了(打开页面 / 点刷新)可以马上查一次, +# 但服务器**每分钟最多真算一次** —— 再多的请求也就是读个缓存,几乎零成本。 +# ===== 预览闸门(金钻 2026-09-30)===== +# 渲染完先给 **512 水印预览**;买家点「确认收货」才放原图。 +# 预览由**服务器**生成(不是渲染机)—— 渲染机那边不用多装任何东西。 +PREVIEW_MAX = 512 +WM_FONT = "/usr/share/fonts/opentype/noto/NotoSerifCJK-Bold.ttc" +WM_TEXT = "预览图" # 金钻:简单加个水印,表示是预览展示图 + +STATUS_TTL = 60 # 冷却:同一结果 60 秒内复用 +_status_cache = {"t": 0.0, "v": None} + + +def status_cache_clear(): + """渲染机刚上报心跳 → 让状态立刻变准,别让买家看到过期的"离线"。""" + _status_cache["v"] = None + + +def make_preview(oid, png_path, out_name, idx=0): + """把交付图缩成 512 的水印预览(JPEG),返回相对路径;失败返回 None。 + + ⚠️ 用 ffmpeg 单线程处理**单张图**是安全的 —— 服务器禁的是视频转码(会爆内存)。 + 这里 512×512、-threads 1,实测 2 秒、内存无变化。 + """ + if not os.path.exists(WM_FONT): + log("⚠️ 找不到水印字体,跳过预览生成") + return None + # ⚠️ 中文名会被替换成下划线 → 「麦田萤火.png」和「海边自拍.png」都变 prev_____.jpg 撞名! + # 所以**必须带上序号**(2026-09-30 实踩:同单两个模板的预览会互相覆盖) + dst_rel = "out/prev_%02d.jpg" % int(idx) + dst = os.path.join(order_dir(oid), dst_rel) + parts = ["scale=%d:%d" % (PREVIEW_MAX, PREVIEW_MAX)] + for gy in (26, 188, 350): # 3×3 平铺,肉眼一眼看出是预览 + for gx in (12, 174, 336): + parts.append("drawtext=fontfile=%s:text='%s':fontsize=30:fontcolor=white@0.30:x=%d:y=%d" + % (WM_FONT, WM_TEXT, gx, gy)) + parts.append("drawtext=fontfile=%s:text='shop.example.com':fontsize=15:fontcolor=white@0.45:" + "x=w-text_w-10:y=h-text_h-8" % WM_FONT) + try: + r = subprocess.run(["ffmpeg", "-y", "-loglevel", "error", "-threads", "1", + "-i", png_path, "-vf", ",".join(parts), "-q:v", "4", dst], + capture_output=True, timeout=120) + if r.returncode != 0 or not os.path.exists(dst): + log("⚠️ 预览生成失败:%s" % (r.stderr or b"")[-200:].decode("utf-8", "replace")) + return None + except Exception as e: + log("⚠️ 预览生成异常 %r" % e) + return None + return dst_rel + + +def heartbeat(force=False): + """渲染机在线状态。结果缓存 STATUS_TTL 秒。 + + 这个结果对所有人**完全一样**(全局状态),所以缓存不会串味。 + """ + c = _status_cache + if (not force) and c["v"] is not None and (time.monotonic() - c["t"]) < STATUS_TTL: + return c["v"] + hb = jload(HB_FILE, {}) + last = hb.get("ts") + online = False + if last: + try: + online = (now() - datetime.fromisoformat(last)).total_seconds() < OFFLINE_AFTER + except ValueError: + online = False + v = {"online": online, "last_seen": last, "host": hb.get("host"), + "queue": len(list_orders(("waiting",))), + "working": len(list_orders(("working",)))} + c["t"], c["v"] = time.monotonic(), v + return v + + +def edit_code(c, patch): + """改一张还没用掉的卡密。返回 (ok, 错误文案, info)。 + + ⚠️ 逻辑只写这一份:HTTP 的管理接口(面板)和本机 admin.py CLI 都调它 —— + 两边各写一遍迟早漂移(这是本项目的头号 bug 来源)。 + """ + c = (c or "").strip().upper() + cs = load_codes() + if c not in cs: + return False, "没有这张卡密:%s" % c, None + if code_state(cs[c]) == "used": + return False, ("这张卡密已经用掉了(订单 %s),改不了 —— 要改请用 admin.py 直接动订单" + % (cs[c].get("order") or "")), None + r = cs[c] + p = patch or {} + if "tpls" in p: + bad = [t for t in (p.get("tpls") or []) if t not in TPL_KEYS] + if bad: + return False, "模板不认识:%s" % "、".join(bad), None + r["tpl"] = ",".join(p["tpls"]) + for k in ("set", "direct", "lock_tpl"): + if k in p: + r[k] = bool(p[k]) + if ("n_fix" in p) or ("n_max" in p) or p.get("unlimited"): + # ⚠️ 只改其中一个时,另一个要**沿用原值** —— 否则「只改封顶」会把固定张数抹成 0 + # (自测实测:n_fix=3 的码 + patch{n_max:2} 被静默改成不限张数) + cur_fix, cur_max = int(r.get("n_fix") or 0), int(r.get("n_max") or 0) + try: + if p.get("unlimited"): + n_fix, n_max = 0, 0 + else: + n_fix = int(p["n_fix"]) if "n_fix" in p else (0 if p.get("free") else cur_fix) + n_max = int(p["n_max"]) if "n_max" in p else cur_max + except (TypeError, ValueError): + return False, "张数不合法", None + if n_fix > MAX_IMAGES or n_max > 100: + return False, "张数不合法(固定张数最多 %d 张)" % MAX_IMAGES, None + if n_fix and n_max and n_max < n_fix: + return False, "封顶不能小于固定张数", None + r["n_fix"], r["n_max"] = n_fix, n_max + if p.get("unlimited"): + r["n_free"] = True # 不限张数(老规矩「一张码一张图」也一并解除) + if "free" in p: + r["n_free"] = bool(p["free"]) + if p["free"]: + r["n_fix"] = 0 + if p.get("state") in ("active", "inactive"): + r["state"] = p["state"] + for k in ("platform", "batch"): + if k in p: + r[k] = str(p[k] or "")[:20] + if r.get("lock_tpl") and not (r.get("tpl") or "").strip(): + return False, "要锁定模板,得先给这张码带模板", None + with LOCK: + jsave(CODES_FILE, cs) + log("改卡密 %s → %s" % (c, json.dumps({k: r.get(k) for k in + ("tpl", "set", "direct", "lock_tpl", "n_fix", "n_max", "state", "platform")}, + ensure_ascii=False))) + return True, None, code_info(c) + + +# ----------------------------------------------------------------- HTTP +def receipt_lines(oid, m): + """整单**收货凭证(小票)** —— 金钻 2026-10-01 P3。 + + 两个用处:① 成品 zip 里随包那份 ② 订单页「看小票 / 复制」(闲鱼对账、留证都用得上)。 + ⚠️ 排版是给**手机窄屏**看的:整宽 W=42 个半角位(≈21 个汉字),一行超了就会横向滚动 + (2026-10-01 实测「保存期限」那行被截断)。加字段前先数一下宽度。 + """ + W = 42 + sk = skins_of(m) + lines = ["=" * W, + " 金钻工坊 · 自助模板渲染", + " 收 货 凭 证", + "=" * W, + "订单号 %s" % oid] + cds = m.get("codes") or [] + if cds: + lines.append("卡密 %s" % "、".join(cds)) + for i, x in enumerate(sk): + sz = x.get("skin_size") or [] + bits = [ARMTXT.get(x.get("arm"), x.get("arm") or "")] + if sz: + bits.append("×".join(str(v) for v in sz)) + lines.append("%s%s" % ("皮肤 " if i == 0 else " ", + "%s(%s)" % (x.get("fileName") or "皮肤%s" % (i + 1), + " ".join(b for b in bits if b)))) + lines.append("出图 %d 张" % img_total(m)) + lines.append(" 每张两版:标准 + 无压缩") + files = m.get("files") or [] + for i, f in enumerate(files): + try: + fsz = os.path.getsize(os.path.join(order_dir(oid), f.get("path") or "")) + except OSError: + fsz = 0 + who = "" + for x in sk: + if x.get("id") == f.get("skin"): + who = (x.get("fileName") or "").replace(".png", "") + break + lines.append(" %02d. %-18s %6s %s" % (i + 1, (f.get("name") or "")[:18], + ("%.1fMB" % (fsz / 1048576.0)) if fsz else "", + who[:8])) + lines.append("分辨率 %d px" % int(m.get("res") or DEFAULT_RES)) + lines.append("提交时间 %s" % (m.get("created") or "")) + lines.append("完成时间 %s" % (m.get("finished") or "")) + seq = m.get("seq") or (m.get("seqs") or [None])[0] + if seq: + lines.append("留档序号 %03d" % int(seq)) + lines.append("条款版本 %s" % TERMS_VERSION) + ex = expire_at(m) + if ex: + lines.append("保存期限 %s" % ex.astimezone(CST).strftime("%Y-%m-%d %H:%M")) + lines.append(" 下载后 72 小时自动清理") + lines.append("反馈 shop.example.com/order/ → 呼叫金钻") + lines.append("-" * W) + lines.append("本站只提供渲染服务;皮肤内容与渲染") + lines.append("结果的合规性由提供者负责、后果自担。") + lines.append("模板质量问题请联系金钻维护。") + return lines + + +def receipt_text(oid, m): + return "\n".join(receipt_lines(oid, m)) + "\n" + + +class H(BaseHTTPRequestHandler): + server_version = "ys-order" + protocol_version = "HTTP/1.1" + + def log_message(self, fmt, *args): # 静音(access 由 nginx 记) + pass + + # ---- 响应helper ---- + def _send(self, code, body=b"", ctype="application/json; charset=utf-8", extra=None): + self.send_response(code) + self.send_header("Content-Type", ctype) + self.send_header("Content-Length", str(len(body))) + self.send_header("Cache-Control", "no-store") + for k, v in (extra or {}).items(): + self.send_header(k, v) + self.end_headers() + if body and self.command != "HEAD": + self.wfile.write(body) + + def js(self, obj, code=200): + self._send(code, json.dumps(obj, ensure_ascii=False).encode(), "application/json; charset=utf-8") + + def err(self, msg, code=400): + self.js({"ok": False, "error": msg}, code) + + def body_json(self, limit=None): + n = int(self.headers.get("Content-Length") or 0) + if n <= 0 or n > (limit or MAX_BODY): + return None + try: + return json.loads(self.rfile.read(n).decode("utf-8")) + except (ValueError, UnicodeDecodeError): + return None + + def is_worker(self): + return hmac.compare_digest(self.headers.get("X-Worker-Token") or "", WT) + + # ---- 路由 ---- + def do_GET(self): + u = urlparse(self.path) + p, q = u.path, parse_qs(u.query) + try: + if p == "/api/status": + # ?fresh=1 → 跳过 60 秒缓存,现算(页面上的「刷新」按钮用这个)。 + # ⚠️ 不加的话:渲染机刚上线,用户连刷几次都还是缓存的「离线」(金钻 2026-10-01 反馈) + return self.js({"ok": True, **heartbeat(force=bool(q.get("fresh")))}) + + # 查码:给前端预填模板用(闲鱼/B站码带平台+模板标记) + m = re.match(r"^/api/code/([A-Za-z0-9\-]+)$", p) + if m: + info = code_info(m.group(1)) + if not info: + return self.js({"ok": False, "error": "没有这个兑换码"}) + return self.js(info) + + m = re.match(r"^/api/order/([A-Z0-9]+)$", p) + if m: + return self.order_detail(m.group(1), (q.get("t") or [""])[0]) + + # 轻量心跳:只回「状态 + 进度」,别的什么都不算 —— 前端敢几秒问一次 + # (金钻 2026-10-04:「进度条和中间态没有即时刷新」) + m = re.match(r"^/api/tick/([A-Z0-9]+)$", p) + if m: + return self.tick(m.group(1), (q.get("t") or [""])[0]) + + m = re.match(r"^/api/dl/([A-Z0-9]+)/(\d+)$", p) + if m: + return self.download(m.group(1), int(m.group(2)), (q.get("t") or [""])[0], q) + + # 渲染机取皮肤:/api/skin/(老,=第一张)或 /api/skin// + m = re.match(r"^/api/skin/([A-Z0-9]+)(?:/([A-Za-z0-9_-]+))?$", p) + if m: + if not self.is_worker(): + return self.err("forbidden", 403) + return self.skin(m.group(1), m.group(2) or "s1") + + # 打包下载(金钻 2026-09-30):整单原图打一个 zip,买家一次拖走 + m = re.match(r"^/api/zip/([A-Z0-9]+)$", p) + if m: + return self.download_zip(m.group(1), (q.get("t") or [""])[0]) + + # 付款方式(爱发电链接 / 收款码):页面「去付款」按钮读它 + if p == "/api/payinfo": + return self.payinfo() + # 福利券池(免费领的那种,金钻 2026-10-01「赛博鸡蛋」) + if p == "/api/gift": + return self.js({"ok": True, "view": gift_view(), + "batches": gift_public()}) # batches 保留:老页面/老调用还在用 + + # 收货凭证 / 小票(金钻 2026-10-01 P3):页面「看小票」用纯文本,?dl=1 当附件下载 + m = re.match(r"^/api/receipt/([A-Z0-9]+)$", p) + if m: + return self.receipt(m.group(1), (q.get("t") or [""])[0], bool(q.get("dl"))) + + # ---- 管理接口(金钻电脑上的后台面板)---- + if p.startswith("/api/admin/"): + if not self.admin_gate(): + return self.err("forbidden", 403) + if p == "/api/admin/ping": + return self.admin_ping() + if p == "/api/admin/orders": + return self.admin_orders(q) + if p == "/api/admin/codes": + return self.admin_codes(q) + if p == "/api/admin/gifts": + return self.admin_gifts() + + return self.err("not found", 404) + except Exception as e: + log("GET %s 异常 %r" % (p, e)) + return self.err("server error", 500) + + def do_POST(self): + u = urlparse(self.path) + p = u.path + try: + # 领一张福利券(免费、免付费、只限张数) + if p == "/api/gift/claim": + return self.gift_take() + # 我领过/买过的券,现在什么状态(页面负责把这些券存在浏览器里) + if p == "/api/my-coupons": + return self.my_coupons() + # 买家自助免费重渲(每单一次) + if p == "/api/redo": + return self.redo() + # 问题反馈(可带图,金钻 2026-10-02)—— 取代原来的 mailto + if p == "/api/feedback": + return self.feedback() + # 爱发电「自动发货」回调(金钻 2026-10-01)—— 地址填在爱发电开发者页 + if p == "/api/payplatform-hook": + return self.payplatform_hook() + # 用平台发来的卡密激活「网页填过的那一单」(金钻 2026-10-01: + # 网页填完 → 跳爱发电付款 → 回来填码激活,**填过的内容不许白填**) + if p == "/api/activate": + return self.activate() + # 认证没下来、拿不到码时:直接用**爱发电订单号**激活(账本里已记这笔成交) + if p == "/api/activate-payplatform": + return self.activate_payplatform() + if p == "/api/submit": + return self.submit() + if p == "/api/accept": + return self.accept() + if p == "/api/paid": + return self.mark_paid() + if p == "/api/add-skin": + return self.add_skin() + if p == "/api/set-templates": + return self.set_templates() + if p == "/api/call": + return self.call() + if p == "/api/hb": + return self.hb() + if p == "/api/claim": + return self.claim() + if p == "/api/progress": + return self.progress() + if p == "/api/finish": + return self.finish() + if p == "/api/fail": + return self.fail() + # ---- 管理接口(金钻电脑上的后台面板)---- + if p.startswith("/api/admin/"): + if not self.admin_gate(): + return self.err("forbidden", 403) + if p == "/api/admin/gen": + return self.admin_gen() + if p == "/api/admin/activate": + return self.admin_activate() + if p == "/api/admin/void": + return self.admin_void() + if p == "/api/admin/note": + return self.admin_note() + if p == "/api/admin/code-edit": + return self.admin_code_edit() + if p == "/api/admin/gift/new": + return self.admin_gift_new() + if p == "/api/admin/gift/add": + return self.admin_gift_add() + if p == "/api/admin/gift/off": + return self.admin_gift_off() + return self.err("not found", 404) + except Exception as e: + log("POST %s 异常 %r" % (p, e)) + return self.err("server error", 500) + + # ---- 业务 ---- + def submit(self): + ip = ip_of(self) + if too_many_fails(ip): + log("拒绝 %s:兑换码连续输错,冷却中" % ip) + return self.err("尝试次数过多,请 15 分钟后再试", 429) + if not submit_allowed(ip): + return self.err("提交太频繁,请稍后再试", 429) + if not disk_ok(): + log("拒绝 %s:磁盘不足" % ip) + return self.err("服务器空间不足,请联系金钻处理", 503) + d = self.body_json() + if not d: + return self.err("请求体不合法") + codes = d.get("codes") or [] + templates = d.get("templates") or [] + skin = d.get("skin") or "" + # 网页下单(待付款):不带兑换码,先登记订单,付款后由金钻激活(金钻 2026-09-30) + prepay = (d.get("pay") == "prepay") + arm = d.get("arm") + try: + res = int(d.get("res") or DEFAULT_RES) + except (TypeError, ValueError): + return self.err("分辨率不合法") + if res not in ALLOWED_RES: + return self.err("分辨率不支持(可选 %s)" % "/".join(str(x) for x in ALLOWED_RES)) + if prepay: + if not templates: + return self.err("还没选模板") + elif not codes or not templates: + return self.err("缺少卡密或模板") + # 套装卡密:一张码管一整套,不做「码数 = 张数」的校验(金钻 2026-09-30) + # ⚠️ 这段必须在下面几个校验**之前** —— 之前放后了,_is_set 未定义直接 500 + _cs = load_codes() + _norm = [(c or "").strip().upper() for c in codes] + _is_set = any((_cs.get(c) or {}).get("set") for c in _norm) + # 金钻直发的码:这单不用等收货,预览看完直接能下原图 + _direct = any((_cs.get(c) or {}).get("direct") for c in _norm) + # 「按张数」的卡密(金钻 2026-09-30 晚):码里带了 固定张数 / 封顶 / 锁定模板, + # 就不走「一张码一张图」的老规矩,改按「皮肤数 × 模板数」核对(见 check_rules)。 + _quota = any(((_cs.get(c) or {}).get("n_fix") or (_cs.get(c) or {}).get("n_max") + or (_cs.get(c) or {}).get("lock_tpl") or (_cs.get(c) or {}).get("n_free")) + for c in _norm) + _loose = _is_set or _quota + if not _loose and len(codes) > MAX_IMAGES: + return self.err("一单最多 %d 张" % MAX_IMAGES) + if len(templates) > MAX_IMAGES: + return self.err("一单最多 %d 个模板" % MAX_IMAGES) + if not prepay and not _loose and len(codes) != len(templates): + return self.err("卡密个数与出图张数不一致") + if arm not in ("classic", "slim"): + return self.err("手臂规格不合法") + # 条款同意(金钻 2026-09-30):必须带版本号 + 勾选同意。 + # 不记入"输错计数"—— 老页面缓存会把正常买家误伤,交给通用限流兜。 + terms = d.get("terms") or {} + if not terms.get("agreed") or str(terms.get("v")) != TERMS_VERSION: + return self.err("请先阅读并勾选同意《模板渲染服务条款》再提交(页面刚更新过的话," + "刷新一下页面重试)") + + if prepay: + good = [] # 网页下单不给码,付款后激活 + else: + ok, e, good = redeem(codes) + if not ok: + note_fail(ip) # 码不对才计数 + log("兑换码失败 %s:%s" % (ip, e)) + return self.err(e) + # 张数 / 模板锁定(金钻 2026-09-30 晚)。 + # ⚠️ 2026-10-04 修:第 1 次提交只带第 1 张皮肤,直接拿 len(templates) 当整单张数 + # 会把多皮肤的单一律算少(实测:皮肤1 出 2 张 + 皮肤2 出 1 张 → 只算 2 张 → + # 「固定 3 张」的码被误拒)。前端现在会传 nTotal / tplUnion,优先用它。 + _n1 = int(d.get("nTotal") or 0) or len(templates) + _u1 = [t for t in (d.get("tplUnion") or templates) if t in TPL_KEYS] or templates + e2 = check_rules(codes_rules(good), _n1, _u1) + if e2: + log("卡密规则不通过 %s:%s" % (ip, e2)) + return self.err(e2) + + raw = skin.split(",", 1)[-1] + try: + data = base64.b64decode(raw, validate=False) + except Exception: + return self.err("皮肤图解析失败") + if len(data) > MAX_SKIN: + return self.err("皮肤文件过大") + sz = png_size(data) + if sz is None: + return self.err("皮肤必须是 PNG 图片") + w, h = sz + if w != h: + # 分清"旧版 2:1 皮肤"和"根本不是皮肤",别把两种错说成一句 + if h * 2 == w or w * 2 == h: + return self.err("皮肤尺寸 %d×%d 是旧版 2:1 皮肤(没有独立左臂/左腿纹路),模板渲染不了" % (w, h)) + return self.err("皮肤尺寸 %d×%d 不是皮肤比例(应为正方形)" % (w, h)) + if w < MIN_SIDE or w > MAX_SIDE: + return self.err("皮肤尺寸 %d×%d 超出范围(%d~%d)" % (w, h, MIN_SIDE, MAX_SIDE)) + + # 结构核验 + 清洗(金钻 2026-09-30「避免夹带私货」): + # 拒掉尾部夹带 / 未知关键块 / APNG;剥掉 tEXt 等元数据。 + # ⚠️ 之后一律用 clean(洗过的字节)落盘和下发,原始 data 不再使用。 + okp, why, clean, notes = pngcheck.scan(data) + if not okp: + log("皮肤结构核验不通过 %s:%s" % (ip, why)) + return self.err("皮肤图片未通过安全核验:%s" % why) + if notes: + log("皮肤清洗 %s:%s" % (ip, ";".join(notes))) + data = clean + if len(data) > MAX_SKIN: + return self.err("皮肤文件过大") + + oid = new_oid() + while os.path.exists(order_dir(oid)): + oid = new_oid() + tok = new_owner_token() + os.makedirs(order_dir(oid), exist_ok=True) + with open(os.path.join(order_dir(oid), "skin.png"), "wb") as f: + f.write(data) + os.chmod(os.path.join(order_dir(oid), "skin.png"), 0o640) + + meta = { + "oid": oid, "token": tok, "state": ("unpaid" if prepay else "waiting"), + "created": now().isoformat(timespec="seconds"), + "arm": arm, "arm_auto": d.get("armAuto"), "arm_certain": bool(d.get("armCertain")), + "res": res, + "templates": list(templates)[:10], + "codes": good, + "fileName": (d.get("fileName") or "skin.png")[:80], + "skins": [{"id": "s1", "fileName": (d.get("fileName") or "skin.png")[:80], + "arm": arm, "arm_auto": d.get("armAuto"), + "arm_certain": bool(d.get("armCertain")), + "skin_size": list(sz), "path": "skin.png", + # 这张皮肤自己要出的模板(金钻 2026-10-01:逐张配,不是乘法) + "tpls": list(templates)[:MAX_IMAGES], + "added": now().isoformat(timespec="seconds")}], + "skin_size": list(sz), + "skin_mult64": (w % 64 == 0), + "risk_ack": bool(d.get("riskAck")), + # 留证:条款版本 + 同意时间 + 来源 IP(争议与配合调查用) + "terms_v": TERMS_VERSION, + "terms_at": now().isoformat(timespec="seconds"), + "ip": ip, + "skin_cleaned": bool(notes), + # 金额按「价格档位表」算(金钻 2026-10-01:按张数分档+优惠) + "amount": price_for(max(1, len(templates or good or [1]))), + # 张数 / 模板锁定的规则快照(金钻 2026-09-30 晚)—— 后续追补皮肤要照它核 + "rules": ({} if prepay else codes_rules(good)), + "direct": bool(_direct), # True = 金钻直发码,不用等确认收货 + "note": "", "files": [], "started": None, "finished": None, + "expire": (now() + timedelta(hours=KEEP_HOURS)).isoformat(timespec="seconds"), + } + with LOCK: + write_meta(oid, meta) + note_submit(ip) + if prepay: + # 给网页单也发一个码:既是凭证,买家也能拿它在「凭票取图」页取件 + # 网页单这张码是**取件/凭证**用的,不是"付了钱的码" —— + # 真正付钱的码是买家去爱发电付完、平台发给他的那张(激活时绑到这一单上)。 + # ⚠️ 所以这里**不要**带张数:带了的话 codes_rules 会把两张码的张数加在一起 + # (网页凭证 2 张 + 爱发电 2 张 = 规则变成 4 张,2026-10-01 实测踩到)。 + # 模板只**预填不锁**(他还能改),符合"不限种类、只限张数"的口径。 + # 金钻 2026-10-01 的状态机:「用户通过网页提起一张兑换码,没付费就是未激活状态, + # 付费后激活,就等待出图」→ 所以这里发的是 **inactive(未激活)**,**不 burn**。 + # 激活由付款触发:金钻面板确认到账 / 爱发电成交推过来(见 payplatform_hook)。 + newc = gen_codes(1, batch="网页下单", value=price_for(len(templates)), + platform="网页下单", + tpl=",".join(templates), state="inactive")[0] + # 把「这张码属于哪一单」记上 —— 状态仍是未激活,只是方便付款时按留言里的码 + # 自动认出是哪一单(金钻 2026-10-01 的自动对单靠这个)。 + with LOCK: + _cs = load_codes() + if newc in _cs: + _cs[newc]["order"] = oid + jsave(CODES_FILE, _cs) + meta["codes"] = [newc] + with LOCK: + write_meta(oid, meta) + else: + burn_codes(good, oid) + log("新订单 %s | %s | %s px | 码 %d 个 | 模板 %s | %s" + % (oid, arm, res, len(good), ",".join(templates), "待付款" if prepay else "已核销入队")) + return self.js({"ok": True, "order": oid, "token": tok, "expire": meta["expire"], + "prepay": prepay, "code": (meta.get("codes") or [None])[0]}) + + def order_detail(self, oid, tok): + m = read_meta(oid) + # ⚠️「订单不存在」与「口令不对」必须回同一个 404 —— + # 否则攻击者靠状态码差异就能枚举出哪些订单号是真的(信息泄露)。 + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + accepted = bool(m.get("accepted")) or bool(m.get("direct")) # direct 单等于自动收货 + files = [] + for i, f in enumerate(m.get("files") or []): + # 文件大小:买家挑「下哪一张」时要看(标准压缩 vs 无压缩差 7 倍) + try: + fpath = os.path.join(order_dir(oid), f.get("path") or "") + fsz = os.path.getsize(fpath) + fver = int(os.path.getmtime(fpath)) # 版本号 = 文件 mtime + except OSError: + fsz = 0 + fver = 0 + files.append({ + "name": f.get("name"), + "size": fsz, + "skin": f.get("skin"), + "is_raw": ("无压缩" in (f.get("name") or "")), + # 收货前:给预览地址;收货后:给原图地址 + # ⚠️ 必须带 v=<文件 mtime>:重渲会把同名文件原地覆盖,URL 不变的话 + # 浏览器直接拿缓存里的旧图(2026-10-04 金钻:「重渲之后的图为什么还是之前的图」) + "url": "/order/api/dl/%s/%d?t=%s&v=%d" % (oid, i, tok, fver), + "prev": ("/order/api/dl/%s/%d?t=%s&p=1&v=%d" % (oid, i, tok, fver)) if f.get("prev") else None, + "has_prev": bool(f.get("prev")), + }) + st = m.get("state") + note = m.get("note") or "" + hbs = heartbeat() + # 金额按「出图张数」算,**不是按码个数** —— 网页单根本没有码(2026-09-30 踩过) + skins = skins_of(m) + n_img = img_total(m) # 皮肤 × 模板 的组合数 + amount = m.get("amount") + if amount is None or m.get("skins"): # 有 skins 就现算(追补皮肤后金额要涨) + amount = price_for(n_img) + if st == "unpaid": + # 一句话就够 —— 付款三步写在付款框里,这里别再复述(金钻 2026-10-01:太乱了) + note = "内容已存好,付款后自动排队出图。" + elif st == "paid": + note = "收到你的付款申报了,正在等金钻确认到账 —— 确认后会自动进队列渲染,不用再操作。" + elif st == "waiting" and m.get("codes"): + # 卡密单(闲鱼/B站发来的码)本来就是付过款的,别再让买家以为要付款 + pos = queue_pos(oid) + note = ("这单是用卡密下的,**已经付过款,不用再付款**。" + + ("渲染机在线,正在排队(前面还有 %d 单)。" % (pos - 1) if hbs["online"] + else "渲染机当前离线,等金钻开机器后会自动开始渲染,着急可点「呼叫金钻」。")) + elif st == "waiting": + pos = queue_pos(oid) + note = ("渲染机在线,正在排队(前面还有 %d 单)。" % (pos - 1)) if hbs["online"] \ + else "渲染机当前离线,等金钻开机器后会自动开始渲染。着急可点「呼叫金钻」。" + elif st == "working": + note = "正在渲染中,稍等片刻。" + elif st == "done": + if m.get("direct") and not m.get("accepted"): + m["note"] = "渲染完成 —— 这一单不用确认收货,看完预览直接下原图就行。" + note = ("渲染完成,已确认收货 —— 原图可以下载了。成品在服务器只保留 72 小时,请及时下载备份。" + if accepted else + "渲染完成!先看下面的 512 预览图(带水印),确认没问题点「确认收货」," + "就能下载原图(标准压缩 + 无压缩 16bit,两张都记得下载)。") + elif st == "failed": + note = note or "渲染失败,已记录,可点「呼叫金钻」处理。" + return self.js({"ok": True, "oid": oid, "state": st, "created": m.get("created"), + "started": m.get("started"), "finished": m.get("finished"), + "templates": m.get("templates"), + "res": int(m.get("res") or DEFAULT_RES), + "note": note, + "accepted": accepted, + # 买家自助重渲:用过没有 + 上次选了什么(页面按钮据此置灰) + "redo_used": bool(m.get("redo_used")), + "redo_files": m.get("redo_files") or [], + "amount": amount, + "amount": amount, + "n_img": n_img, + "codes": m.get("codes") or [], + "skins": [{"id": x.get("id"), "name": x.get("fileName"), + "arm": x.get("arm"), "size": x.get("skin_size"), + "tpls": skin_tpls(m, x)} for x in skins], + "n_tpl": len(m.get("templates") or []), + "accepted_at": m.get("accepted_at"), + # 卡密的张数 / 模板锁定(金钻 2026-09-30 晚):页面要照它提示与拦人 + "rules": (m.get("rules") or codes_rules(m.get("codes") or [])), + "files": files, + # 到期时间按「开放下载后 72 小时」现算(老单没有 accepted_at 就用创建时间) + "expire": ((expire_at(m) or now()).isoformat(timespec="seconds") + if expire_at(m) else m.get("expire")), + "open_at": open_at(m), + "progress": m.get("progress"), + "eta_sec": tpl_eta_sec(m.get("templates"), n_img), + "machine_online": hbs["online"]}) + + def _read_skin(self, d): + """把请求里的皮肤解码 + 体检 + 洗白,返回 (ok, err, clean_bytes, size, notes)""" + raw = (d.get("skin") or "").split(",", 1)[-1] + try: + data = base64.b64decode(raw, validate=False) + except Exception: + return False, "皮肤图解析失败", None, None, [] + if len(data) > MAX_SKIN: + return False, "皮肤文件过大", None, None, [] + sz = png_size(data) + if sz is None: + return False, "皮肤必须是 PNG 图片", None, None, [] + w, h = sz + if w != h: + if h * 2 == w or w * 2 == h: + return False, "皮肤尺寸 %d×%d 是旧版 2:1 皮肤(没有独立左臂/左腿纹路),模板渲染不了" % (w, h), None, None, [] + return False, "皮肤尺寸 %d×%d 不是皮肤比例(应为正方形)" % (w, h), None, None, [] + if w < MIN_SIDE or w > MAX_SIDE: + return False, "皮肤尺寸 %d×%d 超出范围(%d~%d)" % (w, h, MIN_SIDE, MAX_SIDE), None, None, [] + okp, why, clean, notes = pngcheck.scan(data) + if not okp: + return False, "皮肤图片未通过安全核验:%s" % why, None, None, [] + return True, None, clean, sz, notes + + def add_skin(self): + """往已有订单**追补**一张皮肤(金钻 2026-09-30:「玩家填完可以在后面补」)。 + + 每张皮肤各自判臂型 —— A 可能 Steve 粗臂、B 可能 Alex 细臂, + 出图 = 皮肤 × 模板 的组合。已经开渲的单不让补(不然队列对不上)。 + """ + ip = ip_of(self) + if not skin_allowed(ip): + return self.err("操作太频繁,请稍后再试", 429) + if not disk_ok(): + return self.err("服务器空间不足,请联系金钻处理", 503) + d = self.body_json() # 单张皮肤(现在上限 10MB,见 MAX_SKIN) + if not d: + return self.err("请求体不合法") + oid, tok = (d.get("oid") or "").strip(), d.get("token") or "" + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + if m.get("state") not in ("unpaid", "paid", "waiting"): + return self.err("这一单已经在渲染或已完成,不能再加皮肤了。要加请另开一单。") + ok, e, clean, sz, notes = self._read_skin(d) + if not ok: + return self.err(e) + arm = d.get("arm") or "classic" + if arm not in ("classic", "slim"): + return self.err("手臂规格不合法") + skins = skins_of(m) + if len(skins) >= MAX_IMAGES: + return self.err("一张单最多 %d 张皮肤" % MAX_IMAGES) + # 这张皮肤自己要出哪些模板(金钻 2026-10-01:逐张配,没给就沿用订单级那份) + new_tpls = [t for t in (d.get("tpls") or m.get("templates") or []) if t in TPL_KEYS][:MAX_IMAGES] + if not new_tpls: + return self.err("这张皮肤还没挑模板(要从模板清单里挑至少一个)") + # 张数卡密(金钻 2026-09-30 晚 + 10-01 改口径):加完这张一共出几张 = 各皮肤之和 + n_after = sum(len(skin_tpls(m, x)) for x in skins) + len(new_tpls) + uni = list(m.get("templates") or []) + for t in new_tpls: + if t not in uni: + uni.append(t) + e2 = check_rules(codes_rules(m.get("codes") or []), n_after, uni) + if e2: + return self.err("这张皮肤加不了:" + e2) + sid = "s%d" % (len(skins) + 1) + while any(x.get("id") == sid for x in skins): + sid += "x" + sd = os.path.join(order_dir(oid), "skins") + os.makedirs(sd, exist_ok=True) + rel = "skins/%s.png" % sid + with open(os.path.join(order_dir(oid), rel), "wb") as f: + f.write(clean) + os.chmod(os.path.join(order_dir(oid), rel), 0o640) + skins.append({"id": sid, "fileName": (d.get("fileName") or ("皮肤%s.png" % len(skins))) [:80], + "arm": arm, "arm_auto": d.get("armAuto"), + "arm_certain": bool(d.get("armCertain")), + "skin_size": list(sz), "path": rel, + "tpls": new_tpls, # 这张皮肤自己出的模板 + "added": now().isoformat(timespec="seconds")}) + m["skins"] = skins + m["templates"] = uni # 订单级 = 并集(展示/锁定校验用) + m["amount"] = price_for(img_total(m)) + # (网页单的凭证码不带张数,所以这里不需要同步 —— 见 submit 里那段注释) + with LOCK: + write_meta(oid, m) + note_skin(ip) + log("订单 %s 追补皮肤 %s(%s)→ 共 %d 张皮肤 × %d 模板 = %d 张图 ¥%s" + % (oid, sid, arm, len(skins), len(m.get("templates") or []), img_total(m), m["amount"])) + return self.js({"ok": True, "skins": len(skins), "n_img": img_total(m), "amount": m["amount"], + "skin": {"id": sid, "name": skins[-1]["fileName"], "arm": arm, "size": list(sz)}}) + + def set_templates(self): + """改模板。带 `skin=<皮肤id>` 就只改那一张皮肤的;不带 = 改所有皮肤(老用法)。 + + 金钻 2026-10-01 改成「每张皮肤各自一份模板」之后,追补/删减要能落到具体某张上。 + """ + d = self.body_json() or {} + oid, tok = (d.get("oid") or "").strip(), d.get("token") or "" + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + if m.get("state") not in ("unpaid", "paid", "waiting"): + return self.err("这一单已经在渲染或已完成,改不了模板了") + tpls = [t for t in (d.get("templates") or []) if t in TPL_KEYS] + if not tpls: + return self.err("至少要留一个模板") + if len(tpls) > MAX_IMAGES: + return self.err("最多 %d 个模板" % MAX_IMAGES) + sid = (d.get("skin") or "").strip() + skins = skins_of(m) + if sid: + hit = [x for x in skins if x.get("id") == sid] + if not hit: + return self.err("没有这张皮肤:%s" % sid, 404) + hit[0]["tpls"] = list(tpls) + else: + for x in skins: + x["tpls"] = list(tpls) # 不带皮肤 = 全改(单皮肤时就是老行为) + m["skins"] = skins + m["templates"] = tpl_union(m) + # 张数 / 锁定模板:改模板会改张数,照卡密规则核一遍 + e2 = check_rules(codes_rules(m.get("codes") or []), img_total(m), m["templates"]) + if e2: + return self.err(e2) + m["amount"] = price_for(img_total(m)) + with LOCK: + write_meta(oid, m) + return self.js({"ok": True, "templates": tpls, "n_img": img_total(m), "amount": m["amount"]}) + + def payplatform_hook(self): + """爱发电「自动发货 / 订单推送」回调(金钻 2026-10-01)。 + + 真实报文长这样(2026-10-01 21:22 抓到的,UA=PayplatformRobot): + {"ec":200,"em":"ok","data":{"type":"order","sign":"", + "order":{"out_trade_no":"…","status":2,"total_amount":"5.00", + "plan_title":"…","title":"…","remark":"买家留言", + "user_id":"…","sku_detail":[{"name":"sku1","count":2}]}}} + + 处理顺序(**先验证再发码**,绝不靠签名猜): + ① 测试单(标题带"测试")→ 只记账 + ② 幂等:同一个 out_trade_no 重推 → 回同一张码(爱发电会重试) + ③ 用开放接口反查这笔单 → 查不到 / 没付款 → 只记账 + 记进待办,不发码 + ④ 查得到且 status==2 → 按规格名/金额映射张数 → 生成卡密 → 落账 → 回给爱发电 + """ + raw = b"" + try: + n = int(self.headers.get("Content-Length") or 0) + raw = self.rfile.read(min(n, 64 * 1024)) if n else b"" + except (ValueError, OSError): + pass + try: + obj = json.loads(raw.decode("utf-8", "replace") or "{}") + except ValueError: + obj = {"_parse_error": True, "_raw": raw[:2000].decode("utf-8", "replace")} + try: + with open(PAYPLATFORM_LOG, "a", encoding="utf-8") as f: + f.write(json.dumps({"ts": now().isoformat(timespec="seconds"), "ip": ip_of(self), + "headers": dict(self.headers.items()), "body": obj}, + ensure_ascii=False) + "\n") + except OSError: + pass + + order = (((obj.get("data") or {}).get("order")) or {}) + oid_af = str(order.get("out_trade_no") or "").strip() + title = "%s %s" % (order.get("plan_title") or "", order.get("title") or "") + if not oid_af: + log("爱发电回调:没有 out_trade_no,忽略(%s)" % json.dumps(obj, ensure_ascii=False)[:200]) + return self.js({"ec": 200, "em": ""}) + if "测试" in title: + log("爱发电回调:测试单(%s),只记账不发码" % title.strip()) + return self.js({"ec": 200, "em": ""}) + led = jload(PAYPLATFORM_LEDGER, {}) or {} + if oid_af in led and led[oid_af].get("code"): + log("爱发电回调:%s 已经发过码 %s(重推,原样回它)" % (oid_af, led[oid_af]["code"])) + return self.js({"ec": 200, "em": "", "data": {"content": led[oid_af].get("content") or ""}}) + + if int(order.get("status") or 0) != 2: + log("爱发电回调:%s 状态不是已付款(status=%s),先不发码" + % (oid_af, order.get("status"))) + led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "status": order.get("status"), + "amount": order.get("show_amount") or order.get("total_amount"), + "code": None, "note": "未付款"} + jsave(PAYPLATFORM_LEDGER, led) + return self.js({"ec": 200, "em": ""}) + + real = payplatform_find_order(oid_af) + if not real: + # 没验过就不发码 —— 宁可让金钻手工补,也不给伪造的报文发货 + log("⚠️ 爱发电回调:%s 在开放接口里查不到(可能官方延迟/伪造),没发码" % oid_af) + led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "code": None, + "amount": order.get("show_amount") or order.get("total_amount"), + "note": "接口没查到,待人工核对", "need_human": True} + jsave(PAYPLATFORM_LEDGER, led) + return self.js({"ec": 200, "em": ""}) + + n_img_af = payplatform_img_count(real) + sku_txt = "、".join("%s×%s" % (d.get("name") or "?", d.get("count") or 1) + for d in (real.get("sku_detail") or [])) or "-" + + # ===== 先看这笔付款是不是"网页单来付的"(金钻 2026-10-01 的状态机)===== + # 线索优先级:⓪ 回调带回的订单号 custom_order_id(专链里塞的,金钻 2026-10-03 新加,最硬) + # ① 留言里写了我方的兑换码(YS-XXXX-….)② 留言里写了订单号(YS7ZBZW6) + # ③ 留言空着,但**只有一笔**待付款单的金额对得上(唯一才敢自动认,两笔就人工) + rm_up = str(real.get("remark") or "").upper() + target, how = None, "" + # ⓪ 专链下单:前端把订单号写进 custom_order_id,爱发电下单后原样带回来。 + # 取不到这个字段 → 静默跳过,走下面的三条老线索(绝不因字段缺失报错)。 + coid = str((real.get("custom_order_id") if isinstance(real, dict) else "") + or (order.get("custom_order_id") if isinstance(order, dict) else "") or "").strip() + if coid: + for _c in (coid, coid.upper()): + if read_meta(_c): + target, how = _c, "回调带回的订单号(custom_order_id)" + break + hit = re.search(r"YS-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}", rm_up) + if hit and not target: + target = (load_codes().get(hit.group(0)) or {}).get("order") + how = "留言里的兑换码" + if not target: + h2 = re.search(r"YS[0-9A-Z]{6}", rm_up.replace("-", "")) + if h2 and read_meta(h2.group(0)): + target, how = h2.group(0), "留言里的订单号" + if not target: + try: + amt = int(round(float(str(real.get("show_amount") or real.get("total_amount"))))) + except (TypeError, ValueError): + amt = -1 + cands = [x for x in list_orders(("unpaid", "paid")) if int(x.get("amount") or 0) == amt] + if len(cands) == 1: + target, how = cands[0]["oid"], "唯一一笔金额对得上的待付款单" + if target: + m_t = read_meta(target) + # ⚠️ 金额闸门(金钻 2026-10-03 提的洞):留言里的凭证/订单号只能说明"这笔钱想付哪一单", + # 不能说明"付够了"。付不够就**不激活**,记一笔待人工 —— + # 防的是"自定义金额填 0.1 元、留言写上凭证 → 直接把大单激活白嫖"。 + need = float(price_for(img_total(m_t or {})) or 0) + paid = payplatform_paid(real) + if paid + 0.005 < need: + log("⚠️ 爱发电付款 %s(实付 ¥%s)想付网页单 %s,但应付 ¥%s —— 金额不足,不激活、不发码,待人工" + % (oid_af, paid, target, need)) + led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "code": None, + "amount": real.get("show_amount") or real.get("total_amount"), + "sku": sku_txt, "buyer": real.get("user_id"), "remark": real.get("remark"), + "want_order": target, "need": need, "paid": paid, + "note": "金额不足(应付 ¥%s,实付 ¥%s),待人工核对" % (need, paid), + "need_human": True} + jsave(PAYPLATFORM_LEDGER, led) + return self.js({"ec": 200, "em": "", "data": {"content": + "金钻工坊 · 自助模板渲染\n收到你的付款,但金额和订单应付款(¥%s)对不上,已记下来等人工核对。\n" + "核对没问题就立刻排队出图;如果是付少了,补齐后我们会马上处理。" % need}}) + ok, msg = activate_order_paid(target, source="爱发电成交(%s)" % how) + if ok: + content = ("金钻工坊 · 自助模板渲染\n已确认你的付款,订单 %s 已激活并开始排队出图。\n" + "进度/成品都在这页看:http" + % (target, target, (m_t or {}).get("token") or "")) + rec_led = {"ts": now().isoformat(timespec="seconds"), "code": None, + "n_img": img_total(m_t or {}), "used_by": target, + "amount": real.get("show_amount") or real.get("total_amount"), + "sku": sku_txt, "buyer": real.get("user_id"), + "remark": real.get("remark"), "content": content, "notified": False, + "matched_by": how} + # 金钻 2026-10-03:多付照样激活(不能因为多给钱就卡住出图), + # 但**必须记账 + 在回调文案里出声** —— 否则买家多付了我们不知道, + # 他也不好意思说。常见成因是「其实想多买几张」→ 待人工看一眼。 + over = paid - need + if over > 0.005: + rec_led["over"] = over + rec_led["need"] = need + rec_led["paid"] = paid + rec_led["note"] = ("多收 ¥%s(应付 ¥%s,实付 ¥%s),待人工看一眼(可能是想多买)" + % (_yuan(over), _yuan(need), _yuan(paid))) + content += ("\n本次收到 ¥%s、订单应付 ¥%s,多收 ¥%s 请联系金钻退回" + "(也可以留作支持 🙏)" % (_yuan(paid), _yuan(need), _yuan(over))) + rec_led["content"] = content + led[oid_af] = rec_led + jsave(PAYPLATFORM_LEDGER, led) + log("爱发电付款 %s(¥%s)→ 对上网页单 %s → 已激活进队列(靠:%s)" + % (oid_af, led[oid_af]["amount"], target, how)) + return self.js({"ec": 200, "em": "", "data": {"content": content}}) + log("爱发电付款 %s 想激活 %s,但没成:%s" % (oid_af, target, msg)) + + # ===== 不是网页单(或者对不上)→ 按"买了张卡密"处理:发码 ===== + # ⚠️ 发码前按**实付金额**再卡一道(金钻 2026-10-03):规格/金额说几张,就以"实付买得起几张"为准。 + # 连一张都买不起(比如自定义金额填 0.1)→ 不发码,记待人工。防白嫖。 + paid = payplatform_paid(real) + afford = int((paid + 0.005) // PRICE_UNIT) + n_img = min(n_img_af, afford) if afford > 0 else 0 + if n_img < 1: + log("⚠️ 爱发电付款 %s 实付只有 ¥%s(不足一张 ¥%s)—— 不发码,待人工" % (oid_af, paid, PRICE_UNIT)) + led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "code": None, + "amount": real.get("show_amount") or real.get("total_amount"), + "sku": sku_txt, "buyer": real.get("user_id"), "remark": real.get("remark"), + "paid": paid, "note": "金额不足一张(¥%s),待人工核对" % paid, + "need_human": True} + jsave(PAYPLATFORM_LEDGER, led) + return self.js({"ec": 200, "em": "", "data": {"content": + "金钻工坊 · 自助模板渲染\n收到你的付款 ¥%s,但不足一张(¥%s),没法自动发码。\n" + "已记下来等人工核对;补齐差额后会马上补发。" % (paid, PRICE_UNIT)}}) + if n_img < n_img_af: + log("爱发电付款 %s:规格说 %d 张,但实付 ¥%s 只够 %d 张 —— 按 %d 张发" + % (oid_af, n_img_af, paid, afford, n_img)) + code = gen_codes(1, batch="爱发电自动", value=n_img * PRICE_UNIT, platform="爱发电", + tpl="", n_fix=n_img)[0] # 不限模板、只限张数(金钻口径) + try: + os.chmod(CODES_FILE, 0o640) + except OSError: + pass + content = ("金钻工坊 · 自助模板渲染\n这是你的卡密(固定 %d 张,模板随便挑):%s\n" + "到 http 点「卡密下单」填进去就能开始。" + % (n_img, code)) + rec_led = {"ts": now().isoformat(timespec="seconds"), "code": code, "n_img": n_img, + "amount": real.get("show_amount") or real.get("total_amount"), + "sku": sku_txt, "buyer": real.get("user_id"), "remark": real.get("remark"), + "content": content, "notified": False, + "note": "没对上网页单,按买码处理"} + # 金钻 2026-10-03:发码**按规格**(多付不会多发码 —— 张数算法不许动), + # 但实付明显超过这张码的值时,也记一笔待人工看一眼(同样常见于「想多买」)。 + over_code = paid - n_img * PRICE_UNIT + if over_code > 0.005: + rec_led["over"] = over_code + rec_led["need"] = n_img * PRICE_UNIT + rec_led["paid"] = paid + rec_led["note"] = ("没对上网页单,按买码处理;多收 ¥%s(码值 ¥%s,实付 ¥%s)," + "待人工看一眼(可能是想多买)" + % (_yuan(over_code), _yuan(n_img * PRICE_UNIT), _yuan(paid))) + led[oid_af] = rec_led + jsave(PAYPLATFORM_LEDGER, led) + log("爱发电卖出:%s | 金额 %s | 规格 %s | 留言 %s | 发码 %s(%d 张)" + % (oid_af, led[oid_af]["amount"], sku_txt, (real.get("remark") or "-")[:30], code, n_img)) + # 发货内容塞进返回体(爱发电的自动发货会用 content 展示给买家;不认也没关系, + # 下面那条定时任务会把成交+卡密推给金钻,绝不会漏)。 + return self.js({"ec": 200, "em": "", "data": {"content": content}}) + + + def activate_payplatform(self): + """用**爱发电订单号**激活网页那一单(金钻 2026-10-01)。 + + 为什么要有这条:爱发电的「自动回复 / 自动随机回复(卡密池)」**要认证创作者才能开** + (2026-10-01 金钻截图确认,两个勾选框都是灰的)。所以认证下来之前,买家拿不到码 —— + 但我们有 webhook:每笔成交都记在 payplatform-orders.json 里了。 + 于是让买家**直接填爱发电订单号**,我们按账本认这笔成交 → 激活他那一单。**全程不用码。** + + ⚠️ 一笔成交只能激活一单(账本里记 used_by),不然一个订单号能白嫖出无数单。 + """ + d = self.body_json() or {} + oid, tok = (d.get("oid") or "").strip().upper(), d.get("token") or "" + ano = re.sub(r"[^0-9A-Za-z]", "", str(d.get("payplatform_order") or "")) + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + if m.get("state") not in ("unpaid", "paid"): + return self.err("这一单现在是「%s」,不用再激活了" % m.get("state")) + if len(ano) < 10: + return self.err("爱发电订单号看着不对(在爱发电「我的订单」里能复制到,一长串数字)") + led = jload(PAYPLATFORM_LEDGER, {}) or {} + rec = None + for k, v in led.items(): + if str(k).endswith(ano) or str(k) == ano: + rec = v + rec["_key"] = k + break + if not rec: + return self.err("没查到这笔爱发电订单 —— 确认一下订单号?刚付完可能要等几秒," + "稍等再试;还不行就点「呼叫金钻」。") + if not rec.get("code"): + return self.err("这笔订单我们还没核对上(%s),请点「呼叫金钻」,金钻手工给你开。" + % (rec.get("note") or "状态异常")) + if rec.get("used_by") and rec["used_by"] != oid: + return self.err("这个爱发电订单号已经用在订单 %s 上了" % rec["used_by"]) + if rec.get("used_by") == oid: + return self.js({"ok": True, "oid": oid, "state": "waiting", "again": True}) + nf = int(rec.get("n_img") or 0) + want = img_total(m) + if nf and nf != want: + return self.err("你买的是 %d 张,这一单是 %d 张 —— 对不上。请点「呼叫金钻」。" + % (nf, want)) + akey = rec["_key"] # ⚠️ 先存下来:下面要把 _key 从记录里 pop 掉, + led[akey]["used_by"] = oid # 之后再读 rec["_key"] 就是 KeyError(2026-10-01 实踩,500) + led[akey].pop("_key", None) + jsave(PAYPLATFORM_LEDGER, led) + m["payplatform_order"] = akey + with LOCK: + write_meta(oid, m) + activate_order_paid(oid, code=rec["code"], source="爱发电订单号") + return self.js({"ok": True, "oid": oid, "state": "waiting", "code": rec["code"], + "n_img": img_total(m)}) + + def activate(self): + """网页下单的买家:付完款后,用平台发来的卡密**激活自己那一单**。 + + 金钻 2026-10-01 定的流程: + 网页把内容填完(挑模板 / 传皮肤)→ 跳去爱发电付款 → 回来把码填上 → 激活开渲。 + **关键:网页填过的东西一个字都不能白填** —— 所以这里是"码认单"而不是"码开新单": + 订单一动不动(皮肤、模板、金额、订单号全不变),只是把码绑上去 + 状态推进到 waiting。 + """ + d = self.body_json() or {} + oid, tok = (d.get("oid") or "").strip().upper(), d.get("token") or "" + code = (d.get("code") or "").strip().upper() + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + if m.get("state") not in ("unpaid", "paid"): + return self.err("这一单现在是「%s」,不用再激活了" % m.get("state")) + if not CODE_RE.match(code): + return self.err("卡密格式不对(形如 YS-XXXX-XXXX-XXXX)") + rec = (load_codes() or {}).get(code) + if not rec: + return self.err("没有这个卡密 —— 检查一下有没有输错") + # 填的是**自己这一单的凭证码**?金钻 2026-10-01 定的口径:「回来就用这个兑换码就行」。 + # 那就把它当**报到付款**用:订单推到 paid(待激活),并告诉买家"等确认到账就开渲"。 + # ⚠️ 为什么不能直接放行开渲:这张码是**提交订单时白送的**(页面上就摊着), + # 直接放行等于不付钱也能渲。所以它在这里的作用 = 「我付好了」,不是付款本身; + # 真金白银那一步由金钻点确认(面板激活)或爱发电成交自动对上(见 payplatform_hook)。 + if code in (m.get("codes") or []): + if m.get("state") == "unpaid": + m["state"] = "paid" + m["paid_at"] = now().isoformat(timespec="seconds") + with LOCK: + write_meta(oid, m) + log("订单 %s 买家填本单凭证码 %s → 报到付款(待激活)" % (oid, code)) + return self.js({"ok": True, "oid": oid, "state": m.get("state"), "paid_claim": True, + "note": "已收到你的付款登记 —— 金钻确认到账后立刻开渲(一般很快)。" + "确认后这一页会自动变成「排队中」。"}) + st = code_state(rec) + if st != "active": + return self.err("这张卡密%s,换一张试试" + % ("已经用过了" if st in ("used", "bound") else "被停用了")) + # 张数必须对得上(1 张的码不能开 3 张的单) + want = img_total(m) + nf = int(rec.get("n_fix") or 0) + if nf and nf != want: + return self.err("这一单是 %d 张,你手上这张卡密是 %d 张 —— 对不上。" + "请联系金钻换一张 %d 张的码。" % (want, nf, want)) + # 锁定模板的码,还要核对模板对得上 + if rec.get("lock_tpl") and rec.get("tpl"): + locked = [x.strip() for x in rec["tpl"].split(",") if x.strip()] + uni = tpl_union(m) + if set(uni) - set(locked): + return self.err("这张卡密锁定了模板(%s),你这单选的是 %s —— 对不上。" + % ("、".join(locked), "、".join(uni))) + burn_codes([code], oid) # 绑码(= 激活,不是核销) + m["codes"] = (m.get("codes") or []) + [code] + m["state"] = "waiting" # 进队列 —— 订单内容原封不动 + m["paid_at"] = now().isoformat(timespec="seconds") + m["activated_by"] = "卡密激活" + with LOCK: + write_meta(oid, m) + log("订单 %s 用卡密 %s 激活 → 进队列(网页填的内容保持原样)" % (oid, code)) + return self.js({"ok": True, "oid": oid, "state": "waiting", "code": code, + "n_img": img_total(m), "amount": m.get("amount")}) + + def payinfo(self): + """付款方式信息(爱发电链接 / 收款码图 / 说明)—— 页面上的「去付款」按钮读它。 + + 改法:编辑 /payinfo.json(金钻给了链接/图就填进去)。 + """ + d = jload(PAYINFO_FILE, {}) + if not isinstance(d, dict): + d = {} + return self.js({"ok": True, + "payplatform": (d.get("payplatform") or "").strip(), + # 创作者 ID:前端用它拼「按本单金额生成的专链」 + # (pay-platform.example/order/create?user_id=…&custom_price=…&custom_order_id=…&remark=…)。 + # 没配就回落上面的固定商品链接 payplatform(兜底,金钻 2026-10-03)。 + "payplatform_uid": (d.get("payplatform_uid") or "").strip(), + "qr_img": (d.get("qr_img") or "").strip(), # 服务器上的相对路径,比如 payme.png + "note": (d.get("note") or "").strip(), + "price": PRICE_UNIT, + # 价格档位表(金钻 2026-10-01):页面按买家选的张数取档位价 + 对应商品链接 + "tiers": price_tiers().get("tiers") or {}, + "per": price_tiers().get("per") or PRICE_UNIT}) + + def redo(self): + """买家点「有问题」→ **免费重渲一次**(金钻 2026-10-02)。 + 上传时买家只看到 512 预览,出问题不该他吃亏;但也不能无限刷 → 每单一次。 + 可选 files:只挑有问题的那几张(留档用;渲染机整体重渲,同名覆盖)。""" + d = self.body_json() or {} + oid = (d.get("oid") or "").strip() + tok = d.get("token") or "" + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + if m.get("state") not in ("done", "failed"): + return self.err("这一单还没渲完(或正在渲),等它停下来再说") + if m.get("redo_used"): + return self.err("这一单已经用过一次免费重渲了。还不行的话进官方群找金钻,他看着办。") + files = [str(x)[:60] for x in (d.get("files") or [])][:12] + note = str(d.get("note") or "").strip()[:200] + # 换皮肤(金钻 2026-10-02:「或者他皮肤填错了重新换」)—— + # 传错了很正常,他上传时只看到 512 预览,不该卡在这儿。 + new_skin = d.get("skin") or "" + sid = str(d.get("skin_id") or "")[:8] + if new_skin and sid: + skins = skins_of(m) + hit = [x for x in skins if (x.get("id") or "") == sid] + if not hit: + return self.err("这张皮肤不属于这一单") + try: + raw = base64.b64decode(new_skin.split(",", 1)[-1]) + except Exception: + return self.err("新皮肤数据不合法") + if not raw or len(raw) > MAX_BODY: + return self.err("新皮肤太大或为空") + sd = os.path.join(order_dir(oid), "skins") + os.makedirs(sd, exist_ok=True) + with open(os.path.join(sd, "%s.png" % sid), "wb") as f: + f.write(raw) + os.chmod(os.path.join(sd, "%s.png" % sid), 0o640) + # 金钻 2026-10-04:「得保证完全覆盖皮肤」—— 同一张还写一份到 skin.png。 + # 任何一条读取路径(老的按 path / 新的按 skins/.png)拿到的都是新皮肤, + # 不给「看着换了、实际没换」留缝。 + if sid == "s1": + with open(os.path.join(order_dir(oid), "skin.png"), "wb") as f: + f.write(raw) + os.chmod(os.path.join(order_dir(oid), "skin.png"), 0o640) + hit[0]["fileName"] = (d.get("skin_name") or "换过的皮肤.png")[:80] + # ⚠️⚠️ 这行是 2026-10-04 的根因修复:换了皮肤必须**同时把 path 指到新文件**。 + # 原来只写文件 + 改文件名,path 还指着旧的 skin.png → + # 渲染机下载到的永远是旧皮肤,买家看到「重渲后还是老图」(金钻实测踩到)。 + hit[0]["path"] = "skins/%s.png" % sid + m["skins"] = skins + log("免费重渲 %s:换了皮肤 %s(%s)" % (oid, sid, hit[0]["fileName"])) + # 换模板(金钻 2026-10-04:「有问题的话选错模板的情况没有后悔药诶」) + new_tpls = [t for t in (d.get("tpls") or []) if t in TPL_KEYS] + if new_tpls: + uniq = list(dict.fromkeys(new_tpls))[:MAX_IMAGES] + n_after = len(uniq) * len(skins_of(m)) + e2 = check_rules(codes_rules(m.get("codes") or []), n_after, uniq) + if e2: + return self.err("换模板不行:" + e2) + for x in skins_of(m): + x["tpls"] = list(uniq) # 每张皮肤都按新的一套来 + m["templates"] = list(uniq) + log("免费重渲 %s:换成模板 %s" % (oid, "、".join(uniq))) + m["redo_used"] = True + m["redo_files"] = files + m["redo_note"] = note + m["redo_at"] = now().isoformat(timespec="seconds") + # 要重渲的是哪几张 → 换算成模板清单(渲染机是按「皮肤 × 模板」干活的) + # 金钻 2026-10-04:「重渲要更灵活更聪明」—— + # 一律**只重出玩家勾的那几张**(换没换皮肤都一样,勾什么渲什么); + # 换了皮肤又想整套一致的话,由玩家自己勾 all=1(弹窗里那个勾选项)。 + redo_tpls = [] + if d.get("all"): + redo_tpls = [] # 空清单 = 整单重出 + else: + want = set(files or []) + for f in (m.get("files") or []): + if (f.get("name") or "") in want and f.get("tpl") and f["tpl"] not in redo_tpls: + redo_tpls.append(f["tpl"]) + if not redo_tpls and files: + # 勾的图找不到模板(老单缺 tpl 字段)→ 退回整单,别让玩家点了没反应 + redo_tpls = [] + m["redo_tpls"] = redo_tpls + # 没换皮肤、只重渲一部分 → **保留**其它成品(claim 里清了就再也找不回来了) + if files and redo_tpls: + log("免费重渲 %s:只重出 %s" % (oid, "、".join(redo_tpls))) + # 重渲中的那几张先从列表里撤掉(渲染机交新的回来时同名字覆盖) + if files: + m["files"] = [f for f in (m.get("files") or []) if (f.get("name") or "") not in files] + m["state"] = "waiting" + m["started"] = m["finished"] = None + m["note"] = "买家申请免费重渲%s:%s" % ( + ("(只重出 %d 张:%s)" % (len(files), "、".join(files)) + if (files and redo_tpls) else "(整单重出)"), + note or "(没写原因)") + with LOCK: + write_meta(oid, m) + log("免费重渲 %s | 选了 %s | %s" % (oid, files or "全部", note or "(没写原因)")) + return self.js({"ok": True, "files": files}) + + def feedback(self): + """买家反馈(金钻 2026-10-02:「反馈问题要能上传图片」)。 + 为什么改走服务器:原来是 mailto —— **手机上点了没反应**(没配邮箱客户端就什么都不发生), + 而且图片根本带不出去。现在存到 /feedback/,并且走「呼叫金钻」同一套通知。""" + d = self.body_json() or {} + ip = self.headers.get("X-Real-IP") or self.client_address[0] + note = str(d.get("note") or "").strip()[:1500] + if not note and not d.get("image"): + return self.err("总得写点什么,或者传张图") + try: + os.makedirs(FEEDBACK_DIR, exist_ok=True) + except OSError: + return self.err("服务器忙,稍后再试", 503) + fid = now().strftime("%Y%m%d-%H%M%S") + "-" + "".join( + random.choice("abcdefghijkmnpqrstuvwxyz23456789") for _ in range(4)) + rec = {"id": fid, "ts": now().isoformat(timespec="seconds"), "ip": ip, + "order": str(d.get("order") or "")[:20], "note": note, + "contact": str(d.get("contact") or "")[:80], + "trail": [str(x)[:60] for x in (d.get("trail") or [])][:20], + "errs": [str(x)[:120] for x in (d.get("errs") or [])][:10], + "platform": str(d.get("platform") or "")[:60], + "ua": (self.headers.get("User-Agent") or "")[:120], + "image": ""} + img = d.get("image") or "" + if img: + try: + raw = base64.b64decode(img.split(",", 1)[-1]) + except Exception: + raw = b"" + if raw and len(raw) <= 4 * 1024 * 1024: + fn = "%s.png" % fid + with open(os.path.join(FEEDBACK_DIR, fn), "wb") as f: + f.write(raw) + rec["image"] = fn + elif raw: + rec["image"] = "(图片超过 4MB,没收)" + with open(os.path.join(FEEDBACK_DIR, fid + ".json"), "w", encoding="utf-8") as f: + json.dump(rec, f, ensure_ascii=False, indent=1) + # 走「呼叫金钻」同一套通知:他手机能收到 + try: + with open(CALLS_FILE, "a", encoding="utf-8") as f: + f.write(json.dumps({"ts": rec["ts"], "ip": ip, "order": rec["order"], + "notified": False, "kind": "反馈", + "note": (note or "(只传了图)")[:120]}, ensure_ascii=False) + "\n") + except OSError: + pass + log("反馈 %s | 单 %s | 图 %s | %s" % (fid, rec["order"] or "-", rec["image"] or "无", (note or "")[:60])) + return self.js({"ok": True, "id": fid}) + + def my_coupons(self): + """批量查券的状态(页面把券存在浏览器里,进来时刷一次状态:可用/已用/已过期 + 还剩多久)""" + d = self.body_json() or {} + codes = [re.sub(r"[^A-Za-z0-9-]", "", str(x)).upper()[:20] + for x in (d.get("codes") or [])][:60] + return self.js({"ok": True, "list": [coupon_status(c) for c in codes if c]}) + + def gift_take(self): + """领一张福利券 → 返回券码(拿去「卡密下单」用,免费)""" + d = self.body_json() or {} + ok, r = gift_claim(str(d.get("batch") or "").strip(), d.get("token") or "", ip_of(self)) + if not ok: + return self.err(r) + return self.js({"ok": True, "gift": r}) + + def mark_paid(self): + """买家点「我付好了」→ unpaid 转 paid(待激活)。 + + 为什么要这一档:买家付完钱到金钻确认到账之间有一段空窗, + 没这个状态买家只能干等、金钻也不知道该查哪几单(2026-09-30 金钻提)。 + """ + d = self.body_json() or {} + oid, tok = (d.get("oid") or "").strip(), d.get("token") or "" + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + if m.get("state") == "paid": + return self.js({"ok": True, "state": "paid", "at": m.get("paid_at")}) + if m.get("state") != "unpaid": + # 2026-10-04(金钻反馈:买家看到「提交失败:状态是 working,不需要再报付款了」很懵): + # 单已经在处理了不是错误 —— 返回 ok,前端就不会显示"提交失败"。 + _stn = {"paid": "已登记付款", "waiting": "排队中", "working": "正在渲染", + "done": "已完成", "failed": "渲染失败", "void": "已注销"}.get(m.get("state"), m.get("state")) + return self.js({"ok": True, "already": True, "state": m.get("state"), + "msg": "这一单已经在处理了(%s),不用再报付款~" % _stn}) + m["state"] = "paid" + m["paid_at"] = now().isoformat(timespec="seconds") + with LOCK: + write_meta(oid, m) + log("订单 %s 买家报「已付款」,等金钻激活" % oid) + return self.js({"ok": True, "state": "paid", "at": m["paid_at"]}) + + def _extend_expire(self, m, base_iso): + """开放下载时把保留期顺延成「这之后 72 小时」(金钻 2026-09-30 晚)。 + ⚠️ 只往后延,不往前缩 —— 免得把已经写好的到期时间改早、文件提前被清。""" + try: + want = datetime.fromisoformat(base_iso) + timedelta(hours=KEEP_HOURS) + except (TypeError, ValueError): + return + try: + cur = datetime.fromisoformat(m.get("expire") or "") + except (TypeError, ValueError): + cur = None + if cur is None or want > cur: + m["expire"] = want.isoformat(timespec="seconds") + + def accept(self): + """买家「确认收货」—— 看过 512 预览、认了,才放原图(金钻 2026-09-30)。""" + d = self.body_json() or {} + oid, tok = (d.get("oid") or "").strip(), d.get("token") or "" + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + if m.get("state") != "done": + return self.err("还没出图,等渲染完成再收货") + if m.get("accepted"): + return self.js({"ok": True, "accepted": True, "at": m.get("accepted_at")}) + m["accepted"] = True + m["accepted_at"] = now().isoformat(timespec="seconds") + # 保留期从此顺延 72 小时(金钻 2026-09-30 晚:核销与清理都以「开放下载」为起算点) + self._extend_expire(m, m["accepted_at"]) + with LOCK: + write_meta(oid, m) + log("订单 %s 买家已确认收货(成品保留到 %s)" % (oid, m.get("expire"))) + return self.js({"ok": True, "accepted": True, "at": m["accepted_at"]}) + + def download(self, oid, idx, tok, q=None): + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + files = m.get("files") or [] + if idx < 0 or idx >= len(files): + return self.err("not found", 404) + # ⚠️ 收货闸:没点「确认收货」不给原图(金钻 2026-09-30)。 + # 预览也走这个接口,用 ?p=1 取 —— 预览本来就是给看不给下的。 + if not m.get("accepted") and not m.get("direct") and (q.get("p") or [""])[0] != "1": + return self.err("还没确认收货:先看 512 预览,点「确认收货」后才能下载原图", 403) + if (q.get("p") or [""])[0] == "1": + rel = files[idx].get("prev") + if not rel: + return self.err("预览还没生成好,稍后再试", 404) + else: + rel = files[idx].get("path") + path = os.path.join(order_dir(oid), rel) + if not os.path.exists(path): + return self.err("文件已过期或不存在", 404) + with open(path, "rb") as f: + data = f.read() + name = files[idx].get("name") or "out.png" + # ⚠️ HTTP 头只能是 latin-1:中文文件名直接写进 filename= 会 UnicodeEncodeError, + # 连接被掐断 → nginx 侧看到 502。必须给 ASCII 回退名 + RFC 5987 的 filename*= + ascii_name = re.sub(r"[^A-Za-z0-9._-]", "_", name) or "out.png" + disp = ("attachment; filename=\"%s\"; filename*=UTF-8''%s" + % (ascii_name, quote(name, safe=""))) + ctype = "image/jpeg" if rel.lower().endswith(".jpg") else "image/png" + # ⚠️ no-store:成品/预览是同名覆盖的,重渲后绝不能让浏览器拿缓存里的旧图 + if (q.get("p") or [""])[0] == "1": + self._send(200, data, ctype, {"Cache-Control": "no-store"}) # 预览内联显示,不强制下载 + else: + self._send(200, data, ctype, {"Content-Disposition": disp, "Cache-Control": "no-store"}) + + def skin(self, oid, sid="s1"): + m = read_meta(oid) + if not m: + return self.err("not found", 404) + sk = [x for x in skins_of(m) if x.get("id") == sid] + if not sk: + return self.err("没有这张皮肤", 404) + # ⚠️ 优先读 skins/.png:重渲换皮肤写的是这个文件。老单(2026-10-04 之前 + # 换过皮肤的)meta 里的 path 还指着旧的 skin.png,这样兜住不用手工改数据。 + cand = [os.path.join(order_dir(oid), "skins", "%s.png" % sid), + os.path.join(order_dir(oid), sk[0].get("path") or "skin.png")] + path = next((p for p in cand if os.path.exists(p)), cand[-1]) + if not os.path.exists(path): + return self.err("not found", 404) + with open(path, "rb") as f: + data = f.read() + self._send(200, data, "image/png") + + def hb(self): + if not self.is_worker(): + return self.err("forbidden", 403) + d = self.body_json() or {} + # 顺手记下渲染机的出口 IP —— 管理后台面板靠它把门(见 admin_ip_ok) + ip = ip_of(self) + if ip and ip not in ("?", "localhost"): + note_home_ip(ip) + jsave(HB_IPS_FILE, {"ips": HOME_IPS}) + with LOCK: + status_cache_clear() + jsave(HB_FILE, {"ts": now().isoformat(timespec="seconds"), + "host": (d.get("host") or "render")[:40]}) + return self.js({"ok": True, "queue": len(list_orders(("waiting",)))}) + + def claim(self): + """渲染机取一单(原子)。没有待办返回 {ok:True, order:null}""" + if not self.is_worker(): + return self.err("forbidden", 403) + with LOCK: + # 渲染机中途挂掉/断电:working 卡太久的单子自动退回队列重排 + stale = now() - timedelta(minutes=STALE_MIN) + for mm in list_orders(("working",)): + try: + st = datetime.fromisoformat(mm.get("started") or mm.get("created")) + except (TypeError, ValueError): + st = stale - timedelta(days=1) + if st < stale: + mm["state"] = "waiting" + mm["note"] = "渲染机中断,已自动退回队列" + write_meta(mm["oid"], mm) + log("回退 %s(渲染机中断)" % mm["oid"]) + waiting = list_orders(("waiting",)) + if not waiting: + return self.js({"ok": True, "order": None}) + # 排序:小单先出;4096 这种重单先让路,等够 HEAVY_WAIT_MIN 就恢复正常排队 + waiting.sort(key=order_rank) + m = waiting[0] + m["state"] = "working" + m["started"] = now().isoformat(timespec="seconds") + # 整单重出(网页单/换皮肤的重渲)才清空成品清单; + # 「只重渲勾的那几张」时必须留着 —— 清了的话没重渲的成品就永远回不来了(金钻 2026-10-04) + if not m.get("redo_tpls"): + m["files"] = [] + write_meta(m["oid"], m) + log("派单 %s → 渲染机" % m["oid"]) + return self.js({"ok": True, "order": { + "oid": m["oid"], "arm": m["arm"], "templates": m["templates"], + "created": m["created"], "skin_size": m.get("skin_size"), + "res": int(m.get("res") or DEFAULT_RES), + "redo_tpls": (m.get("redo_tpls") or []), "keep_n": len(m.get("files") or []), "codes": m.get("codes"), + # 皮肤清单(金钻 2026-10-01):渲染机按「每张皮肤 × 每个模板」出图, + # 每张皮肤各自带臂型(A 可能粗臂、B 可能细臂) + "skins": [{"id": x.get("id"), "fileName": x.get("fileName"), "arm": x.get("arm"), + "tpls": skin_tpls(m, x)} for x in skins_of(m)], + }}) + + def tick(self, oid, tok): + """轻量心跳:只回「状态 + 进度」。 + + 详情接口每次要读 meta + stat 一堆文件,不敢几秒问一次;这个只读 meta, + 所以前端可以 4 秒一轮 —— 渲染机一领单、进度一动,页面上立刻能看见。 + """ + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + files = m.get("files") or [] + return self.js({"ok": True, + "state": m.get("state"), + "n": len(files), + "started": m.get("started"), + "finished": m.get("finished"), + "progress": m.get("progress"), + "accepted": bool(m.get("accepted")) or bool(m.get("direct"))}) + + def progress(self): + """渲染机报「渲到哪了」(金钻 2026-10-04:买家得看得见进度)。 + + 允许它漏报、报错、断线 —— **绝不能因为这个影响出图**,所以任何异常都当"收到,忽略"。 + """ + if not self.is_worker(): + return self.err("forbidden", 403) + d = self.body_json() or {} + oid = (d.get("oid") or "")[:20] + m = read_meta(oid) + if not m: + return self.err("订单不存在", 404) + try: + idx = int(d.get("idx") or 0) + total = int(d.get("total") or 0) + pct = int(d.get("pct") or 0) + except (TypeError, ValueError): + return self.js({"ok": True, "ignored": True}) + pct = max(0, min(100, pct)) + if total < 0 or total > MAX_IMAGES: + total = 0 + m["progress"] = {"idx": max(0, idx), "total": total, "pct": pct, + "tpl": (d.get("tpl") or "")[:20], + "at": now().isoformat(timespec="seconds")} + with LOCK: + write_meta(oid, m) + return self.js({"ok": True}) + + def finish(self): + """渲染机交回成品(**一张一次**,避免单次请求过大): + {oid, total, results:[{tpl,name,png}], note} + 收满 total 张才把单子标成 done。""" + if not self.is_worker(): + self.close_connection = True + return self.err("forbidden", 403) + d = self.body_json(MAX_BODY_WK) + if not d or not d.get("oid"): + return self.err("参数不合法") + oid = d["oid"] + m = read_meta(oid) + if not m: + return self.err("订单不存在", 404) + # 渲染机带回来的"皮肤节点认了谁"日志 —— 存进订单 meta,云端能直接查 + # (2026-10-01:模板认错皮肤节点时,不用再去宿主翻渲染机日志) + if d.get("diag"): + m["skin_diag"] = [str(x)[:240] for x in (d.get("diag") or [])][:8] + write_meta(oid, m) + log("皮肤节点判定(%s):%s" % (oid, " | ".join(m["skin_diag"]))) + outdir = os.path.join(order_dir(oid), "out") + os.makedirs(outdir, exist_ok=True) + files = m.get("files") or [] + for r in (d.get("results") or [])[:MAX_IMAGES]: + png = r.get("png") or "" + try: + data = base64.b64decode(png.split(",", 1)[-1]) + except Exception: + continue + if not data or len(data) > MAX_BODY_WK: + continue + name = re.sub(r"[^0-9A-Za-z_\u4e00-\u9fa5.-]", "_", (r.get("name") or "out.png"))[:60] + if not name.lower().endswith(".png"): + name += ".png" + fn = "out/%s" % name + with open(os.path.join(order_dir(oid), fn), "wb") as f: + f.write(data) + entry = {"name": name, "path": fn, "tpl": (r.get("tpl") or "")[:20], + "skin": (r.get("skin") or "s1")[:8]} + # 渲染机报的单张耗时 → 存进订单,并喂给「按模板估时」的历史样本 + if r.get("sec"): + try: + entry["sec"] = round(float(r["sec"]), 1) + note_tpl_time(entry["tpl"], entry["sec"]) + except (TypeError, ValueError): + pass + if r.get("seq") and not m.get("seq"): + m["seq"] = int(r["seq"]) # 留档序号(渲染机给的,小票上印) + # 512 水印预览:服务器自己生成,渲染机不用多装东西。 + # ⚠️ 只给「标准压缩」那张做 —— 「无压缩」是同一画面另存,再做一遍纯浪费(金钻 2026-10-01 反馈:预览列表里重复出现两张一样的) + is_raw = "无压缩" in name + if not is_raw: + pv = make_preview(oid, os.path.join(order_dir(oid), fn), name, len(files)) + if pv: + entry["prev"] = pv + else: + entry["prev_failed"] = True # 交给下面的「水印没做好就不许标完成」闸门 + # 重渲会把同名图重新交上来 —— 按名字替换,别在列表里堆两份(2026-10-02 加重渲时发现) + files = [f for f in files if (f.get("name") or "") != name] + files.append(entry) + total = int(d.get("total") or len(m.get("templates") or []) or 1) + m["files"] = files + if d.get("note"): + m["note"] = str(d["note"])[:300] + # 收满 total 张,或渲染机显式收单(有部分失败时用 close),都算这单结束 + # ⚠️ 水印/预览没做出来的图,**不许标「已完成」**(金钻 2026-10-01: + # 「如果水印没有做好,请不要标记渲染完成」)—— 不然买家看到「已完成」却既看不了 + # 预览也下不了原图(收货闸挡着),等于卡死。宁可标 failed 让金钻/苏达看到。 + bad_prev = [f.get("name") for f in files + if not f.get("prev") and "无压缩" not in (f.get("name") or "")] + if len(files) >= total or d.get("close"): + if bad_prev: + m["state"] = "failed" + m["note"] = ("预览水印没生成出来(%s),已拦下不让买家看到「已完成」。" + "金钻/苏达用 admin.py retry <单号> 退回重渲即可。" + % "、".join(bad_prev))[:300] + log("⚠️ %s 预览缺失 %s → 标 failed(水印闸门)" % (oid, bad_prev)) + else: + m["state"] = "done" + m["finished"] = now().isoformat(timespec="seconds") + m.setdefault("accepted", False) # 收货闸:没确认只能看 512 预览 + if m.get("direct"): + # 直发单不用确认收货 —— 渲完就是「开放下载」,保留期/核销都从这一刻起算 + self._extend_expire(m, m["finished"]) + m["note"] = m.get("note") or "" + with LOCK: + write_meta(oid, m) + log("回传 %s | %d/%d 张%s" % (oid, len(files), total, " 完成" if m["state"] == "done" else "")) + return self.js({"ok": True, "n": len(files), "total": total, + "done": m["state"] == "done"}) + + def fail(self): + if not self.is_worker(): + return self.err("forbidden", 403) + d = self.body_json() or {} + oid = d.get("oid") + m = read_meta(oid) if oid else None + if not m: + return self.err("订单不存在", 404) + m["state"] = "failed" + m["note"] = (d.get("note") or "渲染失败")[:300] + # 渲染机把 Blender 的日志尾巴和"皮肤节点判定"一起带回来 —— 失败时最需要它 + if d.get("log_tail"): + m["fail_log"] = str(d["log_tail"])[-4000:] + if d.get("diag"): + m["skin_diag"] = [str(x)[:240] for x in (d.get("diag") or [])][:8] + with LOCK: + write_meta(oid, m) + log("失败 %s | %s%s" % (oid, m["note"], + (" | " + " ".join(m.get("skin_diag") or [])) if m.get("skin_diag") else "")) + return self.js({"ok": True}) + + def call(self): + d = self.body_json() or {} + ip = self.headers.get("X-Real-IP") or self.client_address[0] + nowt = now() + # 限频:同 IP 10 分钟内最多 3 次 + try: + recent = [json.loads(l) for l in open(CALLS_FILE, encoding="utf-8") if l.strip()] + except OSError: + recent = [] + n = sum(1 for r in recent[-50:] if r.get("ip") == ip + and (nowt - datetime.fromisoformat(r["ts"])).total_seconds() < 600) + if n >= 3: + return self.js({"ok": True, "throttled": True}) + rec = {"ts": nowt.isoformat(timespec="seconds"), "ip": ip, + "order": (d.get("order") or "")[:20], + # 买家写的原因 + 留下的邮箱(金钻 2026-10-04:要在「有问题」那一屏直接呼叫, + # 得让金钻知道到底出了什么事、修好之后找谁) + "note": (d.get("note") or "")[:600], + "email": (d.get("email") or "")[:120], + "notified": False} + with open(CALLS_FILE, "a", encoding="utf-8") as f: + f.write(json.dumps(rec, ensure_ascii=False) + "\n") + log("呼叫金钻 %s" % rec) + return self.js({"ok": True}) + + + # ------------------------------------------------------------ 打包下载(zip) + def receipt(self, oid, tok, as_file=False): + """整单收货凭证(小票)。没有 token 不给 —— 里面有卡密和出图清单。""" + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok or ""): + return self.err("not found", 404) + body = receipt_text(oid, m).encode("utf-8-sig") # 带 BOM:Windows 记事本不乱码 + extra = {"Cache-Control": "no-store"} + if as_file: + extra["Content-Disposition"] = ( + "attachment; filename=\"receipt-%s.txt\"; filename*=UTF-8''%s" + % (oid, quote("小票-%s.txt" % oid))) + self._send(200, body, "text/plain; charset=utf-8", extra) + + def download_zip(self, oid, tok): + """整单原图打一个 zip 发走(金钻 2026-09-30「挨个下太慢了,按需下载」)。 + + ⚠️ zip 先落临时文件、再边读边发 —— 这台机器只有 1.6G 内存(服务限额 256M), + 几十 MB 的成品绝不能整块读进内存。也不需要准确 Content-Length 之外的技巧。 + """ + m = read_meta(oid) + if not m or not hmac.compare_digest(m.get("token", ""), tok): + return self.err("not found", 404) + # 和单张下载同一个收货闸:没确认收货不给原图 + if not m.get("accepted") and not m.get("direct"): + return self.err("还没确认收货:先看 512 预览,点「确认收货」后才能下载原图", 403) + files = [f for f in (m.get("files") or []) if f.get("path")] + if not files: + return self.err("这一单还没有可下载的成品", 404) + base = order_dir(oid) + total = 0 + for f in files: + try: + total += os.path.getsize(os.path.join(base, f["path"])) + except OSError: + pass + if total <= 0: + return self.err("文件已过期或不存在", 404) + if total > MAX_ZIP_BYTES: + return self.err("这一单合计太大(%.0f MB),请一张一张下载" % (total / 1048576.0), 413) + os.makedirs(TMP_DIR, exist_ok=True) + fd, zpath = tempfile.mkstemp(prefix="ys-", suffix=".zip", dir=TMP_DIR) + os.close(fd) + try: + # 随包一份**收货凭证(小票)**:金钻 2026-10-01 —— 订单号/卡密/皮肤/逐张清单/ + # 分辨率/时间/留档序号/条款版本/保存期限,闲鱼对账、留证都用它。 + # ⚠️ 带 BOM(utf-8-sig):Windows 记事本打开中文才不乱码。 + with zipfile.ZipFile(zpath, "w", zipfile.ZIP_DEFLATED, compresslevel=1) as z: + z.writestr("小票.txt", receipt_text(oid, m).encode("utf-8-sig")) + for i, f in enumerate(files): + nm = re.sub(r'[\\/:*?"<>|]', "_", f.get("name") or ("out%d.png" % (i + 1))) + z.write(os.path.join(base, f["path"]), "%02d_%s" % (i + 1, nm)) + size = os.path.getsize(zpath) + zname = "金钻工坊-%s.zip" % oid + ascii_name = re.sub(r"[^A-Za-z0-9._-]", "_", zname) or "order.zip" + self.send_response(200) + self.send_header("Content-Type", "application/zip") + self.send_header("Content-Length", str(size)) + self.send_header("Cache-Control", "no-store") + self.send_header("Content-Disposition", + "attachment; filename=\"%s\"; filename*=UTF-8''%s" + % (ascii_name, quote(zname, safe=""))) + self.end_headers() + with open(zpath, "rb") as fh: + shutil.copyfileobj(fh, self.wfile, ZIP_CHUNK) + log("打包下载 %s | %d 张 %.1f MB" % (oid, len(files), size / 1048576.0)) + except (BrokenPipeError, ConnectionResetError): + log("打包下载 %s 被中断(买家关页面了)" % oid) + finally: + try: + os.remove(zpath) + except OSError: + pass + + # ------------------------------------------------------------ 管理接口(面板) + def admin_gate(self): + """金钻电脑上那块后台面板的通行证 —— 两道门都要过: + ① 令牌对得上(/admin_token,和 worker_token 一个路子) + ② 来源 IP 是「渲染机心跳认出来的出口 IP」= 金钻家网络的公网出口 + 所以**公网上别处扫到也是 403**:令牌泄露了外人也进不来。 + """ + ip = ip_of(self) + if not hmac.compare_digest(self.headers.get("X-Admin-Token") or "", AT): + log("管理接口拒绝:令牌不对 (%s %s)" % (ip, self.path[:40])) + return False + if not admin_ip_ok(ip): + log("管理接口拒绝:IP 不在白名单 (%s)" % ip) + return False + return True + + def admin_ping(self): + hbs = heartbeat(force=True) + cs = load_codes() + st = [code_state(r) for r in cs.values()] + return self.js({"ok": True, "machine_online": hbs["online"], + "last_seen": hbs["last_seen"], "queue": hbs["queue"], + "working": hbs["working"], + "codes_active": st.count("active"), "codes_used": st.count("used"), + "codes_bound": st.count("bound"), + "pending": len(list_orders(("unpaid", "paid"))), + "home_ips": HOME_IPS, "tpl_keys": list(TPL_KEYS), + "price": PRICE_UNIT}) + + def admin_gen(self): + """后台一键生成卡密(金钻 2026-09-30:「我后台点击,上传」)。""" + d = self.body_json() or {} + try: + n = int(d.get("n") or 1) + except (TypeError, ValueError): + return self.err("数量不合法") + if not (1 <= n <= 200): + return self.err("一次生成 1~200 张") + platform = (d.get("platform") or "").strip()[:20] + batch = (d.get("batch") or "").strip()[:20] + try: + value = int(d.get("value") or PRICE_UNIT) + except (TypeError, ValueError): + value = PRICE_UNIT + tpls = [str(x).strip() for x in (d.get("tpls") or []) if str(x).strip()] + bad = [x for x in tpls if x not in TPL_KEYS] + if bad: + return self.err("模板不认识:%s" % "、".join(bad)) + is_set, direct = bool(d.get("set")), bool(d.get("direct")) + # 张数卡密(金钻 2026-09-30 晚):n_fix>0 固定张数;n_max>0 封顶;lock_tpl 锁模板 + try: + n_fix = int(d.get("n_fix") or 0) + n_max = int(d.get("n_max") or 0) + except (TypeError, ValueError): + return self.err("张数不合法") + if n_fix < 0 or n_max < 0 or n_fix > MAX_IMAGES or n_max > 100: + return self.err("张数不合法(固定张数最多 %d 张)" % MAX_IMAGES) + if n_fix and n_max and n_max < n_fix: + return self.err("封顶不能小于固定张数") + lock_tpl = bool(d.get("lock_tpl")) and bool(tpls) + if d.get("lock_tpl") and not tpls: + return self.err("要锁定模板,得先选模板") + n_free = bool(d.get("free")) + if n_free and n_fix: + return self.err("「不限张数」和「固定张数」只能选一个") + made = gen_codes(n, batch, value, platform, ",".join(tpls), + is_set=is_set, direct=direct, + n_fix=n_fix, n_max=n_max, lock_tpl=lock_tpl, n_free=n_free) + csv = "\n".join( + ["卡密,金额,平台,模板,套装,直发,固定张数,最多张数,锁定模板"] + + ["%s,%d,%s,%s,%s,%s,%s,%s,%s" % (c, value, platform, ",".join(tpls), + "是" if is_set else "", "是" if direct else "", + n_fix or "", n_max or "", "是" if lock_tpl else "") + for c in made]) + log("后台生成 %d 张卡密 | 平台=%s 模板=%s 套装=%s 直发=%s 固定=%s 封顶=%s 锁模板=%s" + % (n, platform or "-", ",".join(tpls) or "-", is_set, direct, + n_fix or "-", n_max or "-", lock_tpl)) + return self.js({"ok": True, "codes": made, "csv": csv, "value": value, + "platform": platform, "tpls": tpls, + "set": is_set, "direct": direct, + "n_fix": n_fix, "n_max": n_max, "lock_tpl": lock_tpl, + "free": n_free}) + + def admin_orders(self, q): + want = tuple(x for x in ((q.get("state") or [""])[0]).split(",") if x) + try: + limit = min(int((q.get("limit") or ["40"])[0]), 200) + except ValueError: + limit = 40 + # 2026-10-04 金钻:面板要能看「这一单渲了什么」→ 传 done=1 就把已完成的也带上 + inc_done = bool(q.get("done") or "done" in want) + rows = [] + for m in list_orders(want or None): + if m.get("state") in ("done",) and not inc_done: + continue + rows.append({ + "oid": m.get("oid"), "state": m.get("state"), + "created": m.get("created"), "paid_at": m.get("paid_at"), + "amount": price_for(img_total(m)), + "n_img": img_total(m), + "templates": m.get("templates") or [], + "codes": m.get("codes") or [], + "skins": [x.get("fileName") for x in skins_of(m)], + "accepted": bool(m.get("accepted")), + "files": len(m.get("files") or []), + "reported_paid": m.get("state") == "paid", + "note": m.get("note") or "", + }) + rows.sort(key=lambda r: r.get("created") or "", reverse=True) + return self.js({"ok": True, "orders": rows[:limit]}) + + def admin_codes(self, q): + try: + limit = min(int((q.get("limit") or ["60"])[0]), 500) + except ValueError: + limit = 60 + want = (q.get("state") or [""])[0].strip() + out = [] + for c, r in load_codes().items(): + st = code_state(r) + if want and st != want: + continue + out.append({"code": c, "state": st, "platform": r.get("platform"), + "tpl": r.get("tpl"), "set": bool(r.get("set")), + "direct": bool(r.get("direct")), "batch": r.get("batch"), + "n_fix": int(r.get("n_fix") or 0), "n_max": int(r.get("n_max") or 0), + "lock_tpl": bool(r.get("lock_tpl")), + "order": r.get("order"), "ts": r.get("ts")}) + out.sort(key=lambda r: r.get("ts") or "zzz", reverse=True) + return self.js({"ok": True, "codes": out[:limit], "total": len(out)}) + + def admin_code_edit(self): + """改一张**还没用掉**的卡密(金钻 2026-09-30 晚「这个也给你开 api,方便我管理和你介入」)。 + + 典型用法:买家说「我再加两张」→ 把这张码的固定张数从 3 改成 5; + 或者临时把码停掉(state=inactive)。 + """ + d = self.body_json() or {} + ok, e, info = edit_code(d.get("code"), d.get("patch")) + if not ok: + return self.err(e, 404 if "没有这张卡密" in e else 400) + return self.js({"ok": True, "code": info.get("code"), "info": info}) + + def admin_activate(self): + """收到钱 → 激活这一单,进队列开渲(等于 admin.py activate)。""" + d = self.body_json() or {} + oid = (d.get("oid") or "").strip().upper() + m = read_meta(oid) if oid else None + if not m: + return self.err("没有这个订单:%s" % oid, 404) + ok, msg = activate_order_paid(oid, source="后台激活") + if not ok: + return self.err("订单 %s :%s" % (oid, msg)) + return self.js({"ok": True, "oid": oid, "state": "waiting"}) + + def admin_void(self): + """注销「未激活」的订单(待付款 / 待激活)—— 只改状态,不删文件(金钻 2026-10-04)。 + 已经占住卡密的单不给注销,免得把码弄乱。""" + d = self.body_json() or {} + oid = (d.get("oid") or "").strip().upper() + m = read_meta(oid) if oid else None + if not m: + return self.err("没有这个订单:%s" % oid, 404) + st = m.get("state") + if st not in ("unpaid", "paid"): + return self.err("只有「待付款 / 待激活」的单能注销,这一单现在是「%s」" % st) + # 网页下单会给这一单预生成一张 inactive 码(还没生效、本来就用不了)——那不算占住; + # 只有真被用起来的码(active / bound / used)才拦(2026-10-04 实测踩到)。 + cs = load_codes() + busy = [c for c in (m.get("codes") or []) + if (cs.get(c) or {}).get("state") in ("active", "bound", "used")] + if busy: + return self.err("这一单已经占住卡密了(%s),不能注销" % "、".join(busy)) + with LOCK: + m["state"] = "void" + m["void_at"] = time.strftime("%Y-%m-%dT%H:%M:%S+08:00") + write_meta(oid, m) + return self.js({"ok": True, "oid": oid, "state": "void"}) + + def admin_note(self): + d = self.body_json() or {} + oid = (d.get("oid") or "").strip().upper() + m = read_meta(oid) if oid else None + if not m: + return self.err("没有这个订单", 404) + m["note"] = str(d.get("note") or "")[:300] + with LOCK: + write_meta(oid, m) + return self.js({"ok": True}) + + # ---- 福利券(免费码):面板 / CLI 双入口(金钻 2026-10-02)---- + # 逻辑全在 gift_batch_new / gift_batch_add / gift_batch_off(模块级), + # 这里只做「取参 → 调它 → 回 JSON」,**别再写一遍业务**。 + def admin_gifts(self): + """批次全貌 + 领取情况(谁在什么时候、哪个 IP 领了哪张)+ 剩余券池。""" + return self.js(gift_admin_view()) + + def admin_gift_new(self): + d = self.body_json() or {} + n_fix = d.get("n_fix") + if n_fix in (None, ""): + n_fix = 1 # 不给就按「最多 1 张」;给 0 = 不限(配合 n_free) + # ⚠️ 别写成 `d.get("count") or 20`:显式传 0 会被静默当成 20(自测当场抓到)。 + # 缺省才是 20,非法值要原样交给 gift_batch_new 拦下来。 + count = d.get("count") + if count in (None, ""): + count = 20 + try: + bid, codes = gift_batch_new( + d.get("name"), count=count, n_fix=n_fix, + n_free=bool(d.get("n_free")), tpl=d.get("tpl") or "", + lock_tpl=bool(d.get("lock_tpl")), days=d.get("days") or 0, + note=d.get("note") or "", kind=d.get("kind") or "render", + direct=bool(d.get("direct", True))) + except ValueError as e: + return self.err(str(e), 400) + log("后台新建福利券批次 %s(%d 张)" % (bid, len(codes))) + return self.js({"ok": True, "batch": bid, "codes": codes, "n": len(codes)}) + + def admin_gift_add(self): + d = self.body_json() or {} + count = d.get("count") # 同上:0 不能被 `or 20` 吃掉 + if count in (None, ""): + count = 20 + try: + got = gift_batch_add(d.get("batch"), count, + direct=None if d.get("direct") is None + else bool(d.get("direct"))) + except ValueError as e: + return self.err(str(e), 404 if "没有这个批次" in str(e) else 400) + log("后台给福利批次 %s 补货 %d 张" % (d.get("batch"), len(got))) + return self.js({"ok": True, "batch": d.get("batch"), "codes": got, "n": len(got)}) + + def admin_gift_off(self): + d = self.body_json() or {} + try: + gift_batch_off(d.get("batch")) + except ValueError as e: + return self.err(str(e), 404 if "没有这个批次" in str(e) else 400) + log("后台收摊福利批次 %s" % d.get("batch")) + return self.js({"ok": True, "batch": d.get("batch")}) + + +def main(): + for d in (ROOT, ORDERS, TMP_DIR): + os.makedirs(d, exist_ok=True) + srv = ThreadingHTTPServer((HOST, PORT), H) + srv.daemon_threads = True + log("ys-order 启动 %s:%d | 数据 %s | 保留 %dh" % (HOST, PORT, ROOT, KEEP_HOURS)) + srv.serve_forever() + + +if __name__ == "__main__": + try: + main() + except KeyboardInterrupt: + sys.exit(0) diff --git a/backend/backend-site/交接说明.md b/backend/backend-site/交接说明.md new file mode 100644 index 0000000..be5a7be --- /dev/null +++ b/backend/backend-site/交接说明.md @@ -0,0 +1,247 @@ +# 交接说明 · 网站后端(卡密 / 自助渲染下单) + +> **交付方**:苏达(网站运维与技术提供) +> **收件方**:外部协作者 +> **日期**:2026-10-05 +> **一句话**:这是一个**零依赖单进程**的下单/卡密/队列后端,跑在一台小机器上。 +> 请你重点看**安全与并发**,并给我们**问题分析 + 改正意见**(见最后一节)。 + +--- + +## 一、这一份是什么 + +「自助模板渲染」的**服务端**:买家在网页挑模板、传皮肤、填卡密下单; +服务器登记订单、排队;家里那台渲染机上线后自动领单、出图、回传; +买家再回来下载。**目标是无人值守** —— 不用人 24 小时盯着。 + +``` +买家 → 网页(本地质检→选模板→填卡密→核对)→ POST /api/submit + ↓ 核销卡密 + 落盘订单目录 +服务器 → 队列(订单 meta 里的一个 state 字段:waiting/working/done/failed) +渲染机 → 每 20s:POST /hb → POST /claim → GET /skin/<单号> + → Blender 渲染 → POST /progress(进度)→ POST /finish(一张一次) +买家 → GET /api/order/<单号>?t=<口令> → 下载 /api/dl/<单号>/?t=<口令> +``` + +**为什么"渲染机是主动出站"**:家里那台机器没有公网入口,所以**服务器从不连它**, +全靠它自己定时来拉。心跳超过阈值没更新 → 页面显示「渲染机离线」。 + +--- + +## 二、技术栈与运行方式 + +| 项 | 值 | +|---|---| +| 语言 / 依赖 | **Python 3,纯标准库,零第三方依赖**(连 Web 框架都没用,`BaseHTTPRequestHandler`) | +| 进程 | 单进程,由 systemd 托管;内存上限被 cgroup 卡住(小机器上防它吃爆) | +| 监听 | **只绑回环**,公网由 nginx 反代过去(后端自己不对外开端口) | +| 账号 | 跑在专用非 root 用户下 | +| 数据 | 全在本地文件 + 一个 SQLite(无外部服务) | +| 规模 | 单机单进程,日单量个位数到几十 | + +**为什么不用框架**:这台机器很小(1G 多内存),装一个 Web 框架 + 一堆传递依赖不划算, +而且这台机器**不允许跑重活**(视频转码这类会把它拖死)。纯标准库启动快、内存稳。 + +--- + +## 三、文件清单 + +| 文件 | 行数 | 干什么 | +|---|---|---| +| `server.py` | ~3100 | **全部服务端逻辑**:路由、订单状态机、卡密生命周期、限流、PNG 结构核验的调用方、爱发电回调、打包下载、小票生成 | +| `admin.py` | ~540 | 命令行管理工具:发卡密 / 看队列 / 重渲 / 清过期 / 审计被拦记录 | +| `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG | + +> 这三个文件是**自足**的:没有 import 本项目之外的模块。 + +--- + +## 四、对外接口 + +全部挂在 `/order/api/` 下(nginx 反代);下面路径已按脱敏规则替换过前缀,**看形状别看字面**。 + +| 方法 | 路径 | 谁用 | 说明 | +|---|---|---|---| +| GET | `/api/status` | 页面轮询 | 渲染机在线?队列长度 | +| POST | `/api/submit` | 页面 | 皮肤(base64) + 模板数组 + 卡密数组 + 臂型 → 返回 `{order, token}` | +| POST | `/api/add-skin` | 页面 | 追补一张皮肤(多皮肤单) | +| POST | `/api/set-templates` | 页面 | 改/补模板(可只改某一张皮肤的) | +| GET | `/api/order/<单号>?t=<口令>` | 页面 | 状态 + 可下载文件清单 + 进度 + 预计耗时 | +| GET | `/api/dl/<单号>/?t=<口令>` | 买家 | 下载成品(未收货只能拿预览) | +| GET | `/api/zip/<单号>?t=` | 买家 | 整单原图打 zip(先落临时文件再边读边发) | +| GET | `/api/receipt/<单号>?t=` | 买家 | 小票纯文本(`&dl=1` 变附件) | +| POST | `/api/accept` | 买家 | 确认收货 → 才放原图 | +| POST | `/api/paid` | 买家 | 「我付好了」 | +| POST | `/api/activate` | 买家 | 用卡密**激活自己那一单**(码认单,不开新单) | +| POST | `/api/redo` | 买家 | 重渲(支持只重出勾中的那几张) | +| POST | `/api/call` | 页面 | 呼叫店主(同 IP 限次) | +| POST | `/api/feedback` | 页面 | 反馈(落盘 + 通知) | +| GET | `/api/payinfo` | 页面 | 付款方式(链接/收款码) | +| POST | `/api/payplatform-hook` | 支付平台回调 | **不验签,改成拿开放接口反查这笔单**(见下) | +| POST | `/api/hb` `/api/claim` `/api/skin/<单号>` `/api/progress` `/api/finish` `/api/fail` | **渲染机** | 都要请求头里的 worker token | +| GET/POST | `/api/admin/*` | **本机后台面板** | 头里带 admin token **且**来源 IP 必须是家里出口 IP | + +### 支付回调的处理顺序(这段是重点,欢迎挑刺) + +``` +① 标题含"测试" → 只记账 +② 幂等:同一平台单号重推 → 回同一张卡密 +③ 反查不到 / 未付款 → 只记账 + 标 need_human,**绝不发卡密** +④ 金额比对: + 少付(paid + 0.005 < need)→ **闸门拦死**,不激活不发码,记 need_human + 多付 → 照样激活出图,但记 over 待人工看一眼 +⑤ 认单优先级:自定义订单号 > 留言里的卡密 > 留言里的订单号 > 「只有一笔待付款单金额对得上」 + (两笔及以上一律人工,绝不乱认) +``` + +--- + +## 五、数据形状(都是文件/JSON,没有数据库表) + +| 路径 | 内容 | +|---|---| +| `/codes.json` | 卡密池:`{码: {state, platform, tpl, n_fix, n_free, n_max, lock_tpl, oid, order, batch}}` | +| `/orders/<单号>/meta.json` | 订单:状态、皮肤数组、模板、金额、时间、条款留证、进度 | +| `/orders/<单号>/skins/` | 买家皮肤原图(落盘前已过 PNG 结构核验并剥掉元数据块) | +| `/orders/<单号>/out/` | 成品(标准压缩 + 无压缩 两个版本/张) | +| `/worker_token`、`admin_token` | 两把**互不通用**的令牌(文件权限 600) | +| `/home_ips.json` | 渲染机心跳认出来的「家里的出口 IP」 | +| `/calls.jsonl` | 「呼叫店主」记录 | +| `/upload.log` 等 | 审计留痕 | + +### 卡密生命周期(**激活 ≠ 核销**,这是刻意分开的) + +``` +active 可用 + ↓ 买家点提交 +bound **已激活** —— 被这一单占住,不能用于别的单;但还没核销 + ↓ 成品开放下载满 72 小时(或直发单从渲完起算) +used **已核销** —— 终态 +inactive 停用(网页单等付款 / 手动停用) +``` + +⚠️ 触发核销的只有两处,**删文件之前必须先核销**,否则文件没了码还挂在"已激活"。 + +--- + +## 六、已经做了的防护(请你对着挑漏) + +| 防护 | 做法 | +|---|---| +| 卡密暴力破解 | 31 字符取 12 位 ≈ 7.9e17 组合;**单 IP 连错 15 次 → 冷却 15 分钟** | +| 灌单 | 单 IP 10 分钟最多开 6 单;提交接口在 nginx 上单独限流 | +| 探测 | **「订单不存在」与「口令错」返回同一个 404**(不承认站上有这单) | +| 占盘 | 磁盘剩余低于阈值**停止收单** | +| 夹带私货 | PNG 结构核验:拒尾部追加 / 未知关键块 / APNG;剥掉文本与 EXIF 类元数据块 | +| 取皮肤 | 必须带 worker token | +| 管理接口 | **两道门**:token + 来源 IP 必须是家里出口 IP(公网别处扫到也是 403) | +| 路径穿越 | slug 白名单 + realpath 前缀校验 | + +--- + +## 七、⚠️ 脱敏说明(**重要:这份代码不能直接跑**) + +按我们的出站纪律,**所有指向真实环境的值都换成了占位**: + +| 类别 | 替换成 | +|---|---| +| 站点域名 / 支付平台域名 | `shop.example.com` / `pay-platform.example` | +| 监听端口、面板端口 | 中性数字(`8080`/`8081`/`8082`…)—— **不是真值** | +| 数据 / 程序 / 工作目录 | `` / `` / `` | +| Windows 盘符路径 | `` / `` / `` | +| 家里出口 IP / 局域网 IP | `` / `` | +| 通配绑定地址 | `` | +| 密钥 / 令牌**值** | 本来就没有硬编码——全走文件与环境变量,所以代码里是干净的 | + +**保留未换的**:`localhost`(回环,通用值)、渲染分辨率 `1000/1024/2048/4096`(业务常量)、 +以及**品牌笔名**(属公开署名)。 + +**包里没有的**(⚠️ 别去找,是刻意不给): +- 任何真实卡密、订单、买家皮肤与成品图 +- 两把令牌、任何密钥、任何账号凭据 +- 数据库/运行数据、备份 +- 私有仓库地址、内部文档 + +--- + +## 八、⭐ 我们要你交给我们的东西(**这一份的主要目的**) + +请你读完之后**回一份文档**(放在同一个仓库里就行,文件名 `回执-<你的名字>.md`),至少包含三部分: + +1. **问题分析** —— 你看到的问题、风险、坏味道。分个轻重(会导致丢钱/丢数据/被人打的,排前面)。 + 请**尽量指到具体函数/行**,并说清**触发条件**(什么输入、什么并发时序会踩到)。 +2. **改正意见** —— 每条给**你建议怎么改**(不一定要写代码,说清思路和代价也行)。 + 如果有**更简单的整体方案**(比如"这段根本该换个做法"),也请直说,别客气。 +3. **你改了什么** —— 如果你直接动手改了,请逐条列: + ``` + 文件 / 函数: + 为什么改: + 改成什么(一句话说清): + 有没有动到接口路径、请求/响应字段、数据格式(**这三样动了我们必须知道**): + 你怎么验证的(跑过什么、看到什么): + ``` + ⚠️ **改了接口/数据格式一定要单独标出来** —— 渲染机那边是另一台机器上的另一份代码, + 两边不同步会**静默出不来图**。 + +**另外请你顺手回答两个具体问题**(我们自己拿不准): +- 爱发电那条线**"不验签、改成拿开放接口反查"**,你认为够不够硬?有没有更好的做法? +- 订单状态机(`unpaid → paid → waiting → working → done/failed`)在**部分失败**时 + (比如 3 张图渲出 2 张)你建议怎么收口? + + +--- + +## 九、我们的思路与方法(**请你连这套做法一起评**) + +代码能看出的是一部分;**为什么这么做、踩过什么坑**,在代码里看不到。这一节补上, +**并且希望你连"做法"本身一起挑** —— 如果我们整套思路就是错的,那比某个函数写错更要紧。 + +### 9.1 我们给自己定的几条硬规矩 + +| 规矩 | 为什么 | +|---|---| +| **无人值守优先**:机器的活不该让人 24 小时待命 | 这行的买家半夜下单是常态,靠人盯必然漏 | +| **正常用户一步都不多加**:每加一道防探测,先问"正常买家会不会被误伤" | 防的是坏人,误伤的是给你钱的人。两者冲突时**先保买家** | +| **收钱的数字一律以服务器订单为准**,本地状态只能当兜底 | 踩过:恢复订单时本地状态是空的,按本地算出错的金额去拼付款链接 → 买家少付 → 闸门拦死。**同一行显示两个来源的数,必然自相矛盾** | +| **状态话术不许骗人** | 踩过:没付款的单子被兜底文案说成"正在排队"。宁可说"没取到订单信息",也不给假安心 | +| **出错要说清是什么、下一步怎么办**,不引导用户猜 | 报错是给人看的,不是给日志看的 | +| **同一件事的逻辑只写一处** | "CLI 一套、后台面板一套"必然漂移 —— 出现过面板和命令行生成出两种卡密 | + +### 9.2 我们干活的方法(改这块代码时照着来) + +1. **改一处 → 顺着所有调用点核一遍**。可见性逻辑被好几个入口调用,改了一处、 + 别的入口还传旧参数 → 出现"导航正常、首页却说没有可见内容"这种**看着像站坏了**的现象。 +2. **同一个东西存在两处时,先问"读取方是按哪个字段找的"**。改写入方不改读取方 = + 写进去了、读的还是旧的(踩过:换了皮肤文件、但路径字段没跟着改,买家看到"重渲了还是旧图")。 +3. **前端必须真的在浏览器里点一遍**。有一批 bug 在 API 层**根本测不出来** + (页面上某个渲染函数调了不存在的名字 → 每次进第 2 步就抛异常 → 页面看着"就是没反应")。 +4. **部署完要核对"跑的是不是新代码"**,不是"部署脚本说成功了"。 + 踩过:脚本全程报成功、功能静默缺失 —— 旧进程还活着,计划任务的"运行"不会替换它。 +5. **自测的每一个负例各用一份新数据**。复用同一份的话,第一条成功就把它消耗了, + 后面几条测的其实是"已经用过了"—— **全绿,但什么都没测到**。 +6. **测完必须清场**。测试产生的记录不许留在管理员看得见的列表里。 + +### 9.3 我们付过学费的坑(这些是"不要重复踩"清单) + +- **静默失败最贵**:不报错、不崩,就是没效果 —— 比抛异常难查十倍。 + 所以我们宁可让它**响亮地失败**(比如离线就不显示预计时间、宁可说"没取到")。 +- **显示层会骗人**:订单本身算对了,但界面从另一个来源取数 → 用户看到的是错的。 + **凡是"从 A 推导出 B"的函数,在别处读 B 之前都要先调一次它**。 +- **文件重复投递**:渲染机与服务器之间"一张图一次"回传,是因为一次全传会撞体积上限。 +- **重试要有上限也能收敛**:部分失败必须显式收尾,否则订单会永远停在"渲染中"、被反复重渲。 + +### 9.4 我们最想要你评的三件"做法" + +1. **"不验签、改成拿开放接口反查"**这个取舍,你认同吗?(我们手头没有对方的公钥,与其猜算法不如反查) +2. **订单状态机在部分失败时怎么收口**(3 张渲出 2 张)—— 我们现在靠"显式收尾",你觉得够不够。 +3. **这套"单文件纯标准库"的写法**:好处是零依赖零安装、小机器跑得动; + 代价是路由/校验/序列化全得自己写。**换你,你会不会上框架?** 请直说。 + +--- + +## 十、边界 + +- 这份是**私有交付**,**请勿外传 / 勿镜像 / 勿公开**(含截图、片段)。 +- 里面是**占位值**,请不要替换成任何真实地址再提交回来。 +- 有看不懂的先问,别猜着改 —— 猜错了我们这边会静默坏掉。 +- 你可以自由重构,但**动了接口/数据格式要按第 8 节单独标出来**。 diff --git a/backend/backend-tools/chk_worker.ps1 b/backend/backend-tools/chk_worker.ps1 new file mode 100644 index 0000000..641e830 --- /dev/null +++ b/backend/backend-tools/chk_worker.ps1 @@ -0,0 +1,8 @@ +# -*- coding: utf-8 -*- +# 核对渲染机进程:是不是这次部署之后起来的(光看"在线"不够 —— 旧进程也报在线) +$ps = @(Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*ys_worker.py*' }) +Write-Host "渲染机进程数:$($ps.Count)" +foreach ($p in $ps) { + $age = [math]::Round(((Get-Date) - $p.CreationDate).TotalMinutes, 1) + Write-Host (" PID {0} 启动于 {1} 已运行 {2} 分钟" -f $p.ProcessId, $p.CreationDate, $age) +} diff --git a/backend/backend-tools/deploy.py b/backend/backend-tools/deploy.py new file mode 100644 index 0000000..f33accc --- /dev/null +++ b/backend/backend-tools/deploy.py @@ -0,0 +1,124 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +把渲染机(worker)装到 Windows 宿主机上。 +链路:本机 → VM(ssh <跳板>) → Windows 宿主() + +用法:python3 /deploy.py +前提:宿主那台开着、隧道通(ssh <跳板> 能 echo 出东西) +""" +import json, os, subprocess, sys, time + +SRC = "" +STAGE = "" +HOST_DIR = "" +KEY_HOST = "" +KEY_VM = "" + + +def sh(cmd, timeout=180): + r = subprocess.run(cmd, shell=True, capture_output=True, text=True, timeout=timeout) + return r.returncode, ((r.stdout or "") + (r.stderr or "")).strip() + + +def step(title, cmd, timeout=180): + print("\n=== %s ===" % title) + rc, out = sh(cmd, timeout) + print(out[-2500:] if out else "(无输出)") + return rc, out + + +def main(): + # 0) 先确认隧道 + rc, out = sh("ssh -o ConnectTimeout=10 -o BatchMode=yes <跳板> 'echo vm-ok'", 40) + if "vm-ok" not in out: + sys.exit("隧道不通:先确认 VM 和宿主机都开着(%s)" % out[:200]) + + # 1) 组装 staging + os.makedirs(STAGE, exist_ok=True) + for f in ("ys_worker.py", "ys_local.py", "local.html", "ys_admin.py", + "run_worker.bat", "open_local.bat", "run_admin.bat", "stop_admin.bat", + "stop_worker.bat", "show_log.bat", "install_worker.ps1", + "pack_archive.bat", "pack_archive.ps1", "chk_worker.ps1"): + data = open(os.path.join(SRC, f), "rb").read() + if f.endswith(".ps1") and not data.startswith(b"\xef\xbb\xbf"): + data = b"\xef\xbb\xbf" + data # BOM:让 PowerShell 正确读中文 + # ⚠️ 幂等:源文件已带 BOM 就不要再加,加两次 PowerShell 开头会多出乱码字符 + open(os.path.join(STAGE, f), "wb").write(data) + token = open("/worker_token", encoding="utf-8").read().strip() + # 开单后台的令牌(金钻电脑上那块面板用)—— 和渲染机 token 是两把,互不通用 + atok = open("/admin_token", encoding="utf-8").read().strip() + with open(os.path.join(STAGE, "config.json"), "w", encoding="utf-8") as f: + json.dump({"server": "http", "token": token, + "admin_token": atok, + # 模板已统一收进「头图\模板\」(2026-09-30) + "tpl_root": r"", + # 在线检查 10 分钟一次(金钻 9-30);领单仍 20 秒,别改大 + "hb_every": 600, + "poll": 20, + "blender": r""}, + f, ensure_ascii=False, indent=1) + mk = "/make_order.py" + open(os.path.join(STAGE, "make_order.py"), "wb").write(open(mk, "rb").read()) + # 质检代码必须是同一份 —— 从网页那边取,绝不手工复制 + open(os.path.join(STAGE, "skincheck.js"), "wb").write( + open("/skincheck.js", "rb").read()) + + sizes = {f: os.path.getsize(os.path.join(STAGE, f)) for f in sorted(os.listdir(STAGE))} + print("待传文件:") + for k, v in sizes.items(): + print(" %-22s %6d 字节" % (k, v)) + + # 2) 本机 → VM + step("本机 → VM", "scp -i %s -P -o StrictHostKeyChecking=accept-new -r %s shopowner@localhos" % (KEY_VM, STAGE)) + + # 3) VM 上跑一段脚本,把文件推到宿主并核对(引号地狱 → 用脚本文件) + vm_sh = r'''#!/bin/sh +set -e +rm -rf && mkdir -p +cp /* / +SSH="ssh -i KEY -o StrictHostKeyChecking=accept-new -o ConnectTimeout=10 user0@" +SCP="scp -i KEY -o StrictHostKeyChecking=accept-new -o ConnectTimeout=10" +$SSH "if not exist mkdir " || true +$SSH "if not exist mkdir " || true +# ⚠️ 以前这里是**写死的文件名清单** —— 结果新加的 pack_archive.* 传不上去, +# 本地打印"待传文件"看着传了,宿主上根本没有(2026-09-30 实踩第 3 次"改 A 忘 B")。 +# 改成自动带上 staging 里除 make_order.py 之外的全部文件。 +WLIST="" +for f in /*; do + case "$f" in */make_order.py) continue;; esac + WLIST="$WLIST $f" +done +$SCP $WLIST "user0@:" +$SCP /make_order.py "user0@:" +echo "--- ---" +$SSH "dir " +echo "--- \\make_order.py ---" +$SSH "dir \\make_order.py" +'''.replace("KEY", KEY_HOST) + open("", "w", newline="\n").write(vm_sh) + step("本机 → VM(推送脚本)", "scp -i %s -P shopowner@localhost:" % KEY_VM) + step("VM → 宿主 推送", "ssh <跳板> 'sh '", 300) + + # 4) 跑安装脚本 + step("宿主上执行安装", + "ssh <跳板> \"ssh -i %s -o StrictHostKeyChecking=accept-new user0@ " + "'powershell -ExecutionPolicy Bypass -File '\"" % KEY_HOST, 300) + + # 5) 服务器侧复核心跳 + time.sleep(20) + step("核对渲染机进程是不是新的", + "ssh <跳板> \"ssh -i %s -o StrictHostKeyChecking=accept-new user0@ " + "'powershell -NoProfile -ExecutionPolicy Bypass -File \\chk_worker.ps1'\"" % KEY_HOST, 120) + + rc, out = sh("curl -s http", 30) + print("\n=== 服务器看到的渲染机状态 ===") + print(out) + if '"online":true' in out.replace(" ", ""): # 先去空格再比;之前比的是带空格的串,永远为假 + print("✅ 渲染机已上线") + else: + print("⚠️ 还没看到心跳,看宿主 \\worker.log") + + +if __name__ == "__main__": + main() diff --git a/backend/backend-tools/install_worker.ps1 b/backend/backend-tools/install_worker.ps1 new file mode 100644 index 0000000..51c0d78 --- /dev/null +++ b/backend/backend-tools/install_worker.ps1 @@ -0,0 +1,170 @@ +# YS render worker installer —— 在 Windows 宿主机上跑(金钻工坊·渲染下单) +# 做四件事:找 pythonw → 修好 run_worker.bat → 注册开机自启 → 桌面放开关 → 立刻启动 +$ErrorActionPreference = 'Continue' +$DIR = '' +Write-Host "=== YS 渲染机 安装 ===" + +# 1) 找 pythonw.exe +$pw = (Get-Command pythonw.exe -ErrorAction SilentlyContinue).Source +if (-not $pw) { + $c = Get-ChildItem -Path "$env:LOCALAPPDATA\Programs\Python", "*", "" ` + -Filter pythonw.exe -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1 + if ($c) { $pw = $c.FullName } +} +if (-not $pw) { Write-Host "ERROR: 找不到 pythonw.exe,先把 Python 装上"; exit 1 } +Write-Host "pythonw = $pw" + +# 2) 把两个 .bat 里的占位符换成真实路径 +$bat = Join-Path $DIR 'run_worker.bat' +if (Test-Path $bat) { + $t = Get-Content $bat -Raw + $t = $t -replace '__PYTHONW__', $pw + [IO.File]::WriteAllText($bat, $t, [Text.Encoding]::ASCII) + Write-Host "run_worker.bat 已修好" +} else { Write-Host "ERROR: 缺 run_worker.bat"; exit 1 } + +# 本机开单工具用 python.exe(要留个黑框,崩了能看见) +$py = (Get-Command python.exe -ErrorAction SilentlyContinue).Source +if (-not $py) { $py = $pw -replace 'pythonw\.exe$', 'python.exe' } +$bat2 = Join-Path $DIR 'open_local.bat' +if (Test-Path $bat2) { + $t2 = Get-Content $bat2 -Raw + $t2 = $t2 -replace '__PYTHON__', $py + [IO.File]::WriteAllText($bat2, $t2, [Text.Encoding]::ASCII) + Write-Host "open_local.bat 已修好 (python=$py)" +} else { Write-Host "!! 缺 open_local.bat,本机开单工具没法一键启动" } + +# 开单后台(金钻 2026-09-30:家里电脑上点着用的,局域网 8081) +# 用 pythonw(不留黑框);⚠️ 两个占位符都要替,只替一个会留个 __PYTHONW__ 在文件里 +$bat3 = Join-Path $DIR 'run_admin.bat' +if (Test-Path $bat3) { + $t3 = Get-Content $bat3 -Raw + $t3 = $t3 -replace '__PYTHONW__', $pw + $t3 = $t3 -replace '__PYTHON__', $py + [IO.File]::WriteAllText($bat3, $t3, [Text.Encoding]::ASCII) + Write-Host "run_admin.bat 已修好 (pythonw=$pw)" +} else { Write-Host "!! 缺 run_admin.bat,开单后台没法一键启动" } + +# 3) 开机自启(登录时启动,不需要管理员) +schtasks /Delete /TN "YS-Render-Worker" /F 2>$null | Out-Null +schtasks /Create /TN "YS-Render-Worker" /TR "`"$bat`"" /SC ONLOGON /RL LIMITED /F | Out-Null +if ($LASTEXITCODE -eq 0) { Write-Host "已注册开机自启:YS-Render-Worker" } +else { Write-Host "!! 注册开机自启失败(可手动跑 run_worker.bat)" } + +# 开单后台也随登录自启(局域网服务,手机同 WiFi 直接开;不需要就删掉这个计划任务) +if (Test-Path $bat3) { + schtasks /Delete /TN "YS-Admin-Panel" /F 2>$null | Out-Null + # ⚠️ 计划任务**直接调 pythonw 且不带 --open** —— 走 bat 的话会带 --open,开机就弹一个网页出来 + schtasks /Create /TN "YS-Admin-Panel" /TR "`"$pw`" `"$DIR\ys_admin.py`"" /SC ONLOGON /RL LIMITED /F | Out-Null + if ($LASTEXITCODE -eq 0) { Write-Host "已注册开机自启:YS-Admin-Panel(开单后台)" } + else { Write-Host "!! 开单后台自启注册失败(点开始菜单「开单后台」也能起)" } +} + +# 4) 桌面放三个开关 +$desk = [Environment]::GetFolderPath('Desktop') +$sh = New-Object -ComObject WScript.Shell +function MkLink([string]$name, [string]$target, [string]$desc) { + $p = Join-Path $desk $name + $l = $sh.CreateShortcut($p) + $l.TargetPath = $target + $l.WorkingDirectory = $DIR + $l.Description = $desc + $l.Save() + if (Test-Path $p) { Write-Host "桌面快捷方式:$name" } +} +# ⚠️ 金钻 2026-09-30:桌面别撒一地 —— 全部进开始菜单「金钻工坊」,桌面只留一个入口。 +# 以前是往桌面逐个放 5 个快捷方式,桌面就花了。 +$GROUP = '金钻工坊' +$start = Join-Path ([Environment]::GetFolderPath('Programs')) $GROUP +New-Item -ItemType Directory -Force -Path $start | Out-Null +function MkIn([string]$folder, [string]$name, [string]$target, [string]$desc) { + $p = Join-Path $folder $name + $l = $sh.CreateShortcut($p) + $l.TargetPath = $target + $l.WorkingDirectory = $DIR + $l.Description = $desc + $l.Save() + if (Test-Path $p) { Write-Host "快捷方式:$folder\$name" } +} +$shortcutItems = @( + @('本机开单', 'open_local.bat', '平台单:本机出图,不联网、不用卡密'), + @('开单后台', 'run_admin.bat', '生成卡密 / 激活订单(局域网,手机同 WiFi 也能开)'), + @('开单后台-停止', 'stop_admin.bat', '关掉开单后台'), + @('打包留档', 'pack_archive.bat', '把在线订单压成一个 zip,方便整个拖网盘'), + @('渲染机-启动', 'run_worker.bat', '启动影塑渲染机'), + @('渲染机-停止', 'stop_worker.bat', '停止影塑渲染机'), + @('渲染机-看日志', 'show_log.bat', '查看渲染机日志与服务器队列') +) +foreach ($it in $shortcutItems) { + MkIn $start ($it[0] + '.lnk') (Join-Path $DIR $it[1]) $it[2] + # 顺手把以前撒在桌面上的清掉(只删苏达建的这几个名字) + $dp = Join-Path $desk ($it[0] + '.lnk') + if (Test-Path $dp) { Remove-Item $dp -Force } +} +$dg = Join-Path $desk "$GROUP.lnk" +if (Test-Path $dg) { Remove-Item $dg -Force } +MkIn $desk "$GROUP.lnk" $start "金钻工坊:本机开单 / 渲染机开关 / 打包留档" + +# 5) 立刻启动 +# ⚠️ 不能用 Start-Process —— 通过 SSH 起的进程会随会话结束被带走(2026-09-30 实踩: +# 安装时显示"已运行",session 一断 worker 就没了,订单干等在队列里没人领)。 +# 走计划任务启动,由 Task Scheduler 持有,跟 SSH 会话无关。 +# ⚠️⚠️ 必须先停掉正在跑的旧进程再起新的! +# 2026-09-30 实踩:部署脚本从头到尾都"成功",但渲染机进程是早上 09:19 起的, +# 跑了一整天旧代码 —— 序号登记、条款留证、看门狗全都没生效, +# 而且现象极具迷惑性(能出图、不报错,只是新功能静默缺失)。 +# 计划任务 /Run 对已在运行的实例不会替换,所以必须显式杀。 +$old = Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*ys_worker.py*' } +if ($old) { + foreach ($p in $old) { + Write-Host "停掉旧渲染机进程 PID $($p.ProcessId)(启动于 $($p.CreationDate))" + Stop-Process -Id $p.ProcessId -Force -ErrorAction SilentlyContinue + } + Start-Sleep -Seconds 3 +} +schtasks /Run /TN "YS-Render-Worker" 2>$null | Out-Null +if ($LASTEXITCODE -ne 0) { Start-Process -FilePath $bat -WindowStyle Hidden } + +# 开单后台:同一套「先杀旧、再起新」——不然跑着的还是昨天的代码(这个坑在渲染机上踩过) +if (Test-Path $bat3) { + $oldA = Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*ys_admin.py*' } + foreach ($p in $oldA) { + Write-Host "停掉旧开单后台进程 PID $($p.ProcessId)(启动于 $($p.CreationDate))" + Stop-Process -Id $p.ProcessId -Force -ErrorAction SilentlyContinue + } + if ($oldA) { Start-Sleep -Seconds 2 } + schtasks /Run /TN "YS-Admin-Panel" 2>$null | Out-Null + if ($LASTEXITCODE -ne 0) { Start-Process -FilePath $bat3 -WindowStyle Hidden } + # ⚠️ 进程要几秒才出现、接口要十几秒才通 —— 检查**放在这个重试循环里**, + # 放在循环外面会误报「没起来 / 接口不通」(2026-09-30 一晚踩了三次) + $pa = $null + for ($i = 1; $i -le 6; $i++) { + Start-Sleep -Seconds 3 + $pa = Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*ys_admin.py*' } + if ($pa) { + try { + # ⚠️ 2026-10-01 起面板有 PIN 锁:自检只能打免锁的 /api/health(state 会 401 → 自检误报"没起来") + $code = (Invoke-WebRequest -UseBasicParsing 'htt' -TimeoutSec 25).Content + Write-Host "开单后台:已运行 (PID $($pa.ProcessId -join ','))(局域网 htt" + Write-Host "开单后台自检:$($code.Substring(0, [Math]::Min(200, $code.Length)))" + break + } catch { } + } + } + if (-not $pa) { Write-Host "!! 开单后台没起来,看 \admin.log" } +} +Start-Sleep -Seconds 10 + +# 6) 自检:进程 + 服务器心跳 +$proc = Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*ys_worker.py*' } +if ($proc) { Write-Host "进程:已运行 (PID $($proc.ProcessId -join ','))" } +else { Write-Host "!! 进程没起来,去 \worker.log 看原因" } +try { + $s = (Invoke-WebRequest -UseBasicParsing 'http' -TimeoutSec 20).Content + Write-Host "服务器状态:$s" +} catch { Write-Host "!! 连不上服务器:$_" } +if (Test-Path (Join-Path $DIR 'worker.log')) { + Write-Host "--- worker.log 末尾 ---" + Get-Content (Join-Path $DIR 'worker.log') -Tail 15 +} +Write-Host "=== 安装完成 ===" diff --git a/backend/backend-tools/local.html b/backend/backend-tools/local.html new file mode 100644 index 0000000..16233fe --- /dev/null +++ b/backend/backend-tools/local.html @@ -0,0 +1,409 @@ + + + + + +本机开单 · 金钻工坊(平台单) + + + +
+

本机开单

+ 平台单 · 只在这台电脑上能打开 + 体检中… +
+ +
+
+ +
+

1 · 皮肤

+

把买家发的皮肤图拖进来,或点一下选。质检规则和网页版是同一份代码。

+
+ 发给买家的说明(可直接复制) +
只提供渲染服务,不对皮肤内容与渲染结果作合规担保。
+皮肤由买家自行提供,其内容合法性由提供者负责;
+因皮肤内容(含夹带数据、隐藏信息、违规图案)产生的任何后果,由提供者承担。
+模板质量问题由金钻负责维护修复,非质量问题不予重做。
+一经发现违法内容,将立即停止服务、删除相关文件、拒绝后续接单。
+
+
+ + +
点击选择皮肤文件
+
或把 .png 拖到这里 / 直接粘贴图片
+
+ + +
+ +
+

2 · 模板

+

勾几个就出几张。一次渲一张,不会把机器顶满。

+
+
+
出图分辨率 —— 越高越慢。 + 默认 1000 是网易我的世界头图的标准分辨率,文件名不带数字; + 换别的分辨率才写进文件名(如 飞跃樱花林2048.png)
+
+
+
+ +
+
+ + +
+ +
+ + + +
+ 本工具只监听 localhost · 不联网 · 不上传 · 不需要兑换码
+ 所有文件都留在你自己电脑上 · 退出工具 +
+
+
+ + + + + diff --git a/backend/backend-tools/make_order.py b/backend/backend-tools/make_order.py new file mode 100644 index 0000000..e233549 --- /dev/null +++ b/backend/backend-tools/make_order.py @@ -0,0 +1,651 @@ +# -*- coding: utf-8 -*- +""" +商单渲染流程自动化(宿主 Windows 用)—— 跑起来 0 token + +金钻 2026-09-19 原话: + 「如果方便的话可以直接写个脚本,到时候如果不需要修改的话,直接按流程, + 复制所需工程到商单文件夹往后补一个新的编号。皮肤也放进去。 + 然后根据皮肤粗细臂去选择对应集合,渲染出图」 + +一条命令完成: + 1. 成品文件夹用成品名(`飞跃樱花林` / `飞跃樱花林1080`),重名自动加 -2 + 2. 新建成品文件夹;工程复制到**临时目录**(原文件不动,渲完就删) + 3. 皮肤先放进成品文件夹 + 4. 自动判定皮肤是【粗臂 classic 4px】还是【细臂 slim 3px】 + 5. 按判定切换场景里的 粗臂 / 细臂 集合(view layer exclude) + 6. 换皮肤贴图(pack 打包) + 7. 渲染出图 → 017\\飞跃樱花林.png + 017\\飞跃樱花林无压缩版.png + (默认 1000 不带数字;换分辨率才带,如 飞跃樱花林1080.png。越高越慢) + 8. 写 _CHANGES.md 与 _make_order.log + +用法: + blender.exe -b --factory-startup --python make_order.py -- ^ + --template "" ^ + --skin "" ^ + --orders-dir "" ^ + [--block-texture ""] [--num 017] [--out-name 麦田萤火] ^ + [--res 2048] [--out-dir "...\\商单\\麦田萤火"] [--keep-blend] ^ + [--no-uncompressed] [--no-render] [--dry-run] + +要点(踩过的坑,别改回去): + * 必须 `-b --factory-startup` —— 宿主 Blender 装了 MMD 系 addon,不 factory-startup + 时会重复注册崩(ValueError: register_class(...): already registered)。 + * 但 factory-startup 会丢掉用户的 Cycles GPU 偏好 → 掉回 CPU,**慢 10 倍** + (实测 1000×1000 / 180 samples:GPU 37.4s vs CPU 378.9s)。 + 所以脚本里 setup_render_device() 显式切 GPU,别删。 + * 判臂型用 bpy.data.images 读 alpha,不依赖 PIL;注意 img.pixels 是 **bottom-up**, + 取像素必须翻转 y。 + * 渲染耗时长(CPU 下 6 分钟+),从我这边跑要走后台 + 轮询日志,别用前台 timeout。 + * **工程文件不保留**(2026-09-30 金钻):一份 .blend 二十多兆,攒起来受不住。 + 工程复制到 tempfile.mkdtemp() 的临时目录,渲完立刻删;`--keep-blend` 只在调试时用。 + 成品文件夹里只有:皮肤 + 成图 + 订单信息.json。 + * **臂集合名/层级各模板都不一样**(实测三种):1~4 顶层 `粗臂`/`细臂`; + 5~6 嵌在 `Collection` 里叫 `Player Wide Rig`/`Player Slim Rig`; + 7 顶层 `01_角色_粗臂`/`02_角色_细臂`。 + → find_layer() 递归整棵树 + 中英双认(WIDE_KEYS/SLIM_KEYS)。 + 写死任一种都会让模板 exit 5 渲不出来(5/6/7 全中过)。 + * 皮肤 `img.pack()` 必须在改 filepath **之前** —— 工程现在在临时目录, + 先改路径的话 pack 会拿相对路径去 找源文件,报 not found。 +""" + +import argparse +import atexit +import os +import re +import shutil +import sys +import tempfile +import time +import traceback + +import bpy + +LOGLINES = [] + +# ---- 成品命名(金钻 2026-09-30 定稿)---- +# 默认分辨率 1000 → <模板名>.png + <模板名>无压缩版.png +# 其它分辨率 N → <模板名>N.png + <模板名>N无压缩版.png +# 例:飞跃樱花林 在 1000 → 飞跃樱花林.png / 飞跃樱花林无压缩版.png +# 飞跃樱花林 在 1080 → 飞跃樱花林1080.png / 飞跃樱花林1080无压缩版.png +DEFAULT_RES = 1000 +UNC_SUFFIX = "无压缩" + + +def out_base(out_name, res): + """模板名 + (非默认分辨率才带数字)""" + res = int(res) + return out_name if res == DEFAULT_RES else "%s%d" % (out_name, res) + + +def make_out_dir(root, base): + """成品文件夹用成品名(金钻 2026-09-30):`飞跃樱花林` / `飞跃樱花林1080`。 + 同名已存在就往后加 -2 / -3 —— 同一个模板被买两次不能互相覆盖。 + 序号仍然记在文件夹里的 订单信息.json(好查账)。""" + d = os.path.join(root, base) + n = 2 + while os.path.exists(d): + d = os.path.join(root, "%s-%d" % (base, n)) + n += 1 + os.makedirs(d, exist_ok=True) + return d + + +def std_name(out_name, res): + return out_base(out_name, res) + ".png" + + +def unc_name(out_name, res): + return out_base(out_name, res) + UNC_SUFFIX + ".png" + + +def log(*a): + s = " ".join(str(x) for x in a) + LOGLINES.append(s) + print("[MAKE-ORDER] " + s, flush=True) + + +def parse_args(): + argv = sys.argv + if "--" in argv: + argv = argv[argv.index("--") + 1:] + else: + argv = [] + ap = argparse.ArgumentParser() + ap.add_argument("--template", required=True, help="干净模板 .blend 绝对路径") + ap.add_argument("--skin", required=True, help="皮肤 png 绝对路径") + ap.add_argument("--orders-dir", required=True, help="商单根目录绝对路径") + ap.add_argument("--out-dir", default=None, + help="直接指定成品文件夹(调用方用来做重名处理;给了就不再用 --num)") + ap.add_argument("--keep-blend", action="store_true", + help="调试用:保留临时工程文件(默认渲完就删)") + ap.add_argument("--block-texture", default=None, help="可选:方块贴图 png") + ap.add_argument("--num", default=None, help="手动指定商单编号(3 位)") + ap.add_argument("--out-name", default=None, help="出图名,默认取模板名去编号前缀") + ap.add_argument("--res", type=int, default=DEFAULT_RES, + help="渲染分辨率。默认 1000(文件名不带数字);换别的值会写进文件名。" + "越高越慢:1000≈40s、2048≈2.5min、4096≈10min") + ap.add_argument("--skin-material", default=None, help="皮肤材质名(默认自动找)") + # 金钻 2026-10-01:页面让买家手动改粗/细臂,但以前**根本没传进来** —— 永远按自动判定走, + # 买家改了也白改。现在由渲染机按「这张皮肤」的臂型传进来(多皮肤单每张各自一个臂型)。 + ap.add_argument("--arm", default="auto", choices=["auto", "classic", "slim"], + help="粗臂(classic)/细臂(slim);auto=按皮肤自动判定(默认)") + ap.add_argument("--uncompressed", action=argparse.BooleanOptionalAction, default=True, + help="输出 16bit 无压缩版(默认开;要关就 --no-uncompressed)") + ap.add_argument("--no-render", action="store_true") + ap.add_argument("--dry-run", action="store_true") + return ap.parse_args(argv) + + +# ---------------------------------------------------------------- 编号 / 目录 + +def next_order_number(orders_dir, forced=None): + if forced: + return forced + n = 0 + for name in os.listdir(orders_dir): + m = re.fullmatch(r"(\d{3})", name) + if m and os.path.isdir(os.path.join(orders_dir, name)): + n = max(n, int(m.group(1))) + return "%03d" % (n + 1) + + +# ------------------------------------------------------- 皮肤臂型判定(核心) + +def _px(img, x, y, w, h): + """取 (x,y) alpha,y 从左上往下数;bpy pixels 是左下起 → 翻转 y。""" + yy = h - 1 - y + return img.pixels[(yy * w + x) * 4 + 3] + + +def detect_arm_model(skin_abs): + """读皮肤 alpha 判粗臂/细臂。返回 (model, score, notes) + model: 'classic'(粗臂 4px) / 'slim'(细臂 3px) / 'unknown' + 依据:64x64 标准布局,右臂区 (40,16)-(55,31)。 + 粗臂:每个 4x4 面填满 → 侧面行 y=25 在 x40..55 无透明列;top/bottom 面各占 4px + 细臂:每个 4x4 面只用 3x3 → 每 4px 段第 4 列透明 + """ + notes = [] + img = bpy.data.images.load(skin_abs, check_existing=False) + try: + ow, oh = img.size + # 皮肤分辨率不固定:64 是基准,128/256/512/1024…都是同一套 64 网格的整倍数放大, + # 一律缩到 64×64 再判臂型(和下单页的判定保持完全一致)。 + if ow != oh: + return "unknown", 0, "非正方形 %dx%d(旧版 2:1,无独立左右臂/腿)" % (ow, oh) + if ow < 64: + return "unknown", 0, "尺寸过小 %dx%d" % (ow, oh) + if ow != 64: + img.scale(64, 64) + w, h = img.size + classic = 0 + slim = 0 + + # 判据1:侧面行 y=25,x=40..55 的透明列数 + nt = sum(1 for x in range(40, 56) if _px(img, x, 25, w, h) == 0.0) + if nt >= 2: + slim += 1 + else: + classic += 1 + notes.append("side-row(y25) transparent cols=%d" % nt) + + # 判据2/3:top/bottom 面第 4 列是否存在(细臂该列为空) + for (x, lab) in ((47, "top-face-4th"), (51, "bottom-face-4th")): + if _px(img, x, 17, w, h) == 0.0: + slim += 1 + notes.append("%s alpha=0" % lab) + else: + classic += 1 + notes.append("%s opaque" % lab) + + # 判据4:y16..19 里 x44..51 的有效列数(粗臂 8,细臂 6) + cols = sum(1 for x in range(44, 52) + if any(_px(img, x, y, w, h) > 0 for y in range(16, 20))) + if cols <= 6: + slim += 1 + else: + classic += 1 + notes.append("face-active cols=%d/8" % cols) + + model = "slim" if slim > classic else "classic" + return model, max(slim, classic), "; ".join(notes) + finally: + try: + bpy.data.images.remove(img) + except Exception: + pass + + +# ------------------------------------------------------------- 场景操作 + +def find_skin_node(mat_name=None, skin_abs=None): + """找皮肤图像纹理节点。返回 (material, node) 或 (None, None) + + ⚠️ 2026-10-01 踩坑(金钻报:「空艇那张皮肤还是默认皮肤材质」): + 老逻辑是「名字里带 skin/皮肤 就选,否则**拿第一个贴图节点**」。 + 空艇模板里第一个贴图节点不是角色皮肤(大概是环境/天空),于是换了个寂寞 —— + 角色身上还是模板自带的默认皮肤,而"站立正反"因为节点名带 skin 所以正常。 + 新逻辑:**给每个候选节点打分挑最高的**,并把候选全打日志(下次出问题一眼看得出)。 + 分:材质/图片名带 skin|皮肤 +3;图片尺寸 == 上传皮肤的尺寸 +2;≤128 的小图 +1 + 都不沾(全是大背景图)→ 才退回第一个,并明确警告。 + """ + pairs = [] + for m in bpy.data.materials: + if not m.use_nodes or not m.node_tree: + continue + for n in m.node_tree.nodes: + if n.type == "TEX_IMAGE" and n.image is not None: + pairs.append((m, n)) + if not pairs: + return None, None + if mat_name: + for m, n in pairs: + if m.name == mat_name: + log("皮肤节点 → 按参数指定材质 %s" % m.name) + return m, n + log("⚠️ 指定材质 %r 没找到,改走自动打分" % mat_name) + + def size_of(img): + try: + return (int(img.size[0]), int(img.size[1])) + except Exception: + return (0, 0) + + want = (0, 0) + if skin_abs: + try: + tmp = bpy.data.images.load(skin_abs, check_existing=False) + want = size_of(tmp) + except Exception: + want = (0, 0) + + board = [] + for m, n in pairs: + nm = (m.name or "") + " " + (n.image.name or "") + " " + (n.image.filepath or "") + low = nm.lower() + s = 0 + if "skin" in low or "皮肤" in nm: + s += 3 + w, h = size_of(n.image) + if want != (0, 0) and (w, h) == want: + s += 2 + if 0 < w <= 128 and 0 < h <= 128: + s += 1 + board.append((s, m, n, (w, h))) + board.sort(key=lambda x: -x[0]) + log("贴图节点候选:%s" % ";".join( + "%s/%s %sx%s 分=%d" % (mm.name, (nn.image.name or "?"), wh[0], wh[1], sc) + for sc, mm, nn, wh in board)) + best = board[0] + if best[0] == 0: + log("⚠️ 没有节点沾『皮肤』特征(全是大图?) → 按第一个来,可能渲出默认皮肤") + # ⭐ 2026-10-01:**同分的全都要换**。空艇模板里有「角色皮肤_粗臂 / 角色皮肤_细臂」 + # 两个皮肤材质(模板作者自己那套工作皮肤),只换排第一的那个 → 用细臂集合渲染时 + # 角色身上还是模板自带的深褐色皮肤(金钻报的"还是默认皮肤"就是这原因)。 + # 只认"最高分"这一档,是为了不误伤 64x64 的杂图(那张模板里还有床 blue/purple, + # 同尺寸但名字不含 skin,分更低 → 不会被换)。 + picked = [x for x in board if x[0] == best[0]] + log("皮肤节点 → 选中 %d 个(分=%d):%s" + % (len(picked), best[0], "、".join(x[1].name + "/" + x[2].name for x in picked))) + return picked + + +def swap_image(node, new_abs, rel_to_blend): + """给图像纹理节点换图并打包。 + + ⚠️ 顺序不能反:**必须先 pack() 再改 filepath**。 + 先改 filepath 的话,Blender 会拿那个相对路径去找源文件;工程一旦不在 + 皮肤旁边(现在工程走临时目录),就会报 + RuntimeError: Unable to pack file, source path '' not found + (2026-09-30 实踩:`//_assets/` 是相对 .blend 所在目录解析的, + .blend 搬去 temp 后就不指向皮肤了。) + """ + old = node.image + img = bpy.data.images.load(new_abs, check_existing=False) + try: + img.pack() # 此刻 filepath 还是绝对路径,找得到源文件 + except Exception as e: + log("⚠️ pack 失败(皮肤仍能用于本次渲染,只是工程不自包含): %r" % e) + img.filepath = rel_to_blend # 已打包,路径只剩记录意义 + node.image = img + node.interpolation = "Closest" + try: + node.image.colorspace_settings.name = "sRGB" + except Exception: + pass + if old is not None and old.users == 0: + try: + bpy.data.images.remove(old) + except Exception: + pass + return img + + +# 粗臂/细臂集合在各模板里叫什么,都不一定 —— 2026-09-30 实测三种: +# 1~4 :顶层 `粗臂` / `细臂` +# 5~6 :**嵌在 `Collection` 里**,叫 `Player Wide Rig` / `Player Slim Rig`(英文) +# 7 :顶层 `01_角色_粗臂` / `02_角色_细臂` +# 所以判定必须 ① 递归整棵树 ② 中英双认。写死任何一种都会漏。 +WIDE_KEYS = ("粗臂", "wide rig", "wide_rig", "wide-rig") +SLIM_KEYS = ("细臂", "slim rig", "slim_rig", "slim-rig") + + +def find_layer(root, keys): + """在**整棵**集合树里找名字命中 keys 的层(广度优先,先浅后深)。 + + 广度优先很重要:1~4 的顶层 `粗臂` 里还嵌着一个 `Player Wide Rig`, + 先命中外层才是对的(切外层等于整体切换)。 + """ + queue = [root] + while queue: + cur = queue.pop(0) + for ch in cur.children: + low = ch.name.lower() + if any(k.lower() in low for k in keys): + return ch + queue.append(ch) + return None + + +def set_arm_rig(model): + """按臂型切换粗臂/细臂。返回 (ok, msg)。 + + ⚠️ **找不到不是错误**:真遇到既没中文也没英文臂集合的模板, + 说明那套模板本来就只有一套角色、不需要切 —— 这种情况要放行继续渲染。 + (早先版本直接 return False,导致 5/6/7 三个模板全部 exit 5 渲不出来。) + """ + lc = bpy.context.view_layer.layer_collection + wide = find_layer(lc, WIDE_KEYS) + slim = find_layer(lc, SLIM_KEYS) + if wide is None and slim is None: + return True, "此模板没有粗臂/细臂集合,跳过切臂型(按单角色渲)" + if wide is not None: + wide.exclude = (model != "classic") + if slim is not None: + slim.exclude = (model != "slim") + return True, "粗臂[%s].exclude=%s / 细臂[%s].exclude=%s" % ( + wide.name if wide else "缺", wide.exclude if wide else "-", + slim.name if slim else "缺", slim.exclude if slim else "-") + + +def visible_armatures(): + out = [] + for o in bpy.data.objects: + if o.type == "ARMATURE": + try: + if o.visible_get(): + out.append(o.name) + except Exception: + pass + return out + + +def setup_render_device(): + """--factory-startup 不加载用户偏好 → Cycles 会掉回 CPU(慢 10 倍)。 + 这里显式把渲染设备切到 GPU。返回描述串。""" + sc = bpy.context.scene + info = [] + try: + if not hasattr(sc, "cycles"): + return "no-cycles" + sc.cycles.device = "GPU" + addon = bpy.context.preferences.addons.get("cycles") + if addon is None: + return "GPU 已设但找不到 cycles 偏好面板(可能仍走 CPU)" + cp = addon.preferences + for dt in ("OPTIX", "CUDA", "HIP", "ONEAPI"): + try: + cp.compute_device_type = dt + info.append("type=%s" % dt) + break + except Exception: + continue + cp.get_devices() + used = [] + for d in cp.devices: + if d.type != "CPU": + d.use = True + used.append(d.name) + if not used: + for d in cp.devices: + d.use = True + info.append("devices=%s" % (", ".join(used) if used else "CPU-only")) + except Exception as e: + info.append("设置失败:%r" % e) + return "; ".join(info) + + +def render_to(out_dir, out_name, res, do_render=True, uncompressed=False): + sc = bpy.context.scene + sc.render.resolution_x = res + sc.render.resolution_y = res + sc.render.resolution_percentage = 100 + sc.render.image_settings.file_format = "PNG" + dev = setup_render_device() + log("渲染设备 %s" % dev) + target = os.path.join(out_dir, out_name + ".png") + sc.render.filepath = target + if not do_render: + return target, False + t0 = time.time() + bpy.ops.render.render(write_still=True) + dt = time.time() - t0 + # compositor 若带 File Output,可能写到别处;兜底找最新 png + if not os.path.exists(target): + cands = [f for f in os.listdir(out_dir) if f.lower().endswith(".png")] + if cands: + newest = max(cands, key=lambda f: os.path.getmtime(os.path.join(out_dir, f))) + target = os.path.join(out_dir, newest) + unc = None + if uncompressed: + unc = os.path.join(out_dir, out_name + UNC_SUFFIX + ".png") + ok = False + # 先试「从已渲好的 Render Result 直接另存」—— 省掉一次完整渲染(一张约 37s) + try: + sc.render.image_settings.file_format = "PNG" + sc.render.image_settings.color_depth = "16" + sc.render.image_settings.compression = 0 + rr = bpy.data.images.get("Render Result") + if rr is not None: + rr.save_render(filepath=unc, scene=sc) + ok = os.path.exists(unc) and os.path.getsize(unc) > 1024 + except Exception as e: + log("无压缩版直接另存失败,回退到重渲: %r" % e) + if not ok: + # 兜底:老老实实再渲一遍(慢一倍,但保证有图) + try: + sc.render.filepath = unc + bpy.ops.render.render(write_still=True) + ok = os.path.exists(unc) and os.path.getsize(unc) > 1024 + except Exception as e: + log("无压缩版重渲也失败: %r" % e) + log("无压缩版 %s %s" % ("OK" if ok else "FAIL", unc)) + if not ok: + unc = None + return target, dt, unc + + +# ------------------------------------------------------------------- main + +def main(): + a = parse_args() + t_start = time.time() + + for p, lab in ((a.template, "template"), (a.skin, "skin"), (a.orders_dir, "orders-dir")): + if not os.path.exists(p): + log("FATAL %s 不存在: %s" % (lab, p)) + return 2 + + tpl_name = os.path.basename(a.template) + blend_name = re.sub(r"^\d+", "", os.path.splitext(tpl_name)[0]) or os.path.splitext(tpl_name)[0] + out_name = a.out_name or blend_name + base = out_base(out_name, a.res) + + # 成品文件夹用成品名(模板名[+分辨率]);重名加 -2。 + # 工程文件不放这里 —— 走临时目录,渲完就删(金钻:不保留工程文件,避免累计拖慢)。 + if a.out_dir: + order_dir = a.out_dir + os.makedirs(order_dir, exist_ok=True) + num = os.path.basename(order_dir) + elif a.num: + num = a.num + order_dir = os.path.join(a.orders_dir, num) + os.makedirs(order_dir, exist_ok=True) + else: + order_dir = make_out_dir(a.orders_dir, base) + num = os.path.basename(order_dir) + log("编号 %s" % num) + log("成品目录 %s" % order_dir) + log("模板 %s" % tpl_name) + log("出图名 %s" % base) + + if a.dry_run: + log("DRY-RUN 只做目录/复制/判定,不改场景不渲染") + + # --- 1) 临时工程目录(每次一份全新副本;渲完删掉)--- + work = tempfile.mkdtemp(prefix="ys_order_%s_" % re.sub(r"\W+", "_", base)) + if not a.keep_blend: + # ⚠️ 工程文件不保留(金钻:一份 .blend 二十多兆,攒起来受不住)。 + # 任何返回路径都要清掉 —— atexit 兜底,正常结束前再显式删一次。 + atexit.register(shutil.rmtree, work, True) + dst_blend = os.path.join(work, tpl_name) + shutil.copy2(a.template, dst_blend) + log("临时工程 %s(渲完删除)" % dst_blend) + + # --- 2) 素材 --- + # ⚠️ 皮肤**先放进成品文件夹**(金钻 2026-09-30):渲染失败也留得下素材 + skin_abs = os.path.join(order_dir, os.path.basename(a.skin)) + if not os.path.exists(skin_abs) or os.path.abspath(skin_abs) != os.path.abspath(a.skin): + shutil.copy2(a.skin, skin_abs) + log("皮肤 → %s" % skin_abs) + block_abs = None + if a.block_texture and os.path.exists(a.block_texture): + block_abs = os.path.join(order_dir, os.path.basename(a.block_texture)) + if not os.path.exists(block_abs): + shutil.copy2(a.block_texture, block_abs) + log("方块贴图 → %s" % block_abs) + + # --- 3) 臂型判定 --- + model, score, notes = detect_arm_model(skin_abs) + log("臂型判定 %s (票数 %d) | %s" % (model.upper(), score, notes)) + if a.arm != "auto" and a.arm != model: + # 指定优先:买家/金钻在页面上手动改过就听他的(自动判定只写进日志备查) + log("臂型指定 %s(自动判定是 %s)→ 按指定的走" % (a.arm.upper(), model.upper())) + model = a.arm + if model == "unknown": + log("FATAL 皮肤尺寸不支持,无法判定臂型") + return 3 + + if a.dry_run: + log("DRY-RUN 结束,未开 Blender 场景。耗时 %.1fs" % (time.time() - t_start)) + _write_log(order_dir, num, model, notes, a, out_name, None) + return 0 + + # --- 4) 打开副本,改场景 --- + bpy.ops.wm.open_mainfile(filepath=dst_blend) + log("已打开 %s" % dst_blend) + + picked = find_skin_node(a.skin_material, skin_abs) + if not picked: + log("FATAL 场景里找不到可用的图像纹理节点") + return 4 + rel = "//" + os.path.basename(skin_abs) # 图片已 pack,路径仅作记录 + # ⚠️ 2026-10-01 实踩:一开始写成"每个节点各 load+pack 一次",空艇这种双皮肤材质模板 + # 直接让 Blender 崩掉(退出码 9)。正确做法是**只加载打包一次**,多个节点共用同一张图。 + try: + img = bpy.data.images.load(skin_abs, check_existing=False) + try: + img.pack() # 此刻 filepath 还是绝对路径,找得到源文件 + except Exception as e: + log("⚠️ pack 失败(皮肤仍能用于本次渲染,只是工程不自包含): %r" % e) + img.filepath = rel # 已打包,路径只剩记录意义 + # ⚠️ board 里每项是**四元组** (分数, 材质, 节点, 尺寸) —— + # 写成 `for mat, node in picked` 会 ValueError: too many values to unpack + # (2026-10-01 实踩:空艇+站立两个模板全因此渲染失败,退出码 4) + for _sc, mat, node, _wh in picked: + node.image = img + log("换皮肤 材质=%s 节点=%s → %s(已打包)" % (mat.name, node.name, rel)) + except Exception as e: + log("FATAL 换皮肤失败:%r" % e) + return 4 + + ok, msg = set_arm_rig(model) + log("选集合 %s | %s" % ("OK" if ok else "FAIL", msg)) + if not ok: # 现在只有"真找不到"才会走到这(正常模板不会) + return 5 + log("可见骨架 %s" % ", ".join(visible_armatures())) + + log("工程 不保存(渲完随临时目录一起删)") + + # --- 5) 渲染 --- + # 成品命名见文件顶部 out_base():默认 1000 不带数字,其它分辨率带数字。 + target, dt, unc = render_to(order_dir, base, a.res, + do_render=not a.no_render, + uncompressed=a.uncompressed) + # 渲完立刻删工程:别把 20 多兆的 .blend 留在盘上 + if a.keep_blend: + log("临时工程 保留(--keep-blend):%s" % work) + else: + shutil.rmtree(work, ignore_errors=True) + log("临时工程 已删除(不保留 .blend)") + if a.no_render: + unc = None + log("跳过渲染(--no-render)") + else: + log("渲染完成 %s (%.1fs)" % (target, dt if isinstance(dt, float) else 0)) + log("成品 %s + %s" % (std_name(out_name, a.res), unc_name(out_name, a.res))) + + _write_log(order_dir, num, model, notes, a, out_name, target) + log("全部完成 耗时 %.1fs" % (time.time() - t_start)) + return 0 + + +def _write_log(order_dir, num, model, notes, a, out_name, target): + stamp = time.strftime("%Y-%m-%d %H:%M:%S") + body = [ + "# 商单 %s —— 自动生成(make_order.py)" % num, + "", + "生成时间:%s" % stamp, + "", + "## 输入", + "- 模板:`%s`" % a.template, + "- 皮肤:`%s`" % os.path.basename(a.skin), + "- 方块贴图:%s" % (os.path.basename(a.block_texture) if a.block_texture else "(无)"), + "", + "## 自动判定", + "- **皮肤臂型:%s**(%s)" % (model.upper(), notes), + "- 集合切换:%s" % ("粗臂" if model == "classic" else "细臂"), + "", + "## 输出", + "- 工程:`%s`" % os.path.basename(a.template), + "- 出图:`%s`%s" % (std_name(out_name, a.res), + ("、`%s`" % unc_name(out_name, a.res)) if target else ""), + "", + "## 说明", + "皮肤臂型判定依据(64x64 标准布局,右臂区 40..55 / 16..31):", + "- 侧面行 y=25 在 x40..55 的透明列数:细臂每 4px 段留 1 列空 → ≥2 列透明", + "- top/bottom 面第 4 列(x=47 / x=51):细臂该列为空", + "- y16..19 中 x44..51 的有效列数:粗臂 8 列,细臂 6 列", + "四项投票多数决;票数接近时请人工复核。", + "", + "---", + "", + "### 运行日志", + "", + "```", + ] + LOGLINES + ["```", ""] + try: + with open(os.path.join(order_dir, "_CHANGES.md"), "w", encoding="utf-8") as f: + f.write("\n".join(body)) + with open(os.path.join(order_dir, "_make_order.log"), "w", encoding="utf-8") as f: + f.write("\n".join(LOGLINES) + "\n") + except Exception as e: + print("write log failed: %r" % e) + + +if __name__ == "__main__": + try: + sys.exit(main()) + except Exception: + traceback.print_exc() + log("FATAL 未捕获异常") + sys.exit(9) diff --git a/backend/backend-tools/open_local.bat b/backend/backend-tools/open_local.bat new file mode 100644 index 0000000..83b1a89 --- /dev/null +++ b/backend/backend-tools/open_local.bat @@ -0,0 +1,4 @@ +@echo off +cd /d %~dp0 +start "ys_local" /min "__PYTHON__" "%~dp0ys_local.py" +exit diff --git a/backend/backend-tools/pack_archive.bat b/backend/backend-tools/pack_archive.bat new file mode 100644 index 0000000..4232153 --- /dev/null +++ b/backend/backend-tools/pack_archive.bat @@ -0,0 +1,2 @@ +@echo off +powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0pack_archive.ps1" diff --git a/backend/backend-tools/pack_archive.ps1 b/backend/backend-tools/pack_archive.ps1 new file mode 100644 index 0000000..e305bd3 --- /dev/null +++ b/backend/backend-tools/pack_archive.ps1 @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# 打包留档 —— 一键把「在线订单」压成带日期的 zip,方便传网盘 +# ⚠️ 本文件含中文,必须存成 UTF-8 **带 BOM**(PowerShell 5.1 不认无 BOM 的 UTF-8) +param([switch]$NoPause) # -NoPause:非交互场景(远程测试)用 +$ErrorActionPreference = 'Stop' + +$ARCH = '' +$OUT = '' +$KEEP = 3 # 只留最近 3 个包,别把盘撑满 + +if (-not (Test-Path $ARCH)) { Write-Host "找不到留档目录:$ARCH"; exit 1 } +New-Item -ItemType Directory -Force -Path $OUT | Out-Null + +# 先算大小,让金钻心里有数 +$files = @(Get-ChildItem -Path $ARCH -Recurse -File -ErrorAction SilentlyContinue) +if ($files.Count -eq 0) { Write-Host "留档目录还是空的,没有要打包的。"; exit 0 } +$mb = [math]::Round((($files | Measure-Object -Property Length -Sum).Sum)/1MB, 1) + +$stamp = Get-Date -Format 'yyyyMMdd_HHmmss' +$zip = Join-Path $OUT ("在线订单_$stamp.zip") + +Write-Host "准备打包:$($files.Count) 个文件 / $mb MB" +Write-Host "输出:$zip" +Write-Host "" + +# ⚠️ PNG 本身已是压缩数据,再压省不了多少,用 Optimal 纯烧时间(实测 35MB 花了 4 分半)。 +# Fastest 快得多,体积几乎一样 —— 金钻 9-30:「压缩率不高的话就亏」。 +$t0 = Get-Date +Compress-Archive -Path $ARCH -DestinationPath $zip -CompressionLevel Fastest -Force +$sec = [math]::Round(((Get-Date) - $t0).TotalSeconds, 1) + +$zmb = [math]::Round((Get-Item $zip).Length/1MB, 1) +$ratio = if ($mb -gt 0) { [math]::Round(100*$zmb/$mb) } else { 0 } +$saved = if ($mb -gt 0) { [math]::Round(100 - $ratio) } else { 0 } +Write-Host "打包完成:$zmb MB(原 $mb MB,省 $saved%) 用了 $sec 秒" +if ($saved -lt 15) { + Write-Host " ⚠️ 这次省得不多 —— 图本来就是压缩过的。" + Write-Host " 打包主要是为了**把一堆文件变成一个**,方便整个拖网盘。" +} + +# 清老包,只留最近 KEEP 个 +$old = @(Get-ChildItem -Path $OUT -Filter '在线订单_*.zip' | + Sort-Object LastWriteTime -Descending | Select-Object -Skip $KEEP) +foreach ($f in $old) { Write-Host "清掉旧包:$($f.Name)"; Remove-Item $f.FullName -Force } + +Write-Host "" +Write-Host "把这个文件拖进网盘就行 —— 上面那行就是路径:" +Write-Host $zip +Write-Host "" +if (-not $NoPause) { + Write-Host "按任意键关闭…" + $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown') +} diff --git a/backend/backend-tools/run_admin.bat b/backend/backend-tools/run_admin.bat new file mode 100644 index 0000000..05da073 --- /dev/null +++ b/backend/backend-tools/run_admin.bat @@ -0,0 +1,7 @@ +@echo off +cd /d %~dp0 +rem 金钻工坊 · 开单后台(局域网 8081)。用 pythonw 起,不留黑框; +rem --open = 顺便把浏览器打开;要停就点「开单后台-停止」。 +rem ⚠️ 不要在这里加 timeout —— 通过 SSH 跑时 timeout.exe 会因为「输入重定向不支持」报错退出(2026-09-30 实踩)。 +start "ys_admin" /min "__PYTHONW__" "%~dp0ys_admin.py" --open +exit /b 0 diff --git a/backend/backend-tools/run_panel.bat b/backend/backend-tools/run_panel.bat new file mode 100644 index 0000000..694595b --- /dev/null +++ b/backend/backend-tools/run_panel.bat @@ -0,0 +1,16 @@ +@echo off +rem ============================================================ +rem 金钻工坊 · 一键面板 (2026-10-04) +rem 渲染机 worker + 开单工具(8082) + 管理面板(8081) 一次拉起来, +rem 只打开一个页面(8081),开单工具在页面里用标签页切换。 +rem 每个服务都有单实例保护:已经跑着的不会重复启动。 +rem 注意:ys_local 用 python.exe(它要 print 到控制台), +rem worker/admin 用 pythonw.exe(不留黑框)。 +rem ============================================================ +cd /d %~dp0 +set PYEXE=\user0\AppData\Local\Programs\Python\Python312\python.exe +set PYW=\user0\AppData\Local\Programs\Python\Python312\pythonw.exe +start "ys_worker" /min "%PYW%" "%~dp0ys_worker.py" +start "ys_local" /min "%PYEXE%" "%~dp0ys_local.py" +start "ys_admin" /min "%PYW%" "%~dp0ys_admin.py" --open +exit /b 0 diff --git a/backend/backend-tools/run_worker.bat b/backend/backend-tools/run_worker.bat new file mode 100644 index 0000000..db0791f --- /dev/null +++ b/backend/backend-tools/run_worker.bat @@ -0,0 +1,6 @@ +@echo off +cd /d %~dp0 +echo Starting YS render worker (background)... +start "ys_worker" /min "__PYTHONW__" "%~dp0ys_worker.py" +timeout /t 2 >nul +echo Done. Log: %~dp0worker.log diff --git a/backend/backend-tools/show_log.bat b/backend/backend-tools/show_log.bat new file mode 100644 index 0000000..145fc71 --- /dev/null +++ b/backend/backend-tools/show_log.bat @@ -0,0 +1,9 @@ +@echo off +cd /d %~dp0 +echo ===== YS render worker log (last 40 lines) ===== +powershell -NoProfile -Command "if (Test-Path '%~dp0worker.log') { Get-Content '%~dp0worker.log' -Tail 40 } else { 'worker.log not found' }" +echo. +echo ===== Server queue status ===== +powershell -NoProfile -Command "try { (Invoke-WebRequest -UseBasicParsing 'http' -TimeoutSec 15).Content } catch { 'cannot reach server' }" +echo. +pause diff --git a/backend/backend-tools/skincheck.js b/backend/backend-tools/skincheck.js new file mode 100644 index 0000000..5ba2fb5 --- /dev/null +++ b/backend/backend-tools/skincheck.js @@ -0,0 +1,245 @@ +/* ========================================================= + 皮肤质检(共用)—— 网页下单页 和 本机开单工具 共用这一份 + ⚠️ 绝对不要复制成两份:两边判定一旦不一致, + 就会出现「网页说能渲、本地渲不出来」这种最难查的 bug。 + ========================================================= */ +/* ---------------- 标准 64 网格分区(来自 MC 皮肤规范) ---------------- + ⚠️ 手臂区粗臂(4px)/细臂(3px)分区不同,必须按判定结果取用。 + 实测教训:细臂皮肤若用粗臂的 4px 框去统计,会有 2.94% 被当成「主体镂空」 + → 直接被红牌拦下(其实是正常皮肤那一列本来就空着)。 */ +const BASE = { + head:[[8,0,16,8],[16,0,24,8],[0,8,8,16],[8,8,16,16],[16,8,24,16],[24,8,32,16]], + body:[[20,16,28,20],[28,16,36,20],[16,20,20,32],[20,20,28,32],[28,20,32,32],[32,20,40,32]], + legR:[[4,16,8,20],[8,16,12,20],[0,20,4,32],[4,20,8,32],[8,20,12,32],[12,20,16,32]], + legL:[[20,48,24,52],[24,48,28,52],[16,52,20,64],[20,52,24,64],[24,52,28,64],[28,52,32,64]] +}; +const ARM = { + classic:{ + armR:[[44,16,48,20],[48,16,52,20],[40,20,44,32],[44,20,48,32],[48,20,52,32],[52,20,56,32]], + armL:[[36,48,40,52],[40,48,44,52],[32,52,36,64],[36,52,40,64],[40,52,44,64],[44,52,48,64]] + }, + slim:{ + /* 细臂:手臂宽 3px,顶/底面也只用 3 列(第 4 列是空的) + —— 这正是渲染端两条判据(x=47 / x=51 处 y=17 镂空)在测的特征。 + 若这里按 4px 画,皮肤会被自己的质检判成「粗臂」(3粗/1细),自相矛盾。 */ + armR:[[44,16,47,20],[48,16,51,20],[40,20,44,32],[44,20,47,32],[47,20,50,32],[50,20,54,32]], + armL:[[36,48,39,52],[40,48,43,52],[32,52,36,64],[36,52,39,64],[39,52,42,64],[42,52,46,64]] + } +}; +const OVL = { + 头外层:[[32,0,64,16]], 身外层:[[16,32,40,48]], 右臂外层:[[40,32,56,48]], + 左臂外层:[[48,48,64,64]], 右腿外层:[[0,32,16,48]], 左腿外层:[[16,48,32,64]] +}; +const ARM_GROUPS = {右臂:'armR', 左臂:'armL'}; + +/* ---------------- 皮肤分析 ---------------- */ +function analyze(img, origW, origH){ + const c = document.createElement('canvas'); + c.width = 64; c.height = 64; + const g = c.getContext('2d', {willReadFrequently:true}); + g.imageSmoothingEnabled = false; + g.clearRect(0,0,64,64); + g.drawImage(img, 0, 0, 64, 64); + const D = g.getImageData(0,0,64,64).data; + const A = (x,y) => D[((y*64)+x)*4+3]; + + /* --- 1. 尺寸 --- + 皮肤分辨率没有"标准值"这回事:64 是基准,往上 128/192/256/512/1024…都是同一个 + 64 网格的整倍数放大,所以只要【正方形 + 64 的整倍数】就是标准皮肤。 + 另外把 16/32 这类小图和其它正方形尺寸也识别出来(标注非常规、允许人工确认继续)。 + 非正方形 = 旧版 2:1(64×32),没有独立左右臂/腿纹理,模板渲不了。 */ + const sq = (origW === origH); + const mult64 = sq && origW >= 64 && origW % 64 === 0; + const legacy = (origH * 2 === origW) || (!sq && origW > origH); + const tooBig = (origW > 4096 || origH > 4096); + const tooSmall = sq && origW < 16; + + /* --- 2. 臂型(与 make_order.py 同算法:4 票制) --- */ + const arm = (function(){ + let slim=0, classic=0; const v=[]; + let nt=0; for(let x=40;x<56;x++) if(A(x,25)===0) nt++; + const c1 = nt>=2 ? 'slim' : 'classic'; + c1==='slim'?slim++:classic++; + v.push({n:'侧面行 y=25 透明列数', val:nt+' 列', r:c1==='slim'?'细臂':'粗臂'}); + + const pairs=[[47,'顶面第 4 列 x=47'],[51,'底面第 4 列 x=51']]; + for(const [x,lab] of pairs){ + const empty = A(x,17)===0; + empty?slim++:classic++; + v.push({n:lab, val:empty?'镂空':'已涂色', r:empty?'细臂':'粗臂'}); + } + let cols=0; for(let x=44;x<52;x++){ + let has=false; for(let y=16;y<20;y++) if(A(x,y)>0){has=true;break;} + if(has) cols++; + } + const c4 = cols<=6 ? 'slim' : 'classic'; + c4==='slim'?slim++:classic++; + v.push({n:'y16-19 有效列数 x44-51', val:cols+'/8', r:c4==='slim'?'细臂':'粗臂'}); + + const model = slim>classic ? 'slim':'classic'; + const conf = Math.max(slim,classic); + return {model, slim, classic, conf, certain: conf>=3, votes:v}; + })(); + + /* --- 3. 分层像素统计(手臂区按判定出的臂型取框,见上方教训) --- */ + function stat(rects){ + let total=0, clear=0, semi=0; + for(const r of rects){ + for(let y=r[1];y>3<<10)|(D[i+1]>>3<<5)|(D[i+2]>>3)); + if(seen.size>6000) break; + } + + return {sq, mult64, legacy, tooBig, tooSmall, origW, origH, arm, base, ovl, partStat, colors:seen.size}; +} + +/* ---------------- 生成检测报告 ---------------- */ +function buildReport(a){ + const out=[]; let hasBad=false, hasWarn=false; + const push=(lv,tag,t,d)=>{out.push({lv,tag,t,d}); + if(lv==='bad')hasBad=true; if(lv==='warn')hasWarn=true;}; + + /* 尺寸:只要正方形 + 64 的整倍数都算标准;放大倍数直接说出来 */ + const sz = a.origW+'×'+a.origH; + const times = a.mult64 ? (a.origW/64) : 0; + if(a.mult64){ + push('ok','通过','图片规格 '+sz, + times===1 ? '标准皮肤尺寸(64 网格)' + : times+" 倍高清皮肤("+times+"×"+times+" 像素块,会按 64 网格解析,出图精度不受影响)"); + } else if(a.tooBig){ + push('bad','不通过','图片规格 '+sz,'图太大了(上限 4096×4096)。请先缩到 1024 或 512 再传。'); + } else if(a.tooSmall){ + push('bad','不通过','图片规格 '+sz,'图太小了(最小 16×16),装不下一套皮肤的分区。'); + } else if(a.legacy){ + push('bad','不通过','图片规格 '+sz,'这是旧版 2:1 皮肤(没有独立的左臂/左腿纹路),模板无法正确渲染,需要的是正方形皮肤。'); + } else if(a.sq){ + push('warn','注意','图片规格 '+sz, + '能识别,但不是 64 的整倍数(如 64 / 128 / 256 / 512 / 1024),也不是标准皮肤分区比例。' + +'会按 64 网格缩放解析;如果皮肤本身是照标准画的,通常也能出图,但有错位风险 —— 你确认没问题就勾下面的「无视风险」。'); + } else { + push('bad','不通过','图片规格 '+sz,'这不是皮肤比例(应为正方形,或旧版的 2:1)。请确认传的是皮肤图。'); + } + + /* 是否像皮肤 */ + if(a.colors>3000) push('warn','注意','图片来源看着不像皮肤','画面颜色数异常多('+a.colors+'+ 色),像素风皮肤一般不到几百色。确认没有传错图(比如误传照片或渲染成品图)。'); + else push('ok','通过','像素风检查','颜色数 '+a.colors+',符合像素风皮肤特征'); + + /* 主体层镂空 */ + const bp=a.base.clearPct; + const badParts=Object.entries(a.partStat).filter(([,s])=>s.clearPct>1.5).map(([n,s])=>n+'('+s.clearPct.toFixed(1)+'%)'); + if(bp>2){ + push('bad','不通过','主体层有大量镂空','皮肤本体共有 '+bp.toFixed(1)+'% 的像素是全透明的' + +(badParts.length?',集中部位:'+badParts.join('、'):'')+'。渲染出来身体会「漏空」,请先把本体补实再提交。'); + }else if(bp>0.2){ + push('warn','注意','主体层有小面积镂空','本体有 '+bp.toFixed(1)+'% 的像素是透明的' + +(badParts.length?',主要在:'+badParts.join('、'):'')+'。多数情况能正常出图,少数会在成图上看到细小的透光点。'); + }else{ + push('ok','通过','主体层完整','本体没有明显镂空'); + } + + /* 半透明 */ + const semiN = a.base.semi + a.ovl.semi; + if(a.base.semi>30){ + push('warn','注意','存在半透明像素','本体层有 '+a.base.semi+' 个半透明像素(alpha 不是全实心)。渲染边缘可能出现毛边或色差。'); + }else if(semiN>0){ + push('warn','注意','存在少量半透明像素','全图 '+semiN+' 个半透明像素,通常不影响出图,但边缘可能略有杂色。'); + }else{ + push('ok','通过','透明度正常','未发现半透明像素'); + } + + /* 外层 */ + const op=a.ovl.clearPct; + if(a.ovl.total && op>99.5){ + push('ok','通过','外层(第二层)未使用','这套皮肤没有用外套/帽子层,属正常情况'); + }else if(a.ovl.total && op<2){ + push('warn','注意','外层几乎铺满','外层(帽子/外套)几乎每一格都有颜色。如果本意是「只有部分外套」,可能是不小心整层涂满了。'); + }else{ + push('ok','通过','外层覆盖正常','外层(帽子/外套)有内容也有留白,符合常见皮肤画法'); + } + + /* 臂型 */ + if(a.arm.certain){ + push('ok','通过','手臂规格 · '+(a.arm.model==='classic'?'粗臂(Steve 4px)':'细臂(Alex 3px)'), + '判定明确(' + Math.max(a.arm.slim,a.arm.classic) + '/4 项)。渲染时会用' + (a.arm.model==='classic'?'粗臂':'细臂') + '模型。若你觉得不对,可在下面手动改。'); + }else{ + push('warn','注意','手臂规格判定不确定', + '4 项检验只命中 '+Math.max(a.arm.slim,a.arm.classic)+' 项('+(a.arm.classic)+' 粗 / '+(a.arm.slim)+' 细),这类皮肤容易判错。' + +'请自己在下面确认一下手臂是粗的还是细的——判错会导致皮肤整体错位。'); + } + return {items:out, hasBad, hasWarn}; +} + + +/* ---------------- PNG 结构核验(防夹带私货) ---------------- + ⚠️ 这份是 /opt/order-app/pngcheck.py 的**镜像**,两边判定必须一致: + 前端负责「拦」(给人看明白的原因),后端负责「剥」(存下来的是干净字节)。 + 改一边必须同步改另一边 —— 共享用例在 /opt/order-app/tests/png_struct_test.py。 + 拦什么:尾部夹带 / 未知关键块 / APNG / 结构损坏 / 非 PNG + 只警告:tEXt 等元数据块(很多编辑器会加,后端会剥掉,不算错) + u8: Uint8Array(整个文件字节)→ {ok, reason, notes} + ------------------------------------------------------------- */ +function checkPngBytes(u8){ + const notes=[]; + const bad=(why)=>({ok:false, reason:why, notes:notes}); + const SIG=[0x89,0x50,0x4E,0x47,0x0D,0x0A,0x1A,0x0A]; + if(!u8 || u8.length < 33) return bad('不是 PNG 文件'); + for(let i=0;i<8;i++){ if(u8[i]!==SIG[i]) return bad('不是 PNG 文件'); } + + const STRIP=['tEXt','zTXt','iTXt','eXIf','tIME','sPLT','hIST']; + const OK_CRIT=['IHDR','PLTE','IDAT','IEND']; + const OK_ANC=['PLTE','tRNS','gAMA','cHRM','sRGB','iCCP','bKGD','pHYs','sBIT']; + const rd=(o)=>((u8[o]<<24)>>>0)+(u8[o+1]<<16)+(u8[o+2]<<8)+u8[o+3]; + const typ=(o)=>String.fromCharCode(u8[o],u8[o+1],u8[o+2],u8[o+3]); + + let off=8, n=0, seenIhdr=false, seenIdat=false, seenIend=false; + while(off < u8.length){ + if(++n > 4096) return bad('PNG 结构异常(块数量过多)'); + if(off+8 > u8.length) return bad('PNG 文件损坏(块头不完整)'); + const ln=rd(off), t=typ(off+4), end=off+12+ln; + if(end > u8.length) return bad('PNG 文件损坏(块数据不完整)'); + if(t==='IHDR'){ + if(off!==8) return bad('PNG 结构异常(IHDR 不在最前)'); + seenIhdr=true; + }else if(t==='IEND'){ + seenIend=true; + const tail=u8.length-end; + if(tail>0) return bad('图片尾部夹带了 '+tail+' 字节额外数据(正常 PNG 到 IEND 就该结束)'); + break; + }else if(t==='acTL'){ + return bad('这是动画 PNG(APNG),请用普通静态 PNG'); + }else if(t==='IDAT'){ + seenIdat=true; + }else if(OK_ANC.indexOf(t)>=0){ + /* 允许 */ + }else if(STRIP.indexOf(t)>=0){ + notes.push('已剥掉元数据块 '+t); + }else{ + const critical = (u8[off+4] & 0x20) === 0; /* PNG 规范:首字母大写=关键块 */ + if(critical && OK_CRIT.indexOf(t)<0) return bad('图片里有无法识别的内容块 '+t); + notes.push('已剥掉附加块 '+t); + } + off=end; + } + if(!seenIhdr) return bad('PNG 缺少 IHDR(不是完整图片)'); + if(!seenIdat) return bad('PNG 缺少图像数据(IDAT)'); + if(!seenIend) return bad('PNG 没有正常结束(缺 IEND)'); + return {ok:true, reason:'', notes:notes}; +} diff --git a/backend/backend-tools/stop_admin.bat b/backend/backend-tools/stop_admin.bat new file mode 100644 index 0000000..940e109 --- /dev/null +++ b/backend/backend-tools/stop_admin.bat @@ -0,0 +1,5 @@ +@echo off +echo Stopping YS admin panel... +powershell -NoProfile -Command "Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*ys_admin.py*' } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }" +echo Stopped. +timeout /t 3 >nul diff --git a/backend/backend-tools/stop_worker.bat b/backend/backend-tools/stop_worker.bat new file mode 100644 index 0000000..dee9c5e --- /dev/null +++ b/backend/backend-tools/stop_worker.bat @@ -0,0 +1,5 @@ +@echo off +echo Stopping YS render worker... +powershell -NoProfile -Command "Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*ys_worker.py*' } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }" +echo Stopped. (Server side will show the machine as offline.) +timeout /t 3 >nul diff --git a/backend/backend-tools/ys_admin.py b/backend/backend-tools/ys_admin.py new file mode 100644 index 0000000..1337ec5 --- /dev/null +++ b/backend/backend-tools/ys_admin.py @@ -0,0 +1,1122 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""金钻工坊 · 开单后台(家里电脑上跑,局域网可访问,**不上公网**) + +金钻 2026-09-30 要的: + 「帮忙给电脑搞一个后台,局域网可以访问的那种,我后台点击,上传。后台不上公网」 + 「也可以让他们选完后给我卡密,我后台激活或叫你激活。收完款之后。」 + +这块面板只干三件事,都在一个页面里: + ① 生成卡密(选平台 + 模板 → 一键出,秒给,可复制 / 存 CSV 去平台上传) + ② 待激活订单(买家点了「我付好了」的会打星号)→ 一键激活,进队列开渲 + ③ 看一眼状态(渲染机在不在线、队列几单、还有多少可用卡密) + +安全设计(为什么敢把管理接口挂在公网域名上): + * 面板本身只绑局域网 :8081,**没有公网入口** + * 面板调服务器走密钥接口 /order/api/admin/*,两道门: + ① X-Admin-Token(/admin_token,和渲染机 token 分开的两把) + ② 来源 IP 必须是「渲染机心跳认出来的出口 IP」= 金钻家网络的公网出口 + 所以公网别处就算扫到、就算拿到了令牌,也是 403。 + * 密钥不在代码里:从同目录 config.json 的 admin_token 字段读(由服务器上的 + deploy.py 推送,跟 worker token 一个路子) + +⚠️ 单实例:再双击只会再开一次浏览器,不会起第二个服务(抢 8081 端口) +""" +import hashlib, hmac, json, os, secrets, socket, subprocess, sys, threading, time +import urllib.error, urllib.request +import webbrowser +from datetime import datetime +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer + +HERE = os.path.dirname(os.path.abspath(__file__)) +CFG_FILE = os.path.join(HERE, "config.json") + +# ==================== 开单后台的 PIN 锁(金钻 2026-10-01)==================== +# 面板虽然只在局域网,但"家里同一个 WiFi 下谁都能开单/激活"总归不踏实。 +# 所以加一道 PIN:第一次打开自己设一个;之后每次进来输一次,12 小时内免输。 +# ⚠️ 校验在**服务端**(这里),不是前端挡一下 —— 前端只负责好看。 +# 忘了 PIN:删掉 \pin.json 再打开面板重新设一个。 +PIN_FILE = os.path.join(HERE, "pin.json") +SESS = {} # 会话 token -> 到期时间戳 +FAILS = {} # ip -> [失败时间戳] +SESS_HOURS = 12 +FAIL_MAX, FAIL_WIN = 5, 300 # 5 分钟内错 5 次就锁一会儿 + + +def _pin_hash(pin, salt): + return hashlib.sha256(("%s|%s" % (salt, pin)).encode("utf-8")).hexdigest() + + +def pin_saved(): + try: + with open(PIN_FILE, encoding="utf-8") as f: + return json.load(f) + except (OSError, ValueError): + return None + + +def pin_check(pin): + """True 对 / False 错 / None 还没设过""" + rec = pin_saved() + if not rec: + return None + return hmac.compare_digest(rec.get("hash", ""), _pin_hash(str(pin), rec.get("salt", ""))) + + +def pin_set(pin): + salt = secrets.token_hex(8) + with open(PIN_FILE, "w", encoding="utf-8") as f: + json.dump({"salt": salt, "hash": _pin_hash(str(pin), salt), + "set_at": datetime.now().isoformat(timespec="seconds")}, f) + try: + os.chmod(PIN_FILE, 0o600) + except OSError: + pass + + +def new_session(): + t = secrets.token_urlsafe(18) + SESS[t] = time.time() + SESS_HOURS * 3600 + return t + + +def sess_ok(tok): + exp = SESS.get(tok or "") + if not exp: + return False + if exp < time.time(): + SESS.pop(tok or "", None) + return False + return True + + +def fails_ok(ip): + now = time.time() + lst = [t for t in FAILS.get(ip, []) if now - t < FAIL_WIN] + FAILS[ip] = lst + return len(lst) < FAIL_MAX +LOG_FILE = os.path.join(HERE, "admin.log") +PORT = 8081 +TITLE = "金钻工坊 · 开单后台" +# 只有带 --open 才自动开浏览器(点开始菜单的快捷方式会带)—— +# 计划任务自启那份不带,否则每天开机都弹一个网页出来。 +OPEN_BROWSER = ("--open" in sys.argv) + +TEMPLATES = [ + ("stand", "站立正反"), + ("standb", "站立正反(虚化)"), + ("wheat", "麦田萤火"), + ("beach", "海边自拍"), + ("boom", "不看爆炸"), + ("sakura", "飞跃樱花林"), + ("airship", "空艇巡游"), +] + + +def log(*a): + try: + with open(LOG_FILE, "a", encoding="utf-8") as f: + f.write("[%s] %s\n" % (time.strftime("%Y-%m-%d %H:%M:%S"), " ".join(str(x) for x in a))) + except OSError: + pass + + +def load_cfg(): + try: + with open(CFG_FILE, encoding="utf-8") as f: + c = json.load(f) + except (OSError, ValueError) as e: + return {"error": "读不到 config.json(%s)—— 先跑一次服务器上的 deploy.py" % e} + c.setdefault("server", "http") + if not c.get("admin_token"): + c["error"] = "config.json 里没有 admin_token —— 在服务器上重跑 deploy.py 就有了" + return c + + +def call(path, payload=None, timeout=60): + """调服务器的管理接口。返回 (ok, 数据或错误文案)""" + c = load_cfg() + if c.get("error"): + return False, c["error"] + url = c["server"].rstrip("/") + "/" + path.lstrip("/") + data = json.dumps(payload).encode() if payload is not None else None + req = urllib.request.Request(url, data=data, method="POST" if data else "GET") + req.add_header("X-Admin-Token", c.get("admin_token") or "") + req.add_header("X-Ys-From", "panel") # 好看日志用(服务器只认 IP) + if data: + req.add_header("Content-Type", "application/json") + try: + with urllib.request.urlopen(req, timeout=timeout) as r: + body = r.read().decode("utf-8", "replace") + return True, json.loads(body or "{}") + except urllib.error.HTTPError as e: + try: + j = json.loads(e.read().decode("utf-8", "replace") or "{}") + except ValueError: + j = {} + if e.code == 403: + return False, ("服务器拒绝了:这台电脑的网络没被认出来。\n" + "多半是渲染机还没上报过心跳 —— 把「渲染机」开起来,等它发一次心跳(几分钟)就好了。") + return False, j.get("error") or ("服务器回 %s" % e.code) + except Exception as e: + return False, "连不上服务器:%r(检查网络 / 域名 shop.example.com 能不能开)" % e + + +# --------------------------------------------------------------------- 页面 +PAGE = r""" + + + +金钻工坊 · 开单后台 + +
+

开单后台已锁定

+

输入 PIN 解锁(12 小时内不用重复输)

+ + +
+
+

金钻工坊 · 开单后台

+
这块面板跑在家里电脑上,只在家里局域网能开 —— 不上公网。 +
+ +
正在连服务器…
+ + +
+ + +
+
+ +
+

① 生成卡密

+ +
+ + + + +
+ +
+ +
+ + + +
+
+ N = + + +
+ +
+ + +
+ +
+ + 同一套设置一次生成多张(每张一模一样) +
+ +
+ + +
+
+ + +
+
+ +
+ +
+

② 待激活订单(收完款点一下就开渲)

+
加载中…
+
+ +
+

③ 最近的卡密

+
+ + + + +
+
+ 核销 = 成品「开放下载」之后满 72 小时 —— 提交订单只是激活,不是核销。 +
+
加载中…
+
+ +
+

④ 免费码(福利券 · 买家自取)

+
+ 开一批「不用付钱」的券放到福利页让人自己领。规则固定、不可调: + 每台设备 + 每个网络各限领 1 张(防刷);领到后 7 天内要用掉, + 过期作废。收摊后已领走的不受影响。 +
+ + + +
+ + 先到先得,领完福利页上就变灰 +
+ +
+ + +
+
+ N = + + 买家可以只出 1 张,也可以几张皮肤凑够 N 张 +
+ +
+ +
+ + +
+ +
+ + + + +
+ +
+ + 到日子自动收摊(已领到的不受影响);填 0 = 一直开着 +
+ + + +
+ + +
+
+ + +
+
+
加载中…
+
+ +
+

⑤ 订单记录(谁下的 · 渲了几张 · 什么状态)

+
+
加载中…
+
+ +
+ + + +
+ +""" + + +def page(): + tpl = json.dumps(TEMPLATES, ensure_ascii=False) + return PAGE.replace("__TPL__", tpl).replace("__PRICE__", "6").encode("utf-8") + + +class H(BaseHTTPRequestHandler): + server_version = "ys-admin" + protocol_version = "HTTP/1.1" + + def log_message(self, *a): + pass + + def _out(self, code, body, ctype="application/json; charset=utf-8"): + self.send_response(code) + self.send_header("Content-Type", ctype) + self.send_header("Content-Length", str(len(body))) + self.send_header("Cache-Control", "no-store") + self.end_headers() + if self.command != "HEAD": + self.wfile.write(body) + + def js(self, obj, code=200): + self._out(code, json.dumps(obj, ensure_ascii=False).encode()) + + def body(self): + try: + n = int(self.headers.get("Content-Length") or 0) + return json.loads(self.rfile.read(n).decode("utf-8")) if n else {} + except (ValueError, UnicodeDecodeError, OSError): + return {} + + def _ip(self): + return (self.client_address[0] if self.client_address else "?") + + def pin_ok(self): + """会话是否有效(token 放 X-Pin 头里)""" + return sess_ok(self.headers.get("X-Pin")) + + def need_pin(self): + return self.js({"ok": False, "error": "还没解锁", "need_pin": True}, 401) + + def do_GET(self): + p = self.path.split("?")[0] + q = self.path.split("?")[1] if "?" in self.path else "" + if p in ("/", "/index.html"): + # 页面本身没有秘密(密钥都在服务端),所以不过锁;页面自己弹输入框 + return self._out(200, page(), "text/html; charset=utf-8") + if p == "/api/pinstate": + # 给页面判断「第一次用要设 PIN」还是「输入 PIN」 + return self.js({"ok": True, "need_set": not pin_saved()}) + if p == "/api/health": + # 免 PIN 的"还活着吗" —— 只给部署自检用,**不含订单/卡密**(那些要解锁) + return self.js({"ok": True, "pin": bool(pin_saved()), "host": socket.gethostname()}) + if not self.pin_ok(): + return self.need_pin() + if p == "/api/state": + return self.state(q) + if p == "/api/orders": + # 订单记录:把面板的查询串原样转给服务器(state / done / limit) + qs = self.path.split("?", 1)[1] if "?" in self.path else "" + ok, r = call("/admin/orders?" + qs) + return self.js(r if ok else {"ok": False, "error": r}) + if p == "/api/gifts": + # 免费码(福利券):批次 + 领取情况(转服务器 /order/api/admin/gifts) + ok, r = call("/admin/gifts") + return self.js(r if ok else {"ok": False, "error": r}) + return self.js({"ok": False, "error": "not found"}, 404) + + def do_POST(self): + p = self.path.split("?")[0] + # ---- 解锁 / 首次设置 PIN(这两个不需要会话)---- + if p == "/api/unlock": + d = self.body() + ip = self._ip() + if not fails_ok(ip): + log("PIN 试错太多次,已临时锁住 %s" % ip) + return self.js({"ok": False, + "error": "PIN 错的次数太多了,等 5 分钟再来"}, 429) + r = pin_check(d.get("pin")) + if r is None: + return self.js({"ok": False, "error": "这台电脑还没设过 PIN", "need_set": True}) + if not r: + FAILS.setdefault(ip, []).append(time.time()) + log("PIN 输错(%s)" % ip) + return self.js({"ok": False, "error": "PIN 不对"}, 403) + FAILS.pop(ip, None) + return self.js({"ok": True, "token": new_session()}) + if p == "/api/pinset": + d = self.body() + pin = str(d.get("pin") or "").strip() + if not (4 <= len(pin) <= 12) or not pin.isdigit(): + return self.js({"ok": False, "error": "PIN 要 4~12 位数字"}) + if pin_saved() and not self.pin_ok(): + return self.need_pin() # 改 PIN:得先解锁 + pin_set(pin) + log("PIN 已设置/更新") + return self.js({"ok": True, "token": new_session()}) + if not self.pin_ok(): + return self.need_pin() + if p == "/api/gen": + d = self.body() + ok, r = call("/admin/gen", d) + if not ok: + return self.js({"ok": False, "error": r}) + log("生成 %d 张 | %s | %s | 套装=%s 直发=%s" + % (len(r.get("codes") or []), d.get("platform") or "-", + ",".join(d.get("tpls") or []) or "-", d.get("set"), d.get("direct"))) + return self.js(r) + if p == "/api/activate": + d = self.body() + ok, r = call("/admin/activate", {"oid": d.get("oid")}) + log("激活 %s → %s" % (d.get("oid"), r)) + return self.js(r if ok else {"ok": False, "error": r}) + if p == "/api/void": + d = self.body() + ok, r = call("/admin/void", {"oid": d.get("oid")}) + log("注销 %s → %s" % (d.get("oid"), r)) + return self.js(r if ok else {"ok": False, "error": r}) + if p == "/api/savecsv": + d = self.body() + try: + outdir = os.path.join(HERE, "卡密导出") + os.makedirs(outdir, exist_ok=True) + fp = os.path.join(outdir, "codes-%s.csv" % time.strftime("%Y%m%d-%H%M%S")) + with open(fp, "w", encoding="utf-8-sig", newline="") as f: + f.write(d.get("csv") or "") + log("导出 CSV → %s" % fp) + return self.js({"ok": True, "path": fp}) + except OSError as e: + return self.js({"ok": False, "error": "写文件失败:%r" % e}) + # ---- 免费码(福利券)三件套:开批 / 补货 / 收摊 ---- + # 业务规则全在服务器(server.py 的 gift_batch_new/add/off),这里只转发 + 记日志。 + if p == "/api/gift/new": + d = self.body() + ok, r = call("/admin/gift/new", d) + log("开免费码批次 | %s | %s 张 | %s 张/券 | 锁模板=%s" + % (d.get("name"), d.get("count"), d.get("n_fix") or "不限", d.get("lock_tpl"))) + return self.js(r if ok else {"ok": False, "error": r}) + if p == "/api/gift/add": + d = self.body() + ok, r = call("/admin/gift/add", d) + log("免费码补货 | %s | +%s" % (d.get("batch"), d.get("count"))) + return self.js(r if ok else {"ok": False, "error": r}) + if p == "/api/gift/off": + d = self.body() + ok, r = call("/admin/gift/off", d) + log("免费码收摊 | %s" % d.get("batch")) + return self.js(r if ok else {"ok": False, "error": r}) + return self.js({"ok": False, "error": "not found"}, 404) + + # ---- 状态:ping + 待处理订单 + 卡密,一次给全(页面一次请求就够) ---- + def state(self, query): + want = "" + for kv in query.split("&"): + if kv.startswith("state="): + want = kv[6:] + ok, ping = call("/admin/ping") + if not ok: + return self.js({"ok": False, "error": ping}) + # ⚠️ failed 也要拉出来:不然渲染失败的单金钻在面板上完全看不见 + ok2, od = call("/admin/orders?state=unpaid,paid,waiting,working,failed") + ok3, cd = call("/admin/codes?limit=60" + ("&state=%s" % want if want else "")) + return self.js({"ok": True, **ping, + "orders": (od.get("orders") if ok2 else []) or [], + "codes": (cd.get("codes") if ok3 else []) or []}) + + +def single_instance(): + s = socket.socket() + try: + s.bind(("localhost", PORT)) + except OSError: + s.close() + return None + return s + + +def main(): + c = load_cfg() + log("开单后台启动 :%d | 服务器 %s | 令牌 %s" % (PORT, c.get("server"), + "有" if c.get("admin_token") else "❌没有")) + if c.get("error"): + log("⚠️ %s" % c["error"]) + # ⚠️ 单实例判定**不能**先 bind 一个 localhost:8081 再 bind :8081 —— + # 两个地址在同一个端口上会 EADDRINUSE(2026-09-30 自测实踩)。 + # 直接起服务:起不来就说明已经有一个在跑,开个浏览器就完事。 + try: + srv = ThreadingHTTPServer(("", PORT), H) # = 局域网(手机同 WiFi 也能开) + except OSError: + log("已经有一个开单后台在跑了%s" % (",这次只开浏览器" if OPEN_BROWSER else ",这次什么都不做")) + if OPEN_BROWSER: + webbrowser.open("htt" % PORT) + return + srv.daemon_threads = True + if OPEN_BROWSER: + threading.Timer(0.6, lambda: webbrowser.open("htt" % PORT)).start() + try: + srv.serve_forever() + except KeyboardInterrupt: + pass + + +if __name__ == "__main__": + main() diff --git a/backend/backend-tools/ys_local.py b/backend/backend-tools/ys_local.py new file mode 100644 index 0000000..98c43b6 --- /dev/null +++ b/backend/backend-tools/ys_local.py @@ -0,0 +1,411 @@ +# -*- coding: utf-8 -*- +""" +金钻工坊 · 本机开单工具(平台单专用) + +给「闲鱼 / B站工坊」这类聊天下单的买家出图用: + + 双击桌面「本机开单」→ 浏览器打开 htt + → 拖皮肤进去(同样自动质检)→ 勾模板 → 点开始 + → 本机 Blender 出图(标准压缩 + 16bit 无压缩,两张)→ 下载 / 打开文件夹 → 贴回闲鱼 + +安全设计(金钻 2026-09-30 提出「别人会暴力破解吧」): + * 只监听 localhost —— 公网、局域网都连不进来,根本没有暴露面 + * 不联网、不上传、不要兑换码、不碰服务器 + +渲染队列(金钻 2026-09-30:「也是渲染队列,不要一口气并行,会卡炸的」): + * **只有一个渲染线程**(qworker)→ 任何时刻至多一个 Blender 在跑 + * 多单进来排队 FIFO,页面显示「前面还有 N 单」 + * 一张图渲完才开下一张;串行是硬约束,不是性能优化 +""" +import base64 +import collections +import json +import os +import re +import socket +import subprocess +import threading +import time +import traceback +import urllib.parse +import webbrowser +from datetime import datetime +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer + +import ys_worker as W # 复用:配置 / 模板表 / Blender 查找 / 日志 + +HERE = os.path.dirname(os.path.abspath(__file__)) +PORT = 8082 +# ⚠️ 2026-10-04:单实例锁必须用**独立端口** —— 以前它 bind 的是 PORT(8082), +# 紧接着 ThreadingHTTPServer 又要 bind 8082,Windows 上会直接 WinError 10013 +# ("访问权限不允许的方式做套接字尝试")。ys_worker 用的 8083,这里用 8084。 +LOCK_PORT = 8084 +JOBS = {} # job_id -> dict +JOB_LOCK = threading.Lock() + +# ⚠️ 渲染队列:只有一个消费线程 → 至多一个 Blender 在跑 +JOBQ = collections.deque() +QCOND = threading.Condition() + + +# ------------------------------------------------------------------ 队列 +def enqueue(job_id): + with QCOND: + JOBQ.append(job_id) + _refresh_positions() + QCOND.notify() + + +def _refresh_positions(): + for i, jid in enumerate(JOBQ): + j = JOBS.get(jid) + if j is not None: + j["queue_pos"] = i + 1 + + +_queue_started = False + + +def start_queue(): + """起唯一的渲染线程(幂等)。main() 会调;测试也直接调它。""" + global _queue_started + if _queue_started: + return False + _queue_started = True + threading.Thread(target=qworker, daemon=True).start() + return True + + +def qworker(): + """唯一干活的人。串行是硬要求,别改成并行。""" + while True: + with QCOND: + while not JOBQ: + QCOND.wait() + jid = JOBQ.popleft() + _refresh_positions() + try: + run_job(jid) + except Exception: + j = JOBS.get(jid) + if j is not None: + j.update(state="error", error=traceback.format_exc()[-400:]) + + +# ------------------------------------------------------------------ 工具 +def local_archive(): + """本机单的留档根目录(和网页订单分开放,但共用同一套序号)""" + return W.CFG.get("local_archive") or os.path.join(W.CFG["archive"], "本地") + + +def now_s(): + return datetime.now().strftime("%Y-%m-%d %H:%M:%S") + + +def scan_assets(): + """体检:Blender / 模板 / 渲染脚本 都在不在(页面进来就先告诉你,别等渲到一半才报错)""" + blender = W.find_blender() + tpl_root = W.CFG["tpl_root"] + missing = [] + for k, fn in W.TEMPLATES.items(): + if not os.path.exists(os.path.join(tpl_root, fn)): + missing.append(fn) + return { + "blender": blender, + "blender_ok": bool(blender), + "tpl_root": tpl_root, + "make_order": W.CFG["make_order"], + "make_order_ok": os.path.exists(W.CFG["make_order"]), + "archive": local_archive(), + "templates": {k: {"file": fn, "ok": os.path.exists(os.path.join(tpl_root, fn))} + for k, fn in W.TEMPLATES.items()}, + "missing": missing, + } + + +def open_browser(url): + """只在 Windows 上自动开浏览器。 + 服务器/无桌面环境调 xdg-open 会去连 D-Bus,起不来还刷错误,没必要。""" + if os.name != "nt" and not os.environ.get("YS_OPEN_BROWSER"): + return + try: + webbrowser.open(url) + except Exception: + pass + + +# ------------------------------------------------------------------ 渲染 +def write_png(dataurl, dest): + if "," in dataurl: + dataurl = dataurl.split(",", 1)[1] + with open(dest, "wb") as f: + f.write(base64.b64decode(dataurl)) + + +def pick_outputs(d, tpl_key, res): + """挑出这一单的两张成品。命名规则(金钻 2026-09-30 定稿,见 ys_worker.deliver_names): + 默认 1000 → 飞跃樱花林.png + 飞跃樱花林无压缩版.png + 其它 N → 飞跃樱花林N.png + 飞跃樱花林N无压缩版.png + 找不到就退回"目录里有的",别让一次改名把成品弄丢。""" + sn, un = W.deliver_names(tpl_key, res) + std = os.path.join(d, sn) + if not os.path.exists(std): + cands = [f for f in sorted(os.listdir(d)) + if f.lower().endswith(".png") and W.UNC_SUFFIX not in f] + std = os.path.join(d, cands[0]) if cands else None + unc = os.path.join(d, un) + if not os.path.exists(unc): + cands = [f for f in sorted(os.listdir(d)) + if f.lower().endswith(".png") and W.UNC_SUFFIX in f] + unc = os.path.join(d, cands[0]) if cands else None + return std, unc + + +def run_job(job_id): + j = JOBS[job_id] + j["state"] = "running" + j["queue_pos"] = 0 + try: + blender = W.find_blender() + if not blender: + j.update(state="error", error="找不到 blender.exe(把路径填进 config.json 的 blender 字段)") + return + work = os.path.join(HERE, "work") + os.makedirs(work, exist_ok=True) + # 用买家原始文件名建临时皮肤 —— 留档文件夹里要看到客户给的那张图叫什么 + safe = re.sub(r'[\\/:*?"<>|]+', "_", (j.get("fileName") or "skin.png")).strip() or "skin.png" + if not safe.lower().endswith(".png"): + safe += ".png" + skin = os.path.join(work, safe) + write_png(j["skin"], skin) + j["skin"] = None # 立刻丢掉 base64,别占内存 + + root = local_archive() + os.makedirs(root, exist_ok=True) + + for idx, tk in enumerate(j["templates"]): + j["current"] = idx + 1 + fname = W.TEMPLATES.get(tk) + if not fname: + j["errors"].append("未知模板:%s" % tk) + continue + tpl = os.path.join(W.CFG["tpl_root"], fname) + if not os.path.exists(tpl): + j["errors"].append("%s:模板文件不存在" % fname) + continue + + out_name = W.tpl_base(tk) + res = int(j.get("res") or W.DEFAULT_RES) + # 不加 --uncompressed:这个开关现在默认就是开的(金钻:两张都要发顾客) + # 成品文件夹用成品名;皮肤先放进去;工程走临时目录,渲完删 + d, dbase = W.prepare_out_dir(root, tk, res, skin) + cmd = [blender, "-b", "--factory-startup", "--python", W.CFG["make_order"], "--", + "--template", tpl, "--skin", skin, + "--orders-dir", root, "--out-dir", d, "--res", str(res)] + W.log("[本机单] 渲染 %s → %s(%d px)" % (fname, os.path.basename(d), res)) + okr, tail, dt, note = W.run_blender(cmd) + if not okr: + j["errors"].append("%s:%s" % (fname, note)) + continue + seq = W.next_seq({"来源": "本机开单(平台单)", "模板": out_name, + "成品文件夹": os.path.basename(d), "分辨率": res, + "皮肤文件": os.path.basename(skin), "备注": j.get("note") or "", + "耗时秒": round(dt, 1)}) + + std, unc = pick_outputs(d, tk, res) + if not std: + j["errors"].append("%s:渲染完成但没找到 png" % fname) + continue + if not unc: + j["errors"].append("%s:无压缩版没生成(只出了标准版)" % fname) + + info = {"序号": seq, "文件夹": os.path.basename(d), + "来源": "本机开单(平台单)", "模板": out_name, "模板key": tk, + "分辨率": res, "皮肤文件": os.path.basename(skin), "手臂规格": j.get("arm"), + "条款版本": W.TERMS_VERSION, + "条款说明": "仅提供渲染服务;皮肤内容合法性由提供者负责", + "买家备注": j.get("note") or "", "渲染完成时间": now_s(), + "渲染耗时秒": round(dt, 1), + "交付件": [os.path.basename(x) for x in (std, unc) if x]} + try: + with open(os.path.join(d, "订单信息.json"), "w", encoding="utf-8") as f: + json.dump(info, f, ensure_ascii=False, indent=1) + except OSError: + pass + + sn, un = W.deliver_names(tk, res) + j["results"].append({"seq": seq, "tpl": tk, "res": res, "kind": "标准压缩", + "name": sn, "path": std, "dir": d, "sec": round(dt, 1)}) + if unc: + j["results"].append({"seq": seq, "tpl": tk, "res": res, "kind": "无压缩(16bit)", + "name": un, "path": unc, "dir": d, "sec": round(dt, 1)}) + W.log("[本机单] 完成 %s → %s(%.1fs,两张)" % (fname, std, dt)) + + j["state"] = "done" if j["results"] else "error" + if not j["results"]: + j["error"] = ";".join(j["errors"])[:400] or "没有产出任何图片" + j["finished"] = now_s() + except subprocess.TimeoutExpired: + j.update(state="error", error="渲染超时(超过 1 小时)") + except Exception: + j.update(state="error", error=traceback.format_exc()[-400:]) + finally: + try: + if skin and os.path.exists(skin): + os.remove(skin) + except (OSError, NameError): + pass + + +# ------------------------------------------------------------------ HTTP +class H(BaseHTTPRequestHandler): + protocol_version = "HTTP/1.1" + server_version = "ys-local" + + def log_message(self, fmt, *a): # 静音,别刷屏 + pass + + def send(self, code, body, ctype="application/json; charset=utf-8", extra=None): + if isinstance(body, str): + body = body.encode("utf-8") + self.send_response(code) + self.send_header("Content-Type", ctype) + self.send_header("Content-Length", str(len(body))) + self.send_header("Cache-Control", "no-store") + for k, v in (extra or {}).items(): + self.send_header(k, v) + self.end_headers() + try: + self.wfile.write(body) + except (BrokenPipeError, ConnectionResetError): + pass + + def js(self, obj, code=200): + self.send(code, json.dumps(obj, ensure_ascii=False)) + + def static(self, name, ctype): + p = os.path.join(HERE, name) + if not os.path.exists(p): + return self.send(404, "missing", "text/plain; charset=utf-8") + with open(p, "rb") as f: + self.send(200, f.read(), ctype) + + def do_GET(self): + u = urllib.parse.urlparse(self.path) + p = u.path + if p in ("/", "/index.html"): + return self.static("local.html", "text/html; charset=utf-8") + if p == "/skincheck.js": + return self.static("skincheck.js", "application/javascript; charset=utf-8") + if p == "/api/status": + return self.js(scan_assets()) + + m = re.fullmatch(r"/api/job/([A-Za-z0-9]+)", p) + if m: + j = JOBS.get(m.group(1)) + if not j: + return self.js({"ok": False, "error": "任务不存在"}, 404) + return self.js({k: v for k, v in j.items() if k != "skin"}) + + m = re.fullmatch(r"/api/file/([A-Za-z0-9]+)/(\d+)", p) + if m: + j = JOBS.get(m.group(1)) + if not j: + return self.send(404, "no job", "text/plain") + i = int(m.group(2)) + if i >= len(j["results"]): + return self.send(404, "no file", "text/plain") + r = j["results"][i] + with open(r["path"], "rb") as f: + # ⚠️ HTTP 头只能是 latin-1,中文文件名直接扔 UnicodeEncodeError + # → 连接被掐断(浏览器看就是「下载失败」)。必须 ASCII 回退名 + RFC 5987。 + ascii_name = r["name"].encode("ascii", "replace").decode("ascii").replace("?", "_") + cd = ("inline; filename=\"%s\"; filename*=UTF-8''%s" + % (ascii_name, urllib.parse.quote(r["name"], safe=""))) + return self.send(200, f.read(), "image/png", {"Content-Disposition": cd}) + return self.send(404, "not found", "text/plain; charset=utf-8") + + def do_POST(self): + u = urllib.parse.urlparse(self.path) + n = int(self.headers.get("Content-Length") or 0) + if n > 64 * 1024 * 1024: + return self.js({"ok": False, "error": "请求过大"}, 413) + try: + d = json.loads(self.rfile.read(n) or b"{}") if n else {} + except ValueError: + return self.js({"ok": False, "error": "请求体不合法"}, 400) + + if u.path == "/api/render": + tpls = [t for t in (d.get("templates") or []) if t in W.TEMPLATES][:10] + if not d.get("skin") or not tpls: + return self.js({"ok": False, "error": "缺皮肤或缺模板"}, 400) + st = scan_assets() + if not st["blender_ok"]: + return self.js({"ok": False, "error": "没找到 blender.exe"}, 400) + jid = "%s%04d" % (datetime.now().strftime("%H%M%S"), len(JOBS)) + JOBS[jid] = {"id": jid, "state": "queued", "queue_pos": 0, "created": now_s(), + "skin": d["skin"], "fileName": d.get("fileName") or "skin.png", + "templates": tpls, "arm": d.get("arm") or "", + "res": int(d.get("res") or W.DEFAULT_RES), + "note": (d.get("note") or "")[:200], + "total": len(tpls), "current": 0, "results": [], "errors": []} + enqueue(jid) # ← 进队列,由唯一的渲染线程串行处理 + return self.js({"ok": True, "job": jid}) + + if u.path == "/api/openfolder": + j = JOBS.get(d.get("job") or "") + if not j or not j.get("results"): + return self.js({"ok": False, "error": "还没有产出"}, 400) + folder = j["results"][0]["dir"] + try: + if hasattr(os, "startfile"): # Windows + os.startfile(folder) + else: + subprocess.Popen(["xdg-open", folder]) + return self.js({"ok": True, "folder": folder}) + except Exception as e: + return self.js({"ok": False, "error": "%s 目录:%s" % (e, folder)}, 500) + + if u.path == "/api/quit": + self.js({"ok": True}) + threading.Thread(target=lambda: (time.sleep(0.4), os._exit(0)), daemon=True).start() + return + + return self.js({"ok": False, "error": "not found"}, 404) + + +def single_instance(): + """只允许开一个:不然两个页面同时开两个 Blender 会把机器顶满""" + s = socket.socket() + try: + s.bind(("localhost", LOCK_PORT)) + s.listen(1) + return s + except OSError: + return None + + +def main(): + W.load_cfg() + lock = single_instance() + if not lock: + print("本机开单工具已经在跑了,直接打开 htt" % PORT) + open_browser("htt" % PORT) + time.sleep(4) + return + start_queue() # 唯一的渲染线程 + a = scan_assets() + print("=" * 56) + print(" 金钻工坊 · 本机开单工具(平台单)") + print(" 地址 htt (只有这台电脑能开)" % PORT) + print(" Blender %s" % (a["blender"] or "❌ 没找到")) + print(" 模板 %s(缺 %d 个)" % (a["tpl_root"], len(a["missing"]))) + print(" 留档 %s" % a["archive"]) + print(" 队列 串行,一次只开一个 Blender") + print("=" * 56, flush=True) + open_browser("htt" % PORT) + ThreadingHTTPServer(("localhost", PORT), H).serve_forever() + + +if __name__ == "__main__": + main() diff --git a/backend/backend-tools/ys_worker.py b/backend/backend-tools/ys_worker.py new file mode 100644 index 0000000..32cec83 --- /dev/null +++ b/backend/backend-tools/ys_worker.py @@ -0,0 +1,663 @@ +# -*- coding: utf-8 -*- +""" +金钻工坊 · 渲染下单 —— 宿主机渲染机(worker) + +开机启动后自动干活: + 心跳上报 → 拉一单 → 下载皮肤 → 用 Blender 按模板出图 → 回传服务器 → 永久留档 + +留档(金钻要求:时间 / 序号 / 兑换码 / 皮肤 / 成图): + + 模板.blend、_assets\\skin.png、<模板名>.png、订单信息.json + +只在需要时连服务器(出站),服务器从不主动连你。 +""" +import base64, json, os, re, shutil, signal, socket, subprocess, sys, threading, time, traceback +import urllib.request, urllib.error +from datetime import datetime + +HERE = os.path.dirname(os.path.abspath(__file__)) + +# ---- 成品命名(金钻 2026-09-30 定稿,和 make_order.py 必须一致)---- +# 默认 1000 → <模板名>.png + <模板名>无压缩.png +# 其它 N → <模板名>N.png + <模板名>N无压缩.png +DEFAULT_RES = 1000 +UNC_SUFFIX = "无压缩" +# 服务条款版本 —— 与网页 index.html / 后端 server.py 必须一致(2026-09-30 金钻定) +TERMS_VERSION = "2026-10-01.1" + +# ---------------------------------------------------------------- 配置 +CFG = { + "server": "http", + "token": "", + "tpl_root": r"", + "make_order": r"\make_order.py", + "archive": r"", + "blender": "", # 留空 = 自动查找 + "res": DEFAULT_RES, # 出图分辨率;文件名规则见上 + "poll": 20 +} +TEMPLATES = { # key 必须和下单页一致 + "stand": "1站立正反.blend", + "standb": "2站立正反加虚化.blend", + "wheat": "3麦田萤火.blend", + "beach": "4海边自拍.blend", + "boom": "5不看爆炸.blend", + "sakura": "6飞跃樱花林.blend", + "airship": "7空艇巡游.blend", +} +def tpl_base(tpl_key): + """模板中文名(去掉文件名开头的序号):3麦田萤火.blend → 麦田萤火""" + return re.sub(r"^\d+", "", os.path.splitext(TEMPLATES.get(tpl_key, tpl_key))[0]) + + +def out_base(tpl_key, res): + res = int(res or DEFAULT_RES) + b = tpl_base(tpl_key) + return b if res == DEFAULT_RES else "%s%d" % (b, res) + + +def deliver_names(tpl_key, res): + b = out_base(tpl_key, res) + return b + ".png", b + UNC_SUFFIX + ".png" + + +def prepare_out_dir(root, tpl_key, res, skin_path): + """建成品文件夹并**先把皮肤放进去**(金钻 2026-09-30)。 + 文件夹名 = 成品名(`飞跃樱花林` / `飞跃樱花林1080`);重名加 -2/-3, + 同一个模板被买两次不能互相覆盖。返回 (文件夹, 成品基名)。""" + base = out_base(tpl_key, res) + d = os.path.join(root, base) + n = 2 + while os.path.exists(d): + d = os.path.join(root, "%s-%d" % (base, n)) + n += 1 + os.makedirs(d, exist_ok=True) + if skin_path and os.path.exists(skin_path): + dst = os.path.join(d, os.path.basename(skin_path)) + if os.path.abspath(dst) != os.path.abspath(skin_path): + shutil.copy2(skin_path, dst) + return d, base + + +LOCK_PORT = 8083 # 单实例锁 +LOG = os.path.join(HERE, "worker.log") + + +def log(*a): + line = "[%s] %s" % (datetime.now().strftime("%Y-%m-%d %H:%M:%S"), " ".join(str(x) for x in a)) + print(line, flush=True) + try: + if os.path.exists(LOG) and os.path.getsize(LOG) > 2 * 1024 * 1024: + shutil.move(LOG, LOG + ".old") + with open(LOG, "a", encoding="utf-8") as f: + f.write(line + "\n") + except OSError: + pass + + +def load_cfg(): + p = os.path.join(HERE, "config.json") + if os.path.exists(p): + try: + CFG.update(json.load(open(p, encoding="utf-8"))) + except Exception as e: + log("config.json 读取失败:%r(用默认值继续)" % e) + + +# ---------------------------------------------------------------- HTTP +def http(path, obj=None, raw=False, timeout=120, tries=1, gap=5): + """调服务器。tries>1 时网络抖动会自己重试。 + + ⚠️ 2026-09-30 晚实踩:原来只接 HTTPError,**网络层的异常直接抛出去**。 + 那次是无压缩(约 10MB)回传时 TLS 断了一下(`EOF occurred in violation of protocol`), + 异常一路冒到轮询循环 → 这一单**剩下的模板全没渲**,还得等 45 分钟退回重来。 + 所以:网络异常要么在重试里消化掉,要么返回「失败」让调用方按普通失败处理。 + """ + url = CFG["server"].rstrip("/") + path + data = json.dumps(obj).encode("utf-8") if obj is not None else None + req = urllib.request.Request(url, data=data, method="POST" if data else "GET") + req.add_header("Content-Type", "application/json") + req.add_header("X-Worker-Token", CFG.get("token") or "") + last = None + for i in range(max(1, tries)): + try: + with urllib.request.urlopen(req, timeout=timeout) as r: + body = r.read() + return (r.status, body if raw else json.loads(body)) + except urllib.error.HTTPError as e: + return (e.code, e.read() if raw else {"ok": False, "error": "HTTP %d" % e.code}) + except (urllib.error.URLError, OSError, ValueError) as e: + last = e + if i < tries - 1: + log("网络异常,%ds 后重试(第 %d/%d 次):%r" % (gap, i + 1, tries, e)) + time.sleep(gap) + return (0, {"ok": False, "error": "网络异常 %r" % last}) + + +# ---------------------------------------------------------------- Blender +def find_blender(): + if CFG.get("blender") and os.path.exists(CFG["blender"]): + return CFG["blender"] + cands = [] + for base in (r"", r"", + r"", r"", r""): + if os.path.isdir(base): + for d in sorted(os.listdir(base), reverse=True): + p = os.path.join(base, d, "blender.exe") + if os.path.exists(p): + cands.append(p) + cands.append(os.path.join(base, d, "blender-launcher.exe")) + for p in cands: + if p.lower().endswith("blender.exe") and os.path.exists(p): + return p + return "" + + +# ===== 序号登记(金钻 2026-09-30:专门用一个文件存,不依赖文件夹)===== +# ⚠️ 以前靠扫文件夹名推序号 —— 文件夹一改名/挪地方序号就乱。 +# 现在序号写在登记文件里,文件夹怎么动都不影响连续性。 +SEQ_FILE_NAME = "_序号登记.json" + + +def seq_file(): + return os.path.join(CFG["archive"], SEQ_FILE_NAME) + + +def _seed_seq_from_folders(): + """登记文件第一次用(或丢了)时,从老文件夹名估个起点,别从 001 重来。""" + n = 0 + try: + for name in os.listdir(CFG["archive"]): + m = re.fullmatch(r"(\d{3})", name) + if m: + n = max(n, int(m.group(1))) + except OSError: + pass + return n + + +def next_seq(rec=None): + """领一个新序号,写进登记文件。返回整数序号。 + + 登记明细里记下:时间 / 来源 / 订单号 / 兑换码 / 模板 / 成品文件夹 / 分辨率 —— + 「看号就知道是第几单、谁的单、出的哪个模板」。 + 写文件用 tmp + os.replace 原子替换,断电也不会写坏。 + """ + os.makedirs(CFG["archive"], exist_ok=True) + p = seq_file() + d = {} + if os.path.exists(p): + try: + with open(p, encoding="utf-8") as f: + d = json.load(f) or {} + except Exception as e: + log("⚠️ 序号登记文件读不动(%r),按 0 起算" % e) + d = {} + if not isinstance(d.get("last"), int): + d["last"] = _seed_seq_from_folders() + d["_起点说明"] = "首次创建:按已有文件夹名估的起点" + n = int(d["last"]) + 1 + d["last"] = n + r = dict(rec or {}) + r.setdefault("序号", n) + r.setdefault("时间", time.strftime("%Y-%m-%d %H:%M:%S")) + d.setdefault("明细", []).append(r) + d["明细"] = d["明细"][-1000:] # 只留最近 1000 条,别把文件撑大 + tmp = p + ".tmp" + try: + with open(tmp, "w", encoding="utf-8") as f: + json.dump(d, f, ensure_ascii=False, indent=1) + os.replace(tmp, p) + except OSError as e: + log("⚠️ 序号登记写失败:%r" % e) + return n + + +# ===== Blender 看门狗(金钻 2026-09-30:卡到十分钟就关掉重开再渲)===== +BLENDER_TIMEOUT = 600 # 单张 10 分钟;4096 实测 ~10 分钟内,够用 +BLENDER_RETRY = 1 # 卡住就杀掉重开一次;再卡就判失败,别死循环 + + +def _kill_tree(proc): + """连子进程一起杀。Blender 会开子进程,只杀父进程会留孤儿继续吃 GPU。 + + Windows 用 taskkill /T 杀整棵树;其它平台 fallback 到 proc.kill() + —— 这样在 Linux 上也能跑测试。 + """ + if os.name == "nt": + try: + subprocess.run(["taskkill", "/F", "/T", "/PID", str(proc.pid)], + capture_output=True, timeout=30) + return + except Exception as e: + log("⚠️ taskkill 失败 pid=%s:%r(改用 proc.kill)" % (proc.pid, e)) + # POSIX:连**整个进程组**一起杀。 + # 只 kill 父进程的话,子进程还活着占着 stdout 管道 → communicate() 白等 30 秒(实测踩过) + try: + os.killpg(os.getpgid(proc.pid), signal.SIGKILL) + except Exception: + try: + proc.kill() + except Exception as e: + log("⚠️ 杀进程失败 pid=%s:%r" % (proc.pid, e)) + + +SKIN_DIAG = [] # 最近几次渲染里"皮肤节点认了谁"的日志 —— 回传服务器,云端直接查 + # (2026-10-01:空艇模板渲染出默认皮肤,只能远程到宿主翻日志才知道它挑了谁) + + +def note_skin_diag(tpl_key, out): + """从 Blender 输出里挑出与"皮肤节点判定"有关的几行,留着回传。""" + for ln in (out or "").splitlines(): + s = ln.strip() + if ("皮肤节点" in s) or ("贴图节点候选" in s) or s.startswith("皮肤 "): + SKIN_DIAG.append("[%s] %s" % (tpl_key, s[:220])) + if len(SKIN_DIAG) > 12: + del SKIN_DIAG[:-12] + + +# 从 Blender 的一行输出里抠进度:`Sample 12/128`、`Rendered 3/8 Tiles`… 抠不到就返回 None +_PCT_RES = [ + re.compile(r"(?:Sample|Path Tracing Sample|Rendered|Rendering|Tiles)\D{0,20}?(\d+)\s*/\s*(\d+)"), + re.compile(r"(\d+)\s*/\s*(\d+)\s*(?:tiles|samples)", re.I), +] + + +def blender_pct(line): + """Blender 那行输出 → 百分比;认不出来就 None(金钻 2026-10-04:进度要给买家看)。""" + if not line or "/" not in line: + return None + for rx in _PCT_RES: + m = rx.search(line) + if not m: + continue + try: + a, b = int(m.group(1)), int(m.group(2)) + except ValueError: + continue + if b > 0 and 0 <= a <= b: + return int(a * 100.0 / b) + return None + + +def run_blender(cmd, timeout=None, retry=None, on_progress=None): + """带超时看门狗的渲染。返回 (ok, 输出尾巴, 耗时秒, 说明)。 + + 「关掉重新打开」= 直接重跑同一条命令 —— 工程每次都是**从干净模板新复制的副本**, + 所以重开等于全新开始,能救掉偶发卡死(GPU 驱动抽风、贴图读挂等)。 + + on_progress(pct):渲的过程中有进度就回调(金钻 2026-10-04)。它在**读输出的线程**上跑, + 所以:不许抛异常、不许阻塞太久(回调里已经有节流 + 超时)。 + """ + timeout = timeout or BLENDER_TIMEOUT + retry = BLENDER_RETRY if retry is None else retry + t_all = time.time() + last = "" + for attempt in range(retry + 1): + try: + kw = {} + if os.name != "nt": + kw["start_new_session"] = True # 自成进程组,超时能整组杀干净 + p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, + text=True, encoding="utf-8", errors="replace", bufsize=1, **kw) + except OSError as e: + return False, "", time.time() - t_all, "启动 Blender 失败:%r" % e + # 输出交给**独立线程**读:一边攒全文,一边挑进度行回调。 + # 主线程只负责等它结束 / 超时 —— 超时看门狗的行为和以前完全一样。 + buf = [] + + def _pump(): + try: + tail = "" + while True: + chunk = p.stdout.read(512) + if not chunk: + break + tail += chunk + # ⚠️ Blender 的进度条是**回车原地刷新**的(`... Sample 4/128\r`), + # 按"行"读(for line in stdout)压根读不到 —— 2026-10-04 金钻要 + # 「按 blender 的完成度」才发现。所以这里 \n 和 \r 都当分隔符切。 + while True: + cuts = [i for i in (tail.find("\n"), tail.find("\r")) if i >= 0] + if not cuts: + break + i = min(cuts) + line, tail = tail[:i + 1], tail[i + 1:] + buf.append(line) + if on_progress: + pct = blender_pct(line) + if pct is not None: + try: + on_progress(pct) + except Exception: + pass + if tail: + buf.append(tail) + except Exception: + pass + th = threading.Thread(target=_pump, daemon=True) + th.start() + try: + p.wait(timeout=timeout) + th.join(timeout=15) + out = "".join(buf) + if p.returncode == 0: + return True, out or "", time.time() - t_all, "" + # ⚠️ 以前只留 400 字,结果失败时看不到自己打的 FATAL 行(2026-10-01 查空艇报错时踩到) + _txt = (out or "").strip() + _keys = [ln.strip() for ln in _txt.splitlines() + if any(k in ln for k in ("FATAL", "MAKE-ORDER", "Error", "Traceback", "错误"))] + last = "Blender 退出码 %s:%s" % ( + p.returncode, + (" | ".join(_keys[-6:]) + " | " if _keys else "") + _txt[-1200:]) + log("渲染失败:%s" % last) + except subprocess.TimeoutExpired: + log("⚠️ 渲染卡住超过 %d 秒 —— 杀掉,重新打开再渲" % timeout) + _kill_tree(p) + try: + p.wait(timeout=10) # 收尸;整组杀过就该立刻返回 + except Exception: + pass + last = "渲染卡住超过 %d 秒(已杀掉重开)" % timeout + if attempt < retry: + log("↻ 重开渲染(第 %d 次尝试)" % (attempt + 2)) + return False, "", time.time() - t_all, last + + +def render_one(tpl_key, skin_path, order_meta, res=DEFAULT_RES, arm="auto", on_progress=None): + """渲染一张,返回 (成功?, png路径 或 错误信息) + + arm:这张皮肤的臂型(auto/classic/slim)。多皮肤单里**每张皮肤各自一个臂型**, + 由调用方从服务器给的皮肤清单里带下来(金钻 2026-10-01:以前压根没传,买家手改无效)。 + """ + fname = TEMPLATES.get(tpl_key) + if not fname: + return False, "未知模板 key:%s" % tpl_key + tpl = os.path.join(CFG["tpl_root"], fname) + if not os.path.exists(tpl): + return False, "模板文件不存在:%s" % tpl + blender = find_blender() + if not blender: + return False, "找不到 blender.exe(请在 config.json 里指定 blender 路径)" + if not os.path.exists(CFG["make_order"]): + return False, "找不到 make_order.py:%s" % CFG["make_order"] + + out_name = tpl_base(tpl_key) + # 文件夹用成品名,皮肤先放进去;工程走临时目录,渲完删(金钻:不留 .blend) + order_dir, base = prepare_out_dir(CFG["archive"], tpl_key, res, skin_path) + cmd = [blender, "-b", "--factory-startup", "--python", CFG["make_order"], "--", + "--template", tpl, "--skin", skin_path, "--arm", arm or "auto", + "--orders-dir", CFG["archive"], "--out-dir", order_dir, "--res", str(int(res))] + # 某个模板的皮肤材质名固定不下来时,可以在 config.json 里钉死: + # "skin_materials": {"airship": "材质名"} + # (2026-10-01:空艇模板自动找皮肤节点找错,先留好这个后门口子) + _sm = (CFG.get("skin_materials") or {}).get(tpl_key) + if _sm: + cmd += ["--skin-material", _sm] + log("渲染 %s(模板 %s,臂型 %s)" % (tpl_key, fname, arm or "auto")) + okr, tail, dt, note = run_blender(cmd, on_progress=on_progress) + note_skin_diag(tpl_key, tail) # 不管成没成,先把"皮肤节点认了谁"记下来 + if not okr: + return False, note + + # 找成品:优先 <名称>.png(命名规则见 out_base),其次目录里最新的 png + cand = os.path.join(order_dir, base + ".png") + if not os.path.exists(cand): + pngs = [f for f in os.listdir(order_dir) if f.lower().endswith(".png")] + pngs = [f for f in pngs if "无压缩" not in f and f != "1000.png"] or pngs + if not pngs: + return False, "渲染完成但没找到 png(看 %s)" % order_dir + cand = os.path.join(order_dir, sorted(pngs, key=lambda f: os.path.getmtime( + os.path.join(order_dir, f)))[-1]) + + # 渲染成功才领序号(失败的图不占号),并登记进专门的文件 + seq = next_seq({ + "来源": "网页订单", + "订单号": order_meta.get("oid"), + "兑换码": order_meta.get("codes") or [], + "模板": out_name, + "成品文件夹": os.path.basename(order_dir), + "分辨率": res, + "耗时秒": round(dt, 1), + }) + + # 金钻要的留档:时间 / 序号 / 兑换码 + info = { + "序号": seq, + "订单号": order_meta.get("oid"), + "兑换码": order_meta.get("codes") or [], + "模板": out_name, + "模板key": tpl_key, + "成品文件夹": os.path.basename(order_dir), + "分辨率": res, + "皮肤文件": "skin.png", + "客户提交时间": order_meta.get("created"), + "渲染完成时间": datetime.now().isoformat(timespec="seconds"), + "渲染耗时秒": round(dt, 1), + "手臂规格": (arm if arm and arm != "auto" else order_meta.get("arm")), + "条款版本": order_meta.get("terms_v") or TERMS_VERSION, + } + try: + with open(os.path.join(order_dir, "订单信息.json"), "w", encoding="utf-8") as f: + json.dump(info, f, ensure_ascii=False, indent=1) + except OSError as e: + log("写 订单信息.json 失败:%r" % e) + # 无压缩版(make_order 默认就会生成):<名称>无压缩版.png + unc = os.path.join(order_dir, out_base(tpl_key, res) + UNC_SUFFIX + ".png") + if not os.path.exists(unc): + cands = [f for f in sorted(os.listdir(order_dir)) + if f.lower().endswith(".png") and UNC_SUFFIX in f] + unc = os.path.join(order_dir, cands[0]) if cands else None + if not unc or not os.path.exists(unc): + unc = None + log("⚠️ 无压缩版没生成,这次只交标准版") + log("完成 %s → %s(序号 %03d,%.1fs,%s)" % (tpl_key, cand, seq, dt, "两张" if unc else "一张")) + return True, {"std": cand, "unc": unc, "seq": seq, "sec": round(dt, 1)} + # seq = 留档序号(小票/订单信息里印);sec = 这张渲了多久(服务器拿它估下一单的时间) + + +def deliver_names_for(skin_i, tk, res, dedup=True): + """第 skin_i 张皮肤、模板 tk 的交付名。 + + ⚠️ 只有**同一个模板被多张皮肤用到**时才需要加 -2/-3(不加会在服务器同一个目录里互相覆盖)。 + 不同皮肤用不同模板(金钻的常见用法:A 出麦田、B 出樱花)就保持干净的名字。 + """ + sn, un = deliver_names(tk, res) + if skin_i <= 0 or not dedup: + return sn, un + k = "-%d" % (skin_i + 1) + + def ins(n): + return (n[:-4] + k + ".png") if n.lower().endswith(".png") else (n + k) + return ins(sn), ins(un) + + +def handle_order(o): + oid = o["oid"] + tpls = o.get("templates") or [] + order_res = int(o.get("res") or CFG.get("res") or DEFAULT_RES) + log("领到订单 %s:%d 张 %s" % (oid, len(tpls), ",".join(tpls))) + + # ---- 皮肤清单(金钻 2026-10-01:多皮肤单 = **每张皮肤 × 每个模板**出图)---- + # 服务器在 /claim 里把清单带下来:[{id,fileName,arm}]。老单没有就按 1 张算。 + skins = o.get("skins") or [{"id": "s1", "fileName": "skin.png", "arm": "auto"}] + tpls = o.get("templates") or [] + order_res = int(o.get("res") or CFG.get("res") or DEFAULT_RES) + # 只重渲勾选的那几张(金钻 2026-10-04:「不需要重渲的就不用再重渲了,费力不讨好」) + # 服务器给了清单就只干这几个模板 —— 换皮肤时清单是空的,那就还是整单重出。 + redo_tpls = [t for t in (o.get("redo_tpls") or []) if t] + if redo_tpls: + for sk in skins: + sk["tpls"] = [t for t in (sk.get("tpls") or tpls) if t in redo_tpls] + log("这一单只重渲:%s" % "、".join(redo_tpls)) + # ⚠️ 张数 = **各皮肤自己挑的模板加起来**(金钻 2026-10-01:不是乘法) + # ⚠️ 只重渲一部分时,total 要**加上保留下来的那几张** —— 服务器是按 total 判断"收满了"的, + # 少了这个数就会在最后一张还没传完时提前标完成(2026-10-04 自测踩到,少了一张无压缩版)。 + _keep = int(o.get("keep_n") or 0) if redo_tpls else 0 + plan = _keep + sum(len(sk.get("tpls") or tpls) for sk in skins) * 2 + log("领到订单 %s:%d 张皮肤,共 %d 张图(%s)" + % (oid, len(skins), plan // 2, + "; ".join("%s→%s" % (sk.get("fileName") or "?", "、".join(sk.get("tpls") or tpls)) + for sk in skins))) + + work = os.path.join(HERE, "work") + os.makedirs(work, exist_ok=True) + + # 同一个模板被多张皮肤用到 → 交付名才加 -2/-3(不同模板就保持干净名字) + cnt = {} + for _sk in skins: + for _tk in (_sk.get("tpls") or tpls): + cnt[_tk] = cnt.get(_tk, 0) + 1 + dup_tpls = set(k for k, n in cnt.items() if n > 1) + + # ---- 进度上报(金钻 2026-10-04:买家要看得见渲到哪了)---- + # 报进度**绝不能影响出图**:节流 2 秒一次,失败一律吞掉。 + def report_progress(idx, total, pct, tpl=""): + try: + http("/progress", {"oid": oid, "idx": idx, "total": total, + "pct": pct, "tpl": tpl}, timeout=20) + except Exception: + pass + + ok_n, errs = 0, [] + img_i = 0 + for si, sk in enumerate(skins): + sid = sk.get("id") or ("s%d" % (si + 1)) + # 每张皮肤各自下载、各自臂型(A 可能粗臂、B 可能细臂) + skin = os.path.join(work, "skin_%s_%s.png" % (oid, sid)) + st, data = http("/skin/%s/%s" % (oid, sid), raw=True, timeout=60) + if st != 200 or not data: + errs.append("皮肤 %s:服务器取皮肤失败 HTTP %s" % (sid, st)) + log("皮肤 %s 取不下来 HTTP %s" % (sid, st)) + continue + with open(skin, "wb") as f: + f.write(data) + arm = (sk.get("arm") or "auto") + + # 这张皮肤**只出它自己挑的模板**(没写就退回订单级那份,兼容老单) + for tk in (sk.get("tpls") or tpls): + img_i += 1 + _last = [0.0] + + def _prog(pct, _tk=tk, _i=img_i, _last=_last): + t = time.time() + if pct < 100 and t - _last[0] < 2.0: # 节流:2 秒最多报一次 + return + _last[0] = t + report_progress(_i, plan // 2, pct, _tk) + + report_progress(img_i, plan // 2, 0, tk) # 这张开始了 + try: + ok, res = render_one(tk, skin, o, order_res, arm=arm, on_progress=_prog) + except subprocess.TimeoutExpired: + ok, res = False, "渲染超时(看门狗已重开过一次仍卡住)" + except Exception as e: + ok, res = False, "异常 %r" % e + if not ok: + errs.append("%s(皮肤%d):%s" % (tk, si + 1, res)) + log("失败 %s" % res) + continue + # 一张模板交两个文件:标准压缩 + 无压缩版(金钻:两张都发顾客) + sn, un = deliver_names_for(si, tk, order_res, dedup=(tk in dup_tpls)) + files = [("标准压缩", sn, res.get("std")), + ("无压缩(16bit)", un, res.get("unc"))] + for kind, name, path in files: + if not path: + continue + try: + with open(path, "rb") as f: + png = base64.b64encode(f.read()).decode() + except OSError as e: + errs.append("%s(%s):读图失败 %r" % (tk, kind, e)) + continue + # 一次一个文件回传;total = 这一单最终会交回的文件总数 + # tries=3:图上一次上传要几 MB~十几 MB,网络抖一下很常见,别为这个白渲一遍 + st, j = http("/finish", {"oid": oid, "total": plan, + "results": [{"tpl": tk, "name": name, "png": png, + "kind": kind, "skin": sid, + # 耗时只跟「标准压缩」报一次:两个文件报两遍会把样本记重 + "sec": (res.get("sec") if kind == "标准压缩" else None), + "seq": res.get("seq")}]}, + timeout=300, tries=3, gap=8) + if st == 200 and j.get("ok"): + log("回传 %s 皮肤%s [%s](服务器已收 %s / 计划 %d)" + % (tk, sid, kind, j.get("n"), plan)) + else: + errs.append("%s-%s:回传失败 %s" % (tk, kind, (j or {}).get("error"))) + ok_n += 1 + + if ok_n == 0: + http("/fail", {"oid": oid, "note": ("全部渲染失败:" + ";".join(errs))[:280], + "diag": SKIN_DIAG[:8], "log_tail": "\n".join(errs)[-3800:]}) + log("订单 %s 全部失败" % oid) + return + # ⚠️ 有失败时必须有始有终:否则 files < total,单子会永远卡在 working, + # 45 分钟后被当成"渲染机中断"退回队列 → 无限重试。这里显式收单。 + http("/finish", {"oid": oid, "close": True, "diag": SKIN_DIAG[:8], + "note": ("部分失败:" + ";".join(errs))[:280] if errs else "", + "results": []}, tries=3, gap=8) + log("订单 %s 处理完毕:成功 %d/%d%s" % (oid, ok_n, len(tpls), "(有失败)" if errs else "")) + + +def single_instance(): + s = socket.socket() + try: + s.bind(("localhost", LOCK_PORT)) + s.listen(1) + return s + except OSError: + return None + + +def main(): + load_cfg() + once = "--once" in sys.argv # 只跑一轮就退出(手动补单 / 测试用) + if not once: + lock = single_instance() + if not lock: + log("已经有一个 worker 在跑了,这次退出") + return + log("渲染机上线 | 服务器 %s | 模板目录 %s | 留档 %s" + % (CFG["server"], CFG["tpl_root"], CFG["archive"])) + host = socket.gethostname() + # 心跳(在线检查)与领单**分开计时**: + # 心跳 = 服务器判断"渲染机还在不在"的唯一依据,也是唯一会造成误判的地方; + # 领单 = 买家体验,慢一分钟买家就多等一分钟。 + # 默认心跳 **600 秒(10 分钟)**(金钻 9-30:有人来了网页会立刻查一次,所以不用频繁上报)。 + # ⚠️ 代价:渲染机真的挂了,最长要 25 分钟才判定为离线(见服务器 OFFLINE_AFTER)。 + # 启动时会立刻发一次心跳,所以"金钻刚开机"这种情形是即时准的。 + hb_every = int(CFG.get("hb_every") or 600) # 在线检查 10 分钟一次(金钻 9-30 定) + poll = int(CFG.get("poll") or 20) + # ⚠️⚠️ 心跳必须**自己一个线程**(金钻 2026-10-01 反馈:「开着电脑还显示设备离线,刷几次才正常」)。 + # 原来心跳和领单/渲染挤在同一个循环里 —— 一渲就是几十秒到十几分钟(4096 要 10 分钟), + # 这期间心跳发不出去;要是连着几单、或某次上传卡住,超过服务器 OFFLINE_AFTER(1500 秒) + # 就被判「离线」,**电脑明明开着、还在干活**。 + def hb_loop(): + while True: + try: + st, j = http("/hb", {"host": host}, timeout=30) + if st != 200: + log("心跳失败 HTTP %s" % st) + except Exception: + log("心跳异常:\n" + traceback.format_exc()[-400:]) + time.sleep(hb_every) + threading.Thread(target=hb_loop, daemon=True).start() + while True: + try: + st, o = http("/claim", {}, timeout=60) + if st == 403: + log("令牌不对(config.json 里的 token 要跟服务器 worker_token 一致)") + time.sleep(300) + continue + if st == 200 and o.get("order"): + handle_order(o["order"]) + except Exception: + log("轮询异常:\n" + traceback.format_exc()[-800:]) + if once: + log("--once:跑完这一轮就退出") + return + time.sleep(poll) + + +if __name__ == "__main__": + main() diff --git a/backend/backend-tools/交接说明.md b/backend/backend-tools/交接说明.md new file mode 100644 index 0000000..9a4037a --- /dev/null +++ b/backend/backend-tools/交接说明.md @@ -0,0 +1,185 @@ +# 交接说明 · 工具后端(渲染机 + 本机开单工具 + 开单后台) + +> **交付方**:苏达(网站运维与技术提供) +> **收件方**:外部协作者 +> **日期**:2026-10-05 +> **一句话**:这是跑在**店主自己那台 Windows 电脑**上的一整套工具:渲染机、 +> 局域网开单后台、纯本机开单工具。请你重点看**健壮性与"静默失败"**, +> 并给我们**问题分析 + 改正意见**(见最后一节)。 + +--- + +## 一、这一份是什么 + +跟「网站后端」配套的**本地侧**。因为店里那台电脑没有公网入口,所以它**只做出站**: +主动来服务器领单、渲染、回传。 + +``` +\ + ├─ ys_worker.py 渲染机主程序(开机自启的计划任务;轮询领单 → 调 Blender → 回传) + ├─ ys_admin.py 开单后台(局域网面板:发卡密 / 激活订单 / 免费码),自带 PIN 锁 + ├─ ys_local.py 纯本机开单工具(不联网、不上传、不要卡密;拖皮肤→勾模板→出图) + ├─ local.html 本机开单工具的页面(ys_local.py 内嵌服务它) + ├─ make_order.py Blender 出图脚本(渲染机调用它;改模板/分辨率/臂型都在这) + ├─ install_worker.ps1 / chk_worker.ps1 / pack_archive.ps1 + └─ run_*.bat / stop_*.bat / open_local.bat / show_log.bat +``` + +--- + +## 二、技术栈与运行方式 + +| 项 | 值 | +|---|---| +| 语言 / 依赖 | **Python 3,纯标准库**(`ys_admin.py` 连 HTML 都内嵌在单文件里) | +| 渲染 | Blender **命令行后台模式**(`-b --factory-startup --python make_order.py`) | +| 进程托管 | Windows 计划任务(**开机自启**);面板另有独立计划任务 | +| 网络 | **只做出站**(来服务器领单/回传);本机工具与面板只监听本机/局域网 | +| 关键约束 | ⚠️ **任何时刻只允许一个 Blender 在跑** —— 同时跑两个会把机器顶满(渲染队列是硬约束,不是优化) | + +--- + +## 三、三条链路 + +### ① 渲染机(`ys_worker.py`) +``` +每 20s POST /hb(心跳) ← 心跳在**独立线程**里,不然一渲染就发不出去被判离线 + POST /claim(领单) + GET /api/skin/<单号> ← 取买家皮肤(必须带 worker token) + Blender 渲染(一张一次 POST /finish) + 中途每 2s POST /progress ← 抠 Blender 输出的百分比 +``` + +### ② 开单后台(`ys_admin.py`,局域网) +四块:① 生成卡密 ② 待激活订单(一键激活进队列)③ 最近卡密 ④ 免费码(福利券)批次管理。 +**自带 PIN 锁**:首次打开自己设 4~12 位数字,存**加盐 sha256**(不是明文),12 小时免输; +校验在服务端,直接打接口也会 401。 + +### ③ 纯本机开单(`ys_local.py` + `local.html`,只监听回环) +给**平台单**(聊天里成交的买家)用:拖皮肤 → 同一套质检 → 勾模板 → 本机 Blender 出图 → 下载。 +**不联网、不上传、不要卡密**,所以网站上根本没有入口(避免卡密被暴力试)。 + +--- + +## 四、几个刻意做出的设计(欢迎质疑) + +| 设计 | 为什么 | +|---|---| +| 渲染串行(一个队列一个消费线程) | 两个 Blender 同时跑会把机器顶满 | +| Blender 超时 600s,卡住就**连整个进程组一起杀**再重跑 | 只杀父进程的话子进程还占着管道,`communicate()` 会白等 30 秒 | +| 命名逻辑**只写两处且必须一致**(`make_order.py` 与 `ys_worker.py`) | 散落硬编码过,判过一次 bug | +| 未压缩版**不重渲**:从已渲好的渲染结果直接另存 | 省一次完整渲染(一张约 37 秒);失败再回退重渲 | +| 质检代码只有一份(前后端共用同一个 js) | 两边判定一旦漂移,会出现「网页说能渲、本机渲不出来」这种最难查的 bug | +| 部署脚本**先显式杀旧进程再起新的** | 计划任务的"运行"对已在跑的实例不替换 → 新代码静默不生效 | +| 成品不保留 `.blend` 工程 | 太大,磁盘受不住;工程渲完立刻删 | + +--- + +## 五、⚠️ 脱敏说明(**这份也不能直接跑**) + +| 类别 | 替换成 | +|---|---| +| 站点域名 / 支付平台域名 | `shop.example.com` / `pay-platform.example` | +| 端口 | 中性数字(**不是真值**) | +| 程序 / 数据 / 工作目录 | `` / `` / `` | +| Windows 盘符路径 | `` / `` / `` / `` | +| 局域网与出口 IP | `` / `` | +| 通配绑定 | `` | +| 跳板与密钥文件名 | `` / `<跳板>` | + +**保留未换的**:`localhost`、分辨率常量 `1000/1024/2048/4096`、品牌笔名。 + +**包里没有的**:真实卡密/订单/皮肤/成品、两把令牌、模板工程(**模板单独给**,见包根目录说明)、 +任何密钥凭据、私有仓库地址。 + +--- + +## 六、⚠️ 已知缺口(我们知道的,不用你重复发现) + +1. **没有内容审核** —— 结构合法的 PNG 但内容违规照样能过(技术拦不住,靠人)。 +2. **留档只增不减** —— 成品的永久留档目录会慢慢攒满盘。 +3. **预览水印是"防君子"** —— 512 宽 + 平铺水印,拦不住认真截图去水印的人。 +4. **渲染机真挂了,最长要 25 分钟才判定离线**(心跳周期 × 容错次数的代价)。 + +--- + +## 七、⭐ 我们要你交给我们的东西(**这一份的主要目的**) + +同样请回一份 `回执-<你的名字>.md`,含三部分: + +1. **问题分析** —— 你看到的 bug、健壮性问题、坏味道。**特别欢迎**指这几类: + - **静默失败**:出错了但看着"一切正常"的地方(我们被这个坑过好几次) + - **状态不一致**:显示与真实不一致(比如界面说排队中、实际没领单) + - **部署/重启类**:改了不生效、旧进程没替换、两边版本漂移 + - **并发/时序**:心跳与渲染抢资源、超时与重试互相打架 +2. **改正意见** —— 每条说清**怎么改 + 代价**。 +3. **你改了什么** —— 逐条列(同网站后端那份的格式): + ``` + 文件 / 函数: 为什么改: 改成什么: + ⚠️ 有没有动接口路径 / 请求响应字段 / 数据格式(动了必须单独标): + 怎么验证的: + ``` + +**另外请你顺手回答两个具体问题**: +- `ys_worker.py` 的**部署不生效**(旧进程还在跑)这类问题,除了"先杀再起",有没有更稳的办法? +- 渲染队列现在是**单线程串行**。如果要在一台机器上同时支持多单, + 你觉得该怎么做才**不会把机器顶满**?(先说方案,不用实现) + +--- + +## 八、我们的思路与方法(**请你连这套做法一起评**) + +代码能看出一部分;**为什么这么做、踩过什么坑**,代码里看不到。这一节补上, +**希望你连"做法"本身一起挑** —— 整套思路要是错的,比某个函数写错更要紧。 + +### 8.1 我们给自己定的硬规矩 + +| 规矩 | 为什么 | +|---|---| +| **机器只做出站**:店里那台没有公网入口,所以服务器从不连它,全靠它自己定时来拉 | 不给家用网络开任何入站口子;代价是"渲染机真挂了,最长要过一会儿才判离线" | +| **任何时刻只允许一个渲染在跑** | 两个同时跑会把机器顶满 —— 这是**硬约束不是优化**,所以做成 FIFO 队列 | +| **渲染串行、队列单消费者** | 同上;宁可让买家多等,也不让机器崩 | +| **命名/路径这类"两边都要知道"的规则只写两处且必须一致** | 散落硬编码过一次,修的时候漏了地方 | +| **质检逻辑只有一份,前后端共用** | 两边判定一旦漂移,会出现"网页说能渲、本机渲不出来"这种最难查的 bug | +| **不保留巨大的中间产物** | 工程文件渲完立刻删(磁盘受不住);需要保留的从已渲结果直接另存,不重渲一遍 | + +### 8.2 我们干活的方法(改这套工具时照着来) + +1. **长驻进程必须交给任务计划/系统托管**,不能用"临时起一个"。 + 踩过:从远程会话里起的进程,**会话一断就被系统回收** —— 装完看着"已运行", + 几十秒后就没了,订单干等在队列里没人领。表现是"看起来一切正常"。 +2. **部署 = 先明确杀掉旧进程,再起新的**。多数"重启/运行"命令对**已在运行的实例不会替换**, + 于是新代码静默不生效。部署后必须核对**进程的启动时间**,光看"在线"没用(旧进程也报在线)。 +3. **判断"活没活"要看真实产物**,不看脚本自述。`Set-Content` 类写入要回读、看字节数; + 端口要真连一次;图要真存在。 +4. **卡死要连整个进程组一起杀**。只杀父进程的话子进程还占着输出管道,读取方会白等很久 + (实测:只杀父 → 64 秒才返回;连组杀 → 4 秒)。 +5. **进度要自己吐日志,并且按 `\r` 和 `\n` 都切**。渲染器的进度条是**原地回车刷新**的, + 按 `\n` 逐行读会**一条都读不到**(看着像"没有进度",其实进度一直在刷)。 +6. **每台机器的配置里不放凭据**,凭据由部署流程单独推(密钥与规则分离)。 +7. **中文不要进 `.bat`**,中文一律放带 BOM 的 `.ps1` 里;编码错了会**连累后面的行**一起崩。 + +### 8.3 我们付过学费的坑("不要重复踩"清单) + +- **"改完不生效"是这套系统最高频的坑**,而且从不报错:旧进程在跑、计划任务不替换、 + 两边版本漂移 —— 三种都会表现成"功能没反应"。 +- **静默半死**:某一步抛异常 → 后面的渲染链全断 → 页面看着"就是没反应", + 只有开发者控制台才有线索。所以我们加了"出错要能看到原因"的要求。 +- **从 A 推导出 B 的函数,在别处读 B 之前必须先调一次**(同一个形状我们踩了两次)。 +- **同名文件被覆盖 + 地址不变 = 用户以为没更新**(缓存/同名双杀)。 + +### 8.4 我们最想要你评的三件"做法" + +1. **部署不生效**这类问题,除了"先杀再起",**有没有更稳的机制**? +2. **单机多单**:现在是严格串行。如果要在同一台机器上支持多单,你会怎么设计才**不会把机器顶满**? +3. **"纯标准库单文件"**这套(零依赖零安装、小机器跑得动)换你你会不会换技术栈?请直说。 + +--- + +## 九、边界 + +- **私有交付,请勿外传 / 勿公开 / 勿镜像**。 +- 占位值保持原样,**不要**替换成真实地址再交回来。 +- 你可以自由重构,但**动了接口/数据格式要按第 7 节单独标出来** —— + 这套工具跟服务器那份代码是**两台机器上各一份**,不同步会静默坏掉。 +- 有看不懂的先问再改,别猜。 diff --git a/backend/deploy/nginx-片段.md b/backend/deploy/nginx-片段.md new file mode 100644 index 0000000..c49d41b --- /dev/null +++ b/backend/deploy/nginx-片段.md @@ -0,0 +1,100 @@ +# 部署层 · 反向代理片段(脱敏版) + +> 后端**只绑本机回环**,对外全部由 nginx 反代。这一份是跟 `/order/` 相关的路由与限流, +> 给你看**路由是怎么接的、限额是怎么设的**。值已按脱敏规则替换,**照形状看,别照字面抄**。 + +--- + +## 一、限流区(定义在 nginx 的 http 层) + +```nginx +# 下单相关:一般接口 90 次/分钟,提交接口单独收紧到 10 次/分钟 +limit_req_zone $binary_remote_addr zone=:1m rate=90r/m; +limit_req_zone $binary_remote_addr zone=:1m rate=10r/m; +``` + +**为什么给提交接口单独一条**:它是唯一会**收上传**的入口,也是最值得刷的入口。 +别的接口刷快一点无所谓(就是查状态),提交接口必须压住。 + +--- + +## 二、`/order/api/` 的路由 + +```nginx +# ① 提交接口:单独限流 + 单独放宽请求体 +location = /order/api/submit { + limit_req zone= burst=5 nodelay; + limit_req_status 429; + client_max_body_size 4m; # 皮肤是 base64 进来的 + proxy_pass http://localhost:/api/submit; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; # 后端要拿它做「单 IP 限单」 + proxy_read_timeout 120s; + add_header Cache-Control "no-store" always; +} + +# ② 回传接口:**单独一条**,因为成品一张 1~3MB(base64 后更大) +# ⚠️ nginx 的 `location =` 精确匹配**优先于**前缀匹配 —— +# 想只给这一个路径放宽体积,不能靠下面那条前缀规则 +location = /order/api/finish { + limit_req zone= burst=40 nodelay; + limit_req_status 429; + client_max_body_size 16m; + proxy_pass http://localhost:/api/finish; + # ... +} + +# ③ 其余接口 +location /order/api/ { + limit_req zone= burst=40 nodelay; + limit_req_status 429; + proxy_pass http://localhost:/api/; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + # ... +} +``` + +⚠️ **打包下载(zip)那条要另外配**:`proxy_buffering off` + 更长的 `proxy_read_timeout`, +因为它是**先落临时文件再边读边发**的,不能在 nginx 这层再缓存一份(小机器内存受不住)。 + +--- + +## 三、买家那边的路由(订单链接) + +```nginx +location ~ "^/order/[A-Za-z0-9]{6,16}$" { + try_files /order/index.html =404; + add_header Cache-Control "no-store" always; + add_header X-Robots-Tag "noindex, nofollow, noarchive" always; +} + +# 兜底:/order/ 下面找不到的路径一律给下单页,**绝不给 404** +location /order/ { + try_files $uri $uri/ /order/index.html; + add_header Cache-Control "no-store" always; + add_header X-Robots-Tag "noindex, nofollow, noarchive" always; +} +``` + +**这两条的用意,请你连做法一起评**: + +1. **`^/order/<6~16位>` 这条必须有**。买家拿到的是 `/order/<订单号>?t=<取件码>`, + 没有这条路由会掉到主站规则**直接 404** —— 而买家一关页面就**再也找不回订单**。 + (页面文案还写着"请记下订单号用于查询下载",那就成了骗人。) +2. **兜底那条绝不能返回 404**。买家从聊天软件复制链接**常夹进不可见字符** + (实测踩到:路径里多了个零宽空格 → 404),看着就像**网站坏了**。 + 给下单页最差只是"没找到那一单",页面自己会提示。 +3. **正则里的 `{6,16}` 必须用引号包住**,否则 nginx 会把花括号当配置块起始, + 报 `unknown directive`(实测踩到)。 +4. **`no-store` + `noindex`**:订单页带取件码,不该被缓存也不该被搜索引擎收录 + (一是降曝光,二是链接本身就是凭证)。 + +--- + +## 四、这一层我们没做的事(也算"做法",欢迎质疑) + +- **没上 WAF / 没有额外防护层**:这台机器很小,装不下重的东西; + 防护全在后端自己的限流 + 两把令牌 + 来源 IP 门上。 +- **没做多机/负载均衡**:单机单进程,够用。 +- **HTTPS 用自动签发的证书**,续期自动化,没有额外动作。 diff --git a/backend/交付清单.md b/backend/交付清单.md new file mode 100644 index 0000000..df4ff46 --- /dev/null +++ b/backend/交付清单.md @@ -0,0 +1,37 @@ +# 交付清单(自查用) + +> 生成:2026-10-05 18:52 共 29 个文件 合计 44.7 MB + +| 文件 | 字节 | SHA-256 | +|---|---|---| +| `README.md` | 7,532 | `e551e8da39ec955f6d2a25fdd724e2949dffccb6de83d0121df62a8944e909bc` | +| `backend-site/admin.py` | 24,214 | `3b9818c063e4c7297d3052cad4ff2a88941b4d07b85e2e5eaf495eed35d3f484` | +| `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` | +| `backend-site/server.py` | 160,560 | `9470b057f9eaf1927d06917ac5909fb0e733a4b44a04c039b82bbd907b9f2a62` | +| `backend-site/交接说明.md` | 14,711 | `6b98b87c0f061760ec73e78036cf563b1c27fc8dead2324685b7218b61c9be72` | +| `backend-tools/chk_worker.ps1` | 486 | `939a42cafa0954347f28d69e75b8af407ed1dab870cc3956fa8b7c5eb55e372f` | +| `backend-tools/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` | +| `backend-tools/install_worker.ps1` | 8,902 | `95c339f2a69359fd1c980fb649217bb18371d9ba0b06eadce049b58537c11c1e` | +| `backend-tools/local.html` | 23,026 | `c02fe7ed5bf39f329120c1ce6a01dcd2db675a37061fd5d57d8519dffc818a97` | +| `backend-tools/make_order.py` | 28,388 | `e8e2ebb473501a0b914b9c2941d9e8505e9b92f0880190cf7f588d5fe27f233e` | +| `backend-tools/open_local.bat` | 81 | `cf91a0f9bbf18db6b082874131aacb8bc04924bf68d355481a9445b26c46ab30` | +| `backend-tools/pack_archive.bat` | 86 | `e2c6683d0b353ae8f68d9f9c0430c486aa733c57c6d2f4e7802bdd5e53783c00` | +| `backend-tools/pack_archive.ps1` | 2,467 | `9fa2956e1d3718876fea3ad2b5576fab94087a0b73d00f43c5b443c821e1c06a` | +| `backend-tools/run_admin.bat` | 417 | `49bab3f66e3f1419f2aab4e8d1835a5bc2f64395d6575605ec000d78c635c1c2` | +| `backend-tools/run_panel.bat` | 911 | `c34eb6fb6d4808026c5432727de59e726632eadf2da49ee581477938c0194b0a` | +| `backend-tools/run_worker.bat` | 176 | `3148827f6bd6967a9fb93f0ec9ba98e85cf8a26ac5160a6e6bab6369b2a3792a` | +| `backend-tools/show_log.bat` | 422 | `fde479d7e8383863a3054b44d267d568a7c9c48df98a59175e03810e51156202` | +| `backend-tools/skincheck.js` | 13,011 | `dc9c65ac8b8551aaa42ca7399517bb1d6c28956c4c80997132f16862e1239b8d` | +| `backend-tools/stop_admin.bat` | 281 | `9b38682234f2e07b58c478c939f4f1d58cefe9624b13d0af2656d5522fd5509d` | +| `backend-tools/stop_worker.bat` | 332 | `f7c8ab10d1d03d7a75c2fcb3343bec0c6d52409ef5cc6dd68c0f9e342e0077b4` | +| `backend-tools/ys_admin.py` | 58,367 | `05878039c3728fc119c75ad76f216298d6c82e6cc19b79024090a89d8cc7fc84` | +| `backend-tools/ys_local.py` | 17,021 | `27948a19f45aa984e0f9ffc88b6cd85bbe127e8f4ceff272fd189a49524fec1f` | +| `backend-tools/ys_worker.py` | 30,465 | `ab6cdff13ce16ed15363c28cf016628b378a1ec255d2b8eeb62566cf38631eb9` | +| `backend-tools/交接说明.md` | 11,008 | `731c591b545c4332c3ad5336910a78e5dfb8b6541da6f33e8f4e70bb3b7dab48` | +| `deploy/nginx-片段.md` | 4,145 | `183179dc694e1f2ac3a791f3c96aa6f7d292b1968276ae1af4d850e26fbf78d0` | +| `模板/1站立正反.blend` | 16,486,783 | `985dc61aeaa6eaaf5dc87ccbba6dfd4e1c5eb95468f7d0a9610d47aff14cb9dc` | +| `模板/4海边自拍.blend` | 18,101,431 | `629df363d00e73e18820bddb6b7b92d7dbdd55d0f5c98de5378c76a48b705183` | +| `模板/5不看爆炸.blend` | 11,849,599 | `3bb67516632e206c89fe44e2cf04667f5e34e1eab70e395c00830555e033e223` | +| `模板/说明.md` | 2,775 | `491fa0587a9ff662a8e8893d0657eb412d87af8161de19abeba993e5a8ff4675` | + +> 用途:对方收到后可以逐文件核哈希,确认传输没损坏 / 没被改动。 \ No newline at end of file diff --git a/backend/模板/1站立正反.blend b/backend/模板/1站立正反.blend new file mode 100644 index 0000000..425d096 Binary files /dev/null and b/backend/模板/1站立正反.blend differ diff --git a/backend/模板/4海边自拍.blend b/backend/模板/4海边自拍.blend new file mode 100644 index 0000000..ca5bf61 Binary files /dev/null and b/backend/模板/4海边自拍.blend differ diff --git a/backend/模板/5不看爆炸.blend b/backend/模板/5不看爆炸.blend new file mode 100644 index 0000000..ebe8ed4 Binary files /dev/null and b/backend/模板/5不看爆炸.blend differ diff --git a/backend/模板/说明.md b/backend/模板/说明.md new file mode 100644 index 0000000..98f128f --- /dev/null +++ b/backend/模板/说明.md @@ -0,0 +1,50 @@ +# 三个 Blender 模板工程(给你跑测试用) + +> 渲染 = **模板工程** + 买家的皮肤贴图。要真跑一遍看效果,你需要模板, +> 所以店主挑了三个给你。**名字前面的数字就是模板编号**,代码里的 `TEMPLATES` 表靠它对应。 + +| 文件 | 编号 | 为什么给你这个 | +|---|---|---| +| `1站立正反.blend` | 1 | **最基础**:站立、正反两面。**先用它把链路跑通** | +| `4海边自拍.blend` | 4 | **场景类的**(带环境),测"场景重"的情况 | +| `5不看爆炸.blend` | 5 | **另一个场景**(爆炸/动感类),测"跟站立那个不一样的行为" | + +**渲染环境**:Blender **4.x**,命令行后台模式: +``` +blender -b --factory-startup --python make_order.py -- --skin <皮肤.png> --num <序号> --out <输出目录> --res 1000 +``` +完整参数看 `backend-tools/make_order.py` 顶部的用法说明。 + +--- + +## ⚠️ 这三个文件也**脱敏过**,说明一下动了什么 + +Blender 会把**绝对路径**写进工程文件里,所以直接给会把店主的机器信息一起带出去。 +我们做了**等长替换**(`.blend` 靠长度前缀存字符串,**长度一变文件就废**, +所以只能等长换,不能删不能加): + +| 原本 | 换成 | 处数 | 说明 | +|---|---|---|---| +| `C:\Users\<账户名>` | `C:\Users\user0` | 1 / 6983 / 0 | 抹掉 Windows 账户名 | +| `<盘符>:\<习惯用的工程目录>` | `<盘符>:\assets0` | 136 / 14 / 12 | 抹掉习惯用的工程盘路径 | + +(`4海边自拍` 那个数字大,是因为它引用了一批 Blender 插件的资源清单,每一条都带完整路径。) + +**已核对**: +- 替换后**文件字节数一个没变**(`1站立正反` 16,486,783 / `4海边自拍` 18,101,431 / `5不看爆炸` 11,849,599)—— 结构没被破坏 +- 里面**没有**中文目录名的长路径(也就是说不会泄露工程目录的命名) +- 里面**没有**邮箱、域名、密钥 + +**请你帮我们确认一件事**:这三个工程在你那边**能正常打开并且能渲出图**吗? +(我们改的是路径字符串,理论上不影响渲染,但只有你真跑一遍才算数 —— +如果打不开或渲出来是灰的,说明我们动坏了,请立刻告诉我们,我们给没动过的版本。) + +--- + +## 用它们做什么 + +1. **跑通**:用 `1站立正反` 走一遍完整链路(皮肤 → 渲染 → 出图,标准压缩 + 无压缩两张)。 +2. **测场景**:用 `4海边自拍` 看有没有跟 `1站立正反` 不一样的行为。 +3. **测场景差异**:用 `5不看爆炸`(动感场景),看有没有跟 `1站立正反` 不一样的行为。 + +跑的过程中如果发现**代码**的问题,按那份交接文档最后两节的要求写回执就行。