@kg-ai/kugou-skill 0.0.21 → 0.0.23

package/README.md

@@ -14,14 +14,14 @@ npm install -g @kg-ai/kugou-skill
 
 ## 前置条件
 
-使用前需要扫码登录（两步流程）：
+使用前需要扫码登录（极简流程）：
 
 ```bash
 # Step 1: 获取二维码图片
 kugou-cli auth login
 
-# Step 2: 轮询等待用户扫码确认（使用 Step 1 返回的 qrcode）
-kugou-cli auth check -q <qrcode>
+# Step 2: 循环检查登录状态（直到 logged_in=true）
+kugou-cli auth status
 ```
 
 > 必须将 Step 1 输出中 `qrcode_img_path` 对应的图片发送给用户扫码。token 会自动持久化存储。
@@ -34,10 +34,7 @@ kugou-cli auth check -q <qrcode>
 # 获取二维码图片
 kugou-cli auth login
 
-# 轮询等待扫码确认
-kugou-cli auth check -q <qrcode>
-
-# 查看登录状态
+# 检查登录状态（未完成登录时内部自动轮询）
 kugou-cli auth status
 
 # 登出
@@ -96,6 +93,12 @@ kugou-cli install --hermes --openclaw --codex
 ```bash
 kugou-cli --version
 kugou-cli --help
+
+# 检查更新
+kugou-cli update --check
+
+# 更新（仅 npm 安装支持）
+kugou-cli update --force
 ```
 
 ## 输出格式

package/SKILL.md

@@ -32,9 +32,9 @@ description: |
 
 ### 关键注意事项
 
-- **登录流程分为两步**（详见 [references/auth.md](references/auth.md)）：
+- **登录流程极简**（详见 [references/auth.md](references/auth.md)）：
   1. `auth login` - 获取二维码图片，输出包含 `qrcode` 和 `qrcode_img_path`（**必须将图片发送给用户**）
-  2. `auth check -q <qrcode>` - 从 login 输出中提取 qrcode 值，传入此命令轮询等待扫码确认，必须等到 `"status":"success"` 才能继续
+  2. `auth status` - 循环调用此命令检查登录状态：已登录返回 `logged_in: true`；未登录但有 pending qrcode 时内部自动检查扫码状态，扫码成功则自动完成登录
 - **音乐命令依赖登录**：除了 `auth`、`install`、`version`、`--help` 以外，所有 `music` 子命令都需要先登录。如果收到 `"not logged in"` 错误，引导用户执行登录流程。
 - **输出均为 JSON**：所有命令输出原始 JSON 到 stdout，错误输出到 stderr。解析 `errcode` 字段判断成功与否（`0` 为成功）。
 - **歌曲展示规范**（详见 [references/output-format.md](references/output-format.md)）：**禁止**只返回歌曲名、歌手名，**必须**以 Markdown 链接格式展示播放链接。
@@ -57,6 +57,7 @@ description: |
 | [references/auth.md](references/auth.md) | 认证命令：扫码登录、查看状态、登出 |
 | [references/music.md](references/music.md) | 音乐命令：搜索、推荐、收藏、统计、榜单 |
 | [references/install.md](references/install.md) | 安装命令：SKILL.md 安装到各平台 |
+| [references/update.md](references/update.md) | 更新命令：检查/执行自动更新 |
 | [references/output-format.md](references/output-format.md) | 输出格式与展示规范 |
 | [references/error-handling.md](references/error-handling.md) | 错误处理与常见错误 |
 
@@ -65,28 +66,26 @@ description: |
 ## 完整使用流程
 
 ```bash
-# 1. 登录（两步流程，详见 references/auth.md）
-kugou-cli auth login
-kugou-cli auth check -q <qrcode>
-
-# 2. 查看登录状态
+# 1. 登录（极简流程，详见 references/auth.md）
+kugou-cli auth login                      # 获取二维码
+# 循环执行以下命令直到 logged_in=true
 kugou-cli auth status
 
-# 3. 搜索歌曲
+# 2. 搜索歌曲
 kugou-cli music search "周杰伦"
 
-# 4. 获取每日推荐
-kugou-cli music recommend daily --num 5
+# 3. 获取猜你喜欢
+kugou-cli music recommend guess
 
-# 5. 查看我的收藏
+# 4. 查看我的收藏
 kugou-cli music favorites
 
-# 6. 查看最近播放
+# 5. 查看最近播放
 kugou-cli music recent
 
-# 7. 查看听歌统计
+# 6. 查看听歌统计
 kugou-cli music stats
 
-# 8. 查看抖音热歌榜
+# 7. 查看抖音热歌榜
 kugou-cli music charts 52144
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kg-ai/kugou-skill",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "Kugou Skill CLI",
   "main": "index.js",
   "bin": {