feat: 导出 SproutClaw .sproutclaw 配置
包含 extensions、skills、prompts、settings、auth、models、mcp 等配置。 排除 node_modules、npm 缓存、sessions 等运行时数据。
This commit is contained in:
@@ -0,0 +1,93 @@
|
||||
# 业务理解
|
||||
|
||||
- 软件名称:StudioAgent
|
||||
- 产品定位:StudioAgent 是面向视频内容创作场景的多智能体 AI 制片平台。用户通过自然语言描述创意、故事或制作目标,系统以 Producer 为中枢协调编剧、导演、摄影、剪辑和音效等专业 Agent,辅助完成从创意沟通、方案规划、剧本分解、分镜设计到图像、视频、音频素材生产的制片流程。
|
||||
- 面向领域 / 行业:数字内容创作 / AI 视频制作 / 智能媒体生产
|
||||
- 核心价值:StudioAgent 将原本分散在文案、分镜、图像、视频和音频工具中的制作步骤整合到一个对话式工作区中,由多 Agent 按项目状态协作推进,并在关键节点保留用户确认、候选选择和撤回能力,降低非专业用户完成视频创意制作的组织成本。
|
||||
- 证据文件:`业务理解证据.md`
|
||||
|
||||
## 目标用户
|
||||
|
||||
- 小说作者、IP 作者等希望把文字内容视觉化的创作者
|
||||
- 短视频创作者、MCN 或自媒体团队
|
||||
- 影视从业者、动画预览和概念片制作人员
|
||||
- 企业市场部、品牌宣传和活动视频制作人员
|
||||
- 需要统一管理角色、场景、分镜、视频和音频资产的内容团队
|
||||
|
||||
## 主要业务功能
|
||||
|
||||
- 用户账号注册与登录
|
||||
- 项目创建与项目列表管理
|
||||
- 对话式 AI 制片工作区
|
||||
- 多 Agent 协作状态展示
|
||||
- 项目资产分类查看
|
||||
- 候选素材选择与撤回
|
||||
- 全局素材库管理
|
||||
- 项目成本与计费信息展示
|
||||
|
||||
## 功能说明
|
||||
|
||||
- 用户账号注册与登录:系统提供注册、登录和当前用户信息获取入口。用户填写邮箱、密码和昵称后可创建账号,登录后系统保存访问令牌,并把用户带入项目列表页面,后续项目、对话和素材操作均以用户身份为基础。
|
||||
- 项目创建与项目列表管理:用户进入“我的项目”页面后可以查看已有项目,并通过“新建项目”填写项目名称和描述。项目创建成功后进入对应工作区,项目列表以卡片方式展示标题、描述、风格和创建日期,便于用户区分不同视频制作任务。
|
||||
- 对话式 AI 制片工作区:项目工作区采用左侧对话、右侧资产的双面板结构。用户在对话框中输入想制作的视频内容或修改意见,系统通过流式事件返回 Agent 回复、工具调用和任务结果,让用户在同一界面持续推进创作。
|
||||
- 多 Agent 协作状态展示:系统围绕 Producer、Screenwriter、Director、Camera、Editor 和 Sound 六类角色组织制作任务。前端通过 Agent 状态栏展示当前工作中的 Agent 和交接状态,后端以 LangGraph Swarm、会话状态和 handoff 机制支撑不同 Agent 之间的协作。
|
||||
- 项目资产分类查看:工作区右侧资产面板按角色、场景、分镜、视频和音频分组展示项目产物。随着创作过程推进,角色设定、场景素材、分镜画面、视频片段和音频内容可以沉淀到项目资产区,用户可在制作过程中查看和管理。
|
||||
- 候选素材选择与撤回:项目包含候选抽卡状态管理和后端候选接口设计。图片、场景、分镜等媒体生成结果可以提供多张候选,用户选择满意项后确认持久化,也可以取消候选或撤回到上一版本,便于对视觉结果进行比较和修正。
|
||||
- 全局素材库管理:系统提供全局素材库页面和接口骨架,用于管理文件夹、全局角色、场景和音色。用户可在素材库中创建、筛选和复用常用资产,并将全局资产深拷贝到具体项目中,减少重复制作。
|
||||
- 项目成本与计费信息展示:工作区底部显示余额、本项目消耗和当前模型,计费页面保留余额与交易记录入口。该功能用于让用户了解 AI 生成过程中的费用状态,并为后续按模型、任务和素材生成量统计成本提供界面基础。
|
||||
|
||||
## 典型操作流程
|
||||
|
||||
1. 用户从首页进入系统,选择注册或登录,完成身份认证后进入项目列表。
|
||||
2. 用户在“我的项目”页面查看已有项目,或填写项目名称和描述创建新的视频制作项目。
|
||||
3. 系统打开项目工作区,左侧显示 AI 剧组对话面板,右侧显示项目资产面板,底部展示余额、项目消耗和当前模型。
|
||||
4. 用户在对话输入框描述创意、故事文本、广告目标或局部修改要求,Producer 根据项目状态规划下一步制作动作。
|
||||
5. 系统以流式消息展示 Agent 回复、工具调用和 Agent 间交接状态,用户可观察当前由哪个 Agent 处理任务。
|
||||
6. 制作过程中形成的角色、场景、分镜、视频和音频内容进入项目资产面板,用户按分类查看产物。
|
||||
7. 当系统生成多个候选素材时,用户选择满意候选并确认,也可以取消候选或撤回到上一版本。
|
||||
8. 用户可进入全局素材库管理常用角色、场景和音色,并在项目中复用已有资产。
|
||||
9. 用户通过计费页面或工作区底部查看余额和项目消耗,根据成本情况继续生成、调整或暂停制作。
|
||||
|
||||
## 操作手册结构建议
|
||||
|
||||
1. 软件概述:说明 StudioAgent 的用途、面向对象和整体制片流程,让审核员先理解软件解决的视频创作问题。
|
||||
2. 运行环境与进入方式:说明软件作为 Web 系统的访问方式、账号使用方式和基础运行要求。
|
||||
3. 账号注册和登录:覆盖当前代码中的注册、登录和用户身份获取流程。
|
||||
4. 项目管理:覆盖项目列表、新建项目、进入项目工作区等核心入口。
|
||||
5. AI 制片工作区:重点说明左侧对话、右侧资产和底部状态栏组成的核心业务页面。
|
||||
6. 项目资产和候选素材处理:说明角色、场景、分镜、视频、音频等资产分类,以及候选选择、确认、取消和撤回的操作结果。
|
||||
7. 全局素材库:说明全局角色、场景、音色和文件夹管理入口,以及素材复用到项目的用途。
|
||||
8. 计费与成本查看:说明工作区底部和计费页面展示余额、项目消耗和模型信息的用途。
|
||||
9. 典型使用流程:把注册登录、创建项目、对话制作、查看资产、选择候选和查看成本串成审核员能理解的完整流程。
|
||||
10. 使用注意事项:说明账号、项目素材、模型服务、费用和网络环境等使用注意点。
|
||||
|
||||
## 申请表建议口径
|
||||
|
||||
- 开发目的:本软件用于辅助视频内容创作者以自然语言方式组织 AI 视频制作流程,把创意描述、剧本分析、分镜规划、视觉素材生成、视频片段生成、配音和音效设计等环节纳入统一项目工作区,帮助用户管理制作过程、素材资产和成本信息。
|
||||
- 软件的主要功能:软件主要包括用户注册登录、项目创建和管理、对话式 AI 制片、六类 Agent 协作状态展示、项目资产分类查看、候选素材选择与撤回、全局素材库管理、计费与成本信息展示等功能。
|
||||
- 技术特点:软件采用前后端分离的 Web 应用架构,前端基于 Next.js、React、TypeScript 和 Tailwind CSS 构建项目列表、对话工作区和资产面板;后端基于 FastAPI、SQLAlchemy、LangGraph Swarm 和 Celery 组织 REST 接口、SSE 流式对话、多 Agent 编排、异步生成任务和数据库持久化;系统预留 PostgreSQL、Redis、多模型 LLM、图像、视频和语音生成服务接入能力,并通过候选状态、项目资产和全局素材库支持内容生产结果的管理。
|
||||
- 软件的技术特点选项:应用软件
|
||||
- 软件分类:应用软件
|
||||
|
||||
## 证据来源
|
||||
|
||||
- `CLAUDE.md`
|
||||
- `README.md`
|
||||
- `docs/ARCHITECTURE_AND_PLAN.md`
|
||||
- `docs/STUDIO_AGENT_PRD.md`
|
||||
- `backend/app/llm/prompts/camera.md`
|
||||
- `backend/app/llm/prompts/director.md`
|
||||
- `backend/app/llm/prompts/editor.md`
|
||||
- `backend/app/llm/prompts/producer.md`
|
||||
- `backend/app/llm/prompts/screenwriter.md`
|
||||
- `backend/app/llm/prompts/sound.md`
|
||||
|
||||
## 待确认
|
||||
|
||||
- 请确认模型判断的行业领域、目标用户和主要功能是否符合实际申报口径。
|
||||
- 请确认操作手册结构是否适合当前项目,而不是套用范本文档。
|
||||
|
||||
```text
|
||||
STOP_FOR_USER
|
||||
NEXT_ACTION: 请确认 草稿/业务理解.md 中的软件用途、行业、目标用户、核心功能、手册结构和申请口径;确认后运行 confirm_stage.py --stage business。
|
||||
```
|
||||
Reference in New Issue
Block a user