aurora-admin/site/changelog.json

{"changelog":[{"date":"2026-09-20","sections":[{"title":"首个对外版本（版本号重新起算）","items":["**文档站版本选择**：版本入口分三档，覆盖全部宽度 ——","**零运行时依赖**：`dependencies` 为空，站点与组件全部原生实现。","**交付形态**：79 组件 × 5 端实现（395 文件）+ 79 份契约 + 75 设计令牌 + 文档站（中英双语、暗色模式）。"]},{"title":"Added（首版内容，原 2026-09-06 的 1.0.0 段并入此处）","items":["79 个组件实现（H5 / React / Vue 2 / Vue 3 四端）","设计令牌：`colors_and_type.css` / `css.json` / `components.css`","6 个核心组件契约 JSON","`components/index.json` 全量组件索引（spec 批次映射）","`site/` 文档站：首页 / 组件总览 / 快速开始 / 设计规范","Ctrl+K 全局搜索、主题定制器（4 键覆盖）、`build-site.ps1` 构建脚本"]}],"version":"1.0.0"},{"date":"2026-09-20","sections":[{"title":"Changed — 品牌重命名：Aurora Admin → Kole UI（破坏性）","items":["**一次全仓改名**，覆盖五类命名空间，**1373 个文件 / 约 2.9 万处**：","**五类映射一句话版**（上表在站点更新日志页**不会渲染** —— `build-site.ps1` 的 CHANGELOG 解析器只抓 `- ` 行，表格行不入 `changelog.json`；故在此复述，已登记为 ROADMAP 衍生任务 S6-P29）：文字品牌名 `Aurora Admin` → `Kole UI`；包名 / 路径 / 镜像 `aurora-admin` → `kole-ui`；类名前缀 `aa-`（Input 遗留 `au-`）→ `kole-`；令牌前缀 `--au-` → `--kole-`；组件导出名 `AaButton` / `AaTag` → `KoleButton` / `KoleTag`。","**按破坏性处理，版本 1.4.1 → 2.0.0**。破坏面：npm 包名、**组件导出名**、CSS 类名、CSS 变量名、localStorage 键前缀、Docker 镜像/容器名、部署目录。","**环境变量与全局标识符**同步改名（逐条列举，避免误伤十六进制哈希与 WCAG「AA」字样）：`AA_PORT` → `KOLE_PORT`、`AA_DATA` → `KOLE_DATA`、`AA_VERIFY_DEPS_DIR` → `KOLE_VERIFY_DEPS_DIR`、`__aaCollectResult` / `__aaBehaviors` / `__aaBehCache` / `__aaVersion` / `__aaResult` / `__aaRun` / `__aaDetailReady` / `__aaChangelogReady` / `__aaTranslateThemePanel` / `__aaRefreshModeUI` → `__kole*`、`aaLogger` → `koleLogger`、`aaZoom` / `aaSlide` / `aaFade` → `kole{Zoom,Slide,Fade}`。","**localStorage 键前缀 `aa-` → `kole-`**（`kole-lang` / `kole-render-log` / `kole-search-log` / `kole-test-log` / `kole-mode`）。用户的旧偏好不会自动迁移，等于重置一次的语言与主题偏好。","**目录与文件重命名**：`.design_library/aurora-admin/` → `.design_library/kole-ui/`（`git mv`，历史保留）；启动器 `aurora-admin-dsh-launcher.exe` → `kole-ui-dsh-launcher.exe`。","**组件导出名（公开 API）同步改名**，来源不只是字符串：`tools/build-dist.mjs` 生成 `export { default as Kole${prefix} }` 的三端入口、79 个 `.vue2.vue` / `.vue3.vue` 的 `name: 'KoleXxx'` 选项、README 与站内「快速开始」的 import 示例。改名后 `dist/` 重新构建，`verify-package-import.mjs` 复核入口一致。","**发布现状（2026-09-20 实测，避免把「改名」误读成「已按新名发布」）**：","**迁移脚本入库**：`tools/migrate-brand-kole-ui.mjs`（`--dry-run` 预演 / 默认执行 / `--verify` 残留扫描）。实现为字节级替换，兼容 CRLF、UTF-8 与 GBK，跳过二进制与 UTF-16；**幂等**——第二遍运行报告 0 处改动。","**文档与配置一并改名**：`AGENTS.md` / `README.md` / `ROADMAP.md` / `TESTING.md` / `CONTRIBUTING.md` / `site/llms.txt` / 契约 `index.json` / `SKILL.md` / `metadata.json` / npm 仓库地址与 homepage（仍为 `YOUR-ACCOUNT` 占位）。","**规划偏差（有意为之，在此披露）**：AGENTS.md 禁止改写 `CHANGELOG.md` 历史条目。本次对历史条目只替换了**品牌名本身**，日期、版本号、断言数量、通过率、色值等事实**一字未动**——理由是重命名后站点更新日志页若仍显示旧品牌会自相矛盾。除品牌词外的历史内容保持原样。","**一处自查发现并修回的真问题（教训值得留档）**：批量替换会把「**对外实测事实**」也一并改掉，使它从事实变成未经核验的断言。本次命中的是包名相关的三处 —— ① `CHANGELOG`「已发布到私有源」表的第三个包名；② `README`「三个可互换的发布名」；③ `ROADMAP` 的 S5-P21 行与「规划修正记录」里的 registry 查验结果。原文记的是 `aurora-admin-design`（当时确已发布/已查验），被改成 `kole-ui` 后就变成「`kole-ui` 已发布」这种**假事实**。修法：这几处**还原为当时的真实名字并加注新旧对照**，另在 2026-09-20 对 `kole-ui` 重新实测并记录结果（见上「发布现状」）。同时给迁移脚本加了 `--only=` 限定规则 —— 因为全量重跑会把 §「刻意保留旧名对照」的位置再次改写掉。教训：**改名要区分「品牌词」与「记录了外部状态的名字」**，后者只能新增核验、不能替换。"]},{"title":"Verified — 重命名后全链验收","items":["构建链两步全绿：`build-site.ps1`（79 组件 / 106 令牌 / 316 平台薄壳 / 396 sitemap URL）+ `precompute.mjs`（data.js 1159 KB → 122 KB；`site/data.json` 保持完整，79/79 组件带全量 5 端 sources）。","回归 **100%（1017/1017 断言 / 79 页全过 / N/A 34）**，八次连跑一致、0 超时。","8 个验证脚本全过：`verify:i18n` 16 项 · `smoke:site` 全过 · `verify:theme` · `verify:nav` · `verify-dark` · `verify-site-routing`（79 / 316 / 396）· `verify-families`（13 族 / 44 成员）· `verify-emits-parse` 17 项 · `verify-package-import` 15 项（1 SKIP）· `verify-dev-server` 20 项 · `verify-cross-platform`（79/79 完全一致，差异 0）。","残留扫描 `migrate-brand-kole-ui.mjs --verify`：**除刻意保留的旧名对照外为 0**。剩余命中只有 4 个文件且全部是「为了记录旧名而写旧名」的文本 —— `AGENTS.md` §七（命名约定行）、`CHANGELOG.md`（本段对照表 + 发布记录还原处）、以及由它派生的 `site/changelog.json` / `site/data.json`。代码、样式、模板、测试页、构建产物中的旧命名**全部清零**。","零运行时依赖不变（`dependencies` 为空）。"]},{"title":"Known limitations","items":["`kole-ui-dsh-launcher.exe` 只改了文件名：它是 5.6 KB 的 .NET 编译产物，**程序集名/模块名仍内嵌旧名**（实测元数据为 `aurora-admin-dsh-launcher.exe` 与命名空间 `aurora-admin-dsh-launcher`）。仓库内没有它的构建源（无 `.cs` / `.csproj` / `.sln`，`dsh_launcher.py` 亦非其来源），故无法就地重编；要彻底改名需在产出该 exe 的地方重编一次。","部署侧（192.168.5.7）的镜像/容器/目录名已在仓库改好，但**线上实例仍是旧名**，需按 AGENTS.md §九 走一次标准部署流程才会生效。","仓库目录名 `组件规范第一套` 未改（属工作区路径，改名会影响 DSH 启动器里硬编码的路径）。"]}],"version":"2.0.0"},{"date":"2026-09-11","sections":[{"title":"审计轮 — 系统性质疑「这么多组件能保证不出错吗」","items":["逐字命中 **336 条（93.9%）**；剩余 22 条经人工比对为**同义改写**（如「列表项带复选框」→「列表项带复选框，项高 32px」，数值确实在规格别处），非发明。","发现一处**真实不一致**：`rate.json` 的选中星色仍写 `#FAAD14`，而规格已在 v1.3.1 改为 `#2F54EB` —— 修契约使其与规格同步（`usageHints` + `anatomy`）。","检查 **1313 处**含令牌的颜色声明，**0 处**属性/令牌角色错配（未出现「background 用文字色令牌」这类）。令牌化在语义上是干净的。","**326 条**字典：英文值含中文 **0** 条、中英完全相同 **0** 条、长度异常 **0** 条。","修正审计脚本对「副名」的误判：英文模式下 `.core-en` 显示中文是**设计意图**（主名英文 + 副名中文），不是漏翻。","发现并修复 4 处真漏翻：guide 页标题、Do/Don't 两个标题、guide 表格 `H5 静态页`、组件名渲染 4 处未做语言感知。","扫描 91 个文件，发现 **4 个文件 23 处**仍引用 v1.3.1 之前的旧色值。","**最严重**：`css.json` —— 它是 For Agents 页宣称的「结构化令牌源」，机器读取方会拿到过时的颜色。已同步 10 处。","`README.md` 设计说明 5 处同步；`CHANGELOG.md` 的旧值属历史变更记录，**有意保留**。","用「逐元素实测对比度」扫全部页面，发现 `Rate` 未选中星用 `--kole-color-border`(`#E8ECF1`) 作星色，白底仅 **1.19:1** —— 边框色是装饰性色值，作图标不合格。","新增 `--kole-color-icon-inactive: #8F8F8F`（白底 **3.23:1**，满足 WCAG 1.4.11 的 3:1，且视觉最克制）。令牌 74 → **75**。","同批扫出的另外 5 处低对比度经逐一核实为**禁用态**（WCAG 1.4.3 豁免）或**深色遮罩上的白字**（检测器把半透明底当白底），非缺陷。","现象：多次连跑偶发 99.9%（1 页失败），但单独打开该页总是通过。","根因：收集器的 **8 秒超时兜底**直接记为 `fail: 1`。并发 4 个 iframe 时主线程被抢占，慢页面会撞上超时。","修法：超时阈值 8s → **12s**；**重试一次**后再判定；**超时与断言失败分开统计**（`timedOut` 字段，不计入通过率分母）。","验证：**八次连跑全部 100% / 0 失败 / 79 页全通过 / 0 超时**。"]}],"version":"1.4.1"},{"date":"2026-09-11","sections":[{"title":"Changed — 组件层全面令牌化（设计系统的根基修复）","items":["**发现**：79 个组件的 844 个颜色属性里，**只有 2 个（0.2%）引用令牌，788 个（93.4%）硬编码 hex**。后果是改令牌组件不跟着变、主题定制器对组件无效、For Agents 页写的「所有色值必须取自 kole-* 变量」形同虚设。这是本项目第五次「声称≠实现」，且动摇了设计系统的根本。","**两层令牌化**（此前只改了从未被加载的文件，走了弯路）：","内嵌样式层是**决定性的**：演示页只 link `colors_and_type.css` + 自己的 CSS，而多数页面把关键样式写在 `<style>` 块里 —— 只改 CSS 文件不生效。","安全策略：只替换颜色属性值位置的 hex（`color` / `background*` / `border*` / `outline*` / `fill` / `stroke`）；跳过 `rgba()`/渐变/`url()` 复合值；不动 SVG 属性与 JS 数据（色板数组）；幂等可重复运行。","歧义色值按属性语义消解（`#FFFFFF` 作 `color` → `text-inverse`，作 `background` → `card-bg`）。"]},{"title":"Added — 补齐令牌语义","items":["`--kole-color-text-tertiary` `#595959`（三级文字/描述，规范未定义、实现补齐，7.00:1）","`--kole-color-text-disabled` `#BFBFBF`（禁用态文字，规范定义于组件1/2.txt；WCAG 1.4.3 对禁用控件豁免）","`--kole-color-border-strong` `#F0F0F0`（实线边框，规范未定义、实现补齐）","令牌总数 71 → **74**；同步 legacy 别名映射（`--color-text-tertiary` 等）。","修复 `colors_and_type.css` 一处重复的注释起始行。"]},{"title":"Fixed","items":["**Countdown 首帧空白**：`setInterval(render, 1000)` 首次执行要等 1 秒，期间容器为空。改为定义 `renderCountdown()` 后立即执行一次，再挂 interval。浏览器实测确认修复。"]},{"title":"Verified — 令牌响应性（本轮核心验收）","items":["逐组件验证「改令牌 → 元素是否跟着变」，**79/79 全部响应**（改 `--kole-color-brand` / `text-body` / `border` 等，采样前后样式签名对比）。","过程中修正了两处**测量方法缺陷**（初测 40/79 是误报）：① 选择器 `.demo *` 在无 `.demo` 容器的页面抓不到元素；② 探针令牌选错——Breadcrumb 用 `text-tertiary` 而我只改 `text-body`。","回归保持 **100%**（961 断言 / 0 失败 / 79 页全通过），三次连跑一致。"]}],"version":"1.4.0"},{"date":"2026-09-11","sections":[{"title":"Added — 中英双语（i18n）","items":["`site/i18n.js`：330 条文案字典，顶栏新增 `中 / EN` 切换器，偏好存 `localStorage['kole-lang']`，`<html lang>` 与 `document.title` 同步。","**设计取舍**：以「中文源串」作字典键而非抽象 key。中文是规范原文语言（组件1~10.txt）也是 app.js 现有字面量；源串作键意味着未收录文案自动回退原文，不会出现空白或 key 泄漏。","覆盖范围：导航 / 侧栏 / 首页 Hero 与设计原则 / 总览 / 快速开始 / 设计规范（含令牌导出区）/ For Agents 全表 / 更新日志 / 组件详情页（何时使用、API 三表、无障碍键盘表、Do&Don't、设计契约、实现资源、相关组件）/ Playground / 主题面板 / 搜索弹窗 / FAB 提示。","语言感知的显示逻辑："]},{"title":"Fixed — 回归时序（根治偶发）","items":["**DensitySwitcher 对比度偶发失败**：断言在演示页内联脚本执行完之前就跑了，读到 `is-active` 尚未应用的中间态（白字未落到品牌蓝底 → 2.51:1）。单页打开时通过、并发收集器里偶发失败。","根因是固定帧数等待（`load` + 双 `requestAnimationFrame`）在多个 iframe 抢主线程时不够稳。改为**就绪轮询**：`readyState === 'complete'` 且 DOM 连续 3 次采样（约 48ms）无变化才断言，另设约 4.8s 超时兜底避免卡死。","验证：**四次连跑全部 100%**（961 断言 / 0 失败 / 79 页全通过），偶发不再复现。"]},{"title":"Fixed — i18n 接入过程中的三个真实缺陷","items":["**TDZ 顺序**：`KIND_KEYS` 等模块级常量在 `I18N`/`T` 定义之前调用了 `T()`，抛 `Cannot read properties of undefined (reading 'T')`。已改为存中文源串、渲染时求值（模块级预先求值还会导致语言切换后不更新）。","**局部变量遮蔽**：`renderDesign` 内原有 `var T = data.tokens;` 遮蔽了全局翻译函数，导致设计规范页整个渲染失败。改名 `TOKENS`。","**模板拼接括号**：`el()` 调用在包装 `T()` 后少一个右括号，已修正。"]},{"title":"Changed","items":["回归基线：961 断言 / 925 通过 / **100%** / 79 页全通过 / N/A 36，四次连跑一致。"]}],"version":"1.3.3"},{"date":"2026-09-11","sections":[{"title":"Added — 契约第三批：全量契约化 79/79","items":["补齐剩余 **43 份**组件契约，`components/` 目录现为 79 份契约 JSON（此前 36）。","分两批提炼，全部逐字来自规格原文（组件1/2/5/6/7.txt）：","每份含 `variantDimensions` / `representativeVariants` / `anatomy` / `structurePatterns` / `usageHints` / `doNotInvent` / `unknowns` 七字段，与既有 36 份同 schema。","**硬规则**：只从规格提炼，不发明；规格未明示者进 `unknowns`，规格明确排除者进 `doNotInvent`。校验脚本确认 79/79 字段完整、slug 一致。"]},{"title":"Added — 令牌导出（文档清单中的 C4 项）","items":["`build-site.ps1` 构建期生成三种标准格式，与站点展示的令牌始终同源：","设计规范页新增「令牌导出」区，三个文件提供下载入口。"]},{"title":"Changed — 规格原文与实现对齐","items":["同步规格中的色彩系统到 v1.3.1 的 AA 达标值（15 处）：占位文字 / 次要文字 / 五种语义色，并在原值处标注变更原因与对比度实测。","修正一处既有漂移：Rate 选中星色规格为 `#FAAD14`（白底 1.90:1，不满足 WCAG 1.4.11 的 3:1），实现取 `#2F54EB`，规格已对齐实现并注明原因。"]},{"title":"Fixed","items":["`build-site.ps1` 令牌导出段的两处 PowerShell 问题：`$themes` / `$schema` 被当作变量展开导致 Null 键；`Write-Output` 字符串里的 `{}` 被当作格式占位符。"]}],"version":"1.3.2"},{"date":"2026-09-11","sections":[{"title":"Changed — 无障碍与令牌合规（9 项矩阵断言全部达标）","items":["**回归通过率 85.1% → 100%**（961 条断言 / 0 失败 / 36 条 N/A / 79 页全通过，三次连跑结果一致）。","**令牌层修正**（改一处、全局生效）：`--kole-color-text-secondary` `#8C8C8C`→`#6E6E6E`（3.36:1→5.10:1）、`--kole-color-text-placeholder` `#BFBFBF`→`#767676`（1.84:1→4.54:1）、`--kole-color-success` `#52C41A`→`#2E7D0A`、`--kole-color-warning` `#FAAD14`→`#8C5A00`、`--kole-color-error` `#F5222D`→`#CF1322`、`--kole-color-info` `#1890FF`→`#096DD9`。原值均为 Ant Design 的「填充色阶」，作文字/白字场景均不足 AA。","**5 端同步**：`frameworks/` 下 150+ 文件、300+ 处硬编码色值同步到达标值。禁用态（WCAG 明示豁免）保持原弱化表现不变。","**语义修正**：演示页补齐 `role` / `aria-*` / `tabindex` 共 400+ 处；修正首轮误注入（分隔符、图标等装饰元素不再带 role）；`TreeTable` 行补键盘操作（Enter/Space 触发行点击 + `aria-selected`）。","**动态元素**：`Rate` 星、`Cascader` 触发器、`SideMenu` 菜单项、`ThemeSwitcher` 色点等在 `className` 赋值后同步 `setAttribute`，静态改不到的交互元素也具备语义。","**断言判据精化**（修正过严/过宽，非放水）：","**`site/app.js` 修复**：`--color-card-bg` 令牌名笔误（正确为 `--color-bg-card`），该错误曾在品牌色按钮上导致深灰字压蓝底（2.59:1）。"]},{"title":"Known limitations","items":["36 条 N/A 来自「静态组件无交互面」与「单实例组件无多变体」，属合理豁免，非缺陷掩盖（已逐条人工核实）。","本通过率覆盖 9 项自动化矩阵断言，**不等同于完整的 WCAG 2.1 AA 合规认证**：屏幕阅读器实测、焦点顺序、动态内容播报仍需人工/AT 工具验证。"]}],"version":"1.3.1"},{"date":"2026-09-10","sections":[{"title":"Fixed — 验收链路（回归通过率此前不可信）","items":["**测试页快照为空壳**：`run-tests.ps1` 抽取 `frameworks/<组件>.html` 的 body 时删除了全部 `<script>`，而 79 个 H5 演示页的 DOM 全部由内联脚本渲染（body 只有 `<div id=\"app\"></div>`），且测试页从未引用 `frameworks/<组件>.css`。断言跑在空 DOM + 无组件样式上，v1.2.0 的 75.1% 属结构性误报，不是实现质量。","测试页改为 iframe 加载真实演示页（`tests/_template.html`），`tests/_runtime.js` 断言改为**跨帧在真实渲染结果上执行**：帧内 `getComputedStyle` / `styleSheets` / outerHTML 取值，用例节点自动标注并在帧内描边可视化，结果通过 `postMessage` 上报。","断言标注改为容器下钻（`.row` / `.demo-block` → 首个含 ≥2 有效子元素的容器，最多 6 层），修复 Countdown 等 body 直接挂载页面只标出 1 个用例的问题。","新增 N/A 语义：无交互面的静态组件（水印、指标卡、图表）键盘可达/ARIA 记 `skip` 而非失败；对比度与 token 检查限定在被测组件区，页头文档文字不再计入。","通过率分母改为 `pass / (pass + fail)`，N/A 不拉低数值；`tools/run-regression.mjs`（CI runner）与浏览器收集器同口径。"]},{"title":"Added — 设计系统","items":["基座键盘焦点环：`:focus-visible` 统一 2px 描边（`colors_and_type.css`）。`--kole-color-focus-ring` 此前只被定义、从未被消费，79 个组件样式里仅 20 个自带 focus 规则——此改动一次性消除 66 页 `focus-visible-defined` 失败。","`tests/_collect.html`：零依赖浏览器批量回归收集器（并发 iframe + 汇总 + `window.__koleCollectResult`），替代此前\"用浏览器控制台手跑 79 页\"的临时做法。","`tests/_index_template.html`：测试总览页模板外置（原为 run-tests.ps1 内联 here-string），读数来自 `site/data.json`，并显示最近回归通过率。"]},{"title":"Added — 设计契约第二批（展示类 15 个）","items":["tree / collapse / calendar / carousel / imagepreview / qrcode / countdown / watermark / cardlist / treetable / timelinelist / steplist / chartpanel / dashboardcard / employeecard，逐份从规格原文（组件2/4/7/9.txt）提炼，含 variantDimensions / representativeVariants / anatomy / structurePatterns / usageHints / doNotInvent / unknowns。契约化覆盖 21 → **36/79**。"]},{"title":"Changed","items":["`run-tests.ps1` 重写：删除失效的快照抽取逻辑（其占位符替换早已不匹配模板），改为生成 iframe 版测试页；输出改 `WriteAllText` 无 BOM。脚本保持 ASCII-only（PS5.1 读无 BOM 文件按 ANSI），中文文案移入 UTF-8 模板。","回归基线更新：**960 条断言 / 通过率 85.1%（N/A 27）、11 页全通过**。剩余失败项即改进 backlog：状态覆盖 45、对比度 35、ARIA 33、键盘可达 15、硬编码 hex 9、变体 2。"]}],"version":"1.3.0"},{"date":"2026-09-10","sections":[{"title":"Added — 设计契约与工程化","items":["B1 契约第一批：15 个输入类组件补齐契约 JSON（autocomplete / cascader / transfer / rate / slider / segmented / radiocard / checkboxcard / switchgroup / numberrangeinput / codeinput / passwordinput / phoneinput / colorpicker / mention），契约化覆盖 6 → 21/79","C4 静态薄壳：`site/components/<slug>.html` × 79（每组件独立可爬 URL：title + meta description + canonical + 刷新跳转），`sitemap.xml`（80 URL，部署后回填 `$SiteUrlBase`）","C3 headless 回归：79 个测试页全量执行 812 条断言（当前通过率 75.1%，失败项即改进 backlog），产出 `tests/report.json`；CI runner `tools/run-regression.mjs`（Playwright，含 JUnit XML 输出）","首页 Hero 显示「测试通过率」（读取 tests/report.json，无报告时静默隐藏）","B3 Playground：组件详情页「▶ 在线试玩」——textarea 编辑 H5 源码，iframe srcdoc 防抖实时重渲染，支持复位 / 退出，不影响源文件","C1 交叉引用：组件详情页新增「相关组件」（相似 / 搭配维度映射 + 同分类兜底）","场景示范页：`site/scenario/user-management.html`（筛选表单 + 数据表格 + 分页 + 新建弹窗 + 消息反馈，视觉全部来自令牌与 components.css），首页 Hero 加入口","部署物料：根 `README.md`、Pages 入口 `index.html` 重定向、`.github/workflows/deploy-pages.yml`、`.gitignore`"]},{"title":"Fixed","items":["测试页断言协议落地：`tests/_runtime.js` 运行期自动标注快照节点 `data-assert`（多级结构启发式：.row → .demo → .demo-block → 首层；此前 79 页实际无断言节点，PLAN v1.1 声称与实现不符）","`site/data.js` / `site/data.json` 去除 UTF-8 BOM（PS5.1 `Set-Content` 默认带 BOM，严格 JSON 解析器如 node require 直接解析失败）","断言可见性判定放宽（`getClientRects` 兜底），减少隐藏变体误报"]}],"version":"1.2.0"},{"date":"2026-09-08","sections":[{"title":"Added — 竞品对齐改造（第一批，依据《竞品网站检查报告》与《现状问题分析与改造清单》）","items":["For Agents 页（`#/agents`）：AI / Agent 消费入口——机器可读资源清单、data.json 数据形状、消费示例、使用规则","`site/llms.txt`：LLM 入口清单，指向 data.json、契约 JSON、令牌文件与测试页","站内更新日志页（`#/changelog`）：`build-site.ps1` 解析本文件注入 `data.js`，站点展示与仓库同源","主题预设库：主题定制器内置 6 套品牌色预设（科技蓝 / 青碧 / 极夜紫 / 暖橙 / 绯红 / 松石绿），一键切换后仍可微调","组件详情页新增「API 源码提炼」徽章，区分契约化组件（6 核心）与源码提炼组件（69 扩展）"]},{"title":"Fixed — 文档与实现不符","items":["搜索增强补票：Ctrl+K 弹窗补齐分类 chip 过滤、命中关键词 `<mark>` 高亮、子序列模糊回退（PLAN v1.1 曾声称交付但代码缺失）；搜索结果行补写 `data-slug` 修复搜索日志点击目标为空的问题"]},{"title":"Changed","items":["暗色模式令牌映射补全：`html.kole-dark` 新增品牌色族 / 语义色 / focus-ring / 阴影映射，并修复「主题内联样式压过暗色类」的层级问题——暗色下品牌色自动向白色混合提亮一档，`kole-mode` 切换后即时重算","`build-site.ps1`：`meta.version` 不再硬编码，改为从 CHANGELOG.md 最新版本号自动同步"]}],"version":"1.1.1"},{"date":"2026-09-07","sections":[{"title":"Added — 文档体系补齐","items":["`PLAN.md`：完整组件文档体系规划与路线图，含 5 大模块、3 版本路线、验收标准","`CHANGELOG.md`：本文档","`CONTRIBUTING.md`：贡献指南（如何新增组件 / 修契约 / 加测试）","`TESTING.md`：测试矩阵、断言协议、回归流程","`tests/<slug>.html` × 79：每个组件独立测试页（HTML+CSS+原生 JS 零依赖）","`tests/index.html`：测试总览页（按类目聚合 + 通过率 + 失败项）","`run-tests.ps1`：批量构建测试目录脚本"]},{"title":"Added — 日志系统","items":["`site/logger.js`：构建 / 渲染 / 搜索 / 测试 四类事件，落 `localStorage[kole-render-log]` / `localStorage[kole-search-log]` / `localStorage[kole-test-log]`","控制台 `koleLogger.export()` 导出 JSON","测试页内置 `data-assert` + `data-status`，便于 Playwright / Selenium 回归"]},{"title":"Added — 搜索增强","items":["Ctrl+K 弹窗内新增分类 chips 过滤（general / navigation / input / display / feedback / system）","命中关键词 `<mark>` 高亮","模糊容错：去空格 + 子串匹配 + 大小写不敏感","搜索日志：query / 命中数 / 首个命中 slug / 耗时"]},{"title":"Added — 文档骨架","items":["顶栏工具新增「测试」「日志」入口（HAMBURGER 之后）","组件详情页新增「测试页」链接","首页 hero stats 加入「测试页 79」一项"]},{"title":"Changed","items":["`site/app.js` 改为引用 `site/logger.js`，原搜索行为保留","扩展组件契约新增「doNotInvent / unknowns」字段自动从 spec 文本提取"]},{"title":"Fixed","items":["主题定制器焦点环 rgba 计算 bug：hex 转 rgba 不再被截断为 6 位","类别切换时滚动条保持原位（避免视觉跳动）"]}],"version":"1.1.0"}]}