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

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yws
2026-10-05 17:31:36 +00:00
co-authored by Claude Opus 5.5
parent 3ae940d828
commit 09b229deee
19 changed files with 1444 additions and 1355 deletions
+67
View File
@@ -0,0 +1,67 @@
/* =============================================================================
* 金钻宇宙 · 星系图配置(config.js)—— 日常改动只改这一个文件
* -----------------------------------------------------------------------------
* 1. UNIVERSES :世界线的「档案内容」(和门户页原来的 UNIVERSES 字段一模一样,可以直接拷过来)
* 2. LOOKS :每条世界线在星系图上「长什么样」(星球风格、颜色、卫星、光环、在哪条旋臂上)
* 3. GALAXY :整个星系的配色、旋臂、粒子数量、扇区名
* 加一条新世界线 = UNIVERSES 里加一条 + LOOKS 里按编号加一条外观(不写外观就用「空槽」的样子)。
* ============================================================================= */
window.JZ_UNIVERSE = {
// ---------------------------------------------------------------- 1. 档案内容
UNIVERSES: [
{ no: '0000', name: '零号宇宙', kind: '主宇宙', tag: '晶钻超算主宇宙', tags: ['门户主宇宙', '晶钻超算', '多世界线演算'],
desc: '门户主宇宙,也是晶钻超算本体:把平行宇宙压成盘符,逐条演算多世界线。其余编号都是它演算出的分支世界线,零号自身负责总调度与收束。' },
{ no: '0001', name: '火柴人宇宙', kind: '原创', tag: '火柴人的冒险', tags: ['金钻原创', '小时候的课堂', '火柴人的冒险'],
desc: '金钻小时候在课上天马行空画出来的世界线,《火柴人的冒险》就从这里开始。' },
{ no: '0002', name: '极寒世界', kind: '原创', tag: '冰河时期', tags: ['金钻原创', '冰河时期', '那迦彗星', '五大深垒', '2056'],
desc: '2030年代确认北大西洋环流(AMOC)减弱、气候转入长期寒冷;2040年高含水彗星「那迦」撞击北大西洋,水汽化为冰晶云遮蔽日照,冰河期开始。故事发生在2056年,冰河已持续16年,地表约-50℃(极端-90℃)。人类转入五大地下深垒。' },
{ no: '0003', name: '没落赛博城', kind: '二创', tag: '史蒂夫的探险之旅', tags: ['二创', '史蒂夫的探险之旅', '赛博废墟'],
desc: '金钻刚接触动画时随手做的二创世界线:史蒂夫穿过没落的赛博城,一路探险。' },
{ no: '0004', name: '善恶等级', kind: '原创', tag: '设定待定', tags: ['金钻原创', '设定酝酿中'],
desc: '这条世界线的设定还在酝酿中,先留好位置,等金钻想清楚再填。' },
{ no: '0005', empty: true }, { no: '0006', empty: true }, { no: '0007', empty: true },
{ no: '0008', empty: true }, { no: '0009', empty: true }, { no: '0010', empty: true },
],
// ---------------------------------------------------------------- 2. 外观(按编号对应)
// style:crystal 晶体 / paper 铅笔纸面 / ice 冰封 / neon 霓虹城 / duality 善恶两半 / gas 气态 / rock 岩石 / ghost 未点亮
// orbit:[离星系中心多远, 第几条旋臂];moons:绕着它转的卫星(纯装饰,没有档案)
// enter:点开这颗星时的运镜 —— push 推进 / zoom 放大(长焦再推)/ rise 升空俯冲 / warp 跃迁 / orbit 绕行;不写就按顺序轮流
LOOKS: {
'0000': { enter: 'zoom', style: 'crystal', r: 2.6, orbit: [0, 0], accent: '#FFD36E',
why: '晶钻超算:多面体切面像钻石,内部有发光的演算脉络。',
moons: [{ style: 'crystal', r: 0.45, d: 5.0, speed: 0.35, colors: ['#BFF4FF', '#8E7BFF', '#FFE59A', '#FFFFFF'] },
{ style: 'rock', r: 0.32, d: 6.6, speed: 0.22 }] },
'0001': { enter: 'push', style: 'paper', r: 1.25, orbit: [20, 0], accent: '#F6F1E4',
why: '小时候课上画出来的:米白纸面、铅笔等高线、暗面排线、几个红笔圈。',
moons: [{ style: 'paper', r: 0.36, d: 2.6, speed: 0.6, colors: ['#FFF8EC', '#2B2E45', '#E5544B', '#F2C14D'] }] },
'0002': { enter: 'rise', style: 'ice', r: 1.35, orbit: [29, 1], accent: '#9FE3FF',
why: '冰河期地球:纬向冰带、厚极冠、冰裂纹;旁边那颗小卫星是「那迦」彗星残骸。',
moons: [{ style: 'rock', r: 0.3, d: 2.7, speed: 0.5, colors: ['#CFE6FF', '#8FB4E0', '#5C79B8', '#FFFFFF'] }] },
'0003': { enter: 'warp', style: 'neon', r: 1.4, orbit: [38, 2], accent: '#C9A6FF',
why: '没落的赛博城:深紫地表、霓虹街区网格、零星还亮着的窗灯。',
moons: [{ style: 'rock', r: 0.28, d: 3.0, speed: 0.42, colors: ['#3A2F66', '#2A2350', '#1A1535', '#FF5FD2'] },
{ style: 'neon', r: 0.22, d: 3.8, speed: 0.3 }] },
'0004': { enter: 'orbit', style: 'duality', r: 1.3, orbit: [46, 3], accent: '#FFD36E',
why: '设定还在酝酿,先按名字「善恶」做成两半:一半金色白昼,一半紫色夜空,交界一条发光的波浪线。设定定了再换。',
moons: [{ style: 'gas', r: 0.34, d: 2.8, speed: 0.45, colors: ['#FFF0C8', '#F2B84B', '#2D1E57', '#FFFFFF'] }] },
},
EMPTY_LOOK: { style: 'ghost', r: 0.75, accent: '#8E96C8' }, // 空槽的样子(未点亮的星系)
// ---------------------------------------------------------------- 3. 星系整体
GALAXY: {
radius: 60, arms: 4, twist: 0.11,
particles: { desktop: 42000, mobile: 36000 }, // 手机和桌面画面要一致:数量只略少一点
nebulae: { desktop: 32, mobile: 28 },
decorPlanets: { desktop: 14, mobile: 14 }, // 散落在旋臂上的无名星球(只是好看,不能点)
// 配色:深海军蓝底 + 蓝紫星云 + 一点青色 + 暖金色核心。整张图只用这几种颜色。
colors: {
bg: '#070B1C', core: '#FFE2B0', armInner: '#9DB4FF', armOuter: '#7C6BFF', accentStar: '#6FE3D6',
nebula: [['#2F4BD8', '#4FB8E8'], ['#4A35B8', '#7C6BFF'], ['#1C7A8C', '#4FD1C5'], ['#5B3FB8', '#9B8BFF']],
coreNebula: ['#FFC97A', '#B98CFF'], line: '#7F8BC8', ui: '#FFD36E',
},
intro: 'random', // 开场运镜:sweep 盘旋落下 / dive 垂直坠入 / random 每次随机
sectors: ['S-01 · 晨线', 'S-02 · 冰原', 'S-03 · 霓虹', 'S-04 · 衡天', 'S-05 · 未测绘', 'S-06 · 未测绘'],
},
};
+310
View File
@@ -0,0 +1,310 @@
/* =============================================================================
* 金钻宇宙 · 星系图引擎(galaxy.js)
* -----------------------------------------------------------------------------
* 读 window.JZ_UNIVERSE(config.js)→ 画旋臂星系、星云、扇区、补给线、星系(卡通星球 + 卫星)、
* 散落的无名星球;处理拖动 / 滚轮 / 双指缩放 / 点星系飞过去 / 档案卡。
* 只依赖 three.js 和 planets.js。挂载:mountGalaxy({ stage, canvas, labels, panel, ... })
* 嵌进普通页面时可选:
* onFocus(u|null) 选中 / 取消选中某条世界线时回调(页面下方的列表可以跟着高亮)
* layout() 返回 { x, y }:选中时星球往左 / 往上挪多少(屏宽 / 屏高的比例),给档案卡让位
* wheelZoom() 返回 true 时滚轮直接缩放;false 时只有按住 Ctrl 才缩放(嵌在页面里别抢页面滚动)
* 返回 { fly(no), home(), resize() }。画面滚出视口时自动暂停渲染。
* ============================================================================= */
import * as THREE from 'three';
import { makePlanet } from './planets.js?v=1';
export function mountGalaxy(el) {
const CFG = window.JZ_UNIVERSE, G = CFG.GALAXY, C = G.colors;
const { stage, canvas, labels, panel, back, hud } = el;
const reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
const isMob = () => stage.clientWidth < 760;
const MOB = isMob();
const renderer = new THREE.WebGLRenderer({ canvas, antialias: true, powerPreference: 'high-performance' });
renderer.setPixelRatio(Math.min(devicePixelRatio, MOB ? 1.5 : 2));
renderer.outputColorSpace = THREE.SRGBColorSpace;
renderer.setClearColor(C.bg, 1);
const scene = new THREE.Scene(), camera = new THREE.PerspectiveCamera(42, 1, 0.1, 2000);
const R = G.radius, ARMS = G.arms;
const rnd = (a = 0, b = 1) => a + Math.random() * (b - a);
const gauss = () => { let u = 0, v = 0; while (!u) u = Math.random(); while (!v) v = Math.random(); return Math.sqrt(-2 * Math.log(u)) * Math.cos(2 * Math.PI * v); };
const armAngle = (r, arm) => arm * Math.PI * 2 / ARMS + r * G.twist;
const LIGHT = new THREE.Vector3(-1, 0.55, 0.6).normalize();
// ============================================================ 旋臂星系(粒子)—— 星点大小有上限,离镜头很近的也不会糊成大光斑
const galaxy = (() => {
const N = MOB ? G.particles.mobile : G.particles.desktop, pos = new Float32Array(N * 3), col = new Float32Array(N * 3), sz = new Float32Array(N);
const cCore = new THREE.Color(C.core), cIn = new THREE.Color(C.armInner), cOut = new THREE.Color(C.armOuter), cAcc = new THREE.Color(C.accentStar), c = new THREE.Color();
for (let i = 0; i < N; i++) {
const r = Math.pow(Math.random(), 0.55) * R, arm = i % ARMS, spread = (0.6 + r * 0.09) * gauss();
const a = armAngle(r, arm) + spread / Math.max(r, 3) + (Math.random() < 0.22 ? rnd(-Math.PI, Math.PI) : 0);
pos.set([Math.cos(a) * r + gauss() * 0.8, gauss() * (2.2 * Math.exp(-r / 18) + 0.35), Math.sin(a) * r + gauss() * 0.8], i * 3);
const t = r / R; c.copy(cCore).lerp(cIn, Math.min(1, t * 2.4)).lerp(cOut, Math.max(0, t * 1.5 - 0.5));
if (Math.random() < 0.04) c.copy(cAcc);
col.set([c.r, c.g, c.b], i * 3); sz[i] = Math.random() < 0.012 ? rnd(3, 5.5) : rnd(0.6, 2.0);
}
const g = new THREE.BufferGeometry();
g.setAttribute('position', new THREE.BufferAttribute(pos, 3)); g.setAttribute('color', new THREE.BufferAttribute(col, 3)); g.setAttribute('size', new THREE.BufferAttribute(sz, 1));
const m = new THREE.ShaderMaterial({ transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, vertexColors: true,
uniforms: { uPx: { value: renderer.getPixelRatio() }, uDim: { value: 1 }, uK: { value: 1 } },
vertexShader: `attribute float size; varying vec3 vC; uniform float uPx; uniform float uK;
void main(){ vC = color; vec4 mv = modelViewMatrix*vec4(position,1.0); gl_PointSize = clamp(size*uPx*uK*(150.0/-mv.z), 1.1, 7.0*uPx); gl_Position = projectionMatrix*mv; }`,
fragmentShader: `varying vec3 vC; uniform float uDim; void main(){ vec2 p = gl_PointCoord-0.5; float d = length(p); if(d>0.5) discard;
float a = smoothstep(0.5,0.0,d); gl_FragColor = vec4(vC*(0.55+a*1.1), a*0.85*uDim); }` });
const pts = new THREE.Points(g, m); scene.add(pts); return pts;
})();
// ============================================================ 星云(噪声云,沿旋臂;颜色只取 config 里那几组)
const nebulaMat = (c1, c2, seed, alpha) => new THREE.ShaderMaterial({ transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide,
uniforms: { uT: { value: 0 }, uA: { value: new THREE.Color(c1) }, uB: { value: new THREE.Color(c2) }, uS: { value: seed }, uO: { value: alpha }, uDim: { value: 1 } },
vertexShader: `varying vec2 vU; void main(){ vU = uv; gl_Position = projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
fragmentShader: `uniform float uT; uniform vec3 uA; uniform vec3 uB; uniform float uS; uniform float uO; uniform float uDim; varying vec2 vU;
float h(vec2 p){ return fract(sin(dot(p,vec2(127.1,311.7))+uS)*43758.5453); }
float n(vec2 p){ vec2 i=floor(p), f=fract(p); f=f*f*(3.0-2.0*f); return mix(mix(h(i),h(i+vec2(1,0)),f.x),mix(h(i+vec2(0,1)),h(i+vec2(1,1)),f.x),f.y); }
float fbm(vec2 p){ float v=0.0, a=0.5; for(int i=0;i<6;i++){ v+=a*n(p); p=p*2.03+vec2(1.7,9.2); a*=0.5; } return v; }
void main(){ vec2 p = vU-0.5; float r = length(p)*2.0; if(r>1.0) discard;
vec2 q = vU*3.0 + uS; float w = fbm(q + vec2(uT*0.02, -uT*0.015)); float d = fbm(q*1.7 + w*2.4 + vec2(-uT*0.01, uT*0.02));
float shape = smoothstep(1.0, 0.15, r) * smoothstep(0.32, 0.85, d); float dust = smoothstep(0.55, 0.75, fbm(q*3.1 - w));
gl_FragColor = vec4(mix(uA, uB, smoothstep(0.3, 0.9, d)) * (0.6 + d), shape * (1.0 - dust*0.6) * uO * uDim); }` });
const nebulae = [];
{ const n = MOB ? G.nebulae.mobile : G.nebulae.desktop;
for (let i = 0; i < n; i++) {
const r = rnd(8, R * 0.95), a = armAngle(r, i % ARMS) + rnd(-0.35, 0.35), pal = C.nebula[i % C.nebula.length], s = rnd(14, 34) * (1.1 - r / R * 0.4);
const m = new THREE.Mesh(new THREE.PlaneGeometry(s, s), nebulaMat(pal[0], pal[1], rnd(0, 100), rnd(0.32, 0.55)));
m.position.set(Math.cos(a) * r, rnd(-1.5, 1.5), Math.sin(a) * r); m.rotation.set(-Math.PI / 2 + rnd(-0.25, 0.25), 0, rnd(0, Math.PI)); scene.add(m); nebulae.push(m);
}
const core = new THREE.Mesh(new THREE.PlaneGeometry(34, 34), nebulaMat(C.coreNebula[0], C.coreNebula[1], 7, 0.5)); core.rotation.x = -Math.PI / 2; scene.add(core); nebulae.push(core); }
const glow = (color, size, op = 1) => { const c = document.createElement('canvas'); c.width = c.height = 128; const x = c.getContext('2d');
const g = x.createRadialGradient(64, 64, 0, 64, 64, 64); g.addColorStop(0, 'rgba(255,255,255,1)'); g.addColorStop(0.22, color); g.addColorStop(1, 'rgba(0,0,0,0)'); x.fillStyle = g; x.fillRect(0, 0, 128, 128);
const s = new THREE.Sprite(new THREE.SpriteMaterial({ map: new THREE.CanvasTexture(c), blending: THREE.AdditiveBlending, depthWrite: false, transparent: true, opacity: op })); s.scale.setScalar(size); return s; };
scene.add(glow('rgba(255,215,150,.28)', 15, 0.7)); // 核心的柔光(收着点,之前太曝)
{ const N = MOB ? 1100 : 2400, p = new Float32Array(N * 3); // 远处整球背景星
for (let i = 0; i < N; i++) { const u = rnd(-1, 1), t = rnd(0, Math.PI * 2), s = Math.sqrt(1 - u * u), r = rnd(500, 900); p.set([Math.cos(t) * s * r, u * r, Math.sin(t) * s * r], i * 3); }
const g = new THREE.BufferGeometry(); g.setAttribute('position', new THREE.BufferAttribute(p, 3));
scene.add(new THREE.Points(g, new THREE.PointsMaterial({ color: 0xC9D3FF, size: 1.2, sizeAttenuation: false, transparent: true, opacity: 0.6 }))); }
// ============================================================ 扇区:同心环 + 分隔虚线 + 扇区名
const lineCol = new THREE.Color(C.line), guides = [];
const addLine = (pts, dashed, op) => { const g = new THREE.BufferGeometry().setFromPoints(pts);
const m = dashed ? new THREE.LineDashedMaterial({ color: lineCol, dashSize: 1.2, gapSize: 1.4, transparent: true, opacity: op, depthWrite: false })
: new THREE.LineBasicMaterial({ color: lineCol, transparent: true, opacity: op, depthWrite: false });
const l = new THREE.Line(g, m); if (dashed) l.computeLineDistances(); l.userData.op = op; scene.add(l); guides.push(l); return l; };
for (const [rr, op] of [[16, 0.16], [32, 0.11], [48, 0.09], [R + 4, 0.16]]) { const pts = []; for (let k = 0; k <= 256; k++) { const a = k / 256 * Math.PI * 2; pts.push(new THREE.Vector3(Math.cos(a) * rr, 0, Math.sin(a) * rr)); } addLine(pts, false, op); }
for (let k = 0; k < 6; k++) { const a = k / 6 * Math.PI * 2 + 0.3; addLine([new THREE.Vector3(Math.cos(a) * 16, 0, Math.sin(a) * 16), new THREE.Vector3(Math.cos(a) * (R + 4), 0, Math.sin(a) * (R + 4))], true, 0.12); }
const sectorTags = G.sectors.map((name, k) => { const d = document.createElement('div'); d.className = 'sector'; d.textContent = name; labels.appendChild(d);
const a = (k + 0.5) / 6 * Math.PI * 2 + 0.3; return { el: d, p: new THREE.Vector3(Math.cos(a) * (R + 9), 0, Math.sin(a) * (R + 9)) }; });
// ============================================================ 星系(每条世界线一颗卡通星球 + 卫星)
const systems = [], planets = [];
const lit = CFG.UNIVERSES.filter(u => !u.empty), empty = CFG.UNIVERSES.filter(u => u.empty);
CFG.UNIVERSES.forEach((u, i) => {
const ei = empty.indexOf(u);
const L = Object.assign({}, CFG.EMPTY_LOOK, CFG.LOOKS[u.no] || {});
if (!CFG.LOOKS[u.no]) L.orbit = [R * (0.8 + 0.12 * (ei % 2)), ei % ARMS]; // 空槽放在外圈,按顺序分到各条旋臂
const [r, arm] = L.orbit || [R * 0.85, i % ARMS];
const a = r ? armAngle(r, arm) + (u.empty ? 0.32 * Math.floor(ei / ARMS) : 0) : 0;
const g = new THREE.Group(); g.position.set(Math.cos(a) * r, 0, Math.sin(a) * r); scene.add(g);
const p = makePlanet(THREE, Object.assign({ seed: i * 7.3 + 1 }, L)); g.add(p.group); planets.push(p);
const moons = (L.moons || []).map((m, k) => { const piv = new THREE.Group(); piv.rotation.x = 0.35 - k * 0.2; piv.rotation.y = k * 2.1; g.add(piv);
const mp = makePlanet(THREE, Object.assign({ seed: i * 13 + k * 3.1, spin: 0.4 }, m)); mp.group.position.x = m.d; piv.add(mp.group); planets.push(mp); return { piv, speed: Math.abs(m.speed || 0.3) }; }); // 卫星一律同一个方向转(和星系自转同向)
const tag = document.createElement('button'); tag.type = 'button'; tag.className = 'tag' + (u.empty ? ' empty' : ''); tag.style.setProperty('--c', L.accent || C.ui);
tag.innerHTML = '<span class="t"><b>' + (u.empty ? '空槽' : u.name) + '</b><em>' + u.no + (u.empty ? ' · 未点亮' : ' · ' + u.kind) + '</em></span>';
labels.appendChild(tag);
const s = { u, L, g, planet: p, moons, tag }; p.body.userData.s = s; systems.push(s);
tag.addEventListener('click', () => fly(s));
});
// 补给线:核心 → 每个星系,虚线往外流
const supply = [];
for (const s of systems) { if (s.u.no === '0000') continue;
const b = s.g.position.clone(), mid = b.clone().multiplyScalar(0.5); mid.y += b.length() * 0.12;
const l = new THREE.Line(new THREE.BufferGeometry().setFromPoints(new THREE.QuadraticBezierCurve3(new THREE.Vector3(), mid, b).getPoints(80)),
new THREE.LineDashedMaterial({ color: s.u.empty ? lineCol : new THREE.Color(C.ui), dashSize: 0.9, gapSize: 0.8, transparent: true, opacity: s.u.empty ? 0.14 : 0.42, depthWrite: false }));
l.computeLineDistances(); l.userData.op = l.material.opacity; scene.add(l); supply.push(l); }
// 散落的无名星球(只是让星系看起来有人住;不进档案、不能点)
// 位置挑过:离核心、离每个星系(含它的卫星轨道)、彼此之间都留足距离,不会叠在一起
{ const n = MOB ? G.decorPlanets.mobile : G.decorPlanets.desktop, styles = ['gas', 'rock', 'gas', 'rock', 'ice'];
const pals = [['#F2D7A6', '#D99A6C', '#8E6BBF', '#FFF2D6'], ['#BFD0FF', '#7C8FD6', '#4A5BA8', '#FFFFFF'], ['#9FE3D6', '#4FB8A8', '#2F6F8C', '#E6FFF8'], ['#D6C2FF', '#9B8BFF', '#5B3FB8', '#FFFFFF']];
const taken = systems.map(s => ({ p: s.g.position, r: s.L.r * 3 + Math.max(0, ...(s.L.moons || []).map(m => m.d + m.r)) + 3 }));
taken.push({ p: new THREE.Vector3(), r: 14 });
let made = 0;
for (let tries = 0; made < n && tries < n * 60; tries++) {
const r = rnd(16, R * 0.96), a = armAngle(r, Math.floor(rnd(0, ARMS))) + rnd(-0.45, 0.45), size = rnd(0.35, 0.8);
const pos = new THREE.Vector3(Math.cos(a) * r, rnd(-0.8, 0.8), Math.sin(a) * r);
if (taken.some(o => o.p.distanceTo(pos) < o.r + size + 2.5)) continue;
const p = makePlanet(THREE, { style: styles[made % styles.length], r: size, colors: pals[made % pals.length], seed: made * 5.1, outline: '#141833', spin: rnd(0.05, 0.2) });
p.group.position.copy(pos); scene.add(p.group); planets.push(p); taken.push({ p: pos, r: size + 2 }); made++;
} }
el.counts && el.counts(CFG.UNIVERSES.length, lit.length, empty.length);
// ============================================================ 相机 + 交互(拖动、滚轮、双指缩放)
const HOME = () => ({ az: 0.7, el: isMob() ? 1.08 : 0.62, dist: isMob() ? 155 : 112 });
// ============================================================ 运镜库(全部按时间走,和帧率无关)
// 每个运镜 = 时长 + 一条路径函数 path(from, to, k):k 是 0→1 的进度,往 view 里写这一刻的相机状态。
// 相机状态:az 方位角 / el 仰角 / dist 距离 / tx,ty,tz 看向哪 / fov 视角 / roll 滚转。
// 加一种新运镜:往 MOVES 里加一项,然后在 config.js 的 LOOKS[编号].enter 里写它的名字。
const FOV = 42;
const lerp = (a, b, k) => a + (b - a) * k, clamp01 = k => Math.max(0, Math.min(1, k));
const E = {
io: k => k < 0.5 ? 4 * k * k * k : 1 - Math.pow(-2 * k + 2, 3) / 2, // 缓入缓出
out: k => 1 - Math.pow(1 - k, 3), // 先快后慢
in: k => k * k * k,
io5: k => k < 0.5 ? 16 * k ** 5 : 1 - Math.pow(-2 * k + 2, 5) / 2, // 更「沉」的缓入缓出
expo: k => k === 0 ? 0 : k === 1 ? 1 : k < 0.5 ? Math.pow(2, 20 * k - 10) / 2 : (2 - Math.pow(2, -20 * k + 10)) / 2,
};
const KEYS = ['az', 'el', 'dist', 'tx', 'ty', 'tz', 'fov', 'roll'];
const mix = (f, to, k, keys = KEYS) => { for (const key of keys) view[key] = lerp(f[key], to[key], k); };
const MOVES = {
// 绕行:边飞边绕过去,中途抬高拉远一点(原来那种)
orbit: { dur: 1700, path(f, to, k) { const e = E.io(k); mix(f, to, e); view.el += Math.sin(Math.PI * e) * 0.28; view.dist *= 1 + Math.sin(Math.PI * e) * 0.22; } },
// 推进:镜头先转过去对准(前 40%),再笔直推进去(不绕圈)
push: { dur: 1600, path(f, to, k) { const look = E.out(clamp01(k / 0.45)), go = E.io5(k);
mix(f, to, look, ['tx', 'ty', 'tz', 'az', 'el']); mix(f, to, go, ['dist']); view.fov = FOV; view.roll = 0; } },
// 放大:先用「长焦」把它拉近(视角收窄),再一边推进一边把视角放回来 —— 有点希区柯克变焦的味道
zoom: { dur: 2000, path(f, to, k) { const k1 = clamp01(k / 0.45), k2 = clamp01((k - 0.45) / 0.55);
mix(f, to, E.out(clamp01(k / 0.35)), ['tx', 'ty', 'tz']); mix(f, to, E.io(k), ['az', 'el']);
view.fov = k < 0.45 ? lerp(f.fov, 14, E.out(k1)) : lerp(14, to.fov, E.io(k2));
view.dist = lerp(f.dist, to.dist, E.io(k2)); view.roll = 0; } },
// 升空俯冲:先拉高到几乎俯视,再从上面扎下去
rise: { dur: 2100, path(f, to, k) { const e = E.io(k); mix(f, to, e);
const up = Math.sin(Math.PI * clamp01(k * 1.15)); view.el = lerp(view.el, 1.35, up * 0.85); view.dist *= 1 + up * 0.55; } },
// 跃迁:慢起步、中段猛冲、末段刹住;冲的时候视角张开、镜头轻轻一滚
warp: { dur: 1800, path(f, to, k) { const e = E.expo(k), s = Math.sin(Math.PI * k);
mix(f, to, e); view.fov = to.fov + s * s * 34; view.roll = s * 0.18 * (f.az > to.az ? 1 : -1); } },
// 拉远:回星系图用 —— 先往后退,再抬头看全景
pull: { dur: 1700, path(f, to, k) { mix(f, to, E.io5(k), ['dist']); mix(f, to, E.out(clamp01((k - 0.15) / 0.85)), ['tx', 'ty', 'tz', 'el', 'az']);
view.fov = lerp(f.fov, to.fov, E.io(k)); view.roll = lerp(f.roll, 0, E.io(k)); } },
// 开场 A · 盘旋落下:从高空、更远处绕半圈落到正常视角
introSweep: { dur: 3600, path(f, to, k) { mix(f, to, E.io(k)); } },
// 开场 B · 垂直坠入:从正上方很远的地方直着往下落,最后才抬起镜头、星系转正
introDive: { dur: 3400, path(f, to, k) { const d = E.io5(k); view.dist = lerp(f.dist, to.dist, d); view.el = lerp(f.el, to.el, E.in(clamp01((k - 0.35) / 0.65)));
view.az = lerp(f.az, to.az, E.io(k)); view.fov = lerp(f.fov, to.fov, E.out(k)); view.tx = view.ty = view.tz = 0; view.roll = 0; } },
};
const h0 = HOME();
const introKind = (G.intro === 'dive' || G.intro === 'sweep') ? G.intro : (Math.random() < 0.5 ? 'dive' : 'sweep');
const START = introKind === 'dive' ? { az: h0.az + 0.6, el: 1.52, dist: h0.dist * 3.2, fov: 30 } : { az: h0.az - 1.5, el: 1.42, dist: h0.dist * 2.4, fov: FOV };
const view = Object.assign({ tx: 0, ty: 0, tz: 0, roll: 0, fov: FOV }, reduce ? h0 : START);
const want = Object.assign({ fov: FOV, roll: 0 }, h0);
let anim = null, intro = !reduce;
// 用户中途拖动 / 缩放:运镜立刻停在原地交还控制权,但没出来的档案卡要马上补上(不然卡就丢了)
function cancelAnim() { if (!anim) return; const f = anim.onArrive; anim = null; f && f(); }
// to 里没写的 fov / roll 默认回到正常;az 走最近的那一边转
function animate(to, move = 'orbit', onArrive = null, arriveAt = 0.8) {
to = Object.assign({ fov: FOV, roll: 0 }, to);
if (reduce) { Object.assign(view, to); Object.assign(want, to); anim = null; onArrive && onArrive(); return; }
const daz = ((to.az - view.az) % (Math.PI * 2) + Math.PI * 3) % (Math.PI * 2) - Math.PI;
const M = MOVES[move] || MOVES.orbit;
anim = { t0: performance.now(), M, from: Object.assign({}, view), to: Object.assign({}, to, { az: view.az + daz }), onArrive, arriveAt };
}
let focus = null, hover = null;
function fit() { const w = stage.clientWidth, h = stage.clientHeight; renderer.setSize(w, h, false); camera.aspect = w / h; camera.updateProjectionMatrix(); }
addEventListener('resize', fit); fit();
const ptrs = new Map(); let drag = null, pinch = null;
canvas.addEventListener('pointerdown', e => { canvas.setPointerCapture(e.pointerId); ptrs.set(e.pointerId, { x: e.clientX, y: e.clientY });
if (ptrs.size === 2) { const [a, b] = [...ptrs.values()]; pinch = { d: Math.hypot(a.x - b.x, a.y - b.y), dist: want.dist }; drag = null; }
else drag = { x: e.clientX, y: e.clientY, az: want.az, el: want.el, moved: false }; });
canvas.addEventListener('pointermove', e => {
if (ptrs.has(e.pointerId)) ptrs.set(e.pointerId, { x: e.clientX, y: e.clientY });
if (pinch && ptrs.size === 2) { const [a, b] = [...ptrs.values()]; zoomTo(pinch.dist * pinch.d / Math.max(20, Math.hypot(a.x - b.x, a.y - b.y))); return; }
if (drag) { const dx = e.clientX - drag.x, dy = e.clientY - drag.y; if (Math.abs(dx) + Math.abs(dy) > 6) drag.moved = true;
if (drag.moved) { if (anim) { cancelAnim(); Object.assign(want, view); drag.az = view.az + dx * 0.005; drag.el = view.el - dy * 0.004; } /* 从镜头现在的位置接着拖,不跳 */ want.az = drag.az - dx * 0.005; want.el = THREE.MathUtils.clamp(drag.el + dy * 0.004, 0.08, 1.45); } return; }
if (e.pointerType === 'mouse') { hover = pick(e); canvas.style.cursor = hover ? 'pointer' : 'grab'; } });
const end = e => { ptrs.delete(e.pointerId); if (ptrs.size < 2) pinch = null;
const d = drag; drag = null; if (d && !d.moved && e.type === 'pointerup') { const s = pick(e); if (s) fly(s); else if (focus) home(); } };
canvas.addEventListener('pointerup', end); canvas.addEventListener('pointercancel', end);
const zoomTo = d => { if (anim) { cancelAnim(); Object.assign(want, view); } want.dist = THREE.MathUtils.clamp(d, focus ? focus.L.r * 2.6 : 32, focus ? focus.L.r * 16 : 230); };
canvas.addEventListener('wheel', e => {
if (el.wheelZoom && !el.wheelZoom() && !e.ctrlKey) return; // 嵌在页面里:普通滚轮留给页面滚动
e.preventDefault(); zoomTo(want.dist * (1 + Math.sign(e.deltaY) * 0.1)); }, { passive: false });
addEventListener('keydown', e => { if (e.key === 'Escape') home(); if (focus && e.key === 'ArrowRight') step(1); if (focus && e.key === 'ArrowLeft') step(-1); });
back && (back.onclick = () => home());
const ray = new THREE.Raycaster(), ptr = new THREE.Vector2(), tmp = new THREE.Vector3();
function pick(e) {
const r = canvas.getBoundingClientRect(); ptr.set((e.clientX - r.left) / r.width * 2 - 1, -(e.clientY - r.top) / r.height * 2 + 1);
ray.setFromCamera(ptr, camera); const hit = ray.intersectObjects(systems.map(s => s.planet.body), false)[0]; if (hit) return hit.object.userData.s;
let best = null, bd = isMob() ? 34 : 28;
for (const s of systems) { s.g.getWorldPosition(tmp).project(camera); const d = Math.hypot((tmp.x - ptr.x) * r.width / 2, (tmp.y - ptr.y) * r.height / 2); if (d < bd && tmp.z < 1) { bd = d; best = s; } }
return best;
}
const esc = x => String(x || '').replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
function card(s) { const u = s.u, nav = '<div class="nav"><button class="btn" type="button" data-s="-1">上一个</button><button class="btn" type="button" data-s="1">下一个</button></div>';
if (u.empty) return '<div class="card" style="--pc:' + (s.L.accent) + '"><div class="k">UNIVERSE ' + u.no + ' · 未点亮</div><h2>空槽</h2><div class="tg">这条世界线还没写出来,星系还没被点亮。</div><div class="acts">' + nav + '<button class="btn" type="button" data-home>回到星系图</button></div></div>';
return '<div class="card" style="--pc:' + s.L.accent + '"><div class="k">UNIVERSE ' + u.no + ' · ' + esc(u.kind) + ' · 已点亮</div><h2>' + esc(u.name) + '</h2><div class="tg">' + esc(u.tag) + '</div>' +
'<p class="ds">' + esc(u.desc) + '</p><div class="tags">' + (u.tags || []).map(t => '<span>' + esc(t) + '</span>').join('') + '</div><div class="acts">' + nav + '<button class="btn pri" type="button" data-home>回到星系图</button></div></div>'; }
panel && panel.addEventListener('click', e => { const b = e.target.closest('[data-s]'); if (b) step(+b.dataset.s); if (e.target.closest('[data-home]')) home(); });
function step(d) { const i = systems.indexOf(focus); fly(systems[(i + d + systems.length) % systems.length]); }
// 飞过去:先把旧档案卡收起来 → 镜头按这颗星的「入场运镜」飞 → 快到(80%)的时候档案卡才滑出来,和星球落定同步
const ENTER_CYCLE = ['push', 'zoom', 'rise', 'warp', 'orbit'];
function fly(s) { const was = focus; focus = s; intro = false; stage.classList.add('ready'); stage.classList.add('focus');
panel && panel.classList.remove('on'); el.onFocus && el.onFocus(s.u, 'start');
const p = s.g.position, dist = s.L.r * (isMob() ? 9 : 5.6) + (s.moons.length ? s.L.r * 1.5 : 0);
const i = systems.indexOf(s), move = s.L.enter || ENTER_CYCLE[i % ENTER_CYCLE.length];
// 推进 / 放大:沿着现在的视线方向过去(不绕);其它运镜:落到「从星系中心那一侧看过去」的角度,背景是星系盘
const az = (move === 'push' || move === 'zoom') ? view.az + 0.12 : Math.atan2(p.x, p.z) + 0.35;
animate({ az, el: 0.24, dist, tx: p.x, ty: p.y, tz: p.z }, was && was !== s && move !== 'warp' ? 'orbit' : move, () => {
if (focus !== s) return;
panel && (panel.innerHTML = card(s), panel.classList.add('on')); el.onFocus && el.onFocus(s.u, 'arrive'); }, 0.78); }
function home() { if (!focus) return; focus = null; panel && panel.classList.remove('on'); stage.classList.remove('focus'); el.onFocus && el.onFocus(null, 'start');
animate(Object.assign(HOME(), { tx: 0, ty: 0, tz: 0, az: view.az - 0.3 }), 'pull'); }
// ============================================================ 循环
const clock = new THREE.Clock(), tgt = new THREE.Vector3();
let hudBottom = 0; const measureHud = () => { hudBottom = hud ? hud.getBoundingClientRect().bottom - stage.getBoundingClientRect().top : 0; }; measureHud(); addEventListener('resize', measureHud);
let visible = true, started = false, tIntro = 0;
if ('IntersectionObserver' in window) new IntersectionObserver(es => { visible = es[0].isIntersecting; }, { threshold: 0.05 }).observe(stage);
function loop() {
requestAnimationFrame(loop);
if (!visible) { clock.getDelta(); return; } // 滚出视口:不渲染,省电
if (!started) { started = true; tIntro = clock.elapsedTime; if (intro) animate(Object.assign({}, h0, { tx: 0, ty: 0, tz: 0 }), introKind === 'dive' ? 'introDive' : 'introSweep'); else stage.classList.add('ready'); }
const dt = Math.min(clock.getDelta(), 0.05), t = clock.elapsedTime, mob = isMob();
if (!reduce) { galaxy.rotation.y += dt * 0.004; for (const n of nebulae) n.material.uniforms.uT.value = t; }
for (const l of supply) l.material.dashOffset -= dt * 2;
for (const p of planets) p.update(reduce ? 0 : dt, t, LIGHT);
// 星系在总览里放大一点(不然在手机上只是一个小点),飞近时恢复真实大小
const sysK = focus ? 1 : (mob ? 1.9 : 1.35);
for (const s of systems) { for (const m of s.moons) m.piv.rotation.y += (reduce ? 0 : dt) * m.speed;
const sc = s.g.scale.x + (sysK - s.g.scale.x) * (reduce ? 1 : Math.min(1, dt * 3)); s.g.scale.setScalar(sc); }
// 开场:星系从暗处亮起来(0 → 1,大约 2.4 秒);飞近一颗星时:星云、粒子、扇区线退后一点,别抢主角
const introK = intro ? Math.min(1, (t - tIntro) / 2.4) : 1;
const dimT = (focus ? 0.45 : 1) * introK;
galaxy.material.uniforms.uDim.value += (dimT - galaxy.material.uniforms.uDim.value) * (intro ? 1 : Math.min(1, dt * 3));
galaxy.material.uniforms.uK.value = 112 / HOME().dist;
for (const n of nebulae) n.material.uniforms.uDim.value = galaxy.material.uniforms.uDim.value;
for (const l of guides.concat(supply)) l.material.opacity += (l.userData.op * (focus ? 0.25 : 1) * introK - l.material.opacity) * Math.min(1, dt * 3);
// 相机:有补间就按时间走补间(不受帧率影响,一条连贯的弧线);没有就柔和地跟着拖动 / 缩放
if (anim) {
const a = anim, kk = Math.min(1, (performance.now() - a.t0) / a.M.dur);
a.M.path(a.from, a.to, kk);
if (a.onArrive && kk >= a.arriveAt) { const f = a.onArrive; a.onArrive = null; f(); } // 档案卡和星球落定同步出现
if (kk >= 1) { Object.assign(view, a.to); Object.assign(want, a.to); if (anim === a) anim = null; if (!focus) stage.classList.add('ready'); }
} else {
view.fov += (FOV - view.fov) * Math.min(1, dt * 4); view.roll += (0 - view.roll) * Math.min(1, dt * 4);
if (focus) focus.g.getWorldPosition(tgt); else tgt.set(0, 0, 0);
const k = 1 - Math.exp(-dt * 6);
view.tx += (tgt.x - view.tx) * k; view.ty += (tgt.y - view.ty) * k; view.tz += (tgt.z - view.tz) * k;
for (const key of ['az', 'el', 'dist']) view[key] += (want[key] - view[key]) * k;
if (!drag && !pinch && !focus && !reduce) want.az += dt * 0.02;
}
camera.position.set(view.tx + Math.sin(view.az) * Math.cos(view.el) * view.dist, view.ty + Math.sin(view.el) * view.dist, view.tz + Math.cos(view.az) * Math.cos(view.el) * view.dist);
camera.lookAt(view.tx, view.ty, view.tz);
if (view.roll) camera.rotateZ(view.roll);
if (Math.abs(camera.fov - view.fov) > 0.01) { camera.fov = view.fov; camera.updateProjectionMatrix(); }
// 选中时把星球挪开,给档案卡让位:桌面往左挪,手机往上挪(档案卡在下半屏)
const w = stage.clientWidth, h = stage.clientHeight;
const lay = el.layout ? el.layout() : { x: mob ? 0 : 0.16, y: mob ? 0.22 : 0 };
if (focus && (lay.x || lay.y)) camera.setViewOffset(w, h, w * lay.x, h * lay.y, w, h); else camera.clearViewOffset();
// 名牌:跟着星系走;贴边夹住不出屏;手机上压到 HUD 下面的藏起来
for (const s of systems) { s.g.getWorldPosition(tmp); tmp.project(camera);
let x = (tmp.x + 1) / 2 * w + 10, y = (1 - tmp.y) / 2 * h - 12;
const tw = s.tag.offsetWidth || 90; x = Math.min(Math.max(x, 6), w - tw - 6);
const vis = tmp.z < 1 && Math.abs(tmp.x) < 1.05 && Math.abs(tmp.y) < 1.05 && !(mob && y < hudBottom + 4) && focus !== s;
s.tag.style.transform = 'translate(' + x.toFixed(1) + 'px,' + y.toFixed(1) + 'px)';
s.tag.classList.toggle('hot', s === hover); s.tag.classList.toggle('dim', !!focus); s.tag.style.visibility = vis ? '' : 'hidden'; }
for (const st of sectorTags) { tmp.copy(st.p).project(camera); st.el.style.transform = 'translate(' + ((tmp.x + 1) / 2 * w) + 'px,' + ((1 - tmp.y) / 2 * h) + 'px) translate(-50%,-50%)'; st.el.style.opacity = (tmp.z < 1 && !focus) ? '' : 0; }
renderer.render(scene, camera);
if (firstFrame) { firstFrame = false; el.onReady && el.onReady(); } // 第一帧画好了,外面的「载入中」再淡出
}
// 开场:第一帧画出来再开始(外面的「载入中」此时淡出,镜头接着就开始动,中间不留空白)
let firstFrame = true;
loop();
return { resize: fit, fly: no => { const s = systems.find(x => x.u.no === no); if (s) fly(s); }, home };
}
+222
View File
@@ -0,0 +1,222 @@
/* =============================================================================
* 金钻宇宙 · 卡通星球材质库(planets.js)
* -----------------------------------------------------------------------------
* 每一种「风格」= 一段着色器(决定星球表面长什么样)+ 一组默认参数。
* 全部是程序生成的卡通材质:分段明暗(toon)+ 墨线描边 + 轮廓光,不依赖任何贴图文件。
*
* 加一种新风格:在 STYLES 里加一项 { geo, frag, defaults },见交接说明「加一种星球风格」。
* 用法:
* import { makePlanet } from './planets.js';
* const p = makePlanet(THREE, { style: 'ice', r: 1.2, colors: [...] });
* scene.add(p.group); // p.update(dt, t, lightDirWorld) 每帧调一次
* ============================================================================= */
// ---- 3D simplex 噪声(Ashima / Stefan Gustavson,MIT)—— 用物体空间坐标取样,球面上没有接缝
const NOISE = `
vec3 m289(vec3 x){return x-floor(x*(1.0/289.0))*289.0;} vec4 m289(vec4 x){return x-floor(x*(1.0/289.0))*289.0;}
vec4 perm(vec4 x){return m289(((x*34.0)+1.0)*x);} vec4 tis(vec4 r){return 1.79284291400159-0.85373472095314*r;}
float snoise(vec3 v){const vec2 C=vec2(1.0/6.0,1.0/3.0);const vec4 D=vec4(0.0,0.5,1.0,2.0);
vec3 i=floor(v+dot(v,C.yyy));vec3 x0=v-i+dot(i,C.xxx);vec3 g=step(x0.yzx,x0.xyz);vec3 l=1.0-g;
vec3 i1=min(g.xyz,l.zxy);vec3 i2=max(g.xyz,l.zxy);vec3 x1=x0-i1+C.xxx;vec3 x2=x0-i2+C.yyy;vec3 x3=x0-D.yyy;
i=m289(i);vec4 p=perm(perm(perm(i.z+vec4(0.0,i1.z,i2.z,1.0))+i.y+vec4(0.0,i1.y,i2.y,1.0))+i.x+vec4(0.0,i1.x,i2.x,1.0));
float n_=0.142857142857;vec3 ns=n_*D.wyz-D.xzx;vec4 j=p-49.0*floor(p*ns.z*ns.z);vec4 x_=floor(j*ns.z);vec4 y_=floor(j-7.0*x_);
vec4 x=x_*ns.x+ns.yyyy;vec4 y=y_*ns.x+ns.yyyy;vec4 h=1.0-abs(x)-abs(y);vec4 b0=vec4(x.xy,y.xy);vec4 b1=vec4(x.zw,y.zw);
vec4 s0=floor(b0)*2.0+1.0;vec4 s1=floor(b1)*2.0+1.0;vec4 sh=-step(h,vec4(0.0));vec4 a0=b0.xzyw+s0.xzyw*sh.xxyy;vec4 a1=b1.xzyw+s1.xzyw*sh.zzww;
vec3 p0=vec3(a0.xy,h.x);vec3 p1=vec3(a0.zw,h.y);vec3 p2=vec3(a1.xy,h.z);vec3 p3=vec3(a1.zw,h.w);
vec4 nm=tis(vec4(dot(p0,p0),dot(p1,p1),dot(p2,p2),dot(p3,p3)));p0*=nm.x;p1*=nm.y;p2*=nm.z;p3*=nm.w;
vec4 m=max(0.6-vec4(dot(x0,x0),dot(x1,x1),dot(x2,x2),dot(x3,x3)),0.0);m=m*m;
return 42.0*dot(m*m,vec4(dot(p0,x0),dot(p1,x1),dot(p2,x2),dot(p3,x3)));}
float fbm(vec3 p){ float v=0.0,a=0.5; for(int i=0;i<4;i++){ v+=a*snoise(p); p=p*2.02+vec3(3.1,1.7,5.3); a*=0.5; } return v; }
// 抗锯齿的细线:x 离 0 越近越黑,线宽 w(以屏幕像素为单位)
float aline(float x, float w){ float f = fwidth(x); return 1.0 - smoothstep(0.0, f*w, abs(x)); }
`;
// ---- 公共部分:分段明暗 + 冷色阴影 + 轮廓光
const HEAD = `
uniform vec3 uL; uniform float uT; uniform float uSeed; uniform vec3 uC0; uniform vec3 uC1; uniform vec3 uC2; uniform vec3 uC3;
uniform vec3 uShadow; uniform vec3 uRim; uniform float uGlow; uniform float uAlpha;
varying vec3 vP; varying vec3 vN; varying vec3 vW;
${NOISE}
// 卡通分段光照:亮 / 中 / 暗 三档,交界处一点点平滑防锯齿
float toon(float d){ float a = smoothstep(0.30,0.34,d), b = smoothstep(-0.12,-0.08,d); return 0.38 + 0.32*b + 0.30*a; }
vec3 shade(vec3 base, vec3 N, vec3 V){ float d = dot(N, normalize(uL)); float t = toon(d);
vec3 c = mix(base*uShadow, base, t);
float rim = pow(1.0 - max(dot(N, V), 0.0), 3.0); c += uRim * rim * 0.32 * smoothstep(-0.3, 0.4, d + 0.3);
return c; }
`;
const VERT = `
varying vec3 vP; varying vec3 vN; varying vec3 vW;
void main(){ vP = normalize(position); vN = normalize(mat3(modelMatrix)*normal); vec4 w = modelMatrix*vec4(position,1.0); vW = w.xyz; gl_Position = projectionMatrix*viewMatrix*w; }`;
// ---- 各风格的表面(main 里拿到 base 颜色 + 自发光 emi,最后统一上光)
const STYLES = {
/* 晶体:多面体切面,每个面颜色随朝向变化(像钻石折光),内部有发光的「演算脉络」 —— 给晶钻超算主宇宙 */
crystal: {
geo: (THREE, r) => new THREE.IcosahedronGeometry(r, 2),
defaults: { colors: ['#7FE7FF', '#8E7BFF', '#FFE59A', '#FFFFFF'], shadow: '#5B5FA8', rim: '#BFF4FF', outline: '#141A3A', glow: 0.55 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW);
vec3 N = normalize(cross(dFdx(vW), dFdy(vW))); // 平面法线 = 一个面一个颜色
vec3 nO = normalize(vP);
float k = 0.5 + 0.5*sin(dot(nO, vec3(5.1,3.7,4.3)) + uSeed);
vec3 base = mix(mix(uC0, uC1, k), uC2, smoothstep(0.55, 1.0, sin(dot(nO, vec3(2.3,-4.1,1.7))*3.0 + uSeed)*0.5+0.5)*0.55);
float vein = aline(snoise(vP*3.2 + vec3(0.0, uT*0.08, 0.0)), 2.2);
vec3 c = shade(base, N, V);
float spark = pow(max(dot(reflect(-normalize(uL), N), V), 0.0), 24.0);
c += uC3 * step(0.5, spark) * 0.45 + uC0 * vein * 0.75 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 铅笔纸面:米白纸色 + 等高线一样的铅笔线 + 暗面排线 + 几处红笔圈 —— 给「火柴人宇宙」(小时候课上画的) */
paper: {
defaults: { colors: ['#F6F1E4', '#2B2E45', '#E5544B', '#9DB7E8'], shadow: '#B9B4C8', rim: '#FFFFFF', outline: '#2B2E45', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float n = fbm(vP*1.6 + uSeed);
float contour = aline(fract(n*4.0 + 0.5) - 0.5, 1.4);
float d = dot(N, normalize(uL));
float h1 = aline(fract(dot(vP, vec3(0.7,0.7,0.1))*26.0) - 0.5, 1.2) * (1.0 - smoothstep(-0.1, 0.1, d)); // 暗面单向排线
float h2 = aline(fract(dot(vP, vec3(-0.7,0.7,0.2))*26.0) - 0.5, 1.2) * (1.0 - smoothstep(-0.55, -0.4, d)); // 更暗处交叉排线
float circ = aline(length(vP - normalize(vec3(0.6, 0.35, 0.7))) - 0.22, 1.6) + aline(length(vP - normalize(vec3(-0.5,-0.4,0.75))) - 0.14, 1.6);
float blue = smoothstep(0.35, 0.6, fbm(vP*2.4 + 7.0 + uSeed)); // 几块淡蓝色铅笔涂色
vec3 base = mix(uC0, mix(uC0, uC3, 0.45), blue);
vec3 c = shade(base, N, V);
c = mix(c, uC1, clamp(contour*0.85 + max(h1, h2)*0.6, 0.0, 1.0));
c = mix(c, uC2, clamp(circ, 0.0, 1.0)*0.9);
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 冰封:纬向冰带 + 极冠 + 冰裂纹 —— 给「极寒世界」(冰河期、地表 -50℃) */
ice: {
defaults: { colors: ['#F2FAFF', '#BFE4FF', '#7CC3F0', '#FFFFFF'], shadow: '#6C80C9', rim: '#D6F3FF', outline: '#18305C', glow: 0.2 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float band = snoise(vec3(vP.x*1.2, vP.y*7.0 + uSeed, vP.z*1.2));
vec3 base = mix(uC0, uC1, smoothstep(-0.25, 0.35, band));
base = mix(base, uC3, smoothstep(0.68, 0.74, abs(vP.y) + 0.05*snoise(vP*6.0))); // 极冠
float crack = smoothstep(0.88, 0.95, 1.0 - abs(snoise(vP*4.5 + uSeed)));
vec3 c = shade(base, N, V);
c = mix(c, uC2, crack*0.85);
c += uC3 * pow(max(dot(reflect(-normalize(uL), N), V), 0.0), 40.0) * 0.6;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 霓虹城:深紫底色 + 经纬网格街区 + 闪烁的窗灯 —— 给「没落赛博城」 */
neon: {
defaults: { colors: ['#211A3D', '#5FF2FF', '#FF5FD2', '#FFD36E'], shadow: '#5E5A8F', rim: '#8A7BFF', outline: '#0B0820', glow: 1.0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float lon = atan(vP.z, vP.x) / 3.14159265, lat = asin(clamp(vP.y, -1.0, 1.0)) / 1.5707963;
float dist = smoothstep(-0.05, 0.25, fbm(vP*2.2 + uSeed)); // 有城的街区
float gx = aline(fract(lon*14.0) - 0.5, 1.6), gy = aline(fract(lat*9.0) - 0.5, 1.6);
vec2 cell = floor(vec2(lon*56.0, lat*36.0));
float win = step(0.72, fract(sin(dot(cell, vec2(12.9898, 78.233)) + uSeed)*43758.5453));
float flick = 0.65 + 0.35*sin(uT*2.0 + cell.x*1.7 + cell.y*0.9);
vec3 base = uC0 * (0.9 + 0.2*snoise(vP*3.0));
vec3 c = shade(base, N, V);
vec3 neon = mix(uC1, uC2, step(0.0, snoise(vP*1.3 + 11.0)));
c += neon * max(gx, gy) * dist * 1.2 * uGlow + uC3 * win * dist * flick * 0.55 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 善恶两半:一半金色白昼、一半紫色夜空,交界是一条发光的波浪线 —— 给「善恶等级」 */
duality: {
defaults: { colors: ['#FFF0C8', '#F2B84B', '#2D1E57', '#8F6BFF'], shadow: '#8C7AA8', rim: '#FFE7A8', outline: '#1A1235', glow: 0.8 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float s = vP.x*0.9 + 0.22*snoise(vP*1.8 + uSeed) + 0.12*sin(vP.y*7.0 + uT*0.3);
float side = smoothstep(-0.015, 0.015, s);
float cloud = smoothstep(0.1, 0.5, fbm(vP*2.6 + uSeed));
vec3 light = mix(uC0, uC1, cloud*0.6);
float star = step(0.985, fract(sin(dot(floor(vP*60.0), vec3(12.9898,78.233,37.719)))*43758.5453));
vec3 dark = mix(uC2, uC3, cloud*0.5) + vec3(star)*0.8;
vec3 c = shade(mix(dark, light, side), N, V);
c += uC1 * aline(s, 3.0) * 1.2 * uGlow;
gl_FragColor = vec4(c, uAlpha); }`,
},
/* 气态巨星(点缀用):卡通条纹 + 一个风暴眼 */
gas: {
defaults: { colors: ['#F2D7A6', '#D99A6C', '#8E6BBF', '#FFF2D6'], shadow: '#7A6A9E', rim: '#FFE2B8', outline: '#1E1838', ring: false, glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float w = vP.y*5.0 + 0.6*snoise(vec3(vP.x*2.0, vP.y*4.0, vP.z*2.0) + uSeed);
float b = 0.5 + 0.5*sin(w*3.14159);
vec3 base = mix(mix(uC0, uC1, smoothstep(0.3, 0.7, b)), uC2, smoothstep(0.8, 0.95, b)*0.6);
float storm = 1.0 - smoothstep(0.08, 0.13, length(vP - normalize(vec3(0.8, -0.25, 0.5))));
base = mix(base, uC3, storm*0.85);
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
/* 岩石小行星(点缀用):卡通陨坑 */
rock: {
defaults: { colors: ['#A9AFC9', '#7D84A6', '#5B6288', '#D5D9EA'], shadow: '#5B5F8A', rim: '#C9D3FF', outline: '#141833', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float n = fbm(vP*2.0 + uSeed);
vec3 base = mix(uC0, uC1, smoothstep(-0.2, 0.3, n));
float cr = smoothstep(0.42, 0.5, snoise(vP*5.0 + uSeed*2.0));
base = mix(base, uC2, cr); base = mix(base, uC3, aline(snoise(vP*5.0 + uSeed*2.0) - 0.42, 1.5)*0.7);
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
/* 未点亮:半透明全息线框球 —— 空槽 */
ghost: {
transparent: true,
defaults: { colors: ['#7F8BC8', '#B9C4FF', '#7F8BC8', '#FFFFFF'], shadow: '#FFFFFF', rim: '#B9C4FF', outline: null, glow: 0, alpha: 1 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
float lon = atan(vP.z, vP.x) / 3.14159265, lat = asin(clamp(vP.y,-1.0,1.0)) / 1.5707963;
float g = max(aline(fract(lon*8.0 + uT*0.02) - 0.5, 1.4), aline(fract(lat*5.0) - 0.5, 1.4));
float f = pow(1.0 - max(dot(N, V), 0.0), 2.0);
gl_FragColor = vec4(mix(uC0, uC1, f), (g*0.55 + f*0.45 + 0.04) * uAlpha); }`,
},
};
export const STYLE_NAMES = Object.keys(STYLES);
/**
* 造一颗卡通星球。look 里能写:
* style 风格名(见 STYLES)
* r 半径
* colors 四个颜色(覆盖风格默认) shadow / rim / outline 阴影色 / 轮廓光色 / 描边色(outline:null 不描边)
* ring 要不要光环(默认没有;true / { inner, outer, color })
* seed 随机种子(同一风格的两颗星球长得不一样)
* tilt 自转轴倾角(弧度)
* atm 大气辉光颜色(默认没有;写了才加一层很淡的辉光)
*/
export function makePlanet(THREE, look = {}) {
const S = STYLES[look.style] || STYLES.rock;
const o = Object.assign({}, S.defaults, look);
const r = o.r || 1;
const col = i => new THREE.Color((o.colors || S.defaults.colors)[i] || '#ffffff');
const uniforms = {
uL: { value: new THREE.Vector3(-1, 0.6, 0.5) }, uT: { value: 0 }, uSeed: { value: o.seed ?? Math.random() * 50 },
uC0: { value: col(0) }, uC1: { value: col(1) }, uC2: { value: col(2) }, uC3: { value: col(3) },
uShadow: { value: new THREE.Color(o.shadow) }, uRim: { value: new THREE.Color(o.rim) }, uGlow: { value: o.glow ?? 0 }, uAlpha: { value: o.alpha ?? 1 },
};
const mat = new THREE.ShaderMaterial({ uniforms, vertexShader: VERT, fragmentShader: HEAD + S.frag,
transparent: !!S.transparent, depthWrite: !S.transparent, side: S.transparent ? THREE.DoubleSide : THREE.FrontSide });
const geo = S.geo ? S.geo(THREE, r) : new THREE.SphereGeometry(r, 96, 64);
const group = new THREE.Group(), body = new THREE.Mesh(geo, mat);
body.rotation.z = o.tilt ?? 0.3; group.add(body);
// 墨线描边:背面放大一点点的同形状,纯色 —— 卡通感的关键
if (o.outline) { const ol = new THREE.Mesh(geo, new THREE.MeshBasicMaterial({ color: o.outline, side: THREE.BackSide }));
ol.scale.setScalar(1.035); body.add(ol); }
// 大气辉光:默认**不加**(用户反馈「每颗星球外边都有一个罩子」)。确实想要就在 look 里写 atm: '#颜色'
let atm = null;
if (o.atm) {
atm = new THREE.Mesh(new THREE.SphereGeometry(r * 1.08, 48, 32), new THREE.ShaderMaterial({
transparent: true, depthWrite: false, side: THREE.BackSide, blending: THREE.AdditiveBlending,
uniforms: { uC: { value: new THREE.Color(o.atm) }, uS: { value: 0.25 } },
vertexShader: `varying vec3 vN; varying vec3 vW; void main(){ vN = normalize(mat3(modelMatrix)*normal); vec4 w = modelMatrix*vec4(position,1.0); vW = w.xyz; gl_Position = projectionMatrix*viewMatrix*w; }`,
fragmentShader: `uniform vec3 uC; uniform float uS; varying vec3 vN; varying vec3 vW; void main(){ vec3 v = normalize(cameraPosition - vW); float f = pow(1.0 - abs(dot(v, vN)), 4.0); gl_FragColor = vec4(uC, f*uS); }` }));
group.add(atm);
}
// 光环(卡通扁环,两道颜色)
let ring = null;
if (o.ring) {
const rc = typeof o.ring === 'object' ? o.ring : {};
const inner = (rc.inner || 1.45) * r, outer = (rc.outer || 2.1) * r;
ring = new THREE.Mesh(new THREE.RingGeometry(inner, outer, 128, 1), new THREE.ShaderMaterial({
transparent: true, depthWrite: false, side: THREE.DoubleSide,
uniforms: { uA: { value: new THREE.Color(rc.color || (o.colors || S.defaults.colors)[0]) }, uB: { value: new THREE.Color(rc.color2 || (o.colors || S.defaults.colors)[1]) }, uIn: { value: inner }, uOut: { value: outer } },
vertexShader: `varying vec3 vP; void main(){ vP = position; gl_Position = projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
fragmentShader: `uniform vec3 uA; uniform vec3 uB; uniform float uIn; uniform float uOut; varying vec3 vP;
void main(){ float t = (length(vP.xy)-uIn)/(uOut-uIn); float b = step(0.5, fract(t*5.0));
float a = (0.55 + 0.25*b) * smoothstep(0.0, 0.06, t) * smoothstep(1.0, 0.94, t); gl_FragColor = vec4(mix(uA, uB, b*0.6 + t*0.3), a); }` }));
ring.rotation.x = -Math.PI / 2 + 0.38; ring.rotation.y = 0.12; group.add(ring);
}
const spin = o.spin ?? 0.15;
return {
group, body, mat, atm, ring, r, look: o,
update(dt, t, lightDir) { body.rotation.y += dt * spin; uniforms.uT.value = t; if (lightDir) uniforms.uL.value.copy(lightDir); },
setAlpha(a) { uniforms.uAlpha.value = a; },
};
}
+96
View File
@@ -0,0 +1,96 @@
/* 金钻宇宙板块:白色客栈页面里开一扇「观星窗」,窗里是星系图;窗下是世界线档案列表(和星图联动)
像素字 / 按钮 / 墨色都沿用门户 jz-2026 层的变量(--pixel --ink --mc-green --stone …),这里只管星图自己的东西。 */
.skywin{--sky:#070B1C;--ui:#FFD36E;--line:rgba(127,139,200,.35);
position:relative;margin:6px 0 26px;padding:6px;border-radius:12px;background:rgba(255,255,255,.75);border:2px solid #fff;
box-shadow:0 30px 60px -36px rgba(40,50,110,.55)}
.skywin .stage{position:relative;height:min(72vh,660px);min-height:440px;border-radius:8px;overflow:hidden;background:var(--sky);color:#E8EBFA;isolation:isolate}
.skywin #uGl{position:absolute;inset:0;width:100%;height:100%;display:block;touch-action:none;outline:none}
/* 窗内 HUD:只放读数,标题已经在页面上了 */
.skywin .hud{position:absolute;left:18px;top:14px;pointer-events:none;display:flex;gap:16px;font:600 11px/1.4 ui-monospace,Menlo,monospace;letter-spacing:.12em;color:#7C84B4;
animation:uHud 1s cubic-bezier(.23,1,.32,1) .4s both}
.skywin .hud b{font:400 18px/1 var(--pixel);letter-spacing:0;color:var(--ui);margin-left:6px;-webkit-font-smoothing:none}
@keyframes uHud{from{opacity:0;transform:translateY(-6px)}to{opacity:1;transform:none}}
.skywin .labels{position:absolute;inset:0;pointer-events:none;transition:opacity .9s cubic-bezier(.23,1,.32,1)}
.skywin .stage:not(.ready) .labels{opacity:0}
.skywin .tag{position:absolute;left:0;top:0;display:flex;align-items:center;gap:7px;padding:3px 8px;border:0;border-radius:4px;background:none;cursor:pointer;white-space:nowrap;pointer-events:auto;font:inherit;text-align:left;will-change:transform;transition:opacity .3s}
.skywin .tag .t b{display:block;font:400 15px/1.15 var(--pixel);-webkit-font-smoothing:none;color:#F4F6FF;text-shadow:0 0 8px rgba(5,8,25,.95)}
.skywin .tag .t em{display:block;font:600 10px/1.3 ui-monospace,Menlo,monospace;letter-spacing:.12em;font-style:normal;color:#7C84B4}
.skywin .tag:hover,.skywin .tag.hot{background:rgba(255,211,110,.1)} .skywin .tag:hover .t b,.skywin .tag.hot .t b{color:var(--ui)}
.skywin .tag:focus-visible{outline:2px solid var(--ui);outline-offset:2px}
.skywin .tag.empty .t b{color:#8A92BE;font-size:13px}
.skywin .tag.dim{opacity:.15}
.skywin .sector{position:absolute;left:0;top:0;font:600 10px/1 ui-monospace,Menlo,monospace;letter-spacing:.3em;color:rgba(169,176,214,.42);white-space:nowrap;transition:opacity .4s;pointer-events:none}
/* 窗内档案卡(桌面 / 全屏时) */
.skywin .panel{position:absolute;right:18px;top:50%;width:min(390px,40%);transform:translate(20px,-48%);opacity:0;pointer-events:none;transition:opacity .45s cubic-bezier(.23,1,.32,1),transform .6s cubic-bezier(.23,1,.32,1)}
.skywin .panel.on{opacity:1;transform:translate(0,-50%);pointer-events:auto}
.skywin .panel .card{position:relative;padding:20px 20px 16px 24px;border-radius:8px;background:rgba(255,255,255,.96);border:2px solid #fff;color:var(--ink);box-shadow:0 30px 70px -30px rgba(0,0,0,.6)}
.skywin .panel .card::before{content:"";position:absolute;left:0;top:0;bottom:0;width:4px;border-radius:8px 0 0 8px;background:var(--pc,#FFD36E)}
.skywin .panel .card .k{font:600 12px/1 var(--font,inherit);letter-spacing:.06em;color:var(--ink-3)}
.skywin .panel .card h2{margin:8px 0 2px;font:400 28px/1.2 var(--pixel);-webkit-font-smoothing:none}
.skywin .panel .card .tg{color:var(--ink-2);font-size:14px}
.skywin .panel .card .ds{margin:10px 0 0;font-size:14px;line-height:1.8;color:var(--ink-2)}
.skywin .panel .card .tags{display:flex;flex-wrap:wrap;gap:6px;margin-top:10px}
.skywin .panel .card .tags span{font-size:12px;padding:4px 8px;border-radius:4px;background:rgba(30,36,64,.05);color:var(--ink-2)}
.skywin .panel .card .acts{display:flex;flex-wrap:wrap;gap:8px;margin-top:16px;justify-content:space-between}
.skywin .panel .card .nav{display:flex;gap:8px}
.skywin .panel .card .btn{height:38px;font-size:13.5px;padding:0 14px 3px}
/* 窗角按钮 */
.skywin .ctl{position:absolute;right:14px;top:12px;display:flex;gap:8px}
.skywin .ctl .btn{height:34px;font-size:13px;padding:0 12px 3px}
/* 档案卡里「回到星系图」是主按钮:门户的 .btn 是石头白方块,这里补一个绿色 .pri(同 .btn-solid) */
.skywin .btn.pri{background:var(--mc-green);border-color:var(--mc-green-lo);color:#fff;box-shadow:inset 0 2px 0 var(--mc-green-hi),inset 0 -4px 0 var(--mc-green-lo)}
.skywin .btn.pri:hover{background:#469A2E}
.skywin #uBack{display:none} .skywin .stage.focus #uBack{display:inline-flex}
.skywin .tip{position:absolute;left:18px;bottom:14px;margin:0;font-size:12px;color:#7C84B4;pointer-events:none;transition:opacity .3s}
.skywin .stage.focus .tip{opacity:0}
.skywin .loading{position:absolute;inset:0;display:grid;place-items:center;font:400 18px var(--pixel);color:#A9B0D6;background:var(--sky);transition:opacity .6s;z-index:5}
/* 全屏:窗户铺满屏幕,滚轮直接缩放 */
.skywin.full .stage{position:fixed;inset:0;z-index:300;height:auto;min-height:0;border-radius:0}
body.sky-full{overflow:hidden}
/* 窗下:世界线列表 */
.uni-title{margin:4px 0 14px;font-size:24px;line-height:1.3;color:var(--ink)}
.sky-hint{display:none}
.uni-list{display:grid;grid-template-columns:repeat(auto-fill,minmax(230px,1fr));gap:12px;margin-bottom:14px}
.ucell{position:relative;display:flex;flex-direction:column;gap:4px;padding:16px 16px 14px;border-radius:8px;border:2px solid rgba(255,255,255,.95);text-align:left;cursor:pointer;font:inherit;color:var(--ink);
background:linear-gradient(160deg,rgba(255,255,255,.9),rgba(255,255,255,.65));box-shadow:0 18px 36px -26px rgba(80,90,170,.45);transition:transform .2s cubic-bezier(.23,1,.32,1),box-shadow .2s}
.ucell:hover{transform:translateY(-2px)}
.ucell[aria-current=true]{box-shadow:inset 0 0 0 3px var(--mc-green,#3C8527),0 18px 36px -26px rgba(80,90,170,.45)}
.ucell .no{font:600 11px/1 ui-monospace,Menlo,monospace;letter-spacing:.14em;color:var(--ink-3)}
.ucell h3{margin:2px 0 0;font:400 22px/1.25 var(--pixel);-webkit-font-smoothing:none}
.ucell .tg{font-size:13px;color:var(--ink-2)}
.ucell .go{margin-top:6px;font-size:12.5px;font-weight:700;color:var(--mc-green,#3C8527)}
.ucell .sw{position:absolute;right:14px;top:14px;width:26px;height:26px;border-radius:50%;background:var(--sw);box-shadow:inset -5px -5px 0 rgba(0,0,0,.18),0 0 0 2px #fff}
.uslots{display:grid;grid-template-columns:repeat(6,minmax(0,1fr));gap:10px}
.uslots button{height:54px;border-radius:8px;border:1.5px dashed rgba(140,150,200,.45);background:rgba(255,255,255,.6);font:inherit;font-size:12px;color:var(--ink-3);cursor:pointer}
.uslots button b{display:block;font-size:14px;color:var(--ink-2);font-variant-numeric:tabular-nums}
.uslots button[aria-current=true]{border-style:solid;border-color:var(--mc-green,#3C8527)}
@media (max-width:760px){
.skywin{margin:4px -4px 8px;padding:4px}
/* 窗户不铺满屏:上下留出能滑页面的地方 */
.skywin .stage{height:min(64svh,560px);min-height:400px}
.skywin #uGl{touch-action:none} /* 在星图里的手势全归星图:单指转、双指缩放,不会带着页面滑 */
.sky-hint{display:block;margin:0 2px 20px;font-size:12px;color:var(--ink-3);text-align:center}
/* 档案卡:星图窗里的底部抽屉(只占下半个窗),星球被镜头挪到上半个窗 */
.skywin .panel{left:8px;right:8px;top:47%;bottom:8px;width:auto;display:flex;flex-direction:column;justify-content:flex-end;transform:translateY(24px)}
.skywin.full .panel{bottom:calc(8px + env(safe-area-inset-bottom))}
.skywin .panel.on{transform:none}
.skywin .panel .card{max-height:100%;overflow:auto;overscroll-behavior:contain;-webkit-overflow-scrolling:touch;padding:12px 14px 0 18px;touch-action:pan-y}
.skywin .panel .card h2{margin-top:6px;font-size:21px}
.skywin .panel .card .tg{font-size:13px}
.skywin .panel .card .ds{margin-top:6px;font-size:13px;line-height:1.7}
.skywin .panel .card .tags{margin-top:8px}
.skywin .panel .card .tags span{font-size:11.5px;padding:3px 7px}
/* 三个按钮一行,贴在抽屉底边,正文长了在中间滚 */
.skywin .panel .card .acts{position:sticky;bottom:0;display:grid;grid-template-columns:1fr 1fr 1.25fr;gap:6px;margin:10px -14px 0 -18px;padding:8px 14px 12px 18px;background:linear-gradient(rgba(255,255,255,0),#fff 10px)}
.skywin .panel .card .nav{display:contents}
.skywin .panel .card .btn{height:36px;font-size:13px;padding:0 6px 3px}
.skywin .tag .t b{font-size:13px} .skywin .tag .t em{display:none} .skywin .tag.empty{display:none}
.skywin .sector,.skywin .tip{display:none}
.skywin #uBack{display:none !important} /* 手机:返回按钮已经在档案卡里了 */
.skywin .hud{gap:12px;transition:opacity .3s}
.skywin .stage.focus .hud{animation:none;opacity:0} /* 看档案时把读数收起来,别和右上角按钮挤 */
.uni-list{grid-template-columns:1fr 1fr;gap:10px}
.ucell{padding:14px 12px 12px}.ucell h3{font-size:18px}.ucell .sw{width:20px;height:20px;right:10px;top:10px}
.uslots{grid-template-columns:repeat(3,minmax(0,1fr))}
}
@media (prefers-reduced-motion:reduce){.skywin .panel,.skywin .labels,.skywin .hud,.ucell{transition:none;animation:none}}
+188
View File
@@ -0,0 +1,188 @@
# 交接说明 · 金钻宇宙星系图(`portal/assets/universe/`)
> 状态:**已接进门户**(2026-10-05):`portal/index.html` 的「金钻宇宙」板块就是它,原来的启动仪式 / 盘符机架 / 读盘舱已删除。
> 风格参考:《绝地潜兵 2》银河战争地图 —— 旋臂星系 + 星云 + 扇区 + 补给线;每条世界线是一个星系,点进去是一颗卡通星球 + 档案卡。
---
## 1. 文件
| 文件 | 干什么 | 日常要不要改 |
|---|---|---|
| `assets/universe/config.js` | **全部内容和外观配置**:世界线档案、每颗星球的风格 / 颜色 / 卫星、星系配色、扇区名、粒子数量。门户主脚本的 `UNIVERSES` 也从这里读 | **改这个** |
| `assets/universe/planets.js` | 卡通星球材质库(每种「风格」= 一段着色器 + 默认参数) | 加新风格时改 |
| `assets/universe/galaxy.js` | 引擎:画星系、星云、补给线、名牌,处理拖动 / 缩放 / 点击 / 档案卡 / 运镜 | 一般不用动 |
| `assets/universe/universe.css` | 观星窗、档案卡、窗下世界线卡片、手机布局的样式 | 改版式时改 |
| `portal/index.html` 里 `#view-universe` + 底部那段 `<script type="module">` | 板块骨架(窗户 / 名牌层 / HUD / 档案卡 / 卡片列表)和接线代码 | 改交互时改 |
| `assets/vendor/three.module.min.js` | three.js r170(MIT,自托管,不连外网) | 不动 |
**没有任何贴图、模型文件**:星球、星云、星点全是着色器实时生成的,所以没有版权问题,也不用担心图片加载慢。
---
## 2. 常见改动
### 加一条新世界线
1. `config.js` → `UNIVERSES` 里把对应的空槽(比如 `{ no: '0005', empty: true }`)换成完整档案:
```js
{ no: '0005', name: '名字', kind: '原创', tag: '一句话副标题', tags: ['标签1', '标签2'], desc: '档案正文' },
```
字段和门户页原来的 `UNIVERSES` 一模一样(`no / name / kind / tag / tags / desc`),可以直接拷。
2. `config.js` → `LOOKS` 里按编号加外观:
```js
'0005': { style: 'ice', r: 1.2, orbit: [34, 2], accent: '#9FE3FF',
colors: ['#…', '#…', '#…', '#…'], // 可选:覆盖风格默认的四个颜色
ring: true, // 可选:光环(默认没有;用户觉得突兀,现在一颗都没开)
atm: '#9FE3FF', // 可选:大气辉光(默认没有;之前「每颗星外面一个罩子」就是它)
moons: [{ style: 'rock', r: 0.3, d: 2.6, speed: 0.5 }], // 可选:卫星(纯装饰)
why: '为什么长这样(写给后来的人看)' },
```
- `orbit: [离中心距离, 第几条旋臂]`:距离 0~60,旋臂 0~3。别和别的星系放太近(差 8 以上比较好看)。
- 不写 `LOOKS` 的世界线会自动用 `EMPTY_LOOK`(全息线框的「未点亮」样子),放在外圈。
3. 刷新页面即可。HUD 上的「世界线 / 已点亮 / 空槽」数字是自动数的。
### 只换一颗星球的颜色
改它 `LOOKS` 里的 `colors`(四个颜色,含义见下表)。不写就用风格默认值。
### 改整张图的配色
`config.js` → `GALAXY.colors`:底色、核心色、旋臂内外色、星云几组颜色、线条色、UI 强调色(名牌 / 数字的金色)。
**建议整张图只用这几种颜色**,别给每颗星单独配一个刺眼的颜色 —— 上一版就是因为颜色太杂被说丑。
### 改扇区名 / 粒子数量 / 散落星球数量
`GALAXY.sectors`(6 个扇区名)、`GALAXY.particles`、`GALAXY.nebulae`、`GALAXY.decorPlanets`(桌面 / 手机分开设)。
手机卡的话先把 `particles.mobile` 降到 10000、`nebulae.mobile` 降到 10。
---
## 3. 现有的星球风格(`planets.js` → `STYLES`)
| 风格 | 长什么样 | 四个颜色依次是 | 现在给谁用 / 为什么 |
|---|---|---|---|
| `crystal` | 多面体切面、每面颜色随朝向变、内部发光脉络 | 主色 / 副色 / 高光色 / 闪点 | 零号宇宙:晶钻超算本体 |
| `paper` | 米白纸面、铅笔等高线、暗面排线、红笔圈、淡蓝涂色 | 纸色 / 铅笔色 / 红笔色 / 涂色 | 火柴人宇宙:小时候课上画的 |
| `ice` | 纬向冰带、极冠、冰裂纹、冰面高光 | 冰白 / 冰蓝 / 裂纹色 / 极冠色 | 极寒世界:冰河期、-50℃ |
| `neon` | 深紫地表、霓虹街区网格、闪烁窗灯 | 地表 / 霓虹 A / 霓虹 B / 窗灯 | 没落赛博城 |
| `duality` | 一半白昼一半夜空,交界一条发光波浪线 | 白昼 / 云 / 夜空 / 夜云 | 善恶等级(设定还在酝酿,先按名字做;定了再换) |
| `gas` | 卡通条纹气态行星 + 风暴眼 | 条纹 A / 条纹 B / 深色带 / 风暴 | 散落的无名星球、卫星 |
| `rock` | 卡通陨坑岩石星 | 亮面 / 暗面 / 坑底 / 坑沿 | 散落的无名星球、卫星 |
| `ghost` | 半透明全息线框球 | 线色 / 边缘色 / - / - | 空槽(未点亮) |
所有风格共用:三档卡通明暗(亮 / 中 / 暗)+ 冷色阴影(`shadow`)+ 很弱的轮廓光(`rim`)+ 墨线描边(`outline`,写 `null` 不描边)。
大气辉光(`atm`)和光环(`ring`)都是**可选**的,默认关 —— 用户反馈过「罩子」「环」很突兀、辉光太曝。
### 加一种新风格
在 `STYLES` 里加一项:
```js
myStyle: {
defaults: { colors: ['#…','#…','#…','#…'], shadow: '#…', rim: '#…', outline: '#…', glow: 0 },
frag: `void main(){ vec3 V = normalize(cameraPosition - vW); vec3 N = normalize(vN);
vec3 base = mix(uC0, uC1, smoothstep(-0.2, 0.3, fbm(vP*2.0 + uSeed))); // vP = 球面上的点(单位向量)
gl_FragColor = vec4(shade(base, N, V), uAlpha); }`,
},
```
着色器里能用:`snoise(vec3)` 噪声、`fbm(vec3)` 分形噪声、`aline(x, 线宽)` 抗锯齿细线、`shade(颜色, N, V)` 统一上卡通光、
`uC0~uC3` 四个颜色、`uT` 时间、`uSeed` 种子、`uGlow` 自发光强度。然后在 `LOOKS` 里 `style: 'myStyle'` 就能用。
---
## 4. 交互
### 开场 / 飞行动画(运镜库在 galaxy.js 的 MOVES 里)
全部按时间走(和帧率无关),慢设备上也是同一条连贯的路线。
| 运镜 | 名字 | 怎么动 | 现在给谁 |
|---|---|---|---|
| 推进 | `push` | 先转过去对准(前 40%),再笔直推进去,不绕圈 | 火柴人宇宙 |
| 放大 | `zoom` | 先用长焦把它拉近(视角收窄到 14°),再一边推进一边把视角放回来 | 零号宇宙 |
| 升空俯冲 | `rise` | 先拉高到几乎俯视,再从上面扎下去 | 极寒世界 |
| 跃迁 | `warp` | 慢起步、中段猛冲、末段刹住;冲的时候视角张开、镜头轻轻一滚 | 没落赛博城 |
| 绕行 | `orbit` | 边飞边绕过去,中途抬高拉远一点 | 善恶等级;以及「上一个 / 下一个」在星系之间切换时 |
| 拉远 | `pull` | 回星系图:先往后退,再抬头看全景 | 「回到星系图」 |
| 开场 · 盘旋落下 | `introSweep` | 从高空、更远处绕半圈落到正常视角 | 开场(`GALAXY.intro`) |
| 开场 · 垂直坠入 | `introDive` | 从正上方很远处直着落下来,最后才抬起镜头 | 开场(`GALAXY.intro`,默认随机二选一) |
- 每条世界线用哪个入场运镜:`config.js` → `LOOKS[编号].enter`;不写就按 push / zoom / rise / warp / orbit 轮流。
- **档案卡和镜头同步**:点下去时旧档案先收起,镜头飞到 78% 的时候档案卡才滑出来(内容也那时才换),和星球落定同时到。
嵌在页面里时 `onFocus(u, 'start')` 在起飞时回调(列表马上高亮),`onFocus(u, 'arrive')` 在快到时回调(这时再出正文)。
- 飞的途中用户拖动 / 缩放:运镜立刻停在原地交还控制权,没出来的档案卡马上补出来,不会丢。
- 加一种新运镜:往 `MOVES` 里加一项 `{ dur: 毫秒, path(from, to, k) { … 往 view 里写 az/el/dist/tx/ty/tz/fov/roll … } }`,再在 `enter` 里写它的名字。
- 开场在画面第一次进入视口时开始;星系从暗处亮起来(约 2.4 秒),镜头落定后名牌才浮现。「载入中」在第一帧画出来时才淡出。
- 总览时星系会放大一点(桌面 1.35 倍、手机 1.9 倍)好认,飞近时恢复真实大小。
- 桌面:拖动转视角、滚轮缩放、点星球或名牌飞过去、`←` / `→` 切上一个 / 下一个、`Esc` 回到星系图。
- 手机:单指拖动、**双指缩放**、点名牌或星球飞过去;飞过去后星球在上半屏、档案卡是底部抽屉,「回到星系图」在卡里。
- 系统设置了「减少动态效果」:星系不自转、镜头直接切过去、星云不流动。
- 名牌是真正的 `<button>`,键盘 Tab 能选中。
---
## 5. 手机端处理过的冲突(这次修的)
| 问题 | 怎么修的 |
|---|---|
| HUD 的说明文字和星系名牌叠在一起 | 手机只留标题 + 一行读数;落在 HUD 范围里的名牌自动藏起来 |
| 名牌贴边被切掉 | 名牌位置夹在屏幕内(左右各留 6px) |
| 档案卡挡住星球 | 选中后镜头把星球挪到上半屏,档案卡做成底部抽屉(最高 44% 屏高,内容多了卡里自己滚) |
| 左下「回到星系图」被抽屉盖住 | 手机上隐藏它,按钮放进档案卡(整行宽,好点) |
| 空槽名牌太多太挤 | 手机只显示已点亮的名牌,空槽只留星球本身 |
| 不能缩放 | 加了双指缩放 |
| 近处的星点糊成大光斑 | 星点像素大小设了上限 |
| 手机画面比桌面稀、星系只是小点 | 手机和桌面用几乎一样的数量,星点大小按距离补偿,总览时星系放大 1.9 倍 |
| 名牌前的小方块色点 | 去掉了(全站规矩:文字前不放色点) |
| 散落的无名星球乱、互相重叠、卫星有的反着转 | 减到 14 颗;摆放时和核心、各星系(含卫星轨道)、彼此之间都留距离;卫星一律同向转 |
验证:无头浏览器 390×844 / 1440×900 各截一轮,五颗星球逐个飞进去截图,控制台 0 报错、无横向滚动、所有名牌都在屏幕内且不压 HUD。
---
## 6. 在门户里是怎么接的
- `<head>` 里:`assets/universe/universe.css` + 一段 `importmap`(把 `three` 指到 `assets/vendor/three.module.min.js`)。
- 主脚本之前:`<script src="assets/universe/config.js">` —— 主脚本一解析就要读 `window.JZ_UNIVERSE`(首页总览的计数、`#0001` 深链都用它)。
- 页面底部一段 `<script type="module">`:
- 按 `config.js` 渲染窗下的世界线卡片和空槽;
- 对外挂 `window.__jzUniverse = { show(), fly(编号) }`;
- **第一次 `show()` 时才 `import('./assets/universe/galaxy.js')`**,three.js 跟着下载(约 690KB,gzip 后约 170KB)。首页、画展等别的板块不下载它。
- 主脚本:`showBoard('universe')` 调 `__jzUniverse.show()`;`#0001` 这种旧深链调 `__jzUniverse.fly('0001')`;飞到哪条,地址栏就 `replaceState` 成 `#编号`,可以直接分享。
`mountGalaxy()` 的可选参数(门户都用上了):
| 参数 | 干什么 | 门户怎么用 |
|---|---|---|
| `onFocus(u, phase)` | 选中 / 取消选中时回调(`u` 是档案或 `null`;`phase` 是 `start` 起飞 / `arrive` 快到) | 窗下卡片跟着高亮;地址栏跟着改 |
| `layout()` | 返回 `{x, y}`:选中时星球往左 / 往上挪多少 | 桌面 `{x:0.17}`(右边是窗内档案卡);手机 `{y:0.26}`(档案卡是窗里的底部抽屉) |
| `wheelZoom()` | 返回 `false` 时普通滚轮留给页面滚动,按住 Ctrl 才缩放 | 不全屏时 `false`,全屏时 `true` |
| `onReady()` | 第一帧画好 | 淡出「星图载入中」 |
| 返回值 `api.fly(no)` / `api.home()` / `api.resize()` | 从外面控制 | 点卡片 → 先把窗户滚到眼前再 `fly`;切全屏 / 切回板块后 `resize` |
另外:画面滚出视口时自动暂停渲染(省电);手机上星图里的手势全归星图(`touch-action:none`:单指转、双指缩放,页面不会跟着滑),窗户只占屏幕约 64%,上下留了滑页面的地方,窗下有一句提示。
星图起不来(没有 WebGL)时,窗里显示原因,下面的世界线卡片照常能看。
## 7. 改了什么(相对原门户)
删掉:启动仪式(逐字 / 权限扫描 / 欢迎)、宇宙首屏的晶体线框画布(CrystalView)、盘符机架(抽插 / 读盘舱 / 键盘翻页)、两枚只给插卡用的图标(`--icd-logo` 白标、`--icd-people` 火柴人)。
保留:首页右侧的晶钻徽记、`#0001` / `#rack` 旧链接(分别飞到那条世界线 / 打开宇宙板块)。
---
## 8. 性能
- 桌面:4.2 万星点 + 32 片星云 + 14 颗散落星球 + 11 个星系(含卫星)。手机:3.6 万星点 + 28 片星云 + 14 颗(为了和桌面画面一致,只少一点点)。
- ⚠️ **帧率还没在真机上测过**(只在无头浏览器的软件渲染里验证了画面和交互),上线前请用一台普通手机和一台集显笔记本各打开看一下。
- 手机像素比上限 1.5;星点大小按镜头距离补偿,手机和桌面看起来一样密。
- 每颗星球一个绘制调用(加描边、大气各一个),没有实时阴影、没有后处理。
- 卡的话按第 2 节降粒子数;再不行把 `planets.js` 里球体的 `SphereGeometry(r, 96, 64)` 降到 `(r, 48, 32)`。
## 9. 版权
- three.js:MIT(`vendor/three-LICENSE.txt`)。
- 噪声函数:Ashima Arts / Stefan Gustavson 的 3D simplex noise(MIT),写在 `planets.js` 里。
- 星球、星云、星点:全部程序生成,无外部素材。
- 上一版用过的 NASA 星球贴图已经全部撤掉(不再需要署名)。
## 10. 部署注意(踩过的坑)
- 静态文件可能被缓存。**改了 JS / CSS 一定要换版本号**,四处一起换:`portal/index.html` 里的 `universe.css?v=`、`config.js?v=`、底部模块脚本里的 `galaxy.js?v=`,以及 `galaxy.js` 里的 `import './planets.js?v='`。
2026-10-05 踩过:一个坏掉的 galaxy.js 被缓存住,修好之后打开还是「加载不出来」。
- 检查语法要按 ES 模块检查(把文件拷成 `.mjs` 再 `node --check`),按普通脚本检查会漏掉「重复声明」这类错误。
+21
View File
@@ -0,0 +1,21 @@
The MIT License
Copyright © 2010-2024 three.js authors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
File diff suppressed because one or more lines are too long
Binary file not shown.
+135 -1340
View File
File diff suppressed because one or more lines are too long