@uxda/appkit 4.3.32 → 4.3.33

package/.cursor/skills/appkit-build-update-component-rules/SKILL.md

@@ -1,54 +1,54 @@
----
-name: appkit-build-update-component-rules
-description: After running npm run build for @uxda/appkit, updates Appkit组件使用规则.md and optionally syncs it to one or more consumer projects' .cursor/rules/appkit.mdc. Use when the user runs build, asks to update or sync component rules, sync to host project(s), or mentions keeping Appkit组件使用规则.md up to date.
----
-
-# Appkit 构建后更新组件使用规则
-
-在项目执行 `npm run build` 后，同步更新根目录下的 `Appkit组件使用规则.md`，使文档与当前源码导出和组件 API 保持一致。
-
-## 工作流程
-
-按顺序执行：
-
-1. **执行构建**
-   - 在项目根目录运行：`npm run build`
-   - 确认构建成功（无报错）
-
-2. **收集当前组件导出**
-   - 扫描以下入口的**具名导出**（仅组件，不含 composables/services）：
-     - `src/payment/components/index.ts`
-     - `src/balance/components/index.ts`
-     - `src/notice/components/index.ts`
-     - `src/user/components/index.ts`
-     - `src/register/components/index.ts`
-     - `src/scenarios/components/index.ts`
-     - `src/shared/components/index.ts`（若文档中有「通用基础组件」则也对照 `src/components/` 下 dd-* 等）
-   - 按模块整理为：模块名 → 组件名列表
-
-3. **对照并更新文档**
-   - 打开 `Appkit组件使用规则.md`，定位到「目录」部分（各模块下的链接列表）。
-   - **新增**：若某模块在源码中有导出但文档目录/正文没有的组件，在对应模块下增加目录项，并在文档正文中为该组件新增一节（至少包含：功能描述、导入方式、Props/Events/Slots 表）。
-   - **删除/弃用**：若文档中某组件在对应模块的 index 中已不再导出，从目录中移除该链接，正文中可保留并标注「已废弃」或删除该节（按项目习惯二选一）。
-   - **命名与锚点**：目录链接格式保持为 `[ComponentName - 中文描述](#componentname---中文描述)`，锚点使用小写+连字符，与现有文档风格一致。
-
-4. **（可选）核对组件 API**
-   - 对文档中已有详细说明的组件，可对照其 Vue 文件中的 `defineProps` / `defineEmits` 与文档中的 Props/Events 表，若不一致则更新文档（类型、必填、默认值、说明）。
-   - 若组件仅有占位节（如“待补充”），可根据 Vue 源码补充 Props/Events/Slots 表。
-
-5. **（可选）同步到宿主项目**
-   - 文档更新完成后，将 `Appkit组件使用规则.md` 的完整内容同步到**一个或多个**使用 Appkit 的宿主项目的 Cursor 规则（`.cursor/rules/appkit.mdc`），使这些项目使用最新组件说明。
-   - 操作：执行 `appkit-sync-component-rules` 技能；目标项目由用户指定（如「同步到 portal-weapp、xx 项目」）或按项目约定（如 `../portal-weapp/.cursor/rules/appkit.mdc`、`../其他项目/.cursor/rules/appkit.mdc`）。若目录不存在则先创建。
-   - 用户要求「构建并同步到宿主项目」或「更新文档并同步到 xx 项目」时执行本步；仅要求「构建/更新文档」时也可主动执行，或询问是否同步及同步到哪些项目。
-
-## 文档结构约定
-
-- 文档路径：项目根目录 `Appkit组件使用规则.md`。
-- 目录按模块分组：支付模块 (Payment)、余额模块 (Balance)、消息通知模块 (Notice)、用户模块 (User)、注册模块 (Register)、业务场景 (Scenarios)、通用基础组件 (Components)。
-- 每个组件一节，包含：功能描述、导入方式、Props 表、Events 表、Slots 表（如有）、使用示例、功能特性等；可随现有文档风格微调。
-
-## 注意事项
-
-- 仅以各模块的 `components/index.ts` 的**导出组件**为“当前应有”的清单；内部使用但未导出的组件（如 RightsPicker 仅在 TradeView 内用）是否写入文档由项目约定决定，本技能以导出清单为准做同步。
-- 更新时保持现有 Markdown 格式与标题层级不变；新增小节时与同模块其他组件节的格式一致。
-- 若构建失败，先解决构建问题再执行文档更新。
+---
+name: appkit-build-update-component-rules
+description: After running npm run build for @uxda/appkit, updates Appkit组件使用规则.md and optionally syncs it to one or more consumer projects' .cursor/rules/appkit.mdc. Use when the user runs build, asks to update or sync component rules, sync to host project(s), or mentions keeping Appkit组件使用规则.md up to date.
+---
+
+# Appkit 构建后更新组件使用规则
+
+在项目执行 `npm run build` 后，同步更新根目录下的 `Appkit组件使用规则.md`，使文档与当前源码导出和组件 API 保持一致。
+
+## 工作流程
+
+按顺序执行：
+
+1. **执行构建**
+   - 在项目根目录运行：`npm run build`
+   - 确认构建成功（无报错）
+
+2. **收集当前组件导出**
+   - 扫描以下入口的**具名导出**（仅组件，不含 composables/services）：
+     - `src/payment/components/index.ts`
+     - `src/balance/components/index.ts`
+     - `src/notice/components/index.ts`
+     - `src/user/components/index.ts`
+     - `src/register/components/index.ts`
+     - `src/scenarios/components/index.ts`
+     - `src/shared/components/index.ts`（若文档中有「通用基础组件」则也对照 `src/components/` 下 dd-* 等）
+   - 按模块整理为：模块名 → 组件名列表
+
+3. **对照并更新文档**
+   - 打开 `Appkit组件使用规则.md`，定位到「目录」部分（各模块下的链接列表）。
+   - **新增**：若某模块在源码中有导出但文档目录/正文没有的组件，在对应模块下增加目录项，并在文档正文中为该组件新增一节（至少包含：功能描述、导入方式、Props/Events/Slots 表）。
+   - **删除/弃用**：若文档中某组件在对应模块的 index 中已不再导出，从目录中移除该链接，正文中可保留并标注「已废弃」或删除该节（按项目习惯二选一）。
+   - **命名与锚点**：目录链接格式保持为 `[ComponentName - 中文描述](#componentname---中文描述)`，锚点使用小写+连字符，与现有文档风格一致。
+
+4. **（可选）核对组件 API**
+   - 对文档中已有详细说明的组件，可对照其 Vue 文件中的 `defineProps` / `defineEmits` 与文档中的 Props/Events 表，若不一致则更新文档（类型、必填、默认值、说明）。
+   - 若组件仅有占位节（如“待补充”），可根据 Vue 源码补充 Props/Events/Slots 表。
+
+5. **（可选）同步到宿主项目**
+   - 文档更新完成后，将 `Appkit组件使用规则.md` 的完整内容同步到**一个或多个**使用 Appkit 的宿主项目的 Cursor 规则（`.cursor/rules/appkit.mdc`），使这些项目使用最新组件说明。
+   - 操作：执行 `appkit-sync-component-rules` 技能；目标项目由用户指定（如「同步到 portal-weapp、xx 项目」）或按项目约定（如 `../portal-weapp/.cursor/rules/appkit.mdc`、`../其他项目/.cursor/rules/appkit.mdc`）。若目录不存在则先创建。
+   - 用户要求「构建并同步到宿主项目」或「更新文档并同步到 xx 项目」时执行本步；仅要求「构建/更新文档」时也可主动执行，或询问是否同步及同步到哪些项目。
+
+## 文档结构约定
+
+- 文档路径：项目根目录 `Appkit组件使用规则.md`。
+- 目录按模块分组：支付模块 (Payment)、余额模块 (Balance)、消息通知模块 (Notice)、用户模块 (User)、注册模块 (Register)、业务场景 (Scenarios)、通用基础组件 (Components)。
+- 每个组件一节，包含：功能描述、导入方式、Props 表、Events 表、Slots 表（如有）、使用示例、功能特性等；可随现有文档风格微调。
+
+## 注意事项
+
+- 仅以各模块的 `components/index.ts` 的**导出组件**为“当前应有”的清单；内部使用但未导出的组件（如 RightsPicker 仅在 TradeView 内用）是否写入文档由项目约定决定，本技能以导出清单为准做同步。
+- 更新时保持现有 Markdown 格式与标题层级不变；新增小节时与同模块其他组件节的格式一致。
+- 若构建失败，先解决构建问题再执行文档更新。

package/.cursor/skills/appkit-sync-component-rules/SKILL.md

@@ -1,60 +1,60 @@
----
-name: appkit-sync-component-rules
-description: Syncs Appkit组件使用规则.md from appkit to one or more consumer projects' .cursor/rules/appkit.mdc. Use when the user updates the component rules doc and wants to sync to host project(s), or asks to sync appkit rules to portal/other projects.
----
-
-# 同步 Appkit 组件使用规则到宿主项目
-
-在 appkit 仓库中更新 `Appkit组件使用规则.md` 后，将其内容同步到**一个或多个**使用 Appkit 的宿主项目的 Cursor 规则文件，使这些项目内的 AI 使用最新的组件使用说明。
-
-## 工作流程
-
-按顺序执行：
-
-1. **读取源文件**
-   - 从 **当前 workspace 根目录**（appkit 项目根）读取：`Appkit组件使用规则.md`
-   - 若文件不存在，提示用户先创建或从构建流程更新该文档
-
-2. **确定目标项目**
-   - 若用户指定了项目名或路径，按指定目标同步
-   - 若未指定，可询问用户要同步到哪些项目，或按项目约定使用默认列表（见下方路径说明）
-   - 目标路径均为**相对于 appkit 项目根**，每个项目对应一个 `.cursor/rules/appkit.mdc` 文件
-
-3. **准备目标内容**
-   - 使用源文件的完整正文内容
-   - **可选**：若希望该 .mdc 作为 Cursor 规则被识别（不始终注入），可在正文前添加 frontmatter：
-     ```yaml
-     ---
-     alwaysApply: false
-     ---
-     ```
-   - 不添加 frontmatter 则原样同步
-
-4. **写入各目标文件**
-   - 对每个目标项目，将内容写入：`../<项目目录名>/.cursor/rules/appkit.mdc`
-   - 若某项目的 `.cursor/rules` 不存在，需先创建
-   - 写入后确认文件存在且内容与源一致（可简要对比首尾几行）
-
-## 路径说明
-
-| 角色     | 说明 |
-|----------|------|
-| 源文件   | `Appkit组件使用规则.md`（appkit 项目根，即当前 workspace 根） |
-| 目标文件 | 每个宿主项目一个：`../<项目目录名>/.cursor/rules/appkit.mdc`（相对于 appkit 项目根） |
-
-**示例**（appkit 与宿主项目同属同一父目录时）：
-- `../portal-weapp/.cursor/rules/appkit.mdc`
-- `../other-consumer/.cursor/rules/appkit.mdc`
-
-若项目不在 appkit 同级目录，请按实际目录结构写出相对路径或由用户提供目标路径列表。
-
-## 触发方式
-
-- **手动**：用户说「同步 appkit 规则到宿主项目」「把组件规则同步到 portal / xx 项目」「同步到多个项目」等时，执行本技能；可询问或按约定确定同步目标。
-- **自动（随构建/文档更新）**：运行 `appkit-build-update-component-rules` 时，若用户要求「构建并同步到宿主项目」或「更新文档并同步」，在文档更新完成后执行本技能，目标项目由用户指定或按项目约定。
-
-## 注意事项
-
-- 同步为**覆盖写入**，会替换各目标项目中现有的 `appkit.mdc` 内容
-- 建议在「已更新 `Appkit组件使用规则.md`」之后执行本同步（例如在运行 `appkit-build-update-component-rules` 并更新完文档之后）
-- 支持一次同步到多个项目：对每个目标路径执行一次读取源 + 写入目标的流程即可
+---
+name: appkit-sync-component-rules
+description: Syncs Appkit组件使用规则.md from appkit to one or more consumer projects' .cursor/rules/appkit.mdc. Use when the user updates the component rules doc and wants to sync to host project(s), or asks to sync appkit rules to portal/other projects.
+---
+
+# 同步 Appkit 组件使用规则到宿主项目
+
+在 appkit 仓库中更新 `Appkit组件使用规则.md` 后，将其内容同步到**一个或多个**使用 Appkit 的宿主项目的 Cursor 规则文件，使这些项目内的 AI 使用最新的组件使用说明。
+
+## 工作流程
+
+按顺序执行：
+
+1. **读取源文件**
+   - 从 **当前 workspace 根目录**（appkit 项目根）读取：`Appkit组件使用规则.md`
+   - 若文件不存在，提示用户先创建或从构建流程更新该文档
+
+2. **确定目标项目**
+   - 若用户指定了项目名或路径，按指定目标同步
+   - 若未指定，可询问用户要同步到哪些项目，或按项目约定使用默认列表（见下方路径说明）
+   - 目标路径均为**相对于 appkit 项目根**，每个项目对应一个 `.cursor/rules/appkit.mdc` 文件
+
+3. **准备目标内容**
+   - 使用源文件的完整正文内容
+   - **可选**：若希望该 .mdc 作为 Cursor 规则被识别（不始终注入），可在正文前添加 frontmatter：
+     ```yaml
+     ---
+     alwaysApply: false
+     ---
+     ```
+   - 不添加 frontmatter 则原样同步
+
+4. **写入各目标文件**
+   - 对每个目标项目，将内容写入：`../<项目目录名>/.cursor/rules/appkit.mdc`
+   - 若某项目的 `.cursor/rules` 不存在，需先创建
+   - 写入后确认文件存在且内容与源一致（可简要对比首尾几行）
+
+## 路径说明
+
+| 角色     | 说明 |
+|----------|------|
+| 源文件   | `Appkit组件使用规则.md`（appkit 项目根，即当前 workspace 根） |
+| 目标文件 | 每个宿主项目一个：`../<项目目录名>/.cursor/rules/appkit.mdc`（相对于 appkit 项目根） |
+
+**示例**（appkit 与宿主项目同属同一父目录时）：
+- `../portal-weapp/.cursor/rules/appkit.mdc`
+- `../other-consumer/.cursor/rules/appkit.mdc`
+
+若项目不在 appkit 同级目录，请按实际目录结构写出相对路径或由用户提供目标路径列表。
+
+## 触发方式
+
+- **手动**：用户说「同步 appkit 规则到宿主项目」「把组件规则同步到 portal / xx 项目」「同步到多个项目」等时，执行本技能；可询问或按约定确定同步目标。
+- **自动（随构建/文档更新）**：运行 `appkit-build-update-component-rules` 时，若用户要求「构建并同步到宿主项目」或「更新文档并同步」，在文档更新完成后执行本技能，目标项目由用户指定或按项目约定。
+
+## 注意事项
+
+- 同步为**覆盖写入**，会替换各目标项目中现有的 `appkit.mdc` 内容
+- 建议在「已更新 `Appkit组件使用规则.md`」之后执行本同步（例如在运行 `appkit-build-update-component-rules` 并更新完文档之后）
+- 支持一次同步到多个项目：对每个目标路径执行一次读取源 + 写入目标的流程即可

package/.eslintrc.mjs

@@ -1,8 +1,8 @@
-module.exports = {
-  extends: [
-    './.eslintrc-auto-import.json'
-  ],
-  rules: {
-    ident: ['error', 2]
-  }
+module.exports = {
+  extends: [
+    './.eslintrc-auto-import.json'
+  ],
+  rules: {
+    ident: ['error', 2]
+  }
 }