Files
ywsandClaude Opus 5.5 09b229deee portal: 金钻宇宙换成星系图(three.js 懒加载)+ 推送前审查 + 总交接文档
- 门户「金钻宇宙」:删掉启动仪式 / 宇宙首屏晶体 / 盘符机架 / 读盘舱及其 CSS、图标;
  换成星系图(portal/assets/universe/,three.js r170 自托管于 assets/vendor/,第一次打开板块才下载)
  + 窗下世界线卡片;#0001 深链飞到对应世界线;世界线数据只留 config.js 一份
- 像素字子集重做(旧字全保留 + 新字);其余板块与改动前逐像素一致
- 后端审查:add_call 写库失败不再打断渲染机回传;多进程同时首启只导入一次(+1 条测试,共 38);
  撤销「处理过了」清掉 handled_at
- 交接文档-2026-10.md:变更清单 / 功能增删 / 接口与数据格式变更 / 设计规范 / 业务逻辑 / 部署运维
- 交付清单哈希重算;README、旧交接说明指路

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 17:31:36 +00:00

142 lines
8.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 交付包 · 卡密 / 自助渲染下单(后端 + 工具)
> **交付方**:苏达(网站运维与技术提供)
> **收件方**:外部协作者
> **日期**: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`),
每份包含三段:
1. **问题分析** —— 你看到的问题/风险/坏味道,**分轻重**(会丢钱/丢数据/能被人打的排前面),
尽量**指到具体函数或行**,并说清**什么条件下会踩到**。
2. **改正意见** —— 每条给出你建议的改法,以及**代价**(改起来多大、会不会影响别处)。
3. **你改了什么** —— 如果你直接动手改了,逐条列:
```
文件 / 函数: 为什么改: 改成什么(一句话):
⚠️ 有没有动接口路径 / 请求响应字段 / 数据格式: ← 这三样动了我们必须知道
你怎么验证的:
```
> 两份交接文档里各有两个**我们自己拿不准的具体问题**,也请顺手回答一下。
**"你改了什么"为什么单独要一段**:这套系统是**两台机器上各跑一份代码**
(服务器一份、店里电脑一份),两边靠接口对齐。你只改了其中一份、
或者改了字段名却没标出来,我们这边会**静默出不来图** —— 不报错、就是没图,
这种最难查。所以请务必标清楚。
---
## ⚠️ 三条纪律
1. **私有交付**:请勿外传、勿公开、勿镜像(含截图和片段)。
里面的**占位值**(域名、端口、路径、IP)请**保持原样**,不要替换成任何真实地址。
2. **不要为了"跑起来"去补真实凭据**:这份代码**设计上就跑不起来**(见下),
我们是给你**读**的,不是给你部署的。要看运行效果用 `模板/` 那三个工程。
3. **有看不懂的先问再改**,别猜 —— 猜错的表现是"静默失效",不报错。
---
## 关于"跑不起来"这件事(不是疏漏,是刻意的)
出站纪律要求:**任何离开我们机器的代码,先脱敏**。所以:
- 站点/支付平台的**域名** → `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 在接口层根本测不出来);
部署完要核对"跑的是不是新代码"。
- **付过学费的坑** —— 例:静默失败最贵(不报错、不崩、就是没效果);
显示层会骗人(订单算对了但界面从另一个来源取数);"改完不生效"是这套系统最高频的坑。
每份最后还有**三个我们拿不准的"做法"**请你表态(要不要换技术栈、单机多单怎么设计、
部署不生效有没有更稳的机制)。
> 我们更想要的是**对做法的批评**,不只是对某几行代码的。如果整套思路就是错的,请直说。
---
## 交付清单(自查用)
- [x] 网站后端:`server.py` / `admin.py` / `pngcheck.py` / `store.py`(数据库,2026-10-05 加),已脱敏
- [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 命中。
- [ ] **故意没带的**(不是漏):运行期的数据文件(卡密池、订单、皮肤、成品、心跳、
价格表、凭据文件等)—— 那些是**真实经营数据**,不在交付范围里。