6.2 KiB
6.2 KiB
大鱼调色开发交接
更新于 2026-11-05(Asia/Shanghai)。这是新对话的接手入口。历史设计和实现细节按需查阅专项交接,复现和交付证据以对应版本的报告为准。
当前基线
| 项目 | 已核对状态 |
|---|---|
| 工程与源码 | /Volumes/备份/大鱼调色/大鱼调色,大鱼调色.xcodeproj,Wrapper Application / Release。远程为 https://dayu.media/git/dayu/dayu-color.git,分支 main。整理本交接前的远端节点为 bbb258e495998274ae486a41c6dd4e65a0aec093。 |
| 本机正式安装 | 1.12.1(81),/Library/Plug-Ins/FxPlug/大鱼调色.app。外层 ID com.dayu.color,服务 ID com.dayu.color.XPC。实际编译源码 43320c7ccdfc6738ba3c380888bb7f3ea75ebb87。 |
| Git Release | 1.12.1(81),标签 v1.12.1-canvas-inspector-20261105 指向 9f0adbeb3b1b902b66ac4be7169b919f82675f21。签名公证 PKG 已发布为公测,草稿和正式附件均完成完整下载校验。本地包位于 /Volumes/备份/大鱼调色/发行包/大鱼调色-1.12.1.pkg。发布页 · 发布核验 |
| 站点及自动更新 | 本次交接回读时,原文章与主 APP 公测通道均为 1.12.0(79)。主 APP 启动时自动检查,发现新版后由用户确认下载和安装。原文章 · 文章核验 · 更新通道核验 |
| 本机开发与验收 | AppKit / Objective-C++ / FxPlug 4 / Metal,Apple Silicon,macOS 14.6+。交付记录使用 Xcode 27.1、FxPlug SDK 4.3.5 和 FCP 12.4。构建缓存为 /Users/mac/Library/Caches/CodexBuilds/com.dayu.color,验收素材库位于其中的 fcp-qa/大鱼调色_验收.fcpbundle。产品交付锁为 /Users/mac/.codex/app-delivery-locks/com.dayu.color.lock,接手时重新检查。 |
1.12.1 已完成
- 检视器以紧凑高度打开,顶部按钮固定在参数滚动区外。80 版在接入宿主后强改视图高度,造成顶部裁切。81 版由 FCP 管理已挂载视图的空间,超出可用高度的模块在参数区内滚动。
- 画布工具栏与曲线默认在右下。曲线顶部手柄可移动面板。松手后保留最终点位,等宿主写回后接续正式参数;保留时间和图层校验及一次手势一次撤销。
- 画布与检视器的曲线直方图取样自当前效果的输出。画布按显示帧匹配,检视器接收效果输出更新。曲线直方图与工作区四宫格示波器各有显示用途,继续沿用各自的取样和色彩说明。
- 画布新增白平衡吸管,复用基础调整的求解和参数写入;畸变修复使用枕形网格图标。独立图层被宿主拒绝写入时增加本机诊断
dayu_tool_save_rejected。
接手时的代码入口
下表中的文件位于 大鱼调色/Plugin/。
| 范围 | 入口 |
|---|---|
| 检视器高度、滚动和曲线刷新 | DYInspector.mm 的 layout、curveOutputChanged: |
| 画布工具、曲线拖动和写回 | DYViewerControls.inc.h、DYViewerParameterPanel.inc.h、DYViewerParameterBridge.inc.h |
| 效果输出取样与直方图 | DYScopeCapture.inc.h、DYScopeSample.mm、DYHistogram.h |
| 画布白平衡与宿主写入诊断 | DYPlugIn.mm、DYColorTables.h、DYToolState.mm |
| 工作区、共享蒙版与跟踪 | DYColorWorkspace.mm、DYToolState.mm、DYToolOSC.inc.h。共享蒙版以工具文档 schema 3 为编辑源,渲染展开副本只用于渲染。工作区与跟踪专项交接 |
验收与待跟进
- 正式 81 版通过 844 项原生检查。FCP 12.4 冷重开后,检视器顶部完整显示,曲线读到 57,600 个输出样本,原调色参数成功读回。同帧输出变更和检视器直方图刷新已通过原生检查。用户手动确认的是 80 版的画布曲线和实时直方图。宿主验收
- 画布白平衡待实机复核。 已验证取样入口分发、播放头改变后的写入保护、白平衡求解、色温和色调写入及一次撤销。下一次实机验收补做系统取样界面的点选和取消,核对取样后色温与色调的实际变化。宿主验收范围
- 第三方 FCP 保存告警待反馈。 本机内置 APFS 验收库未复现,退出重开读回正常。收到报错前的操作、时间、FCP 和插件版本、素材库位置后,再区分卷写入故障、素材库异常与特定插件写入触发;先保护原库与备份,复现在独立验收库进行。保存告警排查
- 站点文章和自动更新通道与 Git Release 是独立交付。后续若要将站点或更新通道升到 81,按发布任务核对现有线上版本、正式安装包和生产回滚记录。更新部署说明
继续工作
- 核对
git status --short --branch、远端引用、正式安装版本与交付锁。先在独立 FCP 验收库重现用户本轮指定的问题,保留原工程和既有参数语义。 - 代码变更按 RECOVERY.md 恢复和验收。常用入口为
tools/checkpoint.py、tools/deliver.py与Packaging/build_pkg.py;交付脚本等待宿主验收时,通过后才输入complete。 - 按 AGENTS.md 在结束前更新本文并提交、推送、回读。
可复制到新对话:
在
/Volumes/备份/大鱼调色/大鱼调色继续优化大鱼调色。先读项目AGENTS.md和开发交接.md,以核实后的正式安装和验收记录为基线,按我接下来指定的内容修改。完成后更新交接文档。
任务记录
| 日期 | 任务 | 结果与接续 |
|---|---|---|
| 2026-11-05 | 检视器、画布控件与保存告警排查 | 81 版正式安装并发布。80 版的画布反馈已复核,81 版修复检视器裁切与直方图刷新。剩余实机取样和第三方告警见上。 |
| 2026-11-05 | 建立每次任务的交接流程 | 新建本入口及项目规则,为历史专项交接加指引。回读核对了正式安装 81、远程版本标签、站点文章及公测通道 79。本轮成果为项目文档。 |