Add project handoff and require updates after every task
这个提交包含在:
1 父节点
bbb258e495
当前提交
504e08e425
5 个文件已更改
+77
没有与搜索条件相匹配的文件
@@ -0,0 +1,15 @@
|
||||
# 大鱼调色项目规则
|
||||
|
||||
本文件适用于当前 Git 仓库及其子目录。沿用本机全局开发、正式交付和 Git 备份约定。
|
||||
|
||||
## 接手
|
||||
|
||||
- 新对话先读 [开发交接.md](开发交接.md) 的当前基线和待跟进事项。核对实际工作区、分支、远端、正式安装版本和交付锁,再依据用户本轮要求继续。
|
||||
- 按范围查阅专项交接、`verification/` 和 [RECOVERY.md](RECOVERY.md)。旧版本文档用于查找历史,当前状态以实际结果和对应版本的验证记录为准。
|
||||
|
||||
## 每次任务结束都要更新交接
|
||||
|
||||
- 无论本轮是开发、排查、发布、纯文档工作,还是暂时受阻,结束前都在 [开发交接.md](开发交接.md) 记录本轮工作。更新受影响的当前基线和待跟进事项,保留前序任务记录。
|
||||
- 写清任务日期与目标、实际完成的改动和关键路径、验证结果及覆盖范围、交付状态,以及仍待处理的事项和接手第一步。涉及发行时分别标明实际编译提交、版本标签、本机安装、Git Release、站点文章和主 APP 更新通道,注明对应版本和核验依据。
|
||||
- 区分本机实测、用户确认、自动检查与尚待复现的反馈。保留有助于继续排查的限制、假设和阻塞,引用已有报告。凭据、用户素材和未脱敏日志留在各自受控位置。
|
||||
- 在本轮结束前按 Git 约定提交交接文档,推送并回读远端。最后回复附上交接入口;远端核验受阻时注明本地提交与具体原因。
|
||||
@@ -1,5 +1,7 @@
|
||||
# 2026-11-04 画布工具与辅助工作区:1.10.0(72)验收完成
|
||||
|
||||
> 当前工程、正式版本和下一步见 [开发交接.md](开发交接.md)。本文件保留历史 FxPlug 交付和技术记录。
|
||||
|
||||
下一阶段完善自定控件,先读[自定控件开发交接](/Volumes/备份/大鱼调色/大鱼调色/自定控件开发交接.md)。该文件集中说明当前代码、尚未补齐的专用图形和后续验证方式;本文件保留完整产品交付与历史。
|
||||
|
||||
当前正式安装 **1.10.0(72)**,固定位置 `/Library/Plug-Ins/FxPlug/大鱼调色.app`,主 Bundle ID `com.dayu.color`,XPC `com.dayu.color.XPC`。实际编译源码 `80dec904bedf5f704b29d16325fa95d639f3a250`;Developer ID 团队 B3W25FX5H5,APP 公证 `c0209032-38d2-4434-8e37-7f911414c3c6` Accepted。票据、Gatekeeper、唯一 PluginKit 正式路径、正式安装的 **695 项原生检查**与用户实鼠验收通过。
|
||||
|
||||
@@ -1,3 +1,5 @@
|
||||
> 当前主 APP、本机安装与公测通道版本见 [开发交接.md](开发交接.md)。本文件保留主 APP 的历史交付与设计记录。
|
||||
|
||||
> 2026-11-02 更新:主 APP 已交付 1.7.0(45)公测。自动更新和云端诊断已经接入,当前实现与部署/隐私/回滚说明见 [Backend/README.md](Backend/README.md),发行与验证见 [Packaging/Release-1.7.0.md](Packaging/Release-1.7.0.md) 和 [verification/BetaClientQA.json](verification/BetaClientQA.json)。下方原始交接保留作背景;登录、授权和业务加密仍未实施,不能把原规划当成已完成状态。
|
||||
|
||||
# 大鱼调色主 APP 开发交接
|
||||
|
||||
@@ -0,0 +1,56 @@
|
||||
# 大鱼调色开发交接
|
||||
|
||||
更新于 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`。[发布页](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.12.1-canvas-inspector-20261105) · [发布核验](verification/Release.json) |
|
||||
| 站点及自动更新 | 本次交接回读时,原文章与主 APP 公测通道均为 **1.12.0(79)**。主 APP 启动时自动检查,发现新版后由用户确认下载和安装。[原文章](https://dayu.media/15792/) · [文章核验](verification/Article1.12.0.json) · [更新通道核验](verification/BetaPublication1.12.0.json) |
|
||||
| 本机开发与验收 | 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 为编辑源,渲染展开副本只用于渲染。[工作区与跟踪专项交接](自定控件开发交接.md) |
|
||||
|
||||
## 验收与待跟进
|
||||
|
||||
- 正式 81 版通过 844 项原生检查。FCP 12.4 冷重开后,检视器顶部完整显示,曲线读到 57,600 个输出样本,原调色参数成功读回。同帧输出变更和检视器直方图刷新已通过原生检查。用户手动确认的是 80 版的画布曲线和实时直方图。[宿主验收](verification/HostCanvasInspector1.12.1.json)
|
||||
- **画布白平衡待实机复核。** 已验证取样入口分发、播放头改变后的写入保护、白平衡求解、色温和色调写入及一次撤销。下一次实机验收补做系统取样界面的点选和取消,核对取样后色温与色调的实际变化。[宿主验收范围](verification/HostCanvasInspector1.12.1.json)
|
||||
- **第三方 FCP 保存告警待反馈。** 本机内置 APFS 验收库未复现,退出重开读回正常。收到报错前的操作、时间、FCP 和插件版本、素材库位置后,再区分卷写入故障、素材库异常与特定插件写入触发;先保护原库与备份,复现在独立验收库进行。[保存告警排查](research/FinalCutSaveFailure-20261105.md)
|
||||
- 站点文章和自动更新通道与 Git Release 是独立交付。后续若要将站点或更新通道升到 81,按发布任务核对现有线上版本、正式安装包和生产回滚记录。[更新部署说明](Backend/README.md)
|
||||
|
||||
## 继续工作
|
||||
|
||||
1. 核对 `git status --short --branch`、远端引用、正式安装版本与交付锁。先在独立 FCP 验收库重现用户本轮指定的问题,保留原工程和既有参数语义。
|
||||
2. 代码变更按 [RECOVERY.md](RECOVERY.md) 恢复和验收。常用入口为 `tools/checkpoint.py`、`tools/deliver.py` 与 `Packaging/build_pkg.py`;交付脚本等待宿主验收时,通过后才输入 `complete`。
|
||||
3. 按 [AGENTS.md](AGENTS.md) 在结束前更新本文并提交、推送、回读。
|
||||
|
||||
可复制到新对话:
|
||||
|
||||
> 在 `/Volumes/备份/大鱼调色/大鱼调色` 继续优化大鱼调色。先读项目 `AGENTS.md` 和 `开发交接.md`,以核实后的正式安装和验收记录为基线,按我接下来指定的内容修改。完成后更新交接文档。
|
||||
|
||||
## 任务记录
|
||||
|
||||
| 日期 | 任务 | 结果与接续 |
|
||||
| --- | --- | --- |
|
||||
| 2026-11-05 | 检视器、画布控件与保存告警排查 | 81 版正式安装并发布。80 版的画布反馈已复核,81 版修复检视器裁切与直方图刷新。剩余实机取样和第三方告警见上。 |
|
||||
| 2026-11-05 | 建立每次任务的交接流程 | 新建本入口及项目规则,为历史专项交接加指引。回读核对了正式安装 81、远程版本标签、站点文章及公测通道 79。本轮成果为项目文档。 |
|
||||
+2
@@ -1,5 +1,7 @@
|
||||
# 大鱼调色自定控件开发交接
|
||||
|
||||
> 当前正式版本、最新控件行为和待验收事项见 [开发交接.md](开发交接.md)。下文保留 1.12.0 及更早版本的实现与研究记录。
|
||||
|
||||
更新日期:2026-11-05,Asia/Shanghai。
|
||||
|
||||
当前正式安装为 **1.12.0(79)统一工作区与共享蒙版**,编译源码beccf2fc01f8dc06c5d3d505f88289885d209bc8,834项正式原生检查及本轮FCP反馈验收通过。实际交付进度以 `verification/Delivery.json`、`HostFeedback78.json`、`HostFeedback79.json`、`Package.json`、`Release.json` 为准;正式安装包签名、公证、20项验包、Release389草稿与发布后完整下载校验均完成。新增最近LUT快捷缩略图与左下横排画布图标,肤色线、片尾时间修复和真实跟踪误差见research/WorkspaceFeedback-20261105.md。
|
||||
|
||||
在新工单中引用
屏蔽一个用户