@linsxyx/kamusic 0.1.0 → 0.1.1

package/README.md

@@ -5,22 +5,12 @@
 ## 安装与启动
 
 ```bash
-# 全局安装（推荐）
+# 全局安装
 npm install -g @linsxyx/kamusic
 
 # 启动播放器
 kamusic
-```
-
-或者免安装直接运行：
 
-```bash
-npx @linsxyx/kamusic
+# 检查并更新到最新版本
+kamusic update
 ```
-
-## 特性
-
-- **多协议终端高清图片**：自动检测并支持 Kitty Graphics Protocol、iTerm2 (`OSC 1337`)、Sixel 与 UTF-8 半块字符（`▀`），终端内直接渲染登录二维码、专辑封面与歌单封面。
-- **全功能音频播放与音效**：支持每日推荐、私人 FM、发现歌单、排行榜、搜索、我的歌单、KRC 逐字高亮歌词、频谱可视化、10 段均衡器与智能无缝过渡。
-- **鼠标与键盘双交互**：支持键盘快捷键与终端鼠标点击/双击/滚轮交互。
-- **独立安全会话**：与桌面端分离存储（`KgTestSession.json`），Windows 下采用系统 DPAPI 加密保护登录态。

package/bin/kamusic.js

@@ -1,10 +1,20 @@
 #!/usr/bin/env node
 
-// kamusic CLI 启动入口：根据当前 OS 与 CPU 架构定位对应平台子包中的 NativeAOT 可执行文件并透传终端标准流与信号。
+// kamusic CLI 启动入口：支持 `kamusic update` / `kamusic -v`，并根据当前 OS 与 CPU 架构定位对应平台子包中的 NativeAOT 可执行文件（支持 TUI 内触发退出码 42 自动更新并重启）。
 
 const fs = require("node:fs");
+const os = require("node:os");
 const path = require("node:path");
-const { spawn } = require("node:child_process");
+const https = require("node:https");
+const { spawn, spawnSync } = require("node:child_process");
+
+const MAIN_PKG_NAME = "@linsxyx/kamusic";
+const UPDATE_EXIT_CODE = 42;
+
+const REGISTRY_URLS = [
+  "https://registry.npmjs.org/@linsxyx%2fkamusic/latest",
+  "https://registry.npmmirror.com/@linsxyx/kamusic/latest",
+];
 
 const PLATFORM_PACKAGES = {
   "win32-x64": {
@@ -39,7 +49,123 @@ const PLATFORM_PACKAGES = {
   },
 };
 
-// 解析当前平台对应的 KaMusic.Cli 原生二进制绝对路径（兼容 npm 全局安装、npx 与本地工作区目录）。
+function getCurrentVersion() {
+  try {
+    const pkgPath = path.resolve(__dirname, "..", "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return pkg.version || "0.1.0";
+  } catch {
+    return "0.1.0";
+  }
+}
+
+function compareSemVer(a, b) {
+  const pa = String(a).replace(/^v/i, "").split("-")[0].split(".");
+  const pb = String(b).replace(/^v/i, "").split("-")[0].split(".");
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const va = Number.parseInt(pa[i] || "0", 10) || 0;
+    const vb = Number.parseInt(pb[i] || "0", 10) || 0;
+    if (va !== vb) return va > vb ? 1 : -1;
+  }
+  return 0;
+}
+
+function fetchJson(url, timeoutMs = 5000) {
+  return new Promise((resolve, reject) => {
+    const req = https.get(
+      url,
+      { headers: { "User-Agent": "kamusic-cli-updater/1.0" }, timeout: timeoutMs },
+      (res) => {
+        if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          fetchJson(res.headers.location, timeoutMs).then(resolve, reject);
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`HTTP ${res.statusCode}`));
+          return;
+        }
+        let body = "";
+        res.setEncoding("utf8");
+        res.on("data", (chunk) => (body += chunk));
+        res.on("end", () => {
+          try {
+            resolve(JSON.parse(body));
+          } catch (e) {
+            reject(e);
+          }
+        });
+      }
+    );
+    req.on("error", reject);
+    req.on("timeout", () => {
+      req.destroy(new Error("timeout"));
+    });
+  });
+}
+
+async function fetchLatestVersion() {
+  for (const url of REGISTRY_URLS) {
+    try {
+      const data = await fetchJson(url);
+      if (data && typeof data.version === "string" && data.version.trim()) {
+        return data.version.trim();
+      }
+    } catch {
+      // try next mirror
+    }
+  }
+  return null;
+}
+
+function installGlobalPackage(targetSpec) {
+  const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
+  const baseArgs = ["install", "-g", targetSpec, "--prefer-online"];
+
+  let res = spawnSync(npmCmd, baseArgs, { stdio: "inherit", shell: process.platform === "win32" });
+  if (res.status === 0) {
+    return true;
+  }
+
+  console.log("[kamusic] 检测到默认 npm 缓存可能存在权限冲突，正在使用独立临时缓存重试...");
+  const tempCache = path.join(os.tmpdir(), "kamusic-npm-cache");
+  res = spawnSync(npmCmd, [...baseArgs, "--cache", tempCache], {
+    stdio: "inherit",
+    shell: process.platform === "win32",
+  });
+  return res.status === 0;
+}
+
+async function handleUpdateCommand({ force = false, restartAfter = false } = {}) {
+  const current = getCurrentVersion();
+  console.log(`[kamusic] 当前版本: v${current}，正在检查 npm (${MAIN_PKG_NAME}) 最新版本...`);
+  const latest = await fetchLatestVersion();
+  if (!latest) {
+    console.error("[kamusic] 无法连接 npm 源获取最新版本，请检查网络连接。");
+    process.exit(1);
+  }
+
+  if (!force && compareSemVer(latest, current) <= 0) {
+    console.log(`[kamusic] 当前已是最新版本 (v${current})。如需强制重装可执行: kamusic update --force`);
+    return false;
+  }
+
+  console.log(`[kamusic] 发现新版本 v${latest}，开始更新 ${MAIN_PKG_NAME}@${latest} ...`);
+  const ok = installGlobalPackage(`${MAIN_PKG_NAME}@${latest}`);
+  if (!ok) {
+    console.error(`[kamusic] 更新失败，可手动执行: npm i -g ${MAIN_PKG_NAME}@latest`);
+    process.exit(1);
+  }
+
+  console.log(`[kamusic] ✓ 已成功更新至 v${latest}！`);
+  if (restartAfter) {
+    console.log("[kamusic] 正在重新启动播放器...");
+    const res = spawnSync("kamusic", [], { stdio: "inherit", shell: process.platform === "win32" });
+    process.exit(res.status ?? 0);
+  }
+  return true;
+}
+
 function resolveBinaryPath() {
   const key = `${process.platform}-${process.arch}`;
   const target = PLATFORM_PACKAGES[key];
@@ -70,46 +196,89 @@ function resolveBinaryPath() {
   }
 
   console.error(
-    `[kamusic] 未找到当前平台 (${key}) 的原生可执行文件，请确认可选依赖包 "${target.pkg}" 已安装（检查是否启用了 --no-optional）。`
+    `[kamusic] 未找到当前平台 (${key}) 的原生可执行文件，请确认可选依赖包 "${target.pkg}" 已安装（可执行 kamusic update --force 修复）。`
   );
   process.exit(1);
 }
 
-const binPath = resolveBinaryPath();
-if (process.platform !== "win32") {
-  try {
-    fs.chmodSync(binPath, 0o755);
-  } catch {
-    // ignore chmod errors on read-only mounts
+async function main() {
+  const args = process.argv.slice(2);
+  const first = args[0];
+
+  if (first === "-v" || first === "--version" || first === "version") {
+    console.log(`${MAIN_PKG_NAME} v${getCurrentVersion()} (${process.platform}-${process.arch})`);
+    return;
+  }
+
+  if (first === "update" || first === "upgrade" || first === "-u" || first === "--update") {
+    const force = args.includes("--force") || args.includes("-f");
+    await handleUpdateCommand({ force, restartAfter: false });
+    return;
+  }
+
+  if (first === "check" || first === "--check-update") {
+    const current = getCurrentVersion();
+    const latest = await fetchLatestVersion();
+    if (!latest) {
+      console.error("[kamusic] 检查更新失败：无法连接 npm 源。");
+      process.exit(1);
+    }
+    if (compareSemVer(latest, current) > 0) {
+      console.log(`[kamusic] 发现新版本: v${current} -> v${latest}（运行 \`kamusic update\` 即可更新）`);
+    } else {
+      console.log(`[kamusic] 当前已是最新版本: v${current}`);
+    }
+    return;
+  }
+
+  const binPath = resolveBinaryPath();
+  if (process.platform !== "win32") {
+    try {
+      fs.chmodSync(binPath, 0o755);
+    } catch {
+      // ignore chmod errors on read-only mounts
+    }
   }
-}
 
-const child = spawn(binPath, process.argv.slice(2), {
-  stdio: "inherit",
-  windowsHide: false,
-});
-
-for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
-  process.on(sig, () => {
-    if (!child.killed) {
-      try {
-        child.kill(sig);
-      } catch {
-        // ignore
+  const currentVersion = getCurrentVersion();
+  const child = spawn(binPath, args, {
+    stdio: "inherit",
+    windowsHide: false,
+    env: {
+      ...process.env,
+      KAMUSIC_NPM_WRAPPER: "1",
+      KAMUSIC_VERSION: currentVersion,
+    },
+  });
+
+  for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+    process.on(sig, () => {
+      if (!child.killed) {
+        try {
+          child.kill(sig);
+        } catch {
+          // ignore
+        }
       }
+    });
+  }
+
+  child.on("error", (err) => {
+    console.error(`[kamusic] 启动失败: ${err.message}`);
+    process.exit(1);
+  });
+
+  child.on("exit", async (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    if (code === UPDATE_EXIT_CODE) {
+      await handleUpdateCommand({ force: false, restartAfter: true });
+      return;
     }
+    process.exit(code ?? 0);
   });
 }
 
-child.on("error", (err) => {
-  console.error(`[kamusic] 启动失败: ${err.message}`);
-  process.exit(1);
-});
-
-child.on("exit", (code, signal) => {
-  if (signal) {
-    process.kill(process.pid, signal);
-    return;
-  }
-  process.exit(code ?? 0);
-});
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linsxyx/kamusic",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "KA Music 终端 TUI 播放器（NativeAOT 跨平台命令行版，支持终端专辑封面、KRC 逐字歌词、频谱与酷狗账号登录）",
   "license": "MIT",
   "repository": {
@@ -33,11 +33,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@linsxyx/kamusic-darwin-arm64": "0.1.0",
-    "@linsxyx/kamusic-darwin-x64": "0.1.0",
-    "@linsxyx/kamusic-linux-arm64": "0.1.0",
-    "@linsxyx/kamusic-linux-x64": "0.1.0",
-    "@linsxyx/kamusic-win32-arm64": "0.1.0",
-    "@linsxyx/kamusic-win32-x64": "0.1.0"
+    "@linsxyx/kamusic-win32-x64": "0.1.1",
+    "@linsxyx/kamusic-win32-arm64": "0.1.1",
+    "@linsxyx/kamusic-linux-x64": "0.1.1",
+    "@linsxyx/kamusic-linux-arm64": "0.1.1",
+    "@linsxyx/kamusic-darwin-arm64": "0.1.1",
+    "@linsxyx/kamusic-darwin-x64": "0.1.1"
   }
 }