# Changelog · POSX Design System

遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/) 与语义化版本。

## [2.2.0-r6] - 2026-08-02 · 线下物料库 + 返利领取流程

### 新增
- **线下物料库**（`01-brand/expressions/materials/`，生成器 `gen_materials.py`）：8 件可印刷矢量基准稿——收银台桌卡 A6（148×105mm）、货架条（180×40mm）、橱窗横幅（600×80mm 深底白标）、门贴（80×80mm）、圆形橱窗贴（⌀90mm）、POS 待机屏（480×800px，Brand Core 渐变 + 金色价值时刻）、员工胸章（⌀76mm 只用 Mark）、Premium 会员卡（85.6×54mm 烫金基准）。真实物理尺寸标注、文字曲线化、内嵌真实二维码（npm qrcode 生成）。
- **返利领取流程标准**（规范 §9）：三路径决策——A 已绑定自动入账（deep link `posx://rewards` + universal link 回退）/ B 桌面扫码（claim token 30 天）/ C 手机一键跳转（deferred deep link 附带待领返利）；状态机 earned→pending(30d)→claimed/expired；六条体验红线（先见金额后引导、领取 ≤1 步、中性倒计时、状态不只靠色、金紫不混用、动画 ≤1.2s）。
- **站点 `/expressions` 新增两区块**（7 语言）：「07 返利领取流程」含 **Web 端领取模块演示**（已绑定/新用户双态切换、真二维码、deep link toast）与 **App 端手机框演示**（锁屏推送 → 钱包 → 领取 → 余额 12.14→12.52 滚动动画）；「08 线下」新增物料库网格（8 件预览 + 尺寸 + SVG 下载）。
- Expressions Kit 扩至 87 文件（含 materials/）。

## [2.2.0-r5] - 2026-08-02 · 品牌衍生表达层（Expressions）

### 新增
- **`01-brand/expressions/` 衍生资产**（生成器 `gen_expressions.py`，文字全部 fontTools 曲线化 + POSX 字标真迹）：
  - Rewards by POSX 受理徽章 ×5 配色（Light/Navy/Purple/Mono×2/Premium）+ Compact ×2，PNG h24/h48/h96；
  - POSX Rewards 第一方项目锁定 ×2（默认 / VIP 金）；
  - 联合品牌双 Logo 锁定：模板（合作方占位区）+ 浅/深底示例（虚构 ACME）；
  - Earn Chip 价值层金色组件 ×2；`posx-expressions-kit.zip` 全量打包（66 文件）。
- **`expressions-guidelines.md` 规范**：命名标准（POSX Rewards vs Rewards by POSX）、紫金色彩决策与金色红线（浅底 700 / 深底 300 / 500 只画不写）、徽章规则、联名 7 条规则（X 模数体系）、线上/线下出现标准。
- **站点 `/expressions` 页**（7 语言）：全部规范可视化 + **可交互的线上支付返利演示**（结账 → POSX 支付 → 返利到账金色价值时刻；徽章 28px/距按钮 ≥8px/Intl 货币格式化/reduced-motion，演示本身即规范参照实现）+ 热敏小票实景 + 下载区。
- 后端：`/assets/expressions` 静态挂载 + 下载清单新增 expressions-kit / expressions-guidelines。

## [2.2.0-r4] - 2026-08-02 · 站点 i18n 七语言 + 多语言字体体系

### 新增
- **i18n 标准**（`06-website/I18N.md`）：7 语言（zh-CN 源语言 / zh-HK / en / es / pt / ko / ja），i18next 懒加载架构、回退链（zh-HK→zh-CN；其余→en→zh-CN）、键命名规范、内容分层（界面 chrome 全翻 vs 规范正文保持源语言）、`npm run i18n:check` 键集一致性门禁（已并入 build）。
- **全站迁移**：8 页面 + 共享组件共 9 命名空间 ×7 语言（约 580 键/语言），语言切换器（桌面 + 移动菜单）、`html[lang]` 同步。
- **多语言字体体系（04-fonts 扩展）**：zh-HK → **GenYoGothic TW（源樣黑體2）** R/M/B（OTF→woff2 转换）；ja → **IBM Plex Sans JP** 400/500/700；ko → **IBM Plex Sans KR（标题）+ Pretendard Variable（正文）** 组合；按 `html[lang]` 经 `--lang-cjk-head/body` 变量自动切换字体栈。字体总量 876 个 woff2 · 34.9MB，全部 OFL 本地自托管；`fetch_fonts.py` 支持 Google/jsDelivr/GitHub-OTF 三类来源一键重取。
- 站点补齐：移动端汉堡导航菜单、404 页。

### 变更
- 移除 Noto Sans HK/JP/KR（被上述指定字体取代）。

## [2.2.0-r3] - 2026-08-02 · 官方站点上线（06-website）

### 新增
- **前后端分离的官方站点**：Express + TypeScript 后端（REST API：tokens / 搜索 / 渐变 / 对比度 / 下载清单与计数 / 变更日志 / 反馈收集；`/assets/*` 实时托管设计系统真实文件）+ Vite + React 19 + Framer Motion 前端。
- 8 个页面：首页（动效 Hero + 六支柱 + 实时统计）、色彩标准（8 家族色阶墙 / 四季层 / 语义双主题表 / 渐变库 / 53 组对比度矩阵）、Design Tokens（三层架构 + 四种消费格式）、字体规范（真实字号 specimen）、品牌与 Logo（三版本展台 + Mark 衍生体系 + 误用禁例）、资源下载（分级徽标 + 下载计数 + 反馈表单）、AI 协作（llms.txt 预览 + 提示词模板复制）、更新日志（时间线）。
- 全站特性：⌘K token 搜索、深浅双主题、页面过渡动画（尊重 prefers-reduced-motion）、零硬编码色值（全站由 tokens.css 语义变量驱动）。
- 运行：`cd 06-website && npm install && npm run dev`（开发）；`npm run build && npm start`（生产单端口）。

## [2.2.0-r2] - 2026-08-02 · 工程化重构（token 值零变更）

> 本次不改任何色值，SemVer 视作同版本的工程修订。

### 新增
- **目录重构**：`01-brand / 02-foundations / 03-tokens / 04-fonts / 05-ai / 99-archive` 编号结构，根目录 `index.html` 门户 + `README.md` + `CHANGELOG.md`。
- **本地字体（04-fonts）**：Space Grotesk、Inter、Noto Sans SC、JetBrains Mono 全部自托管（130 个 woff2 变量字体切片 ≈5.2MB，含 OFL 许可证），`fonts.css` 一行引入，零 CDN 依赖。
- **字体规范**：`02-foundations/typography/typography-spec.md`（字阶 / 行高 / 中西文混排 / 金额等宽规则）。
- **品牌资产补齐（01-brand）**：mark-only 图标版 SVG×3、全套 PNG 导出（600/1200/2400w + mark 256/512/1024）、favicon 全家桶（自适应 favicon.svg、重制 favicon.ico、apple-touch-icon 180、PWA 192/512、maskable 512）、社交分享图 og-default.png（1200×630）、`brand-guidelines.md` 完整规范、干净命名重新打包的 `posx-logo-kit.zip`。
- **AI 协作层（05-ai）**：`llms.txt`、`design-system.ai.json` 单文件导入包、`AI-GUIDE.md`、3 个提示词模板、`exports/`（扁平 JSON / Tailwind preset / Figma Tokens Studio）。

### 修复（依据 11 智能体审计，全部经对抗复核确认）
- **P0** `favicon.ico` 内容错误（黑圆白三角占位图，非 POSX 标志）→ 由真实 mark 重新生成。
- **P0** 规范文件 `tokens.css` 缺失（仅存 Google Drive 冲突副本 `"tokens 2.css"`）→ 经逐字节比对确认无手改后更名归位至 `03-tokens/tokens.css`。
- **P0** logo 资产仅存 `" 2"/" 1"` 冲突副本命名、zip 内文件名脏 → 全部规范为 kebab-case 重制，原件归档。
- **P1** 展示页内嵌 CSS 缺 19 条声明（12 个季节短别名 + 4 条 deprecated 渐变别名 + 3 条 dark 覆盖）→ 已补齐。
- **P1** 展示页 Google Fonts CDN 阻塞渲染、3 处字重缺失导致伪粗体 → 改为本地变量字体（全字重真实渲染）。
- **P1** 展示页更名 `02-foundations/color/color-system.html`（原中文文件名不利于 URL/部署），补 favicon / theme-color / 深色模式 FOUC 修复。
- **P2** 展示页「9 个家族全阶色板」计数错误 → 修正为「8 个家族色板（Sand 为 legacy 6 阶）」。
- **P2** `build_tokens.py` 输出路径适配新目录（tokens → `03-tokens/`，spec → `02-foundations/color/`），已沙盒验证重跑输出与现存文件一致（仅日期行）。

### 已知问题（Roadmap 见 README）
- 展示页仍为手工维护（未纳入生成管线）；tokens.json 非 DTCG 标准格式；缺 spacing/motion/icon token；对比度未含 APCA 与 CVD 校验。

## [2.2.0] - 2026-07-20

- 渐变体系升级为四层 12 条（Signature / Atmospheric / Bio-Luminescence / Heritage），4 条旧渐变退役为 deprecated 别名。
- 新增 `--primary-hover` / `--gold` / `--teal` 语义槽；dark 涨跌色提亮（#34d399 / #f87171）。
- Layer 3 组件别名 20 个示例。

## [2.1.0] - 2026-07

- 新增 Cloud 家族 11 阶（PANTONE 11-4201 Cloud Dancer 锚点），接替 Sand 承担 60% 基座；Sand 降级为 legacy（50–500）。
- 新增 Seasonal 2026 四季趋势层（4 色 × 3 阶 + `--season-1…4` 语义槽）。

## [1.x] - 2026 上半年

- 初版：Navy/Purple/Sand 品牌色系、Signature 渐变（brand-core / aurora / gilded）。