- 没验证过的爱发电回调不再写进账本 pay_orders,只进 50 条封顶的待核对清单;回调日志只记关键头 + 正文 4KB、5MB 轮转(测试 +2) - 福利券领取令牌定长比较;ys_admin.py 转义补上引号;星门格子提示转义;首页价格改读公开接口 - nginx 片段:安全头(HSTS/nosniff/XFO/Referrer/Permissions/CSP)、挡备份 / 预览稿 / 隐藏文件 / 原始内容 json、回调单独限流、server_tokens off - 交接文档 2.9 安全加固 + 维护页挂法更新 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
交付包 · 卡密 / 自助渲染下单(后端 + 工具)
交付方:苏达(网站运维与技术提供) 收件方:外部协作者 日期:2026-10-05 本次交付由店主拍板,范围就是他圈定的:网站后端 + 工具后端,全部脱敏,各配交接文档。
怎么读这份包(建议顺序)
2026-10 这一轮(数据库、开单后台 / 本机开单重写、前端星系图)的总说明在仓库根目录
交接文档-2026-10.md。
| 顺序 | 读什么 | 为什么先读它 |
|---|---|---|
| 1 | 他应该知道的.md |
生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— 不读这个,代码里很多东西推不出来 |
| 2 | 本文件 | 包里有什么、三条纪律、我们要你回什么 |
| 3 | backend-site/交接说明.md 或 backend-tools/交接说明.md |
各含一节**《我们的思路与方法》**(比代码更值得看:坑都是"不报错但坏掉"那一类) |
| 4 | 代码 | 到这儿再进代码 |
| 5 | 回执模板.md |
写回执时照它填,不用另起格式 |
包里有什么(按店主划的交付范围)
| 店主说的 | 落在哪 | 里面是什么 | 交接文档 |
|---|---|---|---|
| 网页后端 / 自助后端 | backend-site/ |
网站服务端全部逻辑:下单、卡密生命周期、队列、支付回调、打包下载、小票 + 管理 CLI + PNG 结构核验 | backend-site/交接说明.md |
| 本地的自助管理后台 | backend-tools/ |
局域网开单后台(带 PIN 锁)+ 纯本机开单工具 + 渲染机 + Blender 出图脚本 + 部署/启动脚本 | backend-tools/交接说明.md |
| 用于测试的工程 | 模板/ |
三个 Blender 模板工程(已脱敏,可直接打开渲染) | 模板/说明.md |
| 其他需要的 | deploy/ |
反向代理的路由与限流片段(部署层)+ 这一层的取舍说明 | deploy/nginx-片段.md |
| 背景须知 | 他应该知道的.md |
生意背景 / 机器约束 / 数据边界 / 术语表 / 我们这边的纪律 | — |
| 回执模板 | 回执模板.md |
直接照着填:问题分析 / 改正意见 / 你改了什么 + 我们拿不准的问题 + 运维个人想知道的 | — |
⭐ 我们要你回的东西(这次交付的主要目的)
请你读完代码后,各回一份回执(就放在对应目录下,文件名 回执-<你的名字>.md),
每份包含三段:
- 问题分析 —— 你看到的问题/风险/坏味道,分轻重(会丢钱/丢数据/能被人打的排前面), 尽量指到具体函数或行,并说清什么条件下会踩到。
- 改正意见 —— 每条给出你建议的改法,以及代价(改起来多大、会不会影响别处)。
- 你改了什么 —— 如果你直接动手改了,逐条列:
文件 / 函数: 为什么改: 改成什么(一句话): ⚠️ 有没有动接口路径 / 请求响应字段 / 数据格式: ← 这三样动了我们必须知道 你怎么验证的:
两份交接文档里各有两个我们自己拿不准的具体问题,也请顺手回答一下。
"你改了什么"为什么单独要一段:这套系统是两台机器上各跑一份代码 (服务器一份、店里电脑一份),两边靠接口对齐。你只改了其中一份、 或者改了字段名却没标出来,我们这边会静默出不来图 —— 不报错、就是没图, 这种最难查。所以请务必标清楚。
⚠️ 三条纪律
- 私有交付:请勿外传、勿公开、勿镜像(含截图和片段)。 里面的占位值(域名、端口、路径、IP)请保持原样,不要替换成任何真实地址。
- 不要为了"跑起来"去补真实凭据:这份代码设计上就跑不起来(见下),
我们是给你读的,不是给你部署的。要看运行效果用
模板/那三个工程。 - 有看不懂的先问再改,别猜 —— 猜错的表现是"静默失效",不报错。
关于"跑不起来"这件事(不是疏漏,是刻意的)
出站纪律要求:任何离开我们机器的代码,先脱敏。所以:
- 站点/支付平台的域名 →
example.com系列(RFC 2606 保留域,永远不会指向真站) - 端口 → 中性数字(不是真端口)
- 目录、盘符路径 →
<DATA_DIR>/<WORKER_DIR>/<WIN-PATH>这类占位 - 家里出口 IP、局域网 IP →
<LOCAL-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 在接口层根本测不出来); 部署完要核对"跑的是不是新代码"。
- 付过学费的坑 —— 例:静默失败最贵(不报错、不崩、就是没效果); 显示层会骗人(订单算对了但界面从另一个来源取数);"改完不生效"是这套系统最高频的坑。
每份最后还有**三个我们拿不准的"做法"**请你表态(要不要换技术栈、单机多单怎么设计、 部署不生效有没有更稳的机制)。
我们更想要的是对做法的批评,不只是对某几行代码的。如果整套思路就是错的,请直说。
交付清单(自查用)
- 网站后端:
server.py/admin.py/pngcheck.py/store.py(数据库,2026-10-05 加),已脱敏 - 工具后端:19 个文件(含
.bat/.ps1/.html/ 共用的skincheck.js/ Blender 脚本),已脱敏 - 两份交接文档(含《我们的思路与方法》)
- 三个模板工程,已脱敏(等长替换,文件字节数未变)
- 逐文件 SHA-256 清单(
交付清单.md) - 机器逐类扫描:0 命中(域名含大小写变体 / 端口 / 各类路径 / IP / 邮箱 / 密钥特征 / 分享链里夹的群号与授权参数 / 第三方人名 / 长数字串)
- 独立第二双眼睛复查(由另一个 agent 独立扫、不采信我们的自述结论)
—— 它抓出了 3 处我们漏的(Windows 账户名从路径与 SSH 用户名两处漏出、
一处换过但仍像真路径的
/srv、一处把真端口换成了另一个像真端口的数) 以及 2 处"引用了却没带上"的缺件(共用的质检脚本、打包脚本),全部已修并复扫 0 命中。 - 故意没带的(不是漏):运行期的数据文件(卡密池、订单、皮肤、成品、心跳、 价格表、凭据文件等)—— 那些是真实经营数据,不在交付范围里。