観測手帖,正式上线!预祝本站开站顺利!

热烈庆祝本站于2026年5月4日正式开通啦!今天,这个站正式开始运营、公开访问以及更新内容。
一部分的旧内容会随着站点同步更新加入到本站中,可能会暂时导致部分发布时间混乱,新消息被顶掉的问题。
——不过没关系!预计大约1-2周的持续更新后就能够恢复到正常的更新节奏,当前打算先推送+挂载几个老的课程设计,然后再同步毕设和画作之类的,为了内容显得不那么空,我会尽量均匀平铺地更新内容。
预计明天会推送两篇我之前写过的「理」分支里面的一些思辨和哲学讨论,今天已经把房日咲立绘发了,后续则是一些游戏内的文件,慢慢来。
从第一次打开 Figma 开始构思设计系统,到现在能在后台点 Create 然后几分钟后在 shiffon.net 看到文章,中间经历的事情比预期的多得多——但起码现在成功了,所以可以正式拿出来用了。
以下是部分技术栈以及碎碎念:
技术栈
| 层级 | 技术 | 备注 |
|---|---|---|
| 框架 | Astro 4.16 | 锁定 4.x,不升。5/6 生态还没跟上 |
| 部署 | Cloudflare Pages | GitHub push 自动触发,约 2–5 分钟更新 |
| CMS | Keystatic Cloud | 图形化后台,保存 = commit,不用碰 git |
| 内容格式 | Markdoc (.mdoc) | 需要 @astrojs/markdoc 0.11.4,版本不对就炸 |
| 类型校验 | Zod schema | config.ts 是「宪法」,keystatic.config.ts 必须跟它对齐 |
| 交互层 | React 19 + @astrojs/react 4.4.2 | 只给 Keystatic 后台用,版本锁死 4.x |
| 域名 | shiffon.net | Cloudflare Registrar |
整个 deploy chain 是:本地写代码 / 后台编辑 → GitHub main 分支 → Cloudflare Pages 自动 build → npm ci + npm run build → dist/ 上线。
为什么是这套组合
选 Astro 是因为它对静态内容友好,页面默认不带 JavaScript,性能好控制。我的站内容比交互多,这很合适。锁 4.x 是因为 5.x 升了 Vite 版本之后 @astrojs/react 还没跟上,不想踩那个坑。
Keystatic 是这套里面让我最满意的部分。它的后台直接把表单字段映射成 frontmatter,保存就自动 commit 到 GitHub,发文章完全不需要开终端。对于我这种「内容和代码都要自己维护」的个人站来说,这个体验比手写 markdown 再 push 要好得多。
Cloudflare Pages 是免费的,build 速度够用,CDN 也在上面,域名也在上面管。能少一个平台就少一个。
花了16美元买的域名(贵死了!)不过能用一年所以勉强容忍一下,只要别续费的时候涨价就行(笑)
内容分四个分区:理(技术工程)、遊(画作创作)、観(随笔)、西(Nishikaze 世界观)。
这是理分区的第一篇。之后的技术笔记、项目记录、嵌入式开发的碎片都会放在这边。加油!五一快乐~