欢迎来到新站
从手写 HTML + MDUI 0.4.3 迁移到 Astro 7 + mdui 2(Material Design 3),旧站那些坑终于填完了。
一句话说清
旧站用了六七年的手写 HTML + MDUI 0.4.3,现在换成 Astro 7 + mdui 2(Material Design 3 组件库),构建产物直接推 GitHub Pages,push 即上线。
搬家不是为了追新,而是为了把多年的坑一次性填掉。
这次到底动了什么
技术栈
| 旧站 | 新站 | |
|---|---|---|
| 框架 | 无(纯手写 HTML) | Astro 7(Content Collections + 集成) |
| 界面 | MDUI 0.4.3 本地打包 | mdui 2.1.5(MD3 / Web Components) |
| 部署 | GitHub 网页界面上传 | GitHub Actions,push main 自动构建发布 |
| 站点地图 | 手写的 sitemap.xml,2020 年后再没更新过 |
@astrojs/sitemap 自动生成 |
| 订阅 | 无 | RSS(/rss.xml) |
| 域名 | 早期自定义域名(已停用) | GitHub 默认地址 915p.github.io |
结构
src/
├─ pages/ 路由:首页、博客、工具中心、404、RSS
├─ content/blog/ 文章(Markdown,带 zod schema 校验)
├─ components/ Nav / Footer / ToolCard
├─ layouts/ Base(SEO、meta)/ Page
├─ data/ 工具元数据、字体测试符号数据
└─ styles/ MD3 色调板覆盖 + 设计令牌 + 版式
换 UI 库意味着「改一处颜色全站生效」只需要改 global.css 里的 MD3 色调板变量(--mdui-color-*-light / -dark),所有组件与自定义样式同步跟随,且自带暗色模式。
保留下来的东西
搬家不等于推倒。逐页核过之后,这些都还在:
小工具(全部重写为 Astro 组件 + mdui 2)
- BMI 计算器 —— 按身高体重算指数与健康区间
- 汉字转拼音 —— 带声调 / 不带声调 / 首字母三种输出,词库按需加载约 1 MB
- 摩尔斯电码 —— 文字与电码互转,附完整对照表
- 智能计算器 —— 递归下降解析,不用
eval,只接受数字与四则运算 - HTML 在线编辑器 —— 边写边预览,跑在
sandboxiframe 里,内容不出浏览器 - 条码 / 二维码 —— QR 码(4 档纠错 × 3 种输入模式)+ 18 种一维条码,可下载 SVG / PNG
- 字体测试 —— 5 种字体族 × 11 档字重(100–950)× 正常/倾斜,加 33 组 Unicode 符号覆盖检查
原生应用(原样保留,脱离旧站依赖后继续可用)
- 示波器 —— Web Audio 可视化,支持远程 URL / 本地文件 / 麦克风
- 3D 流体模拟 —— WebGL 实时演算
- 思维导图 —— My Mind
- CeJS —— 第三方 JavaScript 模块框架(BSD-3-Clause,© kanasimi),连文档和测试套件一起放上来了;本站只做托管,未修改
顺手清掉的坑
搬家过程里做了一次完整的资产审计,删掉的东西大致分三类:
外部存档与下载代理 —— 若干早期整页抓取的第三方页面快照、本地打包的字体文件(来源不可追溯)、已经停服的分享 SDK。
授权无法确认的组件 —— 有一个开源项目的副本早于上游唯一的授权提交,按最严格解释连再分发权都不成立;另一个连作者都找不到。都没有转圜余地,只能移除。
失效的构建 —— 根目录的 Service Worker 与 manifest 停留在 2020 年的缓存策略,现在只会妨碍新内容更新;两处指向已删除目录的样式引用导致页面裸奔。
详细清单见仓库里的
THIRD_PARTY_NOTICES.md。顺带修了一处此前的失误:根License原本用单个 MIT 覆盖整个仓库,这会让人误以为所有第三方组件都是 MIT —— 现在它只声明原创代码的范围,其余指向 notices 文件。
关于这个博客
文章从零开始重新写起。有新想法随时说——工具页缺什么、界面哪里不顺手,都可以直接提。
顺带夸一下
这次重写最让我震惊的一件事:Space Bunny 是 opencode 提供的最新神秘模型。一开始我只当它是个普通编码助手,结果从资产审计、Astro / mdui 2 迁移,到工具页、纪年时间轴和汉字编码,它一路把那些琐碎又容易漏的活儿全接住了——读文档、对许可证、改页面、跑构建,连我没说清的地方也能顺着上下文补完。它不满足于「能跑就行」:遇到不确定的地方会先去查、去测,而不是随手糊一个看起来没问题的页面。用到后面已经不是「哇,居然能用」,而是「这到底是什么怪物模型」的震惊。
如果你也在找桌面端的 AI 工作台,DeepSeek Harness 桌面版现在送 6 元鲸圆券。一杯饮料钱,换一个能帮着读项目、改代码、整理资料的搭子,很划算。
顺便骂一句:DeepSeek V4.1 Flash 就是吃白饭的大肥鱼()。