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

package/.agents/skills/uzoo-anime-cli/references/node-capabilities.md

@@ -0,0 +1,64 @@
+# 节点用途、素材工具与 CLI 接入状态
+
+转绘暂停。CLI 仍可按用户明确授权查询、下载原结果或排障。单片段重拍是独立功能。
+
+下表用于判断网页操作能否通过 CLI 完成。以命令帮助、实际服务和专用流程为准。
+
+## 普通节点的用途
+
+独立「视频转绘」页面：**CLI未接入，暂不实现**。本指南的转绘接入状态仅指画布内入口和派生流程；独立页素材池选择/排序/生成不纳入当前计划。
+
+| 节点 | 主要用途 | 操作指南 |
+|---|---|---|
+| 文本 | 编写文字要求，或用模型理解文本/图片/视频，输出可传递的文本 | 普通生成按生成流程；模型理解能力和输入类型按实际目录核验 |
+| 图片生成 | 接收提示词及合法图片参考，生成图片；有结果后网页提供素材工具 | 生成链路已接入；当前 prepare 仅支持单张，素材工具状态见下表 |
+| 视频生成 | 接收提示词及当前模型允许的图片/视频/音频参考，生成视频 | 独立生成链路已接入；协议签署与素材审核分别处理，无“无声”开关 |
+| 音频 | 网页提供音频节点入口 | CLI 可创建节点，目前不支持音频生成提交，不承诺其完整业务可用 |
+| 图片/视频/音频素材 | 承载上传、素材库导入或处理后媒体，作为下游输入 | 上传与素材库使用见素材与分组流程；有引用后核验可读取媒体 |
+| 视频转绘入口 | 历史画布转绘入口 | 开发与专项补验暂停；保留已有入口和记录，不因新普通画布任务自动创建或续做 |
+
+直接创建范围及 API 类型见 [节点创建](node-workflow.md)。普通生成见 [生成与恢复](generation-workflow.md)；上传、素材库及连线见 [素材与分组](material-graph-workflow.md)。
+
+## 图片有素材后的工具
+
+| 功能 | 网页用途与操作 | 结果与原图关系 | 当前 CLI |
+|---|---|---|---|
+| 裁剪 | 按原图像素选区 | 新素材及来源线 | 已接矩形或最大居中比例，需 FFmpeg/FFprobe，限静态 PNG/JPEG |
+| 标注 | 绘制形状或文字 | 新图片或素材节点及来源线 | 已接像素坐标指令，需 FFmpeg 的相应渲染能力 |
+| 抠图 | 固定 general 去背景 | 透明 PNG 素材及来源线 | 支持同步、本地后台与服务端异步，按原 operation 查询与恢复 |
+| Seedance 审核 | 审核图片或下游引用 | 保存审核状态和关联 | 支持显式当前／上游审核、查询和恢复 |
+
+## 视频有素材后的工具
+
+| 功能 | 网页用途与操作 | 产出 | 当前 CLI |
+|---|---|---|---|
+| 剪辑 | 按起止时间截取 | 新视频素材及来源线 | 限同画布已完成任务 |
+| 截帧 | 按时间取帧 | 每帧生成素材及来源线 | 需 FFmpeg/FFprobe，一次 1–3 帧 |
+| 片段重拍 | 选片段、模型及提示词 | 独立视频结果及任务关联 | 支持单源视频，不支持附加参考或批量重拍 |
+| 转绘 | 原分段及派生节点 | 原任务结果 | 暂停；仅按授权[查询或下载原结果](repaint-workflow.md) |
+| Seedance 审核 | 审核当前视频或下游参考 | 保存审核关联 | 支持显式审核；任意子集、跨画布及完整自动审核编排未接入 |
+| 去字幕 | 框选字幕区域处理 | 新视频素材 | CLI 未接入 |
+
+转绘已接入步骤、命令及待完善路线以 [视频分段流程](repaint-workflow.md) 为准。派生节点由处理流程创建，不等于必须执行前端代码；CLI 自行编排时也要保存等效节点、连线、任务与结果，不能只调用单个接口就宣称完成流程。
+
+剪辑与截帧已实现步骤、外部工具依赖和恢复见 [视频工具](video-tools-workflow.md)；重拍按专用流程，去字幕暂停服务。功能错误先按连接排查核验服务，保留原接口错误与原 operation，不把未知结果判成“没有任务”。
+
+抠图、去字幕在网页上受部署功能开关控制；开发环境出现入口不表示所有部署都开放。不要固定承诺费用，按实际处理接口与钱包核对；有收费副作用时仍需当次费用确认。
+
+## Seedance 素材审核与协议
+
+- 用户已明确产品规则：用于 Seedance 视频生成的含人脸素材，真人与动漫都需要审核；不能以动漫形象为由跳过。不据此声称前端具备自动识别人脸的逻辑；源码中的审核流程收集图片/视频引用并提交审核。
+- 用户签署《统一协议》与素材通过 Seedance 审核是两件事。协议命令只解决账号/版本签署，不代表任何素材已审核。
+- review start/get/wait/recover 支持同画布普通节点的当前及上游图片／视频审核。需要真实完成任务，且素材引用匹配；只复用真实 Active 任务关联。
+- enable_asset_review 传输字段对应后端生成内审核，与独立 review 操作不同；前端自动审核交互尚未全部等效。签协议、节点创建、传输字段、出现审核标记均不代表真实审核通过，不能手写 active/assetUri 或伪造任务。
+
+## 其他前端流程差异
+
+| 网页功能 | CLI 当前边界 |
+|---|---|
+| 持久参考、断线与 @ 标记 | prepare 合并有效引用、分离文本上下文，复用实际审核关联 |
+| Seedance 样片转正片 | 支持独立报价、继承父样片、结果节点和原任务恢复 |
+| 结果入库 | 支持同空间普通图片／视频及有任务关联的素材；不自动入库 |
+| 历史 | 支持普通图片／视频选用历史或添加为独立节点；来源历史不成为副本自己的任务 |
+| 下载和预览 | 支持原生成结果及素材空间原文件下载；不支持请求改名、格式转换或通用媒体预览 |
+| 分组与画布编辑 | 支持普通节点复制、删除、断线及分组；缩放只改组框，不缩放组内媒体 |

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

@@ -0,0 +1,90 @@
+# 节点创建与核验
+
+用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md)：沿用已明确选择，缺项优先用卡片收集，等待回复后继续原任务；本路线的执行、签署与恢复边界仍按下文，不扩展功能。
+
+用户要求添加节点时读取本文件。沿用已确认的空间、团队和目标画布；缺少时按 [画布流程](canvas-workflow.md) 查询并补齐。真实生产只直接创建普通节点；派生节点由真实业务流程创建。只创建普通空节点不需要选择模型、上传素材或预估生成费用。创建完成并读回后停止，不把创建授权延伸到分析、分段、生成或收费任务。
+
+## 类型与范围
+
+各节点用途、素材工具的操作方式及 CLI 已接入/未接入对照见 [节点功能说明](node-capabilities.md)。本文负责创建与读回核验，不将前端裁剪、剪辑、审核或重拍等功能视为 node add/update 已支持。
+
+| CLI `--type` | 保存后的 API type / 标记 | 网页节点 |
+|---|---|---|
+| `text` | `text` | 文本 |
+| `image` | `image` | 图片生成 |
+| `video` | `video` | 视频生成 |
+| `audio` | `audio` | 音频；当前 CLI 不支持音频生成提交 |
+| `image_upload` | `image_upload`，`extra.node_kind=asset` | 图片素材 |
+| `video_upload` | `video_upload`，`extra.node_kind=asset` | 视频素材 |
+| `audio_upload` | `audio_upload`，`extra.node_kind=asset` | 音频素材 |
+| `video-repaint` | `video_repain_begain`，`extra.repaint.role=entry` | 视频转绘入口 |
+
+上表 8 种为普通节点。视频转绘入口是普通配置入口，创建入口不触发分析。视频重拍、分段详情、转绘片段/反推提示词/最终提示词/结果等是流程派生节点，不能用 `node add` 独立创建，不能通过给普通节点注入 `repaint`、`video_remake` 或 `clip_redraw` 标记制造派生节点；也不能用 `node update` 把普通节点改成派生节点。CLI 会拒绝这些操作。已有真实流程节点会随画布快照保留，其存在不说明 CLI 已支持该流程。
+
+不要传网页组件名（如 `imageNode`），也不要用 `video` 代替流程节点。CLI 自动补齐素材和转绘入口标记；`--input` 中的 `data.extra` 按一层键合并。空素材节点不表示上传已通过。
+
+用户要求“所有节点”时只覆盖上表普通节点，不额外创建派生占位。不要自行选取私人素材、构造已完成任务或调用生成。若用户要求可运行的业务节点，先确认素材和配置，并核对 CLI 是否实现完整流程；未实现时明确说明能力缺口。组框等画布元数据不属于这些内容节点。整理、打组与按类型展开组合输出的命令见 [素材与分组流程](material-graph-workflow.md)。
+
+## API 与流程的边界
+
+CLI 业务命令直接通过 HTTP 调用后端，不加载网页或执行前端 Vue/store 代码。代理或网关转发 HTTP 不等于执行前端流程；浏览器登录授权是独立步骤。
+
+当前视频转绘由网页负责流程编排：先在本地画布创建带源节点/连线的分段详情并安排保存，再调用分析 API 取得任务 ID；轮询任务更新详情；确认方案并等待切片完成后，再根据后端任务/片段数据创建分段、提示词、结果节点及分组/连线并保存。后端返回任务与业务结果，不会仅因传了画布绑定 ID 就自动创建整条派生节点链。
+
+转绘暂停。仅按[原任务查询与下载](repaint-workflow.md)处理明确授权的原结果；通用 node add/update 不能创建派生节点。
+
+## 执行顺序
+
+1. 复用有效登录，`canvas get DOC_ID` 核对 `team_uid` 与已确认空间一致，确认有写权限。记录当前版本、已有节点、边、视口和 meta；不要清空画布。
+2. 确定节点类型、标题及位置；用户只指定类型时可以用可读标题与互不重叠的位置。每个创建意图先记录固定 `--node-id` 与输入文件，再写入，便于断连后识别。
+3. UTF-8 保存 `node-patch.json`，例如：
+
+   ```json
+   {
+     "position": {"x":120,"y":130},
+     "width":300,
+     "height":260,
+     "data":{"title":"图片节点","prompt":""}
+   }
+   ```
+
+4. 执行一次 `uzoo-anime --profile PROFILE node add --doc DOC_ID --type image --node-id NODE_ID --input node-patch.json`。同画布按顺序创建，不并发写入完整快照。其他普通节点换成表中的 CLI 类型；不额外拼接内部组件字段或流程派生标记。
+5. `canvas get DOC_ID` 读回，验证节点 ID、API type、扩展 role、中文标题、位置、数量与版本；同时核对已有节点/边/meta 未丢失、归属未变化。不要只以命令退出 0 判定网页兼容通过。
+6. 网页可用时打开同一画布并刷新，检查组件、标题及空状态。网页可能自动保存并增加版本，后续操作始终重新读取，保留网页补齐的数据。网页暂不可用时仅标记 API 保存/读取通过，网页待验证。
+
+更新已有节点使用 `node update --doc DOC_ID --node-id NODE_ID --input node-patch.json`，不通过删除重建验证修改。字段契约和并发行为见 [命令说明](commands.md)。
+
+## 异常与交付
+
+- 写入超时/响应不完整：先 get 查固定 ID，存在且内容符合则复用；结果无法确认时停止，不换 ID 追加。
+- 版本冲突：重新读取并检查实际变化；不要自动重放旧快照。已有相同 ID 时先确认是否属于本次意图，不直接重复创建。
+- 组件错型、字段丢失或中文异常：保留响应与节点 ID，修复可确定的 CLI 协议适配后更新原节点；需要前后端改动时单独记录，不覆盖其他工程师修改。
+- 报告实际创建数量/类型、归属与画布入口，区分空节点保存、网页展示、素材上传与业务运行的验证范围。只创建节点时明确未提交生成。真实业务 ID、截图与原始响应留在本地忽略目录，通用 skill 不固化测试环境。
+
+## 同画布单文本节点复制
+
+node copy --input copy.json 默认只读预览；输入doc_id、space、团队team_uid、node_id、new_node_id、position。按用户授权目标和位置执行，--yes须带预览expected_version。新ID固定，重复目标拒绝，防止未知保存后再追加。
+
+仅普通文本节点，保留文本/配置；原上游与持久参考合并为新节点持久引用，外部节点ID保持，不复制连线/分组、不触发生成。进行中任务、派生和媒体节点拒绝；非完成状态清理运行任务绑定。前端媒体复制还有来源历史协议，不能把本命令称为全节点复制。版本冲突或读回失败停止，先查固定新ID，不自动重放。
+
+## 普通节点删除
+
+node delete --input delete.json 默认只读预览；输入doc_id、space、团队team_uid、node_ids，实际执行增加预览expected_version并传--yes。展示节点列表、removed_edge_ids、group_changes、retained_references及mode_changes，用户明确授权具体删除范围后执行。不能把笼统开发请求当作删除业务节点的授权。
+
+删除普通节点及其入出边，按前端规则更新组成员；保留其他节点对已删除源的持久参考与提示词，retained_references明确列出这些目标。它不同于graph disconnect的引用清理语义；不取消/删除远程生成任务、素材库或文件。下游模式按剩余拓扑调整，涉及换模型时停止，不静默切换。系统线、派生流程、进行中节点不支持普通删除。
+
+CAS或预览版本变化停止；保存结果未知先查询原ID是否存在，不自动重放。当前不提供CLI撤销删除命令；执行前需明确选择。真实删除/网页验收按实际记录，不将模拟对照当真实通过。
+
+## 同画布多文本复制
+
+node copy-batch --input copies.json 默认只读预览，输入doc_id、space、团队team_uid、copies及执行时expected_version。copies每项为node_id/new_node_id/position。整批只保存一次，任一目标不合规则全部停止；重复新ID停止，保存未知先按固定ID查询，不自动重放。
+
+限普通文本，继承上游/持久引用，不复制边或组。批内引用ID与稳定提示词标记同时映射到新ID，保留手动@@标记；外部引用不变。相较当前本地前端仅映射references的实现，CLI额外同步prompt中的稳定标记，避免副本中引用对象与提示词不一致；预览显示prompt前后。原节点保持；媒体来源历史和跨画布复制未接入。
+
+## 当前普通节点复制
+
+以下范围更新此前“仅文本/媒体待接”的历史记录。`node copy`支持普通文本、图片/视频生成节点及图片/视频/音频素材；`node copy-batch`支持同画布1–100项混合批次。保持现有输入字段：doc_id、space、团队team_uid、node_id/new_node_id/position；批量使用copies数组。默认预览；执行须将本次预览expected_version写回输入并加--yes。一个批次仅一次CAS保存及完整读回，任一成员不支持则整批停止；不复制边和组。
+
+生成结果副本保留成品、真实文件引用、审核和持久参考，将当前结果加入extra.copied_generation_history；extra.source_task_id只标来源。清除副本自身last_task_id、结果内task_id与轮询/提交状态，不能把原任务认领为副本的生成任务。素材副本保留原上传任务关联。进行中节点及转绘/重拍/正片等派生节点不能复制；不同配置协议未核对时停止。批内持久引用、审核映射键及稳定@{ref:ID}/@@{ref:ID}一起映射，外部引用保持。预览报告来源任务和复制历史数；保存未知不重放，先按固定副本ID读取。
+
+复制使用同画布来源任务并验证文件。来源历史与副本自身任务分开；入库是独立的 material save 操作。

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

@@ -0,0 +1,54 @@
+# 单片段重拍
+
+单片段重拍与转绘独立，不支持批量、附加参考或整片合成。每次收费提交都需用户确认。
+
+用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md)：沿用已明确选择，缺项优先用卡片收集，等待回复后继续原任务；本路线的执行、签署与恢复边界仍按下文，不扩展功能。
+
+适用于普通video/video_upload节点上已有视频的指定区间修改。CLI独立编排“源视频→重拍配置→视频素材结果”，运行时无需前端代码。配置创建不生成；收费处理必须另行预估和当次确认。当前实现限同画布真实完成任务、单一源视频、纯文本提示词；额外图片/音频/视频参考、@素材输入、批量重拍及独立合成操作未接入。模拟与真实前端请求/codec保存重开兼容通过，真实单次任务已完成并恢复结果。
+
+## 输入和配置创建
+
+先沿用本次空间、团队、画布与源视频，核对实际team_uid、同画布任务和真实媒体引用；明确时间范围及要修改的内容，查询当前空间视频模型是否声明video_editing及可用分辨率/时长。已有选择不重问。重拍按源片比例，区间决定时长，不增加比例、输出时长、声音等开关；不走普通node add伪造派生节点。
+
+UTF-8 remake.json示例（个人移除team_uid；ID/模型替换为实际查询值）：
+
+```json
+{
+  "doc_id": "DOC_ID",
+  "node_id": "SOURCE_NODE_ID",
+  "space": "team",
+  "team_uid": "TEAM_UID",
+  "start_ms": 0,
+  "end_ms": 4000,
+  "model_name": "模型目录的展示名",
+  "resolution": "480p",
+  "prompt": "人物轻轻转头后看向镜头"
+}
+```
+
+命令统一前缀为`uzoo-anime --profile PROFILE`：
+
+1. `remake prepare --input remake.json --operation remake-001`只预检来源、区间和模型，展示付款钱包快照；无远端写入、无operation记录。
+2. 确认参数并协调暂停该画布旧页面编辑，加`--yes`只保存真实来源绑定的重拍配置和video-remake-input系统线。保留源节点和其他内容，使用最新完整画布与CAS。后端保存类型为video、extra.video_remake.role=node；网页读取为videoRemakeNode，sourceRef/sourceUrl、区间和sourceDuration均来自真实源片。没有新任务、没有OO生成费用，不把配置创建当成重拍成功。
+3. 配置位于源片右侧width+80、同y，尺寸按源片比例；输入的resolution为明确成本参数，不能为空。模型/区间/提示词/来源绑定后不自动改写，用户另行编辑导致不一致会停止，先协调新目标再操作。
+
+本路线截取、推理及合成都由后端执行，不要求用户安装本机FFmpeg或推理环境。服务端依赖异常按原HTTP/业务码排查；不要将后端FFmpeg报错转成让用户安装本机软件。
+
+## 实时预估与一次提交
+
+1. `remake submit remake-001`只调用前端同源的canvas/generations/estimate，保存本次报价并显示模型/区间/提示词/分辨率和实际钱包。预估按重拍配置识别片段、mode=video_editing，源视频引用和自动素材说明按前端规则整理；实际提交按前端重拍接口使用用户正文，两者不可随意混用。未知费用、will_intercept或模型配置不匹配均停止。
+2. 展示当次预估OO币，用户明确确认后，`remake submit remake-001 --yes --expected-cost OO`。CLI重新核对账号/归属/原媒体/配置及当前模型和费用；共享余额变化本身不改变已确认参数，不根据余额差额归因本次费用。--expected-cost为CLI提交前比价。
+3. 《统一协议》《Seedance2.0模型使用承诺书》需本人确认时，复用[本机协议阅读页](agreement-workflow.md)，用户点击后同步CLI；只在原账号、配置、协议版本和费用仍一致时继续。不代填同意，传protocol_agreed=false，依赖服务端已签状态。接口4401仍是待签署，不误报成重拍模型失败。
+4. 使用真实源ref和区间，固定generation_mode=video_editing，POST /clip-redraw/tasks仅一次，不伪造Idempotency-Key。后端截取并返回真实clip/task；任务ID可为UUID，不能当成canvas生成任务ID。先持久化可查询ID，即使其余响应缺失也尽量从该ID恢复，不丢弃已知任务。
+5. 含人脸素材（真人/动漫）需要Seedance审核。当前重拍接口由后端携视频参考进入现有审核链；CLI不传关闭审核开关、不伪造active或复用原图审核。源码显示后端在启用审核配置时强制视频走Asset审核；这不证明当前部署审核已成功。协议签署也不等于素材审核，实际执行中的审核错误独立保留，首次真实任务仍须验证。
+
+## 查询、结果与恢复
+
+- `remake get remake-001`只读远端任务并核对画布，`remake wait remake-001`等待原任务后保存终态；后端可在CLI退出后继续，但画布仍需wait或recover同步。
+- `remake recover remake-001`默认只查，`--yes`只恢复原配置/已知任务结果的画布保存；不会再次POST收费任务。重复prepare/submit也查询原operation，不重复创建/重拍。
+- 结果是下游video_upload素材，extra.clip_redraw.role=clip-redraw，保存真实taskId/clipId/taskNo、状态、结果引用及clip-redraw-link。配置节点也保存对应clip/任务关联；不替换原视频，不自动入库或继续生成。后端result可能优先返回整片交付产物，同时提供clip_result/compose；照实交付，不把整片与重拍片段混为一项，也不另行触发拼接。
+- 完成判定看原任务status=completed、真实结果url/file_ref和canvas_synced；state=failed/cancelled仍是终态失败/取消，不以命令退出0冒充成功。本次费用看task.estimated_credit_cost/credit_cost/billing_status，余额只报共享快照。
+- 后端对提示词做NFKC兼容字符规范化，中文全角逗号变半角不当作任务错配；只按该规范化比较，其他正文差异仍停止。网页保存可能把真实video_remake配置的API类型写成video_upload；来源/区间/模型/提示词及role均一致时按真实标记识别，不因别名重建节点。
+- 保存冲突停止。保存丢响应先读回原分配节点/线；明确CAS拒绝可显式恢复最新快照。用户删除/换素材/改配置/断系统线后停止，不自动重建或回写旧内容。源签名更新通过实际媒体摘要核对同一内容，不能只比文件名或尺寸。
+- **提交响应未知且无任务ID时，完整自动恢复不可用**：没有已声明的提交幂等/按operation查询契约。先检查service status及原副作用，保留原operation，不换键重发，不根据列表空或共享余额不变推断未执行。REMAKE_SUBMISSION_UNKNOWN退出4，REMAKE_SYNC_PENDING退出4；已知ID仅查原任务，不能猜另一个任务。
+- 记录在用户配置目录remakes/PROFILE，包含源引用/提示词/任务响应，不公开或提交。退出/删除网页节点不会自动删除本地记录。

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

@@ -0,0 +1,13 @@
+# 转绘原任务查询与下载
+
+转绘暂停。仅在用户明确要求时查询、下载原结果或排障；不提交新的分析、切片、提示词、生成，不自动恢复画布写入。普通视频及单片段重拍使用各自流程。
+
+## 原运行只读查询
+
+1. 沿用原 profile 和 operation，不切换账号、服务、空间或团队。先核对原操作记录及可用的任务 ID。
+2. 用 `uzoo-anime repaint get NAME` 查询原运行。若要查询当前账号已知原任务的历史，使用 `repaint history PARENT --type reverse|delivery|video` 并核对父任务。具体参数见 [命令参考](commands.md)。
+3. 已知单段视频用 `repaint video-get NAME` 查询。状态未知或数据缺失时，保留原操作；不要换键补发，不将历史结果回填到修改后的节点。
+
+## 下载原视频
+
+用 `repaint video-download NAME --output FILE` 下载可访问的原视频，保留同一来源任务。使用原任务下载入口处理权限与签名引用；服务拒绝、引用不可续期或文件不完整时停止，不绕过。输出路径已存在时改用新文件名。

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

@@ -0,0 +1,37 @@
+# Seedance 图片与视频素材审核
+
+用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md)：沿用已明确选择，缺项优先用卡片收集，等待回复后继续原任务；本路线的执行、签署与恢复边界仍按下文，不扩展功能。
+
+用于显式审核当前或下游引用的同画布普通图片／视频。使用 `uzoo-anime --profile PROFILE`，以真实的 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；同一媒体不因凭证字符串不同误拒，内容不同或无法核验仍停止。此核验不提交审核，不把旧审核套用到新媒体。

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

@@ -0,0 +1,67 @@
+# 视频素材工具：剪辑与截帧
+
+用户决定、方案与费用确认统一遵循 [交互流程](interaction-workflow.md)：沿用已明确选择，缺项优先用卡片收集，等待回复后继续原任务；本路线的执行、签署与恢复边界仍按下文，不扩展功能。
+
+适用于同画布普通视频生成或素材节点上的已有结果。运行前缀为 `uzoo-anime --profile PROFILE`；支持预检、单次截取、结果落图和原片段恢复。
+
+剪辑裁取原媒体的时间范围；截帧读取指定时刻的原画面，两者均不提交 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 不会自行下载媒体工具。缺少依赖时，由用户确认具体安装方案，安装后再检查。图片裁剪复用 FFmpeg/FFprobe。
+
+## 输入与执行
+
+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，上传为画布素材，绑定真实上传任务并保存来源线。
+
+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 与原工具路径。

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# 更新记录
+
+## 0.6.0
+
+- 新增可选的 `install` 命令，支持交互多选和显式指定 Agent。全局 CLI 同版本可复用，Skill 从同版本包同步；不覆盖手动安装或修改过的 Skill。
+- 普通 npm 安装保持原行为。Windows 的 Codex 与 WorkBuddy 桌面版已验证 Skill 发现与 CLI 调用。
+- 随包 Skill 指导 Agent 在首次使用时查询新版；是否更新由用户决定，CLI 不自动更新。
+- npm 归档仅包含运行资源和公开使用说明。
+
+## 0.5.0
+
+- 初始公开版本。支持浏览器 CLI 授权、画布与节点管理、素材、普通生成与恢复、下载、样片转正片，以及已接入的图片和视频工具。
+- 包含完整 Skill。该版本无 `install` 子命令，请按[安装与更新说明](docs/Agent接入与版本更新.md)手动接入 Agent。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UzooAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Uzoo Anime CLI
+
+通过终端或 Agent 操作 Uzoo 的画布、素材和生成任务。支持 Node.js 22 或更高版本。
+
+## 安装 CLI 与 Skill
+
+```sh
+npm install --global @uzooai/anime-ai-cli@latest
+uzoo-anime --version
+uzoo-anime --help
+```
+
+**如果版本是 0.5.0：该版本没有 `install` 子命令。** 运行 `npx @uzooai/anime-ai-cli@latest install` 时出现“未知命令”，请使用上面的 npm 命令，再按 [Agent 接入与版本更新](docs/Agent接入与版本更新.md) 手动添加 Skill。重复下载同一个版本不会增加命令。
+
+从 0.6.0 起支持一键安装。在该版本进入 npm 的 `latest` 后，可运行：
+
+```sh
+npx @uzooai/anime-ai-cli@latest install
+```
+
+按提示选择一个或多个 Agent。已有同版本 CLI 的用户可以直接运行 `uzoo-anime install` 加装 Skill。
+
+普通 npm 安装附带完整 Skill 文件，不会修改 Agent 的技能目录。用 `uzoo-anime skill path --format json` 找到目录后，将整个目录（含 `references`）复制到目标宿主。
+
+## 登录与使用
+
+```sh
+uzoo-anime service status
+uzoo-anime auth login
+uzoo-anime auth status
+```
+
+默认服务是 [Uzoo](https://uzooai.com)。浏览器登录和 CLI 授权由用户本人完成；不要把密码、验证码或令牌粘贴到 Agent。可用 `--profile NAME` 区分本地配置，已有有效登录可继续使用。
+
+- [CLI 命令](.agents/skills/uzoo-anime-cli/references/commands.md)：画布和节点、素材、生成、查询与下载。
+- [支持的节点与工具](.agents/skills/uzoo-anime-cli/references/node-capabilities.md)：区分 CLI 能力和网页专属操作。
+- [生成与恢复](.agents/skills/uzoo-anime-cli/references/generation-workflow.md)：先确认素材、参数和实际报价；中断时查询并恢复原 operation。
+- [图片工具](.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md)与[视频工具](.agents/skills/uzoo-anime-cli/references/video-tools-workflow.md)：按需检查 FFmpeg；CLI 不自动安装媒体工具。
+
+使用 CLI 写画布前，先确认对应网页标签已关闭且离开保存完成。付费任务在用户确认本次实际报价后提交。转绘旧命令仅用于有明确授权的原结果查询、下载或排障。
+
+## 更新
+
+CLI 不会后台检查或自动安装新版。使用随包 Skill 的 Agent 会在会话首次使用时尝试查询 npm 稳定版，有新版才提示，由你决定是否更新；查询失败不影响原任务。手动升级 CLI 后，也请同步手动接入的 Skill。见 [Agent 接入与版本更新](docs/Agent接入与版本更新.md)。
+
+[更新记录](CHANGELOG.md) · [MIT 许可证](LICENSE)

package/assets/logo-uzoo.svg

@@ -0,0 +1,7 @@
+<svg width="89" height="32" viewBox="0 0 89 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M21.3798 2.70136C21.3798 2.88258 21.3911 2.98452 21.4138 3.00717C21.4364 3.02983 21.4251 3.16574 21.3798 3.41493V9.0555C21.3798 9.50856 21.3458 9.98427 21.2779 10.4826C21.2099 10.9583 21.1759 11.4227 21.1759 11.8758C21.1759 12.2835 21.1533 12.646 21.108 12.9631C21.0627 13.2576 21.04 13.5634 21.04 13.8806C21.04 14.0618 20.9947 14.345 20.9041 14.7301C20.8361 15.1152 20.7455 15.4663 20.6323 15.7834C20.5417 15.874 20.485 15.9986 20.4624 16.1572C20.4397 16.3158 20.3718 16.497 20.2585 16.7009C20.2358 16.7462 20.1566 16.8821 20.0206 17.1086C19.8847 17.3125 19.7262 17.5277 19.5449 17.7542C19.3864 17.9807 19.2391 18.1959 19.1032 18.3998C18.9673 18.581 18.888 18.683 18.8653 18.7056C18.5709 18.9548 18.333 19.1587 18.1518 19.3173C17.9932 19.4532 17.7214 19.6004 17.3363 19.759C17.291 19.8043 17.1664 19.8383 16.9625 19.8609C16.7586 19.8836 16.634 19.9176 16.5887 19.9629C16.4075 20.0535 16.181 20.1101 15.9091 20.1328C15.66 20.1554 15.3881 20.2234 15.0936 20.3366H14.482C14.2328 20.382 13.9723 20.4046 13.7005 20.4046C13.4513 20.4273 13.2587 20.4386 13.1228 20.4386C12.851 20.4386 12.5112 20.4273 12.1034 20.4046C11.7183 20.4046 11.3106 20.3933 10.8802 20.3706C10.4724 20.3706 10.0647 20.3593 9.65693 20.3366C9.24918 20.3366 8.88673 20.3366 8.56959 20.3366C8.25245 20.3366 7.91266 20.3027 7.55021 20.2347C7.21042 20.1441 6.91593 20.0535 6.66675 19.9629C6.62144 19.9176 6.53083 19.8949 6.39492 19.8949C6.259 19.8723 6.14573 19.8383 6.05512 19.793C5.96451 19.7477 5.81727 19.691 5.61339 19.6231C5.43217 19.5325 5.23962 19.4532 5.03574 19.3852C4.83187 19.2946 4.63932 19.204 4.45809 19.1134C4.29952 19.0228 4.19758 18.9548 4.15228 18.9095C3.72187 18.683 3.22351 18.3205 2.65719 17.8222C2.09086 17.3238 1.62648 16.6669 1.26403 15.8514C1.10546 15.5116 0.946892 15.2058 0.788321 14.9339C0.629751 14.6394 0.516486 14.3336 0.448528 14.0165C0.380569 13.6993 0.31261 13.3822 0.244651 13.0651C0.199346 12.7253 0.15404 12.4081 0.108734 12.1136C0.0634281 11.8645 0.0521017 11.6266 0.0747546 11.4001C0.0974074 11.1735 0.108734 10.913 0.108734 10.6185V9.39529C0.086081 9.16876 0.0521017 8.87428 0.00679586 8.51183C-0.015857 8.12673 0.0181223 7.84357 0.108734 7.66234V2.32759C0.131387 2.30493 0.188019 2.29361 0.278631 2.29361C0.391895 2.27095 0.516486 2.2483 0.652404 2.22565C0.788321 2.203 0.924239 2.19167 1.06016 2.19167C1.19607 2.16901 1.30934 2.15769 1.39995 2.15769C1.71709 2.15769 2.00025 2.19167 2.24943 2.25963C2.52127 2.30493 2.7478 2.32759 2.92902 2.32759C3.24616 2.37289 3.54065 2.40687 3.81248 2.42952C4.10697 2.45218 4.40146 2.4182 4.69595 2.32759C4.80921 2.4182 4.86584 2.54279 4.86584 2.70136C4.8885 2.83728 4.89982 2.95054 4.89982 3.04115C4.89982 3.4489 4.8885 3.85666 4.86584 4.26441C4.84319 4.64951 4.80921 5.09124 4.76391 5.5896C4.76391 5.95205 4.75258 6.37113 4.72993 6.84684C4.70727 7.32255 4.69595 7.78694 4.69595 8.24V9.97294C4.69595 10.4713 4.69595 10.9244 4.69595 11.3321C4.7186 11.7399 4.78656 12.1929 4.89982 12.6913C4.89982 12.7592 4.92248 12.9178 4.96778 13.167C5.01309 13.3935 5.06972 13.6427 5.13768 13.9145C5.20564 14.1864 5.26227 14.4469 5.30758 14.6961C5.37554 14.9453 5.43217 15.1038 5.47747 15.1718C5.56808 15.2624 5.64737 15.387 5.71533 15.5456C5.78329 15.6815 5.83992 15.8174 5.88523 15.9533C6.0438 16.2931 6.27032 16.5649 6.56481 16.7688C6.88195 16.9727 7.19909 17.1992 7.51623 17.4484C7.76542 17.6523 8.02593 17.8222 8.29776 17.9581C8.56959 18.0714 8.88673 18.1733 9.24918 18.2639C9.29449 18.2866 9.37377 18.2979 9.48704 18.2979C9.62296 18.2979 9.74755 18.2979 9.86081 18.2979L10.7443 18.3658C10.9255 18.3885 11.118 18.4111 11.3219 18.4338C11.5485 18.4338 11.7523 18.4111 11.9336 18.3658L12.5452 18.2299C12.5678 18.2299 12.6471 18.2073 12.783 18.162C12.919 18.094 13.0549 18.0261 13.1908 17.9581C13.3494 17.8901 13.4966 17.8335 13.6325 17.7882C13.7911 17.7202 13.893 17.6636 13.9383 17.6183C14.3234 17.3691 14.6179 17.1313 14.8218 16.9047C15.0257 16.6556 15.2182 16.3384 15.3994 15.9533C15.4448 15.8174 15.524 15.6022 15.6373 15.3077C15.7506 14.9906 15.8412 14.7754 15.9091 14.6621C16.0224 14.3223 16.0904 14.0165 16.113 13.7447C16.1583 13.4728 16.2036 13.1897 16.2489 12.8952C16.2489 12.7139 16.2489 12.2722 16.2489 11.57C16.2489 10.8677 16.2716 9.84835 16.3169 8.51183C16.3395 8.03612 16.3509 7.56041 16.3509 7.0847C16.3509 6.60899 16.3509 6.13327 16.3509 5.65756C16.3735 5.1592 16.3735 4.64951 16.3509 4.12849C16.3282 3.60747 16.3395 3.13176 16.3848 2.70136H16.5887C16.9059 2.79197 17.2343 2.81462 17.5741 2.76932C17.9366 2.72401 18.3217 2.70136 18.7294 2.70136H19.8507C19.964 2.70136 20.1339 2.72401 20.3604 2.76932C20.6096 2.79197 20.9494 2.76932 21.3798 2.70136Z" fill="#15CAF7"/>
+<path d="M25.0453 17.2348H26.4106V15.8696H27.7758V14.5043H29.1411V13.1391H30.5063V11.7738H31.8715V10.4086H25.0453V7.67812H35.9673V11.7738H34.602V13.1391H33.2368V14.5043H31.8715V15.8696H30.5063V17.2348H29.1411V18.6001H35.9673V21.3305H25.0453V17.2348Z" fill="#FF74D3"/>
+<path d="M66.4704 18.4763C65.2302 18.4763 64.1768 18.2129 63.3103 17.6863C62.4439 17.1596 61.7473 16.4545 61.2206 15.571C60.6939 14.6706 60.3117 13.6682 60.0738 12.5639C59.836 11.4425 59.717 10.2957 59.717 9.12346C59.717 7.9002 59.836 6.73641 60.0738 5.63208C60.3287 4.52775 60.7194 3.55934 61.2461 2.72684C61.7728 1.87736 62.4609 1.21476 63.3103 0.739051C64.1768 0.24635 65.2302 0 66.4704 0C67.6937 0 68.73 0.24635 69.5795 0.739051C70.429 1.21476 71.1171 1.87736 71.6438 2.72684C72.1874 3.55934 72.5782 4.52775 72.8161 5.63208C73.0539 6.73641 73.1729 7.9002 73.1729 9.12346C73.1729 10.2957 73.0539 11.4425 72.8161 12.5639C72.5782 13.6682 72.1959 14.6706 71.6693 15.571C71.1426 16.4545 70.4545 17.1596 69.605 17.6863C68.7555 18.2129 67.7107 18.4763 66.4704 18.4763ZM66.4704 16.4375C67.4898 16.4375 68.3223 16.1062 68.9679 15.4436C69.6135 14.781 70.0807 13.8976 70.3696 12.7932C70.6754 11.6719 70.8283 10.4402 70.8283 9.09797C70.8283 7.72181 70.6754 6.50705 70.3696 5.45369C70.0807 4.38334 69.6135 3.55084 68.9679 2.9562C68.3393 2.34458 67.5153 2.03876 66.4959 2.03876C65.4256 2.03876 64.5676 2.34458 63.922 2.9562C63.2764 3.55084 62.8007 4.38334 62.4948 5.45369C62.206 6.50705 62.0616 7.72181 62.0616 9.09797C62.0616 10.4402 62.206 11.6719 62.4948 12.7932C62.8007 13.8976 63.2764 14.781 63.922 15.4436C64.5676 16.1062 65.4171 16.4375 66.4704 16.4375ZM62.0616 16.2336L68.6366 2.21715H70.9302L64.3552 16.2336H62.0616Z" fill="#FFC940"/>
+<path d="M44.026 8.19009L47.8337 7.21949L51.4922 7.41858L55.6483 10.2806L56.8429 12.6698L57.6642 15.9798L57.1664 19.2898L55.2501 22.5998L51.8157 24.2423L48.5306 24.7152L44.3495 23.9188L41.4377 22.2016L39.8449 20.4595L39.0734 17.3486L39.4219 13.0431L41.1142 10.0566L44.026 8.19009ZM49.3767 11.2761L46.664 11.5001L44.4491 12.6449L43.3789 14.2875L43.0554 16.6269L43.578 18.8418L45.4943 20.3599L48.6301 20.9821L52.0646 19.912L53.1596 17.8214L53.3587 15.4323L51.965 12.7693L49.3767 11.2761Z" fill="#31ED70"/>
+<path d="M58.0829 28.2153L61.0829 20.9153H62.6929L63.3829 28.2153H62.1429L62.0229 26.4453H60.0829L59.4029 28.2153H58.0829ZM60.4629 25.4253H61.9529L61.8229 23.4653C61.8029 23.1387 61.7829 22.8453 61.7629 22.5853C61.7495 22.3187 61.7429 22.1253 61.7429 22.0053C61.7029 22.1253 61.6362 22.3187 61.5429 22.5853C61.4562 22.8453 61.3529 23.1353 61.2329 23.4553L60.4629 25.4253ZM64.4989 28.2153L65.3689 22.7153H66.5889L66.4189 23.7653H66.7589L66.3789 24.0553C66.4523 23.602 66.6389 23.2487 66.9389 22.9953C67.2456 22.742 67.6289 22.6153 68.0889 22.6153C68.6289 22.6153 69.0323 22.7953 69.2989 23.1553C69.5656 23.5153 69.6489 23.9987 69.5489 24.6053L68.9789 28.2153H67.7289L68.2789 24.7353C68.3323 24.402 68.2856 24.1453 68.1389 23.9653C67.9923 23.7853 67.7656 23.6953 67.4589 23.6953C67.1456 23.6953 66.8856 23.7887 66.6789 23.9753C66.4789 24.162 66.3489 24.4287 66.2889 24.7753L65.7489 28.2153H64.4989ZM70.465 28.2153L70.645 27.0753H72.565L73.085 23.8453H71.405L71.585 22.7153H74.445L73.765 27.0753H75.465L75.285 28.2153H70.465ZM73.925 21.7953C73.6717 21.7953 73.4817 21.732 73.355 21.6053C73.2284 21.472 73.1817 21.2953 73.215 21.0753C73.255 20.8553 73.3584 20.682 73.525 20.5553C73.6917 20.422 73.9017 20.3553 74.155 20.3553C74.4017 20.3553 74.5884 20.422 74.715 20.5553C74.8484 20.682 74.895 20.8553 74.855 21.0753C74.8217 21.2953 74.7217 21.472 74.555 21.6053C74.3884 21.732 74.1784 21.7953 73.925 21.7953ZM76.2411 28.2153L77.1111 22.7153H78.1311L78.0111 23.4553H78.2311L78.0311 23.6353C78.0845 23.3287 78.2111 23.082 78.4111 22.8953C78.6111 22.7087 78.8478 22.6153 79.1211 22.6153C79.4145 22.6153 79.6245 22.7353 79.7511 22.9753C79.8778 23.2153 79.9078 23.5387 79.8411 23.9453L79.7011 23.4553H80.0411L79.8811 23.6353C79.9345 23.3287 80.0611 23.082 80.2611 22.8953C80.4611 22.7087 80.7045 22.6153 80.9911 22.6153C81.3311 22.6153 81.5811 22.742 81.7411 22.9953C81.9011 23.2487 81.9445 23.592 81.8711 24.0253L81.2111 28.2153H80.1111L80.7611 24.0753C80.7945 23.8953 80.7778 23.7553 80.7111 23.6553C80.6511 23.5487 80.5445 23.4953 80.3911 23.4953C80.2445 23.4953 80.1211 23.5453 80.0211 23.6453C79.9278 23.7453 79.8645 23.8887 79.8311 24.0753L79.1711 28.2153H78.2711L78.9311 24.0753C78.9578 23.8887 78.9378 23.7453 78.8711 23.6453C78.8111 23.5453 78.7045 23.4953 78.5511 23.4953C78.3978 23.4953 78.2745 23.5453 78.1811 23.6453C78.0878 23.7453 78.0278 23.8887 78.0011 24.0753L77.3411 28.2153H76.2411ZM84.7072 28.3153C84.2406 28.3153 83.8506 28.2253 83.5372 28.0453C83.2239 27.8653 82.9972 27.6153 82.8572 27.2953C82.7239 26.9687 82.6906 26.5887 82.7572 26.1553L82.9772 24.7753C83.0506 24.342 83.2072 23.9653 83.4472 23.6453C83.6872 23.3187 83.9906 23.0653 84.3572 22.8853C84.7306 22.7053 85.1506 22.6153 85.6172 22.6153C86.0772 22.6153 86.4639 22.7053 86.7772 22.8853C87.0906 23.0653 87.3139 23.3187 87.4472 23.6453C87.5872 23.9653 87.6206 24.342 87.5472 24.7753L87.3872 25.7653H84.0272L83.9572 26.1553C83.9039 26.542 83.9506 26.8353 84.0972 27.0353C84.2506 27.2287 84.5106 27.3253 84.8772 27.3253C85.1572 27.3253 85.3872 27.2787 85.5672 27.1853C85.7539 27.0853 85.8839 26.942 85.9572 26.7553H87.1972C87.0839 27.0687 86.9039 27.342 86.6572 27.5753C86.4172 27.8087 86.1306 27.992 85.7972 28.1253C85.4639 28.252 85.1006 28.3153 84.7072 28.3153ZM86.2972 25.0653L86.3472 24.7653C86.4072 24.3853 86.3639 24.0953 86.2172 23.8953C86.0706 23.6887 85.8172 23.5853 85.4572 23.5853C85.0972 23.5853 84.8072 23.6887 84.5872 23.8953C84.3739 24.102 84.2372 24.3953 84.1772 24.7753L84.1472 24.9853L86.4072 24.9653L86.2972 25.0653Z" fill="white"/>
+</svg>

package/docs/Agent/346/216/245/345/205/245/344/270/216/347/211/210/346/234/254/346/233/264/346/226/260.md

@@ -0,0 +1,43 @@
+# Agent 接入与版本更新
+
+## npm 0.5.0：先安装 CLI，再接入 Skill
+
+如果 `npx ... install` 返回“未知命令”，先运行 `uzoo-anime --version`（未安装时可用 `npx @uzooai/anime-ai-cli@latest --version`）。**0.5.0 没有一键安装入口。**
+
+```powershell
+npm install --global @uzooai/anime-ai-cli@latest
+uzoo-anime --version
+uzoo-anime skill path --format json
+```
+
+将返回的 `directory` **整个复制**到宿主技能目录，保留 `SKILL.md` 和 `references/`。已有同名 Skill 先备份并比较自定义修改，备份不要留在技能扫描目录内。
+
+| 本地宿主 | 用户级目标目录 |
+| --- | --- |
+| Codex | `~/.agents/skills/uzoo-anime-cli` |
+| WorkBuddy 桌面版 | `~/.workbuddy/skills/uzoo-anime-cli` |
+| Claude Code | `~/.claude/skills/uzoo-anime-cli` |
+
+只在当前项目使用 Codex 时，可放到该项目的 `.agents/skills/uzoo-anime-cli`。其他 Agent 按各自的技能导入方式接入。打开新会话，确认能找到 Skill 且能运行 `uzoo-anime --version`；找不到命令时检查宿主的 PATH 是否包含 npm 全局命令目录。
+
+## 含一键安装入口的版本
+
+仅在 `uzoo-anime install --help` 可用时使用本节。0.6.0 的安装入口已在 Windows 的 Codex、WorkBuddy 桌面版验证；Claude Code 可明确指定，尚未验收真实宿主。WorkBuddy AI 或远程 Claw 不在此范围。
+
+```sh
+uzoo-anime install
+uzoo-anime install --agent codex --agent workbuddy
+uzoo-anime install --agent workbuddy --dry-run
+```
+
+默认列出检测到的 Agent，允许多选，确认后才写入。脚本须明确传入至少一个 `--agent` 并使用 `--yes`。安装器复用同版本全局 CLI，只给选中的宿主同步 Skill。发现手动安装或改过的副本会停止，给出目录，供用户先备份或只选择其他宿主。安装器不会代登录、安装 Agent 或改 PATH。
+
+当包含该功能的版本成为 npm 的 `latest` 后，才可用 `npx @uzooai/anime-ai-cli@latest install` 首次一键接入或主动升级。为已有同版本 CLI 加装新 Agent，直接用本机 `uzoo-anime install` 即可。
+
+## 主动更新
+
+- 普通 npm 用户：运行 `npm install --global @uzooai/anime-ai-cli@latest`，核对版本，再从该版本更新已复制的 Skill。
+- 一键安装用户：通过含一键安装功能的新版入口更新 CLI，并选择所有要同步的 Agent。
+- 更新不要求重新登录；可继续使用原 profile 和 operation。不要因更新重提未知任务。
+
+CLI 不会后台查询或自动更新。使用随包 Skill 的 Agent 会在每个会话首次实际使用时尝试只读查询 npm 稳定版。若有新版，会展示本机和新版版本号，由你选择继续当前版或更新，以及是否同步所选 Agent 的 Skill。查不到版本不影响使用，进行中的操作先处理完再更新。版本号也可用 `uzoo-anime --version` 查看，已发布版本可用 `npm view @uzooai/anime-ai-cli version` 查询。

package/examples/matting.json

@@ -0,0 +1,5 @@
+{
+  "doc_id": "YOUR_CANVAS_ID",
+  "node_id": "YOUR_COMPLETED_IMAGE_NODE_ID",
+  "space": "personal"
+}

package/extensions/uzoo-cli-login/manifest.json

@@ -0,0 +1,9 @@
+{
+  "manifest_version": 3,
+  "name": "Uzoo CLI Login",
+  "version": "0.1.0",
+  "description": "在普通浏览器登录后，由用户主动授权当前 Uzoo 网页会话给本机 CLI。",
+  "permissions": ["activeTab", "scripting", "cookies", "storage"],
+  "host_permissions": ["https://uzooai.com/*", "http://127.0.0.1/*"],
+  "action": { "default_title": "Uzoo CLI Login", "default_popup": "popup.html" }
+}

package/extensions/uzoo-cli-login/popup.css

@@ -0,0 +1 @@
+body{font:14px/1.6 system-ui;width:340px;padding:16px;color:#192336}h1{font-size:20px;margin:0 0 12px}button{width:100%;padding:10px;background:#2949db;color:white;border:0;border-radius:7px;cursor:pointer}button:disabled{opacity:.5;cursor:default}.hint{font-size:12px;color:#667085}#status{white-space:pre-wrap;overflow-wrap:anywhere}

package/extensions/uzoo-cli-login/popup.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="zh-CN">
+<meta charset="utf-8">
+<title>Uzoo CLI Login</title>
+<link rel="stylesheet" href="popup.css">
+<body>
+  <h1>Uzoo CLI Login</h1>
+  <p id="description">正在检查当前页面…</p>
+  <button id="action" disabled>请稍候</button>
+  <p id="status" role="status"></p>
+  <p class="hint">只有点击授权后，扩展才读取当前网站的登录态并发送到本机 CLI。不上传到第三方服务器。</p>
+  <script src="popup.js" type="module"></script>
+</body>
+</html>