@minij/cli 0.0.1

package/CLAUDE.md

@@ -0,0 +1,23 @@
+# 小吉 AI 执行规范 (High Performance)
+
+## 核心原则
+- **优先 CLI**：所有操作（建站、建仓、初始化、部署）必须通过 `minij` CLI 完成。
+- **环境隔离**：仅限 608 内网。API: `http://192.168.50.41:8888`。
+- **禁止手动**：禁止使用 git clone/init/push 替代 CLI，除非用户明确要求。
+
+## 指令映射表
+| 需求场景 | 动作 / 预设 | 命令 |
+| :--- | :--- | :--- |
+| **新建项目** | 需确认 <英文名> | `minij create <name> [--port <port>]` |
+| **部署/发布** | 需确认 <项目名> | `minij server-deploy <name>` |
+| **初始化环境** | 直接执行 | `minij init` |
+
+## 业务逻辑约束
+1. **参数校验**：
+   - 英文名：仅限字母、数字、-、_。
+   - 端口：3000-3100 (默认 3001)。
+2. **缺省策略**：
+   - 无英文名：主动询问。
+   - 无端口：直接执行 `minij create <name>` 由 CLI 接管提示。
+   - 中文名：默认使用英文名，无需确认。
+3. **基础设施**：GitLab (`git.minij.com`)，用户 (`deployer-bot`)。

package/README.md

@@ -0,0 +1,203 @@
+# @minij/cli
+
+minij 一键建站方案的本地触发端，负责本地项目初始化、模板替换，并协调 `minij-orchestrator-server` 完成 GitLab 仓库创建和 CI/CD 变量注入。
+
+> **注意：需在minij 608 内网中使用。**
+> orchestrator 服务固定部署在 `http://192.168.50.41:8888`，不在内网无法连接。
+
+---
+
+## 安装
+
+```bash
+npm install -g @minij/cli
+# 或
+pnpm add -g @minij/cli
+```
+
+## 前置要求
+
+- Node.js >= 18
+- pnpm
+- Git
+- SSH 公钥已配置到 `git.minij.com`
+- 处于minij 608 内网环境
+
+---
+
+## 命令
+
+### minij create \<name\>
+
+一键创建项目：克隆模板 → 替换项目名 → 创建 GitLab 仓库 → 注入 CI/CD 变量 → 初始化 git 并推送。
+
+```bash
+minij create my-project
+# 或指定 Node 端口（跳过交互提示）
+minij create my-project --port 3002
+```
+
+**选项**
+
+| 选项 | 说明 |
+|------|------|
+| `-p, --port <port>` | Node 服务端口，范围 3000-3100，默认 3001 |
+
+**执行流程**
+
+1. 从 `git@git.minij.com:dataverse/minij-bi-admin-template.git` 克隆模板
+2. 删除 `.git` 目录
+3. 全局替换模板中的 `minij-bi-admin-template` 为项目名
+4. 写入 `backend/.env` 的 `PORT` 值
+5. 调用 orchestrator `POST /api/create-repo` 创建 GitLab 私有仓库
+6. 调用 orchestrator `POST /api/setup-ci-variables` 注入 CI/CD 变量
+7. `git init → commit → push -u origin main`
+
+**完成后输出**
+
+```
+✓ 项目 my-project 创建完成！
+
+目录: /path/to/my-project
+远程仓库: git@git.minij.com:dataverse/my-project.git
+Node 端口: 3002
+
+访问地址（CI 部署完成后）：
+https://dataverse.minij.com/DataVerse/my-project/
+```
+
+---
+
+### minij init
+
+在当前目录生成 `CLAUDE.md`（AI 助手执行规则），并检查 SSH 到 GitLab 的连通���。
+
+```bash
+minij init
+```
+
+SSH 检查失败时会提示配置步骤：
+
+```bash
+ssh-keygen -t ed25519 -C "your_email@example.com"
+cat ~/.ssh/id_ed25519.pub
+# 将公钥添加到 git.minij.com → Settings → SSH Keys
+```
+
+---
+
+### minij server-deploy \<name\>
+
+调用 orchestrator `POST /api/setup-router` 为项目分配端口并配置 Nginx 路由。
+
+```bash
+minij server-deploy my-project
+```
+
+> 当前 DataVerse 体系前端通过 CI/CD 直接部署，通常不需要单独调用此命令。
+
+---
+
+## 完整工作流
+
+```bash
+# 1. 检查环境（首次使用）
+minij init
+
+# 2. 一键创建项目
+minij create my-project --port 3002
+
+# 3. 进入项目目录，开始开发
+cd my-project
+
+# 4. 推送代码触发 CI/CD 自动部署
+git add .
+git commit -m "feat: ..."
+git push
+
+# 5. 部署完成后访问
+# https://dataverse.minij.com/DataVerse/my-project/
+```
+
+---
+
+## 本地开发测试
+
+### 1. 安装依赖并构建
+
+```bash
+pnpm install
+pnpm build
+```
+
+### 2. 本地挂载 CLI
+
+在 `minij-cli` 目录执行：
+
+```bash
+pnpm link --global
+```
+
+挂载完成后，可直接在终端使用：
+
+```bash
+minij --version
+minij init
+```
+
+### 3. 测试创建项目全流程
+
+> 需确保当前机器已连接minij 608 内网，且 `minij-orchestrator-server` 已部署在 `http://192.168.50.41:8888`。
+
+```bash
+minij create test-demo --port 3002
+```
+
+该命令会验证以下完整链路：
+
+1. 克隆模板仓库
+2. 替换项目名
+3. 调用 orchestrator 创建 GitLab 仓库
+4. 注入 GitLab CI/CD 变量
+5. 初始化 git 并推送到远程仓库
+
+### 4. 修改代码后重新测试
+
+每次修改 CLI 源码后，重新执行：
+
+```bash
+pnpm build
+```
+
+然后再次运行：
+
+```bash
+minij create another-demo --port 3003
+```
+
+### 5. 如需取消全局挂载
+
+```bash
+pnpm unlink --global @minij/cli
+```
+
+---
+
+## 配置
+
+CLI 默认连接 `http://192.168.50.41:8888`，无需手动配置。
+
+如需覆盖，可编辑 `~/.minij/config.json`：
+
+```json
+{
+  "ORCHESTRATOR_URL": "http://192.168.50.41:8888"
+}
+```
+
+---
+
+## 项目名规范
+
+- 只能包含字母、数字、中划线、下划线
+- 示例：`my-project`、`data_dashboard`、`bi2025`

package/bin/minij.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/index.js';

package/deploy.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+set -e
+
+cd "$(dirname "$0")"
+
+echo "📦 构建项目..."
+pnpm build
+
+echo "🔍 检查 Git 工作区..."
+if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  if [ -n "$(git status --porcelain)" ]; then
+    echo "❌ 检测到未提交的 Git 变更，已取消发布。"
+    echo ""
+    echo "当前变更："
+    git status --short
+    echo ""
+    echo "请先处理后再重试，你可以选择："
+    echo "1. 提交改动后重新执行 bash deploy.sh"
+    echo "2. 临时 stash 改动后重新执行 bash deploy.sh"
+    echo "3. 如确需跳过检查，手动执行：pnpm publish --no-git-checks --registry=https://registry.npmjs.org/"
+    exit 1
+  fi
+  echo "✅ Git 工作区干净"
+else
+  echo "⚠️  当前目录不在 Git 仓库中，跳过 Git 状态检查"
+fi
+
+echo "🚀 发布到 npm..."
+pnpm publish --tag beta --access public --registry=https://registry.npmjs.org/
+
+echo "✅ 发布完成！"
+echo "查看: https://www.npmjs.com/package/@minij/cli"

package/local_deploy.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+set -e
+
+cd "$(dirname "$0")"
+
+echo "📦 构建项目..."
+pnpm build
+
+echo "🚀 部署到本地..."
+pnpm link --global
+
+echo "✅ 部署完成！"
+echo "minij -h"

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@minij/cli",
+  "version": "0.0.1",
+  "description": "minij 一键建站方案 - 本地触发端",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "minij": "./bin/minij.js"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.0.1",
+    "shelljs": "^0.8.5"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.10.0",
+    "@types/shelljs": "^0.8.15",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublish": "npm run build"
+  }
+}

package/src/commands/create.ts

@@ -0,0 +1,94 @@
+import chalk from 'chalk';
+import shelljs from 'shelljs';
+const shell = shelljs;
+import fs from 'fs-extra';
+import path from 'path';
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { TEMPLATE_URL } from '../constants.js';
+import { withLoader } from '../utils/loader.js';
+import { applyTemplateReplacements } from '../utils/template-replacer.js';
+import { createGitlabRepo, initLocalGitRepo, setupCiVariables } from '../services/gitlab.js';
+
+export interface CreateCommandOptions {
+  port?: string;
+}
+
+export async function createCommand(name: string, options: CreateCommandOptions = {}): Promise<void> {
+  validateProjectName(name);
+
+  const projectPath = path.resolve(name);
+  if (await fs.pathExists(projectPath)) {
+    throw new Error(`目录已存在: ${projectPath}`);
+  }
+
+  const backendPort = await resolveBackendPort(options.port);
+
+  await withLoader(`正在克隆模板到 ${name}...`, async () => {
+    const result = shell.exec(`git clone ${TEMPLATE_URL} ${name}`, { silent: true });
+    if (result.code !== 0) {
+      throw new Error(`克隆失败: ${result.stderr}`);
+    }
+  });
+
+  await withLoader('正在清理 .git 目录...', async () => {
+    await fs.remove(path.join(projectPath, '.git'));
+  });
+
+  await withLoader('正在替换模板内容...', async () => {
+    await applyTemplateReplacements(projectPath, name, backendPort);
+  });
+
+  const { sshUrl, projectId } = await createGitlabRepo(name);
+  await setupCiVariables(projectId, name, backendPort);
+  await initLocalGitRepo(projectPath, sshUrl);
+
+  const url = `https://dataverse.minij.com/DataVerse/${name}/`;
+
+  console.log(chalk.green(`\n✓ 项目 ${name} 创建完成！`));
+  console.log(chalk.white('\n项目信息：'));
+  console.log(chalk.gray(`目录: ${projectPath}`));
+  console.log(chalk.gray(`远程仓库: ${sshUrl}`));
+  console.log(chalk.gray(`Node 端口: ${backendPort}`));
+  console.log(chalk.yellow('\n提示：GitLab CI/CD 正在构建，约 20S后可访问'));
+  console.log(chalk.white('\n访问地址：'));
+  console.log(chalk.bold.blue(`\x1b]8;;${url}\x1b\\${url}\x1b]8;;\x1b\\`));
+  console.log(chalk.gray('\n下一步：'));
+  console.log(chalk.gray(`cd ${name}`));
+  console.log(chalk.gray(`minij server-deploy ${name}`));
+}
+
+function validateProjectName(name: string): void {
+  const validNamePattern = /^[a-zA-Z0-9_-]+$/;
+  if (!validNamePattern.test(name)) {
+    throw new Error('项目名仅支持字母、数字、中划线和下划线');
+  }
+}
+
+async function resolveBackendPort(inputPort?: string): Promise<string> {
+  if (inputPort) {
+    validateBackendPort(inputPort);
+    return inputPort;
+  }
+
+  const rl = readline.createInterface({ input, output });
+  try {
+    const answer = await rl.question('请输入 Node 服务端口号（3000-3100，默认 3001）: ');
+    const backendPort = answer.trim() || '3001';
+    validateBackendPort(backendPort);
+    return backendPort;
+  } finally {
+    rl.close();
+  }
+}
+
+function validateBackendPort(port: string): void {
+  if (!/^\d+$/.test(port)) {
+    throw new Error('Node 服务端口号必须是数字，范围 3000-3100，默认 3001');
+  }
+
+  const numericPort = Number(port);
+  if (numericPort < 3000 || numericPort > 3100) {
+    throw new Error('Node 服务端口号必须在 3000 到 3100 之间，默认 3001');
+  }
+}

package/src/commands/init.ts

@@ -0,0 +1,118 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import { checkSshConnectivity } from '../utils/ssh.js';
+
+const CLAUDE_MD_CONTENT = `# 小吉 AI 执行规则
+
+你是小吉建站系统的 AI 助手。
+
+## 总原则
+
+- 本项目中的建站、创建仓库、初始化代码、推送代码、部署服务，**优先使用 \`minij\` CLI**。
+- **不要手动执行** clone 模板、修改项目名、创建 GitLab 仓库、初始化 git、推送代码，除非用户明确要求你不要使用 CLI。
+- 当用户表达的目标已经对应到现有 CLI 能力时，直接调用 CLI，不要自己拆步骤重做。
+
+## 环境要求
+
+> **重要**：minij CLI 需在 **小吉 608 内网** 中使用。
+> orchestrator 服务固定部署在 \`http://192.168.50.41:8888\`，不在内网无法连接。
+
+## 创建项目
+
+当用户提出以下任一需求时：
+- 新建项目
+- 创建项目
+- 帮我建一个项目
+- 帮我初始化一个新项目
+- 帮我从模板创建项目
+
+你的处理规则：
+
+1. 如果用户**还没有提供项目英文名**，先询问项目英文名。
+2. 如果用户**已经提供项目英文名和 Node 端口**，直接执行：
+
+\`\`\`bash
+minij create <项目英文名> --port <Node端口>
+\`\`\`
+
+3. 如果用户**只提供了项目英文名**，直接执行：
+
+\`\`\`bash
+minij create <项目英文名>
+\`\`\`
+
+此时 CLI 会继续询问 Node 服务端口（3000-3100，默认 3001）。
+
+4. 执行 \`minij create\` 时，不要改用手动 git 命令替代。
+5. 项目显示名默认直接使用英文项目名，不再单独询问中文项目名。
+
+## 部署项目
+
+当用户提出以下任一需求时：
+- 部署项目
+- 发布项目
+- 帮我部署
+- 帮我发布服务
+
+直接执行：
+
+\`\`\`bash
+minij server-deploy <项目名>
+\`\`\`
+
+如果用户没有提供项目名，先询问项目名。
+
+## 初始化环境
+
+当用户提出以下任一需求时：
+- 初始化环境
+- 检查环境
+- 初始化小吉环境
+
+直接执行：
+
+\`\`\`bash
+minij init
+\`\`\`
+
+## 禁止事项
+
+在以下场景中，禁止跳过 CLI 直接手动操作：
+- 创建项目
+- 从模板生成项目
+- 创建 GitLab 仓库
+- 初始化项目 git
+- 首次推送代码
+- 部署服务
+
+除非用户明确说：
+- 不要用 minij
+- 我想手动执行
+- 只给我命令，不要帮我执行
+
+## 额外约束
+
+- 项目英文名只能包含字母、数字、中划线、下划线
+- Node 服务端口必须在 3000-3100 之间，默认 3001
+- 必须在小吉 608 内网环境中执行，orchestrator 地址：\`http://192.168.50.41:8888\`
+- 默认 GitLab 主机是 \`git.minij.com\`
+- 默认创建仓库用户是 \`deployer-bot\`
+`;
+
+export async function initCommand(): Promise<void> {
+  await fs.writeFile('CLAUDE.md', CLAUDE_MD_CONTENT, 'utf-8');
+  console.log(chalk.green('✓ CLAUDE.md 文件已生成'));
+
+  const sshResult = await checkSshConnectivity();
+
+  if (sshResult.success) {
+    console.log(chalk.green(`✓ ${sshResult.message}`));
+  } else {
+    console.log(chalk.red(`✗ ${sshResult.message}`));
+    console.log(chalk.yellow('\n请按以下步骤配置 SSH 公钥：'));
+    console.log(chalk.cyan('1. 生成 SSH 密钥对：ssh-keygen -t ed25519 -C "your_email@example.com"'));
+    console.log(chalk.cyan('2. 查看公钥：cat ~/.ssh/id_ed25519.pub'));
+    console.log(chalk.cyan('3. 复制公钥到 GitLab -> Settings -> SSH Keys'));
+    process.exit(1);
+  }
+}

package/src/commands/server-deploy.ts

@@ -0,0 +1,40 @@
+import chalk from 'chalk';
+import axios from 'axios';
+import { withLoader } from '../utils/loader.js';
+import { getOrchestratorUrl } from '../utils/config.js';
+
+interface SetupRouterResponse {
+  success: boolean;
+  url: string;
+}
+
+export async function serverDeployCommand(name: string): Promise<void> {
+  const orchestratorUrl = await getOrchestratorUrl();
+
+  // 调用远程接口设置路由
+  const resultUrl = await withLoader('正在部署服务...', async () => {
+    try {
+      const response = await axios.post<SetupRouterResponse>(
+        `${orchestratorUrl}/api/setup-router`,
+        {
+          projectName: name
+        }
+      );
+
+      if (!response.data.success) {
+        throw new Error('部署失败');
+      }
+
+      return response.data.url;
+    } catch (error) {
+      if (axios.isAxiosError(error)) {
+        throw new Error(`API 请求失败: ${error.message}`);
+      }
+      throw error;
+    }
+  });
+
+  console.log(chalk.green(`\n✓ 服务部署完成！`));
+  console.log(chalk.cyan(`\n访问地址：`));
+  console.log(chalk.bold.underline(resultUrl));
+}

package/src/constants.ts

@@ -0,0 +1,11 @@
+// 模板地址配置
+export const TEMPLATE_URL = 'git@git.minij.com:dataverse/minij-bi-admin-template.git';
+
+// GitLab 配置
+export const GITLAB_HOST = 'git.minij.com';
+
+// 编排服务地址（固定部署在小吉 608 内网，需在该内网环境下使用）
+export const DEFAULT_ORCHESTRATOR_URL = 'http://192.168.50.41:8888';
+
+// 配置文件路径
+export const CONFIG_PATH = `${process.env.HOME}/.minij/config.json`;

package/src/index.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { initCommand } from './commands/init.js';
+import { serverDeployCommand } from './commands/server-deploy.js';
+import { createCommand } from './commands/create.js';
+
+const program = new Command();
+
+program
+  .name('minij')
+  .description('minij一键建站方案 - 本地触发端')
+  .version('1.0.0');
+
+program
+  .command('create <name>')
+  .description('一键创建项目：克隆模板、替换项目名、创建 GitLab 仓库、初始化 git 并推送')
+  .option('-p, --port <port>', 'Node 服务端口号（3000-3100，默认 3001）')
+  .action(async (name: string, options: { port?: string }) => {
+    try {
+      await createCommand(name, options);
+    } catch (error) {
+      console.error(chalk.red(`\n错误: ${(error as Error).message}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('init')
+  .description('初始化项目环境，生成 CLAUDE.md 并检查 SSH 配置')
+  .action(async () => {
+    try {
+      await initCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n错误: ${(error as Error).message}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('server-deploy <name>')
+  .description('调用远程接口部署服务')
+  .action(async (name: string) => {
+    try {
+      await serverDeployCommand(name);
+    } catch (error) {
+      console.error(chalk.red(`\n错误: ${(error as Error).message}`));
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/services/gitlab.ts

@@ -0,0 +1,94 @@
+import shelljs from 'shelljs';
+const shell = shelljs;
+import axios from 'axios';
+import { withLoader } from '../utils/loader.js';
+import { getOrchestratorUrl } from '../utils/config.js';
+
+interface CreateRepoResponse {
+  success?: boolean;
+  sshUrl: string;
+  projectId: number;
+}
+
+export interface CreateGitlabRepoResult {
+  sshUrl: string;
+  projectId: number;
+}
+
+export async function createGitlabRepo(name: string): Promise<CreateGitlabRepoResult> {
+  const orchestratorUrl = await getOrchestratorUrl();
+
+  return withLoader('正在创建 GitLab 仓库...', async () => {
+    try {
+      const response = await axios.post<CreateRepoResponse>(
+        `${orchestratorUrl}/api/create-repo`,
+        { projectName: name, userName: 'deployer-bot' }
+      );
+
+      if (!response.data.sshUrl || !response.data.projectId) {
+        throw new Error('接口未返回完整的仓库信息');
+      }
+
+      return {
+        sshUrl: response.data.sshUrl,
+        projectId: response.data.projectId,
+      };
+    } catch (error) {
+      if (axios.isAxiosError(error)) {
+        throw new Error(`API 请求失败: ${error.message}`);
+      }
+      throw error;
+    }
+  });
+}
+
+export async function setupCiVariables(
+  projectId: number,
+  name: string,
+  backendPort: string
+): Promise<void> {
+  const orchestratorUrl = await getOrchestratorUrl();
+
+  await withLoader('正在绑定 CI/CD 变量...', async () => {
+    try {
+      await axios.post(`${orchestratorUrl}/api/setup-ci-variables`, {
+        projectId,
+        name,
+        backendPort,
+      });
+    } catch (error) {
+      if (axios.isAxiosError(error)) {
+        throw new Error(`API 请求失败: ${error.message}`);
+      }
+      throw error;
+    }
+  });
+}
+
+export async function initLocalGitRepo(projectPath: string, sshUrl: string): Promise<void> {
+  await withLoader('正在初始化 Git 仓库...', async () => {
+    const result = shell.exec('git init', { silent: true, cwd: projectPath });
+    if (result.code !== 0) throw new Error(`git init 失败: ${result.stderr}`);
+
+    const branchResult = shell.exec('git branch -M main', { silent: true, cwd: projectPath });
+    if (branchResult.code !== 0) throw new Error(`git branch 失败: ${branchResult.stderr}`);
+  });
+
+  await withLoader('正在添加远程仓库...', async () => {
+    const result = shell.exec(`git remote add origin ${sshUrl}`, { silent: true, cwd: projectPath });
+    if (result.code !== 0) throw new Error(`添加远程仓库失败: ${result.stderr}`);
+  });
+
+  await withLoader('正在提交初始代码...', async () => {
+    const addResult = shell.exec('git add .', { silent: true, cwd: projectPath });
+    if (addResult.code !== 0) throw new Error(`git add 失败: ${addResult.stderr}`);
+
+    const commitResult = shell.exec('git commit -m "chore: init project"', { silent: true, cwd: projectPath });
+    if (commitResult.code !== 0) throw new Error(`git commit 失败: ${commitResult.stderr}`);
+  });
+
+  await withLoader('正在推送初始代码...', async () => {
+    const result = shell.exec('git push -u origin main', { silent: true, cwd: projectPath });
+    if (result.code !== 0) throw new Error(`git push 失败: ${result.stderr}`);
+  });
+}

package/src/utils/config.ts

@@ -0,0 +1,28 @@
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import { CONFIG_PATH, DEFAULT_ORCHESTRATOR_URL } from '../constants.js';
+
+export interface MinijConfig {
+  ORCHESTRATOR_URL: string;
+}
+
+export async function loadConfig(): Promise<MinijConfig> {
+  try {
+    const config = await fs.readJson(CONFIG_PATH);
+    return config as MinijConfig;
+  } catch {
+    // 配置文件不存在，返回默认值
+    return { ORCHESTRATOR_URL: DEFAULT_ORCHESTRATOR_URL };
+  }
+}
+
+export async function saveConfig(config: MinijConfig): Promise<void> {
+  await fs.ensureFile(CONFIG_PATH);
+  await fs.writeJson(CONFIG_PATH, config, { spaces: 2 });
+}
+
+export async function getOrchestratorUrl(): Promise<string> {
+  const config = await loadConfig();
+  console.log(chalk.gray(`提示：minij CLI 需在小吉 608 内网中使用，服务地址：${config.ORCHESTRATOR_URL}`));
+  return config.ORCHESTRATOR_URL;
+}

package/src/utils/loader.ts

@@ -0,0 +1,25 @@
+import ora, { Ora } from 'ora';
+
+export function createLoader(text: string): Ora {
+  return ora({
+    text,
+    color: 'cyan'
+  });
+}
+
+export async function withLoader<T>(
+  text: string,
+  fn: () => Promise<T>
+): Promise<T> {
+  const spinner = createLoader(text);
+  spinner.start();
+
+  try {
+    const result = await fn();
+    spinner.succeed();
+    return result;
+  } catch (error) {
+    spinner.fail();
+    throw error;
+  }
+}

package/src/utils/ssh.ts

@@ -0,0 +1,47 @@
+import shelljs from 'shelljs';
+const { exec } = shelljs;
+import chalk from 'chalk';
+import { GITLAB_HOST } from '../constants.js';
+
+export interface SshCheckResult {
+  success: boolean;
+  message: string;
+}
+
+export async function checkSshConnectivity(): Promise<SshCheckResult> {
+  return new Promise((resolve) => {
+    const command = `ssh -T git@${GITLAB_HOST} 2>&1`;
+
+    exec(command, { silent: true }, (code, stdout, stderr) => {
+      const output = stdout + stderr;
+      const lowerOutput = output.toLowerCase();
+
+      // 成功标志：GitLab 系列或 Gitee 的欢迎语，或包含用户名提示
+      const isSuccess =
+        lowerOutput.includes('welcome to gitlab') ||
+        lowerOutput.includes('welcome to gitee') ||
+        lowerOutput.includes('you\'ve successfully authenticated') ||
+        // 私有部署的 GitLab 通常也会包含用户名
+        lowerOutput.includes('hi ');
+
+      // 明确失败标志
+      const isFail =
+        lowerOutput.includes('permission denied') ||
+        lowerOutput.includes('publickey') ||
+        lowerOutput.includes('no such host') ||
+        lowerOutput.includes('connection refused');
+
+      if (isSuccess || (!isFail && output.length > 0)) {
+        resolve({
+          success: true,
+          message: 'SSH 连接成功'
+        });
+      } else {
+        resolve({
+          success: false,
+          message: 'SSH 连接失败，请先配置公钥'
+        });
+      }
+    });
+  });
+}

package/src/utils/template-replacer.ts

@@ -0,0 +1,84 @@
+import fs from 'fs-extra';
+import path from 'path';
+
+const TEMPLATE_NAME = 'minij-bi-admin-template';
+
+export async function applyTemplateReplacements(
+  projectPath: string,
+  name: string,
+  backendPort: string
+): Promise<void> {
+  await replaceJsonField(path.join(projectPath, 'package.json'), (pkg) => {
+    pkg.name = name;
+    return pkg;
+  });
+
+  await replaceInFile(
+    path.join(projectPath, 'frontend/index.html'),
+    /<title>[^<]*<\/title>/,
+    `<title>${name}</title>`
+  );
+
+  await replaceAllInFile(path.join(projectPath, 'frontend/vite.config.ts'), TEMPLATE_NAME, name);
+
+  await replaceInFile(
+    path.join(projectPath, 'frontend/src/router/index.ts'),
+    /createWebHistory\([^)]*\)/g,
+    `createWebHistory('/DataVerse/${name}/')`
+  );
+
+  await replaceAllInFile(path.join(projectPath, 'frontend/src/router/guards.ts'), TEMPLATE_NAME, name);
+  await replaceAllInFile(path.join(projectPath, 'frontend/src/layouts/AdminLayout.vue'), TEMPLATE_NAME, name);
+  await replaceAllInFile(path.join(projectPath, 'frontend/src/views/home/HomeView.vue'), TEMPLATE_NAME, name);
+  await replaceAllInFile(path.join(projectPath, '.gitlab-ci.yml'), TEMPLATE_NAME, name);
+  await replaceAllInFile(path.join(projectPath, 'README.md'), TEMPLATE_NAME, name);
+
+  await replaceEnvValue(path.join(projectPath, 'backend/.env'), 'PORT', backendPort);
+
+  // 替换前端生产环境 API 地址
+  await replaceEnvValue(
+    path.join(projectPath, 'frontend/.env.production'),
+    'VITE_API_BASE_URL',
+    `https://node.minij.com/DataVerse/${name}`
+  );
+}
+
+async function replaceInFile(
+  filePath: string,
+  pattern: RegExp | string,
+  replacement: string
+): Promise<void> {
+  if (!(await fs.pathExists(filePath))) return;
+  const content = await fs.readFile(filePath, 'utf-8');
+  await fs.writeFile(filePath, content.replace(pattern, replacement), 'utf-8');
+}
+
+async function replaceAllInFile(
+  filePath: string,
+  search: string,
+  replacement: string
+): Promise<void> {
+  if (!(await fs.pathExists(filePath))) return;
+  const content = await fs.readFile(filePath, 'utf-8');
+  if (!content.includes(search)) return;
+  await fs.writeFile(filePath, content.split(search).join(replacement), 'utf-8');
+}
+
+async function replaceEnvValue(filePath: string, key: string, value: string): Promise<void> {
+  if (!(await fs.pathExists(filePath))) return;
+  const content = await fs.readFile(filePath, 'utf-8');
+  const pattern = new RegExp(`^${key}=.*$`, 'm');
+  const modified = pattern.test(content)
+    ? content.replace(pattern, `${key}=${value}`)
+    : `${content.trimEnd()}\n${key}=${value}\n`;
+  await fs.writeFile(filePath, modified, 'utf-8');
+}
+
+async function replaceJsonField(
+  filePath: string,
+  transform: (obj: Record<string, unknown>) => Record<string, unknown>
+): Promise<void> {
+  if (!(await fs.pathExists(filePath))) return;
+  const obj = await fs.readJson(filePath);
+  await fs.writeJson(filePath, transform(obj), { spaces: 2 });
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}