MediaGo 视频下载器

通过正在运行的 MediaGo 实例，下载来自 m3u8/HLS 流、Bilibili 以及直接 URL 的视频。

配置

配置文件：~/.mediago-skill.json

{
  "url": "http://localhost:8899",
  "apiKey": ""
}

首次配置

如果 ~/.mediago-skill.json 文件不存在，则显示以下提示信息（响应语言需与用户当前语言一致）：

EN: "MediaGo 尚未配置。要使用此功能：

1. 安装 MediaGo（如尚未安装）：

• 桌面客户端：从 https://github.com/caorushizi/mediago/releases 下载安装
• Docker 部署：docker run -d --name mediago -p 8899:8899 -v /path/to/mediago:/app/mediago ghcr.io/caorushizi/mediago:latest

2. 初始化配置 — 告诉我你的 MediaGo 地址，例如：

• Docker：设置 mediago 地址为 http://localhost:8899
• 桌面客户端：设置 mediago 地址为 http://192.168.x.x:39719"

CN: "MediaGo 还没有配置。要使用此功能：

1. 安装 MediaGo（如果还没装）：

• 桌面客户端：从 https://github.com/caorushizi/mediago/releases 下载安装
• Docker 部署：docker run -d --name mediago -p 8899:8899 -v /path/to/mediago:/app/mediago ghcr.io/caorushizi/mediago:latest

2. 初始化配置 — 告诉我你的 MediaGo 地址，例如：

• Docker：设置 mediago 地址为 http://localhost:8899
• 桌面客户端：设置 mediago 地址为 http://192.168.x.x:39719"

当用户提供 URL（及可选的 API 密钥）后，将其写入 ~/.mediago-skill.json 文件。

更新配置

在识别到以下任一表述时触发配置更新流程：

• EN: "set mediago url to ...", "mediago api key is ...", "my mediago is at ..."
• CN: "设置 mediago 地址为 ...", "mediago api key 是 ...", "我的 mediago 跑在 ..."

读取现有配置，更新对应字段，并将修改后的内容写回文件。

API 参考

所有 API 调用均使用 curl。每次调用前，需从 ~/.mediago-skill.json 中读取 url 和 apiKey 字段。

若已设置 apiKey，则需添加请求头：-H "X-API-Key: API_KEY"

健康检查

curl -s BASE_URL/healthy

服务正常运行时返回 {"success":true,...}。

创建并启动下载任务

curl -s -X POST BASE_URL/api/downloads 
  -H "Content-Type: application/json" 
  -d '{"tasks":[{"type":"TYPE","url":"VIDEO_URL","name":"NAME"}],"startDownload":true}'

• type（必需）：取值为 m3u8、bilibili 或 direct
• url（必需）：视频 URL
• name（可选）：自定义文件名

基于 URL 自动识别类型：

• URL 包含 bilibili.com 或 b23.tv → 类型为 bilibili
• URL 包含 .m3u8 → 类型为 m3u8
• 其他情况 → 类型为 direct

响应体中 data 字段为已创建任务数组，从中提取 data[0].id 即为任务 ID。

获取任务状态

curl -s BASE_URL/api/downloads/TASK_ID

响应体中 data 字段包含：id、name、status、type、exists、file。

可能的 status 值：pending、downloading、success、failed、stopped。

列出下载任务

curl -s "BASE_URL/api/downloads?current=1&pageSize=20"

响应体包含：data.total（总数量）和 data.list（任务数组）。

获取配置（下载目录等）

curl -s BASE_URL/api/config

返回完整配置，其中 local 字段表示本地下载目录路径。

下载流程

1. 检查配置：读取 ~/.mediago-skill.json。若文件缺失，则执行上述“首次配置”流程。
2. 健康检查：验证 MediaGo 服务是否可达。若不可达，提示用户 MediaGo 可能未运行，并引导其启动服务。
3. 创建任务：向 /api/downloads 发起 POST 请求，且请求体中指定 startDownload: true。
4. 轮询进度：每 3 秒发起一次 GET 请求，访问 /api/downloads/TASK_ID，并将当前状态实时反馈给用户。
5. 报告结果：
   • success → EN: "Download complete! File: [path]" / CN: "下载完成！文件：[path]"
   • failed → EN: "Download failed." / CN: "下载失败。"
   • 若轮询持续超过 5 分钟，提示用户下载仍在进行中。

注意事项

• 语言：始终使用用户当前所用语言（中文或英文）进行响应。
• 若 API 返回 HTTP 401 错误，提示用户 API 密钥可能不正确，并请其更新配置。
• 除非用户明确指定下载类型，否则始终根据 URL 自动识别类型。
• 若未提供 name，则不在请求中包含该字段 —— 服务端将自动生成文件名。