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

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,242 @@
-# 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
+
+**当前开发范围（2026-10-31）**：转绘因重新设计暂停CLI开发和专项补验，现有代码/记录/结果保留，不自动续做。后续按[非转绘完善计划](docs/画布CLI非转绘完善计划.md)推进普通画布、节点工具和下载；N5安装与交付专项仍排除；片段重拍单独保留现状。下文转绘命令及测试是历史能力记录，不表示当前执行安排。
+
+视频转绘当前只接入**画布内流程**；独立「视频转绘」页面标为**未接入，暂不实现**。共用接口及历史任务素材上传测试不代表独立页面可用。
+
+CLI 直接调用 `/api/v1`，已接入普通浏览器授权与独立 CLI 会话。当前版本为0.5.0，普通浏览器CLI授权及代表性真实路线已有验证；早期阶段分工历史见 [阶段 3B 验收交接](docs/阶段3B验收交接.md)。三阶段范围见 [开发计划](docs/开发计划.md)，阶段一验收结果见 [阶段一验收](docs/阶段一验收.md)。
+
+源码仓库为 `UzooAI/uzooai-cli`，主分支为 `cli-liu`。本仓库包含 CLI、配套 skill、历史扩展兼容实现及测试；前后端应用代码分别由各自仓库交付。
+
+2026-10-28：用户确认 B/C/D 已通过，开始 [真实业务接入与测试准备](docs/真实业务接入与测试.md)。实际生成在确认模型、参数和费用额度后执行。
+
+授权设计见 [CLI 授权接口与令牌自动刷新设计](docs/CLI授权接口与令牌自动刷新设计.md)。网页与 CLI 各有一个会话，同类新登录替换同类会话；正式站正常CLI授权已验证；服务启动自检仍按实际部署执行。
+
+## npm安装、版本更新与Agent使用
+
+正式包名为`@uzooai/anime-ai-cli`，MIT开源，本包版本`0.5.0`，公开包／`latest`通道。发布到registry后可执行`npm install --global @uzooai/anime-ai-cli@latest`；未发布时可安装维护者提供的tgz。安装后使用`uzoo-anime --version`、`uzoo-anime --help`、`uzoo-anime skill path`。
+
+实际服务为https://uzooai.com，首次先运行service status；随后在普通浏览器`auth login`并本人授权CLI；Agent另加载随包skill。升级通过npm明确选择@latest／@next／具体版本，不后台自动安装；沿用原profile和operation，不需要升级后退出登录。旧demo包迁移、配置位置、skill同步和发布条件见[完整安装与更新指南](docs/npm线上发布与安装使用.md)。本轮不发布、不实际安装或跨版本升级。
+
+## 环境与安装
+
+Node.js 22+。当前实际验证平台为 Windows，使用当前用户 DPAPI 加密凭据；Linux 提供 `secret-tool` 适配（需桌面 Secret Service，尚未实机验收）；macOS 适配留到跨平台发布阶段，当前会明确拒绝保存凭据。系统凭据服务失败时不会回退到明文文件。
+
+视频截帧和图片裁剪是可选功能，另需本机 FFmpeg 软件包内的 ffmpeg 和 ffprobe 在 PATH，或通过 `--ffmpeg PATH --ffprobe PATH` 明确提供；`uzoo-anime video tools` / `image tools` 可检查。当前采用按需安装：CLI/npm 包不捆绑或自动下载二进制，缺失返回 MEDIA_UNAVAILABLE 及结构化依赖清单；配套 Agent 说明具体安装方案并询问用户，同意后才安装、复检并继续原任务。已安装则复用，用户拒绝则保留任务待处理；业务 --yes 不授权安装。详见 [依赖与安装流程](.agents/skills/uzoo-anime-cli/references/video-tools-workflow.md#本机依赖与按需安装)。维护者可运行 `npm run test:media` 验证实际图片/视频处理；普通回归不要求安装媒体工具。当前 Windows 已实测，其他系统/编码及新环境实际安装仍待验证。
+
+运行环境为 Node.js 22+。授权使用普通浏览器，无需浏览器扩展：
+
+```powershell
+cd E:\anime-ai\anime-ai-cli
+npm install
+node src/cli.js --help
+```
+
+可选本机安装：`npm install --global .`，随后使用 `uzoo-anime`。配套 skill 位于 `.agents/skills/uzoo-anime-cli`；在本目录开启 Codex 会话即可发现，其他工作目录可将该技能文件夹复制到自己的技能目录。不要把实际登录态打包进 skill。
+
+npm 安装 CLI 不会自动将 skill 注册到 Agent。全局安装后，可用 `npm root --global` 找到包目录，skill 在包内 `.agents/skills/uzoo-anime-cli`；将整个文件夹（含 references）放入目标 Agent 的技能目录，或目标项目的 `.agents/skills/`。当前包名以 package.json 为准，为 `@uzooai/anime-ai-cli`，版本0.5.0，MIT许可证，已配置 `private: false`／public／latest；registry版本可用性以npm view查询为准，未发布时使用维护者提供的本地包。
+
+所有真实任务先遵循 [统一交互流程](.agents/skills/uzoo-anime-cli/references/interaction-workflow.md)：优先通过宿主卡片选择新建/已有画布、模型及适用参数、素材目录和方案，再通过费用卡片确认并继续原任务。已明确或明确委托的选择不重复询问；不把等待确认写成任务结束。宿主不支持卡片时说明后使用文字，不通过 CLI 假装生成宿主 UI。`model options --space personal --type image`（团队须带 UID）提供实时模型与已接入的普通节点控件数据，保存选择后用 `generation prepare` 组装请求。
+
+Agent 执行创建前读取 [画布流程](.agents/skills/uzoo-anime-cli/references/canvas-workflow.md)，维护者遵循 仓库中的项目规则AGENTS.md（不随运行包分发），将真实业务测试发现的问题同步修正到 CLI 和 skill。用户已明确的选择和创建授权应沿用，生成仍须每次预估并确认 OO 币。
+
+CLI 与 skill 按当前前端实际使用的节点功能、参数与流程设计，运行时由 CLI 独立调用接口，不依赖网页保持打开。模型目录提供实时可选值与能力限制，不把管理端/供应商配置自动变成用户开关。生成请求只接收 CLI 已核实接入的字段，节点 extra 不整包透传；当前没有视频“无声”开关，generate_audio 不支持。前端已有而 CLI 尚未接入的路线继续标为待完善，详见 [生成参数范围](.agents/skills/uzoo-anime-cli/references/generation-workflow.md#参数与前端使用范围)。
+
+## 空间选择
+
+业务开始先确认个人或团队空间；团队需从账号信息确认具体团队 UID。模型查询、画布列表和创建必须传 `--space personal` 或 `--space team --team-uid UID`，不再默认个人。以下命令以已确认的个人空间为例；团队请换对应参数。已有画布操作先检查 team_uid，预估时说明实际个人/团队 OO 币钱包，等待用户每次确认。
+
+团队余额由成员共用，普通成员只能查看本人的消费记录；其他成员使用时，即使本人没有消费，团队额度也可能下降。CLI任务实际费用以原任务计费和本人可见记录核验，团队余额按查询时点另列，不用余额差额推断本次消费，见 [团队钱包核验](.agents/skills/uzoo-anime-cli/references/generation-workflow.md#团队共享钱包与费用核验)。
+
+## 登录与查询
+
+```powershell
+node src/cli.js config set --base-url http://127.0.0.1:5174
+node src/cli.js auth login --web-url http://127.0.0.1:5174
+node src/cli.js auth status
+node src/cli.js model list --space personal --type image
+node src/cli.js canvas list --space personal
+node src/cli.js canvas get DOC_ID
+node src/cli.js generation list --doc DOC_ID
+```
+
+### 网页授权
+
+线上 profile 只有在服务端和前端完成上线并开启功能后才能使用；`uzooai-online` 内置 `https://uzooai.com/api/v1`。直接运行：
+
+```powershell
+node src/cli.js --profile uzooai-online auth login
+node src/cli.js --profile uzooai-online auth status
+```
+
+运行 `auth login` 后，在打开的网页登录页面完成正常登录并确认账号和设备。浏览器将一次性授权码交回本机 CLI，CLI 建立独立会话并加密保存凭据。旧扩展导入的网页凭据不会自动转成 CLI 凭据，需要重新授权。
+
+可用 `--browser msedge` / `--browser chrome` 指定浏览器，默认使用系统浏览器；`--web-url` 接受网站根地址。默认等候 5 分钟，`--timeout MS` 可调整，Ctrl+C 取消。
+
+网页登录仍执行网站的短信、滑块与设备校验。网页与 CLI 可以同时在线，各自刷新；新 CLI 登录会替换该账号原有 CLI 会话。`auth logout` 会先撤销当前 CLI 会话，再清除本地凭据。
+
+手动导入仍可排查：`auth import --input login-state.local.json`，文件由用户在本机准备，包含 `accessToken`、`cookie`、`deviceId`。勿将凭据提交仓库或贴入聊天。
+
+## Seedance 协议确认
+
+首次使用或协议版本更新后，`generation protocol-status` 可查当前状态，`generation protocol-open` 可打开《统一协议》中的《Seedance2.0模型使用承诺书》本机阅读确认页。用户亲自勾选确认后才记录签署；已获费用授权的 submit/recover --yes 会等待签署、重新核验账号/输入/费用并继续原 operation。4401 是待签署状态，不是生成任务执行失败；不同意或超时不继续生成。详见 [协议流程](.agents/skills/uzoo-anime-cli/references/agreement-workflow.md)。
+
+## 上传与生成
+
+素材库使用独立素材空间：`material folders/list/get/upload/use`；节点素材使用 `resource upload`，上传成功但绑定未确认可凭原响应 `resource bind`，无需重传。`graph apply --input FILE` 支持普通节点整理、打组、单节点/整组连接；整组按成员类型与目标模型能力过滤。`generation prepare` 从当前合法拓扑准备单次请求，不自动提交。完整操作与限制见 [素材、素材库与分组流程](.agents/skills/uzoo-anime-cli/references/material-graph-workflow.md)。
+
+请求准备现已合并节点持久参考、@素材标记、文本上下文和已通过的审核关联，并对照真实前端默认值与请求放置。`review start/get/wait/recover` 支持同画布普通图片/视频的显式审核及上游批量审核，记录状态并恢复画布关联；不提交生成，响应未知不重发审核。模拟/前端兼容及真实单图片审核、回填、下游请求复用已验证，视频/批量与网页人工验收待完成；跨画布、force 重审与完整自动审核编排仍未接入。输入与边界见 [素材审核指南](.agents/skills/uzoo-anime-cli/references/seedance-review-workflow.md)。
+
+新增 `material save/save-get/save-recover`，使用网页的原结果直接入库接口并持久化幂等恢复；真实单图片原键恢复入库、库查询和 PNG 读取已通过，重新导入/网页人工验收待完成。当前前端版本冲突后自动覆盖旧快照的风险已隔离复现；CLI 保留 CAS 停止策略，写入/同步期间应暂停同画布编辑，之后网页重新加载服务器内容。详见 [素材流程](.agents/skills/uzoo-anime-cli/references/material-graph-workflow.md)。
+
+素材入库是用户明确发起的独立动作，须指定目标目录或明确委托选择；CLI 的 folder_id 必填，不提供内容自动分类或生成后自动入库。生成结果回填画布、入库及从库导入画布分别执行，不能将其中一个动作默认扩展为后续动作。
+
+遇到接口问题先用 `service status` 核验同源后端进程与数据库/Redis就绪；CLI 对网络或内部错误保留原错误并追加探针结果，健康恢复不会自动重发业务操作。`video clip/clips/clip-get/clip-recover` 已实现普通视频截取和原片段恢复，默认预检；真实 2 秒剪辑、结果节点/连线与 MP4 读取通过，网页人工播放待确认。此前 code 5000 的错误和未知操作保留在测试记录。详见 [视频工具](.agents/skills/uzoo-anime-cli/references/video-tools-workflow.md)。
+
+`video frame --input frames.json --operation NAME` 默认预检，加 `--yes` 才按 `times_ms`（1–3 帧）解码、上传到画布并保存新图片素材及来源系统线；`video frame-get/frame-recover NAME` 查询/恢复原阶段。真实 1000ms 单帧、640×640 JPEG、0 OO 上传任务与读回通过，多帧真实上传和网页人工查看待完成。结果不自动存入素材库。任务/节点的签名引用不同时，截帧通过实际媒体大小与 SHA-256 核验同一内容；其他历史路线的跨日引用兼容尚待单独补齐。
+
+`image crop --input crop.json --operation NAME` 默认预检，使用原图像素 rect 或最大居中 aspect_ratio，加 --yes 才导出 PNG、上传并保存下游图片素材与 image-edit-link；`image crop-get/crop-recover NAME` 查询/恢复。当前支持同画布真实任务的静态 PNG/JPEG，真实 3:4/768×1024 裁剪与0 OO上传通过；原图保留、不自动入库、不继承原图审核。导出最长边4096、1600万像素，网页人工显示及其他格式/方向元数据待验证。详见 [图片工具](.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md)。
+
+`image annotate --input annotations.json --operation NAME`默认预检，支持原图像素矩形/椭圆/直线/画笔/单行文字；--yes才本地合成PNG并上传，下游类型按前端：生成图→普通图片，素材图→素材。查询/恢复用image annotate-get/annotate-recover。现有FFmpeg还须具备用到的drawvg/drawtext过滤器，文字需包含实际字形的已安装字体，缺依赖先询问；无文字无需字体。生成图面部红框、1024×1024 PNG和0 OO上传任务真实通过，中文字形/图形旋转及两类源兼容本地通过；文字旋转未接入，网页人工查看及其他真实标注子项待验收。详见[图片标注](.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md#图片标注)。
+
+可以全程使用 CLI 创建画布、添加节点、查询模型并准备请求，无需先在网页创建。创建不会提交生成；实际生成仍需预估和每次确认 OO 币。
+
+`node add` 只直接创建普通节点：文本、图片、视频、音频、三种素材节点及视频转绘入口，共 8 种。视频重拍、分段详情及后续节点链由真实业务流程派生，不提供独立创建入口，也不能注入派生标记来创建。类型映射与核验见 [节点流程](.agents/skills/uzoo-anime-cli/references/node-workflow.md)。
+
+视频分析、分段审核、切片及派生画布链现由 CLI 的 `repaint start/plan/confirm/wait/get/recover/operations` 编排。它调用现有后端接口，按真实任务结果保存节点、连线和分组，无需改前后端或打开网页。先运行 `repaint start --input repaint.json --operation NAME` 展示实际钱包和分析费用，获得当次确认后同命令加 `--yes`；方案也需先展示再确认。完整输入与恢复见 [视频分段流程](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md)。
+
+该阶段产出可继续操作的分段节点链。单段反推已接入独立reverse流程；单段无附件最终/交付提示词已接入delivery流程（单段默认首轮0 OO真实通过，自定义替换真实待验）；无额外参考的单段转绘视频已接入video专用流程，mini首轮生成/24 OO结算/回填恢复通过（原转绘成品现已通过专用下载入口导出及解码补验）；额外参考、批量和拼接仍待完善；片段重拍已独立接入remake流程，见下方重拍指南；带附件最终提示词已接CLI流程（真实处理待地址链路确认）；字幕及批量生成尚未接入。后续实际测试到对应路线时，按流程补全 CLI + skill 并逐段验收，详见[功能状态与待完善路线](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#功能状态与待完善路线)。CLI 退出后，已提交后端任务可以继续，但画布同步需 `repaint wait/recover NAME` 恢复。模拟接口、真实智能分析45 OO、单段切片/派生链与原任务恢复通过；真实快照的前端保存重开兼容通过。网页人工交互、均匀分段及改切点真实待验。详情被旧快照清除时默认停止，用户明确授权后可用`repaint recover NAME --restore-detail`预览，加`--yes`仅恢复原待审核详情和系统线，不重新分析。
+
+CLI 业务操作直接调用后端 API，不加载或执行前端代码；浏览器用于登录授权和可选的网页验收。派生节点由 `repaint` / `remake` 的真实业务流程创建，不能把空节点保存当成业务运行通过。
+
+```powershell
+node src/cli.js canvas create --name "CLI 测试画布" --space personal
+# 从响应取得 DOC_ID，再创建节点；返回 node_id
+node src/cli.js node add --doc DOC_ID --type image --node-id IMAGE_NODE_ID
+node src/cli.js resource upload --file cat.png --doc DOC_ID --node IMAGE_NODE_ID --type image --mime image/png
+node src/cli.js generation estimate --input request.json
+node src/cli.js generation submit --input request.json --operation cat-window-001
+# 交互卡片明确确认参数、钱包与费用后，将数值填入 $confirmedOo，再提交：
+node src/cli.js generation submit --input request.json --operation cat-window-001 --yes --expected-cost $confirmedOo
+node src/cli.js generation wait TASK_ID
+node src/cli.js generation download TASK_ID --output result.png
+```
+
+请求文件用 UTF-8 保存，示例中 ID 与模型名须替换为真实查询结果：
+
+```json
+{
+  "doc_id": "DOC_ID",
+  "node_id": "IMAGE_NODE_ID",
+  "segment_type": "image",
+  "model_name": "模型目录返回的 label",
+  "prompt": "一只坐在窗边的猫"
+}
+```
+
+节点可用 `node update --doc DOC_ID --node-id IMAGE_NODE_ID --input node-patch.json` 修改参数；输入格式见 [命令契约](.agents/skills/uzoo-anime-cli/references/commands.md)。版本冲突会停止，不会自动覆盖网页修改。
+
+上传结果引用需按实际响应填入模型支持的参考字段。资产库图片上传可以不传 `--node`，改传 `--asset-type character|scene|prop --name 名称`。视频/音频上传需要节点。不会代替用户设置协议同意字段。
+
+## 恢复与错误
+
+提交前记录原请求与幂等键。网络中断后保留原 operation：
+
+```powershell
+node src/cli.js generation operations
+node src/cli.js generation recover cat-window-001
+# 仅在提交结果未知、且确认恢复原提交时使用：
+node src/cli.js generation recover cat-window-001 --yes
+```
+
+已知任务 ID 时只查询；未知时使用原幂等键重新调用提交接口。operation 不得用于不同账号、API 地址或请求。后端没有按幂等键查询的公开接口，因此无法在不调用提交接口的条件下取回未知 task ID；不要删除记录后换 key 重试。同一 profile 的命令串行执行，防止刷新轮换和恢复提交互相覆盖。
+
+默认成功输出为 API 数据 JSON，提交结果为 `{operation, estimate, task}`，下载结果为 `{output, bytes, sha256}`。失败在 stderr 输出 JSON，退出码：2 参数/配置/存储错误，3 API 错误，4 提交结果未知，5 超时，6 任务失败，130 中断。`--format table` 适合人工查看，agent 使用 JSON。
+
+全局可用 `--profile NAME --request-timeout MS`；轮询另有 `--interval MS --timeout MS`。下载不覆盖已有文件，支持 `--sha256 HEX` 校验；匿名文件GET支持最多5次307引用续期，API与上传仍拒绝跳转；拒绝HTML/JSON错误页、非预期部分响应及不完整文件。对没有下载文件的文本任务，使用 `generation get` 的结果。
+
+普通配置位于 `%APPDATA%\uzoo-anime-cli\NAME.json`，Windows 密文位于 `NAME.dpapi`，签名密钥仅在内存。旧版明文 profile 首次使用时自动迁移，迁移失败保留原文件并报错。本地 operation 记录含提示词和素材引用，位于同目录 `operations/NAME/`；退出不会清除记录。强制终止进程可能留下 `NAME.lock` 空目录，确认进程已退出后可手动删除。
+
+## 验证
+
+```powershell
+npm run check
+npm test
+npm run test:browser
+python C:\Users\Liu\.codex\skills\.system\skill-creator\scripts\quick_validate.py .agents\skills\uzoo-anime-cli
+```
+
+测试使用本机 mock API 与临时测试凭据，不访问真实业务服务，不产生扣费。`npm test` 还验证新授权协议的 E1、PKCE、本机回调和刷新恢复；网页短信、滑块和真人授权仍需在隔离环境验收。
+
+`image matting --input matting.json --operation NAME`已接入免费抠图，默认预览、--yes只提交一次；签名multipart、原PNG缓存／透明通道核验、素材节点及来源线、CAS读回与已知结果恢复。正式站7738返回0 OO，用户确认网页重开通过；未知响应无结果引用时无法服务端查回，绝不自动重做。matting-check仍仅只读预检。见[抠图流程](.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md#图片抠图)。
+
+`remake prepare --input remake.json --operation NAME`默认预检，--yes仅创建源片绑定的派生重拍配置和来源线；`remake submit NAME`实时预估，当次确认后才加--yes --expected-cost；get/wait/recover查询和同步原任务。单源视频0–4秒重拍真实完成，结果/任务/系统线与下载验证通过，网页codec保存重开通过。--expected-cost为提交前比价。无ID的未知提交不盲目重发，附加素材与批量未接入。详见[重拍指南](.agents/skills/uzoo-anime-cli/references/remake-workflow.md)。去字幕依用户说明暂停服务，本轮跳过接入和实测。
+
+`repaint reverse PARENT --segment-index N --operation NAME`先核对原分段任务和片段，实时查询单价与首轮权益，取得当次确认后加`--yes --expected-cost OO`提交一次。`reverse-get/reverse-wait/reverse-recover NAME`查询并同步原反推节点，不重发未知任务、不处理最终提示词或视频。真实单段首轮权益0 OO、回填与前端保存重开/重复恢复通过，付费重做和多段上下文真实待验，详见[反推指南](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#单段反推提示词)。
+
+`repaint delivery PARENT --segment-index N --operation NAME [--input rules.json]`先预估，沿用明确的替换要求或“不替换”；缺信息时由Agent交互卡片收集。单次确认后加`--yes --expected-cost OO`按前端顺序保存现有全局设置并处理最终提示词；delivery-get/wait/recover查询回填原节点。单段无附件默认处理首轮0 OO、正常结果回填、重复恢复及前端保存重开真实通过；自定义替换、非空全局规则和付费重做真实待验；回退结果明确报告fallback及未生效事项，不自动生成视频或入库。见[最终提示词指南](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#单段最终提示词与替换交互)。
+
+`repaint video-options PARENT --segment-index N`列出专用画布转绘的实际可选模型。用交互卡片选择模型/输出参数后，`repaint video PARENT --segment-index N --input video.json --operation NAME`同时核对画布和转绘估价；当次费用确认后加`--yes --expected-cost OO`单次提交。`video-get/video-wait/video-recover NAME`查询并同步原生成节点；`video-download NAME --output FILE`通过原任务的下载权限接口导出，下载被2001拒绝不代表生成失败，不改用结果URL绕过团队限制。当前画布路径不将源视频作为模型参考发送；仅首轮、单段、无额外参考，不能据此宣称整片拼接已完成。见[单段转绘视频指南](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#单段转绘视频生成)。
+
+`repaint settings-get PARENT`查看全局文本两端状态；`repaint settings PARENT --input settings.json --operation NAME`预览`custom_prompt`编辑，已授权后加`--yes`保存原后端设置与原全局节点，保留已有附件和结果。`settings-operation/settings-recover NAME`查询及恢复原两阶段保存，不重发未知POST、不重处理提示词或生成。真实全局文字保存、原结果保留/重复恢复及前端保存重开通过；任务素材池上传/查询和全局附件上传/挂载现已接入，见下文；带附件最终提示词的准备/费用/提交/恢复已接入（真实处理受地址限制待验），独立页素材池参考参与生成未接入、暂不实现。详见[全局规则文本编辑](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#全局规则文本编辑与恢复)。
+
+`repaint materials PARENT`列任务素材；`repaint reference-upload PARENT --input reference.json --operation NAME [--yes]`上传file/kind/category到任务池，`repaint attachment-upload PARENT --input attachment.json --operation NAME [--yes]`上传file并挂载原全局附件。默认只准备，已授权免费动作加--yes；upload-get/upload-recover查看或按已知阶段恢复。两条图片路线、原结果保留、重复恢复及前端保存重开真实通过；不自动入普通素材库、审核、处理或生成。音频/PDF真实待验，带附件处理需先检查submission_available/blockers，当前测试的本机代理地址被拦截、真实处理待验；独立页素材池参考选择/生成未接入、暂不实现。详见[任务素材与附件指南](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#任务素材池与全局附件上传)。
+
+带全局附件的`repaint delivery`沿用同一命令：按当前pricing与单段billing-estimate核对处理费+附件超额费，预览展示submission_available/blockers。附件保留在全局settings中，不改写进reference_images；本机/内网地址会在收费前停止，不能把网页能显示图片当作模型可读取。真实只读预估和保护通过，带附件模型处理尚未实测。详见[带全局附件的最终提示词](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#带全局附件的单段最终提示词)。
+
+`repaint history NAME --type reverse|delivery|video`在全局配置变更后只读核验对应阶段的原operation、结果与费用，不写回、不提交或下载。提示词接口仅有当前轮，原轮被替换时返回`original_result_unavailable`，不把新结果认作旧结果。当前已完成真实原最终提示词/视频查询；配置变更后的原结果导出已接入，转绘任意轮次切换/写回仍待完善。普通图片/视频历史选择见下文。见[原运行只读查询](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#原运行只读查询)。
+
+
+配置变化后可用`repaint export NAME --type reverse|delivery|video --output FILE`交付原结果，或`video-download NAME --output FILE`下载原视频；视频始终经过专用下载权限，不能绕过业务权限。新版下载契约取消团队白名单，是否部署须按当前服务响应核验，不能仅凭2001推断白名单原因。今后成功恢复的原提示词会保存本地快照；服务端旧轮替换后仅在已有快照时显式`--source archive`导出，并说明来源。文件不覆盖，原任务不重新生成。见[原结果导出](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#原结果导出与本地归档)。
+
+多段可用`repaint sequence PARENT --input steps.json --operation NAME`保存逐项调度，`sequence-get NAME`只读核验，`sequence-next NAME`准备下一项；单次费用确认后加`--yes --step CHILD_OPERATION --expected-cost OO`仅执行这一项。`sequence-recover NAME --step CHILD_OPERATION`恢复原子操作，不重发未知提交。它复用画布单段流程，不接独立页批量接口，也不拼接整片；见[多段调度](.agents/skills/uzoo-anime-cli/references/repaint-workflow.md#多段的逐项调度)。
+
+维护者可用`npm run test:package`验证实际打包、离线隔离安装、命令入口、13份skill参考的逐字节复制及Windows模拟账号DPAPI/退出，并将同一版本包覆盖重装，验证配置/凭据与各类operation及归档原字节保留，普通生成/转绘operation列表可继续查询；退出仅清凭据。跨版本升级尚未验证。不会发布或更改全局skill目录；它复用当前操作系统/Node，不代表干净机器或真实网页登录验收。
+
+普通图片/视频可用 `generation history --doc DOC_ID --node NODE_ID --space personal --status completed` 查询真实历史（团队须带已确认的team UID）。用户选定条目后，`generation history-select --input history.json --operation NAME` 先预览；明确选择后同输入加 `--yes` 仅一次保存所选历史结果与对应提示词/模型等配置。恢复旧task同样恢复该次历史配置，不能理解为回到切换前的编辑快照。无新生成，不自动入库或重新生成下游；当前参考、其他节点及连线保留。保存未知用 `generation history-get/history-recover NAME` 只查询核验，不重发。普通视频真实切换/恢复和图片/视频前端选择、序列化重开兼容通过；普通图片真实历史切换／恢复已通过，图片网页采用1986／离开重开／恢复2071再次重开已通过。输入、分页与状态详见[普通历史指南](.agents/skills/uzoo-anime-cli/references/generation-workflow.md#普通图片与视频历史选择)。
+
+2026-10-31下载契约适配：现有普通生成、转绘原视频导出与媒体读取支持匿名307引用续期，保留服务端完整URL/查询参数，并识别HTTP200错误JSON及安全诊断。业务下载端点与旧operation保持，失败不重做生成或写画布。新素材空间命名/格式转换接口没有自动扩成现有命令参数；当前CLI未新增转换/预览命令。素材原格式下载现已提供material download，见下文。说明涉及尚未部署改动，源码/当前服务和新版契约分别记录，见[适配与验收](docs/下载接口适配与验收.md)及[使用规则](.agents/skills/uzoo-anime-cli/references/commands.md#下载与文件凭证)。
+
+素材原文件可用`uzoo-anime material download ASSET_ID --space personal --output FILE [--sha256 HEX]`；团队须换为`--space team --team-uid UID`。先核对空间/素材，再经专属业务入口取链接，只下载original；业务拒绝不退回列表URL，不写画布/上传/生成/入库。团队素材107原文件下载及受控非成员拒绝已真实通过；读取服务端响应文件名，当前不支持格式转换。详见[素材下载](.agents/skills/uzoo-anime-cli/references/material-graph-workflow.md#素材原文件下载)。
+
+非转绘首批N1/N2/N5状态见[执行与验收](docs/非转绘首批实施与验收.md)：两帧上传和已有素材重新导入在CLI保存时成功，但网页后续保存中新增节点缺失，已停止该画布写入且没有自动重建；N5独立环境验收清单已准备，干净机器/真正跨版本仍未验收。
+
+### 可选：Seedance 2.5提示词优化
+
+安装独立sd25-pe后，Agent在Seedance 2.5视频生成过程中自动按其规则组织提示词，无需用户主动调用skill。CLI继续负责素材绑定、参数校验、审核/协议、估价确认与提交。安装方式与@素材交接见[优化指南](.agents/skills/uzoo-anime-cli/references/generation-workflow.md#seedance-25提示词优化sd25-pe)。
+
+## 2026-11-03非转绘完善
+
+新增普通媒体单个/混合批量复制（1–100）、来源历史与任务归属隔离、分组整体移动/组框调整/组内三种重排；修正断线后保留持久参考的模式计算。单次预览/expected_version、一次CAS及读回校验保持。样片转正片新增draft prepare/submit/get/recover/wait，继承父任务并按实际报价确认，未知提交只查原任务；当前仅模拟/前端codec通过，真实闭环待有效样片。
+
+本批真实及网页验收、费用、限制和证据见[集中记录](docs/非转绘持续完善与验收-20261103.md)。N5安装与交付专项、转绘和去字幕未开展；`npm run check:resources`仅检查离线包资源，不安装/升级/发布。
+
+## 本地npm构建与打包（2026-11-03）
+
+本地打包生成0.5.0归档，按已确认策略配置public／latest；生成归档不等于上传npm。原生ESM无需转译：`npm run build`执行语法及离线资源检查，`npm test`运行模拟回归，`npm run pack:local`完成构建检查后生成outputs/npm/独立时间目录中的tgz与manifest.json，并核验归档长度／摘要。白名单打包运行模块、资源、skill、文档和示例，排除测试、宿主规则、本地记录／凭据及历史归档；标准npm pack也会执行prepack构建检查。
+
+已实现能力和剩余真实条件见[当前范围与打包说明](docs/CLI当前范围与本地打包-20261103.md)。可以制作内测包，不等于所有网页／收费专用路线验收完成；N5仍未开展，未安装、升级或发布npm包。
+
+## 0.5.0-rc.4样片检修
+
+真实样片2072已完成、回填及下载，修复后端基础模型名称归一导致的Draft回填误拦，保留有效期元数据与重复sync无写入保护。此前rc.1和0.4.0归档保留；当前完整正片真实闭环仍待单独费用授权，详情见[补充验收](docs/非转绘补充条件验收-20261103.md)。
+
+## 样片到正片的真实闭环（2026-11-03）
+
+用户先认可低画质样片，再独立确认高画质费用：2072样片52 OO→2073正片260 OO，父子关系、画布回填、原片下载、实际1440×1440及完整解码通过；两阶段合计312 OO。重复原operation恢复无新任务、无再次画布写入。正片网页展示／保存重开未冒称通过，见[真实记录](docs/非转绘补充条件验收-20261103.md)。
+
+普通历史新增为独立结果节点使用 `generation history-add --input history-add.json --operation NAME`，默认预览，再同输入加 `--yes`；输入含历史字段、new_node_id和position，可选title／expected_version。原节点与全部输入参考不变，新节点不认领原生成任务，不继承素材／审核授权；只读恢复使用 `history-add-get/history-add-recover NAME`，保存未知不重放。图片1986、视频2069真实新增及网页重开通过；正片2073网页完整播放通过。详见[历史新增节点](.agents/skills/uzoo-anime-cli/references/generation-workflow.md#将普通历史结果添加为新节点)。
+
+此前正式站2110/cli_auth_disabled阻塞已解除；2026-11-04本人正式授权、免费抠图执行／落图及用户确认网页重开通过，详见抠图流程及验收文档。
+
+## 2026-11-04 正式站接入更新
+
+当前用户指定实际服务为https://uzooai.com，使用独立uzooai-online profile。用户启用授权后本人正常登录／授权及账号读回成功，历史2110/cli_auth_disabled阻塞已解除。正式站实际账号／团队与开发站不同，操作前重新查询并绑定实际对象，不迁移旧operation的服务地址。抠图已接入单次免费执行及已知原结果／缓存恢复，正式站真实处理和用户确认网页重开通过；未知响应无结果引用时仍无法服务端查回，不重发。免费处理不以余额0判不可用。
+
+免费抠图可在原预览后用`image matting-start NAME --yes`独立后台缓存，`image matting-status NAME`离线查询；确认画布关闭后用原`matting-recover NAME --yes`回填。未知处理不重发；见[后台流程](.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md#抠图独立后台执行与本地查询)。
+
+异步抠图可在原预览后用`image matting-submit NAME --yes`入队，`matting-get NAME`查原job，完成后原`matting-recover NAME --yes`取回并落图；本地`matting-status`不联网。44组回归与前端对照为已有基线；2026-11-05正式站异步202提交、CLI退出后原job查询、实际0 OO、透明PNG恢复／一次CAS及用户网页保存重开通过。旧同步和本地worker兼容，见[异步流程](.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md#服务端异步抠图任务)。
+
+当前非转绘完成范围、2078服务端元数据及剩余真实边界、条件性能力与npm发布准备见[收尾核对](docs/CLI缺口核对与收尾-20261105.md)。该清单不恢复N5、转绘或去字幕，不代表已授权发布。
+
+维护者发布准备：`npm run check:release`只做本地公开包策略／构建检查，不会登录、修改npm权限或上传包。当前版本0.5.0／latest，实际发布须完成npm账户／scope／2FA核验并取得当次明确授权。

package/assets/README.md

@@ -0,0 +1,4 @@
+# 授权结果页品牌资源
+
+favicon-uzoo.png 复用前端 public/favicon-uzoo.png；logo-uzoo.svg 复用前端 src/assets/logo-uzoo.svg。
+资源随 CLI 一起分发，回调页面通过 data URL 内嵌，不请求网站、CDN 或本地额外资源。

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/CLI/345/275/223/345/211/215/350/214/203/345/233/264/344/270/216/346/234/254/345/234/260/346/211/223/345/214/205-20261103.md

@@ -0,0 +1,134 @@
+# CLI当前范围与本地打包（2026-11-03）
+
+## 可交付范围
+
+当前可制作内测用npm压缩包，不把本地打包成功等同正式发布或所有真实业务验收完成。正式名称更新为@uzooai/anime-ai-cli、MIT许可证、待发布版本0.5.0，已准备private=false／public／官方registry／latest，保留Node.js >=22要求；原生ESM JavaScript无需转译，没有新增构建依赖。禁止自动npm发布、Git提交或推送。
+
+已收紧的普通路线包括媒体复制的任务来源／历史／引用归属，画布CAS和读回，同节点再次生成的提交前快照与最新任务保护，未知提交原operation恢复，独立费用确认和本人协议签署。图片prepare之外的直接estimate/submit也只接受数值image_count=1；多张、零张、字符串数量在估价前拒绝，不能通过手写JSON扩展前端未支持的参数。
+
+当前抠图已接同步／本地后台及服务端异步job；正式站202、CLI退出后按原job查询／取回PNG、实际0 OO、一次CAS及用户网页重开通过。image matting-check仍为只读预检；未取得job_id或原结果引用的未知提交无法可靠查回，不重POST。此前开发部署无服务／正式站授权关闭为历史状态。
+
+## 构建与打包
+
+```powershell
+npm run build
+npm test
+npm run pack:local
+```
+
+build做语法和离线包资源检查，不生成编译目录。pack:local先build，再离线npm pack，输出outputs/npm/独立时间目录/*.tgz及manifest.json，校验实际归档长度、SHA-1及SHA-512 integrity。目录每次独立，保留全部旧产物。标准npm pack也有prepack构建检查；资源dry-run显式ignore-scripts以免递归。
+
+files白名单包含src、assets、完整skill入口及13份参考、历史登录扩展兼容资源、示例、文档及两个打包检查脚本；README/package.json由npm包含。排除test、本机outputs/.local/node_modules、宿主AGENTS、安装专项脚本、内部远端联调记录、凭据及旧tgz。维护者文档中的兄弟前后端仓库源码链接只作为历史证据，不属于运行依赖；CLI、README和skill所需包内相对依赖另行检查。
+
+可以将该tgz交付给内测用户，通过npm安装；本轮没有执行安装、全局配置修改或干净Windows／跨版本验收，不属于N5专项。npm安装不会自动注册Agent skill，仍按README复制完整skill目录到宿主支持的位置。
+
+## 尚未宣称完成的路线
+
+| 路线 | 具体条件／边界 |
+|---|---|
+| 图片历史网页保存重开 | 采用1986／离开重开／恢复2071再次重开及独立服务端读回已通过 |
+| 样片转正片 | 2072→2073真实CLI闭环、父子关联、回填、下载／解码及52+260 OO核验通过；正片网页重开、1440×1440／4.064秒完整播放已通过 |
+| 协议阻断后原生成续接 | 2026-11-04猫猫队新协议v3真实前检阻断→本人签署→原operation任务2078完成，16 OO；回填／下载／解码及无重复提交通过 |
+| 抠图 | 单次免费执行、透明PNG、已知结果GET／缓存恢复、CAS落图与正式站网页重开通过；无引用的未知提交仍缺服务端查询契约，不重发 |
+| 真实过期／不可续期、私有／下架下载组合 | 非成员拒绝已过，其余需受控真实条件，不篡改凭证或删除素材制造情景 |
+| 图片多张、音频生成、格式转换、完整撤销、更多重拍／ZIP等 | 只接实际前端能力；没有当前完整产品入口／契约时不造参数。普通图片当前单张；格式转换当前不支持 |
+| 大小元数据 | 2026-11-03 15:24最新复测2069／2071记录大小与实际字节均一致、原摘要不变；旧失败证据保留 |
+| N5、转绘、去字幕 | 继续排除／暂停；本地语法、回归及归档资源检查不是恢复这些专项 |
+
+真实业务及收费历史见[补充验收记录](非转绘补充条件验收-20261103.md)。本次历史新增两个测试节点，网页采用旧图片并恢复2071；无新生成、审核、上传、入库或费用。
+
+历史新增普通节点已接入history-add，预览／CAS／原operation只读恢复／读回核验及来源历史归属保护，真实图片／视频新增和网页重开通过。
+
+## 2026-11-04 新协议v3真实续接通过
+
+猫猫队实际v3未签状态下，CLI先持久化blocked_agreement（无生成POST／远端任务）；本人阅读签署后，通过原recover复核账号、请求及报价，以原operation和同一幂等键提交一次，任务2078完成、实际16 OO，回填／下载／完整解码通过；再次recover无新提交。此项更新v2独立签署后“尚缺收费原任务续接”的历史状态。未向生成接口故意跳过前检制造4401；并发版本变化的服务端4401分支仍为模拟覆盖。正文版本更新必须重读当前服务端状态，不能把本次v3已签当作未来版本同意。
+
+## 2026-11-04 任务2078下载元数据补验
+
+新协议v3验收生成的2078已完成／charged／16 OO。两次均通过原任务专属下载入口重新取链，实际交付602870字节、SHA-256 b273d50132379c984106fd0d4cf07d92273715463460586c323d845130aeb2c7，两次完全一致；H.264 640×640／24fps，容器4.096秒，整片完整解码通过。原任务GET的result.file_size前后仍为937487，与实际交付不一致。
+
+本次协议原operation续接及媒体交付可用通过；大小元数据一致性不通过，交后端核对最终交付版本／更新时点，未擅自认定根因。此前2069／2071大小一致复测仍是各自条目的有效历史证据，不扩大为新任务均已修复。未修改前后端、篡改凭证、转码、重新生成或覆盖旧文件。
+
+证据：.local/frontend-conflict-20261102/agreement-v3-finish-1793757654901.json、size2078-recheck-1793757700987.json；两份MP4均保留。原operation=seedance-agreement-v3-20261104、task_id=2078。共享钱包2665→2641仅为快照，任务实际结算16 OO，不从余额差额推定其他消费。
+
+## 2026-11-04 实际业务地址切换正式站
+
+用户说明服务版前后端已更新，后续业务地址切换为https://uzooai.com，使用独立uzooai-online profile；原开发站配置、凭据、operation及产物保留，不跨服务改绑或重放。正式站live/ready均HTTP200/code0，database/redis均ok；更新后的CLI授权实测仍返回2110/cli_auth_disabled，未建立正式站CLI会话。等待部署方核对授权开关及HTTPS的CLI_AUTH_ORIGIN，尚未在正式站签署或提交业务。详见[正式站切换与验收](正式站切换与验收-20261104.md)。开发站此前验收不自动视为正式站业务通过。
+
+## 2026-11-04 正式站授权已启用并完成登录
+
+用户确认正式部署授权开关已启用生效后，重新运行uzoo-anime --profile uzooai-online auth login，正式站返回https://uzooai.com/auth/login授权页。用户本人登录并明确授权，CLI成功保存独立加密会话，cliSessionReplaced=false；此前2110/cli_auth_disabled阻塞已解除。
+
+独立GET核验：API=https://uzooai.com/api/v1，live/ready均HTTP200/code0、database/redis均ok。实际账号LIU（uid=585603228375），唯一有效团队“SD2.5-Draft功能测试”（team_uid=519080401579），共享余额快照0 OO；协议required=true、agreed=true、version=v2。正式站账号／团队与开发站不同，不能复用开发站猫猫队、测试画布或任务ID。正式站v2已签不代表开发站v3发生变化，也不需要为切换再次签署。
+
+后续真实业务明确使用uzooai-online profile和正式站实际对象。开发站stage3b-test及旧operation／产物保留，不将其改绑到正式站。抠图免费约束沿用用户说明；CLI登录成功只解除身份接入阻塞，不等于抠图执行／原结果恢复已经实现或已验收。
+
+本次未创建／修改正式站画布、上传、签署协议或提交生成／抠图，未产生费用。证据：.local/frontend-conflict-20261102/production-switch-1793774998943.json；正式网页公开入口/assets/index-Da5Nhe9D.js已记录，公开HTML摘要b32df6a35c964ba2e813b66937ac075280bcdc04227d86d971213cbbf0639c72。页面资源不当作抠图推理服务或全部业务契约证明。
+
+## 2026-11-04 正式站抠图执行更新（rc.4）
+
+免费抠图已接入单次执行、透明PNG核验、缓存与已知原结果GET恢复、CAS落图及来源线；正式站7738原图返回0 OO，用户确认网页保存重开，独立102版读回通过。此前“仅预检／执行未实现”为历史阶段；无引用的未知提交服务端查回仍未接入，不重发。详情见[抠图接入与验收](图片抠图接入与验收-20261104.md)。
+
+## 2026-11-04 独立后台执行更新（rc.5）
+
+用户选择独立后台执行＋原operation状态查询，保持现有同步PNG接口。新增matting-start／matting-status：后台独立Node进程仅缓存PNG，原recover确认后保存；本地状态可离线读取、不争profile锁，不冒称服务端实时进度。网络真正丢响应且无引用、关机／强杀后的未知提交仍不重发；不改前后端。
+
+正式站新operation production-matting-background-7738-20261104，用户已授权一次免费处理并确认关闭画布，原图7738与旧operation保留。启动命令退出后worker独立接收完成，原PNG220×757／116567字节，SHA-256为3a9eaf344f95de7b1b81008beee2e866be706a0a23f7cffc4087c2620944dd8e；alpha0–255，透明87441／有效79099／半透明11493像素，实际响应0 OO。
+
+后台完成时画布仍104版／6节点／5线，无结果节点且尚未尝试保存；原operation recover --yes一次CAS到105版／7节点／6线，独立读回及重复只读恢复canvas_verified=true，无再次处理或保存，不入库。新结果未重复做网页重开验收；旧结果用户已确认网页正常／保存重开仍在的记录不混作新结果证明。
+
+脱敏证据.local/frontend-conflict-20261102/production-matting-background-verified-1793783196848.json及production-matting-background-7738-20261104.png。模拟覆盖启动进程退出、后台存活、离线状态、profile锁、重复启动、错误worker绑定、立即响应、网络丢响应／强杀不重放、缓存后同operation显式回填；测试结果以本轮实际执行记录为准。
+
+本轮最终检修：43组完整npm test通过（含独立后台／立即响应／断网／强杀／离线查询及原operation恢复）；npm run build语法检查与包运行资源检查通过，117个包文件、245个相对运行资源、235个包内文档链接、13个skill参考。skill校验、UTF-8／本地链接和git diff --check通过，原有混合换行文件保持。没有安装软件、执行N5、发布或Git提交。
+
+## 2026-11-04 异步抠图接口适配（rc.6，真实验收待条件）
+
+用户截图新增POST /api/v1/matting/jobs（multipart，202与job_id）和GET同路径/{job_id}（仅提交者，五种状态及成功result_ref／result_url／credit_cost）；旧同步接口保留。本地anime-ai-engine/app/api/v1/matting.py与前端仍为旧同步实现，等待新代码位置／脱敏响应示例。正式站公开OpenAPI未给可用JSON；就绪探测通过，签名随机不存在job只读查询HTTP200／业务码3001、request_id=ee2da706-2111-4e61-8892-43e13168e68c，没有提交真实处理或写画布。
+
+已实现matting-submit及按原operation的服务端查询／恢复，202及job_id立即持久化，五状态、实际免费约束、匿名原引用GET、透明PNG／尺寸核验、一次CAS及不重放保护；同步旧operation／本地后台记录保留。针对性模拟通过个人／团队、CLI重建client后的原ID查询、排队／处理／终态、失响应／不合法响应、费用／身份／来源／权限／PNG异常及保存冲突／丢响应。模拟不替代真实接口成功验收，当前未提交新真实job、未产生本轮费用或新画布变化。
+
+提交没有job_id的失响应仍缺幂等／按请求键查询契约，不自动重提；已知job_id后无需本地进程持续存活。新路线真实处理及网页重开待用户确认本轮原图和画布关闭后验收。
+
+## 异步抠图最新核验：前端已更新，正式站提交未确认
+
+用户说明最新前端已有实现，并明确采用原图7738的一次免费验收、确认本轮画布关闭／保存。前端工作区原本干净，git fetch origin后确认当前提交为origin/master祖先，仅git merge --ff-only origin/master从3d3a2a84快进919c71b8，没有创建新提交／推送、安装或启动前端。实际media-tools/api/matting.js有createJob/getJob，services/matting.js的createAndPoll核对202、job_id、裸／code-data包装、五状态和结果字段；flow/services/nodeActionService.js画布入口调用createAndPoll，未开放threshold参数。
+
+44组完整npm test通过；诊断补充后异步抠图针对性测试再次通过（含实际遇到的HTTP200／3001不重放）。新增test/matting-jobs-web-compat.mjs只读加载上述实际前端service，个人／团队表单、202与ID、裸／包装响应、queued→processing→succeeded及结果URL对照通过。使用现有Vite依赖，无安装。前端代码对照不是当前正式部署任务成功证明。
+
+原图7738预览实际团队SD2.5-Draft功能测试（519080401579）、钱包0 OO、220×757，最新画布105版。仅一次POST /matting/jobs尝试使用operation production-matting-job-7738-20261104，返回HTTP200／业务码3001，没有job_id；安全request_id=bbb410d1-f06c-47ba-bbbb-32190b4cf766。保留submission_unknown及原诊断，没有重POST、启动新worker或换operation。当前不能证明已入队或未入队，费用未确认，不将原免费约定冒称本次服务结算证据。
+
+失败后只读服务探测ready（数据库／Redis），随机job路径与任意不存在路由均返回HTTP200／3001“请求的资源不存在”，仅支持“疑似未挂载新路由”，不能证明某一任务状态。画布仍105版／7节点／6线，原图在、分配的新结果节点不存在，无本次画布变化。已请求服务端核对正式部署及原request_id，若有job则提供原job_id；不自动重新提交。后台worker上轮0 OO／104→105的成功证据与本轮失败分开。
+
+脱敏证据.local/frontend-conflict-20261102/production-matting-jobs-route-diagnostic-1793785327626.json。原operation本地诊断保留；本轮新接口完整成功、原job恢复下载／落图和网页重开未通过。旧同步／本地后台功能继续保留。
+
+2026-11-04用户明确选择“先保留阻塞，完成CLI开发测试与打包”。本轮停止真实异步补验，不等待或自动重试部署；保留production-matting-job-7738-20261104原未知提交、诊断及所有旧产物。44组完整回归及后续针对性诊断回归、最新前端异步service对照和实际asset factory／snapshot重开对照通过；候选rc.6本地构建／包资源检查通过（118文件、250相对运行资源、238包内文档链接、13 skill参考），private且不发布。新异步job成功查询／PNG恢复／落图／网页真实验收仍待服务端核对后另行推进；本次画布无变化，是否入队及费用未确认。
+
+## 2026-11-05 异步抠图真实路线通过
+
+用户通知CLI权限修复后，只读确认新查询已到达业务接口；用户另确认旧request_id经服务端核对未入队，并重新确认画布关闭。保留旧记录，新关联operation production-matting-job-7738-20261105仅提交一次202，job_id=42740a87-7308-4099-9d80-62c3781c5f17。提交CLI退出后新进程查询原job成功，实际0 OO；原operation取回220×757／116567字节透明PNG并一次CAS落图，105→106版、7→8节点、6→7线，原内容保持且重复恢复不再保存／处理。
+
+用户确认本次网页显示正常、保存重开后结果及来源线仍在；其后只读109版／8节点／7线、原operation completed／canvas_verified=true，网页规范化后的canvas_exactly_matches=false不误报失败，不覆盖网页内容。本轮业务代码不变；前轮44组回归及前端对照属于历史已通过，本轮新增真实部署／任务／PNG／落图／用户网页及其后读回证据。候选rc.7同步记录、文档和skill，保持private，不发布、不做N5。
+
+此前3001／403及等待修复为历史状态，当前阻塞已解除。无job_id的未知提交仍不能自动重提；这次旧请求未入队依据用户服务端核验，未篡改旧operation。完整证据和未覆盖边界见[本次真实验收](异步抠图真实验收-20261105.md)。
+
+## 2026-11-05 最终收尾核对
+
+本轮重新执行44组完整模拟回归通过，并核对最新真实证据。已修正skill能力表的旧验收状态；主线完成项、2078大小元数据交接、真实边界、条件性能力和npm发布前置项分开，详见[收尾清单](CLI缺口核对与收尾-20261105.md)。候选rc.8不改CLI业务实现，不做真实生成／处理／画布写入，不恢复N5／转绘／去字幕，不提交推送发布。
+
+## 2026-11-05 组织确认与0.5.0发布准备
+
+用户已创建npm组织uzooai；正常CLI只读核验当前账号liuwql为组织owner，npm本机登录成功。目标包未查到已发布版本；首次尚未发布的目标没有包级可写列表条目，不再把组织创建／owner身份误列为未确认。账户2FA最后读回disabled，仍需本人设置及再次读回。
+
+用户明确选择正式0.5.0／latest，并同意先同步版本、发布配置和最终产物检查；该选择不授权实际上传。已准备package.json private=false与publishConfig public／https://registry.npmjs.org/／latest，lock／CHANGELOG／说明同步。包检查改用统一显式策略：内部private候选仍可本地打包，公开包须完整匹配名称、入口、MIT、官方registry、稳定／RC通道。pack:local输出改读实际private与通道，不再硬编码private=true。安装专项脚本同样读取策略兼容，但本轮不执行N5。
+
+新增npm run check:release（本地构建＋版本／lock／独立更新记录／许可证／入口检查）及prepublishOnly挂钩；它们不执行登录、2FA、权限变更或发布。脚本和新运行依赖纳入包资源检查，拒绝缺失发布策略模块。新增策略模拟覆盖私有／公开、非官方registry、缺显式private、错误入口／许可、RC串latest等；具体检查结果按本轮实际执行记录，不因配置存在就宣称已发布。
+
+等待2FA本人启用及最终归档复核后，才展示具体包／版本／通道／摘要并收集当次上传授权。当前不npm publish、不提交／推送，不新建真实业务任务／写画布，不恢复边界专项／N5／转绘／去字幕。旧候选包、全部凭据／profile／operation保留；公开发布配置并非切换平台账号或修改业务请求。
+
+## 0.5.0本地发布准备最终检查
+
+用户选择0.5.0／latest，配置与统一发布策略本地检查通过；Windows原子rename修复及策略测试加入后，46组完整npm test实际通过。此前两次45组在截帧Temp的EPERM中断、针对性复验和修正记录均保留，不抹掉失败，也不将重试描述为网络重放。完整回归仍只是模拟／本地检查，已有真实业务证据范围不扩大。
+
+最新npm只读身份核验：本机已登录，liuwql为uzooai组织owner；two-factor auth仍disabled，目标包未查到可见已发布版本。正式发布配置已经准备，不表示已获实际上传授权。下一步为本人启用2FA并核验，然后展示最终归档与摘要取得当次发布确认；未执行npm publish、安装专项、Git提交／推送或真实业务写入。
+
+本轮静态及包检查保留13份skill参考、公开运行模块和新的发布校验模块，排除.local、outputs、测试／凭据和内部远程联调记录；归档以本轮pack:local生成的独立目录和manifest校验为准。README安装入口使用版本／通道和条件性发布表述，避免归档发布后仍把“尚未上传”的准备快照当成用户功能状态。