FindDataTechnology/fd-vaas-skills

> 谦面 Facet 产品线 · 寻数 FindData 的内容创作线 —— 自然语言视频创作与多平台分发技能链。
> 🌐 语言： 简体中文（本文件） · English
> 🚀 一键安装： curl -fsSL https://raw.githubusercontent.com/FindDataTechnology/fd-vaas-skills/main/install.sh | bash
## ⚡ 5 分钟第一支视频
bash
export VAAS= # 后续命令都用 $VAAS 指代
# 1. 安装（已跑过一键安装可跳过）
cd $VAAS && ./install.sh
# 2. 填密钥：编辑 .env，填入 vol_agent_api_key（火山方舟，https://console.volcengine.com/ark）
# 不确定环境是否就绪？随时跑：
node $VAAS/scripts/doctor.mjs
# 3. 出片走 MCP 工具面（本地 stdio 或托管端点均可；2026-11-09 起无本地 node 渲染链）
# generate_voice(text="你好，这是 VAAS 的第一支视频。", slug="demo") -> 配音 + captions.json
# render_video(type="news-flash", script="…", inputs={...}, slug="demo") -> 成片 mp4
# （也可 render_still 出封面/图表、render_document 出 PDF/长图）
# 产物：$VAAS/downloads/video/demo/demo.mp4（+ review URL / 签名 download_url）
> 接收一个内容需求，生成可变类型的资源（幻灯片、文档、屏幕录制视频、AI 图片/视频，或渲染面渲染的口播视频），然后自动发布到不同的社交媒体账号——理想情况下为每个平台产出不同的变体。
VAAS 是架在两半之上的一个编排层，自身没有应用代码：
1. 创作技能（Creation skills）——把需求变成一个素材文件（.pptx、.docx、.mp4、图片……），源码在 .agents/skills/。
2. 分发引擎（Distribution engine）——两个发布技能把素材发到各平台：fd-vaas-publish-videos（视频 -> 6 个视频平台）和 fd-vaas-publish-docs（图文 -> 11 个图文平台）。分发走「vendor 上游 + 薄适配层」：把 social-auto-upload 上游整个 vendor 进发布技能的 scripts/upstream/，薄适配层（sau_adapter.py / note_adapter.py）把 CLI 翻译成上游 Video(...).main() 调用，统一 py 运行时（patchright），登录态是 cookie 文件（upstream/cookies/ _uploader/account.json）；bilibili 例外（上游用 biliup 二进制，走本地 bilibili.py）。
> 架构变更（重要）： 分发栈已重新 vendor 上游 social-auto-upload——这是第二次架构翻转。先前「social-auto-upload 已移除、分发完全内置、macOS 走 ego-browser（.mjs）/ Windows 走 patchright（.py）双运行时」的表述全部作废。现在统一 py/patchright 运行时 + cookie 登录；各平台手写的 .mjs/.py 已删除。如果你看到旧文档提到 ego-browser 复用 Chrome 登录态发视频、--runtime 按 OS 派发，那些都已过时。
当有人说「做一个资源并发出去」时，预期的流程是：
创作技能产出一个文件 -> 发布技能把它上传到一个或多个账号
两条已接好的主线通过 fd-vaas- 技能把这个流程端到端串起来（无需手写胶水代码）：
视频主线： 需求 -> /fd-vaas-brainstorm -> /fd-vaas-video-creator -> /fd-vaas-publish-videos -> 视频平台
图文主线： 选题 -> /fd-vaas-brainstorm(图文模式) -> 文章 -> /fd-vaas-publish-docs -> 图文平台
## 目录
VAAS - 可变资源创作与分发
⚡ 5 分钟第一支视频
工作原理
VAAS 主线
仓库结构
前置条件
安装与部署
1. 分发运行时（patchright）与登录
2. 创作工具
3. Remotion 视频项目
4. Claude Code 技能
技能一览
平台支持矩阵
端到端使用示例
生成后端配置（volcengine / ciyuan 双档）
配置与代理说明
坑与排错
## 工作原理
┌─────────────────────────── 创作（CREATION）──────────────────────────┐ ┌──── 分发（DISTRIBUTION）────┐
需求 ──► ppt-master ──────► .pptx ┐
├─► officecli ──────► .docx/.xlsx ├─► 素材文件 ──► fd-vaas-publish-videos ──► 视频平台
├─► cap ──────► .mp4/.gif │ （抖音、快手、小红书、
├─► fd-cover-image ──► 封面图 │ B站、视频号、YouTube）
├─► remotion ──────► .mp4 │
└─► fd-vaas-video-creator ► .mp4+.srt ┘ ──► fd-vaas-publish-docs ──► 图文平台
（知乎、公众号、小红书、抖音、
快手、雪球、东财、同花顺、
头条、百家、微博）
创作技能产出具体的文件。每个技能的 SKILL.md 是权威契约--驱动工具前先读它。
分发只消费文件 + 元数据（视频 = title + desc + tags；图文 = title + content + tags）。两半之间没有共享胶水代码，除了 fd-vaas- 主线--创作技能产出的素材路径就是发布技能读取的那个。
登录态：发布走 cookie 文件（scripts/upstream/cookies/ _uploader/account.json），统一用 /fd-vaas-login（localhost:8766）扫码登录，视频与图文共享同一份 cookie。图文自有逻辑平台另可走 --runtime patchright（独立持久 profile VAAS/.profiles/ /）。ego-browser 仅用于录屏和图文自有平台的默认运行时。
## VAAS 主线
fd-vaas- 技能是接好的「需求到发布」流水线。
### 视频主线（「做一支视频并发布」）
1. /fd-vaas-brainstorm （可选）--给定赛道/主题，按口播 / 图文模式返回选题矩阵（热点/痛点/争议/干货/人设）、脚本框架或图文草稿（Markdown 版 + 纯文本简洁版）、差异化角度，以及可选的完整大纲。内置合规红线：口播稿不出现其他平台名、不引流站外。
2. /fd-vaas-video-creator--把文案变成成片。通过类型注册表（types/ /type.json，renderer: "hyperframes"）选视频类型，templates_list(domain="video") 看全部类型。稳定类型：口播 voiceover、录屏 screen-recording；实验类型：carousel（轮播）、kinetic-quote（动态金句）、news-flash（快讯）、listicle（盘点）、data-viz（数据可视化）。