@atooyu/uxto-cli 1.0.0

package/README.md

@@ -0,0 +1,175 @@
+# UXTO CLI
+
+UXTO UniApp 项目脚手架工具 - 支持 iOS、Android、鸿蒙多平台。
+
+## 安装
+
+```bash
+# 全局安装
+pnpm add -g @atooyu/uxto-cli
+
+# 或使用 npm
+npm install -g @atooyu/uxto-cli
+```
+
+## 命令
+
+### 创建项目
+
+```bash
+# 交互式创建
+uxto create
+
+# 直接指定项目名称
+uxto create my-app
+
+# 使用 init 别名
+uxto init my-app
+```
+
+### 发布组件到 NPM
+
+```bash
+# 发布组件
+uxto publish
+
+# 指定发布范围 (公开包)
+uxto publish --access public
+
+# 指定标签 (如 beta, next)
+uxto publish --tag beta
+
+# 指定 registry
+uxto publish --registry https://registry.npmjs.org/
+
+# 模拟发布 (不实际执行)
+uxto publish --dry-run
+```
+
+### 登录 NPM
+
+```bash
+uxto login
+```
+
+### 查看版本
+
+```bash
+uxto -v
+uxto --version
+```
+
+### 查看更新记录
+
+```bash
+uxto changelog
+```
+
+## 生成的项目特性
+
+- 基于 UniApp + Vue3 + TypeScript 构建
+- 支持 iOS、Android、鸿蒙、H5、小程序多平台
+- 集成 Pinia 状态管理
+- 集成 UXTO 组件库 (`@atooyu/uxto-ui`)
+- 内置 u-tabbar 底部导航组件
+- 支持暗黑模式和灰色模式主题切换
+
+## 开发命令
+
+创建项目后：
+
+```bash
+pnpm install        # 安装依赖
+pnpm dev:h5         # 运行 H5
+pnpm dev:app        # 运行 App (iOS/Android)
+pnpm dev:harmony    # 运行鸿蒙
+pnpm dev:mp-weixin  # 运行微信小程序
+```
+
+## 项目结构
+
+生成的项目结构：
+
+```
+my-app/
+├── src/
+│   ├── pages/          # 页面
+│   │   ├── index/      # 首页
+│   │   ├── components/ # 组件示例
+│   │   ├── api/        # API 示例
+│   │   ├── store/      # 状态管理
+│   │   ├── utils/      # 工具类
+│   │   └── tabbar/     # 底部导航示例
+│   ├── stores/         # Pinia Store
+│   │   ├── counter.ts
+│   │   ├── user.ts
+│   │   ├── cart.ts
+│   │   └── theme.ts    # 主题状态 (暗黑/灰色模式)
+│   ├── utils/          # 工具类
+│   ├── assets/         # 静态资源
+│   │   └── styles/     # 全局样式
+│   ├── App.vue
+│   ├── main.ts
+│   └── pages.json
+├── package.json
+├── vite.config.js
+└── tsconfig.json
+```
+
+## 使用 UXTO 组件库
+
+生成的项目已集成 `@atooyu/uxto-ui` 组件库，可以直接使用：
+
+```vue
+<template>
+  <!-- 底部导航 -->
+  <u-tabbar
+    v-model="activeTab"
+    center-brand="U"
+    center-label="UXTO"
+    :left-tab="{ label: '首页', icon: '⌂', value: 'home' }"
+    :center-tab="{ label: 'UXTO', icon: 'U', value: 'uxto' }"
+    :right-tab="{ label: '我的', icon: '◉', value: 'mine' }"
+    @tab-change="onTabChange"
+  />
+
+  <!-- 开关 -->
+  <u-switch v-model="enabled" />
+
+  <!-- 其他组件... -->
+</template>
+```
+
+## 发布组件流程
+
+### 1. 登录 NPM
+
+```bash
+uxto login
+```
+
+### 2. 确保组件已构建
+
+```bash
+# 在 uxto-ui 目录
+npm run build:all
+```
+
+### 3. 发布
+
+```bash
+uxto publish --access public
+```
+
+## 相关项目
+
+- [uxto-ui](../uxto-ui) - UXTO 组件库
+- [uxto-fronted](../uxto-fronted) - UXTO 前端脚手架模板 (CLI 模板来源)
+  - [template](../uxto-fronted/template) - 项目模板
+  - [example](../uxto-fronted/example) - 示例项目
+
+> CLI 通过 `@atooyu/uxto-fronted` 包获取模板，无需本地 template 目录。
+
+## License
+
+MIT

package/dist/commands/changelog.d.ts

@@ -0,0 +1 @@
+export declare function showChangelog(): void;

package/dist/commands/changelog.js

@@ -0,0 +1,19 @@
+import chalk from 'chalk';
+const CHANGELOG = `
+# UXTO CLI 更新记录
+
+## v1.0.0 (2026-03-31)
+
+### 新特性
+- 初始版本发布
+- 支持 iOS、Android、鸿蒙多平台
+- 内置 uxto-ui 组件库集成
+- 默认生成三个底部导航菜单（首页、UXTO、我的）
+- 完善的项目结构和开发规范
+`;
+export function showChangelog() {
+    console.log();
+    console.log(chalk.cyan('UXTO CLI 更新记录'));
+    console.log();
+    console.log(CHANGELOG);
+}

package/dist/commands/create.d.ts

@@ -0,0 +1 @@
+export declare function createProject(projectName?: string): Promise<void>;

package/dist/commands/create.js

@@ -0,0 +1,65 @@
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import { createRequire } from 'module';
+import { promptProjectOptions, promptInstallDeps } from '../utils/prompt.js';
+import { generateProject, installDependencies } from '../utils/generate.js';
+const require = createRequire(import.meta.url);
+// 获取模板目录 (从 @atooyu/uxto-fronted 包中获取)
+function getTemplateDir() {
+    const uxtoFrontedPath = require.resolve('@atooyu/uxto-fronted/package.json');
+    return path.join(path.dirname(uxtoFrontedPath), 'template');
+}
+const TEMPLATE_DIR = getTemplateDir();
+export async function createProject(projectName) {
+    console.log();
+    console.log(chalk.cyan('🚀 UXTO CLI - 创建 UniApp 项目'));
+    console.log(chalk.gray('  支持 iOS、Android、鸿蒙多平台'));
+    console.log();
+    try {
+        // 1. 获取项目配置
+        const options = await promptProjectOptions(projectName);
+        const targetDir = path.resolve(process.cwd(), options.name);
+        // 检查目录是否已存在
+        if (await fs.pathExists(targetDir)) {
+            console.log(chalk.red(`✖ 目录 ${options.name} 已存在`));
+            process.exit(1);
+        }
+        // 2. 检查模板目录
+        if (!await fs.pathExists(TEMPLATE_DIR)) {
+            console.log(chalk.red('✖ 模板目录不存在'));
+            process.exit(1);
+        }
+        console.log(chalk.gray(`  模板: uxto-starter`));
+        console.log();
+        // 3. 生成项目
+        await generateProject(TEMPLATE_DIR, targetDir, options);
+        // 4. 询问是否安装依赖
+        const shouldInstall = await promptInstallDeps();
+        if (shouldInstall) {
+            await installDependencies(targetDir);
+        }
+        // 5. 完成
+        console.log();
+        console.log(chalk.green('✔ 项目创建成功!'));
+        console.log();
+        console.log('  下一步:');
+        console.log(chalk.cyan(`    cd ${options.name}`));
+        if (!shouldInstall) {
+            console.log(chalk.cyan('    pnpm install'));
+        }
+        console.log(chalk.cyan('    pnpm dev:app      # 开发 App (iOS/Android)'));
+        console.log(chalk.cyan('    pnpm dev:h5       # 开发 H5'));
+        console.log(chalk.cyan('    pnpm dev:harmony  # 开发鸿蒙'));
+        console.log();
+        console.log(chalk.gray('  提示:'));
+        console.log(chalk.gray('    - 在 src/pages.json 中添加页面'));
+        console.log(chalk.gray('    - 在 src/pages/ 中添加页面组件'));
+        console.log(chalk.gray('    - 在 src/static/tabbar/ 中添加导航图标'));
+        console.log();
+    }
+    catch (error) {
+        console.error(chalk.red('✖ 创建项目失败:'), error);
+        process.exit(1);
+    }
+}

package/dist/commands/publish.d.ts

@@ -0,0 +1,9 @@
+interface PublishOptions {
+    registry?: string;
+    tag?: string;
+    access?: 'public' | 'restricted';
+    dryRun?: boolean;
+}
+export declare function publishComponent(options?: PublishOptions): Promise<void>;
+export declare function loginNpm(): Promise<void>;
+export {};

package/dist/commands/publish.js

@@ -0,0 +1,140 @@
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import ora from 'ora';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import inquirer from 'inquirer';
+const execAsync = promisify(exec);
+export async function publishComponent(options = {}) {
+    console.log();
+    console.log(chalk.cyan('📦 UXTO CLI - 发布组件到 NPM'));
+    console.log();
+    try {
+        // 1. 检查是否在 uxto-ui 目录
+        const currentDir = process.cwd();
+        const pkgPath = path.join(currentDir, 'package.json');
+        if (!await fs.pathExists(pkgPath)) {
+            console.log(chalk.red('✖ 未找到 package.json，请在组件库目录下运行此命令'));
+            process.exit(1);
+        }
+        const pkg = await fs.readJson(pkgPath);
+        // 2. 显示当前包信息
+        console.log(chalk.gray('  包名:'), chalk.white(pkg.name));
+        console.log(chalk.gray('  版本:'), chalk.white(pkg.version));
+        console.log(chalk.gray('  描述:'), chalk.white(pkg.description));
+        console.log();
+        // 3. 确认发布
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: '确认发布此组件?',
+                default: false,
+            },
+        ]);
+        if (!confirm) {
+            console.log(chalk.yellow('已取消发布'));
+            return;
+        }
+        // 4. 检查是否需要登录
+        const spinner = ora('检查 npm 登录状态...').start();
+        try {
+            await execAsync('npm whoami');
+            spinner.succeed('已登录 npm');
+        }
+        catch {
+            spinner.warn('未登录 npm，请先登录');
+            console.log();
+            console.log(chalk.cyan('  运行 npm login 进行登录'));
+            console.log();
+            return;
+        }
+        // 5. 构建组件
+        const buildSpinner = ora('构建组件...').start();
+        try {
+            // 检查是否有构建脚本
+            if (pkg.scripts?.['build:all']) {
+                await execAsync('npm run build:all', { cwd: currentDir });
+            }
+            else if (pkg.scripts?.build) {
+                await execAsync('npm run build', { cwd: currentDir });
+            }
+            buildSpinner.succeed('构建完成');
+        }
+        catch (error) {
+            buildSpinner.fail('构建失败');
+            throw error;
+        }
+        // 6. 发布到 npm
+        if (options.dryRun) {
+            console.log(chalk.yellow('\n  [Dry Run] 跳过实际发布'));
+            console.log(chalk.gray('  将执行的命令: npm publish'));
+            if (options.access) {
+                console.log(chalk.gray(`  --access ${options.access}`));
+            }
+            if (options.tag) {
+                console.log(chalk.gray(`  --tag ${options.tag}`));
+            }
+            if (options.registry) {
+                console.log(chalk.gray(`  --registry ${options.registry}`));
+            }
+        }
+        else {
+            const publishSpinner = ora('发布到 npm...').start();
+            let publishCmd = 'npm publish';
+            if (options.access) {
+                publishCmd += ` --access ${options.access}`;
+            }
+            if (options.tag) {
+                publishCmd += ` --tag ${options.tag}`;
+            }
+            if (options.registry) {
+                publishCmd += ` --registry ${options.registry}`;
+            }
+            try {
+                await execAsync(publishCmd, { cwd: currentDir });
+                publishSpinner.succeed('发布成功');
+            }
+            catch (error) {
+                publishSpinner.fail('发布失败');
+                throw error;
+            }
+        }
+        // 7. 完成
+        console.log();
+        console.log(chalk.green('✔ 组件发布成功!'));
+        console.log();
+        console.log(chalk.gray('  安装方式:'));
+        console.log(chalk.cyan(`    npm install ${pkg.name}`));
+        console.log(chalk.cyan(`    pnpm add ${pkg.name}`));
+        console.log(chalk.cyan(`    yarn add ${pkg.name}`));
+        console.log();
+    }
+    catch (error) {
+        console.error(chalk.red('✖ 发布失败:'), error);
+        process.exit(1);
+    }
+}
+export async function loginNpm() {
+    console.log();
+    console.log(chalk.cyan('🔐 登录 NPM'));
+    console.log();
+    try {
+        // 使用 spawn 来保持交互式输入
+        const { spawn } = await import('child_process');
+        const child = spawn('npm', ['login'], { stdio: 'inherit' });
+        child.on('close', (code) => {
+            if (code === 0) {
+                console.log();
+                console.log(chalk.green('✔ 登录成功!'));
+            }
+            else {
+                console.log(chalk.red('✖ 登录失败'));
+            }
+        });
+    }
+    catch (error) {
+        console.error(chalk.red('✖ 登录失败:'), error);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createProject } from './commands/create.js';
+import { publishComponent, loginNpm } from './commands/publish.js';
+import { showChangelog } from './commands/changelog.js';
+// 从 package.json 读取版本号
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const program = new Command();
+program
+    .name('uxto-cli')
+    .description('UXTO UniApp 项目脚手架工具 - 支持 iOS、Android、鸿蒙')
+    .version(pkg.version, '-v, --version', '显示版本号');
+program
+    .command('create [project-name]')
+    .description('创建一个新的 UXTO UniApp 项目')
+    .action(async (projectName) => {
+    await createProject(projectName);
+});
+program
+    .command('init [project-name]')
+    .description('创建一个新的 UXTO UniApp 项目 (create 的别名)')
+    .action(async (projectName) => {
+    await createProject(projectName);
+});
+program
+    .command('publish')
+    .description('发布组件到 NPM')
+    .option('-r, --registry <url>', '指定 npm registry')
+    .option('-t, --tag <tag>', '指定发布标签 (如 beta, next)')
+    .option('-a, --access <access>', '发布范围 (public 或 restricted)')
+    .option('--dry-run', '模拟发布，不实际执行')
+    .action(async (options) => {
+    await publishComponent(options);
+});
+program
+    .command('login')
+    .description('登录 NPM')
+    .action(async () => {
+    await loginNpm();
+});
+program
+    .command('changelog')
+    .description('查看版本更新记录')
+    .action(() => {
+    showChangelog();
+});
+// 处理未知命令
+program.on('command:*', () => {
+    console.error(chalk.red('无效的命令: %s'), program.args.join(' '));
+    console.log(chalk.gray('使用 uxto-cli --help 查看可用命令'));
+    process.exit(1);
+});
+program.parse();

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export interface ProjectOptions {
+    name: string;
+    description: string;
+    author: string;
+}

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/generate.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectOptions } from '../types/index.js';
+export declare function generateProject(templateDir: string, targetDir: string, options: ProjectOptions): Promise<void>;
+export declare function installDependencies(projectDir: string): Promise<void>;

package/dist/utils/generate.js

@@ -0,0 +1,115 @@
+import path from 'path';
+import fs from 'fs-extra';
+import ora from 'ora';
+// 需要排除的目录
+const EXCLUDE_DIRS = ['node_modules', 'dist'];
+// 需要从 package.json 中移除的字段
+const REMOVE_PKG_FIELDS = [
+    'main',
+    'module',
+    'types',
+    'exports',
+    'files',
+    'keywords',
+    'repository',
+];
+// 需要替换模板变量的文件扩展名
+const TEMPLATE_FILE_EXTENSIONS = ['.json', '.html', '.ts', '.js', '.vue', '.md', '.scss'];
+/**
+ * 替换模板变量
+ */
+function replaceTemplateVariables(content, options) {
+    return content
+        .replace(/\{\{\s*name\s*\}\}/g, options.name)
+        .replace(/\{\{\s*description\s*\}\}/g, options.description || '')
+        .replace(/\{\{\s*author\s*\}\}/g, options.author || '')
+        .replace(/<%=\s*appName\s*%>/g, options.name);
+}
+/**
+ * 检查文件是否需要模板替换
+ */
+function isTemplateFile(filePath) {
+    const ext = path.extname(filePath);
+    return TEMPLATE_FILE_EXTENSIONS.includes(ext);
+}
+export async function generateProject(templateDir, targetDir, options) {
+    const spinner = ora('生成项目...').start();
+    try {
+        // 确保目标目录存在
+        await fs.ensureDir(targetDir);
+        // 获取所有模板文件
+        const files = await getAllFiles(templateDir);
+        for (const file of files) {
+            const relativePath = path.relative(templateDir, file);
+            const targetPath = path.join(targetDir, relativePath);
+            // 确保目标目录存在
+            await fs.ensureDir(path.dirname(targetPath));
+            // 检查是否需要模板替换
+            if (isTemplateFile(file)) {
+                let content = await fs.readFile(file, 'utf-8');
+                content = replaceTemplateVariables(content, options);
+                await fs.writeFile(targetPath, content);
+            }
+            else {
+                // 直接复制
+                await fs.copy(file, targetPath);
+            }
+        }
+        // 更新 package.json
+        const pkgPath = path.join(targetDir, 'package.json');
+        if (await fs.pathExists(pkgPath)) {
+            const pkg = await fs.readJson(pkgPath);
+            // 移除无效字段
+            for (const field of REMOVE_PKG_FIELDS) {
+                delete pkg[field];
+            }
+            // 设置项目信息
+            pkg.name = options.name;
+            pkg.description = options.description;
+            if (options.author) {
+                pkg.author = options.author;
+            }
+            await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+        }
+        spinner.succeed('项目生成成功');
+    }
+    catch (error) {
+        spinner.fail('项目生成失败');
+        throw error;
+    }
+}
+/**
+ * 递归获取所有文件
+ */
+async function getAllFiles(dir) {
+    const files = [];
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        // 排除特定目录
+        if (EXCLUDE_DIRS.includes(entry.name)) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            files.push(...await getAllFiles(fullPath));
+        }
+        else {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+export async function installDependencies(projectDir) {
+    const spinner = ora('安装依赖...').start();
+    try {
+        const { exec } = await import('child_process');
+        const { promisify } = await import('util');
+        const execAsync = promisify(exec);
+        await execAsync('pnpm install', { cwd: projectDir });
+        spinner.succeed('依赖安装成功');
+    }
+    catch (error) {
+        spinner.fail('依赖安装失败');
+        throw error;
+    }
+}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectOptions } from '../types/index.js';
+export declare function promptProjectOptions(defaultName?: string): Promise<ProjectOptions>;
+export declare function promptInstallDeps(): Promise<boolean>;

package/dist/utils/prompt.js

@@ -0,0 +1,44 @@
+import inquirer from 'inquirer';
+export async function promptProjectOptions(defaultName) {
+    const questions = [
+        {
+            type: 'input',
+            name: 'name',
+            message: '项目名称:',
+            default: defaultName || 'uxto-project',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return '项目名称不能为空';
+                }
+                if (!/^[a-zA-Z0-9_-]+$/.test(input)) {
+                    return '项目名称只能包含字母、数字、下划线和中划线';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'description',
+            message: '项目描述:',
+            default: 'UXTO UniApp 项目 - 支持 iOS、Android、鸿蒙',
+        },
+        {
+            type: 'input',
+            name: 'author',
+            message: '作者:',
+            default: '',
+        },
+    ];
+    return inquirer.prompt(questions);
+}
+export async function promptInstallDeps() {
+    const { install } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'install',
+            message: '是否安装依赖?',
+            default: true,
+        },
+    ]);
+    return install;
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@atooyu/uxto-cli",
+  "version": "1.0.0",
+  "description": "UXTO UniApp 项目脚手架工具 - 支持 iOS、Android、鸿蒙",
+  "type": "module",
+  "bin": {
+    "uxto": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "cli",
+    "scaffold",
+    "uxto",
+    "uniapp",
+    "vue",
+    "mobile",
+    "ios",
+    "android",
+    "harmony",
+    "atooyu"
+  ],
+  "author": "atooyu <chujingu@163.com>",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.15",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.30",
+    "typescript": "^5.4.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}