@qilitt-mickey/vue3-temp-skill 1.1.19 → 1.1.21

package/README.md

@@ -8,6 +8,7 @@ Vue 3 企业级中后台项目开发规范技能包 — 按团队规范生成代
 
 - **始终加载** `core-kernel`
 - **按需** `project-inventory`（addon / 查 Re* / 装依赖）
+- **精简模板启用 addon** `addon-enable`（装包后逐文件恢复配置，非自动）
 - **生成后闸门** `code-quality`：清单 + `pnpm lint:fix` + `pnpm type-check` + 结果块
 - 复用仓库已有封装；选型表指定库勿擅自替换；addon 精确版本见 inventory 第九节
 
@@ -31,7 +32,7 @@ Vue 3 企业级中后台项目开发规范技能包 — 按团队规范生成代
 |------|------|
 | 始终 | core-kernel |
 | 闸门 | code-quality |
-| 按需资产 | project-inventory |
+| 按需资产 | project-inventory、**addon-enable** |
 | 标准业务 | http-api、crud-pages、detail-page、data-writeback、permission-auth、layout-theme、design-system、design-handoff、icons、feedback-loading、base-code-dict、api-check、ui-components |
 | 专项 | form-advanced、table-vxe、tree-table、chart-echarts、file-management、download-export、rich-text、graph-relation、workflow-bpmn、flowchart-g6、data-mapping、websocket-realtime、mobile-h5、wechat-js、verify-captcha、qrcode-barcode、feedback-ui、seamless-scroll、particles、data-compare、data-screen、directives-advanced |
 
@@ -52,11 +53,23 @@ npx @qilitt-mickey/vue3-temp-skill@latest install all
 ## 生成工作流（AI）
 
 1. 解析需求 → 命中功能模块  
-2. 读 `core-kernel` + 命中模块；addon 时加读 inventory；设计交接块时加读 `design-handoff`  
-3. 缺包按 inventory 第九节精确版本，确认后安装  
+2. 读 `core-kernel` + 命中模块；addon 时加读 inventory + **`addon-enable`**；设计交接块时加读 `design-handoff`  
+3. 缺包按 inventory 第九节精确版本，确认后安装；**再按 `addon-enable` 逐文件恢复配置**  
 4. 复用仓库 Re*/Hook/utils；按模块示例生成落盘  
 5. 执行 `code-quality` → 输出审查结果块 + 变更说明  
 
 ## 与模版的关系
 
-本 Skill 约定对齐 **vue3-web-temp** 脚手架；使用者在各自业务仓库中开发，不绑定某一固定本机目录。壳层以当前项目源码为准，规范以本包 `references/` 为准。
+本 Skill 约定对齐 **vue3-web-temp** 精简脚手架：
+
+| 文档 | 读者 | 内容 |
+|------|------|------|
+| 模板 `README.md` | 人类开发者 | 安装、配置、命令、与 AI 协同入口 |
+| 模板 `AGENTS.md` | AI 助手 | 仓库事实、硬性约定摘要、Skill 路由 |
+| 本包 `references/` | AI + 开发者 | **标准样板**、专项细则、addon 安装表 |
+| 本包 `addon-enable.md` | AI + 开发者 | **出厂已删依赖的逐文件恢复代码** |
+
+- 模板仓库：布局壳 + core 依赖 + `Re*` 源码（addon 组件默认不参与类型检查直至安装依赖）
+- **标准样板**：在本包 `references/`，不在模板 `views/`
+- 壳层以当前项目源码为准；规范与安装表以本包为准
+- HTTP：`axios@1.19.0` 固定版本，仅经 `@/utils/http`

package/SKILL.md

@@ -25,7 +25,10 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 ## 模版约定
 
 - 面向由 **vue3-web-temp** 脚手架搭出的业务项目（目录名/安装路径因人而异，以当前工作区为准）
-- 业务写法以本包 `references/` 为准；壳层行为（顶部 tag / 侧栏 / keep-alive / `useDetail`）以**当前项目**已有实现为准
+- **文档分工**：人类读模板 `README.md`；AI 读模板 `AGENTS.md` + 本 Skill；样板与细则在本包 `references/`
+- **精简出厂**：模板 `views/` 仅保留登录/首页等壳页面；**业务标准样板**在本包 `references/`（如 `crud-pages`、`detail-page`）
+- **依赖分层**：`package.json` 仅 **core**；**addon** 默认不装；缺包时装依赖后须按 `addon-enable.md` **逐文件恢复配置**（非自动）
+- 壳层行为（顶部 tag / 侧栏 / keep-alive / `useDetail`）以**当前项目**已有实现为准
 - **双轨**：无设计 handoff → 保持模版出厂；有设计落地 → 读 `design-handoff.md` **原子步骤**（`Theme`/`Version`/令牌整组，禁止只改主色）
 
 ## 使用方式
@@ -41,7 +44,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 3. 按命中模块内**标准样板**整段编写（禁止只抄 API 签名、丢掉 meta/配套段落）
 4. 无对应能力 → 标注「待确认」，未经同意不引入新依赖
 5. 权威性优先级：`仓库已有封装` > `本 Skill 示例` > 通用 Vue 习惯
-6. 命中 addon / 缺依赖时再读 `project-inventory.md` 第九节；精确版本安装，禁止 `@latest`
+6. 命中 addon / 缺依赖：读 `project-inventory` 第九/十节 + **`addon-enable.md`**（逐文件恢复代码）；精确版本安装，禁止 `@latest`
 
 ## 完整性守则（全模块强制）
 
@@ -65,6 +68,7 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 | 时机 | 文件 |
 |------|------|
 | addon / 查 Re* 名 / 装依赖 | `references/project-inventory.md` |
+| **启用精简模板已删的 addon（装包 + 改配置）** | `references/addon-enable.md`（与功能模块同读） |
 | 写完代码后（闸门，非功能命中） | `references/code-quality.md` |
 | 设计交接块 / **design-handoff/v1 JSON** / 上游令牌产出落地 | `references/design-handoff.md`（+ `design-system`） |
 
@@ -117,8 +121,9 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 1. 单模块 → 该模块 + `core-kernel`；结束后执行 `code-quality`
 2. 多模块 → 同时加载（例：客户列表 = `crud-pages` + `permission-auth` + `http-api`）
 3. 未命中模块 → 仅 `core-kernel`，向用户确认是否专项
-4. 默认不改 `vite.config.ts` / `build/**`
+4. 默认不改 `vite.config.ts` / `build/**`；**例外**：按 `addon-enable.md` 恢复 FileViewer / VantResolver / Vconsole 等占位插件时允许改 `build/plugins/*`
 5. 效果匹配：
+   - 启用 echarts / vant / file-viewer / 富文本等已删 addon → 功能模块 + **`addon-enable`**
    - 弹窗 → `form-advanced`
    - 点一下复制 → `directives-advanced`（`v-copy`）
    - 标题字跟着宽度变小 → `directives-advanced`（`v-auto-font`）
@@ -142,22 +147,22 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 ## 工作流
 
 1. **需求分析**：列出功能模块 ID（不含 `code-quality`）
-2. **加载**：`core-kernel` + 命中模块；addon 时加读 `project-inventory`；设计规范/交接产出时加读 `design-handoff` 并执行 design-system Step 0（与业务的先后按需求）
-3. **依赖**：缺包按 inventory 第九节精确版本，确认后再装
+2. **加载**：`core-kernel` + 命中模块；addon/缺包时加读 `project-inventory` + **`addon-enable`**；设计规范/交接产出时加读 `design-handoff`
+3. **依赖**：缺包按 inventory 第九节精确版本，确认后安装；**再按 `addon-enable` 对应章节改配置**
 4. **探查**：复用仓库 `Re*` / Hook / utils
 5. **生成**：可运行代码落盘
-6. **code-quality**：按 `references/code-quality.md` 执行（重读清单 → 对照改动 → `pnpm lint:fix` + `pnpm type-check` → 修正 → 结果块）
-7. **输出**：变更说明 + 待确认项
+6. **code-quality**：按 `references/code-quality.md` 执行
+7. **输出**：变更说明（含已改配置文件列表）+ 待确认项
 
 ### 最终回复结构
 
 ```markdown
 ## 命中模块
-- <功能模块…>
+- <功能模块…>（缺包时含 addon-enable）
 
 ## 代码质量审查
 - 闸门：已执行 code-quality（生成后）
-- 清单：选型 / 类型 / 组件 / API / 安全 / 业务 / 列表→详情(如适用) / 列表布局(如适用) / 风格 → 通过 | 已修正：…
+- 清单：选型 / 类型 / 组件 / API / 安全 / 业务 / 列表→详情(如适用) / 列表布局(如适用) / 风格 / addon启用(如适用) → 通过 | 已修正：…
 - 硬失败：无 | 已拦截并修正：…
 - 命令：`pnpm lint:fix` → …；`pnpm type-check` → …
 - 待确认：…
@@ -168,4 +173,4 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 ## 文件索引
 
-`references/<模块名>.md` 与路由表 ID 一一对应。依赖安装见 `project-inventory.md` 第九节。
+`references/<模块名>.md` 与路由表 ID 一一对应。依赖安装见 `project-inventory.md` 第九节；**精简模板配置恢复见 `addon-enable.md`**。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.1.19",
+  "version": "1.1.21",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — core-kernel 架构、按需功能模块",
   "bin": {
     "vue3-temp-skill": "./bin/cli.js"

package/references/addon-enable.md

@@ -0,0 +1,418 @@
+---
+skill: addon-enable
+description: 精简模板 addon 启用手册。记录出厂删除的依赖及须恢复的每一处代码/配置；命中 chart/vant/file-viewer 等 addon 或装依赖时必读。
+scope: project
+tags: [addon, enable, restore, tsconfig, vant, echarts, file-viewer, slim-template]
+---
+
+# 精简模板 addon 启用手册（代码级恢复）
+
+> **读者**：AI 与开发者。  
+> **何时读**：`package.json` 缺某 addon，且业务要启用该能力时（与功能模块、`project-inventory` 第九/十节同读）。  
+> **原则**：`pnpm add` **不会**自动改配置；须按本节**逐文件落盘**。禁止 `@latest`。版本以 inventory 为准。
+
+## 总流程
+
+1. 查 `package.json` → 列缺失包  
+2. 展示精确版本命令 → **用户确认**  
+3. `pnpm add` / `pnpm add -D`  
+4. 按对应章节改 `tsconfig` / `build` / `src`  
+5. `pnpm type-check`  
+6. 再写业务代码 / 引用 `Re*`
+
+未完成第 4 步就引用组件 → 视为未通过。
+
+---
+
+## A. 通用：`tsconfig.json` exclude
+
+启用时**只删用到的行**（保留 `__tests__` / `node_modules` / `dist` / `**/*.js`）：
+
+```json
+"src/components/ReEchart/**",
+"src/components/ReRichText/**",
+"src/components/ReFileViewer/**",
+"src/components/ReCheckCard/**",
+"src/components/ReQrcode/**",
+"src/components/ReBarcode/**",
+"src/components/ReTypeit/**",
+"src/components/ReVerify/**",
+"src/components/ReSelectVant/**",
+"src/components/RePopupPicker/**",
+"src/utils/wechat/**",
+"src/hooks/useWechat.ts",
+"src/api/wechat/**",
+"src/utils/vantRules.ts",
+"types/file-viewer.d.ts"
+```
+
+---
+
+## B. chart-echarts
+
+```bash
+pnpm add echarts@6.1.0
+# 词云：
+pnpm add echarts-wordcloud@2.1.0
+```
+
+| 文件 | 动作 |
+|------|------|
+| `tsconfig.json` | 删 exclude：`src/components/ReEchart/**` |
+| `build/optimize.ts` | 建议 `include` 追加： |
+
+```ts
+'echarts/core',
+'echarts/charts',
+'echarts/components',
+'echarts/features',
+'echarts/renderers',
+```
+
+```ts
+import { ReEchart } from '@/components/ReEchart'
+```
+
+组件源码已在 `src/components/ReEchart/`。业务样板见 `chart-echarts.md`。
+
+---
+
+## C. rich-text
+
+```bash
+pnpm add @wangeditor/editor@5.1.23
+```
+
+| 文件 | 动作 |
+|------|------|
+| `tsconfig.json` | 删：`src/components/ReRichText/**` |
+| `build/optimize.ts` | 可选：`'@wangeditor/editor'` |
+
+```ts
+import ReRichText from '@/components/ReRichText'
+```
+
+样板见 `rich-text.md`。
+
+---
+
+## D. file-management
+
+```bash
+pnpm add @file-viewer/core@2.1.14 @file-viewer/vue3@2.1.14 @file-viewer/preset-all@2.1.14 browser-image-compression@2.0.2
+pnpm add -D @file-viewer/vite-plugin@2.1.14
+```
+
+### D1. `tsconfig.json`
+
+删：`src/components/ReFileViewer/**`、`types/file-viewer.d.ts`
+
+### D2. `build/plugins/FileViewer.ts`（替换占位 `return []`）
+
+```ts
+import { fileViewerRenderers } from '@file-viewer/vite-plugin'
+
+/**
+ * @file-viewer/vite-plugin 封装（2.1.14）
+ * preset-all；renderer 分包见 build/chunks.ts
+ */
+export function FileViewerPlugin() {
+  return fileViewerRenderers({
+    preset: 'all',
+    autoPresets: false,
+    inject: false,
+    scan: false,
+    copyAssets: true,
+    chunkStrategy: 'none',
+  })
+}
+```
+
+`build/plugins/index.ts` 已有 `FileViewerPlugin()`，一般不用改。
+
+### D3. `types/env.d.ts` — 在 `declare module 'js-md5'` 后增加
+
+```ts
+declare module 'virtual:file-viewer-renderers' {
+  import type { FileViewerRendererPlugin } from '@file-viewer/core'
+  export const configuredFileViewerRenderers: FileViewerRendererPlugin[]
+  const renderers: FileViewerRendererPlugin[]
+  export default renderers
+}
+```
+
+### D4. 图片压缩
+
+`src/utils/imageCompression.ts` 已支持未装包时 Canvas 降级；装 `browser-image-compression` 后动态加载，**通常无需改该文件**。
+
+```ts
+import { ReFileViewer } from '@/components/ReFileViewer'
+```
+
+样板见 `file-management.md`。
+
+---
+
+## E. form-advanced（ReCheckCard）
+
+```bash
+pnpm add plus-pro-components@0.1.31
+# 常一起：
+pnpm add address-parse@1.2.19
+```
+
+| 文件 | 动作 |
+|------|------|
+| `tsconfig.json` | 删：`src/components/ReCheckCard/**`（`address-parse` 无 exclude） |
+
+```ts
+import { ReCheckCard } from '@/components/ReCheckCard'
+```
+
+---
+
+## F. qrcode-barcode
+
+```bash
+pnpm add qrcode@1.5.4 jsbarcode@3.12.3
+pnpm add -D @types/qrcode@1.5.6
+```
+
+| 文件 | 动作 |
+|------|------|
+| `tsconfig.json` | 删：`ReQrcode/**`、`ReBarcode/**` |
+| `build/optimize.ts` | 可选：`'qrcode'`、`'jsbarcode'` |
+
+```ts
+import { ReQrcode } from '@/components/ReQrcode'
+import { ReBarcode } from '@/components/ReBarcode'
+```
+
+---
+
+## G. feedback-ui（ReTypeit）
+
+```bash
+pnpm add typeit@8.8.7
+```
+
+| 文件 | 动作 |
+|------|------|
+| `tsconfig.json` | 删：`src/components/ReTypeit/**` |
+| `build/optimize.ts` | 可选：`'typeit'` |
+
+```ts
+import { ReTypeit } from '@/components/ReTypeit'
+```
+
+---
+
+## H. verify-captcha（ReVerify）
+
+```bash
+pnpm add vue3-puzzle-vcode@1.1.7
+```
+
+| 文件 | 动作 |
+|------|------|
+| `tsconfig.json` | 删：`src/components/ReVerify/**` |
+
+`ReDragVerify` / `ReImageVerify` / `ReSmsCode` 自研，无需此包。
+
+```ts
+import { ReVerify } from '@/components/ReVerify'
+```
+
+---
+
+## I. wechat-js
+
+```bash
+pnpm add weixin-js-sdk@1.6.5
+```
+
+| 文件 | 动作 |
+|------|------|
+| `tsconfig.json` | 删：`src/utils/wechat/**`、`src/hooks/useWechat.ts`、`src/api/wechat/**` |
+
+```ts
+import { useWechat } from '@/hooks/useWechat'
+```
+
+源码已在仓库。样板见 `wechat-js.md`。
+
+---
+
+## J. mobile-h5（Vant）— 改动最多
+
+完整步骤与片段亦见 **`mobile-h5.md`「精简模板启用清单」**；本节为权威代码副本。
+
+```bash
+pnpm add vant@4.10.0 vconsole@3.15.1
+pnpm add -D @vant/auto-import-resolver@1.3.0 vite-plugin-vconsole@2.1.1
+```
+
+### J1. `tsconfig.json`
+
+删：`ReSelectVant/**`、`RePopupPicker/**`、`src/utils/vantRules.ts`
+
+### J2. `src/main.ts` — Element Plus 样式后追加
+
+```ts
+import 'vant/lib/index.css'
+import 'vant/es/toast/style'
+import 'vant/es/dialog/style'
+import 'vant/es/notify/style'
+import 'vant/es/image-preview/style'
+```
+
+### J3. `src/locales/index.ts` — 整文件恢复为
+
+```ts
+import elenLocale from 'element-plus/es/locale/lang/en'
+import elzhLocale from 'element-plus/es/locale/lang/zh-cn'
+import venLocale from 'vant/es/locale/lang/en-US'
+import vzhLocale from 'vant/es/locale/lang/zh-CN'
+import { createI18n } from 'vue-i18n'
+import { getLanguage } from '@/utils/i18n'
+import enLocale from './en-US.json'
+import zhLocale from './zh-Cn.json'
+
+const messages = {
+  en: {
+    ...elenLocale,
+    ...venLocale,
+    ...enLocale,
+  },
+  zh: {
+    ...elzhLocale,
+    ...vzhLocale,
+    ...zhLocale,
+  },
+}
+
+export const i18n = createI18n({
+  legacy: false,
+  locale: getLanguage(),
+  fallbackLocale: 'zh',
+  messages,
+  globalInjection: true,
+})
+
+export const $t: typeof i18n.global.t = i18n.global.t
+export default i18n
+```
+
+### J4. `src/styles/index.scss`
+
+`src/styles/vant.scss` 已存在。在 `@use 'dark';` 后加：
+
+```scss
+@use 'vant';
+```
+
+### J5. `build/plugins/AutoImportComponents.ts` — 整文件
+
+```ts
+import type { Plugin } from 'vite'
+import { VantResolver } from '@vant/auto-import-resolver'
+import AutoImport from 'unplugin-auto-import/vite'
+import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
+import Components from 'unplugin-vue-components/vite'
+
+export function AutoComponentsPlugin(): Plugin[] {
+  const plugins: Plugin[] = []
+
+  const autoImportPlugin = AutoImport({
+    resolvers: [ElementPlusResolver({ importStyle: false }), VantResolver()],
+    include: [/\.[tj]sx?$/, /\.vue$/, /\.vue?$/],
+    dts: './types/auto-imports.d.ts',
+    imports: [
+      'vue',
+      'vue-router',
+      'pinia',
+      '@vueuse/core',
+      { axios: [['default', 'axios']] },
+    ],
+    eslintrc: { enabled: false },
+  })
+  plugins.push(...(Array.isArray(autoImportPlugin) ? autoImportPlugin : [autoImportPlugin]))
+
+  const componentsPlugin = Components({
+    resolvers: [ElementPlusResolver({ importStyle: false }), VantResolver()],
+    dts: './types/components.d.ts',
+  })
+  plugins.push(...(Array.isArray(componentsPlugin) ? componentsPlugin : [componentsPlugin]))
+
+  return plugins
+}
+```
+
+### J6. `build/plugins/Vconsole.ts` — 替换占位
+
+```ts
+import path from 'node:path'
+import { viteVConsole } from 'vite-plugin-vconsole'
+
+export function createViteVConsole() {
+  return viteVConsole({
+    entry: [path.resolve('src/main.ts')],
+    enabled: true,
+    config: {
+      maxLogNumber: 1000,
+      theme: 'light',
+    },
+  })
+}
+```
+
+`build/plugins/index.ts` 已有 `VITE_VCONSOLE` 开关，一般不用改。`.env.development`：`VITE_VCONSOLE = true`。
+
+### J7. `build/optimize.ts` — include 追加
+
+```ts
+'vant/es',
+'vant/es/locale/lang/zh-CN',
+'vant/es/locale/lang/en-US',
+```
+
+### J8. 业务资产
+
+| 资产 | 路径 |
+|------|------|
+| `ReSelectVant` | `src/components/ReSelectVant` |
+| `RePopupPicker` | `src/components/RePopupPicker` |
+| `vantRules` | `src/utils/vantRules.ts` |
+| 移动路由 | `src/router/mobileModules/**` |
+
+页面样板见 `mobile-h5.md`。
+
+---
+
+## K. 出厂未装、无 exclude 的 addon
+
+通常**只装包 + 业务代码**（见各模块 md / inventory 第九节）：
+
+| 模块 | 命令摘要 |
+|------|----------|
+| `table-vxe` | `vxe-table@4.19.21` `vxe-pc-ui@4.15.19` |
+| `graph-relation` | `relation-graph-vue3@2.2.11` |
+| `workflow-bpmn` | `bpmn-js@18.19.0` |
+| `flowchart-g6` | `@antv/g6@5.1.1` `g6-extension-vue@0.1.0` |
+| `data-mapping` | `jsplumb@2.15.6` |
+| `data-screen` | `grid-layout-plus@1.1.1` |
+| `particles` | `@tsparticles/slim@4.3.1` `@tsparticles/vue3@4.3.1` + `main.ts` 注册（见 `particles.md`） |
+
+---
+
+## L. AI 变更说明模板
+
+```text
+已启用 <模块>：
+- 安装：…
+- tsconfig exclude 已移除：…
+- 已改文件：…
+- type-check：通过 | 失败原因
+```
+
+装了包却仍 exclude 对应路径 → `code-quality` **硬失败**。

package/references/chart-echarts.md

@@ -17,6 +17,8 @@ tags: [echarts, ReEchart, chart, wordcloud]
 | `echarts` | `6.1.0` | 图表必装 |
 | `echarts-wordcloud` | `2.1.0` | 仅词云 |
 
+安装后从 `tsconfig.json` 的 `exclude` 移除 `src/components/ReEchart/**`，并按 **`addon-enable.md` 章节 B** 完成配置恢复，再引用 `ReEchart`。
+
 ```bash
 pnpm add echarts@6.1.0
 # 词云时追加：

package/references/code-quality.md

@@ -45,12 +45,13 @@ lint / type-check **过了也不能放过**下列项。发现即改代码，禁
 | 按钮权限需求 | 裸 `v-if` 角色判断，未用 `v-auth`/`ReAuth` | `permission-auth` |
 | 新菜单路由 | 父级无 `icon` 或业务页二次挂 `Layout` | `icons` + `core-kernel` |
 | 列表查询区 `el-form` / 查询按钮 | 写了 `size="small"`（紧凑主题用户未要求） | 不写 size，用 default=`--control-height` |
+| 本轮新增 addon 并引用对应 `Re*` / Vant / 微信 | 已装包但 `tsconfig exclude` 仍含该路径，或 `addon-enable` 要求的 build/src 未改 | 按 **`addon-enable.md`** 对应章节恢复后重跑 type-check |
 
 ## 选型与硬约束
 
-- [ ] 已读 `core-kernel`；addon/缺依赖时已读 `project-inventory`
+- [ ] 已读 `core-kernel`；addon/缺依赖时已读 `project-inventory` + **`addon-enable`**
 - [ ] 复用已有 Re* / Hook / utils；选型库未擅自替换；新依赖已待确认
-- [ ] addon 缺包按 inventory 第九节精确版本（禁止 `@latest`）
+- [ ] addon 缺包按 inventory 第九节精确版本（禁止 `@latest`）；装包后已按 **`addon-enable`** 恢复配置与 `tsconfig exclude`
 - [ ] 列表方法名 `onSearch` / `reset`；HTTP 用 `@/utils/http` + `Result<T>`
 - [ ] 业务路由未二次挂 Layout
 - [ ] 独立详情：对照路由文件确认 `showLink:false` + `activePath` + `keepAlive`/`moreTags`（默认）+ `toDetail` + `initToDetail`

package/references/core-kernel.md

@@ -125,13 +125,25 @@ export function getCustomerList(data: CustomerQuery, url: string) {
 
 ### 独立功能页容器
 
-定高且内部滚动（与列表卡同类场景）——优先 `el-card.vts-page-card`；非 Card 根节点用 `vts-page-fill`：
+页面容器分两类，**禁止混用**：
+
+| 场景 | 根节点 | 滚动落点 |
+|------|--------|----------|
+| 查询列表 | `el-card.vts-page-card` | 仅表格体内（`tableHeight`） |
+| 长表单 / 详情 / 说明 | `bg-bg_color p-5` + `min-height: 100%` | `.app-main` 内 `el-scrollbar` |
+| 定高画布（地图 / 流程图 / 大屏） | `vts-page-fill` + `h-full` + `overflow-hidden` | **页面内部**自管滚动 |
 
 ```vue
+<!-- ✅ 详情 / 长表单（默认） -->
+<div class="bg-bg_color p-5" :style="{ minHeight: '100%' }">
+
+<!-- ✅ 定高画布（仅地图/流程图/大屏等） -->
 <div class="vts-page-fill h-full pos-relative bg-bg_color p-5 overflow-hidden">
+
+<!-- ❌ 详情页禁止 vts-page-fill / h-full / overflow-hidden（会裁切且外层滚不动） -->
 ```
 
-查询列表定高卡 → `crud-pages`（`el-card.vts-page-card` + `tableHeight`，禁止 `100vh` 减顶栏定高）。
+查询列表定高卡 → `crud-pages`；详情容器与三件套 → `detail-page`。
 ## 六、资产分层
 
 附加 Hook/组件按功能模块加载（WebSocket、微信、附件、图表等）→ 见各专项与 `project-inventory`。
@@ -142,7 +154,8 @@ export function getCustomerList(data: CustomerQuery, url: string) {
 |----|------|
 | 包管理 | pnpm；`dev` / `build` / `type-check` / `lint` / `lint:fix` |
 | 默认插件 | Vue/JSX、AutoImport、SVG、UnoCSS、Mock、Gzip 等 |
-| addon | FileViewer → `file-management`；vConsole → `mobile-h5`；安装见 inventory 第九节 |
+| addon 构建 | FileViewer / vConsole 等在精简模板中为占位；安装后按对应模块恢复 `build/plugins/*` |
+| addon 类型检查 | 未装 addon 时相关路径在 `tsconfig exclude`；**装包后须手动移除**对应项 → 见 `project-inventory` **第十节**（非自动） |
 
 非用户要求不改 `vite.config.ts` / `build/**`。
 

package/references/crud-pages.md

@@ -31,11 +31,11 @@ useTableSearch(formQuery, searchFn, url)
 |------|------|
 | 查询列表（定高） | `el-card.vts-page-card`（禁止 `100vh` 减顶栏定高）；表格绑 `tableHeight`；仅表格体内滚动；分页在表格下方；整页无外层滚动条 |
 | 树 + 表分栏 | 同上；左侧树、右侧表共用定高卡，高度仍走 `useTableSearch` 几何实测 |
-| 长表单 / 详情 / 说明类 | 根节点 `min-height: 100%`（或 `:style="{ minHeight: '100%' }"`）；超出由 `.app-main` 内 `el-scrollbar` 滚动 |
-| 非 Card 整页填满 | 根节点加 `class="vts-page-fill"` + `height: 100%` / `h-full` |
+| 长表单 / 详情 / 说明类 | 根节点 `min-height: 100%`（或 `:style="{ minHeight: '100%' }"`）；**禁止** `vts-page-fill` / `h-full` / `overflow-hidden`；超出由 `.app-main` 内 `el-scrollbar` 滚动 |
+| 非 Card 整页填满（地图/流程图/大屏） | 根节点加 `class="vts-page-fill"` + `height: 100%` / `h-full`；**仅此类定高场景** |
 | Card 内边距 | 一律走 `--vts-card-padding`（桥接 `--card-padding`）；换规范 / `--vts-margin` 变化由壳层 flex 链 + Hook 自动跟随 |
 
-> **壳层原理**（`lay-content`）：`.main-content` 用 `padding: var(--vts-margin)`（不用 margin）；定高页 `.main-content:has(.vts-page-card)` / `.vts-page-fill` 为 `height: 100%`；`.vts-page-card` 填满。`html/body/#app/.app-wrapper/.main-container/.app-main` 均为 `height:100%; overflow:hidden`。禁止业务页 `100vh` 减顶栏定高。
+> **壳层原理**（`lay-content`）：`.main-content` 用 `padding: var(--vts-margin)`（不用 margin）；默认可滚动页 `el-scrollbar__view` / `.grow` 为 `min-height:100%; height:auto`；定高页 `.main-content:has(.vts-page-card|.vts-page-fill)` 为 `height: 100%` 并收回祖先链；`.vts-page-card` 填满。`html/body/#app/.app-wrapper/.main-container/.app-main` 均为 `height:100%; overflow:hidden`。禁止业务页 `100vh` 减顶栏定高。
 
 ## 列表标准样板（唯一完整示例）
 
@@ -377,6 +377,7 @@ async function onSubmit() {
 | 额外模块不绑 `otherRef` | L8 |
 | 只写 `toDetail`、详情路由缺 `activePath` | 三件套整段落盘（见 detail-page） |
 | 裸 `router.push` 开详情 | `toDetail` + meta（见 detail-page） |
+| 详情根节点 `vts-page-fill` / `h-full` / `overflow-hidden` | `min-height: 100%` + `bg-bg_color`；滚动交给壳层 `el-scrollbar`（见 detail-page ④） |
 | `ReTableOperate :buttons` | `:list` |
 | 操作列手写多颗 `el-button` / 自造更多菜单 | `ReTableOperate`；过多靠 `limit`（默认 3）进「更多」 |
 | `@show-collapse` | `@should-show-collapse` |

package/references/detail-page.md

@@ -58,6 +58,31 @@ const { id, mark } = getParameter as DetailParameter;
 </script>
 ```
 
+### ④ 详情页容器（滚动约定）
+
+详情 / 编辑 / 查看页是**长内容页**，滚动交给壳层 `.app-main` 内 `el-scrollbar`。**禁止**根节点使用 `vts-page-fill` / `h-full` / `overflow-hidden`（那是定高画布专用）。
+
+```vue
+<template>
+  <div
+    v-loading.lock="pageLoading"
+    class="bg-bg_color p-5"
+    :style="{ minHeight: '100%' }"
+  >
+    <ReHeaderPage />
+    <!-- 表单 / 描述 / 版本记录等 -->
+  </div>
+</template>
+```
+
+| 禁止 | 原因 |
+|------|------|
+| `class="vts-page-fill"` | 触发定高链，内容被裁切、外层滚不动 |
+| `h-full` + `overflow-hidden` | 把超出内容锁死在视口内 |
+| `el-card.vts-page-card` 包整页长表单 | 列表定高卡专用；详情走外层滚动 |
+
+完整布局原理见 `layout-theme`「内容区高度与滚动」；列表页见 `crud-pages`。
+
 ## 概念
 
 | 能力 | 字段 / API | 谁负责 |
@@ -91,3 +116,4 @@ toDetail(name, parameter, title?, model = "query") // model: "query" | "params"
 2. `showLink: false` + `activePath` + 非空 `title` + 默认 `keepAlive`/`moreTags`
 3. 列表只用 `toDetail`，禁止裸 `router.push`
 4. 详情页必调 `initToDetail`；`name` 对齐；参数用 `getParameter`
+5. 详情根容器：`min-height: 100%` + `bg-bg_color`；**禁止** `vts-page-fill` / `h-full` / `overflow-hidden`

package/references/feedback-ui.md

@@ -16,6 +16,8 @@
 pnpm add typeit@8.8.7
 ```
 
+装包后按 **`addon-enable.md` 章节 G** 移除 `ReTypeit/**` exclude。
+
 ## ReNoticeBar 通知栏
 
 ```vue

package/references/file-management.md

@@ -18,7 +18,7 @@ pnpm add @file-viewer/core@2.1.14 @file-viewer/vue3@2.1.14 @file-viewer/preset-a
 pnpm add -D @file-viewer/vite-plugin@2.1.14
 ```
 
-先查 `package.json`；完整模板通常已装齐。缺插件接线时恢复 `build/plugins/FileViewer.ts`，勿擅自改 Vite 主配置。三件套必须同版本。
+先查 `package.json`；**精简模板默认未装**。装包后按 **`addon-enable.md` 章节 D** 恢复：`tsconfig exclude`、`build/plugins/FileViewer.ts`、`types/env.d.ts` 虚拟模块。三件套必须同版本。
 
 ## ReAttachment 附件管理
 

package/references/form-advanced.md

@@ -25,6 +25,8 @@ tags: [form, dialog, ReDialog, ReDialogResize, ReSelectQuery, ReCascader, iconPi
 pnpm add address-parse@1.2.19 plus-pro-components@0.1.31
 ```
 
+使用 `ReCheckCard` 时按 **`addon-enable.md` 章节 E** 移除 `tsconfig exclude` 中 `ReCheckCard/**`。`address-parse` 无 exclude。
+
 `ReDialog` / `ReDialogResize` / `ReSelectQuery` / `ReCascader` / `ReIconPicker` / `ReAnchor` 为项目封装，**无额外 npm 包**。
 
 ## ReSelectQuery（远程搜索下拉）

package/references/layout-theme.md

@@ -367,8 +367,8 @@ $sideBarWidth: var(--sidebar-width, 208px);
 |------|-------------|----------|
 | 查询列表 | `el-card.vts-page-card`（无 inline `100vh`）；表格绑 `useTableSearch().tableHeight` | 仅 `el-table` 体内；分页在表格下方 |
 | 树 + 表分栏 | 同上定高卡；左右并排，高度走 Hook 几何实测 | 同查询列表 |
-| 非 Card 整页填满 | 根节点 `class="vts-page-fill"` + `height: 100%` / `h-full` | 内部区域自管滚动 |
-| 长表单 / 详情 / 说明 | `min-height: 100%`；不绑 `tableHeight` | `.app-main` 内 `el-scrollbar` |
+| 非 Card 整页填满 | 根节点 `class="vts-page-fill"` + `height: 100%` / `h-full` | 内部区域自管滚动；**仅地图/流程图/大屏** |
+| 长表单 / 详情 / 说明 | `min-height: 100%`；**禁止** `vts-page-fill` / `h-full` / `overflow-hidden`；不绑 `tableHeight` | `.app-main` 内 `el-scrollbar` |
 | Card 内边距 | `--vts-card-padding` → `--card-padding` | 换规范 / `--vts-margin` 只改令牌；列表高度由壳层 + Hook 跟随 |
 
 `.vts-page-card`：flex 填满 `.main-content:has(.vts-page-card)`，`overflow: hidden`，`.el-card__body` 高度 100%。样式在 `element-plus.scss` + `lay-content`。

package/references/mobile-h5.md

@@ -7,9 +7,9 @@ tags: [vue3, mobile, h5, vant, wechat, miniprogram, responsive, touch]
 
 # 移动端 H5 与微信开发规范
 
-> 按本模块与 `wechat-js` 示例编写。
-> **构建附属**：`VITE_VCONSOLE` → `build/plugins/Vconsole.ts`。  
-> 微信 JS-SDK 细节优先加载 **`wechat-js`**；本模块侧重 Vant 页面与移动路由。
+> 按本模块与 `wechat-js` 示例编写。  
+> 微信 JS-SDK 细节优先加载 **`wechat-js`**；本模块侧重 Vant 页面与移动路由。  
+> **精简模板（vue3-web-temp）出厂未装 Vant**：仅 `pnpm add` **不够**，须按下方「启用清单」改配置；**不会自动恢复**，须 AI/人工按本文件逐步落盘。
 
 ## 依赖（缺则先装）
 
@@ -25,7 +25,129 @@ pnpm add vant@4.10.0 vconsole@3.15.1
 pnpm add -D @vant/auto-import-resolver@1.3.0 vite-plugin-vconsole@2.1.1
 ```
 
-核对 AutoImport 中 Vant resolver 与 `build/plugins/Vconsole.ts` 是否仍在；模板已接线则勿改 Vite。微信能力另装 `weixin-js-sdk@1.6.5`（见 wechat-js）。
+微信能力另装 `weixin-js-sdk@1.6.5`（见 `wechat-js`）。装包后**必须**继续执行下一节启用清单；完整代码副本亦见 **`addon-enable.md` 章节 J**。
+
+---
+
+## 精简模板启用清单（Vant 恢复）
+
+> **是否自动？** 否。`pnpm add` 不会改 `main.ts` / `tsconfig` / 插件。  
+> **Skill 能否恢复？** 能：AI 命中 `mobile-h5` 后须按本清单**逐文件改回**（用户确认装包后执行），再写业务页。  
+> 完成后跑 `pnpm type-check`。
+
+### 0. 依赖（见上）
+
+用户确认后执行安装命令。
+
+### 1. `tsconfig.json` — 移除 exclude
+
+删除下列行（勿删整个 `exclude`）：
+
+```json
+"src/components/ReSelectVant/**",
+"src/components/RePopupPicker/**",
+"src/utils/vantRules.ts"
+```
+
+若同时启用微信，再删：`src/utils/wechat/**`、`src/hooks/useWechat.ts`、`src/api/wechat/**`（见 `wechat-js` / inventory 第十节）。
+
+### 2. `src/main.ts` — 引入 Vant 样式
+
+在 Element Plus 样式之后增加：
+
+```ts
+import 'vant/lib/index.css'
+import 'vant/es/toast/style'
+import 'vant/es/dialog/style'
+import 'vant/es/notify/style'
+import 'vant/es/image-preview/style'
+```
+
+### 3. `src/locales/index.ts` — 合并 Vant 语言包
+
+```ts
+import elenLocale from 'element-plus/es/locale/lang/en'
+import elzhLocale from 'element-plus/es/locale/lang/zh-cn'
+import venLocale from 'vant/es/locale/lang/en-US'
+import vzhLocale from 'vant/es/locale/lang/zh-CN'
+// ... 其余 import 不变
+
+const messages = {
+  en: { ...elenLocale, ...venLocale, ...enLocale },
+  zh: { ...elzhLocale, ...vzhLocale, ...zhLocale },
+}
+```
+
+### 4. `src/styles/index.scss` — 挂回 vant 主题覆盖
+
+文件 `src/styles/vant.scss` **仍在仓库**，只需恢复引用：
+
+```scss
+@use 'dark';
+@use 'vant';
+```
+
+### 5. `build/plugins/AutoImportComponents.ts` — 恢复 VantResolver
+
+```ts
+import { VantResolver } from '@vant/auto-import-resolver'
+import AutoImport from 'unplugin-auto-import/vite'
+import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
+import Components from 'unplugin-vue-components/vite'
+
+// AutoImport / Components 的 resolvers 均改为：
+resolvers: [ElementPlusResolver({ importStyle: false }), VantResolver()],
+```
+
+### 6. `build/plugins/Vconsole.ts` — 恢复真实插件
+
+将占位 `return []` 换回：
+
+```ts
+import path from 'node:path'
+import { viteVConsole } from 'vite-plugin-vconsole'
+
+export function createViteVConsole() {
+  return viteVConsole({
+    entry: [path.resolve('src/main.ts')],
+    enabled: true,
+    config: { maxLogNumber: 1000, theme: 'light' },
+  })
+}
+```
+
+说明：`build/plugins/index.ts` 已有 `if (viteEnv.VITE_VCONSOLE) plugins.push(createViteVConsole())`，一般**不用改**。本地调试在 `.env.development` 设 `VITE_VCONSOLE = true`。
+
+### 7. `build/optimize.ts` — 预构建（建议）
+
+在 `include` 数组中追加（装包后）：
+
+```ts
+'vant/es',
+'vant/es/locale/lang/zh-CN',
+'vant/es/locale/lang/en-US',
+```
+
+### 8. 启用后可用资产
+
+| 资产 | 路径 |
+|------|------|
+| `ReSelectVant` | `src/components/ReSelectVant` |
+| `RePopupPicker` | `src/components/RePopupPicker` |
+| `vantRules` | `src/utils/vantRules.ts` |
+| 移动路由扫描 | `src/router/mobileModules/**`（见 `router/index.ts`） |
+
+### AI 变更说明模板
+
+```text
+已启用 mobile-h5 / Vant：
+- pnpm add vant@4.10.0 vconsole@3.15.1 + -D @vant/auto-import-resolver@1.3.0 vite-plugin-vconsole@2.1.1
+- tsconfig：移除 ReSelectVant / RePopupPicker / vantRules exclude
+- 已改：main.ts、locales/index.ts、styles/index.scss、AutoImportComponents.ts、Vconsole.ts、optimize.ts
+- type-check：…
+```
+
+---
 
 ## 移动端页面结构
 

package/references/project-inventory.md

@@ -8,6 +8,16 @@
 - 版本对齐模板 `package.json`（2026-08 冻结）；先查业务项目 `package.json`
 - 缺失 →「九、专项能力依赖安装表」精确版本 `pnpm` 命令，确认后再装；禁止 `@latest` / 无版本号
 
+## 精简模板（vue3-web-temp）策略
+
+| 层级 | 说明 |
+|------|------|
+| **core** | 已在模板 `package.json`（如 `axios@1.19.0`、`element-plus`、`pinia`） |
+| **addon** | 专项 npm 包**默认不装**；`ReEchart` 等扩展组件源码保留，使用前按**第九节**安装 |
+| **标准样板** | 列表/详情/表单等完整示例在本 Skill `references/`，不在模板 `views/` 堆演示页 |
+
+AI 生成业务代码时：以 Skill 模块标准样板为准；先查 `package.json` 是否已有 addon，缺失则先列安装命令征得确认。
+
 ---
 
 ## 一、三方库清单（按功能分类）
@@ -71,7 +81,7 @@
 
 | 库 | 版本 | scope | 用途 | 备注 |
 |---|---|---|---|---|
-| `axios` | `1.18.1` | core | HTTP | 仅经 `@/utils/http` |
+| `axios` | `1.19.0` | core | HTTP | 仅经 `@/utils/http` |
 | `crypto-js` | `4.2.0` | core | AES | + `@types/crypto-js@4.2.2` |
 | `jsencrypt` | `3.5.4` | core | RSA | |
 | `js-md5` | `0.8.3` | core | MD5 签名 | + `@types/js-md5@0.8.0` |
@@ -340,30 +350,29 @@
 
 ## 九、专项能力依赖安装表（addon）
 
-> **何时用**：裁剪过的派生项目、或 `package.json` 中找不到对应包时。  
+> **何时用**：精简模板默认**未装** addon；裁剪过的派生项目、或 `package.json` 中找不到对应包时。  
 > **包管理**：统一 `pnpm`。`-D` 表示写入 `devDependencies`。  
-> **AI 流程**：① 查 `package.json` → ② 列出缺失包 → ③ 展示下方命令并征得确认 → ④ 执行安装 → ⑤ 再写业务代码。  
-> 完整模板通常已装齐，**不要**重复安装。
+> **AI 流程**：① 查 `package.json` → ② 列出缺失包 → ③ 展示下方命令并征得确认 → ④ 执行安装 → ⑤ **读 `addon-enable.md` 对应章节逐文件改配置**（含第十节 `tsconfig exclude`）→ ⑥ 再写业务代码。
 
 | Skill 模块 | 生产依赖（精确版本） | 开发依赖（精确版本） | 构建/接线附属 | 一键安装命令 |
 |---|---|---|---|---|
-| **table-vxe** | `vxe-table@4.19.21` `vxe-pc-ui@4.15.19` | — | `main.ts` 中 vxe 注册（以仓库为准） | `pnpm add vxe-table@4.19.21 vxe-pc-ui@4.15.19` |
-| **form-advanced**（地址解析 / CheckCard） | `address-parse@1.2.19` `plus-pro-components@0.1.31` | — | — | `pnpm add address-parse@1.2.19 plus-pro-components@0.1.31` |
-| **file-management** | `@file-viewer/core@2.1.14` `@file-viewer/vue3@2.1.14` `@file-viewer/preset-all@2.1.14` `browser-image-compression@2.0.2` | `@file-viewer/vite-plugin@2.1.14` | `build/plugins/FileViewer.ts`；chunks 大体积 vendor | `pnpm add @file-viewer/core@2.1.14 @file-viewer/vue3@2.1.14 @file-viewer/preset-all@2.1.14 browser-image-compression@2.0.2` + `pnpm add -D @file-viewer/vite-plugin@2.1.14` |
-| **rich-text** | `@wangeditor/editor@5.1.23` | — | — | `pnpm add @wangeditor/editor@5.1.23` |
-| **chart-echarts** | `echarts@6.1.0` | — | — | `pnpm add echarts@6.1.0` |
-| **chart-echarts**（词云） | 上 + `echarts-wordcloud@2.1.0` | — | 业务侧 `import 'echarts-wordcloud'` | `pnpm add echarts@6.1.0 echarts-wordcloud@2.1.0` |
-| **data-screen** | `grid-layout-plus@1.1.1`（图表另见 chart-echarts） | — | 大屏缩放按模块示例 | `pnpm add grid-layout-plus@1.1.1` |
-| **graph-relation** | `relation-graph-vue3@2.2.11` | — | chunks 拆包（若模板有） | `pnpm add relation-graph-vue3@2.2.11` |
-| **workflow-bpmn** | `bpmn-js@18.19.0` | — | 仅 Viewer | `pnpm add bpmn-js@18.19.0` |
-| **flowchart-g6** | `@antv/g6@5.1.1` `g6-extension-vue@0.1.0` | — | chunks：`antv-g6` / `antv-vendor` | `pnpm add @antv/g6@5.1.1 g6-extension-vue@0.1.0` |
-| **data-mapping** | `jsplumb@2.15.6` | — | — | `pnpm add jsplumb@2.15.6` |
-| **mobile-h5** | `vant@4.10.0` `vconsole@3.15.1` | `@vant/auto-import-resolver@1.3.0` `vite-plugin-vconsole@2.1.1` | `build/plugins/Vconsole.ts`；`VITE_VCONSOLE`；AutoImport Vant resolver | `pnpm add vant@4.10.0 vconsole@3.15.1` + `pnpm add -D @vant/auto-import-resolver@1.3.0 vite-plugin-vconsole@2.1.1` |
-| **wechat-js** | `weixin-js-sdk@1.6.5` | — | `utils/wechat` + `useWechat` + `api/wechat` | `pnpm add weixin-js-sdk@1.6.5` |
-| **verify-captcha** | `vue3-puzzle-vcode@1.1.7` | — | — | `pnpm add vue3-puzzle-vcode@1.1.7` |
-| **qrcode-barcode** | `qrcode@1.5.4` `jsbarcode@3.12.3` | `@types/qrcode@1.5.6` | — | `pnpm add qrcode@1.5.4 jsbarcode@3.12.3` + `pnpm add -D @types/qrcode@1.5.6` |
-| **feedback-ui**（打字机） | `typeit@8.8.7` | — | — | `pnpm add typeit@8.8.7` |
-| **particles** | `@tsparticles/slim@4.3.1` `@tsparticles/vue3@4.3.1` | — | `main.ts` 中 `Particles` + `loadSlim`；可选 `build/chunks.ts` 的 `tsparticles-vendor` | `pnpm add @tsparticles/slim@4.3.1 @tsparticles/vue3@4.3.1` |
+| **table-vxe** | `vxe-table@4.19.21` `vxe-pc-ui@4.15.19` | — | `main.ts` 中 vxe 注册（以仓库为准）；启用细节见 `addon-enable` K | `pnpm add vxe-table@4.19.21 vxe-pc-ui@4.15.19` |
+| **form-advanced**（地址解析 / CheckCard） | `address-parse@1.2.19` `plus-pro-components@0.1.31` | — | **`addon-enable` E** | `pnpm add address-parse@1.2.19 plus-pro-components@0.1.31` |
+| **file-management** | `@file-viewer/core@2.1.14` `@file-viewer/vue3@2.1.14` `@file-viewer/preset-all@2.1.14` `browser-image-compression@2.0.2` | `@file-viewer/vite-plugin@2.1.14` | **`addon-enable` D**（FileViewer.ts / env.d.ts） | `pnpm add @file-viewer/core@2.1.14 @file-viewer/vue3@2.1.14 @file-viewer/preset-all@2.1.14 browser-image-compression@2.0.2` + `pnpm add -D @file-viewer/vite-plugin@2.1.14` |
+| **rich-text** | `@wangeditor/editor@5.1.23` | — | **`addon-enable` C** | `pnpm add @wangeditor/editor@5.1.23` |
+| **chart-echarts** | `echarts@6.1.0` | — | **`addon-enable` B** | `pnpm add echarts@6.1.0` |
+| **chart-echarts**（词云） | 上 + `echarts-wordcloud@2.1.0` | — | 业务侧 `import 'echarts-wordcloud'`；**`addon-enable` B** | `pnpm add echarts@6.1.0 echarts-wordcloud@2.1.0` |
+| **data-screen** | `grid-layout-plus@1.1.1`（图表另见 chart-echarts） | — | `addon-enable` K | `pnpm add grid-layout-plus@1.1.1` |
+| **graph-relation** | `relation-graph-vue3@2.2.11` | — | `addon-enable` K | `pnpm add relation-graph-vue3@2.2.11` |
+| **workflow-bpmn** | `bpmn-js@18.19.0` | — | `addon-enable` K | `pnpm add bpmn-js@18.19.0` |
+| **flowchart-g6** | `@antv/g6@5.1.1` `g6-extension-vue@0.1.0` | — | `addon-enable` K | `pnpm add @antv/g6@5.1.1 g6-extension-vue@0.1.0` |
+| **data-mapping** | `jsplumb@2.15.6` | — | `addon-enable` K | `pnpm add jsplumb@2.15.6` |
+| **mobile-h5** | `vant@4.10.0` `vconsole@3.15.1` | `@vant/auto-import-resolver@1.3.0` `vite-plugin-vconsole@2.1.1` | **`addon-enable` J** + `mobile-h5` 启用清单 | `pnpm add vant@4.10.0 vconsole@3.15.1` + `pnpm add -D @vant/auto-import-resolver@1.3.0 vite-plugin-vconsole@2.1.1` |
+| **wechat-js** | `weixin-js-sdk@1.6.5` | — | **`addon-enable` I** | `pnpm add weixin-js-sdk@1.6.5` |
+| **verify-captcha** | `vue3-puzzle-vcode@1.1.7` | — | **`addon-enable` H** | `pnpm add vue3-puzzle-vcode@1.1.7` |
+| **qrcode-barcode** | `qrcode@1.5.4` `jsbarcode@3.12.3` | `@types/qrcode@1.5.6` | **`addon-enable` F** | `pnpm add qrcode@1.5.4 jsbarcode@3.12.3` + `pnpm add -D @types/qrcode@1.5.6` |
+| **feedback-ui**（打字机） | `typeit@8.8.7` | — | **`addon-enable` G** | `pnpm add typeit@8.8.7` |
+| **particles** | `@tsparticles/slim@4.3.1` `@tsparticles/vue3@4.3.1` | — | `addon-enable` K + `particles.md` | `pnpm add @tsparticles/slim@4.3.1 @tsparticles/vue3@4.3.1` |
 | **api-check** / Mock | —（运行时无额外包） | `vite-plugin-fake-server@2.2.4`（core 通常已有） | `build/plugins/ViteMockServe.ts`；`VITE_USE_MOCK` | 缺失时：`pnpm add -D vite-plugin-fake-server@2.2.4` |
 | **websocket-realtime** / **data-compare** / **seamless-scroll** / **directives-advanced** / **download-export** / **tree-table** | 无额外 npm 包（用项目封装） | — | 见各模块 | 无需安装 |
 
@@ -380,3 +389,43 @@
 ```
 
 未经用户确认**不得**擅自改 `package.json` 或执行安装。
+
+---
+
+## 十、精简模板 addon 启用清单（`tsconfig exclude`）
+
+> **非自动**：`pnpm add` 不会删除 `tsconfig exclude`，也不会改 `main.ts` / 插件。  
+> **完整逐文件代码**：见 **`addon-enable.md`**（B–J 章）。本节仅索引。  
+> AI 装包后**必须**按 `addon-enable` 改配置，并在变更说明中列出文件。
+
+### 启用步骤（每次命中 addon）
+
+1. 查 `package.json` → 第九节精确版本安装（用户确认）
+2. 打开 `addon-enable.md` 对应章节，逐文件落盘
+3. 按下表从 `tsconfig.json` 的 `exclude` **删除**对应行
+4. `pnpm type-check` → 再写业务代码
+
+### exclude 路径 ↔ Skill 模块 ↔ addon-enable 章节
+
+| Skill 模块 | 须移除的 `exclude` 项 | 代码恢复章节 |
+|---|---|---|
+| **chart-echarts** | `src/components/ReEchart/**` | **B** |
+| **rich-text** | `src/components/ReRichText/**` | **C** |
+| **file-management** | `src/components/ReFileViewer/**`、`types/file-viewer.d.ts` | **D** |
+| **form-advanced**（ReCheckCard） | `src/components/ReCheckCard/**` | **E** |
+| **qrcode-barcode** | `ReQrcode/**`、`ReBarcode/**` | **F** |
+| **feedback-ui**（打字机） | `src/components/ReTypeit/**` | **G** |
+| **verify-captcha** | `src/components/ReVerify/**` | **H** |
+| **wechat-js** | `wechat/**`、`useWechat.ts`、`api/wechat/**` | **I** |
+| **mobile-h5** | `ReSelectVant/**`、`RePopupPicker/**`、`vantRules.ts` | **J**（+ `mobile-h5.md`） |
+
+`browser-image-compression` 随 **D**；`imageCompression.ts` 未 exclude（可 Canvas 降级）。
+
+### AI 输出示例
+
+```text
+已启用 chart-echarts（addon-enable B）：
+- pnpm add echarts@6.1.0
+- tsconfig：移除 ReEchart/**
+- type-check：通过
+```

package/references/qrcode-barcode.md

@@ -17,6 +17,8 @@ pnpm add qrcode@1.5.4 jsbarcode@3.12.3
 pnpm add -D @types/qrcode@1.5.6
 ```
 
+装包后按 **`addon-enable.md` 章节 F** 移除 `ReQrcode/**`、`ReBarcode/**` exclude。
+
 ## 组件选型
 
 | 场景                | 组件        | 底层库      |

package/references/rich-text.md

@@ -14,6 +14,8 @@
 pnpm add @wangeditor/editor@5.1.23
 ```
 
+装包后按 **`addon-enable.md` 章节 C**：移除 `tsconfig exclude` 中 `ReRichText/**`，再引用组件。
+
 ## 组件
 
 使用 `ReRichText` 封装 `@wangeditor/editor`。

package/references/verify-captcha.md

@@ -14,6 +14,8 @@
 pnpm add vue3-puzzle-vcode@1.1.7
 ```
 
+装包后按 **`addon-enable.md` 章节 H** 移除 `ReVerify/**` exclude。
+
 `ReDragVerify` / `ReImageVerify` / `ReSmsCode` 为项目自研，无需额外 npm 包。
 
 ## 组件选型

package/references/wechat-js.md

@@ -20,6 +20,8 @@ tags: [wechat, weixin, js-sdk, useWechat]
 pnpm add weixin-js-sdk@1.6.5
 ```
 
+装包后按 **`addon-enable.md` 章节 I** 移除 wechat 相关 `tsconfig exclude`。
+
 ## 完整示例
 
 ```vue