create-yss-spec 3.3.1 → 3.3.3

package/template/.claude/skills/yss-ui/assets/docs/guide/index.md

@@ -1,132 +0,0 @@
----
-title: 快速开始
-description: YSS UI 快速开始指南
-toc: content
----
-
-# 快速开始
-
-YSS UI 是一个基于 Vue 3、Ant Design Vue 与 VXE-Table 的企业级中后台组件库，专为微应用架构设计。
-
-## 安装
-
-### 环境要求
-
-- Node.js >= 22.10.0（建议升级到 22.17.1，我们在该版本验证良好）
-- Vue >= 3.0.0
-
-### 包管理器
-
-推荐使用 pnpm：
-
-```bash
-pnpm add @yss-ui/components
-```
-
-或者使用 npm：
-
-```bash
-npm install @yss-ui/components
-```
-
-## 全局引入（你的微应用当前方案）
-
-在 main.ts 中：
-
-```typescript
-import { createApp } from 'vue'
-import YSSUI from '@yss-ui/components'
-import '@yss-ui/components/dist/style.css'
-import App from './App.vue'
-
-const app = createApp(App)
-app.use(YSSUI)
-app.mount('#app')
-```
-
-## 按需引入（适用于独立项目或极限体积优化）
-
-为了减小包体积，推荐按需引入组件：
-
-<code src="./main/Button.vue" ></code>
-
-## 使用 Utils 和 Hooks（先保留）
-
-```typescript
-// 使用工具函数
-import { formatMoney, validateEmail } from '@yss-ui/utils'
-
-// 使用 Hooks
-import { useTable, useForm } from '@yss-ui/hooks'
-```
-
-## TypeScript 支持
-
-YSS UI 使用 TypeScript 开发，提供完整的类型定义：
-
-```typescript
-import type { ButtonProps, FormProps } from '@yss-ui/components'
-```
-
-## 配置
-
-### 全局配置
-
-```typescript
-import { createApp } from 'vue'
-import YssUI from '@yss-ui/components'
-
-const app = createApp(App)
-
-app.use(YssUI, {
-  // 全局配置
-  theme: {
-    primaryColor: '#1890ff'
-  }
-})
-```
-
-### 主题定制
-
-```typescript
-import { colors, spacing, typography } from '@yss-ui/theme'
-
-// 使用主题变量
-const primaryColor = colors.primary[6]
-const basePadding = spacing.md
-```
-
-## 最佳实践
-
-### 1. 组件命名
-
-统一使用 `y-` 前缀避免命名冲突：
-
-<code src="./main/Button.vue" ></code>
-
-### 2. 类型安全
-
-充分利用 TypeScript 类型：
-
-```typescript
-import type { YTableProps } from '@yss-ui/components'
-
-const tableProps: YTableProps = {
-  data: [],
-  columns: [],
-  showPagination: true
-}
-```
-
-### 3. 主题一致性（避免颜色硬编码）
-
-使用主题变量保持设计一致性：
-
-<code src="./main/ButtonTheme.vue" ></code>
-
-## 下一步
-
-- 查看 [组件文档](/components/table) 了解所有可用组件
-- 查看 [工具函数](/utils) 了解实用工具
-- 查看 [Hooks](/hooks) 了解可复用逻辑
- - 面向存量系统：查看 [JSP 项目接入（UMD + CDN/本地）](/guide/jsp)

package/template/.claude/skills/yss-ui/assets/docs/guide/installation.md

@@ -1,97 +0,0 @@
----
-title: 安装
-description: YSS UI 安装指南
----
-
-# 安装
-
-## 环境准备
-
-使用 YSS UI 前，需要在本地依次安装 [Node.js](https://nodejs.org/zh-cn/) 和包管理器。
-
-### Node.js
-
-YSS UI 支持 Node.js 22.10.0 及以上版本（建议升级到 22.17.1，我们在该版本验证良好）。
-
-```bash
-# 检查 Node.js 版本
-node --version
-
-# 建议安装 LTS 22.17.1（可用 nvm / volta 管理）
-```
-
-### 包管理器
-
-推荐使用 pnpm 作为包管理器：
-
-```bash
-# 安装 pnpm
-npm install -g pnpm
-
-# 检查版本
-pnpm --version
-```
-
-## 安装组件库
-
-### 使用 pnpm（推荐）
-
-```bash
-pnpm add @yss-ui/components
-```
-
-### 使用 npm
-
-```bash
-npm install @yss-ui/components
-```
-
-### 使用 yarn
-
-```bash
-yarn add @yss-ui/components
-```
-
-## 安装子包
-
-根据需要安装相应的子包：
-
-```bash
-# 工具函数包
-pnpm add @yss-ui/utils
-
-# Hooks 包
-pnpm add @yss-ui/hooks
-
-# 主题包
-pnpm add @yss-ui/theme
-```
-
-## CDN 引入（可选）
-
-对于快速原型开发，可以通过 CDN 引入：
-
-```html
-<!-- 引入 Vue 3 -->
-<script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
-
-<!-- 引入 YSS UI -->
-<script src="https://unpkg.com/@yss-ui/components/dist/index.umd.js"></script>
-<link rel="stylesheet" href="https://unpkg.com/@yss-ui/components/dist/style.css">
-```
-
-## 版本信息
-
-YSS UI 版本与依赖版本对应关系：
-
-| YSS UI | Vue | Ant Design Vue | VXE-table |
-|--------|-----|----------------|-----------|
-| 1.x    | 3.3+ | 4.0+           | 4.5+      |
-
-## 下一步
-
-安装完成后，可以：
-
-1. 查看 [快速开始](/guide) 了解基本用法
-2. 查看 [组件文档](/components/table) 了解所有组件
-3. 在项目中开始使用 YSS UI

package/template/.claude/skills/yss-ui/assets/docs/guide/jsp.md

@@ -1,227 +0,0 @@
----
-title: JSP 项目接入（UMD + CDN/本地）
-description: 在 JSP/Servlet 项目中通过 UMD 形式集成 Vue 3 + YSS UI，并支持将 CDN 资源一键下载到本地离线部署
-order: 20
-toc: content
----
-
-## 适用场景
-
-- 现有单体/多模块 Java 应用（Spring MVC、Spring Boot、SSM 等）仍以 JSP 渲染页面。
-- 需要在 JSP 中直接使用 Vue 3 与 YSS UI，而暂时无法引入打包构建链路（Vite/Webpack）。
-
-方案采用 UMD 全局构建：通过 `<link>`/`<script>` 标签按顺序引入依赖，在页面里创建并挂载 Vue 应用。
-
-## 依赖关系与加载顺序
-
-必须保证以下顺序（同 Demo）：
-
-```38:63:/Users/wangyancong/Downloads/guangda/Sonorus/yss-ui-demo/index.html
-  <!-- 依赖顺序：Vue3 -> xe-utils -> vxe-pc-ui -> vxe-table -> dayjs(+plugins) -> antd -> Formily -> yss-ui -->
-  <script src="../resources/vue3/vue.global.js" defer></script>
-  <script src="../resources/xe-utils/xe-utils.umd.min.js" defer></script>
-  <script src="../resources/vxe-pc-ui/index.umd.min.js" defer></script>
-  <script src="../resources/vxe-table/index.umd.min.js" defer></script>
-  <script src="../resources/dayjs/dayjs.min.js" defer></script>
-  <script src="../resources/dayjs/plugin/advancedFormat.js" defer></script>
-  <script src="../resources/dayjs/plugin/customParseFormat.js" defer></script>
-  <script src="../resources/dayjs/plugin/localeData.js" defer></script>
-  <script src="../resources/dayjs/plugin/quarterOfYear.js" defer></script>
-  <script src="../resources/dayjs/plugin/weekOfYear.js" defer></script>
-  <script src="../resources/dayjs/plugin/weekYear.js" defer></script>
-  <script src="../resources/dayjs/plugin/weekday.js" defer></script>
-  <script src="../resources/ant-design-vue/antd.js" defer></script>
-  <script src="../resources/formily/formily.core.umd.js" defer></script>
-  <script src="../resources/formily/formily.vue.umd.js" defer></script>
-  <script src="../resources/formily/formily.antdv.umd.js" defer></script>
-  <script src="../resources/formily/formily.validator.umd.js" defer></script>
-  <script src="../resources/yss-ui/yss-ui.umd.js" defer></script>
-```
-
-## 本地目录建议
-
-将静态资源统一放在服务器可直接访问的路径（例如 `src/main/resources/static/vendor` 或 Nginx 的根目录 `static/vendor`）：
-
-```
-static/
-  vendor/
-    ant-design-vue/
-    dayjs/
-      plugin/
-    formily/
-    vue3/
-    vxe-pc-ui/
-    vxe-table/
-    xe-utils/
-    yss-ui/
-```
-
-## 一键下载：使用 curl 将 CDN 资源落地
-
-以下脚本可直接在 macOS/Linux 终端执行。会创建目录并下载相应 UMD/CSS 文件到 `static/vendor`。
-
-```bash
-#!/usr/bin/env bash
-set -euo pipefail
-
-# 版本可按需调整（建议与后续生产依赖保持一致）
-VUE_VERSION=3.5.12
-XE_UTILS_VERSION=3.5.21
-VXE_UI_VERSION=3.7.18
-VXE_TABLE_VERSION=4.6.18
-DAYJS_VERSION=1.11.11
-ANTDV_VERSION=4.2.6
-FORMILY_VERSION=2.4.14
-YSSUI_VERSION=latest   # 如走私有 npm，可改为具体发布号
-
-BASE=static/vendor
-mkdir -p "$BASE"/{vue3,xe-utils,vxe-pc-ui,vxe-table,dayjs/plugin,ant-design-vue,formily,yss-ui}
-
-# Vue 3（全局构建）
-curl -L "https://cdn.jsdelivr.net/npm/vue@${VUE_VERSION}/dist/vue.global.prod.js" -o "$BASE/vue3/vue.global.js"
-
-# xe-utils
-curl -L "https://cdn.jsdelivr.net/npm/xe-utils@${XE_UTILS_VERSION}/dist/xe-utils.umd.min.js" -o "$BASE/xe-utils/xe-utils.umd.min.js"
-
-# vxe-pc-ui 与 vxe-table（注意顺序）
-curl -L "https://cdn.jsdelivr.net/npm/vxe-pc-ui@${VXE_UI_VERSION}/lib/index.umd.min.js" -o "$BASE/vxe-pc-ui/index.umd.min.js"
-curl -L "https://cdn.jsdelivr.net/npm/vxe-table@${VXE_TABLE_VERSION}/lib/index.umd.min.js" -o "$BASE/vxe-table/index.umd.min.js"
-
-# dayjs 及常用插件
-curl -L "https://cdn.jsdelivr.net/npm/dayjs@${DAYJS_VERSION}/dayjs.min.js" -o "$BASE/dayjs/dayjs.min.js"
-for p in advancedFormat customParseFormat localeData quarterOfYear weekOfYear weekYear weekday; do
-  curl -L "https://cdn.jsdelivr.net/npm/dayjs@${DAYJS_VERSION}/plugin/${p}.js" -o "$BASE/dayjs/plugin/${p}.js"
-done
-
-# Ant Design Vue（UMD + 样式）
-curl -L "https://cdn.jsdelivr.net/npm/ant-design-vue@${ANTDV_VERSION}/dist/antd.min.js" -o "$BASE/ant-design-vue/antd.js"
-curl -L "https://cdn.jsdelivr.net/npm/ant-design-vue@${ANTDV_VERSION}/dist/antd.min.css" -o "$BASE/ant-design-vue/antd.min.css"
-
-# Formily（yss-ui 的 UMD 工厂会解构 Formily.*，需先定义）
-curl -L "https://cdn.jsdelivr.net/npm/@formily/core@${FORMILY_VERSION}/dist/formily.core.umd.js" -o "$BASE/formily/formily.core.umd.js"
-curl -L "https://cdn.jsdelivr.net/npm/@formily/vue@${FORMILY_VERSION}/dist/formily.vue.umd.js" -o "$BASE/formily/formily.vue.umd.js"
-# 不同生态包名可能为 @formily/antdv 或 @formily/antdv-x，任选其一可用即可
-curl -L "https://cdn.jsdelivr.net/npm/@formily/antdv-x@${FORMILY_VERSION}/dist/formily.antdv.umd.js" -o "$BASE/formily/formily.antdv.umd.js" || true
-curl -L "https://cdn.jsdelivr.net/npm/@formily/validator@${FORMILY_VERSION}/dist/formily.validator.umd.js" -o "$BASE/formily/formily.validator.umd.js"
-
-# YSS UI（UMD + 样式）
-curl -L "https://cdn.jsdelivr.net/npm/@yss-ui/components@${YSSUI_VERSION}/dist-umd/yss-ui.umd.js" -o "$BASE/yss-ui/yss-ui.umd.js"
-curl -L "https://cdn.jsdelivr.net/npm/@yss-ui/components@${YSSUI_VERSION}/dist-umd/yss-ui.css" -o "$BASE/yss-ui/yss-ui.css"
-
-echo "\n下载完成：请将 ${BASE} 目录发布到 Web 服务器可访问路径。"
-```
-
-> 无公网/私有 npm 的环境：可以直接从内部仓库复制 `packages/components/dist-umd/yss-ui.umd.js` 与 `yss-ui.css` 到 `static/vendor/yss-ui/`。
-
-## JSP 页面模板（完整可复制）
-
-以下示例演示如何在 JSP 中引入上述静态资源，并挂载一个最小应用。建议保留 `defer`，保证脚本按顺序解析后在 DOM 可用时执行。
-
-```html
-<%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
-<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
-<c:set var="ctx" value="${pageContext.request.contextPath}" />
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>YSS UI - JSP 集成示例</title>
-
-  <!-- 样式（YSS UI + Ant Design Vue） -->
-  <link rel="stylesheet" href="${ctx}/static/vendor/yss-ui/yss-ui.css" />
-  <link rel="stylesheet" href="${ctx}/static/vendor/ant-design-vue/antd.min.css" />
-
-  <!-- 依赖顺序：Vue3 -> xe-utils -> vxe-pc-ui -> vxe-table -> dayjs(+plugins) -> antd -> Formily -> yss-ui -->
-  <script src="${ctx}/static/vendor/vue3/vue.global.js" defer></script>
-  <script src="${ctx}/static/vendor/xe-utils/xe-utils.umd.min.js" defer></script>
-  <script src="${ctx}/static/vendor/vxe-pc-ui/index.umd.min.js" defer></script>
-  <script src="${ctx}/static/vendor/vxe-table/index.umd.min.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/dayjs.min.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/plugin/advancedFormat.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/plugin/customParseFormat.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/plugin/localeData.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/plugin/quarterOfYear.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/plugin/weekOfYear.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/plugin/weekYear.js" defer></script>
-  <script src="${ctx}/static/vendor/dayjs/plugin/weekday.js" defer></script>
-  <script src="${ctx}/static/vendor/ant-design-vue/antd.js" defer></script>
-  <script src="${ctx}/static/vendor/formily/formily.core.umd.js" defer></script>
-  <script src="${ctx}/static/vendor/formily/formily.vue.umd.js" defer></script>
-  <script src="${ctx}/static/vendor/formily/formily.antdv.umd.js" defer></script>
-  <script src="${ctx}/static/vendor/formily/formily.validator.umd.js" defer></script>
-  <script src="${ctx}/static/vendor/yss-ui/yss-ui.umd.js" defer></script>
-</head>
-<body>
-  <div id="app">
-    <a-config-provider :wave="{ disabled: true }">
-      <y-button type="primary">Hello JSP + YSS UI</y-button>
-    </a-config-provider>
-  </div>
-
-  <script defer>
-    const { createApp } = Vue;
-    const app = createApp({});
-    [window.VXETable, window.antd, window.YssUI].forEach(p => { try { p && app.use(p); } catch (e) { console.warn(e); } });
-    app.mount('#app');
-  </script>
-</body>
-</html>
-```
-
-> 插件注册方式与 Demo 一致：
-
-```90:95:/Users/wangyancong/Downloads/guangda/Sonorus/yss-ui-demo/main.js
-  const plugins = [window.VXETable, window.antd, window.YssUI];
-  plugins.forEach(p => { try { p && app.use(p); } catch (e) { console.warn('plugin use failed:', e); } });
-  app.mount('#app');
-```
-
-## 常见问题
-
-- **脚本一定要用 defer 吗？** 推荐使用。UMD 均无需模块系统，`defer` 可保证元素已解析再执行，同时保持加载顺序。
-- **Formily 是不是必须？** 目前 UMD 版本的 yss-ui 在工厂函数中会解构 `Formily.*`，因此需先定义。如果没有使用表单相关能力，也可在后续版本优化此约束。
-- **如何离线部署？** 将 `static/vendor` 目录随应用一起打包发布或由 Nginx 统一托管；JSP 通过 `${ctx}` 引用静态资源上下文。
-- **如何更新版本？** 只需替换对应文件即可，注意 vxe-pc-ui 与 vxe-table 的兼容矩阵，优先成对升级。
-
-### DOM 模板中的插槽命名
-
-HTML/JSP 等 DOM 模板会将属性名统一转为小写，这会影响具名插槽与指令参数的大小写匹配：
-
-- 请统一使用中划线（kebab-case）插槽名，例如：`#toolbar-left`、`#toolbar-right`、`#action-more-icon`、`#name-header`、`#name-filter`。
-- 对应地，组件内部已兼容旧的 camelCase 写法（如 `#toolbarLeft`），但在 DOM 模板中会被浏览器转为 `toolbarleft` 导致不匹配，建议尽快切换到 kebab-case。
-- 临时兼容方案：可使用动态参数写法避免浏览器改写（不推荐长期使用）：
-
-```html
-<!-- 动态 v-slot 名称在运行时计算，避免被浏览器转小写 -->
-<template v-slot:[slotName]>...</template>
-<script>
-  const slotName = 'toolbarLeft';
-</script>
-```
-
-
-## 进阶：拆分业务脚本
-
-当页面逻辑变复杂，建议将 `main.js` 独立到 `static/js/main.js`，JSP 只负责引入：
-
-```html
-<script src="${ctx}/static/js/main.js" defer></script>
-```
-
-脚本内容可参考 Demo：
-
-```75:95:/Users/wangyancong/Downloads/guangda/Sonorus/yss-ui-demo/main.js
-      return { columns, tableData, formState, roleOptions, statusOptions, handleSearch, handleReset };
-    },
-  });
-  const plugins = [window.VXETable, window.antd, window.YssUI];
-  plugins.forEach(p => { try { p && app.use(p); } catch (e) { console.warn('plugin use failed:', e); } });
-  app.mount('#app');
-```
-
----
-
-如需示例静态资源与完整页面，可参考仓库中的 Demo 目录 `Sonorus/yss-ui-demo/`。
-
-

package/template/.claude/skills/yss-ui/assets/docs/guide/llms.md

@@ -1,234 +0,0 @@
----
-title: AI 工具集成指南（LLMs.txt）
-description: 如何在 Cursor、Windsurf 等 AI 编程工具中使用 YSS UI 文档
-toc: content
----
-
-# AI 工具集成指南
-
-YSS UI 支持通过 <a href="https://llmstxt.org/" target="_blank">LLMs.txt</a> 文件向大语言模型（LLMs）提供文档。此功能可帮助 AI 工具更好地理解我们的组件库、API 及使用模式。
-
-## 什么是 LLMs.txt？
-
-LLMs.txt 是一个专门为大语言模型设计的文档格式规范。通过提供结构化的组件概览和完整文档，AI 编程工具能够：
-
-- 🤖 **自动获取组件文档** - AI 工具可以直接访问最新的组件 API 和用法
-- 💡 **提供准确的代码建议** - 基于真实文档生成正确的组件使用示例
-- 📚 **降低学习成本** - 开发时无需频繁切换到文档页面
-- ✨ **提高代码质量** - AI 能根据最佳实践自动提供建议
-
-## 可用资源
-
-我们提供两个 LLMs.txt 文件来帮助 AI 工具访问文档：
-
-### 推荐使用：llms-full.txt ⭐
-
-**<a href="/llms-full.txt" target="_blank">llms-full.txt</a>** - 完整文档
-
-包含所有组件的完整 API 文档、使用示例和最佳实践。**强烈推荐**作为默认配置，因为：
-- ✅ **更准确的代码生成** - AI 能看到完整的 Props、Events、Slots 定义
-- ✅ **真实示例参考** - 包含实际使用代码，避免 AI 猜测用法
-- ✅ **完整上下文** - 现代 AI 工具（Claude 200K、GPT-4 128K）完全支持这个大小
-
-### 轻量级索引：llms.txt
-
-**<a href="/llms.txt" target="_blank">llms.txt</a>** - 简版索引（1.6KB，70 行）
-
-仅包含组件列表和文档链接。适用于：
-- 上下文窗口受限的旧版 AI 工具
-- 只需要快速组件发现的场景
-- 网络带宽受限的环境
-
-> **建议**：优先使用 `llms-full.txt`，只有在遇到上下文限制时才降级使用 `llms.txt`。
-
-## 在 AI 工具中的使用
-
-### Cursor
-
-在 Cursor 中使用 `@Docs` 功能将 LLMs.txt 文件包含到您的项目中。这有助于 Cursor 为 YSS UI 组件提供更准确的代码建议和文档。
-
-**使用方法：**
-
-1. 在 Cursor 聊天窗口中输入 `@Docs`
-2. 输入 YSS UI 文档站点的 URL（部署后的地址）
-3. Cursor 会自动加载 llms.txt 文件
-
-**示例：**
-
-```
-@Docs http://192.168.164.27:3200
-```
-
-然后你可以直接询问：
-
-```
-如何使用 YTable 组件实现远程分页？
-```
-
-Cursor 将基于 YSS UI 的真实文档提供准确的回答和代码示例。
-
-<a href="https://docs.cursor.com/context/@-symbols/@-docs" target="_blank">详细了解 Cursor 中的 @Docs 功能</a>
-
----
-
-### Windsurf
-
-通过 `@` 引用或在 `.windsurf/rules` 文件中配置 LLMs.txt 文件，以增强 Windsurf 对 YSS UI 组件的理解。
-
-**使用方法 1：临时引用**
-
-```
-@ http://192.168.164.27:3200/llms-full.txt
-```
-
-**使用方法 2：持久化配置**
-
-在项目根目录创建 `.windsurf/rules` 文件：
-
-```markdown
-# YSS UI Documentation
-
-Always reference the YSS UI documentation when working with components:
-- http://192.168.164.27:3200/llms-full.txt
-```
-
-<a href="https://docs.windsurf.com/windsurf/cascade/memories" target="_blank">详细了解 Windsurf Memories 功能</a>
-
----
-
-### Claude Code
-
-在 Claude Code 中，将 LLMs.txt 添加到工作区的知识库（Docs / Context Files）配置中，即可在代码补全与解释时引用其中的内容。
-
-**使用方法：**
-
-1. 打开 Claude Code 设置
-2. 找到 "Docs / Context Files" 配置
-3. 添加 `http://192.168.164.27:3200/llms-full.txt`
-
-<a href="https://code.claude.com/docs" target="_blank">详细了解 Claude Code 文档上下文配置</a>
-
----
-
-### Trae
-
-在 Trae 中，将 LLMs.txt 文件放入项目的 knowledge sources 并在设置里开启引用。
-
-**使用方法：**
-
-1. 打开 Trae 项目设置
-2. 找到 "Knowledge Sources" 配置
-3. 添加 `http://192.168.164.27:3200/llms-full.txt`
-4. 启用该知识源
-
-<a href="https://trae.ai/docs" target="_blank">详细了解 Trae 的知识源功能</a>
-
----
-
-### Qoder
-
-在 Qoder 中，可以在 `.qoder/config.yml` 中添加 LLMs.txt 作为外部知识文件，或在对话中通过 `@docs` 进行临时引用。
-
-**使用方法 1：配置文件**
-
-在项目根目录创建 `.qoder/config.yml`：
-
-```yaml
-knowledge:
-  external_docs:
-    - url: http://192.168.164.27:3200/llms-full.txt
-      name: YSS UI Documentation
-```
-
-**使用方法 2：临时引用**
-
-```
-@docs http://192.168.164.27:3200/llms-full.txt
-```
-
-<a href="https://docs.qoder.com/" target="_blank">详细了解 Qoder 配置方法</a>
-
----
-
-### 其他 AI 工具
-
-任何支持 LLMs.txt 的 AI 工具均可使用以上路径来更好地理解 YSS UI。
-
-<!-- ## 本地开发
-
-如果你在本地开发环境中使用 AI 工具，推荐使用完整文档：
-
-```
-http://localhost:8000/llms-full.txt
-```
-
-如果遇到上下文限制，可以降级使用：
-```
-http://localhost:8000/llms.txt -->
-```
-
-## 最佳实践建议
-
-### 选择合适的文件
-
-**大多数情况：使用 llms-full.txt** ✅
-- 开发新功能、编写业务代码
-- 需要 AI 提供准确的 API 用法
-- 学习组件库的使用方式
-
-**特殊情况：使用 llms.txt**
-- AI 工具报告上下文窗口不足
-- 只需要快速查找组件名称
-- 网络环境较差，需要减少传输量
-
-### 如何验证 AI 已正确加载文档
-
-询问 AI 一些特定的问题来验证：
-
-```
-Q: YTable 组件的 pagination 属性支持哪些配置项？
-Q: YssFormily 的 mode 属性有哪些可选值？各代表什么含义？
-Q: 如何使用 YTree 组件的搜索功能？
-```
-
-如果 AI 能准确回答这些问题并提供符合实际 API 的代码示例，说明文档已成功加载。
-
-## 自动更新
-
-LLMs.txt 文件会在每次 CI/CD 构建时自动生成和更新，确保 AI 工具始终访问到最新的文档。
-
-如需手动重新生成，可以运行：
-
-```bash
-pnpm run generate:llms
-```
-
-## 常见问题
-
-### Q: llms.txt 和 llms-full.txt 有什么区别？应该用哪个？
-
-**A:** 
-- **推荐使用 `llms-full.txt`**（71KB）- 包含完整的 API 文档、Props、Events、示例代码，让 AI 生成更准确的代码
-- `llms.txt`（1.6KB）- 仅包含组件列表和链接，适合上下文窗口受限的场景
-
-现代 AI 工具（Claude、GPT-4、Gemini 等）完全支持 `llms-full.txt` 的大小，优先使用它能获得更好的代码生成效果。
-
-### Q: 如何确认 AI 工具已成功加载文档？
-
-**A:** 
-你可以直接询问 AI 工具关于 YSS UI 特定组件的问题，如果它能准确回答并提供符合实际 API 的代码示例，说明已成功加载。
-
-### Q: 文档更新后 AI 工具没有获取到最新内容？
-
-**A:** 
-某些 AI 工具会缓存文档内容。尝试：
-1. 重新加载文档引用
-2. 清除 AI 工具缓存
-3. 使用新的会话窗口
-
-## 反馈与建议
-
-如果你在使用 AI 工具集成时遇到问题，或有改进建议，欢迎：
-
-- 提交 Issue 到项目仓库
-- 联系技术支持团队