@qcplay/cli 1.0.5 → 1.0.6

package/README.md

@@ -7,6 +7,7 @@
 - 认证默认请求线上接口：`https://cli.qcg.ink`
 - 发布默认请求线上接口：`https://cli.qcg.ink`
 - 登录默认打开线上页面：`https://cli.qcg.ink/auth.html`
+- `qcplay-cli update` 会更新 npm 全局包，并同步 `~/.agents/skills`
 - 本地调试时可直接使用 `--local`
 - `--local` 默认指向 `http://127.0.0.1:8787`
 - `qcplay-cli auth --local` 会打开仓库里的本地页面 `web/auth.html`

package/bin/qcplay.js

@@ -93,16 +93,24 @@ const AGENTS_DIR = path.join(os.homedir(), ".agents");
 const CONFIG_FILE = path.join(QCPLAY_DIR, "config.json");
 const SKILLS_DIR = path.join(AGENTS_DIR, "skills");
 
-function readPackageVersion() {
+function readPackageMetadata() {
   try {
     const packageJson = JSON.parse(fs.readFileSync(PACKAGE_JSON, "utf8"));
-    return packageJson.version || "0.0.0";
+    return {
+      name: packageJson.name || "@qcplay/cli",
+      version: packageJson.version || "0.0.0"
+    };
   } catch {
-    return "0.0.0";
+    return {
+      name: "@qcplay/cli",
+      version: "0.0.0"
+    };
   }
 }
 
-const PACKAGE_VERSION = readPackageVersion();
+const PACKAGE_METADATA = readPackageMetadata();
+const PACKAGE_NAME = PACKAGE_METADATA.name;
+const PACKAGE_VERSION = PACKAGE_METADATA.version;
 const colorsEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
 
 const chalk = {
@@ -126,6 +134,7 @@ function printRootHelp() {
 
 Usage:
   qcplay-cli install [--local]
+  qcplay-cli update
   qcplay-cli auth [login|status|logout] [--local] [--backend <url>] [--auth-page <url>]
   qcplay-cli auth permissions [--local] [--key <key>] [--json]
   qcplay-cli article
@@ -141,6 +150,11 @@ Options:
 `);
 }
 
+function printUpdateHelp() {
+  console.log("Usage:");
+  console.log("  qcplay-cli update");
+}
+
 function printAuthHelp() {
   console.log("Usage:");
   console.log("  qcplay-cli auth [login|status|logout] [--local] [--backend <url>] [--auth-page <url>]");
@@ -236,15 +250,70 @@ async function ensureLocalDirs() {
   await ensureDir(SKILLS_DIR);
 }
 
+async function filesAreEqual(sourcePath, targetPath) {
+  try {
+    const [sourceContent, targetContent] = await Promise.all([
+      fs.promises.readFile(sourcePath),
+      fs.promises.readFile(targetPath)
+    ]);
+    return sourceContent.equals(targetContent);
+  } catch {
+    return false;
+  }
+}
+
+async function syncDirectoryChanges(sourceDir, targetDir, rootDir = sourceDir, changes = { added: [], updated: [] }) {
+  await ensureDir(targetDir);
+  const entries = await fs.promises.readdir(sourceDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const sourcePath = path.join(sourceDir, entry.name);
+    const targetPath = path.join(targetDir, entry.name);
+
+    if (entry.isDirectory()) {
+      await syncDirectoryChanges(sourcePath, targetPath, rootDir, changes);
+      continue;
+    }
+
+    if (!entry.isFile()) {
+      continue;
+    }
+
+    const relativePath = path.relative(rootDir, sourcePath);
+    if (!(await pathExists(targetPath))) {
+      await ensureDir(path.dirname(targetPath));
+      await fs.promises.copyFile(sourcePath, targetPath);
+      changes.added.push(relativePath);
+      continue;
+    }
+
+    if (await filesAreEqual(sourcePath, targetPath)) {
+      continue;
+    }
+
+    await fs.promises.copyFile(sourcePath, targetPath);
+    changes.updated.push(relativePath);
+  }
+
+  return changes;
+}
+
 async function installSkills() {
   const sourceDir = path.resolve(__dirname, "../templates/skills");
 
   if (!(await pathExists(sourceDir))) {
-    return false;
+    return {
+      available: false,
+      added: [],
+      updated: []
+    };
   }
 
-  await copyRecursive(sourceDir, SKILLS_DIR);
-  return true;
+  const changes = await syncDirectoryChanges(sourceDir, SKILLS_DIR);
+  return {
+    available: true,
+    ...changes
+  };
 }
 
 async function saveConfig(authBackendUrl, publishBackendUrl, authPageUrl, localMode = false) {
@@ -264,6 +333,19 @@ async function loadConfig() {
   return readJson(CONFIG_FILE);
 }
 
+async function updateStoredConfigVersion(version) {
+  const config = await loadConfig();
+  if (Object.keys(config).length === 0) {
+    return;
+  }
+
+  await writeJson(CONFIG_FILE, {
+    ...config,
+    version,
+    updated_at: Date.now()
+  });
+}
+
 function normalizeText(value) {
   return String(value ?? "").trim();
 }
@@ -489,6 +571,28 @@ function openBrowser(targetUrl) {
   });
 }
 
+function getNpmCommand() {
+  return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+
+function runCommand(command, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: "inherit"
+    });
+
+    child.on("error", reject);
+    child.on("close", code => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+
+      reject(new Error(`命令执行失败 (${code}): ${command} ${args.join(" ")}`));
+    });
+  });
+}
+
 function delay(ms) {
   return new Promise(resolve => {
     setTimeout(resolve, ms);
@@ -675,6 +779,28 @@ function printPermissionTree(items) {
   }
 }
 
+function formatAccountSummary(data = {}) {
+  const id = Number(data.id || 0);
+  const name = normalizeText(data.name) || "未知账号";
+  const type = normalizeText(data.type);
+  const status = normalizeText(data.status);
+  const parts = [name];
+
+  if (id > 0) {
+    parts.push(`id=${id}`);
+  }
+
+  if (type) {
+    parts.push(`type=${type}`);
+  }
+
+  if (status) {
+    parts.push(`status=${status}`);
+  }
+
+  return parts.join(" | ");
+}
+
 async function installCommand(options) {
   const config = await loadConfig();
   const localMode = isLocalMode(options, config);
@@ -690,7 +816,7 @@ async function installCommand(options) {
   console.log(chalk.green("✔ 本地目录已创建"));
 
   const skillsInstalled = await installSkills();
-  if (skillsInstalled) {
+  if (skillsInstalled.available) {
     console.log(chalk.green("✔ Skills 已安装"));
     console.log(`Skills 目录: ${chalk.gray(SKILLS_DIR)}`);
   } else {
@@ -708,6 +834,56 @@ async function installCommand(options) {
   console.log("");
 }
 
+function printSkillsSyncResult(result) {
+  if (!result.available) {
+    console.log(chalk.yellow("! 未找到 Skills 模板，已跳过"));
+    return;
+  }
+
+  const addedCount = result.added.length;
+  const updatedCount = result.updated.length;
+  if (addedCount === 0 && updatedCount === 0) {
+    console.log(chalk.green("✔ Skills 已检查，无新增或变更"));
+    console.log(`Skills 目录: ${chalk.gray(SKILLS_DIR)}`);
+    return;
+  }
+
+  const parts = [];
+  if (addedCount > 0) {
+    parts.push(`新增 ${addedCount} 个文件`);
+  }
+  if (updatedCount > 0) {
+    parts.push(`更新 ${updatedCount} 个文件`);
+  }
+
+  console.log(chalk.green(`✔ Skills 已同步（${parts.join("，")}）`));
+  console.log(`Skills 目录: ${chalk.gray(SKILLS_DIR)}`);
+}
+
+async function updateCommand() {
+  console.log("");
+  console.log(chalk.cyan("正在更新 QCPlay CLI..."));
+  console.log(chalk.gray(`当前版本: ${PACKAGE_VERSION}`));
+  console.log("");
+
+  await ensureLocalDirs();
+  await runCommand(getNpmCommand(), ["install", "-g", `${PACKAGE_NAME}@latest`]);
+
+  const latestPackage = readPackageMetadata();
+  await updateStoredConfigVersion(latestPackage.version);
+  const skillsInstalled = await installSkills();
+
+  console.log("");
+  console.log(chalk.green("CLI 更新完成"));
+  if (latestPackage.version !== PACKAGE_VERSION) {
+    console.log(chalk.gray(`版本: ${PACKAGE_VERSION} -> ${latestPackage.version}`));
+  } else {
+    console.log(chalk.gray(`版本: ${latestPackage.version}`));
+  }
+  printSkillsSyncResult(skillsInstalled);
+  console.log("");
+}
+
 async function authCommand(rawArgs = []) {
   const parsed = parseBackendOptions(rawArgs);
   const options = parsed.options;
@@ -734,7 +910,11 @@ async function authCommand(rawArgs = []) {
     } catch {}
 
     await waitForLoginSuccessSequence(backendUrl, previousSequence);
+    const statusResponse = await requestJson("GET", backendUrl, "/api/auth/status");
     console.log(chalk.green("登录成功"));
+    if (statusResponse.data?.logged_in) {
+      console.log(chalk.gray(`当前账号: ${formatAccountSummary(statusResponse.data)}`));
+    }
     return;
   }
 
@@ -742,6 +922,7 @@ async function authCommand(rawArgs = []) {
     const response = await requestJson("GET", backendUrl, "/api/auth/status");
     if (response.data?.logged_in) {
       console.log(chalk.green("已登录"));
+      console.log(chalk.gray(`当前账号: ${formatAccountSummary(response.data)}`));
       return;
     }
 
@@ -1189,6 +1370,16 @@ async function main() {
     return;
   }
 
+  if (command === "update") {
+    if (subcommand === "-h" || subcommand === "--help") {
+      printUpdateHelp();
+      return;
+    }
+
+    await runWithErrorBanner("更新失败", () => updateCommand());
+    return;
+  }
+
   if (command === "auth") {
     if (subcommand === "-h" || subcommand === "--help") {
       printAuthHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qcplay/cli",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "QCPlay CLI",
   "type": "module",
   "bin": {