Files
aurora-admin/.gitignore
T
aurora-admin 5ee5d829a4
Regression / regression (push) Canceled after 0s
refactor(详情页+S8): 详情页减重(导航互斥/入口去重/i18n去重) + 品牌标识入库
本提交含两条并行工作线,因互相咬合(package.json scripts、regression.yml、
npm run build 链)无法按文件干净拆分,故合并为一次自洽提交。

## 详情页减重(本轮主任务:修复「AI 干太重」)

- 导航收敛:宽屏只用右侧目录、≤1200px 只用页内 sticky 导航,纯 CSS 媒体查询
  实现(不引入 JS 宽度监听)。此前两套导航同时可见,active 状态互相打架。
- 入口去重:标题区由「查看示例/在线测试/契约 JSON」三个减为「在线测试」一个;
  契约 JSON 归入实现资源;删除示例底部重复的「在线测试」。
- 示例工具栏:删除与目录锚点重复的示例下拉选择器;「全部展开代码」只在
  示例数 >1 时出现(103 个组件里 49 个仅 1 个示例,此前恒显示)。
- 重复文案:示例区两句同义导语合并为一句。
- 首页 CTA 由 5 个减为 2 个(浏览组件/快速开始),测试总览入口挂到已有的
  通过率统计卡上,不再另占 Hero 按钮。
- 统一详情取数:抽出 fetchDetail/loadDetail 作为 details/*.json 的唯一路径,
  FAQ 不再自行 fetch 一遍,与组件页共用缓存与失败兜底。

## i18n

- 删除 12 组重复键(含整段 FAQ 说明),字典 604 → 585 唯一键。
- 删除本次改动产生的 6 个死键。
- verify-i18n.mjs 新增 `unique dictionary keys` 断言:重复键在对象字面量里
  是静默的后值覆盖,此前无从发现;现由门禁拦住。

## 文档事实修正(实测为准)

- TESTING/CONTRIBUTING:79 → 103 组件;旧断言数改为回指 tests/report.json。
- PLATFORMS:移动端 108 文件/18 端 → 282 文件/47 端;契约 5 → 47;
  令牌 17 → 15;uni-app SFC 21 → 50。
- AGENTS:断言 1405/18 页 → 1464/103 页(PC)、807/47 页(移动端)。
- package.json:YOUR-ACCOUNT 占位 → gitea 实址与 kole-ui.mymoyu.top。

## 品牌标识(并行会话成果,一并入库)

- brand-mark.json 收归真源,build:brand 生成 favicon 与单色 SVG;
  PC 与移动端共用资产,verify:brand 24 条断言。
- regression.yml 增加 verify:brand 步骤。

## 门禁与验收

新增工具:verify-component-page.mjs(86 条真实浏览器断言,随详情页改造同步
更新为「只允许一套导航可见」)、verify-brand-mark.mjs、lib/i18n-dead-keys.mjs
(只读诊断)。

回归:PC 100%(1464/1464,103 页,N/A 50)· 移动端 100%(807/807,47 页)。
门禁:component-page 86 · i18n 17 · brand 24 · routes all · smoke all ·
theme OK · isolation 31 · nav all · examples 9 · api-docs 10 · mobile-docs 12。

已知未做:i18n 另有约 44 条历史死键(非本次产生),已记为 ROADMAP S8-P6;
顶栏与悬浮区的两个主题入口为刻意设计(verify-theme 断言其互斥),未删。
2026-09-22 23:56:05 +08:00

50 lines
1.8 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# session / tooling artifacts
.playwright-mcp/
.tmp/
# 同理覆盖 .tmp-* 这类带后缀的会话暂存目录(实测漏网:.tmp-logo-ref/ 含参考图与
# 生成脚本,.tmp/ 规则匹配不到它;根目录的 /*.png 也管不到嵌套 PNG)
.tmp-*/
.zcode/
.nav-*.mjs
*.log
# 分析过程截图(不入库;docs 资产请放 assets/)
/*.png
# OS
Thumbs.db
.DS_Store
# 构建产物:由 tools/build-dist.mjs 生成,不入库(发布时用 npm publish / CI 上传)
dist/
# 部署产物:由 tools/pack-deploy.mjs 生成,不入库(部署时把 tar.gz 传到服务器 /tmp)
dist-deploy/
# 历史版本文档站快照:由 tools/snapshot-site.mjs 生成(每份约 8 MB),不入库 ——
# 是可重建的构建产物,入库只会让仓库膨胀;部署时随包发布(tools/pack-deploy.mjs 会收集)。
/[0-9]*.[0-9]*.[0-9]*/
# 图标源缓存:tools/fetch-icon-sources.mjs 把上游 tgz 与解压目录放这里(约 2 MB),
# 不入库 —— 可重建(带 sha256 校验),入了只会让仓库膨胀。
# 入库的是编译产物 .design_library/kole-ui/icons/sources.json(离线构建的真源)。
.cache-icons/
# 依赖(仅 CI 用的 devDependencies;运行时零依赖不变)
node_modules/
# 回归失败现场:runner 在非满分时把上一次报告留档为 report-prev.json(S5-P17),
# 供事后回放「1016/1017」这类偶发失败。它是**诊断中间产物**,不入库 ——
# 入库版本仍是 tests/report.json(首页通过率数据源)。
tests/report-prev.json
# npm
npm-debug.log*
.npm/
*.tgz
# 会话/工具中间产物:AI 会话留下的暂存快照与探针脚本,不是仓库内容。
# .scratch/ 实测 9.1MB(local-hashes*.txt 与 probe 脚本),入库只让仓库膨胀。
.scratch/
.zcode-preexisting-*.txt