generator-mico-cli 0.2.19 → 0.2.20

package/generators/micro-react/index.js

@@ -210,6 +210,16 @@ module.exports = class extends Generator {
   }
 
   install() {
+    // 检查并初始化 git
+    const gitDir = path.join(this.destDir, '.git');
+    if (!fs.existsSync(gitDir)) {
+      this.log('');
+      this.log('🔧 初始化 Git 仓库...');
+      this.spawnCommandSync('git', ['init'], {
+        cwd: this.destDir,
+      });
+    }
+
     this.log('');
     this.log('📦 正在安装依赖...');
     this.spawnCommandSync('pnpm', ['install'], {

package/generators/micro-react/templates/.eslintrc.js

@@ -19,7 +19,30 @@ module.exports = {
       },
     ],
   },
-  // 忽略 apps/ 子包和 scripts/
+	// TypeScript 文件使用专门的 parser
+	overrides: [
+		{
+			files: ["*.ts", "*.tsx"],
+			parser: "@typescript-eslint/parser",
+			plugins: ["@typescript-eslint"],
+			extends: [
+				"eslint:recommended",
+				"plugin:@typescript-eslint/recommended",
+			],
+			rules: {
+				// 使用 TS 版本的 no-unused-vars
+				"no-unused-vars": "off",
+				"@typescript-eslint/no-unused-vars": [
+					"warn",
+					{
+						argsIgnorePattern: "^_",
+						varsIgnorePattern: "^_",
+					},
+				],
+			},
+		},
+	],
+  // 忽略 apps/ 子包和 scripts/，apps由内部的eslint规则处理
   ignorePatterns: [
     'node_modules/',
     'dist/',

package/generators/micro-react/templates/CICD/start_dev.sh

@@ -38,7 +38,7 @@ pnpm run build:development
 
 # 只有在 CI 环境时才写入版本号文件（覆盖写入）
 if [ "${CI}" = "true" ]; then
-  echo "VERSION=$VERSION" > .env_x_<%= projectName %>portal-web
+  echo "VERSION=$VERSION" > .env_x_<%= projectName %>
 fi
 
 

package/generators/micro-react/templates/apps/layout/docs/common-intl.md

@@ -2,7 +2,7 @@
 
 ## 概述
 
-`@portal-web/common-intl` 是 Portal 项目的通用国际化（i18n）库，用于管理多语言文案，支持从多语言中台拉取翻译数据。
+`<%= packageScope %>/common-intl` 是 Portal 项目的通用国际化（i18n）库，用于管理多语言文案，支持从多语言中台拉取翻译数据。
 
 ## 适用场景
 
@@ -22,7 +22,7 @@
 
 ## 两种使用模式
 
-根据应用架构的不同，`@portal-web/common-intl` 支持两种使用模式：
+根据应用架构的不同，`<%= packageScope %>/common-intl` 支持两种使用模式：
 
 | 模式         | 适用场景                                         | 示例应用                                                     |
 | ------------ | ------------------------------------------------ | ------------------------------------------------------------ |
@@ -64,7 +64,7 @@ import {
   getCurrentLocale,
   initIntl,
   type ILang,
-} from "@portal-web/common-intl";
+} from "<%= packageScope %>/common-intl";
 import { Message } from "@mico-platform/ui";
 import { request } from "@umijs/max";
 
@@ -100,7 +100,7 @@ export function render(oldRender: () => void): void {
 
 ```typescript
 // apps/conversation-v2、apps/session、apps/workorder 等子应用
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 
 // 直接使用，文案来自主应用
 <h1>{intl.cs_web_workbench_conversation_record()}</h1>;
@@ -113,7 +113,7 @@ import { intl } from "@portal-web/common-intl";
 **独立应用配置（apps/mico-cs-mobile/src/app.ts）**：
 
 ```typescript
-import { initIntl } from "@portal-web/common-intl";
+import { initIntl } from "<%= packageScope %>/common-intl";
 import { Toast } from "@arco-design/mobile-react";
 import { request } from "@umijs/max";
 import { convertLocaleToLangParam } from "./locales/utils";
@@ -149,7 +149,7 @@ export function render(oldRender: () => void): void {
 **独立应用的文案文件（apps/mico-cs-mobile/src/locales/index.ts）**：
 
 ```typescript
-import { i18n } from "@portal-web/common-intl";
+import { i18n } from "<%= packageScope %>/common-intl";
 
 const intl = {
   sdk_h5_ticket_record: () =>
@@ -173,7 +173,7 @@ import intl from "@/locales";
 
 ## 导出 API
 
-`@portal-web/common-intl` 提供以下导出：
+`<%= packageScope %>/common-intl` 提供以下导出：
 
 | 导出                 | 类型 | 说明                                                      |
 | -------------------- | ---- | --------------------------------------------------------- |
@@ -192,18 +192,18 @@ import intl from "@/locales";
 
 ```typescript
 // 微前端子应用 - 直接使用共享的 intl 对象
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 intl.cs_web_common_request_failed();
 
 // 独立应用 - 使用 i18n 函数构建自己的文案对象
-import { i18n, initIntl, LANG } from "@portal-web/common-intl";
+import { i18n, initIntl, LANG } from "<%= packageScope %>/common-intl";
 
 // 获取当前语言环境
-import { getCurrentLocale } from "@portal-web/common-intl";
+import { getCurrentLocale } from "<%= packageScope %>/common-intl";
 const currentLang = getCurrentLocale(); // 'zh_CN' | 'en' | 'ar' | 'tr'
 
 // 获取支持的语言列表
-import { SUPPORTED_LOCALES } from "@portal-web/common-intl";
+import { SUPPORTED_LOCALES } from "<%= packageScope %>/common-intl";
 console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 ```
 
@@ -212,7 +212,7 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 ### PC 端主子应用
 
 - **文案位置**：[packages/common-intl/src/intl.ts](../packages/common-intl/src/intl.ts)
-- **使用方式**：`import { intl } from '@portal-web/common-intl'`
+- **使用方式**：`import { intl } from '<%= packageScope %>/common-intl'`
 - **适用应用**：
   - apps/layout（主应用）
   - apps/conversation-v2（工作台子应用）
@@ -242,7 +242,7 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 // apps/your-app/package.json
 {
   "dependencies": {
-    "@portal-web/common-intl": "workspace:*"
+    "<%= packageScope %>/common-intl": "workspace:*"
   }
 }
 ```
@@ -252,7 +252,7 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 **如果是 layout 的子应用**：
 
 - 无需调用 `initIntl()`
-- 直接使用 `import { intl } from '@portal-web/common-intl'`
+- 直接使用 `import { intl } from '<%= packageScope %>/common-intl'`
 
 **如果是独立应用**：
 
@@ -321,7 +321,7 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 ### Q: 如何在代码中获取当前语言？
 
 ```typescript
-import { getCurrentLocale } from "@portal-web/common-intl";
+import { getCurrentLocale } from "<%= packageScope %>/common-intl";
 
 const currentLang = getCurrentLocale();
 if (currentLang === "ar") {

package/generators/micro-react/templates/apps/layout/docs/feature-/344/270/273/351/242/230/350/211/262/345/210/207/346/215/242.md

@@ -201,7 +201,7 @@ wc -c apps/[子应用]/dist/umi.css
 1. 主应用加载 @mico-platform/ui 并暴露到 `window.micoUI`
 2. 主应用的样式包含 `arco-theme` 属性选择器（基于 Arco）
 3. 主应用切换主题时设置 `body[arco-theme="dark"]`
-4. 子应用的 UI 组件（来自 window.micoUi）自动应用暗色样式
+4. 子应用的 UI 组件（来自 window.micoUI）自动应用暗色样式
 
 #### 子应用使用 @mico-platform/ui
 

package/generators/micro-react/templates/apps/layout/docs/feature-/345/276/256/345/211/215/347/253/257/346/250/241/345/274/217.md

@@ -70,7 +70,7 @@ interface MicroAppLoaderProps {
 ```typescript
 interface MicroAppProps {
   /** 主应用标识 */
-  mainApp: 'portal-web';
+  mainApp: '<%= projectName %>';
   /** 运行环境 */
   env: 'development' | 'testing' | 'production';
   /** 认证 token */

package/generators/micro-react/templates/apps/layout/src/common/locale.ts

@@ -122,7 +122,7 @@ export function setLocaleToStorage(locale: SupportedLocale): void {
 /**
  * 根据语言获取图标库路径
  */
-export function getIconFontPath(locale: SupportedLocale): string {
-  // 如果后续需要支持 RTL 语言（如阿拉伯语），可在此扩展
-  return withPublicPath('/font/default.js');
+export function getIconFontPath(/* locale: SupportedLocale */): string {
+	// 如果后续需要支持 RTL 语言（如阿拉伯语），可在此扩展
+	return withPublicPath("/font/default.js");
 }

package/generators/micro-react/templates/apps/layout/src/components/MicroAppLoader/index.tsx

@@ -70,7 +70,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
   const buildProps = useCallback(() => {
     const authInfo = getAuthInfo();
     return {
-      mainApp: 'portal-web',
+      mainApp: '<%= projectName %>',
       env,
       authToken: authInfo.token,
       uid: authInfo.uid,

package/generators/micro-react/templates/apps/layout/src/global.less

@@ -7,7 +7,7 @@
   box-sizing: border-box;
 }
 
-#<%= projectName %> {
+#root {
   height: 100vh;
   min-height: 800px;
   display: flex;

package/generators/micro-react/templates/apps/layout/src/services/config/type.ts

@@ -13,11 +13,9 @@ export interface ITimezone {
 }
 
 /**
- * 获取时区配置请求
+ * 获取时区配置请求（空请求体）
  */
-export interface IGetTimezoneListRequest {
-  // 空请求体
-}
+export type IGetTimezoneListRequest = Record<string, never>;
 
 /**
  * 获取时区配置响应

package/generators/micro-react/templates/package.json

@@ -24,13 +24,15 @@
     "lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix && turbo run lint:fix",
     "check-types": "turbo run check-types",
     "lint-staged": "pnpm exec lint-staged --quiet",
-    "prepare": "husky install",
+    "prepare": "husky",
     "test": "dotenv -e .env -e .env.local -- turbo run test",
     "create:umi-app": "./scripts/create-umi-app.sh"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-conventional": "^19.5.0",
+		"@typescript-eslint/eslint-plugin": "^8.54.0",
+		"@typescript-eslint/parser": "^8.54.0",
     "dotenv-cli": "^7.4.1",
     "eslint": "^8.57.0",
     "husky": "^9.1.7",

package/generators/micro-react/templates/packages/common-intl/README.md

@@ -1,4 +1,4 @@
-# @portal-web/common-intl
+# <%= packageScope %>/common-intl
 
 通用国际化（i18n）库，用于 Portal 多应用间的多语言文案管理。
 
@@ -18,14 +18,14 @@
 ```json
 {
   "dependencies": {
-    "@portal-web/common-intl": "workspace:*"
+    "<%= packageScope %>/common-intl": "workspace:*"
   }
 }
 ```
 
 ## 两种使用模式
 
-根据应用架构的不同，`@portal-web/common-intl` 支持两种使用模式：
+根据应用架构的不同，`<%= packageScope %>/common-intl` 支持两种使用模式：
 
 | 模式         | 适用场景                                         | 示例应用                                                     |
 | ------------ | ------------------------------------------------ | ------------------------------------------------------------ |
@@ -49,7 +49,7 @@ import {
   getCurrentLocale,
   initIntl,
   type ILang,
-} from "@portal-web/common-intl";
+} from "<%= packageScope %>/common-intl";
 import { Message } from "@mico-platform/ui";
 import { request } from "@umijs/max";
 
@@ -85,7 +85,7 @@ export function render(oldRender: () => void): void {
 
 ```typescript
 // apps/conversation-v2、apps/session、apps/workorder 等子应用
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 
 // 直接使用，文案来自主应用
 <h1>{intl.cs_web_workbench_conversation_record()}</h1>;
@@ -98,7 +98,7 @@ import { intl } from "@portal-web/common-intl";
 **独立应用配置**（参考 `apps/mico-cs-mobile/src/app.ts`）：
 
 ```typescript
-import { initIntl } from "@portal-web/common-intl";
+import { initIntl } from "<%= packageScope %>/common-intl";
 import { request } from "@umijs/max";
 import { convertLocaleToLangParam } from "./locales/utils";
 import { getSearchParams } from "@/common/jsbridge/jsbridge";
@@ -140,7 +140,7 @@ export function render(oldRender: () => void): void {
 **独立应用的文案文件**（`apps/mico-cs-mobile/src/locales/index.ts`）：集中管理所有国际化文案
 
 ```typescript
-import { i18n } from "@portal-web/common-intl";
+import { i18n } from "<%= packageScope %>/common-intl";
 
 const intl = {
   // 无插值示例
@@ -395,7 +395,7 @@ const intl = {
 2. 在业务代码中使用：
 
 ```typescript
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 
 // 使用新 key
 intl.cs_web_your_new_key();