qdmp-cli 0.0.1

package/README.md

@@ -0,0 +1,17 @@
+# QDMP CLI 
+
+千岛小程序开发平台命令行工具
+
+
+## ✨ 功能特性
+- 项目初始化与模板管理
+- 用户认证与权限管理
+- 小程序版本上传与发布
+- 开发工作流自动化
+
+## 🚀 快速开始
+
+### 安装
+```bash
+npm install -g qdmp-cli
+```

package/actions.js

@@ -0,0 +1,140 @@
+import shell from "shelljs";
+import { error, info, success } from "./utils/logHandler.js";
+import { TEMPLATES } from "./constants.js";
+import { download } from "./utils/gitClone.js";
+import { printLogo } from "./utils/logHandler.js";
+import chalk from "chalk";
+import table from "table";
+import { inquirerAccountPassword } from "./utils/interactive.js";
+import { login, getUserInfo } from "./api.js";
+import fs from "fs";
+import {
+  getUploadPath,
+  getAppId,
+  isUrlAccessible,
+  preUpload,
+  cleanWorkSpaceFolder,
+} from "./utils/common.js";
+import { getAppInfo, uploadVersion, uploadApp } from "./api.js";
+
+function createProject(appName, template) {
+  printLogo();
+  if (template) {
+    console.log("\n" + chalk.dim("─".repeat(60)) + "\n");
+    info(
+      `${template.emoji}  已为 ${chalk.bold(
+        appName
+      )} 选择模版：${chalk.underline(template.name)}`
+    );
+    info(`   ${chalk.dim("描述:")} ${template.desc}`);
+    info(`   ${chalk.dim("仓库:")} ${chalk.green(template.value)}`);
+    info(`⏳ 正在创建 ${chalk.bold(appName)} 项目...`);
+    console.log("\n" + chalk.dim("─".repeat(60)) + "\n");
+    download(appName, template.value);
+  } else {
+    listAction();
+    error(`未找到模板`);
+  }
+}
+
+export const initAction = async (appName, option) => {
+  if (!shell.which("git")) {
+    error("未安装git");
+  }
+  const invalidChars = /[\u4E00-\u9FFF`~!@#$%^&*()_+=\[\]{};':"\\|,.<>\/?]/g;
+  if (appName.match(invalidChars)) {
+    error("名称不能包含中文及特殊字符");
+  }
+  const inputTemplate = option.template || TEMPLATES[0].name;
+  const template = TEMPLATES.find((t) => t.name === inputTemplate);
+  await createProject(appName, template);
+};
+
+export const listAction = () => {
+  console.log(chalk.green.bold("\n📋 可选模版:"));
+  const tableData = [
+    [
+      chalk.cyan.bold("序号"),
+      chalk.cyan.bold("模版名称"),
+      chalk.cyan.bold("描述"),
+      chalk.cyan.bold("仓库路径"),
+    ],
+  ];
+  TEMPLATES.forEach((t, i) => {
+    tableData.push([
+      chalk.gray(`${i + 1}`),
+      `${t.emoji} ${chalk.yellow(t.name)}`,
+      chalk.white(t.desc),
+      chalk.green(t.value),
+    ]);
+  });
+
+  console.log(table.table(tableData));
+};
+
+export const loginAction = async () => {
+  try {
+    const { account, password } = await inquirerAccountPassword();
+    const result = await login(account, password);
+    if (result.success) {
+      success("登录成功");
+    } else {
+      error("登录失败");
+    }
+  } catch (e) {
+    error(e.message);
+  }
+};
+export const getMyInfoAction = async () => {
+  try {
+    const nickname = await getUserInfo();
+    const appId = await getAppId();
+    const appInfo = await getAppInfo(appId);
+    info(`当前用户：${nickname}`);
+    info(`当前授权应用：${appInfo?.name} - ${appId}`);
+  } catch (error) {
+    error(error?.message);
+  }
+};
+
+export async function uploadAction() {
+  try {
+    const appId = await getAppId();
+    if (!appId) {
+      error("未授权应用，请在根目录下qdmp.json配置对应的appId");
+    }
+    const remoteApp = await getAppInfo(appId);
+    if (!remoteApp) {
+      error("未找到应用，请检查appId是否正确");
+    }
+    const code = +remoteApp.latest + 1;
+    const uploadPath = getUploadPath(appId, code);
+    const url = `https://crane.qiandaocdn.com/${uploadPath}`;
+
+    // 预上传
+    const targetName = `${appId}_${code}`;
+    const localPath = await preUpload(targetName);
+    if (!localPath) {
+      error("预上传失败");
+    }
+    // 添加文件存在检查
+    if (!fs.existsSync(localPath)) {
+      error(`压缩文件 ${localPath} 未生成`);
+    }
+    // 上传到oss;
+    await uploadApp(uploadPath, localPath);
+    const isAccessible = await isUrlAccessible(url);
+    if (!isAccessible) {
+      error("上传链接不可用，请检查网络是否正常");
+    }
+    // 更新远端版本信息;
+    await uploadVersion(appId, url);
+    // 清理工作文件夹;
+    await cleanWorkSpaceFolder();
+    success(
+      `上传成功，版本号：${code}，可前往官网进行小程序发布：https://mp.qiandao.com`
+    );
+  } catch (e) {
+    error(`${e.message}`);
+  }
+}

package/api.js

@@ -0,0 +1,157 @@
+import { getToken, saveToken } from "./utils/authorized.js";
+import fs from "fs";
+import { promisify } from "util";
+
+const readFile = promisify(fs.readFile);
+// API 基础配置
+const API_CONFIG = {
+  baseURL: "https://api.qiandao.com",
+  timeout: 10000,
+  headers: {
+    "content-type": "application/json",
+  },
+};
+
+/**
+ * 基础请求函数
+ * @param {string} url - 请求地址
+ * @param {object} options - 请求选项
+ * @returns {Promise} 请求结果
+ */
+export const request = async (url, options = {}) => {
+  const config = {
+    method: "GET",
+    headers: { ...API_CONFIG.headers },
+    ...options,
+  };
+
+  // 添加认证头（如果有 token）
+  const token = getToken();
+  if (token) {
+    config.headers["authorization"] = `Bearer ${token}`;
+  }
+
+  try {
+    const response = await fetch(`${API_CONFIG.baseURL}${url}`, config);
+
+    // 检查响应状态
+    if (!response.ok) {
+      if (response.status === 401) {
+        throw new Error("未授权，执行 qdmp-cli login 完成登录");
+      }
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return data;
+  } catch (error) {
+    throw new Error(error);
+  }
+};
+
+/**
+ * 用户登录
+ * @param {string} username - 用户名
+ * @param {string} password - 密码
+ * @returns {Promise} 登录结果
+ */
+export const login = async (username, password) => {
+  try {
+    const result = await request("/mp/v1/user/login", {
+      method: "POST",
+      body: JSON.stringify({ username, password }),
+    });
+    if (result?.data?.token) {
+      saveToken(result.data.token); // 保存token
+      return { success: true };
+    } else {
+      throw new Error(result.error || "登录失败");
+    }
+  } catch (error) {
+    throw new Error(error.message);
+  }
+};
+/**
+ * 获取用户信息
+ * @returns {Promise} 用户信息
+ */
+export const getUserInfo = async () => {
+  try {
+    const result = await request("/mp/v1/user/me");
+    return result?.data?.nickname;
+  } catch (error) {
+    throw new Error(error?.message);
+  }
+};
+/**
+ * 获取预上传url
+ * @returns {Promise} url
+ */
+export const getSignInRecords = async (file) => {
+  try {
+    const result = await request("/mp/v1/platform/version/uploadurl", {
+      method: "POST",
+      body: JSON.stringify({ file }),
+    });
+    if (result?.data?.url) {
+      return result.data.url;
+    } else {
+      throw new Error(result.error || "获取上传url失败");
+    }
+  } catch (error) {
+    throw new Error(error?.message);
+  }
+};
+/**
+ * 上传版本
+ * @params {string} filename
+ */
+export const uploadApp = async (filename, localPath) => {
+  try {
+    const signedUrl = await getSignInRecords(filename);
+    const fileBuffer = await readFile(localPath);
+    const response = await fetch(signedUrl, {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/octet-stream",
+      },
+      body: fileBuffer,
+    });
+    if (response.status === 200) {
+      return response;
+    }
+  } catch (error) {
+    throw new Error(error?.message);
+  }
+};
+/**
+ * 获取app信息
+ * @params {string} appId - appId
+ */
+export const getAppInfo = async (appId) => {
+  try {
+    const result = await request("/mp/v1/lookup/app/" + appId);
+    return result?.data;
+  } catch (error) {
+    throw new Error(error?.message);
+  }
+};
+/**
+ * 更新版本
+ * @params {string} appId - appId
+ * @params {string} downloadUrl - 上传链接
+ */
+export const uploadVersion = async (appId, downloadUrl) => {
+  try {
+    const result = await request("/mp/v1/platform/version/update", {
+      method: "POST",
+      body: JSON.stringify({
+        appId,
+        downloadUrl,
+      }),
+    });
+    return result;
+  } catch (error) {
+    throw new Error(error?.message);
+  }
+};

package/constants.js

@@ -0,0 +1,16 @@
+export const TEMPLATES = [
+  {
+    name: "default",
+    value: "frontend/echo-uniapp-template",
+    desc: "千岛小程序默认模版",
+    emoji: "🟢",
+  },
+  {
+    name: "h5",
+    value: "frontend/h5-template",
+    desc: "h5模版",
+    emoji: "🔵",
+  },
+];
+
+export const WORKSPACE_DIR = "qdmp-output";

package/index.js

@@ -0,0 +1,49 @@
+#! /usr/bin/env node
+
+import chalk from "chalk";
+import { program } from "commander";
+import { readFileSync } from "fs";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+import {
+  initAction,
+  listAction,
+  loginAction,
+  getMyInfoAction,
+  uploadAction,
+} from "./actions.js";
+import { printLogo } from "./utils/logHandler.js";
+// import.meta.url： esm模块化中的属性,获取模块文件的绝对地址
+// __dirname： 获取模块文件所在目录的绝对路径，由nodejs在每个模块注入的特殊变量，只能在commonjs中使用
+// process.cwd()： 获取当前执行nodejs命令的当前工作目录
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(
+  readFileSync(resolve(__dirname, "package.json"), "utf8")
+);
+
+program.version(chalk.green(`v${packageJson.version}`), "-v,--version");
+program
+  .name("qdmp-cli")
+  .description("千岛小程序脚手架")
+  .usage("<command> [options]")
+  .on("--help", () => {
+    printLogo();
+  });
+
+program
+  .command("create <app-name>")
+  .description("创建项目")
+  .option("-t, --template <template>", "项目模版")
+  .action(initAction);
+
+program.command("list").description("列出可选模版").action(listAction);
+program.command("login").description("登录").action(loginAction);
+program
+  .command("getMe")
+  .description("查看当前登陆用户")
+  .action(getMyInfoAction);
+program.command("upload").description("上传项目").action(uploadAction);
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "qdmp-cli",
+  "version": "0.0.1",
+  "description": "qdmp-cli",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "bin": "./index.js",
+  "keywords": [],
+  "author": "zhangyanran",
+  "license": "ISC",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "figlet": "^1.8.1",
+    "inquirer": "^12.6.3",
+    "is-unicode-supported": "^2.1.0",
+    "ora": "^8.2.0",
+    "shelljs": "^0.10.0",
+    "table": "^6.9.0"
+  },
+   "publishConfig": {
+    "@frontend:registry": " http://g.echo.tech/api/v4/projects/1107/packages/npm/"
+  }
+
+}

package/utils/authorized.js

@@ -0,0 +1,43 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { error, info } from "./logHandler.js";
+
+// 获取配置文件路径
+const getConfigPath = () => {
+  return path.join(os.homedir(), ".qdtool.config.json");
+};
+
+/**
+ * 保存认证令牌
+ * @param {string} token - 认证令牌
+ */
+export const saveToken = (token) => {
+  const configPath = getConfigPath();
+  const config = { token };
+
+  try {
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    info("🔑 认证令牌已安全存储");
+  } catch (err) {
+    error("保存认证令牌失败:", err.message);
+  }
+};
+
+/**
+ * 获取认证令牌
+ * @returns {string} - 认证令牌
+ */
+export const getToken = () => {
+  const configPath = getConfigPath();
+  try {
+    if (fs.existsSync(configPath)) {
+      const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+      return config.token || null;
+    } else {
+      error("认证令牌不存在，请重新登录");
+    }
+  } catch (err) {
+    error("读取认证令牌失败，请重新登录:", err.message);
+  }
+};

package/utils/common.js

@@ -0,0 +1,133 @@
+import { info, error, success } from "./logHandler.js";
+import { execSync } from "child_process";
+import chalk from "chalk";
+import { WORKSPACE_DIR } from "../constants.js";
+import fs from "fs";
+import path from "path";
+
+/** 获取上传链接
+ * @param {*} appId 文件
+ * @param {*} code 版本号
+ */
+export const getUploadPath = (appId, code) => {
+  return `mp/${appId}/${appId}_${code}.zip`;
+};
+
+/** 获取AppId
+ *
+ * @returns appId
+ */
+export function getAppId() {
+  try {
+    const qdmpJsonPath = `${process.cwd()}/qdmp.json`;
+    const data = fs.readFileSync(path.resolve(qdmpJsonPath), "utf8");
+    const qdmpJson = JSON.parse(data);
+    return qdmpJson?.appId || "";
+  } catch (e) {
+    error("未授权应用，请在根目录下qdmp.json配置对应的appId");
+  }
+}
+
+/** 验证URL是否可访问
+ * @param {*} url
+ */
+export const isUrlAccessible = async (url) => {
+  try {
+    const response = await fetch(url, { method: "HEAD" });
+    return response.ok;
+  } catch (e) {
+    error(e);
+    return false;
+  }
+};
+
+/** 重命名文件夹
+ * @param {*} dirname 旧文件夹名
+ * @param {*} newname 新文件夹名
+ */
+export async function renameDistFolder(dirname, newname) {
+  try {
+    execSync(`rm -rf ./h5`, { stdio: "inherit" });
+    execSync(`mv ${dirname} ${newname}`, { stdio: "inherit" });
+    return true;
+  } catch (e) {
+    error("重命名文件夹失败：", e);
+    return false;
+  }
+}
+/** 创建工作文件夹
+ * @param {*} dirname 文件夹名
+ */
+export async function createWorkSpaceFolder(dirname = "") {
+  info("创建工作区...");
+  try {
+    execSync(`rm -rf ${dirname}`);
+    execSync(`mkdir ${dirname}`, { stdio: "inherit" });
+    success("创建工作区成功！");
+    return true;
+  } catch (e) {
+    error(e);
+    return false;
+  }
+}
+/** 压缩文件夹
+ * @param {*} dirname 文件夹名
+ */
+// 压缩项目
+async function compressProject(output, dirname = "") {
+  try {
+    execSync(`cd ./${dirname} && zip -r ${output}.zip ./h5`, {
+      stdio: "inherit",
+    });
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+/** 复制文件夹
+ * @param {*} dirname 文件夹名
+ */
+async function copyDistFolder(dirname) {
+  try {
+    execSync(`cp -r ${dirname} ./${WORKSPACE_DIR}`, {
+      stdio: "inherit",
+    });
+    return true;
+  } catch (e) {
+    error(e);
+    return false;
+  }
+}
+
+/**预上传
+ *
+ */
+export async function preUpload(targetName) {
+  try {
+    if (!(await createWorkSpaceFolder(WORKSPACE_DIR))) return false;
+
+    if (!(await copyDistFolder("dist"))) return false;
+
+    if (
+      !(await renameDistFolder(`${WORKSPACE_DIR}/dist`, `${WORKSPACE_DIR}/h5`))
+    )
+      return false;
+
+    if (!(await compressProject(targetName, WORKSPACE_DIR))) return false;
+    return `./${WORKSPACE_DIR}/${targetName}.zip`;
+  } catch (e) {
+    error(e);
+  }
+}
+/** 清理工作文件夹
+ * @param {*} dirname 文件夹名
+ */
+export async function cleanWorkSpaceFolder(dirname) {
+  try {
+    execSync(`rm -rf ./${WORKSPACE_DIR}`, { stdio: "inherit" });
+    success("清理工作空间成功！");
+    return true;
+  } catch (error) {
+    return false;
+  }
+}

package/utils/gitClone.js

@@ -0,0 +1,62 @@
+import child_process from "child_process";
+import ora from "ora";
+import path from "path";
+import chalk from "chalk";
+import { rm } from "fs/promises";
+import { existsSync } from "fs";
+import { inquirerConfirm } from "./interactive.js";
+import { error } from "./logHandler.js";
+/**
+ * 下载项目
+ * @param {string} projectName - 项目名称
+ * @param {string} repo - 仓库地址
+ */
+export const download = async (projectName, repo) => {
+  try {
+    const targetPath = path.join(process.cwd(), projectName);
+    let name = projectName;
+    if (existsSync(targetPath)) {
+      const randomHash = Math.random().toString(36).substring(2, 8);
+      name = `${projectName}_${randomHash}`;
+      //询问是否创建新名称
+      const confirm = await inquirerConfirm(
+        `文件夹 ${projectName} 已存在，是否创建新名称: ${name}`
+      );
+      if (confirm) {
+        clone(repo, name);
+      } else {
+        error(`文件夹 ${projectName} 已存在, 请更名后重新创建`);
+      }
+    } else {
+      clone(repo, name);
+    }
+  } catch (error) {
+    error(`${error.message}`);
+  }
+};
+
+const execSync = async (cmd) => {
+  return new Promise((resolve, reject) => {
+    child_process.exec(cmd, function (err, stdout, stderr) {
+      if (err) {
+        reject(new Error(stderr || err.message));
+        return;
+      }
+      resolve(stdout);
+    });
+  });
+};
+
+const clone = async (repo, name) => {
+  const spinner = ora("正在拉取项目......").start();
+  try {
+    await execSync(`git clone --depth 1 git@g.echo.tech:${repo}.git ${name}`);
+    const gitPath = path.join(process.cwd(), name, ".git");
+    await rm(gitPath, { recursive: true, force: true });
+    spinner.succeed(chalk.green(`模版创建成功！请进入 ${name} 目录开始开发`));
+  } catch (error) {
+    spinner.fail(chalk.red(`模版创建失败: ${error.message}`));
+  } finally {
+    spinner.stop();
+  }
+};

package/utils/interactive.js

@@ -0,0 +1,36 @@
+import inquirer from "inquirer";
+/**
+ * 交互式确认
+ * @param {string} message - 提示信息
+ * @returns {boolean} - 是否确认
+ */
+export const inquirerConfirm = async (message) => {
+  const { confirm } = await inquirer.prompt([
+    {
+      type: "confirm",
+      name: "confirm",
+      message,
+    },
+  ]);
+  return confirm;
+};
+/**
+ * 输入用户账号 密码
+ * @param {string} message - 提示信息
+ * @returns {string} - 用户账号密码
+ */
+export const inquirerAccountPassword = async (message) => {
+  const { account, password } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "account",
+      message: "请输入用户账号",
+    },
+    {
+      type: "password",
+      name: "password",
+      message: "请输入用户密码",
+    },
+  ]);
+  return { account, password };
+};

package/utils/logHandler.js

@@ -0,0 +1,68 @@
+import chalk from "chalk";
+import isUnicodeSupported from "is-unicode-supported";
+import figlet from "figlet";
+const _isUnicodeSupported = isUnicodeSupported();
+
+/**
+ * 日志符号集合
+ */
+export const logSymbols = {
+  error: _isUnicodeSupported ? "✖" : "×",
+  warning: _isUnicodeSupported ? "⚠" : "‼",
+  success: _isUnicodeSupported ? "✔" : "√",
+  info: _isUnicodeSupported ? "ℹ" : "i",
+  star: _isUnicodeSupported ? "★" : "*",
+};
+
+/**
+ * 通用错误处理工具类
+ */
+export class ErrorHandler {
+  /**
+   * 显示错误信息并退出程序
+   * @param {string} message - 错误信息
+   */
+  static fatal(message) {
+    console.trace(chalk.red(`${logSymbols.error} 错误：${message}`));
+    process.exit(1);
+  }
+
+  /**
+   * 显示警告信息，不退出程序
+   * @param {string} message - 警告信息
+   */
+  static warn(message) {
+    console.log(chalk.yellow(`${logSymbols.warning} 警告：${message}`));
+  }
+
+  /**
+   * 显示成功信息
+   * @param {string} message - 成功信息
+   */
+  static success(message) {
+    console.log(chalk.green(`${logSymbols.success} ${message}`));
+  }
+
+  /**
+   * 显示普通信息
+   * @param {string} message - 信息内容
+   */
+  static info(message) {
+    console.log(chalk.blue(`${logSymbols.info}  ${message}`));
+  }
+}
+
+/**
+ * 简化的错误处理函数
+ */
+export const error = (message) => ErrorHandler.fatal(message);
+export const warn = (message) => ErrorHandler.warn(message);
+export const success = (message) => ErrorHandler.success(message);
+export const info = (message) => ErrorHandler.info(message);
+
+export const printLogo = () =>
+  console.log(
+    "\r\n" +
+      chalk.hex("#7C66FF").bold(figlet.textSync("qiandao-miniapp")) +
+      "\r\n"
+  );