changelog.md
资源 · 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_level 0、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