wip: 2026-08-11 工作树快照（docs/memory/h5.py/scripts 等 447 项未评审改动，安全提交到 feat 分支）

2026-08-11 09:59:44 +08:00
parent 6be361fb63
commit f2fd4fa012
447 changed files with 273482 additions and 1386 deletions
@@ -0,0 +1,87 @@
+# =============================================================================
+# Gitea Actions · Design Tokens WCAG 2AA 对比度自动校验
+# =============================================================================
+# 触发：PR + push to main
+# 目的：PRD-REQ-通用-001 v1.2 §6 + §7.4 实施要求
+#   "颜色对比度纳入 CI 或视觉回归检查；
+#    普通文字最低 4.5:1，大文字最低 3:1。"
+#
+# 工作流：
+#   1. 拉取代码
+#   2. 配置 Node 22
+#   3. 跑 scripts/check-wcag-tokens.mjs 校验所有前端 tokens.css
+#   4. 失败 → 阻断 PR
+#
+# 依赖：零外部 npm 依赖（脚本自包含 WCAG 2.x 算法）
+# =============================================================================
+
+name: WCAG 2AA Tokens Check
+
+on:
+  pull_request:
+    paths:
+      - 'src/frontend-*/src/styles/tokens.css'
+      - 'scripts/check-wcag-tokens.mjs'
+      - '.gitea/workflows/wcag-a11y.yml'
+  push:
+    branches: [main, feature/**, develop]
+    paths:
+      - 'src/frontend-*/src/styles/tokens.css'
+      - 'scripts/check-wcag-tokens.mjs'
+      - '.gitea/workflows/wcag-a11y.yml'
+
+jobs:
+  wcag-tokens:
+    name: Design Tokens WCAG 2AA
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      - name: 配置 Node.js 22
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: 列出待扫描 tokens.css
+        run: |
+          echo "━━━ 待扫描文件 ━━━"
+          find src -path "*/styles/tokens.css" -type f 2>/dev/null || echo "(无)"
+
+      - name: 跑 WCAG 2AA 对比度校验
+        run: node scripts/check-wcag-tokens.mjs
+
+      - name: 失败时注释 PR
+        if: failure() && github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const comment = [
+              '## ❌ WCAG 2AA Design Tokens 校验失败',
+              '',
+              '`scripts/check-wcag-tokens.mjs` 检测到关键 token 组合不满足 WCAG 2AA 阈值：',
+              '- 普通文字 ≥ 4.5:1',
+              '- 大文字（≥ 18pt regular / ≥ 14pt bold）/ UI 组件 ≥ 3:1',
+              '',
+              '**修复路径**：',
+              '1. 查看上方日志中的失败项（`fg × bg`）',
+              '2. 调整 `src/frontend-*/src/styles/tokens.css` 中的颜色值',
+              '3. 或在组件层强制使用大字号 / 加粗（触发大文字 3:1 阈值）',
+              '4. 重新 push 触发 CI',
+              '',
+              '参考：PRD-REQ-通用-001-前端设计系统 v1.2 §4.1.6 + §7.4',
+            ].join('\n');
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: comment,
+            });
+
+      - name: 校验通过总结
+        if: success()
+        run: |
+          echo "✅ 所有关键 token 组合满足 WCAG 2AA 阈值（普通文字 4.5:1 / 大文字 3:1）"
+          echo "详见上方日志中的 ✅ PASS 项"