工具 USES
用到的东西
其实就这几样.
这个网站的全部工具链。左边是名字，右边是它在这里负责什么。最后有一节"刻意不用"，那部分和用了什么同样重要。
页面本身
HTML / CSS / JavaScript
本站的页面技术。与 AI 协作维护，使用静态 HTML、CSS 和 JavaScript。
Markdown
文章与笔记的写作格式。写完不用管排版，交给生成脚本。
内联 SVG
首页的光线图形与工具示意直接嵌入页面，不额外请求图片。
系统等宽字体
Cascadia Code / Consolas。署名必须用等宽——不然数字 0 会被看成字母 o。
生成与预览
Python 3
跑在一个 conda 环境里。只用来做生成和检查，不参与网站运行。
markdown-it-py + PyYAML
把
*.md 和 front matter 渲染成页面。tools/build_blog.py 一次产出博客、笔记、sitemap 与 RSS。
tools/serve.py
本地预览服务器。它按 Cloudflare Pages 的规则解析没有后缀的地址，本地和线上表现一致。
Pillow
生成 1200×630 的社交分享图，以及压头像。
质量检查
pytest
验收测试入口，用于检查内容链接、主题、布局与键盘操作。
Playwright
独立无头浏览器。盯 320 到 1440 的布局、200% 文字缩放、键盘操作、关掉脚本还能不能读、站内死链。
WCAG 对比度
读计算样式算真实比值，不靠肉眼判断。可以在实验室里自己试。
发布与域名
Cloudflare Pages
免费托管，自动 HTTPS，全球分发。只发布
public/ 这一个目录。
wrangler
一条命令发布，十秒左右生效。改网站不需要打开控制台。
Cloudflare DNS
解析托管在这里，橙云代理开着。
华为云
只负责域名注册与实名，2027 年 6 月到期。
Git Bash / PowerShell
日常两条命令的路径不同，部署命令在两种终端里都写了。
刻意不用
前端框架
这个体量的页面，框架带来的复杂度大于收益。
CMS 与数据库
内容就是仓库里的 Markdown 文件，不需要后台。
远程字体与 CDN 依赖
页面不向第三方要资源，测试里有一条专门盯着这件事。
访问统计
目前没有统计脚本。要看数据的话，只会考虑不带 cookie 的方案。