@uzooai/anime-ai-cli 0.0.0-stage → 0.5.0

package/.agents/skills/uzoo-anime-cli/references/repaint-workflow.md

@@ -0,0 +1,300 @@
+# 视频分段与派生画布链
+
+**暂停状态（2026-10-31，用户明确决定）**：转绘将重新设计，CLI转绘开发及专项真实补验暂停。下文为旧实现/测试记录，不是执行队列。保留所有代码、operation、归档及结果；不得自动提交分析、切片、提示词、生成、上传/设置、批量/多段或恢复画布写入。仅在用户明确提出原结果查询/下载或必要排障时按该范围操作；不能据此继续新任务。原6.385秒素材的多段验收不再安排，原任务保留现状。新设计明确且用户恢复后重新核对契约。现有命令没有运行时禁用；片段重拍是单独路线。
+
+当前只接入画布内的视频转绘。独立「视频转绘」页面（含其任务列表、独立生成准备页及素材池选择/排序/生成）标为“未接入，暂不实现”，不纳入当前开发或业务测试。共用后端接口、已有任务素材上传命令或单项测试不代表独立页面已接入；画布扩展只以实际画布入口和请求为依据，不从独立页面移植功能。
+
+用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md)：沿用已明确选择，缺项优先用卡片收集，等待回复后继续原任务；本路线的执行、签署与恢复边界仍按下文，不扩展功能。
+
+用于用户要求从真实视频分析、审核分段、切片并在画布形成可继续操作的节点链。使用独立 `repaint` 命令，由 CLI 编排，不依赖网页打开或前端源码。普通节点创建仍遵循 [节点流程](node-workflow.md)，收费生成遵循 [生成流程](generation-workflow.md)。
+
+## 范围与前置条件
+
+- 沿用已确定的账号、个人/团队空间和画布；先读取实际 `team_uid`。缺少空间选择才问，团队从账号实际 teams 解析。
+- 需要同画布的普通视频源节点（video/video_upload，已经有可读取的真实视频地址）和普通转绘入口（video-repaint）。缺少节点可在授权范围内创建；源素材由用户指定，使用 resource upload 准备，不自行选私人文件或测试占位。
+- CLI 从源节点地址读取视频；不能拿另一份文件替换。地址不可访问、过期、MIME/大小不符合服务端限制或远程 HTTP 被拒绝时停止，更新合法资源引用后重新核对，不放宽网络限制。下载和预签名上传不向资源地址发送 API Authorization/Cookie。
+- 提交前读取当前 upload-limits 的格式、大小和时长范围；用源素材的实际媒体时长核对，不把生成节点的请求时长当作文件时长。已知源片不符合限制时先选择符合条件的既有素材并重新展示预估，不修改文件时长或提交无效分析。缺少可信时长时明确待核验；需要本机探测工具则遵循按需依赖规则，不自动安装。
+- 支持 intelligent 与 uniform；均匀分段需用户明确 4–15 秒间隔。间隔不保证段数，每段至少4秒，短余量合并；两段至少需要8秒源素材，实际以服务端方案为准。source_preview缺可信时长时先探测，不按请求时长承诺。智能分析提交可能收费，不能当作免费创建节点。分段命令不自动反推；单段反推走下方独立命令。单段最终提示词见下方独立流程；单段视频生成见下方video流程；当前不接字幕、视频生成额外参考、批量生成或整片拼接；视频重拍走独立remake流程。
+
+## 功能状态与待完善路线
+
+以下状态仅指 CLI 的视频转绘流程接入范围，不代表网页或后端没有相应能力。
+
+| 环节 | 当前状态 | 后续路线补全与验收目标 |
+|---|---|---|
+| 视频分析、方案审核/修改、切片及派生节点链保存 | 智能分析、方案确认、切片及落图真实通过；均匀分段/改切点真实待验 | 已验证真实计费/媒体、原任务恢复与前端codec保存重开；网页人工交互仍待验 |
+| 单段反推提示词 | 已接入，真实第1段首轮0 OO、结果回填和重复恢复通过 | 使用下方reverse命令，不能在切片后自动提交；付费重做仅本地验证，批量未接入 |
+| 单段最终/交付提示词处理 | 已接默认/替换规则及带全局附件的预估/提交/恢复；无附件默认首轮0 OO真实通过；带附件真实处理因当前地址受阻，自定义替换真实待验 | 复用真实反推与已同步全局规则，按下方delivery流程单独确认，不自动生成视频 |
+| 单段转绘视频生成 | 已接入无额外参考首轮；mini单次6秒/480p/16:9真实完成、24 OO结算和原节点回填/恢复通过 | 见下方video流程；团队下载权限独立核验，原成品下载/解码已补验；其他成员权限、真实过期引用及网页人工播放待验 |
+| 原运行查询与导出 | 已接history与export；配置改变后仍核验原任务，最终提示词真实导出通过，原视频下载/解码已补验且始终经业务权限 | 文本可显式导出已核验本地archive；没有旧快照不能补造原轮。写回/任意历史切换未接入 |
+| 多段逐项调度 | 已接sequence/get/next/recover，复用单段流程；本地两段与三类步骤通过 | 每次只处理一项，确认绑定step；真实多段按用户选择保留待验，不代表产品批量接口或拼接 |
+| 视频重拍流程 | 已独立接入单源重拍，真实产物/恢复通过 | 走[remake专用流程](remake-workflow.md)，不由repaint命令代替 |
+| 全局提示词文本编辑 | 已接入，真实保存/双端读回、原结果保留与重复恢复通过 | 见下方settings流程；保存免费，不自动重处理或生成 |
+| 画布全局附件上传/挂载 | 已接入，单图片真实路线及重复恢复/前端codec通过 | 附件参与处理另行预检/确认；不等于视频生成参考素材 |
+| 任务素材池上传/查询 | 底层命令和历史单图片测试已存在；不代表独立页面接入 | 保留原记录/命令；不扩展独立页素材选择、排序或生成 |
+| 独立「视频转绘」页面 | 未接入，暂不实现 | 不进入当前计划，不能用共用接口或画布流程冒充 |
+| 全局附件参与单段最终提示词处理 | 已接入，模拟费用/请求/恢复及真实只读预估通过；当前测试附件地址不适用，真实处理未验证 | 先检查submission_available与blockers，地址问题不报上传失败；另行确认费用后才处理 |
+| 独立页素材池选择/排序/审核/生成 | 未接入，暂不实现 | 已从当前开发计划移出 |
+| 画布转绘尚缺的参考/字幕/批量能力 | 未接入或待完善 | 仅先核对画布真实入口；画布未使用的请求字段不自行添加 |
+
+仅对当前画布接入范围内的不可用环节，后续测试时先告知尚未接入；独立页面不进入此补全过程。对画布环节，按该路线补全 CLI 编排与 skill，再继续验证。按“输入/归属 → 参数 → 涉及收费时预估与当次确认 → 真实任务 → 查询/恢复 → 结果落图及网页兼容 → 记录结果”推进；本记录不构成后续收费授权。不提前执行这些待办，不用 node add/update 伪造业务产物，也不把独立的 generation 命令当作已打通转绘流程。代码与契约检查通过后仍标“真实业务待验证”，实际验收通过后才更新为通过。
+
+## 分析、审核、切片、落图
+
+以下命令以 `uzoo-anime --profile PROFILE` 为前缀。创建 UTF-8 repaint.json，ID 替换为实际查询结果；个人示例：
+
+```json
+{
+  "doc_id": "DOC_ID",
+  "source_node_id": "SOURCE_VIDEO_NODE_ID",
+  "entry_node_id": "REPAINT_ENTRY_NODE_ID",
+  "space": "personal",
+  "segmentation_mode": "intelligent"
+}
+```
+
+团队改为 `space: team` 并提供实际 `team_uid`。均匀分段改为 `segmentation_mode: uniform` 并填写 `uniform_interval_seconds`。operation 使用固定名称；不要通过换名重新提交未知任务。
+
+1. `repaint start --input repaint.json --operation video-split-001`：核对归属、源节点和入口，读取实际价格与上传限制，持久化本地预估。此时不上传、分析或写远端画布。展示源视频、分段模式/间隔、实际个人或团队付款钱包及本次分析 OO 币。预估不包括后续 AI 操作和视频生成。
+2. 等待用户对该参数和费用的当次明确确认，再执行同一命令加 `--yes`。CLI 核对预估未变，下载源视频，分片上传。会话提前返回 job_id，CLI 保存后才调用 complete；complete 可能启动分析和预扣费用，没有自动重试。提交前再检查价格与画布，并通过 CAS 保存流程占用，防止另一 CLI operation 对同一入口和源视频重复提交。占用是任务元数据，不是虚构派生节点。
+3. `repaint wait video-split-001`：分析达到 awaiting_review 后同步真实任务详情并返回。详情已有 job_id、源/入口引用和系统连线。CLI 首次派生详情基于已存在的真实任务，不创建无任务的占位详情。`repaint get video-split-001` 只查询，不写画布。
+4. `repaint confirm video-split-001 --plan-version N`：展示实际方案、每段时间和当前版本，等待用户确认分段。要调整切点，准备 `{ "plan_version": N, "boundaries_ms": [0, 6000, 12000] }`（仅结构示例，末尾必须是真实总时长），用 `repaint plan ... --input plan.json` 检查，再加 `--yes` 保存；重新读取新版本后展示方案。
+5. 用户确认当前方案后，`repaint confirm video-split-001 --plan-version N --yes` 启动切片；再 `repaint wait video-split-001`。只有任务 completed、已确认版本一致且片段下载结果完整时，CLI 才创建每段的片段素材、反推提示词、最终提示词、视频生成节点，全局提示词及系统连线/分组，保存并核对响应。视频生成节点此时可以没有结果，这不表示已生成成片。
+6. `canvas get DOC_ID` 核对真实任务关联、节点/边/分组和原画布保留情况。网页可用时打开同画布，检查片段可播放、详情可查看、提示词/视频节点可继续操作，再次保存后 CLI 仍可恢复。同一任务重复恢复不追加一套节点。
+
+单段反推按下方独立流程准备参数、估价和当次确认；单段最终提示词按下方delivery流程执行；单段视频生成按下方video流程独立估价/确认；切片完成不等于视频生成完成，单段完成不等于批量或整片拼接已接入。
+
+## 中断与并发
+
+- 关闭网页不影响 CLI。CLI 不是后台常驻服务：退出后后端已提交任务可继续，但画布落图需重新运行同 profile 下的 `repaint wait/recover NAME`。
+- `repaint operations` 查原 operation；`repaint get NAME` 查真实任务。`repaint recover NAME` 核对账号、服务、画布、源素材、任务绑定、方案版本后，仅查询并同步，不再次 complete/confirm，也不重新生成。
+- complete 响应不明时查询预分配 job_id；任务暂不存在或不可见时保留记录，稍后查询。不能以 404 为依据重提 complete，也不能更换 operation 绕过画布上的待确认占用。
+- 上传中断但尚未 complete 时，重新展示预估并确认后，可用同一 start --yes 继续原上传会话中缺少 ETag 的分片；不会自动新建已过期会话。上传会话创建响应丢失、会话过期或记录缺少任务 ID 时停止调查。当前没有取消/清理占用命令，不手工删记录来重试收费步骤。
+- 切片确认或方案保存响应不明时，recover 读取原任务核对是否生效；无法确定则停止。方案变化需要重新展示并确认，不重放旧 plan_version。
+- 同画布写入用最新快照和 CAS，409 停止；先读取实际变化，再显式 recover。其他节点、提示词编辑、位置、视口、名称和 meta 保留。网页已物化同任务的完整组时复用；节点/组被删除、方案重做或已有不完整链时停止，不自动重建或覆盖。
+- 网页旧快照可能同时移除详情、系统线和CLI流程元数据。本地原operation保留已同步证据，普通start/wait/recover及方案确认会停止，不借元数据缺失自动重建；get仍可只读查询原任务。先协调关闭/暂停全部该画布页面，确认删除是否有意。仅在用户明确授权恢复原分析详情时，运行`repaint recover NAME --restore-detail`预览，再加`--yes`恢复原待审核job的详情/两条系统线/元数据；不重新上传、complete、分析或确认切片。此选项只适用于awaiting_review，不重建已切片节点链；有意删除则停止。已确认且未变化的分段方案可沿用，不重复问同一方案。
+- 原始响应和截图放本地忽略目录；运行记录位于用户配置目录 repaint/PROFILE，不提交其素材地址、预签名链接或业务 ID。
+
+## 验证范围
+
+已实现并通过本地模拟HTTP流程测试，包括实际签名、费用变化、未知提交恢复、CAS、去重、后端对象键重排不重复保存及元数据连同详情被清除后的停止/显式恢复。智能模式真实素材上传、分析计费、v1方案确认、切片、派生组落图、媒体下载解码和原任务重复恢复通过；真实分析/切片快照经前端解析、保存重开与CLI恢复兼容通过。网页人工查看/编辑、均匀分段和改切点真实待验。单段反推已按下方路线真实验收；单段无附件默认最终提示词首轮0 OO、原节点回填/恢复及前端保存重开真实通过；自定义替换真实待验。无额外参考的单段转绘视频真实完成/计费/回填与恢复通过，下载和其他范围见下方。
+
+## 单段反推提示词
+
+需要已完成并落图的原repaint operation、当前方案版本和具体片段序号；沿用用户指定的团队/画布和素材，不重新分析、切片或创建派生节点。只有一个明确待测片段可沿用；多个片段且用户未指定范围时先问。CLI只处理一段，不把“下一项”理解为收费批量或重做。
+
+1. `repaint reverse PARENT --segment-index N --operation reverse-001`只读核对原任务、已确认方案、真实片段、完整节点组/系统线、原反推节点和全局规则，保存本地预估。任务的billing.has_base_benefit与是否已有reverse_prompt共同决定首次权益，单价从实时pricing取得；不能仅凭智能模式或历史45 OO认定免费，也不能把普通单价当本次费用。展示实际个人/团队钱包、余额快照、当前片段区间、首轮/重做及本次OO。全局规则与后端不同步则停止，不自行改规则；反推模型由服务端管理，前端没有此处的模型/声音/阈值选择。此步不确认片段或提交任务。
+2. 得到用户对本次参数/费用的明确确认后，同命令加`--yes --expected-cost OO`（0也须明确）。重新核对节点、全局规则、原反推状态、归属和费用，先检查后端就绪；按前端顺序POST确认该片段，再POST单段reverse-prompt，两者均不自动重发。片段本已确认可复用；没有提交幂等键契约，不自行伪造。请求不添加未在前端使用的字段。
+3. `repaint reverse-get reverse-001`只读查询原job/segment，显示本次状态、真实billing与结构化reverse_prompt。`repaint reverse-wait reverse-001 --timeout MS`轮询并在完成后回填既有反推节点的input/prompt/output，保留其他节点、全局/最终提示词、模型、布局、组和线。不自动处理最终提示词、生成视频或入库。反推计算在后端完成，不要求本机FFmpeg/模型工具。
+4. `repaint reverse-recover reverse-001`只查询并同步已明确接收的原反推结果，不再次确认片段或提交反推。同operation重复reverse也走恢复，不能借换名重复未知任务。保存用最新完整快照+CAS；丢保存响应先读回，已有相同结果不再写入。用户编辑了目标正文或删除/换组/断系统线后停止，不覆盖或重建；已完成结果被另一轮反推替换、方案/源/规则变化也停止。
+5. 返回running继续查原操作；failed查询原错误，不自动重做。超时、502/503/504或断连先service status，再查原任务。确认片段响应未知时只查询确认是否生效；确认已生效且尚未发送反推，可在原授权、报价和状态未变时继续原operation的首次反推。反推POST响应未知且未取得接收证据时保持REVERSE_SUBMISSION_UNKNOWN：get可展示观察到的远端状态，但不能仅凭同job/segment出现结果就认定本次提交或自动保存，不能再次POST。当前未接自动认领或收费重试流程。
+
+操作记录位于用户配置目录repaint-reverse/PROFILE，绑定父operation、账号/服务/任务/方案/片段、原节点内容和本次提交；不要公开原始素材地址/记录。REVERSE_SUBMISSION_UNKNOWN及REVERSE_SYNC_PENDING退出4，等待超时5、已知任务失败6；canvas_synced与remote_status分别看，不能只看进程退出0。
+
+已验证：首轮权益/付费/重做的本地费用与轮次校验、前端真实确认→反推顺序/空请求体/轮询/三字段回填，未知提交不重发、确认未知续接、冲突/丢响应、保留用户编辑/删除及跨版本停止；真实单段首轮0 OO回填、前端保存重开和重复恢复通过。实际付费重做、非首段上下文、多段/批量与网页人工编辑验收仍待验证，不因本轮通过自动扩大范围。
+
+## 单段最终提示词与替换交互
+
+沿用已确认的原repaint任务/方案/片段，先查询该段反推已completed且有真实原文。全局规则必须已在画布和后端同步，原分组/节点/系统线完整；不伪造反推或新建空节点。当前接入单段，复用已有全局规则；全局文本编辑见下方settings流程，附件上传及带附件处理见后文专节。先查看submission_available和费用，地址不适用时停止；不清除附件或漏算。批量未接入，单段视频生成另走下方专用流程。
+
+- Agent支持交互卡片时，缺少替换要求就用卡片收集“角色/场景/道具/台词的原内容→目标内容”，允许明确“不替换”。优先异步收集并在同一会话继续独立的查询/开发准备；必要输入未答不能提前执行依赖操作。不让CLI阻塞式readline接替Agent交互。用户已经说不替换或给出具体映射时直接沿用，不再重复提问；不把自然语言请求或选择替换方式当成本次费用批准。Agent不支持卡片时再用普通提问。
+- CLI映射角色/道具/场景规则以及台词正文替换；台词保留原说话人，按前端规则整理。先读真实反推原文来确定source，不自行编造原名称。规则与完整四类章节可通过UTF-8输入传递；无替换时不传input或使用`{}`。
+- “不替换”表示不添加用户自定义替换；前端默认最终提示词仍包含服务端的文化本地化及格式整理，不能承诺输出与反推逐字相同，也不新增关闭本地化或另选模型的开关。涉及费用的确认卡片应说明采用默认处理、当前规则和本次预估。
+
+输入例（实际source来自任务；章节编辑要完整提供character/scene/prop/dialogue，不能用示例冒充原文）：
+
+```json
+{
+  "rules": {
+    "character": [{ "source": "原角色名", "target": "新角色名" }],
+    "scene": [{ "source": "原场景名称", "target": "新场景名称" }],
+    "prop": [{ "source": "原道具名", "target": "新道具名" }],
+    "dialogue": [{ "source": "角色：“原台词”", "target": "新台词" }]
+  }
+}
+```
+
+1. `repaint delivery PARENT --segment-index N --operation final-001 [--input rules.json]`只查询原任务/节点，按前端同款builder从后端反推的角色/场景/道具/台词组装sections与替换规则，保留cultural_reference空值和空reference_images。未知字段/无效章节/超长映射停止，不猜测供应商参数。保存本地预估，不保存设置、不提交处理。
+2. 查询实时`ai_edit_credits_per_segment`及原任务首轮权益，显示本次费用、付款钱包、片段与规则；有权益且尚无最终提示词时首轮可能0 OO，不能把历史0或普通单价当当前费用。收到用户当次明确确认后，同命令加`--yes --expected-cost OO`。CLI重新核对状态/原文/内容/费用，先检查后端ready，再按前端顺序保存现有全局设置，后单次POST该段delivery-prompt；不重复保存未知设置或重发未知生成。
+3. `repaint delivery-get final-001`只读原状态、真实billing与结构化delivery_prompt；`delivery-wait final-001 [--interval MS --timeout MS]`轮询，完成后仅回填原最终提示词节点input/prompt/output。原反推、全局、视频节点、布局/组/线不变，不自动生成视频或入库。本机无需媒体/模型依赖。
+4. `repaint delivery-recover final-001`只核对和同步已接收的原结果，保存丢响应先读回，语义相同不重复PUT；用户编辑目标、删除节点/系统线、原反推或方案/全局规则变化时停止，不覆盖或重建。设置保存响应未知时可查询验证现有设置，再沿用原参数和费用批准继续首次处理；POST生成未知无接收证据则保持未知，不因同job/segment出现结果就认领或换operation重提。
+5. 返回`completed_fallback`/`fallback=true`时，明确报告“返回了回退文本，本地化/全局要求/替换未生效”，保留后端warning，不当成正常需求验收通过，也不自动重新生成。failed/timeout保持原操作，优先检查后端与原副作用后恢复查询。
+
+DELIVERY_SUBMISSION_UNKNOWN/DELIVERY_SYNC_PENDING退出4，等待超时5、已知任务失败6。记录在用户配置目录repaint-delivery/PROFILE，包含规则/原文/响应，不公开或提交。当前没有每轮独立任务ID/声明的提交幂等契约，已知job与段不等于未知提交已确认；恢复不依赖网页自动执行后续。
+
+已验证：单段、无自定义替换/附件/额外全局规则的首轮权益0 OO真实处理，正常delivery-v1结果（未回退）、原最终节点三字段回填、其他内容保留、重复恢复无POST/PUT，以及真实快照的前端保存重开兼容。本地模拟覆盖付费/权益变化、规则/章节/台词组装、未知提交、设置未知查询续接、冲突及用户编辑/删除防护。自定义替换的实际模型效果、非空全局规则、付费重做、带附件真实处理和多段/批量、网页人工编辑仍待逐项验收；本次通过不表示整片转绘成片已接入。
+
+## 单段转绘视频生成
+
+适用于原分段任务已完成且派生组完整，当前片段有正常completed最终提示词的首轮生成。复用原账号/空间/画布/方案/片段与generation节点，不重新分析、反推或创建节点。本机无需FFmpeg或模型软件即可估价、提交、查询、同步与下载；媒体解码验收需要的工具另按按需依赖流程检测。
+
+### 前端语义与支持范围
+
+画布前端runCanvasRedrawGenerationNode经canvasService.createCanvasRedrawTask提交专用redraw-tasks。当前这条画布路径使用连入的最终提示词和节点自有提示词，不把原片段视频作为reference_video发送，也不把画布媒体入边转换成素材池reference_image_material_ids/audio_material_ids。本轮CLI只接原最终文本入边、无额外参考的路径，检测额外入边或持久参考会停止，不丢参考后继续。不能把“转绘”一词解释成必然以原视频作为模型输入；执行前说明实际输入。
+
+- 模型/输出时长/分辨率/比例由用户选择或明确委托，不能因上次测试用了某模型便自动复用；已明确的同次选择沿用。输出时长独立于原片段的毫秒范围，不偷偷改切点/提示词时序；原文与所选时长有明显冲突时先说明并由用户决定。
+- 当前仅明确整数输出秒数、非样片、支持当前文本输入的模型；自动时长、额外媒体参考/审核编排、素材池附件、批量/重做/历史版本切换及拼接未接入。普通generation prepare/submit/sync不能替代此专用流程。
+- 含人脸媒体的Seedance审核规则继续适用；本轮没有将源片或图片/音频发给模型，不因此声称源片已审核。要添加含人脸参考时先进入待完善的参考路线，不能跳过审核或仅手写active。
+
+### 命令与执行
+
+以下以`uzoo-anime --profile PROFILE`为前缀：
+
+1. `repaint video-options PARENT --segment-index N`先核对后端ready、原job/方案/片段/节点组/系统线和最终提示词，再只读查询当前空间模型，返回本路线可选模型及比例/分辨率/时长。通过交互卡片依次收集模型与适用参数；当前选项只表示查询结果，不表示已同意默认值或费用。
+2. 创建UTF-8输入：`{"model_name":"实际模型展示名","duration":6,"aspect_ratio":"16:9","resolution":"480p"}`，数字仅示例。`repaint video PARENT --segment-index N --input video.json --operation video-001`构造经前端验证的估价/提交体，只保存本地预估，不改画布或生成。画布generations/estimate与原job/redraw-estimate必须均返回有效且一致的本次费用；空值、拦截、不同价停止。展示实际提示词/输入、输出配置、实际团队或个人钱包、余额快照和预估OO。
+3. 交互卡片取得当次明确费用确认后，同命令加`--yes --expected-cost OO`。CLI重新检查服务、身份、原绑定/输入和两处费用；协议需要签署时通过本人阅读页完成，再核对原请求与费用。只在已同意/无要求状态继续，提交体不代填protocol_agreed=true；4401明确报告《统一协议》《Seedance2.0模型使用承诺书》待签署，不报生成失败。
+4. CLI保存原生成节点模型/输出参数（镜像字段一致），核验响应后持久化attempt，再单次POST专用redraw-tasks并保存真实task_id。没有接口幂等契约，不自动重发；POST响应不明且无接收ID时保持REPAINT_VIDEO_SUBMISSION_UNKNOWN，get可展示观察到的任务但不自动认领或换operation提交。
+5. `repaint video-get video-001`只读原任务；`video-wait video-001 --interval MS --timeout MS`或`video-recover video-001`查询并把原状态/真实结果保存到原generation节点，保留其他节点、组、边、全局及提示词。超时后继续原operation；已知失败保留原错误及计费，不自动重做。方案/来源/规则/最终文本变化、目标编辑/删除/旧快照清空、系统线断开时停止，不覆盖或重建。
+6. completed后核对原task的credit_cost和billing_status，不能用共享钱包差额替代费用；任务completed与结算状态分开报告。画布完成重复恢复不因新签发URL而重复PUT，丢保存响应读回核验原pending结果，不再提交生成。CLI退出后后端可继续，画布同步需同operation的video-wait/recover。
+7. 需要导出时用`repaint video-download video-001 --output 新文件.mp4`，始终先经过原任务专用download接口，其个人/团队可见性及审计独立于生成和画布查看（新版契约取消白名单，实际部署须核验）。下载成功返回绝对路径、字节数、SHA-256；本地已有同名文件拒绝覆盖。返回REPAINT_VIDEO_DOWNLOAD_FORBIDDEN（2001）说明下载受限，原生成仍completed，不改用result.url绕过下载接口，不重做生成；先核验当前部署、账号、活跃团队成员和原任务可见性，权限恢复后仅继续原任务下载。用户选择保留受限时结束下载核验并明确未验证媒体。
+
+operation位于用户配置目录repaint-video/PROFILE，包含原绑定/请求/报价/attempt/接收任务与保存证据，不公开原始文件引用或凭据。REPAINT_VIDEO_SUBMISSION_UNKNOWN与REPAINT_VIDEO_SYNC_PENDING退出4；DOWNLOAD_FORBIDDEN退出3；等待超时5；已知生成失败6；协议待签署7。画布结果不自动入素材库。
+
+### 验证与限制
+
+已通过签名HTTP模拟、参数/双报价变化门禁、未知提交不重发、协议、CAS/保存丢响应、目标编辑/删除/旧快照防护、原结果恢复与下载权限隔离；真实前端估价builder、专用service/API、run/poll/result和完成快照的codec保存重开通过。单段mini首轮6秒/480p/16:9真实完成，实际24 OO、原节点回填和重复恢复无写入通过。本次团队禁止成品下载，用户选择保留限制：下载/媒体解码、网页人工播放、其他模型和参数真实效果仍待验，不扩大成多段/参考素材/整片拼接已通过。
+
+## 全局规则文本编辑与恢复
+
+用于编辑已完成分段任务的原全局提示词节点，和后端delivery_prompt_custom_prompt同步。沿用已明确的任务/画布/空间；缺少规则内容时用交互卡片收集文本，已给定则直接沿用。保存设置本身不计费，不另制造收费确认；提示词处理、附件参与处理或视频生成均是后续独立动作，仍须实时估价和当次确认。
+
+当前只编辑纯文本。已有附件会在画布原节点中完整保留，API使用原服务端附件，不新增、删除、替换或静默裁减；两端附件不一致或结构无效时停止。附件上传与挂载使用下方独立命令；本文本编辑命令不承担新增附件。
+
+1. `repaint settings-get PARENT`只读核验原job/版本、已物化组和全局节点/各段系统线，展示画布值、后端值及是否一致。目标被删或关联不完整则停止，不创建新全局节点。若已有不一致，不擅自选择画布/后端覆盖另一侧；先明确哪一份才是用户要保留的编辑。
+2. 准备UTF-8输入`{"custom_prompt":"用户实际要求"}`；明确清空用`{"custom_prompt":""}`。不传字段不能表示清空，不通过HTML/富文本载荷替代纯文本。`repaint settings PARENT --input settings.json --operation global-001`默认只预览/保存本地记录，不写远端。展示原值、新值、目标及已有结果不自动重做；用户已授权的同次免费编辑不重复询问。
+3. 同命令加`--yes`：先service ready、原账号/服务/方案/源/组/节点绑定及当前文本核验；有提示词/视频正在运行，或本地存在同job的未结束/未知处理operation时停止，避免改变其输入。保存前再次读回当前值，不覆盖新的用户编辑。
+4. CLI按两阶段保存：先单次POST原delivery-prompt-settings，保留原附件；查询核验该目标文本后，以最新画布快照+CAS只更新原全局节点input/prompt/output，最后再次读回两端。普通node update不用于绕过派生节点保护。接口没有规则版本CAS/幂等键，CLI不能承诺跨客户端原子事务；冲突/不一致停止，不用旧快照回滚或反复覆盖。
+5. `repaint settings-operation global-001`只读原保存记录及两端状态。`settings-recover global-001`只查原POST是否已生效；已查到目标文本才继续原画布同步，不重新POST设置，更不处理提示词/视频。POST响应未知且后端仍是旧值时保持REPAINT_SETTINGS_SAVE_UNKNOWN，不因健康恢复或换operation而重发。
+6. 画布保存响应丢失时读回，已是目标文本则完成且不再PUT；CAS冲突且全局文本仍为原值时，显式恢复可以使用最新快照继续，保留其他节点/布局编辑。目标/附件/方案/原关联发生变化时停止，不覆盖或重建。完成后重复恢复没有POST/PUT。用户后续编辑后不将旧operation自动重新应用；旧记录不是“强制还原”的授权。
+
+operation位于用户配置目录repaint-settings/PROFILE，保存原值、目标、绑定、附件投影与两个阶段证据。REPAINT_SETTINGS_SAVE_UNKNOWN和REPAINT_SETTINGS_SYNC_PENDING退出4。未知保存不换名；原文本完全相同的编辑可无远端写入完成。设置免费与当前任务费用分开，不从团队余额差额认定有无收费。
+
+规则变更仅供后续处理使用：已有反推/最终提示词/视频保留，不声称它们已体现新规则。旧reverse/delivery/video operation仍绑定其提交时的规则，规则改变后原get/recover的严格校验可能停止；不要手改记录或追认新输入。只需查看原结果时使用下方repaint history；配置改变后的导出走下方export；任意历史切换与写回仍待完善，不借本轮编辑自动重提处理。
+
+已验证：真实文本保存、两端一致、仅原全局三字段变化、已完成提示词/视频任务不变、重复恢复无POST/PUT；真实完成快照经前端codec保存重开通过。本地模拟还覆盖明确清空、已有附件保留、设置未知/保存丢响应、冲突/并发用户编辑、运行中/未知任务及身份/版本/删除保护；清空/非空附件与多段的真实交互、网页人工编辑继续待验。
+
+## 任务素材池与全局附件上传
+
+两条路线独立于普通素材库和画布resource上传。沿用已确认任务、空间及素材；缺少文件、用途或分类时先用卡片收集，不自行挑私人文件。同一文件如需两种用途，必须分别获得该用途授权，并用两个operation。上传/挂载不消耗生成OO额度，但受服务端存储配额与格式限制；不自动入普通素材库，不自动处理提示词、审核或生成。
+
+- 任务素材池输入：`{"file":"本机文件绝对路径","kind":"image","category":"scene"}`。图片支持PNG/JPEG/WebP，分类character/scene/prop/other；音频支持MP3/WAV/M4A/AAC，分类audio/voice。视频参考入口在前端禁用，CLI不接受视频。当前没有任务参考素材大小限额的公开查询接口，CLI明确返回未知，以服务端实际限制为准，不套用普通素材库限额或编造默认值。
+- 全局附件输入：`{"file":"本机文件绝对路径"}`；当前CLI接受PNG/JPEG/WebP/PDF，单文件上限20MiB，数量取当前pricing与前端10个上限的交集。保留现有custom_prompt和有序附件；本批不提供删除/替换。无需本机FFmpeg或额外安装工具，内容解码和配额由服务端验证。
+
+1. `repaint materials PARENT`只读列原任务素材池的真实ID/分类/文件引用。ID不能用普通素材库asset_id、画布task_id或URL冒充。
+2. `repaint reference-upload PARENT --input reference.json --operation reference-001`，或`repaint attachment-upload PARENT --input attachment.json --operation attachment-001`：默认仅准备本地记录、检查绑定及文件摘要。附件operation最长55字符，为内部`-settings`记录预留空间。
+3. 已授权的同次免费上传直接加`--yes`，不重复询问费用。先检查后端ready和原账号/job/方案/源/派生链；有进行中或本地未知提示词/视频任务时停止。按前端先POST `/uploads/sessions`，用途分别video_reference/video_delivery、scope_id为job；匿名PUT实际分片并保存ETag，最后complete。签名URL不携带API凭据，不放宽远程HTTP限制。文件摘要变化停止，不续传混合文件。
+4. complete回执必须证实原会话/用途/文件绑定，再用签名multipart提交业务注册：任务素材为`reference-materials`的upload_id/kind/category；全局附件为`delivery-attachment`的upload_id/name。multipart按前端signV2显式序列化，签名与传输使用完全相同字节。
+5. 任务素材保存注册回执，再按真实ID查回列表；不创建普通画布节点，不自动选给生成。全局附件注册成功后仍未激活：CLI复用原全局设置恢复器，单次保存带新增附件的完整设置，再CAS更新原全局节点attachments，保留原规则及所有结果；最后双端核验。原节点被删、用户更改规则/附件或方案变化时停止，不重建或覆盖。
+6. `repaint upload-get NAME`只读原上传记录与绑定。`upload-recover NAME`默认只查；加`--yes`仅在已知阶段继续原会话缺片/首次complete/首次注册或原附件挂载，不再次生成。已完成操作重复恢复无POST/PUT。任务素材独立于全局规则，后来编辑规则或挂载附件不妨碍原素材ID验证。
+
+恢复边界：创建会话无回执/upload_id、complete响应未知、业务注册响应未知时均保留原operation，返回REPAINT_UPLOAD_UNKNOWN（退出4），不自动重发、不换名重新上传。注册会消费上传会话，仅凭同名/大小或观察到新增列表不能可靠认领；全局附件注册后未激活也没有可供可靠认领的列表接口。分片PUT未知可先查原会话已传分片，再仅续缺片；附件settings未知只查询原保存是否生效，不重发设置；画布CAS/保存丢响应按原settings记录恢复。先查service status，保留HTTP/API码和安全request_id；正常ready不解除上述未知副作用限制。
+
+本地记录在用户配置目录repaint-uploads/PROFILE，含本地文件路径/摘要、原会话、分片、complete和注册回执；附件另有repaint-settings/PROFILE/NAME-settings。不要分享、提交或打包这些业务记录。当前真实验收仅图片：任务池场景图查询、全局附件挂载、原结果保留、重复恢复无写入与前端保存重开通过；音频、PDF、多附件与网页人工操作仍待验。
+
+## 参考选择、审核与附件处理的待接入范围
+
+独立「视频转绘」页面及其生成准备页未接入，暂不实现。其中有序任务素材ID选择属于范围外，不能据此给CLI画布流程新增reference_image_material_ids/reference_audio_material_ids配置。当前画布createCanvasRedrawTask分支仍传空数组，CLI video继续只支持无额外参考。若后续完善画布参考能力，先核对画布真实入口、请求和保存语义，不能将画布媒体入边自行转换成独立页参数。
+
+画布全局附件参与最终提示词处理已按下文接入；独立页任务素材池选择/审核/生成不在本轮实现范围。含人脸的真人/动漫Seedance参考须经真实审核，协议签署与素材审核分别核验。字幕、批量与拼接继续待接入。
+
+## 带全局附件的单段最终提示词
+
+沿用原delivery命令及rules/edited_sections输入；附件来自已同步的原全局节点和job设置，不能通过单次JSON另外传URL、静默移除附件或重新上传。保留附件顺序、名称、media_type和实际文件引用。这里的附件供提示词模型阅读，不是后续视频生成的任务素材池参考；不自动生成视频或入库。
+
+1. 先读取原job/方案/反推/最终节点、全局文字和附件；画布/服务端任一附件不一致或结构不合法时停止，不选一边覆盖。已上传文件的代理URL与本机文件路径不同；相对文件地址归一化仅用于同服务比较，不能据此认定外部模型能够读取。
+2. `repaint delivery PARENT --segment-index N --operation NAME [--input rules.json]`只准备本地记录并预估。实时pricing提供AI处理单价及attachment_free_images/free_docs/extra_fee/max；再POST原job/billing-estimate（只读估价）以segment_count=1和实际附件交叉核验数量/单价/权益。该端点可能使用job历史价格；与实时pricing不一致时停止，不用整任务totals或历史45 OO基础价当作本次单段费用。
+3. 本次费用=首次基础权益下的处理费0，否则当前单段AI单价，再加附件超额费。图片数和PDF数分别与免费额度比较；任一超额，本段本次仅加一次extra_fee，不按超出文件数量乘算。展示base_credits、attachment_credits、credits、附件清单与实际付款钱包；重做不自动沿用旧首轮0 OO。
+4. 检查预览submission_available与blockers。本机/内网/HTTP地址或无效data内容返回DELIVERY_ATTACHMENT_ADDRESS_UNUSABLE，不提交设置或收费处理。当前源码的附件模型链路直接使用图片URL，普通画布生成则会解析fr1存储引用，两者不能混同。CLI只接受格式适用的HTTPS文件地址或已有同类型有效data附件；公网HTTPS格式合规不保证模型端实际可达。当前公网IPv6直写地址未验证，保守停止。文件域名必须属于实际同服务资源，不能猜域名、发送文件令牌到无关服务或替换成未知上传来源。
+5. submission_available=true后，使用交互卡片展示原规则、附件、是否重做、费用及已有结果将更新；取得当次确认才同operation加--yes --expected-cost OO。CLI再检查原文本/附件及当前费用，按前端先保存完整custom_prompt/attachments，再单次POST单段delivery-prompt。附件不塞进reference_images；该字段仍按原前端builder为空数组，由后端从job读取全局附件。
+6. 继续delivery-get/wait/recover，按原本次reservation/plan/billing验证并只回填原最终提示词节点；旧视频不自动重做。附件/规则改变后停止原恢复，不认领新一轮结果；未知收费POST不重放、不换名；settings响应未知按原记录查询核对，CAS/丢保存响应/编辑删除保护沿用。出现fallback明确报告，不能声称附件已生效；后端未提供逐附件读取成功回执，任务completed本身也不能证明每份附件都被模型成功读取。
+
+本地模拟覆盖免费/付费重做、图片/PDF阈值、双超额只加一次、历史价格不一致、设置前后附件或报价变化、未知提交及地址阻止；真实前端执行验证完整附件设置先保存、处理body保持原builder、结果三字段回填，并复现相对资源在本机开发站点补为127.0.0.1。当前真实只读预估通过，本机代理附件地址被拦截，原画布/结果未变；没有收费提交，带附件真实处理仍待验证。地址根因和工程师协作建议见维护记录，不要求安装用户读取前后端源码。
+
+上传响应若已提供绝对HTTPS文件域名，CLI保留它，不强行改为API/前端origin；相对URL只能按当前服务补全显示。本轮不修改前后端代码或配置，不重新上传、压缩/转换图片、搭建公网隧道或代签费用。服务侧配置/解析能力确认后，还须核对CLI地址保护与实际部署契约，再预估确认；不能仅凭health ready认定该能力已修复。
+
+## 原运行只读查询
+
+用户只需查看原处理/视频结果、或全局规则/附件变更使原get停止时，使用同profile下对应阶段的原operation：
+
+```text
+uzoo-anime repaint history REVERSE_OPERATION --type reverse
+uzoo-anime repaint history DELIVERY_OPERATION --type delivery
+uzoo-anime repaint history VIDEO_OPERATION --type video
+```
+
+NAME不是父分段operation，也不是job/task ID。命令无--yes，不保存画布或操作记录、不提交处理、不下载；不要求暂停画布编辑。先检查服务与账号，再核对原job、方案、片段、源素材及派生节点/组/系统线。允许全局规则/附件和上游提示词改变，但不放宽原任务身份；方案或来源改变、原关联被删除时停止。
+
+- 先看status、original_run_verified与result_available。只有原接收证据及运行轮次/计费/结果摘要一致，才展示原结果和billing；不能只看退出码0。没有原接收证据时返回submission_unknown/not_submitted，不从当前结果或任务列表认领。
+- 提示词API只提供当前轮；与原记录不匹配时返回original_result_unavailable、result/billing为空，明确原结果不能从当前接口确认。不要把新轮次当原结果、归因是谁重做、或为找回旧文重新提交。视频只按原task_id查询，不依赖当前节点恰好显示同一URL。
+- current_configuration中的global_rules、canvas_global_rules、attachments及reverse_prompt/final_prompt表示相对原记录的变化；global_settings_synced表示当前画布与后端是否一致。旧记录没有附件快照时attachments为null且original_attachment_snapshot_available=false，不能报告“附件没变”。
+- canvas_matches_original_result表示当前节点是否仍显示已核验原结果，不等于写回成功；false也不授权覆盖。规则改变后旧结果仍不体现新规则。写回仍走原recover的严格校验，不编辑本地记录、不自动重做。下载仍须原video-download权限接口，history不提供绕过入口。
+
+本地回归覆盖配置改变、当前轮被替换、未知提交、账号/版本/来源/删除保护及无写入；真实最终提示词和视频原运行可核验，原首轮反推已被第2轮替换而返回不可用，查询前后画布/旧记录不变。history本身不导出；导出见下节。服务端全量历史、任意结果切换和删除节点恢复继续未接入。
+
+## 原结果导出与本地归档
+
+配置改变后交付原结果，沿用原阶段operation；无需重做，也不写回当前节点：
+
+```text
+uzoo-anime repaint export DELIVERY_OPERATION --type delivery --output 原提示词.txt
+uzoo-anime repaint export REVERSE_OPERATION --type reverse --output 原反推.txt
+uzoo-anime repaint export VIDEO_OPERATION --type video --output 原视频.mp4
+uzoo-anime repaint video-download VIDEO_OPERATION --output 原视频.mp4
+```
+
+- 默认`--source remote`。先按history核验原账号/空间、任务/方案/片段/来源和节点关联；全局配置或上游提示词变化只报告差异，不放宽submit/recover的校验。方案、来源或原派生链改变仍停止。
+- 文本以UTF-8原文导出，返回绝对路径、字节数与SHA-256。原轮不可用返回`REPAINT_RESULT_UNAVAILABLE`，不导出当前其他轮次、不付费重做。
+- 视频始终请求原任务专用download接口；2001返回`REPAINT_VIDEO_DOWNLOAD_FORBIDDEN`，不能从结果URL或本地快照绕过业务权限。归档仅保存视频元数据，不保存可下载的媒体引用。
+- 目标文件存在则拒绝覆盖；下载或写入中断只清理本次临时文件，目标文件名不会被不完整内容占用。文件路径由用户任务指定或在已委托的交付目录内选择。
+- 新版在已核验的反推/最终提示词/视频成功恢复，以及remote导出时保存本地原结果快照。快照按profile、类型与operation隔离，不修改旧操作记录；摘要只检查完整性，不是服务器签名或全量服务端历史。
+- 原提示词已被服务端新轮替换，但过去成功保存过快照时，可显式`--source archive`导出文本；返回source/verified_at，须说明是本地已核验快照。仍在线核对当前账号和原关联，不能用它恢复被删除节点、越权读其他空间或写回结果。无快照返回`REPAINT_ARCHIVE_UNAVAILABLE`；损坏或绑定不符停止。
+- delivery导出保留fallback/warning，归档回退文本也不能声称替换要求已生效。快照只覆盖实际获得的结果；升级前未取得的旧文不会凭空恢复。
+
+配置变化后的原最终提示词已有真实导出记录；原视频仍受团队下载权限限制。详细本地回归覆盖配置变化、过期引用、历史不可用、损坏快照、并发目标文件与中断清理。
+
+## 多段的逐项调度
+
+用于用户已选择同一画布/分段方案下的多个单段操作。它复用上述单段命令，不调用独立页面批量接口，不进行整片拼接。每次最多处理一个步骤，后续步骤各自准备和确认。
+
+```json
+{
+  "steps": [
+    { "type": "reverse", "segment_index": 1, "operation": "r1" },
+    { "type": "delivery", "segment_index": 1, "operation": "d1", "input": {} },
+    { "type": "video", "segment_index": 1, "operation": "v1", "input": {
+      "model_name": "从专用video-options选择", "duration": 4,
+      "aspect_ratio": "16:9", "resolution": "480p"
+    } },
+    { "type": "reverse", "segment_index": 2, "operation": "r2" }
+  ]
+}
+```
+
+示例模型字段须替换为当前专用目录中用户选择的真实模型，参数须满足其限制；不能直接执行占位模型。delivery的空对象仅在用户已明确“不替换”时使用；缺少input不会自动接受默认选择。只需多个片段某一阶段时也可仅列该阶段。已有同参数的子operation可显式列入，先核验再复用，不自动新建收费重做。
+
+```text
+uzoo-anime repaint sequence PARENT --input steps.json --operation sequence-001
+uzoo-anime repaint sequence-get sequence-001
+uzoo-anime repaint sequence-next sequence-001
+uzoo-anime repaint sequence-next sequence-001 --yes --step r1 --expected-cost OO
+uzoo-anime repaint sequence-recover sequence-001 --step r1
+```
+
+1. sequence只保存本地调度清单并只读检查，步骤为1–100项，子operation和同片段同阶段不得重复。模型/替换等缺失选择按统一交互流程补齐。
+2. sequence-next不带--yes只准备当前next_step，展示result中的参数、实际钱包、估价和blockers。后续阶段依赖前序结果，total_estimated_credit_cost为null，不把已知单项报价当总价。
+3. 收到本项明确确认后，使用当前子operation作--step并携带--expected-cost；CLI再次校验实时费用。过期的步骤确认不能用于下一项；预选、总价预览、另一段/阶段的授权不适用。
+4. 已提交、失败或未知步骤不重发；sequence-get只读查询，sequence-recover仅恢复指定原子operation。前序未完成/未同步、回退结果、输入/方案/规则/附件变化或节点被删时停止，不跳过失败或自动重做。
+5. 完成本项后重新sequence-get/sequence-next准备下一项。CLI退出后远程任务仍可继续；重新执行同调度与子operation恢复，不依赖当前Agent会话内存。取消仅停止未提交步骤，不声称远程任务已取消。
+
+本地模拟服务验证两段串行、重启、逐步确认和原结果复用，并覆盖三类单段调度、价格变化与未知提交不重发。真实多段验收单独记录；不将本地测试标为真实模型完成。产品批量入口、整片拼接及额外参考仍只按实际画布入口评估。
+
+
+均匀分段真实预检补充：6.385秒源素材按4秒间隔实际返回单段方案，未确认切片。详情在成功保存后缺失时按既有规则停止；本轮保留原任务待审核，不自动恢复或重提。真实两段仍待至少8秒且适合分段的用户指定素材。
+
+## 下载契约更新（2026-10-31）
+
+新提供的下载说明取消团队成品白名单，仍校验原分段/转绘任务完成、归属与公开/私有可见性，团队下载保留审计。本指南早前2001/白名单拦截是旧部署真实记录，不能据此判定新版接口不可用，也不能只凭文档推定当前服务已更新。
+
+`video-download`及`export --type video`仍从原任务download入口取完整url，再匿名读取文件。仅文件GET允许最多5次307引用续期，不放宽API/上传的跳转规则；不能续期、权限/下架错误、非完整文件响应均停止。新业务入口无filename/format参数，不在CLI拼接转换参数。下载不触发生成、处理、入库或画布写入；签名凭证不公开展示。具体流、错误与完整性规则见[下载与文件凭证](commands.md#下载与文件凭证)。
+
+下载补验更新：同日随后当前账号的原转绘视频已通过原业务入口成功下载，文件大小/摘要与FFprobe/FFmpeg整条视频流解码通过；原画布未变，无新生成。此前禁止下载为旧部署验收记录，当前两条原结果的阻塞已解除。没有据此验收所有团队成员权限、真实过期引用续期、音频效果或网页人工播放。

package/.agents/skills/uzoo-anime-cli/references/seedance-review-workflow.md

@@ -0,0 +1,41 @@
+# Seedance 图片与视频素材审核
+
+用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md)：沿用已明确选择，缺项优先用卡片收集，等待回复后继续原任务；本路线的执行、签署与恢复边界仍按下文，不扩展功能。
+
+用于显式审核当前普通图片/视频节点的素材，或审核下游生成节点所引用的同画布图片/视频。运行前缀为 `uzoo-anime --profile PROFILE`。命令已实现并通过模拟契约验证；真实单图片审核→通过→回填→下游生成请求复用已验证，2026-11-02原图片与视频双素材审核已真实通过，视频新提交后Active、图片复用已有审核，画布状态与下游请求双任务关联已核验；网页审核标记人工验收及更多组合仍待完成。
+
+## 与生成、签署的关系
+
+含人脸素材用于 Seedance 视频时，按产品要求先审核，真人与动漫均不能据形象跳过。CLI 不具备自动识别人脸能力。签署《统一协议》《Seedance2.0模型使用承诺书》是账号/版本同意，不代表素材通过审核，分别使用 [协议流程](agreement-workflow.md)。审核不是视频生成授权，也不自动启动生成。
+
+显式审核支持单素材和批量；generation 请求的 enable_asset_review 是另一条后端生成内审核路径。当前未实现所有前端自动审核交互的等效编排，不将该字段或本命令存在当作整条生成路线已验收。
+
+## 准备与执行
+
+1. 复用登录和已确认空间，读取目标画布，核对 team_uid。审核素材必须能关联到同画布内当前账号可访问的真实已完成图片/视频任务；file_ref 须与任务结果一致。素材库 ID 不能当任务 ID。图片宽度须为 300–6000 像素，宽高比 0.4–2.5，缺少尺寸先核对原图。
+2. 将实际 ID 写入 UTF-8 `review.json`，例如团队当前素材：
+
+   ```json
+   { "doc_id":"DOC_ID", "node_id":"SOURCE_NODE_ID", "space":"team", "team_uid":"TEAM_UID", "mode":"current" }
+   ```
+
+   `mode: current` 审核该节点自己的媒体输出；`mode: upstream` 将 node_id 改为下游生成节点，合并入边及持久参考中的图片/视频，忽略文本和音频，不审核尚未生成的下游输出。当前无按任意列表选择部分上游的命令。
+3. `review start --input review.json --operation material-check-001` 仅预检并列出真实任务、素材类型与来源节点，不提交审核、不保存画布或创建 operation。先核对素材范围和当前服务开放状态。它没有生成费用估价，不把预览输出理解成任何部署均免费；需要收费承诺时先核实当前服务。
+4. 用户要求审核的范围已明确后，同命令加 `--yes` 提交审核。先查已有状态，仅在没有记录时 POST；不 force 重审，不重发已有失败或结果未知的审核。相同 operation 绑定账号、服务、输入及素材/任务关联，不能改输入复用。
+5. `review get material-check-001` 查询原审核，不保存画布；`review wait material-check-001 --interval 3000 --timeout 180000` 等待并回填状态；`review recover material-check-001` 查询并恢复回填。active 须有后端真实 asset_uri、submission_id，不能手写状态。
+6. 核验返回 state、逐素材 status 和 canvas_synced，并读回画布的 extra.seedance_review、持久参考关联。随后重新 `generation prepare`，检查 reference_canvas_task_ids 等实际关联，再按 [生成流程](generation-workflow.md) 估价并取得当次生成确认。审核本身不创建新媒体节点或生成任务。
+
+## 恢复与限制
+
+- rejected 表示已识别的参数/权限等拒绝；failed 表示查到审核失败；unknown 表示提交结果不确定或原审核暂查不到。保留 diagnostic/last_failure 的 HTTP 与业务错误码，不能把审核阻塞报告成视频生成执行失败。通用业务投递错误可能发生在记录保存后，仍按未知结果先查询。
+- 提交响应丢失后只 recover/get 原 operation；即使加 --yes 重复 start，也不会重发 POST。GET 可能触发后端已有审核的状态刷新或工作队列恢复，CLI 不发新的审核提交。
+- 版本冲突或保存响应不完整返回 REVIEW_SYNC_PENDING。先读取最新画布，再 recover 原审核；已完成审核不重做，原节点或引用变化时停止。批量中途受阻也不自动重提或补交其余项，先核对逐项状态。
+- 查询成功与画布同步成功分别报告；get 不确认同步结果。CAS 防止基于已过期版本写入，但不能消除浏览器另一次自动保存造成的数据覆盖；必要时协调暂停编辑目标画布。
+- 当前仅支持普通节点、同画布且有真实已完成任务关联的素材。跨画布/缺少任务关联的库素材、force 重审、指定部分上游以及派生流程审核未接入。素材或任务关联变更后，不将旧 active 记录套用到新媒体。
+- 本地审核记录位于用户配置目录的 reviews/PROFILE 下，包含素材引用；不要写入仓库或分享完整记录。不在运行时加载前端源码。
+
+审核凭证重新签发时，在任务/画布/媒体类型/完成状态绑定通过后，以现有匿名文件读取核验长度和SHA-256；同一媒体不因凭证字符串不同误拒，内容不同或无法核验仍停止。此核验不提交审核，不把旧审核套用到新媒体。
+
+## 2026-11-05 已验范围核对
+
+图片1986／视频1989双素材Active、画布关联、prepare及真实下游请求复用和网页审核标记已有2026-11-03证据；不再标为“视频／批量／网页均未验”。三类型图片／视频／音频仅prepare映射与模拟，不为凑组合重新收费；更多有效批次、任意子集／跨画布／完整自动审核交互仍按实际已接范围及受控条件声明。

package/.agents/skills/uzoo-anime-cli/references/video-tools-workflow.md

@@ -0,0 +1,71 @@
+# 视频素材工具：剪辑与截帧
+
+用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md)：沿用已明确选择，缺项优先用卡片收集，等待回复后继续原任务；本路线的执行、签署与恢复边界仍按下文，不扩展功能。
+
+适用于普通视频生成或视频素材节点上的已有视频截取。运行前缀为 `uzoo-anime --profile PROFILE`。当前已实现剪辑预检、单次截取、结果/连线保存及原片段恢复；模拟和真实前端请求/保存重开兼容通过。真实单次 2 秒截取、新节点/连线、真实 MP4 读取与 0 费用画布任务已验证；网页人工播放尚待确认。历史首次 code 5000 的未知操作保留，不与后续明确授权的成功复测混为同一笔。
+
+剪辑裁取原媒体的时间范围；截帧读取指定时刻的原画面，两者均不提交 AI 生成。去字幕按用户说明暂停服务；片段重拍见[专用流程](remake-workflow.md)，转绘后续仍按能力表判断，不把素材处理命令当作这些功能已接入。
+
+## 本机依赖与按需安装
+
+| 功能 | 用户本机需要的依赖 | 检测方式 |
+|---|---|---|
+| 视频截帧、本地视频信息探测 | FFmpeg 软件包，必须同时包含 `ffmpeg`、`ffprobe` 可执行工具；这不是另装同名 npm 包即可满足的依赖 | `video tools`；可指定 `--ffmpeg PATH --ffprobe PATH` |
+| [图片裁剪](image-tools-workflow.md) | 同一 FFmpeg 软件包内的 `ffmpeg`、`ffprobe`，复用已有安装 | `image tools` 或 `video tools`；可指定工具路径 |
+| [图片标注](image-tools-workflow.md#图片标注) | 同一FFmpeg工具，图形需drawvg、文字需drawtext及包含实际字形的本机字体；无文字无需字体 | image tools查基础工具；image annotate预检检查实际过滤器及字体，缺少时先询问更新/安装或已有路径 |
+| 当前视频剪辑 | 没有新增的本机媒体工具要求，后端执行截取 | `service status` 及真实剪辑接口；不要因后端使用 FFmpeg 就要求用户本机安装 |
+
+按用户选定的折中方式，npm 包暂不捆绑二进制，由 Agent 在使用需要本机工具的功能时处理依赖：
+
+1. 先检测并复用可用工具。用户给过路径则沿用；仅 PATH 找不到时可只读检查明确的现有安装位置，不扫描整机。已有工具可运行就继续，不重复询问安装。
+2. 缺失时 CLI 返回 `MEDIA_UNAVAILABLE`（退出码2）和 `error.dependency`：status=awaiting_dependency_installation、package、required_tools、missing_tools、checks、installation_requires_confirmation=true、installation_performed=false。`checks` 区分 available/missing/unavailable/invalid_response；已有程序不能运行或版本响应异常时 status=dependency_unavailable，先核对路径、执行权限或版本，不自动认定要重装。解码失败本身不代表缺包。
+3. Agent 根据用户系统/架构核对当前官方来源或可信包管理器的实际安装项，先准备具体方案，再询问用户是否安装并继续。说明软件名与用途、下载来源、安装范围及必要 PATH/管理员权限变更；无需安装未用工具或开发机前端依赖。示例：“截帧需要 FFmpeg（含 ffmpeg 和 ffprobe），当前未找到。拟通过〔已核实的来源/方式〕安装到〔位置/范围〕，〔是否修改 PATH〕。是否安装后继续原截帧任务？也可提供已有工具路径。”来源/位置必须换成本次已核实方案，不把示例占位符直接发给用户。
+4. 等用户明确同意后才由 Agent 执行该安装，遵守宿主系统执行/网络审批。普通截帧授权、`--yes`、缺少依赖的报错均不算安装同意；不要默认同意许可证、静默提权或扩大安装范围。已有明确的同次安装授权不重复询问。用户不安装则暂停本功能，说明缺少项，保留原参数/operation；可继续不依赖这些工具的其他已授权工作。
+5. 安装或用户提供路径后，再运行 `video tools` 验证两个工具。PATH 尚未对当前 Agent 进程生效时，可使用实际可执行文件路径，不擅自改系统配置。检测通过后继续原请求；已有 operation 则先查询并按原 frame-recover 阶段恢复，不换 operation，也不重做未知上传或已扣费生成。只查询结果或复用已导出的缓存不需要重新安装解码工具。
+
+CLI 本身不执行安装器，不在 npm 安装或调用功能时自行下载工具；安装由获得同意的 Agent 执行。本次开发机已有 FFmpeg，未实际执行新安装；安装体验待真实缺依赖环境验收。图片裁剪复用这套依赖；未来接入其他本机处理时须补实测依赖说明，当前未接入功能不预先承诺安装什么包。
+
+## 输入与执行
+
+1. 沿用已确认空间/团队，读取最新画布。源为普通 video/video_upload，须有同画布真实已完成视频任务，当前 file_ref 与任务一致。无任务关联的素材库 source_ref、跨画布或派生源暂未接入；不能把 clip ID 当画布任务 ID。
+2. 明确起止时刻，使用整数毫秒，起点非负，片段时长 500–120000ms，终点不超过实际源视频时长。没有时刻选择才询问，不自动裁掉用户要保留的内容。
+3. UTF-8 clip.json 示例：`{"doc_id":"DOC_ID","node_id":"SOURCE_NODE_ID","space":"team","team_uid":"TEAM_UID","start_ms":0,"end_ms":2000}`。个人空间移除 team_uid。
+4. `video clip --input clip.json --operation trim-001` 只预检，不创建 operation/产物/画布节点。核对任务与区间，协调暂停同画布旧页面编辑，再加 --yes。CLI 在实际截取前检查后端就绪；异常时按 [连接排查](commands.md#后端连接与异常排查) 处理。
+5. CLI 单次 POST /video/clips，后端同步 ffmpeg 截取并保存片段，不提交 AI 生成、不做生成费用预扣；可能占用存储。当前源码在具备画布归属时为产物建立真实 0 费用已完成画布记录，不能称为 AI 生成成功。
+6. 成功响应中 id/clip_task_id 是片段 ID，canvas_task_id 才是本片段的真实画布任务；source_task_id 指向源视频。CLI 仅将 canvas_task_id 写入新节点的 last_task_id，不拿片段 ID 或整片源任务替代。缺少 canvas_task_id 时保存媒体但不承诺能走要求真实任务的审核/入库路线。
+7. 以新 video_upload 素材节点保留结果，并保存源→结果的 video-clip-link 系统线；不替换原视频。读取最新画布 CAS 一次保存，保留其他内容。读回结果 URL/file_ref、区间时长、原视频与连线，再在网页重新加载核对播放。真实媒体产出、保存和网页可用分别验收。
+
+## 查询与恢复
+
+- `video clip-get trim-001` 查询原操作和当前来源；不重新截取、不保存画布。返回最后的真实 clip/canvas_task_id 与 canvas_synced。已保存节点/连线后来删除或变更时报告 canvas_changed，不再报当前已同步。
+- `video clips --limit 50 --offset 0` 查询当前账号真实片段列表。列表是账号级查询，不自动拿其中素材跨空间落图；恢复仍按原画布/任务归属校验。
+- `/video/clips` 没有请求幂等保证。响应丢失后原 start --yes 也不会重发；先检查后端连接和原片段列表。确认对应本次的新片段 ID 后才执行 `video clip-recover trim-001 --clip-id CLIP_ID`，核对账号、源任务、起止区间、提交前片段基线后复用原产物。不能仅凭同名或相同时长自动猜一个结果；找不到时停在未知状态。
+- 已有 clip 响应但画布未同步时，`video clip-recover trim-001` 只保存原产物，绝不再次截取。明确 CAS 拒绝后可用最新快照恢复；保存响应丢失先读回已分配节点 ID，已存在则核验，不重复追加。
+- 保存已尝试但结果节点缺失时，不能分辨未保存与保存后被删，停止调查；已删除结果节点或连线不自动重建。源任务/素材或账号/服务变化停止，保留原操作。
+- CLIP_RESULT_UNKNOWN/CLIP_SYNC_PENDING 为退出码 4。错误后先检查连接、原操作和片段/画布，再定位具体接口；健康检查正常也可能有对象存储或剪辑处理故障。不会切换服务或自动重发。
+
+本地记录在用户配置目录 video-clips/PROFILE，含真实媒体引用；不要分享或提交原记录。CLI 运行不依赖前端源码或浏览器，网页关闭不影响后端同步处理，但 CLI 退出后需要原 operation 完成画布同步。
+
+## 视频截帧
+
+已接入本地解码、单次 1–3 帧 JPEG 导出、画布素材上传、真实上传任务绑定和系统线保存。模拟、真实 FFmpeg 解码与前端流程/codec 兼容通过；真实单帧 1000ms、原像素 640×640、图片读取和 0 OO 上传任务通过。第1/2秒两帧真实JPEG上传、640×640读取和0 OO任务已通过；早期网页保存后缺失曾失败；2026-11-02经用户明确授权复用原产物恢复，用户确认保存重开及536版只读核验通过。其他编码／时刻组合仍未全验，不自动重建后续被用户删除的节点。
+
+1. 沿用已确认空间/团队，读取最新画布并核对普通 video/video_upload。当前支持同画布真实已完成视频任务，源引用与任务对应；无任务的素材库来源及派生源暂未接入。用户明确时刻后沿用，缺少时才问；时间为整数毫秒，必须早于视频末尾，一次最多 3 帧，自动按时刻排序。相同或间距小于半帧的选择停止，不悄悄多生成重复图片。
+2. 先用 `video tools` 检查本机 FFmpeg 和 FFprobe。两者须在 PATH 或显式通过 `--ffmpeg PATH --ffprobe PATH` 提供；缺失按 [按需安装](#本机依赖与按需安装) 说明依赖并询问，用户同意安装后再由 Agent 执行。当前仅 Windows 实机验证。
+3. UTF-8 frames.json 示例：`{"doc_id":"DOC_ID","node_id":"SOURCE_NODE_ID","space":"team","team_uid":"TEAM_UID","times_ms":[1000]}`；个人移除 team_uid。`video frame --input frames.json --operation frames-001` 只预检，不创建本地 operation、节点或上传。如果任务重新签发引用而与节点值不同，会通过正常文件代理匿名流式读取双方媒体，比较大小及 SHA-256；仅同一内容才继续，不凭同名/尺寸相同判断，也不解密引用。无法读取或内容不同即停止。
+4. 确认时刻与来源并暂停同画布旧页面编辑后，加 `--yes`。CLI 检查后端 ready，下载源视频（上限 500MB），按真实帧显示时间戳解码，输出原尺寸 JPEG。输出 `time_ms` 是指定时刻，`frame_time_ms` 是该时刻实际显示帧的起始时间，二者可不同。使用 FFmpeg JPEG 质量参数，语义与前端原尺寸 JPEG 对齐，但不承诺等同浏览器 quality=0.92 的字节/压缩结果。
+5. 为每帧在源视频右侧分配避免重叠的位置，创建图片素材准备节点和 `video-frame-capture-link` 系统线；后端要求节点已存在，随后才申请普通画布上传会话、PUT 分片、单次 complete。取得真实 `local-upload` 完成任务后保存 URL/file_ref/last_task_id，清除 uploading。准备节点不是已成功产物，只有 state=completed 且 canvas_bound=true 才进入完成核验。
+6. `video frame-get frames-001` 只查询原记录和当前画布。核对各帧真实任务、媒体类型/尺寸、来源连线、原视频保留及实际图片可读；后续重新打开网页核验显示。不会自动入素材库，入库须用户另行指定目录并按素材流程执行；不自动审核截图或接着生成。
+
+## 截帧异常与恢复
+
+- 错误优先运行 service status，再查原 operation、画布和任务，保留原 HTTP/业务码/request_id。`frame-recover frames-001` 默认只查询，加 `--yes` 才按已确认原阶段恢复；重复 frame --yes 只查询，不能用新 operation 绕过未知结果。
+- 本地缓存记录源视频与 JPEG 的 SHA-256；已完成解码不重复做，文件被改则停止。未完成的本地导出可恢复；分片失败时只使用已知原会话和本地产物，不新建第二次会话。会话创建结果未知时停止，不自动再次申请。
+- complete响应丢失或失败后绝不自动重发complete/重传：只查询原doc_id/node_id下唯一可核验的已完成图片上传任务且文件名/尺寸匹配，复用其结果绑定。模型名被转为显示标签时，还需后端上传回填task_id/file_ref及0费用charged证据，不凭显示名猜测。无唯一结果停在upload_unknown，需要调查，不能把没有查到当作绝无副作用。
+- 图片已上传但绑定 CAS 冲突只恢复保存，绝不重传；保存响应未知先读回预分配节点和连线。明确 CAS 拒绝可以最新快照恢复；保存已尝试但节点缺失，或已保存节点/连线被删除/素材被替换则停止，不自动重建或覆盖用户编辑。账号、服务或源素材变更同样停止。
+- MEDIA_UNAVAILABLE 退出码 2；FRAME_UPLOAD_UNKNOWN/FRAME_SYNC_PENDING 退出码 4。查询命令仍须检查 state（如 upload_unknown、sync_pending、canvas_changed），不能只按退出码判断成功。
+- 记录及缓存位于用户配置目录 video-frames/PROFILE，包含真实引用和视频/图片，不提交或公开分享。运行不需要浏览器常开；CLI 退出后的上传/保存恢复使用原 profile、operation 与原工具路径。
+
+2026-10-31多帧补验：两个本地产物和上传任务完成，525版两节点/来源线读回成功，重复get无写入。网页随后保存到526版时新增节点/线缺失；527版源节点配置也改变，frame-get因源绑定变化停止，未自动重传、恢复或重建。不能把之前state=completed当作当前画布仍绑定成功；保留原operation及远端任务，用户明确决定后才安排进一步处理。
+
+2026-11-05收尾核对：原2秒剪辑、裁剪／矩形标注的网页显示／播放已由用户2026-11-02确认正常；原第1／2秒两帧及素材107导入保存重开、536版读回通过。早期节点丢失为历史，不作为当前整条路线失败；不把有限样例扩大为所有格式／编码已验。

package/CHANGELOG.md

@@ -0,0 +1,92 @@
+# 更新记录
+
+## 0.5.0 — 2026-11-05
+
+本版本按已确认的公开包／latest策略构建，实际registry发布状态以npm查询为准。
+
+- 首发范围为Windows上的普通画布／节点／分组／复制／历史、素材与下载、普通生成／审核／本人协议续接、样片转正片及已接图片／视频工具；异步免费抠图真实202／原job恢复／落图及用户网页重开已验。
+- 同步明确的public／官方registry／latest配置、版本与安装说明；维护者检查同时支持显式private候选和完整公开发布策略，拒绝RC串latest、非官方registry或隐式开放发布。
+- 新增本地check:release及prepublishOnly检查版本／lock／更新记录／许可证与运行资源；这些检查不认证账号、不启用2FA、不代表实际发布授权。
+- 发布回归两次遇到Windows本地journal原子替换EPERM；对EPERM／EACCES／EBUSY仅有限重试已刷盘临时文件的rename，持续失败仍保留原文件并报错，不删除旧记录或重放任何网络提交。
+- 保留旧profile、凭据与operation恢复路径，不因版本更新重提任务；转绘、去字幕、N5及用户暂缓的边界专项仍不开展。
+
+
+## 0.5.0-rc.8 — 2026-11-05
+
+- 核对非转绘收尾范围与最新证据，校正skill中审核／剪辑／截帧／组框／下载命名／异步抠图的陈旧验收状态，保留历史记录。
+- 明确剩余2078大小元数据交接、真实边界／条件性能力及npm发布前置项；已通过的历史网页、样片转正片、协议原operation续接和抠图不再列为阻塞。
+- 重新执行44组完整回归通过；本候选不改变CLI业务实现，不提交真实任务／写画布，不开展N5或发布npm。
+
+
+## 0.5.0-rc.7 — 2026-11-05
+
+- 正式站CLI权限修复后完成异步抠图真实验收：202提交、CLI退出后原job查询、实际0 OO、透明PNG取回、原operation一次CAS落图及重复恢复不重放。
+- 用户确认本次结果及来源线显示正常、保存重开仍在；其后109版独立只读核验通过。原图、旧operation及旧产物保留，不入库。
+- 本候选仅同步验收结论／文档／skill及版本，不变更CLI业务实现；旧仓库权限快照不作为最新部署证明。无job_id的未知提交仍不自动重发。
+
+
+## 0.5.0-rc.6 — 2026-11-04
+
+- 按用户提供的新异步接口说明增加image matting-submit：一次POST /matting/jobs确认202后持久保存job_id；原matting-get／matting-recover查询原服务端任务，成功后取回透明PNG并一次CAS落图。
+- 保留旧同步接口和独立本地worker／operation兼容；matting-status仍为离线本地快照，异步job查询与本地worker心跳分开。
+- 提交响应丢失且没有job_id仍不重提；queued／processing／succeeded／failed／cancelled分别处理，费用不是0、引用／来源／身份异常停止落图。44组完整回归及最新前端实际service对照通过；正式站一次提交返回3001未取得job_id，保留原operation且不重发，真实完整路线待后端部署／原请求核验。
+
+
+## 0.5.0-rc.5 — 2026-11-04
+
+- 新增image matting-start独立后台执行及matting-status本地状态查询；启动命令退出后继续等待原HTTP响应，缓存PNG后停止，由原matting-recover --yes确认回填。
+- 后台持有原profile锁，状态／后台matting-get不联网、不争锁；不伪造实时进度或自动重发未知处理，进程中断保留原operation。修正抠图查询／恢复位置参数校验。
+- 正式站原图7738后台免费处理、透明PNG、启动命令退出后完成缓存、原operation恢复及一次CAS读回通过：104→105版，新增1节点／1来源线，保留原内容。新结果网页重开未重复验收；前一结果用户网页验收仍保留为独立证据。
+
+
+## 0.5.0-rc.4 — 2026-11-04
+
+- 新增免费抠图image matting及原operation查询／恢复；签名multipart、受限PNG二进制响应、原字节缓存和透明像素核验、独立素材节点／来源线及一次CAS读回。
+- 已知原结果引用可通过GET恢复缓存；未知处理响应不重发、未知保存不重放、用户删除不重建。缺少服务端未知提交查询契约的边界明确保留。
+- 正式站CLI已由本人完成正常授权，保留开发站profile及原operation。正式站原图7738免费处理／透明PNG／落图／原引用读取及用户确认网页重开通过；修正网页规范化后的恢复误报。42组完整模拟及前端对照通过，详见业务记录。
+
+
+## 0.5.0-rc.3 — 2026-11-03
+
+- 新增普通图片／视频 `generation history-add`，预览后一次CAS保存独立成品节点，保留来源历史，原任务不变为新节点的生成任务；输入、审核和样片执行状态不继承。
+- 新增原operation只读 `history-add-get/history-add-recover`；保存未知不重放，后续其他节点变化不误判成新增失败。
+- 图片1986／视频2069历史新增真实服务及网页重开通过；原图片1986采用、保存重开、恢复2071再次重开通过；2073正片网页完整播放通过。
+- 授权拒绝仅显示受限协议错误符号；正式站实际返回2110/cli_auth_disabled，用户选择暂不启用，抠图执行／真实验收保持阻塞。
+- 本轮无新生成、上传、入库或费用，npm保持private，未发布。
+
+## 0.5.0-rc.2 — 2026-11-03
+
+- 已完成用户认可样片2072后，独立确认260 OO并生成2073高画质正片的真实CLI闭环；核验父子关系、两阶段费用、独立结果／来源线、完整解码及重复恢复无副作用。
+
+- 修复真实样片任务返回基础模型展示名时被普通回填误拦；只接受样片元数据与实时目录共同证明的映射，精简目录仅支持已核对的Seedance 2.5 Draft别名。
+- 回填extra.draft保留样片有效期／状态；重复sync按对象深比较，不重复写画布。
+- 真实任务2072样片完成、52 OO、回填和下载通过；有效至2026-11-10 16:28:56（北京时间），没有提交正片。用户截图补充图片历史两条缩略图及2071成品可见，保存重开仍待验。
+
+
+## 0.5.0-rc.2 — 2026-11-03
+
+- 修复真实样片任务返回基础模型展示名时被普通回填误拦；只接受样片元数据与实时目录共同证明的映射，精简目录仅支持已核对的Seedance 2.5 Draft别名。
+- 回填extra.draft保留样片有效期／状态；重复sync按对象深比较，不重复写画布。
+- 真实任务2072样片完成、52 OO、回填和下载通过；有效至2026-11-10 16:28:56（北京时间），没有提交正片。用户截图补充图片历史两条缩略图及2071成品可见，保存重开仍待验。
+
+
+## 0.5.0-rc.1 — 2026-11-03
+
+候选版本，尚未发布npm registry；原0.4.0归档、配置和operation保留。
+
+正式包名更新为@uzooai/anime-ai-cli，采用MIT许可证，命令名uzoo-anime和配置目录不变。旧demo全局包迁移前需处理同名命令冲突，见安装指南。
+
+- 新增普通图片／视频生成结果及图片／视频／音频素材单个和1–100混合复制，来源历史与副本任务归属分离，保留审核及批内引用映射。
+- 新增分组移动、组框尺寸调整、组内布局；修正断线保留持久参考时的模式计算。
+- 新增样片转正片专用准备／提交／恢复流程，真实正向验收仍待有效样片及当次授权。
+- 补齐同节点再次生成的提交前快照保护，明确区分协议拒绝和未知签署结果；本人独立签署真实通过。
+- 直接图片请求也严格限制数值image_count=1；下载读取实际服务端文件名，每次通过业务入口取链接。
+- 抠图预检更新为免费产品服务，明确当前部署／恢复契约与执行限制。
+- 新增--version、version和skill path本地查询；新增build、prepack、pack:local、白名单及归档完整性检查。
+- 原配置目录和operation格式未迁移，不执行升级后退出／重新登录。跨版本安装／回退仍未做N5实机验收。
+
+已知边界与使用说明见[线上发布及安装使用](docs/npm线上发布与安装使用.md)。转绘／去字幕继续暂停，未恢复专项。
+
+## 0.4.0 — 已有内测基线
+
+保留原包及历史验收记录；不是本次新发布版本。此前没有registry发布证明，不将内测归档冒称线上已发布。