@kg-ai/kugou-skill 0.0.21 → 0.0.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -14,14 +14,14 @@ npm install -g @kg-ai/kugou-skill
14
14
 
15
15
  ## 前置条件
16
16
 
17
- 使用前需要扫码登录(两步流程):
17
+ 使用前需要扫码登录(极简流程):
18
18
 
19
19
  ```bash
20
20
  # Step 1: 获取二维码图片
21
21
  kugou-cli auth login
22
22
 
23
- # Step 2: 轮询等待用户扫码确认(使用 Step 1 返回的 qrcode
24
- kugou-cli auth check -q <qrcode>
23
+ # Step 2: 循环检查登录状态(直到 logged_in=true
24
+ kugou-cli auth status
25
25
  ```
26
26
 
27
27
  > 必须将 Step 1 输出中 `qrcode_img_path` 对应的图片发送给用户扫码。token 会自动持久化存储。
@@ -34,10 +34,7 @@ kugou-cli auth check -q <qrcode>
34
34
  # 获取二维码图片
35
35
  kugou-cli auth login
36
36
 
37
- # 轮询等待扫码确认
38
- kugou-cli auth check -q <qrcode>
39
-
40
- # 查看登录状态
37
+ # 检查登录状态(未完成登录时内部自动轮询)
41
38
  kugou-cli auth status
42
39
 
43
40
  # 登出
package/SKILL.md CHANGED
@@ -32,9 +32,9 @@ description: |
32
32
 
33
33
  ### 关键注意事项
34
34
 
35
- - **登录流程分为两步**(详见 [references/auth.md](references/auth.md)):
35
+ - **登录流程极简**(详见 [references/auth.md](references/auth.md)):
36
36
  1. `auth login` - 获取二维码图片,输出包含 `qrcode` 和 `qrcode_img_path`(**必须将图片发送给用户**)
37
- 2. `auth check -q <qrcode>` - login 输出中提取 qrcode 值,传入此命令轮询等待扫码确认,必须等到 `"status":"success"` 才能继续
37
+ 2. `auth status` - 循环调用此命令检查登录状态:已登录返回 `logged_in: true`;未登录但有 pending qrcode 时内部自动检查扫码状态,扫码成功则自动完成登录
38
38
  - **音乐命令依赖登录**:除了 `auth`、`install`、`version`、`--help` 以外,所有 `music` 子命令都需要先登录。如果收到 `"not logged in"` 错误,引导用户执行登录流程。
39
39
  - **输出均为 JSON**:所有命令输出原始 JSON 到 stdout,错误输出到 stderr。解析 `errcode` 字段判断成功与否(`0` 为成功)。
40
40
  - **歌曲展示规范**(详见 [references/output-format.md](references/output-format.md)):**禁止**只返回歌曲名、歌手名,**必须**以 Markdown 链接格式展示播放链接。
@@ -65,28 +65,26 @@ description: |
65
65
  ## 完整使用流程
66
66
 
67
67
  ```bash
68
- # 1. 登录(两步流程,详见 references/auth.md)
69
- kugou-cli auth login
70
- kugou-cli auth check -q <qrcode>
71
-
72
- # 2. 查看登录状态
68
+ # 1. 登录(极简流程,详见 references/auth.md)
69
+ kugou-cli auth login # 获取二维码
70
+ # 循环执行以下命令直到 logged_in=true
73
71
  kugou-cli auth status
74
72
 
75
- # 3. 搜索歌曲
73
+ # 2. 搜索歌曲
76
74
  kugou-cli music search "周杰伦"
77
75
 
78
- # 4. 获取每日推荐
79
- kugou-cli music recommend daily --num 5
76
+ # 3. 获取猜你喜欢
77
+ kugou-cli music recommend guess
80
78
 
81
- # 5. 查看我的收藏
79
+ # 4. 查看我的收藏
82
80
  kugou-cli music favorites
83
81
 
84
- # 6. 查看最近播放
82
+ # 5. 查看最近播放
85
83
  kugou-cli music recent
86
84
 
87
- # 7. 查看听歌统计
85
+ # 6. 查看听歌统计
88
86
  kugou-cli music stats
89
87
 
90
- # 8. 查看抖音热歌榜
88
+ # 7. 查看抖音热歌榜
91
89
  kugou-cli music charts 52144
92
90
  ```
Binary file
Binary file
Binary file
Binary file
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kg-ai/kugou-skill",
3
- "version": "0.0.21",
3
+ "version": "0.0.22",
4
4
  "description": "Kugou Skill CLI",
5
5
  "main": "index.js",
6
6
  "bin": {