feat(heatmap): 蛇家族四变体预览 + 后台补齐 story/页面说明文案

验证: 构建 exit 0；实测 F1 循环（loop 1→2、每轮吃到 51 天）、F2 身长 3→26、
      F3 双头、FJ 柱子随爬行点亮、J 柱联动

Spec: none (预览页随选型迭代)

Co-authored-by: GLM-5.3

content/posts/mian-sha.md

@@ -1,20 +1,25 @@
 ---
-title: "面纱"
+title: 面纱
 pubDate: 2026-03-09
 category: reading
-tags: [read]
+tags:
+  - read
+pinned: true
 mood: '#7c3aed'
-bookAuthor: '威廉·萨默塞特·毛姆'
-description: '面纱之下：理想的殉道者与真实的幸存者。'
+bookAuthor: 威廉·萨默塞特·毛姆
+description: 面纱之下：理想的殉道者与真实的幸存者。
+cover: ./assets/面纱.png
+hiddenTag: false
+draft: false
 ---
 
-****面纱之下：理想的殉道者和真实的幸存者****
+**_面纱之下：理想的殉道者和真实的幸存者_**
 
 ### 你用面纱遮蔽他人的窥探，自己也难以一睹世界之实。
 
 这是译者在后记中写下的一句话。很好印证了《面纱》这本书或者说这个题目所蕴含的真相。人们活在面纱之下，以此遮蔽他人的窥探，却也因此困于自己的面纱之下。
 
-见沃尔特像是见最温柔的爱和最悲痛的爱情，以最炽热的心和最真挚的感情去爱，爱上了一个不爱自己的人，最后在爱中将自己陷入漩涡🌀，不得解脱。他富有智慧，又富有对这个世界和社会以及人性最明锐的洞察力，他了解世界的苦难，了解社会的种种表象以及深层次的真相，了解人的“伪装”背后的真实人性。他像是个圣洁的存在，却同样又有着拙劣和“恶毒”的想法，以至于至死都未能从感情漩涡中游出。在我看来，沃尔特对于凯蒂的爱是真切的，对于背叛的恨也是真切的，但从始至终爱始终贯穿永远。在去湄潭府之前，他是冷静的旁观者，他是理性的化身，他有真对于真理的精准见解，有着自己衡量一切的道德标准和不可被践踏的信仰，这是源于理性的不可被磨灭的印记。在感知到背叛，并带着赴死的姿态奔赴湄潭府的过程中，他被感情所裹挟，他既爱又恨，恨凯蒂的背叛，也恨自己爱上了一个与自己原则背道而驰的爱人，他从一开始想让凯蒂也走向死亡，到最后让她离开，看似对于婚姻和这段感情有了一点点解脱，可实际上到死他都未能跨过自己给自己筑起的情感高墙。他是矛盾的，他至死未能宽恕自己，也正如他对世界最后的留言所述：“死的是一条狗”。这不仅是对凯蒂的隐喻，更是他对自己灵魂的终极审判。他终于承认，那个满怀怨恨、试图以爱之名行毁灭之实的自己，才是那条被仇恨吞噬的‘疯狗’。沃尔特的一生，是用最锋利的理性去剖析世界，却唯独不敢直视自己内心那片荒芜的废墟。他死于霍乱，实则死于那层由傲慢与偏见织就的、永远无法揭下的面纱。
+见沃尔特像是见最温柔的爱和最悲痛的爱情，以最炽热的心和最真挚的感情去爱，爱上了一个不爱自己的人，最后在爱中将自己陷入漩涡🌀，不得解脱。他富有智慧，又富有对这个世界和社会以及人性最明锐的洞察力，他了解世界的苦难，了解社会的种种表象以及深层次的真相，了解人的“伪装”背后的真实人性。他像是个圣洁的存在，却同样又有着拙劣和“恶毒”的想法，以至于至死都未能从感情漩涡中游出。在我看来，沃尔特对于凯蒂的爱是真切的，对于背叛的恨也是真切的，但从始至终爱始终贯穿永远。在去湄潭府之前，他是冷静的旁观者，他是理性的化身，他有着对于真理的精准见解，有着自己衡量一切的道德标准和不可被践踏的信仰，这是源于理性的不可被磨灭的印记。在感知到背叛，并带着赴死的姿态奔赴湄潭府的过程中，他被感情所裹挟，他既爱又恨，恨凯蒂的背叛，也恨自己爱上了一个与自己原则背道而驰的爱人，他从一开始想让凯蒂也走向死亡，到最后让她离开，看似对于婚姻和这段感情有了一点点解脱，可实际上到死他都未能跨过自己给自己筑起的情感高墙。他是矛盾的，他至死未能宽恕自己，也正如他对世界最后的留言所述：“死的是一条狗”。这不仅是对凯蒂的隐喻，更是他对自己灵魂的终极审判。他终于承认，那个满怀怨恨、试图以爱之名行毁灭之实的自己，才是那条被仇恨吞噬的‘疯狗’。沃尔特的一生，是用最锋利的理性去剖析世界，却唯独不敢直视自己内心那片荒芜的废墟。他死于霍乱，实则死于那层由傲慢与偏见织就的、永远无法揭下的面纱。
 
 相比之下，凯蒂是幸运的，也最终得到了自由。在虚荣的面纱下，遮住的是世界的残酷和社会的复杂以及人性的不可知。一开始的虚荣心作祟，让她步入了和沃尔特的婚姻，却发现婚后的生活并非是自己所期望的那样，甚至从一开始她就清楚的知道自己并不爱沃尔特。于是，当她到了香港，并遇上查理的时候，她沦陷了，她在查理身上看见了自己所期待的伴侣所拥有的那些特性，幽默风趣，性感迷人，但是却忽视了人性。在去往湄潭府之前，她虚荣，她害怕，她怕沃尔特发现一切，她软弱，她想逃离这样的婚姻和查理相拥，但是她不敢付诸行动。当沃尔特推着她去面对一切的时候，当一切都败露的时候，她终究是看见了人性的恶，她见到了查理的无情和所谓的爱只是言语上的“美好”，她也真正的感到了恐惧，面对死亡的恐惧和面对沃尔特不可捉摸的想法的恐惧。在湄潭府之行的初期，她依旧活在对于过去的回忆之中，她害怕恐惧，她看不见未来。但被圣光照耀的庙堂始终矗立在彼岸，她向往那迷人的色彩，她想要去追求新的生活。当她跨出第一步并开始在修道院工作的时候，她的觉醒之路从此慢慢开始，她慢慢和自己和解，慢慢看淡背叛，慢慢看清查理，慢慢找寻着自己在生活中该有的样子，她开始慢慢摘掉自己的面纱，看清自己的虚伪和软弱，开始追寻道的意义，她感悟周围的一切，甚至想着能够将沃尔特从他的痛苦中将他拉出。然而直到沃尔特死去，他们都没能和解，她愧对沃尔特，她看到了自己的轻贱，可是她自始至终都跨不过沃尔特竖起的高墙，她在墙外，沃尔特在墙内，各自在各自的面纱下痛苦的活着。沃尔特的死，是沃尔特的一种“解脱”，也是凯蒂的一种解脱。
 
@@ -22,7 +27,7 @@ description: '面纱之下：理想的殉道者与真实的幸存者。'
 >
 > 所谓《面纱》，遮住的不仅是真相，更是我们面对真实自我的勇气。沃尔特缺乏这份勇气去接纳不完美的爱与人性，所以他困死其中；凯蒂在生死关头被迫拥有了这份勇气，所以她获得了自由。
 >
-> 故事的最后，死去的人得到了安息，活着的人带着记忆与教训，继续前行。这或许就是毛姆想告诉我们的：****人生没有完美的结局，只有在认清生活的残酷真相后，依然选择热爱并真实地活下去，才是唯一的救赎。****
+> 故事的最后，死去的人得到了安息，活着的人带着记忆与教训，继续前行。这或许就是毛姆想告诉我们的：**_人生没有完美的结局，只有在认清生活的残酷真相后，依然选择热爱并真实地活下去，才是唯一的救赎。_**
 
 从背叛到自我的救赎，凯蒂在远离家乡的异国，没能逃脱欲望作祟，再次回到香港之后又一次沦陷在了查理的怀抱中，但此刻的她早已不是去湄潭府的之前的自己，她的思想早已骤变。她厌恶自己肉体对自己灵魂的出卖，她选择远离这个是非之地，她选择去重新追求自由，亦如从湄潭府离开一样，她再一次走上了追寻自由的路上。她回到故土，见母亲离世，见妹妹怀有身孕，见父亲终于脱离过去的自己，她亦想脱离过去的自己，拥抱一个崭新的未来。活在面纱之下的她和她的父亲，在故事的结局，两人袒露心声，一同前往新的地方开始新的生活，去活出新的自己。
 
@@ -32,7 +37,7 @@ description: '面纱之下：理想的殉道者与真实的幸存者。'
 
 沃尔特死在了他的‘正确’里，而凯蒂活在了她的‘真实’中。沃尔特的故事是带有悲惨的个人主义的牺牲，凯蒂的故事是带有幸运的个人主义的新生。沃尔特自觉没有希望，在困顿的泥潭中深陷，他没有勇气去面对新的生活和新的世界，他将自己紧紧隐藏在自己的面纱之后，他活在自己为自己构建的信念世界之中，为自己的信念，"悲壮”赴死。凯蒂活在纷繁的社会中，从小我见大我，从假我见真我，从困局中得自由。她一步一步从虚伪的面纱下得见人性、社会冷暖以及新世界的希望，湄潭府之前的生活让她自省，湄潭府之行让她感知到一切，在死亡和黑暗中得到感悟和觉醒，得见光明，再次回到香港，欲望再次作祟，这一次她没有沉沦于虚妄的现实，她终于携手勇气做出了自己的决定，踏上了"离开”的归程。
 
-故事的最后，面纱已落。凯蒂带着伤痕，牵着父亲的手，走向巴哈马的阳光。那里没有豪门的虚妄，没有激情的幻象，只有平凡而坚实的生活。这，或许就是毛姆留给所有在虚荣与迷茫中挣扎的人们，最温柔的答案：****唯有真实，可得自由。****
+故事的最后，面纱已落。凯蒂带着伤痕，牵着父亲的手，走向巴哈马的阳光。那里没有豪门的虚妄，没有激情的幻象，只有平凡而坚实的生活。这，或许就是毛姆留给所有在虚荣与迷茫中挣扎的人们，最温柔的答案：**_唯有真实，可得自由。_**
 
 在《面纱》的故事中，沃尔特是极具“英雄主义”的个人，为自己固有的信仰慷然赴死；凯蒂是在纷杂的社会中逐步成长，在欲望和虚荣的交叉间度过早年，湄潭府一行，在黑暗中见光明，在死亡中见希望，在异国见真我，在“新世界”得自由。
 
@@ -41,51 +46,28 @@ description: '面纱之下：理想的殉道者与真实的幸存者。'
 ------------------------------------------------------------------------
 
 - 我不了解你，我一点儿都不了解你。
-
 - 我知道你愚蠢、轻浮、没有头脑，但是我爱你。我知道你的目标和理想既庸俗又普通，但是我爱你。我知道你是二流货色，但是我爱你。想一想真是好笑，我竭力去喜欢那些讨你喜欢的东西，忍受折磨也要对你隐瞒起自己，实际上我并不无知粗俗、不爱散播丑闻也不愚蠢。我知道你何等害怕智慧，便尽我所能让你觉得我是个大傻瓜，跟你认识的其他人一样。我知道你嫁给我只图一时利益，我是那样爱你，我不在乎。大多数人，就我所知，当他们爱一个人，却没有得到爱的回报时就会觉得委屈不平，甚至愈发愤怒和痛苦。我不是那样，我从来没有指望你爱我，我看不出任何理由让你爱我，我也从来没想过自己会被人爱。我很感激能被允许爱你，当我时常想起你高兴跟我在一起，或者当我发现你眼中闪烁着愉快的爱意时，我就会欣喜若狂。我尽量不让我的爱来烦扰你，我知道那会让我承受不起，所以我一直察言观色，留意我的爱让你厌烦的最初迹象。大部分丈夫认为那是一种权力，我却准备当成恩惠来接受。
-
 - 他知道你虚荣、懦弱、自私自利，他想让我亲眼看到这一切。他知道你会像野兔一样，危险一来就跑得远远的。他知道我深受蒙骗才会认为你爱上了我，因为他知道你不会爱任何人，只爱你自己。他知道你会牺牲我，好让自己毫发无损地逃脱出去。
-
 - 死亡既突然又无情，在一条条曲折的街巷上匆匆穿过。
-
 - 黎明乍现，阳光触到雾霭，令其闪闪发白，犹如雪之幽灵降至即将熄灭的星宿之上。
-
 - 你瞧，这里只有你跟我踏踏实实在坚实的地上行走。修女们走在天上，而你丈夫则走在黑暗里。
-
 - 他的灵魂撕裂了，他一直活在一种虚假的构想之中，当真相击碎了幻象，他便认为现实本身也被击碎了。
-
 - 这个时辰的城市街巷空空荡荡，比任何时候都更像一座死城。路人一个个神色迷离，不禁让人怀疑他们全都是鬼魂。天空晴朗无云，初升的太阳将圣洁和煦的光芒洒满大地。很难想象，在这个愉悦、清新、爽朗的黎明，这座城市却像被疯子一手扼住咽喉的人，在瘟疫的黑暗掌控下苟延残喘。不可思议的是，当人类在痛苦挣扎、在恐惧中走向死亡时，大自然（蓝色的天空如孩童的心一般清澈）竟会如此无动于衷。
-
 - 安宁只存在于人的灵魂中。
-
 - 所有的人，乃至整个人类，就如同这条河里的水滴一样，流淌不定，一滴滴彼此接近，却又相距遥远，汇成一股无名的巨流奔向大海。既然一切转瞬即逝，任何事物都无关宏旨，人们竟还要荒唐地看重那些微不足道的事情，让自己也让别人遭受不幸，这实在太可悲了。
-
 - 小小的两滴水随着河流默默流向未知，这两滴水相对而言是那样独特，但在旁观者的眼里，不过是河流中无法辨识的组成部分。
-
 - 我又明白什么呢，生命是那么奇特。我觉得自己就像个一辈子都住在小池塘边上的人，突然间看见了大海，让我有点喘不过气来，但心里又充满了喜悦。我不想死，想活下去，于是感到一股新的勇气。我就好像那些老水手，起航驶向尚未发现的海洋，我的灵魂渴求未知的一切。
-
 - 小小的两滴水默默地、默默地流向那黑暗、永恒的大海。
-
 - 道。我们有些人在鸦片中寻找道，有些人在上帝那儿，有些人寻求威士忌，或去爱里寻找。这道终归只有一条，可它不通向任何地方。
-
 - 这一切既新奇又感人，她的心灵犹如一片平静而灰暗的大海，波浪起伏，蔚然壮观，阴郁浩瀚令人畏惧，突然间，一缕阳光投射过来，让一切变得活泼、友好而快乐。
-
 - 人生何其短暂，世界本来就充满了苦痛，人们却还要折磨自己，这岂不太可怜了吗？
-
 - 她的性格就像一片乡野，初见时感觉辽阔而冷漠，但不久就会在巍峨山岭的褶皱间发现一个个掩映在果树丛中的欢腾的村庄，看见郁郁葱葱的草地上欢快流淌的一条条小河。这番宜人的景象会让你惊奇，甚至熨帖安心，但远处狂风劲吹的黄褐色高地尚不足以使你感到自如自在。
-
 - 只有一种办法赢得人心，那就是让自己成为人们会去爱的人。
-
 - 我说不清。我不知道她们追求幻觉这一点是否真的那么重要，还是这种生活本身就很美好。我有个想法，唯一让我们有可能不带嫌恶地关注我们所生活的这个世界的，就是人类不断从混沌中创造出的美。他们描绘的画，他们谱出的乐曲，他们写的书，还有他们的生活。这一切中，最富于美的就是美好的生活，那是件完美的艺术品。
-
 - 道就是道路和行道者。那是一条永恒的路，所有的生命存在行走其上，但它并非由生命存在所创造，因为它本身便是生命存在。它什么都是，又什么都不是。万物由道所生，与道相符，最后万物又回归于道。它是一块方形却无四角，是种声音却不被聆听，是幅图画却未有形状；它是一张巨大的网，网眼阔如海洋，却什么都无法穿过；它是万物寻求庇护的避难所；它无处可寻，但你‘不窥牖’便可‘见天道’；它要人学会欲无所欲，让一切顺其自然。谦卑者尽得保全，屈身者终将直立。‘祸兮，福之所依；福兮，祸之所伏’；但谁能说清什么时候会出现转折点？追求柔慈之人会如小孩子一样平和。柔慈为进攻者获取胜利，为守卫者求得保全。战胜自己的人最为强大。
-
 - 自由！这便是一直萦绕在她心中的念头。尽管未来仍旧模糊，这一念头却像河上的薄雾，在清晨阳光的照耀下焕发虹彩。自由！不仅仅是挣脱烦恼的束缚，解除那让她消沉的伴侣关系的自由。自由！不仅是逃离死亡威胁的自由，更是逃离让她降低人格的爱情，逃脱所有精神束缚的自由，一种抽离出肉体的精神的自由。与自由相伴的，还有勇气，以及无论发生什么都毫不在乎的坚强气质。
-
 - 她以为自己变了，以为自己意志坚强，会以一个冷静自持的女人的面目回到香港。心中掠过一个个崭新的念头，就像阳光下翻飞的黄色蝴蝶，让她对美好的未来充满期望。自由就像光的精灵召唤她，整个世界犹如一片广袤的平原，任她迈着轻快的步子昂首前行。她原以为自己已摆脱了肉欲和卑劣的情爱，足以过上一种纯洁健康的精神生活。她曾将自己比作黄昏时分悠然飞跃稻田的白鹭，它们就像安闲自处的头脑中翩然翱翔的片片思绪，可实际上她却仍是欲望的奴隶。
-
 - 我有希望，也有勇气。
-
 - 你用面纱遮蔽他人的窥探，自己也难以一睹世界之实。
 
 ------------------------------------------------------------------------

content/posts/ni-tan.md

@@ -1,11 +1,16 @@
 ---
-title: "泥潭"
+title: 泥潭
 pubDate: 2026-02-09
 category: reading
-tags: [read]
-mood: '#166534'
-bookAuthor: '刘楚昕'
-description: '迷失于黑夜时，不妨抬头看看星空。'
+tags:
+  - read
+pinned: false
+mood: '#686868'
+bookAuthor: 刘楚昕
+description: 迷失在黑夜中时，不妨抬头看看星空；如果不知道该相信什么，人应当面对自己的良知。
+cover: ./assets/泥潭.png
+hiddenTag: false
+draft: false
 ---
 
 ### 迷失在黑夜中时，不妨抬头看看星空；如果不知道该相信什么，人应当面对自己的良知。

content/posts/shu-zui.md

@@ -1,11 +1,16 @@
 ---
-title: "赎罪"
+title: 赎罪
 pubDate: 2026-02-26
 category: reading
-tags: [read]
-mood: '#9f1239'
-bookAuthor: '伊恩·麦克尤恩'
-description: '因一个人、一张图、一句台词，看了一本书。'
+tags:
+  - read
+pinned: false
+mood: '#bf002f'
+bookAuthor: 伊恩·麦克尤恩
+description: 亲爱的塞西莉亚，我们缘分未尽
+cover: ./assets/赎罪.png
+hiddenTag: false
+draft: false
 ---
 
 ### 你要回来，我会等你。

content/posts/writing-template.md

@@ -1,10 +1,14 @@
 ---
-title: "写作模板：这篇文章本身就是模板"
+title: 写作模板：这篇文章本身就是模板
 pubDate: 2026-11-02
 category: tech
-tags: [写作, 模板]
+tags:
+  - 写作
+  - 模板
 pinned: true
 description: 一篇文章演示全站可用的排版能力：标题层级、彩色强调、字族、引用、代码窗、表格、图、链接卡、折叠。复制它开始写新文。
+hiddenTag: true
+draft: false
 ---
 
 这篇不是教程，是**可复制的模板**。下面每一节都在真跑——你看到的效果，就是 Markdown 源码能产出的效果。写新文章时，把本文件复制一份、改个 slug、删掉不需要的段落即可。

content/site/opensource.yaml

@@ -1,4 +1,3 @@
-# 打字机动效文案（档案卡顶部逐字轮播；每行双语，最多 6 行；留空用内置默认三行）
 typing:
   - zh: 气象出身，写代码为乐
     en: Trained in meteorology, coding for fun
@@ -6,9 +5,6 @@ typing:
     en: Self-hosting whatever can be self-hosted
   - zh: 拥抱开源，热爱开源
     en: Embrace open source, love open source
-  - zh: 书与快门都在一个工作台
-    en: Books and shutters, one workbench
-
 blurb:
   zh: 本站本身即开源：
   en: 'This site is itself open source:'
@@ -20,11 +16,4 @@ blurb_after:
 mode: all
 sort: pinned-first
 perSource: github
-intro_from: "off"
-
-# ---- 开篇来源说明（2026-11-02 Phase 5h）----
-# 开篇已改原生 GitHub 档案卡（头像 / 统计四格 / 语言占比灰阶条），不再渲染 README 原文。
-# intro_from: "off"      = 用档案卡 + 上面的 blurb（当前）
-# intro_from: github-readme = 构建期取 wait4xx/wait4xx 的 README 原样渲染（**不推荐**：
-#   会引入 7 类第三方外链图，慢网或被墙时整片空白；README 用 <div align="center"> 居中，
-#   本站不认该属性 → 居中失效。这正是当初"内容没居中、图片不显示"的根因。）
+intro_from: 'off'

public/admin/config.yml

@@ -143,6 +143,73 @@ collections:
   - name: site_pages
     label: 页面文案
     files:
+      - name: pages
+        label: 瞬间 / 书架 标题下的说明
+        file: content/site/pages.yaml
+        format: yaml
+        hint: 这两页大标题下面那一行字，文字与样式都在这里改
+        fields:
+          - label: 瞬间页
+            name: moments
+            widget: object
+            required: false
+            fields:
+              - label: 说明文字
+                name: note
+                widget: object
+                required: false
+                hint: 支持 markdown 与排版类（字体/颜色）
+                fields:
+                  - { label: 中文, name: zh, widget: markdown, required: false }
+                  - { label: English, name: en, widget: markdown, required: false }
+              - label: 样式
+                name: style
+                widget: object
+                required: false
+                hint: 留空用全站默认；越界值会被自动夹取（不会破版）
+                fields:
+                  - { label: 字号（px，11–16）, name: size, widget: number, required: false, value_type: int, min: 11, max: 16 }
+                  - label: 颜色
+                    name: color
+                    widget: select
+                    required: false
+                    hint: 只开放灰阶层级，避免正文被染色
+                    options: [ink-1, ink-2, ink-3, ink-4]
+                  - label: 字体
+                    name: font
+                    widget: select
+                    required: false
+                    options: [font-sans, font-serif, font-kai, font-huiwen, font-kuaile, font-xiaowei, font-huangyou, font-mashanzheng, font-liujianmaocao, font-smiley, font-neoxihei]
+          - label: 书架页
+            name: books
+            widget: object
+            required: false
+            fields:
+              - label: 说明文字
+                name: note
+                widget: object
+                required: false
+                hint: 支持 markdown 与排版类（字体/颜色）
+                fields:
+                  - { label: 中文, name: zh, widget: markdown, required: false }
+                  - { label: English, name: en, widget: markdown, required: false }
+              - label: 样式
+                name: style
+                widget: object
+                required: false
+                hint: 留空用全站默认；越界值会被自动夹取（不会破版）
+                fields:
+                  - { label: 字号（px，11–16）, name: size, widget: number, required: false, value_type: int, min: 11, max: 16 }
+                  - label: 颜色
+                    name: color
+                    widget: select
+                    required: false
+                    options: [ink-1, ink-2, ink-3, ink-4]
+                  - label: 字体
+                    name: font
+                    widget: select
+                    required: false
+                    options: [font-sans, font-serif, font-kai, font-huiwen, font-kuaile, font-xiaowei, font-huangyou, font-mashanzheng, font-liujianmaocao, font-smiley, font-neoxihei]
       - name: home
         label: 主页设置
         file: content/site/home.yaml
@@ -544,11 +611,19 @@ collections:
             fields:
               - { label: 中文, name: zh, widget: string }
               - { label: English, name: en, widget: string }
-          - label: 叙述（链接前）
+          - label: 叙述（推荐改这里）
+            name: story
+            widget: object
+            required: false
+            hint: '整段叙述写成一个字段即可（markdown + 排版类），链接直接写在句子里：[本站源码](https://git.wait4x.online/wait4x/blog) —— 这样就不用再分"链接前/链接后"。留空时才会退回下面的旧字段拼接'
+            fields:
+              - { label: 中文, name: zh, widget: markdown, required: false }
+              - { label: English, name: en, widget: markdown, required: false }
+          - label: 叙述（旧：链接前）
             name: blurb
             widget: object
             required: false
-            hint: 富文本（markdown + 排版类），渲染在仓库链接之前
+            hint: 'legacy：仅当上面的「叙述」为空时才使用（历史字段，为把仓库链接夹在中间而拆成两半）'
             fields:
               - { label: 中文, name: zh, widget: string, required: false }
               - { label: 英文, name: en, widget: string, required: false }

scripts/build-perf/content-lint.mjs

@@ -16,6 +16,9 @@ if (MODE === 'skip') {
 const SKIP_PREFIX = ['/admin/', '/photos-originals/']; // admin=CMS 路由；photos-originals=部署期 rsync 叠加层（不在 dist，另有部署链保障）
 const SKIP_FILE = new Set(['/404.html']); // Astro 404 页不参与配对
 
+// 一次性预览路由（无 en 对应页）：完全不参与检查。用户选定方案后随路由一起删除。
+const SKIP_ALL = new Set(['/heatmap-preview/index.html']);
+
 
 function walk(dir, out = []) {
   for (const e of readdirSync(dir)) {
@@ -50,6 +53,7 @@ const warns = [];
 
 for (const f of files) {
   const rel = f.slice(DIST.length) || '/';
+  if (SKIP_ALL.has(rel)) continue;
   const html = readFileSync(f, 'utf8');
 
   // 站内 <a href>：仅根相对路径；#锚点/mailto/tel/外部/data: 全跳过

src/components/geek/HeatGrid.astro

@@ -0,0 +1,58 @@
+---
+/**
+ * 热力图网格（可复用渲染件）：给 5 个动效方案预览共用，避免把 371 个格子抄五遍。
+ *
+ * 每格带 `data-c/--c`（列=周）与 `data-r/--r`（行=星期），动效方案靠这两个自定义属性
+ * 算错峰延迟；`data-l` 是灰阶档（0–4，复用 tokens 的 --ink-1..4）。
+ * 全部格子 aria-hidden：语义由外层 role="img" + aria-label 概括（371 个 aria 节点是噪音）。
+ */
+import { levelOf, type HeatDay } from '../../lib/heatmap';
+
+interface Props {
+  weeks: HeatDay[][];
+  /** 网格类型，仅用于选择器命名（不动行为） */
+  variant: string;
+  /** 单元格错峰延迟基数（ms），0 = 不设延迟 */
+  step?: number;
+}
+
+const { weeks, variant, step = 0 } = Astro.props;
+---
+
+<div class={`hg hg-${variant}`} data-hg={variant}>
+  {weeks.map((week, ci) =>
+    week.map((day, ri) => (
+      <span
+        class={`hg-c hg-l${levelOf(day.count)}`}
+        data-c={ci}
+        data-r={ri}
+        data-count={day.count}
+        data-date={day.date}
+        style={step ? `--c:${ci};--r:${ri};--d:${(ci + ri) * step}ms` : `--c:${ci};--r:${ri}`}
+        aria-hidden="true"
+      />
+    )),
+  )}
+</div>
+
+<style>
+  .hg {
+    display: grid;
+    grid-auto-flow: column;
+    grid-template-rows: repeat(7, 10px);
+    grid-auto-columns: 10px;
+    gap: 3px;
+  }
+  .hg-c {
+    width: 10px;
+    height: 10px;
+    border-radius: 2px;
+    /* 与线上热力图同口径：空格用 hairline 描边、四档用 ink 灰阶（亮暗自动跟随），
+       accent 只留给各方案的"高亮"（glow / flow / 连续数字），不参与数据编码 */
+  }
+  .hg-l0 { border: 1px solid var(--line); }
+  .hg-l1 { background: var(--ink-4); }
+  .hg-l2 { background: var(--ink-3); }
+  .hg-l3 { background: var(--ink-2); }
+  .hg-l4 { background: var(--ink-1); }
+</style>

src/pages/heatmap-preview.astro

@@ -0,0 +1,418 @@
+---
+/**
+ * 热力图动效方案 v3（Phase 5j）——用户选定方向「F+J」，但要求贪吃蛇能**循环**，
+ * 并希望再看几个新变体。故本页给四个蛇家族方案 + J 柱状图参考：
+ *
+ *   F1 循环贪吃蛇（GitHub README 蛇的循环逻辑）
+ *   F2 生长蛇（吃得越多身体越长）
+ *   F3 双蛇对开（两头同时吃，交汇于年中）
+ *   FJ 蛇 + 月度柱联动（用户要的 F+J 组合）
+ *   J  月度柱状图（单独保留作参考）
+ *
+ * 设计红线：accent 只做高亮不参与数据编码（数据密度仍由 ink 四档承载）、
+ * prefers-reduced-motion 静态化、离开视口即停、零第三方依赖。
+ */
+import BaseLayout from '../layouts/BaseLayout.astro';
+import HeatGrid from '../components/geek/HeatGrid.astro';
+import { loadHeatmap, type HeatDay } from '../lib/heatmap';
+
+const { weeks, total } = await loadHeatmap();
+const days: HeatDay[] = weeks.flat();
+const buildTime = new Date().toISOString().slice(0, 10);
+
+/* 连续贡献（本地计算，口径：以最后一个有贡献的日子为终点往回数） */
+const countOf = new Map(days.map((d) => [d.date, d.count]));
+const isoOf = (d: Date) => d.toISOString().slice(0, 10);
+const lastActive = [...days].reverse().find((d) => d.count > 0)?.date ?? '';
+let current = 0;
+if (lastActive) {
+  const start = new Date(`${lastActive}T00:00:00Z`);
+  for (let i = 0; ; i++) {
+    const d = new Date(start);
+    d.setUTCDate(start.getUTCDate() - i);
+    if ((countOf.get(isoOf(d)) ?? 0) > 0) current++;
+    else break;
+  }
+}
+let longest = 0;
+let run = 0;
+for (const d of days) {
+  run = d.count > 0 ? run + 1 : 0;
+  if (run > longest) longest = run;
+}
+
+/* 月度聚合（J / FJ 用） */
+const byMonth = new Map<string, number>();
+for (const d of days) {
+  const key = d.date.slice(0, 7);
+  byMonth.set(key, (byMonth.get(key) ?? 0) + d.count);
+}
+const months = [...byMonth.entries()].sort(([a], [b]) => a.localeCompare(b));
+const maxMonth = Math.max(...months.map(([, v]) => v));
+const activeDays = days.filter((d) => d.count > 0).length;
+const stats = { total, current, longest, activeDays };
+---
+
+<BaseLayout title="热力图动效方案 v3 · wait4x" description="贪吃蛇的四个循环变体 + 月度柱状图">
+  <h1 class="pv-title">热力图：蛇的四个变体</h1>
+  <p class="pv-note">
+    按你的选择做成 <strong>F + J</strong> 方向，并让蛇<strong>循环</strong>爬（学 GitHub README 蛇的
+    节奏：吃完一轮 → 停顿 → 清空 → 再来）。真实数据：近一年 <strong>{stats.total}</strong> 次贡献 ·
+    {stats.activeDays} 天有贡献 · 当前连续 {stats.current} 天 · 数据更新于 {buildTime}。
+    <br />
+    <strong>回字母告诉我选哪个</strong>（F1 / F2 / F3 / FJ / J），也可以说「FJ 但循环慢一点」。
+  </p>
+
+  <nav class="pv-switch" aria-label="方案跳转">
+    <a href="#f1" class="pv-chip">F1 · 循环贪吃蛇</a>
+    <a href="#f2" class="pv-chip">F2 · 生长蛇</a>
+    <a href="#f3" class="pv-chip">F3 · 双蛇对开</a>
+    <a href="#fj" class="pv-chip">FJ · 蛇 + 柱联动</a>
+    <a href="#j" class="pv-chip">J · 月度柱</a>
+  </nav>
+
+  <!-- ══════ F1 · 循环贪吃蛇 ══════ -->
+  <section id="f1" class="pv-sec">
+    <header class="pv-head">
+      <span class="pv-tag mono">F1</span>
+      <h2>循环贪吃蛇</h2>
+      <p class="pv-pros">蛇沿格子蛇形爬一年，吃到有贡献的日子就点亮；爬到尽头停一拍、清空、重新开始，
+        <b>无限循环</b>。身体保持 6 格长度（GitHub README 蛇手感）。</p>
+    </header>
+    <div class="hm-wrap" data-snake data-body={6}>
+      <HeatGrid weeks={weeks} variant="f1" />
+    </div>
+    <p class="hm-read mono"><span data-snake-read>准备出发…</span> · 第 <span data-snake-loop>1</span> 轮 ·
+      <button class="hm-btn" type="button" data-snake-toggle>暂停</button></p>
+  </section>
+
+  <!-- ══════ F2 · 生长蛇 ══════ -->
+  <section id="f2" class="pv-sec">
+    <header class="pv-head">
+      <span class="pv-tag mono">F2</span>
+      <h2>生长蛇</h2>
+      <p class="pv-pros">每吃到一天就长一节（最长 26 节），前半程是细蛇、后半程拖成长尾，吃完循环重置。
+        <b>优点</b>"积累"的隐喻最强；<b>代价</b>尾长时略挡格子。</p>
+    </header>
+    <div class="hm-wrap" data-snake data-body={3} data-grow={26}>
+      <HeatGrid weeks={weeks} variant="f2" />
+    </div>
+    <p class="hm-read mono"><span data-snake-read>准备出发…</span> · 蛇长 <span data-snake-len>3</span> 节</p>
+  </section>
+
+  <!-- ══════ F3 · 双蛇对开 ══════ -->
+  <section id="f3" class="pv-sec">
+    <header class="pv-head">
+      <span class="pv-tag mono">F3</span>
+      <h2>双蛇对开</h2>
+      <p class="pv-pros">两条蛇分别从最早与最新一头出发对向而吃，在年中附近交汇，吃完一起循环。
+        <b>优点</b>更有戏剧性、时间感双向；<b>代价</b>两条同时动，注意力会被分走。</p>
+    </header>
+    <div class="hm-wrap" data-snake data-body={5} data-dual="1">
+      <HeatGrid weeks={weeks} variant="f3" />
+    </div>
+    <p class="hm-read mono"><span data-snake-read>准备出发…</span></p>
+  </section>
+
+  <!-- ══════ FJ · 蛇 + 月柱联动 ══════ -->
+  <section id="fj" class="pv-sec">
+    <header class="pv-head">
+      <span class="pv-tag mono">FJ</span>
+      <h2>蛇 + 月度柱联动 <span class="pv-rec">你的选择方向</span></h2>
+      <p class="pv-pros">蛇每爬进一个月，对应的柱子就同步升起并高亮；爬到年末时十二根柱子全部立起，
+        然后蛇回到起点、柱子清零、再来一轮。<b>优点</b>格子与柱状图互相解释，信息与动感兼得。</p>
+    </header>
+    <div class="hm-wrap" data-snake data-body={6} data-bars-link="1">
+      <HeatGrid weeks={weeks} variant="fj" />
+    </div>
+    <ul class="hm-bars" data-months>
+      {months.map(([m, v], i) => (
+        <li>
+          <span class="hm-bar-btn"><span class="hm-bar-fill" data-month-idx={i} style={`--h:${Math.round((v / maxMonth) * 100)}%`} /></span>
+          <span class="hm-bar-label mono">{m.slice(5)}</span>
+        </li>
+      ))}
+    </ul>
+    <p class="hm-read mono"><span data-snake-read>准备出发…</span></p>
+  </section>
+
+  <!-- ══════ J · 月度柱（单独参考）══════ -->
+  <section id="j" class="pv-sec">
+    <header class="pv-head">
+      <span class="pv-tag mono">J</span>
+      <h2>月度柱状图</h2>
+      <p class="pv-pros">不带动效时的样子：进视口逐根升起，指针移到柱子上，对应月份的格子同时高亮。
+        <b>可单独用，也可像 FJ 那样与蛇联动。</b></p>
+    </header>
+    <div class="hm-wrap" data-bars>
+      <HeatGrid weeks={weeks} variant="j" />
+    </div>
+    <ul class="hm-bars" data-bars-chart>
+      {months.map(([m, v]) => (
+        <li>
+          <button class="hm-bar-btn" type="button" data-month={m} aria-label={`${m} 共 ${v} 次`}>
+            <span class="hm-bar-fill" style={`--h:${Math.round((v / maxMonth) * 100)}%`} />
+          </button>
+          <span class="hm-bar-label mono">{m.slice(5)}</span>
+        </li>
+      ))}
+    </ul>
+  </section>
+
+  <p class="pv-foot mono">数据口径：GitHub GraphQL 贡献日历，构建期快照（{buildTime}）。"减少动态效果"下全部静态；离开视口自动暂停。</p>
+
+  <span hidden data-months-map={JSON.stringify(months.map(([m]) => m))} data-weeks={weeks.length}></span>
+</BaseLayout>
+
+<script>
+  const reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
+  const weeksN = Number(document.querySelector<HTMLElement>('[data-weeks]')?.dataset.weeks ?? 53);
+  const monthKeys: string[] = JSON.parse(
+    document.querySelector<HTMLElement>('[data-months-map]')?.dataset.monthsMap ?? '[]',
+  );
+
+  /** 蛇形路径：按列推进，奇数列自下而上（与 GitHub README 蛇同构） */
+  const buildPath = () => {
+    const p: number[] = [];
+    for (let c = 0; c < weeksN; c++) {
+      const rows = [0, 1, 2, 3, 4, 5, 6];
+      if (c % 2 === 1) rows.reverse();
+      for (const r of rows) p.push(c * 7 + r);
+    }
+    return p;
+  };
+  const PATH = buildPath();
+
+  for (const wrap of document.querySelectorAll<HTMLElement>('[data-snake]')) {
+    const cells = [...wrap.querySelectorAll<HTMLElement>('.hg-c')];
+    const readEl = wrap.parentElement?.querySelector<HTMLElement>('[data-snake-read]');
+    const loopEl = wrap.parentElement?.querySelector<HTMLElement>('[data-snake-loop]');
+    const lenEl = wrap.parentElement?.querySelector<HTMLElement>('[data-snake-len]');
+    const toggle = wrap.parentElement?.querySelector<HTMLButtonElement>('[data-snake-toggle]');
+    const barsEl = wrap.parentElement?.querySelector<HTMLElement>('[data-months]');
+    const bars = barsEl ? [...barsEl.querySelectorAll<HTMLElement>('[data-month-idx]')] : [];
+
+    const baseBody = Number(wrap.dataset.body ?? 6);
+    const growTo = Number(wrap.dataset.grow ?? 0);
+    const dual = wrap.dataset.dual === '1';
+    const barsLink = wrap.dataset.barsLink === '1';
+
+    let body = baseBody;
+    let eaten = 0;
+    let loopNo = 1;
+    let timer = 0;
+    let paused = false;
+    // 双蛇：两条独立游标，反向推进
+    const cursors = dual ? [0, PATH.length - 1] : [0];
+    const dirs = dual ? [1, -1] : [1];
+    const trails: number[][] = cursors.map(() => []);
+
+    const paint = () => {
+      cells.forEach((c) => c.classList.remove('snake-head', 'snake-body', 'snake-eaten'));
+      trails.forEach((t) => t.forEach((i) => cells[i]?.classList.add('snake-body')));
+      cursors.forEach((cur, si) => {
+        const cell = cells[PATH[cur]];
+        if (cell) cell.classList.add('snake-head');
+        const e = trails[si];
+        if (e) e[e.length - 1] = PATH[cur];
+        void cur;
+      });
+    };
+
+    const reset = (full: boolean) => {
+      eaten = 0;
+      body = baseBody;
+      cursors.forEach((_, i) => (cursors[i] = i === 0 ? 0 : PATH.length - 1));
+      trails.forEach((t) => (t.length = 0));
+      cells.forEach((c) => c.classList.remove('snake-head', 'snake-body', 'snake-eaten'));
+      if (full) bars.forEach((b) => b.classList.remove('on'));
+      if (lenEl) lenEl.textContent = String(body);
+      if (loopEl) loopEl.textContent = String(loopNo);
+    };
+
+    const step = () => {
+      let moved = false;
+      cursors.forEach((cur, si) => {
+        const idx = PATH[cur];
+        if (idx === undefined) return;
+        moved = true;
+        const cell = cells[idx];
+        if (!cell) return;
+        // 轨迹队列：保持 body 长度
+        const trail = trails[si];
+        trail.push(idx);
+        if (trail.length > body) {
+          const dropped = trail.shift();
+          cells[dropped ?? -1]?.classList.remove('snake-body');
+        }
+        cells.forEach((c) => c.classList.remove('snake-head'));
+        cursors.forEach((c2) => cells[PATH[c2]]?.classList.add('snake-head'));
+        cells[idx].classList.add('snake-body');
+
+        const count = Number(cell.dataset.count ?? 0);
+        if (count > 0) {
+          cell.classList.add('snake-eaten');
+          eaten++;
+          if (growTo) body = Math.min(growTo, body + 1);
+          if (readEl)
+            readEl.textContent = `${cell.dataset.date} · 吃到 ${count} 次（累计 ${eaten} 天）`;
+        }
+        // 月份联动：柱子按当前列所属月份点亮
+        if (barsLink && bars.length) {
+          const col = Math.floor(idx / 7);
+          const date = cell.dataset.date ?? '';
+          const mi = monthKeys.indexOf(date.slice(0, 7));
+          if (mi >= 0) bars.slice(0, mi + 1).forEach((b) => b.classList.add('on'));
+        }
+        if (lenEl) lenEl.textContent = String(body);
+        // 推进游标
+        const next = cur + dirs[si];
+        cursors[si] = next;
+        if (next < 0 || next >= PATH.length) cursors[si] = -1 as number;
+      });
+      // 全部游标到端点 → 一轮结束
+      if (!moved || cursors.every((c) => c < 0)) {
+        clearInterval(timer);
+        timer = 0;
+        if (readEl) readEl.textContent = `第 ${loopNo} 轮完成：吃到 ${eaten} 天`;
+        loopNo++;
+        setTimeout(() => {
+          reset(true);
+          if (!paused) start();
+        }, 900);
+      }
+      void paint;
+    };
+
+    const start = () => {
+      if (timer || paused) return;
+      reset(false);
+      timer = window.setInterval(step, 26);
+    };
+
+    const stop = () => {
+      if (timer) clearInterval(timer);
+      timer = 0;
+    };
+
+    toggle?.addEventListener('click', () => {
+      paused = !paused;
+      toggle.textContent = paused ? '继续' : '暂停';
+      if (paused) stop();
+      else start();
+    });
+
+    if (reduce) {
+      // 减少动态：直接展示终态（所有有贡献的格子点亮 + 柱子立起）
+      cells.forEach((c) => {
+        if (Number(c.dataset.count ?? 0) > 0) c.classList.add('snake-eaten');
+      });
+      bars.forEach((b) => b.classList.add('on'));
+      if (readEl) readEl.textContent = '已按"减少动态效果"静态呈现';
+    } else {
+      new IntersectionObserver(
+        (entries) => {
+          for (const e of entries) {
+            if (e.isIntersecting) start();
+            else stop();
+          }
+        },
+        { threshold: 0.15 },
+      ).observe(wrap);
+    }
+  }
+
+  /* J：单独的柱状图（进视口升起 + hover 联动） */
+  const chart = document.querySelector<HTMLElement>('[data-bars-chart]');
+  if (chart) {
+    new IntersectionObserver(
+      (entries) => {
+        for (const e of entries) if (e.isIntersecting) e.target.classList.add('grow');
+      },
+      { threshold: 0.2 },
+    ).observe(chart);
+    const grid = document.querySelector<HTMLElement>('[data-bars]');
+    for (const btn of chart.querySelectorAll<HTMLElement>('[data-month]')) {
+      const m = btn.dataset.month ?? '';
+      const on = () =>
+        grid?.querySelectorAll<HTMLElement>('.hg-c').forEach((c) =>
+          c.classList.toggle('hg-month', (c.dataset.date ?? '').startsWith(m)),
+        );
+      const off = () => grid?.querySelectorAll<HTMLElement>('.hg-c').forEach((c) => c.classList.remove('hg-month'));
+      btn.addEventListener('pointerenter', on);
+      btn.addEventListener('pointerleave', off);
+      btn.addEventListener('focus', on);
+      btn.addEventListener('blur', off);
+    }
+  }
+</script>
+
+<style>
+  .pv-title { font-size: var(--text-h1); color: var(--ink-1); margin-top: var(--space-5); }
+  .pv-note { font-size: 14px; color: var(--ink-3); line-height: 1.75; max-width: var(--measure); margin-block: var(--space-2) var(--space-4); }
+  .pv-switch {
+    position: sticky; top: 0; z-index: 3; display: flex; flex-wrap: wrap; gap: var(--space-2);
+    padding: var(--space-2) 0; background: color-mix(in oklab, var(--bg) 92%, transparent);
+    backdrop-filter: blur(6px); border-bottom: 1px solid var(--line);
+  }
+  .pv-chip {
+    font-family: var(--font-mono); font-size: 12.5px; color: var(--ink-2);
+    border: 1px solid var(--line); border-radius: 999px; padding: 4px 12px;
+    transition: border-color var(--dur) var(--ease), color var(--dur) var(--ease);
+  }
+  .pv-chip:hover { border-color: var(--accent); color: var(--ink-1); }
+  .pv-sec { margin-top: var(--space-6); scroll-margin-top: 56px; }
+  .pv-head { border-top: 1px solid var(--line); padding-top: var(--space-3); }
+  .pv-tag { display: inline-block; font-size: 11px; color: var(--ink-4); border: 1px solid var(--line); border-radius: 4px; padding: 0 5px; }
+  .pv-rec { font-size: 11px; color: var(--accent); border: 1px solid color-mix(in oklab, var(--accent) 40%, var(--line)); border-radius: 4px; padding: 0 5px; margin-left: 6px; font-family: var(--font-mono); }
+  .pv-head h2 { font-size: 20px; color: var(--ink-1); margin: var(--space-1) 0; }
+  .pv-pros { font-size: 13px; color: var(--ink-3); line-height: 1.7; max-width: var(--measure); margin: 0 0 var(--space-3); }
+  .pv-pros b { color: var(--ink-2); }
+  .pv-foot { font-size: 12px; color: var(--ink-4); margin-top: var(--space-6); }
+  .hm-wrap { overflow-x: auto; padding: 6px 0; }
+  .hm-read { font-size: 12px; color: var(--ink-4); margin-top: var(--space-2); display: flex; gap: var(--space-2); align-items: center; flex-wrap: wrap; }
+  .hm-btn {
+    font-family: var(--font-mono); font-size: 12px; color: var(--ink-2);
+    background: var(--bg-soft); border: 1px solid var(--line); border-radius: 6px; padding: 3px 10px; cursor: pointer;
+  }
+  .hm-btn:hover { border-color: var(--accent); }
+
+  /* 蛇：头 / 身 / 吃过 */
+  :global(.snake-head) {
+    outline: 2px solid var(--accent);
+    outline-offset: 1px;
+    z-index: 2;
+    position: relative;
+  }
+  :global(.snake-body) {
+    background: color-mix(in oklab, var(--accent) 32%, transparent) !important;
+  }
+  :global(.snake-eaten) {
+    background: var(--accent) !important;
+    box-shadow: 0 0 0 1px color-mix(in oklab, var(--accent) 45%, transparent);
+    transition: background 180ms var(--ease);
+  }
+
+  /* 月度柱 */
+  .hm-bars {
+    display: flex; align-items: flex-end; gap: 6px; list-style: none;
+    padding: 0; margin: var(--space-2) 0 0; height: 84px;
+  }
+  .hm-bars li { display: flex; flex-direction: column; align-items: center; gap: 4px; flex: 1; height: 100%; justify-content: flex-end; }
+  .hm-bar-btn { width: 100%; height: 100%; display: flex; align-items: flex-end; background: none; border: 0; padding: 0; cursor: pointer; }
+  .hm-bar-fill {
+    display: block; width: 100%; height: 0;
+    background: var(--ink-4); border-radius: 2px 2px 0 0;
+    transition: height 420ms cubic-bezier(0.22, 0.8, 0.3, 1), background 160ms var(--ease);
+  }
+  .grow .hm-bar-fill { height: var(--h, 0%); }
+  /* FJ：蛇爬到该月时柱子升起（由 JS 加 .on） */
+  .hm-bar-fill.on { height: var(--h, 0%); background: var(--accent); }
+  .hm-bar-btn:hover .hm-bar-fill { background: var(--accent); }
+  .hm-bar-label { font-size: 10.5px; color: var(--ink-4); }
+  :global(.hg-month) { background: var(--accent) !important; }
+
+  @media (prefers-reduced-motion: reduce) {
+    .hm-bar-fill { transition: none; }
+  }
+</style>