@qilitt-mickey/vue3-temp-skill 1.1.74 → 1.1.76

package/references/project-inventory.md

@@ -1,438 +1,438 @@
----
-name: project-inventory
-description: 项目资产清单：三方库、Re* 组件、依赖安装表
-scope: project
-tags: [查Re, 版本, 安装, 依赖清单, 库版本]
----
-
-# 项目资产清单（Project Inventory）
-
-## 何时读本文件
-
-按需加载（非始终）：查 Re* / Hook 名、确认库版本、命中 addon、缺依赖需安装时。硬约束与壳摘要见 `core-kernel`。
-
-- 已有封装须复用；选型表指定库勿擅自替换；新依赖须待确认
-- 版本对齐模板 `package.json`（2026-08 冻结）；先查业务项目 `package.json`
-- 缺失 → 先说明缺少的能力、影响范围和精确版本，再征得确认后安装；禁止 `@latest` / 无版本号
-
-## 参考模板（vue3-web-temp）策略
-
-| 层级 | 说明 |
-|------|------|
-| **core** | 以业务项目当前 `package.json` 为准；不要假设模板或派生项目的依赖分层完全一致 |
-| **可选能力** | ECharts、Vant、VXE、BPMN、G6、文件预览、富文本等能力必须先检查当前项目是否已安装，再决定是否安装或直接复用 |
-| **标准样板** | 列表/详情/表单等完整示例在本 Skill `references/`；模板 `views/` 中的示例页面只用于确认真实 API、组件和壳层接线，不直接当生产页面复制 |
-
-AI 生成业务代码时：以 Skill 模块标准样板为准；先查 `package.json` 是否已有 addon，缺失则先列安装命令征得确认。
-
----
-
-## 一、三方库清单（按功能分类）
-
-> 版本号记录的是当前参考模板的已验证版本；真正执行前必须以目标业务项目的 `package.json`、锁文件和构建接线为准。`scope` 仅表示参考模板中的常见用途，不代表所有派生项目都已安装。
-
-### UI 框架
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `element-plus` | `2.14.2` | core | PC 端 UI | 自动引入 |
-| `vant` | `4.10.0` | addon | 移动端 UI | 见 mobile-h5 |
-| `plus-pro-components` | `0.1.31` | addon | EP 企业扩展（ReCheckCard 等） | 见 form-advanced |
-| `vxe-table` | `4.19.21` | addon | 高性能大数据表格 | 见 table-vxe |
-| `vxe-pc-ui` | `4.15.19` | addon | VXE 配套 PC UI | 与 vxe-table 同装 |
-
-### 图表与可视化
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `echarts` | `6.1.0` | addon | 图表引擎 | + `ReEchart` |
-| `echarts-wordcloud` | `2.1.0` | addon | 词云 | ECharts 扩展 |
-| `relation-graph-vue3` | `2.2.11` | addon | 关系/知识图谱 | 见 graph-relation |
-| `@antv/g6` | `5.1.1` | addon | 图可视化 | 见 flowchart-g6 |
-| `g6-extension-vue` | `0.1.0` | addon | G6 Vue 节点 | 与 g6 同装 |
-
-### 工作流与流程
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `bpmn-js` | `18.19.0` | addon | BPMN Viewer（只读） | 见 workflow-bpmn；不用 Modeler |
-| `jsplumb` | `2.15.6` | addon | 连线/字段映射 | 见 data-mapping |
-
-### 富文本与编辑器
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `@wangeditor/editor` | `5.1.23` | addon | 富文本 | + `ReRichText` |
-
-### 图标
-
-> 用法规范见专项模块 **`icons`**（`references/icons.md`）。
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `@iconify/vue` | `5.0.1` | core | 图标框架 | 经全局 `svg-icon` |
-| `@iconify-json/ep` | `1.2.4` | core | EP 图标集 | devDependency |
-| `@iconify-json/ri` | `1.2.10` | core | Remix 图标集 | devDependency |
-| `vite-plugin-svg-icons` | `2.0.1` | core | SVG 雪碧图 | + `ReSvgIcon`；扫描 `src/icons/svg` |
-| `vite-svg-loader` | `5.1.1` | core | `svg?component` | 见 `build/plugins/SvgLoader.ts` |
-
-### 状态管理与路由
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `pinia` | `3.0.4` | core | 状态管理 | |
-| `pinia-plugin-persistedstate` | `4.7.1` | core | Pinia 持久化 | |
-| `vue-router` | `5.1.0` | core | 路由 Hash + 动态路由 | |
-
-### HTTP 与加密
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `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` |
-
-### 工具库
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `@vueuse/core` | `14.3.0` | core | 组合式工具 | 自动引入 |
-| `@vueuse/math` | `14.3.0` | core | 数学组合式 | |
-| `@vueuse/motion` | `3.0.3` | core | 入场动画 | `v-motion` |
-| `@pureadmin/utils` | `2.6.4` | core | 下载/存储/设备等 | |
-| `dayjs` | `1.11.21` | core | 日期 | 不用 moment |
-| `qs` | `6.15.3` | core | query 序列化 | + `@types/qs@6.15.1` |
-| `js-cookie` | `3.0.8` | core | Cookie | + `@types/js-cookie@3.0.6` |
-| `mitt` | `3.0.1` | core | 事件总线 | |
-| `chroma-js` | `3.2.0` | core | 颜色/主题 | + `@types/chroma-js@3.1.2` |
-| `address-parse` | `1.2.19` | addon | 中文地址解析 | 见 form-advanced |
-| `nprogress` | `0.2.0` | core | 路由进度条 | + `@types/nprogress@0.2.3` |
-| `responsive-storage` | `2.2.0` | core | 响应式 storage | |
-| `sortablejs` | `1.15.7` | core | 拖拽排序 | + `@types/sortablejs@1.15.9` |
-| `vue-dompurify-html` | `5.3.0` | core | 安全 HTML | |
-| `browser-image-compression` | `2.0.2` | addon | 上传前压缩 | 见 file-management |
-
-### 文件预览
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `@file-viewer/core` | `2.1.14` | addon | 预览核心 | 三件套同版本 |
-| `@file-viewer/vue3` | `2.1.14` | addon | Vue3 集成 | + `ReFileViewer` |
-| `@file-viewer/preset-all` | `2.1.14` | addon | 全格式预设 | |
-| `@file-viewer/vite-plugin` | `2.1.14` | addon | Vite 插件 | **devDependency**；见 file-management |
-
-### 二维码与条形码
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `qrcode` | `1.5.4` | addon | 二维码 | + `ReQrcode`；`@types/qrcode@1.5.6` |
-| `jsbarcode` | `3.12.3` | addon | 条形码 | + `ReBarcode` |
-
-### 验证与动画
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `vue3-puzzle-vcode` | `1.1.7` | addon | 滑块拼图 | + `ReVerify` |
-| `typeit` | `8.8.7` | addon | 打字机 | + `ReTypeit` |
-| `@tsparticles/slim` | `4.3.1` | core | 粒子 | 登录背景 |
-| `@tsparticles/vue3` | `4.3.1` | core | 粒子 Vue3 | |
-| `tippy.js` | `6.3.7` | core | Tooltip | |
-| `vue-tippy` | `6.7.1` | core | Tippy Vue 封装 | |
-
-### 微信 / 移动调试
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `weixin-js-sdk` | `1.6.5` | addon | 微信 JS-SDK | 见 wechat-js |
-| `vconsole` | `3.15.1` | addon | 移动调试台 | 见 mobile-h5 |
-| `vite-plugin-vconsole` | `2.1.1` | addon | vConsole Vite 插件 | **devDependency** |
-
-### 布局 / CSS
-
-| 库 | 版本 | scope | 用途 | 备注 |
-|---|---|---|---|---|
-| `grid-layout-plus` | `1.1.1` | addon | 拖拽网格 | 大屏/仪表盘 |
-| `unocss` | `66.7.4` | core | 原子化 CSS | 及相关 `@unocss/*` 同版本 |
-
-### 构建链路常用插件（core，一般勿随业务安装）
-
-| 库 | 版本 | 用途 |
-|---|---|---|
-| `vite` | `8.1.2` | 构建 |
-| `@vitejs/plugin-vue` | `6.0.7` | SFC |
-| `@vitejs/plugin-vue-jsx` | `5.1.6` | JSX |
-| `unplugin-auto-import` | `21.0.0` | 自动 API |
-| `unplugin-vue-components` | `32.1.0` | 自动组件 |
-| `@vant/auto-import-resolver` | `1.3.0` | Vant 解析（mobile 时需要） |
-| `vite-plugin-fake-server` | `2.2.4` | Mock（`VITE_USE_MOCK`） |
-| `vite-plugin-compression` | `0.5.1` | Gzip |
-| `rollup-plugin-visualizer` | `7.0.1` | 包分析 |
-| `vite-plugin-bundle-obfuscator` | `1.13.0` | 混淆 |
-| `vite-plugin-vue-devtools` | `8.1.5` | DevTools |
-| `vite-svg-loader` | `5.1.1` | SVG as component |
-| `vue` | `3.5.39` | 框架 |
-| `vue-i18n` | `11.4.6` | 国际化 |
-| `typescript` | `6.0.3` | 类型 |
-| `vue-tsc` | `3.3.6` | 类型检查 |
-
----
-
-## 二、Re* 自定义组件清单
-
-> 所有自定义组件以 `Re` 为前缀。开发前先查本表，禁止重复造轮子。  
-> **用法**按功能模块写（见 `ui-components` 索引），本表只做名录 + 落点。
-
-| 组件 | 用途 | 目录 | 用法模块 |
-|---|---|---|---|
-| **ReAnchor** | 锚点导航 | `ReAnchor/` | `form-advanced` |
-| **ReAttachment** | 附件上传/管理 | `ReAttachment/` | `file-management` |
-| **ReAuth** | 权限包裹 | `ReAuth/` | `permission-auth` |
-| **ReAvatars** | 头像组 | `ReAvatars/` | 业务页 / `data-screen` |
-| **ReBarcode** | 条形码 | `ReBarcode/` | `qrcode-barcode` |
-| **ReCascader** | 级联选择 | `ReCascader/` | `form-advanced` |
-| **ReCheckCard** | 卡片多选 | `ReCheckCard/` | `form-advanced` |
-| **ReCollapsible** | 折叠 | `ReCollapsible/` | `form-advanced` |
-| **ReDatePicker** | 日期 | `ReDatePicker/` | `form-advanced` |
-| **ReDateRangePicker** | 日期范围 | `ReDateRangePicker/` | `form-advanced` |
-| **ReDialog** | 弹窗（`fullscreen` 默认 false） | `ReDialog/` | `form-advanced` |
-| **ReDialogResize** | 可缩放弹窗 | `ReDialogResize/` | `form-advanced` |
-| **ReDragVerify** | 滑块拖拽验证 | `ReDragVerify/` | `verify-captcha` |
-| **ReEchart** | ECharts 容器 | `ReEchart/` | `chart-echarts` |
-| **ReFileViewer** | 文件预览 | `ReFileViewer/` | `file-management` |
-| **ReFlicker** | 闪烁点 | `ReFlicker/` | `data-screen` |
-| **ReGrid** | 响应式栅格 | `ReGrid/` | `crud-pages` |
-| **ReGridItem** | 栅格子项 | `ReGridItem/` | `crud-pages` |
-| **ReHeaderPage** | 页头 | `ReHeaderPage/` | `crud-pages` / `detail-page` |
-| **ReIconPicker** | 图标选择 | `ReIconPicker/` | `icons` |
-| **ReImageVerify** | 图形验证码 | `ReImageVerify/` | `verify-captcha` |
-| **ReLanguageSwitch** | 语言切换 | `ReLanguageSwitch/` | `layout-theme` |
-| **ReNoticeBar** | 通知栏 | `ReNoticeBar/` | `feedback-loading` |
-| **RePagination** | 分页 | `RePagination/` | `crud-pages` |
-| **RePopupPicker** | 移动端弹出选择 | `RePopupPicker/` | `mobile-h5` |
-| **ReQrcode** | 二维码 | `ReQrcode/` | `qrcode-barcode` |
-| **ReRichText** | 富文本 | `ReRichText/` | `rich-text` |
-| **ReSeamlessScroll** | 无缝滚动 | `ReSeamlessScroll/` | `seamless-scroll` |
-| **ReSegmented** | 分段控制 | `ReSegmented/` | `layout-theme` |
-| **ReSelectQuery** | 远程分页选择 | `ReSelectQuery/` | `form-advanced` |
-| **ReSelectVant** | 移动端选择 | `ReSelectVant/` | `mobile-h5` |
-| **ReSmsCode** | 短信倒计时 | `ReSmsCode/` | `verify-captcha` |
-| **ReSvgIcon** | SVG / Iconify | `ReSvgIcon/` | `icons` |
-| **ReTableBar** | 表格工具栏 | `ReTableBar/` | `crud-pages` |
-| **ReTableOperate** | 行操作（`limit` 默认 3；超出进「更多」；列宽用 `resolveOperateColumnWidth`；`:size` 跟表格密度） | `ReTableOperate/` | `crud-pages` |
-| **ReText** | 文本省略 | `ReText/` | `layout-theme` |
-| **ReTimeLine** | 时间轴 | `ReTimeLine/` | `detail-page` / 业务 |
-| **ReTreeLine** | 树连线 | `ReTreeLine/` | `tree-table` |
-| **ReTypeit** | 打字机 | `ReTypeit/` | `data-screen` |
-| **ReVerify** | 拼图验证 | `ReVerify/` | `verify-captcha` |
-
-路径前缀均为 `src/components/`。
-
----
-
-## 三、Hooks 清单
-
-> 所有 Hook 位于 `src/hooks/` 目录。开发新功能时必须先检查是否已有可复用的 Hook。
-
-| Hook | 用途 | 关键 API |
-|---|---|---|
-| **useApp** | 全局应用状态（布局、字典、登出等） | `baseCodeGet`、`filterValue`、`svgLoading`、`layout`、`logout` 等；顶栏高度不由此导出 |
-| **useDetail** | 列表→详情：写顶部 tag 并跳转 | `toDetail(name, params, title?, 'query'\|'params')`、`initToDetail(name)`、`getParameter`；路由配 `showLink:false`（不进侧栏）+`activePath`（见 `detail-page`） |
-| **useFormCheck** | 多表单校验聚合 | 追踪各字段校验状态，emit `form-validate` 事件 |
-| **useTableSearch** | 列表页搜索/分页/Loading/动态表高 | `content`（须绑 `el-card.vts-page-card`）、`multipleTableRef`（建议绑 `el-table`）、`otherRef`（表上方额外模块）、`tableHeight`（卡片底边 − 表格顶边 − 分页；空数据仍有占位高）、`paginationRef`、`tableData`、`pagination`、`loading`、`onSearch()`、`reset()`、`formRef`、`gridRef`、`collapsed` / `showCollapse` / `collapsedToggle` |
-| **useTags** | 多标签页管理 | 右键菜单（刷新/关闭/关闭其他/全屏） |
-| **useTheme** | 主题切换（暗色/亮色） | 主题色生成、布局预设、缓存重置 |
-| **useWebSocket** | WebSocket 通信 | `subscribe()`、`send()`、`sendRaw()`、`isConnected` |
-| **useWechat** | 微信 JS-SDK | `isReady`、`error` |
-
----
-
-## 四、工具函数清单
-
-> 所有工具位于 `src/utils/` 目录。
-
-| 文件 | 关键导出 | 用途 |
-|---|---|---|
-| `auth.ts` | `getToken()`、`setUserToken()`、`removeToken()` | Token 管理 |
-| `autoUpdate.ts` | `checkUpdate()` | 前端版本检测/自动刷新 |
-| `changeSummaryService.ts` | `ChangeSummaryService.getChangeSummaryData()` | v-compare 变更汇总读取/元素引用修复 |
-| `encryptUtils.ts` | `aesEncrypt()`、`aesDecrypt()`、`rsaEncrypt()`、`md5Sign()` | 加解密工具 |
-| `http.ts` | `http.request()` | Axios 封装（支持 GET/POST + 加密开关 + 拦截器） |
-| `i18n.ts` | `getLocale()` | 语言检测 |
-| `imageCompression.ts` | `compressImage()` | 图片压缩（上传前） |
-| `message.ts` | `message()` | 消息提示封装（ElMessage 包装） |
-| `mitt.ts` | `mitt()` | 全局事件总线 |
-| `motion.tsx` | `MotionComponent` | 入场动画 TSX 组件 |
-| `particles.ts` | `particlesOptions` | 粒子动画配置（tsParticles v4 paint） |
-| `progress/` | `NProgress` | 路由进度条配置 |
-| `responsive.ts` | `ResponsiveStorage` | 响应式存储注入 |
-| `router.ts` | `hasAuth()`、路由扁平化、权限过滤 | 路由工具 |
-| `rule.ts` | `passwordRule`、`phoneRule` | 表单校验规则（PC） |
-| `tree.ts` | `handleTree()`、`buildHierarchyTree()` | 树结构转换 |
-| `uploadManager.ts` | `UploadManager` | 批量上传任务管理 |
-| `useActivity.ts` | `useActivity()` | 用户空闲检测/自动登出 |
-| `utils.ts` | `svgLoad()`、`composeOptions()`、`getRowClassByFlag()`、`escapeAttrSelector()`、`formatFileSize()` 等 | 通用工具（含对比辅助） |
-| `vantRules.ts` | `vantRules` | 表单校验规则（移动端 Vant） |
-| `websocket/` | `initWebSocket()`、`closeWebSocket()`、`WebSocketManager` | WebSocket 基础设施 |
-| `wechat/` | `WechatSDK` | 微信 SDK 单例 |
-
----
-
-## 五、自定义指令清单
-
-> 所有指令位于 `src/directives/` 目录，在 `src/directives/index.ts` 统一注册。
-
-| 指令 | 用途 | 用法示例 |
-|---|---|---|
-| **v-auth** | 按钮级权限控制（无权限移除 DOM） | `v-auth="['btn.add']"` |
-| **v-auto-font** | 根据容器宽度自动缩放字体 | `v-auto-font:0.8` 或 `v-auto-font="{ scale: 0.8, min: 12, max: 24 }"` |
-| **v-compare** | 编辑页变更对比（高亮+汇总） | `v-compare:key="{ oldValue, title, label, enabled }"`；详见 data-compare |
-| **v-copy** | 复制文本到剪贴板 | `v-copy="text"`（双击）、`v-copy:click="text"`（单击） |
-
----
-
-## 六、Store 模块清单
-
-> 所有 Store 位于 `src/store/modules/`，使用 `pinia-plugin-persistedstate` 持久化。
-
-| Store | 用途 | 关键状态/方法 |
-|---|---|---|
-| **useAppStore** | 应用全局状态 | 侧边栏、布局模式、设备类型 |
-| **useBaseCodeStore** | 字典/码表缓存 | 按 `codeType` 获取+缓存 |
-| **useCompareStore** | 变更对比追踪 | `addOrUpdateRecord` / `clearAllRecords`；按 title 模块分组 |
-| **useLangStore** | 语言设置 | 持久化到 localStorage + cookie |
-| **useMultiTagsStore** | 多标签页 | 标签增删排序 |
-| **useRouterMenuStore** | 路由/菜单 | 静态+动态菜单、keepAlive 缓存 |
-| **useSettingStore** | UI 设置 | 标题、固定头部、侧边栏显隐 |
-| **useThemeStore** | 主题 | 主题色、暗色模式 |
-| **useUserStore** | 用户信息 | userCode、userName、角色、token |
-
----
-
-## 七、功能选型对照表（禁止替换）
-
-> 当用户需求涉及以下场景时，**必须使用选型表指定的库/组件**；勿擅自换成同类其他库，新依赖须待确认。
-
-| 需求场景 | 项目选型 | 勿擅自替换为 |
-|---|---|---|
-| 图表 | `echarts` + `ReEchart` | 禁止使用 Chart.js / D3 / Plotly 等 |
-| 关系/知识图谱 | `relation-graph-vue3` | 禁止引入 D3 / vis.js / Cytoscape 等 |
-| 流程图 | `@antv/g6` + `g6-extension-vue` | 禁止引入 Mermaid / X6 / LogicFlow 等 |
-| BPMN 工作流 | `bpmn-js` (Viewer) | 禁止引入其他 BPMN 库 |
-| 字段映射/连线 | `jsplumb` | 禁止引入 LeaderLine / Drawflow 等 |
-| 富文本编辑器 | `@wangeditor/editor` + `ReRichText` | 禁止引入 Quill / TinyMCE / CKEditor 等 |
-| 二维码 | `qrcode` + `ReQrcode` | 禁止引入其他二维码库 |
-| 条形码 | `jsbarcode` + `ReBarcode` | 禁止引入其他条形码库 |
-| 文件预览 | `@file-viewer/*` + `ReFileViewer` | 禁止引入 pdf.js / mammoth 等 |
-| 滑块验证 | `vue3-puzzle-vcode` + `ReVerify` | 禁止引入其他验证码库 |
-| 打字机动画 | `typeit` + `ReTypeit` | 禁止引入其他打字机库 |
-| 粒子动画 | `@tsparticles/slim` + `@tsparticles/vue3` + `particlesOptions` | 禁止引入 particles.js 等；配置见 `particles` 模块 |
-| 日期处理 | `dayjs` | 禁止引入 moment / date-fns 等 |
-| HTTP 请求 | 项目封装的 `src/utils/http.ts`（基于 axios） | 禁止直接使用 axios / fetch / ky 等 |
-| 状态管理 | `pinia` + `pinia-plugin-persistedstate` | 禁止引入 vuex / zustand 等 |
-| 原子化 CSS | `unocss` | 禁止引入 tailwindcss / windicss 等 |
-| 拖拽排序 | `sortablejs` | 禁止引入 vuedraggable / dnd-kit 等 |
-| 微信集成 | `weixin-js-sdk` + `useWechat` | 禁止引入其他微信 SDK |
-| 高性能表格 | `vxe-table` | 禁止引入 ag-grid / handsontable 等 |
-| 地址解析 | `address-parse` | 禁止引入其他地址解析库 |
-| 图片压缩 | `browser-image-compression` | 禁止引入其他压缩库 |
-| 颜色处理 | `chroma-js` | 禁止引入 color / polished 等 |
-| 事件总线 | `mitt`（项目封装 `src/utils/mitt.ts`） | 禁止引入 eventemitter3 等 |
-| 编辑页数据变更对比 | `v-compare` + `useCompareStore` + `ChangeSummaryService` / `ChangeSummaryDialog` | 禁止自研 Diff 组件树或第三方 diff UI；按 data-compare 模块 |
-
----
-
-## 八、使用规则
-
-1. **先查后写**：生成任何功能代码前，必须先在本清单中查找是否已有对应的库/组件/Hook/工具
-2. **有则必用**：已有封装直接复用，勿另起一套同能力实现；选型表指定库勿擅自替换
-3. **无则上报**：如果确实需要引入新库（清单中没有），必须在输出中明确说明原因，并标注为"待确认"让用户审批
-4. **按示例编写**：以对应 Skill 模块 `references/<模块>.md` 完整示例与约定写法为准
-5. **版本一致**：使用库的版本必须与清单中**精确版本**一致，不得擅自升降级，不得 `pnpm add xxx` 不带版本
-6. **缺依赖先装**：命中 addon 模块时，先读业务项目 `package.json`；缺失则按第九节安装命令征得确认后执行，再生成业务代码
-7. **Vite 插件成套**：涉及 `@file-viewer/vite-plugin`、`vite-plugin-vconsole` 等时，运行时包与 `-D` 插件、以及仓库内 `build/plugins/*` 接线一并检查；模板已接线则勿改 `vite.config`；裁剪缺失时需恢复对应插件文件后再装依赖
-8. **已移除依赖（勿再推荐）**：`@wocwin/t-ui-plus`、`animate.css`、`version-rocket`、`vue-types`、`vite-plugin-remove-console`、`vite-plugin-router-warn`；发版检测用 `utils/autoUpdate`；去 console 用构建 Terser
-
----
-
-## 九、专项能力依赖安装表（addon）
-
-> **何时用**：目标项目需要专项能力、但当前 `package.json` 中找不到对应包时。参考模板已包含的能力也必须以目标项目实际依赖为准。
-> **包管理**：统一 `pnpm`。`-D` 表示写入 `devDependencies`。  
-> **AI 流程**：① 查目标项目 `package.json` 与构建接线 → ② 列出缺失包及影响 → ③ 展示精确安装命令并征得确认 → ④ 执行安装 → ⑤ 仅在目标项目确有对应排除项或构建占位时，按 `addon-enable.md` 对应章节恢复配置 → ⑥ 再写业务代码。
-
-| Skill 模块 | 生产依赖（精确版本） | 开发依赖（精确版本） | 构建/接线附属 | 一键安装命令 |
-|---|---|---|---|---|
-| **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 包（用项目封装） | — | 见各模块 | 无需安装 |
-
-### 安装输出模板（AI 对用户）
-
-```text
-检测到以下依赖缺失（对齐模板锁定版本）：
-- xxx@a.b.c
-拟执行：
-  pnpm add ...
-  pnpm add -D ...
-涉及构建插件时还需确认：build/plugins/Xxx.ts 是否仍在。
-是否确认安装？
-```
-
-未经用户确认**不得**擅自改 `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：通过
-```
+---
+name: project-inventory
+description: 项目资产清单：三方库、Re* 组件、依赖安装表
+scope: project
+tags: [查Re, 版本, 安装, 依赖清单, 库版本]
+---
+
+# 项目资产清单（Project Inventory）
+
+## 何时读本文件
+
+按需加载（非始终）：查 Re* / Hook 名、确认库版本、命中 addon、缺依赖需安装时。硬约束与壳摘要见 `core-kernel`。
+
+- 已有封装须复用；选型表指定库勿擅自替换；新依赖须待确认
+- 版本对齐模板 `package.json`（2026-08 冻结）；先查业务项目 `package.json`
+- 缺失 → 先说明缺少的能力、影响范围和精确版本，再征得确认后安装；禁止 `@latest` / 无版本号
+
+## 参考模板（vue3-web-temp）策略
+
+| 层级 | 说明 |
+|------|------|
+| **core** | 以业务项目当前 `package.json` 为准；不要假设模板或派生项目的依赖分层完全一致 |
+| **可选能力** | ECharts、Vant、VXE、BPMN、G6、文件预览、富文本等能力必须先检查当前项目是否已安装，再决定是否安装或直接复用 |
+| **标准样板** | 列表/详情/表单等完整示例在本 Skill `references/`；模板 `views/` 中的示例页面只用于确认真实 API、组件和壳层接线，不直接当生产页面复制 |
+
+AI 生成业务代码时：以 Skill 模块标准样板为准；先查 `package.json` 是否已有 addon，缺失则先列安装命令征得确认。
+
+---
+
+## 一、三方库清单（按功能分类）
+
+> 版本号记录的是当前参考模板的已验证版本；真正执行前必须以目标业务项目的 `package.json`、锁文件和构建接线为准。`scope` 仅表示参考模板中的常见用途，不代表所有派生项目都已安装。
+
+### UI 框架
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `element-plus` | `2.14.2` | core | PC 端 UI | 自动引入 |
+| `vant` | `4.10.0` | addon | 移动端 UI | 见 mobile-h5 |
+| `plus-pro-components` | `0.1.31` | addon | EP 企业扩展（ReCheckCard 等） | 见 form-advanced |
+| `vxe-table` | `4.19.21` | addon | 高性能大数据表格 | 见 table-vxe |
+| `vxe-pc-ui` | `4.15.19` | addon | VXE 配套 PC UI | 与 vxe-table 同装 |
+
+### 图表与可视化
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `echarts` | `6.1.0` | addon | 图表引擎 | + `ReEchart` |
+| `echarts-wordcloud` | `2.1.0` | addon | 词云 | ECharts 扩展 |
+| `relation-graph-vue3` | `2.2.11` | addon | 关系/知识图谱 | 见 graph-relation |
+| `@antv/g6` | `5.1.1` | addon | 图可视化 | 见 flowchart-g6 |
+| `g6-extension-vue` | `0.1.0` | addon | G6 Vue 节点 | 与 g6 同装 |
+
+### 工作流与流程
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `bpmn-js` | `18.19.0` | addon | BPMN Viewer（只读） | 见 workflow-bpmn；不用 Modeler |
+| `jsplumb` | `2.15.6` | addon | 连线/字段映射 | 见 data-mapping |
+
+### 富文本与编辑器
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `@wangeditor/editor` | `5.1.23` | addon | 富文本 | + `ReRichText` |
+
+### 图标
+
+> 用法规范见专项模块 **`icons`**（`references/icons.md`）。
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `@iconify/vue` | `5.0.1` | core | 图标框架 | 经全局 `svg-icon` |
+| `@iconify-json/ep` | `1.2.4` | core | EP 图标集 | devDependency |
+| `@iconify-json/ri` | `1.2.10` | core | Remix 图标集 | devDependency |
+| `vite-plugin-svg-icons` | `2.0.1` | core | SVG 雪碧图 | + `ReSvgIcon`；扫描 `src/icons/svg` |
+| `vite-svg-loader` | `5.1.1` | core | `svg?component` | 见 `build/plugins/SvgLoader.ts` |
+
+### 状态管理与路由
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `pinia` | `3.0.4` | core | 状态管理 | |
+| `pinia-plugin-persistedstate` | `4.7.1` | core | Pinia 持久化 | |
+| `vue-router` | `5.1.0` | core | 路由 Hash + 动态路由 | |
+
+### HTTP 与加密
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `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` |
+
+### 工具库
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `@vueuse/core` | `14.3.0` | core | 组合式工具 | 自动引入 |
+| `@vueuse/math` | `14.3.0` | core | 数学组合式 | |
+| `@vueuse/motion` | `3.0.3` | core | 入场动画 | `v-motion` |
+| `@pureadmin/utils` | `2.6.4` | core | 下载/存储/设备等 | |
+| `dayjs` | `1.11.21` | core | 日期 | 不用 moment |
+| `qs` | `6.15.3` | core | query 序列化 | + `@types/qs@6.15.1` |
+| `js-cookie` | `3.0.8` | core | Cookie | + `@types/js-cookie@3.0.6` |
+| `mitt` | `3.0.1` | core | 事件总线 | |
+| `chroma-js` | `3.2.0` | core | 颜色/主题 | + `@types/chroma-js@3.1.2` |
+| `address-parse` | `1.2.19` | addon | 中文地址解析 | 见 form-advanced |
+| `nprogress` | `0.2.0` | core | 路由进度条 | + `@types/nprogress@0.2.3` |
+| `responsive-storage` | `2.2.0` | core | 响应式 storage | |
+| `sortablejs` | `1.15.7` | core | 拖拽排序 | + `@types/sortablejs@1.15.9` |
+| `vue-dompurify-html` | `5.3.0` | core | 安全 HTML | |
+| `browser-image-compression` | `2.0.2` | addon | 上传前压缩 | 见 file-management |
+
+### 文件预览
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `@file-viewer/core` | `2.1.14` | addon | 预览核心 | 三件套同版本 |
+| `@file-viewer/vue3` | `2.1.14` | addon | Vue3 集成 | + `ReFileViewer` |
+| `@file-viewer/preset-all` | `2.1.14` | addon | 全格式预设 | |
+| `@file-viewer/vite-plugin` | `2.1.14` | addon | Vite 插件 | **devDependency**；见 file-management |
+
+### 二维码与条形码
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `qrcode` | `1.5.4` | addon | 二维码 | + `ReQrcode`；`@types/qrcode@1.5.6` |
+| `jsbarcode` | `3.12.3` | addon | 条形码 | + `ReBarcode` |
+
+### 验证与动画
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `vue3-puzzle-vcode` | `1.1.7` | addon | 滑块拼图 | + `ReVerify` |
+| `typeit` | `8.8.7` | addon | 打字机 | + `ReTypeit` |
+| `@tsparticles/slim` | `4.3.1` | core | 粒子 | 登录背景 |
+| `@tsparticles/vue3` | `4.3.1` | core | 粒子 Vue3 | |
+| `tippy.js` | `6.3.7` | core | Tooltip | |
+| `vue-tippy` | `6.7.1` | core | Tippy Vue 封装 | |
+
+### 微信 / 移动调试
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `weixin-js-sdk` | `1.6.5` | addon | 微信 JS-SDK | 见 wechat-js |
+| `vconsole` | `3.15.1` | addon | 移动调试台 | 见 mobile-h5 |
+| `vite-plugin-vconsole` | `2.1.1` | addon | vConsole Vite 插件 | **devDependency** |
+
+### 布局 / CSS
+
+| 库 | 版本 | scope | 用途 | 备注 |
+|---|---|---|---|---|
+| `grid-layout-plus` | `1.1.1` | addon | 拖拽网格 | 大屏/仪表盘 |
+| `unocss` | `66.7.4` | core | 原子化 CSS | 及相关 `@unocss/*` 同版本 |
+
+### 构建链路常用插件（core，一般勿随业务安装）
+
+| 库 | 版本 | 用途 |
+|---|---|---|
+| `vite` | `8.1.2` | 构建 |
+| `@vitejs/plugin-vue` | `6.0.7` | SFC |
+| `@vitejs/plugin-vue-jsx` | `5.1.6` | JSX |
+| `unplugin-auto-import` | `21.0.0` | 自动 API |
+| `unplugin-vue-components` | `32.1.0` | 自动组件 |
+| `@vant/auto-import-resolver` | `1.3.0` | Vant 解析（mobile 时需要） |
+| `vite-plugin-fake-server` | `2.2.4` | Mock（`VITE_USE_MOCK`） |
+| `vite-plugin-compression` | `0.5.1` | Gzip |
+| `rollup-plugin-visualizer` | `7.0.1` | 包分析 |
+| `vite-plugin-bundle-obfuscator` | `1.13.0` | 混淆 |
+| `vite-plugin-vue-devtools` | `8.1.5` | DevTools |
+| `vite-svg-loader` | `5.1.1` | SVG as component |
+| `vue` | `3.5.39` | 框架 |
+| `vue-i18n` | `11.4.6` | 国际化 |
+| `typescript` | `6.0.3` | 类型 |
+| `vue-tsc` | `3.3.6` | 类型检查 |
+
+---
+
+## 二、Re* 自定义组件清单
+
+> 所有自定义组件以 `Re` 为前缀。开发前先查本表，禁止重复造轮子。  
+> **用法**按功能模块写（见 `ui-components` 索引），本表只做名录 + 落点。
+
+| 组件 | 用途 | 目录 | 用法模块 |
+|---|---|---|---|
+| **ReAnchor** | 锚点导航 | `ReAnchor/` | `form-advanced` |
+| **ReAttachment** | 附件上传/管理 | `ReAttachment/` | `file-management` |
+| **ReAuth** | 权限包裹 | `ReAuth/` | `permission-auth` |
+| **ReAvatars** | 头像组 | `ReAvatars/` | 业务页 / `data-screen` |
+| **ReBarcode** | 条形码 | `ReBarcode/` | `qrcode-barcode` |
+| **ReCascader** | 级联选择 | `ReCascader/` | `form-advanced` |
+| **ReCheckCard** | 卡片多选 | `ReCheckCard/` | `form-advanced` |
+| **ReCollapsible** | 折叠 | `ReCollapsible/` | `form-advanced` |
+| **ReDatePicker** | 日期 | `ReDatePicker/` | `form-advanced` |
+| **ReDateRangePicker** | 日期范围 | `ReDateRangePicker/` | `form-advanced` |
+| **ReDialog** | 弹窗（`fullscreen` 默认 false） | `ReDialog/` | `form-advanced` |
+| **ReDialogResize** | 可缩放弹窗 | `ReDialogResize/` | `form-advanced` |
+| **ReDragVerify** | 滑块拖拽验证 | `ReDragVerify/` | `verify-captcha` |
+| **ReEchart** | ECharts 容器 | `ReEchart/` | `chart-echarts` |
+| **ReFileViewer** | 文件预览 | `ReFileViewer/` | `file-management` |
+| **ReFlicker** | 闪烁点 | `ReFlicker/` | `data-screen` |
+| **ReGrid** | 响应式栅格 | `ReGrid/` | `crud-pages` |
+| **ReGridItem** | 栅格子项 | `ReGridItem/` | `crud-pages` |
+| **ReHeaderPage** | 页头 | `ReHeaderPage/` | `crud-pages` / `detail-page` |
+| **ReIconPicker** | 图标选择 | `ReIconPicker/` | `icons` |
+| **ReImageVerify** | 图形验证码 | `ReImageVerify/` | `verify-captcha` |
+| **ReLanguageSwitch** | 语言切换 | `ReLanguageSwitch/` | `layout-theme` |
+| **ReNoticeBar** | 通知栏 | `ReNoticeBar/` | `feedback-loading` |
+| **RePagination** | 分页 | `RePagination/` | `crud-pages` |
+| **RePopupPicker** | 移动端弹出选择 | `RePopupPicker/` | `mobile-h5` |
+| **ReQrcode** | 二维码 | `ReQrcode/` | `qrcode-barcode` |
+| **ReRichText** | 富文本 | `ReRichText/` | `rich-text` |
+| **ReSeamlessScroll** | 无缝滚动 | `ReSeamlessScroll/` | `seamless-scroll` |
+| **ReSegmented** | 分段控制 | `ReSegmented/` | `layout-theme` |
+| **ReSelectQuery** | 远程分页选择 | `ReSelectQuery/` | `form-advanced` |
+| **ReSelectVant** | 移动端选择 | `ReSelectVant/` | `mobile-h5` |
+| **ReSmsCode** | 短信倒计时 | `ReSmsCode/` | `verify-captcha` |
+| **ReSvgIcon** | SVG / Iconify | `ReSvgIcon/` | `icons` |
+| **ReTableBar** | 表格工具栏 | `ReTableBar/` | `crud-pages` |
+| **ReTableOperate** | 行操作（`limit` 默认 3；超出进「更多」；列宽用 `resolveOperateColumnWidth`；`:size` 跟表格密度） | `ReTableOperate/` | `crud-pages` |
+| **ReText** | 文本省略 | `ReText/` | `layout-theme` |
+| **ReTimeLine** | 时间轴 | `ReTimeLine/` | `detail-page` / 业务 |
+| **ReTreeLine** | 树连线 | `ReTreeLine/` | `tree-table` |
+| **ReTypeit** | 打字机 | `ReTypeit/` | `data-screen` |
+| **ReVerify** | 拼图验证 | `ReVerify/` | `verify-captcha` |
+
+路径前缀均为 `src/components/`。
+
+---
+
+## 三、Hooks 清单
+
+> 所有 Hook 位于 `src/hooks/` 目录。开发新功能时必须先检查是否已有可复用的 Hook。
+
+| Hook | 用途 | 关键 API |
+|---|---|---|
+| **useApp** | 全局应用状态（布局、字典、登出等） | `baseCodeGet`、`filterValue`、`svgLoading`、`layout`、`logout` 等；顶栏高度不由此导出 |
+| **useDetail** | 列表→详情：写顶部 tag 并跳转 | `toDetail(name, params, title?, 'query'\|'params')`、`initToDetail(name)`、`getParameter`；路由配 `showLink:false`（不进侧栏）+`activePath`（见 `detail-page`） |
+| **useFormCheck** | 多表单校验聚合 | 追踪各字段校验状态，emit `form-validate` 事件 |
+| **useTableSearch** | 列表页搜索/分页/Loading/动态表高 | `content`（须绑 `el-card.vts-page-card`）、`multipleTableRef`（建议绑 `el-table`）、`otherRef`（表上方额外模块）、`tableHeight`（卡片底边 − 表格顶边 − 分页；空数据仍有占位高）、`paginationRef`、`tableData`、`pagination`、`loading`、`onSearch()`、`reset()`、`formRef`、`gridRef`、`collapsed` / `showCollapse` / `collapsedToggle` |
+| **useTags** | 多标签页管理 | 右键菜单（刷新/关闭/关闭其他/全屏） |
+| **useTheme** | 主题切换（暗色/亮色） | 主题色生成、布局预设、缓存重置 |
+| **useWebSocket** | WebSocket 通信 | `subscribe()`、`send()`、`sendRaw()`、`isConnected` |
+| **useWechat** | 微信 JS-SDK | `isReady`、`error` |
+
+---
+
+## 四、工具函数清单
+
+> 所有工具位于 `src/utils/` 目录。
+
+| 文件 | 关键导出 | 用途 |
+|---|---|---|
+| `auth.ts` | `getToken()`、`setUserToken()`、`removeToken()` | Token 管理 |
+| `autoUpdate.ts` | `checkUpdate()` | 前端版本检测/自动刷新 |
+| `changeSummaryService.ts` | `ChangeSummaryService.getChangeSummaryData()` | v-compare 变更汇总读取/元素引用修复 |
+| `encryptUtils.ts` | `aesEncrypt()`、`aesDecrypt()`、`rsaEncrypt()`、`md5Sign()` | 加解密工具 |
+| `http.ts` | `http.request()` | Axios 封装（支持 GET/POST + 加密开关 + 拦截器） |
+| `i18n.ts` | `getLocale()` | 语言检测 |
+| `imageCompression.ts` | `compressImage()` | 图片压缩（上传前） |
+| `message.ts` | `message()` | 消息提示封装（ElMessage 包装） |
+| `mitt.ts` | `mitt()` | 全局事件总线 |
+| `motion.tsx` | `MotionComponent` | 入场动画 TSX 组件 |
+| `particles.ts` | `particlesOptions` | 粒子动画配置（tsParticles v4 paint） |
+| `progress/` | `NProgress` | 路由进度条配置 |
+| `responsive.ts` | `ResponsiveStorage` | 响应式存储注入 |
+| `router.ts` | `hasAuth()`、路由扁平化、权限过滤 | 路由工具 |
+| `rule.ts` | `passwordRule`、`phoneRule` | 表单校验规则（PC） |
+| `tree.ts` | `handleTree()`、`buildHierarchyTree()` | 树结构转换 |
+| `uploadManager.ts` | `UploadManager` | 批量上传任务管理 |
+| `useActivity.ts` | `useActivity()` | 用户空闲检测/自动登出 |
+| `utils.ts` | `svgLoad()`、`composeOptions()`、`getRowClassByFlag()`、`escapeAttrSelector()`、`formatFileSize()` 等 | 通用工具（含对比辅助） |
+| `vantRules.ts` | `vantRules` | 表单校验规则（移动端 Vant） |
+| `websocket/` | `initWebSocket()`、`closeWebSocket()`、`WebSocketManager` | WebSocket 基础设施 |
+| `wechat/` | `WechatSDK` | 微信 SDK 单例 |
+
+---
+
+## 五、自定义指令清单
+
+> 所有指令位于 `src/directives/` 目录，在 `src/directives/index.ts` 统一注册。
+
+| 指令 | 用途 | 用法示例 |
+|---|---|---|
+| **v-auth** | 按钮级权限控制（无权限移除 DOM） | `v-auth="['btn.add']"` |
+| **v-auto-font** | 根据容器宽度自动缩放字体 | `v-auto-font:0.8` 或 `v-auto-font="{ scale: 0.8, min: 12, max: 24 }"` |
+| **v-compare** | 编辑页变更对比（高亮+汇总） | `v-compare:key="{ oldValue, title, label, enabled }"`；详见 data-compare |
+| **v-copy** | 复制文本到剪贴板 | `v-copy="text"`（双击）、`v-copy:click="text"`（单击） |
+
+---
+
+## 六、Store 模块清单
+
+> 所有 Store 位于 `src/store/modules/`，使用 `pinia-plugin-persistedstate` 持久化。
+
+| Store | 用途 | 关键状态/方法 |
+|---|---|---|
+| **useAppStore** | 应用全局状态 | 侧边栏、布局模式、设备类型 |
+| **useBaseCodeStore** | 字典/码表缓存 | 按 `codeType` 获取+缓存 |
+| **useCompareStore** | 变更对比追踪 | `addOrUpdateRecord` / `clearAllRecords`；按 title 模块分组 |
+| **useLangStore** | 语言设置 | 持久化到 localStorage + cookie |
+| **useMultiTagsStore** | 多标签页 | 标签增删排序 |
+| **useRouterMenuStore** | 路由/菜单 | 静态+动态菜单、keepAlive 缓存 |
+| **useSettingStore** | UI 设置 | 标题、固定头部、侧边栏显隐 |
+| **useThemeStore** | 主题 | 主题色、暗色模式 |
+| **useUserStore** | 用户信息 | userCode、userName、角色、token |
+
+---
+
+## 七、功能选型对照表（禁止替换）
+
+> 当用户需求涉及以下场景时，**必须使用选型表指定的库/组件**；勿擅自换成同类其他库，新依赖须待确认。
+
+| 需求场景 | 项目选型 | 勿擅自替换为 |
+|---|---|---|
+| 图表 | `echarts` + `ReEchart` | 禁止使用 Chart.js / D3 / Plotly 等 |
+| 关系/知识图谱 | `relation-graph-vue3` | 禁止引入 D3 / vis.js / Cytoscape 等 |
+| 流程图 | `@antv/g6` + `g6-extension-vue` | 禁止引入 Mermaid / X6 / LogicFlow 等 |
+| BPMN 工作流 | `bpmn-js` (Viewer) | 禁止引入其他 BPMN 库 |
+| 字段映射/连线 | `jsplumb` | 禁止引入 LeaderLine / Drawflow 等 |
+| 富文本编辑器 | `@wangeditor/editor` + `ReRichText` | 禁止引入 Quill / TinyMCE / CKEditor 等 |
+| 二维码 | `qrcode` + `ReQrcode` | 禁止引入其他二维码库 |
+| 条形码 | `jsbarcode` + `ReBarcode` | 禁止引入其他条形码库 |
+| 文件预览 | `@file-viewer/*` + `ReFileViewer` | 禁止引入 pdf.js / mammoth 等 |
+| 滑块验证 | `vue3-puzzle-vcode` + `ReVerify` | 禁止引入其他验证码库 |
+| 打字机动画 | `typeit` + `ReTypeit` | 禁止引入其他打字机库 |
+| 粒子动画 | `@tsparticles/slim` + `@tsparticles/vue3` + `particlesOptions` | 禁止引入 particles.js 等；配置见 `particles` 模块 |
+| 日期处理 | `dayjs` | 禁止引入 moment / date-fns 等 |
+| HTTP 请求 | 项目封装的 `src/utils/http.ts`（基于 axios） | 禁止直接使用 axios / fetch / ky 等 |
+| 状态管理 | `pinia` + `pinia-plugin-persistedstate` | 禁止引入 vuex / zustand 等 |
+| 原子化 CSS | `unocss` | 禁止引入 tailwindcss / windicss 等 |
+| 拖拽排序 | `sortablejs` | 禁止引入 vuedraggable / dnd-kit 等 |
+| 微信集成 | `weixin-js-sdk` + `useWechat` | 禁止引入其他微信 SDK |
+| 高性能表格 | `vxe-table` | 禁止引入 ag-grid / handsontable 等 |
+| 地址解析 | `address-parse` | 禁止引入其他地址解析库 |
+| 图片压缩 | `browser-image-compression` | 禁止引入其他压缩库 |
+| 颜色处理 | `chroma-js` | 禁止引入 color / polished 等 |
+| 事件总线 | `mitt`（项目封装 `src/utils/mitt.ts`） | 禁止引入 eventemitter3 等 |
+| 编辑页数据变更对比 | `v-compare` + `useCompareStore` + `ChangeSummaryService` / `ChangeSummaryDialog` | 禁止自研 Diff 组件树或第三方 diff UI；按 data-compare 模块 |
+
+---
+
+## 八、使用规则
+
+1. **先查后写**：生成任何功能代码前，必须先在本清单中查找是否已有对应的库/组件/Hook/工具
+2. **有则必用**：已有封装直接复用，勿另起一套同能力实现；选型表指定库勿擅自替换
+3. **无则上报**：如果确实需要引入新库（清单中没有），必须在输出中明确说明原因，并标注为"待确认"让用户审批
+4. **按示例编写**：以对应 Skill 模块 `references/<模块>.md` 完整示例与约定写法为准
+5. **版本一致**：使用库的版本必须与清单中**精确版本**一致，不得擅自升降级，不得 `pnpm add xxx` 不带版本
+6. **缺依赖先装**：命中 addon 模块时，先读业务项目 `package.json`；缺失则按第九节安装命令征得确认后执行，再生成业务代码
+7. **Vite 插件成套**：涉及 `@file-viewer/vite-plugin`、`vite-plugin-vconsole` 等时，运行时包与 `-D` 插件、以及仓库内 `build/plugins/*` 接线一并检查；模板已接线则勿改 `vite.config`；裁剪缺失时需恢复对应插件文件后再装依赖
+8. **已移除依赖（勿再推荐）**：`@wocwin/t-ui-plus`、`animate.css`、`version-rocket`、`vue-types`、`vite-plugin-remove-console`、`vite-plugin-router-warn`；发版检测用 `utils/autoUpdate`；去 console 用构建 Terser
+
+---
+
+## 九、专项能力依赖安装表（addon）
+
+> **何时用**：目标项目需要专项能力、但当前 `package.json` 中找不到对应包时。参考模板已包含的能力也必须以目标项目实际依赖为准。
+> **包管理**：统一 `pnpm`。`-D` 表示写入 `devDependencies`。  
+> **AI 流程**：① 查目标项目 `package.json` 与构建接线 → ② 列出缺失包及影响 → ③ 展示精确安装命令并征得确认 → ④ 执行安装 → ⑤ 仅在目标项目确有对应排除项或构建占位时，按 `addon-enable.md` 对应章节恢复配置 → ⑥ 再写业务代码。
+
+| Skill 模块 | 生产依赖（精确版本） | 开发依赖（精确版本） | 构建/接线附属 | 一键安装命令 |
+|---|---|---|---|---|
+| **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 包（用项目封装） | — | 见各模块 | 无需安装 |
+
+### 安装输出模板（AI 对用户）
+
+```text
+检测到以下依赖缺失（对齐模板锁定版本）：
+- xxx@a.b.c
+拟执行：
+  pnpm add ...
+  pnpm add -D ...
+涉及构建插件时还需确认：build/plugins/Xxx.ts 是否仍在。
+是否确认安装？
+```
+
+未经用户确认**不得**擅自改 `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：通过
+```