@linsxyx/kamusic 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# @linsxyx/kamusic (KA Music CLI)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+最好用、最轻量的酷狗音乐概念版终端 TUI 播放器（NativeAOT 原生编译，跨 Windows / macOS / Linux 全平台）。
+
+## 安装与启动
+
+```bash
+# 全局安装
+npm install -g @linsxyx/kamusic
+
+# 启动播放器
+kamusic
+
+# 检查并更新到最新版本
+kamusic update
+```

package/bin/kamusic.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+
+// 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 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": {
+    pkg: "@linsxyx/kamusic-win32-x64",
+    dir: "kamusic-win32-x64",
+    bin: "KaMusic.Cli.exe",
+  },
+  "win32-arm64": {
+    pkg: "@linsxyx/kamusic-win32-arm64",
+    dir: "kamusic-win32-arm64",
+    bin: "KaMusic.Cli.exe",
+  },
+  "linux-x64": {
+    pkg: "@linsxyx/kamusic-linux-x64",
+    dir: "kamusic-linux-x64",
+    bin: "KaMusic.Cli",
+  },
+  "linux-arm64": {
+    pkg: "@linsxyx/kamusic-linux-arm64",
+    dir: "kamusic-linux-arm64",
+    bin: "KaMusic.Cli",
+  },
+  "darwin-arm64": {
+    pkg: "@linsxyx/kamusic-darwin-arm64",
+    dir: "kamusic-darwin-arm64",
+    bin: "KaMusic.Cli",
+  },
+  "darwin-x64": {
+    pkg: "@linsxyx/kamusic-darwin-x64",
+    dir: "kamusic-darwin-x64",
+    bin: "KaMusic.Cli",
+  },
+};
+
+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];
+  if (!target) {
+    console.error(
+      `[kamusic] 当前平台暂不支持: ${key}（支持平台: ${Object.keys(PLATFORM_PACKAGES).join(", ")}）`
+    );
+    process.exit(1);
+  }
+
+  const candidates = [];
+
+  try {
+    const pkgJsonPath = require.resolve(`${target.pkg}/package.json`);
+    candidates.push(path.join(path.dirname(pkgJsonPath), "vendor", target.bin));
+  } catch {
+    // fallback to workspace sibling directory
+  }
+
+  candidates.push(
+    path.resolve(__dirname, "..", "..", target.dir, "vendor", target.bin)
+  );
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  console.error(
+    `[kamusic] 未找到当前平台 (${key}) 的原生可执行文件，请确认可选依赖包 "${target.pkg}" 已安装（可执行 kamusic update --force 修复）。`
+  );
+  process.exit(1);
+}
+
+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 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);
+  });
+}
+
+main();

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@linsxyx/kamusic",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "KA Music 终端 TUI 播放器（NativeAOT 跨平台命令行版，支持终端专辑封面、KRC 逐字歌词、频谱与酷狗账号登录）",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Linsxyx/KugouMusic.NET.git"
+  },
+  "homepage": "https://github.com/Linsxyx/KugouMusic.NET",
+  "bugs": {
+    "url": "https://github.com/Linsxyx/KugouMusic.NET/issues"
+  },
+  "keywords": [
+    "kamusic",
+    "kugou",
+    "music",
+    "player",
+    "tui",
+    "cli",
+    "terminal"
+  ],
+  "bin": {
+    "kamusic": "bin/kamusic.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@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"
+  }
+}