Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
09b229deee | ||
|
|
3ae940d828 | ||
|
|
51212a07c0 |
@@ -11,6 +11,8 @@
|
||||
| `portal/` `order/` | 门户与下单页(前端) | 上一批(视觉重设计) |
|
||||
| **`backend/`** | **网站后端 + 本地自助管理后台 + 测试用 Blender 工程 + 部署层片段** | **本批** |
|
||||
|
||||
> **总交接文档:`交接文档-2026-10.md`**(2026-10 这一轮前后端所有改动 / 功能增删 / 设计规范 / 业务逻辑 / 部署运维)。
|
||||
>
|
||||
> 看后端请从 **`backend/他应该知道的.md`** 开始读(生意背景 / 机器约束 / 数据边界 / 术语表),
|
||||
> 再进 `backend/README.md` 和两份交接说明。
|
||||
> 写回执照 **`backend/回执模板.md`** 填。
|
||||
|
||||
+3
-1
@@ -9,6 +9,8 @@
|
||||
|
||||
## 怎么读这份包(建议顺序)
|
||||
|
||||
> 2026-10 这一轮(数据库、开单后台 / 本机开单重写、前端星系图)的总说明在仓库根目录 **`交接文档-2026-10.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] 两份交接文档(含《我们的思路与方法》)
|
||||
- [x] 三个模板工程,已脱敏(等长替换,文件字节数未变)
|
||||
|
||||
@@ -14,6 +14,7 @@
|
||||
python3 admin.py calls 看「呼叫金钻」记录
|
||||
python3 admin.py sweep 清理超过保留期的成品
|
||||
python3 admin.py stat 概览
|
||||
python3 admin.py db [check|backup|export [目录]] 数据库:体检 / 热备份 / 导回旧版 JSON
|
||||
python3 admin.py audit [行数] 看兑换码失败/被拒记录
|
||||
"""
|
||||
import csv, json, os, shutil, sys, time
|
||||
@@ -267,15 +268,33 @@ def cmd_retry(argv):
|
||||
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):
|
||||
try:
|
||||
for line in open(S.CALLS_FILE, encoding="utf-8"):
|
||||
if line.strip():
|
||||
r = json.loads(line)
|
||||
print("%s 订单=%s IP=%s %s" % (r["ts"], r.get("order") or "-",
|
||||
r.get("ip"), "已通知" if r.get("notified") else "未通知"))
|
||||
except OSError:
|
||||
rows = S.STORE.calls() # 数据库 calls 表(2026-10-05 起;calls.jsonl 只是给手机通知的副本)
|
||||
if not rows:
|
||||
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):
|
||||
@@ -285,8 +304,8 @@ def cmd_sweep(argv):
|
||||
⚠️ 删文件之前先把卡密核销 —— 否则文件没了、码还挂在「已激活」,账永远对不上。
|
||||
"""
|
||||
n = freed = settled = 0
|
||||
for oid in list(os.listdir(S.ORDERS)):
|
||||
d = os.path.join(S.ORDERS, oid)
|
||||
for oid in S.STORE.order_ids():
|
||||
d = S.order_dir(oid)
|
||||
m = S.read_meta(oid)
|
||||
if not m:
|
||||
continue
|
||||
@@ -306,7 +325,7 @@ def cmd_sweep(argv):
|
||||
freed += os.path.getsize(os.path.join(root, f))
|
||||
except OSError:
|
||||
pass
|
||||
shutil.rmtree(d, ignore_errors=True)
|
||||
S.purge_order(oid) # 删文件;库里那一行留着记账(之后当它不存在)
|
||||
n += 1
|
||||
# 文件还在、但开放下载已满 72 小时的,也一起核销
|
||||
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,
|
||||
"gift": cmd_gift,
|
||||
"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,
|
||||
"edit": cmd_edit}
|
||||
|
||||
|
||||
+143
-85
@@ -5,7 +5,8 @@
|
||||
|
||||
设计要点
|
||||
* 纯标准库(http.server),零依赖、内存小 —— 这台机器只有 1.6G 内存
|
||||
* 队列就是文件系统:orders/<订单号>/meta.json 里 state 字段 = 状态
|
||||
* 数据在 SQLite(<DATA_DIR>/ys.db,见 store.py):卡密 / 订单 / 爱发电账本 / 呼叫记录 / 小块状态;
|
||||
订单的 state 字段 = 队列状态。皮肤和成品**文件**还在 orders/<订单号>/ 目录里
|
||||
* 渲染机主动出站拉单(宿主只能出站),服务器不主动连宿主
|
||||
* 管理操作全走本地 CLI(admin.py),**不开任何公网管理入口**
|
||||
|
||||
@@ -123,6 +124,11 @@ LOG_FILE = os.path.join(ROOT, "server.log")
|
||||
|
||||
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
|
||||
KEEP_HOURS = 72 # 成品在服务器保留时长
|
||||
OFFLINE_AFTER = 1500 # 心跳超过这么多秒 = 离线
|
||||
@@ -245,7 +251,7 @@ def gift_batches():
|
||||
kind(券的种类:render=渲染图 / standee=立牌 / keychain=钥匙扣 / …未来扩展)
|
||||
shape(版式:square/横版 portrait…留字段,先不用)
|
||||
"""
|
||||
d = jload(GIFTS_FILE, {})
|
||||
d = STORE.kv_get("gifts", {})
|
||||
if not isinstance(d, dict) or not isinstance(d.get("batches"), list):
|
||||
d = {"batches": []}
|
||||
return d
|
||||
@@ -310,7 +316,7 @@ def gift_public():
|
||||
def gift_claim_days():
|
||||
"""福利券领到后**多久必须用掉**(金钻 2026-10-02:领了不用要逾期)"""
|
||||
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):
|
||||
return 7
|
||||
|
||||
@@ -414,7 +420,7 @@ def gift_claim(bid, token, ip):
|
||||
_days = gift_claim_days()
|
||||
cs[pick]["claim_expire"] = (now() + timedelta(days=_days)).isoformat(timespec="seconds")
|
||||
cs[pick]["gift_kind"] = b.get("kind") or "render"
|
||||
jsave(CODES_FILE, cs)
|
||||
save_codes(cs)
|
||||
log("福利券 %s 被领走:%s(%s)" % (bid, pick, ip))
|
||||
rec = load_codes().get(pick) or {}
|
||||
mx = int(rec.get("n_max") or rec.get("n_fix") or 1)
|
||||
@@ -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),
|
||||
"created": now().isoformat(timespec="seconds"),
|
||||
})
|
||||
jsave(GIFTS_FILE, d)
|
||||
STORE.kv_put("gifts", d)
|
||||
codes = gift_batch_add(bid, count, direct=direct)
|
||||
log("福利券批次建好 %s「%s」%d 张(%s)" % (
|
||||
bid, name, len(codes), "不限张数" if n_free else "最多 %d 张" % n_fix))
|
||||
@@ -526,7 +532,7 @@ def gift_batch_add(bid, count=20, direct=None):
|
||||
for c in got:
|
||||
if c in cs:
|
||||
cs[c]["gift"] = bid
|
||||
jsave(CODES_FILE, cs)
|
||||
save_codes(cs)
|
||||
log("福利券批次 %s 补货 %d 张" % (bid, len(got)))
|
||||
return got
|
||||
|
||||
@@ -539,7 +545,7 @@ def gift_batch_off(bid):
|
||||
if not b:
|
||||
raise ValueError("没有这个批次:%s" % bid)
|
||||
b["enabled"] = False
|
||||
jsave(GIFTS_FILE, d)
|
||||
STORE.kv_put("gifts", d)
|
||||
log("福利券批次 %s 已收摊" % bid)
|
||||
return b
|
||||
|
||||
@@ -724,6 +730,24 @@ def now():
|
||||
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):
|
||||
line = "[%s] %s" % (now().strftime("%Y-%m-%d %H:%M:%S"), " ".join(str(x) for x in a))
|
||||
try:
|
||||
@@ -811,7 +835,7 @@ def 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):
|
||||
@@ -843,7 +867,12 @@ def new_owner_token():
|
||||
|
||||
# ----------------------------------------------------------------- 兑换码
|
||||
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,
|
||||
@@ -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),
|
||||
"lock_tpl": bool(lock_tpl), "n_free": bool(n_free)}
|
||||
made.append(c)
|
||||
jsave(CODES_FILE, codes)
|
||||
save_codes(codes)
|
||||
return made
|
||||
|
||||
|
||||
@@ -909,7 +938,7 @@ def code_info(raw):
|
||||
c = (raw or "").strip().upper()
|
||||
if not CODE_RE.match(c):
|
||||
return None
|
||||
rec = (load_codes() or {}).get(c)
|
||||
rec = STORE.code_get(c)
|
||||
if not rec:
|
||||
return None
|
||||
st = code_state(rec)
|
||||
@@ -945,32 +974,21 @@ def note_tpl_time(tpl, sec):
|
||||
return
|
||||
if not tpl or sec <= 0 or sec > 3600:
|
||||
return
|
||||
try:
|
||||
d = json.load(open(TPL_TIMES_FILE, encoding="utf-8"))
|
||||
with LOCK:
|
||||
d = STORE.kv_get("tpl_times", {})
|
||||
if not isinstance(d, dict):
|
||||
d = {}
|
||||
except Exception:
|
||||
d = {}
|
||||
arr = list(d.get(tpl) or [])
|
||||
arr.append(round(sec, 1))
|
||||
d[tpl] = arr[-50:]
|
||||
try:
|
||||
tmp = TPL_TIMES_FILE + ".tmp"
|
||||
with open(tmp, "w", encoding="utf-8") as f:
|
||||
json.dump(d, f, ensure_ascii=False)
|
||||
os.replace(tmp, TPL_TIMES_FILE) # 原子替换,断电不会写坏
|
||||
except OSError:
|
||||
pass
|
||||
STORE.kv_put("tpl_times", d)
|
||||
|
||||
|
||||
def tpl_eta_sec(templates, n_img=1):
|
||||
"""这单大概要渲多久:按模板历史耗时求和;没样本的模板按每张 60 秒兜底,再加 20 秒收尾。"""
|
||||
try:
|
||||
d = json.load(open(TPL_TIMES_FILE, encoding="utf-8"))
|
||||
d = STORE.kv_get("tpl_times", {})
|
||||
if not isinstance(d, dict):
|
||||
d = {}
|
||||
except Exception:
|
||||
d = {}
|
||||
per = []
|
||||
for t in (templates or []):
|
||||
a = sorted(x for x in (d.get(t) or []) if isinstance(x, (int, float)))
|
||||
@@ -1127,7 +1145,7 @@ def redeem_bind(codes_in, oid):
|
||||
codes[c]["used"] = False
|
||||
codes[c]["order"] = oid
|
||||
codes[c]["bound_at"] = ts
|
||||
jsave(CODES_FILE, codes)
|
||||
save_codes(codes)
|
||||
return True, None, good
|
||||
|
||||
|
||||
@@ -1145,7 +1163,7 @@ def unbind_codes(codes_list, oid):
|
||||
r.pop("bound_at", None)
|
||||
hit = True
|
||||
if hit:
|
||||
jsave(CODES_FILE, codes)
|
||||
save_codes(codes)
|
||||
|
||||
|
||||
def burn_codes(codes_list, oid):
|
||||
@@ -1163,7 +1181,7 @@ def burn_codes(codes_list, oid):
|
||||
codes[c]["used"] = False
|
||||
codes[c]["order"] = oid
|
||||
codes[c]["bound_at"] = now().isoformat(timespec="seconds")
|
||||
jsave(CODES_FILE, codes)
|
||||
save_codes(codes)
|
||||
|
||||
|
||||
def settle_codes(oid, why=""):
|
||||
@@ -1185,7 +1203,7 @@ def settle_codes(oid, why=""):
|
||||
r["settled"] = why
|
||||
n += 1
|
||||
if n:
|
||||
jsave(CODES_FILE, codes)
|
||||
save_codes(codes)
|
||||
return n
|
||||
|
||||
|
||||
@@ -1238,25 +1256,31 @@ def order_dir(oid):
|
||||
|
||||
|
||||
def read_meta(oid):
|
||||
p = os.path.join(order_dir(oid), "meta.json")
|
||||
if not os.path.exists(p):
|
||||
"""订单信息(数据库 orders 表)。没有这单 / 已清理 → None。"""
|
||||
if not oid or not isinstance(oid, str):
|
||||
return None
|
||||
return jload(p, None)
|
||||
return STORE.order_get(oid)
|
||||
|
||||
|
||||
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):
|
||||
out = []
|
||||
if not os.path.isdir(ORDERS):
|
||||
return out
|
||||
for oid in sorted(os.listdir(ORDERS)):
|
||||
m = read_meta(oid)
|
||||
if m and (states is None or m.get("state") in states):
|
||||
out.append(m)
|
||||
return out
|
||||
"""按单号排序的订单列表;states 给了就只要这几种状态(走索引,不再一单一单读文件)。"""
|
||||
return STORE.orders(states)
|
||||
|
||||
|
||||
def drop_order(oid):
|
||||
"""单没建成(提交中途失败):删目录 + 删行。"""
|
||||
shutil.rmtree(order_dir(oid), ignore_errors=True)
|
||||
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 结构核验(防夹带)—— 同目录,零依赖
|
||||
@@ -1317,7 +1341,7 @@ def sync_voucher_nfix(m):
|
||||
rec["n_fix"] = img_total(m)
|
||||
hit = True
|
||||
if hit:
|
||||
jsave(CODES_FILE, cs)
|
||||
save_codes(cs)
|
||||
|
||||
|
||||
def img_total(m):
|
||||
@@ -1405,7 +1429,7 @@ def heartbeat(force=False):
|
||||
c = _status_cache
|
||||
if (not force) and c["v"] is not None and (time.monotonic() - c["t"]) < STATUS_TTL:
|
||||
return c["v"]
|
||||
hb = jload(HB_FILE, {})
|
||||
hb = STORE.kv_get("heartbeat", {}) or {}
|
||||
last = hb.get("ts")
|
||||
online = False
|
||||
if last:
|
||||
@@ -1487,7 +1511,7 @@ def _edit_code_locked(c, patch):
|
||||
r[k] = str(p[k] or "")[:20]
|
||||
if r.get("lock_tpl") and not (r.get("tpl") or "").strip():
|
||||
return False, "要锁定模板,得先给这张码带模板"
|
||||
jsave(CODES_FILE, cs)
|
||||
save_codes(cs)
|
||||
return r, None
|
||||
|
||||
|
||||
@@ -1684,6 +1708,8 @@ class H(BaseHTTPRequestHandler):
|
||||
return self.admin_codes(q)
|
||||
if p == "/api/admin/gifts":
|
||||
return self.admin_gifts()
|
||||
if p == "/api/admin/calls":
|
||||
return self.admin_calls(q)
|
||||
|
||||
return self.err("not found", 404)
|
||||
except Exception as e:
|
||||
@@ -1758,6 +1784,10 @@ class H(BaseHTTPRequestHandler):
|
||||
return self.admin_gift_add()
|
||||
if p == "/api/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)
|
||||
except Exception as e:
|
||||
log("POST %s 异常 %r" % (p, e))
|
||||
@@ -1887,7 +1917,7 @@ class H(BaseHTTPRequestHandler):
|
||||
return self.err("皮肤文件过大")
|
||||
|
||||
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()
|
||||
tok = new_owner_token()
|
||||
os.makedirs(order_dir(oid), exist_ok=True)
|
||||
@@ -1932,7 +1962,7 @@ class H(BaseHTTPRequestHandler):
|
||||
# 同一张码并发提交两次的话两边都会查到「可用」。绑不上 = 被别的提交抢先了。
|
||||
okb, eb, good = redeem_bind(good, oid)
|
||||
if not okb:
|
||||
shutil.rmtree(order_dir(oid), ignore_errors=True)
|
||||
drop_order(oid)
|
||||
log("兑换码并发冲突 %s:%s" % (ip, eb))
|
||||
return self.err(eb)
|
||||
meta["codes"] = good
|
||||
@@ -1942,7 +1972,7 @@ class H(BaseHTTPRequestHandler):
|
||||
except Exception:
|
||||
if not prepay:
|
||||
unbind_codes(good, oid) # 单没建成,码放回去
|
||||
shutil.rmtree(order_dir(oid), ignore_errors=True)
|
||||
drop_order(oid)
|
||||
raise
|
||||
note_submit(ip)
|
||||
if prepay:
|
||||
@@ -1964,7 +1994,7 @@ class H(BaseHTTPRequestHandler):
|
||||
_cs = load_codes()
|
||||
if newc in _cs:
|
||||
_cs[newc]["order"] = oid
|
||||
jsave(CODES_FILE, _cs)
|
||||
save_codes(_cs)
|
||||
meta["codes"] = [newc]
|
||||
with LOCK:
|
||||
write_meta(oid, meta)
|
||||
@@ -2249,7 +2279,7 @@ class H(BaseHTTPRequestHandler):
|
||||
if "测试" in title:
|
||||
log("爱发电回调:测试单(%s),只记账不发码" % title.strip())
|
||||
return self.js({"ec": 200, "em": ""})
|
||||
led = jload(PAYPLATFORM_LEDGER, {}) or {}
|
||||
led = STORE.ledger_all()
|
||||
# ⚠️ 2026-10-05(外部复查):幂等原来只认「发过码」。可「对上网页单、激活了」那条路记的是
|
||||
# code=None + used_by=<单号> —— 同一笔单再推一次(爱发电自己会重试;这个地址又是公开的,
|
||||
# 谁都能把报文原样再 POST 一遍)就不算处理过:第二次激活失败(单子已经在排队)→ 掉进
|
||||
@@ -2265,7 +2295,7 @@ class H(BaseHTTPRequestHandler):
|
||||
led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "status": order.get("status"),
|
||||
"amount": order.get("show_amount") or order.get("total_amount"),
|
||||
"code": None, "note": "未付款"}
|
||||
jsave(PAYPLATFORM_LEDGER, led)
|
||||
STORE.ledger_save(led)
|
||||
return self.js({"ec": 200, "em": ""})
|
||||
|
||||
real = payplatform_find_order(oid_af)
|
||||
@@ -2275,7 +2305,7 @@ class H(BaseHTTPRequestHandler):
|
||||
led[oid_af] = {"ts": now().isoformat(timespec="seconds"), "code": None,
|
||||
"amount": order.get("show_amount") or order.get("total_amount"),
|
||||
"note": "接口没查到,待人工核对", "need_human": True}
|
||||
jsave(PAYPLATFORM_LEDGER, led)
|
||||
STORE.ledger_save(led)
|
||||
return self.js({"ec": 200, "em": ""})
|
||||
|
||||
n_img_af = payplatform_img_count(real)
|
||||
@@ -2329,7 +2359,7 @@ class H(BaseHTTPRequestHandler):
|
||||
"want_order": target, "need": need, "paid": paid,
|
||||
"note": "金额不足(应付 ¥%s,实付 ¥%s),待人工核对" % (need, paid),
|
||||
"need_human": True}
|
||||
jsave(PAYPLATFORM_LEDGER, led)
|
||||
STORE.ledger_save(led)
|
||||
return self.js({"ec": 200, "em": "", "data": {"content":
|
||||
"金钻工坊 · 自助模板渲染\n收到你的付款,但金额和订单应付款(¥%s)对不上,已记下来等人工核对。\n"
|
||||
"核对没问题就立刻排队出图;如果是付少了,补齐后我们会马上处理。" % need}})
|
||||
@@ -2358,7 +2388,7 @@ class H(BaseHTTPRequestHandler):
|
||||
"(也可以留作支持 🙏)" % (_yuan(paid), _yuan(need), _yuan(over)))
|
||||
rec_led["content"] = content
|
||||
led[oid_af] = rec_led
|
||||
jsave(PAYPLATFORM_LEDGER, led)
|
||||
STORE.ledger_save(led)
|
||||
log("爱发电付款 %s(¥%s)→ 对上网页单 %s → 已激活进队列(靠:%s)"
|
||||
% (oid_af, led[oid_af]["amount"], target, how))
|
||||
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"),
|
||||
"paid": paid, "note": "金额不足一张(¥%s),待人工核对" % paid,
|
||||
"need_human": True}
|
||||
jsave(PAYPLATFORM_LEDGER, led)
|
||||
STORE.ledger_save(led)
|
||||
return self.js({"ec": 200, "em": "", "data": {"content":
|
||||
"金钻工坊 · 自助模板渲染\n收到你的付款 ¥%s,但不足一张(¥%s),没法自动发码。\n"
|
||||
"已记下来等人工核对;补齐差额后会马上补发。" % (paid, PRICE_UNIT)}})
|
||||
@@ -2386,10 +2416,6 @@ class H(BaseHTTPRequestHandler):
|
||||
% (oid_af, n_img_af, paid, afford, n_img))
|
||||
code = gen_codes(1, batch="爱发电自动", value=n_img * PRICE_UNIT, platform="爱发电",
|
||||
tpl="", n_fix=n_img)[0] # 不限模板、只限张数(金钻口径)
|
||||
try:
|
||||
os.chmod(CODES_FILE, 0o640)
|
||||
except OSError:
|
||||
pass
|
||||
content = ("金钻工坊 · 自助模板渲染\n这是你的卡密(固定 %d 张,模板随便挑):%s\n"
|
||||
"到 http<WIN-PATH> 点「卡密下单」填进去就能开始。"
|
||||
% (n_img, code))
|
||||
@@ -2409,7 +2435,7 @@ class H(BaseHTTPRequestHandler):
|
||||
"待人工看一眼(可能是想多买)"
|
||||
% (_yuan(over_code), _yuan(n_img * PRICE_UNIT), _yuan(paid)))
|
||||
led[oid_af] = rec_led
|
||||
jsave(PAYPLATFORM_LEDGER, led)
|
||||
STORE.ledger_save(led)
|
||||
log("爱发电卖出:%s | 金额 %s | 规格 %s | 留言 %s | 发码 %s(%d 张)"
|
||||
% (oid_af, led[oid_af]["amount"], sku_txt, (real.get("remark") or "-")[:30], code, n_img))
|
||||
# 发货内容塞进返回体(爱发电的自动发货会用 content 展示给买家;不认也没关系,
|
||||
@@ -2444,7 +2470,7 @@ class H(BaseHTTPRequestHandler):
|
||||
return self._activate_payplatform_locked(oid, m, ano, ip)
|
||||
|
||||
def _activate_payplatform_locked(self, oid, m, ano, ip):
|
||||
led = jload(PAYPLATFORM_LEDGER, {}) or {}
|
||||
led = STORE.ledger_all()
|
||||
rec = None
|
||||
for k, v in led.items():
|
||||
if str(k).endswith(ano) or str(k) == ano:
|
||||
@@ -2470,7 +2496,7 @@ class H(BaseHTTPRequestHandler):
|
||||
akey = rec["_key"] # ⚠️ 先存下来:下面要把 _key 从记录里 pop 掉,
|
||||
led[akey]["used_by"] = oid # 之后再读 rec["_key"] 就是 KeyError(2026-10-01 实踩,500)
|
||||
led[akey].pop("_key", None)
|
||||
jsave(PAYPLATFORM_LEDGER, led)
|
||||
STORE.ledger_save(led)
|
||||
m["payplatform_order"] = akey
|
||||
with LOCK:
|
||||
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:
|
||||
json.dump(rec, f, ensure_ascii=False, indent=1)
|
||||
# 走「呼叫金钻」同一套通知:他手机能收到
|
||||
try:
|
||||
with open(CALLS_FILE, "a", encoding="utf-8") as f:
|
||||
f.write(json.dumps({"ts": rec["ts"], "ip": ip, "order": rec["order"],
|
||||
add_call({"ts": rec["ts"], "ip": ip, "order": rec["order"],
|
||||
"notified": False, "kind": "反馈",
|
||||
"note": (note or "(只传了图)")[:120]}, ensure_ascii=False) + "\n")
|
||||
except OSError:
|
||||
pass
|
||||
"note": (note or "(只传了图)")[:120]})
|
||||
log("反馈 %s | 单 %s | 图 %s | %s" % (fid, rec["order"] or "-", rec["image"] or "无", (note or "")[:60]))
|
||||
return self.js({"ok": True, "id": fid})
|
||||
|
||||
@@ -2866,10 +2888,10 @@ class H(BaseHTTPRequestHandler):
|
||||
ip = ip_of(self)
|
||||
if ip and ip not in ("?", "localhost"):
|
||||
note_home_ip(ip)
|
||||
jsave(HB_IPS_FILE, {"ips": HOME_IPS})
|
||||
STORE.kv_put("home_ips", {"ips": HOME_IPS})
|
||||
with LOCK:
|
||||
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]})
|
||||
return self.js({"ok": True, "queue": len(list_orders(("waiting",)))})
|
||||
|
||||
@@ -3070,15 +3092,10 @@ class H(BaseHTTPRequestHandler):
|
||||
m["partial"] = {"got": len(files), "want": total,
|
||||
"why": str(d.get("note") or "")[:300],
|
||||
"at": now().isoformat(timespec="seconds")}
|
||||
try:
|
||||
with open(CALLS_FILE, "a", encoding="utf-8") as f:
|
||||
f.write(json.dumps({"ts": m["partial"]["at"], "ip": "渲染机", "order": oid,
|
||||
add_call({"ts": m["partial"]["at"], "ip": "渲染机", "order": oid,
|
||||
"notified": False, "kind": "部分失败",
|
||||
"note": ("收到 %d/%d 个文件:%s" % (len(files), total,
|
||||
m["partial"]["why"]))[:300]},
|
||||
ensure_ascii=False) + "\n")
|
||||
except OSError:
|
||||
pass
|
||||
m["partial"]["why"]))[:300]})
|
||||
log("⚠️ %s 部分失败:收到 %d/%d 个文件(%s)" % (oid, len(files), total, m["partial"]["why"]))
|
||||
if m.get("direct"):
|
||||
# 直发单不用确认收货 —— 渲完就是「开放下载」,保留期/核销都从这一刻起算
|
||||
@@ -3116,12 +3133,8 @@ class H(BaseHTTPRequestHandler):
|
||||
ip = self.headers.get("X-Real-IP") or self.client_address[0]
|
||||
nowt = now()
|
||||
# 限频:同 IP 10 分钟内最多 3 次
|
||||
try:
|
||||
recent = [json.loads(l) for l in open(CALLS_FILE, encoding="utf-8") if l.strip()]
|
||||
except OSError:
|
||||
recent = []
|
||||
n = sum(1 for r in recent[-50:] if r.get("ip") == ip
|
||||
and (nowt - datetime.fromisoformat(r["ts"])).total_seconds() < 600)
|
||||
since = (nowt - timedelta(seconds=600)).isoformat(timespec="seconds")
|
||||
n = len(STORE.calls(ip=ip, since=since))
|
||||
if n >= 3:
|
||||
return self.js({"ok": True, "throttled": True})
|
||||
rec = {"ts": nowt.isoformat(timespec="seconds"), "ip": ip,
|
||||
@@ -3131,8 +3144,7 @@ class H(BaseHTTPRequestHandler):
|
||||
"note": (d.get("note") or "")[:600],
|
||||
"email": (d.get("email") or "")[:120],
|
||||
"notified": False}
|
||||
with open(CALLS_FILE, "a", encoding="utf-8") as f:
|
||||
f.write(json.dumps(rec, ensure_ascii=False) + "\n")
|
||||
add_call(rec)
|
||||
log("呼叫金钻 %s" % rec)
|
||||
return self.js({"ok": True})
|
||||
|
||||
@@ -3341,11 +3353,16 @@ class H(BaseHTTPRequestHandler):
|
||||
except ValueError:
|
||||
limit = 60
|
||||
want = (q.get("state") or [""])[0].strip()
|
||||
# 2026-10-05:后台面板加了搜索框 —— 按码 / 订单号 / 批次 / 平台 找(不分大小写)
|
||||
kw = (q.get("q") or [""])[0].strip().upper()[:40]
|
||||
out = []
|
||||
for c, r in load_codes().items():
|
||||
st = code_state(r)
|
||||
if want and st != want:
|
||||
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"),
|
||||
"tpl": r.get("tpl"), "set": bool(r.get("set")),
|
||||
"direct": bool(r.get("direct")), "batch": r.get("batch"),
|
||||
@@ -3403,6 +3420,47 @@ class H(BaseHTTPRequestHandler):
|
||||
write_meta(oid, m)
|
||||
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):
|
||||
d = self.body_json() or {}
|
||||
oid = (d.get("oid") or "").strip().upper()
|
||||
|
||||
@@ -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)
|
||||
@@ -36,7 +36,7 @@
|
||||
| 进程 | 单进程,由 systemd 托管;内存上限被 cgroup 卡住(小机器上防它吃爆) |
|
||||
| 监听 | **只绑回环**,公网由 nginx 反代过去(后端自己不对外开端口) |
|
||||
| 账号 | 跑在专用非 root 用户下 |
|
||||
| 数据 | 全在本地文件 + 一个 SQLite(无外部服务) |
|
||||
| 数据 | **SQLite**(`<DATA_DIR>/ys.db`,标准库自带 `sqlite3`,无外部服务)+ 皮肤 / 成品图片文件。2026-10-05 接入,见第五节 |
|
||||
| 规模 | 单机单进程,日单量个位数到几十 |
|
||||
|
||||
**为什么不用框架**:这台机器很小(1G 多内存),装一个 Web 框架 + 一堆传递依赖不划算,
|
||||
@@ -51,8 +51,11 @@
|
||||
| `server.py` | ~3100 | **全部服务端逻辑**:路由、订单状态机、卡密生命周期、限流、PNG 结构核验的调用方、爱发电回调、打包下载、小票生成 |
|
||||
| `admin.py` | ~540 | 命令行管理工具:发卡密 / 看队列 / 重渲 / 清过期 / 审计被拦记录 |
|
||||
| `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 |
|
||||
| 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>/orders/<单号>/meta.json` | 订单:状态、皮肤数组、模板、金额、时间、条款留证、进度 |
|
||||
| `<DATA_DIR>/ys.db`(+ `-wal` / `-shm`) | 上面那个库(640 权限) |
|
||||
| `<DATA_DIR>/orders/<单号>/skins/` | 买家皮肤原图(落盘前已过 PNG 结构核验并剥掉元数据块) |
|
||||
| `<DATA_DIR>/orders/<单号>/out/` | 成品(标准压缩 + 无压缩 两个版本/张) |
|
||||
| `<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>/codes.json`、`orders/*/meta.json` … | **旧数据**:导入之后就不再读写,留着当回退的底 |
|
||||
|
||||
### 卡密生命周期(**激活 ≠ 核销**,这是刻意分开的)
|
||||
|
||||
|
||||
@@ -331,3 +331,54 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
|
||||
---
|
||||
|
||||
*以上改动都还只在工作区,等你们(和 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` 没清 → 一起清掉。
|
||||
|
||||
+308
-217
@@ -2,200 +2,241 @@
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<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>
|
||||
<style>
|
||||
:root{
|
||||
--bg:#08090a; --surface:rgba(255,255,255,.02); --line:rgba(255,255,255,.08); --line-soft:rgba(255,255,255,.05);
|
||||
--txt:#f7f8f8; --txt-2:#d0d6e0; --txt-3:#8a8f98; --txt-4:#62666d;
|
||||
--acc:#3ecf8e; --acc-hi:#4ade9f; --acc-hover:#37b87f;
|
||||
--ok:#3ecf8e; --ok-t:#5fd8a2; --warn:#d29922; --warn-t:#e0b355; --bad:#da3633; --bad-t:#f08a7c;
|
||||
}
|
||||
|
||||
/* ↓ 统一动效 token(金钻系四界面同值;本页跑在家里电脑上,引不到 /assets/tokens.css,
|
||||
照 tokens.css 复制同一份值 —— 改值要两边一起改) */
|
||||
:root{
|
||||
--ease-out:cubic-bezier(.23,1,.32,1); --ease-in-out:cubic-bezier(.77,0,.175,1);
|
||||
--d-press:100ms; --d-hover:150ms; --d-pop:200ms; --d-modal:240ms; --d-exit:180ms;
|
||||
}
|
||||
/* 本机开单(2026-10-05 重写:跟 2026 版网站 / 开单后台同一套样子 —— 白光 + 毛玻璃卡片 + MC 方块按钮)
|
||||
本页跑在家里电脑上,引不到网站的 css / 字体,颜色值照网站复制一份(改值要两边一起改)。
|
||||
布局:电脑上左边「皮肤 + 质检」、右边「模板 + 分辨率 + 开始」;出图结果在下面整行。手机上从上往下排。 */
|
||||
:root{--bg:#F5F7FB;--txt:#1E2440;--txt-2:#454B6B;--txt-3:#5E6482;--dim:#7E849C;
|
||||
--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);
|
||||
--mc:#3C8527;--mc-hi:#5BAA3C;--mc-lo:#1D4D13;--ok-t:#2F6E1F;
|
||||
--stone:#F3F4F6;--stone-lo:#B4B7BE;--stone-edge:#9EA2AA;
|
||||
--bad-t:#B33A2E;--warn-t:#9A6A0C;
|
||||
--ease:cubic-bezier(.23,1,.32,1);
|
||||
--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}
|
||||
body{margin:0;background:var(--bg);color:var(--txt-2);position:relative;padding:0 0 60px;
|
||||
font:15px/1.7 'OPPO Sans',system-ui,-apple-system,'PingFang SC','Microsoft YaHei',sans-serif;
|
||||
-webkit-font-smoothing:antialiased}
|
||||
body::before{content:"";position:fixed;inset:0 0 auto 0;height:40vh;pointer-events:none;
|
||||
background:radial-gradient(70% 100% at 50% 0%,rgba(62,207,142,.05),transparent 72%)}
|
||||
.wrap{max-width:860px;margin:0 auto;padding:0 20px;position:relative;z-index:1}
|
||||
header{border-bottom:1px solid var(--line-soft);background:rgba(8,9,10,.86);position:sticky;top:0;z-index:9;
|
||||
backdrop-filter:blur(12px)}
|
||||
.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)}
|
||||
.badge{margin-left:auto;font-size:12px;padding:4px 11px;border:1px solid var(--line-soft);
|
||||
border-radius:9999px;color:var(--txt-3);white-space:nowrap}
|
||||
.card{background:var(--surface);border:1px solid var(--line-soft);border-radius:8px;padding:22px;margin:16px 0}
|
||||
h2{font-size:16px;margin:0 0 4px;font-weight:700;color:var(--txt)}
|
||||
.hint{font-size:13px;color:var(--txt-4);margin:5px 0 18px;line-height:1.8}
|
||||
.drop{border:1px dashed rgba(255,255,255,.14);border-radius:8px;padding:32px 18px;text-align:center;
|
||||
cursor:pointer;transition:border-color var(--d-pop) var(--ease-out),background-color var(--d-pop) var(--ease-out)}
|
||||
.drop:hover,.drop.over{border-color:rgba(62,207,142,.55);background:rgba(62,207,142,.05)}
|
||||
.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}
|
||||
@media(min-width:680px){.split{grid-template-columns:200px 1fr;align-items:start}}
|
||||
.preview{border:1px solid var(--line-soft);border-radius:8px;padding:12px;text-align:center}
|
||||
.preview canvas{width:100%;max-width:176px;image-rendering:pixelated;border-radius:4px;
|
||||
background:linear-gradient(45deg,#141618 25%,transparent 25%,transparent 75%,#141618 75%),
|
||||
linear-gradient(45deg,#141618 25%,#0d0f10 25%,#0d0f10 75%,#141618 75%);
|
||||
background-size:11px 11px;background-position:0 0,5.5px 5.5px}
|
||||
.preview .fn{font-size:11.5px;color:var(--txt-4);margin-top:10px;word-break:break-all}
|
||||
.item{display:flex;gap:12px;padding:12px 14px;border-radius:6px;font-size:13.5px;background:rgba(255,255,255,.015);margin-bottom:8px}
|
||||
.item.warn{background:rgba(210,153,34,.055)}
|
||||
.item.bad{background:rgba(218,54,51,.055)}
|
||||
.tag{display:inline-flex;align-items:center;gap:7px;font-size:12px;color:var(--txt-4);flex:none;margin-top:1px;white-space:nowrap}
|
||||
.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)}
|
||||
.item.bad .tag::before{background:var(--bad)}
|
||||
[hidden]{display:none!important}
|
||||
body{margin:0;min-height:100vh;background:var(--bg);color:var(--txt);font:14.5px/1.65 var(--font);-webkit-font-smoothing:antialiased}
|
||||
body::before{content:"";position:fixed;inset:0;z-index:-1;pointer-events:none;background:
|
||||
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%),
|
||||
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%)}
|
||||
button,input{font:inherit;color:inherit}
|
||||
a{color:var(--mc);font-weight:700;text-decoration:none}
|
||||
a:hover{text-decoration:underline}
|
||||
|
||||
/* ---------- 顶栏 ---------- */
|
||||
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);
|
||||
-webkit-backdrop-filter:blur(14px) saturate(1.4);backdrop-filter:blur(14px) saturate(1.4)}
|
||||
.hd{max-width:1180px;margin:0 auto;padding:12px 20px;display:flex;align-items:center;gap:12px}
|
||||
.hd h1{margin:0;font-size:17px;letter-spacing:.02em}
|
||||
.hd .sub{font-size:12px;color:var(--dim)}
|
||||
.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;
|
||||
background:rgba(255,255,255,.85);border:1px solid var(--line-soft);color:var(--txt-3)}
|
||||
.badge.ok{color:var(--ok-t);background:rgba(91,170,60,.1);border-color:rgba(60,133,39,.25)}
|
||||
.badge.bad{color:var(--bad-t);background:rgba(210,72,58,.08);border-color:rgba(210,72,58,.25)}
|
||||
|
||||
/* ---------- 骨架 ---------- */
|
||||
.wrap{max-width:1180px;margin:0 auto;padding:20px}
|
||||
.cols{display:grid;grid-template-columns:minmax(0,5fr) minmax(0,7fr);gap:18px;align-items:start}
|
||||
.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}
|
||||
.step{display:flex;align-items:center;gap:10px;margin:0 0 4px}
|
||||
.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);
|
||||
font:800 14px/1 var(--mono);box-shadow:inset 0 2px 0 #fff,inset 0 -3px 0 var(--stone-lo)}
|
||||
.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)}
|
||||
.step h2{margin:0;font-size:17px}
|
||||
.hint{font-size:13px;color:var(--txt-3);margin:4px 0 16px;line-height:1.75}
|
||||
.hint b{color:var(--txt-2)}
|
||||
.lab{font-size:12.5px;font-weight:700;color:var(--txt-2);margin:18px 0 8px}
|
||||
.lab .h{font-weight:400;color:var(--dim)}
|
||||
|
||||
/* ---------- 按钮:绿 = 主,石头白 = 次 ---------- */
|
||||
.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;
|
||||
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}
|
||||
.t{font-weight:700;color:var(--txt-2)}
|
||||
.d{font-size:12.5px;color:var(--txt-4);margin-top:5px;line-height:1.75}
|
||||
.tpls{display:grid;gap:12px;grid-template-columns:repeat(auto-fill,minmax(150px,1fr))}
|
||||
.tpl{border:1px solid var(--line);border-radius:8px;cursor:pointer;position:relative;overflow:hidden;
|
||||
background:rgba(255,255,255,.015);transition:.15s}
|
||||
.tpl:hover{border-color:rgba(255,255,255,.16);background:rgba(255,255,255,.03)}
|
||||
.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;
|
||||
border-bottom:1px solid var(--line-soft);position:relative}
|
||||
.tpl .thumb::before{content:"";position:absolute;top:0;left:0;right:0;height:2px;background:var(--tone,#8a8f98);opacity:.5}
|
||||
.tpl .thumb svg{color:var(--tone,#8a8f98)}
|
||||
.tpl .meta{padding:11px 12px}
|
||||
.tpl .n{font-size:13px;font-weight:700;color:var(--txt-2)}
|
||||
.tpl .s{font-size:11.5px;color:var(--txt-4);margin-top:3px}
|
||||
.tpl .pick{position:absolute;top:9px;right:9px;width:18px;height:18px;border-radius:4px;font-size:11px;
|
||||
border:1px solid rgba(255,255,255,.2);background:rgba(8,9,10,.7);display:flex;align-items:center;
|
||||
justify-content:center;color:transparent}
|
||||
.tpl.sel .pick{background:var(--acc);border-color:var(--acc);color:#07150e}
|
||||
input.t{width:100%;background:rgba(255,255,255,.035);border:1px solid rgba(255,255,255,.13);
|
||||
border-radius:6px;color:var(--txt);padding:12px 14px;font:13.5px/1.6 inherit}
|
||||
input.t:focus{outline:none;border-color:var(--acc-hi);background:rgba(62,207,142,.05)}
|
||||
input.t::placeholder{color:#7c8290}
|
||||
.btns{display:flex;gap:10px;margin-top:18px;flex-wrap:wrap}
|
||||
button{font:inherit;border-radius:6px;padding:11px 18px;border:1px solid var(--line);
|
||||
background-color:rgba(255,255,255,.02);color:var(--txt-2);cursor:pointer;font-size:13.5px;font-weight:700;
|
||||
transition:border-color var(--d-hover) var(--ease-out),background-color var(--d-hover) var(--ease-out),
|
||||
color var(--d-hover) var(--ease-out),transform var(--d-press) var(--ease-out)}
|
||||
button:active:not(:disabled){transform:scale(.985)}
|
||||
button:hover:not(:disabled){background:rgba(255,255,255,.05);border-color:rgba(255,255,255,.14);color:var(--txt)}
|
||||
button.pri{background:var(--acc);border-color:var(--acc);color:#07150e;flex:1;min-width:180px}
|
||||
button.pri:hover:not(:disabled){background:var(--acc-hover);border-color:var(--acc-hover)}
|
||||
button:disabled{opacity:.32;cursor:not-allowed}
|
||||
.warnbar{padding:13px 15px;border-radius:6px;font-size:13px;background:rgba(210,153,34,.08);
|
||||
border:1px solid rgba(210,153,34,.24);color:var(--txt-3);margin-bottom:14px;line-height:1.75}
|
||||
.errbar{padding:13px 15px;border-radius:6px;font-size:13px;background:rgba(218,54,51,.08);
|
||||
border:1px solid rgba(218,54,51,.24);color:var(--txt-3);margin:14px 0;line-height:1.75;white-space:pre-wrap}
|
||||
.bar{height:3px;border-radius:2px;background:rgba(255,255,255,.07);overflow:hidden;margin:16px 0 10px}
|
||||
.bar i{display:block;height:100%;background:var(--acc);width:0;transition:width .4s var(--ease-out)}
|
||||
.res{display:grid;gap:14px;grid-template-columns:repeat(auto-fill,minmax(190px,1fr));margin-top:6px}
|
||||
.res .one{border:1px solid var(--line);border-radius:8px;overflow:hidden}
|
||||
.res img{width:100%;display:block;background:#0d0f10}
|
||||
.res .cap{padding:10px 12px;font-size:12px;color:var(--txt-4)}
|
||||
.res .cap b{color:var(--txt-2);font-size:13px;display:block;margin-bottom:3px}
|
||||
.res .dls{margin-top:7px;line-height:2}
|
||||
.res a{color:var(--acc-hi);text-decoration:none;font-size:12.5px}
|
||||
footer{text-align:center;font-size:11.5px;color:var(--txt-4);padding:34px 20px 0;line-height:2}
|
||||
.toast{position:fixed;left:50%;bottom:30px;transform:translate(-50%,12px);opacity:0;z-index:90;
|
||||
background:#16181b;border:1px solid var(--line);border-radius:6px;padding:11px 17px;font-size:13.5px;
|
||||
color:var(--txt-2);pointer-events:none;max-width:88vw;
|
||||
/* 2026-10-02 统一:toast 180ms --ease-out(原 .2s 内建 ease) */
|
||||
transition:opacity var(--d-exit) var(--ease-out),transform var(--d-exit) var(--ease-out)}
|
||||
.bd .t{font-weight:700;color:var(--txt)}
|
||||
.bd .d{font-size:12.5px;color:var(--txt-3);margin-top:2px;line-height:1.7}
|
||||
details.terms{margin-top:16px;font-size:12.5px;color:var(--txt-3)}
|
||||
details.terms summary{cursor:pointer;color:var(--mc);font-weight:700}
|
||||
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)}
|
||||
.copyterms{margin-top:8px}
|
||||
|
||||
/* ---------- 2 · 模板 ---------- */
|
||||
.tpls{display:grid;gap:10px;grid-template-columns:repeat(auto-fill,minmax(138px,1fr))}
|
||||
.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;
|
||||
box-shadow:0 12px 24px -20px rgba(80,90,170,.55);transition:transform .15s var(--ease),border-color .15s,box-shadow .15s}
|
||||
.tpl:hover{transform:translateY(-2px)}
|
||||
.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 .thumb{position:relative;aspect-ratio:4/3;display:grid;place-items:center;background:#EEF1F7;
|
||||
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))}
|
||||
.tpl .thumb svg{width:40px;height:40px;color:var(--tone);opacity:.85}
|
||||
.tpl .meta{padding:9px 11px 10px}
|
||||
.tpl .n{font-size:13.5px;font-weight:700;color:var(--txt)}
|
||||
.tpl .s{font-size:11.5px;color:var(--dim);margin-top:1px}
|
||||
.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}
|
||||
.tpl.sel .pick{background:var(--mc);border-color:var(--mc-lo);color:#fff}
|
||||
.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}
|
||||
.tpl:not(.sel) .ord{display:none}
|
||||
.seg{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:6px}
|
||||
.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;
|
||||
font:800 15px/1.2 var(--mono);color:var(--txt-2);transition:border-color .12s,background .12s,color .12s}
|
||||
.seg button small{display:block;margin-top:3px;font:400 11.5px/1.3 var(--font);color:var(--dim)}
|
||||
.seg button:hover{background:#fff}
|
||||
.seg button.on{border-color:var(--mc);background:rgba(91,170,60,.1);color:var(--ok-t)}
|
||||
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}
|
||||
input.t:focus{border-color:var(--mc)}
|
||||
input.t::placeholder{color:#9AA0B4}
|
||||
.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}
|
||||
.sum b{color:var(--ok-t)}
|
||||
.sum.idle{background:rgba(30,36,64,.04);border-color:var(--line-soft);color:var(--dim)}
|
||||
.btns{display:flex;gap:10px;margin-top:14px;flex-wrap:wrap}
|
||||
.prog{margin-top:16px}
|
||||
.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)}
|
||||
.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)}
|
||||
.prog .hint{margin:8px 0 0}
|
||||
|
||||
/* ---------- 3 · 出图 ---------- */
|
||||
.res{display:grid;gap:14px;grid-template-columns:repeat(auto-fill,minmax(210px,1fr))}
|
||||
.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 img{width:100%;display:block;aspect-ratio:1/1;object-fit:cover;background:#EEF1F6}
|
||||
.res .cap{padding:10px 12px 12px;font-size:12px;color:var(--dim)}
|
||||
.res .cap b{display:block;font-size:14px;color:var(--txt);margin-bottom:1px}
|
||||
.res .dls{display:flex;gap:6px;flex-wrap:wrap;margin-top:8px}
|
||||
.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;
|
||||
box-shadow:inset 0 2px 0 #fff,inset 0 -3px 0 var(--stone-lo);text-decoration:none}
|
||||
.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)}
|
||||
|
||||
/* ---------- 动效降级:prefers-reduced-motion(2026-10-02 补,原来完全没有)---------- */
|
||||
@media (prefers-reduced-motion:reduce){
|
||||
*{animation-duration:1ms!important;animation-iteration-count:1!important}
|
||||
.toast,.toast.show{transform:translate(-50%,0)}
|
||||
button:active:not(:disabled){transform:none}
|
||||
@media (max-width:900px){
|
||||
.cols{grid-template-columns:minmax(0,1fr)}
|
||||
.hd{padding:10px 14px}.hd .sub{display:none}
|
||||
.wrap{padding:14px 12px}
|
||||
.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>
|
||||
</head>
|
||||
<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>
|
||||
<span class="sub">平台单 · 只在这台电脑上能打开</span>
|
||||
<span class="sub">平台单 · 只在这台电脑上能打开 · 不联网、不要卡密</span>
|
||||
<span class="badge" id="health">体检中…</span>
|
||||
</div></header>
|
||||
|
||||
<div class="wrap">
|
||||
<div id="syswarn"></div>
|
||||
|
||||
<div class="card">
|
||||
<h2>1 · 皮肤</h2>
|
||||
<p class="hint">把买家发的皮肤图拖进来,或点一下选。质检规则和网页版是同一份代码。</p>
|
||||
<details style="margin:10px 0 0;font-size:12.5px;color:var(--dim)">
|
||||
<summary style="cursor:pointer">发给买家的说明(可直接复制)</summary>
|
||||
<pre style="white-space:pre-wrap;font:12px/1.7 inherit;margin:9px 0 0;padding:10px 11px;
|
||||
border-left:2px solid var(--line);background:rgba(255,255,255,.02);border-radius:0 6px 6px 0">只提供渲染服务,不对皮肤内容与渲染结果作合规担保。
|
||||
皮肤由买家自行提供,其内容合法性由提供者负责;
|
||||
因皮肤内容(含夹带数据、隐藏信息、违规图案)产生的任何后果,由提供者承担。
|
||||
模板质量问题由金钻负责维护修复,非质量问题不予重做。
|
||||
一经发现违法内容,将立即停止服务、删除相关文件、拒绝后续接单。</pre>
|
||||
</details>
|
||||
<div class="drop" id="drop">
|
||||
<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="cols">
|
||||
<div class="card" id="card1">
|
||||
<div class="step" id="st1"><span class="num">1</span><h2>皮肤</h2></div>
|
||||
<p class="hint">把买家发的皮肤图拖进来、点一下选,或者直接 Ctrl+V 粘贴。质检规则和网页版是同一份代码。</p>
|
||||
<button type="button" class="drop" id="drop">
|
||||
<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>
|
||||
<div class="big" id="dropBig">点击选择皮肤文件</div>
|
||||
<div class="small">或把 .png 拖到这里 / 直接粘贴图片</div>
|
||||
</div>
|
||||
</button>
|
||||
<input type="file" id="file" accept="image/png" hidden>
|
||||
<div id="pvwrap" style="display:none;margin-top:18px">
|
||||
<div class="split">
|
||||
<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>
|
||||
<button type="button" class="btn copyterms" id="copyTerms" style="height:34px;font-size:13px">复制这段话</button>
|
||||
</details>
|
||||
</div>
|
||||
|
||||
<div class="card" id="card2">
|
||||
<h2>2 · 模板</h2>
|
||||
<p class="hint">勾几个就出几张。一次渲一张,不会把机器顶满。</p>
|
||||
<div class="step" id="st2"><span class="num">2</span><h2>模板</h2></div>
|
||||
<p class="hint">勾几个就出几张,按勾的顺序出。一次渲一张,不会把机器顶满。</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="lab">出图分辨率 <span class="h">默认 1000 = 网易我的世界头图标准,文件名不带数字;换别的才写进文件名(如 飞跃樱花林2048.png)</span></div>
|
||||
<div class="seg" id="resSeg"></div>
|
||||
</div>
|
||||
<div style="margin-top:16px">
|
||||
<input class="t" id="note" placeholder="买家备注(选填,会记进留档,比如闲鱼订单号 / 昵称)">
|
||||
</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 class="pri" id="go" disabled>开始渲染</button>
|
||||
<button class="ghost" id="clear">清空</button>
|
||||
<button type="button" class="btn pri big" id="go" disabled>开始渲染</button>
|
||||
<button type="button" class="btn" id="clear">清空</button>
|
||||
</div>
|
||||
<div id="progWrap" style="display:none">
|
||||
<div class="prog" id="progWrap" hidden>
|
||||
<div class="bar"><i id="bar"></i></div>
|
||||
<div class="hint" id="progTxt" style="margin:0"></div>
|
||||
<div class="hint" id="progTxt"></div>
|
||||
</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="card" id="card3" hidden>
|
||||
<div class="step done"><span class="num">3</span><h2>出图</h2></div>
|
||||
<p class="hint"><span id="resHint"></span> 每张模板出<b>两张</b>:标准压缩(发预览 / 常规交付)+ 无压缩 16bit(客户要高清时给),两张都发过去。</p>
|
||||
<div class="res" id="res"></div>
|
||||
<div class="btns">
|
||||
<button id="open">打开留档文件夹</button>
|
||||
<button class="ghost" id="again">再开一单</button>
|
||||
<button type="button" class="btn pri" id="open">打开留档文件夹</button>
|
||||
<button type="button" class="btn" id="again">再开一单</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer>
|
||||
本工具只监听 localhost · 不联网 · 不上传 · 不需要兑换码<br>
|
||||
所有文件都留在你自己电脑上 · <a href="#" id="quit" style="color:var(--txt-4)">退出工具</a>
|
||||
本工具只监听 localhost · 不联网 · 不上传 · 不需要兑换码 · 所有文件都留在你自己电脑上<br>
|
||||
<a href="#" id="quit">退出工具</a>
|
||||
</footer>
|
||||
</div>
|
||||
<div class="toast" id="toast"></div>
|
||||
<div class="toast" id="toast" role="status" aria-live="polite"></div>
|
||||
|
||||
<script src="skincheck.js"></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);}
|
||||
|
||||
const TEMPLATES=[
|
||||
{k:'stand', n:'站立正反', s:'正面站立 · 干净背景', c:'#8a8f98'},
|
||||
{k:'standb', n:'站立正反(虚化)', s:'同款 + 景深虚化', c:'#6f7680'},
|
||||
{k:'wheat', n:'麦田萤火', s:'麦田 · 暖光 · 萤火', c:'#a8863a'},
|
||||
{k:'beach', n:'海边自拍', s:'海面 · 天光', c:'#4a7fa5'},
|
||||
{k:'boom', n:'不看爆炸', s:'身后爆炸 · 不回头', c:'#a2563f'},
|
||||
{k:'sakura', n:'飞跃樱花林', s:'樱花 · 动态', c:'#b07a92'},
|
||||
{k:'airship', n:'空艇巡游', s:'飞空艇 · 巡航', c:'#5e7f8f'}
|
||||
{k:'stand', n:'站立正反', s:'正面站立 · 干净背景', c:'#6F7A90'},
|
||||
{k:'standb', n:'站立正反(虚化)', s:'同款 + 景深虚化', c:'#7C86A8'},
|
||||
{k:'wheat', n:'麦田萤火', s:'麦田 · 暖光 · 萤火', c:'#C08A2A'},
|
||||
{k:'beach', n:'海边自拍', s:'海面 · 天光', c:'#3D86C2'},
|
||||
{k:'boom', n:'不看爆炸', s:'身后爆炸 · 不回头', c:'#C9573A'},
|
||||
{k:'sakura', n:'飞跃樱花林', s:'樱花 · 动态', c:'#D0739A'},
|
||||
{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};
|
||||
|
||||
/* 分辨率:文件名就是它。耗时按像素数粗估(1000² ≈ 40 秒 GPU 打底) */
|
||||
const RES=[{v:1000,t:'网易头图标准 · 约 40 秒'},
|
||||
{v:1024,t:'约 45 秒'},
|
||||
{v:2048,t:'约 2.5 分钟'},
|
||||
{v:4096,t:'约 10 分钟'}];
|
||||
const RES=[{v:1000,t:'头图标准 · 约 40 秒',sec:40},
|
||||
{v:1024,t:'约 45 秒',sec:45},
|
||||
{v:2048,t:'约 2.5 分钟',sec:150},
|
||||
{v:4096,t:'约 10 分钟',sec:600}];
|
||||
RES.forEach(r=>{
|
||||
const lb=document.createElement('label');
|
||||
lb.innerHTML=r.v+'<small>'+r.t+'</small>';
|
||||
if(r.v===S.res) lb.classList.add('sel');
|
||||
lb.onclick=()=>{ S.res=r.v;
|
||||
document.querySelectorAll('#resSeg label').forEach(x=>x.classList.remove('sel'));
|
||||
lb.classList.add('sel'); };
|
||||
$('#resSeg').appendChild(lb);
|
||||
const b=document.createElement('button'); b.type='button';
|
||||
b.innerHTML=r.v+'<small>'+r.t+'</small>';
|
||||
if(r.v===S.res) b.classList.add('on');
|
||||
b.onclick=()=>{ S.res=r.v; $$('#resSeg button').forEach(x=>x.classList.toggle('on',x===b)); syncGo(); };
|
||||
$('#resSeg').appendChild(b);
|
||||
});
|
||||
|
||||
/* ---------- 渲染模板卡片 ---------- */
|
||||
/* ---------- 模板卡片 ---------- */
|
||||
TEMPLATES.forEach(t=>{
|
||||
const el=document.createElement('div');
|
||||
el.className='tpl'; el.dataset.k=t.k; el.style.setProperty('--tone',t.c);
|
||||
el.innerHTML='<div class="thumb"><div class="ph">'
|
||||
+'<svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor"'
|
||||
+' stroke-width="1.1" stroke-linejoin="round" opacity=".42"><path d="M12 2.6 21 7.3v9.4L12 21.4 3 16.7V7.3z"/>'
|
||||
+'<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>';
|
||||
const el=document.createElement('button');
|
||||
el.type='button'; el.className='tpl'; el.dataset.k=t.k; el.style.setProperty('--tone',t.c);
|
||||
el.setAttribute('aria-pressed','false');
|
||||
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">'
|
||||
+(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>';
|
||||
el.querySelector('.n').textContent=t.n; el.querySelector('.s').textContent=t.s;
|
||||
el.onclick=()=>{
|
||||
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); }
|
||||
el.classList.toggle('sel'); syncGo();
|
||||
syncTpls(); syncGo();
|
||||
};
|
||||
$('#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) ---------- */
|
||||
const drop=$('#drop'), fileIn=$('#file');
|
||||
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');}));
|
||||
['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); });
|
||||
/* 拖到页面别处也能收(不然浏览器会直接打开这张图、把页面换掉) */
|
||||
['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=>{
|
||||
for(const it of (e.clipboardData||{}).items||[]){
|
||||
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(';')+'(不影响出图)');
|
||||
const fr=new FileReader();
|
||||
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.src=fr.result; };
|
||||
fr.readAsDataURL(f);
|
||||
@@ -286,53 +341,69 @@ function runCheck(img,name,w,h){
|
||||
const c=$('#pv'); c.width=64; c.height=64;
|
||||
const g=c.getContext('2d'); g.imageSmoothingEnabled=false;
|
||||
g.clearRect(0,0,64,64); g.drawImage(img,0,0,64,64);
|
||||
$('#pvName').textContent=name+' ('+a.origW+'×'+a.origH+')';
|
||||
$('#pvwrap').style.display='';
|
||||
$('#pvName').textContent=name+'('+a.origW+'×'+a.origH+')';
|
||||
$('#pvwrap').hidden=false;
|
||||
drop.classList.add('has'); $('#dropBig').textContent='换一张皮肤';
|
||||
|
||||
const box=$('#report'); box.innerHTML='';
|
||||
rep.items.forEach(it=>{
|
||||
const d=document.createElement('div'); d.className='item '+it.lv;
|
||||
const tg=document.createElement('span'); tg.className='tag'; tg.textContent=it.tag;
|
||||
const row=(lv,tag,t,d)=>{
|
||||
const el=document.createElement('div'); el.className='item '+lv;
|
||||
const tg=document.createElement('span'); tg.className='tag'; tg.textContent=tag;
|
||||
const bd=document.createElement('div'); bd.className='bd';
|
||||
const t=document.createElement('div'); t.className='t'; t.textContent=it.t;
|
||||
const dd=document.createElement('div'); dd.className='d'; dd.textContent=it.d;
|
||||
bd.appendChild(t); bd.appendChild(dd); d.appendChild(tg); d.appendChild(bd);
|
||||
box.appendChild(d);
|
||||
});
|
||||
if(rep.hasBad){
|
||||
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);
|
||||
}
|
||||
const tt=document.createElement('div'); tt.className='t'; tt.textContent=t;
|
||||
const dd=document.createElement('div'); dd.className='d'; dd.textContent=d;
|
||||
bd.appendChild(tt); if(d) bd.appendChild(dd); el.appendChild(tg); el.appendChild(bd); box.appendChild(el);
|
||||
};
|
||||
rep.items.forEach(it=>row(it.lv,it.tag,it.t,it.d));
|
||||
if(rep.hasBad) row('bad','不通过','这张皮肤不能直接渲','上面标了不通过的问题得先解决。请买家换一张标准皮肤。');
|
||||
syncGo();
|
||||
}
|
||||
|
||||
/* ---------- 提交 ---------- */
|
||||
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()=>{
|
||||
if(!S.skin) return toast('先选皮肤');
|
||||
if(!S.sel.length) return toast('先勾模板');
|
||||
if(S.report&&S.report.hasBad) return toast('质检不通过,不能提交');
|
||||
$('#go').disabled=true;
|
||||
$('#progWrap').style.display=''; $('#card3').style.display='none';
|
||||
$('#progWrap').hidden=false; $('#card3').hidden=true;
|
||||
$('#bar').style.width='4%'; $('#progTxt').textContent='提交中…';
|
||||
// 皮肤转 base64 送本机接口
|
||||
const c=document.createElement('canvas');
|
||||
c.width=S.analysis.origW; c.height=S.analysis.origH;
|
||||
const g=c.getContext('2d'); g.imageSmoothingEnabled=false;
|
||||
g.drawImage(S.skin,0,0,S.analysis.origW,S.analysis.origH);
|
||||
const data=c.toDataURL('image/png');
|
||||
const st=await (await fetch('/api/render',{method:'POST',headers:{'Content-Type':'application/json'},
|
||||
let st;
|
||||
try{
|
||||
st=await (await fetch('/api/render',{method:'POST',headers:{'Content-Type':'application/json'},
|
||||
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();
|
||||
if(!st.ok){ $('#go').disabled=false; $('#progWrap').style.display='none'; return toast(st.error||'提交失败'); }
|
||||
}catch(e){ st={ok:false,error:'连不上本机工具(是不是已经退出了?)'}; }
|
||||
if(!st.ok){ $('#go').disabled=false; $('#progWrap').hidden=true; return toast(st.error||'提交失败'); }
|
||||
S.job=st.job; 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);
|
||||
$('#bar').style.width=Math.max(pct,j.state==='done'?100:4)+'%';
|
||||
const ahead = Math.max((j.queue_pos||1) - 1, 0);
|
||||
@@ -343,15 +414,16 @@ async function poll(){
|
||||
+'(每张出标准 + 无压缩两张)')
|
||||
: j.state==='done' ? '全部完成' : '出错了';
|
||||
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;
|
||||
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='';
|
||||
$('#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】两个下载
|
||||
const groups=[];
|
||||
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}); });
|
||||
groups.forEach(g=>{
|
||||
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>';
|
||||
d.querySelector('b').textContent=g.tplName||g.tpl;
|
||||
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=>{
|
||||
const a=document.createElement('a');
|
||||
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);
|
||||
});
|
||||
@@ -376,34 +448,53 @@ async function poll(){
|
||||
box.appendChild(e);
|
||||
}
|
||||
S.job=j.id; toast('出图完成');
|
||||
$('#card3').scrollIntoView({behavior:'smooth',block:'start'});
|
||||
}
|
||||
|
||||
$('#quit').onclick=async e=>{ e.preventDefault();
|
||||
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()=>{
|
||||
const r=await (await fetch('/api/openfolder',{method:'POST',headers:{'Content-Type':'application/json'},
|
||||
body:JSON.stringify({job:S.job})})).json();
|
||||
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()=>{
|
||||
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=[];
|
||||
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.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){
|
||||
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=>({'&':'&','<':'<','>':'>'}[c]))).join('<br>');
|
||||
$('#syswarn').appendChild(w);
|
||||
}
|
||||
})();
|
||||
syncGo();
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
+668
-681
File diff suppressed because it is too large
Load Diff
@@ -17,7 +17,7 @@
|
||||
```
|
||||
<WORKER_DIR>\
|
||||
├─ ys_worker.py 渲染机主程序(开机自启的计划任务;轮询领单 → 调 Blender → 回传)
|
||||
├─ ys_admin.py 开单后台(局域网面板:发卡密 / 激活订单 / 免费码),自带 PIN 锁
|
||||
├─ ys_admin.py 开单后台(局域网面板:待处理 / 订单 / 卡密 / 福利券 / 呼叫·反馈),自带 PIN 锁
|
||||
├─ ys_local.py 纯本机开单工具(不联网、不上传、不要卡密;拖皮肤→勾模板→出图)
|
||||
├─ local.html 本机开单工具的页面(ys_local.py 内嵌服务它)
|
||||
├─ make_order.py Blender 出图脚本(渲染机调用它;改模板/分辨率/臂型都在这)
|
||||
@@ -51,14 +51,42 @@
|
||||
```
|
||||
|
||||
### ② 开单后台(`ys_admin.py`,局域网)
|
||||
四块:① 生成卡密 ② 待激活订单(一键激活进队列)③ 最近卡密 ④ 免费码(福利券)批次管理。
|
||||
**自带 PIN 锁**:首次打开自己设 4~12 位数字,存**加盐 sha256**(不是明文),12 小时免输;
|
||||
校验在服务端,直接打接口也会 401。
|
||||
**2026-10-05 页面重写**:样子跟 2026 版网站统一(白光 + 毛玻璃卡片 + MC 方块按钮),按「要干的事」分页:
|
||||
|
||||
| 页 | 干什么 | 新增 / 变化 |
|
||||
|---|---|---|
|
||||
| **待处理**(默认打开) | 渲染机在不在、队列、待激活、卡密数一眼看完;下面是**要你动手的**:买家说付好了的单(排最前)、渲染失败的单、没处理的呼叫 | 失败的单有「退回重渲」按钮(以前只能写「喊苏达用 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`,只监听回环)
|
||||
给**平台单**(聊天里成交的买家)用:拖皮肤 → 同一套质检 → 勾模板 → 本机 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 上跑**(页面发给本机接口的字段和原来一样)。
|
||||
|
||||
---
|
||||
|
||||
## 四、几个刻意做出的设计(欢迎质疑)
|
||||
|
||||
@@ -83,3 +83,32 @@ ys_admin.py 的「令牌 + PIN + 自定义请求头」做法本身是对的:
|
||||
---
|
||||
|
||||
*以上改动都还只在工作区,等你们(和 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 上跑
|
||||
```
|
||||
|
||||
+14
-9
@@ -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 |
|
||||
|---|---|---|
|
||||
| `README.md` | 8,498 | `15ccb27558e0612ff1a9fc7822f7a0ec8da298753617b317cbf057a4902ddbb5` |
|
||||
| `backend-site/admin.py` | 24,214 | `3b9818c063e4c7297d3052cad4ff2a88941b4d07b85e2e5eaf495eed35d3f484` |
|
||||
| `README.md` | 8,696 | `5cef368dbf5916def012dbfcf7fdfb35d1f435faf5a7b42b65f6ad683343b1c2` |
|
||||
| `backend-site/admin.py` | 26,020 | `d7f86dcf0b07962ceb55a7714b43c876628118d19159dc3a9215535db1bc47f7` |
|
||||
| `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` |
|
||||
| `backend-site/server.py` | 160,560 | `9470b057f9eaf1927d06917ac5909fb0e733a4b44a04c039b82bbd907b9f2a62` |
|
||||
| `backend-site/交接说明.md` | 14,711 | `6b98b87c0f061760ec73e78036cf563b1c27fc8dead2324685b7218b61c9be72` |
|
||||
| `backend-site/server.py` | 181,352 | `438fcd98d57043ee503222b6decc83e873dda2d62c66a8d36f521c7d21e6afed` |
|
||||
| `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/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` |
|
||||
| `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/open_local.bat` | 81 | `cf91a0f9bbf18db6b082874131aacb8bc04924bf68d355481a9445b26c46ab30` |
|
||||
| `backend-tools/pack_archive.bat` | 86 | `e2c6683d0b353ae8f68d9f9c0430c486aa733c57c6d2f4e7802bdd5e53783c00` |
|
||||
@@ -24,10 +28,11 @@
|
||||
| `backend-tools/skincheck.js` | 13,011 | `dc9c65ac8b8551aaa42ca7399517bb1d6c28956c4c80997132f16862e1239b8d` |
|
||||
| `backend-tools/stop_admin.bat` | 281 | `9b38682234f2e07b58c478c939f4f1d58cefe9624b13d0af2656d5522fd5509d` |
|
||||
| `backend-tools/stop_worker.bat` | 332 | `f7c8ab10d1d03d7a75c2fcb3343bec0c6d52409ef5cc6dd68c0f9e342e0077b4` |
|
||||
| `backend-tools/ys_admin.py` | 58,367 | `05878039c3728fc119c75ad76f216298d6c82e6cc19b79024090a89d8cc7fc84` |
|
||||
| `backend-tools/ys_local.py` | 17,021 | `27948a19f45aa984e0f9ffc88b6cd85bbe127e8f4ceff272fd189a49524fec1f` |
|
||||
| `backend-tools/ys_admin.py` | 74,901 | `69f7938cb7f4fb96ec16fecb2272b1d1b6688dafbc28a4d72dc7b1ea53853f35` |
|
||||
| `backend-tools/ys_local.py` | 18,243 | `ea0b3208ec34ba4817b4513feb64d47eb7746cb5d1536191f295eb830107d15d` |
|
||||
| `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` |
|
||||
| `他应该知道的.md` | 6,988 | `177f08cb455bf5cf4b299abda5b227ff530c1da634c69f81c8ca7498ccc00cbe` |
|
||||
| `回执模板.md` | 5,049 | `0e38a6c19dff7b55767b8998d294b0252aa6024053dad0c63956ddd58b56a07a` |
|
||||
|
||||
@@ -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 · 未测绘'],
|
||||
},
|
||||
};
|
||||
@@ -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 => ({ '&': '&', '<': '<', '>': '>', '"': '"' }[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 };
|
||||
}
|
||||
@@ -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; },
|
||||
};
|
||||
}
|
||||
@@ -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}}
|
||||
@@ -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
@@ -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.
|
||||
+6
File diff suppressed because one or more lines are too long
Binary file not shown.
+135
-1340
File diff suppressed because one or more lines are too long
+353
@@ -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/`),本地从仓库根目录起服务时「首页」会跳到仓库根,线上没问题。
|
||||
- 署名按要求没改(「苏达 · 大肥鱼」)。
|
||||
@@ -1,5 +1,8 @@
|
||||
# 交接说明 · 金钻客栈 2026 视觉改版(白光藏色 × MC 方块)
|
||||
|
||||
> ⚠️ 这一份只讲 `11eb16c` 那一轮视觉改版。之后「金钻宇宙」板块换成了星系图(这次改了门户原有的 JS,下面「原有脚本一字未改」那句对门户已不成立),后端也接了数据库。
|
||||
> **完整的、最新的情况以根目录 `交接文档-2026-10.md` 为准。**
|
||||
|
||||
## 一句话
|
||||
|
||||
两个页面换成了**浅色的「白光藏色」+ Minecraft 方块风**:整体一眼是白的,颜色藏在亮部和流动的淡彩背景里;按钮是 MC Ore UI 那种方块按钮;标题换成像素字;手机端换成底部物品栏导航。
|
||||
|
||||
Reference in New Issue
Block a user