@kg-ai/kugou-skill 0.0.7 → 0.0.9

package/SKILL.md

@@ -1,8 +1,17 @@
 ---
 name: kugou-skill
 description: |
-  kugou-skill 是酷狗音乐 API CLI 工具，用于搜索、推荐、收藏、统计、榜单等功能。
-  触发场景：用户要求搜索歌曲、获取推荐、管理收藏、查看听歌统计、查看榜单等酷狗音乐相关操作。
+  酷狗音乐助手，提供歌曲搜索、每日推荐、相似推荐、收藏管理、听歌统计、酷狗榜单等功能。
+  
+  **触发场景**（满足任一即使用本技能）：
+  - 用户要求推荐歌曲、听歌建议
+  - 用户要求搜索歌曲、查找歌手作品
+  - 用户要求查看音乐榜单（飙升榜、TOP500、抖音热歌等）
+  - 用户要求查看收藏、最近播放、听歌统计
+  - 用户提到"酷狗"、"kugou"、"每日推荐"、"相似歌曲"
+  
+  **与其他音乐技能的区别**：酷狗音乐以推荐算法见长，榜单数据实时更新，适合获取热门歌曲和个性化推荐。
+  
   安装方式：npm install -g @kg-ai/kugou-skill
 ---
 
@@ -144,7 +153,7 @@ kugou-cli auth login --output base64  # 输出 base64 编码的图片数据（
 - `{"status": "waiting", ...}` — 等待扫码
 - `{"status": "scanned", "nickname": "...", ...}` — 已扫码，等待用户在手机上确认
 - `{"status": "success", "nickname": "...", "secret": "..."}` — 登录成功，token 已持久化
-- `{"status": "failed", "message": "QR code expired or login failed"}` — 登录失败（二维码过期），需重新执行
+- `{"status": "failed", "message": "QR code expired or login failed"}` — 登录失败（二维码过期），需重新执行
 
 ---
 
@@ -255,8 +264,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
 {
@@ -274,18 +293,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
@@ -293,9 +312,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.7",
+  "version": "0.0.9",
   "description": "Kugou Skill CLI",
   "main": "index.js",
   "bin": {