portal: 金钻宇宙换成星系图(three.js 懒加载)+ 推送前审查 + 总交接文档

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yws
2026-10-05 17:31:36 +00:00
co-authored by Claude Opus 5.5
parent 3ae940d828
commit 09b229deee
19 changed files with 1444 additions and 1355 deletions
+2
View File
@@ -11,6 +11,8 @@
| `portal/` `order/` | 门户与下单页(前端) | 上一批(视觉重设计) | | `portal/` `order/` | 门户与下单页(前端) | 上一批(视觉重设计) |
| **`backend/`** | **网站后端 + 本地自助管理后台 + 测试用 Blender 工程 + 部署层片段** | **本批** | | **`backend/`** | **网站后端 + 本地自助管理后台 + 测试用 Blender 工程 + 部署层片段** | **本批** |
> **总交接文档:`交接文档-2026-10.md`**(2026-10 这一轮前后端所有改动 / 功能增删 / 设计规范 / 业务逻辑 / 部署运维)。
>
> 看后端请从 **`backend/他应该知道的.md`** 开始读(生意背景 / 机器约束 / 数据边界 / 术语表), > 看后端请从 **`backend/他应该知道的.md`** 开始读(生意背景 / 机器约束 / 数据边界 / 术语表),
> 再进 `backend/README.md` 和两份交接说明。 > 再进 `backend/README.md` 和两份交接说明。
> 写回执照 **`backend/回执模板.md`** 填。 > 写回执照 **`backend/回执模板.md`** 填。
+2
View File
@@ -9,6 +9,8 @@
## 怎么读这份包(建议顺序) ## 怎么读这份包(建议顺序)
> 2026-10 这一轮(数据库、开单后台 / 本机开单重写、前端星系图)的总说明在仓库根目录 **`交接文档-2026-10.md`**。
| 顺序 | 读什么 | 为什么先读它 | | 顺序 | 读什么 | 为什么先读它 |
|---|---|---| |---|---|---|
| 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** | | 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** |
+7 -2
View File
@@ -736,7 +736,11 @@ def add_call(rec):
数据库 calls 表是正本(后台和限频都查它);**同时照旧追加一行到 calls.jsonl** —— 数据库 calls 表是正本(后台和限频都查它);**同时照旧追加一行到 calls.jsonl** ——
手机通知那边是盯着这个文件的(那段不在这份代码里),不能让它断。 手机通知那边是盯着这个文件的(那段不在这份代码里),不能让它断。
""" """
# ⚠️ 这条也会在渲染机回传(finish_upload)里调:库写失败只记日志,绝不能让异常把回传打断
try:
STORE.call_add(rec) STORE.call_add(rec)
except Exception as e: # noqa: BLE001
log("⚠️ 呼叫记录写库失败(只写了 calls.jsonl):%r" % (e,))
try: try:
with open(CALLS_FILE, "a", encoding="utf-8") as f: with open(CALLS_FILE, "a", encoding="utf-8") as f:
f.write(json.dumps(rec, ensure_ascii=False) + "\n") f.write(json.dumps(rec, ensure_ascii=False) + "\n")
@@ -3433,8 +3437,9 @@ class H(BaseHTTPRequestHandler):
cid = int(d.get("id")) cid = int(d.get("id"))
except (TypeError, ValueError): except (TypeError, ValueError):
return self.err("没有这条记录", 404) return self.err("没有这条记录", 404)
if not STORE.call_mark(cid, handled=not d.get("undo"), undo = bool(d.get("undo"))
handled_at=now().isoformat(timespec="seconds")): 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.err("没有这条记录", 404)
return self.js({"ok": True, "id": cid}) return self.js({"ok": True, "id": cid})
+4
View File
@@ -318,6 +318,10 @@ class Store(object):
return default return default
now = time.time() now = time.time()
with self.tx() as c: 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(): for k, rec in (jl(os.path.join(R, "codes.json"), {}) or {}).items():
if isinstance(rec, dict): if isinstance(rec, dict):
c.execute("INSERT OR IGNORE INTO codes (code, state, order_id, batch, platform, gift, data, updated)" c.execute("INSERT OR IGNORE INTO codes (code, state, order_id, batch, platform, gift, data, updated)"
+10 -1
View File
@@ -14,7 +14,7 @@
7. 导出旧版 JSON → 再导入新库,数据一模一样(回退路径能用) 7. 导出旧版 JSON → 再导入新库,数据一模一样(回退路径能用)
8. 热备份能打开、行数一致;完整性检查 ok 8. 热备份能打开、行数一致;完整性检查 ok
9. 服务器直接在「迁移过来的老数据」上跑:老订单能查、老卡密能认、admin.py db / calls / ls 能用 9. 服务器直接在「迁移过来的老数据」上跑:老订单能查、老卡密能认、admin.py db / calls / ls 能用
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢 10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢;三个进程同时第一次启动只导一次
11. 规模:5000 张码 + 2000 单,按状态列订单的耗时 11. 规模:5000 张码 + 2000 单,按状态列订单的耗时
""" """
import json, os, random, shutil, sqlite3, subprocess, sys, tempfile, threading, time import json, os, random, shutil, sqlite3, subprocess, sys, tempfile, threading, time
@@ -255,6 +255,15 @@ for i in range(300):
ps = [subprocess.Popen([sys.executable, "-c", writer, x]) for x in ("A", "B")] ps = [subprocess.Popen([sys.executable, "-c", writer, x]) for x in ("A", "B")]
[p.wait(timeout=120) for p in ps] [p.wait(timeout=120) for p in ps]
check("并发:两个进程同时各写 300 张码,600 张一张不少", len(st5.codes_all()) == 600, "%d 张" % len(st5.codes_all())) 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. 规模 # ================================================================== 11. 规模
R6 = tempfile.mkdtemp(prefix="ys-db-scale-") R6 = tempfile.mkdtemp(prefix="ys-db-scale-")
+3 -3
View File
@@ -53,7 +53,7 @@
| `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG | | `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG |
| `store.py` | ~400 | **数据层**(2026-10-05 新增):SQLite 建库 / 第一次启动自动导入旧 JSON / 存取 / 导出回旧格式 / 体检 / 热备份 | | `store.py` | ~400 | **数据层**(2026-10-05 新增):SQLite 建库 / 第一次启动自动导入旧 JSON / 存取 / 导出回旧格式 / 体检 / 热备份 |
| `tests/回执复现测试.py` | ~280 | 回归 + 漏洞复现(27 条,HTTP 层打接口) | | `tests/回执复现测试.py` | ~280 | 回归 + 漏洞复现(27 条,HTTP 层打接口) |
| `tests/数据库测试.py` | ~290 | 数据库专项(37 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 | | `tests/数据库测试.py` | ~290 | 数据库专项(38 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
> 这几个文件是**自足**的:没有 import 本项目之外的模块。**部署时 `store.py` 必须和 `server.py` 放在同一个目录**(`server.py` 直接 `import store`)。 > 这几个文件是**自足**的:没有 import 本项目之外的模块。**部署时 `store.py` 必须和 `server.py` 放在同一个目录**(`server.py` 直接 `import store`)。
@@ -179,13 +179,13 @@
### 5.6 测试 ### 5.6 测试
``` ```
python3 tests/数据库测试.py <server.py 所在目录> # 37 条:数据库专项 python3 tests/数据库测试.py <server.py 所在目录> # 38 条:数据库专项
python3 tests/回执复现测试.py <server.py 所在目录> # 27 条:回归 + 漏洞复现(现在跑在数据库上) python3 tests/回执复现测试.py <server.py 所在目录> # 27 条:回归 + 漏洞复现(现在跑在数据库上)
``` ```
- 数据全是测试脚本**现编的**(假卡密、假订单、假呼叫,包括一行写坏的 `calls.jsonl`),建在系统临时目录,不碰 `<DATA_DIR>`。 - 数据全是测试脚本**现编的**(假卡密、假订单、假呼叫,包括一行写坏的 `calls.jsonl`),建在系统临时目录,不碰 `<DATA_DIR>`。
- 交付副本里三个 URL 格式串被脱敏弄坏了(`http<WIN-PATH>`),要起服务器的那几节跑之前先换成能格式化的占位;线上原版直接跑。 - 交付副本里三个 URL 格式串被脱敏弄坏了(`http<WIN-PATH>`),要起服务器的那几节跑之前先换成能格式化的占位;线上原版直接跑。
- 2026-10-05 结果:**64 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。 - 2026-10-05 结果:**65 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
### 5.7 文件 / 目录(库以外的) ### 5.7 文件 / 目录(库以外的)
+7 -1
View File
@@ -355,7 +355,7 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
接口路径、请求 / 响应字段:没动。 接口路径、请求 / 响应字段:没动。
数据格式:**动了**(存储从 JSON 文件换成 SQLite)。第一次启动自动导入、旧文件不动, 数据格式:**动了**(存储从 JSON 文件换成 SQLite)。第一次启动自动导入、旧文件不动,
`admin.py db export` 能原样导回旧格式。calls.jsonl 照旧追加(手机通知要读)。渲染机不用动。 `admin.py db export` 能原样导回旧格式。calls.jsonl 照旧追加(手机通知要读)。渲染机不用动。
你怎么验证的:tests/数据库测试.py 37 条(全新安装 / 迁移 / 重启不重导 / 只改变化的行 / 清理 / 回滚 / 你怎么验证的:tests/数据库测试.py 38 条(全新安装 / 迁移 / 重启不重导 / 多进程同时首启只导一次 / 只改变化的行 / 清理 / 回滚 /
导出再导入一致 / 热备份 / 服务器跑在迁移来的数据上 / 8 线程 + 2 进程并发 / 5000 码 2000 单规模); 导出再导入一致 / 热备份 / 服务器跑在迁移来的数据上 / 8 线程 + 2 进程并发 / 5000 码 2000 单规模);
tests/回执复现测试.py 27 条照旧全过(现在跑在库上) tests/回执复现测试.py 27 条照旧全过(现在跑在库上)
``` ```
@@ -376,3 +376,9 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
- 没在你们的真机器(1.6G 内存 + systemd MemoryMax)上跑过;库很小(几千行级别),按测试的内存占用不会有压力,但请部署后跑一次 `admin.py db check`。 - 没在你们的真机器(1.6G 内存 + systemd MemoryMax)上跑过;库很小(几千行级别),按测试的内存占用不会有压力,但请部署后跑一次 `admin.py db check`。
- `admin.py` 用别的账号跑时的目录权限(WAL 要在 `<DATA_DIR>` 里建两个小文件),见交接说明 5.1。 - `admin.py` 用别的账号跑时的目录权限(WAL 要在 `<DATA_DIR>` 里建两个小文件),见交接说明 5.1。
### 第二轮自查修掉的三处(推送前审查)
- `add_call`:渲染机回传(`finish_upload`)的「部分失败」也调它;写库出错原来会把异常抛到回传接口 → 改成只记日志、`calls.jsonl` 照写。
- `store.import_legacy`:服务器和 `admin.py` 同时第一次启动会各导一遍(呼叫记录翻倍)→ 在写事务里再判一次「导过没有」。测试加了一条(三个进程同时首启)。
- `admin_call_done`:撤销「处理过了」时 `handled_at` 没清 → 一起清掉。
+7 -7
View File
@@ -1,18 +1,18 @@
# 交付清单(自查用) # 交付清单(自查用)
> 生成:2026-10-05 16:31 共 36 个文件 合计 44.9 MB(2026-10-05 第二轮:加了数据库 store.py、两份测试、回执;后台面板和本机开单页面重写) > 生成:2026-10-05 17:30 共 36 个文件 合计 44.9 MB(2026-10-05 第二轮:数据库 store.py、两份测试、回执;后台面板和本机开单页面重写;推送前审查修复)
| 文件 | 字节 | SHA-256 | | 文件 | 字节 | SHA-256 |
|---|---|---| |---|---|---|
| `README.md` | 8,543 | `ea8e0339caf30b69754f1c6ff28027c9615c43072c596406bc791b5801285eb3` | | `README.md` | 8,696 | `5cef368dbf5916def012dbfcf7fdfb35d1f435faf5a7b42b65f6ad683343b1c2` |
| `backend-site/admin.py` | 26,020 | `d7f86dcf0b07962ceb55a7714b43c876628118d19159dc3a9215535db1bc47f7` | | `backend-site/admin.py` | 26,020 | `d7f86dcf0b07962ceb55a7714b43c876628118d19159dc3a9215535db1bc47f7` |
| `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` | | `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` |
| `backend-site/server.py` | 181,030 | `24f052fdab2fbc5eba345cc305810b33c05b44d01b7e749cd8804d28473f401e` | | `backend-site/server.py` | 181,352 | `438fcd98d57043ee503222b6decc83e873dda2d62c66a8d36f521c7d21e6afed` |
| `backend-site/store.py` | 18,948 | `283029b92e0bba8934c7075a4f3467784d7fde46104bd098eda23742f99a0158` | | `backend-site/store.py` | 19,303 | `9d22007b43188225d4254f8c9710c310d9d55635d0d67496ec99e91fe47bcd2d` |
| `backend-site/tests/回执复现测试.py` | 15,355 | `4529f6076abdfce89bf4406c7fbd0789482deaa595383749580bdc3e08ddc327` | | `backend-site/tests/回执复现测试.py` | 15,355 | `4529f6076abdfce89bf4406c7fbd0789482deaa595383749580bdc3e08ddc327` |
| `backend-site/tests/数据库测试.py` | 15,416 | `b9f420a353927da9e5c1bfaa9a130e5d50cae28dffd42712d9f9c42d2816f5f8` | | `backend-site/tests/数据库测试.py` | 16,045 | `9838f32bf213cd3c727625a50b5e0cbff7da98ded8b7452cacd187c448bde04f` |
| `backend-site/交接说明.md` | 21,795 | `80911c91d0623497c057de8374d41337ff75f4a937571b57486a7d2a319e9c70` | | `backend-site/交接说明.md` | 21,795 | `03b9cb73b27a265c32fc5a36120da0d6d61c2e1d612308cba0221818493cb3f0` |
| `backend-site/回执-Claude.md` | 37,110 | `2f7fc60f48e99e7f07affcac16fe3d0ce2e8660738fbf954b89f2c00e638262f` | | `backend-site/回执-Claude.md` | 37,690 | `de1648832fe8bcd004c32ed538d4a90c6c29a0d72b8c70f448fdbe5332d8b5d9` |
| `backend-tools/chk_worker.ps1` | 486 | `939a42cafa0954347f28d69e75b8af407ed1dab870cc3956fa8b7c5eb55e372f` | | `backend-tools/chk_worker.ps1` | 486 | `939a42cafa0954347f28d69e75b8af407ed1dab870cc3956fa8b7c5eb55e372f` |
| `backend-tools/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` | | `backend-tools/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` |
| `backend-tools/install_worker.ps1` | 8,902 | `95c339f2a69359fd1c980fb649217bb18371d9ba0b06eadce049b58537c11c1e` | | `backend-tools/install_worker.ps1` | 8,902 | `95c339f2a69359fd1c980fb649217bb18371d9ba0b06eadce049b58537c11c1e` |
+67
View File
@@ -0,0 +1,67 @@
/* =============================================================================
* 金钻宇宙 · 星系图配置(config.js)—— 日常改动只改这一个文件
* -----------------------------------------------------------------------------
* 1. UNIVERSES :世界线的「档案内容」(和门户页原来的 UNIVERSES 字段一模一样,可以直接拷过来)
* 2. LOOKS :每条世界线在星系图上「长什么样」(星球风格、颜色、卫星、光环、在哪条旋臂上)
* 3. GALAXY :整个星系的配色、旋臂、粒子数量、扇区名
* 加一条新世界线 = UNIVERSES 里加一条 + LOOKS 里按编号加一条外观(不写外观就用「空槽」的样子)。
* ============================================================================= */
window.JZ_UNIVERSE = {
// ---------------------------------------------------------------- 1. 档案内容
UNIVERSES: [
{ no: '0000', name: '零号宇宙', kind: '主宇宙', tag: '晶钻超算主宇宙', tags: ['门户主宇宙', '晶钻超算', '多世界线演算'],
desc: '门户主宇宙,也是晶钻超算本体:把平行宇宙压成盘符,逐条演算多世界线。其余编号都是它演算出的分支世界线,零号自身负责总调度与收束。' },
{ no: '0001', name: '火柴人宇宙', kind: '原创', tag: '火柴人的冒险', tags: ['金钻原创', '小时候的课堂', '火柴人的冒险'],
desc: '金钻小时候在课上天马行空画出来的世界线,《火柴人的冒险》就从这里开始。' },
{ no: '0002', name: '极寒世界', kind: '原创', tag: '冰河时期', tags: ['金钻原创', '冰河时期', '那迦彗星', '五大深垒', '2056'],
desc: '2030年代确认北大西洋环流(AMOC)减弱、气候转入长期寒冷;2040年高含水彗星「那迦」撞击北大西洋,水汽化为冰晶云遮蔽日照,冰河期开始。故事发生在2056年,冰河已持续16年,地表约-50℃(极端-90℃)。人类转入五大地下深垒。' },
{ no: '0003', name: '没落赛博城', kind: '二创', tag: '史蒂夫的探险之旅', tags: ['二创', '史蒂夫的探险之旅', '赛博废墟'],
desc: '金钻刚接触动画时随手做的二创世界线:史蒂夫穿过没落的赛博城,一路探险。' },
{ no: '0004', name: '善恶等级', kind: '原创', tag: '设定待定', tags: ['金钻原创', '设定酝酿中'],
desc: '这条世界线的设定还在酝酿中,先留好位置,等金钻想清楚再填。' },
{ no: '0005', empty: true }, { no: '0006', empty: true }, { no: '0007', empty: true },
{ no: '0008', empty: true }, { no: '0009', empty: true }, { no: '0010', empty: true },
],
// ---------------------------------------------------------------- 2. 外观(按编号对应)
// style:crystal 晶体 / paper 铅笔纸面 / ice 冰封 / neon 霓虹城 / duality 善恶两半 / gas 气态 / rock 岩石 / ghost 未点亮
// orbit:[离星系中心多远, 第几条旋臂];moons:绕着它转的卫星(纯装饰,没有档案)
// enter:点开这颗星时的运镜 —— push 推进 / zoom 放大(长焦再推)/ rise 升空俯冲 / warp 跃迁 / orbit 绕行;不写就按顺序轮流
LOOKS: {
'0000': { enter: 'zoom', style: 'crystal', r: 2.6, orbit: [0, 0], accent: '#FFD36E',
why: '晶钻超算:多面体切面像钻石,内部有发光的演算脉络。',
moons: [{ style: 'crystal', r: 0.45, d: 5.0, speed: 0.35, colors: ['#BFF4FF', '#8E7BFF', '#FFE59A', '#FFFFFF'] },
{ style: 'rock', r: 0.32, d: 6.6, speed: 0.22 }] },
'0001': { enter: 'push', style: 'paper', r: 1.25, orbit: [20, 0], accent: '#F6F1E4',
why: '小时候课上画出来的:米白纸面、铅笔等高线、暗面排线、几个红笔圈。',
moons: [{ style: 'paper', r: 0.36, d: 2.6, speed: 0.6, colors: ['#FFF8EC', '#2B2E45', '#E5544B', '#F2C14D'] }] },
'0002': { enter: 'rise', style: 'ice', r: 1.35, orbit: [29, 1], accent: '#9FE3FF',
why: '冰河期地球:纬向冰带、厚极冠、冰裂纹;旁边那颗小卫星是「那迦」彗星残骸。',
moons: [{ style: 'rock', r: 0.3, d: 2.7, speed: 0.5, colors: ['#CFE6FF', '#8FB4E0', '#5C79B8', '#FFFFFF'] }] },
'0003': { enter: 'warp', style: 'neon', r: 1.4, orbit: [38, 2], accent: '#C9A6FF',
why: '没落的赛博城:深紫地表、霓虹街区网格、零星还亮着的窗灯。',
moons: [{ style: 'rock', r: 0.28, d: 3.0, speed: 0.42, colors: ['#3A2F66', '#2A2350', '#1A1535', '#FF5FD2'] },
{ style: 'neon', r: 0.22, d: 3.8, speed: 0.3 }] },
'0004': { enter: 'orbit', style: 'duality', r: 1.3, orbit: [46, 3], accent: '#FFD36E',
why: '设定还在酝酿,先按名字「善恶」做成两半:一半金色白昼,一半紫色夜空,交界一条发光的波浪线。设定定了再换。',
moons: [{ style: 'gas', r: 0.34, d: 2.8, speed: 0.45, colors: ['#FFF0C8', '#F2B84B', '#2D1E57', '#FFFFFF'] }] },
},
EMPTY_LOOK: { style: 'ghost', r: 0.75, accent: '#8E96C8' }, // 空槽的样子(未点亮的星系)
// ---------------------------------------------------------------- 3. 星系整体
GALAXY: {
radius: 60, arms: 4, twist: 0.11,
particles: { desktop: 42000, mobile: 36000 }, // 手机和桌面画面要一致:数量只略少一点
nebulae: { desktop: 32, mobile: 28 },
decorPlanets: { desktop: 14, mobile: 14 }, // 散落在旋臂上的无名星球(只是好看,不能点)
// 配色:深海军蓝底 + 蓝紫星云 + 一点青色 + 暖金色核心。整张图只用这几种颜色。
colors: {
bg: '#070B1C', core: '#FFE2B0', armInner: '#9DB4FF', armOuter: '#7C6BFF', accentStar: '#6FE3D6',
nebula: [['#2F4BD8', '#4FB8E8'], ['#4A35B8', '#7C6BFF'], ['#1C7A8C', '#4FD1C5'], ['#5B3FB8', '#9B8BFF']],
coreNebula: ['#FFC97A', '#B98CFF'], line: '#7F8BC8', ui: '#FFD36E',
},
intro: 'random', // 开场运镜:sweep 盘旋落下 / dive 垂直坠入 / random 每次随机
sectors: ['S-01 · 晨线', 'S-02 · 冰原', 'S-03 · 霓虹', 'S-04 · 衡天', 'S-05 · 未测绘', 'S-06 · 未测绘'],
},
};
+310
View File
@@ -0,0 +1,310 @@
/* =============================================================================
* 金钻宇宙 · 星系图引擎(galaxy.js)
* -----------------------------------------------------------------------------
* 读 window.JZ_UNIVERSE(config.js)→ 画旋臂星系、星云、扇区、补给线、星系(卡通星球 + 卫星)、
* 散落的无名星球;处理拖动 / 滚轮 / 双指缩放 / 点星系飞过去 / 档案卡。
* 只依赖 three.js 和 planets.js。挂载:mountGalaxy({ stage, canvas, labels, panel, ... })
* 嵌进普通页面时可选:
* onFocus(u|null) 选中 / 取消选中某条世界线时回调(页面下方的列表可以跟着高亮)
* layout() 返回 { x, y }:选中时星球往左 / 往上挪多少(屏宽 / 屏高的比例),给档案卡让位
* wheelZoom() 返回 true 时滚轮直接缩放;false 时只有按住 Ctrl 才缩放(嵌在页面里别抢页面滚动)
* 返回 { fly(no), home(), resize() }。画面滚出视口时自动暂停渲染。
* ============================================================================= */
import * as THREE from 'three';
import { makePlanet } from './planets.js?v=1';
export function mountGalaxy(el) {
const CFG = window.JZ_UNIVERSE, G = CFG.GALAXY, C = G.colors;
const { stage, canvas, labels, panel, back, hud } = el;
const reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
const isMob = () => stage.clientWidth < 760;
const MOB = isMob();
const renderer = new THREE.WebGLRenderer({ canvas, antialias: true, powerPreference: 'high-performance' });
renderer.setPixelRatio(Math.min(devicePixelRatio, MOB ? 1.5 : 2));
renderer.outputColorSpace = THREE.SRGBColorSpace;
renderer.setClearColor(C.bg, 1);
const scene = new THREE.Scene(), camera = new THREE.PerspectiveCamera(42, 1, 0.1, 2000);
const R = G.radius, ARMS = G.arms;
const rnd = (a = 0, b = 1) => a + Math.random() * (b - a);
const gauss = () => { let u = 0, v = 0; while (!u) u = Math.random(); while (!v) v = Math.random(); return Math.sqrt(-2 * Math.log(u)) * Math.cos(2 * Math.PI * v); };
const armAngle = (r, arm) => arm * Math.PI * 2 / ARMS + r * G.twist;
const LIGHT = new THREE.Vector3(-1, 0.55, 0.6).normalize();
// ============================================================ 旋臂星系(粒子)—— 星点大小有上限,离镜头很近的也不会糊成大光斑
const galaxy = (() => {
const N = MOB ? G.particles.mobile : G.particles.desktop, pos = new Float32Array(N * 3), col = new Float32Array(N * 3), sz = new Float32Array(N);
const cCore = new THREE.Color(C.core), cIn = new THREE.Color(C.armInner), cOut = new THREE.Color(C.armOuter), cAcc = new THREE.Color(C.accentStar), c = new THREE.Color();
for (let i = 0; i < N; i++) {
const r = Math.pow(Math.random(), 0.55) * R, arm = i % ARMS, spread = (0.6 + r * 0.09) * gauss();
const a = armAngle(r, arm) + spread / Math.max(r, 3) + (Math.random() < 0.22 ? rnd(-Math.PI, Math.PI) : 0);
pos.set([Math.cos(a) * r + gauss() * 0.8, gauss() * (2.2 * Math.exp(-r / 18) + 0.35), Math.sin(a) * r + gauss() * 0.8], i * 3);
const t = r / R; c.copy(cCore).lerp(cIn, Math.min(1, t * 2.4)).lerp(cOut, Math.max(0, t * 1.5 - 0.5));
if (Math.random() < 0.04) c.copy(cAcc);
col.set([c.r, c.g, c.b], i * 3); sz[i] = Math.random() < 0.012 ? rnd(3, 5.5) : rnd(0.6, 2.0);
}
const g = new THREE.BufferGeometry();
g.setAttribute('position', new THREE.BufferAttribute(pos, 3)); g.setAttribute('color', new THREE.BufferAttribute(col, 3)); g.setAttribute('size', new THREE.BufferAttribute(sz, 1));
const m = new THREE.ShaderMaterial({ transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, vertexColors: true,
uniforms: { uPx: { value: renderer.getPixelRatio() }, uDim: { value: 1 }, uK: { value: 1 } },
vertexShader: `attribute float size; varying vec3 vC; uniform float uPx; uniform float uK;
void main(){ vC = color; vec4 mv = modelViewMatrix*vec4(position,1.0); gl_PointSize = clamp(size*uPx*uK*(150.0/-mv.z), 1.1, 7.0*uPx); gl_Position = projectionMatrix*mv; }`,
fragmentShader: `varying vec3 vC; uniform float uDim; void main(){ vec2 p = gl_PointCoord-0.5; float d = length(p); if(d>0.5) discard;
float a = smoothstep(0.5,0.0,d); gl_FragColor = vec4(vC*(0.55+a*1.1), a*0.85*uDim); }` });
const pts = new THREE.Points(g, m); scene.add(pts); return pts;
})();
// ============================================================ 星云(噪声云,沿旋臂;颜色只取 config 里那几组)
const nebulaMat = (c1, c2, seed, alpha) => new THREE.ShaderMaterial({ transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide,
uniforms: { uT: { value: 0 }, uA: { value: new THREE.Color(c1) }, uB: { value: new THREE.Color(c2) }, uS: { value: seed }, uO: { value: alpha }, uDim: { value: 1 } },
vertexShader: `varying vec2 vU; void main(){ vU = uv; gl_Position = projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
fragmentShader: `uniform float uT; uniform vec3 uA; uniform vec3 uB; uniform float uS; uniform float uO; uniform float uDim; varying vec2 vU;
float h(vec2 p){ return fract(sin(dot(p,vec2(127.1,311.7))+uS)*43758.5453); }
float n(vec2 p){ vec2 i=floor(p), f=fract(p); f=f*f*(3.0-2.0*f); return mix(mix(h(i),h(i+vec2(1,0)),f.x),mix(h(i+vec2(0,1)),h(i+vec2(1,1)),f.x),f.y); }
float fbm(vec2 p){ float v=0.0, a=0.5; for(int i=0;i<6;i++){ v+=a*n(p); p=p*2.03+vec2(1.7,9.2); a*=0.5; } return v; }
void main(){ vec2 p = vU-0.5; float r = length(p)*2.0; if(r>1.0) discard;
vec2 q = vU*3.0 + uS; float w = fbm(q + vec2(uT*0.02, -uT*0.015)); float d = fbm(q*1.7 + w*2.4 + vec2(-uT*0.01, uT*0.02));
float shape = smoothstep(1.0, 0.15, r) * smoothstep(0.32, 0.85, d); float dust = smoothstep(0.55, 0.75, fbm(q*3.1 - w));
gl_FragColor = vec4(mix(uA, uB, smoothstep(0.3, 0.9, d)) * (0.6 + d), shape * (1.0 - dust*0.6) * uO * uDim); }` });
const nebulae = [];
{ const n = MOB ? G.nebulae.mobile : G.nebulae.desktop;
for (let i = 0; i < n; i++) {
const r = rnd(8, R * 0.95), a = armAngle(r, i % ARMS) + rnd(-0.35, 0.35), pal = C.nebula[i % C.nebula.length], s = rnd(14, 34) * (1.1 - r / R * 0.4);
const m = new THREE.Mesh(new THREE.PlaneGeometry(s, s), nebulaMat(pal[0], pal[1], rnd(0, 100), rnd(0.32, 0.55)));
m.position.set(Math.cos(a) * r, rnd(-1.5, 1.5), Math.sin(a) * r); m.rotation.set(-Math.PI / 2 + rnd(-0.25, 0.25), 0, rnd(0, Math.PI)); scene.add(m); nebulae.push(m);
}
const core = new THREE.Mesh(new THREE.PlaneGeometry(34, 34), nebulaMat(C.coreNebula[0], C.coreNebula[1], 7, 0.5)); core.rotation.x = -Math.PI / 2; scene.add(core); nebulae.push(core); }
const glow = (color, size, op = 1) => { const c = document.createElement('canvas'); c.width = c.height = 128; const x = c.getContext('2d');
const g = x.createRadialGradient(64, 64, 0, 64, 64, 64); g.addColorStop(0, 'rgba(255,255,255,1)'); g.addColorStop(0.22, color); g.addColorStop(1, 'rgba(0,0,0,0)'); x.fillStyle = g; x.fillRect(0, 0, 128, 128);
const s = new THREE.Sprite(new THREE.SpriteMaterial({ map: new THREE.CanvasTexture(c), blending: THREE.AdditiveBlending, depthWrite: false, transparent: true, opacity: op })); s.scale.setScalar(size); return s; };
scene.add(glow('rgba(255,215,150,.28)', 15, 0.7)); // 核心的柔光(收着点,之前太曝)
{ const N = MOB ? 1100 : 2400, p = new Float32Array(N * 3); // 远处整球背景星
for (let i = 0; i < N; i++) { const u = rnd(-1, 1), t = rnd(0, Math.PI * 2), s = Math.sqrt(1 - u * u), r = rnd(500, 900); p.set([Math.cos(t) * s * r, u * r, Math.sin(t) * s * r], i * 3); }
const g = new THREE.BufferGeometry(); g.setAttribute('position', new THREE.BufferAttribute(p, 3));
scene.add(new THREE.Points(g, new THREE.PointsMaterial({ color: 0xC9D3FF, size: 1.2, sizeAttenuation: false, transparent: true, opacity: 0.6 }))); }
// ============================================================ 扇区:同心环 + 分隔虚线 + 扇区名
const lineCol = new THREE.Color(C.line), guides = [];
const addLine = (pts, dashed, op) => { const g = new THREE.BufferGeometry().setFromPoints(pts);
const m = dashed ? new THREE.LineDashedMaterial({ color: lineCol, dashSize: 1.2, gapSize: 1.4, transparent: true, opacity: op, depthWrite: false })
: new THREE.LineBasicMaterial({ color: lineCol, transparent: true, opacity: op, depthWrite: false });
const l = new THREE.Line(g, m); if (dashed) l.computeLineDistances(); l.userData.op = op; scene.add(l); guides.push(l); return l; };
for (const [rr, op] of [[16, 0.16], [32, 0.11], [48, 0.09], [R + 4, 0.16]]) { const pts = []; for (let k = 0; k <= 256; k++) { const a = k / 256 * Math.PI * 2; pts.push(new THREE.Vector3(Math.cos(a) * rr, 0, Math.sin(a) * rr)); } addLine(pts, false, op); }
for (let k = 0; k < 6; k++) { const a = k / 6 * Math.PI * 2 + 0.3; addLine([new THREE.Vector3(Math.cos(a) * 16, 0, Math.sin(a) * 16), new THREE.Vector3(Math.cos(a) * (R + 4), 0, Math.sin(a) * (R + 4))], true, 0.12); }
const sectorTags = G.sectors.map((name, k) => { const d = document.createElement('div'); d.className = 'sector'; d.textContent = name; labels.appendChild(d);
const a = (k + 0.5) / 6 * Math.PI * 2 + 0.3; return { el: d, p: new THREE.Vector3(Math.cos(a) * (R + 9), 0, Math.sin(a) * (R + 9)) }; });
// ============================================================ 星系(每条世界线一颗卡通星球 + 卫星)
const systems = [], planets = [];
const lit = CFG.UNIVERSES.filter(u => !u.empty), empty = CFG.UNIVERSES.filter(u => u.empty);
CFG.UNIVERSES.forEach((u, i) => {
const ei = empty.indexOf(u);
const L = Object.assign({}, CFG.EMPTY_LOOK, CFG.LOOKS[u.no] || {});
if (!CFG.LOOKS[u.no]) L.orbit = [R * (0.8 + 0.12 * (ei % 2)), ei % ARMS]; // 空槽放在外圈,按顺序分到各条旋臂
const [r, arm] = L.orbit || [R * 0.85, i % ARMS];
const a = r ? armAngle(r, arm) + (u.empty ? 0.32 * Math.floor(ei / ARMS) : 0) : 0;
const g = new THREE.Group(); g.position.set(Math.cos(a) * r, 0, Math.sin(a) * r); scene.add(g);
const p = makePlanet(THREE, Object.assign({ seed: i * 7.3 + 1 }, L)); g.add(p.group); planets.push(p);
const moons = (L.moons || []).map((m, k) => { const piv = new THREE.Group(); piv.rotation.x = 0.35 - k * 0.2; piv.rotation.y = k * 2.1; g.add(piv);
const mp = makePlanet(THREE, Object.assign({ seed: i * 13 + k * 3.1, spin: 0.4 }, m)); mp.group.position.x = m.d; piv.add(mp.group); planets.push(mp); return { piv, speed: Math.abs(m.speed || 0.3) }; }); // 卫星一律同一个方向转(和星系自转同向)
const tag = document.createElement('button'); tag.type = 'button'; tag.className = 'tag' + (u.empty ? ' empty' : ''); tag.style.setProperty('--c', L.accent || C.ui);
tag.innerHTML = '<span class="t"><b>' + (u.empty ? '空槽' : u.name) + '</b><em>' + u.no + (u.empty ? ' · 未点亮' : ' · ' + u.kind) + '</em></span>';
labels.appendChild(tag);
const s = { u, L, g, planet: p, moons, tag }; p.body.userData.s = s; systems.push(s);
tag.addEventListener('click', () => fly(s));
});
// 补给线:核心 → 每个星系,虚线往外流
const supply = [];
for (const s of systems) { if (s.u.no === '0000') continue;
const b = s.g.position.clone(), mid = b.clone().multiplyScalar(0.5); mid.y += b.length() * 0.12;
const l = new THREE.Line(new THREE.BufferGeometry().setFromPoints(new THREE.QuadraticBezierCurve3(new THREE.Vector3(), mid, b).getPoints(80)),
new THREE.LineDashedMaterial({ color: s.u.empty ? lineCol : new THREE.Color(C.ui), dashSize: 0.9, gapSize: 0.8, transparent: true, opacity: s.u.empty ? 0.14 : 0.42, depthWrite: false }));
l.computeLineDistances(); l.userData.op = l.material.opacity; scene.add(l); supply.push(l); }
// 散落的无名星球(只是让星系看起来有人住;不进档案、不能点)
// 位置挑过:离核心、离每个星系(含它的卫星轨道)、彼此之间都留足距离,不会叠在一起
{ const n = MOB ? G.decorPlanets.mobile : G.decorPlanets.desktop, styles = ['gas', 'rock', 'gas', 'rock', 'ice'];
const pals = [['#F2D7A6', '#D99A6C', '#8E6BBF', '#FFF2D6'], ['#BFD0FF', '#7C8FD6', '#4A5BA8', '#FFFFFF'], ['#9FE3D6', '#4FB8A8', '#2F6F8C', '#E6FFF8'], ['#D6C2FF', '#9B8BFF', '#5B3FB8', '#FFFFFF']];
const taken = systems.map(s => ({ p: s.g.position, r: s.L.r * 3 + Math.max(0, ...(s.L.moons || []).map(m => m.d + m.r)) + 3 }));
taken.push({ p: new THREE.Vector3(), r: 14 });
let made = 0;
for (let tries = 0; made < n && tries < n * 60; tries++) {
const r = rnd(16, R * 0.96), a = armAngle(r, Math.floor(rnd(0, ARMS))) + rnd(-0.45, 0.45), size = rnd(0.35, 0.8);
const pos = new THREE.Vector3(Math.cos(a) * r, rnd(-0.8, 0.8), Math.sin(a) * r);
if (taken.some(o => o.p.distanceTo(pos) < o.r + size + 2.5)) continue;
const p = makePlanet(THREE, { style: styles[made % styles.length], r: size, colors: pals[made % pals.length], seed: made * 5.1, outline: '#141833', spin: rnd(0.05, 0.2) });
p.group.position.copy(pos); scene.add(p.group); planets.push(p); taken.push({ p: pos, r: size + 2 }); made++;
} }
el.counts && el.counts(CFG.UNIVERSES.length, lit.length, empty.length);
// ============================================================ 相机 + 交互(拖动、滚轮、双指缩放)
const HOME = () => ({ az: 0.7, el: isMob() ? 1.08 : 0.62, dist: isMob() ? 155 : 112 });
// ============================================================ 运镜库(全部按时间走,和帧率无关)
// 每个运镜 = 时长 + 一条路径函数 path(from, to, k):k 是 0→1 的进度,往 view 里写这一刻的相机状态。
// 相机状态:az 方位角 / el 仰角 / dist 距离 / tx,ty,tz 看向哪 / fov 视角 / roll 滚转。
// 加一种新运镜:往 MOVES 里加一项,然后在 config.js 的 LOOKS[编号].enter 里写它的名字。
const FOV = 42;
const lerp = (a, b, k) => a + (b - a) * k, clamp01 = k => Math.max(0, Math.min(1, k));
const E = {
io: k => k < 0.5 ? 4 * k * k * k : 1 - Math.pow(-2 * k + 2, 3) / 2, // 缓入缓出
out: k => 1 - Math.pow(1 - k, 3), // 先快后慢
in: k => k * k * k,
io5: k => k < 0.5 ? 16 * k ** 5 : 1 - Math.pow(-2 * k + 2, 5) / 2, // 更「沉」的缓入缓出
expo: k => k === 0 ? 0 : k === 1 ? 1 : k < 0.5 ? Math.pow(2, 20 * k - 10) / 2 : (2 - Math.pow(2, -20 * k + 10)) / 2,
};
const KEYS = ['az', 'el', 'dist', 'tx', 'ty', 'tz', 'fov', 'roll'];
const mix = (f, to, k, keys = KEYS) => { for (const key of keys) view[key] = lerp(f[key], to[key], k); };
const MOVES = {
// 绕行:边飞边绕过去,中途抬高拉远一点(原来那种)
orbit: { dur: 1700, path(f, to, k) { const e = E.io(k); mix(f, to, e); view.el += Math.sin(Math.PI * e) * 0.28; view.dist *= 1 + Math.sin(Math.PI * e) * 0.22; } },
// 推进:镜头先转过去对准(前 40%),再笔直推进去(不绕圈)
push: { dur: 1600, path(f, to, k) { const look = E.out(clamp01(k / 0.45)), go = E.io5(k);
mix(f, to, look, ['tx', 'ty', 'tz', 'az', 'el']); mix(f, to, go, ['dist']); view.fov = FOV; view.roll = 0; } },
// 放大:先用「长焦」把它拉近(视角收窄),再一边推进一边把视角放回来 —— 有点希区柯克变焦的味道
zoom: { dur: 2000, path(f, to, k) { const k1 = clamp01(k / 0.45), k2 = clamp01((k - 0.45) / 0.55);
mix(f, to, E.out(clamp01(k / 0.35)), ['tx', 'ty', 'tz']); mix(f, to, E.io(k), ['az', 'el']);
view.fov = k < 0.45 ? lerp(f.fov, 14, E.out(k1)) : lerp(14, to.fov, E.io(k2));
view.dist = lerp(f.dist, to.dist, E.io(k2)); view.roll = 0; } },
// 升空俯冲:先拉高到几乎俯视,再从上面扎下去
rise: { dur: 2100, path(f, to, k) { const e = E.io(k); mix(f, to, e);
const up = Math.sin(Math.PI * clamp01(k * 1.15)); view.el = lerp(view.el, 1.35, up * 0.85); view.dist *= 1 + up * 0.55; } },
// 跃迁:慢起步、中段猛冲、末段刹住;冲的时候视角张开、镜头轻轻一滚
warp: { dur: 1800, path(f, to, k) { const e = E.expo(k), s = Math.sin(Math.PI * k);
mix(f, to, e); view.fov = to.fov + s * s * 34; view.roll = s * 0.18 * (f.az > to.az ? 1 : -1); } },
// 拉远:回星系图用 —— 先往后退,再抬头看全景
pull: { dur: 1700, path(f, to, k) { mix(f, to, E.io5(k), ['dist']); mix(f, to, E.out(clamp01((k - 0.15) / 0.85)), ['tx', 'ty', 'tz', 'el', 'az']);
view.fov = lerp(f.fov, to.fov, E.io(k)); view.roll = lerp(f.roll, 0, E.io(k)); } },
// 开场 A · 盘旋落下:从高空、更远处绕半圈落到正常视角
introSweep: { dur: 3600, path(f, to, k) { mix(f, to, E.io(k)); } },
// 开场 B · 垂直坠入:从正上方很远的地方直着往下落,最后才抬起镜头、星系转正
introDive: { dur: 3400, path(f, to, k) { const d = E.io5(k); view.dist = lerp(f.dist, to.dist, d); view.el = lerp(f.el, to.el, E.in(clamp01((k - 0.35) / 0.65)));
view.az = lerp(f.az, to.az, E.io(k)); view.fov = lerp(f.fov, to.fov, E.out(k)); view.tx = view.ty = view.tz = 0; view.roll = 0; } },
};
const h0 = HOME();
const introKind = (G.intro === 'dive' || G.intro === 'sweep') ? G.intro : (Math.random() < 0.5 ? 'dive' : 'sweep');
const START = introKind === 'dive' ? { az: h0.az + 0.6, el: 1.52, dist: h0.dist * 3.2, fov: 30 } : { az: h0.az - 1.5, el: 1.42, dist: h0.dist * 2.4, fov: FOV };
const view = Object.assign({ tx: 0, ty: 0, tz: 0, roll: 0, fov: FOV }, reduce ? h0 : START);
const want = Object.assign({ fov: FOV, roll: 0 }, h0);
let anim = null, intro = !reduce;
// 用户中途拖动 / 缩放:运镜立刻停在原地交还控制权,但没出来的档案卡要马上补上(不然卡就丢了)
function cancelAnim() { if (!anim) return; const f = anim.onArrive; anim = null; f && f(); }
// to 里没写的 fov / roll 默认回到正常;az 走最近的那一边转
function animate(to, move = 'orbit', onArrive = null, arriveAt = 0.8) {
to = Object.assign({ fov: FOV, roll: 0 }, to);
if (reduce) { Object.assign(view, to); Object.assign(want, to); anim = null; onArrive && onArrive(); return; }
const daz = ((to.az - view.az) % (Math.PI * 2) + Math.PI * 3) % (Math.PI * 2) - Math.PI;
const M = MOVES[move] || MOVES.orbit;
anim = { t0: performance.now(), M, from: Object.assign({}, view), to: Object.assign({}, to, { az: view.az + daz }), onArrive, arriveAt };
}
let focus = null, hover = null;
function fit() { const w = stage.clientWidth, h = stage.clientHeight; renderer.setSize(w, h, false); camera.aspect = w / h; camera.updateProjectionMatrix(); }
addEventListener('resize', fit); fit();
const ptrs = new Map(); let drag = null, pinch = null;
canvas.addEventListener('pointerdown', e => { canvas.setPointerCapture(e.pointerId); ptrs.set(e.pointerId, { x: e.clientX, y: e.clientY });
if (ptrs.size === 2) { const [a, b] = [...ptrs.values()]; pinch = { d: Math.hypot(a.x - b.x, a.y - b.y), dist: want.dist }; drag = null; }
else drag = { x: e.clientX, y: e.clientY, az: want.az, el: want.el, moved: false }; });
canvas.addEventListener('pointermove', e => {
if (ptrs.has(e.pointerId)) ptrs.set(e.pointerId, { x: e.clientX, y: e.clientY });
if (pinch && ptrs.size === 2) { const [a, b] = [...ptrs.values()]; zoomTo(pinch.dist * pinch.d / Math.max(20, Math.hypot(a.x - b.x, a.y - b.y))); return; }
if (drag) { const dx = e.clientX - drag.x, dy = e.clientY - drag.y; if (Math.abs(dx) + Math.abs(dy) > 6) drag.moved = true;
if (drag.moved) { if (anim) { cancelAnim(); Object.assign(want, view); drag.az = view.az + dx * 0.005; drag.el = view.el - dy * 0.004; } /* 从镜头现在的位置接着拖,不跳 */ want.az = drag.az - dx * 0.005; want.el = THREE.MathUtils.clamp(drag.el + dy * 0.004, 0.08, 1.45); } return; }
if (e.pointerType === 'mouse') { hover = pick(e); canvas.style.cursor = hover ? 'pointer' : 'grab'; } });
const end = e => { ptrs.delete(e.pointerId); if (ptrs.size < 2) pinch = null;
const d = drag; drag = null; if (d && !d.moved && e.type === 'pointerup') { const s = pick(e); if (s) fly(s); else if (focus) home(); } };
canvas.addEventListener('pointerup', end); canvas.addEventListener('pointercancel', end);
const zoomTo = d => { if (anim) { cancelAnim(); Object.assign(want, view); } want.dist = THREE.MathUtils.clamp(d, focus ? focus.L.r * 2.6 : 32, focus ? focus.L.r * 16 : 230); };
canvas.addEventListener('wheel', e => {
if (el.wheelZoom && !el.wheelZoom() && !e.ctrlKey) return; // 嵌在页面里:普通滚轮留给页面滚动
e.preventDefault(); zoomTo(want.dist * (1 + Math.sign(e.deltaY) * 0.1)); }, { passive: false });
addEventListener('keydown', e => { if (e.key === 'Escape') home(); if (focus && e.key === 'ArrowRight') step(1); if (focus && e.key === 'ArrowLeft') step(-1); });
back && (back.onclick = () => home());
const ray = new THREE.Raycaster(), ptr = new THREE.Vector2(), tmp = new THREE.Vector3();
function pick(e) {
const r = canvas.getBoundingClientRect(); ptr.set((e.clientX - r.left) / r.width * 2 - 1, -(e.clientY - r.top) / r.height * 2 + 1);
ray.setFromCamera(ptr, camera); const hit = ray.intersectObjects(systems.map(s => s.planet.body), false)[0]; if (hit) return hit.object.userData.s;
let best = null, bd = isMob() ? 34 : 28;
for (const s of systems) { s.g.getWorldPosition(tmp).project(camera); const d = Math.hypot((tmp.x - ptr.x) * r.width / 2, (tmp.y - ptr.y) * r.height / 2); if (d < bd && tmp.z < 1) { bd = d; best = s; } }
return best;
}
const esc = x => String(x || '').replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
function card(s) { const u = s.u, nav = '<div class="nav"><button class="btn" type="button" data-s="-1">上一个</button><button class="btn" type="button" data-s="1">下一个</button></div>';
if (u.empty) return '<div class="card" style="--pc:' + (s.L.accent) + '"><div class="k">UNIVERSE ' + u.no + ' · 未点亮</div><h2>空槽</h2><div class="tg">这条世界线还没写出来,星系还没被点亮。</div><div class="acts">' + nav + '<button class="btn" type="button" data-home>回到星系图</button></div></div>';
return '<div class="card" style="--pc:' + s.L.accent + '"><div class="k">UNIVERSE ' + u.no + ' · ' + esc(u.kind) + ' · 已点亮</div><h2>' + esc(u.name) + '</h2><div class="tg">' + esc(u.tag) + '</div>' +
'<p class="ds">' + esc(u.desc) + '</p><div class="tags">' + (u.tags || []).map(t => '<span>' + esc(t) + '</span>').join('') + '</div><div class="acts">' + nav + '<button class="btn pri" type="button" data-home>回到星系图</button></div></div>'; }
panel && panel.addEventListener('click', e => { const b = e.target.closest('[data-s]'); if (b) step(+b.dataset.s); if (e.target.closest('[data-home]')) home(); });
function step(d) { const i = systems.indexOf(focus); fly(systems[(i + d + systems.length) % systems.length]); }
// 飞过去:先把旧档案卡收起来 → 镜头按这颗星的「入场运镜」飞 → 快到(80%)的时候档案卡才滑出来,和星球落定同步
const ENTER_CYCLE = ['push', 'zoom', 'rise', 'warp', 'orbit'];
function fly(s) { const was = focus; focus = s; intro = false; stage.classList.add('ready'); stage.classList.add('focus');
panel && panel.classList.remove('on'); el.onFocus && el.onFocus(s.u, 'start');
const p = s.g.position, dist = s.L.r * (isMob() ? 9 : 5.6) + (s.moons.length ? s.L.r * 1.5 : 0);
const i = systems.indexOf(s), move = s.L.enter || ENTER_CYCLE[i % ENTER_CYCLE.length];
// 推进 / 放大:沿着现在的视线方向过去(不绕);其它运镜:落到「从星系中心那一侧看过去」的角度,背景是星系盘
const az = (move === 'push' || move === 'zoom') ? view.az + 0.12 : Math.atan2(p.x, p.z) + 0.35;
animate({ az, el: 0.24, dist, tx: p.x, ty: p.y, tz: p.z }, was && was !== s && move !== 'warp' ? 'orbit' : move, () => {
if (focus !== s) return;
panel && (panel.innerHTML = card(s), panel.classList.add('on')); el.onFocus && el.onFocus(s.u, 'arrive'); }, 0.78); }
function home() { if (!focus) return; focus = null; panel && panel.classList.remove('on'); stage.classList.remove('focus'); el.onFocus && el.onFocus(null, 'start');
animate(Object.assign(HOME(), { tx: 0, ty: 0, tz: 0, az: view.az - 0.3 }), 'pull'); }
// ============================================================ 循环
const clock = new THREE.Clock(), tgt = new THREE.Vector3();
let hudBottom = 0; const measureHud = () => { hudBottom = hud ? hud.getBoundingClientRect().bottom - stage.getBoundingClientRect().top : 0; }; measureHud(); addEventListener('resize', measureHud);
let visible = true, started = false, tIntro = 0;
if ('IntersectionObserver' in window) new IntersectionObserver(es => { visible = es[0].isIntersecting; }, { threshold: 0.05 }).observe(stage);
function loop() {
requestAnimationFrame(loop);
if (!visible) { clock.getDelta(); return; } // 滚出视口:不渲染,省电
if (!started) { started = true; tIntro = clock.elapsedTime; if (intro) animate(Object.assign({}, h0, { tx: 0, ty: 0, tz: 0 }), introKind === 'dive' ? 'introDive' : 'introSweep'); else stage.classList.add('ready'); }
const dt = Math.min(clock.getDelta(), 0.05), t = clock.elapsedTime, mob = isMob();
if (!reduce) { galaxy.rotation.y += dt * 0.004; for (const n of nebulae) n.material.uniforms.uT.value = t; }
for (const l of supply) l.material.dashOffset -= dt * 2;
for (const p of planets) p.update(reduce ? 0 : dt, t, LIGHT);
// 星系在总览里放大一点(不然在手机上只是一个小点),飞近时恢复真实大小
const sysK = focus ? 1 : (mob ? 1.9 : 1.35);
for (const s of systems) { for (const m of s.moons) m.piv.rotation.y += (reduce ? 0 : dt) * m.speed;
const sc = s.g.scale.x + (sysK - s.g.scale.x) * (reduce ? 1 : Math.min(1, dt * 3)); s.g.scale.setScalar(sc); }
// 开场:星系从暗处亮起来(0 → 1,大约 2.4 秒);飞近一颗星时:星云、粒子、扇区线退后一点,别抢主角
const introK = intro ? Math.min(1, (t - tIntro) / 2.4) : 1;
const dimT = (focus ? 0.45 : 1) * introK;
galaxy.material.uniforms.uDim.value += (dimT - galaxy.material.uniforms.uDim.value) * (intro ? 1 : Math.min(1, dt * 3));
galaxy.material.uniforms.uK.value = 112 / HOME().dist;
for (const n of nebulae) n.material.uniforms.uDim.value = galaxy.material.uniforms.uDim.value;
for (const l of guides.concat(supply)) l.material.opacity += (l.userData.op * (focus ? 0.25 : 1) * introK - l.material.opacity) * Math.min(1, dt * 3);
// 相机:有补间就按时间走补间(不受帧率影响,一条连贯的弧线);没有就柔和地跟着拖动 / 缩放
if (anim) {
const a = anim, kk = Math.min(1, (performance.now() - a.t0) / a.M.dur);
a.M.path(a.from, a.to, kk);
if (a.onArrive && kk >= a.arriveAt) { const f = a.onArrive; a.onArrive = null; f(); } // 档案卡和星球落定同步出现
if (kk >= 1) { Object.assign(view, a.to); Object.assign(want, a.to); if (anim === a) anim = null; if (!focus) stage.classList.add('ready'); }
} else {
view.fov += (FOV - view.fov) * Math.min(1, dt * 4); view.roll += (0 - view.roll) * Math.min(1, dt * 4);
if (focus) focus.g.getWorldPosition(tgt); else tgt.set(0, 0, 0);
const k = 1 - Math.exp(-dt * 6);
view.tx += (tgt.x - view.tx) * k; view.ty += (tgt.y - view.ty) * k; view.tz += (tgt.z - view.tz) * k;
for (const key of ['az', 'el', 'dist']) view[key] += (want[key] - view[key]) * k;
if (!drag && !pinch && !focus && !reduce) want.az += dt * 0.02;
}
camera.position.set(view.tx + Math.sin(view.az) * Math.cos(view.el) * view.dist, view.ty + Math.sin(view.el) * view.dist, view.tz + Math.cos(view.az) * Math.cos(view.el) * view.dist);
camera.lookAt(view.tx, view.ty, view.tz);
if (view.roll) camera.rotateZ(view.roll);
if (Math.abs(camera.fov - view.fov) > 0.01) { camera.fov = view.fov; camera.updateProjectionMatrix(); }
// 选中时把星球挪开,给档案卡让位:桌面往左挪,手机往上挪(档案卡在下半屏)
const w = stage.clientWidth, h = stage.clientHeight;
const lay = el.layout ? el.layout() : { x: mob ? 0 : 0.16, y: mob ? 0.22 : 0 };
if (focus && (lay.x || lay.y)) camera.setViewOffset(w, h, w * lay.x, h * lay.y, w, h); else camera.clearViewOffset();
// 名牌:跟着星系走;贴边夹住不出屏;手机上压到 HUD 下面的藏起来
for (const s of systems) { s.g.getWorldPosition(tmp); tmp.project(camera);
let x = (tmp.x + 1) / 2 * w + 10, y = (1 - tmp.y) / 2 * h - 12;
const tw = s.tag.offsetWidth || 90; x = Math.min(Math.max(x, 6), w - tw - 6);
const vis = tmp.z < 1 && Math.abs(tmp.x) < 1.05 && Math.abs(tmp.y) < 1.05 && !(mob && y < hudBottom + 4) && focus !== s;
s.tag.style.transform = 'translate(' + x.toFixed(1) + 'px,' + y.toFixed(1) + 'px)';
s.tag.classList.toggle('hot', s === hover); s.tag.classList.toggle('dim', !!focus); s.tag.style.visibility = vis ? '' : 'hidden'; }
for (const st of sectorTags) { tmp.copy(st.p).project(camera); st.el.style.transform = 'translate(' + ((tmp.x + 1) / 2 * w) + 'px,' + ((1 - tmp.y) / 2 * h) + 'px) translate(-50%,-50%)'; st.el.style.opacity = (tmp.z < 1 && !focus) ? '' : 0; }
renderer.render(scene, camera);
if (firstFrame) { firstFrame = false; el.onReady && el.onReady(); } // 第一帧画好了,外面的「载入中」再淡出
}
// 开场:第一帧画出来再开始(外面的「载入中」此时淡出,镜头接着就开始动,中间不留空白)
let firstFrame = true;
loop();
return { resize: fit, fly: no => { const s = systems.find(x => x.u.no === no); if (s) fly(s); }, home };
}
+222
View File
@@ -0,0 +1,222 @@
/* =============================================================================
* 金钻宇宙 · 卡通星球材质库(planets.js)
* -----------------------------------------------------------------------------
* 每一种「风格」= 一段着色器(决定星球表面长什么样)+ 一组默认参数。
* 全部是程序生成的卡通材质:分段明暗(toon)+ 墨线描边 + 轮廓光,不依赖任何贴图文件。
*
* 加一种新风格:在 STYLES 里加一项 { geo, frag, defaults },见交接说明「加一种星球风格」。
* 用法:
* import { makePlanet } from './planets.js';
* const p = makePlanet(THREE, { style: 'ice', r: 1.2, colors: [...] });
* scene.add(p.group); // p.update(dt, t, lightDirWorld) 每帧调一次
* ============================================================================= */
// ---- 3D simplex 噪声(Ashima / Stefan Gustavson,MIT)—— 用物体空间坐标取样,球面上没有接缝
const NOISE = `
vec3 m289(vec3 x){return x-floor(x*(1.0/289.0))*289.0;} vec4 m289(vec4 x){return x-floor(x*(1.0/289.0))*289.0;}
vec4 perm(vec4 x){return m289(((x*34.0)+1.0)*x);} vec4 tis(vec4 r){return 1.79284291400159-0.85373472095314*r;}
float snoise(vec3 v){const vec2 C=vec2(1.0/6.0,1.0/3.0);const vec4 D=vec4(0.0,0.5,1.0,2.0);
vec3 i=floor(v+dot(v,C.yyy));vec3 x0=v-i+dot(i,C.xxx);vec3 g=step(x0.yzx,x0.xyz);vec3 l=1.0-g;
vec3 i1=min(g.xyz,l.zxy);vec3 i2=max(g.xyz,l.zxy);vec3 x1=x0-i1+C.xxx;vec3 x2=x0-i2+C.yyy;vec3 x3=x0-D.yyy;
i=m289(i);vec4 p=perm(perm(perm(i.z+vec4(0.0,i1.z,i2.z,1.0))+i.y+vec4(0.0,i1.y,i2.y,1.0))+i.x+vec4(0.0,i1.x,i2.x,1.0));
float n_=0.142857142857;vec3 ns=n_*D.wyz-D.xzx;vec4 j=p-49.0*floor(p*ns.z*ns.z);vec4 x_=floor(j*ns.z);vec4 y_=floor(j-7.0*x_);
vec4 x=x_*ns.x+ns.yyyy;vec4 y=y_*ns.x+ns.yyyy;vec4 h=1.0-abs(x)-abs(y);vec4 b0=vec4(x.xy,y.xy);vec4 b1=vec4(x.zw,y.zw);
vec4 s0=floor(b0)*2.0+1.0;vec4 s1=floor(b1)*2.0+1.0;vec4 sh=-step(h,vec4(0.0));vec4 a0=b0.xzyw+s0.xzyw*sh.xxyy;vec4 a1=b1.xzyw+s1.xzyw*sh.zzww;
vec3 p0=vec3(a0.xy,h.x);vec3 p1=vec3(a0.zw,h.y);vec3 p2=vec3(a1.xy,h.z);vec3 p3=vec3(a1.zw,h.w);
vec4 nm=tis(vec4(dot(p0,p0),dot(p1,p1),dot(p2,p2),dot(p3,p3)));p0*=nm.x;p1*=nm.y;p2*=nm.z;p3*=nm.w;
vec4 m=max(0.6-vec4(dot(x0,x0),dot(x1,x1),dot(x2,x2),dot(x3,x3)),0.0);m=m*m;
return 42.0*dot(m*m,vec4(dot(p0,x0),dot(p1,x1),dot(p2,x2),dot(p3,x3)));}
float fbm(vec3 p){ float v=0.0,a=0.5; for(int i=0;i<4;i++){ v+=a*snoise(p); p=p*2.02+vec3(3.1,1.7,5.3); a*=0.5; } return v; }
// 抗锯齿的细线:x 离 0 越近越黑,线宽 w(以屏幕像素为单位)
float aline(float x, float w){ float f = fwidth(x); return 1.0 - smoothstep(0.0, f*w, abs(x)); }
`;
// ---- 公共部分:分段明暗 + 冷色阴影 + 轮廓光
const HEAD = `
uniform vec3 uL; uniform float uT; uniform float uSeed; uniform vec3 uC0; uniform vec3 uC1; uniform vec3 uC2; uniform vec3 uC3;
uniform vec3 uShadow; uniform vec3 uRim; uniform float uGlow; uniform float uAlpha;
varying vec3 vP; varying vec3 vN; varying vec3 vW;
${NOISE}
// 卡通分段光照:亮 / 中 / 暗 三档,交界处一点点平滑防锯齿
float toon(float d){ float a = smoothstep(0.30,0.34,d), b = smoothstep(-0.12,-0.08,d); return 0.38 + 0.32*b + 0.30*a; }
vec3 shade(vec3 base, vec3 N, vec3 V){ float d = dot(N, normalize(uL)); float t = toon(d);
vec3 c = mix(base*uShadow, base, t);
float rim = pow(1.0 - max(dot(N, V), 0.0), 3.0); c += uRim * rim * 0.32 * smoothstep(-0.3, 0.4, d + 0.3);
return c; }
`;
const VERT = `
varying vec3 vP; varying vec3 vN; varying vec3 vW;
void main(){ vP = normalize(position); vN = normalize(mat3(modelMatrix)*normal); vec4 w = modelMatrix*vec4(position,1.0); vW = w.xyz; gl_Position = projectionMatrix*viewMatrix*w; }`;
// ---- 各风格的表面(main 里拿到 base 颜色 + 自发光 emi,最后统一上光)
const STYLES = {
/* 晶体:多面体切面,每个面颜色随朝向变化(像钻石折光),内部有发光的「演算脉络」 —— 给晶钻超算主宇宙 */
crystal: {
geo: (THREE, r) => new THREE.IcosahedronGeometry(r, 2),
defaults: { colors: ['#7FE7FF', '#8E7BFF', '#FFE59A', '#FFFFFF'], shadow: '#5B5FA8', rim: '#BFF4FF', outline: '#141A3A', glow: 0.55 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW);
vec3 N = normalize(cross(dFdx(vW), dFdy(vW))); // 平面法线 = 一个面一个颜色
vec3 nO = normalize(vP);
float k = 0.5 + 0.5*sin(dot(nO, vec3(5.1,3.7,4.3)) + uSeed);
vec3 base = mix(mix(uC0, uC1, k), uC2, smoothstep(0.55, 1.0, sin(dot(nO, vec3(2.3,-4.1,1.7))*3.0 + uSeed)*0.5+0.5)*0.55);
float vein = aline(snoise(vP*3.2 + vec3(0.0, uT*0.08, 0.0)), 2.2);
vec3 c = shade(base, N, V);
float spark = pow(max(dot(reflect(-normalize(uL), N), V), 0.0), 24.0);
c += uC3 * step(0.5, spark) * 0.45 + uC0 * vein * 0.75 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 铅笔纸面:米白纸色 + 等高线一样的铅笔线 + 暗面排线 + 几处红笔圈 —— 给「火柴人宇宙」(小时候课上画的) */
paper: {
defaults: { colors: ['#F6F1E4', '#2B2E45', '#E5544B', '#9DB7E8'], shadow: '#B9B4C8', rim: '#FFFFFF', outline: '#2B2E45', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float n = fbm(vP*1.6 + uSeed);
float contour = aline(fract(n*4.0 + 0.5) - 0.5, 1.4);
float d = dot(N, normalize(uL));
float h1 = aline(fract(dot(vP, vec3(0.7,0.7,0.1))*26.0) - 0.5, 1.2) * (1.0 - smoothstep(-0.1, 0.1, d)); // 暗面单向排线
float h2 = aline(fract(dot(vP, vec3(-0.7,0.7,0.2))*26.0) - 0.5, 1.2) * (1.0 - smoothstep(-0.55, -0.4, d)); // 更暗处交叉排线
float circ = aline(length(vP - normalize(vec3(0.6, 0.35, 0.7))) - 0.22, 1.6) + aline(length(vP - normalize(vec3(-0.5,-0.4,0.75))) - 0.14, 1.6);
float blue = smoothstep(0.35, 0.6, fbm(vP*2.4 + 7.0 + uSeed)); // 几块淡蓝色铅笔涂色
vec3 base = mix(uC0, mix(uC0, uC3, 0.45), blue);
vec3 c = shade(base, N, V);
c = mix(c, uC1, clamp(contour*0.85 + max(h1, h2)*0.6, 0.0, 1.0));
c = mix(c, uC2, clamp(circ, 0.0, 1.0)*0.9);
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 冰封:纬向冰带 + 极冠 + 冰裂纹 —— 给「极寒世界」(冰河期、地表 -50℃) */
ice: {
defaults: { colors: ['#F2FAFF', '#BFE4FF', '#7CC3F0', '#FFFFFF'], shadow: '#6C80C9', rim: '#D6F3FF', outline: '#18305C', glow: 0.2 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float band = snoise(vec3(vP.x*1.2, vP.y*7.0 + uSeed, vP.z*1.2));
vec3 base = mix(uC0, uC1, smoothstep(-0.25, 0.35, band));
base = mix(base, uC3, smoothstep(0.68, 0.74, abs(vP.y) + 0.05*snoise(vP*6.0))); // 极冠
float crack = smoothstep(0.88, 0.95, 1.0 - abs(snoise(vP*4.5 + uSeed)));
vec3 c = shade(base, N, V);
c = mix(c, uC2, crack*0.85);
c += uC3 * pow(max(dot(reflect(-normalize(uL), N), V), 0.0), 40.0) * 0.6;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 霓虹城:深紫底色 + 经纬网格街区 + 闪烁的窗灯 —— 给「没落赛博城」 */
neon: {
defaults: { colors: ['#211A3D', '#5FF2FF', '#FF5FD2', '#FFD36E'], shadow: '#5E5A8F', rim: '#8A7BFF', outline: '#0B0820', glow: 1.0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float lon = atan(vP.z, vP.x) / 3.14159265, lat = asin(clamp(vP.y, -1.0, 1.0)) / 1.5707963;
float dist = smoothstep(-0.05, 0.25, fbm(vP*2.2 + uSeed)); // 有城的街区
float gx = aline(fract(lon*14.0) - 0.5, 1.6), gy = aline(fract(lat*9.0) - 0.5, 1.6);
vec2 cell = floor(vec2(lon*56.0, lat*36.0));
float win = step(0.72, fract(sin(dot(cell, vec2(12.9898, 78.233)) + uSeed)*43758.5453));
float flick = 0.65 + 0.35*sin(uT*2.0 + cell.x*1.7 + cell.y*0.9);
vec3 base = uC0 * (0.9 + 0.2*snoise(vP*3.0));
vec3 c = shade(base, N, V);
vec3 neon = mix(uC1, uC2, step(0.0, snoise(vP*1.3 + 11.0)));
c += neon * max(gx, gy) * dist * 1.2 * uGlow + uC3 * win * dist * flick * 0.55 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 善恶两半:一半金色白昼、一半紫色夜空,交界是一条发光的波浪线 —— 给「善恶等级」 */
duality: {
defaults: { colors: ['#FFF0C8', '#F2B84B', '#2D1E57', '#8F6BFF'], shadow: '#8C7AA8', rim: '#FFE7A8', outline: '#1A1235', glow: 0.8 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float s = vP.x*0.9 + 0.22*snoise(vP*1.8 + uSeed) + 0.12*sin(vP.y*7.0 + uT*0.3);
float side = smoothstep(-0.015, 0.015, s);
float cloud = smoothstep(0.1, 0.5, fbm(vP*2.6 + uSeed));
vec3 light = mix(uC0, uC1, cloud*0.6);
float star = step(0.985, fract(sin(dot(floor(vP*60.0), vec3(12.9898,78.233,37.719)))*43758.5453));
vec3 dark = mix(uC2, uC3, cloud*0.5) + vec3(star)*0.8;
vec3 c = shade(mix(dark, light, side), N, V);
c += uC1 * aline(s, 3.0) * 1.2 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 气态巨星(点缀用):卡通条纹 + 一个风暴眼 */
gas: {
defaults: { colors: ['#F2D7A6', '#D99A6C', '#8E6BBF', '#FFF2D6'], shadow: '#7A6A9E', rim: '#FFE2B8', outline: '#1E1838', ring: false, glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float w = vP.y*5.0 + 0.6*snoise(vec3(vP.x*2.0, vP.y*4.0, vP.z*2.0) + uSeed);
float b = 0.5 + 0.5*sin(w*3.14159);
vec3 base = mix(mix(uC0, uC1, smoothstep(0.3, 0.7, b)), uC2, smoothstep(0.8, 0.95, b)*0.6);
float storm = 1.0 - smoothstep(0.08, 0.13, length(vP - normalize(vec3(0.8, -0.25, 0.5))));
base = mix(base, uC3, storm*0.85);
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
/* 岩石小行星(点缀用):卡通陨坑 */
rock: {
defaults: { colors: ['#A9AFC9', '#7D84A6', '#5B6288', '#D5D9EA'], shadow: '#5B5F8A', rim: '#C9D3FF', outline: '#141833', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float n = fbm(vP*2.0 + uSeed);
vec3 base = mix(uC0, uC1, smoothstep(-0.2, 0.3, n));
float cr = smoothstep(0.42, 0.5, snoise(vP*5.0 + uSeed*2.0));
base = mix(base, uC2, cr); base = mix(base, uC3, aline(snoise(vP*5.0 + uSeed*2.0) - 0.42, 1.5)*0.7);
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
/* 未点亮:半透明全息线框球 —— 空槽 */
ghost: {
transparent: true,
defaults: { colors: ['#7F8BC8', '#B9C4FF', '#7F8BC8', '#FFFFFF'], shadow: '#FFFFFF', rim: '#B9C4FF', outline: null, glow: 0, alpha: 1 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float lon = atan(vP.z, vP.x) / 3.14159265, lat = asin(clamp(vP.y,-1.0,1.0)) / 1.5707963;
float g = max(aline(fract(lon*8.0 + uT*0.02) - 0.5, 1.4), aline(fract(lat*5.0) - 0.5, 1.4));
float f = pow(1.0 - max(dot(N, V), 0.0), 2.0);
gl_FragColor = vec4(mix(uC0, uC1, f), (g*0.55 + f*0.45 + 0.04) * uAlpha); }`,
},
};
export const STYLE_NAMES = Object.keys(STYLES);
/**
* 造一颗卡通星球。look 里能写:
* style 风格名(见 STYLES)
* r 半径
* colors 四个颜色(覆盖风格默认) shadow / rim / outline 阴影色 / 轮廓光色 / 描边色(outline:null 不描边)
* ring 要不要光环(默认没有;true / { inner, outer, color })
* seed 随机种子(同一风格的两颗星球长得不一样)
* tilt 自转轴倾角(弧度)
* atm 大气辉光颜色(默认没有;写了才加一层很淡的辉光)
*/
export function makePlanet(THREE, look = {}) {
const S = STYLES[look.style] || STYLES.rock;
const o = Object.assign({}, S.defaults, look);
const r = o.r || 1;
const col = i => new THREE.Color((o.colors || S.defaults.colors)[i] || '#ffffff');
const uniforms = {
uL: { value: new THREE.Vector3(-1, 0.6, 0.5) }, uT: { value: 0 }, uSeed: { value: o.seed ?? Math.random() * 50 },
uC0: { value: col(0) }, uC1: { value: col(1) }, uC2: { value: col(2) }, uC3: { value: col(3) },
uShadow: { value: new THREE.Color(o.shadow) }, uRim: { value: new THREE.Color(o.rim) }, uGlow: { value: o.glow ?? 0 }, uAlpha: { value: o.alpha ?? 1 },
};
const mat = new THREE.ShaderMaterial({ uniforms, vertexShader: VERT, fragmentShader: HEAD + S.frag,
transparent: !!S.transparent, depthWrite: !S.transparent, side: S.transparent ? THREE.DoubleSide : THREE.FrontSide });
const geo = S.geo ? S.geo(THREE, r) : new THREE.SphereGeometry(r, 96, 64);
const group = new THREE.Group(), body = new THREE.Mesh(geo, mat);
body.rotation.z = o.tilt ?? 0.3; group.add(body);
// 墨线描边:背面放大一点点的同形状,纯色 —— 卡通感的关键
if (o.outline) { const ol = new THREE.Mesh(geo, new THREE.MeshBasicMaterial({ color: o.outline, side: THREE.BackSide }));
ol.scale.setScalar(1.035); body.add(ol); }
// 大气辉光:默认**不加**(用户反馈「每颗星球外边都有一个罩子」)。确实想要就在 look 里写 atm: '#颜色'
let atm = null;
if (o.atm) {
atm = new THREE.Mesh(new THREE.SphereGeometry(r * 1.08, 48, 32), new THREE.ShaderMaterial({
transparent: true, depthWrite: false, side: THREE.BackSide, blending: THREE.AdditiveBlending,
uniforms: { uC: { value: new THREE.Color(o.atm) }, uS: { value: 0.25 } },
vertexShader: `varying vec3 vN; varying vec3 vW; void main(){ vN = normalize(mat3(modelMatrix)*normal); vec4 w = modelMatrix*vec4(position,1.0); vW = w.xyz; gl_Position = projectionMatrix*viewMatrix*w; }`,
fragmentShader: `uniform vec3 uC; uniform float uS; varying vec3 vN; varying vec3 vW; void main(){ vec3 v = normalize(cameraPosition - vW); float f = pow(1.0 - abs(dot(v, vN)), 4.0); gl_FragColor = vec4(uC, f*uS); }` }));
group.add(atm);
}
// 光环(卡通扁环,两道颜色)
let ring = null;
if (o.ring) {
const rc = typeof o.ring === 'object' ? o.ring : {};
const inner = (rc.inner || 1.45) * r, outer = (rc.outer || 2.1) * r;
ring = new THREE.Mesh(new THREE.RingGeometry(inner, outer, 128, 1), new THREE.ShaderMaterial({
transparent: true, depthWrite: false, side: THREE.DoubleSide,
uniforms: { uA: { value: new THREE.Color(rc.color || (o.colors || S.defaults.colors)[0]) }, uB: { value: new THREE.Color(rc.color2 || (o.colors || S.defaults.colors)[1]) }, uIn: { value: inner }, uOut: { value: outer } },
vertexShader: `varying vec3 vP; void main(){ vP = position; gl_Position = projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
fragmentShader: `uniform vec3 uA; uniform vec3 uB; uniform float uIn; uniform float uOut; varying vec3 vP;
void main(){ float t = (length(vP.xy)-uIn)/(uOut-uIn); float b = step(0.5, fract(t*5.0));
float a = (0.55 + 0.25*b) * smoothstep(0.0, 0.06, t) * smoothstep(1.0, 0.94, t); gl_FragColor = vec4(mix(uA, uB, b*0.6 + t*0.3), a); }` }));
ring.rotation.x = -Math.PI / 2 + 0.38; ring.rotation.y = 0.12; group.add(ring);
}
const spin = o.spin ?? 0.15;
return {
group, body, mat, atm, ring, r, look: o,
update(dt, t, lightDir) { body.rotation.y += dt * spin; uniforms.uT.value = t; if (lightDir) uniforms.uL.value.copy(lightDir); },
setAlpha(a) { uniforms.uAlpha.value = a; },
};
}
+96
View File
@@ -0,0 +1,96 @@
/* 金钻宇宙板块:白色客栈页面里开一扇「观星窗」,窗里是星系图;窗下是世界线档案列表(和星图联动)
像素字 / 按钮 / 墨色都沿用门户 jz-2026 层的变量(--pixel --ink --mc-green --stone …),这里只管星图自己的东西。 */
.skywin{--sky:#070B1C;--ui:#FFD36E;--line:rgba(127,139,200,.35);
position:relative;margin:6px 0 26px;padding:6px;border-radius:12px;background:rgba(255,255,255,.75);border:2px solid #fff;
box-shadow:0 30px 60px -36px rgba(40,50,110,.55)}
.skywin .stage{position:relative;height:min(72vh,660px);min-height:440px;border-radius:8px;overflow:hidden;background:var(--sky);color:#E8EBFA;isolation:isolate}
.skywin #uGl{position:absolute;inset:0;width:100%;height:100%;display:block;touch-action:none;outline:none}
/* 窗内 HUD:只放读数,标题已经在页面上了 */
.skywin .hud{position:absolute;left:18px;top:14px;pointer-events:none;display:flex;gap:16px;font:600 11px/1.4 ui-monospace,Menlo,monospace;letter-spacing:.12em;color:#7C84B4;
animation:uHud 1s cubic-bezier(.23,1,.32,1) .4s both}
.skywin .hud b{font:400 18px/1 var(--pixel);letter-spacing:0;color:var(--ui);margin-left:6px;-webkit-font-smoothing:none}
@keyframes uHud{from{opacity:0;transform:translateY(-6px)}to{opacity:1;transform:none}}
.skywin .labels{position:absolute;inset:0;pointer-events:none;transition:opacity .9s cubic-bezier(.23,1,.32,1)}
.skywin .stage:not(.ready) .labels{opacity:0}
.skywin .tag{position:absolute;left:0;top:0;display:flex;align-items:center;gap:7px;padding:3px 8px;border:0;border-radius:4px;background:none;cursor:pointer;white-space:nowrap;pointer-events:auto;font:inherit;text-align:left;will-change:transform;transition:opacity .3s}
.skywin .tag .t b{display:block;font:400 15px/1.15 var(--pixel);-webkit-font-smoothing:none;color:#F4F6FF;text-shadow:0 0 8px rgba(5,8,25,.95)}
.skywin .tag .t em{display:block;font:600 10px/1.3 ui-monospace,Menlo,monospace;letter-spacing:.12em;font-style:normal;color:#7C84B4}
.skywin .tag:hover,.skywin .tag.hot{background:rgba(255,211,110,.1)} .skywin .tag:hover .t b,.skywin .tag.hot .t b{color:var(--ui)}
.skywin .tag:focus-visible{outline:2px solid var(--ui);outline-offset:2px}
.skywin .tag.empty .t b{color:#8A92BE;font-size:13px}
.skywin .tag.dim{opacity:.15}
.skywin .sector{position:absolute;left:0;top:0;font:600 10px/1 ui-monospace,Menlo,monospace;letter-spacing:.3em;color:rgba(169,176,214,.42);white-space:nowrap;transition:opacity .4s;pointer-events:none}
/* 窗内档案卡(桌面 / 全屏时) */
.skywin .panel{position:absolute;right:18px;top:50%;width:min(390px,40%);transform:translate(20px,-48%);opacity:0;pointer-events:none;transition:opacity .45s cubic-bezier(.23,1,.32,1),transform .6s cubic-bezier(.23,1,.32,1)}
.skywin .panel.on{opacity:1;transform:translate(0,-50%);pointer-events:auto}
.skywin .panel .card{position:relative;padding:20px 20px 16px 24px;border-radius:8px;background:rgba(255,255,255,.96);border:2px solid #fff;color:var(--ink);box-shadow:0 30px 70px -30px rgba(0,0,0,.6)}
.skywin .panel .card::before{content:"";position:absolute;left:0;top:0;bottom:0;width:4px;border-radius:8px 0 0 8px;background:var(--pc,#FFD36E)}
.skywin .panel .card .k{font:600 12px/1 var(--font,inherit);letter-spacing:.06em;color:var(--ink-3)}
.skywin .panel .card h2{margin:8px 0 2px;font:400 28px/1.2 var(--pixel);-webkit-font-smoothing:none}
.skywin .panel .card .tg{color:var(--ink-2);font-size:14px}
.skywin .panel .card .ds{margin:10px 0 0;font-size:14px;line-height:1.8;color:var(--ink-2)}
.skywin .panel .card .tags{display:flex;flex-wrap:wrap;gap:6px;margin-top:10px}
.skywin .panel .card .tags span{font-size:12px;padding:4px 8px;border-radius:4px;background:rgba(30,36,64,.05);color:var(--ink-2)}
.skywin .panel .card .acts{display:flex;flex-wrap:wrap;gap:8px;margin-top:16px;justify-content:space-between}
.skywin .panel .card .nav{display:flex;gap:8px}
.skywin .panel .card .btn{height:38px;font-size:13.5px;padding:0 14px 3px}
/* 窗角按钮 */
.skywin .ctl{position:absolute;right:14px;top:12px;display:flex;gap:8px}
.skywin .ctl .btn{height:34px;font-size:13px;padding:0 12px 3px}
/* 档案卡里「回到星系图」是主按钮:门户的 .btn 是石头白方块,这里补一个绿色 .pri(同 .btn-solid) */
.skywin .btn.pri{background:var(--mc-green);border-color:var(--mc-green-lo);color:#fff;box-shadow:inset 0 2px 0 var(--mc-green-hi),inset 0 -4px 0 var(--mc-green-lo)}
.skywin .btn.pri:hover{background:#469A2E}
.skywin #uBack{display:none} .skywin .stage.focus #uBack{display:inline-flex}
.skywin .tip{position:absolute;left:18px;bottom:14px;margin:0;font-size:12px;color:#7C84B4;pointer-events:none;transition:opacity .3s}
.skywin .stage.focus .tip{opacity:0}
.skywin .loading{position:absolute;inset:0;display:grid;place-items:center;font:400 18px var(--pixel);color:#A9B0D6;background:var(--sky);transition:opacity .6s;z-index:5}
/* 全屏:窗户铺满屏幕,滚轮直接缩放 */
.skywin.full .stage{position:fixed;inset:0;z-index:300;height:auto;min-height:0;border-radius:0}
body.sky-full{overflow:hidden}
/* 窗下:世界线列表 */
.uni-title{margin:4px 0 14px;font-size:24px;line-height:1.3;color:var(--ink)}
.sky-hint{display:none}
.uni-list{display:grid;grid-template-columns:repeat(auto-fill,minmax(230px,1fr));gap:12px;margin-bottom:14px}
.ucell{position:relative;display:flex;flex-direction:column;gap:4px;padding:16px 16px 14px;border-radius:8px;border:2px solid rgba(255,255,255,.95);text-align:left;cursor:pointer;font:inherit;color:var(--ink);
background:linear-gradient(160deg,rgba(255,255,255,.9),rgba(255,255,255,.65));box-shadow:0 18px 36px -26px rgba(80,90,170,.45);transition:transform .2s cubic-bezier(.23,1,.32,1),box-shadow .2s}
.ucell:hover{transform:translateY(-2px)}
.ucell[aria-current=true]{box-shadow:inset 0 0 0 3px var(--mc-green,#3C8527),0 18px 36px -26px rgba(80,90,170,.45)}
.ucell .no{font:600 11px/1 ui-monospace,Menlo,monospace;letter-spacing:.14em;color:var(--ink-3)}
.ucell h3{margin:2px 0 0;font:400 22px/1.25 var(--pixel);-webkit-font-smoothing:none}
.ucell .tg{font-size:13px;color:var(--ink-2)}
.ucell .go{margin-top:6px;font-size:12.5px;font-weight:700;color:var(--mc-green,#3C8527)}
.ucell .sw{position:absolute;right:14px;top:14px;width:26px;height:26px;border-radius:50%;background:var(--sw);box-shadow:inset -5px -5px 0 rgba(0,0,0,.18),0 0 0 2px #fff}
.uslots{display:grid;grid-template-columns:repeat(6,minmax(0,1fr));gap:10px}
.uslots button{height:54px;border-radius:8px;border:1.5px dashed rgba(140,150,200,.45);background:rgba(255,255,255,.6);font:inherit;font-size:12px;color:var(--ink-3);cursor:pointer}
.uslots button b{display:block;font-size:14px;color:var(--ink-2);font-variant-numeric:tabular-nums}
.uslots button[aria-current=true]{border-style:solid;border-color:var(--mc-green,#3C8527)}
@media (max-width:760px){
.skywin{margin:4px -4px 8px;padding:4px}
/* 窗户不铺满屏:上下留出能滑页面的地方 */
.skywin .stage{height:min(64svh,560px);min-height:400px}
.skywin #uGl{touch-action:none} /* 在星图里的手势全归星图:单指转、双指缩放,不会带着页面滑 */
.sky-hint{display:block;margin:0 2px 20px;font-size:12px;color:var(--ink-3);text-align:center}
/* 档案卡:星图窗里的底部抽屉(只占下半个窗),星球被镜头挪到上半个窗 */
.skywin .panel{left:8px;right:8px;top:47%;bottom:8px;width:auto;display:flex;flex-direction:column;justify-content:flex-end;transform:translateY(24px)}
.skywin.full .panel{bottom:calc(8px + env(safe-area-inset-bottom))}
.skywin .panel.on{transform:none}
.skywin .panel .card{max-height:100%;overflow:auto;overscroll-behavior:contain;-webkit-overflow-scrolling:touch;padding:12px 14px 0 18px;touch-action:pan-y}
.skywin .panel .card h2{margin-top:6px;font-size:21px}
.skywin .panel .card .tg{font-size:13px}
.skywin .panel .card .ds{margin-top:6px;font-size:13px;line-height:1.7}
.skywin .panel .card .tags{margin-top:8px}
.skywin .panel .card .tags span{font-size:11.5px;padding:3px 7px}
/* 三个按钮一行,贴在抽屉底边,正文长了在中间滚 */
.skywin .panel .card .acts{position:sticky;bottom:0;display:grid;grid-template-columns:1fr 1fr 1.25fr;gap:6px;margin:10px -14px 0 -18px;padding:8px 14px 12px 18px;background:linear-gradient(rgba(255,255,255,0),#fff 10px)}
.skywin .panel .card .nav{display:contents}
.skywin .panel .card .btn{height:36px;font-size:13px;padding:0 6px 3px}
.skywin .tag .t b{font-size:13px} .skywin .tag .t em{display:none} .skywin .tag.empty{display:none}
.skywin .sector,.skywin .tip{display:none}
.skywin #uBack{display:none !important} /* 手机:返回按钮已经在档案卡里了 */
.skywin .hud{gap:12px;transition:opacity .3s}
.skywin .stage.focus .hud{animation:none;opacity:0} /* 看档案时把读数收起来,别和右上角按钮挤 */
.uni-list{grid-template-columns:1fr 1fr;gap:10px}
.ucell{padding:14px 12px 12px}.ucell h3{font-size:18px}.ucell .sw{width:20px;height:20px;right:10px;top:10px}
.uslots{grid-template-columns:repeat(3,minmax(0,1fr))}
}
@media (prefers-reduced-motion:reduce){.skywin .panel,.skywin .labels,.skywin .hud,.ucell{transition:none;animation:none}}
+188
View File
@@ -0,0 +1,188 @@
# 交接说明 · 金钻宇宙星系图(`portal/assets/universe/`)
> 状态:**已接进门户**(2026-10-05):`portal/index.html` 的「金钻宇宙」板块就是它,原来的启动仪式 / 盘符机架 / 读盘舱已删除。
> 风格参考:《绝地潜兵 2》银河战争地图 —— 旋臂星系 + 星云 + 扇区 + 补给线;每条世界线是一个星系,点进去是一颗卡通星球 + 档案卡。
---
## 1. 文件
| 文件 | 干什么 | 日常要不要改 |
|---|---|---|
| `assets/universe/config.js` | **全部内容和外观配置**:世界线档案、每颗星球的风格 / 颜色 / 卫星、星系配色、扇区名、粒子数量。门户主脚本的 `UNIVERSES` 也从这里读 | **改这个** |
| `assets/universe/planets.js` | 卡通星球材质库(每种「风格」= 一段着色器 + 默认参数) | 加新风格时改 |
| `assets/universe/galaxy.js` | 引擎:画星系、星云、补给线、名牌,处理拖动 / 缩放 / 点击 / 档案卡 / 运镜 | 一般不用动 |
| `assets/universe/universe.css` | 观星窗、档案卡、窗下世界线卡片、手机布局的样式 | 改版式时改 |
| `portal/index.html` 里 `#view-universe` + 底部那段 `<script type="module">` | 板块骨架(窗户 / 名牌层 / HUD / 档案卡 / 卡片列表)和接线代码 | 改交互时改 |
| `assets/vendor/three.module.min.js` | three.js r170(MIT,自托管,不连外网) | 不动 |
**没有任何贴图、模型文件**:星球、星云、星点全是着色器实时生成的,所以没有版权问题,也不用担心图片加载慢。
---
## 2. 常见改动
### 加一条新世界线
1. `config.js` → `UNIVERSES` 里把对应的空槽(比如 `{ no: '0005', empty: true }`)换成完整档案:
```js
{ no: '0005', name: '名字', kind: '原创', tag: '一句话副标题', tags: ['标签1', '标签2'], desc: '档案正文' },
```
字段和门户页原来的 `UNIVERSES` 一模一样(`no / name / kind / tag / tags / desc`),可以直接拷。
2. `config.js` → `LOOKS` 里按编号加外观:
```js
'0005': { style: 'ice', r: 1.2, orbit: [34, 2], accent: '#9FE3FF',
colors: ['#…', '#…', '#…', '#…'], // 可选:覆盖风格默认的四个颜色
ring: true, // 可选:光环(默认没有;用户觉得突兀,现在一颗都没开)
atm: '#9FE3FF', // 可选:大气辉光(默认没有;之前「每颗星外面一个罩子」就是它)
moons: [{ style: 'rock', r: 0.3, d: 2.6, speed: 0.5 }], // 可选:卫星(纯装饰)
why: '为什么长这样(写给后来的人看)' },
```
- `orbit: [离中心距离, 第几条旋臂]`:距离 0~60,旋臂 0~3。别和别的星系放太近(差 8 以上比较好看)。
- 不写 `LOOKS` 的世界线会自动用 `EMPTY_LOOK`(全息线框的「未点亮」样子),放在外圈。
3. 刷新页面即可。HUD 上的「世界线 / 已点亮 / 空槽」数字是自动数的。
### 只换一颗星球的颜色
改它 `LOOKS` 里的 `colors`(四个颜色,含义见下表)。不写就用风格默认值。
### 改整张图的配色
`config.js` → `GALAXY.colors`:底色、核心色、旋臂内外色、星云几组颜色、线条色、UI 强调色(名牌 / 数字的金色)。
**建议整张图只用这几种颜色**,别给每颗星单独配一个刺眼的颜色 —— 上一版就是因为颜色太杂被说丑。
### 改扇区名 / 粒子数量 / 散落星球数量
`GALAXY.sectors`(6 个扇区名)、`GALAXY.particles`、`GALAXY.nebulae`、`GALAXY.decorPlanets`(桌面 / 手机分开设)。
手机卡的话先把 `particles.mobile` 降到 10000、`nebulae.mobile` 降到 10。
---
## 3. 现有的星球风格(`planets.js` → `STYLES`)
| 风格 | 长什么样 | 四个颜色依次是 | 现在给谁用 / 为什么 |
|---|---|---|---|
| `crystal` | 多面体切面、每面颜色随朝向变、内部发光脉络 | 主色 / 副色 / 高光色 / 闪点 | 零号宇宙:晶钻超算本体 |
| `paper` | 米白纸面、铅笔等高线、暗面排线、红笔圈、淡蓝涂色 | 纸色 / 铅笔色 / 红笔色 / 涂色 | 火柴人宇宙:小时候课上画的 |
| `ice` | 纬向冰带、极冠、冰裂纹、冰面高光 | 冰白 / 冰蓝 / 裂纹色 / 极冠色 | 极寒世界:冰河期、-50℃ |
| `neon` | 深紫地表、霓虹街区网格、闪烁窗灯 | 地表 / 霓虹 A / 霓虹 B / 窗灯 | 没落赛博城 |
| `duality` | 一半白昼一半夜空,交界一条发光波浪线 | 白昼 / 云 / 夜空 / 夜云 | 善恶等级(设定还在酝酿,先按名字做;定了再换) |
| `gas` | 卡通条纹气态行星 + 风暴眼 | 条纹 A / 条纹 B / 深色带 / 风暴 | 散落的无名星球、卫星 |
| `rock` | 卡通陨坑岩石星 | 亮面 / 暗面 / 坑底 / 坑沿 | 散落的无名星球、卫星 |
| `ghost` | 半透明全息线框球 | 线色 / 边缘色 / - / - | 空槽(未点亮) |
所有风格共用:三档卡通明暗(亮 / 中 / 暗)+ 冷色阴影(`shadow`)+ 很弱的轮廓光(`rim`)+ 墨线描边(`outline`,写 `null` 不描边)。
大气辉光(`atm`)和光环(`ring`)都是**可选**的,默认关 —— 用户反馈过「罩子」「环」很突兀、辉光太曝。
### 加一种新风格
在 `STYLES` 里加一项:
```js
myStyle: {
defaults: { colors: ['#…','#…','#…','#…'], shadow: '#…', rim: '#…', outline: '#…', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
vec3 base = mix(uC0, uC1, smoothstep(-0.2, 0.3, fbm(vP*2.0 + uSeed))); // vP = 球面上的点(单位向量)
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
```
着色器里能用:`snoise(vec3)` 噪声、`fbm(vec3)` 分形噪声、`aline(x, 线宽)` 抗锯齿细线、`shade(颜色, N, V)` 统一上卡通光、
`uC0~uC3` 四个颜色、`uT` 时间、`uSeed` 种子、`uGlow` 自发光强度。然后在 `LOOKS` 里 `style: 'myStyle'` 就能用。
---
## 4. 交互
### 开场 / 飞行动画(运镜库在 galaxy.js 的 MOVES 里)
全部按时间走(和帧率无关),慢设备上也是同一条连贯的路线。
| 运镜 | 名字 | 怎么动 | 现在给谁 |
|---|---|---|---|
| 推进 | `push` | 先转过去对准(前 40%),再笔直推进去,不绕圈 | 火柴人宇宙 |
| 放大 | `zoom` | 先用长焦把它拉近(视角收窄到 14°),再一边推进一边把视角放回来 | 零号宇宙 |
| 升空俯冲 | `rise` | 先拉高到几乎俯视,再从上面扎下去 | 极寒世界 |
| 跃迁 | `warp` | 慢起步、中段猛冲、末段刹住;冲的时候视角张开、镜头轻轻一滚 | 没落赛博城 |
| 绕行 | `orbit` | 边飞边绕过去,中途抬高拉远一点 | 善恶等级;以及「上一个 / 下一个」在星系之间切换时 |
| 拉远 | `pull` | 回星系图:先往后退,再抬头看全景 | 「回到星系图」 |
| 开场 · 盘旋落下 | `introSweep` | 从高空、更远处绕半圈落到正常视角 | 开场(`GALAXY.intro`) |
| 开场 · 垂直坠入 | `introDive` | 从正上方很远处直着落下来,最后才抬起镜头 | 开场(`GALAXY.intro`,默认随机二选一) |
- 每条世界线用哪个入场运镜:`config.js` → `LOOKS[编号].enter`;不写就按 push / zoom / rise / warp / orbit 轮流。
- **档案卡和镜头同步**:点下去时旧档案先收起,镜头飞到 78% 的时候档案卡才滑出来(内容也那时才换),和星球落定同时到。
嵌在页面里时 `onFocus(u, 'start')` 在起飞时回调(列表马上高亮),`onFocus(u, 'arrive')` 在快到时回调(这时再出正文)。
- 飞的途中用户拖动 / 缩放:运镜立刻停在原地交还控制权,没出来的档案卡马上补出来,不会丢。
- 加一种新运镜:往 `MOVES` 里加一项 `{ dur: 毫秒, path(from, to, k) { … 往 view 里写 az/el/dist/tx/ty/tz/fov/roll … } }`,再在 `enter` 里写它的名字。
- 开场在画面第一次进入视口时开始;星系从暗处亮起来(约 2.4 秒),镜头落定后名牌才浮现。「载入中」在第一帧画出来时才淡出。
- 总览时星系会放大一点(桌面 1.35 倍、手机 1.9 倍)好认,飞近时恢复真实大小。
- 桌面:拖动转视角、滚轮缩放、点星球或名牌飞过去、`←` / `→` 切上一个 / 下一个、`Esc` 回到星系图。
- 手机:单指拖动、**双指缩放**、点名牌或星球飞过去;飞过去后星球在上半屏、档案卡是底部抽屉,「回到星系图」在卡里。
- 系统设置了「减少动态效果」:星系不自转、镜头直接切过去、星云不流动。
- 名牌是真正的 `<button>`,键盘 Tab 能选中。
---
## 5. 手机端处理过的冲突(这次修的)
| 问题 | 怎么修的 |
|---|---|
| HUD 的说明文字和星系名牌叠在一起 | 手机只留标题 + 一行读数;落在 HUD 范围里的名牌自动藏起来 |
| 名牌贴边被切掉 | 名牌位置夹在屏幕内(左右各留 6px) |
| 档案卡挡住星球 | 选中后镜头把星球挪到上半屏,档案卡做成底部抽屉(最高 44% 屏高,内容多了卡里自己滚) |
| 左下「回到星系图」被抽屉盖住 | 手机上隐藏它,按钮放进档案卡(整行宽,好点) |
| 空槽名牌太多太挤 | 手机只显示已点亮的名牌,空槽只留星球本身 |
| 不能缩放 | 加了双指缩放 |
| 近处的星点糊成大光斑 | 星点像素大小设了上限 |
| 手机画面比桌面稀、星系只是小点 | 手机和桌面用几乎一样的数量,星点大小按距离补偿,总览时星系放大 1.9 倍 |
| 名牌前的小方块色点 | 去掉了(全站规矩:文字前不放色点) |
| 散落的无名星球乱、互相重叠、卫星有的反着转 | 减到 14 颗;摆放时和核心、各星系(含卫星轨道)、彼此之间都留距离;卫星一律同向转 |
验证:无头浏览器 390×844 / 1440×900 各截一轮,五颗星球逐个飞进去截图,控制台 0 报错、无横向滚动、所有名牌都在屏幕内且不压 HUD。
---
## 6. 在门户里是怎么接的
- `<head>` 里:`assets/universe/universe.css` + 一段 `importmap`(把 `three` 指到 `assets/vendor/three.module.min.js`)。
- 主脚本之前:`<script src="assets/universe/config.js">` —— 主脚本一解析就要读 `window.JZ_UNIVERSE`(首页总览的计数、`#0001` 深链都用它)。
- 页面底部一段 `<script type="module">`:
- 按 `config.js` 渲染窗下的世界线卡片和空槽;
- 对外挂 `window.__jzUniverse = { show(), fly(编号) }`;
- **第一次 `show()` 时才 `import('./assets/universe/galaxy.js')`**,three.js 跟着下载(约 690KB,gzip 后约 170KB)。首页、画展等别的板块不下载它。
- 主脚本:`showBoard('universe')` 调 `__jzUniverse.show()`;`#0001` 这种旧深链调 `__jzUniverse.fly('0001')`;飞到哪条,地址栏就 `replaceState` 成 `#编号`,可以直接分享。
`mountGalaxy()` 的可选参数(门户都用上了):
| 参数 | 干什么 | 门户怎么用 |
|---|---|---|
| `onFocus(u, phase)` | 选中 / 取消选中时回调(`u` 是档案或 `null`;`phase` 是 `start` 起飞 / `arrive` 快到) | 窗下卡片跟着高亮;地址栏跟着改 |
| `layout()` | 返回 `{x, y}`:选中时星球往左 / 往上挪多少 | 桌面 `{x:0.17}`(右边是窗内档案卡);手机 `{y:0.26}`(档案卡是窗里的底部抽屉) |
| `wheelZoom()` | 返回 `false` 时普通滚轮留给页面滚动,按住 Ctrl 才缩放 | 不全屏时 `false`,全屏时 `true` |
| `onReady()` | 第一帧画好 | 淡出「星图载入中」 |
| 返回值 `api.fly(no)` / `api.home()` / `api.resize()` | 从外面控制 | 点卡片 → 先把窗户滚到眼前再 `fly`;切全屏 / 切回板块后 `resize` |
另外:画面滚出视口时自动暂停渲染(省电);手机上星图里的手势全归星图(`touch-action:none`:单指转、双指缩放,页面不会跟着滑),窗户只占屏幕约 64%,上下留了滑页面的地方,窗下有一句提示。
星图起不来(没有 WebGL)时,窗里显示原因,下面的世界线卡片照常能看。
## 7. 改了什么(相对原门户)
删掉:启动仪式(逐字 / 权限扫描 / 欢迎)、宇宙首屏的晶体线框画布(CrystalView)、盘符机架(抽插 / 读盘舱 / 键盘翻页)、两枚只给插卡用的图标(`--icd-logo` 白标、`--icd-people` 火柴人)。
保留:首页右侧的晶钻徽记、`#0001` / `#rack` 旧链接(分别飞到那条世界线 / 打开宇宙板块)。
---
## 8. 性能
- 桌面:4.2 万星点 + 32 片星云 + 14 颗散落星球 + 11 个星系(含卫星)。手机:3.6 万星点 + 28 片星云 + 14 颗(为了和桌面画面一致,只少一点点)。
- ⚠️ **帧率还没在真机上测过**(只在无头浏览器的软件渲染里验证了画面和交互),上线前请用一台普通手机和一台集显笔记本各打开看一下。
- 手机像素比上限 1.5;星点大小按镜头距离补偿,手机和桌面看起来一样密。
- 每颗星球一个绘制调用(加描边、大气各一个),没有实时阴影、没有后处理。
- 卡的话按第 2 节降粒子数;再不行把 `planets.js` 里球体的 `SphereGeometry(r, 96, 64)` 降到 `(r, 48, 32)`。
## 9. 版权
- three.js:MIT(`vendor/three-LICENSE.txt`)。
- 噪声函数:Ashima Arts / Stefan Gustavson 的 3D simplex noise(MIT),写在 `planets.js` 里。
- 星球、星云、星点:全部程序生成,无外部素材。
- 上一版用过的 NASA 星球贴图已经全部撤掉(不再需要署名)。
## 10. 部署注意(踩过的坑)
- 静态文件可能被缓存。**改了 JS / CSS 一定要换版本号**,四处一起换:`portal/index.html` 里的 `universe.css?v=`、`config.js?v=`、底部模块脚本里的 `galaxy.js?v=`,以及 `galaxy.js` 里的 `import './planets.js?v='`。
2026-10-05 踩过:一个坏掉的 galaxy.js 被缓存住,修好之后打开还是「加载不出来」。
- 检查语法要按 ES 模块检查(把文件拷成 `.mjs` 再 `node --check`),按普通脚本检查会漏掉「重复声明」这类错误。
+21
View File
@@ -0,0 +1,21 @@
The MIT License
Copyright © 2010-2024 three.js authors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
File diff suppressed because one or more lines are too long
Binary file not shown.
+135 -1340
View File
File diff suppressed because one or more lines are too long
+353
View File
@@ -0,0 +1,353 @@
# 金钻客栈 · 2026-10 总交接文档(前端 + 后端)
> 这一份把 2026-10-05 这一轮**前后端所有改动**、**功能增删**、**设计规范**、**业务逻辑**和**部署运维**写在一处。
> 细节文档还在各自目录里(位置见第 1 节),这份是总目录 + 总说明。
>
> 占位值一律保持原样:`example.com` / `shop.example.com`、`123456789`、`备案号(已移除)`、`(本机路径)`、`<DATA_DIR>` / `<APP_DIR>` / `<WORKER_DIR>` / `<WIN-PATH>` 等。
> 署名不动(「苏达 · 大肥鱼」)。本文不含任何密钥、真实地址或截图。
---
## 目录
1. [仓库里有什么](#1-仓库里有什么)
2. [变更清单(按提交)](#2-变更清单按提交)
3. [功能增加 / 删除一览](#3-功能增加--删除一览)
4. [⚠️ 接口与数据格式变更(单独列)](#4-️-接口与数据格式变更单独列)
5. [设计规范](#5-设计规范)
6. [业务逻辑](#6-业务逻辑)
7. [部署与运维](#7-部署与运维)
8. [测试与验证](#8-测试与验证)
9. [已知未验证 / 待确认](#9-已知未验证--待确认)
---
## 1. 仓库里有什么
| 目录 / 文件 | 是什么 | 细节文档 |
|---|---|---|
| `portal/` | 门户(整个网站):首页 / 画展 / 工具与开源 / 金钻宇宙 / 平台入口 / 关于,单文件 `index.html` + 资源 | 本文第 5、6 节;`portal/assets/universe/交接说明.md`(星系图) |
| `order/` | 自助模板渲染(下单页)`index.html` + `skincheck.js` | 本文第 6.2 节 |
| `backend/backend-site/` | 网站后端:`server.py`(全部服务端逻辑)、`store.py`(数据库)、`admin.py`(命令行管理)、`pngcheck.py`(PNG 结构核验)、`tests/` | `backend/backend-site/交接说明.md`、`回执-Claude.md` |
| `backend/backend-tools/` | 店主电脑上的一整套:渲染机 `ys_worker.py`、开单后台 `ys_admin.py`、本机开单 `ys_local.py` + `local.html`、Blender 出图脚本 `make_order.py`、各种启动脚本 | `backend/backend-tools/交接说明.md`、`回执-Claude.md` |
| `backend/模板/` | 三个 Blender 模板工程(测试用) | `backend/模板/说明.md` |
| `backend/deploy/` | 反向代理路由与限流片段 | `backend/deploy/nginx-片段.md` |
| `backend/他应该知道的.md` | 生意背景 / 机器约束 / 数据边界 / 术语表 | — |
| `交接说明.md`(根目录) | 11eb16c 那一轮视觉改版的说明(**部分已过时**,以本文为准) | — |
---
## 2. 变更清单(按提交)
时间顺序。哈希以 `git log` 为准。
### 2.1 `11eb16c` · 前端 2026 改版「白光藏色 × MC 方块」
- 删掉上一轮的暗色覆盖块 `redesign-2026`(反馈不好看)。
- 两页 `</body>` 前新增 `<!-- jz-2026:start -->…<!-- jz-2026:end -->`:手机底栏 HTML + `<style id="jz-2026">` + `<script id="jz-2026-js">`;下单页 `<body>` 开头另加一段跟门户一样的顶栏。
- 浅色配色、流动淡彩背景(WebGL,降级为静态渐变)、MC 方块按钮、像素标题字(缝合像素字体子集,OFL)。
- 门户顶栏加「自助渲染」入口;手机端底部物品栏导航 + 「更多」面板(像开关一样再点就收)。
- 下单页页头改版;四段进度条 `.prog` 用 CSS 隐藏(DOM 和逻辑都还在)。
- 修了「工具与开源」卡片正文被挤成一指宽的问题。
- 这一轮**没改**任何原有 `<script>` / `<style>` 块(逐块比对过)。详见根目录 `交接说明.md`。
### 2.2 `651d21d` · 后端复查修复 + 回执
外部复查找到的问题,按会丢钱 / 丢数据的先修:
| 问题 | 改法 |
|---|---|
| 同一张码并发提交能成两单 | 查码和绑码放进同一把锁(`redeem_bind`) |
| 卡密规则只信前端报的张数 | 按 `max(前端张数, 实际模板数)` 和模板并集校验;不认识的模板 key 直接拒 |
| 爱发电回调重放 / 改单号能多发码、多激活 | 处理过的平台单号一律原样回;回调和账本读写串行(`HOOK_LOCK`) |
| `admin.py` 和服务器同时改 `codes.json` 互相覆盖(实测 200 张丢 185 张) | `LOCK` 加跨进程 `flock`;写文件用唯一临时名 + `fsync` |
| `sweep` 会删掉还在排队 / 等确认的单 | 只清走完流程的单 |
| 卡密 / 单号 / 取件码用 `random` 生成(可预测) | 改 `secrets` |
| 重渲换皮肤不过 PNG 核验 | 走同一套核验 |
| 反馈接口能灌爆磁盘和通知 | 限频 + 磁盘闸 + 只收图片 |
| 下载整个读进内存 | 边读边发;zip 同一时间只打一个 |
| 部分失败静默标「已完成」 | 记 `partial`,通知店主,页面说实话 |
| `H.finish` 和框架方法重名 | 改名 `finish_upload`(接口路径不变) |
| 本机开单工具接受任意来源的 POST | 只认本机页面(Host / Origin 校验) |
附 `tests/回执复现测试.py`(27 条;原版 13 条失败,改后全过)。
### 2.3 `51212a0` · 接入 SQLite + 开单后台重写
- 新增 `store.py`:卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态进 `<DATA_DIR>/ys.db`;第一次启动自动建库并导入旧 JSON(旧文件不动)。
- `server.py` / `admin.py` 的存取换到库上,路由逻辑不变;`calls.jsonl` 照旧追加(手机通知读它)。
- 管理接口新增 `calls` / `call-done` / `retry`,`codes` 加 `q` 搜索。
- `admin.py db check / backup / export`。
- `ys_admin.py`(开单后台)页面按功能重写:待处理 / 订单 / 卡密 / 福利券 / 呼叫·反馈 / 开单工具。
- 新增 `tests/数据库测试.py`(现编假数据)。
### 2.4 `3ae940d` · 本机开单页面重写
`backend-tools/local.html` 换成跟网站 / 后台同一套样子;补上原来没写样式的分辨率选择、没绑事件的「清空」;整页接收拖拽;按勾选顺序标号;预计耗时。`ys_local.py` 没动。
### 2.5 本次提交 · 金钻宇宙换成星系图 + 推送前审查
- 门户「金钻宇宙」板块:**删掉**启动仪式、宇宙首屏晶体、盘符机架、读盘舱;**换成**星系图(three.js,懒加载)+ 窗下世界线卡片。
- 世界线数据只剩一份:`portal/assets/universe/config.js`(主脚本也读它)。
- 像素字子集按新文字重做(并保留了原来所有字)。
- 审查修掉的后端问题:`add_call` 写库失败会打断渲染机回传;多进程同时首启会重复导入呼叫记录;撤销「处理过了」没清时间。数据库测试加一条,共 38 条。
- 本文档。
---
## 3. 功能增加 / 删除一览
### 增加
| 在哪 | 功能 |
|---|---|
| 门户 · 金钻宇宙 | 星系图:旋臂星系 + 星云 + 扇区 + 补给线;每条世界线一颗卡通星球(材质按设定:晶体 / 铅笔纸面 / 冰封 / 霓虹 / 善恶两半);点星系或下面卡片飞过去,档案卡和星球同时落定;五种运镜(推进 / 放大 / 升空俯冲 / 跃迁 / 绕行);全屏;`#0001` 深链可分享 |
| 门户 · 全站 | 「自助渲染」入口;手机底部物品栏 + 「更多」面板;流动淡彩背景 |
| 下单页 | 跟门户一致的顶栏 / 底栏 |
| 后端 | SQLite 数据库(自动建库、自动导入、导出回退、热备份、体检) |
| 后端 · 管理接口 | 呼叫记录列表、标「处理过了」、失败单退回重渲、卡密搜索 |
| 开单后台 | 待处理首页(要动手的事集中在一页)、订单搜索、卡密搜索 / 停用 / 启用 / 改张数、订单备注、呼叫·反馈页、失败单「退回重渲」按钮 |
| 本机开单 | 分辨率选择样式、清空、整页拖拽、出图顺序标号、预计耗时、复制买家说明 |
### 删除
| 在哪 | 删了什么 | 为什么 |
|---|---|---|
| 门户 · 金钻宇宙 | 启动仪式(逐字 / 权限扫描 / 欢迎)、宇宙首屏晶体线框(`CrystalView`)、盘符机架(抽插 / 拖拽 / 导轨)、读盘舱(特写弹窗 / 拆解 / 翻页)、两枚只给插卡用的图标(白标 `--icd-logo`、火柴人 `--icd-people`)、相关 CSS | 被星系图取代;店主说机架「丑死了」 |
| 门户 · 装饰 | 英文 kicker、遥测数字条、时钟、`LINK // 已同步`(CSS 隐藏,DOM 还在) | 文案要说人话 |
| 下单页 | 四段进度条(CSS 隐藏,逻辑还在) | 店主觉得难看 |
| 前端 | 上一轮暗色覆盖块 `redesign-2026` | 不好看 |
保留:首页右侧晶钻徽记、`#0001` / `#rack` 旧链接(分别飞到那条世界线 / 打开宇宙板块)。
---
## 4. ⚠️ 接口与数据格式变更(单独列)
> 规矩:动了接口路径、请求 / 响应字段、数据格式的,必须单独标出来 —— 渲染机是另一台机器上的另一份代码,两边对不上会静默出不来图。
| 类别 | 变更 | 影响谁 |
|---|---|---|
| **数据格式** | 卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态从 JSON 文件挪进 `<DATA_DIR>/ys.db`。第一次启动自动导入,旧文件原样留着;`admin.py db export` 能导回旧格式 | 服务器、`admin.py`。**渲染机不受影响** |
| 新增接口 | `GET /api/admin/calls`、`POST /api/admin/call-done`、`POST /api/admin/retry` | 开单后台(新按钮要它们:**服务器先升级**) |
| 接口加参数 | `GET /api/admin/codes?q=`(可选,不传和以前一样) | 开单后台 |
| 新增字段 | `/api/claim` 回的订单里多一个 `terms_v`(只增不减) | 渲染机可以不理 |
| 开单后台本机接口 | 新增 `/api/codes` `/api/calls` `/api/retry` `/api/note` `/api/code-edit` `/api/call-done`(都要 PIN,原样转服务器) | 只有面板页面自己用 |
| 前端 | 门户的 `#rack` / `#bay` DOM 与 `window.__icd.open/close/flip/tray` 调试钩子删了;新增 `window.__jzUniverse.show()/fly(no)` | 只有页面自己和自动化脚本 |
**没变**:所有买家接口、渲染机接口的路径和字段;本机开单的本机接口。
---
## 5. 设计规范
### 5.1 一句话
**白光藏色 × Minecraft 方块**:一眼看过去是白的,颜色藏在亮部和缓慢流动的淡彩光里;按钮是 MC Ore UI 那种方块按钮;标题用像素字;正文用 OPPO Sans。
### 5.2 颜色 token(门户 / 下单页写在 `jz-2026` 块的 `:root`;后台 / 本机开单各自复制一份)
| 用途 | 变量 | 值 |
|---|---|---|
| 页面底色 | `--bg` | `#F5F7FB` |
| 正文墨色(深→浅) | `--ink` / `--txt` · `--txt-2` · `--txt-3` · `--txt-4` | `#1E2440` · `#454B6B` · `#676D8A` · `#858AA2` |
| 发丝线 | `--line` / `--line-soft` | `rgba(30,36,64,.12)` / `.08` |
| 主色(草方块绿) | `--mc-green` / `-hi` / `-lo` | `#3C8527` / `#5BAA3C` / `#1D4D13` |
| 次按钮(石头白) | `--stone` / `--stone-lo` / `--stone-edge` | `#F3F4F6` / `#B4B7BE` / `#9EA2AA` |
| 面板 | `--panel-shadow` + 半透明白 | `inset 0 1px 0 #fff, 0 22px 44px -28px rgba(100,110,190,.38)`;底 `rgba(255,255,255,.74~.9)`,2px 白边 |
| 警告 / 错误文字 | `--warn-t` / `--bad-t` | `#9A6A0C` / `#B33A2E` |
| 首页板块卡的「矿石色」 | `--zc` | 画展金 `#F2C14D`、工具蓝 `#4F86E8`、宇宙紫 `#9A6BE0`、平台绿、关于红(只在悬停时从边缘亮出来) |
| 背景彩光 | `body::before` 四团 radial-gradient | 天蓝 / 粉 / 杏 / 薄荷,透明度 .22~.30;有 WebGL 时换成 `#jzBg` 流动彩光 |
| 星系图(唯一的深色区域) | `config.js → GALAXY.colors` | 深海军蓝 `#070B1C` + 蓝紫星云 + 一点青 + 暖金 `#FFD36E`(名牌 / 数字) |
### 5.3 字体
- **标题**:`JZ Pixel` = 缝合像素字体 12px(TakWolf,SIL OFL 1.1),**只含页面用到的字**(子集)。门户 `portal/fonts/jz-pixel-12.woff2`,下单页 `order/assets/jz-pixel-12.woff2`,协议原文在同目录。12 的整数倍字号最清楚,`-webkit-font-smoothing:none`。
- **正文**:OPPO Sans(可免费商用)。
- **加了新字(比如新世界线名字)要重做子集**,否则那几个字会掉回系统字体:
```
# 文本 = 旧子集里已有的字 ∪ 页面 + config.js + galaxy.js 里所有字(只加不减)
python3 -m fontTools.subset fusion-pixel-12px-proportional-zh_hans.otf.woff2 \
--text-file=字表.txt --flavor=woff2 --layout-features='*' --output-file=portal/fonts/jz-pixel-12.woff2
```
源字体从 fusion-pixel-font 的 release 取(12px proportional zh_hans)。
### 5.4 组件
| 组件 | 规则 |
|---|---|
| 按钮 | **全站统一一种**:MC 方块,`border-radius:4px`,2px 边,上亮下暗的内阴影;按下下沉 2px。绿 = 主操作,石头白 = 次操作,红字 = 危险操作(注销 / 停用 / 收摊) |
| 卡片 / 面板 | 半透明白 + 2px 白边 + `--panel-shadow`,圆角 8px(大块 12px)。**只有吸顶顶栏用 `backdrop-filter`**,面板不用(卡、而且显得死板) |
| 标签 / 状态 | 色块小标签(4px 圆角、浅底深字):绿 = 通过 / 已完成,黄 = 注意,红 = 失败,蓝 = 进行中,灰 = 停用 |
| 输入框 | 白底、2px 线、聚焦变绿 |
| 动效 | 只动 `transform` / `opacity`;缓动 `cubic-bezier(.23,1,.32,1)`;尊重 `prefers-reduced-motion` 和页面上的「动效」开关 |
### 5.5 移动端规则
- 窄屏(≤760 / 860px):顶栏只留 logo 和开关;底部浮动物品栏(首页 / 画展 / 渲染〔中间钻石〕 / 宇宙 / 更多),「更多」从底栏上方弹出一排格子,再点同一个按钮 / 点空白 / 返回键 / Esc 收起。
- 左右边距 16px 左右;**任何页面不许横向滚动**(每次改完都要在 390 宽度下检查)。
- 星系图在手机上:星图里的手势全归星图(拖动转、双指缩放,页面不跟着滑),窗户只占屏幕约 64%,上下留出滑页面的地方;档案卡是窗里的底部抽屉,星球挪到上半个窗。
### 5.6 口味禁区(每条都是看过预览之后的直接反馈)
- **不要暗色面板**、不要黑白强对比(星系图窗户是唯一例外);不要复古风。
- **文字 / 标题 / 名牌前面不要放小圆点、小方块色点**。
- 不要按钮扫光动画;不要六边形「三棱镜」按钮;全站按钮一个样子。
- 星系图:不要星球光环、不要每颗星外面一层大气「罩子」、辉光不能过曝;颜色只用那一套(深蓝 + 蓝紫 + 金),不要彩虹;装饰星球不能互相重叠、卫星不能反着转;开场 / 飞行运镜要连贯,档案卡要跟星球落定同时出来。
- 流动大背景要平滑,不要像素化;像素风只留在字、按钮、粒子上。
- **文案说人话**:不写「标签 · 解释」式的说明、不加英文小字装饰、不写解释界面怎么用的句子。
- 改一块就只动那一块,不要顺手改邻居(比如改顶栏时别动头图);小步改。
---
## 6. 业务逻辑
### 6.1 网站全貌
金钻客栈 = 一个线上「客栈」:画展、工具与开源、金钻宇宙、各平台入口都在里面;**自助模板渲染只是其中一家店**。
| 门户板块 | 内容 | 数据在哪 |
|---|---|---|
| 首页 | 欢迎首屏 + 五个板块卡 | `BOARDS` |
| 画展 | 图片 / 视频 / 全景 / 动态壁纸,按时间排、可筛选(脱敏版只有一张占位) | `GALLERY` + `hd_cache/manifest.json` |
| 工具与开源 | 开源一行 / 闭源一行,按类型筛选 | `APPS` |
| 金钻宇宙 | 星系图 + 世界线档案(0000 零号主宇宙、0001–0004 已点亮、0005–0010 空槽) | `portal/assets/universe/config.js` |
| 平台入口 | 视频 / 图文 / 模型创作 / 开源 / 小店 / 联系,外链新窗口打开 | `LINK_GROUPS` + `LINKS` |
| 关于 | 制作者、开源组件鸣谢、名字由来 | 静态 HTML |
路由:`#/板块`(单页切换,无整页刷新);`#0001` 这种编号直接飞到那条世界线;`#rack` 兼容到宇宙板块。
**加一条世界线**:`config.js` 里把空槽换成完整档案(`no / name / kind / tag / tags / desc`)+ 在 `LOOKS` 里给它一个外观(`style / r / orbit / accent / moons / enter`);名字里有新字记得重做像素字子集(5.3);改了 JS 要换版本号(7.2)。细节见 `portal/assets/universe/交接说明.md`。
### 6.2 下单页(`order/`)
两条路:
```
网页下单:传皮肤(本地质检)→ 选模板 / 分辨率 → 出订单号(待付款)→ 去爱发电付款
→ 爱发电回调确认 / 店主后台激活 → 排队 → 渲染机出图 → 买家看 512 预览 → 确认收货 → 下原图
卡密下单:传皮肤 → 填卡密(自动认模板 / 张数)→ 直接排队 → 出图 → 同上
凭票取图:拿单号 + 取件码(或卡密)回来看进度、下载
```
皮肤质检(`skincheck.js`,前端和本机开单共用):尺寸是否 64 网格的正方形、像素风检查、主体层完整、半透明、外层铺满、手臂粗细判定;PNG 结构核验防夹带(尾部追加 / 未知关键块 / APNG)。服务器落盘前还会再核一遍(`pngcheck.py`)并剥掉元数据块。
### 6.3 订单状态机
```
unpaid(待付款)──买家点「我付好了」──▶ paid(待激活)
│ │
└──── 爱发电回调确认 / 后台激活 / 买家用卡密激活 ───┘
▼
waiting(排队中)──渲染机 claim──▶ working(渲染中)
▲ │
后台「退回重渲」/ admin.py retry 一张一次 /finish 回传
│ ▼
failed(失败)◀── 水印没生成 ── done(已完成)
unpaid / paid ──后台注销──▶ void(已注销,不占卡密)
```
- 领单超过 45 分钟没交回 → 自动退回队列。4096 的「重单」高峰期给小单让路,最多让 30 分钟(防饿死)。
- 收满张数才算完成;渲染机显式收单但没收满 = **部分失败**:记 `partial`、页面说实话、通知店主。
- 预览水印没做出来的不许标完成(标 `failed`,等退回重渲)。
- 成品保留 72 小时(从开放下载算);`admin.py sweep` 清理时**先核销卡密再删文件**,排队 / 渲染中 / 待激活的单绝不删。清理后库里那一行留着做账。
### 6.4 卡密生命周期(**激活 ≠ 核销**)
```
active(可用)──买家提交──▶ bound(已激活:被这一单占住,还没核销)──开放下载满 72 小时──▶ used(已核销,终态)
inactive(停用:网页单等付款 / 手动停用)
```
卡密种类:固定 N 张 / 最多 N 张 / 不限张数;可锁模板;「直发」= 店主自己发的码,不用等确认收货。
防暴破:码空间 31¹² ≈ 7.9e17;同 IP 连错 15 次冷却 15 分钟;单 IP 10 分钟最多开 6 单。
### 6.5 爱发电回调
不验签(没有对方公钥),改成**拿开放接口反查这笔单**。处理顺序:
① 标题含「测试」只记账 → ② 同一平台单号重推:原样回上次结果(幂等)→ ③ 反查不到 / 没付款:只记账、标人工,**绝不发码** → ④ 金额:少付拦死、多付照常但记一笔 → ⑤ 认单:自定义订单号 > 留言里的卡密 > 留言里的单号 > 「只有一笔待付款单金额对得上」(两笔以上一律人工)。
### 6.6 渲染机(店主电脑,`ys_worker.py`)
只出站:定时 `claim`(领单)+ 独立线程 `hb`(心跳,默认 10 分钟一次,`hb_every`)→ 取皮肤 → Blender 后台渲染(**同一时刻只允许一个 Blender**)→ 中途 `progress` → 一张一次 `finish` 回传。心跳超过 1500 秒没更新 = 页面显示离线(所以 `OFFLINE_AFTER` 必须大于心跳间隔,两边一起改)。心跳顺带记下家里的出口 IP,管理接口只认这个 IP。
### 6.7 福利券
一批「免费、已激活」的码放在福利页让人自取:**每台设备 + 每个网络各限领 1 张**(服务器硬规则),领到后 N 天内要用;可锁模板、限张数、定种类(渲染图 / 立牌 / 钥匙扣 / 海报)、到期自动收摊;收摊后已领走的照常能用。
### 6.8 开单后台(`ys_admin.py`,店主电脑,局域网)
- PIN 锁(服务端校验,加盐 sha256,12 小时免输);调服务器管理接口要「令牌 + 家里出口 IP」两道门。
- 六页:**待处理**(买家说付好了的单、渲染失败的单、没处理的呼叫)/ 订单 / 卡密(生成 + 库)/ 福利券 / 呼叫·反馈 / 开单工具。
### 6.9 本机开单(`ys_local.py` + `local.html`)
给聊天里成交的平台单用:拖皮肤 → 同一套质检 → 勾模板 → 本机 Blender 出图 → 下载 / 打开留档文件夹。**不联网、不上传、不要卡密**,只监听本机,只认本机页面。
### 6.10 数据库
见 `backend/backend-site/交接说明.md` 第五节。要点:`ys.db` 里 5 张表(codes / orders / pay_orders / calls / kv),每张「能查的列 + 一列整条 JSON」;上层代码拿到的还是原来的 dict;`.lock` 文件锁照旧;WAL 模式。
---
## 7. 部署与运维
### 7.1 文件放哪
| 文件 | 放到 | 备注 |
|---|---|---|
| `portal/**` | 网站根目录 | 星系图要 `assets/universe/` 和 `assets/vendor/` 一起上 |
| `order/**` | 网站 `/order/` | |
| `server.py` + **`store.py`** + `admin.py` + `pngcheck.py` | `<APP_DIR>`(同一目录) | `server.py` 直接 `import store`,**少了 `store.py` 服务起不来** |
| `backend-tools/*` | 店主电脑 `<WORKER_DIR>` | `deploy.py` 推送;面板新按钮依赖服务器新接口,**先升服务器** |
### 7.2 缓存与版本号
- 门户星系图:改了 JS / CSS 要换版本号,**四处一起换**:`portal/index.html` 里 `universe.css?v=`、`config.js?v=`、底部模块脚本里 `galaxy.js?v=`,以及 `galaxy.js` 里 `import './planets.js?v='`。踩过:坏文件被缓存住,修好了打开还是「加载不出来」。
- 检查 ES 模块语法要拷成 `.mjs` 再 `node --check`(按普通脚本查会漏「重复声明」)。
- three.js 只在第一次打开「金钻宇宙」时下载(约 690KB,gzip 后约 170KB)。
### 7.3 数据库命令
```
python3 admin.py db check # 完整性 + 每张表几行 + 按状态计数
python3 admin.py db backup # 在线热备份到 <DATA_DIR>/backup/
python3 admin.py db export [目录] # 导回旧版 JSON(回退用)
```
回退:停服务 → `db export` → 换回旧版 `server.py` / `admin.py` → 启动。再切回来:挪走 `ys.db`,新版启动时从 JSON 重新导入。
权限:跑 `admin.py` 的账号要对 `<DATA_DIR>` **目录**有写权限(WAL 会建 `ys.db-wal` / `-shm`)。
### 7.4 常用
```
python3 admin.py ls waiting # 看排队
python3 admin.py retry <单号> # 失败单退回(后台也有按钮)
python3 admin.py calls # 呼叫记录(后台也有页面)
python3 admin.py sweep # 清过期成品 + 核销(建议每天跑一次)
```
---
## 8. 测试与验证
| 测试 | 怎么跑 | 结果(2026-10-05) |
|---|---|---|
| 后端回归 + 漏洞复现 | `python3 backend/backend-site/tests/回执复现测试.py <server.py 所在目录>` | 27 / 27 |
| 数据库专项 | `python3 backend/backend-site/tests/数据库测试.py <server.py 所在目录>` | 38 / 38 |
| 开单后台 | 假数据起真服务器 + 真面板,headless 浏览器电脑宽 / 手机宽点全部页面 | 无报错、无横滚;无 PIN → 401、无令牌 → 403 |
| 本机开单 | 假本机服务(模拟渲染)+ headless 浏览器走完整流程 | 无报错、无横滚 |
| 门户 | headless 浏览器 1366 / 390:六个板块都切一遍;宇宙:星图就绪、点卡片飞过去出档案、`#0002` 深链、全屏开关、手机上拖星图页面不滚;首页不下载 three.js | 全过;除星系图板块外,其余板块和改动前**逐像素一致** |
| 下单页 | 打开截图 | 正常(本轮没改) |
后端测试数据全是测试脚本现编的,建在系统临时目录。⚠️ 交付副本里三个 URL 格式串被脱敏成 `http<WIN-PATH>`,要起服务器的测试得先在**测试副本**里换成能格式化的占位(这三处分别吃 1 / 2 / 0 个参数);线上原版直接跑。
---
## 9. 已知未验证 / 待确认
- **星系图帧率没在真机上测过**(只在无头浏览器的软件渲染里验证了画面和交互)。上线前用一台普通手机、一台集显笔记本各打开看一下;卡的话按 `universe/交接说明.md` 第 8 节降粒子数。
- **数据库没在真机器上跑过**(1.6G 内存 + systemd 内存上限)。部署后先跑一次 `admin.py db check`。
- 渲染机、真实 Blender、爱发电真实回调、手机通知脚本(读 `calls.jsonl` 的那段不在仓库里)都没有端到端测过。
- 下单页里的链接是站点根路径(`/#/home`、`/order/`),本地从仓库根目录起服务时「首页」会跳到仓库根,线上没问题。
- 署名按要求没改(「苏达 · 大肥鱼」)。
+3
View File
@@ -1,5 +1,8 @@
# 交接说明 · 金钻客栈 2026 视觉改版(白光藏色 × MC 方块) # 交接说明 · 金钻客栈 2026 视觉改版(白光藏色 × MC 方块)
> ⚠️ 这一份只讲 `11eb16c` 那一轮视觉改版。之后「金钻宇宙」板块换成了星系图(这次改了门户原有的 JS,下面「原有脚本一字未改」那句对门户已不成立),后端也接了数据库。
> **完整的、最新的情况以根目录 `交接文档-2026-10.md` 为准。**
## 一句话 ## 一句话
两个页面换成了**浅色的「白光藏色」+ Minecraft 方块风**:整体一眼是白的,颜色藏在亮部和流动的淡彩背景里;按钮是 MC Ore UI 那种方块按钮;标题换成像素字;手机端换成底部物品栏导航。 两个页面换成了**浅色的「白光藏色」+ Minecraft 方块风**:整体一眼是白的,颜色藏在亮部和流动的淡彩背景里;按钮是 MC Ore UI 那种方块按钮;标题换成像素字;手机端换成底部物品栏导航。