使用文档区管理项目文档与长期上下文
文档区用于管理项目里的长期上下文。它和媒体空间、剪辑时间线一起构成 Flova 工作台:媒体空间管理素材,剪辑时间线管理成片剪辑工程,文档区则管理那些需要被用户和 Agent 持续记住、反复引用和不断更新的信息。
在复杂视频项目中,Flova Agent 通常会默认维护两个核心文档:Final Video Spec 和 Skill。它们不是你必须手动使用的功能,但能帮助 Agent 更稳定地理解项目目标、视频结构、风格规则和执行偏好。除此之外,如果你希望更多资料被项目长期记忆,也可以上传文档、自己新建文档,或者让 Agent 新建和修改文档。
查看项目文档
文档区左侧可以切换不同文档。常见的文档包括:
- Final Video Spec:记录最终视频的目标、结构、风格、分镜和交付要求。
- Skill:记录项目执行时需要遵循的方法、规则和偏好。
- 自建文档:你或 Agent 新建的项目文档,适合保存品牌规则、角色设定、参考资料整理、待办说明等需要长期保留的信息。
- 上传文档:你从本地上传的参考资料,可以被项目引用和 Agent 理解,但原始上传文档本身不能直接编辑。
你可以在易读视图和 Markdown 视图之间切换。易读视图适合快速阅读和检查内容,Markdown 视图适合查看或编辑更具体的原文结构。
新建和上传文档
如果你想让一段资料长期保留在项目里,可以直接新建文档。新建文档是可编辑的,适合记录你希望 Agent 后续持续参考的背景信息、规则、想法或阶段性结论。
如果你已经有现成文件,也可以上传到项目里。上传文档适合作为参考资料长期放在项目上下文中,例如剧本文件、品牌手册、脚本资料、客户 brief 等。上传文档可以查看、引用、删除或下载,但不能直接改写原文件内容;如果你想基于上传内容整理出一版可编辑资料,可以让 Agent 帮你新建一个项目文档。
你也可以直接在右侧对话区告诉 Agent 新建或修改文档,例如让它把一段讨论整理成项目规则,或把某份上传资料提炼成长期参考文档。
编辑项目文档
可编辑文档可以直接在文档区修改。保存后,Agent 会基于当前项目文档和项目状态继续工作。
不同类型的文档编辑方式会略有区别:
- Final Video Spec 和自建文档更接近普通 Markdown 文档,适合直接修改文字、结构和规则。
- Skill 会按结构化区域展示,适合逐段检查和调整 Agent 的执行规则。Skill 文档还可以保存为你的 Skill,方便后续复用。
- 上传文档 是只读参考资料,不能直接编辑。
如果只是补充一条明确规则、修正文档里的小错误,直接手动编辑通常更快;如果需要重写、合并或重新组织大段内容,也可以让 Agent 先修改,再由你 review。
将文档内容加入对话
阅读文档时,你可以选中文档中的一段内容并添加到右侧对话区。这样 Agent 会知道你具体指的是哪份文档里的哪段内容,适合让它基于某段规则继续修改、解释、总结或执行。
例如,你可以选中 Final Video Spec 里关于画面风格的一段,让 Agent 根据这段要求重新调整某个镜头;也可以选中自建文档里的品牌规则,让 Agent 检查当前素材是否符合要求。
使用建议
- 项目越复杂,越建议把关键规则和长期信息沉淀到文档里,而不是只留在一次性的对话中。
- 明确的小改动可以直接手动编辑;涉及大范围整理、改写或提炼时,可以让 Agent 先处理。
- 上传文档适合作为只读参考;需要持续维护的内容,建议整理成可编辑的项目文档。
- 修改 Skill 或 Final Video Spec 前,先确认你正在编辑的是当前希望保留的项目版本。