@kg-ai/kugou-skill 0.0.6 → 0.0.8

package/README.md

@@ -27,15 +27,15 @@ kugou-cli auth login
 ### 认证
 
 ```bash
-# 扫码登录（默认保存二维码图片到临时目录）
+# 扫码登录（默认保存并打开二维码图片）
 kugou-cli auth login
 
+# 只保存二维码图片，不打开
+kugou-cli auth login --output file
+
 # 输出 base64 编码的二维码图片
 kugou-cli auth login --output base64
 
-# 打开系统图片查看器扫码
-kugou-cli auth login --output terminal
-
 # 查看登录状态
 kugou-cli auth status
 

package/SKILL.md

@@ -22,7 +22,7 @@ description: |
 
 ### 关键注意事项
 
-- **登录是阻塞操作**：`kugou-cli auth login` 会持续轮询直到用户扫码确认。必须等到输出 `"status":"success"` 才能继续后续音乐操作。TUI Agent（如 OpenCode）推荐使用 `--output terminal` 模式，自动弹出系统图片查看器。`base64` 模式适合 Web 前端场景。
+- **登录是阻塞操作**：`kugou-cli auth login` 会持续轮询直到用户扫码确认。必须等到输出 `"status":"success"` 才能继续后续音乐操作。默认模式会自动打开系统图片查看器供扫码。`file` 模式只保存文件不打开。`base64` 模式适合 Web 前端场景。
 - **音乐命令依赖登录**：除了 `auth`、`install`、`version`、`--help` 以外，所有 `music` 子命令都需要先登录。如果收到 `"not logged in"` 错误，引导用户执行 `kugou-cli auth login`。
 - **输出均为 JSON**：所有命令输出原始 JSON 到 stdout，错误输出到 stderr。解析 `errcode` 字段判断成功与否（`0` 为成功）。
 - **链接展示**：输出中的 `play_link` 字段，展示给用户时转为可点击格式：
@@ -43,10 +43,9 @@ description: |
 使用前需要扫码登录。登录采用轮询机制，需等待用户扫码确认。
 
 ```bash
-kugou-cli auth login
-kugou-cli auth login --output image    # 默认，保存二维码图片到临时目录
+kugou-cli auth login                    # 默认，保存二维码图片并打开图片查看器
+kugou-cli auth login --output file    # 只保存二维码图片，不打开
 kugou-cli auth login --output base64  # 输出 base64 图片数据（含 data:image/png;base64, 前缀）
-kugou-cli auth login --output terminal # 自动打开系统图片查看器扫码（推荐 TUI Agent 使用）
 ```
 
 **登录轮询流程**（`kugou-cli auth login` 内部自动处理）：
@@ -59,7 +58,7 @@ kugou-cli auth login --output terminal # 自动打开系统图片查看器扫码
 5. 若超时/二维码过期输出 {"status": "failed", "message": "..."}
 ```
 
-> **输出模式选择建议**：`terminal` 模式会自动调用系统图片查看器弹出二维码，用户直接扫码即可，适合 OpenCode 等 TUI Agent 使用。`image` 模式保存到临时文件，需手动打开。`base64` 模式适合需要内嵌二维码图片展示的场景。
+> **输出模式选择建议**：默认模式会自动打开图片查看器弹出二维码，用户直接扫码即可，适合桌面端 Agent 使用。`file` 模式只保存到临时文件，需手动打开。`base64` 模式适合需要内嵌二维码图片展示的场景。
 
 ---
 
@@ -114,18 +113,22 @@ kugou-cli auth login --output terminal # 自动打开系统图片查看器扫码
 
 ```bash
 kugou-cli auth login
-kugou-cli auth login --output image    # 默认，保存二维码图片到临时目录
+kugou-cli auth login --output file    # 只保存二维码图片，不打开
 kugou-cli auth login --output base64  # 输出 base64 编码的图片数据（含 data:image/png;base64, 前缀）
-kugou-cli auth login --output terminal # 自动打开系统图片查看器，适合 OpenCode 等 TUI Agent
 ```
 
 **参数**:
 - `-o, --output`: 输出模式
-  - `image` (默认): 保存二维码图片到临时目录，输出图片路径
+  - (默认): 保存二维码图片到临时目录并打开图片查看器，供扫码
+  - `file`: 只保存二维码图片到临时目录，不打开
   - `base64`: 输出 base64 编码的图片数据（含 `data:image/png;base64,` 前缀）
-  - `terminal`: 自动打开系统图片查看器显示二维码，适合 OpenCode 等 TUI Agent 使用。用户无需手动打开文件，系统会自动弹出二维码窗口供扫码。
 
-**输出示例** (image 模式):
+**输出示例** (默认模式 - 保存并打开):
+```json
+{"qrcode": "xxx", "qrcode_img_path": "C:\\Users\\xxx\\AppData\\Local\\Temp\\kugou-qrcode.png", "status": "waiting"}
+```
+
+**输出示例** (file 模式):
 ```json
 {"qrcode": "xxx", "qrcode_img_path": "/tmp/kugou-qrcode.png", "status": "waiting"}
 ```
@@ -137,11 +140,6 @@ kugou-cli auth login --output terminal # 自动打开系统图片查看器，适
 
 > **base64 二维码展示指导**：`qrcode_base64` 已包含 `data:image/png;base64,` 前缀，可直接作为 `<img>` 标签的 `src` 属性，或通过 Markdown `![QR](data:image/png;base64,...)` 展示。
 
-**输出示例** (terminal 模式):
-```json
-{"qrcode": "xxx", "qrcode_img_path": "C:\\Users\\xxx\\AppData\\Local\\Temp\\kugou-qrcode.png", "status": "waiting"}
-```
-
 **轮询过程中的状态输出**:
 - `{"status": "waiting", ...}` — 等待扫码
 - `{"status": "scanned", "nickname": "...", ...}` — 已扫码，等待用户在手机上确认
@@ -257,8 +255,18 @@ kugou-cli music recent --page 1 --size 20
 
 ```bash
 kugou-cli music stats
+kugou-cli music stats --date-type 1 --date 20260501
 ```
 
+**AI 引导**：如果用户不指定查询范围，默认按月查询（`--date-type 2`），日期设为当月第一天。例如当前日期是 2025-06-15，默认查询 2025年6月1日 的数据。
+
+**参数**:
+- `--date-type`: 日期类型，0=日、1=周、2=月，默认 0
+- `--date`: 查询日期，YYYYMMDD 格式，如 "20260501"
+  - 日类型：每天日期，如 "20260501"
+  - 周类型：必须是周一日期，如 "20260505"（周一）
+  - 月类型：必须是月份第一天，如 "20260501"（5月1日）
+
 **输出示例**:
 ```json
 {
@@ -276,18 +284,18 @@ kugou-cli music stats
     "last_listen_total": 387,
     "rank_song": [
       {
-        "song_info": {"song_name": "晴天", "mix_song_id": "xxx", "artist_name": "周杰伦", "play_link": "https://..."},
+        "song_info": {"name": "晴天", "mix_song_id": "8888", "cover": "https://xxx.jpg", "singer_name": "周杰伦", "hash": "abcdef123456"},
         "count": 50
       }
     ],
     "rank_singer": [
-      {"singer_id": 123, "name": "周杰伦", "avatar": "https://...", "total": 120}
+      {"singer_id": 123, "name": "周杰伦", "avatar": "https://xxx.jpg", "total": 120}
     ],
     "rank_style": [
       {"style": "流行", "total": 200, "count": 80}
     ],
     "rank_language": [
-      {"language": "国语", "total": 180, "count": 70}
+      {"language": "华语", "total": 400, "count": 150}
     ]
   },
   "status": 1
@@ -295,9 +303,12 @@ kugou-cli music stats
 ```
 
 **关键字段**:
-- `listen_duration`: 累计听歌时长（秒）
-- `listen_total`: 累计听歌数量
-- `clocks`: 每个小时的听歌时长分布（`clock`: 0-23，`listen_duration`: 秒）
+- `listen_duration`: 今日/周/月听歌时长（秒）
+- `clocks`: 时段打卡统计（`clock`: 时段标识，`listen_duration`: 秒）
+- `accumulate_listen_days`: 累计听歌天数
+- `continue_listen_days`: 连续听歌天数
+- `listen_total`: 累计听歌次数
+- `last_listen_total`: 昨日听歌次数
 - `rank_song`: 播放最多的歌曲排行（`count` 为播放次数）
 - `rank_singer`: 播放最多的歌手排行
 - `rank_style`: 曲风分布统计

package/package.json

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