@qcplay/cli 1.0.0

package/bin/qcplay.js

@@ -0,0 +1,652 @@
+#!/usr/bin/env node
+
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const QCPLAY_DIR = path.join(os.homedir(), ".qcplay");
+const AUTH_FILE = path.join(QCPLAY_DIR, "auth.json");
+const CONFIG_FILE = path.join(QCPLAY_DIR, "config.json");
+const SKILLS_DIR = path.join(QCPLAY_DIR, "skills");
+
+const colorsEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
+
+const chalk = {
+  red: text => colorize("\x1b[31m", text),
+  green: text => colorize("\x1b[32m", text),
+  yellow: text => colorize("\x1b[33m", text),
+  cyan: text => colorize("\x1b[36m", text),
+  gray: text => colorize("\x1b[90m", text)
+};
+
+function colorize(code, text) {
+  if (!colorsEnabled) {
+    return String(text);
+  }
+
+  return `${code}${text}\x1b[0m`;
+}
+
+function printRootHelp() {
+  console.log(`QCPlay CLI
+
+Usage:
+  qcplay-cli install
+  qcplay-cli auth [login|status|logout]
+  qcplay-cli article
+  qcplay-cli article init [file]
+  qcplay-cli article publish <file> [--env <env>] [--url <url>] [--dry-run]
+  qcplay-cli www-article-list.store <file> [--env <env>] [--url <url>] [--dry-run]
+  qcplay-cli features
+  qcplay-cli where
+
+Options:
+  -h, --help     Show help
+  -V, --version  Show version
+`);
+}
+
+function printAuthHelp() {
+  console.log("Usage:");
+  console.log("  qcplay-cli auth");
+  console.log("  qcplay-cli auth status");
+  console.log("  qcplay-cli auth logout");
+}
+
+function printArticleHelp() {
+  console.log(`Usage:
+  qcplay-cli article
+  qcplay-cli article init [file]
+  qcplay-cli article publish <file> [--env <env>] [--url <url>] [--dry-run]`);
+}
+
+function getVendorDir() {
+  if (process.platform === "win32") {
+    return path.resolve(__dirname, "../vendor/win32");
+  }
+
+  if (process.platform === "darwin") {
+    return path.resolve(__dirname, "../vendor/darwin");
+  }
+
+  if (process.platform === "linux") {
+    return path.resolve(__dirname, "../vendor/linux");
+  }
+
+  throw new Error(`Unsupported platform: ${process.platform}`);
+}
+
+function getExePath(name) {
+  const vendorDir = getVendorDir();
+  return process.platform === "win32" ? path.join(vendorDir, `${name}.exe`) : path.join(vendorDir, name);
+}
+
+function runNative(name, args = []) {
+  return new Promise((resolve, reject) => {
+    const exePath = getExePath(name);
+
+    if (!fs.existsSync(exePath)) {
+      reject(new Error(`执行程序不存在: ${exePath}`));
+      return;
+    }
+
+    const child = spawn(exePath, args, {
+      stdio: "inherit",
+      shell: false
+    });
+
+    child.on("error", err => {
+      reject(err);
+    });
+
+    child.on("exit", code => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`${name} 执行失败，退出码: ${code}`));
+      }
+    });
+  });
+}
+
+async function pathExists(targetPath) {
+  try {
+    await fs.promises.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function ensureDir(targetPath) {
+  await fs.promises.mkdir(targetPath, { recursive: true });
+}
+
+async function copyRecursive(sourcePath, targetPath) {
+  const sourceStat = await fs.promises.stat(sourcePath);
+
+  if (sourceStat.isDirectory()) {
+    await ensureDir(targetPath);
+    const entries = await fs.promises.readdir(sourcePath);
+    for (const entry of entries) {
+      await copyRecursive(path.join(sourcePath, entry), path.join(targetPath, entry));
+    }
+    return;
+  }
+
+  await ensureDir(path.dirname(targetPath));
+  await fs.promises.copyFile(sourcePath, targetPath);
+}
+
+async function writeJson(filePath, value) {
+  await ensureDir(path.dirname(filePath));
+  await fs.promises.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+
+async function readJson(filePath) {
+  const raw = await fs.promises.readFile(filePath, "utf8");
+  return JSON.parse(raw);
+}
+
+async function removeFile(filePath) {
+  await fs.promises.rm(filePath, { force: true });
+}
+
+async function ensureLocalDirs() {
+  await ensureDir(QCPLAY_DIR);
+  await ensureDir(SKILLS_DIR);
+}
+
+async function installSkills() {
+  const sourceDir = path.resolve(__dirname, "../templates/skills");
+
+  if (!(await pathExists(sourceDir))) {
+    return false;
+  }
+
+  await copyRecursive(sourceDir, SKILLS_DIR);
+  return true;
+}
+
+async function saveConfig() {
+  await writeJson(CONFIG_FILE, {
+    cli: "qcplay-cli",
+    version: "1.0.0",
+    auth_file: AUTH_FILE,
+    skills_dir: SKILLS_DIR,
+    configured_at: Date.now()
+  });
+}
+
+async function getLoginStatus() {
+  if (!(await pathExists(AUTH_FILE))) {
+    return {
+      ok: false,
+      reason: `认证文件不存在: ${AUTH_FILE}`
+    };
+  }
+
+  let auth;
+
+  try {
+    auth = await readJson(AUTH_FILE);
+  } catch (err) {
+    return {
+      ok: false,
+      reason: `认证文件不是合法 JSON: ${err.message}`
+    };
+  }
+
+  const accessToken =
+    auth.access_token ||
+    auth.accessToken ||
+    auth.token ||
+    auth.data?.access_token ||
+    auth.data?.accessToken;
+
+  if (!accessToken) {
+    return {
+      ok: false,
+      reason: "认证文件中没有找到 access_token"
+    };
+  }
+
+  let expiresAt =
+    auth.expires_at ||
+    auth.expiresAt ||
+    auth.data?.expires_at ||
+    auth.data?.expiresAt;
+
+  if (expiresAt) {
+    expiresAt = Number(expiresAt);
+
+    if (expiresAt > 0 && expiresAt < 1000000000000) {
+      expiresAt = expiresAt * 1000;
+    }
+
+    if (Date.now() >= expiresAt) {
+      return {
+        ok: false,
+        reason: `登录状态已过期: ${new Date(expiresAt).toLocaleString()}`
+      };
+    }
+  }
+
+  return {
+    ok: true,
+    auth
+  };
+}
+
+function printFeatures() {
+  console.log("");
+  console.log(chalk.green("你现在可以使用以下功能:"));
+  console.log("");
+
+  console.log(chalk.cyan("1. 登录认证"));
+  console.log("   qcplay-cli auth");
+  console.log("");
+
+  console.log(chalk.cyan("4. 发布官网文章"));
+  console.log("   qcplay-cli www-article-list.store article.md");
+  console.log(chalk.gray("   文章标题、分类、缩略图、标签等信息写在 article.md 顶部 Front Matter 中。"));
+  console.log("");
+
+  console.log(chalk.cyan("5. 查看本地配置目录"));
+  console.log("   qcplay-cli where");
+  console.log("");
+}
+
+function printWhere() {
+  console.log(QCPLAY_DIR);
+}
+
+async function installCommand() {
+  console.log("");
+  console.log(chalk.cyan("正在安装 QCPlay CLI..."));
+  console.log("");
+
+  await ensureLocalDirs();
+  console.log(chalk.green("✔ 本地目录已创建"));
+
+  const skillsInstalled = await installSkills();
+  if (skillsInstalled) {
+    console.log(chalk.green("✔ Skills 已安装"));
+  } else {
+    console.log(chalk.yellow("! 未找到 Skills 模板，已跳过"));
+  }
+
+  await saveConfig();
+  console.log(chalk.green("✔ 配置文件已生成"));
+
+  console.log("");
+  console.log(chalk.cyan("正在打开登录窗口..."));
+  console.log(chalk.gray("请在浏览器中完成账号密码登录。"));
+  console.log("");
+
+  await runNative("qcplay-auth", ["login"]);
+
+  const loginStatus = await getLoginStatus();
+  if (!loginStatus.ok) {
+    throw new Error(`登录流程结束，但未检测到有效认证文件。\n原因: ${loginStatus.reason}`);
+  }
+
+  console.log("");
+  console.log(chalk.green("✔ 登录成功"));
+  console.log(`认证文件: ${chalk.gray(AUTH_FILE)}`);
+
+  console.log("");
+  console.log(chalk.green("✔ QCPlay CLI 安装完成"));
+
+  printFeatures();
+}
+
+async function authCommand(action) {
+  if (!action || action === "login") {
+    console.log("");
+    console.log(chalk.cyan("正在打开 QCPlay 登录窗口..."));
+    console.log("");
+
+    await runNative("qcplay-auth", ["login"]);
+
+    const loginStatus = await getLoginStatus();
+    if (!loginStatus.ok) {
+      throw new Error(`登录失败。\n原因: ${loginStatus.reason}`);
+    }
+
+    console.log("");
+    console.log(chalk.green("✔ 登录成功"));
+    console.log(`认证文件: ${chalk.gray(AUTH_FILE)}`);
+    return;
+  }
+
+  if (action === "status") {
+    const loginStatus = await getLoginStatus();
+
+    if (!loginStatus.ok) {
+      console.log(chalk.yellow("未登录或登录无效"));
+      console.log(`原因: ${loginStatus.reason}`);
+      console.log("");
+      console.log("请执行:");
+      console.log("  qcplay-cli auth");
+      return;
+    }
+
+    console.log(chalk.green("已登录"));
+    console.log(`认证文件: ${AUTH_FILE}`);
+    return;
+  }
+
+  if (action === "logout") {
+    await removeFile(AUTH_FILE);
+    console.log(chalk.green("已退出登录"));
+    return;
+  }
+
+  printAuthHelp();
+}
+
+function parsePublishOptions(args) {
+  const options = {
+    env: undefined,
+    url: undefined,
+    dryRun: false
+  };
+  const positional = [];
+
+  for (let index = 0; index < args.length; index += 1) {
+    const current = args[index];
+
+    if (current === "--dry-run") {
+      options.dryRun = true;
+      continue;
+    }
+
+    if (current === "--env" || current === "--url") {
+      const next = args[index + 1];
+      if (!next || next.startsWith("--")) {
+        throw new Error(`${current} 缺少参数值`);
+      }
+
+      if (current === "--env") {
+        options.env = next;
+      } else {
+        options.url = next;
+      }
+
+      index += 1;
+      continue;
+    }
+
+    if (current.startsWith("--")) {
+      throw new Error(`未知参数: ${current}`);
+    }
+
+    positional.push(current);
+  }
+
+  return {
+    file: positional[0],
+    options
+  };
+}
+
+async function publishArticleCommand(file, options) {
+  if (!file) {
+    throw new Error("缺少文章文件，例如：qcplay-cli www-article-list.store article.md");
+  }
+
+  const articleFile = path.resolve(process.cwd(), file);
+  if (!(await pathExists(articleFile))) {
+    throw new Error(`文章文件不存在: ${articleFile}`);
+  }
+
+  const loginStatus = await getLoginStatus();
+  if (!loginStatus.ok) {
+    throw new Error(`未检测到有效登录状态。\n原因: ${loginStatus.reason}\n请先执行：qcplay-cli auth`);
+  }
+
+  const args = ["--content-file", articleFile];
+
+  if (options.env) {
+    args.push("--env", options.env);
+  }
+
+  if (options.url) {
+    args.push("--url", options.url);
+  }
+
+  if (options.dryRun) {
+    args.push("--dry-run");
+  }
+
+  console.log("");
+  console.log(chalk.cyan("正在发布官网文章..."));
+  console.log(chalk.gray(`文章文件: ${articleFile}`));
+  console.log("");
+
+  await runNative("publish-article", args);
+}
+
+async function initArticleTemplate(file = "article.md") {
+  const sourceFile = path.resolve(__dirname, "../templates/skills/qcplay-publish-article/article/article.md");
+  const targetFile = path.resolve(process.cwd(), file);
+
+  if (!(await pathExists(sourceFile))) {
+    throw new Error(`文章模板不存在: ${sourceFile}`);
+  }
+
+  if (await pathExists(targetFile)) {
+    throw new Error(`文件已存在: ${targetFile}`);
+  }
+
+  await copyRecursive(sourceFile, targetFile);
+
+  console.log(chalk.green("文章模板已创建:"));
+  console.log(targetFile);
+  console.log("");
+  console.log("请编辑该文件后执行:");
+  console.log("");
+  console.log(`  qcplay-cli www-article-list.store ${file}`);
+  console.log("");
+}
+
+function printArticleTemplate() {
+  console.log(`
+${chalk.cyan("QCPlay 官网文章发布模板")}
+
+请创建一个 Markdown 文件，例如：
+
+  article.md
+
+文件内容参考：
+
+${chalk.gray("--------------------------------------------------")}
+---
+article_title: 文章标题
+thumbnail: https://example.com/thumbnail.png
+move_thumbnail: https://example.com/mobile-thumbnail.png
+article_excerpt: 文章描述，可以为空
+article_url: article-url-slug
+origin: QCPlay
+status: "1"
+cate_id: "2"
+video_link: ""
+is_hot: "0"
+is_index: "0"
+release_time: "2026-07-09"
+area: "1"
+sort: "100"
+game_id: "39"
+index_pc_img: ""
+index_move_img: ""
+---
+
+# 文章标题
+
+这里填写文章正文内容。
+
+## 一、文章小标题
+
+这里填写正文内容。
+
+## 二、内容说明
+
+这里继续填写正文。
+
+## 三、总结
+
+这里填写文章结尾内容。
+${chalk.gray("--------------------------------------------------")}
+
+${chalk.cyan("发布命令：")}
+
+  qcplay-cli www-article-list.store article.md
+
+${chalk.cyan("参数说明：")}
+
+  article_title      文章标题，必填
+  thumbnail          缩略图，必填
+  move_thumbnail     移动端缩略图，可为空
+  article_excerpt    文章描述，可为空
+  article_url        文章链接，建议英文 slug
+  origin             作者来源
+  status             1 发布，0 未发布
+  cate_id            分类 ID
+  video_link         视频链接，可为空
+  is_hot             1 热门，0 非热门
+  is_index           1 推荐，0 不推荐
+  release_time       发布时间，格式：年-月-日
+  area               所属区域
+  sort               排序，数字
+  game_id            游戏 ID，最强蜗牛是 39
+  index_pc_img       推荐 PC 端缩略图，可为空
+  index_move_img     推荐移动端缩略图，可为空
+
+${chalk.cyan("分类 ID：")}
+
+  综合                 2
+  视频中心             8
+  活动                 3
+  游戏攻略             7
+  萌新入门             9
+  萌新入门-攻略专区    25
+  高手进阶             26
+  活动攻略             27
+  视频攻略             29
+
+${chalk.cyan("区域 ID：")}
+
+  PC                  1
+  资料站              3
+  公益网站            4
+
+${chalk.cyan("游戏 ID：")}
+
+  最强蜗牛            39
+
+${chalk.yellow("注意：")}
+
+  1. article_content 不需要写在 Front Matter 中。
+  2. Markdown 正文会自动作为 article_content。
+  3. is_index2 默认 0，不需要填写。
+  4. type 默认 1，不需要填写。
+  5. 发布前请先登录：
+
+     qcplay-cli auth
+
+`);
+}
+
+async function runWithErrorBanner(title, action) {
+  try {
+    await action();
+  } catch (err) {
+    console.error("");
+    console.error(chalk.red(`${title}:`));
+    console.error(err.message || err);
+    process.exit(1);
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const [command, subcommand, ...rest] = args;
+
+  if (!command || command === "-h" || command === "--help") {
+    printRootHelp();
+    return;
+  }
+
+  if (command === "-V" || command === "--version") {
+    console.log("1.0.0");
+    return;
+  }
+
+  if (command === "install") {
+    await runWithErrorBanner("安装失败", installCommand);
+    return;
+  }
+
+  if (command === "auth") {
+    if (subcommand === "-h" || subcommand === "--help") {
+      printAuthHelp();
+      return;
+    }
+
+    await runWithErrorBanner("认证失败", () => authCommand(subcommand));
+    return;
+  }
+
+  if (command === "article") {
+    if (!subcommand || subcommand === "-h" || subcommand === "--help") {
+      if (!subcommand) {
+        printArticleTemplate();
+      } else {
+        printArticleHelp();
+      }
+      return;
+    }
+
+    if (subcommand === "init") {
+      const file = rest[0] || "article.md";
+      await runWithErrorBanner("创建模板失败", () => initArticleTemplate(file));
+      return;
+    }
+
+    if (subcommand === "publish") {
+      const { file, options } = parsePublishOptions(rest);
+      await runWithErrorBanner("发布失败", () => publishArticleCommand(file, options));
+      return;
+    }
+
+    printArticleHelp();
+    process.exit(1);
+  }
+
+  if (command === "www-article-list.store") {
+    const parsed = parsePublishOptions([subcommand, ...rest].filter(Boolean));
+    await runWithErrorBanner("发布失败", () => publishArticleCommand(parsed.file, parsed.options));
+    return;
+  }
+
+  if (command === "features") {
+    printFeatures();
+    return;
+  }
+
+  if (command === "where") {
+    printWhere();
+    return;
+  }
+
+  printRootHelp();
+  process.exit(1);
+}
+
+await main();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@qcplay/cli",
+  "version": "1.0.0",
+  "description": "QCPlay CLI",
+  "type": "module",
+  "bin": {
+    "qcplay": "./bin/qcplay.js",
+    "qcplay-cli": "./bin/qcplay.js"
+  },
+  "files": [
+    "bin",
+    "vendor",
+    "templates",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=16 <17",
+    "npm": ">=8"
+  },
+  "scripts": {
+    "start": "node bin/qcplay.js",
+    "test:auth": "node bin/qcplay.js auth",
+    "test:publish": "node bin/qcplay.js www-article-list.store article.md",
+    "pack:check": "npm pack --dry-run"
+  },
+  "license": "MIT"
+}