fast-element-plus 2.0.19 → 2.0.21

package/CHANGELOG.md

@@ -1,6 +1,31 @@
 # Changelog
 
-All notable changes to Fast.Element.Plus are documented in this file.
+All notable changes to this project are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and releases should follow [Semantic Versioning](https://semver.org/).
+
+## [2.0.21] - 2026-09-27
+
+### Fixed
+
+- Resolve nested `prop` paths consistently for default, date/time, numeric, link, tag, enum and image table columns, including local sorting.
+
+## [2.0.20] - 2026-09-22
+
+### Fixed
+
+- Keep independent Loading ownership for concurrent button/table tasks and external/manual states; stale completions cannot release another task.
+- Cancel delayed table work on unmount, invalidate stale request results immediately on rerender and disconnect ResizeObserver through actual watchEffect cleanup.
+- Prefer current remote option labels while retaining out-of-page selections, and clear stale selector caches after reset/context changes.
+- Release debounce/throttle timers on directive unmount; preserve the throttle unlock timer across extra events and callback errors.
+- Track FaButton overlay ownership so initial false state, duplicate completion and unmount do not close another component's overlay.
+
+### Documentation and Tooling
+
+- Admit Icons 2.x and the corrected 3.x through the peer range; the installer continues registering `fa-icon-*` by public export keys. Locked development dependencies remain unchanged.
+- Correct localized Fast.Docs links and retain minimal README examples.
+- Align public-contract comments and agent guidance.
+- Keep ESLint and Prettier skill-file ignores separate and add regression checks.
 
 ## [2.0.19] - 2026-09-16
 
@@ -209,23 +234,25 @@ All notable changes to Fast.Element.Plus are documented in this file.
 - Scoped Table styles and added responsive IconSelector styling.
 - Improved dialogs, drawers, tables, forms, trees, selectors, car-number input, images, and uploads for dark mode, touch input, and narrow viewports.
 
-[2.0.19]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.19
-[2.0.18]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.18
-[2.0.17]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.17
-[2.0.16]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.16
-[2.0.15]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.15
-[2.0.14]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.14
-[2.0.13]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.13
-[2.0.12]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.12
-[2.0.11]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.11
-[2.0.10]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.10
-[2.0.9]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.9
-[2.0.8]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.8
-[2.0.7]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.7
-[2.0.6]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.6
-[2.0.5]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.5
-[2.0.4]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.4
-[2.0.3]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.3
-[2.0.2]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.2
-[2.0.1]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.1
+[2.0.21]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.20...v2.0.21
+[2.0.20]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.19...v2.0.20
+[2.0.19]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.18...v2.0.19
+[2.0.18]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.17...v2.0.18
+[2.0.17]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.16...v2.0.17
+[2.0.16]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.15...v2.0.16
+[2.0.15]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.14...v2.0.15
+[2.0.14]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.13...v2.0.14
+[2.0.13]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.12...v2.0.13
+[2.0.12]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.11...v2.0.12
+[2.0.11]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.10...v2.0.11
+[2.0.10]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.9...v2.0.10
+[2.0.9]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.8...v2.0.9
+[2.0.8]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.7...v2.0.8
+[2.0.7]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.6...v2.0.7
+[2.0.6]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.5...v2.0.6
+[2.0.5]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.4...v2.0.5
+[2.0.4]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.3...v2.0.4
+[2.0.3]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.2...v2.0.3
+[2.0.2]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.1...v2.0.2
+[2.0.1]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.0...v2.0.1
 [2.0.0]: https://gitee.com/FastDotnet/fast.element.plus/releases/tag/v2.0.0

package/CONTRIBUTING.md

@@ -15,7 +15,7 @@ pnpm check
 ```
 
 Use `pnpm dev` when a long-running tsdown watch build is useful during implementation.
-Use `pnpm docs:dev` to review component examples and documentation changes in the VitePress site.
+Review component usage and examples in the [documentation](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/).
 
 ## Design rules
 
@@ -52,7 +52,6 @@ Run the narrowest relevant command during development, then run the full set bef
 pnpm typecheck
 pnpm lint
 pnpm test
-pnpm docs:build
 pnpm format:check
 pnpm --config.ignore-scripts=true pack --dry-run
 ```
@@ -61,9 +60,9 @@ pnpm --config.ignore-scripts=true pack --dry-run
 
 Use one release flow: change code → update the package version → review and synchronize affected documentation → update the reviewed documentation version → run tests and the documentation build.
 
-The single reviewed documentation version is `docReviewVersion` in the frontmatter of `docs/index.md`. It means the documentation has been checked against that package version; it is not the version in which a component or property was introduced. Before updating it, compare the release changes with source and verify the affected Props, Events, Slots, Exposes, `v-model` contracts, defaults, types, behavior, and examples. Update the field after the review even when no documentation text needs to change. If the change scope is uncertain, widen the review instead of assuming that no documentation update is required.
+Documentation maintainers record the reviewed package version as `docReviewVersion`. It means the documentation has been checked against that package version; it is not the version in which a component or property was introduced. Before updating it, compare the release changes with source and verify the affected Props, Events, Slots, Exposes, `v-model` contracts, defaults, types, behavior, and examples. Update the field after the review even when no documentation text needs to change. If the change scope is uncertain, widen the review instead of assuming that no documentation update is required.
 
-`pnpm test:docs` checks the package/documentation version match, public component API-page coverage, required API references, and Markdown example paths. These stable checks do not prove that every semantic description or example is correct, so never update only `docReviewVersion` to make the test pass.
+The documentation validation workflow checks the package/documentation version match, public component API-page coverage, required API references, and Markdown example paths. These stable checks do not prove that every semantic description or example is correct, so never update only `docReviewVersion` to make the test pass.
 
 ## Dependencies
 

package/README.md

@@ -1,31 +1,34 @@
-[中文](./README.zh.md) | **English**
-
-<h1 align="center">Fast.Element.Plus</h1>
+[简体中文](./README.zh.md) | **English**
 
 <p align="center">
-	Typed Vue 3 components, directives, and hooks for business applications built on Element Plus.
+	<img src="./Fast.png" width="128" alt="Fast.Element.Plus Logo" />
 </p>
 
+<h1 align="center">Fast.Element.Plus</h1>
+
 <p align="center">
-	<a href="https://www.npmjs.com/package/fast-element-plus"><img src="https://img.shields.io/npm/v/fast-element-plus?color=orange" alt="npm version" /></a>
-	<a href="https://gitee.com/FastDotnet/fast.element.plus/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/fast-element-plus" alt="license" /></a>
+	<a href="https://www.npmjs.com/package/fast-element-plus"><img src="https://img.shields.io/npm/v/fast-element-plus?logo=npm" alt="npm version" /></a>
+	<a href="https://www.npmjs.com/package/fast-element-plus"><img src="https://img.shields.io/npm/dm/fast-element-plus" alt="npm downloads" /></a>
+	<a href="./LICENSE"><img src="https://img.shields.io/npm/l/fast-element-plus" alt="License" /></a>
 </p>
 
-Fast.Element.Plus is an officially open-source Fast business SDK for the Fast team and developers who adopt its coding and interaction conventions. It provides opinionated form, selection, table, tree, upload, layout, dialog, drawer, image, icon, and utility components, plus installable directives, browser UI hooks, shared constants, global component types, and one complete `app.use()` plugin.
+A Vue 3 and Element Plus business-component SDK with components, directives, hooks and types.
+
+**[Documentation](http://docs.fastdotnet.cn/en-US/frontend/element-plus/) · [Official website](http://fastdotnet.com)**
 
-The SDK builds business behavior on Element Plus and is not a drop-in replacement. Some defaults, event semantics, remote-data flows, and interactions intentionally follow Fast team conventions.
+This SDK is not a drop-in replacement for Element Plus; business defaults, event semantics and data flows follow Fast conventions.
 
 ## Requirements
 
 - ES2022 modern browsers or WebViews.
-- Vue `^3.5.41`.
+- Vue `^3.5.11`.
 - Element Plus `^2.14.5`.
 - Element Plus Icons `^2.3.2`.
 - Fast.Element.Plus.Icons `^2.0.0`.
 
 Vue, Element Plus, Element Plus Icons, and Fast.Element.Plus.Icons are required peer dependencies. Both icon packages remain external to the build. Package managers install declared runtime dependencies automatically, and the ESM build keeps those imports external instead of copying them into `dist/node_modules`; the CDN IIFE bundles them for direct browser use. Component-only utilities are included in the Fast.Element.Plus build.
 
-The current manually audited Element Plus baseline is `2.14.x`. When the Element Plus minor version changes, for example from `2.14.x` to `2.15.x` or later, native Props, Emits, Slots, exposed methods, defaults, and internal style structures must be audited again. See [Element Plus compatibility and upgrade audit](./docs/ELEMENT_PLUS_COMPATIBILITY.md).
+The current manually audited Element Plus baseline is `2.14.x`. When the Element Plus minor version changes, for example from `2.14.x` to `2.15.x` or later, native Props, Emits, Slots, exposed methods, defaults, and internal style structures must be audited again. See [Element Plus compatibility and upgrade audit](http://docs.fastdotnet.cn/en-US/frontend/element-plus/ELEMENT_PLUS_COMPATIBILITY).
 
 ## Install
 
@@ -33,7 +36,43 @@ The current manually audited Element Plus baseline is `2.14.x`. When the Element
 pnpm add fast-element-plus vue element-plus @element-plus/icons-vue @fast-element-plus/icons-vue
 ```
 
-## Use
+## CDN
+
+The jsDelivr entry uses `dist/index.global.min.js`. Load Vue, Element Plus, Element Plus Icons, and Fast.Element.Plus.Icons first, then access the library as `globalThis.FastElementPlus`. Load `dist/index.css` separately.
+
+| Resource                                     | jsDelivr                                                                            | unpkg                                                                 |
+| -------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| `fast-element-plus/dist/index.global.min.js` | [jsDelivr](https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.global.min.js) | [unpkg](https://unpkg.com/fast-element-plus/dist/index.global.min.js) |
+| `fast-element-plus/dist/index.css`           | [jsDelivr](https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.css)           | [unpkg](https://unpkg.com/fast-element-plus/dist/index.css)           |
+
+```html
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="UTF-8" />
+		<title>Fast Element Plus</title>
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.css" />
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.css" />
+	</head>
+	<body>
+		<div id="app"></div>
+		<script src="https://cdn.jsdelivr.net/npm/vue@3.5.11/dist/vue.global.prod.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.full.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/@element-plus/icons-vue@2.3.2/dist/index.iife.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/@fast-element-plus/icons-vue/dist/index.global.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.global.min.js"></script>
+		<script>
+			Vue.createApp({
+				render: () => Vue.h(globalThis.FastElementPlus.FaButton, { type: "primary" }, () => "Button"),
+			})
+				.use(globalThis.FastElementPlus)
+				.mount("#app");
+		</script>
+	</body>
+</html>
+```
+
+## Quick start
 
 Register the complete component library:
 
@@ -83,6 +122,24 @@ For global component and directive types, add the package type entry to the appl
 }
 ```
 
+## Component example
+
+After the full installation above, use the button in a page:
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+
+const count = ref(0);
+</script>
+
+<template>
+	<FaButton :disabled-loading="true" @click="count++">{{ count }}</FaButton>
+</template>
+```
+
+When using internal loading for asynchronous work, finish through the click `done` callback or the exposed `doLoading()` contract.
+
 ## Public modules
 
 | Module     | Public APIs                                                                                                                                                                                                                                                                                                                                                                              |
@@ -97,29 +154,25 @@ The package root is the only JavaScript API entry. `fast-element-plus/global` pr
 
 Open-ended business rows, paging extensions, selector/tree payloads, request parameters, and dynamic configuration use `any` where the SDK cannot know the application schema; exported generics can constrain known models. Untrusted runtime inputs, errors, and values that require validation remain `unknown`. `DefaultRow` is the public default FaTable row type for business tables whose fields are not declared in advance.
 
-## CDN
-
-The `unpkg` and `jsdelivr` fields select `dist/index.global.min.js`. Load Vue, Element Plus, Element Plus Icons, and Fast.Element.Plus.Icons first, then access the library as `globalThis.FastElementPlus`. Load `dist/index.css` separately.
-
 ## Documentation
 
-- [Component documentation and interactive examples (Chinese)](./docs/components/overview.md)
-- [Installation guide (Chinese)](./docs/guide/installation.md)
-- [Documentation build and deployment (Chinese)](./docs/guide/deployment.md)
-- [API reference](./docs/API.md)
-- [Runtime contract](./docs/RUNTIME_CONTRACT.md)
-- [Element Plus compatibility and upgrade audit](./docs/ELEMENT_PLUS_COMPATIBILITY.md)
+- [Component documentation and interactive examples (Chinese)](http://docs.fastdotnet.cn/en-US/frontend/element-plus/components/overview)
+- [Installation guide (Chinese)](http://docs.fastdotnet.cn/en-US/frontend/element-plus/guide/installation)
+- [Documentation build and deployment (Chinese)](http://docs.fastdotnet.cn/en-US/frontend/element-plus/guide/deployment)
+- [API reference](http://docs.fastdotnet.cn/en-US/frontend/element-plus/api/)
+- [Runtime contract](http://docs.fastdotnet.cn/en-US/frontend/element-plus/RUNTIME_CONTRACT)
+- [Element Plus compatibility and upgrade audit](http://docs.fastdotnet.cn/en-US/frontend/element-plus/ELEMENT_PLUS_COMPATIBILITY)
 - [Development and release guide (Chinese)](./docs/DEVELOPMENT_RELEASE.zh-CN.md)
 - [Contributing](./CONTRIBUTING.md)
 - [Security policy](./SECURITY.md)
 - [Changelog](./CHANGELOG.md)
 
-Run the complete documentation site locally:
+## Copyright, license and use
 
-```bash
-pnpm docs:dev
-```
+Copyright © 2018-Now 小方. This project uses [Apache License 2.0](./LICENSE). Use, modification, distribution and commercial use are permitted subject to its terms.
+
+When redistributing, provide the license, mark modified files and preserve applicable copyright, attribution and supplied NOTICE information as required. This summary does not replace the license or impose additional UI attribution.
 
-## License
+Users are responsible for the legal compliance and authorization of their own modifications, deployment, data processing and operations. This reminder is not an additional license condition.
 
-[Apache-2.0](./LICENSE)
+Except as required by applicable law or agreed in writing, the software is provided on an "AS IS" basis. Sections 7 and 8 govern warranty disclaimers and liability limits. Providing the project does not endorse downstream activities or assume users' contractual commitments. This statement does not exclude liability that cannot lawfully be excluded.

package/README.zh.md

@@ -1,31 +1,34 @@
-**中文** | [English](./README.md)
-
-<h1 align="center">Fast.Element.Plus</h1>
+**简体中文** | [English](./README.md)
 
 <p align="center">
-	基于 Element Plus 构建的 Vue 3 类型化业务组件、指令与 Hook。
+	<img src="./Fast.png" width="128" alt="Fast.Element.Plus Logo" />
 </p>
 
+<h1 align="center">Fast.Element.Plus</h1>
+
 <p align="center">
-	<a href="https://www.npmjs.com/package/fast-element-plus"><img src="https://img.shields.io/npm/v/fast-element-plus?color=orange" alt="npm 版本" /></a>
-	<a href="https://gitee.com/FastDotnet/fast.element.plus/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/fast-element-plus" alt="开源协议" /></a>
+	<a href="https://www.npmjs.com/package/fast-element-plus"><img src="https://img.shields.io/npm/v/fast-element-plus?logo=npm" alt="npm version" /></a>
+	<a href="https://www.npmjs.com/package/fast-element-plus"><img src="https://img.shields.io/npm/dm/fast-element-plus" alt="npm downloads" /></a>
+	<a href="./LICENSE"><img src="https://img.shields.io/npm/l/fast-element-plus" alt="License" /></a>
 </p>
 
-Fast.Element.Plus 是正式开源的 Fast 系列业务 SDK，面向 Fast 团队以及认同 Fast 团队编码与交互约定的开发者。它提供表单、选择器、表格、树、上传、布局、对话框、抽屉、图片、图标等约定式组件，以及可安装指令、浏览器 UI Hook、共享常量、全局组件类型和完整的 `app.use()` 插件。
+基于 Vue 3 和 Element Plus 的业务组件 SDK，提供组件、指令、Hooks 与类型。
+
+**[使用文档](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/) · [官方网站](http://fastdotnet.com)**
 
-本 SDK 基于 Element Plus 进行业务增强，不承诺无差异替代 Element Plus 原生组件。部分默认 Props、事件语义、远程数据流程和交互行为会遵循 Fast 团队约定。
+本库不是 Element Plus 的直接替代品；业务默认值、事件语义和数据交互遵循 Fast 约定。
 
 ## 环境要求
 
 - 支持 ES2022 的现代浏览器或 WebView。
-- Vue `^3.5.41`。
+- Vue `^3.5.11`。
 - Element Plus `^2.14.5`。
 - Element Plus Icons `^2.3.2`。
 - Fast.Element.Plus.Icons `^2.0.0`。
 
 Vue、Element Plus、Element Plus Icons 和 Fast.Element.Plus.Icons 均为强制 Peer Dependency。两套图标包保持在构建产物之外。包管理器会自动安装正式 Runtime Dependency，ESM 构建保留这些外部导入，不再将其复制到 `dist/node_modules`；CDN IIFE 仍会内联依赖以支持浏览器直接使用。组件内部工具包含在 Fast.Element.Plus 构建产物中。
 
-当前 Element Plus 人工审计基线为 `2.14.x`。当 Element Plus 次版本号发生变化，例如由 `2.14.x` 升级到 `2.15.x` 或更高时，必须重新核对封装涉及的原生 Props、Emits、Slots、Expose、默认值和内部样式结构，详见 [Element Plus 兼容性与升级核对](./docs/ELEMENT_PLUS_COMPATIBILITY.zh-CN.md)。
+当前 Element Plus 人工审计基线为 `2.14.x`。当 Element Plus 次版本号发生变化，例如由 `2.14.x` 升级到 `2.15.x` 或更高时，必须重新核对封装涉及的原生 Props、Emits、Slots、Expose、默认值和内部样式结构，详见 [Element Plus 兼容性与升级核对](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/ELEMENT_PLUS_COMPATIBILITY)。
 
 ## 安装
 
@@ -33,7 +36,43 @@ Vue、Element Plus、Element Plus Icons 和 Fast.Element.Plus.Icons 均为强制
 pnpm add fast-element-plus vue element-plus @element-plus/icons-vue @fast-element-plus/icons-vue
 ```
 
-## 使用
+## CDN
+
+jsDelivr 入口为 `dist/index.global.min.js`。页面先加载 Vue、Element Plus、Element Plus Icons 和 Fast.Element.Plus.Icons，再通过 `globalThis.FastElementPlus` 访问组件库。样式需单独加载 `dist/index.css`。
+
+| 资源                                         | jsDelivr                                                                            | unpkg                                                                 |
+| -------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| `fast-element-plus/dist/index.global.min.js` | [jsDelivr](https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.global.min.js) | [unpkg](https://unpkg.com/fast-element-plus/dist/index.global.min.js) |
+| `fast-element-plus/dist/index.css`           | [jsDelivr](https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.css)           | [unpkg](https://unpkg.com/fast-element-plus/dist/index.css)           |
+
+```html
+<!doctype html>
+<html lang="zh-CN">
+	<head>
+		<meta charset="UTF-8" />
+		<title>Fast Element Plus</title>
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.css" />
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.css" />
+	</head>
+	<body>
+		<div id="app"></div>
+		<script src="https://cdn.jsdelivr.net/npm/vue@3.5.11/dist/vue.global.prod.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.full.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/@element-plus/icons-vue@2.3.2/dist/index.iife.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/@fast-element-plus/icons-vue/dist/index.global.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.global.min.js"></script>
+		<script>
+			Vue.createApp({
+				render: () => Vue.h(globalThis.FastElementPlus.FaButton, { type: "primary" }, () => "按钮"),
+			})
+				.use(globalThis.FastElementPlus)
+				.mount("#app");
+		</script>
+	</body>
+</html>
+```
+
+## 快速开始
 
 注册完整组件库：
 
@@ -97,29 +136,29 @@ useOverlay.show();
 
 业务行、分页扩展字段、选择器与树节点附加数据、请求参数和动态配置在 SDK 无法预知应用模型时使用 `any`，已知模型可通过公开泛型约束；未经验证的运行时输入、错误对象和必须先收窄的值继续使用 `unknown`。`DefaultRow` 是 FaTable 默认公开行类型，可直接用于未预先定义字段的业务表格。
 
-## CDN
-
-`unpkg` 和 `jsdelivr` 字段都指向 `dist/index.global.min.js`。页面先加载 Vue、Element Plus、Element Plus Icons 和 Fast.Element.Plus.Icons，再通过 `globalThis.FastElementPlus` 访问组件库。样式需单独加载 `dist/index.css`。
-
 ## 文档
 
-- [组件文档与交互案例](./docs/components/overview.md)
-- [安装与使用](./docs/guide/installation.md)
-- [文档站构建与部署](./docs/guide/deployment.md)
-- [API 参考](./docs/API.zh-CN.md)
-- [运行时契约](./docs/RUNTIME_CONTRACT.md)
-- [Element Plus 兼容性与升级核对](./docs/ELEMENT_PLUS_COMPATIBILITY.zh-CN.md)
+- [组件文档与交互案例](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/components/overview)
+- [安装与使用](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/guide/installation)
+- [文档站构建与部署](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/guide/deployment)
+- [API 参考](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/api/)
+- [运行时契约](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/RUNTIME_CONTRACT)
+- [Element Plus 兼容性与升级核对](http://docs.fastdotnet.cn/zh-CN/frontend/element-plus/ELEMENT_PLUS_COMPATIBILITY)
 - [开发与发布指南](./docs/DEVELOPMENT_RELEASE.zh-CN.md)
 - [贡献指南](./CONTRIBUTING.md)
 - [安全策略](./SECURITY.md)
 - [更新日志](./CHANGELOG.md)
 
-本地运行完整文档站：
-
-```bash
-pnpm docs:dev
-```
-
 ## 开源协议
 
 [Apache-2.0](./LICENSE)
+
+## 版权、许可证与使用声明
+
+版权所有 © 2018-Now 小方。本项目依据 [Apache License 2.0](./LICENSE) 开源；在遵守许可证的前提下，可以使用、修改和分发本软件，包括商业使用。
+
+再分发时，应按许可证要求提供许可证副本、对修改的文件作出显著说明，并保留适用的版权和归属声明；包含需要保留的 NOTICE 信息时一并处理。本说明不替代正式许可证，也不额外要求在产品界面展示作者或项目标识。
+
+使用者应就自身使用、二次开发、部署、数据处理及运营活动遵守适用法律和第三方合法权益，自行取得依法需要的授权。上述内容为合规提醒，不构成附加许可条件。
+
+除适用法律另有规定或另有书面约定外，本软件按“原样”提供；保证排除与责任限制以许可证第 7、8 条为准。提供本项目不代表原作者为使用者的二次开发和运营活动背书，也不当然承担其对第三方作出的合同承诺。本说明不排除依法不得排除的责任。