资源 · RESOURCE
更新记录 Changelog
当前 v0.11.0(2026-11-16)。本仓库是设计系统的唯一源头;消费方锁版本使用,不执行升级命令就不会跟随变动。
版本与升级
样式与组件的原稿在本仓库。消费方(课程站 edu.zhaozimin,以及任何引用 zzm.css 的站点)锁定一个版本:
- 锁版本引用:
https://ui.zhaozimin.com/v/0.11.0/zzm.css——本仓库之后再改,这个地址的内容永不变动。 - 不锁版本的
/zzm.css永远指向最新,只建议自己预览时用。 - 代码级消费方在自己仓库里跑一次升级命令才会变:
npm run ds:upgrade -- v0.11.0。不跑,永远停在旧版本。
版本号语义:改令牌、改组件行为、删接口 → 次版本号(0.x);只补文档、修文案 → 修订号。
v0.11.0 · 2026-11-16
次要文字灰阶加深,小字看得清,三档层次保留。
- 浅色:
--zzm-muted#8B8B85 → #71716C(对比度 3.2 → 4.5,达小字标准);--zzm-muted-2#A2A29C → #82827D(2.4 → 3.6);--zzm-muted-3#B0B0AA → #8F8F8A(2.0 → 3.0,达大字与装饰文字标准)。 - 深色:
--zzm-muted-2#77766F → #85847C(3.7 → 4.5);--zzm-muted-3#6A6964 → #77766F(3.1 → 3.7);--zzm-muted原本就达标,不变。 - 对比度按白底与纸面(深色按卡片面与画布)中较差的一侧计算。文档页样张里的同名字面值一并更新。
v0.10.0 · 2026-11-16
触屏点按区:手机和平板上的小键更容易点中。
controls.css:粗指针设备(pointer: coarse)上,28px 小键(.zzm-btn--sm,含图标键)用透明::after向四周各扩 8px,点按区约 44px;忙碌态的反光层不受影响。Breadcrumb:可点项上下内距 12px、外距 -8px 抵消——占位仍是 28px,点按区 44px(项自身要省略号裁剪,伪元素扩区会被裁掉,所以用内距)。- 键面尺寸、颜色和电脑上的行为都不变。
v0.9.0 · 2026-10-18
催更键独占敬请期待罩,催过之前不显示人数。
SoonVeil:传remind时罩里只放催更键,不再叠「敬请期待」签;不传remind时仍显示签(罩里不会空着)。- 人数:键上与悬停提示都不再带人数;
mine为真时才显示「✓ 已催更 · N 人」。 - 已催更改用描边胶囊(与签同一种非交互徽章),高度与对应的键相同(28 / 36),点完原地换形不跳。
controls.css:删去.zzm-soon__count;.zzm-soon__voted改为胶囊样式。
v0.8.0 · 2026-10-17
敬请期待罩收成一个组件,并可放催更键。
- 新增组件
components/v4/SoonVeil:「敬请期待」罩的单一真相源(lg大画面版、title、remind)。课节卡、课程卡改用它;课程站的导学封面、学习地图舞台、课时页海报、收藏卡同步改用它,不再手写罩的结构。 - 催更键:传
remind={{ count, mine, failed, onRemind }}时签下多一个朱键「催更」,有人催过时键尾带人数;点击不冒泡,卡片与海报照旧不可点。mine为真换成一行白字「✓ 已催更 · N 人」,failed为真键上写「催更失败,重试」。一人一票与能否催更由消费方服务端判定。 LessonCard/CourseCard新增remind属性(只在敬请期待态生效)。controls.css:.zzm-soon改为竖排居中(gap 8,大画面 12);新增.zzm-soon__remind、.zzm-soon__count、.zzm-soon__voted。不传remind时外观与 v0.7.0 一致。
v0.7.0 · 2026-10-16
课程卡的敬请期待:没开放的课不可点。
- 新增判定
domain/v4/lessonSoon.js的isCourseSoon(course):course.open === false即敬请期待,字段缺失当作已开放。课程站后台每门课新增「开放」开关,分类目录下发is_open。 - 课程卡
CourseCard新增敬请期待态,由数据决定、无需新属性:头图盖.zzm-soon罩 +「敬请期待」签(与课节卡同一原件),整卡不调onClick、不挂悬停、光标默认、aria-disabled,脚注动作换成灰字「敬请期待」。
v0.6.2 · 2026-10-16
修复:没有封面又没有视频的课节卡,课名与「敬请期待」签压成两行字。
LessonCard敬请期待态下,无封面兜底面只留星座线稿,不再叠短标题与朱色识别线;课名在卡片下方照常显示。有封面的卡不受影响。
v0.6.1 · 2026-10-16
文档修订:课节卡「敬请期待」样张改用无封面兜底面。
- 文档站的样张是静态渲染,
CoverImage停在加载态,演示封面图不会出现,样张看上去是一块黑底。改为与其他样张一致的无封面兜底面:罩下的课名照样看得清。组件与样式代码无变化。
v0.6.0 · 2026-10-15
敬请期待:还没有视频的课节不可点。
- 新增判定
domain/v4/lessonSoon.js的isSoon(a):课节行has_video === false即敬请期待。字段缺失一律当作有视频,宁可放行也不误锁已上线的课。课程站的安全目录接口同步下发这个布尔值(不下发视频 ID 本身)。 - 课节卡
LessonCard新增敬请期待态,由数据决定、无需新属性:封面盖半透明黑罩(.5,比锁罩 .7 浅一档,封面仍看得清)+ 居中「敬请期待」描边签;整卡不调onClick、不预取播放凭证、aria-disabled;先于锁罩显示。 - 新增类(
controls.css):.zzm-soon罩、.zzm-soon__tag签、.zzm-soon--lg大画面版(导学封面、播放舞台)、.zzm-cardlink--soon(撤掉悬停上浮、描边高亮与柔影,光标为默认)。签用白字白线,不用朱色——朱色在本站表示「可以行动」。
v0.5.1 · 2026-10-13
文档修订:导学封面改为 16:9。
- 课程站导学课封面由 4:3 改为与课节封面同比例的 16:9(系列页导学视频位、学习地图导学舞台、后台上传裁切同步)。「视频播放键」页的导学封面样张随之改为 16:9,仍是 contain 完整展示、不裁切。组件与样式代码无变化。
v0.5.0 · 2026-10-13
笔记列表修复与任务列表;课节卡新增播放中态。
- 列表符号由组件写明:
MarkdownNotes的无序列表随层级 disc → circle → square,有序列表 decimal。此前依赖宿主默认样式,课程站的 Tailwind 基础层把list-style清成 none,圆点与序号整体消失。 - 列表解析(
lib/markdown):有序列表记住首条序号(5.起编从 5 开始,AST 带start);条目间的空行不再切断列表(此前每段从 1 重新编号);缩进续行与懒续行并入条目正文;缩进更深的行(子列表、代码块、标注块、隔空行的段落)按条目正文起始列去缩进后归属条目——tab 缩进的代码块不再把列表截断成字面文字。 - 任务列表
- [ ]/- [x]:条目新增task(null / false / true)。任务框沿用复选框的语言(16px、圆角 4、已勾墨底白勾),只读;无序里替代圆点,有序里跟在序号后;已完成划线弱化。只认空格与 x/X,[/]、[1]等保留原文。 - 课节卡
LessonCard新增current(朱环 +「▶ 播放中」,类.zzm-cardlink--current)与desc(false 去简介脚注),供课程站视频页目录改用大卡片。
v0.4.0 · 2026-10-13
笔记代码块一键复制。
MarkdownNotes的围栏代码块右上角恒有复制键(Btn纸键 sm 方形,Copy 图标)。复制的是解析出的原文,缩进逐字不变;点后显示「已复制」2 秒,失败显示「复制失败,重试」,与课程站学习地图的提示词复制键同一套话术。- 复制键是
<pre>的兄弟元素:代码横向滚动时它钉在右上角;代码区右内距让出键宽,长首行滚到最右时末尾不被压住。 - 新增依赖
lib/clipboard.js(copyText(text) → Promise<boolean>):Clipboard API 被拒时回退 execCommand,覆盖微信等内置浏览器。它原是课程站的私有工具,现在归设计系统,课程站升级后该文件改由本仓库锁定。
v0.3.2 · 2026-10-06
课时档位文案。
- 课时 0 档(
required_level0、1)的胶囊文案由「免费」改为**「体验」**:课程站引入学员等级后,每个系列的前几节只对体验学员及以上开放,「免费」已与事实不符。配色与令牌名--zzm-tier-free*不变,消费方无需改代码。 - 课节卡的「试看」角标、B 站公开片的「免费」角标语义不变。
v0.3.1 · 2026-10-05
深色主题补齐消费方用到的令牌。
- 深色展台
--zzm-dark-panel:推荐方案卡这类两套主题都保持深色的大面;深色下压到比卡面更深,靠朱色徽标与描边区分,不翻成浅色以免夜里成为光源。 - 插图灰阶
--zzm-wash-1…--zzm-wash-5:示意图里的屏幕底、侧栏与文字条,深色下按同样的明暗顺序反向排列。 - 成功字色
--zzm-ok-ink、宋体栈--zzm-serif(会员、社群等礼仪性页面的题名)。
v0.3.0 · 2026-10-05
深色主题:夜间护眼的第二套颜色。
- 令牌分两套:浅色写在
:root, [data-theme="light"],深色写在[data-theme="dark"]。消费方在外壳根上写data-theme即切换;任何子树写data-theme="light"整块回到浅色(例如付款二维码所在的白色收银卡)。 - 深色不是反相:每个令牌按它在界面里的角色单独定值——纸面深暖灰、卡面高一档、正文浅墨而非纯白;墨键翻成浅瓷键仍是全屏最重的键;封面、付款页这类本来就深的暗底只微调到能与纸面区分。移除旧的整树
invert反相。 - 新增令牌:朱字
--zzm-accent-ink(深色下提亮)及朱色三档面线、浮层--zzm-surface-2、墨底字--zzm-on-ink、中性填充--zzm-chip/fill/fill-2/fill-lite、悬停描边--zzm-line-hover、遮罩、输入槽、学习热力四档,以及微拟物材质令牌(纸键/墨键的面色渐变与投影组、卡片与浮层投影、聚焦光晕)。 controls.css、base.css与课程卡、课时卡、系列卡、面包屑、笔记渲染改为只引用令牌;光照模型(层数与方向)两套一致。文字灰阶在深色下逐级保持对比度不低于浅色同档。- 文档的令牌表与
tokens.json(com.zhaozimin.dark扩展)同时给出浅色与深色值。
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