@kg-ai/kugou-skill 0.0.16 → 0.0.17

package/SKILL.md

@@ -33,8 +33,9 @@ description: |
 ### 关键注意事项
 
 - **登录是阻塞操作**：`kugou-cli auth login` 会持续轮询直到用户扫码确认。必须等到输出 `"status":"success"` 才能继续后续音乐操作。
-  - **默认模式**：自动打开系统图片查看器弹出二维码
-  - **`--output file` 模式**：保存二维码到临时文件，**必须将图片发送给用户供扫码**
+  - **默认模式（file）**：只保存二维码到临时文件，**需将图片发送给用户扫码**
+  - **`--output open` 模式**：保存二维码到临时文件并自动打开图片查看器
+  - **TUI 模式判断**：如果 Agent 当前为命令行交互模式（TUI），应使用 `--output open` 自动打开图片；如果是文件交互或需要用户主动获取图片的场景，应使用默认模式并**主动发送图片给用户**
 - **音乐命令依赖登录**：除了 `auth`、`install`、`version`、`--help` 以外，所有 `music` 子命令都需要先登录。如果收到 `"not logged in"` 错误，引导用户执行 `kugou-cli auth login`。
 - **输出均为 JSON**：所有命令输出原始 JSON 到 stdout，错误输出到 stderr。解析 `errcode` 字段判断成功与否（`0` 为成功）。
 - **链接展示**：输出中的 `play_link` 字段，展示给用户时转为可点击格式：
@@ -55,8 +56,8 @@ description: |
 使用前需要扫码登录。登录采用轮询机制，需等待用户扫码确认。
 
 ```bash
-kugou-cli auth login                    # 默认，保存二维码图片并打开图片查看器
-kugou-cli auth login --output file    # 只保存二维码图片，不打开（需将图片发送给用户扫码）
+kugou-cli auth login                    # 默认，只保存二维码图片到临时文件（需发送图片给用户扫码）
+kugou-cli auth login --output open    # 保存并打开图片查看器（适合 TUI 模式）
 ```
 
 **登录轮询流程**（`kugou-cli auth login` 内部自动处理）：
@@ -69,7 +70,9 @@ kugou-cli auth login --output file    # 只保存二维码图片，不打开（
 5. 若超时/二维码过期输出 {"status": "failed", "message": "..."}
 ```
 
-> **输出模式选择建议**：默认模式会自动打开图片查看器弹出二维码，用户直接扫码即可。`file` 模式保存到临时文件，需将图片路径对应的二维码图片**发送给用户**供扫码。
+> **TUI 模式判断**：Agent 应根据当前交互模式选择合适的输出模式：
+> - **TUI 模式**（命令行交互，用户可直接看到弹窗）：使用 `--output open` 自动打开二维码
+> - **其他模式**（文件交互、需要用户主动操作）：使用默认模式（file），**必须将 `qrcode_img_path` 对应的图片文件发送给用户**
 
 ---
 
@@ -123,25 +126,28 @@ kugou-cli auth login --output file    # 只保存二维码图片，不打开（
 ### 1. 扫码登录
 
 ```bash
-kugou-cli auth login
-kugou-cli auth login --output file    # 只保存二维码图片，需将图片发送给用户扫码
+kugou-cli auth login                      # 默认，只保存二维码图片（需发送图片给用户扫码）
+kugou-cli auth login --output open       # 保存并打开图片查看器（适合 TUI 模式）
 ```
 
 **参数**:
 - `-o, --output`: 输出模式
-  - (默认): 保存二维码图片到临时目录并打开图片查看器，供扫码
-  - `file`: 只保存二维码图片到临时目录，不打开，**需将图片文件发送给用户**
+  - `(默认)`: 只保存二维码图片到临时目录，**需将图片文件发送给用户扫码**
+  - `open`: 保存二维码图片到临时目录并打开图片查看器
 
-**输出示例** (默认模式 - 保存并打开):
+**输出示例** (默认模式 - 保存文件):
 ```json
 {"qrcode": "xxx", "qrcode_img_path": "C:\\Users\\xxx\\AppData\\Local\\Temp\\kugou-qrcode.png", "status": "waiting"}
 ```
 
-**输出示例** (file 模式):
+**输出示例** (open 模式):
 ```json
-{"qrcode": "xxx", "qrcode_img_path": "/tmp/kugou-qrcode.png", "status": "waiting"}
+{"qrcode": "xxx", "qrcode_img_path": "C:\\Users\\xxx\\AppData\\Local\\Temp\\kugou-qrcode.png", "status": "waiting"}
 ```
-> **重要**：file 模式下必须将 `qrcode_img_path` 对应的图片文件**发送给用户**，否则用户无法扫码登录。
+
+> **TUI 模式判断**：Agent 应根据当前交互模式选择：
+> - **TUI 模式**：使用 `--output open` 自动打开二维码，用户可直接扫码
+> - **其他模式**：使用默认模式，**必须将 `qrcode_img_path` 对应的图片文件发送给用户**
 
 **轮询过程中的状态输出**:
 - `{"status": "waiting", ...}` — 等待扫码

package/package.json

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