create-yss-spec 2.1.10 → 2.1.13

package/template/.cursor/skills/yss-ui/assets/reference-index.md

@@ -0,0 +1,74 @@
+# yss-ui 引用索引
+
+## 说明
+
+- 本索引从以下文件提取依赖引用并校验可达性：
+  - `../SKILL.md`
+  - `../references/quick-recipes.md`
+  - `../references/checklist.md`
+- 目标：集中沉淀到 `assets`，便于快速定位文档与示例。
+- 已将引用文档复制到：`./docs`
+- 已将引用样例复制到：`./demos`
+- 校验结果：以下引用路径均已存在。
+
+---
+
+## A. 文档引用（Docs）
+
+| 分类       | 原引用路径                       | 本地副本路径                            |
+| ---------- | -------------------------------- | --------------------------------------- |
+| Components | `components/table.md`            | `./docs/components/table.md`            |
+| Components | `components/editTable.md`        | `./docs/components/editTable.md`        |
+| Components | `components/formily.md`          | `./docs/components/formily.md`          |
+| Components | `components/tree.md`             | `./docs/components/tree.md`             |
+| Components | `components/split-pane.md`       | `./docs/components/split-pane.md`       |
+| Components | `components/monaco.md`           | `./docs/components/monaco.md`           |
+| Components | `components/echarts.md`          | `./docs/components/echarts.md`          |
+| Components | `components/fileImport.md`       | `./docs/components/fileImport.md`       |
+| Components | `components/conditionBuilder.md` | `./docs/components/conditionBuilder.md` |
+| Components | `components/cron.md`             | `./docs/components/cron.md`             |
+| Components | `components/card.md`             | `./docs/components/card.md`             |
+| Components | `components/button.md`           | `./docs/components/button.md`           |
+| Components | `components/sheet.md`            | `./docs/components/sheet.md`            |
+| Hooks      | `hooks/use-table-height.md`      | `./docs/hooks/use-table-height.md`      |
+| Hooks      | `hooks/use-tree-height.md`       | `./docs/hooks/use-tree-height.md`       |
+| Hooks      | `hooks/useFullscreen.md`         | `./docs/hooks/useFullscreen.md`         |
+| Hooks      | `hooks/useLoading.md`            | `./docs/hooks/useLoading.md`            |
+| Guide      | `guide/index.md`                 | `./docs/guide/index.md`                 |
+| Guide      | `guide/installation.md`          | `./docs/guide/installation.md`          |
+| Guide      | `guide/jsp.md`                   | `./docs/guide/jsp.md`                   |
+| Guide      | `guide/llms.md`                  | `./docs/guide/llms.md`                  |
+| Guide      | `guide/release-workflow.md`      | `./docs/guide/release-workflow.md`      |
+| Guide      | `guide/gitlab-ci-integration.md` | `./docs/guide/gitlab-ci-integration.md` |
+| Guide      | `guide/monorepo-versioning.md`   | `./docs/guide/monorepo-versioning.md`   |
+| Root       | `resources.md`                   | `./docs/root/resources.md`              |
+
+---
+
+## B. 样例引用（Demos）
+
+| 组件              | 原引用模式                                  | 本地副本目录                |
+| ----------------- | ------------------------------------------- | --------------------------- |
+| YTable            | `docs/components/demos/table/*`             | `./demos/table`             |
+| YEditTable        | `docs/components/demos/edit-table/*`        | `./demos/edit-table`        |
+| YssFormily        | `docs/components/demos/formily/*`           | `./demos/formily`           |
+| YTree             | `docs/components/demos/tree/*`              | `./demos/tree`              |
+| SplitPane         | `docs/components/demos/split-pane/*`        | `./demos/split-pane`        |
+| YMonaco           | `docs/components/demos/monaco/*`            | `./demos/monaco`            |
+| YEcharts          | `docs/components/demos/echarts/*`           | `./demos/echarts`           |
+| YFileImport       | `docs/components/demos/file-import/*`       | `./demos/file-import`       |
+| YConditionBuilder | `docs/components/demos/condition-builder/*` | `./demos/condition-builder` |
+| YCron             | `docs/components/demos/cron/*`              | `./demos/cron`              |
+| YCard             | `docs/components/demos/card/*`              | `./demos/card`              |
+| YButton           | `docs/components/demos/button/*`            | `./demos/button`            |
+
+---
+
+## C. 快速打开建议
+
+- 组件 API：优先打开 `A. 文档引用` 中对应 `components/*.md`。
+- 真实样例：优先打开 `B. 样例引用` 中对应目录下 `index.vue`。
+- 表格/树高度问题：先看 `hooks/use-table-height.md` 与 `hooks/use-tree-height.md`。
+- DOM 模板插槽命名问题：先看 `guide/jsp.md` 与 `components/table.md` 插槽章节。
+- 业务场景检索：优先打开 `./scenario-index.md` 按场景快速跳转。
+- 关键词反向定位：优先打开 `./keyword-index.md` 按关键词快速跳转。

package/template/.cursor/skills/yss-ui/assets/scenario-index.json

@@ -0,0 +1,50 @@
+{
+  "scenarios": [
+    {
+      "name": "列表管理页（查询 + 分页 + 操作）",
+      "docs": ["./docs/components/table.md"],
+      "demos": ["./demos/table/basic", "./demos/table/action", "./demos/table/pagination-remote"]
+    },
+    {
+      "name": "远程筛选列表页",
+      "docs": ["./docs/components/table.md"],
+      "demos": ["./demos/table/filter-remote", "./demos/table/filter-mixed"]
+    },
+    {
+      "name": "可编辑表格（行内编辑）",
+      "docs": ["./docs/components/editTable.md"],
+      "demos": ["./demos/edit-table/row-edit", "./demos/edit-table/required", "./demos/edit-table/custom-rule"]
+    },
+    {
+      "name": "树表联动页面（左树右表）",
+      "docs": ["./docs/components/tree.md", "./docs/components/split-pane.md", "./docs/hooks/use-tree-height.md"],
+      "demos": ["./demos/split-pane/tree-table", "./demos/split-pane/tree-table-layout"]
+    },
+    {
+      "name": "JSON Schema 表单（新增/编辑/查看）",
+      "docs": ["./docs/components/formily.md"],
+      "demos": ["./demos/formily/basic.vue", "./demos/formily/modes.vue", "./demos/formily/steps.vue"]
+    },
+    {
+      "name": "文件导入两步流",
+      "docs": ["./docs/components/fileImport.md"],
+      "demos": ["./demos/file-import/basic.vue", "./demos/file-import/formily.vue"]
+    },
+    {
+      "name": "代码编辑与日志查看",
+      "docs": ["./docs/components/monaco.md", "./docs/hooks/useFullscreen.md"],
+      "demos": ["./demos/monaco/monaco.vue", "./demos/monaco/log-viewer.vue", "./demos/monaco/fullscreen.vue"]
+    },
+    {
+      "name": "图表分析页",
+      "docs": ["./docs/components/echarts.md"],
+      "demos": ["./demos/echarts/line.vue", "./demos/echarts/mix.vue", "./demos/echarts/dark.vue"]
+    },
+    {
+      "name": "高度自适应",
+      "docs": ["./docs/hooks/use-table-height.md", "./docs/hooks/use-tree-height.md"],
+      "demos": ["./demos/table/basic", "./demos/tree/search-toolbar"]
+    }
+  ],
+  "status": "validated"
+}

package/template/.cursor/skills/yss-ui/assets/scenario-index.md

@@ -0,0 +1,41 @@
+# yss-ui 场景索引
+
+## 使用方式
+
+- 先按业务场景选条目，再打开对应 API 文档与 Demo 目录。
+- 默认顺序：先看 `docs` 规则，再看 `demos` 实现。
+- 若一个需求覆盖多个场景，按“主流程优先、增强能力补充”组合取用。
+
+---
+
+## 场景映射
+
+| 场景                               | 优先文档                                                                                          | 优先 Demo                                                                                                |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| 列表管理页（查询 + 分页 + 操作）   | `./docs/components/table.md`                                                                      | `./demos/table/basic`、`./demos/table/action`、`./demos/table/pagination-remote`                         |
+| 远程筛选列表页                     | `./docs/components/table.md`                                                                      | `./demos/table/filter-remote`、`./demos/table/filter-mixed`                                              |
+| 可编辑表格（行内编辑）             | `./docs/components/editTable.md`                                                                  | `./demos/edit-table/row-edit`、`./demos/edit-table/required`、`./demos/edit-table/custom-rule`           |
+| 大数据表格                         | `./docs/components/table.md`、`./docs/components/editTable.md`                                    | `./demos/table/merge-cells`、`./demos/edit-table/big-data`                                               |
+| 树表联动页面（左树右表）           | `./docs/components/tree.md`、`./docs/components/split-pane.md`、`./docs/hooks/use-tree-height.md` | `./demos/split-pane/tree-table`、`./demos/split-pane/tree-table-layout`                                  |
+| 组织树/资源树选择                  | `./docs/components/tree.md`                                                                       | `./demos/tree/search-toolbar`、`./demos/tree/multiple-select`、`./demos/tree/multi-checkable`            |
+| JSON Schema 表单（新增/编辑/查看） | `./docs/components/formily.md`                                                                    | `./demos/formily/basic.vue`、`./demos/formily/modes.vue`、`./demos/formily/steps.vue`                    |
+| 表单联动与异步校验                 | `./docs/components/formily.md`                                                                    | `./demos/formily/linkage.vue`、`./demos/formily/linkage-multi.vue`、`./demos/formily/async-validate.vue` |
+| 文件导入两步流                     | `./docs/components/fileImport.md`                                                                 | `./demos/file-import/basic.vue`、`./demos/file-import/formily.vue`                                       |
+| 条件构造器                         | `./docs/components/conditionBuilder.md`                                                           | `./demos/condition-builder/basic`、`./demos/condition-builder/linked`                                    |
+| Cron 配置                          | `./docs/components/cron.md`                                                                       | `./demos/cron/basic`、`./demos/cron/select`                                                              |
+| 代码编辑与日志查看                 | `./docs/components/monaco.md`、`./docs/hooks/useFullscreen.md`                                    | `./demos/monaco/monaco.vue`、`./demos/monaco/log-viewer.vue`、`./demos/monaco/fullscreen.vue`            |
+| 图表分析页                         | `./docs/components/echarts.md`                                                                    | `./demos/echarts/line.vue`、`./demos/echarts/mix.vue`、`./demos/echarts/dark.vue`                        |
+| 卡片化指标看板                     | `./docs/components/card.md`                                                                       | `./demos/card/layout-metrics`、`./demos/card/basic`                                                      |
+| 权限按钮与操作态                   | `./docs/components/button.md`                                                                     | `./demos/button/permission.vue`、`./demos/button/states.vue`                                             |
+| 表格高度自适应                     | `./docs/hooks/use-table-height.md`                                                                | `./demos/table/basic`                                                                                    |
+| 树高度自适应                       | `./docs/hooks/use-tree-height.md`                                                                 | `./demos/tree/search-toolbar`                                                                            |
+
+---
+
+## 常见任务到场景
+
+- “做一个管理列表页”：使用“列表管理页（查询 + 分页 + 操作）”。
+- “左树右表联动”：使用“树表联动页面（左树右表）”。
+- “表单要支持查看模式”：使用“JSON Schema 表单（新增/编辑/查看）”。
+- “导入模板并校验结果”：使用“文件导入两步流”。
+- “表格/树撑满可视区域”：使用“表格高度自适应”或“树高度自适应”。

package/template/.cursor/skills/yss-ui/references/accessibility.md

@@ -0,0 +1,23 @@
+# YSS UI 可访问性、响应式与性能
+
+## 可访问性
+
+- 图标按钮必须有可访问名称或可见文本。
+- 表单 label、错误提示和输入控件建立语义关联。
+- 状态不能只用颜色表达；同时提供文本或图标语义。
+- Tab 顺序符合视觉与业务顺序；主要动作支持键盘触发。
+- Modal/Drawer 处理焦点进入、捕获、关闭恢复和 Escape 行为。
+- 对比度目标以项目测试策略为准；不足时修复主题 token，不制造页面特例。
+
+## 响应式
+
+- 明确目标断点和窄屏降级，不默认所有后台页面只运行在大屏。
+- Table 在窄屏提供横向滚动、列优先级或操作菜单收敛。
+- 主从布局在宽度不足时切换 Drawer、上下布局或独立页面。
+
+## 性能
+
+- 大数据 Table/Tree 使用项目已验证的虚拟化能力。
+- 远程 Select、Tree 搜索使用防抖、取消过期请求和 loading/empty/error 状态。
+- Monaco、ECharts、复杂 Formily 和大组件按需加载。
+- 禁止在 Vue 模板中执行排序、深拷贝或高成本结构转换。

package/template/.cursor/skills/yss-ui/references/antdv-compatibility.md

@@ -0,0 +1,39 @@
+# Ant Design Vue 兼容策略
+
+快照日期：2026-08-08。
+
+## 当前已知基线
+
+- Ant Design Vue 官网组件概览当日展示版本：`4.2.6`。
+- 本地 YSS UI 安装快照声明：YSS UI `1.x`、Vue `3.3+`、Ant Design Vue `4.0+`、VXE Table `4.5+`。
+- 上述范围不是目标项目的实际版本，生产实现必须读取目标仓库 lockfile。
+
+## 资料来源与新鲜度
+
+| 资料 | 快照 / 检查时间 | SHA-256 / 版本信号 |
+|---|---|---|
+| `references/frontend-docs.md` | 2026-06-29 | `062d818a8d9f3c3ee6a62e6ac561cff00e5bfe7033d60c1e0a10dc7fd4c32b1e` |
+| `assets/docs/guide/installation.md` | 2026-08-08 校验 | `53ebe138efeb3b7e4a66ae9f5d87e9aad895649c22cab429e8c09ed248580c3f` |
+| AntDV Components Overview | 2026-08-08 浏览器核对 | 页面版本信号 `4.2.6` |
+
+本地文档内容变化时必须更新哈希、版本矩阵和三个索引；仅更新时间而没有 fresh verification 不构成已同步。
+
+## 实现前命令
+
+```bash
+pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
+```
+
+记录包管理器、lockfile、精确版本和验证命令。若目标项目未安装某依赖，不得自行添加或升级，除非批准合同明确允许。
+
+## 事实优先级
+
+项目冻结基线 → lockfile/类型 → 已验证项目用法 → 对应版本 YSS 文档 → 对应版本 AntDV 官方文档 → 最新官网。
+
+## Ant Design v6 边界
+
+Ant Design v6 可以作为产品原型的视觉和 token 语义参考；Vue 生产实现使用 Ant Design Vue 4.x。禁止复制 React hooks、JSX、组件 props、theme algorithm API 或事件模型到 Vue 代码。
+
+## 兼容性证据
+
+任何版本升级至少执行 lint、type-check、组件测试和受影响页面验证，并记录破坏性变化、回滚版本和 YSS Wrapper 影响。

package/template/.cursor/skills/yss-ui/references/checklist.md

@@ -0,0 +1,110 @@
+# yss-ui Checklist
+
+## 使用方式
+
+- 开发阶段：按页面类型逐项自检。
+- 联调阶段：重点执行“数据链路与交互”清单。
+- 提交前：至少完成“通用基线”+ 当前页面类型清单。
+
+---
+
+## 通用基线（所有页面必查）
+
+- [ ] 已用 `pnpm why` 确认 Vue、YSS UI、AntDV、VXE 实际版本
+- [ ] 组件选型已对照 `component-routing.md`，AntDV 回退已记录原因
+- [ ] 使用 Vue 3 Composition API + `<script setup lang="ts">`
+- [ ] 优先使用 `@yss-ui/components`，缺失能力再回退 `ant-design-vue`
+- [ ] 未引入不存在的 Y 前缀组件
+- [ ] 无 `@formily/antd*` 违规导入
+- [ ] 页面容器具备统一布局（padding/margin/min-height）
+- [ ] 状态展示与危险操作颜色保持一致
+- [ ] 关键交互具备成功/失败反馈（`message`）
+- [ ] 关键实现至少对照一个 docs demo（`../assets/demos/*`）
+- [ ] 推荐 Demo 不含 `pending-verification`
+
+## 主题、Locale 与浮层
+
+- [ ] 页面通过项目 ConfigProvider/YSS theme/语义 token 消费主题
+- [ ] 未新增页面级主题色和任意 z-index
+- [ ] locale、时区、日期和金额格式化沿用项目统一能力
+- [ ] Popup/Teleport 目标适配宿主和微应用容器
+- [ ] Modal/Drawer 关闭时清理状态并恢复触发元素焦点
+
+## 可访问性、响应式与性能
+
+- [ ] 图标按钮有可访问名称，状态不只依赖颜色
+- [ ] 表单 label、错误提示与控件建立语义关联
+- [ ] 主要操作可通过键盘完成，Tab 顺序合理
+- [ ] 窄屏布局、表格横向滚动和操作收敛已检查
+- [ ] 大数据 Table/Tree、远程搜索和复杂组件采用项目已验证的性能策略
+
+---
+
+## 列表页清单（YTable）
+
+- [ ] 列定义使用 `YTableColumn`，主字段走 `field/type`
+- [ ] 启用 `:row-config="{ keyField: 'id' }"` 或业务主键
+- [ ] 需要选择行时已配置 `type: 'checkbox'`
+- [ ] 自定义单元格走字段插槽（如 `#status`、`#action`）
+- [ ] DOM 模板（JSP/HTML）下插槽命名使用 kebab-case（如 `#toolbar-left`）
+- [ ] 避免以 `bodyCell` 分支作为主渲染模式
+- [ ] 分页状态包含 `current/pageSize/total`
+- [ ] `@change` 中同步更新分页并触发刷新
+- [ ] 加载态与空态行为正确
+
+---
+
+## 抽屉详情页清单
+
+- [ ] 抽屉开关状态单一来源（`ref<boolean>`）
+- [ ] 打开抽屉前正确设置当前记录
+- [ ] 抽屉关闭时清理临时输入/评论等状态
+- [ ] Tab 切换不引入脏数据
+- [ ] 抽屉内表格优先使用 YTable（列同样遵循 `field/type`）
+- [ ] 底部操作按钮具备确认机制（如 `Modal.confirm`）
+
+---
+
+## 步骤页清单（Create/Step）
+
+- [ ] 步骤状态由单一 `currentStep` 管理
+- [ ] 第一步表单校验通过后再进入下一步
+- [ ] 步骤二列表推荐使用 YTable 承载节点信息
+- [ ] 节点编辑弹层（Drawer/Modal）保存后回填源数据
+- [ ] 上一步/下一步/取消/完成按钮状态与文案正确
+- [ ] 完成动作后有明确反馈并返回目标页面
+
+---
+
+## 数据链路与联调清单（API + Mock）
+
+- [ ] API 请求通过项目统一实例（`mutator.ts`）发起
+- [ ] URL 未重复拼接 `/api` 前缀
+- [ ] 列表请求参数包含 `page/pageSize` 与筛选参数
+- [ ] Mock 路由与前端请求路径一致
+- [ ] Mock 返回结构为 `{ code, message, data: { list, total, page, pageSize } }`
+- [ ] 查询行为会重置页码到第一页
+- [ ] 分页行为会沿用筛选条件重新请求
+- [ ] 异常时正确提示并兜底空数据
+
+---
+
+## 路由与菜单清单
+
+- [ ] 页面路由挂载在正确模块 `children` 下
+- [ ] `meta.title` 与页面语义一致
+- [ ] 详情/创建页使用 `menuType: MENU_TYPE.INNER_MENU`
+- [ ] 路由名称（name）语义清晰且唯一
+
+---
+
+## 交付前核查清单
+
+- [ ] 关键文件已补充必要类型定义
+- [ ] 无调试输出（如 `console.info`）遗留
+- [ ] 运行格式化命令并确认无格式问题
+- [ ] 目标文件 IDE 诊断无新增错误
+- [ ] 若 lint/type-check 失败，已明确标注环境原因
+- [ ] 如需 AI 辅助生成代码，优先加载 `llms-full.txt` 上下文
+- [ ] 必要的组件测试、E2E、视觉回归已执行；未适用项记录原因
+- [ ] 浏览器 console 无新增 warning/error

package/template/.cursor/skills/yss-ui/references/component-routing.md

@@ -0,0 +1,31 @@
+# YSS UI 组件路由表
+
+本文件是 YSS Wrapper 与 Ant Design Vue / VXE 组件选型的权威映射。`required` 表示生产页面必须优先使用 YSS；`fallback` 表示当前无独立 YSS 封装，可直接使用项目安装版本的 AntDV；`specialized` 表示必须加载专项 skill。
+
+| 场景 | YSS 组件 | 底层能力 | 策略 | 关键差异 / 路由 |
+|---|---|---|---|---|
+| 普通按钮、权限按钮 | `YButton` | AntDV Button | required | 权限、主题和统一动作语义；不得直接导入 Button |
+| 卡片 | `YCard` | AntDV Card | required | YSS 布局与间距扩展 |
+| 数据表格 | `YTable` | VXE Table + AntDV Pagination | specialized | 使用 `yss-components`、`field/type`、字段插槽 |
+| 编辑表格 | `YEditTable` | VXE Table | specialized | 对照 edit-table docs/demo |
+| 树 | `YTree` | AntDV Tree | specialized | 搜索、Tooltip、动作和高度路由 |
+| Schema 表单 | `YssFormily` | Formily + AntDV | specialized | `YssFormily` 为 canonical；加载 `yss-formily` |
+| 分栏布局 | `YSplitPane` | YSS layout | required | 统一主从页面与容器高度 |
+| 文件导入 | `YFileImport` | Upload/业务适配 | required | 使用 YSS 上传结果和表单适配 |
+| 条件构建 | `YConditionBuilder` | YSS domain component | required | 使用对应 docs/demo |
+| Cron | `YCron` | YSS domain component | required | 底层 Popover 可 fallback |
+| 图表 | `YEcharts` | ECharts | required | 主题、resize、darkMode 使用 YSS API |
+| 编辑器 | `YMonaco` | Monaco | required | 按需加载和尺寸治理 |
+| Sheet | `YSheet` | Univer | required | locale 与资源包按 YSS 文档 |
+| 输入、选择、日期 | 无独立通用 Wrapper | AntDV Input/Select/DatePicker 等 | fallback | 读取实际 AntDV 版本；服从 theme/locale/popup 规则 |
+| 浮层反馈 | 无统一 Wrapper | Modal/Drawer/Popover/Tooltip/Alert | fallback | 服从容器、焦点、销毁、z-index 规则 |
+| 服务式反馈 | 无统一 Wrapper | message/notification | fallback | 检查 App/ConfigProvider 上下文 |
+| 布局与导航 | 按项目现状 | AntDV Layout/Grid/Menu/Tabs 等 | fallback | 不复制 React Ant Design v6 API |
+
+## 受控回退
+
+YSS `required` wrapper 缺少必要能力时，记录组件、能力缺口、依赖版本、替代方案、主题/locale/浮层影响和验证证据。没有记录不得回退。
+
+## 更新规则
+
+新增或变更 YSS Wrapper 时同步：本表、组件 docs、至少一个已验证 demo、三个索引、兼容矩阵和验证脚本。

package/template/.cursor/skills/yss-ui/references/frontend-docs.md

@@ -0,0 +1,11 @@
+# yss-ui Frontend Documentation
+
+Generated: 2026-08-17T12:03:37.436Z
+
+Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
+
+- components: http://192.168.164.27:3200/components
+- hooks: http://192.168.164.27:3200/hooks
+- skills: http://192.168.164.27:3200/skills
+
+When documentation and local code differ, inspect the current project code before editing and prefer established local usage.

package/template/.cursor/skills/yss-ui/references/migration-antdv-to-yss.md

@@ -0,0 +1,20 @@
+# AntDV 到 YSS Wrapper 迁移与 Demo 审计
+
+## 迁移规则
+
+1. 从 `component-routing.md` 判断目标是 required、fallback 或 specialized。
+2. required 组件改用 YSS Wrapper，并运行对应 docs/demo 验证。
+3. fallback 组件保留 AntDV 导入，记录无 Wrapper 或能力缺口。
+4. 服务式 API 记录 App/ConfigProvider 上下文。
+5. 未验证 Demo 标记 `pending-verification`，不得进入推荐索引。
+
+## 2026-08-08 基线审计
+
+基线发现 28 个 Demo 直接导入 `ant-design-vue`。
+
+- 明确迁移：直接使用 AntDV `Button` 的 Cron、Card、Table Demo 改用 `YButton`。
+- 合理 fallback：Input、Select、Checkbox、Radio、Collapse、Popover、Tooltip、Dropdown、Tag、Grid 等当前无独立通用 YSS Wrapper。
+- 服务式 fallback：`message` 保留，但实现项目必须检查应用上下文。
+- `RadioButton` / `RadioGroup` 不等同于独立 `Button`，不应被 Button 规则误判。
+
+后续新增 Demo 若直接导入 YSS 已标记 required 的底层组件，模板验证必须失败。