Flovart: Instructions file for Codex

AGENTS.md

本文件约束 Flovart的 AI / 自动化开发。优先级：系统/开发者指令 > 用户当前明确要求 > 本文件 > 项目文档。用户已确认的新决定覆盖旧稿；历史文档不得反向改变当前产品方向。

0. 品牌规则

• 对外产品名称统一为 Flovart：新 UI、标题、按钮、宿主面板、README 和当前文档不再引入 Iris 品牌。
• CLI、Skill、package、环境变量和命令中已有的 flovart 保持不动。
• 旧 iris-* 的数据库字段、协议字段、持久化 key、兼容 ID 与已存素材路径保持兼容，不做全局替换；纯展示、CSS 和新导出文件名可以清理。
• 当前 canonical GitHub repository 经核验为 avabbbb/Flovart。仓库或协议迁移不得混入普通品牌清理。
• 历史归档和更名前的视频可保留原始名称，引用时说明历史背景。

1. 开始前先确认当前事实

开始任何实质修改前，先读：

1. docs/index.md
2. 与任务相关的 current-truth 文档
3. 真实代码与 SUPPORT_MATRIX.md

产品与系统目标由 docs/design/00-overview.md（总体设计）定义；所有交互遵守 docs/design/01-interaction.md（简单直接、不硬编码、不死锁）；模块细节见 docs/design/1x-*.md。不要从 archive、旧 audit、release evidence 或 Git 历史推导当前需求。

会变化的 SDK、宿主 API、许可证、模型/Provider 能力必须按当前日期核验官方文档和真实源码。构建通过、mock 通过、manifest 存在都不等于真实宿主/账号已认证。

2. 当前产品边界

产品目标（三个场景）：

1. 游戏素材替换（暂缓，当前不在 Reverse 中提供）：把游戏复刻 demo 里占位的美术与音效，用 Flovart 批量替换为可发布的原创素材；Agent 自动执行，并记住用户的个人美术风格偏好（memory）。
2. 爆款视频逆向：像 Hypit 一样把爆款视频拆成 Script → 转写证据 → 对齐 → Timeline → 轨道，再用用户自己的 AI 数字人角色批量、高并发、低时延地制作变体，支持快速投流。
3. 剪辑宿主插件：在达芬奇 / 剪映中作为插件，Agent 直接读取时间轴、图层和素材库作为上下文，不需要用户再手动上传；可对指定片段做人物替换、绿幕背景、AI 特效，或生成剪辑用素材。

顶级产品 surface 固定为 Canvas | Reverse | Agent（原 Table 位改为 Reverse，不再保留 table 视图）：

• Canvas：空间化 Workflow，用户与 Agent 操作同一份可见生产状态。

• Reverse（逆向）：按 Hypit 代码架构与功能复刻的视频逆向工作台（Studio 式：库 / 预览 / 时间线 lane / Inspector）。二次开发：逆向工程可一键转成 Canvas 上的子画布节点，双击子画布回到 Reverse；两边走同一 workflow.apply 边界联动。详见 docs/design/11-reverse.md。

• Agent：本地/外部 Coding Agent 的发现、准备、状态与切换中心。

• Assistant / Context / History：只在 Canvas / Reverse 的 contextual drawer 中，不复制到 Agent 页。

  Hypit 复刻边界：以 gitignored 的 _ref/hypit 为参照，对齐包分层、数据模型、术语与数据流，代码在 services/reverse/ 自写；不复制 Hypit 源文件，不把 @hypit/* 打进 bundle（附加条件的 Apache-2.0 要求衍生品同许可、禁止商业再分发与多租户托管，与本仓库 MIT 冲突）。WhisperX / ffmpeg / 渲染等本地能力走本地 Runtime 或用户自装的 hypit CLI，结果作为 durable artifact 导回。

  不要重新引入 Agent full-page chat、Tasks/Artifacts/Context 工作区、Production Crew / Director / Operator 必经层、Production Skill Marketplace 或第二套 Canvas/Workflow。