diff --git a/Backend/README.md b/Backend/README.md index bc9769f..0b199fd 100644 --- a/Backend/README.md +++ b/Backend/README.md @@ -4,8 +4,34 @@ LOCAL_PROJECT=/Users/mac/Downloads/dayumedia/dayu-color-beta NAS_ROOT=/Volumes/dayumedia (存储空间1)/wwwroot/dayu_media SOURCE_BACKUP=大鱼调色仓库 Backend/ -映射:wp-content/mu-plugins/dayu-color-beta.php → 同相对路径;wp-content/uploads/dayu-color-beta/updates/beta.json → 同相对路径。发行PKG不进Git,由产品Release及生产公测下载空间保存。部署工作副本仅含本专项文件,源码和脱敏交付记录由产品已有仓库保存。 +映射:`wp-content/mu-plugins/dayu-color-beta.php` 和 `wp-content/uploads/dayu-color-beta/updates/beta.json` 均保持同相对路径。PKG 不进 Git,由产品 Release 与生产公测下载空间保存。专项工作副本只包含本产品文件,源码及脱敏记录保存到产品仓库。参考 `fcpx-qwen3-asr` 提交 `113069c74aff935db2082b5bcd8e1aa47fe1fbf2` 的更新校验、批次诊断和崩溃脱敏流程;共享会员鉴权代码未修改。 -2026-11-02盘点:目标MU插件不存在;本地工作目录新建,无未部署改动。生产共享已确认来自192.168.31.21、dayumedia (存储空间1)、smbfs且可读写。仅操作本产品命名空间,不改共享鉴权插件或其他APP。参考fcpx-qwen3-asr提交113069c74aff935db2082b5bcd8e1aa47fe1fbf2的更新校验、分批诊断与崩溃脱敏流程。 +2026-11-02 初始盘点:目标 MU 插件不存在,本地专项工程新建。实际共享已确认来自 192.168.31.21、dayumedia (存储空间1)、smbfs 且可读写。单独建仓因令牌缺少 write:user 返回403,未扩大权限;改用现有产品仓库保存。 -修改/部署前按NAS规则旁路备份并校验;新增文件无需备份不存在的原件。用户已授权公测更新与日志,暂不引入登录授权。新建单独仓库因现有令牌缺少write:user而403,未建库、未扩大权限;使用已有产品仓库保存。 +## 路由与查看 + +- 更新:`GET https://dayu.media/wp-json/dayu-color/v1/update?bundle_id=com.dayu.color&channel=beta¤t_build=45`。仅提供更高构建号的完整 PKG 更新,无强制安装。 +- 诊断:`POST https://dayu.media/wp-json/dayu-color/v1/diagnostics`,公测阶段不依赖账号。严格限定产品、字段、事件、UUID、批次大小及频率;匿名输入只作为排查证据,不作为授权凭据。 +- 日志后台:`https://dayu.media/wp-admin/tools.php?page=dayu-color-beta`,需要管理员。可按构建号、事件、完整报告标识筛选并翻页。GET 诊断接口同样要求 manage_options。 +- 数据保留30天,由 WordPress 每日计划清理;依赖站点 WP-Cron 正常运行。IP 仅用于短期频控哈希,不存入诊断表。 + +## 客户端 + +主 APP 检查更新与插件注册并行,检查结束且注册成功后显示3秒退出倒计时。发现更新则保留窗口;下载可取消,校验 SHA-256、字节数、Installer/App签名团队、Gatekeeper、包内 Bundle ID、版本、安装位置及模板。保存并退出 FCP/Motion 后打开系统安装器,不强杀宿主。下一次启动可记录已完成升级。 + +主 APP 与 XPC 共享随机安装标识及诊断开关。诊断默认开启,界面明确说明并可关闭;不上传素材、LUT、预设、用户路径、账号、硬件 UUID 或原始崩溃文件。后台私有队列最多256条/384KB,批次16条,网络超时并延迟重试,服务端按事件 UUID 去重。关闭后清除待发摘要并停止新请求;已经送达的数据按保留期清理。 + +采集进程启动、初始化、检查器创建/慢刷新、Metal 管线准备、首次渲染、渲染错误、超过6秒的疑似阻塞,以及本插件近7天系统崩溃报告的脱敏摘要。疑似阻塞不等于根因;整个进程被停止、网络不可用、主机强制断电时无法保证即时送达。不会拦截崩溃信号,也不采集整个 FCP 的报告。本轮保留调色与宿主回调逻辑,尚未修复偶发卡死。 + +## 验证与发布 + +```sh +php Backend/tests/contract.php +python3 Backend/verify_live.py +python3 Backend/deploy.py --backend +python3 Backend/deploy.py --package '/Volumes/备份/大鱼调色/发行包/大鱼调色-1.7.0.pkg' +``` + +先从仓库审查、提交并推送,再由部署脚本同步到专项工程;脚本验证实际 SMB 挂载及基线。覆盖原文件前同目录旁路备份并核对字节,新增文件无需不存在的备份。只写明确列出的路径,不加载或输出生产配置。更新包签名、公证、票据与正式 APP 验收通过后才发布;同名包不同字节立即停止。发布后完整下载核对大小与 SHA-256,并核验较低/相同构建号的更新结果。 + +回滚:先备份当前文件,再恢复部署记录中对应旁路备份;禁止降低已有清单构建号来自动降级。撤下更新时备份并移走 beta.json,更新路由回到没有更新;历史安装包和诊断表保留。源代码可从产品远程仓库恢复,签名私钥及服务端数据库不属于 Git 备份。