Skip to content
Back to search

libtv-skills

> AI Agent Skills for LibLib.tv — 让你的 AI Agent 轻松调用 LibTV 的生图、生视频等 AIGC 能力。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/libtv-labs-libtv-skills/badge.svg)](/listings/libtv-labs-libtv-skills)

HTML

<a href="/listings/libtv-labs-libtv-skills"><img src="/api/listings/libtv-labs-libtv-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 330 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🎬 libtv-skills
  2. > AI Agent Skills for [LibLib.tv](https://www.liblib.tv) — 让你的 AI Agent 轻松调用 LibTV 的生图、生视频等 AIGC 能力。
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  4. [![Python 3.6+](https://img.shields.io/badge/Python-3.6+-green.svg)](https://python.org)
  5. ## ✨ 简介
  6. **libtv-skills** 是一组面向 AI Agent 的技能包(Skills),通过 [LibLib.tv](https://www.liblib.tv) 的 OpenAPI 提供 **AI 生图**、**AI 生视频** 等 AIGC 能力。Agent 可以通过这些技能创建会话、发送创作指令、查询生成进展,并获取最终的图片/视频结果。
  7. 本项目遵循 [OpenClaw](https://github.com/anthropics/openclaw) 技能规范,可被支持该规范的 AI Agent 平台直接识别和调用。
  8. ## 📦 技能列表
  9. | 技能 | 描述 | 脚本 |
  10. |------|------|------|
  11. | **libtv-skill** | Agent-IM 会话技能 — 创建会话、发送生图/生视频消息、上传文件、查询进展、批量下载结果 | `create_session.py` `query_session.py` `change_project.py` `upload_file.py` `download_results.py` |
  12. ## 📥 快速安装
  13. 通过 `npx skills` 一键安装技能到你的项目中:
  14. ```bash
  15. # 交互式选择要安装的技能
  16. npx skills add libtv-labs/libtv-skills
  17. # 直接安装指定技能
  18. npx skills add libtv-labs/libtv-skills --skill libtv-skill
  19. ```
  20. 安装完成后,设置环境变量即可使用:
  21. ```bash
  22. export LIBTV_ACCESS_KEY="your-access-key"
  23. ```
  24. > 🎉 **就这么简单!** 技能文件会被添加到你的项目中,AI Agent 将自动识别并调用,无需手动执行任何脚本。
  25. 可选配置(一般无需修改):
  26. | 变量 | 必填 | 默认值 | 说明 |
  27. |------|------|--------|------|
  28. | `LIBTV_ACCESS_KEY` | ✅ | — | LibTV API 鉴权密钥 |
  29. | `OPENAPI_IM_BASE` | ❌ | `https://im.liblib.tv` | IM 服务地址 |
  30. | `IM_BASE_URL` | ❌ | `https://im.liblib.tv` | IM 服务地址(备选) |
  31. ## 🛠️ 手动使用 / 调试
  32. <details>
  33. <summary>如果你需要手动调用脚本或调试,点击展开查看详细用法</summary>
  34. ### 前置要求
  35. - **Python 3.6+**(仅使用标准库,无需安装额外依赖)
  36. - **`LIBTV_ACCESS_KEY`** 环境变量已设置
  37. ### 创建会话 & 发送生成指令
  38. ```bash
  39. # 创建新会话,发送「生一个动漫视频」
  40. python3 skills/libtv-skill/scripts/create_session.py "生一个动漫视频"
  41. # 向已有会话追加消息
  42. python3 skills/libtv-skill/scripts/create_session.py "再生成一张风景图" --session-id <SESSION_ID>
  43. # 只创建/绑定会话,不发消息
  44. python3 skills/libtv-skill/scripts/create_session.py
  45. ```
  46. **输出示例:**
  47. ```json
  48. {
  49. "projectUuid": "aa3ba04c5044477cb7a00a9e5bf3b4d0",
  50. "sessionId": "90f05e0c-5d08-4148-be40-e30fc7c7bedf",
  51. "projectUrl": "https://www.liblib.tv/canvas?projectId=aa3ba04c5044477cb7a00a9e5bf3b4d0"
  52. }
  53. ```
  54. ### 查询会话进展
  55. ```bash
  56. # 查询会话消息列表
  57. python3 skills/libtv-skill/scripts/query_session.py <SESSION_ID>
  58. # 增量拉取(只返回 seq > N 的新消息,适合轮询)
  59. python3 skills/libtv-skill/scripts/query_session.py <SESSION_ID> --after-seq 5
  60. # 附带项目地址
  61. python3 skills/libtv-skill/scripts/query_session.py <SESSION_ID> --project-id <PROJECT_UUID>
  62. ```
  63. **输出示例:**
  64. ```json
  65. {
  66. "messages": [
  67. { "id": "msg-xxx", "role": "user", "content": "生一个动漫视频" },
  68. { "id": "msg-yyy", "role": "assistant", "content": "..." }
  69. ],
  70. "projectUrl": "https://www.liblib.tv/canvas?projectId=..."
  71. }
  72. ```
  73. ### 切换项目
  74. ```bash
  75. # 切换当前 accessKey 绑定的项目
  76. python3 skills/libtv-skill/scripts/change_project.py
  77. ```
  78. **输出示例:**
  79. ```json
  80. {
  81. "projectUuid": "新项目UUID",
  82. "projectUrl": "https://www.liblib.tv/canvas?projectId=新项目UUID"
  83. }
  84. ```
  85. ### 上传文件
  86. ```bash
  87. # 上传图片
  88. python3 skills/libtv-skill/scripts/upload_file.py /path/to/image.png
  89. # 上传视频
  90. python3 skills/libtv-skill/scripts/upload_file.py /path/to/video.mp4
  91. ```
  92. **输出示例:**
  93. ```json
  94. {
  95. "url": "https://libtv-res.liblib.art/claw/{projectUuid}/{uuid}.png"
  96. }
  97. ```
  98. ### 下载结果
  99. ```bash
  100. # 从会话自动提取并下载所有图片/视频
  101. python3 skills/libtv-skill/scripts/download_results.py <SESSION_ID>
  102. # 指定输出目录
  103. python3 skills/libtv-skill/scripts/download_results.py <SESSION_ID> --output-dir ~/Desktop/my_project
  104. # 指定文件名前缀(如 storyboard_01.png, storyboard_02.png ...)
  105. python3 skills/libtv-skill/scripts/download_results.py <SESSION_ID> --prefix "storyboard"
  106. # 直接下载指定 URL 列表(无需 session_id)
  107. python3 skills/libtv-skill/scripts/download_results.py --urls URL1 URL2 URL3 --output-dir ./output
  108. ```
  109. **输出示例:**
  110. ```json
  111. {
  112. "output_dir": "/Users/xxx/Downloads/libtv_results",
  113. "downloaded": ["/Users/xxx/Downloads/libtv_results/01.png", "..."],
  114. "total": 9
  115. }
  116. ```
  117. </details>
  118. ## 📁 项目结构
  119. ```
  120. libtv-skills/
  121. ├── README.md
  122. ├── LICENSE
  123. └── skills/
  124. └── libtv-skill/ # Agent-IM 会话技能
  125. ├── SKILL.md # 技能描述文件(OpenClaw 规范)
  126. └── scripts/
  127. ├── _common.py # 公共模块(鉴权、HTTP 请求、API 封装)
  128. ├── create_session.py # 创建会话 / 发送消息
  129. ├── query_session.py # 查询会话消息进展
  130. ├── change_project.py # 切换绑定项目
  131. ├── upload_file.py # 上传图片 / 视频文件到 OSS
  132. └── download_results.py # 批量下载生成结果到本地
  133. ```
  134. ## 🔧 API 参考
  135. ### 鉴权
  136. 所有 API 请求通过 HTTP Header 进行 Bearer Token 鉴权:
  137. ```
  138. Authorization: Bearer <LIBTV_ACCESS_KEY>
  139. ```
  140. ### 接口列表
  141. | 方法 | 路径 | 说明 |
  142. |------|------|------|
  143. | `POST` | `/openapi/session` | 创建会话 / 发送消息 |
  144. | `GET` | `/openapi/session/:sessionId` | 查询会话消息列表 |
  145. | `POST` | `/openapi/session/change-project` | 切换绑定项目 |
  146. | `POST` | `/openapi/file/upload` | 上传图片 / 视频文件到 OSS |
  147. ### 请求 & 响应
  148. <details>
  149. <summary><b>POST /openapi/session</b> — 创建会话 / 发送消息</summary>
  150. **Request Body:**
  151. ```json
  152. {
  153. "sessionId": "(可选)已有会话 ID",
  154. "message": "(可选)要发送的消息内容"
  155. }
  156. ```
  157. **Response:**
  158. ```json
  159. {
  160. "data": {
  161. "projectUuid": "aa3ba04c5044477cb7a00a9e5bf3b4d0",
  162. "sessionId": "90f05e0c-5d08-4148-be40-e30fc7c7bedf"
  163. }
  164. }
  165. ```
  166. </details>
  167. <details>
  168. <summary><b>GET /openapi/session/:sessionId</b> — 查询会话消息</summary>
  169. **Query Params:**
  170. | 参数 | 类型 | 说明 |
  171. |------|------|------|
  172. | `afterSeq` | int | 可选,只返回 seq 大于该值的消息(增量拉取) |
  173. **Response:**
  174. ```json
  175. {
  176. "data": {
  177. "messages": [
  178. { "id": "msg-xxx", "role": "user", "content": "生一个动漫视频" },
  179. { "id": "msg-yyy", "role": "assistant", "content": "..." }
  180. ]
  181. }
  182. }
  183. ```
  184. </details>
  185. <details>
  186. <summary><b>POST /openapi/session/change-project</b> — 切换项目</summary>
  187. **Request Body:** `{}`(空)
  188. **Response:**
  189. ```json
  190. {
  191. "data": {
  192. "projectUuid": "新项目UUID"
  193. }
  194. }
  195. ```
  196. </details>
  197. <details>
  198. <summary><b>POST /openapi/file/upload</b> — 上传文件</summary>
  199. **Request Body:** `multipart/form-data`,包含 `file` 字段(图片或视频文件)
  200. **Response:**
  201. ```json
  202. {
  203. "data": {
  204. "url": "https://libtv-res.liblib.art/claw/{projectUuid}/{uuid}.png"
  205. }
  206. }
  207. ```
  208. > 仅支持图片(`image/*`)和视频(`video/*`)类型,其他类型会被拒绝。
  209. </details>
  210. ## 🤖 Agent 集成指南
  211. 本技能包设计为被 AI Agent 自动调用。典型的工作流如下:
  212. ```
  213. 用户指令 → Agent 解析意图 → 调用 create_session.py 发送指令
  214. ↓
  215. 获取 sessionId + projectUuid
  216. ↓
  217. 轮询 query_session.py 获取结果
  218. ↓
  219. download_results.py 批量下载到本地
  220. ↓
  221. 向用户展示:生成结果 + 项目画布链接
  222. ```
  223. ### 最佳实践
  224. - **自动下载**:任务完成后,使用 `download_results.py` 将图片/视频批量下载到本地,再同时向用户展示 **本地文件路径** 和 **项目画布链接**(`projectUrl`)
  225. - **增量轮询**:使用 `--after-seq` 参数进行增量拉取,避免重复获取已处理的消息
  226. - **项目管理**:当需要隔离不同任务时,使用 `change_project.py` 切换到新项目
  227. - **文件上传**:在发送生图/生视频指令前,可先用 `upload_file.py` 上传参考图片或素材,获取 OSS 地址后再一并传入消息
  228. ## 🤝 贡献
  229. 欢迎提交 Pull Request 来添加新的技能或改进现有技能!
  230. ### 添加新技能
  231. 1. 在 `skills/` 目录下创建新的技能文件夹
  232. 2. 编写 `SKILL.md` 技能描述文件(遵循 OpenClaw 规范)
  233. 3. 在 `scripts/` 子目录中实现功能脚本
  234. 4. 更新本 README 的技能列表
  235. ## 📄 License
  236. 本项目采用 [MIT License](LICENSE) 开源。
  237. Copyright © 2026 [libtv-labs](https://github.com/libtv-labs)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.