NOTE · 碎片

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

  • #Astro
  • #Cloudflare
  • #Keystatic
  • #建站
  • #开发笔记

热烈庆祝本站于2026年5月4日正式开通啦!今天,这个站正式开始运营、公开访问以及更新内容。

一部分的旧内容会随着站点同步更新加入到本站中,可能会暂时导致部分发布时间混乱,新消息被顶掉的问题。

——不过没关系!预计大约1-2周的持续更新后就能够恢复到正常的更新节奏,当前打算先推送+挂载几个老的课程设计,然后再同步毕设和画作之类的,为了内容显得不那么空,我会尽量均匀平铺地更新内容。

预计明天会推送两篇我之前写过的「理」分支里面的一些思辨和哲学讨论,今天已经把房日咲立绘发了,后续则是一些游戏内的文件,慢慢来。

从第一次打开 Figma 开始构思设计系统,到现在能在后台点 Create 然后几分钟后在 shiffon.net 看到文章,中间经历的事情比预期的多得多——但起码现在成功了,所以可以正式拿出来用了。

以下是部分技术栈以及碎碎念:


技术栈

层级技术备注
框架Astro 4.16锁定 4.x,不升。5/6 生态还没跟上
部署Cloudflare PagesGitHub push 自动触发,约 2–5 分钟更新
CMSKeystatic Cloud图形化后台,保存 = commit,不用碰 git
内容格式Markdoc (.mdoc)需要 @astrojs/markdoc 0.11.4,版本不对就炸
类型校验Zod schemaconfig.ts 是「宪法」,keystatic.config.ts 必须跟它对齐
交互层React 19 + @astrojs/react 4.4.2只给 Keystatic 后台用,版本锁死 4.x
域名shiffon.netCloudflare 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 世界观)。

这是理分区的第一篇。之后的技术笔记、项目记录、嵌入式开发的碎片都会放在这边。加油!五一快乐~