<?xml version="1.0" encoding="UTF-8"?><?xml-stylesheet href="/rss/feed.xsl" type="text/xsl"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>XFffff&apos;s Blog</title><description>记录生活和技术的个人空间</description><link>https://blog.the37777777.top</link><item><title>换新家了：从 Next.js 搬到 Astro，以及要感谢的两个人</title><link>https://blog.the37777777.top/post/new-home-thanks</link><guid isPermaLink="false">new-home-thanks</guid><description>博客从 Next.js + Velite 迁移到 Astro 7，记录换框架的真实原因，并向两位把代码开源出来的作者致谢——没有他们，这个博客不会存在。</description><pubDate>Fri, 20 Nov 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;先说结论&lt;a href=&quot;#先说结论&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;我把博客从 &lt;strong&gt;Next.js + Velite&lt;/strong&gt; 换成了 &lt;strong&gt;Astro 7&lt;/strong&gt;，用的主题是 &lt;a href=&quot;https://github.com/cosZone/astro-koharu&quot;&gt;astro-koharu&lt;/a&gt;。&lt;/p&gt;
&lt;p&gt;换完之后这个站是&lt;strong&gt;纯静态&lt;/strong&gt;的：构建产物就是一堆 HTML、CSS、JS，没有服务端、没有数据库，扔到任何静态托管上都能跑。这对一个只想安安静静写字的人来说，比什么都重要。&lt;/p&gt;
&lt;p&gt;但这篇文章真正想说的不是技术选型，是&lt;strong&gt;感谢&lt;/strong&gt;。&lt;/p&gt;
&lt;h2&gt;要感谢的第一个人：mk965&lt;a href=&quot;#要感谢的第一个人mk965&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;我最早的这个博客，骨架来自 &lt;a href=&quot;https://github.com/mk965/mengke.me&quot;&gt;mengke.me&lt;/a&gt;。&lt;/p&gt;
&lt;p&gt;那时候我刚开始折腾个人博客，什么都不懂。GitHub 上翻了几十个项目，最后停在这个上面——它把 Next.js、Tailwind、MDX、搜索、评论、SEO 这些东西全都搭好了，而且写得很清楚，我能一行一行看明白它在干什么。&lt;/p&gt;
&lt;p&gt;我的第一篇文章《从零到一：一个高中生的博客搭建与优化之旅》里写过，我是怎么找到这个模板、怎么照着改的。现在回头看那篇，字里行间全是一个新手的兴奋和手忙脚乱。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;没有 mengke.me 这个起点，就没有后来这一路。&lt;/strong&gt; 后来我在它上面加了自己的东西：液态玻璃设计、照片墙、碎碎念、项目页、Changelog…… 从一个模板慢慢长成一个”我的”博客。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;项目地址：&lt;a href=&quot;https://github.com/mk965/mengke.me&quot;&gt;https://github.com/mk965/mengke.me&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;要感谢的第二个人：cosZone&lt;a href=&quot;#要感谢的第二个人coszone&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;换框架的时候，我又一次面临”从零开始”。&lt;/p&gt;
&lt;p&gt;这次运气好，找到了 &lt;a href=&quot;https://github.com/cosZone/astro-koharu&quot;&gt;astro-koharu&lt;/a&gt;——一个用 Astro 7 + Tailwind 4 + React 写的博客主题，设计灵感来自 Hexo 的 Shoka 主题。&lt;/p&gt;
&lt;p&gt;它打动我的地方，不只是好看：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;质量高得离谱&lt;/strong&gt;。它不是”能跑就行”的模板，加密文章用 AES-256-GCM 真正做构建期加密、代码块有折叠和行标记、链接自动生成 OG 卡片、支持从 Shoka 迁移过来的一整套 Markdown 扩展语法。这些细节说明作者是真的在自己用。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;工程化完整&lt;/strong&gt;。自带 CLI（备份、还原、主题更新、内容生成）、完整的测试套件、i18n 多语言、Pagefind 搜索、giscus / Waline / Twikoo / Remark42 四种评论系统可选。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;文档足够细&lt;/strong&gt;。&lt;code&gt;AGENTS.md&lt;/code&gt;、&lt;code&gt;GETTING-STARTED.md&lt;/code&gt;、&lt;code&gt;docs/features/&lt;/code&gt;——一个主题能写到这个程度，是花了大量时间的。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;而且它是 &lt;strong&gt;AGPL-3.0&lt;/strong&gt; 开源的。这意味着我可以直接拿来用、改，只要把改动也开源出去。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;项目地址：&lt;a href=&quot;https://github.com/cosZone/astro-koharu&quot;&gt;https://github.com/cosZone/astro-koharu&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;作者主页：&lt;a href=&quot;https://github.com/cosZone&quot;&gt;https://github.com/cosZone&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;谢谢你把这么多工作成果直接放出来。&lt;/strong&gt; 我知道维护一个高质量开源项目有多耗精力，尤其是还带着完整文档和测试的那种。&lt;/p&gt;
&lt;h2&gt;为什么换框架&lt;a href=&quot;#为什么换框架&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;不是为了追新。是真的有几个问题绕不过去：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第一，我要的是纯静态。&lt;/strong&gt;
原来的 Next.js 方案虽然也能 &lt;code&gt;export&lt;/code&gt; 出静态站，但整个技术栈是围绕服务端渲染设计的，写完总觉得别扭。Astro 是”默认零 JS”的思路，一个博客 90% 的页面本来就只是文章，不需要一坨水合。换成 Astro 之后，构建产物是纯静态的，部署到任何地方都不用操心运行时。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第二，内容管理太重了。&lt;/strong&gt;
原来用 Velite 做内容层，配置文件写了一百多行，每次改 schema 都要重新理解一遍。Astro 的 Content Collections + Zod schema 更直接：文章就是带 frontmatter 的 Markdown，字段定义一目了然。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第三，我不想再维护一堆自己写的基础设施。&lt;/strong&gt;
搜索、评论、图片优化、SEO、RSS、站点地图……这些东西我自己拼过一遍，能用，但每次升级依赖都要重新调。astro-koharu 把这些都做好了，还带测试。&lt;strong&gt;把精力放在写字上，比放在修基础设施上值。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第四，迁移成本比想象中低。&lt;/strong&gt;
九篇文章、几百张图、一堆内链，理论上很麻烦。实际上写个转换脚本，把 frontmatter 映射一下、内链 &lt;code&gt;/blog/xxx&lt;/code&gt; 改成 &lt;code&gt;/post/xxx&lt;/code&gt;、MDX 组件换成 Markdown 容器语法，一天之内就跑通了。文章是 Markdown，它本来就不该被框架绑死——这也是我这次最深的体会。&lt;/p&gt;
&lt;h2&gt;现在这个站&lt;a href=&quot;#现在这个站&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;框架：&lt;strong&gt;Astro 7&lt;/strong&gt;，纯静态输出&lt;/li&gt;
&lt;li&gt;主题：&lt;strong&gt;astro-koharu&lt;/strong&gt;（AGPL-3.0，已保留原许可与署名）&lt;/li&gt;
&lt;li&gt;内容：Markdown + Content Collections&lt;/li&gt;
&lt;li&gt;搜索：Pagefind（构建期生成索引）&lt;/li&gt;
&lt;li&gt;评论：giscus（GitHub Discussions）&lt;/li&gt;
&lt;li&gt;部署：Vercel，推送到 GitHub 自动构建&lt;/li&gt;
&lt;li&gt;备案：&lt;a href=&quot;https://icp.gov.moe/?keyword=20263777&quot; target=&quot;_blank&quot;&gt;萌ICP备20263777号&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;最后&lt;a href=&quot;#最后&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;写博客这件事，我做了不到一年。技术上没什么值得炫耀的，我到现在还是靠 AI 帮我写代码。&lt;/p&gt;
&lt;p&gt;但有一件事我越来越确定：&lt;strong&gt;你今天能轻松用上的东西，是别人花了很多个晚上做出来的。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;mk965 和 cosZone 都不认识我，他们只是把自己的项目开源了。但这个动作，让一个桂林的文科生能在大学宿舍里搭起自己的博客，能一行一行看懂、能改、能学。&lt;/p&gt;
&lt;p&gt;所以这篇不是技术文章，是记账。&lt;strong&gt;记下我欠了谁的人情。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;如果以后我也有能力做出点什么，希望能像他们一样，直接放出来。&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;&lt;em&gt;感谢阅读。这个博客会继续写下去。&lt;/em&gt;&lt;/p&gt;</content:encoded><category>category:随笔</category><category>category:建站</category><category>tag:博客</category><category>tag:Astro</category><category>tag:Next.js</category><category>tag:开源</category><category>tag:致谢</category></item><item><title>项目全景与最近两个项目：墨屿论坛、NetLab —— 后端密集期的开发心得</title><link>https://blog.the37777777.top/post/project-overview-and-latest-two</link><guid isPermaLink="false">project-overview-and-latest-two</guid><description>距离上一篇（八月中那三个项目）过去两个月，项目列表上又多了几个新面孔：墨屿论坛、NetLab、万象纪元、UGreenLedPilot。这篇先把整条项目线从头过一遍，再重点讲这两个后端密集型项目里踩到的坑——尤其是「生产不是大号的本地」这件事。</description><pubDate>Mon, 12 Oct 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;为什么要写这篇&lt;a href=&quot;#为什么要写这篇&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;七月写过一篇 &lt;a href=&quot;/post/summer-dev-review&quot;&gt;2026 开发复盘&lt;/a&gt;，讲的是「半年五个项目」。八月中写过 &lt;a href=&quot;/post/vibe-coding-triple-projects&quot;&gt;一周三个项目&lt;/a&gt;，讲的是那一周同时推进的织词、游戏大厅和阅海。两篇都是「某个时间段做了什么」。&lt;/p&gt;
&lt;p&gt;这篇不太一样：&lt;strong&gt;先把项目列表整体过一遍，再重点谈最近的这两个。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;这两个月的产出数量不多，但它们和之前那些项目有个明显区别——&lt;strong&gt;两个都是「后端密集型」：界面只是壳，真正的仗打在数据库、权限和线上环境上。&lt;/strong&gt; 而恰恰是这类项目，把之前一直没暴露的问题全暴露出来了。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;先把项目列一遍&lt;a href=&quot;#先把项目列一遍&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;项目列表上现在有十个：&lt;/p&gt;




























































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;项目&lt;/th&gt;&lt;th&gt;是什么&lt;/th&gt;&lt;th&gt;主要技术&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;墨屿&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;自建社区论坛&lt;/td&gt;&lt;td&gt;Next.js、PostgreSQL、Vercel&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;NetLab&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;网络资产发现与体检（授权范围内）&lt;/td&gt;&lt;td&gt;Next.js、只读探测、PostgreSQL&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;万象纪元&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;文字宇宙文明模拟器（私有）&lt;/td&gt;&lt;td&gt;React、Web Worker、确定性随机&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;光子遥控&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;安卓万能红外遥控器&lt;/td&gt;&lt;td&gt;Kotlin、Compose、自研红外协议&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;星域战机&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;弹幕射击游戏&lt;/td&gt;&lt;td&gt;Vanilla JS、Canvas&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;经典扫雷&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Windows 扫雷复刻&lt;/td&gt;&lt;td&gt;Vanilla JS、PWA&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;LinkRoom&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;P2P 局域网联机工具&lt;/td&gt;&lt;td&gt;C#、EasyTier&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;TimeMark&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;智能事件提醒（Docker + 云平台双版）&lt;/td&gt;&lt;td&gt;Hono、SQLite、PostgreSQL&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;UGreenLedPilot&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;绿联 NAS LED 智能控制&lt;/td&gt;&lt;td&gt;Python、I2C、fnOS&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;知屋&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;私人阅读与笔记书房&lt;/td&gt;&lt;td&gt;Astro、Hono、Vercel&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;十个项目，横跨桌面端、安卓、Web、NAS、后端服务。&lt;strong&gt;但真正让我改观的是最近这两个&lt;/strong&gt;——因为它们是第一批「有多个真实用户、必须长期在线、必须自己管好数据」的项目。&lt;/p&gt;
&lt;p&gt;其余八个这里只做一句话回看，不重复展开。下面重点讲墨屿和 NetLab。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;一、墨屿论坛：本地跑得好好的论坛，为什么线上全是 500&lt;a href=&quot;#一墨屿论坛本地跑得好好的论坛为什么线上全是-500&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;论坛这种形态，功能本身不复杂，难的是「长期在线」这四个字。上线之后暴露的问题，基本都不在功能层面。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;生产写路径整片 500。&lt;/strong&gt; 本地怎么点都正常，换到线上之后，所有写操作全部 500。最后定位到是数据库驱动的问题：生产用的 HTTP 型驱动&lt;strong&gt;不支持交互式事务&lt;/strong&gt;，而代码里到处是「先开事务、再操作、再提交」的写法。本地另一个驱动能跑，线上直接挂。&lt;/li&gt;
&lt;/ul&gt;
&lt;div&gt;
&lt;blockquote&gt;
&lt;p&gt;「本地全过」在生产面前没有任何参考价值。驱动不同、连接方式不同，同一份代码就是两套行为。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;date 字段的类型居然不一样。&lt;/strong&gt; 同一个日期列，一个驱动取出来是 &lt;code&gt;Date&lt;/code&gt; 对象，另一个驱动取出来是字符串。跨驱动做日期比较，最后只能把比较逻辑写回 SQL 里，让数据库自己比，别在应用层猜类型。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;管理后台「没有入口」。&lt;/strong&gt; 功能是写了的，但除了我自己没人知道怎么进，角色还没同步。这类问题测试永远发现不了，因为测试不会「以一个新用户的身份去找入口」。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;一张运维表无限增长。&lt;/strong&gt; 计数用的表从来没清理过，越涨越大，配套的保留策略一开始也没写对。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;存储面板的数字是虚的。&lt;/strong&gt; 页面上显示的占用和实际差了好几倍，属于统计口径的问题——面板上的数字不该比不显示更糟。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;浏览计数把表撑爆。&lt;/strong&gt; 每次浏览落一条记录，表涨得飞快，后来改成去重统计才压下来。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;经验等级制的一个取舍。&lt;/strong&gt; L1–L5 决定发帖和互动配额。这里我选了&lt;strong&gt;等级不落库&lt;/strong&gt;：每次由发帖量等数据派生算出来，而不是存一个等级字段。好处是不会出现「等级和实际数据对不上」的不一致，代价是查询时多算一次。能派生就别冗余存——省下的那个字段，迟早会变成不一致的来源。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;心得：&lt;strong&gt;这轮最重要的教训是「生产不是大号的本地」。&lt;/strong&gt; 本地、CI、生产是三个不同的世界，驱动版本、连接方式、网络策略都可能不一样。没在生产形态上验证过的东西，就不算验证过。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;二、NetLab：做工具类项目，先划边界&lt;a href=&quot;#二netlab做工具类项目先划边界&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;这个项目最难的部分不是技术，是**「什么该做、什么不该做」**。&lt;/p&gt;
&lt;p&gt;它的定位是给自有资产做网络测绘和体检：被动 CT 子域名发现、只读的端口与服务探测、网络质量测量、DNS 服务商与 CDN 识别、NAT 分类、局域网指纹扫描，再配一套修复台账。&lt;/p&gt;
&lt;p&gt;遇到的问题：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;能力边界是设计的一部分。&lt;/strong&gt; 爆破、注入这类主动攻击手段我不做。原因很直接：&lt;strong&gt;授权不转移责任&lt;/strong&gt;。工具一旦放出去就会扩散，「用户说他手里有授权」并不能让工具本身变得无害。所以能力只做被动的、只读的，边界写进代码，而不是写在文档里。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;逐人授权和额度。&lt;/strong&gt; 每个人有自己的额度，管理员可以逐人调整，自己不受额度限制。额度这种事，一旦有多个用户，就必须是「谁的账记在谁头上」。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;给自己立了三条不变量，并且写成测试。&lt;/strong&gt; 开关不空转（界面上每个开关必须真的改变行为）、文案不空挂（写了的功能必须真的做了）、计数不撒谎（页面上的数字必须能和实际对上账）。听着很基础，但一上强度就会发现到处都是「文案写了、代码没跟上」。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;线上加列要连迁移记录一起补。&lt;/strong&gt; 生产库加字段是另一套流程，光加列不够，还得把 ORM 的迁移记账补上，否则下次迁移一定打架。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;发布通道也得有备胎。&lt;/strong&gt; 有一段时间本机直连 github.com 完全不稳定，clone 和 push 时通时断。最后改用 Git 的数据接口（另一个域名可达）来提交——本地和远程的提交哈希对不上，但文件树是一致的。能用，但下次联网推的时候得留意。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;心得：&lt;strong&gt;工具类项目的难度不在写代码，在划边界。&lt;/strong&gt; 边界划清楚之后，代码反而不难写；边界没划清楚，写出来的东西就是隐患。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;三、其余八个，一句话回看&lt;a href=&quot;#三其余八个一句话回看&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;把列表从上到下扫一遍，每个项目其实都留下了一句能记住的话：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;万象纪元&lt;/strong&gt; —— 确定性种子随机流（同种子必同历史），模拟内核跑在 Web Worker 里，加载后断网可玩。它教会我的是**「把不确定性关进种子」**：随机的东西只要能复现，就能被测试。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;光子遥控&lt;/strong&gt; —— 自研 14 种红外协议编码器，配上离线码库与宏、暴力找码。它让我第一次&lt;strong&gt;敢为真实硬件啃协议底层&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;星域战机 / 经典扫雷&lt;/strong&gt; —— 两个纯 Vanilla JS、零依赖的游戏。它们证明了一件事：&lt;strong&gt;不用框架也能把东西做完，而且更好控。&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;LinkRoom&lt;/strong&gt; —— 房间号加密码就能联机的 P2P 局域网工具，没有账号系统。&lt;strong&gt;「少一个账号，就少一整套麻烦」。&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;TimeMark&lt;/strong&gt; —— 从三容器砍到单容器，内存从约 800MB 降到约 256MB。它教会我的是&lt;strong&gt;砍掉过度设计&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;UGreenLedPilot&lt;/strong&gt; —— 用 I2C 控制 NAS 面板的电源、网络、磁盘指示灯，热插拔用事件驱动而不是定时轮询。&lt;strong&gt;能事件驱动就别轮询&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;知屋&lt;/strong&gt; —— 阅读、划线、间隔复习加私有书库。它是第一个让我把「数据放在自己的 Vault 里」当默认选项的项目。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;十行看下来，其实能看到一条很清楚的线：&lt;strong&gt;前端和纯客户端的项目，做完就是做完了；而后端和服务型的项目，做完只是开始。&lt;/strong&gt; 它们要一直在线、一直有人用、一直有数据在长。这就是为什么最近这两个项目给我的教训，比前面八个加起来还多。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;看完这一圈，共通的是这几件事&lt;a href=&quot;#看完这一圈共通的是这几件事&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;1. 生产是第三种环境，而且是唯一算数的那种。&lt;/strong&gt; 本地和 CI 都只是近似。凡是「跟别人交互」的部分——数据库、网络、权限——都必须按生产形态验证。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. 面板上的数字要能对账，否则不如不显示。&lt;/strong&gt; 一个假数字比没有数字更差，因为它会让人做错误的判断。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. 项目之间保持隔离是省事的做法。&lt;/strong&gt; 两个新项目各用一个独立的库，改一个不会波及另一个，省下了很多「改 A 影响 B」的排查时间。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;4. 拒掉的能力要真的不存在。&lt;/strong&gt; 不做的功能不要在界面上留个灰色按钮，也不要留一段永远返回「未实现」的代码。没有就是没有，这本身也是一种诚实。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;5. 把不变量写下来、写成测试。&lt;/strong&gt; 开关不空转、文案不空挂、计数不撒谎——这三条听起来像废话，但它们是唯一能挡住「功能写了、行为没跟上」的东西。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;最后&lt;a href=&quot;#最后&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;这两个月最大的感受是：&lt;strong&gt;项目从「能跑」到「能扛」之间，隔的不是功能，是纪律。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;功能可以很快堆出来，但驱动差异、类型不一致、计数失真、能力边界这些事，没有一件能靠「多写点代码」解决。它们要靠把不变量写下来、写成测试，然后每次改动都真的去跑一遍。&lt;/p&gt;
&lt;p&gt;八月中那篇写的是 vibe coding 的边界——它压缩了「从零到能跑」的时间。这一轮摸到的是另一条线：&lt;strong&gt;从「能跑」到「能扛」的那段路，依然得自己一步一步走，没有任何工具能替你走。&lt;/strong&gt;&lt;/p&gt;
&lt;/div&gt;</content:encoded><category>category:笔记</category><category>category:开发之路</category><category>tag:成长</category><category>tag:复盘</category><category>tag:Next.js</category><category>tag:全栈</category><category>tag:论坛</category><category>tag:网络安全</category><category>tag:PostgreSQL</category></item><item><title>一周三个项目：织词、游戏大厅与阅海 —— 一次 vibe coding 的实践心得</title><link>https://blog.the37777777.top/post/vibe-coding-triple-projects</link><guid isPermaLink="false">vibe-coding-triple-projects</guid><description>八月中旬的一周里，我同时推进了三个项目：织词（桌面提示词工作台）、游戏大厅（P2P 多人游戏平台）、阅海（NAS 图书馆应用）。这篇不聊功能清单，只讲过程中的心得体会和踩过的坑，以及 vibe coding 这种开发方式的真实边界。</description><pubDate>Thu, 13 Aug 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;为什么要写这篇&lt;a href=&quot;#为什么要写这篇&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;七月底那篇 &lt;a href=&quot;/post/summer-dev-review&quot;&gt;2026 开发复盘&lt;/a&gt; 写的是「半年五个项目」的长线回顾。而这周的情况很不一样：&lt;strong&gt;三个项目几乎同时开工、同时推进、同时收尾&lt;/strong&gt;，其中两个还涉及我之前完全没碰过的领域。&lt;/p&gt;
&lt;p&gt;这篇只讲三件事：做了什么（一句话）、遇到了什么问题、以及 vibe coding 到底靠不靠谱。不想写成功能清单，很多细节也没必要展开。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;三个项目，三句话&lt;a href=&quot;#三个项目三句话&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;项目&lt;/th&gt;&lt;th&gt;是什么&lt;/th&gt;&lt;th&gt;主要技术&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;织词 PromptWeaver&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Windows 桌面提示词工作台&lt;/td&gt;&lt;td&gt;Electron、React、zustand&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;游戏大厅 Game Hall&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;私有 P2P 多人游戏平台&lt;/td&gt;&lt;td&gt;Next.js、WebRTC、WebSocket&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;阅海 Yuehai&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;飞牛 NAS 图书馆应用&lt;/td&gt;&lt;td&gt;Kavita fork、fnOS 打包&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;三个项目几乎没有重叠的技术栈：一个桌面端、一个实时联机、一个 NAS 生态。这也是我刻意为之——想看看 vibe coding 在不同领域的表现。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;一、织词：桌面端的性能与数据&lt;a href=&quot;#一织词桌面端的性能与数据&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;桌面应用的第一个体会：&lt;strong&gt;本地数据越多，越考验工程能力&lt;/strong&gt;。角色、标签、翻译映射、别名……数据量上来之后，从「能跑」到「不卡」之间隔着一次重构。&lt;/p&gt;
&lt;p&gt;遇到的问题：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;状态管理失控&lt;/strong&gt;：功能越加越多，一个主组件膨胀到几百行、七八个 &lt;code&gt;useState&lt;/code&gt;，改一处崩三处。最后老老实实重构，拆成多个 store 才稳住。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;渲染性能&lt;/strong&gt;：列表数据大之后，滚动明显卡顿，不得不引入虚拟滚动。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;中文搜索远比想象复杂&lt;/strong&gt;：汉字、拼音、首字母、别名、同义词，每个都要命中；还遇到过某条全量查询耗时 20 秒的超时问题，最后靠给匹配逻辑加门控条件解决。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;中英双语的一致性&lt;/strong&gt;：输出是中英双份的，两边经常对不上。后面做了不少数据审计工作，才把差集清零。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;心得：&lt;strong&gt;数据质量工程（data engineering）的坑，不比写代码少&lt;/strong&gt;。vibe coding 能很快写出功能，但「数据对不对、全不全、一致不一致」这件事，AI 帮不了多少，得自己一遍遍核对。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;二、游戏大厅：P2P 联网是深水区&lt;a href=&quot;#二游戏大厅p2p-联网是深水区&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;这个项目的定位很简单：朋友之间通过邀请码注册，建立房间，然后双方设备&lt;strong&gt;点对点直连&lt;/strong&gt;对局，服务器只做控制面。&lt;/p&gt;
&lt;p&gt;遇到的问题：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;库与环境的版本暗坑&lt;/strong&gt;：密码哈希库在 CI 的 Node 版本下直接报「不是函数」，查了半天是版本兼容问题，升级运行时才解决。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;白屏问题&lt;/strong&gt;：为安全加了严格的内容安全策略（CSP），结果某些环境下一打开就是白屏，排查下来是安全策略和浏览器扩展冲突，最后做了权衡调整。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;P2P 连不上&lt;/strong&gt;：不同运营商、不同 NAT 环境下，直连经常失败。只能做成「局域网直连 → 点对点 → 中继兜底」三级策略，再加网络检测向导让用户自己看链路质量。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;平台限制&lt;/strong&gt;：部署平台对 WebSocket 连接时长有硬限制，不得不设计短连接 + 退避重连 + 消息重放的方案。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;测试不稳定&lt;/strong&gt;：端到端测试经常时好时坏，同一套用例在本地全过、CI 上随机挂，花了不少时间稳定它们。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;心得：&lt;strong&gt;联网和安全的坑，vibe coding 只能帮你走到一半&lt;/strong&gt;。AI 能写出 WebRTC 握手、能写出认证流程，但「为什么这个环境下连不上」「为什么 CI 上测不过」这种需要实机环境反复验证的问题，最后还是得靠人一点点试。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;三、阅海：改一个大项目的勇气&lt;a href=&quot;#三阅海改一个大项目的勇气&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;这个项目是给 NAS 做的图书馆应用，基于开源的阅读器 fork 改造。这是三个项目里**最「改别人的代码」**的一个。&lt;/p&gt;
&lt;p&gt;遇到的问题：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;gitignore 误吞&lt;/strong&gt;：一次配置失误，把源码文件整个从版本控制里吞掉了，差点丢文件，花了不少力气恢复。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;安全漏洞&lt;/strong&gt;：fork 上游的代码里存在认证相关的漏洞，逐项审计修复，顺手把沙箱和内容安全也补上了。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;上游版本管理&lt;/strong&gt;：fork 了多个开源项目，版本固定、许可证分层、上游更新跟踪，全是琐碎但必须做对的事。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;NAS 集成&lt;/strong&gt;：安装向导、权限、数据卷、生命周期脚本，和普通 Web 应用完全不是一个思路。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;心得：&lt;strong&gt;改别人的大项目，最大的瓶颈是上下文&lt;/strong&gt;。项目太大，AI 的上下文窗口根本装不下整个代码库，经常「改了这个忘了那个」。只能把改动拆得很碎，一次只动一个点，每步都靠测试兜底。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;vibe coding 到底有什么问题&lt;a href=&quot;#vibe-coding-到底有什么问题&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;三个项目跑下来，说说我的真实感受：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1. 功能写得快，问题出在后面。&lt;/strong&gt; 一周能堆出别人一个月的功能量，但随之而来的性能、数据一致性、边界情况，AI 不会替你想到。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. 测试是唯一的救命稻草。&lt;/strong&gt; 没有测试，vibe coding 就是给未来的自己埋雷。三个项目都是测试越写越重，到后期几乎改一个点就要跑一遍全量回归。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. 上下文是硬天花板。&lt;/strong&gt; 单文件、单模块 AI 很强；整个项目级别的「全局视野」，AI 给不了，得靠人拆分和设计。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;4. 安全和隐私不能外包。&lt;/strong&gt; 代码生成得再快，认证、权限、密钥管理这些还是要自己过一遍，不能假设 AI 写的就是安全的。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;5. 数据比代码更费神。&lt;/strong&gt; 尤其涉及大量结构化数据时，AI 写转换代码很利索，但数据本身的正确性，只能靠审计。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;最后&lt;a href=&quot;#最后&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;这周最大的收获不是三个项目本身，而是摸清了 vibe coding 的边界：&lt;strong&gt;它把「从零到能跑」的时间压缩到极限，但「从能跑到能上线」的每一步，依然要靠自己的判断力&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;工具不会替你踩坑，只会让你踩坑的速度更快。想清楚这一点，vibe coding 就是很好的工具；想不清楚，它只是加速翻车的引擎。&lt;/p&gt;</content:encoded><category>category:笔记</category><category>category:开发之路</category><category>tag:成长</category><category>tag:复盘</category><category>tag:vibe coding</category><category>tag:全栈</category><category>tag:Electron</category><category>tag:Next.js</category><category>tag:NAS</category></item><item><title>OpenCode安装及优化教程</title><link>https://blog.the37777777.top/post/opencode-an-zhuang-ji-you-hua-jiao-cheng-2</link><guid isPermaLink="false">opencode-an-zhuang-ji-you-hua-jiao-cheng-2</guid><description>1. 安装
OpenCode 官网：https://opencode.ai/
OpenCode GitHub 仓库：https://github.com/anomalyco/opencode
选择对应操作系统版本进行安装，具体步骤参考官方文档
2. 配置 API Key

打开设置</description><pubDate>Tue, 04 Aug 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;1. 安装&lt;a href=&quot;#1-安装&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;OpenCode 官网：&lt;a href=&quot;https://opencode.ai/&quot;&gt;https://opencode.ai/&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;OpenCode GitHub 仓库：&lt;a href=&quot;https://github.com/anomalyco/opencode&quot;&gt;https://github.com/anomalyco/opencode&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;选择对应操作系统版本进行安装，具体步骤参考官方文档&lt;/p&gt;
&lt;h2&gt;2. 配置 API Key&lt;a href=&quot;#2-配置-api-key&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;打开设置&lt;/li&gt;
&lt;li&gt;找到「提供商」，然后在提供商这里选择你拥有的对应的 API 进行连接；如果没有可以用自定义提供商，注意&lt;strong&gt;自定义提供商&lt;/strong&gt;支持的是 &lt;strong&gt;OpenAI 兼容格式&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;等待连接成功提示，即完成绑定就可以用了&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;3. 优化&lt;a href=&quot;#3-优化&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;3.1 安装插件&lt;a href=&quot;#31-安装插件&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;推荐安装 oh-my-openagent&lt;/p&gt;
&lt;p&gt;GitHub 仓库：&lt;a href=&quot;https://github.com/code-yeongyu/oh-my-openagent&quot;&gt;https://github.com/code-yeongyu/oh-my-openagent&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;复制下面的文档提示词给 AI，让 AI 安装即可（例如：「请帮我安装 oh-my-openagent」）&lt;/p&gt;
&lt;h3&gt;3.2 MCP 服务器&lt;a href=&quot;#32-mcp-服务器&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;安装 oh-my-openagent 以后会自带几个 MCP 服务器，这边推荐几个好用的：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;playwright&lt;/li&gt;
&lt;li&gt;chrome-devtools&lt;/li&gt;
&lt;li&gt;github&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;4. 按需配置 oh-my-openagent agent 使用模型&lt;a href=&quot;#4-按需配置-oh-my-openagent-agent-使用模型&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;探索可以启用&lt;strong&gt;速度快的&lt;/strong&gt;，调研可以使用&lt;strong&gt;有原生搜索能力的&lt;/strong&gt;，然后规划可以用&lt;strong&gt;性能强的&lt;/strong&gt;，像审查呀那些的也推荐是&lt;strong&gt;性能强的&lt;/strong&gt;，一般的写入用&lt;strong&gt;正常的模型&lt;/strong&gt;即可，不需要特别强，看需求写入即可。&lt;/p&gt;
&lt;div&gt;
&lt;p&gt;&lt;strong&gt;提示&lt;/strong&gt;
输入 &lt;code&gt;ulw&lt;/code&gt; 可以启用 Ultra Work 模式，使用体验会更好&lt;/p&gt;
&lt;/div&gt;</content:encoded><category>category:工具</category><category>category:OpenCode</category><category>tag:OpenCode</category></item><item><title>2026 开发复盘：博客、TimeMark、游戏、知屋与光子遥控</title><link>https://blog.the37777777.top/post/summer-dev-review</link><guid isPermaLink="false">summer-dev-review</guid><description>从二月博客上线到八月光子遥控首推，把半年多里做过的五个项目、写过的代码、踩过的坑，以及从「能用框架」到「敢造轮子」再到「敢啃协议底层」的变化，尽量诚实地写下来。</description><pubDate>Sat, 01 Aug 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;为什么要写这篇&lt;a href=&quot;#为什么要写这篇&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;2 月博客上线的时候，我写过一篇 &lt;a href=&quot;/post/my-blog-journey&quot;&gt;从零到一：博客搭建之旅&lt;/a&gt;。那篇文章讲的是「怎么把站搭起来」。&lt;/p&gt;
&lt;p&gt;半年多过去了，我又做了 TimeMark、两款 Web 游戏、知屋阅读书房，还有 8 月初刚推出的&lt;strong&gt;光子遥控&lt;/strong&gt;——一个自研 14 种红外协议编码器的安卓 App。博客本身也从 v1.0 迭代到 v2.2。如果只用一句话概括这段时间，大概是：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;从「跟着教程和框架走」，慢慢变成「敢自己设计架构、敢砍过度设计、敢为真实场景做取舍、敢啃底层协议」。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;这篇不是某一次升级的 changelog，而是把&lt;strong&gt;所有项目串成一条线&lt;/strong&gt;的复盘。技术细节会写（而且这次附上真实代码），但更重要的是：每个项目为什么做、做错了什么、学到了什么。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;时间线：六个阶段&lt;a href=&quot;#时间线六个阶段&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;回看 git 记录和 Changelog，这大半年大致可以分成六段：&lt;/p&gt;















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;阶段&lt;/th&gt;&lt;th&gt;时间&lt;/th&gt;&lt;th&gt;主线&lt;/th&gt;&lt;th&gt;关键词&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;① 建站&lt;/td&gt;&lt;td&gt;2 月&lt;/td&gt;&lt;td&gt;个人博客 v1.0&lt;/td&gt;&lt;td&gt;Next.js、Cloudflare Pages、Contentlayer&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;② 打磨&lt;/td&gt;&lt;td&gt;4 月&lt;/td&gt;&lt;td&gt;液态玻璃 UI + TimeMark 立项&lt;/td&gt;&lt;td&gt;设计系统、Docker 初体验&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;③ 扩张&lt;/td&gt;&lt;td&gt;5 月&lt;/td&gt;&lt;td&gt;博客 v2.0 + Web 游戏 + TimeMark v2&lt;/td&gt;&lt;td&gt;Pagefind、Vanilla JS、单容器重构&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;④ 节点&lt;/td&gt;&lt;td&gt;6 月&lt;/td&gt;&lt;td&gt;高考&lt;/td&gt;&lt;td&gt;项目暂停，Moment 记录&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;⑤ 工程化&lt;/td&gt;&lt;td&gt;7 月&lt;/td&gt;&lt;td&gt;博客 v2.1 + 知屋 1.0&lt;/td&gt;&lt;td&gt;构建管线、安全审查、全栈书房&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;⑥ 新篇&lt;/td&gt;&lt;td&gt;8 月初&lt;/td&gt;&lt;td&gt;光子遥控 + 博客 v2.2&lt;/td&gt;&lt;td&gt;Kotlin、Compose、红外协议、安全加固&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;下面按项目和阶段展开。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;一、个人博客：从 v1.0 到 v2.2&lt;a href=&quot;#一个人博客从-v10-到-v22&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;博客是我所有项目的「大本营」——文章在这里发，其他项目的开发过程也在这里记录。&lt;/p&gt;
&lt;h3&gt;v1.0：先跑起来（2 月）&lt;a href=&quot;#v10先跑起来2-月&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;技术栈很早就定了：&lt;strong&gt;Next.js 15 + Contentlayer2 + Tailwind + Cloudflare Pages 静态导出&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;选静态导出是有意为之：没有服务端，部署简单，攻击面小。评论用 Giscus（GitHub Discussions），搜索先用 kbar 匹配标题。&lt;/p&gt;
&lt;p&gt;v1.0 解决的是「有没有」的问题。深色模式、RSS、Sitemap、基础安全头（CSP、HSTS）都在这一版落地。&lt;/p&gt;
&lt;p&gt;那会儿我对前端几乎一无所知，是照着 &lt;a href=&quot;https://github.com/mk965/mengke.me&quot;&gt;mengke.me&lt;/a&gt; 这个开源项目一步步改造的。Fork → 换文案 → 换配色 → 加功能，就像在别人的地基上盖自己的房子。后来我才慢慢意识到，&lt;strong&gt;「会改别人的代码」和「会设计自己的架构」之间，隔着半年时间的距离&lt;/strong&gt;。&lt;/p&gt;
&lt;h3&gt;v1.1–v1.2：功能补全 + 液态玻璃（4 月）&lt;a href=&quot;#v11v12功能补全--液态玻璃4-月&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;4 月是博客改动最密集的一个月之一，commit 数量能到几十条。主要方向：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;交互与阅读&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;阅读进度条、增强 TOC（移动端抽屉）&lt;/li&gt;
&lt;li&gt;相关文章评分算法、系列导航（上一篇/下一篇/进度）&lt;/li&gt;
&lt;li&gt;键盘快捷键帮助面板、Changelog 页、友链申请表&lt;/li&gt;
&lt;li&gt;Service Worker 离线支持、构建期 OG 图生成&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;液态玻璃设计系统&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;全站 UI 从手写 glass 样式迁移到统一的 &lt;code&gt;liquid-glass&lt;/code&gt; 四层体系。核心是 CSS 变量 + &lt;code&gt;backdrop-filter&lt;/code&gt;，不依赖任何第三方库：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt;root&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  --lg-blur&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 20&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; /* 标准层级模糊度 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  --lg-blur-elevated&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 30&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; /* 导航栏 / 模态框 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  --lg-blur-subtle&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 12&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; /* 次要区块 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  --lg-saturate&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 180%&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  --lg-bg&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; rgba&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0.45&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;dark&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  --lg-bg&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; rgba&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0.04&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;span&gt; /* 深色模式自动切换 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;liquid-glass&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  backdrop-filter&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; blur&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;--lg-blur&lt;/span&gt;&lt;span&gt;))&lt;/span&gt;&lt;span&gt; saturate&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;--lg-saturate&lt;/span&gt;&lt;span&gt;));&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  background&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; var&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;--lg-bg&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  transition&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; background &lt;/span&gt;&lt;span&gt;0.3&lt;/span&gt;&lt;span&gt;s&lt;/span&gt;&lt;span&gt; ease&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;四个层级对应不同场景：&lt;code&gt;liquid-glass&lt;/code&gt;（卡片/列表）、&lt;code&gt;liquid-glass-elevated&lt;/code&gt;（导航栏/模态框）、&lt;code&gt;liquid-glass-subtle&lt;/code&gt;（次要区块）、&lt;code&gt;liquid-glass-input&lt;/code&gt;（表单，带 focus 光晕）。深浅色模式靠 &lt;code&gt;.dark&lt;/code&gt; 下的变量覆盖，一套 CSS 两套皮肤。&lt;/p&gt;
&lt;p&gt;还做了滑动 Pill 导航指示器（spring easing 药丸动画），以及中文标签 404 的 Cloudflare Pages 路由兼容。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;项目结构规范化&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;css/&lt;/code&gt; → &lt;code&gt;styles/&lt;/code&gt;，JSON 数据迁入 &lt;code&gt;data/&lt;/code&gt;，图片目录统一为 &lt;code&gt;covers/&lt;/code&gt;、&lt;code&gt;banners/&lt;/code&gt;、&lt;code&gt;posts/&lt;/code&gt;。写了 &lt;code&gt;CONTENT_GUIDE.md&lt;/code&gt;，以后发文章有章可循。&lt;/p&gt;
&lt;p&gt;这个月我最深的体会是：&lt;strong&gt;好看的 UI 不是玄学，是 CSS 变量的分层管理&lt;/strong&gt;。把颜色、模糊度、透明度抽象成变量之后，「换皮肤」就只是改几个数字的事。&lt;/p&gt;
&lt;h3&gt;v1.3：SEO、About 与视觉（5 月初）&lt;a href=&quot;#v13seoabout-与视觉5-月初&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;AI 爬虫权限（GPTBot、ClaudeBot 等）与 &lt;code&gt;llms.txt&lt;/code&gt; 自动生成&lt;/li&gt;
&lt;li&gt;About 页重设计：Profile 卡片 3D tilt、流动背景动画&lt;/li&gt;
&lt;li&gt;一言（Hitokoto）迁入 Footer，30 秒自动刷新&lt;/li&gt;
&lt;li&gt;Moments 数据源统一为单一 &lt;code&gt;moments.json&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;v2.0：从「能用」到「好用」（5 月底）&lt;a href=&quot;#v20从能用到好用5-月底&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这是博客迄今最大的一次功能爆发，&lt;strong&gt;50+ 项改进、70+ 文件、9 次集中 commit&lt;/strong&gt;。详细过程见 &lt;a href=&quot;/post/blog-v2-optimization&quot;&gt;博客大升级 v2.0&lt;/a&gt;，这里只列骨架：&lt;/p&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;方向&lt;/th&gt;&lt;th&gt;代表能力&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;MDX 组件库&lt;/td&gt;&lt;td&gt;Callout、Tabs、Steps、Accordion 等 15 个&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;搜索&lt;/td&gt;&lt;td&gt;Pagefind 构建期全文索引，支持中文&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;阅读&lt;/td&gt;&lt;td&gt;字体档位、专注模式、位置记忆、TTS、难度标签&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;分享&lt;/td&gt;&lt;td&gt;微信/QQ/微博等 7 渠道 + 选中文字分享&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;视觉&lt;/td&gt;&lt;td&gt;View Transitions、终端 404、暗色模式过渡动画&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;移动&lt;/td&gt;&lt;td&gt;滑动手势切文、PWA 安装提示、J/K 键盘导航&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;v2.0 的教训也很明确：&lt;strong&gt;不要过度工程化&lt;/strong&gt;（曾想用本地 AI 做语义搜索，最后 Pagefind 够用）；&lt;strong&gt;Sandpack 在线运行代码块&lt;/strong&gt;因加载不稳定被移除；&lt;strong&gt;trusted-devices.json 误提交&lt;/strong&gt;敲了一次安全警钟。&lt;/p&gt;
&lt;h3&gt;v2.1：好维护、好审计（7 月）&lt;a href=&quot;#v21好维护好审计7-月&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;高考后的暑假，博客进入「工程化」阶段——不大改 UI，而是让构建更快、边界更清晰：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;构建期 Mermaid&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;文章里的图表在 Contentlayer 编译时用 JSDOM + Mermaid 预渲染成 SVG，亮/暗双主题各一份，DOMPurify 清理输出。读者侧零 JS 渲染、零闪烁。失败则回退客户端组件，不阻断发布。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;构建并发&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;run-with-concurrency.ts&lt;/code&gt; 按 CPU 核心数限制图片优化与 OG 生成的并行度（2–6 路），避免 &lt;code&gt;Promise.all&lt;/code&gt; 打满内存。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;构建前安全自检&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;新增 &lt;code&gt;scripts/security-audit.ts&lt;/code&gt;，在每次构建前自动跑一遍。核心逻辑很朴素——就是检查清单 + 正则扫描：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// scripts/security-audit.ts（节选）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; required &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &apos;Content-Security-Policy&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &apos;Strict-Transport-Security&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &apos;X-Frame-Options&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &apos;X-Content-Type-Options&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &apos;Referrer-Policy&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &apos;Permissions-Policy&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; h &lt;/span&gt;&lt;span&gt;of&lt;/span&gt;&lt;span&gt; required) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  if&lt;/span&gt;&lt;span&gt; (headers&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;includes&lt;/span&gt;&lt;span&gt;(h)) &lt;/span&gt;&lt;span&gt;pass&lt;/span&gt;&lt;span&gt;(h)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  else&lt;/span&gt;&lt;span&gt; fail&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;`缺少 &lt;/span&gt;&lt;span&gt;${&lt;/span&gt;&lt;span&gt;h&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;`&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// 扫描源码里的硬编码密钥模式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; secretPatterns &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  /&lt;/span&gt;&lt;span&gt;ghp_&lt;/span&gt;&lt;span&gt;[&lt;/span&gt;&lt;span&gt;A-Za-z0-9&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt;{36}&lt;/span&gt;&lt;span&gt;/&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; // GitHub PAT&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  /&lt;/span&gt;&lt;span&gt;sk-&lt;/span&gt;&lt;span&gt;[&lt;/span&gt;&lt;span&gt;A-Za-z0-9&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt;{20,}&lt;/span&gt;&lt;span&gt;/&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; // OpenAI key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  /&lt;/span&gt;&lt;span&gt;AKIA&lt;/span&gt;&lt;span&gt;[&lt;/span&gt;&lt;span&gt;A-Z0-9&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt;{16}&lt;/span&gt;&lt;span&gt;/&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; // AWS key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;]&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;检查项包括：&lt;code&gt;_headers&lt;/code&gt; 是否含全套安全头、工作区是否存在 &lt;code&gt;.env&lt;/code&gt; 等敏感文件、源码中是否出现密钥模式、Service Worker 是否只缓存同源 GET。有错误就 &lt;code&gt;process.exit(1)&lt;/code&gt; 阻断构建——把「安全」从自觉变成强制。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;内容与元数据&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;全文 RSS（而不只是摘要）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;schema-dts&lt;/code&gt; 生成类型安全的 &lt;code&gt;BlogPosting&lt;/code&gt; JSON-LD&lt;/li&gt;
&lt;li&gt;&lt;code&gt;remark-smartypants&lt;/code&gt; 排版插件&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;又踩过的坑&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;kbar 打开搜索时导航 Pill 位移：根因是滚动条被隐藏导致布局宽度变化。最终解法是 &lt;code&gt;ResizeObserver&lt;/code&gt; 监听容器尺寸重算指示器位置：&lt;/li&gt;
&lt;/ul&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// components/header/index.tsx（节选）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; updateIndicator&lt;/span&gt;&lt;span&gt; =&lt;/span&gt;&lt;span&gt; ()&lt;/span&gt;&lt;span&gt; =&amp;gt;&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  const&lt;/span&gt;&lt;span&gt; active &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; containerRef&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;current&lt;/span&gt;&lt;span&gt;?.&lt;/span&gt;&lt;span&gt;querySelector&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;[data-active]&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  if&lt;/span&gt;&lt;span&gt; (active) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    indicator&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;style&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;width &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; `&lt;/span&gt;&lt;span&gt;${&lt;/span&gt;&lt;span&gt;active&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;offsetWidth&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;px`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    indicator&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;style&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;transform &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; `translateX(&lt;/span&gt;&lt;span&gt;${&lt;/span&gt;&lt;span&gt;active&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;offsetLeft&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;px)`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; observer &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; new&lt;/span&gt;&lt;span&gt; ResizeObserver&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt; =&amp;gt;&lt;/span&gt;&lt;span&gt; updateIndicator&lt;/span&gt;&lt;span&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;observer&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;observe&lt;/span&gt;&lt;span&gt;(containerRef&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;current)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;Image&lt;/code&gt; 组件误删 &lt;code&gt;overflow-hidden&lt;/code&gt;：Logo 和 Profile 卡片圆角变方，已恢复。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;v2.2：安全加固 + 新功能（8 月初）&lt;a href=&quot;#v22安全加固--新功能8-月初&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;做完光子遥控之后，我回头给博客做了一轮「年度审计」——用 AI 帮我把整个站点的安全、依赖、性能、SEO 从头过了一遍，一次提交 55 个文件的改动。这大概是&lt;strong&gt;第一次用「审计」而不是「加功能」的视角&lt;/strong&gt;来对待自己的项目：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;安全加固&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;供应链 CVE 修复：通过 &lt;code&gt;pnpm-workspace.yaml&lt;/code&gt; 的 overrides 把 postcss、sharp、picomatch、ws 强制升级到安全版本，&lt;code&gt;pnpm audit --prod&lt;/code&gt; 高危清零&lt;/li&gt;
&lt;li&gt;CSP 大收紧：&lt;code&gt;img-src&lt;/code&gt; 限制为 &lt;code&gt;&apos;self&apos; data: blob: https:&lt;/code&gt;，&lt;code&gt;frame-src&lt;/code&gt; 只保留视频平台白名单并补上 vimeo.com，新增 &lt;code&gt;frame-ancestors &apos;none&apos;&lt;/code&gt;（防点击劫持），HSTS 加 &lt;code&gt;preload&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;JSON-LD 里的 &lt;code&gt;&amp;lt;/script&amp;gt;&lt;/code&gt; 转义（防止标题注入破坏页面结构）&lt;/li&gt;
&lt;li&gt;pagefind 搜索摘要加 DOMPurify 净化（防存储型 XSS）&lt;/li&gt;
&lt;li&gt;Service Worker 缓存策略升级：缓存名 bump 到 v2，HTML 请求加 &lt;code&gt;response.ok&lt;/code&gt; 校验（防缓存 404 页面）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;search.json&lt;/code&gt; 精简：把 filePath、structuredData 等冗余字段从输出剥离，避免暴露内部路径&lt;/li&gt;
&lt;li&gt;CodeQL workflow 的 GitHub Action 全部 pin 到完整 SHA（供应链安全）&lt;/li&gt;
&lt;li&gt;清理 &lt;code&gt;GITHUB_API_TOKEN&lt;/code&gt; 环境变量（已弃用）和一堆死代码&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;性能&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;LCP 图片加 &lt;code&gt;fetchpriority=&quot;high&quot;&lt;/code&gt;（首页头像、文章封面提前加载）&lt;/li&gt;
&lt;li&gt;Giscus 评论区改为 IntersectionObserver 懒加载 + 点击按钮兜底（首屏不再加载评论 iframe）&lt;/li&gt;
&lt;li&gt;文章正文加 &lt;code&gt;content-visibility: auto&lt;/code&gt;（浏览器跳过屏外区块的渲染）&lt;/li&gt;
&lt;li&gt;给实际用到的外部域名加 preconnect（giscus.app、hitokoto 等）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;SEO&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;OG 图升级为多尺寸（1200×630 + 1:1 方形）&lt;/li&gt;
&lt;li&gt;BlogPosting 结构化数据补 &lt;code&gt;wordCount&lt;/code&gt;、&lt;code&gt;inLanguage&lt;/code&gt;、&lt;code&gt;dateModified&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;About 页新增 ProfilePage JSON-LD（作者信息对搜索引擎更友好）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;新功能&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Photos 照片墙页面&lt;/strong&gt;：8 月新页面，支持 4 种媒体类型（静态照片 / Live Photo / 动图 / 视频），瀑布流 + lightbox + 长按播放，媒体直接打包进仓库&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;搜索升级&lt;/strong&gt;：kbar 集成 fuse.js 模糊搜索，中文错字、拼音都能命中（原来只能精确匹配标题）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;分享扩展&lt;/strong&gt;：从 7 渠道扩到 32 平台（内嵌 17 个常用 + 更多面板 14 个）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;依赖升级&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;14 项依赖安全升级（react 19.2.8、next 15.5.22、prettier 3.9.6 等），全部逐组升级、每步构建回归，最后 &lt;code&gt;pnpm audit --prod&lt;/code&gt; 0 high/critical。&lt;/p&gt;
&lt;p&gt;这次审计让我意识到：&lt;strong&gt;项目做久了，「维护」本身就是一种能力&lt;/strong&gt;。不加新功能、只做减法，反而让整个站点更健康。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;二、TimeMark：第一个 Docker 全栈项目&lt;a href=&quot;#二timemark第一个-docker-全栈项目&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;TimeMark 是智能事件提醒系统——农历生日、纪念日，多渠道通知（微信、QQ、钉钉、邮件等三十多种）。&lt;/p&gt;
&lt;p&gt;完整开发故事见 &lt;a href=&quot;/post/timemark-docker&quot;&gt;TimeMark：我的第一个 Docker 项目&lt;/a&gt;。复盘里只提炼&lt;strong&gt;架构演进&lt;/strong&gt;，因为这是半年里最重要的技术认知之一。&lt;/p&gt;
&lt;h3&gt;v1.x：三容器的「豪华配置」&lt;a href=&quot;#v1x三容器的豪华配置&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;第一版：PostgreSQL + Redis/Bull + 应用，&lt;strong&gt;三个容器、约 800MB 内存&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;选型时觉得「专业」——正经数据库、业界标准队列。NAS 用户反馈很直接：低功耗机器上跑不动，一个提醒工具何必这么重。&lt;/p&gt;
&lt;h3&gt;v2.0：大道至简&lt;a href=&quot;#v20大道至简&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;两周重写后端：&lt;/p&gt;






























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;项目&lt;/th&gt;&lt;th&gt;v1.x&lt;/th&gt;&lt;th&gt;v2.0&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;数据库&lt;/td&gt;&lt;td&gt;PostgreSQL 容器&lt;/td&gt;&lt;td&gt;sql.js（单文件 SQLite）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;任务调度&lt;/td&gt;&lt;td&gt;Redis + Bull&lt;/td&gt;&lt;td&gt;Croner（纯 JS cron）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;部署&lt;/td&gt;&lt;td&gt;3 容器&lt;/td&gt;&lt;td&gt;&lt;strong&gt;1 容器&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;内存&lt;/td&gt;&lt;td&gt;~800MB&lt;/td&gt;&lt;td&gt;&lt;strong&gt;~256MB&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;v2.1 又给所有环境变量加了内置默认值，&lt;code&gt;docker compose up -d&lt;/code&gt; 后零配置即用——因为家庭内网场景下，「强迫用户生成随机密钥」本身就是设计错误。还有云平台版（Vercel + PostgreSQL + Serverless），给没有 NAS 的场景用。&lt;/p&gt;
&lt;h3&gt;从 TimeMark 学到的&lt;a href=&quot;#从-timemark-学到的&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;先想清楚用户场景，再选技术&lt;/strong&gt;——家庭用户要的是简单可靠，不是架构炫技&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;monorepo + 共享类型&lt;/strong&gt;——前后端共用 &lt;code&gt;Event&lt;/code&gt; 等类型定义，改一处两边生效&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;踩坑密度高&lt;/strong&gt;——Docker Hub 用户名改六次、镜像名拼写、GHCR 路径……都是真实发布才会遇到的问题&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;换数据库不是换驱动&lt;/strong&gt;——PostgreSQL → SQLite 时 &lt;code&gt;TO_CHAR()&lt;/code&gt;、布尔值、日期排序全都不一样，SQL「标准」在不同数据库里各有怪癖&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;通知渠道用适配器模式&lt;/strong&gt;——35+ 渠道统一抽象成一个接口，新增渠道只写一个 adapter，这个设计让我后来做红外协议编码器时受益很大&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;
&lt;h2&gt;三、Web 游戏：敢不用框架&lt;a href=&quot;#三web-游戏敢不用框架&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;高考前不到一个月，我用 &lt;strong&gt;纯 Vanilla JavaScript&lt;/strong&gt; 做了两款游戏，零依赖、零框架。详见 &lt;a href=&quot;/post/web-games-dev&quot;&gt;从弹幕射击到经典扫雷&lt;/a&gt;。&lt;/p&gt;
&lt;h3&gt;星域战机（弹幕 STG）&lt;a href=&quot;#星域战机弹幕-stg&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;纯 JS 约 &lt;strong&gt;11,500 行&lt;/strong&gt;，含配置近两万行&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;20 流派 × 200 技能 × 20 武器 × 40 道具&lt;/strong&gt;，数据驱动&lt;/li&gt;
&lt;li&gt;引擎与内容分离：新流派只改 &lt;code&gt;config.js&lt;/code&gt;，不动引擎&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;核心技术点：Canvas 渲染、&lt;code&gt;requestAnimationFrame&lt;/code&gt; 游戏循环、&lt;strong&gt;对象池&lt;/strong&gt;复用子弹/粒子、Web Audio API 音效。&lt;/p&gt;
&lt;p&gt;对象池是弹幕游戏不卡顿的关键——屏幕上几百颗子弹飞，如果每颗都 &lt;code&gt;new&lt;/code&gt;，GC 会疯掉。整个游戏运行中 &lt;code&gt;new&lt;/code&gt; 只发生在最开始：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;class&lt;/span&gt;&lt;span&gt; ObjectPool&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  constructor&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;factory&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; initialSize&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; []&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_factory &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; factory&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; (initialSize &lt;/span&gt;&lt;span&gt;||&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;factory&lt;/span&gt;&lt;span&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  pop&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    return&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;length &lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt; ?&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;pop&lt;/span&gt;&lt;span&gt;() &lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_factory&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;obj&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(obj)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;还有游戏循环的「死亡螺旋」——切标签页再切回来，浏览器暂停了 &lt;code&gt;requestAnimationFrame&lt;/code&gt;，回来时 deltaTime 飙到几秒，所有物体瞬间飞出屏幕。解法是一行 &lt;code&gt;Math.min(rawDt, 50)&lt;/code&gt;，超过 50ms 的帧一律按 50ms 算：游戏可能短暂变慢，但不会崩。&lt;/p&gt;
&lt;h3&gt;经典扫雷&lt;a href=&quot;#经典扫雷&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;像素级还原 Windows XP/7 扫雷&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;BFS 洪水填充&lt;/strong&gt;展开空白区、无尽模式、成就、PWA 离线&lt;/li&gt;
&lt;li&gt;三天完成，验证「小项目也能打磨细节」&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;为什么做游戏&lt;a href=&quot;#为什么做游戏&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;博客和 TimeMark 都站在框架肩膀上。我想证明：&lt;strong&gt;不依赖 React/Next，也能做复杂交互。&lt;/strong&gt; 对象池、BFS、状态机——这些在框架里常被封装，自己写一遍才真正理解。后来做光子遥控的红外协议编码器时，这种「从底层自己造」的感觉又回来了——原来框架和库帮你藏起来的细节，才是真正值钱的知识。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;四、知屋：从阅读器到 1.0 书房&lt;a href=&quot;#四知屋从阅读器到-10-书房&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;知屋是&lt;strong&gt;私人阅读与笔记&lt;/strong&gt;项目，和博客的静态架构完全不同：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;静态页面（Astro） + Serverless API（Hono） + Redis 会话 + 对象存储 + Git LFS 书库&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;博客是「写出来给人看」；知屋是「用起来管自己的书与笔记」。&lt;strong&gt;闭源、需登录&lt;/strong&gt;，不对外公开仓库与部署地址。&lt;/p&gt;
&lt;h3&gt;7 月集中迭代做了什么&lt;a href=&quot;#7-月集中迭代做了什么&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;阅读与内容&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;EPUB/PDF 阅读、划线批注、三栏布局阅读器&lt;/li&gt;
&lt;li&gt;从 PagePulse 迁移教材目录、FSRS 间隔复习、闪卡与词汇&lt;/li&gt;
&lt;li&gt;书架按章节正文含量自动分级（书籍 vs 学习资料）&lt;/li&gt;
&lt;li&gt;内置教材封面本地化、章节纲要逐节正文&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;AI&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;从本机 ONNX 逐步迁到&lt;strong&gt;云端流式代理&lt;/strong&gt;（用户 Key 加密存 Redis，不进部署环境变量）&lt;/li&gt;
&lt;li&gt;多会话对话 UI、停止/重试、提示词缓存&lt;/li&gt;
&lt;li&gt;后期精简 Agent 提示词与权限边界&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;存储&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Vercel Blob → Cloudflare R2 优先，统一 &lt;code&gt;cloud-store&lt;/code&gt; 抽象层——换存储厂商只改一个实现，上层代码不动&lt;/li&gt;
&lt;li&gt;私有书库 Vault（Git LFS）存 PDF/笔记/进度，与前端代码仓分离，无公开 raw 链接&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;安全（三轮加固）&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;localStorage 会话 → &lt;strong&gt;HttpOnly Cookie&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;人机验证（Turnstile）、CORS 绑定正式域名&lt;/li&gt;
&lt;li&gt;本地 security-probe 自检脚本&lt;/li&gt;
&lt;li&gt;修复登录重复弹窗、OpenList 兼容性等&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;客户端&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Android / Windows 原生壳（加载线上站点，WebView 行为与浏览器一致）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;知屋让我第一次系统面对&lt;strong&gt;有用户数据的后端安全&lt;/strong&gt;：静态博客扫一遍 &lt;code&gt;_headers&lt;/code&gt; 就够；全栈项目要管会话、存储、AI Key、跨域、探针，完全是另一个量级。三轮 &lt;code&gt;fix(security)&lt;/code&gt; 才稳住，每一轮都是被真实问题（或者说，被「万一被别人搞」的想象）逼出来的。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;五、光子遥控：第一个原生 Android 项目&lt;a href=&quot;#五光子遥控第一个原生-android-项目&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;完整代码：&lt;a href=&quot;https://github.com/WXFffff666/photon-remote&quot;&gt;github.com/WXFffff666/photon-remote&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;这是 8 月初刚推出的项目，也是我的&lt;strong&gt;第一个原生 Android 应用&lt;/strong&gt;——之前的所有项目都在 Web 技术栈里打转。&lt;/p&gt;
&lt;h3&gt;为什么做&lt;a href=&quot;#为什么做&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;家里遥控器太多了：电视一个、机顶盒一个、空调一个、风扇一个，每个都长得差不多，还总找不到。市面上万能遥控 App 不少，但要么广告满天飞，要么机顶盒运营商码库不全。于是决定自己写一个。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;光子遥控&lt;/strong&gt;是一款安卓万能红外遥控器：把电视、机顶盒、空调、风扇等家电装进手机里，中国国内市场优先，完全离线可用。&lt;/p&gt;
&lt;h3&gt;技术栈&lt;a href=&quot;#技术栈&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;























































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;层面&lt;/th&gt;&lt;th&gt;技术&lt;/th&gt;&lt;th&gt;说明&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;语言&lt;/td&gt;&lt;td&gt;Kotlin 2.1.20&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;UI&lt;/td&gt;&lt;td&gt;Jetpack Compose + Material 3&lt;/td&gt;&lt;td&gt;动态取色 / 深浅色 / 纯黑 AMOLED / 强调色&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;自适应&lt;/td&gt;&lt;td&gt;material3-adaptive-navigation-suite&lt;/td&gt;&lt;td&gt;手机 Compact 与平板 Expanded 双形态&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;数据库&lt;/td&gt;&lt;td&gt;Room（设备 / 按键 / 宏三张表）&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;配置存储&lt;/td&gt;&lt;td&gt;DataStore Preferences&lt;/td&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;序列化&lt;/td&gt;&lt;td&gt;kotlinx.serialization&lt;/td&gt;&lt;td&gt;按键动作 / 布局 / 备份&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;红外发射&lt;/td&gt;&lt;td&gt;ConsumerIrManager + USB + 音频转红外&lt;/td&gt;&lt;td&gt;三路自动路由&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;码库解码&lt;/td&gt;&lt;td&gt;IREXT（JNI 离线解码二进制码库）&lt;/td&gt;&lt;td&gt;MIT 协议&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;测试&lt;/td&gt;&lt;td&gt;JUnit 4 + Mockito + Robolectric&lt;/td&gt;&lt;td&gt;&lt;strong&gt;211 个单测全通过&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3&gt;14 种红外协议编码器&lt;a href=&quot;#14-种红外协议编码器&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;红外遥控最底层的知识：每种协议定义了载波频率、前导码、位时序。比如最经典的 NEC 协议——38kHz 载波，前导 &lt;code&gt;9000/4500 µs&lt;/code&gt;，逻辑 0 是 &lt;code&gt;562/562 µs&lt;/code&gt;，逻辑 1 是 &lt;code&gt;562/1687 µs&lt;/code&gt;，每字节 LSB 先发。&lt;/p&gt;
&lt;p&gt;我把这 14 种协议（NEC 家族 / RC5 / RC6 / SONY / SAMSUNG / SHARP / JVC / KASEIKYO / PIONEER / RAW）全部自研实现，每个协议一个文件，接口统一：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// ir/core/ProtocolType.kt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;enum&lt;/span&gt;&lt;span&gt; class&lt;/span&gt;&lt;span&gt; ProtocolType&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    NEC, NECX1, NECX2, RC5, RC6, SONY12, SONY15, SONY20,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    SAMSUNG32, SHARP, JVC, KASEIKYO, PIONEER, RAW&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;以 NEC 编码器为例——输入一个 hex 码串，输出一串 mark/space 时间间隔（微秒）：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// ir/protocol/NecEncoder.kt（节选）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;object&lt;/span&gt;&lt;span&gt; NecEncoder&lt;/span&gt;&lt;span&gt; : &lt;/span&gt;&lt;span&gt;IrProtocolEncoder&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    override&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; protocol: &lt;/span&gt;&lt;span&gt;ProtocolType&lt;/span&gt;&lt;span&gt; =&lt;/span&gt;&lt;span&gt; ProtocolType.NEC&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    override&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; repeatIntervalMs: &lt;/span&gt;&lt;span&gt;Int&lt;/span&gt;&lt;span&gt; =&lt;/span&gt;&lt;span&gt; 110&lt;/span&gt;&lt;span&gt;   // NEC 长按重复间隔&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; FREQUENCY &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 38000&lt;/span&gt;&lt;span&gt;                // 38kHz 载波&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; PRE_MARK &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 9000&lt;/span&gt;&lt;span&gt;                  // 前导 mark µs&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; PRE_SPACE &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 4500&lt;/span&gt;&lt;span&gt;                 // 前导 space µs&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; BIT_MARK &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 562&lt;/span&gt;&lt;span&gt;                   // 位 mark&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; BIT0_SPACE &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 562&lt;/span&gt;&lt;span&gt;                 // 逻辑 0 的 space&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; BIT1_SPACE &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 1687&lt;/span&gt;&lt;span&gt;                // 逻辑 1 的 space&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    override&lt;/span&gt;&lt;span&gt; fun&lt;/span&gt;&lt;span&gt; encode&lt;/span&gt;&lt;span&gt;(hex: &lt;/span&gt;&lt;span&gt;String&lt;/span&gt;&lt;span&gt;, press: &lt;/span&gt;&lt;span&gt;PressKind&lt;/span&gt;&lt;span&gt;): &lt;/span&gt;&lt;span&gt;IRPattern&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        if&lt;/span&gt;&lt;span&gt; (press &lt;/span&gt;&lt;span&gt;==&lt;/span&gt;&lt;span&gt; PressKind.REPEAT) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            // NEC 短重复帧：9000/2250 + 562µs mark，与码值无关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            return&lt;/span&gt;&lt;span&gt; IRPattern&lt;/span&gt;&lt;span&gt;(FREQUENCY, &lt;/span&gt;&lt;span&gt;intArrayOf&lt;/span&gt;&lt;span&gt;(PRE_MARK, &lt;/span&gt;&lt;span&gt;2250&lt;/span&gt;&lt;span&gt;, &lt;/span&gt;&lt;span&gt;562&lt;/span&gt;&lt;span&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        val&lt;/span&gt;&lt;span&gt; normalized &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; hex.&lt;/span&gt;&lt;span&gt;trim&lt;/span&gt;&lt;span&gt;().&lt;/span&gt;&lt;span&gt;uppercase&lt;/span&gt;&lt;span&gt;().&lt;/span&gt;&lt;span&gt;padStart&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;8&lt;/span&gt;&lt;span&gt;, &lt;/span&gt;&lt;span&gt;&apos;0&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        require&lt;/span&gt;&lt;span&gt;(normalized.length &lt;/span&gt;&lt;span&gt;&amp;lt;=&lt;/span&gt;&lt;span&gt; 8&lt;/span&gt;&lt;span&gt;) { &lt;/span&gt;&lt;span&gt;&quot;NEC 码最多 8 位十六进制: &lt;/span&gt;&lt;span&gt;$hex&lt;/span&gt;&lt;span&gt;&quot;&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        // 每字节 LSB 先发：0x00FF12ED → 4 字节，每字节低位在前&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        val&lt;/span&gt;&lt;span&gt; bytes &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; normalized.&lt;/span&gt;&lt;span&gt;chunked&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;2&lt;/span&gt;&lt;span&gt;).&lt;/span&gt;&lt;span&gt;map&lt;/span&gt;&lt;span&gt; { it.&lt;/span&gt;&lt;span&gt;toInt&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;16&lt;/span&gt;&lt;span&gt;) }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        val&lt;/span&gt;&lt;span&gt; bits &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; bytes.&lt;/span&gt;&lt;span&gt;flatMap&lt;/span&gt;&lt;span&gt; { b &lt;/span&gt;&lt;span&gt;-&amp;gt;&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;0&lt;/span&gt;&lt;span&gt;..&lt;/span&gt;&lt;span&gt;7&lt;/span&gt;&lt;span&gt;).&lt;/span&gt;&lt;span&gt;map&lt;/span&gt;&lt;span&gt; { (b shr it) and &lt;/span&gt;&lt;span&gt;1&lt;/span&gt;&lt;span&gt; } }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        val&lt;/span&gt;&lt;span&gt; list &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; mutableListOf&lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;Int&lt;/span&gt;&lt;span&gt;&amp;gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        list &lt;/span&gt;&lt;span&gt;+=&lt;/span&gt;&lt;span&gt; PRE_MARK; list &lt;/span&gt;&lt;span&gt;+=&lt;/span&gt;&lt;span&gt; PRE_SPACE&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        for&lt;/span&gt;&lt;span&gt; (b &lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt; bits) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            list &lt;/span&gt;&lt;span&gt;+=&lt;/span&gt;&lt;span&gt; BIT_MARK&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            list &lt;/span&gt;&lt;span&gt;+=&lt;/span&gt;&lt;span&gt; if&lt;/span&gt;&lt;span&gt; (b &lt;/span&gt;&lt;span&gt;==&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;) BIT0_SPACE &lt;/span&gt;&lt;span&gt;else&lt;/span&gt;&lt;span&gt; BIT1_SPACE&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        list &lt;/span&gt;&lt;span&gt;+=&lt;/span&gt;&lt;span&gt; 562&lt;/span&gt;&lt;span&gt;                                  // 帧尾&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        list &lt;/span&gt;&lt;span&gt;+=&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;108_800&lt;/span&gt;&lt;span&gt; -&lt;/span&gt;&lt;span&gt; list.&lt;/span&gt;&lt;span&gt;sum&lt;/span&gt;&lt;span&gt;()).&lt;/span&gt;&lt;span&gt;coerceAtLeast&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;0&lt;/span&gt;&lt;span&gt;)  &lt;/span&gt;&lt;span&gt;// 补零到整帧&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        return&lt;/span&gt;&lt;span&gt; IRPattern&lt;/span&gt;&lt;span&gt;(FREQUENCY, list.&lt;/span&gt;&lt;span&gt;toIntArray&lt;/span&gt;&lt;span&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;这段代码看起来简单，但每个数字背后都是真实硬件的行为约束：&lt;code&gt;ConsumerIrManager.transmit&lt;/code&gt; 会&lt;strong&gt;阻塞到整帧发完&lt;/strong&gt;（NEC 补零后最长 108.8ms），所以绝不能在主线程调用；长按重复帧必须和完整帧区分开，否则长按音量键会卡死界面。&lt;/p&gt;
&lt;h3&gt;单线程发射调度器&lt;a href=&quot;#单线程发射调度器&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;宏、暴力找码、长按连发可能同时触发发送，而 IREXT 的 JNI 解码是共享原生状态的单例——并发调用会互相污染。所以所有红外发送和 IREXT 解码都走一个&lt;strong&gt;单线程队列&lt;/strong&gt;：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// ir/transmitter/IrDispatcher.kt（节选）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;class&lt;/span&gt;&lt;span&gt; IrDispatcher&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    private&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; transmitFn: &lt;/span&gt;&lt;span&gt;suspend&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;IRPattern&lt;/span&gt;&lt;span&gt;) -&amp;gt; &lt;/span&gt;&lt;span&gt;Boolean&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    private&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; scope: &lt;/span&gt;&lt;span&gt;CoroutineScope&lt;/span&gt;&lt;span&gt; =&lt;/span&gt;&lt;span&gt; CoroutineScope&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;SupervisorJob&lt;/span&gt;&lt;span&gt;() &lt;/span&gt;&lt;span&gt;+&lt;/span&gt;&lt;span&gt; Dispatchers.Default),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    private&lt;/span&gt;&lt;span&gt; val&lt;/span&gt;&lt;span&gt; queue &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; Channel&lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;suspend&lt;/span&gt;&lt;span&gt; () &lt;/span&gt;&lt;span&gt;-&amp;gt;&lt;/span&gt;&lt;span&gt; Unit&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;(Channel.UNLIMITED)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    init&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        scope.&lt;/span&gt;&lt;span&gt;launch&lt;/span&gt;&lt;span&gt; { &lt;/span&gt;&lt;span&gt;for&lt;/span&gt;&lt;span&gt; (task &lt;/span&gt;&lt;span&gt;in&lt;/span&gt;&lt;span&gt; queue) &lt;/span&gt;&lt;span&gt;task&lt;/span&gt;&lt;span&gt;() }   &lt;/span&gt;&lt;span&gt;// 常驻消费协程，天然串行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    suspend&lt;/span&gt;&lt;span&gt; fun&lt;/span&gt;&lt;span&gt; send&lt;/span&gt;&lt;span&gt;(pattern: &lt;/span&gt;&lt;span&gt;IRPattern&lt;/span&gt;&lt;span&gt;): &lt;/span&gt;&lt;span&gt;Boolean&lt;/span&gt;&lt;span&gt; =&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        onQueue&lt;/span&gt;&lt;span&gt; { &lt;/span&gt;&lt;span&gt;transmitFn&lt;/span&gt;&lt;span&gt;(pattern) }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    suspend&lt;/span&gt;&lt;span&gt; fun&lt;/span&gt;&lt;span&gt; &amp;lt;&lt;/span&gt;&lt;span&gt;T&lt;/span&gt;&lt;span&gt;&amp;gt; &lt;/span&gt;&lt;span&gt;onQueue&lt;/span&gt;&lt;span&gt;(block: &lt;/span&gt;&lt;span&gt;suspend&lt;/span&gt;&lt;span&gt; () &lt;/span&gt;&lt;span&gt;-&amp;gt;&lt;/span&gt;&lt;span&gt; T): &lt;/span&gt;&lt;span&gt;T&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        val&lt;/span&gt;&lt;span&gt; deferred &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; CompletableDeferred&lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;T&lt;/span&gt;&lt;span&gt;&amp;gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        queue.&lt;/span&gt;&lt;span&gt;send&lt;/span&gt;&lt;span&gt; { deferred.&lt;/span&gt;&lt;span&gt;completeWith&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;runCatching&lt;/span&gt;&lt;span&gt; { &lt;/span&gt;&lt;span&gt;block&lt;/span&gt;&lt;span&gt;() }) }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        return&lt;/span&gt;&lt;span&gt; deferred.&lt;/span&gt;&lt;span&gt;await&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;原理很简单：一个 &lt;code&gt;Channel&lt;/code&gt; 队列 + 一个常驻消费协程，所有任务进去后逐个执行，天然串行。&lt;code&gt;CompletableDeferred&lt;/code&gt; 让调用方能拿到结果，&lt;code&gt;runCatching&lt;/code&gt; 保证某个任务炸了不影响队列后续任务。&lt;/p&gt;
&lt;h3&gt;机顶盒省市运营商三级筛选 + 离线码库&lt;a href=&quot;#机顶盒省市运营商三级筛选--离线码库&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;中国市场的机顶盒码库按「省份 → 城市 → 运营商（移动/联通/电信/广电）」组织，再结合定位自动匹配。码库来自 IREXT 的开源实现（MIT 协议，JNI 离线解码二进制码库），加上精选的 irdb CSV，&lt;strong&gt;完全离线内置&lt;/strong&gt;，飞行模式下也能用。&lt;/p&gt;
&lt;h3&gt;其他亮点&lt;a href=&quot;#其他亮点&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;宏&lt;/strong&gt;：把多个设备的多步按键串成一条宏（如「电视开机 → 调音量 → 机顶盒确定」），可调步间延迟、可中途停止&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;暴力找码&lt;/strong&gt;：协议 + hex 前缀约束，自动迭代发码，设备一响应就保存为按键&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;导入导出&lt;/strong&gt;：Flipper &lt;code&gt;.ir&lt;/code&gt;、LIRC &lt;code&gt;.conf&lt;/code&gt;、JSON 全量备份，逐条校验，坏记录跳过不中断&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;无红外扩展&lt;/strong&gt;：USB 红外外设（RLE 帧收发、热插拔重连）和音频转红外适配器（AudioTrack 192kHz 合成 38kHz 载波）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;211 个单元测试&lt;/strong&gt;：协议波形（前导/位序/帧尾/总长）、数据层、调度器、序列化全覆盖&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;从光子遥控学到的&lt;a href=&quot;#从光子遥控学到的&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;「简单」的底层往往最难&lt;/strong&gt;——一个 NEC 编码器 40 行，但它是被真实硬件约束逼出来的：阻塞时长、重复帧、补零，全是查协议文档 + 实机测试得来的&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;共享原生状态要串行化&lt;/strong&gt;——JNI 单例 + 并发调用 = 状态污染，一个 Channel 队列解决&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;测试先行在协议层最值钱&lt;/strong&gt;——波形是纯函数，输入输出确定，211 个单测里协议测试占了很大比重，改起来心里有底&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;国产市场的坑&lt;/strong&gt;——运营商机顶盒码库、省市筛选、定位匹配，这些「本地化」需求是海外开源项目永远不会替你考虑的&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;
&lt;h2&gt;六、其他项目（简表）&lt;a href=&quot;#六其他项目简表&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;项目&lt;/th&gt;&lt;th&gt;类型&lt;/th&gt;&lt;th&gt;技术要点&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;LinkRoom&lt;/td&gt;&lt;td&gt;桌面工具&lt;/td&gt;&lt;td&gt;C#、EasyTier P2P 局域网联机&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;知屋 Vault&lt;/td&gt;&lt;td&gt;私有数据仓&lt;/td&gt;&lt;td&gt;Git LFS、manifest 索引，仅供知屋拉取&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;TimeMark 云平台版&lt;/td&gt;&lt;td&gt;Serverless&lt;/td&gt;&lt;td&gt;PostgreSQL、Cron Jobs，免 Docker&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;小米平板系统补丁模块&lt;/td&gt;&lt;td&gt;系统模块&lt;/td&gt;&lt;td&gt;Smali 反编译补丁，Magisk 生态&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;给设备编译驱动模块&lt;/td&gt;&lt;td&gt;系统模块&lt;/td&gt;&lt;td&gt;给自己的设备编译适配驱动（如 GPU），不是编译完整驱动&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;这些在博客 Projects 页有卡片展示；闭源项目只写能力描述，不附仓库或线上链接。&lt;/p&gt;
&lt;p&gt;顺带说一句：上面提到的「给设备编译驱动」，是&lt;strong&gt;给自己的设备编译适配&lt;/strong&gt;——比如给我的小米平板编一个能用的 GPU 驱动模块，配合 Magisk 刷进去用。这不是从零编译完整驱动（我也没那个能力），而是在开源驱动源码基础上做配置、打补丁、适配到我的设备上。折腾设备这件事，本来就不是「从零造轮子」，而是&lt;strong&gt;把别人造好的轮子装到自己车上，并且让它转起来&lt;/strong&gt;。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;七、横向对比：我怎么做技术选型&lt;a href=&quot;#七横向对比我怎么做技术选型&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;半年里五个主项目，架构差异很大，但选型逻辑有迹可循：&lt;/p&gt;















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;项目&lt;/th&gt;&lt;th&gt;渲染/部署&lt;/th&gt;&lt;th&gt;数据&lt;/th&gt;&lt;th&gt;为什么这样选&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;博客&lt;/td&gt;&lt;td&gt;静态导出 + CDN&lt;/td&gt;&lt;td&gt;无（MDX 文件）&lt;/td&gt;&lt;td&gt;内容站、零运维、安全面小&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;TimeMark Docker&lt;/td&gt;&lt;td&gt;单容器&lt;/td&gt;&lt;td&gt;SQLite 文件&lt;/td&gt;&lt;td&gt;NAS 用户要备份简单、内存省&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;TimeMark 云&lt;/td&gt;&lt;td&gt;Serverless&lt;/td&gt;&lt;td&gt;PostgreSQL&lt;/td&gt;&lt;td&gt;无 NAS 也要能用&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Web 游戏&lt;/td&gt;&lt;td&gt;纯静态 HTML/JS&lt;/td&gt;&lt;td&gt;无&lt;/td&gt;&lt;td&gt;练底层、零构建链&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;知屋&lt;/td&gt;&lt;td&gt;静态 + API&lt;/td&gt;&lt;td&gt;Redis + R2 + LFS&lt;/td&gt;&lt;td&gt;要登录、要同步、要大文件&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;光子遥控&lt;/td&gt;&lt;td&gt;原生 App&lt;/td&gt;&lt;td&gt;Room（本地）&lt;/td&gt;&lt;td&gt;要离线、要硬件能力（红外）&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;一个越来越清晰的原则：&lt;strong&gt;用户是谁、数据存在哪、要不要登录&lt;/strong&gt;——三个问题先答了，技术栈就不会偏太远。到了光子遥控，答案变成了：&lt;strong&gt;要不要碰硬件、要不要离线&lt;/strong&gt;——要，那就原生 + 本地库 + 离线码库，别想用 Web 壳糊弄。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;八、安全：三种完全不同的工作量&lt;a href=&quot;#八安全三种完全不同的工作量&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;静态博客&lt;a href=&quot;#静态博客&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;攻击面主要是 XSS（MDX、Giscus）、供应链依赖、CSP 配置。v2.1 加了构建前 &lt;code&gt;security-audit.ts&lt;/code&gt;（代码见上文），v2.2 又做了一轮完整加固（CVE overrides、CSP 收紧、JSON-LD 转义、DOMPurify、sw.js 缓存策略），检查项包括：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;_headers&lt;/code&gt; 是否含 CSP、HSTS、X-Frame-Options 等&lt;/li&gt;
&lt;li&gt;工作区是否存在 &lt;code&gt;.env&lt;/code&gt;、误提交的敏感文件&lt;/li&gt;
&lt;li&gt;源码中是否出现 &lt;code&gt;ghp_&lt;/code&gt;、&lt;code&gt;sk-&lt;/code&gt; 等密钥模式&lt;/li&gt;
&lt;li&gt;Service Worker 是否只缓存同源 GET&lt;/li&gt;
&lt;li&gt;&lt;code&gt;pnpm audit --prod&lt;/code&gt; 是否 0 high&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;已知权衡：Next.js 静态导出需要 CSP &lt;code&gt;unsafe-inline&lt;/code&gt;；&lt;code&gt;img-src *&lt;/code&gt; 方便文章外链图——都是可接受的残余风险。&lt;/p&gt;
&lt;h3&gt;全栈应用（知屋）&lt;a href=&quot;#全栈应用知屋&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;HttpOnly Cookie、Turnstile、CORS 收紧、AI Key 加密、R2 权限、安全探针脚本……&lt;strong&gt;三轮&lt;/strong&gt; &lt;code&gt;fix(security)&lt;/code&gt; 才稳住。有后端就必须按后端的标准做，不能套用静态站的检查清单。&lt;/p&gt;
&lt;h3&gt;原生 App（光子遥控）&lt;a href=&quot;#原生-app光子遥控&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;又是另一种维度：&lt;strong&gt;开源协议合规&lt;/strong&gt;。App 内置了 IREXT（MIT）、irdb（宽松许可）、Flipper IRDB（MIT）三套第三方码库，README 里逐一声明出处；&lt;strong&gt;明确排除了 AGPLv3 的 mi_remote_database&lt;/strong&gt;——选型时就把许可不兼容的库挡在门外，比事后换库便宜得多。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;九、踩坑合集（跨项目）&lt;a href=&quot;#九踩坑合集跨项目&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;把各项目里印象最深的坑放在一起，方便以后翻：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;过度设计&lt;/strong&gt; — TimeMark v1 三容器；博客曾想用本地 AI 搜索。解法：先 MVP，再按需加。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;像素级 UI bug&lt;/strong&gt; — kbar 位移、圆角被 &lt;code&gt;overflow-hidden&lt;/code&gt; 误删。解法：模态框 + 居中布局要测滚动条；改 UI 组件要看回归。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;发布细节&lt;/strong&gt; — Docker 镜像名拼错、Hub 用户名多次调整。解法：CI 里固定镜像名，文档写清推送步骤。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;静态站 CSP&lt;/strong&gt; — 想要严格 nonce，但没有服务端。解法：接受 &lt;code&gt;unsafe-inline&lt;/code&gt; 或维护 hash 列表（成本高）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;死代码拖延&lt;/strong&gt; — Sandpack 移除 Run 按钮后依赖留了几个月。解法：功能砍掉就删依赖，别「以后可能还用」。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;安全文件误提交&lt;/strong&gt; — trusted-devices.json。解法：&lt;code&gt;.gitignore&lt;/code&gt; + 构建前扫描。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;JNI 状态污染&lt;/strong&gt; — 光子遥控的 IREXT 是共享原生单例，并发解码会互相污染。解法：所有解码走单线程队列（IrDispatcher）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;阻塞型硬件调用&lt;/strong&gt; — &lt;code&gt;ConsumerIrManager.transmit&lt;/code&gt; 会阻塞到整帧发完（最长 108.8ms）。解法：绝不在主线程调用，统一走后端调度器。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;供应链漏洞&lt;/strong&gt; — 传递依赖（postcss、sharp 等）有 CVE。解法：pnpm overrides 强制升级，audit 常态化。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;缓存了 404&lt;/strong&gt; — sw.js 缓存了失败响应，离线时页面错乱。解法：缓存前检查 &lt;code&gt;response.ok&lt;/code&gt;。&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;
&lt;h2&gt;十、数据印象（不追求精确）&lt;a href=&quot;#十数据印象不追求精确&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;













































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;维度&lt;/th&gt;&lt;th&gt;博客&lt;/th&gt;&lt;th&gt;TimeMark&lt;/th&gt;&lt;th&gt;游戏&lt;/th&gt;&lt;th&gt;知屋&lt;/th&gt;&lt;th&gt;光子遥控&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;时间跨度&lt;/td&gt;&lt;td&gt;2 月–8 月持续&lt;/td&gt;&lt;td&gt;4 月–5 月主开发&lt;/td&gt;&lt;td&gt;5 月约两周&lt;/td&gt;&lt;td&gt;7 月集中爆发&lt;/td&gt;&lt;td&gt;8 月初（进行中）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;主语言&lt;/td&gt;&lt;td&gt;TypeScript&lt;/td&gt;&lt;td&gt;TypeScript&lt;/td&gt;&lt;td&gt;JavaScript&lt;/td&gt;&lt;td&gt;TypeScript&lt;/td&gt;&lt;td&gt;Kotlin&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;体量感&lt;/td&gt;&lt;td&gt;100+ commit（半年）&lt;/td&gt;&lt;td&gt;全栈 + Docker&lt;/td&gt;&lt;td&gt;~1.5 万行 JS&lt;/td&gt;&lt;td&gt;全栈 + 存储&lt;/td&gt;&lt;td&gt;单测 211 个&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;开源&lt;/td&gt;&lt;td&gt;私有仓库&lt;/td&gt;&lt;td&gt;开源&lt;/td&gt;&lt;td&gt;开源&lt;/td&gt;&lt;td&gt;闭源&lt;/td&gt;&lt;td&gt;开源&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;博客 Changelog 从 v1.0.0 记到 v2.2.0，光 5 月底 v2.0 单次升级就 50+ 项改进——这些数字说明的是&lt;strong&gt;迭代频率&lt;/strong&gt;，不是炫耀代码行数。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;十一、如果重来，我会怎么排期&lt;a href=&quot;#十一如果重来我会怎么排期&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;诚实说，有些顺序我会调整：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;博客 v2.0 可以拆成两期&lt;/strong&gt; — MDX 组件 + Pagefind 一期，分享/动画一期，避免一次改太多难以回归测试。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;TimeMark 应该更早做单容器&lt;/strong&gt; — v1 的三容器架构本可跳过，直接听 NAS 用户场景。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;知屋 AI 路径应更早定云端&lt;/strong&gt; — 本机 ONNX 在 Vercel 构建体积和 Edge 跟踪防护下走了很多弯路，最后仍迁到服务端代理。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;文档与博客同步写&lt;/strong&gt; — TimeMark 和游戏的专文是事后补的；边做边写能少靠 git 回忆决策原因。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;安全审计应该定期做，而不是等大版本&lt;/strong&gt; — v2.2 的 55 文件大改动如果拆成每月一次的小审计，风险会更小。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;反过来，&lt;strong&gt;不会改&lt;/strong&gt;的选择：博客坚持静态导出、游戏坚持 Vanilla JS、TimeMark v2 砍 Redis/Postgres、知屋闭源且数据与代码分仓、光子遥控坚持自研协议编码器（而不是直接套现成库）——自己把 NEC 波形写一遍，才知道那些开源库帮你藏了多少细节。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;十二、下半年想做什么&lt;a href=&quot;#十二下半年想做什么&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;不列具体地址，只列方向：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;博客：继续写文章，CSP 与依赖审计常态化，少堆新功能、多打磨阅读体验&lt;/li&gt;
&lt;li&gt;知屋：1.0 后的文档与复习闭环，存储配额与 LFS 策略长期可维护&lt;/li&gt;
&lt;li&gt;TimeMark：跟用户反馈迭代通知渠道与部署体验&lt;/li&gt;
&lt;li&gt;游戏：高考后若有空，给扫雷加更多主题或给 STG 做平衡性调参&lt;/li&gt;
&lt;li&gt;光子遥控：继续补全 UI 细节与更多设备码组，把离线码库的维护流程跑通&lt;/li&gt;
&lt;li&gt;折腾设备：继续给我的设备编译适配驱动模块、玩 NAS，把「折腾」写进博客&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;总结&lt;a href=&quot;#总结&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;这半年多，我不是在「学一门技术」，而是在&lt;strong&gt;反复经历同一条曲线&lt;/strong&gt;：&lt;/p&gt;
&lt;p&gt;做一个东西 → 觉得不够好用或大改 → 踩坑 → 写文档或博文 → 下一个项目带着上次的教训&lt;/p&gt;
&lt;p&gt;博客教会我前端工程化和设计系统；TimeMark 教会我&lt;strong&gt;别为用技术而用技术&lt;/strong&gt;；游戏教会我&lt;strong&gt;框架之下还有什么&lt;/strong&gt;；知屋教会我&lt;strong&gt;有数据就要有安全模型&lt;/strong&gt;；光子遥控教会我&lt;strong&gt;最底层的协议里藏着最硬的知识&lt;/strong&gt;——以及，选型时要先把开源协议的许可看清楚。&lt;/p&gt;
&lt;p&gt;如果你也在读书、做作业之余做 side project，我的建议只有一句：&lt;strong&gt;做给自己用的东西，然后把踩坑写下来。&lt;/strong&gt; 半年后回头看，会比只记得「做过某某项目」有用得多。&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;&lt;em&gt;更多分项细节可参阅本系列其它文章：&lt;a href=&quot;/post/my-blog-journey&quot;&gt;博客搭建之旅&lt;/a&gt;、&lt;a href=&quot;/post/blog-v2-optimization&quot;&gt;博客 v2.0 升级&lt;/a&gt;、&lt;a href=&quot;/post/timemark-docker&quot;&gt;TimeMark Docker&lt;/a&gt;、&lt;a href=&quot;/post/web-games-dev&quot;&gt;Web 游戏开发手记&lt;/a&gt;，以及站内 &lt;a href=&quot;/changelog&quot;&gt;Changelog&lt;/a&gt;。&lt;/em&gt;&lt;/p&gt;</content:encoded><category>category:笔记</category><category>category:开发之旅</category><category>tag:技术</category><category>tag:成长</category><category>tag:Next.js</category><category>tag:Docker</category><category>tag:全栈</category><category>tag:复盘</category><category>tag:Kotlin</category><category>tag:Android</category></item><item><title>博客大升级 v2.0：从单调到丰富的全站优化之旅</title><link>https://blog.the37777777.top/post/blog-v2-optimization</link><guid isPermaLink="false">blog-v2-optimization</guid><description>记录博客 v2.0 全站增强的完整过程：15 个 MDX 组件、Pagefind 中文全文搜索、7 渠道社交分享、阅读体验升级等 50+ 项改进。</description><pubDate>Sat, 30 May 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;写在前面&lt;a href=&quot;#写在前面&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;距离上次写博客搭建文章已经过了几个月了。这段时间里，我一直在用这个博客写文章、记录生活，但总觉得少了点什么——功能太单调了，读者体验也不够好。&lt;/p&gt;
&lt;p&gt;于是趁着周末，我决定给博客来一次大升级。没想到这一改就停不下来了，最后做了 &lt;strong&gt;50+ 项改进&lt;/strong&gt;，涉及 &lt;strong&gt;70+ 个文件&lt;/strong&gt;，提交了 &lt;strong&gt;9 次 commit&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;这篇文章记录一下这次升级的过程，包括做了什么、怎么做的、踩了哪些坑。&lt;/p&gt;
&lt;h2&gt;为什么要升级&lt;a href=&quot;#为什么要升级&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;说实话，之前的博客虽然能用，但有几个问题一直困扰我：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;功能单调&lt;/strong&gt; — 除了写文章和评论，没有其他互动方式&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;搜索不够好&lt;/strong&gt; — kbar 搜索只能匹配标题，不能搜文章内容&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;分享不方便&lt;/strong&gt; — 想分享给朋友，只有几个国外平台的按钮&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;阅读体验一般&lt;/strong&gt; — 字体大小固定，没有专注模式&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;MDX 组件太少&lt;/strong&gt; — 写技术文章时想用 Tabs、Steps 这些组件，但没有&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;有几个 Bug&lt;/strong&gt; — 图片放大不了、一言不刷新、有测试数据残留&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;所以这次的目标很明确：&lt;strong&gt;让博客从”能用”变成”好用”&lt;/strong&gt;。&lt;/p&gt;
&lt;h2&gt;这次做了什么&lt;a href=&quot;#这次做了什么&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;🐛 Bug 修复（4 项）&lt;a href=&quot;#-bug-修复4-项&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;修复了 &lt;code&gt;trusted-devices.json&lt;/code&gt; 被意外提交到 Git 的安全问题&lt;/li&gt;
&lt;li&gt;实现了一言（Hitokoto）30 秒自动刷新 + 淡入淡出动画&lt;/li&gt;
&lt;li&gt;清理了 Moments 里的测试数据&lt;/li&gt;
&lt;li&gt;移除了代码块的 Run 按钮（Sandpack 加载太不稳定了）&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;📦 MDX 组件库（15 个新组件）&lt;a href=&quot;#-mdx-组件库15-个新组件&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这是这次升级最大的工作量。我一口气做了 15 个 MDX 组件：&lt;/p&gt;

































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;组件&lt;/th&gt;&lt;th&gt;用途&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Callout&lt;/td&gt;&lt;td&gt;提示框（info/tip/warning/error/success）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Tabs&lt;/td&gt;&lt;td&gt;选项卡（多语言代码对比）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Steps&lt;/td&gt;&lt;td&gt;步骤指南（带时间线）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Accordion&lt;/td&gt;&lt;td&gt;折叠面板（FAQ）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;ComparisonTable&lt;/td&gt;&lt;td&gt;对比表格（✅/❌）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Timeline&lt;/td&gt;&lt;td&gt;时间线&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;FileTree&lt;/td&gt;&lt;td&gt;文件目录树&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Terminal&lt;/td&gt;&lt;td&gt;终端输出&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Kbd&lt;/td&gt;&lt;td&gt;键盘按键&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;GitHubCard&lt;/td&gt;&lt;td&gt;GitHub 仓库卡片&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;BeforeAfter&lt;/td&gt;&lt;td&gt;图片对比滑块&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Chart&lt;/td&gt;&lt;td&gt;SVG 图表&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Video&lt;/td&gt;&lt;td&gt;B 站/YouTube 嵌入&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;MathNumber&lt;/td&gt;&lt;td&gt;公式编号&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3&gt;🔍 Pagefind 全文搜索&lt;a href=&quot;#-pagefind-全文搜索&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这是我最满意的功能之一。Pagefind 在构建时自动索引所有文章内容，支持中文分词，搜索速度极快。&lt;/p&gt;
&lt;h3&gt;📖 阅读体验增强（6 项）&lt;a href=&quot;#-阅读体验增强6-项&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;字体大小控制（S/M/L 三档）&lt;/li&gt;
&lt;li&gt;专注阅读模式（隐藏所有干扰）&lt;/li&gt;
&lt;li&gt;阅读位置记忆（下次打开恢复位置）&lt;/li&gt;
&lt;li&gt;文章语音朗读（Web Speech API）&lt;/li&gt;
&lt;li&gt;文章难度标签&lt;/li&gt;
&lt;li&gt;归档时间线页面&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;🔗 社交分享（7 渠道）&lt;a href=&quot;#-社交分享7-渠道&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;微信（二维码）、QQ、微博、X、Telegram、Reddit、复制链接。移动端优先使用系统原生分享。&lt;/p&gt;
&lt;h3&gt;🎨 视觉与动画&lt;a href=&quot;#-视觉与动画&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;页面切换动画（View Transitions API）&lt;/li&gt;
&lt;li&gt;终端风格 404 页面（打字机效果）&lt;/li&gt;
&lt;li&gt;暗色模式切换动画（圆形扩散）&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;📱 移动端优化&lt;a href=&quot;#-移动端优化&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;左右滑动切换文章&lt;/li&gt;
&lt;li&gt;PWA 安装提示&lt;/li&gt;
&lt;li&gt;下拉刷新动画&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;🔧 其他改进（15+ 项）&lt;a href=&quot;#-其他改进15-项&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;键盘导航 J/K、拼音搜索、KaTeX 公式复制、Mermaid 图表放大、TOC 折叠记忆、文章卡片入场动画、代码块增强（行号/文件名）等等。&lt;/p&gt;
&lt;h2&gt;技术亮点&lt;a href=&quot;#技术亮点&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;Pagefind 全文搜索&lt;a href=&quot;#pagefind-全文搜索&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;Pagefind 的集成非常简单。只需要在 &lt;code&gt;postbuild&lt;/code&gt; 脚本中加一行：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;npx&lt;/span&gt;&lt;span&gt; pagefind&lt;/span&gt;&lt;span&gt; --site&lt;/span&gt;&lt;span&gt; out&lt;/span&gt;&lt;span&gt; --glob&lt;/span&gt;&lt;span&gt; &quot;**/*.html&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;它会自动扫描所有 HTML 页面，生成搜索索引。在文章内容区域加上 &lt;code&gt;data-pagefind-body&lt;/code&gt; 属性，就能精确控制索引范围：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;prose&quot;&lt;/span&gt;&lt;span&gt; data-pagefind-body&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  {&lt;/span&gt;&lt;span&gt;children&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;搜索结果支持中文分词，虽然不支持词干提取（stemming），但对于博客搜索来说完全够用了。&lt;/p&gt;
&lt;h3&gt;MDX 组件示例&lt;a href=&quot;#mdx-组件示例&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;有了这些组件，写技术文章方便多了。比如：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;:::success&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;**&lt;/span&gt;&lt;span&gt;小贴士&lt;/span&gt;&lt;span&gt;**&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;使用 &lt;/span&gt;&lt;span&gt;`&lt;/span&gt;&lt;span&gt;pnpm&lt;/span&gt;&lt;span&gt;`&lt;/span&gt;&lt;span&gt; 比 &lt;/span&gt;&lt;span&gt;`&lt;/span&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt;`&lt;/span&gt;&lt;span&gt; 快很多，而且节省磁盘空间。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;:::&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;Tabs&lt;/span&gt;&lt;span&gt; items&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;[&lt;/span&gt;&lt;span&gt;&apos;pnpm&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; &apos;npm&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; &apos;yarn&apos;&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &amp;lt;&lt;/span&gt;&lt;span&gt;Tab&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;pnpm&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;pnpm install next&lt;/span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Tab&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &amp;lt;&lt;/span&gt;&lt;span&gt;Tab&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;npm&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;npm install next&lt;/span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Tab&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &amp;lt;&lt;/span&gt;&lt;span&gt;Tab&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;yarn&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;yarn add next&lt;/span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Tab&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Tabs&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;Steps&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &amp;lt;&lt;/span&gt;&lt;span&gt;Step&lt;/span&gt;&lt;span&gt; title&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;安装依赖&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;运行 pnpm install&lt;/span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Step&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &amp;lt;&lt;/span&gt;&lt;span&gt;Step&lt;/span&gt;&lt;span&gt; title&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;启动开发&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;运行 pnpm dev&lt;/span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Step&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &amp;lt;&lt;/span&gt;&lt;span&gt;Step&lt;/span&gt;&lt;span&gt; title&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;构建部署&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;运行 pnpm build&lt;/span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Step&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;Steps&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h3&gt;液态玻璃设计统一&lt;a href=&quot;#液态玻璃设计统一&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这次把所有组件都统一到了液态玻璃设计系统。四个层级：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;liquid-glass&lt;/code&gt; — 标准卡片&lt;/li&gt;
&lt;li&gt;&lt;code&gt;liquid-glass-elevated&lt;/code&gt; — 弹出层/模态框&lt;/li&gt;
&lt;li&gt;&lt;code&gt;liquid-glass-subtle&lt;/code&gt; — 次要元素&lt;/li&gt;
&lt;li&gt;&lt;code&gt;liquid-glass-input&lt;/code&gt; — 表单输入&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;所有新组件都遵循这个规范，确保视觉一致性。&lt;/p&gt;
&lt;h3&gt;View Transitions 页面动画&lt;a href=&quot;#view-transitions-页面动画&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;利用浏览器原生的 View Transitions API，实现了页面切换时的平滑过渡。不支持的浏览器会自动降级为普通跳转，不影响功能。&lt;/p&gt;
&lt;h2&gt;遇到的坑&lt;a href=&quot;#遇到的坑&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;1. Cloudflare Pages 不支持原生模块&lt;a href=&quot;#1-cloudflare-pages-不支持原生模块&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;一开始我想用 &lt;code&gt;@xenova/transformers&lt;/code&gt; 在构建时跑本地 AI 模型来做语义搜索。结果发现 CF Pages 的构建环境不支持 &lt;code&gt;onnxruntime-node&lt;/code&gt;（原生 C++ 模块）。&lt;/p&gt;
&lt;p&gt;最后放弃了 AI 方案，改用 Pagefind + 标签权重算法。对于我目前不到 10 篇文章的规模，效果其实差不多。&lt;/p&gt;
&lt;h3&gt;2. Sandpack 加载不稳定&lt;a href=&quot;#2-sandpack-加载不稳定&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;代码块的”Run”按钮用的是 CodeSandbox 的 Sandpack，但不管开不开加速器都经常加载失败，一直转圈。最后决定直接移除这个功能。&lt;/p&gt;
&lt;h3&gt;3. overflow-hidden 阻止图片缩放&lt;a href=&quot;#3-overflow-hidden-阻止图片缩放&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;react-medium-image-zoom&lt;/code&gt; 的放大效果被父容器的 &lt;code&gt;overflow-hidden&lt;/code&gt; 给裁剪了。解决方法很简单——把 &lt;code&gt;overflow-hidden&lt;/code&gt; 去掉就行。&lt;/p&gt;
&lt;h3&gt;4. Safari 隐私模式 localStorage 报错&lt;a href=&quot;#4-safari-隐私模式-localstorage-报错&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;Safari 的隐私浏览模式下，&lt;code&gt;localStorage.setItem()&lt;/code&gt; 会直接抛异常。所有用到 localStorage 的地方都需要 try/catch 包裹。&lt;/p&gt;
&lt;h2&gt;数据统计&lt;a href=&quot;#数据统计&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;指标&lt;/th&gt;&lt;th&gt;数字&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;总改进项&lt;/td&gt;&lt;td&gt;50+&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;新增 MDX 组件&lt;/td&gt;&lt;td&gt;15 个&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Git 提交&lt;/td&gt;&lt;td&gt;9 次&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;涉及文件&lt;/td&gt;&lt;td&gt;70+&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;新增代码行&lt;/td&gt;&lt;td&gt;~3000 行&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;分享渠道&lt;/td&gt;&lt;td&gt;7 个&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2&gt;下一步&lt;a href=&quot;#下一步&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;📝 继续写文章，记录学习和生活&lt;/li&gt;
&lt;li&gt;🎓 准备高考（这才是正事！）&lt;/li&gt;
&lt;li&gt;🔧 根据实际使用情况继续打磨细节&lt;/li&gt;
&lt;li&gt;📊 观察 Pagefind 搜索的实际效果&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;总结&lt;a href=&quot;#总结&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;做博客就像种花——你不能指望种下去第二天就开花，需要持续浇水、施肥、修剪。每次升级都是一次”施肥”，让博客变得更好一点。&lt;/p&gt;
&lt;p&gt;这次 v2.0 升级让我学到了很多：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;不要过度工程化&lt;/strong&gt; — 一开始想用 AI 模型，后来发现简单算法就够用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;用户体验很重要&lt;/strong&gt; — 小细节（如字体控制、位置记忆）能大幅提升阅读感受&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;保持一致性&lt;/strong&gt; — 液态玻璃设计系统让所有组件看起来是一个整体&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;渐进增强&lt;/strong&gt; — 新功能不支持就降级，不影响基本使用&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;好了，该去复习了。高考加油！💪&lt;/p&gt;</content:encoded><category>category:笔记</category><category>category:开发之旅</category><category>tag:技术</category><category>tag:成长</category><category>tag:Next.js</category><category>tag:Cloudflare</category><category>tag:前端</category><category>tag:MDX</category><category>tag:Pagefind</category></item><item><title>从弹幕射击到经典扫雷：纯 JS 游戏开发手记</title><link>https://blog.the37777777.top/post/web-games-dev</link><guid isPermaLink="false">web-games-dev</guid><description>高考前的最后一个项目——用纯 Vanilla JavaScript 做了两款 Web 游戏：一个 11500 行的弹幕射击，一个像素级还原的 Windows 扫雷。零依赖，零框架，从对象池到 BFS 洪水填充，记录一个高中生的游戏开发之旅。</description><pubDate>Sat, 23 May 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;起因&lt;a href=&quot;#起因&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;距离高考还有不到一个月。&lt;/p&gt;
&lt;p&gt;按理说这个时候应该全力冲刺，但说实话，连续刷了几个月的题，脑子有时候真的转不动了。晚自习回来，打开电脑，本来想看看数学错题，结果手不自觉地打开了 VS Code。这种感觉做过博客和 TimeMark 的人应该懂：一旦你习惯了创造东西，就很难停下来。&lt;/p&gt;
&lt;p&gt;做游戏这个念头其实很早就有了。小时候在学校机房玩 4399 上的 Flash 小游戏，那时候就想：这些东西是怎么做出来的？后来学了 JavaScript，发现浏览器本身就是一个游戏引擎。Canvas 能画任何东西，requestAnimationFrame 能跑 60 帧。不需要 Unity，不需要 Godot，一个浏览器就够了。&lt;/p&gt;
&lt;p&gt;还有一个原因。做完博客和 TimeMark 之后，我一直在用框架。Next.js、React、Hono……框架确实好用，但我想证明一件事：&lt;strong&gt;纯 Vanilla JavaScript，不依赖任何框架和库，也能做出复杂的东西。&lt;/strong&gt; 博客是站在巨人肩膀上，TimeMark 是全栈但有框架兜底，这次我想从零开始，自己造所有轮子。&lt;/p&gt;
&lt;p&gt;于是就有了这两个项目。一个大的，一个小的。一个花了两周，一个花了三天。&lt;/p&gt;
&lt;h2&gt;星域战机：一万一千行的弹幕射击&lt;a href=&quot;#星域战机一万一千行的弹幕射击&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;它是什么&lt;a href=&quot;#它是什么&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;星域战机是一个 HTML5 Canvas 弹幕射击游戏（STG）。无尽模式，越打越难，死了重来。&lt;/p&gt;
&lt;p&gt;听起来简单对吧？但内容量比我预想的大得多。最终纯 JavaScript 部分大约一万一千多行，算上 HTML 和 CSS 接近两万行。&lt;/p&gt;
&lt;p&gt;规模有多大？看数据：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;20 个流派&lt;/strong&gt;（相当于角色 build）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;200 个技能&lt;/strong&gt;（每次升级随机三选一）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;20 种武器&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;40 个道具&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;16+ 种敌人&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;4 个 Boss&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这些内容全部是数据驱动的，后面会详细说。&lt;/p&gt;
&lt;p&gt;🎮 在线试玩：&lt;a href=&quot;https://game1.the37777777.top/ulw&quot;&gt;game1.the37777777.top/ulw&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;📦 源码：&lt;a href=&quot;https://github.com/WXFffff666/stg-game&quot;&gt;github.com/WXFffff666/stg-game&lt;/a&gt;&lt;/p&gt;
&lt;h3&gt;数据驱动架构：引擎和内容完全分离&lt;a href=&quot;#数据驱动架构引擎和内容完全分离&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这个项目最让我满意的设计决策是：&lt;strong&gt;引擎只负责执行逻辑，所有内容定义在配置文件里。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;想加一个新流派？往 &lt;code&gt;config.js&lt;/code&gt; 里加一条数据就行，引擎代码一行都不用改。来看看实际的流派配置长什么样：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;FACTIONS&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  attackSpeed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;attackSpeed&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;⚡ 攻速流&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; color&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;#ffdd00&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    description&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;极致射速，弹幕如雨&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    baseStats&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; attackSpeed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.4&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; attack&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.85&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; hp&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 100&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; speed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 300&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; critRate&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.05&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; critMult&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1.5&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; bulletCount&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt; },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    icon&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;⚡&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  counter&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;counter&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;🛡️ 反伤流&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; color&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;#ff6644&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    description&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;挨打反弹，以守为攻&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    baseStats&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; attackSpeed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1.0&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; attack&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.9&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; hp&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 150&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; speed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 260&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; reflectDamage&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.3&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; defense&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.2&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; critRate&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.05&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; critMult&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1.5&lt;/span&gt;&lt;span&gt; },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    icon&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;🛡️&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  crit&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;crit&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;💥 暴击流&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; color&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;#ff0000&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    description&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;一击必杀，刀刀暴击&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    baseStats&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; attackSpeed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1.0&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; attack&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1.2&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; hp&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 90&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; speed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 290&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; critRate&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.25&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; critMult&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 3.0&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; critDamage&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt; },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    icon&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;💥&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  // ... 17 more factions&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;20 个流派，每个都是这样一条配置。攻速流射速快但攻击力低，反伤流血厚能反弹伤害，暴击流脆皮但爆发高。引擎不关心具体有多少流派，它只读取 &lt;code&gt;baseStats&lt;/code&gt; 然后计算。&lt;/p&gt;
&lt;p&gt;技能也是同样的思路。每个技能就是一个纯数据对象：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;atk_up_1&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;攻击提升 I&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; faction&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;any&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; type&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;passive&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; rarity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;common&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  effects&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; stat&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;attack&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; op&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;multiply&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.15&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;span&gt;] &lt;/span&gt;&lt;span&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;bullet_plus_1&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;弹道+1&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; faction&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;any&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; type&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;passive&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; rarity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;uncommon&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  effects&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; stat&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;bulletCount&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; op&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;add&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;span&gt;] &lt;/span&gt;&lt;span&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;crit_up_2&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;暴击率提升 II&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; faction&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;any&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; type&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;passive&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; rarity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;uncommon&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  effects&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; stat&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;critRate&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; op&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;add&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.15&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;span&gt;] &lt;/span&gt;&lt;span&gt;},&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;看到没？&lt;code&gt;effects&lt;/code&gt; 数组里定义了这个技能修改哪个属性、用什么运算、改多少。引擎只需要遍历 effects，根据 &lt;code&gt;op&lt;/code&gt; 字段做加法或乘法就行。200 个技能，引擎处理逻辑就那么几行，剩下的全是数据。&lt;/p&gt;
&lt;p&gt;这种架构的好处是：&lt;strong&gt;加内容的速度极快。&lt;/strong&gt; 一旦引擎稳定了，后面就是纯粹的内容创作。我后期加技能的速度大概是一小时 5、6 个，因为不需要碰引擎代码。&lt;/p&gt;
&lt;p&gt;每个流派还有自己的终极技能，定义在 &lt;code&gt;skills.js&lt;/code&gt; 里：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; FACTION_SYSTEM &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  attackSpeed&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    corePassive&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; effects&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; stat&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;attackSpeed&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; op&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;multiply&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; -&lt;/span&gt;&lt;span&gt;0.15&lt;/span&gt;&lt;span&gt; },&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; stat&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;attack&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; op&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;multiply&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0.1&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;span&gt;] &lt;/span&gt;&lt;span&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    exclusiveSkills&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;span&gt;&apos;as_dual_wield&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; &apos;as_frenzy&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; &apos;as_machine_gun&apos;&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ultimate&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;ut_attackSpeed&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;⚡ 弹幕终结&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; faction&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;attackSpeed&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; type&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;passive&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; rarity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;legendary&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; ultimate&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; true&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      description&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;极致攻速的终极形态&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      effects&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; stat&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;attackSpeed&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; op&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;multiply&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; -&lt;/span&gt;&lt;span&gt;0.5&lt;/span&gt;&lt;span&gt; },&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; stat&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;ricochet&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; op&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;add&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; value&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 3&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      visualColor&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;#ffdd00&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; visualType&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;lightning&apos;&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  // ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;};&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;攻速流的终极技能「弹幕终结」：攻速再乘以 -0.5（注意这里 attackSpeed 的值越小射速越快），子弹还能弹射 3 次。配合前面基础属性里 &lt;code&gt;attackSpeed: 0.4&lt;/code&gt; 的底子，这个流派到后期就是满屏子弹乱飞。&lt;/p&gt;
&lt;h3&gt;对象池：零 GC 压力&lt;a href=&quot;#对象池零-gc-压力&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;弹幕射击游戏最大的性能瓶颈是什么？垃圾回收（GC）。&lt;/p&gt;
&lt;p&gt;想象一下：屏幕上同时有几百颗子弹在飞，每颗子弹飞出屏幕就销毁，新子弹不断创建。如果每颗子弹都 &lt;code&gt;new Bullet()&lt;/code&gt;，GC 会疯掉，游戏会卡顿。&lt;/p&gt;
&lt;p&gt;我写了一个通用的对象池类来解决这个问题：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;class&lt;/span&gt;&lt;span&gt; ObjectPool&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  constructor&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;factory&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; initialSize&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; []&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_factory &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; factory&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; (initialSize &lt;/span&gt;&lt;span&gt;||&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;factory&lt;/span&gt;&lt;span&gt;())&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  get&lt;/span&gt;&lt;span&gt; length&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; return&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;length&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  pop&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    if&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;length &lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      return&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;pop&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    return&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_factory&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;obj&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_items&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(obj)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;原理很简单：构造的时候传入一个工厂函数和初始大小，预先创建一批对象放进池子。需要新对象的时候调 &lt;code&gt;pop()&lt;/code&gt;，池子里有就直接拿，没有才用工厂函数创建新的。对象「死亡」后调 &lt;code&gt;push()&lt;/code&gt; 放回池子。整个游戏运行过程中，&lt;code&gt;new&lt;/code&gt; 操作只在最开始发生几次，之后全部是复用。&lt;/p&gt;
&lt;p&gt;子弹、粒子、敌人、伤害数字……所有频繁创建销毁的对象都用了对象池。实测下来，即使屏幕上有 300+ 子弹同时飞行，帧率也能稳定在 60fps。&lt;/p&gt;
&lt;h3&gt;踩坑：游戏循环与 Spiral of Death&lt;a href=&quot;#踩坑游戏循环与-spiral-of-death&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;游戏的心跳是 &lt;code&gt;requestAnimationFrame&lt;/code&gt; + deltaTime。但这里有个坑，我一开始没注意到，后来被坑了一整个晚上。&lt;/p&gt;
&lt;p&gt;先看最终的代码：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// Inside Game class _loop method:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; rawDt &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; timestamp &lt;/span&gt;&lt;span&gt;-&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;lastTime&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;lastTime &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; timestamp&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// Cap delta time to prevent spiral of death&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; dt &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; Math&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;min&lt;/span&gt;&lt;span&gt;(rawDt&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 50&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;*&lt;/span&gt;&lt;span&gt; 0.001&lt;/span&gt;&lt;span&gt; *&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;timeScale&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;if&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;!&lt;/span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;isPaused) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;gameTime &lt;/span&gt;&lt;span&gt;+=&lt;/span&gt;&lt;span&gt; rawDt&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_update&lt;/span&gt;&lt;span&gt;(dt)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_draw&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;rafId &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; requestAnimationFrame&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_loop)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;看到那行 &lt;code&gt;Math.min(rawDt, 50)&lt;/code&gt; 了吗？这是为了防止所谓的「spiral of death」（死亡螺旋）。&lt;/p&gt;
&lt;p&gt;什么意思呢？假设某一帧因为 GC 或者其他原因卡了 500ms，如果不做限制，deltaTime 就是 0.5 秒。这一帧里所有物体都会移动半秒的距离，子弹可能直接穿过敌人，碰撞检测全部失效。更糟糕的是，这一帧要处理的计算量暴增，导致下一帧也卡，deltaTime 更大，计算量更多……恶性循环，游戏直接崩掉。&lt;/p&gt;
&lt;p&gt;解决方案就是给 deltaTime 加个上限。超过 50ms（相当于 20fps 以下）的帧，一律按 50ms 算。游戏可能会短暂变慢，但不会崩。&lt;/p&gt;
&lt;p&gt;这个 bug 的现象是：切到其他标签页再切回来，游戏里所有东西瞬间飞出屏幕。当时我完全懵了，以为是碰撞检测的问题，排查了半天。后来才想明白，浏览器在后台标签页会暂停 requestAnimationFrame，切回来的时候 deltaTime 直接飙到几秒。加了这个 cap 之后就好了。&lt;/p&gt;
&lt;p&gt;注释里写的 “prevent spiral of death” 就是那天晚上加的，算是给自己留个纪念。&lt;/p&gt;
&lt;h3&gt;程序化音效：零音频文件&lt;a href=&quot;#程序化音效零音频文件&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;整个游戏没有一个音频文件。所有音效都是用 Web Audio API 实时合成的：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// Shoot sound: short square wave decay&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;playShoot&lt;/span&gt;&lt;span&gt;() &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_playTone&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;square&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 800&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 400&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0.05&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0.08&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// Explosion: noise burst with lowpass filter&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;playExplosion&lt;/span&gt;&lt;span&gt;() &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_playNoise&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;0.2&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0.12&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 1000&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// Core tone generator&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;_playTone&lt;/span&gt;&lt;span&gt;(type&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; startFreq&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; endFreq&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; duration&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; vol) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_ensureContext&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  if&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_muted) &lt;/span&gt;&lt;span&gt;return&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  const&lt;/span&gt;&lt;span&gt; ctx &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_ctx&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  const&lt;/span&gt;&lt;span&gt; now &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; ctx&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;currentTime&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  const&lt;/span&gt;&lt;span&gt; osc &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; ctx&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;createOscillator&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  const&lt;/span&gt;&lt;span&gt; gain &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; ctx&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;createGain&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  osc&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;type &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; type&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  osc&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;frequency&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;setValueAtTime&lt;/span&gt;&lt;span&gt;(Math&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;max&lt;/span&gt;&lt;span&gt;(startFreq&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0.01&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; now)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  osc&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;frequency&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;exponentialRampToValueAtTime&lt;/span&gt;&lt;span&gt;(Math&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;max&lt;/span&gt;&lt;span&gt;(endFreq&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0.01&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; now &lt;/span&gt;&lt;span&gt;+&lt;/span&gt;&lt;span&gt; duration)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gain&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;gain&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;setValueAtTime&lt;/span&gt;&lt;span&gt;(vol&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; now)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gain&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;gain&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;exponentialRampToValueAtTime&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;0.001&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; now &lt;/span&gt;&lt;span&gt;+&lt;/span&gt;&lt;span&gt; duration)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  osc&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;connect&lt;/span&gt;&lt;span&gt;(gain)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gain&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;connect&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;this&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;_masterGain)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  osc&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;start&lt;/span&gt;&lt;span&gt;(now)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  osc&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;stop&lt;/span&gt;&lt;span&gt;(now &lt;/span&gt;&lt;span&gt;+&lt;/span&gt;&lt;span&gt; duration &lt;/span&gt;&lt;span&gt;+&lt;/span&gt;&lt;span&gt; 0.01&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;射击声是一段 800Hz 到 400Hz 的方波快速衰减，持续 0.05 秒。爆炸声是白噪声加 1000Hz 低通滤波器。升级音效是两个正弦波的快速上行。听起来很 retro，但和像素风的画面很搭。&lt;/p&gt;
&lt;p&gt;好处是显而易见的：零网络请求，零加载时间，包体积极小。坏处是调音效全靠耳朵，没有可视化工具，改一个参数就要重新听一遍。&lt;code&gt;playShoot&lt;/code&gt; 那个 0.05 秒的持续时间我调了十几次才觉得「对味」。0.03 太短听不清，0.08 又太拖沓，最后定在 0.05。&lt;/p&gt;
&lt;p&gt;还有个坑：&lt;code&gt;exponentialRampToValueAtTime&lt;/code&gt; 不能 ramp 到 0，只能 ramp 到一个接近 0 的值（我用的 0.001）。一开始写的是 ramp 到 0，浏览器直接报错，查了半天 MDN 才发现这个限制。指数衰减嘛，数学上不可能到 0，想想也合理。&lt;/p&gt;
&lt;h3&gt;最大的挑战：200 个技能的平衡性&lt;a href=&quot;#最大的挑战200-个技能的平衡性&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;200 个技能，怎么保证不会出现某个组合过于逆天？&lt;/p&gt;
&lt;p&gt;说实话，保证不了。😅&lt;/p&gt;
&lt;p&gt;我的做法是分层：技能分 common、uncommon、rare、legendary 四个稀有度，高稀有度出现概率低。同一流派的技能之间有协同效果，但不同流派混搭也不会太弱。然后就是大量的自己试玩，发现太强的就削一刀，太弱的就加强。&lt;/p&gt;
&lt;p&gt;比如攻速流一开始太强了。基础 &lt;code&gt;attackSpeed: 0.4&lt;/code&gt; 加上终极技能再乘 -0.5，配合「弹道+1」技能多发子弹，屏幕上全是子弹，Boss 秒融。后来我把终极技能的弹射次数从 5 降到 3，才算平衡了一点。&lt;/p&gt;
&lt;p&gt;这个过程其实挺像做数学题的：调参数、验证、再调。只不过验证的方式是打一局游戏而不是算一道题。&lt;/p&gt;
&lt;h2&gt;经典扫雷：三天的像素级还原&lt;a href=&quot;#经典扫雷三天的像素级还原&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;它是什么&lt;a href=&quot;#它是什么-1&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;做完星域战机之后，我想做个小的项目换换脑子。扫雷是我小时候在 Windows XP 上玩得最多的游戏之一，规则简单，但实现起来有不少细节。&lt;/p&gt;
&lt;p&gt;目标很明确：&lt;strong&gt;像素级还原 Windows XP/7 的扫雷体验。&lt;/strong&gt; 不是「类似扫雷」，是打开之后让人觉得「这就是那个扫雷」。&lt;/p&gt;
&lt;p&gt;最终成品大约 2800 行代码，支持 PWA 离线游玩。&lt;/p&gt;
&lt;p&gt;🎮 在线试玩：&lt;a href=&quot;https://game2.the37777777.top/&quot;&gt;game2.the37777777.top&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;📦 源码：&lt;a href=&quot;https://github.com/WXFffff666/minesweeper&quot;&gt;github.com/WXFffff666/minesweeper&lt;/a&gt;&lt;/p&gt;
&lt;h3&gt;功能清单&lt;a href=&quot;#功能清单&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;别看扫雷「简单」，要做到完整还是有不少东西的：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;3D 凸起/凹陷边框（经典 Windows 风格）&lt;/li&gt;
&lt;li&gt;LED 数字计数器（剩余雷数 + 计时器）&lt;/li&gt;
&lt;li&gt;左右键同时按的 chord click（双击翻开周围）&lt;/li&gt;
&lt;li&gt;第一次点击保证安全（不会踩雷）&lt;/li&gt;
&lt;li&gt;BFS 洪水填充（点到空白区域自动展开）&lt;/li&gt;
&lt;li&gt;无尽模式（通关后自动开下一局）&lt;/li&gt;
&lt;li&gt;12 个成就&lt;/li&gt;
&lt;li&gt;3 套主题（经典、暗色、现代）&lt;/li&gt;
&lt;li&gt;统计数据和排行榜&lt;/li&gt;
&lt;li&gt;PWA 离线支持&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;模块模式架构&lt;a href=&quot;#模块模式架构&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;扫雷的代码结构比星域战机清晰得多（毕竟规模小很多）。我用了 IIFE 模块模式，把逻辑拆成独立模块。来看看渲染模块的实际代码：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;MS&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;Renderer &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;function&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &apos;use strict&apos;&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; boardEl &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; document&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;querySelector&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;.board&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; mineCounterEl &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; document&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;querySelector&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;.mine-counter&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; timerEl &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; document&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;querySelector&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;.timer&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; smileyBtn &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; document&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;querySelector&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;.smiley-btn&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; currentCols &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    function&lt;/span&gt;&lt;span&gt; createBoard&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;rows&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; cols&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        currentCols &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; cols&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        boardEl&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;innerHTML &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; &apos;&apos;&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        boardEl&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;style&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;setProperty&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;--cols&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; cols)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        var&lt;/span&gt;&lt;span&gt; fragment &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; document&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;createDocumentFragment&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; r &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; r &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; rows&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; r&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; cols&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; c&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                var&lt;/span&gt;&lt;span&gt; cell &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; document&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;createElement&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;div&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                cell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;className &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; &apos;cell&apos;&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                cell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;dataset&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;row &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; r&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                cell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;dataset&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;col &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; c&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                fragment&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;appendChild&lt;/span&gt;&lt;span&gt;(cell)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        boardEl&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;appendChild&lt;/span&gt;&lt;span&gt;(fragment)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    // ... more methods ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    return&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;span&gt; createBoard&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; createBoard&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; updateCell&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; updateCell&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; ...&lt;/span&gt;&lt;span&gt; };&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;)()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;每个模块是一个 IIFE，内部变量完全私有，只通过 return 暴露公共接口。&lt;code&gt;MS.Engine&lt;/code&gt; 负责游戏逻辑，&lt;code&gt;MS.Renderer&lt;/code&gt; 负责渲染，&lt;code&gt;MS.Input&lt;/code&gt; 负责输入处理，&lt;code&gt;MS.Audio&lt;/code&gt; 负责音效，&lt;code&gt;MS.Stats&lt;/code&gt; 负责统计和成就。&lt;/p&gt;
&lt;p&gt;纯逻辑和渲染完全分离。&lt;code&gt;MS.Engine&lt;/code&gt; 不知道自己被画在哪里，&lt;code&gt;MS.Renderer&lt;/code&gt; 不关心游戏规则。如果以后想换一套 UI（比如从 DOM 换成 Canvas），只需要重写 &lt;code&gt;MS.Renderer&lt;/code&gt;，其他模块一行不动。&lt;/p&gt;
&lt;p&gt;注意 &lt;code&gt;createBoard&lt;/code&gt; 里用了 &lt;code&gt;document.createDocumentFragment()&lt;/code&gt;。如果直接在循环里 &lt;code&gt;appendChild&lt;/code&gt; 到 DOM，每次都会触发重排。用 fragment 先在内存里拼好，最后一次性插入，性能差距在大棋盘（30x16 = 480 个格子）上很明显。&lt;/p&gt;
&lt;h3&gt;BFS 洪水填充&lt;a href=&quot;#bfs-洪水填充&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;扫雷里点到一个周围没有雷的空白格子，会自动展开一大片区域。这个功能的实现是经典的 BFS（广度优先搜索）。来看实际代码：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;function&lt;/span&gt;&lt;span&gt; floodFill&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;startRow&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; startCol&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; queue &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; []&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; revealed &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; []&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    queue&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; row&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; startRow&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; col&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; startCol &lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    while&lt;/span&gt;&lt;span&gt; (queue&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;length &lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        var&lt;/span&gt;&lt;span&gt; cell &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; queue&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;shift&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        var&lt;/span&gt;&lt;span&gt; r &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; cell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;row&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        var&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; cell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;col&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        var&lt;/span&gt;&lt;span&gt; boardCell &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; board[r][c]&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        if&lt;/span&gt;&lt;span&gt; (boardCell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;revealed &lt;/span&gt;&lt;span&gt;||&lt;/span&gt;&lt;span&gt; boardCell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;flagged) &lt;/span&gt;&lt;span&gt;continue&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        boardCell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;revealed &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; true&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        revealedCount&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        revealed&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; row&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; r&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; col&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        if&lt;/span&gt;&lt;span&gt; (boardCell&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;adjacentMines &lt;/span&gt;&lt;span&gt;===&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            var&lt;/span&gt;&lt;span&gt; neighbors &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; getNeighbors&lt;/span&gt;&lt;span&gt;(r&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; c)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; neighbors&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;length&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                var&lt;/span&gt;&lt;span&gt; nr &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; neighbors[i]&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;row&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                var&lt;/span&gt;&lt;span&gt; nc &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; neighbors[i]&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;col&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                if&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;!&lt;/span&gt;&lt;span&gt;board[nr][nc]&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;revealed &lt;/span&gt;&lt;span&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span&gt; !&lt;/span&gt;&lt;span&gt;board[nr][nc]&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;flagged) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                    queue&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; row&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; nr&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; col&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; nc &lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    return&lt;/span&gt;&lt;span&gt; revealed&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;为什么用迭代 BFS 而不是递归 DFS？因为大棋盘（比如 30x16）上，递归深度可能超过浏览器的调用栈限制，直接 stack overflow。迭代版本用一个队列，不管棋盘多大都不会爆栈。&lt;/p&gt;
&lt;p&gt;注意这里的逻辑：只有 &lt;code&gt;adjacentMines === 0&lt;/code&gt; 的格子才会继续扩展邻居。如果一个格子周围有雷（数字不为 0），它会被翻开但不会继续往外扩。这就是为什么 BFS 展开后边缘总是一圈数字。&lt;/p&gt;
&lt;p&gt;函数返回所有被翻开的格子坐标，渲染模块拿到这个数组后批量更新 DOM。逻辑和渲染分离的好处在这里就体现出来了。&lt;/p&gt;
&lt;p&gt;这也是算法课上学的东西第一次在实际项目里派上用场。真的挺有成就感的。&lt;/p&gt;
&lt;h3&gt;踩坑：第一次点击保证安全&lt;a href=&quot;#踩坑第一次点击保证安全&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;扫雷有个规则很多人不知道：第一次点击永远不会踩雷。Windows 原版就是这样的。&lt;/p&gt;
&lt;p&gt;实现方式是：&lt;strong&gt;雷不是游戏开始时就放好的，而是第一次点击之后才放。&lt;/strong&gt; 放雷的时候排除掉点击位置周围 3x3 的区域：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;function&lt;/span&gt;&lt;span&gt; placeMines&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;safeRow&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; safeCol&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; positions &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; []&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; r &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; r &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; rows&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; r&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; cols&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; c&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            // Exclude 3x3 area around safe cell&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            if&lt;/span&gt;&lt;span&gt; (Math&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;abs&lt;/span&gt;&lt;span&gt;(r &lt;/span&gt;&lt;span&gt;-&lt;/span&gt;&lt;span&gt; safeRow) &lt;/span&gt;&lt;span&gt;&amp;lt;=&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span&gt; Math&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;abs&lt;/span&gt;&lt;span&gt;(c &lt;/span&gt;&lt;span&gt;-&lt;/span&gt;&lt;span&gt; safeCol) &lt;/span&gt;&lt;span&gt;&amp;lt;=&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                continue&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            positions&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;push&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt; row&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; r&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; col&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    shuffle&lt;/span&gt;&lt;span&gt;(positions)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    var&lt;/span&gt;&lt;span&gt; minesToPlace &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; Math&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;min&lt;/span&gt;&lt;span&gt;(totalMines&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; positions&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;length)&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    for&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;var&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; minesToPlace&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;span&gt; i&lt;/span&gt;&lt;span&gt;++&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        board[positions[i]&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;row][positions[i]&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;col]&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;mine &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; true&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;先收集所有「可以放雷」的位置（排除安全区），然后 shuffle 打乱，取前 N 个放雷。&lt;/p&gt;
&lt;p&gt;这里有个边界情况我一开始没想到：&lt;code&gt;Math.min(totalMines, positions.length)&lt;/code&gt; 这行。如果棋盘太小、雷太多，排除了 3x3 安全区之后可放的位置不够怎么办？比如 5x5 的棋盘放 20 颗雷，排除 9 个安全格后只剩 16 个位置。没有这个 &lt;code&gt;Math.min&lt;/code&gt; 的话，数组越界直接报错。虽然正常游戏不太会出现这种情况，但自定义难度的时候用户什么参数都可能填。&lt;/p&gt;
&lt;p&gt;还有个细节：排除的是 3x3 区域而不是单个格子。为什么？因为如果只排除点击的那一个格子，第一次点击虽然不会死，但可能翻开一个数字 8（周围全是雷），体验很差。排除 3x3 保证第一次点击至少能展开一小片区域，给玩家一个好的开局。&lt;/p&gt;
&lt;h3&gt;像素级还原的 CSS 挑战&lt;a href=&quot;#像素级还原的-css-挑战&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;Windows XP 扫雷那个经典的 3D 外观，全靠 CSS 实现：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;cell-raised&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-top&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 2&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;fff&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-left&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 2&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;fff&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-bottom&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 2&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;808080&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-right&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 2&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;808080&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;cell-sunken&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-top&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;808080&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-left&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;808080&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-bottom&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;fff&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  border-right&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt; solid &lt;/span&gt;&lt;span&gt;#&lt;/span&gt;&lt;span&gt;fff&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;上边和左边用亮色，下边和右边用暗色，就能模拟出光照从左上方打过来的 3D 效果。翻开的格子反过来，就是凹陷的效果。注意凸起是 2px 边框，凹陷是 1px，这个细节也是对着原版截图一点点调出来的。&lt;/p&gt;
&lt;p&gt;LED 数字显示器也是纯 CSS 画的，用七段数码管的方式拼出 0-9。计时器和雷数计数器都用这个组件。&lt;/p&gt;
&lt;p&gt;说起来简单，但调到「看起来对」花了不少时间。我对着 Windows XP 虚拟机的截图一个像素一个像素地比对，调颜色、调边框宽度、调间距。强迫症发作的时候真的停不下来。&lt;/p&gt;
&lt;h3&gt;PWA 离线支持&lt;a href=&quot;#pwa-离线支持&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;扫雷这种游戏太适合做 PWA 了。断网环境下也能玩，安装到手机桌面之后和原生 App 体验一模一样。&lt;/p&gt;
&lt;p&gt;Service Worker 缓存了所有静态资源，第一次加载之后就完全不需要网络了。加上整个游戏零外部依赖，离线体验和在线完全一致。&lt;/p&gt;
&lt;h2&gt;技术对比&lt;a href=&quot;#技术对比&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;两个项目放在一起看，差异还挺大的：&lt;/p&gt;


















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;星域战机&lt;/th&gt;&lt;th&gt;经典扫雷&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;代码量&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;~20000 行&lt;/td&gt;&lt;td&gt;~2800 行&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;渲染方式&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Canvas 2D&lt;/td&gt;&lt;td&gt;DOM&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;架构&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;数据驱动 + 对象池&lt;/td&gt;&lt;td&gt;模块模式 + MVC&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;音效&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Web Audio 程序化&lt;/td&gt;&lt;td&gt;Web Audio 程序化&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;离线&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Service Worker&lt;/td&gt;&lt;td&gt;PWA + Service Worker&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;开发周期&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;~2 周&lt;/td&gt;&lt;td&gt;~3 天&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;输入&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;键盘 + 鼠标&lt;/td&gt;&lt;td&gt;鼠标 + 触屏&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;状态管理&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;全局 Game 对象&lt;/td&gt;&lt;td&gt;模块内部状态&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;星域战机是「大而全」，什么都自己造轮子；扫雷是「小而精」，在有限的规模里把每个细节打磨到位。两种开发体验都很有意思。&lt;/p&gt;
&lt;h2&gt;共同的设计哲学&lt;a href=&quot;#共同的设计哲学&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;虽然两个项目规模差很多，但有几个原则是一致的：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;零依赖。&lt;/strong&gt; 没有 React，没有 Vue，没有 jQuery，没有任何 npm 包。所有代码都是从零写的。这不是为了装逼，是为了学习。用框架的时候，很多底层细节被封装掉了，你不知道 Canvas 怎么画一个圆，不知道事件委托怎么实现，不知道音频合成的原理。自己写一遍，这些东西就真的变成你的了。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;数据驱动。&lt;/strong&gt; 星域战机的技能配置是数据驱动，扫雷的主题和成就也是数据驱动。把「是什么」和「怎么做」分开，代码会清晰很多。加内容不需要改逻辑，改逻辑不会破坏内容。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;程序化音效。&lt;/strong&gt; 两个游戏都没有音频文件，全部用 Web Audio API 实时合成。省带宽，省加载时间，而且可以动态调整参数（比如根据连击数改变音调）。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;渐进增强。&lt;/strong&gt; 核心功能不依赖任何高级 API。Web Audio 不支持？静音也能玩。Service Worker 不支持？在线也能玩。触屏设备？也做了适配。不会因为某个 API 不可用就整个游戏崩掉。&lt;/p&gt;
&lt;h2&gt;写在最后&lt;a href=&quot;#写在最后&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;这两个游戏是在备考间隙做的。晚上回来，刷完当天的任务，如果还有精力，就写一会儿代码。有时候是半小时，有时候是两小时。星域战机断断续续写了两周，扫雷集中三天搞定。&lt;/p&gt;
&lt;p&gt;对我来说，写代码是一种很好的减压方式。和刷题不同，写代码的时候你在创造东西，看着一个游戏从空白画布变成能玩的成品，那种成就感是做对一道数学题给不了的。&lt;/p&gt;
&lt;p&gt;回头看这一年多的项目：博客让我入了前端的门，TimeMark 让我理解了全栈和 Docker，这两个游戏让我真正掌握了 Vanilla JS 的底层能力。每个项目都在前一个的基础上往前走了一步。&lt;/p&gt;
&lt;p&gt;高考之后，我想试试用真正的游戏引擎做点东西。Godot 或者 Unity，做一个有完整剧情的小游戏。也可能会继续用 Web 技术，毕竟浏览器的能力还远没被我榨干。&lt;/p&gt;
&lt;p&gt;不管怎样，这两个项目算是高中阶段的一个句号。&lt;/p&gt;
&lt;p&gt;好了，该去背英语了。&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;&lt;strong&gt;试玩链接：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;星域战机：&lt;a href=&quot;https://game1.the37777777.top/ulw&quot;&gt;game1.the37777777.top/ulw&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;经典扫雷：&lt;a href=&quot;https://game2.the37777777.top/&quot;&gt;game2.the37777777.top&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content:encoded><category>category:笔记</category><category>category:开发之旅</category><category>tag:JavaScript</category><category>tag:Canvas</category><category>tag:Game Dev</category><category>tag:前端</category><category>tag:PWA</category></item><item><title>TimeMark：我的第一个 Docker 项目</title><link>https://blog.the37777777.top/post/timemark-docker</link><guid isPermaLink="false">timemark-docker</guid><description>从三容器到单容器，从 800MB 到 256MB —— 一个高中生独立开发的智能生日提醒系统。支持农历、38+ 通知渠道、一键部署到 NAS。</description><pubDate>Sun, 19 Apr 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;起因&lt;a href=&quot;#起因&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;去年过年的时候，我忘了给一个长辈发生日祝福。不是不想发，是真的忘了。我妈提醒我的时候已经过了两天，场面一度很尴尬。&lt;/p&gt;
&lt;p&gt;后来我想，能不能做个工具自动提醒我？上网搜了一圈，发现要么是手机日历（不支持农历），要么是付费 App（一年几十块），要么是那种企业级的日程管理系统（杀鸡用牛刀）。我家里有台 NAS，跑着飞牛 OS，上面已经有好几个 Docker 容器了。如果能做一个 Docker 应用，一键部署到 NAS 上，岂不是完美？&lt;/p&gt;
&lt;p&gt;就这样，TimeMark 诞生了。这是我做完博客之后的第二个项目，也是我第一次接触 Docker 开发。&lt;/p&gt;
&lt;h2&gt;TimeMark 是什么&lt;a href=&quot;#timemark-是什么&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;简单说，TimeMark 是一个智能事件提醒系统。你把家人朋友的生日、纪念日录进去，它会在指定时间通过微信、QQ、钉钉、飞书、邮件、Bark 等渠道自动发通知给你。&lt;/p&gt;
&lt;p&gt;听起来不复杂对吧？但有几个点让它变得有意思：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;农历支持&lt;/strong&gt;。我奶奶的生日是农历的，每年对应的公历日期都不一样，还要处理闰月的情况。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;NAS 友好&lt;/strong&gt;。专门为家用 NAS 设计，J4125、N5105 这种低功耗处理器也能跑。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;一键部署&lt;/strong&gt;。三行命令搞定，不需要懂代码。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;目前支持飞牛 OS、群晖、威联通、铁威马这几个主流 NAS 系统。&lt;/p&gt;
&lt;h2&gt;技术选型：为什么选这些&lt;a href=&quot;#技术选型为什么选这些&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;做博客的时候我用了 Next.js + Tailwind CSS，算是入了前端的门。TimeMark 是全栈项目，前后端都要写，所以技术选型花了不少心思。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;后端框架选了 Hono。&lt;/strong&gt; 那段时间刷 GitHub Trending，发现 Hono 经常上榜。点进去一看：轻量、快、TypeScript 原生支持、API 设计很优雅。试了一下，确实比 Express 写起来舒服。而且 Hono 的中间件机制很灵活，做鉴权、日志这些很方便。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;数据库选了 sql.js（SQLite）。&lt;/strong&gt; 这个选择其实是踩了坑之后才做的，后面会讲。最终选 sql.js 的原因很简单：零依赖，数据就是一个文件，NAS 用户备份的时候直接拷贝就行。做博客的时候我就学到了一个道理：能简单就别复杂。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;前端还是 React + TailwindCSS。&lt;/strong&gt; 熟悉嘛，博客项目打下的基础直接用上了。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;项目结构用了 pnpm workspace monorepo。&lt;/strong&gt; 前端和后端放在一个仓库里，共享 TypeScript 类型定义。比如一个 &lt;code&gt;Event&lt;/code&gt; 类型，前端后端用的是同一份定义，改一处两边都生效。类型安全这东西，用过就回不去了。&lt;/p&gt;
&lt;p&gt;架构设计参考了不少开源项目，Docker 最佳实践也翻了官方文档好几遍。&lt;/p&gt;
&lt;h2&gt;架构演进：从过度设计到大道至简&lt;a href=&quot;#架构演进从过度设计到大道至简&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;v1.x 时代：三个容器的「豪华配置」&lt;a href=&quot;#v1x-时代三个容器的豪华配置&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;第一版的 TimeMark，我用了 PostgreSQL 做数据库，Redis + Bull 做任务队列，加上应用本身，一共三个 Docker 容器。&lt;/p&gt;
&lt;p&gt;为什么这么设计？因为我看的教程和开源项目都是这么搞的。PostgreSQL 是「正经」数据库，Redis 做缓存和消息队列是「业界标准」，Bull 是 Node.js 生态里最流行的任务调度库。一切看起来都很「专业」。&lt;/p&gt;
&lt;p&gt;然后 NAS 用户开始反馈了。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“这玩意吃了我 800MB 内存，我 NAS 一共才 4GB。”
“J4125 跑你这个 CPU 占用 30%，我还跑着其他服务呢。”
“就一个提醒工具，为什么要装 PostgreSQL？”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;说实话，他们说得对。一个生日提醒系统，数据量撑死几百条，用 PostgreSQL 确实是大炮打蚊子。Redis 就更离谱了，我用它只是为了跑定时任务，完全可以用更轻量的方案替代。&lt;/p&gt;
&lt;h3&gt;v2.0 重写：砍掉一切不必要的&lt;a href=&quot;#v20-重写砍掉一切不必要的&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;想明白之后，我花了两周重写了整个后端：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;PostgreSQL → sql.js&lt;/strong&gt;。SQLite 跑在 WASM 里，不需要单独的数据库容器。数据就是一个 &lt;code&gt;.db&lt;/code&gt; 文件。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Redis + Bull → Croner&lt;/strong&gt;。Croner 是一个纯 JavaScript 的 cron 调度器，几十 KB 大小，功能完全够用。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;三容器 → 单容器&lt;/strong&gt;。只需要一个 Docker 容器，内存占用从 800MB 降到 256MB，减少了 70%。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这次重写让我真正理解了一句话：&lt;strong&gt;不要为了用技术而用技术。&lt;/strong&gt; 选型的时候应该先想清楚需求是什么，而不是什么流行就用什么。一个面向家庭用户的小工具，简单可靠比「架构优雅」重要一万倍。&lt;/p&gt;
&lt;h2&gt;踩过的坑&lt;a href=&quot;#踩过的坑&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;做这个项目踩的坑比做博客多得多。挑几个印象最深的说说。&lt;/p&gt;
&lt;h3&gt;Docker Hub 用户名：连改了 6 次&lt;a href=&quot;#docker-hub-用户名连改了-6-次&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;第一次往 Docker Hub 发布镜像，我以为随便填个用户名就行。结果 push 的时候一直报错，说找不到仓库。&lt;/p&gt;
&lt;p&gt;折腾了半天才搞明白：Docker Hub 的镜像名格式是 &lt;code&gt;用户名/镜像名&lt;/code&gt;，这个用户名必须和你的 Docker Hub 账号完全一致。我一开始注册的时候手滑打错了，后来又改了好几次。翻 git log 能看到连续 6 个 commit 都在改这个用户名：&lt;code&gt;wfffff666&lt;/code&gt;、&lt;code&gt;xxxxxf666&lt;/code&gt;、&lt;code&gt;xfffff666&lt;/code&gt;……&lt;/p&gt;
&lt;p&gt;现在回头看那段 git 历史，挺好笑的。但当时真的很崩溃，因为 CI/CD 流水线一直跑不通，每次改完都要等 GitHub Actions 重新构建。&lt;/p&gt;
&lt;p&gt;最终确定的镜像地址是 &lt;code&gt;xfffff666/timemark:latest&lt;/code&gt;。&lt;/p&gt;
&lt;h3&gt;SQL 方言不兼容：PostgreSQL 到 SQLite 的迁移噩梦&lt;a href=&quot;#sql-方言不兼容postgresql-到-sqlite-的迁移噩梦&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;v2.0 把数据库从 PostgreSQL 换成 sql.js 的时候，我天真地以为改个连接字符串就行了。&lt;/p&gt;
&lt;p&gt;大错特错。&lt;/p&gt;
&lt;p&gt;PostgreSQL 和 SQLite 的 SQL 方言差异比我想象的大得多。&lt;code&gt;TO_CHAR()&lt;/code&gt; 函数在 SQLite 里根本不存在，日期格式化要用 &lt;code&gt;strftime()&lt;/code&gt;。PostgreSQL 的布尔值是 &lt;code&gt;true/false&lt;/code&gt;，SQLite 里是 &lt;code&gt;1/0&lt;/code&gt;。Date 对象的处理方式也完全不同。&lt;/p&gt;
&lt;p&gt;我不得不把所有涉及日期的查询全部重写。光这一项就改了好几天，提交了十几个 commit。有些 bug 还很隐蔽，比如农历转换后的日期比较逻辑，在 PostgreSQL 里跑得好好的，换到 SQLite 就出错了，因为两边的日期排序规则不一样。&lt;/p&gt;
&lt;p&gt;教训：换数据库不是换个驱动那么简单。SQL 看起来是「标准」的，但每个数据库都有自己的方言和怪癖。&lt;/p&gt;
&lt;h3&gt;crypto.randomUUID 在 NAS 上不工作&lt;a href=&quot;#cryptorandomuuid-在-nas-上不工作&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这个 bug 让我排查了很久。本地开发一切正常，部署到 NAS 上之后，用户注册和登录功能直接崩了。&lt;/p&gt;
&lt;p&gt;报错信息是 &lt;code&gt;crypto.randomUUID is not a function&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;查了一圈才知道：&lt;code&gt;crypto.randomUUID()&lt;/code&gt; 需要「安全上下文」（Secure Context），也就是 HTTPS 环境。但 NAS 用户大多是通过局域网 HTTP 访问的，没有 HTTPS。&lt;/p&gt;
&lt;p&gt;解决方案是加了一个 fallback：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;function&lt;/span&gt;&lt;span&gt; generateUUID&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; string&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  if&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;typeof&lt;/span&gt;&lt;span&gt; crypto &lt;/span&gt;&lt;span&gt;!==&lt;/span&gt;&lt;span&gt; &apos;undefined&apos;&lt;/span&gt;&lt;span&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span&gt; crypto&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;randomUUID) &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    return&lt;/span&gt;&lt;span&gt; crypto&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;randomUUID&lt;/span&gt;&lt;span&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  // fallback: 手动拼接 UUID v4&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  return&lt;/span&gt;&lt;span&gt; &apos;xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx&apos;&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;replace&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;/&lt;/span&gt;&lt;span&gt;[&lt;/span&gt;&lt;span&gt;xy&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt;/&lt;/span&gt;&lt;span&gt;g&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; (&lt;/span&gt;&lt;span&gt;c&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; =&amp;gt;&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; r &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; (Math&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;random&lt;/span&gt;&lt;span&gt;() &lt;/span&gt;&lt;span&gt;*&lt;/span&gt;&lt;span&gt; 16&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;|&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    const&lt;/span&gt;&lt;span&gt; v &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; c &lt;/span&gt;&lt;span&gt;===&lt;/span&gt;&lt;span&gt; &apos;x&apos;&lt;/span&gt;&lt;span&gt; ?&lt;/span&gt;&lt;span&gt; r &lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; (r &lt;/span&gt;&lt;span&gt;&amp;amp;&lt;/span&gt;&lt;span&gt; 0x3&lt;/span&gt;&lt;span&gt;) &lt;/span&gt;&lt;span&gt;|&lt;/span&gt;&lt;span&gt; 0x8&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    return&lt;/span&gt;&lt;span&gt; v&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;toString&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;16&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;这种「本地没问题，线上就炸」的 bug 是最烦人的。以后写代码得多想想目标用户的实际使用环境。&lt;/p&gt;
&lt;h3&gt;时区问题：经典的差 8 小时&lt;a href=&quot;#时区问题经典的差-8-小时&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;做 Web 开发的人大概都会遇到时区问题，我也没逃过。&lt;/p&gt;
&lt;p&gt;用户反馈说登录时间显示不对，明明是下午三点登录的，系统显示的是早上七点。差了刚好 8 小时。&lt;/p&gt;
&lt;p&gt;原因很简单：服务端存的是 UTC 时间，前端展示的时候没有做时区转换。中国是 UTC+8，所以差了 8 小时。&lt;/p&gt;
&lt;p&gt;听起来很好修对吧？但实际上我前前后后改了好几次才彻底修好。因为时区问题不只出现在登录时间，事件提醒的触发时间、农历日期的计算、cron 表达式的解析……到处都有时区的影子。每修一个地方就发现另一个地方也有问题。&lt;/p&gt;
&lt;p&gt;最后我统一了策略：服务端全部用 UTC 存储和计算，只在返回给前端的时候转换成 &lt;code&gt;Asia/Shanghai&lt;/code&gt;。&lt;/p&gt;
&lt;h3&gt;Docker 容器里的 DNS 解析失败&lt;a href=&quot;#docker-容器里的-dns-解析失败&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;有用户反馈说通知发不出去，看日志发现是 DNS 解析失败。容器里 &lt;code&gt;ping&lt;/code&gt; 任何域名都不通。&lt;/p&gt;
&lt;p&gt;这是国内网络环境的老问题了。Docker 默认用的 DNS 是 &lt;code&gt;8.8.8.8&lt;/code&gt;（Google DNS），在国内很多网络环境下不稳定。&lt;/p&gt;
&lt;p&gt;解决方案是在 &lt;code&gt;docker-compose.yml&lt;/code&gt; 里加上国内 DNS：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;dns&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&lt;/span&gt;&lt;span&gt; 223.5.5.5&lt;/span&gt;&lt;span&gt; # 阿里 DNS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&lt;/span&gt;&lt;span&gt; 8.8.8.8&lt;/span&gt;&lt;span&gt; # Google DNS（备用）&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;code&gt;223.5.5.5&lt;/code&gt; 是阿里云的公共 DNS，国内解析速度快、稳定性好。加上之后问题就解决了。&lt;/p&gt;
&lt;h2&gt;几个有意思的功能&lt;a href=&quot;#几个有意思的功能&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;TimeMark 的功能不少，挑几个我觉得有意思的说说。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;农历支持&lt;/strong&gt;是最费心思的。我用了 &lt;code&gt;lunar-javascript&lt;/code&gt; 这个库来做农历和公历的互转。农历有闰月，比如闰四月，这种情况下同一个农历生日在公历上的日期会跳来跳去。我写了一套逻辑来处理这些边界情况，测试用例写了一大堆。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;通知渠道&lt;/strong&gt;目前支持 35 个以上，覆盖了微信（Server 酱、PushPlus）、QQ、Telegram、钉钉、飞书、邮件、Bark、Gotify 等等。这些渠道的 API 各不相同，我抽象了一个统一的通知接口，新增渠道只需要实现一个 adapter 就行。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;安全方面&lt;/strong&gt;也下了功夫。JWT 做身份认证，bcrypt 做密码哈希，AES-256 加密存储第三方通知渠道的密钥（比如邮箱密码、API Token），还有登录失败锁定机制防暴力破解。虽然是个小工具，但跑在 NAS 上，安全不能马虎。&lt;/p&gt;
&lt;p&gt;还有个小功能我挺喜欢的：&lt;strong&gt;智能关系映射&lt;/strong&gt;。你输入「我爸」，系统会自动识别成「父亲」这个关系类型，方便后续分类和展示。&lt;/p&gt;
&lt;h2&gt;部署方式&lt;a href=&quot;#部署方式&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;说了这么多，怎么用呢？&lt;/p&gt;
&lt;h3&gt;最快的方式：三行命令&lt;a href=&quot;#最快的方式三行命令&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;mkdir&lt;/span&gt;&lt;span&gt; timemark&lt;/span&gt;&lt;span&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span&gt; cd&lt;/span&gt;&lt;span&gt; timemark&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;curl&lt;/span&gt;&lt;span&gt; -sSL&lt;/span&gt;&lt;span&gt; https://raw.githubusercontent.com/WXFffff666/timemark-docker/master/docker-compose.dockerhub.yml&lt;/span&gt;&lt;span&gt; -o&lt;/span&gt;&lt;span&gt; docker-compose.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;docker&lt;/span&gt;&lt;span&gt; compose&lt;/span&gt;&lt;span&gt; up&lt;/span&gt;&lt;span&gt; -d&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h3&gt;完整的 docker-compose.yml&lt;a href=&quot;#完整的-docker-composeyml&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;如果你想手动创建配置文件，内容就这么多：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# TimeMark 一键部署 (Docker Hub)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# 使用: docker compose up -d&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;services&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  app&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    image&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; xfffff666/timemark:latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    container_name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; timemark-app&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    restart&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ports&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -&lt;/span&gt;&lt;span&gt; &apos;3000:3000&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    environment&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      TZ&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Asia/Shanghai&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    dns&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -&lt;/span&gt;&lt;span&gt; 223.5.5.5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -&lt;/span&gt;&lt;span&gt; 8.8.8.8&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    volumes&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -&lt;/span&gt;&lt;span&gt; ./data:/app/data&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;就这 18 行，没了。不需要配置数据库，不需要配置 Redis，不需要设置环境变量。&lt;code&gt;docker compose up -d&lt;/code&gt; 之后访问 &lt;code&gt;http://你的NAS的IP:3000&lt;/code&gt; 就能用了。&lt;/p&gt;
&lt;h3&gt;几个部署细节&lt;a href=&quot;#几个部署细节&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;端口冲突？&lt;/strong&gt; 如果 3000 端口被占了，改成别的就行：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;ports&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&lt;/span&gt;&lt;span&gt; &apos;8080:3000&apos;&lt;/span&gt;&lt;span&gt; # 改成 8080 或者任何空闲端口&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;数据在哪？&lt;/strong&gt; 所有数据存在 &lt;code&gt;./data/timemark.db&lt;/code&gt; 这个 SQLite 文件里。备份的时候直接拷贝这个文件就行：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;cp&lt;/span&gt;&lt;span&gt; ./data/timemark.db&lt;/span&gt;&lt;span&gt; ./data/timemark.db.bak&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;DNS 为什么要配？&lt;/strong&gt; 国内网络环境下，Docker 默认的 DNS（8.8.8.8）经常解析失败。加上 &lt;code&gt;223.5.5.5&lt;/code&gt;（阿里 DNS）就稳了。这也是我踩坑踩出来的经验。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;公网部署？&lt;/strong&gt; 如果要放到公网服务器上，建议自定义 &lt;code&gt;JWT_SECRET&lt;/code&gt; 和 &lt;code&gt;MASTER_KEY&lt;/code&gt;：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;environment&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  TZ&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Asia/Shanghai&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  JWT_SECRET&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 你自己生成一个随机字符串&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  MASTER_KEY&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 再生成一个随机字符串&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h3&gt;镜像地址&lt;a href=&quot;#镜像地址&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;




















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;镜像源&lt;/th&gt;&lt;th&gt;地址&lt;/th&gt;&lt;th&gt;说明&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Docker Hub&lt;/strong&gt;（推荐）&lt;/td&gt;&lt;td&gt;&lt;code&gt;xfffff666/timemark:latest&lt;/code&gt;&lt;/td&gt;&lt;td&gt;无需登录，直接拉取&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;GHCR&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;ghcr.io/wfffff666/timemark:latest&lt;/code&gt;&lt;/td&gt;&lt;td&gt;需要 GitHub 登录&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;飞牛 OS、群晖、威联通、铁威马都能用。只要你的 NAS 支持 Docker，就没问题。&lt;/p&gt;
&lt;h2&gt;v2.1.0：继续打磨&lt;a href=&quot;#v210继续打磨&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;v2.0 发布之后，我以为可以告一段落了。结果用了几天就发现还有很多可以改进的地方。&lt;/p&gt;
&lt;h3&gt;8 个新通知渠道&lt;a href=&quot;#8-个新通知渠道&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;v2.0 的时候支持 27 个通知渠道，已经不少了。但我发现国内用户最常用的几个推送服务还没支持：Server 酱、PushPlus、Bark 这些。&lt;/p&gt;
&lt;p&gt;于是我又加了 8 个新渠道：&lt;/p&gt;









































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;渠道&lt;/th&gt;&lt;th&gt;说明&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;🦞 微信龙虾 (ClawBot)&lt;/td&gt;&lt;td&gt;直接推送到个人微信&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;📡 Server 酱&lt;/td&gt;&lt;td&gt;微信推送服务&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;📮 PushPlus&lt;/td&gt;&lt;td&gt;多渠道推送&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;🔔 Bark&lt;/td&gt;&lt;td&gt;iOS 推送通知&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;📢 Gotify&lt;/td&gt;&lt;td&gt;自托管推送&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;🐱 喵推送 (Meow)&lt;/td&gt;&lt;td&gt;鸿蒙系统推送&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;📲 PushMe&lt;/td&gt;&lt;td&gt;多平台推送&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;💼 企业微信应用&lt;/td&gt;&lt;td&gt;企微应用消息&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;加完之后渠道总数到了 38+。因为之前设计了统一的通知接口，新增渠道只需要实现一个 adapter，所以加起来还挺快的。每个渠道大概半天就能搞定，主要时间花在看各家的 API 文档上。&lt;/p&gt;
&lt;p&gt;顺便还把邮件渠道做了分类重组，支持多账号选择了。比如你可以配置多个邮箱，创建事件的时候选择用哪个邮箱发通知。&lt;/p&gt;
&lt;h3&gt;零配置即开即用&lt;a href=&quot;#零配置即开即用&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;v2.0 的时候，虽然已经是单容器了，但还是需要配置 &lt;code&gt;JWT_SECRET&lt;/code&gt; 和 &lt;code&gt;MASTER_KEY&lt;/code&gt; 这两个环境变量。有用户反馈说不知道怎么生成随机字符串，觉得麻烦。&lt;/p&gt;
&lt;p&gt;想了想，确实没必要强制配置。对于家庭内网使用的场景，内置一个默认密钥就够了。于是我给所有环境变量都加了内置默认值：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;JWT_SECRET&lt;/code&gt; 和 &lt;code&gt;MASTER_KEY&lt;/code&gt; 有内置默认值&lt;/li&gt;
&lt;li&gt;默认管理员账号 &lt;code&gt;admin&lt;/code&gt; / &lt;code&gt;TimeMark@2026&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;docker compose up -d&lt;/code&gt; 之后直接就能用，不需要改任何配置&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;当然，如果是公网部署，还是建议自定义密钥。但对于大多数 NAS 用户来说，零配置才是最友好的。&lt;/p&gt;
&lt;h3&gt;登录锁定升级&lt;a href=&quot;#登录锁定升级&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;v2.0 的登录锁定是固定的：连续 5 次失败，锁定 15 分钟。但这样有个问题——攻击者等 15 分钟就能继续尝试。&lt;/p&gt;
&lt;p&gt;v2.1.0 改成了线性叠加：第一次锁定 5 分钟，第二次 10 分钟，第三次 15 分钟……每次锁定时间递增。这样暴力破解的成本会越来越高。&lt;/p&gt;
&lt;h3&gt;CI 构建修复&lt;a href=&quot;#ci-构建修复&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;加了 ClawBot（微信龙虾）渠道之后，CI 构建突然挂了。排查了一下，发现是两个问题：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;ClawBot 依赖 &lt;code&gt;nodemailer&lt;/code&gt;，但没有加到 &lt;code&gt;package.json&lt;/code&gt; 里。本地开发的时候因为 &lt;code&gt;node_modules&lt;/code&gt; 里有缓存所以没问题，CI 环境是干净安装就报错了。&lt;/li&gt;
&lt;li&gt;ClawBot 的类型定义有问题，TypeScript 编译不过。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;修了这两个问题之后 CI 就通了。这种「本地没问题，CI 就炸」的情况我在做博客的时候也遇到过，算是老朋友了。&lt;/p&gt;
&lt;h2&gt;这个项目教会我的&lt;a href=&quot;#这个项目教会我的&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;回头看，TimeMark 教会我的东西比博客项目多得多。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;全栈开发的完整链路。&lt;/strong&gt; 从前端 UI 到后端 API，从数据库设计到 Docker 打包，从 CI/CD 到镜像发布。每一环都自己来，虽然累，但对整个开发流程的理解深了很多。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Docker 多阶段构建。&lt;/strong&gt; 为了减小镜像体积，我学了 multi-stage build。第一阶段用 Node.js 编译 TypeScript，第二阶段只拷贝编译产物和运行时依赖。最终镜像从 1GB+ 压缩到了几百 MB。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;安全意识。&lt;/strong&gt; 以前写代码不太在意安全，觉得「又没人攻击我」。但 TimeMark 要存用户的通知渠道密钥，这些东西泄露了是真的会出问题的。所以我认真学了加密、鉴权、防暴力破解这些知识。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;架构重构的勇气。&lt;/strong&gt; v1.x 到 v2.0 的重写，等于把后端推翻重来。当时很纠结，毕竟 v1.x 已经能用了。但用户反馈摆在那里，不改不行。这次经历让我明白：代码不是写完就结束了，根据反馈持续改进才是常态。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;CI/CD 自动化。&lt;/strong&gt; 用 GitHub Actions 实现了自动构建和推送 Docker 镜像。每次 push 代码，Actions 会自动编译、打包、推送到 Docker Hub。再也不用手动 &lt;code&gt;docker build&lt;/code&gt; 然后 &lt;code&gt;docker push&lt;/code&gt; 了。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;用户反馈的价值。&lt;/strong&gt; 如果不是 NAS 用户告诉我「太重了」，我可能永远不会去做 v2.0 的重写。闭门造车做出来的东西，和真实用户需要的东西，往往差距很大。&lt;/p&gt;
&lt;h2&gt;写在最后&lt;a href=&quot;#写在最后&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;从博客到 TimeMark，每个项目都让我成长了一截。博客教会我前端开发和部署，TimeMark 教会我全栈开发和 Docker。&lt;/p&gt;
&lt;p&gt;从 v1.x 到 v2.0 再到 v2.1.0，每次迭代都是在用户反馈的基础上打磨。这个项目不会「完成」，它会一直跟着需求进化。&lt;/p&gt;
&lt;p&gt;下一个项目会是什么？还不确定。但我知道，只要一直做下去，一直学下去，总会越来越好的。&lt;/p&gt;
&lt;p&gt;如果你也是学生，也想做点什么，别犹豫，直接开始。第一版肯定很烂，没关系。我的第一版也很烂，三个容器吃 800MB 内存那种烂。但做着做着，就会越来越好。&lt;/p&gt;
&lt;p&gt;继续写代码，继续踩坑，继续成长。&lt;/p&gt;</content:encoded><category>category:笔记</category><category>category:开发之旅</category><category>tag:Docker</category><category>tag:TypeScript</category><category>tag:NAS</category><category>tag:全栈</category><category>tag:开源</category></item><item><title>从零到一：一个高中生的博客搭建与优化之旅</title><link>https://blog.the37777777.top/post/my-blog-journey</link><guid isPermaLink="false">my-blog-journey</guid><description>记录一个高中生从零开始搭建个人博客的完整历程，从技术选型到部署上线，从深色模式渲染问题到图片加载优化，每一步都是成长。</description><pubDate>Sat, 14 Feb 2026 16:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;写在前面&lt;a href=&quot;#写在前面&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;大家好，我是 XFffff，一名高中生。这是我第一次尝试搭建自己的个人博客。说实话，一开始我对前端开发了解得不多，只是觉得有个自己的博客很酷，可以记录学习和生活。没想到这个过程比我想象的要复杂得多，但也更有趣。&lt;/p&gt;
&lt;p&gt;这篇文章记录了我从零开始搭建博客的完整过程，包括遇到的各种问题和解决方法，特别是今天（2 月 15 日）一整天的性能优化历程。希望能帮到和我一样想做博客的同学。&lt;/p&gt;
&lt;h2&gt;第一步：选择技术方案&lt;a href=&quot;#第一步选择技术方案&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;一开始我很迷茫，不知道该用什么技术。在网上搜索了很久，看了很多教程，最后决定用这套方案：&lt;/p&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;组件&lt;/th&gt;&lt;th&gt;选择&lt;/th&gt;&lt;th&gt;为什么选它&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;框架&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Next.js 15&lt;/td&gt;&lt;td&gt;听说很流行，而且可以生成静态网站&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;样式&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Tailwind CSS 3.4&lt;/td&gt;&lt;td&gt;不用写太多 CSS，直接用类名就行&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;内容&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;MDX&lt;/td&gt;&lt;td&gt;可以用 Markdown 写文章，简单方便&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;部署&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Cloudflare Pages&lt;/td&gt;&lt;td&gt;免费！而且速度快&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;包管理&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;pnpm&lt;/td&gt;&lt;td&gt;比 npm 快，节省空间&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;为什么不用 Vercel？&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;虽然很多教程都推荐 Vercel，但我选择了 Cloudflare Pages，因为：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;完全免费，没有流量限制&lt;/li&gt;
&lt;li&gt;全球 CDN，访问速度快&lt;/li&gt;
&lt;li&gt;和域名管理在一起，方便&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;第二步：找到合适的模板&lt;a href=&quot;#第二步找到合适的模板&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;作为第一次做项目，我不可能从零开始写所有代码。在 GitHub 上找了很久，最后发现了 &lt;a href=&quot;https://github.com/mk965/mengke.me&quot;&gt;mengke.me&lt;/a&gt; 这个开源项目。&lt;/p&gt;
&lt;p&gt;这个项目功能很完善：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;✅ 支持 Markdown 写文章&lt;/li&gt;
&lt;li&gt;✅ 有深色模式&lt;/li&gt;
&lt;li&gt;✅ 可以搜索文章&lt;/li&gt;
&lt;li&gt;✅ 自动生成 RSS&lt;/li&gt;
&lt;li&gt;✅ 手机和电脑都能正常显示&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;我把它 Fork 到自己的 GitHub，然后开始改造。&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# 克隆项目到本地&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;git&lt;/span&gt;&lt;span&gt; clone&lt;/span&gt;&lt;span&gt; https://github.com/WXFffff666/my-blog.git&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;cd&lt;/span&gt;&lt;span&gt; my-blog&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# 安装依赖&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;pnpm&lt;/span&gt;&lt;span&gt; install&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# 启动开发服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;pnpm&lt;/span&gt;&lt;span&gt; dev&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;打开 &lt;code&gt;http://localhost:3434&lt;/code&gt;，看到页面成功显示，心里特别激动！&lt;/p&gt;
&lt;h2&gt;第三步：个性化定制&lt;a href=&quot;#第三步个性化定制&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;修改个人信息&lt;a href=&quot;#修改个人信息&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;第一件事就是把模板里的信息改成自己的。主要修改这几个文件：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1. 个人信息（&lt;code&gt;data/author-info.ts&lt;/code&gt;）&lt;/strong&gt;&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;export&lt;/span&gt;&lt;span&gt; const&lt;/span&gt;&lt;span&gt; AUTHOR_INFO &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;XFffff&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  description&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;一个热爱学习的高中生&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  email&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;my-email@example.com&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  identity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;Student | Learning&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  address&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    city&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;Guilin, China&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    flag&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;flag-china&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    timeZone&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 8&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  social&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    github&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;https://github.com/WXFffff666&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;注意&lt;/strong&gt;：不要填真实姓名、手机号、详细地址这些敏感信息！&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;2. 网站信息（&lt;code&gt;data/site-metadata.ts&lt;/code&gt;）&lt;/strong&gt;&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;export&lt;/span&gt;&lt;span&gt; const&lt;/span&gt;&lt;span&gt; SITE_METADATA &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  title&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;XFffff 的个人博客&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  author&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;XFffff&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  siteUrl&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;https://blog.the37777777.top&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  locale&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;zh-CN&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  language&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;zh-CN&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h3&gt;写第一篇文章&lt;a href=&quot;#写第一篇文章&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;在 &lt;code&gt;data/blog/202602/&lt;/code&gt; 目录下创建 &lt;code&gt;Hello_World.mdx&lt;/code&gt;：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;title&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;Hello World - 我的第一篇博客&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;date&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;2026-02-12&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;tags&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; [&lt;/span&gt;&lt;span&gt;&apos;随笔&apos;&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;draft&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;summary&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;这是我的第一篇博客文章！&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;## 你好，世界！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;这是我的第一篇博客文章。从今天开始，我要记录自己的学习和成长。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;希望能坚持下去！&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;保存后刷新页面，文章就出现了！那一刻真的很有成就感。&lt;/p&gt;
&lt;h2&gt;第四步：部署到 Cloudflare Pages&lt;a href=&quot;#第四步部署到-cloudflare-pages&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;本地运行成功后，就要部署到网上了。这一步遇到了不少问题。&lt;/p&gt;
&lt;h3&gt;配置静态导出&lt;a href=&quot;#配置静态导出&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;Cloudflare Pages 需要静态文件，所以要修改 &lt;code&gt;next.config.js&lt;/code&gt;：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;const&lt;/span&gt;&lt;span&gt; nextConfig &lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  output&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;export&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; // 静态导出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  images&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    unoptimized&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; true&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; // 必须禁用图片优化&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h3&gt;遇到的第一个错误&lt;a href=&quot;#遇到的第一个错误&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;运行 &lt;code&gt;pnpm build&lt;/code&gt; 时报错：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;Page &quot;/snippets/[...slug]&quot; is missing &quot;generateStaticParams()&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;原因&lt;/strong&gt;：项目里有个 &lt;code&gt;snippets&lt;/code&gt; 目录，但我还没有添加任何内容。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;解决&lt;/strong&gt;：直接删除 &lt;code&gt;app/snippets/&lt;/code&gt; 目录，等以后有内容了再加回来。&lt;/p&gt;
&lt;h3&gt;创建 Cloudflare Pages 项目&lt;a href=&quot;#创建-cloudflare-pages-项目&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;登录 &lt;a href=&quot;https://dash.cloudflare.com/&quot;&gt;Cloudflare Dashboard&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;左侧菜单 → &lt;strong&gt;Workers 和 Pages&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;点击 &lt;strong&gt;创建&lt;/strong&gt; → 选择 &lt;strong&gt;Pages&lt;/strong&gt; 标签页&lt;/li&gt;
&lt;li&gt;连接 GitHub 仓库&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;重要配置：&lt;/strong&gt;&lt;/p&gt;





















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;配置项&lt;/th&gt;&lt;th&gt;值&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;框架预设&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;Next.js (Static HTML Export)&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;构建命令&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;pnpm build&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;构建输出目录&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;out&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3&gt;绑定自定义域名&lt;a href=&quot;#绑定自定义域名&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;Cloudflare 会给一个 &lt;code&gt;xxx.pages.dev&lt;/code&gt; 的临时域名，但我想用自己的域名。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;进入 Pages 项目 → &lt;strong&gt;自定义域&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;添加域名 &lt;code&gt;blog.the37777777.top&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Cloudflare 自动添加 DNS 记录&lt;/li&gt;
&lt;li&gt;等待 5-10 分钟生效&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;访问自己的域名，博客成功上线了！那一刻真的超级激动！&lt;/p&gt;
&lt;h2&gt;第五步：深色模式渲染优化（今天的重头戏）&lt;a href=&quot;#第五步深色模式渲染优化今天的重头戏&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;博客上线后，我发现深色模式有严重的渲染问题：&lt;strong&gt;快速滚动时，文字会闪烁消失，非常卡顿&lt;/strong&gt;。这个问题困扰了我一整天，但最终找到了解决方案。&lt;/p&gt;
&lt;h3&gt;问题现象&lt;a href=&quot;#问题现象&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;在深色模式下快速滚动页面&lt;/li&gt;
&lt;li&gt;部分文字会闪烁、消失&lt;/li&gt;
&lt;li&gt;有些文字清晰，有些文字模糊&lt;/li&gt;
&lt;li&gt;Footer 的文字清晰，但首页的文字模糊&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;排查过程&lt;a href=&quot;#排查过程&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;h4&gt;尝试 1：移除 PageTransition 的 transform&lt;a href=&quot;#尝试-1移除-pagetransition-的-transform&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h4&gt;
&lt;p&gt;我发现 &lt;code&gt;PageTransition&lt;/code&gt; 组件使用了 &lt;code&gt;translate-y-2&lt;/code&gt;，这会创建 GPU 渲染层。&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// 修改前&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;translate-y-2 opacity-0&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// 修改后&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;opacity-0&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;结果&lt;/strong&gt;：❌ 还是会闪烁&lt;/p&gt;
&lt;h4&gt;尝试 2：移除所有动画的 transform&lt;a href=&quot;#尝试-2移除所有动画的-transform&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h4&gt;
&lt;p&gt;检查了所有动画，发现很多地方使用了 &lt;code&gt;transform&lt;/code&gt;：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;/* CSS 中的动画 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;@keyframes&lt;/span&gt;&lt;span&gt; fade-in-up&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  from &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    opacity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    transform&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; translateY&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;20&lt;/span&gt;&lt;span&gt;px&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;span&gt; /* ← 问题所在 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;全部改成只用 &lt;code&gt;opacity&lt;/code&gt;：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;@keyframes&lt;/span&gt;&lt;span&gt; fade-in-up&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  from &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    opacity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  to &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    opacity&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 1&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;结果&lt;/strong&gt;：❌ 还是有问题&lt;/p&gt;
&lt;h4&gt;尝试 3：移除 Greeting 的 bg-clip-text&lt;a href=&quot;#尝试-3移除-greeting-的-bg-clip-text&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h4&gt;
&lt;p&gt;发现 Greeting 组件使用了 &lt;code&gt;bg-clip-text&lt;/code&gt; 和渐变动画：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// 修改前&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;bg-clip-text text-transparent animate-text-shimmer&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// 修改后&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;text-violet-600&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;结果&lt;/strong&gt;：❌ 还是不行&lt;/p&gt;
&lt;h4&gt;尝试 4：对比原作者项目（找到根本原因！）&lt;a href=&quot;#尝试-4对比原作者项目找到根本原因&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h4&gt;
&lt;p&gt;我仔细对比了原作者的项目，发现了关键差异：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;我的配置：&lt;/strong&gt;&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// layout.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;body&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;dark:bg-black&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;  // 纯黑 #000000&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// background.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;dark:bg-[#000000]&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;  // 纯黑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// tailwind.config.js&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;dark: &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  bg: &lt;/span&gt;&lt;span&gt;&apos;#050505&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt;  // 极致深黑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;原作者的配置：&lt;/strong&gt;&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// layout.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;body&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;dark:bg-dark&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;span&gt;  // 深灰色&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// tailwind.config.js&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;dark: &apos;#1f1f1f&apos;,  // 深灰色，不是纯黑！&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;发现问题&lt;/strong&gt;：纯黑背景（#000000 或 #050505）在某些浏览器和操作系统上会导致字体渲染问题！&lt;/p&gt;
&lt;h3&gt;最终解决方案&lt;a href=&quot;#最终解决方案&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;将所有深色背景从&lt;strong&gt;纯黑&lt;/strong&gt;改为&lt;strong&gt;深灰色 &lt;code&gt;#1f1f1f&lt;/code&gt;&lt;/strong&gt;：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// layout.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;body&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;dark:bg-dark-bg&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// background.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;dark:bg-[#1f1f1f]&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;// tailwind.config.js&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;dark: &lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  bg: &lt;/span&gt;&lt;span&gt;&apos;#1f1f1f&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt;  // 深灰色&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;结果&lt;/strong&gt;：✅ 完美解决！深色模式滚动完全流畅，不再闪烁！&lt;/p&gt;
&lt;h3&gt;为什么深灰色不会糊？&lt;a href=&quot;#为什么深灰色不会糊&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;#1f1f1f&lt;/code&gt; 虽然看起来也很黑，但它不是纯黑&lt;/li&gt;
&lt;li&gt;这个颜色值在浏览器渲染引擎中不会触发某些特殊的优化路径&lt;/li&gt;
&lt;li&gt;原作者也是用这个颜色，证明它是稳定可靠的&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;教训&lt;/strong&gt;：有时候问题的根源不在代码逻辑，而在一些看似无关紧要的细节（比如背景颜色）。&lt;/p&gt;
&lt;h2&gt;第六步：图片加载优化&lt;a href=&quot;#第六步图片加载优化&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;解决了深色模式问题后，我发现快速滚动时，下面会出现白条（内容还没渲染出来）。这是图片加载慢导致的。&lt;/p&gt;
&lt;h3&gt;优化方案&lt;a href=&quot;#优化方案&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;1. 预加载首屏图片&lt;/strong&gt;&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// latest-posts.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  posts&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;map&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;post&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; index&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt; =&amp;gt;&lt;/span&gt;&lt;span&gt; &amp;lt;&lt;/span&gt;&lt;span&gt;BlogCard&lt;/span&gt;&lt;span&gt; key&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;post&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;slug&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt; post&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;post&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt; priority&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;index &lt;/span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt; 3&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt; /&amp;gt;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;前 3 篇文章的图片使用 &lt;code&gt;priority={true}&lt;/code&gt;，浏览器会优先加载。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. 添加渐变占位符&lt;/strong&gt;&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// blog-card.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;relative h-48 w-full overflow-hidden bg-gradient-to-br from-gray-100 to-gray-200 dark:from-[#121212] dark:to-[#1a1a1a]&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &amp;lt;&lt;/span&gt;&lt;span&gt;Image&lt;/span&gt;&lt;span&gt; src&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;coverImage&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt; alt&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;title&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt; priority&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;priority&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;span&gt; /&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;/&lt;/span&gt;&lt;span&gt;div&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;图片加载前显示渐变背景，视觉上更平滑。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. 优化图片淡入效果&lt;/strong&gt;&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;// image.tsx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;NextImage&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;clsx&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&apos;transition-opacity duration-300&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; loaded &lt;/span&gt;&lt;span&gt;?&lt;/span&gt;&lt;span&gt; &apos;opacity-100&apos;&lt;/span&gt;&lt;span&gt; :&lt;/span&gt;&lt;span&gt; &apos;opacity-0&apos;&lt;/span&gt;&lt;span&gt;)&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  onLoad&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{&lt;/span&gt;&lt;span&gt;onLoad&lt;/span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;图片加载完成后淡入显示，更自然。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;结果&lt;/strong&gt;：✅ 快速滚动时不再出现明显的白条！&lt;/p&gt;
&lt;h2&gt;第七步：导航栏交互优化&lt;a href=&quot;#第七步导航栏交互优化&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;博客基本完善后，我开始优化细节。发现导航栏 hover 时有个放大动画，但放大过程中会模糊。&lt;/p&gt;
&lt;h3&gt;问题分析&lt;a href=&quot;#问题分析&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;导航栏使用了 &lt;code&gt;hover:scale-[1.005]&lt;/code&gt;，scale 变换会导致字体模糊。&lt;/p&gt;
&lt;h3&gt;尝试的方案&lt;a href=&quot;#尝试的方案&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;h4&gt;方案 1：移除 scale，改用阴影 + 上移&lt;a href=&quot;#方案-1移除-scale改用阴影--上移&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h4&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;nav&lt;/span&gt;&lt;span&gt; className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;hover:shadow-xl hover:-translate-y-0.5&quot;&lt;/span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;结果&lt;/strong&gt;：✅ 完全不会模糊，但上移有点突兀&lt;/p&gt;
&lt;h4&gt;方案 2：保留 scale，添加 GPU 优化（最终方案）&lt;a href=&quot;#方案-2保留-scale添加-gpu-优化最终方案&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h4&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;&amp;lt;&lt;/span&gt;&lt;span&gt;nav&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  className&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;hover:scale-[1.005]&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  style&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;{{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    willChange&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;transform&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    transform&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;translateZ(0)&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    backfaceVisibility&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;hidden&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    WebkitFontSmoothing&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;subpixel-antialiased&apos;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;GPU 优化原理：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;willChange: &apos;transform&apos;&lt;/code&gt; - 提示浏览器会有变换&lt;/li&gt;
&lt;li&gt;&lt;code&gt;transform: translateZ(0)&lt;/code&gt; - 强制创建 GPU 渲染层&lt;/li&gt;
&lt;li&gt;&lt;code&gt;backfaceVisibility: &apos;hidden&apos;&lt;/code&gt; - 隐藏背面，提升性能&lt;/li&gt;
&lt;li&gt;&lt;code&gt;WebkitFontSmoothing: &apos;subpixel-antialiased&apos;&lt;/code&gt; - 亚像素级抗锯齿&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;结果&lt;/strong&gt;：✅ 保留了放大效果，模糊感大幅减少！&lt;/p&gt;
&lt;h2&gt;经验总结&lt;a href=&quot;#经验总结&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;1. 技术选型很重要&lt;a href=&quot;#1-技术选型很重要&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Next.js 静态导出性能很好，适合博客&lt;/li&gt;
&lt;li&gt;Cloudflare Pages 免费额度够用，速度也快&lt;/li&gt;
&lt;li&gt;找一个好的开源模板可以节省很多时间&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;2. 遇到问题不要慌&lt;a href=&quot;#2-遇到问题不要慌&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;先对比原作者的代码，找出差异&lt;/li&gt;
&lt;li&gt;逐步修复，每次只改一个地方&lt;/li&gt;
&lt;li&gt;分别测试电脑端和移动端&lt;/li&gt;
&lt;li&gt;善用浏览器开发者工具&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;3. 性能优化要系统思考&lt;a href=&quot;#3-性能优化要系统思考&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;深色模式问题可能是背景颜色导致的&lt;/li&gt;
&lt;li&gt;图片加载要预加载首屏内容&lt;/li&gt;
&lt;li&gt;GPU 优化可以减少 transform 的模糊感&lt;/li&gt;
&lt;li&gt;不要过度使用动画和特效&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;4. 细节决定体验&lt;a href=&quot;#4-细节决定体验&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;背景颜色不要用纯黑，用深灰色&lt;/li&gt;
&lt;li&gt;图片要有占位符，避免白屏&lt;/li&gt;
&lt;li&gt;动画要流畅，不能卡顿&lt;/li&gt;
&lt;li&gt;移动端和电脑端要分别优化&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;5. 学会阅读源码&lt;a href=&quot;#5-学会阅读源码&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;遇到问题时，对比原作者的代码&lt;/li&gt;
&lt;li&gt;理解每一行代码的作用&lt;/li&gt;
&lt;li&gt;不要盲目复制粘贴&lt;/li&gt;
&lt;li&gt;学会举一反三&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;后续开发：从初版到液态玻璃&lt;a href=&quot;#后续开发从初版到液态玻璃&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;博客上线之后，我以为可以歇一歇了。结果完全停不下来——每天都能想到新功能要加，新 bug 要修。从 2 月到 4 月，这个博客经历了一次又一次的迭代，最终变成了现在的样子。&lt;/p&gt;
&lt;h3&gt;功能大爆发&lt;a href=&quot;#功能大爆发&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;上线后的两个月里，我一口气加了 11 个新功能。说实话，有些功能是我自己想要的，有些是看到别人的博客觉得「这个好酷，我也要」。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;阅读进度条 + TOC 增强。&lt;/strong&gt; 文章顶部加了一个进度条，滚动的时候能看到读了多少。目录（TOC）也做了增强，在手机上变成了一个抽屉式的侧边栏，不会挡住正文。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;相关文章推荐 + 系列导航。&lt;/strong&gt; 每篇文章底部会推荐相关的文章，算法是根据标签重合度打分的。还加了「文章系列」功能，比如这篇和 TimeMark 那篇就属于「我的开发之旅」系列，可以按顺序浏览。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Sandpack 可运行代码块。&lt;/strong&gt; 这个是我最喜欢的功能之一。文章里的 JavaScript/TypeScript/HTML/CSS 代码块可以直接运行！用的是 CodeSandbox 的 Sandpack 组件，懒加载的，不影响页面性能。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;OG 图片自动生成。&lt;/strong&gt; 分享文章到社交媒体的时候，会自动生成一张好看的封面图。这个是构建时生成的，不需要运行时渲染。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Service Worker + 离线支持。&lt;/strong&gt; 加了 Service Worker 做缓存，断网了也能看之前访问过的页面。顺便还做了一个友链申请表单。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;键盘快捷键 + Changelog + Snippets 筛选。&lt;/strong&gt; 按 &lt;code&gt;?&lt;/code&gt; 可以查看所有快捷键，加了一个 Changelog 页面记录版本更新，Snippets 页面支持按标签筛选了。&lt;/p&gt;
&lt;p&gt;这些功能加起来，提交了十几个 commit。每次加完一个功能都要跑一遍 &lt;code&gt;pnpm build&lt;/code&gt;，确保静态导出没问题。Cloudflare Pages 是纯静态部署，任何需要服务端的功能都不能用，这个限制反而让我学会了很多静态站点的技巧。&lt;/p&gt;
&lt;h3&gt;代码规范化重构&lt;a href=&quot;#代码规范化重构&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;功能加多了之后，项目结构开始变得混乱。CSS 文件散落在各处，图片目录没有统一规范，有些文件放错了位置。&lt;/p&gt;
&lt;p&gt;我花了两天时间做了一次大重构：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;把 &lt;code&gt;css/&lt;/code&gt; 目录统一改名为 &lt;code&gt;styles/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;图片目录按用途分类：&lt;code&gt;covers/&lt;/code&gt;（封面）、&lt;code&gt;banners/&lt;/code&gt;（横幅）、&lt;code&gt;posts/&lt;/code&gt;（文章配图）&lt;/li&gt;
&lt;li&gt;移除了没用的测试文件和示例文件&lt;/li&gt;
&lt;li&gt;把文档统一放到 &lt;code&gt;docs/&lt;/code&gt; 目录&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;重构的过程很枯燥，但做完之后整个项目清爽了很多。以后找文件也方便了。&lt;/p&gt;
&lt;h3&gt;中文标签 404 修复&lt;a href=&quot;#中文标签-404-修复&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这个 bug 困扰了我好一阵子。博客的标签系统支持中文标签（比如「技术」「前端」），在本地开发的时候一切正常，但部署到 Cloudflare Pages 之后，点击中文标签就 404。&lt;/p&gt;
&lt;p&gt;排查了半天，发现是 &lt;code&gt;encodeURI&lt;/code&gt; 的问题。之前代码里对标签做了 URL 编码，但 Cloudflare Pages 的静态文件路径不需要编码。移除了多余的 &lt;code&gt;encodeURI&lt;/code&gt; 调用就好了。&lt;/p&gt;
&lt;p&gt;顺便还做了一个标签显示名映射（&lt;code&gt;tag-names.json&lt;/code&gt;），这样标签页上能显示原始的中文名称，而不是 URL 编码后的乱码。&lt;/p&gt;
&lt;h3&gt;液态玻璃 UI 改造&lt;a href=&quot;#液态玻璃-ui-改造&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这是最大的一次改动。&lt;/p&gt;
&lt;p&gt;起因是我看到了 Apple 的液态玻璃（Liquid Glass）设计风格，觉得特别好看。之前博客用的是「黑曜石玻璃」风格——深空灰背景加噪点纹理，虽然也不错，但看久了觉得有点沉闷。&lt;/p&gt;
&lt;p&gt;我决定把整个博客改成液态玻璃风格。&lt;/p&gt;
&lt;p&gt;一开始我想用 &lt;code&gt;liquid-glass-react&lt;/code&gt; 这个 npm 包，但研究了一下发现它已经 10 个月没更新了，性能也不太好，还没有可访问性支持。最后决定自己用纯 CSS 实现。&lt;/p&gt;
&lt;p&gt;液态玻璃的核心就是 &lt;code&gt;backdrop-filter: blur()&lt;/code&gt; 加上半透明背景。我设计了 4 个层级：&lt;/p&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;/* standard - 普通组件 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;background: rgba(255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;15&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;backdrop-filter&lt;/span&gt;&lt;span&gt;: blur(20px) saturate(1&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;8&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;/* elevated - 突出组件（导航栏、卡片） */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;background: rgba(255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;2&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;backdrop-filter&lt;/span&gt;&lt;span&gt;: blur(24px) saturate(2);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;/* subtle - 低调组件（标签、徽章） */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;background: rgba(255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;08&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;backdrop-filter&lt;/span&gt;&lt;span&gt;: blur(12px);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;/* input - 输入框 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;background: rgba(255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 255&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;span&gt;12&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;backdrop-filter&lt;/span&gt;&lt;span&gt;: blur(16px);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;背景色从深空灰改成了天蓝色 &lt;code&gt;#bfdbfe&lt;/code&gt;（浅色模式）和 &lt;code&gt;#1f1f1f&lt;/code&gt;（深色模式）。&lt;/p&gt;
&lt;p&gt;改造过程中踩了不少坑。一开始用了 SVG 滤镜做扭曲效果，结果在某些浏览器上会出现奇怪的变形和闪烁。后来去掉了 SVG 扭曲，只保留了 CSS 的 blur 和 saturate，效果反而更好。&lt;/p&gt;
&lt;p&gt;还有一个问题是白色边框。液态玻璃组件之前有白色边框和阴影，在天蓝色背景上看起来很突兀。我把所有组件的白色边框和阴影都去掉了，改用更微妙的透明度变化来区分层次。&lt;/p&gt;
&lt;p&gt;最后还要把 6 个代码块相关的 MDX 组件也适配液态玻璃风格，确保代码块在新设计系统下看起来协调。&lt;/p&gt;
&lt;p&gt;整个改造涉及了 26 个组件，提交了好几个 commit。虽然工作量很大，但最终效果我很满意。&lt;/p&gt;
&lt;h3&gt;滑动 Pill 导航指示器&lt;a href=&quot;#滑动-pill-导航指示器&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;液态玻璃改造完之后，我觉得导航栏还可以更酷一点。&lt;/p&gt;
&lt;p&gt;于是加了一个滑动的玻璃药丸（Pill）指示器。当你切换导航项的时候，一个半透明的玻璃药丸会平滑地滑动到当前选中的位置。动画用了 spring easing（弹簧缓动），有一种很自然的弹性感。&lt;/p&gt;
&lt;p&gt;这个效果实现起来不难，但调参数花了不少时间。弹簧的刚度、阻尼、质量都会影响动画的感觉，太硬了像机械，太软了像果冻。最后调到一个我觉得刚好的状态。&lt;/p&gt;
&lt;h3&gt;kbar 搜索位移修复&lt;a href=&quot;#kbar-搜索位移修复&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;这个 bug 是最后修的，也是最烦人的。&lt;/p&gt;
&lt;p&gt;博客用了 kbar 做搜索（按 &lt;code&gt;Ctrl+K&lt;/code&gt; 打开）。kbar 打开的时候会给 body 加 &lt;code&gt;overflow: hidden&lt;/code&gt;，防止背景滚动。但这样做有个副作用：滚动条消失了，页面内容会往右移动一点点（大概 15-17 像素），看起来就像页面「抖」了一下。&lt;/p&gt;
&lt;p&gt;我前前后后试了好几种方案：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;用 &lt;code&gt;padding-right&lt;/code&gt; 补偿滚动条宽度 —— 不行，因为 sticky header 的居中计算会受影响&lt;/li&gt;
&lt;li&gt;动态测量滚动条宽度再补偿 —— 太复杂，而且不同浏览器滚动条宽度不一样&lt;/li&gt;
&lt;li&gt;最终方案：直接用 CSS 覆盖 kbar 的行为&lt;/li&gt;
&lt;/ol&gt;
&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;body&lt;/span&gt;&lt;span&gt;[&lt;/span&gt;&lt;span&gt;style&lt;/span&gt;&lt;span&gt;*=&lt;/span&gt;&lt;span&gt;&apos;overflow: hidden&apos;&lt;/span&gt;&lt;span&gt;]&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  overflow-y&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; scroll &lt;/span&gt;&lt;span&gt;!important&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;简单粗暴但有效。让 body 始终保持 &lt;code&gt;overflow-y: scroll&lt;/code&gt;，滚动条一直在，就不会有位移了。kbar 的遮罩层本身就会阻止用户滚动，所以不影响功能。&lt;/p&gt;
&lt;p&gt;有时候最简单的方案就是最好的方案。&lt;/p&gt;
&lt;h2&gt;写在最后&lt;a href=&quot;#写在最后&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;从开始搭建到现在，已经过去好几天了。特别是今天（2 月 15 日），我花了一整天时间优化深色模式的渲染问题。这个过程中遇到了很多挫折，有时候真的很想放弃。但每次解决一个问题，那种成就感是无法形容的。&lt;/p&gt;
&lt;p&gt;作为一个高中生，这是我第一次完整地做一个项目。虽然代码写得不够好，但我学到了很多：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;学会了如何阅读文档和源码&lt;/li&gt;
&lt;li&gt;学会了如何调试和定位问题&lt;/li&gt;
&lt;li&gt;学会了如何系统地优化性能&lt;/li&gt;
&lt;li&gt;学会了如何坚持下去&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;最重要的是，我有了一个属于自己的博客，可以记录学习和成长。&lt;/p&gt;
&lt;p&gt;如果你也想做一个博客，不要害怕，大胆去试！遇到问题很正常，解决问题的过程就是成长的过程。&lt;/p&gt;
&lt;p&gt;后来我把浏览量统计功能去掉了，博客现在是一个纯静态站点，部署在 Cloudflare Pages 上，简单又稳定。&lt;/p&gt;
&lt;p&gt;希望这篇文章能帮到和我一样的初学者。如果你有问题，欢迎交流！&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;相关资源&lt;a href=&quot;#相关资源&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;我的博客&lt;/strong&gt;：&lt;a href=&quot;https://blog.the37777777.top&quot;&gt;https://blog.the37777777.top&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;原项目地址&lt;/strong&gt;：&lt;a href=&quot;https://github.com/mk965/mengke.me&quot;&gt;https://github.com/mk965/mengke.me&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Next.js 官方文档&lt;/strong&gt;：&lt;a href=&quot;https://nextjs.org/docs&quot;&gt;https://nextjs.org/docs&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Cloudflare Pages 文档&lt;/strong&gt;：&lt;a href=&quot;https://developers.cloudflare.com/pages/&quot;&gt;https://developers.cloudflare.com/pages/&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;下一步计划&lt;a href=&quot;#下一步计划&quot;&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;✅ 添加了 Giscus 评论系统&lt;/li&gt;
&lt;li&gt;✅ 做了 TimeMark 生日提醒系统（我的第一个 Docker 项目！）&lt;/li&gt;
&lt;li&gt;✅ 添加了 11 个新功能（进度条、系列导航、Sandpack、OG 图片等）&lt;/li&gt;
&lt;li&gt;✅ 完成了液态玻璃 UI 改造&lt;/li&gt;
&lt;li&gt;✅ 修复了中文标签 404 问题&lt;/li&gt;
&lt;li&gt;✅ 代码规范化重构&lt;/li&gt;
&lt;li&gt;✅ 完成 v2.0 全站增强（50+ 项改进，15 个 MDX 组件，Pagefind 搜索）&lt;/li&gt;
&lt;li&gt;📝 持续写文章，记录学习&lt;/li&gt;
&lt;li&gt;🎨 继续打磨液态玻璃细节&lt;/li&gt;
&lt;li&gt;🚀 探索更多有趣的项目&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;加油！💪&lt;/p&gt;</content:encoded><category>category:笔记</category><category>category:开发之旅</category><category>tag:技术</category><category>tag:成长</category><category>tag:Next.js</category><category>tag:Cloudflare</category><category>tag:前端</category><category>tag:性能优化</category><category>tag:液态玻璃</category></item></channel></rss>