skill-atlas-cli 0.2.8 → 0.2.10

package/bin/cli.js

@@ -29,7 +29,7 @@ function showLogo() {
 const PKG = getPackageJson();
 const VERSION = PKG.version;
 async function main() {
-	checkForUpdate(PKG);
+	await checkForUpdate(PKG);
 	if (!process.argv.includes("-y") && !process.argv.includes("--yes")) showLogo();
 	const parseArgv = process.argv.slice(2).length === 0 ? [...process.argv.slice(0, 2), "--help"] : process.argv;
 	const cli = cac("skill-atlas");
@@ -41,11 +41,12 @@ async function main() {
 		}
 		await runSearch({ keyword: keyword.trim() });
 	});
-	cli.command("update", "快速升级 CLI 到最新版本").option("-y, --yes", "非交互模式，跳过确认直接升级").action(async (options) => {
+	cli.command("update", "快速升级 CLI 到最新版本").option("-y, --yes", "非交互模式，跳过确认直接升级").option("-p, --plugin", "使用官方安装脚本，同步更新 agent 插件与 CLI（推荐: skill-atlas update -y -p）").action(async (options) => {
 		await runUpdate({
 			pkgName: PKG.name,
 			currentVersion: PKG.version,
-			yes: options.yes
+			yes: options.yes,
+			plugin: options.plugin
 		});
 	});
 	cli.command("install [name]", "安装 skill（支持 skill 名称）").option("-y, --yes", "非交互模式，默认安装到全局").option("-g, --global", "安装到全局目录").option("-p, --path <dir>", "安装到自定义路径（目录），如 -p /path/to/skills 或 -p .qoder/skills").option("-a, --agent <agent...>", "非 TTY 模式下指定目标 agent（如 cursor、openclaw），可传多个").action(async (name, options) => {

package/lib/index.d.ts

@@ -1,11 +1,11 @@
 //#region src/core/update-notifier.d.ts
 /**
- * 检查更新，有新版本时输出提示（无需重装，直接 update）
+ * 检查更新：TTY 任意新版本提示；非交互下 minor+ 自动执行官方安装脚本升级，patch 仅一行提示
  */
 declare function checkForUpdate(pkg: {
   name: string;
   version: string;
-}): void;
+}): Promise<void>;
 //#endregion
 //#region src/commands/install.d.ts
 interface AddOptions {
@@ -51,6 +51,10 @@ interface UpdateOptions {
   currentVersion: string;
   /** 非交互模式，跳过确认 */
   yes?: boolean;
+  /**
+   * 使用官方 install 脚本升级（同步 IDE 插件与 CLI），非交互下可与 -y 合用
+   */
+  plugin?: boolean;
 }
 declare function runUpdate(options: UpdateOptions): Promise<void>;
 //#endregion

package/lib/index.js

@@ -3,6 +3,7 @@ import path, { join } from "node:path";
 import semver from "semver";
 import os from "node:os";
 import crypto, { createHash, randomBytes } from "node:crypto";
+import { spawn } from "node:child_process";
 import * as p from "@clack/prompts";
 import chalk from "chalk";
 import axios from "axios";
@@ -15,7 +16,6 @@ import { cp, lstat, mkdir, readdir, readlink, realpath, rename, rm, stat, symlin
 import { execSync } from "child_process";
 import { info } from "console";
 import secp256k1 from "secp256k1";
-import { spawn } from "node:child_process";
 import { createConsola } from "consola";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -243,9 +243,60 @@ var config_default = {
 	getAgentCredentials
 };
 //#endregion
+//#region src/core/npm-global-install.ts
+/**
+* 全局升级 skill-atlas-cli：
+* - update 子命令：npm install -g（保持原方式）
+* - 非 TTY 自动检查升级：与 skillhub 一致的官方安装脚本（curl|bash / PowerShell）
+*/
+/** unpkg 上发布的包根路径（与 skillhub.md 安装说明一致） */
+const UNPKG_PACKAGE_ROOT = "https://unpkg.com/skill-atlas-cli";
+/** 用户可手动执行的命令行（文档 / 报错提示用） */
+const OFFICIAL_INSTALL_CMD_UNIX = `curl -fsSL ${UNPKG_PACKAGE_ROOT}/install.sh | bash`;
+const OFFICIAL_INSTALL_CMD_WIN = `irm ${UNPKG_PACKAGE_ROOT}/install.ps1 | iex`;
+function officialInstallManualForPlatform() {
+	return process.platform === "win32" ? OFFICIAL_INSTALL_CMD_WIN : OFFICIAL_INSTALL_CMD_UNIX;
+}
+/** 执行 npm install -g <pkg>@latest（供 update 指令使用） */
+function runNpmInstallGlobalLatest(pkgName) {
+	return new Promise((resolve) => {
+		const child = spawn("npm", [
+			"install",
+			"-g",
+			`${pkgName}@latest`,
+			"--force"
+		], {
+			stdio: "inherit",
+			shell: true
+		});
+		child.on("close", (code) => resolve(code ?? 0));
+		child.on("error", () => resolve(1));
+	});
+}
+/**
+* 执行官方安装脚本升级（与 skillhub：macOS/Linux 用 install.sh，Windows 用 install.ps1）
+* 供非交互场景下 checkForUpdate 自动升级使用
+*/
+function runOfficialInstallScriptUpdate() {
+	return new Promise((resolve) => {
+		const child = process.platform === "win32" ? spawn("powershell.exe", [
+			"-NoProfile",
+			"-ExecutionPolicy",
+			"Bypass",
+			"-Command",
+			OFFICIAL_INSTALL_CMD_WIN
+		], {
+			stdio: "inherit",
+			windowsHide: true
+		}) : spawn("bash", ["-c", OFFICIAL_INSTALL_CMD_UNIX], { stdio: "inherit" });
+		child.on("close", (code) => resolve(code ?? 0));
+		child.on("error", () => resolve(1));
+	});
+}
+//#endregion
 //#region src/core/update-notifier.ts
 /**
-* npm 包更新检查：有新版本时提示无需重装，直接 npm update 即可
+* npm 包更新检查：TTY 下提示任意新版本；非 TTY 下 minor 及以上通过官方 install 脚本更新，patch 仅 stderr 提示
 */
 const CACHE_DIR = config_default.CONFIG_DIR;
 const CACHE_FILE = join(CACHE_DIR, "update-check.json");
@@ -273,14 +324,23 @@ function saveCache(latest) {
 		}) + "\n");
 	} catch {}
 }
+/** 从 current 升到 latest 是否为至少 minor 级别（含 major），纯 patch 不算 */
+function isAtLeastMinorBump(current, latest) {
+	const diff = semver.diff(current, latest);
+	if (!diff) return false;
+	return diff === "major" || diff === "premajor" || diff === "minor" || diff === "preminor";
+}
 /**
-* 检查更新，有新版本时输出提示（无需重装，直接 update）
+* 检查更新：TTY 任意新版本提示；非交互下 minor+ 自动执行官方安装脚本升级，patch 仅一行提示
 */
-function checkForUpdate(pkg) {
+async function checkForUpdate(pkg) {
 	const cache = getCache();
-	if (cache?.latest && semver.gt(cache.latest, pkg.version)) {
-		if (process.stdout.isTTY) console.error(`\n  📦 Update available: \x1b[31m${pkg.version}\x1b[0m → \x1b[32m${cache.latest}\x1b[0m\n  👉 Run: \x1b[36mskill-atlas update\x1b[0m\n`);
-	}
+	if (cache?.latest && semver.gt(cache.latest, pkg.version)) if (process.stdout.isTTY) console.error(`\n  📦 Update available: \x1b[31m${pkg.version}\x1b[0m → \x1b[32m${cache.latest}\x1b[0m\n  👉 Run: \x1b[36mskill-atlas update\x1b[0m\n`);
+	else if (isAtLeastMinorBump(pkg.version, cache.latest)) {
+		console.error(`[skill-atlas] 检测到 minor 及以上新版本 ${pkg.version} → ${cache.latest}（非交互环境），正在通过官方安装脚本更新…`);
+		const code = await runOfficialInstallScriptUpdate();
+		if (code !== 0) console.error(`[skill-atlas] 自动更新失败（退出码 ${code}），可手动执行: ${officialInstallManualForPlatform()}`);
+	} else console.error(`[skill-atlas] 检测到新版本 ${pkg.version} → ${cache.latest}（非 minor/major 升级，非交互环境不自动安装），可执行: ${officialInstallManualForPlatform()}`);
 	const lastCheck = cache?.lastCheck || 0;
 	if (Date.now() - lastCheck < CHECK_INTERVAL) return;
 	fetchLatestVersion$1(pkg.name).then((latest) => {
@@ -1598,23 +1658,8 @@ async function fetchLatestVersion(pkgName) {
 	if (!res.ok) throw new Error("获取最新版本失败");
 	return (await res.json()).latest || "0.0.0";
 }
-/** 执行 npm install -g <pkg>@latest */
-function runNpmUpdate(pkgName) {
-	return new Promise((resolve) => {
-		const child = spawn("npm", [
-			"install",
-			"-g",
-			`${pkgName}@latest --force`
-		], {
-			stdio: "inherit",
-			shell: true
-		});
-		child.on("close", (code) => resolve(code ?? 0));
-		child.on("error", () => resolve(1));
-	});
-}
 async function runUpdate(options) {
-	const { pkgName, currentVersion, yes } = options;
+	const { pkgName, currentVersion, yes, plugin } = options;
 	const spinner = p.spinner();
 	spinner.start("检查最新版本...");
 	try {
@@ -1628,7 +1673,7 @@ async function runUpdate(options) {
 			p.log.success(`已是最新版本 ${chalk.cyan(currentVersion)}`);
 			return;
 		}
-		p.log.message(`发现新版本: ${chalk.red(currentVersion)} → ${chalk.green(latest)}`);
+		p.log.message(`发现新版本: ${chalk.red(currentVersion)} → ${chalk.green(latest)}` + (plugin ? chalk.dim("（将使用官方安装脚本更新 CLI 与插件）") : ""));
 		const proceed = yes || !process.stdin.isTTY ? true : await p.confirm({
 			message: "是否立即升级？",
 			initialValue: true
@@ -1637,18 +1682,20 @@ async function runUpdate(options) {
 			p.cancel("已取消升级");
 			return;
 		}
-		spinner.start("正在升级...");
-		const code = await runNpmUpdate(pkgName);
+		spinner.start(plugin ? "正在通过官方脚本升级（CLI + 插件）…" : "正在升级...");
+		const code = plugin ? await runOfficialInstallScriptUpdate() : await runNpmInstallGlobalLatest(pkgName);
 		spinner.stop(code === 0 ? "升级完成" : "升级失败");
 		if (code !== 0) {
-			logger_default.error("升级失败，可手动执行: npm install -g " + pkgName + "@latest");
+			if (plugin) logger_default.error("升级失败，可手动执行: " + officialInstallManualForPlatform());
+			else logger_default.error("升级失败，可手动执行: npm install -g " + pkgName + "@latest");
 			process.exit(1);
 		}
-		p.log.success(`已升级到 ${chalk.green(latest)}`);
+		p.log.success(plugin ? `已通过官方脚本更新（目标版本 ${chalk.green(latest)}）` : `已升级到 ${chalk.green(latest)}`);
 	} catch (err) {
 		spinner.stop("检查失败");
 		p.log.error(err.message);
-		logger_default.info("可手动执行: npm install -g " + pkgName + "@latest");
+		if (plugin) logger_default.info("可手动执行: " + officialInstallManualForPlatform());
+		else logger_default.info("可手动执行: npm install -g " + pkgName + "@latest");
 		process.exit(1);
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-atlas-cli",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "skill-atlas CLI - 虾小宝 命令行工具",
   "homepage": "https://skillatlas.cn/",
   "type": "module",