Agent Skills
返回列表
💻

PeerTube 视频发布管理 API

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/peertube-video-publishing-moderation-api。

技能介绍

这个技能解决什么问题

自建 PeerTube 实例之后,平台并不会自己运转起来。一个实例通常会同时积累三类需求:创作者需要批量上传视频并维护频道元数据;管理员需要处理联邦网络里从其它实例同步过来的视频与评论;运维人员需要掌握实例的运行状态。这些操作都能通过 PeerTube 的 REST API 完成,但每次手写请求很容易出错——上传本身就是多步流程(创建视频条目、获取上传凭证、轮询处理状态),审核与频道管理也分散在多个端点上。

这个技能把这些操作收敛成一套连贯的调用方案,让你用声明式的请求驱动从上传到审核的完整链路。

核心能力与工作方式

技能建立在 PeerTube REST API 之上,并利用 PeerTube 的联邦感知(federation-aware)特性。核心能力包括:

  • 视频上传:遵循标准的多步上传流程——创建视频条目、拿到上传凭证、轮询后台转码状态,而不是简单 POST 一个文件
  • 频道管理:维护频道信息、内容列表与账号配置
  • 审核队列:读取待处理内容、执行通过或拒绝,处理跨实例同步过来的远程视频
  • 实例运维:查询节点状态、运行指标与联邦信息

典型步骤是:准备好实例地址与访问令牌 → 调用对应资源端点 → 轮询任务状态直到完成 → 校验结果。前置依赖为 Node.js、PostgreSQL 与 PeerTube REST API(PeerTube 的元数据与任务队列由 PostgreSQL 支撑)。

适用边界与注意事项

两点需要留意。

第一,技能的自动化能力来自 PeerTube 的原生 API,而非网页界面自动化,因此部署在 Node.js + PostgreSQL 上的自建实例才能完整覆盖联邦相关操作。

第二,SKILL.md 明确指出,安装与使用说明未能自动从源码中提取,技能仓库为个人项目(1991513ccie-png/skills)。在敏感流程中运行之前,建议先通读上游源码,核对每一步调用是否符合预期。API 细节以官方文档为准:https://docs.joinpeertube.org/api-rest-reference.html。

使用场景

  • 在自建 PeerTube 实例上批量发布课程视频时,自动走完创建条目、获取上传凭证、轮询转码完成的完整流程
  • 运营社区视频实例时,从审核队列里逐条批准或拒绝其他实例经联邦同步过来的远程视频
  • 需要统一维护多名创作者的频道分类与简介信息时,通过 API 批量更新频道元数据
  • 排查实例故障时,拉取节点运行指标与联邦状态数据来定位同步异常或转码卡死的问题

适合人员

  • 自建 PeerTube 实例的独立创作者,想把新录的课程视频批量发布并自动等待转码完成
  • 运营开源视频社区的管理员,需要处理每天从其他实例经联邦同步过来的待审核内容
  • 维护 PeerTube 服务的后端开发者,想用脚本化调用替代手写 REST 请求来巡检实例状态
  • 管理多创作者频道的视频平台运营,需要批量维护频道元数据与分类信息