黑洞法阵

高度的两个单位，混一次就全平#

project() 收的 z 是像素，而法阵每条折线（Wire）上存的 z 是占该座升起高度 riseH 的比例（0 = 贴在盘底、1 = 盘面）。画之前乘回 riseH：

1
const zBase = r.riseH * lift;      // 升起进度也在这里进去
2
const [x, y] = project(r.cx, r.cy, rx, ry, zBase * w.z, RITE_K);

🔴 就是这一行让整页法阵全是平的。 原来 z 的取值是 0.16 ~ 1.0，而绘制处只写了 w.z * lift —— 高度实际是 0.1 ~ 1.0 像素。一座半径两百多像素的法阵，起伏不到一像素，投影出来当然是一张贴纸。症状不是”立体感弱”，是”看起来完全没有高度”。改成”比例 × riseH”之后，同一批图元的高度是 十几到一百多像素。

盘面必须共面，立体感交给”盘厚”#

盘面上的一切（同心环、星形、弦网、放射骨）都落在几乎同一个高度上（0.94 ~ 1.0，单位是 riseH 的比例）。这不是偷懒 —— 恰恰相反：原先把高度按”离中心多远”分成四层大台阶（外圈贴地、内圈抬高到 0.84），看着很立体，但同心环、星形、弦网被抬得互相错位，整座法阵读不成一个图形了。设定图里那些法阵全是同一平面上的完整曼陀罗，所以盘面必须基本共面。

立体感的预算于是全部挪到另一处：盘厚。外圈往下拉出一圈侧壁（skirt）—— 一圈下沿 ＋ 96 条竖直母线，两条 wire、两次 stroke()，给出”这是个实心盘”的全部依据：

1
const DECK = 1;    // 盘面高度（占 riseH）
2
const BODY = 0.78; // 盘底高度 —— DECK − BODY 就是"盘有多厚"

🔴 盘厚要薄。 这里先给过 0.58（厚度 = 0.42·riseH，最大能到 0.18R），实测读出来是一只鼓 —— 侧壁比盘面上任何结构都抢眼，整座阵变成”扣在碗里的图案”。设定图里那些法阵是薄盘：厚度只是”这不是一张贴纸”的最低限度的证据，不该自己成为主角。

折线为此支持逐点高度 zs（给了就覆盖整条的 z），于是两类图元是同一件事：

• 两端半径不同、高度不同 → 一道坡；
• 两端同一位置、只有高度不同 → 一片竖刃（投影里就是一条竖线，一眼看出这东西有厚度）。

⚠️ 竖母线必须是同一 (x, y) 上的两个点。写成”斜着爬上去”的话整条会读成一根撑杆，“厚度”就没了。

同理，涡线（spiral）要”往里旋下去”也靠 zs，但给的是锥面（0.86 → 1.0，中心高）而不是台阶 —— 四层台阶那版是配旧台面写的，台面改成共面之后它塌成 0.94~1.0 的微起伏，等于什么都没做，涡线整条躺在同一层，投影里就退化成一圈套一圈的同心圆（“看着杂”的头号来源）。

立体感有了一半，剩下一半是前后分层。同一平面里的图元要分出”在后面”和”在前面”，靠的不是 z-index，而是算深度：所有图元按旋转后的 y 符号分两趟画，后半先画、前半后画，每段的亮度再按它落在哪一趟调一档（近半 0.95、远半 0.45）。这就是圆环看起来是”绕着黑洞立体的环”而不是”一条椭圆线”的原因。

⚠️ 这里踩过一次：在平面里分层，不能用 z-index “谁画在上面谁先判”。z-index 是给 DOM 分层用的，画布里的前后关系只能是”后画的压先画的”，所以顺序得自己算出来。

🔴 而且分两趟这件事本身翻过一次大车，代价是”法阵只剩一半”。当时用一个 drawing 标志同时管两件事：既表示”当前子折线还连不连着”（决定 lineTo 还是 moveTo），又表示”这条 path 里到底有没有东西”（决定要不要 stroke()）。一圈 97 点的圆环在第 95 段跨出本 half 被跳过时把 drawing 置回 false，循环正好结束 —— 于是 if (!drawing) return 直接把整条 wire 丢掉，49 段明明都 moveTo/lineTo 过了却一次都没描。闭合曲线（圆、环、星）的最后一段永远落在接缝那一侧，所以几乎每条线都中招，整座法阵的上半圈是空的。症状看着像”亮度不均”，其实是”半个阵根本不存在”。修法是拆成两个标志：drawing 管连接，any 管”有没有内容”。

边饰语法：法阵的”贵气”全在那一圈#

把设定图放大到一格一格看，才看清那圈边不是”一条圆线”，是一条完整的、分层刻满东西的边饰带。从外往里一共五层，缺一层就掉档：

这五层加起来的 wire 预算只有 7 条（齿／节点／纹样／锯齿各一条 extra，主副圈各一条），但密度的读感翻了几倍 —— 这正是”要走 extra 合成一条”那条规矩最值钱的地方。

🔴 纹样必须用本阵自己的色。一开始把那一圈纹样和锯齿边给了 CRIMSON（猩红，设定里是”坍缩／危险”的专用色），结果每一座法阵边缘都套着一圈红刺，和暗金／幽青／暗紫的主色直接打架 —— 那是”看着劣质”里最扎眼、也最容易修的一笔。

法阵是一整个发光的场，不是黑盘上的亮线#

这是”劣质感”最后、也是最大的一块。只画折线的话，无论线多密，盘内永远剩下几块没有线经过的纯黑空底，整座阵读成”一个箍了边的空盘子”。

设定图里法阵是一整个发光的圆场：盘缘最亮、越往里越暗（光从边上打进来，中心是暗芯），而盘内没有一处是纯黑。所以绘制时在折线之后再加三到四层加色（lighter）的径向渐变：

1
盘缘亮箍    0.78R → 1.0R，alpha 0 → 0.3     ← 那道"亮箍"
2
整场        0 → R，0.08 → 0.36 → 0.3        ← 把盘从黑里抬起来
3
外溢光晕    1.0R → 1.22R，0.16 → 0          ← "这道光有厚度"（降级档省掉这层）
4
盘心        0.6R 内一点冷白（带一个很慢的呼吸）

🔴 剖面方向反了就毁了。 中心亮、边缘暗会读成”一颗发光的球”，盘就没了。设定图是边缘亮。

⚠️ 加色的峰值要控：这里是单层渐变铺一次，给到 0.3 也不会顶到 255；但”大面积 ≤ 0.2”那条规矩管的是多层累加 —— 盘心那一层仍然只敢给 0.22，因为它叠在整场上面。

⚠️ 全部都要跟着盘面一起压扁：translate 到盘心之后 scale(1, RITE_K)，否则中心是一颗球，不是盘上的光。

配套还有两样”一眼读出这是立体阵”的东西：盘面上方倾斜着转的悬浮光环（0~3 圈），和盘内那层细放射线 ＋ 斜织的弦（radial 72 条 ＋ lattice 24 组，各自一条 extra，亮度只有 0.1）。

🔴 悬浮光环正圆转起来看不见 —— 转速全靠沿弧等距的”珠”给；环本身只负责形状。

🔴 细放射线同理：16~32 条又亮又等长的是辐条（车轮），72 条、亮度压到 0.1 的才是织物。条数和亮度的关系比形状更决定它读成哪种。

空间扭曲：得让”有方向的东西”被推弯#

点状星野做径向重映射只会变密，看不出空间被掰 —— 一片均匀的疏密变化读不出方向。想让它读成”时空被拽弯”，得先往星野里放有方向的长条：尘埃纤维、绕洞的漩涡丝、几道大扫帚臂。它们靠近洞口时被推着弯、被拉长，在极近距离被拉成切向拖影（采样时沿切向多取几个点取最大值），才真的像”空间本身”，而不是”画了一堆弧”。

⚠️ 漩涡丝要三样一起来才散得开：压扁（两个半轴分开给）、逐道旋转（越往外扭得越多，同方向）、半径抖动。只做前两样会变成”水波纹” —— 几百道丝自己对齐成一圈圈同心圆。这是量出来才发现的事。

⚠️ 而且这一涡不能烘。它最早和星野一起烘进位图里，数量、配色、剖面对得上一张参考图，但那一层一条都不会动，整页于是像一张壁纸。现在它是每帧画的一层活丝：半径存真实半径 b（单位 R），每帧用透镜方程正解把它映射成视半径，于是 b < 1R 的丝一定落在视界外 —— 物理上就是”洞口背后那片天被掰出来”，而且会转。差速来自 rate = 2.6 / (1 + b·1.1)，只跟一个只增不减的相位走，没有累积误差。

⚠️ 判断”哪一层真的在动”只有一个客观证据：把两个不同时刻的帧做像素差。动的层会显形，烘死的一条都不出现。

物理底子那一手是引力透镜：透镜方程 β = θ − θE²/θ 反解，对烘好的星野位图做一次径向重映射（θE = 1.0R、8R 窗口）。θ→θE 时 β→0 —— 紧贴视界外的那一圈采回来的是中心附近的天区，整片天被压进极窄一环，环上又密又亮，这就是爱因斯坦环。

⚠️ 三件必须记住的事：

• 只在烘的时候做一次。每帧重映射等于每帧读 500 万像素，两个数量级的代价。贴着视界的那圈环和细弧是每帧另画的，别搞混。
• 烘星野时不能把中心掏空。透镜要靠 θ≈1R 那圈像素去采 β < 1R 的星 —— 留空则环上采回一片空白，“光堆在环上”当场落空。
• 一半的丝要故意放在 1R 以内。它们在画面上本来是看不见的（被不透明的视界圆盖掉），是透镜把它们搬到环外——物理上正是引力透镜的二次像：“洞口背后那片天被掰出来”。

背景那层（星野 + 星云 + 底色 + 几根当”直尺”的尘埃纤维）连同上面那次透镜重映射，是一起烘进一张离屏位图的：这些东西本来就不动，动的只是视差。每帧重抽样上千颗星、几百道纤维，是白扔的预算。星数按画布面积给（w * h / 1500，1440×900 上约 860 颗），窄屏直接给 340 颗。

烘和活的分界线就是一句话：烘只放真的不动的东西，凡是要看出”在动”的一律每帧画。绕洞的丝、暖尘、盘上的亮点、上下细弧全是活层。诊断”没动感”的第一步就是量这个 —— 早先那 468 条丝全烘在静态位图里，一条都不会动，参数怎么调都是死的。

脉冲：一条包络管三件事#

坍缩脉冲的全部形态都从一个秒数 collapse 派生：

• 半径包络：0→0.16s 收到 0.86R（视界真的在缩），0.16→0.34s 弹出去过冲到 1.20R，再 0.5s 落回 1.0R。
• 亮度包络：同一段时间里视界先暗到 0.4，回弹时过曝到 1.25，落回 1。只乘在透镜那一套上（环、细弧、活丝），盘要留着 —— 整页一起暗下去读成”熄灯”，不是”那个天体自己在收缩”。
• 符文：回弹那一刻，洞口边缘浮现一圈暗金古符文，随后散掉。

🔴 关键是半径包络写在 holeOf 里面，不是画的时候再乘一次。命中判定、法阵生成、四层绘制全都从 holeOf 取半径 —— 写在一处，于是”缩进去的那一瞬间点不到洞口""碎片穿进了球里”这类错位从设计上就不存在。这条有个能红的断言兜着（收缩期半径必须小于静息半径的 0.9 倍）。

脉冲还顺手把整页拧成一股：pulse 拉满 → 法阵层所有阵一起提亮 55%（“共振”），引力波变宽变亮，wave 从零重启。同一时刻只动一个共享量，四个读者自己响应。

觉醒四阶：阶数必须是派生的#

吞到 1 / 2 / 4 / 8 座分别对应初醒 / 荧动 / 曜变 / 归墟。形态、法阵库、粒子密度、吞噬速度全读它。

1
export type Stage = 1 | 2 | 4 | 8;
2
export function stageOf(swallowed: number): Stage {
3
  if (swallowed >= 8) return 8;
4
  if (swallowed >= 4) return 4;
5
  if (swallowed >= 2) return 2;
6
  return 1;
7
}

🔴 阶数是”已吞噬数”的函数，不是一个单独的字段。 因为八阶的过载喷发要把层级打回一阶 —— 派生写法只要把计数清零，形态、法阵库、反馈自己就全回来了；置位写法就得在”进阶”和”过载”两条路上各写一遍重置，迟早漏一条。

尺寸上，神给的要求是「黑洞初始时小一点，最大也就目前大小」——所以 8 阶 = 1.0（就是原来那个尺寸），1 阶收到 0.76，一路长回来：

至于”吞了几座”这个读数：页面上没有数字。数量由洞口外围的光点个数暗示（初醒 0 颗、荧动 4 颗、曜变 8 颗、归墟再多一层），文字只给一个阶名。

这一节踩到的四个坑#

① 压扁的环兜不住球。 视界是个正圆，而压扁的环在竖直方向的半轴只有 rr · flat。想让符文圈落在球外，必须 rr · flat > 1。按盘那种 0.32 压扁，rr 要给到 3R 以上才出得来 —— 那已经不是”贴着洞口边缘”了。所以符文圈只能压到 0.72~0.78（略扁、基本是个圆），rr · flat ≈ 1.1~1.2R，正好压在爱因斯坦环外沿：符文读成”刻在那圈光上的”。绕盘的光点同理，压扁比从 0.3 提到 0.46 —— 0.3 的话上下两颗掉进黑球里，而它们正是”数了几颗”的读数。

② 盘面里的东西必须画在核心之前。 那圈金属光环压扁 0.32，竖直半轴只有 0.53R —— 那两段本来就该被视界吃掉（土星环绕到行星背后）。画在核心之后，它就变成”贴着黑球描的一条线”。

③ 一圈符文只许 stroke() 一次。 逐颗描边在加色混合下会把相接处叠成一串珠子（细弧上踩过一模一样的坑）。所有符文塞进同一个 path，代价是线宽只能整圈一个值 —— 这层不需要粗细变化。同理，22 道过载光纹也是一笔。它们的起点走正圆（1.08R，一定在球外）、远端才压扁 —— 反过来写的话竖直那几道的起点落进黑球里，等于在纯黑球面上划金线。

④ 换阶要重烘星野。 透镜参数 θE 跟着 R 走，而星野的透镜重映射只在烘那一步做一次。换阶时不重烘，活丝用的新 θE 和星野里的旧 θE 就成了两套几何。只在换阶那一帧做 —— 那是百万级像素的循环，绝不能每帧。