@zhin.js/plugin-music 1.0.16 → 1.0.17
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/package.json +5 -5
- package/skills/music/SKILL.md +27 -10
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zhin.js/plugin-music",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.17",
|
|
4
4
|
"description": "Music search and sharing plugin for Zhin.js",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./lib/index.js",
|
|
@@ -41,12 +41,12 @@
|
|
|
41
41
|
"dependencies": {},
|
|
42
42
|
"devDependencies": {
|
|
43
43
|
"typescript": "^6.0.3",
|
|
44
|
-
"zhin.js": "1.0.
|
|
45
|
-
"@zhin.js/adapter-icqq": "2.0.
|
|
44
|
+
"zhin.js": "1.0.73",
|
|
45
|
+
"@zhin.js/adapter-icqq": "2.0.17"
|
|
46
46
|
},
|
|
47
47
|
"peerDependencies": {
|
|
48
|
-
"@zhin.js/adapter-icqq": "2.0.
|
|
49
|
-
"zhin.js": "1.0.
|
|
48
|
+
"@zhin.js/adapter-icqq": "2.0.17",
|
|
49
|
+
"zhin.js": "1.0.73"
|
|
50
50
|
},
|
|
51
51
|
"peerDependenciesMeta": {
|
|
52
52
|
"@zhin.js/adapter-icqq": {
|
package/skills/music/SKILL.md
CHANGED
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: music
|
|
3
|
-
description:
|
|
3
|
+
description: >-
|
|
4
|
+
音乐搜索与分享能力。当用户想搜索歌曲、点歌、分享音乐、
|
|
5
|
+
听某首歌或查找歌手的歌时使用。支持 QQ 音乐和网易云音乐两个平台。
|
|
6
|
+
即使用户只是说「来首歌」「点个歌」或提到某首歌的名字,也应触发。
|
|
4
7
|
keywords:
|
|
5
8
|
- music
|
|
6
9
|
- 音乐
|
|
@@ -10,6 +13,7 @@ keywords:
|
|
|
10
13
|
- QQ音乐
|
|
11
14
|
- 网易云
|
|
12
15
|
- 点歌
|
|
16
|
+
- 听歌
|
|
13
17
|
tags:
|
|
14
18
|
- music
|
|
15
19
|
- entertainment
|
|
@@ -19,15 +23,28 @@ tools:
|
|
|
19
23
|
- music_share
|
|
20
24
|
---
|
|
21
25
|
|
|
22
|
-
|
|
26
|
+
# 音乐搜索分享技能
|
|
23
27
|
|
|
24
|
-
|
|
25
|
-
|------|------|
|
|
26
|
-
| `music_search` | 搜索歌曲(关键词、来源、数量) |
|
|
27
|
-
| `music_share` | 分享指定歌曲(歌曲 ID + 来源) |
|
|
28
|
+
搜索歌曲并以富文本卡片分享到聊天中。
|
|
28
29
|
|
|
29
|
-
##
|
|
30
|
+
## 工作流
|
|
30
31
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
32
|
+
典型的点歌流程是两步走:先搜后分享。
|
|
33
|
+
|
|
34
|
+
**Example:**
|
|
35
|
+
```
|
|
36
|
+
用户: 点一首周杰伦的晴天
|
|
37
|
+
步骤1: music_search(keyword="周杰伦 晴天", source="qq") → 获取歌曲列表
|
|
38
|
+
步骤2: music_share(id=搜索结果中的歌曲ID, source="qq") → 发送卡片
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
| 工具 | 用途 | 关键参数 |
|
|
42
|
+
|------|------|----------|
|
|
43
|
+
| `music_search` | 搜索歌曲 | `keyword`(关键词), `source`(qq/163), `count`(数量) |
|
|
44
|
+
| `music_share` | 分享歌曲 | `id`(歌曲 ID,来自搜索结果), `source`(qq/163) |
|
|
45
|
+
|
|
46
|
+
## 易错点
|
|
47
|
+
|
|
48
|
+
1. **search 和 share 的 source 必须一致**。QQ 音乐搜到的 ID 不能用网易云分享。
|
|
49
|
+
2. **分享需要 ID**,不能直接用歌名。必须先搜索获取 ID。
|
|
50
|
+
3. 用户没说平台时,默认用 QQ 音乐(`source="qq"`)。
|