aurora-admin/CHANGELOG.md

Changelog

所有显著改动按 SemVer 记录于此。格式基于 Keep a Changelog。

[Unreleased]

[1.1.1] - 2026-09-08

Added — 竞品对齐改造（第一批，依据《竞品网站检查报告》与《现状问题分析与改造清单》）

• For Agents 页（#/agents）：AI / Agent 消费入口——机器可读资源清单、data.json 数据形状、消费示例、使用规则
• site/llms.txt：LLM 入口清单，指向 data.json、契约 JSON、令牌文件与测试页
• 站内更新日志页（#/changelog）：build-site.ps1 解析本文件注入 data.js，站点展示与仓库同源
• 主题预设库：主题定制器内置 6 套品牌色预设（科技蓝 / 青碧 / 极夜紫 / 暖橙 / 绯红 / 松石绿），一键切换后仍可微调
• 组件详情页新增「API 源码提炼」徽章，区分契约化组件（6 核心）与源码提炼组件（69 扩展）

Fixed — 文档与实现不符

• 搜索增强补票：Ctrl+K 弹窗补齐分类 chip 过滤、命中关键词 <mark> 高亮、子序列模糊回退（PLAN v1.1 曾声称交付但代码缺失）；搜索结果行补写 data-slug 修复搜索日志点击目标为空的问题

Changed

• 暗色模式令牌映射补全：html.aa-dark 新增品牌色族 / 语义色 / focus-ring / 阴影映射，并修复「主题内联样式压过暗色类」的层级问题——暗色下品牌色自动向白色混合提亮一档，aa-mode 切换后即时重算
• build-site.ps1：meta.version 不再硬编码，改为从 CHANGELOG.md 最新版本号自动同步

[1.1.0] - 2026-09-07

Added — 文档体系补齐

• PLAN.md：完整组件文档体系规划与路线图，含 5 大模块、3 版本路线、验收标准
• CHANGELOG.md：本文档
• CONTRIBUTING.md：贡献指南（如何新增组件 / 修契约 / 加测试）
• TESTING.md：测试矩阵、断言协议、回归流程
• tests/<slug>.html × 79：每个组件独立测试页（HTML+CSS+原生 JS 零依赖）
• tests/index.html：测试总览页（按类目聚合 + 通过率 + 失败项）
• run-tests.ps1：批量构建测试目录脚本

Added — 日志系统

• site/logger.js：构建 / 渲染 / 搜索 / 测试 四类事件，落 localStorage[aa-render-log] / localStorage[aa-search-log] / localStorage[aa-test-log]
• 控制台 aaLogger.export() 导出 JSON
• 测试页内置 data-assert + data-status，便于 Playwright / Selenium 回归

Added — 搜索增强

• Ctrl+K 弹窗内新增分类 chips 过滤（general / navigation / input / display / feedback / system）
• 命中关键词 <mark> 高亮
• 模糊容错：去空格 + 子串匹配 + 大小写不敏感
• 搜索日志：query / 命中数 / 首个命中 slug / 耗时

Added — 文档骨架

• 顶栏工具新增「测试」「日志」入口（HAMBURGER 之后）
• 组件详情页新增「测试页」链接
• 首页 hero stats 加入「测试页 79」一项

Changed

• site/app.js 改为引用 site/logger.js，原搜索行为保留
• 扩展组件契约新增「doNotInvent / unknowns」字段自动从 spec 文本提取

Fixed

• 主题定制器焦点环 rgba 计算 bug：hex 转 rgba 不再被截断为 6 位
• 类别切换时滚动条保持原位（避免视觉跳动）

[1.0.0] - 2026-09-06

Added

• 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 构建脚本

Notes

• 数据生成产物：site/data.js（自动生成，请勿手动编辑）

---

标签说明

• Added：新功能
• Changed：现有功能变更
• Deprecated：即将移除
• Removed：已移除
• Fixed：缺陷修复
• Security：安全相关

版本约定

• 主版本号：不兼容的 API 变更
• 次版本号：向后兼容的功能新增
• 修订号：向后兼容的问题修复