@linsxyx/kamusic 0.0.0-stage → 0.1.0

package/README.md

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

package/bin/kamusic.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+// kamusic CLI 启动入口：根据当前 OS 与 CPU 架构定位对应平台子包中的 NativeAOT 可执行文件并透传终端标准流与信号。
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawn } = require("node:child_process");
+
+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",
+  },
+};
+
+// 解析当前平台对应的 KaMusic.Cli 原生二进制绝对路径（兼容 npm 全局安装、npx 与本地工作区目录）。
+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}" 已安装（检查是否启用了 --no-optional）。`
+  );
+  process.exit(1);
+}
+
+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
+      }
+    }
+  });
+}
+
+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);
+});

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.0",
+  "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-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"
+  }
+}