chore: chore lint

Author: wkylin

.gitignore

@@ -31,3 +31,14 @@ storybook-static
 /dist-zip
 /playwright-report
 /test-results
+
+# 一次性报告输出（避免误提交）
+/npm-audit*.json
+/depcheck-full.json
+
+# 本地浏览器报告（非项目产物）
+/chromewebdata_*.report.html
+
+# 路由权限扫描报告（脚本生成产物）
+/scripts/route-permission-report.json
+/scripts/route-permission-suggested.json

.markdownlint.json

@@ -2,5 +2,9 @@
   "default": true,
   "no-hard-tabs": false,
   "whitespace": false,
-  "line-length": false
+  "line-length": false,
+
+  "MD033": false,
+  "MD041": false,
+  "MD060": false
 }

.markdownlintignore

@@ -0,0 +1,3 @@
+# CHANGELOG.md is generated by conventional-changelog / standard-version
+# and doesn't follow markdownlint heading/duplicate-heading rules.
+CHANGELOG.md

.storybook/preview.tsx

@@ -1,10 +1,10 @@
 // .storybook/preview.tsx
-import React, { Suspense } from 'react';
-import type { Preview } from '@storybook/react'; // 注意：Vite 版本用 @storybook/react
-import { MemoryRouter } from 'react-router-dom';
-import { I18nextProvider } from 'react-i18next';
+import React, { Suspense } from 'react'
+import type { Preview } from '@storybook/react' // 注意：Vite 版本用 @storybook/react
+import { MemoryRouter } from 'react-router-dom'
+import { I18nextProvider } from 'react-i18next'
 
-import i18n from '../src/i18n/i18n';
+import i18n from '../src/i18n/i18n'
 
 const preview: Preview = {
   decorators: [
@@ -39,6 +39,6 @@ const preview: Preview = {
       },
     },
   },
-};
+}
 
-export default preview;
+export default preview

CHANGELOG.md

@@ -4,71 +4,65 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [3.3.1](https://github.com/wkylin/pro-react-admin/compare/v3.3.0...v3.3.1) (2025-12-23)
 
-
 ### Bug Fixes
 
-* fix vite storybook ([077e064](https://github.com/wkylin/pro-react-admin/commits/077e064186c145b2e1f15c431188a1d2772bfd94))
+- fix vite storybook ([077e064](https://github.com/wkylin/pro-react-admin/commits/077e064186c145b2e1f15c431188a1d2772bfd94))
 
 ## [3.3.0](https://github.com/wkylin/pro-react-admin/compare/v3.2.0...v3.3.0) (2025-12-22)
 
-
 ### Features
 
-* i18n key ([3d6e6be](https://github.com/wkylin/pro-react-admin/commits/3d6e6bed827881ca52e8f133b3cba49519704eba))
+- i18n key ([3d6e6be](https://github.com/wkylin/pro-react-admin/commits/3d6e6bed827881ca52e8f133b3cba49519704eba))
 
 ## [3.2.0](https://github.com/wkylin/pro-react-admin/compare/v3.1.0...v3.2.0) (2025-12-22)
 
 ## [3.1.0](https://github.com/wkylin/pro-react-admin/compare/v3.0.0...v3.1.0) (2025-12-22)
 
-
 ### Features
 
-* storybook stories ([cb31b5c](https://github.com/wkylin/pro-react-admin/commits/cb31b5c491b1db671989c868f3584875d18c06a7))
-* storybook update ([f1cfa0f](https://github.com/wkylin/pro-react-admin/commits/f1cfa0f3a188d9bcda9cf562a05576bc942d5b2d))
-* video ([baeb1e4](https://github.com/wkylin/pro-react-admin/commits/baeb1e4e31b31cf8de0f2d29d76a1d931b89d07e))
-* video layout ([3aee6e5](https://github.com/wkylin/pro-react-admin/commits/3aee6e5a0c328187954b3596c8848eabc7a0dbee))
-* video list ([f984183](https://github.com/wkylin/pro-react-admin/commits/f984183432054cfece06bf4b0e1155a221af383a))
-* video update ([b0e5d86](https://github.com/wkylin/pro-react-admin/commits/b0e5d865f5359cd28d12803ac7588d96fbf7cc8d))
-* video update ([e044e8c](https://github.com/wkylin/pro-react-admin/commits/e044e8cb23dbc1c90e7f47449df4fbd6947fe2c7))
-* video update ([40757b4](https://github.com/wkylin/pro-react-admin/commits/40757b47bd97215a38ac207a11ab18002f926283))
-* video update ([e414aaa](https://github.com/wkylin/pro-react-admin/commits/e414aaa37cd5fbdbf75720d84ed26d10e3016840))
-
+- storybook stories ([cb31b5c](https://github.com/wkylin/pro-react-admin/commits/cb31b5c491b1db671989c868f3584875d18c06a7))
+- storybook update ([f1cfa0f](https://github.com/wkylin/pro-react-admin/commits/f1cfa0f3a188d9bcda9cf562a05576bc942d5b2d))
+- video ([baeb1e4](https://github.com/wkylin/pro-react-admin/commits/baeb1e4e31b31cf8de0f2d29d76a1d931b89d07e))
+- video layout ([3aee6e5](https://github.com/wkylin/pro-react-admin/commits/3aee6e5a0c328187954b3596c8848eabc7a0dbee))
+- video list ([f984183](https://github.com/wkylin/pro-react-admin/commits/f984183432054cfece06bf4b0e1155a221af383a))
+- video update ([b0e5d86](https://github.com/wkylin/pro-react-admin/commits/b0e5d865f5359cd28d12803ac7588d96fbf7cc8d))
+- video update ([e044e8c](https://github.com/wkylin/pro-react-admin/commits/e044e8cb23dbc1c90e7f47449df4fbd6947fe2c7))
+- video update ([40757b4](https://github.com/wkylin/pro-react-admin/commits/40757b47bd97215a38ac207a11ab18002f926283))
+- video update ([e414aaa](https://github.com/wkylin/pro-react-admin/commits/e414aaa37cd5fbdbf75720d84ed26d10e3016840))
 
 ### Bug Fixes
 
-* fix video error ([dcb60d7](https://github.com/wkylin/pro-react-admin/commits/dcb60d751d6f05ea9025ea8977bf4c39f2ffee49))
+- fix video error ([dcb60d7](https://github.com/wkylin/pro-react-admin/commits/dcb60d751d6f05ea9025ea8977bf4c39f2ffee49))
 
 ## [3.0.0](https://github.com/wkylin/pro-react-admin/compare/v2.2.0...v3.0.0) (2025-12-19)
 
-
 ### Features
 
-* 构建lib瘦身 ([0020efa](https://github.com/wkylin/pro-react-admin/commits/0020efaa8866af931b191a081fbcda4c4fb6d36a))
-* 权限集中 ([1c98b23](https://github.com/wkylin/pro-react-admin/commits/1c98b238e992fb3b484466662d26a37ecba207c3))
-* 权限示例 ([615d78e](https://github.com/wkylin/pro-react-admin/commits/615d78e0c9ee4a1af8b5fb3f85c358ceae8ce6fa))
-* error boundary error tip ([0e19ca3](https://github.com/wkylin/pro-react-admin/commits/0e19ca3b4a2e5d7c9537aad5c10330571651e0a5))
-* fix panel scroll ([0986434](https://github.com/wkylin/pro-react-admin/commits/098643425955bd73e18324b3a161d04a49e401cc))
-* gpt mermaid ([500a5b7](https://github.com/wkylin/pro-react-admin/commits/500a5b7aac856ac98e071892ce716368527880d9))
-* gpt mermaid markmap ([4eaf2dc](https://github.com/wkylin/pro-react-admin/commits/4eaf2dccf37238e345450b02491d8598000739d0))
-* motion ([d5366db](https://github.com/wkylin/pro-react-admin/commits/d5366dbc0c8ba15a04861259f8da576c3df5e9f8))
-* motion ([f45b5d4](https://github.com/wkylin/pro-react-admin/commits/f45b5d407bfa16e3b071eda4eddfb33b5cf39164))
-* motion scrollbar ([7caf879](https://github.com/wkylin/pro-react-admin/commits/7caf879922b00eb82eb20528346092bb6c256afa))
-* one time passcode ([4a14586](https://github.com/wkylin/pro-react-admin/commits/4a14586b04fb22c27eb5c98b027f4e23505d391a))
-* perf sonarqube ([0f210df](https://github.com/wkylin/pro-react-admin/commits/0f210df5819abce917c9581f03a815d233e6936e))
-* permission ([8990e94](https://github.com/wkylin/pro-react-admin/commits/8990e949c0b2dfdc6fd426a54cb57edaf13b6abd))
-* sentry ([f24e277](https://github.com/wkylin/pro-react-admin/commits/f24e27736eedfe431a9c2160947eed0f5a171069))
-* topology ([429c10e](https://github.com/wkylin/pro-react-admin/commits/429c10e0f252670407e4476368374049fc12ee26))
-* topology dashed flowing ([c8c8b96](https://github.com/wkylin/pro-react-admin/commits/c8c8b9675a2d4652e2fcc70e3ecd8078797530a8))
-* ui perf ([69d7fc9](https://github.com/wkylin/pro-react-admin/commits/69d7fc9d0cc91ddd080484c7709c4a6a51986c7b))
-
+- 构建lib瘦身 ([0020efa](https://github.com/wkylin/pro-react-admin/commits/0020efaa8866af931b191a081fbcda4c4fb6d36a))
+- 权限集中 ([1c98b23](https://github.com/wkylin/pro-react-admin/commits/1c98b238e992fb3b484466662d26a37ecba207c3))
+- 权限示例 ([615d78e](https://github.com/wkylin/pro-react-admin/commits/615d78e0c9ee4a1af8b5fb3f85c358ceae8ce6fa))
+- error boundary error tip ([0e19ca3](https://github.com/wkylin/pro-react-admin/commits/0e19ca3b4a2e5d7c9537aad5c10330571651e0a5))
+- fix panel scroll ([0986434](https://github.com/wkylin/pro-react-admin/commits/098643425955bd73e18324b3a161d04a49e401cc))
+- gpt mermaid ([500a5b7](https://github.com/wkylin/pro-react-admin/commits/500a5b7aac856ac98e071892ce716368527880d9))
+- gpt mermaid markmap ([4eaf2dc](https://github.com/wkylin/pro-react-admin/commits/4eaf2dccf37238e345450b02491d8598000739d0))
+- motion ([d5366db](https://github.com/wkylin/pro-react-admin/commits/d5366dbc0c8ba15a04861259f8da576c3df5e9f8))
+- motion ([f45b5d4](https://github.com/wkylin/pro-react-admin/commits/f45b5d407bfa16e3b071eda4eddfb33b5cf39164))
+- motion scrollbar ([7caf879](https://github.com/wkylin/pro-react-admin/commits/7caf879922b00eb82eb20528346092bb6c256afa))
+- one time passcode ([4a14586](https://github.com/wkylin/pro-react-admin/commits/4a14586b04fb22c27eb5c98b027f4e23505d391a))
+- perf sonarqube ([0f210df](https://github.com/wkylin/pro-react-admin/commits/0f210df5819abce917c9581f03a815d233e6936e))
+- permission ([8990e94](https://github.com/wkylin/pro-react-admin/commits/8990e949c0b2dfdc6fd426a54cb57edaf13b6abd))
+- sentry ([f24e277](https://github.com/wkylin/pro-react-admin/commits/f24e27736eedfe431a9c2160947eed0f5a171069))
+- topology ([429c10e](https://github.com/wkylin/pro-react-admin/commits/429c10e0f252670407e4476368374049fc12ee26))
+- topology dashed flowing ([c8c8b96](https://github.com/wkylin/pro-react-admin/commits/c8c8b9675a2d4652e2fcc70e3ecd8078797530a8))
+- ui perf ([69d7fc9](https://github.com/wkylin/pro-react-admin/commits/69d7fc9d0cc91ddd080484c7709c4a6a51986c7b))
 
 ### Bug Fixes
 
-* bug fix ([f3f5e09](https://github.com/wkylin/pro-react-admin/commits/f3f5e09e819b7376f01118b7662ba3ea9a259af9))
-* Cannot convert undefined or null to object ([796a3a0](https://github.com/wkylin/pro-react-admin/commits/796a3a05118e453e4452e045fc125ab842eae718))
-* fix dependencier ([61449b4](https://github.com/wkylin/pro-react-admin/commits/61449b429647c3e4d5854ce347899fe556cf8870))
-* fix sonaqube ([d5de247](https://github.com/wkylin/pro-react-admin/commits/d5de24760acf8991bee92e2966d68f697fced8b1))
-* fix sonarqube ([303b683](https://github.com/wkylin/pro-react-admin/commits/303b6837da3cee2453ba4c197afec274a41879e3))
+- bug fix ([f3f5e09](https://github.com/wkylin/pro-react-admin/commits/f3f5e09e819b7376f01118b7662ba3ea9a259af9))
+- Cannot convert undefined or null to object ([796a3a0](https://github.com/wkylin/pro-react-admin/commits/796a3a05118e453e4452e045fc125ab842eae718))
+- fix dependencier ([61449b4](https://github.com/wkylin/pro-react-admin/commits/61449b429647c3e4d5854ce347899fe556cf8870))
+- fix sonaqube ([d5de247](https://github.com/wkylin/pro-react-admin/commits/d5de24760acf8991bee92e2966d68f697fced8b1))
+- fix sonarqube ([303b683](https://github.com/wkylin/pro-react-admin/commits/303b6837da3cee2453ba4c197afec274a41879e3))
 
 # [2.2.0](https://github.com/wkylin/pro-react-admin/compare/v2.1.1...v2.2.0) (2025-12-05)
 

NPM_README.md

@@ -53,13 +53,13 @@ export default App
 - **主包单入口**：`@w.ui/wui-react`（向后兼容，导出聚合）
 - **子路径多入口**：`@w.ui/wui-react/core | /stateful | /stateless`（更细粒度 tree-shaking）
 
-| 源入口（源码） | 使用方 import 路径 | 对应产物（发布后） |
-|---|---|---|
-| `src/lib/index.ts` | `@w.ui/wui-react` | `pro-react-components.es.js` / `pro-react-components.umd.js` / `index.d.ts` |
-| `src/lib/core.ts` | `@w.ui/wui-react/core` | `entries/core.es.js` / `entries/core.cjs.js` / `entries/core.d.ts` |
-| `src/lib/stateful.ts` | `@w.ui/wui-react/stateful` | `entries/stateful.es.js` / `entries/stateful.cjs.js` / `entries/stateful.d.ts` |
+| 源入口（源码）         | 使用方 import 路径          | 对应产物（发布后）                                                                |
+| ---------------------- | --------------------------- | --------------------------------------------------------------------------------- |
+| `src/lib/index.ts`     | `@w.ui/wui-react`           | `pro-react-components.es.js` / `pro-react-components.umd.js` / `index.d.ts`       |
+| `src/lib/core.ts`      | `@w.ui/wui-react/core`      | `entries/core.es.js` / `entries/core.cjs.js` / `entries/core.d.ts`                |
+| `src/lib/stateful.ts`  | `@w.ui/wui-react/stateful`  | `entries/stateful.es.js` / `entries/stateful.cjs.js` / `entries/stateful.d.ts`    |
 | `src/lib/stateless.ts` | `@w.ui/wui-react/stateless` | `entries/stateless.es.js` / `entries/stateless.cjs.js` / `entries/stateless.d.ts` |
-|（样式）| `@w.ui/wui-react/style.css` | `style.css` |
+| （样式）               | `@w.ui/wui-react/style.css` | `style.css`                                                                       |
 
 ### 子路径按需导入示例
 
@@ -166,10 +166,8 @@ MIT © [wkylin](https://github.com/wkylin)
 
 ## 👨‍💻 作者
 
-**wkylin**
-
 - GitHub: [@wkylin](https://github.com/wkylin)
-- Email: wkylin.w@gmail.com
+- Email: <wkylin.w@gmail.com>
 
 ## ⭐️ Star History
 

README.md

@@ -45,7 +45,7 @@
 - 📚 **组件文档库**：集成 Storybook，提供 120+ 组件的交互式文档与预览，支持 Props 动态调试与独立测试。
 - 📡 **健壮请求层**：封装统一请求库，支持并发控制、自动重试、取消重复请求、全局错误处理与消息去重。
 - 👤 **登录/注册流程**：完整的登录鉴权流程，支持一键测试账号切换，实时同步权限状态。
-- 📊 **数据可视化**：集成 ECharts、D3.js、Recharts 等多种图表库，支持大数据量展示。
+- 📊 **数据可视化**：集成 ECharts、Recharts 等多种图表库，支持大数据量展示。
 - 📝 **富文本与文档**：支持 Markdown 实时渲染与编辑、代码高亮、数学公式解析。
 - 🎬 **多媒体支持**：内置音频/视频播放器，支持 Tab 切换自动暂停/恢复播放，优化资源占用。
 - 🌍 **主题与国际化**：内置明亮/暗黑模式一键切换，支持多语言（i18n）动态切换。
@@ -109,6 +109,8 @@ npm install
 npm run dev
 ```
 
+提示：运行 `npm run lighthouse` 前请先启动 dev server（例如先执行 `npm run dev`/`npm run start`）。
+
 更多用法详见 [详细文档](./docs/README_PERMISSION.md) 与 [用户角色权限说明](./docs/USER_ROLE_PERMISSION.md)。
 
 ---