feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库

## 品牌标识（本次会话）起因：品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」，那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处（PC 顶栏也是「A」，移动端站已是「K」；移动端文档站则完全没有 favicon）。 - 几何：24 网格三个互不接触的笔画（竖 + 两斜），圆头描边；描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」 - 取色分两套（刻意）：favicon 硬编码品牌蓝/白（渲染在浏览器标签栏，不继承 kole-dark）；顶栏标记走 currentColor（实测暗色下自动转 rgb(20,22,28)） - 新增 theme-color 双条（light #FFFFFF / dark #1C1F26，取 --kole-color-card-bg） - 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI（改名变形残留） - 移动端 7 个模板补 favicon（此前计数 0）验收：门禁 9 条全 OK（site-routing/site-routes/mobile-docs/mobile-site/isolation/ theme/nav/i18n/icons）；PC 回归 1464/1464 · 移动端 807/807，各连跑 8 次一致；两端 favicon 405 字节逐字节一致；PC 站控制台错误 1→0。 ## 并行会话成果（本次一并入库） - 图标系统：2576 图标（TDesign/Element Plus，MIT）+ 11 端注入 + 5 个构建门禁工具 + IconPreview 预览页 + ICON-SPEC.md 冻结规格 - 移动端平台：47 组件 × 6 端 + 文档站 53 页 + 隔离门禁 - PC 组件：103 个大后台组件 / 组件11 批次 - uni-app：PC 端试点 + 移动端端实现 + 真实编译验证 ## 工程 - .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt（会话中间产物，实测 9.1MB，不入库） - CHANGELOG 补品牌标识条目 - ROADMAP 登 S8-P4（品牌标识任务包 + og:image/apple-touch-icon 未做部分）
2026-09-21 10:05:48 +08:00
parent eb25feedaf
commit f1fbfc2ddb
2541 changed files with 270385 additions and 25873 deletions
@@ -0,0 +1,185 @@
+{
+  "schemaVersion": 1,
+  "sourceKind": "authored-spec",
+  "provenance": "authored-in-repo",
+  "specFile": "spec/移动端规格.md",
+  "specSection": "5 · 滑动单元格 SwipeCell",
+  "confidence": "high",
+  "slug": "swipecell",
+  "name": "滑动单元格 SwipeCell",
+  "semanticTypeCandidates": [
+    "swipe-cell",
+    "list-item",
+    "gesture"
+  ],
+  "variantDimensions": [
+    {
+      "name": "direction",
+      "values": [
+        "left",
+        "right"
+      ]
+    },
+    {
+      "name": "actions",
+      "values": [
+        "1",
+        "2"
+      ]
+    }
+  ],
+  "representativeVariants": [
+    {
+      "direction": "left",
+      "actions": "1",
+      "label": "左滑 · 单个操作"
+    },
+    {
+      "direction": "left",
+      "actions": "2",
+      "label": "左滑 · 两个操作"
+    },
+    {
+      "direction": "right",
+      "actions": "1",
+      "label": "右滑 · 单个操作"
+    },
+    {
+      "direction": "left",
+      "actions": "2",
+      "label": "已展开态"
+    }
+  ],
+  "anatomy": {
+    "cell": "可滑动的行容器",
+    "content": "行内容（标题、描述）",
+    "actions": "右侧操作区，随滑动露出",
+    "action": "单个操作按钮，可标记危险"
+  },
+  "structurePatterns": {
+    "direction": "left（左滑露出右侧操作，默认）/ right（右滑露出左侧操作）",
+    "actions": "1 / 2（操作数量，最多 2 个）"
+  },
+  "usageHints": [
+    "列表行左滑露出操作按钮，用于删除、标记等单行操作",
+    "横向位移超过 10px 判定为滑动，纵向位移更大时取消滑动",
+    "松手后按位移是否超过操作区宽度的一半决定展开或回弹",
+    "展开状态下点击内容区先收起，不触发内容点击",
+    "操作按钮为原生 button，具备 aria-label",
+    "滑动不可作为唯一路径：操作按钮在展开后必须可键盘聚焦"
+  ],
+  "doNotInvent": [
+    "多行同时展开的互斥规则",
+    "滑动与纵向滚动的竞争阈值细节"
+  ],
+  "unknowns": [
+    "操作区宽度是否有标准档位",
+    "拖拽中的阴影表现"
+  ],
+  "interaction": [
+    "横向位移超过 10px 判定为滑动，纵向位移更大时取消滑动",
+    "松手后按位移是否超过操作区宽度的一半决定展开或回弹",
+    "展开状态下点击内容区先收起，不触发内容点击"
+  ],
+  "accessibility": [
+    "操作按钮为原生 button，具备 aria-label",
+    "滑动不可作为唯一路径：操作按钮在展开后必须可键盘聚焦"
+  ],
+  "api": {
+    "source": "implementation",
+    "note": "props / events / slots 为 6 端实现的公共接口（说明文字取自规格对应小节）。字段名与各端源码逐名核对：node tools/verify-mobile-docs.mjs",
+    "props": [
+      {
+        "name": "direction",
+        "type": "'left' | 'right'",
+        "default": "'left'",
+        "desc": "变体 direction：左滑露出右侧操作或右滑露出左侧操作（规格 §5.3）",
+        "required": false
+      },
+      {
+        "name": "actions",
+        "type": "Action[]",
+        "default": "[]",
+        "desc": "操作项（最多 2 个）：{ key, label, tone?, ariaLabel? }（规格 §5.2/§5.3）",
+        "required": false
+      },
+      {
+        "name": "open",
+        "type": "boolean",
+        "default": "false",
+        "desc": "受控展开态（closed / open，规格 §5.4）",
+        "required": false
+      }
+    ],
+    "events": [
+      {
+        "name": "action",
+        "params": "key, action",
+        "desc": "点击某个操作按钮时触发"
+      }
+    ],
+    "slots": [
+      {
+        "name": "default",
+        "desc": "行内容（标题、描述；规格 §5.2）"
+      }
+    ],
+    "requiredNote": "「必传」按严格定义：实现里**没有默认值**时才为 Y（本门禁逐条核对 props 与各端源码的默认值，防止契约与实现脱节）。"
+  },
+  "variantClasses": {
+    "direction": {
+      "left": [],
+      "right": [
+        ".kole-m-swipecell--right"
+      ]
+    },
+    "actions": {
+      "1": [
+        ".kole-m-swipecell__action"
+      ],
+      "2": [
+        ".kole-m-swipecell__action"
+      ]
+    }
+  },
+  "demos": [
+    {
+      "id": "left-single",
+      "group": "01 组件类型",
+      "title": "左滑 · 单个操作",
+      "desc": "最常用的形态：左滑露出一个操作；位移超过操作区一半即展开。",
+      "variant": "direction=left / actions=1"
+    },
+    {
+      "id": "left-double",
+      "group": "01 组件类型",
+      "title": "左滑 · 两个操作",
+      "desc": "两个操作为上限；破坏性操作放最右（拇指行程最短，也最不易误触）。",
+      "variant": "actions=2"
+    },
+    {
+      "id": "right-single",
+      "group": "01 组件类型",
+      "title": "右滑 · 单个操作",
+      "desc": "右滑露出左侧操作，适合「标记已读」这类非破坏性动作。",
+      "variant": "direction=right"
+    },
+    {
+      "id": "open",
+      "group": "02 组件状态",
+      "title": "已展开态",
+      "desc": "展开后操作按钮可键盘聚焦 —— 滑动不是唯一路径（无障碍要求）。",
+      "variant": "open=true"
+    }
+  ],
+  "related": [
+    {
+      "slug": "actionsheet",
+      "why": "需要标题与统一取消的批量选择用动作面板；行内单点操作用滑动单元格"
+    },
+    {
+      "slug": "tabbar",
+      "why": "长列表底部常带标签栏，滑动时要保证列表可滚、标签栏不动"
+    }
+  ]
+}