AutoDirector

AutoDirector 是一个本地优先的 AI Agent 视频制作控制台。它把一句视频 brief 拆成可追踪的生产流水线：Producer 负责调度，Research / Director / Asset / Video Engineer / Render / Quality Gate 各自产出 artifact，Recorder 记录交接、沉淀经验和可复用 skill。

它不是“生成一个看起来像视频的结果”，而是把制作过程本身变成可检查的系统：谁接了任务、用了哪些素材、为什么被质检打回、返修从哪一步重跑、最后交付包里有哪些证据。

Review-use license: this public source release is provided for hackathon evaluation, not as an open-source template. See LICENSE before copying, redistributing, or reusing it.

当前重点

• CLI wizard 已支持 npm 启动、本地 doctor、QuickStart / Advanced 配置。
• Settings 保留为控制台里的长期配置入口，后续会替代一次性的 UI setup。
• Agent 状态面板已经按真实 run state 展示完成、闲置、返修、报错和上下文使用量。
• Live feed 会显示 SSE 连接状态，并把 Agent 输出合并成可读消息流。
• Quality Gate 拒绝后会从出问题的步骤重跑，而不是直接停止。
• Producer 支持用户 follow-up，制作中可以继续接收最新想法。
• Asset Agent 鼓励先找真实素材；制作导图时优先使用 imagegen。
• v0.5 已内置 12 个 premade super templates，并把 QA 硬失败规则结构化到 docs/quality-policy.json。
• v0.6 music selection 先保留路线图占位，等 Felix 补音乐标注后再启用。
• v0.7 图片策略已结构化：真实事件优先真实/可引用图片，导图和概念图优先原生 imagegen。
• v0.8 增加测试反馈矩阵，bootstrap 会暴露模板、QA、图片策略和回归验收面。

完整后续计划见 ROADMAP.md。

快速开始

推荐用 npm 包启动：

npx glitch-autodirector@latest onboard
npx glitch-autodirector@latest start

也可以从源码运行：

git clone https://github.com/Felix201209/AutoDirector-Studio.git
cd "AutoDirector-Studio"
npm ci
npm run build
npm start

打开本地控制台：

http://127.0.0.1:8787

CLI Wizard

autodirector onboard 是参考 OpenClaw onboarding 形态做的本地配置向导：

• QuickStart：使用安全默认值，最快进入本地控制台。
• Advanced：逐项配置 Agent host、模型 provider、视觉 provider、runtime、workspace、Gateway host/port/token。
• autodirector status：查看当前配置、端口和 provider 选择。
• autodirector doctor：检查 Node 版本、dist UI、server entry、state 目录和 API token。

常用命令：

npx glitch-autodirector@latest --help
npx glitch-autodirector@latest onboard --advanced
npx glitch-autodirector@latest doctor
npx glitch-autodirector@latest start --port 8787

安全默认值

AutoDirector 默认只监听 127.0.0.1，避免把本机 Agent 控制面暴露到局域网或公网。

如果你明确要开放给局域网或 tunnel：

AUTODIRECTOR_HOST=0.0.0.0 \
AUTODIRECTOR_API_TOKEN="$(openssl rand -base64 24)" \
npx glitch-autodirector@latest start

非本机 API mutation 必须携带：

x-autodirector-api-token: <token>

或：

Authorization: Bearer <token>

Agent Team

Agent	责任
Producer	理解 brief、拆任务、调度团队、接收用户 follow-up
Research	选题、事实、引用、素材线索
Story Director	脚本、字幕、叙事节奏、镜头结构
Asset	图片、imagegen、公开素材、音乐、版权风险
Video Engineer	HyperFrames / Remotion 源项目和动效实现
Render	渲染、ffmpeg、导出、package 文件
Quality Gate	自动质检，失败时只让出问题的步骤返修
Recorder	记录交接、上下文、run memory 和 skill 草稿

Quality Gate 拒绝结果时，pipeline 不会停在原地。它会把失败原因写进 repairState，把对应 Agent 标记为返修，并从最小责任步骤开始重跑受影响的下游步骤。

模型与视觉 Provider

可选模型/路由包括：

• Codex / ChatGPT OAuth
• OpenAI API
• Claude / Anthropic
• DeepSeek
• Qwen
• Moonshot / Kimi
• Gemini
• OpenRouter
• xAI / Grok
• Groq
• Mistral
• Doubao / Volcengine
• SiliconFlow
• MiniMax
• Z.AI / GLM
• Vercel AI Gateway
• Cloudflare AI Gateway
• LiteLLM
• LM Studio
• Ollama
• 自定义 OpenAI-compatible endpoint

视觉 provider：

• Codex Native / ChatGPT imagegen
• OpenAI Image API
• User upload
• Public/source assets only

Asset Agent 被鼓励先找真实可引用素材，或使用原生 imagegen 生成合格主视觉。AutoDirector 不允许把 HTML/SVG/canvas/local raster fallback 冒充成正式 imagegen 产物。

Templates, QA, Images

• docs/super-templates.json：12 个制作模板，覆盖新闻解释、产品宣传、课程讲解、导图、活动 recap、社媒短片、技术 demo、品牌片、对比评测、研究摘要、融资 pitch、release notes。
• docs/quality-policy.json：v0.5 严格 QA 策略，包含硬失败规则、patch owner routing、package allow/block 条件。
• docs/visual-asset-policy.json：v0.7 图片策略。真实新闻、人物、地点、产品、历史事件优先真实来源图；导图、概念图、结构图优先 imagegen；所有素材进入 asset_manifest.json。
• docs/testing-feedback-matrix.json：v0.8 测试反馈矩阵，覆盖 provider、stream、状态、模板、QA、图片策略、package 和公开文档一致性。

这些策略会通过 /api/bootstrap 暴露给控制台，也会进入 Codex Native Agent prompt，避免只停留在文档里。

输出结构

每次 run 会生成可审计交付包：

.autodirector/runs/<run-id>/final-package/

典型内容：

• final.mp4
• source_project.zip
• asset_manifest.json
• citations.md
• quality_report.md
• recorder_summary.md
• Agent artifacts 和 handoff 记录

验证

便携验证，不依赖 Codex 登录、外网、ffmpeg 或 imagegen quota：

npm run verify:quick

完整本地 Agent 验证：

npm run verify:full

发布前建议：

npm run build
npm run test:unit
npm audit --omit=dev
npm pack --dry-run

Codex Plugin

本仓库包含一个本地 Codex plugin：

plugins/autodirector-codex

它通过 MCP 连接本地 AutoDirector，可以让 Codex 创建 run、读取 Agent task、提交 artifact、注册 imagegen 资产、查看 Recorder memory，并请求最终 package。

npm 发布

当前包名：

glitch-autodirector

发布命令：

npm login
npm run build
npm run test:unit
npm audit --omit=dev
npm publish --access public

发布后验证：

npm view glitch-autodirector version
npx --yes glitch-autodirector@latest --help
npx --yes glitch-autodirector@latest doctor