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 Studio0.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 执行器按路线图继续实现。
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
对其他项目运行验证和生成:
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.sqliteHTTP 端点固定绑定 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。
相关文档: