Files
short-drama-agent-front/docs/superpowers/plans/2026-10-08-shot-selection-project-settings.md
T

54 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 镜头定位与项目配置 Implementation Plan
> **For agentic workers:** 本次在当前 worktree 内逐项执行,保持用户已确认的范围。
**Goal:** 刷新后恢复镜头,清理独立刷新按钮,统一项目配置入口。
**Architecture:** 共享地址同步 composable 接入两个现有页面查询。ProjectLayout 打开 AppDialog 并复用 CreativeProfileSettings,配置修订通过项目注入上下文通知消费者。
**Tech Stack:** Vue 3、TypeScript、Vue Router、Naive UI、Tailwind。
## Global Constraints
- 全部新增/修改函数、类型、响应式声明和页面模块写中文注释。
- 页面和功能在本地 Chrome 的 localhost:4314 验证,不使用 Playwright。
- 用户未要求本次提交,不提交、不推送;不执行付费生成。
### Task 1: 地址保存镜头选择
Files: 新建 src/features/storyboard/useShotSelection.ts;修改 useStoryboard.ts、useProduction.ts、ProductionPage.vue;新增 tests/features/storyboard/shot-selection.test.ts。
- [x] 用真实 memory router 写恢复、选镜头保留其它参数、切集清旧镜头、外部导航测试;先运行确认缺失功能失败。
- [x] 导出 useShotSelection(currentEpisode: () => number),使用注入 route/router 与独立 ref;写入 router.replace({query: {...route.query, episodeNo: String(currentEpisode()), shotId}}),切集删除 shotId。
- [x] 两个 hook 复用选择;移除生产页重复 route 同步;无效明确 ID 不回退其它镜头。
- [x] 运行定向测试及 Chrome 刷新和地址导航验证。
### Task 2: 项目配置弹窗
Files: ProjectLayout.vue、CreativeProfileSettings.vue;新建 ProjectSettingsDialog.vue 与 context.ts(generation-config);调整现有配置消费者。
- [x] 标题栏增加“项目配置”;AppDialog 显示宽高比、图片配置、视频配置,图片与视频左右两列,小屏单列;操作按钮放 footer。
- [x] 保留模型 schema 与现有保存 payload;保存期间 busy 锁关闭;读取和保存捕获原项目及请求归属。
- [x] 注入项目配置 revision,保存后自增;单镜参数和已打开配置查询重新读取;配置错误恢复共用新入口。
- [x] Chrome 打开、滚动、保存相同配置并刷新核对,取消修改不写入。
### Task 3: 清理独立刷新图标
Files: 搜索全部 src 下 RefreshCw 的组件。
- [x] 移除只有图标的 NButton(图库同时移除包装 NPopover);保留有文字的刷新操作与错误重试。
- [x] 清理无用图标导入、按钮说明文字,保留仍被操作完成后调用的 refresh 函数。
- [x] 格式化修改文件,lint、类型检查、构建;Chrome 核对各页面,检视地址恢复和配置弹窗。
用户后续调整:项目配置弹窗改为图片、视频左右布局,操作按钮放在 footer;保存草稿原样保留实际项目参数。
验收记录:Chrome 在 localhost:4314 验证分镜与生产选择刷新恢复、配置左右布局、footer 按钮、标题下 description slot、2px 间距、有效参数启用保存和取消草稿隔离;其它页面独立刷新图标已删除。49 项定向检查通过,类型、lint 与构建通过;全量检查的既有失败已在交付前同步修正并全部通过。
现有守株待兔项目配置 size=1080*1920 已被当前后端目录拒绝,真实保存验证得到该错误;表单保留原值并先提示校验问题。未写入替代尺寸,也未执行付费模型调用。
用户最新要求:新增与本次调整的布局、间距和文字样式优先直接使用 Tailwind utility class,减少自定义 class。
## 本次交付检查
用户明确要求提交、合并 dev、检查无错误后推送。完整 pnpm check 已通过:44 个测试文件、349 项测试全部通过,lint、格式与类型检查通过;build 通过。同步了旧参数 schema、202 执行句柄、readiness 门禁和 Modal 测试契约,并排除其它 worktree 的重复测试。修复新建 footer 校验、图库配置修订更新、失效镜头正文提示及内嵌配置操作锁。Chrome 验证空白创建输入被拦截、失效镜头可从目录恢复,未执行付费模型调用。