@kg-ai/kugou-skill 0.0.17 → 0.0.18

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/SKILL.md CHANGED
@@ -33,9 +33,7 @@ description: |
33
33
  ### 关键注意事项
34
34
 
35
35
  - **登录是阻塞操作**:`kugou-cli auth login` 会持续轮询直到用户扫码确认。必须等到输出 `"status":"success"` 才能继续后续音乐操作。
36
- - **默认模式(file)**:只保存二维码到临时文件,**需将图片发送给用户扫码**
37
- - **`--output open` 模式**:保存二维码到临时文件并自动打开图片查看器
38
- - **TUI 模式判断**:如果 Agent 当前为命令行交互模式(TUI),应使用 `--output open` 自动打开图片;如果是文件交互或需要用户主动获取图片的场景,应使用默认模式并**主动发送图片给用户**
36
+ - 登录命令会保存二维码到临时文件,**必须将二维码图片发送给用户供扫码**
39
37
  - **音乐命令依赖登录**:除了 `auth`、`install`、`version`、`--help` 以外,所有 `music` 子命令都需要先登录。如果收到 `"not logged in"` 错误,引导用户执行 `kugou-cli auth login`。
40
38
  - **输出均为 JSON**:所有命令输出原始 JSON 到 stdout,错误输出到 stderr。解析 `errcode` 字段判断成功与否(`0` 为成功)。
41
39
  - **链接展示**:输出中的 `play_link` 字段,展示给用户时转为可点击格式:
@@ -56,8 +54,7 @@ description: |
56
54
  使用前需要扫码登录。登录采用轮询机制,需等待用户扫码确认。
57
55
 
58
56
  ```bash
59
- kugou-cli auth login # 默认,只保存二维码图片到临时文件(需发送图片给用户扫码)
60
- kugou-cli auth login --output open # 保存并打开图片查看器(适合 TUI 模式)
57
+ kugou-cli auth login # 保存二维码图片到临时文件(需发送图片给用户扫码)
61
58
  ```
62
59
 
63
60
  **登录轮询流程**(`kugou-cli auth login` 内部自动处理):
@@ -70,9 +67,7 @@ kugou-cli auth login --output open # 保存并打开图片查看器(适合
70
67
  5. 若超时/二维码过期输出 {"status": "failed", "message": "..."}
71
68
  ```
72
69
 
73
- > **TUI 模式判断**:Agent 应根据当前交互模式选择合适的输出模式:
74
- > - **TUI 模式**(命令行交互,用户可直接看到弹窗):使用 `--output open` 自动打开二维码
75
- > - **其他模式**(文件交互、需要用户主动操作):使用默认模式(file),**必须将 `qrcode_img_path` 对应的图片文件发送给用户**
70
+ > **重要**:登录命令只保存二维码到临时文件,**必须将 `qrcode_img_path` 对应的图片文件发送给用户**,否则用户无法扫码登录。
76
71
 
77
72
  ---
78
73
 
@@ -126,28 +121,15 @@ kugou-cli auth login --output open # 保存并打开图片查看器(适合
126
121
  ### 1. 扫码登录
127
122
 
128
123
  ```bash
129
- kugou-cli auth login # 默认,只保存二维码图片(需发送图片给用户扫码)
130
- kugou-cli auth login --output open # 保存并打开图片查看器(适合 TUI 模式)
124
+ kugou-cli auth login # 保存二维码图片到临时文件(需发送图片给用户扫码)
131
125
  ```
132
126
 
133
- **参数**:
134
- - `-o, --output`: 输出模式
135
- - `(默认)`: 只保存二维码图片到临时目录,**需将图片文件发送给用户扫码**
136
- - `open`: 保存二维码图片到临时目录并打开图片查看器
137
-
138
- **输出示例** (默认模式 - 保存文件):
139
- ```json
140
- {"qrcode": "xxx", "qrcode_img_path": "C:\\Users\\xxx\\AppData\\Local\\Temp\\kugou-qrcode.png", "status": "waiting"}
141
- ```
142
-
143
- **输出示例** (open 模式):
127
+ **输出示例**:
144
128
  ```json
145
129
  {"qrcode": "xxx", "qrcode_img_path": "C:\\Users\\xxx\\AppData\\Local\\Temp\\kugou-qrcode.png", "status": "waiting"}
146
130
  ```
147
131
 
148
- > **TUI 模式判断**:Agent 应根据当前交互模式选择:
149
- > - **TUI 模式**:使用 `--output open` 自动打开二维码,用户可直接扫码
150
- > - **其他模式**:使用默认模式,**必须将 `qrcode_img_path` 对应的图片文件发送给用户**
132
+ > **重要**:必须将 `qrcode_img_path` 对应的图片文件**发送给用户**供扫码登录。
151
133
 
152
134
  **轮询过程中的状态输出**:
153
135
  - `{"status": "waiting", ...}` — 等待扫码
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.17",
3
+ "version": "0.0.18",
4
4
  "description": "Kugou Skill CLI",
5
5
  "main": "index.js",
6
6
  "bin": {