weifuwu 0.85.0 → 0.87.0

package/content/index.json

@@ -0,0 +1,4344 @@
+{
+  "counts": {
+    "components": 160,
+    "primitives": 20,
+    "patterns": 11,
+    "apps": 5,
+    "backend": 14,
+    "capabilities": 12,
+    "guides": 20,
+    "community": 0
+  },
+  "components": [
+    {
+      "id": "videoplayer",
+      "name": "VideoPlayer",
+      "category": "core",
+      "desc": "视频播放器——原生 video 封装（controls/封面/宽高比/事件——零依赖）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/VideoPlayer/VideoPlayer.ts",
+      "cssFile": "src/client/components/VideoPlayer/VideoPlayer.css",
+      "testFile": "src/client/components/VideoPlayer/VideoPlayer.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "math",
+      "name": "Math",
+      "category": "core",
+      "desc": "轻量公式渲染——自研 LaTeX 子集（上下标/分数/根号/希腊字母——零依赖不引 KaTeX）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/Math/Math.ts",
+      "cssFile": "src/client/components/Math/Math.css",
+      "testFile": "src/client/components/Math/Math.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "markdowneditor",
+      "name": "MarkdownEditor",
+      "category": "editor",
+      "desc": "分屏 Markdown 编辑器——textarea + 实时预览（复用 Markdown parser 零漂移）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/MarkdownEditor/MarkdownEditor.ts",
+      "cssFile": "src/client/components/MarkdownEditor/MarkdownEditor.css",
+      "testFile": "src/client/components/MarkdownEditor/MarkdownEditor.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "codeeditor",
+      "name": "CodeEditor",
+      "category": "editor",
+      "desc": "轻量代码编辑器——textarea + 行号 + Tab 缩进（零依赖，不引 Monaco）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/CodeEditor/CodeEditor.ts",
+      "cssFile": "src/client/components/CodeEditor/CodeEditor.css",
+      "testFile": "src/client/components/CodeEditor/CodeEditor.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "imagecropper",
+      "name": "ImageCropper",
+      "category": "editor",
+      "desc": "图片裁剪——canvas 原生 API + 拖拽裁剪框 + 比例控制（零依赖）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/ImageCropper/ImageCropper.ts",
+      "cssFile": "src/client/components/ImageCropper/ImageCropper.css",
+      "testFile": "src/client/components/ImageCropper/ImageCropper.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "wave",
+      "name": "Wave",
+      "category": "core",
+      "desc": "点击水波纹动效——包装任意可点击元素（纯 CSS，reduced-motion 自动降级）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Wave/Wave.ts",
+      "cssFile": "src/client/components/Wave/Wave.css",
+      "testFile": "src/client/components/Wave/Wave.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "sortablelist",
+      "name": "SortableList",
+      "category": "viz",
+      "desc": "拖拽排序列表——useDragDrop 原语 + keyed 身份（任务/字段/配置排序）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/SortableList/SortableList.ts",
+      "cssFile": "src/client/components/SortableList/SortableList.css",
+      "testFile": "src/client/components/SortableList/SortableList.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "exportcsv",
+      "name": "ExportCSV",
+      "category": "display",
+      "desc": "数据导出 CSV——RFC 4180 转义 + BOM（Excel 兼容）零依赖",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/ExportCSV/ExportCSV.ts",
+      "cssFile": null,
+      "testFile": "src/client/components/ExportCSV/ExportCSV.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "button",
+      "name": "Button",
+      "category": "core",
+      "desc": "4 variants × 3 sizes + loading + block + disabled",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Button/Button.ts",
+      "cssFile": "src/client/components/Button/Button.css",
+      "testFile": "src/client/components/Button/Button.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "workspace",
+        "focus-task",
+        "docs",
+        "landing",
+        "list-page",
+        "detail-page",
+        "settings-page"
+      ],
+      "usedInApps": [
+        "todo",
+        "auth",
+        "multi"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "input",
+      "name": "Input",
+      "category": "input",
+      "desc": "text/email/password/number，支持 label/error/hint/required",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/Input/Input.ts",
+      "cssFile": "src/client/components/Input/Input.css",
+      "testFile": "src/client/components/Input/Input.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "focus-task",
+        "settings-page"
+      ],
+      "usedInApps": [
+        "todo",
+        "auth",
+        "multi"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "textarea",
+      "name": "Textarea",
+      "category": "input",
+      "desc": "多行文本，支持 rows/label/error/hint",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/Textarea/Textarea.ts",
+      "cssFile": "src/client/components/Textarea/Textarea.css",
+      "testFile": "src/client/components/Textarea/Textarea.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "select",
+      "name": "Select",
+      "category": "input",
+      "desc": "原生下拉选择器",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/Select/Select.ts",
+      "cssFile": "src/client/components/Select/Select.css",
+      "testFile": "src/client/components/Select/Select.test.ts",
+      "gotchas": [
+        "受控输入纪律：searchable 输入焦点丢失——useControlledInput 内部态",
+        "事件 prop 判定：on+大写（EVENT_RE）——once/only 等 on 开头属性防误判",
+        "浮层必须 portal（§5.4）——absolute 相对父容器在 overflow 下裁剪"
+      ],
+      "usedInPatterns": [
+        "settings-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "select-searchable",
+      "name": "Select (searchable)",
+      "category": "input",
+      "desc": "搜索过滤下拉，输入即搜",
+      "family": null,
+      "variantOf": "select",
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "checkbox",
+      "name": "Checkbox",
+      "category": "input",
+      "desc": "带 label 的复选框，支持 checked/disabled",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/Checkbox/Checkbox.ts",
+      "cssFile": "src/client/components/Checkbox/Checkbox.css",
+      "testFile": "src/client/components/Checkbox/Checkbox.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "focus-task"
+      ],
+      "usedInApps": [
+        "todo"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "switch",
+      "name": "Switch",
+      "category": "input",
+      "desc": "开关切换，视觉替代 checkbox",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/Switch/Switch.ts",
+      "cssFile": "src/client/components/Switch/Switch.css",
+      "testFile": "src/client/components/Switch/Switch.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "dashboard",
+        "settings-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "radiogroup",
+      "name": "RadioGroup",
+      "category": "input",
+      "desc": "单选组，支持 inline/options/value",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/RadioGroup/RadioGroup.ts",
+      "cssFile": "src/client/components/RadioGroup/RadioGroup.css",
+      "testFile": "src/client/components/RadioGroup/RadioGroup.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "segmentedcontrol",
+      "name": "SegmentedControl",
+      "category": "input",
+      "desc": "分段单选（模式切换/筛选/模板），支持 sm/block",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/SegmentedControl/SegmentedControl.ts",
+      "cssFile": "src/client/components/SegmentedControl/SegmentedControl.css",
+      "testFile": "src/client/components/SegmentedControl/SegmentedControl.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "dashboard"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "slider",
+      "name": "Slider",
+      "category": "input",
+      "desc": "范围滑块，支持 min/max/step/label",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/Slider/Slider.ts",
+      "cssFile": "src/client/components/Slider/Slider.css",
+      "testFile": "src/client/components/Slider/Slider.test.ts",
+      "gotchas": [
+        "浏览器表单状态恢复（刷新/后退）覆盖受控 value——autocomplete=off + 内部 0-100 归一化刻度（2000 slider 刷新跳动事故）",
+        "拖拽中气泡位置冻结——usePopup 锚点恒定需 popup.refresh() 跟随 thumb"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "form",
+      "name": "Form",
+      "category": "form",
+      "desc": "内置验证规则：required/pattern/minLength/自定义",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "表单"
+      ],
+      "sourceFile": "src/client/components/Form/Form.ts",
+      "cssFile": "src/client/components/Form/Form.css",
+      "testFile": "src/client/components/Form/Form.test.ts",
+      "gotchas": [
+        "三层一致（§6.3）：条件渲染 false 是空洞占位——{cond && <Alert/>} 不滤除不塌缩（提交按钮消失事故）",
+        "受控纪律：受控 value 必须配 onChange——缺回调静默不可点"
+      ],
+      "usedInPatterns": [
+        "focus-task",
+        "settings-page"
+      ],
+      "usedInApps": [
+        "todo",
+        "auth",
+        "admin",
+        "agent-platform"
+      ],
+      "relatedBackend": [
+        "sql"
+      ]
+    },
+    {
+      "id": "form-v2",
+      "name": "Form 提交",
+      "category": "form",
+      "desc": "loading 提交 + 校验错误（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "form",
+      "tags": [
+        "表单"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "field",
+      "name": "Field",
+      "category": "form",
+      "desc": "label+error+hint 容器",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "表单"
+      ],
+      "sourceFile": "src/client/components/Field/Field.ts",
+      "cssFile": "src/client/components/Field/Field.css",
+      "testFile": "src/client/components/Field/Field.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "focus-task",
+        "settings-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "relationgraph",
+      "name": "RelationGraph",
+      "category": "display",
+      "desc": "关系图谱——环形/网格布局 + 类型着色 + 选中交互（人物/组织/网络）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/RelationGraph/RelationGraph.ts",
+      "cssFile": "src/client/components/RelationGraph/RelationGraph.css",
+      "testFile": "src/client/components/RelationGraph/RelationGraph.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "appshell",
+      "name": "AppShell",
+      "category": "navigation",
+      "desc": "应用壳——品牌 + 分组导航 + 用户区 + 主内容（受控——父层驱动）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/AppShell/AppShell.ts",
+      "cssFile": "src/client/components/AppShell/AppShell.css",
+      "testFile": "src/client/components/AppShell/AppShell.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "filetree",
+      "name": "FileTree",
+      "category": "editor",
+      "desc": "文件树浏览器——面包屑 + 列表/编辑态 + 上传（受控——数据源无关）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/FileTree/FileTree.ts",
+      "cssFile": "src/client/components/FileTree/FileTree.css",
+      "testFile": "src/client/components/FileTree/FileTree.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "fileupload",
+      "name": "FileUpload",
+      "category": "editor",
+      "desc": "文件上传，拖拽区 + 文件列表 + accept/maxSize",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/FileUpload/FileUpload.ts",
+      "cssFile": "src/client/components/FileUpload/FileUpload.css",
+      "testFile": "src/client/components/FileUpload/FileUpload.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "fileupload-v2",
+      "name": "FileUpload 禁用",
+      "category": "editor",
+      "desc": "disabled + accept 限定（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "fileupload",
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "searchinput",
+      "name": "SearchInput",
+      "category": "input",
+      "desc": "搜索输入框，带清除按钮",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/SearchInput/SearchInput.ts",
+      "cssFile": "src/client/components/SearchInput/SearchInput.css",
+      "testFile": "src/client/components/SearchInput/SearchInput.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "mobile",
+        "list-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "progressbar",
+      "name": "ProgressBar",
+      "category": "feedback",
+      "desc": "进度条，支持 label/showValue",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/ProgressBar/ProgressBar.ts",
+      "cssFile": "src/client/components/ProgressBar/ProgressBar.css",
+      "testFile": "src/client/components/ProgressBar/ProgressBar.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "dashboard"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "inputnumber",
+      "name": "InputNumber",
+      "category": "input",
+      "desc": "数字输入：min/max/step + 增减按钮 + precision",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/InputNumber/InputNumber.ts",
+      "cssFile": "src/client/components/InputNumber/InputNumber.css",
+      "testFile": "src/client/components/InputNumber/InputNumber.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "passwordinput",
+      "name": "PasswordInput",
+      "category": "input",
+      "desc": "密码输入：眼睛按钮切换可见性",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/PasswordInput/PasswordInput.ts",
+      "cssFile": "src/client/components/PasswordInput/PasswordInput.css",
+      "testFile": "src/client/components/PasswordInput/PasswordInput.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "auth"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "tagsinput",
+      "name": "TagsInput",
+      "category": "input",
+      "desc": "标签输入：回车/逗号添加 + 中文输入法感知",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/TagsInput/TagsInput.ts",
+      "cssFile": "src/client/components/TagsInput/TagsInput.css",
+      "testFile": "src/client/components/TagsInput/TagsInput.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "tagsinput-v2",
+      "name": "TagsInput 限制/错误",
+      "category": "input",
+      "desc": "maxTags 限制 + error 校验态（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "tagsinput",
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "table",
+      "name": "Table",
+      "category": "display",
+      "desc": "可排序 + 自定义 render + 空状态",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Table/Table.ts",
+      "cssFile": "src/client/components/Table/Table.css",
+      "testFile": "src/client/components/Table/Table.test.ts",
+      "gotchas": [
+        "固定列必须显式 width（缺省 140 估算 + console.warn——sticky 偏移累计依赖）",
+        "数组空洞：children 里 {cond && <X/>} 是占位——不得误删下一个兄弟（提交按钮消失事故同源）",
+        "行内编辑（editable 列）必须配 onCellEdit（受控纪律）"
+      ],
+      "usedInPatterns": [
+        "app-shell",
+        "dashboard",
+        "list-page"
+      ],
+      "usedInApps": [
+        "admin",
+        "agent-platform"
+      ],
+      "relatedBackend": [
+        "sql",
+        "redis"
+      ]
+    },
+    {
+      "id": "table-v2",
+      "name": "Table 行选择",
+      "category": "display",
+      "desc": "rowSelection 勾选列 + 受控 keys（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "table",
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "card",
+      "name": "Card",
+      "category": "core",
+      "desc": "容器，支持 default/outlined/clickable",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Card/Card.ts",
+      "cssFile": "src/client/components/Card/Card.css",
+      "testFile": "src/client/components/Card/Card.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "focus-task",
+        "dashboard",
+        "data-screen",
+        "landing",
+        "list-page",
+        "detail-page"
+      ],
+      "usedInApps": [
+        "auth",
+        "multi"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "badge",
+      "name": "Badge",
+      "category": "core",
+      "desc": "状态标签 + 圆点，6 种 variant",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Badge/Badge.ts",
+      "cssFile": "src/client/components/Badge/Badge.css",
+      "testFile": "src/client/components/Badge/Badge.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "dashboard",
+        "data-screen",
+        "landing",
+        "mobile"
+      ],
+      "usedInApps": [
+        "admin"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "tag",
+      "name": "Tag",
+      "category": "core",
+      "desc": "标签，支持 closable/onClose",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Tag/Tag.ts",
+      "cssFile": "src/client/components/Tag/Tag.css",
+      "testFile": "src/client/components/Tag/Tag.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "docs",
+        "list-page",
+        "detail-page"
+      ],
+      "usedInApps": [
+        "todo",
+        "admin",
+        "multi"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "avatar",
+      "name": "Avatar",
+      "category": "core",
+      "desc": "头像（首字母/图片），3 种 size",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Avatar/Avatar.ts",
+      "cssFile": "src/client/components/Avatar/Avatar.css",
+      "testFile": "src/client/components/Avatar/Avatar.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "landing",
+        "mobile"
+      ],
+      "usedInApps": [
+        "admin"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "img",
+      "name": "Img",
+      "category": "display",
+      "desc": "图片 \\<img\\> 组件：fallback / lazy / preview 点击放大",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示",
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/Img/Img.ts",
+      "cssFile": "src/client/components/Img/Img.css",
+      "testFile": "src/client/components/Img/Img.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "inview",
+      "name": "InView",
+      "category": "display",
+      "desc": "进入视窗后懒加载内容，支持 IntersectionObserver",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/InView/InView.ts",
+      "cssFile": "src/client/components/InView/InView.css",
+      "testFile": "src/client/components/InView/InView.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "timeline",
+      "name": "Timeline",
+      "category": "display",
+      "desc": "时间线：节点状态色 + 时间 + 内容（执行日志/审批历史）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Timeline/Timeline.ts",
+      "cssFile": "src/client/components/Timeline/Timeline.css",
+      "testFile": "src/client/components/Timeline/Timeline.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "detail-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "descriptions",
+      "name": "Descriptions",
+      "category": "display",
+      "desc": "描述列表：label/value 栅格 + bordered + span（详情页）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Descriptions/Descriptions.ts",
+      "cssFile": "src/client/components/Descriptions/Descriptions.css",
+      "testFile": "src/client/components/Descriptions/Descriptions.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "workspace",
+        "detail-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "descriptions-v2",
+      "name": "Descriptions 紧凑",
+      "category": "display",
+      "desc": "size=small 详情页密度（变体覆盖）",
+      "family": null,
+      "variantOf": "descriptions",
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "avatargroup",
+      "name": "AvatarGroup",
+      "category": "core",
+      "desc": "头像组：堆叠 + max 溢出 +N",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/AvatarGroup/AvatarGroup.ts",
+      "cssFile": "src/client/components/AvatarGroup/AvatarGroup.css",
+      "testFile": "src/client/components/AvatarGroup/AvatarGroup.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "markdown",
+      "name": "Markdown",
+      "category": "display",
+      "desc": "AI 回复渲染：安全子集 parser + 代码块 + 链接白名单",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示",
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/Markdown/Markdown.ts",
+      "cssFile": "src/client/components/Markdown/Markdown.css",
+      "testFile": "src/client/components/Markdown/Markdown.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "codeblock",
+      "name": "CodeBlock",
+      "category": "display",
+      "desc": "代码块：语言标签 + 复制按钮 + 横向滚动",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示",
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/CodeBlock/CodeBlock.ts",
+      "cssFile": "src/client/components/CodeBlock/CodeBlock.css",
+      "testFile": "src/client/components/CodeBlock/CodeBlock.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "workspace",
+        "docs"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "logviewer",
+      "name": "LogViewer",
+      "category": "display",
+      "desc": "日志流：ANSI 着色 + 虚拟滚动 + 自动跟随 + 复制",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/LogViewer/LogViewer.ts",
+      "cssFile": "src/client/components/LogViewer/LogViewer.css",
+      "testFile": "src/client/components/LogViewer/LogViewer.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "logviewer-v2",
+      "name": "LogViewer 自定义",
+      "category": "display",
+      "desc": "自定义日志源 + 行号 + 复制（变体覆盖）",
+      "family": null,
+      "variantOf": "logviewer",
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "jsonviewer",
+      "name": "JSONViewer",
+      "category": "display",
+      "desc": "结构化 JSON：递归折叠 + 类型色 + 路径复制 + 懒展开",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/JSONViewer/JSONViewer.ts",
+      "cssFile": "src/client/components/JSONViewer/JSONViewer.css",
+      "testFile": "src/client/components/JSONViewer/JSONViewer.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "jsonviewer-v2",
+      "name": "JSONViewer 深展开",
+      "category": "display",
+      "desc": "defaultExpandDepth 深度展开嵌套对象（变体覆盖）",
+      "family": null,
+      "variantOf": "jsonviewer",
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "diffview",
+      "name": "DiffView",
+      "category": "display",
+      "desc": "代码 diff：LCS 行级对比 + 未变块折叠 + 三态着色",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/DiffView/DiffView.ts",
+      "cssFile": "src/client/components/DiffView/DiffView.css",
+      "testFile": "src/client/components/DiffView/DiffView.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "diffview-v2",
+      "name": "DiffView 标题",
+      "category": "display",
+      "desc": "oldTitle/newTitle 标记版本对比（变体覆盖）",
+      "family": null,
+      "variantOf": "diffview",
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "sparkline",
+      "name": "Sparkline",
+      "category": "viz",
+      "desc": "迷你趋势线：SVG 自绘 + 归一化 + 平滑曲线 + 面积填充",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "可视化"
+      ],
+      "sourceFile": "src/client/components/Sparkline/Sparkline.ts",
+      "cssFile": "src/client/components/Sparkline/Sparkline.css",
+      "testFile": "src/client/components/Sparkline/Sparkline.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "data-screen"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "tour",
+      "name": "Tour",
+      "category": "overlay",
+      "desc": "新手引导：步骤气泡 + 目标高亮 + 遮罩 + 键盘 Escape",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Tour/Tour.ts",
+      "cssFile": "src/client/components/Tour/Tour.css",
+      "testFile": "src/client/components/Tour/Tour.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "kanban",
+      "name": "Kanban",
+      "category": "viz",
+      "desc": "看板：原生 DnD 拖拽 + 跨列/重排 + 悬停高亮",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Kanban/Kanban.ts",
+      "cssFile": "src/client/components/Kanban/Kanban.css",
+      "testFile": "src/client/components/Kanban/Kanban.test.ts",
+      "gotchas": [
+        "enumerated 属性（§6.2）：draggable 空字符串解析为 false——必须显式 setAttribute true/false（拖动变文本选中事故）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "pipeline",
+      "name": "Pipeline",
+      "category": "ai",
+      "desc": "Agent 工作流 DAG：分层布局 + 贝塞尔连线 + 状态语义色 + 环检测",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "可视化",
+        "AI"
+      ],
+      "sourceFile": "src/client/components/Pipeline/Pipeline.ts",
+      "cssFile": "src/client/components/Pipeline/Pipeline.css",
+      "testFile": "src/client/components/Pipeline/Pipeline.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "treeselect",
+      "name": "TreeSelect",
+      "category": "advanced",
+      "desc": "树形选择：单选/多选（父子联动）+ 选中 label 回显 + 受控纪律",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/TreeSelect/TreeSelect.ts",
+      "cssFile": "src/client/components/TreeSelect/TreeSelect.css",
+      "testFile": "src/client/components/TreeSelect/TreeSelect.test.ts",
+      "gotchas": [
+        "弹窗纪律（§5.4）：曾遗漏 portal——absolute 在父容器 overflow/transform 下裁剪/错位——统一 usePopup",
+        "选项量小场景搜索过滤已裁剪（components-cuts.md 永久裁剪）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "layout",
+      "name": "Layout",
+      "category": "core",
+      "desc": "布局外壳：Sider 折叠 + Header/Content/Footer 骨架（antd Layout / shadcn Sidebar 等价）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航",
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Layout/Layout.ts",
+      "cssFile": "src/client/components/Layout/Layout.css",
+      "testFile": "src/client/components/Layout/Layout.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "admin"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "layoutheader",
+      "name": "LayoutHeader",
+      "category": "core",
+      "desc": "布局顶栏——Layout 家族（Layout/LayoutHeader/LayoutSider/LayoutContent/LayoutFooter）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Layout/Layout.ts",
+      "cssFile": "src/client/components/Layout/Layout.css",
+      "testFile": "src/client/components/Layout/Layout.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "layoutsider",
+      "name": "LayoutSider",
+      "category": "core",
+      "desc": "布局侧栏（可折叠 collapsed/collapsible）——Layout 家族",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Layout/Layout.ts",
+      "cssFile": "src/client/components/Layout/Layout.css",
+      "testFile": "src/client/components/Layout/Layout.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "layoutcontent",
+      "name": "LayoutContent",
+      "category": "core",
+      "desc": "布局内容区——Layout 家族",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Layout/Layout.ts",
+      "cssFile": "src/client/components/Layout/Layout.css",
+      "testFile": "src/client/components/Layout/Layout.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "popconfirm",
+      "name": "Popconfirm",
+      "category": "overlay",
+      "desc": "气泡确认：危险操作防误触 + 复用 usePopup 基座",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈",
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Popconfirm/Popconfirm.ts",
+      "cssFile": "src/client/components/Popconfirm/Popconfirm.css",
+      "testFile": "src/client/components/Popconfirm/Popconfirm.test.ts",
+      "gotchas": [
+        "气泡内表单/自定义箭头已裁剪（Popover 基座 + 定位全套复用）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "autocomplete",
+      "name": "AutoComplete",
+      "category": "advanced",
+      "desc": "输入联想：自由输入 + 过滤下拉 + 键盘流 + 选中回填",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/AutoComplete/AutoComplete.ts",
+      "cssFile": "src/client/components/AutoComplete/AutoComplete.css",
+      "testFile": "src/client/components/AutoComplete/AutoComplete.test.ts",
+      "gotchas": [
+        "受控输入纪律（§5.3）：受控 input 焦点丢失事故——输入期间 value 走内部 keyword（useControlledInput），不依赖受控 value 回流",
+        "IME composition：中文输入组合期间受控 value 重置打断——isComposing 门控"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "autocomplete-v2",
+      "name": "AutoComplete 禁用态",
+      "category": "input",
+      "desc": "disabled 时不可输入（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "autocomplete",
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [
+        "受控输入纪律：焦点丢失——useControlledInput（与 autocomplete 同源事故）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "link",
+      "name": "Link",
+      "category": "core",
+      "desc": "文字链接：语义色/下划线/disabled/新窗口",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Link/Link.ts",
+      "cssFile": "src/client/components/Link/Link.css",
+      "testFile": "src/client/components/Link/Link.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "landing"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "floatbutton",
+      "name": "FloatButton",
+      "category": "core",
+      "desc": "悬浮按钮组：展开状态机 + badge",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/FloatButton/FloatButton.ts",
+      "cssFile": "src/client/components/FloatButton/FloatButton.css",
+      "testFile": "src/client/components/FloatButton/FloatButton.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "navmenu",
+      "name": "NavMenu",
+      "category": "navigation",
+      "desc": "顶部导航：多级 hover 弹出 + 键盘（shadcn NavigationMenu）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/NavMenu/NavMenu.ts",
+      "cssFile": "src/client/components/NavMenu/NavMenu.css",
+      "testFile": "src/client/components/NavMenu/NavMenu.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "admin"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "space",
+      "name": "Space",
+      "category": "core",
+      "desc": "间距容器：size/direction/wrap + split 分隔符",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Space/Space.ts",
+      "cssFile": "src/client/components/Space/Space.css",
+      "testFile": "src/client/components/Space/Space.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "workspace",
+        "focus-task",
+        "docs",
+        "dashboard",
+        "data-screen",
+        "landing",
+        "mobile",
+        "detail-page",
+        "settings-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "grid",
+      "name": "Grid",
+      "category": "core",
+      "desc": "24 栅格 + gutter + flex 容器模式（Row/Col/Flex 等价）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Grid/Grid.ts",
+      "cssFile": "src/client/components/Grid/Grid.css",
+      "testFile": "src/client/components/Grid/Grid.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "scrollbar",
+      "name": "Scrollbar",
+      "category": "core",
+      "desc": "自定义滚动容器：webkit 样式 + hover 显示",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Scrollbar/Scrollbar.ts",
+      "cssFile": "src/client/components/Scrollbar/Scrollbar.css",
+      "testFile": "src/client/components/Scrollbar/Scrollbar.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "alertgroup",
+      "name": "AlertGroup",
+      "category": "feedback",
+      "desc": "通知合并组：≥3 条折叠为 +N，点击展开",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/AlertGroup/AlertGroup.ts",
+      "cssFile": "src/client/components/AlertGroup/AlertGroup.css",
+      "testFile": "src/client/components/AlertGroup/AlertGroup.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "statcard-countdown",
+      "name": "StatCard Countdown",
+      "category": "display",
+      "desc": "倒计时模式：剩余 HH:MM:SS + 结束回调",
+      "family": null,
+      "variantOf": "statcard",
+      "tags": [
+        "展示",
+        "可视化"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "messagebubble",
+      "name": "MessageBubble",
+      "category": "ai",
+      "desc": "消息气泡：user/assistant + streaming/error 状态 + actions",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "展示",
+        "AI"
+      ],
+      "sourceFile": "src/client/components/MessageBubble/MessageBubble.ts",
+      "cssFile": "src/client/components/MessageBubble/MessageBubble.css",
+      "testFile": "src/client/components/MessageBubble/MessageBubble.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "highlight",
+      "name": "Highlight",
+      "category": "display",
+      "desc": "搜索词高亮：分词渲染 mark，大小写不敏感",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Highlight/Highlight.ts",
+      "cssFile": "src/client/components/Highlight/Highlight.css",
+      "testFile": "src/client/components/Highlight/Highlight.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "highlight-v2",
+      "name": "Highlight 多词",
+      "category": "display",
+      "desc": "query 数组多词高亮（变体覆盖）",
+      "family": null,
+      "variantOf": "highlight",
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "list",
+      "name": "List",
+      "category": "display",
+      "desc": "通用列表：renderItem + divided + header/footer/empty",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/List/List.ts",
+      "cssFile": "src/client/components/List/List.css",
+      "testFile": "src/client/components/List/List.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "workspace",
+        "mobile"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "result",
+      "name": "Result",
+      "category": "feedback",
+      "desc": "结果页：success/error/warning/info + extra 操作区",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示",
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/Result/Result.ts",
+      "cssFile": "src/client/components/Result/Result.css",
+      "testFile": "src/client/components/Result/Result.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "confirm",
+      "name": "Confirm",
+      "category": "feedback",
+      "desc": "确认对话框，Promise 化 await 调用",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/Confirm/Confirm.ts",
+      "cssFile": null,
+      "testFile": "src/client/components/Confirm/Confirm.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "statcard",
+      "name": "StatCard",
+      "category": "viz",
+      "desc": "KPI 指标卡，支持 trend/icon",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示",
+        "可视化"
+      ],
+      "sourceFile": "src/client/components/StatCard/StatCard.ts",
+      "cssFile": "src/client/components/StatCard/StatCard.css",
+      "testFile": "src/client/components/StatCard/StatCard.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "dashboard",
+        "data-screen"
+      ],
+      "usedInApps": [
+        "admin",
+        "agent-platform"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "chart",
+      "name": "Chart",
+      "category": "viz",
+      "desc": "SVG 图表：line/bar/pie/radar/gauge/scatter——零依赖自绘",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "可视化"
+      ],
+      "sourceFile": "src/client/components/Chart/Chart.ts",
+      "cssFile": "src/client/components/Chart/Chart.css",
+      "testFile": "src/client/components/Chart/Chart.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "admin"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "editor",
+      "name": "Editor",
+      "category": "editor",
+      "desc": "富文本编辑器，contentEditable + toolbar，零依赖",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/Editor/Editor.ts",
+      "cssFile": "src/client/components/Editor/Editor.css",
+      "testFile": "src/client/components/Editor/Editor.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "filepreview",
+      "name": "FilePreview",
+      "category": "editor",
+      "desc": "文件预览（md/html/pdf/office）——基于事件流，可编辑",
+      "family": "file-preview",
+      "variantOf": null,
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/FilePreview/FilePreview.ts",
+      "cssFile": "src/client/components/FilePreview/FilePreview.css",
+      "testFile": "src/client/components/FilePreview/FilePreview.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "filepreview-office",
+      "name": "FilePreview Office",
+      "category": "editor",
+      "desc": "office 前端导入/导出（零依赖转换——无需后端）",
+      "family": null,
+      "variantOf": "filepreview",
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "themeswitch",
+      "name": "ThemeSwitch",
+      "category": "core",
+      "desc": "主题切换：auto/light/dark，localStorage 持久化",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/ThemeSwitch/ThemeSwitch.ts",
+      "cssFile": "src/client/components/ThemeSwitch/ThemeSwitch.css",
+      "testFile": "src/client/components/ThemeSwitch/ThemeSwitch.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "admin",
+        "agent-platform"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "datepicker",
+      "name": "DatePicker",
+      "category": "advanced",
+      "desc": "日期选择器，四种模式：date/datetime/time/range",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/DatePicker/DatePicker.ts",
+      "cssFile": "src/client/components/DatePicker/DatePicker.css",
+      "testFile": "src/client/components/DatePicker/DatePicker.test.ts",
+      "gotchas": [
+        "受控纪律：受控 value/month 必须配回调——缺回调静默不可点"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "modal",
+      "name": "Modal",
+      "category": "overlay",
+      "desc": "自定义宽度 + closable 控制关闭按钮",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Modal/Modal.ts",
+      "cssFile": "src/client/components/Modal/Modal.css",
+      "testFile": "src/client/components/Modal/Modal.test.ts",
+      "gotchas": [
+        "退场动画：exit 类必须挂载（animationend 驱动卸载）——reduced-motion 下动画降为 0.01ms 等效瞬时",
+        "会话级模态四件套：presence/trapFocus/lockScroll 由 usePopup 统一提供"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "agent-platform"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "drawer",
+      "name": "Drawer",
+      "category": "overlay",
+      "desc": "侧边面板，左右滑入 + ESC 关闭",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Drawer/Drawer.ts",
+      "cssFile": "src/client/components/Drawer/Drawer.css",
+      "testFile": "src/client/components/Drawer/Drawer.test.ts",
+      "gotchas": [
+        "退场动画：--enter/--exit 类必须成对（audit 强制）——只定义不挂是死代码（CS-01）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "agent-platform"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "popover",
+      "name": "Popover",
+      "category": "overlay",
+      "desc": "通用弹出层，click/hover 触发，4 方向",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Popover/Popover.ts",
+      "cssFile": "src/client/components/Popover/Popover.css",
+      "testFile": "src/client/components/Popover/Popover.test.ts",
+      "gotchas": [
+        "portal 槽豁免（同 HoverCard）",
+        "富内容自动判定已裁剪——HoverCard 补富内容（components-cuts.md）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "tooltip",
+      "name": "Tooltip",
+      "category": "overlay",
+      "desc": "hover 浮动提示，4 方向",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Tooltip/Tooltip.ts",
+      "cssFile": "src/client/components/Tooltip/Tooltip.css",
+      "testFile": "src/client/components/Tooltip/Tooltip.test.ts",
+      "gotchas": [
+        "portal 槽豁免（同 HoverCard）——浮层插槽非业务列表"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "toast",
+      "name": "Toast",
+      "category": "feedback",
+      "desc": "5 种位置 + 自动消失 + 数量限制",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/Toast/Toast.ts",
+      "cssFile": "src/client/components/Toast/Toast.css",
+      "testFile": "src/client/components/Toast/Toast.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "alert",
+      "name": "Alert",
+      "category": "feedback",
+      "desc": "信息提示条，4 种 variant + closable",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/Alert/Alert.ts",
+      "cssFile": "src/client/components/Alert/Alert.css",
+      "testFile": "src/client/components/Alert/Alert.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "focus-task",
+        "settings-page"
+      ],
+      "usedInApps": [
+        "auth"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "loading",
+      "name": "Loading",
+      "category": "feedback",
+      "desc": "加载状态，支持自定义文字",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/Loading/Loading.ts",
+      "cssFile": "src/client/components/Loading/Loading.css",
+      "testFile": "src/client/components/Loading/Loading.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "skeleton",
+      "name": "Skeleton",
+      "category": "display",
+      "desc": "text/circle/rect/image/avatar/table 六种变体",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Skeleton/Skeleton.ts",
+      "cssFile": "src/client/components/Skeleton/Skeleton.css",
+      "testFile": "src/client/components/Skeleton/Skeleton.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "emptystate",
+      "name": "EmptyState",
+      "category": "feedback",
+      "desc": "空状态占位，支持 icon/text/hint/action",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/EmptyState/EmptyState.ts",
+      "cssFile": "src/client/components/EmptyState/EmptyState.css",
+      "testFile": "src/client/components/EmptyState/EmptyState.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "list-page"
+      ],
+      "usedInApps": [
+        "todo"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "breadcrumb",
+      "name": "Breadcrumb",
+      "category": "navigation",
+      "desc": "面包屑导航，支持 aria-current",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Breadcrumb/Breadcrumb.ts",
+      "cssFile": "src/client/components/Breadcrumb/Breadcrumb.css",
+      "testFile": "src/client/components/Breadcrumb/Breadcrumb.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "docs"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "menu",
+      "name": "Menu",
+      "category": "navigation",
+      "desc": "侧栏导航：分组 + 图标 + 选中态 + 方向键",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Menu/Menu.ts",
+      "cssFile": "src/client/components/Menu/Menu.css",
+      "testFile": "src/client/components/Menu/Menu.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "admin",
+        "agent-platform"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "tabs",
+      "name": "Tabs",
+      "category": "navigation",
+      "desc": "标签页切换，支持 active/onChange",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Tabs/Tabs.ts",
+      "cssFile": "src/client/components/Tabs/Tabs.css",
+      "testFile": "src/client/components/Tabs/Tabs.test.ts",
+      "gotchas": [
+        "混合数组稳定 key：tabList+addBtn+ink 全 keyed——无 key 项退 unkeyed 位置配对（新增 tab 错位事故）",
+        "closable 必须配 onClose / addable 必须配 onAdd（受控纪律——console.warn）"
+      ],
+      "usedInPatterns": [
+        "workspace",
+        "settings-page"
+      ],
+      "usedInApps": [
+        "multi"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "dropdown",
+      "name": "Dropdown",
+      "category": "overlay",
+      "desc": "下拉菜单，支持 danger variant",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Dropdown/Dropdown.ts",
+      "cssFile": "src/client/components/Dropdown/Dropdown.css",
+      "testFile": "src/client/components/Dropdown/Dropdown.test.ts",
+      "gotchas": [
+        "受控纪律：受控 open 必须配 onOpenChange——缺回调静默不可点",
+        "命令式弹窗：浮层经 ctx.ui.openPopup（唯一形态——toast 心智——内核自管理生命周期）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "pagination",
+      "name": "Pagination",
+      "category": "navigation",
+      "desc": "分页器，自动计算页码范围",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Pagination/Pagination.ts",
+      "cssFile": "src/client/components/Pagination/Pagination.css",
+      "testFile": "src/client/components/Pagination/Pagination.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "list-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "steps",
+      "name": "Steps",
+      "category": "navigation",
+      "desc": "分步指示器，支持 active/current",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Steps/Steps.ts",
+      "cssFile": "src/client/components/Steps/Steps.css",
+      "testFile": "src/client/components/Steps/Steps.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "accordion",
+      "name": "Accordion",
+      "category": "navigation",
+      "desc": "折叠面板，支持多个 items",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Accordion/Accordion.ts",
+      "cssFile": "src/client/components/Accordion/Accordion.css",
+      "testFile": "src/client/components/Accordion/Accordion.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "aichat",
+      "name": "AiChat",
+      "category": "ai",
+      "desc": "useChat + 标准对话界面：流式 token / 工具卡 / 审批卡 / 自动滚动，协议对页面透明",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/AiChat/AiChat.ts",
+      "cssFile": "src/client/components/AiChat/AiChat.css",
+      "testFile": "src/client/components/AiChat/AiChat.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "agent-platform"
+      ],
+      "relatedBackend": [
+        "ws",
+        "sse",
+        "ai"
+      ]
+    },
+    {
+      "id": "chatinput",
+      "name": "ChatInput",
+      "category": "ai",
+      "desc": "独立聊天输入条（AiChat 抽取）：单行/多行 + streaming 停止 + IME 安全——不自带聊天逻辑",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/ChatInput/ChatInput.ts",
+      "cssFile": "src/client/components/ChatInput/ChatInput.css",
+      "testFile": "src/client/components/ChatInput/ChatInput.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "authpage",
+      "name": "AuthPage",
+      "category": "ai",
+      "desc": "认证页骨架：居中卡片 + logo + 表单插槽 + 错误条 + 提交 loading（登录/注册复用）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/AuthPage/AuthPage.ts",
+      "cssFile": null,
+      "testFile": "src/client/components/AuthPage/AuthPage.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [
+        "agent-platform"
+      ],
+      "relatedBackend": [
+        "auth"
+      ]
+    },
+    {
+      "id": "toolcallcard",
+      "name": "ToolCallCard",
+      "category": "ai",
+      "desc": "工具调用卡片：running / ok / error 状态机（call/progress/result 三字段驱动）",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/ToolCallCard/ToolCallCard.ts",
+      "cssFile": "src/client/components/ToolCallCard/ToolCallCard.css",
+      "testFile": "src/client/components/ToolCallCard/ToolCallCard.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": [
+        "ai"
+      ]
+    },
+    {
+      "id": "jsonschemaform",
+      "name": "JsonSchemaForm",
+      "category": "form",
+      "desc": "JSON Schema → 参数输入表单：类型映射 + 必填/范围校验 + 嵌套/数组（AI 工具参数输入面）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "表单",
+        "AI"
+      ],
+      "sourceFile": "src/client/components/JsonSchemaForm/JsonSchemaForm.ts",
+      "cssFile": "src/client/components/JsonSchemaForm/JsonSchemaForm.css",
+      "testFile": "src/client/components/JsonSchemaForm/JsonSchemaForm.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "reasoningblock",
+      "name": "ReasoningBlock",
+      "category": "ai",
+      "desc": "CoT 推理折叠展示：aria-expanded + 键盘可达 + 流式脉冲（thinking 模式 reasoning_content）",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/ReasoningBlock/ReasoningBlock.ts",
+      "cssFile": "src/client/components/ReasoningBlock/ReasoningBlock.css",
+      "testFile": "src/client/components/ReasoningBlock/ReasoningBlock.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "citationcard",
+      "name": "CitationCard",
+      "category": "ai",
+      "desc": "RAG 引用来源：折叠「引用 N 条」+ 条目列表（序号/标题/来源/片段/链接）+ 溢出 +N",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/CitationCard/CitationCard.ts",
+      "cssFile": "src/client/components/CitationCard/CitationCard.css",
+      "testFile": "src/client/components/CitationCard/CitationCard.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "sessionlist",
+      "name": "SessionList",
+      "category": "ai",
+      "desc": "会话管理列表：分组（今天/昨天/更早）+ 搜索 + 选中 + 重命名/删除/新建 + 键盘导航",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/SessionList/SessionList.ts",
+      "cssFile": "src/client/components/SessionList/SessionList.css",
+      "testFile": "src/client/components/SessionList/SessionList.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "approvalcard",
+      "name": "ApprovalCard",
+      "category": "ai",
+      "desc": "HITL 审批卡片：pending 可批/拒 + 修改参数（JsonSchemaForm）· approved/rejected/timeout 终态",
+      "family": "ai-chat",
+      "variantOf": null,
+      "tags": [
+        "AI"
+      ],
+      "sourceFile": "src/client/components/ApprovalCard/ApprovalCard.ts",
+      "cssFile": "src/client/components/ApprovalCard/ApprovalCard.css",
+      "testFile": "src/client/components/ApprovalCard/ApprovalCard.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": [
+        "ai"
+      ]
+    },
+    {
+      "id": "pageheader",
+      "name": "PageHeader",
+      "category": "navigation",
+      "desc": "页面标题栏，支持 sub + 右侧操作区 + display 大标题",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/PageHeader/PageHeader.ts",
+      "cssFile": "src/client/components/PageHeader/PageHeader.css",
+      "testFile": "src/client/components/PageHeader/PageHeader.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "dashboard",
+        "list-page",
+        "detail-page",
+        "settings-page"
+      ],
+      "usedInApps": [
+        "todo"
+      ],
+      "relatedBackend": []
+    },
+    {
+      "id": "icon",
+      "name": "Icon",
+      "category": "core",
+      "desc": "stroke SVG 图标集，currentColor 着色，随字号缩放",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Icon/Icon.ts",
+      "cssFile": "src/client/components/Icon/Icon.css",
+      "testFile": "src/client/components/Icon/Icon.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "workspace",
+        "focus-task",
+        "docs",
+        "dashboard",
+        "data-screen",
+        "landing",
+        "mobile",
+        "list-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "divider",
+      "name": "Divider",
+      "category": "core",
+      "desc": "分割线，支持 horizontal/vertical/带文字",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Divider/Divider.ts",
+      "cssFile": "src/client/components/Divider/Divider.css",
+      "testFile": "src/client/components/Divider/Divider.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "workspace",
+        "focus-task",
+        "docs",
+        "dashboard",
+        "landing",
+        "mobile",
+        "detail-page"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "app",
+      "name": "多应用（app 节点）",
+      "category": "ai",
+      "desc": "父应用嵌入子应用：注册表 + 独立状态 + app:* 边界事件（appId 可区分——同流全链路）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "rate",
+      "name": "Rate",
+      "category": "input",
+      "desc": "评分：键盘方向键 / allowClear / readOnly，新增 star 图标",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/Rate/Rate.ts",
+      "cssFile": "src/client/components/Rate/Rate.css",
+      "testFile": "src/client/components/Rate/Rate.test.ts",
+      "gotchas": [
+        "小尺寸 button 固定 min/max-height（§5.6）：星 16x36 竖条事故"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "typography",
+      "name": "Typography",
+      "category": "core",
+      "desc": "Title/Text/Paragraph：语义标签 + 语义色 -text 变体 + mark/code/删除线",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Typography/Typography.ts",
+      "cssFile": "src/client/components/Typography/Typography.css",
+      "testFile": "src/client/components/Typography/Typography.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "label",
+      "name": "Label",
+      "category": "core",
+      "desc": "独立标签（required 星号）+ 宽高比容器（内容填满）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Label/Label.ts",
+      "cssFile": "src/client/components/Label/Label.css",
+      "testFile": "src/client/components/Label/Label.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "aspectratio",
+      "name": "AspectRatio",
+      "category": "core",
+      "desc": "独立标签（required 星号）+ 宽高比容器（内容填满）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/AspectRatio/AspectRatio.ts",
+      "cssFile": "src/client/components/AspectRatio/AspectRatio.css",
+      "testFile": "src/client/components/AspectRatio/AspectRatio.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "toggle-togglegroup",
+      "name": "Toggle / ToggleGroup",
+      "category": "input",
+      "desc": "切换按钮：single/multiple 双模式（shadcn 对齐）",
+      "family": null,
+      "variantOf": "togglegroup",
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/ToggleGroup/ToggleGroup.ts",
+      "cssFile": "src/client/components/ToggleGroup/ToggleGroup.css",
+      "testFile": "src/client/components/ToggleGroup/ToggleGroup.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "checkboxgroup",
+      "name": "CheckboxGroup",
+      "category": "input",
+      "desc": "复选框组：数组受控 + 栅格列数（antd Checkbox.Group）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/CheckboxGroup/CheckboxGroup.ts",
+      "cssFile": "src/client/components/CheckboxGroup/CheckboxGroup.css",
+      "testFile": "src/client/components/CheckboxGroup/CheckboxGroup.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "pininput",
+      "name": "PinInput",
+      "category": "input",
+      "desc": "验证码输入：自动聚焦/粘贴分派/Backspace 回退（shadcn InputOTP）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/PinInput/PinInput.ts",
+      "cssFile": "src/client/components/PinInput/PinInput.css",
+      "testFile": "src/client/components/PinInput/PinInput.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "pininput-v2",
+      "name": "PinInput 禁用态",
+      "category": "input",
+      "desc": "disabled 不可编辑（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "pininput",
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "copybutton",
+      "name": "CopyButton",
+      "category": "core",
+      "desc": "复制按钮：clipboard + execCommand 降级 + 成功状态机",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/CopyButton/CopyButton.ts",
+      "cssFile": "src/client/components/CopyButton/CopyButton.css",
+      "testFile": "src/client/components/CopyButton/CopyButton.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "colorpicker",
+      "name": "ColorPicker",
+      "category": "overlay",
+      "desc": "颜色选择：预设色板 + hex 输入（Popover 弹层）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入",
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/ColorPicker/ColorPicker.ts",
+      "cssFile": "src/client/components/ColorPicker/ColorPicker.css",
+      "testFile": "src/client/components/ColorPicker/ColorPicker.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "hovercard",
+      "name": "HoverCard",
+      "category": "overlay",
+      "desc": "悬停富内容卡：openDelay 延迟 + 任意 VNode（shadcn）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/HoverCard/HoverCard.ts",
+      "cssFile": "src/client/components/HoverCard/HoverCard.css",
+      "testFile": "src/client/components/HoverCard/HoverCard.test.ts",
+      "gotchas": [
+        "portal 槽豁免：浮层插槽打开/关闭不触发 A 级动态数组检测（框架管理切换槽）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "notification",
+      "name": "Notification",
+      "category": "feedback",
+      "desc": "队列式通知：notification.success/error/warning 命令式（antd 对齐）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "反馈"
+      ],
+      "sourceFile": "src/client/components/Notification/Notification.ts",
+      "cssFile": "src/client/components/Notification/Notification.css",
+      "testFile": "src/client/components/Notification/Notification.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "backtop",
+      "name": "BackTop",
+      "category": "navigation",
+      "desc": "回到顶部（滚动超 400px 显示）+ 固定导航（距顶 80px 钉住）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/BackTop/BackTop.ts",
+      "cssFile": "src/client/components/BackTop/BackTop.css",
+      "testFile": "src/client/components/BackTop/BackTop.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "docs",
+        "landing"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "affix",
+      "name": "Affix",
+      "category": "navigation",
+      "desc": "回到顶部（滚动超 400px 显示）+ 固定导航（距顶 80px 钉住）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Affix/Affix.ts",
+      "cssFile": "src/client/components/Affix/Affix.css",
+      "testFile": "src/client/components/Affix/Affix.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "anchor",
+      "name": "Anchor",
+      "category": "navigation",
+      "desc": "锚点导航：滚动高亮跟随 + 点击平滑滚动",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Anchor/Anchor.ts",
+      "cssFile": "src/client/components/Anchor/Anchor.css",
+      "testFile": "src/client/components/Anchor/Anchor.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "docs"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "contextmenu",
+      "name": "ContextMenu",
+      "category": "overlay",
+      "desc": "右键菜单：光标定位 + 方向键 + danger 变体（shadcn）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/ContextMenu/ContextMenu.ts",
+      "cssFile": "src/client/components/ContextMenu/ContextMenu.css",
+      "testFile": "src/client/components/ContextMenu/ContextMenu.test.ts",
+      "gotchas": [
+        "portal 槽豁免；右键 + 触屏长按双通道"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "mentions",
+      "name": "Mentions",
+      "category": "advanced",
+      "desc": "@提及：composition 抑制 + 过滤插入（antd Mentions）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/Mentions/Mentions.ts",
+      "cssFile": "src/client/components/Mentions/Mentions.css",
+      "testFile": "src/client/components/Mentions/Mentions.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "mentions-v2",
+      "name": "Mentions 禁用态",
+      "category": "input",
+      "desc": "disabled 时不可输入（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "mentions",
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "collapse",
+      "name": "Collapse",
+      "category": "navigation",
+      "desc": "行内折叠：异步 loading + extra 操作区（区别于 Accordion）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "导航"
+      ],
+      "sourceFile": "src/client/components/Collapse/Collapse.ts",
+      "cssFile": "src/client/components/Collapse/Collapse.css",
+      "testFile": "src/client/components/Collapse/Collapse.test.ts",
+      "gotchas": [
+        "受控纪律（§5.2）：受控 activeKeys 必须配回调——缺回调静默不可点（console.warn 防护）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "tree",
+      "name": "Tree",
+      "category": "advanced",
+      "desc": "树形：递归模型 + 勾选父子联动 + indeterminate（antd/EP Tree）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/Tree/Tree.ts",
+      "cssFile": "src/client/components/Tree/Tree.css",
+      "testFile": "src/client/components/Tree/Tree.test.ts",
+      "gotchas": [
+        "受控纪律：selectedKeys/checkedKeys/expandedKeys 必须配回调（缺回调 console.warn）",
+        "小尺寸 button 固定 min/max-height（§5.6）：checkbox 14x36 竖条事故",
+        "虚拟模式（virtual）键盘导航限于可见窗口（VirtualList 无 scrollTo——裁剪登记）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "tree-v2",
+      "name": "Tree 勾选",
+      "category": "advanced",
+      "desc": "checkable 父子联动 + 受控 checkedKeys（变体覆盖）",
+      "family": null,
+      "variantOf": "tree",
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "cascader",
+      "name": "Cascader",
+      "category": "advanced",
+      "desc": "级联选择：多列面板逐级推进（antd/EP Cascader）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/Cascader/Cascader.ts",
+      "cssFile": "src/client/components/Cascader/Cascader.css",
+      "testFile": "src/client/components/Cascader/Cascader.test.ts",
+      "gotchas": [
+        "受控纪律：受控 value 必须配回调——缺回调静默不可点",
+        "多选（multiple）已裁剪（低频——单选+搜索已够，见 components-cuts.md）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "cascader-v2",
+      "name": "Cascader 禁用/错误",
+      "category": "advanced",
+      "desc": "disabled + error 校验态（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "cascader",
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "transfer",
+      "name": "Transfer",
+      "category": "advanced",
+      "desc": "穿梭框：双列表 + 选中移动（antd/EP Transfer）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/Transfer/Transfer.ts",
+      "cssFile": "src/client/components/Transfer/Transfer.css",
+      "testFile": "src/client/components/Transfer/Transfer.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "command",
+      "name": "Command",
+      "category": "overlay",
+      "desc": "命令面板：⌘K 全局快捷键 + 键盘流（shadcn Command）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Command/Command.ts",
+      "cssFile": "src/client/components/Command/Command.css",
+      "testFile": "src/client/components/Command/Command.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "menubar",
+      "name": "Menubar",
+      "category": "navigation",
+      "desc": "水平菜单栏：←→ 切换 + ↓ 展开（shadcn Menubar）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "弹层"
+      ],
+      "sourceFile": "src/client/components/Menubar/Menubar.ts",
+      "cssFile": "src/client/components/Menubar/Menubar.css",
+      "testFile": "src/client/components/Menubar/Menubar.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "carousel",
+      "name": "Carousel",
+      "category": "virtual",
+      "desc": "轮播：箭头/圆点/循环 + 自动播放（三库共识）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "虚拟化"
+      ],
+      "sourceFile": "src/client/components/Carousel/Carousel.ts",
+      "cssFile": "src/client/components/Carousel/Carousel.css",
+      "testFile": "src/client/components/Carousel/Carousel.test.ts",
+      "gotchas": [
+        "小尺寸 button 固定 min/max-height（§5.6）：圆点 8x45 竖条事故"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "resizable",
+      "name": "Resizable",
+      "category": "virtual",
+      "desc": "拖拽分割面板：pointer + 键盘方向键 + clamp（shadcn）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "虚拟化"
+      ],
+      "sourceFile": "src/client/components/Resizable/Resizable.ts",
+      "cssFile": "src/client/components/Resizable/Resizable.css",
+      "testFile": "src/client/components/Resizable/Resizable.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "calendar",
+      "name": "Calendar",
+      "category": "advanced",
+      "desc": "月历：事件点 + 月切换 + 日期选择（antd/EP Calendar）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": "src/client/components/Calendar/Calendar.ts",
+      "cssFile": "src/client/components/Calendar/Calendar.css",
+      "testFile": "src/client/components/Calendar/Calendar.test.ts",
+      "gotchas": [
+        "受控纪律：受控 month/value 必须配回调——缺回调静默不可点（console.warn 防护）"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "calendar-v2",
+      "name": "Calendar 事件",
+      "category": "advanced",
+      "desc": "事件标记 + 日期选择交互（变体覆盖）",
+      "family": null,
+      "variantOf": "calendar",
+      "tags": [
+        "选择"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "watermark",
+      "name": "Watermark",
+      "category": "display",
+      "desc": "水印：canvas 平铺绘制 + overlay（antd Watermark）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/Watermark/Watermark.ts",
+      "cssFile": "src/client/components/Watermark/Watermark.css",
+      "testFile": "src/client/components/Watermark/Watermark.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "virtuallist",
+      "name": "VirtualList",
+      "category": "virtual",
+      "desc": "虚拟列表：spacer + 可见窗口，200 条只渲染 ~12 个 DOM",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "虚拟化"
+      ],
+      "sourceFile": "src/client/components/VirtualList/VirtualList.ts",
+      "cssFile": "src/client/components/VirtualList/VirtualList.css",
+      "testFile": "src/client/components/VirtualList/VirtualList.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "virtualtable",
+      "name": "VirtualTable",
+      "category": "virtual",
+      "desc": "虚拟表格：10k 行固定表头 + 可见窗口渲染 + 排序",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示",
+        "虚拟化"
+      ],
+      "sourceFile": "src/client/components/VirtualTable/VirtualTable.ts",
+      "cssFile": "src/client/components/VirtualTable/VirtualTable.css",
+      "testFile": "src/client/components/VirtualTable/VirtualTable.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "virtualtable-v2",
+      "name": "VirtualTable 大数据",
+      "category": "virtual",
+      "desc": "10 万行虚拟滚动（只渲染可见窗口——性能展示）",
+      "family": null,
+      "variantOf": "virtualtable",
+      "tags": [
+        "展示",
+        "虚拟化"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "infinitescroll",
+      "name": "InfiniteScroll",
+      "category": "virtual",
+      "desc": "无限滚动：底部哨兵触底加载 + loading/end 态",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "虚拟化"
+      ],
+      "sourceFile": "src/client/components/InfiniteScroll/InfiniteScroll.ts",
+      "cssFile": "src/client/components/InfiniteScroll/InfiniteScroll.css",
+      "testFile": "src/client/components/InfiniteScroll/InfiniteScroll.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "infinitescroll-v2",
+      "name": "InfiniteScroll 失败重试",
+      "category": "virtual",
+      "desc": "加载失败提示 + 滚动重试（状态矩阵覆盖）",
+      "family": null,
+      "variantOf": "infinitescroll",
+      "tags": [
+        "虚拟化"
+      ],
+      "sourceFile": null,
+      "cssFile": null,
+      "testFile": null,
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "qrcode",
+      "name": "QRCode",
+      "category": "display",
+      "desc": "二维码：自研 QR 编码（Reed-Solomon + 8 掩码）零依赖 SVG",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "展示"
+      ],
+      "sourceFile": "src/client/components/QRCode/QRCode.ts",
+      "cssFile": null,
+      "testFile": "src/client/components/QRCode/QRCode.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "sheetgrid",
+      "name": "SheetGrid",
+      "category": "editor",
+      "desc": "weifuwu/components/SheetGrid — xlsx 网格编辑器（ODES 事件流底座） 设计（design/office-events-plan.md）：文档 = fold(事件流)——SheetGrid 的每个",
+      "family": "file-preview",
+      "variantOf": null,
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/SheetGrid/SheetGrid.ts",
+      "cssFile": "src/client/components/SheetGrid/SheetGrid.css",
+      "testFile": "src/client/components/SheetGrid/SheetGrid.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "slidecanvas",
+      "name": "SlideCanvas",
+      "category": "editor",
+      "desc": "weifuwu/components/SlideCanvas — pptx 画布编辑器（ODES 事件流——阶段 3） 设计（design/office-events-plan.md）：文档 = fold(事件流)——每个编辑 =",
+      "family": "file-preview",
+      "variantOf": null,
+      "tags": [
+        "编辑文件"
+      ],
+      "sourceFile": "src/client/components/SlideCanvas/SlideCanvas.ts",
+      "cssFile": "src/client/components/SlideCanvas/SlideCanvas.css",
+      "testFile": "src/client/components/SlideCanvas/SlideCanvas.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "togglegroup",
+      "name": "ToggleGroup",
+      "category": "input",
+      "desc": "（无 demo 卡片——组件目录存在）",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "输入"
+      ],
+      "sourceFile": "src/client/components/ToggleGroup/ToggleGroup.ts",
+      "cssFile": "src/client/components/ToggleGroup/ToggleGroup.css",
+      "testFile": "src/client/components/ToggleGroup/ToggleGroup.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "title",
+      "name": "Title",
+      "category": "core",
+      "desc": "标题排版（语义标签 + 语义色 -text 变体）——Typography 家族",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Typography/Typography.ts",
+      "cssFile": "src/client/components/Typography/Typography.css",
+      "testFile": "src/client/components/Typography/Typography.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "docs",
+        "dashboard",
+        "landing"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "text",
+      "name": "Text",
+      "category": "core",
+      "desc": "正文排版（语义色 -text 变体 + mark/code/删除线）——Typography 家族",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Typography/Typography.ts",
+      "cssFile": "src/client/components/Typography/Typography.css",
+      "testFile": "src/client/components/Typography/Typography.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "app-shell",
+        "workspace",
+        "focus-task",
+        "dashboard",
+        "data-screen",
+        "landing",
+        "mobile"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "paragraph",
+      "name": "Paragraph",
+      "category": "core",
+      "desc": "段落排版——Typography 家族",
+      "family": null,
+      "variantOf": null,
+      "tags": [
+        "通用布局"
+      ],
+      "sourceFile": "src/client/components/Typography/Typography.ts",
+      "cssFile": "src/client/components/Typography/Typography.css",
+      "testFile": "src/client/components/Typography/Typography.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [
+        "docs",
+        "landing"
+      ],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "tabbar",
+      "name": "TabBar",
+      "category": "navigation",
+      "desc": "底部标签栏——移动端 App 主导航（3-5 tab + icon/badge/受控激活 + safe-area 避让）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/TabBar/TabBar.ts",
+      "cssFile": "src/client/components/TabBar/TabBar.css",
+      "testFile": "src/client/components/TabBar/TabBar.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "actionsheet",
+      "name": "ActionSheet",
+      "category": "overlay",
+      "desc": "动作面板——移动端底部滑出（命令列表 + 取消按钮，usePopup 会话级模态）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/ActionSheet/ActionSheet.ts",
+      "cssFile": "src/client/components/ActionSheet/ActionSheet.css",
+      "testFile": "src/client/components/ActionSheet/ActionSheet.test.ts",
+      "gotchas": [],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    },
+    {
+      "id": "prompttemplate",
+      "name": "PromptTemplate",
+      "category": "ai",
+      "desc": "提示词模板编辑器——变量 chips 插入 + 实时预览填充（AI 场景痛点）",
+      "family": null,
+      "variantOf": null,
+      "tags": [],
+      "sourceFile": "src/client/components/PromptTemplate/PromptTemplate.ts",
+      "cssFile": "src/client/components/PromptTemplate/PromptTemplate.css",
+      "testFile": "src/client/components/PromptTemplate/PromptTemplate.test.ts",
+      "gotchas": [
+        "textarea value 必须走 property（attribute 只是 defaultValue——DOM value 恒空/光标失效事故，vdom3 渲染器已修）",
+        "受控输入纪律：value 由父控制 + onChange 通知"
+      ],
+      "usedInPatterns": [],
+      "usedInApps": [],
+      "relatedBackend": []
+    }
+  ],
+  "primitives": [
+    {
+      "id": "grid",
+      "name": "网格",
+      "cssFile": "_grid.css",
+      "kind": "primitive",
+      "desc": "CSS Grid 容器——--wf-cols 控制列（auto-fill/模板/比例）",
+      "classes": [
+        "wf-grid"
+      ]
+    },
+    {
+      "id": "stack",
+      "name": "纵向堆叠",
+      "cssFile": "_stack.css",
+      "kind": "primitive",
+      "desc": "flex column 容器——--wf-gap 控制间距（页面/卡片骨架首选）",
+      "classes": [
+        "wf-stack"
+      ]
+    },
+    {
+      "id": "row",
+      "name": "横向行",
+      "cssFile": "_row.css",
+      "kind": "primitive",
+      "desc": "flex row 容器——/between/around/evenly/right 分布变体",
+      "classes": [
+        "wf-row",
+        "wf-between",
+        "wf-around",
+        "wf-evenly",
+        "wf-right"
+      ]
+    },
+    {
+      "id": "center",
+      "name": "居中",
+      "cssFile": "_center.css",
+      "kind": "primitive",
+      "desc": "双向居中（Hero/空状态/认证页）",
+      "classes": [
+        "wf-center"
+      ]
+    },
+    {
+      "id": "fill",
+      "name": "填满",
+      "cssFile": "_fill.css",
+      "kind": "primitive",
+      "desc": "flex:1 占满剩余空间（内容区/弹性布局）",
+      "classes": [
+        "wf-fill"
+      ]
+    },
+    {
+      "id": "container",
+      "name": "页面容器",
+      "cssFile": "_container.css",
+      "kind": "primitive",
+      "desc": "水平居中定宽容器——--wf-max 控制宽度",
+      "classes": [
+        "wf-container"
+      ]
+    },
+    {
+      "id": "cluster",
+      "name": "自动换行簇",
+      "cssFile": "_cluster.css",
+      "kind": "primitive",
+      "desc": "flex-wrap 簇布局（标签/按钮组）",
+      "classes": [
+        "wf-cluster"
+      ]
+    },
+    {
+      "id": "split",
+      "name": "分栏",
+      "cssFile": "_split.css",
+      "kind": "primitive",
+      "desc": "两栏拆分——--wf-split-ratio 控制比例",
+      "classes": [
+        "wf-split"
+      ]
+    },
+    {
+      "id": "layer",
+      "name": "层叠",
+      "cssFile": "_layer.css",
+      "kind": "primitive",
+      "desc": "absolute 层叠容器（角标/覆盖层）",
+      "classes": [
+        "wf-layer"
+      ]
+    },
+    {
+      "id": "app-shell",
+      "name": "应用外壳",
+      "cssFile": "_app-shell.css",
+      "kind": "primitive",
+      "desc": "wf-app-shell 可折叠侧栏 + wf-nav 导航（菜单/分组/激活态）",
+      "classes": [
+        "wf-app-shell",
+        "wf-nav",
+        "wf-nav-item",
+        "wf-nav-group",
+        "wf-sidebar"
+      ]
+    },
+    {
+      "id": "hidden",
+      "name": "显隐与显示类型",
+      "cssFile": "_hidden.css",
+      "kind": "primitive",
+      "desc": "wf-hidden/wf-block/wf-flex…（含 @lg 断点变体——响应式切换）",
+      "classes": [
+        "wf-hidden",
+        "wf-hidden@lg",
+        "wf-flex@lg",
+        "wf-block"
+      ]
+    },
+    {
+      "id": "position",
+      "name": "定位",
+      "cssFile": "_fixed.css",
+      "kind": "primitive",
+      "desc": "fixed/sticky + top/bottom/right 吸附（吸顶/悬浮/回顶）",
+      "classes": [
+        "wf-fixed",
+        "wf-sticky",
+        "wf-top",
+        "wf-bottom"
+      ]
+    },
+    {
+      "id": "scroll",
+      "name": "滚动与裁剪",
+      "cssFile": "_scroll.css",
+      "kind": "primitive",
+      "desc": "溢出滚动容器 + clip/nowrap（横向滚动条/卡片裁剪）",
+      "classes": [
+        "wf-scroll",
+        "wf-clip",
+        "wf-nowrap"
+      ]
+    },
+    {
+      "id": "safe-area",
+      "name": "安全区",
+      "cssFile": "_safe-area.css",
+      "kind": "primitive",
+      "desc": "wf-safe-top/bottom（移动端刘海/底部栏适配）",
+      "classes": [
+        "wf-safe-top",
+        "wf-safe-bottom"
+      ]
+    },
+    {
+      "id": "anchor",
+      "name": "锚点定位",
+      "cssFile": "_anchor.css",
+      "kind": "primitive",
+      "desc": "wf-anchor（锚定定位——fixed 相对容器）",
+      "classes": [
+        "wf-anchor"
+      ]
+    },
+    {
+      "id": "align",
+      "name": "对齐",
+      "cssFile": "_align-self.css",
+      "kind": "primitive",
+      "desc": "align-self 系列（stretch/start/end/center——单元格对齐）",
+      "classes": [
+        "wf-stretch",
+        "wf-align-self-start"
+      ]
+    },
+    {
+      "id": "spacing",
+      "name": "间距工具",
+      "cssFile": "_spacing.css",
+      "kind": "utility",
+      "desc": "90 个 p/m/gap 类——刻度阶梯（--wf-space-*）",
+      "classes": [
+        "wf-p-md",
+        "wf-m-0",
+        "wf-gap-sm",
+        "wf-gap-lg"
+      ]
+    },
+    {
+      "id": "surface",
+      "name": "表面工具",
+      "cssFile": "_surface.css",
+      "kind": "utility",
+      "desc": "20 个背景/圆角/边框类（卡片/表单面；flat 变体=平面表面）",
+      "classes": [
+        "wf-surface",
+        "wf-surface--flat",
+        "wf-bg-secondary",
+        "wf-rounded-md",
+        "wf-border-t"
+      ]
+    },
+    {
+      "id": "border",
+      "name": "边框工具",
+      "cssFile": "_border.css",
+      "kind": "utility",
+      "desc": "边框/分隔线（wf-border/b/t/l/r）",
+      "classes": [
+        "wf-border",
+        "wf-border-b"
+      ]
+    },
+    {
+      "id": "text",
+      "name": "文本工具",
+      "cssFile": "_text.css",
+      "kind": "utility",
+      "desc": "42 个字号/字重/颜色/对齐类（-text 语义色变体）",
+      "classes": [
+        "wf-text-sm",
+        "wf-text-bold",
+        "wf-text-secondary",
+        "wf-text-primary"
+      ]
+    }
+  ],
+  "patterns": [
+    {
+      "id": "app-shell",
+      "name": "后台应用壳",
+      "group": "工作台",
+      "desc": "wf-app-shell 可折叠侧栏 + 内容区",
+      "file": "patterns/AppShell.tsx",
+      "uses": [
+        "Button",
+        "PageHeader",
+        "Table",
+        "Badge",
+        "Icon",
+        "Divider",
+        "Pagination",
+        "StatCard",
+        "Space",
+        "Card",
+        "Text"
+      ],
+      "usedInApps": [
+        "admin"
+      ]
+    },
+    {
+      "id": "workspace",
+      "name": "分栏工作台",
+      "group": "工作台",
+      "desc": "wf-grid 三栏（文件树 + CodeBlock + Descriptions）",
+      "file": "patterns/SplitWorkspace.tsx",
+      "uses": [
+        "Text",
+        "Button",
+        "CodeBlock",
+        "Descriptions",
+        "Divider",
+        "Icon",
+        "List",
+        "Tabs",
+        "Space"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "focus-task",
+      "name": "聚焦任务页",
+      "group": "工作台",
+      "desc": "wf-center 居中 + Form 表单全家桶",
+      "file": "patterns/FocusTask.tsx",
+      "uses": [
+        "Text",
+        "Button",
+        "Card",
+        "Checkbox",
+        "Field",
+        "Form",
+        "Icon",
+        "Input",
+        "Space",
+        "Alert",
+        "Divider"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "docs",
+      "name": "文档站",
+      "group": "内容展示",
+      "desc": "Anchor 目录 + prose 正文 + CodeBlock",
+      "file": "patterns/Docs.tsx",
+      "uses": [
+        "Title",
+        "Paragraph",
+        "Anchor",
+        "BackTop",
+        "Breadcrumb",
+        "Button",
+        "CodeBlock",
+        "Divider",
+        "Icon",
+        "Tag",
+        "Space"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "dashboard",
+      "name": "仪表盘",
+      "group": "内容展示",
+      "desc": "wf-grid 响应式 KPI + 时间范围数据联动",
+      "file": "patterns/Dashboard.tsx",
+      "uses": [
+        "Title",
+        "Text",
+        "StatCard",
+        "PageHeader",
+        "ProgressBar",
+        "SegmentedControl",
+        "Switch",
+        "Table",
+        "Badge",
+        "Card",
+        "Divider",
+        "Icon",
+        "Space"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "data-screen",
+      "name": "数据大屏",
+      "group": "内容展示",
+      "desc": "wf-fill 全屏 + wf-layer/wf-pop 容器内角标 + Sparkline",
+      "file": "patterns/DataScreen.tsx",
+      "uses": [
+        "Text",
+        "Badge",
+        "Card",
+        "Icon",
+        "Sparkline",
+        "StatCard",
+        "Space"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "landing",
+      "name": "营销落地页",
+      "group": "营销推广",
+      "desc": "wf-center Hero + wf-grid 特性 + CTA",
+      "file": "patterns/Landing.tsx",
+      "uses": [
+        "Title",
+        "Paragraph",
+        "Text",
+        "Badge",
+        "BackTop",
+        "Button",
+        "Card",
+        "Divider",
+        "Icon",
+        "Link",
+        "Space",
+        "Avatar"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "mobile",
+      "name": "移动端 App",
+      "group": "营销推广",
+      "desc": "wf-safe-top/bottom + SearchInput + List + 底部 Tab",
+      "file": "patterns/Mobile.tsx",
+      "uses": [
+        "Text",
+        "Avatar",
+        "Badge",
+        "Divider",
+        "Icon",
+        "List",
+        "SearchInput",
+        "Space"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "list-page",
+      "name": "列表页",
+      "group": "内容展示",
+      "desc": "搜索 + 表格 + 分页 + 状态标签——最常用业务列表",
+      "file": "patterns/ListPage.tsx",
+      "uses": [
+        "PageHeader",
+        "SearchInput",
+        "Table",
+        "Tag",
+        "Pagination",
+        "Button",
+        "Icon",
+        "EmptyState",
+        "Card"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "detail-page",
+      "name": "详情页",
+      "group": "内容展示",
+      "desc": "描述列表 + 时间线 + 操作区——业务对象详情",
+      "file": "patterns/DetailPage.tsx",
+      "uses": [
+        "PageHeader",
+        "Descriptions",
+        "Timeline",
+        "Tag",
+        "Button",
+        "Space",
+        "Card",
+        "Divider"
+      ],
+      "usedInApps": []
+    },
+    {
+      "id": "settings-page",
+      "name": "设置页",
+      "group": "内容展示",
+      "desc": "Tabs 分区 + 表单 + 开关——多块设置",
+      "file": "patterns/SettingsPage.tsx",
+      "uses": [
+        "PageHeader",
+        "Tabs",
+        "Form",
+        "Field",
+        "Input",
+        "Switch",
+        "Select",
+        "Button",
+        "Alert",
+        "Space"
+      ],
+      "usedInApps": []
+    }
+  ],
+  "apps": [
+    {
+      "id": "todo",
+      "name": "任务管理",
+      "desc": "经典 CRUD 应用：列表/详情/新建——多页路由 + createStore 跨页状态 + 表单受控。后端：MemorySql 持久化。",
+      "dir": "apps/todo",
+      "usesPatterns": [],
+      "uses": [
+        "Button",
+        "Input",
+        "Checkbox",
+        "Form",
+        "Tag",
+        "EmptyState",
+        "PageHeader"
+      ],
+      "production": false,
+      "quality": [
+        "键盘可达",
+        "375/768 无溢出",
+        "亮暗主题",
+        "loading/error/empty 态",
+        "零控制台错误"
+      ]
+    },
+    {
+      "id": "auth",
+      "name": "登录注册",
+      "desc": "登录/注册 → 受保护页 → 登出：应用级状态（user store）+ 路由守卫 + ctx.data。后端：认证中间件。",
+      "dir": "apps/auth",
+      "usesPatterns": [],
+      "uses": [
+        "Card",
+        "Form",
+        "Input",
+        "PasswordInput",
+        "Button",
+        "Alert"
+      ],
+      "production": false,
+      "quality": [
+        "键盘可达",
+        "表单校验",
+        "错误态",
+        "会话持久化",
+        "零控制台错误"
+      ]
+    },
+    {
+      "id": "admin",
+      "name": "管理后台",
+      "desc": "AppShell + Dashboard/Table/Form 多页——layout 包裹复用 + 主题。后端：rateLimit + 查询端点。源于 agent-platform 架构提炼。",
+      "dir": "apps/admin",
+      "usesPatterns": [
+        "app-shell"
+      ],
+      "uses": [
+        "Layout",
+        "Menu",
+        "NavMenu",
+        "Table",
+        "Form",
+        "ThemeSwitch",
+        "StatCard",
+        "Chart",
+        "Badge",
+        "Avatar",
+        "Tag"
+      ],
+      "production": false,
+      "quality": [
+        "键盘可达",
+        "侧栏折叠",
+        "表格排序",
+        "亮暗主题",
+        "loading/empty 态"
+      ]
+    },
+    {
+      "id": "multi",
+      "name": "应用编排",
+      "desc": "父应用嵌子应用：registerApp/hApp + app:* 边界事件——子应用独立状态。后端：ws 广播。",
+      "dir": "apps/multi",
+      "usesPatterns": [],
+      "uses": [
+        "Card",
+        "Button",
+        "Input",
+        "Tag",
+        "Tabs"
+      ],
+      "production": false,
+      "quality": [
+        "子应用独立状态",
+        "边界事件观测",
+        "零控制台错误"
+      ]
+    },
+    {
+      "id": "agent-platform",
+      "name": "agent-platform（生产级）",
+      "desc": "多租户 AI Agent 平台——weifuwu 中间件全量消费方（认证/AI/沙箱/工具链/商业化/私有化）。实战驱动框架开发的生产级参考。",
+      "dir": "",
+      "usesPatterns": [],
+      "uses": [
+        "AiChat",
+        "AuthPage",
+        "Table",
+        "Form",
+        "Modal",
+        "Drawer",
+        "Menu",
+        "StatCard",
+        "ThemeSwitch"
+      ],
+      "production": true,
+      "quality": [
+        "真实产品",
+        "多租户",
+        "私有化部署",
+        "商业化闭环"
+      ]
+    }
+  ],
+  "backend": [
+    {
+      "id": "router",
+      "name": "Router 与请求",
+      "group": "core",
+      "desc": "Trie 路由 + 路径参数 :id + 通配符 + 方法分发——showcase 自身就是活体证明",
+      "middleware": "ctx.route",
+      "endpoint": "/api/demo/router",
+      "relatedComponents": []
+    },
+    {
+      "id": "middleware",
+      "name": "ctx 注入链",
+      "group": "core",
+      "desc": "中间件面注入 ctx.sql/redis/ui/api/auth/ws/limit/email/queue/cron/ai——装配即依赖注入",
+      "middleware": "ctx.*",
+      "endpoint": null,
+      "relatedComponents": []
+    },
+    {
+      "id": "http",
+      "name": "HTTP 原语",
+      "group": "core",
+      "desc": "Request/Response 标准接口 + SSE + CORS + 静态服务",
+      "middleware": "—",
+      "endpoint": "/api/demo/http",
+      "relatedComponents": []
+    },
+    {
+      "id": "sql",
+      "name": "ctx.sql（自研 PG 协议层）",
+      "group": "data",
+      "desc": "PgConnection 实现 Sql 契约——演示用 MemorySql（零 docker），文档说明换 postgres() 一行代码",
+      "middleware": "ctx.sql",
+      "endpoint": "/api/demo/sql",
+      "relatedComponents": [
+        "Form",
+        "Table"
+      ]
+    },
+    {
+      "id": "redis",
+      "name": "ctx.redis（自研 RESP 协议层）",
+      "group": "data",
+      "desc": "RedisClient 实现 Redis 契约——缓存/计数/发布订阅；演示用 MemoryRedis",
+      "middleware": "ctx.redis",
+      "endpoint": "/api/demo/redis",
+      "relatedComponents": [
+        "Table"
+      ]
+    },
+    {
+      "id": "ws",
+      "name": "WebSocket",
+      "group": "realtime",
+      "desc": "app.ws(path, handler)——双向实时（聊天/推送/协作）",
+      "middleware": "ctx.ws",
+      "endpoint": "/ws/echo",
+      "relatedComponents": [
+        "AiChat"
+      ]
+    },
+    {
+      "id": "sse",
+      "name": "SSE 事件流",
+      "group": "realtime",
+      "desc": "Server-Sent Events——服务端推送（流式回复/进度/通知）；wire-fake chat 即活体",
+      "middleware": "—",
+      "endpoint": "/api/chat",
+      "relatedComponents": [
+        "AiChat"
+      ]
+    },
+    {
+      "id": "ai",
+      "name": "ctx.ai（chat/stream/agent/approve）",
+      "group": "ai",
+      "desc": "AI 对话全链路：流式 token / 工具调用 / HITL 审批——wf: 协议对页面透明",
+      "middleware": "ctx.ai",
+      "endpoint": "/api/chat",
+      "relatedComponents": [
+        "AiChat",
+        "ToolCallCard",
+        "ApprovalCard"
+      ]
+    },
+    {
+      "id": "limit",
+      "name": "rateLimit（ctx.limit）",
+      "group": "saas",
+      "desc": "限流中间件——超额返回 429（演示端点轻阈值）",
+      "middleware": "ctx.limit",
+      "endpoint": "/api/demo/limit",
+      "relatedComponents": []
+    },
+    {
+      "id": "auth",
+      "name": "认证（ctx.auth/user）",
+      "group": "saas",
+      "desc": "登录态/会话/权限——userSystem 集成",
+      "middleware": "ctx.auth",
+      "endpoint": null,
+      "relatedComponents": [
+        "AuthPage"
+      ]
+    },
+    {
+      "id": "email",
+      "name": "邮件（ctx.email）",
+      "group": "saas",
+      "desc": "Mailer 契约——演示用内存捕获回显（mock 输出可读）",
+      "middleware": "ctx.email",
+      "endpoint": "/api/demo/email",
+      "relatedComponents": []
+    },
+    {
+      "id": "queue",
+      "name": "任务队列（ctx.queue）",
+      "group": "saas",
+      "desc": "QueueClientModule——池命令 + 阻塞 worker（注入 Redis 模式）",
+      "middleware": "ctx.queue",
+      "endpoint": "/api/demo/queue",
+      "relatedComponents": []
+    },
+    {
+      "id": "schedule",
+      "name": "定时任务（ctx.schedule/cron）",
+      "group": "saas",
+      "desc": "cron 表达式调度——演示：日志计数端点",
+      "middleware": "ctx.schedule",
+      "endpoint": "/api/demo/cron",
+      "relatedComponents": []
+    },
+    {
+      "id": "graphql",
+      "name": "GraphQL",
+      "group": "core",
+      "desc": "app.graphql(handler)——SDL + resolvers map 绑定",
+      "middleware": "—",
+      "endpoint": "/api/demo/graphql",
+      "relatedComponents": []
+    }
+  ],
+  "capabilities": [
+    {
+      "id": "two-phase",
+      "name": "两阶段异步组件",
+      "desc": "mount（工厂，只一次）+ render（每次渲染）——工厂可 await，renderFn 强制异步",
+      "srcFile": "src/client/ui-dom/vdom3/build.ts",
+      "selfUsedIn": [
+        "showcase 所有页面"
+      ]
+    },
+    {
+      "id": "render-only",
+      "name": "render-only 状态",
+      "desc": "只有 ctx.render() 一种触发——状态是普通对象（let/createStore），无 $ Proxy 无隐式触发",
+      "srcFile": "src/client/ui-dom/vdom3/router.ts",
+      "selfUsedIn": [
+        "搜索框",
+        "主题切换",
+        "应用页内嵌 router"
+      ]
+    },
+    {
+      "id": "store",
+      "name": "createStore + useExternal",
+      "desc": "共享状态原语：普通对象 + subscribe/set/update/notify——跨组件通道",
+      "srcFile": "src/client/ui-dom/store.ts",
+      "selfUsedIn": [
+        "主题/语言偏好跨页同步"
+      ]
+    },
+    {
+      "id": "router",
+      "name": "UIRouter 路由",
+      "desc": "pathname 路由 + :param + layout 包裹复用 + 隔离模式（页面内嵌子路由）",
+      "srcFile": "src/client/ui-dom/vdom3/router.ts",
+      "selfUsedIn": [
+        "showcase 八域导航",
+        "app demo 嵌入"
+      ]
+    },
+    {
+      "id": "data",
+      "name": "ctx.data 数据管道",
+      "desc": "get/set/has + 并发合并——SSR/hydration/SPA 三场景自动适配",
+      "srcFile": "src/client/ui-dom/",
+      "selfUsedIn": [
+        "（P2：示例页）"
+      ]
+    },
+    {
+      "id": "events",
+      "name": "事件流（stream）",
+      "desc": "DOM↔事件流全链路因果可回放——__wf_tail 实时观测",
+      "srcFile": "src/client/ui-dom/vdom3/events.ts",
+      "selfUsedIn": [
+        "__wf_tail 观测面板"
+      ]
+    },
+    {
+      "id": "app-node",
+      "name": "多应用（registerApp/hApp）",
+      "desc": "注册表 + 独立状态 + app:* 边界事件——应用编排",
+      "srcFile": "src/client/ui-dom/vdom3/registry.ts",
+      "selfUsedIn": [
+        "multi 应用模板"
+      ]
+    },
+    {
+      "id": "hooks",
+      "name": "hooks 族",
+      "desc": "useMedia/useInView/useChat/usePopup…——事件驱动重渲染",
+      "srcFile": "src/client/ui-dom/vdom3/",
+      "selfUsedIn": [
+        "懒渲染",
+        "弹层"
+      ]
+    },
+    {
+      "id": "popup",
+      "name": "usePopup 弹窗基座",
+      "desc": "portal + 定位 + 外部点击/Escape + 会话级模态——新弹层一律复用",
+      "srcFile": "src/client/ui-dom/popup.ts",
+      "selfUsedIn": [
+        "Drawer/代码抽屉/下拉"
+      ]
+    },
+    {
+      "id": "self-id",
+      "name": "selfId 精准刷新",
+      "desc": "自定义组件 ID——任意位置 render([id]) 跨组件精准定位",
+      "srcFile": "src/client/ui-dom/vdom3/",
+      "selfUsedIn": [
+        "（示例页）"
+      ]
+    },
+    {
+      "id": "i18n",
+      "name": "i18n 中间件",
+      "desc": "locale/setLocale/t + 页面级重渲染（demo 专用 AppMiddleware）",
+      "srcFile": "src/client/ui-dom/i18n.ts",
+      "selfUsedIn": [
+        "中英切换"
+      ]
+    },
+    {
+      "id": "theme",
+      "name": "主题系统",
+      "desc": "--wf-* token 双层（亮/暗/自动）+ ThemeSwitch + localStorage 持久化",
+      "srcFile": "src/layout/_tokens.css",
+      "selfUsedIn": [
+        "ThemeSwitch 全站"
+      ]
+    }
+  ],
+  "community": [],
+  "guides": [
+    {
+      "id": "start",
+      "name": "快速开始",
+      "desc": "从零到第一个页面：装包 → 选型 → 取码 → 运行"
+    },
+    {
+      "id": "choose",
+      "name": "选型决策树",
+      "desc": "组件 vs 原语 vs 页面模式 vs 应用模板——什么场景抄什么"
+    },
+    {
+      "id": "quality",
+      "name": "人类质量标准",
+      "desc": "LLM 交付前验收门槛：可访问性/响应式/主题/动效/状态矩阵/性能/纪律"
+    },
+    {
+      "id": "component-model",
+      "name": "两阶段组件模型",
+      "desc": "mount/render 生命周期职责表 + 事件函数放哪层（AGENTS.md §3.1 展开）"
+    },
+    {
+      "id": "render-only",
+      "name": "render-only 状态",
+      "desc": "改状态 → 显式 render()；createStore 跨组件；selfId 精准刷新"
+    },
+    {
+      "id": "custom-component",
+      "name": "自定义组件开发指南",
+      "desc": "usePopup / useControlled / 动画 / AI 组件 / 类型纪律 / 测试写法（从 docs 迁移）"
+    },
+    {
+      "id": "page-building",
+      "name": "页面组装方法论",
+      "desc": "从零搭页面：页面解剖学五层 + 组装 5 步套路 + 完整示例（\"第一行写什么\"）"
+    },
+    {
+      "id": "layout-choice",
+      "name": "布局选型指南",
+      "desc": "什么时候用哪个原语：决策树（骨架/分区/间距/定位/响应式）+ 组件与原语边界"
+    },
+    {
+      "id": "production",
+      "name": "生产级案例",
+      "desc": "agent-platform 架构提炼：中间件全家桶装配、14 页 SPA 组织、商业化能力"
+    },
+    {
+      "id": "frontend",
+      "name": "前端总览与 API 速查",
+      "desc": "从 docs/frontend.md 迁移（叙述性指南——正文见 content/guides/frontend.md）"
+    },
+    {
+      "id": "components-guide",
+      "name": "组件库使用示例速查",
+      "desc": "从 docs/components.md 迁移（叙述性指南——正文见 content/guides/components-guide.md）"
+    },
+    {
+      "id": "middleware",
+      "name": "中间件与 ctx 注入链",
+      "desc": "从 docs/frontend-middleware.md 迁移（叙述性指南——正文见 content/guides/middleware.md）"
+    },
+    {
+      "id": "server-guide",
+      "name": "后端开发指南",
+      "desc": "从 docs/server.md 迁移（叙述性指南——正文见 content/guides/server-guide.md）"
+    },
+    {
+      "id": "data-guide",
+      "name": "数据层指南（sql/redis）",
+      "desc": "从 docs/data.md 迁移（叙述性指南——正文见 content/guides/data-guide.md）"
+    },
+    {
+      "id": "realtime-guide",
+      "name": "实时能力指南（ws/sse）",
+      "desc": "从 docs/realtime.md 迁移（叙述性指南——正文见 content/guides/realtime-guide.md）"
+    },
+    {
+      "id": "saas-guide",
+      "name": "SaaS 能力指南（auth/limit/email/queue/cron）",
+      "desc": "从 docs/saas.md 迁移（叙述性指南——正文见 content/guides/saas-guide.md）"
+    },
+    {
+      "id": "layout-guide",
+      "name": "布局原语使用指南",
+      "desc": "从 docs/layout.md 迁移（叙述性指南——正文见 content/guides/layout-guide.md）"
+    },
+    {
+      "id": "styling",
+      "name": "样式体系指南",
+      "desc": "从 docs/styling.md 迁移（叙述性指南——正文见 content/guides/styling.md）"
+    },
+    {
+      "id": "mobile-guide",
+      "name": "移动端开发指南",
+      "desc": "从 docs/mobile.md 迁移（叙述性指南——正文见 content/guides/mobile-guide.md）"
+    },
+    {
+      "id": "ui-dom-guide",
+      "name": "前端运行时指南（UIRouter/渲染器）",
+      "desc": "从 docs/frontend-ui-dom.md 迁移（叙述性指南——正文见 content/guides/ui-dom-guide.md）"
+    }
+  ],
+  "needs": [
+    {
+      "id": "admin",
+      "name": "管理后台",
+      "desc": "侧栏导航 + 仪表盘 + 数据表格 + 表单——最常见的企业应用",
+      "template": "admin",
+      "patterns": [
+        "app-shell",
+        "dashboard"
+      ],
+      "components": [
+        "Layout",
+        "Menu",
+        "Table",
+        "Form",
+        "StatCard",
+        "ThemeSwitch",
+        "Pagination"
+      ],
+      "backend": [
+        "sql",
+        "limit"
+      ],
+      "guide": "复制 examples/apps/admin/ → 按改造指南换业务数据 → 加页面"
+    },
+    {
+      "id": "ai-chat",
+      "name": "AI 对话应用",
+      "desc": "流式对话 + 工具调用 + HITL 审批 + 推理展示",
+      "template": "multi",
+      "patterns": [],
+      "components": [
+        "AiChat",
+        "ChatInput",
+        "ToolCallCard",
+        "ApprovalCard",
+        "ReasoningBlock",
+        "SessionList"
+      ],
+      "backend": [
+        "ai",
+        "sse"
+      ],
+      "guide": "wire-fake /api/chat 已就绪——接真实 ctx.ai 换端点即可"
+    },
+    {
+      "id": "auth-app",
+      "name": "登录/权限应用",
+      "desc": "注册登录 + 受保护页 + 会话持久化",
+      "template": "auth",
+      "patterns": [],
+      "components": [
+        "AuthPage",
+        "Form",
+        "Input",
+        "PasswordInput",
+        "Alert"
+      ],
+      "backend": [
+        "auth"
+      ],
+      "guide": "复制 examples/apps/auth/ → 换用户存储（userSystem 中间件）"
+    },
+    {
+      "id": "todo-tool",
+      "name": "工具型应用",
+      "desc": "任务/清单/轻量 CRUD——经典起步应用",
+      "template": "todo",
+      "patterns": [],
+      "components": [
+        "Form",
+        "Input",
+        "Checkbox",
+        "Tag",
+        "EmptyState",
+        "PageHeader"
+      ],
+      "backend": [
+        "sql"
+      ],
+      "guide": "复制 examples/apps/todo/ → 改数据模型（api.ts 表结构）"
+    },
+    {
+      "id": "dashboard",
+      "name": "数据看板",
+      "desc": "KPI 指标 + 图表 + 数据表格——分析型页面",
+      "template": "admin",
+      "patterns": [
+        "dashboard",
+        "data-screen"
+      ],
+      "components": [
+        "StatCard",
+        "Chart",
+        "Table",
+        "Sparkline",
+        "VirtualTable"
+      ],
+      "backend": [
+        "sql"
+      ],
+      "guide": "patterns/dashboard 复制 → Chart 数据接真实 API"
+    },
+    {
+      "id": "content-site",
+      "name": "内容展示站",
+      "desc": "文档站/落地页/营销页——内容为主",
+      "template": "",
+      "patterns": [
+        "docs",
+        "landing"
+      ],
+      "components": [
+        "Markdown",
+        "CodeBlock",
+        "Anchor",
+        "Card",
+        "Badge"
+      ],
+      "backend": [],
+      "guide": "patterns/docs 或 landing 复制 → 填内容"
+    },
+    {
+      "id": "mobile-app",
+      "name": "移动端应用",
+      "desc": "底部 Tab + 安全区 + 移动端适配",
+      "template": "",
+      "patterns": [
+        "mobile"
+      ],
+      "components": [
+        "SearchInput",
+        "List",
+        "Tabs",
+        "Drawer",
+        "Tag"
+      ],
+      "backend": [],
+      "guide": "patterns/mobile 复制 → 移动端断点纪律（44px 命中区）"
+    },
+    {
+      "id": "team-collab",
+      "name": "团队协作工具",
+      "desc": "多应用编排 + 实时协作",
+      "template": "multi",
+      "patterns": [],
+      "components": [
+        "SortableList",
+        "Kanban",
+        "Tabs",
+        "AvatarGroup",
+        "Mentions"
+      ],
+      "backend": [
+        "ws",
+        "queue"
+      ],
+      "guide": "复制 examples/apps/multi/ → 加子应用（registerApp）"
+    }
+  ],
+  "cases": [
+    {
+      "id": "agent-platform",
+      "name": "agent-platform",
+      "type": "production",
+      "desc": "多租户 AI Agent 平台——认证/AI 引擎/实时消息/沙箱/工具链/商业化全家桶",
+      "highlights": [
+        "中间件全量消费方",
+        "14 页 SPA",
+        "私有化部署",
+        "实战驱动框架开发"
+      ],
+      "url": "https://github.com/weifuwu/weifuwu/tree/main/apps/agent-platform"
+    },
+    {
+      "id": "showcase",
+      "name": "showcase 平台",
+      "type": "showcase",
+      "desc": "本平台自身——weifuwu 发展引擎（用 weifuwu 构建的网站，自举证明）",
+      "highlights": [
+        "六域 500+ 文档",
+        "157 组件活体",
+        "SSR + SPA 双轨",
+        "LLM 友好"
+      ],
+      "url": "https://weifuwu.dev"
+    },
+    {
+      "id": "todo-app",
+      "name": "任务管理应用",
+      "type": "template",
+      "desc": "todo 模板——多页路由 + createStore 跨页状态 + MemorySql 持久化",
+      "highlights": [
+        "全栈模板",
+        "复制即用"
+      ],
+      "url": "https://github.com/weifuwu/weifuwu/tree/main/examples/apps/todo"
+    },
+    {
+      "id": "admin-app",
+      "name": "管理后台应用",
+      "type": "template",
+      "desc": "admin 模板——AppShell + 多页 + 表格 + KPI",
+      "highlights": [
+        "Layout 骨架",
+        "路由 layout 包裹"
+      ],
+      "url": "https://github.com/weifuwu/weifuwu/tree/main/examples/apps/admin"
+    },
+    {
+      "id": "auth-app",
+      "name": "登录注册应用",
+      "type": "template",
+      "desc": "auth 模板——登录/注册/受保护页/会话持久化",
+      "highlights": [
+        "路由守卫",
+        "AuthPage 组件"
+      ],
+      "url": "https://github.com/weifuwu/weifuwu/tree/main/examples/apps/auth"
+    },
+    {
+      "id": "multi-app",
+      "name": "应用编排工作台",
+      "type": "template",
+      "desc": "multi 模板——父应用嵌子应用（registerApp + 边界事件）",
+      "highlights": [
+        "多应用",
+        "独立状态"
+      ],
+      "url": "https://github.com/weifuwu/weifuwu/tree/main/examples/apps/multi"
+    }
+  ]
+}