sproutclaw-data/agent/skills-disabled/SoftwareCopyright-Skill/生成demo/软件著作权申请资料/草稿/代码文件候选清单.md

# 代码文件候选清单

请先确认要抽取哪些源码文件，再运行代码材料抽取。

本清单只列出候选源码证据，不默认决定抽取文件。
模型需要先理解项目业务、页面入口和源码职责，再填写 `selected/start_line/end_line/model_reason`。
当前已选约 84 页，全部候选源码约 86 页。

```text
STOP_FOR_USER
NEXT_ACTION: 请由模型先填写 草稿/代码文件选择.json 的抽取选择和选择理由，再让用户确认；确认后运行 confirm_stage.py --stage code-selection。
```

确认方式：

1. 模型根据项目业务和代码入口选择最能体现软件功能的文件。
2. 把需要抽取的文件设为 `selected: true`，并填写 `model_reason`。
3. 如只想抽取某个文件中间部分，可填写 `start_line` 和 `end_line`。
4. 用户确认模型选择后，再记录 `code-selection` 门禁。

## 默认选中文件

| 文件 | 行数 | 抽取范围 | 模型选择理由 |
| --- | ---: | --- | --- |
| `frontend/src/app/layout.tsx` | 22 | 1-22 | 前端应用根布局，体现页面框架和全局结构。 |
| `frontend/src/app/page.tsx` | 24 | 1-24 | 系统首页入口，体现 StudioAgent 产品入口和开始创作路径。 |
| `backend/app/agents/compaction.py` | 14 | 1-14 | 上下文压缩服务骨架，体现长对话维护能力。 |
| `backend/app/agents/graph.py` | 187 | 1-187 | LangGraph Swarm 编排核心，体现六 Agent 创建、handoff 和图编译。 |
| `backend/app/agents/session.py` | 25 | 1-25 | 会话生命周期骨架，体现 prompt、resume、steer、abort 等会话控制。 |
| `backend/app/agents/sse_transformer.py` | 111 | 1-111 | Agent 事件到 SSE 协议转换，体现前后端流式协作协议。 |
| `backend/app/agents/state.py` | 82 | 1-82 | 生产状态定义，体现项目计划、角色、场景、剧本、分镜、资产和交互模式。 |
| `backend/app/agents/tools/base.py` | 29 | 1-29 | Agent 工具基类，体现工具定义和执行上下文。 |
| `backend/app/agents/tools/camera_tools.py` | 89 | 1-89 | 摄影工具定义，体现角色、场景、分镜画面生成和图片修改。 |
| `backend/app/agents/tools/candidate.py` | 14 | 1-14 | 候选状态模型，体现候选素材抽卡状态结构。 |
| `backend/app/agents/tools/confirm.py` | 38 | 1-38 | 用户确认工具，体现关键节点中断和人机协同控制。 |
| `backend/app/agents/tools/director_tools.py` | 52 | 1-52 | 导演工具定义，体现分镜生成、镜头规划和视觉一致性审核。 |
| `backend/app/agents/tools/editor_tools.py` | 52 | 1-52 | 剪辑工具定义，体现视频生成、延长和时间线编排。 |
| `backend/app/agents/tools/global_asset_picker.py` | 11 | 1-11 | 全局素材选择工具，体现跨项目素材复用入口。 |
| `backend/app/agents/tools/producer_tools.py` | 97 | 1-97 | Producer 工具定义，体现方案规划、成本估算和项目状态查询。 |
| `backend/app/agents/tools/reference_collector.py` | 29 | 1-29 | 参考图收集工具，体现角色、场景和草图参考素材组织。 |
| `backend/app/agents/tools/screenwriter_tools.py` | 69 | 1-69 | 编剧工具定义，体现文本分析、角色提取、场景提取、剧本生成和编辑。 |
| `backend/app/agents/tools/sound_tools.py` | 60 | 1-60 | 音效工具定义，体现对白分析、语音生成、音效和背景音乐设计。 |
| `backend/app/api/asset_hub.py` | 124 | 1-124 | 全局素材库接口，体现文件夹、全局角色、场景和音色管理。 |
| `backend/app/api/assets.py` | 59 | 1-59 | 项目资产接口，体现角色、场景、剧集、分镜、任务和全局素材复制入口。 |
| `backend/app/api/auth.py` | 43 | 1-43 | 认证接口，体现注册、登录和获取当前用户信息。 |
| `backend/app/api/billing.py` | 23 | 1-23 | 计费接口，体现余额、交易记录和充值入口。 |
| `backend/app/api/candidates.py` | 52 | 1-52 | 候选抽卡接口，体现候选确认、取消、撤回和历史恢复能力。 |
| `backend/app/api/conversations.py` | 153 | 1-153 | 对话接口，体现项目会话创建、消息发送、SSE 流式响应和恢复入口。 |
| `backend/app/api/projects.py` | 65 | 1-65 | 项目接口，体现项目创建、列表、详情、更新和软删除。 |
| `backend/app/config.py` | 72 | 1-72 | 后端配置管理，体现数据库、Redis、LLM 和多媒体生成服务参数。 |
| `backend/app/db/migrations/env.py` | 67 | 1-67 | 数据库迁移环境，体现模型元数据和迁移运行配置。 |
| `backend/app/db/migrations/versions/001_initial_schema.py` | 224 | 1-224 | 初始数据库迁移，体现用户、项目、对话、资产、任务和交易表结构。 |
| `backend/app/db/session.py` | 24 | 1-24 | 数据库连接会话，体现异步数据库访问基础。 |
| `backend/app/deps.py` | 67 | 1-67 | 后端依赖注入，体现数据库会话、当前用户和 Agent 图依赖。 |
| `backend/app/generators/base.py` | 30 | 1-30 | 多媒体生成器抽象接口，体现图像、视频和语音生成统一结构。 |
| `backend/app/generators/image/flux.py` | 11 | 1-11 | FLUX 图片生成器骨架，体现图像生成备选服务接入。 |
| `backend/app/generators/image/imagen.py` | 11 | 1-11 | Imagen 图片生成器骨架，体现图像生成备选服务接入。 |
| `backend/app/generators/image/seedream.py` | 11 | 1-11 | Seedream 图片生成器骨架，体现图像生成服务接入。 |
| `backend/app/generators/video/kling.py` | 11 | 1-11 | Kling 视频生成器骨架，体现视频生成备选服务接入。 |
| `backend/app/generators/video/seedance.py` | 11 | 1-11 | Seedance 视频生成器骨架，体现视频生成服务接入。 |
| `backend/app/generators/video/veo.py` | 11 | 1-11 | Veo 视频生成器骨架，体现视频生成备选服务接入。 |
| `backend/app/generators/voice/elevenlabs.py` | 11 | 1-11 | ElevenLabs 语音生成器骨架，体现英文配音服务接入。 |
| `backend/app/generators/voice/qwen_tts.py` | 11 | 1-11 | Qwen TTS 语音生成器骨架，体现中文配音服务接入。 |
| `backend/app/llm/__init__.py` | 85 | 1-85 | LLM 工厂和模型注册表，体现多 Provider 模型接入。 |
| `backend/app/llm/base.py` | 53 | 1-53 | LLM Provider 抽象接口，体现模型消息和响应结构。 |
| `backend/app/main.py` | 76 | 1-76 | FastAPI 应用入口，体现路由挂载、健康检查和跨域配置。 |
| `backend/app/models/asset.py` | 124 | 1-124 | 资产模型，体现角色、形象、场景、分镜等制片资产结构。 |
| `backend/app/models/conversation.py` | 37 | 1-37 | 对话和消息模型，体现 Agent 消息、推理内容和元数据保存。 |
| `backend/app/models/project.py` | 23 | 1-23 | 项目模型，体现视频项目基本信息和软删除状态。 |
| `backend/app/models/task.py` | 45 | 1-45 | 任务和交易模型，体现异步任务状态和余额流水。 |
| `backend/app/models/user.py` | 27 | 1-27 | 用户模型，体现账号、余额和偏好数据。 |
| `backend/app/schemas/auth.py` | 31 | 1-31 | 认证接口数据结构，体现注册、登录和用户响应字段。 |
| `backend/app/schemas/conversation.py` | 41 | 1-41 | 对话接口数据结构，体现消息发送、恢复和消息响应字段。 |
| `backend/app/schemas/project.py` | 31 | 1-31 | 项目接口数据结构，体现创建、更新和响应字段。 |
| `backend/app/services/auth_service.py` | 46 | 1-46 | 认证服务，体现密码哈希、用户创建、用户查询和令牌生成。 |
| `backend/app/services/conversation_service.py` | 62 | 1-62 | 对话服务，体现会话创建、消息存储和历史查询。 |
| `backend/app/services/project_service.py` | 45 | 1-45 | 项目服务，体现项目创建、查询、更新和软删除业务逻辑。 |
| `backend/app/workers/image_worker.py` | 9 | 1-9 | 图像任务 Worker，体现图像生成异步任务入口。 |
| `backend/app/workers/text_worker.py` | 9 | 1-9 | 文本任务 Worker，体现文本生成异步任务入口。 |
| `backend/app/workers/video_worker.py` | 9 | 1-9 | 视频任务 Worker，体现视频生成异步任务入口。 |
| `backend/app/workers/voice_worker.py` | 9 | 1-9 | 语音任务 Worker，体现配音生成异步任务入口。 |
| `frontend/src/app/(auth)/login/page.tsx` | 88 | 1-88 | 登录页面源码，体现用户身份认证的前端操作流程。 |
| `frontend/src/app/(auth)/register/page.tsx` | 99 | 1-99 | 注册页面源码，体现账号创建和登录状态写入流程。 |
| `frontend/src/app/asset-hub/page.tsx` | 32 | 1-32 | 全局素材库页面，体现素材分类管理入口。 |
| `frontend/src/app/billing/page.tsx` | 8 | 1-8 | 计费管理页面入口，体现成本信息查看功能。 |
| `frontend/src/app/projects/[id]/page.tsx` | 99 | 1-99 | 核心制片工作区页面，体现左侧对话、右侧资产和底部费用状态布局。 |
| `frontend/src/app/projects/[id]/settings/page.tsx` | 8 | 1-8 | 项目设置页面入口，体现单项目配置功能。 |
| `frontend/src/app/projects/page.tsx` | 164 | 1-164 | 项目列表与新建项目页面，体现项目管理主流程。 |
| `frontend/src/app/providers.tsx` | 22 | 1-22 | 前端全局 Provider，体现客户端状态和请求上下文承载。 |
| `frontend/src/app/settings/page.tsx` | 8 | 1-8 | 用户设置页面入口，体现系统配置功能。 |
| `frontend/src/stores/conversation.ts` | 19 | 1-19 | 对话状态管理，体现会话状态数据结构。 |
| `frontend/src/stores/user.ts` | 33 | 1-33 | 用户状态管理，体现登录用户、令牌和余额状态保存。 |
| `frontend/src/components/agent/AgentStatusBar.tsx` | 36 | 1-36 | 多 Agent 状态栏组件，体现制片人、编剧、导演等角色的协作状态展示。 |
| `frontend/src/components/agent/ChatInput.tsx` | 42 | 1-42 | 对话输入组件，体现用户发送自然语言制作需求的交互。 |
| `frontend/src/components/agent/ChatPanel.tsx` | 61 | 1-61 | AI 剧组对话面板，体现消息列表、状态栏和输入区组合。 |
| `frontend/src/components/agent/MessageBubble.tsx` | 71 | 1-71 | 消息气泡组件，体现用户、Agent 和工具结果的展示方式。 |
| `frontend/src/components/assets/AssetPanel.tsx` | 26 | 1-26 | 项目资产面板，体现角色、场景、分镜、视频和音频分类查看。 |
| `frontend/src/components/ui/avatar.tsx` | 109 | 1-109 | 基础头像组件，支撑用户和 Agent 视觉标识展示。 |
| `frontend/src/components/ui/button.tsx` | 64 | 1-64 | 基础按钮组件，支撑注册、登录、创建项目和候选确认等操作。 |
| `frontend/src/components/ui/card.tsx` | 92 | 1-92 | 基础卡片组件，支撑项目、素材和结果信息展示。 |
| `frontend/src/components/ui/input.tsx` | 21 | 1-21 | 基础输入组件，支撑账号、项目等表单输入。 |
| `frontend/src/components/ui/label.tsx` | 24 | 1-24 | 表单标签组件，支撑表单字段说明。 |
| `frontend/src/components/ui/scroll-area.tsx` | 58 | 1-58 | 滚动区域组件，支撑对话和素材列表浏览。 |
| `frontend/src/components/ui/textarea.tsx` | 18 | 1-18 | 基础多行输入组件，支撑项目描述和创意文本输入。 |
| `frontend/src/hooks/useAgentStream.ts` | 216 | 1-216 | SSE 流式对话 Hook，体现消息发送、Agent 事件处理、确认请求和交接状态更新。 |
| `frontend/src/hooks/useCandidateSystem.ts` | 85 | 1-85 | 候选素材状态 Hook，体现候选选择、确认、取消和撤回的前端逻辑。 |
| `frontend/src/lib/api.ts` | 29 | 1-29 | API 客户端封装，体现统一接口请求和鉴权头处理。 |
| `frontend/src/lib/utils.ts` | 6 | 1-6 | 前端样式工具函数，支撑组件类名组合。 |
| `frontend/next.config.ts` | 15 | 1-15 | 前端构建和 API 代理配置，体现前后端联调路径。 |
| `frontend/src/app/globals.css` | 128 | 1-128 | 全局样式，体现 Web 界面的基础视觉与暗色模式样式。 |
| `backend/pyproject.toml` | 74 | 1-74 | 后端依赖和开发工具配置，体现 FastAPI、LangGraph、数据库和测试工具依赖。 |
| `docker-compose.dev.yml` | 19 | 1-19 | 开发环境容器覆写配置，体现本地开发服务启动方式。 |
| `docker-compose.yml` | 124 | 1-124 | 容器编排配置，体现数据库、Redis、后端、Worker 和前端服务组成。 |
| `backend/celery_app.py` | 29 | 1-29 | Celery 任务队列配置，体现图像、视频、语音和文本队列路由。 |
| `frontend/package.json` | 45 | 1-45 | 前端依赖和脚本配置，体现运行、构建和依赖环境。 |
| `frontend/tsconfig.json` | 23 | 1-23 | 前端 TypeScript 配置，体现路径别名和类型检查环境。 |

## 未选候选文件

| 文件 | 行数 | 证据类型 |
| --- | ---: | --- |
| `backend/app/agents/__init__.py` | 1 | 页面文件证据 |
| `backend/app/agents/nodes/__init__.py` | 1 | 页面文件证据 |
| `backend/app/agents/tools/__init__.py` | 1 | 页面文件证据 |
| `backend/app/generators/__init__.py` | 5 | 页面文件证据 |
| `backend/app/models/__init__.py` | 30 | 页面文件证据 |
| `backend/app/schemas/__init__.py` | 1 | 页面文件证据 |
| `backend/app/services/__init__.py` | 1 | 页面文件证据 |
| `backend/app/workers/__init__.py` | 1 | 页面文件证据 |
| `frontend/next-env.d.ts` | 6 | 普通源码文件 |
| `frontend/postcss.config.js` | 5 | 普通源码文件 |
| `backend/tests/__init__.py` | 1 | 补充源码证据 |
| `frontend/components.json` | 23 | 补充源码证据 |