uxos 0.0.25 → 0.0.27

package/README.md

@@ -4,16 +4,41 @@ UXOS - 设计效率助手：一个由 AI 驱动的、具有引导式工作流的
 
 ## 安装方法
 
-**⭐ 推荐方式（始终使用最新版本）**：
+**⭐ 必须使用 @latest 标签**：
 
 ```bash
 npx uxos@latest
 ```
 
-> ⚠️ **重要提示**：
-> - 必须加 `@latest` 以避免使用缓存的旧版本
-> - 注意拼写：是 `latest`（不是 `lastest`）
-> - 如果不加 `@latest`，可能会使用旧版本导致错误
+> ❌ **不要使用** `npx uxos`（会使用缓存的旧版本）  
+> ✅ **必须使用** `npx uxos@latest`（始终获取最新版本）
+
+### 为什么必须使用 @latest？
+
+npx 会优先使用缓存的旧版本，导致：
+- 创建错误的文件夹（`config/`, `workflows/`）
+- 缺少必要的文件
+- 安装失败
+
+使用 `@latest` 可以：
+- ✅ 强制下载最新版本
+- ✅ 跳过缓存
+- ✅ 确保正确安装
+
+### 正确用法
+
+```bash
+# ✅ 推荐：使用 @latest
+npx uxos@latest
+
+# ✅ 或指定具体版本号
+npx uxos@0.0.25
+
+# ❌ 错误：不要直接使用（会用缓存）
+npx uxos
+```
+
+> ⚠️ **注意拼写**：是 `latest`（不是 `lastest`）
 
 **方法一：通过 AI 助手安装**
 
@@ -55,6 +80,33 @@ npx uxos@latest
 
 安装完成后，UXOS 会自动在工作目录创建 `_uxos/` 文件夹。AI 助手会引导你阅读初始化指南并开始使用。
 
+## 故障排除
+
+### 问题：出现 config/ 或 workflows/ 文件夹
+
+**原因**：使用了缓存的旧版本（没有加 `@latest`）
+
+**解决**：
+```bash
+# 1. 删除旧文件夹
+rm -rf config/ workflows/ templates/
+
+# 2. 清除缓存
+npm cache clean --force
+rm -rf ~/.npm/_npx
+
+# 3. 使用 @latest 重新安装
+npx uxos@latest
+```
+
+### 问题：提示版本不匹配
+
+**解决**：始终使用 `@latest` 标签
+
+```bash
+npx uxos@latest
+```
+
 ## 功能特性
 
 - **工作流系统**：产品设计和开发的引导式工作流

package/cli.js

@@ -10,7 +10,7 @@ const VERSION = packageJson.version;
 
 const UXOS_SRC_DIR = path.join(__dirname, '_uxos');
 
-// Check if running the latest version
+// CRITICAL: Check if running the latest version IMMEDIATELY
 function checkForLatestVersion() {
   try {
     const latestVersion = execSync('npm view uxos version', { encoding: 'utf8', timeout: 3000 }).trim();
@@ -24,26 +24,33 @@ function checkForLatestVersion() {
 You are running uxos@${VERSION}
 The latest version is: uxos@${latestVersion}
 
-Please run the following to use the latest version:
+⚠️  IMPORTANT: Direct 'npx uxos' may use cached old versions!
+
+SOLUTION: Always use @latest tag:
+
+  npx uxos@latest
+
+Or clean cache first:
 
   npm uninstall -g uxos
   npm cache clean --force
   rm -rf ~/.npm/_npx
   npx uxos@latest
 
-Or simply use:
-
-  npx uxos@${latestVersion}
+Visit: https://www.npmjs.com/package/uxos
 
 `);
       process.exit(1);
     }
   } catch (error) {
     // If we can't check (no internet, etc.), continue anyway
-    console.log('⚠️  Unable to check for updates (network issue?)');
+    console.log('⚠️  Unable to check for updates (network issue?)\n');
   }
 }
 
+// Check IMMEDIATELY before doing anything
+checkForLatestVersion();
+
 function createDirectory(dir) {
   if (!fs.existsSync(dir)) {
     fs.mkdirSync(dir, { recursive: true });
@@ -87,25 +94,66 @@ function main() {
     return;
   }
 
-  // Check if we're running the latest version
-  checkForLatestVersion();
-
-  // Check for old version structure and warn user
+  // Check for old version structure FIRST (before creating anything)
   const oldWorkflowsDir = path.join(__dirname, 'workflows');
   const oldTemplatesDir = path.join(__dirname, 'templates');
-  if (fs.existsSync(oldWorkflowsDir) || fs.existsSync(oldTemplatesDir)) {
+  const oldConfigDir = path.join(__dirname, 'config');
+  
+  if (fs.existsSync(oldWorkflowsDir) || fs.existsSync(oldTemplatesDir) || fs.existsSync(oldConfigDir)) {
     console.log(`
 ╔═══════════════════════════════════════════════════════════╗
-║              ⚠️  OLD VERSION STRUCTURE DETECTED           ║
+║           ⚠️  OLD VERSION STRUCTURE DETECTED              ║
 ╚═══════════════════════════════════════════════════════════╝
 
-This appears to be an old version (0.0.21 or earlier).
+This is an old version (0.0.21 or earlier).
+
+⚠️  CRITICAL: You are using a CACHED old version!
 
-Please uninstall and reinstall:
+The old version may have created these folders:
+  - config/
+  - workflows/
+  - templates/
+
+SOLUTION: Always use @latest to avoid cache:
+
+  npx uxos@latest
+
+Or clean up:
 
   npm uninstall -g uxos
   npm cache clean --force
   rm -rf ~/.npm/_npx
+
+Then delete old folders in your project:
+  rm -rf config/ workflows/ templates/
+
+Then run:
+  npx uxos@latest
+
+`);
+    process.exit(1);
+  }
+
+  const projectRoot = process.cwd();
+  
+  // Check if old folders exist in project directory
+  const projectOldWorkflows = path.join(projectRoot, 'workflows');
+  const projectOldConfig = path.join(projectRoot, 'config');
+  
+  if (fs.existsSync(projectOldWorkflows) || fs.existsSync(projectOldConfig)) {
+    console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║        ⚠️  OLD UXOS FILES DETECTED IN PROJECT             ║
+╚═══════════════════════════════════════════════════════════╝
+
+Found old UXOS files from version 0.0.21 or earlier:
+${fs.existsSync(projectOldWorkflows) ? '  ✗ workflows/\n' : ''}${fs.existsSync(projectOldConfig) ? '  ✗ config/\n' : ''}
+Please remove these folders before installing:
+
+  rm -rf workflows/ config/ templates/
+
+Then run:
+
   npx uxos@latest
 
 `);
@@ -121,7 +169,6 @@ Please uninstall and reinstall:
 Installing UXOS workflow system...
   `);
 
-  const projectRoot = process.cwd();
   const uxosDestDir = path.join(projectRoot, '_uxos');
 
   // Copy entire _uxos directory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uxos",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "UXOS - Design Efficiency Assistant: A guided workflow system for AI-powered design collaboration",
   "main": "cli.js",
   "bin": {