更新记录 Changelog

样式与组件的原稿在本仓库。消费方（课程站 edu.zhaozimin，以及任何引用 zzm.css 的站点）锁定一个版本：

• 锁版本引用：https://ui.zhaozimin.com/v/0.2.0/zzm.css——本仓库之后再改，这个地址的内容永不变动。
• 不锁版本的 /zzm.css 永远指向最新，只建议自己预览时用。
• 代码级消费方在自己仓库里跑一次升级命令才会变：npm run ds:upgrade -- v0.2.0。不跑，永远停在旧版本。

版本号语义：改令牌、改组件行为、删接口 → 次版本号（0.x）；只补文档、修文案 → 修订号。

主权转移：本仓库成为设计系统的唯一源头。

• 此前 src/system/ 是课程站 edu.zhaozimin 的只读快照，源头在那边。现在反过来：原稿在这里，edu 成为第一个消费者。
• 消费方通过 ds:upgrade 按版本拉取，落点与指纹记在对方仓库的 design-system.lock.json 里。改设计系统不会波及任何站点，除非对方显式升级。
• 新增锁版本产物：/v/<版本>/zzm.css、zzm.global.css、tokens.json、DESIGN.md——发布过的版本永久冻结。
• 源码清单 /src/system/manifest.json 重写：记录版本、每个源文件的 sha256 与消费方落点；npm run manifest 生成、npm run check:manifest 守门。

双站上线。

• 国际站 ui.zhaozimin.com：Cloudflare Pages，推送 main 自动构建发布。
• 大陆站 ui.zhaozimin.cn：阿里云 1Panel 静态站，GitHub Actions 推送自动发布，约 40 秒到位；页脚挂 ICP 与公安备案（备案按域名，国际站不挂）。
• 产物改为目录式输出：/components/button/ 而不是 /components/button → button.html。文件式输出依赖「访问 /x 自动找 x.html」这一平台特性，Cloudflare 支持而 nginx 不支持；改完之后同一份产物放在任何静态服务器上都成立。
• 同一份代码发两套站：构建期 SITE_ORIGIN 决定站内绝对地址，SITE_REGION=cn 决定是否挂备案。

首版。

• 从课程站 edu.zhaozimin v23.5.1（086937d）把 v4「纸·墨·朱」的四份样式、SPACING.md、12 个组件、5 个逻辑依赖与资源逐字取出，作为设计系统的起点。
• 提炼：把 edu 后台设计系统页里只以 inline 样张存在的开关、复选框、标签页、分页、轻提示、进度条、数据表格、验证外壳整理成正式组件。
• 改造：确认窗原先依赖 shadcn 与 Tailwind，这里保留同一 API 与 .zzm-dialog-* 皮肤，用纯 CSS 补齐定位，去掉两层依赖。
• 新增：宿主基线 baseline.css——把组件依赖的 Tailwind preflight 子集与减少动效规则单独拿出来，使组件脱离原宿主也能 1:1 成立。
• 机读层：每页 .md、llms.txt、llms-full.txt、DESIGN.md、tokens.json、zzm.css、zzm.global.css、源码直读、robots 全面放行 AI 爬虫。