FrameOS

面向 AI Agent 的 FrameOS

只需向你正在使用的 AI Agent 提出要求，就能把长视频变成短片段。将播客、直播、访谈或网络研讨会的链接粘贴到 Claude、ChatGPT、Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI 或 Perplexity 中，FrameOS 就会找出精彩片段，根据你的格式调整画面、添加字幕，并按排名整理好片段供你选择。导出、添加字幕、制作缩略图和发布哪些内容，都由你决定。

本仓库包含 FrameOS 插件、技能和扩展包。它们会将你的 Agent 连接到托管的 FrameOS 连接器（位于 https://frameos.studio/mcp 的 MCP 服务），并教会它如何善用 FrameOS：何时检查你的积分、渲染需要等待多久、有哪些字幕样式，以及未经你同意绝不发布任何内容。

状态，2026-10-26：托管连接器已上线，除 Devin 外，所有列出的应用均可登录。 https://frameos.studio/mcp 已可使用。Claude Code、Claude（网页端、桌面端、移动端）、ChatGPT、Codex、Cursor 和搭载 GitHub Copilot 的 VS Code 均已使用真实账户完成端到端测试；Gemini CLI、Perplexity 和 Copilot CLI 可以登录，但尚未完成端到端测试（测试版）。Devin（包括 Windsurf）即将推出：目前还无法登录。请参阅 docs/status.md 了解待完成事项，也可以在模拟服务上试用完整工作流，无需消耗积分。

可以对 Agent 说什么

你不需要学习任何命令。只要像向剪辑师说明需求一样告诉 Agent：

• “把这一期做成 5 个竖屏 TikTok 短片段：https://youtube.com/watch?v=...”
• “从这段访谈中制作 3 个 LinkedIn 方形片段，重点关注我们谈到定价的部分。”
• “按优劣顺序给我看看昨天直播中的片段。”
• “把第 2 个片段的字幕放大一点、往上移一些，并使用 Beasty 样式。然后给我 MP4。”
• “上周的播客中，我们在哪里谈到了招聘？请给我带时间戳的引述。”
• “为我最好的片段制作 2 张 YouTube 缩略图。”
• “为这个片段写一段 Instagram 文案。”然后，满意后再说：“把它发布到我的 Instagram。”
• “把这场网络研讨会做成一周的内容：5 个片段、字幕、缩略图，以及适用于 YouTube 和 LinkedIn 的文案。”
• “我还剩多少 FrameOS 积分？这个月都花在哪些地方了？”

更多按任务分类、可直接使用的提示词，请参阅 docs/workflows.md。

请求制作片段后会发生什么

1. Agent 会检查你是否已登录，以及是否有足够的积分。
2. Agent 会将链接（如果你的 Agent 能运行命令，也可以上传文件）连同你的设置发送给 FrameOS：要制作多少个片段、使用哪种格式，以及重点关注什么。
3. 渲染通常需要 10 到 30 分钟。Agent 会告诉你大概需要多久，并自动回来检查；如果使用无法等待的聊天应用，Agent 会告诉你稍后说“检查我的 FrameOS 渲染”。
4. 你会收到按排名整理的片段列表，其中包括标题或吸引点、时长、评分、片段在原视频中的位置，以及预览链接。
5. 接下来由你决定：调整字幕样式、导出 MP4、制作缩略图、起草文案或发布。

积分如何计算

• 所有 FrameOS 套餐均可使用。你只需要积分。
• 每开始处理 1 分钟源视频，渲染费用为 1 积分；只有交付片段时才会扣除积分。
• 每张缩略图需要 10 积分。
• 导出、调整字幕、起草文案、创建合集和发布均免费。
• 只有当你的余额足以支付整段视频时，渲染才会开始，因此不会出现只付了一部分费用的渲染。
• 一个工作区最多可同时处理 3 个视频。Agent 会将其余视频排入队列，并在渲染完成后继续提交。
• 服务端会强制执行这两项规则（自 2026-10-06 起生效），技能也会遵循这些规则。
• 随时向 Agent 询问“我的 FrameOS 积分余额是多少？”即可查看。套餐和价格请访问 https://frameos.studio/pricing；Agent 不会提供报价。

安装

选择你使用的应用。每份指南都包含具体步骤、验证是否成功的方法、重新登录的方法以及已知限制。Claude Code、Claude（网页、桌面端、移动端）、ChatGPT、Codex、Cursor 和 VS Code 均已完成端到端测试；Gemini CLI 和 Perplexity（自 2026-10-08 起）以及 Copilot CLI（自 2026-10-23 起）可以登录，但尚未完成端到端测试；Devin 即将推出（状态）。

AI 使用场景	最快捷的方式	完整指南
Claude Code	运行 claude mcp add --transport http -s user frameos https://frameos.studio/mcp，然后运行 claude mcp login frameos（已测试）。或者，使用技能：运行 claude plugin marketplace add theSatvik/frameos-plugins，然后运行 claude plugin install frameos@frameos（尚未测试通过插件自身的连接登录）	docs/install/claude-code.md
Claude.ai、Claude Desktop、Cowork	使用 https://frameos.studio/mcp 添加自定义连接器（已测试）。或者，使用技能：Customize > Plugins > Add > Add marketplace，输入 theSatvik/frameos-plugins（尚未测试）	docs/install/claude-ai.md
Codex	运行 codex plugin marketplace add theSatvik/frameos-plugins，然后运行 codex plugin add frameos@frameos	docs/install/codex.md
ChatGPT	开启开发者模式，然后在 ChatGPT Plugins 下添加 https://frameos.studio/mcp	docs/install/chatgpt.md
Cursor	一键安装链接（已测试），或将插件作为本地插件安装	docs/install/cursor.md
Gemini CLI	运行 gemini extensions install https://github.com/theSatvik/frameos-plugins	docs/install/gemini-cli.md
VS Code 和 GitHub Copilot	VS Code：将 https://frameos.studio/mcp 添加到你的 mcp.json 中（已测试），或选择 Chat: Install Plugin From Source。Copilot CLI（1.0.83 或更高版本）：运行 copilot mcp add --transport http frameos https://frameos.studio/mcp，然后运行 /mcp auth frameos（尚未完成端到端测试）	docs/install/vscode-copilot.md
Perplexity	使用 https://frameos.studio/mcp，选择 Account settings > Connectors > + Custom connector > Remote	docs/install/perplexity.md
Devin 和 Windsurf（现为 Devin Desktop）	即将推出：Devin 目前还无法登录 FrameOS。发送邮件至 [email protected]，了解何时可以使用	docs/install/devin-windsurf.md
其他任何 Agent	运行 npx skills add theSatvik/frameos-plugins，并添加连接器 URL https://frameos.studio/mcp	docs/install/other-agents.md

验证是否成功。 在新对话中询问：“我的 FrameOS 积分余额是多少？”你应该会看到工作区名称和积分数。单有“已连接”徽章并不能证明连接成功；只有实际得到答复才算。

让你的 Agent 执行安装。 能运行命令的 Agent（例如 Claude Code、Codex、Gemini CLI）可以帮你安装 FrameOS。粘贴以下内容：

Install FrameOS by following https://github.com/theSatvik/frameos-plugins/blob/main/docs/install-protocol.md

它能做什么，不能做什么

你的 Agent 可以：

• 从链接中剪辑视频——链接可以是 YouTube、Vimeo、Twitch、Kick、公开的 Google Drive 文件，或直接的视频文件 URL；也可以从你电脑上的文件剪辑，前提是你的 Agent 能运行命令。视频素材时长至少需要 30 秒。
• 每个视频最多制作 20 个片段（默认 3 个）。这是上限，因此你实际得到的片段可能更少。
• 将片段设为 9:16（Shorts、Reels、TikTok）、4:5 或 3:4（信息流）、1:1（正方形）或 16:9（横向）。
• 引导剪辑聚焦某个主题。请使用说话者实际说出的词语（“定价”“招聘”），因为系统会根据词语匹配焦点；这只是偏好，并非筛选条件。
• 使用 22 种字幕样式（或不显示字幕）、16 种字体，设置字号、位置和 17 种动画效果，然后导出带字幕的 MP4。下载链接大约 1 小时后失效，需要时你的 Agent 会获取新的链接。
• 搜索自连接器启动以来处理过的视频的完整转录文本（较早的项目可能只有每个片段的转录文本），并提取带时间戳的引言。
• 每次请求最多根据视频的真实画面制作 3 张缩略图，并添加文字排版（不是 AI 生成的图像）。
• 为 YouTube、Instagram、Facebook、LinkedIn、TikTok 或 X 拟写标题、说明和主题标签。
• 发布到 YouTube（Shorts）、Facebook 专页、Instagram 商业账号（Reels）或你在 FrameOS 中连接的 LinkedIn 个人主页——但每次发布前都必须先由你确认。
• 将片段整理到合集、复制片段以便尝试不同方案，并查看过去 30 天的额度使用情况。

你的 Agent 无法提供（请使用 FrameOS 网页应用：https://frameos.studio/dashboard，或该功能尚不可用）：

• 安排帖子发布时间、生成分享链接、遮挡或消音、配音，或自由编辑时间线。
• 指定片段时长，或不经剪辑直接渲染完整视频。
• 取消已开始的渲染任务。
• 发布到 TikTok 或 X（但你的 Agent 仍可撰写文案）。
• 连接社交账号或上传品牌 Logo（这两项都需要在网页应用中完成一次）。
• 重命名或删除合集，或从合集移除片段。

免费方案制作的片段会带有 FrameOS 水印。

此插件会发送哪些内容

• 只有两个地址，不会发送其他内容。 安装后，插件会将你的应用指向 FrameOS 连接器 https://frameos.studio/mcp，以及 FrameOS 登录服务 https://clerk.frameos.studio；连接账号时，这两个地址会显示一次。连接器返回的上传和下载链接（用于上传你要求 Agent 上传的文件，或下载完成的 MP4）指向 FrameOS 自有的文件存储，并会过期。
• 插件本身不包含代码。 插件由说明（技能和 Gemini CLI 命令）及连接设置组成，不包含钩子，也没有任何会在安装或使用时运行的内容。所有请求均由你的 AI 应用发起。仓库中的 dev/、scripts/、tests/ 和 evals/ 文件夹属于维护者工具（仅在你启动时运行的本地模拟服务器不会调用你电脑以外的任何内容，还有各类检查和测试）；插件从不会运行这些工具。在能够运行命令的应用中，技能可能会让你的 Agent 检查并上传你选定的视频文件、在渲染检查之间等待、保存你要求的 MP4，或在你要求配置 FrameOS 时运行应用的安装步骤。
• 不追踪。 不进行分析或遥测。插件额外添加的唯一信息是其版本号；在支持的应用中，该版本号会通过 X-FrameOS-Plugin-Version 标头发送。
• 未经你的同意，不会公开任何内容。 每次发布前，技能都会要求你确认。

FrameOS 如何处理你的视频和账号，请参阅隐私政策和条款。如有疑问，请联系：[email protected]。

无需积分即可试用（模拟服务）

仓库附带一个本地模拟 FrameOS 服务，拥有与真实服务相同的 27 个工具和输入，并以相同格式返回错误。无需账户、登录或积分，因此你可以完整体验整个流程——提交、轮询、片段、字幕、导出、缩略图、复制和模拟发布——而无需接触真实账户。

git clone https://github.com/theSatvik/frameos-plugins
cd frameos-plugins
uv run --script dev/mock_server.py                        # stdio
uv run --script dev/mock_server.py --http --port 8790     # Streamable HTTP at http://127.0.0.1:8790/mcp
claude --plugin-dir . --mcp-config dev/mock.mcp.json --strict-mcp-config   # Claude Code: these skills + the mock only

模拟链接指向 mock.frameos.invalid，因此不会创建任何真实内容。dev/README.md 提供了完整的演练指南，以及会触发各类错误的输入。

本仓库中的软件包

仓库根目录就是插件。一组技能适用于所有宿主；每个宿主都读取自己的清单。

文件或文件夹	内容	读取方
skills/	八项技能：frameos-setup、frameos-clip、frameos-captions、frameos-find-moments、frameos-thumbnails、frameos-publish、frameos-library、frameos-repurpose。每项技能都包含 references/ 和 agents/openai.yaml。	所有宿主；npx skills；技能 ZIP 上传
.claude-plugin/	Claude 插件清单和市场	Claude Code；claude.ai、Claude Desktop 和 Cowork；Devin 会回退使用它
.mcp.json	采用 Claude Code 格式的 FrameOS 连接配置	Claude Code；安装 Claude 格式插件时的 Devin 和 VS Code
.codex-plugin/、.agents/plugins/marketplace.json	Codex 插件清单、其专属连接文件（.codex-plugin/mcp.json）和市场	Codex CLI 和应用；ChatGPT 插件目录提交
.cursor-plugin/plugin.json	包含连接配置的 Cursor 插件	Cursor
gemini-extension.json、GEMINI.md、commands/frameos/	Gemini CLI 扩展、始终启用的上下文和 /frameos:* 命令	Gemini CLI
agent-plugin/	Agent Plugins 1.0 软件包（其中的 skills/ 是同步副本）	VS Code 和 GitHub Copilot（IDE、CLI、应用）、Devin、Cursor
.github/plugin/marketplace.json	指向 agent-plugin/ 的 Copilot 市场	Copilot CLI、VS Code
assets/icon.png	1024 px 图标	Codex、Cursor、目录
server.json	连接器在官方 MCP 注册表中的条目（不属于插件）	MCP 注册表及复制该文件的目录
docs/submission/openai-package.json	合并到 OpenAI 上传 ZIP 中的条目文本和审核详情	ChatGPT 和 Codex 插件目录提交
dev/	用于演示和测试的模拟 FrameOS 服务	你、维护者
docs/	安装指南、提示词库、状态、提交清单	所有人
scripts/、tests/、evals/	验证器、同步、版本更新、ZIP 构建器、测试、Claude 插件评估	维护者

用于上传到 claude.ai 和 Perplexity 的技能 ZIP、用于 Upload plugin 的插件 ZIP，以及 OpenAI 插件目录 ZIP，均通过 python3 scripts/build_dist.py 构建到 dist/。

链接

• FrameOS：https://frameos.studio - Web 应用：https://frameos.studio/dashboard - 定价：https://frameos.studio/pricing
• 帮助：https://frameos.studio/contact 或 [email protected]
• 隐私：https://frameos.studio/privacy - 条款：https://frameos.studio/terms
• 状态 - 提示词库 - Agent 安装协议 - 更新日志
• 贡献指南 - 发布 - 安全 - 许可证（MIT）