阶段一交付物之二。本矩阵是专栏的覆盖率验收基线：任何知识点不允许没有归属篇目；矩阵未 100% 勾选前专栏不得宣告完结。每交付一批文章，更新「状态」列（
☐待写 /▣已交付 /✔已复核）。锚点列已按 2026-09-16 修复战役与深化考据后的实态修正。
| # | 知识点 | 关键事实锚点 | 归属篇目 | 状态 |
|---|---|---|---|---|
| A1 | 仓库定位：AI 协作研发组件库的动机、成本结构与发布现状 | 四包已发布（base 1.1.0 / pro 2.0.0 / primitives 1.1.0 / mcp 0.1.1）；changesets git tag 与 npm 对齐 | 1-01 | ☑ |
| A2 | Monorepo 分层与依赖治理 | 6 包 2 应用；依赖严格单向 pro→base→primitives；内部依赖 peer 化（pro-components/package.json peerDependencies workspace:^）；docs/playground 零依赖声明靠 alias | 1-02 | ☑ |
| # | 知识点 | 关键事实锚点 | 归属篇目 | 状态 |
|---|---|---|---|---|
| B1 | pnpm workspace 组织 | pnpm-workspace.yaml 三组 glob；packageManager 锁定 pnpm@10.30.3；根 scripts 全景（含 check:tokens/check:llms 两道生成物守卫） | 2-01 | ☑ |
| B2 | 一套 alias 服务四条工具链 | scripts/config/aliases.ts（116 行）被库构建/vitest/文档站/playground 复用；CSS 别名先于 JS、精确先于正则的排序规则；@xiaoye/* 与 npm 裸名双形式覆盖 | 2-01 | ☑ |
| B3 | 构建体系：ES-only 单格式与构建工厂 | scripts/config/library-build.ts createLibraryConfig（84 行）；三库包零自有 vite 配置；vite.config.ts/vite.primitives.config.ts/vite.pro.config.ts 三入口；pro 的 extraExternal 外部化基础库；xlsx 独立 chunk | 2-02 | ☑ |
| B4 | 样式分发与 tree-shaking 安全 | sideEffects: ["*.css","**/*.css"]；exports["./style.css"] 子路径；vite 编译出 dist/index.css + prepare-package 补写 style.css | 2-02 | ☑ |
| B5 | d.ts 后处理管线（上）：specifier 重写 | scripts/prepare-package.mjs（808 行）：@xiaoye/* → npm 名；.ts→.js、.vue→.vue.js 文件系统探测；primitives symlink 断链回落 | 2-03 | ☑ |
| B6 | d.ts 后处理管线（下）：泛型简化与 index.d.ts 重建 | 手写词法扫描器简化 SFCWithInstall 泛型；TS Compiler API 解析 withInstall/withInstallFunction 重建声明；InstanceType 降级 | 2-03 | ☑ |
| B7 | Changesets 版本策略 | .changeset/config.json：fixed 为空（四包独立版本）、updateInternalDependencies patch、GitHub changelog 生成器 | 2-04 | ☑ |
| B8 | release.yml 发布流水线与门禁兜底 | permissions 设计；concurrency 防并发；fork 仓库 guard；发布前重跑 check/typecheck/test/build:lib | 2-04 | ☑ |
| B9 | ci.yml 门禁编排 | check → lint → typecheck → test → build 的 job 顺序；--no-file-parallelism 防 OOM 踩坑注释；e2e 独立 job | 2-05 | ☑ |
| B10 | docs.yml 与文档部署边界 | 仅构建冒烟、无部署 job 的取舍 | 2-05 | ☑ |
| B11 | 文档站架构（上）：配置与主题 | apps/docs/.vitepress/config.ts 侧边栏从 manifest 生成；theme/index.ts 的 enhanceApp 全量安装两层库；configProviderContext zIndex 2100 注入；syncDataTheme 暗色联动 | 2-06 | ☑ |
| B12 | 文档站架构（中）：demo 三件套 | plugins/demo.ts（:::demo 容器）、plugins/markdown-transform.ts（pre-transform 注入异步导入）、plugins/demo-source.ts（virtual:xy-demo-source 虚拟模块） | 2-07 | ☑ |
| B13 | 文档站架构（下）：TS/JS 双源与构建优化 | utils/ts2js.ts transpileModule 现场转译；sandbox 判定；manualChunks vendor 拆分；cssCodeSplit 踩坑（修复 commit 075b46b） | 2-07 | ☑ |
| B14 | Playground 联调机制 | vite.config 复用 alias 直连源码热更；App.vue 类型消费冒烟；main.ts 样式走别名表（2026-09-16 断链修复后实态） | 2-08 | ☑ |
| B15 | llms 文档生成 | scripts/generate-llm-files.mjs（501 行）：md 表格反向解析（中文表头/转义竖线）、TYPE_EXPANSIONS 25 条、api-schema.json + llms-full.txt 双产物；同步由 check:llms 守卫（2026-09-16 新增） | 2-09 | ☑ |
| B16 | MCP Server 架构 | packages/mcp-server/src/index.ts（268 行）：三工具（list/get/search）、"Did you mean" 纠错、instructions 选型指导 prompt；data.ts 装载链路 | 2-09 | ☑ |
| B17 | e2e 以文档站为宿主 | playwright.config.ts webServer 起 vitepress dev；admin-flow.spec.ts 业务闭环；clickInViewCenter 的吸顶遮挡/固定列镜像解法；docs-demos 含 dialog 遮罩真实 hit-testing 用例（2026-09-16 补位） | 10-04 | ☑ |
| B18 | TypeScript 工程组织 | tsconfig/base.json + packages/apps/types 三工程 composite + references；vue-tsc 分命令 | 2-05 | ☑ |
| # | 知识点 | 关键事实锚点 | 归属篇目 | 状态 |
|---|---|---|---|---|
| C1 | 令牌三层架构总览 | tokens.css 410 行：基元 58 / 语义 66 / 刻度 45（字重 12 档）；命名模板唯一；暗色覆写 59 + @deprecated 48 | 3-01 | ☑ |
| C2 | 基元层色板体系 | 六族色板（gray/purple/green/amber/red/blue）逐阶锚定 Stripe 官方值；注释可追溯 | 3-02 | ☑ |
| C3 | 语义层角色体系 | 文字 7 级 / 背景 8 级亮度阶梯 / 状态色六件套命名契约（base/hover/active/soft/soft-hover/text × 4 族）/ 阴影五级 / z-index 语义阶梯 | 3-02 | ☑ |
| C4 | 刻度层体系 | 九档字号无坍缩、字重 12 档（语义 5 档+数值微调 7 档，2026-09-16 扩档）、8px 基准间距网格、三时长三缓动 | 3-02 | ☑ |
| C5 | 双主题切换协议 | [data-theme="dark"] 属性（非 class/媒体查询）；暗色只覆写语义层；组件 CSS 零暗色分支；文档站 syncDataTheme 接入 | 3-03 | ☑ |
| C6 | --xy-mix-light 反转技巧 | 亮色 #ffffff → 暗色 var(--xy-bg-container)；800+ 处 color-mix 同一公式双语义 | 3-03 | ☑ |
| C7 | Stripe 蓝本可追溯性 | 文件头注释 + 逐阶内联注释（purple-600 官方 stripe purple 等）+ AGENTS.md/docs 多处一致 | 3-04 | ☑ |
| C8 | generate:tokens 生成链路 | scripts/generate-tokens.mjs（115 行）：正则解析 → classify() 三分类 → toCamel → 4 个 as const TS 文件；var() 引用原样字符串化；同步由 check:tokens 守卫（2026-09-16 新增） | 3-05 | ☑ |
| C9 | theme 包样式组织 | index.css 聚合结构；BEM 变体（xy-block__el--mod + is-state）；纯原生 CSS 无预处理器无 @layer | 3-06 | ☑ |
| C10 | 可配置命名空间 | use-namespace.ts 从 useConfig 读前缀；ConfigProvider 整库换前缀（CSS 侧硬编码 .xy- 不联动的边界） | 3-06 | ☑ |
| C11 | 组件级变量层（第四层定制纵深） | 378 个 --xy-{block}-{slot}；alert.css 组件变量实例；全局语义覆写 vs 实例覆写两级定制 | 3-06 | ☑ |
| C12 | 组件样式令牌消费纪律 | 只消费语义层+刻度层（AGENTS.md 约定）；button.css 全链实例；基元层零直接引用 | 3-06 | ☑ |
| # | 知识点 | 关键事实锚点 | 归属篇目 | 状态 |
|---|---|---|---|---|
| D1 | manifest 数据结构与派生 | installExports/installChecks/styleImports 三字段语义；check kinds（component/directive/globalProperty） | 4-01 | ☑ |
| D2 | check-components 六向一致性校验 | scripts/check-components.mjs（134 行）：目录/导出/文档/夹具/单测/样式六面双向 diff；挂进 lint 即门禁 | 4-01 | ☑ |
| D3 | withInstall 双别名注册 | utils/vue/with-install.ts：PascalCase + kebab-case 同时注册 | 4-02 | ☑ |
| D4 | withInstallFunction 与 AppContext 捕获 | 闭包捕获 app._context；快捷方法白名单重绑；withContext 逃生舱；多 Provider warnOnce | 4-02 | ☑ |
| D5 | Symbol.for 幂等安装锁 | Symbol.for("xiaoye-components:installed")；鸭子类型过滤 installable exports（新增组件零改包入口） | 4-02 | ☑ |
| D6 | 标准组件解剖：类型层 | src/<name>.ts：as const 元组派生联合、Props interface、InstanceType、事件 handler 独立命名、DEFAULT_* 常量 | 4-03 | ☑ |
| D7 | 标准组件解剖：视图层与逻辑层 | .vue 视图 + use-*.ts 逻辑 hook；runtime props 对象（dialog）vs 泛型类型声明（button）两条路线的取舍 | 4-03 | ☑ |
| D8 | 开发态护栏即文档 | isDev() + watchEffect + warnOnce（button 互斥归一化/a11y 提示）；单测逐条断言告警 | 4-03 | ☑ |
| D9 | use-controlled 受控双模 | 8 行 writable computed；零消费死代码考古与双模现状（watch 回同步方案）；已加 @deprecated（2026-09-16） | 4-04 | ☑ |
| D10 | 浮层可见性状态机 | visible/rendered/isAnimating 三态正交；openDelay/closeDelay；before/on 回调协议；persistent 懒卸载；isAnimating 已加 @deprecated（语义漂移立案） | 4-05 | ☑ |
| D11 | 全局浮层栈与栈顶裁决 | 模块级 Set + zIndexCounter 2000；响应式 Set 整体重赋值技巧；isTopMost 防"一按全关"；zIndex 已 Ref 化（缓存缺陷 2026-09-16 修复） | 4-05 | ☑ |
| D12 | floating-ui 定位管道 | offset→flip→shift→size(matchTriggerWidth)→arrow 中间件序；toRaw 解包；autoUpdate 启停时机 | 4-06 | ☑ |
| D13 | 关闭语义统一收口 | use-dismissible-layer：Escape 复合闸+栈顶闸 / 外点 contains 判定（触发器必入排除集）/ 遮罩 down-up 配对防误关 | 4-06 | ☑ |
| D14 | 焦点陷阱工程化 | Tab 循环、autofocus 策略、lastFocusReason 追踪、focusout 延迟+preventDefault 协议、vitest teardown 防御注释；focus utils（focusableSelector/trapFocus） | 4-07 | ☑ |
| D15 | 滚动锁与双 zIndex 体系 | lockBodyScroll 计数器式叠加；useZIndex 瞬态层 vs overlayStack 进栈层；CSS z 语义阶梯（1000→1400）与倒挂修复史；lockScroll 已由 use-overlay-dialog 配对消费（2026-09-16 补上） | 4-07 | ☑ |
| D16 | 表单联动体系 | formKey/formItemKey 两个 Symbol context；字段收集/validate 编排（async-validator）；控件 inject 契约（disabled/inputId/aria 链路/validateEvent） | 4-08 | ☑ |
| D17 | 全局配置链 | configProviderKey（Symbol.for 跨包共享）；useConfig 八项配置优雅降级；shared-context 默认值；form 级 size/disabled 级联已闭合（2026-09-16） | 4-08 | ☑ |
| D18 | group 复合模式 + 泛型组件 + 服务式形态 | group provide/emit 收口（radio/checkbox/button/avatar 四组对比）；select generic 全链路；message 分桶/max/grouping 治理 + dialog 队列服务 + loading 指令双形态 | 4-09 ~ 4-12 | ☑ |
每个组件的知识点 = 该组件区别于通用范式的专属机制。通用范式（D 卷）在组件篇中只引用不重复展开。72 个 manifest 组件各一篇 + form-item 独立成篇（6-18）。
| # | 组件 | 专属知识点 | 篇目 | 状态 |
|---|---|---|---|---|
| E1 | icon | Iconify 按需渲染；data-icon 测试契约（vitest.setup mock） | 5-01 | ☑ |
| E2 | button | as const 类型派生范本；开发态护栏；use-button 的 form（reset 联动）/group 双 inject；ButtonGroup | 5-02 | ☑ |
| E3 | link | 语义化链接与 button 的复用边界 | 5-03 | ☑ |
| E4 | breadcrumb | 父收集子槽位注册模式（BreadcrumbItem） | 5-04 | ☑ |
| E5 | text | 排版刻度令牌消费范本 | 5-05 | ☑ |
| E6 | badge | 徽标独立/依附双形态与溢出 | 5-06 | ☑ |
| E7 | avatar | AvatarGroup 折叠溢出（vnode 扫描 + slice 裁剪）；shape/size 下发 | 5-07 | ☑ |
| E8 | image | 懒加载/占位/错误态；image-viewer 预览浮层（滚动锁消费方） | 5-08 | ☑ |
| E9 | watermark | canvas 水印 tile 平铺与 MutationObserver 防篡改 | 5-09 | ☑ |
| E10 | card | 卡片 slot 结构约定（header 双通道连坐/三态 body） | 5-10 | ☑ |
| E11 | check-card | 卡片化受控选择（CheckCardGroup 零 provide 第三路线） | 5-11 | ☑ |
| E12 | carousel | CarouselItem 索引注册与轮播状态机；timerToken 世代定时器治理 | 5-12 | ☑ |
| E13 | affix | scroll 监听与固定定位计算（占位盒测量消解坐标悖论） | 5-13 | ☑ |
| E14 | anchor | 滚动监听与高亮联动（last-crossing 判定 + 点击锁定） | 5-14 | ☑ |
| E15 | menu | MenuItem/SubMenu 层级注册；sub-menu 浮层复用（仅 useFloatingPanel） | 5-15 | ☑ |
| E16 | row | 栅格 provide（gutter 下发）；flex 对齐 | 5-16 | ☑ |
| E17 | col | 响应式断点 props 矩阵；col.css 3020 行最大样式文件的生成逻辑 | 5-17 | ☑ |
| E18 | scrollbar | 原生 overflow 封装（混合三段式）与 expose 滚动方法 | 5-18 | ☑ |
| E19 | splitter | 拖拽几何与面板尺寸受控（会话协议统一双输入） | 5-19 | ☑ |
| E20 | divider | 最小组件的完整规范样本 | 5-20 | ☑ |
| E21 | tag | ComponentStatus 通用状态类型消费样本 | 5-21 | ☑ |
| E22 | space | 间距方案（实考：零遍历纯 gap 直排） | 5-22 | ☑ |
| E23 | tabs | 激活态管理与面板联动（乐观切换 + 指示条 JS 测量） | 5-23 | ☑ |
| # | 组件 | 专属知识点 | 篇目 | 状态 |
|---|---|---|---|---|
| F1 | config-provider | 全局配置源头八项；Symbol.for 跨包 context（双通道：provide 树 + 服务注册表） | 6-01 | ☑ |
| F2 | input | displayValue/modelValue 双轨；formatter/parser 管道；手写 lazy/number/trim 修饰符；IME composition 保护；formItem 全量联动 | 6-02 | ☑ |
| F3 | auto-complete | input + 浮层 + list-navigation 三合一组合 | 6-03 | ☑ |
| F4 | cascader | 多级面板联动与懒加载（selectedValue 兼任展开路径） | 6-04 | ☑ |
| F5 | radio | radio/radio-button/group 三形态同一 context（60 行复制债实况） | 6-05 | ☑ |
| F6 | checkbox | min/max 数量约束；options 配置化 + type 切换 | 6-06 | ☑ |
| F7 | switch | 最小受控组件范本（纯直通 + withDefaults 钉死的假非受控） | 6-07 | ☑ |
| F8 | input-tag | 复合输入态（标签流 + 输入框；拖拽子系统 + delimiter） | 6-08 | ☑ |
| F9 | input-number | 步进/精度/边界处理（guard-digit 自愈管线） | 6-09 | ☑ |
| F10 | rate | hover 预览与键盘可达（命令式 currentValue 单值缓存 + role=slider） | 6-10 | ☑ |
| F11 | slider | 拖拽几何计算与 range 双端点（absolute 坐标模型 + 十进制修约吸附） | 6-11 | ☑ |
| F12 | date-picker | dayjs 封装与日历面板状态机（类型零外泄 + 三轨分离） | 6-12 | ☑ |
| F13 | time-picker | 时间面板与列表选择（负发现：无滚动吸附，点选+草稿+确定） | 6-13 | ☑ |
| F14 | time-select | 基于 select 的选项生成特化（负发现：代码零复用，交互同构 + 内联 disabled 标记） | 6-14 | ☑ |
| F15 | select | generic="T" 全链路泛型；FlatSelectOption 拍平模型；键盘导航巨型 switch（10 分支 + 95 行引擎分工） | 6-15 | ☑ |
| F16 | tree-select | tree + 浮层 + 多选值映射（砍掉多选的单选通道，DFS 回显无索引） | 6-16 | ☑ |
| F17 | form | 字段收集与 validate/resetFields 编排（async-validator 零封装；失败 resolve false 永不 reject） | 6-17 | ☑ |
| F18 | form-item | label 布局、错误消息与 aria-invalid/aria-describedby 链路（双通道同 ref 驱动） | 6-18 | ☑ |
| F19 | upload | 文件队列、拖拽与自定义请求（三态请求分支 + objectURL 登记簿） | 6-19 | ☑ |
| F20 | editor | vditor 集成与受控桥接（值比对断环 + 半适配主题） | 6-20 | ☑ |
| # | 组件 | 专属知识点 | 篇目 | 状态 |
|---|---|---|---|---|
| G1 | alert | 语义状态色派生 + 组件变量头（29 个 --xy-alert-*；服务形态属 createApp 家族变奏） | 7-01 | ☑ |
| G2 | message | 命令式消息治理：分桶/max/grouping+repeatNum/快照/closeAll 过滤/pauseOnHover（670 行样本） | 7-02 | ☑ |
| G3 | notification | 组件与服务双形态并存设计（同渲染体 + overflowStrategy） | 7-03 | ☑ |
| G4 | backtop | 滚动目标解析与可见性阈值（显式 target + window 兜底双分支） | 7-04 | ☑ |
| G5 | collapse | 手风琴模式与 item 展开状态（入口/出口双适配函数 + 零注册） | 7-05 | ☑ |
| G6 | collapse-transition | height 过渡 JS hook 的通用实现（max-height 方案 + 零 props） | 7-06 | ☑ |
| G7 | empty | 无逻辑组件的规范化样本（七条契约 + locale 通道） | 7-07 | ☑ |
| G8 | loading | v-loading 指令生命周期 + $loading 服务双注册（四路 data 属性引用计数） | 7-08 | ☑ |
| G9 | skeleton | useThrottleRender leading/trailing 防闪烁（82 行单消费方抽象） | 7-09 | ☑ |
| G10 | result | 预设场景组合（status+icon 双入口 × 映射表 + 类型层前移） | 7-10 | ☑ |
| G11 | tooltip | 浮层四件套最小消费样本（三件拆分 + enterable 竞速窗口） | 7-11 | ☑ |
| G12 | popover | trigger 策略全集（click/hover/focus/manual 四值 + 动画期 toggle 守卫） | 7-12 | ☑ |
| G13 | popconfirm | popover + 动作确认的组合封装（内嵌 XyTooltip + locale 四键占二） | 7-13 | ☑ |
| G14 | dropdown | list-navigation 键盘导航与菜单语义（真 roving tabindex + command 协议） | 7-14 | ☑ |
| G15 | transfer | 双栏数据流与 keys 同步（右栏真相源派生树 + 孤儿键静默滞留） | 7-15 | ☑ |
| G16 | dialog | overlay-dialog 编排 + focus-trap + 服务队列（service-state.ts）+ 13 事件全解（遮罩判定失效已修复） | 7-16 | ☑ |
| G17 | drawer | dialog 的容器变体与差异点（基建共享 + 四方向几何 + pointer 放行） | 7-17 | ☑ |
| # | 组件 | 专属知识点 | 篇目 | 状态 |
|---|---|---|---|---|
| H1 | statistic | 数值格式化与过渡动画（formatter 逃生口 + 前瞻正则分组；动画负发现） | 8-01 | ☑ |
| H2 | countdown | 定时器管理与暂停/恢复（rAF 墙钟重算 + 无 paused prop 的外置协议） | 8-02 | ☑ |
| H3 | progress | line/circle 形态与 SVG 描边（五环几何管道 + color 三形态） | 8-03 | ☑ |
| H4 | steps | 步骤状态派生（注册制厚名片 + error 不截断双通道） | 8-04 | ☑ |
| H5 | timeline | vnode 扫描与 cloneVNode 注入（考据修正：非注册模式） | 8-05 | ☑ |
| H6 | scheduler | fullcalendar 集成与事件模型（自研 RRULE 窗口化物化 + 收敛协议路线） | 8-06 | ☑ |
| H7 | descriptions | schema 化描述渲染（17 字段 schema + display-value 共享底座 471 行） | 8-07 | ☑ |
| H8 | tree | tree-store 状态管理、扁平/树形互转、dev.ts 消费方（考据修正：消费的是 warnOnce 非 deprecated） | 8-08 | ☑ |
| H9 | table | 列模型/固定列/排序筛选；DOM 镜像九面板（4 条同步链）；filter-panel 浮层复用 | 8-09 | ☑ |
| H10 | pagination | 页码窗口计算（四分支窗口算法 + EP 同款 layout 协议） | 8-10 | ☑ |
| H11 | charts | echarts 封装与令牌取色（负发现：零令牌消费，第三形态直通） | 8-11 | ☑ |
| H12 | audio-player | howler 封装（playing 门控 rAF 轮询 + 交互件全复用） | 8-12 | ☑ |
| H13 | video-player | video.js 封装与皮肤令牌化（v8 零变量 → 3 条选择器覆写桥） | 8-13 | ☑ |
| # | 篇目 | 主题 | 专属知识点 | 状态 |
|---|---|---|---|---|
| I1 | 9-01 | 增强层总览 | exports.ts/index.ts/core.ts 三层分工；根入口类型白名单；check-pro-components 十一组校验；pro-root-boundary 双包名负向夹具；exports 只开 "." 与 "./style.css" | ☑ |
| I2 | 9-02 | core.ts 协议层 | 请求协议 + 展示协议（14 种 valueType）+ schema 协议（ProFieldSchema）；request-utils 归一化（实考：四族 16 类型 + 两形状归一） | ☑ |
| I3 | 9-03 | field-schema 底座 | builtInComponentMap 23 内建组件映射；placeholder 推导；hidden/disabled 函数式联动；一份 schema 三形态 | ☑ |
| I4 | 9-04 | search-form | 查询/重置语义 + 折叠展开（字段级 collapsible + 快照载荷） | ☑ |
| I5 | 9-05 | pro-form | schema → Grid 布局；readonly 整表切换 XyDescriptions（双条件切换） | ☑ |
| I6 | 9-06 | overlay-form | container: drawer/modal 多态容器；mode: create/edit/view 驱动；structuredClone 快照 payload（仅出口快照） | ☑ |
| I7 | 9-07 | dialog-form | Omit 派生薄壳（10 行类型 + 61 行模板；v-bind 全量 + 动态 slot 单通道） | ☑ |
| I8 | 9-08 | drawer-form | 与 dialog-form 对称的特化（5 处 diff 56 行同 + 三方案镜像账） | ☑ |
| I9 | 9-09 | steps-form | 分步表单（考据修正：单实例 + schema 切换，注册制天然分步校验） | ☑ |
| I10 | 9-10 | request-form | 初始加载/提交请求 + async-state 集成（协议薄第三形态） | ☑ |
| I11 | 9-11 | login-form | 登录预设与第三方登录项（领域不变量七项写死 + 纯数据第三方协议） | ☑ |
| I12 | 9-12 | filter-panel | 卡片式筛选面板（纯布局容器 + 双 filter-panel 重名辨析） | ☑ |
| I13 | 9-13 | page-toolbar | 纯插槽容器布局件（heading/actions/default 三区 + 零逻辑纪律） | ☑ |
| I14 | 9-14 | page-header | 页头结构与 meta 区（metaItems 双通道 + 零返回键零路由假设） | ☑ |
| I15 | 9-15 | page-container | loading 视觉内聚（组件级内嵌 XyLoadingIndicator + 内容区替换语义） | ☑ |
| I16 | 9-16 | avatar-menu | 头像下拉组合（items 直通 legacy 路径 + command 削参反向收敛） | ☑ |
| I17 | 9-17 | header-tabs | 页签 + 下拉动作（items 轨优先消费 + 关闭流责任外置） | ☑ |
| I18 | 9-18 | notice-center | 多 tab 通知列表（Tabs/Tag/Empty 组合）（分组数据源 + 已读弱化非红点） | ☑ |
| I19 | 9-19 | stat-card | 指标卡趋势与骨架（与 statistic 竞品定性 + trend 三态语义色） | ☑ |
| I20 | 9-20 | async-state-container | loading/empty/error 三态容器协议（v-if 裁决链 + 两消费壳插槽收缩为零） | ☑ |
| I21 | 9-21 | list-page | 薄预设封装：三件翻译（request 包装/searchFields→views/有请求才分页）；显式 + v-for 动态插槽双通道透传 | ☑ |
| I22 | 9-22 | crud-page | 三级金字塔顶层：行动作推断 create/edit、自动注入新建按钮（删除流未内建） | ☑ |
| I23 | 9-23 | split-layout-page | Splitter 页面级封装（page 壳四件套 + size 单向语义分层） | ☑ |
| I24 | 9-24 | pro-table（配置模型） | ProTableColumn 扩展面：valueType/formatter/render/editor 声明；workbench 八开关；request/views/editable/virtual/contextmenu 配置对象（views 实为 7 键） | ☑ |
| I25 | 9-25 | pro-table（运行时引擎） | 递归列渲染器；latestRequestId 竞态防护；参数合并序；CSV/xlsx 动态导入导出；Sortable 拖拽挂载；Fullscreen API；Instance 透传契约（29 成员） | ☑ |
| I26 | 9-26 | column-setting-panel | 列显隐/固定/排序（sortablejs）（实考：面板只管显隐，固定/排序在 pro-table 主题域） | ☑ |
| I27 | 9-27 | saved-view-tabs | 保存视图页签（key 无 params 身份语义分离；addable 死 prop 已修复） | ☑ |
| I28 | 9-28 | table-filter-drawer | schema 驱动筛选抽屉（直绑无草稿 + 四件套筛选家族终表） | ☑ |
| I29 | 9-29 | import-result-table | 导入结果回显（summary 外置零派生 + 内嵌 ProTable 裁剪成只读预览） | ☑ |
| I30 | 9-30 | audit-timeline | 审计流渲染（八字段协议 + 五档流程词三路出口） | ☑ |
| I31 | 9-31 | detail-panel | drawer/dialog 详情浮层（schema → descriptions）（四级管线单行接线 + 容器词表漂移） | ☑ |
| I32 | 9-32 | detail-page | 异步态 + 描述 + 审计的整页组装（纯受控无 request；retry 断链已修复为转发链） | ☑ |
| I33 | 9-33 | approval-flow-panel | 审批流节点面板（:items 断桥已修复 + 自绘 button 链实态） | ☑ |
| I34 | 9-34 | import-wizard | 分步导入向导（80 行纯壳；:items 断桥与 prev 差一均已修复） | ☑ |
| I35 | 9-35 | export-task-panel | 导出任务进度面板（六字段四态 + 轮询外置 + 与同步导出的场景分野） | ☑ |
| # | 知识点 | 关键事实锚点 | 归属篇目 | 状态 |
|---|---|---|---|---|
| J1 | 单测策略与基建 | vitest + jsdom + globals；icon mock 契约；中文用例描述惯例；a11y 断言风格；CI --no-file-parallelism（实考：114 spec/1020 it 七类断言分类学） | 10-01 | ☑ |
| J2 | 类型测试夹具体系 | 105 夹具 @ts-expect-error 负向断言双向锁死；独立 tsconfig；与 manifest 强制对应（215 断言零 ts-ignore） | 10-02 | ☑ |
| J3 | 视觉回归巡检 | visual-audit.mjs 341 行：元素级截图 × 双主题 × pixelmatch 0.5%；基线三模式；1064 张全一致的噪音决策（双层阈值判定） | 10-03 | ☑ |
| J4 | e2e 与发布门禁汇总 | admin-flow 业务闭环；helpers 踩坑封装；check→lint→type→test→build→release 六道门禁全景 | 10-04 | ☑ |
| # | 知识点 | 关键事实锚点 | 归属篇目 | 状态 |
|---|---|---|---|---|
| K1 | AI 协作研发组件库方法论 | 全库 AI 编写的分层验证策略：机器可校验约定如何替代人工 review；三层测试如何兜底（守卫覆盖矩阵 + 修复战役实证） | 11-01 | ☑ |
| K2 | 约定驱动开发（AGENTS.md 即规范） | AGENTS.md 作为机器可执行规范；manifest 主源原则；守卫脚本把约定 lint 化（41 条三档分类） | 11-02 | ☑ |
| K3 | 组件库的 AI 生态闭环 | 文档 → llms → api-schema → MCP 的数据流；AI 消费组件库的四层架构（check:llms 守卫后完成度更新） | 11-03 | ☑ |
| 卷 | 篇数 | 知识点数 |
|---|---|---|
| 第一卷 全景开篇 | 2 | 2 |
| 第二卷 工程化基座 | 9 | 17（B1~B16、B18） |
| 第三卷 设计令牌 | 6 | 12 |
| 第四卷 组件通用架构 | 12 | 18（D1~D18） |
| 第五~八卷 基础组件 | 73 | 73（E1 |
| 第九卷 增强层 | 35 | 35 |
| 第十卷 质量保障 | 4 | 4 |
| 第十一卷 方法论收官 | 3 | 3 |
| 合计 | 144 | 164 |
注：B17（e2e）与 J4 合并覆盖于 10-04；部分机制知识点会在组件篇中复用讲解但不重复计数。篇数按「全部独立成篇」口径统计：72 个 manifest 组件各一篇，form-item 无独立 manifest 条目但协议独立成篇（6-18），故基础组件篇为 73 篇、合计 144 篇。若用户选择合并方案将同步修订矩阵归属列。