@kg-ai/kugou-skill 0.1.2 → 0.1.4

package/references/output-format.md

@@ -1,42 +1,42 @@
-# 输出格式与展示规范
-
-## 通用响应结构
-
-所有 API 命令输出标准 JSON 结构：
-
-```json
-{
-  "errcode": 0,
-  "errmsg": "",
-  "data": { ... },
-  "status": 1
-}
-```
-
-**响应状态**:
-- `errcode: 0` 表示成功
-- `data` 包含实际业务数据
-- `status: 1` 表示接口调用成功
-
----
-
-## 展示规范
-
-向用户展示结果时，**必须遵循以下规范**：
-
-### 1. 歌曲列表展示（强制要求）
-
-- **禁止**只返回歌曲名、歌手名
-- **必须**以 Markdown 链接格式展示播放链接
-- 正确格式：`[歌曲名 - 歌手名](https://www.kugou.com/...)`
-- 禁止格式：`晴天 - 周杰伦`（无链接）、`歌曲名: 晴天, 歌手: 周杰伦`（无链接）
-
-### 2. 统计数据
-
-提取关键字段并以结构化方式呈现（如"累计听歌 342 首，时长 22.4 小时"）
-
-### 3. 二维码
-
-使用 `qrcode_img_path` 对应的图片文件发送给用户
-
----
+# 输出格式与展示规范
+
+## 通用响应结构
+
+所有 API 命令输出标准 JSON 结构：
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "",
+  "data": { ... },
+  "status": 1
+}
+```
+
+**响应状态**:
+- `errcode: 0` 表示成功
+- `data` 包含实际业务数据
+- `status: 1` 表示接口调用成功
+
+---
+
+## 展示规范
+
+向用户展示结果时，**必须遵循以下规范**：
+
+### 1. 歌曲列表展示（强制要求）
+
+- **禁止**只返回歌曲名、歌手名
+- **必须**以 Markdown 链接格式展示播放链接
+- 正确格式：`[歌曲名 - 歌手名](https://www.kugou.com/...)`
+- 禁止格式：`晴天 - 周杰伦`（无链接）、`歌曲名: 晴天, 歌手: 周杰伦`（无链接）
+
+### 2. 统计数据
+
+提取关键字段并以结构化方式呈现（如"累计听歌 342 首，时长 22.4 小时"）
+
+### 3. 二维码
+
+使用 `qrcode_img_path` 对应的图片文件发送给用户
+
+---

package/references/update.md

@@ -1,128 +1,128 @@
-# 更新命令 (update)
-
-> 自动检查并更新 kugou-cli
-
-## 命令
-
-| 命令 | 说明 |
-|------|------|
-| `kugou-cli update --check` | 仅检查更新，不执行 |
-| `kugou-cli update` | 检查并提示（不自动执行） |
-| `kugou-cli update --force` | 直接执行更新（仅 npm 安装） |
-
----
-
-## 工作机制
-
-### 1. 启动时检查
-
-每次执行任意 `kugou-cli` 命令时，**后台异步**检查 npm registry 上的最新版本。
-
-- **不阻塞** 主命令
-- 有更新时输出到 **stderr**（避免污染 stdout JSON 输出）
-- 提示格式：
-  ```
-  [kugou-cli] update available: 0.0.22 → 0.0.23 (run `kugou-cli update` to upgrade)
-  ```
-
-### 2. 检查频率限制
-
-- 缓存文件：`~/.config/kugou-cli/update_check.json`
-- 缓存有效期：**24 小时**
-- 24 小时内不会重复访问 npm registry
-
-### 3. 跳过检查
-
-在以下情况跳过启动检查：
-- `CI=true` 环境变量
-- `KUGOU_CLI_NO_UPDATE_CHECK=1` 环境变量
-- 命令行指定 `--no-update-check` flag
-
----
-
-## 显式检查更新
-
-```bash
-kugou-cli update --check
-```
-
-**输出示例**：
-
-有更新时：
-```json
-{
-  "current_version": "0.0.22",
-  "latest_version": "0.0.23",
-  "update_available": true,
-  "install_method": "npm",
-  "update_command": "npm install -g @kg-ai/kugou-skill@latest"
-}
-```
-
-无更新时：
-```json
-{
-  "current_version": "0.0.22",
-  "latest_version": "0.0.22",
-  "update_available": false,
-  "install_method": "npm"
-}
-```
-
----
-
-## 执行更新
-
-### 方式 1：Agent / 脚本（推荐）
-
-```bash
-# 步骤 1: 检查
-info=$(kugou-cli update --check)
-update_available=$(echo "$info" | jq -r '.update_available')
-
-# 步骤 2: 如果有更新，提示用户确认后执行
-if [ "$update_available" = "true" ]; then
-  echo "有可用更新，正在升级..."
-  kugou-cli update --force
-fi
-```
-
-### 方式 2：手动
-
-```bash
-# 提示但不执行
-kugou-cli update
-# 显示: About to run: npm install -g @kg-ai/kugou-skill@latest
-
-# 强制执行
-kugou-cli update --force
-```
-
-### 方式 3：标准 npm 命令
-
-无需 `update` 子命令，直接：
-```bash
-npm install -g @kg-ai/kugou-skill@latest
-```
-
----
-
-## 安装方式检测
-
-CLI 自动检测安装方式：
-
-| 安装方式 | 检测方法 | 是否支持自动更新 |
-|---------|---------|------------------|
-| **npm** | 二进制路径包含 `node_modules/@kg-ai/kugou-skill` | ✅ 支持 |
-| **其他**（源码编译 / 手动下载） | 其他路径 | ❌ 仅提示 |
-
-非 npm 安装时，CLI 只会提示，不会自动更新。请使用对应方式更新。
-
----
-
-## 注意事项
-
-1. **网络要求**：检查更新需要访问 `https://registry.npmjs.org`，在受限网络下可能失败
-2. **离线友好**：网络失败时静默忽略，不影响主命令
-3. **CI 友好**：CI 环境默认跳过检查，避免污染日志
-4. **不强制**：默认仅提示，更新需用户/Agent 显式确认
+# 更新命令 (update)
+
+> 自动检查并更新 kugou-cli
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `kugou-cli update --check` | 仅检查更新，不执行 |
+| `kugou-cli update` | 检查并提示（不自动执行） |
+| `kugou-cli update --force` | 直接执行更新（仅 npm 安装） |
+
+---
+
+## 工作机制
+
+### 1. 启动时检查
+
+每次执行任意 `kugou-cli` 命令时，**后台异步**检查 npm registry 上的最新版本。
+
+- **不阻塞** 主命令
+- 有更新时输出到 **stderr**（避免污染 stdout JSON 输出）
+- 提示格式：
+  ```
+  [kugou-cli] update available: 0.0.22 → 0.0.23 (run `kugou-cli update` to upgrade)
+  ```
+
+### 2. 检查频率限制
+
+- 缓存文件：`~/.config/kugou-cli/update_check.json`
+- 缓存有效期：**24 小时**
+- 24 小时内不会重复访问 npm registry
+
+### 3. 跳过检查
+
+在以下情况跳过启动检查：
+- `CI=true` 环境变量
+- `KUGOU_CLI_NO_UPDATE_CHECK=1` 环境变量
+- 命令行指定 `--no-update-check` flag
+
+---
+
+## 显式检查更新
+
+```bash
+kugou-cli update --check
+```
+
+**输出示例**：
+
+有更新时：
+```json
+{
+  "current_version": "0.0.22",
+  "latest_version": "0.0.23",
+  "update_available": true,
+  "install_method": "npm",
+  "update_command": "npm install -g @kg-ai/kugou-skill@latest"
+}
+```
+
+无更新时：
+```json
+{
+  "current_version": "0.0.22",
+  "latest_version": "0.0.22",
+  "update_available": false,
+  "install_method": "npm"
+}
+```
+
+---
+
+## 执行更新
+
+### 方式 1：Agent / 脚本（推荐）
+
+```bash
+# 步骤 1: 检查
+info=$(kugou-cli update --check)
+update_available=$(echo "$info" | jq -r '.update_available')
+
+# 步骤 2: 如果有更新，提示用户确认后执行
+if [ "$update_available" = "true" ]; then
+  echo "有可用更新，正在升级..."
+  kugou-cli update --force
+fi
+```
+
+### 方式 2：手动
+
+```bash
+# 提示但不执行
+kugou-cli update
+# 显示: About to run: npm install -g @kg-ai/kugou-skill@latest
+
+# 强制执行
+kugou-cli update --force
+```
+
+### 方式 3：标准 npm 命令
+
+无需 `update` 子命令，直接：
+```bash
+npm install -g @kg-ai/kugou-skill@latest
+```
+
+---
+
+## 安装方式检测
+
+CLI 自动检测安装方式：
+
+| 安装方式 | 检测方法 | 是否支持自动更新 |
+|---------|---------|------------------|
+| **npm** | 二进制路径包含 `node_modules/@kg-ai/kugou-skill` | ✅ 支持 |
+| **其他**（源码编译 / 手动下载） | 其他路径 | ❌ 仅提示 |
+
+非 npm 安装时，CLI 只会提示，不会自动更新。请使用对应方式更新。
+
+---
+
+## 注意事项
+
+1. **网络要求**：检查更新需要访问 `https://registry.npmjs.org`，在受限网络下可能失败
+2. **离线友好**：网络失败时静默忽略，不影响主命令
+3. **CI 友好**：CI 环境默认跳过检查，避免污染日志
+4. **不强制**：默认仅提示，更新需用户/Agent 显式确认

package/scripts/build-all.js

@@ -1,52 +1,52 @@
-#!/usr/bin/env node
-/**
- * 构建所有平台二进制
- * 使用方式: node scripts/build-all.js
- */
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const platforms = [
-  { os: 'darwin', arch: 'arm64', name: 'darwin-arm64', exe: 'kugou-cli' },
-  { os: 'darwin', arch: 'amd64', name: 'darwin-x64', exe: 'kugou-cli' },
-  { os: 'linux', arch: 'arm64', name: 'linux-arm64', exe: 'kugou-cli' },
-  { os: 'linux', arch: 'amd64', name: 'linux-x64', exe: 'kugou-cli' },
-  { os: 'windows', arch: 'amd64', name: 'win32-x64', exe: 'kugou-cli.exe' },
-];
-
-const binDir = path.join(__dirname, '..', 'bin');
-
-console.log('=== Building all platforms ===\n');
-
-// 清理平台目录
-for (const p of platforms) {
-  const dir = path.join(binDir, p.name);
-  if (fs.existsSync(dir)) {
-    fs.rmSync(dir, { recursive: true });
-  }
-}
-
-// 构建每个平台
-for (const p of platforms) {
-  const outDir = path.join(binDir, p.name);
-  fs.mkdirSync(outDir, { recursive: true });
-
-  const outFile = path.join(outDir, p.exe);
-  console.log(`Building ${p.name}...`);
-
-  try {
-    execSync(`go build -ldflags="-s -w" -o "${outFile}" .`, {
-      env: { ...process.env, GOOS: p.os, GOARCH: p.arch, CGO_ENABLED: '0' },
-      stdio: 'inherit',
-    });
-    console.log(`✅ Built: ${p.name}\n`);
-  } catch (err) {
-    console.error(`❌ Failed: ${p.name}\n`);
-    process.exit(1);
-  }
-}
-
-console.log('=== All platforms built successfully! ===');
-console.log('\nRun: node scripts/pack.js');
+#!/usr/bin/env node
+/**
+ * 构建所有平台二进制
+ * 使用方式: node scripts/build-all.js
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const platforms = [
+  { os: 'darwin', arch: 'arm64', name: 'darwin-arm64', exe: 'kugou-cli' },
+  { os: 'darwin', arch: 'amd64', name: 'darwin-x64', exe: 'kugou-cli' },
+  { os: 'linux', arch: 'arm64', name: 'linux-arm64', exe: 'kugou-cli' },
+  { os: 'linux', arch: 'amd64', name: 'linux-x64', exe: 'kugou-cli' },
+  { os: 'windows', arch: 'amd64', name: 'win32-x64', exe: 'kugou-cli.exe' },
+];
+
+const binDir = path.join(__dirname, '..', 'bin');
+
+console.log('=== Building all platforms ===\n');
+
+// 清理平台目录
+for (const p of platforms) {
+  const dir = path.join(binDir, p.name);
+  if (fs.existsSync(dir)) {
+    fs.rmSync(dir, { recursive: true });
+  }
+}
+
+// 构建每个平台
+for (const p of platforms) {
+  const outDir = path.join(binDir, p.name);
+  fs.mkdirSync(outDir, { recursive: true });
+
+  const outFile = path.join(outDir, p.exe);
+  console.log(`Building ${p.name}...`);
+
+  try {
+    execSync(`go build -ldflags="-s -w" -o "${outFile}" .`, {
+      env: { ...process.env, GOOS: p.os, GOARCH: p.arch, CGO_ENABLED: '0' },
+      stdio: 'inherit',
+    });
+    console.log(`✅ Built: ${p.name}\n`);
+  } catch (err) {
+    console.error(`❌ Failed: ${p.name}\n`);
+    process.exit(1);
+  }
+}
+
+console.log('=== All platforms built successfully! ===');
+console.log('\nRun: node scripts/pack.js');

package/scripts/pack.js

@@ -1,67 +1,67 @@
-#!/usr/bin/env node
-/**
- * 本地打包脚本
- * 使用方式: node scripts/pack.js
- *
- * 发布流程:
- * 1. 构建所有平台二进制到 bin/{platform}/
- * 2. 运行 node scripts/pack.js
- * 3. 运行 npm publish
- */
-
-const fs = require('fs');
-const path = require('path');
-const pkgRoot = path.join(__dirname, '..');
-
-// 检查必要文件
-const requiredFiles = [
-  'package.json',
-  'SKILL.md',
-  'scripts/install.js',
-  'scripts/run.js'
-];
-
-// 检查平台二进制
-const platforms = [
-  'darwin-arm64',
-  'darwin-x64',
-  'linux-arm64',
-  'linux-x64',
-  'win32-x64'
-];
-
-console.log('=== 检查必要文件 ===');
-let hasError = false;
-
-for (const file of requiredFiles) {
-  const filePath = path.join(pkgRoot, file);
-  if (fs.existsSync(filePath)) {
-    console.log(`✅ ${file}`);
-  } else {
-    console.log(`❌ ${file} - 缺失`);
-    hasError = true;
-  }
-}
-
-console.log('\n=== 检查平台二进制 ===');
-for (const platform of platforms) {
-  const exeName = platform.startsWith('win32') ? 'kugou-cli.exe' : 'kugou-cli';
-  const binPath = path.join(pkgRoot, 'bin', platform, exeName);
-  if (fs.existsSync(binPath)) {
-    const size = fs.statSync(binPath).size;
-    console.log(`✅ ${platform}: ${exeName} (${(size / 1024 / 1024).toFixed(2)} MB)`);
-  } else {
-    console.log(`❌ ${platform}: ${exeName} - 缺失`);
-    hasError = true;
-  }
-}
-
-if (hasError) {
-  console.log('\n❌ 打包检查失败，请确保所有文件都已构建');
-  process.exit(1);
-}
-
-console.log('\n=== 构建完成 ===');
-console.log('运行以下命令发布:');
-console.log('  npm pack');
-console.log('  npm publish --access public --scope=@kugouai');
+#!/usr/bin/env node
+/**
+ * 本地打包脚本
+ * 使用方式: node scripts/pack.js
+ *
+ * 发布流程:
+ * 1. 构建所有平台二进制到 bin/{platform}/
+ * 2. 运行 node scripts/pack.js
+ * 3. 运行 npm publish
+ */
+
+const fs = require('fs');
+const path = require('path');
+const pkgRoot = path.join(__dirname, '..');
+
+// 检查必要文件
+const requiredFiles = [
+  'package.json',
+  'SKILL.md',
+  'scripts/install.js',
+  'scripts/run.js'
+];
+
+// 检查平台二进制
+const platforms = [
+  'darwin-arm64',
+  'darwin-x64',
+  'linux-arm64',
+  'linux-x64',
+  'win32-x64'
+];
+
+console.log('=== 检查必要文件 ===');
+let hasError = false;
+
+for (const file of requiredFiles) {
+  const filePath = path.join(pkgRoot, file);
+  if (fs.existsSync(filePath)) {
+    console.log(`✅ ${file}`);
+  } else {
+    console.log(`❌ ${file} - 缺失`);
+    hasError = true;
+  }
+}
+
+console.log('\n=== 检查平台二进制 ===');
+for (const platform of platforms) {
+  const exeName = platform.startsWith('win32') ? 'kugou-cli.exe' : 'kugou-cli';
+  const binPath = path.join(pkgRoot, 'bin', platform, exeName);
+  if (fs.existsSync(binPath)) {
+    const size = fs.statSync(binPath).size;
+    console.log(`✅ ${platform}: ${exeName} (${(size / 1024 / 1024).toFixed(2)} MB)`);
+  } else {
+    console.log(`❌ ${platform}: ${exeName} - 缺失`);
+    hasError = true;
+  }
+}
+
+if (hasError) {
+  console.log('\n❌ 打包检查失败，请确保所有文件都已构建');
+  process.exit(1);
+}
+
+console.log('\n=== 构建完成 ===');
+console.log('运行以下命令发布:');
+console.log('  npm pack');
+console.log('  npm publish --access public --scope=@kugouai');

package/scripts/run.js

@@ -1,21 +1,21 @@
-#!/usr/bin/env node
-const { spawn } = require('child_process');
-const path = require('path');
-
-// 获取当前平台对应的二进制路径
-const platform = process.platform; // darwin, linux, win32
-
-const binName = platform === 'win32' ? 'kugou-cli.exe' : 'kugou-cli';
-// scripts/ 的父目录就是项目根目录，bin/ 在根目录下
-// 使用简单名称，install.js 会复制对应平台的二进制到这里
-const rootDir = path.join(__dirname, '..');
-const binPath = path.join(rootDir, 'bin', binName);
-
-const child = spawn(binPath, process.argv.slice(2), {
-  stdio: 'inherit',
-  shell: platform === 'win32'
-});
-
-child.on('exit', (code) => {
-  process.exit(code);
-});
+#!/usr/bin/env node
+const { spawn } = require('child_process');
+const path = require('path');
+
+// 获取当前平台对应的二进制路径
+const platform = process.platform; // darwin, linux, win32
+
+const binName = platform === 'win32' ? 'kugou-cli.exe' : 'kugou-cli';
+// scripts/ 的父目录就是项目根目录，bin/ 在根目录下
+// 使用简单名称，install.js 会复制对应平台的二进制到这里
+const rootDir = path.join(__dirname, '..');
+const binPath = path.join(rootDir, 'bin', binName);
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  shell: platform === 'win32'
+});
+
+child.on('exit', (code) => {
+  process.exit(code);
+});