Compare commits

...
3 Commits
Author SHA1 Message Date
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
ywsandClaude Opus 5.5 3ae940d828 backend-tools: 本机开单页面重写(跟网站 / 后台同一套样子,补分辨率样式、清空、整页拖拽)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 16:31:58 +00:00
ywsandClaude Opus 5.5 51212a07c0 backend: 接入 SQLite 数据库 + 开单后台按功能重写
- store.py(新):卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态进 <DATA_DIR>/ys.db;
  第一次启动自动建库并导入旧 JSON(旧文件不动),admin.py db check/backup/export
- server.py / admin.py 存取换到库上,路由与接口字段不变;calls.jsonl 照旧追加
- 管理接口新增 calls / call-done / retry,codes 支持 q 搜索
- ys_admin.py 页面重写:待处理 / 订单 / 卡密 / 福利券 / 呼叫·反馈 / 开单工具
- tests/数据库测试.py(37 条,假数据);回归 27 条照旧全过
- 交接说明(数据库一节、面板一节)、回执第二轮、交付清单更新

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 16:20:45 +00:00
24 changed files with 3513 additions and 2367 deletions
+2
View File
@@ -11,6 +11,8 @@
| `portal/` `order/` | 门户与下单页(前端) | 上一批(视觉重设计) | | `portal/` `order/` | 门户与下单页(前端) | 上一批(视觉重设计) |
| **`backend/`** | **网站后端 + 本地自助管理后台 + 测试用 Blender 工程 + 部署层片段** | **本批** | | **`backend/`** | **网站后端 + 本地自助管理后台 + 测试用 Blender 工程 + 部署层片段** | **本批** |
> **总交接文档:`交接文档-2026-10.md`**(2026-10 这一轮前后端所有改动 / 功能增删 / 设计规范 / 业务逻辑 / 部署运维)。
>
> 看后端请从 **`backend/他应该知道的.md`** 开始读(生意背景 / 机器约束 / 数据边界 / 术语表), > 看后端请从 **`backend/他应该知道的.md`** 开始读(生意背景 / 机器约束 / 数据边界 / 术语表),
> 再进 `backend/README.md` 和两份交接说明。 > 再进 `backend/README.md` 和两份交接说明。
> 写回执照 **`backend/回执模板.md`** 填。 > 写回执照 **`backend/回执模板.md`** 填。
+3 -1
View File
@@ -9,6 +9,8 @@
## 怎么读这份包(建议顺序) ## 怎么读这份包(建议顺序)
> 2026-10 这一轮(数据库、开单后台 / 本机开单重写、前端星系图)的总说明在仓库根目录 **`交接文档-2026-10.md`**。
| 顺序 | 读什么 | 为什么先读它 | | 顺序 | 读什么 | 为什么先读它 |
|---|---|---| |---|---|---|
| 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** | | 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** |
@@ -124,7 +126,7 @@ Windows 下用 `pythonw.exe` 起。具体参数看 `backend-tools/make_order.py`
## 交付清单(自查用) ## 交付清单(自查用)
- [x] 网站后端:`server.py` / `admin.py` / `pngcheck.py`,已脱敏 - [x] 网站后端:`server.py` / `admin.py` / `pngcheck.py` / `store.py`(数据库,2026-10-05 加),已脱敏
- [x] 工具后端:19 个文件(含 `.bat` / `.ps1` / `.html` / 共用的 `skincheck.js` / Blender 脚本),已脱敏 - [x] 工具后端:19 个文件(含 `.bat` / `.ps1` / `.html` / 共用的 `skincheck.js` / Blender 脚本),已脱敏
- [x] 两份交接文档(含《我们的思路与方法》) - [x] 两份交接文档(含《我们的思路与方法》)
- [x] 三个模板工程,已脱敏(等长替换,文件字节数未变) - [x] 三个模板工程,已脱敏(等长替换,文件字节数未变)
+30 -11
View File
@@ -14,6 +14,7 @@
python3 admin.py calls 看「呼叫金钻」记录 python3 admin.py calls 看「呼叫金钻」记录
python3 admin.py sweep 清理超过保留期的成品 python3 admin.py sweep 清理超过保留期的成品
python3 admin.py stat 概览 python3 admin.py stat 概览
python3 admin.py db [check|backup|export [目录]] 数据库:体检 / 热备份 / 导回旧版 JSON
python3 admin.py audit [行数] 看兑换码失败/被拒记录 python3 admin.py audit [行数] 看兑换码失败/被拒记录
""" """
import csv, json, os, shutil, sys, time import csv, json, os, shutil, sys, time
@@ -267,15 +268,33 @@ def cmd_retry(argv):
print("%s 已退回队列" % oid) print("%s 已退回队列" % oid)
def cmd_db(argv):
"""数据库(<DATA_DIR>/ys.db,2026-10-05 起)。服务器不用停。"""
sub = (argv or ["check"])[0]
if sub == "check":
ok, n, imp = S.STORE.check()
print("库文件:%s" % S.STORE.path)
print("完整性:%s" % ok)
for k, v in n.items():
print(" %-10s %d 行" % (k, v))
print("订单(按状态):%s" % (S.STORE.order_counts() or "无"))
print("卡密(按状态):%s" % (S.STORE.code_counts() or "无"))
print("旧数据导入:%s" % (imp or "(没导过)"))
elif sub == "backup":
print("备份好了:%s" % S.STORE.backup())
elif sub == "export":
print("已导出到 %s" % S.STORE.export_legacy(argv[1] if len(argv) > 1 else None))
else:
print("用法:admin.py db [check|backup|export [目录]]")
def cmd_calls(argv): def cmd_calls(argv):
try: rows = S.STORE.calls() # 数据库 calls 表(2026-10-05 起;calls.jsonl 只是给手机通知的副本)
for line in open(S.CALLS_FILE, encoding="utf-8"): if not rows:
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("(没有呼叫记录)") print("(没有呼叫记录)")
for r in rows:
print("%s 订单=%s IP=%s %s %s" % (r.get("ts"), r.get("order") or "-", r.get("ip"),
"已通知" if r.get("notified") else "未通知", r.get("kind") or "呼叫"))
def cmd_sweep(argv): def cmd_sweep(argv):
@@ -285,8 +304,8 @@ def cmd_sweep(argv):
⚠️ 删文件之前先把卡密核销 —— 否则文件没了、码还挂在「已激活」,账永远对不上。 ⚠️ 删文件之前先把卡密核销 —— 否则文件没了、码还挂在「已激活」,账永远对不上。
""" """
n = freed = settled = 0 n = freed = settled = 0
for oid in list(os.listdir(S.ORDERS)): for oid in S.STORE.order_ids():
d = os.path.join(S.ORDERS, oid) d = S.order_dir(oid)
m = S.read_meta(oid) m = S.read_meta(oid)
if not m: if not m:
continue continue
@@ -306,7 +325,7 @@ def cmd_sweep(argv):
freed += os.path.getsize(os.path.join(root, f)) freed += os.path.getsize(os.path.join(root, f))
except OSError: except OSError:
pass pass
shutil.rmtree(d, ignore_errors=True) S.purge_order(oid) # 删文件;库里那一行留着记账(之后当它不存在)
n += 1 n += 1
# 文件还在、但开放下载已满 72 小时的,也一起核销 # 文件还在、但开放下载已满 72 小时的,也一起核销
settled += sum(x[1] for x in S.settle_due()) settled += sum(x[1] for x in S.settle_due())
@@ -534,7 +553,7 @@ def cmd_gift(argv):
CMDS = {"gen": cmd_gen, "codes": cmd_codes, "ls": cmd_ls, "show": cmd_show, CMDS = {"gen": cmd_gen, "codes": cmd_codes, "ls": cmd_ls, "show": cmd_show,
"gift": cmd_gift, "gift": cmd_gift,
"price": cmd_price, "price": cmd_price,
"retry": cmd_retry, "calls": cmd_calls, "sweep": cmd_sweep, "stat": cmd_stat, "retry": cmd_retry, "calls": cmd_calls, "db": cmd_db, "sweep": cmd_sweep, "stat": cmd_stat,
"audit": cmd_audit, "activate": cmd_activate, "pending": cmd_pending, "audit": cmd_audit, "activate": cmd_activate, "pending": cmd_pending,
"edit": cmd_edit} "edit": cmd_edit}
+150 -92
View File
@@ -5,7 +5,8 @@
设计要点 设计要点
* 纯标准库(http.server),零依赖、内存小 —— 这台机器只有 1.6G 内存 * 纯标准库(http.server),零依赖、内存小 —— 这台机器只有 1.6G 内存
* 队列就是文件系统:orders/<订单号>/meta.json 里 state 字段 = 状态 * 数据在 SQLite(<DATA_DIR>/ys.db,见 store.py):卡密 / 订单 / 爱发电账本 / 呼叫记录 / 小块状态;
订单的 state 字段 = 队列状态。皮肤和成品**文件**还在 orders/<订单号>/ 目录里
* 渲染机主动出站拉单(宿主只能出站),服务器不主动连宿主 * 渲染机主动出站拉单(宿主只能出站),服务器不主动连宿主
* 管理操作全走本地 CLI(admin.py),**不开任何公网管理入口** * 管理操作全走本地 CLI(admin.py),**不开任何公网管理入口**
@@ -123,6 +124,11 @@ LOG_FILE = os.path.join(ROOT, "server.log")
os.makedirs(ROOT, exist_ok=True) # 模块导入时就要保证目录存在(token 文件要写进去) os.makedirs(ROOT, exist_ok=True) # 模块导入时就要保证目录存在(token 文件要写进去)
# 数据库(2026-10-05):第一次启动自动建库,并把旧版 JSON(codes.json / meta.json / 账本 …)导进来,
# 旧文件原样留着。回退:python3 store.py export。详见 store.py 开头和交接说明「数据库」一节。
import store # noqa: E402 同目录,零依赖
STORE = store.Store(ROOT)
HOST, PORT = "localhost", 8080 HOST, PORT = "localhost", 8080
KEEP_HOURS = 72 # 成品在服务器保留时长 KEEP_HOURS = 72 # 成品在服务器保留时长
OFFLINE_AFTER = 1500 # 心跳超过这么多秒 = 离线 OFFLINE_AFTER = 1500 # 心跳超过这么多秒 = 离线
@@ -245,7 +251,7 @@ def gift_batches():
kind(券的种类:render=渲染图 / standee=立牌 / keychain=钥匙扣 / …未来扩展) kind(券的种类:render=渲染图 / standee=立牌 / keychain=钥匙扣 / …未来扩展)
shape(版式:square/横版 portrait…留字段,先不用) shape(版式:square/横版 portrait…留字段,先不用)
""" """
d = jload(GIFTS_FILE, {}) d = STORE.kv_get("gifts", {})
if not isinstance(d, dict) or not isinstance(d.get("batches"), list): if not isinstance(d, dict) or not isinstance(d.get("batches"), list):
d = {"batches": []} d = {"batches": []}
return d return d
@@ -310,7 +316,7 @@ def gift_public():
def gift_claim_days(): def gift_claim_days():
"""福利券领到后**多久必须用掉**(金钻 2026-10-02:领了不用要逾期)""" """福利券领到后**多久必须用掉**(金钻 2026-10-02:领了不用要逾期)"""
try: try:
return max(1, int((jload(GIFTS_FILE, {}) or {}).get("claim_days") or 7)) return max(1, int((STORE.kv_get("gifts", {}) or {}).get("claim_days") or 7))
except (TypeError, ValueError): except (TypeError, ValueError):
return 7 return 7
@@ -414,7 +420,7 @@ def gift_claim(bid, token, ip):
_days = gift_claim_days() _days = gift_claim_days()
cs[pick]["claim_expire"] = (now() + timedelta(days=_days)).isoformat(timespec="seconds") cs[pick]["claim_expire"] = (now() + timedelta(days=_days)).isoformat(timespec="seconds")
cs[pick]["gift_kind"] = b.get("kind") or "render" cs[pick]["gift_kind"] = b.get("kind") or "render"
jsave(CODES_FILE, cs) save_codes(cs)
log("福利券 %s 被领走:%s(%s)" % (bid, pick, ip)) log("福利券 %s 被领走:%s(%s)" % (bid, pick, ip))
rec = load_codes().get(pick) or {} rec = load_codes().get(pick) or {}
mx = int(rec.get("n_max") or rec.get("n_fix") or 1) mx = int(rec.get("n_max") or rec.get("n_fix") or 1)
@@ -487,7 +493,7 @@ def gift_batch_new(name, count=20, n_fix=1, n_free=False, tpl="", lock_tpl=False
"enabled": True, "direct": bool(direct), "enabled": True, "direct": bool(direct),
"created": now().isoformat(timespec="seconds"), "created": now().isoformat(timespec="seconds"),
}) })
jsave(GIFTS_FILE, d) STORE.kv_put("gifts", d)
codes = gift_batch_add(bid, count, direct=direct) codes = gift_batch_add(bid, count, direct=direct)
log("福利券批次建好 %s「%s」%d 张(%s)" % ( log("福利券批次建好 %s「%s」%d 张(%s)" % (
bid, name, len(codes), "不限张数" if n_free else "最多 %d 张" % n_fix)) bid, name, len(codes), "不限张数" if n_free else "最多 %d 张" % n_fix))
@@ -526,7 +532,7 @@ def gift_batch_add(bid, count=20, direct=None):
for c in got: for c in got:
if c in cs: if c in cs:
cs[c]["gift"] = bid cs[c]["gift"] = bid
jsave(CODES_FILE, cs) save_codes(cs)
log("福利券批次 %s 补货 %d 张" % (bid, len(got))) log("福利券批次 %s 补货 %d 张" % (bid, len(got)))
return got return got
@@ -539,7 +545,7 @@ def gift_batch_off(bid):
if not b: if not b:
raise ValueError("没有这个批次:%s" % bid) raise ValueError("没有这个批次:%s" % bid)
b["enabled"] = False b["enabled"] = False
jsave(GIFTS_FILE, d) STORE.kv_put("gifts", d)
log("福利券批次 %s 已收摊" % bid) log("福利券批次 %s 已收摊" % bid)
return b return b
@@ -724,6 +730,24 @@ def now():
return datetime.now(CST) return datetime.now(CST)
def add_call(rec):
"""记一条「呼叫金钻」/ 反馈 / 部分失败。
数据库 calls 表是正本(后台和限频都查它);**同时照旧追加一行到 calls.jsonl** ——
手机通知那边是盯着这个文件的(那段不在这份代码里),不能让它断。
"""
# ⚠️ 这条也会在渲染机回传(finish_upload)里调:库写失败只记日志,绝不能让异常把回传打断
try:
STORE.call_add(rec)
except Exception as e: # noqa: BLE001
log("⚠️ 呼叫记录写库失败(只写了 calls.jsonl):%r" % (e,))
try:
with open(CALLS_FILE, "a", encoding="utf-8") as f:
f.write(json.dumps(rec, ensure_ascii=False) + "\n")
except OSError:
pass
def log(*a): def log(*a):
line = "[%s] %s" % (now().strftime("%Y-%m-%d %H:%M:%S"), " ".join(str(x) for x in a)) line = "[%s] %s" % (now().strftime("%Y-%m-%d %H:%M:%S"), " ".join(str(x) for x in a))
try: try:
@@ -811,7 +835,7 @@ def admin_token():
AT = admin_token() AT = admin_token()
HOME_IPS = (jload(HB_IPS_FILE, {}) or {}).get("ips") or [] # 重启后还记得上次认出的出口 IP HOME_IPS = (STORE.kv_get("home_ips", {}) or {}).get("ips") or [] # 重启后还记得上次认出的出口 IP
def note_home_ip(ip): def note_home_ip(ip):
@@ -843,7 +867,12 @@ def new_owner_token():
# ----------------------------------------------------------------- 兑换码 # ----------------------------------------------------------------- 兑换码
def load_codes(): def load_codes():
return jload(CODES_FILE, {}) return STORE.codes_all()
def save_codes(codes):
"""整份写回卡密(一个事务里只改有变化的行)。调用方照旧要在 `with LOCK:` 里 load → 改 → save。"""
STORE.codes_save(codes)
def gen_codes(n, batch="", value=6, platform="", tpl="", state="active", is_set=False, direct=False, def gen_codes(n, batch="", value=6, platform="", tpl="", state="active", is_set=False, direct=False,
@@ -880,7 +909,7 @@ def gen_codes(n, batch="", value=6, platform="", tpl="", state="active", is_set=
"n_fix": int(n_fix or 0), "n_max": int(n_max or 0), "n_fix": int(n_fix or 0), "n_max": int(n_max or 0),
"lock_tpl": bool(lock_tpl), "n_free": bool(n_free)} "lock_tpl": bool(lock_tpl), "n_free": bool(n_free)}
made.append(c) made.append(c)
jsave(CODES_FILE, codes) save_codes(codes)
return made return made
@@ -909,7 +938,7 @@ def code_info(raw):
c = (raw or "").strip().upper() c = (raw or "").strip().upper()
if not CODE_RE.match(c): if not CODE_RE.match(c):
return None return None
rec = (load_codes() or {}).get(c) rec = STORE.code_get(c)
if not rec: if not rec:
return None return None
st = code_state(rec) st = code_state(rec)
@@ -945,31 +974,20 @@ def note_tpl_time(tpl, sec):
return return
if not tpl or sec <= 0 or sec > 3600: if not tpl or sec <= 0 or sec > 3600:
return return
try: with LOCK:
d = json.load(open(TPL_TIMES_FILE, encoding="utf-8")) d = STORE.kv_get("tpl_times", {})
if not isinstance(d, dict): if not isinstance(d, dict):
d = {} d = {}
except Exception: arr = list(d.get(tpl) or [])
d = {} arr.append(round(sec, 1))
arr = list(d.get(tpl) or []) d[tpl] = arr[-50:]
arr.append(round(sec, 1)) STORE.kv_put("tpl_times", d)
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): def tpl_eta_sec(templates, n_img=1):
"""这单大概要渲多久:按模板历史耗时求和;没样本的模板按每张 60 秒兜底,再加 20 秒收尾。""" """这单大概要渲多久:按模板历史耗时求和;没样本的模板按每张 60 秒兜底,再加 20 秒收尾。"""
try: d = STORE.kv_get("tpl_times", {})
d = json.load(open(TPL_TIMES_FILE, encoding="utf-8")) if not isinstance(d, dict):
if not isinstance(d, dict):
d = {}
except Exception:
d = {} d = {}
per = [] per = []
for t in (templates or []): for t in (templates or []):
@@ -1127,7 +1145,7 @@ def redeem_bind(codes_in, oid):
codes[c]["used"] = False codes[c]["used"] = False
codes[c]["order"] = oid codes[c]["order"] = oid
codes[c]["bound_at"] = ts codes[c]["bound_at"] = ts
jsave(CODES_FILE, codes) save_codes(codes)
return True, None, good return True, None, good
@@ -1145,7 +1163,7 @@ def unbind_codes(codes_list, oid):
r.pop("bound_at", None) r.pop("bound_at", None)
hit = True hit = True
if hit: if hit:
jsave(CODES_FILE, codes) save_codes(codes)
def burn_codes(codes_list, oid): def burn_codes(codes_list, oid):
@@ -1163,7 +1181,7 @@ def burn_codes(codes_list, oid):
codes[c]["used"] = False codes[c]["used"] = False
codes[c]["order"] = oid codes[c]["order"] = oid
codes[c]["bound_at"] = now().isoformat(timespec="seconds") codes[c]["bound_at"] = now().isoformat(timespec="seconds")
jsave(CODES_FILE, codes) save_codes(codes)
def settle_codes(oid, why=""): def settle_codes(oid, why=""):
@@ -1185,7 +1203,7 @@ def settle_codes(oid, why=""):
r["settled"] = why r["settled"] = why
n += 1 n += 1
if n: if n:
jsave(CODES_FILE, codes) save_codes(codes)
return n return n
@@ -1238,25 +1256,31 @@ def order_dir(oid):
def read_meta(oid): def read_meta(oid):
p = os.path.join(order_dir(oid), "meta.json") """订单信息(数据库 orders 表)。没有这单 / 已清理 → None。"""
if not os.path.exists(p): if not oid or not isinstance(oid, str):
return None return None
return jload(p, None) return STORE.order_get(oid)
def write_meta(oid, meta): def write_meta(oid, meta):
jsave(os.path.join(order_dir(oid), "meta.json"), meta) STORE.order_put(oid, meta)
def list_orders(states=None): def list_orders(states=None):
out = [] """按单号排序的订单列表;states 给了就只要这几种状态(走索引,不再一单一单读文件)。"""
if not os.path.isdir(ORDERS): return STORE.orders(states)
return out
for oid in sorted(os.listdir(ORDERS)):
m = read_meta(oid) def drop_order(oid):
if m and (states is None or m.get("state") in states): """单没建成(提交中途失败):删目录 + 删行。"""
out.append(m) shutil.rmtree(order_dir(oid), ignore_errors=True)
return out STORE.order_drop(oid)
def purge_order(oid):
"""到期清理:删文件,行留着记账(之后 read_meta 当它不存在)。"""
shutil.rmtree(order_dir(oid), ignore_errors=True)
STORE.order_purge(oid)
import pngcheck # PNG 结构核验(防夹带)—— 同目录,零依赖 import pngcheck # PNG 结构核验(防夹带)—— 同目录,零依赖
@@ -1317,7 +1341,7 @@ def sync_voucher_nfix(m):
rec["n_fix"] = img_total(m) rec["n_fix"] = img_total(m)
hit = True hit = True
if hit: if hit:
jsave(CODES_FILE, cs) save_codes(cs)
def img_total(m): def img_total(m):
@@ -1405,7 +1429,7 @@ def heartbeat(force=False):
c = _status_cache c = _status_cache
if (not force) and c["v"] is not None and (time.monotonic() - c["t"]) < STATUS_TTL: if (not force) and c["v"] is not None and (time.monotonic() - c["t"]) < STATUS_TTL:
return c["v"] return c["v"]
hb = jload(HB_FILE, {}) hb = STORE.kv_get("heartbeat", {}) or {}
last = hb.get("ts") last = hb.get("ts")
online = False online = False
if last: if last:
@@ -1487,7 +1511,7 @@ def _edit_code_locked(c, patch):
r[k] = str(p[k] or "")[:20] r[k] = str(p[k] or "")[:20]
if r.get("lock_tpl") and not (r.get("tpl") or "").strip(): if r.get("lock_tpl") and not (r.get("tpl") or "").strip():
return False, "要锁定模板,得先给这张码带模板" return False, "要锁定模板,得先给这张码带模板"
jsave(CODES_FILE, cs) save_codes(cs)
return r, None return r, None
@@ -1684,6 +1708,8 @@ class H(BaseHTTPRequestHandler):
return self.admin_codes(q) return self.admin_codes(q)
if p == "/api/admin/gifts": if p == "/api/admin/gifts":
return self.admin_gifts() return self.admin_gifts()
if p == "/api/admin/calls":
return self.admin_calls(q)
return self.err("not found", 404) return self.err("not found", 404)
except Exception as e: except Exception as e:
@@ -1758,6 +1784,10 @@ class H(BaseHTTPRequestHandler):
return self.admin_gift_add() return self.admin_gift_add()
if p == "/api/admin/gift/off": if p == "/api/admin/gift/off":
return self.admin_gift_off() return self.admin_gift_off()
if p == "/api/admin/retry":
return self.admin_retry()
if p == "/api/admin/call-done":
return self.admin_call_done()
return self.err("not found", 404) return self.err("not found", 404)
except Exception as e: except Exception as e:
log("POST %s 异常 %r" % (p, e)) log("POST %s 异常 %r" % (p, e))
@@ -1887,7 +1917,7 @@ class H(BaseHTTPRequestHandler):
return self.err("皮肤文件过大") return self.err("皮肤文件过大")
oid = new_oid() oid = new_oid()
while os.path.exists(order_dir(oid)): while os.path.exists(order_dir(oid)) or STORE.order_known(oid):
oid = new_oid() oid = new_oid()
tok = new_owner_token() tok = new_owner_token()
os.makedirs(order_dir(oid), exist_ok=True) os.makedirs(order_dir(oid), exist_ok=True)
@@ -1932,7 +1962,7 @@ class H(BaseHTTPRequestHandler):
# 同一张码并发提交两次的话两边都会查到「可用」。绑不上 = 被别的提交抢先了。 # 同一张码并发提交两次的话两边都会查到「可用」。绑不上 = 被别的提交抢先了。
okb, eb, good = redeem_bind(good, oid) okb, eb, good = redeem_bind(good, oid)
if not okb: if not okb:
shutil.rmtree(order_dir(oid), ignore_errors=True) drop_order(oid)
log("兑换码并发冲突 %s:%s" % (ip, eb)) log("兑换码并发冲突 %s:%s" % (ip, eb))
return self.err(eb) return self.err(eb)
meta["codes"] = good meta["codes"] = good
@@ -1942,7 +1972,7 @@ class H(BaseHTTPRequestHandler):
except Exception: except Exception:
if not prepay: if not prepay:
unbind_codes(good, oid) # 单没建成,码放回去 unbind_codes(good, oid) # 单没建成,码放回去
shutil.rmtree(order_dir(oid), ignore_errors=True) drop_order(oid)
raise raise
note_submit(ip) note_submit(ip)
if prepay: if prepay:
@@ -1964,7 +1994,7 @@ class H(BaseHTTPRequestHandler):
_cs = load_codes() _cs = load_codes()
if newc in _cs: if newc in _cs:
_cs[newc]["order"] = oid _cs[newc]["order"] = oid
jsave(CODES_FILE, _cs) save_codes(_cs)
meta["codes"] = [newc] meta["codes"] = [newc]
with LOCK: with LOCK:
write_meta(oid, meta) write_meta(oid, meta)
@@ -2249,7 +2279,7 @@ class H(BaseHTTPRequestHandler):
if "测试" in title: if "测试" in title:
log("爱发电回调:测试单(%s),只记账不发码" % title.strip()) log("爱发电回调:测试单(%s),只记账不发码" % title.strip())
return self.js({"ec": 200, "em": ""}) return self.js({"ec": 200, "em": ""})
led = jload(PAYPLATFORM_LEDGER, {}) or {} led = STORE.ledger_all()
# ⚠️ 2026-10-05(外部复查):幂等原来只认「发过码」。可「对上网页单、激活了」那条路记的是 # ⚠️ 2026-10-05(外部复查):幂等原来只认「发过码」。可「对上网页单、激活了」那条路记的是
# code=None + used_by=<单号> —— 同一笔单再推一次(爱发电自己会重试;这个地址又是公开的, # code=None + used_by=<单号> —— 同一笔单再推一次(爱发电自己会重试;这个地址又是公开的,
# 谁都能把报文原样再 POST 一遍)就不算处理过:第二次激活失败(单子已经在排队)→ 掉进 # 谁都能把报文原样再 POST 一遍)就不算处理过:第二次激活失败(单子已经在排队)→ 掉进
@@ -2265,7 +2295,7 @@ class H(BaseHTTPRequestHandler):
led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "status": 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"), "amount": order.get("show_amount") or order.get("total_amount"),
"code": None, "note": "未付款"} "code": None, "note": "未付款"}
jsave(PAYPLATFORM_LEDGER, led) STORE.ledger_save(led)
return self.js({"ec": 200, "em": ""}) return self.js({"ec": 200, "em": ""})
real = payplatform_find_order(oid_af) real = payplatform_find_order(oid_af)
@@ -2275,7 +2305,7 @@ class H(BaseHTTPRequestHandler):
led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "code": None, led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "code": None,
"amount": order.get("show_amount") or order.get("total_amount"), "amount": order.get("show_amount") or order.get("total_amount"),
"note": "接口没查到,待人工核对", "need_human": True} "note": "接口没查到,待人工核对", "need_human": True}
jsave(PAYPLATFORM_LEDGER, led) STORE.ledger_save(led)
return self.js({"ec": 200, "em": ""}) return self.js({"ec": 200, "em": ""})
n_img_af = payplatform_img_count(real) n_img_af = payplatform_img_count(real)
@@ -2329,7 +2359,7 @@ class H(BaseHTTPRequestHandler):
"want_order": target, "need": need, "paid": paid, "want_order": target, "need": need, "paid": paid,
"note": "金额不足(应付 ¥%s,实付 ¥%s),待人工核对" % (need, paid), "note": "金额不足(应付 ¥%s,实付 ¥%s),待人工核对" % (need, paid),
"need_human": True} "need_human": True}
jsave(PAYPLATFORM_LEDGER, led) STORE.ledger_save(led)
return self.js({"ec": 200, "em": "", "data": {"content": return self.js({"ec": 200, "em": "", "data": {"content":
"金钻工坊 · 自助模板渲染\n收到你的付款,但金额和订单应付款(¥%s)对不上,已记下来等人工核对。\n" "金钻工坊 · 自助模板渲染\n收到你的付款,但金额和订单应付款(¥%s)对不上,已记下来等人工核对。\n"
"核对没问题就立刻排队出图;如果是付少了,补齐后我们会马上处理。" % need}}) "核对没问题就立刻排队出图;如果是付少了,补齐后我们会马上处理。" % need}})
@@ -2358,7 +2388,7 @@ class H(BaseHTTPRequestHandler):
"(也可以留作支持 🙏)" % (_yuan(paid), _yuan(need), _yuan(over))) "(也可以留作支持 🙏)" % (_yuan(paid), _yuan(need), _yuan(over)))
rec_led["content"] = content rec_led["content"] = content
led[oid_af] = rec_led led[oid_af] = rec_led
jsave(PAYPLATFORM_LEDGER, led) STORE.ledger_save(led)
log("爱发电付款 %s(¥%s)→ 对上网页单 %s → 已激活进队列(靠:%s)" log("爱发电付款 %s(¥%s)→ 对上网页单 %s → 已激活进队列(靠:%s)"
% (oid_af, led[oid_af]["amount"], target, how)) % (oid_af, led[oid_af]["amount"], target, how))
return self.js({"ec": 200, "em": "", "data": {"content": content}}) return self.js({"ec": 200, "em": "", "data": {"content": content}})
@@ -2377,7 +2407,7 @@ class H(BaseHTTPRequestHandler):
"sku": sku_txt, "buyer": real.get("user_id"), "remark": real.get("remark"), "sku": sku_txt, "buyer": real.get("user_id"), "remark": real.get("remark"),
"paid": paid, "note": "金额不足一张(¥%s),待人工核对" % paid, "paid": paid, "note": "金额不足一张(¥%s),待人工核对" % paid,
"need_human": True} "need_human": True}
jsave(PAYPLATFORM_LEDGER, led) STORE.ledger_save(led)
return self.js({"ec": 200, "em": "", "data": {"content": return self.js({"ec": 200, "em": "", "data": {"content":
"金钻工坊 · 自助模板渲染\n收到你的付款 ¥%s,但不足一张(¥%s),没法自动发码。\n" "金钻工坊 · 自助模板渲染\n收到你的付款 ¥%s,但不足一张(¥%s),没法自动发码。\n"
"已记下来等人工核对;补齐差额后会马上补发。" % (paid, PRICE_UNIT)}}) "已记下来等人工核对;补齐差额后会马上补发。" % (paid, PRICE_UNIT)}})
@@ -2386,10 +2416,6 @@ class H(BaseHTTPRequestHandler):
% (oid_af, n_img_af, paid, afford, n_img)) % (oid_af, n_img_af, paid, afford, n_img))
code = gen_codes(1, batch="爱发电自动", value=n_img * PRICE_UNIT, platform="爱发电", code = gen_codes(1, batch="爱发电自动", value=n_img * PRICE_UNIT, platform="爱发电",
tpl="", n_fix=n_img)[0] # 不限模板、只限张数(金钻口径) tpl="", n_fix=n_img)[0] # 不限模板、只限张数(金钻口径)
try:
os.chmod(CODES_FILE, 0o640)
except OSError:
pass
content = ("金钻工坊 · 自助模板渲染\n这是你的卡密(固定 %d 张,模板随便挑):%s\n" content = ("金钻工坊 · 自助模板渲染\n这是你的卡密(固定 %d 张,模板随便挑):%s\n"
"到 http<WIN-PATH> 点「卡密下单」填进去就能开始。" "到 http<WIN-PATH> 点「卡密下单」填进去就能开始。"
% (n_img, code)) % (n_img, code))
@@ -2409,7 +2435,7 @@ class H(BaseHTTPRequestHandler):
"待人工看一眼(可能是想多买)" "待人工看一眼(可能是想多买)"
% (_yuan(over_code), _yuan(n_img * PRICE_UNIT), _yuan(paid))) % (_yuan(over_code), _yuan(n_img * PRICE_UNIT), _yuan(paid)))
led[oid_af] = rec_led led[oid_af] = rec_led
jsave(PAYPLATFORM_LEDGER, led) STORE.ledger_save(led)
log("爱发电卖出:%s | 金额 %s | 规格 %s | 留言 %s | 发码 %s(%d 张)" log("爱发电卖出:%s | 金额 %s | 规格 %s | 留言 %s | 发码 %s(%d 张)"
% (oid_af, led[oid_af]["amount"], sku_txt, (real.get("remark") or "-")[:30], code, n_img)) % (oid_af, led[oid_af]["amount"], sku_txt, (real.get("remark") or "-")[:30], code, n_img))
# 发货内容塞进返回体(爱发电的自动发货会用 content 展示给买家;不认也没关系, # 发货内容塞进返回体(爱发电的自动发货会用 content 展示给买家;不认也没关系,
@@ -2444,7 +2470,7 @@ class H(BaseHTTPRequestHandler):
return self._activate_payplatform_locked(oid, m, ano, ip) return self._activate_payplatform_locked(oid, m, ano, ip)
def _activate_payplatform_locked(self, oid, m, ano, ip): def _activate_payplatform_locked(self, oid, m, ano, ip):
led = jload(PAYPLATFORM_LEDGER, {}) or {} led = STORE.ledger_all()
rec = None rec = None
for k, v in led.items(): for k, v in led.items():
if str(k).endswith(ano) or str(k) == ano: if str(k).endswith(ano) or str(k) == ano:
@@ -2470,7 +2496,7 @@ class H(BaseHTTPRequestHandler):
akey = rec["_key"] # ⚠️ 先存下来:下面要把 _key 从记录里 pop 掉, akey = rec["_key"] # ⚠️ 先存下来:下面要把 _key 从记录里 pop 掉,
led[akey]["used_by"] = oid # 之后再读 rec["_key"] 就是 KeyError(2026-10-01 实踩,500) led[akey]["used_by"] = oid # 之后再读 rec["_key"] 就是 KeyError(2026-10-01 实踩,500)
led[akey].pop("_key", None) led[akey].pop("_key", None)
jsave(PAYPLATFORM_LEDGER, led) STORE.ledger_save(led)
m["payplatform_order"] = akey m["payplatform_order"] = akey
with LOCK: with LOCK:
write_meta(oid, m) write_meta(oid, m)
@@ -2719,13 +2745,9 @@ class H(BaseHTTPRequestHandler):
with open(os.path.join(FEEDBACK_DIR, fid + ".json"), "w", encoding="utf-8") as f: with open(os.path.join(FEEDBACK_DIR, fid + ".json"), "w", encoding="utf-8") as f:
json.dump(rec, f, ensure_ascii=False, indent=1) json.dump(rec, f, ensure_ascii=False, indent=1)
# 走「呼叫金钻」同一套通知:他手机能收到 # 走「呼叫金钻」同一套通知:他手机能收到
try: add_call({"ts": rec["ts"], "ip": ip, "order": rec["order"],
with open(CALLS_FILE, "a", encoding="utf-8") as f: "notified": False, "kind": "反馈",
f.write(json.dumps({"ts": rec["ts"], "ip": ip, "order": rec["order"], "note": (note or "(只传了图)")[:120]})
"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])) log("反馈 %s | 单 %s | 图 %s | %s" % (fid, rec["order"] or "-", rec["image"] or "无", (note or "")[:60]))
return self.js({"ok": True, "id": fid}) return self.js({"ok": True, "id": fid})
@@ -2866,10 +2888,10 @@ class H(BaseHTTPRequestHandler):
ip = ip_of(self) ip = ip_of(self)
if ip and ip not in ("?", "localhost"): if ip and ip not in ("?", "localhost"):
note_home_ip(ip) note_home_ip(ip)
jsave(HB_IPS_FILE, {"ips": HOME_IPS}) STORE.kv_put("home_ips", {"ips": HOME_IPS})
with LOCK: with LOCK:
status_cache_clear() status_cache_clear()
jsave(HB_FILE, {"ts": now().isoformat(timespec="seconds"), STORE.kv_put("heartbeat", {"ts": now().isoformat(timespec="seconds"),
"host": (d.get("host") or "render")[:40]}) "host": (d.get("host") or "render")[:40]})
return self.js({"ok": True, "queue": len(list_orders(("waiting",)))}) return self.js({"ok": True, "queue": len(list_orders(("waiting",)))})
@@ -3070,15 +3092,10 @@ class H(BaseHTTPRequestHandler):
m["partial"] = {"got": len(files), "want": total, m["partial"] = {"got": len(files), "want": total,
"why": str(d.get("note") or "")[:300], "why": str(d.get("note") or "")[:300],
"at": now().isoformat(timespec="seconds")} "at": now().isoformat(timespec="seconds")}
try: add_call({"ts": m["partial"]["at"], "ip": "渲染机", "order": oid,
with open(CALLS_FILE, "a", encoding="utf-8") as f: "notified": False, "kind": "部分失败",
f.write(json.dumps({"ts": m["partial"]["at"], "ip": "渲染机", "order": oid, "note": ("收到 %d/%d 个文件:%s" % (len(files), total,
"notified": False, "kind": "部分失败", m["partial"]["why"]))[:300]})
"note": ("收到 %d/%d 个文件:%s" % (len(files), total,
m["partial"]["why"]))[:300]},
ensure_ascii=False) + "\n")
except OSError:
pass
log("⚠️ %s 部分失败:收到 %d/%d 个文件(%s)" % (oid, len(files), total, m["partial"]["why"])) log("⚠️ %s 部分失败:收到 %d/%d 个文件(%s)" % (oid, len(files), total, m["partial"]["why"]))
if m.get("direct"): if m.get("direct"):
# 直发单不用确认收货 —— 渲完就是「开放下载」,保留期/核销都从这一刻起算 # 直发单不用确认收货 —— 渲完就是「开放下载」,保留期/核销都从这一刻起算
@@ -3116,12 +3133,8 @@ class H(BaseHTTPRequestHandler):
ip = self.headers.get("X-Real-IP") or self.client_address[0] ip = self.headers.get("X-Real-IP") or self.client_address[0]
nowt = now() nowt = now()
# 限频:同 IP 10 分钟内最多 3 次 # 限频:同 IP 10 分钟内最多 3 次
try: since = (nowt - timedelta(seconds=600)).isoformat(timespec="seconds")
recent = [json.loads(l) for l in open(CALLS_FILE, encoding="utf-8") if l.strip()] n = len(STORE.calls(ip=ip, since=since))
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: if n >= 3:
return self.js({"ok": True, "throttled": True}) return self.js({"ok": True, "throttled": True})
rec = {"ts": nowt.isoformat(timespec="seconds"), "ip": ip, rec = {"ts": nowt.isoformat(timespec="seconds"), "ip": ip,
@@ -3131,8 +3144,7 @@ class H(BaseHTTPRequestHandler):
"note": (d.get("note") or "")[:600], "note": (d.get("note") or "")[:600],
"email": (d.get("email") or "")[:120], "email": (d.get("email") or "")[:120],
"notified": False} "notified": False}
with open(CALLS_FILE, "a", encoding="utf-8") as f: add_call(rec)
f.write(json.dumps(rec, ensure_ascii=False) + "\n")
log("呼叫金钻 %s" % rec) log("呼叫金钻 %s" % rec)
return self.js({"ok": True}) return self.js({"ok": True})
@@ -3341,11 +3353,16 @@ class H(BaseHTTPRequestHandler):
except ValueError: except ValueError:
limit = 60 limit = 60
want = (q.get("state") or [""])[0].strip() want = (q.get("state") or [""])[0].strip()
# 2026-10-05:后台面板加了搜索框 —— 按码 / 订单号 / 批次 / 平台 找(不分大小写)
kw = (q.get("q") or [""])[0].strip().upper()[:40]
out = [] out = []
for c, r in load_codes().items(): for c, r in load_codes().items():
st = code_state(r) st = code_state(r)
if want and st != want: if want and st != want:
continue continue
if kw and not any(kw in str(x or "").upper()
for x in (c, r.get("order"), r.get("batch"), r.get("platform"))):
continue
out.append({"code": c, "state": st, "platform": r.get("platform"), out.append({"code": c, "state": st, "platform": r.get("platform"),
"tpl": r.get("tpl"), "set": bool(r.get("set")), "tpl": r.get("tpl"), "set": bool(r.get("set")),
"direct": bool(r.get("direct")), "batch": r.get("batch"), "direct": bool(r.get("direct")), "batch": r.get("batch"),
@@ -3403,6 +3420,47 @@ class H(BaseHTTPRequestHandler):
write_meta(oid, m) write_meta(oid, m)
return self.js({"ok": True, "oid": oid, "state": "void"}) return self.js({"ok": True, "oid": oid, "state": "void"})
def admin_calls(self, q):
"""「呼叫金钻」/ 反馈 / 部分失败 记录,新的在前(2026-10-05:原来只能 ssh 上去 admin.py calls 看)。"""
try:
limit = min(int((q.get("limit") or ["60"])[0]), 300)
except ValueError:
limit = 60
rows = STORE.calls(limit=limit)[::-1]
return self.js({"ok": True, "calls": rows,
"open": sum(1 for r in rows if not r.get("handled"))})
def admin_call_done(self):
"""把一条呼叫标成「处理过了」。只加 handled 字段,不碰 notified(那是手机通知那边用的)。"""
d = self.body_json() or {}
try:
cid = int(d.get("id"))
except (TypeError, ValueError):
return self.err("没有这条记录", 404)
undo = bool(d.get("undo"))
if not STORE.call_mark(cid, handled=not undo,
handled_at=None if undo else now().isoformat(timespec="seconds")):
return self.err("没有这条记录", 404)
return self.js({"ok": True, "id": cid})
def admin_retry(self):
"""渲染失败的单退回队列重渲(等于 admin.py retry;面板上原来只能写「喊苏达」)。"""
d = self.body_json() or {}
oid = (d.get("oid") or "").strip().upper()
with LOCK:
m = read_meta(oid) if oid else None
if not m:
return self.err("没有这个订单:%s" % oid, 404)
if m.get("state") != "failed":
return self.err("只有「渲染失败」的单能退回重渲,这一单现在是「%s」" % m.get("state"))
m["state"] = "waiting"
m["note"] = "管理员退回重渲"
m["started"] = m["finished"] = None
write_meta(oid, m)
status_cache_clear()
log("后台退回重渲 %s" % oid)
return self.js({"ok": True, "oid": oid, "state": "waiting"})
def admin_note(self): def admin_note(self):
d = self.body_json() or {} d = self.body_json() or {}
oid = (d.get("oid") or "").strip().upper() oid = (d.get("oid") or "").strip().upper()
+425
View File
@@ -0,0 +1,425 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""金钻工坊 · 数据层(SQLite,标准库自带,零依赖)
2026-10-05 起,原来散在 <DATA_DIR> 下的这些「拿 JSON 文件当数据库」的东西,统一进一个库:
<DATA_DIR>/ys.db
| 表 | 原来在哪 | 里面是什么 |
|-------------|-----------------------------------|------------|
| codes | codes.json | 卡密池(一行一张码) |
| orders | orders/<单号>/meta.json | 订单信息(一行一单;皮肤 / 成品**文件**还在 orders/<单号>/ 目录里) |
| pay_orders | payplatform-orders.json | 爱发电回调账本(一行一笔,按平台单号幂等) |
| calls | calls.jsonl | 「呼叫金钻」/ 反馈 / 部分失败 记录 |
| kv | gifts.json / heartbeat.json / home_ips.json / tpl_times.json | 小块状态(一个键一份 JSON) |
**还是文件、没进库的**(都是人手改的配置或二进制):
payplatform.json(凭据)、payplatform-map.json、prices.json、payinfo.json、
worker_token / admin_token、皮肤与成品图片、feedback/ 里的反馈图、各种 .log
设计取舍(为什么这么做):
* 每张表都是「几个能查的列 + 一列 data(整条记录的 JSON)」。上层代码拿到的还是原来的 dict,
**字段想加就加,不用改表**;能查的列(state / order_id / batch …)是写入时从 data 里抽出来的。
* 写整份 dict 的老写法(load → 改 → save)保留:save 时在**一个事务里**只改有变化的行。
所以 server.py 里的路由逻辑一行都不用动,只是存取换了地方。
* 并发:上层照旧 `with LOCK:`(线程锁 + 跨进程 flock);库本身开 WAL + busy_timeout,
读不挡写、写不挡读,另一个进程(admin.py)在写也只是等一会儿,不会报 locked。
* 断电:SQLite 事务要么全写进去、要么全没写,不会再有「半截 codes.json」。
第一次启动自动从旧 JSON 导入(只导一次,旧文件原样留着不删);要回退到旧版:
python3 store.py export 把库里的数据导回成旧版的 JSON 文件
python3 store.py check 完整性检查 + 每张表几行
python3 store.py backup 在线热备份一份到 <DATA_DIR>/backup/ys-<时间>.db
"""
import json, os, sqlite3, sys, threading, time
SCHEMA_VERSION = 1
# 哪些 kv 键原来是哪个文件(导入 / 导出用)
KV_FILES = {
"gifts": "gifts.json",
"heartbeat": "heartbeat.json",
"home_ips": "home_ips.json",
"tpl_times": "tpl_times.json",
}
_SCHEMA = """
CREATE TABLE IF NOT EXISTS codes (
code TEXT PRIMARY KEY,
state TEXT NOT NULL DEFAULT 'active',
order_id TEXT,
batch TEXT,
platform TEXT,
gift TEXT,
data TEXT NOT NULL,
updated REAL NOT NULL
);
CREATE INDEX IF NOT EXISTS codes_state ON codes(state);
CREATE INDEX IF NOT EXISTS codes_order ON codes(order_id);
CREATE INDEX IF NOT EXISTS codes_batch ON codes(batch);
CREATE INDEX IF NOT EXISTS codes_gift ON codes(gift);
CREATE TABLE IF NOT EXISTS orders (
oid TEXT PRIMARY KEY,
state TEXT,
created TEXT,
data TEXT NOT NULL,
updated REAL NOT NULL,
purged REAL -- 文件已清理的时间;NULL = 还在。清掉的单留一行做账,不再当成「存在」
);
CREATE INDEX IF NOT EXISTS orders_state ON orders(state) WHERE purged IS NULL;
CREATE TABLE IF NOT EXISTS pay_orders (
out_trade_no TEXT PRIMARY KEY,
data TEXT NOT NULL,
updated REAL NOT NULL
);
CREATE TABLE IF NOT EXISTS calls (
id INTEGER PRIMARY KEY AUTOINCREMENT,
ts TEXT,
ip TEXT,
order_id TEXT,
data TEXT NOT NULL
);
CREATE INDEX IF NOT EXISTS calls_ip ON calls(ip, ts);
CREATE TABLE IF NOT EXISTS kv (
k TEXT PRIMARY KEY,
data TEXT NOT NULL,
updated REAL NOT NULL
);
CREATE TABLE IF NOT EXISTS schema_info (k TEXT PRIMARY KEY, v TEXT);
"""
def _dump(obj):
return json.dumps(obj, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
def _code_cols(code, rec):
st = rec.get("state")
if st not in ("active", "inactive", "used", "bound"):
st = "used" if rec.get("used") else "active"
return (code, st, rec.get("order") or None, rec.get("batch") or None,
rec.get("platform") or None, rec.get("gift") or None)
class Store(object):
"""一个库文件一个实例。每个线程自己一条连接(sqlite3 连接不能跨线程用)。"""
def __init__(self, root):
self.root = root
self.path = os.path.join(root, "ys.db")
self._local = threading.local()
os.makedirs(root, exist_ok=True)
fresh = not os.path.exists(self.path)
c = self.conn()
c.executescript(_SCHEMA)
if fresh:
try:
os.chmod(self.path, 0o640) # 和 codes.json 一样:别的账号读不到
except OSError:
pass
if self._info("schema") is None:
with self.tx() as c:
c.execute("INSERT OR REPLACE INTO schema_info VALUES ('schema', ?)", (str(SCHEMA_VERSION),))
if self._info("imported") is None:
self.import_legacy()
# ------------------------------------------------------------ 连接 / 事务
def conn(self):
c = getattr(self._local, "c", None)
if c is None:
c = sqlite3.connect(self.path, timeout=30, isolation_level=None, check_same_thread=False)
c.execute("PRAGMA journal_mode=WAL")
c.execute("PRAGMA synchronous=NORMAL") # WAL 下 NORMAL:断电最多丢最后一个事务,不会写坏库
c.execute("PRAGMA busy_timeout=30000")
c.execute("PRAGMA foreign_keys=ON")
self._local.c = c
return c
class _Tx(object):
def __init__(self, c):
self.c = c
def __enter__(self):
self.c.execute("BEGIN IMMEDIATE")
return self.c
def __exit__(self, et, ev, tb):
self.c.execute("COMMIT" if et is None else "ROLLBACK")
return False
def tx(self):
"""写事务:`with store.tx() as c:` 里的语句要么全成、要么全不成。"""
return Store._Tx(self.conn())
def _info(self, k):
r = self.conn().execute("SELECT v FROM schema_info WHERE k=?", (k,)).fetchone()
return r[0] if r else None
# ------------------------------------------------------------ 卡密
def codes_all(self):
return {k: json.loads(d) for k, d in self.conn().execute("SELECT code, data FROM codes")}
def code_get(self, code):
r = self.conn().execute("SELECT data FROM codes WHERE code=?", (code,)).fetchone()
return json.loads(r[0]) if r else None
def codes_where(self, **cols):
"""按列查:codes_where(order_id='YS…') / codes_where(gift='g1') / codes_where(state='active')"""
ok = ("state", "order_id", "batch", "platform", "gift")
ks = [k for k in cols if k in ok]
sql = "SELECT code, data FROM codes" + (" WHERE " + " AND ".join("%s=?" % k for k in ks) if ks else "")
return {k: json.loads(d) for k, d in self.conn().execute(sql, [cols[k] for k in ks])}
def codes_save(self, codes):
"""整份写回(老写法 load → 改 → save 用)。一个事务里:变了的更新、没了的删掉、新的插入。"""
now = time.time()
with self.tx() as c:
old = dict(c.execute("SELECT code, data FROM codes"))
for k in set(old) - set(codes):
c.execute("DELETE FROM codes WHERE code=?", (k,))
for k, rec in codes.items():
d = _dump(rec)
if old.get(k) == d:
continue
c.execute("INSERT OR REPLACE INTO codes (code, state, order_id, batch, platform, gift, data, updated)"
" VALUES (?,?,?,?,?,?,?,?)", _code_cols(k, rec) + (d, now))
def code_put(self, code, rec):
with self.tx() as c:
c.execute("INSERT OR REPLACE INTO codes (code, state, order_id, batch, platform, gift, data, updated)"
" VALUES (?,?,?,?,?,?,?,?)", _code_cols(code, rec) + (_dump(rec), time.time()))
def code_counts(self):
return dict(self.conn().execute("SELECT state, COUNT(*) FROM codes GROUP BY state"))
# ------------------------------------------------------------ 订单
def order_get(self, oid):
r = self.conn().execute("SELECT data FROM orders WHERE oid=? AND purged IS NULL", (oid,)).fetchone()
return json.loads(r[0]) if r else None
def order_put(self, oid, meta):
with self.tx() as c:
c.execute("INSERT INTO orders (oid, state, created, data, updated, purged) VALUES (?,?,?,?,?,NULL)"
" ON CONFLICT(oid) DO UPDATE SET state=excluded.state, created=excluded.created,"
" data=excluded.data, updated=excluded.updated, purged=NULL",
(oid, meta.get("state"), meta.get("created"), _dump(meta), time.time()))
def order_known(self, oid):
"""这个单号用过没有(包括已清理的)—— 发新单号时防撞号。"""
return self.conn().execute("SELECT 1 FROM orders WHERE oid=?", (oid,)).fetchone() is not None
def orders(self, states=None, include_purged=False):
sql, args = "SELECT data FROM orders", []
cond = [] if include_purged else ["purged IS NULL"]
if states is not None:
states = list(states)
if not states:
return []
cond.append("state IN (%s)" % ",".join("?" * len(states)))
args += states
if cond:
sql += " WHERE " + " AND ".join(cond)
sql += " ORDER BY oid"
return [json.loads(d) for (d,) in self.conn().execute(sql, args)]
def order_ids(self):
return [r[0] for r in self.conn().execute("SELECT oid FROM orders WHERE purged IS NULL ORDER BY oid")]
def order_purge(self, oid):
"""文件清掉了:行留着(记账 / 统计用),但之后 order_get 当它不存在。"""
with self.tx() as c:
c.execute("UPDATE orders SET purged=? WHERE oid=?", (time.time(), oid))
def order_drop(self, oid):
"""单根本没建成(提交中途失败):连行一起删。"""
with self.tx() as c:
c.execute("DELETE FROM orders WHERE oid=?", (oid,))
def order_counts(self):
return dict(self.conn().execute("SELECT state, COUNT(*) FROM orders WHERE purged IS NULL GROUP BY state"))
# ------------------------------------------------------------ 爱发电账本
def ledger_all(self):
return {k: json.loads(d) for k, d in self.conn().execute("SELECT out_trade_no, data FROM pay_orders")}
def ledger_get(self, no):
r = self.conn().execute("SELECT data FROM pay_orders WHERE out_trade_no=?", (str(no),)).fetchone()
return json.loads(r[0]) if r else None
def ledger_save(self, led):
now = time.time()
with self.tx() as c:
old = dict(c.execute("SELECT out_trade_no, data FROM pay_orders"))
for k in set(old) - set(led):
c.execute("DELETE FROM pay_orders WHERE out_trade_no=?", (k,))
for k, rec in led.items():
d = _dump(rec)
if old.get(k) != d:
c.execute("INSERT OR REPLACE INTO pay_orders VALUES (?,?,?)", (str(k), d, now))
# ------------------------------------------------------------ 呼叫记录
def call_add(self, rec):
with self.tx() as c:
cur = c.execute("INSERT INTO calls (ts, ip, order_id, data) VALUES (?,?,?,?)",
(rec.get("ts"), rec.get("ip"), rec.get("order") or None, _dump(rec)))
return cur.lastrowid
def calls(self, limit=None, ip=None, since=None):
"""最近的在后。ip / since(ISO 时间串)可以筛。"""
sql, cond, args = "SELECT id, data FROM calls", [], []
if ip is not None:
cond.append("ip=?"); args.append(ip)
if since is not None:
cond.append("ts>=?"); args.append(since)
if cond:
sql += " WHERE " + " AND ".join(cond)
sql += " ORDER BY id DESC"
if limit:
sql += " LIMIT %d" % int(limit)
out = []
for i, d in self.conn().execute(sql, args):
r = json.loads(d); r["id"] = i; out.append(r)
return out[::-1]
def call_mark(self, cid, **fields):
with self.tx() as c:
r = c.execute("SELECT data FROM calls WHERE id=?", (cid,)).fetchone()
if not r:
return False
d = json.loads(r[0]); d.update(fields)
c.execute("UPDATE calls SET data=? WHERE id=?", (_dump(d), cid))
return True
# ------------------------------------------------------------ 小块状态
def kv_get(self, k, default=None):
r = self.conn().execute("SELECT data FROM kv WHERE k=?", (k,)).fetchone()
return json.loads(r[0]) if r else default
def kv_put(self, k, obj):
with self.tx() as c:
c.execute("INSERT OR REPLACE INTO kv VALUES (?,?,?)", (k, _dump(obj), time.time()))
# ------------------------------------------------------------ 导入 / 导出 / 体检
def import_legacy(self):
"""第一次启动:把旧 JSON 导进来(旧文件不动)。整个导入一个事务,失败就整体回滚、下次再试。"""
R = self.root
n = {"codes": 0, "orders": 0, "pay_orders": 0, "calls": 0, "kv": 0}
def jl(p, default):
try:
with open(p, encoding="utf-8") as f:
return json.load(f)
except (OSError, ValueError):
return default
now = time.time()
with self.tx() as c:
# 服务器和 admin.py 同时第一次启动时,两边都会走到这里:BEGIN IMMEDIATE 让它们排队,
# 后进来的那个在事务里再看一眼,导过了就不再导(不然呼叫记录会导两份)
if c.execute("SELECT 1 FROM schema_info WHERE k='imported'").fetchone():
return None
for k, rec in (jl(os.path.join(R, "codes.json"), {}) or {}).items():
if isinstance(rec, dict):
c.execute("INSERT OR IGNORE INTO codes (code, state, order_id, batch, platform, gift, data, updated)"
" VALUES (?,?,?,?,?,?,?,?)", _code_cols(k, rec) + (_dump(rec), now))
n["codes"] += 1
od = os.path.join(R, "orders")
if os.path.isdir(od):
for oid in sorted(os.listdir(od)):
m = jl(os.path.join(od, oid, "meta.json"), None)
if isinstance(m, dict):
c.execute("INSERT OR IGNORE INTO orders (oid, state, created, data, updated) VALUES (?,?,?,?,?)",
(oid, m.get("state"), m.get("created"), _dump(m), now))
n["orders"] += 1
for k, rec in (jl(os.path.join(R, "payplatform-orders.json"), {}) or {}).items():
c.execute("INSERT OR IGNORE INTO pay_orders VALUES (?,?,?)", (str(k), _dump(rec), now))
n["pay_orders"] += 1
try:
with open(os.path.join(R, "calls.jsonl"), encoding="utf-8") as f:
for line in f:
try:
r = json.loads(line)
except ValueError:
continue # 旧文件里写了半行的那条跳过
if isinstance(r, dict):
c.execute("INSERT INTO calls (ts, ip, order_id, data) VALUES (?,?,?,?)",
(r.get("ts"), r.get("ip"), r.get("order") or None, _dump(r)))
n["calls"] += 1
except OSError:
pass
for k, fn in KV_FILES.items():
v = jl(os.path.join(R, fn), None)
if v is not None:
c.execute("INSERT OR IGNORE INTO kv VALUES (?,?,?)", (k, _dump(v), now))
n["kv"] += 1
c.execute("INSERT OR REPLACE INTO schema_info VALUES ('imported', ?)",
(json.dumps({"at": time.strftime("%Y-%m-%d %H:%M:%S"), "n": n}, ensure_ascii=False),))
return n
def export_legacy(self, dest=None):
"""把库导回旧版 JSON(回退用)。dest 不给 = 写回 <DATA_DIR>(会覆盖那几个旧文件)。"""
D = dest or self.root
os.makedirs(os.path.join(D, "orders"), exist_ok=True)
def js(p, obj):
tmp = p + ".export.tmp"
with open(tmp, "w", encoding="utf-8") as f:
json.dump(obj, f, ensure_ascii=False, indent=1)
os.replace(tmp, p)
js(os.path.join(D, "codes.json"), self.codes_all())
js(os.path.join(D, "payplatform-orders.json"), self.ledger_all())
for m in self.orders():
od = os.path.join(D, "orders", m["oid"])
os.makedirs(od, exist_ok=True)
js(os.path.join(od, "meta.json"), m)
with open(os.path.join(D, "calls.jsonl"), "w", encoding="utf-8") as f:
for r in self.calls():
r.pop("id", None)
f.write(json.dumps(r, ensure_ascii=False) + "\n")
for k, fn in KV_FILES.items():
v = self.kv_get(k)
if v is not None:
js(os.path.join(D, fn), v)
return D
def check(self):
c = self.conn()
ok = c.execute("PRAGMA integrity_check").fetchone()[0]
n = {t: c.execute("SELECT COUNT(*) FROM %s" % t).fetchone()[0]
for t in ("codes", "orders", "pay_orders", "calls", "kv")}
return ok, n, self._info("imported")
def backup(self, dest=None):
"""在线热备份(服务器不用停)。"""
d = dest or os.path.join(self.root, "backup")
os.makedirs(d, exist_ok=True)
p = os.path.join(d, "ys-%s.db" % time.strftime("%Y%m%d-%H%M%S"))
b = sqlite3.connect(p)
with b:
self.conn().backup(b)
b.close()
os.chmod(p, 0o600)
return p
if __name__ == "__main__":
root = os.environ.get("YS_ROOT", "<DATA_DIR>")
cmd = (sys.argv[1:] or ["check"])[0]
st = Store(root)
if cmd == "check":
ok, n, imp = st.check()
print("完整性:%s" % ok)
for k, v in n.items():
print(" %-10s %d 行" % (k, v))
print("旧数据导入:%s" % (imp or "(没导过)"))
elif cmd == "export":
print("已导出到 %s" % st.export_legacy(sys.argv[2] if len(sys.argv) > 2 else None))
elif cmd == "backup":
print("备份好了:%s" % st.backup())
else:
print(__doc__)
sys.exit(2)
@@ -0,0 +1,298 @@
# -*- coding: utf-8 -*-
"""数据库(store.py / ys.db)测试 —— 数据全是这里现编的假数据,不碰任何真实环境。
用法:python3 tests/数据库测试.py <server.py 所在目录>
(和 回执复现测试.py 一样:交付副本里三个 URL 格式串被脱敏弄坏了,第 9 节要起服务器,跑之前先换成能格式化的占位)
测的是:
1. 全新安装:空目录第一次启动 → 自动建库,什么都不用配
2. 老数据迁移:现编一套旧版 JSON(卡密 / 订单 meta / 爱发电账本 / 呼叫记录(含写坏的半行)/ 小块状态)→ 一次导全
3. 重启不重复导入;旧文件原样不动
4. 卡密整份写回 = 只改有变化的行;能查的列(state / order_id)跟着变
5. 订单清理:行留着记账,但对外当它不存在;单号不会被重新发出去
6. 事务:中途出错整体回滚,不留半截
7. 导出旧版 JSON → 再导入新库,数据一模一样(回退路径能用)
8. 热备份能打开、行数一致;完整性检查 ok
9. 服务器直接在「迁移过来的老数据」上跑:老订单能查、老卡密能认、admin.py db / calls / ls 能用
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢;三个进程同时第一次启动只导一次
11. 规模:5000 张码 + 2000 单,按状态列订单的耗时
"""
import json, os, random, shutil, sqlite3, subprocess, sys, tempfile, threading, time
SRC = os.path.abspath(sys.argv[1])
sys.path.insert(0, SRC)
import store # noqa: E402
RESULTS = []
def check(name, cond, detail=""):
RESULTS.append((name, bool(cond), detail))
print(("PASS " if cond else "FAIL ") + name + ((" —— " + detail) if detail else ""), flush=True)
def jw(p, obj):
os.makedirs(os.path.dirname(p), exist_ok=True)
with open(p, "w", encoding="utf-8") as f:
json.dump(obj, f, ensure_ascii=False, indent=1)
ALPH = "23456789ABCDEFGHJKMNPQRSTUVWXYZ"
rnd = random.Random(20261005)
def fake_code():
return "YS-" + "-".join("".join(rnd.choice(ALPH) for _ in range(4)) for _ in range(3))
def fake_oid():
return "YS" + "".join(rnd.choice(ALPH) for _ in range(6))
def make_legacy(root, n_codes=40, n_orders=12):
"""现编一套「旧版」数据目录(形状照 server.py 写出来的样子)。"""
codes, orders = {}, {}
states = ["waiting", "working", "done", "failed", "unpaid", "paid"]
for i in range(n_orders):
oid = fake_oid()
orders[oid] = {"oid": oid, "state": states[i % len(states)], "token": "".join(rnd.choice(ALPH) for _ in range(14)),
"created": "2026-10-0%dT1%d:00:00+08:00" % (1 + i % 4, i % 10), "arm": "classic",
"templates": ["stand"], "res": 1000, "skins": [{"id": "s1", "path": "skin.png", "templates": ["stand"]}],
"codes": [], "files": [], "note": "假单 %d" % i, "expire": "2026-10-09T00:00:00+08:00"}
oids = list(orders)
for i in range(n_codes):
c = fake_code()
st = ["active", "inactive", "bound", "used"][i % 4]
rec = {"used": st == "used", "order": None, "ts": None, "batch": "测试批%d" % (i % 3), "value": 6,
"platform": ["", "闲鱼", "爱发电"][i % 3], "tpl": "", "state": st, "set": False, "direct": False,
"n_fix": 1, "n_max": 0, "lock_tpl": False, "n_free": False}
if st in ("bound", "used"):
o = oids[i % len(oids)]
rec["order"] = o
orders[o]["codes"].append(c)
codes[c] = rec
codes["YS-OLD0-OLD0-OLD0"] = {"used": True, "order": None, "batch": "最早一批"} # 老格式:只有 used 布尔
jw(os.path.join(root, "codes.json"), codes)
for oid, m in orders.items():
jw(os.path.join(root, "orders", oid, "meta.json"), m)
with open(os.path.join(root, "orders", oid, "skin.png"), "wb") as f:
f.write(b"\x89PNG\r\n\x1a\nfake-skin")
jw(os.path.join(root, "payplatform-orders.json"),
{"2026100500000000000000000%02d" % i: {"ts": "2026-10-05T12:00:00+08:00", "code": fake_code(), "n_img": 1,
"paid": "6.00", "notified": False} for i in range(5)})
with open(os.path.join(root, "calls.jsonl"), "w", encoding="utf-8") as f:
for i in range(6):
f.write(json.dumps({"ts": "2026-10-05T1%d:00:00+08:00" % i, "ip": "10.0.0.%d" % i, "order": oids[i],
"note": "等太久了 %d" % i, "notified": i % 2 == 0}, ensure_ascii=False) + "\n")
f.write('{"ts": "2026-10-05T19:00:00+08:00", "ip": "10.0.0.9", "no') # 断电写了半行
jw(os.path.join(root, "gifts.json"), {"batches": [{"id": "g1", "name": "国庆福利", "n_fix": 1, "enabled": True}]})
jw(os.path.join(root, "heartbeat.json"), {"ts": "2026-10-05T12:00:00+08:00", "host": "render"})
jw(os.path.join(root, "home_ips.json"), {"ips": ["198.51.100.7"]})
jw(os.path.join(root, "tpl_times.json"), {"stand": [40.0, 42.5, 39.1]})
return codes, orders
def fingerprint(root):
out = {}
for dp, _, fs in os.walk(root):
for f in fs:
p = os.path.join(dp, f)
out[os.path.relpath(p, root)] = open(p, "rb").read()
return out
# ================================================================== 1. 全新安装
R1 = tempfile.mkdtemp(prefix="ys-db-fresh-")
st = store.Store(R1)
ok, n, imp = st.check()
check("全新安装:空目录第一次启动自动建库", os.path.exists(os.path.join(R1, "ys.db")) and ok == "ok" and sum(n.values()) == 0,
"完整性=%s 行数=%s" % (ok, n))
check("全新安装:库文件权限不对外(640)", (os.stat(st.path).st_mode & 0o777) == 0o640, oct(os.stat(st.path).st_mode & 0o777))
# ================================================================== 2/3. 老数据迁移
R2 = tempfile.mkdtemp(prefix="ys-db-legacy-")
codes0, orders0 = make_legacy(R2)
before = fingerprint(R2)
st2 = store.Store(R2)
check("迁移:卡密全部导入、内容一致", st2.codes_all() == codes0, "%d 张" % len(st2.codes_all()))
check("迁移:订单全部导入、内容一致", {m["oid"]: m for m in st2.orders()} == orders0, "%d 单" % len(st2.orders()))
check("迁移:爱发电账本导入", len(st2.ledger_all()) == 5)
calls = st2.calls()
check("迁移:呼叫记录导入(写坏的半行跳过,不影响别的)", len(calls) == 6 and calls[0]["note"] == "等太久了 0", "%d 条" % len(calls))
check("迁移:小块状态(福利券 / 心跳 / 家里 IP / 模板耗时)导入",
st2.kv_get("gifts")["batches"][0]["name"] == "国庆福利" and st2.kv_get("home_ips") == {"ips": ["198.51.100.7"]}
and st2.kv_get("tpl_times")["stand"][1] == 42.5 and st2.kv_get("heartbeat")["host"] == "render")
check("迁移:老格式卡密(只有 used 布尔)能查到、状态算成 used",
st2.codes_where(state="used").get("YS-OLD0-OLD0-OLD0") is not None)
bound = [c for c, r in codes0.items() if r.get("state") == "bound"]
o1 = codes0[bound[0]]["order"]
check("迁移:按订单号查它绑的卡密(走索引)", bound[0] in st2.codes_where(order_id=o1))
after = {k: v for k, v in fingerprint(R2).items() if not k.startswith("ys.db")}
check("迁移:旧文件原样不动(一个字节都没改)", after == before)
st2b = store.Store(R2)
check("重启:不会重复导入", len(st2b.codes_all()) == len(codes0) and len(st2b.calls()) == 6 and len(st2b.orders()) == len(orders0))
# ================================================================== 4. 整份写回 = 只改有变化的行
cs = st2.codes_all()
c_up, c_del = list(cs)[0], list(cs)[1]
cs[c_up] = dict(cs[c_up], state="bound", order=o1)
del cs[c_del]
cs["YS-NEW1-NEW1-NEW1"] = {"state": "active", "batch": "新批"}
stamp = dict(st2.conn().execute("SELECT code, updated FROM codes"))
time.sleep(0.02)
st2.codes_save(cs)
stamp2 = dict(st2.conn().execute("SELECT code, updated FROM codes"))
changed = {k for k in stamp2 if stamp2[k] != stamp.get(k)}
check("写回:只动了改过 / 新加的两行,删掉的那行没了", changed == {c_up, "YS-NEW1-NEW1-NEW1"} and c_del not in stamp2,
"变动的行:%s" % sorted(changed))
check("写回:能查的列跟着变(state=bound / order_id)", c_up in st2.codes_where(state="bound", order_id=o1))
# ================================================================== 5. 订单清理
victim = list(orders0)[0]
st2.order_purge(victim)
check("清理:清掉的单对外当它不存在", st2.order_get(victim) is None and victim not in st2.order_ids())
check("清理:行还在(记账用),单号不会被再发出去", st2.order_known(victim)
and any(m["oid"] == victim for m in st2.orders(include_purged=True)))
st2.order_put(victim, orders0[victim])
check("清理:同号重新写入会复活(恢复误删用)", st2.order_get(victim) is not None)
st2.order_drop("YSNOPE00")
check("清理:删不存在的单不报错", True)
# ================================================================== 6. 事务回滚
n_before = len(st2.codes_all())
try:
with st2.tx() as c:
c.execute("INSERT INTO codes (code, state, data, updated) VALUES ('YS-HALF-HALF-HALF','active','{}',0)")
raise RuntimeError("中途出错(模拟断电 / 异常)")
except RuntimeError:
pass
check("事务:中途出错整体回滚,不留半截", len(st2.codes_all()) == n_before and st2.code_get("YS-HALF-HALF-HALF") is None)
# ================================================================== 7. 导出 → 再导入,一模一样
EXP = tempfile.mkdtemp(prefix="ys-db-export-")
st2.export_legacy(EXP)
st3 = store.Store(EXP)
check("回退:导出的 JSON 再导入,卡密一模一样", st3.codes_all() == st2.codes_all())
check("回退:订单 / 账本 / 小块状态一模一样",
st3.orders() == st2.orders() and st3.ledger_all() == st2.ledger_all()
and all(st3.kv_get(k) == st2.kv_get(k) for k in store.KV_FILES))
check("回退:呼叫记录条数和内容一致", [dict(r, id=0) for r in st3.calls()] == [dict(r, id=0) for r in st2.calls()])
# ================================================================== 8. 备份 / 体检
bp = st2.backup()
b = sqlite3.connect(bp)
bn = b.execute("SELECT COUNT(*) FROM codes").fetchone()[0]
b.close()
check("备份:热备份能打开、行数一致", bn == len(st2.codes_all()), bp)
check("体检:integrity_check = ok", st2.check()[0] == "ok")
# ================================================================== 9. 服务器跑在迁移过来的老数据上
R4 = tempfile.mkdtemp(prefix="ys-db-server-")
codes4, orders4 = make_legacy(R4, n_codes=12, n_orders=6)
o4 = [o for o, m in orders4.items() if m["state"] == "done"][0]
b4 = [c for c, r in codes4.items() if r.get("state") == "bound"][0]
probe = r"""
import sys, json, threading, urllib.request
sys.path.insert(0, %(src)r)
import server as S
srv = S.ThreadingHTTPServer(("127.0.0.1", 0), S.H); srv.daemon_threads = True
threading.Thread(target=srv.serve_forever, daemon=True).start()
base = "http://127.0.0.1:%%d" %% srv.server_address[1]
def get(p):
try:
with urllib.request.urlopen(base + p, timeout=20) as r: return r.status, json.loads(r.read())
except urllib.error.HTTPError as e: return e.code, {}
out = {}
out["order"] = get("/api/order/%(oid)s?t=%(tok)s")
out["badtok"] = get("/api/order/%(oid)s?t=WRONGTOKEN0000")
out["code"] = S.code_info(%(code)r)
out["status"] = get("/api/status")
out["home_ips"] = S.HOME_IPS
out["waiting"] = [m["oid"] for m in S.list_orders(("waiting",))]
print(json.dumps(out, ensure_ascii=False))
srv.shutdown()
""" % {"src": SRC, "oid": o4, "tok": orders4[o4]["token"], "code": b4}
env = dict(os.environ, YS_ROOT=R4)
p = subprocess.run([sys.executable, "-c", probe], capture_output=True, text=True, env=env, cwd=SRC, timeout=120)
try:
res = json.loads(p.stdout.strip().splitlines()[-1])
except Exception:
res = {}
print(p.stdout[-800:], p.stderr[-1500:])
check("服务器:老订单直接能查(口令对 → 200)", (res.get("order") or [0])[0] == 200, str(res.get("order"))[:100])
check("服务器:口令错 → 404(和以前一样不承认这单)", (res.get("badtok") or [0])[0] == 404)
check("服务器:老卡密能认,带出它绑的单", (res.get("code") or {}).get("oid") == codes4[b4]["order"])
check("服务器:状态接口照常", (res.get("status") or [0])[0] == 200)
check("服务器:重启后还记得家里的出口 IP(从 home_ips.json 迁过来)", res.get("home_ips") == ["198.51.100.7"])
check("服务器:按状态列队列", sorted(res.get("waiting") or []) == sorted(o for o, m in orders4.items() if m["state"] == "waiting"))
for args, want in ((["db", "check"], "完整性:ok"), (["calls"], "10.0.0.1"),
(["ls", "waiting"], ""), (["stat"], "")):
q = subprocess.run([sys.executable, os.path.join(SRC, "admin.py")] + args, capture_output=True, text=True,
env=env, cwd=SRC, timeout=60)
check("admin.py %s 能跑" % " ".join(args), q.returncode == 0 and want in q.stdout, (q.stdout + q.stderr).strip()[-120:])
# ================================================================== 10. 并发
R5 = tempfile.mkdtemp(prefix="ys-db-conc-")
st5 = store.Store(R5)
def spam(k):
for i in range(50):
st5.call_add({"ts": "2026-10-05T12:00:%02d+08:00" % (i % 60), "ip": "t%d" % k, "order": "", "note": str(i)})
ths = [threading.Thread(target=spam, args=(k,)) for k in range(8)]
[t.start() for t in ths]
[t.join() for t in ths]
check("并发:8 个线程同时记呼叫,400 条一条不丢", len(st5.calls()) == 400, "%d 条" % len(st5.calls()))
writer = r"""
import sys; sys.path.insert(0, %r)
import store
s = store.Store(%r)
for i in range(300):
s.code_put("YS-P%%s-%%04d-AAAA" %% (sys.argv[1], i), {"state": "active", "batch": "proc" + sys.argv[1]})
""" % (SRC, R5)
ps = [subprocess.Popen([sys.executable, "-c", writer, x]) for x in ("A", "B")]
[p.wait(timeout=120) for p in ps]
check("并发:两个进程同时各写 300 张码,600 张一张不少", len(st5.codes_all()) == 600, "%d 张" % len(st5.codes_all()))
R7 = tempfile.mkdtemp(prefix="ys-db-race-")
make_legacy(R7, n_codes=20, n_orders=6)
opener = "import sys; sys.path.insert(0, %r); import store; store.Store(%r)" % (SRC, R7)
ps = [subprocess.Popen([sys.executable, "-c", opener]) for _ in range(3)]
[p.wait(timeout=120) for p in ps]
st7 = store.Store(R7)
check("并发:三个进程同时第一次启动,旧数据只导一次(呼叫记录不翻倍)",
len(st7.calls()) == 6 and len(st7.codes_all()) == 21, "呼叫 %d 条 · 卡密 %d 张" % (len(st7.calls()), len(st7.codes_all())))
shutil.rmtree(R7, ignore_errors=True)
# ================================================================== 11. 规模
R6 = tempfile.mkdtemp(prefix="ys-db-scale-")
make_legacy(R6, n_codes=5000, n_orders=2000)
t0 = time.time()
st6 = store.Store(R6)
t_imp = time.time() - t0
t0 = time.time()
for _ in range(20):
w = st6.orders(("waiting",))
t_q = (time.time() - t0) / 20
t0 = time.time()
for _ in range(20):
old = []
od = os.path.join(R6, "orders")
for oid in sorted(os.listdir(od)):
m = json.load(open(os.path.join(od, oid, "meta.json"), encoding="utf-8"))
if m.get("state") == "waiting":
old.append(m)
t_old = (time.time() - t0) / 20
check("规模:5000 张码 + 2000 单首次导入 < 10 秒", t_imp < 10, "%.2f 秒" % t_imp)
check("规模:按状态列队列比旧版(一单一单读文件)快", t_q < t_old and len(w) == len(old),
"数据库 %.1f ms / 旧版 %.1f ms(%d 单在排队)" % (t_q * 1000, t_old * 1000, len(w)))
# ================================================================== 汇总
for d in (R1, R2, EXP, R4, R5, R6):
shutil.rmtree(d, ignore_errors=True)
bad = [n for n, ok, _ in RESULTS if not ok]
print("\n%d 条,失败 %d 条" % (len(RESULTS), len(bad)))
for n in bad:
print(" ✗ " + n)
sys.exit(1 if bad else 0)
+97 -7
View File
@@ -36,7 +36,7 @@
| 进程 | 单进程,由 systemd 托管;内存上限被 cgroup 卡住(小机器上防它吃爆) | | 进程 | 单进程,由 systemd 托管;内存上限被 cgroup 卡住(小机器上防它吃爆) |
| 监听 | **只绑回环**,公网由 nginx 反代过去(后端自己不对外开端口) | | 监听 | **只绑回环**,公网由 nginx 反代过去(后端自己不对外开端口) |
| 账号 | 跑在专用非 root 用户下 | | 账号 | 跑在专用非 root 用户下 |
| 数据 | 全在本地文件 + 一个 SQLite(无外部服务) | | 数据 | **SQLite**(`<DATA_DIR>/ys.db`,标准库自带 `sqlite3`,无外部服务)+ 皮肤 / 成品图片文件。2026-10-05 接入,见第五节 |
| 规模 | 单机单进程,日单量个位数到几十 | | 规模 | 单机单进程,日单量个位数到几十 |
**为什么不用框架**:这台机器很小(1G 多内存),装一个 Web 框架 + 一堆传递依赖不划算, **为什么不用框架**:这台机器很小(1G 多内存),装一个 Web 框架 + 一堆传递依赖不划算,
@@ -51,8 +51,11 @@
| `server.py` | ~3100 | **全部服务端逻辑**:路由、订单状态机、卡密生命周期、限流、PNG 结构核验的调用方、爱发电回调、打包下载、小票生成 | | `server.py` | ~3100 | **全部服务端逻辑**:路由、订单状态机、卡密生命周期、限流、PNG 结构核验的调用方、爱发电回调、打包下载、小票生成 |
| `admin.py` | ~540 | 命令行管理工具:发卡密 / 看队列 / 重渲 / 清过期 / 审计被拦记录 | | `admin.py` | ~540 | 命令行管理工具:发卡密 / 看队列 / 重渲 / 清过期 / 审计被拦记录 |
| `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG | | `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG |
| `store.py` | ~400 | **数据层**(2026-10-05 新增):SQLite 建库 / 第一次启动自动导入旧 JSON / 存取 / 导出回旧格式 / 体检 / 热备份 |
| `tests/回执复现测试.py` | ~280 | 回归 + 漏洞复现(27 条,HTTP 层打接口) |
| `tests/数据库测试.py` | ~290 | 数据库专项(38 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
> 这三个文件是**自足**的:没有 import 本项目之外的模块。 > 这几个文件是**自足**的:没有 import 本项目之外的模块。**部署时 `store.py` 必须和 `server.py` 放在同一个目录**(`server.py` 直接 `import store`)。
--- ---
@@ -81,6 +84,15 @@
| POST | `/api/hb` `/api/claim` `/api/skin/<单号>` `/api/progress` `/api/finish` `/api/fail` | **渲染机** | 都要请求头里的 worker token | | POST | `/api/hb` `/api/claim` `/api/skin/<单号>` `/api/progress` `/api/finish` `/api/fail` | **渲染机** | 都要请求头里的 worker token |
| GET/POST | `/api/admin/*` | **本机后台面板** | 头里带 admin token **且**来源 IP 必须是家里出口 IP | | GET/POST | `/api/admin/*` | **本机后台面板** | 头里带 admin token **且**来源 IP 必须是家里出口 IP |
**2026-10-05 管理接口新增四个**(都在上面那两道门后面;**老接口的路径和字段一个没动**):
| 方法 | 路径 | 干什么 |
|---|---|---|
| GET | `/api/admin/calls?limit=` | 「呼叫店主」/ 反馈 / 部分失败 记录,新的在前;`open` = 还没处理的条数 |
| POST | `/api/admin/call-done` | `{id, undo?}` 把一条呼叫标成「处理过了」(只加 `handled` 字段,不碰 `notified`) |
| POST | `/api/admin/retry` | `{oid}` 渲染失败的单退回队列(等于 `admin.py retry`,只收 `failed` 状态的单) |
| GET | `/api/admin/codes?q=` | 原有接口**加了一个可选参数** `q`:按卡密 / 订单号 / 批次 / 平台模糊搜;不传和以前一样 |
### 支付回调的处理顺序(这段是重点,欢迎挑刺) ### 支付回调的处理顺序(这段是重点,欢迎挑刺)
``` ```
@@ -96,18 +108,96 @@
--- ---
## 五、数据形状(都是文件/JSON,没有数据库表) ## 五、数据(2026-10-05 起:SQLite)
> ⚠️ **数据格式变了,按第八节的规矩单独标出来**:卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 几块小状态
> 从 JSON 文件挪进了 `<DATA_DIR>/ys.db`。**接口路径、请求 / 响应字段都没变**,渲染机那份代码**不用动**。
### 5.1 装上就能用
1. 把 `store.py` 放到 `server.py` 旁边,照常重启服务。**什么都不用配、不用装**(`sqlite3` 是 Python 自带的)。
2. 第一次启动时自动:建库 → 如果 `<DATA_DIR>` 里有旧的 `codes.json` / `orders/*/meta.json` / 账本等,**一次性导进来**。
- 导入是一个事务:中途出错就整体回滚,下次启动再试。
- **旧文件原样留着,一个字节都不改**(测试里逐字节比对过)。
- 只导一次:库里记了「导过了」,以后重启不会重复导。
3. 自检:`python3 admin.py db check`,看到「完整性:ok」和每张表的行数就对了。
⚠️ 跑 `admin.py` 的账号要对 `<DATA_DIR>` **目录**有写权限(不只是对 `ys.db`):SQLite 的 WAL 模式会在旁边建 `ys.db-wal` / `ys.db-shm` 两个文件。
以前 `admin.py` 就要写 `codes.json`、`.lock`,权限照以前那样给就行。
### 5.2 库里有什么
| 表 | 原来在哪 | 一行是什么 | 能按什么查(有索引) |
|---|---|---|---|
| `codes` | `codes.json` | 一张卡密 | 状态、订单号、批次、平台、福利券批次 |
| `orders` | `orders/<单号>/meta.json` | 一单的信息 | 状态(只算没清理的单) |
| `pay_orders` | `payplatform-orders.json` | 一笔爱发电成交(按平台单号幂等) | 平台单号 |
| `calls` | `calls.jsonl` | 一条呼叫 / 反馈 / 部分失败 | 来源 IP + 时间(限频用) |
| `kv` | `gifts.json` / `heartbeat.json` / `home_ips.json` / `tpl_times.json` | 一块小状态 | 键名 |
每张表都是「几个能查的列 + 一列 `data`(整条记录的 JSON)」。上层代码拿到的**还是原来那个 dict**,加字段不用改表。
**还是文件、没进库的**:皮肤和成品图片(`orders/<单号>/` 目录还在)、`feedback/` 里的反馈图、
两把令牌、人手改的配置(`payplatform.json`、`payplatform-map.json`、`prices.json`、`payinfo.json`)、各种 `.log`。
**`calls.jsonl` 还会继续追加**:库是正本,但「呼叫店主」的手机通知是盯这个文件的(那段不在这份代码里),所以每条记录**同时**照旧写一行进去,通知不会断。
**清理过期订单**(`admin.py sweep`):文件照旧删掉;库里那一行**留着做账**,但之后对外当它不存在(`read_meta` 返回空),单号也不会再被发出去。
### 5.3 为什么换、换了有什么用
上一轮回执里修的竞态(一码两单、CLI 和服务器互相覆盖、账本丢记录、半截 JSON),根子都是「拿 JSON 文件当数据库」。换成 SQLite 之后:
| | 以前(JSON 文件) | 现在(SQLite) |
|---|---|---|
| 断电 / 进程被杀 | 可能留下半截或 0 字节的 `codes.json`(后来加了 fsync 才堵上) | 事务要么全写进去、要么全没写 |
| 改一张码 | 整个 `codes.json` 重写一遍 | 一个事务里只改有变化的那几行 |
| 列出排队的单 | 把每一单的 `meta.json` 都读一遍 | 走索引:2000 单时 **38 ms,以前 1238 ms**(测试第 11 节实测) |
| 两个进程同时写 | 靠 `.lock` 文件锁 | `.lock` 照旧保留,库本身再兜一层(WAL + 等锁 30 秒,不会报 locked) |
| 查账 / 统计 | 只能自己写脚本扫文件 | 直接 SQL;`admin.py db check` 按状态出数 |
| 备份 | 拷整个目录(拷的时候可能有半截写入) | `admin.py db backup` 在线热备份,服务不用停 |
代价:多一个 `store.py`;库文件不能直接用记事本改(要改用 `sqlite3` 命令行,或者先导出成 JSON 改完再导回)。
### 5.4 运维命令
| 命令 | 干什么 |
|---|---|
| `python3 admin.py db check` | 完整性检查 + 每张表几行 + 订单 / 卡密按状态的数 + 当初导入了多少 |
| `python3 admin.py db backup` | 在线热备份到 `<DATA_DIR>/backup/ys-<时间>.db`(600 权限) |
| `python3 admin.py db export [目录]` | 把库导回**旧版 JSON 格式**;不写目录 = 写回 `<DATA_DIR>`(会覆盖那几个旧文件) |
| `python3 store.py check / backup / export` | 同上(不用 `admin.py` 也能跑,要先设 `YS_ROOT`) |
### 5.5 回退到旧版
1. 停服务 → `python3 admin.py db export`(把库里的最新数据写回 `codes.json` / `meta.json` / 账本 …)
2. 换回旧版 `server.py` / `admin.py` → 启动。旧版只认 JSON 文件,`ys.db` 放着不碰也没关系。
3. 以后要再切回来:先删掉(或挪走)`ys.db`,新版启动时会从 JSON 重新导入。
测试第 7 节验证过:导出 → 再导入,卡密 / 订单 / 账本 / 呼叫 / 小状态**一模一样**。
### 5.6 测试
```
python3 tests/数据库测试.py <server.py 所在目录> # 38 条:数据库专项
python3 tests/回执复现测试.py <server.py 所在目录> # 27 条:回归 + 漏洞复现(现在跑在数据库上)
```
- 数据全是测试脚本**现编的**(假卡密、假订单、假呼叫,包括一行写坏的 `calls.jsonl`),建在系统临时目录,不碰 `<DATA_DIR>`。
- 交付副本里三个 URL 格式串被脱敏弄坏了(`http<WIN-PATH>`),要起服务器的那几节跑之前先换成能格式化的占位;线上原版直接跑。
- 2026-10-05 结果:**65 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
### 5.7 文件 / 目录(库以外的)
| 路径 | 内容 | | 路径 | 内容 |
|---|---| |---|---|
| `<DATA_DIR>/codes.json` | 卡密池:`{码: {state, platform, tpl, n_fix, n_free, n_max, lock_tpl, oid, order, batch}}` | | `<DATA_DIR>/ys.db`(+ `-wal` / `-shm`) | 上面那个库(640 权限) |
| `<DATA_DIR>/orders/<单号>/meta.json` | 订单:状态、皮肤数组、模板、金额、时间、条款留证、进度 |
| `<DATA_DIR>/orders/<单号>/skins/` | 买家皮肤原图(落盘前已过 PNG 结构核验并剥掉元数据块) | | `<DATA_DIR>/orders/<单号>/skins/` | 买家皮肤原图(落盘前已过 PNG 结构核验并剥掉元数据块) |
| `<DATA_DIR>/orders/<单号>/out/` | 成品(标准压缩 + 无压缩 两个版本/张) | | `<DATA_DIR>/orders/<单号>/out/` | 成品(标准压缩 + 无压缩 两个版本/张) |
| `<DATA_DIR>/worker_token`、`admin_token` | 两把**互不通用**的令牌(文件权限 600) | | `<DATA_DIR>/worker_token`、`admin_token` | 两把**互不通用**的令牌(文件权限 600) |
| `<DATA_DIR>/home_ips.json` | 渲染机心跳认出来的「家里的出口 IP」 | | `<DATA_DIR>/calls.jsonl` | 呼叫记录的**副本**(给手机通知读,正本在库里) |
| `<DATA_DIR>/calls.jsonl` | 「呼叫店主」记录 |
| `<DATA_DIR>/upload.log` 等 | 审计留痕 | | `<DATA_DIR>/upload.log` 等 | 审计留痕 |
| `<DATA_DIR>/codes.json`、`orders/*/meta.json` … | **旧数据**:导入之后就不再读写,留着当回退的底 |
### 卡密生命周期(**激活 ≠ 核销**,这是刻意分开的) ### 卡密生命周期(**激活 ≠ 核销**,这是刻意分开的)
+51
View File
@@ -331,3 +331,54 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
--- ---
*以上改动都还只在工作区,等你们(和 ywsabc2)看过再决定要不要合。* *以上改动都还只在工作区,等你们(和 ywsabc2)看过再决定要不要合。*
---
# 第二轮(2026-10-05 晚)· 接入数据库 + 管理接口补齐
> 上一轮第 2 节「中期:换 SQLite」这次做了。你们没给真实数据,所以测试全用现编的假数据;
> 设计目标是**换上就能用**:放好 `store.py` 重启即可,第一次启动自动建库并导入旧 JSON。
> 怎么装、怎么回退、怎么测,都写进了 `交接说明.md` 第五节。
### 改动 14 · 数据层换成 SQLite
```
文件 / 函数:新增 store.py;server.py 的 load_codes / save_codes(新)/ read_meta / write_meta / list_orders /
drop_order(新)/ purge_order(新)/ add_call(新)/ note_tpl_time / tpl_eta_sec / gift_batches /
heartbeat / hb / call / feedback / finish_upload 里写呼叫的地方 / 爱发电账本读写;
admin.py 的 calls / sweep,新增 db 子命令
为什么改:上一轮修的竞态根子都是「拿 JSON 文件当数据库」;锁补上了,但断电半截、整文件重写、
列队列要读遍所有 meta.json 这些还在
改成什么:卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态进 <DATA_DIR>/ys.db;
上层还是拿到原来的 dict,路由逻辑一行没动,原来的 LOCK 也照旧保留
⚠️ 有没有动接口路径 / 请求响应字段 / 数据格式:
接口路径、请求 / 响应字段:没动。
数据格式:**动了**(存储从 JSON 文件换成 SQLite)。第一次启动自动导入、旧文件不动,
`admin.py db export` 能原样导回旧格式。calls.jsonl 照旧追加(手机通知要读)。渲染机不用动。
你怎么验证的:tests/数据库测试.py 38 条(全新安装 / 迁移 / 重启不重导 / 多进程同时首启只导一次 / 只改变化的行 / 清理 / 回滚 /
导出再导入一致 / 热备份 / 服务器跑在迁移来的数据上 / 8 线程 + 2 进程并发 / 5000 码 2000 单规模);
tests/回执复现测试.py 27 条照旧全过(现在跑在库上)
```
### 改动 15 · 管理接口补四个(给新面板用)
```
文件 / 函数:server.py 的 admin_calls / admin_call_done / admin_retry(新);admin_codes 加可选参数 q
为什么改:面板上「渲染失败」只能写「喊苏达用 admin.py retry」;呼叫记录只能 ssh 上去看
改成什么:GET /api/admin/calls、POST /api/admin/call-done、POST /api/admin/retry(只收 failed 的单)、
GET /api/admin/codes?q=(不传 q 和以前一样)
⚠️ 有没有动接口:**新增**四个,老的路径 / 字段没改;都在原来的两道门(令牌 + 家里 IP)后面
你怎么验证的:假数据起真服务器 + 真面板逐个打:退回重渲成功、对非 failed 单拒绝;
不带令牌直接打 → 403;面板不带 PIN → 401
```
### 这轮没验证的
- 没在你们的真机器(1.6G 内存 + systemd MemoryMax)上跑过;库很小(几千行级别),按测试的内存占用不会有压力,但请部署后跑一次 `admin.py db check`。
- `admin.py` 用别的账号跑时的目录权限(WAL 要在 `<DATA_DIR>` 里建两个小文件),见交接说明 5.1。
### 第二轮自查修掉的三处(推送前审查)
- `add_call`:渲染机回传(`finish_upload`)的「部分失败」也调它;写库出错原来会把异常抛到回传接口 → 改成只记日志、`calls.jsonl` 照写。
- `store.import_legacy`:服务器和 `admin.py` 同时第一次启动会各导一遍(呼叫记录翻倍)→ 在写事务里再判一次「导过没有」。测试加了一条(三个进程同时首启)。
- `admin_call_done`:撤销「处理过了」时 `handled_at` 没清 → 一起清掉。
+319 -228
View File
@@ -2,200 +2,241 @@
<html lang="zh-CN"> <html lang="zh-CN">
<head> <head>
<meta charset="UTF-8"> <meta charset="UTF-8">
<meta name="viewport" content="width=device-width,initial-scale=1"> <meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
<title>本机开单 · 金钻工坊(平台单)</title> <title>本机开单 · 金钻工坊(平台单)</title>
<style> <style>
:root{ /* 本机开单(2026-10-05 重写:跟 2026 版网站 / 开单后台同一套样子 —— 白光 + 毛玻璃卡片 + MC 方块按钮)
--bg:#08090a; --surface:rgba(255,255,255,.02); --line:rgba(255,255,255,.08); --line-soft:rgba(255,255,255,.05); 本页跑在家里电脑上,引不到网站的 css / 字体,颜色值照网站复制一份(改值要两边一起改)。
--txt:#f7f8f8; --txt-2:#d0d6e0; --txt-3:#8a8f98; --txt-4:#62666d; 布局:电脑上左边「皮肤 + 质检」、右边「模板 + 分辨率 + 开始」;出图结果在下面整行。手机上从上往下排。 */
--acc:#3ecf8e; --acc-hi:#4ade9f; --acc-hover:#37b87f; :root{--bg:#F5F7FB;--txt:#1E2440;--txt-2:#454B6B;--txt-3:#5E6482;--dim:#7E849C;
--ok:#3ecf8e; --ok-t:#5fd8a2; --warn:#d29922; --warn-t:#e0b355; --bad:#da3633; --bad-t:#f08a7c; --line:rgba(30,36,64,.13);--line-soft:rgba(30,36,64,.08);
} --glass:linear-gradient(160deg,rgba(255,255,255,.9),rgba(255,255,255,.7));
--panel-shadow:inset 0 1px 0 #fff,0 22px 44px -28px rgba(100,110,190,.38);
/* ↓ 统一动效 token(金钻系四界面同值;本页跑在家里电脑上,引不到 /assets/tokens.css, --mc:#3C8527;--mc-hi:#5BAA3C;--mc-lo:#1D4D13;--ok-t:#2F6E1F;
照 tokens.css 复制同一份值 —— 改值要两边一起改) */ --stone:#F3F4F6;--stone-lo:#B4B7BE;--stone-edge:#9EA2AA;
:root{ --bad-t:#B33A2E;--warn-t:#9A6A0C;
--ease-out:cubic-bezier(.23,1,.32,1); --ease-in-out:cubic-bezier(.77,0,.175,1); --ease:cubic-bezier(.23,1,.32,1);
--d-press:100ms; --d-hover:150ms; --d-pop:200ms; --d-modal:240ms; --d-exit:180ms; --font:'OPPO Sans',system-ui,-apple-system,"PingFang SC","Microsoft YaHei","Segoe UI",sans-serif;
} --mono:ui-monospace,Consolas,"SF Mono",Menlo,monospace;color-scheme:light}
*{box-sizing:border-box} *{box-sizing:border-box}
body{margin:0;background:var(--bg);color:var(--txt-2);position:relative;padding:0 0 60px; [hidden]{display:none!important}
font:15px/1.7 'OPPO Sans',system-ui,-apple-system,'PingFang SC','Microsoft YaHei',sans-serif; body{margin:0;min-height:100vh;background:var(--bg);color:var(--txt);font:14.5px/1.65 var(--font);-webkit-font-smoothing:antialiased}
-webkit-font-smoothing:antialiased} body::before{content:"";position:fixed;inset:0;z-index:-1;pointer-events:none;background:
body::before{content:"";position:fixed;inset:0 0 auto 0;height:40vh;pointer-events:none; radial-gradient(40% 34% at 6% 0%,rgba(150,215,255,.30),transparent 70%),radial-gradient(36% 30% at 100% 8%,rgba(255,176,204,.22),transparent 70%),
background:radial-gradient(70% 100% at 50% 0%,rgba(62,207,142,.05),transparent 72%)} radial-gradient(48% 38% at 72% 100%,rgba(255,214,150,.22),transparent 70%),radial-gradient(42% 36% at 0% 72%,rgba(170,235,200,.22),transparent 70%)}
.wrap{max-width:860px;margin:0 auto;padding:0 20px;position:relative;z-index:1} button,input{font:inherit;color:inherit}
header{border-bottom:1px solid var(--line-soft);background:rgba(8,9,10,.86);position:sticky;top:0;z-index:9; a{color:var(--mc);font-weight:700;text-decoration:none}
backdrop-filter:blur(12px)} a:hover{text-decoration:underline}
.hd{display:flex;align-items:center;gap:12px;padding:15px 0 13px;flex-wrap:wrap}
h1{font-size:16px;margin:0;font-weight:700;color:var(--txt);letter-spacing:-.2px} /* ---------- 顶栏 ---------- */
.hd .sub{font-size:12px;color:var(--txt-4)} header{position:sticky;top:0;z-index:20;background:rgba(255,255,255,.74);border-bottom:1px solid rgba(255,255,255,.9);box-shadow:0 10px 30px -24px rgba(80,90,170,.45);
.badge{margin-left:auto;font-size:12px;padding:4px 11px;border:1px solid var(--line-soft); -webkit-backdrop-filter:blur(14px) saturate(1.4);backdrop-filter:blur(14px) saturate(1.4)}
border-radius:9999px;color:var(--txt-3);white-space:nowrap} .hd{max-width:1180px;margin:0 auto;padding:12px 20px;display:flex;align-items:center;gap:12px}
.card{background:var(--surface);border:1px solid var(--line-soft);border-radius:8px;padding:22px;margin:16px 0} .hd h1{margin:0;font-size:17px;letter-spacing:.02em}
h2{font-size:16px;margin:0 0 4px;font-weight:700;color:var(--txt)} .hd .sub{font-size:12px;color:var(--dim)}
.hint{font-size:13px;color:var(--txt-4);margin:5px 0 18px;line-height:1.8} .badge{margin-left:auto;display:inline-flex;align-items:center;height:30px;padding:0 11px;border-radius:4px;font-size:12.5px;font-weight:700;white-space:nowrap;
.drop{border:1px dashed rgba(255,255,255,.14);border-radius:8px;padding:32px 18px;text-align:center; background:rgba(255,255,255,.85);border:1px solid var(--line-soft);color:var(--txt-3)}
cursor:pointer;transition:border-color var(--d-pop) var(--ease-out),background-color var(--d-pop) var(--ease-out)} .badge.ok{color:var(--ok-t);background:rgba(91,170,60,.1);border-color:rgba(60,133,39,.25)}
.drop:hover,.drop.over{border-color:rgba(62,207,142,.55);background:rgba(62,207,142,.05)} .badge.bad{color:var(--bad-t);background:rgba(210,72,58,.08);border-color:rgba(210,72,58,.25)}
.drop .big{font-size:14.5px;font-weight:700;color:var(--txt-2);margin-bottom:5px}
.drop .small{font-size:12.5px;color:var(--txt-4)} /* ---------- 骨架 ---------- */
.split{display:grid;gap:20px} .wrap{max-width:1180px;margin:0 auto;padding:20px}
@media(min-width:680px){.split{grid-template-columns:200px 1fr;align-items:start}} .cols{display:grid;grid-template-columns:minmax(0,5fr) minmax(0,7fr);gap:18px;align-items:start}
.preview{border:1px solid var(--line-soft);border-radius:8px;padding:12px;text-align:center} .card{background:var(--glass);border:2px solid rgba(255,255,255,.95);border-radius:8px;box-shadow:var(--panel-shadow);padding:20px;margin-bottom:18px}
.preview canvas{width:100%;max-width:176px;image-rendering:pixelated;border-radius:4px; .step{display:flex;align-items:center;gap:10px;margin:0 0 4px}
background:linear-gradient(45deg,#141618 25%,transparent 25%,transparent 75%,#141618 75%), .step .num{display:inline-grid;place-items:center;width:30px;height:30px;flex:none;border-radius:4px;background:var(--stone);border:2px solid var(--stone-edge);
linear-gradient(45deg,#141618 25%,#0d0f10 25%,#0d0f10 75%,#141618 75%); font:800 14px/1 var(--mono);box-shadow:inset 0 2px 0 #fff,inset 0 -3px 0 var(--stone-lo)}
background-size:11px 11px;background-position:0 0,5.5px 5.5px} .step.done .num{background:var(--mc);border-color:var(--mc-lo);color:#fff;box-shadow:inset 0 2px 0 var(--mc-hi),inset 0 -3px 0 var(--mc-lo)}
.preview .fn{font-size:11.5px;color:var(--txt-4);margin-top:10px;word-break:break-all} .step h2{margin:0;font-size:17px}
.item{display:flex;gap:12px;padding:12px 14px;border-radius:6px;font-size:13.5px;background:rgba(255,255,255,.015);margin-bottom:8px} .hint{font-size:13px;color:var(--txt-3);margin:4px 0 16px;line-height:1.75}
.item.warn{background:rgba(210,153,34,.055)} .hint b{color:var(--txt-2)}
.item.bad{background:rgba(218,54,51,.055)} .lab{font-size:12.5px;font-weight:700;color:var(--txt-2);margin:18px 0 8px}
.tag{display:inline-flex;align-items:center;gap:7px;font-size:12px;color:var(--txt-4);flex:none;margin-top:1px;white-space:nowrap} .lab .h{font-weight:400;color:var(--dim)}
.tag::before{content:"";width:6px;height:6px;border-radius:50%;background:currentColor}
.item.ok .tag::before{background:var(--ok)} /* ---------- 按钮:绿 = 主,石头白 = 次 ---------- */
.item.warn .tag::before{background:var(--warn)} .btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;height:42px;padding:0 16px 3px;border-radius:4px;cursor:pointer;white-space:nowrap;
.item.bad .tag::before{background:var(--bad)} border:2px solid var(--stone-edge);background:var(--stone);color:var(--txt);font-weight:700;font-size:14px;
box-shadow:inset 0 2px 0 #fff,inset 0 -4px 0 var(--stone-lo);transition:transform .08s linear,box-shadow .08s linear,background .12s}
.btn:hover:not(:disabled){background:#fff}
.btn:active:not(:disabled){transform:translateY(2px);box-shadow:inset 0 2px 0 #fff,inset 0 -2px 0 var(--stone-lo)}
.btn.pri{border-color:var(--mc-lo);background:var(--mc);color:#fff;box-shadow:inset 0 2px 0 var(--mc-hi),inset 0 -4px 0 var(--mc-lo)}
.btn.pri:hover:not(:disabled){background:#469A2E}
.btn.pri:active:not(:disabled){box-shadow:inset 0 2px 0 var(--mc-hi),inset 0 -2px 0 var(--mc-lo)}
.btn.big{height:48px;font-size:15.5px;flex:1;min-width:200px}
.btn:disabled{opacity:.45;cursor:not-allowed;filter:saturate(.4)}
.btn:focus-visible,.tpl:focus-visible,.seg button:focus-visible,.drop:focus-visible{outline:2px solid var(--mc-hi);outline-offset:2px}
/* ---------- 1 · 皮肤 ---------- */
.drop{display:block;width:100%;border:2px dashed rgba(60,133,39,.35);border-radius:8px;padding:30px 16px;text-align:center;cursor:pointer;background:rgba(255,255,255,.6);
transition:border-color .15s,background .15s}
.drop:hover,.drop.over{border-color:var(--mc);background:rgba(91,170,60,.07)}
.drop svg{display:block;margin:0 auto 10px;width:30px;height:30px;color:var(--mc)}
.drop .big{font-size:15px;font-weight:700;color:var(--txt);margin-bottom:3px}
.drop .small{font-size:12.5px;color:var(--dim)}
.drop.has{padding:14px 16px}
.drop.has svg{display:none}
.skin{display:grid;grid-template-columns:132px minmax(0,1fr);gap:16px;align-items:start;margin-top:16px}
.preview{padding:10px;border-radius:8px;background:#fff;border:1px solid var(--line-soft);text-align:center}
.preview canvas{width:100%;display:block;image-rendering:pixelated;border-radius:4px;
background:conic-gradient(#E9ECF2 25%,#fff 0 50%,#E9ECF2 0 75%,#fff 0) 0 0/12px 12px}
.preview .fn{font-size:11.5px;color:var(--dim);margin-top:8px;word-break:break-all;line-height:1.5}
#report{display:flex;flex-direction:column;gap:8px}
.item{display:flex;gap:10px;align-items:flex-start;padding:10px 12px;border-radius:6px;background:rgba(255,255,255,.85);border:1px solid var(--line-soft);font-size:13.5px}
.item.warn{background:rgba(255,248,230,.9);border-color:rgba(214,160,40,.3)}
.item.bad{background:rgba(255,240,238,.92);border-color:rgba(210,72,58,.3)}
.tag{flex:none;display:inline-flex;align-items:center;height:22px;padding:0 8px;border-radius:4px;font-size:12px;font-weight:700;white-space:nowrap;
background:rgba(91,170,60,.12);color:var(--ok-t)}
.item.warn .tag{background:rgba(214,160,40,.18);color:var(--warn-t)}
.item.bad .tag{background:rgba(210,72,58,.12);color:var(--bad-t)}
.bd{flex:1;min-width:0} .bd{flex:1;min-width:0}
.t{font-weight:700;color:var(--txt-2)} .bd .t{font-weight:700;color:var(--txt)}
.d{font-size:12.5px;color:var(--txt-4);margin-top:5px;line-height:1.75} .bd .d{font-size:12.5px;color:var(--txt-3);margin-top:2px;line-height:1.7}
.tpls{display:grid;gap:12px;grid-template-columns:repeat(auto-fill,minmax(150px,1fr))} details.terms{margin-top:16px;font-size:12.5px;color:var(--txt-3)}
.tpl{border:1px solid var(--line);border-radius:8px;cursor:pointer;position:relative;overflow:hidden; details.terms summary{cursor:pointer;color:var(--mc);font-weight:700}
background:rgba(255,255,255,.015);transition:.15s} details.terms pre{white-space:pre-wrap;font:12.5px/1.8 var(--font);margin:8px 0 0;padding:10px 12px;border-radius:6px;background:rgba(255,255,255,.8);border:1px solid var(--line-soft)}
.tpl:hover{border-color:rgba(255,255,255,.16);background:rgba(255,255,255,.03)} .copyterms{margin-top:8px}
.tpl.sel{border-color:var(--acc);box-shadow:inset 0 0 0 1px var(--acc)}
.tpl .thumb{aspect-ratio:1/1;display:flex;align-items:center;justify-content:center;background:#0d0f10; /* ---------- 2 · 模板 ---------- */
border-bottom:1px solid var(--line-soft);position:relative} .tpls{display:grid;gap:10px;grid-template-columns:repeat(auto-fill,minmax(138px,1fr))}
.tpl .thumb::before{content:"";position:absolute;top:0;left:0;right:0;height:2px;background:var(--tone,#8a8f98);opacity:.5} .tpl{position:relative;display:block;padding:0;text-align:left;border-radius:8px;border:2px solid rgba(255,255,255,.95);background:#fff;cursor:pointer;overflow:hidden;
.tpl .thumb svg{color:var(--tone,#8a8f98)} box-shadow:0 12px 24px -20px rgba(80,90,170,.55);transition:transform .15s var(--ease),border-color .15s,box-shadow .15s}
.tpl .meta{padding:11px 12px} .tpl:hover{transform:translateY(-2px)}
.tpl .n{font-size:13px;font-weight:700;color:var(--txt-2)} .tpl.sel{border-color:var(--mc);box-shadow:0 0 0 3px rgba(91,170,60,.22),0 12px 24px -20px rgba(80,90,170,.55)}
.tpl .s{font-size:11.5px;color:var(--txt-4);margin-top:3px} .tpl .thumb{position:relative;aspect-ratio:4/3;display:grid;place-items:center;background:#EEF1F7;
.tpl .pick{position:absolute;top:9px;right:9px;width:18px;height:18px;border-radius:4px;font-size:11px; background:radial-gradient(80% 90% at 30% 20%,#fff,transparent 70%),linear-gradient(150deg,color-mix(in srgb,var(--tone) 22%,#fff),color-mix(in srgb,var(--tone) 48%,#fff))}
border:1px solid rgba(255,255,255,.2);background:rgba(8,9,10,.7);display:flex;align-items:center; .tpl .thumb svg{width:40px;height:40px;color:var(--tone);opacity:.85}
justify-content:center;color:transparent} .tpl .meta{padding:9px 11px 10px}
.tpl.sel .pick{background:var(--acc);border-color:var(--acc);color:#07150e} .tpl .n{font-size:13.5px;font-weight:700;color:var(--txt)}
input.t{width:100%;background:rgba(255,255,255,.035);border:1px solid rgba(255,255,255,.13); .tpl .s{font-size:11.5px;color:var(--dim);margin-top:1px}
border-radius:6px;color:var(--txt);padding:12px 14px;font:13.5px/1.6 inherit} .tpl .pick{position:absolute;top:8px;right:8px;width:22px;height:22px;display:grid;place-items:center;border-radius:4px;border:2px solid rgba(30,36,64,.18);background:rgba(255,255,255,.9);color:transparent;font-size:13px;font-weight:800}
input.t:focus{outline:none;border-color:var(--acc-hi);background:rgba(62,207,142,.05)} .tpl.sel .pick{background:var(--mc);border-color:var(--mc-lo);color:#fff}
input.t::placeholder{color:#7c8290} .tpl .ord{position:absolute;top:8px;left:8px;min-width:22px;height:22px;padding:0 6px;border-radius:4px;background:var(--txt);color:#fff;font:700 12px/22px var(--mono);text-align:center}
.btns{display:flex;gap:10px;margin-top:18px;flex-wrap:wrap} .tpl:not(.sel) .ord{display:none}
button{font:inherit;border-radius:6px;padding:11px 18px;border:1px solid var(--line); .seg{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:6px}
background-color:rgba(255,255,255,.02);color:var(--txt-2);cursor:pointer;font-size:13.5px;font-weight:700; .seg button{min-height:52px;padding:6px 8px;border-radius:4px;border:2px solid var(--line);background:rgba(255,255,255,.75);cursor:pointer;text-align:center;
transition:border-color var(--d-hover) var(--ease-out),background-color var(--d-hover) var(--ease-out), font:800 15px/1.2 var(--mono);color:var(--txt-2);transition:border-color .12s,background .12s,color .12s}
color var(--d-hover) var(--ease-out),transform var(--d-press) var(--ease-out)} .seg button small{display:block;margin-top:3px;font:400 11.5px/1.3 var(--font);color:var(--dim)}
button:active:not(:disabled){transform:scale(.985)} .seg button:hover{background:#fff}
button:hover:not(:disabled){background:rgba(255,255,255,.05);border-color:rgba(255,255,255,.14);color:var(--txt)} .seg button.on{border-color:var(--mc);background:rgba(91,170,60,.1);color:var(--ok-t)}
button.pri{background:var(--acc);border-color:var(--acc);color:#07150e;flex:1;min-width:180px} input.t{width:100%;height:42px;padding:0 12px;border-radius:4px;border:2px solid var(--line);background:#fff;outline:none;transition:border-color .12s}
button.pri:hover:not(:disabled){background:var(--acc-hover);border-color:var(--acc-hover)} input.t:focus{border-color:var(--mc)}
button:disabled{opacity:.32;cursor:not-allowed} input.t::placeholder{color:#9AA0B4}
.warnbar{padding:13px 15px;border-radius:6px;font-size:13px;background:rgba(210,153,34,.08); .sum{margin-top:18px;padding:11px 13px;border-radius:6px;background:rgba(91,170,60,.08);border:1px solid rgba(60,133,39,.2);font-size:13px;color:var(--txt-2);line-height:1.7}
border:1px solid rgba(210,153,34,.24);color:var(--txt-3);margin-bottom:14px;line-height:1.75} .sum b{color:var(--ok-t)}
.errbar{padding:13px 15px;border-radius:6px;font-size:13px;background:rgba(218,54,51,.08); .sum.idle{background:rgba(30,36,64,.04);border-color:var(--line-soft);color:var(--dim)}
border:1px solid rgba(218,54,51,.24);color:var(--txt-3);margin:14px 0;line-height:1.75;white-space:pre-wrap} .btns{display:flex;gap:10px;margin-top:14px;flex-wrap:wrap}
.bar{height:3px;border-radius:2px;background:rgba(255,255,255,.07);overflow:hidden;margin:16px 0 10px} .prog{margin-top:16px}
.bar i{display:block;height:100%;background:var(--acc);width:0;transition:width .4s var(--ease-out)} .bar{height:10px;border-radius:3px;background:rgba(30,36,64,.08);overflow:hidden;box-shadow:inset 0 1px 2px rgba(30,36,64,.12)}
.res{display:grid;gap:14px;grid-template-columns:repeat(auto-fill,minmax(190px,1fr));margin-top:6px} .bar i{display:block;height:100%;width:0;background:repeating-linear-gradient(90deg,var(--mc) 0 14px,var(--mc-hi) 14px 16px);transition:width .4s var(--ease)}
.res .one{border:1px solid var(--line);border-radius:8px;overflow:hidden} .prog .hint{margin:8px 0 0}
.res img{width:100%;display:block;background:#0d0f10}
.res .cap{padding:10px 12px;font-size:12px;color:var(--txt-4)} /* ---------- 3 · 出图 ---------- */
.res .cap b{color:var(--txt-2);font-size:13px;display:block;margin-bottom:3px} .res{display:grid;gap:14px;grid-template-columns:repeat(auto-fill,minmax(210px,1fr))}
.res .dls{margin-top:7px;line-height:2} .res .one{border-radius:8px;overflow:hidden;background:#fff;border:2px solid rgba(255,255,255,.95);box-shadow:0 14px 28px -22px rgba(80,90,170,.55)}
.res a{color:var(--acc-hi);text-decoration:none;font-size:12.5px} .res img{width:100%;display:block;aspect-ratio:1/1;object-fit:cover;background:#EEF1F6}
footer{text-align:center;font-size:11.5px;color:var(--txt-4);padding:34px 20px 0;line-height:2} .res .cap{padding:10px 12px 12px;font-size:12px;color:var(--dim)}
.toast{position:fixed;left:50%;bottom:30px;transform:translate(-50%,12px);opacity:0;z-index:90; .res .cap b{display:block;font-size:14px;color:var(--txt);margin-bottom:1px}
background:#16181b;border:1px solid var(--line);border-radius:6px;padding:11px 17px;font-size:13.5px; .res .dls{display:flex;gap:6px;flex-wrap:wrap;margin-top:8px}
color:var(--txt-2);pointer-events:none;max-width:88vw; .res .dls a{display:inline-flex;align-items:center;height:30px;padding:0 10px 2px;border-radius:4px;border:2px solid var(--stone-edge);background:var(--stone);color:var(--txt);font-size:12.5px;
/* 2026-10-02 统一:toast 180ms --ease-out(原 .2s 内建 ease) */ box-shadow:inset 0 2px 0 #fff,inset 0 -3px 0 var(--stone-lo);text-decoration:none}
transition:opacity var(--d-exit) var(--ease-out),transform var(--d-exit) var(--ease-out)} .res .dls a:hover{background:#fff}
.warnbar,.errbar{padding:12px 14px;border-radius:6px;font-size:13.5px;line-height:1.75;margin-bottom:16px}
.warnbar{background:rgba(255,248,230,.95);border:1px solid rgba(214,160,40,.35);color:var(--warn-t)}
.errbar{background:rgba(255,240,238,.95);border:1px solid rgba(210,72,58,.3);color:var(--bad-t);white-space:pre-wrap;grid-column:1/-1}
footer{text-align:center;font-size:12px;color:var(--dim);padding:10px 20px 36px;line-height:2}
footer a{color:var(--txt-3);font-weight:400}
.toast{position:fixed;left:50%;bottom:28px;z-index:90;max-width:min(92vw,520px);padding:10px 16px;border-radius:6px;background:#1E2440;color:#fff;font-size:13.5px;
opacity:0;transform:translate(-50%,10px);pointer-events:none;transition:opacity .18s var(--ease),transform .18s var(--ease)}
.toast.show{opacity:1;transform:translate(-50%,0)} .toast.show{opacity:1;transform:translate(-50%,0)}
/* ---------- 动效降级:prefers-reduced-motion(2026-10-02 补,原来完全没有)---------- */ @media (max-width:900px){
@media (prefers-reduced-motion:reduce){ .cols{grid-template-columns:minmax(0,1fr)}
*{animation-duration:1ms!important;animation-iteration-count:1!important} .hd{padding:10px 14px}.hd .sub{display:none}
.toast,.toast.show{transform:translate(-50%,0)} .wrap{padding:14px 12px}
button:active:not(:disabled){transform:none} .card{padding:16px 14px}
.seg{grid-template-columns:repeat(2,minmax(0,1fr))}
.skin{grid-template-columns:minmax(0,1fr);gap:10px}
.preview{display:flex;align-items:center;gap:12px;text-align:left}
.preview canvas{width:72px;flex:none}
.preview .fn{margin:0}
} }
@media (prefers-reduced-motion:reduce){.toast{transition:none}.btn:active:not(:disabled){transform:none}.tpl:hover{transform:none}}
</style> </style>
</head> </head>
<body> <body>
<header><div class="wrap hd"> <header><div class="hd">
<svg width="26" height="26" viewBox="0 0 24 24" aria-hidden="true"><path fill="#5BAA3C" d="M6 3h12l4 6-10 12L2 9z"/><path fill="#3C8527" d="M2 9h20L12 21z"/><path fill="#9FE07A" d="M6 3l3 6h6l3-6z"/></svg>
<h1>本机开单</h1> <h1>本机开单</h1>
<span class="sub">平台单 · 只在这台电脑上能打开</span> <span class="sub">平台单 · 只在这台电脑上能打开 · 不联网、不要卡密</span>
<span class="badge" id="health">体检中…</span> <span class="badge" id="health">体检中…</span>
</div></header> </div></header>
<div class="wrap"> <div class="wrap">
<div id="syswarn"></div> <div id="syswarn"></div>
<div class="card"> <div class="cols">
<h2>1 · 皮肤</h2> <div class="card" id="card1">
<p class="hint">把买家发的皮肤图拖进来,或点一下选。质检规则和网页版是同一份代码。</p> <div class="step" id="st1"><span class="num">1</span><h2>皮肤</h2></div>
<details style="margin:10px 0 0;font-size:12.5px;color:var(--dim)"> <p class="hint">把买家发的皮肤图拖进来、点一下选,或者直接 Ctrl+V 粘贴。质检规则和网页版是同一份代码。</p>
<summary style="cursor:pointer">发给买家的说明(可直接复制)</summary> <button type="button" class="drop" id="drop">
<pre style="white-space:pre-wrap;font:12px/1.7 inherit;margin:9px 0 0;padding:10px 11px; <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M12 15V4"/><path d="M8 8l4-4 4 4"/><path d="M4 15v3a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-3"/></svg>
border-left:2px solid var(--line);background:rgba(255,255,255,.02);border-radius:0 6px 6px 0">只提供渲染服务,不对皮肤内容与渲染结果作合规担保。 <div class="big" id="dropBig">点击选择皮肤文件</div>
<div class="small">或把 .png 拖到这里 / 直接粘贴图片</div>
</button>
<input type="file" id="file" accept="image/png" hidden>
<div id="pvwrap" hidden>
<div class="skin">
<div class="preview"><canvas id="pv" width="64" height="64"></canvas><div class="fn" id="pvName"></div></div>
<div id="report"></div>
</div>
</div>
<details class="terms">
<summary>发给买家的说明(可直接复制)</summary>
<pre id="termsTxt">只提供渲染服务,不对皮肤内容与渲染结果作合规担保。
皮肤由买家自行提供,其内容合法性由提供者负责; 皮肤由买家自行提供,其内容合法性由提供者负责;
因皮肤内容(含夹带数据、隐藏信息、违规图案)产生的任何后果,由提供者承担。 因皮肤内容(含夹带数据、隐藏信息、违规图案)产生的任何后果,由提供者承担。
模板质量问题由金钻负责维护修复,非质量问题不予重做。 模板质量问题由金钻负责维护修复,非质量问题不予重做。
一经发现违法内容,将立即停止服务、删除相关文件、拒绝后续接单。</pre> 一经发现违法内容,将立即停止服务、删除相关文件、拒绝后续接单。</pre>
</details> <button type="button" class="btn copyterms" id="copyTerms" style="height:34px;font-size:13px">复制这段话</button>
<div class="drop" id="drop"> </details>
<svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6"
stroke-linecap="round" stroke-linejoin="round" style="display:block;margin:0 auto 12px;color:var(--txt-3)">
<path d="M12 15V4"/><path d="M8 8l4-4 4 4"/><path d="M4 15v3a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-3"/></svg>
<div class="big">点击选择皮肤文件</div>
<div class="small">或把 .png 拖到这里 / 直接粘贴图片</div>
</div> </div>
<input type="file" id="file" accept="image/png" hidden>
<div id="pvwrap" style="display:none;margin-top:18px"> <div class="card" id="card2">
<div class="split"> <div class="step" id="st2"><span class="num">2</span><h2>模板</h2></div>
<div class="preview"><canvas id="pv" width="64" height="64"></canvas><div class="fn" id="pvName"></div></div> <p class="hint">勾几个就出几张,按勾的顺序出。一次渲一张,不会把机器顶满。</p>
<div id="report"></div> <div class="tpls" id="tpls"></div>
<div class="lab">出图分辨率 <span class="h">默认 1000 = 网易我的世界头图标准,文件名不带数字;换别的才写进文件名(如 飞跃樱花林2048.png)</span></div>
<div class="seg" id="resSeg"></div>
<div class="lab">买家备注 <span class="h">(选填,记进留档,比如闲鱼订单号 / 昵称)</span></div>
<input class="t" id="note" placeholder="例:闲鱼 3829… / 小明">
<div class="sum idle" id="sum">先选皮肤、勾模板。</div>
<div class="btns">
<button type="button" class="btn pri big" id="go" disabled>开始渲染</button>
<button type="button" class="btn" id="clear">清空</button>
</div>
<div class="prog" id="progWrap" hidden>
<div class="bar"><i id="bar"></i></div>
<div class="hint" id="progTxt"></div>
</div> </div>
</div> </div>
</div> </div>
<div class="card" id="card2"> <div class="card" id="card3" hidden>
<h2>2 · 模板</h2> <div class="step done"><span class="num">3</span><h2>出图</h2></div>
<p class="hint">勾几个就出几张。一次渲一张,不会把机器顶满。</p> <p class="hint"><span id="resHint"></span> 每张模板出<b>两张</b>:标准压缩(发预览 / 常规交付)+ 无压缩 16bit(客户要高清时给),两张都发过去。</p>
<div class="tpls" id="tpls"></div>
<div style="margin-top:18px">
<div class="hint" style="margin:0 0 9px">出图分辨率 —— 越高越慢。
<b style="color:var(--txt-3)">默认 1000 是网易我的世界头图的标准分辨率</b>,文件名不带数字;
换别的分辨率才写进文件名(如 飞跃樱花林2048.png)</div>
<div class="seg" id="resSeg"></div>
</div>
<div style="margin-top:16px">
<input class="t" id="note" placeholder="买家备注(选填,会记进留档,比如闲鱼订单号 / 昵称)">
</div>
<div class="btns">
<button class="pri" id="go" disabled>开始渲染</button>
<button class="ghost" id="clear">清空</button>
</div>
<div id="progWrap" style="display:none">
<div class="bar"><i id="bar"></i></div>
<div class="hint" id="progTxt" style="margin:0"></div>
</div>
</div>
<div class="card" id="card3" style="display:none">
<h2>3 · 出图</h2>
<p class="hint" id="resHint"></p>
<p class="hint" style="margin-top:-6px">每张模板出<b style="color:var(--txt-3)">两张</b>:标准压缩(发预览/常规交付)+ 无压缩 16bit(客户要高清时给)。两张都发过去。</p>
<div class="res" id="res"></div> <div class="res" id="res"></div>
<div class="btns"> <div class="btns">
<button id="open">打开留档文件夹</button> <button type="button" class="btn pri" id="open">打开留档文件夹</button>
<button class="ghost" id="again">再开一单</button> <button type="button" class="btn" id="again">再开一单</button>
</div> </div>
</div> </div>
<footer> <footer>
本工具只监听 localhost · 不联网 · 不上传 · 不需要兑换码<br> 本工具只监听 localhost · 不联网 · 不上传 · 不需要兑换码 · 所有文件都留在你自己电脑上<br>
所有文件都留在你自己电脑上 · <a href="#" id="quit" style="color:var(--txt-4)">退出工具</a> <a href="#" id="quit">退出工具</a>
</footer> </footer>
</div> </div>
<div class="toast" id="toast"></div> <div class="toast" id="toast" role="status" aria-live="polite"></div>
<script src="skincheck.js"></script> <script src="skincheck.js"></script>
<script> <script>
@@ -204,56 +245,70 @@ function toast(m){const t=$('#toast');t.textContent=m;t.classList.add('show');
clearTimeout(t._h);t._h=setTimeout(()=>t.classList.remove('show'),2600);} clearTimeout(t._h);t._h=setTimeout(()=>t.classList.remove('show'),2600);}
const TEMPLATES=[ const TEMPLATES=[
{k:'stand', n:'站立正反', s:'正面站立 · 干净背景', c:'#8a8f98'}, {k:'stand', n:'站立正反', s:'正面站立 · 干净背景', c:'#6F7A90'},
{k:'standb', n:'站立正反(虚化)', s:'同款 + 景深虚化', c:'#6f7680'}, {k:'standb', n:'站立正反(虚化)', s:'同款 + 景深虚化', c:'#7C86A8'},
{k:'wheat', n:'麦田萤火', s:'麦田 · 暖光 · 萤火', c:'#a8863a'}, {k:'wheat', n:'麦田萤火', s:'麦田 · 暖光 · 萤火', c:'#C08A2A'},
{k:'beach', n:'海边自拍', s:'海面 · 天光', c:'#4a7fa5'}, {k:'beach', n:'海边自拍', s:'海面 · 天光', c:'#3D86C2'},
{k:'boom', n:'不看爆炸', s:'身后爆炸 · 不回头', c:'#a2563f'}, {k:'boom', n:'不看爆炸', s:'身后爆炸 · 不回头', c:'#C9573A'},
{k:'sakura', n:'飞跃樱花林', s:'樱花 · 动态', c:'#b07a92'}, {k:'sakura', n:'飞跃樱花林', s:'樱花 · 动态', c:'#D0739A'},
{k:'airship', n:'空艇巡游', s:'飞空艇 · 巡航', c:'#5e7f8f'} {k:'airship', n:'空艇巡游', s:'飞空艇 · 巡航', c:'#4E8C9C'}
]; ];
/* 模板缩略图:还没有实拍预览图,先用每个模板自己的颜色 + 一个小图标顶着(以后换成真图:把 thumb 里的 svg 换成 <img>) */
const ICON={
stand:'<path d="M12 4a2 2 0 1 0 0 .01M9 8h6l-1 6h-4zM10 14l-1 6M14 14l1 6"/>',
standb:'<circle cx="12" cy="12" r="8" stroke-dasharray="2 3"/><path d="M12 7a1.5 1.5 0 1 0 0 .01M10 10h4l-.7 4h-2.6zM11 14l-.6 3.5M13 14l.6 3.5"/>',
wheat:'<path d="M12 21V8M12 8c-2-1-3-3-3-5 2 1 3 3 3 5zM12 8c2-1 3-3 3-5-2 1-3 3-3 5zM12 13c-2-1-3-3-3-5 2 1 3 3 3 5zM12 13c2-1 3-3 3-5-2 1-3 3-3 5zM18 6h.01M6 10h.01"/>',
beach:'<circle cx="17" cy="7" r="3"/><path d="M2 16c2 0 2-1.5 4-1.5S8 16 10 16s2-1.5 4-1.5S16 16 18 16s2-1.5 4-1.5M2 20c2 0 2-1.5 4-1.5S8 20 10 20s2-1.5 4-1.5S16 20 18 20s2-1.5 4-1.5"/>',
boom:'<path d="M12 2l2 5 5-2-2 5 5 2-5 2 2 5-5-2-2 5-2-5-5 2 2-5-5-2 5-2-2-5 5 2z"/>',
sakura:'<path d="M12 12c-1.5-2-1.5-5 0-7 1.5 2 1.5 5 0 7zM12 12c2.4-.6 5 .9 5.8 3.1-2.4.6-5-.9-5.8-3.1zM12 12c-2.4-.6-5 .9-5.8 3.1 2.4.6 5-.9 5.8-3.1z"/><circle cx="12" cy="12" r="1"/>',
airship:'<ellipse cx="12" cy="9" rx="9" ry="4"/><path d="M9 13l1 3h4l1-3M3 9h18M21 9l2-2M21 9l2 2"/>'
};
const S={skin:null,fileName:'',analysis:null,report:null,sel:[],job:null,timer:null,res:1000}; const S={skin:null,fileName:'',analysis:null,report:null,sel:[],job:null,timer:null,res:1000};
/* 分辨率:文件名就是它。耗时按像素数粗估(1000² ≈ 40 秒 GPU 打底) */ /* 分辨率:文件名就是它。耗时按像素数粗估(1000² ≈ 40 秒 GPU 打底) */
const RES=[{v:1000,t:'网易头图标准 · 约 40 秒'}, const RES=[{v:1000,t:'头图标准 · 约 40 秒',sec:40},
{v:1024,t:'约 45 秒'}, {v:1024,t:'约 45 秒',sec:45},
{v:2048,t:'约 2.5 分钟'}, {v:2048,t:'约 2.5 分钟',sec:150},
{v:4096,t:'约 10 分钟'}]; {v:4096,t:'约 10 分钟',sec:600}];
RES.forEach(r=>{ RES.forEach(r=>{
const lb=document.createElement('label'); const b=document.createElement('button'); b.type='button';
lb.innerHTML=r.v+'<small>'+r.t+'</small>'; b.innerHTML=r.v+'<small>'+r.t+'</small>';
if(r.v===S.res) lb.classList.add('sel'); if(r.v===S.res) b.classList.add('on');
lb.onclick=()=>{ S.res=r.v; b.onclick=()=>{ S.res=r.v; $$('#resSeg button').forEach(x=>x.classList.toggle('on',x===b)); syncGo(); };
document.querySelectorAll('#resSeg label').forEach(x=>x.classList.remove('sel')); $('#resSeg').appendChild(b);
lb.classList.add('sel'); };
$('#resSeg').appendChild(lb);
}); });
/* ---------- 渲染模板卡片 ---------- */ /* ---------- 模板卡片 ---------- */
TEMPLATES.forEach(t=>{ TEMPLATES.forEach(t=>{
const el=document.createElement('div'); const el=document.createElement('button');
el.className='tpl'; el.dataset.k=t.k; el.style.setProperty('--tone',t.c); el.type='button'; el.className='tpl'; el.dataset.k=t.k; el.style.setProperty('--tone',t.c);
el.innerHTML='<div class="thumb"><div class="ph">' el.setAttribute('aria-pressed','false');
+'<svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor"' el.innerHTML='<div class="thumb"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">'
+' stroke-width="1.1" stroke-linejoin="round" opacity=".42"><path d="M12 2.6 21 7.3v9.4L12 21.4 3 16.7V7.3z"/>' +(ICON[t.k]||'')+'</svg></div><div class="meta"><div class="n"></div><div class="s"></div></div><span class="pick">✓</span><span class="ord"></span>';
+'<path d="M3 7.3l9 4.7 9-4.7M12 12v9.4"/></svg></div></div>'
+'<div class="meta"><div class="n"></div><div class="s"></div></div><div class="pick">✓</div>';
el.querySelector('.n').textContent=t.n; el.querySelector('.s').textContent=t.s; el.querySelector('.n').textContent=t.n; el.querySelector('.s').textContent=t.s;
el.onclick=()=>{ el.onclick=()=>{
const i=S.sel.indexOf(t.k); const i=S.sel.indexOf(t.k);
if(i>=0) S.sel.splice(i,1); else { if(S.sel.length>=10) return toast('一次最多 10 张'); S.sel.push(t.k); } if(i>=0) S.sel.splice(i,1); else { if(S.sel.length>=10) return toast('一次最多 10 张'); S.sel.push(t.k); }
el.classList.toggle('sel'); syncGo(); syncTpls(); syncGo();
}; };
$('#tpls').appendChild(el); $('#tpls').appendChild(el);
}); });
function syncTpls(){
$$('#tpls .tpl').forEach(el=>{ const i=S.sel.indexOf(el.dataset.k);
el.classList.toggle('sel',i>=0); el.setAttribute('aria-pressed',String(i>=0));
el.querySelector('.ord').textContent=i>=0?String(i+1):''; });
}
/* ---------- 皮肤上传 + 质检(复用 skincheck.js) ---------- */ /* ---------- 皮肤上传 + 质检(复用 skincheck.js) ---------- */
const drop=$('#drop'), fileIn=$('#file'); const drop=$('#drop'), fileIn=$('#file');
drop.onclick=()=>fileIn.click(); drop.onclick=()=>fileIn.click();
fileIn.onchange=e=>{ if(e.target.files[0]) loadFile(e.target.files[0]); }; fileIn.onchange=e=>{ if(e.target.files[0]) loadFile(e.target.files[0]); fileIn.value=''; };
['dragenter','dragover'].forEach(ev=>drop.addEventListener(ev,e=>{e.preventDefault();drop.classList.add('over');})); ['dragenter','dragover'].forEach(ev=>drop.addEventListener(ev,e=>{e.preventDefault();drop.classList.add('over');}));
['dragleave','drop'].forEach(ev=>drop.addEventListener(ev,e=>{e.preventDefault();drop.classList.remove('over');})); ['dragleave','drop'].forEach(ev=>drop.addEventListener(ev,e=>{e.preventDefault();drop.classList.remove('over');}));
drop.addEventListener('drop',e=>{ const f=e.dataTransfer.files[0]; if(f) loadFile(f); }); drop.addEventListener('drop',e=>{ const f=e.dataTransfer.files[0]; if(f) loadFile(f); });
/* 拖到页面别处也能收(不然浏览器会直接打开这张图、把页面换掉) */
['dragover','drop'].forEach(ev=>window.addEventListener(ev,e=>{ if(!drop.contains(e.target)){ e.preventDefault();
if(ev==='drop'&&e.dataTransfer.files[0]) loadFile(e.dataTransfer.files[0]); } }));
window.addEventListener('paste',e=>{ window.addEventListener('paste',e=>{
for(const it of (e.clipboardData||{}).items||[]){ for(const it of (e.clipboardData||{}).items||[]){
if(it.type.startsWith('image/')){ const f=it.getAsFile(); if(f) return loadFile(f); } if(it.type.startsWith('image/')){ const f=it.getAsFile(); if(f) return loadFile(f); }
@@ -270,7 +325,7 @@ function loadFile(f){
if(st && st.notes && st.notes.length) toast('提示:'+st.notes.join(';')+'(不影响出图)'); if(st && st.notes && st.notes.length) toast('提示:'+st.notes.join(';')+'(不影响出图)');
const fr=new FileReader(); const fr=new FileReader();
fr.onload=()=>{ const im=new Image(); fr.onload=()=>{ const im=new Image();
im.onload=()=>runCheck(im,f.name,im.width,im.height); im.onload=()=>runCheck(im,f.name||'粘贴的图片.png',im.width,im.height);
im.onerror=()=>toast('这张图读不出来,换一张试试'); im.onerror=()=>toast('这张图读不出来,换一张试试');
im.src=fr.result; }; im.src=fr.result; };
fr.readAsDataURL(f); fr.readAsDataURL(f);
@@ -286,53 +341,69 @@ function runCheck(img,name,w,h){
const c=$('#pv'); c.width=64; c.height=64; const c=$('#pv'); c.width=64; c.height=64;
const g=c.getContext('2d'); g.imageSmoothingEnabled=false; const g=c.getContext('2d'); g.imageSmoothingEnabled=false;
g.clearRect(0,0,64,64); g.drawImage(img,0,0,64,64); g.clearRect(0,0,64,64); g.drawImage(img,0,0,64,64);
$('#pvName').textContent=name+' ('+a.origW+'×'+a.origH+')'; $('#pvName').textContent=name+'('+a.origW+'×'+a.origH+')';
$('#pvwrap').style.display=''; $('#pvwrap').hidden=false;
drop.classList.add('has'); $('#dropBig').textContent='换一张皮肤';
const box=$('#report'); box.innerHTML=''; const box=$('#report'); box.innerHTML='';
rep.items.forEach(it=>{ const row=(lv,tag,t,d)=>{
const d=document.createElement('div'); d.className='item '+it.lv; const el=document.createElement('div'); el.className='item '+lv;
const tg=document.createElement('span'); tg.className='tag'; tg.textContent=it.tag; const tg=document.createElement('span'); tg.className='tag'; tg.textContent=tag;
const bd=document.createElement('div'); bd.className='bd'; const bd=document.createElement('div'); bd.className='bd';
const t=document.createElement('div'); t.className='t'; t.textContent=it.t; const tt=document.createElement('div'); tt.className='t'; tt.textContent=t;
const dd=document.createElement('div'); dd.className='d'; dd.textContent=it.d; const dd=document.createElement('div'); dd.className='d'; dd.textContent=d;
bd.appendChild(t); bd.appendChild(dd); d.appendChild(tg); d.appendChild(bd); bd.appendChild(tt); if(d) bd.appendChild(dd); el.appendChild(tg); el.appendChild(bd); box.appendChild(el);
box.appendChild(d); };
}); rep.items.forEach(it=>row(it.lv,it.tag,it.t,it.d));
if(rep.hasBad){ if(rep.hasBad) row('bad','不通过','这张皮肤不能直接渲','上面标了不通过的问题得先解决。请买家换一张标准皮肤。');
const d=document.createElement('div'); d.className='item bad';
d.innerHTML='<span class="tag">不通过</span><div class="bd"><div class="t">这张皮肤不能直接渲</div>'
+'<div class="d">上面标了不通过的问题得先解决。请买家换一张标准皮肤。</div></div>';
box.appendChild(d);
}
syncGo(); syncGo();
} }
/* ---------- 提交 ---------- */ /* ---------- 提交 ---------- */
function tplName(k){ const t=TEMPLATES.find(x=>x.k===k); return t?t.n:k; } function tplName(k){ const t=TEMPLATES.find(x=>x.k===k); return t?t.n:k; }
function syncGo(){ $('#go').disabled = !(S.skin && S.sel.length && !(S.report&&S.report.hasBad)); } function fmtSec(s){ return s<90 ? (Math.round(s)+' 秒') : (Math.round(s/60)+' 分钟'); }
function syncGo(){
const ready = !!(S.skin && S.sel.length && !(S.report&&S.report.hasBad));
$('#go').disabled = !ready;
$('#st1').classList.toggle('done', !!(S.skin && !(S.report&&S.report.hasBad)));
$('#st2').classList.toggle('done', S.sel.length>0);
const sum=$('#sum');
if(!S.skin && !S.sel.length){ sum.className='sum idle'; sum.textContent='先选皮肤、勾模板。'; return; }
if(S.report&&S.report.hasBad){ sum.className='sum idle'; sum.textContent='皮肤质检没通过,换一张再来。'; return; }
if(!S.skin){ sum.className='sum idle'; sum.textContent='已勾 '+S.sel.length+' 个模板,还差皮肤。'; return; }
if(!S.sel.length){ sum.className='sum idle'; sum.textContent='皮肤好了,再勾模板。'; return; }
const r=RES.find(x=>x.v===S.res)||RES[0];
sum.className='sum';
sum.innerHTML='出 <b>'+S.sel.length+'</b> 张:'+S.sel.map(k=>tplName(k)).join('、')+' · <b>'+S.res+'px</b> · 大概 <b>'+fmtSec(r.sec*S.sel.length)+'</b>(每张另出一份无压缩)';
}
$('#go').onclick=async()=>{ $('#go').onclick=async()=>{
if(!S.skin) return toast('先选皮肤'); if(!S.skin) return toast('先选皮肤');
if(!S.sel.length) return toast('先勾模板'); if(!S.sel.length) return toast('先勾模板');
if(S.report&&S.report.hasBad) return toast('质检不通过,不能提交'); if(S.report&&S.report.hasBad) return toast('质检不通过,不能提交');
$('#go').disabled=true; $('#go').disabled=true;
$('#progWrap').style.display=''; $('#card3').style.display='none'; $('#progWrap').hidden=false; $('#card3').hidden=true;
$('#bar').style.width='4%'; $('#progTxt').textContent='提交中…';
// 皮肤转 base64 送本机接口 // 皮肤转 base64 送本机接口
const c=document.createElement('canvas'); const c=document.createElement('canvas');
c.width=S.analysis.origW; c.height=S.analysis.origH; c.width=S.analysis.origW; c.height=S.analysis.origH;
const g=c.getContext('2d'); g.imageSmoothingEnabled=false; const g=c.getContext('2d'); g.imageSmoothingEnabled=false;
g.drawImage(S.skin,0,0,S.analysis.origW,S.analysis.origH); g.drawImage(S.skin,0,0,S.analysis.origW,S.analysis.origH);
const data=c.toDataURL('image/png'); const data=c.toDataURL('image/png');
const st=await (await fetch('/api/render',{method:'POST',headers:{'Content-Type':'application/json'}, let st;
body:JSON.stringify({skin:data,fileName:S.fileName,templates:S.sel,res:S.res, try{
arm:(S.analysis.arm&&S.analysis.arm.model)||'',note:$('#note').value.trim()})})).json(); st=await (await fetch('/api/render',{method:'POST',headers:{'Content-Type':'application/json'},
if(!st.ok){ $('#go').disabled=false; $('#progWrap').style.display='none'; return toast(st.error||'提交失败'); } body:JSON.stringify({skin:data,fileName:S.fileName,templates:S.sel,res:S.res,
arm:(S.analysis.arm&&S.analysis.arm.model)||'',note:$('#note').value.trim()})})).json();
}catch(e){ st={ok:false,error:'连不上本机工具(是不是已经退出了?)'}; }
if(!st.ok){ $('#go').disabled=false; $('#progWrap').hidden=true; return toast(st.error||'提交失败'); }
S.job=st.job; poll(); S.job=st.job; poll();
}; };
async function poll(){ async function poll(){
const j=await (await fetch('/api/job/'+S.job)).json(); let j;
try{ j=await (await fetch('/api/job/'+S.job)).json(); }
catch(e){ S.timer=setTimeout(poll,3000); $('#progTxt').textContent='和本机工具断了一下,重连中…'; return; }
const pct=Math.round(((j.current-1)/j.total)*100); const pct=Math.round(((j.current-1)/j.total)*100);
$('#bar').style.width=Math.max(pct,j.state==='done'?100:4)+'%'; $('#bar').style.width=Math.max(pct,j.state==='done'?100:4)+'%';
const ahead = Math.max((j.queue_pos||1) - 1, 0); const ahead = Math.max((j.queue_pos||1) - 1, 0);
@@ -340,18 +411,19 @@ async function poll(){
j.state==='queued' ? (ahead>0 ? ('排队中 · 前面还有 '+ahead+' 单(一张一张来,不并行)') j.state==='queued' ? (ahead>0 ? ('排队中 · 前面还有 '+ahead+' 单(一张一张来,不并行)')
: '马上开始…') : '马上开始…')
: j.state==='running' ? ('正在渲染第 '+j.current+' / '+j.total+' 张 · '+(j.res||1000)+'px' : j.state==='running' ? ('正在渲染第 '+j.current+' / '+j.total+' 张 · '+(j.res||1000)+'px'
+'(每张出标准+无压缩两张)') +'(每张出标准 + 无压缩两张)')
: j.state==='done' ? '全部完成' : '出错了'; : j.state==='done' ? '全部完成' : '出错了';
if(j.state==='running'||j.state==='queued'){ S.timer=setTimeout(poll,2000); return; } if(j.state==='running'||j.state==='queued'){ S.timer=setTimeout(poll,2000); return; }
clearTimeout(S.timer); clearTimeout(S.timer); S.timer=null;
$('#go').disabled=false; $('#go').disabled=false;
if(j.state==='error' && !j.results.length){
$('#card3').style.display=''; $('#resHint').textContent='';
$('#res').innerHTML='<div class="errbar">'+(j.error||'渲染失败')+'</div>'; return;
}
$('#card3').style.display='';
$('#resHint').textContent='共 '+j.results.length+' 张'+(j.errors&&j.errors.length?('(有 '+j.errors.length+' 张失败)'):'');
const box=$('#res'); box.innerHTML=''; const box=$('#res'); box.innerHTML='';
$('#card3').hidden=false;
if(j.state==='error' && !j.results.length){
$('#resHint').textContent='';
const e=document.createElement('div'); e.className='errbar'; e.textContent=j.error||'渲染失败'; box.appendChild(e);
$('#card3').scrollIntoView({behavior:'smooth',block:'start'}); return;
}
$('#resHint').textContent='共 '+j.results.length+' 个文件'+(j.errors&&j.errors.length?('(有 '+j.errors.length+' 张失败)'):'')+'。';
// 按序号分组:一个模板 = 一张卡片,里面挂【标准压缩】+【无压缩 16bit】两个下载 // 按序号分组:一个模板 = 一张卡片,里面挂【标准压缩】+【无压缩 16bit】两个下载
const groups=[]; const groups=[];
j.results.forEach((r,i)=>{ let g=groups.find(x=>x.seq===r.seq); j.results.forEach((r,i)=>{ let g=groups.find(x=>x.seq===r.seq);
@@ -359,7 +431,7 @@ async function poll(){
g.items.push({i:i,r:r}); }); g.items.push({i:i,r:r}); });
groups.forEach(g=>{ groups.forEach(g=>{
const d=document.createElement('div'); d.className='one'; const d=document.createElement('div'); d.className='one';
d.innerHTML='<img src="/api/file/'+S.job+'/'+g.items[0].i+'?t='+Date.now()+'" alt="">' d.innerHTML='<img src="/api/file/'+S.job+'/'+g.items[0].i+'?t='+Date.now()+'" alt="" loading="lazy">'
+'<div class="cap"><b></b><span></span><div class="dls"></div></div>'; +'<div class="cap"><b></b><span></span><div class="dls"></div></div>';
d.querySelector('b').textContent=g.tplName||g.tpl; d.querySelector('b').textContent=g.tplName||g.tpl;
d.querySelector('span').textContent='序号 '+g.seq+' · '+(g.items[0].r.res||1000)+'px · 渲染 '+g.sec+' 秒'; d.querySelector('span').textContent='序号 '+g.seq+' · '+(g.items[0].r.res||1000)+'px · 渲染 '+g.sec+' 秒';
@@ -367,7 +439,7 @@ async function poll(){
g.items.forEach(it=>{ g.items.forEach(it=>{
const a=document.createElement('a'); const a=document.createElement('a');
a.href='/api/file/'+S.job+'/'+it.i; a.setAttribute('download',it.r.name); a.href='/api/file/'+S.job+'/'+it.i; a.setAttribute('download',it.r.name);
a.textContent='↓ '+it.r.kind; dl.appendChild(a); dl.appendChild(document.createTextNode(' ')); a.textContent='下载 '+it.r.kind; dl.appendChild(a);
}); });
box.appendChild(d); box.appendChild(d);
}); });
@@ -376,34 +448,53 @@ async function poll(){
box.appendChild(e); box.appendChild(e);
} }
S.job=j.id; toast('出图完成'); S.job=j.id; toast('出图完成');
$('#card3').scrollIntoView({behavior:'smooth',block:'start'});
} }
$('#quit').onclick=async e=>{ e.preventDefault(); $('#quit').onclick=async e=>{ e.preventDefault();
if(!confirm('关闭本机开单工具?(渲染机不受影响,还会继续接网页的单)')) return; if(!confirm('关闭本机开单工具?(渲染机不受影响,还会继续接网页的单)')) return;
await fetch('/api/quit',{method:'POST'}); document.body.innerHTML='<div class="wrap" style="padding:80px 20px;text-align:center;color:var(--txt-4)">工具已关闭,可以关掉这个页面了。</div>'; await fetch('/api/quit',{method:'POST'}).catch(()=>{});
document.body.innerHTML='<div class="wrap" style="padding:80px 20px;text-align:center;color:var(--dim)">工具已关闭,可以关掉这个页面了。</div>';
}; };
$('#open').onclick=async()=>{ $('#open').onclick=async()=>{
const r=await (await fetch('/api/openfolder',{method:'POST',headers:{'Content-Type':'application/json'}, const r=await (await fetch('/api/openfolder',{method:'POST',headers:{'Content-Type':'application/json'},
body:JSON.stringify({job:S.job})})).json(); body:JSON.stringify({job:S.job})})).json();
toast(r.ok?'已打开文件夹':(r.error||'打不开')); toast(r.ok?'已打开文件夹':(r.error||'打不开'));
}; };
$('#again').onclick=()=>{ S.sel=[]; $$('#tpls .tpl').forEach(e=>e.classList.remove('sel')); /* 再开一单:模板和备注清掉,皮肤留着(同一个买家常常要再加几张) */
$('#note').value=''; $('#card3').style.display='none'; $('#progWrap').style.display='none'; syncGo(); }; $('#again').onclick=()=>{ S.sel=[]; syncTpls();
$('#note').value=''; $('#card3').hidden=true; $('#progWrap').hidden=true; syncGo();
window.scrollTo({top:0,behavior:'smooth'}); };
/* 清空:皮肤、模板、备注全清 */
$('#clear').onclick=()=>{ if(S.timer) return toast('正在渲染,等它出完再清');
S.skin=null; S.fileName=''; S.analysis=null; S.report=null; S.sel=[]; syncTpls();
$('#note').value=''; $('#pvwrap').hidden=true; $('#report').innerHTML='';
drop.classList.remove('has'); $('#dropBig').textContent='点击选择皮肤文件';
$('#progWrap').hidden=true; syncGo(); };
$('#copyTerms').onclick=()=>{ const t=$('#termsTxt').textContent;
if(navigator.clipboard&&window.isSecureContext) navigator.clipboard.writeText(t).then(()=>toast('说明已复制'),()=>toast('复制失败,手动选吧'));
else { const a=document.createElement('textarea'); a.value=t; a.style.position='fixed'; a.style.opacity='0'; document.body.appendChild(a); a.select();
try{ document.execCommand('copy'); toast('说明已复制'); }catch(e){ toast('复制失败,手动选吧'); } a.remove(); } };
/* ---------- 体检 ---------- */ /* ---------- 体检 ---------- */
(async()=>{ (async()=>{
const a=await (await fetch('/api/status')).json(); let a;
try{ a=await (await fetch('/api/status')).json(); }
catch(e){ $('#health').textContent='连不上'; $('#health').className='badge bad'; return; }
const bad=[]; const bad=[];
if(!a.blender_ok) bad.push('没找到 blender.exe —— 请在 config.json 里填 blender 路径'); if(!a.blender_ok) bad.push('没找到 blender.exe —— 请在 config.json 里填 blender 路径');
if(!a.make_order_ok) bad.push('没找到渲染脚本 make_order.py('+a.make_order+')'); if(!a.make_order_ok) bad.push('没找到渲染脚本 make_order.py('+a.make_order+')');
if(a.missing.length) bad.push('缺 '+a.missing.length+' 个模板文件:'+a.missing.join('、')); if(a.missing.length) bad.push('缺 '+a.missing.length+' 个模板文件:'+a.missing.join('、'));
$('#health').textContent = a.blender_ok && !a.missing.length && a.make_order_ok ? '就绪' : '有问题'; const ok = a.blender_ok && !a.missing.length && a.make_order_ok;
$('#health').textContent = ok ? '就绪' : '有问题';
$('#health').className = 'badge '+(ok?'ok':'bad');
if(bad.length){ if(bad.length){
const w=document.createElement('div'); w.className='warnbar'; const w=document.createElement('div'); w.className='warnbar';
w.innerHTML='<b>先看这里:</b><br>'+bad.join('<br>'); w.innerHTML='<b>先看这里:</b><br>'+bad.map(x=>x.replace(/[&<>]/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;'}[c]))).join('<br>');
$('#syswarn').appendChild(w); $('#syswarn').appendChild(w);
} }
})(); })();
syncGo();
</script> </script>
</body> </body>
</html> </html>
File diff suppressed because it is too large Load Diff
+32 -4
View File
@@ -17,7 +17,7 @@
``` ```
<WORKER_DIR>\ <WORKER_DIR>\
├─ ys_worker.py 渲染机主程序(开机自启的计划任务;轮询领单 → 调 Blender → 回传) ├─ ys_worker.py 渲染机主程序(开机自启的计划任务;轮询领单 → 调 Blender → 回传)
├─ ys_admin.py 开单后台(局域网面板:发卡密 / 激活订单 / 免费码),自带 PIN 锁 ├─ ys_admin.py 开单后台(局域网面板:待处理 / 订单 / 卡密 / 福利券 / 呼叫·反馈),自带 PIN 锁
├─ ys_local.py 纯本机开单工具(不联网、不上传、不要卡密;拖皮肤→勾模板→出图) ├─ ys_local.py 纯本机开单工具(不联网、不上传、不要卡密;拖皮肤→勾模板→出图)
├─ local.html 本机开单工具的页面(ys_local.py 内嵌服务它) ├─ local.html 本机开单工具的页面(ys_local.py 内嵌服务它)
├─ make_order.py Blender 出图脚本(渲染机调用它;改模板/分辨率/臂型都在这) ├─ make_order.py Blender 出图脚本(渲染机调用它;改模板/分辨率/臂型都在这)
@@ -51,14 +51,42 @@
``` ```
### ② 开单后台(`ys_admin.py`,局域网) ### ② 开单后台(`ys_admin.py`,局域网)
四块:① 生成卡密 ② 待激活订单(一键激活进队列)③ 最近卡密 ④ 免费码(福利券)批次管理。 **2026-10-05 页面重写**:样子跟 2026 版网站统一(白光 + 毛玻璃卡片 + MC 方块按钮),按「要干的事」分页:
**自带 PIN 锁**:首次打开自己设 4~12 位数字,存**加盐 sha256**(不是明文),12 小时免输;
校验在服务端,直接打接口也会 401。 | 页 | 干什么 | 新增 / 变化 |
|---|---|---|
| **待处理**(默认打开) | 渲染机在不在、队列、待激活、卡密数一眼看完;下面是**要你动手的**:买家说付好了的单(排最前)、渲染失败的单、没处理的呼叫 | 失败的单有「退回重渲」按钮(以前只能写「喊苏达用 admin.py」);呼叫直接在这里看、点「处理过了」 |
| 订单 | 全部订单,按状态筛 + **搜索**(单号 / 卡密 / 模板 / 备注) | 每单能**写备注**(服务器早有接口,以前面板上没按钮) |
| 卡密 | 左:生成(设置下面实时出一句「会生成什么」);右:卡密库,按状态筛 + **搜索**(码 / 订单号 / 批次 / 平台) | 能**停用 / 启用**、**改张数**(服务器早有 `code-edit`,以前面板上没按钮) |
| 福利券 | 左:开一批;右:已开的批次(复制券码 / 补货 / 收摊 / 领取情况) | 只改了排版 |
| 呼叫·反馈 | 买家「呼叫金钻」、反馈、渲染机报的「部分失败」 | **新页**:以前只能 ssh 上去 `admin.py calls` 看 |
| 开单工具 | 本机开单工具(iframe,第一次点开才加载) | 不变 |
- 手机上导航放到底部;电脑上在左边。顶栏的状态、导航上的角标每 30 秒自动刷新(页面藏在后台时不刷)。
- **自带 PIN 锁**:首次打开自己设 4~12 位数字,存**加盐 sha256**(不是明文),12 小时免输;校验在服务端,直接打接口也会 401。
- 面板新增的本机接口(都要 PIN,都是原样转给服务器 `/api/admin/*`):
`GET /api/codes`、`GET /api/calls`、`POST /api/retry`、`POST /api/note`、`POST /api/code-edit`、`POST /api/call-done`。
老接口(`/api/state`、`/api/gen`、`/api/activate`、`/api/void`、`/api/orders`、`/api/gifts`、`/api/gift/*`、`/api/savecsv`、PIN 那三个)**一个没动**。
- ⚠️ 用到了服务器这次新加的管理接口(`calls` / `call-done` / `retry` / `codes?q=`),所以**服务器要先升级**;
面板先升、服务器没升的话,这几个按钮会提示「服务器回 404」,别的照常能用。
- 怎么验证的:用现编的假数据(10 单覆盖全部状态、30 多张卡密、3 条呼叫、1 批福利券)起一份真服务器 + 真面板,
浏览器里(电脑 1366 宽 + 手机 390 宽)把每一页点了一遍:生成卡密、搜订单、激活、退回重渲、停用卡密、标呼叫已处理都走通,
没有报错、没有横向滚动;不带 PIN 打面板接口 → 401,不带令牌直接打服务器管理接口 → 403。
### ③ 纯本机开单(`ys_local.py` + `local.html`,只监听回环) ### ③ 纯本机开单(`ys_local.py` + `local.html`,只监听回环)
给**平台单**(聊天里成交的买家)用:拖皮肤 → 同一套质检 → 勾模板 → 本机 Blender 出图 → 下载。 给**平台单**(聊天里成交的买家)用:拖皮肤 → 同一套质检 → 勾模板 → 本机 Blender 出图 → 下载。
**不联网、不上传、不要卡密**,所以网站上根本没有入口(避免卡密被暴力试)。 **不联网、不上传、不要卡密**,所以网站上根本没有入口(避免卡密被暴力试)。
**2026-10-05 页面重写**(`local.html`;`ys_local.py` 和本机接口一个没动):
- 样子跟网站 / 开单后台统一;电脑上左边「① 皮肤 + 质检」、右边「② 模板 + 分辨率 + 备注 + 开始」,出图结果在下面整行;手机上从上往下排。
- 补上了原来没写样式的两处:**分辨率选择**(原来 `.seg` / `label.sel` 没有 CSS,看着像一行纯文字)、「清空」「再开一单」按钮(原来用的 `.ghost` 没定义)。
- 模板卡片:按勾的顺序标 1 / 2 / 3(出图就是这个顺序);每个模板一个颜色 + 小图标(还没有实拍预览图,以后有了把 `thumb` 里的 svg 换成 `<img>`)。
- 「开始」上面实时一句话:出几张、哪几个模板、多大、大概多久;勾完、皮肤过了质检,步骤号变绿。
- 「清空」现在真的会清皮肤(原来这个按钮**没绑任何事件**,点了没反应);「再开一单」照旧只清模板和备注、留着皮肤(同一个买家常常再加几张)。
- 拖到页面别处也能收皮肤(原来拖偏了浏览器会直接打开那张图、把工具页换掉);买家说明多了一个「复制这段话」按钮。
- 质检结果去掉了每行前面的小圆点,改成「通过 / 注意 / 不通过」色块。
- 怎么验证的:写了一个假的本机服务(假装渲染,每张 1.4 秒),浏览器在电脑宽 / 手机宽各走一遍:选皮肤 → 勾 3 个模板 → 选 2048 → 渲染 → 出 3 张卡片各两个下载,无报错、无横向滚动。**没在真 Blender 上跑**(页面发给本机接口的字段和原来一样)。
--- ---
## 四、几个刻意做出的设计(欢迎质疑) ## 四、几个刻意做出的设计(欢迎质疑)
+29
View File
@@ -83,3 +83,32 @@ ys_admin.py 的「令牌 + PIN + 自定义请求头」做法本身是对的:
--- ---
*以上改动都还只在工作区,等你们(和 ywsabc2)看过再决定要不要合。* *以上改动都还只在工作区,等你们(和 ywsabc2)看过再决定要不要合。*
---
# 第二轮(2026-10-05 晚)· 开单后台页面重写
### 改动 4 · ys_admin.py 页面按功能重排 + 补按钮
```
文件 / 函数:ys_admin.py 的 PAGE(整页 HTML / CSS / JS 重写);do_GET / do_POST 加了 6 个转发
为什么改:老页面一长条五张卡,要处理的事(待激活、失败、呼叫)跟生成表单混在一起;
服务器早有的「写备注」「改卡密 / 停用」在面板上没有按钮;失败的单和呼叫记录在面板上处理不了
改成什么:待处理(默认)/ 订单 / 卡密 / 福利券 / 呼叫·反馈 / 开单工具 六页;样子跟 2026 版网站一致;
订单、卡密能搜;失败的单能退回重渲;呼叫能标「处理过了」;卡密能停用 / 启用 / 改张数
⚠️ 有没有动接口:面板本机接口**新增** /api/codes /api/calls /api/retry /api/note /api/code-edit /api/call-done,
老接口和 PIN 锁逻辑一个没动;新按钮用到服务器这次新加的管理接口,**服务器要先升级**
你怎么验证的:现编假数据起真服务器 + 真面板,headless 浏览器在电脑宽 / 手机宽各点一遍全部页面和主要操作,
无报错、无横向滚动(详见 交接说明.md 第三节 ②)
```
### 改动 5 · 本机开单页面(local.html)重写
```
文件 / 函数:local.html(整页);ys_local.py 没动
为什么改:暗色老样子;分辨率选择和次按钮没写样式;「清空」按钮没绑事件(点了没反应);
拖偏了浏览器会把工具页换成那张图
改成什么:跟网站 / 开单后台同一套样子,左皮肤右模板;补上分辨率样式、清空、整页接收拖拽、出图顺序标号、预计耗时
⚠️ 有没有动接口:没有。/api/status /api/render /api/job /api/file /api/openfolder /api/quit 的请求和字段照旧
你怎么验证的:假本机服务 + headless 浏览器(电脑宽 / 手机宽)走完整流程;没在真 Blender 上跑
```
+15 -10
View File
@@ -1,18 +1,22 @@
# 交付清单(自查用) # 交付清单(自查用)
> 生成:2026-10-05 18:55 共 31 个文件 合计 44.7 MB > 生成:2026-10-05 17:30 共 36 个文件 合计 44.9 MB(2026-10-05 第二轮:数据库 store.py、两份测试、回执;后台面板和本机开单页面重写;推送前审查修复)
| 文件 | 字节 | SHA-256 | | 文件 | 字节 | SHA-256 |
|---|---|---| |---|---|---|
| `README.md` | 8,498 | `15ccb27558e0612ff1a9fc7822f7a0ec8da298753617b317cbf057a4902ddbb5` | | `README.md` | 8,696 | `5cef368dbf5916def012dbfcf7fdfb35d1f435faf5a7b42b65f6ad683343b1c2` |
| `backend-site/admin.py` | 24,214 | `3b9818c063e4c7297d3052cad4ff2a88941b4d07b85e2e5eaf495eed35d3f484` | | `backend-site/admin.py` | 26,020 | `d7f86dcf0b07962ceb55a7714b43c876628118d19159dc3a9215535db1bc47f7` |
| `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` | | `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` |
| `backend-site/server.py` | 160,560 | `9470b057f9eaf1927d06917ac5909fb0e733a4b44a04c039b82bbd907b9f2a62` | | `backend-site/server.py` | 181,352 | `438fcd98d57043ee503222b6decc83e873dda2d62c66a8d36f521c7d21e6afed` |
| `backend-site/交接说明.md` | 14,711 | `6b98b87c0f061760ec73e78036cf563b1c27fc8dead2324685b7218b61c9be72` | | `backend-site/store.py` | 19,303 | `9d22007b43188225d4254f8c9710c310d9d55635d0d67496ec99e91fe47bcd2d` |
| `backend-site/tests/回执复现测试.py` | 15,355 | `4529f6076abdfce89bf4406c7fbd0789482deaa595383749580bdc3e08ddc327` |
| `backend-site/tests/数据库测试.py` | 16,045 | `9838f32bf213cd3c727625a50b5e0cbff7da98ded8b7452cacd187c448bde04f` |
| `backend-site/交接说明.md` | 21,795 | `03b9cb73b27a265c32fc5a36120da0d6d61c2e1d612308cba0221818493cb3f0` |
| `backend-site/回执-Claude.md` | 37,690 | `de1648832fe8bcd004c32ed538d4a90c6c29a0d72b8c70f448fdbe5332d8b5d9` |
| `backend-tools/chk_worker.ps1` | 486 | `939a42cafa0954347f28d69e75b8af407ed1dab870cc3956fa8b7c5eb55e372f` | | `backend-tools/chk_worker.ps1` | 486 | `939a42cafa0954347f28d69e75b8af407ed1dab870cc3956fa8b7c5eb55e372f` |
| `backend-tools/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` | | `backend-tools/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` |
| `backend-tools/install_worker.ps1` | 8,902 | `95c339f2a69359fd1c980fb649217bb18371d9ba0b06eadce049b58537c11c1e` | | `backend-tools/install_worker.ps1` | 8,902 | `95c339f2a69359fd1c980fb649217bb18371d9ba0b06eadce049b58537c11c1e` |
| `backend-tools/local.html` | 23,026 | `c02fe7ed5bf39f329120c1ce6a01dcd2db675a37061fd5d57d8519dffc818a97` | | `backend-tools/local.html` | 32,184 | `7c31ed3419946b2ab10065a8b9007a5a18c57aba1a1eaa645856af7be46181b2` |
| `backend-tools/make_order.py` | 28,388 | `e8e2ebb473501a0b914b9c2941d9e8505e9b92f0880190cf7f588d5fe27f233e` | | `backend-tools/make_order.py` | 28,388 | `e8e2ebb473501a0b914b9c2941d9e8505e9b92f0880190cf7f588d5fe27f233e` |
| `backend-tools/open_local.bat` | 81 | `cf91a0f9bbf18db6b082874131aacb8bc04924bf68d355481a9445b26c46ab30` | | `backend-tools/open_local.bat` | 81 | `cf91a0f9bbf18db6b082874131aacb8bc04924bf68d355481a9445b26c46ab30` |
| `backend-tools/pack_archive.bat` | 86 | `e2c6683d0b353ae8f68d9f9c0430c486aa733c57c6d2f4e7802bdd5e53783c00` | | `backend-tools/pack_archive.bat` | 86 | `e2c6683d0b353ae8f68d9f9c0430c486aa733c57c6d2f4e7802bdd5e53783c00` |
@@ -24,10 +28,11 @@
| `backend-tools/skincheck.js` | 13,011 | `dc9c65ac8b8551aaa42ca7399517bb1d6c28956c4c80997132f16862e1239b8d` | | `backend-tools/skincheck.js` | 13,011 | `dc9c65ac8b8551aaa42ca7399517bb1d6c28956c4c80997132f16862e1239b8d` |
| `backend-tools/stop_admin.bat` | 281 | `9b38682234f2e07b58c478c939f4f1d58cefe9624b13d0af2656d5522fd5509d` | | `backend-tools/stop_admin.bat` | 281 | `9b38682234f2e07b58c478c939f4f1d58cefe9624b13d0af2656d5522fd5509d` |
| `backend-tools/stop_worker.bat` | 332 | `f7c8ab10d1d03d7a75c2fcb3343bec0c6d52409ef5cc6dd68c0f9e342e0077b4` | | `backend-tools/stop_worker.bat` | 332 | `f7c8ab10d1d03d7a75c2fcb3343bec0c6d52409ef5cc6dd68c0f9e342e0077b4` |
| `backend-tools/ys_admin.py` | 58,367 | `05878039c3728fc119c75ad76f216298d6c82e6cc19b79024090a89d8cc7fc84` | | `backend-tools/ys_admin.py` | 74,901 | `69f7938cb7f4fb96ec16fecb2272b1d1b6688dafbc28a4d72dc7b1ea53853f35` |
| `backend-tools/ys_local.py` | 17,021 | `27948a19f45aa984e0f9ffc88b6cd85bbe127e8f4ceff272fd189a49524fec1f` | | `backend-tools/ys_local.py` | 18,243 | `ea0b3208ec34ba4817b4513feb64d47eb7746cb5d1536191f295eb830107d15d` |
| `backend-tools/ys_worker.py` | 30,465 | `ab6cdff13ce16ed15363c28cf016628b378a1ec255d2b8eeb62566cf38631eb9` | | `backend-tools/ys_worker.py` | 30,465 | `ab6cdff13ce16ed15363c28cf016628b378a1ec255d2b8eeb62566cf38631eb9` |
| `backend-tools/交接说明.md` | 11,008 | `731c591b545c4332c3ad5336910a78e5dfb8b6541da6f33e8f4e70bb3b7dab48` | | `backend-tools/交接说明.md` | 15,276 | `5468d47b9f51bb6cca6172db6a61bed209a181814ac662093345d02445305dea` |
| `backend-tools/回执-Claude.md` | 11,578 | `d1151810199f0dc585872027870666963e528f7027f12ce146334c5f36f761e4` |
| `deploy/nginx-片段.md` | 4,145 | `183179dc694e1f2ac3a791f3c96aa6f7d292b1968276ae1af4d850e26fbf78d0` | | `deploy/nginx-片段.md` | 4,145 | `183179dc694e1f2ac3a791f3c96aa6f7d292b1968276ae1af4d850e26fbf78d0` |
| `他应该知道的.md` | 6,988 | `177f08cb455bf5cf4b299abda5b227ff530c1da634c69f81c8ca7498ccc00cbe` | | `他应该知道的.md` | 6,988 | `177f08cb455bf5cf4b299abda5b227ff530c1da634c69f81c8ca7498ccc00cbe` |
| `回执模板.md` | 5,049 | `0e38a6c19dff7b55767b8998d294b0252aa6024053dad0c63956ddd58b56a07a` | | `回执模板.md` | 5,049 | `0e38a6c19dff7b55767b8998d294b0252aa6024053dad0c63956ddd58b56a07a` |
@@ -36,4 +41,4 @@
| `模板/5不看爆炸.blend` | 11,849,599 | `3bb67516632e206c89fe44e2cf04667f5e34e1eab70e395c00830555e033e223` | | `模板/5不看爆炸.blend` | 11,849,599 | `3bb67516632e206c89fe44e2cf04667f5e34e1eab70e395c00830555e033e223` |
| `模板/说明.md` | 2,775 | `491fa0587a9ff662a8e8893d0657eb412d87af8161de19abeba993e5a8ff4675` | | `模板/说明.md` | 2,775 | `491fa0587a9ff662a8e8893d0657eb412d87af8161de19abeba993e5a8ff4675` |
> 用途:对方收到后可以逐文件核哈希,确认传输没损坏 / 没被改动。 > 用途:对方收到后可以逐文件核哈希,确认传输没损坏 / 没被改动。
+67
View File
@@ -0,0 +1,67 @@
/* =============================================================================
* 金钻宇宙 · 星系图配置(config.js)—— 日常改动只改这一个文件
* -----------------------------------------------------------------------------
* 1. UNIVERSES :世界线的「档案内容」(和门户页原来的 UNIVERSES 字段一模一样,可以直接拷过来)
* 2. LOOKS :每条世界线在星系图上「长什么样」(星球风格、颜色、卫星、光环、在哪条旋臂上)
* 3. GALAXY :整个星系的配色、旋臂、粒子数量、扇区名
* 加一条新世界线 = UNIVERSES 里加一条 + LOOKS 里按编号加一条外观(不写外观就用「空槽」的样子)。
* ============================================================================= */
window.JZ_UNIVERSE = {
// ---------------------------------------------------------------- 1. 档案内容
UNIVERSES: [
{ no: '0000', name: '零号宇宙', kind: '主宇宙', tag: '晶钻超算主宇宙', tags: ['门户主宇宙', '晶钻超算', '多世界线演算'],
desc: '门户主宇宙,也是晶钻超算本体:把平行宇宙压成盘符,逐条演算多世界线。其余编号都是它演算出的分支世界线,零号自身负责总调度与收束。' },
{ no: '0001', name: '火柴人宇宙', kind: '原创', tag: '火柴人的冒险', tags: ['金钻原创', '小时候的课堂', '火柴人的冒险'],
desc: '金钻小时候在课上天马行空画出来的世界线,《火柴人的冒险》就从这里开始。' },
{ no: '0002', name: '极寒世界', kind: '原创', tag: '冰河时期', tags: ['金钻原创', '冰河时期', '那迦彗星', '五大深垒', '2056'],
desc: '2030年代确认北大西洋环流(AMOC)减弱、气候转入长期寒冷;2040年高含水彗星「那迦」撞击北大西洋,水汽化为冰晶云遮蔽日照,冰河期开始。故事发生在2056年,冰河已持续16年,地表约-50℃(极端-90℃)。人类转入五大地下深垒。' },
{ no: '0003', name: '没落赛博城', kind: '二创', tag: '史蒂夫的探险之旅', tags: ['二创', '史蒂夫的探险之旅', '赛博废墟'],
desc: '金钻刚接触动画时随手做的二创世界线:史蒂夫穿过没落的赛博城,一路探险。' },
{ no: '0004', name: '善恶等级', kind: '原创', tag: '设定待定', tags: ['金钻原创', '设定酝酿中'],
desc: '这条世界线的设定还在酝酿中,先留好位置,等金钻想清楚再填。' },
{ no: '0005', empty: true }, { no: '0006', empty: true }, { no: '0007', empty: true },
{ no: '0008', empty: true }, { no: '0009', empty: true }, { no: '0010', empty: true },
],
// ---------------------------------------------------------------- 2. 外观(按编号对应)
// style:crystal 晶体 / paper 铅笔纸面 / ice 冰封 / neon 霓虹城 / duality 善恶两半 / gas 气态 / rock 岩石 / ghost 未点亮
// orbit:[离星系中心多远, 第几条旋臂];moons:绕着它转的卫星(纯装饰,没有档案)
// enter:点开这颗星时的运镜 —— push 推进 / zoom 放大(长焦再推)/ rise 升空俯冲 / warp 跃迁 / orbit 绕行;不写就按顺序轮流
LOOKS: {
'0000': { enter: 'zoom', style: 'crystal', r: 2.6, orbit: [0, 0], accent: '#FFD36E',
why: '晶钻超算:多面体切面像钻石,内部有发光的演算脉络。',
moons: [{ style: 'crystal', r: 0.45, d: 5.0, speed: 0.35, colors: ['#BFF4FF', '#8E7BFF', '#FFE59A', '#FFFFFF'] },
{ style: 'rock', r: 0.32, d: 6.6, speed: 0.22 }] },
'0001': { enter: 'push', style: 'paper', r: 1.25, orbit: [20, 0], accent: '#F6F1E4',
why: '小时候课上画出来的:米白纸面、铅笔等高线、暗面排线、几个红笔圈。',
moons: [{ style: 'paper', r: 0.36, d: 2.6, speed: 0.6, colors: ['#FFF8EC', '#2B2E45', '#E5544B', '#F2C14D'] }] },
'0002': { enter: 'rise', style: 'ice', r: 1.35, orbit: [29, 1], accent: '#9FE3FF',
why: '冰河期地球:纬向冰带、厚极冠、冰裂纹;旁边那颗小卫星是「那迦」彗星残骸。',
moons: [{ style: 'rock', r: 0.3, d: 2.7, speed: 0.5, colors: ['#CFE6FF', '#8FB4E0', '#5C79B8', '#FFFFFF'] }] },
'0003': { enter: 'warp', style: 'neon', r: 1.4, orbit: [38, 2], accent: '#C9A6FF',
why: '没落的赛博城:深紫地表、霓虹街区网格、零星还亮着的窗灯。',
moons: [{ style: 'rock', r: 0.28, d: 3.0, speed: 0.42, colors: ['#3A2F66', '#2A2350', '#1A1535', '#FF5FD2'] },
{ style: 'neon', r: 0.22, d: 3.8, speed: 0.3 }] },
'0004': { enter: 'orbit', style: 'duality', r: 1.3, orbit: [46, 3], accent: '#FFD36E',
why: '设定还在酝酿,先按名字「善恶」做成两半:一半金色白昼,一半紫色夜空,交界一条发光的波浪线。设定定了再换。',
moons: [{ style: 'gas', r: 0.34, d: 2.8, speed: 0.45, colors: ['#FFF0C8', '#F2B84B', '#2D1E57', '#FFFFFF'] }] },
},
EMPTY_LOOK: { style: 'ghost', r: 0.75, accent: '#8E96C8' }, // 空槽的样子(未点亮的星系)
// ---------------------------------------------------------------- 3. 星系整体
GALAXY: {
radius: 60, arms: 4, twist: 0.11,
particles: { desktop: 42000, mobile: 36000 }, // 手机和桌面画面要一致:数量只略少一点
nebulae: { desktop: 32, mobile: 28 },
decorPlanets: { desktop: 14, mobile: 14 }, // 散落在旋臂上的无名星球(只是好看,不能点)
// 配色:深海军蓝底 + 蓝紫星云 + 一点青色 + 暖金色核心。整张图只用这几种颜色。
colors: {
bg: '#070B1C', core: '#FFE2B0', armInner: '#9DB4FF', armOuter: '#7C6BFF', accentStar: '#6FE3D6',
nebula: [['#2F4BD8', '#4FB8E8'], ['#4A35B8', '#7C6BFF'], ['#1C7A8C', '#4FD1C5'], ['#5B3FB8', '#9B8BFF']],
coreNebula: ['#FFC97A', '#B98CFF'], line: '#7F8BC8', ui: '#FFD36E',
},
intro: 'random', // 开场运镜:sweep 盘旋落下 / dive 垂直坠入 / random 每次随机
sectors: ['S-01 · 晨线', 'S-02 · 冰原', 'S-03 · 霓虹', 'S-04 · 衡天', 'S-05 · 未测绘', 'S-06 · 未测绘'],
},
};
+310
View File
@@ -0,0 +1,310 @@
/* =============================================================================
* 金钻宇宙 · 星系图引擎(galaxy.js)
* -----------------------------------------------------------------------------
* 读 window.JZ_UNIVERSE(config.js)→ 画旋臂星系、星云、扇区、补给线、星系(卡通星球 + 卫星)、
* 散落的无名星球;处理拖动 / 滚轮 / 双指缩放 / 点星系飞过去 / 档案卡。
* 只依赖 three.js 和 planets.js。挂载:mountGalaxy({ stage, canvas, labels, panel, ... })
* 嵌进普通页面时可选:
* onFocus(u|null) 选中 / 取消选中某条世界线时回调(页面下方的列表可以跟着高亮)
* layout() 返回 { x, y }:选中时星球往左 / 往上挪多少(屏宽 / 屏高的比例),给档案卡让位
* wheelZoom() 返回 true 时滚轮直接缩放;false 时只有按住 Ctrl 才缩放(嵌在页面里别抢页面滚动)
* 返回 { fly(no), home(), resize() }。画面滚出视口时自动暂停渲染。
* ============================================================================= */
import * as THREE from 'three';
import { makePlanet } from './planets.js?v=1';
export function mountGalaxy(el) {
const CFG = window.JZ_UNIVERSE, G = CFG.GALAXY, C = G.colors;
const { stage, canvas, labels, panel, back, hud } = el;
const reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
const isMob = () => stage.clientWidth < 760;
const MOB = isMob();
const renderer = new THREE.WebGLRenderer({ canvas, antialias: true, powerPreference: 'high-performance' });
renderer.setPixelRatio(Math.min(devicePixelRatio, MOB ? 1.5 : 2));
renderer.outputColorSpace = THREE.SRGBColorSpace;
renderer.setClearColor(C.bg, 1);
const scene = new THREE.Scene(), camera = new THREE.PerspectiveCamera(42, 1, 0.1, 2000);
const R = G.radius, ARMS = G.arms;
const rnd = (a = 0, b = 1) => a + Math.random() * (b - a);
const gauss = () => { let u = 0, v = 0; while (!u) u = Math.random(); while (!v) v = Math.random(); return Math.sqrt(-2 * Math.log(u)) * Math.cos(2 * Math.PI * v); };
const armAngle = (r, arm) => arm * Math.PI * 2 / ARMS + r * G.twist;
const LIGHT = new THREE.Vector3(-1, 0.55, 0.6).normalize();
// ============================================================ 旋臂星系(粒子)—— 星点大小有上限,离镜头很近的也不会糊成大光斑
const galaxy = (() => {
const N = MOB ? G.particles.mobile : G.particles.desktop, pos = new Float32Array(N * 3), col = new Float32Array(N * 3), sz = new Float32Array(N);
const cCore = new THREE.Color(C.core), cIn = new THREE.Color(C.armInner), cOut = new THREE.Color(C.armOuter), cAcc = new THREE.Color(C.accentStar), c = new THREE.Color();
for (let i = 0; i < N; i++) {
const r = Math.pow(Math.random(), 0.55) * R, arm = i % ARMS, spread = (0.6 + r * 0.09) * gauss();
const a = armAngle(r, arm) + spread / Math.max(r, 3) + (Math.random() < 0.22 ? rnd(-Math.PI, Math.PI) : 0);
pos.set([Math.cos(a) * r + gauss() * 0.8, gauss() * (2.2 * Math.exp(-r / 18) + 0.35), Math.sin(a) * r + gauss() * 0.8], i * 3);
const t = r / R; c.copy(cCore).lerp(cIn, Math.min(1, t * 2.4)).lerp(cOut, Math.max(0, t * 1.5 - 0.5));
if (Math.random() < 0.04) c.copy(cAcc);
col.set([c.r, c.g, c.b], i * 3); sz[i] = Math.random() < 0.012 ? rnd(3, 5.5) : rnd(0.6, 2.0);
}
const g = new THREE.BufferGeometry();
g.setAttribute('position', new THREE.BufferAttribute(pos, 3)); g.setAttribute('color', new THREE.BufferAttribute(col, 3)); g.setAttribute('size', new THREE.BufferAttribute(sz, 1));
const m = new THREE.ShaderMaterial({ transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, vertexColors: true,
uniforms: { uPx: { value: renderer.getPixelRatio() }, uDim: { value: 1 }, uK: { value: 1 } },
vertexShader: `attribute float size; varying vec3 vC; uniform float uPx; uniform float uK;
void main(){ vC = color; vec4 mv = modelViewMatrix*vec4(position,1.0); gl_PointSize = clamp(size*uPx*uK*(150.0/-mv.z), 1.1, 7.0*uPx); gl_Position = projectionMatrix*mv; }`,
fragmentShader: `varying vec3 vC; uniform float uDim; void main(){ vec2 p = gl_PointCoord-0.5; float d = length(p); if(d>0.5) discard;
float a = smoothstep(0.5,0.0,d); gl_FragColor = vec4(vC*(0.55+a*1.1), a*0.85*uDim); }` });
const pts = new THREE.Points(g, m); scene.add(pts); return pts;
})();
// ============================================================ 星云(噪声云,沿旋臂;颜色只取 config 里那几组)
const nebulaMat = (c1, c2, seed, alpha) => new THREE.ShaderMaterial({ transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide,
uniforms: { uT: { value: 0 }, uA: { value: new THREE.Color(c1) }, uB: { value: new THREE.Color(c2) }, uS: { value: seed }, uO: { value: alpha }, uDim: { value: 1 } },
vertexShader: `varying vec2 vU; void main(){ vU = uv; gl_Position = projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
fragmentShader: `uniform float uT; uniform vec3 uA; uniform vec3 uB; uniform float uS; uniform float uO; uniform float uDim; varying vec2 vU;
float h(vec2 p){ return fract(sin(dot(p,vec2(127.1,311.7))+uS)*43758.5453); }
float n(vec2 p){ vec2 i=floor(p), f=fract(p); f=f*f*(3.0-2.0*f); return mix(mix(h(i),h(i+vec2(1,0)),f.x),mix(h(i+vec2(0,1)),h(i+vec2(1,1)),f.x),f.y); }
float fbm(vec2 p){ float v=0.0, a=0.5; for(int i=0;i<6;i++){ v+=a*n(p); p=p*2.03+vec2(1.7,9.2); a*=0.5; } return v; }
void main(){ vec2 p = vU-0.5; float r = length(p)*2.0; if(r>1.0) discard;
vec2 q = vU*3.0 + uS; float w = fbm(q + vec2(uT*0.02, -uT*0.015)); float d = fbm(q*1.7 + w*2.4 + vec2(-uT*0.01, uT*0.02));
float shape = smoothstep(1.0, 0.15, r) * smoothstep(0.32, 0.85, d); float dust = smoothstep(0.55, 0.75, fbm(q*3.1 - w));
gl_FragColor = vec4(mix(uA, uB, smoothstep(0.3, 0.9, d)) * (0.6 + d), shape * (1.0 - dust*0.6) * uO * uDim); }` });
const nebulae = [];
{ const n = MOB ? G.nebulae.mobile : G.nebulae.desktop;
for (let i = 0; i < n; i++) {
const r = rnd(8, R * 0.95), a = armAngle(r, i % ARMS) + rnd(-0.35, 0.35), pal = C.nebula[i % C.nebula.length], s = rnd(14, 34) * (1.1 - r / R * 0.4);
const m = new THREE.Mesh(new THREE.PlaneGeometry(s, s), nebulaMat(pal[0], pal[1], rnd(0, 100), rnd(0.32, 0.55)));
m.position.set(Math.cos(a) * r, rnd(-1.5, 1.5), Math.sin(a) * r); m.rotation.set(-Math.PI / 2 + rnd(-0.25, 0.25), 0, rnd(0, Math.PI)); scene.add(m); nebulae.push(m);
}
const core = new THREE.Mesh(new THREE.PlaneGeometry(34, 34), nebulaMat(C.coreNebula[0], C.coreNebula[1], 7, 0.5)); core.rotation.x = -Math.PI / 2; scene.add(core); nebulae.push(core); }
const glow = (color, size, op = 1) => { const c = document.createElement('canvas'); c.width = c.height = 128; const x = c.getContext('2d');
const g = x.createRadialGradient(64, 64, 0, 64, 64, 64); g.addColorStop(0, 'rgba(255,255,255,1)'); g.addColorStop(0.22, color); g.addColorStop(1, 'rgba(0,0,0,0)'); x.fillStyle = g; x.fillRect(0, 0, 128, 128);
const s = new THREE.Sprite(new THREE.SpriteMaterial({ map: new THREE.CanvasTexture(c), blending: THREE.AdditiveBlending, depthWrite: false, transparent: true, opacity: op })); s.scale.setScalar(size); return s; };
scene.add(glow('rgba(255,215,150,.28)', 15, 0.7)); // 核心的柔光(收着点,之前太曝)
{ const N = MOB ? 1100 : 2400, p = new Float32Array(N * 3); // 远处整球背景星
for (let i = 0; i < N; i++) { const u = rnd(-1, 1), t = rnd(0, Math.PI * 2), s = Math.sqrt(1 - u * u), r = rnd(500, 900); p.set([Math.cos(t) * s * r, u * r, Math.sin(t) * s * r], i * 3); }
const g = new THREE.BufferGeometry(); g.setAttribute('position', new THREE.BufferAttribute(p, 3));
scene.add(new THREE.Points(g, new THREE.PointsMaterial({ color: 0xC9D3FF, size: 1.2, sizeAttenuation: false, transparent: true, opacity: 0.6 }))); }
// ============================================================ 扇区:同心环 + 分隔虚线 + 扇区名
const lineCol = new THREE.Color(C.line), guides = [];
const addLine = (pts, dashed, op) => { const g = new THREE.BufferGeometry().setFromPoints(pts);
const m = dashed ? new THREE.LineDashedMaterial({ color: lineCol, dashSize: 1.2, gapSize: 1.4, transparent: true, opacity: op, depthWrite: false })
: new THREE.LineBasicMaterial({ color: lineCol, transparent: true, opacity: op, depthWrite: false });
const l = new THREE.Line(g, m); if (dashed) l.computeLineDistances(); l.userData.op = op; scene.add(l); guides.push(l); return l; };
for (const [rr, op] of [[16, 0.16], [32, 0.11], [48, 0.09], [R + 4, 0.16]]) { const pts = []; for (let k = 0; k <= 256; k++) { const a = k / 256 * Math.PI * 2; pts.push(new THREE.Vector3(Math.cos(a) * rr, 0, Math.sin(a) * rr)); } addLine(pts, false, op); }
for (let k = 0; k < 6; k++) { const a = k / 6 * Math.PI * 2 + 0.3; addLine([new THREE.Vector3(Math.cos(a) * 16, 0, Math.sin(a) * 16), new THREE.Vector3(Math.cos(a) * (R + 4), 0, Math.sin(a) * (R + 4))], true, 0.12); }
const sectorTags = G.sectors.map((name, k) => { const d = document.createElement('div'); d.className = 'sector'; d.textContent = name; labels.appendChild(d);
const a = (k + 0.5) / 6 * Math.PI * 2 + 0.3; return { el: d, p: new THREE.Vector3(Math.cos(a) * (R + 9), 0, Math.sin(a) * (R + 9)) }; });
// ============================================================ 星系(每条世界线一颗卡通星球 + 卫星)
const systems = [], planets = [];
const lit = CFG.UNIVERSES.filter(u => !u.empty), empty = CFG.UNIVERSES.filter(u => u.empty);
CFG.UNIVERSES.forEach((u, i) => {
const ei = empty.indexOf(u);
const L = Object.assign({}, CFG.EMPTY_LOOK, CFG.LOOKS[u.no] || {});
if (!CFG.LOOKS[u.no]) L.orbit = [R * (0.8 + 0.12 * (ei % 2)), ei % ARMS]; // 空槽放在外圈,按顺序分到各条旋臂
const [r, arm] = L.orbit || [R * 0.85, i % ARMS];
const a = r ? armAngle(r, arm) + (u.empty ? 0.32 * Math.floor(ei / ARMS) : 0) : 0;
const g = new THREE.Group(); g.position.set(Math.cos(a) * r, 0, Math.sin(a) * r); scene.add(g);
const p = makePlanet(THREE, Object.assign({ seed: i * 7.3 + 1 }, L)); g.add(p.group); planets.push(p);
const moons = (L.moons || []).map((m, k) => { const piv = new THREE.Group(); piv.rotation.x = 0.35 - k * 0.2; piv.rotation.y = k * 2.1; g.add(piv);
const mp = makePlanet(THREE, Object.assign({ seed: i * 13 + k * 3.1, spin: 0.4 }, m)); mp.group.position.x = m.d; piv.add(mp.group); planets.push(mp); return { piv, speed: Math.abs(m.speed || 0.3) }; }); // 卫星一律同一个方向转(和星系自转同向)
const tag = document.createElement('button'); tag.type = 'button'; tag.className = 'tag' + (u.empty ? ' empty' : ''); tag.style.setProperty('--c', L.accent || C.ui);
tag.innerHTML = '<span class="t"><b>' + (u.empty ? '空槽' : u.name) + '</b><em>' + u.no + (u.empty ? ' · 未点亮' : ' · ' + u.kind) + '</em></span>';
labels.appendChild(tag);
const s = { u, L, g, planet: p, moons, tag }; p.body.userData.s = s; systems.push(s);
tag.addEventListener('click', () => fly(s));
});
// 补给线:核心 → 每个星系,虚线往外流
const supply = [];
for (const s of systems) { if (s.u.no === '0000') continue;
const b = s.g.position.clone(), mid = b.clone().multiplyScalar(0.5); mid.y += b.length() * 0.12;
const l = new THREE.Line(new THREE.BufferGeometry().setFromPoints(new THREE.QuadraticBezierCurve3(new THREE.Vector3(), mid, b).getPoints(80)),
new THREE.LineDashedMaterial({ color: s.u.empty ? lineCol : new THREE.Color(C.ui), dashSize: 0.9, gapSize: 0.8, transparent: true, opacity: s.u.empty ? 0.14 : 0.42, depthWrite: false }));
l.computeLineDistances(); l.userData.op = l.material.opacity; scene.add(l); supply.push(l); }
// 散落的无名星球(只是让星系看起来有人住;不进档案、不能点)
// 位置挑过:离核心、离每个星系(含它的卫星轨道)、彼此之间都留足距离,不会叠在一起
{ const n = MOB ? G.decorPlanets.mobile : G.decorPlanets.desktop, styles = ['gas', 'rock', 'gas', 'rock', 'ice'];
const pals = [['#F2D7A6', '#D99A6C', '#8E6BBF', '#FFF2D6'], ['#BFD0FF', '#7C8FD6', '#4A5BA8', '#FFFFFF'], ['#9FE3D6', '#4FB8A8', '#2F6F8C', '#E6FFF8'], ['#D6C2FF', '#9B8BFF', '#5B3FB8', '#FFFFFF']];
const taken = systems.map(s => ({ p: s.g.position, r: s.L.r * 3 + Math.max(0, ...(s.L.moons || []).map(m => m.d + m.r)) + 3 }));
taken.push({ p: new THREE.Vector3(), r: 14 });
let made = 0;
for (let tries = 0; made < n && tries < n * 60; tries++) {
const r = rnd(16, R * 0.96), a = armAngle(r, Math.floor(rnd(0, ARMS))) + rnd(-0.45, 0.45), size = rnd(0.35, 0.8);
const pos = new THREE.Vector3(Math.cos(a) * r, rnd(-0.8, 0.8), Math.sin(a) * r);
if (taken.some(o => o.p.distanceTo(pos) < o.r + size + 2.5)) continue;
const p = makePlanet(THREE, { style: styles[made % styles.length], r: size, colors: pals[made % pals.length], seed: made * 5.1, outline: '#141833', spin: rnd(0.05, 0.2) });
p.group.position.copy(pos); scene.add(p.group); planets.push(p); taken.push({ p: pos, r: size + 2 }); made++;
} }
el.counts && el.counts(CFG.UNIVERSES.length, lit.length, empty.length);
// ============================================================ 相机 + 交互(拖动、滚轮、双指缩放)
const HOME = () => ({ az: 0.7, el: isMob() ? 1.08 : 0.62, dist: isMob() ? 155 : 112 });
// ============================================================ 运镜库(全部按时间走,和帧率无关)
// 每个运镜 = 时长 + 一条路径函数 path(from, to, k):k 是 0→1 的进度,往 view 里写这一刻的相机状态。
// 相机状态:az 方位角 / el 仰角 / dist 距离 / tx,ty,tz 看向哪 / fov 视角 / roll 滚转。
// 加一种新运镜:往 MOVES 里加一项,然后在 config.js 的 LOOKS[编号].enter 里写它的名字。
const FOV = 42;
const lerp = (a, b, k) => a + (b - a) * k, clamp01 = k => Math.max(0, Math.min(1, k));
const E = {
io: k => k < 0.5 ? 4 * k * k * k : 1 - Math.pow(-2 * k + 2, 3) / 2, // 缓入缓出
out: k => 1 - Math.pow(1 - k, 3), // 先快后慢
in: k => k * k * k,
io5: k => k < 0.5 ? 16 * k ** 5 : 1 - Math.pow(-2 * k + 2, 5) / 2, // 更「沉」的缓入缓出
expo: k => k === 0 ? 0 : k === 1 ? 1 : k < 0.5 ? Math.pow(2, 20 * k - 10) / 2 : (2 - Math.pow(2, -20 * k + 10)) / 2,
};
const KEYS = ['az', 'el', 'dist', 'tx', 'ty', 'tz', 'fov', 'roll'];
const mix = (f, to, k, keys = KEYS) => { for (const key of keys) view[key] = lerp(f[key], to[key], k); };
const MOVES = {
// 绕行:边飞边绕过去,中途抬高拉远一点(原来那种)
orbit: { dur: 1700, path(f, to, k) { const e = E.io(k); mix(f, to, e); view.el += Math.sin(Math.PI * e) * 0.28; view.dist *= 1 + Math.sin(Math.PI * e) * 0.22; } },
// 推进:镜头先转过去对准(前 40%),再笔直推进去(不绕圈)
push: { dur: 1600, path(f, to, k) { const look = E.out(clamp01(k / 0.45)), go = E.io5(k);
mix(f, to, look, ['tx', 'ty', 'tz', 'az', 'el']); mix(f, to, go, ['dist']); view.fov = FOV; view.roll = 0; } },
// 放大:先用「长焦」把它拉近(视角收窄),再一边推进一边把视角放回来 —— 有点希区柯克变焦的味道
zoom: { dur: 2000, path(f, to, k) { const k1 = clamp01(k / 0.45), k2 = clamp01((k - 0.45) / 0.55);
mix(f, to, E.out(clamp01(k / 0.35)), ['tx', 'ty', 'tz']); mix(f, to, E.io(k), ['az', 'el']);
view.fov = k < 0.45 ? lerp(f.fov, 14, E.out(k1)) : lerp(14, to.fov, E.io(k2));
view.dist = lerp(f.dist, to.dist, E.io(k2)); view.roll = 0; } },
// 升空俯冲:先拉高到几乎俯视,再从上面扎下去
rise: { dur: 2100, path(f, to, k) { const e = E.io(k); mix(f, to, e);
const up = Math.sin(Math.PI * clamp01(k * 1.15)); view.el = lerp(view.el, 1.35, up * 0.85); view.dist *= 1 + up * 0.55; } },
// 跃迁:慢起步、中段猛冲、末段刹住;冲的时候视角张开、镜头轻轻一滚
warp: { dur: 1800, path(f, to, k) { const e = E.expo(k), s = Math.sin(Math.PI * k);
mix(f, to, e); view.fov = to.fov + s * s * 34; view.roll = s * 0.18 * (f.az > to.az ? 1 : -1); } },
// 拉远:回星系图用 —— 先往后退,再抬头看全景
pull: { dur: 1700, path(f, to, k) { mix(f, to, E.io5(k), ['dist']); mix(f, to, E.out(clamp01((k - 0.15) / 0.85)), ['tx', 'ty', 'tz', 'el', 'az']);
view.fov = lerp(f.fov, to.fov, E.io(k)); view.roll = lerp(f.roll, 0, E.io(k)); } },
// 开场 A · 盘旋落下:从高空、更远处绕半圈落到正常视角
introSweep: { dur: 3600, path(f, to, k) { mix(f, to, E.io(k)); } },
// 开场 B · 垂直坠入:从正上方很远的地方直着往下落,最后才抬起镜头、星系转正
introDive: { dur: 3400, path(f, to, k) { const d = E.io5(k); view.dist = lerp(f.dist, to.dist, d); view.el = lerp(f.el, to.el, E.in(clamp01((k - 0.35) / 0.65)));
view.az = lerp(f.az, to.az, E.io(k)); view.fov = lerp(f.fov, to.fov, E.out(k)); view.tx = view.ty = view.tz = 0; view.roll = 0; } },
};
const h0 = HOME();
const introKind = (G.intro === 'dive' || G.intro === 'sweep') ? G.intro : (Math.random() < 0.5 ? 'dive' : 'sweep');
const START = introKind === 'dive' ? { az: h0.az + 0.6, el: 1.52, dist: h0.dist * 3.2, fov: 30 } : { az: h0.az - 1.5, el: 1.42, dist: h0.dist * 2.4, fov: FOV };
const view = Object.assign({ tx: 0, ty: 0, tz: 0, roll: 0, fov: FOV }, reduce ? h0 : START);
const want = Object.assign({ fov: FOV, roll: 0 }, h0);
let anim = null, intro = !reduce;
// 用户中途拖动 / 缩放:运镜立刻停在原地交还控制权,但没出来的档案卡要马上补上(不然卡就丢了)
function cancelAnim() { if (!anim) return; const f = anim.onArrive; anim = null; f && f(); }
// to 里没写的 fov / roll 默认回到正常;az 走最近的那一边转
function animate(to, move = 'orbit', onArrive = null, arriveAt = 0.8) {
to = Object.assign({ fov: FOV, roll: 0 }, to);
if (reduce) { Object.assign(view, to); Object.assign(want, to); anim = null; onArrive && onArrive(); return; }
const daz = ((to.az - view.az) % (Math.PI * 2) + Math.PI * 3) % (Math.PI * 2) - Math.PI;
const M = MOVES[move] || MOVES.orbit;
anim = { t0: performance.now(), M, from: Object.assign({}, view), to: Object.assign({}, to, { az: view.az + daz }), onArrive, arriveAt };
}
let focus = null, hover = null;
function fit() { const w = stage.clientWidth, h = stage.clientHeight; renderer.setSize(w, h, false); camera.aspect = w / h; camera.updateProjectionMatrix(); }
addEventListener('resize', fit); fit();
const ptrs = new Map(); let drag = null, pinch = null;
canvas.addEventListener('pointerdown', e => { canvas.setPointerCapture(e.pointerId); ptrs.set(e.pointerId, { x: e.clientX, y: e.clientY });
if (ptrs.size === 2) { const [a, b] = [...ptrs.values()]; pinch = { d: Math.hypot(a.x - b.x, a.y - b.y), dist: want.dist }; drag = null; }
else drag = { x: e.clientX, y: e.clientY, az: want.az, el: want.el, moved: false }; });
canvas.addEventListener('pointermove', e => {
if (ptrs.has(e.pointerId)) ptrs.set(e.pointerId, { x: e.clientX, y: e.clientY });
if (pinch && ptrs.size === 2) { const [a, b] = [...ptrs.values()]; zoomTo(pinch.dist * pinch.d / Math.max(20, Math.hypot(a.x - b.x, a.y - b.y))); return; }
if (drag) { const dx = e.clientX - drag.x, dy = e.clientY - drag.y; if (Math.abs(dx) + Math.abs(dy) > 6) drag.moved = true;
if (drag.moved) { if (anim) { cancelAnim(); Object.assign(want, view); drag.az = view.az + dx * 0.005; drag.el = view.el - dy * 0.004; } /* 从镜头现在的位置接着拖,不跳 */ want.az = drag.az - dx * 0.005; want.el = THREE.MathUtils.clamp(drag.el + dy * 0.004, 0.08, 1.45); } return; }
if (e.pointerType === 'mouse') { hover = pick(e); canvas.style.cursor = hover ? 'pointer' : 'grab'; } });
const end = e => { ptrs.delete(e.pointerId); if (ptrs.size < 2) pinch = null;
const d = drag; drag = null; if (d && !d.moved && e.type === 'pointerup') { const s = pick(e); if (s) fly(s); else if (focus) home(); } };
canvas.addEventListener('pointerup', end); canvas.addEventListener('pointercancel', end);
const zoomTo = d => { if (anim) { cancelAnim(); Object.assign(want, view); } want.dist = THREE.MathUtils.clamp(d, focus ? focus.L.r * 2.6 : 32, focus ? focus.L.r * 16 : 230); };
canvas.addEventListener('wheel', e => {
if (el.wheelZoom && !el.wheelZoom() && !e.ctrlKey) return; // 嵌在页面里:普通滚轮留给页面滚动
e.preventDefault(); zoomTo(want.dist * (1 + Math.sign(e.deltaY) * 0.1)); }, { passive: false });
addEventListener('keydown', e => { if (e.key === 'Escape') home(); if (focus && e.key === 'ArrowRight') step(1); if (focus && e.key === 'ArrowLeft') step(-1); });
back && (back.onclick = () => home());
const ray = new THREE.Raycaster(), ptr = new THREE.Vector2(), tmp = new THREE.Vector3();
function pick(e) {
const r = canvas.getBoundingClientRect(); ptr.set((e.clientX - r.left) / r.width * 2 - 1, -(e.clientY - r.top) / r.height * 2 + 1);
ray.setFromCamera(ptr, camera); const hit = ray.intersectObjects(systems.map(s => s.planet.body), false)[0]; if (hit) return hit.object.userData.s;
let best = null, bd = isMob() ? 34 : 28;
for (const s of systems) { s.g.getWorldPosition(tmp).project(camera); const d = Math.hypot((tmp.x - ptr.x) * r.width / 2, (tmp.y - ptr.y) * r.height / 2); if (d < bd && tmp.z < 1) { bd = d; best = s; } }
return best;
}
const esc = x => String(x || '').replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
function card(s) { const u = s.u, nav = '<div class="nav"><button class="btn" type="button" data-s="-1">上一个</button><button class="btn" type="button" data-s="1">下一个</button></div>';
if (u.empty) return '<div class="card" style="--pc:' + (s.L.accent) + '"><div class="k">UNIVERSE ' + u.no + ' · 未点亮</div><h2>空槽</h2><div class="tg">这条世界线还没写出来,星系还没被点亮。</div><div class="acts">' + nav + '<button class="btn" type="button" data-home>回到星系图</button></div></div>';
return '<div class="card" style="--pc:' + s.L.accent + '"><div class="k">UNIVERSE ' + u.no + ' · ' + esc(u.kind) + ' · 已点亮</div><h2>' + esc(u.name) + '</h2><div class="tg">' + esc(u.tag) + '</div>' +
'<p class="ds">' + esc(u.desc) + '</p><div class="tags">' + (u.tags || []).map(t => '<span>' + esc(t) + '</span>').join('') + '</div><div class="acts">' + nav + '<button class="btn pri" type="button" data-home>回到星系图</button></div></div>'; }
panel && panel.addEventListener('click', e => { const b = e.target.closest('[data-s]'); if (b) step(+b.dataset.s); if (e.target.closest('[data-home]')) home(); });
function step(d) { const i = systems.indexOf(focus); fly(systems[(i + d + systems.length) % systems.length]); }
// 飞过去:先把旧档案卡收起来 → 镜头按这颗星的「入场运镜」飞 → 快到(80%)的时候档案卡才滑出来,和星球落定同步
const ENTER_CYCLE = ['push', 'zoom', 'rise', 'warp', 'orbit'];
function fly(s) { const was = focus; focus = s; intro = false; stage.classList.add('ready'); stage.classList.add('focus');
panel && panel.classList.remove('on'); el.onFocus && el.onFocus(s.u, 'start');
const p = s.g.position, dist = s.L.r * (isMob() ? 9 : 5.6) + (s.moons.length ? s.L.r * 1.5 : 0);
const i = systems.indexOf(s), move = s.L.enter || ENTER_CYCLE[i % ENTER_CYCLE.length];
// 推进 / 放大:沿着现在的视线方向过去(不绕);其它运镜:落到「从星系中心那一侧看过去」的角度,背景是星系盘
const az = (move === 'push' || move === 'zoom') ? view.az + 0.12 : Math.atan2(p.x, p.z) + 0.35;
animate({ az, el: 0.24, dist, tx: p.x, ty: p.y, tz: p.z }, was && was !== s && move !== 'warp' ? 'orbit' : move, () => {
if (focus !== s) return;
panel && (panel.innerHTML = card(s), panel.classList.add('on')); el.onFocus && el.onFocus(s.u, 'arrive'); }, 0.78); }
function home() { if (!focus) return; focus = null; panel && panel.classList.remove('on'); stage.classList.remove('focus'); el.onFocus && el.onFocus(null, 'start');
animate(Object.assign(HOME(), { tx: 0, ty: 0, tz: 0, az: view.az - 0.3 }), 'pull'); }
// ============================================================ 循环
const clock = new THREE.Clock(), tgt = new THREE.Vector3();
let hudBottom = 0; const measureHud = () => { hudBottom = hud ? hud.getBoundingClientRect().bottom - stage.getBoundingClientRect().top : 0; }; measureHud(); addEventListener('resize', measureHud);
let visible = true, started = false, tIntro = 0;
if ('IntersectionObserver' in window) new IntersectionObserver(es => { visible = es[0].isIntersecting; }, { threshold: 0.05 }).observe(stage);
function loop() {
requestAnimationFrame(loop);
if (!visible) { clock.getDelta(); return; } // 滚出视口:不渲染,省电
if (!started) { started = true; tIntro = clock.elapsedTime; if (intro) animate(Object.assign({}, h0, { tx: 0, ty: 0, tz: 0 }), introKind === 'dive' ? 'introDive' : 'introSweep'); else stage.classList.add('ready'); }
const dt = Math.min(clock.getDelta(), 0.05), t = clock.elapsedTime, mob = isMob();
if (!reduce) { galaxy.rotation.y += dt * 0.004; for (const n of nebulae) n.material.uniforms.uT.value = t; }
for (const l of supply) l.material.dashOffset -= dt * 2;
for (const p of planets) p.update(reduce ? 0 : dt, t, LIGHT);
// 星系在总览里放大一点(不然在手机上只是一个小点),飞近时恢复真实大小
const sysK = focus ? 1 : (mob ? 1.9 : 1.35);
for (const s of systems) { for (const m of s.moons) m.piv.rotation.y += (reduce ? 0 : dt) * m.speed;
const sc = s.g.scale.x + (sysK - s.g.scale.x) * (reduce ? 1 : Math.min(1, dt * 3)); s.g.scale.setScalar(sc); }
// 开场:星系从暗处亮起来(0 → 1,大约 2.4 秒);飞近一颗星时:星云、粒子、扇区线退后一点,别抢主角
const introK = intro ? Math.min(1, (t - tIntro) / 2.4) : 1;
const dimT = (focus ? 0.45 : 1) * introK;
galaxy.material.uniforms.uDim.value += (dimT - galaxy.material.uniforms.uDim.value) * (intro ? 1 : Math.min(1, dt * 3));
galaxy.material.uniforms.uK.value = 112 / HOME().dist;
for (const n of nebulae) n.material.uniforms.uDim.value = galaxy.material.uniforms.uDim.value;
for (const l of guides.concat(supply)) l.material.opacity += (l.userData.op * (focus ? 0.25 : 1) * introK - l.material.opacity) * Math.min(1, dt * 3);
// 相机:有补间就按时间走补间(不受帧率影响,一条连贯的弧线);没有就柔和地跟着拖动 / 缩放
if (anim) {
const a = anim, kk = Math.min(1, (performance.now() - a.t0) / a.M.dur);
a.M.path(a.from, a.to, kk);
if (a.onArrive && kk >= a.arriveAt) { const f = a.onArrive; a.onArrive = null; f(); } // 档案卡和星球落定同步出现
if (kk >= 1) { Object.assign(view, a.to); Object.assign(want, a.to); if (anim === a) anim = null; if (!focus) stage.classList.add('ready'); }
} else {
view.fov += (FOV - view.fov) * Math.min(1, dt * 4); view.roll += (0 - view.roll) * Math.min(1, dt * 4);
if (focus) focus.g.getWorldPosition(tgt); else tgt.set(0, 0, 0);
const k = 1 - Math.exp(-dt * 6);
view.tx += (tgt.x - view.tx) * k; view.ty += (tgt.y - view.ty) * k; view.tz += (tgt.z - view.tz) * k;
for (const key of ['az', 'el', 'dist']) view[key] += (want[key] - view[key]) * k;
if (!drag && !pinch && !focus && !reduce) want.az += dt * 0.02;
}
camera.position.set(view.tx + Math.sin(view.az) * Math.cos(view.el) * view.dist, view.ty + Math.sin(view.el) * view.dist, view.tz + Math.cos(view.az) * Math.cos(view.el) * view.dist);
camera.lookAt(view.tx, view.ty, view.tz);
if (view.roll) camera.rotateZ(view.roll);
if (Math.abs(camera.fov - view.fov) > 0.01) { camera.fov = view.fov; camera.updateProjectionMatrix(); }
// 选中时把星球挪开,给档案卡让位:桌面往左挪,手机往上挪(档案卡在下半屏)
const w = stage.clientWidth, h = stage.clientHeight;
const lay = el.layout ? el.layout() : { x: mob ? 0 : 0.16, y: mob ? 0.22 : 0 };
if (focus && (lay.x || lay.y)) camera.setViewOffset(w, h, w * lay.x, h * lay.y, w, h); else camera.clearViewOffset();
// 名牌:跟着星系走;贴边夹住不出屏;手机上压到 HUD 下面的藏起来
for (const s of systems) { s.g.getWorldPosition(tmp); tmp.project(camera);
let x = (tmp.x + 1) / 2 * w + 10, y = (1 - tmp.y) / 2 * h - 12;
const tw = s.tag.offsetWidth || 90; x = Math.min(Math.max(x, 6), w - tw - 6);
const vis = tmp.z < 1 && Math.abs(tmp.x) < 1.05 && Math.abs(tmp.y) < 1.05 && !(mob && y < hudBottom + 4) && focus !== s;
s.tag.style.transform = 'translate(' + x.toFixed(1) + 'px,' + y.toFixed(1) + 'px)';
s.tag.classList.toggle('hot', s === hover); s.tag.classList.toggle('dim', !!focus); s.tag.style.visibility = vis ? '' : 'hidden'; }
for (const st of sectorTags) { tmp.copy(st.p).project(camera); st.el.style.transform = 'translate(' + ((tmp.x + 1) / 2 * w) + 'px,' + ((1 - tmp.y) / 2 * h) + 'px) translate(-50%,-50%)'; st.el.style.opacity = (tmp.z < 1 && !focus) ? '' : 0; }
renderer.render(scene, camera);
if (firstFrame) { firstFrame = false; el.onReady && el.onReady(); } // 第一帧画好了,外面的「载入中」再淡出
}
// 开场:第一帧画出来再开始(外面的「载入中」此时淡出,镜头接着就开始动,中间不留空白)
let firstFrame = true;
loop();
return { resize: fit, fly: no => { const s = systems.find(x => x.u.no === no); if (s) fly(s); }, home };
}
+222
View File
@@ -0,0 +1,222 @@
/* =============================================================================
* 金钻宇宙 · 卡通星球材质库(planets.js)
* -----------------------------------------------------------------------------
* 每一种「风格」= 一段着色器(决定星球表面长什么样)+ 一组默认参数。
* 全部是程序生成的卡通材质:分段明暗(toon)+ 墨线描边 + 轮廓光,不依赖任何贴图文件。
*
* 加一种新风格:在 STYLES 里加一项 { geo, frag, defaults },见交接说明「加一种星球风格」。
* 用法:
* import { makePlanet } from './planets.js';
* const p = makePlanet(THREE, { style: 'ice', r: 1.2, colors: [...] });
* scene.add(p.group); // p.update(dt, t, lightDirWorld) 每帧调一次
* ============================================================================= */
// ---- 3D simplex 噪声(Ashima / Stefan Gustavson,MIT)—— 用物体空间坐标取样,球面上没有接缝
const NOISE = `
vec3 m289(vec3 x){return x-floor(x*(1.0/289.0))*289.0;} vec4 m289(vec4 x){return x-floor(x*(1.0/289.0))*289.0;}
vec4 perm(vec4 x){return m289(((x*34.0)+1.0)*x);} vec4 tis(vec4 r){return 1.79284291400159-0.85373472095314*r;}
float snoise(vec3 v){const vec2 C=vec2(1.0/6.0,1.0/3.0);const vec4 D=vec4(0.0,0.5,1.0,2.0);
vec3 i=floor(v+dot(v,C.yyy));vec3 x0=v-i+dot(i,C.xxx);vec3 g=step(x0.yzx,x0.xyz);vec3 l=1.0-g;
vec3 i1=min(g.xyz,l.zxy);vec3 i2=max(g.xyz,l.zxy);vec3 x1=x0-i1+C.xxx;vec3 x2=x0-i2+C.yyy;vec3 x3=x0-D.yyy;
i=m289(i);vec4 p=perm(perm(perm(i.z+vec4(0.0,i1.z,i2.z,1.0))+i.y+vec4(0.0,i1.y,i2.y,1.0))+i.x+vec4(0.0,i1.x,i2.x,1.0));
float n_=0.142857142857;vec3 ns=n_*D.wyz-D.xzx;vec4 j=p-49.0*floor(p*ns.z*ns.z);vec4 x_=floor(j*ns.z);vec4 y_=floor(j-7.0*x_);
vec4 x=x_*ns.x+ns.yyyy;vec4 y=y_*ns.x+ns.yyyy;vec4 h=1.0-abs(x)-abs(y);vec4 b0=vec4(x.xy,y.xy);vec4 b1=vec4(x.zw,y.zw);
vec4 s0=floor(b0)*2.0+1.0;vec4 s1=floor(b1)*2.0+1.0;vec4 sh=-step(h,vec4(0.0));vec4 a0=b0.xzyw+s0.xzyw*sh.xxyy;vec4 a1=b1.xzyw+s1.xzyw*sh.zzww;
vec3 p0=vec3(a0.xy,h.x);vec3 p1=vec3(a0.zw,h.y);vec3 p2=vec3(a1.xy,h.z);vec3 p3=vec3(a1.zw,h.w);
vec4 nm=tis(vec4(dot(p0,p0),dot(p1,p1),dot(p2,p2),dot(p3,p3)));p0*=nm.x;p1*=nm.y;p2*=nm.z;p3*=nm.w;
vec4 m=max(0.6-vec4(dot(x0,x0),dot(x1,x1),dot(x2,x2),dot(x3,x3)),0.0);m=m*m;
return 42.0*dot(m*m,vec4(dot(p0,x0),dot(p1,x1),dot(p2,x2),dot(p3,x3)));}
float fbm(vec3 p){ float v=0.0,a=0.5; for(int i=0;i<4;i++){ v+=a*snoise(p); p=p*2.02+vec3(3.1,1.7,5.3); a*=0.5; } return v; }
// 抗锯齿的细线:x 离 0 越近越黑,线宽 w(以屏幕像素为单位)
float aline(float x, float w){ float f = fwidth(x); return 1.0 - smoothstep(0.0, f*w, abs(x)); }
`;
// ---- 公共部分:分段明暗 + 冷色阴影 + 轮廓光
const HEAD = `
uniform vec3 uL; uniform float uT; uniform float uSeed; uniform vec3 uC0; uniform vec3 uC1; uniform vec3 uC2; uniform vec3 uC3;
uniform vec3 uShadow; uniform vec3 uRim; uniform float uGlow; uniform float uAlpha;
varying vec3 vP; varying vec3 vN; varying vec3 vW;
${NOISE}
// 卡通分段光照:亮 / 中 / 暗 三档,交界处一点点平滑防锯齿
float toon(float d){ float a = smoothstep(0.30,0.34,d), b = smoothstep(-0.12,-0.08,d); return 0.38 + 0.32*b + 0.30*a; }
vec3 shade(vec3 base, vec3 N, vec3 V){ float d = dot(N, normalize(uL)); float t = toon(d);
vec3 c = mix(base*uShadow, base, t);
float rim = pow(1.0 - max(dot(N, V), 0.0), 3.0); c += uRim * rim * 0.32 * smoothstep(-0.3, 0.4, d + 0.3);
return c; }
`;
const VERT = `
varying vec3 vP; varying vec3 vN; varying vec3 vW;
void main(){ vP = normalize(position); vN = normalize(mat3(modelMatrix)*normal); vec4 w = modelMatrix*vec4(position,1.0); vW = w.xyz; gl_Position = projectionMatrix*viewMatrix*w; }`;
// ---- 各风格的表面(main 里拿到 base 颜色 + 自发光 emi,最后统一上光)
const STYLES = {
/* 晶体:多面体切面,每个面颜色随朝向变化(像钻石折光),内部有发光的「演算脉络」 —— 给晶钻超算主宇宙 */
crystal: {
geo: (THREE, r) => new THREE.IcosahedronGeometry(r, 2),
defaults: { colors: ['#7FE7FF', '#8E7BFF', '#FFE59A', '#FFFFFF'], shadow: '#5B5FA8', rim: '#BFF4FF', outline: '#141A3A', glow: 0.55 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW);
vec3 N = normalize(cross(dFdx(vW), dFdy(vW))); // 平面法线 = 一个面一个颜色
vec3 nO = normalize(vP);
float k = 0.5 + 0.5*sin(dot(nO, vec3(5.1,3.7,4.3)) + uSeed);
vec3 base = mix(mix(uC0, uC1, k), uC2, smoothstep(0.55, 1.0, sin(dot(nO, vec3(2.3,-4.1,1.7))*3.0 + uSeed)*0.5+0.5)*0.55);
float vein = aline(snoise(vP*3.2 + vec3(0.0, uT*0.08, 0.0)), 2.2);
vec3 c = shade(base, N, V);
float spark = pow(max(dot(reflect(-normalize(uL), N), V), 0.0), 24.0);
c += uC3 * step(0.5, spark) * 0.45 + uC0 * vein * 0.75 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 铅笔纸面:米白纸色 + 等高线一样的铅笔线 + 暗面排线 + 几处红笔圈 —— 给「火柴人宇宙」(小时候课上画的) */
paper: {
defaults: { colors: ['#F6F1E4', '#2B2E45', '#E5544B', '#9DB7E8'], shadow: '#B9B4C8', rim: '#FFFFFF', outline: '#2B2E45', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float n = fbm(vP*1.6 + uSeed);
float contour = aline(fract(n*4.0 + 0.5) - 0.5, 1.4);
float d = dot(N, normalize(uL));
float h1 = aline(fract(dot(vP, vec3(0.7,0.7,0.1))*26.0) - 0.5, 1.2) * (1.0 - smoothstep(-0.1, 0.1, d)); // 暗面单向排线
float h2 = aline(fract(dot(vP, vec3(-0.7,0.7,0.2))*26.0) - 0.5, 1.2) * (1.0 - smoothstep(-0.55, -0.4, d)); // 更暗处交叉排线
float circ = aline(length(vP - normalize(vec3(0.6, 0.35, 0.7))) - 0.22, 1.6) + aline(length(vP - normalize(vec3(-0.5,-0.4,0.75))) - 0.14, 1.6);
float blue = smoothstep(0.35, 0.6, fbm(vP*2.4 + 7.0 + uSeed)); // 几块淡蓝色铅笔涂色
vec3 base = mix(uC0, mix(uC0, uC3, 0.45), blue);
vec3 c = shade(base, N, V);
c = mix(c, uC1, clamp(contour*0.85 + max(h1, h2)*0.6, 0.0, 1.0));
c = mix(c, uC2, clamp(circ, 0.0, 1.0)*0.9);
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 冰封:纬向冰带 + 极冠 + 冰裂纹 —— 给「极寒世界」(冰河期、地表 -50℃) */
ice: {
defaults: { colors: ['#F2FAFF', '#BFE4FF', '#7CC3F0', '#FFFFFF'], shadow: '#6C80C9', rim: '#D6F3FF', outline: '#18305C', glow: 0.2 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float band = snoise(vec3(vP.x*1.2, vP.y*7.0 + uSeed, vP.z*1.2));
vec3 base = mix(uC0, uC1, smoothstep(-0.25, 0.35, band));
base = mix(base, uC3, smoothstep(0.68, 0.74, abs(vP.y) + 0.05*snoise(vP*6.0))); // 极冠
float crack = smoothstep(0.88, 0.95, 1.0 - abs(snoise(vP*4.5 + uSeed)));
vec3 c = shade(base, N, V);
c = mix(c, uC2, crack*0.85);
c += uC3 * pow(max(dot(reflect(-normalize(uL), N), V), 0.0), 40.0) * 0.6;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 霓虹城:深紫底色 + 经纬网格街区 + 闪烁的窗灯 —— 给「没落赛博城」 */
neon: {
defaults: { colors: ['#211A3D', '#5FF2FF', '#FF5FD2', '#FFD36E'], shadow: '#5E5A8F', rim: '#8A7BFF', outline: '#0B0820', glow: 1.0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float lon = atan(vP.z, vP.x) / 3.14159265, lat = asin(clamp(vP.y, -1.0, 1.0)) / 1.5707963;
float dist = smoothstep(-0.05, 0.25, fbm(vP*2.2 + uSeed)); // 有城的街区
float gx = aline(fract(lon*14.0) - 0.5, 1.6), gy = aline(fract(lat*9.0) - 0.5, 1.6);
vec2 cell = floor(vec2(lon*56.0, lat*36.0));
float win = step(0.72, fract(sin(dot(cell, vec2(12.9898, 78.233)) + uSeed)*43758.5453));
float flick = 0.65 + 0.35*sin(uT*2.0 + cell.x*1.7 + cell.y*0.9);
vec3 base = uC0 * (0.9 + 0.2*snoise(vP*3.0));
vec3 c = shade(base, N, V);
vec3 neon = mix(uC1, uC2, step(0.0, snoise(vP*1.3 + 11.0)));
c += neon * max(gx, gy) * dist * 1.2 * uGlow + uC3 * win * dist * flick * 0.55 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 善恶两半:一半金色白昼、一半紫色夜空,交界是一条发光的波浪线 —— 给「善恶等级」 */
duality: {
defaults: { colors: ['#FFF0C8', '#F2B84B', '#2D1E57', '#8F6BFF'], shadow: '#8C7AA8', rim: '#FFE7A8', outline: '#1A1235', glow: 0.8 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float s = vP.x*0.9 + 0.22*snoise(vP*1.8 + uSeed) + 0.12*sin(vP.y*7.0 + uT*0.3);
float side = smoothstep(-0.015, 0.015, s);
float cloud = smoothstep(0.1, 0.5, fbm(vP*2.6 + uSeed));
vec3 light = mix(uC0, uC1, cloud*0.6);
float star = step(0.985, fract(sin(dot(floor(vP*60.0), vec3(12.9898,78.233,37.719)))*43758.5453));
vec3 dark = mix(uC2, uC3, cloud*0.5) + vec3(star)*0.8;
vec3 c = shade(mix(dark, light, side), N, V);
c += uC1 * aline(s, 3.0) * 1.2 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 气态巨星(点缀用):卡通条纹 + 一个风暴眼 */
gas: {
defaults: { colors: ['#F2D7A6', '#D99A6C', '#8E6BBF', '#FFF2D6'], shadow: '#7A6A9E', rim: '#FFE2B8', outline: '#1E1838', ring: false, glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float w = vP.y*5.0 + 0.6*snoise(vec3(vP.x*2.0, vP.y*4.0, vP.z*2.0) + uSeed);
float b = 0.5 + 0.5*sin(w*3.14159);
vec3 base = mix(mix(uC0, uC1, smoothstep(0.3, 0.7, b)), uC2, smoothstep(0.8, 0.95, b)*0.6);
float storm = 1.0 - smoothstep(0.08, 0.13, length(vP - normalize(vec3(0.8, -0.25, 0.5))));
base = mix(base, uC3, storm*0.85);
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
/* 岩石小行星(点缀用):卡通陨坑 */
rock: {
defaults: { colors: ['#A9AFC9', '#7D84A6', '#5B6288', '#D5D9EA'], shadow: '#5B5F8A', rim: '#C9D3FF', outline: '#141833', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float n = fbm(vP*2.0 + uSeed);
vec3 base = mix(uC0, uC1, smoothstep(-0.2, 0.3, n));
float cr = smoothstep(0.42, 0.5, snoise(vP*5.0 + uSeed*2.0));
base = mix(base, uC2, cr); base = mix(base, uC3, aline(snoise(vP*5.0 + uSeed*2.0) - 0.42, 1.5)*0.7);
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
/* 未点亮:半透明全息线框球 —— 空槽 */
ghost: {
transparent: true,
defaults: { colors: ['#7F8BC8', '#B9C4FF', '#7F8BC8', '#FFFFFF'], shadow: '#FFFFFF', rim: '#B9C4FF', outline: null, glow: 0, alpha: 1 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float lon = atan(vP.z, vP.x) / 3.14159265, lat = asin(clamp(vP.y,-1.0,1.0)) / 1.5707963;
float g = max(aline(fract(lon*8.0 + uT*0.02) - 0.5, 1.4), aline(fract(lat*5.0) - 0.5, 1.4));
float f = pow(1.0 - max(dot(N, V), 0.0), 2.0);
gl_FragColor = vec4(mix(uC0, uC1, f), (g*0.55 + f*0.45 + 0.04) * uAlpha); }`,
},
};
export const STYLE_NAMES = Object.keys(STYLES);
/**
* 造一颗卡通星球。look 里能写:
* style 风格名(见 STYLES)
* r 半径
* colors 四个颜色(覆盖风格默认) shadow / rim / outline 阴影色 / 轮廓光色 / 描边色(outline:null 不描边)
* ring 要不要光环(默认没有;true / { inner, outer, color })
* seed 随机种子(同一风格的两颗星球长得不一样)
* tilt 自转轴倾角(弧度)
* atm 大气辉光颜色(默认没有;写了才加一层很淡的辉光)
*/
export function makePlanet(THREE, look = {}) {
const S = STYLES[look.style] || STYLES.rock;
const o = Object.assign({}, S.defaults, look);
const r = o.r || 1;
const col = i => new THREE.Color((o.colors || S.defaults.colors)[i] || '#ffffff');
const uniforms = {
uL: { value: new THREE.Vector3(-1, 0.6, 0.5) }, uT: { value: 0 }, uSeed: { value: o.seed ?? Math.random() * 50 },
uC0: { value: col(0) }, uC1: { value: col(1) }, uC2: { value: col(2) }, uC3: { value: col(3) },
uShadow: { value: new THREE.Color(o.shadow) }, uRim: { value: new THREE.Color(o.rim) }, uGlow: { value: o.glow ?? 0 }, uAlpha: { value: o.alpha ?? 1 },
};
const mat = new THREE.ShaderMaterial({ uniforms, vertexShader: VERT, fragmentShader: HEAD + S.frag,
transparent: !!S.transparent, depthWrite: !S.transparent, side: S.transparent ? THREE.DoubleSide : THREE.FrontSide });
const geo = S.geo ? S.geo(THREE, r) : new THREE.SphereGeometry(r, 96, 64);
const group = new THREE.Group(), body = new THREE.Mesh(geo, mat);
body.rotation.z = o.tilt ?? 0.3; group.add(body);
// 墨线描边:背面放大一点点的同形状,纯色 —— 卡通感的关键
if (o.outline) { const ol = new THREE.Mesh(geo, new THREE.MeshBasicMaterial({ color: o.outline, side: THREE.BackSide }));
ol.scale.setScalar(1.035); body.add(ol); }
// 大气辉光:默认**不加**(用户反馈「每颗星球外边都有一个罩子」)。确实想要就在 look 里写 atm: '#颜色'
let atm = null;
if (o.atm) {
atm = new THREE.Mesh(new THREE.SphereGeometry(r * 1.08, 48, 32), new THREE.ShaderMaterial({
transparent: true, depthWrite: false, side: THREE.BackSide, blending: THREE.AdditiveBlending,
uniforms: { uC: { value: new THREE.Color(o.atm) }, uS: { value: 0.25 } },
vertexShader: `varying vec3 vN; varying vec3 vW; void main(){ vN = normalize(mat3(modelMatrix)*normal); vec4 w = modelMatrix*vec4(position,1.0); vW = w.xyz; gl_Position = projectionMatrix*viewMatrix*w; }`,
fragmentShader: `uniform vec3 uC; uniform float uS; varying vec3 vN; varying vec3 vW; void main(){ vec3 v = normalize(cameraPosition - vW); float f = pow(1.0 - abs(dot(v, vN)), 4.0); gl_FragColor = vec4(uC, f*uS); }` }));
group.add(atm);
}
// 光环(卡通扁环,两道颜色)
let ring = null;
if (o.ring) {
const rc = typeof o.ring === 'object' ? o.ring : {};
const inner = (rc.inner || 1.45) * r, outer = (rc.outer || 2.1) * r;
ring = new THREE.Mesh(new THREE.RingGeometry(inner, outer, 128, 1), new THREE.ShaderMaterial({
transparent: true, depthWrite: false, side: THREE.DoubleSide,
uniforms: { uA: { value: new THREE.Color(rc.color || (o.colors || S.defaults.colors)[0]) }, uB: { value: new THREE.Color(rc.color2 || (o.colors || S.defaults.colors)[1]) }, uIn: { value: inner }, uOut: { value: outer } },
vertexShader: `varying vec3 vP; void main(){ vP = position; gl_Position = projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
fragmentShader: `uniform vec3 uA; uniform vec3 uB; uniform float uIn; uniform float uOut; varying vec3 vP;
void main(){ float t = (length(vP.xy)-uIn)/(uOut-uIn); float b = step(0.5, fract(t*5.0));
float a = (0.55 + 0.25*b) * smoothstep(0.0, 0.06, t) * smoothstep(1.0, 0.94, t); gl_FragColor = vec4(mix(uA, uB, b*0.6 + t*0.3), a); }` }));
ring.rotation.x = -Math.PI / 2 + 0.38; ring.rotation.y = 0.12; group.add(ring);
}
const spin = o.spin ?? 0.15;
return {
group, body, mat, atm, ring, r, look: o,
update(dt, t, lightDir) { body.rotation.y += dt * spin; uniforms.uT.value = t; if (lightDir) uniforms.uL.value.copy(lightDir); },
setAlpha(a) { uniforms.uAlpha.value = a; },
};
}
+96
View File
@@ -0,0 +1,96 @@
/* 金钻宇宙板块:白色客栈页面里开一扇「观星窗」,窗里是星系图;窗下是世界线档案列表(和星图联动)
像素字 / 按钮 / 墨色都沿用门户 jz-2026 层的变量(--pixel --ink --mc-green --stone …),这里只管星图自己的东西。 */
.skywin{--sky:#070B1C;--ui:#FFD36E;--line:rgba(127,139,200,.35);
position:relative;margin:6px 0 26px;padding:6px;border-radius:12px;background:rgba(255,255,255,.75);border:2px solid #fff;
box-shadow:0 30px 60px -36px rgba(40,50,110,.55)}
.skywin .stage{position:relative;height:min(72vh,660px);min-height:440px;border-radius:8px;overflow:hidden;background:var(--sky);color:#E8EBFA;isolation:isolate}
.skywin #uGl{position:absolute;inset:0;width:100%;height:100%;display:block;touch-action:none;outline:none}
/* 窗内 HUD:只放读数,标题已经在页面上了 */
.skywin .hud{position:absolute;left:18px;top:14px;pointer-events:none;display:flex;gap:16px;font:600 11px/1.4 ui-monospace,Menlo,monospace;letter-spacing:.12em;color:#7C84B4;
animation:uHud 1s cubic-bezier(.23,1,.32,1) .4s both}
.skywin .hud b{font:400 18px/1 var(--pixel);letter-spacing:0;color:var(--ui);margin-left:6px;-webkit-font-smoothing:none}
@keyframes uHud{from{opacity:0;transform:translateY(-6px)}to{opacity:1;transform:none}}
.skywin .labels{position:absolute;inset:0;pointer-events:none;transition:opacity .9s cubic-bezier(.23,1,.32,1)}
.skywin .stage:not(.ready) .labels{opacity:0}
.skywin .tag{position:absolute;left:0;top:0;display:flex;align-items:center;gap:7px;padding:3px 8px;border:0;border-radius:4px;background:none;cursor:pointer;white-space:nowrap;pointer-events:auto;font:inherit;text-align:left;will-change:transform;transition:opacity .3s}
.skywin .tag .t b{display:block;font:400 15px/1.15 var(--pixel);-webkit-font-smoothing:none;color:#F4F6FF;text-shadow:0 0 8px rgba(5,8,25,.95)}
.skywin .tag .t em{display:block;font:600 10px/1.3 ui-monospace,Menlo,monospace;letter-spacing:.12em;font-style:normal;color:#7C84B4}
.skywin .tag:hover,.skywin .tag.hot{background:rgba(255,211,110,.1)} .skywin .tag:hover .t b,.skywin .tag.hot .t b{color:var(--ui)}
.skywin .tag:focus-visible{outline:2px solid var(--ui);outline-offset:2px}
.skywin .tag.empty .t b{color:#8A92BE;font-size:13px}
.skywin .tag.dim{opacity:.15}
.skywin .sector{position:absolute;left:0;top:0;font:600 10px/1 ui-monospace,Menlo,monospace;letter-spacing:.3em;color:rgba(169,176,214,.42);white-space:nowrap;transition:opacity .4s;pointer-events:none}
/* 窗内档案卡(桌面 / 全屏时) */
.skywin .panel{position:absolute;right:18px;top:50%;width:min(390px,40%);transform:translate(20px,-48%);opacity:0;pointer-events:none;transition:opacity .45s cubic-bezier(.23,1,.32,1),transform .6s cubic-bezier(.23,1,.32,1)}
.skywin .panel.on{opacity:1;transform:translate(0,-50%);pointer-events:auto}
.skywin .panel .card{position:relative;padding:20px 20px 16px 24px;border-radius:8px;background:rgba(255,255,255,.96);border:2px solid #fff;color:var(--ink);box-shadow:0 30px 70px -30px rgba(0,0,0,.6)}
.skywin .panel .card::before{content:"";position:absolute;left:0;top:0;bottom:0;width:4px;border-radius:8px 0 0 8px;background:var(--pc,#FFD36E)}
.skywin .panel .card .k{font:600 12px/1 var(--font,inherit);letter-spacing:.06em;color:var(--ink-3)}
.skywin .panel .card h2{margin:8px 0 2px;font:400 28px/1.2 var(--pixel);-webkit-font-smoothing:none}
.skywin .panel .card .tg{color:var(--ink-2);font-size:14px}
.skywin .panel .card .ds{margin:10px 0 0;font-size:14px;line-height:1.8;color:var(--ink-2)}
.skywin .panel .card .tags{display:flex;flex-wrap:wrap;gap:6px;margin-top:10px}
.skywin .panel .card .tags span{font-size:12px;padding:4px 8px;border-radius:4px;background:rgba(30,36,64,.05);color:var(--ink-2)}
.skywin .panel .card .acts{display:flex;flex-wrap:wrap;gap:8px;margin-top:16px;justify-content:space-between}
.skywin .panel .card .nav{display:flex;gap:8px}
.skywin .panel .card .btn{height:38px;font-size:13.5px;padding:0 14px 3px}
/* 窗角按钮 */
.skywin .ctl{position:absolute;right:14px;top:12px;display:flex;gap:8px}
.skywin .ctl .btn{height:34px;font-size:13px;padding:0 12px 3px}
/* 档案卡里「回到星系图」是主按钮:门户的 .btn 是石头白方块,这里补一个绿色 .pri(同 .btn-solid) */
.skywin .btn.pri{background:var(--mc-green);border-color:var(--mc-green-lo);color:#fff;box-shadow:inset 0 2px 0 var(--mc-green-hi),inset 0 -4px 0 var(--mc-green-lo)}
.skywin .btn.pri:hover{background:#469A2E}
.skywin #uBack{display:none} .skywin .stage.focus #uBack{display:inline-flex}
.skywin .tip{position:absolute;left:18px;bottom:14px;margin:0;font-size:12px;color:#7C84B4;pointer-events:none;transition:opacity .3s}
.skywin .stage.focus .tip{opacity:0}
.skywin .loading{position:absolute;inset:0;display:grid;place-items:center;font:400 18px var(--pixel);color:#A9B0D6;background:var(--sky);transition:opacity .6s;z-index:5}
/* 全屏:窗户铺满屏幕,滚轮直接缩放 */
.skywin.full .stage{position:fixed;inset:0;z-index:300;height:auto;min-height:0;border-radius:0}
body.sky-full{overflow:hidden}
/* 窗下:世界线列表 */
.uni-title{margin:4px 0 14px;font-size:24px;line-height:1.3;color:var(--ink)}
.sky-hint{display:none}
.uni-list{display:grid;grid-template-columns:repeat(auto-fill,minmax(230px,1fr));gap:12px;margin-bottom:14px}
.ucell{position:relative;display:flex;flex-direction:column;gap:4px;padding:16px 16px 14px;border-radius:8px;border:2px solid rgba(255,255,255,.95);text-align:left;cursor:pointer;font:inherit;color:var(--ink);
background:linear-gradient(160deg,rgba(255,255,255,.9),rgba(255,255,255,.65));box-shadow:0 18px 36px -26px rgba(80,90,170,.45);transition:transform .2s cubic-bezier(.23,1,.32,1),box-shadow .2s}
.ucell:hover{transform:translateY(-2px)}
.ucell[aria-current=true]{box-shadow:inset 0 0 0 3px var(--mc-green,#3C8527),0 18px 36px -26px rgba(80,90,170,.45)}
.ucell .no{font:600 11px/1 ui-monospace,Menlo,monospace;letter-spacing:.14em;color:var(--ink-3)}
.ucell h3{margin:2px 0 0;font:400 22px/1.25 var(--pixel);-webkit-font-smoothing:none}
.ucell .tg{font-size:13px;color:var(--ink-2)}
.ucell .go{margin-top:6px;font-size:12.5px;font-weight:700;color:var(--mc-green,#3C8527)}
.ucell .sw{position:absolute;right:14px;top:14px;width:26px;height:26px;border-radius:50%;background:var(--sw);box-shadow:inset -5px -5px 0 rgba(0,0,0,.18),0 0 0 2px #fff}
.uslots{display:grid;grid-template-columns:repeat(6,minmax(0,1fr));gap:10px}
.uslots button{height:54px;border-radius:8px;border:1.5px dashed rgba(140,150,200,.45);background:rgba(255,255,255,.6);font:inherit;font-size:12px;color:var(--ink-3);cursor:pointer}
.uslots button b{display:block;font-size:14px;color:var(--ink-2);font-variant-numeric:tabular-nums}
.uslots button[aria-current=true]{border-style:solid;border-color:var(--mc-green,#3C8527)}
@media (max-width:760px){
.skywin{margin:4px -4px 8px;padding:4px}
/* 窗户不铺满屏:上下留出能滑页面的地方 */
.skywin .stage{height:min(64svh,560px);min-height:400px}
.skywin #uGl{touch-action:none} /* 在星图里的手势全归星图:单指转、双指缩放,不会带着页面滑 */
.sky-hint{display:block;margin:0 2px 20px;font-size:12px;color:var(--ink-3);text-align:center}
/* 档案卡:星图窗里的底部抽屉(只占下半个窗),星球被镜头挪到上半个窗 */
.skywin .panel{left:8px;right:8px;top:47%;bottom:8px;width:auto;display:flex;flex-direction:column;justify-content:flex-end;transform:translateY(24px)}
.skywin.full .panel{bottom:calc(8px + env(safe-area-inset-bottom))}
.skywin .panel.on{transform:none}
.skywin .panel .card{max-height:100%;overflow:auto;overscroll-behavior:contain;-webkit-overflow-scrolling:touch;padding:12px 14px 0 18px;touch-action:pan-y}
.skywin .panel .card h2{margin-top:6px;font-size:21px}
.skywin .panel .card .tg{font-size:13px}
.skywin .panel .card .ds{margin-top:6px;font-size:13px;line-height:1.7}
.skywin .panel .card .tags{margin-top:8px}
.skywin .panel .card .tags span{font-size:11.5px;padding:3px 7px}
/* 三个按钮一行,贴在抽屉底边,正文长了在中间滚 */
.skywin .panel .card .acts{position:sticky;bottom:0;display:grid;grid-template-columns:1fr 1fr 1.25fr;gap:6px;margin:10px -14px 0 -18px;padding:8px 14px 12px 18px;background:linear-gradient(rgba(255,255,255,0),#fff 10px)}
.skywin .panel .card .nav{display:contents}
.skywin .panel .card .btn{height:36px;font-size:13px;padding:0 6px 3px}
.skywin .tag .t b{font-size:13px} .skywin .tag .t em{display:none} .skywin .tag.empty{display:none}
.skywin .sector,.skywin .tip{display:none}
.skywin #uBack{display:none !important} /* 手机:返回按钮已经在档案卡里了 */
.skywin .hud{gap:12px;transition:opacity .3s}
.skywin .stage.focus .hud{animation:none;opacity:0} /* 看档案时把读数收起来,别和右上角按钮挤 */
.uni-list{grid-template-columns:1fr 1fr;gap:10px}
.ucell{padding:14px 12px 12px}.ucell h3{font-size:18px}.ucell .sw{width:20px;height:20px;right:10px;top:10px}
.uslots{grid-template-columns:repeat(3,minmax(0,1fr))}
}
@media (prefers-reduced-motion:reduce){.skywin .panel,.skywin .labels,.skywin .hud,.ucell{transition:none;animation:none}}
+188
View File
@@ -0,0 +1,188 @@
# 交接说明 · 金钻宇宙星系图(`portal/assets/universe/`)
> 状态:**已接进门户**(2026-10-05):`portal/index.html` 的「金钻宇宙」板块就是它,原来的启动仪式 / 盘符机架 / 读盘舱已删除。
> 风格参考:《绝地潜兵 2》银河战争地图 —— 旋臂星系 + 星云 + 扇区 + 补给线;每条世界线是一个星系,点进去是一颗卡通星球 + 档案卡。
---
## 1. 文件
| 文件 | 干什么 | 日常要不要改 |
|---|---|---|
| `assets/universe/config.js` | **全部内容和外观配置**:世界线档案、每颗星球的风格 / 颜色 / 卫星、星系配色、扇区名、粒子数量。门户主脚本的 `UNIVERSES` 也从这里读 | **改这个** |
| `assets/universe/planets.js` | 卡通星球材质库(每种「风格」= 一段着色器 + 默认参数) | 加新风格时改 |
| `assets/universe/galaxy.js` | 引擎:画星系、星云、补给线、名牌,处理拖动 / 缩放 / 点击 / 档案卡 / 运镜 | 一般不用动 |
| `assets/universe/universe.css` | 观星窗、档案卡、窗下世界线卡片、手机布局的样式 | 改版式时改 |
| `portal/index.html` 里 `#view-universe` + 底部那段 `<script type="module">` | 板块骨架(窗户 / 名牌层 / HUD / 档案卡 / 卡片列表)和接线代码 | 改交互时改 |
| `assets/vendor/three.module.min.js` | three.js r170(MIT,自托管,不连外网) | 不动 |
**没有任何贴图、模型文件**:星球、星云、星点全是着色器实时生成的,所以没有版权问题,也不用担心图片加载慢。
---
## 2. 常见改动
### 加一条新世界线
1. `config.js` → `UNIVERSES` 里把对应的空槽(比如 `{ no: '0005', empty: true }`)换成完整档案:
```js
{ no: '0005', name: '名字', kind: '原创', tag: '一句话副标题', tags: ['标签1', '标签2'], desc: '档案正文' },
```
字段和门户页原来的 `UNIVERSES` 一模一样(`no / name / kind / tag / tags / desc`),可以直接拷。
2. `config.js` → `LOOKS` 里按编号加外观:
```js
'0005': { style: 'ice', r: 1.2, orbit: [34, 2], accent: '#9FE3FF',
colors: ['#…', '#…', '#…', '#…'], // 可选:覆盖风格默认的四个颜色
ring: true, // 可选:光环(默认没有;用户觉得突兀,现在一颗都没开)
atm: '#9FE3FF', // 可选:大气辉光(默认没有;之前「每颗星外面一个罩子」就是它)
moons: [{ style: 'rock', r: 0.3, d: 2.6, speed: 0.5 }], // 可选:卫星(纯装饰)
why: '为什么长这样(写给后来的人看)' },
```
- `orbit: [离中心距离, 第几条旋臂]`:距离 0~60,旋臂 0~3。别和别的星系放太近(差 8 以上比较好看)。
- 不写 `LOOKS` 的世界线会自动用 `EMPTY_LOOK`(全息线框的「未点亮」样子),放在外圈。
3. 刷新页面即可。HUD 上的「世界线 / 已点亮 / 空槽」数字是自动数的。
### 只换一颗星球的颜色
改它 `LOOKS` 里的 `colors`(四个颜色,含义见下表)。不写就用风格默认值。
### 改整张图的配色
`config.js` → `GALAXY.colors`:底色、核心色、旋臂内外色、星云几组颜色、线条色、UI 强调色(名牌 / 数字的金色)。
**建议整张图只用这几种颜色**,别给每颗星单独配一个刺眼的颜色 —— 上一版就是因为颜色太杂被说丑。
### 改扇区名 / 粒子数量 / 散落星球数量
`GALAXY.sectors`(6 个扇区名)、`GALAXY.particles`、`GALAXY.nebulae`、`GALAXY.decorPlanets`(桌面 / 手机分开设)。
手机卡的话先把 `particles.mobile` 降到 10000、`nebulae.mobile` 降到 10。
---
## 3. 现有的星球风格(`planets.js` → `STYLES`)
| 风格 | 长什么样 | 四个颜色依次是 | 现在给谁用 / 为什么 |
|---|---|---|---|
| `crystal` | 多面体切面、每面颜色随朝向变、内部发光脉络 | 主色 / 副色 / 高光色 / 闪点 | 零号宇宙:晶钻超算本体 |
| `paper` | 米白纸面、铅笔等高线、暗面排线、红笔圈、淡蓝涂色 | 纸色 / 铅笔色 / 红笔色 / 涂色 | 火柴人宇宙:小时候课上画的 |
| `ice` | 纬向冰带、极冠、冰裂纹、冰面高光 | 冰白 / 冰蓝 / 裂纹色 / 极冠色 | 极寒世界:冰河期、-50℃ |
| `neon` | 深紫地表、霓虹街区网格、闪烁窗灯 | 地表 / 霓虹 A / 霓虹 B / 窗灯 | 没落赛博城 |
| `duality` | 一半白昼一半夜空,交界一条发光波浪线 | 白昼 / 云 / 夜空 / 夜云 | 善恶等级(设定还在酝酿,先按名字做;定了再换) |
| `gas` | 卡通条纹气态行星 + 风暴眼 | 条纹 A / 条纹 B / 深色带 / 风暴 | 散落的无名星球、卫星 |
| `rock` | 卡通陨坑岩石星 | 亮面 / 暗面 / 坑底 / 坑沿 | 散落的无名星球、卫星 |
| `ghost` | 半透明全息线框球 | 线色 / 边缘色 / - / - | 空槽(未点亮) |
所有风格共用:三档卡通明暗(亮 / 中 / 暗)+ 冷色阴影(`shadow`)+ 很弱的轮廓光(`rim`)+ 墨线描边(`outline`,写 `null` 不描边)。
大气辉光(`atm`)和光环(`ring`)都是**可选**的,默认关 —— 用户反馈过「罩子」「环」很突兀、辉光太曝。
### 加一种新风格
在 `STYLES` 里加一项:
```js
myStyle: {
defaults: { colors: ['#…','#…','#…','#…'], shadow: '#…', rim: '#…', outline: '#…', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
vec3 base = mix(uC0, uC1, smoothstep(-0.2, 0.3, fbm(vP*2.0 + uSeed))); // vP = 球面上的点(单位向量)
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
```
着色器里能用:`snoise(vec3)` 噪声、`fbm(vec3)` 分形噪声、`aline(x, 线宽)` 抗锯齿细线、`shade(颜色, N, V)` 统一上卡通光、
`uC0~uC3` 四个颜色、`uT` 时间、`uSeed` 种子、`uGlow` 自发光强度。然后在 `LOOKS` 里 `style: 'myStyle'` 就能用。
---
## 4. 交互
### 开场 / 飞行动画(运镜库在 galaxy.js 的 MOVES 里)
全部按时间走(和帧率无关),慢设备上也是同一条连贯的路线。
| 运镜 | 名字 | 怎么动 | 现在给谁 |
|---|---|---|---|
| 推进 | `push` | 先转过去对准(前 40%),再笔直推进去,不绕圈 | 火柴人宇宙 |
| 放大 | `zoom` | 先用长焦把它拉近(视角收窄到 14°),再一边推进一边把视角放回来 | 零号宇宙 |
| 升空俯冲 | `rise` | 先拉高到几乎俯视,再从上面扎下去 | 极寒世界 |
| 跃迁 | `warp` | 慢起步、中段猛冲、末段刹住;冲的时候视角张开、镜头轻轻一滚 | 没落赛博城 |
| 绕行 | `orbit` | 边飞边绕过去,中途抬高拉远一点 | 善恶等级;以及「上一个 / 下一个」在星系之间切换时 |
| 拉远 | `pull` | 回星系图:先往后退,再抬头看全景 | 「回到星系图」 |
| 开场 · 盘旋落下 | `introSweep` | 从高空、更远处绕半圈落到正常视角 | 开场(`GALAXY.intro`) |
| 开场 · 垂直坠入 | `introDive` | 从正上方很远处直着落下来,最后才抬起镜头 | 开场(`GALAXY.intro`,默认随机二选一) |
- 每条世界线用哪个入场运镜:`config.js` → `LOOKS[编号].enter`;不写就按 push / zoom / rise / warp / orbit 轮流。
- **档案卡和镜头同步**:点下去时旧档案先收起,镜头飞到 78% 的时候档案卡才滑出来(内容也那时才换),和星球落定同时到。
嵌在页面里时 `onFocus(u, 'start')` 在起飞时回调(列表马上高亮),`onFocus(u, 'arrive')` 在快到时回调(这时再出正文)。
- 飞的途中用户拖动 / 缩放:运镜立刻停在原地交还控制权,没出来的档案卡马上补出来,不会丢。
- 加一种新运镜:往 `MOVES` 里加一项 `{ dur: 毫秒, path(from, to, k) { … 往 view 里写 az/el/dist/tx/ty/tz/fov/roll … } }`,再在 `enter` 里写它的名字。
- 开场在画面第一次进入视口时开始;星系从暗处亮起来(约 2.4 秒),镜头落定后名牌才浮现。「载入中」在第一帧画出来时才淡出。
- 总览时星系会放大一点(桌面 1.35 倍、手机 1.9 倍)好认,飞近时恢复真实大小。
- 桌面:拖动转视角、滚轮缩放、点星球或名牌飞过去、`←` / `→` 切上一个 / 下一个、`Esc` 回到星系图。
- 手机:单指拖动、**双指缩放**、点名牌或星球飞过去;飞过去后星球在上半屏、档案卡是底部抽屉,「回到星系图」在卡里。
- 系统设置了「减少动态效果」:星系不自转、镜头直接切过去、星云不流动。
- 名牌是真正的 `<button>`,键盘 Tab 能选中。
---
## 5. 手机端处理过的冲突(这次修的)
| 问题 | 怎么修的 |
|---|---|
| HUD 的说明文字和星系名牌叠在一起 | 手机只留标题 + 一行读数;落在 HUD 范围里的名牌自动藏起来 |
| 名牌贴边被切掉 | 名牌位置夹在屏幕内(左右各留 6px) |
| 档案卡挡住星球 | 选中后镜头把星球挪到上半屏,档案卡做成底部抽屉(最高 44% 屏高,内容多了卡里自己滚) |
| 左下「回到星系图」被抽屉盖住 | 手机上隐藏它,按钮放进档案卡(整行宽,好点) |
| 空槽名牌太多太挤 | 手机只显示已点亮的名牌,空槽只留星球本身 |
| 不能缩放 | 加了双指缩放 |
| 近处的星点糊成大光斑 | 星点像素大小设了上限 |
| 手机画面比桌面稀、星系只是小点 | 手机和桌面用几乎一样的数量,星点大小按距离补偿,总览时星系放大 1.9 倍 |
| 名牌前的小方块色点 | 去掉了(全站规矩:文字前不放色点) |
| 散落的无名星球乱、互相重叠、卫星有的反着转 | 减到 14 颗;摆放时和核心、各星系(含卫星轨道)、彼此之间都留距离;卫星一律同向转 |
验证:无头浏览器 390×844 / 1440×900 各截一轮,五颗星球逐个飞进去截图,控制台 0 报错、无横向滚动、所有名牌都在屏幕内且不压 HUD。
---
## 6. 在门户里是怎么接的
- `<head>` 里:`assets/universe/universe.css` + 一段 `importmap`(把 `three` 指到 `assets/vendor/three.module.min.js`)。
- 主脚本之前:`<script src="assets/universe/config.js">` —— 主脚本一解析就要读 `window.JZ_UNIVERSE`(首页总览的计数、`#0001` 深链都用它)。
- 页面底部一段 `<script type="module">`:
- 按 `config.js` 渲染窗下的世界线卡片和空槽;
- 对外挂 `window.__jzUniverse = { show(), fly(编号) }`;
- **第一次 `show()` 时才 `import('./assets/universe/galaxy.js')`**,three.js 跟着下载(约 690KB,gzip 后约 170KB)。首页、画展等别的板块不下载它。
- 主脚本:`showBoard('universe')` 调 `__jzUniverse.show()`;`#0001` 这种旧深链调 `__jzUniverse.fly('0001')`;飞到哪条,地址栏就 `replaceState` 成 `#编号`,可以直接分享。
`mountGalaxy()` 的可选参数(门户都用上了):
| 参数 | 干什么 | 门户怎么用 |
|---|---|---|
| `onFocus(u, phase)` | 选中 / 取消选中时回调(`u` 是档案或 `null`;`phase` 是 `start` 起飞 / `arrive` 快到) | 窗下卡片跟着高亮;地址栏跟着改 |
| `layout()` | 返回 `{x, y}`:选中时星球往左 / 往上挪多少 | 桌面 `{x:0.17}`(右边是窗内档案卡);手机 `{y:0.26}`(档案卡是窗里的底部抽屉) |
| `wheelZoom()` | 返回 `false` 时普通滚轮留给页面滚动,按住 Ctrl 才缩放 | 不全屏时 `false`,全屏时 `true` |
| `onReady()` | 第一帧画好 | 淡出「星图载入中」 |
| 返回值 `api.fly(no)` / `api.home()` / `api.resize()` | 从外面控制 | 点卡片 → 先把窗户滚到眼前再 `fly`;切全屏 / 切回板块后 `resize` |
另外:画面滚出视口时自动暂停渲染(省电);手机上星图里的手势全归星图(`touch-action:none`:单指转、双指缩放,页面不会跟着滑),窗户只占屏幕约 64%,上下留了滑页面的地方,窗下有一句提示。
星图起不来(没有 WebGL)时,窗里显示原因,下面的世界线卡片照常能看。
## 7. 改了什么(相对原门户)
删掉:启动仪式(逐字 / 权限扫描 / 欢迎)、宇宙首屏的晶体线框画布(CrystalView)、盘符机架(抽插 / 读盘舱 / 键盘翻页)、两枚只给插卡用的图标(`--icd-logo` 白标、`--icd-people` 火柴人)。
保留:首页右侧的晶钻徽记、`#0001` / `#rack` 旧链接(分别飞到那条世界线 / 打开宇宙板块)。
---
## 8. 性能
- 桌面:4.2 万星点 + 32 片星云 + 14 颗散落星球 + 11 个星系(含卫星)。手机:3.6 万星点 + 28 片星云 + 14 颗(为了和桌面画面一致,只少一点点)。
- ⚠️ **帧率还没在真机上测过**(只在无头浏览器的软件渲染里验证了画面和交互),上线前请用一台普通手机和一台集显笔记本各打开看一下。
- 手机像素比上限 1.5;星点大小按镜头距离补偿,手机和桌面看起来一样密。
- 每颗星球一个绘制调用(加描边、大气各一个),没有实时阴影、没有后处理。
- 卡的话按第 2 节降粒子数;再不行把 `planets.js` 里球体的 `SphereGeometry(r, 96, 64)` 降到 `(r, 48, 32)`。
## 9. 版权
- three.js:MIT(`vendor/three-LICENSE.txt`)。
- 噪声函数:Ashima Arts / Stefan Gustavson 的 3D simplex noise(MIT),写在 `planets.js` 里。
- 星球、星云、星点:全部程序生成,无外部素材。
- 上一版用过的 NASA 星球贴图已经全部撤掉(不再需要署名)。
## 10. 部署注意(踩过的坑)
- 静态文件可能被缓存。**改了 JS / CSS 一定要换版本号**,四处一起换:`portal/index.html` 里的 `universe.css?v=`、`config.js?v=`、底部模块脚本里的 `galaxy.js?v=`,以及 `galaxy.js` 里的 `import './planets.js?v='`。
2026-10-05 踩过:一个坏掉的 galaxy.js 被缓存住,修好之后打开还是「加载不出来」。
- 检查语法要按 ES 模块检查(把文件拷成 `.mjs` 再 `node --check`),按普通脚本检查会漏掉「重复声明」这类错误。
+21
View File
@@ -0,0 +1,21 @@
The MIT License
Copyright © 2010-2024 three.js authors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
File diff suppressed because one or more lines are too long
Binary file not shown.
+135 -1340
View File
File diff suppressed because one or more lines are too long
+353
View File
@@ -0,0 +1,353 @@
# 金钻客栈 · 2026-10 总交接文档(前端 + 后端)
> 这一份把 2026-10-05 这一轮**前后端所有改动**、**功能增删**、**设计规范**、**业务逻辑**和**部署运维**写在一处。
> 细节文档还在各自目录里(位置见第 1 节),这份是总目录 + 总说明。
>
> 占位值一律保持原样:`example.com` / `shop.example.com`、`123456789`、`备案号(已移除)`、`(本机路径)`、`<DATA_DIR>` / `<APP_DIR>` / `<WORKER_DIR>` / `<WIN-PATH>` 等。
> 署名不动(「苏达 · 大肥鱼」)。本文不含任何密钥、真实地址或截图。
---
## 目录
1. [仓库里有什么](#1-仓库里有什么)
2. [变更清单(按提交)](#2-变更清单按提交)
3. [功能增加 / 删除一览](#3-功能增加--删除一览)
4. [⚠️ 接口与数据格式变更(单独列)](#4-️-接口与数据格式变更单独列)
5. [设计规范](#5-设计规范)
6. [业务逻辑](#6-业务逻辑)
7. [部署与运维](#7-部署与运维)
8. [测试与验证](#8-测试与验证)
9. [已知未验证 / 待确认](#9-已知未验证--待确认)
---
## 1. 仓库里有什么
| 目录 / 文件 | 是什么 | 细节文档 |
|---|---|---|
| `portal/` | 门户(整个网站):首页 / 画展 / 工具与开源 / 金钻宇宙 / 平台入口 / 关于,单文件 `index.html` + 资源 | 本文第 5、6 节;`portal/assets/universe/交接说明.md`(星系图) |
| `order/` | 自助模板渲染(下单页)`index.html` + `skincheck.js` | 本文第 6.2 节 |
| `backend/backend-site/` | 网站后端:`server.py`(全部服务端逻辑)、`store.py`(数据库)、`admin.py`(命令行管理)、`pngcheck.py`(PNG 结构核验)、`tests/` | `backend/backend-site/交接说明.md`、`回执-Claude.md` |
| `backend/backend-tools/` | 店主电脑上的一整套:渲染机 `ys_worker.py`、开单后台 `ys_admin.py`、本机开单 `ys_local.py` + `local.html`、Blender 出图脚本 `make_order.py`、各种启动脚本 | `backend/backend-tools/交接说明.md`、`回执-Claude.md` |
| `backend/模板/` | 三个 Blender 模板工程(测试用) | `backend/模板/说明.md` |
| `backend/deploy/` | 反向代理路由与限流片段 | `backend/deploy/nginx-片段.md` |
| `backend/他应该知道的.md` | 生意背景 / 机器约束 / 数据边界 / 术语表 | — |
| `交接说明.md`(根目录) | 11eb16c 那一轮视觉改版的说明(**部分已过时**,以本文为准) | — |
---
## 2. 变更清单(按提交)
时间顺序。哈希以 `git log` 为准。
### 2.1 `11eb16c` · 前端 2026 改版「白光藏色 × MC 方块」
- 删掉上一轮的暗色覆盖块 `redesign-2026`(反馈不好看)。
- 两页 `</body>` 前新增 `<!-- jz-2026:start -->…<!-- jz-2026:end -->`:手机底栏 HTML + `<style id="jz-2026">` + `<script id="jz-2026-js">`;下单页 `<body>` 开头另加一段跟门户一样的顶栏。
- 浅色配色、流动淡彩背景(WebGL,降级为静态渐变)、MC 方块按钮、像素标题字(缝合像素字体子集,OFL)。
- 门户顶栏加「自助渲染」入口;手机端底部物品栏导航 + 「更多」面板(像开关一样再点就收)。
- 下单页页头改版;四段进度条 `.prog` 用 CSS 隐藏(DOM 和逻辑都还在)。
- 修了「工具与开源」卡片正文被挤成一指宽的问题。
- 这一轮**没改**任何原有 `<script>` / `<style>` 块(逐块比对过)。详见根目录 `交接说明.md`。
### 2.2 `651d21d` · 后端复查修复 + 回执
外部复查找到的问题,按会丢钱 / 丢数据的先修:
| 问题 | 改法 |
|---|---|
| 同一张码并发提交能成两单 | 查码和绑码放进同一把锁(`redeem_bind`) |
| 卡密规则只信前端报的张数 | 按 `max(前端张数, 实际模板数)` 和模板并集校验;不认识的模板 key 直接拒 |
| 爱发电回调重放 / 改单号能多发码、多激活 | 处理过的平台单号一律原样回;回调和账本读写串行(`HOOK_LOCK`) |
| `admin.py` 和服务器同时改 `codes.json` 互相覆盖(实测 200 张丢 185 张) | `LOCK` 加跨进程 `flock`;写文件用唯一临时名 + `fsync` |
| `sweep` 会删掉还在排队 / 等确认的单 | 只清走完流程的单 |
| 卡密 / 单号 / 取件码用 `random` 生成(可预测) | 改 `secrets` |
| 重渲换皮肤不过 PNG 核验 | 走同一套核验 |
| 反馈接口能灌爆磁盘和通知 | 限频 + 磁盘闸 + 只收图片 |
| 下载整个读进内存 | 边读边发;zip 同一时间只打一个 |
| 部分失败静默标「已完成」 | 记 `partial`,通知店主,页面说实话 |
| `H.finish` 和框架方法重名 | 改名 `finish_upload`(接口路径不变) |
| 本机开单工具接受任意来源的 POST | 只认本机页面(Host / Origin 校验) |
附 `tests/回执复现测试.py`(27 条;原版 13 条失败,改后全过)。
### 2.3 `51212a0` · 接入 SQLite + 开单后台重写
- 新增 `store.py`:卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态进 `<DATA_DIR>/ys.db`;第一次启动自动建库并导入旧 JSON(旧文件不动)。
- `server.py` / `admin.py` 的存取换到库上,路由逻辑不变;`calls.jsonl` 照旧追加(手机通知读它)。
- 管理接口新增 `calls` / `call-done` / `retry`,`codes` 加 `q` 搜索。
- `admin.py db check / backup / export`。
- `ys_admin.py`(开单后台)页面按功能重写:待处理 / 订单 / 卡密 / 福利券 / 呼叫·反馈 / 开单工具。
- 新增 `tests/数据库测试.py`(现编假数据)。
### 2.4 `3ae940d` · 本机开单页面重写
`backend-tools/local.html` 换成跟网站 / 后台同一套样子;补上原来没写样式的分辨率选择、没绑事件的「清空」;整页接收拖拽;按勾选顺序标号;预计耗时。`ys_local.py` 没动。
### 2.5 本次提交 · 金钻宇宙换成星系图 + 推送前审查
- 门户「金钻宇宙」板块:**删掉**启动仪式、宇宙首屏晶体、盘符机架、读盘舱;**换成**星系图(three.js,懒加载)+ 窗下世界线卡片。
- 世界线数据只剩一份:`portal/assets/universe/config.js`(主脚本也读它)。
- 像素字子集按新文字重做(并保留了原来所有字)。
- 审查修掉的后端问题:`add_call` 写库失败会打断渲染机回传;多进程同时首启会重复导入呼叫记录;撤销「处理过了」没清时间。数据库测试加一条,共 38 条。
- 本文档。
---
## 3. 功能增加 / 删除一览
### 增加
| 在哪 | 功能 |
|---|---|
| 门户 · 金钻宇宙 | 星系图:旋臂星系 + 星云 + 扇区 + 补给线;每条世界线一颗卡通星球(材质按设定:晶体 / 铅笔纸面 / 冰封 / 霓虹 / 善恶两半);点星系或下面卡片飞过去,档案卡和星球同时落定;五种运镜(推进 / 放大 / 升空俯冲 / 跃迁 / 绕行);全屏;`#0001` 深链可分享 |
| 门户 · 全站 | 「自助渲染」入口;手机底部物品栏 + 「更多」面板;流动淡彩背景 |
| 下单页 | 跟门户一致的顶栏 / 底栏 |
| 后端 | SQLite 数据库(自动建库、自动导入、导出回退、热备份、体检) |
| 后端 · 管理接口 | 呼叫记录列表、标「处理过了」、失败单退回重渲、卡密搜索 |
| 开单后台 | 待处理首页(要动手的事集中在一页)、订单搜索、卡密搜索 / 停用 / 启用 / 改张数、订单备注、呼叫·反馈页、失败单「退回重渲」按钮 |
| 本机开单 | 分辨率选择样式、清空、整页拖拽、出图顺序标号、预计耗时、复制买家说明 |
### 删除
| 在哪 | 删了什么 | 为什么 |
|---|---|---|
| 门户 · 金钻宇宙 | 启动仪式(逐字 / 权限扫描 / 欢迎)、宇宙首屏晶体线框(`CrystalView`)、盘符机架(抽插 / 拖拽 / 导轨)、读盘舱(特写弹窗 / 拆解 / 翻页)、两枚只给插卡用的图标(白标 `--icd-logo`、火柴人 `--icd-people`)、相关 CSS | 被星系图取代;店主说机架「丑死了」 |
| 门户 · 装饰 | 英文 kicker、遥测数字条、时钟、`LINK // 已同步`(CSS 隐藏,DOM 还在) | 文案要说人话 |
| 下单页 | 四段进度条(CSS 隐藏,逻辑还在) | 店主觉得难看 |
| 前端 | 上一轮暗色覆盖块 `redesign-2026` | 不好看 |
保留:首页右侧晶钻徽记、`#0001` / `#rack` 旧链接(分别飞到那条世界线 / 打开宇宙板块)。
---
## 4. ⚠️ 接口与数据格式变更(单独列)
> 规矩:动了接口路径、请求 / 响应字段、数据格式的,必须单独标出来 —— 渲染机是另一台机器上的另一份代码,两边对不上会静默出不来图。
| 类别 | 变更 | 影响谁 |
|---|---|---|
| **数据格式** | 卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态从 JSON 文件挪进 `<DATA_DIR>/ys.db`。第一次启动自动导入,旧文件原样留着;`admin.py db export` 能导回旧格式 | 服务器、`admin.py`。**渲染机不受影响** |
| 新增接口 | `GET /api/admin/calls`、`POST /api/admin/call-done`、`POST /api/admin/retry` | 开单后台(新按钮要它们:**服务器先升级**) |
| 接口加参数 | `GET /api/admin/codes?q=`(可选,不传和以前一样) | 开单后台 |
| 新增字段 | `/api/claim` 回的订单里多一个 `terms_v`(只增不减) | 渲染机可以不理 |
| 开单后台本机接口 | 新增 `/api/codes` `/api/calls` `/api/retry` `/api/note` `/api/code-edit` `/api/call-done`(都要 PIN,原样转服务器) | 只有面板页面自己用 |
| 前端 | 门户的 `#rack` / `#bay` DOM 与 `window.__icd.open/close/flip/tray` 调试钩子删了;新增 `window.__jzUniverse.show()/fly(no)` | 只有页面自己和自动化脚本 |
**没变**:所有买家接口、渲染机接口的路径和字段;本机开单的本机接口。
---
## 5. 设计规范
### 5.1 一句话
**白光藏色 × Minecraft 方块**:一眼看过去是白的,颜色藏在亮部和缓慢流动的淡彩光里;按钮是 MC Ore UI 那种方块按钮;标题用像素字;正文用 OPPO Sans。
### 5.2 颜色 token(门户 / 下单页写在 `jz-2026` 块的 `:root`;后台 / 本机开单各自复制一份)
| 用途 | 变量 | 值 |
|---|---|---|
| 页面底色 | `--bg` | `#F5F7FB` |
| 正文墨色(深→浅) | `--ink` / `--txt` · `--txt-2` · `--txt-3` · `--txt-4` | `#1E2440` · `#454B6B` · `#676D8A` · `#858AA2` |
| 发丝线 | `--line` / `--line-soft` | `rgba(30,36,64,.12)` / `.08` |
| 主色(草方块绿) | `--mc-green` / `-hi` / `-lo` | `#3C8527` / `#5BAA3C` / `#1D4D13` |
| 次按钮(石头白) | `--stone` / `--stone-lo` / `--stone-edge` | `#F3F4F6` / `#B4B7BE` / `#9EA2AA` |
| 面板 | `--panel-shadow` + 半透明白 | `inset 0 1px 0 #fff, 0 22px 44px -28px rgba(100,110,190,.38)`;底 `rgba(255,255,255,.74~.9)`,2px 白边 |
| 警告 / 错误文字 | `--warn-t` / `--bad-t` | `#9A6A0C` / `#B33A2E` |
| 首页板块卡的「矿石色」 | `--zc` | 画展金 `#F2C14D`、工具蓝 `#4F86E8`、宇宙紫 `#9A6BE0`、平台绿、关于红(只在悬停时从边缘亮出来) |
| 背景彩光 | `body::before` 四团 radial-gradient | 天蓝 / 粉 / 杏 / 薄荷,透明度 .22~.30;有 WebGL 时换成 `#jzBg` 流动彩光 |
| 星系图(唯一的深色区域) | `config.js → GALAXY.colors` | 深海军蓝 `#070B1C` + 蓝紫星云 + 一点青 + 暖金 `#FFD36E`(名牌 / 数字) |
### 5.3 字体
- **标题**:`JZ Pixel` = 缝合像素字体 12px(TakWolf,SIL OFL 1.1),**只含页面用到的字**(子集)。门户 `portal/fonts/jz-pixel-12.woff2`,下单页 `order/assets/jz-pixel-12.woff2`,协议原文在同目录。12 的整数倍字号最清楚,`-webkit-font-smoothing:none`。
- **正文**:OPPO Sans(可免费商用)。
- **加了新字(比如新世界线名字)要重做子集**,否则那几个字会掉回系统字体:
```
# 文本 = 旧子集里已有的字 ∪ 页面 + config.js + galaxy.js 里所有字(只加不减)
python3 -m fontTools.subset fusion-pixel-12px-proportional-zh_hans.otf.woff2 \
--text-file=字表.txt --flavor=woff2 --layout-features='*' --output-file=portal/fonts/jz-pixel-12.woff2
```
源字体从 fusion-pixel-font 的 release 取(12px proportional zh_hans)。
### 5.4 组件
| 组件 | 规则 |
|---|---|
| 按钮 | **全站统一一种**:MC 方块,`border-radius:4px`,2px 边,上亮下暗的内阴影;按下下沉 2px。绿 = 主操作,石头白 = 次操作,红字 = 危险操作(注销 / 停用 / 收摊) |
| 卡片 / 面板 | 半透明白 + 2px 白边 + `--panel-shadow`,圆角 8px(大块 12px)。**只有吸顶顶栏用 `backdrop-filter`**,面板不用(卡、而且显得死板) |
| 标签 / 状态 | 色块小标签(4px 圆角、浅底深字):绿 = 通过 / 已完成,黄 = 注意,红 = 失败,蓝 = 进行中,灰 = 停用 |
| 输入框 | 白底、2px 线、聚焦变绿 |
| 动效 | 只动 `transform` / `opacity`;缓动 `cubic-bezier(.23,1,.32,1)`;尊重 `prefers-reduced-motion` 和页面上的「动效」开关 |
### 5.5 移动端规则
- 窄屏(≤760 / 860px):顶栏只留 logo 和开关;底部浮动物品栏(首页 / 画展 / 渲染〔中间钻石〕 / 宇宙 / 更多),「更多」从底栏上方弹出一排格子,再点同一个按钮 / 点空白 / 返回键 / Esc 收起。
- 左右边距 16px 左右;**任何页面不许横向滚动**(每次改完都要在 390 宽度下检查)。
- 星系图在手机上:星图里的手势全归星图(拖动转、双指缩放,页面不跟着滑),窗户只占屏幕约 64%,上下留出滑页面的地方;档案卡是窗里的底部抽屉,星球挪到上半个窗。
### 5.6 口味禁区(每条都是看过预览之后的直接反馈)
- **不要暗色面板**、不要黑白强对比(星系图窗户是唯一例外);不要复古风。
- **文字 / 标题 / 名牌前面不要放小圆点、小方块色点**。
- 不要按钮扫光动画;不要六边形「三棱镜」按钮;全站按钮一个样子。
- 星系图:不要星球光环、不要每颗星外面一层大气「罩子」、辉光不能过曝;颜色只用那一套(深蓝 + 蓝紫 + 金),不要彩虹;装饰星球不能互相重叠、卫星不能反着转;开场 / 飞行运镜要连贯,档案卡要跟星球落定同时出来。
- 流动大背景要平滑,不要像素化;像素风只留在字、按钮、粒子上。
- **文案说人话**:不写「标签 · 解释」式的说明、不加英文小字装饰、不写解释界面怎么用的句子。
- 改一块就只动那一块,不要顺手改邻居(比如改顶栏时别动头图);小步改。
---
## 6. 业务逻辑
### 6.1 网站全貌
金钻客栈 = 一个线上「客栈」:画展、工具与开源、金钻宇宙、各平台入口都在里面;**自助模板渲染只是其中一家店**。
| 门户板块 | 内容 | 数据在哪 |
|---|---|---|
| 首页 | 欢迎首屏 + 五个板块卡 | `BOARDS` |
| 画展 | 图片 / 视频 / 全景 / 动态壁纸,按时间排、可筛选(脱敏版只有一张占位) | `GALLERY` + `hd_cache/manifest.json` |
| 工具与开源 | 开源一行 / 闭源一行,按类型筛选 | `APPS` |
| 金钻宇宙 | 星系图 + 世界线档案(0000 零号主宇宙、0001–0004 已点亮、0005–0010 空槽) | `portal/assets/universe/config.js` |
| 平台入口 | 视频 / 图文 / 模型创作 / 开源 / 小店 / 联系,外链新窗口打开 | `LINK_GROUPS` + `LINKS` |
| 关于 | 制作者、开源组件鸣谢、名字由来 | 静态 HTML |
路由:`#/板块`(单页切换,无整页刷新);`#0001` 这种编号直接飞到那条世界线;`#rack` 兼容到宇宙板块。
**加一条世界线**:`config.js` 里把空槽换成完整档案(`no / name / kind / tag / tags / desc`)+ 在 `LOOKS` 里给它一个外观(`style / r / orbit / accent / moons / enter`);名字里有新字记得重做像素字子集(5.3);改了 JS 要换版本号(7.2)。细节见 `portal/assets/universe/交接说明.md`。
### 6.2 下单页(`order/`)
两条路:
```
网页下单:传皮肤(本地质检)→ 选模板 / 分辨率 → 出订单号(待付款)→ 去爱发电付款
→ 爱发电回调确认 / 店主后台激活 → 排队 → 渲染机出图 → 买家看 512 预览 → 确认收货 → 下原图
卡密下单:传皮肤 → 填卡密(自动认模板 / 张数)→ 直接排队 → 出图 → 同上
凭票取图:拿单号 + 取件码(或卡密)回来看进度、下载
```
皮肤质检(`skincheck.js`,前端和本机开单共用):尺寸是否 64 网格的正方形、像素风检查、主体层完整、半透明、外层铺满、手臂粗细判定;PNG 结构核验防夹带(尾部追加 / 未知关键块 / APNG)。服务器落盘前还会再核一遍(`pngcheck.py`)并剥掉元数据块。
### 6.3 订单状态机
```
unpaid(待付款)──买家点「我付好了」──▶ paid(待激活)
│ │
└──── 爱发电回调确认 / 后台激活 / 买家用卡密激活 ───┘
▼
waiting(排队中)──渲染机 claim──▶ working(渲染中)
▲ │
后台「退回重渲」/ admin.py retry 一张一次 /finish 回传
│ ▼
failed(失败)◀── 水印没生成 ── done(已完成)
unpaid / paid ──后台注销──▶ void(已注销,不占卡密)
```
- 领单超过 45 分钟没交回 → 自动退回队列。4096 的「重单」高峰期给小单让路,最多让 30 分钟(防饿死)。
- 收满张数才算完成;渲染机显式收单但没收满 = **部分失败**:记 `partial`、页面说实话、通知店主。
- 预览水印没做出来的不许标完成(标 `failed`,等退回重渲)。
- 成品保留 72 小时(从开放下载算);`admin.py sweep` 清理时**先核销卡密再删文件**,排队 / 渲染中 / 待激活的单绝不删。清理后库里那一行留着做账。
### 6.4 卡密生命周期(**激活 ≠ 核销**)
```
active(可用)──买家提交──▶ bound(已激活:被这一单占住,还没核销)──开放下载满 72 小时──▶ used(已核销,终态)
inactive(停用:网页单等付款 / 手动停用)
```
卡密种类:固定 N 张 / 最多 N 张 / 不限张数;可锁模板;「直发」= 店主自己发的码,不用等确认收货。
防暴破:码空间 31¹² ≈ 7.9e17;同 IP 连错 15 次冷却 15 分钟;单 IP 10 分钟最多开 6 单。
### 6.5 爱发电回调
不验签(没有对方公钥),改成**拿开放接口反查这笔单**。处理顺序:
① 标题含「测试」只记账 → ② 同一平台单号重推:原样回上次结果(幂等)→ ③ 反查不到 / 没付款:只记账、标人工,**绝不发码** → ④ 金额:少付拦死、多付照常但记一笔 → ⑤ 认单:自定义订单号 > 留言里的卡密 > 留言里的单号 > 「只有一笔待付款单金额对得上」(两笔以上一律人工)。
### 6.6 渲染机(店主电脑,`ys_worker.py`)
只出站:定时 `claim`(领单)+ 独立线程 `hb`(心跳,默认 10 分钟一次,`hb_every`)→ 取皮肤 → Blender 后台渲染(**同一时刻只允许一个 Blender**)→ 中途 `progress` → 一张一次 `finish` 回传。心跳超过 1500 秒没更新 = 页面显示离线(所以 `OFFLINE_AFTER` 必须大于心跳间隔,两边一起改)。心跳顺带记下家里的出口 IP,管理接口只认这个 IP。
### 6.7 福利券
一批「免费、已激活」的码放在福利页让人自取:**每台设备 + 每个网络各限领 1 张**(服务器硬规则),领到后 N 天内要用;可锁模板、限张数、定种类(渲染图 / 立牌 / 钥匙扣 / 海报)、到期自动收摊;收摊后已领走的照常能用。
### 6.8 开单后台(`ys_admin.py`,店主电脑,局域网)
- PIN 锁(服务端校验,加盐 sha256,12 小时免输);调服务器管理接口要「令牌 + 家里出口 IP」两道门。
- 六页:**待处理**(买家说付好了的单、渲染失败的单、没处理的呼叫)/ 订单 / 卡密(生成 + 库)/ 福利券 / 呼叫·反馈 / 开单工具。
### 6.9 本机开单(`ys_local.py` + `local.html`)
给聊天里成交的平台单用:拖皮肤 → 同一套质检 → 勾模板 → 本机 Blender 出图 → 下载 / 打开留档文件夹。**不联网、不上传、不要卡密**,只监听本机,只认本机页面。
### 6.10 数据库
见 `backend/backend-site/交接说明.md` 第五节。要点:`ys.db` 里 5 张表(codes / orders / pay_orders / calls / kv),每张「能查的列 + 一列整条 JSON」;上层代码拿到的还是原来的 dict;`.lock` 文件锁照旧;WAL 模式。
---
## 7. 部署与运维
### 7.1 文件放哪
| 文件 | 放到 | 备注 |
|---|---|---|
| `portal/**` | 网站根目录 | 星系图要 `assets/universe/` 和 `assets/vendor/` 一起上 |
| `order/**` | 网站 `/order/` | |
| `server.py` + **`store.py`** + `admin.py` + `pngcheck.py` | `<APP_DIR>`(同一目录) | `server.py` 直接 `import store`,**少了 `store.py` 服务起不来** |
| `backend-tools/*` | 店主电脑 `<WORKER_DIR>` | `deploy.py` 推送;面板新按钮依赖服务器新接口,**先升服务器** |
### 7.2 缓存与版本号
- 门户星系图:改了 JS / CSS 要换版本号,**四处一起换**:`portal/index.html` 里 `universe.css?v=`、`config.js?v=`、底部模块脚本里 `galaxy.js?v=`,以及 `galaxy.js` 里 `import './planets.js?v='`。踩过:坏文件被缓存住,修好了打开还是「加载不出来」。
- 检查 ES 模块语法要拷成 `.mjs` 再 `node --check`(按普通脚本查会漏「重复声明」)。
- three.js 只在第一次打开「金钻宇宙」时下载(约 690KB,gzip 后约 170KB)。
### 7.3 数据库命令
```
python3 admin.py db check # 完整性 + 每张表几行 + 按状态计数
python3 admin.py db backup # 在线热备份到 <DATA_DIR>/backup/
python3 admin.py db export [目录] # 导回旧版 JSON(回退用)
```
回退:停服务 → `db export` → 换回旧版 `server.py` / `admin.py` → 启动。再切回来:挪走 `ys.db`,新版启动时从 JSON 重新导入。
权限:跑 `admin.py` 的账号要对 `<DATA_DIR>` **目录**有写权限(WAL 会建 `ys.db-wal` / `-shm`)。
### 7.4 常用
```
python3 admin.py ls waiting # 看排队
python3 admin.py retry <单号> # 失败单退回(后台也有按钮)
python3 admin.py calls # 呼叫记录(后台也有页面)
python3 admin.py sweep # 清过期成品 + 核销(建议每天跑一次)
```
---
## 8. 测试与验证
| 测试 | 怎么跑 | 结果(2026-10-05) |
|---|---|---|
| 后端回归 + 漏洞复现 | `python3 backend/backend-site/tests/回执复现测试.py <server.py 所在目录>` | 27 / 27 |
| 数据库专项 | `python3 backend/backend-site/tests/数据库测试.py <server.py 所在目录>` | 38 / 38 |
| 开单后台 | 假数据起真服务器 + 真面板,headless 浏览器电脑宽 / 手机宽点全部页面 | 无报错、无横滚;无 PIN → 401、无令牌 → 403 |
| 本机开单 | 假本机服务(模拟渲染)+ headless 浏览器走完整流程 | 无报错、无横滚 |
| 门户 | headless 浏览器 1366 / 390:六个板块都切一遍;宇宙:星图就绪、点卡片飞过去出档案、`#0002` 深链、全屏开关、手机上拖星图页面不滚;首页不下载 three.js | 全过;除星系图板块外,其余板块和改动前**逐像素一致** |
| 下单页 | 打开截图 | 正常(本轮没改) |
后端测试数据全是测试脚本现编的,建在系统临时目录。⚠️ 交付副本里三个 URL 格式串被脱敏成 `http<WIN-PATH>`,要起服务器的测试得先在**测试副本**里换成能格式化的占位(这三处分别吃 1 / 2 / 0 个参数);线上原版直接跑。
---
## 9. 已知未验证 / 待确认
- **星系图帧率没在真机上测过**(只在无头浏览器的软件渲染里验证了画面和交互)。上线前用一台普通手机、一台集显笔记本各打开看一下;卡的话按 `universe/交接说明.md` 第 8 节降粒子数。
- **数据库没在真机器上跑过**(1.6G 内存 + systemd 内存上限)。部署后先跑一次 `admin.py db check`。
- 渲染机、真实 Blender、爱发电真实回调、手机通知脚本(读 `calls.jsonl` 的那段不在仓库里)都没有端到端测过。
- 下单页里的链接是站点根路径(`/#/home`、`/order/`),本地从仓库根目录起服务时「首页」会跳到仓库根,线上没问题。
- 署名按要求没改(「苏达 · 大肥鱼」)。
+3
View File
@@ -1,5 +1,8 @@
# 交接说明 · 金钻客栈 2026 视觉改版(白光藏色 × MC 方块) # 交接说明 · 金钻客栈 2026 视觉改版(白光藏色 × MC 方块)
> ⚠️ 这一份只讲 `11eb16c` 那一轮视觉改版。之后「金钻宇宙」板块换成了星系图(这次改了门户原有的 JS,下面「原有脚本一字未改」那句对门户已不成立),后端也接了数据库。
> **完整的、最新的情况以根目录 `交接文档-2026-10.md` 为准。**
## 一句话 ## 一句话
两个页面换成了**浅色的「白光藏色」+ Minecraft 方块风**:整体一眼是白的,颜色藏在亮部和流动的淡彩背景里;按钮是 MC Ore UI 那种方块按钮;标题换成像素字;手机端换成底部物品栏导航。 两个页面换成了**浅色的「白光藏色」+ Minecraft 方块风**:整体一眼是白的,颜色藏在亮部和流动的淡彩背景里;按钮是 MC Ore UI 那种方块按钮;标题换成像素字;手机端换成底部物品栏导航。