create-yss-spec 3.3.1 → 3.3.4

package/template/.trae/skills/yss-ui/assets/docs/hooks/useFullscreen.md

@@ -1,130 +0,0 @@
----
-title: useFullscreen
-description: 管理 DOM 全屏的 Hook
-toc: content
----
-
-# useFullscreen
-
-管理 DOM 全屏的 Hook，支持真实全屏和页面全屏两种模式。
-
-## 代码演示
-
-### 基础用法
-
-使用 `ref` 设置需要全屏的元素。
-
-<code src="./demos/useFullscreen/demo1-basic.vue"></code>
-
-### 图片全屏
-
-使用函数形式传入目标元素，实现图片全屏效果。
-
-<code src="./demos/useFullscreen/demo2-image.vue"></code>
-
-### 页面全屏
-
-使用 `pageFullscreen` 配置启用页面全屏模式（伪全屏），通过 CSS fixed 定位实现，不使用浏览器全屏 API。
-
-<code src="./demos/useFullscreen/demo3-page.vue"></code>
-
-### 与其他全屏操作共存
-
-元素的全屏情况可能被其他脚本修改，useFullscreen 能正确追踪外部全屏状态变化。
-
-<code src="./demos/useFullscreen/demo4-coexist.vue"></code>
-
-## API
-
-```typescript
-const {
-  isFullscreen,
-  enterFullscreen,
-  exitFullscreen,
-  toggleFullscreen,
-  isEnabled,
-} = useFullscreen(target, options?);
-```
-
-### Params
-
-| 参数    | 说明             | 类型                                                                 | 默认值 |
-| ------- | ---------------- | -------------------------------------------------------------------- | ------ |
-| target  | 目标元素         | `HTMLElement` \| `Ref<HTMLElement>` \| `() => HTMLElement \| null` | -      |
-| options | 配置选项         | `UseFullscreenOptions`                                               | -      |
-
-### UseFullscreenOptions
-
-| 参数           | 说明                                                                   | 类型                                                   | 默认值  |
-| -------------- | ---------------------------------------------------------------------- | ------------------------------------------------------ | ------- |
-| onEnter        | 进入全屏时的回调                                                       | `() => void`                                           | -       |
-| onExit         | 退出全屏时的回调                                                       | `() => void`                                           | -       |
-| pageFullscreen | 是否使用页面全屏模式。当参数类型为对象时，可以设置全屏元素的类名和 `z-index` | `boolean` \| `{ className?: string, zIndex?: number }` | `false` |
-| escTip         | Esc 键退出提示配置。`true` 显示默认提示，`string` 自定义文案，`false` 不显示 | `boolean` \| `string`                                  | `true`  |
-
-### UseFullscreenReturn
-
-| 参数             | 说明                 | 类型                  |
-| ---------------- | -------------------- | --------------------- |
-| isFullscreen     | 是否处于全屏状态     | `Readonly<Ref<boolean>>` |
-| enterFullscreen  | 进入全屏             | `() => void`          |
-| exitFullscreen   | 退出全屏             | `() => void`          |
-| toggleFullscreen | 切换全屏状态         | `() => void`          |
-| isEnabled        | 浏览器是否支持全屏   | `boolean`             |
-
-## 注意事项
-
-1. **浏览器兼容性**：Fullscreen API 在某些旧版浏览器中可能不支持，可以通过 `isEnabled` 属性检查支持状态。
-
-2. **用户手势要求**：浏览器要求全屏操作必须由用户手势触发（如点击事件），不能在页面加载时自动全屏。
-
-3. **页面全屏 vs 真实全屏**：
-   - **真实全屏**：使用浏览器 Fullscreen API，会隐藏浏览器界面，用户可以按 `ESC` 键退出
-   - **页面全屏**：通过 CSS 实现，只是让元素覆盖整个视口，不会隐藏浏览器界面
-
-4. **样式隔离**：页面全屏模式会动态创建 `<style>` 标签，默认类名为 `yss-page-fullscreen`，可以通过配置自定义。
-
-5. **Esc 键提示**：进入全屏时会自动显示"若要退出全屏模式，请按 esc"提示，3 秒后自动隐藏。可以通过 `escTip` 配置自定义提示文案或禁用提示。
-
-## 类型定义
-
-```typescript
-export interface PageFullscreenOptions {
-  /** 全屏元素的类名 */
-  className?: string;
-  /** 全屏元素的 z-index */
-  zIndex?: number;
-}
-
-export interface UseFullscreenOptions {
-  /** 退出全屏时的回调 */
-  onExit?: () => void;
-  /** 进入全屏时的回调 */
-  onEnter?: () => void;
-  /** 是否使用页面全屏模式（伪全屏），或传入配置对象 */
-  pageFullscreen?: boolean | PageFullscreenOptions;
-  /** 
-   * Esc 键退出提示配置
-   * - true: 显示默认提示"若要退出全屏模式，请按 esc"
-   * - string: 自定义提示文案
-   * - false: 不显示提示
-   * @default true
-   */
-  escTip?: boolean | string;
-}
-
-export type Target = HTMLElement | Ref<HTMLElement | undefined> | (() => HTMLElement | null);
-
-export interface UseFullscreenReturn {
-  /** 是否处于全屏状态 */
-  isFullscreen: Readonly<Ref<boolean>>;
-  /** 进入全屏 */
-  enterFullscreen: () => void;
-  /** 退出全屏 */
-  exitFullscreen: () => void;
-  /** 切换全屏状态 */
-  toggleFullscreen: () => void;
-  /** 浏览器是否支持全屏 */
-  isEnabled: boolean;
-}
-```

package/template/.trae/skills/yss-ui/assets/docs/hooks/useLoading.md

@@ -1,97 +0,0 @@
----
-title: useLoading
-description: 管理异步加载状态的 Hook
-toc: content
----
-
-# useLoading
-
-管理异步请求的加载状态，支持自动控制和手动控制两种模式。
-
-## 代码演示
-
-### 基础用法
-
-使用 `withLoading` 包装异步函数，自动控制加载状态。
-
-<code src="./demos/useLoading/use-loading-basic.vue"></code>
-
-### 手动控制
-
-使用 `setLoading` 和 `toggleLoading` 手动控制加载状态。
-
-<code src="./demos/useLoading/use-loading-manual.vue"></code>
-
-## API
-
-```typescript
-const {
-  loading,
-  setLoading,
-  withLoading,
-  toggleLoading,
-} = useLoading(initialValue?);
-```
-
-### Params
-
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| initialValue | 初始加载状态 | `boolean` | `false` |
-
-### UseLoadingReturn
-
-| 参数 | 说明 | 类型 |
-| --- | --- | --- |
-| loading | 当前加载状态（响应式） | `Ref<boolean>` |
-| setLoading | 设置加载状态 | `(value: boolean) => void` |
-| withLoading | 包装异步函数，自动控制加载状态 | `<T>(fn: () => Promise<T>, options?: WithLoadingOptions) => Promise<T \| undefined>` |
-| toggleLoading | 切换加载状态 | `() => void` |
-
-### WithLoadingOptions
-
-`withLoading` 方法的配置选项：
-
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| onSuccess | 成功回调函数 | `(result: T) => void` | - |
-| onError | 错误回调函数 | `(error: Error) => void` | - |
-| onFinally | 完成回调（无论成功/失败都会触发） | `() => void` | - |
-| keepLoadingOnError | 发生错误时是否保持 loading 状态 | `boolean` | `false` |
-| rethrowError | 是否重新抛出错误（设为 false 可防止白屏） | `boolean` | `false` |
-
-:::info{title=命名说明}
-- **onSuccess**：异步函数成功执行后触发，可以获取返回值
-- **onError**：异步函数内部抛出错误（接口异常/JS 报错）时触发
-- **onFinally**：类似 try-catch-finally 的 finally，无论成功或失败都会触发
-- **rethrowError**：默认 `false`，错误会被捕获，通过 `onError` 通知，防止未捕获的 Promise rejection 导致白屏
-:::
-
-## 使用场景
-
-- ✅ 按钮点击触发异步请求
-- ✅ 表单提交时显示加载状态
-- ✅ 数据列表刷新时显示加载动画
-- ✅ 多个并发请求的统一加载状态管理
-
-## 类型定义
-
-```typescript
-interface WithLoadingOptions<T = any> {
-  onSuccess?: (result: T) => void;
-  onError?: (error: Error) => void;
-  onFinally?: () => void;
-  keepLoadingOnError?: boolean;
-  rethrowError?: boolean;
-}
-
-export function useLoading(initialValue?: boolean): {
-  loading: Ref<boolean>;
-  setLoading: (value: boolean) => void;
-  withLoading: <T>(
-    fn: () => Promise<T>,
-    options?: WithLoadingOptions<T>
-  ) => Promise<T | undefined>;
-  toggleLoading: () => void;
-}
-```

package/template/.trae/skills/yss-ui/assets/docs/root/resources.md

@@ -1,18 +0,0 @@
----
-title: 资源
-order: 99
----
-
-# 资源
-
-本文收敛 Formily 生态与内部平台的常用入口，便于统一查阅与跳转。
-
-## Formily 生态
-
-- **Formily Core（内核 API）**：[`https://core.formilyjs.org/zh-CN/api/entry/create-form#iformprops`](https://core.formilyjs.org/zh-CN/api/entry/create-form#iformprops)
-- **Ant Design Vue Formily 文档**：[`https://antdv.formilyjs.org/guide/`](https://antdv.formilyjs.org/guide/)
-- **Formily Vue 组件 API**：[`https://vue.formilyjs.org/api/components/field.html`](https://vue.formilyjs.org/api/components/field.html)
-
-## 内部平台
-
-- **雨燕 · 生成微应用脚手架**：[`http://192.168.164.27:3100/`](http://192.168.164.27:3100/)

package/template/.trae/skills/yss-ui/assets/keyword-index.json

@@ -1,53 +0,0 @@
-{
-  "keywords": [
-    {
-      "keyword": "审批流程列表",
-      "scenario": "列表管理页（查询 + 分页 + 操作）",
-      "docs": ["./docs/components/table.md"],
-      "demos": ["./demos/table/basic", "./demos/table/action"]
-    },
-    {
-      "keyword": "节点设计",
-      "scenario": "可编辑表格（行内编辑）",
-      "docs": ["./docs/components/editTable.md"],
-      "demos": ["./demos/edit-table/row-edit", "./demos/edit-table/slot-linkage"]
-    },
-    {
-      "keyword": "树表联动",
-      "scenario": "树表联动页面（左树右表）",
-      "docs": ["./docs/components/tree.md", "./docs/components/split-pane.md"],
-      "demos": ["./demos/split-pane/tree-table-layout"]
-    },
-    {
-      "keyword": "新增编辑查看",
-      "scenario": "JSON Schema 表单（新增/编辑/查看）",
-      "docs": ["./docs/components/formily.md"],
-      "demos": ["./demos/formily/modes.vue"]
-    },
-    {
-      "keyword": "文件导入",
-      "scenario": "文件导入两步流",
-      "docs": ["./docs/components/fileImport.md"],
-      "demos": ["./demos/file-import/basic.vue", "./demos/file-import/formily.vue"]
-    },
-    {
-      "keyword": "代码编辑器",
-      "scenario": "代码编辑与日志查看",
-      "docs": ["./docs/components/monaco.md"],
-      "demos": ["./demos/monaco/monaco.vue", "./demos/monaco/log-viewer.vue"]
-    },
-    {
-      "keyword": "图表分析",
-      "scenario": "图表分析页",
-      "docs": ["./docs/components/echarts.md"],
-      "demos": ["./demos/echarts/mix.vue", "./demos/echarts/line.vue"]
-    },
-    {
-      "keyword": "表格高度",
-      "scenario": "表格高度自适应",
-      "docs": ["./docs/hooks/use-table-height.md"],
-      "demos": ["./demos/table/basic"]
-    }
-  ],
-  "status": "validated"
-}

package/template/.trae/skills/yss-ui/assets/keyword-index.md

@@ -1,47 +0,0 @@
-# yss-ui 关键词反查索引
-
-## 使用方式
-
-- 按关键词找到对应“场景 + 文档 + Demo”。
-- 同一关键词命中多个条目时，优先选择最贴近当前业务目标的场景。
-- 对复杂需求可组合多个关键词逐步定位。
-
----
-
-## 关键词映射
-
-| 关键词       | 场景                               | 文档                                                           | Demo                                                             |
-| ------------ | ---------------------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------- |
-| 审批流程列表 | 列表管理页（查询 + 分页 + 操作）   | `./docs/components/table.md`                                   | `./demos/table/basic`、`./demos/table/action`                    |
-| 待我审批     | 列表管理页（查询 + 分页 + 操作）   | `./docs/components/table.md`                                   | `./demos/table/pagination-remote`                                |
-| 抽屉详情     | 列表管理页（查询 + 分页 + 操作）   | `./docs/components/table.md`                                   | `./demos/table/action-slot`                                      |
-| 节点设计     | 可编辑表格（行内编辑）             | `./docs/components/editTable.md`                               | `./demos/edit-table/row-edit`、`./demos/edit-table/slot-linkage` |
-| 行内编辑     | 可编辑表格（行内编辑）             | `./docs/components/editTable.md`                               | `./demos/edit-table/row-edit`                                    |
-| 远程分页     | 列表管理页（查询 + 分页 + 操作）   | `./docs/components/table.md`                                   | `./demos/table/pagination-remote`                                |
-| 远程筛选     | 远程筛选列表页                     | `./docs/components/table.md`                                   | `./demos/table/filter-remote`                                    |
-| 树表联动     | 树表联动页面（左树右表）           | `./docs/components/tree.md`、`./docs/components/split-pane.md` | `./demos/split-pane/tree-table-layout`                           |
-| 左树右表     | 树表联动页面（左树右表）           | `./docs/components/split-pane.md`                              | `./demos/split-pane/tree-table`                                  |
-| 组织树选择   | 组织树/资源树选择                  | `./docs/components/tree.md`                                    | `./demos/tree/multiple-select`、`./demos/tree/multi-checkable`   |
-| 新增编辑查看 | JSON Schema 表单（新增/编辑/查看） | `./docs/components/formily.md`                                 | `./demos/formily/modes.vue`                                      |
-| 表单联动     | 表单联动与异步校验                 | `./docs/components/formily.md`                                 | `./demos/formily/linkage.vue`                                    |
-| 异步校验     | 表单联动与异步校验                 | `./docs/components/formily.md`                                 | `./demos/formily/async-validate.vue`                             |
-| 分步表单     | JSON Schema 表单（新增/编辑/查看） | `./docs/components/formily.md`                                 | `./demos/formily/steps.vue`                                      |
-| 文件导入     | 文件导入两步流                     | `./docs/components/fileImport.md`                              | `./demos/file-import/basic.vue`                                  |
-| 导入结果确认 | 文件导入两步流                     | `./docs/components/fileImport.md`                              | `./demos/file-import/formily.vue`                                |
-| 条件构造器   | 条件构造器                         | `./docs/components/conditionBuilder.md`                        | `./demos/condition-builder/basic`                                |
-| cron 表达式  | Cron 配置                          | `./docs/components/cron.md`                                    | `./demos/cron/basic`                                             |
-| 代码编辑器   | 代码编辑与日志查看                 | `./docs/components/monaco.md`                                  | `./demos/monaco/monaco.vue`                                      |
-| 日志查看     | 代码编辑与日志查看                 | `./docs/components/monaco.md`                                  | `./demos/monaco/log-viewer.vue`                                  |
-| 全屏预览     | 代码编辑与日志查看                 | `./docs/hooks/useFullscreen.md`                                | `./demos/monaco/fullscreen.vue`                                  |
-| 图表分析     | 图表分析页                         | `./docs/components/echarts.md`                                 | `./demos/echarts/mix.vue`、`./demos/echarts/line.vue`            |
-| 指标卡片     | 卡片化指标看板                     | `./docs/components/card.md`                                    | `./demos/card/layout-metrics`                                    |
-| 权限按钮     | 权限按钮与操作态                   | `./docs/components/button.md`                                  | `./demos/button/permission.vue`                                  |
-| 表格高度     | 表格高度自适应                     | `./docs/hooks/use-table-height.md`                             | `./demos/table/basic`                                            |
-| 树高度       | 树高度自适应                       | `./docs/hooks/use-tree-height.md`                              | `./demos/tree/search-toolbar`                                    |
-
----
-
-## 快速建议
-
-- 若关键词无法唯一命中，先打开 `./scenario-index.md` 按场景二次筛选。
-- 若关键词未覆盖，优先补充到本文件并同步更新 `keyword-index.json`。

package/template/.trae/skills/yss-ui/assets/reference-index.json

@@ -1,55 +0,0 @@
-{
-  "sourceFiles": [
-    "../SKILL.md",
-    "../references/quick-recipes.md",
-    "../references/checklist.md"
-  ],
-  "docsRoot": "./docs",
-  "demosRoot": "./demos",
-  "scenarioIndex": "./scenario-index.md",
-  "scenarioIndexJson": "./scenario-index.json",
-  "keywordIndex": "./keyword-index.md",
-  "keywordIndexJson": "./keyword-index.json",
-  "docReferences": [
-    "components/table.md",
-    "components/editTable.md",
-    "components/formily.md",
-    "components/tree.md",
-    "components/split-pane.md",
-    "components/monaco.md",
-    "components/echarts.md",
-    "components/fileImport.md",
-    "components/conditionBuilder.md",
-    "components/cron.md",
-    "components/card.md",
-    "components/button.md",
-    "components/sheet.md",
-    "hooks/use-table-height.md",
-    "hooks/use-tree-height.md",
-    "hooks/useFullscreen.md",
-    "hooks/useLoading.md",
-    "guide/index.md",
-    "guide/installation.md",
-    "guide/jsp.md",
-    "guide/llms.md",
-    "guide/release-workflow.md",
-    "guide/gitlab-ci-integration.md",
-    "guide/monorepo-versioning.md",
-    "root/resources.md"
-  ],
-  "demoReferences": [
-    "table/*",
-    "edit-table/*",
-    "formily/*",
-    "tree/*",
-    "split-pane/*",
-    "monaco/*",
-    "echarts/*",
-    "file-import/*",
-    "condition-builder/*",
-    "cron/*",
-    "card/*",
-    "button/*"
-  ],
-  "status": "validated"
-}

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

@@ -1,74 +0,0 @@
-# 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/.trae/skills/yss-ui/assets/scenario-index.json

@@ -1,50 +0,0 @@
-{
-  "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/.trae/skills/yss-ui/assets/scenario-index.md

@@ -1,41 +0,0 @@
-# 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/.trae/skills/yss-ui/references/accessibility.md

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

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

@@ -1,39 +0,0 @@
-# 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。版本号不同本身不是冲突。生产映射必须消费原型证据中的 `visual_semantic_mapping`，并用实现仓 lockfile/类型验证 YSS 或 AntDV 目标；禁止复制 React hooks、JSX、组件 props、theme algorithm API 或事件模型到 Vue 代码。
-
-## 兼容性证据
-
-任何版本升级至少执行 lint、type-check、组件测试和受影响页面验证，并记录破坏性变化、回滚版本和 YSS Wrapper 影响。