Skip to content

About

Cross-project automated content and video production toolkit

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Content Studio

Content Studio 是开源、本地优先、跨项目、AI 原生的内容生产与发布控制台。它以 Agent Plugin + MCP App UI 为主要交互边界:AI 读取版本化项目事实和发布活动简报,生成文章、图片、 视频脚本及不同渠道版本,再通过可观察、可取消、可重试的任务完成录制和后续媒体 制作。

Vue 3 工作台是同一套 Content Studio core 和应用服务的可视化控制面,不在浏览器 应用中复制生成、录制、合成或发布逻辑。

真实渠道发布不属于本仓库。Content Studio 只准备发布内容、协调人工接管并展示 回执;独立的 marketing-ops 负责匹配授权、渠道策略、外部写入和发布回执。 最终安装器默认把兼容版本的 marketing-ops 作为受管运行时依赖一起安装,但 不会因此合并它的代码、存储或发布权限边界。

产品结构

全局渠道目录
  → 项目选择启用
    → 发布活动
      → 主题、目标和已选渠道
        → 内容组
          → 活动素材
            → 渠道成品(文章、图文、动态或视频)
              → 资源变体
                → 发布安排
                  → 发布记录
                    → 数据监测和报告
  • 渠道平台能力由全局管理,账号在项目渠道配置中绑定且每个渠道唯一;发布活动只选择 渠道,账号由项目配置自动解析。
  • 渠道是内容形态能力集合,而不是单一格式。例如 Bilibili 可以在同一个活动中选择 short-post(动态)、image-text(图文)和 video-metadata(视频稿);每种形态都会 生成独立内容包、文件和后续制作任务。视频的横屏/竖屏不是另一个渠道,而是活动视频 计划的 format: "landscape" | "portrait",并会被锁进 Bilibili 发布包和人工确认回执。 活动创建时通过 contentFormats 选择要做的形态;未声明时仍使用渠道默认形态,保持旧 campaign 兼容。当前一个活动的视频计划只有一个画幅;若同一主题要同时出横屏和竖屏, 应先建立两条独立的视频发布安排,后续再把画幅下沉为逐内容变体。
  • 每个渠道形态蓝图还描述标题/正文长度、允许的媒体类型和媒体数量要求。应用服务会把 渠道内容引用的最终 image/video 活动产物投影为逐内容 readiness,MCP 和工作台会 显示“已就绪”或缺少的资源;预览帧和录制片段不能冒充最终成品。缺少必需媒体时不会 创建发布安排。这个本地门槛不等同于发布授权,也不会替代独立 marketing-ops 的最终校验。
  • 活动产物可标记 en、zh-CN 或语言无关的 neutral;渠道内容只能引用同语言或 neutral 产物。发布包以渠道、语言、内容形态和内容版本锁定,只携带 artifact ID、sha256 和版本,不携带本地路径;同一渠道的中英文或多形态包不会被互相覆盖。发布安排建立后, prepare_marketing_ops_package 会从项目内自动解析当前渠道绑定并只读生成该包;调用方不能 传入账号引用或路径,返回结果也不会产生渠道调用、授权或发布回执。
  • marketing-ops 状态只通过有类型的只读客户端读取;当前兼容矩阵为 Content Studio 0.1.x ↔ marketing-ops 0.1.x / contract v3。状态快照由本地生成时间并只保留 60 秒, 未连接、版本不兼容或过期时发布保持阻塞;adapterReady 也不等于本次操作获得授权。 已初始化的受管 MCP client 只能通过固定 channels_status 适配器接入,Content Studio 忽略工具文本,只接受 structuredContent。Runtime 的项目范围 HTTP/MCP 读取入口和 Workbench 共用该快照;HTTP 禁止缓存,Workbench 每 30 秒刷新,失败时只显示“未查询”。 对已解析账号,快照可带不透明 accountRef;工作台优先据此匹配项目绑定,引用不匹配时 保持阻塞,旧响应缺失该字段才兼容回退到脱敏 alias。快照仍新鲜时,工作台只把当前 已解析账号作为该项目的单个候选项;项目所有者明确保存后才写入本地绑定,不自动改绑、 不形成全局账号目录,也不授予发布权限。 安装器或宿主通过显式的 MarketingOpsManagedRuntime 注入已初始化 client 和关闭句柄; CLI 只负责消费并在命令结束时幂等关闭,不探测命令、路径或凭据。 Plugin 通过独立的 content-studio-host 入口启动,它只转发三个项目路径变量;在安装器 交付有签名或内置摘要的固定 runtime 制品前,host 不会尝试查找或启动任何 marketing-ops 进程,状态保持阻塞。
  • 素材归项目所有,活动产物归具体活动;当前不设置全局素材库。
  • 同一发布活动可以为不同平台创作完全不同的内容。
  • 图片是可由 AI 独立生成的素材,通常服务于文章、图文、视频或封面。
  • 移动端、PC 端、横屏、竖屏等通过渠道要求的资源变体表达。
  • 制作、发布、监测是三类执行任务,在全局或项目任务面板中显示,不作为活动 内部业务模块的名称。

完整层级见产品功能模块。

开源、本地优先与安装目标

项目源码、素材、活动产物、Playwright、FFmpeg 和渠道运行时默认保留在用户自己的 设备或自托管环境。公网服务只作为公共 Plugin 的轻量入口、UI resources 和可选 协调层,不是本地使用的前提。

目标用户体验是:

一条命令安装 Content Studio 本地运行时
  → 安装一个 Content Studio Plugin
    → 第一次使用时确认项目目录和允许的能力
      → 开始创作、制作、发布协作和监测

正式发布后 README 将提供版本化且可验证的安装脚本,命令形态如下;当前安装器和 公开地址尚未发布,因此这里不提供伪造的可执行 URL。

curl -fsSL <versioned-install-url> | sh
content-studio doctor

本地运行时统一交付 core、应用服务、MCP Server、Vue 工作台、本地存储、 Playwright/FFmpeg Worker 和受管的 marketing-ops 依赖。用户只安装一个 Content Studio Plugin;渠道配置仍由用户在 marketing-ops 的本地交互流程中 完成,任何凭据都不经过 Content Studio、MCP 参数或对话。

完整决策和安装器安全要求见 开源、本地优先与安装分发。

当前实现

V0.1 确定性编译器已经完成。它把小型、版本化项目清单和 campaign brief 编译为:

  • 当前 19 渠道的确定性内容包;
  • 不授予发布权限的渠道交付分类;
  • 使用语义项目交互的确定性视频录制计划;
  • 可以移交给独立 marketing-ops 的版本化产物。

V0.2 通用 Playwright 录制器已经完成:

  • 只消费编译后的语义视频计划;
  • 输出标准 JSON 进度事件、日志摘要、预览帧和回执;
  • 支持协作式取消和有界重试;
  • 每次尝试使用独立目录且不覆盖此前证据;
  • 拒绝跨 origin、认证页面、弹窗、下载和非语义选择器。

最小 Vue 3 工作台已经建立。项目概览和发布活动现在可以连接本地应用服务:项目视图 和活动从 SQLite 读取,活动可以通过工作台创建并立即显示,同时生成一个真实的项目制作 任务,任务事件也会在运行时重启后恢复。其他任务类型、素材、人工接管和报告仍有明确 标注的演示投影。制作任务的取消和重试已经通过本地应用服务执行;清理和真实渠道发布 仍保持只读或禁用,直到对应契约接入。

活动详情还可以通过本地应用服务保存内容组和渠道内容版本,按渠道展示文章、图文、动态或视频内容。 已有内容可以用带 baseVersion 的媒体修订追加或替换最终图片/视频;替换只更新最终媒体引用, 保留文章、音频和中间证据,建立发布安排后则锁定媒体修订。当前工作台里的保存表单是 AI/MCP 接入前的手动测试入口,不代表系统已经自动生成内容。

视频制作任务在录制片段完成后会由本地 FFmpeg 合成为渠道尺寸的最终成片,并从成片首帧 生成一个嵌入真实画面的 composed/cover.svg。封面以活动级图片产物登记,工作台和本地 Runtime 预览接口可以直接查看;这条降级路径不调用图像模型,也不接收模型凭据。 同一成片还可以生成一个无音频、无限循环的 composed/preview.gif:默认限制为 640px 长边、10 FPS、4 秒和 8 MiB,并以同一活动级 image 产物登记,方便公众号等场景直接 预览或下载。GIF 使用本地 FFmpeg 的调色板两遍编码,不调用图像模型,也不授予任何发布权限。 合成阶段现在沿用任务事件和回执契约:视频、封面、GIF 完成时分别写入结构化事件,终态 回执按任务尝试保存安全相对路径、尺寸、时长、大小和 SHA-256。取消信号会传入 FFmpeg、 媒体探测和文件哈希;取消或失败的尝试不会把半成品登记为活动产物,回执可在 SQLite 重启后恢复。

本地 MCP 的第一条切片已经接入。它使用 stdio 逐行传输 JSON-RPC,只加载命令行明确 指定的一个项目,不监听端口,也不接收凭据、任意脚本、选择器或文件路径。AI 宿主可以 读取项目事实、活动、内容和任务,并通过高层工具创建发布活动、保存内容组与渠道内容、 读取任务以及取消/重试本地任务。宿主声明 Tasks 扩展能力后,长调用返回 resultType: "task";tasks/get 读取状态和终态结果,tasks/update 提交 inputResponses,tasks/cancel 协作式请求取消。追加事件继续由领域工具 get_task 读取。AI 宿主还可以用 save_activity_content_pack 一次 保存内容组和多个渠道版本,再用 start_production_task 启动本地制作的生成阶段;这些 工具不会执行真实渠道发布。图片等最终产物稍后生成时,可用 revise_channel_content_media 对已有内容执行版本化 append/replace,无需重建正文。

本地 Plugin 运行时同时支持当前 Codex stdio 客户端的标准 initialize/ notifications/initialized 握手,以及目标 2026-07-28 的无状态 server/discover 路径。两条入口复用同一组项目范围工具和资源;兼容握手不会创建协议 会话,也不会扩大工具权限。

AI 创作是目标产品的核心能力,目前的确定性编译器是安全基础,MCP 是 AI 宿主接入 应用服务的第一步,文章/图片/视频方案生成和后台 AI 执行器按路线图继续实现。

MCP App 与公开上架目标

Content Studio 将以 Skills、无状态 MCP Server 组成可公开提交的 OpenAI Plugin 包 (.codex-plugin/plugin.json + skills/ + .mcp.json),MCP App UI 作为客户端命名空间扩展存在,目标进入 ChatGPT 与 Codex 共用的 Plugins Directory。

远程服务首选 MCP 2026-07-28,业务状态通过 projectId、activityId、 taskId 等显式句柄和服务端持久化管理;长制作流程映射为 MCP Tasks。没有 UI 时工具仍能完成 headless 工作流,Vue 用于内容审核、资源比较、任务观察和全屏 活动控制。

Algorithm Visualizer 的自有服务器已经通过只读检查确认具备 Nginx、HTTPS、 Node.js 和 PM2 基础,可以作为轻量 MCP API/UI 试运行基础;Playwright、FFmpeg 和后台 AI Worker 需要与低内存公网服务分离。本次检查没有部署或修改服务器。

协议、部署与公开审核检查表见 MCP App 与公开上架准备。

从源码开发和验证

corepack enable
pnpm install
pnpm verify
pnpm generate:example

示例输出:

.content-studio/example/
├── bundle.json
├── content/
│   ├── bilibili.zh-CN.md
│   ├── github.en.md
│   └── ...
└── video/
    └── plan.json

CLI

对其他项目运行验证和生成:

pnpm build
node dist/cli.mjs validate \
  --project path/to/project.json \
  --campaign path/to/campaign.json

node dist/cli.mjs generate \
  --project path/to/project.json \
  --campaign path/to/campaign.json \
  --out .content-studio/my-campaign

产品层把 Campaign 称为“发布活动”。V0.1 CLI 和数据契约暂时保留 --campaign、campaignId 等兼容名称。

检查本地运行条件(不会创建目录、读取凭据或配置渠道):

node dist/cli.mjs doctor \
  --project path/to/project.json \
  --db .content-studio/content-studio.sqlite

对明确启动或连接的项目预览执行录制:

pnpm exec playwright install chromium
node dist/cli.mjs record \
  --project path/to/project.json \
  --campaign path/to/campaign.json \
  --base-url http://127.0.0.1:11000 \
  --out .content-studio/jobs/my-recording \
  --attempts 2

录制器发出 JSON 进度事件。每个不可变 attempt-<n>/ 目录包含隔离 WebM 场景片段、预览帧和机器可读 receipt.json。Ctrl+C 会协作式取消当前尝试。 当前视频录制使用横屏、竖屏、方形三种固定分辨率预设,也支持在项目和活动视频计划中 指定经过边长、像素总量、比例和画幅方向校验的 viewport、输出媒体尺寸、device scale factor、语言和色彩环境。配置按项目默认值、活动默认值和渠道变体合并,最终完整配置会 进入 VideoPlan 和录制回执;不接受任意浏览器参数、脚本、 选择器、cookie 或凭据。 工作台的新建活动表单可以建立视频制作计划,活动详情可以修订录制尺寸;每次修订都会 生成新版本并等待再次确认。

启动最小工作台:

pnpm dev:workbench

启动本地应用服务(另一个终端):

pnpm build
node dist/cli.mjs serve \
  --project examples/algorithm-visualizer/project.json \
  --campaign examples/algorithm-visualizer/campaign.json \
  --port 11001

启动本地 MCP(由支持 MCP 的 AI 宿主启动或在终端中测试):

pnpm build
node dist/cli.mjs mcp --stdio \
  --project examples/algorithm-visualizer/project.json \
  --campaign examples/algorithm-visualizer/campaign.json \
  --db .content-studio/content-studio.sqlite

--campaign 只用于把发布活动中使用的渠道绑定到这个项目;MCP 工具仍会再次校验 项目范围和渠道是否启用。stdio 不占用端口,协议输出只写到标准输出,诊断信息不混入 协议流。

随本地 Plugin 启动时可分别用 CONTENT_STUDIO_PROJECT、 CONTENT_STUDIO_CAMPAIGN 和 CONTENT_STUDIO_DB 传入同三条 Owner 控制的绝对路径; 插件包只声明变量名,不包含路径内容或任何凭据。

需要 HTTP 传输的本地宿主可以使用同一个项目范围启动无状态 MCP 端点:

node dist/cli.mjs mcp --http \
  --project examples/algorithm-visualizer/project.json \
  --campaign examples/algorithm-visualizer/campaign.json \
  --port 11002 \
  --db .content-studio/content-studio.sqlite

HTTP 端点固定绑定 127.0.0.1,路径为 /mcp;它只处理符合 MCP 2026-07-28 的 JSON-RPC 请求,不提供公网鉴权,也不会触发真实渠道发布。公网部署前仍需单独完成 TLS、鉴权、Origin 白名单、限流和审计。

本地开发端口从 11000 开始分配:11000 是 Vue 工作台,后续应用服务使用 11001、MCP HTTP 使用 11002,MCP stdio 不占用端口。工作台使用严格端口模式, 如果端口已被占用会直接报错,不会悄悄换到另一个端口;新增服务继续按这个表顺延。

工作台会通过 /api 代理连接 11001 的本地应用服务;服务未启动时自动退回只读演示。 当前 UI 开放“创建发布活动”以及本地制作任务的取消、重试;不会模拟发布或监测成功。

录制回执会写入同一份 SQLite,并在项目活动的视频详情中显示预览帧、产物下载链接、文件 大小、日志摘要和失败原因。项目视图不会暴露本地绝对路径;真实渠道发布仍不会由该服务触发。

统一素材预览首版已接入:项目素材和活动产物会通过本地运行时的项目范围接口显示文字、 图片、视频或音频预览,并提供登记文件下载;运行时未连接时仍只显示登记信息。尺寸、时长、 放大查看、清理确认、回收区和恢复按路线图继续补齐;素材页已可查看已登记文件的只读 清理预览,不会扫描或删除未知文件。

项目对接

项目至少提供:

  • 当前产品事实、定位和语言;
  • 规范网站与仓库 URL;
  • 使用 role、label、text 或 test-id 的语义 capture flow。

项目也可以在所有者明确许可后实现一个受信任的窄接口适配器,以准备更准确、 可重复的演示状态。Content Studio 按已注册 adapter ID 调用它;MCP 和公共数据 契约仍不接受任意脚本、Shell 命令、选择器或环境变量。

安全边界

Content Studio 不登录渠道、不处理验证码、不保存凭据、不持有浏览器会话,也不 运行任意浏览器脚本或选择器。

对于人工辅助渠道,Content Studio 可以创建“人工接管”,由“渠道授权人”在官方 平台界面完成登录、2FA/CAPTCHA、审核和最终发布点击。只有匹配的 marketing-ops 回执才能让控制面显示“已发布”。

内容包、AI 生成结果、预览或人工接管都不会产生发布权限。本仓库不执行未经匹配 授权的真实发布、回复或删除,也不抓取未授权的私有渠道后台。

开发

pnpm lint
pnpm type-check
pnpm test
pnpm coverage
pnpm build
pnpm generate:example

包管理器:pnpm 10.29.2。运行时:Node.js 22.5 或更高。项目使用纯 ESM。

相关文档:

About

Cross-project automated content and video production toolkit

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages