@4399ywkf/cli 1.0.7 → 1.0.9

package/dist/templates/app/config/rspack/rspack.config.mjs

@@ -1,16 +1,16 @@
-import { defineConfig } from '@rspack/cli';
-import { rspack } from '@rspack/core';
-import path from './paths.js';
-import fs from 'fs';
-import { RsdoctorRspackPlugin } from '@rsdoctor/rspack-plugin';
-import dotenv from 'dotenv';
-import { createRequire } from 'module';
+import { defineConfig } from "@rspack/cli";
+import { rspack } from "@rspack/core";
+import path from "./paths.js";
+import fs from "fs";
+import { RsdoctorRspackPlugin } from "@rsdoctor/rspack-plugin";
+import dotenv from "dotenv";
+import { createRequire } from "module";
 
 // 创建 require 函数用于 require.resolve
 const require = createRequire(import.meta.url);
 
 // 复用现有的环境变量加载逻辑
-dotenv.config({ path: path.resolveApp('./config/env/.env.public') });
+dotenv.config({ path: path.resolveApp("./config/env/.env.public") });
 
 let extraConfig = {};
 try {
@@ -19,40 +19,41 @@ try {
     extraConfig = dotenv.parse(fs.readFileSync(envFile));
   }
 } catch (error) {
-  console.warn('环境变量文件读取失败:', error.message);
+  console.warn("环境变量文件读取失败:", error.message);
 }
 
 for (const key in extraConfig) {
   process.env[key] = extraConfig[key];
 }
 
-const APP_CNAME = process.env.APP_CNAME || 'Chat应用';
-const APP_NAME = process.env.APP_NAME || 'chat';
-const OUTPUT_PATH = process.env.OUTPUT_PATH || 'dist';
-const PUBLIC_PATH = process.env.PUBLIC_PATH || '/';
+const APP_CNAME = process.env.APP_CNAME || "Chat应用";
+const APP_NAME = process.env.APP_NAME || "chat";
+const OUTPUT_PATH = process.env.OUTPUT_PATH || "dist";
+const PUBLIC_PATH = process.env.PUBLIC_PATH || "/";
 
 export default defineConfig({
-  entry: [path.resolveApp('./src/index')],
+  entry: [path.resolveApp("./src/index")],
 
   resolve: {
-    extensions: ['.ts', '.tsx', '.jsx', '.js', '.json'],
+    extensions: [".ts", ".tsx", ".jsx", ".js", ".json"],
     alias: {
-      '@': path.resolveApp('./src'),
-      '@config': path.resolveApp('./config'),
-      '@store': path.resolveApp('./store'),
-      '@locales': path.resolveApp('./locales'),
+      "@": path.resolveApp("./src"),
+      "@config": path.resolveApp("./config"),
+      "@store": path.resolveApp("./store"),
+      "@locales": path.resolveApp("./locales"),
+      "@public": path.resolveApp("./public"),
     },
     fallback: {
-      path: require.resolve('path-browserify'),
-      process: require.resolve('process/browser.js'),
-      buffer: require.resolve('buffer'),
-      util: require.resolve('util'),
-      stream: require.resolve('stream-browserify'),
-      crypto: require.resolve('crypto-browserify'),
-      zlib: require.resolve('browserify-zlib'),
-      querystring: require.resolve('querystring-es3'),
-      url: require.resolve('url'),
-      assert: require.resolve('assert'),
+      path: require.resolve("path-browserify"),
+      process: require.resolve("process/browser.js"),
+      buffer: require.resolve("buffer"),
+      util: require.resolve("util"),
+      stream: require.resolve("stream-browserify"),
+      crypto: require.resolve("crypto-browserify"),
+      zlib: require.resolve("browserify-zlib"),
+      querystring: require.resolve("querystring-es3"),
+      url: require.resolve("url"),
+      assert: require.resolve("assert"),
       fs: false,
       net: false,
       tls: false,
@@ -67,28 +68,28 @@ export default defineConfig({
       {
         test: /\.[jt]sx?$/,
         include: [
-          path.resolveApp('src'),
-          path.resolveApp('config'),
-          path.resolveApp('store'),
-          path.resolveApp('packages'),
+          path.resolveApp("src"),
+          path.resolveApp("config"),
+          path.resolveApp("store"),
+          path.resolveApp("packages"),
         ],
-        exclude: [path.resolveApp('node_modules')],
+        exclude: [path.resolveApp("node_modules")],
         use: [
           {
-            loader: 'builtin:swc-loader',
+            loader: "builtin:swc-loader",
             options: {
               jsc: {
                 parser: {
-                  syntax: 'typescript',
+                  syntax: "typescript",
                   tsx: true,
                   decorators: true,
                 },
                 transform: {
                   react: {
-                    runtime: 'automatic',
+                    runtime: "automatic",
                   },
                 },
-                target: 'es2015',
+                target: "es2015",
               },
               sourceMaps: true,
             },
@@ -96,10 +97,10 @@ export default defineConfig({
         ],
       },
       {
-        test: /\.(png|jpg|jpeg|gif|webp|m3u8|exr|hdr|json)$/,
-        include: [path.resolveApp('config')],
-        exclude: [path.resolveApp('src'), path.resolveApp('store')],
-        type: 'asset',
+        test: /\.(png|jpg|jpeg|gif|webp|m3u8|exr|hdr|json|woff2)$/,
+        include: [path.resolveApp("public")],
+        exclude: [path.resolveApp("src"), path.resolveApp("store")],
+        type: "asset",
         parser: {
           dataUrlCondition: {
             maxSize: 10 * 1024,
@@ -107,33 +108,33 @@ export default defineConfig({
         },
       },
       {
-        test: /\.md$/,
-        include: [path.resolveApp('src')],
-        type: 'asset/source',
+        test: /\.(md)$/,
+        include: [path.resolveApp("src")],
+        type: "asset/source",
       },
       {
         test: /\.svg$/,
-        use: ['@svgr/webpack'],
+        use: ["@svgr/webpack"],
       },
     ],
   },
 
   plugins: [
     new rspack.ProvidePlugin({
-      process: 'process/browser.js',
-      Buffer: ['buffer', 'Buffer'],
+      process: "process/browser.js",
+      Buffer: ["buffer", "Buffer"],
     }),
     new rspack.DefinePlugin({
-      'process.env': JSON.stringify(process.env),
+      "process.env": JSON.stringify(process.env),
       // ["__CONVENTION_ROUTES__"]: JSON.stringify([]),
     }),
     new rspack.HtmlRspackPlugin({
-      template: path.resolveApp('./config/public/index.html'),
-      filename: 'index.html',
-      inject: 'body',
+      template: path.resolveApp("./public/index.html"),
+      filename: "index.html",
+      inject: "body",
       hash: true,
-      minify: process.env.NODE_ENV === 'production',
-      favicon: path.resolveApp('./config/public/favicon.ico'),
+      minify: process.env.NODE_ENV === "production",
+      favicon: path.resolveApp("./public/favicon.ico"),
       templateParameters: {
         title: APP_CNAME,
         mountRoot: APP_NAME,
@@ -142,8 +143,8 @@ export default defineConfig({
     new rspack.CopyRspackPlugin({
       patterns: [
         {
-          from: path.resolveApp('./config/public/images'),
-          to: 'public/images',
+          from: path.resolveApp("./public/images"),
+          to: "public/images",
         },
       ],
     }),
@@ -165,11 +166,11 @@ export default defineConfig({
   ],
 
   output: {
-    assetModuleFilename: 'images/[hash][ext]',
+    assetModuleFilename: "images/[hash][ext]",
     library: `${APP_CNAME}-[name]`,
-    chunkFilename: '[name].[contenthash].js',
-    libraryTarget: 'umd',
-    globalObject: 'window',
+    chunkFilename: "[name].[contenthash].js",
+    libraryTarget: "umd",
+    globalObject: "window",
     chunkLoadingGlobal: `chunk_global_${APP_NAME}`,
     publicPath: PUBLIC_PATH,
     path: path.resolveApp(OUTPUT_PATH),
@@ -182,5 +183,5 @@ export default defineConfig({
     },
   ],
 
-  devtool: 'source-map',
+  devtool: "source-map",
 });

package/dist/templates/app/config/rspack/rspack.prod.mjs

@@ -1,17 +1,15 @@
-import { defineConfig } from '@rspack/cli';
-import { merge } from 'webpack-merge';
-import { rspack } from '@rspack/core';
-import baseConfig from './rspack.config.mjs';
-import path from './paths.js';
-import { sentryWebpackPlugin } from '@sentry/webpack-plugin';
+import { merge } from "webpack-merge";
+import { rspack } from "@rspack/core";
+import baseConfig from "./rspack.config.mjs";
+import path from "./paths.js";
 
 export default merge(baseConfig, {
-  mode: 'production',
-  devtool: 'hidden-source-map',
+  mode: "production",
+  devtool: "hidden-source-map",
 
   output: {
-    filename: '[name].[contenthash].bundle.js',
-    chunkFilename: '[name].[contenthash].chunk.js',
+    filename: "[name].[contenthash].bundle.js",
+    chunkFilename: "[name].[contenthash].chunk.js",
     clean: true,
   },
 
@@ -29,18 +27,18 @@ export default merge(baseConfig, {
             loader: rspack.CssExtractRspackPlugin.loader,
           },
           {
-            loader: 'css-loader',
+            loader: "css-loader",
             options: {
               sourceMap: true,
             },
           },
           {
-            loader: 'less-loader',
+            loader: "less-loader",
             options: {
               sourceMap: true,
               lessOptions: {
                 strictMath: false,
-                math: 'always',
+                math: "always",
                 javascriptEnabled: true,
               },
             },
@@ -50,8 +48,8 @@ export default merge(baseConfig, {
       // Less 处理 - 项目文件
       {
         test: /\.less$/,
-        include: [path.resolveApp('src')],
-        exclude: [path.resolveApp('node_modules')],
+        include: [path.resolveApp("src")],
+        exclude: [path.resolveApp("node_modules")],
         oneOf: [
           {
             test: /\.module\.less$/,
@@ -60,17 +58,17 @@ export default merge(baseConfig, {
                 loader: rspack.CssExtractRspackPlugin.loader,
               },
               {
-                loader: 'css-loader',
+                loader: "css-loader",
                 options: {
                   sourceMap: true,
                   modules: {
-                    localIdentName: '[path][name]__[local]--[hash:base64:5]',
+                    localIdentName: "[path][name]__[local]--[hash:base64:5]",
                   },
                   importLoaders: 2,
                 },
               },
               {
-                loader: 'less-loader',
+                loader: "less-loader",
                 options: {
                   sourceMap: true,
                   lessOptions: {
@@ -86,13 +84,13 @@ export default merge(baseConfig, {
                 loader: rspack.CssExtractRspackPlugin.loader,
               },
               {
-                loader: 'css-loader',
+                loader: "css-loader",
                 options: {
                   sourceMap: true,
                 },
               },
               {
-                loader: 'less-loader',
+                loader: "less-loader",
                 options: {
                   sourceMap: true,
                   lessOptions: {
@@ -107,8 +105,8 @@ export default merge(baseConfig, {
       // Sass 处理
       {
         test: /\.s[ac]ss$/i,
-        include: [path.resolveApp('src')],
-        exclude: [path.resolveApp('node_modules')],
+        include: [path.resolveApp("src")],
+        exclude: [path.resolveApp("node_modules")],
         oneOf: [
           {
             test: /\.module\.s[ac]ss$/,
@@ -117,21 +115,21 @@ export default merge(baseConfig, {
                 loader: rspack.CssExtractRspackPlugin.loader,
               },
               {
-                loader: 'css-loader',
+                loader: "css-loader",
                 options: {
                   sourceMap: true,
                   modules: {
-                    localIdentName: '[path][name]__[local]--[hash:base64:5]',
+                    localIdentName: "[path][name]__[local]--[hash:base64:5]",
                   },
                   importLoaders: 2,
                 },
               },
               {
-                loader: 'sass-loader',
+                loader: "sass-loader",
                 options: {
                   sourceMap: true,
                   sassOptions: {
-                    outputStyle: 'compressed',
+                    outputStyle: "compressed",
                   },
                 },
               },
@@ -143,17 +141,17 @@ export default merge(baseConfig, {
                 loader: rspack.CssExtractRspackPlugin.loader,
               },
               {
-                loader: 'css-loader',
+                loader: "css-loader",
                 options: {
                   sourceMap: true,
                 },
               },
               {
-                loader: 'sass-loader',
+                loader: "sass-loader",
                 options: {
                   sourceMap: true,
                   sassOptions: {
-                    outputStyle: 'compressed',
+                    outputStyle: "compressed",
                   },
                 },
               },
@@ -164,26 +162,26 @@ export default merge(baseConfig, {
       // CSS 处理 - TailwindCSS
       {
         test: /\.css$/,
-        include: [path.resolveApp('src/index.css')],
+        include: [path.resolveApp("src/index.css")],
         use: [
           {
             loader: rspack.CssExtractRspackPlugin.loader,
           },
-          'css-loader',
-          'postcss-loader',
+          "css-loader",
+          "postcss-loader",
         ],
       },
       // CSS 处理 - src 目录中的其他 CSS
       {
         test: /\.css$/,
-        include: [path.resolveApp('src')],
-        exclude: [path.resolveApp('src/index.css')],
+        include: [path.resolveApp("src")],
+        exclude: [path.resolveApp("src/index.css")],
         use: [
           {
             loader: rspack.CssExtractRspackPlugin.loader,
           },
           {
-            loader: 'css-loader',
+            loader: "css-loader",
             options: {
               sourceMap: true,
             },
@@ -193,13 +191,13 @@ export default merge(baseConfig, {
       // CSS 处理 - node_modules
       {
         test: /\.css$/,
-        include: [path.resolveApp('node_modules')],
+        include: [path.resolveApp("node_modules")],
         use: [
           {
-            loader: 'style-loader',
+            loader: "style-loader",
           },
           {
-            loader: 'css-loader',
+            loader: "css-loader",
             options: {
               sourceMap: true,
             },
@@ -211,41 +209,22 @@ export default merge(baseConfig, {
 
   plugins: [
     new rspack.CssExtractRspackPlugin({
-      filename: '[name].[contenthash:8].css',
-      chunkFilename: '[name].[contenthash:8].chunk.css',
+      filename: "[name].[contenthash:8].css",
+      chunkFilename: "[name].[contenthash:8].chunk.css",
     }),
-
-    // Sentry 插件 (仅生产环境)
-    process.env.SENTRY_ENABLED === 'true' &&
-      process.env.SENTRY_AUTH_TOKEN &&
-      sentryWebpackPlugin({
-        org: process.env.SENTRY_ORG,
-        project: process.env.SENTRY_PROJECT,
-        authToken: process.env.SENTRY_AUTH_TOKEN,
-        url: process.env.SENTRY_URL,
-        errorHandler: () => false,
-      }),
-  ].filter(Boolean),
+  ],
 
   optimization: {
     minimize: true,
     minimizer: [
       new rspack.SwcJsMinimizerRspackPlugin({
-        exclude: [path.resolveApp('node_modules')],
+        exclude: [path.resolveApp("node_modules")],
         minimizerOptions: {
           compress: {
-            pure_funcs: ['console.info', 'console.debug', 'console.warn'],
+            pure_funcs: ["console.info", "console.debug", "console.warn"],
             drop_console: false,
             drop_debugger: false,
           },
-          mangle: {
-            reserved: [
-              'Sentry',
-              'initSentry',
-              'captureException',
-              'captureMessage',
-            ],
-          },
         },
       }),
       new rspack.LightningCssMinimizerRspackPlugin(),

package/dist/templates/app/docs/DIRECTORY_STRUCTURE.md

@@ -0,0 +1,141 @@
+# 企业脚手架目录规划说明
+
+## 1. 现状概览
+
+```
+app/
+├── config/           # 构建 + 运行时配置混放
+│   ├── env/          # 环境变量文件
+│   ├── jwt/          # 运行时
+│   ├── request/      # 运行时
+│   ├── router/       # 渲染入口（renderClient）
+│   └── rspack/       # 构建
+├── locales/          # 文案 JSON（与 src/locales 双源）
+├── public/
+├── scripts/
+├── src/
+│   ├── bootstrap/
+│   ├── color/        # 设计 token 色板
+│   ├── components/
+│   ├── config/       # 仅 env.ts（与根 config 易混淆）
+│   ├── const/
+│   ├── layout/
+│   ├── locales/      # i18n 逻辑 + TS 文案
+│   ├── micro/
+│   ├── pages/
+│   ├── routes.tsx
+│   ├── styles/       # 全局样式 + theme 算法
+│   ├── types/
+│   └── utils/
+└── store/            # 与 src 平级
+    ├── middleware/
+    └── user/
+```
+
+---
+
+## 2. 结论：整体可用，有几处需约定或收敛
+
+- **做得好的**：`store` 独立、按 agent/slice 拆分；`pages` + `layout` + `components` 分层清晰；构建配置集中在 `config/rspack`、环境变量在 `config/env`，便于维护。
+- **需要约定的**：根目录 `config` 与 `src/config` 的职责边界、`locales` 双源、`color`/`styles`/`theme` 的归属。
+- **可优化项**：收敛「配置与文案」的入口、统一命名（如 `const` vs `constants`）、可选能力（如 `micro`）在文档中说明。
+
+---
+
+## 3. 问题与建议
+
+### 3.1 config 双位置（根 config vs src/config）
+
+| 位置       | 内容           | 问题                         |
+|------------|----------------|------------------------------|
+| 根 `config/` | env 文件、rspack、request、jwt、router | 构建与运行时混在同一层       |
+| `src/config/` | 仅 `env.ts`（zod 解析）     | 新人易困惑「改 env 改哪边」 |
+
+**建议（二选一或折中）：**
+
+- **方案 A（推荐）**：约定「根 `config/` = 仅构建与环境文件」：只放 `env/`、`rspack/`；把 `request/`、`jwt/`、`router/` 迁到 `src/config/`（或 `src/core/`），alias 保持 `@config` 指向 `src/config`，构建配置单独用 `config/rspack` 路径。这样「构建配置在根 config，运行时配置在 src」边界清晰。
+- **方案 B**：维持现状，在 README 中明确写清：「环境变量与构建用根 `config/`，运行时解析用 `src/config/env.ts`；请求/路由等由根 `config/` 的模块提供」，减少误改。
+
+### 3.2 locales 双源（根 locales vs src/locales）
+
+- 根 `locales/zh-CN/common.json` 与 `src/locales/default/common.ts` 内容重复，且有脚本把 TS 转 JSON。
+- **建议**：选单一数据源。若以 i18n 代码为主，保留 `src/locales`，删除根 `locales/` 和转换脚本，构建或运行时从 `src/locales` 生成/加载；若以 JSON 为主，则只保留根 `locales/`，在 README 中说明「文案只放根 locales」。
+
+### 3.3 store 与 src 平级
+
+- `store/` 在项目根与 `src/` 平级，符合「状态与 UI 分离」的常见企业习惯；alias `@store` 指向根下 `store` 也合理。
+- **建议**：保持现状；在 README 或本说明中写一句：「业务 UI 在 `src/`，领域状态在 `store/`，按 agent/slice 拆分」，避免被误挪进 `src`。
+
+### 3.4 src 内部：color / styles / theme
+
+- `color/`：色板与 token 数据；`styles/`：全局样式、antd 覆盖、**theme 算法与 customToken**；`types/` 中还有 `customStylish`、`customToken`。
+- 问题：主题相关分散在 `color`、`styles/theme`、`styles`、`types`，新人找「改主题」入口不直观。
+- **建议**：
+  - 要么保留 `color/` 但在 README 标明「设计 token 与色板，被 `styles/theme` 消费」；
+  - 要么将 `color/` 收进 `styles/theme/`（如 `styles/theme/color/`），入口统一为 `styles/theme`，减少顶层目录。
+- 不强求一步到位，但需在文档中画一条线：**主题与 token 的入口是 `src/styles/theme`（及可选 `src/color`）**。
+
+### 3.5 横切目录：const / types / utils
+
+- `const/`、`types/`、`utils/` 是常见横切层，结构合理。
+- 小问题：`const/constants.ts` 当前为空；`types` 里既有全局类型又有与 theme 强相关的类型。
+- **建议**：`const` 保留，删除或补全 `constants.ts`，避免空文件；在 README 或本说明中约定「全局业务常量放 `const/`，组件/页面私有常量随模块」。`types` 可注明「与 theme/样式强相关的类型与 `styles/theme` 同目录或在本目录集中维护」，二选一即可。
+
+### 3.6 可选能力：micro、bootstrap
+
+- `micro/` 仅 Garfish，已作为可选项；`bootstrap/` 仅应用启动逻辑。
+- **建议**：保持 `micro/` 在 `src` 下，README 中说明「微前端为可选项，入口与配置见 xxx」。`bootstrap/` 可保留；若希望根入口更短，可把 `bootstrapWithEnv()` 的实现迁到 `src/index.tsx` 或 `src/config/bootstrap.ts`，只保留单文件也可。
+
+### 3.7 pages 与路由
+
+- `pages/` 下有 404、base、index 等；路由定义在 `src/routes.tsx`，渲染入口在 `config/router/index.tsx`。
+- **建议**：约定「路由表仅由 `src/routes.tsx` 维护；`config/router` 只负责 `renderClient` 与挂载」，在 README 或本说明写清，避免在 `config/router` 里再配路由造成双源。
+
+### 3.8 根目录与脚本
+
+- 根目录的 `tsconfig`、`tailwind`、`postcss`、`scripts/` 等符合常规，无需调整。
+- `scripts/` 若仅剩「locales 转 JSON」且已决定废弃根 `locales/`，可删除该脚本；否则保留并注明用途。
+
+---
+
+## 4. 推荐约定（最小改动版）
+
+在不做大范围迁移的前提下，建议先做「约定文档化 + 少量收敛」：
+
+1. **配置**：在 README 中写清「根 `config/` = 构建与环境文件；运行时配置与请求/路由实现来自 `@config`（当前指向根 config，或你们改为 src/config）」。  
+2. **文案**：选定 locales 单一数据源（推荐 `src/locales`），删除或弃用另一侧及转换脚本。  
+3. **主题**：在 README 中标明「主题与 token 入口：`src/styles/theme`，色板数据见 `src/color`（可选）」。  
+4. **store**：说明「全局状态在根 `store/`，按 agent/slice 划分，与 `src` 并列」。  
+5. **路由**：说明「路由表只在 `src/routes.tsx` 维护；`config/router` 仅负责渲染与挂载」。  
+6. **空文件**：删除或补全 `src/const/constants.ts`。
+
+若后续要做更大调整，再考虑：把 request/jwt/router 迁入 `src/config` 或 `src/core`、将 `color` 并入 `styles/theme` 等。
+
+---
+
+## 5. 可选：目标结构示意（供长期演进参考）
+
+```
+app/
+├── config/                 # 仅构建与环境
+│   ├── env/
+│   └── rspack/
+├── public/
+├── scripts/
+├── src/
+│   ├── config/             # 运行时：env 解析、request、router 挂载等
+│   ├── core/                # 可选：bootstrap、微前端入口等
+│   ├── layout/
+│   ├── pages/
+│   ├── components/
+│   ├── styles/              # 全局样式 + theme（含 token/color 或引用）
+│   ├── locales/             # 单一 i18n 数据源
+│   ├── const/
+│   ├── types/
+│   ├── utils/
+│   ├── routes.tsx
+│   └── index.tsx
+└── store/
+```
+
+当前模板不必立刻改成上述结构，可先落实「约定 + 文档 + 删除冗余」，再按团队习惯逐步演进。

package/dist/templates/app/docs/glossary.md

@@ -0,0 +1,11 @@
+# Glossary
+
+以下是一些词汇的固定翻译：
+
+| develop key | zh-CN (中文) | en-US(English) |
+| ----------- | ------------ | -------------- |
+| agent       | 助理         | Agent          |
+| agentGroup  | 群组         | Group          |
+| page        | 文稿         | Page           |
+| topic       | 话题         | Topic          |
+| thread      | 子话题       | Thread         |

package/dist/templates/app/locales/zh-CN/common.json

@@ -0,0 +1,3 @@
+{
+  "appName": "Chat应用"
+}