# 酷狗音乐
> 在酷狗曲库中搜索歌曲，试听并选用外链，供全景作品配乐或投稿使用。

## 1. 页面信息

- 网页地址：https://9kvr.cn/plugin/kgmusic
- 所属模块：插件与工具
- 页面用途：输入关键词搜索酷狗曲库中的歌曲，在结果列表中点击歌曲名称表示选用（添加）该歌曲，点击右侧耳机图标可先预览试听。选用后会把歌曲地址与名称带回来源页，或直接复制歌曲链接；一般情况下不建议把酷狗外链用于投稿或长期保存乐库。
- 适用用户：需要在酷狗曲库中搜索并选用歌曲做配乐的用户
- 访问条件：公开访问

## 2. 功能说明

- 关键词搜索酷狗歌曲列表
- 点击歌曲名称选用、点击右侧耳机图标预览试听
- 顶部提示外链时效与稳定性风险
- 带回歌曲链接与名称，或复制链接到剪贴板

## 3. 业务说明

### 稳定性

酷狗外链时效较短（约一周左右会失效），且获取不太稳定，因此不建议用于投稿或长期保存乐库；热门歌曲建议优先改用抖音获取。

### 两种操作

点击歌曲名称表示添加 / 选用该歌曲；点击右侧耳机图标可先预览试听，确认无误再选用。

### 表单字段

| 字段 | 类型 | 是否必填 | 取值来源 | 默认值 | 限制与说明 | 影响费用 |
| --- | --- | --- | --- | --- | --- | --- |
| 搜索关键词 | 文本 | 必填 | 用户输入 |  | 输入关键词后点击确定搜索 | 未核实（视实际规则） |

## 4. 使用说明

1. 输入关键词并搜索
2. 浏览搜索结果，点击耳机图标预览试听
3. 点击歌曲名称选用该歌曲
4. 选用后带回来源页，或复制歌曲链接使用

## 5. 规则与限制

- 酷狗外链时效较短（约一周失效），不建议投稿或长期保存乐库
- 搜索结果均来自酷狗曲库，若搜索不成功可多试几次
- 清空关键词后会清空搜索结果列表

## 6. 状态与异常

- 未搜索：仅展示搜索框
- 搜索中：展示「奋力搜索中…」加载提示
- 有结果：展示歌曲列表
- 选用 / 试听中：展示对应加载提示
- 搜索或获取详情连接超时时提示「可能是连接超时，请再试一次吧」
- 搜索无结果时列表为空

## 7. 相关文档

- [音乐投稿](https://9kvr.cn/site/plugin/addmedia.md)
- [抖音背景音乐](https://9kvr.cn/site/plugin/dymusic.md)
- [网易云音乐](https://9kvr.cn/site/plugin/wymusic.md)
- 上级目录索引：[/plugin](https://9kvr.cn/site/plugin/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验