@qilitt-mickey/vue3-temp-skill 1.1.18 → 1.1.20

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

@@ -9,10 +9,26 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 执行顺序：命中模块 → 读 `core-kernel` → 读命中 `references/<模块>.md` → 生成 → 执行 `code-quality` → 回复含审查结果块。
 
+## 术语约定
+
+全文统一使用下表术语；不得使用「黄金样板 / 强制完整样板 / 抗略读 / 默记 / 真相源」等表述。
+
+| 统一术语 | 含义 | 禁止使用 |
+|----------|------|----------|
+| 标准样板 | 模块内完整代码样板，命中即整段落盘 | 黄金样板、强制完整样板 |
+| 完整性守则 | 全模块通用的防浅读规则 | 抗略读 |
+| 速查约定 | 高频写法的快速指引 | 默记 |
+| 权威性优先级 | 实现方式选取顺序：仓库封装 > 本 Skill 示例 > 通用 Vue 习惯 | 真相源 |
+| 回退至 | 缺档取值动作（如「缺档 → 回退至 default」） | 缺档场景的「落到」 |
+| 未命中模块 | 需求无对应专项模块时的路由结果 | 「兜底」指代路由结果 |
+
 ## 模版约定
 
 - 面向由 **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`/令牌整组，禁止只改主色）
 
 ## 使用方式
@@ -25,19 +41,19 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 1. 先读 `references/core-kernel.md`
 2. 复用仓库已有 `Re*` / Hook / utils；选型表指定库勿擅自替换
-3. 按命中模块内**强制完整样板**整段编写（禁止只抄 API 签名、丢掉 meta/配套段落）
+3. 按命中模块内**标准样板**整段编写（禁止只抄 API 签名、丢掉 meta/配套段落）
 4. 无对应能力 → 标注「待确认」，未经同意不引入新依赖
-5. 真相源：`仓库已有封装` > `本 Skill 示例` > 通用 Vue 习惯
-6. 命中 addon / 缺依赖时再读 `project-inventory.md` 第九节；精确版本安装，禁止 `@latest`
+5. 权威性优先级：`仓库已有封装` > `本 Skill 示例` > 通用 Vue 习惯
+6. 命中 addon / 缺依赖：读 `project-inventory` 第九/十节 + **`addon-enable.md`**（逐文件恢复代码）；精确版本安装，禁止 `@latest`
 
-## 抗略读（全模块 · 提高命中率）
+## 完整性守则（全模块强制）
 
-按需模块 ≠ 可浅读。命中即须落到该文件的**完整样板 / Must-do**，生成后靠 `code-quality` 硬失败表兜底。
+按需模块 ≠ 可浅读。命中即须落到该文件的**标准样板 / Must-do**，生成后靠 `code-quality` 硬失败表兜底。
 
 1. **样板字段默认写出**：示例里写明的 `activePath` / `keepAlive` / `roles` / `responseType: "blob"` 等不得改成 `//` 注释再当可选项；仅业务明确不需要时才删除
 2. **关联能力同批落盘**：列表→详情 = `crud-pages` + `detail-page` 三件套；有 API = 同步 `http-api`；有删除 = 确认框；有编辑回显 = `Object.assign`
 3. **Hook ≠ 壳层自动**：`toDetail` 写 tag；侧栏高亮 / keepAlive 靠路由 meta；`http` 加解密靠环境开关，不靠单请求配置
-4. **大范围交付仍须逐模块核对硬失败表**，禁止「lint 过了就算完」
+4. **大范围交付仍须逐模块核对硬失败表**，禁止以 lint 通过代替硬失败表逐项核对
 
 ## 模块路由表
 
@@ -52,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`） |
 
@@ -97,15 +114,16 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 | **feedback-ui** | 通知栏、水印、时间轴、打字机 |
 | **seamless-scroll** | 无缝滚动、跑马灯 |
 | **particles** | 粒子、tsparticles、登录背景粒子 |
-| **directives-advanced** | 一键复制、标题太长字号变小 → `v-copy` / `v-auto-font` |
+| **directives-advanced** | 一键复制、标题字号自适应 → `v-copy` / `v-auto-font` |
 
 ### 匹配规则
 
 1. 单模块 → 该模块 + `core-kernel`；结束后执行 `code-quality`
 2. 多模块 → 同时加载（例：客户列表 = `crud-pages` + `permission-auth` + `http-api`）
-3. 兜底 → 仅 `core-kernel`，询问是否专项
-4. 默认不改 `vite.config.ts` / `build/**`
+3. 未命中模块 → 仅 `core-kernel`，向用户确认是否专项
+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`）
@@ -118,10 +136,10 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
    - 列表→独立详情/编辑页 → `crud-pages` + `detail-page`
 6. 独立详情路由：跳转与 meta 见 `detail-page`（`toDetail` / `showLink` / `activePath` / `initToDetail`）
 
-## 默记（细则见对应模块）
+## 速查约定（细则见对应模块）
 
 - HTTP：`import { http } from '@/utils/http'`；方法跟后端（允许 GET/POST）；`Result<T>`；`VITE_API_BASE_URL` → `http-api`
-- 列表：`onSearch` / `reset` + 黄金样板 → `crud-pages`
+- 列表：`onSearch` / `reset` + 标准样板 → `crud-pages`
 - 独立详情：`toDetail` **不能替代** `activePath` / `keepAlive` / `moreTags`；三件套 → `detail-page`
 - 权限：`meta.roles` + `v-auth`/`ReAuth` → `permission-auth`
 - 不二次挂 Layout；`script setup` + `defineOptions({ name })`；`$t('中文')`；样式契约 → `core-kernel`
@@ -129,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` → …
 - 待确认：…
@@ -155,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.18",
+  "version": "1.1.20",
   "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/api-check.md

@@ -9,7 +9,7 @@ tags: [api, backend, integration, contract, http, checklist, mock]
 
 写法与示例 → **`http-api`**。本文件只做联调核对。权威源：`types/global.d.ts`、`src/utils/http.ts`、`src/api/**`、`mock/**`、`useTableSearch`。
 
-**抗略读**：联调阶段仍须核对「下载是否带 blob」「分页字段是否 content/totalCount」；契约不过 = API 未完成，禁止只靠 lint 放行。
+**完整性守则**：联调阶段仍须核对「下载是否带 blob」「分页字段是否 content/totalCount」；契约不过 = API 未完成，禁止只靠 lint 放行。
 
 ## 基本信息
 

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

@@ -30,7 +30,7 @@ tags: [code-review, quality, checklist, lint, typescript, vue3, security, perfor
 
 ## 硬失败（对照落盘文件；命中即未通过）
 
-lint / type-check **过了也不能放过**下列项。发现即改代码，禁止「已知问题后续再说」。
+lint / type-check **过了也不能放过**下列项。发现即改代码，禁止搁置已知问题。
 
 | 触发条件（改动里出现） | 未通过条件 | 正确做法 |
 |------------------------|------------|----------|
@@ -45,16 +45,17 @@ 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`
-- [ ] 列表布局按 `crud-pages` 黄金样板（`el-card.vts-page-card`+`content`、无 `100vh` 减顶栏、`tableHeight`、`otherRef`、分页在 ReTableBar 内；内容区无外层滚动条）
+- [ ] 列表布局按 `crud-pages` 标准样板（`el-card.vts-page-card`+`content`、无 `100vh` 减顶栏、`tableHeight`、`otherRef`、分页在 ReTableBar 内；内容区无外层滚动条）
 - [ ] 顶栏高度仅 `--header-height` 等 CSS 令牌；禁止 JS 测顶栏 / `platform-config` 顶栏像素字段 / `useApp` 导出顶栏高度
 
 ## TypeScript
@@ -105,14 +106,14 @@ lint / type-check **过了也不能放过**下列项。发现即改代码，禁
 - [ ] 冲突清单已逐条处理（见 `design-system`）
 - [ ] 有上游设计产出时已读 `design-handoff`：JSON 优先；**原子步骤**含 `Theme=default`（深色侧栏）+ `--sidebar-*` + **`Version++`** + 主色阶；禁止只改 EpThemeColor；错误色 `#F5222D`
 - [ ] **无**设计落地时未改出厂主色 / ShowModel / 壳层 / 弹窗几何默认
-- [ ] 组件尺寸三档已落地并桥接 `--el-component-size*`；缺档落到 default；未全局强制 `size="small"`；**查询区不写 size**（三档对照表 ≠ 查询区要用 small）
+- [ ] 组件尺寸三档已落地并桥接 `--el-component-size*`；缺档回退至 default；未全局强制 `size="small"`；**查询区不写 size**（三档对照表 ≠ 查询区要用 small）
 
 ## 业务
 
 - [ ] 提交前 `validate()`；删除有确认；提交有 loading；列表有 `v-loading`
 - [ ] 编辑回显正确（`Object.assign`）；分页切换会拉数
 
-### 列表→详情（改动含 toDetail / *Detail 路由时强制，禁止 N/A 糊弄）
+### 列表→详情（改动含 toDetail / *Detail 路由时强制，禁止以 N/A 跳过）
 
 - [ ] **打开落盘路由文件**核对：兄弟绝对 path；`showLink:false`；`activePath`=列表 path；非空 `title`；默认 `keepAlive`+`moreTags`
 - [ ] 仅 `toDetail`；详情 `initToDetail`；`name` 对齐；`toDetail` 第 3 参 title 可辨识