c-admin-kit 1.0.1 → 1.0.2

package/LLMS.md

@@ -1,6 +1,7 @@
 # C-Admin-Kit: AI Assistant Context & Guidelines
 
-> This document is designed for AI Coding Assistants (Cursor, GitHub Copilot, Claude Code, Antigravity, Windsurf, etc.) to understand the architectural rules, coding standards, and golden patterns of `c-admin-kit`.
+> This document is designed for AI Coding Assistants (Cursor, GitHub Copilot, Claude Code, Antigravity, Windsurf, etc.) to understand the architectural rules, coding standards, and golden patterns of `c-admin-kit`.  
+> 🌐 **Live Demo & Playground**: [https://admin-kit.cheatppf.xyz](https://admin-kit.cheatppf.xyz)
 
 ---
 
@@ -57,7 +58,7 @@ import {
 
 ---
 
-## 🌟 The Golden Standard Pattern (Standard CRUD Page)
+## Standard CRUD Page Pattern
 
 AI should use this template as the standard blueprint for any admin list view:
 

package/README.md

@@ -11,6 +11,7 @@
 
 `c-admin-kit` 是一套专为企业级中后台打造的高阶通用组件与 Hooks 套件。基于 **Vue 3 + Element Plus + TypeScript** 构建，提供成熟的标准 CRUD 流程封装、配置化高级表格、多条件搜索工厂、异步防重按钮、平滑拖拽分栏及常用树形数据工具函数。
 
+> 🌐 **在线预览与交互演练场**：[https://admin-kit.cheatppf.xyz](https://admin-kit.cheatppf.xyz)  
 > 📌 **团队规范约束**：为彻底避免多工程复用时的组件同名冲突，所有组件**统一且固定强制使用 `c-` / `C` 前缀**（如 `<c-simple-table>`、`<c-search-box>`），开箱即用，代码风格统一。
 
 ---
@@ -84,9 +85,9 @@ import 'c-admin-kit/dist/c-admin-kit.css'
 
 ---
 
-## 🌟 黄金组合：10 行代码实现企业级标准 CRUD 页面
+## 典型用法：标准 CRUD 页面
 
-结合 `SearchFieldFactory`、`useListPage`、`CSearchBox` 与 `CSimpleTable`，告别繁重重复模板：
+结合 `SearchFieldFactory`、`useListPage`、`CSearchBox` 与 `CSimpleTable` 快速构建后台列表页：
 
 ```vue
 <template>
@@ -304,6 +305,34 @@ const filteredTree = filterTree(tree, (node) => node.name.includes('技术部'))
 
 ---
 
+## 🎮 Playground 交互演练台
+
+> 🔗 **线上演示地址**：[https://admin-kit.cheatppf.xyz](https://admin-kit.cheatppf.xyz)
+
+本项目包含同仓物理隔离的独立演练工程 `playground/`，**100% 消费并运行 NPM 官方已发布的真实 `c-admin-kit` 远端包与产物**，包含 6 大核心场景 Demo（CRUD 页面、左右拖拽容器、文本代码比对、抽屉组件、增强选择器、树算法测试台）：
+
+```bash
+# 启动本地演练场（真实加载 npm 已发布的 c-admin-kit）
+pnpm run dev:playground
+
+# 打包纯静态 SPA 站点（输出至 playground/dist/）
+pnpm run build:playground
+
+# 本地快速预览打包产物
+pnpm run preview:playground
+```
+
+### 🚀 部署至 Cloudflare Pages 步骤：
+1. 登录 Cloudflare 控制台，进入 **Workers & Pages** -> **Create application** -> **Pages** -> **Connect to Git**；
+2. 选择本仓库，配置构建设置：
+   - **Root directory**: `playground`
+   - **Framework preset**: `Vite`
+   - **Build command**: `pnpm run build`
+   - **Build output directory**: `dist`
+3. 点击 **Save and Deploy**，即可自动从 NPM 官方拉取最新发布的 `c-admin-kit` 并部署为全球 CDN 静态网页。
+
+---
+
 ## 📄 授权协议
 
 [MIT License](file:///e:/售后项目/admin-kit/LICENSE) © 2026 [wllcyg](https://github.com/wllcyg)

package/llms.txt

@@ -15,5 +15,5 @@
 - `useDownload`: Composable for file export with `downloading` status and filename auto-detect.
 - `treeManager`: Utilities for `listToTree` (O(n)), `treeToList`, and `findParentNodes`.
 
-## Detailed Guidelines & Golden Pattern
+## Detailed Guidelines & Standard Patterns
 See [LLMS.md](./LLMS.md) for full contracts, component API, and standard CRUD blueprints.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c-admin-kit",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "基于 Vue 3 + Element Plus 的中后台企业级高阶通用组件与 Hooks 套件（强制使用 c- 前缀）",
   "type": "module",
   "main": "./dist/c-admin-kit.umd.cjs",
@@ -83,6 +83,9 @@
   },
   "scripts": {
     "build": "vue-tsc --noEmit && vite build",
+    "dev:playground": "npm --prefix playground run dev",
+    "build:playground": "npm --prefix playground run build",
+    "preview:playground": "npm --prefix playground run preview",
     "typecheck": "vue-tsc --noEmit"
   }
 }