uxos 0.0.23 → 0.0.25

package/README.md

@@ -4,29 +4,49 @@ UXOS - 设计效率助手：一个由 AI 驱动的、具有引导式工作流的
 
 ## 安装方法
 
-**⚠️ 重要提示**：首次安装或更新时，请使用以下命令清除缓存：
+**⭐ 推荐方式（始终使用最新版本）**：
 
 ```bash
-# 清除 npm 缓存
-npm cache clean --force
-
-# 删除 npx 缓存
-rm -rf ~/.npm/_npx
+npx uxos@latest
 ```
 
+> ⚠️ **重要提示**：
+> - 必须加 `@latest` 以避免使用缓存的旧版本
+> - 注意拼写：是 `latest`（不是 `lastest`）
+> - 如果不加 `@latest`，可能会使用旧版本导致错误
+
 **方法一：通过 AI 助手安装**
 
-在 CodeBuddy 的 AI 助手中输入以下指令：
+在 CodeBuddy 的 AI 助手中输入：
 
 ```
 帮我安装 npx uxos
 ```
 
-**方法二：命令行安装**
+**方法二：命令行安装（推荐）**
+
+```bash
+# 推荐：明确指定 @latest 确保使用最新版本
+npx uxos@latest
+
+# 或指定具体版本号
+npx uxos@0.0.24
+```
+
+### ⚠️ 如果遇到旧版本问题
+
+如果之前安装过 uxos 并遇到错误，请运行：
 
 ```bash
-# 强制安装最新版本
-npx --yes uxos@latest
+# 1. 卸载全局安装（如果有）
+npm uninstall -g uxos
+
+# 2. 清除缓存
+npm cache clean --force
+rm -rf ~/.npm/_npx
+
+# 3. 使用最新版本
+npx uxos@latest
 ```
 
 然后跟随 AI 助手的指引即可完成安装。

package/cli.js

@@ -2,6 +2,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { execSync } = require('child_process');
 
 // Read version from package.json
 const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
@@ -9,6 +10,40 @@ const VERSION = packageJson.version;
 
 const UXOS_SRC_DIR = path.join(__dirname, '_uxos');
 
+// Check if running the latest version
+function checkForLatestVersion() {
+  try {
+    const latestVersion = execSync('npm view uxos version', { encoding: 'utf8', timeout: 3000 }).trim();
+    
+    if (latestVersion !== VERSION) {
+      console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║                    ⚠️  VERSION WARNING                    ║
+╚═══════════════════════════════════════════════════════════╝
+
+You are running uxos@${VERSION}
+The latest version is: uxos@${latestVersion}
+
+Please run the following to use the latest version:
+
+  npm uninstall -g uxos
+  npm cache clean --force
+  rm -rf ~/.npm/_npx
+  npx uxos@latest
+
+Or simply use:
+
+  npx uxos@${latestVersion}
+
+`);
+      process.exit(1);
+    }
+  } catch (error) {
+    // If we can't check (no internet, etc.), continue anyway
+    console.log('⚠️  Unable to check for updates (network issue?)');
+  }
+}
+
 function createDirectory(dir) {
   if (!fs.existsSync(dir)) {
     fs.mkdirSync(dir, { recursive: true });
@@ -52,27 +87,27 @@ function main() {
     return;
   }
 
+  // Check if we're running the latest version
+  checkForLatestVersion();
+
   // Check for old version structure and warn user
   const oldWorkflowsDir = path.join(__dirname, 'workflows');
   const oldTemplatesDir = path.join(__dirname, 'templates');
   if (fs.existsSync(oldWorkflowsDir) || fs.existsSync(oldTemplatesDir)) {
     console.log(`
-═══════════════════════════════════════════════════════════
-⚠️  WARNING: OLD VERSION DETECTED
-═══════════════════════════════════════════════════════════
+╔═══════════════════════════════════════════════════════════╗
+║              ⚠️  OLD VERSION STRUCTURE DETECTED           ║
+╚═══════════════════════════════════════════════════════════╝
 
-You are using an outdated version of UXOS.
+This appears to be an old version (0.0.21 or earlier).
 
-To update to the latest version, run:
+Please uninstall and reinstall:
 
+  npm uninstall -g uxos
   npm cache clean --force
   rm -rf ~/.npm/_npx
-  npx --yes uxos@latest
-
-Current version: OLD (0.0.21 or earlier)
-Latest version:  0.0.22+
+  npx uxos@latest
 
-For more information, visit: https://www.npmjs.com/package/uxos
 `);
     process.exit(1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uxos",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "UXOS - Design Efficiency Assistant: A guided workflow system for AI-powered design collaboration",
   "main": "cli.js",
   "bin": {
@@ -16,7 +16,8 @@
     "ai-assistant",
     "productivity",
     "ux",
-    "collaboration"
+    "collaboration",
+    "npx"
   ],
   "author": "UXOS Team",
   "license": "MIT",
@@ -28,6 +29,7 @@
   "engines": {
     "node": ">=14.0.0"
   },
+  "preferGlobal": false,
   "files": [
     "cli.js",
     "package.json",