---
title: 更新记录 Changelog
url: https://ui.zhaozimin.com/resources/changelog/
markdown: https://ui.zhaozimin.com/resources/changelog.md
group: 资源
origin: 规范文档
version: v0.2.0  # 设计系统版本，发布于 2026-09-23
scope: .zzm-v4   # 根节点必须带这个类，否则样式不生效
css: https://ui.zhaozimin.com/v/0.2.0/zzm.css   # 锁版本地址，本仓库再改也不影响你
---

# 更新记录 Changelog

> 当前 v0.2.0（2026-09-23）。本仓库是设计系统的唯一源头；消费方锁版本使用，不执行升级命令就不会跟随变动。

## 版本与升级

样式与组件的**原稿在本仓库**。消费方（课程站 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）；只补文档、修文案 → 修订号。

## v0.2.0 · 2026-09-23

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

- 此前 `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` 守门。

## v0.1.1 · 2026-09-23

双站上线。

- **国际站** `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` 决定是否挂备案。

## v0.1.0 · 2026-09-22

首版。

- 从课程站 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 爬虫。

## 怎么发一个新版本

```bash
# 1. 改设计系统源码（src/system 或 src/extracted）
# 2. 加/改对应的文档页（src/content），必要时在 src/lib/nav.js 登记
npm run verify            # 清单一致 → 8pt 审计 → 构建 → 出厂检验
npm version minor         # 或 patch
npm run release           # 重算清单、冻结 /v/<版本>/ 产物、打 tag
git push && git push --tags
```

---

上一页：[勋章与下载](https://ui.zhaozimin.com/resources/assets.md) · 下一页：无 · 全站目录：https://ui.zhaozimin.com/llms.txt