1

README.md

@@ -23,6 +23,7 @@
 | 文件 | 说明 |
 |------|------|
 | `admin-framework.js` | **UMD**，Terser 压缩，对外默认导出为框架单例；浏览器中为 `window.AdminFramework`，也可由 Webpack 等从该文件解析 `import` |
+| `admin-framework.md` | 与根目录 `README.md` 内容相同，随 `npm run build` 一并复制到 `dist/`，便于随包分发使用说明 |
 
 在项目根目录执行：
 

webpack.config.js

@@ -1,6 +1,25 @@
-
+const fs = require('fs')
 const path = require('path')
 const webpack = require('webpack')
+
+/** 构建完成后将根目录 README.md 复制为 dist/admin-framework.md */
+function copyReadmeToDistPlugin() {
+  return {
+    apply(compiler) {
+      compiler.hooks.afterEmit.tap('CopyReadmeToDist', () => {
+        const src = path.join(__dirname, 'README.md')
+        const dest = path.join(compiler.options.output.path, 'admin-framework.md')
+        try {
+          if (fs.existsSync(src)) {
+            fs.copyFileSync(src, dest)
+          }
+        } catch (e) {
+          console.warn('[webpack] 复制 README.md -> dist/admin-framework.md 失败:', e.message)
+        }
+      })
+    }
+  }
+}
 const { VueLoaderPlugin } = require('vue-loader')
 const TerserPlugin = require('terser-webpack-plugin')
 
@@ -142,6 +161,7 @@ module.exports = {
   },
   plugins: [
     new VueLoaderPlugin(),
+    copyReadmeToDistPlugin(),
     new webpack.BannerPlugin({
       banner: () => {
         const now = new Date()