AI Skill 使用指南
如果您希望直接对 AI 说“帮我下载这个视频”，而不是每次都手动打开 MediaGo 填表，那么可以使用 MediaGo 的 AI Skill。
这类 Skill 的作用不是替代 MediaGo，而是让支持自定义技能的 AI 客户端，能够直接调用已经安装好的 MediaGo 桌面版，或者您已经部署好的 MediaGo Server / NAS。
下载 MediaGo Skill
Section titled “下载 MediaGo Skill”如果您只是想先把 Skill 文件拿下来，可以直接点击下面这个链接：
点击后会直接下载成标准文件名 SKILL.md，后续您可以把它导入到支持自定义 Skill 的 AI 客户端里。
- 已经在使用支持自定义 Skill / Agent Skill 的 AI 客户端
- 想直接让 AI 帮自己创建下载任务、查看进度、管理任务
- 希望把 MediaGo 接到自己的自动化流程中
如果您只是想自己写脚本调用接口，而不是让 AI 来调用，请直接查看 接口调用。
在导入 Skill 之前，请先确认以下条件至少满足其中一项：
方式一：本机桌面版
Section titled “方式一：本机桌面版”- 您已经安装了 MediaGo 桌面版
- MediaGo 可以在这台机器上正常启动
- 您希望 AI 直接调用这台机器上的 MediaGo
这是最适合个人电脑用户的方式。
通常不需要额外配置 API Key，Skill 会优先尝试连接本机的 MediaGo。
方式二：Server / NAS
Section titled “方式二：Server / NAS”- 您已经部署好了 MediaGo Server / NAS
- 您知道服务地址
- 您已经设置好 API Key
这是更适合远端下载、NAS 统一管理、多人共用服务的方式。
如果您还没有完成远端配置，可以先查看：
MediaGo Skill 能做什么
Section titled “MediaGo Skill 能做什么”导入 Skill 后，AI 通常可以帮您完成这些操作：
- 根据自然语言创建下载任务
- 批量提交多个下载链接
- 查询任务列表和当前状态
- 暂停、继续或删除任务
- 在失败时读取日志并做基本说明
常见的表达方式包括：
下载这个视频：https://example.com/video.m3u8把这三个链接都加到 MediaGo 里并立即开始下载先加入任务，不要开始下载看一下刚才那个任务现在下载到多少了支持的连接模式
Section titled “支持的连接模式”本机模式适合您在自己的电脑上直接使用 MediaGo 桌面版。
它的特点是：
- 默认优先尝试本机 MediaGo
- 不依赖局域网 IP
- 一般不需要额外填写 API Key
- 只要桌面版处于运行状态，AI 就可以发起下载任务
如果 AI 提示连接不上本机 MediaGo，通常只需要先打开桌面版应用，再让它重试一次。
Server / NAS 模式
Section titled “Server / NAS 模式”Server / NAS 模式适合这些场景：
- 下载任务希望交给远端 NAS 执行
- 想在多台机器之间共用同一套下载服务
- 希望把 AI 和 MediaGo Server 结合成长期自动化流程
这一模式下，通常需要告诉 AI 两个信息：
- MediaGo Server 地址
- API Key
例如：
设置 mediago server 为 http://你的服务器地址:9900设置 mediago api key 为 你的密钥如果之后要切回本机桌面版模式，也可以直接告诉 AI：
切换 mediago 到本机模式一般导入流程
Section titled “一般导入流程”不同 AI 客户端的导入方式并不完全相同，但整体流程通常都差不多：
- 先拿到 MediaGo Skill 包或 Skill 文件夹
- 在 AI 客户端中导入 Skill，或把 Skill 放到客户端约定的
skills目录 - 回到聊天窗口，直接用自然语言让 AI 帮您下载
如果您还没有下载，可以直接使用上面的下载入口。
常见导入方式一般有三类：
- 直接导入一个
.zip或技能包文件 - 在设置里添加一个本地 Skill 目录
- 把 Skill 文件夹复制到客户端指定的
skills目录
由于每个 AI 客户端的界面和命名都不同，建议您优先看自己所用客户端的“自定义技能 / Skills / Agent Skills”说明。
导入后建议先做一次最小验证
Section titled “导入后建议先做一次最小验证”不要一上来就批量提交十几个链接，建议先做一次单任务测试。
您可以让 AI 执行一条最简单的命令：
下载这个视频：https://example.com/video.m3u8如果一切正常，AI 一般会：
- 连接 MediaGo
- 创建下载任务
- 返回任务已提交的结果
- 在需要时继续汇报下载进度
等单任务验证通过后，再去使用批量下载、远端 Server、自动化流程会更稳。
什么时候更适合用 AI Skill
Section titled “什么时候更适合用 AI Skill”以下场景最适合用 Skill：
- 您已经习惯通过 AI 做日常操作
- 链接来源比较分散，希望复制后直接一句话交给 AI
- 希望让 AI 顺手帮您整理名称、目录或任务状态
- 希望后续把下载流程接进自己的自动化系统
如果您只是偶尔下载一个链接，其实直接打开 MediaGo 手动新建任务也很高效。
Skill 更大的价值在于“减少重复操作”和“把下载流程变成一句话命令”。
为什么 AI 提示连接不上 MediaGo？
Section titled “为什么 AI 提示连接不上 MediaGo？”请先区分您当前在用哪一种模式：
- 如果是本机模式：确认 MediaGo 桌面版已经启动
- 如果是 Server / NAS 模式：确认服务地址可访问、端口正确、服务已经启动
为什么 AI 提示 API Key 错误？
Section titled “为什么 AI 提示 API Key 错误？”这通常只会出现在 Server / NAS 模式下。
请检查：
- 当前填写的是不是正确的服务地址
- API Key 是否填写错误
- 您是不是把本机模式和 server 模式弄混了
如果不想继续使用远端服务，可以直接切回：
切换 mediago 到本机模式为什么 AI 没有立即开始下载？
Section titled “为什么 AI 没有立即开始下载？”有些 Skill 会支持“先创建任务，不立即开始”的用法。
如果您说了类似“先加任务不要开始”，AI 会把任务加入 MediaGo，但不会立刻启动下载。
Skill 和接口调用有什么区别？
Section titled “Skill 和接口调用有什么区别？”- AI Skill：适合直接对 AI 发自然语言命令
- 接口调用：适合脚本、自动化平台、程序直接调 HTTP API
如果您更偏向工程化集成，请查看 接口调用。
- 想继续了解脚本接入：查看 接口调用
- 想把任务交给 NAS：查看 NAS / Docker 设置
- 想先学会普通下载流程：查看 快速开始