4.1 KiB
镜头定位与项目配置 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。
- 用真实 memory router 写恢复、选镜头保留其它参数、切集清旧镜头、外部导航测试;先运行确认缺失功能失败。
- 导出 useShotSelection(currentEpisode: () => number),使用注入 route/router 与独立 ref;写入 router.replace({query: {...route.query, episodeNo: String(currentEpisode()), shotId}}),切集删除 shotId。
- 两个 hook 复用选择;移除生产页重复 route 同步;无效明确 ID 不回退其它镜头。
- 运行定向测试及 Chrome 刷新和地址导航验证。
Task 2: 项目配置弹窗
Files: ProjectLayout.vue、CreativeProfileSettings.vue;新建 ProjectSettingsDialog.vue 与 context.ts(generation-config);调整现有配置消费者。
- 标题栏增加“项目配置”;AppDialog 显示宽高比、图片配置、视频配置,图片与视频左右两列,小屏单列;操作按钮放 footer。
- 保留模型 schema 与现有保存 payload;保存期间 busy 锁关闭;读取和保存捕获原项目及请求归属。
- 注入项目配置 revision,保存后自增;单镜参数和已打开配置查询重新读取;配置错误恢复共用新入口。
- Chrome 打开、滚动、保存相同配置并刷新核对,取消修改不写入。
Task 3: 清理独立刷新图标
Files: 搜索全部 src 下 RefreshCw 的组件。
- 移除只有图标的 NButton(图库同时移除包装 NPopover);保留有文字的刷新操作与错误重试。
- 清理无用图标导入、按钮说明文字,保留仍被操作完成后调用的 refresh 函数。
- 格式化修改文件,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 验证空白创建输入被拦截、失效镜头可从目录恢复,未执行付费模型调用。