portal: 金钻宇宙换成星系图(three.js 懒加载)+ 推送前审查 + 总交接文档
- 门户「金钻宇宙」:删掉启动仪式 / 宇宙首屏晶体 / 盘符机架 / 读盘舱及其 CSS、图标; 换成星系图(portal/assets/universe/,three.js r170 自托管于 assets/vendor/,第一次打开板块才下载) + 窗下世界线卡片;#0001 深链飞到对应世界线;世界线数据只留 config.js 一份 - 像素字子集重做(旧字全保留 + 新字);其余板块与改动前逐像素一致 - 后端审查:add_call 写库失败不再打断渲染机回传;多进程同时首启只导入一次(+1 条测试,共 38); 撤销「处理过了」清掉 handled_at - 交接文档-2026-10.md:变更清单 / 功能增删 / 接口与数据格式变更 / 设计规范 / 业务逻辑 / 部署运维 - 交付清单哈希重算;README、旧交接说明指路 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -11,6 +11,8 @@
|
||||
| `portal/` `order/` | 门户与下单页(前端) | 上一批(视觉重设计) |
|
||||
| **`backend/`** | **网站后端 + 本地自助管理后台 + 测试用 Blender 工程 + 部署层片段** | **本批** |
|
||||
|
||||
> **总交接文档:`交接文档-2026-10.md`**(2026-10 这一轮前后端所有改动 / 功能增删 / 设计规范 / 业务逻辑 / 部署运维)。
|
||||
>
|
||||
> 看后端请从 **`backend/他应该知道的.md`** 开始读(生意背景 / 机器约束 / 数据边界 / 术语表),
|
||||
> 再进 `backend/README.md` 和两份交接说明。
|
||||
> 写回执照 **`backend/回执模板.md`** 填。
|
||||
|
||||
@@ -9,6 +9,8 @@
|
||||
|
||||
## 怎么读这份包(建议顺序)
|
||||
|
||||
> 2026-10 这一轮(数据库、开单后台 / 本机开单重写、前端星系图)的总说明在仓库根目录 **`交接文档-2026-10.md`**。
|
||||
|
||||
| 顺序 | 读什么 | 为什么先读它 |
|
||||
|---|---|---|
|
||||
| 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** |
|
||||
|
||||
@@ -736,7 +736,11 @@ def add_call(rec):
|
||||
数据库 calls 表是正本(后台和限频都查它);**同时照旧追加一行到 calls.jsonl** ——
|
||||
手机通知那边是盯着这个文件的(那段不在这份代码里),不能让它断。
|
||||
"""
|
||||
STORE.call_add(rec)
|
||||
# ⚠️ 这条也会在渲染机回传(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")
|
||||
@@ -3433,8 +3437,9 @@ class H(BaseHTTPRequestHandler):
|
||||
cid = int(d.get("id"))
|
||||
except (TypeError, ValueError):
|
||||
return self.err("没有这条记录", 404)
|
||||
if not STORE.call_mark(cid, handled=not d.get("undo"),
|
||||
handled_at=now().isoformat(timespec="seconds")):
|
||||
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})
|
||||
|
||||
|
||||
@@ -318,6 +318,10 @@ class Store(object):
|
||||
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)"
|
||||
|
||||
@@ -14,7 +14,7 @@
|
||||
7. 导出旧版 JSON → 再导入新库,数据一模一样(回退路径能用)
|
||||
8. 热备份能打开、行数一致;完整性检查 ok
|
||||
9. 服务器直接在「迁移过来的老数据」上跑:老订单能查、老卡密能认、admin.py db / calls / ls 能用
|
||||
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢
|
||||
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢;三个进程同时第一次启动只导一次
|
||||
11. 规模:5000 张码 + 2000 单,按状态列订单的耗时
|
||||
"""
|
||||
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")]
|
||||
[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-")
|
||||
|
||||
@@ -53,7 +53,7 @@
|
||||
| `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG |
|
||||
| `store.py` | ~400 | **数据层**(2026-10-05 新增):SQLite 建库 / 第一次启动自动导入旧 JSON / 存取 / 导出回旧格式 / 体检 / 热备份 |
|
||||
| `tests/回执复现测试.py` | ~280 | 回归 + 漏洞复现(27 条,HTTP 层打接口) |
|
||||
| `tests/数据库测试.py` | ~290 | 数据库专项(37 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
|
||||
| `tests/数据库测试.py` | ~290 | 数据库专项(38 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
|
||||
|
||||
> 这几个文件是**自足**的:没有 import 本项目之外的模块。**部署时 `store.py` 必须和 `server.py` 放在同一个目录**(`server.py` 直接 `import store`)。
|
||||
|
||||
@@ -179,13 +179,13 @@
|
||||
### 5.6 测试
|
||||
|
||||
```
|
||||
python3 tests/数据库测试.py <server.py 所在目录> # 37 条:数据库专项
|
||||
python3 tests/数据库测试.py <server.py 所在目录> # 38 条:数据库专项
|
||||
python3 tests/回执复现测试.py <server.py 所在目录> # 27 条:回归 + 漏洞复现(现在跑在数据库上)
|
||||
```
|
||||
|
||||
- 数据全是测试脚本**现编的**(假卡密、假订单、假呼叫,包括一行写坏的 `calls.jsonl`),建在系统临时目录,不碰 `<DATA_DIR>`。
|
||||
- 交付副本里三个 URL 格式串被脱敏弄坏了(`http<WIN-PATH>`),要起服务器的那几节跑之前先换成能格式化的占位;线上原版直接跑。
|
||||
- 2026-10-05 结果:**64 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
|
||||
- 2026-10-05 结果:**65 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
|
||||
|
||||
### 5.7 文件 / 目录(库以外的)
|
||||
|
||||
|
||||
@@ -355,7 +355,7 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
|
||||
接口路径、请求 / 响应字段:没动。
|
||||
数据格式:**动了**(存储从 JSON 文件换成 SQLite)。第一次启动自动导入、旧文件不动,
|
||||
`admin.py db export` 能原样导回旧格式。calls.jsonl 照旧追加(手机通知要读)。渲染机不用动。
|
||||
你怎么验证的:tests/数据库测试.py 37 条(全新安装 / 迁移 / 重启不重导 / 只改变化的行 / 清理 / 回滚 /
|
||||
你怎么验证的:tests/数据库测试.py 38 条(全新安装 / 迁移 / 重启不重导 / 多进程同时首启只导一次 / 只改变化的行 / 清理 / 回滚 /
|
||||
导出再导入一致 / 热备份 / 服务器跑在迁移来的数据上 / 8 线程 + 2 进程并发 / 5000 码 2000 单规模);
|
||||
tests/回执复现测试.py 27 条照旧全过(现在跑在库上)
|
||||
```
|
||||
@@ -376,3 +376,9 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
|
||||
|
||||
- 没在你们的真机器(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` 没清 → 一起清掉。
|
||||
|
||||
+7
-7
@@ -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 |
|
||||
|---|---|---|
|
||||
| `README.md` | 8,543 | `ea8e0339caf30b69754f1c6ff28027c9615c43072c596406bc791b5801285eb3` |
|
||||
| `README.md` | 8,696 | `5cef368dbf5916def012dbfcf7fdfb35d1f435faf5a7b42b65f6ad683343b1c2` |
|
||||
| `backend-site/admin.py` | 26,020 | `d7f86dcf0b07962ceb55a7714b43c876628118d19159dc3a9215535db1bc47f7` |
|
||||
| `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` |
|
||||
| `backend-site/server.py` | 181,030 | `24f052fdab2fbc5eba345cc305810b33c05b44d01b7e749cd8804d28473f401e` |
|
||||
| `backend-site/store.py` | 18,948 | `283029b92e0bba8934c7075a4f3467784d7fde46104bd098eda23742f99a0158` |
|
||||
| `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` | 15,416 | `b9f420a353927da9e5c1bfaa9a130e5d50cae28dffd42712d9f9c42d2816f5f8` |
|
||||
| `backend-site/交接说明.md` | 21,795 | `80911c91d0623497c057de8374d41337ff75f4a937571b57486a7d2a319e9c70` |
|
||||
| `backend-site/回执-Claude.md` | 37,110 | `2f7fc60f48e99e7f07affcac16fe3d0ce2e8660738fbf954b89f2c00e638262f` |
|
||||
| `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` |
|
||||
|
||||
@@ -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