@uzooai/anime-ai-cli 0.5.0 → 0.6.0

package/README.md

@@ -1,242 +1,46 @@
 # Uzoo Anime CLI
 
-**当前开发范围（2026-10-31）**：转绘因重新设计暂停CLI开发和专项补验，现有代码/记录/结果保留，不自动续做。后续按[非转绘完善计划](docs/画布CLI非转绘完善计划.md)推进普通画布、节点工具和下载；N5安装与交付专项仍排除；片段重拍单独保留现状。下文转绘命令及测试是历史能力记录，不表示当前执行安排。
+通过终端或 Agent 操作 Uzoo 的画布、素材和生成任务。支持 Node.js 22 或更高版本。
 
-视频转绘当前只接入**画布内流程**；独立「视频转绘」页面标为**未接入，暂不实现**。共用接口及历史任务素材上传测试不代表独立页面可用。
+## 安装 CLI 与 Skill
 
-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
+```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。重复下载同一个版本不会增加命令。
 
-线上 profile 只有在服务端和前端完成上线并开启功能后才能使用；`uzooai-online` 内置 `https://uzooai.com/api/v1`。直接运行：
+从 0.6.0 起支持一键安装。在该版本进入 npm 的 `latest` 后，可运行：
 
-```powershell
-node src/cli.js --profile uzooai-online auth login
-node src/cli.js --profile uzooai-online auth status
+```sh
+npx @uzooai/anime-ai-cli@latest install
 ```
 
-运行 `auth login` 后，在打开的网页登录页面完成正常登录并确认账号和设备。浏览器将一次性授权码交回本机 CLI，CLI 建立独立会话并加密保存凭据。旧扩展导入的网页凭据不会自动转成 CLI 凭据，需要重新授权。
+按提示选择一个或多个 Agent。已有同版本 CLI 的用户可以直接运行 `uzoo-anime install` 加装 Skill。
 
-可用 `--browser msedge` / `--browser chrome` 指定浏览器，默认使用系统浏览器；`--web-url` 接受网站根地址。默认等候 5 分钟，`--timeout MS` 可调整，Ctrl+C 取消。
+普通 npm 安装附带完整 Skill 文件，不会修改 Agent 的技能目录。用 `uzoo-anime skill path --format json` 找到目录后，将整个目录（含 `references`）复制到目标宿主。
 
-网页登录仍执行网站的短信、滑块与设备校验。网页与 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
+```sh
+uzoo-anime service status
+uzoo-anime auth login
+uzoo-anime auth status
 ```
 
-请求文件用 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 正式站接入更新
+默认服务是 [Uzoo](https://uzooai.com)。浏览器登录和 CLI 授权由用户本人完成；不要把密码、验证码或令牌粘贴到 Agent。可用 `--profile NAME` 区分本地配置，已有有效登录可继续使用。
 
-当前用户指定实际服务为https://uzooai.com，使用独立uzooai-online profile。用户启用授权后本人正常登录／授权及账号读回成功，历史2110/cli_auth_disabled阻塞已解除。正式站实际账号／团队与开发站不同，操作前重新查询并绑定实际对象，不迁移旧operation的服务地址。抠图已接入单次免费执行及已知原结果／缓存恢复，正式站真实处理和用户确认网页重开通过；未知响应无结果引用时仍无法服务端查回，不重发。免费处理不以余额0判不可用。
+- [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 不自动安装媒体工具。
 
-免费抠图可在原预览后用`image matting-start NAME --yes`独立后台缓存，`image matting-status NAME`离线查询；确认画布关闭后用原`matting-recover NAME --yes`回填。未知处理不重发；见[后台流程](.agents/skills/uzoo-anime-cli/references/image-tools-workflow.md#抠图独立后台执行与本地查询)。
+使用 CLI 写画布前，先确认对应网页标签已关闭且离开保存完成。付费任务在用户确认本次实际报价后提交。转绘旧命令仅用于有明确授权的原结果查询、下载或排障。
 
-异步抠图可在原预览后用`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、转绘或去字幕，不代表已授权发布。
+CLI 不会后台检查或自动安装新版。使用随包 Skill 的 Agent 会在会话首次使用时尝试查询 npm 稳定版，有新版才提示，由你决定是否更新；查询失败不影响原任务。手动升级 CLI 后，也请同步手动接入的 Skill。见 [Agent 接入与版本更新](docs/Agent接入与版本更新.md)。
 
-维护者发布准备：`npm run check:release`只做本地公开包策略／构建检查，不会登录、修改npm权限或上传包。当前版本0.5.0／latest，实际发布须完成npm账户／scope／2FA核验并取得当次明确授权。
+[更新记录](CHANGELOG.md) · [MIT 许可证](LICENSE)

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzooai/anime-ai-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": false,
   "type": "module",
   "engines": {
@@ -14,8 +14,8 @@
     "pack:local": "node scripts/pack-local.mjs",
     "prepack": "npm run build",
     "start": "node src/cli.js",
-    "check": "node --check src/cli.js && node --check src/api.js && node --check src/canvas.js && node --check src/draft-finalize.js && node --check src/media-copy.js && node --check src/group-edit.js && node --check src/group-layout.js && node --check src/node-copy.js && node --check src/node-delete.js && node --check src/materials.js && node --check src/material-save.js && node --check src/service.js && node --check src/video-clip.js && node --check src/media.js && node --check src/image-media.js && node --check src/image-output.js && node --check src/image-crop.js && node --check src/image-annotation.js && node --check src/image-matting.js && node --check src/matting.js && node --check src/png-alpha.js && node --check src/annotation-media.js && node --check src/video-frame.js && node --check src/graph.js && node --check src/graph-disconnect.js && node --check src/group-membership.js && node --check src/model-options.js && node --check src/generation-input.js && node --check src/review.js && node --check src/resource.js && node --check src/generation-graph.js && node --check src/repaint.js && node --check src/repaint-reverse.js && node --check src/repaint-delivery.js && node --check src/repaint-video.js && node --check src/repaint-history.js && node --check src/multipart.js && node --check src/repaint-materials.js && node --check src/repaint-settings.js && node --check src/remake.js && node --check src/repaint-graph.js && node --check src/store.js && node --check src/workflows.js && node --check src/agreement.js && node --check src/agreement-page.js && node --check src/protocol.js && node --check src/cli-authorization.js && node --check src/browser-login.js && node --check src/normal-login.js && node --check extensions/uzoo-cli-login/popup.js && node --check src/local-output.js && node --check src/repaint-archive.js && node --check src/repaint-export.js && node --check src/repaint-sequence.js && node --check src/node-history.js && node --check src/history-add.js && node --check src/material-download.js && node --check src/download-name.js && node --check scripts/pack-local.mjs && node --check src/package-info.js && node --check src/matting-background.js && node --check src/matting-worker.js && node --check src/matting-jobs.js && node --check scripts/release-policy.mjs && node --check scripts/check-release.mjs",
-    "test": "node test/smoke.mjs && node test/atomic-file.mjs && node test/phase1.mjs && node test/agreement.mjs && node test/canvas.mjs && node test/material-graph.mjs && node test/graph-rename.mjs && node test/graph-ungroup.mjs && node test/graph-disconnect.mjs && node test/node-copy.mjs && node test/node-copy-batch.mjs && node test/draft-finalize.mjs && node test/media-copy.mjs && node test/group-edit.mjs && node test/node-delete.mjs && node test/material-save.mjs && node test/service.mjs && node test/video-clip.mjs && node test/video-frame.mjs && node test/image-crop.mjs && node test/image-annotation.mjs && node test/image-matting.mjs && node test/matting.mjs && node test/matting-background.mjs && node test/matting-jobs.mjs && node test/model-options.mjs && node test/generation-input.mjs && node test/review.mjs && node test/repaint.mjs && node test/repaint-reverse.mjs && node test/repaint-delivery.mjs && node test/repaint-video.mjs && node test/repaint-settings.mjs && node test/repaint-materials.mjs && node test/remake.mjs && node test/normal-login.mjs && node test/login-extension.mjs && node test/browser-login.mjs && node test/cli-authorization.mjs && node test/store-recovery.mjs && node test/store-concurrency.mjs && node test/repaint-archive.mjs && node test/node-history.mjs && node test/file-transfer.mjs && node test/material-download.mjs && node test/release-policy.mjs",
+    "check": "node --check src/cli.js && node --check src/install.js && node --check src/api.js && node --check src/canvas.js && node --check src/draft-finalize.js && node --check src/media-copy.js && node --check src/group-edit.js && node --check src/group-layout.js && node --check src/node-copy.js && node --check src/node-delete.js && node --check src/materials.js && node --check src/material-save.js && node --check src/service.js && node --check src/video-clip.js && node --check src/media.js && node --check src/image-media.js && node --check src/image-output.js && node --check src/image-crop.js && node --check src/image-annotation.js && node --check src/image-matting.js && node --check src/matting.js && node --check src/png-alpha.js && node --check src/annotation-media.js && node --check src/video-frame.js && node --check src/graph.js && node --check src/graph-disconnect.js && node --check src/group-membership.js && node --check src/model-options.js && node --check src/generation-input.js && node --check src/review.js && node --check src/resource.js && node --check src/generation-graph.js && node --check src/repaint.js && node --check src/repaint-reverse.js && node --check src/repaint-delivery.js && node --check src/repaint-video.js && node --check src/repaint-history.js && node --check src/multipart.js && node --check src/repaint-materials.js && node --check src/repaint-settings.js && node --check src/remake.js && node --check src/repaint-graph.js && node --check src/store.js && node --check src/workflows.js && node --check src/agreement.js && node --check src/agreement-page.js && node --check src/protocol.js && node --check src/cli-authorization.js && node --check src/browser-login.js && node --check src/normal-login.js && node --check extensions/uzoo-cli-login/popup.js && node --check src/local-output.js && node --check src/repaint-archive.js && node --check src/repaint-export.js && node --check src/repaint-sequence.js && node --check src/node-history.js && node --check src/history-add.js && node --check src/material-download.js && node --check src/download-name.js && node --check scripts/pack-local.mjs && node --check src/package-info.js && node --check src/matting-background.js && node --check src/matting-worker.js && node --check src/matting-jobs.js && node --check scripts/release-policy.mjs && node --check scripts/check-release.mjs",
+    "test": "node test/smoke.mjs && node test/install.mjs && node test/atomic-file.mjs && node test/phase1.mjs && node test/agreement.mjs && node test/canvas.mjs && node test/material-graph.mjs && node test/graph-rename.mjs && node test/graph-ungroup.mjs && node test/graph-disconnect.mjs && node test/node-copy.mjs && node test/node-copy-batch.mjs && node test/draft-finalize.mjs && node test/media-copy.mjs && node test/group-edit.mjs && node test/node-delete.mjs && node test/material-save.mjs && node test/service.mjs && node test/video-clip.mjs && node test/video-frame.mjs && node test/image-crop.mjs && node test/image-annotation.mjs && node test/image-matting.mjs && node test/matting.mjs && node test/matting-background.mjs && node test/matting-jobs.mjs && node test/model-options.mjs && node test/generation-input.mjs && node test/review.mjs && node test/repaint.mjs && node test/repaint-reverse.mjs && node test/repaint-delivery.mjs && node test/repaint-video.mjs && node test/repaint-settings.mjs && node test/repaint-materials.mjs && node test/remake.mjs && node test/normal-login.mjs && node test/login-extension.mjs && node test/browser-login.mjs && node test/cli-authorization.mjs && node test/store-recovery.mjs && node test/store-concurrency.mjs && node test/repaint-archive.mjs && node test/node-history.mjs && node test/file-transfer.mjs && node test/material-download.mjs && node test/release-policy.mjs",
     "test:browser": "node test/normal-login.mjs && node test/login-extension.mjs && node test/browser-login.mjs",
     "test:media": "node test/media.mjs && node test/image-media.mjs && node test/annotation-media.mjs",
     "check:resources": "node scripts/check-package-resources.mjs",
@@ -25,19 +25,16 @@
   },
   "files": [
     "src/",
-    "assets/",
+    "assets/logo-uzoo.svg",
+    "assets/favicon-uzoo.png",
+    "!assets/README.md",
     ".agents/skills/uzoo-anime-cli/",
     "extensions/uzoo-cli-login/",
-    "examples/",
-    "docs/",
-    "!docs/阶段3B远程后端联调记录.md",
-    "scripts/check-package-resources.mjs",
-    "scripts/pack-local.mjs",
+    "examples/matting.json",
+    "docs/Agent接入与版本更新.md",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE",
-    "scripts/release-policy.mjs",
-    "scripts/check-release.mjs"
+    "LICENSE"
   ],
   "description": "Uzoo Anime CLI for canvas, media references and authorized generation workflows",
   "repository": {

package/src/cli.js

@@ -49,6 +49,7 @@ import { getRepaintSettings, startRepaintSettings, repaintSettingsOperation, rec
 const help = `Uzoo Anime CLI — 浏览器授权与独立 CLI 会话
 命令：
   --version | version [--format json]（本地版本，不读取登录态）
+  install [--agent NAME ...] [--yes | --dry-run]（可选：安装 CLI 和所选 Agent 的 Skill）
   skill path [--format json]（定位随包skill，不自动注册或覆盖）
   service status [--timeout MS]（先检查后端连接及数据库/Redis就绪）
   video clip --input clip.json --operation NAME [--yes]（视频剪辑，保留原视频）
@@ -180,6 +181,10 @@ function query(endpoint, fields) { const q = new URLSearchParams(Object.entries(
 
 let diagnosticClient
 async function main(args) {
+  if (args[0] === 'install') {
+    const { runInstall } = await import('./install.js')
+    await runInstall(args.slice(1), { signal: cancellation.signal }); return
+  }
   if(args[0]==='--version'||args[0]==='-v'){
     if(args.length!==1)throw new Error('--version仅用于查看本地版本，不能与业务参数混用')
     console.log(packageInfo.version);return

package/src/group-membership.js

@@ -123,4 +123,3 @@ export function syncGroupMemberships(state) {
 
   return changed
 }
-