@kg-ai/kugou-skill 0.0.11 → 0.0.13

package/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: kugou-skill
 description: |
-  酷狗音乐助手，提供歌曲搜索、每日推荐、相似推荐、收藏管理、听歌统计、酷狗榜单等功能。
+  酷狗，酷狗音乐，酷狗skill，酷狗音乐skill，酷狗音乐助手
+  提供歌曲搜索、每日推荐、相似推荐、收藏管理、听歌统计、酷狗榜单等功能。
   
   **触发场景**（满足任一即使用本技能）：
   - 用户要求推荐歌曲、听歌建议
@@ -238,12 +239,29 @@ kugou-cli music recommend similar --song "晴天" --text "风格相似的" -n 5
 
 ```bash
 kugou-cli music favorites
-kugou-cli music favorites --page 1 --size 20
 ```
 
-**参数**:
-- `--page`: 页码，默认 1
-- `--size`: 每页数量，默认 20
+> 注意：固定返回最近 10 首收藏，查看更多请前往酷狗App
+
+**输出示例**:
+```json
+{
+  "errcode": 0,
+  "data": {
+    "list": [
+      {
+        "song_name": "晴天",
+        "mix_song_id": "32100650",
+        "artist_name": "周杰伦",
+        "play_link": "https://www.kugou.com/mixsong/agent_gateway/j410q78a01f.html"
+      }
+    ],
+    "total": 50,
+    "msg": "当前仅显示最近的10首收藏，查看更多内容，请前往酷狗App"
+  },
+  "status": 1
+}
+```
 
 ---
 
@@ -251,12 +269,29 @@ kugou-cli music favorites --page 1 --size 20
 
 ```bash
 kugou-cli music recent
-kugou-cli music recent --page 1 --size 20
 ```
 
-**参数**:
-- `--page`: 页码，默认 1
-- `--size`: 每页数量，默认 20
+> 注意：固定返回最近 10 首播放记录，查看更多请前往酷狗App
+
+**输出示例**:
+```json
+{
+  "errcode": 0,
+  "data": {
+    "list": [
+      {
+        "song_name": "七里香",
+        "mix_song_id": "32100651",
+        "artist_name": "周杰伦",
+        "play_link": "https://www.kugou.com/mixsong/agent_gateway/j410q78a01f.html"
+      }
+    ],
+    "total": 100,
+    "msg": "当前仅显示最近的10首最近播放，查看更多内容，请前往酷狗App"
+  },
+  "status": 1
+}
+```
 
 ---
 
@@ -281,17 +316,18 @@ kugou-cli music stats --date-type 1 --date 20260501  # 指定周查询
   "data": {
     "server_time": 1779977674,
     "listen_duration": 80776,
-    "clocks": [
-      {"clock": 0, "listen_duration": 1200},
-      {"clock": 1, "listen_duration": 800}
-    ],
-    "accumulate_listen_days": 1,
-    "continue_listen_days": 1,
+    "accumulate_listen_days": 30,
+    "continue_listen_days": 7,
     "listen_total": 342,
     "last_listen_total": 387,
+    "top_clocks": [
+      "今日08:00-10:00听歌30分钟",
+      "今日14:00-16:00听歌25分钟",
+      "今日20:00-22:00听歌20分钟"
+    ],
     "rank_song": [
       {
-        "song_info": {"name": "晴天", "mix_song_id": "8888", "cover": "https://xxx.jpg", "singer_name": "周杰伦", "hash": "abcdef123456"},
+        "song_info": {"song_name": "晴天", "mix_song_id": "8888", "artist_name": "周杰伦", "play_link": "https://www.kugou.com/..."},
         "count": 50
       }
     ],
@@ -311,11 +347,11 @@ kugou-cli music stats --date-type 1 --date 20260501  # 指定周查询
 
 **关键字段**:
 - `listen_duration`: 今日/周/月听歌时长（秒）
-- `clocks`: 时段打卡统计（`clock`: 时段标识，`listen_duration`: 秒）
+- `top_clocks`: 听歌时长最长的 Top3 时段描述（日类型格式如"今日08:00-10:00听歌30分钟"，周/月类型格式如"近7天平均08:00-10:00听歌119分钟"）
 - `accumulate_listen_days`: 累计听歌天数
 - `continue_listen_days`: 连续听歌天数
 - `listen_total`: 累计听歌次数
-- `last_listen_total`: 昨日听歌次数
+- `last_listen_total`: 昨日/上周/上月听歌次数
 - `rank_song`: 播放最多的歌曲排行（`count` 为播放次数）
 - `rank_singer`: 播放最多的歌手排行
 - `rank_style`: 曲风分布统计
@@ -453,10 +489,10 @@ kugou-cli music search "周杰伦"
 kugou-cli music recommend daily --num 5
 
 # 5. 查看我的收藏
-kugou-cli music favorites --page 1
+kugou-cli music favorites
 
 # 6. 查看最近播放
-kugou-cli music recent --size 10
+kugou-cli music recent
 
 # 7. 查看听歌统计
 kugou-cli music stats

package/package.json

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