axhub-make 1.0.5 → 1.0.6

package/AI-ASSISTANT-GUIDE.md

@@ -127,6 +127,9 @@ CLI 会检测目标目录是否包含：
     "src/**",
     "assets/**"
   ],
+  "alwaysOverwrite": [
+    "src/common/**"
+  ],
   "conflictCheck": [
     "package.json"
   ],
@@ -134,12 +137,17 @@ CLI 会检测目标目录是否包含：
 }
 ```
 
-**冲突文件分类：**
+**冲突文件分类（优先级从高到低）：**
+- `alwaysOverwrite`：**最高优先级**，强制覆盖的文件
+  - 即使文件匹配 `neverOverwrite` 规则，也会被覆盖
+  - 当前配置：`src/common/**`（脚手架公共代码，需要保持同步）
+  - 使用场景：框架核心文件、类型定义等需要随模板更新的文件
 - `conflictCheck`：需要检查的文件（如配置文件）
   - 当前配置：`package.json`
   - 未来可能添加：`vite.config.ts`、`tsconfig.json` 等
 - `neverOverwrite`：永不覆盖的文件（如用户数据）
   - 当前配置：`src/**`、`assets/**`（用户业务代码和资源）
+  - 注意：会被 `alwaysOverwrite` 规则覆盖
 - `defaultOverwrite`：默认行为（true = 其他文件默认覆盖）
 
 **你的工作流程：**
@@ -243,9 +251,12 @@ CLI 会检测目标目录是否包含：
         原因：此文件在 conflictCheck 列表中，可能包含你的自定义依赖
      
      ℹ️  以下文件会被保护，不会覆盖：
-     • src/** - 你的业务代码
+     • src/** - 你的业务代码（除了 src/common/**）
      • assets/** - 你的资源文件
      
+     ℹ️  以下文件会强制更新（保持与模板同步）：
+     • src/common/** - 脚手架公共代码和类型定义
+     
      请选择处理方式：
      
      1️⃣ 保留 - 保留你的本地版本（推荐，安全）
@@ -283,13 +294,14 @@ CLI 会检测目标目录是否包含：
      ✅ 会自动更新的文件：
      • vite.config.ts
      • tsconfig.json
+     • src/common/** - 脚手架公共代码（强制更新）
      • 其他脚手架文件
      
      ⚠️  需要确认的冲突文件：
      • package.json（在 conflictCheck 列表中）
      
      🔒 永不覆盖的文件：
-     • src/** - 你的业务代码
+     • src/** - 你的业务代码（除了 src/common/**）
      • assets/** - 你的资源文件
      
      当前冲突文件：package.json

package/bin/index.js

@@ -55,6 +55,7 @@ async function readUpdateRules(tmpDir) {
     return {
       schemaVersion: 1,
       neverOverwrite: [],
+      alwaysOverwrite: [],
       conflictCheck: [],
       defaultOverwrite: true
     };
@@ -63,6 +64,7 @@ async function readUpdateRules(tmpDir) {
   return {
     schemaVersion: typeof rules.schemaVersion === 'number' ? rules.schemaVersion : 1,
     neverOverwrite: Array.isArray(rules.neverOverwrite) ? rules.neverOverwrite : [],
+    alwaysOverwrite: Array.isArray(rules.alwaysOverwrite) ? rules.alwaysOverwrite : [],
     conflictCheck: Array.isArray(rules.conflictCheck) ? rules.conflictCheck : [],
     defaultOverwrite: typeof rules.defaultOverwrite === 'boolean' ? rules.defaultOverwrite : true
   };
@@ -138,6 +140,12 @@ async function planUpdateFromTemplate(tmpDir, targetDir, rules, conflictMode) {
       continue;
     }
 
+    // alwaysOverwrite 优先级最高，即使匹配 neverOverwrite 也要覆盖
+    if (matchesAny(relPosix, rules.alwaysOverwrite)) {
+      copied.push(relPosix);
+      continue;
+    }
+
     if (matchesAny(relPosix, rules.neverOverwrite) && destExists) {
       skipped.push(relPosix);
       continue;
@@ -183,6 +191,14 @@ async function applyUpdateFromTemplate(tmpDir, targetDir, rules, conflictMode) {
       continue;
     }
 
+    // alwaysOverwrite 优先级最高，即使匹配 neverOverwrite 也要覆盖
+    if (matchesAny(relPosix, rules.alwaysOverwrite)) {
+      await fs.ensureDir(path.dirname(destPath));
+      await fs.copyFile(srcPath, destPath);
+      copied.push(relPosix);
+      continue;
+    }
+
     if (matchesAny(relPosix, rules.neverOverwrite) && destExists) {
       skipped.push(relPosix);
       continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axhub-make",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Axhub Make scaffolding tool",
   "bin": {
     "axhub-make": "./bin/index.js"
@@ -10,13 +10,18 @@
   },
   "dependencies": {
     "chalk": "^4.1.2",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
     "download-git-repo": "^3.0.2",
     "fs-extra": "^10.0.0",
-    "inquirer": "^8.2.0"
+    "inquirer": "^8.2.0",
+    "tailwind-merge": "^3.4.0"
   },
   "author": "Lintendo",
   "license": "ISC",
   "devDependencies": {
-    "execa": "^9.6.1"
+    "@tailwindcss/vite": "^4.1.18",
+    "execa": "^9.6.1",
+    "tailwindcss": "^4.1.18"
   }
 }

package/TEST.md

@@ -1,76 +0,0 @@
-# 测试指南
-
-## 快速测试
-
-```bash
-npm test
-# 或
-node test.js
-```
-
-## 测试覆盖
-
-测试文件 `test.js` 覆盖以下功能：
-
-### 1. 核心工具函数
-- ✅ `globToRegExp` - glob 模式转正则表达式
-- ✅ `matchesAny` - 文件路径匹配
-- ✅ `normalizeRelPath` - 路径标准化
-
-### 2. 参数解析
-- ✅ 目录参数解析
-- ✅ 命令行选项（--no-install, --no-start, --pm, --conflict）
-
-### 3. 文件操作
-- ✅ 临时目录创建和清理
-- ✅ 文件内容比较
-
-## 手动测试
-
-### 测试新项目创建
-
-```bash
-# 在临时目录测试
-mkdir /tmp/test-axhub && cd /tmp/test-axhub
-npx axhub-make my-project --no-start
-
-# 验证项目结构
-ls -la my-project
-```
-
-### 测试项目更新
-
-```bash
-# 在已有项目中测试
-cd existing-axhub-project
-npx axhub-make --no-start
-
-# 检查是否正确处理冲突文件
-```
-
-### 测试 GitHub 可访问性
-
-```bash
-# 测试会自动检测 GitHub 连接并切换到 Gitee（如果需要）
-npx axhub-make test-project
-```
-
-### 测试冲突处理
-
-```bash
-# 保持本地文件（默认）
-npx axhub-make --conflict keep
-
-# 覆盖冲突文件
-npx axhub-make --conflict overwrite
-```
-
-## 发布前检查清单
-
-- [ ] 运行 `npm test` 确保所有测试通过
-- [ ] 测试新项目创建
-- [ ] 测试项目更新
-- [ ] 测试 GitHub/Gitee 自动切换
-- [ ] 测试不同包管理器（npm, yarn, pnpm）
-- [ ] 检查 package.json 版本号
-- [ ] 更新 CHANGELOG