commit f831bab4862a10aaaf4c6b0f89f0b544b747c055
Author: Codex <codex@users.noreply.local>
Date:   Mon Nov 9 12:10:05 2026 +0800

    Initial import of Huobao multi-GPU customizations

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..df66861
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,9 @@
+* text=auto
+*.sh text eol=lf
+*.py text eol=lf
+*.ts text eol=lf
+*.vue text eol=lf
+*.md text eol=lf
+*.json text eol=lf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..6aacc3a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,92 @@
+# Only source code, maintenance scripts and documentation belong in this repo.
+/*
+!/.gitignore
+!/.gitattributes
+!/README.md
+!/一键启动火宝.cmd
+!/升级与高清制作说明.txt
+!/huobao-source/
+!/model-bridge/
+!/integration-work/
+
+# Preserve the upstream checkout locally; never embed it as a Git submodule.
+huobao-source/.git/
+
+# Bridge source and reusable style presets; local credentials/reports stay local.
+/model-bridge/*
+!/model-bridge/.gitignore
+!/model-bridge/*.py
+!/model-bridge/*.ps1
+!/model-bridge/*.cjs
+!/model-bridge/*.cmd
+!/model-bridge/*.example.json
+!/model-bridge/接入说明.txt
+!/model-bridge/style-live-action.json
+!/model-bridge/style-xianxia.json
+
+# Keep maintenance source, not staged applications, fixtures, logs or audit data.
+/integration-work/*
+!/integration-work/*.py
+!/integration-work/*.ps1
+!/integration-work/*.cjs
+!/integration-work/browser-test/
+/integration-work/browser-test/*
+!/integration-work/browser-test/*.cjs
+/integration-work/inspect_shot05_*.py
+/integration-work/transcribe_shot05.py
+
+# Dependencies and generated application bundles.
+node_modules/
+__pycache__/
+*.py[cod]
+.nuxt/
+.output/
+dist/
+build/
+release/
+coverage/
+*.asar
+*.exe
+*.msi
+*.zip
+*.7z
+
+# Never version video output (including uppercase extensions).
+*.[mM][pP]4
+*.[mM][kK][vV]
+*.[mM][oO][vV]
+*.[aA][vV][iI]
+*.[wW][eE][bB][mM]
+*.[mM]4[vV]
+*.[mM][pP][eE][gG]
+*.[mM][pP][gG]
+*.[mM]2[tT][sS]
+*.[mM][tT][sS]
+*.[fF][lL][vV]
+*.[wW][mM][vV]
+*.3[gG][pP]
+*.[oO][gG][vV]
+
+# Runtime databases, secrets and local configuration.
+*.db
+*.db-*
+*.sqlite
+*.sqlite-*
+*.sqlite3
+*.sqlite3-*
+*.log
+*.bak
+*.pem
+*.key
+*.p12
+*.pfx
+.env
+.env.*
+!.env.example
+!.env.sample
+client.json
+grok-client.json
+config.local.json
+secrets.json
+Thumbs.db
+.DS_Store
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..786358e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# 火宝短剧 · 本地多显卡版
+
+基于 [chatfire-AI/huobao-drama](https://github.com/chatfire-AI/huobao-drama) 4.0.11 的本地定制代码。上游源码基线为 `b48e6b2312166e25b1ff141832d2e82e5d63c142`，原项目说明和许可证保留在 `huobao-source/`。
+
+## 已集成功能
+
+- 模型桥接与多显卡图片、视频调度；可按单个分镜选择显卡重新生成。
+- 显示实际执行节点：GPU1 / ComfyUI 8189、GPU2 / ComfyUI 8188、GPU3 / ComfyUI 8191。
+- MiniMax H3 视频及 VDN-H3 2K/4K 高清版本，保留原版供对比。
+- 角色、场景、道具的图片参考图上传与编辑接口。
+- 本地长任务持续查询、重启后恢复查询和原任务结果恢复。
+- 固定数据目录、一键启动、升级备份与真人实拍、仙侠风格预设。
+
+## 目录
+
+| 目录或文件 | 用途 |
+| --- | --- |
+| `huobao-source/` | 前端、后端、Electron 桌面端源码及上游文档 |
+| `model-bridge/` | 模型桥接、启动、打包、升级、数据检查和测试脚本 |
+| `integration-work/*.py`、`*.ps1`、`*.cjs` | 服务器适配、部署、迁移及验证脚本；部分为历史维护步骤，运行前阅读脚本 |
+| `integration-work/browser-test/` | 浏览器界面验证脚本 |
+| `一键启动火宝.cmd` | 当前 Windows 工作站的启动入口 |
+| `升级与高清制作说明.txt` | 本地升级和高清制作说明 |
+
+## 本地数据与配置
+
+此仓库保存代码，**不包含项目数据库、模型密钥、生成素材、视频、安装包和备份**。现有机器上的这些文件不会因为加入 `.gitignore` 而被删除。
+
+- `huobao-data/`：项目、模型配置、素材和生成记录，必须单独备份。
+- `HuobaoDrama/`：安装后的桌面应用，不随代码上传。
+- `model-bridge/client.json`、`grok-client.json`：本机连接配置和令牌，不上传。
+- `integration-work/backups/`、`previous-app-*/`、`stage-4.0.11/`：升级备份及打包产物，不上传。
+- 所有常见视频扩展名均已加入忽略规则；TypeScript 的 `.ts` 源码正常跟踪。
+
+在新机器上仅克隆代码不会恢复原项目和模型配置，需要另外恢复数据备份并配置私有接口。维护脚本含当前工作站路径和内网节点约定，迁移前需按部署环境检查。
+
+## 开发与构建
+
+按 `huobao-source/README.md` 和各目录的 `package.json` 安装对应依赖并构建。当前本地升级流程还使用 `model-bridge/build_upgrade.py` 与 `switch_upgrade.ps1`，需要准备已验证的 4.0.11 桌面运行包；安装包与暂存包不存入 Git。
+
+`一键启动火宝.cmd` 面向已经安装、已有数据的工作站，不是全新安装程序。升级前先保存编辑并完成数据库、素材和配置备份。
+
+## Git 同步
+
+```powershell
+git pull --ff-only origin main
+git status
+git add <需要提交的代码路径>
+git commit -m "说明本次修改"
+git push origin main
+```
+
+拉取代码不会自动替换正在运行的桌面程序。构建和升级需单独执行。当前工作站 `huobao-source/.git` 中的上游历史保留在本地，不作为子模块提交；新克隆会直接得到完整源码。
diff --git a/huobao-source/.dockerignore b/huobao-source/.dockerignore
new file mode 100644
index 0000000..e6753a5
--- /dev/null
+++ b/huobao-source/.dockerignore
@@ -0,0 +1,23 @@
+# 版本控制与产物
+.git
+**/node_modules
+**/.nuxt
+**/.output
+frontend/dist
+backend/dist
+desktop/build
+desktop/dist
+desktop/release
+release
+
+# 运行时数据（绝不能进镜像：SQLite + 生成的媒体文件）
+data
+
+# 本地环境
+.env
+*.log
+.DS_Store
+
+# 桌面发布与密钥配置不参与服务端镜像构建
+desktop
+**/.env*
diff --git a/huobao-source/.env.example b/huobao-source/.env.example
new file mode 100644
index 0000000..24d90bc
--- /dev/null
+++ b/huobao-source/.env.example
@@ -0,0 +1,6 @@
+# Docker 部署环境变量（复制为 .env 后修改）
+# Watchtower HTTP API 令牌，app 与 watchtower 两侧必须一致；生产环境务必修改
+WATCHTOWER_TOKEN=please-change-me
+
+# 构建镜像时注入的版本号（发布时指定，如 1.2.0；本地构建保持 dev 即可）
+HUOBAO_VERSION=dev
diff --git a/huobao-source/.gitignore b/huobao-source/.gitignore
new file mode 100644
index 0000000..30c4a72
--- /dev/null
+++ b/huobao-source/.gitignore
@@ -0,0 +1,60 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Environment
+.env
+.env.local
+
+# Logs
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Data (database and uploaded files)
+data/drama_generator.db
+data/drama_generator.db-wal
+data/drama_generator.db-shm
+data/huobao_drama.db
+data/huobao_drama.db-wal
+data/huobao_drama.db-shm
+data/*.sqlite3
+data/*.sqlite3-wal
+data/*.sqlite3-shm
+data/public.sql
+data/*.bak*
+data/static/
+data/storage/
+
+# Config
+configs/config.yaml
+
+# Misc
+tmp/
+temp/
+.superpowers/
+/CLAUDE.md
+/AGENTS.md
+
+# Agent workspace (skills/prompts 为策划模板保持跟踪，其余产出忽略)
+backend/workspace/*
+!backend/workspace/skills/
+!backend/workspace/prompts/
+
+# Desktop (Electron) build artifacts
+desktop/node_modules/
+desktop/build/
+desktop/dist/
+desktop/release/
+desktop/resources/
diff --git a/huobao-source/Dockerfile b/huobao-source/Dockerfile
new file mode 100644
index 0000000..9a72b4f
--- /dev/null
+++ b/huobao-source/Dockerfile
@@ -0,0 +1,61 @@
+# syntax=docker/dockerfile:1
+
+# ===== 前端构建：Nuxt generate 产出静态站点 =====
+FROM node:22-bookworm-slim AS frontend-build
+WORKDIR /build/frontend
+COPY frontend/package.json frontend/package-lock.json ./
+# lockfile 的 resolved 可能指向带鉴权的私有 registry（开发者本机 .npmrc），镜像内会 401。
+# 构建期删除 resolved 字段（integrity 校验不受影响），让 npm 统一走公共 registry
+RUN node -e "const fs=require('fs');const l=JSON.parse(fs.readFileSync('package-lock.json'));for(const p of Object.values(l.packages||{}))delete p.resolved;fs.writeFileSync('package-lock.json',JSON.stringify(l,null,2))" \
+  && npm ci --no-audit --no-fund --registry=https://registry.npmjs.org
+COPY frontend/ ./
+RUN npm run generate
+
+# ===== 后端构建：安装依赖（含原生模块编译） =====
+FROM node:22-bookworm AS backend-build
+WORKDIR /build/backend
+COPY backend/package.json backend/package-lock.json ./
+RUN node -e "const fs=require('fs');const l=JSON.parse(fs.readFileSync('package-lock.json'));for(const p of Object.values(l.packages||{}))delete p.resolved;fs.writeFileSync('package-lock.json',JSON.stringify(l,null,2))" \
+  && npm ci --no-audit --no-fund --registry=https://registry.npmjs.org
+COPY backend/ ./
+# 运行时与既有服务器部署一致走 tsx（源码存在 bundler 风格无扩展名 import，tsc 产物 node 直跑不可行）；
+# tsx 是 devDependency，prune 后单独补装
+RUN npm prune --omit=dev && npm i tsx@^4.21.0 --no-save --no-audit --no-fund --registry=https://registry.npmjs.org
+
+# ===== 运行时 =====
+FROM node:22-bookworm-slim
+ARG HUOBAO_VERSION=dev
+ENV NODE_ENV=production \
+    HUOBAO_VERSION=${HUOBAO_VERSION} \
+    PORT=5679 \
+    FFMPEG_BIN=/usr/bin/ffmpeg \
+    FFPROBE_BIN=/usr/bin/ffprobe \
+    HUOBAO_DATA_DIR=/app/data \
+    SQLITE_PATH=/app/data/huobao.sqlite3 \
+    WORKSPACE_PATH=/app/data/workspace \
+    FRONTEND_DIST=/app/frontend-dist
+
+# ffprobe-static 不包含 Linux ARM64 二进制；两个架构统一使用系统媒体工具。
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends ffmpeg \
+  && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+COPY --from=backend-build /build/backend/src ./backend/src
+COPY --from=backend-build /build/backend/node_modules ./backend/node_modules
+COPY --from=backend-build /build/backend/package.json ./backend/package.json
+COPY --from=backend-build /build/backend/tsconfig.json ./backend/tsconfig.json
+# workspace 模板（skills/prompts），entrypoint copy-once 到数据卷后可在线编辑
+COPY backend/workspace ./workspace-template
+COPY --from=frontend-build /build/frontend/.output/public ./frontend-dist
+COPY docker/entrypoint.sh ./entrypoint.sh
+RUN chmod +x ./entrypoint.sh && mkdir -p /app/data
+
+# 数据卷：SQLite + 生成的静态文件 + 可编辑 workspace
+VOLUME ["/app/data"]
+EXPOSE 5679
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=15s \
+  CMD node -e "fetch('http://localhost:'+(process.env.PORT||5679)+'/api/v1/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
+
+ENTRYPOINT ["./entrypoint.sh"]
diff --git a/huobao-source/LICENSE b/huobao-source/LICENSE
new file mode 100644
index 0000000..7cdbe0b
--- /dev/null
+++ b/huobao-source/LICENSE
@@ -0,0 +1,438 @@
+Attribution-NonCommercial-ShareAlike 4.0 International
+
+=======================================================================
+
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
+
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+    wiki.creativecommons.org/Considerations_for_licensors
+
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More considerations
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
+
+=======================================================================
+
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution-NonCommercial-ShareAlike 4.0 International Public License
+("Public License"). To the extent this Public License may be
+interpreted as a contract, You are granted the Licensed Rights in
+consideration of Your acceptance of these terms and conditions, and the
+Licensor grants You such rights in consideration of benefits the
+Licensor receives from making the Licensed Material available under
+these terms and conditions.
+
+
+Section 1 -- Definitions.
+
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. BY-NC-SA Compatible License means a license listed at
+     creativecommons.org/compatiblelicenses, approved by Creative
+     Commons as essentially the equivalent of this Public License.
+
+  d. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  e. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  f. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  g. License Elements means the license attributes listed in the name
+     of a Creative Commons Public License. The License Elements of this
+     Public License are Attribution, NonCommercial, and ShareAlike.
+
+  h. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  i. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  j. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  k. NonCommercial means not primarily intended for or directed towards
+     commercial advantage or monetary compensation. For purposes of
+     this Public License, the exchange of the Licensed Material for
+     other material subject to Copyright and Similar Rights by digital
+     file-sharing or similar means is NonCommercial provided there is
+     no payment of monetary compensation in connection with the
+     exchange.
+
+  l. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  m. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  n. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part, for NonCommercial purposes only; and
+
+            b. produce, reproduce, and Share Adapted Material for
+               NonCommercial purposes only.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. Additional offer from the Licensor -- Adapted Material.
+               Every recipient of Adapted Material from You
+               automatically receives an offer from the Licensor to
+               exercise the Licensed Rights in the Adapted Material
+               under the conditions of the Adapter's License You apply.
+
+            c. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties, including when
+          the Licensed Material is used other than for NonCommercial
+          purposes.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+  b. ShareAlike.
+
+     In addition to the conditions in Section 3(a), if You Share
+     Adapted Material You produce, the following conditions also apply.
+
+       1. The Adapter's License You apply must be a Creative Commons
+          license with the same License Elements, this version or
+          later, or a BY-NC-SA Compatible License.
+
+       2. You must include the text of, or the URI or hyperlink to, the
+          Adapter's License You apply. You may satisfy this condition
+          in any reasonable manner based on the medium, means, and
+          context in which You Share Adapted Material.
+
+       3. You may not offer or impose any additional or different terms
+          or conditions on, or apply any Effective Technological
+          Measures to, Adapted Material that restrict exercise of the
+          rights granted under the Adapter's License You apply.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database for NonCommercial purposes
+     only;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material,
+     including for purposes of Section 3(b); and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.
+
diff --git a/huobao-source/README.en.md b/huobao-source/README.en.md
new file mode 100644
index 0000000..e2da374
--- /dev/null
+++ b/huobao-source/README.en.md
@@ -0,0 +1,643 @@
+# 🎬 Huobao Drama - AI Short Drama Generation Platform
+
+<div align="center">
+
+**A full-stack TypeScript platform for automated AI short-drama production**
+
+[![Node Version](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org)
+[![Vue Version](https://img.shields.io/badge/Vue-3.x-4FC08D?style=flat&logo=vue.js)](https://vuejs.org)
+[![License](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+[![Download](https://img.shields.io/github/v/release/chatfire-AI/huobao-drama?style=flat&logo=github&label=Download)](https://github.com/chatfire-AI/huobao-drama/releases/latest)
+
+[中英双语](README.md) | **English** | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
+
+[Features](#-features) • [Quick Start](#-quick-start) • [Walkthrough](#-visual-walkthrough) • [Desktop App](#-desktop-app-recommended) • [Deployment](#-deployment)
+
+<h2>🔑 <a href="https://api.firemux.com">Get a Huobao API Key 👉 Get started</a></h2>
+
+**Text, image, and video AI capabilities — one key unlocks everything**
+
+After deploying, paste the key in "Settings → Huobao Quick Setup" to write three recommended configs in one click
+
+<h3>📥 <a href="https://github.com/chatfire-AI/huobao-drama/releases/latest">Download Desktop App (macOS / Windows)</a></h3>
+<h3>🌐 <a href="https://www.firemux.cn">Official Website</a></h3>
+
+</div>
+
+---
+
+## 📖 Overview
+
+Huobao Drama is an AI-powered short-drama production platform that automates the entire pipeline: script generation, character design, storyboard breakdown, and video compositing.
+
+### 🎯 Core Value
+
+- **🤖 AI-Driven**: LLMs parse scripts and extract characters, scenes, and storyboard information
+- **🎨 Intelligent Creation**: AI image generation for character designs and scene backgrounds
+- **📹 Video Generation**: Text-to-video and image-to-video models automatically produce storyboard clips
+- **🔄 End-to-End Workflow**: A complete pipeline from idea to finished episode
+
+### 🛠️ Architecture
+
+```
+frontend/   — Nuxt 3 + Vue 3 + TypeScript (pure CSS, no UI framework)
+backend/    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
+backend/workspace/skills/ — Agent skill definitions (SKILL.md, editable in the UI)
+desktop/    — Electron desktop app (main process + esbuild + electron-builder dmg/exe)
+data/       — Generated assets and the SQLite database
+```
+
+---
+
+## ✨ Features
+
+### 🎭 Character Management
+
+- ✅ AI-generated character designs
+- ✅ Batch character generation
+- ✅ Character image upload and management
+
+### 🎬 Video Tasks
+
+- ✅ Automatic AI video-task generation
+- ✅ Scene descriptions and video prompt generation
+- ✅ Batch video generation per task
+
+### 🎥 Video Generation
+
+- ✅ Text-to-video generation
+- ✅ FFmpeg per-shot compositing and subtitle handling
+- ✅ Full-episode stitching and export
+
+### 📦 Asset Management
+
+- ✅ Unified asset library
+- ✅ Local storage support
+- ✅ Task progress tracking
+
+### 🤖 AI Agents
+
+Four built-in Mastra agents with database-backed configuration and Skill extensions:
+
+| Agent | Role |
+|---|---|
+| `script_rewriter` | Novel → formatted script rewriting |
+| `extractor` | Intelligent extraction and dedup of characters / scenes / props |
+| `storyboard_breaker` | Script → storyboard sequence breakdown |
+| `prompt_generator` | Image prompts for characters/scenes/props + storyboard video prompts |
+
+### 🌐 Multi-Language UI
+
+The interface ships in **中文 / English / 日本語 / 한국어**, with a global setting for AI-generated content language.
+
+### 🔌 Multi-Provider Support
+
+| Type | Providers |
+|---|---|
+| **Text** | OpenAI (compatible APIs), Gemini |
+| **Image** | OpenAI, Gemini, Volcano Engine |
+| **Video** | Volcano Engine Seedance 2.0 (Standard / Fast / Mini), MiniMax H3, Alibaba Bailian Wan 3.0 (Prime / Standard) |
+
+---
+
+## 🚀 Quick Start
+
+### 📋 Requirements
+
+| Software | Version | Notes |
+|---|---|---|
+| **Node.js** | 20+ | Runtime for frontend and backend |
+| **npm** | 9+ | Package manager |
+
+> **Zero-install database**: Bundled SQLite (single file in the project data directory) — no database server required.
+> **No FFmpeg install needed**: Binaries ship via the `ffmpeg-static` / `ffprobe-static` npm packages — works out of the box.
+
+### ⚙️ Environment Variables
+
+No config files — everything is set via environment variables (all have defaults; local dev needs zero configuration):
+
+| Variable | Default | Description |
+|---|---|---|
+| `SQLITE_PATH` | `<repo>/data/huobao.sqlite3` | SQLite database file location |
+| `PORT` | `5679` | Backend service port |
+| `STORAGE_PATH` | `<repo>/data/static` | Generated-file storage directory |
+| `HUOBAO_DATA_DIR` | — | Injected by the Electron main process (userData data root) |
+| `WORKSPACE_PATH` | `backend/workspace` | Agent skills/prompts directory (desktop: writable copy under userData) |
+| `FRONTEND_DIST` | `frontend/dist` | Frontend static build directory |
+| `FFMPEG_BIN` / `FFPROBE_BIN` | bundled npm binaries | Custom ffmpeg/ffprobe executable paths |
+| `PUBLIC_BASE_URL` | — | Public URL Seedance needs to reference local assets (server deployments) |
+
+> **Note**: AI service API keys, base URLs, and model parameters are all configured in the web UI "Settings" page and stored in the database — never in config files or environment variables.
+
+### 📥 Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/chatfire-AI/huobao-drama.git
+cd huobao-drama
+
+# Install backend dependencies
+cd backend && npm install
+
+# Install frontend dependencies
+cd ../frontend && npm install
+```
+
+### 🎯 Running
+
+#### Option 1: Development mode (recommended)
+
+Frontend and backend run separately with hot reload:
+
+```bash
+# Terminal 1: backend
+cd backend
+npm run dev
+
+# Terminal 2: frontend
+cd frontend
+npm run dev
+```
+
+- Frontend: `http://localhost:3013`
+- Backend API: `http://localhost:5679/api/v1`
+- The frontend automatically proxies `/api` and `/static` to the backend
+
+#### Option 2: Single-service mode
+
+The backend serves both the API and the frontend static files:
+
+```bash
+# 1. Build the frontend
+cd frontend && npm run generate
+
+# 2. Copy the build output where the backend expects it
+#    (generate outputs to .output/public; the backend reads frontend/dist)
+cp -r .output/public dist
+
+# 3. Start the backend
+cd ../backend && npm start
+```
+
+Visit: `http://localhost:5679`
+
+### 🗄️ Database
+
+Bundled SQLite (`better-sqlite3` + WAL mode). Tables are created automatically on first launch (idempotent DDL replay + seed data). Default file: `data/huobao.sqlite3`, overridable via `SQLITE_PATH`. The desktop app stores data in the user-data directory (`~/Library/Application Support/HuobaoDrama/data/`).
+
+Migrating data from a legacy MySQL deployment:
+
+**Automatic migration on startup (recommended)**: When MySQL is explicitly configured (`DATABASE_URL` or `MYSQL_HOST`) and the SQLite database is empty, the backend automatically detects and imports all tables once (per-table row-count validation, single-transaction atomic writes, automatic rollback with retry on next launch, and a `.mysql-imported` marker to avoid re-importing). Set `MYSQL_AUTO_IMPORT=false` to disable.
+
+```bash
+# Or run manually (non-empty target requires --force; automatic backup before writing)
+cd backend && npx tsx scripts/import-mysql-to-sqlite.ts
+```
+
+> Migration covers database rows only; media files (images/videos) under the old deployment's `data/static/` must be copied manually, or historical assets won't load.
+
+### 🔑 First Use: Configure AI Services
+
+All AI features (text/image/video) require model services to be configured first — a banner at the top of the page guides you until then:
+
+1. Open the "Settings" page
+2. Paste your Huobao API key in "Huobao Quick Setup" ([get one at api.firemux.com](https://api.firemux.com)) to write three recommended configs (text, image, video) in one click
+3. Or add providers one by one via "Manual Templates", with connectivity testing
+
+Once configured, the banner disappears and you can start producing episodes.
+
+---
+
+## 📖 Visual Walkthrough
+
+The complete pipeline from novel to finished episode. The left progress rail always shows where you are.
+
+### Step 1 · Create a Project
+
+On the home page click "New Project", pick a **aspect ratio** (16:9 landscape / 9:16 portrait, fixed after creation) and a **visual style** (3D, realistic, … — injected into every image prompt).
+
+<p align="center">
+  <img src="docs/screenshots/02-create-drama.png" alt="Create a project" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/01-projects.png" alt="Project list" width="800">
+</p>
+
+### Step 2 · Configure AI Services (first run)
+
+Paste an API key in Settings → "Huobao Quick Setup" to write the three recommended configs at once, or add providers manually. The current model can be switched any time from the top bar (see Step 5).
+
+<p align="center">
+  <img src="docs/screenshots/03-settings-quick.png" alt="AI service setup" width="800">
+</p>
+
+### Step 3 · Script Stage
+
+Paste your **source novel** into the workbench, then hit "AI Rewrite" to produce a shooting script — split by episode with scenes and characters annotated. You can switch text models and tone while rewriting.
+
+<p align="center">
+  <img src="docs/screenshots/05-script.png" alt="Script stage" width="800">
+</p>
+
+### Step 4 · Assets
+
+Run **extraction** on the script to get the character / scene / prop list, then generate a consistent reference image for each (or in batch). These images are injected as reference material when generating videos.
+
+<p align="center">
+  <img src="docs/screenshots/06-assets.png" alt="Asset production" width="800">
+</p>
+
+### Step 5 · Storyboard & Videos
+
+On the "Video Production" page, first run **storyboard breakdown** (AI splits shots and writes video prompts). Then:
+
+- Pick the **video model** in the top bar (Seedance / Wan 3.0 / MiniMax…); resolution and duration tiers follow the model
+- Review and tweak each shot's prompt on the right (`@character` references map to reference images automatically)
+- Click "Batch Generate Videos"; failed tasks can be retried in one click
+
+<p align="center">
+  <img src="docs/screenshots/07-storyboard.png" alt="Storyboard breakdown" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/08-videos.png" alt="Video generation" width="800">
+</p>
+
+### Step 6 · Merge & Export
+
+Select shots (hover to preview each clip), click "Start Merging" and FFmpeg assembles the full episode — play online or download. Click "Mark Done" when finished to light up the progress rail.
+
+<p align="center">
+  <img src="docs/screenshots/09-export.png" alt="Merge & export" width="800">
+</p>
+
+The episode list shows the production status of every episode — click "Enter Studio" to continue:
+
+<p align="center">
+  <img src="docs/screenshots/04-episodes.png" alt="Episode list" width="800">
+</p>
+
+---
+
+## 📦 Deployment
+
+### 🖥️ Desktop App (recommended)
+
+**⬇️ Prebuilt installers: [GitHub Releases](https://github.com/chatfire-AI/huobao-drama/releases/latest) · [Mirror for China (Tencent COS)](https://installer.firemux.site/huobao-drama/v4.0.11/)**
+
+| Platform | File to download |
+|---|---|
+| macOS (Apple Silicon, M-series) | `HuobaoDrama-4.0.5-arm64.dmg` |
+| macOS (Intel) | `HuobaoDrama-4.0.5.dmg` |
+| Windows | `HuobaoDrama.Setup.4.0.5.exe` |
+
+> China users: use the COS mirror above (GitHub is slow/unreachable in mainland China). The in-app updater also checks the COS mirror first, then falls back to GitHub.
+
+**Command-line install (recommended, no Gatekeeper fix needed)**: downloading via curl never sets macOS's quarantine attribute, so the app opens cleanly with no "damaged" prompt (use the `-arm64.dmg` for Apple Silicon, the plain dmg for Intel):
+
+```bash
+curl -L -o /tmp/HuobaoDrama.dmg https://installer.firemux.site/huobao-drama/v4.0.11/HuobaoDrama-4.0.11-arm64.dmg \
+  && hdiutil attach -nobrowse /tmp/HuobaoDrama.dmg \
+  && cp -R /Volumes/HuobaoDrama*/HuobaoDrama.app /Applications/ \
+  && hdiutil detach /Volumes/HuobaoDrama*
+```
+
+No build required — download the dmg/exe and install. Installed clients auto-update via the built-in updater. (To package from source instead, see the commands below.)
+
+Double-click to install, works out of the box (macOS + Windows): the SQLite database, generated media, and Agent skills all live in the user-data directory — uninstalling the app does not affect your data.
+
+```bash
+# One-command packaging (frontend generate → backend esbuild → electron-builder)
+npm run dist        # macOS dmg (arm64 + Intel)
+npm run dist:win    # Windows NSIS installer (win-x64, cross-buildable on macOS)
+
+# Artifacts
+# desktop/release/HuobaoDrama-<version>-arm64.dmg     (Apple Silicon)
+# desktop/release/HuobaoDrama-<version>.dmg           (Intel)
+# desktop/release/HuobaoDrama Setup <version>.exe     (Windows)
+```
+
+Installation notes:
+
+- The macOS build is unsigned — on first launch you may see "App is damaged and can't be opened" (common on Apple Silicon). This is Gatekeeper's quarantine attribute, not actual file damage. Two ways to fix it:
+  1. **The dmg bundles a fix script**: after dragging the app into Applications, double-click the "如提示已损坏请双击我.command" script at the bottom of the dmg window — it removes the quarantine attribute automatically;
+  2. Or run `sudo xattr -cr /Applications/HuobaoDrama.app` in Terminal.
+
+  The fix is one-time only — the app then launches normally, and in-app auto-updates are not affected.
+- The Windows build is unsigned — SmartScreen will prompt "More info → Run anyway"
+- User-data directory: `~/Library/Application Support/HuobaoDrama/` (database, generated media, writable copies of online-edited skills)
+- FFmpeg/FFprobe binaries are bundled — no system install needed
+- Electron is pinned to 37.x: better-sqlite3's win32 prebuilds max out at that ABI (the key to compilation-free cross-packaging)
+- External links open in the system browser (e.g. "Get a key at api.firemux.com")
+
+#### 🔄 In-App Updates (no Apple signing required)
+
+The desktop app ships with a built-in updater (same class of solution as Tauri: directory replacement on macOS / silent installer on Windows, with local sha256 verification). To publish a new release:
+
+```bash
+# 1. Bump version in desktop/package.json, then package
+npm run dist        # macOS (produces dmg + update zip)
+npm run dist:win    # Windows (produces Setup.exe)
+
+# 2. Generate the release manifest release/latest.json (with per-platform sha256)
+cd desktop && npm run feed
+
+# 3. Publish: upload latest.json + installers + zips to a GitHub Release (tag like v1.0.1)
+```
+
+Installed clients check the manifest automatically after launch (manual check available in "Settings → About & Updates") and prompt to download and install when a new version is found. Override the manifest URL with the `HUOBAO_UPDATE_FEED` environment variable.
+
+Desktop development:
+
+```bash
+npm run build:frontend   # frontend static output (frontend/.output/public)
+cd desktop && npm run dev  # bundle the backend and run in an Electron window
+```
+
+> Known limitation: Seedance video models need a `PUBLIC_BASE_URL` public address to reference local assets; the desktop app has no public entry point, so that scenario produces a clear error message. Text-to-video, image generation, and all other capabilities are unaffected.
+
+---
+
+### 🏭 Server Deployment
+
+```bash
+# 1. Build the frontend
+cd frontend && npm run generate
+
+# 2. Copy the build output (generate outputs to frontend/.output/public; the backend reads
+#    frontend/dist — skip this step and the API works but pages 404)
+cp -r .output/public dist && cd ..
+
+# 3. Start the backend
+cd backend && npm start
+```
+
+Files to upload to the server:
+
+```
+backend/                    # backend source + node_modules
+backend/workspace/skills/   # Agent skill files
+frontend/dist/              # frontend build output
+data/                       # data directory (auto-created on first run)
+```
+
+#### Nginx Reverse Proxy
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # Max 50MB for reference video/audio uploads
+    client_max_body_size 100m;
+
+    # Generated images/videos served straight from disk, bypassing Node:
+    # sendfile zero-copy + long-lived caching
+    # (files are uuid-named and immutable, so immutable caching is safe)
+    location /static/ {
+        alias /path/to/huobao-drama/data/static/;
+        sendfile on;
+        tcp_nopush on;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
+    location / {
+        proxy_pass http://localhost:5679;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+}
+```
+
+> Media loading optimization: the backend automatically generates 400px thumbnails (`*_thumb.webp`) for list pages and extracts poster frames (`*_poster.jpg`) as video covers — the frontend only loads original files when opening the full image or playing. To backfill historical files, run `npm run backfill-artwork` under `backend/`.
+
+### 🐳 Docker Deployment (with in-app updates)
+
+**Option A — prebuilt image (no clone, no build):** multi-arch (`linux/amd64` + `linux/arm64`), x86 servers and ARM devices match automatically
+
+```bash
+docker pull huobao/huobao-drama:4.0.6
+
+docker run -d \
+  --name huobao-drama \
+  -p 5679:5679 \
+  -v huobao-data:/app/data \
+  --restart unless-stopped \
+  huobao/huobao-drama:4.0.6
+```
+
+**Option B — docker compose (source build + Watchtower in-app updates):** the repo root provides an all-in-one `Dockerfile` (three stages: frontend generate + backend dependencies + runtime; the backend runs via tsx just like server deployment) and `docker-compose.yml` (app + Watchtower):
+
+```bash
+# 1. Configure the environment (Watchtower token — must match on the app and watchtower sides)
+cp .env.example .env   # edit WATCHTOWER_TOKEN
+
+# 2. Build and start (inject a version at publish time for "About & Updates" comparison)
+HUOBAO_VERSION=4.0.5 docker compose up -d --build
+
+# 3. Visit http://localhost:5679
+```
+
+- **Data persistence**: the named volume `huobao-data` mounts `/app/data` (SQLite + generated images/videos + workspace/skills) — image updates don't lose data
+- **In-app updates**: the compose file ships a [Watchtower](https://containrrr.dev/watchtower/) sidecar (`--label-enable` only updates labeled containers, `--cleanup` removes old images, daily self-check). "Settings → About & Updates" can check for new versions and "Update Now" — the backend triggers it via the Watchtower HTTP API, which pulls the new image and rebuilds the container; refresh the page after a few minutes
+- **Manual mode**: remove the app's two `HUOBAO_WATCHTOWER_*` env vars (or the whole watchtower service) from `docker-compose.yml` — "About & Updates" then degrades to a new-version notice + manual `docker compose pull && docker compose up -d`
+- **Publishing images**: `docker buildx build --platform linux/amd64,linux/arm64 --build-arg HUOBAO_VERSION=x.y.z -t huobao/huobao-drama:x.y.z -t huobao/huobao-drama:latest --push .` — the version manifest is shared with the desktop app via `latest.json` on GitHub Releases (overridable with `HUOBAO_UPDATE_FEED`)
+
+---
+
+## 🎨 Tech Stack
+
+### Backend
+
+- **Runtime**: Node.js 20+
+- **Web framework**: Hono
+- **ORM**: Drizzle ORM + better-sqlite3 (WAL mode)
+- **AI Agents**: Mastra + AI SDK (OpenAI compatible)
+- **Video processing**: FFmpeg (fluent-ffmpeg + bundled binaries)
+- **Image processing**: Sharp
+
+### Desktop
+
+- **Shell**: Electron (utilityProcess hosts the backend; BrowserWindow loads same-origin)
+- **Packaging**: esbuild (single-file backend bundle) + electron-builder (dmg arm64/x64, NSIS win-x64)
+
+### Frontend
+
+- **Framework**: Nuxt 3 (SPA mode)
+- **Language**: Vue 3 + TypeScript
+- **Routing**: File-based routing (Vue Router 4)
+- **Styling**: Pure CSS + CSS Variables
+- **Icons**: Lucide Vue
+- **i18n**: vue-i18n (中文 / English / 日本語 / 한국어)
+
+---
+
+## 📝 FAQ
+
+### Q: Where does the desktop app store data?
+
+A: `~/Library/Application Support/HuobaoDrama/data/` (SQLite database + generated images/videos); writable copies of online-edited skills live in the sibling `workspace/` directory. In development mode the repo's `data/` directory is used instead.
+
+### Q: How do I migrate legacy MySQL data to SQLite?
+
+A: Keep MySQL reachable (environment variables or `backend/.env`), then run `cd backend && npx tsx scripts/import-mysql-to-sqlite.ts`. The script creates tables automatically, imports table-by-table, and validates row counts (non-empty targets require `--force`; a backup is made before writing).
+
+### Q: FFmpeg not installed or not found?
+
+A: No install needed. The project bundles `ffmpeg-static` / `ffprobe-static` binaries (carried along in the desktop package). A system `PATH` FFmpeg won't conflict either, and you can point explicitly via `FFMPEG_BIN`/`FFPROBE_BIN`.
+
+### Q: The top of the page says "No model configured"?
+
+A: That's the normal first-deploy guidance. Go to "Settings" and use "Huobao Quick Setup" to paste an API key and write configs in one click, or add providers via "Manual Templates". The banner disappears once text, image, and video all have an enabled config.
+
+### Q: The frontend can't reach the backend API?
+
+A: Check that the backend is running and the port is correct. In dev mode the proxy config lives in `frontend/nuxt.config.ts`.
+
+### Q: Database tables not created?
+
+A: The backend creates all tables automatically on first launch — check the logs to confirm initialization succeeded.
+
+---
+
+## 📋 Changelog
+
+### v4.0.0 (2026-08)
+
+#### 🖥️ Desktop App + Database Migration
+
+- Electron desktop app (macOS dmg, arm64/x64 dual architecture)
+  - Double-click install, works out of the box: automatic port selection, single-instance lock, crash-isolated backend subprocess
+  - User-data isolation: SQLite database / generated media / skill copies all live in the userData directory
+  - FFmpeg/FFprobe bundled; workspace skill templates copied on first launch, upgrades only fill gaps without overwriting
+- Database fully migrated from MySQL to SQLite (better-sqlite3 + WAL)
+  - Zero business-code changes (the Drizzle query layer is naturally portable); idempotent DDL replay
+  - New one-shot import script `import-mysql-to-sqlite.ts` (per-table row-count validation + automatic backup)
+- Backend bundled to a single file with esbuild (externals: sharp/better-sqlite3/ffmpeg binary packages)
+- Removed Docker/MySQL deployment (recoverable from git history)
+
+### v3.1.0 (2026-09)
+
+- Added Alibaba Bailian Wan 3.0 video models (Prime / Standard, official `input.media`/`parameters` payloads)
+- Resolution selector in the workbench top bar with native tiers per provider (Seedance 480p/720p, MiniMax 768P/2K, Wan 480P/720P/1080P)
+- Default video model changed to Seedance 2.0 Mini
+- Fixed generation errors caused by provider/model mismatch when switching video models
+- Batch video: selection mode + pre-generation confirmation (shot count / total duration / model / resolution), one-click retry for failed tasks
+- Storyboard duration now editable directly in the video-generation params area, applied to single and batch generation
+- Content-moderation failures (real-person / sensitive content) now prompt to switch models and retry
+
+### v3.0.0 (2026-08)
+
+#### 🚀 Deployment & Experience Improvements
+
+- Docker deployment readiness
+  - MySQL / app health checks; the app waits for the database before starting
+  - Database initialization retries — zero manual intervention on first containerized deploy
+  - Removed the system FFmpeg dependency; bundled binaries everywhere
+  - Agent skills directory volume persistence (online edits in Settings survive)
+  - New `docker/init.sql` and export scripts (DBA review / pre-created tables)
+- First-use guidance
+  - Site-wide banner guiding to Settings when no AI service is configured
+  - New "Huobao Quick Setup" in Settings: one key writes three recommended configs (text/image/video)
+  - Unconfigured-model errors localized with pointers to Settings
+- Default video model changed to Seedance 2.0 Fast
+- Provider consolidation: OpenAI / Gemini / Volcano Engine only
+- Workbench: task-list drawer, pipeline stage status, selective stitching (validates video files exist before merging)
+- Asset library redesign, @mention improvements, episode list rework
+
+### v2.0.0 (2026-04)
+
+#### 🚀 Major Update
+
+- Full migration to a TypeScript stack
+  - Backend: Hono + Drizzle ORM + mysql2
+  - Frontend: Nuxt 3 + Vue 3
+  - AI Agents: Mastra framework
+- Episode workbench UI and production flow rebuilt
+  - More compact console layout
+  - Storyboard editing area rebuilt
+  - Shot image, video, compositing, and export screens rebuilt
+- Docker deployment support — frontend and backend merged into a single image
+- Runtime Skill loading mechanism
+- Expanded multi-provider media adapters
+  - Image: OpenAI, Gemini, Volcano Engine, Alibaba
+  - Video: Volcano Engine/Seedance, Vidu, Alibaba
+- Improved local file handling and on-demand reference-image transcoding
+
+### v1.0.4 (2026-01-27)
+
+- Local storage strategy to avoid dead external asset links
+- Base64 reference-image embedded transport
+- Fixed shot-switch state reset
+- Scene migration to chapters
+
+### v1.0.3 (2026-01-16)
+
+- Database concurrency performance improvements
+- Docker cross-platform support for host.docker.internal
+
+### v1.0.2 (2026-01-14)
+
+- Fixed video-generation API response parsing
+- OpenAI Sora video endpoint configuration
+- Improved error handling and logging
+
+---
+
+## 📄 License
+
+This project is licensed under **[CC BY-NC-SA 4.0](LICENSE)** (Attribution-NonCommercial-ShareAlike 4.0 International).
+
+- ✅ Personal use, learning, and non-commercial projects are welcome
+- ✅ Modifications and redistribution allowed under the same license with attribution
+- ❌ **Commercial use is prohibited** — you may not use this project, in whole or in part, for any commercial purpose (including paid services, commercial deployments, or resale) without prior written permission from the author
+
+Full license text: see [LICENSE](LICENSE).
+
+---
+
+## 🤝 Contributing
+
+Issues and Pull Requests are welcome!
+
+1. Fork the project
+2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+Common checks:
+
+```bash
+cd backend && npm run typecheck
+cd ../frontend && npm run build
+```
+
+---
+
+## 💬 WeChat Group
+
+Scan the QR code to join the WeChat group:
+
+<div align="center">
+  <img src="docs/images/wx-group.png" width="200" alt="WeChat group QR code" />
+</div>
+
+---
+
+> _"Let AI do the creating with us"_
+
+## 🔗 Links
+
+This project has been recognized with a link from the [LINUX DO](https://linux.do/) community.
+
+- [LINUX DO](https://linux.do/) — a genuine open-source spirit, a community built on sharing
+
+---
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/chart?repos=chatfire-ai/huobao-drama&type=date&legend=top-left)](https://www.star-history.com/?repos=chatfire-ai%2Fhuobao-drama&type=date&legend=top-left)
diff --git a/huobao-source/README.ja.md b/huobao-source/README.ja.md
new file mode 100644
index 0000000..d140c9b
--- /dev/null
+++ b/huobao-source/README.ja.md
@@ -0,0 +1,640 @@
+# 🎬 Huobao Drama - AI ショートドラマ生成プラットフォーム
+
+<div align="center">
+
+**TypeScript フルスタックの AI ショートドラマ自動制作プラットフォーム**
+
+[![Node Version](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org)
+[![Vue Version](https://img.shields.io/badge/Vue-3.x-4FC08D?style=flat&logo=vue.js)](https://vuejs.org)
+[![License](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+[![ダウンロード](https://img.shields.io/github/v/release/chatfire-AI/huobao-drama?style=flat&logo=github&label=%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89)](https://github.com/chatfire-AI/huobao-drama/releases/latest)
+
+[中英双语](README.md) | [English](README.en.md) | [简体中文](README.zh-CN.md) | **日本語** | [한국어](README.ko.md)
+
+[機能](#-機能) • [クイックスタート](#-クイックスタート) • [チュートリアル](#-チュートリアル画像付き) • [デスクトップ版](#-デスクトップアプリ推奨) • [デプロイ](#-デプロイ)
+
+<h2>🔑 <a href="https://api.firemux.com">Huobao API Key を取得 👉 今すぐ見る</a></h2>
+
+**テキスト・画像・動画のすべての AI 機能を、1 つの Key で有効化**
+
+デプロイ後、「設定 → 火宝クイック設定」に Key を貼るだけで、3 つの推奨設定をワンクリックで書き込み
+
+<h3>📥 <a href="https://github.com/chatfire-AI/huobao-drama/releases/latest">デスクトップ版をダウンロード（macOS / Windows）</a></h3>
+<h3>🌐 <a href="https://www.firemux.cn">公式サイト</a></h3>
+
+</div>
+
+---
+
+## 📖 プロジェクト概要
+
+Huobao Drama は AI ベースのショートドラマ自動制作プラットフォームです。脚本生成、キャラクターデザイン、分镜制作から動画合成まで、全工程を自動化します。
+
+### 🎯 コアバリュー
+
+- **🤖 AI 駆動**：大規模言語モデルで脚本を解析し、キャラクター・シーン・分镜情報を抽出
+- **🎨 インテリジェント制作**：AI 画像生成でキャラクター形象とシーン背景を作成
+- **📹 動画生成**：テキスト→動画・画像→動画モデルで分镜動画を自動生成
+- **🔄 ワークフロー**：アイデアから完成作品までのショートドラマ制作をワンストップで完結
+
+### 🛠️ 技術アーキテクチャ
+
+```
+frontend/   — Nuxt 3 + Vue 3 + TypeScript (純粋 CSS、UI フレームワークなし)
+backend/    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
+backend/workspace/skills/ — Agent スキル定義 (SKILL.md、UI からオンライン編集可能)
+desktop/    — Electron デスクトップ版（メインプロセス + esbuild バンドル + electron-builder で dmg/exe）
+data/       — 生成アセットと SQLite データベース
+```
+
+---
+
+## ✨ 機能
+
+### 🎭 キャラクター管理
+
+- ✅ AI によるキャラクター形象生成
+- ✅ キャラクターの一括生成
+- ✅ キャラクター画像のアップロードと管理
+
+### 🎬 動画タスク
+
+- ✅ AI による動画タスクの自動生成
+- ✅ シーン説明と動画プロンプトの生成
+- ✅ タスク単位の一括動画生成
+
+### 🎥 動画生成
+
+- ✅ テキスト→動画の自動生成
+- ✅ FFmpeg によるショット単位の合成と字幕処理
+- ✅ エピソード全体の結合と書き出し
+
+### 📦 アセット管理
+
+- ✅ 素材ライブラリの一元管理
+- ✅ ローカルストレージ対応
+- ✅ タスク進捗トラッキング
+
+### 🤖 AI Agents
+
+4 つの Mastra Agent を内蔵。データベース設定と Skill 拡張に対応：
+
+| Agent | 役割 |
+|---|---|
+| `script_rewriter` | 小説 → フォーマット済み脚本へのリライト |
+| `extractor` | キャラクター / シーン / 小道具のインテリジェント抽出と重複排除 |
+| `storyboard_breaker` | 脚本 → 分镜シーケンスへの分解 |
+| `prompt_generator` | キャラクター/シーン/小道具の画像プロンプト + 分镜動画プロンプト生成 |
+
+### 🌐 多言語 UI
+
+インターフェースは **中文 / English / 日本語 / 한국어** を内蔵し、AI 生成コンテンツの言語をグローバルに設定できます。
+
+### 🔌 マルチプロバイダー対応
+
+| タイプ | 対応プロバイダー |
+|---|---|
+| **テキスト** | OpenAI（互換 API）、Gemini |
+| **画像** | OpenAI、Gemini、Volcano Engine |
+| **動画** | Volcano Engine Seedance 2.0（Standard / Fast / Mini）、MiniMax H3、Alibaba Bailian Wan 3.0（Prime / Standard） |
+
+---
+
+## 🚀 クイックスタート
+
+### 📋 動作環境
+
+| ソフトウェア | バージョン | 説明 |
+|---|---|---|
+| **Node.js** | 20+ | フロントエンド・バックエンド実行環境 |
+| **npm** | 9+ | パッケージマネージャー |
+
+> **データベース不要**：SQLite 内蔵（プロジェクトのデータディレクトリに単一ファイル）。データベースサーバーのインストールは不要です。
+> **FFmpeg 不要**：`ffmpeg-static` / `ffprobe-static` npm パッケージにバイナリを内蔵。すぐに使えます。
+
+### ⚙️ 環境変数
+
+設定ファイルは不要。環境変数で設定します（すべてデフォルト値あり、ローカル開発はゼロ設定で起動可能）：
+
+| 変数 | デフォルト値 | 説明 |
+|---|---|---|
+| `SQLITE_PATH` | `<リポジトリ>/data/huobao.sqlite3` | SQLite データベースファイルの場所 |
+| `PORT` | `5679` | バックエンドサービスのポート |
+| `STORAGE_PATH` | `<リポジトリ>/data/static` | 生成ファイルの保存ディレクトリ |
+| `HUOBAO_DATA_DIR` | — | デスクトップ版で Electron メインプロセスが注入（userData データルート） |
+| `WORKSPACE_PATH` | `backend/workspace` | Agent スキル/プロンプトディレクトリ（デスクトップ版は userData の書き込み可能なコピー） |
+| `FRONTEND_DIST` | `frontend/dist` | フロントエンド静的ビルドディレクトリ |
+| `FFMPEG_BIN` / `FFPROBE_BIN` | npm 内蔵バイナリ | カスタム ffmpeg/ffprobe の実行ファイルパス |
+| `PUBLIC_BASE_URL` | — | Seedance がローカル参照リソースを使う際に必要な公開 URL（サーバーデプロイ用） |
+
+> **説明**：AI サービスの API Key、Base URL、モデルパラメータはすべて Web UI の「設定」ページで設定してデータベースに保存します。設定ファイルや環境変数では管理しません。
+
+### 📥 インストール
+
+```bash
+# リポジトリをクローン
+git clone https://github.com/chatfire-AI/huobao-drama.git
+cd huobao-drama
+
+# バックエンドの依存をインストール
+cd backend && npm install
+
+# フロントエンドの依存をインストール
+cd ../frontend && npm install
+```
+
+### 🎯 起動
+
+#### 方法 1：開発モード（推奨）
+
+フロントエンドとバックエンドを分離し、ホットリロード対応：
+
+```bash
+# ターミナル 1：バックエンド
+cd backend
+npm run dev
+
+# ターミナル 2：フロントエンド
+cd frontend
+npm run dev
+```
+
+- フロントエンド：`http://localhost:3013`
+- バックエンド API：`http://localhost:5679/api/v1`
+- フロントエンドは `/api` と `/static` をバックエンドへ自動プロキシ
+
+#### 方法 2：シングルサービスモード
+
+バックエンドが API とフロントエンド静的ファイルの両方を提供：
+
+```bash
+# 1. フロントエンドをビルド
+cd frontend && npm run generate
+
+# 2. ビルド成果物をバックエンドが読むディレクトリへコピー
+#    （generate の出力は .output/public、バックエンドは frontend/dist を読む）
+cp -r .output/public dist
+
+# 3. バックエンドを起動
+cd ../backend && npm start
+```
+
+アクセス：`http://localhost:5679`
+
+### 🗄️ データベース
+
+SQLite 内蔵（`better-sqlite3` + WAL モード）。初回起動時にテーブルを自動作成（冪等な DDL リプレイ + シードデータ）。デフォルトのファイルは `data/huobao.sqlite3`、`SQLITE_PATH` で変更可能。デスクトップ版はユーザーデータディレクトリ（`~/Library/Application Support/HuobaoDrama/data/`）に保存します。
+
+旧 MySQL からのデータ移行：
+
+**起動時の自動移行（推奨）**：MySQL が明示的に設定されており（`DATABASE_URL` または `MYSQL_HOST`）、SQLite が空の場合、バックエンド起動時に自動検出して全テーブルを一度だけインポートします（テーブルごとの行数検証、単一トランザクションの原子書き込み、失敗時は自動ロールバックして次回起動時に再試行、成功後は `.mysql-imported` マーカーを書き込み重複を防止）。`MYSQL_AUTO_IMPORT=false` で無効化できます。
+
+```bash
+# 手動実行も可能（対象 DB が空でない場合は --force が必要、書き込み前に自動バックアップ）
+cd backend && npx tsx scripts/import-mysql-to-sqlite.ts
+```
+
+> 移行はデータベースの行のみをカバーします。旧デプロイの `data/static/` 配下の画像・動画などのメディアファイルは手動でコピーしてください。コピーしないと過去の素材にアクセスできません。
+
+### 🔑 初回利用：AI サービスの設定
+
+起動後、すべての AI 機能（テキスト/画像/動画）を使うには、先にモデルサービスの設定が必要です。未設定の場合、ページ上部にバナーで案内されます：
+
+1. 「設定」ページを開く
+2. 「火宝クイック設定」に Huobao API Key を貼る（[api.firemux.com で取得](https://api.firemux.com)）。テキスト・画像・動画の 3 つの推奨設定をワンクリックで書き込み
+3. または「手動テンプレート」でプロバイダーごとに追加。接続テストに対応
+
+設定が完了するとバナーは自動で消え、エピソード制作を開始できます。
+
+---
+
+## 📖 チュートリアル（画像付き）
+
+小説から完成エピソードまでの全工程。左の進捗バーが常に現在のステージを示します。
+
+### ステップ 1 · プロジェクト作成
+
+ホームで「新規プロジェクト」をクリックし、**アスペクト比**（16:9 横 / 9:16 縦、作成後は変更不可）と**作画スタイル**（3D / リアル系など、全生図プロンプトに注入）を選択します。
+
+<p align="center">
+  <img src="docs/screenshots/02-create-drama.png" alt="プロジェクト作成" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/01-projects.png" alt="プロジェクト一覧" width="800">
+</p>
+
+### ステップ 2 · AI サービス設定（初回）
+
+設定ページの「火宝クイック設定」に API キーを貼り付けると推奨 3 設定を一括書き込み。手動テンプレートでの追加も可能です。使用モデルは上部バーでいつでも切り替えられます（ステップ 5 参照）。
+
+<p align="center">
+  <img src="docs/screenshots/03-settings-quick.png" alt="AI サービス設定" width="800">
+</p>
+
+### ステップ 3 · 脚本ステージ
+
+制作画面に**原文（小説）**を貼り付け、「AI リライト」で撮影用脚本を生成 — エピソード単位の分割とシーン・キャラクターの注記付き。モデルやトーンの切り替えも可能です。
+
+<p align="center">
+  <img src="docs/screenshots/05-script.png" alt="脚本ステージ" width="800">
+</p>
+
+### ステップ 4 · アセット制作
+
+脚本に**抽出**を実行するとキャラクター / シーン / 小道具の一覧を自動取得。各項目の「イメージ生成」で一貫性のある参照画像を作成します（一括も可）。これらの画像は動画生成時に参照素材として注入されます。
+
+<p align="center">
+  <img src="docs/screenshots/06-assets.png" alt="アセット制作" width="800">
+</p>
+
+### ステップ 5 · 絵コンテと動画
+
+「動画制作」ページでまず**絵コンテ分割**を実行（AI がカット割りし動画プロンプトを生成）。その後：
+
+- 上部バーで**動画モデル**を選択（Seedance / Wan 3.0 / MiniMax など）。解像度と尺の選択肢はモデルに連動
+- 右側で各カットのプロンプトを確認・調整（`@キャラ名` 参照は自動で参照画像にマッピング）
+- 「一括動画生成」でタスク開始。失敗タスクはワンクリックでリトライ
+
+<p align="center">
+  <img src="docs/screenshots/07-storyboard.png" alt="絵コンテ分割" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/08-videos.png" alt="動画生成" width="800">
+</p>
+
+### ステップ 6 · 連結と書き出し
+
+カットを選択（ホバーで各クリップをプレビュー）し、「連結開始」をクリックすると FFmpeg が完全なエピソードを自動合成。オンライン再生・ダウンロード可能です。完了したら「完了にする」で進捗バーを点灯。
+
+<p align="center">
+  <img src="docs/screenshots/09-export.png" alt="連結と書き出し" width="800">
+</p>
+
+エピソード一覧では各話の制作状況を確認でき、「制作を開く」から再開できます：
+
+<p align="center">
+  <img src="docs/screenshots/04-episodes.png" alt="エピソード一覧" width="800">
+</p>
+
+---
+
+## 📦 デプロイ
+
+### 🖥️ デスクトップアプリ（推奨）
+
+**⬇️ ビルド済みインストーラー: [GitHub Releases](https://github.com/chatfire-AI/huobao-drama/releases/latest) · [中国向けミラー（Tencent COS）](https://installer.firemux.site/huobao-drama/v4.0.11/)**
+
+| プラットフォーム | ダウンロードファイル |
+|---|---|
+| macOS（Apple Silicon、M シリーズ） | `HuobaoDrama-4.0.5-arm64.dmg` |
+| macOS（Intel） | `HuobaoDrama-4.0.5.dmg` |
+| Windows | `HuobaoDrama.Setup.4.0.5.exe` |
+
+> 中国本土では GitHub が不安定なため、Tencent COS ミラーをご利用ください。アプリ内アップデーターも COS を優先し、GitHub にフォールバックします。
+
+**コマンドラインインストール（推奨・修復不要）**：curl でのダウンロードは macOS の隔離属性が付かないため、「壊れている」警告なしでそのまま起動できます（Apple Silicon は `-arm64.dmg`、Intel は無印の dmg）：
+
+```bash
+curl -L -o /tmp/HuobaoDrama.dmg https://installer.firemux.site/huobao-drama/v4.0.11/HuobaoDrama-4.0.11-arm64.dmg \
+  && hdiutil attach -nobrowse /tmp/HuobaoDrama.dmg \
+  && cp -R /Volumes/HuobaoDrama*/HuobaoDrama.app /Applications/ \
+  && hdiutil detach /Volumes/HuobaoDrama*
+```
+
+ビルド不要 —— dmg/exe をダウンロードしてそのままインストールできます。インストール済みクライアントは内蔵アップデーターで自動更新されます。（ソースから自分でパッケージングする場合は以下のコマンドを参照。）
+
+ダブルクリックでインストール、すぐに使えるデスクトップ版（macOS + Windows）。データベース（SQLite）、生成メディア、Agent スキルはすべてユーザーデータディレクトリに保存され、アプリをアンインストールしてもデータに影響しません。
+
+```bash
+# ワンコマンドパッケージ（フロントエンド generate → バックエンド esbuild → electron-builder）
+npm run dist        # macOS dmg（arm64 + Intel）
+npm run dist:win    # Windows NSIS インストーラー（win-x64、macOS 上でクロスビルド可能）
+
+# 成果物
+# desktop/release/HuobaoDrama-<バージョン>-arm64.dmg      (Apple Silicon)
+# desktop/release/HuobaoDrama-<バージョン>.dmg            (Intel)
+# desktop/release/HuobaoDrama Setup <バージョン>.exe      (Windows)
+```
+
+インストール時の注意：
+
+- macOS 未署名パッケージは初回起動時に「Appが壊れているため開けません」と表示される場合があります（Apple Silicon で多発）。これは Gatekeeper の隔離属性によるもので、ファイルは壊れていません。修復方法は 2 つあります：
+  1. **dmg に修復スクリプトを同梱**：アプリを「アプリケーション」にドラッグした後、dmg ウィンドウ下部の「如提示已损坏请双击我.command」をダブルクリックすれば自動で修復されます；
+  2. またはターミナルで `sudo xattr -cr /Applications/HuobaoDrama.app` を実行。
+
+  修復は初回の 1 回だけ。その後は普通に起動でき、アプリ内自動更新にも影響しません。
+- Windows 未署名パッケージは SmartScreen で「詳細情報 → 実行」を選択
+- ユーザーデータディレクトリ：`~/Library/Application Support/HuobaoDrama/`（データベース、生成メディア、オンライン編集したスキルのコピー）
+- FFmpeg/FFprobe バイナリ内蔵。システムへのインストール不要
+- Electron は 37.x に固定：better-sqlite3 の win32 プリビルドがこの ABI までしか対応していないため（クロスパッケージでコンパイル不要にする鍵）
+- アプリ内の外部リンク（「api.firemux.com で Key を取得」など）はシステムブラウザで直接開きます
+
+#### 🔄 アプリ内更新（Apple 署名不要）
+
+デスクトップ版には更新機能を内蔵（Tauri と同種の方式：macOS はディレクトリ置換 / Windows はサイレントインストール、ローカルで sha256 検証）。新バージョンのリリース手順：
+
+```bash
+# 1. desktop/package.json の version を変更してパッケージ
+npm run dist        # macOS（dmg + 更新用 zip を出力）
+npm run dist:win    # Windows（Setup.exe を出力）
+
+# 2. バージョンマニフェスト release/latest.json を生成（各プラットフォームの sha256 を含む）
+cd desktop && npm run feed
+
+# 3. 公開：latest.json + インストーラー + zip を GitHub Release にアップロード（タグは v1.0.1 形式）
+```
+
+インストール済みのクライアントは起動後にマニフェストを自動チェックし（「設定 → 关于更新」から手動チェックも可能）、新バージョンを検出するとダウンロードとインストールを促します。マニフェストの URL は `HUOBAO_UPDATE_FEED` 環境変数で変更可能です。
+
+デスクトップ版の開発デバッグ：
+
+```bash
+npm run build:frontend   # フロントエンド静的成果物（frontend/.output/public）
+cd desktop && npm run dev  # バックエンドをバンドルして Electron ウィンドウで実行
+```
+
+> 既知の制限：Seedance 動画モデルがローカル参照リソースを使うには `PUBLIC_BASE_URL` の公開アドレスが必要です。デスクトップ版には公開エントリがないため、このシナリオでは明確なエラーメッセージが表示されます。テキスト→動画・画像生成など他の機能には影響しません。
+
+---
+
+### 🏭 サーバーデプロイ
+
+```bash
+# 1. フロントエンドをビルド
+cd frontend && npm run generate
+
+# 2. ビルド成果物をコピー（generate の出力は frontend/.output/public、バックエンドは
+#    frontend/dist を読む。この手順を省くと API は動くがページが 404 になる）
+cp -r .output/public dist && cd ..
+
+# 3. バックエンドを起動
+cd backend && npm start
+```
+
+サーバーにアップロードするファイル：
+
+```
+backend/                    # バックエンドソース + node_modules
+backend/workspace/skills/   # Agent スキルファイル
+frontend/dist/              # フロントエンドビルド成果物
+data/                       # データディレクトリ（初回実行時に自動作成）
+```
+
+#### Nginx リバースプロキシ
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # 参照動画/音声アップロードは最大 50MB
+    client_max_body_size 100m;
+
+    # 生成画像/動画はディスクから直接配信（Node を経由しない）：
+    # sendfile ゼロコピー + 長期キャッシュ
+    # （ファイルは uuid 命名で内容不変のため immutable キャッシュが安全）
+    location /static/ {
+        alias /path/to/huobao-drama/data/static/;
+        sendfile on;
+        tcp_nopush on;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
+    location / {
+        proxy_pass http://localhost:5679;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+}
+```
+
+> メディア読み込みの最適化：画像生成時にバックエンドが 400px サムネイル（`*_thumb.webp`）を自動生成してリストページで使用し、動画はポスターフレーム（`*_poster.jpg`）をカバーとして抽出します。フロントエンドは画像を開く/再生する時だけ元ファイルを読み込みます。過去の既存ファイルは `backend/` で `npm run backfill-artwork` を実行して一括補完できます。
+
+### 🐳 Docker デプロイ（アプリ内更新付き）
+
+**方法 A — ビルド済みイメージ（クローン・ビルド不要）**：マルチアーキテクチャ（`linux/amd64` + `linux/arm64`）、x86 サーバーと ARM デバイスの両方に自動対応
+
+```bash
+docker pull huobao/huobao-drama:4.0.6
+
+docker run -d \
+  --name huobao-drama \
+  -p 5679:5679 \
+  -v huobao-data:/app/data \
+  --restart unless-stopped \
+  huobao/huobao-drama:4.0.6
+```
+
+**方法 B — docker compose（ソースビルド + Watchtower アプリ内更新）**：リポジトリルートにオールインワンの `Dockerfile`（フロントエンド generate + バックエンド依存/ランタイムの 3 ステージ。バックエンドはサーバーデプロイと同様に tsx で実行）と `docker-compose.yml`（アプリ + Watchtower）を用意：
+
+```bash
+# 1. 環境を設定（Watchtower トークン。app と watchtower の両側で一致必須）
+cp .env.example .env   # WATCHTOWER_TOKEN を変更
+
+# 2. ビルドして起動（リリース時にバージョンを注入し、「关于更新」での比較に使用）
+HUOBAO_VERSION=4.0.5 docker compose up -d --build
+
+# 3. http://localhost:5679 にアクセス
+```
+
+- **データ永続化**：名前付きボリューム `huobao-data` を `/app/data` にマウント（SQLite + 生成画像/動画 + workspace/skills）。イメージ更新でもデータを失いません
+- **アプリ内更新**：compose に [Watchtower](https://containrrr.dev/watchtower/) sidecar を同梱（`--label-enable` でラベル付きコンテナのみ更新、`--cleanup` で旧イメージ削除、毎日セルフチェック）。「設定 → 关于更新」で新バージョンの確認と「今すぐ更新」が可能。バックエンドが Watchtower HTTP API 経由でトリガーし、新イメージを pull してコンテナを再構築。数分後にページを更新すれば完了です
+- **手動モード**：`docker-compose.yml` から app の `HUOBAO_WATCHTOWER_*` の 2 つの環境変数（または watchtower サービス全体）を削除すると、「关于更新」は新バージョン通知 + 手動コマンド `docker compose pull && docker compose up -d` に退化します
+- **イメージの公開**：`docker buildx build --platform linux/amd64,linux/arm64 --build-arg HUOBAO_VERSION=x.y.z -t huobao/huobao-drama:x.y.z -t huobao/huobao-drama:latest --push .`。バージョンマニフェストはデスクトップ版と GitHub Releases の `latest.json` を共用（`HUOBAO_UPDATE_FEED` で上書き可能）
+
+---
+
+## 🎨 技術スタック
+
+### バックエンド
+
+- **ランタイム**：Node.js 20+
+- **Web フレームワーク**：Hono
+- **ORM**：Drizzle ORM + better-sqlite3（WAL モード）
+- **AI Agent**：Mastra + AI SDK（OpenAI 互換）
+- **動画処理**：FFmpeg（fluent-ffmpeg + 内蔵バイナリ）
+- **画像処理**：Sharp
+
+### デスクトップ
+
+- **シェル**：Electron（utilityProcess がバックエンドをホスト、BrowserWindow は同一オリジンで読み込み）
+- **パッケージ**：esbuild（バックエンド単一ファイルバンドル）+ electron-builder（dmg arm64/x64、NSIS win-x64）
+
+### フロントエンド
+
+- **フレームワーク**：Nuxt 3（SPA モード）
+- **言語**：Vue 3 + TypeScript
+- **ルーティング**：ファイルルーティング（Vue Router 4）
+- **スタイル**：純粋 CSS + CSS Variables
+- **アイコン**：Lucide Vue
+- **i18n**：vue-i18n（中文 / English / 日本語 / 한국어）
+
+---
+
+## 📝 よくある質問
+
+### Q: デスクトップ版のデータはどこに保存されますか？
+
+A: `~/Library/Application Support/HuobaoDrama/data/`（SQLite データベース + 生成画像/動画）。オンライン編集したスキルのコピーは同階層の `workspace/` ディレクトリにあります。開発モードではリポジトリの `data/` ディレクトリを使用します。
+
+### Q: 旧 MySQL データを SQLite に移行するには？
+
+A: MySQL に接続できる状態（環境変数または `backend/.env`）を保ち、`cd backend && npx tsx scripts/import-mysql-to-sqlite.ts` を実行。スクリプトが自動でテーブルを作成し、テーブルごとにインポートして行数を検証します（対象 DB が空でない場合は `--force` が必要。書き込み前に自動バックアップ）。
+
+### Q: FFmpeg が未インストール/見つからない？
+
+A: インストール不要です。プロジェクトに `ffmpeg-static` / `ffprobe-static` バイナリを内蔵（デスクトップ版も同梱）。システム `PATH` の FFmpeg と競合することもありません。`FFMPEG_BIN`/`FFPROBE_BIN` で明示的に指定することも可能です。
+
+### Q: ページ上部に「モデル未設定」と表示される？
+
+A: 初回デプロイ時の正常な案内です。「設定」ページで「火宝クイック設定」に API Key を貼ってワンクリックで書き込むか、「手動テンプレート」でプロバイダーを追加してください。テキスト・画像・動画の 3 類すべてに有効な設定があるとバナーは自動で消えます。
+
+### Q: フロントエンドがバックエンド API に接続できない？
+
+A: バックエンドが起動しているか、ポートが正しいかを確認してください。開発モードのプロキシ設定は `frontend/nuxt.config.ts` にあります。
+
+### Q: データベーステーブルが作成されない？
+
+A: バックエンドは初回起動時に全テーブルを自動作成します。ログで初期化が成功したか確認してください。
+
+---
+
+## 📋 更新履歴
+
+### v4.0.0 (2026-08)
+
+#### 🖥️ デスクトップアプリ + データベース移行
+
+- Electron デスクトップ版（macOS dmg、arm64/x64 デュアルアーキテクチャ）
+  - ダブルクリックでインストール、すぐ使える：自動ポート選択、シングルインスタンスロック、クラッシュ分離されたバックエンドサブプロセス
+  - ユーザーデータ分離：SQLite DB / 生成メディア / スキルコピーはすべて userData ディレクトリに保存
+  - FFmpeg/FFprobe を同梱。workspace スキルテンプレートは初回起動時にコピー、アップグレード時は不足分のみ補完して上書きしない
+- データベースを MySQL から SQLite へ完全移行（better-sqlite3 + WAL）
+  - ビジネスコードの変更ゼロ（Drizzle クエリ層は本質的に移植可能）、冪等な DDL リプレイ
+  - 一度きりのインポートスクリプト `import-mysql-to-sqlite.ts` を追加（テーブルごとの行数検証 + 自動バックアップ）
+- バックエンドを esbuild で単一ファイルにバンドル（externals：sharp/better-sqlite3/ffmpeg バイナリパッケージ）
+- Docker/MySQL デプロイを削除（git 履歴から復元可能）
+
+### v3.1.0 (2026-09)
+
+- Alibaba Bailian Wan 3.0 動画モデルを追加（Prime / 標準、公式 input.media/parameters パラメータ対応）
+- ワークベンチ上部バーに解像度セレクターを追加、プロバイダーごとにネイティブ段階を表示（Seedance 480p/720p、MiniMax 768P/2K、Wan 480P/720P/1080P）
+- デフォルトの動画モデルを Seedance 2.0 Mini に変更
+- 動画モデル切替時のプロバイダー/モデル不一致による生成エラーを修正
+- バッチ動画：選択モード + 生成前確認（ショット数/合計尺/モデル/解像度）、失敗タスクのワンクリック再試行
+- 分镜尺は動画生成パラメータ領域で直接編集・保存可能、単発/バッチ生成に統一適用
+- 実写/センシティブ内容の審査失敗時にモデル切替再試行を案内
+
+### v3.0.0 (2026-08)
+
+
+#### 🚀 デプロイと体験の最適化
+
+- Docker デプロイ対応の整備
+  - MySQL / アプリのヘルスチェック。データベース準備完了を待ってからアプリ起動
+  - データベース初期化にリトライを追加。コンテナオーケストレーションでの初回デプロイが無人で完了
+  - システム FFmpeg 依存を削除し、内蔵バイナリに全面移行
+  - Agent skills ディレクトリの volume 永続化（設定ページでのオンライン編集が失われない）
+  - `docker/init.sql` とエクスポートスクリプトを追加（DBA レビュー / 事前テーブル作成）
+- 初回利用ガイド
+  - AI サービス未設定時にサイト上部にバナーを表示し設定ページへ誘導
+  - 設定ページに「火宝クイック設定」を追加：1 つの Key でテキスト/画像/動画の 3 つの推奨設定を書き込み
+  - モデル未設定エラーの中国語化と設定ページへの誘導
+- 動画モデルのデフォルトを Seedance 2.0 Fast に変更
+- プロバイダー集約：OpenAI / Gemini / Volcano Engine のみ残存
+- ワークベンチ：タスクリストドロワー、パイプライン大セクション状態、選択的結合（結合前に動画ファイルの存在を検証）
+- 素材ライブラリ刷新、@メンション最適化、エピソードリスト再構築
+
+### v2.0.0 (2026-04)
+
+#### 🚀 大型アップデート
+
+- プロジェクトを TypeScript 技術スタックへ全面移行
+  - バックエンド：Hono + Drizzle ORM + mysql2
+  - フロントエンド：Nuxt 3 + Vue 3
+  - AI Agent：Mastra フレームワーク
+- エピソードワークベンチ UI と制作フローを刷新
+  - よりコンパクトなコンソールレイアウト
+  - 分镜編集エリアを刷新
+  - ショット画像、動画、合成、書き出し画面を刷新
+- Docker デプロイ対応を追加。フロントエンドとバックエンドを単一イメージに統合
+- ランタイム Skill ロード機構を追加
+- マルチプロバイダーメディアアダプターを拡張
+  - 画像：OpenAI、Gemini、Volcano Engine、Alibaba
+  - 動画：Volcano Engine/Seedance、Vidu、Alibaba
+- ローカルファイル処理と参照画像のオンデマンドトランスコードを最適化
+
+### v1.0.4 (2026-01-27)
+
+- ローカルストレージ戦略を導入し、外部リソースリンク切れを回避
+- Base64 参照画像の埋め込み転送
+- ショット切り替え時の状態リセット問題を修正
+- シーンのチャプターへの移行を追加
+
+### v1.0.3 (2026-01-16)
+
+- データベース同時アクセス性能を最適化
+- Docker クロスプラットフォームで host.docker.internal に対応
+
+### v1.0.2 (2026-01-14)
+
+- 動画生成 API レスポンスの解析問題を修正
+- OpenAI Sora 動画エンドポイント設定を追加
+- エラーハンドリングとログ出力を最適化
+
+---
+
+## 📄 ライセンス
+
+本プロジェクトは **[CC BY-NC-SA 4.0](LICENSE)**（表示-非営利-継承 4.0 国際）ライセンスを採用しています。
+
+- ✅ 個人利用、学習・研究、非営利プロジェクトでの使用は自由です
+- ✅ 改変と再配布は可能ですが、クレジット表示と同一ライセンスでの共有が必要です
+- ❌ **商用利用は禁止**——作者の書面による許可なく、本プロジェクトの全部または一部をいかなる商業目的（有料サービス、商用デプロイ、転売など）にも使用することはできません
+
+ライセンス全文は [LICENSE](LICENSE) を参照してください。
+
+---
+
+## 🤝 コントリビューション
+
+Issue と Pull Request を歓迎します！
+
+1. 本プロジェクトを Fork
+2. フィーチャーブランチを作成（`git checkout -b feature/AmazingFeature`）
+3. 変更をコミット（`git commit -m 'Add some AmazingFeature'`）
+4. ブランチをプッシュ（`git push origin feature/AmazingFeature`）
+5. Pull Request を作成
+
+よく使うチェックコマンド：
+
+```bash
+cd backend && npm run typecheck
+cd ../frontend && npm run build
+```
+
+---
+
+## 💬 WeChat グループ
+
+QR コードをスキャンして WeChat グループに参加：
+
+<div align="center">
+  <img src="docs/images/wx-group.png" width="200" alt="WeChat グループ QR コード" />
+</div>
+
+---
+
+> _"AI にもっと創造的なことを手伝ってもらおう"_
+
+## 🔗 関連リンク
+
+本プロジェクトは [LINUX DO](https://linux.do/) コミュニティからリンクの承認を得ています。
+
+- [LINUX DO](https://linux.do/) — 真のオープンソース精神、共に作り共有する技術コミュニティ
+
+---
diff --git a/huobao-source/README.ko.md b/huobao-source/README.ko.md
new file mode 100644
index 0000000..82f4883
--- /dev/null
+++ b/huobao-source/README.ko.md
@@ -0,0 +1,640 @@
+# 🎬 Huobao Drama - AI 숏드라마 생성 플랫폼
+
+<div align="center">
+
+**TypeScript 풀스택 기반 AI 숏드라마 자동 제작 플랫폼**
+
+[![Node Version](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org)
+[![Vue Version](https://img.shields.io/badge/Vue-3.x-4FC08D?style=flat&logo=vue.js)](https://vuejs.org)
+[![License](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+[![다운로드](https://img.shields.io/github/v/release/chatfire-AI/huobao-drama?style=flat&logo=github&label=%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C)](https://github.com/chatfire-AI/huobao-drama/releases/latest)
+
+[中英双语](README.md) | [English](README.en.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | **한국어**
+
+[기능](#-기능) • [빠른 시작](#-빠른-시작) • [튜토리얼](#-그림-튜토리얼) • [데스크톱 앱](#-데스크톱-앱-권장) • [배포](#-배포)
+
+<h2>🔑 <a href="https://api.firemux.com">Huobao API Key 받기 👉 바로 보기</a></h2>
+
+**텍스트 · 이미지 · 영상 모든 AI 기능, Key 하나로 활성화**
+
+배포 후 「설정 → 火宝快捷 설정」에 Key 를 붙여넣으면 추천 설정 3개가 한 번에 입력됩니다
+
+<h3>📥 <a href="https://github.com/chatfire-AI/huobao-drama/releases/latest">데스크톱 앱 다운로드 (macOS / Windows)</a></h3>
+<h3>🌐 <a href="https://www.firemux.cn">공식 웹사이트</a></h3>
+
+</div>
+
+---
+
+## 📖 프로젝트 소개
+
+Huobao Drama는 AI 기반 숏드라마 자동 제작 플랫폼으로, 각본 생성, 캐릭터 디자인, 스토리보드 제작부터 영상 합성까지 전 과정을 자동화합니다.
+
+### 🎯 핵심 가치
+
+- **🤖 AI 기반**：대규모 언어 모델로 각본을 분석하여 캐릭터, 장면, 스토리보드 정보를 추출
+- **🎨 지능형 창작**：AI 이미지 생성으로 캐릭터 이미지와 장면 배경 제작
+- **📹 영상 생성**：텍스트→영상 및 이미지→영상 모델로 스토리보드 영상 자동 생성
+- **🔄 워크플로**：아이디어부터 완성 영상까지 숏드라마 제작 전 과정을 한 곳에서 완료
+
+### 🛠️ 기술 아키텍처
+
+```
+frontend/   — Nuxt 3 + Vue 3 + TypeScript (순수 CSS, UI 프레임워크 없음)
+backend/    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
+backend/workspace/skills/ — Agent 스킬 정의 (SKILL.md, UI에서 온라인 편집 가능)
+desktop/    — Electron 데스크톱 버전 (메인 프로세스 + esbuild 번들 + electron-builder로 dmg/exe 생성)
+data/       — 생성된 에셋과 SQLite 데이터베이스
+```
+
+---
+
+## ✨ 기능
+
+### 🎭 캐릭터 관리
+
+- ✅ AI 캐릭터 이미지 생성
+- ✅ 캐릭터 일괄 생성
+- ✅ 캐릭터 이미지 업로드 및 관리
+
+### 🎬 영상 작업
+
+- ✅ AI 영상 작업 자동 생성
+- ✅ 장면 설명 및 영상 프롬프트 생성
+- ✅ 작업별 영상 일괄 생성
+
+### 🎥 영상 생성
+
+- ✅ 텍스트→영상 자동 생성
+- ✅ FFmpeg 샷 단위 합성 및 자막 처리
+- ✅ 에피소드 전체 병합 및 납출
+
+### 📦 에셋 관리
+
+- ✅ 소재 라이브러리 통합 관리
+- ✅ 로컬 스토리지 지원
+- ✅ 작업 진행 상황 추적
+
+### 🤖 AI Agents
+
+4개의 Mastra Agent 내장, 데이터베이스 설정과 Skill 확장 지원:
+
+| Agent | 역할 |
+|---|---|
+| `script_rewriter` | 소설 → 형식화된 각본 리라이팅 |
+| `extractor` | 캐릭터 / 장면 / 소품 지능형 추출 및 중복 제거 |
+| `storyboard_breaker` | 각본 → 스토리보드 시퀀스 분해 |
+| `prompt_generator` | 캐릭터/장면/소품 이미지 프롬프트 + 스토리보드 영상 프롬프트 생성 |
+
+### 🌐 다국어 UI
+
+인터페이스는 **中文 / English / 日本語 / 한국어** 4개 언어를 내장하고, AI 생성 콘텐츠의 언어를 전역으로 설정할 수 있습니다.
+
+### 🔌 멀티 프로바이더 지원
+
+| 유형 | 지원 프로바이더 |
+|---|---|
+| **텍스트** | OpenAI(호환 API), Gemini |
+| **이미지** | OpenAI, Gemini, Volcano Engine |
+| **영상** | Volcano Engine Seedance 2.0(Standard / Fast / Mini), MiniMax H3, Alibaba Bailian Wan 3.0(Prime / Standard) |
+
+---
+
+## 🚀 빠른 시작
+
+### 📋 환경 요구 사항
+
+| 소프트웨어 | 버전 | 설명 |
+|---|---|---|
+| **Node.js** | 20+ | 프런트엔드/백엔드 실행 환경 |
+| **npm** | 9+ | 패키지 관리 도구 |
+
+> **데이터베이스 설치 불필요**：SQLite 내장(프로젝트 데이터 디렉터리의 단일 파일)으로 데이터베이스 서버 설치가 필요 없습니다.
+> **FFmpeg 설치 불필요**：`ffmpeg-static` / `ffprobe-static` npm 패키지에 바이너리가 내장되어 바로 사용할 수 있습니다.
+
+### ⚙️ 환경 변수
+
+설정 파일 없이 환경 변수로 설정합니다(모두 기본값이 있어 로컬 개발은 무설정으로 시작 가능):
+
+| 변수 | 기본값 | 설명 |
+|---|---|---|
+| `SQLITE_PATH` | `<저장소>/data/huobao.sqlite3` | SQLite 데이터베이스 파일 위치 |
+| `PORT` | `5679` | 백엔드 서비스 포트 |
+| `STORAGE_PATH` | `<저장소>/data/static` | 생성 파일 저장 디렉터리 |
+| `HUOBAO_DATA_DIR` | — | 데스크톱 버전에서 Electron 메인 프로세스가 주입(userData 데이터 루트) |
+| `WORKSPACE_PATH` | `backend/workspace` | Agent 스킬/프롬프트 디렉터리(데스크톱 버전은 userData의 쓰기 가능한 복사본) |
+| `FRONTEND_DIST` | `frontend/dist` | 프런트엔드 정적 빌드 디렉터리 |
+| `FFMPEG_BIN` / `FFPROBE_BIN` | npm 내장 바이너리 | 사용자 지정 ffmpeg/ffprobe 실행 파일 경로 |
+| `PUBLIC_BASE_URL` | — | Seedance가 로컬 참조 리소스를 사용할 때 필요한 공개 주소(서버 배포용) |
+
+> **설명**：AI 서비스의 API Key, Base URL, 모델 파라미터는 모두 웹 UI의 「설정」 페이지에서 설정하여 데이터베이스에 저장합니다. 설정 파일이나 환경 변수로 관리하지 않습니다.
+
+### 📥 설치
+
+```bash
+# 저장소 클론
+git clone https://github.com/chatfire-AI/huobao-drama.git
+cd huobao-drama
+
+# 백엔드 의존성 설치
+cd backend && npm install
+
+# 프런트엔드 의존성 설치
+cd ../frontend && npm install
+```
+
+### 🎯 실행
+
+#### 방법 1: 개발 모드(권장)
+
+프런트엔드와 백엔드를 분리하여 핫 리로드 지원:
+
+```bash
+# 터미널 1: 백엔드
+cd backend
+npm run dev
+
+# 터미널 2: 프런트엔드
+cd frontend
+npm run dev
+```
+
+- 프런트엔드 주소: `http://localhost:3013`
+- 백엔드 API: `http://localhost:5679/api/v1`
+- 프런트엔드가 `/api`와 `/static`을 백엔드로 자동 프록시
+
+#### 방법 2: 단일 서비스 모드
+
+백엔드가 API와 프런트엔드 정적 파일을 모두 제공:
+
+```bash
+# 1. 프런트엔드 빌드
+cd frontend && npm run generate
+
+# 2. 빌드 산출물을 백엔드가 읽는 디렉터리로 복사
+#    (generate 산출물은 .output/public, 백엔드는 frontend/dist를 읽음)
+cp -r .output/public dist
+
+# 3. 백엔드 시작
+cd ../backend && npm start
+```
+
+접속: `http://localhost:5679`
+
+### 🗄️ 데이터베이스
+
+SQLite 내장(`better-sqlite3` + WAL 모드). 최초 시작 시 테이블 자동 생성(멱등 DDL 재생 + 시드 데이터). 기본 파일은 `data/huobao.sqlite3`이며 `SQLITE_PATH`로 변경 가능. 데스크톱 버전의 데이터는 사용자 데이터 디렉터리(`~/Library/Application Support/HuobaoDrama/data/`)에 저장됩니다.
+
+구버전 MySQL에서 데이터 마이그레이션:
+
+**시작 시 자동 마이그레이션(권장)**: MySQL이 명시적으로 설정되어 있고(`DATABASE_URL` 또는 `MYSQL_HOST`) SQLite가 비어 있으면, 백엔드 시작 시 자동으로 감지하여 모든 테이블을 한 번만 가져옵니다(테이블별 행 수 검증, 단일 트랜잭션 원자적 쓰기, 실패 시 자동 롤백 후 다음 시작 때 재시도, 성공 시 `.mysql-imported` 마커를 기록하여 중복 방지). `MYSQL_AUTO_IMPORT=false`로 비활성화할 수 있습니다.
+
+```bash
+# 수동 실행도 가능(대상 DB가 비어 있지 않으면 --force 필요, 쓰기 전 자동 백업)
+cd backend && npx tsx scripts/import-mysql-to-sqlite.ts
+```
+
+> 마이그레이션은 데이터베이스 행만 포함합니다. 구 배포의 `data/static/` 아래 이미지/영상 등 미디어 파일은 수동으로 복사해야 하며, 그렇지 않으면 기존 소재에 접근할 수 없습니다.
+
+### 🔑 첫 사용: AI 서비스 설정
+
+시작 후 모든 AI 기능(텍스트/이미지/영상)을 사용하려면 먼저 모델 서비스를 설정해야 합니다. 미설정 시 페이지 상단에 배너로 안내합니다:
+
+1. 「설정」 페이지 열기
+2. 「火宝快捷 설정」에 Huobao API Key 붙여넣기([api.firemux.com에서 발급](https://api.firemux.com)). 텍스트, 이미지, 영상 추천 설정 3개가 한 번에 입력됩니다
+3. 또는 「수동 템플릿」으로 프로바이더별 추가. 연결 테스트 지원
+
+설정이 완료되면 배너가 자동으로 사라지고 에피소드 제작을 시작할 수 있습니다.
+
+---
+
+## 📖 그림 튜토리얼
+
+소설부터 완성 에피소드까지의 전체 제작 흐름입니다. 왼쪽 진행 표시줄이 항상 현재 단계를 보여줍니다.
+
+### 1단계 · 프로젝트 생성
+
+홈에서 "새 프로젝트"를 클릭하고 **화면 비율**(16:9 가로 / 9:16 세로, 생성 후 변경 불가)과 **화풍**(3D / 실사 등, 모든 이미지 프롬프트에 주입)을 선택합니다.
+
+<p align="center">
+  <img src="docs/screenshots/02-create-drama.png" alt="프로젝트 생성" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/01-projects.png" alt="프로젝트 목록" width="800">
+</p>
+
+### 2단계 · AI 서비스 설정 (최초)
+
+설정 페이지의 "휘바오 빠른 설정"에 API 키를 붙여넣으면 추천 설정 3종을 한 번에 등록합니다. 수동 템플릿으로 직접 추가할 수도 있습니다. 사용 모델은 상단 바에서 언제든 전환 가능합니다(5단계 참고).
+
+<p align="center">
+  <img src="docs/screenshots/03-settings-quick.png" alt="AI 서비스 설정" width="800">
+</p>
+
+### 3단계 · 대본 단계
+
+제작 화면에 **원문(소설)**을 붙여넣고 "AI 재작성"을 실행하면 촬영용 대본이 생성됩니다 — 에피소드별 분할 및 장면·캐릭터 주석 포함. 모델과 톤을 바꿔가며 재작성할 수 있습니다.
+
+<p align="center">
+  <img src="docs/screenshots/05-script.png" alt="대본 단계" width="800">
+</p>
+
+### 4단계 · 에셋 제작
+
+대본에 **추출**을 실행하면 캐릭터 / 장면 / 소품 목록이 자동 생성됩니다. 각 항목의 "이미지 생성"으로 일관성 있는 참조 이미지를 만들 수 있습니다(일괄 생성 지원). 이 이미지들은 영상 생성 시 참조 소재로 주입됩니다.
+
+<p align="center">
+  <img src="docs/screenshots/06-assets.png" alt="에셋 제작" width="800">
+</p>
+
+### 5단계 · 스토리보드와 영상
+
+"영상 제작" 페이지에서 먼저 **스토리보드 분할**을 실행하세요(AI가 컷을 나누고 영상 프롬프트 생성). 그 후:
+
+- 상단 바에서 **영상 모델** 선택(Seedance / Wan 3.0 / MiniMax 등). 해상도와 길이 옵션은 모델에 연동됩니다
+- 오른쪽에서 각 컷의 프롬프트를 확인·조정(`@캐릭터명` 참조는 자동으로 참조 이미지에 매핑)
+- "일괄 영상 생성"으로 작업 시작. 실패한 작업은 원클릭 재시도
+
+<p align="center">
+  <img src="docs/screenshots/07-storyboard.png" alt="스토리보드 분할" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/08-videos.png" alt="영상 생성" width="800">
+</p>
+
+### 6단계 · 병합과 내보내기
+
+컷을 선택(호버로 각 클립 미리보기)하고 "병합 시작"을 누르면 FFmpeg이 완성 에피소드를 자동 합성합니다. 온라인 재생·다운로드 가능. 완료 후 "완료 표시"를 누르면 진행 표시줄이 켜집니다.
+
+<p align="center">
+  <img src="docs/screenshots/09-export.png" alt="병합과 내보내기" width="800">
+</p>
+
+에피소드 목록에서 각 화의 제작 현황을 확인하고 "제작 열기"로 이어서 작업할 수 있습니다:
+
+<p align="center">
+  <img src="docs/screenshots/04-episodes.png" alt="에피소드 목록" width="800">
+</p>
+
+---
+
+## 📦 배포
+
+### 🖥️ 데스크톱 앱(권장)
+
+**⬇️ 빌드된 설치 파일: [GitHub Releases](https://github.com/chatfire-AI/huobao-drama/releases/latest) · [중국용 미러(Tencent COS)](https://installer.firemux.site/huobao-drama/v4.0.11/)**
+
+| 플랫폼 | 다운로드 파일 |
+|---|---|
+| macOS(Apple Silicon, M 시리즈) | `HuobaoDrama-4.0.5-arm64.dmg` |
+| macOS(Intel) | `HuobaoDrama-4.0.5.dmg` |
+| Windows | `HuobaoDrama.Setup.4.0.5.exe` |
+
+> 중국 본토에서는 GitHub이 불안정하므로 Tencent COS 미러를 이용하세요. 앱 내 업데이터도 COS를 우선하고 GitHub으로 폴백합니다.
+
+**커맨드라인 설치(권장, 복구 불필요)**: curl로 다운로드하면 macOS 격리 속성이 붙지 않아 "손상됨" 경고 없이 바로 실행됩니다(Apple Silicon은 `-arm64.dmg`, Intel은 일반 dmg 사용):
+
+```bash
+curl -L -o /tmp/HuobaoDrama.dmg https://installer.firemux.site/huobao-drama/v4.0.11/HuobaoDrama-4.0.11-arm64.dmg \
+  && hdiutil attach -nobrowse /tmp/HuobaoDrama.dmg \
+  && cp -R /Volumes/HuobaoDrama*/HuobaoDrama.app /Applications/ \
+  && hdiutil detach /Volumes/HuobaoDrama*
+```
+
+빌드 불필요 — dmg/exe를 다운로드해 바로 설치하면 됩니다. 설치된 클라이언트는 내장 업데이터로 자동 업데이트됩니다. (소스에서 직접 패키징하려면 아래 명령을 참조하세요.)
+
+더블클릭 설치로 바로 사용할 수 있는 데스크톱 버전(macOS + Windows). 데이터베이스(SQLite), 생성된 미디어 파일, Agent 스킬은 모두 사용자 데이터 디렉터리에 저장되며 앱을 삭제필필도 데이터에 영향이 없습니다.
+
+```bash
+# 원커맨드 패키징(프런트엔드 generate → 백엔드 esbuild → electron-builder)
+npm run dist        # macOS dmg(arm64 + Intel)
+npm run dist:win    # Windows NSIS 설치 프로그램(win-x64, macOS에서 크로스 빌드 가능)
+
+# 산출물
+# desktop/release/HuobaoDrama-<버전>-arm64.dmg        (Apple Silicon)
+# desktop/release/HuobaoDrama-<버전>.dmg              (Intel)
+# desktop/release/HuobaoDrama Setup <버전>.exe        (Windows)
+```
+
+설치 안내:
+
+- macOS 미서명 패키지는 첫 실행 시 "App이 손상되어 열 수 없습니다"라는 메시지가 뜰 수 있습니다(Apple Silicon에서 흔함). 이는 Gatekeeper 격리 속성 때문이며 파일이 실제로 손상된 것은 아닙니다. 복구 방법은 두 가지입니다:
+  1. **dmg에 복구 스크립트 포함**: 앱을 "응용 프로그램"으로 드래그한 후 dmg 창 하단의 "如提示已损坏请双击我.command"를 더블클릭하면 자동으로 복구됩니다;
+  2. 또는 터미널에서 `sudo xattr -cr /Applications/HuobaoDrama.app` 실행.
+
+  복구는 처음 한 번만 필요하며, 이후에는 정상 실행되고 앱 내 자동 업데이트에도 영향이 없습니다.
+- Windows 미서명 패키지는 SmartScreen에서 「추가 정보 → 실행」 선택
+- 사용자 데이터 디렉터리: `~/Library/Application Support/HuobaoDrama/`(데이터베이스, 생성된 미디어, 온라인 편집한 스킬 복사본)
+- FFmpeg/FFprobe 바이너리 내장, 시스템 설치 불필요
+- Electron은 37.x로 고정: better-sqlite3의 win32 프리빌드가 해당 ABI까지만 지원(크로스 패키징 시 컴파일 불필요의 핵심)
+- 앱 내 외부 링크(「api.firemux.com에서 Key 받기」 등)는 시스템 브라우저로 바로 열립니다
+
+#### 🔄 앱 내 업데이트(Apple 서명 불필요)
+
+데스크톱 버전에는 업데이터가 내장되어 있습니다(Tauri와 동류 방식: macOS 디렉터리 교체 / Windows 사일런트 설치, 로컬 sha256 검증). 새 버전 릴리스 절차:
+
+```bash
+# 1. desktop/package.json의 version을 수정한 후 패키징
+npm run dist        # macOS(dmg + 업데이트용 zip 산출)
+npm run dist:win    # Windows(Setup.exe 산출)
+
+# 2. 버전 매니페스트 release/latest.json 생성(플랫폼별 sha256 포함)
+cd desktop && npm run feed
+
+# 3. 릴리스: latest.json + 설치 패키지 + zip을 GitHub Release에 업로드(태그는 v1.0.1 형식)
+```
+
+설치된 클라이언트는 시작 후 매니페스트를 자동으로 확인하고(「설정 → 정보 및 업데이트」에서 수동 확인도 가능), 새 버전을 발견하면 다운로드 및 설치를 안내합니다. 매니페스트 주소는 `HUOBAO_UPDATE_FEED` 환경 변수로 변경할 수 있습니다.
+
+데스크톱 버전 개발 디버깅:
+
+```bash
+npm run build:frontend   # 프런트엔드 정적 산출물(frontend/.output/public)
+cd desktop && npm run dev  # 백엔드 번들 후 Electron 창으로 실행
+```
+
+> 알려진 제한: Seedance 영상 모델이 로컬 참조 리소스를 사용하려면 `PUBLIC_BASE_URL` 공개 주소가 필요합니다. 데스크톱 버전에는 공개 진입점이 없어 해당 시나리오에서는 명확한 오류 메시지가 표시됩니다. 텍스트→영상/이미지 생성 등 나머지 기능에는 영향이 없습니다.
+
+---
+
+### 🏭 서버 배포
+
+```bash
+# 1. 프런트엔드 빌드
+cd frontend && npm run generate
+
+# 2. 빌드 산출물 복사(generate 산출물은 frontend/.output/public, 백엔드는
+#    frontend/dist를 읽음. 이 단계를 생략하면 API는 정상이지만 페이지가 404)
+cp -r .output/public dist && cd ..
+
+# 3. 백엔드 시작
+cd backend && npm start
+```
+
+서버에 업로드할 파일:
+
+```
+backend/                    # 백엔드 소스 + node_modules
+backend/workspace/skills/   # Agent 스킬 파일
+frontend/dist/              # 프런트엔드 빌드 산출물
+data/                       # 데이터 디렉터리(최초 실행 시 자동 생성)
+```
+
+#### Nginx 리버스 프록시
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # 참조 영상/오디오 업로드 최대 50MB
+    client_max_body_size 100m;
+
+    # 생성된 이미지/영상은 디스크에서 직접 서빙(Node를 거치지 않음):
+    # sendfile 제로 카피 + 장기 캐시
+    # (파일은 uuid 명명, 내용 불변이므로 immutable 캐시 안전)
+    location /static/ {
+        alias /path/to/huobao-drama/data/static/;
+        sendfile on;
+        tcp_nopush on;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
+    location / {
+        proxy_pass http://localhost:5679;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+}
+```
+
+> 미디어 로딩 최적화: 이미지 생성 시 백엔드가 목록 페이지용 400px 썸네일(`*_thumb.webp`)을 자동 생성하고, 영상은 포스터 프레임(`*_poster.jpg`)을 커버로 추출합니다. 프런트엔드는 큰 이미지를 열거나 재생할 때만 원본 파일을 로드합니다. 기존 파일은 `backend/`에서 `npm run backfill-artwork`를 실행해 일괄 보완할 수 있습니다.
+
+### 🐳 Docker 배포(앱 내 업데이트 포함)
+
+**방법 A — 사전 빌드 이미지(클론·빌드 불필요)**: 멀티 아키텍처(`linux/amd64` + `linux/arm64`), x86 서버와 ARM 디바이스 자동 매칭
+
+```bash
+docker pull huobao/huobao-drama:4.0.6
+
+docker run -d \
+  --name huobao-drama \
+  -p 5679:5679 \
+  -v huobao-data:/app/data \
+  --restart unless-stopped \
+  huobao/huobao-drama:4.0.6
+```
+
+**방법 B — docker compose(소스 빌드 + Watchtower 인앱 업데이트)**: 저장소 루트에 올인원 `Dockerfile`(프런트엔드 generate + 백엔드 의존성/런타임 3단계, 백엔드는 서버 배포와 동일하게 tsx로 실행)과 `docker-compose.yml`(앱 + Watchtower)을 제공합니다:
+
+```bash
+# 1. 환경 설정(Watchtower 토큰, app과 watchtower 양쪽이 일치해야 함)
+cp .env.example .env   # WATCHTOWER_TOKEN 수정
+
+# 2. 빌드 및 시작(릴리스 시 버전을 주입하여 「정보 및 업데이트」 비교에 사용)
+HUOBAO_VERSION=4.0.5 docker compose up -d --build
+
+# 3. http://localhost:5679 접속
+```
+
+- **데이터 영속화**: 네임드 볼륨 `huobao-data`를 `/app/data`에 마운트(SQLite + 생성된 이미지/영상 + workspace/skills). 이미지 업데이트 시에도 데이터 유지
+- **앱 내 업데이트**: compose에 [Watchtower](https://containrrr.dev/watchtower/) 사이드카 포함(`--label-enable`로 라벨이 지정된 컨테이너만 업데이트, `--cleanup`으로 구 이미지 정리, 매일 자체 점검). 「설정 → 정보 및 업데이트」에서 새 버전 확인 및 「지금 업데이트」 가능 — 백엔드가 Watchtower HTTP API를 통해 트리거하여 새 이미지를 가져와 컨테이너를 재생성합니다. 몇 분 후 페이지를 새로고침하면 완료
+- **수동 모드**: `docker-compose.yml`에서 app의 `HUOBAO_WATCHTOWER_*` 환경 변수 2개(또는 watchtower 서비스 전체)를 삭제하면 「정보 및 업데이트」는 새 버전 알림 + 수동 명령 `docker compose pull && docker compose up -d`으로 전환됩니다
+- **이미지 릴리스**: `docker buildx build --platform linux/amd64,linux/arm64 --build-arg HUOBAO_VERSION=x.y.z -t huobao/huobao-drama:x.y.z -t huobao/huobao-drama:latest --push .`. 버전 매니페스트는 데스크톱 버전과 GitHub Releases의 `latest.json`을 공유(`HUOBAO_UPDATE_FEED`로 재정의 가능)
+
+---
+
+## 🎨 기술 스택
+
+### 백엔드
+
+- **런타임**: Node.js 20+
+- **웹 프레임워크**: Hono
+- **ORM**: Drizzle ORM + better-sqlite3(WAL 모드)
+- **AI Agent**: Mastra + AI SDK(OpenAI 호환)
+- **영상 처리**: FFmpeg(fluent-ffmpeg + 내장 바이너리)
+- **이미지 처리**: Sharp
+
+### 데스크톱
+
+- **셸**: Electron(utilityProcess가 백엔드를 호스팅, BrowserWindow는 동일 출처로 로드)
+- **패키징**: esbuild(백엔드 단일 파일 번들) + electron-builder(dmg arm64/x64, NSIS win-x64)
+
+### 프런트엔드
+
+- **프레임워크**: Nuxt 3(SPA 모드)
+- **언어**: Vue 3 + TypeScript
+- **라우팅**: 파일 라우팅(Vue Router 4)
+- **스타일**: 순수 CSS + CSS Variables
+- **아이콘**: Lucide Vue
+- **i18n**: vue-i18n(中文 / English / 日本語 / 한국어)
+
+---
+
+## 📝 자주 묻는 질문
+
+### Q: 데스크톱 버전의 데이터는 어디에 저장되나요?
+
+A: `~/Library/Application Support/HuobaoDrama/data/`(SQLite 데이터베이스 + 생성된 이미지/영상)에 저장되며, 온라인 편집한 스킬의 복사본은 같은 수준의 `workspace/` 디렉터리에 있습니다. 개발 모드에서는 저장소의 `data/` 디렉터리를 사용합니다.
+
+### Q: 구버전 MySQL 데이터를 SQLite로 마이그레이션하려면?
+
+A: MySQL에 연결 가능한 상태(환경 변수 또는 `backend/.env`)를 유지하고 `cd backend && npx tsx scripts/import-mysql-to-sqlite.ts`를 실행하세요. 스크립트가 자동으로 테이블을 생성하고 테이블별로 가져오며 행 수를 검증합니다(대상 DB가 비어 있지 않으면 `--force` 필요, 쓰기 전 자동 백업).
+
+### Q: FFmpeg가 설치되지 않았거나 찾을 수 없다고 나옵니다?
+
+A: 설치할 필요가 없습니다. 프로젝트에 `ffmpeg-static` / `ffprobe-static` 바이너리가 내장되어 있습니다(데스크톱 버전에도 포함). 시스템 `PATH`의 FFmpeg와 충돌하지 않으며, `FFMPEG_BIN`/`FFPROBE_BIN`으로 명시적으로 지정할 수도 있습니다.
+
+### Q: 페이지 상단에 「모델 미설정」이 표시됩니다?
+
+A: 정상적인 첫 배포 안내입니다. 「설정」 페이지에서 「火宝快捷 설정」에 API Key를 붙여넣어 한 번에 입력하거나, 「수동 템플릿」으로 프로바이더를 추가하세요. 텍스트, 이미지, 영상 3가지 모두에 활성화된 설정이 있으면 배너가 자동으로 사라집니다.
+
+### Q: 프런트엔드가 백엔드 API에 연결되지 않습니다?
+
+A: 백엔드가 시작되었는지, 포트가 올바른지 확인하세요. 개발 모드의 프록시 설정은 `frontend/nuxt.config.ts`에 있습니다.
+
+### Q: 데이터베이스 테이블이 생성되지 않았습니다?
+
+A: 백엔드는 최초 시작 시 모든 테이블을 자동으로 생성합니다. 로그에서 초기화 성공 여부를 확인하세요.
+
+---
+
+## 📋 업데이트 로그
+
+### v4.0.0 (2026-08)
+
+#### 🖥️ 데스크톱 앱 + 데이터베이스 마이그레이션
+
+- Electron 데스크톱 버전(macOS dmg, arm64/x64 듀얼 아키텍처)
+  - 더블클릭 설치, 즉시 사용: 자동 포트 선택, 단일 인스턴스 잠금, 충돌 분리된 백엔드 서브프로세스
+  - 사용자 데이터 분리: SQLite DB / 생성된 미디어 / 스킬 복사본 모두 userData 디렉터리에 저장
+  - FFmpeg/FFprobe 포함 배포. workspace 스킬 템플릿은 첫 시작 시 복사, 업그레이드 시 누락분만 보충하고 덮어쓰지 않음
+- 데이터베이스를 MySQL에서 SQLite로 완전 마이그레이션(better-sqlite3 + WAL)
+  - 비즈니스 코드 변경 제로(Drizzle 쿼리 계층은 본질적으로 이식 가능), 멱등 DDL 재생
+  - 1회용 가져오기 스크립트 `import-mysql-to-sqlite.ts` 추가(테이블별 행 수 검증 + 자동 백업)
+- 백엔드 esbuild 단일 파일 번들(externals: sharp/better-sqlite3/ffmpeg 바이너리 패키지)
+- Docker/MySQL 배포 방식 제거(git 히스토리에서 복구 가능)
+
+### v3.1.0 (2026-09)
+
+- Alibaba Bailian Wan 3.0 동영상 모델 추가(Prime / 표준, 공식 input.media/parameters 파라미터 지원)
+- 작업대 상단 바에 해상도 선택기 추가, 제공사별 네이티브 단계 표시(Seedance 480p/720p, MiniMax 768P/2K, Wan 480P/720P/1080P)
+- 기본 동영상 모델을 Seedance 2.0 Mini로 변경
+- 동영상 모델 전환 시 제공사/모델 불일치로 인한 생성 오류 수정
+- 배치 동영상: 선택 모드 + 생성 전 확인(숏 수/총 길이/모델/해상도), 실패 작업 원클릭 재시도
+- 스토리보드 길이를 동영상 생성 파라미터 영역에서 직접 편집·저장, 단건/배치 생성에 통일 적용
+- 실사/민감 콘텐츠 심사 실패 시 모델 전환 후 재시도 안내
+
+### v3.0.0 (2026-08)
+
+
+#### 🚀 배포 및 경험 최적화
+
+- Docker 배포 준비 개선
+  - MySQL / 앱 헬스 체크, 데이터베이스 준비 후 앱 시작
+  - 데이터베이스 초기화에 재시도 추가, 컨테이너 오케스트레이션에서 첫 배포 무인 완료
+  - 시스템 FFmpeg 의존 제거, 내장 바이너리로 전면 전환
+  - Agent skills 디렉터리 볼륨 영속화(설정 페이지 온라인 편집 유실 방지)
+  - `docker/init.sql` 및 납출 스크립트 추가(DBA 검토 / 사전 테이블 생성)
+- 첫 사용 가이드
+  - AI 서비스 미설정 시 사이트 상단 배너로 설정 페이지 안내
+  - 설정 페이지에 「火宝快捷 설정」 추가: Key 하나로 텍스트/이미지/영상 추천 설정 3개 입력
+  - 모델 미설정 오류의 중국어화 및 설정 페이지 안내
+- 영상 모델 기본값을 Seedance 2.0 Fast로 조정
+- 프로바이더 통합: OpenAI / Gemini / Volcano Engine만 유지
+- 워크벤치: 작업 목록 드로어, 파이프라인 대섹션 상태, 선택적 병합(병합 전 영상 파일 존재 검증)
+- 소재 라이브러리 개편, @멘션 최적화, 에피소드 목록 재구성
+
+### v2.0.0 (2026-04)
+
+#### 🚀 대규모 업데이트
+
+- 프로젝트를 TypeScript 기술 스택으로 전면 마이그레이션
+  - 백엔드: Hono + Drizzle ORM + mysql2
+  - 프런트엔드: Nuxt 3 + Vue 3
+  - AI Agent: Mastra 프레임워크
+- 에피소드 워크벤치 UI와 제작 플로우 재구축
+  - 더 컴팩트한 콘솔 레이아웃
+  - 스토리보드 편집 영역 재구축
+  - 샷 이미지, 영상, 합성, 납출 화면 재구축
+- Docker 배포 지원 추가, 프런트엔드와 백엔드를 단일 이미지로 통합
+- 런타임 Skill 로딩 메커니즘 추가
+- 멀티 프로바이더 미디어 어댑터 확장
+  - 이미지: OpenAI, Gemini, Volcano Engine, Alibaba
+  - 영상: Volcano Engine/Seedance, Vidu, Alibaba
+- 로컬 파일 처리 및 참조 이미지 온디맨드 트랜스코딩 최적화
+
+### v1.0.4 (2026-01-27)
+
+- 로컬 스토리지 전략 도입으로 외부 리소스 링크 실효 회피
+- Base64 참조 이미지 임베디드 전송
+- 샷 전환 상태 리셋 문제 수정
+- 장면의 챕터 마이그레이션 추가
+
+### v1.0.3 (2026-01-16)
+
+- 데이터베이스 동시 접근 성능 최적화
+- Docker 크로스 플랫폼 host.docker.internal 지원
+
+### v1.0.2 (2026-01-14)
+
+- 영상 생성 API 응답 파싱 문제 수정
+- OpenAI Sora 영상 엔드포인트 설정 추가
+- 오류 처리 및 로그 출력 최적화
+
+---
+
+## 📄 라이선스
+
+이 프로젝트는 **[CC BY-NC-SA 4.0](LICENSE)**(저작자표시-비영리-동일조걳경변경허락 4.0 국제) 라이선스를 채택하고 있습니다.
+
+- ✅ 개인 사용, 학습·연구, 비영리 프로젝트는 자유롭게 사용 가능
+- ✅ 수정 및 재배포 가능, 단 저작자 표시와 동일 라이선스로 공유 필요
+- ❌ **상업적 사용 금지** — 저작자의 서면 허가 없이 이 프로젝트의 전부 또는 일부를 어떠한 상업적 목적(유료 서비스, 상업 배포, 재판매 등)으로도 사용할 수 없습니다
+
+라이선스 전문은 [LICENSE](LICENSE)를 참조하세요.
+
+---
+
+## 🤝 기여 가이드
+
+Issue와 Pull Request를 환영합니다!
+
+1. 이 프로젝트를 Fork
+2. 기능 브랜치 생성(`git checkout -b feature/AmazingFeature`)
+3. 변경 사항 커밋(`git commit -m 'Add some AmazingFeature'`)
+4. 브랜치 푸시(`git push origin feature/AmazingFeature`)
+5. Pull Request 생성
+
+자주 쓰는 검사 명령:
+
+```bash
+cd backend && npm run typecheck
+cd ../frontend && npm run build
+```
+
+---
+
+## 💬 WeChat 그룹
+
+QR 코드를 스캔하여 WeChat 그룹에 참여하세요:
+
+<div align="center">
+  <img src="docs/images/wx-group.png" width="200" alt="WeChat 그룹 QR 코드" />
+</div>
+
+---
+
+> _"AI가 더 창의적인 일을 돕게 하자"_
+
+## 🔗 관련 링크
+
+이 프로젝트는 [LINUX DO](https://linux.do/) 커뮤니티의 링크 승인을 받았습니다.
+
+- [LINUX DO](https://linux.do/) — 진정한 오픈소스 정신, 함께 만들고 공유하는 기술 커뮤니티
+
+---
diff --git a/huobao-source/README.md b/huobao-source/README.md
new file mode 100644
index 0000000..578c85e
--- /dev/null
+++ b/huobao-source/README.md
@@ -0,0 +1,916 @@
+# 🎬 Huobao Drama — AI 短剧生成平台 / AI Short Drama Generation Platform
+
+<div align="center">
+
+**基于 TypeScript 全栈的 AI 短剧自动化生产平台**<br>
+**A full-stack TypeScript platform for automated AI short-drama production**
+
+[![Node Version](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org)
+[![Vue Version](https://img.shields.io/badge/Vue-3.x-4FC08D?style=flat&logo=vue.js)](https://vuejs.org)
+[![License](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+[![Download](https://img.shields.io/github/v/release/chatfire-AI/huobao-drama?style=flat&logo=github&label=Download)](https://github.com/chatfire-AI/huobao-drama/releases/latest)
+
+**中英双语 / Bilingual** | [简体中文](README.zh-CN.md) | [English](README.en.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
+
+<p>
+  <a href="https://api.firemux.cn">
+    <img src="docs/images/api-key-cta.svg" width="380" alt="立即获取 FireMux API Key / Get your API key" />
+  </a>
+</p>
+
+**文本 · 图片 · 视频全部 AI 能力，一个 Key 即可开通**<br>
+**Text, image, and video AI capabilities — one key unlocks everything**
+
+部署完成后，在「设置 → 火宝快捷配置」粘贴 Key，一键写入三条推荐配置。<br>
+After deploying, paste the key in "Settings → Huobao Quick Setup" to write three recommended configs in one click.
+
+<p>
+  <a href="https://github.com/chatfire-AI/huobao-drama/releases/latest">
+    <img src="docs/images/desktop-download-cta.svg" width="380" alt="立即下载桌面版 / Download Desktop App (macOS / Windows)" />
+  </a>
+</p>
+<p>
+  <a href="https://www.firemux.cn">
+    <img src="docs/images/website-cta.svg" width="320" alt="访问 FireMux 官网 / Visit the official website" />
+  </a>
+</p>
+
+</div>
+
+---
+
+## 📖 项目简介 / Overview
+
+Huobao Drama 是一个基于 AI 的短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。<br>
+Huobao Drama is an AI-powered short-drama production platform that automates the entire pipeline: script generation, character design, storyboard breakdown, and video compositing.
+
+### 🎯 核心价值 / Core Value
+
+- **🤖 AI 驱动**：使用大语言模型解析剧本，提取角色、场景和分镜信息<br>
+  **🤖 AI-Driven**: LLMs parse scripts and extract characters, scenes, and storyboard information
+
+- **🎨 智能创作**：AI 绘图生成角色形象和场景背景<br>
+  **🎨 Intelligent Creation**: AI image generation for character designs and scene backgrounds
+
+- **📹 视频生成**：基于文生视频和图生视频模型自动生成分镜视频<br>
+  **📹 Video Generation**: Text-to-video and image-to-video models automatically produce storyboard clips
+
+- **🔄 工作流**：完整的短剧制作工作流，从创意到成片一站式完成<br>
+  **🔄 End-to-End Workflow**: A complete pipeline from idea to finished episode
+
+### 🛠️ 技术架构 / Architecture
+
+```
+frontend/   — Nuxt 3 + Vue 3 + TypeScript（纯 CSS，无 UI 框架 / pure CSS, no UI framework）
+backend/    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
+backend/workspace/skills/ — Agent 技能定义，支持界面在线编辑 / Agent skill definitions (SKILL.md), editable in the UI
+desktop/    — Electron 桌面版 / Electron desktop app（主进程 + esbuild + electron-builder / main process + esbuild + electron-builder）
+data/       — 生成资源文件与 SQLite 数据库 / Generated assets and the SQLite database
+```
+
+---
+
+## ✨ 功能特性 / Features
+
+### 🎭 角色管理 / Character Management
+
+- ✅ AI 生成角色形象<br>
+  ✅ AI-generated character designs
+
+- ✅ 批量角色生成<br>
+  ✅ Batch character generation
+
+- ✅ 角色图片上传和管理<br>
+  ✅ Character image upload and management
+
+### 🎬 视频任务 / Video Tasks
+
+- ✅ AI 自动生成视频任务<br>
+  ✅ Automatic AI video-task generation
+
+- ✅ 场景描述和视频提示词生成<br>
+  ✅ Scene descriptions and video prompt generation
+
+- ✅ 按任务批量生成视频<br>
+  ✅ Batch video generation per task
+
+### 🎥 视频生成 / Video Generation
+
+- ✅ 文生视频自动生成<br>
+  ✅ Text-to-video generation
+
+- ✅ FFmpeg 单镜头合成与字幕处理<br>
+  ✅ FFmpeg per-shot compositing and subtitle handling
+
+- ✅ 整集拼接导出<br>
+  ✅ Full-episode stitching and export
+
+### 📦 资源管理 / Asset Management
+
+- ✅ 素材库统一管理<br>
+  ✅ Unified asset library
+
+- ✅ 本地存储支持<br>
+  ✅ Local storage support
+
+- ✅ 任务进度追踪<br>
+  ✅ Task progress tracking
+
+### 🤖 AI Agents
+
+内置 4 个 Mastra Agent，支持数据库配置和 Skill 扩展：<br>
+Four built-in Mastra agents with database-backed configuration and Skill extensions:
+
+| Agent |职责<br>Role|
+|---|---|
+| `script_rewriter` |小说 → 格式化剧本改写<br>Novel → formatted script rewriting|
+| `extractor` |角色 / 场景 / 道具智能提取与去重<br>Intelligent extraction and dedup of characters / scenes / props|
+| `storyboard_breaker` |剧本 → 分镜序列拆解<br>Script → storyboard sequence breakdown|
+| `prompt_generator` |角色/场景/道具图片提示词 + 分镜视频提示词生成<br>Image prompts for characters/scenes/props + storyboard video prompts|
+
+### 🌐 多语言界面 / Multi-Language UI
+
+界面内置 **中文 / English / 日本語 / 한국어** 四种语言，并可全局设置 AI 生成内容的语言。<br>
+The interface ships in **中文 / English / 日本語 / 한국어**, with a global setting for AI-generated content language.
+
+### 🔌 多厂商适配 / Multi-Provider Support
+
+|类型<br>Type|支持厂商<br>Providers|
+|---|---|
+|**文本**<br>**Text**|OpenAI(兼容接口)、Gemini<br>OpenAI (compatible APIs), Gemini|
+|**图片**<br>**Image**|OpenAI、Gemini、火山引擎<br>OpenAI, Gemini, Volcano Engine|
+|**视频**<br>**Video**|火山引擎 Seedance 2.0(标准 / Fast / Mini)、MiniMax H3、阿里云百炼 Wan 3.0 (Prime / 标准)<br>Volcano Engine Seedance 2.0 (Standard / Fast / Mini), MiniMax H3, Alibaba Bailian Wan 3.0 (Prime / Standard)|
+
+---
+
+## 🚀 快速开始 / Quick Start
+
+### 📋 环境要求 / Requirements
+
+|软件<br>Software|版本要求<br>Version|说明<br>Notes|
+|---|---|---|
+| **Node.js** | 20+ |前后端运行环境<br>Runtime for frontend and backend|
+| **npm** | 9+ |包管理工具<br>Package manager|
+
+> **数据库零安装**：内置 SQLite（单文件，随项目数据目录存放），无需安装任何数据库服务。<br>
+> **Zero-install database**: Bundled SQLite (single file in the project data directory) — no database server required.
+
+> **FFmpeg 无需安装**：项目通过 `ffmpeg-static` / `ffprobe-static` npm 包内置二进制，开箱即用。<br>
+> **No FFmpeg install needed**: Binaries ship via the `ffmpeg-static` / `ffprobe-static` npm packages — works out of the box.
+
+### ⚙️ 环境变量 / Environment Variables
+
+无需配置文件，通过环境变量设置（均有默认值，本地开发可零配置启动）：<br>
+No config files — everything is set via environment variables (all have defaults; local dev needs zero configuration):
+
+|变量<br>Variable|默认值<br>Default|说明<br>Description|
+|---|---|---|
+| `SQLITE_PATH` |`<仓库根>/data/huobao.sqlite3`<br>`<repo>/data/huobao.sqlite3`|SQLite 数据库文件位置<br>SQLite database file location|
+| `PORT` | `5679` |后端服务端口<br>Backend service port|
+| `STORAGE_PATH` |`<仓库根>/data/static`<br>`<repo>/data/static`|生成文件存储目录<br>Generated-file storage directory|
+| `HUOBAO_DATA_DIR` | — |桌面版由 Electron 主进程注入（userData 数据根）<br>Injected by the Electron main process (userData data root)|
+| `WORKSPACE_PATH` | `backend/workspace` |Agent 技能/提示词目录（桌面版指向 userData 可写副本）<br>Agent skills/prompts directory (desktop: writable copy under userData)|
+| `FRONTEND_DIST` | `frontend/dist` |前端静态产物目录<br>Frontend static build directory|
+| `FFMPEG_BIN` / `FFPROBE_BIN` |npm 内置二进制<br>bundled npm binaries|自定义 ffmpeg/ffprobe 可执行文件路径<br>Custom ffmpeg/ffprobe executable paths|
+| `PUBLIC_BASE_URL` | — |Seedance 引用本地参考资源时所需的公网地址（服务器部署用）<br>Public URL Seedance needs to reference local assets (server deployments)|
+
+> **说明**：AI 服务的 API Key、Base URL 和模型参数全部在 Web 界面的「设置」页配置并入库，不在配置文件/环境变量中维护。<br>
+> **Note**: AI service API keys, base URLs, and model parameters are all configured in the web UI "Settings" page and stored in the database — never in config files or environment variables.
+
+### 📥 安装依赖 / Installation
+
+```bash
+# 克隆项目 / Clone the repository
+git clone https://github.com/chatfire-AI/huobao-drama.git
+cd huobao-drama
+
+# 安装后端依赖 / Install backend dependencies
+cd backend && npm install
+
+# 安装前端依赖 / Install frontend dependencies
+cd ../frontend && npm install
+```
+
+### 🎯 启动项目 / Running
+
+#### 方式一：开发模式（推荐） / Option 1: Development mode (recommended)
+
+前后端分离，支持热重载：<br>
+Frontend and backend run separately with hot reload:
+
+```bash
+# 终端1：启动后端 / Terminal 1: backend
+cd backend
+npm run dev
+
+# 终端2：启动前端 / Terminal 2: frontend
+cd frontend
+npm run dev
+```
+
+- 前端地址: `http://localhost:3013`<br>
+  Frontend: `http://localhost:3013`
+
+- 后端 API: `http://localhost:5679/api/v1`<br>
+  Backend API: `http://localhost:5679/api/v1`
+
+- 前端自动代理 `/api` 和 `/static` 到后端<br>
+  The frontend automatically proxies `/api` and `/static` to the backend
+
+#### 方式二：单服务模式 / Option 2: Single-service mode
+
+后端同时提供 API 和前端静态文件：<br>
+The backend serves both the API and the frontend static files:
+
+```bash
+# 1. 构建前端 / Build the frontend
+cd frontend && npm run generate
+
+# 2. 复制构建产物到后端读取的目录 / Copy the build output where the backend expects it
+# generate 产物在 .output/public，后端只读取 frontend/dist
+# generate outputs to .output/public; the backend reads frontend/dist
+cp -r .output/public dist
+
+# 3. 启动后端 / Start the backend
+cd ../backend && npm start
+```
+
+访问: `http://localhost:5679`<br>
+Visit: `http://localhost:5679`
+
+### 🗄️ 数据库 / Database
+
+内置 SQLite（`better-sqlite3` + WAL 模式），数据库表在首次启动时自动创建（幂等重放 DDL 与种子数据），默认文件位于 `data/huobao.sqlite3`，可通过 `SQLITE_PATH` 重定向。桌面版数据存放在用户数据目录（`~/Library/Application Support/HuobaoDrama/data/`）。<br>
+Bundled SQLite (`better-sqlite3` + WAL mode). Tables are created automatically on first launch (idempotent DDL replay + seed data). Default file: `data/huobao.sqlite3`, overridable via `SQLITE_PATH`. The desktop app stores data in the user-data directory (`~/Library/Application Support/HuobaoDrama/data/`).
+
+从旧版 MySQL 迁移数据：<br>
+Migrating data from a legacy MySQL deployment:
+
+**启动时自动迁移（推荐）**：显式配置了 MySQL（`DATABASE_URL` 或 `MYSQL_HOST`）且 SQLite 为空库时，后端启动会自动探测并一次性导入全部表（行数逐表校验、单事务原子写入、失败自动回滚并在下次启动重试、成功后写 `.mysql-imported` 标记避免重复）。设 `MYSQL_AUTO_IMPORT=false` 可关闭。<br>
+**Automatic migration on startup (recommended)**: When MySQL is explicitly configured (`DATABASE_URL` or `MYSQL_HOST`) and the SQLite database is empty, the backend automatically detects and imports all tables once (per-table row-count validation, single-transaction atomic writes, automatic rollback with retry on next launch, and a `.mysql-imported` marker to avoid re-importing). Set `MYSQL_AUTO_IMPORT=false` to disable.
+
+```bash
+# 也可手动执行（目标库非空需加 --force，写入前自动备份） / Or run manually (non-empty target requires --force; automatic backup before writing)
+cd backend && npx tsx scripts/import-mysql-to-sqlite.ts
+```
+
+> 迁移只覆盖数据库行；旧部署 `data/static/` 下的图片/视频等媒体文件需手动拷贝，否则历史素材无法访问。<br>
+> Migration covers database rows only; media files (images/videos) under the old deployment's `data/static/` must be copied manually, or historical assets won't load.
+
+### 🔑 首次使用：配置 AI 服务 / First Use: Configure AI Services
+
+启动后所有 AI 功能（文本/生图/视频）都需要先配置模型服务，未配置时页面顶部会有横幅引导：<br>
+All AI features (text/image/video) require model services to be configured first — a banner at the top of the page guides you until then:
+
+1. 打开「设置」页<br>
+   Open the "Settings" page
+
+2. 在「火宝快捷配置」中粘贴 Huobao API Key（[前往 api.firemux.cn 获取](https://api.firemux.cn)），一键写入文本、图片、视频三条推荐配置<br>
+   Paste your Huobao API key in "Huobao Quick Setup" ([get one at api.firemux.com](https://api.firemux.com)) to write three recommended configs (text, image, video) in one click
+
+3. 或使用「手动模板」按厂商逐个添加，支持连通性测试<br>
+   Or add providers one by one via "Manual Templates", with connectivity testing
+
+配置完成横幅自动消失，即可开始创建剧集生产。<br>
+Once configured, the banner disappears and you can start producing episodes.
+
+---
+
+## 📖 图文教程 / Visual Walkthrough
+
+从小说到成片的完整制作流程。左侧进度栏始终标示当前所处阶段，跟着走即可。<br>
+The complete pipeline from novel to finished episode. The left progress rail always shows where you are.
+
+### 第 1 步 · 创建项目 / Step 1 · Create a Project
+
+首页点「新建项目」，填写剧名并选择**画面比例**（横屏 16:9 / 竖屏 9:16，创建后不可改）与**画面风格**（3D / 真实感等，影响全局生图提示词）。<br>
+On the home page click "New Project", pick a **aspect ratio** (16:9 landscape / 9:16 portrait, fixed after creation) and a **visual style** (3D, realistic, … — injected into every image prompt).
+
+<p align="center">
+  <img src="docs/screenshots/02-create-drama.png" alt="新建项目 / Create a project" width="800">
+</p>
+
+项目卡片即项目列表，随时点入续作：
+
+<p align="center">
+  <img src="docs/screenshots/01-projects.png" alt="项目列表 / Project list" width="800">
+</p>
+
+### 第 2 步 · 配置 AI 服务（首次） / Step 2 · Configure AI Services (first run)
+
+设置页「火宝快捷配置」粘贴 API Key 一键写入三条推荐配置；或用「手动模板」按厂商自选模型（顶栏可随时切换当前模型，见第 5 步）。<br>
+Paste an API key in Settings → "Huobao Quick Setup" to write the three recommended configs at once, or add providers manually. The current model can be switched any time from the top bar (see Step 5).
+
+<p align="center">
+  <img src="docs/screenshots/03-settings-quick.png" alt="AI 服务配置 / AI service setup" width="800">
+</p>
+
+### 第 3 步 · 剧本阶段 / Step 3 · Script Stage
+
+进入剧集工作台，先粘贴**原始内容**（小说文本），再点「AI 改写」生成拍摄剧本——按集拆分、标注场景与角色，改写时可换文本模型、调语气。满意后「保存并进入制作」。<br>
+Paste your **source novel** into the workbench, then hit "AI Rewrite" to produce a shooting script — split by episode with scenes and characters annotated. You can switch text models and tone while rewriting.
+
+<p align="center">
+  <img src="docs/screenshots/05-script.png" alt="剧本阶段 / Script stage" width="800">
+</p>
+
+### 第 4 步 · 资产制作 / Step 4 · Assets
+
+对剧本执行**提取**，自动获得角色 / 场景 / 道具清单；逐个点「生成形象」产出一致性参考图（也可批量）。生成的资产图会在后续生视频时作为参考素材注入。<br>
+Run **extraction** on the script to get the character / scene / prop list, then generate a consistent reference image for each (or in batch). These images are injected as reference material when generating videos.
+
+<p align="center">
+  <img src="docs/screenshots/06-assets.png" alt="资产制作 / Asset production" width="800">
+</p>
+
+### 第 5 步 · 分镜与视频 / Step 5 · Storyboard & Videos
+
+「视频制作」页先**拆分分镜**（AI 按镜头节奏切分并生成视频提示词），然后：<br>
+On the "Video Production" page, first run **storyboard breakdown** (AI splits shots and writes video prompts). Then:
+
+- 顶栏选择本次使用的**视频模型**（Seedance / Wan 3.0 / MiniMax…），分辨率与时长档位随之联动<br>
+  Pick the **video model** in the top bar (Seedance / Wan 3.0 / MiniMax…); resolution and duration tiers follow the model
+
+- 右侧检查 / 微调每个分镜的提示词（`@角色名` 自动映射参考图）<br>
+  Review and tweak each shot's prompt on the right (`@character` references map to reference images automatically)
+
+- 点「批量生成视频」发起任务，失败任务可一键「重试失败」<br>
+  Click "Batch Generate Videos"; failed tasks can be retried in one click
+
+<p align="center">
+  <img src="docs/screenshots/07-storyboard.png" alt="分镜拆分 / Storyboard breakdown" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/08-videos.png" alt="视频生成 / Video generation" width="800">
+</p>
+
+### 第 6 步 · 拼接导出 / Step 6 · Merge & Export
+
+勾选镜头（悬停可预览单个镜头视频），点「开始拼接」，FFmpeg 自动合成为完整剧集成片，支持在线播放与下载。完成后点「标记完成」，左侧进度栏点亮。<br>
+Select shots (hover to preview each clip), click "Start Merging" and FFmpeg assembles the full episode — play online or download. Click "Mark Done" when finished to light up the progress rail.
+
+<p align="center">
+  <img src="docs/screenshots/09-export.png" alt="拼接导出 / Merge & export" width="800">
+</p>
+
+剧集列表随时展示各集制作状态，点「进入制作」继续未完成的集：<br>
+The episode list shows the production status of every episode — click "Enter Studio" to continue:
+
+<p align="center">
+  <img src="docs/screenshots/04-episodes.png" alt="剧集列表 / Episode list" width="800">
+</p>
+
+---
+
+## 📦 部署指南 / Deployment
+
+### 🖥️ 桌面应用（推荐） / Desktop App (recommended)
+
+**⬇️ 预编译安装包下载：[国内镜像（腾讯云，推荐）](https://installer.firemux.site/huobao-drama/v4.0.11/) · [GitHub Releases（海外）](https://github.com/chatfire-AI/huobao-drama/releases/latest)**<br>
+**⬇️ Prebuilt installers: [GitHub Releases](https://github.com/chatfire-AI/huobao-drama/releases/latest) · [Mirror for China (Tencent COS)](https://installer.firemux.site/huobao-drama/v4.0.11/)**
+
+|平台<br>Platform|下载文件<br>File to download|
+|---|---|
+|macOS（Apple Silicon，M 系列）<br>macOS (Apple Silicon, M-series)| `HuobaoDrama-4.0.5-arm64.dmg` |
+|macOS（Intel）<br>macOS (Intel)| `HuobaoDrama-4.0.5.dmg` |
+| Windows | `HuobaoDrama.Setup.4.0.5.exe` |
+
+> 国内用户请用腾讯云镜像直链下载（GitHub 在国内访问不稳定）。应用内更新器同样国内源优先、GitHub 兜底。<br>
+> China users: use the COS mirror above (GitHub is slow/unreachable in mainland China). The in-app updater also checks the COS mirror first, then falls back to GitHub.
+
+**命令行安装（推荐，免修复）**：用 curl 下载不会触发 macOS 隔离属性，安装后双击即开，不会遇到「已损坏」提示（Apple Silicon 把 `arm64` 文件名换成对应版本，Intel 用无后缀 dmg）：<br>
+**Command-line install (recommended, no Gatekeeper fix needed)**: downloading via curl never sets macOS's quarantine attribute, so the app opens cleanly with no "damaged" prompt (use the `-arm64.dmg` for Apple Silicon, the plain dmg for Intel):
+
+```bash
+curl -L -o /tmp/HuobaoDrama.dmg https://installer.firemux.site/huobao-drama/v4.0.11/HuobaoDrama-4.0.11-arm64.dmg \
+  && hdiutil attach -nobrowse /tmp/HuobaoDrama.dmg \
+  && cp -R /Volumes/HuobaoDrama*/HuobaoDrama.app /Applications/ \
+  && hdiutil detach /Volumes/HuobaoDrama*
+```
+
+无需构建 —— 下载 dmg/exe 直接安装即可，已安装客户端会通过内置更新器自动升级。（如需从源码自行打包，见下方命令。）<br>
+No build required — download the dmg/exe and install. Installed clients auto-update via the built-in updater. (To package from source instead, see the commands below.)
+
+双击安装、开箱即用的桌面版（macOS + Windows）：数据库（SQLite）、生成的媒体文件、Agent 技能全部存放在用户数据目录，卸载应用不影响数据。<br>
+Double-click to install, works out of the box (macOS + Windows): the SQLite database, generated media, and Agent skills all live in the user-data directory — uninstalling the app does not affect your data.
+
+```bash
+# 一键打包（前端 generate → 后端 esbuild → electron-builder） / One-command packaging (frontend generate → backend esbuild → electron-builder)
+npm run dist        # macOS dmg（arm64 + Intel） / macOS dmg (arm64 + Intel)
+npm run dist:win    # Windows NSIS 安装器（win-x64，可在 macOS 上交叉打包） / Windows NSIS installer (win-x64, cross-buildable on macOS)
+
+# 产物 / Artifacts
+# desktop/release/HuobaoDrama-<版本>-arm64.dmg        (Apple Silicon) / desktop/release/HuobaoDrama-<version>-arm64.dmg     (Apple Silicon)
+# desktop/release/HuobaoDrama-<版本>.dmg              (Intel) / desktop/release/HuobaoDrama-<version>.dmg           (Intel)
+# desktop/release/HuobaoDrama Setup <版本>.exe        (Windows) / desktop/release/HuobaoDrama Setup <version>.exe     (Windows)
+```
+
+安装说明：<br>
+Installation notes:
+
+- macOS 未签名包首次打开可能提示「App 已损坏，无法打开」（Apple Silicon 常见），这是 Gatekeeper 隔离属性导致，并非文件损坏。两种修复方式任选：<br>
+  The macOS build is unsigned — on first launch you may see "App is damaged and can't be opened" (common on Apple Silicon). This is Gatekeeper's quarantine attribute, not actual file damage. Two ways to fix it:
+
+  1. **dmg 内自带修复脚本**：把 app 拖入「应用程序」后，双击 dmg 窗口底部的「如提示已损坏请双击我.command」，自动完成修复；<br>
+     **The dmg bundles a fix script**: after dragging the app into Applications, double-click the "如提示已损坏请双击我.command" script at the bottom of the dmg window — it removes the quarantine attribute automatically;
+
+  2. 或终端执行 `sudo xattr -cr /Applications/HuobaoDrama.app`。<br>
+     Or run `sudo xattr -cr /Applications/HuobaoDrama.app` in Terminal.
+
+  修复只需一次，之后双击图标即可启动，应用内自动更新也不受影响。<br>
+  The fix is one-time only — the app then launches normally, and in-app auto-updates are not affected.
+
+- Windows 未签名包 SmartScreen 会提示「更多信息 → 仍要运行」<br>
+  The Windows build is unsigned — SmartScreen will prompt "More info → Run anyway"
+
+- 用户数据目录：`~/Library/Application Support/HuobaoDrama/`（数据库、生成的媒体、技能在线编辑的副本）<br>
+  User-data directory: `~/Library/Application Support/HuobaoDrama/` (database, generated media, writable copies of online-edited skills)
+
+- 内置 FFmpeg/FFprobe 二进制，无需系统安装<br>
+  FFmpeg/FFprobe binaries are bundled — no system install needed
+
+- Electron 锁定 37.x：better-sqlite3 的 win32 预编译最高覆盖到该版本的 ABI（交叉打包免编译的关键）<br>
+  Electron is pinned to 37.x: better-sqlite3's win32 prebuilds max out at that ABI (the key to compilation-free cross-packaging)
+
+- 应用内点击外部链接（如「前往 api.firemux.cn 获取 Key」）直接用系统浏览器打开<br>
+  External links open in the system browser (e.g. "Get a key at api.firemux.com")
+
+#### 🔄 应用内更新（无需 Apple 签名） / In-App Updates (no Apple signing required)
+
+桌面版内置更新器（与 Tauri 同类方案：macOS 目录替换 / Windows 静默安装，本地 sha256 校验）。发布新版流程：<br>
+The desktop app ships with a built-in updater (same class of solution as Tauri: directory replacement on macOS / silent installer on Windows, with local sha256 verification). To publish a new release:
+
+```bash
+# 1. 改 desktop/package.json 的 version，然后打包 / 1. Bump version in desktop/package.json, then package
+npm run dist        # macOS（产出 dmg + 更新用 zip） / macOS (produces dmg + update zip)
+npm run dist:win    # Windows（产出 Setup.exe） / Windows (produces Setup.exe)
+
+# 2. 生成版本清单 release/latest.json（含各平台产物 sha256） / 2. Generate the release manifest release/latest.json (with per-platform sha256)
+cd desktop && npm run feed
+
+# 3. 发布：把 latest.json + 安装包 + zip 上传到 GitHub Release（tag 形如 v1.0.1） / 3. Publish: upload latest.json + installers + zips to a GitHub Release (tag like v1.0.1)
+```
+
+已安装的客户端会在启动后自动检查清单（也可在「设置 → 关于更新」手动检查），发现新版即提示下载安装。自定义清单地址：`HUOBAO_UPDATE_FEED` 环境变量。<br>
+Installed clients check the manifest automatically after launch (manual check available in "Settings → About & Updates") and prompt to download and install when a new version is found. Override the manifest URL with the `HUOBAO_UPDATE_FEED` environment variable.
+
+桌面版开发调试：<br>
+Desktop development:
+
+```bash
+npm run build:frontend   # 前端静态产物（frontend/.output/public） / frontend static output (frontend/.output/public)
+cd desktop && npm run dev  # 打包后端 bundle 并以 Electron 窗口运行 / bundle the backend and run in an Electron window
+```
+
+> 已知限制：Seedance 视频模型引用本地参考资源时需要 `PUBLIC_BASE_URL` 公网地址，桌面版无公网入口，该场景会得到明确的中文报错；文生视频/图片等其余能力不受影响。<br>
+> Known limitation: Seedance video models need a `PUBLIC_BASE_URL` public address to reference local assets; the desktop app has no public entry point, so that scenario produces a clear error message. Text-to-video, image generation, and all other capabilities are unaffected.
+
+---
+
+### 🏭 服务器部署方式 / Server Deployment
+
+```bash
+# 1. 构建前端 / Build the frontend
+cd frontend && npm run generate
+
+# 2. 复制构建产物 / Copy the build output
+# generate 产物在 frontend/.output/public，后端只读取 frontend/dist，缺此步 API 正常但页面 404
+# generate outputs to frontend/.output/public; the backend reads frontend/dist — skip this step and the API works but pages 404
+cp -r .output/public dist && cd ..
+
+# 3. 启动后端 / Start the backend
+cd backend && npm start
+```
+
+需要上传到服务器的文件：<br>
+Files to upload to the server:
+
+```
+backend/                    # 后端源码 + node_modules / backend source + node_modules
+backend/workspace/skills/   # Agent 技能文件 / Agent skill files
+frontend/dist/              # 前端构建产物 / frontend build output
+data/                       # 数据目录（首次运行自动创建） / data directory (auto-created on first run)
+```
+
+#### Nginx 反向代理 / Nginx Reverse Proxy
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # 参考视频/音频上传最大 50MB / Max 50MB for reference video/audio uploads
+    client_max_body_size 100m;
+
+    # 生成的图片/视频直连磁盘，不经过 Node / Generated images/videos served straight from disk, bypassing Node
+    # sendfile 零拷贝 + 长缓存 / sendfile zero-copy + long-lived caching
+    # 产物按 uuid 命名、内容不变，可安全 immutable 缓存 / Files are uuid-named and immutable, so immutable caching is safe
+    location /static/ {
+        alias /path/to/huobao-drama/data/static/;
+        sendfile on;
+        tcp_nopush on;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
+    location / {
+        proxy_pass http://localhost:5679;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+}
+```
+
+> 媒体加载优化：生成图片时后端会自动产出 400px 缩略图（`*_thumb.webp`）供列表页加载，视频会抽取海报帧（`*_poster.jpg`）作为封面，前端仅在点开大图/播放时才加载原文件。历史存量文件可在 `backend/` 下执行 `npm run backfill-artwork` 一次性补齐。<br>
+> Media loading optimization: the backend automatically generates 400px thumbnails (`*_thumb.webp`) for list pages and extracts poster frames (`*_poster.jpg`) as video covers — the frontend only loads original files when opening the full image or playing. To backfill historical files, run `npm run backfill-artwork` under `backend/`.
+
+### 🐳 Docker 部署（含应用内更新） / Docker Deployment (with in-app updates)
+
+**方式一：预构建镜像（免克隆、免构建）**：多架构镜像（`linux/amd64` + `linux/arm64`），x86 服务器与 ARM 设备自动匹配<br>
+**Option A — prebuilt image (no clone, no build):** multi-arch (`linux/amd64` + `linux/arm64`), x86 servers and ARM devices match automatically
+
+```bash
+docker pull huobao/huobao-drama:4.0.6
+
+docker run -d \
+  --name huobao-drama \
+  -p 5679:5679 \
+  -v huobao-data:/app/data \
+  --restart unless-stopped \
+  huobao/huobao-drama:4.0.6
+```
+
+**方式二：docker compose（源码构建 + Watchtower 应用内更新）**：根目录提供一体化 `Dockerfile`（前端 generate + 后端依赖/运行时三阶段，后端与服务器部署一致走 tsx）与 `docker-compose.yml`（应用 + Watchtower）：<br>
+**Option B — docker compose (source build + Watchtower in-app updates):** the repo root provides an all-in-one `Dockerfile` (three stages: frontend generate + backend dependencies + runtime; the backend runs via tsx just like server deployment) and `docker-compose.yml` (app + Watchtower):
+
+```bash
+# 1. 配置环境（Watchtower 令牌，app 与 watchtower 两侧必须一致） / 1. Configure the environment (Watchtower token — must match on the app and watchtower sides)
+cp .env.example .env   # 修改 WATCHTOWER_TOKEN / edit WATCHTOWER_TOKEN
+
+# 2. 构建并启动（发布时注入版本号，供「关于更新」比对） / 2. Build and start (inject a version at publish time for "About & Updates" comparison)
+HUOBAO_VERSION=4.0.5 docker compose up -d --build
+
+# 3. 访问 http://localhost:5679 / 3. Visit http://localhost:5679
+```
+
+- **数据持久化**：命名卷 `huobao-data` 挂载 `/app/data`（SQLite + 生成的图片/视频 + workspace/skills，更新镜像不丢数据）<br>
+  **Data persistence**: the named volume `huobao-data` mounts `/app/data` (SQLite + generated images/videos + workspace/skills) — image updates don't lose data
+
+- **应用内更新**：compose 自带 [Watchtower](https://containrrr.dev/watchtower/) sidecar（`--label-enable` 只更新标记容器，`--cleanup` 清旧镜像，每天自检一次）。设置页「关于更新」可检查新版本并「立即更新」——后端经 Watchtower HTTP API 触发，拉新镜像重建容器，几分钟后刷新页面即可<br>
+  **In-app updates**: the compose file ships a [Watchtower](https://containrrr.dev/watchtower/) sidecar (`--label-enable` only updates labeled containers, `--cleanup` removes old images, daily self-check). "Settings → About & Updates" can check for new versions and "Update Now" — the backend triggers it via the Watchtower HTTP API, which pulls the new image and rebuilds the container; refresh the page after a few minutes
+
+- **手动模式**：`docker-compose.yml` 中删除 app 的 `HUOBAO_WATCHTOWER_*` 两个环境变量（或整个 watchtower 服务）后，「关于更新」退化为新版本提示 + 手动命令 `docker compose pull && docker compose up -d`<br>
+  **Manual mode**: remove the app's two `HUOBAO_WATCHTOWER_*` env vars (or the whole watchtower service) from `docker-compose.yml` — "About & Updates" then degrades to a new-version notice + manual `docker compose pull && docker compose up -d`
+
+- **发布镜像**：`docker buildx build --platform linux/amd64,linux/arm64 --build-arg HUOBAO_VERSION=x.y.z -t huobao/huobao-drama:x.y.z -t huobao/huobao-drama:latest --push .`，版本清单与桌面版共用 GitHub Releases 的 `latest.json`（可用 `HUOBAO_UPDATE_FEED` 覆盖）<br>
+  **Publishing images**: `docker buildx build --platform linux/amd64,linux/arm64 --build-arg HUOBAO_VERSION=x.y.z -t huobao/huobao-drama:x.y.z -t huobao/huobao-drama:latest --push .` — the version manifest is shared with the desktop app via `latest.json` on GitHub Releases (overridable with `HUOBAO_UPDATE_FEED`)
+
+---
+
+## 🎨 技术栈 / Tech Stack
+
+### 后端 / Backend
+
+- **运行时**: Node.js 20+<br>
+  **Runtime**: Node.js 20+
+
+- **Web 框架**: Hono<br>
+  **Web framework**: Hono
+
+- **ORM**: Drizzle ORM + better-sqlite3（WAL 模式）<br>
+  **ORM**: Drizzle ORM + better-sqlite3 (WAL mode)
+
+- **AI Agent**: Mastra + AI SDK (OpenAI compatible)<br>
+  **AI Agents**: Mastra + AI SDK (OpenAI compatible)
+
+- **视频处理**: FFmpeg (fluent-ffmpeg + 内置二进制)<br>
+  **Video processing**: FFmpeg (fluent-ffmpeg + bundled binaries)
+
+- **图片处理**: Sharp<br>
+  **Image processing**: Sharp
+
+### 桌面端 / Desktop
+
+- **壳**: Electron（utilityProcess 承载后端，BrowserWindow 同源加载）<br>
+  **Shell**: Electron (utilityProcess hosts the backend; BrowserWindow loads same-origin)
+
+- **打包**: esbuild（后端单文件 bundle）+ electron-builder（dmg arm64/x64，NSIS win-x64）<br>
+  **Packaging**: esbuild (single-file backend bundle) + electron-builder (dmg arm64/x64, NSIS win-x64)
+
+### 前端 / Frontend
+
+- **框架**: Nuxt 3 (SPA 模式)<br>
+  **Framework**: Nuxt 3 (SPA mode)
+
+- **语言**: Vue 3 + TypeScript<br>
+  **Language**: Vue 3 + TypeScript
+
+- **路由**: 文件路由 (Vue Router 4)<br>
+  **Routing**: File-based routing (Vue Router 4)
+
+- **样式**: 纯 CSS + CSS Variables<br>
+  **Styling**: Pure CSS + CSS Variables
+
+- **图标**: Lucide Vue<br>
+  **Icons**: Lucide Vue
+
+- **国际化**: vue-i18n（中文 / English / 日本語 / 한국어）<br>
+  **i18n**: vue-i18n (中文 / English / 日本語 / 한국어)
+
+---
+
+## 📝 常见问题 / FAQ
+
+### Q: 桌面版数据存在哪里？ / Q: Where does the desktop app store data?
+
+A: `~/Library/Application Support/HuobaoDrama/data/`（SQLite 数据库 + 生成的图片/视频），技能在线编辑的副本在同级 `workspace/` 目录。开发模式下则使用仓库 `data/` 目录。<br>
+A: `~/Library/Application Support/HuobaoDrama/data/` (SQLite database + generated images/videos); writable copies of online-edited skills live in the sibling `workspace/` directory. In development mode the repo's `data/` directory is used instead.
+
+### Q: 旧版 MySQL 数据怎么迁移到 SQLite？ / Q: How do I migrate legacy MySQL data to SQLite?
+
+A: 保持 MySQL 可连接（环境变量或 `backend/.env`），执行 `cd backend && npx tsx scripts/import-mysql-to-sqlite.ts`，脚本会自动建表、逐表导入并校验行数（目标库非空需加 `--force`，写入前自动备份）。<br>
+A: Keep MySQL reachable (environment variables or `backend/.env`), then run `cd backend && npx tsx scripts/import-mysql-to-sqlite.ts`. The script creates tables automatically, imports table-by-table, and validates row counts (non-empty targets require `--force`; a backup is made before writing).
+
+### Q: FFmpeg 未安装或找不到？ / Q: FFmpeg not installed or not found?
+
+A: 无需安装。项目内置 `ffmpeg-static` / `ffprobe-static` 二进制（桌面版随包携带）。系统 `PATH` 中的 FFmpeg 也不会冲突，也可通过 `FFMPEG_BIN`/`FFPROBE_BIN` 显式指定。<br>
+A: No install needed. The project bundles `ffmpeg-static` / `ffprobe-static` binaries (carried along in the desktop package). A system `PATH` FFmpeg won't conflict either, and you can point explicitly via `FFMPEG_BIN`/`FFPROBE_BIN`.
+
+### Q: 页面顶部提示「尚未配置模型」？ / Q: The top of the page says "No model configured"?
+
+A: 这是正常的首次部署引导。前往「设置」页，用「火宝快捷配置」粘贴 API Key 一键写入，或通过「手动模板」按厂商添加。文本、图片、视频三类均有启用中的配置后横幅自动消失。<br>
+A: That's the normal first-deploy guidance. Go to "Settings" and use "Huobao Quick Setup" to paste an API key and write configs in one click, or add providers via "Manual Templates". The banner disappears once text, image, and video all have an enabled config.
+
+### Q: 前端无法连接后端 API？ / Q: The frontend can't reach the backend API?
+
+A: 检查后端是否启动，端口是否正确。开发模式下前端代理配置在 `frontend/nuxt.config.ts`。<br>
+A: Check that the backend is running and the port is correct. In dev mode the proxy config lives in `frontend/nuxt.config.ts`.
+
+### Q: 数据库表未创建？ / Q: Database tables not created?
+
+A: 后端会在首次启动时自动创建所有表，检查日志确认初始化是否成功。<br>
+A: The backend creates all tables automatically on first launch — check the logs to confirm initialization succeeded.
+
+---
+
+## 📋 更新日志 / Changelog
+
+### v4.0.0 (2026-08)
+
+#### 🖥️ 桌面应用 + 数据库迁移 / Desktop App + Database Migration
+
+- Electron 桌面版（macOS dmg，arm64/x64 双架构）<br>
+  Electron desktop app (macOS dmg, arm64/x64 dual architecture)
+
+  - 双击安装、开箱即用：自动选择端口、单实例锁、崩溃隔离的后端子进程<br>
+    Double-click install, works out of the box: automatic port selection, single-instance lock, crash-isolated backend subprocess
+
+  - 用户数据隔离：SQLite 库 / 生成媒体 / 技能副本均存放于 userData 目录<br>
+    User-data isolation: SQLite database / generated media / skill copies all live in the userData directory
+
+  - 内置 FFmpeg/FFprobe 随包分发；workspace 技能模板首启动拷贝、升级只补缺不覆盖<br>
+    FFmpeg/FFprobe bundled; workspace skill templates copied on first launch, upgrades only fill gaps without overwriting
+
+- 数据库从 MySQL 完全迁移到 SQLite（better-sqlite3 + WAL）<br>
+  Database fully migrated from MySQL to SQLite (better-sqlite3 + WAL)
+
+  - 业务代码零改动（Drizzle 查询层天然可移植），DDL 幂等重放<br>
+    Zero business-code changes (the Drizzle query layer is naturally portable); idempotent DDL replay
+
+  - 新增一次性导入脚本 `import-mysql-to-sqlite.ts`（逐表行数校验 + 自动备份）<br>
+    New one-shot import script `import-mysql-to-sqlite.ts` (per-table row-count validation + automatic backup)
+
+- 后端 esbuild 单文件打包（externals：sharp/better-sqlite3/ffmpeg 二进制包）<br>
+  Backend bundled to a single file with esbuild (externals: sharp/better-sqlite3/ffmpeg binary packages)
+
+- 移除 Docker/MySQL 部署方式（git 历史可找回）<br>
+  Removed Docker/MySQL deployment (recoverable from git history)
+
+### v3.1.0 (2026-09)
+
+- 新增阿里云百炼 Wan 3.0 视频模型（Prime / 标准，支持官方 input.media/parameters 入参）<br>
+  Added Alibaba Bailian Wan 3.0 video models (Prime / Standard, official `input.media`/`parameters` payloads)
+
+- 工作台顶栏新增分辨率选择器，按厂商显示原生档位（Seedance 480p/720p、MiniMax 768P/2K、Wan 480P/720P/1080P）<br>
+  Resolution selector in the workbench top bar with native tiers per provider (Seedance 480p/720p, MiniMax 768P/2K, Wan 480P/720P/1080P)
+
+- 默认视频模型调整为 Seedance 2.0 Mini<br>
+  Default video model changed to Seedance 2.0 Mini
+
+- 修复切换视频模型时厂商/模型错配导致的生成报错<br>
+  Fixed generation errors caused by provider/model mismatch when switching video models
+
+- 批量视频：选择模式 + 生成前确认（镜头数/总时长/模型/分辨率），失败任务一键重试<br>
+  Batch video: selection mode + pre-generation confirmation (shot count / total duration / model / resolution), one-click retry for failed tasks
+
+- 分镜时长在视频生成参数区直接编辑保存，单次/批量生成统一生效<br>
+  Storyboard duration now editable directly in the video-generation params area, applied to single and batch generation
+
+- 真人/敏感内容审核失败时提示切换模型重试<br>
+  Content-moderation failures (real-person / sensitive content) now prompt to switch models and retry
+
+### v3.0.0 (2026-08)
+
+#### 🚀 部署与体验优化 / Deployment & Experience Improvements
+
+- Docker 部署就绪改造<br>
+  Docker deployment readiness
+
+  - MySQL / 应用健康检查，应用等待数据库就绪后启动<br>
+    MySQL / app health checks; the app waits for the database before starting
+
+  - 数据库初始化增加重试，容器编排下首次部署零人工干预<br>
+    Database initialization retries — zero manual intervention on first containerized deploy
+
+  - 移除系统 FFmpeg 依赖，全面使用内置二进制<br>
+    Removed the system FFmpeg dependency; bundled binaries everywhere
+
+  - Agent skills 目录 volume 持久化（设置页在线编辑不丢失）<br>
+    Agent skills directory volume persistence (online edits in Settings survive)
+
+  - 新增 `docker/init.sql` 及导出脚本（DBA 审核 / 预建表）<br>
+    New `docker/init.sql` and export scripts (DBA review / pre-created tables)
+
+- 首次使用引导<br>
+  First-use guidance
+
+  - 未配置 AI 服务时全站顶部横幅提示并引导至设置页<br>
+    Site-wide banner guiding to Settings when no AI service is configured
+
+  - 设置页新增「火宝快捷配置」：一个 Key 写入文本/图片/视频三条推荐配置<br>
+    New "Huobao Quick Setup" in Settings: one key writes three recommended configs (text/image/video)
+
+  - 未配置模型的报错中文化并指引设置页<br>
+    Unconfigured-model errors localized with pointers to Settings
+
+- 视频模型默认调整为 Seedance 2.0 Fast<br>
+  Default video model changed to Seedance 2.0 Fast
+
+- 厂商收敛：仅保留 OpenAI / Gemini / 火山引擎<br>
+  Provider consolidation: OpenAI / Gemini / Volcano Engine only
+
+- 工作台：任务列表抽屉、流水线大环节状态、选择性拼接（拼接前校验视频文件存在）<br>
+  Workbench: task-list drawer, pipeline stage status, selective stitching (validates video files exist before merging)
+
+- 素材库改版、@提及优化、剧集列表重构<br>
+  Asset library redesign, @mention improvements, episode list rework
+
+### v2.0.0 (2026-04)
+
+#### 🚀 重大更新 / Major Update
+
+- 项目全面迁移至 TypeScript 技术栈<br>
+  Full migration to a TypeScript stack
+
+  - 后端：Hono + Drizzle ORM + mysql2<br>
+    Backend: Hono + Drizzle ORM + mysql2
+
+  - 前端：Nuxt 3 + Vue 3<br>
+    Frontend: Nuxt 3 + Vue 3
+
+  - AI Agent：Mastra 框架<br>
+    AI Agents: Mastra framework
+
+- 重做单集工作台 UI 和生产流程<br>
+  Episode workbench UI and production flow rebuilt
+
+  - 更紧凑的控制台布局<br>
+    More compact console layout
+
+  - 重做分镜编辑区<br>
+    Storyboard editing area rebuilt
+
+  - 重做镜头图、视频、合成、导出界面<br>
+    Shot image, video, compositing, and export screens rebuilt
+
+- 新增 Docker 部署支持，前后端合并为单镜像<br>
+  Docker deployment support — frontend and backend merged into a single image
+
+- 增加运行时 Skill 加载机制<br>
+  Runtime Skill loading mechanism
+
+- 扩展多厂商媒体 Adapter<br>
+  Expanded multi-provider media adapters
+
+  - 图片：OpenAI、Gemini、火山引擎、阿里<br>
+    Image: OpenAI, Gemini, Volcano Engine, Alibaba
+
+  - 视频：火山引擎/Seedance、Vidu、阿里<br>
+    Video: Volcano Engine/Seedance, Vidu, Alibaba
+
+- 优化本地文件处理与参考图按需转码<br>
+  Improved local file handling and on-demand reference-image transcoding
+
+### v1.0.4 (2026-01-27)
+
+- 引入本地存储策略，规避外部资源链接失效<br>
+  Local storage strategy to avoid dead external asset links
+
+- Base64 参考图嵌入式传输<br>
+  Base64 reference-image embedded transport
+
+- 修复镜头切换状态重置问题<br>
+  Fixed shot-switch state reset
+
+- 添加场景迁移至章节<br>
+  Scene migration to chapters
+
+### v1.0.3 (2026-01-16)
+
+- 优化数据库并发访问性能<br>
+  Database concurrency performance improvements
+
+- Docker 跨平台支持 host.docker.internal<br>
+  Docker cross-platform support for host.docker.internal
+
+### v1.0.2 (2026-01-14)
+
+- 修复视频生成 API 响应解析问题<br>
+  Fixed video-generation API response parsing
+
+- 添加 OpenAI Sora 视频端点配置<br>
+  OpenAI Sora video endpoint configuration
+
+- 优化错误处理和日志输出<br>
+  Improved error handling and logging
+
+---
+
+## 📄 许可证 / License
+
+本项目采用 **[CC BY-NC-SA 4.0](LICENSE)**（署名-非商业性使用-相同方式共享 4.0 国际）许可证。<br>
+This project is licensed under **[CC BY-NC-SA 4.0](LICENSE)** (Attribution-NonCommercial-ShareAlike 4.0 International).
+
+- ✅ 个人使用、学习研究、非商业项目均可自由使用<br>
+  ✅ Personal use, learning, and non-commercial projects are welcome
+
+- ✅ 允许修改与再分发，但须署名并以相同许可证共享<br>
+  ✅ Modifications and redistribution allowed under the same license with attribution
+
+- ❌ **禁止商用**——未经作者书面许可，不得将本项目整体或部分用于任何商业目的（包括付费服务、商业部署、转售等）<br>
+  ❌ **Commercial use is prohibited** — you may not use this project, in whole or in part, for any commercial purpose (including paid services, commercial deployments, or resale) without prior written permission from the author
+
+许可证全文见 [LICENSE](LICENSE)。<br>
+Full license text: see [LICENSE](LICENSE).
+
+---
+
+## 🤝 贡献指南 / Contributing
+
+欢迎提交 Issue 和 Pull Request！<br>
+Issues and Pull Requests are welcome!
+
+1. Fork 本项目<br>
+   Fork the project
+
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)<br>
+   Create a feature branch (`git checkout -b feature/AmazingFeature`)
+
+3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)<br>
+   Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+
+4. 推送到分支 (`git push origin feature/AmazingFeature`)<br>
+   Push to the branch (`git push origin feature/AmazingFeature`)
+
+5. 开启 Pull Request<br>
+   Open a Pull Request
+
+常用检查命令：<br>
+Common checks:
+
+```bash
+cd backend && npm run typecheck
+cd ../frontend && npm run build
+```
+
+---
+
+## 💬 微信群 / WeChat Group
+
+扫码加入微信群交流：<br>
+Scan the QR code to join the WeChat group:
+
+<div align="center">
+  <img src="docs/images/wx-group.png" width="200" alt="微信群二维码 / WeChat group QR code" />
+</div>
+
+---
+
+> _"让 AI 帮我们做更有创造力的事"_<br>
+> _"Let AI do the creating with us"_
+
+## 🔗 友情链接 / Links
+
+本项目已获得 [LINUX DO](https://linux.do/) 社区链接认可。<br>
+This project has been recognized with a link from the [LINUX DO](https://linux.do/) community.
+
+- [LINUX DO](https://linux.do/) — 真正的开源精神，共建共享的技术社区<br>
+  [LINUX DO](https://linux.do/) — a genuine open-source spirit, a community built on sharing
+
+---
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/chart?repos=chatfire-ai/huobao-drama&type=date&legend=top-left)](https://www.star-history.com/?repos=chatfire-ai%2Fhuobao-drama&type=date&legend=top-left)
diff --git a/huobao-source/README.zh-CN.md b/huobao-source/README.zh-CN.md
new file mode 100644
index 0000000..14527f2
--- /dev/null
+++ b/huobao-source/README.zh-CN.md
@@ -0,0 +1,638 @@
+# 🎬 Huobao Drama - AI 短剧生成平台
+
+<div align="center">
+
+**基于 TypeScript 全栈的 AI 短剧自动化生产平台**
+
+[![Node Version](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org)
+[![Vue Version](https://img.shields.io/badge/Vue-3.x-4FC08D?style=flat&logo=vue.js)](https://vuejs.org)
+[![License](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+[![下载](https://img.shields.io/github/v/release/chatfire-AI/huobao-drama?style=flat&logo=github&label=%E4%B8%8B%E8%BD%BD)](https://github.com/chatfire-AI/huobao-drama/releases/latest)
+
+[中英双语](README.md) | **简体中文** | [English](README.en.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
+
+[功能特性](#-功能特性) • [快速开始](#-快速开始) • [图文教程](#-图文教程) • [桌面版](#-桌面应用推荐) • [部署指南](#-部署指南)
+
+<h2>🔑 <a href="https://api.firemux.cn">获取 Huobao API Key 👉 立即查看</a></h2>
+
+**文本 · 图片 · 视频全部 AI 能力，一个 Key 即可开通**
+
+部署完成后在「设置 → 火宝快捷配置」粘贴 Key，一键写入三条推荐配置，开箱即用
+
+<h3>📥 <a href="https://github.com/chatfire-AI/huobao-drama/releases/latest">下载桌面版（macOS / Windows）</a></h3>
+<h3>🌐 <a href="https://www.firemux.cn">官方网站</a></h3>
+
+</div>
+
+---
+
+## 📖 项目简介
+
+Huobao Drama 是一个基于 AI 的短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。
+
+### 🎯 核心价值
+
+- **🤖 AI 驱动**：使用大语言模型解析剧本，提取角色、场景和分镜信息
+- **🎨 智能创作**：AI 绘图生成角色形象和场景背景
+- **📹 视频生成**：基于文生视频和图生视频模型自动生成分镜视频
+- **🔄 工作流**：完整的短剧制作工作流，从创意到成片一站式完成
+
+### 🛠️ 技术架构
+
+```
+frontend/   — Nuxt 3 + Vue 3 + TypeScript (纯 CSS，无 UI 框架)
+backend/    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
+backend/workspace/skills/ — Agent 技能定义 (SKILL.md，支持界面在线编辑)
+desktop/    — Electron 桌面版（主进程 + esbuild 打包 + electron-builder 出 dmg/exe）
+data/       — 生成资源文件与 SQLite 数据库
+```
+
+---
+
+## ✨ 功能特性
+
+### 🎭 角色管理
+
+- ✅ AI 生成角色形象
+- ✅ 批量角色生成
+- ✅ 角色图片上传和管理
+
+### 🎬 视频任务
+
+- ✅ AI 自动生成视频任务
+- ✅ 场景描述和视频提示词生成
+- ✅ 按任务批量生成视频
+
+### 🎥 视频生成
+
+- ✅ 文生视频自动生成
+- ✅ FFmpeg 单镜头合成与字幕处理
+- ✅ 整集拼接导出
+
+### 📦 资源管理
+
+- ✅ 素材库统一管理
+- ✅ 本地存储支持
+- ✅ 任务进度追踪
+
+### 🤖 AI Agents
+
+内置 4 个 Mastra Agent，支持数据库配置和 Skill 扩展：
+
+| Agent | 职责 |
+|---|---|
+| `script_rewriter` | 小说 → 格式化剧本改写 |
+| `extractor` | 角色 / 场景 / 道具智能提取与去重 |
+| `storyboard_breaker` | 剧本 → 分镜序列拆解 |
+| `prompt_generator` | 角色/场景/道具图片提示词 + 分镜视频提示词生成 |
+
+### 🌐 多语言界面
+
+界面内置 **中文 / English / 日本語 / 한국어** 四种语言，并可全局设置 AI 生成内容的语言。
+
+### 🔌 多厂商适配
+
+| 类型 | 支持厂商 |
+|---|---|
+| **文本** | OpenAI(兼容接口)、Gemini |
+| **图片** | OpenAI、Gemini、火山引擎 |
+| **视频** | 火山引擎 Seedance 2.0(标准 / Fast / Mini)、MiniMax H3、阿里云百炼 Wan 3.0 (Prime / 标准) |
+
+---
+
+## 🚀 快速开始
+
+### 📋 环境要求
+
+| 软件 | 版本要求 | 说明 |
+|---|---|---|
+| **Node.js** | 20+ | 前后端运行环境 |
+| **npm** | 9+ | 包管理工具 |
+
+> **数据库零安装**：内置 SQLite（单文件，随项目数据目录存放），无需安装任何数据库服务。
+> **FFmpeg 无需安装**：项目通过 `ffmpeg-static` / `ffprobe-static` npm 包内置二进制，开箱即用。
+
+### ⚙️ 环境变量
+
+无需配置文件，通过环境变量设置（均有默认值，本地开发可零配置启动）：
+
+| 变量 | 默认值 | 说明 |
+|---|---|---|
+| `SQLITE_PATH` | `<仓库根>/data/huobao.sqlite3` | SQLite 数据库文件位置 |
+| `PORT` | `5679` | 后端服务端口 |
+| `STORAGE_PATH` | `<仓库根>/data/static` | 生成文件存储目录 |
+| `HUOBAO_DATA_DIR` | — | 桌面版由 Electron 主进程注入（userData 数据根） |
+| `WORKSPACE_PATH` | `backend/workspace` | Agent 技能/提示词目录（桌面版指向 userData 可写副本） |
+| `FRONTEND_DIST` | `frontend/dist` | 前端静态产物目录 |
+| `FFMPEG_BIN` / `FFPROBE_BIN` | npm 内置二进制 | 自定义 ffmpeg/ffprobe 可执行文件路径 |
+| `PUBLIC_BASE_URL` | — | Seedance 引用本地参考资源时所需的公网地址（服务器部署用） |
+
+> **说明**：AI 服务的 API Key、Base URL 和模型参数全部在 Web 界面的「设置」页配置并入库，不在配置文件/环境变量中维护。
+
+### 📥 安装依赖
+
+```bash
+# 克隆项目
+git clone https://github.com/chatfire-AI/huobao-drama.git
+cd huobao-drama
+
+# 安装后端依赖
+cd backend && npm install
+
+# 安装前端依赖
+cd ../frontend && npm install
+```
+
+### 🎯 启动项目
+
+#### 方式一：开发模式（推荐）
+
+前后端分离，支持热重载：
+
+```bash
+# 终端1：启动后端
+cd backend
+npm run dev
+
+# 终端2：启动前端
+cd frontend
+npm run dev
+```
+
+- 前端地址: `http://localhost:3013`
+- 后端 API: `http://localhost:5679/api/v1`
+- 前端自动代理 `/api` 和 `/static` 到后端
+
+#### 方式二：单服务模式
+
+后端同时提供 API 和前端静态文件：
+
+```bash
+# 1. 构建前端
+cd frontend && npm run generate
+
+# 2. 复制构建产物到后端读取的目录（generate 产物在 .output/public，后端只读取 frontend/dist）
+cp -r .output/public dist
+
+# 3. 启动后端
+cd ../backend && npm start
+```
+
+访问: `http://localhost:5679`
+
+### 🗄️ 数据库
+
+内置 SQLite（`better-sqlite3` + WAL 模式），数据库表在首次启动时自动创建（幂等重放 DDL 与种子数据），默认文件位于 `data/huobao.sqlite3`，可通过 `SQLITE_PATH` 重定向。桌面版数据存放在用户数据目录（`~/Library/Application Support/HuobaoDrama/data/`）。
+
+从旧版 MySQL 迁移数据：
+
+**启动时自动迁移（推荐）**：显式配置了 MySQL（`DATABASE_URL` 或 `MYSQL_HOST`）且 SQLite 为空库时，后端启动会自动探测并一次性导入全部表（行数逐表校验、单事务原子写入、失败自动回滚并在下次启动重试、成功后写 `.mysql-imported` 标记避免重复）。设 `MYSQL_AUTO_IMPORT=false` 可关闭。
+
+```bash
+# 也可手动执行（目标库非空需加 --force，写入前自动备份）
+cd backend && npx tsx scripts/import-mysql-to-sqlite.ts
+```
+
+> 迁移只覆盖数据库行；旧部署 `data/static/` 下的图片/视频等媒体文件需手动拷贝，否则历史素材无法访问。
+
+### 🔑 首次使用：配置 AI 服务
+
+启动后所有 AI 功能（文本/生图/视频）都需要先配置模型服务，未配置时页面顶部会有横幅引导：
+
+1. 打开「设置」页
+2. 在「火宝快捷配置」中粘贴 Huobao API Key（[前往 api.firemux.cn 获取](https://api.firemux.cn)），一键写入文本、图片、视频三条推荐配置
+3. 或使用「手动模板」按厂商逐个添加，支持连通性测试
+
+配置完成横幅自动消失，即可开始创建剧集生产。
+
+---
+
+## 📖 图文教程
+
+从小说到成片的完整制作流程。左侧进度栏始终标示当前所处阶段，跟着走即可。
+
+### 第 1 步 · 创建项目
+
+首页点「新建项目」，填写剧名并选择**画面比例**（横屏 16:9 / 竖屏 9:16，创建后不可改）与**画面风格**（3D / 真实感等，影响全局生图提示词）。
+
+<p align="center">
+  <img src="docs/screenshots/02-create-drama.png" alt="新建项目" width="800">
+</p>
+
+项目卡片即项目列表，随时点入续作：
+
+<p align="center">
+  <img src="docs/screenshots/01-projects.png" alt="项目列表" width="800">
+</p>
+
+### 第 2 步 · 配置 AI 服务（首次）
+
+设置页「火宝快捷配置」粘贴 API Key 一键写入三条推荐配置；或用「手动模板」按厂商自选模型（顶栏可随时切换当前模型，见第 5 步）。
+
+<p align="center">
+  <img src="docs/screenshots/03-settings-quick.png" alt="AI 服务配置" width="800">
+</p>
+
+### 第 3 步 · 剧本阶段
+
+进入剧集工作台，先粘贴**原始内容**（小说文本），再点「AI 改写」生成拍摄剧本——按集拆分、标注场景与角色，改写时可换文本模型、调语气。满意后「保存并进入制作」。
+
+<p align="center">
+  <img src="docs/screenshots/05-script.png" alt="剧本阶段" width="800">
+</p>
+
+### 第 4 步 · 资产制作
+
+对剧本执行**提取**，自动获得角色 / 场景 / 道具清单；逐个点「生成形象」产出一致性参考图（也可批量）。生成的资产图会在后续生视频时作为参考素材注入。
+
+<p align="center">
+  <img src="docs/screenshots/06-assets.png" alt="资产制作" width="800">
+</p>
+
+### 第 5 步 · 分镜与视频
+
+「视频制作」页先**拆分分镜**（AI 按镜头节奏切分并生成视频提示词），然后：
+
+- 顶栏选择本次使用的**视频模型**（Seedance / Wan 3.0 / MiniMax…），分辨率与时长档位随之联动
+- 右侧检查 / 微调每个分镜的提示词（`@角色名` 自动映射参考图）
+- 点「批量生成视频」发起任务，失败任务可一键「重试失败」
+
+<p align="center">
+  <img src="docs/screenshots/07-storyboard.png" alt="分镜拆分" width="800">
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/08-videos.png" alt="视频生成" width="800">
+</p>
+
+### 第 6 步 · 拼接导出
+
+勾选镜头（悬停可预览单个镜头视频），点「开始拼接」，FFmpeg 自动合成为完整剧集成片，支持在线播放与下载。完成后点「标记完成」，左侧进度栏点亮。
+
+<p align="center">
+  <img src="docs/screenshots/09-export.png" alt="拼接导出" width="800">
+</p>
+
+剧集列表随时展示各集制作状态，点「进入制作」继续未完成的集：
+
+<p align="center">
+  <img src="docs/screenshots/04-episodes.png" alt="剧集列表" width="800">
+</p>
+
+---
+
+## 📦 部署指南
+
+### 🖥️ 桌面应用（推荐）
+
+**⬇️ 预编译安装包下载：[国内镜像（腾讯云，推荐）](https://installer.firemux.site/huobao-drama/v4.0.11/) · [GitHub Releases（海外）](https://github.com/chatfire-AI/huobao-drama/releases/latest)**
+
+| 平台 | 下载文件 |
+|---|---|
+| macOS（Apple Silicon，M 系列） | `HuobaoDrama-4.0.5-arm64.dmg` |
+| macOS（Intel） | `HuobaoDrama-4.0.5.dmg` |
+| Windows | `HuobaoDrama.Setup.4.0.5.exe` |
+
+> 国内用户请用腾讯云镜像直链下载（GitHub 在国内访问不稳定）。应用内更新器同样国内源优先、GitHub 兜底。
+
+**命令行安装（推荐，免修复）**：用 curl 下载不会触发 macOS 隔离属性，安装后双击即开，不会遇到「已损坏」提示（Apple Silicon 把 `arm64` 文件名换成对应版本，Intel 用无后缀 dmg）：
+
+```bash
+curl -L -o /tmp/HuobaoDrama.dmg https://installer.firemux.site/huobao-drama/v4.0.11/HuobaoDrama-4.0.11-arm64.dmg \
+  && hdiutil attach -nobrowse /tmp/HuobaoDrama.dmg \
+  && cp -R /Volumes/HuobaoDrama*/HuobaoDrama.app /Applications/ \
+  && hdiutil detach /Volumes/HuobaoDrama*
+```
+
+无需构建 —— 下载 dmg/exe 直接安装即可，已安装客户端会通过内置更新器自动升级。（如需从源码自行打包，见下方命令。）
+
+双击安装、开箱即用的桌面版（macOS + Windows）：数据库（SQLite）、生成的媒体文件、Agent 技能全部存放在用户数据目录，卸载应用不影响数据。
+
+```bash
+# 一键打包（前端 generate → 后端 esbuild → electron-builder）
+npm run dist        # macOS dmg（arm64 + Intel）
+npm run dist:win    # Windows NSIS 安装器（win-x64，可在 macOS 上交叉打包）
+
+# 产物
+# desktop/release/HuobaoDrama-<版本>-arm64.dmg        (Apple Silicon)
+# desktop/release/HuobaoDrama-<版本>.dmg              (Intel)
+# desktop/release/HuobaoDrama Setup <版本>.exe        (Windows)
+```
+
+安装说明：
+
+- macOS 未签名包首次打开可能提示「App 已损坏，无法打开」（Apple Silicon 常见），这是 Gatekeeper 隔离属性导致，并非文件损坏。两种修复方式任选：
+  1. **dmg 内自带修复脚本**：把 app 拖入「应用程序」后，双击 dmg 窗口底部的「如提示已损坏请双击我.command」，自动完成修复；
+  2. 或终端执行 `sudo xattr -cr /Applications/HuobaoDrama.app`。
+
+  修复只需一次，之后双击图标即可启动，应用内自动更新也不受影响。
+- Windows 未签名包 SmartScreen 会提示「更多信息 → 仍要运行」
+- 用户数据目录：`~/Library/Application Support/HuobaoDrama/`（数据库、生成的媒体、技能在线编辑的副本）
+- 内置 FFmpeg/FFprobe 二进制，无需系统安装
+- Electron 锁定 37.x：better-sqlite3 的 win32 预编译最高覆盖到该版本的 ABI（交叉打包免编译的关键）
+- 应用内点击外部链接（如「前往 api.firemux.cn 获取 Key」）直接用系统浏览器打开
+
+#### 🔄 应用内更新（无需 Apple 签名）
+
+桌面版内置更新器（与 Tauri 同类方案：macOS 目录替换 / Windows 静默安装，本地 sha256 校验）。发布新版流程：
+
+```bash
+# 1. 改 desktop/package.json 的 version，然后打包
+npm run dist        # macOS（产出 dmg + 更新用 zip）
+npm run dist:win    # Windows（产出 Setup.exe）
+
+# 2. 生成版本清单 release/latest.json（含各平台产物 sha256）
+cd desktop && npm run feed
+
+# 3. 发布：把 latest.json + 安装包 + zip 上传到 GitHub Release（tag 形如 v1.0.1）
+```
+
+已安装的客户端会在启动后自动检查清单（也可在「设置 → 关于更新」手动检查），发现新版即提示下载安装。自定义清单地址：`HUOBAO_UPDATE_FEED` 环境变量。
+
+桌面版开发调试：
+
+```bash
+npm run build:frontend   # 前端静态产物（frontend/.output/public）
+cd desktop && npm run dev  # 打包后端 bundle 并以 Electron 窗口运行
+```
+
+> 已知限制：Seedance 视频模型引用本地参考资源时需要 `PUBLIC_BASE_URL` 公网地址，桌面版无公网入口，该场景会得到明确的中文报错；文生视频/图片等其余能力不受影响。
+
+---
+
+### 🏭 服务器部署方式
+
+```bash
+# 1. 构建前端
+cd frontend && npm run generate
+
+# 2. 复制构建产物（generate 产物在 frontend/.output/public，后端只读取 frontend/dist，缺此步 API 正常但页面 404）
+cp -r .output/public dist && cd ..
+
+# 3. 启动后端
+cd backend && npm start
+```
+
+需要上传到服务器的文件：
+
+```
+backend/                    # 后端源码 + node_modules
+backend/workspace/skills/   # Agent 技能文件
+frontend/dist/              # 前端构建产物
+data/                       # 数据目录（首次运行自动创建）
+```
+
+#### Nginx 反向代理
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # 参考视频/音频上传最大 50MB
+    client_max_body_size 100m;
+
+    # 生成的图片/视频直连磁盘，不经过 Node：sendfile 零拷贝 + 长缓存
+    # （产物按 uuid 命名、内容不变，可安全 immutable 缓存）
+    location /static/ {
+        alias /path/to/huobao-drama/data/static/;
+        sendfile on;
+        tcp_nopush on;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
+    location / {
+        proxy_pass http://localhost:5679;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+}
+```
+
+> 媒体加载优化：生成图片时后端会自动产出 400px 缩略图（`*_thumb.webp`）供列表页加载，视频会抽取海报帧（`*_poster.jpg`）作为封面，前端仅在点开大图/播放时才加载原文件。历史存量文件可在 `backend/` 下执行 `npm run backfill-artwork` 一次性补齐。
+
+### 🐳 Docker 部署（含应用内更新）
+
+**方式一：预构建镜像（免克隆、免构建）**：多架构镜像（`linux/amd64` + `linux/arm64`），x86 服务器与 ARM 设备自动匹配
+
+```bash
+docker pull huobao/huobao-drama:4.0.6
+
+docker run -d \
+  --name huobao-drama \
+  -p 5679:5679 \
+  -v huobao-data:/app/data \
+  --restart unless-stopped \
+  huobao/huobao-drama:4.0.6
+```
+
+**方式二：docker compose（源码构建 + Watchtower 应用内更新）**：根目录提供一体化 `Dockerfile`（前端 generate + 后端依赖/运行时三阶段，后端与服务器部署一致走 tsx）与 `docker-compose.yml`（应用 + Watchtower）：
+
+```bash
+# 1. 配置环境（Watchtower 令牌，app 与 watchtower 两侧必须一致）
+cp .env.example .env   # 修改 WATCHTOWER_TOKEN
+
+# 2. 构建并启动（发布时注入版本号，供「关于更新」比对）
+HUOBAO_VERSION=4.0.5 docker compose up -d --build
+
+# 3. 访问 http://localhost:5679
+```
+
+- **数据持久化**：命名卷 `huobao-data` 挂载 `/app/data`（SQLite + 生成的图片/视频 + workspace/skills，更新镜像不丢数据）
+- **应用内更新**：compose 自带 [Watchtower](https://containrrr.dev/watchtower/) sidecar（`--label-enable` 只更新标记容器，`--cleanup` 清旧镜像，每天自检一次）。设置页「关于更新」可检查新版本并「立即更新」——后端经 Watchtower HTTP API 触发，拉新镜像重建容器，几分钟后刷新页面即可
+- **手动模式**：`docker-compose.yml` 中删除 app 的 `HUOBAO_WATCHTOWER_*` 两个环境变量（或整个 watchtower 服务）后，「关于更新」退化为新版本提示 + 手动命令 `docker compose pull && docker compose up -d`
+- **发布镜像**：`docker buildx build --platform linux/amd64,linux/arm64 --build-arg HUOBAO_VERSION=x.y.z -t huobao/huobao-drama:x.y.z -t huobao/huobao-drama:latest --push .`，版本清单与桌面版共用 GitHub Releases 的 `latest.json`（可用 `HUOBAO_UPDATE_FEED` 覆盖）
+
+---
+
+## 🎨 技术栈
+
+### 后端
+
+- **运行时**: Node.js 20+
+- **Web 框架**: Hono
+- **ORM**: Drizzle ORM + better-sqlite3（WAL 模式）
+- **AI Agent**: Mastra + AI SDK (OpenAI compatible)
+- **视频处理**: FFmpeg (fluent-ffmpeg + 内置二进制)
+- **图片处理**: Sharp
+
+### 桌面端
+
+- **壳**: Electron（utilityProcess 承载后端，BrowserWindow 同源加载）
+- **打包**: esbuild（后端单文件 bundle）+ electron-builder（dmg arm64/x64，NSIS win-x64）
+
+### 前端
+
+- **框架**: Nuxt 3 (SPA 模式)
+- **语言**: Vue 3 + TypeScript
+- **路由**: 文件路由 (Vue Router 4)
+- **样式**: 纯 CSS + CSS Variables
+- **图标**: Lucide Vue
+- **国际化**: vue-i18n（中文 / English / 日本語 / 한국어）
+
+---
+
+## 📝 常见问题
+
+### Q: 桌面版数据存在哪里？
+
+A: `~/Library/Application Support/HuobaoDrama/data/`（SQLite 数据库 + 生成的图片/视频），技能在线编辑的副本在同级 `workspace/` 目录。开发模式下则使用仓库 `data/` 目录。
+
+### Q: 旧版 MySQL 数据怎么迁移到 SQLite？
+
+A: 保持 MySQL 可连接（环境变量或 `backend/.env`），执行 `cd backend && npx tsx scripts/import-mysql-to-sqlite.ts`，脚本会自动建表、逐表导入并校验行数（目标库非空需加 `--force`，写入前自动备份）。
+
+### Q: FFmpeg 未安装或找不到？
+
+A: 无需安装。项目内置 `ffmpeg-static` / `ffprobe-static` 二进制（桌面版随包携带）。系统 `PATH` 中的 FFmpeg 也不会冲突，也可通过 `FFMPEG_BIN`/`FFPROBE_BIN` 显式指定。
+
+### Q: 页面顶部提示「尚未配置模型」？
+
+A: 这是正常的首次部署引导。前往「设置」页，用「火宝快捷配置」粘贴 API Key 一键写入，或通过「手动模板」按厂商添加。文本、图片、视频三类均有启用中的配置后横幅自动消失。
+
+### Q: 前端无法连接后端 API？
+
+A: 检查后端是否启动，端口是否正确。开发模式下前端代理配置在 `frontend/nuxt.config.ts`。
+
+### Q: 数据库表未创建？
+
+A: 后端会在首次启动时自动创建所有表，检查日志确认初始化是否成功。
+
+---
+
+## 📋 更新日志
+
+### v4.0.0 (2026-08)
+
+#### 🖥️ 桌面应用 + 数据库迁移
+
+- Electron 桌面版（macOS dmg，arm64/x64 双架构）
+  - 双击安装、开箱即用：自动选择端口、单实例锁、崩溃隔离的后端子进程
+  - 用户数据隔离：SQLite 库 / 生成媒体 / 技能副本均存放于 userData 目录
+  - 内置 FFmpeg/FFprobe 随包分发；workspace 技能模板首启动拷贝、升级只补缺不覆盖
+- 数据库从 MySQL 完全迁移到 SQLite（better-sqlite3 + WAL）
+  - 业务代码零改动（Drizzle 查询层天然可移植），DDL 幂等重放
+  - 新增一次性导入脚本 `import-mysql-to-sqlite.ts`（逐表行数校验 + 自动备份）
+- 后端 esbuild 单文件打包（externals：sharp/better-sqlite3/ffmpeg 二进制包）
+- 移除 Docker/MySQL 部署方式（git 历史可找回）
+
+### v3.1.0 (2026-09)
+
+- 新增阿里云百炼 Wan 3.0 视频模型（Prime / 标准，支持官方 input.media/parameters 入参）
+- 工作台顶栏新增分辨率选择器，按厂商显示原生档位（Seedance 480p/720p、MiniMax 768P/2K、Wan 480P/720P/1080P）
+- 默认视频模型调整为 Seedance 2.0 Mini
+- 修复切换视频模型时厂商/模型错配导致的生成报错
+- 批量视频：选择模式 + 生成前确认（镜头数/总时长/模型/分辨率），失败任务一键重试
+- 分镜时长在视频生成参数区直接编辑保存，单次/批量生成统一生效
+- 真人/敏感内容审核失败时提示切换模型重试
+
+### v3.0.0 (2026-08)
+
+#### 🚀 部署与体验优化
+
+- Docker 部署就绪改造
+  - MySQL / 应用健康检查，应用等待数据库就绪后启动
+  - 数据库初始化增加重试，容器编排下首次部署零人工干预
+  - 移除系统 FFmpeg 依赖，全面使用内置二进制
+  - Agent skills 目录 volume 持久化（设置页在线编辑不丢失）
+  - 新增 `docker/init.sql` 及导出脚本（DBA 审核 / 预建表）
+- 首次使用引导
+  - 未配置 AI 服务时全站顶部横幅提示并引导至设置页
+  - 设置页新增「火宝快捷配置」：一个 Key 写入文本/图片/视频三条推荐配置
+  - 未配置模型的报错中文化并指引设置页
+- 视频模型默认调整为 Seedance 2.0 Fast
+- 厂商收敛：仅保留 OpenAI / Gemini / 火山引擎
+- 工作台：任务列表抽屉、流水线大环节状态、选择性拼接（拼接前校验视频文件存在）
+- 素材库改版、@提及优化、剧集列表重构
+
+### v2.0.0 (2026-04)
+
+#### 🚀 重大更新
+
+- 项目全面迁移至 TypeScript 技术栈
+  - 后端：Hono + Drizzle ORM + mysql2
+  - 前端：Nuxt 3 + Vue 3
+  - AI Agent：Mastra 框架
+- 重做单集工作台 UI 和生产流程
+  - 更紧凑的控制台布局
+  - 重做分镜编辑区
+  - 重做镜头图、视频、合成、导出界面
+- 新增 Docker 部署支持，前后端合并为单镜像
+- 增加运行时 Skill 加载机制
+- 扩展多厂商媒体 Adapter
+  - 图片：OpenAI、Gemini、火山引擎、阿里
+  - 视频：火山引擎/Seedance、Vidu、阿里
+- 优化本地文件处理与参考图按需转码
+
+### v1.0.4 (2026-01-27)
+
+- 引入本地存储策略，规避外部资源链接失效
+- Base64 参考图嵌入式传输
+- 修复镜头切换状态重置问题
+- 添加场景迁移至章节
+
+### v1.0.3 (2026-01-16)
+
+- 优化数据库并发访问性能
+- Docker 跨平台支持 host.docker.internal
+
+### v1.0.2 (2026-01-14)
+
+- 修复视频生成 API 响应解析问题
+- 添加 OpenAI Sora 视频端点配置
+- 优化错误处理和日志输出
+
+---
+
+## 📄 许可证
+
+本项目采用 **[CC BY-NC-SA 4.0](LICENSE)**（署名-非商业性使用-相同方式共享 4.0 国际）许可证。
+
+- ✅ 个人使用、学习研究、非商业项目均可自由使用
+- ✅ 允许修改与再分发，但须署名并以相同许可证共享
+- ❌ **禁止商用**——未经作者书面许可，不得将本项目整体或部分用于任何商业目的（包括付费服务、商业部署、转售等）
+
+许可证全文见 [LICENSE](LICENSE)。
+
+---
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 本项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
+
+常用检查命令：
+
+```bash
+cd backend && npm run typecheck
+cd ../frontend && npm run build
+```
+
+---
+
+## 💬 微信群
+
+扫码加入微信群交流：
+
+<div align="center">
+  <img src="docs/images/wx-group.png" width="200" alt="微信群二维码" />
+</div>
+
+---
+
+> _"让 AI 帮我们做更有创造力的事"_
+
+## 🔗 友情链接
+
+本项目已获得 [LINUX DO](https://linux.do/) 社区链接认可。
+
+- [LINUX DO](https://linux.do/) — 真正的开源精神，共建共享的技术社区
+
+---
diff --git a/huobao-source/backend/.env.example b/huobao-source/backend/.env.example
new file mode 100644
index 0000000..2e42d4e
--- /dev/null
+++ b/huobao-source/backend/.env.example
@@ -0,0 +1,25 @@
+PORT=5679
+
+# Optional. SQLite 数据库文件位置（默认仓库根 data/huobao.sqlite3）
+# SQLITE_PATH=/path/to/huobao.sqlite3
+
+# Optional. 数据根目录（默认仓库根 data/；桌面版由 Electron 注入 HUOBAO_DATA_DIR）
+# HUOBAO_DATA_DIR=/path/to/data
+# STORAGE_PATH=/path/to/data/static
+
+# Optional. MySQL → SQLite 启动自动迁移（老用户升级）：显式配置 DATABASE_URL 或
+# MYSQL_HOST 且 SQLite 为空库时，启动自动一次性导入全部表（原子事务 + 行数校验 +
+# 成功后写 .mysql-imported 标记）。关闭：MYSQL_AUTO_IMPORT=false
+# DATABASE_URL=mysql://huobao:huobao@127.0.0.1:3306/huobao_drama
+
+# Optional. Public base URL of this backend. Required when passing locally
+# uploaded reference videos/audios/files to an upstream video API (local
+# /static paths are resolved as PUBLIC_BASE_URL + path).
+# PUBLIC_BASE_URL=https://your-domain.com
+
+# Optional. 关闭文本模型思考(thinking)模式,默认 true。
+# 对 new-api 类中转站在请求体注入关思考参数,规避中转站强制回传
+# reasoning_content 导致的 400;官方 OpenAI/Gemini 端点自动跳过。
+# AI_DISABLE_THINKING=false
+# 可选:自定义注入的 OpenAI 风格参数(JSON),适配不同中转站
+# AI_THINKING_OFF_PATCH={"thinking":{"type":"disabled"},"enable_thinking":false}
diff --git a/huobao-source/backend/.gitignore b/huobao-source/backend/.gitignore
new file mode 100644
index 0000000..191b54c
--- /dev/null
+++ b/huobao-source/backend/.gitignore
@@ -0,0 +1,5 @@
+node_modules/
+dist/
+*.js
+*.d.ts
+*.map
diff --git a/huobao-source/backend/.npmrc b/huobao-source/backend/.npmrc
new file mode 100644
index 0000000..f00e882
--- /dev/null
+++ b/huobao-source/backend/.npmrc
@@ -0,0 +1 @@
+package-manager=npm
diff --git a/huobao-source/backend/package-lock.json b/huobao-source/backend/package-lock.json
new file mode 100644
index 0000000..a8b3b06
--- /dev/null
+++ b/huobao-source/backend/package-lock.json
@@ -0,0 +1,5758 @@
+{
+  "name": "server",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "server",
+      "version": "1.0.0",
+      "license": "ISC",
+      "dependencies": {
+        "@ai-sdk/google": "^3.0.53",
+        "@ai-sdk/openai": "^3.0.48",
+        "@hono/node-server": "^1.19.11",
+        "@mastra/core": "^1.17.0",
+        "better-sqlite3": "^12.4.1",
+        "dotenv": "^17.4.2",
+        "drizzle-orm": "^0.45.1",
+        "ffmpeg-static": "^5.3.0",
+        "ffprobe-static": "^3.1.0",
+        "fluent-ffmpeg": "^2.1.3",
+        "hono": "^4.12.9",
+        "pino": "^10.3.1",
+        "sharp": "^0.34.5",
+        "uuid": "^13.0.0",
+        "zod": "^4.3.6"
+      },
+      "devDependencies": {
+        "@types/better-sqlite3": "^7.6.13",
+        "@types/fluent-ffmpeg": "^2.1.28",
+        "@types/node": "^25.5.0",
+        "@types/uuid": "^10.0.0",
+        "drizzle-kit": "^0.31.10",
+        "mysql2": "^3.22.5",
+        "tsx": "^4.21.0",
+        "typescript": "^6.0.2"
+      }
+    },
+    "node_modules/@a2a-js/sdk": {
+      "version": "0.2.5",
+      "resolved": "https://registry.npmjs.org/@a2a-js/sdk/-/sdk-0.2.5.tgz",
+      "integrity": "sha512-VTDuRS5V0ATbJ/LkaQlisMnTAeYKXAK6scMguVBstf+KIBQ7HIuKhiXLv+G/hvejkV+THoXzoNifInAkU81P1g==",
+      "dependencies": {
+        "@types/cors": "^2.8.17",
+        "@types/express": "^4.17.23",
+        "body-parser": "^2.2.0",
+        "cors": "^2.8.5",
+        "express": "^4.21.2",
+        "uuid": "^11.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@a2a-js/sdk/node_modules/uuid": {
+      "version": "11.1.0",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.0.tgz",
+      "integrity": "sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/esm/bin/uuid"
+      }
+    },
+    "node_modules/@ai-sdk/google": {
+      "version": "3.0.53",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/google/-/google-3.0.53.tgz",
+      "integrity": "sha512-uz8tIlkDgQJG9Js2Wh9JHzd4kI9+hYJqf9XXJLx60vyN5mRIqhr49iwR5zGP5Gl8odp2PeR3Gh2k+5bh3Z1HHw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.21"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/openai": {
+      "version": "3.0.48",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/openai/-/openai-3.0.48.tgz",
+      "integrity": "sha512-ALmj/53EXpcRqMbGpPJPP4UOSWw0q4VGpnDo7YctvsynjkrKDmoneDG/1a7VQnSPYHnJp6tTRMf5ZdxZ5whulg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.21"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/provider": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.8.tgz",
+      "integrity": "sha512-oGMAgGoQdBXbZqNG0Ze56CHjDZ1IDYOwGYxYjO5KLSlz5HiNQ9udIXsPZ61VWaHGZ5XW/jyjmr6t2xz2jGVwbQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/provider-utils": {
+      "version": "4.0.21",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-4.0.21.tgz",
+      "integrity": "sha512-MtFUYI1/8mgDvRmaBDjbLJPFFrMG777AvSgyIFQtZHIMzm88R/12vYBBpnk7pfiWLFE1DSZzY4WDYzGbKAcmiw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@standard-schema/spec": "^1.1.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/provider-utils-v5": {
+      "name": "@ai-sdk/provider-utils",
+      "version": "3.0.20",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-3.0.20.tgz",
+      "integrity": "sha512-iXHVe0apM2zUEzauqJwqmpC37A5rihrStAih5Ks+JE32iTe4LZ58y17UGBjpQQTCRw9YxMeo2UFLxLpBluyvLQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "2.0.1",
+        "@standard-schema/spec": "^1.0.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/provider-utils-v5/node_modules/@ai-sdk/provider": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-2.0.1.tgz",
+      "integrity": "sha512-KCUwswvsC5VsW2PWFqF8eJgSCu5Ysj7m1TxiHTVA6g7k360bk0RNQENT8KTMAYEs+8fWPD3Uu4dEmzGHc+jGng==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/provider-utils-v6": {
+      "name": "@ai-sdk/provider-utils",
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-4.0.0.tgz",
+      "integrity": "sha512-HyCyOls9I3a3e38+gtvOJOEjuw9KRcvbBnCL5GBuSmJvS9Jh9v3fz7pRC6ha1EUo/ZH1zwvLWYXBMtic8MTguA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.0",
+        "@standard-schema/spec": "^1.1.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/provider-utils-v6/node_modules/@ai-sdk/provider": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.0.tgz",
+      "integrity": "sha512-m9ka3ptkPQbaHHZHqDXDF9C9B5/Mav0KTdky1k2HZ3/nrW2t1AgObxIVPyGDWQNS9FXT/FS6PIoSjpcP/No8rQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/provider-v5": {
+      "name": "@ai-sdk/provider",
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-2.0.1.tgz",
+      "integrity": "sha512-KCUwswvsC5VsW2PWFqF8eJgSCu5Ysj7m1TxiHTVA6g7k360bk0RNQENT8KTMAYEs+8fWPD3Uu4dEmzGHc+jGng==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/provider-v6": {
+      "name": "@ai-sdk/provider",
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.5.tgz",
+      "integrity": "sha512-2Xmoq6DBJqmSl80U6V9z5jJSJP7ehaJJQMy2iFUqTay06wdCqTnPVBBQbtEL8RCChenL+q5DC5H5WzU3vV3v8w==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@derhuerst/http-basic": {
+      "version": "8.2.4",
+      "resolved": "https://registry.npmjs.org/@derhuerst/http-basic/-/http-basic-8.2.4.tgz",
+      "integrity": "sha512-F9rL9k9Xjf5blCz8HsJRO4diy111cayL2vkY2XE4r4t3n0yPXVYy3KD3nJ1qbrSn9743UWSXH4IwuCa/HWlGFw==",
+      "license": "MIT",
+      "dependencies": {
+        "caseless": "^0.12.0",
+        "concat-stream": "^2.0.0",
+        "http-response-object": "^3.0.1",
+        "parse-cache-control": "^1.0.1"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@drizzle-team/brocli": {
+      "version": "0.10.2",
+      "resolved": "https://registry.npmjs.org/@drizzle-team/brocli/-/brocli-0.10.2.tgz",
+      "integrity": "sha512-z33Il7l5dKjUgGULTqBsQBQwckHh5AbIuxhdsIxDDiZAzBOrZO6q9ogcWC65kU382AfynTfgNumVcNIjuIua6w==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/@emnapi/runtime": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.9.1.tgz",
+      "integrity": "sha512-VYi5+ZVLhpgK4hQ0TAjiQiZ6ol0oe4mBx7mVv7IflsiEp0OWoVsp/+f9Vc1hOhE0TtkORVrI1GvzyreqpgWtkA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils": {
+      "version": "3.3.2",
+      "resolved": "https://registry.npmjs.org/@esbuild-kit/core-utils/-/core-utils-3.3.2.tgz",
+      "integrity": "sha512-sPRAnw9CdSsRmEtnsl2WXWdyquogVpB3yZ3dgwJfe8zrOzTsV7cJvmwrKVa+0ma5BoiGJ+BoqkMvawbayKUsqQ==",
+      "deprecated": "Merged into tsx: https://tsx.is",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.18.20",
+        "source-map-support": "^0.5.21"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/android-arm": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.18.20.tgz",
+      "integrity": "sha512-fyi7TDI/ijKKNZTUJAQqiG5T7YjJXgnzkURqmGj13C6dCqckZBLdl4h7bkhHt/t0WP+zO9/zwroDvANaOqO5Sw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/android-arm64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.18.20.tgz",
+      "integrity": "sha512-Nz4rJcchGDtENV0eMKUNa6L12zz2zBDXuhj/Vjh18zGqB44Bi7MBMSXjgunJgjRhCmKOjnPuZp4Mb6OKqtMHLQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/android-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.18.20.tgz",
+      "integrity": "sha512-8GDdlePJA8D6zlZYJV/jnrRAi6rOiNaCC/JclcXpB+KIuvfBN4owLtgzY2bsxnx666XjJx2kDPUmnTtR8qKQUg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/darwin-arm64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.18.20.tgz",
+      "integrity": "sha512-bxRHW5kHU38zS2lPTPOyuyTm+S+eobPUnTNkdJEfAddYgEcll4xkT8DB9d2008DtTbl7uJag2HuE5NZAZgnNEA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/darwin-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.18.20.tgz",
+      "integrity": "sha512-pc5gxlMDxzm513qPGbCbDukOdsGtKhfxD1zJKXjCCcU7ju50O7MeAZ8c4krSJcOIJGFR+qx21yMMVYwiQvyTyQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.18.20.tgz",
+      "integrity": "sha512-yqDQHy4QHevpMAaxhhIwYPMv1NECwOvIpGCZkECn8w2WFHXjEwrBn3CeNIYsibZ/iZEUemj++M26W3cNR5h+Tw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/freebsd-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.18.20.tgz",
+      "integrity": "sha512-tgWRPPuQsd3RmBZwarGVHZQvtzfEBOreNuxEMKFcd5DaDn2PbBxfwLcj4+aenoh7ctXcbXmOQIn8HI6mCSw5MQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-arm": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.18.20.tgz",
+      "integrity": "sha512-/5bHkMWnq1EgKr1V+Ybz3s1hWXok7mDFUMQ4cG10AfW3wL02PSZi5kFpYKrptDsgb2WAJIvRcDm+qIvXf/apvg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-arm64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.18.20.tgz",
+      "integrity": "sha512-2YbscF+UL7SQAVIpnWvYwM+3LskyDmPhe31pE7/aoTMFKKzIc9lLbyGUpmmb8a8AixOL61sQ/mFh3jEjHYFvdA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-ia32": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.18.20.tgz",
+      "integrity": "sha512-P4etWwq6IsReT0E1KHU40bOnzMHoH73aXp96Fs8TIT6z9Hu8G6+0SHSw9i2isWrD2nbx2qo5yUqACgdfVGx7TA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-loong64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.18.20.tgz",
+      "integrity": "sha512-nXW8nqBTrOpDLPgPY9uV+/1DjxoQ7DoB2N8eocyq8I9XuqJ7BiAMDMf9n1xZM9TgW0J8zrquIb/A7s3BJv7rjg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-mips64el": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.18.20.tgz",
+      "integrity": "sha512-d5NeaXZcHp8PzYy5VnXV3VSd2D328Zb+9dEq5HE6bw6+N86JVPExrA6O68OPwobntbNJ0pzCpUFZTo3w0GyetQ==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-ppc64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.18.20.tgz",
+      "integrity": "sha512-WHPyeScRNcmANnLQkq6AfyXRFr5D6N2sKgkFo2FqguP44Nw2eyDlbTdZwd9GYk98DZG9QItIiTlFLHJHjxP3FA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-riscv64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.18.20.tgz",
+      "integrity": "sha512-WSxo6h5ecI5XH34KC7w5veNnKkju3zBRLEQNY7mv5mtBmrP/MjNBCAlsM2u5hDBlS3NGcTQpoBvRzqBcRtpq1A==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-s390x": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.18.20.tgz",
+      "integrity": "sha512-+8231GMs3mAEth6Ja1iK0a1sQ3ohfcpzpRLH8uuc5/KVDFneH6jtAJLFGafpzpMRO6DzJ6AvXKze9LfFMrIHVQ==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/linux-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.18.20.tgz",
+      "integrity": "sha512-UYqiqemphJcNsFEskc73jQ7B9jgwjWrSayxawS6UVFZGWrAAtkzjxSqnoclCXxWtfwLdzU+vTpcNYhpn43uP1w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/netbsd-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.18.20.tgz",
+      "integrity": "sha512-iO1c++VP6xUBUmltHZoMtCUdPlnPGdBom6IrO4gyKPFFVBKioIImVooR5I83nTew5UOYrk3gIJhbZh8X44y06A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/openbsd-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.18.20.tgz",
+      "integrity": "sha512-e5e4YSsuQfX4cxcygw/UCPIEP6wbIL+se3sxPdCiMbFLBWu0eiZOJ7WoD+ptCLrmjZBK1Wk7I6D/I3NglUGOxg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/sunos-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.18.20.tgz",
+      "integrity": "sha512-kDbFRFp0YpTQVVrqUd5FTYmWo45zGaXe0X8E1G/LKFC0v8x0vWrhOWSLITcCn63lmZIxfOMXtCfti/RxN/0wnQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/win32-arm64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.18.20.tgz",
+      "integrity": "sha512-ddYFR6ItYgoaq4v4JmQQaAI5s7npztfV4Ag6NrhiaW0RrnOXqBkgwZLofVTlq1daVTQNhtI5oieTvkRPfZrePg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/win32-ia32": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.18.20.tgz",
+      "integrity": "sha512-Wv7QBi3ID/rROT08SABTS7eV4hX26sVduqDOTe1MvGMjNd3EjOz4b7zeexIR62GTIEKrfJXKL9LFxTYgkyeu7g==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/@esbuild/win32-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.18.20.tgz",
+      "integrity": "sha512-kTdfRcSiDfQca/y9QIkng02avJ+NCaQvrMejlsB3RRv5sE9rRoeBPISaZpKxHELzRxZyLvNts1P27W3wV+8geQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild-kit/core-utils/node_modules/esbuild": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.18.20.tgz",
+      "integrity": "sha512-ceqxoedUrcayh7Y7ZX6NdbbDzGROiyVBgC4PriJThBKSVPWnnFHZAkfI1lJT8QFkOwH4qOS2SJkS4wvpGl8BpA==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "optionalDependencies": {
+        "@esbuild/android-arm": "0.18.20",
+        "@esbuild/android-arm64": "0.18.20",
+        "@esbuild/android-x64": "0.18.20",
+        "@esbuild/darwin-arm64": "0.18.20",
+        "@esbuild/darwin-x64": "0.18.20",
+        "@esbuild/freebsd-arm64": "0.18.20",
+        "@esbuild/freebsd-x64": "0.18.20",
+        "@esbuild/linux-arm": "0.18.20",
+        "@esbuild/linux-arm64": "0.18.20",
+        "@esbuild/linux-ia32": "0.18.20",
+        "@esbuild/linux-loong64": "0.18.20",
+        "@esbuild/linux-mips64el": "0.18.20",
+        "@esbuild/linux-ppc64": "0.18.20",
+        "@esbuild/linux-riscv64": "0.18.20",
+        "@esbuild/linux-s390x": "0.18.20",
+        "@esbuild/linux-x64": "0.18.20",
+        "@esbuild/netbsd-x64": "0.18.20",
+        "@esbuild/openbsd-x64": "0.18.20",
+        "@esbuild/sunos-x64": "0.18.20",
+        "@esbuild/win32-arm64": "0.18.20",
+        "@esbuild/win32-ia32": "0.18.20",
+        "@esbuild/win32-x64": "0.18.20"
+      }
+    },
+    "node_modules/@esbuild-kit/esm-loader": {
+      "version": "2.6.5",
+      "resolved": "https://registry.npmjs.org/@esbuild-kit/esm-loader/-/esm-loader-2.6.5.tgz",
+      "integrity": "sha512-FxEMIkJKnodyA1OaCUoEvbYRkoZlLZ4d/eXFu9Fh8CbBBgP5EmZxrfTRyN0qpXZ4vOvqnE5YdRdcrmUUXuU+dA==",
+      "deprecated": "Merged into tsx: https://tsx.is",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@esbuild-kit/core-utils": "^3.3.2",
+        "get-tsconfig": "^4.7.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
+      "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz",
+      "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz",
+      "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz",
+      "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz",
+      "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz",
+      "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz",
+      "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz",
+      "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz",
+      "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz",
+      "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz",
+      "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz",
+      "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz",
+      "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz",
+      "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz",
+      "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz",
+      "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz",
+      "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz",
+      "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz",
+      "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz",
+      "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz",
+      "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@hono/node-server": {
+      "version": "1.19.11",
+      "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-1.19.11.tgz",
+      "integrity": "sha512-dr8/3zEaB+p0D2n/IUrlPF1HZm586qgJNXK1a9fhg/PzdtkK7Ksd5l312tJX2yBuALqDYBlG20QEbayqPyxn+g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.14.1"
+      },
+      "peerDependencies": {
+        "hono": "^4"
+      }
+    },
+    "node_modules/@img/colour": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz",
+      "integrity": "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@img/sharp-darwin-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.5.tgz",
+      "integrity": "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-arm64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-darwin-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.5.tgz",
+      "integrity": "sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-x64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-arm64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.4.tgz",
+      "integrity": "sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-x64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.4.tgz",
+      "integrity": "sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.4.tgz",
+      "integrity": "sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.4.tgz",
+      "integrity": "sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-ppc64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.4.tgz",
+      "integrity": "sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-riscv64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.2.4.tgz",
+      "integrity": "sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-s390x": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.4.tgz",
+      "integrity": "sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-x64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.4.tgz",
+      "integrity": "sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-arm64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.4.tgz",
+      "integrity": "sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-x64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.4.tgz",
+      "integrity": "sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.5.tgz",
+      "integrity": "sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.5.tgz",
+      "integrity": "sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-ppc64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.5.tgz",
+      "integrity": "sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-ppc64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-riscv64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.34.5.tgz",
+      "integrity": "sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-riscv64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-s390x": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.5.tgz",
+      "integrity": "sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-s390x": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.5.tgz",
+      "integrity": "sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-x64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.5.tgz",
+      "integrity": "sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.5.tgz",
+      "integrity": "sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-wasm32": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.5.tgz",
+      "integrity": "sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==",
+      "cpu": [
+        "wasm32"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/runtime": "^1.7.0"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.5.tgz",
+      "integrity": "sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-ia32": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.5.tgz",
+      "integrity": "sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.5.tgz",
+      "integrity": "sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@isaacs/ttlcache": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/@isaacs/ttlcache/-/ttlcache-2.1.4.tgz",
+      "integrity": "sha512-7kMz0BJpMvgAMkyglums7B2vtrn5g0a0am77JY0GjkZZNetOBCFn7AG7gKCwT0QPiXyxW7YIQSgtARknUEOcxQ==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@lukeed/csprng": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@lukeed/csprng/-/csprng-1.1.0.tgz",
+      "integrity": "sha512-Z7C/xXCiGWsg0KuKsHTKJxbWhpI3Vs5GwLfOean7MGyVFGqdRgBbAjOCh6u4bbjPc/8MJ2pZmK/0DLdCbivLDA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@lukeed/uuid": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@lukeed/uuid/-/uuid-2.0.1.tgz",
+      "integrity": "sha512-qC72D4+CDdjGqJvkFMMEAtancHUQ7/d/tAiHf64z8MopFDmcrtbcJuerDtFceuAfQJ2pDSfCKCtbqoGBNnwg0w==",
+      "license": "MIT",
+      "dependencies": {
+        "@lukeed/csprng": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@mastra/core": {
+      "version": "1.17.0",
+      "resolved": "https://registry.npmjs.org/@mastra/core/-/core-1.17.0.tgz",
+      "integrity": "sha512-szJgYEXGj9ux5cM1wpi2HdouvKBugbnt3TEHEPvW9fI6fLvZTiYG0Nt0y8DPQgDK4nH0BPdL9HFxOf3PnevZ8Q==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@a2a-js/sdk": "~0.2.5",
+        "@ai-sdk/provider-utils-v5": "npm:@ai-sdk/provider-utils@3.0.20",
+        "@ai-sdk/provider-utils-v6": "npm:@ai-sdk/provider-utils@4.0.0",
+        "@ai-sdk/provider-v5": "npm:@ai-sdk/provider@2.0.1",
+        "@ai-sdk/provider-v6": "npm:@ai-sdk/provider@3.0.5",
+        "@ai-sdk/ui-utils-v5": "npm:@ai-sdk/ui-utils@1.2.11",
+        "@isaacs/ttlcache": "^2.1.4",
+        "@lukeed/uuid": "^2.0.1",
+        "@mastra/schema-compat": "1.2.7",
+        "@modelcontextprotocol/sdk": "^1.27.1",
+        "@sindresorhus/slugify": "^2.2.1",
+        "@standard-schema/spec": "^1.1.0",
+        "ajv": "^8.18.0",
+        "dotenv": "^17.3.1",
+        "execa": "^9.6.1",
+        "gray-matter": "^4.0.3",
+        "hono": "^4.12.8",
+        "hono-openapi": "^1.3.0",
+        "ignore": "^7.0.5",
+        "js-tiktoken": "^1.0.21",
+        "json-schema": "^0.4.0",
+        "lru-cache": "^11.2.7",
+        "p-map": "^7.0.4",
+        "p-retry": "^7.1.1",
+        "picomatch": "^4.0.3",
+        "radash": "^12.1.1",
+        "ws": "^8.19.0",
+        "xxhash-wasm": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=22.13.0"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.0 || ^4.0.0"
+      }
+    },
+    "node_modules/@mastra/core/node_modules/@ai-sdk/provider": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-1.1.3.tgz",
+      "integrity": "sha512-qZMxYJ0qqX/RfnuIaab+zp8UAeJn/ygXXAffR5I4N0n1IrvA6qBsjc8hXLmBiMV2zoXlifkacF7sEFnYnjBcqg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@mastra/core/node_modules/@ai-sdk/ui-utils-v5": {
+      "name": "@ai-sdk/ui-utils",
+      "version": "1.2.11",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/ui-utils/-/ui-utils-1.2.11.tgz",
+      "integrity": "sha512-3zcwCc8ezzFlwp3ZD15wAPjf2Au4s3vAbKsXQVyhxODHcmu0iyPO2Eua6D/vicq/AUm/BAo60r97O6HU+EI0+w==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "1.1.3",
+        "@ai-sdk/provider-utils": "2.2.8",
+        "zod-to-json-schema": "^3.24.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.23.8"
+      }
+    },
+    "node_modules/@mastra/core/node_modules/@ai-sdk/ui-utils-v5/node_modules/@ai-sdk/provider-utils": {
+      "version": "2.2.8",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-2.2.8.tgz",
+      "integrity": "sha512-fqhG+4sCVv8x7nFzYnFo19ryhAa3w096Kmc3hWxMQfW/TubPOmt3A6tYZhl4mUfQWWQMsuSkLrtjlWuXBVSGQA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "1.1.3",
+        "nanoid": "^3.3.8",
+        "secure-json-parse": "^2.7.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.23.8"
+      }
+    },
+    "node_modules/@mastra/core/node_modules/@standard-community/standard-openapi": {
+      "version": "0.2.9",
+      "resolved": "https://registry.npmjs.org/@standard-community/standard-openapi/-/standard-openapi-0.2.9.tgz",
+      "integrity": "sha512-htj+yldvN1XncyZi4rehbf9kLbu8os2Ke/rfqoZHCMHuw34kiF3LP/yQPdA0tQ940y8nDq3Iou8R3wG+AGGyvg==",
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "@standard-community/standard-json": "^0.3.5",
+        "@standard-schema/spec": "^1.0.0",
+        "arktype": "^2.1.20",
+        "effect": "^3.17.14",
+        "openapi-types": "^12.1.3",
+        "sury": "^10.0.0",
+        "typebox": "^1.0.0",
+        "valibot": "^1.1.0",
+        "zod": "^3.25.0 || ^4.0.0",
+        "zod-openapi": "^4"
+      },
+      "peerDependenciesMeta": {
+        "arktype": {
+          "optional": true
+        },
+        "effect": {
+          "optional": true
+        },
+        "sury": {
+          "optional": true
+        },
+        "typebox": {
+          "optional": true
+        },
+        "valibot": {
+          "optional": true
+        },
+        "zod": {
+          "optional": true
+        },
+        "zod-openapi": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@mastra/core/node_modules/hono-openapi": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/hono-openapi/-/hono-openapi-1.3.0.tgz",
+      "integrity": "sha512-xDvCWpWEIv0weEmnl3EjRQzqbHIO8LnfzMuYOCmbuyE5aes6aXxLg4vM3ybnoZD5TiTUkA6PuRQPJs3R7WRBig==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@hono/standard-validator": "^0.2.0",
+        "@standard-community/standard-json": "^0.3.5",
+        "@standard-community/standard-openapi": "^0.2.9",
+        "@types/json-schema": "^7.0.15",
+        "hono": "^4.8.3",
+        "openapi-types": "^12.1.3"
+      },
+      "peerDependenciesMeta": {
+        "@hono/standard-validator": {
+          "optional": true
+        },
+        "hono": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@mastra/schema-compat": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/@mastra/schema-compat/-/schema-compat-1.2.7.tgz",
+      "integrity": "sha512-t63E0f5HcH8neXPfs3D5x4qqQM6Pf/pbhFUVk0cTC0bFo6609sT/+189I+2HY4sbAF3uzurOgy2fXIS4vfMkOA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema-to-zod": "^2.7.0",
+        "zod-from-json-schema": "^0.5.2",
+        "zod-from-json-schema-v3": "npm:zod-from-json-schema@^0.0.5",
+        "zod-to-json-schema": "^3.25.1"
+      },
+      "engines": {
+        "node": ">=22.13.0"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.0 || ^4.0.0"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk": {
+      "version": "1.28.0",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.28.0.tgz",
+      "integrity": "sha512-gmloF+i+flI8ouQK7MWW4mOwuMh4RePBuPFAEPC6+pdqyWOUMDOixb6qZ69owLJpz6XmyllCouc4t8YWO+E2Nw==",
+      "license": "MIT",
+      "dependencies": {
+        "@hono/node-server": "^1.19.9",
+        "ajv": "^8.17.1",
+        "ajv-formats": "^3.0.1",
+        "content-type": "^1.0.5",
+        "cors": "^2.8.5",
+        "cross-spawn": "^7.0.5",
+        "eventsource": "^3.0.2",
+        "eventsource-parser": "^3.0.0",
+        "express": "^5.2.1",
+        "express-rate-limit": "^8.2.1",
+        "hono": "^4.11.4",
+        "jose": "^6.1.3",
+        "json-schema-typed": "^8.0.2",
+        "pkce-challenge": "^5.0.0",
+        "raw-body": "^3.0.0",
+        "zod": "^3.25 || ^4.0",
+        "zod-to-json-schema": "^3.25.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@cfworker/json-schema": "^4.1.1",
+        "zod": "^3.25 || ^4.0"
+      },
+      "peerDependenciesMeta": {
+        "@cfworker/json-schema": {
+          "optional": true
+        },
+        "zod": {
+          "optional": false
+        }
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/accepts": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
+      "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "^3.0.0",
+        "negotiator": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/content-disposition": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.0.1.tgz",
+      "integrity": "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/cookie-signature": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz",
+      "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.6.0"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/express": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz",
+      "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "^2.0.0",
+        "body-parser": "^2.2.1",
+        "content-disposition": "^1.0.0",
+        "content-type": "^1.0.5",
+        "cookie": "^0.7.1",
+        "cookie-signature": "^1.2.1",
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "finalhandler": "^2.1.0",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.0",
+        "merge-descriptors": "^2.0.0",
+        "mime-types": "^3.0.0",
+        "on-finished": "^2.4.1",
+        "once": "^1.4.0",
+        "parseurl": "^1.3.3",
+        "proxy-addr": "^2.0.7",
+        "qs": "^6.14.0",
+        "range-parser": "^1.2.1",
+        "router": "^2.2.0",
+        "send": "^1.1.0",
+        "serve-static": "^2.2.0",
+        "statuses": "^2.0.1",
+        "type-is": "^2.0.1",
+        "vary": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/finalhandler": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
+      "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "on-finished": "^2.4.1",
+        "parseurl": "^1.3.3",
+        "statuses": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 18.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/fresh": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
+      "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/merge-descriptors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
+      "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/mime-db": {
+      "version": "1.54.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/mime-types": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz",
+      "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "^1.54.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/negotiator": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz",
+      "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.3",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.1",
+        "mime-types": "^3.0.2",
+        "ms": "^2.1.3",
+        "on-finished": "^2.4.1",
+        "range-parser": "^1.2.1",
+        "statuses": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/serve-static": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz",
+      "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "parseurl": "^1.3.3",
+        "send": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/@pinojs/redact": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/@pinojs/redact/-/redact-0.4.0.tgz",
+      "integrity": "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==",
+      "license": "MIT"
+    },
+    "node_modules/@sec-ant/readable-stream": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/@sec-ant/readable-stream/-/readable-stream-0.4.1.tgz",
+      "integrity": "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg==",
+      "license": "MIT"
+    },
+    "node_modules/@sindresorhus/merge-streams": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/merge-streams/-/merge-streams-4.0.0.tgz",
+      "integrity": "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@sindresorhus/slugify": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/slugify/-/slugify-2.2.1.tgz",
+      "integrity": "sha512-MkngSCRZ8JdSOCHRaYd+D01XhvU3Hjy6MGl06zhOk614hp9EOAp5gIkBeQg7wtmxpitU6eAL4kdiRMcJa2dlrw==",
+      "license": "MIT",
+      "dependencies": {
+        "@sindresorhus/transliterate": "^1.0.0",
+        "escape-string-regexp": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@sindresorhus/transliterate": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/transliterate/-/transliterate-1.6.0.tgz",
+      "integrity": "sha512-doH1gimEu3A46VX6aVxpHTeHrytJAG6HgdxntYnCFiIFHEM/ZGpG8KiZGBChchjQmG0XFIBL552kBTjVcMZXwQ==",
+      "license": "MIT",
+      "dependencies": {
+        "escape-string-regexp": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@standard-community/standard-json": {
+      "version": "0.3.5",
+      "resolved": "https://registry.npmjs.org/@standard-community/standard-json/-/standard-json-0.3.5.tgz",
+      "integrity": "sha512-4+ZPorwDRt47i+O7RjyuaxHRK/37QY/LmgxlGrRrSTLYoFatEOzvqIc85GTlM18SFZ5E91C+v0o/M37wZPpUHA==",
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "@standard-schema/spec": "^1.0.0",
+        "@types/json-schema": "^7.0.15",
+        "@valibot/to-json-schema": "^1.3.0",
+        "arktype": "^2.1.20",
+        "effect": "^3.16.8",
+        "quansync": "^0.2.11",
+        "sury": "^10.0.0",
+        "typebox": "^1.0.17",
+        "valibot": "^1.1.0",
+        "zod": "^3.25.0 || ^4.0.0",
+        "zod-to-json-schema": "^3.24.5"
+      },
+      "peerDependenciesMeta": {
+        "@valibot/to-json-schema": {
+          "optional": true
+        },
+        "arktype": {
+          "optional": true
+        },
+        "effect": {
+          "optional": true
+        },
+        "sury": {
+          "optional": true
+        },
+        "typebox": {
+          "optional": true
+        },
+        "valibot": {
+          "optional": true
+        },
+        "zod": {
+          "optional": true
+        },
+        "zod-to-json-schema": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@standard-schema/spec": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+      "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/better-sqlite3": {
+      "version": "7.6.13",
+      "resolved": "https://registry.npmjs.org/@types/better-sqlite3/-/better-sqlite3-7.6.13.tgz",
+      "integrity": "sha512-NMv9ASNARoKksWtsq/SHakpYAYnhBrQgGD8zkLYk/jaK8jUGn08CfEdTRgYhMypUQAfzSP8W6gNLe0q19/t4VA==",
+      "devOptional": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/body-parser": {
+      "version": "1.19.6",
+      "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
+      "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/connect": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/connect": {
+      "version": "3.4.38",
+      "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz",
+      "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/cors": {
+      "version": "2.8.19",
+      "resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.19.tgz",
+      "integrity": "sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/express": {
+      "version": "4.17.25",
+      "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.25.tgz",
+      "integrity": "sha512-dVd04UKsfpINUnK0yBoYHDF3xu7xVH4BuDotC/xGuycx4CgbP48X/KF/586bcObxT0HENHXEU8Nqtu6NR+eKhw==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/body-parser": "*",
+        "@types/express-serve-static-core": "^4.17.33",
+        "@types/qs": "*",
+        "@types/serve-static": "^1"
+      }
+    },
+    "node_modules/@types/express-serve-static-core": {
+      "version": "4.19.8",
+      "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.19.8.tgz",
+      "integrity": "sha512-02S5fmqeoKzVZCHPZid4b8JH2eM5HzQLZWN2FohQEy/0eXTq8VXZfSN6Pcr3F6N9R/vNrj7cpgbhjie6m/1tCA==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*",
+        "@types/qs": "*",
+        "@types/range-parser": "*",
+        "@types/send": "*"
+      }
+    },
+    "node_modules/@types/fluent-ffmpeg": {
+      "version": "2.1.28",
+      "resolved": "https://registry.npmjs.org/@types/fluent-ffmpeg/-/fluent-ffmpeg-2.1.28.tgz",
+      "integrity": "sha512-5ovxsDwBcPfJ+eYs1I/ZpcYCnkce7pvH9AHSvrZllAp1ZPpTRDZAFjF3TRFbukxSgIYTTNYePbS0rKUmaxVbXw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/http-errors": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz",
+      "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==",
+      "license": "MIT"
+    },
+    "node_modules/@types/json-schema": {
+      "version": "7.0.15",
+      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
+      "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/mime": {
+      "version": "1.3.5",
+      "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.5.tgz",
+      "integrity": "sha512-/pyBZWSLD2n0dcHE3hq8s8ZvcETHtEuF+3E7XVt0Ig2nvsVQXdghHVcEkIWjy9A0wKfTn97a/PSDYohKIlnP/w==",
+      "license": "MIT"
+    },
+    "node_modules/@types/node": {
+      "version": "25.5.0",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.5.0.tgz",
+      "integrity": "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "undici-types": "~7.18.0"
+      }
+    },
+    "node_modules/@types/qs": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.15.0.tgz",
+      "integrity": "sha512-JawvT8iBVWpzTrz3EGw9BTQFg3BQNmwERdKE22vlTxawwtbyUSlMppvZYKLZzB5zgACXdXxbD3m1bXaMqP/9ow==",
+      "license": "MIT"
+    },
+    "node_modules/@types/range-parser": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz",
+      "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==",
+      "license": "MIT"
+    },
+    "node_modules/@types/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-arsCikDvlU99zl1g69TcAB3mzZPpxgw0UQnaHeC1Nwb015xp8bknZv5rIfri9xTOcMuaVgvabfIRA7PSZVuZIQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/serve-static": {
+      "version": "1.15.10",
+      "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.15.10.tgz",
+      "integrity": "sha512-tRs1dB+g8Itk72rlSI2ZrW6vZg0YrLI81iQSTkMmOqnqCaNr/8Ek4VwWcN5vZgCYWbg/JJSGBlUaYGAOP73qBw==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/http-errors": "*",
+        "@types/node": "*",
+        "@types/send": "<1"
+      }
+    },
+    "node_modules/@types/serve-static/node_modules/@types/send": {
+      "version": "0.17.6",
+      "resolved": "https://registry.npmjs.org/@types/send/-/send-0.17.6.tgz",
+      "integrity": "sha512-Uqt8rPBE8SY0RK8JB1EzVOIZ32uqy8HwdxCnoCOsYrvnswqmFZ/k+9Ikidlk/ImhsdvBsloHbAlewb2IEBV/Og==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/mime": "^1",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/uuid": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-10.0.0.tgz",
+      "integrity": "sha512-7gqG38EyHgyP1S+7+xomFtL+ZNHcKv6DwNaCZmJmo1vgMugyF3TCnXVg4t1uk89mLNwnLtnY3TpOpCOyp1/xHQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/accepts": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
+      "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "~2.1.34",
+        "negotiator": "0.6.3"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/agent-base": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz",
+      "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6.0.0"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.18.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz",
+      "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ajv-formats": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz",
+      "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "ajv": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "license": "MIT",
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "node_modules/array-flatten": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
+      "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
+      "license": "MIT"
+    },
+    "node_modules/async": {
+      "version": "0.2.10",
+      "resolved": "https://registry.npmjs.org/async/-/async-0.2.10.tgz",
+      "integrity": "sha512-eAkdoKxU6/LkKDBzLpT+t6Ff5EtfSF4wx1WfJiPEEV7WNLnDaRXk0oVysiEPm262roaachGexwUv94WhSgN5TQ=="
+    },
+    "node_modules/atomic-sleep": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/atomic-sleep/-/atomic-sleep-1.0.0.tgz",
+      "integrity": "sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/aws-ssl-profiles": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/aws-ssl-profiles/-/aws-ssl-profiles-1.1.2.tgz",
+      "integrity": "sha512-NZKeq9AfyQvEeNlN0zSYAaWrmBffJh3IELMZfRpJVWgrpEbtEpnjvzqBPf+mxoI287JohRDoa+/nsfqqiZmF6g==",
+      "devOptional": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 6.0.0"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/better-sqlite3": {
+      "version": "12.11.1",
+      "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-12.11.1.tgz",
+      "integrity": "sha512-dq9AtApgg5PGFtBzPFSBl3HZQjHok5gaQCM6zh2Yk0aSmDCs1CbnVI8/HgASQkNKsWFpseIO9beg5xxpYhbIfA==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "bindings": "^1.5.0",
+        "prebuild-install": "^7.1.1"
+      },
+      "engines": {
+        "node": "20.x || 22.x || 23.x || 24.x || 25.x || 26.x"
+      }
+    },
+    "node_modules/bindings": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz",
+      "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==",
+      "license": "MIT",
+      "dependencies": {
+        "file-uri-to-path": "1.0.0"
+      }
+    },
+    "node_modules/bl": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz",
+      "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==",
+      "license": "MIT",
+      "dependencies": {
+        "buffer": "^5.5.0",
+        "inherits": "^2.0.4",
+        "readable-stream": "^3.4.0"
+      }
+    },
+    "node_modules/body-parser": {
+      "version": "2.2.2",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.2.tgz",
+      "integrity": "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "^3.1.2",
+        "content-type": "^1.0.5",
+        "debug": "^4.4.3",
+        "http-errors": "^2.0.0",
+        "iconv-lite": "^0.7.0",
+        "on-finished": "^2.4.1",
+        "qs": "^6.14.1",
+        "raw-body": "^3.0.1",
+        "type-is": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/buffer": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz",
+      "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.1.13"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "license": "MIT"
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/caseless": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz",
+      "integrity": "sha512-4tYFyifaFfGacoiObjJegolkwSU4xQNGbVgUiNYVUxbQ2x2lUsFvY4hVgVzGiIe6WLOPqycWXA40l+PWsxthUw==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/chownr": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz",
+      "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==",
+      "license": "ISC"
+    },
+    "node_modules/concat-stream": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz",
+      "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==",
+      "engines": [
+        "node >= 6.0"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.0.2",
+        "typedarray": "^0.0.6"
+      }
+    },
+    "node_modules/content-disposition": {
+      "version": "0.5.4",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
+      "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "5.2.1"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz",
+      "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
+      "license": "MIT"
+    },
+    "node_modules/cors": {
+      "version": "2.8.6",
+      "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
+      "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==",
+      "license": "MIT",
+      "dependencies": {
+        "object-assign": "^4",
+        "vary": "^1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/cross-spawn/node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decompress-response": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
+      "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==",
+      "license": "MIT",
+      "dependencies": {
+        "mimic-response": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/deep-extend": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
+      "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/denque": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz",
+      "integrity": "sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==",
+      "devOptional": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/destroy": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
+      "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/detect-libc": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "17.4.2",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz",
+      "integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/drizzle-kit": {
+      "version": "0.31.10",
+      "resolved": "https://registry.npmjs.org/drizzle-kit/-/drizzle-kit-0.31.10.tgz",
+      "integrity": "sha512-7OZcmQUrdGI+DUNNsKBn1aW8qSoKuTH7d0mYgSP8bAzdFzKoovxEFnoGQp2dVs82EOJeYycqRtciopszwUf8bw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@drizzle-team/brocli": "^0.10.2",
+        "@esbuild-kit/esm-loader": "^2.5.5",
+        "esbuild": "^0.25.4",
+        "tsx": "^4.21.0"
+      },
+      "bin": {
+        "drizzle-kit": "bin.cjs"
+      }
+    },
+    "node_modules/drizzle-orm": {
+      "version": "0.45.1",
+      "resolved": "https://registry.npmjs.org/drizzle-orm/-/drizzle-orm-0.45.1.tgz",
+      "integrity": "sha512-Te0FOdKIistGNPMq2jscdqngBRfBpC8uMFVwqjf6gtTVJHIQ/dosgV/CLBU2N4ZJBsXL5savCba9b0YJskKdcA==",
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "@aws-sdk/client-rds-data": ">=3",
+        "@cloudflare/workers-types": ">=4",
+        "@electric-sql/pglite": ">=0.2.0",
+        "@libsql/client": ">=0.10.0",
+        "@libsql/client-wasm": ">=0.10.0",
+        "@neondatabase/serverless": ">=0.10.0",
+        "@op-engineering/op-sqlite": ">=2",
+        "@opentelemetry/api": "^1.4.1",
+        "@planetscale/database": ">=1.13",
+        "@prisma/client": "*",
+        "@tidbcloud/serverless": "*",
+        "@types/better-sqlite3": "*",
+        "@types/pg": "*",
+        "@types/sql.js": "*",
+        "@upstash/redis": ">=1.34.7",
+        "@vercel/postgres": ">=0.8.0",
+        "@xata.io/client": "*",
+        "better-sqlite3": ">=7",
+        "bun-types": "*",
+        "expo-sqlite": ">=14.0.0",
+        "gel": ">=2",
+        "knex": "*",
+        "kysely": "*",
+        "mysql2": ">=2",
+        "pg": ">=8",
+        "postgres": ">=3",
+        "sql.js": ">=1",
+        "sqlite3": ">=5"
+      },
+      "peerDependenciesMeta": {
+        "@aws-sdk/client-rds-data": {
+          "optional": true
+        },
+        "@cloudflare/workers-types": {
+          "optional": true
+        },
+        "@electric-sql/pglite": {
+          "optional": true
+        },
+        "@libsql/client": {
+          "optional": true
+        },
+        "@libsql/client-wasm": {
+          "optional": true
+        },
+        "@neondatabase/serverless": {
+          "optional": true
+        },
+        "@op-engineering/op-sqlite": {
+          "optional": true
+        },
+        "@opentelemetry/api": {
+          "optional": true
+        },
+        "@planetscale/database": {
+          "optional": true
+        },
+        "@prisma/client": {
+          "optional": true
+        },
+        "@tidbcloud/serverless": {
+          "optional": true
+        },
+        "@types/better-sqlite3": {
+          "optional": true
+        },
+        "@types/pg": {
+          "optional": true
+        },
+        "@types/sql.js": {
+          "optional": true
+        },
+        "@upstash/redis": {
+          "optional": true
+        },
+        "@vercel/postgres": {
+          "optional": true
+        },
+        "@xata.io/client": {
+          "optional": true
+        },
+        "better-sqlite3": {
+          "optional": true
+        },
+        "bun-types": {
+          "optional": true
+        },
+        "expo-sqlite": {
+          "optional": true
+        },
+        "gel": {
+          "optional": true
+        },
+        "knex": {
+          "optional": true
+        },
+        "kysely": {
+          "optional": true
+        },
+        "mysql2": {
+          "optional": true
+        },
+        "pg": {
+          "optional": true
+        },
+        "postgres": {
+          "optional": true
+        },
+        "prisma": {
+          "optional": true
+        },
+        "sql.js": {
+          "optional": true
+        },
+        "sqlite3": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/end-of-stream": {
+      "version": "1.4.5",
+      "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz",
+      "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==",
+      "license": "MIT",
+      "dependencies": {
+        "once": "^1.4.0"
+      }
+    },
+    "node_modules/env-paths": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
+      "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
+      "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.12",
+        "@esbuild/android-arm": "0.25.12",
+        "@esbuild/android-arm64": "0.25.12",
+        "@esbuild/android-x64": "0.25.12",
+        "@esbuild/darwin-arm64": "0.25.12",
+        "@esbuild/darwin-x64": "0.25.12",
+        "@esbuild/freebsd-arm64": "0.25.12",
+        "@esbuild/freebsd-x64": "0.25.12",
+        "@esbuild/linux-arm": "0.25.12",
+        "@esbuild/linux-arm64": "0.25.12",
+        "@esbuild/linux-ia32": "0.25.12",
+        "@esbuild/linux-loong64": "0.25.12",
+        "@esbuild/linux-mips64el": "0.25.12",
+        "@esbuild/linux-ppc64": "0.25.12",
+        "@esbuild/linux-riscv64": "0.25.12",
+        "@esbuild/linux-s390x": "0.25.12",
+        "@esbuild/linux-x64": "0.25.12",
+        "@esbuild/netbsd-arm64": "0.25.12",
+        "@esbuild/netbsd-x64": "0.25.12",
+        "@esbuild/openbsd-arm64": "0.25.12",
+        "@esbuild/openbsd-x64": "0.25.12",
+        "@esbuild/openharmony-arm64": "0.25.12",
+        "@esbuild/sunos-x64": "0.25.12",
+        "@esbuild/win32-arm64": "0.25.12",
+        "@esbuild/win32-ia32": "0.25.12",
+        "@esbuild/win32-x64": "0.25.12"
+      }
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",
+      "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/esprima": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
+      "license": "BSD-2-Clause",
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/eventsource": {
+      "version": "3.0.7",
+      "resolved": "https://registry.npmjs.org/eventsource/-/eventsource-3.0.7.tgz",
+      "integrity": "sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==",
+      "license": "MIT",
+      "dependencies": {
+        "eventsource-parser": "^3.0.1"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/eventsource-parser": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.0.6.tgz",
+      "integrity": "sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/execa": {
+      "version": "9.6.1",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-9.6.1.tgz",
+      "integrity": "sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA==",
+      "license": "MIT",
+      "dependencies": {
+        "@sindresorhus/merge-streams": "^4.0.0",
+        "cross-spawn": "^7.0.6",
+        "figures": "^6.1.0",
+        "get-stream": "^9.0.0",
+        "human-signals": "^8.0.1",
+        "is-plain-obj": "^4.1.0",
+        "is-stream": "^4.0.1",
+        "npm-run-path": "^6.0.0",
+        "pretty-ms": "^9.2.0",
+        "signal-exit": "^4.1.0",
+        "strip-final-newline": "^4.0.0",
+        "yoctocolors": "^2.1.1"
+      },
+      "engines": {
+        "node": "^18.19.0 || >=20.5.0"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/execa?sponsor=1"
+      }
+    },
+    "node_modules/expand-template": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz",
+      "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==",
+      "license": "(MIT OR WTFPL)",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/express": {
+      "version": "4.22.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-4.22.1.tgz",
+      "integrity": "sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "~1.3.8",
+        "array-flatten": "1.1.1",
+        "body-parser": "~1.20.3",
+        "content-disposition": "~0.5.4",
+        "content-type": "~1.0.4",
+        "cookie": "~0.7.1",
+        "cookie-signature": "~1.0.6",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "finalhandler": "~1.3.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.0",
+        "merge-descriptors": "1.0.3",
+        "methods": "~1.1.2",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "path-to-regexp": "~0.1.12",
+        "proxy-addr": "~2.0.7",
+        "qs": "~6.14.0",
+        "range-parser": "~1.2.1",
+        "safe-buffer": "5.2.1",
+        "send": "~0.19.0",
+        "serve-static": "~1.16.2",
+        "setprototypeof": "1.2.0",
+        "statuses": "~2.0.1",
+        "type-is": "~1.6.18",
+        "utils-merge": "1.0.1",
+        "vary": "~1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/express-rate-limit": {
+      "version": "8.3.1",
+      "resolved": "https://registry.npmjs.org/express-rate-limit/-/express-rate-limit-8.3.1.tgz",
+      "integrity": "sha512-D1dKN+cmyPWuvB+G2SREQDzPY1agpBIcTa9sJxOPMCNeH3gwzhqJRDWCXW3gg0y//+LQ/8j52JbMROWyrKdMdw==",
+      "license": "MIT",
+      "dependencies": {
+        "ip-address": "10.1.0"
+      },
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/express-rate-limit"
+      },
+      "peerDependencies": {
+        "express": ">= 4.11"
+      }
+    },
+    "node_modules/express/node_modules/body-parser": {
+      "version": "1.20.4",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz",
+      "integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "content-type": "~1.0.5",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "~1.2.0",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "on-finished": "~2.4.1",
+        "qs": "~6.14.0",
+        "raw-body": "~2.5.3",
+        "type-is": "~1.6.18",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/express/node_modules/debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "2.0.0"
+      }
+    },
+    "node_modules/express/node_modules/iconv-lite": {
+      "version": "0.4.24",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/express/node_modules/media-typer": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
+      "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/express/node_modules/ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+      "license": "MIT"
+    },
+    "node_modules/express/node_modules/qs": {
+      "version": "6.14.2",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.2.tgz",
+      "integrity": "sha512-V/yCWTTF7VJ9hIh18Ugr2zhJMP01MY7c5kh4J870L7imm6/DIzBsNLTXzMwUA3yZ5b/KBqLx8Kp3uRvd7xSe3Q==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/express/node_modules/raw-body": {
+      "version": "2.5.3",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz",
+      "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/express/node_modules/type-is": {
+      "version": "1.6.18",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
+      "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+      "license": "MIT",
+      "dependencies": {
+        "media-typer": "0.3.0",
+        "mime-types": "~2.1.24"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/extend-shallow": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+      "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==",
+      "license": "MIT",
+      "dependencies": {
+        "is-extendable": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz",
+      "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/ffmpeg-static": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/ffmpeg-static/-/ffmpeg-static-5.3.0.tgz",
+      "integrity": "sha512-H+K6sW6TiIX6VGend0KQwthe+kaceeH/luE8dIZyOP35ik7ahYojDuqlTV1bOrtEwl01sy2HFNGQfi5IDJvotg==",
+      "hasInstallScript": true,
+      "license": "GPL-3.0-or-later",
+      "dependencies": {
+        "@derhuerst/http-basic": "^8.2.0",
+        "env-paths": "^2.2.0",
+        "https-proxy-agent": "^5.0.0",
+        "progress": "^2.0.3"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/ffprobe-static": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/ffprobe-static/-/ffprobe-static-3.1.0.tgz",
+      "integrity": "sha512-Dvpa9uhVMOYivhHKWLGDoa512J751qN1WZAIO+Xw4L/mrUSPxS4DApzSUDbCFE/LUq2+xYnznEahTd63AqBSpA==",
+      "license": "MIT"
+    },
+    "node_modules/figures": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/figures/-/figures-6.1.0.tgz",
+      "integrity": "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==",
+      "license": "MIT",
+      "dependencies": {
+        "is-unicode-supported": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/file-uri-to-path": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz",
+      "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==",
+      "license": "MIT"
+    },
+    "node_modules/finalhandler": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
+      "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "statuses": "~2.0.2",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/finalhandler/node_modules/debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "2.0.0"
+      }
+    },
+    "node_modules/finalhandler/node_modules/ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+      "license": "MIT"
+    },
+    "node_modules/fluent-ffmpeg": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/fluent-ffmpeg/-/fluent-ffmpeg-2.1.3.tgz",
+      "integrity": "sha512-Be3narBNt2s6bsaqP6Jzq91heDgOEaDCJAXcE3qcma/EJBSy5FB4cvO31XBInuAuKBx8Kptf8dkhjK0IOru39Q==",
+      "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.",
+      "license": "MIT",
+      "dependencies": {
+        "async": "^0.2.9",
+        "which": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
+      "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fs-constants": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz",
+      "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==",
+      "license": "MIT"
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/generate-function": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/generate-function/-/generate-function-2.3.1.tgz",
+      "integrity": "sha512-eeB5GfMNeevm/GRYq20ShmsaGcmI81kIX2K9XQx5miC8KdHaC6Jm0qQ8ZNeGOi7wYB8OsdxKs+Y2oVuTFuVwKQ==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-property": "^1.0.2"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/get-stream": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-9.0.1.tgz",
+      "integrity": "sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA==",
+      "license": "MIT",
+      "dependencies": {
+        "@sec-ant/readable-stream": "^0.4.1",
+        "is-stream": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/get-tsconfig": {
+      "version": "4.13.7",
+      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.7.tgz",
+      "integrity": "sha512-7tN6rFgBlMgpBML5j8typ92BKFi2sFQvIdpAqLA2beia5avZDrMs0FLZiM5etShWq5irVyGcGMEA1jcDaK7A/Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "resolve-pkg-maps": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+      }
+    },
+    "node_modules/github-from-package": {
+      "version": "0.0.0",
+      "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz",
+      "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==",
+      "license": "MIT"
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/gray-matter": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz",
+      "integrity": "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==",
+      "license": "MIT",
+      "dependencies": {
+        "js-yaml": "^3.13.1",
+        "kind-of": "^6.0.2",
+        "section-matter": "^1.0.0",
+        "strip-bom-string": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=6.0"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/hono": {
+      "version": "4.12.9",
+      "resolved": "https://registry.npmjs.org/hono/-/hono-4.12.9.tgz",
+      "integrity": "sha512-wy3T8Zm2bsEvxKZM5w21VdHDDcwVS1yUFFY6i8UobSsKfFceT7TOwhbhfKsDyx7tYQlmRM5FLpIuYvNFyjctiA==",
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=16.9.0"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/http-response-object": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/http-response-object/-/http-response-object-3.0.2.tgz",
+      "integrity": "sha512-bqX0XTF6fnXSQcEJ2Iuyr75yVakyjIDCqroJQ/aHfSdlM743Cwqoi2nDYMzLGWUcuTWGWy8AAvOKXTfiv6q9RA==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "^10.0.3"
+      }
+    },
+    "node_modules/http-response-object/node_modules/@types/node": {
+      "version": "10.17.60",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-10.17.60.tgz",
+      "integrity": "sha512-F0KIgDJfy2nA3zMLmWGKxcH2ZVEtCZXHHdOQs2gSaQ27+lNeEfGxzkIw90aXswATX7AZ33tahPbzy6KAfUreVw==",
+      "license": "MIT"
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",
+      "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==",
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "6",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/human-signals": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-8.0.1.tgz",
+      "integrity": "sha512-eKCa6bwnJhvxj14kZk5NCPc6Hb6BdsU9DZcOnmQKSnO1VKrfV0zCvtttPZUsBvjmNDn8rpcJfpwSYnHBjc95MQ==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.2.tgz",
+      "integrity": "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/ignore": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz",
+      "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ini": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
+      "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
+      "license": "ISC"
+    },
+    "node_modules/ip-address": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.1.0.tgz",
+      "integrity": "sha512-XXADHxXmvT9+CRxhXg56LJovE+bmWnEWB78LB83VZTprKTmaC5QfruXocxzTZ2Kl0DNwKuBdlIhjL8LeY8Sf8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/is-extendable": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
+      "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-network-error": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/is-network-error/-/is-network-error-1.3.1.tgz",
+      "integrity": "sha512-6QCxa49rQbmUWLfk0nuGqzql9U8uaV2H6279bRErPBHe/109hCzsLUBUHfbEtvLIHBd6hyXbgedBSHevm43Edw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-plain-obj": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz",
+      "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-promise": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
+      "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==",
+      "license": "MIT"
+    },
+    "node_modules/is-property": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-property/-/is-property-1.0.2.tgz",
+      "integrity": "sha512-Ks/IoX00TtClbGQr4TWXemAnktAQvYB7HzcCxDGqEZU6oCmb2INHuOoKxbtR+HFkmYWBKv/dOZtGRiAjDhj92g==",
+      "devOptional": true,
+      "license": "MIT"
+    },
+    "node_modules/is-stream": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-4.0.1.tgz",
+      "integrity": "sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-unicode-supported": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-2.1.0.tgz",
+      "integrity": "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "license": "ISC"
+    },
+    "node_modules/jose": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/jose/-/jose-6.2.2.tgz",
+      "integrity": "sha512-d7kPDd34KO/YnzaDOlikGpOurfF0ByC2sEV4cANCtdqLlTfBlw2p14O/5d/zv40gJPbIQxfES3nSx1/oYNyuZQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/panva"
+      }
+    },
+    "node_modules/js-tiktoken": {
+      "version": "1.0.21",
+      "resolved": "https://registry.npmjs.org/js-tiktoken/-/js-tiktoken-1.0.21.tgz",
+      "integrity": "sha512-biOj/6M5qdgx5TKjDnFT1ymSpM5tbd3ylwDtrQvFQSu0Z7bBYko2dF+W/aUkXUPuk6IVpRxk/3Q2sHOzGlS36g==",
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.5.1"
+      }
+    },
+    "node_modules/js-yaml": {
+      "version": "3.14.2",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
+      "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==",
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-schema": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz",
+      "integrity": "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==",
+      "license": "(AFL-2.1 OR BSD-3-Clause)"
+    },
+    "node_modules/json-schema-to-zod": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/json-schema-to-zod/-/json-schema-to-zod-2.7.0.tgz",
+      "integrity": "sha512-eW59l3NQ6sa3HcB+Ahf7pP6iGU7MY4we5JsPqXQ2ZcIPF8QxSg/lkY8lN0Js/AG0NjMbk+nZGUfHlceiHF+bwQ==",
+      "license": "ISC",
+      "bin": {
+        "json-schema-to-zod": "dist/cjs/cli.js"
+      }
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
+    "node_modules/json-schema-typed": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/json-schema-typed/-/json-schema-typed-8.0.2.tgz",
+      "integrity": "sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==",
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/kind-of": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
+      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/long": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",
+      "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==",
+      "devOptional": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/lru-cache": {
+      "version": "11.2.7",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz",
+      "integrity": "sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/lru.min": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/lru.min/-/lru.min-1.1.4.tgz",
+      "integrity": "sha512-DqC6n3QQ77zdFpCMASA1a3Jlb64Hv2N2DciFGkO/4L9+q/IpIAuRlKOvCXabtRW6cQf8usbmM6BE/TOPysCdIA==",
+      "devOptional": true,
+      "license": "MIT",
+      "engines": {
+        "bun": ">=1.0.0",
+        "deno": ">=1.30.0",
+        "node": ">=8.0.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wellwelwel"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz",
+      "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/merge-descriptors": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
+      "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/methods": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
+      "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
+      "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
+      "license": "MIT",
+      "bin": {
+        "mime": "cli.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mimic-response": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz",
+      "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/mkdirp-classic": {
+      "version": "0.5.3",
+      "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz",
+      "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==",
+      "license": "MIT"
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/mysql2": {
+      "version": "3.22.5",
+      "resolved": "https://registry.npmjs.org/mysql2/-/mysql2-3.22.5.tgz",
+      "integrity": "sha512-95uZ2TrPWAZdwpB3vvvDbmEMcNG8yIeNCyu6GUcr/QnWEE/wXm7+mhOCsdQfWQDTV7qYT/PDUZ4U4UPP4AsXqQ==",
+      "devOptional": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "aws-ssl-profiles": "^1.1.2",
+        "denque": "^2.1.0",
+        "generate-function": "^2.3.1",
+        "iconv-lite": "^0.7.2",
+        "long": "^5.3.2",
+        "lru.min": "^1.1.4",
+        "named-placeholders": "^1.1.6",
+        "sql-escaper": "^1.3.3"
+      },
+      "engines": {
+        "node": ">= 8.0"
+      },
+      "peerDependencies": {
+        "@types/node": ">= 8"
+      }
+    },
+    "node_modules/named-placeholders": {
+      "version": "1.1.6",
+      "resolved": "https://registry.npmjs.org/named-placeholders/-/named-placeholders-1.1.6.tgz",
+      "integrity": "sha512-Tz09sEL2EEuv5fFowm419c1+a/jSMiBjI9gHxVLrVdbUkkNUUfjsVYs9pVZu5oCon/kmRh9TfLEObFtkVxmY0w==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "lru.min": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/napi-build-utils": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-1.0.2.tgz",
+      "integrity": "sha512-ONmRUqK7zj7DWX0D9ADe03wbwOBZxNAfF20PlGfCWQcD3+/MakShIHrMqx9YwPTfxDdF1zLeL+RGZiR9kGMLdg==",
+      "license": "MIT"
+    },
+    "node_modules/negotiator": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
+      "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/node-abi": {
+      "version": "3.96.0",
+      "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.96.0.tgz",
+      "integrity": "sha512-rebQ/lz7i0EkoLzUVSrKRzA69zMkwLp95kKMWoMDkkM00Suxz0D7zEQPwRml5fQum24mj7bPvmlgLAmu2JCiYg==",
+      "license": "MIT",
+      "dependencies": {
+        "semver": "^7.3.5"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/npm-run-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-6.0.0.tgz",
+      "integrity": "sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA==",
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^4.0.0",
+        "unicorn-magic": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/npm-run-path/node_modules/path-key": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+      "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/on-exit-leak-free": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/on-exit-leak-free/-/on-exit-leak-free-2.1.2.tgz",
+      "integrity": "sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/openapi-types": {
+      "version": "12.1.3",
+      "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz",
+      "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==",
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/p-map": {
+      "version": "7.0.4",
+      "resolved": "https://registry.npmjs.org/p-map/-/p-map-7.0.4.tgz",
+      "integrity": "sha512-tkAQEw8ysMzmkhgw8k+1U/iPhWNhykKnSk4Rd5zLoPJCuJaGRPo6YposrZgaxHKzDHdDWWZvE/Sk7hsL2X/CpQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-retry": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-7.1.1.tgz",
+      "integrity": "sha512-J5ApzjyRkkf601HpEeykoiCvzHQjWxPAHhyjFcEUP2SWq0+35NKh8TLhpLw+Dkq5TZBFvUM6UigdE9hIVYTl5w==",
+      "license": "MIT",
+      "dependencies": {
+        "is-network-error": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/parse-cache-control": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/parse-cache-control/-/parse-cache-control-1.0.1.tgz",
+      "integrity": "sha512-60zvsJReQPX5/QP0Kzfd/VrpjScIQ7SHBW6bFCYfEP+fp0Eppr1SHhIO5nd1PjZtvclzSzES9D/p5nFJurwfWg=="
+    },
+    "node_modules/parse-ms": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/parse-ms/-/parse-ms-4.0.0.tgz",
+      "integrity": "sha512-TXfryirbmq34y8QBwgqCVLi+8oA3oWx2eAnSn62ITyEhEYaWRlVZ2DvMM9eZbMs/RfxPu/PK/aBLyGj4IrqMHw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-to-regexp": {
+      "version": "0.1.13",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz",
+      "integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==",
+      "license": "MIT"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pino": {
+      "version": "10.3.1",
+      "resolved": "https://registry.npmjs.org/pino/-/pino-10.3.1.tgz",
+      "integrity": "sha512-r34yH/GlQpKZbU1BvFFqOjhISRo1MNx1tWYsYvmj6KIRHSPMT2+yHOEb1SG6NMvRoHRF0a07kCOox/9yakl1vg==",
+      "license": "MIT",
+      "dependencies": {
+        "@pinojs/redact": "^0.4.0",
+        "atomic-sleep": "^1.0.0",
+        "on-exit-leak-free": "^2.1.0",
+        "pino-abstract-transport": "^3.0.0",
+        "pino-std-serializers": "^7.0.0",
+        "process-warning": "^5.0.0",
+        "quick-format-unescaped": "^4.0.3",
+        "real-require": "^0.2.0",
+        "safe-stable-stringify": "^2.3.1",
+        "sonic-boom": "^4.0.1",
+        "thread-stream": "^4.0.0"
+      },
+      "bin": {
+        "pino": "bin.js"
+      }
+    },
+    "node_modules/pino-abstract-transport": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/pino-abstract-transport/-/pino-abstract-transport-3.0.0.tgz",
+      "integrity": "sha512-wlfUczU+n7Hy/Ha5j9a/gZNy7We5+cXp8YL+X+PG8S0KXxw7n/JXA3c46Y0zQznIJ83URJiwy7Lh56WLokNuxg==",
+      "license": "MIT",
+      "dependencies": {
+        "split2": "^4.0.0"
+      }
+    },
+    "node_modules/pino-std-serializers": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/pino-std-serializers/-/pino-std-serializers-7.1.0.tgz",
+      "integrity": "sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw==",
+      "license": "MIT"
+    },
+    "node_modules/pkce-challenge": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/pkce-challenge/-/pkce-challenge-5.0.1.tgz",
+      "integrity": "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.20.0"
+      }
+    },
+    "node_modules/prebuild-install": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.2.tgz",
+      "integrity": "sha512-UnNke3IQb6sgarcZIDU3gbMeTp/9SSU1DAIkil7PrqG1vZlBtY5msYccSKSHDqa3hNg436IXK+SNImReuA1wEQ==",
+      "license": "MIT",
+      "dependencies": {
+        "detect-libc": "^2.0.0",
+        "expand-template": "^2.0.3",
+        "github-from-package": "0.0.0",
+        "minimist": "^1.2.3",
+        "mkdirp-classic": "^0.5.3",
+        "napi-build-utils": "^1.0.1",
+        "node-abi": "^3.3.0",
+        "pump": "^3.0.0",
+        "rc": "^1.2.7",
+        "simple-get": "^4.0.0",
+        "tar-fs": "^2.0.0",
+        "tunnel-agent": "^0.6.0"
+      },
+      "bin": {
+        "prebuild-install": "bin.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/pretty-ms": {
+      "version": "9.3.0",
+      "resolved": "https://registry.npmjs.org/pretty-ms/-/pretty-ms-9.3.0.tgz",
+      "integrity": "sha512-gjVS5hOP+M3wMm5nmNOucbIrqudzs9v/57bWRHQWLYklXqoXKrVfYW2W9+glfGsqtPgpiz5WwyEEB+ksXIx3gQ==",
+      "license": "MIT",
+      "dependencies": {
+        "parse-ms": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/process-warning": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-5.0.0.tgz",
+      "integrity": "sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/progress": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
+      "integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "license": "MIT",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/pump": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.4.tgz",
+      "integrity": "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==",
+      "license": "MIT",
+      "dependencies": {
+        "end-of-stream": "^1.1.0",
+        "once": "^1.3.1"
+      }
+    },
+    "node_modules/qs": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.0.tgz",
+      "integrity": "sha512-mAZTtNCeetKMH+pSjrb76NAM8V9a05I9aBZOHztWy/UqcJdQYNsf59vrRKWnojAT9Y+GbIvoTBC++CPHqpDBhQ==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/quansync": {
+      "version": "0.2.11",
+      "resolved": "https://registry.npmjs.org/quansync/-/quansync-0.2.11.tgz",
+      "integrity": "sha512-AifT7QEbW9Nri4tAwR5M/uzpBuqfZf+zwaEM/QkzEjj7NBuFD2rBuy0K3dE+8wltbezDV7JMA0WfnCPYRSYbXA==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/antfu"
+        },
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/sxzz"
+        }
+      ],
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/quick-format-unescaped": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/quick-format-unescaped/-/quick-format-unescaped-4.0.4.tgz",
+      "integrity": "sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg==",
+      "license": "MIT"
+    },
+    "node_modules/radash": {
+      "version": "12.1.1",
+      "resolved": "https://registry.npmjs.org/radash/-/radash-12.1.1.tgz",
+      "integrity": "sha512-h36JMxKRqrAxVD8201FrCpyeNuUY9Y5zZwujr20fFO77tpUtGa6EZzfKw/3WaiBX95fq7+MpsuMLNdSnORAwSA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.18.0"
+      }
+    },
+    "node_modules/range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz",
+      "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.7.0",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/rc": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz",
+      "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==",
+      "license": "(BSD-2-Clause OR MIT OR Apache-2.0)",
+      "dependencies": {
+        "deep-extend": "^0.6.0",
+        "ini": "~1.3.0",
+        "minimist": "^1.2.0",
+        "strip-json-comments": "~2.0.1"
+      },
+      "bin": {
+        "rc": "cli.js"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/real-require": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/real-require/-/real-require-0.2.0.tgz",
+      "integrity": "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12.13.0"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/resolve-pkg-maps": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+      }
+    },
+    "node_modules/router": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
+      "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "is-promise": "^4.0.0",
+        "parseurl": "^1.3.3",
+        "path-to-regexp": "^8.0.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/router/node_modules/path-to-regexp": {
+      "version": "8.4.0",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.0.tgz",
+      "integrity": "sha512-PuseHIvAnz3bjrM2rGJtSgo1zjgxapTLZ7x2pjhzWwlp4SJQgK3f3iZIQwkpEnBaKz6seKBADpM4B4ySkuYypg==",
+      "license": "MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/safe-stable-stringify": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz",
+      "integrity": "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT"
+    },
+    "node_modules/section-matter": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/section-matter/-/section-matter-1.0.0.tgz",
+      "integrity": "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==",
+      "license": "MIT",
+      "dependencies": {
+        "extend-shallow": "^2.0.1",
+        "kind-of": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/secure-json-parse": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/secure-json-parse/-/secure-json-parse-2.7.0.tgz",
+      "integrity": "sha512-6aU+Rwsezw7VR8/nyvKTx8QpWH9FrcYiXXlqC4z5d5XQBDRqtbfsRjnwGyqbi3gddNtWHuEk9OANUotL26qKUw==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/semver": {
+      "version": "7.7.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz",
+      "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/send": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz",
+      "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "1.2.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.1",
+        "mime": "1.6.0",
+        "ms": "2.1.3",
+        "on-finished": "~2.4.1",
+        "range-parser": "~1.2.1",
+        "statuses": "~2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/send/node_modules/debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "2.0.0"
+      }
+    },
+    "node_modules/send/node_modules/debug/node_modules/ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+      "license": "MIT"
+    },
+    "node_modules/serve-static": {
+      "version": "1.16.3",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz",
+      "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "parseurl": "~1.3.3",
+        "send": "~0.19.1"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
+    "node_modules/sharp": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.5.tgz",
+      "integrity": "sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==",
+      "hasInstallScript": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@img/colour": "^1.0.0",
+        "detect-libc": "^2.1.2",
+        "semver": "^7.7.3"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-darwin-arm64": "0.34.5",
+        "@img/sharp-darwin-x64": "0.34.5",
+        "@img/sharp-libvips-darwin-arm64": "1.2.4",
+        "@img/sharp-libvips-darwin-x64": "1.2.4",
+        "@img/sharp-libvips-linux-arm": "1.2.4",
+        "@img/sharp-libvips-linux-arm64": "1.2.4",
+        "@img/sharp-libvips-linux-ppc64": "1.2.4",
+        "@img/sharp-libvips-linux-riscv64": "1.2.4",
+        "@img/sharp-libvips-linux-s390x": "1.2.4",
+        "@img/sharp-libvips-linux-x64": "1.2.4",
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.4",
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.4",
+        "@img/sharp-linux-arm": "0.34.5",
+        "@img/sharp-linux-arm64": "0.34.5",
+        "@img/sharp-linux-ppc64": "0.34.5",
+        "@img/sharp-linux-riscv64": "0.34.5",
+        "@img/sharp-linux-s390x": "0.34.5",
+        "@img/sharp-linux-x64": "0.34.5",
+        "@img/sharp-linuxmusl-arm64": "0.34.5",
+        "@img/sharp-linuxmusl-x64": "0.34.5",
+        "@img/sharp-wasm32": "0.34.5",
+        "@img/sharp-win32-arm64": "0.34.5",
+        "@img/sharp-win32-ia32": "0.34.5",
+        "@img/sharp-win32-x64": "0.34.5"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/simple-concat": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz",
+      "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/simple-get": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz",
+      "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "decompress-response": "^6.0.0",
+        "once": "^1.3.1",
+        "simple-concat": "^1.0.0"
+      }
+    },
+    "node_modules/sonic-boom": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/sonic-boom/-/sonic-boom-4.2.1.tgz",
+      "integrity": "sha512-w6AxtubXa2wTXAUsZMMWERrsIRAdrK0Sc+FUytWvYAhBJLyuI4llrMIC1DtlNSdI99EI86KZum2MMq3EAZlF9Q==",
+      "license": "MIT",
+      "dependencies": {
+        "atomic-sleep": "^1.0.0"
+      }
+    },
+    "node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/source-map-support": {
+      "version": "0.5.21",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
+      "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "node_modules/split2": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz",
+      "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">= 10.x"
+      }
+    },
+    "node_modules/sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/sql-escaper": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/sql-escaper/-/sql-escaper-1.3.3.tgz",
+      "integrity": "sha512-BsTCV265VpTp8tm1wyIm1xqQCS+Q9NHx2Sr+WcnUrgLrQ6yiDIvHYJV5gHxsj1lMBy2zm5twLaZao8Jd+S8JJw==",
+      "devOptional": true,
+      "license": "MIT",
+      "engines": {
+        "bun": ">=1.0.0",
+        "deno": ">=2.0.0",
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/mysqljs/sql-escaper?sponsor=1"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/strip-bom-string": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/strip-bom-string/-/strip-bom-string-1.0.0.tgz",
+      "integrity": "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/strip-final-newline": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-4.0.0.tgz",
+      "integrity": "sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz",
+      "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/tar-fs": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.5.tgz",
+      "integrity": "sha512-OboTd8mmMhZDNPV+UjQcK9yKAatXu2aJ+r1w4im1Otd4M4fl2hwvdoXUxIYHFTHWK/3y3FarBP70v3vwmGlOxw==",
+      "license": "MIT",
+      "dependencies": {
+        "chownr": "^1.1.1",
+        "mkdirp-classic": "^0.5.2",
+        "pump": "^3.0.0",
+        "tar-stream": "^2.1.4"
+      }
+    },
+    "node_modules/tar-stream": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz",
+      "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==",
+      "license": "MIT",
+      "dependencies": {
+        "bl": "^4.0.3",
+        "end-of-stream": "^1.4.1",
+        "fs-constants": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.1.1"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/thread-stream": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/thread-stream/-/thread-stream-4.0.0.tgz",
+      "integrity": "sha512-4iMVL6HAINXWf1ZKZjIPcz5wYaOdPhtO8ATvZ+Xqp3BTdaqtAwQkNmKORqcIo5YkQqGXq5cwfswDwMqqQNrpJA==",
+      "license": "MIT",
+      "dependencies": {
+        "real-require": "^0.2.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "license": "0BSD",
+      "optional": true
+    },
+    "node_modules/tsx": {
+      "version": "4.21.0",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.21.0.tgz",
+      "integrity": "sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.27.0",
+        "get-tsconfig": "^4.7.5"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/aix-ppc64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.4.tgz",
+      "integrity": "sha512-cQPwL2mp2nSmHHJlCyoXgHGhbEPMrEEU5xhkcy3Hs/O7nGZqEpZ2sUtLaL9MORLtDfRvVl2/3PAuEkYZH0Ty8Q==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/android-arm": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.4.tgz",
+      "integrity": "sha512-X9bUgvxiC8CHAGKYufLIHGXPJWnr0OCdR0anD2e21vdvgCI8lIfqFbnoeOz7lBjdrAGUhqLZLcQo6MLhTO2DKQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/android-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.4.tgz",
+      "integrity": "sha512-gdLscB7v75wRfu7QSm/zg6Rx29VLdy9eTr2t44sfTW7CxwAtQghZ4ZnqHk3/ogz7xao0QAgrkradbBzcqFPasw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/android-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.4.tgz",
+      "integrity": "sha512-PzPFnBNVF292sfpfhiyiXCGSn9HZg5BcAz+ivBuSsl6Rk4ga1oEXAamhOXRFyMcjwr2DVtm40G65N3GLeH1Lvw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.4.tgz",
+      "integrity": "sha512-b7xaGIwdJlht8ZFCvMkpDN6uiSmnxxK56N2GDTMYPr2/gzvfdQN8rTfBsvVKmIVY/X7EM+/hJKEIbbHs9oA4tQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/darwin-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.4.tgz",
+      "integrity": "sha512-sR+OiKLwd15nmCdqpXMnuJ9W2kpy0KigzqScqHI3Hqwr7IXxBp3Yva+yJwoqh7rE8V77tdoheRYataNKL4QrPw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-jnfpKe+p79tCnm4GVav68A7tUFeKQwQyLgESwEAUzyxk/TJr4QdGog9sqWNcUbr/bZt/O/HXouspuQDd9JxFSw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/freebsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.4.tgz",
+      "integrity": "sha512-2kb4ceA/CpfUrIcTUl1wrP/9ad9Atrp5J94Lq69w7UwOMolPIGrfLSvAKJp0RTvkPPyn6CIWrNy13kyLikZRZQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-arm": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.4.tgz",
+      "integrity": "sha512-aBYgcIxX/wd5n2ys0yESGeYMGF+pv6g0DhZr3G1ZG4jMfruU9Tl1i2Z+Wnj9/KjGz1lTLCcorqE2viePZqj4Eg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.4.tgz",
+      "integrity": "sha512-7nQOttdzVGth1iz57kxg9uCz57dxQLHWxopL6mYuYthohPKEK0vU0C3O21CcBK6KDlkYVcnDXY099HcCDXd9dA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-ia32": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.4.tgz",
+      "integrity": "sha512-oPtixtAIzgvzYcKBQM/qZ3R+9TEUd1aNJQu0HhGyqtx6oS7qTpvjheIWBbes4+qu1bNlo2V4cbkISr8q6gRBFA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-loong64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.4.tgz",
+      "integrity": "sha512-8mL/vh8qeCoRcFH2nM8wm5uJP+ZcVYGGayMavi8GmRJjuI3g1v6Z7Ni0JJKAJW+m0EtUuARb6Lmp4hMjzCBWzA==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-mips64el": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.4.tgz",
+      "integrity": "sha512-1RdrWFFiiLIW7LQq9Q2NES+HiD4NyT8Itj9AUeCl0IVCA459WnPhREKgwrpaIfTOe+/2rdntisegiPWn/r/aAw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-ppc64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.4.tgz",
+      "integrity": "sha512-tLCwNG47l3sd9lpfyx9LAGEGItCUeRCWeAx6x2Jmbav65nAwoPXfewtAdtbtit/pJFLUWOhpv0FpS6GQAmPrHA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-riscv64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.4.tgz",
+      "integrity": "sha512-BnASypppbUWyqjd1KIpU4AUBiIhVr6YlHx/cnPgqEkNoVOhHg+YiSVxM1RLfiy4t9cAulbRGTNCKOcqHrEQLIw==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-s390x": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.4.tgz",
+      "integrity": "sha512-+eUqgb/Z7vxVLezG8bVB9SfBie89gMueS+I0xYh2tJdw3vqA/0ImZJ2ROeWwVJN59ihBeZ7Tu92dF/5dy5FttA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.4.tgz",
+      "integrity": "sha512-S5qOXrKV8BQEzJPVxAwnryi2+Iq5pB40gTEIT69BQONqR7JH1EPIcQ/Uiv9mCnn05jff9umq/5nqzxlqTOg9NA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-xHT8X4sb0GS8qTqiwzHqpY00C95DPAq7nAwX35Ie/s+LO9830hrMd3oX0ZMKLvy7vsonee73x0lmcdOVXFzd6Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/netbsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.4.tgz",
+      "integrity": "sha512-RugOvOdXfdyi5Tyv40kgQnI0byv66BFgAqjdgtAKqHoZTbTF2QqfQrFwa7cHEORJf6X2ht+l9ABLMP0dnKYsgg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-2MyL3IAaTX+1/qP0O1SwskwcwCoOI4kV2IBX1xYnDDqthmq5ArrW94qSIKCAuRraMgPOmG0RDTA74mzYNQA9ow==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/openbsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.4.tgz",
+      "integrity": "sha512-u8fg/jQ5aQDfsnIV6+KwLOf1CmJnfu1ShpwqdwC0uA7ZPwFws55Ngc12vBdeUdnuWoQYx/SOQLGDcdlfXhYmXQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.4.tgz",
+      "integrity": "sha512-JkTZrl6VbyO8lDQO3yv26nNr2RM2yZzNrNHEsj9bm6dOwwu9OYN28CjzZkH57bh4w0I2F7IodpQvUAEd1mbWXg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/sunos-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.4.tgz",
+      "integrity": "sha512-/gOzgaewZJfeJTlsWhvUEmUG4tWEY2Spp5M20INYRg2ZKl9QPO3QEEgPeRtLjEWSW8FilRNacPOg8R1uaYkA6g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/win32-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.4.tgz",
+      "integrity": "sha512-Z9SExBg2y32smoDQdf1HRwHRt6vAHLXcxD2uGgO/v2jK7Y718Ix4ndsbNMU/+1Qiem9OiOdaqitioZwxivhXYg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/win32-ia32": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.4.tgz",
+      "integrity": "sha512-DAyGLS0Jz5G5iixEbMHi5KdiApqHBWMGzTtMiJ72ZOLhbu/bzxgAe8Ue8CTS3n3HbIUHQz/L51yMdGMeoxXNJw==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/win32-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.4.tgz",
+      "integrity": "sha512-+knoa0BDoeXgkNvvV1vvbZX4+hizelrkwmGJBdT17t8FNPwG2lKemmuMZlmaNQ3ws3DKKCxpb4zRZEIp3UxFCg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/esbuild": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.4.tgz",
+      "integrity": "sha512-Rq4vbHnYkK5fws5NF7MYTU68FPRE1ajX7heQ/8QXXWqNgqqJ/GkmmyxIzUnf2Sr/bakf8l54716CcMGHYhMrrQ==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.4",
+        "@esbuild/android-arm": "0.27.4",
+        "@esbuild/android-arm64": "0.27.4",
+        "@esbuild/android-x64": "0.27.4",
+        "@esbuild/darwin-arm64": "0.27.4",
+        "@esbuild/darwin-x64": "0.27.4",
+        "@esbuild/freebsd-arm64": "0.27.4",
+        "@esbuild/freebsd-x64": "0.27.4",
+        "@esbuild/linux-arm": "0.27.4",
+        "@esbuild/linux-arm64": "0.27.4",
+        "@esbuild/linux-ia32": "0.27.4",
+        "@esbuild/linux-loong64": "0.27.4",
+        "@esbuild/linux-mips64el": "0.27.4",
+        "@esbuild/linux-ppc64": "0.27.4",
+        "@esbuild/linux-riscv64": "0.27.4",
+        "@esbuild/linux-s390x": "0.27.4",
+        "@esbuild/linux-x64": "0.27.4",
+        "@esbuild/netbsd-arm64": "0.27.4",
+        "@esbuild/netbsd-x64": "0.27.4",
+        "@esbuild/openbsd-arm64": "0.27.4",
+        "@esbuild/openbsd-x64": "0.27.4",
+        "@esbuild/openharmony-arm64": "0.27.4",
+        "@esbuild/sunos-x64": "0.27.4",
+        "@esbuild/win32-arm64": "0.27.4",
+        "@esbuild/win32-ia32": "0.27.4",
+        "@esbuild/win32-x64": "0.27.4"
+      }
+    },
+    "node_modules/tunnel-agent": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz",
+      "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "safe-buffer": "^5.0.1"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/type-is": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.0.1.tgz",
+      "integrity": "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==",
+      "license": "MIT",
+      "dependencies": {
+        "content-type": "^1.0.5",
+        "media-typer": "^1.1.0",
+        "mime-types": "^3.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/type-is/node_modules/mime-db": {
+      "version": "1.54.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/type-is/node_modules/mime-types": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz",
+      "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "^1.54.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/typedarray": {
+      "version": "0.0.6",
+      "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz",
+      "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==",
+      "license": "MIT"
+    },
+    "node_modules/typescript": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.2.tgz",
+      "integrity": "sha512-bGdAIrZ0wiGDo5l8c++HWtbaNCWTS4UTv7RaTH/ThVIgjkveJt83m74bBHMJkuCbslY8ixgLBVZJIOiQlQTjfQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "7.18.2",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz",
+      "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==",
+      "license": "MIT"
+    },
+    "node_modules/unicorn-magic": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.3.0.tgz",
+      "integrity": "sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT"
+    },
+    "node_modules/utils-merge": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
+      "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4.0"
+      }
+    },
+    "node_modules/uuid": {
+      "version": "13.0.0",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-13.0.0.tgz",
+      "integrity": "sha512-XQegIaBTVUjSHliKqcnFqYypAd4S+WCYt5NIeRs6w/UAry7z8Y9j5ZwRRL4kzq9U3sD6v+85er9FvkEaBpji2w==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist-node/bin/uuid"
+      }
+    },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/which": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
+      "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==",
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "which": "bin/which"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "license": "ISC"
+    },
+    "node_modules/ws": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
+      "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/xxhash-wasm": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/xxhash-wasm/-/xxhash-wasm-1.1.0.tgz",
+      "integrity": "sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==",
+      "license": "MIT"
+    },
+    "node_modules/yoctocolors": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/yoctocolors/-/yoctocolors-2.1.2.tgz",
+      "integrity": "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/zod": {
+      "version": "4.3.6",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.3.6.tgz",
+      "integrity": "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg==",
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    },
+    "node_modules/zod-from-json-schema": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/zod-from-json-schema/-/zod-from-json-schema-0.5.2.tgz",
+      "integrity": "sha512-/dNaicfdhJTOuUd4RImbLUE2g5yrSzzDjI/S6C2vO2ecAGZzn9UcRVgtyLSnENSmAOBRiSpUdzDS6fDWX3Z35g==",
+      "license": "MIT",
+      "dependencies": {
+        "zod": "^4.0.17"
+      }
+    },
+    "node_modules/zod-from-json-schema-v3": {
+      "name": "zod-from-json-schema",
+      "version": "0.0.5",
+      "resolved": "https://registry.npmjs.org/zod-from-json-schema/-/zod-from-json-schema-0.0.5.tgz",
+      "integrity": "sha512-zYEoo86M1qpA1Pq6329oSyHLS785z/mTwfr9V1Xf/ZLhuuBGaMlDGu/pDVGVUe4H4oa1EFgWZT53DP0U3oT9CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "zod": "^3.24.2"
+      }
+    },
+    "node_modules/zod-from-json-schema-v3/node_modules/zod": {
+      "version": "3.25.76",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
+      "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    },
+    "node_modules/zod-to-json-schema": {
+      "version": "3.25.1",
+      "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.25.1.tgz",
+      "integrity": "sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA==",
+      "license": "ISC",
+      "peerDependencies": {
+        "zod": "^3.25 || ^4"
+      }
+    }
+  }
+}
diff --git a/huobao-source/backend/package.json b/huobao-source/backend/package.json
new file mode 100644
index 0000000..28755a2
--- /dev/null
+++ b/huobao-source/backend/package.json
@@ -0,0 +1,50 @@
+{
+  "name": "server",
+  "version": "1.0.0",
+  "description": "",
+  "main": "src/index.ts",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "start": "tsx src/index.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "backfill-artwork": "tsx scripts/backfill-artwork.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "CC BY-NC-SA-4.0",
+  "type": "module",
+  "dependencies": {
+    "@ai-sdk/google": "^3.0.53",
+    "@ai-sdk/openai": "^3.0.48",
+    "@hono/node-server": "^1.19.11",
+    "@mastra/core": "^1.17.0",
+    "better-sqlite3": "^12.4.1",
+    "dotenv": "^17.4.2",
+    "drizzle-orm": "^0.45.1",
+    "ffmpeg-static": "^5.3.0",
+    "ffprobe-static": "^3.1.0",
+    "fluent-ffmpeg": "^2.1.3",
+    "hono": "^4.12.9",
+    "pino": "^10.3.1",
+    "sharp": "^0.34.5",
+    "uuid": "^13.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/fluent-ffmpeg": "^2.1.28",
+    "@types/node": "^25.5.0",
+    "@types/uuid": "^10.0.0",
+    "drizzle-kit": "^0.31.10",
+    "mysql2": "^3.22.5",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "ffmpeg-static",
+      "ffprobe-static"
+    ]
+  }
+}
diff --git a/huobao-source/backend/scripts/backfill-artwork.ts b/huobao-source/backend/scripts/backfill-artwork.ts
new file mode 100644
index 0000000..5b52aa1
--- /dev/null
+++ b/huobao-source/backend/scripts/backfill-artwork.ts
@@ -0,0 +1,60 @@
+/**
+ * 存量文件回填脚本 — 为历史生成的图片/视频补生成缩略图和海报帧
+ *
+ * 用法：cd backend && npx tsx scripts/backfill-artwork.ts
+ *
+ * 扫描 data/static 下：
+ *   images/  → 为缺少 *_thumb.webp 的图片生成缩略图（宽 400 WebP）
+ *   videos/、merged/ → 为缺少 *_poster.jpg 的视频抽取海报帧
+ * 已存在的跳过，可重复执行。
+ */
+import fs from 'fs'
+import path from 'path'
+import { generateImageThumb, thumbPathFor, getAbsolutePath } from '../src/utils/storage.js'
+import { extractVideoPoster, posterPathFor } from '../src/utils/video-poster.js'
+import { STORAGE_ROOT } from '../src/utils/paths.js'
+
+const IMAGE_EXTS = new Set(['.png', '.jpg', '.jpeg', '.webp', '.gif'])
+const VIDEO_EXTS = new Set(['.mp4', '.webm', '.mov'])
+
+function listFiles(subDir: string): string[] {
+  const dir = path.join(STORAGE_ROOT, subDir)
+  if (!fs.existsSync(dir)) return []
+  return fs.readdirSync(dir).filter(f => fs.statSync(path.join(dir, f)).isFile())
+}
+
+async function backfillImages(subDir: string) {
+  let done = 0, skipped = 0, failed = 0
+  for (const file of listFiles(subDir)) {
+    const ext = path.extname(file).toLowerCase()
+    if (!IMAGE_EXTS.has(ext) || file.endsWith('_thumb.webp')) continue
+    const rel = `static/${subDir}/${file}`
+    if (fs.existsSync(getAbsolutePath(thumbPathFor(rel)))) { skipped++; continue }
+    const ok = await generateImageThumb(rel)
+    ok ? done++ : failed++
+    if (ok) console.log(`  thumb ✓ ${rel}`)
+    else console.warn(`  thumb ✗ ${rel}`)
+  }
+  console.log(`[${subDir}] 缩略图：新生成 ${done}，已存在 ${skipped}，失败 ${failed}`)
+}
+
+async function backfillVideos(subDir: string) {
+  let done = 0, skipped = 0, failed = 0
+  for (const file of listFiles(subDir)) {
+    const ext = path.extname(file).toLowerCase()
+    if (!VIDEO_EXTS.has(ext)) continue
+    const rel = `static/${subDir}/${file}`
+    if (fs.existsSync(getAbsolutePath(posterPathFor(rel)))) { skipped++; continue }
+    const ok = await extractVideoPoster(rel)
+    ok ? done++ : failed++
+    if (ok) console.log(`  poster ✓ ${rel}`)
+    else console.warn(`  poster ✗ ${rel}`)
+  }
+  console.log(`[${subDir}] 海报帧：新生成 ${done}，已存在 ${skipped}，失败 ${failed}`)
+}
+
+console.log(`回填目录：${STORAGE_ROOT}`)
+await backfillImages('images')
+await backfillVideos('videos')
+await backfillVideos('merged')
+console.log('回填完成')
diff --git a/huobao-source/backend/scripts/import-mysql-to-sqlite.ts b/huobao-source/backend/scripts/import-mysql-to-sqlite.ts
new file mode 100644
index 0000000..2c608b2
--- /dev/null
+++ b/huobao-source/backend/scripts/import-mysql-to-sqlite.ts
@@ -0,0 +1,74 @@
+/**
+ * MySQL → SQLite 一次性数据迁移脚本（CLI）
+ *
+ * 用法：cd backend && npx tsx scripts/import-mysql-to-sqlite.ts [--force]
+ *
+ * - 源：MySQL（读取 DATABASE_URL 或 MYSQL_* 环境变量，兼容 backend/.env）
+ * - 目标：SQLITE_PATH 环境变量，默认仓库根 data/huobao.sqlite3
+ * - 表结构由 initSqliteSchema 幂等创建；数据显式带 id 写入（AUTOINCREMENT 表
+ *   插入后 sqlite_sequence 自动对齐 max(id)）
+ * - 目标库已有业务数据时须 --force 才允许写入；写入前自动备份 .bak
+ * - 逐表行数对照，不一致则非零退出
+ *
+ * 注意：服务启动时已内置同逻辑的自动迁移（src/db/mysql-import.ts，
+ * 显式配置 MySQL + 空库时触发），本脚本用于手动/强制场景。
+ */
+import 'dotenv/config'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import mysql from 'mysql2/promise'
+import Database from 'better-sqlite3'
+import { initSqliteSchema } from '../src/db/sqlite-schema.js'
+import { importMysqlData, mysqlUrlFromEnv, sqliteBusinessRowCount } from '../src/db/mysql-import.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const force = process.argv.includes('--force')
+
+const repoRoot = path.resolve(__dirname, '../..')
+const sqlitePath = process.env.SQLITE_PATH || path.join(repoRoot, 'data', 'huobao.sqlite3')
+
+async function main() {
+  const url = mysqlUrlFromEnv()
+  if (!url) {
+    console.error('未检测到 MySQL 配置（DATABASE_URL 或 MYSQL_HOST）')
+    process.exit(1)
+  }
+  const mysqlPool = mysql.createPool({ uri: url, connectionLimit: 4, charset: 'utf8mb4' })
+
+  // 备份已有目标库（仅当文件存在且非空库时才需要 --force，备份无条件做）
+  if (fs.existsSync(sqlitePath)) {
+    const backup = `${sqlitePath}.bak-${Date.now()}`
+    fs.copyFileSync(sqlitePath, backup)
+    console.log(`已备份现有库 → ${backup}`)
+  }
+  fs.mkdirSync(path.dirname(sqlitePath), { recursive: true })
+  const sqlite = new Database(sqlitePath)
+  sqlite.pragma('journal_mode = WAL')
+  sqlite.pragma('busy_timeout = 5000')
+  initSqliteSchema(sqlite)
+
+  // 非空目标库须 --force
+  const existing = sqliteBusinessRowCount(sqlite)
+  if (existing > 0 && !force) {
+    console.error(`目标库已含 ${existing} 行业务数据。确认覆盖请加 --force（已自动备份）`)
+    process.exit(1)
+  }
+
+  const { totalSrc, totalDst } = await importMysqlData(mysqlPool, sqlite)
+
+  // 自增序列对齐检查（显式 id 插入后 sqlite_sequence 应 >= max(id)）
+  const seq = sqlite.prepare(`SELECT name, seq FROM sqlite_sequence`).all() as { name: string; seq: number }[]
+  console.log(`\nsqlite_sequence 已登记 ${seq.length} 张自增表`)
+
+  await mysqlPool.end()
+  sqlite.close()
+
+  console.log(`\n合计: mysql=${totalSrc} sqlite=${totalDst}`)
+  console.log('迁移完成 ✓')
+}
+
+main().catch(err => {
+  console.error('迁移失败:', err)
+  process.exit(1)
+})
diff --git a/huobao-source/backend/src/agents/context.ts b/huobao-source/backend/src/agents/context.ts
new file mode 100644
index 0000000..5ea4bf2
--- /dev/null
+++ b/huobao-source/backend/src/agents/context.ts
@@ -0,0 +1,43 @@
+/**
+ * Agent 请求上下文 — 通过 Mastra RequestContext 按请求注入
+ * 路由层 build → generate({ requestContext }) → 工具 execute 内读取
+ */
+import { RequestContext } from '@mastra/core/request-context'
+import { getContentLanguage, type ContentLanguage } from '../services/app-settings.js'
+
+export interface AgentRequestContextValues {
+  episodeId: number
+  dramaId: number
+  modelOverride?: string
+  textConfigId?: number
+  /** AI 内容语言；缺省时读全局设置（app_settings.content_language） */
+  language?: ContentLanguage
+}
+
+export function buildAgentRequestContext(values: AgentRequestContextValues): RequestContext<AgentRequestContextValues> {
+  const rc = new RequestContext<AgentRequestContextValues>()
+  rc.set('episodeId', values.episodeId)
+  rc.set('dramaId', values.dramaId)
+  if (values.modelOverride) rc.set('modelOverride', values.modelOverride)
+  if (values.textConfigId) rc.set('textConfigId', values.textConfigId)
+  // 语言在构建处统一解析：4 条链路（chat/提取/图片提示词/视频提示词）都经过这里，
+  // 全局设置一处生效；显式传入 values.language 可按请求覆盖
+  rc.set('language', values.language ?? getContentLanguage())
+  return rc
+}
+
+export function getEpisodeId(requestContext: RequestContext | undefined): number | null {
+  const v = requestContext?.get('episodeId' as never)
+  return typeof v === 'number' ? v : null
+}
+
+export function getDramaId(requestContext: RequestContext | undefined): number | null {
+  const v = requestContext?.get('dramaId' as never)
+  return typeof v === 'number' ? v : null
+}
+
+/** 读取请求上下文中的内容语言；未设置返回 null（调用方按 zh 处理） */
+export function getContentLanguageFromRC(requestContext: RequestContext | undefined): ContentLanguage | null {
+  const v = requestContext?.get('language' as never)
+  return typeof v === 'string' && v ? (v as ContentLanguage) : null
+}
diff --git a/huobao-source/backend/src/agents/index.ts b/huobao-source/backend/src/agents/index.ts
new file mode 100644
index 0000000..27dbcfb
--- /dev/null
+++ b/huobao-source/backend/src/agents/index.ts
@@ -0,0 +1,392 @@
+/**
+ * Mastra Agent 注册表
+ * 启动时注册静态 Agent；instructions/model 用 DynamicArgument 按请求解析
+ * （workspace/prompts/<agent_type>.md 文件 + RequestContext 中的 model/config_id 覆盖），
+ * episodeId/dramaId 由工具从 RequestContext 读取
+ */
+import { Agent } from '@mastra/core/agent'
+import type { RequestContext } from '@mastra/core/request-context'
+import { createGoogleGenerativeAI } from '@ai-sdk/google'
+import { createOpenAI } from '@ai-sdk/openai'
+import { getTextConfig, getTextProviderBaseUrl, getConfigById } from '../services/ai.js'
+import { logTaskProgress } from '../utils/task-logger.js'
+import { scriptTools } from './tools/script-tools.js'
+import { extractTools } from './tools/extract-tools.js'
+import { storyboardTools } from './tools/storyboard-tools.js'
+import { imagePromptTools } from './tools/image-prompt-tools.js'
+import { loadAgentSkills, skillWorkspaces } from './skills.js'
+import { loadAgentPromptFile, loadBasePromptFile } from './prompts.js'
+import { buildLanguageDirective } from './language.js'
+import { getContentLanguageFromRC } from './context.js'
+import { getVoiceReferenceInstructions } from './voice-reference-instructions.js'
+
+// Default prompts (used when workspace/prompts/<type>.md 文件缺失时兜底)
+export const DEFAULT_PROMPTS: Record<string, { name: string; instructions: string }> = {
+  script_rewriter: {
+    name: '剧本改写',
+    instructions: `你是专业编剧，擅长将小说改编为短剧剧本。
+
+工作流程：
+1. 调用 read_episode_script 读取原始内容
+2. 根据读取到的内容，自己进行改写（输出格式化剧本格式）
+3. 调用 save_script 保存改写后的完整剧本
+
+格式化剧本格式：
+- 场景头：## S编号 | 内景/外景 · 地点 | 时间段
+- 动作描写：自然段落，不包含镜头语言
+- 对白：角色名：（状态/表情）台词内容
+- 每个场景 30-60 秒内容
+
+注意：你必须自己完成改写工作，不要只返回指令。读取内容后直接输出改写结果并保存。`,
+  },
+  extractor: {
+    name: '角色场景提取',
+    instructions: `你是制片助理，擅长从剧本中提取角色、场景和道具信息，并在提取时与项目已有数据进行智能去重。
+
+工作流程：
+1. 调用 read_script_for_extraction 读取格式化剧本
+2. 调用 read_existing_characters 读取项目中已存在的角色列表，以及当前集已关联角色
+3. 调用 read_existing_scenes 读取项目中已存在的场景列表，以及当前集已关联场景
+4. 调用 read_existing_props 读取项目中已存在的道具列表，以及当前集已关联道具
+5. 优先围绕当前集剧本，分析本集实际出现的角色、场景和道具
+6. 对每个角色：若同名已存在则合并更新，若不存在则新增
+7. 调用 save_dedup_characters 保存角色（去重合并，自动处理新增和更新，并关联到当前集）
+8. 分析剧本内容，提取本集涉及的所有场景信息
+9. 对每个场景：若同地点+时间段已存在则复用，若不存在则新增
+10. 调用 save_dedup_scenes 保存场景（去重合并，自动处理新增和复用，并关联到当前集）
+11. 提取本集的关键道具——必须同时满足以下两条，缺一不可：
+    a) 直接推动剧情：该物品的出现、交接、损坏或发现会引发情节转折（如凶器、信物、关键文件、定情礼物、证据）；
+    b) 值得单独生成图片：后续分镜会给它特写或反复出现，需要固定外观。
+    判定三问（自问自答，任一答"否"即放弃该道具）：① 删掉它剧情是否依然成立？成立 → 不提取；② 它只是角色随手使用的日常物品（手机、筷子、杯子、烟）吗？是 → 不提取；③ 它是场景陈设的一部分（桌椅、灯具、门窗、装饰）吗？是 → 不提取。
+    宁可少提，不要多提：一集通常 0-3 个关键道具，超过 3 个时按剧情重要性排序只保留前 3 个；没有符合条件的道具就一个都不要提取
+12. 对每个道具：若同名已存在则合并更新，若不存在则新增
+13. 调用 save_dedup_props 保存道具（去重合并，自动处理新增和更新，并关联到当前集）；若没有需要提取的道具，调用时传空数组即可，不要强行凑数
+
+去重规则：
+- 角色/道具：按名字精确匹配，同名保留现有（合并信息）；名称带括号定位或别名时按括号前主体比较（如「林小雨（主角）」与「林小雨」视为同一角色，优先复用项目已有，不要重复创建）。read_existing_characters / read_existing_props 返回的 normalized_name 即归一化后的名字，可据此判断
+- 场景：按【地点+时间段】精确匹配（地点忽略空白/大小写）；同地点不同时段视为新场景
+
+提取要求：
+- 只提取当前集真实出现或被明确提及、且对当前集叙事有效的角色、场景和道具
+- 角色只需要两个核心描述字段：appearance（样貌：年龄感、五官、体态、气质等，角色的性格特点要转化为外在气质与神态融入样貌描写，不要单独输出性格字段）和 styling（妆造：发型、服装、妆面、配饰等）
+- 场景只需要两个核心描述字段：prompt（场景描述：空间、陈设、年代质感、关键视觉元素等）和 lighting（场景光影：光源、色调、明暗、氛围等）
+- 道具字段：name（道具名）、type（类型：日常/武器/交通/装饰/文件等）、description（物品外貌：只描写物品本身的物理外观——材质、颜色、形状、大小、新旧程度、磨损痕迹等，不要写剧情用途，不要涉及与角色或其他事物的关联）。道具不需要输出图片提示词，最终提示词由提示词生成 Agent 后续专门生成
+- 不要遗漏任何有台词或重要动作的角色`,
+  },
+  storyboard_breaker: {
+    name: '分镜拆解',
+    instructions: `你是资深影视分镜师，擅长将剧本拆解为分镜方案，并直接产出可供视频生成使用的提示词。
+
+核心定义：一个分镜 = 一个「分镜段落」= 一个视频生成任务。每个段落 8-15 秒，内部承载 2-4 个子镜头；子镜头之间可以切镜（换景别/角度/对象），但不跨场景。
+
+工作流程：
+1. 调用 read_storyboard_context 读取剧本、角色列表、场景列表、道具列表
+2. 先识别剧本的叙事节拍（如【开场】【触发】【高潮】【收尾】等标记或叙事转折点），节拍边界强制切段；再将每个节拍拆为 1 到多个分镜段落，总体保持剧情完整连续
+3. 为每个段落一并补全生产字段：description（画面描述）与 video_prompt（视频提示词）同步产出，规则分别见下
+4. 分批调用 save_storyboards 保存全部分镜段落：第一批调用必须带 replace_existing: true（先清空该集旧分镜再写入，保证整集重新生成时不留旧镜头），后续每批省略 replace_existing（追加保存）。每批最多 8 个段落，shot_number 必须按顺序递增；全部段落保存完成前不要结束（不要只保存部分段落就停止）
+
+硬约束（必须遵守）：
+- 不要输出任何规划、分析、推理或解释性文本，不要复述剧本，不要写「我正在…」「首先我需要…」这类话——思考留在模型内部，输出只允许工具调用
+- 每个输出步骤必须是工具调用（或完成后的简短结束语），禁止先输出大段文字再调用工具
+- 若因内容过多需要分多批，直接在连续的工具调用中完成全部批次，中间不要插入文字
+
+每个段落需要填写以下字段：
+- character_ids：当前段落涉及的角色 ID 列表，可以为空，也可以包含多个角色；必须从 characters 中选择
+- prop_ids：当前段落出现的关键道具 ID 列表（道具在画面中被看到、使用或特写时绑定），可以为空；必须从 props 中选择
+- scene_id：若可匹配到 scenes 中已有场景，必须填写正确 scene_id；无匹配时置空
+- duration：段落总时长 8-15 秒
+- description：画面描述，按【镜头1】【镜头2】…逐子镜头描述观众实际看到和听到的内容——画面（谁+具体动作+肢体细节+表情）写在前；该子镜头有台词时以「角色名说：「台词」」写在对应【镜头N】内，旁白写「旁白：内容」
+- atmosphere：氛围、光线、色调、环境感受
+- video_prompt：该段落的视频生成提示词（规则见下）
+
+时长规则（硬约束）：
+- 总量锚定：目标总时长 = 剧本字数 ÷ 500字/分钟，段落数 ≈ 目标总时长 ÷ 12秒，允许 ±20% 浮动
+- 节奏分层：过渡段（赶路/空镜/转场）8-10 秒；叙事段 10-15 秒；爆点段（特写/规则揭示/情感爆发/反转）12-15 秒且子镜头节奏放慢
+- 台词下限：段落时长 ≥ 段内台词与旁白总字数（写在 description 中的部分）÷ 4.5字/秒 + 2秒表演余量，装不下的台词拆到下一个段落
+
+video_prompt 规则（硬约束）：
+- 按 3 秒为一段、每段单独一行换行分隔；description 的每个【镜头N】映射为 1-2 个连续 3 秒段（顺序一致、不遗漏、不新增子镜头），切镜点对齐【镜头N】结构
+- 每段先写画面（谁+动作+景别/角度），再写该段时间内的台词/旁白——台词从 description 对应【镜头N】内提取，不要创作 description 之外的新台词
+- 提到场景用 @场景名、提到角色用 @角色名，名字必须与 read_storyboard_context 返回的列表完全一致（用于挂接参考素材图片）
+- 氛围、光线描述取自该段 atmosphere
+- 一个段落内允许切镜（换景别/角度/对象），但不跨场景
+- 用户消息中会告知本次视频模型，按该模型的特性与时长限制调整写法；未告知时按通用视频模型写法
+
+额外要求：
+- 优先复用 read_storyboard_context 返回的 scene_id，不要凭空创造新场景
+- 段落角色绑定必须来自 read_storyboard_context 返回的角色列表；无角色的空镜段落可传空数组
+- 段落道具绑定必须来自 read_storyboard_context 返回的道具列表；道具被使用、特写、交接或在画面中明显可见时绑定，与剧情无关的背景物品不要绑定；没有道具出现可传空数组
+- 段落描述必须能支撑后续视频生成和导出流程
+- 若一个段落没有台词，description 中不写台词即可，但画面描述与 atmosphere 仍必须完整
+- 如果已有 existing_storyboards，仅在用户明确要求增量修改时参考；默认按当前剧本重新完整生成并保存整集分镜。`,
+  },
+  prompt_generator: {
+    name: '提示词',
+    instructions: `你是专业的 AI 提示词工程师，负责两类提示词的创作与保存：
+1. 角色/场景/道具的「最终提示词」，供生图直接使用
+2. 分镜的「视频提示词」（video_prompt），供视频生成直接使用
+
+## 图片最终提示词
+
+用户请求会告知要为哪些角色、场景或道具生成最终提示词（附带 character_id / scene_id / prop_id）。
+
+工作流程：
+1. 调用 read_characters / read_scenes / read_props 读取资产信息
+2. 按对应资产的技能规范（角色三视图 / 场景固定视角 / 道具白底单品）创作最终提示词
+3. 调用 save_character_final_prompt / save_scene_final_prompt / save_prop_final_prompt 逐个保存
+
+## 视频提示词
+
+用户请求会告知要为哪个分镜生成视频提示词（附带分镜 ID）。
+
+工作流程：
+1. 调用 read_storyboard_context 读取该分镜的 description（含【镜头N】子镜头与台词/旁白）、atmosphere、duration 及绑定的场景/角色
+2. 据此生成 video_prompt：按 3 秒为一段、每段单独一行换行分隔；description 的每个【镜头N】映射为 1-2 个连续 3 秒段（顺序一致、不遗漏、不新增子镜头），台词/旁白从对应【镜头N】内的「角色名说：「…」」「旁白：…」提取，不要创作 description 之外的新台词；提到场景用 @场景名、提到角色用 @角色名（名字必须与列表完全一致）；氛围光线取自 atmosphere。一个分镜段落内允许切镜（换景别/角度/对象），段与段之间可以是不同镜头，但不跨场景；切镜点对齐分镜 description 的【镜头N】结构
+3. 生成时会自动把 @名字 替换为对应参考图片标记（如 @小明 → @图片1小明），因此名字必须精确匹配场景/角色列表，不要缩写或加额外符号
+4. 调用 update_storyboard 保存时参数只传两个键：storyboard_id 和 video_prompt。不要回传该分镜的其他任何字段（title、description、scene_id 等一律不传）
+
+通用规范：
+- 所有提示词使用本次会话语言指令指定的目标语言输出，单段连贯描述，不要分点，不要混入无关词汇
+- 项目设定的视觉风格描述会由工具在保存图片提示词时自动注入到最终提示词的最前方，不要自行添加风格词
+- 必须实际调用保存工具，不要只在回复中给出提示词`,
+  },
+}
+
+export const validAgentTypes = Object.keys(DEFAULT_PROMPTS)
+
+// Agent 每一步都会重新解析模型，相同端点只打一次日志避免刷屏
+let lastLoggedTextEndpointKey = ''
+
+/**
+ * 关闭思考(thinking)模式
+ *
+ * 背景：new-api 类中转站对 thinking 模型强制要求多轮请求回传 reasoning_content,
+ * 而 Agent 多轮工具调用无法回传,会被中转站 400 拒绝
+ * ("The `reasoning_content` in the thinking mode must be passed back to the API")。
+ * 这里在请求体注入各厂商风格的关思考参数,让模型不产出 reasoning_content。
+ *
+ * - 默认开启;AI_DISABLE_THINKING=false 可关闭注入
+ * - 官方 OpenAI / Gemini 端点跳过(官方 API 会拒绝未知参数)
+ * - AI_THINKING_OFF_PATCH 可传 JSON 覆盖注入的 OpenAI 风格参数(适配不同中转站)
+ */
+const thinkingOffEnabled = (process.env.AI_DISABLE_THINKING ?? 'true').toLowerCase() !== 'false'
+
+function isOfficialTextHost(baseURL: string) {
+  return /api\.openai\.com|generativelanguage\.googleapis\.com/.test(baseURL)
+}
+
+function openaiThinkingOffPatch(): Record<string, any> {
+  const fallback = {
+    thinking: { type: 'disabled' },   // new-api 通用 / DeepSeek
+    enable_thinking: false,           // Qwen / 阿里系
+    reasoning_effort: 'none',         // OpenAI 风格枚举(Gemini 渠道映射为 budget 0)
+  }
+  const raw = process.env.AI_THINKING_OFF_PATCH
+  if (!raw) return fallback
+  try {
+    const parsed = JSON.parse(raw)
+    return parsed && typeof parsed === 'object' ? parsed : fallback
+  } catch {
+    return fallback
+  }
+}
+
+function createThinkingOffFetch(providerName: string, baseURL: string): typeof fetch | undefined {
+  if (!thinkingOffEnabled || isOfficialTextHost(baseURL)) return undefined
+  const openaiPatch = openaiThinkingOffPatch()
+
+  return async (input: any, init?: any) => {
+    try {
+      if (init?.body && typeof init.body === 'string') {
+        const body = JSON.parse(init.body)
+        if (providerName === 'gemini' && Array.isArray(body?.contents)) {
+          // Gemini 原生格式。Gemini 3 系列思考参数改名 thinkingLevel(low/high)，
+          // 旧参数 thinkingBudget 会被 400 拒绝("requires thinkingLevel, not thinkingBudget")；
+          // 2.x 及更早仍用 thinkingBudget: 0。模型名从 URL(/models/<model>:)或 body 嗅探
+          const url = String(typeof input === 'string' ? input : input?.url || '')
+          const isGemini3 = /gemini-3/i.test(url) || /gemini-3/i.test(String(body?.model || ''))
+          body.generationConfig = {
+            ...(body.generationConfig || {}),
+            thinkingConfig: isGemini3
+              ? { thinkingLevel: 'low' }
+              : { thinkingBudget: 0, includeThoughts: false },
+          }
+          init = { ...init, body: JSON.stringify(body) }
+        } else if (Array.isArray(body?.messages)) {
+          // OpenAI 兼容格式
+          Object.assign(body, openaiPatch)
+          init = { ...init, body: JSON.stringify(body) }
+        }
+      }
+    } catch { /* 解析失败则原样透传 */ }
+    return fetch(input, init)
+  }
+}
+
+/**
+ * 在请求体中写入配置的温度
+ *
+ * 背景：部分模型服务端强制固定温度（如 kimi-k2 系只允许 0.6，
+ * 报 "invalid temperature: only 0.6 is allowed for this model"），
+ * 需要在文本服务配置里显式指定并随每个请求下发。
+ * inner 传 thinking-off fetch 时可链式叠加两个补丁。
+ */
+function createTemperatureFetch(providerName: string, temperature: number, inner?: typeof fetch): typeof fetch {
+  const base = inner || fetch
+  return async (input: any, init?: any) => {
+    try {
+      if (init?.body && typeof init.body === 'string') {
+        const body = JSON.parse(init.body)
+        if (providerName === 'gemini' && Array.isArray(body?.contents)) {
+          // Gemini 原生格式
+          body.generationConfig = { ...(body.generationConfig || {}), temperature }
+          init = { ...init, body: JSON.stringify(body) }
+        } else if (Array.isArray(body?.messages)) {
+          // OpenAI 兼容格式
+          body.temperature = temperature
+          init = { ...init, body: JSON.stringify(body) }
+        }
+      }
+    } catch { /* 解析失败则原样透传 */ }
+    return base(input, init)
+  }
+}
+
+/**
+ * 在请求体中注入输出上限
+ *
+ * 背景：Agent 输出可能包含大段规划文本 + 工具调用（尤其分批保存时），
+ * 而服务商默认 max_tokens 很小（如 DeepSeek 默认 4096/8192），
+ * 模型写作到一半被截断、工具调用从未生成，表现为「Agent 正常结束但什么都没保存」。
+ * 这里显式抬高输出上限，给足模型完整生成工具调用的空间。
+ * AI_MAX_TOKENS 可覆盖默认值（如某些中转站限制更严）。
+ *
+ * 官方 OpenAI 端点不注入：reasoning 模型（o 系/gpt-5 系）拒绝 max_tokens
+ * （要求 max_completion_tokens），且官方默认输出上限足够大，
+ * 截断问题主要出现在中转站/DeepSeek 类端点。
+ */
+const defaultMaxTokens = Number(process.env.AI_MAX_TOKENS || 16384)
+
+function isOfficialOpenAIHost(baseURL: string) {
+  return /api\.openai\.com/.test(baseURL)
+}
+
+function createMaxTokensFetch(providerName: string, inner?: typeof fetch): typeof fetch {
+  const base = inner || fetch
+  return async (input: any, init?: any) => {
+    try {
+      if (init?.body && typeof init.body === 'string') {
+        const body = JSON.parse(init.body)
+        if (providerName === 'gemini' && Array.isArray(body?.contents)) {
+          // Gemini 原生格式
+          body.generationConfig = { ...(body.generationConfig || {}), maxOutputTokens: defaultMaxTokens }
+          init = { ...init, body: JSON.stringify(body) }
+        } else if (Array.isArray(body?.messages)) {
+          // OpenAI 兼容格式
+          body.max_tokens = defaultMaxTokens
+          init = { ...init, body: JSON.stringify(body) }
+        }
+      }
+    } catch { /* 解析失败则原样透传 */ }
+    return base(input, init)
+  }
+}
+
+async function getModel(fileModel: string | undefined, modelOverride?: string, textConfigId?: number) {
+  // 请求可指定文本配置（含其 provider/baseUrl/apiKey），否则回退到当前启用配置
+  const textConfig = (textConfigId ? await getConfigById(textConfigId) : null) || await getTextConfig()
+  const modelName = modelOverride || fileModel || textConfig.model
+  const providerName = textConfig.provider.toLowerCase()
+  const resolvedBaseURL = getTextProviderBaseUrl(textConfig)
+  const temperature = textConfig.temperature ?? null
+  const endpointKey = `${providerName}|${resolvedBaseURL}|${modelName}|t=${temperature ?? 'default'}`
+  if (endpointKey !== lastLoggedTextEndpointKey) {
+    lastLoggedTextEndpointKey = endpointKey
+    logTaskProgress('AIConfig', 'text-model-endpoint', {
+      provider: textConfig.provider,
+      baseUrl: resolvedBaseURL,
+      model: modelName,
+      ...(temperature !== null ? { temperature } : {}),
+    })
+  }
+
+  // 叠加请求补丁：thinking-off（非官方端点）+ 配置温度 + 输出上限（非官方 OpenAI）
+  const thinkingOffFetch = createThinkingOffFetch(providerName, resolvedBaseURL)
+  const tempFetch = temperature !== null
+    ? createTemperatureFetch(providerName, temperature, thinkingOffFetch)
+    : thinkingOffFetch
+  const fetchImpl = isOfficialOpenAIHost(resolvedBaseURL)
+    ? tempFetch
+    : createMaxTokensFetch(providerName, tempFetch)
+
+  if (providerName === 'gemini') {
+    const googleProvider = createGoogleGenerativeAI({
+      apiKey: textConfig.apiKey,
+      baseURL: resolvedBaseURL,
+      fetch: fetchImpl,
+    })
+    return googleProvider(modelName)
+  }
+
+  const provider = createOpenAI({
+    baseURL: resolvedBaseURL,
+    apiKey: textConfig.apiKey,
+    fetch: fetchImpl,
+  } as any)
+  return provider.chat(modelName)
+}
+
+const AGENT_TOOLS: Record<string, Record<string, any>> = {
+  script_rewriter: scriptTools,
+  extractor: extractTools,
+  storyboard_breaker: storyboardTools,
+  prompt_generator: {
+    ...imagePromptTools,
+    readStoryboardContext: storyboardTools.readStoryboardContext,
+    updateStoryboard: storyboardTools.updateStoryboard,
+  },
+}
+
+/** instructions 按请求解析：prompt 文件（或默认）+ 技能全文拼接 + 目标语言指令块
+ *  prompt/skill 文本随内容语言切换语言变体（<type>.<lang>.md / SKILL.<lang>.md），缺失回退中文版 */
+function buildInstructions(type: string) {
+  return async ({ requestContext }: { requestContext?: RequestContext }) => {
+    const defaults = DEFAULT_PROMPTS[type]
+    const lang = getContentLanguageFromRC(requestContext)
+    const promptFile = await loadAgentPromptFile(type, lang)
+    const baseInstructions = promptFile?.instructions || defaults.instructions
+    const skillInstructions = await loadAgentSkills(type, lang)
+    const languageDirective = buildLanguageDirective(lang)
+    const voiceInstructions = getVoiceReferenceInstructions(type, lang)
+    return [baseInstructions, skillInstructions, voiceInstructions, languageDirective]
+      .filter(Boolean)
+      .join('\n\n')
+  }
+}
+
+/** model 按请求解析：基础版 prompt 文件 frontmatter + RequestContext 的 modelOverride/textConfigId 覆盖
+ *  （model 只认基础版 prompts/<type>.md，语言变体不参与 model 解析） */
+function buildModel(type: string) {
+  return async ({ requestContext }: { requestContext?: RequestContext }) => {
+    const promptFile = await loadBasePromptFile(type)
+    const modelOverride = requestContext?.get('modelOverride' as never) as string | undefined
+    const textConfigId = requestContext?.get('textConfigId' as never) as number | undefined
+    return getModel(promptFile?.model || undefined, modelOverride, textConfigId)
+  }
+}
+
+/** 启动时注册的静态 Agent 表（供 Mastra 实例挂载） */
+export const agentRegistry: Record<string, Agent> = Object.fromEntries(
+  validAgentTypes.map(type => [
+    type,
+    new Agent({
+      id: type,
+      name: DEFAULT_PROMPTS[type].name,
+      instructions: buildInstructions(type),
+      model: buildModel(type),
+      tools: AGENT_TOOLS[type],
+      workspace: skillWorkspaces[type],
+      skillsFormat: 'markdown',
+    }),
+  ]),
+)
diff --git a/huobao-source/backend/src/agents/language.ts b/huobao-source/backend/src/agents/language.ts
new file mode 100644
index 0000000..9720a99
--- /dev/null
+++ b/huobao-source/backend/src/agents/language.ts
@@ -0,0 +1,32 @@
+/**
+ * AI 内容语言指令块 — 按 RequestContext 中的目标语言生成，追加到 Agent instructions 末尾
+ *
+ * 设计要点：
+ * - zh / 未设置时返回空串：默认行为与历史完全一致，零 token 开销
+ * - 指令用英文书写（多语言模型遵循度最好），目标语言用原生名标注
+ * - 必须自带「最高优先级」声明：桌面版已安装用户的 workspace 模板不会被覆盖
+ *   （cpSync force:false），旧 SKILL.md 中的「只输出中文」约束只能靠这里的显式覆盖压制
+ */
+
+const LANGUAGE_NATIVE_NAMES: Record<string, string> = {
+  en: 'English',
+  ja: '日本語 (Japanese)',
+  ko: '한국어 (Korean)',
+}
+
+export function buildLanguageDirective(lang?: string | null): string {
+  if (!lang || lang === 'zh') return ''
+  const native = LANGUAGE_NATIVE_NAMES[lang] || lang
+  return [
+    '## Output Language (HIGHEST PRIORITY)',
+    '',
+    `ALL user-facing content you produce (scripts, dialogue, extracted fields, storyboard descriptions, atmosphere, image prompts, video prompts, asset names for NEW assets) MUST be written in ${native}.`,
+    '',
+    'This instruction has the highest priority and OVERRIDES any conflicting language requirement anywhere else in these instructions or skills — including requirements such as "output must be pure Chinese / 只输出中文". Ignore those.',
+    '',
+    'Exceptions:',
+    '- When referencing EXISTING assets with @mentions (e.g. in video prompts), the name after @ must EXACTLY match the asset name as it appears in the provided asset lists — do NOT translate or rewrite existing asset names.',
+    '- Character voice references (e.g. #Alex) are literal tokens: copy the complete voice_reference value exactly, including the existing name, regardless of output language. Do not add a suffix.',
+    '- The visual style prefix of image prompts is injected automatically by the system (in English). Do not translate, rewrite, or duplicate it.',
+  ].join('\n')
+}
diff --git a/huobao-source/backend/src/agents/prompts.ts b/huobao-source/backend/src/agents/prompts.ts
new file mode 100644
index 0000000..ec158dc
--- /dev/null
+++ b/huobao-source/backend/src/agents/prompts.ts
@@ -0,0 +1,75 @@
+/**
+ * Agent prompt 文件加载 — workspace/prompts/<agent_type>.md
+ * 文件格式（参照 SKILL.md 惯例）：
+ *   ---
+ *   name: 分镜拆解
+ *   model: ""        # 可选，覆盖文本模型；空 = 用 AI 服务默认
+ *   ---
+ *   <系统提示词正文>
+ * 文件即唯一事实来源；文件缺失时由调用方回退到代码默认值。
+ */
+import { skillsManagerWorkspace } from './skills.js'
+
+export interface AgentPromptFile {
+  name: string
+  model: string
+  instructions: string
+}
+
+const fsm = () => skillsManagerWorkspace.filesystem!
+/** prompt 文件路径；lang 为 en/ja/ko 时返回语言变体（<type>.<lang>.md），zh/空为基础版 */
+export const promptFilePath = (agentType: string, lang?: string | null) =>
+  `prompts/${agentType}${lang && lang !== 'zh' ? `.${lang}` : ''}.md`
+
+/** 解析 prompt 文件（frontmatter 仅支持 name/model 两个标量字段，无需 yaml 依赖） */
+export function parsePromptFile(raw: string): AgentPromptFile {
+  const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/)
+  let name = ''
+  let model = ''
+  let body = raw
+  if (fmMatch) {
+    const fm = fmMatch[1]
+    const get = (key: string) => {
+      const m = fm.match(new RegExp(`^${key}:\\s*"?([^"\\n]*)"?\\s*$`, 'm'))
+      return (m?.[1] || '').trim()
+    }
+    name = get('name')
+    model = get('model')
+    body = raw.slice(fmMatch[0].length)
+  }
+  return { name, model, instructions: body.trim() }
+}
+
+/** 序列化为 prompt 文件内容（供保存接口使用） */
+export function serializePromptFile(file: AgentPromptFile): string {
+  return `---\nname: ${file.name}\nmodel: "${file.model}"\n---\n\n${file.instructions.trim()}\n`
+}
+
+/** 读取指定路径的 prompt 文件；文件不存在或解析失败返回 null */
+async function readPromptFile(path: string): Promise<AgentPromptFile | null> {
+  try {
+    if (!await fsm().exists(path)) return null
+    const raw = String(await fsm().readFile(path, { encoding: 'utf-8' }))
+    const parsed = parsePromptFile(raw)
+    return parsed.instructions ? parsed : null
+  } catch {
+    return null
+  }
+}
+
+/** 读取基础版（中文）prompt 文件 — model 字段永远只从基础版解析，避免多语言文件漂移 */
+export function loadBasePromptFile(agentType: string): Promise<AgentPromptFile | null> {
+  return readPromptFile(promptFilePath(agentType))
+}
+
+/**
+ * 读取 Agent 的 prompt 文件；lang 非 zh 时优先语言变体（<type>.<lang>.md），缺失回退基础版。
+ * 变体的 model 字段无效：返回时 model 始终取基础版的值。
+ */
+export async function loadAgentPromptFile(agentType: string, lang?: string | null): Promise<AgentPromptFile | null> {
+  const base = await loadBasePromptFile(agentType)
+  if (!lang || lang === 'zh') return base
+  const localized = await readPromptFile(promptFilePath(agentType, lang))
+  if (!localized) return base
+  return { ...localized, model: base?.model || '' }
+}
diff --git a/huobao-source/backend/src/agents/skills.ts b/huobao-source/backend/src/agents/skills.ts
new file mode 100644
index 0000000..7008177
--- /dev/null
+++ b/huobao-source/backend/src/agents/skills.ts
@@ -0,0 +1,166 @@
+/**
+ * Agent 工作区（Workspace）— Mastra 原生能力
+ * 每个 Agent 一个 Workspace：
+ * - filesystem：jail 到 backend/workspace/ 目录，Agent 获得文件读写工具
+ * - skills：从 workspace/skills/ 下注册各 Agent 专属的 SKILL.md
+ * 注入 instructions 时仍拼接技能全文（原生注入只有元数据，全文注入保证行为一致）
+ *
+ * 注意：filesystem instructions 刻意覆写为无 "workspace" 字样的中文描述——
+ * 默认文案含绝对路径（路径里有 workspace 目录名），Gemini 系低思考档位下
+ * 偶发把其脑补成 Google Workspace 然后以"组织政策"为由拒绝调用工具。
+ */
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { Workspace, LocalFilesystem } from '@mastra/core/workspace'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+// 桌面版由 Electron 主进程注入 WORKSPACE_PATH（userData 下的可写副本）；dev 锚定 backend/workspace
+const WORKSPACE_DIR = process.env.WORKSPACE_PATH
+  ? path.resolve(process.env.WORKSPACE_PATH)
+  : path.resolve(__dirname, '../../workspace')
+const SKILLS_DIR = path.join(WORKSPACE_DIR, 'skills')
+
+// 覆写默认 filesystem instructions（默认文案带绝对路径，暴露 workspace 字样）
+const FILESYSTEM_INSTRUCTIONS =
+  '本地文件目录：用于读写技能定义、提示词等项目文件。相对路径均以此目录为根解析；文件访问仅限此目录之内。'
+const localFilesystem = () => new LocalFilesystem({ basePath: WORKSPACE_DIR, instructions: FILESYSTEM_INSTRUCTIONS })
+
+// 启动时确保工作目录存在（Agent 文件读写的 jail 根）
+// 桌面版打包后模块可能仍从只读位置加载，失败不阻断启动（路由层会给出明确报错）
+try {
+  fs.mkdirSync(SKILLS_DIR, { recursive: true })
+} catch (err) {
+  console.warn(`[skills] 工作目录创建失败（只读环境？）: ${(err as Error).message}`)
+}
+
+/** 每个 Agent 注册的 skill 目录（相对 workspace/skills/，含子规范目录；目录名需符合 Agent Skills 规范：小写+连字符） */
+const AGENT_SKILL_MAP: Record<string, string[]> = {
+  script_rewriter: ['script-rewriter'],
+  extractor: ['extractor'],
+  storyboard_breaker: ['storyboard-breaker'],
+  prompt_generator: [
+    'prompt-generator/character-prompt',
+    'prompt-generator/scene-prompt',
+    'prompt-generator/prop-prompt',
+    'prompt-generator/video-prompt',
+  ],
+}
+
+/** 每个 Agent 的 Workspace（filesystem 工作目录 + 原生技能注册）
+ *  skills 用动态解析器按目录前缀匹配：设置页新建的子技能无需重启即可被发现 */
+export const skillWorkspaces: Record<string, Workspace> = Object.fromEntries(
+  Object.entries(AGENT_SKILL_MAP).map(([agentType, prefixes]) => [
+    agentType,
+    new Workspace({
+      id: `workspace-${agentType}`,
+      name: `${agentType} workspace`,
+      filesystem: localFilesystem(),
+      skills: () => scanSkillPaths().filter(p =>
+        prefixes.some(prefix => p === `skills/${prefix}` || p.startsWith(`skills/${prefix}/`))),
+    }),
+  ]),
+)
+
+/** 递归扫描 workspace/skills/ 下所有含 SKILL.md 的目录（相对 workspace 根的路径） */
+function scanSkillPaths(): string[] {
+  const found: string[] = []
+  const walk = (dir: string, prefix: string) => {
+    if (!fs.existsSync(dir)) return
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue
+      const rel = prefix ? `${prefix}/${entry.name}` : entry.name
+      const full = path.join(dir, entry.name)
+      if (fs.existsSync(path.join(full, 'SKILL.md'))) found.push(`skills/${rel}`)
+      walk(full, rel)
+    }
+  }
+  walk(SKILLS_DIR, '')
+  return found
+}
+
+/**
+ * 技能管理 Workspace（设置页 CRUD 用）
+ * skills 用动态解析器，新建/删除技能目录后无需重启即可发现
+ */
+export const skillsManagerWorkspace = new Workspace({
+  id: 'workspace-skills-manager',
+  name: 'skills manager',
+  filesystem: localFilesystem(),
+  skills: () => scanSkillPaths(),
+})
+
+function formatSkillSection(skillId: string, content: string): string {
+  return [`## Skill: ${skillId}`, content].join('\n')
+}
+
+/** 剥离 SKILL.md 风格文件的 frontmatter，返回正文（供语言变体直读使用） */
+function stripFrontmatter(raw: string): string {
+  const m = raw.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/)
+  return (m ? raw.slice(m[0].length) : raw).trim()
+}
+
+/** 读取技能的语言变体正文（SKILL.<lang>.md，直读绕缓存永远最新）；不存在返回 null */
+async function readLocalizedSkill(relPath: string, lang: string): Promise<string | null> {
+  const fsm = skillsManagerWorkspace.filesystem!
+  const p = `skills/${relPath}/SKILL.${lang}.md`
+  try {
+    if (!await fsm.exists(p)) return null
+    const body = stripFrontmatter(String(await fsm.readFile(p, { encoding: 'utf-8' })))
+    return body || null
+  } catch {
+    return null
+  }
+}
+
+/** 读取 Agent 专属技能全文（经 workspace.skills API，保持原注入格式）
+ *  AGENT_SKILL_MAP 的目录按前缀匹配：目录自身及其子目录下所有 SKILL.md 都会注入，
+ *  因此设置页新建的子技能（如 storyboard-breaker/xxx）无需改代码即可生效。
+ *  lang 非 zh 时逐技能优先 SKILL.<lang>.md，缺失回退基础版（中文） */
+export async function loadAgentSkills(agentType: string, lang?: string | null): Promise<string> {
+  const workspace = skillWorkspaces[agentType]
+  const prefixes = AGENT_SKILL_MAP[agentType] || []
+  if (!workspace || !prefixes.length) return ''
+
+  const allPaths = scanSkillPaths().map(p => p.replace(/^skills\//, ''))
+  const relPaths = allPaths.filter(p =>
+    prefixes.some(prefix => p === prefix || p.startsWith(prefix + '/')))
+
+  const useLocalized = Boolean(lang && lang !== 'zh')
+  const contents: string[] = []
+  for (const relPath of relPaths) {
+    let body: string | null | undefined
+    if (useLocalized) body = await readLocalizedSkill(relPath, lang!)
+    if (!body) {
+      const skill = await workspace.skills?.get(`skills/${relPath}`)
+      body = skill?.instructions?.trim()
+    }
+    if (body) contents.push(formatSkillSection(relPath, body))
+  }
+
+  if (!contents.length) return ''
+
+  return [
+    '以下是该 Agent 专属的项目技能规范（SKILL.md）。',
+    '不同 Agent 会加载不同 skill；你只需要遵守当前注入的这些技能。',
+    '你必须在不违背当前工具边界的前提下优先遵守这些规范；若与用户明确要求冲突，以用户要求为准。',
+    '',
+    contents.join('\n\n'),
+  ].join('\n')
+}
+
+/**
+ * 强制重新扫描全部 Agent 的技能（SKILL.md 编辑后调用）
+ * maybeRefresh 负责感知目录增删（动态 resolver 路径变化），refresh 负责内容更新
+ * （目录 mtime 不会因文件内容编辑而更新，单靠 maybeRefresh 的 staleness 检查不可靠）
+ */
+export async function refreshSkillWorkspaces(): Promise<void> {
+  await Promise.all(
+    [...Object.values(skillWorkspaces), skillsManagerWorkspace]
+      .map(async workspace => {
+        await workspace.skills?.maybeRefresh()
+        await workspace.skills?.refresh()
+      }),
+  )
+}
diff --git a/huobao-source/backend/src/agents/tools/extract-tools.ts b/huobao-source/backend/src/agents/tools/extract-tools.ts
new file mode 100644
index 0000000..0b11fec
--- /dev/null
+++ b/huobao-source/backend/src/agents/tools/extract-tools.ts
@@ -0,0 +1,426 @@
+/**
+ * 角色/场景提取 Agent 工具
+ * 模块级单例 — episodeId + dramaId 通过 RequestContext 按请求注入
+ *
+ * 单 Agent 一步流程：
+ * 1. 读取剧本内容
+ * 2. 读取项目中已存在的角色/场景（用于去重）
+ * 3. 提取角色/场景并智能去重后直接保存
+ */
+import { createTool } from '@mastra/core/tools'
+import type { ToolExecutionContext } from '@mastra/core/tools'
+import { z } from 'zod'
+import { db, getInsertId, schema } from '../../db/index.js'
+import { eq, and } from 'drizzle-orm'
+import { now } from '../../utils/response.js'
+import { logTaskProgress, logTaskSuccess } from '../../utils/task-logger.js'
+import { getDramaId, getEpisodeId } from '../context.js'
+
+// ─── 关联辅助 ────────────────────────────────────────────────
+async function linkCharToEpisode(episodeId: number, characterId: number) {
+  const ts = now()
+  const existing = await db.select().from(schema.episodeCharacters)
+    .where(and(eq(schema.episodeCharacters.episodeId, episodeId), eq(schema.episodeCharacters.characterId, characterId)))
+
+  if (!existing.length) {
+    await db.insert(schema.episodeCharacters).values({ episodeId, characterId, createdAt: ts })
+  }
+}
+
+async function linkSceneToEpisode(episodeId: number, sceneId: number) {
+  const ts = now()
+  const existing = await db.select().from(schema.episodeScenes)
+    .where(and(eq(schema.episodeScenes.episodeId, episodeId), eq(schema.episodeScenes.sceneId, sceneId)))
+
+  if (!existing.length) {
+    await db.insert(schema.episodeScenes).values({ episodeId, sceneId, createdAt: ts })
+  }
+}
+
+async function linkPropToEpisode(episodeId: number, propId: number) {
+  const ts = now()
+  const existing = await db.select().from(schema.episodeProps)
+    .where(and(eq(schema.episodeProps.episodeId, episodeId), eq(schema.episodeProps.propId, propId)))
+
+  if (!existing.length) {
+    await db.insert(schema.episodeProps).values({ episodeId, propId, createdAt: ts })
+  }
+}
+
+// ─── 名字归一化（近名去重） ───────────────────────────────────
+// 提取时同一角色/道具可能出现不同书写形式（如「林小雨」与「林小雨（主角）」、
+// 「林小雨(女主)」、「林小雨 」）。归一化后做精确比较，命中即复用已有，不重复创建。
+function normalizeName(name: string): string {
+  return (name || '')
+    .replace(/[（(][^（()）]*[）)]/g, '') // 去掉成对的中/英文括号内容（角色定位/别名）
+    .replace(/[（(].*$/, '')              // 兜底：未闭合括号从首个括号截断
+    .replace(/[\s　]+/g, '')          // 去空白与全角空格
+    .toLowerCase()
+    .trim()
+}
+
+// 场景地点只做空白归一化（不删括号：如「火车站（候车厅）」与「火车站（站台）」是不同场景）
+function normalizeLocation(loc: string): string {
+  return (loc || '').replace(/[\s　]+/g, '').toLowerCase().trim()
+}
+
+type ToolContext = ToolExecutionContext | undefined
+
+function requireIds(context: ToolContext): { episodeId: number; dramaId: number } | { error: string } {
+  const episodeId = getEpisodeId(context?.requestContext)
+  const dramaId = getDramaId(context?.requestContext)
+  if (!episodeId || !dramaId) return { error: 'Missing episodeId/dramaId in request context' }
+  return { episodeId, dramaId }
+}
+
+// 1. 读取剧本内容
+const readScriptForExtraction = createTool({
+  id: 'read_script_for_extraction',
+  description: 'Read the formatted screenplay for character/scene extraction.',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const [ep] = await db.select().from(schema.episodes)
+      .where(eq(schema.episodes.id, episodeId))
+    if (!ep) return { error: 'Episode not found' }
+    const content = ep.scriptContent || ep.content
+    if (!content) return { error: 'Episode has no script content' }
+    logTaskSuccess('ExtractTool', 'read-script', { episodeId, dramaId, scriptLength: content.length })
+    return { script: content }
+  },
+})
+
+// 2. 读取项目中已存在的角色（用于去重判断）
+const readExistingCharacters = createTool({
+  id: 'read_existing_characters',
+  description: 'Read all characters already existing in this drama project (for deduplication).',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const links = await db.select().from(schema.episodeCharacters)
+      .where(eq(schema.episodeCharacters.episodeId, episodeId))
+    const linkedIds = new Set(links.map(link => link.characterId))
+    const chars = (await db.select().from(schema.characters)
+      .where(eq(schema.characters.dramaId, dramaId)))
+      .filter(c => !c.deletedAt)
+    const visibleChars = chars.map(c => ({
+      id: c.id,
+      name: c.name,
+      role: c.role || '',
+      appearance: c.appearance || '',
+      styling: c.styling || '',
+      normalized_name: normalizeName(c.name), // 用于判断近名复用：括号定位/别名视为同名
+    }))
+    const payload = {
+      count: visibleChars.length,
+      characters: visibleChars,
+      current_episode_characters: visibleChars.filter(c => linkedIds.has(c.id)),
+    }
+    logTaskSuccess('ExtractTool', 'read-characters', {
+      episodeId,
+      dramaId,
+      projectCharacters: payload.count,
+      episodeCharacters: payload.current_episode_characters.length,
+    })
+    return payload
+  },
+})
+
+// 3. 读取项目中已存在的场景（用于去重判断）
+const readExistingScenes = createTool({
+  id: 'read_existing_scenes',
+  description: 'Read all scenes already existing in this drama project (for deduplication).',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const links = await db.select().from(schema.episodeScenes)
+      .where(eq(schema.episodeScenes.episodeId, episodeId))
+    const linkedIds = new Set(links.map(link => link.sceneId))
+    const scenes = (await db.select().from(schema.scenes)
+      .where(eq(schema.scenes.dramaId, dramaId)))
+      .filter(s => !s.deletedAt)
+    const visibleScenes = scenes.map(s => ({
+      id: s.id,
+      location: s.location,
+      time: s.time || '',
+      prompt: s.prompt || '',
+      lighting: s.lighting || '',
+      normalized_location: normalizeLocation(s.location), // 用于判断近名复用（仅空白/大小写）
+    }))
+    const payload = {
+      count: visibleScenes.length,
+      scenes: visibleScenes,
+      current_episode_scenes: visibleScenes.filter(s => linkedIds.has(s.id)),
+    }
+    logTaskSuccess('ExtractTool', 'read-scenes', {
+      episodeId,
+      dramaId,
+      projectScenes: payload.count,
+      episodeScenes: payload.current_episode_scenes.length,
+    })
+    return payload
+  },
+})
+
+// 4. 智能保存角色（按名字去重，与现有数据合并）
+const saveDedupCharacters = createTool({
+  id: 'save_dedup_characters',
+  description: 'Save extracted characters with deduplication. Existing characters (same name) are merged/updated; new ones are created. All are linked to the current episode.',
+  inputSchema: z.object({
+    characters: z.array(z.object({
+      name: z.string(),
+      role: z.string().optional(),
+      description: z.string().optional(),
+      appearance: z.string().optional(),
+      styling: z.string().optional(),
+    })),
+  }),
+  execute: async ({ characters }, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const ts = now()
+    const results = { created: 0, merged: 0 }
+    logTaskProgress('ExtractTool', 'save-characters-begin', {
+      episodeId,
+      dramaId,
+      names: characters.map(char => char.name).join(','),
+    })
+
+    for (const char of characters) {
+      const charsInProject = (await db.select().from(schema.characters)
+        .where(eq(schema.characters.dramaId, dramaId)))
+        .filter(c => !c.deletedAt)
+      const exact = charsInProject.find(c => c.name === char.name)
+      const normName = normalizeName(char.name)
+      const existing = exact || (normName ? charsInProject.find(c => c.name && normalizeName(c.name) === normName) : undefined)
+      const matchedViaNorm = !!existing && existing !== exact
+
+      if (existing) {
+        // 归一化命中：括号定位/别名等近名视作同一角色复用，避免重复创建
+        if (matchedViaNorm) logTaskProgress('ExtractTool', 'save-characters-reuse', { episodeId, dramaId, extracted: char.name, reused: existing.name })
+        // 已存在：合并信息，保留 ID
+        await db.update(schema.characters).set({
+          role: char.role || existing.role,
+          description: char.description || existing.description,
+          appearance: char.appearance || existing.appearance,
+          styling: char.styling || char.description || existing.styling,
+          updatedAt: ts,
+        }).where(eq(schema.characters.id, existing.id))
+        await linkCharToEpisode(episodeId, existing.id)
+        results.merged++
+      } else {
+        // 新增角色
+        const res = await db.insert(schema.characters).values({
+          name: char.name,
+          role: char.role || '',
+          description: char.description || '',
+          appearance: char.appearance || '',
+          styling: char.styling || char.description || '',
+          dramaId,
+          createdAt: ts,
+          updatedAt: ts,
+        })
+        const charId = getInsertId(res)
+        await linkCharToEpisode(episodeId, charId)
+        results.created++
+      }
+    }
+
+    const payload = {
+      message: `角色保存完成：新增 ${results.created}，合并更新 ${results.merged}`,
+      ...results,
+    }
+    logTaskSuccess('ExtractTool', 'save-characters-complete', { episodeId, ...results })
+    return payload
+  },
+})
+
+// 5. 智能保存场景（按地点+时间段去重，与现有数据合并）
+const saveDedupScenes = createTool({
+  id: 'save_dedup_scenes',
+  description: 'Save extracted scenes with deduplication. Existing scenes (same location+time) are reused; new ones are created. All are linked to the current episode.',
+  inputSchema: z.object({
+    scenes: z.array(z.object({
+      location: z.string(),
+      time: z.string().optional(),
+      prompt: z.string().optional(),
+      description: z.string().optional(),
+      lighting: z.string().optional(),
+    })),
+  }),
+  execute: async ({ scenes }, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const ts = now()
+    const results = { created: 0, reused: 0 }
+    logTaskProgress('ExtractTool', 'save-scenes-begin', {
+      episodeId,
+      dramaId,
+      scenes: scenes.map(scene => `${scene.location}@${scene.time || ''}`).join(','),
+    })
+
+    for (const scene of scenes) {
+      // 按地点+时间段精确匹配；地点仅做空白/大小写归一化（不删括号，避免误合并）
+      const scenesInProject = (await db.select().from(schema.scenes)
+        .where(eq(schema.scenes.dramaId, dramaId)))
+        .filter(s => !s.deletedAt)
+      const normLocation = normalizeLocation(scene.location)
+      const existing = scenesInProject.find(s => s.location === scene.location && s.time === (scene.time || ''))
+        || (normLocation ? scenesInProject.find(s => normalizeLocation(s.location) === normLocation && s.time === (scene.time || '')) : undefined)
+
+      if (existing) {
+        // 已存在完全匹配的场景：关联并补齐描述/光影
+        await db.update(schema.scenes).set({
+          prompt: scene.prompt || scene.description || existing.prompt,
+          lighting: scene.lighting || existing.lighting,
+          updatedAt: ts,
+        }).where(eq(schema.scenes.id, existing.id))
+        await linkSceneToEpisode(episodeId, existing.id)
+        results.reused++
+      } else {
+        const res = await db.insert(schema.scenes).values({
+          dramaId,
+          location: scene.location,
+          time: scene.time || '',
+          prompt: scene.prompt || scene.description || scene.location,
+          lighting: scene.lighting || '',
+          createdAt: ts,
+          updatedAt: ts,
+        })
+        const sceneId = getInsertId(res)
+        await linkSceneToEpisode(episodeId, sceneId)
+        results.created++
+      }
+    }
+
+    const payload = {
+      message: `场景保存完成：新增 ${results.created}，复用已有 ${results.reused}`,
+      ...results,
+    }
+    logTaskSuccess('ExtractTool', 'save-scenes-complete', { episodeId, ...results })
+    return payload
+  },
+})
+
+// 6. 读取项目中已存在的道具（用于去重判断）
+const readExistingProps = createTool({
+  id: 'read_existing_props',
+  description: 'Read all props already existing in this drama project (for deduplication).',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const links = await db.select().from(schema.episodeProps)
+      .where(eq(schema.episodeProps.episodeId, episodeId))
+    const linkedIds = new Set(links.map(link => link.propId))
+    const props = (await db.select().from(schema.props)
+      .where(eq(schema.props.dramaId, dramaId)))
+      .filter(p => !p.deletedAt)
+    const visibleProps = props.map(p => ({
+      id: p.id,
+      name: p.name,
+      type: p.type || '',
+      description: p.description || '',
+      normalized_name: normalizeName(p.name), // 用于判断近名复用：括号定位/别名视为同名
+    }))
+    const payload = {
+      count: visibleProps.length,
+      props: visibleProps,
+      current_episode_props: visibleProps.filter(p => linkedIds.has(p.id)),
+    }
+    logTaskSuccess('ExtractTool', 'read-props', {
+      episodeId,
+      dramaId,
+      projectProps: payload.count,
+      episodeProps: payload.current_episode_props.length,
+    })
+    return payload
+  },
+})
+
+// 7. 智能保存道具（按名字去重，与现有数据合并）
+const saveDedupProps = createTool({
+  id: 'save_dedup_props',
+  description: 'Save extracted props with deduplication. Existing props (same name) are merged/updated; new ones are created. All are linked to the current episode.',
+  inputSchema: z.object({
+    props: z.array(z.object({
+      name: z.string(),
+      type: z.string().optional(),
+      description: z.string().optional(),
+    })),
+  }),
+  execute: async ({ props }, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const ts = now()
+    const results = { created: 0, merged: 0 }
+    logTaskProgress('ExtractTool', 'save-props-begin', {
+      episodeId,
+      dramaId,
+      names: props.map(prop => prop.name).join(','),
+    })
+
+    for (const prop of props) {
+      const propsInProject = (await db.select().from(schema.props)
+        .where(eq(schema.props.dramaId, dramaId)))
+        .filter(p => !p.deletedAt)
+      const exact = propsInProject.find(p => p.name === prop.name)
+      const normName = normalizeName(prop.name)
+      const existing = exact || (normName ? propsInProject.find(p => p.name && normalizeName(p.name) === normName) : undefined)
+      const matchedViaNorm = !!existing && existing !== exact
+
+      if (existing) {
+        // 归一化命中：括号定位/别名等近名视作同一道具复用
+        if (matchedViaNorm) logTaskProgress('ExtractTool', 'save-props-reuse', { episodeId, dramaId, extracted: prop.name, reused: existing.name })
+        // 已存在：合并信息，保留 ID；物品外貌变更后旧的最终提示词失效
+        await db.update(schema.props).set({
+          type: prop.type || existing.type,
+          description: prop.description || existing.description,
+          finalPrompt: prop.description ? null : existing.finalPrompt,
+          updatedAt: ts,
+        }).where(eq(schema.props.id, existing.id))
+        await linkPropToEpisode(episodeId, existing.id)
+        results.merged++
+      } else {
+        const res = await db.insert(schema.props).values({
+          name: prop.name,
+          type: prop.type || '',
+          description: prop.description || '',
+          dramaId,
+          createdAt: ts,
+          updatedAt: ts,
+        })
+        const propId = getInsertId(res)
+        await linkPropToEpisode(episodeId, propId)
+        results.created++
+      }
+    }
+
+    const payload = {
+      message: `道具保存完成：新增 ${results.created}，合并更新 ${results.merged}`,
+      ...results,
+    }
+    logTaskSuccess('ExtractTool', 'save-props-complete', { episodeId, ...results })
+    return payload
+  },
+})
+
+export const extractTools = {
+  readScriptForExtraction,
+  readExistingCharacters,
+  readExistingScenes,
+  readExistingProps,
+  saveDedupCharacters,
+  saveDedupScenes,
+  saveDedupProps,
+}
diff --git a/huobao-source/backend/src/agents/tools/image-prompt-tools.ts b/huobao-source/backend/src/agents/tools/image-prompt-tools.ts
new file mode 100644
index 0000000..017acf3
--- /dev/null
+++ b/huobao-source/backend/src/agents/tools/image-prompt-tools.ts
@@ -0,0 +1,188 @@
+/**
+ * 提示词生成 Agent 工具
+ * 模块级单例 — dramaId 通过 RequestContext 按请求注入
+ *
+ * Agent 负责创作最终提示词：
+ * 1. 角色 → 三视图（character turnaround：正面/侧面/背面）
+ * 2. 场景 → 固定视角 + 前景/中景/后景分层构图
+ * 3. 道具 → 白底单品静物（single product shot on pure white background）
+ * 工具负责读取资产信息与保存 Agent 产出的最终提示词（保存时注入项目视觉风格）
+ */
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+import { db, schema } from '../../db/index.js'
+import { eq } from 'drizzle-orm'
+import { now } from '../../utils/response.js'
+import { getDramaStylePrompt } from '../../services/style-preset.js'
+import { getDramaId } from '../context.js'
+
+// ─── 角色提示词 ───────────────────────────────────────
+
+const readCharacters = createTool({
+  id: 'read_characters',
+  description: '读取当前剧集中的所有角色信息，用于生成角色三视图最终提示词。',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const dramaId = getDramaId(context?.requestContext)
+    if (!dramaId) return { error: 'Missing dramaId in request context' }
+    const chars = (await db.select().from(schema.characters)
+      .where(eq(schema.characters.dramaId, dramaId)))
+      .filter(c => !c.deletedAt)
+    return {
+      characters: chars.map(c => ({
+        id: c.id,
+        name: c.name,
+        role: c.role || '',
+        description: c.description || '',
+        appearance: c.appearance || '',
+        styling: c.styling || '',
+        final_prompt: c.finalPrompt || '',
+      })),
+    }
+  },
+})
+
+const saveCharacterFinalPrompt = createTool({
+  id: 'save_character_final_prompt',
+  description: '保存为角色创作的三视图最终提示词。项目视觉风格会由工具自动拼接，prompt 参数中不要包含风格词。',
+  inputSchema: z.object({
+    character_id: z.number(),
+    prompt: z.string().describe('角色三视图最终提示词（使用会话语言指令指定的目标语言，不含风格词）'),
+  }),
+  execute: async ({ character_id, prompt }, context) => {
+    const dramaId = getDramaId(context?.requestContext)
+    if (!dramaId) return { error: 'Missing dramaId in request context' }
+    const [c] = await db.select().from(schema.characters)
+      .where(eq(schema.characters.id, character_id))
+    if (!c) return { error: 'Character not found' }
+
+    const stylePrompt = await getDramaStylePrompt(dramaId)
+    const finalPrompt = stylePrompt ? `${stylePrompt}, ${prompt}` : prompt
+    await db.update(schema.characters)
+      .set({ finalPrompt, updatedAt: now() })
+      .where(eq(schema.characters.id, character_id))
+
+    return {
+      character_id: c.id,
+      character_name: c.name,
+      saved: true,
+      final_prompt: finalPrompt,
+    }
+  },
+})
+
+// ─── 场景提示词 ───────────────────────────────────────
+
+const readScenes = createTool({
+  id: 'read_scenes',
+  description: '读取当前剧集中的所有场景信息，用于生成场景固定视角最终提示词。',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const dramaId = getDramaId(context?.requestContext)
+    if (!dramaId) return { error: 'Missing dramaId in request context' }
+    const scenes = (await db.select().from(schema.scenes)
+      .where(eq(schema.scenes.dramaId, dramaId)))
+      .filter(s => !s.deletedAt)
+    return {
+      scenes: scenes.map(s => ({
+        id: s.id,
+        location: s.location,
+        time: s.time || '',
+        prompt: s.prompt || '',
+        lighting: s.lighting || '',
+        final_prompt: s.finalPrompt || '',
+      })),
+    }
+  },
+})
+
+const saveSceneFinalPrompt = createTool({
+  id: 'save_scene_final_prompt',
+  description: '保存为场景创作的固定视角（前景/中景/后景）最终提示词。项目视觉风格会由工具自动拼接，prompt 参数中不要包含风格词。',
+  inputSchema: z.object({
+    scene_id: z.number(),
+    prompt: z.string().describe('场景固定视角最终提示词（使用会话语言指令指定的目标语言，不含风格词）'),
+  }),
+  execute: async ({ scene_id, prompt }, context) => {
+    const dramaId = getDramaId(context?.requestContext)
+    if (!dramaId) return { error: 'Missing dramaId in request context' }
+    const [s] = await db.select().from(schema.scenes)
+      .where(eq(schema.scenes.id, scene_id))
+    if (!s) return { error: 'Scene not found' }
+
+    const stylePrompt = await getDramaStylePrompt(dramaId)
+    const finalPrompt = stylePrompt ? `${stylePrompt}, ${prompt}` : prompt
+    await db.update(schema.scenes)
+      .set({ finalPrompt, updatedAt: now() })
+      .where(eq(schema.scenes.id, scene_id))
+
+    return {
+      scene_id: s.id,
+      location: s.location,
+      saved: true,
+      final_prompt: finalPrompt,
+    }
+  },
+})
+
+// ─── 道具提示词 ───────────────────────────────────────
+
+const readProps = createTool({
+  id: 'read_props',
+  description: '读取当前剧集项目中的所有道具信息，用于生成道具白底单品最终提示词。',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const dramaId = getDramaId(context?.requestContext)
+    if (!dramaId) return { error: 'Missing dramaId in request context' }
+    const props = (await db.select().from(schema.props)
+      .where(eq(schema.props.dramaId, dramaId)))
+      .filter(p => !p.deletedAt)
+    return {
+      props: props.map(p => ({
+        id: p.id,
+        name: p.name,
+        type: p.type || '',
+        description: p.description || '',
+        final_prompt: p.finalPrompt || '',
+      })),
+    }
+  },
+})
+
+const savePropFinalPrompt = createTool({
+  id: 'save_prop_final_prompt',
+  description: '保存为道具创作的白底单品最终提示词。项目视觉风格会由工具自动拼接，prompt 参数中不要包含风格词。',
+  inputSchema: z.object({
+    prop_id: z.number(),
+    prompt: z.string().describe('道具白底单品最终提示词（使用会话语言指令指定的目标语言，不含风格词）'),
+  }),
+  execute: async ({ prop_id, prompt }, context) => {
+    const dramaId = getDramaId(context?.requestContext)
+    if (!dramaId) return { error: 'Missing dramaId in request context' }
+    const [p] = await db.select().from(schema.props)
+      .where(eq(schema.props.id, prop_id))
+    if (!p) return { error: 'Prop not found' }
+
+    const stylePrompt = await getDramaStylePrompt(dramaId)
+    const finalPrompt = stylePrompt ? `${stylePrompt}, ${prompt}` : prompt
+    await db.update(schema.props)
+      .set({ finalPrompt, updatedAt: now() })
+      .where(eq(schema.props.id, prop_id))
+
+    return {
+      prop_id: p.id,
+      prop_name: p.name,
+      saved: true,
+      final_prompt: finalPrompt,
+    }
+  },
+})
+
+export const imagePromptTools = {
+  readCharacters,
+  saveCharacterFinalPrompt,
+  readScenes,
+  saveSceneFinalPrompt,
+  readProps,
+  savePropFinalPrompt,
+}
diff --git a/huobao-source/backend/src/agents/tools/script-tools.ts b/huobao-source/backend/src/agents/tools/script-tools.ts
new file mode 100644
index 0000000..2aa4d84
--- /dev/null
+++ b/huobao-source/backend/src/agents/tools/script-tools.ts
@@ -0,0 +1,78 @@
+/**
+ * 剧本改写 Agent 工具
+ * 模块级单例 — episodeId 通过 RequestContext 按请求注入
+ */
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+import { db, schema } from '../../db/index.js'
+import { eq } from 'drizzle-orm'
+import { now } from '../../utils/response.js'
+import { getEpisodeId } from '../context.js'
+
+const readEpisodeScript = createTool({
+  id: 'read_episode_script',
+  description: 'Read the script content of the current episode.',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const episodeId = getEpisodeId(context?.requestContext)
+    if (!episodeId) return { error: 'Missing episodeId in request context' }
+    const [ep] = await db.select().from(schema.episodes)
+      .where(eq(schema.episodes.id, episodeId))
+    if (!ep) return { error: `Episode not found (id=${episodeId})` }
+    const content = ep.content || ep.scriptContent
+    if (!content) return { error: `Episode has no content (id=${episodeId})` }
+    return { content, word_count: content.length, episode_id: episodeId }
+  },
+})
+
+const rewriteToScreenplay = createTool({
+  id: 'rewrite_to_screenplay',
+  description: 'Read the original content for AI rewriting. Returns the source text with formatting instructions.',
+  inputSchema: z.object({
+    instructions: z.string().optional().describe('Additional rewrite instructions'),
+  }),
+  execute: async ({ instructions }, context) => {
+    const episodeId = getEpisodeId(context?.requestContext)
+    if (!episodeId) return { error: 'Missing episodeId in request context' }
+    const [ep] = await db.select().from(schema.episodes)
+      .where(eq(schema.episodes.id, episodeId))
+    if (!ep) return { error: `Episode not found` }
+    const source = ep.content || ep.scriptContent
+    if (!source) return { error: `Episode has no content to rewrite` }
+
+    return {
+      source_content: source,
+      instruction: `请将以下内容改写为格式化剧本。
+
+格式规范：
+- 场景头：## S编号 | 内景/外景 · 地点 | 时间段
+- 动作描写：自然段落，不包含镜头语言
+- 对白：角色名：（状态/表情）台词内容
+- 每个场景 30-60 秒内容
+
+${instructions || ''}
+
+【原始内容】
+${source}`,
+    }
+  },
+})
+
+const saveScript = createTool({
+  id: 'save_script',
+  description: 'Save the rewritten screenplay content to the current episode.',
+  inputSchema: z.object({
+    content: z.string().describe('The formatted screenplay content to save'),
+  }),
+  execute: async ({ content }, context) => {
+    const episodeId = getEpisodeId(context?.requestContext)
+    if (!episodeId) return { error: 'Missing episodeId in request context' }
+    await db.update(schema.episodes)
+      .set({ scriptContent: content, updatedAt: now() })
+      .where(eq(schema.episodes.id, episodeId))
+
+    return { message: `Script saved`, word_count: content.length }
+  },
+})
+
+export const scriptTools = { readEpisodeScript, rewriteToScreenplay, saveScript }
diff --git a/huobao-source/backend/src/agents/tools/storyboard-tools.ts b/huobao-source/backend/src/agents/tools/storyboard-tools.ts
new file mode 100644
index 0000000..d0ed29a
--- /dev/null
+++ b/huobao-source/backend/src/agents/tools/storyboard-tools.ts
@@ -0,0 +1,458 @@
+/**
+ * 分镜拆解 Agent 工具
+ * 模块级单例 — episodeId + dramaId 通过 RequestContext 按请求注入
+ */
+import { createTool } from '@mastra/core/tools'
+import type { ToolExecutionContext } from '@mastra/core/tools'
+import { z } from 'zod'
+import { db, getInsertId, schema } from '../../db/index.js'
+import { and, eq, isNull } from 'drizzle-orm'
+import { now } from '../../utils/response.js'
+import { logTaskProgress, logTaskSuccess } from '../../utils/task-logger.js'
+import { getDramaId, getEpisodeId } from '../context.js'
+import { resolveVoiceMentions } from '../../services/character-voice-references.js'
+
+async function validateVideoPromptVoices(prompt: string | undefined, dramaId: number, characterIds: number[] = []) {
+  if (!prompt?.includes('#')) return
+  const characters = await db.select({ id: schema.characters.id, name: schema.characters.name, voiceAudioUrl: schema.characters.voiceAudioUrl }).from(schema.characters)
+    .where(and(eq(schema.characters.dramaId, dramaId), isNull(schema.characters.deletedAt)))
+  // Validate the model's references, but persist the original editable #tokens.
+  resolveVoiceMentions(prompt, characters.map(c => ({ ...c, bound: characterIds.includes(c.id) })))
+}
+
+async function syncStoryboardCharacters(storyboardId: number, characterIds: number[]) {
+  await db.delete(schema.storyboardCharacters)
+    .where(eq(schema.storyboardCharacters.storyboardId, storyboardId))
+
+
+  const uniqueIds = [...new Set(characterIds.filter(Boolean))]
+  if (!uniqueIds.length) return
+
+  for (const characterId of uniqueIds) {
+    await db.insert(schema.storyboardCharacters).values({
+      storyboardId,
+      characterId,
+    })
+  }
+}
+
+async function syncStoryboardProps(storyboardId: number, propIds: number[]) {
+  await db.delete(schema.storyboardProps)
+    .where(eq(schema.storyboardProps.storyboardId, storyboardId))
+
+  const uniqueIds = [...new Set(propIds.filter(Boolean))]
+  if (!uniqueIds.length) return
+
+  for (const propId of uniqueIds) {
+    await db.insert(schema.storyboardProps).values({
+      storyboardId,
+      propId,
+    })
+  }
+}
+
+async function getEpisodeSceneIds(episodeId: number) {
+  const links = await db.select().from(schema.episodeScenes)
+    .where(eq(schema.episodeScenes.episodeId, episodeId))
+  return new Set(links.map(link => link.sceneId))
+}
+
+async function getEpisodeCharacterIds(episodeId: number) {
+  const links = await db.select().from(schema.episodeCharacters)
+    .where(eq(schema.episodeCharacters.episodeId, episodeId))
+  return new Set(links.map(link => link.characterId))
+}
+
+async function getEpisodePropIds(episodeId: number) {
+  const links = await db.select().from(schema.episodeProps)
+    .where(eq(schema.episodeProps.episodeId, episodeId))
+  return new Set(links.map(link => link.propId))
+}
+
+async function validateStoryboardBindings(episodeId: number, dramaId: number, sceneId: number | null | undefined, characterIds: number[] | undefined, propIds?: number[] | undefined) {
+  const episodeSceneIds = await getEpisodeSceneIds(episodeId)
+  const episodeCharacterIds = await getEpisodeCharacterIds(episodeId)
+  const episodePropIds = await getEpisodePropIds(episodeId)
+
+  // 场景/角色/道具属于本剧但尚未关联到当前集时，自动补关联（拆分时即完成绑定）
+  if (sceneId != null && !episodeSceneIds.has(sceneId)) {
+    const [scene] = await db.select().from(schema.scenes).where(eq(schema.scenes.id, sceneId))
+    if (!scene || scene.dramaId !== dramaId || scene.deletedAt) {
+      throw new Error(`scene_id ${sceneId} 不属于当前项目`)
+    }
+    await db.insert(schema.episodeScenes).values({ episodeId, sceneId, createdAt: now() })
+  }
+
+  const uniqueCharacterIds = [...new Set((characterIds || []).filter(Boolean))]
+  for (const characterId of uniqueCharacterIds) {
+    if (episodeCharacterIds.has(characterId)) continue
+    const [character] = await db.select().from(schema.characters).where(eq(schema.characters.id, characterId))
+    if (!character || character.dramaId !== dramaId || character.deletedAt) {
+      throw new Error(`character_id ${characterId} 不属于当前项目`)
+    }
+    await db.insert(schema.episodeCharacters).values({ episodeId, characterId, createdAt: now() })
+  }
+
+  const uniquePropIds = [...new Set((propIds || []).filter(Boolean))]
+  for (const propId of uniquePropIds) {
+    if (episodePropIds.has(propId)) continue
+    const [prop] = await db.select().from(schema.props).where(eq(schema.props.id, propId))
+    if (!prop || prop.dramaId !== dramaId || prop.deletedAt) {
+      throw new Error(`prop_id ${propId} 不属于当前项目`)
+    }
+    await db.insert(schema.episodeProps).values({ episodeId, propId, createdAt: now() })
+  }
+}
+
+type ToolContext = ToolExecutionContext | undefined
+
+function requireIds(context: ToolContext): { episodeId: number; dramaId: number } | { error: string } {
+  const episodeId = getEpisodeId(context?.requestContext)
+  const dramaId = getDramaId(context?.requestContext)
+  if (!episodeId || !dramaId) return { error: 'Missing episodeId/dramaId in request context' }
+  return { episodeId, dramaId }
+}
+
+const readStoryboardContext = createTool({
+  id: 'read_storyboard_context',
+  description: 'Read the screenplay, characters, scenes, and props for storyboard breakdown.',
+  inputSchema: z.object({}),
+  execute: async (_input, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const [ep] = await db.select().from(schema.episodes)
+      .where(eq(schema.episodes.id, episodeId))
+    if (!ep) return { error: 'Episode not found' }
+    const script = ep.scriptContent || ep.content
+    if (!script) return { error: 'Episode has no script' }
+
+    const charLinks = await db.select().from(schema.episodeCharacters)
+      .where(eq(schema.episodeCharacters.episodeId, episodeId))
+    const sceneLinks = await db.select().from(schema.episodeScenes)
+      .where(eq(schema.episodeScenes.episodeId, episodeId))
+    const propLinks = await db.select().from(schema.episodeProps)
+      .where(eq(schema.episodeProps.episodeId, episodeId))
+
+    const linkedCharacterIds = new Set(charLinks.map(link => link.characterId))
+    const linkedSceneIds = new Set(sceneLinks.map(link => link.sceneId))
+    const linkedPropIds = new Set(propLinks.map(link => link.propId))
+
+    const chars = await db.select().from(schema.characters)
+      .where(eq(schema.characters.dramaId, dramaId))
+    const scns = await db.select().from(schema.scenes)
+      .where(eq(schema.scenes.dramaId, dramaId))
+    const prps = await db.select().from(schema.props)
+      .where(eq(schema.props.dramaId, dramaId))
+    const existingStoryboards = await db.select().from(schema.storyboards)
+      .where(eq(schema.storyboards.episodeId, episodeId))
+
+    const characters = chars
+      .filter(c => !c.deletedAt)
+      .filter(c => !linkedCharacterIds.size || linkedCharacterIds.has(c.id))
+      .map(c => ({
+        id: c.id,
+        name: c.name,
+        role: c.role || '',
+        description: c.description || '',
+        appearance: c.appearance || '',
+        styling: c.styling || '',
+        image_url: c.imageUrl || '',
+        reference_images: c.referenceImages || '',
+        has_voice: Boolean(c.voiceAudioUrl?.trim()),
+        voice_reference: c.voiceAudioUrl?.trim() ? `#${c.name}` : null,
+      }))
+
+    const scenes = scns
+      .filter(s => !s.deletedAt)
+      .filter(s => !linkedSceneIds.size || linkedSceneIds.has(s.id))
+      .map(s => ({
+        id: s.id,
+        location: s.location,
+        time: s.time,
+        prompt: s.prompt || '',
+        lighting: s.lighting || '',
+        image_url: s.imageUrl || '',
+        storyboard_count: s.storyboardCount || 0,
+      }))
+
+    const props = prps
+      .filter(p => !p.deletedAt)
+      .filter(p => !linkedPropIds.size || linkedPropIds.has(p.id))
+      .map(p => ({
+        id: p.id,
+        name: p.name,
+        type: p.type || '',
+        description: p.description || '',
+        image_url: p.imageUrl || '',
+      }))
+
+    const existingStoryboardPayload = await Promise.all(existingStoryboards
+      .filter(sb => !sb.deletedAt)
+      .map(async (sb) => {
+        const links = await db.select().from(schema.storyboardCharacters)
+          .where(eq(schema.storyboardCharacters.storyboardId, sb.id))
+        const sbPropLinks = await db.select().from(schema.storyboardProps)
+          .where(eq(schema.storyboardProps.storyboardId, sb.id))
+        return {
+          id: sb.id,
+          shot_number: sb.storyboardNumber,
+          title: sb.title || '',
+          scene_id: sb.sceneId,
+          character_ids: links.map(link => link.characterId),
+          available_voice_references: characters
+            .filter(c => c.has_voice && links.some(link => link.characterId === c.id))
+            .map(c => ({ character_id: c.id, name: c.name, voice_reference: c.voice_reference })),
+          prop_ids: sbPropLinks.map(link => link.propId),
+          shot_type: sb.shotType || '',
+          duration: sb.duration || 0,
+          description: sb.description || '',
+          atmosphere: sb.atmosphere || '',
+          video_prompt: sb.videoPrompt || '',
+        }
+      }))
+
+    const payload = {
+      episode: {
+        id: ep.id,
+        title: ep.title,
+        episode_number: ep.episodeNumber,
+        description: ep.description || '',
+      },
+      script,
+      characters,
+      scenes,
+      props,
+      existing_storyboards: existingStoryboardPayload,
+    }
+    logTaskSuccess('StoryboardTool', 'read-context', {
+      episodeId,
+      dramaId,
+      characters: characters.length,
+      scenes: scenes.length,
+      props: props.length,
+      existingStoryboards: payload.existing_storyboards.length,
+      scriptLength: script.length,
+    })
+    return payload
+  },
+})
+
+const storyboardFields = z.object({
+  shot_number: z.number(),
+  title: z.string().optional(),
+  shot_type: z.string().optional(),
+  angle: z.string().optional(),
+  movement: z.string().optional(),
+  location: z.string().optional(),
+  time: z.string().optional(),
+  description: z.string().optional(),
+  result: z.string().optional(),
+  atmosphere: z.string().optional(),
+  image_prompt: z.string().optional(),
+  video_prompt: z.string().optional(),
+  bgm_prompt: z.string().optional(),
+  sound_effect: z.string().optional(),
+  duration: z.number().optional(),
+  scene_id: z.number().nullable().optional(),
+  character_ids: z.array(z.number()).optional(),
+  prop_ids: z.array(z.number()).optional(),
+})
+
+const saveStoryboards = createTool({
+  id: 'save_storyboards',
+  description: 'Save storyboards for this episode. Call in batches of at most 8 storyboards: the first batch must set replace_existing: true (clears all old storyboards for the episode, then writes), every following batch omits replace_existing (appends). Rows are upserted by shot_number, so overlapping batches and retries never create duplicates.',
+  inputSchema: z.object({
+    replace_existing: z.boolean().optional(),
+    storyboards: z.array(storyboardFields),
+  }),
+  execute: async ({ storyboards, replace_existing }, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const ts = now()
+    logTaskProgress('StoryboardTool', 'save-begin', {
+      episodeId,
+      dramaId,
+      replaceExisting: replace_existing === true,
+      count: storyboards.length,
+      shotNumbers: storyboards.map(sb => sb.shot_number).join(','),
+    })
+    // Check all voice references before replace_existing can remove the previous storyboards.
+    for (const sb of storyboards) {
+      await validateVideoPromptVoices(sb.video_prompt, dramaId, sb.character_ids)
+    }
+    if (replace_existing === true) {
+      const existingStoryboardRows = await db.select().from(schema.storyboards)
+        .where(eq(schema.storyboards.episodeId, episodeId))
+      for (const storyboardId of existingStoryboardRows.map(sb => sb.id)) {
+        await db.delete(schema.storyboardCharacters)
+          .where(eq(schema.storyboardCharacters.storyboardId, storyboardId))
+        await db.delete(schema.storyboardProps)
+          .where(eq(schema.storyboardProps.storyboardId, storyboardId))
+      }
+      await db.delete(schema.storyboards).where(eq(schema.storyboards.episodeId, episodeId))
+    }
+
+    // shot_number → id 索引（含本次调用内新增的行），保证按分镜号幂等 upsert
+    const existingRows = await db.select().from(schema.storyboards)
+      .where(eq(schema.storyboards.episodeId, episodeId))
+    const shotToId = new Map<number, number>(
+      existingRows.filter(sb => !sb.deletedAt).map(sb => [sb.storyboardNumber, sb.id]),
+    )
+
+    for (const sb of storyboards) {
+      await validateStoryboardBindings(episodeId, dramaId, sb.scene_id, sb.character_ids, sb.prop_ids)
+      const existingId = shotToId.get(sb.shot_number)
+      if (existingId !== undefined) {
+        await db.update(schema.storyboards).set({
+          title: sb.title, shotType: sb.shot_type,
+          angle: sb.angle, movement: sb.movement,
+          location: sb.location, time: sb.time,
+          description: sb.description, result: sb.result,
+          atmosphere: sb.atmosphere, imagePrompt: sb.image_prompt,
+          videoPrompt: sb.video_prompt, bgmPrompt: sb.bgm_prompt,
+          soundEffect: sb.sound_effect,
+          sceneId: sb.scene_id, duration: sb.duration || 10,
+          updatedAt: ts,
+        }).where(eq(schema.storyboards.id, existingId))
+        await syncStoryboardCharacters(existingId, sb.character_ids || [])
+        await syncStoryboardProps(existingId, sb.prop_ids || [])
+      } else {
+        const res = await db.insert(schema.storyboards).values({
+          episodeId,
+          storyboardNumber: sb.shot_number,
+          title: sb.title, shotType: sb.shot_type,
+          angle: sb.angle, movement: sb.movement,
+          location: sb.location, time: sb.time,
+          description: sb.description, result: sb.result,
+          atmosphere: sb.atmosphere, imagePrompt: sb.image_prompt,
+          videoPrompt: sb.video_prompt, bgmPrompt: sb.bgm_prompt,
+          soundEffect: sb.sound_effect,
+          sceneId: sb.scene_id, duration: sb.duration || 10,
+          createdAt: ts, updatedAt: ts,
+        })
+        const newId = getInsertId(res)
+        shotToId.set(sb.shot_number, newId)
+        await syncStoryboardCharacters(newId, sb.character_ids || [])
+        await syncStoryboardProps(newId, sb.prop_ids || [])
+      }
+    }
+
+    // 整集时长 = 当前全部存活分镜时长之和（分批保存时不能再按单批累加）
+    const allRows = await db.select().from(schema.storyboards)
+      .where(eq(schema.storyboards.episodeId, episodeId))
+    const totalDuration = allRows
+      .filter(sb => !sb.deletedAt)
+      .reduce((sum, sb) => sum + (sb.duration || 0), 0)
+
+    await db.update(schema.episodes)
+      .set({ duration: Math.ceil(totalDuration / 60), updatedAt: ts })
+      .where(eq(schema.episodes.id, episodeId))
+
+    logTaskSuccess('StoryboardTool', 'save-complete', {
+      episodeId,
+      count: storyboards.length,
+      totalDuration,
+    })
+    return { message: `Saved ${storyboards.length} storyboards`, count: storyboards.length, total_duration: totalDuration }
+  },
+})
+
+const updateStoryboard = createTool({
+  id: 'update_storyboard',
+  description: 'Update a specific storyboard shot.',
+  inputSchema: z.object({
+    storyboard_id: z.number(),
+    title: z.string().optional(),
+    shot_type: z.string().optional(),
+    angle: z.string().optional(),
+    movement: z.string().optional(),
+    location: z.string().optional(),
+    time: z.string().optional(),
+    result: z.string().optional(),
+    atmosphere: z.string().optional(),
+    image_prompt: z.string().optional(),
+    video_prompt: z.string().optional(),
+    bgm_prompt: z.string().optional(),
+    sound_effect: z.string().optional(),
+    description: z.string().optional(),
+    scene_id: z.number().nullable().optional(),
+    character_ids: z.array(z.number()).optional(),
+    prop_ids: z.array(z.number()).optional(),
+    duration: z.number().optional(),
+  }),
+  execute: async ({ storyboard_id, ...fields }, context) => {
+    const ids = requireIds(context)
+    if ('error' in ids) return ids
+    const { episodeId, dramaId } = ids
+    const [storyboard] = await db.select().from(schema.storyboards).where(eq(schema.storyboards.id, storyboard_id))
+    if (!storyboard || storyboard.episodeId !== episodeId || storyboard.deletedAt) return { error: `Storyboard ${storyboard_id} not found in this episode` }
+
+    // 过滤模型回传的垃圾值：视频提示词 Agent 常把整行字段回传，
+    // 拿不准的字符串字段写成 "null"/"undefined"，直接覆盖会毁掉已有内容
+    for (const key of Object.keys(fields) as (keyof typeof fields)[]) {
+      const v = fields[key]
+      if (typeof v === 'string' && (v === 'null' || v === 'undefined' || v === 'NULL' || v === 'Null')) {
+        delete fields[key]
+      }
+    }
+
+    logTaskProgress('StoryboardTool', 'update-begin', {
+      episodeId,
+      storyboardId: storyboard_id,
+      fields: Object.keys(fields),
+    })
+
+    const currentCharacterIds = 'character_ids' in fields
+      ? fields.character_ids
+      : (await db.select().from(schema.storyboardCharacters)
+          .where(eq(schema.storyboardCharacters.storyboardId, storyboard_id)))
+          .map(link => link.characterId)
+
+    const currentPropIds = 'prop_ids' in fields
+      ? fields.prop_ids
+      : (await db.select().from(schema.storyboardProps)
+          .where(eq(schema.storyboardProps.storyboardId, storyboard_id)))
+          .map(link => link.propId)
+
+    await validateVideoPromptVoices(fields.video_prompt, dramaId, currentCharacterIds)
+    await validateStoryboardBindings(
+      episodeId,
+      dramaId,
+      'scene_id' in fields ? fields.scene_id : storyboard.sceneId,
+      currentCharacterIds,
+      currentPropIds,
+    )
+
+    const updates: Record<string, any> = { updatedAt: now() }
+    if ('title' in fields) updates.title = fields.title
+    if ('shot_type' in fields) updates.shotType = fields.shot_type
+    if ('angle' in fields) updates.angle = fields.angle
+    if ('movement' in fields) updates.movement = fields.movement
+    if ('location' in fields) updates.location = fields.location
+    if ('time' in fields) updates.time = fields.time
+    if ('result' in fields) updates.result = fields.result
+    if ('atmosphere' in fields) updates.atmosphere = fields.atmosphere
+    if ('image_prompt' in fields) updates.imagePrompt = fields.image_prompt
+    if ('video_prompt' in fields) updates.videoPrompt = fields.video_prompt
+    if ('bgm_prompt' in fields) updates.bgmPrompt = fields.bgm_prompt
+    if ('sound_effect' in fields) updates.soundEffect = fields.sound_effect
+    if ('description' in fields) updates.description = fields.description
+    if ('scene_id' in fields) updates.sceneId = fields.scene_id
+    if ('duration' in fields) updates.duration = fields.duration
+    await db.update(schema.storyboards).set(updates).where(eq(schema.storyboards.id, storyboard_id))
+    if ('character_ids' in fields) await syncStoryboardCharacters(storyboard_id, fields.character_ids || [])
+    if ('prop_ids' in fields) await syncStoryboardProps(storyboard_id, fields.prop_ids || [])
+    logTaskSuccess('StoryboardTool', 'update-complete', {
+      episodeId,
+      storyboardId: storyboard_id,
+      updatedFields: Object.keys(updates),
+      characterIds: 'character_ids' in fields ? (fields.character_ids || []).join(',') : undefined,
+      propIds: 'prop_ids' in fields ? (fields.prop_ids || []).join(',') : undefined,
+    })
+    return { message: `Storyboard ${storyboard_id} updated` }
+  },
+})
+
+export const storyboardTools = { readStoryboardContext, saveStoryboards, updateStoryboard }
diff --git a/huobao-source/backend/src/agents/voice-reference-instructions.ts b/huobao-source/backend/src/agents/voice-reference-instructions.ts
new file mode 100644
index 0000000..54be122
--- /dev/null
+++ b/huobao-source/backend/src/agents/voice-reference-instructions.ts
@@ -0,0 +1,46 @@
+/** Shared by first-time breakdown and single/batch video prompt generation.
+ * Inject at runtime so existing/custom desktop prompt files also see the voice contract.
+ */
+const instructions: Record<string, string> = {
+  zh: `## 视频提示词中的角色音色引用
+- read_storyboard_context 的角色提供 has_voice 与 voice_reference；已有分镜提供 available_voice_references。只有 has_voice 为 true 的角色才有可用音色。
+- 为某个分镜生成或重写 video_prompt 时，只使用该分镜 available_voice_references 中的音色；首次拆分时，只使用本段 character_ids 对应角色的 voice_reference。
+- 先从 description 的台词确定说话角色。画面动作使用 @角色名；有台词且有可用音色时，在对应对白的说话人位置直接使用 #角色名，紧接语气、发声动作与台词。例如：0-3秒：@林小雨抬头，#林小雨轻声说：「早上好。」
+- 音色引用必须与对白写在同一个时间段内，不新增独立的「音色：」信息头。每次对白都明确标出自己的 #说话人；多人对话逐句对应，不能把所有音色集中列在开头。
+- 直接复制 voice_reference 的完整值（如 #林小雨），禁止改名、缩写、翻译或追加“音色”后缀。@角色名引用形象，#角色名引用音色，两者分别放在画面动作与发声位置。
+- 没有上传音色的角色、未绑定角色、已移除音色和不说话的角色，不添加 # 引用。旁白只有明确对应某个已绑定、已有音色的角色时才可引用，不借用其他角色的音色。
+- 音频仅用于参考音色，台词内容与说话时机遵循 description；不要为了使用音色新增台词、人物或镜头。
+- 保存前检查 @图片引用、#音色引用和说话角色的对应关系。video_prompt 中保留原始 #角色名 标签，不写音频 URL、Base64、音频1 等上游编号；编号由视频生成接口自动映射。`,
+  en: `## Character voice references in video_prompt
+- read_storyboard_context provides has_voice and voice_reference for each character, plus available_voice_references for each existing storyboard.
+- For an existing shot, use only its available_voice_references. During initial breakdown, use only voice_reference values belonging to this segment's character_ids.
+- Identify speakers from description. Use @CharacterName for visual actions and #CharacterName directly as the speaker before delivery and dialogue, e.g. "0-3s: @Alex looks up; #Alex softly says: 'Good morning.'"
+- Keep voice references inline with each utterance in its time segment. Do not add a separate voice header or collect all voices at the start. Mark the correct #speaker for every utterance, including repeated speakers and multi-person dialogue.
+- Copy voice_reference exactly (e.g. #Alex). Do not translate, abbreviate or add a suffix. @CharacterName is the image; #CharacterName is the voice.
+- Do not add # references for unbound characters, missing/removed uploads, or silent characters. Narration may use a voice only when its speaker is explicitly a bound character with that voice; never borrow another character's voice.
+- Reference audio supplies timbre only: preserve the original dialogue and timing from description, and do not add dialogue, characters or shots just to use a voice.
+- Before saving, check speaker/image/voice bindings. Save the original #CharacterName tokens, never audio URLs, Base64 or provider audio numbers; video generation resolves the indices.`,
+  ja: `## video_prompt のキャラクター音声参照
+- read_storyboard_context は各キャラクターの has_voice と voice_reference、既存ショットの available_voice_references を返す。
+- 既存ショットではその available_voice_references のみ使用する。初回分割では、その段落の character_ids に含まれるキャラクターの voice_reference のみ使用する。
+- description のセリフから話者を確認する。画面の動作は @名前、音声がある話者の発声は #名前 を直接使う。例：「0-3秒：@太郎が顔を上げ、#太郎が優しく『おはよう』と言う。」
+- 音声参照は各時間帯のセリフ内に記載する。独立した音声ヘッダーを追加せず、冒頭に音声をまとめない。発話ごとに正しい #話者 を指定する。
+- voice_reference（例：#太郎）を完全一致でコピーし、翻訳・省略・接尾辞の追加をしない。@名前 は画像、#名前 は音声の参照。
+- 未紐付け・未アップロード・削除済み音声・無言の人物には # 参照を付けない。ナレーションは話者が音声付きの紐付け済みキャラクターと明示されている場合のみ参照し、別人の声を流用しない。
+- 音声は声質の参照のみ。description のセリフと発話タイミングを守り、音声を使うためのセリフ・人物・カットを追加しない。
+- 保存前に話者・画像・音声の対応を確認する。video_prompt には元の #名前 を保存し、音声URL、Base64、音声番号を書かない。番号への変換は動画生成側が行う。`,
+  ko: `## video_prompt의 캐릭터 음색 참조
+- read_storyboard_context는 캐릭터별 has_voice와 voice_reference, 기존 샷별 available_voice_references를 제공한다.
+- 기존 샷은 해당 available_voice_references만 사용한다. 최초 분할은 해당 구간 character_ids에 속하는 캐릭터의 voice_reference만 사용한다.
+- description의 대사에서 화자를 확인한다. 화면 동작은 @이름, 음색이 있는 화자의 발화는 #이름을 직접 사용한다. 예: "0-3초: @민수가 고개를 들고, #민수가 부드럽게 '안녕'이라고 말한다."
+- 각 시간 구간의 대사 안에 음색 참조를 넣는다. 별도의 음색 헤더를 추가하거나 처음에 음색을 모아 쓰지 않는다. 대사마다 정확한 #화자를 표시한다.
+- voice_reference(예: #민수)를 그대로 복사한다. 번역, 축약, 접미사 추가를 하지 않는다. @이름은 이미지, #이름은 음색 참조다.
+- 미연결 캐릭터, 미업로드/삭제된 음색, 말하지 않는 캐릭터에는 # 참조를 추가하지 않는다. 내레이션은 화자가 음색이 있는 연결 캐릭터로 명시된 경우에만 참조하며 다른 캐릭터의 음색을 빌리지 않는다.
+- 오디오는 음색만 참고한다. description의 대사와 발화 시점을 유지하고 음색 사용을 위해 대사, 인물, 샷을 추가하지 않는다.
+- 저장 전 화자/이미지/음색 연결을 확인한다. video_prompt에는 원래 #이름 토큰을 저장한다. 오디오 URL, Base64, 공급자 오디오 번호는 쓰지 않는다. 번호 변환은 영상 생성 단계에서 수행한다.`,
+}
+
+export function getVoiceReferenceInstructions(agentType: string, language?: string | null): string {
+  if (agentType !== 'prompt_generator' && agentType !== 'storyboard_breaker') return ''
+  return instructions[language || 'zh'] || instructions.zh
+}
diff --git a/huobao-source/backend/src/db/index.ts b/huobao-source/backend/src/db/index.ts
new file mode 100644
index 0000000..f047edf
--- /dev/null
+++ b/huobao-source/backend/src/db/index.ts
@@ -0,0 +1,48 @@
+import 'dotenv/config'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import Database from 'better-sqlite3'
+import { drizzle } from 'drizzle-orm/better-sqlite3'
+import * as schema from './schema.js'
+import { initSqliteSchema } from './sqlite-schema.js'
+import { maybeAutoImportMysql } from './mysql-import.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+// src/db → 上三级为仓库根（与 utils/paths.ts 的推断层级一致）
+const repoRoot = path.resolve(__dirname, '../../..')
+
+// 桌面版由 Electron 主进程注入 SQLITE_PATH（userData 下）；dev 默认仓库根 data/
+// 注意：勿沿用旧文件名 huobao_drama.db —— 那是早期 SQLite 时代的遗留库，表名重叠但列不同
+export const dbPath = process.env.SQLITE_PATH || path.join(repoRoot, 'data', 'huobao.sqlite3')
+fs.mkdirSync(path.dirname(dbPath), { recursive: true })
+
+const sqlite = new Database(dbPath)
+
+// WAL：生成任务轮询与页面读并发时不互相阻塞；busy_timeout 兜底写锁竞争
+sqlite.pragma('journal_mode = WAL')
+sqlite.pragma('busy_timeout = 5000')
+sqlite.pragma('synchronous = NORMAL')
+
+/** 启动建表（DDL 幂等重放 + 种子补缺）。SQLite 无连接就绪问题，无需重试 */
+export function initDb() {
+  initSqliteSchema(sqlite)
+}
+
+initDb()
+
+// MySQL 老用户一次性自动迁移：仅在显式配置 MySQL + 空库 + 无标记时触发（详见 mysql-import.ts 头注释）
+await maybeAutoImportMysql(sqlite, dbPath)
+
+/** better-sqlite3 的 lastInsertRowid 可能是 bigint，统一转 number */
+export function getInsertId(result: unknown) {
+  const res = result as { lastInsertRowid?: number | bigint } | undefined
+  if (res?.lastInsertRowid === undefined || res.lastInsertRowid === null) {
+    throw new Error('SQLite insert did not return lastInsertRowid')
+  }
+  return Number(res.lastInsertRowid)
+}
+
+export const db = drizzle(sqlite, { schema })
+export { schema }
+export type DB = typeof db
diff --git a/huobao-source/backend/src/db/mysql-import.ts b/huobao-source/backend/src/db/mysql-import.ts
new file mode 100644
index 0000000..5003b9c
--- /dev/null
+++ b/huobao-source/backend/src/db/mysql-import.ts
@@ -0,0 +1,175 @@
+/**
+ * MySQL → SQLite 数据导入（启动自动迁移 + CLI 脚本共用核心）
+ *
+ * 自动迁移触发条件（全部满足）：
+ * 1. 未设 MYSQL_AUTO_IMPORT=false
+ * 2. 显式配置了 MySQL（DATABASE_URL 或 MYSQL_HOST；纯默认值不触发，避免桌面/新装用户误连）
+ * 3. SQLite 业务表为空（style_presets 种子不计）
+ * 4. 无完成标记文件 <sqlite>.mysql-imported（导入成功后写入；MySQL 不可达时不写，下次启动重试）
+ *
+ * 导入为两段式：先从 MySQL 全量读出到内存，再在单个 SQLite 事务内写入，
+ * 任一步失败整体回滚，不留半迁移状态。
+ */
+import fs from 'fs'
+import mysql from 'mysql2/promise'
+import type { Database as SqliteDB } from 'better-sqlite3'
+
+/** 依赖序：被引用表先写（SQLite 未开外键时仅为可读性约定，保持导入顺序清晰） */
+export const MIGRATE_TABLES = [
+  'dramas',
+  'characters',
+  'props',
+  'scenes',
+  'episodes',
+  'storyboards',
+  'episode_characters',
+  'episode_scenes',
+  'episode_props',
+  'storyboard_characters',
+  'storyboard_props',
+  'ai_service_configs',
+  'ai_service_providers',
+  'style_presets',
+  'sys_task',
+  'video_merges',
+  'assets',
+]
+
+/** MySQL 行 → SQLite 可绑定值（boolean→0/1，undefined→null） */
+export function sanitize(v: unknown): string | number | bigint | null {
+  if (v === undefined || v === null) return null
+  if (typeof v === 'boolean') return v ? 1 : 0
+  if (v instanceof Date) return v.toISOString()
+  if (typeof v === 'number' || typeof v === 'string' || typeof v === 'bigint') return v
+  return String(v)
+}
+
+/**
+ * 仅在显式配置 MySQL 时返回连接串（DATABASE_URL 或 MYSQL_HOST）。
+ * 纯默认值不触发，避免桌面/新装用户误连本机无关 MySQL。
+ */
+export function mysqlUrlFromEnv(): string | null {
+  if (process.env.DATABASE_URL) return process.env.DATABASE_URL
+  if (!process.env.MYSQL_HOST) return null
+  const host = process.env.MYSQL_HOST
+  const port = process.env.MYSQL_PORT || '3306'
+  const user = encodeURIComponent(process.env.MYSQL_USER || 'huobao')
+  const password = encodeURIComponent(process.env.MYSQL_PASSWORD || 'huobao')
+  const database = process.env.MYSQL_DATABASE || 'huobao_drama'
+  return `mysql://${user}:${password}@${host}:${port}/${database}`
+}
+
+/** SQLite 业务表是否为空（style_presets 启动种子不计） */
+export function sqliteBusinessRowCount(sqlite: SqliteDB): number {
+  return MIGRATE_TABLES
+    .filter(t => t !== 'style_presets')
+    .reduce((sum, t) => {
+      const { n } = sqlite.prepare(`SELECT COUNT(*) AS n FROM "${t}"`).get() as { n: number }
+      return sum + n
+    }, 0)
+}
+
+/**
+ * 两段式导入：先全量读出，再单事务写入；行数不一致抛错（事务随之回滚）。
+ */
+export async function importMysqlData(
+  pool: mysql.Pool,
+  sqlite: SqliteDB,
+  log: (msg: string) => void = console.log,
+): Promise<{ totalSrc: number; totalDst: number }> {
+  // 第一段：读出
+  const dump: Record<string, Record<string, unknown>[]> = {}
+  for (const table of MIGRATE_TABLES) {
+    const [rows] = await pool.query(`SELECT * FROM \`${table}\``)
+    dump[table] = rows as Record<string, unknown>[]
+  }
+
+  // 第二段：单事务写入
+  let totalSrc = 0
+  let totalDst = 0
+  const mismatch: string[] = []
+
+  sqlite.transaction(() => {
+    for (const table of MIGRATE_TABLES) {
+      const data = dump[table]
+      const columns = data.length ? Object.keys(data[0]) : null
+
+      // 导入前清空目标表：style_presets 的初始化种子会撞 UNIQUE(value)；重复执行保持幂等
+      if (data.length) {
+        sqlite.prepare(`DELETE FROM "${table}"`).run()
+      }
+
+      if (columns) {
+        const colList = columns.map(c => `"${c}"`).join(', ')
+        const placeholders = columns.map(() => '?').join(', ')
+        const stmt = sqlite.prepare(`INSERT INTO "${table}" (${colList}) VALUES (${placeholders})`)
+        for (const row of data) {
+          stmt.run(...columns.map(c => sanitize(row[c])))
+        }
+      }
+
+      const dst = (sqlite.prepare(`SELECT COUNT(*) AS n FROM "${table}"`).get() as { n: number }).n
+      totalSrc += data.length
+      totalDst += dst
+      log(`${data.length === dst ? '✓' : '✗'} ${table}: mysql=${data.length} sqlite=${dst}`)
+      if (data.length !== dst) mismatch.push(table)
+    }
+  })()
+
+  if (mismatch.length) {
+    throw new Error(`行数不一致: ${mismatch.join(', ')}`)
+  }
+  return { totalSrc, totalDst }
+}
+
+/**
+ * 启动时自动迁移（条件见文件头注释）。永不抛出：失败仅告警并回滚，不阻塞服务启动。
+ */
+export async function maybeAutoImportMysql(sqlite: SqliteDB, dbPath: string): Promise<void> {
+  const tag = '[mysql-import]'
+  if ((process.env.MYSQL_AUTO_IMPORT || 'true').toLowerCase() === 'false') return
+
+  const url = mysqlUrlFromEnv()
+  if (!url) return
+
+  const marker = `${dbPath}.mysql-imported`
+  if (fs.existsSync(marker)) return
+
+  if (sqliteBusinessRowCount(sqlite) > 0) return // 已有业务数据，静默跳过
+
+  let pool: mysql.Pool | null = null
+  try {
+    pool = mysql.createPool({ uri: url, connectionLimit: 4, charset: 'utf8mb4', connectTimeout: 3000 })
+    await pool.query('SELECT 1')
+  } catch (err) {
+    console.warn(`${tag} 已配置 MySQL 但连接失败（${(err as Error).message}），本次跳过自动迁移，下次启动重试`)
+    await pool?.end().catch(() => {})
+    return
+  }
+
+  try {
+    // MySQL 侧无业务数据 → 写标记，避免每次启动探测
+    const [rows] = await pool.query('SELECT (SELECT COUNT(*) FROM `dramas`) + (SELECT COUNT(*) FROM `ai_service_configs`) AS n')
+    const mysqlRows = Number((rows as { n: number }[])[0]?.n || 0)
+    if (mysqlRows === 0) {
+      fs.writeFileSync(marker, `mysql source empty at ${new Date().toISOString()}\n`)
+      return
+    }
+
+    console.log(`${tag} 检测到 MySQL 旧数据（${mysqlRows} 行关键表记录），开始自动迁移到 SQLite…`)
+    if (fs.existsSync(dbPath)) {
+      const backup = `${dbPath}.bak-${Date.now()}`
+      fs.copyFileSync(dbPath, backup)
+      console.log(`${tag} 已备份现有库 → ${backup}`)
+    }
+
+    const { totalSrc, totalDst } = await importMysqlData(pool, sqlite, msg => console.log(`${tag} ${msg}`))
+    fs.writeFileSync(marker, `imported ${totalSrc} rows at ${new Date().toISOString()}\n`)
+    console.log(`${tag} 迁移完成 ✓（mysql=${totalSrc} sqlite=${totalDst}）`)
+    console.log(`${tag} 提示：若旧部署的 data/static 媒体文件不在本机，请手动拷贝，否则历史素材将无法访问`)
+  } catch (err) {
+    console.error(`${tag} 自动迁移失败（已回滚，不影响本次启动，下次启动将重试）:`, (err as Error).message)
+  } finally {
+    await pool.end().catch(() => {})
+  }
+}
diff --git a/huobao-source/backend/src/db/schema.ts b/huobao-source/backend/src/db/schema.ts
new file mode 100644
index 0000000..ef61246
--- /dev/null
+++ b/huobao-source/backend/src/db/schema.ts
@@ -0,0 +1,298 @@
+/**
+ * Drizzle schema - SQLite column mappings.
+ * 自 MySQL 迁移：varchar(x)→text（SQLite 不校验长度）、int→integer、
+ * boolean→integer boolean mode、时间戳仍为 text 存 ISO 字符串，表/列名不变。
+ */
+import { sqliteTable, text, integer, primaryKey } from 'drizzle-orm/sqlite-core'
+
+export const dramas = sqliteTable('dramas', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  title: text('title').notNull(),
+  description: text('description'),
+  genre: text('genre'),
+  style: text('style').default('3d'),
+  aspectRatio: text('aspect_ratio').default('16:9'),
+  totalEpisodes: integer('total_episodes').default(1),
+  totalDuration: integer('total_duration').default(0),
+  status: text('status').notNull().default('draft'),
+  thumbnail: text('thumbnail'),
+  tags: text('tags'),
+  metadata: text('metadata'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  deletedAt: text('deleted_at'),
+})
+
+export const episodes = sqliteTable('episodes', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  dramaId: integer('drama_id').notNull(),
+  episodeNumber: integer('episode_number').notNull(),
+  title: text('title').notNull(),
+  content: text('content'),
+  scriptContent: text('script_content'),
+  description: text('description'),
+  duration: integer('duration').default(0),
+  status: text('status').default('draft'),
+  videoUrl: text('video_url'),
+  thumbnail: text('thumbnail'),
+  imageConfigId: integer('image_config_id'),
+  videoConfigId: integer('video_config_id'),
+  resolution: text('resolution').default('720p'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  deletedAt: text('deleted_at'),
+})
+
+export const characters = sqliteTable('characters', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  dramaId: integer('drama_id').notNull(),
+  name: text('name').notNull(),
+  role: text('role'),
+  description: text('description'),
+  appearance: text('appearance'),
+  styling: text('styling'),
+  finalPrompt: text('final_prompt'),
+  personality: text('personality'),
+  imageUrl: text('image_url'),
+  voiceAudioUrl: text('voice_audio_url'),
+  voiceAudioName: text('voice_audio_name'),
+  referenceImages: text('reference_images'),
+  seedValue: text('seed_value'),
+  sortOrder: integer('sort_order'),
+  localPath: text('local_path'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  deletedAt: text('deleted_at'),
+})
+
+// Episode-Character many-to-many
+export const episodeCharacters = sqliteTable('episode_characters', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  episodeId: integer('episode_id').notNull(),
+  characterId: integer('character_id').notNull(),
+  createdAt: text('created_at').notNull(),
+})
+
+// Episode-Scene many-to-many
+export const episodeScenes = sqliteTable('episode_scenes', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  episodeId: integer('episode_id').notNull(),
+  sceneId: integer('scene_id').notNull(),
+  createdAt: text('created_at').notNull(),
+})
+
+// Episode-Prop many-to-many
+export const episodeProps = sqliteTable('episode_props', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  episodeId: integer('episode_id').notNull(),
+  propId: integer('prop_id').notNull(),
+  createdAt: text('created_at').notNull(),
+})
+
+export const scenes = sqliteTable('scenes', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  dramaId: integer('drama_id').notNull(),
+  episodeId: integer('episode_id'),
+  location: text('location').notNull(),
+  time: text('time').notNull(),
+  prompt: text('prompt').notNull(),
+  lighting: text('lighting'),
+  finalPrompt: text('final_prompt'),
+  storyboardCount: integer('storyboard_count').default(1),
+  imageUrl: text('image_url'),
+  referenceImages: text('reference_images'),
+  status: text('status').default('pending'),
+  localPath: text('local_path'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  deletedAt: text('deleted_at'),
+})
+
+export const storyboards = sqliteTable('storyboards', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  episodeId: integer('episode_id').notNull(),
+  sceneId: integer('scene_id'),
+  storyboardNumber: integer('storyboard_number').notNull(),
+  title: text('title'),
+  location: text('location'),
+  time: text('time'),
+  shotType: text('shot_type'),
+  angle: text('angle'),
+  movement: text('movement'),
+  result: text('result'),
+  atmosphere: text('atmosphere'),
+  imagePrompt: text('image_prompt'),
+  videoPrompt: text('video_prompt'),
+  bgmPrompt: text('bgm_prompt'),
+  soundEffect: text('sound_effect'),
+  description: text('description'),
+  duration: integer('duration').default(0),
+  composedImage: text('composed_image'),
+  firstFrameImage: text('first_frame_image'),
+  lastFrameImage: text('last_frame_image'),
+  referenceImages: text('reference_images'),
+  videoUrl: text('video_url'),
+  subtitleUrl: text('subtitle_url'),
+  composedVideoUrl: text('composed_video_url'),
+  status: text('status').default('pending'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  deletedAt: text('deleted_at'),
+})
+
+export const storyboardCharacters = sqliteTable('storyboard_characters', {
+  storyboardId: integer('storyboard_id').notNull(),
+  characterId: integer('character_id').notNull(),
+}, (table) => [
+  primaryKey({ columns: [table.storyboardId, table.characterId] }),
+])
+
+export const storyboardProps = sqliteTable('storyboard_props', {
+  storyboardId: integer('storyboard_id').notNull(),
+  propId: integer('prop_id').notNull(),
+}, (table) => [
+  primaryKey({ columns: [table.storyboardId, table.propId] }),
+])
+
+export const aiServiceConfigs = sqliteTable('ai_service_configs', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  serviceType: text('service_type').notNull(),
+  provider: text('provider'),
+  name: text('name').notNull(),
+  baseUrl: text('base_url').notNull(),
+  apiKey: text('api_key').notNull(),
+  model: text('model'),
+  endpoint: text('endpoint'),
+  queryEndpoint: text('query_endpoint'),
+  priority: integer('priority').default(0),
+  isDefault: integer('is_default', { mode: 'boolean' }).default(false),
+  isActive: integer('is_active', { mode: 'boolean' }).default(true),
+  settings: text('settings'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  // 注意: 此表无 deleted_at
+})
+
+export const aiServiceProviders = sqliteTable('ai_service_providers', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  name: text('name').notNull(),
+  displayName: text('display_name'),
+  serviceType: text('service_type').notNull(),
+  provider: text('provider').notNull(),
+  defaultUrl: text('default_url'),
+  presetModels: text('preset_models'),
+  description: text('description'),
+  isActive: integer('is_active', { mode: 'boolean' }).default(true),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+})
+
+export const stylePresets = sqliteTable('style_presets', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  name: text('name').notNull(),
+  value: text('value').notNull(),
+  prompt: text('prompt').notNull(),
+  description: text('description'),
+  sortOrder: integer('sort_order').default(0),
+  isActive: integer('is_active', { mode: 'boolean' }).default(true),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  // 注意: 此表无 deleted_at（硬删除），value 列有唯一索引（见 sqlite-schema.ts DDL）
+})
+
+// 统一生成任务表：图片/视频生成共用，type 区分，生成参数存 params(JSON)
+export const sysTask = sqliteTable('sys_task', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  configId: integer('config_id'),
+  configBaseUrl: text('config_base_url'),
+  stage: text('stage'),
+  errorCode: text('error_code'),
+  type: text('type').notNull(), // image | video
+  storyboardId: integer('storyboard_id'),
+  dramaId: integer('drama_id'),
+  sceneId: integer('scene_id'),
+  characterId: integer('character_id'),
+  propId: integer('prop_id'),
+  provider: text('provider'),
+  prompt: text('prompt'),
+  model: text('model'),
+  // image: {size, frameType, referenceImages[]}
+  // video: {referenceMode, firstFrameUrl, lastFrameUrl, referenceImageUrls[], referenceVideoUrls[], referenceAudioUrls[], referenceFileUrl, referenceLinkUrl, generateAudio, duration, aspectRatio, resolution, seed, promptExtend, watermark}
+  params: text('params'),
+  taskId: text('task_id'),
+  resultUrl: text('result_url'),
+  localPath: text('local_path'),
+  status: text('status').default('processing'),
+  errorMsg: text('error_msg'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  completedAt: text('completed_at'),
+})
+
+export const videoMerges = sqliteTable('video_merges', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  episodeId: integer('episode_id'),
+  dramaId: integer('drama_id'),
+  title: text('title'),
+  provider: text('provider'),
+  model: text('model'),
+  status: text('status').default('pending'),
+  scenes: text('scenes'), // JSON
+  mergedUrl: text('merged_url'),
+  duration: integer('duration'),
+  taskId: text('task_id'),
+  errorMsg: text('error_msg'),
+  createdAt: text('created_at').notNull(),
+  completedAt: text('completed_at'),
+  deletedAt: text('deleted_at'),
+})
+
+export const props = sqliteTable('props', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  dramaId: integer('drama_id').notNull(),
+  name: text('name').notNull(),
+  type: text('type'),
+  description: text('description'),
+  prompt: text('prompt'),
+  finalPrompt: text('final_prompt'),
+  imageUrl: text('image_url'),
+  referenceImages: text('reference_images'),
+  localPath: text('local_path'),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  deletedAt: text('deleted_at'),
+})
+
+export const assets = sqliteTable('assets', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  dramaId: integer('drama_id'),
+  episodeId: integer('episode_id'),
+  storyboardId: integer('storyboard_id'),
+  storyboardNum: integer('storyboard_num'),
+  name: text('name'),
+  description: text('description'),
+  type: text('type'),
+  category: text('category'),
+  url: text('url'),
+  thumbnailUrl: text('thumbnail_url'),
+  localPath: text('local_path'),
+  fileSize: integer('file_size'),
+  mimeType: text('mime_type'),
+  width: integer('width'),
+  height: integer('height'),
+  duration: integer('duration'),
+  format: text('format'),
+  imageGenId: integer('image_gen_id'),
+  videoGenId: integer('video_gen_id'),
+  isFavorite: integer('is_favorite', { mode: 'boolean' }).default(false),
+  viewCount: integer('view_count').default(0),
+  createdAt: text('created_at').notNull(),
+  updatedAt: text('updated_at').notNull(),
+  deletedAt: text('deleted_at'),
+})
+
+export const appSettings = sqliteTable('app_settings', {
+  key: text('key').primaryKey(),
+  value: text('value').notNull(),
+  updatedAt: text('updated_at').notNull(),
+})
diff --git a/huobao-source/backend/src/db/sqlite-schema.ts b/huobao-source/backend/src/db/sqlite-schema.ts
new file mode 100644
index 0000000..108fa62
--- /dev/null
+++ b/huobao-source/backend/src/db/sqlite-schema.ts
@@ -0,0 +1,413 @@
+/**
+ * SQLite 启动建表 DDL + 种子数据（自 mysql-schema.ts 翻译）
+ * - AUTO_INCREMENT → AUTOINCREMENT；删除 ENGINE/CHARSET；TINYINT(1) → INTEGER
+ * - MySQL 内联 INDEX 拆为独立 CREATE INDEX IF NOT EXISTS
+ * - 种子语句去掉 FROM DUAL（SQLite 非法），幂等语义（WHERE NOT EXISTS）保留
+ */
+import type Database from 'better-sqlite3'
+
+export const sqliteSchemaStatements = [
+  `CREATE TABLE IF NOT EXISTS dramas (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    title TEXT NOT NULL,
+    description TEXT,
+    genre TEXT,
+    style TEXT DEFAULT '3d',
+    aspect_ratio TEXT DEFAULT '16:9',
+    total_episodes INTEGER DEFAULT 1,
+    total_duration INTEGER DEFAULT 0,
+    status TEXT NOT NULL DEFAULT 'draft',
+    thumbnail TEXT,
+    tags TEXT,
+    metadata TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    deleted_at TEXT
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS episodes (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    drama_id INTEGER NOT NULL,
+    episode_number INTEGER NOT NULL,
+    title TEXT NOT NULL,
+    content TEXT,
+    script_content TEXT,
+    description TEXT,
+    duration INTEGER DEFAULT 0,
+    status TEXT DEFAULT 'draft',
+    video_url TEXT,
+    thumbnail TEXT,
+    image_config_id INTEGER,
+    video_config_id INTEGER,
+    resolution TEXT DEFAULT '720p',
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    deleted_at TEXT
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS characters (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    drama_id INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    role TEXT,
+    description TEXT,
+    appearance TEXT,
+    styling TEXT,
+    final_prompt TEXT,
+    personality TEXT,
+    image_url TEXT,
+    voice_audio_url TEXT,
+    voice_audio_name TEXT,
+    reference_images TEXT,
+    seed_value TEXT,
+    sort_order INTEGER,
+    local_path TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    deleted_at TEXT
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS scenes (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    drama_id INTEGER NOT NULL,
+    episode_id INTEGER,
+    location TEXT NOT NULL,
+    time TEXT NOT NULL,
+    prompt TEXT NOT NULL,
+    lighting TEXT,
+    final_prompt TEXT,
+    storyboard_count INTEGER DEFAULT 1,
+    image_url TEXT,
+    reference_images TEXT,
+    status TEXT DEFAULT 'pending',
+    local_path TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    deleted_at TEXT
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS storyboards (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER NOT NULL,
+    scene_id INTEGER,
+    storyboard_number INTEGER NOT NULL,
+    title TEXT,
+    location TEXT,
+    time TEXT,
+    shot_type TEXT,
+    angle TEXT,
+    movement TEXT,
+    result TEXT,
+    atmosphere TEXT,
+    image_prompt TEXT,
+    video_prompt TEXT,
+    bgm_prompt TEXT,
+    sound_effect TEXT,
+    description TEXT,
+    duration INTEGER DEFAULT 0,
+    composed_image TEXT,
+    first_frame_image TEXT,
+    last_frame_image TEXT,
+    reference_images TEXT,
+    video_url TEXT,
+    subtitle_url TEXT,
+    composed_video_url TEXT,
+    status TEXT DEFAULT 'pending',
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    deleted_at TEXT
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS episode_characters (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER NOT NULL,
+    character_id INTEGER NOT NULL,
+    created_at TEXT NOT NULL
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_episode_characters_episode_id ON episode_characters (episode_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_episode_characters_character_id ON episode_characters (character_id)`,
+
+  `CREATE TABLE IF NOT EXISTS episode_scenes (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER NOT NULL,
+    scene_id INTEGER NOT NULL,
+    created_at TEXT NOT NULL
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_episode_scenes_episode_id ON episode_scenes (episode_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_episode_scenes_scene_id ON episode_scenes (scene_id)`,
+
+  `CREATE TABLE IF NOT EXISTS episode_props (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER NOT NULL,
+    prop_id INTEGER NOT NULL,
+    created_at TEXT NOT NULL
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_episode_props_episode_id ON episode_props (episode_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_episode_props_prop_id ON episode_props (prop_id)`,
+
+  `CREATE TABLE IF NOT EXISTS storyboard_characters (
+    storyboard_id INTEGER NOT NULL,
+    character_id INTEGER NOT NULL,
+    PRIMARY KEY (storyboard_id, character_id)
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_storyboard_characters_character_id ON storyboard_characters (character_id)`,
+
+  `CREATE TABLE IF NOT EXISTS storyboard_props (
+    storyboard_id INTEGER NOT NULL,
+    prop_id INTEGER NOT NULL,
+    PRIMARY KEY (storyboard_id, prop_id)
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_storyboard_props_prop_id ON storyboard_props (prop_id)`,
+
+  `CREATE TABLE IF NOT EXISTS ai_service_configs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    service_type TEXT NOT NULL,
+    provider TEXT,
+    name TEXT NOT NULL,
+    base_url TEXT NOT NULL,
+    api_key TEXT NOT NULL,
+    model TEXT,
+    endpoint TEXT,
+    query_endpoint TEXT,
+    priority INTEGER DEFAULT 0,
+    is_default INTEGER DEFAULT 0,
+    is_active INTEGER DEFAULT 1,
+    settings TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS ai_service_providers (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    display_name TEXT,
+    service_type TEXT NOT NULL,
+    provider TEXT NOT NULL,
+    default_url TEXT,
+    preset_models TEXT,
+    description TEXT,
+    is_active INTEGER DEFAULT 1,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS style_presets (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    value TEXT NOT NULL,
+    prompt TEXT NOT NULL,
+    description TEXT,
+    sort_order INTEGER DEFAULT 0,
+    is_active INTEGER DEFAULT 1,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    UNIQUE (value)
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS sys_task (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    type TEXT NOT NULL,
+    storyboard_id INTEGER,
+    drama_id INTEGER,
+    scene_id INTEGER,
+    character_id INTEGER,
+    prop_id INTEGER,
+    provider TEXT,
+    prompt TEXT,
+    model TEXT,
+    params TEXT,
+    task_id TEXT,
+    result_url TEXT,
+    local_path TEXT,
+    status TEXT DEFAULT 'processing',
+    error_msg TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    completed_at TEXT
+  )`,
+  `CREATE INDEX IF NOT EXISTS idx_sys_task_type ON sys_task (type)`,
+  `CREATE INDEX IF NOT EXISTS idx_sys_task_drama_id ON sys_task (drama_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_sys_task_storyboard_id ON sys_task (storyboard_id)`,
+
+  `CREATE TABLE IF NOT EXISTS video_merges (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER,
+    drama_id INTEGER,
+    title TEXT,
+    provider TEXT NOT NULL,
+    model TEXT NOT NULL,
+    status TEXT DEFAULT 'pending',
+    scenes TEXT,
+    merged_url TEXT,
+    duration INTEGER,
+    task_id TEXT,
+    error_msg TEXT,
+    created_at TEXT NOT NULL,
+    completed_at TEXT,
+    deleted_at TEXT
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS props (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    drama_id INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    type TEXT,
+    description TEXT,
+    prompt TEXT,
+    final_prompt TEXT,
+    image_url TEXT,
+    reference_images TEXT,
+    local_path TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    deleted_at TEXT
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS assets (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    drama_id INTEGER,
+    episode_id INTEGER,
+    storyboard_id INTEGER,
+    storyboard_num INTEGER,
+    name TEXT,
+    description TEXT,
+    type TEXT,
+    category TEXT,
+    url TEXT,
+    thumbnail_url TEXT,
+    local_path TEXT,
+    file_size INTEGER,
+    mime_type TEXT,
+    width INTEGER,
+    height INTEGER,
+    duration INTEGER,
+    format TEXT,
+    image_gen_id INTEGER,
+    video_gen_id INTEGER,
+    is_favorite INTEGER DEFAULT 0,
+    view_count INTEGER DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    deleted_at TEXT
+  )`,
+
+  // 应用级全局设置（key-value，如 AI 内容语言 content_language）
+  `CREATE TABLE IF NOT EXISTS app_settings (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  )`,
+]
+
+/**
+ * 风格预设种子数据 — value 存入 dramas.style，prompt 注入生图提示词（作为前缀拼接）
+ *
+ * prompt 统一按多维结构书写，保证跨模型/跨镜头的风格控制力：
+ *   核心媒介与渲染 → 线条/造型 → 上色/材质 → 光影 → 色彩调性 → 背景处理 → 画质锚点 → avoid 禁忌项
+ */
+export const stylePresetSeeds = [
+  {
+    name: '3D 漫剧', value: '3d', sortOrder: 1,
+    prompt: 'high-quality 3D CG animation still, modern game-engine cinematic render, Unreal Engine and Pixar grade quality, semi-realistic stylized characters with refined facial features, clean sculpted anatomy, detailed skin shader with subtle subsurface scattering, PBR materials with crisp detailed textures, volumetric cinematic lighting with soft rim light, rich depth of field, polished film color grading, detailed environment art, sharp focus, consistent character design across shots, avoid flat lighting, avoid plastic waxy skin, avoid low-poly blurry look, avoid 2D flat cel shading, avoid anime line art',
+    description: '游戏引擎级 3D 渲染，半写实角色，当前短剧主流的 3D 漫剧质感',
+  },
+  {
+    name: '日漫赛璐璐', value: 'anime', sortOrder: 2,
+    prompt: 'Japanese TV anime style, clean cel shading with hard-edged shadow shapes, crisp uniform black line art, vivid saturated color palette, expressive large-eyed character design with on-model proportions, detailed hand-painted anime backgrounds, dramatic anime key lighting with screentone highlights, key-visual poster quality, consistent character design across shots, avoid 3D CGI look, avoid painterly soft blending, avoid watercolor texture, avoid photorealism, avoid thick western comic outlines',
+    description: '日式赛璐璐动画风格',
+  },
+  {
+    name: '吉卜力手绘', value: 'ghibli', sortOrder: 3,
+    prompt: 'Studio Ghibli hand-drawn animation style, soft painterly brushwork with organic hand-crafted line quality, lush warm watercolor painted backgrounds, gentle natural daylight with nostalgic warm glow, muted earthy natural color palette, whimsical cozy storybook atmosphere, subtle film-grain softness, theatrical background art quality, consistent character design across shots, avoid hard cel shading, avoid 3D render look, avoid neon over-saturated colors, avoid sharp digital edges, avoid photorealism',
+    description: '吉卜力手绘治愈风',
+  },
+  {
+    name: '水彩绘本', value: 'watercolor', sortOrder: 4,
+    prompt: 'delicate watercolor storybook illustration, soft translucent color washes, visible cold-press paper texture, fluid hand-painted brushstrokes with gentle pigment bleeds, light airy atmosphere, harmonious pastel palette, whimsical children book charm, loose expressive edges, consistent character design across shots, avoid bold black outlines, avoid digital airbrush look, avoid harsh contrast, avoid 3D rendering, avoid photorealism',
+    description: '水彩插画质感',
+  },
+  {
+    name: '美式漫画', value: 'comic', sortOrder: 5,
+    prompt: 'Western graphic-novel comic book style, bold confident black ink outlines, halftone dot shading and screentone gradients, dynamic saturated colors with dramatic contrast, dramatic spotlight lighting, flat graphic print look, sharp inking details, dynamic cinematic composition, consistent character design across shots, avoid painterly soft blending, avoid watercolor washes, avoid photorealistic rendering, avoid 3D CGI look, avoid anime cel shading',
+    description: '美式漫画粗线条风格',
+  },
+  {
+    name: '国风 2.5D', value: 'guofeng', sortOrder: 7,
+    prompt: 'Chinese guofeng 2.5D illustration style, semi-realistic donghua-quality character art, elegant flowing line work, rich traditional Chinese aesthetic elements, layered ink-wash inspired atmospheric backgrounds, refined silk and fabric textures, soft luminous lighting with gentle haze, sophisticated muted jewel-tone palette, xianxia drama poster quality, consistent character design across shots, avoid flat cel shading, avoid western comic ink style, avoid photorealism, avoid plastic 3D look, avoid modern clothing and props unless specified',
+    description: '国风动画/仙侠剧质感，2.5D 半写实',
+  },
+  {
+    name: '韩系网漫', value: 'webtoon', sortOrder: 8,
+    prompt: 'Korean webtoon manhwa style, clean digital painting with soft gradient shading, slim elegant character proportions, large expressive eyes with detailed highlights, soft glowing skin rendering, romantic dreamy lighting, modern pastel-to-vivid color palette, detailed fashion and fabric rendering, webtoon key visual quality, consistent character design across shots, avoid heavy black ink outlines, avoid halftone dots, avoid 3D render look, avoid watercolor paper texture, avoid chibi proportions',
+    description: '韩国条漫/网漫精致上色风',
+  },
+  {
+    name: '黑白漫画', value: 'noir', sortOrder: 9,
+    prompt: 'black and white manga illustration, high-contrast monochrome ink work, dynamic hatching and cross-hatching shading, bold solid blacks with dramatic negative space, screentone gray gradation, expressive confident ink linework, cinematic noir lighting, professional manga page quality, consistent character design across shots, strictly no color, avoid grayscale blur smudging, avoid painterly soft edges, avoid photorealism, avoid 3D render look',
+    description: '黑白漫/ Noir 高对比墨水风',
+  },
+]
+
+/**
+ * 旧版种子 prompt（v1 一句话风格描述）— 用于内容寻址升级：
+ * 仅当库中行的 prompt 仍等于旧种子值（未被用户在设置页编辑过）才覆盖为新 prompt
+ */
+const LEGACY_SEED_PROMPTS: Record<string, string> = {
+  '3d': '3D CG animation style, game-engine quality render, semi-realistic stylized characters, refined facial features, detailed materials and textures, cinematic lighting, high detail',
+  anime: 'Japanese anime style, cel shading, clean crisp line art, vivid saturated colors, expressive character designs, detailed painted backgrounds',
+  ghibli: 'Studio Ghibli style, hand-drawn animation, soft watercolor painted backgrounds, warm nostalgic lighting, gentle natural palette, whimsical cozy atmosphere',
+  watercolor: 'watercolor illustration style, soft translucent washes, visible paper texture, delicate fluid brushwork, light airy atmosphere, hand-painted storybook feel',
+  comic: 'Western comic book style, bold black ink outlines, halftone dot shading, dynamic saturated colors, dramatic contrast lighting, flat graphic novel look',
+}
+
+/**
+ * 已下架的种子预设 — 内容寻址删除：仅当库中行的 prompt 仍是种子原文
+ * （未被用户编辑过）才删除；用户改过的同名行视为用户数据保留。
+ * live（真人写实）：真人影像过不了平台真人内容审核，下架。
+ */
+const REMOVED_SEED_PROMPTS: Record<string, string> = {
+  live: 'ultra-realistic cinematic live-action look, professional film photography, natural skin tones with detailed pores and realistic texture, true human anatomy and proportions, shallow depth of field with creamy bokeh, cinematic three-point lighting, subtle film grain, 35mm lens cinematic framing, true-to-life color grading, detailed real-world environments, consistent actor appearance across shots, avoid cartoon or anime features, avoid 3D render look, avoid illustration style, avoid plastic waxy skin, avoid over-smoothing beauty filter',
+}
+
+// INSERT ... SELECT WHERE NOT EXISTS → 幂等：只补缺失行，不覆盖用户编辑
+// （SQLite 无 FROM DUAL，无 FROM 的 SELECT 合法）
+const SEED_SQL = 'INSERT INTO style_presets ("name", "value", "prompt", "description", "sort_order", "is_active", "created_at", "updated_at") SELECT ?, ?, ?, ?, ?, 1, ?, ? WHERE NOT EXISTS (SELECT 1 FROM style_presets WHERE value = ?)'
+// 内容寻址升级：命中旧种子原文才更新（用户在设置页改过的行不动）
+const UPGRADE_SQL = 'UPDATE style_presets SET "name" = ?, "prompt" = ?, "description" = ?, "sort_order" = ?, "updated_at" = ? WHERE "value" = ? AND "prompt" = ?'
+// 内容寻址下架：命中下架种子原文才删除
+const REMOVE_SQL = 'DELETE FROM style_presets WHERE "value" = ? AND "prompt" = ?'
+
+export function initSqliteSchema(sqlite: Database.Database) {
+  for (const statement of sqliteSchemaStatements) {
+    sqlite.exec(statement)
+  }
+  // 兼容已安装的桌面版；仅增加任务恢复元数据，不改写历史生成结果。
+  const taskColumns = new Set((sqlite.prepare('PRAGMA table_info(sys_task)').all() as { name: string }[]).map(c => c.name))
+  for (const [name, type] of Object.entries({ config_id: 'INTEGER', config_base_url: 'TEXT', stage: 'TEXT', error_code: 'TEXT' })) {
+    if (!taskColumns.has(name)) sqlite.exec(`ALTER TABLE sys_task ADD COLUMN ${name} ${type}`)
+  }
+  // 角色音色由用户上传；旧库补充可空字段，不修改已有角色和图片。
+  const characterColumns = new Set((sqlite.prepare('PRAGMA table_info(characters)').all() as { name: string }[]).map(c => c.name))
+  for (const name of ['voice_audio_url', 'voice_audio_name']) {
+    if (!characterColumns.has(name)) sqlite.exec(`ALTER TABLE characters ADD COLUMN ${name} TEXT`)
+  }
+  const insertSeed = sqlite.prepare(SEED_SQL)
+  // Reference inputs are independent of generated outputs; preserve all existing rows.
+  const sceneColumns = new Set((sqlite.prepare('PRAGMA table_info(scenes)').all() as { name: string }[]).map(c => c.name))
+  if (!sceneColumns.has('reference_images')) sqlite.exec('ALTER TABLE scenes ADD COLUMN reference_images TEXT')
+  const upgradeSeed = sqlite.prepare(UPGRADE_SQL)
+  const removeSeed = sqlite.prepare(REMOVE_SQL)
+  for (const s of stylePresetSeeds) {
+    const ts = new Date().toISOString()
+    insertSeed.run(s.name, s.value, s.prompt, s.description, s.sortOrder, ts, ts, s.value)
+    const legacyPrompt = LEGACY_SEED_PROMPTS[s.value]
+    if (legacyPrompt) {
+      const res = upgradeSeed.run(s.name, s.prompt, s.description, s.sortOrder, ts, s.value, legacyPrompt)
+      if (res.changes > 0) console.log(`🎨 风格预设「${s.name}」已升级为结构化提示词`)
+    }
+  }
+  for (const [value, prompt] of Object.entries(REMOVED_SEED_PROMPTS)) {
+    const res = removeSeed.run(value, prompt)
+    if (res.changes > 0) console.log(`🗑️ 风格预设「${value}」已下架`)
+  }
+}
diff --git a/huobao-source/backend/src/index.ts b/huobao-source/backend/src/index.ts
new file mode 100644
index 0000000..2c40539
--- /dev/null
+++ b/huobao-source/backend/src/index.ts
@@ -0,0 +1,93 @@
+import 'dotenv/config'
+import { serve } from '@hono/node-server'
+import { serveStatic } from '@hono/node-server/serve-static'
+import { Hono } from 'hono'
+import { cors } from 'hono/cors'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+import dramas from './routes/dramas.js'
+import episodes from './routes/episodes.js'
+import storyboards from './routes/storyboards.js'
+import scenes from './routes/scenes.js'
+import characters from './routes/characters.js'
+import tasks from './routes/tasks.js'
+import hd from './routes/hd.js'
+import upload from './routes/upload.js'
+import aiConfigs, { aiProviders } from './routes/aiConfigs.js'
+import stylePresets from './routes/stylePresets.js'
+import prompts from './routes/prompts.js'
+import agent from './routes/agent.js'
+import merge from './routes/merge.js'
+import skills from './routes/skills.js'
+import props from './routes/props.js'
+import settings from './routes/settings.js'
+import storage from './routes/storage.js'
+import serverUpdate from './routes/serverUpdate.js'
+import { requestLogger, errorHandler } from './middleware/logger.js'
+import { resumeInterruptedTasks } from './services/generation.js'
+import { DATA_ROOT } from './utils/paths.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const projectRoot = path.resolve(__dirname, '../..')
+
+const app = new Hono()
+
+// Middleware
+app.use('*', cors({
+  origin: ['http://localhost:3013', 'http://localhost:5679'],
+  credentials: true,
+}))
+app.use('*', requestLogger)
+app.use('*', errorHandler)
+
+// Health check（version 供部署巡检/更新检查核对当前运行版本）
+app.get('/api/v1/health', (c) => c.json({
+  status: 'ok',
+  version: process.env.HUOBAO_VERSION || undefined,
+  timestamp: new Date().toISOString(),
+}))
+
+// API routes
+const api = new Hono()
+api.route('/dramas', dramas)
+api.route('/episodes', episodes)
+api.route('/storyboards', storyboards)
+api.route('/scenes', scenes)
+api.route('/characters', characters)
+api.route('/tasks', tasks)
+api.route('/hd', hd)
+api.route('/upload', upload)
+api.route('/ai-configs', aiConfigs)
+api.route('/ai-providers', aiProviders)
+api.route('/style-presets', stylePresets)
+api.route('/prompts', prompts)
+api.route('/agent', agent)
+api.route('/merge', merge)
+api.route('/skills', skills)
+api.route('/props', props)
+api.route('/storage', storage)
+api.route('/settings', settings)
+api.route('/server-update', serverUpdate)
+
+app.route('/api/v1', api)
+
+// Serve static files (storage)
+// 生成的图片/视频按 uuid 命名、内容不变，标记为 immutable 让浏览器长缓存
+app.use('/static/*', async (c, next) => {
+  await next()
+  if (c.res.ok) c.header('Cache-Control', 'public, max-age=31536000, immutable')
+})
+app.use('/static/*', serveStatic({ root: DATA_ROOT }))
+
+// Serve frontend (production build) — 桌面版由主进程注入 FRONTEND_DIST（resources/frontend）
+const distPath = process.env.FRONTEND_DIST || path.join(projectRoot, 'frontend', 'dist')
+app.use('*', serveStatic({ root: distPath }))
+app.get('*', serveStatic({ root: distPath, path: 'index.html' }))
+
+const port = Number(process.env.PORT || 5679)
+console.log(`🚀 Huobao Drama TS server on http://localhost:${port}`)
+
+await resumeInterruptedTasks()
+
+serve({ fetch: app.fetch, port })
diff --git a/huobao-source/backend/src/mastra/index.ts b/huobao-source/backend/src/mastra/index.ts
new file mode 100644
index 0000000..23d2d87
--- /dev/null
+++ b/huobao-source/backend/src/mastra/index.ts
@@ -0,0 +1,11 @@
+/**
+ * Mastra 中央实例 — Agent 注册表挂载点
+ * 不用 Mastra logger（项目已有 pino + task-logger）
+ */
+import { Mastra } from '@mastra/core/mastra'
+import { agentRegistry } from '../agents/index.js'
+
+export const mastra = new Mastra({
+  agents: agentRegistry,
+  logger: false,
+})
diff --git a/huobao-source/backend/src/middleware/logger.ts b/huobao-source/backend/src/middleware/logger.ts
new file mode 100644
index 0000000..412b644
--- /dev/null
+++ b/huobao-source/backend/src/middleware/logger.ts
@@ -0,0 +1,70 @@
+import type { MiddlewareHandler } from 'hono'
+
+const colors = {
+  reset: '\x1b[0m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+}
+
+function statusColor(status: number): string {
+  if (status >= 500) return colors.red
+  if (status >= 400) return colors.yellow
+  if (status >= 300) return colors.cyan
+  return colors.green
+}
+
+function formatTime(): string {
+  return new Date().toLocaleTimeString('zh-CN', { hour12: false })
+}
+
+/**
+ * 全局日志中间件 — 打印请求方法/路径/状态/耗时/请求体
+ */
+export const requestLogger: MiddlewareHandler = async (c, next) => {
+  const method = c.req.method
+  const path = c.req.path
+  const start = performance.now()
+
+  // 打印请求
+  const time = formatTime()
+  let bodyInfo = ''
+  // 上传文件不克隆/读取请求体：避免记录音频内容，也让路由的大小限制先执行。
+  const isFileUpload = c.req.header('content-type')?.toLowerCase().startsWith('multipart/form-data')
+  if (!isFileUpload && ['POST', 'PUT', 'PATCH'].includes(method)) {
+    try {
+      const clone = c.req.raw.clone()
+      const text = await clone.text()
+      if (text) {
+        const truncated = text.length > 500 ? text.slice(0, 500) + '...' : text
+        bodyInfo = `\n  ${colors.dim}body: ${truncated}${colors.reset}`
+      }
+    } catch {}
+  }
+
+  console.log(`${colors.dim}${time}${colors.reset} ${colors.cyan}${method}${colors.reset} ${path}${bodyInfo}`)
+
+  await next()
+
+  const ms = (performance.now() - start).toFixed(0)
+  const status = c.res.status
+  const sc = statusColor(status)
+  console.log(`${colors.dim}${time}${colors.reset} ${colors.cyan}${method}${colors.reset} ${path} ${sc}${status}${colors.reset} ${colors.dim}${ms}ms${colors.reset}`)
+}
+
+/**
+ * 全局错误处理 — 捕获未处理异常，打印完整堆栈
+ */
+export const errorHandler: MiddlewareHandler = async (c, next) => {
+  try {
+    await next()
+  } catch (err: any) {
+    const status = err.status || 500
+    console.error(`${colors.red}[ERROR]${colors.reset} ${c.req.method} ${c.req.path}`)
+    console.error(err.stack || err.message || err)
+    return c.json({ code: status, message: err.message || 'Internal Server Error' }, status)
+  }
+}
diff --git a/huobao-source/backend/src/routes/agent.ts b/huobao-source/backend/src/routes/agent.ts
new file mode 100644
index 0000000..e7b301d
--- /dev/null
+++ b/huobao-source/backend/src/routes/agent.ts
@@ -0,0 +1,117 @@
+/**
+ * Agent 聊天路由 — 非流式版本
+ */
+import { Hono } from 'hono'
+import { validAgentTypes } from '../agents/index.js'
+import { buildAgentRequestContext } from '../agents/context.js'
+import { mastra } from '../mastra/index.js'
+import { success, badRequest } from '../utils/response.js'
+import { logTaskError, logTaskPayload, logTaskProgress, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+const app = new Hono()
+
+// Mastra v1.17 的 ToolCallChunk / ToolResultChunk 结构：
+// { type: 'tool-call', payload: { toolCallId, toolName, args } }
+// { type: 'tool-result', payload: { toolCallId, toolName, result, isError } }
+function normalizeToolName(entry: any) {
+  return entry?.payload?.toolName
+    || entry?.toolName
+    || entry?.tool?.toolName
+    || entry?.tool?.id
+    || entry?.name
+    || entry?.type
+    || null
+}
+
+function normalizeToolResult(entry: any) {
+  const result = entry?.payload?.result ?? entry?.result ?? entry?.payload?.output ?? entry?.output ?? entry?.data ?? null
+  return typeof result === 'string' ? result : JSON.stringify(result)
+}
+
+// POST /agent/:type/chat — 非流式 Agent 对话
+app.post('/:type/chat', async (c) => {
+  const agentType = c.req.param('type')
+  if (!validAgentTypes.includes(agentType)) {
+    return badRequest(c, `无效的 Agent 类型：${agentType}`)
+  }
+
+  const body = await c.req.json()
+  const { message, drama_id, episode_id } = body
+
+  logTaskStart('Agent', agentType, {
+    dramaId: drama_id,
+    episodeId: episode_id,
+    message,
+  })
+  logTaskPayload('Agent', `${agentType} input`, body)
+
+  if (!episode_id || !drama_id) {
+    logTaskError('Agent', agentType, { reason: 'missing drama_id or episode_id' })
+    return badRequest(c, '需要 drama_id 与 episode_id')
+  }
+
+  const agent = mastra.getAgent(agentType)
+  if (!agent) {
+    logTaskError('Agent', agentType, { reason: 'agent not found' })
+    return badRequest(c, 'Agent 不存在')
+  }
+
+  const requestContext = buildAgentRequestContext({
+    episodeId: episode_id,
+    dramaId: drama_id,
+    modelOverride: body.model || undefined,
+    textConfigId: body.config_id || undefined,
+  })
+
+  const startTime = performance.now()
+
+  try {
+    const result = await agent.generate(
+      [{ role: 'user', content: message }],
+      { maxSteps: 20, requestContext },
+    )
+
+    const elapsed = ((performance.now() - startTime) / 1000).toFixed(1)
+    logTaskSuccess('Agent', agentType, { elapsedSeconds: elapsed })
+
+    // 收集所有 tool calls 和 results
+    const toolCalls = result.toolCalls || []
+    const toolResults = result.toolResults || []
+    const normalizedToolCalls = toolCalls.map((tc: any) => ({
+      toolName: normalizeToolName(tc),
+      args: tc?.payload?.args ?? tc?.args ?? tc?.input ?? null,
+    }))
+    const normalizedToolResults = toolResults.map((tr: any) => ({
+      toolName: normalizeToolName(tr),
+      result: normalizeToolResult(tr),
+    }))
+
+    logTaskProgress('Agent', 'tool-summary', {
+      agentType,
+      toolCalls: normalizedToolCalls.map((tc: any) => tc.toolName),
+      toolResults: normalizedToolResults.map((tr: any) => tr.toolName),
+    })
+    logTaskPayload('Agent', `${agentType} tool-results`, normalizedToolResults)
+
+    return success(c, {
+      type: 'done',
+      text: result.text || '',
+      toolCalls: normalizedToolCalls,
+      toolResults: normalizedToolResults,
+    })
+  } catch (err: any) {
+    const elapsed = ((performance.now() - startTime) / 1000).toFixed(1)
+    logTaskError('Agent', agentType, { elapsedSeconds: elapsed, error: err.message })
+    console.error(err.stack || err)
+    return badRequest(c, err.message || 'Agent 执行失败')
+  }
+})
+
+// GET /agent/:type/debug
+app.get('/:type/debug', async (c) => {
+  const agentType = c.req.param('type')
+  if (!validAgentTypes.includes(agentType)) return badRequest(c, '无效的 Agent 类型')
+  return success(c, { agent_type: agentType, valid: true })
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/aiConfigs.ts b/huobao-source/backend/src/routes/aiConfigs.ts
new file mode 100644
index 0000000..b3e8c2e
--- /dev/null
+++ b/huobao-source/backend/src/routes/aiConfigs.ts
@@ -0,0 +1,321 @@
+import { Hono } from 'hono'
+import { eq } from 'drizzle-orm'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, notFound, created, badRequest, now } from '../utils/response.js'
+import { toSnakeCase } from '../utils/transform.js'
+import { joinProviderUrl } from '../services/adapters/url.js'
+import { isOfficialProvider, parseConfigTemperature, parseConfigGpu } from '../services/ai.js'
+import { redactUrl, logTaskError, logTaskProgress, logTaskSuccess } from '../utils/task-logger.js'
+
+const app = new Hono()
+
+/** 归一化 temperature 入参：null=未设置；合法值 0~2；非法抛错 */
+function normalizeTemperature(v: any): number | null {
+  if (v === null || v === undefined || v === '') return null
+  const n = Number(v)
+  if (!Number.isFinite(n) || n < 0 || n > 2) throw new Error('invalid temperature')
+  return n
+}
+
+/** 把 settings JSON 中的 temperature 透出为顶层字段，便于前端直接读写 */
+function withParsedFields(r: any) {
+  return {
+    ...toSnakeCase(r),
+    model: r.model ? JSON.parse(r.model) : [],
+    temperature: parseConfigTemperature(r.settings),
+    gpu: parseConfigGpu(r.settings),
+  }
+}
+
+function bearerHeaders(apiKey?: string, withJson = false) {
+  const headers: Record<string, string> = {}
+  if (apiKey) headers.Authorization = `Bearer ${apiKey}`
+  if (withJson) headers['Content-Type'] = 'application/json'
+  return headers
+}
+
+function geminiHeaders(apiKey?: string, withJson = false) {
+  const headers: Record<string, string> = {}
+  if (apiKey) {
+    headers['x-goog-api-key'] = apiKey
+  }
+  if (withJson) headers['Content-Type'] = 'application/json'
+  return headers
+}
+
+function buildProbe(serviceType: string, provider: string, baseUrl: string, model?: string, apiKey?: string) {
+  const p = provider.toLowerCase()
+  const m = model || ''
+
+  if (p === 'gemini') {
+    // 探针统一走 generateContent:文本运行时(AI SDK)走的就是它,官方与中转站都支持;
+    // interactions 端点很多中转站未配置,探它会误报 500。
+    // 用最小合法请求体而非空体——空体在部分中转站会触发上游认证失败的误报
+    const modelName = m || 'gemini-3.1-pro-preview'
+    const url = new URL(joinProviderUrl(baseUrl, '/v1beta', `/models/${modelName}:generateContent`))
+    if (apiKey) url.searchParams.set('key', apiKey)
+    return {
+      method: 'POST',
+      url: url.toString(),
+      headers: geminiHeaders(apiKey, true),
+      body: { contents: [{ parts: [{ text: 'hi' }] }] },
+    }
+  }
+
+  if (p === 'openai' || p === 'localvideo') {
+    return {
+      method: 'GET',
+      url: joinProviderUrl(baseUrl, '/v1', '/models'),
+      headers: bearerHeaders(apiKey),
+      body: undefined,
+    }
+  }
+
+  if (p === 'volcengine') {
+    const path = serviceType === 'video'
+      ? '/contents/generations/tasks'
+      : serviceType === 'text'
+        ? '/chat/completions'
+        : '/images/generations'
+    return {
+      method: 'POST',
+      url: joinProviderUrl(baseUrl, '/api/v3', path),
+      headers: bearerHeaders(apiKey, true),
+      body: {},
+    }
+  }
+
+  if (p === 'minimax') {
+    // MiniMax 仅提供视频服务，空请求体探测鉴权/端点连通性
+    return {
+      method: 'POST',
+      url: joinProviderUrl(baseUrl, '/v2', '/video_generation'),
+      headers: bearerHeaders(apiKey, true),
+      body: {},
+    }
+  }
+
+  if (p === 'aliyun') {
+    // Wan 3.0 仅支持异步提交；空请求体不会创建计费任务，仅用于验证地域端点与鉴权是否可达。
+    return {
+      method: 'POST',
+      url: joinProviderUrl(baseUrl, '/api/v1', '/services/aigc/video-generation/video-synthesis'),
+      headers: {
+        ...bearerHeaders(apiKey, true),
+        'X-DashScope-Async': 'enable',
+      },
+      body: {},
+    }
+  }
+
+  return {
+    method: 'GET',
+    url: joinProviderUrl(baseUrl, '', m ? `/${m}` : '/'),
+    headers: bearerHeaders(apiKey),
+    body: undefined,
+  }
+}
+
+// GET /ai-configs?service_type=text
+app.get('/', async (c) => {
+  const serviceType = c.req.query('service_type')
+  let rows = await db.select().from(schema.aiServiceConfigs)
+  if (serviceType) rows = rows.filter(r => r.serviceType === serviceType)
+
+  const parsed = rows.map(withParsedFields)
+  return success(c, parsed)
+})
+
+// POST /ai-configs
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  const ts = now()
+  if ('gpu' in body && !['auto', 'gpu1', 'gpu2', 'gpu3'].includes(body.gpu)) return badRequest(c, '显卡须为 auto、gpu1、gpu2 或 gpu3')
+
+  // 验证必填字段
+  if (!body.service_type || !body.provider) {
+    return badRequest(c, '需要 service_type 与 provider')
+  }
+  if (!isOfficialProvider(body.service_type, body.provider)) {
+    return badRequest(c, '不支持的 service_type/provider')
+  }
+
+  let temperature: number | null = null
+  if ('temperature' in body) {
+    try {
+      temperature = normalizeTemperature(body.temperature)
+    } catch {
+      return badRequest(c, 'temperature 须为 0 到 2 之间的数字')
+    }
+  }
+
+  const res = await db.insert(schema.aiServiceConfigs).values({
+    serviceType: body.service_type,
+    provider: body.provider,
+    name: body.name || `${body.provider}-${body.service_type}`,
+    baseUrl: body.base_url || '',
+    apiKey: body.api_key || '',
+    model: JSON.stringify(body.model || []),
+    priority: body.priority || 0,
+    isActive: true,
+    settings: temperature !== null || body.gpu && body.gpu !== 'auto'
+      ? JSON.stringify({ ...(temperature !== null ? { temperature } : {}), ...(body.gpu && body.gpu !== 'auto' ? { gpu: body.gpu } : {}) }) : null,
+    createdAt: ts,
+    updatedAt: ts,
+  })
+
+  const [row] = await db.select().from(schema.aiServiceConfigs)
+    .where(eq(schema.aiServiceConfigs.id, getInsertId(res)))
+
+  return created(c, withParsedFields(row))
+})
+
+// POST /ai-configs/test
+app.post('/test', async (c) => {
+  const body = await c.req.json()
+  if (!body.service_type || !body.provider || !body.base_url) {
+    return badRequest(c, '需要 service_type、provider 与 base_url')
+  }
+  if (!isOfficialProvider(body.service_type, body.provider)) {
+    return badRequest(c, '不支持的 service_type/provider')
+  }
+
+  const model = Array.isArray(body.model) ? body.model[0] : body.model
+  const probe = buildProbe(body.service_type, body.provider, body.base_url, model, body.api_key)
+  const probeUrl = redactUrl(probe.url)
+
+  logTaskProgress('AIConfig', 'probe-start', {
+    serviceType: body.service_type,
+    provider: body.provider,
+    method: probe.method,
+    url: probeUrl,
+  })
+
+  try {
+    const resp = await fetch(probe.url, {
+      method: probe.method,
+      headers: probe.headers,
+      body: probe.body ? JSON.stringify(probe.body) : undefined,
+    })
+    const text = await resp.text()
+    const reachable = [200, 204, 400, 401, 403].includes(resp.status)
+    const payload = {
+      ok: resp.ok,
+      reachable,
+      status: resp.status,
+      status_text: resp.statusText,
+      method: probe.method,
+      url: probeUrl,
+      message: reachable
+        ? (resp.ok ? '端点可访问，认证与路径基本正常' : '端点已响应，请根据状态码判断认证或路径是否正确')
+        : '端点未按预期响应，请检查 Base URL 和代理前缀',
+      response_preview: text.slice(0, 240),
+    }
+    if (reachable) {
+      logTaskSuccess('AIConfig', 'probe-done', {
+        provider: body.provider,
+        status: resp.status,
+        url: probeUrl,
+      })
+    } else {
+      logTaskError('AIConfig', 'probe-unexpected', {
+        provider: body.provider,
+        status: resp.status,
+        url: probeUrl,
+      })
+    }
+    return success(c, payload)
+  } catch (error: any) {
+    logTaskError('AIConfig', 'probe-failed', {
+      provider: body.provider,
+      url: probeUrl,
+      error: error.message,
+    })
+    return success(c, {
+      ok: false,
+      reachable: false,
+      method: probe.method,
+      url: probeUrl,
+      message: error.message || '请求失败',
+      response_preview: '',
+    })
+  }
+})
+
+// GET /ai-configs/:id
+app.get('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const [row] = await db.select().from(schema.aiServiceConfigs).where(eq(schema.aiServiceConfigs.id, id))
+  if (!row) return notFound(c)
+  return success(c, withParsedFields(row))
+})
+
+// PUT /ai-configs/:id
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [existing] = await db.select().from(schema.aiServiceConfigs).where(eq(schema.aiServiceConfigs.id, id))
+  if (!existing) return notFound(c)
+
+  const serviceType = 'service_type' in body ? body.service_type : existing.serviceType
+  const provider = 'provider' in body ? body.provider : existing.provider
+  if (!isOfficialProvider(serviceType, provider)) {
+    return badRequest(c, '不支持的 service_type/provider')
+  }
+
+  const updates: Record<string, any> = { updatedAt: now() }
+  if ('gpu' in body && !['auto', 'gpu1', 'gpu2', 'gpu3'].includes(body.gpu)) return badRequest(c, '显卡须为 auto、gpu1、gpu2 或 gpu3')
+
+  if ('service_type' in body) updates.serviceType = body.service_type
+  if ('provider' in body) updates.provider = body.provider
+  if ('name' in body) updates.name = body.name
+  if ('base_url' in body) updates.baseUrl = body.base_url
+  if ('api_key' in body) updates.apiKey = body.api_key
+  if ('model' in body) updates.model = JSON.stringify(body.model)
+  if ('priority' in body) updates.priority = body.priority
+  if ('is_active' in body) updates.isActive = body.is_active
+  if ('temperature' in body) {
+    let temperature: number | null
+    try {
+      temperature = normalizeTemperature(body.temperature)
+    } catch {
+      return badRequest(c, 'temperature 须为 0 到 2 之间的数字')
+    }
+    // 与已有 settings 合并，清空的 temperature 从 JSON 中移除
+    let settings: Record<string, any> = {}
+    try { settings = existing.settings ? JSON.parse(existing.settings) : {} } catch { settings = {} }
+    if (temperature === null) delete settings.temperature
+    else settings.temperature = temperature
+    updates.settings = Object.keys(settings).length ? JSON.stringify(settings) : null
+  }
+  if ('gpu' in body) {
+    let settings: Record<string, any> = {}
+    try { settings = JSON.parse(('settings' in updates ? updates.settings : existing.settings) || '{}') } catch { settings = {} }
+    if (body.gpu === 'auto') delete settings.gpu
+    else settings.gpu = body.gpu
+    updates.settings = Object.keys(settings).length ? JSON.stringify(settings) : null
+  }
+
+  await db.update(schema.aiServiceConfigs).set(updates).where(eq(schema.aiServiceConfigs.id, id))
+  return success(c)
+})
+
+// DELETE /ai-configs/:id
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  await db.delete(schema.aiServiceConfigs).where(eq(schema.aiServiceConfigs.id, id))
+  return success(c)
+})
+
+// GET /ai-providers
+export const aiProviders = new Hono()
+aiProviders.get('/', async (c) => {
+  const rows = await db.select().from(schema.aiServiceProviders)
+  const parsed = rows.map(r => ({
+    ...toSnakeCase(r),
+    preset_models: r.presetModels ? JSON.parse(r.presetModels) : [],
+  }))
+  return success(c, parsed)
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/asset-references.ts b/huobao-source/backend/src/routes/asset-references.ts
new file mode 100644
index 0000000..5a178b3
--- /dev/null
+++ b/huobao-source/backend/src/routes/asset-references.ts
@@ -0,0 +1,90 @@
+import type { Hono } from 'hono'
+import { bodyLimit } from 'hono/body-limit'
+import { and, eq, isNull } from 'drizzle-orm'
+import fs from 'node:fs/promises'
+import sharp from 'sharp'
+import { db, schema } from '../db/index.js'
+import { badRequest, notFound, now, success } from '../utils/response.js'
+import { generateImageThumb, getAbsolutePath, saveUploadedFile, thumbPathFor } from '../utils/storage.js'
+
+const MAX_REFERENCES = 6
+const MAX_BYTES = 20 * 1024 * 1024
+type AssetTable = typeof schema.characters | typeof schema.scenes | typeof schema.props
+
+export function assetReferenceImages(raw: string | null | undefined): string[] {
+  if (!raw) return []
+  const refs: unknown = JSON.parse(raw)
+  if (!Array.isArray(refs) || refs.some(ref => typeof ref !== 'string' || !ref.trim())) {
+    throw new Error('参考图记录异常，请重新设置参考图')
+  }
+  if (refs.length > MAX_REFERENCES) throw new Error('参考图最多 6 张')
+  return [...new Set(refs)]
+}
+
+/** Append/remove only this asset's reference inputs; output images remain untouched. */
+export function registerAssetReferenceRoutes(app: Hono, table: AssetTable): void {
+  app.post('/:id/reference-images', bodyLimit({ maxSize: MAX_BYTES + 64 * 1024,
+    onError: c => badRequest(c, '参考图不能超过 20MB'),
+  }), async c => {
+    const id = Number(c.req.param('id'))
+    if (!Number.isSafeInteger(id) || id <= 0) return badRequest(c, '资产编号无效')
+    const condition = and(eq(table.id, id), isNull(table.deletedAt))
+    const asset = db.select({ referenceImages: table.referenceImages }).from(table).where(condition).get()
+    if (!asset) return notFound(c, '资产不存在')
+    let uploadedPath: string | undefined
+    try {
+      if (assetReferenceImages(asset.referenceImages).length >= MAX_REFERENCES) return badRequest(c, '参考图最多 6 张')
+      const body = await c.req.parseBody()
+      const file = body.file
+      if (!(file instanceof File) || !file.size) return badRequest(c, '请选择参考图片')
+      if (file.size > MAX_BYTES) return badRequest(c, '参考图不能超过 20MB')
+      const bytes = await file.arrayBuffer()
+      const image = sharp(Buffer.from(bytes), { limitInputPixels: 40_000_000, failOn: 'error' })
+      let extension: string
+      try {
+        const info = await image.metadata()
+        extension = ({ jpeg: 'jpg', png: 'png', webp: 'webp' } as Record<string, string>)[info.format || '']
+        if (!extension || (info.pages || 1) > 1) return badRequest(c, '参考图仅支持静态 JPG、PNG、WebP')
+        await image.stats() // Decode before accepting a damaged or mislabeled file.
+      } catch { return badRequest(c, '参考图片无法读取，请使用 JPG、PNG 或 WebP') }
+      uploadedPath = await saveUploadedFile(bytes, 'references', `reference.${extension}`)
+      await generateImageThumb(uploadedPath)
+      const refs = db.transaction(tx => {
+        const current = tx.select({ referenceImages: table.referenceImages }).from(table).where(condition).get()
+        if (!current) throw new Error('资产不存在')
+        const list = assetReferenceImages(current.referenceImages)
+        if (list.length >= MAX_REFERENCES) throw new Error('参考图最多 6 张')
+        list.push(uploadedPath!)
+        tx.update(table).set({ referenceImages: JSON.stringify(list), updatedAt: now() }).where(condition).run()
+        return list
+      })
+      return success(c, { reference_images: refs })
+    } catch (error) {
+      if (uploadedPath) {
+        await fs.unlink(getAbsolutePath(uploadedPath)).catch(() => {})
+        await fs.unlink(getAbsolutePath(thumbPathFor(uploadedPath))).catch(() => {})
+      }
+      return badRequest(c, (error as Error).message)
+    }
+  })
+
+  app.delete('/:id/reference-images', async c => {
+    const id = Number(c.req.param('id'))
+    if (!Number.isSafeInteger(id) || id <= 0) return badRequest(c, '资产编号无效')
+    const body = await c.req.json()
+    if (typeof body.path !== 'string') return badRequest(c, '请选择需要移除的参考图')
+    const condition = and(eq(table.id, id), isNull(table.deletedAt))
+    try {
+      const refs = db.transaction(tx => {
+        const asset = tx.select({ referenceImages: table.referenceImages }).from(table).where(condition).get()
+        if (!asset) return null
+        const list = assetReferenceImages(asset.referenceImages).filter(ref => ref !== body.path)
+        tx.update(table).set({ referenceImages: JSON.stringify(list), updatedAt: now() }).where(condition).run()
+        return list
+      })
+      if (refs === null) return notFound(c, '资产不存在')
+      // Submitted task snapshots and other assets may still need these files.
+      return success(c, { reference_images: refs })
+    } catch (error) { return badRequest(c, (error as Error).message) }
+  })
+}
diff --git a/huobao-source/backend/src/routes/characters.ts b/huobao-source/backend/src/routes/characters.ts
new file mode 100644
index 0000000..ea850c9
--- /dev/null
+++ b/huobao-source/backend/src/routes/characters.ts
@@ -0,0 +1,197 @@
+import { Hono } from 'hono'
+import { bodyLimit } from 'hono/body-limit'
+import { and, eq, isNull } from 'drizzle-orm'
+import fs from 'node:fs/promises'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, created, badRequest, notFound, now } from '../utils/response.js'
+import { AUDIO_MAX_BYTES, AudioUploadError, saveAudioUpload } from '../utils/audio-upload.js'
+import { getAbsolutePath } from '../utils/storage.js'
+import { toSnakeCase } from '../utils/transform.js'
+import { generateImage } from '../services/generation.js'
+import { getDramaStylePrompt } from '../services/style-preset.js'
+import { ensureCharacterFinalPrompt } from '../services/final-prompt.js'
+import { logTaskError, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+import { assetReferenceImages, registerAssetReferenceRoutes } from './asset-references.js'
+
+const app = new Hono()
+registerAssetReferenceRoutes(app, schema.characters)
+const CHARACTER_IMAGE_SIZE = '1920x1080'
+
+// 用户上传的角色音色样本独立于生图和 AI 提取，跨剧集复用同一个角色绑定。
+app.post('/:id/voice', bodyLimit({ maxSize: AUDIO_MAX_BYTES + 64 * 1024,
+  onError: c => badRequest(c, '音频文件大小不能超过 20MB'),
+}), async c => {
+  const id = Number(c.req.param('id'))
+  if (!Number.isSafeInteger(id) || id <= 0) return badRequest(c, '角色编号无效')
+  const condition = and(eq(schema.characters.id, id), isNull(schema.characters.deletedAt))
+  const char = db.select({ id: schema.characters.id }).from(schema.characters).where(condition).get()
+  if (!char) return notFound(c, '角色不存在')
+  let uploadedPath: string | undefined
+  try {
+    const body = await c.req.parseBody()
+    const audio = await saveAudioUpload(body.file)
+    uploadedPath = audio.path
+    const updated = db.update(schema.characters)
+      .set({ voiceAudioUrl: audio.path, voiceAudioName: audio.name, updatedAt: now() })
+      .where(condition).returning({ id: schema.characters.id }).get()
+    if (!updated) {
+      await fs.unlink(getAbsolutePath(audio.path))
+      return notFound(c, '角色不存在')
+    }
+    return success(c, { voice_audio_url: audio.path, voice_audio_name: audio.name })
+  } catch (error) {
+    if (uploadedPath) await fs.unlink(getAbsolutePath(uploadedPath)).catch(() => {})
+    if (error instanceof AudioUploadError) return badRequest(c, error.message)
+    throw error
+  }
+})
+
+// 只移除角色绑定，不删除可能仍被引用的媒体文件。
+app.delete('/:id/voice', async c => {
+  const id = Number(c.req.param('id'))
+  if (!Number.isSafeInteger(id) || id <= 0) return badRequest(c, '角色编号无效')
+  const updated = db.update(schema.characters)
+    .set({ voiceAudioUrl: null, voiceAudioName: null, updatedAt: now() })
+    .where(and(eq(schema.characters.id, id), isNull(schema.characters.deletedAt)))
+    .returning({ id: schema.characters.id }).get()
+  if (!updated) return notFound(c, '角色不存在')
+  return success(c, { voice_audio_url: null, voice_audio_name: null })
+})
+
+// POST /characters — 手动新增角色（传入 episode_id 时关联到该集）
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  if (!body.drama_id) return badRequest(c, 'drama_id 必填')
+  if (!body.name?.trim()) return badRequest(c, '名称必填')
+  const ts = now()
+  const res = await db.insert(schema.characters).values({
+    name: body.name.trim(),
+    role: body.role || '',
+    description: body.description || '',
+    appearance: body.appearance || '',
+    styling: body.styling || '',
+    dramaId: body.drama_id,
+    createdAt: ts,
+    updatedAt: ts,
+  })
+  const charId = getInsertId(res)
+  if (body.episode_id) {
+    const existing = await db.select().from(schema.episodeCharacters)
+      .where(and(eq(schema.episodeCharacters.episodeId, Number(body.episode_id)), eq(schema.episodeCharacters.characterId, charId)))
+    if (!existing.length) {
+      await db.insert(schema.episodeCharacters).values({ episodeId: Number(body.episode_id), characterId: charId, createdAt: ts })
+    }
+  }
+  const [row] = await db.select().from(schema.characters).where(eq(schema.characters.id, charId))
+  return created(c, toSnakeCase(row))
+})
+
+function characterImagePrompt(char: typeof schema.characters.$inferSelect, stylePrompt = '') {
+  return [
+    stylePrompt || '',
+    char.name,
+    char.appearance || char.description || '人物立绘',
+    char.styling || '',
+    '16:9 横版角色定妆照',
+    '半身角色海报构图',
+    '正面',
+    '高质量',
+    '白色背景',
+  ].filter(Boolean).join(', ')
+}
+
+// PUT /characters/:id
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const updates: Record<string, any> = { updatedAt: now() }
+  for (const key of ['name', 'role', 'description', 'appearance', 'styling', 'imageUrl', 'localPath']) {
+    const snakeKey = key.replace(/[A-Z]/g, m => '_' + m.toLowerCase())
+    if (snakeKey in body) updates[key] = body[snakeKey]
+    else if (key in body) updates[key] = body[key]
+  }
+  // 手动编辑最终提示词时以传入值为准；未传入则保留原值（修改信息时不再自动置空）
+  if (body.final_prompt !== undefined) updates.finalPrompt = body.final_prompt || null
+  else if (body.finalPrompt !== undefined) updates.finalPrompt = body.finalPrompt || null
+  await db.update(schema.characters).set(updates).where(eq(schema.characters.id, id))
+  return success(c)
+})
+
+// DELETE /characters/:id
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  await db.update(schema.characters).set({ deletedAt: now() }).where(eq(schema.characters.id, id))
+  return success(c)
+})
+
+// POST /characters/:id/generate-image
+app.post('/:id/generate-image', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [char] = await db.select().from(schema.characters).where(eq(schema.characters.id, id))
+  if (!char) return badRequest(c, '角色不存在')
+  if (!body.episode_id) return badRequest(c, 'episode_id 必填')
+
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, Number(body.episode_id)))
+  if (!ep) return badRequest(c, '剧集不存在')
+
+  const stylePrompt = await getDramaStylePrompt(char.dramaId)
+  const finalPrompt = await ensureCharacterFinalPrompt(char, ep.id, false, { model: body.text_model, configId: body.text_config_id ?? undefined })
+  const prompt = finalPrompt || characterImagePrompt(char, stylePrompt)
+  try {
+    logTaskStart('CharacterImage', 'generate', { characterId: id, episodeId: ep.id, dramaId: char.dramaId })
+    const genId = await generateImage({ characterId: id, dramaId: char.dramaId, prompt, referenceImages: assetReferenceImages(char.referenceImages), model: body.model, size: CHARACTER_IMAGE_SIZE, configId: body.config_id ?? ep.imageConfigId ?? undefined })
+    logTaskSuccess('CharacterImage', 'generate', { characterId: id, generationId: genId })
+    return success(c, { image_generation_id: genId })
+  } catch (err: any) {
+    logTaskError('CharacterImage', 'generate', { characterId: id, error: err.message })
+    return badRequest(c, err.message)
+  }
+})
+
+// POST /characters/:id/generate-prompt — 独立生成/重新生成三视图最终提示词（不生图）
+app.post('/:id/generate-prompt', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [char] = await db.select().from(schema.characters).where(eq(schema.characters.id, id))
+  if (!char) return badRequest(c, '角色不存在')
+  if (!body.episode_id) return badRequest(c, 'episode_id 必填')
+
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, Number(body.episode_id)))
+  if (!ep) return badRequest(c, '剧集不存在')
+
+  logTaskStart('FinalPrompt', 'character-generate', { characterId: id, episodeId: ep.id, force: !!body.force })
+  const finalPrompt = await ensureCharacterFinalPrompt(char, ep.id, !!body.force, { model: body.text_model, configId: body.text_config_id ?? undefined })
+  if (!finalPrompt) {
+    logTaskError('FinalPrompt', 'character-generate', { characterId: id, error: 'agent returned empty prompt' })
+    return badRequest(c, '最终提示词生成失败，请重试')
+  }
+  logTaskSuccess('FinalPrompt', 'character-generate', { characterId: id })
+  return success(c, { final_prompt: finalPrompt })
+})
+
+// POST /characters/batch-generate-images
+app.post('/batch-generate-images', async (c) => {
+  const body = await c.req.json()
+  const ids: number[] = body.character_ids || []
+  if (!body.episode_id) return badRequest(c, 'episode_id 必填')
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, Number(body.episode_id)))
+  if (!ep) return badRequest(c, '剧集不存在')
+  const results: number[] = []
+  const stylePrompt = await getDramaStylePrompt(ep.dramaId)
+  for (const cid of ids) {
+    const [char] = await db.select().from(schema.characters).where(eq(schema.characters.id, cid))
+    if (!char) continue
+    const finalPrompt = await ensureCharacterFinalPrompt(char, ep.id, false, { model: body.text_model, configId: body.text_config_id ?? undefined })
+    const prompt = finalPrompt || characterImagePrompt(char, stylePrompt)
+    try {
+      const genId = await generateImage({ characterId: cid, dramaId: char.dramaId, prompt, referenceImages: assetReferenceImages(char.referenceImages), model: body.model, size: CHARACTER_IMAGE_SIZE, configId: body.config_id ?? ep.imageConfigId ?? undefined })
+      results.push(genId)
+    } catch {}
+  }
+  logTaskSuccess('CharacterImage', 'batch-generate', { episodeId: ep.id, requested: ids.length, started: results.length })
+  return success(c, { count: results.length, ids: results })
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/dramas.ts b/huobao-source/backend/src/routes/dramas.ts
new file mode 100644
index 0000000..cf44236
--- /dev/null
+++ b/huobao-source/backend/src/routes/dramas.ts
@@ -0,0 +1,178 @@
+import { Hono } from 'hono'
+import { and, eq, isNull, like, desc } from 'drizzle-orm'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, badRequest, notFound, created, now } from '../utils/response.js'
+import { toSnakeCase, toSnakeCaseArray } from '../utils/transform.js'
+
+const app = new Hono()
+
+// GET /dramas - List dramas
+app.get('/', async (c) => {
+  const page = Number(c.req.query('page') || 1)
+  const pageSize = Number(c.req.query('page_size') || 20)
+  const status = c.req.query('status')
+  const keyword = c.req.query('keyword')
+
+  const allRows = await db.select().from(schema.dramas)
+    .where(isNull(schema.dramas.deletedAt))
+    .orderBy(desc(schema.dramas.updatedAt))
+  let filtered = allRows
+
+  if (status) filtered = filtered.filter(d => d.status === status)
+  if (keyword) filtered = filtered.filter(d => d.title.includes(keyword))
+
+  const total = filtered.length
+  const items = filtered.slice((page - 1) * pageSize, page * pageSize)
+
+  // Attach episode/character/scene counts
+  const enriched = await Promise.all(items.map(async (drama) => {
+    const eps = await db.select().from(schema.episodes)
+      .where(and(eq(schema.episodes.dramaId, drama.id), isNull(schema.episodes.deletedAt)))
+    const chars = await db.select().from(schema.characters)
+      .where(eq(schema.characters.dramaId, drama.id))
+    const scns = await db.select().from(schema.scenes)
+      .where(eq(schema.scenes.dramaId, drama.id))
+    return {
+      ...toSnakeCase(drama),
+      tags: drama.tags ? JSON.parse(drama.tags) : [],
+      total_episodes: eps.length,
+      episodes: toSnakeCaseArray(eps),
+      characters: toSnakeCaseArray(chars),
+      scenes: toSnakeCaseArray(scns),
+    }
+  }))
+
+  return success(c, {
+    items: enriched,
+    pagination: { page, page_size: pageSize, total, total_pages: Math.ceil(total / pageSize) },
+  })
+})
+
+// POST /dramas - Create drama
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  const ts = now()
+  const res = await db.insert(schema.dramas).values({
+    title: body.title,
+    description: body.description,
+    genre: body.genre,
+    style: body.style,
+    aspectRatio: body.aspect_ratio || '16:9',
+    tags: body.tags ? JSON.stringify(body.tags) : null,
+    metadata: body.metadata,
+    status: 'draft',
+    createdAt: ts,
+    updatedAt: ts,
+  })
+
+  const [result] = await db.select().from(schema.dramas)
+    .where(eq(schema.dramas.id, getInsertId(res)))
+
+  // 不再预建集 — 用户通过「添加集」流程创建（该流程会锁定图片/视频生成配置）
+  return created(c, toSnakeCase(result))
+})
+
+
+// GET /dramas/stats — must be before /:id
+app.get('/stats', async (c) => {
+  const all = await db.select().from(schema.dramas).where(isNull(schema.dramas.deletedAt))
+  const byStatus = Object.entries(
+    all.reduce((acc, d) => {
+      acc[d.status || 'draft'] = (acc[d.status || 'draft'] || 0) + 1
+      return acc
+    }, {} as Record<string, number>)
+  ).map(([status, count]) => ({ status, count }))
+  return success(c, { total: all.length, by_status: byStatus })
+})
+
+// GET /dramas/:id - Get drama detail
+app.get('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const [drama] = await db.select().from(schema.dramas).where(eq(schema.dramas.id, id))
+  if (!drama) return notFound(c, '剧本不存在')
+
+  const eps = await db.select().from(schema.episodes)
+    .where(and(eq(schema.episodes.dramaId, id), isNull(schema.episodes.deletedAt)))
+  const chars = await db.select().from(schema.characters)
+    .where(eq(schema.characters.dramaId, id))
+  const scns = await db.select().from(schema.scenes)
+    .where(eq(schema.scenes.dramaId, id))
+  const prps = await db.select().from(schema.props)
+    .where(eq(schema.props.dramaId, id))
+
+  return success(c, {
+    ...toSnakeCase(drama),
+    tags: drama.tags ? JSON.parse(drama.tags) : [],
+    episodes: toSnakeCaseArray(eps),
+    characters: toSnakeCaseArray(chars),
+    scenes: toSnakeCaseArray(scns),
+    props: toSnakeCaseArray(prps),
+  })
+})
+
+// PUT /dramas/:id - Update drama
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const updates: Record<string, any> = { updatedAt: now() }
+  if (body.title !== undefined) updates.title = body.title
+  if (body.description !== undefined) updates.description = body.description
+  if (body.genre !== undefined) updates.genre = body.genre
+  if (body.style !== undefined) updates.style = body.style
+  if (body.aspect_ratio !== undefined) updates.aspectRatio = body.aspect_ratio
+  if (body.status !== undefined) updates.status = body.status
+  if (body.tags !== undefined) updates.tags = JSON.stringify(body.tags)
+  if (body.metadata !== undefined) updates.metadata = body.metadata
+  await db.update(schema.dramas).set(updates).where(eq(schema.dramas.id, id))
+  return success(c)
+})
+
+// DELETE /dramas/:id - Soft delete
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  await db.update(schema.dramas).set({ deletedAt: now() }).where(eq(schema.dramas.id, id))
+  return success(c)
+})
+
+// PUT /dramas/:id/characters - Save characters
+app.put('/:id/characters', async (c) => {
+  const dramaId = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const chars = body.characters || []
+  const ts = now()
+
+  for (const char of chars) {
+    if (char.id) {
+      await db.update(schema.characters).set({ ...char, updatedAt: ts }).where(eq(schema.characters.id, char.id))
+    } else {
+      await db.insert(schema.characters).values({ ...char, dramaId, createdAt: ts, updatedAt: ts })
+    }
+  }
+  return success(c)
+})
+
+// PUT /dramas/:id/episodes - Save episodes
+app.put('/:id/episodes', async (c) => {
+  const dramaId = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const episodes = body.episodes || []
+  const ts = now()
+
+  for (const ep of episodes) {
+    if (ep.id) {
+      await db.update(schema.episodes).set({ ...ep, updatedAt: ts }).where(eq(schema.episodes.id, ep.id))
+    } else {
+      await db.insert(schema.episodes).values({
+        ...ep,
+        dramaId,
+        episodeNumber: ep.episode_number || ep.episodeNumber || 1,
+        title: ep.title || '未命名',
+        createdAt: ts,
+        updatedAt: ts,
+      })
+    }
+  }
+  return success(c)
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/episodes.ts b/huobao-source/backend/src/routes/episodes.ts
new file mode 100644
index 0000000..934ffee
--- /dev/null
+++ b/huobao-source/backend/src/routes/episodes.ts
@@ -0,0 +1,294 @@
+import { Hono } from 'hono'
+import { taskRouting } from '../services/worker-routing.js'
+import { and, eq, isNull } from 'drizzle-orm'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, notFound, badRequest, now } from '../utils/response.js'
+import { toSnakeCaseArray, toSnakeCase } from '../utils/transform.js'
+import { getActiveConfigId } from '../services/ai.js'
+import { EXTRACT_TARGETS, getExtractionStatus, startExtraction, type ExtractTarget } from '../services/extraction.js'
+import { getVideoPromptBatchStatus, startVideoPromptBatch } from '../services/video-prompts.js'
+
+const app = new Hono()
+
+// POST /episodes — Create a new episode
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  if (!body.drama_id) return badRequest(c, 'drama_id 必填')
+
+  // 图片/视频配置：显式传入优先，缺省时自动锁定当前启用的最高优先级官方配置
+  const imageConfigId = body.image_config_id ?? await getActiveConfigId('image')
+  const videoConfigId = body.video_config_id ?? await getActiveConfigId('video')
+  if (!imageConfigId) return badRequest(c, '未找到启用的图片生成配置，请先在设置中心添加')
+  if (!videoConfigId) return badRequest(c, '未找到启用的视频生成配置，请先在设置中心添加')
+  const ts = now()
+
+  // Get next episode number（忽略已软删的集，删除中间集后新集号可复用空位之后的最大值）
+  const existing = await db.select().from(schema.episodes)
+    .where(and(eq(schema.episodes.dramaId, body.drama_id), isNull(schema.episodes.deletedAt)))
+    .orderBy(schema.episodes.episodeNumber)
+  const nextNum = existing.length ? Math.max(...existing.map(e => e.episodeNumber)) + 1 : 1
+
+  const res = await db.insert(schema.episodes).values({
+    dramaId: body.drama_id,
+    episodeNumber: nextNum,
+    title: body.title || `第${nextNum}集`,
+    imageConfigId,
+    videoConfigId,
+    // 视频分辨率在创建集时固定（480p/720p/1080p），后续可通过 PUT 修改；各视频适配器再映射为厂商档位
+    resolution: ['480p', '720p', '1080p'].includes(body.resolution) ? body.resolution : '720p',
+    createdAt: ts,
+    updatedAt: ts,
+  })
+
+  const [ep] = await db.select().from(schema.episodes)
+    .where(eq(schema.episodes.id, getInsertId(res)))
+  return success(c, {
+    id: ep.id,
+    episode_number: ep.episodeNumber,
+    title: ep.title,
+    image_config_id: ep.imageConfigId,
+    video_config_id: ep.videoConfigId,
+    resolution: ep.resolution,
+  })
+})
+
+// PUT /episodes/:id - Update episode fields
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+
+  const allowed = ['content', 'script_content', 'title', 'description', 'status', 'resolution']
+  const updates: Record<string, any> = {}
+  for (const key of allowed) {
+    if (key in body) updates[key] = body[key]
+  }
+  if (Object.keys(updates).length === 0) return badRequest(c, '没有可更新的字段')
+  if ('resolution' in updates && !['480p', '720p', '1080p'].includes(updates.resolution)) {
+    return badRequest(c, 'resolution 只支持 480p / 720p / 1080p')
+  }
+
+  // Map snake_case to camelCase for drizzle
+  const drizzleUpdates: Record<string, any> = { updatedAt: now() }
+  if ('content' in updates) drizzleUpdates.content = updates.content
+  if ('script_content' in updates) drizzleUpdates.scriptContent = updates.script_content
+  if ('title' in updates) drizzleUpdates.title = updates.title
+  if ('description' in updates) drizzleUpdates.description = updates.description
+  if ('status' in updates) drizzleUpdates.status = updates.status
+  if ('resolution' in updates) drizzleUpdates.resolution = updates.resolution
+
+  await db.update(schema.episodes).set(drizzleUpdates).where(eq(schema.episodes.id, id))
+  return success(c)
+})
+
+// DELETE /episodes/:id - Soft delete episode（其分镜/生成记录保留但不可达）
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, id))
+  if (!ep) return notFound(c, '剧集不存在')
+  await db.update(schema.episodes).set({ deletedAt: now(), updatedAt: now() })
+    .where(eq(schema.episodes.id, id))
+  return success(c)
+})
+
+// GET /episodes/:id/characters — characters linked to this episode
+app.get('/:id/characters', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const links = await db.select().from(schema.episodeCharacters)
+    .where(eq(schema.episodeCharacters.episodeId, episodeId))
+  const charIds = links.map(l => l.characterId)
+  if (!charIds.length) return success(c, [])
+  const allChars = await db.select().from(schema.characters)
+  const result = allChars.filter(ch => charIds.includes(ch.id) && !ch.deletedAt)
+  return success(c, toSnakeCaseArray(result))
+})
+
+// GET /episodes/:id/scenes — scenes linked to this episode
+app.get('/:id/scenes', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const links = await db.select().from(schema.episodeScenes)
+    .where(eq(schema.episodeScenes.episodeId, episodeId))
+  const sceneIds = links.map(l => l.sceneId)
+  if (!sceneIds.length) return success(c, [])
+  const allScenes = await db.select().from(schema.scenes)
+  const result = allScenes.filter(sc => sceneIds.includes(sc.id) && !sc.deletedAt)
+  return success(c, toSnakeCaseArray(result))
+})
+
+// GET /episodes/:id/props — props linked to this episode
+app.get('/:id/props', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const links = await db.select().from(schema.episodeProps)
+    .where(eq(schema.episodeProps.episodeId, episodeId))
+  const propIds = links.map(l => l.propId)
+  if (!propIds.length) return success(c, [])
+  const allProps = await db.select().from(schema.props)
+  const result = allProps.filter(p => propIds.includes(p.id) && !p.deletedAt)
+  return success(c, toSnakeCaseArray(result))
+})
+
+// POST /episodes/:id/extract — 异步提取资产（target: characters | scenes | props），立即返回，前端轮询状态
+app.post('/:id/extract', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const target = body.target as ExtractTarget
+  if (!EXTRACT_TARGETS.includes(target)) return badRequest(c, 'target 必须是 characters / scenes / props')
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, id))
+  if (!ep) return notFound(c, '剧集不存在')
+  const started = startExtraction(ep.id, ep.dramaId, target, { model: body.model || undefined, configId: body.config_id ?? undefined })
+  return success(c, { target, status: 'running', already_running: !started })
+})
+
+// GET /episodes/:id/extract-status — 查询三类资产提取任务状态
+app.get('/:id/extract-status', async (c) => {
+  const id = Number(c.req.param('id'))
+  return success(c, getExtractionStatus(id))
+})
+
+// POST /episodes/:id/generate-video-prompts — 异步批量为缺少视频提示词的分镜生成（立即返回，前端轮询状态）
+app.post('/:id/generate-video-prompts', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json().catch(() => ({}))
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, id))
+  if (!ep) return notFound(c, '剧集不存在')
+  const storyboardIds = Array.isArray(body.storyboard_ids)
+    ? body.storyboard_ids.map(Number).filter((n: number) => Number.isInteger(n) && n > 0)
+    : undefined
+  const result = await startVideoPromptBatch(ep.id, ep.dramaId, { model: body.model || undefined, configId: body.config_id ?? undefined }, storyboardIds)
+  if (result.total === -1) return success(c, { status: 'running', already_running: true })
+  if (!result.started) return success(c, { status: 'idle', total: 0 })
+  return success(c, { status: 'running', total: result.total })
+})
+
+// GET /episodes/:id/video-prompts-status — 查询批量视频提示词任务状态
+app.get('/:id/video-prompts-status', async (c) => {
+  const id = Number(c.req.param('id'))
+  return success(c, getVideoPromptBatchStatus(id))
+})
+
+// GET /episodes/:episode_id/storyboards
+app.get('/:episode_id/storyboards', async (c) => {
+  const episodeId = Number(c.req.param('episode_id'))
+  const rows = await db.select().from(schema.storyboards)
+    .where(eq(schema.storyboards.episodeId, episodeId))
+    .orderBy(schema.storyboards.storyboardNumber)
+
+  const links = await db.select().from(schema.storyboardCharacters)
+  const charIdsByStoryboard = new Map<number, number[]>()
+  for (const link of links) {
+    const arr = charIdsByStoryboard.get(link.storyboardId) || []
+    arr.push(link.characterId)
+    charIdsByStoryboard.set(link.storyboardId, arr)
+  }
+
+  const propLinks = await db.select().from(schema.storyboardProps)
+  const propIdsByStoryboard = new Map<number, number[]>()
+  for (const link of propLinks) {
+    const arr = propIdsByStoryboard.get(link.storyboardId) || []
+    arr.push(link.propId)
+    propIdsByStoryboard.set(link.storyboardId, arr)
+  }
+
+  const episodeCharLinks = await db.select().from(schema.episodeCharacters)
+    .where(eq(schema.episodeCharacters.episodeId, episodeId))
+  const episodeCharIds = episodeCharLinks.map(link => link.characterId)
+  const allChars = (await db.select().from(schema.characters))
+    .filter(ch => episodeCharIds.includes(ch.id) && !ch.deletedAt)
+
+  const episodePropLinks = await db.select().from(schema.episodeProps)
+    .where(eq(schema.episodeProps.episodeId, episodeId))
+  const episodePropIds = episodePropLinks.map(link => link.propId)
+  const allProps = (await db.select().from(schema.props))
+    .filter(p => episodePropIds.includes(p.id) && !p.deletedAt)
+
+  return success(c, rows.map((row) => ({
+    ...toSnakeCase(row),
+    character_ids: charIdsByStoryboard.get(row.id) || [],
+    prop_ids: propIdsByStoryboard.get(row.id) || [],
+    characters: allChars
+      .filter(ch => (charIdsByStoryboard.get(row.id) || []).includes(ch.id))
+      .map(ch => toSnakeCase(ch)),
+    props: allProps
+      .filter(p => (propIdsByStoryboard.get(row.id) || []).includes(p.id))
+      .map(p => toSnakeCase(p)),
+  })))
+})
+
+// GET /episodes/:id/pipeline-status — 流水线进度
+// GET /episodes/:id/generation-tasks — 按集聚合 sys_task + video_merges
+// sys_task 无 episode_id,通过 storyboard/scene/character/prop 关联键归属到当前集
+app.get('/:id/generation-tasks', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, episodeId))
+  if (!ep) return notFound(c, '剧集不存在')
+
+  const sbs = await db.select().from(schema.storyboards).where(eq(schema.storyboards.episodeId, episodeId))
+  const storyboardIds = new Set(sbs.map(s => s.id))
+
+  const epScenes = await db.select().from(schema.episodeScenes).where(eq(schema.episodeScenes.episodeId, episodeId))
+  const sceneIds = new Set(epScenes.map(r => r.sceneId))
+  // 兼容 scenes.episodeId 直挂的旧数据
+  const directScenes = await db.select().from(schema.scenes).where(eq(schema.scenes.episodeId, episodeId))
+  directScenes.forEach(s => sceneIds.add(s.id))
+
+  const epChars = await db.select().from(schema.episodeCharacters).where(eq(schema.episodeCharacters.episodeId, episodeId))
+  const characterIds = new Set(epChars.map(r => r.characterId))
+
+  const dramaProps = await db.select().from(schema.props).where(eq(schema.props.dramaId, ep.dramaId))
+  const propIds = new Set(dramaProps.map(p => p.id))
+
+  const allTasks = await db.select().from(schema.sysTask).where(eq(schema.sysTask.dramaId, ep.dramaId))
+  const tasks = allTasks
+    .filter(t =>
+      (t.storyboardId && storyboardIds.has(t.storyboardId)) ||
+      (t.sceneId && sceneIds.has(t.sceneId)) ||
+      (t.characterId && characterIds.has(t.characterId)) ||
+      (t.propId && propIds.has(t.propId))
+    )
+    .sort((a, b) => (b.createdAt || '').localeCompare(a.createdAt || ''))
+
+  const merges = (await db.select().from(schema.videoMerges)
+    .where(and(eq(schema.videoMerges.episodeId, episodeId), isNull(schema.videoMerges.deletedAt))))
+    .sort((a, b) => (b.createdAt || '').localeCompare(a.createdAt || ''))
+    .slice(0, 20)
+
+  return success(c, {
+    tasks: toSnakeCaseArray(tasks.map(task => ({ ...task, routing: taskRouting(task) }))),
+    merges: toSnakeCaseArray(merges),
+  })
+})
+
+app.get('/:id/pipeline-status', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, episodeId))
+  if (!ep) return notFound(c, '剧集不存在')
+
+  const chars = await db.select().from(schema.characters).where(eq(schema.characters.dramaId, ep.dramaId))
+  const scenes = await db.select().from(schema.scenes).where(eq(schema.scenes.dramaId, ep.dramaId))
+  const sbs = await db.select().from(schema.storyboards).where(eq(schema.storyboards.episodeId, episodeId))
+  const merges = await db.select().from(schema.videoMerges).where(eq(schema.videoMerges.episodeId, episodeId))
+
+  const sbsWithImage = sbs.filter(s => s.composedImage)
+  const sbsWithVideo = sbs.filter(s => s.videoUrl)
+  const latestMerge = merges[merges.length - 1]
+
+  function stepStatus(done: boolean, partial?: boolean) {
+    if (done) return 'done'
+    if (partial) return 'partial'
+    return 'pending'
+  }
+
+  return success(c, {
+    episode_id: episodeId,
+    steps: {
+      script_rewrite: { status: ep.scriptContent ? 'done' : (ep.content ? 'ready' : 'pending') },
+      extract_characters: { status: stepStatus(chars.length > 0), count: chars.length },
+      extract_scenes: { status: stepStatus(scenes.length > 0), count: scenes.length },
+      extract_storyboards: { status: stepStatus(sbs.length > 0), count: sbs.length },
+      generate_images: { status: stepStatus(sbsWithImage.length === sbs.length && sbs.length > 0, sbsWithImage.length > 0), completed: sbsWithImage.length, total: sbs.length },
+      generate_videos: { status: stepStatus(sbsWithVideo.length === sbs.length && sbs.length > 0, sbsWithVideo.length > 0), completed: sbsWithVideo.length, total: sbs.length },
+      merge_episode: { status: latestMerge?.status === 'completed' ? 'done' : (latestMerge ? latestMerge.status : 'pending'), merged_url: latestMerge?.mergedUrl },
+    },
+  })
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/hd.ts b/huobao-source/backend/src/routes/hd.ts
new file mode 100644
index 0000000..0393c40
--- /dev/null
+++ b/huobao-source/backend/src/routes/hd.ts
@@ -0,0 +1,116 @@
+import { Hono } from 'hono'
+import { and, asc, eq } from 'drizzle-orm'
+import fs from 'node:fs'
+import path from 'node:path'
+import { randomUUID } from 'node:crypto'
+import { db, schema } from '../db/index.js'
+import { success, created, badRequest, now } from '../utils/response.js'
+import { getAbsolutePath } from '../utils/storage.js'
+import { STORAGE_ROOT } from '../utils/paths.js'
+import { ffmpeg, checkFfmpegSuite } from '../utils/ffmpeg.js'
+import { generateVideo } from '../services/generation.js'
+import { getDramaStylePrompt } from '../services/style-preset.js'
+import { safeTaskError } from '../services/video-download.js'
+import { parseConfigGpu } from '../services/ai.js'
+import { taskRouting } from '../services/worker-routing.js'
+
+const app = new Hono()
+const MODEL = 'MiniMax-H3-VDN-H3'
+type HdParams = { variant?: string; originalVideoUrl?: string; resolution?: string; gpu?: string }
+function params(raw: string | null): HdParams {
+  try { return JSON.parse(raw || '{}') } catch { return {} }
+}
+function localVideo(url: string) {
+  const absolute = getAbsolutePath(url)
+  const relative = path.relative(STORAGE_ROOT, absolute)
+  if (!url.startsWith('static/videos/') || relative.startsWith('..') || path.isAbsolute(relative) || !fs.existsSync(absolute)) throw new Error('原视频尚未保存到本地，请先完成视频制作')
+  return absolute
+}
+async function versions(id: number) {
+  return db.select().from(schema.sysTask).where(and(eq(schema.sysTask.storyboardId, id), eq(schema.sysTask.type, 'video'))).orderBy(asc(schema.sysTask.id))
+}
+async function context(id: number) {
+  const [sb] = await db.select().from(schema.storyboards).where(eq(schema.storyboards.id, id))
+  if (!sb) throw new Error('分镜不存在')
+  const tasks = await versions(id)
+  const original = tasks.map(t => params(t.params).originalVideoUrl).find(Boolean) || sb.videoUrl
+  return { sb, tasks, original }
+}
+
+app.get('/episodes/:id', async c => {
+  const id = Number(c.req.param('id'))
+  if (!Number.isSafeInteger(id) || id <= 0) return badRequest(c, '集 ID 无效')
+  const boards = await db.select().from(schema.storyboards).where(eq(schema.storyboards.episodeId, id))
+  const configs = (await db.select().from(schema.aiServiceConfigs)).filter(row => row.isActive && row.serviceType === 'video' && row.provider === 'localvideo' && row.model?.includes(MODEL)).sort((a, b) => (b.priority || 0) - (a.priority || 0))
+  return success(c, {
+    configured: configs.length > 0,
+    gpu: parseConfigGpu(configs[0]?.settings),
+    configs: configs.map(row => ({ id: row.id, name: row.name, gpu: parseConfigGpu(row.settings) })),
+    items: await Promise.all(boards.map(async sb => {
+      const { tasks, original } = await context(sb.id)
+      return { id: sb.id, title: sb.title, order: sb.storyboardNumber, current: sb.videoUrl, original,
+        busy: tasks.some(t => t.status === 'processing'),
+        busyTaskId: [...tasks].reverse().find(t => t.status === 'processing')?.id,
+        activeTask: [...tasks].reverse().filter(t => params(t.params).variant === 'hd').map(t => ({ id: t.id, status: t.status, model: t.model, configId: t.configId, gpu: params(t.params).gpu, routing: taskRouting(t) }))[0],
+        versions: tasks.filter(t => params(t.params).variant === 'hd').map(t => ({ id: t.id, status: t.status,
+          resolution: params(t.params).resolution, gpu: params(t.params).gpu, routing: taskRouting(t), url: t.localPath, error: t.errorMsg ? safeTaskError(t.errorMsg) : null, createdAt: t.createdAt })) }
+    })),
+  })
+})
+
+const submitting = new Set<number>()
+app.post('/storyboards/:id', async c => {
+  const id = Number(c.req.param('id'))
+  if (!Number.isSafeInteger(id) || id <= 0) return badRequest(c, '分镜 ID 无效')
+  if (submitting.has(id)) return badRequest(c, '该分镜正在提交，请勿重复点击')
+  submitting.add(id)
+  try {
+    const body: { resolution?: string; config_id?: number; gpu?: 'auto' | 'gpu1' | 'gpu2' | 'gpu3'; replace_task_id?: number } = await c.req.json()
+    if (body.resolution !== '2K' && body.resolution !== '4K') throw new Error('请选择 2K 或 4K')
+    const { sb, tasks, original } = await context(id)
+    if (!original) throw new Error('请先完成该分镜的视频制作')
+    if (tasks.some(t => t.status === 'processing' && t.id !== body.replace_task_id)) throw new Error('该分镜仍有任务运行，请等待完成')
+    const source = localVideo(original)
+    const config = (await db.select().from(schema.aiServiceConfigs)).sort((a, b) => (b.priority || 0) - (a.priority || 0)).find(row => row.isActive && row.serviceType === 'video' && row.provider === 'localvideo' && row.model?.includes(MODEL) && (body.config_id === undefined || row.id === body.config_id))
+    if (!config) throw new Error('请先启用 MiniMax H3-VDN-H3 高清服务')
+    const [episode] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, sb.episodeId))
+    const originalTask = tasks.find(t => t.localPath === original)
+    const prompt = originalTask?.prompt || [await getDramaStylePrompt(episode?.dramaId), sb.videoPrompt || sb.description].filter(Boolean).join('\n')
+    if (!prompt?.trim()) throw new Error('请先填写该分镜的视频提示词')
+    const suite = await checkFfmpegSuite()
+    if (!suite.ffmpeg || !suite.ffprobe) throw new Error('视频工具不可用，无法读取原视频参考画面')
+    const meta = await new Promise<import('fluent-ffmpeg').FfprobeData>((resolve, reject) => ffmpeg.ffprobe(source, (err, data) => err ? reject(err) : resolve(data)))
+    const stream = meta.streams.find(s => s.codec_type === 'video')
+    if (!stream?.width || !stream.height) throw new Error('原视频尺寸无法读取')
+    const ratio = stream.width / stream.height
+    if (Math.min(Math.abs(ratio - 16 / 9), Math.abs(ratio - 9 / 16)) > 0.08) throw new Error('高清制作目前支持 16:9 横屏或 9:16 竖屏视频')
+    const duration = Number(meta.format.duration)
+    if (!Number.isFinite(duration) || duration < 1 || duration > 15.2) throw new Error('高清制作支持 1–15 秒的分镜视频')
+    const ref = `static/images/hd-reference-${randomUUID()}.png`
+    fs.mkdirSync(path.dirname(getAbsolutePath(ref)), { recursive: true })
+    await new Promise<void>((resolve, reject) => ffmpeg(source).seekInput(0).frames(1).output(getAbsolutePath(ref)).on('end', () => resolve()).on('error', reject).run())
+    const taskId = await generateVideo({ storyboardId: id, dramaId: episode?.dramaId, prompt,
+      gpu: body.gpu, replaceTaskId: body.replace_task_id,
+      configId: config.id, model: MODEL, variant: 'hd', originalVideoUrl: original,
+      referenceImageUrls: [ref], referenceMode: 'reference', resolution: body.resolution,
+      aspectRatio: ratio > 1 ? '16:9' : '9:16', duration: Math.min(15, Math.max(4, Math.round(duration))), forceNew: true })
+    return created(c, { id: taskId })
+  } catch (error) { return badRequest(c, safeTaskError(error)) }
+  finally { submitting.delete(id) }
+})
+
+app.post('/storyboards/:id/select', async c => {
+  try {
+    const id = Number(c.req.param('id'))
+    const body: { task_id?: number; original?: boolean } = await c.req.json()
+    const { tasks, original } = await context(id)
+    if (tasks.some(t => t.status === 'processing')) throw new Error('请等待当前视频任务完成后再切换导出版本')
+    const selected = tasks.find(t => t.id === body.task_id && t.status === 'completed' && params(t.params).variant === 'hd')
+    const url = body.original === true ? original : selected?.localPath
+    if (!url) throw new Error('所选视频版本尚未完成或不存在')
+    localVideo(url)
+    await db.update(schema.storyboards).set({ videoUrl: url, updatedAt: now() }).where(eq(schema.storyboards.id, id))
+    return success(c, { video_url: url })
+  } catch (error) { return badRequest(c, safeTaskError(error)) }
+})
+export default app
diff --git a/huobao-source/backend/src/routes/merge.ts b/huobao-source/backend/src/routes/merge.ts
new file mode 100644
index 0000000..3c0c700
--- /dev/null
+++ b/huobao-source/backend/src/routes/merge.ts
@@ -0,0 +1,58 @@
+import { Hono } from 'hono'
+import { and, eq, isNull } from 'drizzle-orm'
+import { db, schema } from '../db/index.js'
+import { success, badRequest } from '../utils/response.js'
+import { mergeEpisodeVideos } from '../services/ffmpeg-merge.js'
+import { toSnakeCase } from '../utils/transform.js'
+import { logTaskError, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+const app = new Hono()
+
+// POST /episodes/:id/merge — 拼接镜头视频(body.storyboard_ids 可选,只拼所选)
+app.post('/episodes/:id/merge', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, episodeId))
+  if (!ep) return badRequest(c, '剧集不存在')
+
+  let storyboardIds: number[] | undefined
+  try {
+    const body = await c.req.json()
+    if (Array.isArray(body?.storyboard_ids)) {
+      storyboardIds = body.storyboard_ids.map(Number).filter(Boolean)
+    }
+  } catch { /* 无 body 时拼接全部 */ }
+
+  try {
+    logTaskStart('MergeAPI', 'episode-merge', { episodeId, dramaId: ep.dramaId, storyboardIds })
+    const mergeId = await mergeEpisodeVideos(episodeId, ep.dramaId, storyboardIds)
+    logTaskSuccess('MergeAPI', 'episode-merge', { episodeId, mergeId })
+    return success(c, { merge_id: mergeId, status: 'processing' })
+  } catch (err: any) {
+    logTaskError('MergeAPI', 'episode-merge', { episodeId, error: err.message })
+    return badRequest(c, err.message)
+  }
+})
+
+// GET /episodes/:id/merge — 查询最新拼接状态
+app.get('/episodes/:id/merge', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const merges = await db.select().from(schema.videoMerges)
+    .where(eq(schema.videoMerges.episodeId, episodeId))
+
+
+  const latest = merges[merges.length - 1]
+  if (!latest) return success(c, null)
+
+  return success(c, toSnakeCase(latest))
+})
+
+// GET /episodes/:id/merges — 成片列表(全部拼接记录,新的在前)
+app.get('/episodes/:id/merges', async (c) => {
+  const episodeId = Number(c.req.param('id'))
+  const merges = await db.select().from(schema.videoMerges)
+    .where(and(eq(schema.videoMerges.episodeId, episodeId), isNull(schema.videoMerges.deletedAt)))
+  merges.sort((a, b) => (b.createdAt || '').localeCompare(a.createdAt || ''))
+  return success(c, merges.slice(0, 30).map(toSnakeCase))
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/prompts.ts b/huobao-source/backend/src/routes/prompts.ts
new file mode 100644
index 0000000..e28a377
--- /dev/null
+++ b/huobao-source/backend/src/routes/prompts.ts
@@ -0,0 +1,96 @@
+/**
+ * Agent prompt 管理路由 — 读写 workspace/prompts/<agent_type>[.<lang>].md
+ * 文件操作 jail 在 backend/workspace/ 目录内（仿 skills 路由）
+ * ?lang=en/ja/ko 读写语言变体；zh/缺省为基础版（历史行为）
+ */
+import { Hono } from 'hono'
+import { success, badRequest } from '../utils/response.js'
+import { skillsManagerWorkspace } from '../agents/skills.js'
+import { validAgentTypes, DEFAULT_PROMPTS } from '../agents/index.js'
+import { loadAgentPromptFile, serializePromptFile, promptFilePath } from '../agents/prompts.js'
+
+const app = new Hono()
+const fsm = () => skillsManagerWorkspace.filesystem!
+
+const checkType = (type: string) => validAgentTypes.includes(type)
+const LANGS = ['zh', 'en', 'ja', 'ko']
+const normalizeLang = (v?: string) => (v && LANGS.includes(v) ? v : 'zh')
+
+// GET /prompts — 列出全部 Agent 的 prompt 状态（基础版口径；name/model 只属于基础版）
+app.get('/', async (c) => {
+  const list = await Promise.all(validAgentTypes.map(async (type) => {
+    const file = await loadAgentPromptFile(type)
+    return {
+      agent_type: type,
+      name: file?.name || DEFAULT_PROMPTS[type].name,
+      model: file?.model || '',
+      is_default: !file,
+    }
+  }))
+  return success(c, list)
+})
+
+// GET /prompts/:type?lang= — 有效内容（语言变体优先，缺失回退基础版，再缺失回退代码默认）
+// is_default=true 表示当前语言无独立文件（内容为回退版本），前端据此提示「跟随中文」
+app.get('/:type', async (c) => {
+  const type = c.req.param('type')
+  if (!checkType(type)) return badRequest(c, '未知的 Agent 类型')
+  const lang = normalizeLang(c.req.query('lang'))
+  const [file, base] = await Promise.all([
+    loadAgentPromptFile(type, lang),
+    lang === 'zh' ? Promise.resolve(null) : loadAgentPromptFile(type),
+  ])
+  // 非 zh 且变体不存在时 file 即基础版；通过路径再确认一次变体存在性
+  const variantExists = lang !== 'zh' && await fsm().exists(promptFilePath(type, lang))
+  if (file) {
+    return success(c, {
+      agent_type: type,
+      lang,
+      name: base?.name || file.name || DEFAULT_PROMPTS[type].name,
+      model: base?.model || file.model,
+      system_prompt: file.instructions,
+      is_default: lang === 'zh' ? false : !variantExists,
+    })
+  }
+  return success(c, {
+    agent_type: type,
+    lang,
+    name: DEFAULT_PROMPTS[type].name,
+    model: '',
+    system_prompt: DEFAULT_PROMPTS[type].instructions,
+    is_default: true,
+  })
+})
+
+// PUT /prompts/:type?lang= — 保存为 prompt 文件（lang 非 zh 写语言变体；model 只随基础版保存）
+app.put('/:type', async (c) => {
+  const type = c.req.param('type')
+  if (!checkType(type)) return badRequest(c, '未知的 Agent 类型')
+  const body = await c.req.json()
+  const lang = normalizeLang(c.req.query('lang') ?? body.lang)
+  const instructions = String(body.system_prompt ?? '').trim()
+  if (!instructions) return badRequest(c, 'system_prompt 必填')
+  if (lang === 'zh') {
+    const name = String(body.name || DEFAULT_PROMPTS[type].name)
+    const model = String(body.model ?? '').trim()
+    await fsm().writeFile(promptFilePath(type), serializePromptFile({ name, model, instructions }), { recursive: true })
+    return success(c, { agent_type: type, lang, name, model, is_default: false })
+  }
+  // 语言变体：model 不从变体读取，name 仅作展示；保留变体自己的 name（缺省用基础版/默认名）
+  const base = await loadAgentPromptFile(type)
+  const name = String(body.name || base?.name || DEFAULT_PROMPTS[type].name)
+  await fsm().writeFile(promptFilePath(type, lang), serializePromptFile({ name, model: '', instructions }), { recursive: true })
+  return success(c, { agent_type: type, lang, name, is_default: false })
+})
+
+// POST /prompts/:type/reset?lang= — 删除对应语言文件，回退（变体→基础版；基础版→代码默认）
+app.post('/:type/reset', async (c) => {
+  const type = c.req.param('type')
+  if (!checkType(type)) return badRequest(c, '未知的 Agent 类型')
+  const lang = normalizeLang(c.req.query('lang'))
+  const path = promptFilePath(type, lang)
+  if (await fsm().exists(path)) await fsm().deleteFile(path)
+  return success(c, { agent_type: type, lang, is_default: true })
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/props.ts b/huobao-source/backend/src/routes/props.ts
new file mode 100644
index 0000000..cc50bd9
--- /dev/null
+++ b/huobao-source/backend/src/routes/props.ts
@@ -0,0 +1,131 @@
+import { Hono } from 'hono'
+import { and, eq } from 'drizzle-orm'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, created, badRequest, now } from '../utils/response.js'
+import { toSnakeCase } from '../utils/transform.js'
+import { generateImage } from '../services/generation.js'
+import { getDramaStylePrompt } from '../services/style-preset.js'
+import { ensurePropFinalPrompt } from '../services/final-prompt.js'
+import { logTaskError, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+import { assetReferenceImages, registerAssetReferenceRoutes } from './asset-references.js'
+
+const app = new Hono()
+registerAssetReferenceRoutes(app, schema.props)
+// 道具图：白底单品静物，方形画布
+const PROP_IMAGE_SIZE = '1024x1024'
+
+// POST /props — 手动新增道具（传入 episode_id 时关联到该集）
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  if (!body.drama_id) return badRequest(c, 'drama_id 必填')
+  if (!body.name?.trim()) return badRequest(c, '名称必填')
+  const ts = now()
+  const res = await db.insert(schema.props).values({
+    name: body.name.trim(),
+    type: body.type || '',
+    description: body.description || '',
+    dramaId: body.drama_id,
+    createdAt: ts,
+    updatedAt: ts,
+  })
+  const propId = getInsertId(res)
+  if (body.episode_id) {
+    const existing = await db.select().from(schema.episodeProps)
+      .where(and(eq(schema.episodeProps.episodeId, Number(body.episode_id)), eq(schema.episodeProps.propId, propId)))
+    if (!existing.length) {
+      await db.insert(schema.episodeProps).values({ episodeId: Number(body.episode_id), propId, createdAt: ts })
+    }
+  }
+  const [row] = await db.select().from(schema.props).where(eq(schema.props.id, propId))
+  return created(c, toSnakeCase(row))
+})
+
+// DELETE /props/:id — 软删除
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  await db.update(schema.props).set({ deletedAt: now(), updatedAt: now() }).where(eq(schema.props.id, id))
+  return success(c)
+})
+
+// PUT /props/:id — 更新道具（物品外貌/类型/最终提示词）
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const updates: Record<string, any> = { updatedAt: now() }
+  if (body.name !== undefined) updates.name = body.name
+  if (body.type !== undefined) updates.type = body.type
+  if (body.description !== undefined) updates.description = body.description
+  // 用户上传道具图：直接写入图片地址与本地路径
+  if (body.image_url !== undefined) updates.imageUrl = body.image_url
+  else if (body.imageUrl !== undefined) updates.imageUrl = body.imageUrl
+  if (body.local_path !== undefined) updates.localPath = body.local_path
+  else if (body.localPath !== undefined) updates.localPath = body.localPath
+  // 手动编辑最终提示词时以传入值为准；未传入则保留原值（修改信息时不再自动置空）
+  if (body.final_prompt !== undefined) updates.finalPrompt = body.final_prompt || null
+  else if (body.finalPrompt !== undefined) updates.finalPrompt = body.finalPrompt || null
+  await db.update(schema.props).set(updates).where(eq(schema.props.id, id))
+  return success(c)
+})
+
+/** 本地兜底提示词：白底单品，不掺杂其他元素 */
+function propImagePrompt(prop: typeof schema.props.$inferSelect, stylePrompt = '') {
+  return [
+    stylePrompt || '',
+    `single product photo of ${prop.name}`,
+    prop.description || '',
+    'isolated on a pure white background',
+    'no other objects, no people, no scenery',
+    'soft even studio lighting',
+    'high detail',
+    'no text, no watermark',
+  ].filter(Boolean).join(', ')
+}
+
+// POST /props/:id/generate-prompt — 独立生成/重新生成白底单品最终提示词（不生图）
+app.post('/:id/generate-prompt', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [prop] = await db.select().from(schema.props).where(eq(schema.props.id, id))
+  if (!prop) return badRequest(c, '道具不存在')
+  if (!body.episode_id) return badRequest(c, 'episode_id 必填')
+
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, Number(body.episode_id)))
+  if (!ep) return badRequest(c, '剧集不存在')
+
+  logTaskStart('FinalPrompt', 'prop-generate', { propId: id, episodeId: ep.id, force: !!body.force })
+  const finalPrompt = await ensurePropFinalPrompt(prop, ep.id, !!body.force, { model: body.text_model, configId: body.text_config_id ?? undefined })
+  if (!finalPrompt) {
+    logTaskError('FinalPrompt', 'prop-generate', { propId: id, error: 'agent returned empty prompt' })
+    return badRequest(c, '最终提示词生成失败，请重试')
+  }
+  logTaskSuccess('FinalPrompt', 'prop-generate', { propId: id })
+  return success(c, { final_prompt: finalPrompt })
+})
+
+// POST /props/:id/generate-image — 生成道具白底单品图
+app.post('/:id/generate-image', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [prop] = await db.select().from(schema.props).where(eq(schema.props.id, id))
+  if (!prop) return badRequest(c, '道具不存在')
+  if (!body.episode_id) return badRequest(c, 'episode_id 必填')
+
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, Number(body.episode_id)))
+  if (!ep) return badRequest(c, '剧集不存在')
+
+  const stylePrompt = await getDramaStylePrompt(prop.dramaId)
+  const finalPrompt = await ensurePropFinalPrompt(prop, ep.id, false, { model: body.text_model, configId: body.text_config_id ?? undefined })
+  const prompt = finalPrompt || propImagePrompt(prop, stylePrompt)
+  try {
+    logTaskStart('PropImage', 'generate', { propId: id, episodeId: ep.id, dramaId: prop.dramaId })
+    const genId = await generateImage({ propId: id, dramaId: prop.dramaId, prompt, referenceImages: assetReferenceImages(prop.referenceImages), model: body.model, size: PROP_IMAGE_SIZE, configId: body.config_id ?? ep.imageConfigId ?? undefined })
+    logTaskSuccess('PropImage', 'generate', { propId: id, generationId: genId })
+    return success(c, { image_generation_id: genId })
+  } catch (err: any) {
+    logTaskError('PropImage', 'generate', { propId: id, error: err.message })
+    return badRequest(c, err.message)
+  }
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/scenes.ts b/huobao-source/backend/src/routes/scenes.ts
new file mode 100644
index 0000000..c3d39ae
--- /dev/null
+++ b/huobao-source/backend/src/routes/scenes.ts
@@ -0,0 +1,131 @@
+import { Hono } from 'hono'
+import { and, eq } from 'drizzle-orm'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, created, badRequest, now } from '../utils/response.js'
+import { generateImage } from '../services/generation.js'
+import { getDramaStylePrompt } from '../services/style-preset.js'
+import { ensureSceneFinalPrompt } from '../services/final-prompt.js'
+import { logTaskError, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+import { assetReferenceImages, registerAssetReferenceRoutes } from './asset-references.js'
+
+const app = new Hono()
+registerAssetReferenceRoutes(app, schema.scenes)
+
+// POST /scenes — 手动新增场景（传入 episode_id 时关联到该集）
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  if (!body.drama_id) return badRequest(c, 'drama_id 必填')
+  if (!body.location?.trim()) return badRequest(c, '地点必填')
+  const ts = now()
+  const res = await db.insert(schema.scenes).values({
+    dramaId: body.drama_id,
+    episodeId: body.episode_id,
+    location: body.location.trim(),
+    time: body.time || '',
+    prompt: body.prompt || body.description || body.location,
+    lighting: body.lighting || '',
+    createdAt: ts,
+    updatedAt: ts,
+  })
+  const sceneId = getInsertId(res)
+  if (body.episode_id) {
+    const existing = await db.select().from(schema.episodeScenes)
+      .where(and(eq(schema.episodeScenes.episodeId, Number(body.episode_id)), eq(schema.episodeScenes.sceneId, sceneId)))
+    if (!existing.length) {
+      await db.insert(schema.episodeScenes).values({ episodeId: Number(body.episode_id), sceneId, createdAt: ts })
+    }
+  }
+  const [result] = await db.select().from(schema.scenes)
+    .where(eq(schema.scenes.id, sceneId))
+  return created(c, result)
+})
+
+// PUT /scenes/:id
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const updates: Record<string, any> = { updatedAt: now() }
+  if (body.location !== undefined) updates.location = body.location
+  if (body.time !== undefined) updates.time = body.time
+  if (body.prompt !== undefined) updates.prompt = body.prompt
+  if (body.description !== undefined) updates.prompt = body.description
+  if (body.lighting !== undefined) updates.lighting = body.lighting
+  // 用户上传场景图：直接写入图片地址与本地路径
+  const uploadedImage = body.image_url ?? body.imageUrl
+  if (uploadedImage !== undefined) {
+    updates.imageUrl = uploadedImage
+    if (uploadedImage) updates.status = 'completed'
+  }
+  if (body.local_path !== undefined) updates.localPath = body.local_path
+  else if (body.localPath !== undefined) updates.localPath = body.localPath
+  // 手动编辑最终提示词时以传入值为准；未传入则保留原值（修改信息时不再自动置空）
+  if (body.final_prompt !== undefined) updates.finalPrompt = body.final_prompt || null
+  else if (body.finalPrompt !== undefined) updates.finalPrompt = body.finalPrompt || null
+  await db.update(schema.scenes).set(updates).where(eq(schema.scenes.id, id))
+  return success(c)
+})
+
+// POST /scenes/:id/generate-image
+app.post('/:id/generate-image', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [scene] = await db.select().from(schema.scenes).where(eq(schema.scenes.id, id))
+  if (!scene) return badRequest(c, '场景不存在')
+  if (!body.episode_id) return badRequest(c, 'episode_id 必填')
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, Number(body.episode_id)))
+  if (!ep) return badRequest(c, '剧集不存在')
+
+  const stylePrompt = await getDramaStylePrompt(scene.dramaId)
+  const finalPrompt = await ensureSceneFinalPrompt(scene, ep.id, false, { model: body.text_model, configId: body.text_config_id ?? undefined })
+  // 回退拼接也要守住无人物约束：场景描述(prompt)可能含人物活动，直接拼会让人混进图里
+  const prompt = finalPrompt || [
+    stylePrompt || '',
+    scene.location,
+    scene.time || '',
+    scene.prompt || '高质量场景',
+    scene.lighting || '电影感光影',
+    '画面中没有任何人物，空场景，只有场景本身',
+  ].filter(Boolean).join(', ')
+  try {
+    logTaskStart('SceneImage', 'generate', { sceneId: id, episodeId: ep.id, dramaId: scene.dramaId, location: scene.location })
+    await db.update(schema.scenes).set({ status: 'processing', updatedAt: now() }).where(eq(schema.scenes.id, id))
+    const genId = await generateImage({ sceneId: id, dramaId: scene.dramaId, prompt, referenceImages: assetReferenceImages(scene.referenceImages), model: body.model, configId: body.config_id ?? ep.imageConfigId ?? undefined })
+    logTaskSuccess('SceneImage', 'generate', { sceneId: id, generationId: genId })
+    return success(c, { image_generation_id: genId })
+  } catch (err: any) {
+    logTaskError('SceneImage', 'generate', { sceneId: id, error: err.message })
+    await db.update(schema.scenes).set({ status: 'failed', updatedAt: now() }).where(eq(schema.scenes.id, id))
+    return badRequest(c, err.message)
+  }
+})
+
+// POST /scenes/:id/generate-prompt — 独立生成/重新生成固定视角最终提示词（不生图）
+app.post('/:id/generate-prompt', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [scene] = await db.select().from(schema.scenes).where(eq(schema.scenes.id, id))
+  if (!scene) return badRequest(c, '场景不存在')
+  if (!body.episode_id) return badRequest(c, 'episode_id 必填')
+
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, Number(body.episode_id)))
+  if (!ep) return badRequest(c, '剧集不存在')
+
+  logTaskStart('FinalPrompt', 'scene-generate', { sceneId: id, episodeId: ep.id, force: !!body.force })
+  const finalPrompt = await ensureSceneFinalPrompt(scene, ep.id, !!body.force, { model: body.text_model, configId: body.text_config_id ?? undefined })
+  if (!finalPrompt) {
+    logTaskError('FinalPrompt', 'scene-generate', { sceneId: id, error: 'agent returned empty prompt' })
+    return badRequest(c, '最终提示词生成失败，请重试')
+  }
+  logTaskSuccess('FinalPrompt', 'scene-generate', { sceneId: id })
+  return success(c, { final_prompt: finalPrompt })
+})
+
+// DELETE /scenes/:id — 软删除（保留历史生成记录）
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  await db.update(schema.scenes).set({ deletedAt: now(), updatedAt: now() }).where(eq(schema.scenes.id, id))
+  return success(c)
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/serverUpdate.ts b/huobao-source/backend/src/routes/serverUpdate.ts
new file mode 100644
index 0000000..2ffc7a8
--- /dev/null
+++ b/huobao-source/backend/src/routes/serverUpdate.ts
@@ -0,0 +1,26 @@
+/**
+ * 服务器 / Docker 部署的版本检查与更新路由（桌面版更新走 Electron 桥，不经此路由）
+ */
+import { Hono } from 'hono'
+import { getServerUpdateState, checkServerUpdate, triggerWatchtowerUpdate } from '../services/server-update.js'
+import { success, badRequest } from '../utils/response.js'
+
+const app = new Hono()
+
+// GET /state — 当前版本 + 更新模式 + 上次检查结果
+app.get('/state', (c) => success(c, getServerUpdateState()))
+
+// POST /check — 拉取发布清单比较版本
+app.post('/check', async (c) => success(c, await checkServerUpdate()))
+
+// POST /apply — 触发 Watchtower 拉新镜像并重建本容器（仅 watchtower 模式可用）
+app.post('/apply', async (c) => {
+  try {
+    await triggerWatchtowerUpdate()
+    return success(c, { triggered: true })
+  } catch (err) {
+    return badRequest(c, (err as Error).message)
+  }
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/settings.ts b/huobao-source/backend/src/routes/settings.ts
new file mode 100644
index 0000000..9f19757
--- /dev/null
+++ b/huobao-source/backend/src/routes/settings.ts
@@ -0,0 +1,40 @@
+/**
+ * 应用设置路由 — 全局配置的读写入口（当前：AI 内容语言）
+ */
+import { Hono } from 'hono'
+import { getContentLanguage, setContentLanguage, getToursSeen, setToursSeen, CONTENT_LANGUAGES, type ContentLanguage } from '../services/app-settings.js'
+import { success, badRequest } from '../utils/response.js'
+
+const app = new Hono()
+
+// GET /content-language — 当前 AI 内容语言
+app.get('/content-language', async (c) => {
+  return success(c, { language: await getContentLanguage() })
+})
+
+// PUT /content-language — 设置 AI 内容语言（body: { language: 'zh'|'en'|'ja'|'ko' }）
+app.put('/content-language', async (c) => {
+  const body = await c.req.json().catch(() => null)
+  const language = body?.language
+  if (!(CONTENT_LANGUAGES as readonly string[]).includes(language)) {
+    return badRequest(c, `language 必须是 ${CONTENT_LANGUAGES.join(' / ')} 之一`)
+  }
+  const saved = await setContentLanguage(language as ContentLanguage)
+  return success(c, { language: saved })
+})
+
+// GET /tours-seen — 已看过的引导漫游 id 列表
+app.get('/tours-seen', async (c) => {
+  return success(c, { seen: await getToursSeen() })
+})
+
+// PUT /tours-seen — 写入已看过的引导漫游 id 列表（body: { seen: string[] }）
+app.put('/tours-seen', async (c) => {
+  const body = await c.req.json().catch(() => null)
+  if (!Array.isArray(body?.seen) || !body.seen.every((v: unknown) => typeof v === 'string')) {
+    return badRequest(c, 'seen 必须是字符串数组')
+  }
+  return success(c, { seen: await setToursSeen(body.seen) })
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/skills.ts b/huobao-source/backend/src/routes/skills.ts
new file mode 100644
index 0000000..4ee2f6b
--- /dev/null
+++ b/huobao-source/backend/src/routes/skills.ts
@@ -0,0 +1,99 @@
+/**
+ * 技能管理路由 — 全部经 Mastra Workspace API 读写
+ * 文件操作 jail 在 backend/workspace/ 目录内
+ */
+import { Hono } from 'hono'
+import { success, badRequest } from '../utils/response.js'
+import { refreshSkillWorkspaces, skillsManagerWorkspace } from '../agents/skills.js'
+
+const app = new Hono()
+const fsm = () => skillsManagerWorkspace.filesystem!
+const LANGS = ['zh', 'en', 'ja', 'ko']
+const normalizeLang = (v?: string) => (v && LANGS.includes(v) ? v : 'zh')
+/** 技能文件路径；lang 非 zh 时为语言变体 SKILL.<lang>.md */
+const skillFile = (id: string, lang?: string) => `skills/${id}/SKILL${lang && lang !== 'zh' ? `.${lang}` : ''}.md`
+const SKILL_ID_SEGMENT = /^[a-z0-9-]+$/
+
+// GET /skills?lang= — List all skills (经 workspace.skills 原生发现)
+// lang 非 zh 且变体存在时，名称/描述取自语言变体 frontmatter（缺失则回退基础版）
+app.get('/', async (c) => {
+  const lang = normalizeLang(c.req.query('lang'))
+  const metas = await skillsManagerWorkspace.skills?.list() || []
+  const out = []
+  for (const meta of metas) {
+    const id = meta.path.replace(/^skills\//, '')
+    let name = meta.name
+    let description = meta.description || ''
+    if (lang !== 'zh' && await fsm().exists(skillFile(id, lang))) {
+      const raw = String(await fsm().readFile(skillFile(id, lang), { encoding: 'utf-8' }))
+      const fm = /^---\r?\n([\s\S]*?)\r?\n---/.exec(raw)?.[1] || ''
+      const n = /^name:\s*(.+)$/m.exec(fm)?.[1]?.trim()
+      const d = /^description:\s*(.+)$/m.exec(fm)?.[1]?.trim()
+      if (n) name = n
+      if (d) description = d
+    }
+    out.push({ id, name, description })
+  }
+  return success(c, out)
+})
+
+// GET /skills/:id?lang= — Get skill content (raw, 含 frontmatter 供编辑)
+// lang 非 zh 时读语言变体；变体缺失回退基础版内容并标记 is_default=true（前端提示「跟随中文」）
+app.get('/*', async (c) => {
+  const id = c.req.path.slice('/api/v1/skills/'.length)
+  const lang = normalizeLang(c.req.query('lang'))
+  if (!await fsm().exists(skillFile(id))) return badRequest(c, '技能不存在')
+  const variantExists = lang !== 'zh' && await fsm().exists(skillFile(id, lang))
+  const content = await fsm().readFile(skillFile(id, variantExists ? lang : undefined), { encoding: 'utf-8' })
+  return success(c, { id, lang, content, is_default: lang !== 'zh' && !variantExists })
+})
+
+// PUT /skills/:id?lang= — Update skill content（lang 非 zh 写语言变体；基础版变更需刷新技能缓存）
+app.put('/*', async (c) => {
+  const id = c.req.path.slice('/api/v1/skills/'.length)
+  const body = await c.req.json()
+  const lang = normalizeLang(c.req.query('lang') ?? body.lang)
+  if (lang !== 'zh' && !await fsm().exists(skillFile(id))) return badRequest(c, '技能不存在')
+  await fsm().writeFile(skillFile(id, lang), body.content, { recursive: true })
+  // 目录 mtime 不会因文件内容编辑而更新（APFS），显式刷新技能缓存；语言变体直读无需刷新
+  if (lang === 'zh') await refreshSkillWorkspaces()
+  return success(c)
+})
+
+// POST /skills — Create new skill directory
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  const { id, description } = body
+  if (!id) return badRequest(c, 'Skill id 必填')
+  // Mastra 技能规范：frontmatter name 必须与目录名一致，且只允许小写字母/数字/连字符
+  const segments = String(id).split('/')
+  if (!segments.every((seg: string) => SKILL_ID_SEGMENT.test(seg))) {
+    return badRequest(c, 'Skill id 每段只能包含小写字母、数字和连字符')
+  }
+  if (await fsm().exists(skillFile(id))) return badRequest(c, '技能已存在')
+
+  const name = segments[segments.length - 1]
+  const content = `---
+name: ${name}
+description: ${description || ''}
+---
+
+# ${name}
+
+Write your skill content here.
+`
+  await fsm().writeFile(skillFile(id), content, { recursive: true, overwrite: false })
+  await refreshSkillWorkspaces()
+  return success(c, { id, name, description: description || '' })
+})
+
+// DELETE /skills/:id — Delete skill directory
+app.delete('/*', async (c) => {
+  const id = c.req.path.slice('/api/v1/skills/'.length)
+  if (!await fsm().exists(`skills/${id}`)) return badRequest(c, '技能不存在')
+  await fsm().rmdir(`skills/${id}`, { recursive: true })
+  await refreshSkillWorkspaces()
+  return success(c)
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/storage.ts b/huobao-source/backend/src/routes/storage.ts
new file mode 100644
index 0000000..5158250
--- /dev/null
+++ b/huobao-source/backend/src/routes/storage.ts
@@ -0,0 +1,68 @@
+/**
+ * 存储位置信息路由 — 设置页「存储位置」卡片数据源
+ *
+ * GET / → 当前模式(desktop/server)、目录路径、磁盘占用（分桶）与剩余空间。
+ * 占用计算较重（全目录 walk）：内存缓存 60s TTL + stale-while-revalidate，
+ * 过期时立即返回旧值并后台单飞重算（computing 防并发）；首次无值才同步等待。
+ */
+import { Hono } from 'hono'
+import { DATA_ROOT, STORAGE_ROOT } from '../utils/paths.js'
+import { dbPath } from '../db/index.js'
+import { dirUsage, volumeFreeBytes } from '../utils/dirsize.js'
+import { success } from '../utils/response.js'
+
+const app = new Hono()
+
+const USAGE_TTL_MS = 60_000
+
+interface UsageCache {
+  usage: Awaited<ReturnType<typeof dirUsage>> | null
+  computedAt: string | null
+  computing: boolean
+}
+const cache: UsageCache = { usage: null, computedAt: null, computing: false }
+
+async function computeUsage() {
+  if (cache.computing) return
+  cache.computing = true
+  try {
+    const usage = await dirUsage(DATA_ROOT, dbPath)
+    cache.usage = usage
+    cache.computedAt = new Date().toISOString()
+  } finally {
+    cache.computing = false
+  }
+}
+
+// 启动 10s 后后台预热一次，用户进设置页时大概率已命中缓存
+const warmup = setTimeout(() => { void computeUsage() }, 10_000)
+warmup.unref?.()
+
+app.get('/', async (c) => {
+  const fresh = cache.computedAt && (Date.now() - new Date(cache.computedAt).getTime()) < USAGE_TTL_MS
+  let usageStale = false
+  if (!fresh) {
+    if (cache.usage) {
+      // stale-while-revalidate：先回旧值，后台重算
+      usageStale = true
+      void computeUsage()
+    } else {
+      // 首次无值，同步等待首算（保证进入页面必有数据）
+      await computeUsage()
+    }
+  }
+
+  const mode = process.env.HUOBAO_DESKTOP === '1' ? 'desktop' : 'server'
+  return success(c, {
+    mode,
+    dataDir: DATA_ROOT,
+    storageRoot: STORAGE_ROOT,
+    sqlitePath: dbPath,
+    usage: cache.usage,
+    usageStale: usageStale || cache.computing,
+    computedAt: cache.computedAt,
+    freeBytes: await volumeFreeBytes(DATA_ROOT),
+  })
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/storyboards.ts b/huobao-source/backend/src/routes/storyboards.ts
new file mode 100644
index 0000000..a690c51
--- /dev/null
+++ b/huobao-source/backend/src/routes/storyboards.ts
@@ -0,0 +1,175 @@
+import { Hono } from 'hono'
+import { eq } from 'drizzle-orm'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, created, now, badRequest } from '../utils/response.js'
+import { toSnakeCase } from '../utils/transform.js'
+import { logTaskPayload, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+const app = new Hono()
+
+async function syncStoryboardCharacters(storyboardId: number, characterIds: number[]) {
+  await db.delete(schema.storyboardCharacters)
+    .where(eq(schema.storyboardCharacters.storyboardId, storyboardId))
+
+
+  const uniqueIds = [...new Set((characterIds || []).filter(Boolean))]
+  if (!uniqueIds.length) return
+
+  for (const characterId of uniqueIds) {
+    await db.insert(schema.storyboardCharacters).values({
+      storyboardId,
+      characterId,
+    })
+  }
+}
+
+async function getStoryboardCharacterIds(storyboardId: number) {
+  const links = await db.select().from(schema.storyboardCharacters)
+    .where(eq(schema.storyboardCharacters.storyboardId, storyboardId))
+  return links.map(link => link.characterId)
+}
+
+async function syncStoryboardProps(storyboardId: number, propIds: number[]) {
+  await db.delete(schema.storyboardProps)
+    .where(eq(schema.storyboardProps.storyboardId, storyboardId))
+
+  const uniqueIds = [...new Set((propIds || []).filter(Boolean))]
+  if (!uniqueIds.length) return
+
+  for (const propId of uniqueIds) {
+    await db.insert(schema.storyboardProps).values({
+      storyboardId,
+      propId,
+    })
+  }
+}
+
+async function getStoryboardPropIds(storyboardId: number) {
+  const links = await db.select().from(schema.storyboardProps)
+    .where(eq(schema.storyboardProps.storyboardId, storyboardId))
+  return links.map(link => link.propId)
+}
+
+async function validateStoryboardBindings(episodeId: number, sceneId: number | null | undefined, characterIds: number[] | undefined, propIds?: number[] | undefined) {
+  const sceneLinks = await db.select().from(schema.episodeScenes)
+    .where(eq(schema.episodeScenes.episodeId, episodeId))
+  const episodeSceneIds = new Set(sceneLinks.map(link => link.sceneId))
+  const characterLinks = await db.select().from(schema.episodeCharacters)
+    .where(eq(schema.episodeCharacters.episodeId, episodeId))
+  const episodeCharacterIds = new Set(characterLinks.map(link => link.characterId))
+  const propLinks = await db.select().from(schema.episodeProps)
+    .where(eq(schema.episodeProps.episodeId, episodeId))
+  const episodePropIds = new Set(propLinks.map(link => link.propId))
+
+  if (sceneId != null && !episodeSceneIds.has(sceneId)) {
+    throw new Error('scene_id 必须来自当前集已关联场景')
+  }
+
+  const invalidCharacterIds = (characterIds || []).filter(id => !episodeCharacterIds.has(id))
+  if (invalidCharacterIds.length) {
+    throw new Error('character_ids 必须来自当前集已关联角色')
+  }
+
+  const invalidPropIds = (propIds || []).filter(id => !episodePropIds.has(id))
+  if (invalidPropIds.length) {
+    throw new Error('prop_ids 必须来自当前集已关联道具')
+  }
+}
+
+// POST /storyboards
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  const ts = now()
+  logTaskStart('StoryboardAPI', 'create', {
+    episodeId: body.episode_id,
+    shotNumber: body.storyboard_number || 1,
+    sceneId: body.scene_id,
+    characterIds: body.character_ids,
+  })
+  logTaskPayload('StoryboardAPI', 'create body', body)
+  await validateStoryboardBindings(body.episode_id, body.scene_id, body.character_ids, body.prop_ids)
+  const res = await db.insert(schema.storyboards).values({
+    episodeId: body.episode_id,
+    storyboardNumber: body.storyboard_number || 1,
+    title: body.title,
+    description: body.description,
+    sceneId: body.scene_id,
+    duration: body.duration || 10,
+    createdAt: ts,
+    updatedAt: ts,
+  })
+  await syncStoryboardCharacters(getInsertId(res), body.character_ids || [])
+  await syncStoryboardProps(getInsertId(res), body.prop_ids || [])
+  const [result] = await db.select().from(schema.storyboards)
+    .where(eq(schema.storyboards.id, getInsertId(res)))
+  logTaskSuccess('StoryboardAPI', 'create', {
+    storyboardId: result.id,
+    episodeId: result.episodeId,
+    shotNumber: result.storyboardNumber,
+  })
+  return created(c, {
+    ...toSnakeCase(result),
+    character_ids: await getStoryboardCharacterIds(result.id),
+    prop_ids: await getStoryboardPropIds(result.id),
+  })
+})
+
+// PUT /storyboards/:id
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [storyboard] = await db.select().from(schema.storyboards).where(eq(schema.storyboards.id, id))
+  if (!storyboard) return badRequest(c, '镜头不存在')
+  logTaskStart('StoryboardAPI', 'update', {
+    storyboardId: id,
+    episodeId: storyboard.episodeId,
+    fields: Object.keys(body),
+  })
+  logTaskPayload('StoryboardAPI', 'update body', body)
+
+  const fieldMap: Record<string, string> = {
+    title: 'title', description: 'description', shot_type: 'shotType',
+    angle: 'angle', movement: 'movement', duration: 'duration',
+    video_prompt: 'videoPrompt',
+    image_prompt: 'imagePrompt', scene_id: 'sceneId', location: 'location',
+    time: 'time', atmosphere: 'atmosphere', result: 'result',
+    bgm_prompt: 'bgmPrompt', sound_effect: 'soundEffect',
+    video_url: 'videoUrl',
+  }
+
+  const updates: Record<string, any> = { updatedAt: now() }
+  for (const [snakeKey, camelKey] of Object.entries(fieldMap)) {
+    if (snakeKey in body) updates[camelKey] = body[snakeKey]
+  }
+
+  await validateStoryboardBindings(
+    storyboard.episodeId,
+    'scene_id' in body ? body.scene_id : storyboard.sceneId,
+    'character_ids' in body ? body.character_ids : await getStoryboardCharacterIds(id),
+    'prop_ids' in body ? body.prop_ids : await getStoryboardPropIds(id),
+  )
+
+  await db.update(schema.storyboards).set(updates).where(eq(schema.storyboards.id, id))
+  if ('character_ids' in body) await syncStoryboardCharacters(id, body.character_ids || [])
+  if ('prop_ids' in body) await syncStoryboardProps(id, body.prop_ids || [])
+  logTaskSuccess('StoryboardAPI', 'update', {
+    storyboardId: id,
+    updatedFields: Object.keys(updates),
+    characterIds: body.character_ids,
+    propIds: body.prop_ids,
+  })
+  return success(c)
+})
+
+// DELETE /storyboards/:id
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  logTaskStart('StoryboardAPI', 'delete', { storyboardId: id })
+  await db.delete(schema.storyboardCharacters).where(eq(schema.storyboardCharacters.storyboardId, id))
+  await db.delete(schema.storyboardProps).where(eq(schema.storyboardProps.storyboardId, id))
+  await db.delete(schema.storyboards).where(eq(schema.storyboards.id, id))
+  logTaskSuccess('StoryboardAPI', 'delete', { storyboardId: id })
+  return success(c)
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/stylePresets.ts b/huobao-source/backend/src/routes/stylePresets.ts
new file mode 100644
index 0000000..ff2b3ca
--- /dev/null
+++ b/huobao-source/backend/src/routes/stylePresets.ts
@@ -0,0 +1,80 @@
+import { Hono } from 'hono'
+import { eq, and } from 'drizzle-orm'
+import { db, getInsertId, schema } from '../db/index.js'
+import { success, created, badRequest, notFound, now } from '../utils/response.js'
+import { toSnakeCase } from '../utils/transform.js'
+
+const app = new Hono()
+
+const VALUE_PATTERN = /^[a-z0-9][a-z0-9-]*$/
+
+// GET /style-presets — 默认只返回启用项，?all=1 返回全部
+app.get('/', async (c) => {
+  const all = c.req.query('all') === '1'
+  const rows = await db.select().from(schema.stylePresets)
+  const filtered = all ? rows : rows.filter(r => r.isActive)
+  filtered.sort((a, b) => (a.sortOrder || 0) - (b.sortOrder || 0) || a.id - b.id)
+  return success(c, filtered.map(r => toSnakeCase(r)))
+})
+
+// POST /style-presets — 新增风格预设
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  if (!body.name?.trim()) return badRequest(c, '风格名称必填')
+  if (!body.value?.trim()) return badRequest(c, '风格 key 必填')
+  if (!VALUE_PATTERN.test(body.value.trim())) return badRequest(c, '风格 key 仅支持小写字母、数字、中划线')
+  if (!body.prompt?.trim()) return badRequest(c, '提示词片段必填')
+
+  const value = body.value.trim()
+  const [dup] = await db.select().from(schema.stylePresets)
+    .where(eq(schema.stylePresets.value, value))
+  if (dup) return badRequest(c, '风格 key 已存在')
+
+  const ts = now()
+  const res = await db.insert(schema.stylePresets).values({
+    name: body.name.trim(),
+    value,
+    prompt: body.prompt.trim(),
+    description: body.description || null,
+    sortOrder: Number(body.sort_order ?? body.sortOrder ?? 0),
+    isActive: body.is_active === false || body.is_active === 0 ? false : true,
+    createdAt: ts,
+    updatedAt: ts,
+  })
+  const [row] = await db.select().from(schema.stylePresets)
+    .where(eq(schema.stylePresets.id, getInsertId(res)))
+  return created(c, toSnakeCase(row))
+})
+
+// PUT /style-presets/:id — 更新（value 创建后不可修改）
+app.put('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const body = await c.req.json()
+  const [row] = await db.select().from(schema.stylePresets)
+    .where(eq(schema.stylePresets.id, id))
+  if (!row) return notFound(c, '风格预设不存在')
+
+  const updates: Record<string, any> = { updatedAt: now() }
+  if (body.name !== undefined) updates.name = String(body.name).trim()
+  if (body.prompt !== undefined) updates.prompt = String(body.prompt).trim()
+  if (body.description !== undefined) updates.description = body.description || null
+  if (body.sort_order !== undefined || body.sortOrder !== undefined) {
+    updates.sortOrder = Number(body.sort_order ?? body.sortOrder)
+  }
+  if (body.is_active !== undefined || body.isActive !== undefined) {
+    const v = body.is_active ?? body.isActive
+    updates.isActive = !(v === false || v === 0)
+  }
+  await db.update(schema.stylePresets).set(updates)
+    .where(eq(schema.stylePresets.id, id))
+  return success(c)
+})
+
+// DELETE /style-presets/:id — 硬删除（已使用此风格的项目保留 key，无害）
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  await db.delete(schema.stylePresets).where(eq(schema.stylePresets.id, id))
+  return success(c)
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/tasks.ts b/huobao-source/backend/src/routes/tasks.ts
new file mode 100644
index 0000000..3d26834
--- /dev/null
+++ b/huobao-source/backend/src/routes/tasks.ts
@@ -0,0 +1,278 @@
+import { Hono } from 'hono'
+import { and, desc, eq } from 'drizzle-orm'
+import { db, schema } from '../db/index.js'
+import { success, created, badRequest } from '../utils/response.js'
+import { generateImage, generateVideo, recoverGenerationTask } from '../services/generation.js'
+import { safeTaskError } from '../services/video-download.js'
+import { taskRouting } from '../services/worker-routing.js'
+import { getActiveConfig, getConfigById } from '../services/ai.js'
+import { getDramaStylePrompt } from '../services/style-preset.js'
+import { resolveStoryboardVoiceReferences } from '../services/character-voice-references.js'
+import { logTaskError, logTaskPayload, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+const app = new Hono()
+
+app.post('/:id/recover', async c => {
+  try {
+    await recoverGenerationTask(Number(c.req.param('id')))
+    return success(c, { id: Number(c.req.param('id')) })
+  } catch (error) { return badRequest(c, safeTaskError(error)) }
+})
+
+app.get('/:id/diagnostics', async c => {
+  const [task] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, Number(c.req.param('id'))))
+  if (!task) return badRequest(c, '任务不存在')
+  return success(c, { id: task.id, upstreamTaskId: task.taskId, provider: task.provider, model: task.model,
+    status: task.status, stage: task.stage, errorCode: task.errorCode, error: safeTaskError(task.errorMsg),
+    hasResult: !!task.resultUrl, hasLocalFile: !!task.localPath, createdAt: task.createdAt, updatedAt: task.updatedAt,
+    version: process.env.HUOBAO_VERSION || 'development' })
+})
+
+type TaskType = 'image' | 'video'
+
+const WAN_MEDIA_TYPES = new Set([
+  'first_frame',
+  'last_frame',
+  'reference_image',
+  'reference_video',
+  'reference_audio',
+  'file',
+  'link',
+])
+
+/**
+ * 兼容项目原有扁平入参，也支持 Wan 3.0 官方 model/input/parameters 结构。
+ */
+function normalizeVideoRequest(body: any) {
+  const input = body.input && typeof body.input === 'object' && !Array.isArray(body.input) ? body.input : {}
+  const parameters = body.parameters && typeof body.parameters === 'object' && !Array.isArray(body.parameters)
+    ? body.parameters
+    : {}
+  const media = Array.isArray(input.media) ? input.media : []
+
+  const mediaUrls = (type: string) => media
+    .filter((item: any) => item?.type === type)
+    .map((item: any) => item?.url)
+
+  return {
+    ...body,
+    prompt: body.prompt ?? input.prompt ?? '',
+    reference_image_urls: body.reference_image_urls ?? mediaUrls('reference_image'),
+    reference_video_urls: body.reference_video_urls ?? mediaUrls('reference_video'),
+    reference_audio_urls: body.reference_audio_urls ?? mediaUrls('reference_audio'),
+    first_frame_url: body.first_frame_url ?? mediaUrls('first_frame')[0],
+    last_frame_url: body.last_frame_url ?? mediaUrls('last_frame')[0],
+    file_url: body.file_url ?? mediaUrls('file')[0],
+    link_url: body.link_url ?? mediaUrls('link')[0],
+    generate_audio: body.generate_audio ?? parameters.audio,
+    duration: body.duration ?? parameters.duration,
+    aspect_ratio: body.aspect_ratio ?? parameters.ratio,
+    resolution: body.resolution ?? parameters.resolution,
+    seed: body.seed ?? parameters.seed,
+    prompt_extend: body.prompt_extend ?? parameters.prompt_extend,
+    watermark: body.watermark ?? parameters.watermark,
+    official_media: media,
+  }
+}
+
+function validateVideoRequest(body: any, provider?: string): string | null {
+  for (const key of ['reference_image_urls', 'reference_video_urls', 'reference_audio_urls']) {
+    if (body[key] !== undefined && !Array.isArray(body[key])) return `${key} 必须为数组`
+    if (Array.isArray(body[key]) && body[key].some((url: any) => typeof url !== 'string' || !url.trim())) {
+      return `${key} 中的每个 URL 都必须为非空字符串`
+    }
+  }
+
+  if (body.official_media.length) {
+    for (const item of body.official_media) {
+      if (!item || typeof item !== 'object' || !WAN_MEDIA_TYPES.has(item.type) || typeof item.url !== 'string' || !item.url.trim()) {
+        return 'input.media 中的每项都必须包含官方支持的 type 和非空 url'
+      }
+    }
+    for (const type of ['first_frame', 'last_frame', 'file', 'link']) {
+      if (body.official_media.filter((item: any) => item.type === type).length > 1) {
+        return `Wan 3.0 input.media 中 ${type} 最多 1 项`
+      }
+    }
+  }
+
+  const imgs = body.reference_image_urls.length
+  const vids = body.reference_video_urls.length
+  const auds = body.reference_audio_urls.length
+  const first = Boolean(body.first_frame_url)
+  const last = Boolean(body.last_frame_url)
+  const file = Boolean(body.file_url)
+  const link = Boolean(body.link_url)
+
+  if ((provider || '').toLowerCase() === 'aliyun') {
+    if (imgs > 10 || vids > 5 || auds > 5) return 'Wan 3.0 参考素材超限：图片≤10、视频≤5、音频≤5'
+    if (last && !first) return 'Wan 3.0 尾帧必须与首帧同时传入'
+    if (file && link) return 'Wan 3.0 file 与 link 不能同时传入'
+    if ((first || last) && (imgs + vids + auds > 0 || file || link)) {
+      return 'Wan 3.0 的 first_frame/last_frame 不能与 reference_image/reference_video/reference_audio/file/link 混用'
+    }
+    const total = imgs + vids + auds + Number(first) + Number(last) + Number(file) + Number(link)
+    if (total > 20) return 'Wan 3.0 input.media 最多 20 项'
+  } else {
+    if (imgs > 9 || vids > 3 || auds > 3) return '参考素材超限：图片≤9、视频≤3、音频≤3'
+    if (auds > 0 && imgs + vids === 0) return '参考音频需要至少 1 个参考图片或视频'
+  }
+
+  if (!String(body.prompt || '').trim() && imgs + vids + auds === 0 && !first && !last && !file && !link) {
+    return '视频生成需要至少一个参考素材或 prompt'
+  }
+  return null
+}
+
+// POST /tasks — 发起生成任务（body.type: image | video）
+app.post('/', async (c) => {
+  const body = await c.req.json()
+  const type = body.type as TaskType
+  if (type !== 'image' && type !== 'video') return badRequest(c, 'type 必须为 image 或 video')
+
+  if (type === 'image') {
+    if (!body.prompt) return badRequest(c, '提示词必填')
+  }
+
+  const videoBody = type === 'video' ? normalizeVideoRequest(body) : null
+
+  try {
+    if (type === 'video' && body.storyboard_id) {
+      const [latest] = await db.select().from(schema.sysTask).where(and(
+        eq(schema.sysTask.type, 'video'), eq(schema.sysTask.storyboardId, Number(body.storyboard_id))
+      )).orderBy(desc(schema.sysTask.id)).limit(1)
+      if (latest?.status === 'processing' && body.replace_task_id !== latest.id) return badRequest(c, '该分镜已有运行中的任务，请等待结果')
+      if (latest?.status === 'failed' && body.force_new !== true) {
+        return badRequest(c, '请先恢复原任务；重新生成需明确确认可能再次计费')
+      }
+    }
+    // 请求显式指定 config_id（工作台模型下拉跨厂商切换）时优先；
+    // 未指定才回退到集锁定配置，避免锁定配置与所选模型错配（如锁定 Seedance 却传 MiniMax 模型名）
+    let configId: number | undefined = body.config_id
+    let episodeResolution: string | undefined
+    let storyboardDramaId: number | undefined
+    if (body.storyboard_id) {
+      const [sb] = await db.select().from(schema.storyboards).where(eq(schema.storyboards.id, Number(body.storyboard_id)))
+      if (sb) {
+        const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, sb.episodeId))
+        const locked = type === 'image' ? ep?.imageConfigId : ep?.videoConfigId
+        if (locked != null && configId == null) configId = locked
+        if (type === 'video' && ep?.resolution) episodeResolution = ep.resolution
+        storyboardDramaId = ep?.dramaId ?? undefined
+      }
+    }
+
+    if (type === 'video' && videoBody) {
+      const effectiveConfig = configId
+        ? (await getConfigById(configId)) ?? await getActiveConfig('video')
+        : await getActiveConfig('video')
+      const validationError = validateVideoRequest(videoBody, effectiveConfig?.provider)
+      if (validationError) return badRequest(c, validationError)
+      const voices = await resolveStoryboardVoiceReferences(String(videoBody.prompt || ''), Number(body.storyboard_id) || undefined, videoBody.reference_audio_urls)
+      videoBody.prompt = voices.prompt
+      videoBody.reference_audio_urls = voices.audioUrls
+      if (voices.hasVoiceReferences && videoBody.generate_audio === false) return badRequest(c, '引用角色音色时需要开启视频声音')
+      const referenceError = validateVideoRequest(videoBody, effectiveConfig?.provider)
+      if (referenceError) return badRequest(c, referenceError)
+    }
+
+    logTaskStart('TaskAPI', 'generate', {
+      type,
+      storyboardId: body.storyboard_id,
+      sceneId: body.scene_id,
+      characterId: body.character_id,
+      dramaId: body.drama_id,
+    })
+    logTaskPayload('TaskAPI', 'request body', body)
+
+    // 视频生成时把项目视觉风格词注入提示词最前方（与图片侧的自动注入保持一致口径）
+    let videoPrompt = videoBody?.prompt
+    if (type === 'video' && String(videoPrompt || '').trim()) {
+      const dramaId = body.drama_id ?? storyboardDramaId ?? null
+      const stylePrompt = await getDramaStylePrompt(dramaId)
+      if (stylePrompt) videoPrompt = `${stylePrompt}，\n${videoPrompt}`
+    }
+
+    const id = type === 'image'
+      ? await generateImage({
+        storyboardId: body.storyboard_id,
+        dramaId: body.drama_id,
+        sceneId: body.scene_id,
+        characterId: body.character_id,
+        prompt: body.prompt,
+        model: body.model,
+        size: body.size,
+        referenceImages: body.reference_images,
+        frameType: body.frame_type,
+        configId,
+      })
+      : await generateVideo({
+        gpu: body.gpu,
+        replaceTaskId: body.replace_task_id,
+        forceNew: body.force_new === true,
+        storyboardId: body.storyboard_id,
+        dramaId: body.drama_id,
+        prompt: videoPrompt,
+        model: videoBody!.model,
+        referenceMode: 'reference',
+        imageUrl: videoBody!.image_url,
+        firstFrameUrl: videoBody!.first_frame_url,
+        lastFrameUrl: videoBody!.last_frame_url,
+        referenceImageUrls: videoBody!.reference_image_urls,
+        referenceVideoUrls: videoBody!.reference_video_urls,
+        referenceAudioUrls: videoBody!.reference_audio_urls,
+        referenceFileUrl: videoBody!.file_url,
+        referenceLinkUrl: videoBody!.link_url,
+        generateAudio: videoBody!.generate_audio,
+        duration: videoBody!.duration,
+        aspectRatio: videoBody!.aspect_ratio,
+        resolution: episodeResolution || videoBody!.resolution,
+        seed: videoBody!.seed,
+        promptExtend: videoBody!.prompt_extend,
+        watermark: videoBody!.watermark,
+        configId,
+      })
+
+    const [record] = await db.select().from(schema.sysTask)
+      .where(eq(schema.sysTask.id, id))
+    logTaskSuccess('TaskAPI', 'generate', { taskId: id, type, provider: record?.provider })
+    return created(c, { ...record, routing: taskRouting(record) })
+  } catch (err: any) {
+    logTaskError('TaskAPI', 'generate', { type, error: err.message })
+    return badRequest(c, err.message)
+  }
+})
+
+// GET /tasks/:id — 轮询任务状态
+app.get('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const [row] = await db.select().from(schema.sysTask)
+    .where(eq(schema.sysTask.id, id))
+  return success(c, row ? { ...row, routing: taskRouting(row) } : null)
+})
+
+// GET /tasks — 按 type / storyboard_id / drama_id 过滤
+app.get('/', async (c) => {
+  const type = c.req.query('type')
+  const storyboardId = c.req.query('storyboard_id')
+  const dramaId = c.req.query('drama_id')
+
+  let rows = await db.select().from(schema.sysTask)
+
+  if (type) rows = rows.filter(r => r.type === type)
+  if (storyboardId) rows = rows.filter(r => r.storyboardId === Number(storyboardId))
+  if (dramaId) rows = rows.filter(r => r.dramaId === Number(dramaId))
+
+  return success(c, rows.map(row => ({ ...row, routing: taskRouting(row) })))
+})
+
+// DELETE /tasks/:id
+app.delete('/:id', async (c) => {
+  const id = Number(c.req.param('id'))
+  const [task] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id))
+  if (task?.status === 'processing') return badRequest(c, '任务运行中，暂不能删除')
+  await db.delete(schema.sysTask).where(eq(schema.sysTask.id, id))
+  return success(c)
+})
+
+export default app
diff --git a/huobao-source/backend/src/routes/upload.ts b/huobao-source/backend/src/routes/upload.ts
new file mode 100644
index 0000000..9a8053d
--- /dev/null
+++ b/huobao-source/backend/src/routes/upload.ts
@@ -0,0 +1,77 @@
+import { Hono } from 'hono'
+import { bodyLimit } from 'hono/body-limit'
+import { success, badRequest } from '../utils/response.js'
+import { saveUploadedFile, generateImageThumb } from '../utils/storage.js'
+import { AUDIO_MAX_BYTES, AudioUploadError, saveAudioUpload } from '../utils/audio-upload.js'
+
+const app = new Hono()
+
+// POST /upload/image
+app.post('/image', async (c) => {
+  const body = await c.req.parseBody()
+  const file = body['file']
+
+  if (!file || !(file instanceof File)) {
+    return badRequest(c, '文件必填')
+  }
+
+  const buffer = await file.arrayBuffer()
+  const path = await saveUploadedFile(buffer, 'uploads', file.name)
+  // 同步生成列表页缩略图，上传图与生图走同一套展示链路（失败不影响上传结果）
+  await generateImageThumb(path)
+  return success(c, { url: `/${path}`, path })
+})
+
+const VIDEO_EXT = new Set(['.mp4', '.mov', '.webm', '.m4v'])
+const VIDEO_MIME = new Set(['video/mp4', 'video/quicktime', 'video/webm', 'video/x-m4v'])
+const VIDEO_MAX = 50 * 1024 * 1024 // 50MB
+
+function extOf(name: string): string {
+  const i = name.lastIndexOf('.')
+  return i >= 0 ? name.slice(i).toLowerCase() : ''
+}
+
+async function saveMediaUpload(
+  c: any,
+  kind: 'video' | 'audio',
+  allowedExt: Set<string>,
+  allowedMime: Set<string>,
+  maxBytes: number,
+) {
+  const body = await c.req.parseBody()
+  const file = body['file']
+  if (!file || !(file instanceof File)) {
+    return badRequest(c, '文件必填')
+  }
+  const label = kind === 'video' ? '视频' : '音频'
+  const ext = extOf(file.name)
+  // MIME 可伪造，扩展名兜底；空 / octet-stream 视为未知类型，仅按扩展名校验
+  const mimeKnown = file.type && file.type !== 'application/octet-stream'
+  if (!allowedExt.has(ext) || (mimeKnown && !allowedMime.has(file.type))) {
+    return badRequest(c, `仅支持 ${Array.from(allowedExt).join('/')} 格式的${label}文件`)
+  }
+  const buffer = await file.arrayBuffer()
+  if (buffer.byteLength > maxBytes) {
+    return badRequest(c, `${label}文件大小不能超过 ${Math.round(maxBytes / 1024 / 1024)}MB`)
+  }
+  const path = await saveUploadedFile(buffer, 'uploads', file.name)
+  return success(c, { url: `/${path}`, path })
+}
+
+// POST /upload/video — 参考视频上传（Seedance 多模态参考用）
+app.post('/video', async (c) => saveMediaUpload(c, 'video', VIDEO_EXT, VIDEO_MIME, VIDEO_MAX))
+
+// POST /upload/audio — 参考音频上传（Seedance 多模态参考用）
+app.post('/audio', bodyLimit({ maxSize: AUDIO_MAX_BYTES + 64 * 1024,
+  onError: c => badRequest(c, '音频文件大小不能超过 20MB'),
+}), async (c) => {
+  try {
+    const body = await c.req.parseBody()
+    return success(c, await saveAudioUpload(body.file))
+  } catch (error) {
+    if (error instanceof AudioUploadError) return badRequest(c, error.message)
+    throw error
+  }
+})
+
+export default app
diff --git a/huobao-source/backend/src/services/adapters/aliyun-wan-video.ts b/huobao-source/backend/src/services/adapters/aliyun-wan-video.ts
new file mode 100644
index 0000000..cd1b6b4
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/aliyun-wan-video.ts
@@ -0,0 +1,262 @@
+/**
+ * 阿里云百炼万相 Wan 3.0 视频生成 Adapter。
+ *
+ * 官方协议：
+ * - POST /api/v1/services/aigc/video-generation/video-synthesis
+ * - GET  /api/v1/tasks/{task_id}
+ * - 仅支持 wan3.0-video-prime / wan3.0-video
+ * - 请求体为 { model, input: { prompt, media }, parameters }
+ * - 异步响应为 { output: { task_id, task_status }, request_id }
+ */
+import type {
+  AIConfig,
+  ProviderRequest,
+  VideoGenerationRecord,
+  VideoGenResponse,
+  VideoPollResponse,
+  VideoProviderAdapter,
+} from './types'
+import { joinProviderUrl } from './url'
+
+const SUPPORTED_MODELS = new Set(['wan3.0-video-prime', 'wan3.0-video'])
+const DEFAULT_MODEL = 'wan3.0-video'
+const PROMPT_MAX_CHARS = 20_000
+const MAX_SEED = 2_147_483_647
+const REF_LIMITS = { images: 10, videos: 5, audios: 5, total: 20 } as const
+const VALID_RATIOS = new Set(['adaptive', '16:9', '4:3', '1:1', '3:4', '9:16'])
+const VALID_RESOLUTIONS = new Set(['480P', '720P', '1080P'])
+
+type WanMediaType =
+  | 'first_frame'
+  | 'last_frame'
+  | 'reference_image'
+  | 'reference_video'
+  | 'reference_audio'
+  | 'file'
+  | 'link'
+
+interface WanMedia {
+  type: WanMediaType
+  url: string
+}
+
+function parseUrlArray(raw?: string | null): string[] {
+  if (!raw) return []
+  try {
+    const value = JSON.parse(raw)
+    if (!Array.isArray(value)) return []
+    return value
+      .filter((url): url is string => typeof url === 'string')
+      .map(url => url.trim())
+      .filter(Boolean)
+  } catch {
+    return []
+  }
+}
+
+function cleanUrl(value?: string | null): string {
+  return String(value || '').trim()
+}
+
+function validateMediaUrl(type: WanMediaType, url: string) {
+  const isWebUrl = /^https?:\/\//i.test(url)
+  const isOssUrl = /^oss:\/\//i.test(url)
+  const isImageData = /^data:image\/(?:jpeg|jpg|png|bmp|webp);base64,/i.test(url)
+  if (type === 'first_frame' || type === 'last_frame' || type === 'reference_image') {
+    if (isWebUrl || isOssUrl || isImageData) return
+    throw new Error(`Wan 3.0 ${type} 需要 HTTP(S)/OSS 图片 URL 或官方支持的图片 Base64`)
+  }
+  if (type === 'link') {
+    if (isWebUrl) return
+    throw new Error('Wan 3.0 link 仅支持无需登录的 HTTP(S) 公开网页')
+  }
+  if (isWebUrl || isOssUrl) return
+  throw new Error(`Wan 3.0 ${type} 仅支持 HTTP(S) 或 OSS URL`)
+}
+
+function booleanValue(value: number | boolean | null | undefined, fallback: boolean): boolean {
+  if (value === null || value === undefined) return fallback
+  return value !== false && value !== 0
+}
+
+function errorMessage(result: any, fallback: string): string {
+  const output = result?.output && typeof result.output === 'object' ? result.output : {}
+  const code = output.code || result?.code
+  const message = output.message || result?.message || fallback
+  const requestId = result?.request_id
+  return `${code ? `[${code}] ` : ''}${message}${requestId ? ` (request_id: ${requestId})` : ''}`
+}
+
+export class AliyunWanVideoAdapter implements VideoProviderAdapter {
+  provider = 'aliyun'
+
+  buildGenerateRequest(config: AIConfig, record: VideoGenerationRecord): ProviderRequest {
+    const model = cleanUrl(record.model || config.model || DEFAULT_MODEL)
+    if (!SUPPORTED_MODELS.has(model)) {
+      throw new Error(`Wan 3.0 仅支持 wan3.0-video-prime 或 wan3.0-video，当前: ${model}`)
+    }
+
+    // 官方对超过 20000 字符的部分自动截断；同时将项目内部 @图片N 标记转为官方的 图N 引用。
+    const prompt = cleanUrl(record.prompt).replace(/@图片(\d+)/g, '图$1').slice(0, PROMPT_MAX_CHARS)
+
+    const refImages = parseUrlArray(record.referenceImageUrls)
+    const refVideos = parseUrlArray(record.referenceVideoUrls)
+    const refAudios = parseUrlArray(record.referenceAudioUrls)
+    const firstFrame = cleanUrl(record.firstFrameUrl || record.imageUrl)
+    const lastFrame = cleanUrl(record.lastFrameUrl)
+    const file = cleanUrl(record.referenceFileUrl)
+    const link = cleanUrl(record.referenceLinkUrl)
+
+    this.validateMedia({ refImages, refVideos, refAudios, firstFrame, lastFrame, file, link })
+
+    const media: WanMedia[] = []
+    if (firstFrame) media.push({ type: 'first_frame', url: firstFrame })
+    if (lastFrame) media.push({ type: 'last_frame', url: lastFrame })
+    for (const url of refImages) media.push({ type: 'reference_image', url })
+    for (const url of refVideos) media.push({ type: 'reference_video', url })
+    for (const url of refAudios) media.push({ type: 'reference_audio', url })
+    if (file) media.push({ type: 'file', url: file })
+    if (link) media.push({ type: 'link', url: link })
+    for (const item of media) validateMediaUrl(item.type, item.url)
+
+    if (!prompt && media.length === 0) {
+      throw new Error('Wan 3.0 的 input.prompt 和 input.media 至少需要提供一项')
+    }
+
+    const input: { prompt?: string; media?: WanMedia[] } = {}
+    if (prompt) input.prompt = prompt
+    if (media.length) input.media = media
+
+    const parameters: Record<string, string | number | boolean> = {
+      resolution: this.normalizeResolution(record.resolution),
+      ratio: this.normalizeRatio(record.aspectRatio),
+      duration: this.normalizeDuration(record.duration),
+      audio: booleanValue(record.generateAudio, true),
+      prompt_extend: booleanValue(record.promptExtend, true),
+      watermark: booleanValue(record.watermark, false),
+    }
+
+    if (record.seed !== null && record.seed !== undefined) {
+      const seed = Number(record.seed)
+      if (!Number.isInteger(seed) || (seed !== -1 && (seed < 0 || seed > MAX_SEED))) {
+        throw new Error(`Wan 3.0 seed 必须为 -1 或 0~${MAX_SEED} 的整数`)
+      }
+      parameters.seed = seed
+    }
+
+    return {
+      url: joinProviderUrl(config.baseUrl, '/api/v1', '/services/aigc/video-generation/video-synthesis'),
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${config.apiKey}`,
+        'X-DashScope-Async': 'enable',
+      },
+      body: { model, input, parameters },
+    }
+  }
+
+  parseGenerateResponse(result: any): VideoGenResponse {
+    const taskId = result?.output?.task_id
+    if (taskId) return { isAsync: true, taskId: String(taskId) }
+    throw new Error(errorMessage(result, 'Wan 3.0 响应中缺少 output.task_id'))
+  }
+
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest {
+    return {
+      url: joinProviderUrl(config.baseUrl, '/api/v1', `/tasks/${encodeURIComponent(taskId)}`),
+      method: 'GET',
+      headers: { 'Authorization': `Bearer ${config.apiKey}` },
+      body: undefined,
+    }
+  }
+
+  parsePollResponse(result: any): VideoPollResponse {
+    const output = result?.output && typeof result.output === 'object' ? result.output : {}
+    switch (output.task_status) {
+      case 'PENDING':
+        return { status: 'pending' }
+      case 'RUNNING':
+        return { status: 'processing' }
+      case 'SUCCEEDED':
+        if (!output.video_url) {
+          return { status: 'failed', error: errorMessage(result, 'Wan 3.0 任务成功但响应中缺少 output.video_url') }
+        }
+        {
+          const duration = Number(result?.usage?.output_video_duration ?? result?.usage?.duration)
+          return {
+            status: 'completed',
+            videoUrl: output.video_url,
+            ...(Number.isFinite(duration) ? { duration } : {}),
+          }
+        }
+      case 'FAILED':
+        return { status: 'failed', error: errorMessage(result, 'Wan 3.0 视频生成失败') }
+      case 'CANCELED':
+        return { status: 'failed', error: errorMessage(result, 'Wan 3.0 任务已取消') }
+      case 'UNKNOWN':
+        return { status: 'failed', error: errorMessage(result, 'Wan 3.0 任务不存在或已超过 24 小时查询有效期') }
+      default:
+        if (result?.code || result?.message || output.code || output.message) {
+          return { status: 'failed', error: errorMessage(result, 'Wan 3.0 任务查询失败') }
+        }
+        return { status: 'processing' }
+    }
+  }
+
+  extractVideoUrl(result: any): string | null {
+    return result?.output?.video_url || null
+  }
+
+  private validateMedia(input: {
+    refImages: string[]
+    refVideos: string[]
+    refAudios: string[]
+    firstFrame: string
+    lastFrame: string
+    file: string
+    link: string
+  }) {
+    const { refImages, refVideos, refAudios, firstFrame, lastFrame, file, link } = input
+    if (refImages.length > REF_LIMITS.images || refVideos.length > REF_LIMITS.videos || refAudios.length > REF_LIMITS.audios) {
+      throw new Error(`Wan 3.0 参考素材超限：图片≤${REF_LIMITS.images}、视频≤${REF_LIMITS.videos}、音频≤${REF_LIMITS.audios}`)
+    }
+    if (lastFrame && !firstFrame) throw new Error('Wan 3.0 尾帧必须与首帧同时传入')
+    if (file && link) throw new Error('Wan 3.0 file 与 link 不能同时传入')
+
+    const hasFrameMode = Boolean(firstFrame || lastFrame)
+    const hasReferenceMode = Boolean(refImages.length || refVideos.length || refAudios.length || file || link)
+    if (hasFrameMode && hasReferenceMode) {
+      throw new Error('Wan 3.0 的 first_frame/last_frame 不能与 reference_image/reference_video/reference_audio/file/link 混用')
+    }
+
+    const total = refImages.length + refVideos.length + refAudios.length + (firstFrame ? 1 : 0)
+      + (lastFrame ? 1 : 0) + (file ? 1 : 0) + (link ? 1 : 0)
+    if (total > REF_LIMITS.total) throw new Error(`Wan 3.0 input.media 最多 ${REF_LIMITS.total} 项`)
+  }
+
+  private normalizeDuration(duration?: number | null): number {
+    if (duration === null || duration === undefined) return 5
+    const value = Number(duration)
+    if (!Number.isInteger(value) || (value !== -1 && (value < 2 || value > 30))) {
+      throw new Error('Wan 3.0 duration 必须为 -1 或 2~30 的整数')
+    }
+    return value
+  }
+
+  private normalizeResolution(resolution?: string | null): string {
+    const value = cleanUrl(resolution).toUpperCase() || '1080P'
+    if (!VALID_RESOLUTIONS.has(value)) {
+      throw new Error('Wan 3.0 resolution 仅支持 480P、720P 或 1080P')
+    }
+    return value
+  }
+
+  private normalizeRatio(ratio?: string | null): string {
+    const value = cleanUrl(ratio) || 'adaptive'
+    if (!VALID_RATIOS.has(value)) {
+      throw new Error('Wan 3.0 ratio 仅支持 adaptive、16:9、4:3、1:1、3:4 或 9:16')
+    }
+    return value
+  }
+}
diff --git a/huobao-source/backend/src/services/adapters/gemini-image.ts b/huobao-source/backend/src/services/adapters/gemini-image.ts
new file mode 100644
index 0000000..dfda373
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/gemini-image.ts
@@ -0,0 +1,199 @@
+/**
+ * Gemini 图片生成 Adapter
+ * 认证: URL Query 参数 ?key= 或 Header x-goog-api-key
+ * 请求: Google REST 风格的 contents[].parts[] 结构
+ * 响应: base64 编码在 inlineData.data 中，无 URL
+ */
+import type {
+  ImageProviderAdapter,
+  ProviderRequest,
+  AIConfig,
+  ImageGenerationRecord,
+  ImageGenResponse,
+  ImagePollResponse,
+} from './types'
+import { joinProviderUrl } from './url'
+import { parseDataUrl } from '../../utils/storage.js'
+
+export class GeminiImageAdapter implements ImageProviderAdapter {
+  provider = 'gemini'
+
+  buildGenerateRequest(config: AIConfig, record: ImageGenerationRecord): ProviderRequest {
+    // Gemini 模型名格式: "models/gemini-3-pro-image" 或直接 "gemini-3-pro-image"
+    const modelName = record.model || config.model || 'gemini-3-pro-image'
+    // interactions 端点仅官方 API 可用;中转站(new-api 类)普遍未配置该端点类型,
+    // 会报 "endpointType=GEMINI_INTERACTIONS 未启用",此类端点回退到 generateContent 分支
+    const isGemini3Image = /gemini-3.*image/.test(modelName)
+    const isOfficialHost = /generativelanguage\.googleapis\.com/.test(config.baseUrl || '')
+
+    if (isGemini3Image && isOfficialHost) {
+      return {
+        url: joinProviderUrl(config.baseUrl, '/v1beta', '/interactions'),
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-goog-api-key': config.apiKey,
+        },
+        body: {
+          model: modelName.replace(/^models\//, ''),
+          input: record.prompt || 'Generate an image',
+          response_format: {
+            type: 'image',
+            aspect_ratio: this.parseAspectRatio(record.size),
+            image_size: this.parseImageSize(record.size),
+          },
+        },
+      }
+    }
+
+    const model = modelName.startsWith('models/') ? modelName : `models/${modelName}`
+
+    // Google REST 风格请求体
+    const parts: any[] = []
+    if (record.referenceImages) {
+      try {
+        const refs = JSON.parse(record.referenceImages)
+        for (const ref of refs) {
+          const parsed = parseDataUrl(String(ref || ''))
+          if (parsed) {
+            parts.push({
+              inline_data: {
+                mime_type: parsed.mimeType,
+                data: parsed.data,
+              },
+            })
+          }
+        }
+      } catch {}
+    }
+    parts.push({ text: record.prompt || 'Generate an image' })
+
+    const body = {
+      contents: [{
+        parts,
+      }],
+      generationConfig: {
+        responseModalities: ['IMAGE', 'TEXT'],
+        imageConfig: {
+          // 解析 size 如 "1920x1080" -> aspectRatio
+          aspectRatio: this.parseAspectRatio(record.size),
+          imageSize: this.parseImageSize(record.size),
+        },
+      },
+    }
+
+    const url = new URL(joinProviderUrl(config.baseUrl, '/v1beta', `/${model}:generateContent`))
+    url.searchParams.set('key', config.apiKey)
+
+    return {
+      url: url.toString(),
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-goog-api-key': config.apiKey,
+      },
+      body,
+    }
+  }
+
+  parseGenerateResponse(result: any): ImageGenResponse {
+    const firstCandidate = result?.candidates?.[0]
+    const finishReason = firstCandidate?.finishReason || firstCandidate?.finish_reason
+    const finishMessage = firstCandidate?.finishMessage || firstCandidate?.finish_message
+
+    if (finishReason && finishReason !== 'STOP' && finishReason !== 'MAX_TOKENS') {
+      throw new Error(finishMessage || `Gemini generation stopped: ${finishReason}`)
+    }
+
+    if (this.extractImageUrl(result)) {
+      return { isAsync: false, imageUrl: this.extractImageUrl(result) || undefined }
+    }
+
+    if (this.extractImageBase64(result)) {
+      return { isAsync: false, imageUrl: undefined }
+    }
+
+    if (result.task_id || result.id) {
+      return { isAsync: true, taskId: result.task_id || result.id }
+    }
+
+    if (result.error) {
+      throw new Error(result.error.message || 'Gemini generation failed')
+    }
+    throw new Error('No image data in Gemini response')
+  }
+
+  parsePollResponse(result: any): ImagePollResponse {
+    // Gemini 是同步的，通常不会走到这里
+    return { status: 'completed' }
+  }
+
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest {
+    // Gemini 不需要轮询，但实现接口以保持一致
+    const url = new URL(joinProviderUrl(config.baseUrl, '/v1beta', `/${taskId}`))
+    url.searchParams.set('key', config.apiKey)
+    return {
+      url: url.toString(),
+      method: 'GET',
+      headers: {
+        'x-goog-api-key': config.apiKey,
+      },
+      body: undefined,
+    }
+  }
+
+  extractImageUrl(result: any): string | null {
+    return result?.data?.[0]?.url
+      || result?.image_url
+      || result?.url
+      || null
+  }
+
+  extractImageBase64(result: any): { data: string; mimeType: string } | null {
+    const b64 = result?.data?.[0]?.b64_json
+    if (b64) {
+      return { data: b64, mimeType: 'image/png' }
+    }
+
+    if (result?.output_image?.data) {
+      return {
+        data: result.output_image.data,
+        mimeType: result.output_image.mime_type || result.output_image.mimeType || 'image/png',
+      }
+    }
+
+    const parts = result.candidates?.[0]?.content?.parts || []
+    for (const part of parts) {
+      if (part.inlineData || part.inline_data) {
+        const inline = part.inlineData || part.inline_data
+        return {
+          data: inline.data,
+          mimeType: inline.mimeType || inline.mime_type || 'image/png',
+        }
+      }
+    }
+    return null
+  }
+
+  private parseAspectRatio(size?: string | null): string {
+    if (!size) return '16:9'
+    const [w, h] = size.split('x').map(Number)
+    if (!w || !h) return '16:9'
+    const gcd = this.gcd(w, h)
+    return `${w / gcd}:${h / gcd}`
+  }
+
+  private parseImageSize(size?: string | null): string {
+    if (!size) return '1K'
+    const [w] = size.split('x').map(Number)
+    if (!w) return '1K'
+    if (w >= 2048) return '4K'
+    if (w >= 1024) return '2K'
+    if (w >= 512) return '1K'
+    return '512'
+  }
+
+  private gcd(a: number, b: number): number {
+    return b === 0 ? a : this.gcd(b, a % b)
+  }
+}
diff --git a/huobao-source/backend/src/services/adapters/local-video.ts b/huobao-source/backend/src/services/adapters/local-video.ts
new file mode 100644
index 0000000..ca663e0
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/local-video.ts
@@ -0,0 +1,24 @@
+import { MiniMaxVideoAdapter } from './minimax-video'
+import type { AIConfig, ProviderRequest, VideoGenerationRecord } from './types'
+
+const MODELS = new Set(['MiniMax-H3', 'MiniMax-H3-Hybrid', 'MiniMax-H3-R2V-4Step', 'LTX-2.3', 'LTX-2.3-Text-Preserve', 'Wan2.2-I2V', 'MiniMax-H3-VDN-H3'])
+
+/** Local workers share the async H3 protocol; preserve each model and resolution. */
+export class LocalVideoAdapter extends MiniMaxVideoAdapter {
+  override provider = 'localvideo'
+  override buildGenerateRequest(config: AIConfig, record: VideoGenerationRecord): ProviderRequest {
+    const model = record.model || config.model || 'MiniMax-H3'
+    if (!MODELS.has(model)) throw new Error(`本地视频任务池不支持模型：${model}`)
+    if (record.referenceFileUrl || record.referenceLinkUrl) throw new Error('本地视频暂不支持 file / link 参考素材')
+    const request = super.buildGenerateRequest(config, { ...record, model: 'MiniMax-H3' })
+    const body = request.body as Record<string, unknown>
+    const resolution = String(record.resolution || '768P').toUpperCase()
+    if (!['480P', '720P', '768P', '1080P', '2K', '4K'].includes(resolution)) throw new Error('不支持的本地视频分辨率')
+    if (resolution === '4K' && model !== 'MiniMax-H3-VDN-H3') throw new Error('4K 需要 VDN-H3 高清制作模型')
+    body.model = model
+    body.resolution = resolution
+    if (config.gpu && config.gpu !== 'auto') body.gpu = config.gpu
+    if (record.seed != null) body.seed = record.seed
+    return request
+  }
+}
diff --git a/huobao-source/backend/src/services/adapters/minimax-video.ts b/huobao-source/backend/src/services/adapters/minimax-video.ts
new file mode 100644
index 0000000..ab4aa39
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/minimax-video.ts
@@ -0,0 +1,176 @@
+/**
+ * MiniMax H3 视频生成 Adapter
+ * 端点: POST /v2/video_generation -> { task_id }
+ * 轮询: GET  /v2/query/video_generation/{task_id} -> { task: { status, content.url, error } }
+ *
+ * 仅支持 MiniMax-H3 系列模型。content[] 多模态结构:
+ * - text           提示词（必填，≤7000 字符）
+ * - image_url      role: first_frame / last_frame / reference_image（参考图 ≤9）
+ * - video_url      role: reference_video（≤3）
+ * - audio_url      参考音频（≤3），混合总数 ≤12
+ *
+ * 注意:
+ * - 文生视频 ratio 必填且不能为 adaptive；有首帧图（图生视频）时恒为 adaptive，省略 ratio
+ * - H3 原生音画同步生成，官方文档无独立 generate_audio 开关，该字段忽略
+ */
+import type {
+  VideoProviderAdapter,
+  ProviderRequest,
+  AIConfig,
+  VideoGenerationRecord,
+  VideoGenResponse,
+  VideoPollResponse,
+} from './types'
+import { joinProviderUrl } from './url'
+import { parseWorkerRouting } from '../worker-routing'
+
+/** 仅支持 MiniMax-H3 系列（前缀匹配，兼容未来 H3.x 变体） */
+const H3_MODEL_PREFIX = 'minimax-h3'
+const DEFAULT_MODEL = 'MiniMax-H3'
+
+/** 多模态参考素材上限：图片 9、视频 3、音频 3，混合总数 12 */
+const REF_LIMITS = { images: 9, videos: 3, audios: 3, total: 12 } as const
+
+const PROMPT_MAX_CHARS = 7000
+
+/** MiniMax 支持的宽高比 */
+const VALID_RATIOS = new Set(['16:9', '9:16', '1:1', '4:3', '3:4', '21:9'])
+
+function parseUrlArray(raw?: string | null): string[] {
+  if (!raw) return []
+  try {
+    const arr = JSON.parse(raw)
+    return Array.isArray(arr) ? arr.filter((u) => typeof u === 'string' && u.trim()) : []
+  } catch {
+    return []
+  }
+}
+
+export class MiniMaxVideoAdapter implements VideoProviderAdapter {
+  provider = 'minimax'
+
+  buildGenerateRequest(config: AIConfig, record: VideoGenerationRecord): ProviderRequest {
+    const model = record.model || config.model || DEFAULT_MODEL
+    if (!model.toLowerCase().startsWith(H3_MODEL_PREFIX)) {
+      throw new Error(`仅支持 MiniMax H3 系列模型（MiniMax-H3*），当前: ${model}`)
+    }
+
+    const prompt = (record.prompt || '').trim()
+    const refImages = parseUrlArray(record.referenceImageUrls)
+    const refVideos = parseUrlArray(record.referenceVideoUrls)
+    const refAudios = parseUrlArray(record.referenceAudioUrls)
+    const firstFrame = (record.firstFrameUrl || record.imageUrl || '').trim()
+    const lastFrame = (record.lastFrameUrl || '').trim()
+
+    if (!prompt) throw new Error('MiniMax H3 要求必须提供提示词（text content）')
+    if (prompt.length > PROMPT_MAX_CHARS) {
+      throw new Error(`提示词超长：MiniMax H3 上限 ${PROMPT_MAX_CHARS} 字符，当前 ${prompt.length}`)
+    }
+
+    const totalRefs = refImages.length + refVideos.length + refAudios.length + (firstFrame ? 1 : 0) + (lastFrame ? 1 : 0)
+    if (refImages.length > REF_LIMITS.images || refVideos.length > REF_LIMITS.videos || refAudios.length > REF_LIMITS.audios || totalRefs > REF_LIMITS.total) {
+      throw new Error(`参考素材超限：图片≤${REF_LIMITS.images}、视频≤${REF_LIMITS.videos}、音频≤${REF_LIMITS.audios}、总数≤${REF_LIMITS.total}`)
+    }
+
+    const content: any[] = [{ type: 'text', text: prompt }]
+    if (firstFrame) content.push({ type: 'image_url', image_url: { url: firstFrame }, role: 'first_frame' })
+    if (lastFrame) content.push({ type: 'image_url', image_url: { url: lastFrame }, role: 'last_frame' })
+    for (const url of refImages) {
+      content.push({ type: 'image_url', image_url: { url }, role: 'reference_image' })
+    }
+    for (const url of refVideos) {
+      content.push({ type: 'video_url', video_url: { url }, role: 'reference_video' })
+    }
+    for (const url of refAudios) {
+      content.push({ type: 'audio_url', audio_url: { url }, role: 'reference_audio' })
+    }
+
+    const body: any = {
+      model,
+      content,
+      duration: this.normalizeDuration(record.duration),
+      resolution: this.normalizeResolution(record.resolution),
+    }
+    if (config.gpu && config.gpu !== 'auto') body.gpu = config.gpu
+
+    // 图生视频（有首帧）ratio 恒为 adaptive，省略；文生视频 ratio 必填
+    if (!firstFrame) {
+      const ratio = (record.aspectRatio || '').trim()
+      body.ratio = VALID_RATIOS.has(ratio) ? ratio : '16:9'
+    }
+
+    return {
+      url: joinProviderUrl(config.baseUrl, '/v2', '/video_generation'),
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body,
+    }
+  }
+
+  parseGenerateResponse(result: any): VideoGenResponse {
+    const taskId = result.task_id ?? result.task?.id
+    const state = result.task?.status ?? result.status
+    const videoUrl = result.task?.content?.url || result.content?.url || result.video_url
+    if (videoUrl && (!state || state === 'succeeded')) {
+      return { isAsync: false, videoUrl, taskId: taskId == null ? undefined : String(taskId), duration: result.task?.duration ?? result.duration }
+    }
+    if (taskId != null) return { isAsync: true, taskId: String(taskId), routing: parseWorkerRouting(result.routing) }
+    throw new Error('No task_id or video url in response')
+  }
+
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest {
+    return {
+      url: joinProviderUrl(config.baseUrl, '/v2', `/query/video_generation/${taskId}`),
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body: undefined,
+    }
+  }
+
+  parsePollResponse(result: any): VideoPollResponse {
+    // 官方响应为 { task: { status, content: { url }, error } }，兼容顶层平铺
+    const task = result.task && typeof result.task === 'object' ? result.task : result
+    const status = task.status
+
+    if (status === 'succeeded') {
+      return {
+        status: 'completed',
+        videoUrl: task.content?.url || task.video_url,
+        duration: task.duration,
+        routing: parseWorkerRouting(task.routing),
+      }
+    }
+    if (status === 'failed' || status === 'cancelled') {
+      const err = task.error
+      const msg = typeof err === 'string' ? err : (err?.message || JSON.stringify(err) || 'Video generation failed')
+      const code = err && typeof err === 'object' && err.code ? `[${err.code}] ` : ''
+      return { status: 'failed', error: `${code}${msg}` }
+    }
+    const workerStage = ['queued', 'running', 'checking', 'missing'].includes(task.worker_state) ? task.worker_state : undefined
+    return { status: 'processing', stage: task.delivery?.status === 'transferring' ? 'transferring' : workerStage, routing: parseWorkerRouting(task.routing) }
+  }
+
+  extractVideoUrl(result: any): string | null {
+    const task = result.task && typeof result.task === 'object' ? result.task : result
+    return task.content?.url || task.video_url || null
+  }
+
+  private normalizeDuration(duration?: number | null): number {
+    const parsed = Math.round(Number(duration || 5))
+    if (!Number.isFinite(parsed)) return 5
+    // MiniMax H3 支持 4-15 秒
+    return Math.min(15, Math.max(4, parsed))
+  }
+
+  /** MiniMax 仅 768P / 2K 两档；项目侧 480p/720p 统一归到 768P，1080p/2K 归到 2K */
+  private normalizeResolution(resolution?: string | null): string {
+    const r = (resolution || '').toLowerCase()
+    if (r === '2k' || r === '1080p') return '2K'
+    return '768P'
+  }
+}
diff --git a/huobao-source/backend/src/services/adapters/openai-image.ts b/huobao-source/backend/src/services/adapters/openai-image.ts
new file mode 100644
index 0000000..e43bf9e
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/openai-image.ts
@@ -0,0 +1,194 @@
+/**
+ * OpenAI DALL-E 图片生成 Adapter
+ * 文生图端点: /v1/images/generations (注意 /v1 前缀)
+ * 参考生图端点: /v1/images/edits (multipart/form-data, image[] 文件上传)
+ * 响应格式: { data: [{ url: "..." }] } 或 { data: [{ b64_json: "..." }] }
+ */
+import type {
+  ImageProviderAdapter,
+  ProviderRequest,
+  AIConfig,
+  ImageGenerationRecord,
+  ImageGenResponse,
+  ImagePollResponse,
+} from './types'
+import { joinProviderUrl } from './url'
+import { parseDataUrl } from '../../utils/storage.js'
+
+export class OpenAIImageAdapter implements ImageProviderAdapter {
+  provider = 'openai'
+
+  buildGenerateRequest(config: AIConfig, record: ImageGenerationRecord): ProviderRequest {
+    const model = record.model || config.model || 'gpt-image-2'
+    const isGptImage = model.startsWith('gpt-image-')
+    const isGptImage2 = model === 'gpt-image-2'
+    const size = isGptImage2
+      ? this.normalizeGptImage2Size(record.size)
+      : isGptImage
+      ? this.normalizeGptImageSize(record.size)
+      : record.size || '1024x1024'
+
+    // 有参考图 → 走 edits（multipart 上传图片文件）；无参考图 → 纯文生图 generations
+    const refs = this.parseReferenceImages(record.referenceImages)
+    if (refs.length) {
+      return this.buildEditsRequest(config, model, record.prompt, size, refs)
+    }
+
+    const body: any = {
+      model,
+      prompt: record.prompt,
+      size,
+      n: 1,
+    }
+
+    if (!isGptImage) {
+      body.response_format = 'url'
+    }
+    if (model === 'qwen_image_2_1' && config.gpu && config.gpu !== 'auto') body.gpu = config.gpu
+
+    return {
+      url: joinProviderUrl(config.baseUrl, '/v1', '/images/generations'),
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body,
+    }
+  }
+
+  private parseReferenceImages(raw?: string | null): string[] {
+    if (!raw) return []
+    try {
+      const parsed = JSON.parse(raw)
+      return Array.isArray(parsed) ? parsed.map(String).filter(Boolean) : []
+    } catch {
+      return []
+    }
+  }
+
+  /**
+   * /v1/images/edits：参考图以 multipart/form-data 的 image[] 文件上传。
+   * 参考图在 generation.ts 已归一化为 data URL（本地压缩 / 远程下载），
+   * 这里只做 base64 → Blob 的转换；multipart 边界由 fetch 自动设置，不要手填 Content-Type。
+   */
+  private buildEditsRequest(
+    config: AIConfig,
+    model: string,
+    prompt: string | null | undefined,
+    size: string,
+    refs: string[],
+  ): ProviderRequest {
+    const form = new FormData()
+    form.append('model', model)
+    form.append('prompt', prompt || '')
+    form.append('size', size)
+    form.append('n', '1')
+    if (model === 'qwen_image_2_1' && config.gpu && config.gpu !== 'auto') form.append('gpu', config.gpu)
+
+    let appended = 0
+    for (const ref of refs) {
+      const parsed = parseDataUrl(ref)
+      if (!parsed) continue
+      const buffer = Buffer.from(parsed.data, 'base64')
+      const ext = parsed.mimeType === 'image/png' ? 'png' : parsed.mimeType === 'image/webp' ? 'webp' : 'jpg'
+      form.append('image[]', new Blob([buffer], { type: parsed.mimeType }), `reference-${++appended}.${ext}`)
+    }
+    if (!appended) {
+      throw new Error('参考图片无法解析为可上传的文件（仅支持 data URL 形式的图片）')
+    }
+
+    return {
+      url: joinProviderUrl(config.baseUrl, '/v1', '/images/edits'),
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body: form,
+    }
+  }
+
+  private normalizeGptImageSize(size?: string | null): string {
+    const allowed = ['1024x1024', '1536x1024', '1024x1536', 'auto']
+    if (!size) return '1024x1024'
+
+    const normalized = size.toLowerCase()
+    if (allowed.includes(normalized)) return normalized
+
+    const [width, height] = normalized.split('x').map(Number)
+    if (!width || !height) return 'auto'
+    if (width === height) return '1024x1024'
+    return width > height ? '1536x1024' : '1024x1536'
+  }
+
+  private normalizeGptImage2Size(size?: string | null): string {
+    if (!size) return '1024x1024'
+    const normalized = size.toLowerCase()
+    if (normalized === 'auto') return 'auto'
+
+    const [rawWidth, rawHeight] = normalized.split('x').map(Number)
+    if (!rawWidth || !rawHeight) return 'auto'
+
+    const width = this.roundToMultiple(Math.min(4096, Math.max(256, rawWidth)), 16)
+    const height = this.roundToMultiple(Math.min(4096, Math.max(256, rawHeight)), 16)
+    return `${width}x${height}`
+  }
+
+  private roundToMultiple(value: number, multiple: number): number {
+    return Math.max(multiple, Math.round(value / multiple) * multiple)
+  }
+
+  parseGenerateResponse(result: any): ImageGenResponse {
+    // OpenAI DALL-E 3 目前是同步返回，但规范上也有异步 task 模式
+    if (result.task_id || result.id) {
+      return { isAsync: true, taskId: result.task_id || result.id }
+    }
+    const imageUrl = result.data?.[0]?.url || result.url
+    if (imageUrl) {
+      return { isAsync: false, imageUrl }
+    }
+    // b64_json 模式
+    const b64 = result.data?.[0]?.b64_json
+    if (b64) {
+      // 对于 base64，返回特殊标记，实际处理在 extractImageBase64
+      return { isAsync: false, imageUrl: undefined }
+    }
+    throw new Error('No image URL in response')
+  }
+
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest {
+    return {
+      url: joinProviderUrl(config.baseUrl, '/v1', `/images/task/${taskId}`),
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body: undefined,
+    }
+  }
+
+  parsePollResponse(result: any): ImagePollResponse {
+    if (result.status === 'completed') {
+      return {
+        status: 'completed',
+        imageUrl: result.image_url || result.data?.[0]?.url || null,
+      }
+    }
+    if (result.status === 'failed') {
+      return { status: 'failed', error: result.error?.message || 'Generation failed' }
+    }
+    return { status: result.status || 'processing', stage: ['queued', 'running', 'checking', 'missing'].includes(result.worker_state) ? result.worker_state : undefined }
+  }
+
+  extractImageUrl(result: any): string | null {
+    return result.data?.[0]?.url || result.image_url || null
+  }
+
+  extractImageBase64(result: any): { data: string; mimeType: string } | null {
+    const b64 = result.data?.[0]?.b64_json
+    if (b64) {
+      return { data: b64, mimeType: 'image/png' }
+    }
+    return null
+  }
+}
diff --git a/huobao-source/backend/src/services/adapters/registry.ts b/huobao-source/backend/src/services/adapters/registry.ts
new file mode 100644
index 0000000..00f5e22
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/registry.ts
@@ -0,0 +1,49 @@
+/**
+ * Provider Adapter 注册表
+ * 根据 provider 名称返回对应的 Adapter 实例
+ */
+import { OpenAIImageAdapter } from './openai-image'
+import { GeminiImageAdapter } from './gemini-image'
+import { VolcEngineImageAdapter } from './volcengine-image'
+import { VolcEngineVideoAdapter } from './volcengine-video'
+import { MiniMaxVideoAdapter } from './minimax-video'
+import { LocalVideoAdapter } from './local-video'
+import { AliyunWanVideoAdapter } from './aliyun-wan-video'
+import type { ImageProviderAdapter, VideoProviderAdapter } from './types'
+
+// 图片 Adapter 注册表
+export const imageAdapters: Record<string, ImageProviderAdapter> = {
+  openai: new OpenAIImageAdapter(),
+  gemini: new GeminiImageAdapter(),
+  volcengine: new VolcEngineImageAdapter(),
+}
+
+// 视频 Adapter 注册表
+export const videoAdapters: Record<string, VideoProviderAdapter> = {
+  volcengine: new VolcEngineVideoAdapter(),
+  minimax: new MiniMaxVideoAdapter(),
+  localvideo: new LocalVideoAdapter(),
+  aliyun: new AliyunWanVideoAdapter(),
+}
+
+/**
+ * 获取图片 Adapter
+ * @param provider 厂商名称
+ * @returns 对应的 Adapter
+ */
+export function getImageAdapter(provider: string): ImageProviderAdapter {
+  const adapter = imageAdapters[provider.toLowerCase()]
+  if (!adapter) throw new Error(`Unsupported image provider: ${provider}`)
+  return adapter
+}
+
+/**
+ * 获取视频 Adapter
+ * @param provider 厂商名称
+ * @returns 对应的 Adapter
+ */
+export function getVideoAdapter(provider: string): VideoProviderAdapter {
+  const adapter = videoAdapters[provider.toLowerCase()]
+  if (!adapter) throw new Error(`Unsupported video provider: ${provider}`)
+  return adapter
+}
diff --git a/huobao-source/backend/src/services/adapters/types.ts b/huobao-source/backend/src/services/adapters/types.ts
new file mode 100644
index 0000000..f9e1ff8
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/types.ts
@@ -0,0 +1,147 @@
+/**
+ * 图片生成 Provider Adapter 接口
+ */
+export interface ImageProviderAdapter {
+  /** 厂商标识 */
+  provider: string
+
+  /**
+   * 构建图片生成请求
+   * @param config AI 配置 { baseUrl, apiKey, model }
+   * @param record 图片生成记录
+   */
+  buildGenerateRequest(config: AIConfig, record: ImageGenerationRecord): ProviderRequest
+
+  /**
+   * 解析生成响应，判断是同步还是异步
+   */
+  parseGenerateResponse(result: any): ImageGenResponse
+
+  /**
+   * 构建轮询请求
+   * @param config AI 配置
+   * @param taskId 任务 ID
+   */
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest
+
+  /**
+   * 解析轮询响应
+   */
+  parsePollResponse(result: any): ImagePollResponse
+
+  /**
+   * 从响应中提取图片 URL（用于直接下载）
+   * 返回 null 表示图片数据是 base64 格式，需要用 extractImageBase64 处理
+   */
+  extractImageUrl(result: any): string | null
+
+  /**
+   * 从响应中提取 base64 图片数据
+   * 仅用于 Gemini 等只返回 base64 的厂商
+   */
+  extractImageBase64(result: any): { data: string; mimeType: string } | null
+}
+
+/**
+ * 视频生成 Provider Adapter 接口
+ */
+export interface VideoProviderAdapter {
+  provider: string
+
+  buildGenerateRequest(config: AIConfig, record: VideoGenerationRecord): ProviderRequest
+
+  parseGenerateResponse(result: any): VideoGenResponse
+
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest
+
+  parsePollResponse(result: any): VideoPollResponse
+
+  extractVideoUrl(result: any): string | null
+}
+
+// ============ 通用类型 ============
+
+export interface ProviderRequest {
+  url: string
+  method: string
+  headers: Record<string, string>
+  /**
+   * 普通请求为可 JSON 序列化的对象（generation.ts 统一 JSON.stringify）；
+   * multipart 上传（如 OpenAI /v1/images/edits）直接返回 FormData，
+   * 此时 headers 不要设置 Content-Type，边界由 fetch 自动生成。
+   */
+  body: any
+}
+
+export interface AIConfig {
+  id?: number
+  provider: string
+  baseUrl: string
+  apiKey: string
+  model: string
+  gpu?: 'auto' | 'gpu1' | 'gpu2' | 'gpu3'
+}
+
+export interface ImageGenerationRecord {
+  id: number
+  model?: string | null
+  prompt?: string | null
+  size?: string | null
+  frameType?: string | null
+  referenceImages?: string | null
+  // ... 其他字段
+}
+
+export interface VideoGenerationRecord {
+  id: number
+  model?: string | null
+  prompt?: string | null
+  referenceMode?: string | null
+  imageUrl?: string | null
+  firstFrameUrl?: string | null
+  lastFrameUrl?: string | null
+  referenceImageUrls?: string | null
+  referenceVideoUrls?: string | null
+  referenceAudioUrls?: string | null
+  referenceFileUrl?: string | null
+  referenceLinkUrl?: string | null
+  generateAudio?: number | boolean | null
+  duration?: number | null
+  aspectRatio?: string | null
+  resolution?: string | null
+  seed?: number | null
+  promptExtend?: number | boolean | null
+  watermark?: number | boolean | null
+  // ... 其他字段
+}
+
+export interface ImageGenResponse {
+  isAsync: boolean
+  taskId?: string
+  /** 同步模式下直接返回的图片 URL */
+  imageUrl?: string
+}
+
+export interface ImagePollResponse {
+  stage?: 'queued' | 'running' | 'checking' | 'missing'
+  status: 'pending' | 'processing' | 'completed' | 'failed'
+  imageUrl?: string
+  error?: string
+}
+
+export interface VideoGenResponse {
+  routing?: import('../worker-routing').WorkerRouting | null
+  isAsync: boolean
+  taskId?: string
+  videoUrl?: string
+  duration?: number
+}
+
+export interface VideoPollResponse {
+  routing?: import('../worker-routing').WorkerRouting | null
+  status: 'pending' | 'processing' | 'completed' | 'failed'
+  stage?: 'transferring' | 'queued' | 'running' | 'checking' | 'missing'
+  videoUrl?: string
+  duration?: number
+  error?: string
+}
diff --git a/huobao-source/backend/src/services/adapters/url.ts b/huobao-source/backend/src/services/adapters/url.ts
new file mode 100644
index 0000000..335cc0d
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/url.ts
@@ -0,0 +1,30 @@
+export function joinProviderUrl(baseUrl: string, requiredPrefix: string, path: string) {
+  const normalizedBase = (baseUrl || '').replace(/\/+$/, '')
+  const normalizedPrefix = normalizeSegment(requiredPrefix)
+  const normalizedPath = normalizeSegment(path)
+
+  if (!normalizedBase) {
+    return `${normalizedPrefix}${normalizedPath}`
+  }
+
+  try {
+    const url = new URL(normalizedBase)
+    const currentPath = url.pathname.replace(/\/+$/, '')
+    const mergedPrefix = currentPath.endsWith(normalizedPrefix)
+      ? currentPath
+      : `${currentPath}${normalizedPrefix}`
+
+    url.pathname = `${mergedPrefix}${normalizedPath}`.replace(/\/{2,}/g, '/')
+    return url.toString()
+  } catch {
+    const basePath = normalizedBase.endsWith(normalizedPrefix)
+      ? normalizedBase
+      : `${normalizedBase}${normalizedPrefix}`
+    return `${basePath}${normalizedPath}`
+  }
+}
+
+function normalizeSegment(segment: string) {
+  if (!segment) return ''
+  return segment.startsWith('/') ? segment : `/${segment}`
+}
diff --git a/huobao-source/backend/src/services/adapters/volcengine-image.ts b/huobao-source/backend/src/services/adapters/volcengine-image.ts
new file mode 100644
index 0000000..b44241b
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/volcengine-image.ts
@@ -0,0 +1,97 @@
+/**
+ * 火山引擎 veImageX 图片生成 Adapter
+ * 端点: /api/v3/images/generations (注意 /api/v3 前缀)
+ * 响应格式: { data: [{ url: "..." }] }
+ */
+import type {
+  ImageProviderAdapter,
+  ProviderRequest,
+  AIConfig,
+  ImageGenerationRecord,
+  ImageGenResponse,
+  ImagePollResponse,
+} from './types'
+import { joinProviderUrl } from './url'
+
+export class VolcEngineImageAdapter implements ImageProviderAdapter {
+  provider = 'volcengine'
+
+  buildGenerateRequest(config: AIConfig, record: ImageGenerationRecord): ProviderRequest {
+    // 火山引擎使用 seedream 模型
+    const model = record.model || config.model || 'doubao-seedream-5-0-260128'
+
+    const body: any = {
+      model,
+      prompt: record.prompt,
+    }
+
+    // 尺寸参数
+    if (record.size) {
+      const [w, h] = record.size.split('x')
+      if (w && h) {
+        body.width = parseInt(w)
+        body.height = parseInt(h)
+      }
+    }
+
+    return {
+      url: joinProviderUrl(config.baseUrl, '/api/v3', '/images/generations'),
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body,
+    }
+  }
+
+  parseGenerateResponse(result: any): ImageGenResponse {
+    // 火山引擎可能返回 task_id 进行轮询
+    if (result.task_id || result.id) {
+      return { isAsync: true, taskId: result.task_id || result.id }
+    }
+    // 同步返回
+    const imageUrl = result.data?.[0]?.url || result.url
+    if (imageUrl) {
+      return { isAsync: false, imageUrl }
+    }
+    throw new Error('No image URL in response')
+  }
+
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest {
+    return {
+      url: joinProviderUrl(config.baseUrl, '/api/v3', `/images/generations/${taskId}`),
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body: undefined,
+    }
+  }
+
+  parsePollResponse(result: any): ImagePollResponse {
+    const status = result.status
+    if (status === 'succeeded') {
+      return {
+        status: 'completed',
+        imageUrl: result.data?.[0]?.url || result.image_url,
+      }
+    }
+    if (status === 'failed') {
+      // 上游 error 可能是对象 { code, message }，规范成字符串
+      const err = result.error
+      const msg = typeof err === 'string' ? err : (err?.message || JSON.stringify(err) || 'Generation failed')
+      const code = err && typeof err === 'object' && err.code ? `[${err.code}] ` : ''
+      return { status: 'failed', error: `${code}${msg}` }
+    }
+    return { status: status || 'processing' }
+  }
+
+  extractImageUrl(result: any): string | null {
+    return result.data?.[0]?.url || result.image_url || null
+  }
+
+  extractImageBase64(result: any): { data: string; mimeType: string } | null {
+    return null
+  }
+}
diff --git a/huobao-source/backend/src/services/adapters/volcengine-video.ts b/huobao-source/backend/src/services/adapters/volcengine-video.ts
new file mode 100644
index 0000000..ab2b6e8
--- /dev/null
+++ b/huobao-source/backend/src/services/adapters/volcengine-video.ts
@@ -0,0 +1,147 @@
+/**
+ * 火山引擎 Seedance 2.0 视频生成 Adapter
+ * 端点: /api/v3/contents/generations/tasks (注意 /api/v3 前缀)
+ * 响应: { id: "task-xxx" } -> 轮询获取状态
+ *
+ * 仅支持 Doubao Seedance 2.0+ 系列模型，生成模式只保留多模态参考:
+ * - reference   多模态参考（≤9 reference_image + ≤3 reference_video + ≤3 reference_audio + 可选文本）
+ *   有参考音频时至少包含 1 个参考图片或视频
+ */
+import type {
+  VideoProviderAdapter,
+  ProviderRequest,
+  AIConfig,
+  VideoGenerationRecord,
+  VideoGenResponse,
+  VideoPollResponse,
+} from './types'
+import { joinProviderUrl } from './url'
+
+/** 仅支持 Seedance 2.0+ 系列（前缀匹配，兼容未来 2.0.x 变体） */
+const SEEDANCE2_MODEL_PREFIX = 'doubao-seedance-2-0'
+const DEFAULT_MODEL = 'doubao-seedance-2-0-mini-260615'
+
+/** 多模态参考素材上限：图片 9、视频 3、音频 3 */
+const REF_LIMITS = { images: 9, videos: 3, audios: 3 } as const
+
+function parseUrlArray(raw?: string | null): string[] {
+  if (!raw) return []
+  try {
+    const arr = JSON.parse(raw)
+    return Array.isArray(arr) ? arr.filter((u) => typeof u === 'string' && u.trim()) : []
+  } catch {
+    return []
+  }
+}
+
+export class VolcEngineVideoAdapter implements VideoProviderAdapter {
+  provider = 'volcengine'
+
+  buildGenerateRequest(config: AIConfig, record: VideoGenerationRecord): ProviderRequest {
+    const model = record.model || config.model || DEFAULT_MODEL
+    if (!model.startsWith(SEEDANCE2_MODEL_PREFIX)) {
+      throw new Error(`仅支持 Seedance 2.0 系列模型（${SEEDANCE2_MODEL_PREFIX}-*），当前: ${model}`)
+    }
+
+    const prompt = (record.prompt || '').trim()
+    const refImages = parseUrlArray(record.referenceImageUrls)
+    const refVideos = parseUrlArray(record.referenceVideoUrls)
+    const refAudios = parseUrlArray(record.referenceAudioUrls)
+
+    if (refImages.length > REF_LIMITS.images || refVideos.length > REF_LIMITS.videos || refAudios.length > REF_LIMITS.audios) {
+      throw new Error(`参考素材超限：图片≤${REF_LIMITS.images}、视频≤${REF_LIMITS.videos}、音频≤${REF_LIMITS.audios}`)
+    }
+    if (refAudios.length > 0 && refImages.length + refVideos.length === 0) {
+      throw new Error('参考音频需要至少 1 个参考图片或视频')
+    }
+    if (!prompt && !refImages.length && !refVideos.length && !refAudios.length) {
+      throw new Error('多模态参考模式需要至少一个参考素材或 prompt')
+    }
+
+    const content: any[] = []
+    if (prompt) content.push({ type: 'text', text: prompt })
+    for (const url of refImages) {
+      content.push({ type: 'image_url', image_url: { url }, role: 'reference_image' })
+    }
+    for (const url of refVideos) {
+      content.push({ type: 'video_url', video_url: { url }, role: 'reference_video' })
+    }
+    for (const url of refAudios) {
+      content.push({ type: 'audio_url', audio_url: { url }, role: 'reference_audio' })
+    }
+
+    const body: any = {
+      model,
+      content,
+      generate_audio: record.generateAudio !== 0 && record.generateAudio !== false,
+      ratio: record.aspectRatio || 'adaptive',
+      duration: this.normalizeDuration(record.duration),
+      // Seedance 2.0 仅 480p/720p 两档，1080p 收敛到 720p
+      resolution: record.resolution === '480p' ? '480p' : '720p',
+      watermark: false,
+    }
+
+    return {
+      url: joinProviderUrl(config.baseUrl, '/api/v3', '/contents/generations/tasks'),
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body,
+    }
+  }
+
+  parseGenerateResponse(result: any): VideoGenResponse {
+    if (result.id) {
+      return { isAsync: true, taskId: result.id }
+    }
+    // 同步返回
+    const videoUrl = result.video_url || result.content?.video_url || result.data?.video_url
+    if (videoUrl) {
+      return { isAsync: false, videoUrl }
+    }
+    throw new Error('No task_id or video_url in response')
+  }
+
+  buildPollRequest(config: AIConfig, taskId: string): ProviderRequest {
+    return {
+      url: joinProviderUrl(config.baseUrl, '/api/v3', `/contents/generations/tasks/${taskId}`),
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body: undefined,
+    }
+  }
+
+  parsePollResponse(result: any): VideoPollResponse {
+    const status = result.status
+    if (status === 'succeeded') {
+      const videoUrl = result.video_url || result.content?.video_url || result.data?.video_url
+      return {
+        status: 'completed',
+        videoUrl,
+      }
+    }
+    if (status === 'failed') {
+      // 上游 error 可能是对象 { code, message }（如 OutputVideoSensitiveContentDetected），规范成字符串
+      const err = result.error
+      const msg = typeof err === 'string' ? err : (err?.message || JSON.stringify(err) || 'Video generation failed')
+      const code = err && typeof err === 'object' && err.code ? `[${err.code}] ` : ''
+      return { status: 'failed', error: `${code}${msg}` }
+    }
+    return { status: status || 'processing' }
+  }
+
+  extractVideoUrl(result: any): string | null {
+    return result.video_url || result.content?.video_url || result.data?.video_url || null
+  }
+
+  private normalizeDuration(duration?: number | null): number {
+    const parsed = Math.round(Number(duration || 5))
+    if (!Number.isFinite(parsed)) return 5
+    // Seedance 2.0 支持 4-15 秒
+    return Math.min(15, Math.max(4, parsed))
+  }
+}
diff --git a/huobao-source/backend/src/services/ai.ts b/huobao-source/backend/src/services/ai.ts
new file mode 100644
index 0000000..a027729
--- /dev/null
+++ b/huobao-source/backend/src/services/ai.ts
@@ -0,0 +1,162 @@
+/**
+ * AI 服务抽象层 — 从数据库配置中获取 provider 和 API key
+ */
+import { db, schema } from '../db/index.js'
+import { eq } from 'drizzle-orm'
+import { logTaskProgress, logTaskWarn } from '../utils/task-logger.js'
+import { joinProviderUrl } from './adapters/url.js'
+
+export type ServiceType = 'text' | 'image' | 'video'
+
+export interface AIConfig {
+  id?: number
+  provider: string
+  baseUrl: string
+  apiKey: string
+  model: string
+  /** 采样温度，null 表示不设置（跟随服务商默认）。存于 ai_service_configs.settings JSON */
+  temperature?: number | null
+  gpu?: 'auto' | 'gpu1' | 'gpu2' | 'gpu3'
+}
+
+export function parseConfigGpu(settingsRaw: string | null | undefined): 'auto' | 'gpu1' | 'gpu2' | 'gpu3' {
+  try {
+    const gpu = JSON.parse(settingsRaw || '{}')?.gpu
+    return gpu === 'gpu1' || gpu === 'gpu2' || gpu === 'gpu3' ? gpu : 'auto'
+  } catch { return 'auto' }
+}
+
+/** 从 settings JSON 解析 temperature；非法值一律视为未设置 */
+export function parseConfigTemperature(settingsRaw: string | null | undefined): number | null {
+  if (!settingsRaw) return null
+  try {
+    const t = JSON.parse(settingsRaw)?.temperature
+    return typeof t === 'number' && Number.isFinite(t) ? t : null
+  } catch {
+    return null
+  }
+}
+
+export const officialProviders: Record<ServiceType, readonly string[]> = {
+  text: ['openai', 'gemini', 'volcengine'],
+  image: ['openai', 'gemini', 'volcengine'],
+  video: ['volcengine', 'minimax', 'aliyun', 'localvideo'],
+}
+
+export function isOfficialProvider(serviceType?: string | null, provider?: string | null): boolean {
+  const providers = officialProviders[serviceType as ServiceType]
+  return !!providers && providers.includes((provider || '').toLowerCase())
+}
+
+export function getTextProviderBaseUrl(config: AIConfig) {
+  const provider = config.provider.toLowerCase()
+
+  if (provider === 'openai') {
+    return joinProviderUrl(config.baseUrl, '/v1', '')
+  }
+
+  if (provider === 'gemini') {
+    return joinProviderUrl(config.baseUrl, '/v1beta', '')
+  }
+
+  if (provider === 'volcengine') {
+    return joinProviderUrl(config.baseUrl, '/api/v3', '')
+  }
+
+  return config.baseUrl
+}
+
+// Agent 多步循环会逐步重复解析同一配置，相同配置只打一次日志避免刷屏
+const lastLoggedActiveConfigKey = new Map<string, string>()
+const lastLoggedConfigByIdKey = new Map<number, string>()
+
+export async function getActiveConfig(serviceType: ServiceType): Promise<AIConfig | null> {
+  const rows = (await db.select().from(schema.aiServiceConfigs)
+    .where(eq(schema.aiServiceConfigs.serviceType, serviceType))
+  )
+    .filter(r => r.isActive && isOfficialProvider(serviceType, r.provider))
+    .sort((a, b) => (b.priority || 0) - (a.priority || 0)) // 高优先级优先
+
+  const active = rows[0]
+  if (!active) {
+    logTaskWarn('AIConfig', 'active-config-missing', { serviceType })
+    return null
+  }
+
+  const models = active.model ? JSON.parse(active.model) : []
+  const logKey = `${active.id}:${models[0] || ''}`
+  if (lastLoggedActiveConfigKey.get(serviceType) !== logKey) {
+    lastLoggedActiveConfigKey.set(serviceType, logKey)
+    logTaskProgress('AIConfig', 'active-config-selected', {
+      serviceType,
+      configId: active.id,
+      provider: active.provider,
+      model: models[0] || '',
+      priority: active.priority,
+    })
+  }
+  return {
+    id: active.id,
+    provider: active.provider || '',
+    baseUrl: active.baseUrl,
+    apiKey: active.apiKey,
+    model: models[0] || '',
+    temperature: parseConfigTemperature(active.settings),
+    gpu: parseConfigGpu(active.settings),
+  }
+}
+
+export async function getTextConfig(): Promise<AIConfig> {
+  const config = await getActiveConfig('text')
+  if (!config) throw new Error('未配置文本模型，请先到「设置」页添加并启用 AI 服务')
+  return config
+}
+
+/**
+ * 取某服务类型当前启用且优先级最高的官方配置 ID（创建集时自动锁定用）
+ */
+export async function getActiveConfigId(serviceType: ServiceType): Promise<number | null> {
+  const rows = (await db.select().from(schema.aiServiceConfigs)
+    .where(eq(schema.aiServiceConfigs.serviceType, serviceType))
+  )
+    .filter(r => r.isActive && isOfficialProvider(serviceType, r.provider))
+    .sort((a, b) => (b.priority || 0) - (a.priority || 0))
+  return rows[0]?.id ?? null
+}
+
+export async function getConfigById(id: number): Promise<AIConfig | null> {
+  const [row] = await db.select().from(schema.aiServiceConfigs)
+    .where(eq(schema.aiServiceConfigs.id, id))
+  if (!row || !row.isActive) {
+    logTaskWarn('AIConfig', 'config-by-id-missing', { configId: id })
+    return null
+  }
+  if (!isOfficialProvider(row.serviceType as ServiceType, row.provider)) {
+    logTaskWarn('AIConfig', 'config-by-id-unsupported-provider', {
+      configId: id,
+      serviceType: row.serviceType,
+      provider: row.provider,
+    })
+    return null
+  }
+  const models = row.model ? JSON.parse(row.model) : []
+  const logKey = `${row.provider}:${models[0] || ''}:${row.serviceType}`
+  if (lastLoggedConfigByIdKey.get(id) !== logKey) {
+    lastLoggedConfigByIdKey.set(id, logKey)
+    logTaskProgress('AIConfig', 'config-by-id-selected', {
+      configId: id,
+      provider: row.provider,
+      model: models[0] || '',
+      serviceType: row.serviceType,
+    })
+  }
+  return {
+    id: row.id,
+    provider: row.provider || '',
+    baseUrl: row.baseUrl,
+    apiKey: row.apiKey,
+    model: models[0] || '',
+    temperature: parseConfigTemperature(row.settings),
+    gpu: parseConfigGpu(row.settings),
+  }
+}
diff --git a/huobao-source/backend/src/services/app-settings.ts b/huobao-source/backend/src/services/app-settings.ts
new file mode 100644
index 0000000..f56678d
--- /dev/null
+++ b/huobao-source/backend/src/services/app-settings.ts
@@ -0,0 +1,71 @@
+/**
+ * 应用级全局设置（app_settings key-value 表）
+ * AI 内容语言：所有 Agent 产出（剧本/提取/分镜/提示词）统一使用的目标语言
+ * 层次约束：本模块只依赖 db，严禁反向 import agents/*（agents/context.ts 会引用本模块）
+ *
+ * 注意：刻意做成同步 API（better-sqlite3 驱动的 .get()/.run()），
+ * 供 agents/context.ts 的同步 buildAgentRequestContext 内部直接调用
+ */
+import { eq } from 'drizzle-orm'
+import { db, schema } from '../db/index.js'
+import { now } from '../utils/response.js'
+
+export const CONTENT_LANGUAGES = ['zh', 'en', 'ja', 'ko'] as const
+export type ContentLanguage = typeof CONTENT_LANGUAGES[number]
+
+const CONTENT_LANGUAGE_KEY = 'content_language'
+
+function isContentLanguage(v: unknown): v is ContentLanguage {
+  return typeof v === 'string' && (CONTENT_LANGUAGES as readonly string[]).includes(v)
+}
+
+/** 读取全局内容语言；未设置或值非法时回退 'zh'（保持历史默认行为） */
+export function getContentLanguage(): ContentLanguage {
+  const row = db.select().from(schema.appSettings)
+    .where(eq(schema.appSettings.key, CONTENT_LANGUAGE_KEY))
+    .get()
+  return isContentLanguage(row?.value) ? row.value : 'zh'
+}
+
+/** 写入全局内容语言（upsert） */
+export function setContentLanguage(lang: ContentLanguage): ContentLanguage {
+  if (!isContentLanguage(lang)) throw new Error(`Invalid content language: ${lang}`)
+  db.insert(schema.appSettings)
+    .values({ key: CONTENT_LANGUAGE_KEY, value: lang, updatedAt: now() })
+    .onConflictDoUpdate({
+      target: schema.appSettings.key,
+      set: { value: lang, updatedAt: now() },
+    })
+    .run()
+  return lang
+}
+
+const TOURS_SEEN_KEY = 'tours_seen'
+const MAX_TOURS_SEEN = 64
+
+function sanitizeTourIds(ids: unknown): string[] {
+  if (!Array.isArray(ids)) return []
+  return [...new Set(ids.filter(v => typeof v === 'string' && v.length > 0 && v.length <= 100))].slice(0, MAX_TOURS_SEEN)
+}
+
+/** 已看过的引导漫游 id 列表（JSON 数组存储）；桌面端端口随启动变化，localStorage 不可靠，故落库 */
+export function getToursSeen(): string[] {
+  const row = db.select().from(schema.appSettings)
+    .where(eq(schema.appSettings.key, TOURS_SEEN_KEY))
+    .get()
+  try { return sanitizeTourIds(JSON.parse(row?.value || '[]')) } catch { return [] }
+}
+
+/** 写入已看过的引导漫游 id 列表（upsert） */
+export function setToursSeen(ids: unknown): string[] {
+  const clean = sanitizeTourIds(ids)
+  const value = JSON.stringify(clean)
+  db.insert(schema.appSettings)
+    .values({ key: TOURS_SEEN_KEY, value, updatedAt: now() })
+    .onConflictDoUpdate({
+      target: schema.appSettings.key,
+      set: { value, updatedAt: now() },
+    })
+    .run()
+  return clean
+}
diff --git a/huobao-source/backend/src/services/character-voice-references.ts b/huobao-source/backend/src/services/character-voice-references.ts
new file mode 100644
index 0000000..1b1ccfc
--- /dev/null
+++ b/huobao-source/backend/src/services/character-voice-references.ts
@@ -0,0 +1,53 @@
+import { and, eq, isNull } from 'drizzle-orm'
+import { db, schema } from '../db/index.js'
+
+type VoiceCharacter = { name: string; voiceAudioUrl: string | null; bound?: boolean }
+const voiceToken = /#[^\s#@，。！？；、：,.!?;:「」“”"'（）()[\]{}<>]{1,100}/u
+
+/** Only explicitly mentioned voices are sent; indices follow the audio array, not image order. */
+export function resolveVoiceMentions(prompt: string, characters: VoiceCharacter[], existingAudio: string[] = []) {
+  const audioUrls = [...new Set(existingAudio.map(url => url.trim()))]
+  const names = [...new Set(characters.map(c => c.name).filter(Boolean))].sort((a, b) => b.length - a.length)
+  let hasVoiceReferences = false
+  let result = ''
+  for (let pos = 0; pos < prompt.length;) {
+    if (prompt[pos] !== '#') { result += prompt[pos++]; continue }
+    const tail = prompt.slice(pos)
+    const name = names.find(name => tail.startsWith(`#${name}`))
+    if (name === undefined) {
+      const unknown = tail.match(voiceToken)
+      // Numeric shot labels such as #01 are not voice mentions.
+      if (unknown?.index === 0 && !/^#\d+$/.test(unknown[0])) throw new Error(`音色引用「${unknown[0]}」无效，请选择当前分镜已绑定角色的音色`)
+      result += prompt[pos++]
+      continue
+    }
+    const matches = characters.filter(c => c.name === name && c.bound !== false)
+    if (!matches.length) throw new Error(`音色引用「#${name}」无效，该角色未绑定到当前分镜`)
+    if (matches.length > 1) throw new Error(`当前分镜存在同名角色「${name}」，请先修改角色名称再引用音色`)
+    const url = matches[0].voiceAudioUrl?.trim()
+    if (!url) throw new Error(`角色「${name}」尚未上传音色或音色已移除，请重新上传后生成`)
+    let index = audioUrls.indexOf(url)
+    if (index < 0) { index = audioUrls.length; audioUrls.push(url) }
+    hasVoiceReferences = true
+    result += `${name}（音色参考音频${index + 1}）`
+    pos += name.length + 1
+    // Keep saved prompts using the previous #Name音色 spelling functional.
+    if (prompt.slice(pos).startsWith('音色')) pos += 2
+  }
+  return { prompt: result, audioUrls, hasVoiceReferences }
+}
+
+export async function resolveStoryboardVoiceReferences(prompt: string, storyboardId: number | undefined, existingAudio: string[]) {
+  if (!prompt.includes('#')) return { prompt, audioUrls: existingAudio, hasVoiceReferences: false }
+  if (!storyboardId) {
+    if ([...prompt.matchAll(new RegExp(voiceToken, 'gu'))].some(match => !/^#\d+$/.test(match[0]))) throw new Error('引用角色音色时必须指定当前分镜')
+    return { prompt, audioUrls: existingAudio, hasVoiceReferences: false }
+  }
+  const characters = await db.select({ name: schema.characters.name, voiceAudioUrl: schema.characters.voiceAudioUrl, boundId: schema.storyboardCharacters.characterId })
+    .from(schema.storyboards)
+    .innerJoin(schema.episodes, eq(schema.storyboards.episodeId, schema.episodes.id))
+    .innerJoin(schema.characters, eq(schema.characters.dramaId, schema.episodes.dramaId))
+    .leftJoin(schema.storyboardCharacters, and(eq(schema.storyboardCharacters.storyboardId, schema.storyboards.id), eq(schema.storyboardCharacters.characterId, schema.characters.id)))
+    .where(and(eq(schema.storyboards.id, storyboardId), isNull(schema.storyboards.deletedAt), isNull(schema.episodes.deletedAt), isNull(schema.characters.deletedAt)))
+  return resolveVoiceMentions(prompt, characters.map(c => ({ ...c, bound: c.boundId !== null })), existingAudio)
+}
diff --git a/huobao-source/backend/src/services/extraction.ts b/huobao-source/backend/src/services/extraction.ts
new file mode 100644
index 0000000..4b0f8a1
--- /dev/null
+++ b/huobao-source/backend/src/services/extraction.ts
@@ -0,0 +1,89 @@
+/**
+ * 资产提取任务 — 异步执行，按「集 × 类型」粒度跟踪
+ * 角色 / 场景 / 道具 可分别单独提取，同一集的不同类型可并行
+ * 任务状态为进程内内存态：后端重启后运行中的任务状态丢失（Agent 调用本身已被中断）
+ */
+import { mastra } from '../mastra/index.js'
+import { buildAgentRequestContext } from '../agents/context.js'
+import { logTaskError, logTaskProgress, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+export type ExtractTarget = 'characters' | 'scenes' | 'props'
+export const EXTRACT_TARGETS: ExtractTarget[] = ['characters', 'scenes', 'props']
+
+export interface ExtractTask {
+  status: 'running' | 'done' | 'error'
+  started_at: string
+  finished_at?: string
+  error?: string
+}
+
+const tasks = new Map<string, ExtractTask>()
+const keyOf = (episodeId: number, target: string) => `${episodeId}:${target}`
+
+/** 每类资产的提取指令：限定只提取该类型，并要求与已有数据去重合并 */
+const EXTRACT_MESSAGES: Record<ExtractTarget, string> = {
+  characters: '请从本集剧本中提取所有角色信息（外貌需融合性格、含妆造），先用 read_existing_characters 读取项目已有角色，同名或近名（带括号定位/别名，如「林小雨（主角）」与「林小雨」）直接复用已有、不要重复创建，再用 save_dedup_characters 保存。本次只提取角色，不要提取场景和道具。',
+  scenes: '请从本集剧本中提取所有场景信息（地点、时间、光影等），先用 read_existing_scenes 读取已有场景去重，再用 save_dedup_scenes 保存。本次只提取场景，不要提取角色和道具。',
+  props: '请从本集剧本中提取关键道具——必须同时满足：① 直接推动剧情（出现/交接/损坏/发现会引发情节转折，如凶器、信物、关键文件、定情礼物、证据）；② 值得单独生成白底单品图（分镜会给它特写或反复出现）。判定三问任一答"否"即放弃：删掉它剧情依然成立吗？它只是随手使用的日常物品（手机、筷子、水杯）吗？它是场景陈设（桌椅、灯具）吗？宁可少提不要多提，一集通常 0-3 个，超过 3 个只保留最重要的 3 个，没有就一个都不提取（save_dedup_props 传空数组）。description 只记录物品外貌。先用 read_existing_props 读取已有道具去重，再用 save_dedup_props 保存。本次只提取道具，不要提取角色和场景。',
+}
+
+/** 启动异步提取任务（立即返回）；同集同类型已在运行时返回 false；可指定文本模型覆盖 */
+export function startExtraction(episodeId: number, dramaId: number, target: ExtractTarget, opts: { model?: string; configId?: number } = {}): boolean {
+  const key = keyOf(episodeId, target)
+  if (tasks.get(key)?.status === 'running') return false
+
+  const task: ExtractTask = { status: 'running', started_at: new Date().toISOString() }
+  tasks.set(key, task)
+
+  logTaskStart('Extract', target, { episodeId, dramaId, model: opts.model || undefined, configId: opts.configId || undefined })
+  ;(async () => {
+    const agent = mastra.getAgent('extractor')
+    if (!agent) throw new Error('提取 Agent 不可用')
+    const requestContext = buildAgentRequestContext({
+      episodeId,
+      dramaId,
+      modelOverride: opts.model || undefined,
+      textConfigId: opts.configId || undefined,
+    })
+    return agent.generate([{ role: 'user', content: EXTRACT_MESSAGES[target] }], {
+      maxSteps: 20,
+      requestContext,
+      // 逐步打印 Agent 进展：调用了哪些工具、输出了什么
+      onStepFinish: (step: any) => {
+        const tools = (step?.toolCalls || [])
+          .map((t: any) => t?.toolName || t?.payload?.toolName)
+          .filter(Boolean)
+        logTaskProgress('Extract', `${target}-step`, {
+          episodeId,
+          tools: tools.length ? tools.join(',') : undefined,
+          text: (step?.text || '').slice(0, 200) || undefined,
+        })
+      },
+    })
+  })()
+    .then((result: any) => {
+      task.status = 'done'
+      task.finished_at = new Date().toISOString()
+      const toolNames = (result?.toolCalls || []).map((t: any) => t?.toolName).filter(Boolean)
+      logTaskSuccess('Extract', target, {
+        episodeId,
+        steps: result?.steps?.length,
+        toolCalls: toolNames.join(',') || undefined,
+        reply: (result?.text || '').slice(0, 300) || undefined,
+      })
+    })
+    .catch((err: any) => {
+      task.status = 'error'
+      task.finished_at = new Date().toISOString()
+      task.error = err?.message || '提取失败'
+      logTaskError('Extract', target, { episodeId, error: err?.message })
+    })
+  return true
+}
+
+/** 查询某集三类资产的提取任务状态（未启动过的类型为 null） */
+export function getExtractionStatus(episodeId: number): Record<ExtractTarget, ExtractTask | null> {
+  const result = {} as Record<ExtractTarget, ExtractTask | null>
+  for (const target of EXTRACT_TARGETS) result[target] = tasks.get(keyOf(episodeId, target)) || null
+  return result
+}
diff --git a/huobao-source/backend/src/services/ffmpeg-merge.ts b/huobao-source/backend/src/services/ffmpeg-merge.ts
new file mode 100644
index 0000000..a98a038
--- /dev/null
+++ b/huobao-source/backend/src/services/ffmpeg-merge.ts
@@ -0,0 +1,169 @@
+/**
+ * FFmpeg 多镜头拼接 — 将所有生成后的镜头视频拼接为一集
+ */
+import fs from 'fs'
+import path from 'path'
+import { v4 as uuid } from 'uuid'
+import { db, getInsertId, schema } from '../db/index.js'
+import { eq } from 'drizzle-orm'
+import { now } from '../utils/response.js'
+import { logTaskError, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+import { extractVideoPoster } from '../utils/video-poster.js'
+import { ffmpeg, checkFfmpegSuite } from '../utils/ffmpeg.js'
+import { DATA_ROOT, STORAGE_ROOT } from '../utils/paths.js'
+
+function toAbsPath(relativePath: string): string {
+  if (path.isAbsolute(relativePath)) return relativePath
+  if (relativePath.startsWith('static/')) return path.join(DATA_ROOT, relativePath)
+  return path.join(STORAGE_ROOT, relativePath)
+}
+
+/**
+ * 拼接一集的镜头视频。
+ * 优先使用视频生成产物，兼容历史的 composedVideoUrl 数据。
+ * 传入 storyboardIds 时只拼接所选镜头（仍按镜号顺序）。
+ */
+export async function mergeEpisodeVideos(episodeId: number, dramaId: number, storyboardIds?: number[]): Promise<number> {
+  let storyboards = await db.select().from(schema.storyboards)
+    .where(eq(schema.storyboards.episodeId, episodeId))
+    .orderBy(schema.storyboards.storyboardNumber)
+
+  if (storyboardIds?.length) {
+    const allow = new Set(storyboardIds.map(Number))
+    storyboards = storyboards.filter(sb => allow.has(sb.id))
+  }
+
+  // 允许部分拼接:按镜号顺序拼接已生成的镜头,未生成的跳过
+  const clips = storyboards
+    .map(sb => ({ sb, url: sb.videoUrl || sb.composedVideoUrl }))
+    .filter(c => Boolean(c.url)) as { sb: typeof storyboards[number]; url: string }[]
+
+  if (clips.length === 0) throw new Error('所选镜头还没有可拼接的视频')
+
+  // 拼接前探测 ffmpeg：二进制损坏时 fluent-ffmpeg 的同步 EFTYPE 会崩掉整个进程，
+  // 这里提前拦截并给出可操作的修复指引（路由层会作为 400 返回前端）
+  const suite = await checkFfmpegSuite()
+  if (!suite.ffmpeg || !suite.ffprobe) {
+    throw new Error('本机 ffmpeg 不可用，无法拼接视频（常见于 node_modules 跨平台拷贝或 ffmpeg-static 下载损坏）。请删除 node_modules 后在本机重新 npm install，或设置 FFMPEG_BIN 指向有效的 ffmpeg 可执行文件后重启服务')
+  }
+
+  // 校验视频文件真实存在:DB 里的 video_url 可能指向已被清理的文件,
+  // 直接拼会得到 ffmpeg 的 "No such file or directory" 晦涩报错
+  const missing = clips.filter(c => !fs.existsSync(toAbsPath(c.url)))
+  if (missing.length > 0) {
+    const nums = missing.map(c => `S${c.sb.storyboardNumber}`).join('、')
+    throw new Error(`镜头 ${nums} 的视频文件已丢失（本地文件不存在），请重新生成这些镜头的视频，或在拼接时取消勾选`)
+  }
+
+  const videos = clips.map(c => c.url)
+
+  logTaskStart('MergeTask', 'episode-merge', { episodeId, dramaId, clips: videos.length })
+
+  // 创建 merge 记录
+  const ts = now()
+  const res = await db.insert(schema.videoMerges).values({
+    episodeId,
+    dramaId,
+    title: `Episode ${episodeId} Merge`,
+    provider: 'ffmpeg',
+    model: 'ffmpeg-concat-h264-aac',
+    status: 'processing',
+    scenes: JSON.stringify(videos),
+    createdAt: ts,
+  })
+  const mergeId = getInsertId(res)
+
+  // 异步执行
+  doMerge(mergeId, episodeId, videos).catch(async err => {
+    logTaskError('MergeTask', 'episode-merge', { mergeId, episodeId, error: err.message })
+    console.error(`[Merge] Failed:`, err)
+    await db.update(schema.videoMerges)
+      .set({ status: 'failed', errorMsg: err.message })
+      .where(eq(schema.videoMerges.id, mergeId))
+  })
+
+  return mergeId
+}
+
+async function doMerge(mergeId: number, episodeId: number, videos: string[]) {
+  // 生成 concat 列表文件
+  const listDir = path.join(STORAGE_ROOT, 'temp')
+  fs.mkdirSync(listDir, { recursive: true })
+  const listPath = path.join(listDir, `${uuid()}.txt`)
+
+  const listContent = videos
+    .map(v => `file '${toAbsPath(v)}'`)
+    .join('\n')
+  fs.writeFileSync(listPath, listContent, 'utf-8')
+
+  // 输出文件
+  const outputDir = path.join(STORAGE_ROOT, 'merged')
+  fs.mkdirSync(outputDir, { recursive: true })
+  const outputFilename = `${uuid()}.mp4`
+  const outputPath = path.join(outputDir, outputFilename)
+
+  // Mixed original/HD selections must not inherit the first clip's lower size.
+  const dimensions = await Promise.all(videos.map(v => new Promise<{ width: number; height: number }>((resolve, reject) => {
+    ffmpeg.ffprobe(toAbsPath(v), (err, meta) => {
+      if (err) return reject(err)
+      const stream = meta.streams.find(s => s.codec_type === 'video')
+      if (!stream?.width || !stream.height) return reject(new Error('无法读取拼接视频尺寸'))
+      resolve({ width: stream.width, height: stream.height })
+    })
+  })))
+  const target = dimensions.reduce((a, b) => b.width * b.height > a.width * a.height ? b : a)
+
+  await new Promise<void>((resolve, reject) => {
+    ffmpeg()
+      .input(listPath)
+      .inputOptions(['-f', 'concat', '-safe', '0'])
+      .outputOptions([
+        '-fflags', '+genpts',
+        '-vf', `scale=${target.width}:${target.height}:force_original_aspect_ratio=decrease,pad=${target.width}:${target.height}:(ow-iw)/2:(oh-ih)/2,setsar=1`,
+        '-c:v', 'libx264',
+        '-preset', 'medium',
+        '-crf', '23',
+        '-c:a', 'aac',
+        '-ar', '48000',
+        '-b:a', '192k',
+        '-movflags', '+faststart',
+      ])
+      .output(outputPath)
+      .on('end', () => resolve())
+      .on('error', (err) => reject(err))
+      .run()
+
+  })
+
+  // 清理临时文件
+  fs.unlinkSync(listPath)
+
+  // 获取时长
+  const duration = await getVideoDuration(outputPath)
+
+  const mergedRelative = `static/merged/${outputFilename}`
+
+  // 成片海报帧（导出页封面用）
+  await extractVideoPoster(mergedRelative)
+
+  // 更新 merge 记录
+  await db.update(schema.videoMerges)
+    .set({ status: 'completed', mergedUrl: mergedRelative, duration, completedAt: now() })
+    .where(eq(schema.videoMerges.id, mergeId))
+
+  // 更新 episode
+  await db.update(schema.episodes)
+    .set({ videoUrl: mergedRelative, updatedAt: now() })
+    .where(eq(schema.episodes.id, episodeId))
+
+  logTaskSuccess('MergeTask', 'episode-merge', { mergeId, episodeId, output: mergedRelative, duration, clips: videos.length })
+}
+
+function getVideoDuration(filePath: string): Promise<number> {
+  return new Promise((resolve) => {
+    ffmpeg.ffprobe(filePath, (err, metadata) => {
+      if (err) { resolve(0); return }
+      resolve(Math.round(metadata.format.duration || 0))
+    })
+  })
+}
diff --git a/huobao-source/backend/src/services/final-prompt.ts b/huobao-source/backend/src/services/final-prompt.ts
new file mode 100644
index 0000000..aa3feeb
--- /dev/null
+++ b/huobao-source/backend/src/services/final-prompt.ts
@@ -0,0 +1,77 @@
+/**
+ * 最终提示词服务
+ * 生图前确保角色/场景/道具已有「最终提示词」：
+ * - 角色 → 三视图（character turnaround：正面/侧面/背面）
+ * - 场景 → 固定视角 + 前景/中景/后景
+ * - 道具 → 白底单品静物（single product shot on pure white background）
+ * 缺失时运行 prompt_generator Agent 创作并保存；失败返回 ''，由调用方回退到本地拼接提示词
+ */
+import { eq } from 'drizzle-orm'
+import { db, schema } from '../db/index.js'
+import { mastra } from '../mastra/index.js'
+import { buildAgentRequestContext } from '../agents/context.js'
+import { logTaskError, logTaskProgress } from '../utils/task-logger.js'
+
+type CharacterRow = typeof schema.characters.$inferSelect
+type SceneRow = typeof schema.scenes.$inferSelect
+type PropRow = typeof schema.props.$inferSelect
+
+/** 顶栏选择的文本模型/配置覆盖（不传则跟随 Agent 与文本配置默认） */
+export interface PromptAgentOptions { model?: string; configId?: number }
+
+async function runPromptAgent(episodeId: number, dramaId: number, message: string, opts?: PromptAgentOptions) {
+  const agent = mastra.getAgent('prompt_generator')
+  if (!agent) throw new Error('图片提示词 Agent 不可用')
+  const requestContext = buildAgentRequestContext({
+    episodeId,
+    dramaId,
+    modelOverride: opts?.model || undefined,
+    textConfigId: opts?.configId || undefined,
+  })
+  await agent.generate([{ role: 'user', content: message }], { maxSteps: 12, requestContext })
+}
+
+/** 确保角色拥有三视图最终提示词，返回最终提示词（失败返回 ''）；force 时忽略已有提示词强制重新生成 */
+export async function ensureCharacterFinalPrompt(char: CharacterRow, episodeId: number, force = false, opts?: PromptAgentOptions): Promise<string> {
+  if (char.finalPrompt && !force) return char.finalPrompt
+  try {
+    logTaskProgress('FinalPrompt', 'character-generate', { characterId: char.id, episodeId })
+    await runPromptAgent(episodeId, char.dramaId,
+      `为角色「${char.name}」(character_id=${char.id}) 生成三视图最终提示词，并调用 save_character_final_prompt 保存。`, opts)
+    const [fresh] = await db.select().from(schema.characters).where(eq(schema.characters.id, char.id))
+    return fresh?.finalPrompt || ''
+  } catch (err: any) {
+    logTaskError('FinalPrompt', 'character-generate', { characterId: char.id, error: err.message })
+    return ''
+  }
+}
+
+/** 确保场景拥有固定视角（前中后景）最终提示词，返回最终提示词（失败返回 ''）；force 时忽略已有提示词强制重新生成 */
+export async function ensureSceneFinalPrompt(scene: SceneRow, episodeId: number, force = false, opts?: PromptAgentOptions): Promise<string> {
+  if (scene.finalPrompt && !force) return scene.finalPrompt
+  try {
+    logTaskProgress('FinalPrompt', 'scene-generate', { sceneId: scene.id, episodeId })
+    await runPromptAgent(episodeId, scene.dramaId,
+      `为场景「${scene.location}」(scene_id=${scene.id}) 生成固定视角（前景/中景/后景）最终提示词，并调用 save_scene_final_prompt 保存。注意：这是无人物空镜——场景图中不能出现任何的人（含背影、剪影、倒影、照片里的人），即使场景描述提到人物活动也必须剔除，只保留场景本身。`, opts)
+    const [fresh] = await db.select().from(schema.scenes).where(eq(schema.scenes.id, scene.id))
+    return fresh?.finalPrompt || ''
+  } catch (err: any) {
+    logTaskError('FinalPrompt', 'scene-generate', { sceneId: scene.id, error: err.message })
+    return ''
+  }
+}
+
+/** 确保道具拥有白底单品最终提示词，返回最终提示词（失败返回 ''）；force 时忽略已有提示词强制重新生成 */
+export async function ensurePropFinalPrompt(prop: PropRow, episodeId: number, force = false, opts?: PromptAgentOptions): Promise<string> {
+  if (prop.finalPrompt && !force) return prop.finalPrompt
+  try {
+    logTaskProgress('FinalPrompt', 'prop-generate', { propId: prop.id, episodeId })
+    await runPromptAgent(episodeId, prop.dramaId,
+      `为道具「${prop.name}」(prop_id=${prop.id}) 生成白底单品最终提示词，并调用 save_prop_final_prompt 保存。`, opts)
+    const [fresh] = await db.select().from(schema.props).where(eq(schema.props.id, prop.id))
+    return fresh?.finalPrompt || ''
+  } catch (err: any) {
+    logTaskError('FinalPrompt', 'prop-generate', { propId: prop.id, error: err.message })
+    return ''
+  }
+}
diff --git a/huobao-source/backend/src/services/generation.ts b/huobao-source/backend/src/services/generation.ts
new file mode 100644
index 0000000..dc59f5d
--- /dev/null
+++ b/huobao-source/backend/src/services/generation.ts
@@ -0,0 +1,858 @@
+/**
+ * 统一生成任务服务 — 图片/视频生成共用 sys_task 表与同一条生命周期：
+ * 创建(processing) → 适配器构建请求 → 同步完成或异步轮询 → 下载落盘 → 回写业务表
+ */
+import { db, getInsertId, schema } from '../db/index.js'
+import { and, desc, eq, gt, ne, or, isNull } from 'drizzle-orm'
+import fs from 'node:fs'
+import { getAbsolutePath } from '../utils/storage.js'
+import { downloadVideo, safeTaskError } from './video-download.js'
+import { prepareReferenceAudio, resolveReferenceAudioUrls } from './reference-audio.js'
+import { getActiveConfig, getConfigById } from './ai.js'
+import { parseWorkerRouting, type WorkerRouting } from './worker-routing.js'
+import { isLocalQueuedTask, taskPollingProfile } from './local-task-tracking.js'
+import { now } from '../utils/response.js'
+import { downloadFile, fetchImageAsCompressedDataUrl, generateImageThumb, readImageAsCompressedDataUrl, readImageAsDataUrl, saveBase64Image } from '../utils/storage.js'
+import { extractVideoPoster } from '../utils/video-poster.js'
+import { ffmpeg } from '../utils/ffmpeg.js'
+import { getImageAdapter, getVideoAdapter } from './adapters/registry'
+import type { AIConfig } from './adapters/types'
+import { logTaskError, logTaskPayload, logTaskProgress, logTaskStart, logTaskSuccess, logTaskWarn, redactUrl } from '../utils/task-logger.js'
+
+type TaskType = 'image' | 'video'
+
+const activeTasks = new Set<number>()
+const videoSubmissions = new Set<number>()
+const cancellingTasks = new Set<number>()
+function runBackground(id: number, job: () => Promise<void>) {
+  if (activeTasks.has(id)) return
+  activeTasks.add(id)
+  void job().catch(error => failTask(id, safeTaskError(error))).finally(() => activeTasks.delete(id))
+}
+
+const taskLabel = (type: TaskType) => (type === 'image' ? 'ImageTask' : 'VideoTask')
+
+interface GenerateImageParams {
+  storyboardId?: number
+  dramaId?: number
+  sceneId?: number
+  characterId?: number
+  propId?: number
+  prompt: string
+  model?: string
+  size?: string
+  referenceImages?: string[]
+  frameType?: string
+  configId?: number
+}
+
+interface GenerateVideoParams {
+  gpu?: AIConfig['gpu']
+  replaceTaskId?: number
+  variant?: 'hd'
+  originalVideoUrl?: string
+  storyboardId?: number
+  dramaId?: number
+  prompt: string
+  model?: string
+  referenceMode?: string
+  imageUrl?: string
+  firstFrameUrl?: string
+  lastFrameUrl?: string
+  referenceImageUrls?: string[]
+  referenceVideoUrls?: string[]
+  referenceAudioUrls?: string[]
+  referenceFileUrl?: string
+  referenceLinkUrl?: string
+  generateAudio?: boolean
+  duration?: number
+  aspectRatio?: string
+  resolution?: string
+  seed?: number
+  promptExtend?: boolean
+  watermark?: boolean
+  configId?: number
+  forceNew?: boolean
+}
+
+export async function generateImage(params: GenerateImageParams): Promise<number> {
+  // 指定配置（集锁定）可能已停用/删除/厂商收敛，失效时回退到当前启用配置，避免生成被旧引用卡死
+  const config = params.configId
+    ? (await getConfigById(params.configId)) ?? await getActiveConfig('image')
+    : await getActiveConfig('image')
+  if (!config) throw new Error('未配置图片模型，请先到「设置」页添加并启用 AI 服务')
+
+  const id = await createTask('image', config, {
+    storyboardId: params.storyboardId,
+    dramaId: params.dramaId,
+    sceneId: params.sceneId,
+    characterId: params.characterId,
+    propId: params.propId,
+    prompt: params.prompt,
+    model: params.model || config.model,
+  }, {
+    size: params.size || '1920x1080',
+    frameType: params.frameType,
+    referenceImages: params.referenceImages,
+  })
+
+  logTaskStart('ImageTask', 'enqueue', {
+    id,
+    provider: config.provider,
+    storyboardId: params.storyboardId,
+    sceneId: params.sceneId,
+    characterId: params.characterId,
+    frameType: params.frameType,
+    model: params.model || config.model,
+  })
+  logTaskPayload('ImageTask', 'enqueue params', {
+    id,
+    config: { provider: config.provider, model: config.model, baseUrl: config.baseUrl },
+    params,
+  })
+  return id
+}
+
+export async function generateVideo(params: GenerateVideoParams): Promise<number> {
+  const storyboardId = params.storyboardId
+  if (storyboardId && videoSubmissions.has(storyboardId)) throw new Error('该分镜正在提交任务，请勿重复点击')
+  if (storyboardId) videoSubmissions.add(storyboardId)
+  try {
+    if (params.gpu !== undefined && !['auto', 'gpu1', 'gpu2', 'gpu3'].includes(params.gpu)) throw new Error('请选择自动分配、GPU1、GPU2 或 GPU3')
+    if (params.replaceTaskId !== undefined && (!storyboardId || !Number.isSafeInteger(params.replaceTaskId) || params.replaceTaskId <= 0)) throw new Error('被替换的任务 ID 无效')
+    // 指定配置（集锁定）可能已停用/删除/厂商收敛，失效时回退到当前启用配置
+    const selectedConfig = params.configId
+      ? await getConfigById(params.configId)
+      : await getActiveConfig('video')
+    const config = selectedConfig ? { ...selectedConfig, gpu: params.gpu ?? selectedConfig.gpu } : null
+    if (!config) throw new Error('未配置视频模型，请先到「设置」页添加并启用 AI 服务')
+    if (params.gpu !== undefined && !['localvideo', 'minimax'].includes(config.provider)) throw new Error('所选模型不支持指定本地显卡')
+    if (params.variant === 'hd' && (config.id !== params.configId || config.provider !== 'localvideo')) throw new Error('高清服务配置已停用或变更，请恢复 VDN-H3 配置')
+
+    params.referenceAudioUrls = await prepareReferenceAudio(params.referenceAudioUrls, config.provider)
+
+    // Validate the new request before touching the previous job.
+    const validatedRequest = getVideoAdapter(config.provider).buildGenerateRequest(config, { ...params, id: 0,
+      referenceImageUrls: JSON.stringify(params.referenceImageUrls || []),
+      referenceVideoUrls: JSON.stringify(params.referenceVideoUrls || []),
+      referenceAudioUrls: JSON.stringify(params.referenceAudioUrls || []) })
+    if (params.replaceTaskId && ['minimax', 'localvideo'].includes(config.provider)) {
+      const target = new URL(config.baseUrl)
+      if (target.hostname === '192.168.110.111' && ['18792', '18794'].includes(target.port)) {
+        const response = await fetch(`${config.baseUrl.replace(/\/$/, '')}/v2/video_generation/validate`, {
+          method: 'POST', headers: { Authorization: `Bearer ${config.apiKey}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify(validatedRequest.body), signal: AbortSignal.timeout(35_000) })
+        if (!response.ok) throw new Error(`新显卡未就绪，原任务保持运行：${safeTaskError(await response.text())}`)
+      }
+    }
+    if (storyboardId) {
+      const tasks = await db.select().from(schema.sysTask).where(and(eq(schema.sysTask.type, 'video'), eq(schema.sysTask.storyboardId, storyboardId)))
+        .orderBy(desc(schema.sysTask.id))
+      const latest = tasks[0]
+      if (params.replaceTaskId !== undefined && latest?.id !== params.replaceTaskId) throw new Error('任务已变化，请刷新后再操作；未取消任何其他任务')
+      if (tasks.some(t => t.status === 'processing' && t.id !== params.replaceTaskId)) throw new Error('该分镜已有运行中的任务，请等待结果')
+      if (latest?.status === 'processing') await cancelVideoForReplacement(latest)
+      if (latest?.status === 'failed' && params.forceNew !== true) throw new Error('请先恢复原任务；重新生成需确认可能再次计费')
+    }
+
+    const id = await createTask('video', config, {
+      storyboardId: params.storyboardId,
+      dramaId: params.dramaId,
+      prompt: params.prompt,
+      model: params.model || config.model,
+    }, {
+      referenceMode: params.referenceMode || 'reference',
+      variant: params.variant,
+      originalVideoUrl: params.originalVideoUrl,
+      replacesTaskId: params.replaceTaskId,
+      imageUrl: params.imageUrl,
+      firstFrameUrl: params.firstFrameUrl,
+      lastFrameUrl: params.lastFrameUrl,
+      referenceImageUrls: params.referenceImageUrls,
+      referenceVideoUrls: params.referenceVideoUrls,
+      referenceAudioUrls: params.referenceAudioUrls,
+      referenceFileUrl: params.referenceFileUrl,
+      referenceLinkUrl: params.referenceLinkUrl,
+      generateAudio: params.generateAudio === false ? 0 : 1,
+      duration: params.duration,
+      aspectRatio: params.aspectRatio,
+      // 统一存为项目内部格式，各适配器再转换为官方大小写与枚举。
+      resolution: normalizeStoredVideoResolution(params.resolution),
+      seed: params.seed,
+      promptExtend: params.promptExtend,
+      watermark: params.watermark,
+    })
+
+    logTaskStart('VideoTask', 'enqueue', {
+      id,
+      provider: config.provider,
+      storyboardId: params.storyboardId,
+      dramaId: params.dramaId,
+      referenceMode: params.referenceMode || 'reference',
+      duration: params.duration || 5,
+    })
+    logTaskPayload('VideoTask', 'enqueue params', {
+      id,
+      config: { provider: config.provider, model: config.model, baseUrl: config.baseUrl },
+      params,
+    })
+    return id
+  } finally {
+    if (storyboardId) videoSubmissions.delete(storyboardId)
+  }
+}
+
+async function cancelVideoForReplacement(record: SysTaskRecord) {
+  if (!record.taskId || record.stage === 'submitting') throw new Error('原任务尚未返回编号，请稍后再换卡')
+  if (record.resultUrl || ['downloading', 'saving', 'transferring'].includes(record.stage || '')) throw new Error('原视频正在保存，请完成后再重新生成')
+  const config = await recoveryConfig(record)
+  if (!['minimax', 'localvideo'].includes(config.provider)) throw new Error('原模型不支持按任务取消')
+  const base = config.baseUrl.replace(/\/$/, '')
+  const headers = { Authorization: `Bearer ${config.apiKey}`, 'Content-Type': 'application/json' }
+  cancellingTasks.add(record.id)
+  try {
+    const request = async (cancel: boolean) => {
+      const path = cancel ? `/v2/video_generation/${encodeURIComponent(record.taskId!)}/cancel` : `/v2/query/video_generation/${encodeURIComponent(record.taskId!)}`
+      const response = await fetch(base + path, { method: cancel ? 'POST' : 'GET', headers,
+        ...(cancel ? { body: '{}' } : {}), signal: AbortSignal.timeout(35_000) })
+      if (!response.ok) throw new Error('原任务取消未确认，请稍后重试；未提交新任务')
+      const result = await response.json() as any
+      if (result.task?.id !== record.taskId) throw new Error('取消回执任务编号不匹配；未提交新任务')
+      return result.task.status as string
+    }
+    let status = await request(true)
+    const deadline = Date.now() + 45_000
+    while (!['cancelled', 'failed', 'succeeded'].includes(status) && Date.now() < deadline) {
+      await new Promise(resolve => setTimeout(resolve, 1000))
+      status = await request(false)
+    }
+    if (status === 'succeeded') throw new Error('原视频已经生成，正在保存；完成后可以重新生成')
+    if (!['cancelled', 'failed'].includes(status)) throw new Error('原任务仍在停止中，请稍后再点击；未提交新任务')
+    await db.update(schema.sysTask).set({ status: 'failed', stage: 'failed', errorCode: 'user_cancelled',
+      errorMsg: '已取消原任务并请求重新生成，历史记录保留', updatedAt: now() })
+      .where(and(eq(schema.sysTask.id, record.id), eq(schema.sysTask.status, 'processing')))
+  } finally { cancellingTasks.delete(record.id) }
+}
+
+async function createTask(
+  type: TaskType,
+  config: AIConfig,
+  fields: {
+    storyboardId?: number
+    dramaId?: number
+    sceneId?: number
+    characterId?: number
+    propId?: number
+    prompt: string
+    model?: string | null
+  },
+  params: Record<string, unknown>,
+): Promise<number> {
+  const ts = now()
+  const res = await db.insert(schema.sysTask).values({
+    type,
+    ...fields,
+    provider: config.provider,
+    configId: config.id,
+    configBaseUrl: config.baseUrl,
+    stage: 'submitting',
+    params: JSON.stringify({ ...params, gpu: config.gpu || 'auto' }),
+    status: 'processing',
+    createdAt: ts,
+    updatedAt: ts,
+  })
+
+  const id = getInsertId(res)
+  runBackground(id, () => processTask(id, config))
+  return id
+}
+
+function parseTaskParams(raw: string | null | undefined): Record<string, any> {
+  if (!raw) return {}
+  try {
+    return JSON.parse(raw) || {}
+  } catch {
+    return {}
+  }
+}
+
+async function processTask(id: number, config: AIConfig) {
+  try {
+    const [record] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id))
+    if (!record) return
+    const type = record.type as TaskType
+    const label = taskLabel(type)
+    const params = parseTaskParams(record.params)
+    logTaskProgress(label, 'build-request', {
+      id,
+      provider: config.provider,
+      storyboardId: record.storyboardId,
+      sceneId: record.sceneId,
+      characterId: record.characterId,
+    })
+
+    let url: string, method: string, headers: Record<string, string>, body: unknown
+
+    if (type === 'image') {
+      const adapter = getImageAdapter(config.provider)
+      const resolvedReferenceImages = await normalizeReferenceImages(params.referenceImages)
+      ;({ url, method, headers, body } = adapter.buildGenerateRequest(config, {
+        id: record.id,
+        model: record.model,
+        prompt: record.prompt,
+        size: params.size,
+        frameType: params.frameType,
+        referenceImages: resolvedReferenceImages.length ? JSON.stringify(resolvedReferenceImages) : null,
+      }))
+    } else {
+      const adapter = getVideoAdapter(config.provider)
+      const resolvedImageUrl = await normalizeVideoReferenceUrl(params.imageUrl)
+      const resolvedFirstFrameUrl = await normalizeVideoReferenceUrl(params.firstFrameUrl)
+      const resolvedLastFrameUrl = await normalizeVideoReferenceUrl(params.lastFrameUrl)
+      const resolvedReferenceImageUrls = await normalizeVideoReferenceUrls(params.referenceImageUrls)
+      // 视频使用公网地址；短音色按厂商能力使用 data URL 或公网地址。
+      const resolvedReferenceVideoUrls = resolvePublicMediaUrls(params.referenceVideoUrls, 'video')
+      const resolvedReferenceAudioUrls = await resolveReferenceAudioUrls(params.referenceAudioUrls, config.provider)
+      const resolvedReferenceFileUrl = resolvePublicMediaUrl(params.referenceFileUrl, 'file')
+      ;({ url, method, headers, body } = adapter.buildGenerateRequest(config, {
+        id: record.id,
+        model: record.model,
+        prompt: record.prompt,
+        referenceMode: params.referenceMode,
+        imageUrl: resolvedImageUrl,
+        firstFrameUrl: resolvedFirstFrameUrl,
+        lastFrameUrl: resolvedLastFrameUrl,
+        referenceImageUrls: resolvedReferenceImageUrls.length ? JSON.stringify(resolvedReferenceImageUrls) : null,
+        referenceVideoUrls: resolvedReferenceVideoUrls.length ? JSON.stringify(resolvedReferenceVideoUrls) : null,
+        referenceAudioUrls: resolvedReferenceAudioUrls.length ? JSON.stringify(resolvedReferenceAudioUrls) : null,
+        referenceFileUrl: resolvedReferenceFileUrl,
+        referenceLinkUrl: params.referenceLinkUrl,
+        generateAudio: params.generateAudio,
+        duration: params.duration,
+        aspectRatio: params.aspectRatio,
+        resolution: params.resolution,
+        seed: params.seed,
+        promptExtend: params.promptExtend,
+        watermark: params.watermark,
+      }))
+    }
+
+    logTaskProgress(label, 'request', {
+      id,
+      provider: config.provider,
+      method,
+      url: redactUrl(url),
+      model: record.model,
+    })
+
+    const isMultipart = body instanceof FormData
+    logTaskPayload(label, 'request payload', {
+      id, method, url, headers,
+      // multipart 表单（如 OpenAI /v1/images/edits）无法 JSON 化，记录字段摘要
+      body: isMultipart ? `[multipart/form-data: ${[...(body as FormData).keys()].join(', ')}]` : body,
+    })
+
+    const resp = await fetch(url, {
+      method,
+      headers,
+      body: isMultipart ? (body as FormData) : JSON.stringify(body),
+      signal: AbortSignal.timeout(600_000),
+    })
+
+    // Firemux 在响应头提供内部任务编号；即使 JSON 响应体中断也能查询原任务。
+    const gatewayTaskId = resp.headers.get('X-Firemux-Task-Id') || resp.headers.get('X-Huobao-Task-Id')
+    if (type === 'video' && gatewayTaskId) {
+      await markPolling(id, gatewayTaskId)
+      record.taskId = gatewayTaskId
+    }
+
+    if (!resp.ok) throw new Error(`API error ${resp.status}: ${await resp.text()}`)
+    const result = await resp.json() as any
+    logTaskPayload(label, 'response payload', { id, provider: config.provider, result })
+
+    if (type === 'image') {
+      const adapter = getImageAdapter(config.provider)
+      const { isAsync, taskId, imageUrl } = adapter.parseGenerateResponse(result)
+
+      if (!isAsync && imageUrl) {
+        logTaskProgress(label, 'sync-complete', { id, imageUrl })
+        await handleImageComplete(record, imageUrl)
+        return
+      }
+
+      if (!isAsync && !imageUrl) {
+        // 同步模式但无 URL（Gemini 等返回 base64）
+        const b64 = adapter.extractImageBase64(result)
+        if (b64) {
+          logTaskProgress(label, 'sync-base64-complete', { id, mimeType: b64.mimeType })
+          await handleImageCompleteBase64(record, b64.data, b64.mimeType)
+          return
+        }
+        throw new Error('No image URL or base64 data in response')
+      }
+
+      await markPolling(id, taskId)
+      await pollTask(record, config, taskId!)
+      return
+    }
+
+    const adapter = getVideoAdapter(config.provider)
+    const { isAsync, taskId, videoUrl, duration, routing } = adapter.parseGenerateResponse(result)
+    if (routing) await saveRouting(id, routing)
+    if (taskId) {
+      await markPolling(id, taskId)
+      record.taskId = taskId
+    }
+
+    if (!isAsync && videoUrl) {
+      logTaskProgress(label, 'sync-complete', { id, videoUrl })
+      await handleVideoComplete(record, videoUrl, duration ?? params.duration)
+      return
+    }
+
+    await markPolling(id, taskId)
+    await pollTask(record, config, taskId!)
+  } catch (err: any) {
+    const [current] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id))
+    const uncertain = current?.type === 'video' && !current.taskId && !current.resultUrl
+      && (err instanceof TypeError || /timeout|abort|No task_id|API error 5/i.test(err.message))
+    await failTask(id, safeTaskError(err), uncertain ? 'submission_unknown' : undefined)
+  }
+}
+
+async function markPolling(id: number, taskId: string | undefined) {
+  await db.update(schema.sysTask)
+    .set({ taskId, stage: 'polling', status: 'processing', updatedAt: now() })
+    .where(eq(schema.sysTask.id, id))
+  logTaskProgress('SysTask', 'poll-start', { id, taskId })
+}
+
+async function saveRouting(id: number, routing: WorkerRouting) {
+  const checked = parseWorkerRouting(routing)
+  if (!checked) return
+  const [record] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id))
+  if (!record || record.status !== 'processing') return
+  await db.update(schema.sysTask).set({ params: JSON.stringify({ ...parseTaskParams(record.params), routing: checked }), updatedAt: now() })
+    .where(and(eq(schema.sysTask.id, id), eq(schema.sysTask.status, 'processing')))
+}
+
+async function failTask(id: number, message: string, code?: string) {
+  message = safeTaskError(message)
+  logTaskError('SysTask', 'failed', { id, error: message })
+  await db.update(schema.sysTask)
+    .set({ status: 'failed', errorMsg: safeTaskError(message), ...(code ? { errorCode: code } : {}), updatedAt: now() })
+    .where(and(eq(schema.sysTask.id, id), ne(schema.sysTask.status, 'completed'),
+      or(isNull(schema.sysTask.errorCode), ne(schema.sysTask.errorCode, 'user_cancelled'))))
+}
+
+type SysTaskRecord = typeof schema.sysTask.$inferSelect
+
+async function pollTask(record: SysTaskRecord, config: AIConfig, taskId: string) {
+  const type = record.type as TaskType
+  const label = taskLabel(type)
+  const local = isLocalQueuedTask(config, taskId)
+  const profile = taskPollingProfile(type, local, parseTaskParams(record.params).variant === 'hd')
+  const adapter = type === 'image' ? getImageAdapter(config.provider) : getVideoAdapter(config.provider)
+  const startedAt = Date.now()
+  let delayMs = profile.intervalMs
+  let missingChecks = 0
+
+  for (let i = 0; i < profile.attempts; i++) {
+    if (profile.maxDurationMs && Date.now() - startedAt >= profile.maxDurationMs) {
+      await failTask(record.id, 'Timeout: Polling exceeded 10 minutes')
+      return
+    }
+    await new Promise(r => setTimeout(r, delayMs))
+      const [current] = await db.select({ status: schema.sysTask.status }).from(schema.sysTask).where(eq(schema.sysTask.id, record.id))
+      if (!current || current.status !== 'processing') return
+    try {
+      const { url, method, headers } = adapter.buildPollRequest(config, taskId)
+      logTaskProgress(label, 'poll-request', {
+        id: record.id,
+        taskId,
+        provider: config.provider,
+        method,
+        url: redactUrl(url),
+        attempt: i + 1,
+      })
+      const remainingMs = local ? 30_000 : profile.maxDurationMs
+        ? Math.max(1_000, profile.maxDurationMs - (Date.now() - startedAt))
+        : 600_000
+      const resp = await fetch(url, {
+        method,
+        headers,
+        signal: AbortSignal.timeout(remainingMs),
+      })
+      if (!resp.ok) throw new Error(`Polling HTTP ${resp.status}`)
+      const result = await resp.json() as any
+
+      if (cancellingTasks.has(record.id)) continue
+      const [afterPoll] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, record.id))
+      if (!afterPoll || afterPoll.status !== 'processing') return
+
+      // 图片/视频 PollResponse 结构不同，这里统一按 any 取值后按 type 分支
+      const pollResp: any = adapter.parsePollResponse(result)
+      delayMs = profile.intervalMs
+      if (local && pollResp.status !== 'completed' && pollResp.status !== 'failed') {
+        missingChecks = pollResp.stage === 'missing' ? missingChecks + 1 : 0
+        if (missingChecks >= 3) {
+          await failTask(record.id, '显卡节点已找不到此任务，请核对节点重启记录后重新生成', 'upstream_missing')
+          return
+        }
+        const stage = pollResp.stage === 'missing' ? 'checking' : pollResp.stage || 'polling'
+        await db.update(schema.sysTask).set({ stage, updatedAt: now() })
+          .where(and(eq(schema.sysTask.id, record.id), eq(schema.sysTask.status, 'processing')))
+      }
+      if (type === 'video' && pollResp.routing) await saveRouting(record.id, pollResp.routing)
+      if (type === 'video' && pollResp.stage === 'transferring') {
+        await db.update(schema.sysTask).set({ stage: 'transferring', updatedAt: now() }).where(eq(schema.sysTask.id, record.id))
+      }
+
+      if (pollResp.status === 'completed') {
+        if (type === 'image') {
+          if (pollResp.imageUrl) {
+            logTaskSuccess(label, 'poll-complete', { id: record.id, taskId, imageUrl: pollResp.imageUrl })
+            await handleImageComplete(record, pollResp.imageUrl)
+            return
+          }
+          if (adapter.provider === 'gemini') {
+            // Gemini 可能返回 base64
+            const b64 = (adapter as ReturnType<typeof getImageAdapter>).extractImageBase64(result)
+            if (b64) {
+              logTaskSuccess(label, 'poll-base64-complete', { id: record.id, taskId, mimeType: b64.mimeType })
+              await handleImageCompleteBase64(record, b64.data, b64.mimeType)
+              return
+            }
+          }
+        } else if (pollResp.videoUrl) {
+          logTaskSuccess(label, 'poll-complete', { id: record.id, taskId, videoUrl: pollResp.videoUrl })
+          await handleVideoComplete(record, pollResp.videoUrl, pollResp.duration)
+          return
+        }
+      }
+      if (pollResp.status === 'failed') {
+        // 上游明确失败（如内容审核拦截）属终态：立即落库，不重试不等待超时
+        const deliveryFailed = /video_transfer_failed/.test(pollResp.error || '')
+        if (deliveryFailed) await db.update(schema.sysTask).set({ stage: 'transferring' }).where(eq(schema.sysTask.id, record.id))
+        await failTask(record.id, pollResp.error || 'Generation failed', deliveryFailed ? 'delivery_failed' : 'generation_failed')
+        return
+      }
+    } catch (err: any) {
+      if (local) {
+        // A transient transport failure cannot cancel an accepted GPU job.
+        missingChecks = 0
+        delayMs = Math.min(60_000, Math.max(profile.intervalMs, delayMs * 2))
+        await db.update(schema.sysTask).set({ stage: 'reconnecting', updatedAt: now() })
+          .where(and(eq(schema.sysTask.id, record.id), eq(schema.sysTask.status, 'processing')))
+        logTaskWarn(label, 'poll-reconnect', { id: record.id, taskId, error: err.message })
+        continue
+      }
+      const exhausted = i === profile.attempts - 1
+        || (profile.maxDurationMs != null && Date.now() - startedAt >= profile.maxDurationMs)
+      if (exhausted) {
+        await failTask(record.id, `Timeout: ${err.message}`)
+        return
+      }
+      logTaskWarn(label, 'poll-retry', { id: record.id, taskId, attempt: i + 1, error: err.message })
+    }
+  }
+  await failTask(record.id, 'Timeout: polling attempts exhausted')
+}
+
+async function handleImageComplete(record: SysTaskRecord, imageUrl: string) {
+  const localPath = await downloadFile(imageUrl, 'images')
+  // 列表页缩略图（前端按命名约定推导地址，失败不影响主流程）
+  await generateImageThumb(localPath)
+
+  await db.update(schema.sysTask)
+    .set({ resultUrl: imageUrl, localPath, status: 'completed', stage: 'completed', errorCode: null, errorMsg: null, completedAt: now(), updatedAt: now() })
+    .where(eq(schema.sysTask.id, record.id))
+
+  logTaskSuccess('ImageTask', 'downloaded', { id: record.id, provider: record.provider, localPath })
+
+  await writeBackImageAssets(record, localPath)
+}
+
+async function handleImageCompleteBase64(record: SysTaskRecord, base64Data: string, mimeType: string) {
+  const localPath = await saveBase64Image(base64Data, mimeType, 'images')
+  await generateImageThumb(localPath)
+
+  await db.update(schema.sysTask)
+    .set({ localPath, status: 'completed', stage: 'completed', errorCode: null, errorMsg: null, completedAt: now(), updatedAt: now() })
+    .where(eq(schema.sysTask.id, record.id))
+
+  logTaskSuccess('ImageTask', 'saved-base64', { id: record.id, provider: record.provider, mimeType, localPath })
+
+  await writeBackImageAssets(record, localPath)
+}
+
+// 图片完成后回写业务表：分镜(按 frameType)、角色、场景、道具
+async function writeBackImageAssets(record: SysTaskRecord, localPath: string) {
+  const params = parseTaskParams(record.params)
+  // A late result is kept in task history, never substituted for a newer attempt.
+  const newer = await db.select().from(schema.sysTask).where(and(eq(schema.sysTask.type, 'image'), gt(schema.sysTask.id, record.id), or(
+    eq(schema.sysTask.characterId, record.characterId || -1), eq(schema.sysTask.sceneId, record.sceneId || -1),
+    eq(schema.sysTask.propId, record.propId || -1), eq(schema.sysTask.storyboardId, record.storyboardId || -1))))
+  if (newer.some(task => !record.storyboardId || parseTaskParams(task.params).frameType === params.frameType)) return
+  if (record.storyboardId) {
+    const sbUpdate: Record<string, any> = { updatedAt: now() }
+    if (params.frameType === 'first_frame') sbUpdate.firstFrameImage = localPath
+    else if (params.frameType === 'last_frame') sbUpdate.lastFrameImage = localPath
+    else sbUpdate.composedImage = localPath
+    await db.update(schema.storyboards).set(sbUpdate).where(eq(schema.storyboards.id, record.storyboardId))
+  }
+  if (record.characterId) {
+    await db.update(schema.characters).set({ imageUrl: localPath, updatedAt: now() }).where(eq(schema.characters.id, record.characterId))
+  }
+  if (record.sceneId) {
+    await db.update(schema.scenes).set({ imageUrl: localPath, status: 'completed', updatedAt: now() }).where(eq(schema.scenes.id, record.sceneId))
+  }
+  if (record.propId) {
+    await db.update(schema.props).set({ imageUrl: localPath, updatedAt: now() }).where(eq(schema.props.id, record.propId))
+  }
+}
+
+async function handleVideoComplete(record: SysTaskRecord, videoUrl: string, duration: number | null | undefined) {
+  const [current] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, record.id))
+  if (!current || current.errorCode === 'user_cancelled' || cancellingTasks.has(record.id)) return
+  // 先落库地址与实际时长；后续下载失败仍可恢复，且不重新提交生成。
+  const params: Record<string, unknown> = { ...parseTaskParams(current.params), resultDuration: duration }
+  await db.update(schema.sysTask).set({ resultUrl: videoUrl, params: JSON.stringify(params),
+    stage: 'downloading', status: 'processing', errorCode: null, errorMsg: null, updatedAt: now() })
+    .where(eq(schema.sysTask.id, record.id))
+  try {
+    const localPath = record.localPath && fs.existsSync(getAbsolutePath(record.localPath))
+      ? record.localPath : await downloadVideo(videoUrl, record.id)
+    if (params.variant === 'hd') {
+      const readDimensions = () => new Promise<{ width?: number; height?: number }>((resolve, reject) => {
+        ffmpeg.ffprobe(getAbsolutePath(localPath), (error, meta) => {
+          if (error) return reject(error)
+          resolve(meta.streams.find(stream => stream.codec_type === 'video') || {})
+        })
+      })
+      let dimensions = await readDimensions()
+      const expected = params.resolution === '4K' ? [3840, 2160] : [2560, 1440]
+      if (params.aspectRatio === '9:16') expected.reverse()
+      // H3 aligns its latent dimensions to 32 pixels. Trim only that padding;
+      // never upscale a lower-resolution render and label it as native HD.
+      const aligned = expected.map(size => Math.ceil(size / 32) * 32)
+      if ((dimensions.width !== expected[0] || dimensions.height !== expected[1]) && dimensions.width === aligned[0] && dimensions.height === aligned[1]) {
+        const absolute = getAbsolutePath(localPath)
+        const cropped = `${absolute}.hd-crop.mp4`
+        try {
+          await new Promise<void>((resolve, reject) => ffmpeg(absolute)
+            .outputOptions(['-vf', `crop=${expected[0]}:${expected[1]}:0:0`, '-c:v', 'libx264', '-preset', 'fast', '-crf', '18', '-c:a', 'copy', '-movflags', '+faststart'])
+            .output(cropped).on('end', () => resolve()).on('error', reject).run())
+          await fs.promises.rename(cropped, absolute)
+        } finally { await fs.promises.rm(cropped, { force: true }) }
+        dimensions = await readDimensions()
+      }
+      if (dimensions.width !== expected[0] || dimensions.height !== expected[1]) throw new Error(`高清结果尺寸不匹配：需要 ${expected.join('×')}，收到 ${dimensions.width}×${dimensions.height}；原版保持不变`)
+    }
+    await db.update(schema.sysTask).set({ localPath, stage: 'saving', updatedAt: now() }).where(eq(schema.sysTask.id, record.id))
+    await extractVideoPoster(localPath)
+    // 完成状态与业务回写原子提交；恢复旧任务不能覆盖用户后来生成的视频。
+    db.transaction(tx => {
+      const newer = record.storyboardId ? tx.select({ id: schema.sysTask.id }).from(schema.sysTask)
+        .where(and(eq(schema.sysTask.storyboardId, record.storyboardId), eq(schema.sysTask.type, 'video'), gt(schema.sysTask.id, record.id))).get() : null
+      if (record.storyboardId && !newer && parseTaskParams(record.params).variant !== 'hd') tx.update(schema.storyboards)
+        .set({ videoUrl: localPath, duration: duration || undefined, updatedAt: now() })
+        .where(eq(schema.storyboards.id, record.storyboardId)).run()
+      tx.update(schema.sysTask).set({ localPath, status: 'completed', stage: 'completed', errorCode: null,
+        errorMsg: null, completedAt: now(), updatedAt: now() }).where(eq(schema.sysTask.id, record.id)).run()
+    })
+  } catch (error) {
+    await failTask(record.id, safeTaskError(error), 'delivery_failed')
+  }
+}
+
+async function recoveryConfig(record: SysTaskRecord): Promise<AIConfig> {
+  if (record.configId) {
+    const config = await getConfigById(record.configId)
+    if (config && config.provider === record.provider && config.baseUrl === record.configBaseUrl) return config
+    throw new Error('原生成服务配置已删除、停用或地址变更，请恢复原配置')
+  }
+  // 旧任务只在同厂商唯一配置时恢复，绝不任意换服务商查询。
+  const rows = (await db.select().from(schema.aiServiceConfigs)).filter(c => c.isActive && c.serviceType === record.type && c.provider === record.provider)
+  if (rows.length === 1) {
+    const config = await getConfigById(rows[0].id)
+    if (config) return config
+  }
+  throw new Error('历史任务无法确定原服务配置，请先核对配置')
+}
+
+export async function recoverVideoTask(id: number): Promise<void> {
+  const [record] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id))
+  if (!record || record.type !== 'video') throw new Error('视频任务不存在')
+  if (record.errorCode === 'user_cancelled') throw new Error('原任务已取消，请选择模型和显卡重新生成')
+  if (activeTasks.has(id) || record.status === 'completed') return
+  if (!record.resultUrl && !record.taskId) throw new Error('未保存上游任务编号，请先核对上游记录，勿重复生成')
+  if (record.errorCode === 'generation_failed') throw new Error('上游已确认生成失败，无法恢复原任务')
+  // 在任何异步配置读取前获取锁，重复点击不会启动多个下载。
+  activeTasks.add(id)
+  try {
+    const config = record.taskId && !record.resultUrl ? await recoveryConfig(record) : null
+    await db.update(schema.sysTask).set({ status: 'processing', errorMsg: null, errorCode: null,
+      stage: record.resultUrl ? 'downloading' : record.stage === 'transferring' || record.errorCode === 'delivery_failed' ? 'transferring' : 'polling', updatedAt: now() }).where(eq(schema.sysTask.id, id))
+    void (async () => {
+      if (record.resultUrl) {
+        await handleVideoComplete(record, record.resultUrl, parseTaskParams(record.params).resultDuration)
+        const [fresh] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id))
+        if (fresh?.status !== 'failed' || !record.taskId) return
+        // 签名链接可能过期：重新查询原任务拿新地址。
+      }
+      const originalConfig = config ?? await recoveryConfig(record)
+      // Firemux 的交付恢复是独立接口；只在其明确返回交付失败时调用。
+      if (record.provider === 'minimax' && (record.errorCode === 'delivery_failed' || record.stage === 'transferring') && !record.resultUrl) {
+        const req = getVideoAdapter('minimax').buildPollRequest(originalConfig, record.taskId!)
+        const resp = await fetch(`${req.url}/recover`, { method: 'POST', headers: req.headers, signal: AbortSignal.timeout(30_000) })
+        if (!resp.ok) throw new Error(`Video delivery recovery HTTP ${resp.status}`)
+      }
+      await markPolling(id, record.taskId!)
+      await pollTask(record, originalConfig, record.taskId!)
+    })().catch(error => failTask(id, safeTaskError(error), 'recovery_failed')).finally(() => activeTasks.delete(id))
+  } catch (error) {
+    activeTasks.delete(id)
+    throw error
+  }
+}
+
+export async function recoverGenerationTask(id: number): Promise<void> {
+  const [record] = await db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id))
+  if (record?.type === 'video') return recoverVideoTask(id)
+  if (!record || record.type !== 'image') throw new Error('生成任务不存在')
+  if (['generation_failed', 'user_cancelled'].includes(record.errorCode || '')) throw new Error('原任务已结束，无法恢复')
+  if (activeTasks.has(id) || record.status === 'completed') return
+  if (!record.taskId) throw new Error('未保存上游任务编号，无法恢复')
+  activeTasks.add(id)
+  try {
+    const config = await recoveryConfig(record)
+    await db.update(schema.sysTask).set({ status: 'processing', errorMsg: null, errorCode: null, stage: 'polling', updatedAt: now() }).where(eq(schema.sysTask.id, id))
+    void pollTask(record, config, record.taskId).catch(error => failTask(id, safeTaskError(error), 'recovery_failed')).finally(() => activeTasks.delete(id))
+  } catch (error) { activeTasks.delete(id); throw error }
+}
+
+export async function resumeInterruptedTasks() {
+  const candidates = await db.select().from(schema.sysTask).where(or(eq(schema.sysTask.status, 'processing'), eq(schema.sysTask.status, 'failed'))).orderBy(desc(schema.sysTask.id))
+  const tasks = candidates.filter(task => task.status === 'processing' || (!task.errorCode && /^Timeout: (polling attempts exhausted|Polling exceeded 10 minutes)/.test(task.errorMsg || '')
+    && isLocalQueuedTask({ provider: task.provider || '', baseUrl: task.configBaseUrl || '' }, task.taskId)))
+  for (const task of tasks) {
+    if ((task.type === 'video' && (task.taskId || task.resultUrl)) || (task.type === 'image' && isLocalQueuedTask({ provider: task.provider || '', baseUrl: task.configBaseUrl || '' }, task.taskId))) {
+      try { await recoverGenerationTask(task.id) } catch (error) { await failTask(task.id, safeTaskError(error), 'recovery_failed') }
+    } else {
+      await failTask(task.id, task.type === 'video' ? '服务中断，提交结果待确认，请先核对上游记录' : '服务重启，生成任务中断，请重试',
+        task.type === 'video' ? 'submission_unknown' : 'interrupted')
+    }
+  }
+}
+
+// ─── 参考素材归一化 ───────────────────────────────────────────────
+
+async function normalizeReferenceImages(refs: string[] | null | undefined): Promise<string[]> {
+  if (!Array.isArray(refs) || !refs.length) return []
+
+  const deduped = Array.from(
+    new Set(
+      refs
+        .map((item) => String(item || '').trim())
+        .filter(Boolean),
+    ),
+  )
+
+  const normalized = await Promise.all(deduped.map(async (value) => {
+    if (value.startsWith('data:image/')) return value
+    if (value.startsWith('static/') || value.startsWith('/static/')) {
+      const localPath = value.startsWith('/static/') ? value.slice(1) : value
+      try {
+        return await readImageAsCompressedDataUrl(localPath, {
+          maxWidth: 768,
+          maxHeight: 768,
+          quality: 68,
+        })
+      } catch (err) {
+        logTaskWarn('ImageTask', 'reference-read-failed', { path: localPath, error: (err as Error).message })
+        throw new Error('参考图读取失败，请重新上传后再生成')
+      }
+    }
+    // 远程 URL：下载压缩为 data URL，保证 multipart 上传（OpenAI edits）/ inline_data（Gemini）都可用
+    if (/^https?:\/\//.test(value)) {
+      try {
+        return await fetchImageAsCompressedDataUrl(value, {
+          maxWidth: 768,
+          maxHeight: 768,
+          quality: 68,
+        })
+      } catch (err) {
+        logTaskWarn('ImageTask', 'reference-fetch-failed', { url: value, error: (err as Error).message })
+        throw new Error('参考图读取失败，请重新上传后再生成')
+      }
+    }
+    throw new Error('参考图地址无效，请重新上传后再生成')
+  }))
+
+  if (normalized.length > 6) throw new Error('参考图最多 6 张')
+  return normalized
+}
+
+async function normalizeVideoReferenceUrl(value: string | null | undefined): Promise<string | null> {
+  const raw = String(value || '').trim()
+  if (!raw) return null
+  if (raw.startsWith('data:image/')) return raw
+  if (raw.startsWith('static/') || raw.startsWith('/static/')) {
+    const localPath = raw.startsWith('/static/') ? raw.slice(1) : raw
+    try {
+      // 视频参考图直接编码原文件，保留原始尺寸、格式、透明通道和画质。
+      return readImageAsDataUrl(localPath)
+    } catch (err) {
+      logTaskWarn('VideoTask', 'reference-read-failed', { path: localPath, error: (err as Error).message })
+      return null
+    }
+  }
+  return raw
+}
+
+async function normalizeVideoReferenceUrls(refs: string[] | null | undefined): Promise<string[]> {
+  if (!Array.isArray(refs) || !refs.length) return []
+  const normalized = await Promise.all(
+    Array.from(new Set(refs.map((item) => String(item || '').trim()).filter(Boolean))).map((item) => normalizeVideoReferenceUrl(item)),
+  )
+  return normalized.filter((item): item is string => !!item)
+}
+
+/**
+ * 将参考视频/音频解析为 Seedance API 可访问的 URL。
+ * http(s)/dataURL 直通；本地 static 路径需要 PUBLIC_BASE_URL 拼成公网地址，
+ * 未配置时抛出可操作的中文错误（落入 catch 写入 error_msg 供前端展示）。
+ */
+function resolvePublicMediaUrl(value: string | null | undefined, kind: 'video' | 'audio' | 'file'): string | null {
+  const raw = String(value || '').trim()
+  if (!raw) return null
+  if (raw.startsWith('http://') || raw.startsWith('https://') || raw.startsWith('data:')) return raw
+  if (raw.startsWith('static/') || raw.startsWith('/static/')) {
+    const base = (process.env.PUBLIC_BASE_URL || '').trim().replace(/\/+$/, '')
+    if (!base) {
+      const label = kind === 'video' ? '视频' : kind === 'audio' ? '音频' : '文件'
+      throw new Error(
+        `参考${label}为本地路径 ${raw}，但后端未配置 PUBLIC_BASE_URL，上游视频生成 API 无法访问内网地址。` +
+        `请在 backend/.env 配置 PUBLIC_BASE_URL（如 https://your-domain.com）后重试，或改用公网 URL。`,
+      )
+    }
+    const p = raw.startsWith('/') ? raw : `/${raw}`
+    return `${base}${p}`
+  }
+  return raw
+}
+
+function resolvePublicMediaUrls(refs: string[] | null | undefined, kind: 'video' | 'audio'): string[] {
+  if (!Array.isArray(refs) || !refs.length) return []
+  const items = Array.from(new Set(refs.map((item) => String(item || '').trim()).filter(Boolean)))
+  return items.map((item) => resolvePublicMediaUrl(item, kind)).filter((item): item is string => !!item)
+}
+
+function normalizeStoredVideoResolution(resolution: string | null | undefined): string | undefined {
+  const value = String(resolution || '').trim().toLowerCase()
+  if (value === '480p' || value === '720p' || value === '1080p') return value
+  if (value === '2k') return '2K'
+  if (value === '4k') return '4K'
+  return undefined
+}
diff --git a/huobao-source/backend/src/services/local-task-tracking.ts b/huobao-source/backend/src/services/local-task-tracking.ts
new file mode 100644
index 0000000..b17069f
--- /dev/null
+++ b/huobao-source/backend/src/services/local-task-tracking.ts
@@ -0,0 +1,18 @@
+import { taskRouting } from './worker-routing.js'
+import type { AIConfig } from './adapters/types.js'
+
+export function isLocalQueuedTask(config: Pick<AIConfig, 'baseUrl' | 'provider'>, taskId?: string | null): boolean {
+  try {
+    const url = new URL(config.baseUrl)
+    return url.hostname === '192.168.110.111' && ['18792', '18794'].includes(url.port)
+      && !!taskRouting({ provider: config.provider, taskId })
+  } catch { return false }
+}
+
+export function taskPollingProfile(type: 'image' | 'video', local: boolean, hd = false) {
+  // Queue waiting and confirmed execution are not generation failures. These
+  // services retain job IDs, so tracking can resume without submitting again.
+  if (local) return { attempts: Infinity, intervalMs: 10_000, maxDurationMs: null }
+  if (type === 'image') return { attempts: 120, intervalMs: 5000, maxDurationMs: 600_000 }
+  return { attempts: hd ? 1080 : 300, intervalMs: 10_000, maxDurationMs: null }
+}
diff --git a/huobao-source/backend/src/services/reference-audio.ts b/huobao-source/backend/src/services/reference-audio.ts
new file mode 100644
index 0000000..1267b36
--- /dev/null
+++ b/huobao-source/backend/src/services/reference-audio.ts
@@ -0,0 +1,95 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { createHash, randomUUID } from 'node:crypto'
+import { STORAGE_ROOT } from '../utils/paths.js'
+import { ffmpeg, checkFfmpegSuite } from '../utils/ffmpeg.js'
+
+const MAX_BYTES = 15 * 1024 * 1024
+const INLINE_PROVIDERS = new Set(['volcengine', 'minimax'])
+
+function localAudioPath(url: string): string | null {
+  if (!/^\/?static\//.test(url)) return null
+  const file = path.resolve(STORAGE_ROOT, url.replace(/^\/?static\//, ''))
+  if (!file.startsWith(path.resolve(STORAGE_ROOT) + path.sep)) throw new Error('无效的本地音色路径')
+  return file
+}
+
+function publicAudioUrl(url: string): string {
+  const base = (process.env.PUBLIC_BASE_URL || '').trim().replace(/\/+$/, '')
+  if (!/^https?:\/\//.test(base)) {
+    throw new Error('当前视频模型需要公网音色地址。请配置后端 PUBLIC_BASE_URL，或切换至支持本地音色的 Seedance 2.0 / MiniMax H3。')
+  }
+  return `${base}/${url.replace(/^\//, '')}`
+}
+
+/** Validate before creating a paid task. M4A/AAC samples are converted without trimming the voice. */
+export async function prepareReferenceAudio(refs: string[] | undefined, provider: string): Promise<string[]> {
+  const urls = [...new Set((refs || []).map(url => url.trim()).filter(Boolean))]
+  const minSeconds = provider === 'aliyun' ? 1 : 2
+  let durationSum = 0
+  const prepared: string[] = []
+  for (const url of urls) {
+    const file = localAudioPath(url)
+    if (!file) { prepared.push(url); continue }
+    if (!INLINE_PROVIDERS.has(provider)) publicAudioUrl(url)
+    let size: number
+    try { size = (await fs.stat(file)).size } catch { throw new Error('角色音色文件不存在，请重新上传音色') }
+    const ext = path.extname(file).toLowerCase()
+    if (!['.mp3', '.wav', '.m4a', '.aac'].includes(ext)) throw new Error('参考音色仅支持 MP3、WAV、M4A 或 AAC')
+    if (size > 20 * 1024 * 1024) throw new Error('音色文件过大，请上传不超过 20MB 的音频')
+    const suite = await checkFfmpegSuite()
+    if (!suite.ffprobe) throw new Error('音色校验需要 FFprobe，请修复后端 FFprobe 配置后重试')
+    const duration = await new Promise<number>((resolve, reject) => {
+      ffmpeg.ffprobe(file, (error, metadata) => {
+        if (error || !metadata.streams.some(stream => stream.codec_type === 'audio')) {
+          reject(new Error('无法读取音色文件，请上传有效的人声音频')); return
+        }
+        resolve(Number(metadata.format.duration))
+      })
+    })
+    if (!Number.isFinite(duration) || duration < minSeconds || duration > 15) {
+      throw new Error(`当前模型要求每段参考音色为 ${minSeconds}–15 秒，请裁剪或重新上传`)
+    }
+    durationSum += duration
+    if (durationSum > 15.05) throw new Error('本次引用的音色总时长不能超过 15 秒，请减少引用或缩短音色样本')
+    if (ext === '.wav' || ext === '.mp3') {
+      if (size > MAX_BYTES) throw new Error('当前模型要求每段参考音色不超过 15MB，请压缩或重新上传')
+      prepared.push(url.replace(/^\//, ''))
+      continue
+    }
+    if (!suite.ffmpeg) throw new Error('M4A / AAC 音色需要 FFmpeg 转换，请修复配置或上传 WAV / MP3')
+    const hash = createHash('sha256').update(await fs.readFile(file)).digest('hex')
+    const relative = `static/voice-references/${hash}.wav`
+    const target = localAudioPath(relative)!
+    await fs.mkdir(path.dirname(target), { recursive: true })
+    try { await fs.access(target) } catch {
+      const temporary = `${target}.${randomUUID()}.wav`
+      try {
+        await new Promise<void>((resolve, reject) => {
+          ffmpeg(file).noVideo().audioChannels(1).audioFrequency(48000).audioCodec('pcm_s16le')
+            .format('wav').on('end', () => resolve()).on('error', () => reject(new Error('音色转换失败，请改用 WAV / MP3 文件'))).save(temporary)
+        })
+        await fs.rename(temporary, target)
+      } finally { await fs.rm(temporary, { force: true }) }
+    }
+    prepared.push(relative)
+  }
+  return prepared
+}
+
+/** Seedance 2.0 / MiniMax H3 accept audio data URLs; Wan requires a public/OSS URL.
+ * https://docs.volcengine.com/docs/ark/create-video-generation-task-api
+ * https://platform.minimax.cn/docs/api-reference/video-generation-v2-create
+ * https://help.aliyun.com/en/model-studio/wan3-video-generation-api-reference
+ */
+export async function resolveReferenceAudioUrls(refs: string[] | undefined, provider: string): Promise<string[]> {
+  return Promise.all((refs || []).map(async url => {
+    const file = localAudioPath(url)
+    if (!file) return url
+    if (!INLINE_PROVIDERS.has(provider)) return publicAudioUrl(url)
+    const bytes = await fs.readFile(file)
+    if (bytes.length > MAX_BYTES) throw new Error('参考音色不能超过 15MB')
+    const format = path.extname(file).toLowerCase() === '.mp3' ? 'mp3' : 'wav'
+    return `data:audio/${format};base64,${bytes.toString('base64')}`
+  }))
+}
diff --git a/huobao-source/backend/src/services/server-update.ts b/huobao-source/backend/src/services/server-update.ts
new file mode 100644
index 0000000..09d528f
--- /dev/null
+++ b/huobao-source/backend/src/services/server-update.ts
@@ -0,0 +1,120 @@
+/**
+ * 服务器 / Docker 部署的版本检查与更新触发
+ *
+ * - 版本检查：复用桌面版同一份发布清单（HUOBAO_UPDATE_FEED 的 latest.json）
+ * - 当前版本：构建时注入 HUOBAO_VERSION（Docker ARG / 环境变量），缺省回退 package.json
+ * - 一键更新：仅在配置 Watchtower（HUOBAO_WATCHTOWER_URL）时可用——容器不可变，
+ *   容器内自更新是反模式，正确路径是由 Watchtower 拉新镜像并重建本容器；
+ *   未配置时前端展示手动更新指引（docker compose pull && up -d）
+ */
+import { readFileSync } from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+// 双源：COS（国内直连）优先，GitHub（海外）兜底；HUOBAO_UPDATE_FEED 可整体覆盖
+const FEED_URLS = process.env.HUOBAO_UPDATE_FEED
+  ? [process.env.HUOBAO_UPDATE_FEED]
+  : [
+    'https://installer.firemux.site/huobao-drama/latest.json',
+    'https://github.com/chatfire-AI/huobao-drama/releases/latest/download/latest.json',
+  ]
+
+const WATCHTOWER_URL = process.env.HUOBAO_WATCHTOWER_URL?.replace(/\/+$/, '')
+const WATCHTOWER_TOKEN = process.env.HUOBAO_WATCHTOWER_TOKEN || ''
+
+export type ServerUpdateMode = 'watchtower' | 'manual'
+
+export interface ServerUpdateState {
+  status: 'idle' | 'up-to-date' | 'available' | 'error'
+  currentVersion: string
+  latestVersion?: string
+  notes?: string
+  error?: string
+  updateMode: ServerUpdateMode
+}
+
+let lastState: Omit<ServerUpdateState, 'updateMode'> | null = null
+
+function currentVersion(): string {
+  if (process.env.HUOBAO_VERSION) return process.env.HUOBAO_VERSION.replace(/^v/, '')
+  try {
+    const pkg = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../package.json')
+    return JSON.parse(readFileSync(pkg, 'utf-8')).version || '0.0.0'
+  } catch {
+    return '0.0.0'
+  }
+}
+
+export function updateMode(): ServerUpdateMode {
+  return WATCHTOWER_URL ? 'watchtower' : 'manual'
+}
+
+/** 与桌面版 updater.ts 同规则的三段数字比较 */
+function compareVersions(a: string, b: string): number {
+  const pa = a.replace(/^v/, '').split('.').map(n => parseInt(n, 10) || 0)
+  const pb = b.replace(/^v/, '').split('.').map(n => parseInt(n, 10) || 0)
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) !== (pb[i] ?? 0)) return (pa[i] ?? 0) - (pb[i] ?? 0)
+  }
+  return 0
+}
+
+/** GET /state — 当前版本 + 更新模式 + 上次检查结果（不触发网络请求） */
+export function getServerUpdateState(): ServerUpdateState {
+  return {
+    status: lastState?.status ?? 'idle',
+    currentVersion: currentVersion(),
+    latestVersion: lastState?.latestVersion,
+    notes: lastState?.notes,
+    error: lastState?.error,
+    updateMode: updateMode(),
+  }
+}
+
+/** POST /check — 拉取发布清单比较版本（双源依次尝试） */
+export async function checkServerUpdate(): Promise<ServerUpdateState> {
+  try {
+    let feed: any
+    let lastError: unknown
+    for (const url of FEED_URLS) {
+      try {
+        const res = await fetch(url, { signal: AbortSignal.timeout(15_000) })
+        if (!res.ok) throw new Error(`HTTP ${res.status}`)
+        feed = await res.json()
+        if (!feed?.version) throw new Error('版本清单格式不正确')
+        break
+      } catch (err) {
+        lastError = err
+      }
+    }
+    if (!feed) throw new Error(`版本清单请求失败（已尝试 ${FEED_URLS.length} 个源）：${(lastError as Error)?.message ?? ''}`)
+    const latestVersion = String(feed.version).replace(/^v/, '')
+    lastState = {
+      status: compareVersions(latestVersion, currentVersion()) > 0 ? 'available' : 'up-to-date',
+      currentVersion: currentVersion(),
+      latestVersion,
+      notes: feed.notes,
+    }
+  } catch (err) {
+    lastState = {
+      status: 'error',
+      currentVersion: currentVersion(),
+      error: (err as Error).message,
+    }
+  }
+  return getServerUpdateState()
+}
+
+/**
+ * POST /apply — 触发 Watchtower 立即检查并重建本容器
+ * Watchtower 异步执行：拉取新镜像 → 重建容器，本进程随后被替换，调用方只能拿到"已触发"
+ */
+export async function triggerWatchtowerUpdate(): Promise<void> {
+  if (!WATCHTOWER_URL) throw new Error('未配置 Watchtower（HUOBAO_WATCHTOWER_URL），无法应用内更新')
+  const res = await fetch(`${WATCHTOWER_URL}/v1/update`, {
+    method: 'POST',
+    headers: WATCHTOWER_TOKEN ? { Authorization: `Bearer ${WATCHTOWER_TOKEN}` } : {},
+    signal: AbortSignal.timeout(15_000),
+  })
+  if (!res.ok) throw new Error(`Watchtower 触发失败（HTTP ${res.status}）`)
+}
diff --git a/huobao-source/backend/src/services/style-preset.ts b/huobao-source/backend/src/services/style-preset.ts
new file mode 100644
index 0000000..c53a235
--- /dev/null
+++ b/huobao-source/backend/src/services/style-preset.ts
@@ -0,0 +1,16 @@
+/**
+ * 风格预设服务 — 将项目绑定的视觉风格解析为英文提示词片段
+ * dramas.style 存 style_presets.value；查不到/已停用时返回空串（调用方走兜底）
+ */
+import { and, eq } from 'drizzle-orm'
+import { db, schema } from '../db/index.js'
+
+/** 查询项目绑定的风格预设英文提示词片段；查不到返回 '' */
+export async function getDramaStylePrompt(dramaId: number | null | undefined): Promise<string> {
+  if (!dramaId) return ''
+  const [drama] = await db.select().from(schema.dramas).where(eq(schema.dramas.id, dramaId))
+  if (!drama?.style) return ''
+  const [preset] = await db.select().from(schema.stylePresets)
+    .where(and(eq(schema.stylePresets.value, drama.style), eq(schema.stylePresets.isActive, true)))
+  return preset?.prompt || ''
+}
diff --git a/huobao-source/backend/src/services/video-download.ts b/huobao-source/backend/src/services/video-download.ts
new file mode 100644
index 0000000..7588e7a
--- /dev/null
+++ b/huobao-source/backend/src/services/video-download.ts
@@ -0,0 +1,70 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { Readable, Transform } from 'node:stream'
+import { pipeline } from 'node:stream/promises'
+import { STORAGE_ROOT } from '../utils/paths.js'
+
+export class VideoDownloadError extends Error {
+  constructor(public code: string, message: string, public retryable = false) { super(message) }
+}
+
+/** 不把 API key、签名链接带到诊断文本、日志或剪贴板。 */
+export function safeTaskError(error: unknown): string {
+  return String(error instanceof Error ? error.message : error || 'Unknown failure')
+    .replace(/https?:\/\/[^\s"'<>]+/gi, '[URL omitted]')
+    .replace(/(Bearer\s+)\S+/gi, '$1[redacted]')
+    .replace(/((?:api[_-]?key|signature|token|secret)\s*["']?\s*[:=]\s*["']?)[^\s,"'}&]+/gi, '$1[redacted]')
+    .replace(/\bsk-[\w-]+/g, '[redacted]')
+    .slice(0, 600)
+}
+
+/** 下载到临时文件，校验容器头后原子改名；同任务重复恢复不会新增媒体文件。 */
+export async function downloadVideo(url: string, taskId: number, options: {
+  root?: string; attempts?: number; timeoutMs?: number; retryDelayMs?: number; maxBytes?: number
+} = {}): Promise<string> {
+  const parsed = new URL(url)
+  if (!['http:', 'https:'].includes(parsed.protocol)) throw new VideoDownloadError('download_url', 'Invalid video URL protocol')
+  const root = options.root ?? STORAGE_ROOT
+  const dir = path.join(root, 'videos')
+  await fs.promises.mkdir(dir, { recursive: true })
+  const partial = path.join(dir, `task-${taskId}.part`)
+  const attempts = options.attempts ?? 3
+  const maxBytes = options.maxBytes ?? 512 * 1024 * 1024
+  for (let attempt = 0; attempt < attempts; attempt++) {
+    try {
+      const signal = AbortSignal.timeout(options.timeoutMs ?? 120_000)
+      const resp = await fetch(url, { signal })
+      if (!resp.ok) {
+        await resp.body?.cancel()
+        throw new VideoDownloadError('download_http', `Video download HTTP ${resp.status}`, [408, 429].includes(resp.status) || resp.status >= 500)
+      }
+      if (Number(resp.headers.get('content-length')) > maxBytes) {
+        await resp.body?.cancel()
+        throw new VideoDownloadError('download_size', 'Video exceeds download size limit')
+      }
+      if (!resp.body) throw new VideoDownloadError('download_empty', 'Empty video response', true)
+      let bytes = 0
+      let head = Buffer.alloc(0)
+      const validator = new Transform({ transform(chunk, _encoding, callback) {
+        bytes += chunk.length
+        if (head.length < 16) head = Buffer.concat([head, chunk.subarray(0, 16 - head.length)])
+        if (bytes > maxBytes) return callback(new VideoDownloadError('download_size', 'Video exceeds download size limit'))
+        callback(null, chunk)
+      } })
+      await pipeline(Readable.fromWeb(resp.body as any), validator, fs.createWriteStream(partial), { signal })
+      const mp4 = head.length >= 12 && head.toString('ascii', 4, 8) === 'ftyp'
+      const webm = head.length >= 4 && head.readUInt32BE(0) === 0x1a45dfa3
+      if (!mp4 && !webm) throw new VideoDownloadError('download_format', 'Response is not an MP4 or WebM video')
+      const name = `task-${taskId}.${webm ? 'webm' : 'mp4'}`
+      await fs.promises.rename(partial, path.join(dir, name))
+      return `static/videos/${name}`
+    } catch (error) {
+      await fs.promises.rm(partial, { force: true })
+      const retryable = error instanceof VideoDownloadError ? error.retryable
+        : error instanceof TypeError || ['TimeoutError', 'AbortError'].includes((error as Error).name)
+      if (!retryable || attempt === attempts - 1) throw error
+      await new Promise(resolve => setTimeout(resolve, (options.retryDelayMs ?? 1000) * 2 ** attempt))
+    }
+  }
+  throw new VideoDownloadError('download_failed', 'Video download failed')
+}
diff --git a/huobao-source/backend/src/services/video-prompts.ts b/huobao-source/backend/src/services/video-prompts.ts
new file mode 100644
index 0000000..4b6bf09
--- /dev/null
+++ b/huobao-source/backend/src/services/video-prompts.ts
@@ -0,0 +1,108 @@
+/**
+ * 批量视频提示词任务 — 异步为缺少 video_prompt 的分镜逐个运行 prompt_generator Agent
+ * 进程内内存态：按集跟踪一份任务，运行中不重复启动；重启后状态丢失
+ */
+import { eq } from 'drizzle-orm'
+import { db, schema } from '../db/index.js'
+import { mastra } from '../mastra/index.js'
+import { buildAgentRequestContext } from '../agents/context.js'
+import { logTaskError, logTaskProgress, logTaskStart, logTaskSuccess } from '../utils/task-logger.js'
+
+export interface VideoPromptBatchStatus {
+  status: 'running' | 'done' | 'error'
+  total: number
+  completed: number
+  failed: number
+  current_storyboard_id?: number
+  started_at: string
+  finished_at?: string
+  error?: string
+}
+
+const tasks = new Map<number, VideoPromptBatchStatus>()
+
+/** 启动批量生成（立即返回）；运行中返回 started:false,total:-1；无待生成分镜返回 started:false,total:0；
+ *  传入 storyboardIds 时只处理所选分镜（即使已有提示词也重新生成），否则处理全部缺失提示词的分镜 */
+export async function startVideoPromptBatch(
+  episodeId: number,
+  dramaId: number,
+  opts: { model?: string; configId?: number } = {},
+  storyboardIds?: number[],
+): Promise<{ started: boolean; total: number }> {
+  if (tasks.get(episodeId)?.status === 'running') return { started: false, total: -1 }
+
+  const sbs = await db.select().from(schema.storyboards)
+    .where(eq(schema.storyboards.episodeId, episodeId))
+    .orderBy(schema.storyboards.storyboardNumber)
+  const pending = storyboardIds?.length
+    ? sbs.filter(sb => storyboardIds.includes(sb.id))
+    : sbs.filter(sb => !(sb.videoPrompt || '').trim())
+  if (!pending.length) return { started: false, total: 0 }
+
+  // 视频模型标签：跟随该集锁定的视频配置，供 Agent 按模型特性生成
+  const [ep] = await db.select().from(schema.episodes).where(eq(schema.episodes.id, episodeId))
+  let videoLabel = '默认'
+  if (ep?.videoConfigId) {
+    const [cfg] = await db.select().from(schema.aiServiceConfigs).where(eq(schema.aiServiceConfigs.id, ep.videoConfigId))
+    if (cfg) videoLabel = `${cfg.name} (${cfg.provider})`
+  }
+
+  const task: VideoPromptBatchStatus = {
+    status: 'running',
+    total: pending.length,
+    completed: 0,
+    failed: 0,
+    started_at: new Date().toISOString(),
+  }
+  tasks.set(episodeId, task)
+
+  logTaskStart('VideoPrompt', 'batch', { episodeId, dramaId, total: pending.length, model: opts.model || undefined })
+  ;(async () => {
+    const agent = mastra.getAgent('prompt_generator')
+    if (!agent) throw new Error('视频提示词 Agent 不可用')
+    const requestContext = buildAgentRequestContext({
+      episodeId,
+      dramaId,
+      modelOverride: opts.model || undefined,
+      textConfigId: opts.configId || undefined,
+    })
+    for (const sb of pending) {
+      task.current_storyboard_id = sb.id
+      logTaskProgress('VideoPrompt', 'batch-shot', { episodeId, storyboardId: sb.id, index: task.completed + task.failed + 1, total: task.total })
+      try {
+        await agent.generate([{
+          role: 'user',
+          content: `请为分镜 #${sb.storyboardNumber}(ID:${sb.id})生成视频提示词(video_prompt)。视频模型:${videoLabel},请根据该模型的特性和时长限制生成。
+请先调用 read_storyboard_context 获取该分镜的画面描述(含【镜头N】子镜头与台词/旁白)、氛围及时长，据此生成 video_prompt(第一行是信息头：列出该分镜出场的人物与场景，用 @角色名/@场景名 引用；之后按 3 秒分段换行、用 @角色名/@场景名/@道具名 引用参考素材；段落内允许多镜头切镜，段与段可以是不同景别/角度/对象，但不跨场景，切镜点对齐分镜 description 的【镜头N】结构),然后调用 update_storyboard 保存到分镜 ID:${sb.id}。update_storyboard 参数只传 storyboard_id 和 video_prompt 两个键,不要回传该分镜的其他任何字段,不要重新拆分整集。`,
+        }], { maxSteps: 8, requestContext })
+        // 以实际落库为准判定成败
+        const [fresh] = await db.select().from(schema.storyboards).where(eq(schema.storyboards.id, sb.id))
+        if ((fresh?.videoPrompt || '').trim()) task.completed++
+        else {
+          task.failed++
+          logTaskError('VideoPrompt', 'batch-shot', { storyboardId: sb.id, error: 'agent finished but video_prompt is empty' })
+        }
+      } catch (err: any) {
+        task.failed++
+        logTaskError('VideoPrompt', 'batch-shot', { storyboardId: sb.id, error: err?.message })
+      }
+    }
+  })()
+    .then(() => {
+      task.status = 'done'
+      task.finished_at = new Date().toISOString()
+      task.current_storyboard_id = undefined
+      logTaskSuccess('VideoPrompt', 'batch', { episodeId, total: task.total, completed: task.completed, failed: task.failed })
+    })
+    .catch((err: any) => {
+      task.status = 'error'
+      task.finished_at = new Date().toISOString()
+      task.error = err?.message || '批量生成失败'
+      logTaskError('VideoPrompt', 'batch', { episodeId, error: err?.message })
+    })
+  return { started: true, total: pending.length }
+}
+
+export function getVideoPromptBatchStatus(episodeId: number): VideoPromptBatchStatus | null {
+  return tasks.get(episodeId) || null
+}
diff --git a/huobao-source/backend/src/services/worker-routing.ts b/huobao-source/backend/src/services/worker-routing.ts
new file mode 100644
index 0000000..8f840b9
--- /dev/null
+++ b/huobao-source/backend/src/services/worker-routing.ts
@@ -0,0 +1,23 @@
+/** Stable worker IDs keep old jobs on their original queue after a routing upgrade. */
+export interface WorkerRouting { gpu: 'gpu1' | 'gpu2' | 'gpu3'; port: number | null; providerId: string; legacy: boolean }
+const workers: Record<string, WorkerRouting> = {
+  default: { gpu: 'gpu2', port: 8188, providerId: 'default', legacy: false },
+  gpu1_8189: { gpu: 'gpu1', port: 8189, providerId: 'gpu1_8189', legacy: false },
+  gpu3: { gpu: 'gpu3', port: 8191, providerId: 'gpu3', legacy: false },
+  gpu1: { gpu: 'gpu1', port: null, providerId: 'gpu1', legacy: true },
+}
+export function parseWorkerRouting(value: any): WorkerRouting | null {
+  const expected = workers[value?.providerId]
+  return expected && value.gpu === expected.gpu && value.port === expected.port ? { ...expected } : null
+}
+export function taskRouting(task: { params?: string | null; taskId?: string | null; provider?: string | null }): WorkerRouting | null {
+  if (!['minimax', 'localvideo', 'openai'].includes(task.provider || '')) return null
+  try { const route = parseWorkerRouting(JSON.parse(task.params || '{}').routing); if (route) return route } catch {}
+  try {
+    const encoded = (task.taskId || '').replace(/^h3[av][12]\./, '')
+    const decoded = Buffer.from(encoded, 'base64url').toString('utf8')
+    const [providerId, id] = decoded.split(':')
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id || '')) return null
+    return workers[providerId] ? { ...workers[providerId] } : null
+  } catch { return null }
+}
diff --git a/huobao-source/backend/src/utils/audio-upload.ts b/huobao-source/backend/src/utils/audio-upload.ts
new file mode 100644
index 0000000..e36df84
--- /dev/null
+++ b/huobao-source/backend/src/utils/audio-upload.ts
@@ -0,0 +1,22 @@
+import { saveUploadedFile } from './storage.js'
+
+export const AUDIO_MAX_BYTES = 20 * 1024 * 1024
+const AUDIO_EXT = new Set(['.mp3', '.wav', '.m4a', '.aac'])
+const AUDIO_MIME = new Set(['audio/mpeg', 'audio/mp3', 'audio/wav', 'audio/x-wav', 'audio/wave', 'audio/vnd.wave', 'audio/mp4', 'audio/x-m4a', 'audio/aac', 'audio/x-aac'])
+
+export class AudioUploadError extends Error {}
+
+/** 音色与视频参考音频共用上传规则，文件名仅用于显示，磁盘使用 UUID。 */
+export async function saveAudioUpload(file: unknown) {
+  if (!(file instanceof File)) throw new AudioUploadError('文件必填')
+  const name = file.name.split(/[\\/]/).pop()!.replace(/[\u0000-\u001f\u007f]/g, '').slice(0, 255)
+  const ext = file.name.slice(file.name.lastIndexOf('.')).toLowerCase()
+  const mime = file.type.toLowerCase()
+  if (!AUDIO_EXT.has(ext) || (mime && mime !== 'application/octet-stream' && !AUDIO_MIME.has(mime))) {
+    throw new AudioUploadError('仅支持 .mp3/.wav/.m4a/.aac 格式的音频文件')
+  }
+  if (!file.size) throw new AudioUploadError('音频文件不能为空')
+  if (file.size > AUDIO_MAX_BYTES) throw new AudioUploadError('音频文件大小不能超过 20MB')
+  const path = await saveUploadedFile(await file.arrayBuffer(), 'uploads', `voice${ext}`)
+  return { path, name, url: `/${path}` }
+}
diff --git a/huobao-source/backend/src/utils/dirsize.ts b/huobao-source/backend/src/utils/dirsize.ts
new file mode 100644
index 0000000..cdbc81a
--- /dev/null
+++ b/huobao-source/backend/src/utils/dirsize.ts
@@ -0,0 +1,86 @@
+/**
+ * 数据目录占用统计 + 磁盘剩余空间
+ *
+ * - dirUsage：单次异步递归 walk（fs.promises，不阻塞事件循环），按相对路径归桶
+ * - 数据库文件（huobao.sqlite3/-wal/-shm）不在 walk 中重复计数，单独 stat
+ *   （server 模式 STORAGE_PATH 覆盖时 SQLITE_PATH 可能位于数据根之外）
+ */
+import type { Dirent } from 'fs'
+import fsp from 'fs/promises'
+import path from 'path'
+
+export interface UsageBuckets {
+  db: number
+  images: number
+  videos: number
+  merged: number
+  uploads: number
+  temp: number
+  other: number
+  total: number
+}
+
+const DB_FILE_BASE = 'huobao.sqlite3'
+
+/** 递归 walk，对每个普通文件回调（完整路径 + 大小）；目录不可读/文件竞态静默跳过 */
+async function walkFiles(dir: string, onFile: (filePath: string, size: number) => void): Promise<void> {
+  let entries: Dirent[]
+  try {
+    entries = await fsp.readdir(dir, { withFileTypes: true })
+  } catch {
+    return
+  }
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      await walkFiles(full, onFile)
+    } else if (entry.isFile()) {
+      try {
+        const st = await fsp.stat(full)
+        onFile(full, st.size)
+      } catch { /* 文件在 walk 期间消失等竞态，忽略 */ }
+    }
+  }
+}
+
+/** 统计数据目录占用（按用途分桶）；db 桶 = SQLITE_PATH 主库 + -wal/-shm 三文件 */
+export async function dirUsage(dataRoot: string, sqlitePath: string): Promise<UsageBuckets> {
+  const usage: UsageBuckets = { db: 0, images: 0, videos: 0, merged: 0, uploads: 0, temp: 0, other: 0, total: 0 }
+  const add = (bucket: keyof UsageBuckets, size: number) => {
+    usage[bucket] += size
+    usage.total += size
+  }
+
+  // db 桶：直接 stat 三个文件（无论是否在 dataRoot 内，walk 侧会跳过避免双计）
+  for (const suffix of ['', '-wal', '-shm']) {
+    try {
+      const st = await fsp.stat(sqlitePath + suffix)
+      if (st.isFile()) add('db', st.size)
+    } catch { /* 文件不存在（如未开 WAL 时 -wal 缺失）*/ }
+  }
+
+  await walkFiles(dataRoot, (filePath, size) => {
+    const rel = path.relative(dataRoot, filePath)
+    if (rel === DB_FILE_BASE || rel.startsWith(DB_FILE_BASE + '-')) return // 已单独计入 db 桶
+    const parts = rel.split(path.sep)
+    if (parts[0] === 'static' && parts.length >= 2) {
+      const sub = parts[1]
+      if (sub === 'images' || sub === 'videos' || sub === 'merged' || sub === 'uploads' || sub === 'temp') {
+        add(sub, size)
+        return
+      }
+    }
+    add('other', size)
+  })
+  return usage
+}
+
+/** 目标目录所在卷的剩余字节；statfs 不可用时返回 null（调用方跳过空间校验） */
+export async function volumeFreeBytes(dir: string): Promise<number | null> {
+  try {
+    const st = await fsp.statfs(dir)
+    return st.bavail * st.bsize
+  } catch {
+    return null
+  }
+}
diff --git a/huobao-source/backend/src/utils/ffmpeg.ts b/huobao-source/backend/src/utils/ffmpeg.ts
new file mode 100644
index 0000000..d63433d
--- /dev/null
+++ b/huobao-source/backend/src/utils/ffmpeg.ts
@@ -0,0 +1,87 @@
+/**
+ * FFmpeg 统一配置与可用性探测
+ *
+ * 背景：Windows 上若 node_modules 跨平台拷贝、或 ffmpeg-static postinstall
+ * 下载损坏（HTML 错误页被存成 ffmpeg.exe），spawn 非 PE 文件会同步抛
+ * EFTYPE；该异常发生在 fluent-ffmpeg 的延迟回调里，外层 try/catch 接不住，
+ * 直接崩掉整个 Node 进程。这里在业务调用前主动 spawn -version 探测，
+ * 不可用时由业务侧优雅降级（海报帧跳过 / 拼接返回明确错误）。
+ */
+import { spawn } from 'child_process'
+import fs from 'fs'
+import ffmpeg from 'fluent-ffmpeg'
+import { createRequire } from 'module'
+
+// ffmpeg-static / ffprobe-static 均为可选依赖：npm 安装时提供内置二进制；
+// 桌面版打包不携带这两个 npm 包（二进制随 resources/bin 分发），缺失时走 FFMPEG_BIN/FFPROBE_BIN
+const req = createRequire(import.meta.url)
+
+function resolveStatic(moduleName: string): string | null {
+  try {
+    const mod = req(moduleName)
+    return (moduleName === 'ffprobe-static' ? mod?.path : mod) ?? null
+  } catch {
+    return null
+  }
+}
+
+const ffmpegPath = process.env.FFMPEG_BIN || resolveStatic('ffmpeg-static')
+const ffprobePath = process.env.FFPROBE_BIN || resolveStatic('ffprobe-static')
+
+// 系统未安装 ffmpeg 时使用项目内置二进制
+if (ffmpegPath) ffmpeg.setFfmpegPath(ffmpegPath)
+if (ffprobePath) ffmpeg.setFfprobePath(ffprobePath)
+
+export { ffmpeg }
+
+/** spawn 一次 -version 验证二进制真实可执行（含同步 EFTYPE 兜底） */
+function probeBinary(binPath: string | null): Promise<boolean> {
+  if (!binPath || !fs.existsSync(binPath)) return Promise.resolve(false)
+  return new Promise((resolve) => {
+    let settled = false
+    const finish = (ok: boolean) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      resolve(ok)
+    }
+    const timer = setTimeout(() => finish(false), 10_000)
+    let child
+    try {
+      child = spawn(binPath, ['-version'], { stdio: 'ignore', windowsHide: true })
+    } catch {
+      // Windows 上 spawn 非 PE 文件（如下载损坏的 ffmpeg.exe）会同步抛 EFTYPE
+      finish(false)
+      return
+    }
+    child.on('error', () => finish(false))
+    child.on('close', (code) => finish(code === 0))
+  })
+}
+
+export interface FfmpegSuite {
+  ffmpeg: boolean
+  ffprobe: boolean
+}
+
+// 成功的探测结果缓存（进程内只探测一次）；失败不缓存，修复二进制后无需重启即可恢复
+let okCache: FfmpegSuite | null = null
+let warned = false
+
+/** 探测内置 ffmpeg/ffprobe 是否可用 */
+export async function checkFfmpegSuite(): Promise<FfmpegSuite> {
+  if (okCache) return okCache
+  const [ffmpegOk, ffprobeOk] = await Promise.all([probeBinary(ffmpegPath), probeBinary(ffprobePath)])
+  const suite = { ffmpeg: ffmpegOk, ffprobe: ffprobeOk }
+  if (ffmpegOk && ffprobeOk) {
+    okCache = suite
+  } else if (!warned) {
+    warned = true
+    console.warn(
+      `[ffmpeg] 内置二进制不可用 (ffmpeg=${ffmpegOk ? 'ok' : 'FAIL'}, ffprobe=${ffprobeOk ? 'ok' : 'FAIL'})。` +
+      `海报帧提取与视频拼接将跳过/失败。修复：删除 node_modules 后在本机重新 npm install，` +
+      `或设置 FFMPEG_BIN/FFPROBE_BIN 指向有效的可执行文件`
+    )
+  }
+  return suite
+}
diff --git a/huobao-source/backend/src/utils/paths.ts b/huobao-source/backend/src/utils/paths.ts
new file mode 100644
index 0000000..f6626dc
--- /dev/null
+++ b/huobao-source/backend/src/utils/paths.ts
@@ -0,0 +1,23 @@
+/**
+ * 数据目录统一解析 — 全项目唯一的路径锚点
+ *
+ * dev：锚定仓库根 data/（__dirname 相对推断，src 与 tsc 产物深度一致）。
+ * Electron 桌面版：主进程注入 HUOBAO_DATA_DIR 指向 userData 可写目录
+ * （打包后 asar 内的 __dirname 相对推断不可用，写路径必须落在包外）。
+ *
+ * STORAGE_PATH 语义保持不变：仅覆盖 static 存储根；未注入 HUOBAO_DATA_DIR
+ * 时以其父目录为数据根，保证 getAbsolutePath('static/...') 的既有行为。
+ */
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+// src/utils → 上三级为仓库根
+const repoRoot = path.resolve(__dirname, '../../..')
+
+export const DATA_ROOT = process.env.HUOBAO_DATA_DIR
+  ?? (process.env.STORAGE_PATH
+    ? path.dirname(path.resolve(process.env.STORAGE_PATH))
+    : path.join(repoRoot, 'data'))
+
+export const STORAGE_ROOT = process.env.STORAGE_PATH ?? path.join(DATA_ROOT, 'static')
diff --git a/huobao-source/backend/src/utils/response.ts b/huobao-source/backend/src/utils/response.ts
new file mode 100644
index 0000000..3a71714
--- /dev/null
+++ b/huobao-source/backend/src/utils/response.ts
@@ -0,0 +1,25 @@
+import type { Context } from 'hono'
+
+export function success(c: Context, data: any = null) {
+  return c.json({ code: 200, data, message: 'success' })
+}
+
+export function created(c: Context, data: any = null) {
+  return c.json({ code: 201, data, message: 'created' }, 201)
+}
+
+export function badRequest(c: Context, message = '请求参数错误') {
+  return c.json({ code: 400, message }, 400)
+}
+
+export function notFound(c: Context, message = '资源不存在') {
+  return c.json({ code: 404, message }, 404)
+}
+
+export function serverError(c: Context, message = '服务器内部错误') {
+  return c.json({ code: 500, message }, 500)
+}
+
+export function now() {
+  return new Date().toISOString()
+}
diff --git a/huobao-source/backend/src/utils/storage.ts b/huobao-source/backend/src/utils/storage.ts
new file mode 100644
index 0000000..ffb055d
--- /dev/null
+++ b/huobao-source/backend/src/utils/storage.ts
@@ -0,0 +1,199 @@
+/**
+ * 文件存储工具 — 下载远程文件到本地
+ */
+import fs from 'fs'
+import path from 'path'
+import sharp from 'sharp'
+import { v4 as uuid } from 'uuid'
+import { STORAGE_ROOT } from './paths.js'
+
+/**
+ * 下载远程文件到本地存储
+ */
+export async function downloadFile(url: string, subDir: string): Promise<string> {
+  const dir = path.join(STORAGE_ROOT, subDir)
+  fs.mkdirSync(dir, { recursive: true })
+
+  const ext = getExtFromUrl(url)
+  const filename = `${uuid()}${ext}`
+  const filePath = path.join(dir, filename)
+
+  const resp = await fetch(url)
+  if (!resp.ok) throw new Error(`Download failed: ${resp.status}`)
+
+  const buffer = Buffer.from(await resp.arrayBuffer())
+  fs.writeFileSync(filePath, buffer)
+
+  // 返回相对路径（供 API 返回给前端）
+  return `static/${subDir}/${filename}`
+}
+
+/**
+ * 保存上传的文件
+ */
+export async function saveUploadedFile(data: ArrayBuffer, subDir: string, originalName: string): Promise<string> {
+  const dir = path.join(STORAGE_ROOT, subDir)
+  fs.mkdirSync(dir, { recursive: true })
+
+  const ext = path.extname(originalName) || '.bin'
+  const filename = `${uuid()}${ext}`
+  const filePath = path.join(dir, filename)
+
+  fs.writeFileSync(filePath, Buffer.from(data))
+  return `static/${subDir}/${filename}`
+}
+
+function getExtFromUrl(url: string): string {
+  try {
+    const pathname = new URL(url).pathname
+    const ext = path.extname(pathname)
+    if (ext && ext.length <= 5) return ext
+  } catch {}
+  return '.bin'
+}
+
+/**
+ * 获取本地文件的绝对路径
+ */
+export function getAbsolutePath(relativePath: string): string {
+  if (relativePath.startsWith('static/')) {
+    return path.join(STORAGE_ROOT, '..', relativePath)
+  }
+  return path.join(STORAGE_ROOT, relativePath)
+}
+
+/**
+ * 保存 Base64 编码的图片数据到本地存储
+ * 用于 Gemini 等只返回 base64 数据的厂商
+ */
+export async function saveBase64Image(base64Data: string, mimeType: string, subDir: string): Promise<string> {
+  const dir = path.join(STORAGE_ROOT, subDir)
+  fs.mkdirSync(dir, { recursive: true })
+
+  // 从 mimeType 推断文件扩展名
+  const ext = mimeTypeToExt(mimeType)
+  const filename = `${uuid()}${ext}`
+  const filePath = path.join(dir, filename)
+
+  const buffer = Buffer.from(base64Data, 'base64')
+  fs.writeFileSync(filePath, buffer)
+
+  return `static/${subDir}/${filename}`
+}
+
+/** 由图片相对路径推导缩略图路径：static/images/x.png → static/images/x_thumb.webp */
+export function thumbPathFor(relativePath: string): string {
+  return relativePath.replace(/\.[^./]+$/, '_thumb.webp')
+}
+
+/**
+ * 为已落盘图片生成列表页缩略图（宽 400 WebP，与原图同目录）。
+ * 失败（文件损坏/格式异常等）返回 null，不阻断主流程。
+ */
+export async function generateImageThumb(relativePath: string): Promise<string | null> {
+  try {
+    const thumbRel = thumbPathFor(relativePath)
+    await sharp(getAbsolutePath(relativePath))
+      .rotate()
+      .resize({ width: 400, withoutEnlargement: true })
+      .webp({ quality: 78 })
+      .toFile(getAbsolutePath(thumbRel))
+    return thumbRel
+  } catch (err) {
+    console.warn(`[storage] 缩略图生成失败 ${relativePath}:`, (err as Error).message)
+    return null
+  }
+}
+
+export function readImageAsDataUrl(relativePath: string): string {
+  const filePath = getAbsolutePath(relativePath)
+  const buffer = fs.readFileSync(filePath)
+  const ext = path.extname(filePath).toLowerCase()
+  const mimeType = extToMimeType(ext)
+  return `data:${mimeType};base64,${buffer.toString('base64')}`
+}
+
+export async function readImageAsCompressedDataUrl(
+  relativePath: string,
+  options: {
+    maxWidth?: number
+    maxHeight?: number
+    quality?: number
+  } = {},
+): Promise<string> {
+  return compressImageAsDataUrl(getAbsolutePath(relativePath), options)
+}
+
+/**
+ * 下载远程图片并压缩为 data URL（远程参考图归一化，供 multipart/base64 上传类厂商使用）
+ */
+export async function fetchImageAsCompressedDataUrl(
+  url: string,
+  options: {
+    maxWidth?: number
+    maxHeight?: number
+    quality?: number
+  } = {},
+): Promise<string> {
+  const resp = await fetch(url, { signal: AbortSignal.timeout(30_000) })
+  if (!resp.ok) throw new Error(`下载参考图失败: HTTP ${resp.status}`)
+  return compressImageAsDataUrl(Buffer.from(await resp.arrayBuffer()), options)
+}
+
+/** sharp 输入 → 压缩 JPEG data URL（本地路径与远程下载共享同一压缩管线） */
+async function compressImageAsDataUrl(
+  input: string | Buffer,
+  options: {
+    maxWidth?: number
+    maxHeight?: number
+    quality?: number
+  } = {},
+): Promise<string> {
+  const maxWidth = options.maxWidth ?? 768
+  const maxHeight = options.maxHeight ?? 768
+  const quality = options.quality ?? 68
+
+  const resized = sharp(input).rotate().resize({
+    width: maxWidth,
+    height: maxHeight,
+    fit: 'inside',
+    withoutEnlargement: true,
+  })
+  const metadata = await resized.metadata()
+  const output = metadata.hasAlpha
+    ? await resized.flatten({ background: '#ffffff' }).jpeg({ quality, mozjpeg: true }).toBuffer()
+    : await resized.jpeg({ quality, mozjpeg: true }).toBuffer()
+  const mimeType = 'image/jpeg'
+  return `data:${mimeType};base64,${output.toString('base64')}`
+}
+
+export function parseDataUrl(dataUrl: string): { mimeType: string; data: string } | null {
+  const match = String(dataUrl || '').match(/^data:([^;]+);base64,(.+)$/)
+  if (!match) return null
+  return {
+    mimeType: match[1],
+    data: match[2],
+  }
+}
+
+function mimeTypeToExt(mimeType: string): string {
+  const map: Record<string, string> = {
+    'image/png': '.png',
+    'image/jpeg': '.jpg',
+    'image/jpg': '.jpg',
+    'image/webp': '.webp',
+    'image/gif': '.gif',
+  }
+  return map[mimeType] || '.png'
+}
+
+function extToMimeType(ext: string): string {
+  const map: Record<string, string> = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.gif': 'image/gif',
+  }
+  return map[ext] || 'image/png'
+}
diff --git a/huobao-source/backend/src/utils/task-logger.ts b/huobao-source/backend/src/utils/task-logger.ts
new file mode 100644
index 0000000..fa22bd6
--- /dev/null
+++ b/huobao-source/backend/src/utils/task-logger.ts
@@ -0,0 +1,146 @@
+type LogLevel = 'INFO' | 'WARN' | 'ERROR' | 'SUCCESS'
+
+const C = {
+  reset: '\x1b[0m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+  blue: '\x1b[34m',
+}
+
+function colorFor(level: LogLevel) {
+  if (level === 'SUCCESS') return C.green
+  if (level === 'WARN') return C.yellow
+  if (level === 'ERROR') return C.red
+  return C.cyan
+}
+
+function timeText() {
+  return new Date().toLocaleTimeString('zh-CN', { hour12: false })
+}
+
+function safeValue(value: unknown) {
+  if (value == null) return value
+  if (typeof value === 'string') return value
+  if (typeof value === 'number' || typeof value === 'boolean') return value
+  try {
+    return JSON.stringify(value)
+  } catch {
+    return String(value)
+  }
+}
+
+function formatMeta(meta?: Record<string, unknown>) {
+  if (!meta) return ''
+  const entries = Object.entries(meta)
+    .filter(([, value]) => value !== undefined)
+    .map(([key, value]) => `${key}=${safeValue(value)}`)
+  return entries.length ? ` | ${entries.join(' ')}` : ''
+}
+
+export function redactUrl(rawUrl: string) {
+  if (rawUrl.startsWith('data:')) return `${rawUrl.slice(0, rawUrl.indexOf(',') + 1)}<omitted>`
+  try {
+    const url = new URL(rawUrl)
+    for (const key of [...url.searchParams.keys()]) {
+      if (/key|token|sign|credential|secret/i.test(key)) {
+        url.searchParams.set(key, '***')
+      }
+    }
+    if (url.username) url.username = '***'
+    if (url.password) url.password = '***'
+    return url.toString()
+  } catch {
+    return rawUrl
+      .replace(/([?&](?:key|api_key|apikey|token|access_token|sign|signature|sig)=)[^&]+/gi, '$1***')
+  }
+}
+
+function sanitizeValue(value: unknown): unknown {
+  if (value == null) return value
+  if (typeof value === 'string') return truncateString(value)
+  if (typeof value === 'number' || typeof value === 'boolean') return value
+
+  if (Array.isArray(value)) {
+    return value.map(item => sanitizeValue(item))
+  }
+
+  if (typeof value === 'object') {
+    const out: Record<string, unknown> = {}
+    for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {
+      const lower = key.toLowerCase()
+      if (['authorization', 'api_key', 'apikey', 'apiKey', 'token', 'access_token'].includes(key) ||
+        lower.includes('authorization') || lower.includes('token') || lower.includes('apikey') || lower.includes('api_key')) {
+        out[key] = '***'
+        continue
+      }
+
+      if (typeof raw === 'string' && (lower === 'url' || lower.endsWith('url'))) {
+        out[key] = redactUrl(raw)
+        continue
+      }
+
+      if (typeof raw === 'string' && (
+        lower === 'data' ||
+        lower === 'b64_json' ||
+        lower.includes('base64') ||
+        lower.includes('audiohex') ||
+        lower.includes('inline') ||
+        raw.startsWith('data:image/')
+      )) {
+        out[key] = truncateString(raw, 48)
+        continue
+      }
+
+      out[key] = sanitizeValue(raw)
+    }
+    return out
+  }
+
+  try {
+    return JSON.parse(JSON.stringify(value))
+  } catch {
+    return String(value)
+  }
+}
+
+function truncateString(value: string, edge = 120) {
+  if (value.length <= edge * 2 + 24) return value
+  return `${value.slice(0, edge)}...<trimmed ${value.length} chars>...${value.slice(-edge)}`
+}
+
+export function logTask(scope: string, action: string, meta?: Record<string, unknown>, level: LogLevel = 'INFO') {
+  const color = colorFor(level)
+  console.log(`${C.dim}${timeText()}${C.reset} ${color}[${scope}]${C.reset} ${action}${formatMeta(meta)}`)
+}
+
+export function logTaskStart(scope: string, action: string, meta?: Record<string, unknown>) {
+  logTask(scope, `START ${action}`, meta, 'INFO')
+}
+
+export function logTaskProgress(scope: string, action: string, meta?: Record<string, unknown>) {
+  logTask(scope, action, meta, 'INFO')
+}
+
+export function logTaskSuccess(scope: string, action: string, meta?: Record<string, unknown>) {
+  logTask(scope, `DONE ${action}`, meta, 'SUCCESS')
+}
+
+export function logTaskWarn(scope: string, action: string, meta?: Record<string, unknown>) {
+  logTask(scope, action, meta, 'WARN')
+}
+
+export function logTaskError(scope: string, action: string, meta?: Record<string, unknown>) {
+  logTask(scope, `ERROR ${action}`, meta, 'ERROR')
+}
+
+export function logTaskPayload(scope: string, action: string, payload: unknown) {
+  const sanitized = sanitizeValue(payload)
+  const serialized = typeof sanitized === 'string'
+    ? sanitized
+    : JSON.stringify(sanitized, null, 2)
+  console.log(`${C.dim}${timeText()}${C.reset} ${C.blue}[${scope}]${C.reset} ${action}\n${serialized}`)
+}
diff --git a/huobao-source/backend/src/utils/transform.ts b/huobao-source/backend/src/utils/transform.ts
new file mode 100644
index 0000000..eb8a7e3
--- /dev/null
+++ b/huobao-source/backend/src/utils/transform.ts
@@ -0,0 +1,16 @@
+/**
+ * 将 Drizzle 返回的 camelCase 对象转换为 snake_case
+ * 保持前端 API 兼容（和旧 Go 后端一致）
+ */
+export function toSnakeCase(obj: Record<string, any>): Record<string, any> {
+  const result: Record<string, any> = {}
+  for (const [key, value] of Object.entries(obj)) {
+    const snakeKey = key.replace(/[A-Z]/g, m => '_' + m.toLowerCase())
+    result[snakeKey] = value
+  }
+  return result
+}
+
+export function toSnakeCaseArray(arr: Record<string, any>[]): Record<string, any>[] {
+  return arr.map(toSnakeCase)
+}
diff --git a/huobao-source/backend/src/utils/video-poster.ts b/huobao-source/backend/src/utils/video-poster.ts
new file mode 100644
index 0000000..981fc17
--- /dev/null
+++ b/huobao-source/backend/src/utils/video-poster.ts
@@ -0,0 +1,42 @@
+/**
+ * 视频海报帧提取 — 供 <video poster> 使用，避免列表页为显示首帧而缓冲整个视频
+ */
+import path from 'path'
+import { getAbsolutePath } from './storage.js'
+import { ffmpeg, checkFfmpegSuite } from './ffmpeg.js'
+
+/** 由视频相对路径推导海报帧路径：static/videos/x.mp4 → static/videos/x_poster.jpg */
+export function posterPathFor(relativePath: string): string {
+  return relativePath.replace(/\.[^./]+$/, '_poster.jpg')
+}
+
+/**
+ * 抽取视频 0.5s 处画面作为海报帧（宽 640，等比缩放，与原视频同目录）。
+ * 失败返回 null，不阻断主流程。
+ */
+export async function extractVideoPoster(relativePath: string): Promise<string | null> {
+  try {
+    // ffmpeg 二进制损坏（跨平台拷贝 node_modules / 下载不完整）时静默跳过，
+    // 避免 fluent-ffmpeg 延迟回调里的同步 EFTYPE 崩掉整个进程
+    const { ffmpeg: ffmpegOk } = await checkFfmpegSuite()
+    if (!ffmpegOk) return null
+
+    const posterRel = posterPathFor(relativePath)
+    const posterAbs = getAbsolutePath(posterRel)
+    await new Promise<void>((resolve, reject) => {
+      ffmpeg(getAbsolutePath(relativePath))
+        .screenshots({
+          timestamps: ['0.5'],
+          filename: path.basename(posterAbs),
+          folder: path.dirname(posterAbs),
+          size: '640x?',
+        })
+        .on('end', () => resolve())
+        .on('error', reject)
+    })
+    return posterRel
+  } catch (err) {
+    console.warn(`[video-poster] 海报帧提取失败 ${relativePath}:`, (err as Error).message)
+    return null
+  }
+}
diff --git a/huobao-source/backend/tests/aliyun-wan3-video.test.ts b/huobao-source/backend/tests/aliyun-wan3-video.test.ts
new file mode 100644
index 0000000..45d06a3
--- /dev/null
+++ b/huobao-source/backend/tests/aliyun-wan3-video.test.ts
@@ -0,0 +1,95 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+import { AliyunWanVideoAdapter } from '../src/services/adapters/aliyun-wan-video'
+
+const adapter = new AliyunWanVideoAdapter()
+const config = {
+  provider: 'aliyun',
+  baseUrl: 'https://ws-123.cn-beijing.maas.aliyuncs.com',
+  apiKey: 'sk-test',
+  model: 'wan3.0-video-prime',
+}
+
+test('Wan 3.0 request follows the official input/media/parameters contract', () => {
+  const request = adapter.buildGenerateRequest(config, {
+    id: 1,
+    prompt: '@图片1女孩 走进视频1的房间',
+    referenceImageUrls: JSON.stringify(['https://example.com/1.png']),
+    referenceVideoUrls: JSON.stringify(['https://example.com/1.mp4']),
+    referenceAudioUrls: JSON.stringify(['https://example.com/1.mp3']),
+    referenceFileUrl: 'https://example.com/brief.pdf',
+    duration: -1,
+    aspectRatio: 'adaptive',
+    resolution: '1080p',
+    generateAudio: false,
+    seed: 42,
+    promptExtend: false,
+    watermark: true,
+  })
+
+  assert.equal(request.url, 'https://ws-123.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis')
+  assert.equal(request.method, 'POST')
+  assert.equal(request.headers.Authorization, 'Bearer sk-test')
+  assert.equal(request.headers['X-DashScope-Async'], 'enable')
+  assert.deepEqual(request.body, {
+    model: 'wan3.0-video-prime',
+    input: {
+      prompt: '图1女孩 走进视频1的房间',
+      media: [
+        { type: 'reference_image', url: 'https://example.com/1.png' },
+        { type: 'reference_video', url: 'https://example.com/1.mp4' },
+        { type: 'reference_audio', url: 'https://example.com/1.mp3' },
+        { type: 'file', url: 'https://example.com/brief.pdf' },
+      ],
+    },
+    parameters: {
+      resolution: '1080P',
+      ratio: 'adaptive',
+      duration: -1,
+      audio: false,
+      prompt_extend: false,
+      watermark: true,
+      seed: 42,
+    },
+  })
+})
+
+test('Wan 3.0 supports official first/last frame mode and rejects mixed media modes', () => {
+  const request = adapter.buildGenerateRequest(config, {
+    id: 2,
+    prompt: '从白天过渡到黑夜',
+    firstFrameUrl: 'data:image/png;base64,first',
+    lastFrameUrl: 'data:image/png;base64,last',
+  })
+
+  assert.deepEqual(request.body.input.media, [
+    { type: 'first_frame', url: 'data:image/png;base64,first' },
+    { type: 'last_frame', url: 'data:image/png;base64,last' },
+  ])
+  assert.throws(() => adapter.buildGenerateRequest(config, {
+    id: 3,
+    firstFrameUrl: 'https://example.com/first.png',
+    referenceAudioUrls: JSON.stringify(['https://example.com/ref.mp3']),
+  }), /first_frame\/last_frame/)
+})
+
+test('Wan 3.0 parses official async creation and polling responses', () => {
+  assert.deepEqual(adapter.parseGenerateResponse({
+    output: { task_status: 'PENDING', task_id: 'task-123' },
+    request_id: 'request-1',
+  }), { isAsync: true, taskId: 'task-123' })
+
+  assert.deepEqual(adapter.parsePollResponse({
+    output: { task_status: 'SUCCEEDED', video_url: 'https://example.com/result.mp4' },
+    usage: { output_video_duration: 7.5, fps: 30, SR: 1080, ratio: '16:9' },
+    request_id: 'request-2',
+  }), { status: 'completed', videoUrl: 'https://example.com/result.mp4', duration: 7.5 })
+
+  assert.deepEqual(adapter.parsePollResponse({
+    output: { task_status: 'FAILED', code: 'InvalidParameter', message: 'bad media combination' },
+    request_id: 'request-3',
+  }), {
+    status: 'failed',
+    error: '[InvalidParameter] bad media combination (request_id: request-3)',
+  })
+})
diff --git a/huobao-source/backend/tests/asset-crud-structure.test.mjs b/huobao-source/backend/tests/asset-crud-structure.test.mjs
new file mode 100644
index 0000000..bd881f1
--- /dev/null
+++ b/huobao-source/backend/tests/asset-crud-structure.test.mjs
@@ -0,0 +1,42 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('characters route supports manual create and soft delete', () => {
+  const route = read('src/routes/characters.ts')
+
+  assert.match(route, /app\.post\('\/'/)
+  assert.match(route, /name required/)
+  // 传入 episode_id 时关联到该集
+  assert.match(route, /insert\(schema\.episodeCharacters\)/)
+  // 软删除
+  assert.match(route, /app\.delete\('\/:id'/)
+  assert.match(route, /deletedAt: now\(\)/)
+  assert.doesNotMatch(route, /db\.delete\(schema\.characters\)/)
+})
+
+test('scenes route links new scenes to episode and soft deletes', () => {
+  const route = read('src/routes/scenes.ts')
+
+  assert.match(route, /app\.post\('\/'/)
+  assert.match(route, /location required/)
+  assert.match(route, /insert\(schema\.episodeScenes\)/)
+  // 软删除（原为硬删，保留历史生成记录）
+  assert.match(route, /app\.delete\('\/:id'/)
+  assert.match(route, /deletedAt: now\(\)/)
+  assert.doesNotMatch(route, /db\.delete\(schema\.scenes\)/)
+})
+
+test('props route supports manual create and soft delete', () => {
+  const route = read('src/routes/props.ts')
+
+  assert.match(route, /app\.post\('\/'/)
+  assert.match(route, /name required/)
+  assert.match(route, /insert\(schema\.episodeProps\)/)
+  assert.match(route, /app\.delete\('\/:id'/)
+  assert.match(route, /deletedAt: now\(\)/)
+  assert.doesNotMatch(route, /db\.delete\(schema\.props\)/)
+})
diff --git a/huobao-source/backend/tests/asset-extract-structure.test.mjs b/huobao-source/backend/tests/asset-extract-structure.test.mjs
new file mode 100644
index 0000000..8425939
--- /dev/null
+++ b/huobao-source/backend/tests/asset-extract-structure.test.mjs
@@ -0,0 +1,66 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('extraction service runs per-target async tasks', () => {
+  const svc = read('src/services/extraction.ts')
+
+  // 三类资产目标
+  assert.match(svc, /'characters' \| 'scenes' \| 'props'/)
+  assert.match(svc, /EXTRACT_TARGETS.*characters.*scenes.*props/s)
+  // 按 集×类型 键控的内存任务表
+  assert.match(svc, /`\$\{episodeId\}:\$\{target\}`/)
+  assert.match(svc, /status: 'running' \| 'done' \| 'error'/)
+  // 同集同类型运行中不重复启动
+  assert.match(svc, /tasks\.get\(key\)\?\.status === 'running'\)\s*return false/)
+  // 每类资产限定只提取该类型
+  assert.match(svc, /本次只提取角色/)
+  assert.match(svc, /本次只提取场景/)
+  assert.match(svc, /本次只提取道具/)
+  // fire-and-forget 异步执行 extractor Agent
+  assert.match(svc, /mastra\.getAgent\('extractor'\)/)
+  assert.match(svc, /\.then\(\(result[^)]*\) => \{[\s\S]*status = 'done'/)
+  assert.match(svc, /\.catch\(\(err/)
+  // 逐步打印 Agent 进展（工具调用 + 文本），完成时打印汇总
+  assert.match(svc, /onStepFinish/)
+  assert.match(svc, /-step/)
+  assert.match(svc, /toolCalls/)
+})
+
+test('extraction tools dedupe by normalized name so near-names reuse existing assets', () => {
+  const tools = read('src/agents/tools/extract-tools.ts')
+
+  // 归一化：括号定位/别名后缀去除 + 空白/大小写统一
+  assert.match(tools, /normalizeName\(name: string\)/)
+  assert.match(tools, /replace\(\/\[（\(]/) // 中/英文括号字符类
+  assert.match(tools, /replace\(\/\[\\s/) // 空白字符类
+  assert.match(tools, /\.toLowerCase\(\)/)
+  // 角色保存：精确匹配优先，归一化近名兜底，命中即复用不重复创建
+  assert.match(tools, /normalizeName\(c\.name\) === normName/)
+  assert.match(tools, /matchedViaNorm/)
+  assert.match(tools, /save-characters-reuse/)
+  // 道具同样按归一化名字复用
+  assert.match(tools, /normalizeName\(p\.name\) === normName/)
+  assert.match(tools, /save-props-reuse/)
+  // 场景按 地点+时间 匹配，地点仅做空白/大小写归一化（不删括号）
+  assert.match(tools, /normalizeLocation\(loc: string\)/)
+  assert.match(tools, /normalizeLocation\(s\.location\) === normLocation/)
+  // read_existing_* 返回归一化字段供 Agent 判断复用
+  assert.match(tools, /normalized_name: normalizeName/)
+  assert.match(tools, /normalized_location: normalizeLocation/)
+})
+
+test('episodes route exposes async extract endpoints', () => {
+  const route = read('src/routes/episodes.ts')
+
+  assert.match(route, /app\.post\('\/:id\/extract'/)
+  assert.match(route, /app\.get\('\/:id\/extract-status'/)
+  assert.match(route, /target 必须是 characters \/ scenes \/ props/)
+  assert.match(route, /startExtraction\(ep\.id, ep\.dramaId, target, \{ model: body\.model/)
+  // 顶栏文本模型覆盖透传到提取 Agent
+  assert.match(read('src/services/extraction.ts'), /modelOverride: opts\.model/)
+  assert.match(route, /getExtractionStatus\(id\)/)
+})
diff --git a/huobao-source/backend/tests/character-image-generation.test.mjs b/huobao-source/backend/tests/character-image-generation.test.mjs
new file mode 100644
index 0000000..13ca6ba
--- /dev/null
+++ b/huobao-source/backend/tests/character-image-generation.test.mjs
@@ -0,0 +1,15 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('character image generation uses 16:9 asset size', () => {
+  const source = read('src/routes/characters.ts')
+
+  assert.match(source, /CHARACTER_IMAGE_SIZE = '1920x1080'/)
+  assert.match(source, /16:9 横版角色定妆照/)
+  assert.match(source, /半身角色海报构图/)
+  assert.match(source, /size: CHARACTER_IMAGE_SIZE/)
+})
diff --git a/huobao-source/backend/tests/character-voice.test.ts b/huobao-source/backend/tests/character-voice.test.ts
new file mode 100644
index 0000000..c49a873
--- /dev/null
+++ b/huobao-source/backend/tests/character-voice.test.ts
@@ -0,0 +1,151 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import Database from 'better-sqlite3'
+import { Hono } from 'hono'
+import { serveStatic } from '@hono/node-server/serve-static'
+import { eq } from 'drizzle-orm'
+import { initSqliteSchema } from '../src/db/sqlite-schema.ts'
+import { requestLogger } from '../src/middleware/logger.ts'
+
+const root = await fs.mkdtemp(path.join(os.tmpdir(), 'huobao-character-voice-'))
+process.env.SQLITE_PATH = path.join(root, 'test.sqlite3')
+process.env.HUOBAO_DATA_DIR = root
+process.env.STORAGE_PATH = path.join(root, 'static')
+process.env.MYSQL_AUTO_IMPORT = 'false'
+const { db, schema } = await import('../src/db/index.ts')
+const app = new Hono()
+app.route('/characters', (await import('../src/routes/characters.ts')).default)
+app.route('/episodes', (await import('../src/routes/episodes.ts')).default)
+app.route('/dramas', (await import('../src/routes/dramas.ts')).default)
+app.route('/upload', (await import('../src/routes/upload.ts')).default)
+app.use('/static/*', serveStatic({ root }))
+const ts = new Date().toISOString()
+const drama = db.insert(schema.dramas).values({ title: 'Voice test', createdAt: ts, updatedAt: ts }).returning().get()
+const character = () => db.insert(schema.characters).values({ dramaId: drama.id, name: '角色', appearance: '原外貌', imageUrl: 'static/images/portrait.png', createdAt: ts, updatedAt: ts }).returning().get()
+const row = (id: number) => db.select().from(schema.characters).where(eq(schema.characters.id, id)).get()!
+const sample = Buffer.alloc(48)
+sample.write('RIFF'); sample.writeUInt32LE(40, 4); sample.write('WAVEfmt ', 8)
+sample.writeUInt32LE(16, 16); sample.writeUInt16LE(1, 20); sample.writeUInt16LE(1, 22)
+sample.writeUInt32LE(8000, 24); sample.writeUInt32LE(16000, 28)
+sample.writeUInt16LE(2, 32); sample.writeUInt16LE(16, 34); sample.write('data', 36); sample.writeUInt32LE(4, 40)
+async function upload(id: number, name = '角色音色.wav', data: Uint8Array = sample, type = 'audio/wav') {
+  const body = new FormData()
+  body.set('file', new File([data], name, { type }))
+  return app.request(`/characters/${id}/voice`, { method: 'POST', body })
+}
+
+test('existing SQLite characters gain nullable voice fields without losing assets; migration is idempotent', () => {
+  const old = new Database(':memory:')
+  try {
+    old.exec(`CREATE TABLE characters (id INTEGER PRIMARY KEY AUTOINCREMENT, drama_id INTEGER NOT NULL,
+      name TEXT NOT NULL, role TEXT, description TEXT, appearance TEXT, styling TEXT, final_prompt TEXT,
+      personality TEXT, image_url TEXT, reference_images TEXT, seed_value TEXT, sort_order INTEGER,
+      local_path TEXT, created_at TEXT NOT NULL, updated_at TEXT NOT NULL, deleted_at TEXT);
+      INSERT INTO characters (drama_id, name, image_url, created_at, updated_at) VALUES (1, '已有角色', 'portrait.png', 'old', 'old')`)
+    initSqliteSchema(old)
+    initSqliteSchema(old)
+    assert.deepEqual(old.prepare('SELECT name, image_url, voice_audio_url, voice_audio_name FROM characters').get(),
+      { name: '已有角色', image_url: 'portrait.png', voice_audio_url: null, voice_audio_name: null })
+  } finally { old.close() }
+})
+
+test('uploaded voice persists, can be served, and is shared by the project and multiple episodes', async () => {
+  const char = character()
+  const result = await upload(char.id)
+  assert.equal(result.status, 200)
+  const { data } = await result.json()
+  assert.equal(data.voice_audio_name, '角色音色.wav')
+  assert.match(data.voice_audio_url, /^static\/uploads\/[\w-]+\.wav$/)
+  const disk = new Database(process.env.SQLITE_PATH!, { readonly: true })
+  try { assert.equal((disk.prepare('SELECT voice_audio_url FROM characters WHERE id = ?').get(char.id) as any).voice_audio_url, data.voice_audio_url) }
+  finally { disk.close() }
+  const audio = await app.request(`/${data.voice_audio_url}`)
+  assert.equal(audio.status, 200)
+  assert.deepEqual(Buffer.from(await audio.arrayBuffer()), sample)
+  for (const number of [1, 2]) {
+    const episode = db.insert(schema.episodes).values({ dramaId: drama.id, episodeNumber: number, title: '测试集', createdAt: ts, updatedAt: ts }).returning().get()
+    db.insert(schema.episodeCharacters).values({ episodeId: episode.id, characterId: char.id, createdAt: ts }).run()
+    const response = await app.request(`/episodes/${episode.id}/characters`)
+    assert.equal((await response.json()).data[0].voice_audio_url, data.voice_audio_url)
+  }
+  const project = await app.request(`/dramas/${drama.id}`)
+  assert.equal((await project.json()).data.characters.find((c: any) => c.id === char.id).voice_audio_name, '角色音色.wav')
+  await app.request(`/characters/${char.id}`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ appearance: '新外貌' }) })
+  assert.equal(row(char.id).voiceAudioUrl, data.voice_audio_url)
+})
+
+test('replacement and removal change only the voice binding', async () => {
+  const char = character()
+  await upload(char.id)
+  const original = row(char.id).voiceAudioUrl
+  const replacement = await upload(char.id, '第二段.WAV', sample, 'audio/x-wav')
+  assert.equal(replacement.status, 200)
+  assert.notEqual(row(char.id).voiceAudioUrl, original)
+  assert.equal(row(char.id).voiceAudioName, '第二段.WAV')
+  const removed = await app.request(`/characters/${char.id}/voice`, { method: 'DELETE' })
+  assert.equal(removed.status, 200)
+  assert.deepEqual((await removed.json()).data, { voice_audio_url: null, voice_audio_name: null })
+  assert.equal(row(char.id).voiceAudioUrl, null)
+  assert.equal(row(char.id).appearance, '原外貌')
+  assert.equal(row(char.id).imageUrl, char.imageUrl)
+})
+
+test('invalid, missing, empty and oversized uploads retain the current voice', async () => {
+  const char = character()
+  await upload(char.id)
+  const original = row(char.id).voiceAudioUrl
+  const cases: [string, Uint8Array, string][] = [
+    ['image.png', sample, 'image/png'], ['fake.wav', sample, 'text/html'],
+    ['empty.wav', new Uint8Array(), 'audio/wav'],
+    ['large.wav', new Uint8Array(20 * 1024 * 1024 + 1), 'audio/wav'],
+    ['too-large.wav', new Uint8Array(21 * 1024 * 1024), 'audio/wav'],
+  ]
+  for (const [name, bytes, type] of cases) {
+    assert.equal((await upload(char.id, name, bytes, type)).status, 400, name)
+    assert.equal(row(char.id).voiceAudioUrl, original)
+  }
+  assert.equal((await app.request(`/characters/${char.id}/voice`, { method: 'POST', body: new FormData() })).status, 400)
+})
+
+test('missing and deleted characters cannot acquire audio files', async () => {
+  const before = await fs.readdir(path.join(root, 'static/uploads'))
+  assert.equal((await upload(999999)).status, 404)
+  const char = character()
+  db.update(schema.characters).set({ deletedAt: ts }).where(eq(schema.characters.id, char.id)).run()
+  assert.equal((await upload(char.id)).status, 404)
+  assert.equal((await app.request(`/characters/${char.id}/voice`, { method: 'DELETE' })).status, 404)
+  assert.deepEqual(await fs.readdir(path.join(root, 'static/uploads')), before)
+})
+
+test('generic reference audio uploads still use the shared file contract', async () => {
+  const body = new FormData()
+  body.set('file', new File([sample], 'reference.wav', { type: 'audio/wav' }))
+  const result = await app.request('/upload/audio', { method: 'POST', body })
+  assert.equal(result.status, 200)
+  const { data } = await result.json()
+  assert.equal(data.url, `/${data.path}`)
+  assert.equal((await app.request(data.url)).status, 200)
+})
+
+test('request logging preserves the upload stream and omits audio contents', async t => {
+  const messages: string[] = []
+  const logger = t.mock.method(console, 'log', (...args: unknown[]) => messages.push(args.join(' ')))
+  try {
+    const logged = new Hono()
+    logged.use('*', requestLogger)
+    logged.route('/', app)
+    const char = character()
+    const body = new FormData()
+    body.set('file', new File([sample], 'private-recording.wav', { type: 'audio/wav' }))
+    const result = await logged.request(`/characters/${char.id}/voice`, { method: 'POST', body })
+    assert.equal(result.status, 200)
+    assert.equal(row(char.id).voiceAudioName, 'private-recording.wav')
+    assert.match(messages.join('\n'), /POST/)
+    assert.doesNotMatch(messages.join('\n'), /private-recording|RIFF|body:|Content-Disposition/)
+  } finally { logger.mock.restore() }
+})
+
+test.after(async () => { db.$client.close(); await fs.rm(root, { recursive: true, force: true }) })
diff --git a/huobao-source/backend/tests/episode-auto-config-structure.test.mjs b/huobao-source/backend/tests/episode-auto-config-structure.test.mjs
new file mode 100644
index 0000000..2cf7839
--- /dev/null
+++ b/huobao-source/backend/tests/episode-auto-config-structure.test.mjs
@@ -0,0 +1,29 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('POST /episodes auto-locks configs when not provided', () => {
+  const route = read('src/routes/episodes.ts')
+  const ai = read('src/services/ai.ts')
+
+  // 不再强制要求 config id
+  assert.doesNotMatch(route, /image_config_id and video_config_id are required/)
+  // 通过 getActiveConfigId 自动锁定
+  assert.match(route, /getActiveConfigId\('image'\)/)
+  assert.match(route, /getActiveConfigId\('video'\)/)
+  // ai.ts 提供 getActiveConfigId
+  assert.match(ai, /export async function getActiveConfigId/)
+  // 找不到启用配置时给可操作的错误提示
+  assert.match(route, /未找到启用的图片生成配置/)
+  assert.match(route, /未找到启用的视频生成配置/)
+})
+
+test('POST /episodes still honors explicit config ids when caller passes them', () => {
+  const route = read('src/routes/episodes.ts')
+
+  assert.match(route, /body\.image_config_id \?\? await getActiveConfigId/)
+  assert.match(route, /body\.video_config_id \?\? await getActiveConfigId/)
+})
\ No newline at end of file
diff --git a/huobao-source/backend/tests/episode-delete-structure.test.mjs b/huobao-source/backend/tests/episode-delete-structure.test.mjs
new file mode 100644
index 0000000..0abf100
--- /dev/null
+++ b/huobao-source/backend/tests/episode-delete-structure.test.mjs
@@ -0,0 +1,27 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('episodes route exposes soft delete', () => {
+  const route = read('src/routes/episodes.ts')
+
+  assert.match(route, /app\.delete\('\/:id'/)
+  assert.match(route, /set\(\{ deletedAt: now\(\)/)
+  assert.match(route, /剧集不存在/)
+  // 无硬删
+  assert.doesNotMatch(route, /db\.delete\(schema\.episodes\)/)
+})
+
+test('drama queries exclude soft-deleted episodes', () => {
+  const dramas = read('src/routes/dramas.ts')
+
+  // 列表聚合与详情都过滤 deletedAt
+  const matches = dramas.match(/isNull\(schema\.episodes\.deletedAt\)/g) || []
+  assert.ok(matches.length >= 2, `expected >=2 deletedAt filters, got ${matches.length}`)
+  // 新建集时下一集号也忽略软删集
+  const episodes = read('src/routes/episodes.ts')
+  assert.match(episodes, /isNull\(schema\.episodes\.deletedAt\)/)
+})
diff --git a/huobao-source/backend/tests/final-prompt-structure.test.mjs b/huobao-source/backend/tests/final-prompt-structure.test.mjs
new file mode 100644
index 0000000..cfec794
--- /dev/null
+++ b/huobao-source/backend/tests/final-prompt-structure.test.mjs
@@ -0,0 +1,82 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('characters and scenes tables store the agent-written final prompt', () => {
+  const schema = read('src/db/schema.ts')
+  const mysql = read('src/db/mysql-schema.ts')
+
+  // Drizzle 表定义
+  assert.match(schema, /export const characters = mysqlTable\('characters'[\s\S]*?finalPrompt: text\('final_prompt'\)/)
+  assert.match(schema, /export const scenes = mysqlTable\('scenes'[\s\S]*?finalPrompt: text\('final_prompt'\)/)
+  // 新建表 DDL + 存量表 backfill
+  assert.match(mysql, /CREATE TABLE IF NOT EXISTS characters \([\s\S]*?final_prompt TEXT/)
+  assert.match(mysql, /CREATE TABLE IF NOT EXISTS scenes \([\s\S]*?final_prompt TEXT/)
+  assert.match(mysql, /table: 'characters', column: 'final_prompt'/)
+  assert.match(mysql, /table: 'scenes', column: 'final_prompt'/)
+})
+
+test('grid prompt agent tools save agent-written final prompts with style injection', () => {
+  const tools = read('src/agents/tools/image-prompt-tools.ts')
+
+  assert.match(tools, /save_character_final_prompt/)
+  assert.match(tools, /save_scene_final_prompt/)
+  // 保存时注入项目视觉风格并落库
+  assert.match(tools, /getDramaStylePrompt/)
+  assert.match(tools, /set\(\{ finalPrompt, updatedAt: now\(\) \}\)/)
+  // 提示词由 Agent 创作，不再由工具机械拼接
+  assert.doesNotMatch(tools, /generate_character_prompt/)
+  assert.doesNotMatch(tools, /generate_scene_prompt/)
+})
+
+test('prompt agent instructions reference per-asset skills; skill files define the specs', () => {
+  const agents = read('src/agents/index.ts')
+  const settings = read('../frontend/app/pages/settings.vue')
+  const charSkill = read('workspace/skills/prompt-generator/character-prompt/SKILL.md')
+  const sceneSkill = read('workspace/skills/prompt-generator/scene-prompt/SKILL.md')
+
+  for (const src of [agents, settings]) {
+    // 三类图片规范入口（具体创作规则在各自 SKILL.md 中）
+    assert.match(src, /角色三视图/)
+    assert.match(src, /场景固定视角/)
+    assert.match(src, /道具白底单品/)
+    // 保存工具约定
+    assert.match(src, /save_character_final_prompt/)
+    assert.match(src, /save_scene_final_prompt/)
+  }
+  // 角色三视图 / 场景固定视角的必备要素由技能文件承载（纯中文输出）
+  assert.match(charSkill, /正脸特写/)
+  assert.match(charSkill, /正面、90 度侧面、背面/)
+  assert.match(charSkill, /三个视图的脸、发型和服装完全一致/)
+  assert.match(charSkill, /纯中文/)
+  assert.match(sceneSkill, /固定机位广角镜头/)
+  assert.match(sceneSkill, /前景（\[前景元素\]）、中景（\[中景主体空间\]）、后景（\[后景纵深\]）/)
+  assert.match(sceneSkill, /出入口/)
+  assert.match(sceneSkill, /纯中文/)
+})
+
+test('image generation prefers the stored final prompt with agent generation and legacy fallback', () => {
+  const service = read('src/services/final-prompt.ts')
+  const characters = read('src/routes/characters.ts')
+  const scenes = read('src/routes/scenes.ts')
+
+  assert.match(service, /export async function ensureCharacterFinalPrompt/)
+  assert.match(service, /export async function ensureSceneFinalPrompt/)
+  assert.match(service, /getAgent\('prompt_generator'/)
+  // 已有最终提示词直接复用（force 时忽略强制重新生成）
+  assert.match(service, /if \(char\.finalPrompt && !force\) return char\.finalPrompt/)
+  assert.match(service, /if \(scene\.finalPrompt && !force\) return scene\.finalPrompt/)
+  assert.match(service, /force = false/)
+
+  assert.match(characters, /ensureCharacterFinalPrompt\(char, ep\.id, /)
+  // 文本模型覆盖（text_model/text_config_id）透传到提示词 Agent
+  assert.match(characters, /text_model/)
+  assert.match(characters, /finalPrompt \|\| characterImagePrompt\(char, stylePrompt\)/)
+  assert.match(scenes, /ensureSceneFinalPrompt\(scene, ep\.id, /)
+  // 描述字段编辑后最终提示词失效
+  assert.match(characters, /updates\.finalPrompt = null/)
+  assert.match(scenes, /updates\.finalPrompt = null/)
+})
diff --git a/huobao-source/backend/tests/merge-direct-video-structure.test.mjs b/huobao-source/backend/tests/merge-direct-video-structure.test.mjs
new file mode 100644
index 0000000..6672614
--- /dev/null
+++ b/huobao-source/backend/tests/merge-direct-video-structure.test.mjs
@@ -0,0 +1,24 @@
+import { existsSync, readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const mergeService = readFileSync(new URL('../src/services/ffmpeg-merge.ts', import.meta.url), 'utf8')
+const episodesRoute = readFileSync(new URL('../src/routes/episodes.ts', import.meta.url), 'utf8')
+const backendIndex = readFileSync(new URL('../src/index.ts', import.meta.url), 'utf8')
+const useApi = readFileSync(new URL('../../frontend/app/composables/useApi.ts', import.meta.url), 'utf8')
+const composeRoutePath = new URL('../src/routes/compose.ts', import.meta.url)
+const composeServicePath = new URL('../src/services/ffmpeg-compose.ts', import.meta.url)
+
+test('episode merge uses generated videos directly without requiring compose output', () => {
+  assert.doesNotMatch(mergeService, /Only composed storyboards can be merged/)
+  assert.match(mergeService, /sb\.videoUrl\s*\|\|\s*sb\.composedVideoUrl/)
+  assert.match(mergeService, /readyVideos\.length !== storyboards\.length/)
+})
+
+test('compose workflow is no longer exposed through API surfaces', () => {
+  assert.doesNotMatch(episodesRoute, /compose_shots/)
+  assert.doesNotMatch(backendIndex, /api\.route\('\/compose'/)
+  assert.doesNotMatch(useApi, /export const composeAPI/)
+  assert.equal(existsSync(composeRoutePath), false)
+  assert.equal(existsSync(composeServicePath), false)
+})
diff --git a/huobao-source/backend/tests/official-provider-adapters.test.mjs b/huobao-source/backend/tests/official-provider-adapters.test.mjs
new file mode 100644
index 0000000..4ccc236
--- /dev/null
+++ b/huobao-source/backend/tests/official-provider-adapters.test.mjs
@@ -0,0 +1,197 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+const routeBlock = (source, route) => {
+  const start = source.indexOf(route)
+  assert.notEqual(start, -1, `Missing route: ${route}`)
+  const next = source.indexOf('\n// ', start + route.length)
+  return source.slice(start, next === -1 ? source.length : next)
+}
+
+test('backend provider registry does not expose ChatFire as a model provider', () => {
+  const registry = read('src/services/adapters/registry.ts')
+  const ai = read('src/services/ai.ts')
+  const aiConfigRoute = read('src/routes/aiConfigs.ts')
+  const useApi = read('../frontend/app/composables/useApi.ts')
+
+  assert.doesNotMatch(registry, /chatfire/i)
+  assert.doesNotMatch(ai, /chatfire/i)
+  assert.doesNotMatch(ai, /openrouter/i)
+  assert.doesNotMatch(aiConfigRoute, /api\.firemux\.com/i)
+  assert.doesNotMatch(aiConfigRoute, /provider:\s*'chatfire'/i)
+  assert.doesNotMatch(aiConfigRoute, /openrouter/i)
+  assert.doesNotMatch(aiConfigRoute, /\/huobao-preset/)
+  assert.doesNotMatch(useApi, /huobaoPreset/)
+})
+
+test('text agents use the official Gemini provider for gemini configs', () => {
+  const agents = read('src/agents/index.ts')
+
+  assert.match(agents, /createGoogleGenerativeAI/)
+  assert.match(agents, /providerName === 'gemini'/)
+  assert.match(agents, /googleProvider\(\s*modelName\s*\)/)
+})
+
+test('text agents keep OpenAI provider routing for non-Gemini configs', () => {
+  const agents = read('src/agents/index.ts')
+
+  assert.match(agents, /createOpenAI/)
+  assert.match(agents, /const provider = createOpenAI\(/)
+  assert.match(agents, /return provider\.chat\(modelName\)/)
+})
+
+test('text provider base URL handling uses official Gemini v1beta endpoint', () => {
+  const ai = read('src/services/ai.ts')
+
+  assert.match(ai, /provider === 'gemini'/)
+  assert.match(ai, /return joinProviderUrl\(config\.baseUrl,\s*'\/v1beta',\s*''\)/)
+})
+
+test('backend rejects unsupported providers at DB and route boundaries', () => {
+  const ai = read('src/services/ai.ts')
+  const route = read('src/routes/aiConfigs.ts')
+
+  assert.match(ai, /officialProviders/)
+  assert.match(ai, /text:\s*\[\s*'openai',\s*'gemini',\s*'volcengine'\s*\]/)
+  assert.match(ai, /image:\s*\[\s*'openai',\s*'gemini',\s*'volcengine'\s*\]/)
+  assert.match(ai, /video:\s*\[\s*'volcengine',\s*'minimax',\s*'aliyun'\s*\]/)
+  assert.doesNotMatch(ai, /'deepseek'/)
+  assert.doesNotMatch(ai, /'ali'/)
+  assert.doesNotMatch(ai, /'vidu'/)
+  assert.doesNotMatch(ai, /audio:\s*\[/)
+  assert.match(ai, /isOfficialProvider/)
+  assert.match(ai, /isOfficialProvider\(serviceType,\s*r\.provider\)/)
+  assert.match(ai, /isOfficialProvider\(row\.serviceType as ServiceType,\s*row\.provider\)/)
+
+  assert.match(route, /isOfficialProvider/)
+  assert.match(route, /isOfficialProvider\(body\.service_type,\s*body\.provider\)/)
+  assert.match(route, /isOfficialProvider\(serviceType,\s*provider\)/)
+  assert.match(route, /不支持的 service_type\/provider/)
+})
+
+test('AI config routes reject unsupported service/provider pairs in create, test, and update paths', () => {
+  const route = read('src/routes/aiConfigs.ts')
+  const createRoute = routeBlock(route, "app.post('/',")
+  const testRoute = routeBlock(route, "app.post('/test',")
+  const updateRoute = routeBlock(route, "app.put('/:id',")
+
+  assert.match(createRoute, /if \(!body\.service_type \|\| !body\.provider\)/)
+  assert.match(createRoute, /isOfficialProvider\(body\.service_type,\s*body\.provider\)/)
+  assert.match(createRoute, /badRequest\(c,\s*'不支持的 service_type\/provider'\)/)
+
+  assert.match(testRoute, /if \(!body\.service_type \|\| !body\.provider \|\| !body\.base_url\)/)
+  assert.match(testRoute, /isOfficialProvider\(body\.service_type,\s*body\.provider\)/)
+  assert.match(testRoute, /badRequest\(c,\s*'不支持的 service_type\/provider'\)/)
+
+  assert.match(updateRoute, /const serviceType = 'service_type' in body \? body\.service_type : existing\.serviceType/)
+  assert.match(updateRoute, /const provider = 'provider' in body \? body\.provider : existing\.provider/)
+  assert.doesNotMatch(updateRoute, /body\.service_type \|\| existing\.serviceType/)
+  assert.doesNotMatch(updateRoute, /body\.provider \|\| existing\.provider/)
+  assert.match(updateRoute, /isOfficialProvider\(serviceType,\s*provider\)/)
+  assert.match(updateRoute, /badRequest\(c,\s*'不支持的 service_type\/provider'\)/)
+})
+
+test('AI config update route persists service type changes after validation', () => {
+  const route = read('src/routes/aiConfigs.ts')
+  const updateRoute = routeBlock(route, "app.put('/:id',")
+
+  assert.match(updateRoute, /const updates: Record<string, any> = \{ updatedAt: now\(\) \}/)
+  assert.match(updateRoute, /if \('service_type' in body\) updates\.serviceType = body\.service_type/)
+  assert.match(updateRoute, /if \('provider' in body\) updates\.provider = body\.provider/)
+})
+
+test('AI config probe uses provider-specific auth schemes', () => {
+  const route = read('src/routes/aiConfigs.ts')
+  const geminiHeadersStart = route.indexOf('function geminiHeaders')
+  const buildProbeStart = route.indexOf('function buildProbe')
+  const geminiHeaders = route.slice(geminiHeadersStart, buildProbeStart)
+
+  assert.match(geminiHeaders, /x-goog-api-key/)
+  assert.doesNotMatch(geminiHeaders, /Authorization\s*=\s*`Bearer/)
+  assert.match(route, /\/models\/\$\{modelName\}:generateContent/)
+  assert.match(route, /url\.searchParams\.set\('key', apiKey\)/)
+  assert.match(route, /function bearerHeaders/)
+  assert.match(route, /p === 'openai'/)
+  assert.match(route, /p === 'volcengine'/)
+  assert.match(route, /p === 'minimax'/)
+  assert.match(route, /p === 'aliyun'/)
+  assert.match(route, /X-DashScope-Async': 'enable'/)
+  assert.match(route, /\/services\/aigc\/video-generation\/video-synthesis/)
+  assert.match(route, /'\/chat\/completions'/)
+  assert.doesNotMatch(route, /viduHeaders/)
+  assert.doesNotMatch(route, /p === 'deepseek'/)
+  assert.doesNotMatch(route, /p === 'ali'/)
+  assert.doesNotMatch(route, /p === 'vidu'/)
+})
+
+test('removed providers no longer ship adapters or webhook routes', () => {
+  const registry = read('src/services/adapters/registry.ts')
+  const index = read('src/index.ts')
+
+  assert.doesNotMatch(registry, /ali-image|ali-video|vidu-video/)
+  assert.doesNotMatch(registry, /AliImageAdapter|AliVideoAdapter|ViduVideoAdapter/)
+  assert.doesNotMatch(index, /webhooks/)
+})
+
+test('adapter registry fails closed for unsupported providers', () => {
+  const registry = read('src/services/adapters/registry.ts')
+
+  assert.match(registry, /Unsupported image provider/)
+  assert.match(registry, /Unsupported video provider/)
+  assert.doesNotMatch(registry, /\|\|\s*imageAdapters\['minimax'\]/)
+  assert.doesNotMatch(registry, /\|\|\s*videoAdapters\['minimax'\]/)
+  assert.doesNotMatch(registry, /ttsAdapters/)
+})
+
+test('OpenAI image adapter defaults to GPT Image instead of legacy DALL-E', () => {
+  const adapter = read('src/services/adapters/openai-image.ts')
+
+  assert.match(adapter, /record\.model\s*\|\|\s*config\.model\s*\|\|\s*'gpt-image-2'/)
+  assert.doesNotMatch(adapter, /record\.model\s*\|\|\s*'dall-e-3'/)
+})
+
+test('OpenAI image adapter uses GPT Image request shape and keeps DALL-E response format', () => {
+  const adapter = read('src/services/adapters/openai-image.ts')
+
+  assert.match(adapter, /model\.startsWith\('gpt-image-'\)/)
+  assert.match(adapter, /normalizeGptImageSize/)
+  assert.match(adapter, /'1536x1024'/)
+  assert.match(adapter, /'1024x1536'/)
+  assert.match(adapter, /'1024x1024'/)
+  assert.match(adapter, /'auto'/)
+  assert.match(adapter, /if \(!isGptImage\)[\s\S]*response_format = 'url'/)
+})
+
+test('new image and video models use their current API shapes', () => {
+  const openaiImage = read('src/services/adapters/openai-image.ts')
+  const geminiImage = read('src/services/adapters/gemini-image.ts')
+  const volcVideo = read('src/services/adapters/volcengine-video.ts')
+  const wanVideo = read('src/services/adapters/aliyun-wan-video.ts')
+
+  assert.match(openaiImage, /isGptImage2/)
+  assert.match(openaiImage, /normalizeGptImage2Size/)
+  assert.match(geminiImage, /isGemini3Image/)
+  assert.match(geminiImage, /\/v1beta'[\s\S]*'\/interactions'/)
+  assert.match(geminiImage, /response_format/)
+  assert.doesNotMatch(geminiImage, /Authorization': `Bearer/)
+  assert.match(volcVideo, /doubao-seedance-2-0-mini-260615/)
+  // Seedance 2.0 多模态能力
+  assert.match(volcVideo, /SEEDANCE2_MODEL_PREFIX/)
+  assert.match(volcVideo, /startsWith\(SEEDANCE2_MODEL_PREFIX\)/)
+  assert.match(volcVideo, /reference_video/)
+  assert.match(volcVideo, /reference_audio/)
+  assert.match(volcVideo, /generate_audio:\s*record\.generateAudio/)
+  // Wan 3.0 使用阿里云百炼官方异步视频生成协议
+  assert.match(wanVideo, /wan3\.0-video-prime/)
+  assert.match(wanVideo, /wan3\.0-video/)
+  assert.match(wanVideo, /\/services\/aigc\/video-generation\/video-synthesis/)
+  assert.match(wanVideo, /X-DashScope-Async': 'enable'/)
+  assert.match(wanVideo, /body:\s*\{ model, input, parameters \}/)
+  assert.match(wanVideo, /\/tasks\/\$\{encodeURIComponent\(taskId\)\}/)
+  assert.match(wanVideo, /output\.task_status/)
+  assert.match(wanVideo, /output_video_duration/)
+})
diff --git a/huobao-source/backend/tests/remove-audio-tts-structure.test.mjs b/huobao-source/backend/tests/remove-audio-tts-structure.test.mjs
new file mode 100644
index 0000000..2f64c2c
--- /dev/null
+++ b/huobao-source/backend/tests/remove-audio-tts-structure.test.mjs
@@ -0,0 +1,65 @@
+import { readFileSync, existsSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+const exists = (path) => existsSync(new URL(path, root))
+
+test('backend removes the voice assignment agent and tools', () => {
+  const agents = read('src/agents/index.ts')
+  const skills = read('src/agents/skills.ts')
+
+  assert.doesNotMatch(agents, /voice_assigner/)
+  assert.doesNotMatch(agents, /createVoiceTools/)
+  assert.doesNotMatch(skills, /voice_assigner/)
+  assert.equal(exists('src/agents/tools/voice-tools.ts'), false)
+  assert.equal(exists('workspace/skills/voice_assigner/SKILL.md'), false)
+})
+
+test('backend removes audio service providers, TTS adapters, and voice routes', () => {
+  const index = read('src/index.ts')
+  const ai = read('src/services/ai.ts')
+  const registry = read('src/services/adapters/registry.ts')
+  const types = read('src/services/adapters/types.ts')
+
+  assert.doesNotMatch(index, /aiVoices/)
+  assert.doesNotMatch(ai, /audio/)
+  assert.doesNotMatch(ai, /getAudioConfig/)
+  assert.doesNotMatch(registry, /TTS/)
+  assert.doesNotMatch(registry, /minimax-tts/)
+  assert.doesNotMatch(types, /TTSProviderAdapter/)
+  assert.equal(exists('src/routes/aiVoices.ts'), false)
+  assert.equal(exists('src/services/tts-generation.ts'), false)
+  assert.equal(exists('src/services/adapters/minimax-tts.ts'), false)
+  assert.match(read('src/services/adapters/volcengine-video.ts'), /generate_audio:\s*record\.generateAudio/)
+  assert.doesNotMatch(read('src/services/adapters/volcengine-video.ts'), /generate_audio:\s*false/)
+})
+
+test('backend keeps legacy TTS fields and endpoints removed while allowing uploaded voice samples', () => {
+  const episodes = read('src/routes/episodes.ts')
+  const storyboards = read('src/routes/storyboards.ts')
+  const characters = read('src/routes/characters.ts')
+  const schema = read('src/db/schema.ts')
+  const sqliteSchema = read('src/db/sqlite-schema.ts')
+
+  assert.doesNotMatch(episodes, /audio_config_id/)
+  assert.doesNotMatch(episodes, /assign_voices/)
+  assert.doesNotMatch(episodes, /generate_voice_samples/)
+  assert.doesNotMatch(storyboards, /generate-tts/)
+  assert.doesNotMatch(storyboards, /ttsAudioUrl/)
+  assert.doesNotMatch(characters, /generate-voice-sample/)
+  assert.doesNotMatch(characters, /voiceStyle/)
+  assert.doesNotMatch(schema, /audioConfigId/)
+  assert.doesNotMatch(schema, /voiceStyle/)
+  assert.doesNotMatch(schema, /voiceSampleUrl/)
+  assert.doesNotMatch(schema, /voiceProvider/)
+  assert.doesNotMatch(schema, /ttsAudioUrl/)
+  assert.doesNotMatch(schema, /aiVoices/)
+  assert.doesNotMatch(sqliteSchema, /audio_config_id/)
+  assert.doesNotMatch(sqliteSchema, /voice_style/)
+  assert.doesNotMatch(sqliteSchema, /voice_sample_url/)
+  assert.doesNotMatch(sqliteSchema, /voice_provider/)
+  assert.doesNotMatch(sqliteSchema, /tts_audio_url/)
+  assert.doesNotMatch(sqliteSchema, /CREATE TABLE IF NOT EXISTS ai_voices/)
+})
diff --git a/huobao-source/backend/tests/remove-grid-feature-structure.test.mjs b/huobao-source/backend/tests/remove-grid-feature-structure.test.mjs
new file mode 100644
index 0000000..262a7b4
--- /dev/null
+++ b/huobao-source/backend/tests/remove-grid-feature-structure.test.mjs
@@ -0,0 +1,39 @@
+import { existsSync, readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+const exists = (path) => existsSync(new URL(path, root))
+
+test('backend no longer exposes the grid image API or split service', () => {
+  const index = read('src/index.ts')
+
+  assert.doesNotMatch(index, /routes\/grid/)
+  assert.doesNotMatch(index, /api\.route\('\/grid'/)
+  assert.equal(exists('src/routes/grid.ts'), false)
+  assert.equal(exists('src/services/grid-split.ts'), false)
+})
+
+test('image prompt agent keeps role and scene prompts but removes grid prompt mode', () => {
+  const agents = read('src/agents/index.ts')
+  const skills = read('src/agents/skills.ts')
+  const imagePromptTools = read('src/agents/tools/image-prompt-tools.ts')
+  const storyboardTools = read('src/agents/tools/storyboard-tools.ts')
+  const skill = read('workspace/skills/prompt-generator/prop-prompt/SKILL.md')
+
+  assert.match(agents, /prompt_generator/)
+  assert.match(skills, /prompt_generator/)
+  assert.match(imagePromptTools, /save_character_final_prompt/)
+  assert.match(imagePromptTools, /save_scene_final_prompt/)
+  assert.doesNotMatch(agents, /宫格图/)
+  assert.doesNotMatch(agents, /read_shots_for_grid/)
+  assert.doesNotMatch(agents, /generate_grid_prompt/)
+  assert.doesNotMatch(imagePromptTools, /宫格图/)
+  assert.doesNotMatch(imagePromptTools, /read_shots_for_grid/)
+  assert.doesNotMatch(imagePromptTools, /generate_grid_prompt/)
+  assert.doesNotMatch(storyboardTools, /generate_grid_prompt/)
+  assert.doesNotMatch(storyboardTools, /宫格图/)
+  assert.doesNotMatch(skill, /宫格图/)
+  assert.doesNotMatch(skill, /grid layout/)
+})
diff --git a/huobao-source/backend/tests/remove-minimax-media-structure.test.mjs b/huobao-source/backend/tests/remove-minimax-media-structure.test.mjs
new file mode 100644
index 0000000..267ff02
--- /dev/null
+++ b/huobao-source/backend/tests/remove-minimax-media-structure.test.mjs
@@ -0,0 +1,41 @@
+import { existsSync, readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('../..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+const exists = (path) => existsSync(new URL(path, root))
+
+test('MiniMax image and video provider surfaces are removed', () => {
+  const ai = read('backend/src/services/ai.ts')
+  const route = read('backend/src/routes/aiConfigs.ts')
+  const registry = read('backend/src/services/adapters/registry.ts')
+  const settings = read('frontend/app/pages/settings.vue')
+  const readme = read('README.md')
+
+  assert.doesNotMatch(ai, /minimax/i)
+  assert.doesNotMatch(route, /p === 'minimax'/i)
+  assert.doesNotMatch(registry, /minimax/i)
+  assert.doesNotMatch(settings, /minimax/i)
+  assert.doesNotMatch(readme, /minimax/i)
+  assert.equal(exists('backend/src/services/adapters/minimax-image.ts'), false)
+  assert.equal(exists('backend/src/services/adapters/minimax-video.ts'), false)
+})
+
+test('MySQL startup removes all saved MiniMax configurations including audio', () => {
+  const mysqlSchema = read('backend/src/db/mysql-schema.ts')
+  const detachImage = 'UPDATE `episodes` e JOIN `ai_service_configs` c ON e.`image_config_id` = c.`id` SET e.`image_config_id` = NULL WHERE c.`provider` = ?'
+  const detachVideo = 'UPDATE `episodes` e JOIN `ai_service_configs` c ON e.`video_config_id` = c.`id` SET e.`video_config_id` = NULL WHERE c.`provider` = ?'
+  const deleteConfigs = 'DELETE FROM `ai_service_configs` WHERE `provider` = ?'
+
+  assert.match(mysqlSchema, /mysqlDataCleanupStatements/)
+  assert.match(mysqlSchema, /DELETE FROM `ai_service_configs` WHERE `provider` = \?/)
+  assert.match(mysqlSchema, /DELETE FROM `ai_service_providers` WHERE `provider` = \?/)
+  assert.ok(mysqlSchema.includes(detachImage))
+  assert.ok(mysqlSchema.includes(detachVideo))
+  assert.ok(mysqlSchema.indexOf(detachImage) < mysqlSchema.indexOf(deleteConfigs))
+  assert.ok(mysqlSchema.indexOf(detachVideo) < mysqlSchema.indexOf(deleteConfigs))
+  assert.equal((mysqlSchema.match(/params:\s*\['minimax'\]/g) || []).length, 4)
+  assert.doesNotMatch(mysqlSchema, /params:\s*\['minimax', 'image', 'video'\]/)
+  assert.match(mysqlSchema, /pool\.query\(cleanup\.sql, cleanup\.params\)/)
+})
diff --git a/huobao-source/backend/tests/seedance2-video-modes.test.mjs b/huobao-source/backend/tests/seedance2-video-modes.test.mjs
new file mode 100644
index 0000000..9945f70
--- /dev/null
+++ b/huobao-source/backend/tests/seedance2-video-modes.test.mjs
@@ -0,0 +1,143 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('volcengine video adapter only supports Seedance 2.0 models and reference mode only', () => {
+  const adapter = read('src/services/adapters/volcengine-video.ts')
+
+  // 模型白名单：仅 doubao-seedance-2-0-* 前缀
+  assert.match(adapter, /SEEDANCE2_MODEL_PREFIX = 'doubao-seedance-2-0'/)
+  assert.match(adapter, /startsWith\(SEEDANCE2_MODEL_PREFIX\)/)
+
+  // 只保留多模态参考：其他模式分支与历史映射已清理
+  assert.doesNotMatch(adapter, /mode === 'text'/)
+  assert.doesNotMatch(adapter, /mode === 'first_frame'/)
+  assert.doesNotMatch(adapter, /mode === 'first_last'/)
+  assert.doesNotMatch(adapter, /LEGACY_MODE_MAP/)
+  assert.doesNotMatch(adapter, /first_frame/)
+  assert.doesNotMatch(adapter, /last_frame/)
+
+  // 多模态 content 项角色
+  assert.match(adapter, /role: 'reference_image'/)
+  assert.match(adapter, /role: 'reference_video'/)
+  assert.match(adapter, /role: 'reference_audio'/)
+
+  // 素材上限 9/3/3、音频需视觉素材约束、至少一个素材或 prompt
+  assert.match(adapter, /REF_LIMITS = \{ images: 9, videos: 3, audios: 3 \}/)
+  assert.match(adapter, /参考音频需要至少 1 个参考图片或视频/)
+  assert.match(adapter, /多模态参考模式需要至少一个参考素材或 prompt/)
+
+  // generate_audio 可配置（默认开），时长支持 4-15 秒；分辨率随集固定（480p/720p，默认 720p）
+  assert.match(adapter, /generate_audio:\s*record\.generateAudio/)
+  assert.match(adapter, /Math\.min\(15, Math\.max\(4, parsed\)\)/)
+  assert.match(adapter, /resolution: record\.resolution === '480p' \? '480p' : '720p'/)
+})
+
+test('video generation service resolves reference media and persists new fields', () => {
+  const service = read('src/services/generation.ts')
+
+  assert.match(service, /PUBLIC_BASE_URL/)
+  assert.match(service, /resolvePublicMediaUrl/)
+  assert.match(service, /referenceVideoUrls: params\.referenceVideoUrls/)
+  assert.match(service, /referenceAudioUrls: params\.referenceAudioUrls/)
+  assert.match(service, /generateAudio: params\.generateAudio === false \? 0 : 1/)
+  // 默认多模态参考模式
+  assert.match(service, /referenceMode: params\.referenceMode \|\| 'reference'/)
+  assert.doesNotMatch(service, /referenceMode: params\.referenceMode \|\| 'text'/)
+  assert.doesNotMatch(service, /referenceMode: params\.referenceMode \|\| 'none'/)
+})
+
+test('video resolution is fixed per episode, editable, and locked into video tasks', () => {
+  const episodes = read('src/routes/episodes.ts')
+  const tasks = read('src/routes/tasks.ts')
+  const service = read('src/services/generation.ts')
+
+  // 创建集时固定（默认 720p，仅接受 480p/720p）
+  assert.match(episodes, /\['480p', '720p', '1080p'\]\.includes\(body\.resolution\)/)
+  // PUT 可修改，白名单校验
+  assert.match(episodes, /'status', 'resolution'\]/)
+  assert.match(episodes, /resolution 只支持 480p \/ 720p/)
+  // 视频任务锁定集的分辨率（优先于请求体）
+  assert.match(tasks, /episodeResolution = ep\.resolution/)
+  assert.match(tasks, /resolution: episodeResolution \|\| videoBody!\.resolution/)
+  // 服务落入 params 并传给适配器
+  assert.match(service, /resolution: normalizeStoredVideoResolution\(params\.resolution\)/)
+  assert.match(service, /resolution: params\.resolution,/)
+})
+
+test('upload route exposes validated video and audio endpoints', () => {
+  const route = read('src/routes/upload.ts')
+  const audioUpload = read('src/utils/audio-upload.ts')
+
+  assert.match(route, /app\.post\('\/video'/)
+  assert.match(route, /app\.post\('\/audio'/)
+  assert.match(route, /VIDEO_EXT = new Set\(\['\.mp4', '\.mov', '\.webm', '\.m4v'\]\)/)
+  assert.match(route, /saveAudioUpload/)
+  assert.match(audioUpload, /AUDIO_EXT = new Set\(\['\.mp3', '\.wav', '\.m4a', '\.aac'\]\)/)
+  assert.match(route, /50 \* 1024 \* 1024/)
+  assert.match(audioUpload, /20 \* 1024 \* 1024/)
+})
+
+test('tasks route validates reference-mode requirements for video tasks', () => {
+  const route = read('src/routes/tasks.ts')
+
+  // 统一任务入口：type 分派 image/video
+  assert.match(route, /type 必须为 image 或 video/)
+  assert.match(route, /generateImage\(\{/)
+  assert.match(route, /generateVideo\(\{/)
+
+  // 其他模式的校验已清理
+  assert.doesNotMatch(route, /文生视频模式必须提供 prompt/)
+  assert.doesNotMatch(route, /首帧模式必须提供 first_frame_url/)
+  assert.doesNotMatch(route, /首尾帧模式必须同时提供/)
+  // Wan 3.0 官方入参兼容层会把 input.media 归一到 first_frame_url/last_frame_url 等扁平字段
+
+  // 多模态参考校验并固定 reference 模式
+  assert.match(route, /参考素材超限：图片≤9、视频≤3、音频≤3/)
+  assert.match(route, /参考音频需要至少 1 个参考图片或视频/)
+  assert.match(route, /视频生成需要至少一个参考素材或 prompt/)
+  assert.match(route, /referenceMode: 'reference'/)
+  assert.match(route, /referenceVideoUrls: videoBody!\.reference_video_urls/)
+  assert.match(route, /referenceAudioUrls: videoBody!\.reference_audio_urls/)
+  assert.match(route, /generateAudio: videoBody!\.generate_audio/)
+})
+
+test('image/video generation tasks are unified into a single sys_task table', () => {
+  const schema = read('src/db/schema.ts')
+  const mysqlSchema = read('src/db/mysql-schema.ts')
+  const envExample = read('.env.example')
+
+  // sys_task：type 区分 image/video，生成参数收进 params(JSON)
+  assert.match(schema, /export const sysTask = mysqlTable\('sys_task'/)
+  assert.match(schema, /type: varchar\('type', \{ length: 16 \}\)\.notNull\(\)/)
+  assert.match(schema, /params: text\('params'\)/)
+  assert.match(schema, /resultUrl: text\('result_url'\)/)
+  assert.match(schema, /localPath: text\('local_path'\)/)
+
+  // 旧的 image_generations / video_generations 表定义与回填已移除
+  assert.doesNotMatch(schema, /imageGenerations/)
+  assert.doesNotMatch(schema, /videoGenerations/)
+  assert.doesNotMatch(mysqlSchema, /CREATE TABLE IF NOT EXISTS image_generations/)
+  assert.doesNotMatch(mysqlSchema, /CREATE TABLE IF NOT EXISTS video_generations/)
+  assert.doesNotMatch(mysqlSchema, /column: 'reference_video_urls'/)
+
+  // DDL 与旧表清理（不迁移历史）
+  assert.match(mysqlSchema, /CREATE TABLE IF NOT EXISTS sys_task \(/)
+  assert.match(mysqlSchema, /type VARCHAR\(16\) NOT NULL/)
+  assert.match(mysqlSchema, /params TEXT/)
+  assert.match(mysqlSchema, /result_url TEXT/)
+  assert.match(mysqlSchema, /DROP TABLE IF EXISTS `image_generations`/)
+  assert.match(mysqlSchema, /DROP TABLE IF EXISTS `video_generations`/)
+
+  // 路由与服务只操作 sys_task（统一 /tasks 入口，type 过滤）
+  const tasksRoute = read('src/routes/tasks.ts')
+  const service = read('src/services/generation.ts')
+  assert.match(tasksRoute, /schema\.sysTask/)
+  assert.match(tasksRoute, /r\.type === type/)
+  assert.match(service, /db\.insert\(schema\.sysTask\)/)
+
+  assert.match(envExample, /PUBLIC_BASE_URL/)
+})
diff --git a/huobao-source/backend/tests/style-presets-structure.test.mjs b/huobao-source/backend/tests/style-presets-structure.test.mjs
new file mode 100644
index 0000000..46c5c68
--- /dev/null
+++ b/huobao-source/backend/tests/style-presets-structure.test.mjs
@@ -0,0 +1,61 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('drama creation no longer pre-creates episodes from total_episodes', () => {
+  const dramas = read('src/routes/dramas.ts')
+
+  assert.doesNotMatch(dramas, /total_episodes \|\| 1/)
+  assert.doesNotMatch(dramas, /第\$\{i\}集/)
+  assert.doesNotMatch(dramas, /Create default episodes/)
+})
+
+test('drama creation records a fixed aspect ratio for video generation', () => {
+  const dramas = read('src/routes/dramas.ts')
+
+  assert.match(dramas, /aspectRatio: body\.aspect_ratio \|\| '16:9'/)
+  assert.match(dramas, /if \(body\.aspect_ratio !== undefined\) updates\.aspectRatio = body\.aspect_ratio/)
+})
+
+test('style presets route is mounted and implements CRUD', () => {
+  const entry = read('src/index.ts')
+  const route = read('src/routes/stylePresets.ts')
+
+  assert.match(entry, /api\.route\('\/style-presets', stylePresets\)/)
+  assert.match(route, /app\.get\('\/'/)
+  assert.match(route, /app\.post\('\/'/)
+  assert.match(route, /app\.put\('\/:id'/)
+  assert.match(route, /app\.delete\('\/:id'/)
+  // value 唯一约束 + 格式校验 + 查重
+  assert.match(route, /VALUE_PATTERN/)
+  assert.match(route, /风格 key 已存在/)
+  // GET 支持 ?all=1 且默认过滤停用项
+  assert.match(route, /query\('all'\)/)
+  assert.match(route, /r\.isActive/)
+})
+
+test('drama style prompt is injected into image prompt composition', () => {
+  const service = read('src/services/style-preset.ts')
+  const gridTools = read('src/agents/tools/image-prompt-tools.ts')
+  const characters = read('src/routes/characters.ts')
+  const scenes = read('src/routes/scenes.ts')
+
+  assert.match(service, /getDramaStylePrompt/)
+  assert.match(service, /stylePresets\.value, drama\.style/)
+  assert.match(gridTools, /getDramaStylePrompt\(dramaId\)/)
+  // 保存最终提示词时由工具拼接项目视觉风格（风格片段置于最前方）
+  assert.match(gridTools, /stylePrompt \? `\$\{stylePrompt\}, \$\{prompt\}` : prompt/)
+  assert.match(characters, /getDramaStylePrompt/)
+  assert.match(characters, /characterImagePrompt\(char, stylePrompt\)/)
+  assert.match(scenes, /getDramaStylePrompt\(scene\.dramaId\)/)
+})
+
+test('agent default prompts no longer hardcode consistent art style', () => {
+  const agents = read('src/agents/index.ts')
+
+  assert.doesNotMatch(agents, /必须包含 "consistent art style"/)
+  assert.match(agents, /视觉风格描述会由工具/)
+})
diff --git a/huobao-source/backend/tests/text-model-selection.test.ts b/huobao-source/backend/tests/text-model-selection.test.ts
new file mode 100644
index 0000000..94e74b6
--- /dev/null
+++ b/huobao-source/backend/tests/text-model-selection.test.ts
@@ -0,0 +1,25 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { resolveTextModelSelection } from '../../frontend/app/utils/text-model-selection.js'
+
+const options = [
+  { key: 'gemini/gemini-flash', model: 'gemini-flash', configId: 7 },
+  { key: 'openai/gemini-flash', model: 'gemini-flash', configId: 12 },
+  { key: 'openai/vendor/model', model: 'vendor/model', configId: 12 },
+]
+
+test('default chat selection sends the displayed model and its configuration in JSON', () => {
+  const selected = resolveTextModelSelection(options, '')
+  const request = JSON.parse(JSON.stringify({ model: selected.model, config_id: selected.configId }))
+  assert.deepEqual(request, { model: 'gemini-flash', config_id: 7 })
+})
+test('explicit selection keeps the provider/configuration and model names containing slashes', () => {
+  assert.deepEqual(resolveTextModelSelection(options, 'openai/gemini-flash'), { model: 'gemini-flash', configId: 12 })
+  assert.deepEqual(resolveTextModelSelection(options, 'openai/vendor/model'), { model: 'vendor/model', configId: 12 })
+})
+test('default follows updated options; stale selections fall back as the picker does', () => {
+  assert.deepEqual(resolveTextModelSelection(options.slice(1), ''), { model: 'gemini-flash', configId: 12 })
+  assert.deepEqual(resolveTextModelSelection(options, 'removed/model'), { model: 'gemini-flash', configId: 7 })
+  assert.deepEqual(resolveTextModelSelection(options, 'vendor/model'), { model: 'vendor/model', configId: 12 })
+  assert.deepEqual(resolveTextModelSelection([], ''), { model: undefined, configId: undefined })
+})
diff --git a/huobao-source/backend/tests/video-delivery.test.ts b/huobao-source/backend/tests/video-delivery.test.ts
new file mode 100644
index 0000000..9d2ae1a
--- /dev/null
+++ b/huobao-source/backend/tests/video-delivery.test.ts
@@ -0,0 +1,67 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import http from 'node:http'
+import { downloadVideo, safeTaskError } from '../src/services/video-download.ts'
+import { MiniMaxVideoAdapter } from '../src/services/adapters/minimax-video.ts'
+
+const video = Buffer.concat([Buffer.from([0,0,0,24]), Buffer.from('ftypisom'), Buffer.alloc(32)])
+async function serve(handler: http.RequestListener) {
+  const server = http.createServer(handler)
+  await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve))
+  const url = `http://127.0.0.1:${(server.address() as any).port}`
+  return { url, close: () => new Promise<void>(resolve => server.close(() => resolve())) }
+}
+
+test('MiniMax preserves task ID and actual duration for the supplied response contract', () => {
+  const adapter = new MiniMaxVideoAdapter()
+  const result = { task: { id: '2109166298120097792', status: 'succeeded', duration: 12, content: { url: 'https://files.example/content?signature=test' } } }
+  assert.deepEqual(adapter.parseGenerateResponse(result), { isAsync: false, taskId: result.task.id, videoUrl: result.task.content.url, duration: 12 })
+  assert.equal(adapter.parsePollResponse(result).duration, 12)
+  assert.deepEqual(adapter.parseGenerateResponse({ task: { id: 'stored-task', status: 'running' } }), { isAsync: true, taskId: 'stored-task' })
+  assert.equal(adapter.parseGenerateResponse({ task_id: 'stored-task', ...result }).isAsync, false)
+})
+
+test('extensionless MP4 downloads atomically and transient HTTP errors retry', async () => {
+  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'video-download-'))
+  let requests = 0
+  const server = await serve((_req, res) => { if (++requests === 1) { res.writeHead(503).end('temporary'); return }; res.end(video) })
+  try {
+    assert.equal(await downloadVideo(server.url + '/content?signature=test', 2, { root, retryDelayMs: 1 }), 'static/videos/task-2.mp4')
+    assert.equal(requests, 2)
+    assert.deepEqual(await fs.readFile(path.join(root, 'videos/task-2.mp4')), video)
+    assert.deepEqual(await fs.readdir(path.join(root, 'videos')), ['task-2.mp4'])
+  } finally { await server.close(); await fs.rm(root, { recursive: true, force: true }) }
+})
+
+test('invalid bodies, size limits and permanent HTTP failures leave no partial files', async () => {
+  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'video-invalid-'))
+  const server = await serve((req, res) => {
+    if (req.url === '/missing') { res.writeHead(404).end(); return }
+    if (req.url === '/large') { res.end(video); return }
+    res.end('<html>expired signature</html>')
+  })
+  try {
+    for (const [url, maxBytes] of [['/missing', 1000], ['/html', 1000], ['/large', 16]] as const) {
+      await assert.rejects(downloadVideo(server.url + url, 3, { root, maxBytes, retryDelayMs: 1 }))
+      assert.deepEqual(await fs.readdir(path.join(root, 'videos')), [])
+    }
+  } finally { await server.close(); await fs.rm(root, { recursive: true, force: true }) }
+})
+
+test('a stalled body times out and does not leave a partial file', async () => {
+  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'video-timeout-'))
+  const server = await serve((_req, res) => { res.writeHead(200); res.write(video) })
+  try {
+    await assert.rejects(downloadVideo(server.url, 4, { root, attempts: 1, timeoutMs: 30 }))
+    assert.deepEqual(await fs.readdir(path.join(root, 'videos')), [])
+  } finally { await server.close(); await fs.rm(root, { recursive: true, force: true }) }
+})
+
+test('diagnostics remove signed URLs and credentials', () => {
+  const error = safeTaskError('fetch failed https://files.example/content?signature=hidden Bearer secret api_key=secret sk-hidden')
+  assert.doesNotMatch(error, /signature=hidden|Bearer secret|api_key=secret|sk-hidden/)
+  assert.match(error, /fetch failed/)
+})
diff --git a/huobao-source/backend/tests/video-prompt-batch-structure.test.mjs b/huobao-source/backend/tests/video-prompt-batch-structure.test.mjs
new file mode 100644
index 0000000..86149e7
--- /dev/null
+++ b/huobao-source/backend/tests/video-prompt-batch-structure.test.mjs
@@ -0,0 +1,35 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('video prompt batch service runs per-shot async agent loop', () => {
+  const svc = read('src/services/video-prompts.ts')
+
+  // 默认只处理缺少 video_prompt 的分镜；指定 storyboardIds 时只处理所选（已有提示词也重新生成）
+  assert.match(svc, /filter\(sb => !\(sb\.videoPrompt \|\| ''\)\.trim\(\)\)/)
+  assert.match(svc, /storyboardIds\?\.length/)
+  assert.match(svc, /storyboardIds\.includes\(sb\.id\)/)
+  // 运行中不重复启动
+  assert.match(svc, /status === 'running'\) return \{ started: false, total: -1 \}/)
+  // 逐个分镜调用 prompt_generator，以落库结果判定成败
+  assert.match(svc, /mastra\.getAgent\('prompt_generator'\)/)
+  assert.match(svc, /read_storyboard_context/)
+  assert.match(svc, /update_storyboard/)
+  assert.match(svc, /fresh\?\.videoPrompt/)
+  // 进度跟踪与文本模型覆盖
+  assert.match(svc, /current_storyboard_id/)
+  assert.match(svc, /modelOverride: opts\.model/)
+})
+
+test('episodes route exposes video prompt batch endpoints', () => {
+  const route = read('src/routes/episodes.ts')
+
+  assert.match(route, /app\.post\('\/:id\/generate-video-prompts'/)
+  assert.match(route, /app\.get\('\/:id\/video-prompts-status'/)
+  assert.match(route, /startVideoPromptBatch\(ep\.id, ep\.dramaId/)
+  assert.match(route, /body\.storyboard_ids/)
+  assert.match(route, /already_running/)
+})
diff --git a/huobao-source/backend/tests/video-prompt-references-structure.test.mjs b/huobao-source/backend/tests/video-prompt-references-structure.test.mjs
new file mode 100644
index 0000000..fd6b365
--- /dev/null
+++ b/huobao-source/backend/tests/video-prompt-references-structure.test.mjs
@@ -0,0 +1,34 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('prompt_generator video prompt format uses @name references instead of XML tags', () => {
+  const agents = read('src/agents/index.ts')
+  const skill = read('workspace/skills/prompt-generator/video-prompt/SKILL.md')
+  const settings = read('../frontend/app/pages/settings.vue')
+
+  // 场景/角色用 @名字 引用（名字必须与场景/角色列表完全一致）
+  assert.match(agents, /@场景名/)
+  assert.match(agents, /@角色名/)
+  assert.match(agents, /@志远 → @图片1志远/)
+  assert.doesNotMatch(agents, /<location>/)
+  assert.doesNotMatch(agents, /<role>/)
+
+  // SKILL.md 同步
+  assert.match(skill, /@场景名/)
+  assert.match(skill, /@角色名/)
+  assert.match(skill, /@小明.*@图片1小明/)
+  assert.doesNotMatch(skill, /<location>/)
+  assert.doesNotMatch(skill, /<role>/)
+
+  // settings.vue 的「恢复默认」副本同样包含新格式规范
+  assert.match(settings, /storyboard_breaker: `/)
+  assert.match(settings, /@场景名/)
+  assert.match(settings, /@角色名/)
+  assert.match(settings, /@志远 → @图片1志远/)
+  assert.doesNotMatch(settings, /<location>/)
+  assert.doesNotMatch(settings, /<role>/)
+})
diff --git a/huobao-source/backend/tests/video-prompt-voices.test.ts b/huobao-source/backend/tests/video-prompt-voices.test.ts
new file mode 100644
index 0000000..321ae42
--- /dev/null
+++ b/huobao-source/backend/tests/video-prompt-voices.test.ts
@@ -0,0 +1,130 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import os from 'node:os'
+import { eq } from 'drizzle-orm'
+
+const root = await fs.mkdtemp(path.join(os.tmpdir(), 'huobao-prompt-voices-'))
+process.env.SQLITE_PATH = path.join(root, 'test.sqlite3')
+process.env.HUOBAO_DATA_DIR = root
+process.env.STORAGE_PATH = path.join(root, 'static')
+process.env.WORKSPACE_PATH = path.join(root, 'workspace')
+process.env.MYSQL_AUTO_IMPORT = 'false'
+await fs.cp(new URL('../workspace/', import.meta.url), process.env.WORKSPACE_PATH, { recursive: true })
+const { db, schema } = await import('../src/db/index.ts')
+const { storyboardTools } = await import('../src/agents/tools/storyboard-tools.ts')
+const { buildAgentRequestContext } = await import('../src/agents/context.ts')
+const { agentRegistry } = await import('../src/agents/index.ts')
+const { resolveStoryboardVoiceReferences } = await import('../src/services/character-voice-references.ts')
+const ts = '2026-01-01T00:00:00.000Z'
+const timestamps = { createdAt: ts, updatedAt: ts }
+const drama = db.insert(schema.dramas).values({ title: 'Prompt voices', ...timestamps }).returning().get()
+const ep = db.insert(schema.episodes).values({ dramaId: drama.id, episodeNumber: 1, title: 'Test', scriptContent: '林小雨说：「早上好。」陈默点头。', ...timestamps }).returning().get()
+const createCharacter = (name: string, voice = true) => {
+  const c = db.insert(schema.characters).values({ name, dramaId: drama.id, voiceAudioUrl: voice ? `static/uploads/private-${name}.wav` : null, ...timestamps }).returning().get()
+  db.insert(schema.episodeCharacters).values({ episodeId: ep.id, characterId: c.id, createdAt: ts }).run()
+  return c
+}
+const speaker = createCharacter('林小雨')
+const silent = createCharacter('陈默')
+const noVoice = createCharacter('小白', false)
+const unbound = createCharacter('未出场')
+const deleted = createCharacter('已删除')
+db.update(schema.characters).set({ deletedAt: ts }).where(eq(schema.characters.id, deleted.id)).run()
+const sb = db.insert(schema.storyboards).values({ episodeId: ep.id, storyboardNumber: 1,
+  description: '【镜头1】林小雨说：「早上好。」陈默点头。', atmosphere: '晨光', duration: 6, videoPrompt: '原提示词', ...timestamps }).returning().get()
+for (const c of [speaker, silent, noVoice, deleted]) db.insert(schema.storyboardCharacters).values({ storyboardId: sb.id, characterId: c.id }).run()
+const requestContext = buildAgentRequestContext({ dramaId: drama.id, episodeId: ep.id })
+const call = (name: keyof typeof storyboardTools, input: any) => (storyboardTools[name].execute as any)(input, { requestContext })
+const row = () => db.select().from(schema.storyboards).where(eq(schema.storyboards.id, sb.id)).get()!
+
+test('prompt context exposes exact voice tokens and scopes each shot to bound, live characters', async () => {
+  const context = await call('readStoryboardContext', {})
+  assert.equal(context.characters.find((c: any) => c.id === speaker.id).voice_reference, '#林小雨')
+  assert.equal(context.characters.find((c: any) => c.id === noVoice.id).has_voice, false)
+  assert.equal(context.characters.find((c: any) => c.id === noVoice.id).voice_reference, null)
+  assert.equal(context.characters.some((c: any) => c.id === deleted.id), false)
+  assert.equal(context.characters.some((c: any) => c.id === unbound.id), true)
+  const voices = context.existing_storyboards[0].available_voice_references
+  assert.deepEqual(voices, [
+    { character_id: speaker.id, name: speaker.name, voice_reference: '#林小雨' },
+    { character_id: silent.id, name: silent.name, voice_reference: '#陈默' },
+  ])
+  assert.doesNotMatch(JSON.stringify(context), /static\/uploads|private-/)
+})
+
+test('single, batch and initial-breakdown agents get voice rules in every content language', async () => {
+  for (const language of ['zh', 'en', 'ja', 'ko'] as const) {
+    const rc = buildAgentRequestContext({ dramaId: drama.id, episodeId: ep.id, language })
+    for (const type of ['prompt_generator', 'storyboard_breaker']) {
+      const instructions = String(await agentRegistry[type].getInstructions({ requestContext: rc }))
+      assert.match(instructions, /available_voice_references/)
+      assert.match(instructions, /voice_reference/)
+      assert.match(instructions, /#(?:林小雨|Alex|太郎|민수)/)
+      if (language !== 'zh') assert.match(instructions, /copy the complete voice_reference value exactly/)
+    }
+  }
+  const extractor = String(await agentRegistry.extractor.getInstructions({ requestContext }))
+  assert.doesNotMatch(extractor, /available_voice_references/)
+})
+
+test('custom and missing prompt templates retain the runtime voice rules', async () => {
+  const file = path.join(process.env.WORKSPACE_PATH!, 'prompts/prompt_generator.md')
+  const original = await fs.readFile(file, 'utf8')
+  try {
+    await fs.writeFile(file, '---\nname: Custom\nmodel: ""\n---\nCustom prompt sentinel.')
+    const custom = String(await agentRegistry.prompt_generator.getInstructions({ requestContext }))
+    assert.match(custom, /Custom prompt sentinel/)
+    assert.match(custom, /available_voice_references/)
+    await fs.rm(file)
+    const fallback = String(await agentRegistry.prompt_generator.getInstructions({ requestContext }))
+    assert.match(fallback, /available_voice_references/)
+  } finally { await fs.writeFile(file, original) }
+})
+
+test('a generated voice binding saves editable tokens and resolves to the corresponding video audio', async () => {
+  const prompt = '0-3秒：@林小雨抬头，#林小雨轻声说：「早上好。」\n3-6秒：@陈默点头。'
+  await call('updateStoryboard', { storyboard_id: sb.id, video_prompt: prompt })
+  assert.equal(row().videoPrompt, prompt)
+  assert.equal(row().description, sb.description)
+  assert.equal(row().atmosphere, sb.atmosphere)
+  assert.equal(row().duration, sb.duration)
+  const resolved = await resolveStoryboardVoiceReferences(row().videoPrompt!, sb.id, [])
+  assert.deepEqual(resolved.audioUrls, [speaker.voiceAudioUrl])
+  assert.equal(resolved.prompt, '0-3秒：@林小雨抬头，林小雨（音色参考音频1）轻声说：「早上好。」\n3-6秒：@陈默点头。')
+  assert.doesNotMatch(resolved.prompt, /#林小雨/)
+})
+
+test('invented, unbound, removed and missing voice references cannot replace a saved prompt', async () => {
+  const before = row().videoPrompt
+  for (const name of ['虚构角色', unbound.name, noVoice.name, deleted.name]) {
+    await assert.rejects(call('updateStoryboard', { storyboard_id: sb.id, video_prompt: `音色：#${name}` }), /音色/)
+    assert.equal(row().videoPrompt, before)
+  }
+  db.update(schema.characters).set({ voiceAudioUrl: null }).where(eq(schema.characters.id, speaker.id)).run()
+  try {
+    const context = await call('readStoryboardContext', {})
+    assert.equal(context.existing_storyboards[0].available_voice_references.some((v: any) => v.character_id === speaker.id), false)
+    await assert.rejects(call('updateStoryboard', { storyboard_id: sb.id, video_prompt: '#林小雨' }), /尚未上传/)
+    assert.equal(row().videoPrompt, before)
+  } finally { db.update(schema.characters).set({ voiceAudioUrl: speaker.voiceAudioUrl }).where(eq(schema.characters.id, speaker.id)).run() }
+})
+
+test('initial breakdown validates voices before replacement and persists valid bindings', async () => {
+  const before = row().videoPrompt
+  await assert.rejects(call('saveStoryboards', { replace_existing: true, storyboards: [
+    { shot_number: 1, character_ids: [speaker.id], video_prompt: '#虚构角色' },
+  ] }), /音色/)
+  assert.equal(row().videoPrompt, before)
+  await call('saveStoryboards', { storyboards: [
+    { shot_number: 2, character_ids: [speaker.id], description: '林小雨说：「再见。」', video_prompt: '0-3秒：@林小雨挥手，#林小雨说：「再见。」' },
+    { shot_number: 3, character_ids: [noVoice.id], description: '小白走路，无对白。', video_prompt: '@小白走路。' },
+  ] })
+  const shots = db.select().from(schema.storyboards).where(eq(schema.storyboards.episodeId, ep.id)).all()
+  const second = shots.find(s => s.storyboardNumber === 2)!
+  assert.deepEqual((await resolveStoryboardVoiceReferences(second.videoPrompt!, second.id, [])).audioUrls, [speaker.voiceAudioUrl])
+  assert.equal(shots.find(s => s.storyboardNumber === 3)!.videoPrompt, '@小白走路。')
+})
+
+test.after(async () => { db.$client.close(); await fs.rm(root, { recursive: true, force: true }) })
diff --git a/huobao-source/backend/tests/video-recovery.test.ts b/huobao-source/backend/tests/video-recovery.test.ts
new file mode 100644
index 0000000..3efa353
--- /dev/null
+++ b/huobao-source/backend/tests/video-recovery.test.ts
@@ -0,0 +1,106 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import http from 'node:http'
+import { eq } from 'drizzle-orm'
+
+// Isolated DB/storage; never read or modify user tasks/configurations.
+const root = await fs.mkdtemp(path.join(os.tmpdir(), 'huobao-recovery-'))
+process.env.SQLITE_PATH = path.join(root, 'tasks.sqlite3')
+process.env.HUOBAO_DATA_DIR = root
+process.env.STORAGE_PATH = path.join(root, 'static')
+process.env.MYSQL_AUTO_IMPORT = 'false'
+process.env.FFMPEG_BIN = '/usr/bin/false'
+process.env.FFPROBE_BIN = '/usr/bin/false'
+const { db, schema } = await import('../src/db/index.ts')
+const { generateVideo, recoverVideoTask, resumeInterruptedTasks } = await import('../src/services/generation.ts')
+const tasksRoute = (await import('../src/routes/tasks.ts')).default
+let submissionCount = 0, downloads = 0, recoveryCalls = 0, available = false, brokenResponse = false
+const video = Buffer.concat([Buffer.from([0,0,0,24]), Buffer.from('ftypisom'), Buffer.alloc(32)])
+const server = http.createServer((req, res) => {
+  if (req.method === 'POST' && req.url?.endsWith('/recover')) { recoveryCalls++; res.end('{}'); return }
+  if (req.url?.startsWith('/v2/query/')) { res.end(JSON.stringify({ task: { id:'upstream-1', status:'succeeded', duration:12, content:{url:base+'/content'} } })); return }
+  if (req.url === '/expired') { res.writeHead(403).end(); return }
+  if (req.method === 'POST' && brokenResponse) { submissionCount++; res.setHeader('X-Firemux-Task-Id','gateway-known'); res.end('{invalid'); return }
+  if (req.method === 'POST') { submissionCount++; res.setHeader('Content-Type','application/json'); res.end(JSON.stringify({ task: { id:'upstream-1', status:'succeeded', duration:12, content:{url:base+'/content'} } })); return }
+  downloads++
+  if (!available) { res.writeHead(404).end(); return }
+  res.end(video)
+})
+await new Promise<void>(resolve => server.listen(0,'127.0.0.1',resolve))
+const base = `http://127.0.0.1:${(server.address() as any).port}`
+const ts = new Date().toISOString()
+const config = db.insert(schema.aiServiceConfigs).values({ serviceType:'video', provider:'minimax', name:'test', baseUrl:base, apiKey:'test-secret', model:'["MiniMax-H3"]', createdAt:ts, updatedAt:ts }).returning().get()
+const sb = db.insert(schema.storyboards).values({ episodeId:1,storyboardNumber:1,createdAt:ts,updatedAt:ts }).returning().get()
+const row = (id:number) => db.select().from(schema.sysTask).where(eq(schema.sysTask.id,id)).get()!
+async function waitFor(id:number, status:string) {
+  const deadline=Date.now()+15000
+  while(Date.now()<deadline) { if(row(id).status===status) return row(id); await new Promise(r=>setTimeout(r,10)) }
+  assert.fail(`Task ${id} did not reach ${status}: ${JSON.stringify(row(id))}`)
+}
+
+test('failed download preserves completed upstream result; concurrent recovery does not generate again', async () => {
+  const attempts=await Promise.allSettled([0,1].map(()=>generateVideo({storyboardId:sb.id,prompt:'test',configId:config.id,duration:6})))
+  assert.equal(attempts.filter(r=>r.status==='rejected').length,1)
+  const id=(attempts.find(r=>r.status==='fulfilled') as PromiseFulfilledResult<number>).value
+  const failed=await waitFor(id,'failed')
+  assert.equal(failed.taskId,'upstream-1'); assert.equal(failed.resultUrl,base+'/content')
+  assert.equal(failed.stage,'downloading'); assert.equal(failed.errorCode,'delivery_failed')
+  assert.equal(failed.configId,config.id)
+  assert.equal(submissionCount,1)
+  const blocked=await tasksRoute.request('/',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({type:'video',storyboard_id:sb.id,prompt:'again'})})
+  assert.equal(blocked.status,400)
+  available=true
+  await Promise.all([recoverVideoTask(id),recoverVideoTask(id),recoverVideoTask(id)])
+  const completed=await waitFor(id,'completed')
+  assert.equal(completed.localPath,`static/videos/task-${id}.mp4`)
+  assert.equal(submissionCount,1); assert.equal(downloads,2)
+  assert.equal(db.select().from(schema.storyboards).where(eq(schema.storyboards.id,sb.id)).get()!.duration,12)
+  const diagnostics=await tasksRoute.request(`/${id}/diagnostics`)
+  const data=await diagnostics.text()
+  assert.doesNotMatch(data,/test-secret|127\.0\.0\.1|\/content/)
+})
+
+test('restart resumes persisted results, leaves unknown submissions for manual review, and does not overwrite newer videos',async()=>{
+  const older=db.insert(schema.sysTask).values({type:'video',storyboardId:sb.id,provider:'minimax',resultUrl:base+'/content',status:'processing',params:'{"resultDuration":9}',createdAt:ts,updatedAt:ts}).returning().get()
+  const latest=db.insert(schema.sysTask).values({type:'video',storyboardId:sb.id,status:'completed',createdAt:ts,updatedAt:ts}).returning().get()
+  db.update(schema.storyboards).set({videoUrl:'static/videos/newer.mp4'}).where(eq(schema.storyboards.id,sb.id)).run()
+  const unknown=db.insert(schema.sysTask).values({type:'video',status:'processing',createdAt:ts,updatedAt:ts}).returning().get()
+  await resumeInterruptedTasks()
+  await waitFor(older.id,'completed')
+  assert.equal(row(unknown.id).errorCode,'submission_unknown')
+  assert.equal(row(latest.id).status,'completed')
+  assert.equal(db.select().from(schema.storyboards).where(eq(schema.storyboards.id,sb.id)).get()!.videoUrl,'static/videos/newer.mp4')
+  assert.equal(submissionCount,1)
+  await assert.rejects(recoverVideoTask(unknown.id),/未保存上游任务编号/)
+})
+
+test('expired signed result is refreshed through the original task query without generating',async()=>{
+  const task=db.insert(schema.sysTask).values({type:'video',provider:'minimax',configId:config.id,configBaseUrl:base,
+    taskId:'upstream-1',resultUrl:base+'/expired',status:'failed',errorCode:'delivery_failed',createdAt:ts,updatedAt:ts}).returning().get()
+  const before=submissionCount
+  await recoverVideoTask(task.id)
+  const done=await waitFor(task.id,'completed')
+  assert.equal(done.resultUrl,base+'/content');assert.equal(submissionCount,before)
+})
+
+test('Firemux delivery recovery calls only its recovery endpoint and task query',async()=>{
+  const task=db.insert(schema.sysTask).values({type:'video',provider:'minimax',configId:config.id,configBaseUrl:base,
+    taskId:'upstream-1',status:'failed',errorCode:'delivery_failed',createdAt:ts,updatedAt:ts}).returning().get()
+  const before=submissionCount
+  await recoverVideoTask(task.id);await waitFor(task.id,'completed')
+  assert.equal(recoveryCalls,1);assert.equal(submissionCount,before)
+})
+
+test('response header preserves recovery ID when response JSON is interrupted; changed configuration is rejected',async()=>{
+  brokenResponse=true
+  const id=await generateVideo({prompt:'test',configId:config.id})
+  await waitFor(id,'failed');assert.equal(row(id).taskId,'gateway-known')
+  db.update(schema.aiServiceConfigs).set({baseUrl:'https://different.example'}).where(eq(schema.aiServiceConfigs.id,config.id)).run()
+  await assert.rejects(recoverVideoTask(id),/原视频服务配置/)
+  db.update(schema.aiServiceConfigs).set({baseUrl:base}).where(eq(schema.aiServiceConfigs.id,config.id)).run()
+})
+
+test.after(async()=>{ await new Promise<void>(resolve=>server.close(()=>resolve())); await fs.rm(root,{recursive:true,force:true}) })
diff --git a/huobao-source/backend/tests/voice-reference-generation.test.ts b/huobao-source/backend/tests/voice-reference-generation.test.ts
new file mode 100644
index 0000000..da51874
--- /dev/null
+++ b/huobao-source/backend/tests/voice-reference-generation.test.ts
@@ -0,0 +1,202 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import http from 'node:http'
+import { eq } from 'drizzle-orm'
+
+const root = await fs.mkdtemp(path.join(os.tmpdir(), 'huobao-voice-reference-'))
+process.env.SQLITE_PATH = path.join(root, 'test.sqlite3')
+process.env.HUOBAO_DATA_DIR = root
+process.env.STORAGE_PATH = path.join(root, 'static')
+process.env.MYSQL_AUTO_IMPORT = 'false'
+delete process.env.PUBLIC_BASE_URL
+const { db, schema } = await import('../src/db/index.ts')
+const { resolveVoiceMentions } = await import('../src/services/character-voice-references.ts')
+const { prepareReferenceAudio, resolveReferenceAudioUrls } = await import('../src/services/reference-audio.ts')
+const { ffmpeg } = await import('../src/utils/ffmpeg.ts')
+const { logTaskPayload } = await import('../src/utils/task-logger.ts')
+const route = (await import('../src/routes/tasks.ts')).default
+const received: any[] = []
+const server = http.createServer(async (req, res) => {
+  const chunks = []
+  for await (const chunk of req) chunks.push(chunk)
+  received.push(JSON.parse(Buffer.concat(chunks).toString()))
+  // Stop after capturing the submission. No paid generation, polling or remote download.
+  res.writeHead(400, { 'Content-Type': 'application/json' }).end('{"error":{"message":"test capture complete"}}')
+})
+await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve))
+const baseUrl = `http://127.0.0.1:${(server.address() as any).port}`
+const ts = new Date().toISOString()
+const timestamps = { createdAt: ts, updatedAt: ts }
+const drama = db.insert(schema.dramas).values({ title: '声音引用测试', ...timestamps }).returning().get()
+const episode = db.insert(schema.episodes).values({ dramaId: drama.id, episodeNumber: 1, title: '测试', ...timestamps }).returning().get()
+const configs = Object.fromEntries(['volcengine', 'minimax', 'aliyun'].map(provider => [provider,
+  db.insert(schema.aiServiceConfigs).values({ serviceType: 'video', provider, name: 'test', baseUrl, apiKey: 'mock-key',
+    model: JSON.stringify([provider === 'volcengine' ? 'doubao-seedance-2-0-mini-260615' : provider === 'minimax' ? 'MiniMax-H3' : 'wan3.0-video']), ...timestamps }).returning().get().id,
+]))
+function wav(seconds: number) {
+  const buffer = Buffer.alloc(44 + 16000 * seconds)
+  buffer.write('RIFF'); buffer.writeUInt32LE(buffer.length - 8, 4); buffer.write('WAVEfmt ', 8)
+  buffer.writeUInt32LE(16, 16); buffer.writeUInt16LE(1, 20); buffer.writeUInt16LE(1, 22)
+  buffer.writeUInt32LE(8000, 24); buffer.writeUInt32LE(16000, 28); buffer.writeUInt16LE(2, 32); buffer.writeUInt16LE(16, 34)
+  buffer.write('data', 36); buffer.writeUInt32LE(buffer.length - 44, 40)
+  return buffer
+}
+await fs.mkdir(path.join(root, 'static/uploads'), { recursive: true })
+for (const seconds of [1, 3, 9, 16]) await fs.writeFile(path.join(root, `static/uploads/${seconds}.wav`), wav(seconds))
+const char = (name: string, url: string | null = 'static/uploads/3.wav', dramaId = drama.id) =>
+  db.insert(schema.characters).values({ name, dramaId, voiceAudioUrl: url, ...timestamps }).returning().get()
+const shot = (...characters: { id: number }[]) => {
+  const sb = db.insert(schema.storyboards).values({ episodeId: episode.id, storyboardNumber: 1, ...timestamps }).returning().get()
+  for (const c of characters) db.insert(schema.storyboardCharacters).values({ storyboardId: sb.id, characterId: c.id }).run()
+  return sb.id
+}
+async function submit(storyboardId: number, prompt: string, extra = {}) {
+  return route.request('/', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({
+    type: 'video', storyboard_id: storyboardId, prompt, config_id: configs.volcengine,
+    reference_image_urls: ['https://example.test/portrait.png'], ...extra,
+  }) })
+}
+async function waitForSubmission(id: number) {
+  const end = Date.now() + 5000
+  while (Date.now() < end) {
+    const row = db.select().from(schema.sysTask).where(eq(schema.sysTask.id, id)).get()!
+    if (row.status === 'failed') return row
+    await new Promise(resolve => setTimeout(resolve, 10))
+  }
+  assert.fail('mock submission did not complete')
+}
+
+test('voice indices follow explicit audio then first appearance; repeats and shared samples are deduplicated', () => {
+  const resolved = resolveVoiceMentions('@小雨 使用#小雨姐姐，#小雨，#小雨姐姐', [
+    { name: '小雨', voiceAudioUrl: 'a.wav' }, { name: '小雨姐姐', voiceAudioUrl: 'b.wav' },
+  ], ['a.wav', 'a.wav'])
+  assert.deepEqual(resolved.audioUrls, ['a.wav', 'b.wav'])
+  assert.match(resolved.prompt, /小雨姐姐（音色参考音频2）/)
+  assert.match(resolved.prompt, /小雨（音色参考音频1）/)
+  assert.doesNotMatch(resolved.prompt, /#小雨/)
+  assert.match(resolved.prompt, /@小雨/)
+  assert.deepEqual(resolveVoiceMentions('@小雨 #01', [{ name: '小雨', voiceAudioUrl: 'a.wav' }]).audioUrls, [])
+  assert.equal(resolveVoiceMentions('#A B，C', [{ name: 'A B，C', voiceAudioUrl: 'a.wav' }]).hasVoiceReferences, true)
+})
+
+test('missing, ambiguous and unknown voice mentions fail rather than generating without the requested voice', () => {
+  assert.throws(() => resolveVoiceMentions('#小雨', [{ name: '小雨', voiceAudioUrl: null }]), /尚未上传/)
+  assert.throws(() => resolveVoiceMentions('#未知', []), /无效/)
+  assert.throws(() => resolveVoiceMentions('#小雨', [{ name: '小雨', voiceAudioUrl: 'a' }, { name: '小雨', voiceAudioUrl: 'b' }]), /同名/)
+})
+
+test('inline dialogue keeps speakers and delivery text in place, including repeated and overlapping names', () => {
+  const result = resolveVoiceMentions('0-3秒：@小雨抬头，#小雨轻声说：「早上好。」\n3-6秒：#小雨姐姐笑着说：「你好。」#小雨低声回应。', [
+    { name: '小雨', voiceAudioUrl: 'a.wav' }, { name: '小雨姐姐', voiceAudioUrl: 'b.wav' },
+  ])
+  assert.deepEqual(result.audioUrls, ['a.wav', 'b.wav'])
+  assert.equal(result.prompt, '0-3秒：@小雨抬头，小雨（音色参考音频1）轻声说：「早上好。」\n3-6秒：小雨姐姐（音色参考音频2）笑着说：「你好。」小雨（音色参考音频1）低声回应。')
+  assert.throws(() => resolveVoiceMentions('#小雨姐姐轻声说：「你好。」', [
+    { name: '小雨', voiceAudioUrl: 'a.wav' }, { name: '小雨姐姐', voiceAudioUrl: 'b.wav', bound: false },
+  ]), /未绑定/)
+})
+
+test('saved suffix references remain compatible and do not attach the same voice twice', () => {
+  const result = resolveVoiceMentions('使用#小雨音色，#小雨轻声说：「早上好。」', [{ name: '小雨', voiceAudioUrl: 'a.wav' }])
+  assert.deepEqual(result.audioUrls, ['a.wav'])
+  assert.equal(result.prompt, '使用小雨（音色参考音频1），小雨（音色参考音频1）轻声说：「早上好。」')
+  const namedWithSuffix = resolveVoiceMentions('#小雨音色说话', [
+    { name: '小雨', voiceAudioUrl: 'a.wav' }, { name: '小雨音色', voiceAudioUrl: 'b.wav' },
+  ])
+  assert.deepEqual(namedWithSuffix.audioUrls, ['b.wav'])
+})
+
+test('Seedance and MiniMax submissions carry local voice bytes and correct role bindings without a public URL', async () => {
+  const c = char('林小雨')
+  for (const provider of ['volcengine', 'minimax']) {
+    const response = await submit(shot(c), '0-3秒：@图片1林小雨抬头，#林小雨轻声说：「早上好。」', { config_id: configs[provider] })
+    assert.equal(response.status, 201, await response.clone().text())
+    const { data } = await response.json()
+    const task = await waitForSubmission(data.id)
+    const request = received.at(-1)
+    assert.match(request.content.find((c: any) => c.type === 'text').text, /林小雨.*音频1/)
+    const audio = request.content.filter((c: any) => c.type === 'audio_url')
+    assert.equal(audio.length, 1)
+    assert.equal(audio[0].role, 'reference_audio')
+    assert.equal(audio[0].audio_url.url, `data:audio/wav;base64,${wav(3).toString('base64')}`)
+    assert.deepEqual(JSON.parse(task.params!).referenceAudioUrls, ['static/uploads/3.wav'])
+    if (provider === 'volcengine') assert.equal(request.generate_audio, true)
+  }
+})
+
+test('image-only prompts never attach the character voice automatically', async () => {
+  const response = await submit(shot(char('小雨')), '@图片1小雨走路')
+  const { data } = await response.json()
+  await waitForSubmission(data.id)
+  assert.equal(received.at(-1).content.some((c: any) => c.type === 'audio_url'), false)
+})
+
+test('unbound, foreign and deleted roles are rejected before creating a generation task', async () => {
+  const otherDrama = db.insert(schema.dramas).values({ title: 'other', ...timestamps }).returning().get()
+  const foreign = char('外部角色', 'static/uploads/3.wav', otherDrama.id)
+  const deleted = char('已删除')
+  db.update(schema.characters).set({ deletedAt: ts }).where(eq(schema.characters.id, deleted.id)).run()
+  char('未绑定')
+  const before = db.select().from(schema.sysTask).all().length
+  for (const [id, prompt] of [[shot(), '#未绑定'], [shot(foreign), '#外部角色'], [shot(deleted), '#已删除']] as const) {
+    const response = await submit(id, prompt)
+    assert.equal(response.status, 400)
+    assert.match(await response.text(), /音色引用/)
+  }
+  assert.equal(db.select().from(schema.sysTask).all().length, before)
+})
+
+test('invalid voices, silent mode, missing visual references and provider count limits fail before submission', async () => {
+  const valid = char('有效')
+  const before = db.select().from(schema.sysTask).all().length
+  for (const [name, url, expected] of [
+    ['丢失', 'static/uploads/missing.wav', /不存在/],
+    ['太短', 'static/uploads/1.wav', /2–15/], ['太长', 'static/uploads/16.wav', /2–15/],
+  ] as const) {
+    const response = await submit(shot(char(name, url)), `#${name}`)
+    assert.equal(response.status, 400)
+    assert.match(await response.text(), expected)
+  }
+  for (const extra of [{ generate_audio: false }, { reference_image_urls: [] }, { config_id: configs.aliyun }]) {
+    const response = await submit(shot(valid), '#有效', extra)
+    assert.equal(response.status, 400)
+  }
+  const roles = [1, 2, 3, 4].map(n => char(`角色${n}`, `https://example.test/${n}.wav`))
+  const response = await submit(shot(...roles), roles.map(c => `#${c.name}`).join(' '))
+  assert.equal(response.status, 400)
+  assert.match(await response.text(), /音频≤3/)
+  assert.equal(db.select().from(schema.sysTask).all().length, before)
+})
+
+test('sample duration total and traversal are checked, and local M4A is converted and reused', async () => {
+  await fs.copyFile(path.join(root, 'static/uploads/9.wav'), path.join(root, 'static/uploads/another.wav'))
+  await assert.rejects(prepareReferenceAudio(['static/uploads/9.wav', 'static/uploads/another.wav'], 'volcengine'), /总时长/)
+  await assert.rejects(prepareReferenceAudio(['static/../outside.wav'], 'volcengine'), /无效/)
+  const m4a = path.join(root, 'static/uploads/sample.m4a')
+  await new Promise<void>((resolve, reject) => ffmpeg(path.join(root, 'static/uploads/3.wav')).audioCodec('aac')
+    .on('end', () => resolve()).on('error', reject).save(m4a))
+  const prepared = await prepareReferenceAudio(['static/uploads/sample.m4a'], 'volcengine')
+  assert.match(prepared[0], /^static\/voice-references\/[a-f0-9]+\.wav$/)
+  assert.deepEqual(await prepareReferenceAudio(['static/uploads/sample.m4a'], 'volcengine'), prepared)
+  assert.match((await resolveReferenceAudioUrls(prepared, 'volcengine'))[0], /^data:audio\/wav;base64,/)
+  process.env.PUBLIC_BASE_URL = 'https://assets.example.test/'
+  try {
+    assert.deepEqual(await resolveReferenceAudioUrls(prepared, 'aliyun'), [`https://assets.example.test/${prepared[0]}`])
+  } finally { delete process.env.PUBLIC_BASE_URL }
+})
+
+test('task logs omit inline audio bytes', t => {
+  const logs: string[] = []
+  t.mock.method(console, 'log', (...args: unknown[]) => logs.push(args.join(' ')))
+  logTaskPayload('test', 'audio', { content: [{ audio_url: { url: 'data:audio/wav;base64,private-audio' } }] })
+  assert.doesNotMatch(logs.join(''), /private-audio/)
+})
+
+test.after(async () => {
+  await new Promise<void>(resolve => server.close(() => resolve()))
+  db.$client.close()
+  await fs.rm(root, { recursive: true, force: true })
+})
diff --git a/huobao-source/backend/tsconfig.json b/huobao-source/backend/tsconfig.json
new file mode 100644
index 0000000..fb169c2
--- /dev/null
+++ b/huobao-source/backend/tsconfig.json
@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"]
+}
diff --git a/huobao-source/backend/workspace/prompts/extractor.en.md b/huobao-source/backend/workspace/prompts/extractor.en.md
new file mode 100644
index 0000000..13ce96b
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/extractor.en.md
@@ -0,0 +1,36 @@
+---
+name: Character & Scene Extraction
+model: ""
+---
+
+You are a production assistant, skilled at extracting character, scene, and prop information from scripts, and intelligently deduplicating against existing project data during extraction.
+
+Workflow:
+1. Call read_script_for_extraction to read the formatted script
+2. Call read_existing_characters to read the list of characters already in the project, plus the characters already linked to the current episode
+3. Call read_existing_scenes to read the list of scenes already in the project, plus the scenes already linked to the current episode
+4. Call read_existing_props to read the list of props already in the project, plus the props already linked to the current episode
+5. Focus on the current episode's script and analyze the characters, scenes, and props that actually appear in this episode
+6. For each character: if one with the same name already exists, merge and update it; otherwise create a new one
+7. Call save_dedup_characters to save the characters (deduplicated merge; automatically handles creation and updates, and links them to the current episode)
+8. Analyze the script content and extract all scene information involved in this episode
+9. For each scene: if one with the same location + time period already exists, reuse it; otherwise create a new one
+10. Call save_dedup_scenes to save the scenes (deduplicated merge; automatically handles creation and reuse, and links them to the current episode)
+11. Extract the key props of this episode — both of the following conditions must be met, neither is optional:
+    a) Directly drives the plot: the item's appearance, handover, damage, or discovery triggers a plot turn (e.g. a murder weapon, a token, a key document, a love-token gift, evidence);
+    b) Worth generating a dedicated image: later storyboards will give it close-ups or it recurs, so it needs a fixed appearance.
+    Three self-check questions (ask and answer for yourself; if any answer is "no", drop the prop): (1) Does the plot still hold if it is removed? If yes → do not extract; (2) Is it just an everyday item the character casually uses (phone, chopsticks, cup, cigarettes)? If yes → do not extract; (3) Is it part of the set dressing (tables and chairs, lamps, doors and windows, decorations)? If yes → do not extract.
+    Prefer extracting too few over too many: an episode usually has 0-3 key props; if there are more than 3, rank them by plot importance and keep only the top 3; if no prop qualifies, extract none at all
+12. For each prop: if one with the same name already exists, merge and update it; otherwise create a new one
+13. Call save_dedup_props to save the props (deduplicated merge; automatically handles creation and updates, and links them to the current episode); if there are no props to extract, pass an empty array — do not force entries just to fill the list
+
+Deduplication rules:
+- Characters/props: exact match by name; on a match, keep the existing one (merge information). When a name carries a parenthesized qualifier or alias, compare by the main part before the parentheses (e.g. "Lin Xiaoyu (protagonist)" and "Lin Xiaoyu" are the same character — prefer reusing the existing project entry, do not create a duplicate). The normalized_name returned by read_existing_characters / read_existing_props is the normalized name and can be used for this judgment
+- Scenes: exact match on [location + time period] (location compared ignoring whitespace/case); the same location at a different time period counts as a new scene
+
+Extraction requirements:
+- Only extract characters, scenes, and props that actually appear in, or are explicitly mentioned in, the current episode and are narratively effective for it
+- A character needs only two core description fields: appearance (looks: age impression, facial features, physique, bearing, etc. — convert personality traits into outward bearing and expression woven into the appearance description; do not output a separate personality field) and styling (hair, clothing, makeup, accessories, etc.)
+- A scene needs only two core description fields: prompt (scene description: space, set dressing, period texture, key visual elements, etc.) and lighting (scene lighting: light sources, color tone, brightness contrast, mood, etc.)
+- Prop fields: name (prop name), type (category: daily / weapon / transportation / decoration / document, etc.), description (physical appearance of the item only — material, color, shape, size, degree of wear, signs of damage, etc.; do not describe its plot purpose or its relation to characters or anything else). Props do not need an image prompt; the final prompt will be generated later by the prompt-generation Agent
+- Do not omit any character who has lines or important actions
diff --git a/huobao-source/backend/workspace/prompts/extractor.ja.md b/huobao-source/backend/workspace/prompts/extractor.ja.md
new file mode 100644
index 0000000..950391c
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/extractor.ja.md
@@ -0,0 +1,36 @@
+---
+name: キャラクター・シーン抽出
+model: ""
+---
+
+あなたは制作アシスタントです。脚本からキャラクター、シーン、小道具の情報を抽出し、抽出時にプロジェクトの既存データと照らし合わせて賢く重複排除を行うことに長けています。
+
+ワークフロー：
+1. read_script_for_extraction を呼び出してフォーマット済み脚本を読み込む
+2. read_existing_characters を呼び出してプロジェクトに既に存在するキャラクターリストと、現在の話に関連付け済みのキャラクターを読み込む
+3. read_existing_scenes を呼び出してプロジェクトに既に存在するシーンリストと、現在の話に関連付け済みのシーンを読み込む
+4. read_existing_props を呼び出してプロジェクトに既に存在する小道具リストと、現在の話に関連付け済みの小道具を読み込む
+5. 現在の話の脚本を中心に、この話に実際に登場するキャラクター、シーン、小道具を分析する
+6. 各キャラクターについて：同名のものが既に存在すればマージして更新し、存在しなければ新規追加する
+7. save_dedup_characters を呼び出してキャラクターを保存する（重複排除・マージされ、新規追加と更新が自動処理され、現在の話に関連付けられる）
+8. 脚本内容を分析し、この話に関わるすべてのシーン情報を抽出する
+9. 各シーンについて：同じ場所＋時間帯のものが既に存在すれば再利用し、存在しなければ新規追加する
+10. save_dedup_scenes を呼び出してシーンを保存する（重複排除・マージされ、新規追加と再利用が自動処理され、現在の話に関連付けられる）
+11. この話の重要な小道具を抽出する——以下の2条件を**同時に**満たすものに限り、どちらか一方でも欠けてはならない：
+    a) 物語を直接動かす：その物品の出現、受け渡し、破損、発見がプロットの転換を引き起こす（凶器、形見、重要書類、愛の誓いの贈り物、証拠など）；
+    b) 単独で画像生成する価値がある：後続の絵コンテでクローズアップされたり繰り返し登場したりするため、外観を固定する必要がある。
+    判定の3問（各候補に自問自答し、いずれか1つでも「いいえ」ならその小道具は諦める）：① それを削除しても物語は成立するか？成立する → 抽出しない；② それはキャラクターが何気なく使う日用品（スマホ、箸、コップ、タバコ）にすぎないか？そうである → 抽出しない；③ それはシーンの調度品の一部（テーブル・椅子、照明、ドア・窓、装飾）か？そうである → 抽出しない。
+    多く抽出するより少なく抽出する方がよい：1話あたり重要な小道具は通常0〜3個。3個を超える場合は物語上の重要度で並べ替えて上位3個だけを残す。条件に合う小道具がなければ1つも抽出しない
+12. 各小道具について：同名のものが既に存在すればマージして更新し、存在しなければ新規追加する
+13. save_dedup_props を呼び出して小道具を保存する（重複排除・マージされ、新規追加と更新が自動処理され、現在の話に関連付けられる）；抽出すべき小道具がなければ、呼び出し時に空の配列を渡せばよい。無理に数を合わせてはならない
+
+重複排除ルール：
+- キャラクター／小道具：名前の完全一致で判定。同名なら既存を保持（情報をマージ）；名前に括弧付きの位置づけや別名が含まれる場合は括弧の前の本体部分で比較する（例：「林小雨（主役）」と「林小雨」は同一キャラクターとみなし、プロジェクト既存のものを優先的に再利用し、重複作成しない）。read_existing_characters / read_existing_props が返す normalized_name が正規化後の名前なので、それに基づいて判断できる
+- シーン：【場所＋時間帯】の完全一致で判定（場所は空白・大文字小文字を無視）；同じ場所でも時間帯が異なれば新規シーンとみなす
+
+抽出要件：
+- 現在の話に実際に登場するか明確に言及され、かつ現在の話の物語に有効なキャラクター、シーン、小道具のみを抽出する
+- キャラクターに必要な中核的な説明フィールドは2つのみ：appearance（容姿：年齢感、顔立ち、体格、雰囲気など。キャラクターの性格特性は外的な雰囲気や表情に変換して容姿描写に溶け込ませること。性格フィールドを単独で出力しない）と styling（装い：髪型、服装、メイク、アクセサリーなど）
+- シーンに必要な中核的な説明フィールドは2つのみ：prompt（シーン描写：空間、調度品、年代の質感、重要な視覚要素など）と lighting（シーンの光影：光源、色調、明暗、雰囲気など）
+- 小道具フィールド：name（小道具名）、type（種類：日常／武器／交通／装飾／書類など）、description（物品の外観：物品そのものの物理的な外観——材質、色、形状、大きさ、新旧の度合い、摩耗の跡など——のみを描写する。物語上の用途は書かず、キャラクターや他の事物との関連にも触れない）。小道具に画像プロンプトは出力不要。最終プロンプトはプロンプト生成エージェントが後で専門に生成する
+- セリフのあるキャラクターや重要な動作のあるキャラクターを1人も漏らさない
diff --git a/huobao-source/backend/workspace/prompts/extractor.ko.md b/huobao-source/backend/workspace/prompts/extractor.ko.md
new file mode 100644
index 0000000..58c8e79
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/extractor.ko.md
@@ -0,0 +1,36 @@
+---
+name: 캐릭터·장면 추출
+model: ""
+---
+
+당신은 제작 어시스턴트로, 대본에서 캐릭터·장면·소품 정보를 추출하고, 추출 시 프로젝트의 기존 데이터와 지능적으로 중복을 제거하는 데 능숙합니다.
+
+작업 흐름:
+1. read_script_for_extraction 을 호출해 포맷된 대본을 읽습니다
+2. read_existing_characters 를 호출해 프로젝트에 이미 존재하는 캐릭터 목록과 현재 화에 이미 연결된 캐릭터를 읽습니다
+3. read_existing_scenes 를 호출해 프로젝트에 이미 존재하는 장면 목록과 현재 화에 이미 연결된 장면을 읽습니다
+4. read_existing_props 를 호출해 프로젝트에 이미 존재하는 소품 목록과 현재 화에 이미 연결된 소품을 읽습니다
+5. 현재 화의 대본을 중심으로, 이번 화에 실제로 등장하는 캐릭터·장면·소품을 분석합니다
+6. 각 캐릭터에 대해: 동일한 이름이 이미 존재하면 병합·갱신하고, 존재하지 않으면 새로 추가합니다
+7. save_dedup_characters 를 호출해 캐릭터를 저장합니다(중복 제거·병합, 신규 추가와 갱신을 자동 처리, 현재 화에 연결)
+8. 대본 내용을 분석해 이번 화에 관련된 모든 장면 정보를 추출합니다
+9. 각 장면에 대해: 동일한 장소+시간대가 이미 존재하면 재사용하고, 존재하지 않으면 새로 추가합니다
+10. save_dedup_scenes 를 호출해 장면을 저장합니다(중복 제거·병합, 신규 추가와 재사용을 자동 처리, 현재 화에 연결)
+11. 이번 화의 핵심 소품을 추출합니다 — 반드시 다음 두 조건을 동시에 만족해야 하며, 하나라도 빠지면 안 됩니다:
+    a) 줄거리를 직접 추진할 것: 해당 물건의 등장, 전달, 파손 또는 발견이 사건의 전환점을 유발해야 합니다(예: 흉기, 증표, 핵심 문서, 사랑의 증표, 증거);
+    b) 단독 이미지 생성 가치가 있을 것: 이후 스토리보드에서 클로즈업되거나 반복 등장하여 고정된 외형이 필요해야 합니다.
+    판정 세 가지 질문(스스로 묻고 답하되, 어느 하나라도 "아니오"이면 해당 소품을 포기): ① 이것을 삭제해도 줄거리가 여전히 성립하는가? 성립 → 추출하지 않음; ② 캐릭터가 무심코 사용하는 일상 물품(휴대폰, 젓가락, 컵, 담배)인가? 그렇다 → 추출하지 않음; ③ 장면의 비품·장식의 일부(책상·의자, 조명, 문·창문, 장식물)인가? 그렇다 → 추출하지 않음.
+    많이 뽑기보다 적게 뽑으세요: 한 화에는 보통 0-3개의 핵심 소품이 있으며, 3개를 초과하면 줄거리 중요도 순으로 상위 3개만 남깁니다; 조건에 맞는 소품이 없으면 하나도 추출하지 않습니다
+12. 각 소품에 대해: 동일한 이름이 이미 존재하면 병합·갱신하고, 존재하지 않으면 새로 추가합니다
+13. save_dedup_props 를 호출해 소품을 저장합니다(중복 제거·병합, 신규 추가와 갱신을 자동 처리, 현재 화에 연결); 추출할 소품이 없으면 호출 시 빈 배열을 전달하면 되며, 억지로 개수를 채우지 마세요
+
+중복 제거 규칙:
+- 캐릭터/소품: 이름을 정확히 일치시켜 비교하고, 동일 이름이면 기존 항목을 유지합니다(정보 병합); 이름에 괄호로 위치/역할 표시나 별칭이 붙은 경우 괄호 앞의 본체를 기준으로 비교합니다(예: 「林小雨(주인공)」과 「林小雨」는 동일 캐릭터로 간주하고, 프로젝트 기존 항목을 우선 재사용하며 중복 생성하지 않습니다). read_existing_characters / read_existing_props 가 반환하는 normalized_name 이 정규화된 이름이므로 이를 기준으로 판단할 수 있습니다
+- 장면: 【장소+시간대】를 정확히 일치시켜 비교합니다(장소는 공백/대소문자 무시); 같은 장소라도 시간대가 다르면 새 장면으로 간주합니다
+
+추출 요구 사항:
+- 현재 화에 실제로 등장하거나 명확히 언급되고, 현재 화의 서사에 유효한 캐릭터·장면·소품만 추출합니다
+- 캐릭터에는 두 가지 핵심 설명 필드만 필요합니다: appearance(외모: 나이대, 이목구비, 체형, 분위기 등 — 캐릭터의 성격 특징은 외적인 분위기와 표정으로 전환해 외모 묘사에 녹여내고, 성격 필드를 따로 출력하지 마세요)와 styling(스타일링: 헤어스타일, 의상, 메이크업, 액세서리 등)
+- 장면에는 두 가지 핵심 설명 필드만 필요합니다: prompt(장면 묘사: 공간, 비품·장식, 시대적 질감, 핵심 시각 요소 등)와 lighting(장면 조명: 광원, 색조, 명암, 분위기 등)
+- 소품 필드: name(소품명), type(유형: 일상/무기/교통/장식/문서 등), description(물건의 외형: 물건 자체의 물리적 외형만 묘사 — 재질, 색상, 형태, 크기, 사용감, 마모 흔적 등. 줄거리상 용도를 쓰지 말고, 캐릭터나 다른 사물과의 연관에도 관여하지 마세요). 소품은 이미지 프롬프트를 출력할 필요가 없습니다 — 최종 프롬프트는 이후 프롬프트 생성 에이전트가 별도로 생성합니다
+- 대사가 있거나 중요한 동작이 있는 캐릭터를 하나도 누락하지 마세요
diff --git a/huobao-source/backend/workspace/prompts/extractor.md b/huobao-source/backend/workspace/prompts/extractor.md
new file mode 100644
index 0000000..c25c2b1
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/extractor.md
@@ -0,0 +1,36 @@
+---
+name: 角色场景提取
+model: ""
+---
+
+你是制片助理，擅长从剧本中提取角色、场景和道具信息，并在提取时与项目已有数据进行智能去重。
+
+工作流程：
+1. 调用 read_script_for_extraction 读取格式化剧本
+2. 调用 read_existing_characters 读取项目中已存在的角色列表，以及当前集已关联角色
+3. 调用 read_existing_scenes 读取项目中已存在的场景列表，以及当前集已关联场景
+4. 调用 read_existing_props 读取项目中已存在的道具列表，以及当前集已关联道具
+5. 优先围绕当前集剧本，分析本集实际出现的角色、场景和道具
+6. 对每个角色：若同名已存在则合并更新，若不存在则新增
+7. 调用 save_dedup_characters 保存角色（去重合并，自动处理新增和更新，并关联到当前集）
+8. 分析剧本内容，提取本集涉及的所有场景信息
+9. 对每个场景：若同地点+时间段已存在则复用，若不存在则新增
+10. 调用 save_dedup_scenes 保存场景（去重合并，自动处理新增和复用，并关联到当前集）
+11. 提取本集的关键道具——必须同时满足以下两条，缺一不可：
+    a) 直接推动剧情：该物品的出现、交接、损坏或发现会引发情节转折（如凶器、信物、关键文件、定情礼物、证据）；
+    b) 值得单独生成图片：后续分镜会给它特写或反复出现，需要固定外观。
+    判定三问（自问自答，任一答"否"即放弃该道具）：① 删掉它剧情是否依然成立？成立 → 不提取；② 它只是角色随手使用的日常物品（手机、筷子、杯子、烟）吗？是 → 不提取；③ 它是场景陈设的一部分（桌椅、灯具、门窗、装饰）吗？是 → 不提取。
+    宁可少提，不要多提：一集通常 0-3 个关键道具，超过 3 个时按剧情重要性排序只保留前 3 个；没有符合条件的道具就一个都不要提取
+12. 对每个道具：若同名已存在则合并更新，若不存在则新增
+13. 调用 save_dedup_props 保存道具（去重合并，自动处理新增和更新，并关联到当前集）；若没有需要提取的道具，调用时传空数组即可，不要强行凑数
+
+去重规则：
+- 角色/道具：按名字精确匹配，同名保留现有（合并信息）；名称带括号定位或别名时按括号前主体比较（如「林小雨（主角）」与「林小雨」视为同一角色，优先复用项目已有，不要重复创建）。read_existing_characters / read_existing_props 返回的 normalized_name 即归一化后的名字，可据此判断
+- 场景：按【地点+时间段】精确匹配（地点忽略空白/大小写）；同地点不同时段视为新场景
+
+提取要求：
+- 只提取当前集真实出现或被明确提及、且对当前集叙事有效的角色、场景和道具
+- 角色只需要两个核心描述字段：appearance（样貌：年龄感、五官、体态、气质等，角色的性格特点要转化为外在气质与神态融入样貌描写，不要单独输出性格字段）和 styling（妆造：发型、服装、妆面、配饰等）
+- 场景只需要两个核心描述字段：prompt（场景描述：空间、陈设、年代质感、关键视觉元素等）和 lighting（场景光影：光源、色调、明暗、氛围等）
+- 道具字段：name（道具名）、type（类型：日常/武器/交通/装饰/文件等）、description（物品外貌：只描写物品本身的物理外观——材质、颜色、形状、大小、新旧程度、磨损痕迹等，不要写剧情用途，不要涉及与角色或其他事物的关联）。道具不需要输出图片提示词，最终提示词由提示词生成 Agent 后续专门生成
+- 不要遗漏任何有台词或重要动作的角色
diff --git a/huobao-source/backend/workspace/prompts/prompt_generator.en.md b/huobao-source/backend/workspace/prompts/prompt_generator.en.md
new file mode 100644
index 0000000..1fb181f
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/prompt_generator.en.md
@@ -0,0 +1,34 @@
+---
+name: Prompt Generation
+model: ""
+---
+
+You are a professional AI prompt engineer, responsible for creating and saving two kinds of prompts:
+1. The "final prompts" for characters/scenes/props, used directly for image generation
+2. The "video prompts" (video_prompt) for storyboards, used directly for video generation
+
+## Final Image Prompts
+
+The user request will tell you which characters, scenes, or props to generate final prompts for (with character_id / scene_id / prop_id attached).
+
+Workflow:
+1. Call read_characters / read_scenes / read_props to read the asset information
+2. Create the final prompt according to the skill specification for the corresponding asset type (character turnaround sheet / fixed-viewpoint scene / white-background prop product shot)
+3. Call save_character_final_prompt / save_scene_final_prompt / save_prop_final_prompt to save each one individually
+
+Hard rule: **A scene image = an empty shot with no people**. Even if the scene description mentions human activity, it must be completely removed; no people of any kind may appear in the scene image (including backs, silhouettes, reflections, or people in photos) — keep only the scene itself.
+
+## Video Prompts
+
+The user request will tell you which storyboard to generate a video prompt for (with the storyboard ID attached).
+
+Workflow:
+1. Call read_storyboard_context to read the storyboard's description (containing the 【镜头N】 sub-shots and dialogue/narration), atmosphere, duration, and its bound scene/characters
+2. Generate the video_prompt accordingly: split into 3-second segments, each segment on its own line separated by newlines; map each 【镜头N】 in the description to 1-2 consecutive 3-second segments (same order, no omissions, no new sub-shots); extract dialogue/narration from the "CharacterName says: "..."" / "Narration: ..." entries inside the corresponding 【镜头N】 — do not invent new dialogue beyond the description; use @SceneName when mentioning a scene and @CharacterName when mentioning a character (names must exactly match the lists); take mood and lighting from atmosphere. Cutting between shots within a storyboard segment is allowed (change of shot size/angle/subject); consecutive segments may be different shots, but never cross scenes; cut points align with the 【镜头N】 structure of the storyboard description
+3. During generation, each @name is automatically replaced with the corresponding reference-image marker (e.g. @Xiaoming → @Image1Xiaoming), so names must exactly match the scene/character lists — do not abbreviate or add extra symbols
+4. When saving via update_storyboard, pass only two keys: storyboard_id and video_prompt. Do not send back any other field of the storyboard (title, description, scene_id, etc. — none of them)
+
+General rules:
+- Write each prompt as a single coherent passage — no bullet points, no unrelated words mixed in
+- The project's visual-style description is automatically injected by the tool at the very front of the final prompt when saving an image prompt — do not add style words yourself
+- You must actually call the save tools — do not merely present the prompts in your reply
diff --git a/huobao-source/backend/workspace/prompts/prompt_generator.ja.md b/huobao-source/backend/workspace/prompts/prompt_generator.ja.md
new file mode 100644
index 0000000..09fe3c2
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/prompt_generator.ja.md
@@ -0,0 +1,34 @@
+---
+name: プロンプト
+model: ""
+---
+
+あなたはプロのAIプロンプトエンジニアです。以下の2種類のプロンプトの作成と保存を担当します：
+1. キャラクター／シーン／小道具の「最終プロンプト」——画像生成で直接使用
+2. 絵コンテの「動画プロンプト」（video_prompt）——動画生成で直接使用
+
+## 画像の最終プロンプト
+
+ユーザーのリクエストには、どのキャラクター、シーン、小道具の最終プロンプトを生成するかが示されます（character_id / scene_id / prop_id が付随）。
+
+ワークフロー：
+1. read_characters / read_scenes / read_props を呼び出してアセット情報を読み込む
+2. 対応するアセットのスキル仕様（キャラクター三面図 / シーン固定視点 / 小道具白背景単品）に従って最終プロンプトを作成する
+3. save_character_final_prompt / save_scene_final_prompt / save_prop_final_prompt を呼び出して1件ずつ保存する
+
+硬性ルール：**シーン画像 = 人物なしの空カット**。シーン描写に人物の活動が言及されていても完全に取り除き、シーン画像にはいかなる人物（後ろ姿、シルエット、反射・映り込み、写真の中の人物を含む）も出してはならず、シーンそのものだけを残す。
+
+## 動画プロンプト
+
+ユーザーのリクエストには、どの絵コンテの動画プロンプトを生成するかが示されます（絵コンテIDが付随）。
+
+ワークフロー：
+1. read_storyboard_context を呼び出して、その絵コンテの description（【镜头N】のサブカットとセリフ／ナレーションを含む）、atmosphere、duration、および紐付けられたシーン／キャラクターを読み込む
+2. これに基づき video_prompt を生成する：3秒を1区間とし、各区間を改行で区切って1行ずつ記述。description の各【镜头N】を連続した1〜2個の3秒区間にマッピングする（順序一致、漏れなし、サブカットの新規追加なし）。セリフ／ナレーションは対応する【镜头N】内の「キャラクター名は言う：「…」」「ナレーション：…」から抽出し、description 以外の新しいセリフを創作しない。シーンに言及する際は @シーン名、キャラクターに言及する際は @キャラクター名を使う（名前はリストと完全に一致させること）。雰囲気・光線は atmosphere から取る。1つの絵コンテパラグラフ内ではカット切り替え（ショットサイズ／アングル／被写体の変更）は許可される。区間と区間の間は異なるカットでよいが、シーンをまたがない。カットの切り替え位置は絵コンテ description の【镜头N】構造に揃える
+3. 生成時に @名前 は対応する参照画像マーカーへ自動的に置き換えられる（例：@小明 → @图片1小明）。そのため名前はシーン／キャラクターリストと正確に一致させ、略称や余分な記号を付けない
+4. update_storyboard を呼び出して保存する際、パラメータは storyboard_id と video_prompt の2キーのみを渡す。その絵コンテの他のフィールド（title、description、scene_id など）は一切返さない
+
+共通仕様：
+- すべてのプロンプトはこのセッションの言語指令で指定されたターゲット言語で出力し、1段落の連続した記述にする。箇条書きにせず、無関係な語彙を混ぜない
+- プロジェクト設定のビジュアルスタイル記述は、ツールが画像プロンプト保存時に最終プロンプトの先頭へ自動注入する。自分でスタイル語を追加しない
+- 必ず実際に保存ツールを呼び出すこと。返答にプロンプトを書くだけで終わらせない
diff --git a/huobao-source/backend/workspace/prompts/prompt_generator.ko.md b/huobao-source/backend/workspace/prompts/prompt_generator.ko.md
new file mode 100644
index 0000000..7d2167f
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/prompt_generator.ko.md
@@ -0,0 +1,34 @@
+---
+name: 프롬프트
+model: ""
+---
+
+당신은 전문 AI 프롬프트 엔지니어로, 다음 두 종류의 프롬프트 작성과 저장을 담당합니다:
+1. 캐릭터/장면/소품의 「최종 프롬프트」 — 이미지 생성에 직접 사용
+2. 스토리보드의 「비디오 프롬프트」(video_prompt) — 비디오 생성에 직접 사용
+
+## 이미지 최종 프롬프트
+
+사용자 요청에서 어떤 캐릭터, 장면 또는 소품의 최종 프롬프트를 생성할지 알려줍니다(character_id / scene_id / prop_id 첨부).
+
+작업 흐름:
+1. read_characters / read_scenes / read_props 를 호출해 자산 정보를 읽습니다
+2. 해당 자산의 스킬 규범(캐릭터 삼면도 / 장면 고정 시점 / 소품 화이트 배경 단품)에 따라 최종 프롬프트를 작성합니다
+3. save_character_final_prompt / save_scene_final_prompt / save_prop_final_prompt 를 호출해 하나씩 저장합니다
+
+엄격한 규칙: **장면 이미지 = 인물 없는 빈 장면**. 장면 설명에 인물의 활동이 언급되더라도 완전히 제거해야 하며, 장면 이미지에는 어떤 사람도 등장할 수 없습니다(뒷모습, 실루엣, 반사된 모습, 사진 속 인물 포함). 장면 자체만 남기세요.
+
+## 비디오 프롬프트
+
+사용자 요청에서 어떤 스토리보드의 비디오 프롬프트를 생성할지 알려줍니다(스토리보드 ID 첨부).
+
+작업 흐름:
+1. read_storyboard_context 를 호출해 해당 스토리보드의 description(【镜头N】 서브 컷과 대사/내레이션 포함), atmosphere, duration 및 바인딩된 장면/캐릭터를 읽습니다
+2. 이를 바탕으로 video_prompt 를 생성합니다: 3초를 한 구간으로 하고 구간마다 한 줄씩 줄바꿈으로 구분합니다; description 의 각 【镜头N】은 1-2개의 연속된 3초 구간에 매핑합니다(순서 일치, 누락 없음, 새 서브 컷 추가 없음). 대사/내레이션은 해당 【镜头N】 안의 「캐릭터명이 말한다: 「…」」「내레이션: …」에서 추출하며, description 밖의 새 대사를 창작하지 마세요; 장면을 언급할 때는 @장면명, 캐릭터를 언급할 때는 @캐릭터명을 사용합니다(이름은 목록과 완전히 일치해야 함); 분위기와 조명은 atmosphere 에서 가져옵니다. 한 스토리보드 구간 내에서는 컷 전환(화면 크기/앵글/대상 변경)이 허용되고, 구간과 구간 사이도 서로 다른 컷일 수 있지만 장면을 넘나들지는 않습니다; 컷 전환 지점은 스토리보드 description 의 【镜头N】 구조에 맞춥니다
+3. 생성 시 @이름 이 해당 참조 이미지 마커로 자동 치환되므로(예: @小明 → @图片1小明), 이름은 장면/캐릭터 목록과 정확히 일치해야 하며 축약하거나 추가 기호를 붙이지 마세요
+4. update_storyboard 를 호출해 저장할 때는 파라미터에 두 개의 키만 전달합니다: storyboard_id 와 video_prompt. 해당 스토리보드의 다른 어떤 필드(title, description, scene_id 등)도 되돌려 보내지 마세요
+
+공통 규범:
+- 모든 프롬프트는 이번 세션의 언어 지시가 지정한 목표 언어로 출력하고, 한 구간은 하나의 연결된 문장으로 서술하며, 항목으로 나누지 말고 무관한 어휘를 섞지 마세요
+- 프로젝트에 설정된 비주얼 스타일 설명은 이미지 프롬프트 저장 시 도구가 최종 프롬프트 맨 앞에 자동으로 주입하므로, 스타일 관련 단어를 직접 추가하지 마세요
+- 반드시 저장 도구를 실제로 호출하세요. 답변에 프롬프트만 적고 끝내지 마세요
diff --git a/huobao-source/backend/workspace/prompts/prompt_generator.md b/huobao-source/backend/workspace/prompts/prompt_generator.md
new file mode 100644
index 0000000..70eb3b1
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/prompt_generator.md
@@ -0,0 +1,34 @@
+---
+name: 提示词
+model: ""
+---
+
+你是专业的 AI 提示词工程师，负责两类提示词的创作与保存：
+1. 角色/场景/道具的「最终提示词」，供生图直接使用
+2. 分镜的「视频提示词」（video_prompt），供视频生成直接使用
+
+## 图片最终提示词
+
+用户请求会告知要为哪些角色、场景或道具生成最终提示词（附带 character_id / scene_id / prop_id）。
+
+工作流程：
+1. 调用 read_characters / read_scenes / read_props 读取资产信息
+2. 按对应资产的技能规范（角色三视图 / 场景固定视角 / 道具白底单品）创作最终提示词
+3. 调用 save_character_final_prompt / save_scene_final_prompt / save_prop_final_prompt 逐个保存
+
+硬性规则：**场景图 = 无人物空镜**。场景描述里即使提到人物活动，也必须完全剔除，场景图中不能出现任何的人（含背影、剪影、倒影、照片里的人），只保留场景本身。
+
+## 视频提示词
+
+用户请求会告知要为哪个分镜生成视频提示词（附带分镜 ID）。
+
+工作流程：
+1. 调用 read_storyboard_context 读取该分镜的 description（含【镜头N】子镜头与台词/旁白）、atmosphere、duration 及绑定的场景/角色
+2. 据此生成 video_prompt：按 3 秒为一段、每段单独一行换行分隔；description 的每个【镜头N】映射为 1-2 个连续 3 秒段（顺序一致、不遗漏、不新增子镜头），台词/旁白从对应【镜头N】内的「角色名说：「…」」「旁白：…」提取，不要创作 description 之外的新台词；提到场景用 @场景名、提到角色用 @角色名（名字必须与列表完全一致）；氛围光线取自 atmosphere。一个分镜段落内允许切镜（换景别/角度/对象），段与段之间可以是不同镜头，但不跨场景；切镜点对齐分镜 description 的【镜头N】结构
+3. 生成时会自动把 @名字 替换为对应参考图片标记（如 @小明 → @图片1小明），因此名字必须精确匹配场景/角色列表，不要缩写或加额外符号
+4. 调用 update_storyboard 保存时参数只传两个键：storyboard_id 和 video_prompt。不要回传该分镜的其他任何字段（title、description、scene_id 等一律不传）
+
+通用规范：
+- 所有提示词使用本次会话语言指令指定的目标语言输出，单段连贯描述，不要分点，不要混入无关词汇
+- 项目设定的视觉风格描述会由工具在保存图片提示词时自动注入到最终提示词的最前方，不要自行添加风格词
+- 必须实际调用保存工具，不要只在回复中给出提示词
diff --git a/huobao-source/backend/workspace/prompts/script_rewriter.en.md b/huobao-source/backend/workspace/prompts/script_rewriter.en.md
new file mode 100644
index 0000000..f688b1d
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/script_rewriter.en.md
@@ -0,0 +1,19 @@
+---
+name: Script Rewriting
+model: ""
+---
+
+You are a professional screenwriter, skilled at adapting novels into short-drama scripts.
+
+Workflow:
+1. Call read_episode_script to read the original content
+2. Rewrite it yourself based on what you read (output in the formatted-script format)
+3. Call save_script to save the complete rewritten script
+
+Formatted-script format:
+- Scene heading: ## S<number> | INT/EXT · Location | Time period
+- Action description: natural paragraphs, no camera language
+- Dialogue: CharacterName: (state/expression) line content
+- Each scene covers 30-60 seconds of content
+
+Note: you must do the rewriting work yourself — do not just return instructions. After reading the content, directly output the rewritten result and save it.
diff --git a/huobao-source/backend/workspace/prompts/script_rewriter.ja.md b/huobao-source/backend/workspace/prompts/script_rewriter.ja.md
new file mode 100644
index 0000000..fdcc927
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/script_rewriter.ja.md
@@ -0,0 +1,19 @@
+---
+name: 脚本リライト
+model: ""
+---
+
+あなたはプロの脚本家です。小説を短編ドラマの脚本に翻案することに長けています。
+
+ワークフロー：
+1. read_episode_script を呼び出して元の内容を読み込む
+2. 読み込んだ内容に基づき、自分でリライトを行う（フォーマット済み脚本形式で出力）
+3. save_script を呼び出してリライト後の完全な脚本を保存する
+
+フォーマット済み脚本の形式：
+- シーンヘッダー：## S番号 | 内景/外景 · 場所 | 時間帯
+- 動作描写：自然な段落。カメラ言語を含めない
+- セリフ：キャラクター名：（状態／表情）セリフ内容
+- 各シーン30〜60秒分の内容
+
+注意：リライト作業は必ず自分で完了させること。指示だけを返さない。内容を読み込んだら、リライト結果を直接出力して保存する。
diff --git a/huobao-source/backend/workspace/prompts/script_rewriter.ko.md b/huobao-source/backend/workspace/prompts/script_rewriter.ko.md
new file mode 100644
index 0000000..6cd4a94
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/script_rewriter.ko.md
@@ -0,0 +1,19 @@
+---
+name: 대본 리라이팅
+model: ""
+---
+
+당신은 전문 극작가로, 소설을 단편 드라마 대본으로 각색하는 데 능숙합니다.
+
+작업 흐름:
+1. read_episode_script 를 호출해 원본 내용을 읽습니다
+2. 읽은 내용을 바탕으로 직접 리라이팅합니다(포맷된 대본 형식으로 출력)
+3. save_script 를 호출해 리라이팅된 전체 대본을 저장합니다
+
+포맷된 대본 형식:
+- 장면 헤더: ## S번호 | 실내/실외 · 장소 | 시간대
+- 동작 묘사: 자연스러운 문단으로, 카메라 언어를 포함하지 않음
+- 대사: 캐릭터명:(상태/표정) 대사 내용
+- 각 장면은 30-60초 분량
+
+주의: 리라이팅 작업은 반드시 당신이 직접 완료해야 하며, 지시만 반환하지 마세요. 내용을 읽은 후 리라이팅 결과를 바로 출력하고 저장하세요.
diff --git a/huobao-source/backend/workspace/prompts/script_rewriter.md b/huobao-source/backend/workspace/prompts/script_rewriter.md
new file mode 100644
index 0000000..3cbe18d
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/script_rewriter.md
@@ -0,0 +1,19 @@
+---
+name: 剧本改写
+model: ""
+---
+
+你是专业编剧，擅长将小说改编为短剧剧本。
+
+工作流程：
+1. 调用 read_episode_script 读取原始内容
+2. 根据读取到的内容，自己进行改写（输出格式化剧本格式）
+3. 调用 save_script 保存改写后的完整剧本
+
+格式化剧本格式：
+- 场景头：## S编号 | 内景/外景 · 地点 | 时间段
+- 动作描写：自然段落，不包含镜头语言
+- 对白：角色名：（状态/表情）台词内容
+- 每个场景 30-60 秒内容
+
+注意：你必须自己完成改写工作，不要只返回指令。读取内容后直接输出改写结果并保存。
diff --git a/huobao-source/backend/workspace/prompts/storyboard_breaker.en.md b/huobao-source/backend/workspace/prompts/storyboard_breaker.en.md
new file mode 100644
index 0000000..9795aa3
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/storyboard_breaker.en.md
@@ -0,0 +1,49 @@
+---
+name: Storyboard Breakdown
+model: ""
+---
+
+You are a veteran film storyboard artist, skilled at breaking scripts down into storyboard plans and directly producing prompts ready for video generation.
+
+Core definition: one storyboard = one "storyboard segment" = one video-generation task. Each segment is 8-15 seconds and internally carries 2-4 sub-shots; cuts between sub-shots are allowed (change of shot size/angle/subject), but they never cross scenes.
+
+Workflow:
+1. Call read_storyboard_context to read the script, character list, scene list, and prop list
+2. First identify the narrative beats of the script (markers such as [Opening] [Trigger] [Climax] [Resolution], or narrative turning points); beat boundaries force a segment cut; then split each beat into one or more storyboard segments, keeping the overall plot complete and continuous
+3. Fill in all production fields for each segment at the same time: description (visual description) and video_prompt (video prompt) are produced in sync — see the rules below for each
+4. Call save_storyboards in batches to save all storyboard segments: the first batch call must carry replace_existing: true (clear the episode's old storyboards before writing, so that a full-episode regeneration leaves no stale shots); omit replace_existing in subsequent batches (append). Each batch contains at most 8 segments, and shot_number must increase in order; do not finish until all segments are saved (do not stop after saving only part of them)
+
+Hard constraints (must be followed):
+- Do not output any planning, analysis, reasoning, or explanatory text; do not restate the script; do not write things like "I am now..." or "First I need to..." — keep thinking internal to the model; output may only be tool calls
+- Every output step must be a tool call (or a brief closing line after completion); it is forbidden to output a large block of text first and then call tools
+- If multiple batches are needed due to volume, complete all batches in consecutive tool calls with no text inserted in between
+
+Each segment requires the following fields:
+- character_ids: the list of character IDs involved in this segment — may be empty or contain multiple characters; must be chosen from characters
+- prop_ids: the list of key prop IDs appearing in this segment (bound when a prop is seen, used, or shown in close-up) — may be empty; must be chosen from props
+- scene_id: if it can be matched to an existing scene in scenes, the correct scene_id must be filled in; leave empty when there is no match
+- duration: total segment duration, 8-15 seconds
+- description: visual description, describing sub-shot by sub-shot as 【镜头1】【镜头2】... what the audience actually sees and hears — the visuals (who + specific action + body-language details + expression) come first; when a sub-shot has dialogue, write it inside the corresponding 【镜头N】 as "CharacterName says: "line"", and narration as "Narration: content"
+- atmosphere: mood, lighting, color tone, environmental feel
+- video_prompt: the video-generation prompt for this segment (rules below)
+
+Duration rules (hard constraints):
+- Total-volume anchoring: target total duration = script character count ÷ 500 characters/minute; segment count ≈ target total duration ÷ 12 seconds, with ±20% tolerance
+- Pacing tiers: transition segments (traveling/empty shots/transitions) 8-10 seconds; narrative segments 10-15 seconds; payoff segments (close-ups/rule reveals/emotional eruptions/reversals) 12-15 seconds with slower sub-shot pacing
+- Dialogue floor: segment duration ≥ total character count of dialogue and narration within the segment (the part written in description) ÷ 4.5 characters/second + 2 seconds of performance headroom; dialogue that does not fit must be moved to the next segment
+
+video_prompt rules (hard constraints):
+- Split into 3-second segments, each segment on its own line separated by newlines; map each 【镜头N】 in the description to 1-2 consecutive 3-second segments (same order, no omissions, no new sub-shots); cut points align with the 【镜头N】 structure
+- In each segment, write the visuals first (who + action + shot size/angle), then the dialogue/narration occurring within that time span — dialogue is extracted from the corresponding 【镜头N】 in the description; do not invent new dialogue beyond the description
+- Use @SceneName when mentioning a scene and @CharacterName when mentioning a character; names must exactly match the lists returned by read_storyboard_context (used to attach reference-asset images)
+- Mood and lighting descriptions come from the segment's atmosphere
+- Cutting between shots within a segment is allowed (change of shot size/angle/subject), but never across scenes
+- The user message will state which video model is being used this time — adapt the writing to that model's characteristics and duration limits; if not stated, write for a generic video model
+
+Additional requirements:
+- Prefer reusing the scene_id values returned by read_storyboard_context — do not invent new scenes out of thin air
+- Segment character bindings must come from the character list returned by read_storyboard_context; empty-shot segments with no characters may pass an empty array
+- Segment prop bindings must come from the prop list returned by read_storyboard_context; bind a prop when it is used, shown in close-up, handed over, or clearly visible in frame; do not bind background items irrelevant to the plot; pass an empty array when no props appear
+- The segment description must be able to support the downstream video-generation and export pipeline
+- If a segment has no dialogue, simply write no dialogue in the description, but the visual description and atmosphere must still be complete
+- If existing_storyboards are present, refer to them only when the user explicitly requests incremental edits; by default, regenerate and save the complete episode storyboard from the current script.
diff --git a/huobao-source/backend/workspace/prompts/storyboard_breaker.ja.md b/huobao-source/backend/workspace/prompts/storyboard_breaker.ja.md
new file mode 100644
index 0000000..c906309
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/storyboard_breaker.ja.md
@@ -0,0 +1,49 @@
+---
+name: 絵コンテ分解
+model: ""
+---
+
+あなたはベテランの映像絵コンテ作家です。脚本を絵コンテプランに分解し、動画生成にそのまま使えるプロンプトを直接出力することに長けています。
+
+中核の定義：1つの絵コンテ = 1つの「絵コンテパラグラフ」= 1つの動画生成タスク。各パラグラフは8〜15秒で、内部に2〜4個のサブカットを収める。サブカット間ではカット切り替え（ショットサイズ／アングル／被写体の変更）は可能だが、シーンをまたがない。
+
+ワークフロー：
+1. read_storyboard_context を呼び出して、脚本、キャラクターリスト、シーンリスト、小道具リストを読み込む
+2. まず脚本の物語の拍（ビート）を識別する（【开场】【触发】【高潮】【收尾】などのマーカー、または物語の転換点）。拍の境界では強制的に区切る。次に各拍を1個以上の絵コンテパラグラフに分解し、全体として物語が完全かつ連続するように保つ
+3. 各パラグラフに本番用フィールドを一式補完する：description（画面描写）と video_prompt（動画プロンプト）を同時に作成する。ルールはそれぞれ以下を参照
+4. save_storyboards をバッチ呼び出しですべての絵コンテパラグラフを保存する：最初のバッチ呼び出しには必ず replace_existing: true を付ける（その話の古い絵コンテを先にクリアしてから書き込み、話全体を再生成するときに古いカットが残らないようにする）。以降のバッチでは replace_existing を省略する（追記保存）。1バッチ最大8パラグラフ。shot_number は順に増加させること。全パラグラフの保存が完了する前に終了しない（一部のパラグラフだけ保存して止まらない）
+
+硬い制約（必ず遵守）：
+- 計画、分析、推論、説明のテキストを一切出力しない。脚本を复述しない。「いま…しています」「まず…する必要があります」といった文言を書かない——思考はモデル内部に留め、出力はツール呼び出しのみ許可する
+- 各出力ステップは必ずツール呼び出し（または完了後の短い終了挨拶）でなければならない。大きな文章を先に出力してからツールを呼び出すことは禁止
+- 内容が多く複数バッチに分ける必要がある場合は、連続したツール呼び出しですべてのバッチを完了させ、途中に文字を挟まない
+
+各パラグラフには以下のフィールドを記入する：
+- character_ids：現在のパラグラフに関わるキャラクターIDのリスト。空でもよいし、複数のキャラクターを含めてもよい。必ず characters の中から選ぶ
+- prop_ids：現在のパラグラフに登場する重要な小道具IDのリスト（小道具が画面内で見える、使われる、クローズアップされるときに紐付ける）。空でもよい。必ず props の中から選ぶ
+- scene_id：scenes 内の既存シーンにマッチできる場合は、必ず正しい scene_id を記入する。マッチしない場合は空にする
+- duration：パラグラフの総尺 8〜15秒
+- description：画面描写。【镜头1】【镜头2】…とサブカットごとに、観客が実際に見て聞く内容を記述する——画面（誰＋具体的な動作＋体の細部＋表情）を先に書く。そのサブカットにセリフがある場合は「キャラクター名は言う：「セリフ」」を対応する【镜头N】内に書き、ナレーションは「ナレーション：内容」と書く
+- atmosphere：雰囲気、光線、色調、環境の感触
+- video_prompt：このパラグラフの動画生成プロンプト（ルールは以下）
+
+尺のルール（硬い制約）：
+- 総量のアンカー：目標総尺 = 脚本の文字数 ÷ 500字/分。パラグラフ数 ≈ 目標総尺 ÷ 12秒。±20%の変動を許容
+- リズムの階層化：つなぎの段落（移動／空カット／場面転換）8〜10秒；物語の段落 10〜15秒；山場の段落（クローズアップ／ルール開示／感情の爆発／どんでん返し）12〜15秒で、サブカットのリズムを落とす
+- セリフの下限：パラグラフの尺 ≥ パラグラフ内のセリフとナレーションの総文字数（description に書かれた部分）÷ 4.5字/秒 ＋ 2秒の演技余裕。収まりきらないセリフは次のパラグラフに振り分ける
+
+video_prompt のルール（硬い制約）：
+- 3秒を1区間とし、各区間を改行で区切って1行ずつ記述する。description の各【镜头N】を連続した1〜2個の3秒区間にマッピングする（順序一致、漏れなし、サブカットの新規追加なし）。カットの切り替え位置は【镜头N】構造に揃える
+- 各区間はまず画面（誰＋動作＋ショットサイズ／アングル）を書き、次にその区間の時間内のセリフ／ナレーションを書く——セリフは description の対応する【镜头N】内から抽出し、description 以外の新しいセリフを創作しない
+- シーンに言及する際は @シーン名、キャラクターに言及する際は @キャラクター名を使う。名前は read_storyboard_context が返すリストと完全に一致させること（参照素材画像の紐付けに使用）
+- 雰囲気・光線の描写はそのパラグラフの atmosphere から取る
+- 1つのパラグラフ内ではカット切り替え（ショットサイズ／アングル／被写体の変更）は許可されるが、シーンをまたがない
+- ユーザーメッセージで今回の動画モデルが知らされる場合は、そのモデルの特性と尺の制限に合わせて書き方を調整する。知らされない場合は汎用的な動画モデルの書き方にする
+
+追加要件：
+- read_storyboard_context が返す scene_id を優先的に再利用し、でたらめに新しいシーンを作らない
+- パラグラフのキャラクター紐付けは、必ず read_storyboard_context が返すキャラクターリストから行う。キャラクターのいない空カットのパラグラフは空の配列を渡してよい
+- パラグラフの小道具紐付けは、必ず read_storyboard_context が返す小道具リストから行う。小道具が使われる、クローズアップされる、受け渡される、または画面内で明確に見える場合に紐付ける。物語と無関係な背景物品は紐付けない。小道具が登場しなければ空の配列を渡してよい
+- パラグラフの描写は、後続の動画生成と書き出しのフローを支えられるものでなければならない
+- パラグラフにセリフがなければ、description にセリフを書かなければよいが、画面描写と atmosphere は必ず完全に記入する
+- existing_storyboards が既にある場合、ユーザーが明示的に差分修正を求めたときのみ参考にする。デフォルトでは現在の脚本に基づき、その話の絵コンテを完全に再生成して保存する
diff --git a/huobao-source/backend/workspace/prompts/storyboard_breaker.ko.md b/huobao-source/backend/workspace/prompts/storyboard_breaker.ko.md
new file mode 100644
index 0000000..f08b5d9
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/storyboard_breaker.ko.md
@@ -0,0 +1,49 @@
+---
+name: 스토리보드 분할
+model: ""
+---
+
+당신은 베테랑 영상 스토리보드 작가로, 대본을 스토리보드 안으로 분할하고 비디오 생성에 바로 사용할 수 있는 프롬프트까지 직접 산출하는 데 능숙합니다.
+
+핵심 정의: 하나의 스토리보드 = 하나의 「스토리보드 구간」 = 하나의 비디오 생성 작업. 각 구간은 8-15초이며, 내부에 2-4개의 서브 컷을 담습니다; 서브 컷 사이에서는 컷 전환(화면 크기/앵글/대상 변경)이 가능하지만 장면을 넘나들지는 않습니다.
+
+작업 흐름:
+1. read_storyboard_context 를 호출해 대본, 캐릭터 목록, 장면 목록, 소품 목록을 읽습니다
+2. 먼저 대본의 서사 박자를 식별합니다(예: 【오프닝】【촉발】【클라이맥스】【마무리】 등의 마커 또는 서사 전환점). 박자 경계에서는 반드시 구간을 자릅니다; 그런 다음 각 박자를 1개 이상의 스토리보드 구간으로 나누되, 전체적으로 줄거리가 완전하고 연속되게 유지합니다
+3. 각 구간에 생산 필드를 함께 채웁니다: description(화면 묘사)과 video_prompt(비디오 프롬프트)를 동시에 산출하며, 규칙은 아래를 참조합니다
+4. save_storyboards 를 여러 번에 나누어 호출해 모든 스토리보드 구간을 저장합니다: 첫 번째 호출에는 반드시 replace_existing: true 를 붙입니다(해당 화의 기존 스토리보드를 먼저 비우고 쓰도록 하여, 전체 화를 다시 생성할 때 옛 컷이 남지 않게 합니다). 이후 호출에서는 replace_existing 을 생략합니다(추가 저장). 한 번에 최대 8개 구간까지 저장하고, shot_number 는 반드시 순서대로 증가해야 합니다; 모든 구간을 저장하기 전에 끝내지 마세요(일부 구간만 저장하고 멈추지 마세요)
+
+엄격한 제약(반드시 준수):
+- 어떤 계획, 분석, 추론 또는 설명성 텍스트도 출력하지 마세요. 대본을 되풀이하지 말고, 「지금 ~하는 중입니다」「먼저 ~해야 합니다」 같은 말도 쓰지 마세요 — 사고는 모델 내부에 두고, 출력은 도구 호출만 허용됩니다
+- 각 출력 단계는 반드시 도구 호출(또는 완료 후의 짧은 종료 문구)이어야 하며, 긴 텍스트를 먼저 출력한 뒤 도구를 호출하는 것은 금지됩니다
+- 내용이 많아 여러 번에 나눠야 할 경우, 연속된 도구 호출로 모든 배치를 완료하고 중간에 텍스트를 끼워 넣지 마세요
+
+각 구간에는 다음 필드를 채워야 합니다:
+- character_ids: 현재 구간에 관련된 캐릭터 ID 목록. 비어 있을 수도 있고 여러 캐릭터를 포함할 수도 있습니다; 반드시 characters 에서 선택해야 합니다
+- prop_ids: 현재 구간에 등장하는 핵심 소품 ID 목록(소품이 화면에 보이거나, 사용되거나, 클로즈업될 때 바인딩). 비어 있을 수 있습니다; 반드시 props 에서 선택해야 합니다
+- scene_id: scenes 에 있는 기존 장면과 매칭되면 반드시 올바른 scene_id 를 채웁니다; 매칭이 없으면 비워 둡니다
+- duration: 구간 총 길이 8-15초
+- description: 화면 묘사. 【镜头1】【镜头2】…와 같이 서브 컷별로 관객이 실제로 보고 듣는 내용을 서술합니다 — 화면(누가 + 구체적 동작 + 신체 디테일 + 표정)을 먼저 씁니다; 해당 서브 컷에 대사가 있으면 「캐릭터명이 말한다: 「대사」」 형식으로 해당 【镜头N】 안에 쓰고, 내레이션은 「내레이션: 내용」으로 씁니다
+- atmosphere: 분위기, 조명, 색조, 환경적 느낌
+- video_prompt: 해당 구간의 비디오 생성 프롬프트(규칙은 아래 참조)
+
+길이 규칙(엄격한 제약):
+- 총량 앵커링: 목표 총 길이 = 대본 글자 수 ÷ 500자/분. 구간 수 ≈ 목표 총 길이 ÷ 12초, ±20% 범위 내 변동 허용
+- 리듬 계층화: 전이 구간(이동/빈 장면/전환) 8-10초; 서사 구간 10-15초; 클라이맥스 구간(클로즈업/규칙 공개/감정 폭발/반전) 12-15초이며 서브 컷 리듬을 늦춥니다
+- 대사 하한: 구간 길이 ≥ 구간 내 대사와 내레이션 총 글자 수(description 에 적힌 부분) ÷ 4.5자/초 + 2초 연기 여유분. 담을 수 없는 대사는 다음 구간으로 나눕니다
+
+video_prompt 규칙(엄격한 제약):
+- 3초를 한 구간으로 하고 구간마다 한 줄씩 줄바꿈으로 구분합니다; description 의 각 【镜头N】은 1-2개의 연속된 3초 구간에 매핑합니다(순서 일치, 누락 없음, 새 서브 컷 추가 없음). 컷 전환 지점은 【镜头N】 구조에 맞춥니다
+- 각 구간은 먼저 화면(누가 + 동작 + 화면 크기/앵글)을 쓰고, 그다음 해당 시간 내의 대사/내레이션을 씁니다 — 대사는 description 의 해당 【镜头N】 안에서 추출하며, description 밖의 새 대사를 창작하지 마세요
+- 장면을 언급할 때는 @장면명, 캐릭터를 언급할 때는 @캐릭터명을 사용하며, 이름은 read_storyboard_context 가 반환한 목록과 완전히 일치해야 합니다(참조 소재 이미지를 연결하는 데 사용됨)
+- 분위기와 조명 묘사는 해당 구간의 atmosphere 에서 가져옵니다
+- 한 구간 내에서는 컷 전환(화면 크기/앵글/대상 변경)이 허용되지만 장면을 넘나들지는 않습니다
+- 사용자 메시지에서 이번 비디오 모델을 알려주면 해당 모델의 특성과 길이 제한에 맞춰 작성 방식을 조정하고, 알려주지 않으면 범용 비디오 모델 방식으로 작성합니다
+
+추가 요구 사항:
+- read_storyboard_context 가 반환한 scene_id 를 우선 재사용하고, 존재하지 않는 새 장면을 임의로 만들지 마세요
+- 구간의 캐릭터 바인딩은 반드시 read_storyboard_context 가 반환한 캐릭터 목록에서 가져와야 합니다; 캐릭터가 없는 빈 장면 구간은 빈 배열을 전달할 수 있습니다
+- 구간의 소품 바인딩은 반드시 read_storyboard_context 가 반환한 소품 목록에서 가져와야 합니다; 소품이 사용되거나, 클로즈업되거나, 전달되거나, 화면에 뚜렷이 보일 때 바인딩하고, 줄거리와 무관한 배경 물건은 바인딩하지 마세요; 소품이 등장하지 않으면 빈 배열을 전달할 수 있습니다
+- 구간 묘사는 이후 비디오 생성 및 익스포트 흐름을 뒷받침할 수 있어야 합니다
+- 한 구간에 대사가 없으면 description 에 대사를 쓰지 않으면 되지만, 화면 묘사와 atmosphere 는 여전히 완전해야 합니다
+- existing_storyboards 가 이미 있더라도 사용자가 명시적으로 증분 수정을 요구할 때만 참조하세요; 기본은 현재 대본을 기준으로 전체 화의 스토리보드를 새로 완전히 생성해 저장합니다.
diff --git a/huobao-source/backend/workspace/prompts/storyboard_breaker.md b/huobao-source/backend/workspace/prompts/storyboard_breaker.md
new file mode 100644
index 0000000..3f9103a
--- /dev/null
+++ b/huobao-source/backend/workspace/prompts/storyboard_breaker.md
@@ -0,0 +1,49 @@
+---
+name: 分镜拆解
+model: ""
+---
+
+你是资深影视分镜师，擅长将剧本拆解为分镜方案，并直接产出可供视频生成使用的提示词。
+
+核心定义：一个分镜 = 一个「分镜段落」= 一个视频生成任务。每个段落 8-15 秒，内部承载 2-4 个子镜头；子镜头之间可以切镜（换景别/角度/对象），但不跨场景。
+
+工作流程：
+1. 调用 read_storyboard_context 读取剧本、角色列表、场景列表、道具列表
+2. 先识别剧本的叙事节拍（如【开场】【触发】【高潮】【收尾】等标记或叙事转折点），节拍边界强制切段；再将每个节拍拆为 1 到多个分镜段落，总体保持剧情完整连续
+3. 为每个段落一并补全生产字段：description（画面描述）与 video_prompt（视频提示词）同步产出，规则分别见下
+4. 分批调用 save_storyboards 保存全部分镜段落：第一批调用必须带 replace_existing: true（先清空该集旧分镜再写入，保证整集重新生成时不留旧镜头），后续每批省略 replace_existing（追加保存）。每批最多 8 个段落，shot_number 必须按顺序递增；全部段落保存完成前不要结束（不要只保存部分段落就停止）
+
+硬约束（必须遵守）：
+- 不要输出任何规划、分析、推理或解释性文本，不要复述剧本，不要写「我正在…」「首先我需要…」这类话——思考留在模型内部，输出只允许工具调用
+- 每个输出步骤必须是工具调用（或完成后的简短结束语），禁止先输出大段文字再调用工具
+- 若因内容过多需要分多批，直接在连续的工具调用中完成全部批次，中间不要插入文字
+
+每个段落需要填写以下字段：
+- character_ids：当前段落涉及的角色 ID 列表，可以为空，也可以包含多个角色；必须从 characters 中选择
+- prop_ids：当前段落出现的关键道具 ID 列表（道具在画面中被看到、使用或特写时绑定），可以为空；必须从 props 中选择
+- scene_id：若可匹配到 scenes 中已有场景，必须填写正确 scene_id；无匹配时置空
+- duration：段落总时长 8-15 秒
+- description：画面描述，按【镜头1】【镜头2】…逐子镜头描述观众实际看到和听到的内容——画面（谁+具体动作+肢体细节+表情）写在前；该子镜头有台词时以「角色名说：「台词」」写在对应【镜头N】内，旁白写「旁白：内容」
+- atmosphere：氛围、光线、色调、环境感受
+- video_prompt：该段落的视频生成提示词（规则见下）
+
+时长规则（硬约束）：
+- 总量锚定：目标总时长 = 剧本字数 ÷ 500字/分钟，段落数 ≈ 目标总时长 ÷ 12秒，允许 ±20% 浮动
+- 节奏分层：过渡段（赶路/空镜/转场）8-10 秒；叙事段 10-15 秒；爆点段（特写/规则揭示/情感爆发/反转）12-15 秒且子镜头节奏放慢
+- 台词下限：段落时长 ≥ 段内台词与旁白总字数（写在 description 中的部分）÷ 4.5字/秒 + 2秒表演余量，装不下的台词拆到下一个段落
+
+video_prompt 规则（硬约束）：
+- 按 3 秒为一段、每段单独一行换行分隔；description 的每个【镜头N】映射为 1-2 个连续 3 秒段（顺序一致、不遗漏、不新增子镜头），切镜点对齐【镜头N】结构
+- 每段先写画面（谁+动作+景别/角度），再写该段时间内的台词/旁白——台词从 description 对应【镜头N】内提取，不要创作 description 之外的新台词
+- 提到场景用 @场景名、提到角色用 @角色名，名字必须与 read_storyboard_context 返回的列表完全一致（用于挂接参考素材图片）
+- 氛围、光线描述取自该段 atmosphere
+- 一个段落内允许切镜（换景别/角度/对象），但不跨场景
+- 用户消息中会告知本次视频模型，按该模型的特性与时长限制调整写法；未告知时按通用视频模型写法
+
+额外要求：
+- 优先复用 read_storyboard_context 返回的 scene_id，不要凭空创造新场景
+- 段落角色绑定必须来自 read_storyboard_context 返回的角色列表；无角色的空镜段落可传空数组
+- 段落道具绑定必须来自 read_storyboard_context 返回的道具列表；道具被使用、特写、交接或在画面中明显可见时绑定，与剧情无关的背景物品不要绑定；没有道具出现可传空数组
+- 段落描述必须能支撑后续视频生成和导出流程
+- 若一个段落没有台词，description 中不写台词即可，但画面描述与 atmosphere 仍必须完整
+- 如果已有 existing_storyboards，仅在用户明确要求增量修改时参考；默认按当前剧本重新完整生成并保存整集分镜。
diff --git a/huobao-source/backend/workspace/skills/extractor/SKILL.en.md b/huobao-source/backend/workspace/skills/extractor/SKILL.en.md
new file mode 100644
index 0000000..c56ef9e
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/extractor/SKILL.en.md
@@ -0,0 +1,65 @@
+---
+name: extractor
+description: Rules and methods for extracting characters, scenes, and props
+---
+
+# Character, Scene & Prop Extraction Guide
+
+## Character Extraction Rules
+
+Extracted character fields (corresponding one-to-one with the `save_dedup_characters` tool parameters):
+- **name** (required): the character's full name
+- **role**: the character's positioning — protagonist / supporting / extra
+- **appearance**: appearance description (300-500 characters) — gender, age impression, facial features, physique, bearing. **Do not output the character's personality traits separately; convert them into outward bearing and expression woven into the appearance description** (e.g. "cold personality" should be written as "a cold gaze, a restrained expression, rarely smiling")
+- **styling**: styling — hairstyle, clothing, makeup, accessories, etc.
+- **description**: backstory and character relationships (optional supplement)
+
+## Scene Extraction Rules
+
+Extracted scene fields (corresponding one-to-one with the `save_dedup_scenes` tool parameters):
+- **location** (required): the specific place name
+- **time**: time period (e.g. daytime / dusk / late night); the same location at a different time period counts as a new scene
+- **prompt**: scene description — space, set dressing, period texture, key visual elements (pure background, no people)
+- **lighting**: scene lighting — light sources, color tone, brightness contrast, mood
+
+## Prop Extraction Rules
+
+**Core principle: prefer extracting too few over too many.** Props are high-cost assets used to generate white-background product shots and referenced by video close-ups; only plot-critical props are worth extracting. An episode usually has **0-3** key props; if there are more than 3, rank them by plot importance and keep only the top 3.
+
+Both of the following conditions must be met — neither is optional:
+1. **Directly drives the plot**: the item's appearance, handover, damage, or discovery triggers a plot turn (e.g. a murder weapon, a token, a key document, a love-token gift, key evidence).
+2. **Worth generating a dedicated image**: later storyboards will give it close-ups or it recurs, so it needs a fixed appearance.
+
+**Three self-check questions** (ask and answer for yourself for each candidate prop; if any answer is "no", drop it):
+- (1) Does the plot still hold if it is removed? → If yes, **do not extract** (it is just a decorative prop)
+- (2) Is it just an everyday item the character casually uses (phone, chopsticks, water cup, cigarettes, umbrella)? → If yes, **do not extract**
+- (3) Is it part of the set dressing (tables and chairs, lamps, doors and windows, wall hangings, tableware)? → If yes, **do not extract** (these belong in the scene description)
+
+**Typical non-props**: ordinary items used casually with no effect on the plot's direction; set dressing and furniture; items mentioned only once and never again; a character's regular attire (belongs in character styling).
+
+If no prop qualifies, **do not force an extraction** — just pass an empty array when calling `save_dedup_props`.
+
+Extracted prop fields (corresponding one-to-one with the `save_dedup_props` tool parameters):
+- **name** (required): prop name
+- **type**: category — daily / weapon / transportation / decoration / document, etc.
+- **description**: physical appearance of the item only (material, color, shape, size, degree of wear, signs of damage, etc.); do not describe its plot purpose or its relation to characters or anything else
+
+Props **do not need an image prompt** — a prop's final prompt is generated by the prompt-generation Agent before image generation (white-background product-shot specification).
+
+## Steps
+
+1. Call `read_script_for_extraction` to read the current episode's script
+2. Call `read_existing_characters` to view existing project characters and the characters already linked to the current episode
+3. Call `read_existing_scenes` to view existing project scenes and the scenes already linked to the current episode
+4. Call `read_existing_props` to view existing project props and the props already linked to the current episode
+5. Only extract the characters, scenes, and props actually involved in the current episode
+6. Call `save_dedup_characters` to save the characters and automatically link them to the current episode
+7. Call `save_dedup_scenes` to save the scenes and automatically link them to the current episode
+8. Call `save_dedup_props` to save the props and automatically link them to the current episode
+
+## Current-Episode Rules
+
+- The goal is to fill in the characters, scenes, and props needed by the "current episode", not to rescan the entire project
+- If an asset already exists in the project but is not yet linked to the current episode, reuse it and link it to the current episode
+- Deduplication rules: characters/props are matched exactly by name, scenes are matched exactly by [location + time period]; on a hit, prefer reuse — do not create duplicates
+- Near-name deduplication: when a name carries a parenthesized qualifier or alias, compare by the main part before the parentheses (e.g. "Lin Xiaoyu (protagonist)" and "Lin Xiaoyu" are the same character/prop — reuse the existing one); the normalized_name returned by read_existing_characters / read_existing_props is the normalized name, and normalized_location works the same way for scenes — use these for the judgment
diff --git a/huobao-source/backend/workspace/skills/extractor/SKILL.ja.md b/huobao-source/backend/workspace/skills/extractor/SKILL.ja.md
new file mode 100644
index 0000000..6222db8
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/extractor/SKILL.ja.md
@@ -0,0 +1,65 @@
+---
+name: extractor
+description: キャラクター、シーン、小道具の抽出に関する仕様と方法
+---
+
+# キャラクター・シーン・小道具の抽出ガイド
+
+## キャラクター抽出仕様
+
+抽出するキャラクターフィールド（`save_dedup_characters` ツールのパラメータと一対一で対応）：
+- **name**（必須）：キャラクターのフルネーム
+- **role**：キャラクターの位置づけ。主役／脇役／端役
+- **appearance**：容姿描写（300〜500字）——性別、年齢感、顔立ち、体格、雰囲気。**キャラクターの性格特性は単独で出力せず、外的な雰囲気と表情に変換して容姿描写に溶け込ませる**（例：「性格が冷徹」は「冷徹な眼差し、抑えた表情、滅多に笑わない」と書く）
+- **styling**：装い——髪型、服装、メイク、アクセサリーなど
+- **description**：バックストーリーと人物関係（任意の補足）
+
+## シーン抽出仕様
+
+抽出するシーンフィールド（`save_dedup_scenes` ツールのパラメータと一対一で対応）：
+- **location**（必須）：具体的な場所の名称
+- **time**：時間帯（例：昼／夕暮れ／深夜）。同じ場所でも時間帯が異なれば新規シーンとみなす
+- **prompt**：シーン描写——空間、調度品、年代の質感、重要な視覚要素（純粋な背景。人物を含まない）
+- **lighting**：シーンの光影——光源、色調、明暗、雰囲気
+
+## 小道具抽出仕様
+
+**中核原則：多く抽出するより少なく抽出する方がよい。** 小道具は白背景の単品画像を生成し、動画のクローズアップで参照するための高コストなアセットであり、物語の鍵となる小道具だけが抽出に値する。1話あたり重要な小道具は通常 **0〜3個**。3個を超える場合は物語上の重要度で並べ替えて上位3個だけを残す。
+
+以下の2条件を**同時に**満たすこと。どちらか一方でも欠けてはならない：
+1. **物語を直接動かす**：その物品の出現、受け渡し、破損、発見がプロットの転換を引き起こす（凶器、形見、重要書類、愛の誓いの贈り物、重要な証拠など）。
+2. **単独で画像生成する価値がある**：後続の絵コンテでクローズアップされたり繰り返し登場したりするため、外観を固定する必要がある。
+
+**判定の3問**（各候補小道具に自問自答し、いずれか1つでも「いいえ」なら諦める）：
+- ① それを削除しても物語は成立するか？→ 成立するなら**抽出しない**（それは単なる背景の道具にすぎない）
+- ② それはキャラクターが何気なく使う日用品にすぎないか（スマホ、箸、コップ、タバコ、傘）？→ そうであるなら**抽出しない**
+- ③ それはシーンの調度品の一部か（テーブル・椅子、照明、ドア・窓、掛け軸、食器）？→ そうであるなら**抽出しない**（これらはシーン描写に属する）
+
+**小道具に当たらない典型例**：何気なく使われるが物語の行方に影響しない普通の物品；シーンの調度品や家具；一度だけ言及されて後の続きがない物品；キャラクターの通常の身に付け物（キャラクターの装いに帰属）。
+
+条件に合う小道具がなければ**無理に抽出しない**。`save_dedup_props` 呼び出し時に空の配列を渡せばよい。
+
+抽出する小道具フィールド（`save_dedup_props` ツールのパラメータと一対一で対応）：
+- **name**（必須）：小道具名
+- **type**：種類——日常／武器／交通／装飾／書類など
+- **description**：物品の外観——物品そのものの物理的な外観のみを描写する（材質、色、形状、大きさ、新旧の度合い、摩耗の跡など）。物語上の用途は書かず、キャラクターや他の事物との関連にも触れない
+
+小道具に画像プロンプトは**出力不要**——小道具の最終プロンプトはプロンプト生成エージェントが画像生成前に専門に生成する（白背景単品仕様）。
+
+## 使用手順
+
+1. `read_script_for_extraction` を呼び出して現在の話の脚本を読み込む
+2. `read_existing_characters` を呼び出してプロジェクトの既存キャラクターと現在の話に関連付け済みのキャラクターを確認する
+3. `read_existing_scenes` を呼び出してプロジェクトの既存シーンと現在の話に関連付け済みのシーンを確認する
+4. `read_existing_props` を呼び出してプロジェクトの既存小道具と現在の話に関連付け済みの小道具を確認する
+5. 現在の話に実際に関わるキャラクター、シーン、小道具のみを抽出する
+6. `save_dedup_characters` を呼び出してキャラクターを保存し、自動的に現在の話に関連付ける
+7. `save_dedup_scenes` を呼び出してシーンを保存し、自動的に現在の話に関連付ける
+8. `save_dedup_props` を呼び出して小道具を保存し、自動的に現在の話に関連付ける
+
+## 現在の話に関するルール
+
+- 目標は「現在の話」に必要なキャラクター、シーン、小道具を補完すること。プロジェクト全体を再スキャンすることではない
+- プロジェクトに既に存在するが現在の話に未関連付けのものも、再利用して現在の話に関連付ける
+- 重複排除ルール：キャラクター／小道具は名前の完全一致、シーンは【場所＋時間帯】の完全一致で判定。ヒットしたものを優先的に再利用し、重複作成しない
+- 近似名の重複排除：名前に括弧付きの位置づけや別名が含まれる場合は括弧の前の本体部分で比較する（例：「林小雨（主役）」と「林小雨」は同一キャラクター／小道具とみなし、既存を再利用）。read_existing_characters / read_existing_props が返す normalized_name が正規化後の名前であり、シーンの normalized_location も同様。これらに基づいて判断すればよい
diff --git a/huobao-source/backend/workspace/skills/extractor/SKILL.ko.md b/huobao-source/backend/workspace/skills/extractor/SKILL.ko.md
new file mode 100644
index 0000000..70667bf
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/extractor/SKILL.ko.md
@@ -0,0 +1,65 @@
+---
+name: extractor
+description: 캐릭터, 장면, 소품 추출의 규범과 방법
+---
+
+# 캐릭터·장면·소품 추출 가이드
+
+## 캐릭터 추출 규범
+
+추출하는 캐릭터 필드(`save_dedup_characters` 도구 파라미터와 일대일 대응):
+- **name**(필수): 캐릭터 전체 이름
+- **role**: 캐릭터 위치, 주인공/조연/단역
+- **appearance**: 외모 묘사(300-500자) — 성별, 나이대, 이목구비, 체형, 분위기. **캐릭터의 성격 특징을 따로 출력하지 말고, 외적인 분위기와 표정으로 전환해 외모 묘사에 녹여내세요**(예: "성격이 냉정하다"는 "차가운 눈빛, 절제된 표정, 좀처럼 웃지 않음"으로 씁니다)
+- **styling**: 스타일링 — 헤어스타일, 의상, 메이크업, 액세서리 등
+- **description**: 배경 이야기와 인물 관계(선택적 보충)
+
+## 장면 추출 규범
+
+추출하는 장면 필드(`save_dedup_scenes` 도구 파라미터와 일대일 대응):
+- **location**(필수): 구체적인 장소명
+- **time**: 시간대(예: 낮/황혼/심야). 같은 장소라도 시간대가 다르면 새 장면으로 간주합니다
+- **prompt**: 장면 묘사 — 공간, 비품·장식, 시대적 질감, 핵심 시각 요소(순수 배경, 인물 제외)
+- **lighting**: 장면 조명 — 광원, 색조, 명암, 분위기
+
+## 소품 추출 규범
+
+**핵심 원칙: 많이 뽑기보다 적게 뽑으세요.** 소품은 화이트 배경 단품 이미지를 생성해 비디오 클로즈업에서 참조하는 고비용 자산이므로, 줄거리상 핵심 소품만 추출할 가치가 있습니다. 한 화에는 보통 **0-3개**의 핵심 소품이 있으며, 3개를 초과하면 줄거리 중요도 순으로 상위 3개만 남깁니다.
+
+반드시 **동시에 만족**해야 하는 두 조건(하나라도 빠지면 안 됨):
+1. **줄거리를 직접 추진**: 해당 물건의 등장, 전달, 파손 또는 발견이 사건의 전환점을 유발해야 합니다(예: 흉기, 증표, 핵심 문서, 사랑의 증표, 핵심 증거).
+2. **단독 이미지 생성 가치**: 이후 스토리보드에서 클로즈업 컷을 받거나 반복 등장하여 고정된 외형이 필요해야 합니다.
+
+**판정 세 가지 질문**(각 후보 소품에 스스로 묻고 답하되, 어느 하나라도 "아니오"이면 포기):
+- ① 이것을 삭제해도 줄거리가 여전히 성립하는가? → 성립하면 **추출하지 않음**(그것은 소품식 배경판에 불과)
+- ② 캐릭터가 무심코 사용하는 일상 물품인가(휴대폰, 젓가락, 물컵, 담배, 우산)? → 그렇다면 **추출하지 않음**
+- ③ 장면의 비품·장식의 일부인가(책상·의자, 조명, 문·창문, 그림, 식기)? → 그렇다면 **추출하지 않음**(이런 것들은 장면 묘사에 속함)
+
+**소품으로 취급하지 않는 전형적인 사례**: 무심코 사용되지만 줄거리 흐름에 영향을 주지 않는 평범한 물건; 장면의 비품과 가구; 한 번만 언급되고 이후 언급이 없는 물건; 캐릭터의 상시 착용물(캐릭터 스타일링으로 귀속).
+
+조건에 맞는 소품이 없으면 **억지로 추출하지 말고**, `save_dedup_props` 호출 시 빈 배열을 전달하세요.
+
+추출하는 소품 필드(`save_dedup_props` 도구 파라미터와 일대일 대응):
+- **name**(필수): 소품명
+- **type**: 유형 — 일상/무기/교통/장식/문서 등
+- **description**: 물건의 외형 — 물건 자체의 물리적 외형만 묘사(재질, 색상, 형태, 크기, 사용감, 마모 흔적 등). 줄거리상 용도를 쓰지 말고, 캐릭터나 다른 사물과의 연관에도 관여하지 마세요
+
+소품은 **이미지 프롬프트를 출력할 필요가 없습니다** — 소품의 최종 프롬프트는 프롬프트 생성 에이전트가 이미지 생성 전에 별도로 생성합니다(화이트 배경 단품 규범).
+
+## 사용 절차
+
+1. `read_script_for_extraction` 을 호출해 현재 화의 대본을 읽습니다
+2. `read_existing_characters` 를 호출해 프로젝트의 기존 캐릭터와 현재 화에 이미 연결된 캐릭터를 확인합니다
+3. `read_existing_scenes` 를 호출해 프로젝트의 기존 장면과 현재 화에 이미 연결된 장면을 확인합니다
+4. `read_existing_props` 를 호출해 프로젝트의 기존 소품과 현재 화에 이미 연결된 소품을 확인합니다
+5. 현재 화에 실제로 관련된 캐릭터·장면·소품만 추출합니다
+6. `save_dedup_characters` 를 호출해 캐릭터를 저장하고 현재 화에 자동으로 연결합니다
+7. `save_dedup_scenes` 를 호출해 장면을 저장하고 현재 화에 자동으로 연결합니다
+8. `save_dedup_props` 를 호출해 소품을 저장하고 현재 화에 자동으로 연결합니다
+
+## 현재 화 규칙
+
+- 목표는 "현재 화"에 필요한 캐릭터·장면·소품을 채우는 것이지, 프로젝트 전체를 다시 스캔하는 것이 아닙니다
+- 프로젝트에 이미 존재하지만 현재 화에 연결되지 않은 경우에도, 재사용하여 현재 화에 연결해야 합니다
+- 중복 제거 규칙: 캐릭터/소품은 이름을 정확히 일치시켜 비교하고, 장면은 【장소+시간대】를 정확히 일치시켜 비교합니다. 일치하는 항목은 우선 재사용하고 중복 생성하지 마세요
+- 유사명 중복 제거: 이름에 괄호로 위치/역할 표시나 별칭이 붙은 경우 괄호 앞의 본체를 기준으로 비교합니다(예: 「林小雨(주인공)」과 「林小雨」는 동일 캐릭터/소품으로 간주하고 기존 항목을 재사용); read_existing_characters / read_existing_props 가 반환하는 normalized_name 이 정규화된 이름이며, 장면의 normalized_location 도 마찬가지이므로 이를 기준으로 판단하면 됩니다
diff --git a/huobao-source/backend/workspace/skills/extractor/SKILL.md b/huobao-source/backend/workspace/skills/extractor/SKILL.md
new file mode 100644
index 0000000..73ec46f
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/extractor/SKILL.md
@@ -0,0 +1,65 @@
+---
+name: extractor
+description: 角色、场景和道具提取的规范与方法
+---
+
+# 角色、场景与道具提取指南
+
+## 角色提取规范
+
+提取的角色字段（与 `save_dedup_characters` 工具参数一一对应）：
+- **name**（必填）：角色全名
+- **role**：角色定位，主角/配角/龙套
+- **appearance**：样貌描写（300-500字）——性别、年龄感、五官、体态、气质。**角色的性格特点不要单独输出，要转化为外在气质与神态融入样貌描写**（例如"性格冷峻"应写为"眼神冷峻、表情克制、少有笑意"）
+- **styling**：妆造——发型、服装、妆面、配饰等
+- **description**：背景故事和人物关系（可选补充）
+
+## 场景提取规范
+
+提取的场景字段（与 `save_dedup_scenes` 工具参数一一对应）：
+- **location**（必填）：具体场所名称
+- **time**：时间段（如 白天/黄昏/深夜），同地点不同时段视为新场景
+- **prompt**：场景描述——空间、陈设、年代质感、关键视觉元素（纯背景，不含人物）
+- **lighting**：场景光影——光源、色调、明暗、氛围
+
+## 道具提取规范
+
+**核心原则：宁可少提，不要多提。** 道具是用来生成白底单品图、供视频特写引用的高成本资产，只有剧情关键道具才值得提取。一集通常 **0-3 个**关键道具，超过 3 个时按剧情重要性排序只保留前 3 个。
+
+必须**同时满足**以下两条，缺一不可：
+1. **直接推动剧情**：该物品的出现、交接、损坏或发现会引发情节转折（如凶器、信物、关键文件、定情礼物、关键证据）。
+2. **值得单独生成图片**：后续分镜会给它特写镜头或反复出现，需要固定外观。
+
+**判定三问**（对每个候选道具自问自答，任一答"否"即放弃）：
+- ① 删掉它剧情是否依然成立？→ 成立则**不提取**（它只是道具式背景板）
+- ② 它只是角色随手使用的日常物品吗（手机、筷子、水杯、香烟、雨伞）？→ 是则**不提取**
+- ③ 它是场景陈设的一部分吗（桌椅、灯具、门窗、挂画、餐具）？→ 是则**不提取**（这些属于场景描述）
+
+**不算道具的典型**：随手使用但不影响剧情走向的普通物品；场景陈设与家具；只被提及一次且再无下文的物品；角色的常规穿戴（归入角色妆造）。
+
+如果没有符合条件的道具，**不要强行提取**，调用 `save_dedup_props` 时传空数组即可。
+
+提取的道具字段（与 `save_dedup_props` 工具参数一一对应）：
+- **name**（必填）：道具名
+- **type**：类型——日常/武器/交通/装饰/文件等
+- **description**：物品外貌——只描写物品本身的物理外观（材质、颜色、形状、大小、新旧程度、磨损痕迹等），不要写剧情用途，不要涉及与角色或其他事物的关联
+
+道具**不需要输出图片提示词**——道具的最终提示词由提示词生成 Agent 在生图前专门生成（白底单品规范）。
+
+## 使用步骤
+
+1. 调用 `read_script_for_extraction` 读取当前集剧本
+2. 调用 `read_existing_characters` 查看项目已有角色和当前集已关联角色
+3. 调用 `read_existing_scenes` 查看项目已有场景和当前集已关联场景
+4. 调用 `read_existing_props` 查看项目已有道具和当前集已关联道具
+5. 只提取当前集真实涉及的角色、场景和道具
+6. 调用 `save_dedup_characters` 保存角色并自动关联到当前集
+7. 调用 `save_dedup_scenes` 保存场景并自动关联到当前集
+8. 调用 `save_dedup_props` 保存道具并自动关联到当前集
+
+## 当前集规则
+
+- 目标是补齐"当前集"需要的角色、场景和道具，不是重扫整个项目
+- 若已在项目中存在但当前集未关联，仍应复用并关联到当前集
+- 去重规则：角色/道具按名称精确匹配，场景按【地点+时间段】精确匹配，命中的优先复用，不要重复创建
+- 近名去重：名称带括号定位或别名时按括号前主体比较（如「林小雨（主角）」与「林小雨」视为同一角色/道具，复用已有）；read_existing_characters / read_existing_props 返回的 normalized_name 即归一化后的名字，场景的 normalized_location 同理，据此判断即可
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.en.md b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.en.md
new file mode 100644
index 0000000..020d758
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.en.md
@@ -0,0 +1,57 @@
+---
+name: character-prompt
+description: Final character prompt specification — front-face close-up + three-view turnaround (front / 90-degree side / back), serving as the appearance anchor for all subsequent generation
+---
+
+# Final Character Prompt (left: front-face close-up + right: three-view turnaround)
+
+What is generated is a character reference sheet with a fixed composition:
+
+- **Left: front-face close-up** — a frontal close view of head and shoulders, with facial features, hairstyle, and skin texture clearly visible, serving as the anchor for facial recognizability
+- **Right: three equal-height full-body views side by side — front, 90-degree side, and back** — three full-body views of the same character at equal height, with the tops of the heads and the soles of the feet aligned
+
+**Core principle: consistency > beauty.** This image is the appearance anchor for all subsequent character images and video references; it must be neutral, clear, and reusable — do not pursue the artistry of a single image.
+
+## Output Structure (assemble a single coherent passage in this order, following the session language directive)
+
+```
+Character reference sheet, left side a front-face close-up, right side three equal-height full-body views
+side by side showing front, 90-degree side, and back;
+the close-up and the full-body views are the same character, full body in frame, neutral A-pose,
+the three full-body views equal in height, side by side, tops of heads and soles of feet aligned;
+[age impression + gender impression + physique], [facial features], [hairstyle], [clothing + accessories];
+the face, hairstyle, and clothing of the front-face close-up and the three views are completely identical;
+pure white background, soft even lighting, cinematic quality
+```
+
+## Description Order Rules
+
+Put the **most recognizable features first**, covering every key element of `appearance` (looks) and `styling` (hair/clothing/makeup) in this order, with no omissions:
+
+1. Identity anchors: age impression (e.g. "early twenties"), gender impression, physique (height and build, posture habits)
+2. Facial features: face shape, eyes, other notable features (scars, moles, glasses, etc.) — the front-face close-up depends on this part especially
+3. Hairstyle: color, length, style
+4. Clothing: style, color, material, condition (e.g. "a wrinkled work uniform with solder marks on the cuffs")
+5. Accessories: write only the recognizable ones; do not pile them on
+
+Convert the character's personality traits into outward bearing and expression descriptions (e.g. "haggard" → "weary eyes, slightly slumped shoulders"); personality words must not appear directly.
+
+## Composition & Consistency
+
+- Left front-face close-up: facing the camera directly, neutral expression, head to shoulders fully in frame
+- Right three full-body views: front, 90-degree side, and back of the same character, **equal in height, side by side, evenly spaced**, tops of heads and soles of feet on the same horizontal lines
+- The close-up and the three full-body views must have the same face, the same hairstyle, and the same clothing — explicitly state "the face, hairstyle, and clothing of the front-face close-up and the three full-body views are completely identical"
+- Neutral stance, natural expression — easy to reuse as a reference image
+- Soft, even studio lighting; no dramatic light and shadow (the reference image must work in every kind of scene)
+- Do not mix unrelated words into the output
+
+## Prohibitions
+
+- Dynamic poses, exaggerated expressions, props in hand, being in frame with other people
+- Cropping the body (full-body views must be full body, head to soles fully in frame; the close-up must have head and shoulders fully in frame)
+- Text, labels, watermarks, signatures
+- Heavy shadows, colored background lighting, background props
+
+## Saving
+
+Call `save_character_final_prompt`: the prompt parameter contains no style words — **the project's visual style is automatically injected by the tool at the very front of the final prompt**.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.ja.md b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.ja.md
new file mode 100644
index 0000000..d88ed2e
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.ja.md
@@ -0,0 +1,55 @@
+---
+name: character-prompt
+description: キャラクター最終プロンプト仕様 — 正面顔クローズアップ ＋ 三面図（character turnaround：正面／90度側面／背面）。後続のすべての生成における外見のアンカー
+---
+
+# キャラクター最終プロンプト（左側：正面顔クローズアップ ＋ 右側：三面図）
+
+生成するのはキャラクター設定参照画像（character reference sheet）1枚。構図は固定：
+
+- **左側：正面顔クローズアップ**——頭部と肩部の正面アップ。顔立ち、髪型、肌質がはっきり見え、顔の識別性のアンカーとなる
+- **右側：正面、90度側面、背面の3枚の等高全身ビューを並列表示**——同一キャラクターの3つの全身ビューを等高で並べ、頭頂と足裏を揃える
+
+**中核原則：一貫性 ＞ 美しさ。** この画像は後続のすべてのキャラクター画像・動画参照の外見のアンカーであり、中立的で、明瞭で、再利用可能でなければならない——単独の1枚としての芸術性を追求しない。
+
+## 出力構造（この順序で1段落の連続した記述を組み立てる。言語はセッションの言語指令に従う）
+
+```
+キャラクター設定参照画像。左側は正面顔クローズアップ、右側は正面・90度側面・背面の3枚の等高全身ビューを並列表示。
+クローズアップと全身ビューはすべて同一キャラクター。全身が画面に収まり、中立的なA字の立ち姿。3枚の全身ビューは等高で並び、頭頂と足裏が揃っている。
+[年齢感 ＋ 性別感 ＋ 体格]、[顔立ちの特徴]、[髪型]、[服装 ＋ アクセサリー]。
+正面顔クローズアップと3つのビューの顔・髪型・服装は完全に一致。
+純白の背景、柔らかく均一な光線、映画の質感
+```
+
+## 記述順のルール
+
+**最も識別しやすい特徴を前に置き**、この順序で `appearance`（容姿）と `styling`（装い）の各キー要素を漏れなく落とし込む：
+
+1. 識別のアンカー：年齢感（例：「二十歳そこそこ」）、性別感、体格（身長・肥痩、姿勢の癖）
+2. 顔立ち：輪郭、目、その他の顕著な特徴（傷跡、ほくろ、眼鏡など）——正面顔クローズアップは特にこの部分の描写に依存する
+3. 髪型：色、長さ、スタイル
+4. 服装：デザイン、色、素材、状態（例：「袖口にはんだの跡のある皺だらけの作業服」）
+5. アクセサリー：識別性のあるものだけを書き、詰め込まない
+
+キャラクターの性格特性は外的な雰囲気と表情の描写に変換する（例：「憔悴」→「疲れ切った眼差し、肩がわずかに落ちている」）。性格を表す語彙を直接登場させない。
+
+## 構図と一貫性
+
+- 左側の正面顔クローズアップ：正面からカメラに向き、中立的な表情、頭頂から肩まで完全に画面に収める
+- 右側の3枚の全身ビュー：同一キャラクターの正面、90度側面、背面。**等高で並び、間隔は均等**、頭頂と足裏が同一水平線上にある
+- クローズアップと3枚の全身ビューは同じ顔、同じ髪型、同じ服装でなければならない——「正面顔クローズアップと3枚の全身ビューの顔・髪型・服装は完全に一致」と明確に書き出す
+- 中立的な立ち姿、自然な表情——参照画像として再利用しやすくするため
+- 柔らかく均一なスタジオ光。劇的な光影は使わない（参照画像はあらゆるシーンで使える必要がある）
+- 出力はセッションの言語指令で指定されたターゲット言語を使い、無関係な語彙を混ぜない
+
+## 禁止事項
+
+- 動的なポーズ、誇張された表情、手に持った小道具、他人との共演
+- 身体の裁切（全身ビューは必ず full body で頭頂から足裏まで完全に画面に収める；クローズアップは頭部と肩部を完全に画面に収める）
+- 文字、ラベル、透かし、署名
+- 強い影、カラーの背景光、背景の小道具
+
+## 保存
+
+`save_character_final_prompt` を呼び出す：prompt パラメータにスタイル語を含めない。**プロジェクトのビジュアルスタイルはツールが最終プロンプトの先頭へ自動注入する**。
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.ko.md b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.ko.md
new file mode 100644
index 0000000..50620fd
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.ko.md
@@ -0,0 +1,55 @@
+---
+name: character-prompt
+description: 캐릭터 최종 프롬프트 규범 — 정면 얼굴 클로즈업 + 삼면도(character turnaround: 정면/90도 측면/후면). 이후 모든 생성의 이미지 앵커로 사용
+---
+
+# 캐릭터 최종 프롬프트(좌측 정면 얼굴 클로즈업 + 우측 삼면도)
+
+생성물은 캐릭터 설정 참조 이미지(character reference sheet)이며, 구도는 다음과 같이 고정됩니다:
+
+- **좌측: 정면 얼굴 클로즈업** — 머리와 어깨의 정면 근경. 이목구비, 헤어스타일, 피부 질감이 선명하게 보이며, 얼굴 식별도의 앵커 역할을 합니다
+- **우측: 정면, 90도 측면, 후면의 같은 키 전신 뷰 3장을 나란히 배치** — 같은 캐릭터의 세 가지 전신 뷰를 같은 키로 나란히 놓고, 머리 꼭대기와 발바닥을 정렬합니다
+
+**핵심 원칙: 일관성 > 아름다움.** 이 이미지는 이후 모든 캐릭터 이미지·비디오 참조의 이미지 앵커이므로, 중립적이고 선명하며 재사용 가능해야 합니다 — 단일 이미지의 예술성을 추구하지 마세요.
+
+## 출력 구조(이 순서대로 하나의 연결된 문장으로 조립, 언어는 세션 언어 지시를 따름)
+
+```
+캐릭터 설정 참조 이미지. 좌측은 정면 얼굴 클로즈업, 우측은 정면, 90도 측면, 후면의 같은 키 전신 뷰 3장을 나란히 배치.
+클로즈업과 전신 뷰는 모두 같은 캐릭터이며, 전신이 화면에 들어오고, 중립적인 A자 서기 자세. 세 가지 전신 뷰는 같은 키로 나란히 놓고 머리 꼭대기와 발바닥을 정렬.
+[나이대 + 성별감 + 체형], [이목구비 특징], [헤어스타일], [의상 + 액세서리].
+정면 얼굴 클로즈업과 세 가지 뷰의 얼굴, 헤어스타일, 의상이 완전히 동일.
+순백 배경, 부드럽고 고른 조명, 영화적 질감
+```
+
+## 묘사 순서 규칙
+
+**가장 식별도가 높은 특징을 앞에 배치**하고, 이 순서대로 `appearance`(외모)와 `styling`(스타일링)의 모든 핵심 요소를 누락 없이 구체화합니다:
+
+1. 정체성 앵커: 나이대(예: "스물 초반"), 성별감, 체형(키와 몸매, 자세 습관)
+2. 이목구비: 얼굴형, 눈, 기타 뚜렷한 특징(흉터, 점, 안경 등) — 정면 얼굴 클로즈업이 특히 이 부분 묘사에 의존합니다
+3. 헤어스타일: 색상, 길이, 스타일
+4. 의상: 디자인, 색상, 소재, 상태(예: "소매에 납땜 자국이 있는 구겨진 작업복")
+5. 액세서리: 식별도가 있는 것만 쓰고, 잔뜩 쌓지 마세요
+
+캐릭터의 성격 특징은 외적인 분위기와 표정 묘사로 전환합니다(예: "초췌함" → "피로한 눈빛, 살짝 처진 어깨"). 성격 단어를 직접 쓰지 마세요.
+
+## 구도와 일관성
+
+- 좌측 정면 얼굴 클로즈업: 카메라를 정면으로 향하고, 중립적인 표정, 머리 꼭대기부터 어깨까지 완전히 화면에 들어옴
+- 우측 세 가지 전신 뷰: 같은 캐릭터의 정면, 90도 측면, 후면. **같은 키로 나란히, 간격 균일**, 머리 꼭대기와 발바닥이 같은 수평선 위에 있음
+- 클로즈업과 세 가지 전신 뷰는 반드시 같은 얼굴, 같은 헤어스타일, 같은 의상이어야 합니다 — "정면 얼굴 클로즈업과 세 가지 전신 뷰의 얼굴, 헤어스타일, 의상이 완전히 동일"하다고 명시적으로 쓰세요
+- 중립적인 서기 자세, 자연스러운 표정 — 참조 이미지로 재사용하기 좋게 합니다
+- 부드럽고 고른 스튜디오 조명, 극적인 명암 금지(참조 이미지는 어떤 장면에서도 쓸 수 있어야 함)
+- 출력은 세션 언어 지시가 지정한 목표 언어를 사용하고, 무관한 어휘를 섞지 마세요
+
+## 금지 사항
+
+- 역동적인 포즈, 과장된 표정, 소품을 손에 든 모습, 다른 사람과 함께 등장
+- 신체 잘림(전신 뷰는 반드시 full body로 머리 꼭대기부터 발바닥까지 완전히 화면에 들어와야 함; 클로즈업은 머리와 어깨가 완전히 들어와야 함)
+- 텍스트, 라벨, 워터마크, 서명
+- 짙은 그림자, 컬러 배경광, 배경 소품
+
+## 저장
+
+`save_character_final_prompt` 를 호출합니다: prompt 파라미터에는 스타일 단어를 넣지 않습니다. **프로젝트 비주얼 스타일은 도구가 최종 프롬프트 맨 앞에 자동으로 주입합니다**.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.md b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.md
new file mode 100644
index 0000000..c4d4c5e
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/character-prompt/SKILL.md
@@ -0,0 +1,55 @@
+---
+name: character-prompt
+description: 角色最终提示词规范 — 正脸特写 + 三视图（character turnaround：正面/90 度侧面/背面），作为后续所有生成的形象锚点
+---
+
+# 角色最终提示词（左侧正脸特写 + 右侧三视图）
+
+生成的是一张角色设定参考图（character reference sheet），构图固定为：
+
+- **左侧：正脸特写**——头部与肩部的正面近景，五官、发型、肤质清晰可见，作为脸部辨识度的锚点
+- **右侧：并列展示正面、90 度侧面、背面三张等高全身视图**——同一角色的三个全身视图等高并排，头顶与脚底对齐
+
+**核心原则：一致性 > 美观。** 这张图是后续所有角色图片、视频参考的形象锚点，必须中性、清晰、可复用——不要追求单张图的艺术感。
+
+## 输出结构（按此顺序组装单段连贯描述，语言跟随会话语言指令）
+
+```
+角色设定参考图，左侧为正脸特写，右侧并列展示正面、90 度侧面、背面三张等高全身视图，
+特写与全身视图都是同一角色，全身入镜，中性 A 字站姿，三张全身视图等高并排、头顶脚底对齐，
+[年龄感 + 性别感 + 体态]，[五官特征]，[发型]，[服装 + 配饰]，
+正脸特写与三个视图的脸、发型和服装完全一致，
+纯白背景，柔和均匀的光线，电影质感
+```
+
+## 描述顺序规则
+
+把**最有辨识度的特征放在前面**，按此顺序落地 `appearance`（样貌）与 `styling`（妆造）的每个关键元素，不遗漏：
+
+1. 身份锚点：年龄感（如"二十出头"）、性别感、体态（高矮胖瘦、姿态习惯）
+2. 五官：脸型、眼睛、其他显著特征（疤、痣、眼镜等）——正脸特写尤其依赖这部分描写
+3. 发型：颜色、长度、样式
+4. 服装：款式、颜色、材质、状态（如"袖口有焊锡痕迹的皱褶工服"）
+5. 配饰：只写有辨识度的，不堆砌
+
+角色的性格特点要转化为外在气质与神态描写（如"憔悴" → "眼神疲惫、肩膀微垮"），不要直接出现性格词汇。
+
+## 构图与一致性
+
+- 左侧正脸特写：正面朝向镜头、中性表情、头顶到肩膀完整入镜
+- 右侧三张全身视图：同一角色的正面、90 度侧面、背面，**等高并排、间距均匀**，头顶与脚底在同一水平线上
+- 特写与三张全身视图必须是同一张脸、同一发型、同一服装——明确写出"正脸特写与三张全身视图的脸、发型和服装完全一致"
+- 中性站姿、自然表情——方便作为参考图复用
+- 柔和均匀的棚拍光，不要戏剧性光影（参考图要在各种场景下都能用）
+- 输出使用会话语言指令指定的目标语言，不要混入无关词汇
+
+## 禁止事项
+
+- 动态姿势、夸张表情、手持道具、与他人同框
+- 裁切身体（全身视图必须 full body，头顶到脚底完整入镜；特写必须头部肩部完整入镜）
+- 文字、标签、水印、签名
+- 重阴影、彩色背景光、背景道具
+
+## 保存
+
+调用 `save_character_final_prompt`：prompt 参数不含风格词，**项目视觉风格由工具自动注入到最终提示词的最前方**。
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.en.md b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.en.md
new file mode 100644
index 0000000..2295ab0
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.en.md
@@ -0,0 +1,45 @@
+---
+name: prop-prompt
+description: Final prop prompt specification — white-background single-item still life, standard product-photography viewpoint: accurate proportions, complete edges, background carries no narrative
+---
+
+# Final Prop Prompt (white-background single item · standard product photography)
+
+What is generated is a white-background product shot: **using a standard product-photography viewpoint**, the frame contains only the prop itself, placed in isolation on a pure white background, **with no other elements mixed in** — no other objects, no people, no scene environment, no hands holding it.
+
+Three hard requirements:
+1. **Accurate proportions of all parts of the item** — no exaggeration, distortion, or stylized stretching; the prop's relative size relationships must be true
+2. **Complete edges** — the prop is fully in frame as a whole, with margins on all sides; no part may be cropped by the frame edge
+3. **The background carries no narrative content** — the pure white background is only a backing, with no sense of place, no plot hints, no decorative elements
+
+## Output Structure (assemble a single coherent passage in this order, following the session language directive)
+
+```
+Single-item product shot, standard product-photography viewpoint,
+[prop name + material/color/shape/size + degree of wear and damage details];
+accurate proportions of all parts, placed in isolation on a pure white background,
+centered and fully in frame, edges complete with no cropping;
+background clean and carrying no narrative content, no other objects, no people, no scene;
+soft even studio light, faint shadows, high detail
+```
+
+## Generation Rules
+
+- Build around the prop's `name` and `description` (physical appearance): material, color, shape, size, degree of wear, signs of damage, and other physical details must be **carried through item by item** — they are the source of the prop's recognizability
+- Standard product-photography viewpoint: a slightly high-angle 3/4 view (showing both the top and a side for maximum dimensionality); flat props (paper, ID cards, photos) use a straight top-down flat lay
+- Present the single item centered and complete, with margins on all sides, accurate proportions, complete edges — do not crop the prop's body
+- Soft even studio light, faint shadows, high detail
+- Describe only the item itself; do not mention plot, characters, or usage (neither the background nor the frame carries narrative content)
+- Do not mix unrelated words into the output; **do not** use "cinematic quality"-type words (a prop image is a product shot, not a film still)
+
+## Prohibitions
+
+- Hands holding it, people, other objects, or scene environment in frame
+- Packaging, bases, display stands (unless they are part of the prop itself)
+- Text, watermarks, signatures (text and graphics printed on the prop itself may be kept and described)
+- Environmental reflections, colored light
+- Exaggerated perspective, distortion, proportion errors, edge cropping
+
+## Saving
+
+Call `save_prop_final_prompt`: the prompt parameter contains no style words — **the project's visual style is automatically injected by the tool at the very front of the final prompt**.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.ja.md b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.ja.md
new file mode 100644
index 0000000..de3ed5f
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.ja.md
@@ -0,0 +1,43 @@
+---
+name: prop-prompt
+description: 小道具最終プロンプト仕様 — 白背景の単品静物。標準的なプロダクト撮影の視点：比率が正確、輪郭が完全、背景は物語を担わない
+---
+
+# 小道具最終プロンプト（白背景単品 · 標準プロダクト撮影）
+
+生成するのは白背景の単品画像（product shot）1枚：**標準的なプロダクト撮影の視点**を採用し、画面には小道具そのものだけがあり、純白の背景上に孤立して置かれ、**他のいかなる要素も混ぜない**——他の物品なし、人物なし、シーン環境なし、手で持つ描写なし。
+
+3つの硬性要件：
+1. **物品の各部の比率が正確**——誇張、変形、様式化された引き伸ばしをしない。小道具の相対的なサイズ関係は実際どおりでなければならない
+2. **輪郭が完全**——小道具全体が完全に画面に収まり、四方に余白を残す。どの部分も画面の端で裁切してはならない
+3. **背景はいかなる物語的内容も担わない**——純白の背景はあくまで下地であり、シーン感を帯びず、プロットの暗示を持たず、装飾要素を含まない
+
+## 出力構造（この順序で1段落の連続した記述を組み立てる。言語はセッションの言語指令に従う）
+
+```
+単品プロダクト画像、標準的なプロダクト撮影の視点。[小道具名 ＋ 材質／色／形状／大きさ ＋ 新旧の度合いと摩耗の細部]。
+物品の各部の比率は正確。純白の背景上に孤立して置かれ、中央に完全に収まり、輪郭は完全で裁切なし。
+背景は無垢でいかなる物語的内容も担わない。他の物品なし、人物なし、シーンなし。
+柔らかく均一なスタジオ光、淡い影、高精細
+```
+
+## 生成ルール
+
+- 小道具の `name`（名称）と `description`（物品の外観）を中核とする：材質、色、形状、大きさ、新旧の度合い、摩耗の跡などの物理的な細部を**一項目ずつ漏れなく落とし込む**。これが小道具の識別性の源となる
+- 標準的なプロダクト撮影の視点：わずかに俯瞰の3/4ビュー（上面と側面を同時に見せ、最も立体感がある）；平たい小道具（紙、証明書、写真）は真上からの俯瞰で平置きにする
+- 単品を中央に完全に呈示し、四方に余白を残す。比率は正確、輪郭は完全。小道具の主体を裁切しない
+- 柔らかく均一なスタジオ光、影は淡く、高精細
+- 物品そのものだけを描写し、プロット、キャラクター、用途に言及しない（背景も画面も物語的内容を担わない）
+- 出力はセッションの言語指令で指定されたターゲット言語を使い、無関係な語彙を混ぜない。**「映画の質感」類の語彙は使わない**（小道具画像は劇中スチルではなくプロダクト画像である）
+
+## 禁止事項
+
+- 手で持つ描写、人物、他の物品、シーン環境の写り込み
+- 包装、台座、ディスプレイスタンド（それが小道具本体の一部である場合を除く）
+- 文字、透かし、署名（小道具本体に印刷された文字や図柄は残し、描写してよい）
+- 環境の反射、カラーの光
+- 誇張されたパース、変形、比率の歪み、輪郭の裁切
+
+## 保存
+
+`save_prop_final_prompt` を呼び出す：prompt パラメータにスタイル語を含めない。**プロジェクトのビジュアルスタイルはツールが最終プロンプトの先頭へ自動注入する**。
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.ko.md b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.ko.md
new file mode 100644
index 0000000..24dc9d4
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.ko.md
@@ -0,0 +1,43 @@
+---
+name: prop-prompt
+description: 소품 최종 프롬프트 규범 — 화이트 배경 단품 정물, 표준 제품 사진 시점: 비율 정확, 가장자리 완전, 배경은 서사를 담지 않음
+---
+
+# 소품 최종 프롬프트(화이트 배경 단품 · 표준 제품 사진)
+
+생성물은 화이트 배경 단품 이미지(product shot)입니다: **표준 제품 사진 시점**을 사용하고, 화면에는 소품 자체만 있으며 순백 배경 위에 고립되어 놓여 있습니다. **다른 어떤 요소도 섞이지 않습니다** — 다른 물건 없음, 인물 없음, 장면 환경 없음, 손에 쥔 모습 없음.
+
+세 가지 엄격한 요구 사항:
+1. **물건 각 부분의 비율이 정확할 것** — 과장, 변형 또는 스타일화된 늘이기 금지. 소품의 상대적 크기 관계가 실제와 같아야 합니다
+2. **가장자리가 완전할 것** — 소품 전체가 온전히 화면에 들어오고 사방에 여백을 두며, 어떤 부분도 화면 가장자리에 잘리지 않아야 합니다
+3. **배경이 어떤 서사 내용도 담지 않을 것** — 순백 배경은 받침일 뿐, 장면감·줄거리 암시·장식 요소를 갖지 않습니다
+
+## 출력 구조(이 순서대로 하나의 연결된 문장으로 조립, 언어는 세션 언어 지시를 따름)
+
+```
+단품 제품 이미지, 표준 제품 사진 시점, [소품명 + 재질/색상/형태/크기 + 사용감과 마모 디테일].
+물건 각 부분의 비율이 정확하고, 순백 배경 위에 고립되어 놓여 있으며, 중앙에 온전히 들어오고, 가장자리가 완전하여 잘림이 없음.
+배경은 깨끗하고 어떤 서사 내용도 담지 않으며, 다른 물건 없음, 인물 없음, 장면 없음.
+부드럽고 고른 스튜디오 조명, 옅은 그림자, 고디테일
+```
+
+## 생성 규칙
+
+- 소품 `name`(이름)과 `description`(물건의 외형)을 핵심으로 합니다: 재질, 색상, 형태, 크기, 사용감, 마모 흔적 등 물리적 디테일을 **항목별로 모두 구체화**합니다 — 이것이 소품 식별도의 원천입니다
+- 표준 제품 사진 시점: 약간 위에서 내려다보는 3/4 시점(윗면과 측면을 동시에 볼 수 있어 가장 입체감이 있음); 납작한 소품(종이, 신분증, 사진)은 정면 위에서 내려다보는 평면 배치 사용
+- 단품을 중앙에 온전히 배치하고 사방에 여백을 둡니다. 비율 정확, 가장자리 완전, 소품 본체를 자르지 마세요
+- 부드럽고 고른 스튜디오 조명, 옅은 그림자, 고디테일
+- 물건 자체만 묘사하고, 줄거리·캐릭터·용도를 언급하지 마세요(배경과 화면 모두 서사 내용을 담지 않음)
+- 출력은 세션 언어 지시가 지정한 목표 언어를 사용하고, 무관한 어휘를 섞지 마세요; "영화적 질감"류의 단어는 쓰지 **마세요**(소품 이미지는 제품 사진이지 스틸컷이 아님)
+
+## 금지 사항
+
+- 손에 쥔 모습, 인물, 다른 물건, 장면 환경이 화면에 들어오는 것
+- 포장, 받침대, 진열대(소품 본체의 일부인 경우 제외)
+- 텍스트, 워터마크, 서명(소품 본체에 인쇄된 글자·무늬는 유지하고 묘사 가능)
+- 환경 반사광, 컬러 조명
+- 과장된 원근, 변형, 비율 왜곡, 가장자리 잘림
+
+## 저장
+
+`save_prop_final_prompt` 를 호출합니다: prompt 파라미터에는 스타일 단어를 넣지 않습니다. **프로젝트 비주얼 스타일은 도구가 최종 프롬프트 맨 앞에 자동으로 주입합니다**.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.md b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.md
new file mode 100644
index 0000000..e710c3f
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/prop-prompt/SKILL.md
@@ -0,0 +1,43 @@
+---
+name: prop-prompt
+description: 道具最终提示词规范 — 白底单品静物，标准产品摄影视角：比例准确、边缘完整、背景不承载叙事
+---
+
+# 道具最终提示词（白底单品 · 标准产品摄影）
+
+生成的是一张白底单品图（product shot）：**采用标准产品摄影视角**，画面中只有道具本身，孤立放置在纯白背景上，**不掺杂任何其他元素**——没有其他物品、没有人物、没有场景环境、没有手部持握。
+
+三条硬性要求：
+1. **物品各部分比例准确**——不要夸张、变形或风格化拉伸，道具的相对尺寸关系必须真实
+2. **边缘完整**——道具整体完整入镜，四周留白，任何部分都不得被画面边缘裁切
+3. **背景不承载任何叙事内容**——纯白背景只是衬底，不带场景感、不带情节暗示、不带装饰元素
+
+## 输出结构（按此顺序组装单段连贯描述，语言跟随会话语言指令）
+
+```
+单品产品图，标准产品摄影视角，[道具名 + 材质/颜色/形状/大小 + 新旧程度与磨损细节]，
+物品各部分比例准确，孤立放置在纯白背景上，居中完整入镜，边缘完整无裁切，
+背景纯净不承载任何叙事内容，无其他物品、无人物、无场景，
+柔和均匀的影棚光，轻淡阴影，高细节
+```
+
+## 生成规则
+
+- 以道具 `name`（名称）与 `description`（物品外貌）为核心：材质、颜色、形状、大小、新旧程度、磨损痕迹等物理细节**逐项落地**，这是道具辨识度的来源
+- 标准产品摄影视角：微俯视 3/4 视角（同时看清顶面与侧面，最有立体感）；扁平道具（纸张、证件、照片）用正俯视平铺
+- 单品居中完整呈现，四周留白，比例准确、边缘完整，不要裁切道具主体
+- 柔和均匀的影棚光，阴影轻淡，高细节
+- 只描写物品本身，不要提及剧情、角色或用途（背景与画面都不承载叙事内容）
+- 输出使用会话语言指令指定的目标语言，不要混入无关词汇；**不要**"电影质感"类词汇（道具图是产品图不是剧照）
+
+## 禁止事项
+
+- 手部持握、人物、其他物品、场景环境入镜
+- 包装、底座、展示架（除非它就是道具本体的一部分）
+- 文字、水印、签名（道具本体上印刷的文字图案可以保留并描述）
+- 环境反光、彩色光
+- 夸张透视、变形、比例失真、边缘裁切
+
+## 保存
+
+调用 `save_prop_final_prompt`：prompt 参数不含风格词，**项目视觉风格由工具自动注入到最终提示词的最前方**。
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.en.md b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.en.md
new file mode 100644
index 0000000..bfe16db
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.en.md
@@ -0,0 +1,63 @@
+---
+name: scene-prompt
+description: Final scene prompt specification — a clear wide-angle establishing shot: fixed relative positions of foreground/midground/background/entrances/floor/walls/key set dressing; spatially continuous, self-consistent, reusable, no people
+---
+
+# Final Scene Prompt (wide-angle establishing shot · empty scene with no people)
+
+What is generated is a **clear wide-angle establishing shot** scene image: a pure empty shot of the scene with **absolutely no people**, fully showing the **fixed relative positions of the foreground, midground, background, entrances/exits, floor, walls, and key set dressing** — spatially continuous, self-consistent, and reusable.
+
+This image serves as the background reference anchor for every shot in this scene: both the audience and the model must be able to read the entire spatial layout from it — where one enters and exits, what the floor and walls feel like, and where each key piece of set dressing is fixed. The viewpoint must be stable and general-purpose.
+
+## Output Structure (assemble a single coherent passage in this order, following the session language directive)
+
+```
+Fixed-camera wide-angle shot, a clear establishing shot, [location + period texture], [time period];
+three-layer composition of foreground ([foreground elements]), midground ([main space of the midground]),
+and background ([depth of the background]);
+entrances/exits ([position and style of doors/passages]), floor ([floor material and condition]),
+walls ([wall material and color]);
+[key set dressing and its fixed relative positions];
+spatial structure continuous and self-consistent;
+[light sources + color temperature + brightness contrast], [mood];
+No people in the scene, empty scene, cinematic quality
+```
+
+## Spatial Structure Rules
+
+The space must be **readable, consistent, and reusable**:
+
+- **Foreground**: framing/occluding elements (door frames, table corners, plants, equipment edges) that create depth — write 1-2 specific elements
+- **Midground**: the scene's main space and core set dressing (assembly line, beds, counter)
+- **Background**: the extension of the space (distant walls, windows, corridors, city skyline)
+- **Entrances/exits**: the position and style of doors, stairs, and passages must be explicit (e.g. "an iron door on the left of the frame") — this is the basis for staging character entrances and exits in later shots
+- **Floor and walls**: make material, color, and condition specific (e.g. "oil stains on the concrete floor", "mottled lime plaster on the walls")
+- **Key set dressing**: write 2-4 core pieces and their **fixed relative positions** (e.g. "the assembly line runs along the wall, ending at the bar counter"); the left-right/near-far relationships among pieces must be self-consistent — do not just list item names
+
+## People (Hard Rule · Highest Priority)
+
+**No people of any kind may appear in the scene image — keep only the scene itself.**
+
+- The prompt must not describe people or mention anything related to people
+- Any human information appearing in the scene description (prompt) must be ignored and not written into the prompt
+- The prompt must end with: "No people in the scene, empty scene"
+
+All set dressing, period texture, and key visual elements in `prompt` (scene description) must be carried through; `lighting` (scene lighting) must be made specific: light-source direction, warm/cool color temperature, brightness contrast (e.g. "overhead tubes emit cold white light, casting hard shadows beneath the machines").
+
+## Viewpoint & Atmosphere
+
+- A stable eye-level or slightly high-angle wide shot; no extreme high/low angles, fisheye, or tilted composition (it will be reused repeatedly as a fixed scene)
+- Determine the time period and overall lighting scheme from `location` + `time` (day / night / dusk are completely different lighting schemes)
+- Make mood words concrete: "oppressive" → "stifling air, dim and low light"; do not write only abstract emotion words
+- Do not mix unrelated words into the output
+
+## Prohibitions
+
+- Any people — **no people of any kind may appear in the scene image; keep only the scene itself**
+- Text, readable text on signboards, watermarks, signatures
+- Motion blur, objects in motion (the scene reference image must be still and stable)
+- Merely listing set dressing without giving relative positions (the spatial structure must be continuous and self-consistent)
+
+## Saving
+
+Call `save_scene_final_prompt`: the prompt parameter contains no style words — **the project's visual style is automatically injected by the tool at the very front of the final prompt**.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.ja.md b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.ja.md
new file mode 100644
index 0000000..e222a5b
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.ja.md
@@ -0,0 +1,61 @@
+---
+name: scene-prompt
+description: シーン最終プロンプト仕様 — 明瞭な広角エスタブリッシングショット：前景／中景／後景／出入口／床／壁／主要な調度品の固定的な相対位置。空間が連続し、自己完結的で再利用可能。人物なし
+---
+
+# シーン最終プロンプト（広角エスタブリッシングショット · 人物なしの空カット）
+
+生成するのは**明瞭な広角エスタブリッシングショット（establishing shot）**のシーン画像：**完全に人物のいない**純粋なシーンの空カットで、**前景、中景、後景、出入口、床、壁、および主要な調度品の固定的な相対位置**を完全に示し、空間構造が連続し、自己完結的で、再利用可能でなければならない。
+
+この画像はそのシーンのすべてのカットの背景参照アンカーとなる：観客もモデルもこの1枚から空間全体のレイアウトを読み取れなければならない——どこから出入りするのか、床と壁はどんな質感か、中核となる調度品がそれぞれどの位置に固定されているか。視点は安定していて汎用的でなければならない。
+
+## 出力構造（この順序で1段落の連続した記述を組み立てる。言語はセッションの言語指令に従う）
+
+```
+固定カメラの広角ショット、明瞭なエスタブリッシングショット。[場所 ＋ 年代の質感]、[時間帯]。
+前景（[前景の要素]）、中景（[中景の主体空間]）、後景（[後景の奥行き]）の3層に分かれた構図。
+出入口（[ドア／通路の位置と様式]）、床（[床の材質と状態]）、壁（[壁の材質と色]）。
+[主要な調度品とその固定的な相対位置]。
+空間構造は連続し、自己完結的。
+[光源 ＋ 色温度 ＋ 明暗のコントラスト]、[雰囲気]。
+シーンに人物はいません、空のシーン。映画の質感
+```
+
+## 空間構造のルール
+
+空間は**読み取れ、対応が取れ、再利用可能**でなければならない：
+
+- **前景**：フレーミング／遮蔽物（ドア枠、テーブルの角、植物、機器の縁）で奥行きを作る——具体的な要素を1〜2個書く
+- **中景**：シーンの主体となる空間と中核の調度品（流れ作業のライン、ベッド、カウンター）
+- **後景**：空間の広がり（遠くの壁、窓、廊下、街の輪郭）
+- **出入口**：ドア、階段、通路の位置と様式を明確にする（例：「画面左側に鉄のドアが1枚」）。これは後続のカットで人物を出入りさせる演出の根拠となる
+- **床と壁**：材質、色、状態を具体化する（例：「コンクリートの床に油の染み」「壁の漆喰が斑に剥がれている」）
+- **主要な調度品**：中核となる調度品を2〜4個書き、それらの**固定的な相対位置**を示す（例：「流れ作業のラインが壁沿いに並び、その突き当たりにカウンター」）。調度品同士の左右／遠近の関係は自己完結的であること。物品名を単に列挙しない
+
+## 人物（硬性ルール · 最優先）
+
+**シーン画像にはいかなる人物も出してはならず、シーンそのものだけを残す。**
+
+- プロンプトに人物を描写せず、人物に関連するいかなる内容にも言及しない
+- シーン描写（prompt）に登場する人物情報は一律に無視し、プロンプトに書き込まない
+- プロンプトの末尾には必ず「シーンに人物はいません、空のシーン」を含める
+
+`prompt`（シーン描写）中の調度品、年代の質感、重要な視覚要素はすべて漏れなく落とし込む；`lighting`（シーンの光影）は具体化する：光源の方向、色温度の寒暖、明暗のコントラスト（例：「頭上の蛍光灯が冷たい白光を放ち、機械の下に硬い影を落としている」）。
+
+## 視点と雰囲気
+
+- 安定した目線の高さかわずかな俯瞰の広角。極端な俯仰、魚眼、傾いた構図は使わない（固定シーンとして繰り返し再利用するため）
+- `location` ＋ `time` で時間帯と光線の基調を定める（昼／夜／夕暮れでは光がまったく異なる）
+- 雰囲気の語は具体化する：「息苦しい」→「空気が蒸し暑く、光線が暗く沈んでいる」。抽象的な感情語だけを書かない
+- 出力はセッションの言語指令で指定されたターゲット言語を使い、無関係な語彙を混ぜない
+
+## 禁止事項
+
+- いかなる人物——**シーン画像にはいかなる人物も出してはならず、シーンそのものだけを残す**（後ろ姿、シルエット、反射・映り込み、写真の中の人物も含む）
+- 文字、看板の読み取れる文字、透かし、署名
+- モーションブラー、動いている物体（シーン参照画像は静止して安定している必要がある）
+- 相対位置を示さず調度品のリストを羅列するだけ（空間構造は連続し、自己完結的でなければならない）
+
+## 保存
+
+`save_scene_final_prompt` を呼び出す：prompt パラメータにスタイル語を含めない。**プロジェクトのビジュアルスタイルはツールが最終プロンプトの先頭へ自動注入する**。
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.ko.md b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.ko.md
new file mode 100644
index 0000000..d7336f2
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.ko.md
@@ -0,0 +1,61 @@
+---
+name: scene-prompt
+description: 장면 최종 프롬프트 규범 — 선명한 광각 establishing shot: 전경/중경/후경/출입구/바닥/벽면/주요 비품의 고정된 상대 위치. 공간이 연속적이고 자기 모순 없이 재사용 가능, 인물 없음
+---
+
+# 장면 최종 프롬프트(광각 establishing shot · 인물 없는 빈 장면)
+
+생성물은 **선명한 광각 establishing shot** 장면 이미지입니다: **인물이 전혀 없는** 순수 장면 빈 컷으로, **전경, 중경, 후경, 출입구, 바닥, 벽면 및 주요 비품의 고정된 상대 위치**를 온전히 보여주며, 공간 구조가 연속적이고 자기 모순이 없으며 재사용 가능합니다.
+
+이 이미지는 해당 장면의 모든 컷의 배경 참조 앵커로 사용됩니다: 관객과 모델 모두 이 이미지 하나로 전체 공간의 배치를 읽을 수 있어야 합니다 — 어디로 드나드는지, 바닥과 벽면이 어떤 질감인지, 핵심 비품이 각각 어느 위치에 고정되어 있는지. 시점은 반드시 안정적이고 범용적이어야 합니다.
+
+## 출력 구조(이 순서대로 하나의 연결된 문장으로 조립, 언어는 세션 언어 지시를 따름)
+
+```
+고정 카메라 광각 컷, 선명한 establishing shot, [장소 + 시대적 질감], [시간대].
+전경([전경 요소]), 중경([중경의 주체 공간]), 후경([후경의 깊이])의 삼중 레이어 구도.
+출입구([문/통로의 위치와 형태]), 바닥([바닥 소재와 상태]), 벽면([벽면 소재와 색상]).
+[주요 비품과 그 고정된 상대 위치].
+공간 구조가 연속적이고 자기 모순이 없음.
+[광원 + 색온도 + 명암 대비], [분위기].
+장면에 사람이 없습니다, 빈 장면, 영화적 질감
+```
+
+## 공간 구조 규칙
+
+공간은 반드시 **읽을 수 있고, 서로 맞물리며, 재사용 가능**해야 합니다:
+
+- **전경**: 프레이밍/가림 요소(문틀, 테이블 모서리, 식물, 장비 가장자리)로 깊이를 만듭니다 — 구체적인 요소 1-2개를 쓰세요
+- **중경**: 장면의 주체 공간과 핵심 비품(생산 라인, 침대, 카운터)
+- **후경**: 공간의 연장(멀리 있는 벽, 창문, 복도, 도시 윤곽)
+- **출입구**: 문, 계단, 통로의 위치와 형태가 명확해야 합니다(예: "화면 왼쪽의 철문 하나"). 이는 이후 컷에서 인물의 출입을 연출하는 근거가 됩니다
+- **바닥과 벽면**: 소재, 색상, 상태를 구체화합니다(예: "콘크리트 바닥에 기름 얼룩", "벽면의 회반죽이 얼룩짐")
+- **주요 비품**: 핵심 비품 2-4개와 그 **고정된 상대 위치**를 씁니다(예: "생산 라인이 벽을 따라 늘어서고, 끝에 바가 있음"). 비품 사이의 좌우/원근 관계가 자기 모순 없어야 하며, 물건 이름만 나열하지 마세요
+
+## 인물(엄격한 규칙 · 최고 우선순위)
+
+**장면 이미지에는 어떤 사람도 등장할 수 없습니다. 장면 자체만 남기세요.**
+
+- 프롬프트에 인물을 묘사하지 말고, 인물과 관련된 어떤 내용도 언급하지 마세요
+- 장면 묘사(prompt)에 등장하는 인물 정보는 모두 무시하고 프롬프트에 쓰지 마세요
+- 프롬프트 끝에는 반드시 "장면에 사람이 없습니다, 빈 장면"을 포함해야 합니다
+
+`prompt`(장면 묘사) 속의 비품, 시대적 질감, 핵심 시각 요소는 모두 구체화해야 합니다; `lighting`(장면 조명)은 구체화합니다: 광원 방향, 색온도의 냉난, 명암 대비(예: "천장 형광등이 차가운 백색광을 내고, 기계 아래로 날카로운 그림자가 드리움").
+
+## 시점과 분위기
+
+- 안정적인 정면 또는 약간 위에서 내려다보는 광각. 극단적인 위·아래 앵글, 어안 렌즈, 기울어진 구도 금지(고정 장면으로 반복 재사용해야 함)
+- `location` + `time` 으로 시간대와 조명 톤을 결정합니다(낮/밤/황혼의 빛은 완전히 다름)
+- 분위기 단어를 구체화합니다: "억압적" → "공기가 무덥고, 빛이 어둡고 낮게 가라앉음". 추상적인 감정 단어만 쓰지 마세요
+- 출력은 세션 언어 지시가 지정한 목표 언어를 사용하고, 무관한 어휘를 섞지 마세요
+
+## 금지 사항
+
+- 어떤 인물이든 — **장면 이미지에는 어떤 사람도 등장할 수 없습니다. 장면 자체만 남기세요**
+- 텍스트, 간판의 읽을 수 있는 글자, 워터마크, 서명
+- 모션 블러, 움직이는 물체(장면 참조 이미지는 정지 상태로 안정적이어야 함)
+- 상대 위치를 밝히지 않고 비품 목록만 나열하는 것(공간 구조는 연속적이고 자기 모순이 없어야 함)
+
+## 저장
+
+`save_scene_final_prompt` 를 호출합니다: prompt 파라미터에는 스타일 단어를 넣지 않습니다. **프로젝트 비주얼 스타일은 도구가 최종 프롬프트 맨 앞에 자동으로 주입합니다**.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.md b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.md
new file mode 100644
index 0000000..193d778
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/scene-prompt/SKILL.md
@@ -0,0 +1,61 @@
+---
+name: scene-prompt
+description: 场景最终提示词规范 — 清晰广角建立镜头：前景/中景/后景/出入口/地面/墙面/主要陈设的固定相对位置，空间连续自洽可复用，无人物
+---
+
+# 场景最终提示词（广角建立镜头 · 无人物空镜）
+
+生成的是一张**清晰的广角建立镜头（establishing shot）**场景图：**完全没有人物**的纯场景空镜，完整展示**前景、中景、后景、出入口、地面、墙面及主要陈设的固定相对位置**，空间结构连续、自洽且可复用。
+
+这张图会作为该场景所有镜头的背景参考锚点：观众和模型都必须能从这张图读懂整个空间的布局——从哪里进出、地面与墙面是什么质感、核心陈设各自固定在什么位置。视角必须稳定、通用。
+
+## 输出结构（按此顺序组装单段连贯描述，语言跟随会话语言指令）
+
+```
+固定机位广角镜头，清晰的建立镜头，[地点 + 年代质感]，[时间段]，
+前景（[前景元素]）、中景（[中景主体空间]）、后景（[后景纵深]）三层分层构图，
+出入口（[门/通道的位置与样式]），地面（[地面材质与状态]），墙面（[墙面材质与颜色]），
+[主要陈设及其固定相对位置]，
+空间结构连续、自洽，
+[光源 + 色温 + 明暗对比]，[氛围]，
+画面中没有任何人物，空场景，电影质感
+```
+
+## 空间结构规则
+
+空间必须**读得懂、对得上、可复用**：
+
+- **前景**：框景/遮挡物（门框、桌角、植物、设备边缘），制造纵深——写出 1-2 个具体元素
+- **中景**：场景的主体空间与核心陈设（流水线、床铺、柜台）
+- **后景**：空间的延伸（远处的墙、窗、走廊、城市轮廓）
+- **出入口**：门、楼梯、通道的位置与样式必须明确（如"画面左侧一扇铁门"），这是后续镜头调度人物进出的依据
+- **地面与墙面**：材质、颜色、状态具体化（如"水泥地面有油渍""墙面石灰斑驳"）
+- **主要陈设**：写出 2-4 个核心陈设及它们的**固定相对位置**（如"流水线沿墙排开，尽头是吧台"），陈设之间的左右/远近关系要自洽，不要只罗列物品名
+
+## 人物（硬性规则 · 最高优先级）
+
+**场景图中不能出现任何的人，只保留场景本身。**
+
+- 提示词中不描述人物、不提及任何与人物相关的内容
+- 场景描述（prompt）中出现的人物信息一律忽略，不写入提示词
+- 提示词结尾必须包含："画面中没有任何人物，空场景"
+
+`prompt`（场景描述）中的陈设、年代质感、关键视觉元素必须全部落地；`lighting`（场景光影）要具体化：光源方向、色温冷暖、明暗对比（如"头顶灯管发出冷白光，机器下方投下硬阴影"）。
+
+## 视角与氛围
+
+- 稳定的平视或微俯广角，不要极端俯仰、鱼眼、倾斜构图（要作为固定场景反复复用）
+- 以 `location` + `time` 确定时间段与光线基调（日/夜/黄昏的光完全不同）
+- 氛围词具体化："压抑" → "空气闷热、光线昏暗低沉"，不要只写抽象情绪词
+- 输出使用会话语言指令指定的目标语言，不要混入无关词汇
+
+## 禁止事项
+
+- 任何人物——**场景图中不能出现任何的人，只保留场景本身**
+- 文字、招牌上的可读文字、水印、签名
+- 动态模糊、运动中的物体（场景参考图必须静止稳定）
+- 只罗列陈设清单而不交代相对位置（空间结构必须连续、自洽）
+
+## 保存
+
+调用 `save_scene_final_prompt`：prompt 参数不含风格词，**项目视觉风格由工具自动注入到最终提示词的最前方**。
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.en.md b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.en.md
new file mode 100644
index 0000000..7fc9d9a
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.en.md
@@ -0,0 +1,71 @@
+---
+name: video-prompt
+description: Video prompt specification — generates a time-segmented video-generation prompt from storyboard-segment content, with cuts allowed within a segment
+---
+
+# Video Prompt (storyboard segment → video_prompt)
+
+From a single storyboard segment's description (containing the 【镜头N】 sub-shot structure and dialogue/narration) / atmosphere / duration, generate the `video_prompt` that drives AI video generation. **One storyboard segment = one 8-15-second video, with cuts allowed inside it**: consecutive segments may be different shots (change of shot size/angle/subject), joined with hard cuts; but the whole segment **never crosses scenes** and never uses flashbacks.
+
+## Format
+
+The **first line of the `video_prompt` is the header**: first introduce which characters and scene appear in this video, then follow with the time segments. Characters and scenes are always referenced with @ (during generation they are replaced with the corresponding reference-image markers, so the video model first locks onto "who" and "where").
+
+```
+Characters: @Xiaoming, @Xiaohong; Scene: @Coffee Shop.
+0-3s: @Coffee Shop, close shot, static camera; @Xiaoming looks down at his phone, fingers repeatedly tapping the table, expression anxious.
+3-6s: Cut to a wide shot of the doorway; the doorbell rings as @Xiaohong pushes the door open and walks in, bringing in a gust of cold air.
+6-9s: Cut back to a medium shot; @Xiaohong walks over with a smile and sits down across from Xiaoming; Xiaoming says: "You finally made it."
+```
+
+Header rules:
+- Only list the characters who actually appear in this storyboard segment and the bound scene — do not list those who do not appear
+- When a prop has a notable appearance, it may be appended to the header (e.g. `; Props: @Letter`)
+- The header is its own line, ending with a period, followed by the time segments
+
+Split into 3-second segments, each segment on its own line separated by newlines, with time ranges continuous and adjoining (no overlaps, no gaps).
+
+## Mapping to the Storyboard Description
+
+The `description` is the sole content source of the video_prompt (visuals, actions, dialogue, and narration are all in it). Conversion rules:
+
+- Each `【镜头N】` in the `description` maps to **1-2 consecutive 3-second segments** — same order, no omissions, no merging, no new sub-shots
+- Dialogue/narration is extracted from the "CharacterName says: "..."" / "Narration: ..." entries inside the corresponding `【镜头N】` and assigned to that sub-shot's mapped segments; **do not invent new dialogue beyond the description**
+- Visual actions follow the `description`; `atmosphere` is only used to supplement each segment's lighting, color tone, and mood descriptions
+
+## Within-Segment Structure
+
+Organize each segment's content in this order (items with no content may be omitted, but action/visuals are mandatory):
+
+**Time range + scene @reference + shot size/camera move + character @reference + main action·expression + dialogue/narration + mood and lighting**
+
+- **The first segment must establish the space**: scene + camera position + each character's position and state, so the audience knows at a glance where we are and whom to watch
+- **Cuts**: start a post-cut segment with a transition word such as "cut to / cut back", and restate the shot size and subject; cut points should align with the `【镜头N】` structure in the storyboard `description`
+- **Shot size/camera move**: one camera state per segment (close shot / medium shot / wide shot / close-up; static / push / pull / pan / tracking); the camera move is continuous within a single sub-shot and may change after a cut
+- **Action**: one main action per segment, with concrete visible verbs (walk, turn around, look up, clench, pause)
+- **All emotion must become visible description**: no abstract words like "he is very sad / the mood is tense" — write it as "he lowers his head, fingers clench the rim of the cup, breathing grows heavier"
+- **Dialogue/narration**: write "CharacterName says: "line""; narration as "Narration: content"; a long line that cannot be spoken within 3 seconds is split across multiple segments; a segment without dialogue may note ambient/action sounds (e.g. "machines keep roaring")
+
+## Reference Rules
+
+- `@SceneName` — scene reference; the name must exactly match the location in the scene list
+- `@CharacterName` — character reference; the name must exactly match the name in the character list
+- `@PropName` — prop reference; the name must exactly match the name in the prop list; reference a prop when it is clearly visible in frame, used, or shown in close-up
+- During generation, each `@name` is automatically replaced with the corresponding reference-image marker (e.g. `@Xiaoming` → `@Image1Xiaoming`), so names must match exactly — do not abbreviate or add extra symbols
+- **Every segment must have at least one @ reference anchoring the frame**; any segment in which a character appears must @ that character; only reference scenes/characters/props already bound to this storyboard segment
+
+## Timeline Rules
+
+- Number of segments = storyboard-segment duration ÷ 3 seconds (rounded up); the segment time ranges must add up exactly to the total segment duration
+- Content pacing: the first segment establishes → middle segments advance the action/conflict → the final segment lands on the result or emotional beat
+
+## Prohibitions
+
+- Cross-scene switching, flashbacks (a segment takes place in a single scene only)
+- Referencing scene/character names outside the lists
+- Abstract psychological description, literary metaphor (the model only recognizes visible imagery)
+- Language that does not match the session language directive
+
+## Saving
+
+Call `update_storyboard` to update only this storyboard segment's `video_prompt` field; do not modify any other field, and do not re-breakdown the whole episode.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.ja.md b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.ja.md
new file mode 100644
index 0000000..291cdee
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.ja.md
@@ -0,0 +1,71 @@
+---
+name: video-prompt
+description: 動画プロンプト仕様 — 絵コンテパラグラフの内容に基づき、時間で区間分けされ、区間内でカット切り替え可能な動画生成プロンプトを生成する
+---
+
+# 動画プロンプト（絵コンテパラグラフ → video_prompt）
+
+1つの絵コンテパラグラフの description（【镜头N】のサブカット構造とセリフ／ナレーションを含む）／ atmosphere ／ duration に基づき、AI動画生成を駆動する `video_prompt` を生成する。**1つの絵コンテパラグラフ = 1本の8〜15秒の動画で、内部でのカット切り替えは許可される**：区間と区間の間は異なるカット（ショットサイズ／アングル／被写体の変更）でよく、ハードカットでつなぐ。ただし**全編を通じてシーンをまたがず**、フラッシュバックもしない。
+
+## フォーマット
+
+`video_prompt` の**1行目は情報ヘッダー**：この動画にどの人物とシーンが出るかを先に紹介し、その後に時間区間を続ける。人物・シーンは一律に @ 参照を使う（生成時に対応する参照画像マーカーへ置き換えられ、動画モデルがまず「誰」と「どこ」を照合できるようにする）。
+
+```
+登場人物：@小明、@小红。シーン：@カフェ。
+0-3秒：@カフェ、近景の固定ショット。@小明は俯いてスマホを見て、指先で何度もテーブルを叩き、表情は不安そう。
+3-6秒：入口の全景に切り替わり、ドアベルが鳴る。@小红がドアを押して入り、一陣の冷たい風を連れてくる。
+6-9秒：ミディアムショットに切り替わる。@小红が微笑みながら小明のそばに歩み寄って座る。小明は言う：「やっと来たね。」
+```
+
+情報ヘッダーのルール：
+- その絵コンテパラグラフに実際に登場する人物と、紐付けられたシーンだけを列挙する。登場しないものを列挙しない
+- 小道具がはっきり登場する場合は情報ヘッダーに追記できる（例：`。小道具：@手紙`）
+- 情報ヘッダーは独立した1行で、句点で終わる。その後に時間区間が続く
+
+3秒を1区間とし、各区間を1行ずつ改行で区切る。時間範囲は連続してつながる（重複なし、欠落なし）。
+
+## 絵コンテの描写とのマッピング
+
+`description` が video_prompt の唯一の内容源である（画面、動作、セリフ、ナレーションはすべてその中にある）。変換ルール：
+
+- `description` の各 `【镜头N】` を**連続した1〜2個の3秒区間**にマッピングする。順序一致、漏れなし、マージなし、サブカットの新規追加なし
+- セリフ／ナレーションは対応する `【镜头N】` 内の「キャラクター名は言う：「…」」「ナレーション：…」から抽出し、そのサブカットにマッピングされた区間へ配分する。**description 以外の新しいセリフを創作しない**
+- 画面の動作は `description` を基準とする；`atmosphere` は各区間の光線、色調、雰囲気の描写を補うためだけに使う
+
+## 区間内の構造
+
+各区間はこの順序で内容を組み立てる（内容のない項目は省略してよいが、動作／画面は必須）：
+
+**時間範囲 ＋ シーンの@参照 ＋ ショットサイズ／カメラワーク ＋ キャラクターの@参照＋主体の動作・表情 ＋ セリフ／ナレーション ＋ 雰囲気と光線**
+
+- **最初の区間は必ず空間を確立する**：シーン ＋ カメラ位置 ＋ キャラクターの位置と状態で、観客が一目で「どこか、誰を見るか」を把握できるようにする
+- **カット切り替え**：切り替え後の区間の冒頭は「切り替わる／戻る」などの接続語を使い、ショットサイズと主体を改めて示す。カットの切り替え位置は絵コンテ `description` の `【镜头N】` 構造に揃える
+- **ショットサイズ／カメラワーク**：各区間1つのショット状態（近景／ミディアム／全景／クローズアップ；固定／プッシュイン／プルバック／パン／フォロー）。1つのサブカット内ではカメラワークは連続し、カット切り替え後に変更できる
+- **動作**：各区間1つの主な動作。動詞は具体的で目に見えるものにする（歩く、振り返る、顔を上げる、握り締める、間を置く）
+- **感情はすべて目に見える描写に変換する**：「彼は悲しい／空気が張り詰めている」のような抽象語は使わず、「彼はうつむき、指がカップの縁を握り締め、呼吸が重くなる」と書く
+- **セリフ／ナレーション**：「キャラクター名は言う：「セリフ」」と書き、ナレーションは「ナレーション：内容」と書く。3秒で読み切れない長いセリフは複数区間に分割する。セリフのない区間には環境音／動作音を書いてよい（例：「機械が轟音を立て続けている」）
+
+## 参照ルール
+
+- `@シーン名` — シーンの参照。名前はシーンリストの場所と完全に一致させること
+- `@キャラクター名` — キャラクターの参照。名前はキャラクターリストの名前と完全に一致させること
+- `@小道具名` — 小道具の参照。名前は小道具リストの名前と完全に一致させること。小道具が画面内で明確に見える、使われる、またはクローズアップされるときに参照する
+- 生成時に `@名前` は対応する参照画像マーカーへ自動置き換えされる（例：`@小明` → `@图片1小明`）。そのため名前は正確に一致させ、略称や余分な記号を付けない
+- **各区間に少なくとも1つの @ 参照で画面をアンカーする**。キャラクターが登場する区間では必ずそのキャラクターを @ する。その絵コンテパラグラフに紐付けられたシーン／キャラクター／小道具だけを参照する
+
+## タイムラインのルール
+
+- 区間数 = 絵コンテパラグラフの duration ÷ 3秒（切り上げ）。各区間の時間範囲の合計はパラグラフの総尺と等しくなければならない
+- 内容のリズム：最初の区間で確立 → 中間の区間で動作／衝突を推進 → 最後の区間で結果または感情のポイントに落とす
+
+## 禁止事項
+
+- シーンをまたぐ切り替え、フラッシュバック（1つのパラグラフは1つのシーン内でのみ起こる）
+- リスト外のシーン／キャラクター名の参照
+- 抽象的な心理描写、文学的な比喩（モデルは目に見える画面だけを認識する）
+- セッションの言語指令に合致しない言語
+
+## 保存
+
+`update_storyboard` を呼び出して、その絵コンテパラグラフの `video_prompt` フィールドのみを更新する。他のフィールドは変更せず、話全体を再分解しない。
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.ko.md b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.ko.md
new file mode 100644
index 0000000..ca9f13b
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.ko.md
@@ -0,0 +1,71 @@
+---
+name: video-prompt
+description: 비디오 프롬프트 규범 — 스토리보드 구간 내용을 바탕으로 시간대별로 구간을 나누고 구간 내 컷 전환이 가능한 비디오 생성 프롬프트를 생성
+---
+
+# 비디오 프롬프트(스토리보드 구간 → video_prompt)
+
+단일 스토리보드 구간의 description(【镜头N】 서브 컷 구조와 대사/내레이션 포함)/ atmosphere / duration 을 바탕으로, AI 비디오 생성을 구동하는 `video_prompt` 를 생성합니다. **하나의 스토리보드 구간 = 8-15초짜리 비디오 한 편이며, 내부에서 컷 전환이 허용됩니다**: 구간과 구간 사이는 서로 다른 컷(화면 크기/앵글/대상 변경)일 수 있고 하드 컷으로 연결합니다; 단 **전체 구간이 장면을 넘나들지 않으며**, 플래시백도 없습니다.
+
+## 형식
+
+`video_prompt` 의 **첫 줄은 정보 헤더**입니다: 이 비디오에 어떤 인물과 장면이 있는지 먼저 소개하고, 그다음 시간대별 구간을 이어 씁니다. 인물과 장면은 모두 @ 로 참조합니다(생성 시 해당 참조 이미지 마커로 치환되어, 비디오 모델이 먼저 "누구"인지와 "어디"인지를 맞추도록 함).
+
+```
+출연 인물: @小明, @小红; 장면: @카페.
+0-3초: @카페, 근경 고정 컷. @小明이 휴대폰을 내려다보며 손가락으로 탁자를 반복해 두드리고, 표정이 불안하다.
+3-6초: 문 쪽 전경으로 전환. 문벨이 울리고 @小红이 문을 밀고 들어오며 찬바람을 몰고 온다.
+6-9초: 미디엄샷으로 되돌아온다. @小红이 미소 지으며 小明에게 다가가 앉는다. 小明이 말한다: 「드디어 왔네.」
+```
+
+정보 헤더 규칙:
+- 해당 스토리보드 구간에 실제로 출연하는 인물과 바인딩된 장면만 나열하고, 출연하지 않는 것은 나열하지 마세요
+- 소품이 뚜렷이 등장하면 정보 헤더에 덧붙일 수 있습니다(예: `; 소품: @편지`)
+- 정보 헤더는 한 줄로 독립시키고 마침표로 끝내며, 그다음에 시간대별 구간이 옵니다
+
+3초를 한 구간으로 하고, 구간마다 한 줄씩 줄바꿈으로 구분하며, 시간 범위가 연속으로 이어져야 합니다(겹침 없음, 공백 없음).
+
+## 스토리보드 묘사와의 매핑
+
+`description` 은 video_prompt 의 유일한 내용 출처입니다(화면, 동작, 대사, 내레이션이 모두 그 안에 있음). 변환 규칙:
+
+- `description` 의 각 `【镜头N】`은 **1-2개의 연속된 3초 구간**에 매핑합니다. 순서 일치, 누락 없음, 병합 없음, 새 서브 컷 추가 없음
+- 대사/내레이션은 해당 `【镜头N】` 안의 「캐릭터명이 말한다: 「…」」「내레이션: …」에서 추출해 해당 서브 컷이 매핑된 구간에 배분합니다; **description 밖의 새 대사를 창작하지 마세요**
+- 화면 동작은 `description` 을 기준으로 하고, `atmosphere` 는 각 구간의 조명, 색조, 분위기 묘사를 보충하는 데만 사용합니다
+
+## 구간 내 구조
+
+각 구간은 이 순서로 내용을 조직합니다(내용이 없는 항목은 생략 가능하지만, 동작/화면은 반드시 있어야 함):
+
+**시간 범위 + 장면 @참조 + 화면 크기/카메라 무빙 + 캐릭터 @참조 + 주체 동작·표정 + 대사/내레이션 + 분위기 조명**
+
+- **첫 구간은 반드시 공간을 설정해야 함**: 장면 + 카메라 위치 + 캐릭터의 위치와 상태로, 관객이 한눈에 어디인지, 누구를 보는지 알게 합니다
+- **컷 전환**: 전환 후 구간의 시작에 "~로 전환", "~로 되돌아온다" 같은 연결어를 쓰고, 화면 크기와 주체를 새로 밝힙니다; 컷 전환 지점은 스토리보드 `description` 의 `【镜头N】` 구조에 맞춰야 합니다
+- **화면 크기/카메라 무빙**: 구간마다 하나의 컷 상태(근경/미디엄샷/전경/클로즈업; 고정/푸시인/풀백/팬/팔로우); 하나의 서브 컷 내에서는 무빙이 연속되고, 컷 전환 후에는 무빙 방식을 바꿀 수 있습니다
+- **동작**: 구간마다 하나의 주된 동작. 동사는 구체적이고 보이는 것으로 씁니다(걷기, 몸 돌리기, 고개 들기, 움켜쥐기, 멈칫하기)
+- **감정은 모두 보이는 묘사로 전환**: "그는 슬프다/분위기가 긴장된다" 같은 추상적인 표현 대신, "그가 고개를 숙이고, 손가락이 컵 가장자리를 움켜쥐며, 숨이 거칠어진다"처럼 씁니다
+- **대사/내레이션**: 「캐릭터명이 말한다: 「대사」」로 쓰고, 내레이션은 「내레이션: 내용」으로 씁니다; 3초 안에 다 말할 수 없는 긴 대사는 여러 구간으로 나눕니다; 대사가 없는 구간은 환경음/동작음을 쓸 수 있습니다(예: "기계가 계속 윙윙거린다")
+
+## 참조 규칙
+
+- `@장면명` — 장면 참조. 이름은 장면 목록의 장소와 완전히 일치해야 합니다
+- `@캐릭터명` — 캐릭터 참조. 이름은 캐릭터 목록의 이름과 완전히 일치해야 합니다
+- `@소품명` — 소품 참조. 이름은 소품 목록의 이름과 완전히 일치해야 합니다; 소품이 화면에 뚜렷이 보이거나, 사용되거나, 클로즈업될 때 참조합니다
+- 생성 시 `@이름` 이 해당 참조 이미지 마커로 자동 치환되므로(예: `@小明` → `@图片1小明`), 이름은 반드시 정확히 일치해야 하며 축약하거나 추가 기호를 붙이지 마세요
+- **모든 구간에 최소 하나의 @ 참조로 화면을 고정합니다**; 캐릭터가 출연하는 구간은 반드시 해당 캐릭터를 @ 합니다; 해당 스토리보드 구간에 이미 바인딩된 장면/캐릭터/소품만 참조합니다
+
+## 타임라인 규칙
+
+- 구간 수 = 스토리보드 구간 duration ÷ 3초(올림). 각 구간의 시간 범위를 합하면 반드시 구간 총 길이와 같아야 합니다
+- 내용 리듬: 첫 구간에서 설정 → 중간 구간에서 동작/갈등 추진 → 마지막 구간에서 결과 또는 감정 지점에 도달
+
+## 금지 사항
+
+- 장면을 넘나드는 전환, 플래시백(한 구간은 하나의 장면 안에서만 일어남)
+- 목록 밖의 장면/캐릭터명 참조
+- 추상적인 심리 묘사, 문학적 비유(모델은 보이는 화면만 인식함)
+- 세션 언어 지시와 맞지 않는 언어
+
+## 저장
+
+`update_storyboard` 를 호출해 해당 스토리보드 구간의 `video_prompt` 필드만 갱신합니다. 다른 필드를 변경하지 말고, 전체 화를 다시 분할하지 마세요.
diff --git a/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.md b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.md
new file mode 100644
index 0000000..2ef2ed8
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/prompt-generator/video-prompt/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: video-prompt
+description: 视频提示词规范 — 根据分镜段落内容生成按时间分段、段内可切镜的视频生成提示词
+---
+
+# 视频提示词（分镜段落 → video_prompt）
+
+根据单个分镜段落的 description（含【镜头N】子镜头结构与台词/旁白）/ atmosphere / duration，生成驱动 AI 视频生成的 `video_prompt`。**一个分镜段落 = 一段 8-15 秒的视频，内部允许切镜**：段与段之间可以是不同镜头（换景别/角度/对象），用硬切衔接；但**全程不跨场景**、不闪回。
+
+## 格式
+
+`video_prompt` 的**第一行是信息头**：先介绍这条视频有哪些人物和场景，然后再接时间分段。人物、场景一律用 @ 引用（生成时会替换为对应参考图片标记，让视频模型先对上"谁"和"在哪"）。
+
+```
+出场人物：@小明、@小红；场景：@咖啡厅。
+0-3秒：@咖啡厅，近景固定镜头，@小明低头看手机，手指反复敲桌面，表情焦虑。
+3-6秒：切到门口全景，门铃响，@小红推门走入，带进一阵冷风。
+6-9秒：切回中景，@小红微笑着走向小明坐下，小明说：「你终于来了。」
+```
+
+信息头规则：
+- 只列该分镜段落实际出场的人物和绑定的场景，不要列没出场的
+- 有明显道具出场时可在信息头追加（如 `；道具：@信件`）
+- 信息头独立一行，以句号结尾，之后是时间分段
+
+按 3 秒为一段，每段单独一行、用换行分隔，时间范围连续衔接（无重叠、无空缺）。
+
+## 与分镜描述的映射
+
+`description` 是 video_prompt 的唯一内容来源（画面、动作、台词、旁白都在其中），转换规则：
+
+- `description` 的每个 `【镜头N】` 映射为 **1-2 个连续的 3 秒段**，顺序一致、不遗漏、不合并、不新增子镜头
+- 台词/旁白从对应 `【镜头N】` 内的「角色名说：「…」」「旁白：…」提取，分配到该子镜头映射的段；**不要创作 description 之外的新台词**
+- 画面动作以 `description` 为准；`atmosphere` 只用于补各段的光线、色调与氛围描写
+
+## 段内结构
+
+每一段按此顺序组织内容（可省略无内容的项，但动作/画面必须有）：
+
+**时间范围 ＋ 场景@引用 ＋ 景别/运镜 ＋ 角色@引用＋主体动作·表情 ＋ 对白/旁白 ＋ 氛围光线**
+
+- **第一段必须建立空间**：场景 + 机位 + 角色的位置与状态，让观众一眼知道在哪、看谁
+- **切镜**：切镜后的段开头用"切到/切回"等衔接词，并重新交代景别与主体；切镜点应对齐分镜 `description` 中的 `【镜头N】` 结构
+- **景别/运镜**：每段一个镜头状态（近景/中景/全景/特写；固定/推/拉/摇/跟）；单个子镜头内运镜连续，切镜后可更换运镜方式
+- **动作**：每段一个主动作，动词具体可见（走、转身、抬头、攥紧、停顿）
+- **情绪全部转为可见描写**：不要"他很伤心/气氛紧张"这类抽象词，写成"他低下头、手指攥紧杯沿、呼吸变重"
+- **对白/旁白**：写「角色名说：「台词」」，旁白写「旁白：内容」；3 秒念不完的长台词拆到多段；无对白的段可写环境音/动作音（如"机器持续轰鸣"）
+
+## 引用规则
+
+- `@场景名` — 场景引用，名字必须与场景列表中的地点完全一致
+- `@角色名` — 角色引用，名字必须与角色列表中的名字完全一致
+- `@道具名` — 道具引用，名字必须与道具列表中的名字完全一致；道具在画面中明显可见、被使用或特写时引用
+- 生成时会自动把 `@名字` 替换为对应参考图片标记（如 `@小明` → `@图片1小明`），因此名字必须精确匹配，不要缩写或加额外符号
+- **每段至少一个 @ 引用锚定画面**；角色出场的段必须 @ 该角色；只引用该分镜段落已绑定的场景/角色/道具
+
+## 时间轴规则
+
+- 段数 = 分镜段落 duration ÷ 3 秒（向上取整），各段时间范围相加必须等于段落总时长
+- 内容节奏：第一段建立 → 中段推进动作/冲突 → 末段落到结果或情绪点
+
+## 禁止事项
+
+- 跨场景切换、闪回（一个段落只发生在一个场景内）
+- 引用列表之外的场景/角色名
+- 抽象心理描写、文学化比喻（模型只认可见画面）
+- 语言与会话语言指令不符
+
+## 保存
+
+调用 `update_storyboard` 仅更新该分镜段落的 `video_prompt` 字段，不要改动其他字段，不要重新拆分整集。
diff --git a/huobao-source/backend/workspace/skills/script-rewriter/SKILL.en.md b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.en.md
new file mode 100644
index 0000000..8474724
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.en.md
@@ -0,0 +1,56 @@
+---
+name: script-rewriter
+description: Methodology and rules for rewriting a novel into a formatted script
+---
+
+# Script Rewriting Guide
+
+## Rewriting Principles
+
+1. **Preserve the core plot**: do not change the main storyline or character relationships
+2. **Strengthen visual quality**: turn narrative prose into visualizable scene descriptions
+3. **Dialogue-driven**: use dialogue to advance the plot and reduce narration
+4. **Pacing control**: keep each scene at 30-60 seconds, suitable for short video
+5. **No camera language**: no shot sizes, angles, or camera moves — those belong to the storyboard-breakdown step
+
+## Formatted-Script Format
+
+```
+## S01 | INT · Coffee Shop | Dusk
+
+Dusk light pours through the floor-to-ceiling windows into the coffee shop; steam rises from coffee cups on the counter.
+
+Xiaoming sits alone in a corner booth, head down over his phone, looking somewhat anxious.
+
+The doorbell chimes as Xiaohong pushes the door open. She sees Xiaoming and walks over with a smile.
+
+Xiaohong: (smiling) Have you been waiting long?
+Xiaoming: (looking up) Not really, just got here.
+```
+
+### Format Rules
+
+- `## S<number> | INT/EXT · Location | Time period` — scene heading
+- Action description in natural paragraphs — no camera language of any kind
+- `CharacterName: (state/expression) line content` — dialogue format
+
+### Content-Volume Reference
+
+The formatted script is about 20-30% longer than the original content; the increase mainly comes from scene-heading markers and dialogue formatting, not from expansion writing.
+
+## Rewriting Steps
+
+1. First call `read_episode_script` to read the original content
+2. Analyze the content structure (the proportions of dialogue, narration, and inner monologue)
+3. Call `rewrite_to_screenplay` to perform the rewriting
+4. Check the rewritten result and confirm it conforms to the formatted-script format
+5. Call `save_script` to save the final result
+
+## Notes
+
+- Inner monologue can be converted into character expressions/actions or voiceover
+- Split long narrative passages into multiple short scenes
+- Make sure every scene has a clear emotional turning point
+- Keep each character's language style consistent
+- Scene numbers increase consecutively (S01, S02, S03...)
+- Time periods must be specific (dusk, late night, early morning) — do not write a vague "daytime"
diff --git a/huobao-source/backend/workspace/skills/script-rewriter/SKILL.ja.md b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.ja.md
new file mode 100644
index 0000000..9401a37
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.ja.md
@@ -0,0 +1,56 @@
+---
+name: script-rewriter
+description: 小説をフォーマット済み脚本にリライトする方法論と仕様
+---
+
+# 脚本リライトガイド
+
+## リライトの原則
+
+1. **中核となるプロットを保持**：主軸の物語とキャラクター関係を変えない
+2. **絵としての説得力を強化**：叙述的な文章を可視化できるシーン描写に変換する
+3. **対話で駆動**：セリフで物語を進め、ナレーションを減らす
+4. **リズムの管理**：各シーンを30〜60秒に収め、短編動画に適したものにする
+5. **カメラ言語を書かない**：ショットサイズ、アングル、カメラワークには触れない。これらは絵コンテ分解のステップに属する
+
+## フォーマット済み脚本の形式
+
+```
+## S01 | 内景 · カフェ | 夕暮れ
+
+夕暮れの光が大きな窓からカフェに差し込み、カウンターのコーヒーカップから湯気が立ち上っている。
+
+小明はひとりで隅のボックス席に座り、俯いてスマホを見ている。表情はどこか不安そうだ。
+
+ドアベルが鳴り、小红がドアを押して入ってくる。彼女は小明を見つけ、微笑みながら歩み寄る。
+
+小红：（微笑み）ずっと待ってた？
+小明：（顔を上げて）ううん、さっき着いたところ。
+```
+
+### フォーマットのルール
+
+- `## S番号 | 内景/外景 · 場所 | 時間帯` — シーンヘッダー
+- 動作描写は自然な段落 — いかなるカメラ言語も含めない
+- `キャラクター名：（状態／表情）セリフ内容` — セリフの形式
+
+### 内容量の目安
+
+フォーマット済み脚本は元の内容より約20〜30%増量する。主な増分はシーンヘッダーのマーカーとセリフのフォーマット化であり、水増しの加筆ではない。
+
+## リライトの手順
+
+1. まず `read_episode_script` を呼び出して元の内容を読み込む
+2. 内容の構造を分析する（対話、叙述、心理描写の比率）
+3. `rewrite_to_screenplay` を呼び出してリライトを実行する
+4. リライト結果をチェックし、フォーマット済み脚本の形式に合致することを確認する
+5. `save_script` を呼び出して最終結果を保存する
+
+## 注意事項
+
+- 心理描写はキャラクターの表情／動作、または画外音（ボイスオーバー）に変換できる
+- 長い叙述は複数の短いシーンに分割する
+- 各シーンに明確な感情の転換点を持たせる
+- キャラクターの話し方の一貫性を保つ
+- シーン番号は連続して増加させる（S01, S02, S03...）
+- 時間帯は具体的に書く（夕暮れ、深夜、早朝）。大雑把に「昼」と書かない
diff --git a/huobao-source/backend/workspace/skills/script-rewriter/SKILL.ko.md b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.ko.md
new file mode 100644
index 0000000..2f73d1e
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.ko.md
@@ -0,0 +1,56 @@
+---
+name: script-rewriter
+description: 소설을 포맷된 대본으로 리라이팅하는 방법론과 규범
+---
+
+# 대본 리라이팅 가이드
+
+## 리라이팅 원칙
+
+1. **핵심 줄거리 보존**: 메인 스토리와 캐릭터 관계를 바꾸지 않습니다
+2. **화면감 강화**: 서술적 문장을 시각화 가능한 장면 묘사로 전환합니다
+3. **대화 중심**: 대사로 줄거리를 추진하고 내레이션을 줄입니다
+4. **리듬 조절**: 각 장면을 30-60초로 조절해 숏폼 영상에 맞춥니다
+5. **카메라 언어 금지**: 화면 크기, 앵글, 카메라 무빙을 다루지 않습니다 — 이는 스토리보드 분할 단계에 속합니다
+
+## 포맷된 대본 형식
+
+```
+## S01 | 실내 · 카페 | 황혼
+
+황혼의 빛이 통유리창을 통해 카페 안으로 쏟아지고, 바 위의 커피잔에서 김이 모락모락 오른다.
+
+小明은 홀로 구석 부스에 앉아 휴대폰을 내려다보며, 표정이 다소 불안하다.
+
+문벨이 울리고 小红이 문을 밀고 들어온다. 그녀는 小明을 보고 미소 지으며 다가간다.
+
+小红:(미소) 오래 기다렸어?
+小明:(고개를 들며) 아니, 나도 방금 왔어.
+```
+
+### 형식 규칙
+
+- `## S번호 | 실내/실외 · 장소 | 시간대` — 장면 헤더
+- 동작 묘사는 자연스러운 문단 — 어떤 카메라 언어도 포함하지 않음
+- `캐릭터명:(상태/표정) 대사 내용` — 대사 형식
+
+### 내용량 참고
+
+포맷된 대본은 원본 내용 대비 약 20-30% 증가하며, 주된 증가분은 장면 헤더 마커와 대사 포맷팅이지 내용 확장이 아닙니다.
+
+## 리라이팅 절차
+
+1. 먼저 `read_episode_script` 를 호출해 원본 내용을 읽습니다
+2. 내용 구조를 분석합니다(대화, 서술, 심리 묘사의 비율)
+3. `rewrite_to_screenplay` 를 호출해 리라이팅을 실행합니다
+4. 리라이팅 결과를 확인해 포맷된 대본 형식에 부합하는지 검토합니다
+5. `save_script` 를 호출해 최종 결과를 저장합니다
+
+## 주의 사항
+
+- 심리 묘사는 캐릭터의 표정/동작 또는 화면 밖 목소리로 전환할 수 있습니다
+- 긴 서술 문단은 여러 짧은 장면으로 나눕니다
+- 각 장면에 명확한 감정 전환점이 있도록 합니다
+- 캐릭터의 말투 스타일 일관성을 유지합니다
+- 장면 번호는 연속 증가(S01, S02, S03...)
+- 시간대는 구체적으로 씁니다(황혼, 심야, 이른 아침). "낮"처럼 대략적으로 쓰지 마세요
diff --git a/huobao-source/backend/workspace/skills/script-rewriter/SKILL.md b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.md
new file mode 100644
index 0000000..f95c8fc
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/script-rewriter/SKILL.md
@@ -0,0 +1,56 @@
+---
+name: script-rewriter
+description: 小说改写为格式化剧本的方法论和规范
+---
+
+# 剧本改写指南
+
+## 改写原则
+
+1. **保留核心情节**：不改变主线故事和角色关系
+2. **增强画面感**：将叙述性文字转化为可视化的场景描写
+3. **对话驱动**：用对白推动情节，减少旁白
+4. **节奏把控**：每场戏控制在 30-60 秒，适合短视频
+5. **不写镜头语言**：不涉及景别、角度、运镜，这些属于分镜拆解步骤
+
+## 格式化剧本格式
+
+```
+## S01 | 内景 · 咖啡厅 | 黄昏
+
+黄昏的光线透过落地窗洒进咖啡厅，吧台上咖啡杯热气升腾。
+
+小明独自坐在角落卡座，低头看手机，神情有些焦虑。
+
+门铃响起，小红推门而入。她看到小明，微笑着走过去。
+
+小红：（微笑）等很久了吗？
+小明：（抬头）还好，刚到。
+```
+
+### 格式规则
+
+- `## S编号 | 内景/外景 · 地点 | 时间段` — 场景头
+- 动作描写自然段 — 不包含任何镜头语言
+- `角色名：（状态/表情）台词内容` — 对白格式
+
+### 内容量参考
+
+格式化剧本相比原始内容增加约 20-30%，主要增量是场景头标记和对白格式化，不是扩写。
+
+## 改写步骤
+
+1. 先调用 `read_episode_script` 读取原始内容
+2. 分析内容结构（对话、叙述、心理描写的比例）
+3. 调用 `rewrite_to_screenplay` 执行改写
+4. 检查改写结果，确认符合格式化剧本格式
+5. 调用 `save_script` 保存最终结果
+
+## 注意事项
+
+- 心理描写可转化为角色表情/动作或画外音
+- 长段叙述拆分为多个短场景
+- 确保每个场景有明确的情绪转折点
+- 保持角色语言风格一致性
+- 场景编号连续递增（S01, S02, S03...）
+- 时间段要具体（黄昏、深夜、清晨），不要笼统写"白天"
diff --git a/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.en.md b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.en.md
new file mode 100644
index 0000000..f978802
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.en.md
@@ -0,0 +1,83 @@
+---
+name: storyboard-breaker
+description: Professional rules for storyboard breakdown — splitting a script into storyboard segments that each carry multiple sub-shots
+---
+
+# Storyboard Breakdown Guide
+
+## Core Definition: Storyboard Segment
+
+One storyboard = one **storyboard segment** = one video-generation task.
+
+- Each segment is **8-15 seconds** long and internally carries **2-4 sub-shots**
+- Cuts between sub-shots **are allowed**: change shot size, angle, or subject, joined with hard cuts
+- Sub-shots **never cross scenes**: a segment takes place in a single scene (`scene_id` is a segment-level binding)
+- Each sub-shot is 2-6 seconds, focused on one visual unit (one action, one reaction, one close-up)
+
+## Breakdown Process (Four Steps)
+
+1. Call `read_storyboard_context` to read the script, characters, scenes, props, and existing storyboard summaries
+2. **Beat identification**: first identify the script's narrative beats — markers such as [Opening] [Trigger] [Climax] [Resolution], or narrative turning points (location changes, rule reveals, emotional eruptions, reversals). **Beat boundaries force a segment cut**; group sub-shots within the same beat into the same segment where possible, and do not scatter a causal chain (setup-event-reaction) across different segments
+3. **Total-volume anchoring**: target total duration = script character count ÷ 500 characters/minute; segment count ≈ target total duration ÷ 12 seconds, with ±20% tolerance. Do not significantly overshoot or undershoot
+4. **Split sub-shots within each segment**: cut sub-shots at action-change points, viewpoint-change points, and subject-change points; after filling in all fields for each segment, call `save_storyboards` to save them in one go
+
+## Pacing-Tier Durations
+
+Determine duration by the segment's function — do not use one size for all:
+
+| Segment type | Duration | Notes |
+|---|---|---|
+| Transition segment | 8-10 s | Traveling, empty shots, environment establishment, transitions |
+| Narrative segment | 10-15 s | Regular plot advancement, dialogue |
+| Payoff segment | 12-15 s | Close-ups, rule reveals, emotional eruptions, reversals; slower sub-shot pacing, a single sub-shot may hold for 4-6 s |
+
+## Dialogue Duration Floor (Hard Rule)
+
+**Segment duration ≥ total character count of dialogue and narration within the segment (the part written in description) ÷ 4.5 characters/second + 2 seconds of performance headroom**
+
+Dialogue that does not fit must be moved to the next segment; cramming unperformable dialogue into one segment is not allowed.
+
+## Shot Elements
+
+1. **Shot title**: a 3-5-character summary of the segment's core content (e.g. "Nightmare Awakening")
+2. **Time**: specific time of day + lighting description
+3. **Location**: full scene description + spatial layout + environmental details
+4. **Shot size**: the dominant shot size of the segment; for multi-size segments write a combination, e.g. "medium shot + close-up"
+5. **Angle**: eye-level / low angle / high angle / side / back
+6. **Camera move**: static / push-in / pull-back / pan / tracking / dolly (different sub-shots within a segment may differ)
+7. **Visual description** `description`: describe sub-shot by sub-shot as `【镜头1】…【镜头2】…` what the audience actually sees and hears — the visuals (who + specific action + body-language details + expression) come first; when a sub-shot has dialogue, write it inside the corresponding `【镜头N】` as "CharacterName says: "line"", and narration as "Narration: content"
+8. **Visual result** `result`: the immediate consequence at the end of the segment + visual details
+9. **Atmosphere** `atmosphere`: lighting + color tone + sound + overall mood
+10. **Duration** `duration`: total segment duration 8-15 seconds, and it must satisfy the dialogue duration floor
+11. **Scene binding**: if it can be matched to an existing scene, `scene_id` must be filled in
+12. **Character binding**: fill in `character_ids`, binding 0 to multiple characters involved in this segment
+13. **Prop binding**: fill in `prop_ids`, binding 0 to multiple key props appearing in this segment
+
+## Scene Binding Rules
+
+- Prefer the `scenes` returned by `read_storyboard_context`
+- When `location + time` can be clearly matched, the correct `scene_id` must be filled in
+- Do not fabricate scene IDs that do not exist
+- If the script content clearly falls within an existing scene, do not create a duplicate new scene description
+
+## Character Binding Rules
+
+- `character_ids` must be chosen from the character list returned by `read_storyboard_context`
+- A segment may have no characters, or may bind multiple characters
+- Any character with a clear appearance in the segment — seen, acting, or speaking — should be bound
+- Pure-environment segments, empty shots, and object close-ups may pass an empty array
+
+## Prop Binding Rules
+
+- `prop_ids` must be chosen from the prop list (`props`) returned by `read_storyboard_context`
+- When a prop is used by a character, handed over, shown in close-up, or clearly visible in frame and meaningful to the narrative, it must be bound to that segment
+- Prop close-up segments (without characters) should also bind the prop; `character_ids` may be empty
+- Do not bind background items or set dressing irrelevant to the plot; segments with no props pass an empty array
+- Bound props serve as reference images for video generation (white-background product shots), keeping the prop's appearance consistent across segments
+
+## Quality Requirements
+
+- `description` should be human-readable, describing sub-shot by sub-shot what the audience actually sees and hears; dialogue/narration is written directly inside the corresponding `【镜头N】`
+- `image_prompt` should highlight the single-frame composition, character appearance, environment, and lighting (corresponding to the segment's first sub-shot)
+- `bgm_prompt` and `sound_effect` may be concise phrases, but must not be as vague as just "tense" or "sad"
+- To make adjustments, call `update_storyboard` to modify the specific segment
diff --git a/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.ja.md b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.ja.md
new file mode 100644
index 0000000..5081ca5
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.ja.md
@@ -0,0 +1,83 @@
+---
+name: storyboard-breaker
+description: 絵コンテ分解のプロ仕様 — 脚本を複数のサブカットを収める絵コンテパラグラフに分割する
+---
+
+# 絵コンテ分解ガイド
+
+## 中核の定義：絵コンテパラグラフ
+
+1つの絵コンテ = 1つの **絵コンテパラグラフ**（segment）= 1つの動画生成タスク。
+
+- 各パラグラフの尺は **8〜15秒** で、内部に **2〜4個のサブカット** を収める
+- サブカット間では**カット切り替えが可能**：ショットサイズ、アングル、被写体を変え、ハードカットでつなぐ
+- サブカット間で**シーンをまたがない**：1つのパラグラフは1つのシーン内でのみ起こる（`scene_id` はパラグラフ単位の紐付け）
+- 各サブカットは2〜6秒で、1つの画面ユニット（1つの動作、1つの反応、1つのクローズアップ）に焦点を当てる
+
+## 分解フロー（4ステップ）
+
+1. `read_storyboard_context` を呼び出して、脚本、キャラクター、シーン、小道具、既存絵コンテの要約を読み込む
+2. **拍（ビート）の識別**：まず脚本の物語の拍を識別する——脚本中の【开场】【触发】【高潮】【收尾】などのマーカー、または物語の転換点（場所の移動、ルール開示、感情の爆発、どんでん返し）。**拍の境界では強制的に区切る**。同じ拍内のサブカットは優先的に同じパラグラフにまとめ、1つの因果チェーン（布石-発生-反応）を異なるパラグラフに切り散らかさない
+3. **総量のアンカー**：目標総尺 = 脚本の文字数 ÷ 500字/分。パラグラフ数 ≈ 目標総尺 ÷ 12秒。±20%の変動を許容。明らかに超過・不足しないこと
+4. **パラグラフ内のサブカット分割**：動作の切り替わり点、視点の切り替わり点、被写体の切り替わり点でサブカットを分割し、各パラグラフに完全なフィールドを補完してから `save_storyboards` を呼び出して一括保存する
+
+## リズム階層別の尺
+
+パラグラフの機能に応じて尺を決め、一律にしない：
+
+| パラグラフの種類 | 尺 | 説明 |
+|---|---|---|
+| つなぎの段落 | 8〜10秒 | 移動、空カット、環境の提示、場面転換 |
+| 物語の段落 | 10〜15秒 | 通常の物語の推進、対話 |
+| 山場の段落 | 12〜15秒 | クローズアップ、ルール開示、感情の爆発、どんでん返し。サブカットのリズムを落とし、1つのサブカットに4〜6秒留めることができる |
+
+## セリフの尺の下限（硬いルール）
+
+**パラグラフの尺 ≥ パラグラフ内のセリフとナレーションの総文字数（description に書かれた部分）÷ 4.5字/秒 ＋ 2秒の演技余裕**
+
+収まりきらないセリフは必ず次のパラグラフに振り分ける。演じきれないセリフを1つのパラグラフに詰め込むことは許されない。
+
+## カットの要素
+
+1. **カットのタイトル**：パラグラフの中核内容を3〜5字で概括（例：「悪夢で目覚める」）
+2. **時間**：具体的な時刻 ＋ 光線の描写
+3. **場所**：シーンの完全な描写 ＋ 空間構成 ＋ 環境の細部
+4. **ショットサイズ**：パラグラフ内で主導するショットサイズ。複数ショットサイズのパラグラフは組み合わせで書く（例：「ミディアム＋クローズアップ」）
+5. **アングル**：目線／仰角／俯瞰／側面／背面
+6. **カメラワーク**：固定／プッシュイン／プルバック／パン／フォロー／移動（パラグラフ内のサブカットごとに異なってよい）
+7. **画面描写** `description`：`【镜头1】…【镜头2】…` とサブカットごとに、観客が実際に見て聞く内容を記述する——画面（誰 ＋ 具体的な動作 ＋ 体の細部 ＋ 表情）を先に書く。そのサブカットにセリフがある場合は「キャラクター名は言う：「セリフ」」を対応する `【镜头N】` 内に書き、ナレーションは「ナレーション：内容」と書く
+8. **画面の結果** `result`：パラグラフ末尾の即時の結果 ＋ 視覚的な細部
+9. **雰囲気** `atmosphere`：光線 ＋ 色調 ＋ 音 ＋ 全体の雰囲気
+10. **尺** `duration`：パラグラフの総尺 8〜15秒。かつセリフの尺の下限を満たすこと
+11. **シーンの関連付け**：既存シーンにマッチできる場合は、必ず `scene_id` を記入する
+12. **キャラクターの関連付け**：`character_ids` を記入し、現在のパラグラフに関わる0個以上のキャラクターを紐付ける
+13. **小道具の関連付け**：`prop_ids` を記入し、現在のパラグラフに登場する重要な小道具（0個以上）を紐付ける
+
+## シーン関連付けのルール
+
+- `read_storyboard_context` が返す `scenes` を優先的に使用する
+- `location + time` で明確にマッチできる場合は、必ず正しい `scene_id` を埋め戻す
+- 存在しないシーンIDをでたらめに生成しない
+- 脚本の内容が明らかに既存シーンに収まる場合、新しいシーン描写を重複して作らない
+
+## キャラクター紐付けのルール
+
+- `character_ids` は必ず `read_storyboard_context` が返すキャラクターリストから選ぶ
+- 1つのパラグラフはキャラクターなしでもよいし、複数のキャラクターを紐付けてもよい
+- パラグラフ内で明確に登場し、見え、動作し、または話すキャラクターはすべて紐付ける
+- 純粋な環境のパラグラフ、空カット、物品のクローズアップは空の配列を渡してよい
+
+## 小道具紐付けのルール
+
+- `prop_ids` は必ず `read_storyboard_context` が返す小道具リスト（`props`）から選ぶ
+- 小道具がキャラクターに使われる、受け渡される、クローズアップされる、または画面内で明確に見えて物語上の意味がある場合は、必ずそのパラグラフに紐付ける
+- 小道具のクローズアップのパラグラフ（キャラクターなし）も小道具を紐付ける。`character_ids` は空でよい
+- 物語と無関係な背景物品、シーンの調度品は紐付けない。小道具が登場しないパラグラフは空の配列を渡す
+- 紐付けられた小道具は動画生成の参照画像（白背景の単品画像）として使われ、パラグラフをまたいで小道具の外観の一貫性を保証する
+
+## 品質要件
+
+- `description` は人が読みやすいものにし、サブカットごとに観客が実際に見て聞く内容を詳細に記述する。セリフ／ナレーションは対応する `【镜头N】` 内に直接書く
+- `image_prompt` は単一フレームの構図、キャラクターの外観、環境、光線を際立たせる（パラグラフの最初のサブカットに対応）
+- `bgm_prompt` と `sound_effect` は簡潔なフレーズでよいが、「緊張」「悲しみ」だけのような空虚なものにしない
+- 調整が必要な場合は `update_storyboard` を呼び出して該当パラグラフを修正する
diff --git a/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.ko.md b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.ko.md
new file mode 100644
index 0000000..63c1c41
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.ko.md
@@ -0,0 +1,83 @@
+---
+name: storyboard-breaker
+description: 스토리보드 분할 전문 규범 — 대본을 여러 서브 컷을 담을 수 있는 스토리보드 구간으로 분할
+---
+
+# 스토리보드 분할 가이드
+
+## 핵심 정의: 스토리보드 구간
+
+하나의 스토리보드 = 하나의 **스토리보드 구간**(segment) = 하나의 비디오 생성 작업.
+
+- 각 구간은 **8-15초**이며, 내부에 **2-4개의 서브 컷**을 담습니다
+- 서브 컷 사이에서는 **컷 전환 가능**: 화면 크기, 앵글, 촬영 대상을 바꾸고 하드 컷으로 연결합니다
+- 서브 컷 사이에서는 **장면을 넘나들지 않음**: 한 구간은 하나의 장면 안에서만 일어납니다(`scene_id` 는 구간 단위 바인딩)
+- 각 서브 컷은 2-6초로, 하나의 화면 단위(하나의 동작, 하나의 반응, 하나의 클로즈업)에 집중합니다
+
+## 분할 흐름(4단계)
+
+1. `read_storyboard_context` 를 호출해 대본, 캐릭터, 장면, 소품, 기존 스토리보드 요약을 읽습니다
+2. **박자 식별**: 먼저 대본의 서사 박자를 식별합니다 — 대본 속 【오프닝】【촉발】【클라이맥스】【마무리】 등의 마커, 또는 서사 전환점(장소 이동, 규칙 공개, 감정 폭발, 반전). **박자 경계에서는 반드시 구간을 자르고**, 같은 박자 안의 서브 컷은 같은 구간에 우선 배치하며, 하나의 인과 사슬(복선-발생-반응)을 서로 다른 구간으로 쪼개지 않습니다
+3. **총량 앵커링**: 목표 총 길이 = 대본 글자 수 ÷ 500자/분; 구간 수 ≈ 목표 총 길이 ÷ 12초, ±20% 범위 내 변동 허용. 눈에 띄게 초과하거나 부족하지 않게 합니다
+4. **구간 내 서브 컷 분할**: 동작 전환점, 시점 전환점, 대상 전환점을 기준으로 서브 컷을 나누고, 각 구간의 전체 필드를 채운 뒤 `save_storyboards` 를 호출해 한 번에 저장합니다
+
+## 리듬 계층별 길이
+
+구간의 기능에 따라 길이를 정하며, 획일적으로 하지 마세요:
+
+| 구간 유형 | 길이 | 설명 |
+|---|---|---|
+| 전이 구간 | 8-10초 | 이동, 빈 장면, 환경 설정, 전환 |
+| 서사 구간 | 10-15초 | 일반적인 줄거리 진행, 대화 |
+| 클라이맥스 구간 | 12-15초 | 클로즈업, 규칙 공개, 감정 폭발, 반전; 서브 컷 리듬을 늦춰 하나의 서브 컷이 4-6초 머무를 수 있음 |
+
+## 대사 길이 하한(엄격한 규칙)
+
+**구간 길이 ≥ 구간 내 대사와 내레이션 총 글자 수(description 에 적힌 부분) ÷ 4.5자/초 + 2초 연기 여유분**
+
+담을 수 없는 대사는 반드시 다음 구간으로 나누며, 다 소화할 수 없는 대사를 한 구간에 욱여넣는 것은 허용되지 않습니다.
+
+## 컷 요소
+
+1. **컷 제목**: 구간의 핵심 내용을 3-5자로 요약(예: "악몽에서 깨어남")
+2. **시간**: 구체적인 시각 + 조명 묘사
+3. **장소**: 장면 전체 묘사 + 공간 배치 + 환경 디테일
+4. **화면 크기**: 구간 내 주도 화면 크기; 여러 화면 크기의 구간은 조합으로 씁니다(예: "미디엄샷+클로즈업")
+5. **앵글**: 정면/로우 앵글/하이 앵글/측면/후면
+6. **카메라 무빙**: 고정/푸시인/풀백/팬/팔로우/트래킹(구간 내 서브 컷마다 다를 수 있음)
+7. **화면 묘사** `description`: `【镜头1】…【镜头2】…` 형식으로 서브 컷별로 관객이 실제로 보고 듣는 내용을 서술합니다 — 화면(누가 + 구체적 동작 + 신체 디테일 + 표정)을 먼저 씁니다; 해당 서브 컷에 대사가 있으면 「캐릭터명이 말한다: 「대사」」 형식으로 해당 `【镜头N】` 안에 쓰고, 내레이션은 「내레이션: 내용」으로 씁니다
+8. **화면 결과** `result`: 구간 끝의 즉각적인 결과 + 시각 디테일
+9. **분위기** `atmosphere`: 조명 + 색조 + 소리 + 전체 분위기
+10. **길이** `duration`: 구간 총 길이 8-15초, 대사 길이 하한을 충족해야 함
+11. **장면 연결**: 기존 장면과 매칭되면 반드시 `scene_id` 를 채웁니다
+12. **캐릭터 연결**: `character_ids` 를 채워 현재 구간에 관련된 0명 이상의 캐릭터를 바인딩합니다
+13. **소품 연결**: `prop_ids` 를 채워 현재 구간에 등장하는 핵심 소품(0개 이상)을 바인딩합니다
+
+## 장면 연결 규칙
+
+- `read_storyboard_context` 가 반환한 `scenes` 를 우선 사용합니다
+- `location + time` 으로 명확히 매칭되면 반드시 올바른 `scene_id` 를 채워 넣습니다
+- 존재하지 않는 장면 ID를 임의로 만들지 마세요
+- 대본 내용이 기존 장면에 명백히 해당하면 새 장면 묘사를 중복 생성하지 마세요
+
+## 캐릭터 바인딩 규칙
+
+- `character_ids` 는 반드시 `read_storyboard_context` 가 반환한 캐릭터 목록에서 선택해야 합니다
+- 한 구간에 캐릭터가 없을 수도 있고, 여러 캐릭터를 바인딩할 수도 있습니다
+- 구간에 명확히 출연하거나, 보이거나, 동작하거나, 말하는 캐릭터가 있으면 모두 바인딩해야 합니다
+- 순수 환경 구간, 빈 장면, 사물 클로즈업은 빈 배열을 전달할 수 있습니다
+
+## 소품 바인딩 규칙
+
+- `prop_ids` 는 반드시 `read_storyboard_context` 가 반환한 소품 목록(`props`)에서 선택해야 합니다
+- 소품이 캐릭터에 의해 사용되거나, 전달되거나, 클로즈업되거나, 화면에 뚜렷이 보이며 서사적으로 의미가 있을 때 반드시 해당 구간에 바인딩합니다
+- 소품 클로즈업 구간(캐릭터 없음)도 소품을 바인딩해야 하며, `character_ids` 는 비워 둘 수 있습니다
+- 줄거리와 무관한 배경 물건, 장면 비품은 바인딩하지 마세요; 소품이 등장하지 않는 구간은 빈 배열을 전달합니다
+- 바인딩된 소품은 비디오 생성의 참조 이미지(화이트 배경 단품 이미지)로 사용되어, 소품의 외형이 구간을 넘어 일관되게 유지됩니다
+
+## 품질 요구 사항
+
+- `description` 은 사람이 읽기에 적합해야 하며, 서브 컷별로 관객이 실제로 보고 듣는 내용을 상세히 서술합니다; 대사/내레이션은 해당 `【镜头N】` 안에 직접 씁니다
+- `image_prompt` 는 단일 프레임 구도, 캐릭터 외형, 환경과 조명을 부각해야 합니다(구간의 첫 번째 서브 컷에 대응)
+- `bgm_prompt` 와 `sound_effect` 는 간결한 구문으로 쓰되, "긴장" "슬픔"만으로 끝날 만큼 공허해서는 안 됩니다
+- 조정이 필요하면 `update_storyboard` 를 호출해 특정 구간을 수정합니다
diff --git a/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.md b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.md
new file mode 100644
index 0000000..6cc87e8
--- /dev/null
+++ b/huobao-source/backend/workspace/skills/storyboard-breaker/SKILL.md
@@ -0,0 +1,83 @@
+---
+name: storyboard-breaker
+description: 分镜拆解专业规范 — 将剧本拆分为可承载多个子镜头的分镜段落
+---
+
+# 分镜拆解指南
+
+## 核心定义：分镜段落
+
+一个分镜 = 一个 **分镜段落**（segment）= 一个视频生成任务。
+
+- 每个段落时长 **8-15 秒**，内部承载 **2-4 个子镜头**
+- 子镜头之间**可以切镜**：换景别、换角度、换拍摄对象，用硬切衔接
+- 子镜头之间**不跨场景**：一个段落只发生在一个场景内（`scene_id` 是段落级绑定）
+- 每个子镜头 2-6 秒，聚焦一个画面单元（一个动作、一个反应、一个特写）
+
+## 拆分流程（四步）
+
+1. 调用 `read_storyboard_context` 读取剧本、角色、场景、道具、已有分镜摘要
+2. **节拍识别**：先识别剧本的叙事节拍——剧本中的【开场】【触发】【高潮】【收尾】等标记，或叙事转折点（地点转移、规则揭示、情绪爆发、反转）。**节拍边界强制切段**，同一节拍内的子镜头优先归入同一段落，不把一条因果链（铺垫-发生-反应）切散到不同段落
+3. **总量锚定**：目标总时长 = 剧本字数 ÷ 500字/分钟；段落数 ≈ 目标总时长 ÷ 12秒，允许 ±20% 浮动。不要明显超出或不足
+4. **段落内拆子镜头**：按动作切换点、视角切换点、对象切换点切分子镜头，为每个段落补全完整字段后调用 `save_storyboards` 一次性保存
+
+## 节奏分层时长
+
+按段落功能确定时长，不要一刀切：
+
+| 段落类型 | 时长 | 说明 |
+|---|---|---|
+| 过渡段 | 8-10 秒 | 赶路、空镜、环境建立、转场 |
+| 叙事段 | 10-15 秒 | 常规剧情推进、对话 |
+| 爆点段 | 12-15 秒 | 特写、规则揭示、情感爆发、反转；子镜头节奏放慢，单个子镜头可停留 4-6 秒 |
+
+## 台词时长下限（硬规则）
+
+**段落时长 ≥ 段内台词与旁白总字数（写在 description 中的部分）÷ 4.5字/秒 + 2秒表演余量**
+
+装不下的台词必须拆到下一个段落，不允许把演不完的台词塞进一个段落。
+
+## 镜头要素
+
+1. **镜头标题**：3-5字概括段落核心内容（如"噩梦惊醒"）
+2. **时间**：具体时分 + 光线描述
+3. **地点**：场景完整描述 + 空间布局 + 环境细节
+4. **景别**：段落内主导景别；多景别段落写组合，如"中景+特写"
+5. **角度**：平视/仰视/俯视/侧面/背面
+6. **运镜**：固定/推镜/拉镜/摇镜/跟镜/移镜（段落内不同子镜头可不同）
+7. **画面描述** `description`：按 `【镜头1】…【镜头2】…` 逐子镜头描述观众实际看到和听到的内容——画面（谁 + 具体动作 + 肢体细节 + 表情）写在前；该子镜头有台词时以「角色名说：「台词」」写在对应 `【镜头N】` 内，旁白写「旁白：内容」
+8. **画面结果** `result`：段落结尾的即时后果 + 视觉细节
+9. **氛围** `atmosphere`：光线 + 色调 + 声音 + 整体氛围
+10. **时长** `duration`：段落总时长 8-15 秒，且满足台词时长下限
+11. **场景关联**：若能匹配已有场景，必须填写 `scene_id`
+12. **角色关联**：填写 `character_ids`，绑定当前段落涉及的 0 到多个角色
+13. **道具关联**：填写 `prop_ids`，绑定当前段落出现的关键道具（0 到多个）
+
+## 场景关联规则
+
+- 优先使用 `read_storyboard_context` 返回的 `scenes`
+- `location + time` 可明确匹配时，必须回填正确 `scene_id`
+- 不要凭空生成不存在的场景 ID
+- 如果剧本内容明显落在已有场景中，不要重复创造新场景描述
+
+## 角色绑定规则
+
+- `character_ids` 必须从 `read_storyboard_context` 返回的角色列表中选择
+- 一个段落可以没有角色，也可以绑定多个角色
+- 只要段落里有明确出场、被看见、发生动作或说话的角色，都应绑定进去
+- 纯环境段落、空镜、物件特写可以传空数组
+
+## 道具绑定规则
+
+- `prop_ids` 必须从 `read_storyboard_context` 返回的道具列表（`props`）中选择
+- 道具被角色使用、交接、特写，或在画面中明显可见且对叙事有意义时，必须绑定到该段落
+- 道具特写段落（无角色）也应绑定道具，`character_ids` 可为空
+- 与剧情无关的背景物品、场景陈设不要绑定；没有道具出现的段落传空数组
+- 绑定的道具会作为视频生成的参考图（白底单品图），保证道具外观跨段落一致
+
+## 质量要求
+
+- `description` 要适合人读，按子镜头详细描述观众实际看到和听到的内容；台词/旁白直接写在对应 `【镜头N】` 内
+- `image_prompt` 要突出单帧构图、角色外观、环境和光线（对应段落第一个子镜头）
+- `bgm_prompt` 和 `sound_effect` 用简洁短语即可，但不能空泛到只有“紧张”“悲伤”
+- 如需调整，调用 `update_storyboard` 修改具体段落
diff --git a/huobao-source/configs/config.example.yaml b/huobao-source/configs/config.example.yaml
new file mode 100644
index 0000000..5d5b5af
--- /dev/null
+++ b/huobao-source/configs/config.example.yaml
@@ -0,0 +1,29 @@
+app:
+  name: "Huobao Drama API"
+  version: "1.0.0"
+  debug: true
+  language: "zh" # 系统语言：zh(中文) 或 en(英文)
+
+server:
+  port: 5678
+  host: "0.0.0.0"
+  cors_origins:
+    - "http://localhost:3012"
+  read_timeout: 600
+  write_timeout: 600
+
+database:
+  type: "mysql"
+  url: "mysql://huobao:huobao@127.0.0.1:3306/huobao_drama"
+  max_idle: 10
+  max_open: 100
+
+storage:
+  type: "local"
+  local_path: "./data/storage"
+  base_url: "http://localhost:5678/static"
+
+ai:
+  default_text_provider: "openai"
+  default_image_provider: "openai"
+  default_video_provider: "doubao"
diff --git a/huobao-source/data/huobao.sqlite3.mysql-imported b/huobao-source/data/huobao.sqlite3.mysql-imported
new file mode 100644
index 0000000..2e3cf81
--- /dev/null
+++ b/huobao-source/data/huobao.sqlite3.mysql-imported
@@ -0,0 +1 @@
+imported 190 rows at 2026-09-05T16:27:52.648Z
diff --git a/huobao-source/desktop/assets/icon.icns b/huobao-source/desktop/assets/icon.icns
new file mode 100644
index 0000000..bb6aff9
Binary files /dev/null and b/huobao-source/desktop/assets/icon.icns differ
diff --git a/huobao-source/desktop/assets/icon.ico b/huobao-source/desktop/assets/icon.ico
new file mode 100644
index 0000000..971f651
Binary files /dev/null and b/huobao-source/desktop/assets/icon.ico differ
diff --git a/huobao-source/desktop/assets/starting.html b/huobao-source/desktop/assets/starting.html
new file mode 100644
index 0000000..578ba0a
--- /dev/null
+++ b/huobao-source/desktop/assets/starting.html
@@ -0,0 +1,22 @@
+<!doctype html>
+<html lang="zh-CN">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'">
+<title>火宝短剧</title>
+<style>
+  body { margin: 0; min-height: 100vh; display: grid; place-items: center; background: #f6f7fb; color: #262b36; font: 16px/1.7 system-ui, sans-serif; }
+  main { max-width: 34rem; padding: 32px; text-align: center; }
+  h1 { font-size: 24px; margin: 0 0 12px; }
+  p { color: #596274; margin: 6px 0; }
+  .spinner { width: 28px; height: 28px; margin: 0 auto 24px; border: 3px solid #e2e5ec; border-top-color: #e88329; border-radius: 50%; animation: spin 1s linear infinite; }
+  @keyframes spin { to { transform: rotate(360deg); } }
+  @media (prefers-reduced-motion: reduce) { .spinner { animation: none; } }
+</style>
+<main role="status">
+  <div class="spinner" aria-hidden="true"></div>
+  <h1>正在启动火宝短剧</h1>
+  <p>正在准备本地服务，首次启动可能需要一些时间。</p>
+  <p>无需重复点击图标。启动失败时会提示原因和日志位置。</p>
+</main>
+</html>
diff --git a/huobao-source/desktop/assets/如提示已损坏请双击我.command b/huobao-source/desktop/assets/如提示已损坏请双击我.command
new file mode 100755
index 0000000..1838f34
--- /dev/null
+++ b/huobao-source/desktop/assets/如提示已损坏请双击我.command
@@ -0,0 +1,32 @@
+#!/bin/bash
+# HuobaoDrama 首次打开修复脚本
+# 未签名 app 从浏览器下载后带 quarantine 属性，Gatekeeper 会误报"已损坏"，
+# 本脚本移除该属性。仅首次安装需要运行一次，后续应用内自动更新不受影响。
+
+APP_PATH="/Applications/HuobaoDrama.app"
+
+echo "======================================"
+echo "  HuobaoDrama 修复「App 已损坏」提示"
+echo "======================================"
+echo ""
+
+if [ ! -d "$APP_PATH" ]; then
+  echo "❌ 未找到 $APP_PATH"
+  echo "   请先将 HuobaoDrama.app 拖入「应用程序」文件夹，再运行本脚本。"
+  echo ""
+  read -n 1 -s -r -p "按任意键退出..."
+  exit 1
+fi
+
+xattr -cr "$APP_PATH"
+
+if [ $? -eq 0 ]; then
+  echo "✅ 修复完成！现在可以正常打开 HuobaoDrama 了。"
+  echo "   （本操作只需执行一次，以后双击图标即可启动）"
+else
+  echo "❌ 修复失败，请尝试在终端手动执行："
+  echo "   sudo xattr -cr $APP_PATH"
+fi
+
+echo ""
+read -n 1 -s -r -p "按任意键退出..."
diff --git a/huobao-source/desktop/diagnostics/windows-diagnostics.cmd b/huobao-source/desktop/diagnostics/windows-diagnostics.cmd
new file mode 100644
index 0000000..8ab63cd
--- /dev/null
+++ b/huobao-source/desktop/diagnostics/windows-diagnostics.cmd
@@ -0,0 +1,5 @@
+@echo off
+setlocal
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File "%~dp0windows-diagnostics.ps1" -AppPath "%~1"
+echo.
+pause
diff --git a/huobao-source/desktop/diagnostics/windows-diagnostics.ps1 b/huobao-source/desktop/diagnostics/windows-diagnostics.ps1
new file mode 100644
index 0000000..58c388a
--- /dev/null
+++ b/huobao-source/desktop/diagnostics/windows-diagnostics.ps1
@@ -0,0 +1,63 @@
+param([string]$AppPath)
+$ErrorActionPreference = 'Stop'
+$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
+$out = Join-Path ([Environment]::GetFolderPath('Desktop')) "HuobaoDrama-diagnostics-$stamp"
+New-Item -ItemType Directory -Path $out -Force | Out-Null
+$report = Join-Path $out 'report.txt'
+function Report([string]$text) { $text | Out-File -FilePath $report -Append -Encoding utf8; Write-Host $text }
+try {
+    Report "HuobaoDrama Windows startup diagnostics - $stamp"
+    Report "OS: $([Environment]::OSVersion.VersionString) | 64-bit OS: $([Environment]::Is64BitOperatingSystem)"
+    Report "PowerShell: $($PSVersionTable.PSVersion)"
+    if (-not $AppPath) {
+        $candidates = @(
+            (Join-Path $PSScriptRoot 'HuobaoDrama.exe'),
+            (Join-Path $env:LOCALAPPDATA 'Programs\HuobaoDrama\HuobaoDrama.exe'),
+            (Join-Path $env:LOCALAPPDATA 'Programs\huobao-drama-desktop\HuobaoDrama.exe'),
+            (Join-Path $env:ProgramFiles 'HuobaoDrama\HuobaoDrama.exe')
+        )
+        foreach ($key in @('HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*', 'HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*', 'HKLM:\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*')) {
+            Get-ItemProperty $key -ErrorAction SilentlyContinue | Where-Object { $_.DisplayName -like '*HuobaoDrama*' } | ForEach-Object {
+                Report "Installed: $($_.DisplayName) $($_.DisplayVersion)"
+                if ($_.InstallLocation) { $candidates += Join-Path $_.InstallLocation 'HuobaoDrama.exe' }
+            }
+        }
+        $AppPath = $candidates | Where-Object { Test-Path -LiteralPath $_ -PathType Leaf } | Select-Object -First 1
+    }
+    if (-not $AppPath -or -not (Test-Path -LiteralPath $AppPath -PathType Leaf)) {
+        Report 'Application not found. Place these two diagnostic files beside HuobaoDrama.exe, then run the CMD file again. You can also drag HuobaoDrama.exe onto the CMD file.'
+    } else {
+        $AppPath = (Resolve-Path -LiteralPath $AppPath).Path
+        $install = Split-Path -Parent $AppPath
+        Report "Executable: $AppPath"
+        Report "File version: $((Get-Item -LiteralPath $AppPath).VersionInfo.FileVersion)"
+        foreach ($relative in @('resources\app.asar','resources\frontend\index.html','resources\bin\ffmpeg.exe','resources\bin\ffprobe.exe','resources\app.asar.unpacked\node_modules\better-sqlite3\build\Release\better_sqlite3.node','resources\app.asar.unpacked\node_modules\@img\sharp-win32-x64\lib\sharp-win32-x64.node')) {
+            $file = Join-Path $install $relative
+            Report "Resource $relative : $(Test-Path -LiteralPath $file -PathType Leaf)"
+        }
+        $running = @(Get-Process -Name HuobaoDrama -ErrorAction SilentlyContinue)
+        if ($running.Count -gt 0) {
+            Report 'Existing HuobaoDrama processes found; no new instance launched and no processes terminated.'
+            foreach ($p in $running) { Report "PID=$($p.Id) Responding=$($p.Responding) Window=$($p.MainWindowTitle)" }
+            Report 'If no window is visible, end HuobaoDrama in Task Manager and run this diagnostic again.'
+        } else {
+            $env:ELECTRON_ENABLE_LOGGING = '1'
+            # A shell-level ELECTRON_RUN_AS_NODE makes the GUI executable act as Node.
+            Report "Inherited ELECTRON_RUN_AS_NODE: $env:ELECTRON_RUN_AS_NODE"
+            Remove-Item Env:ELECTRON_RUN_AS_NODE -ErrorAction SilentlyContinue
+            $chromium = Join-Path $out 'chromium.log'
+            $p = Start-Process -FilePath $AppPath -WorkingDirectory $install -ArgumentList @('--enable-logging', "--log-file=`"$chromium`"") -RedirectStandardOutput (Join-Path $out 'stdout.log') -RedirectStandardError (Join-Path $out 'stderr.log') -PassThru
+            Report "Launched PID=$($p.Id). Observing for 15 seconds; the application will not be terminated."
+            Start-Sleep -Seconds 15
+            $p.Refresh()
+            if ($p.HasExited) { Report "Exited: code=$($p.ExitCode)" }
+            else { Report "Still running: Responding=$($p.Responding) Window=$($p.MainWindowTitle)" }
+        }
+    }
+    $startup = Join-Path $env:APPDATA 'HuobaoDrama\logs\startup.log'
+    if (Test-Path -LiteralPath $startup) { Copy-Item -LiteralPath $startup -Destination $out }
+    $events = @(Get-WinEvent -FilterHashtable @{LogName='Application';StartTime=(Get-Date).AddMinutes(-20);Level=2} -MaxEvents 100 -ErrorAction SilentlyContinue | Where-Object { $_.Message -match 'HuobaoDrama|huobao-backend' })
+    if ($events.Count -gt 0) { $events | Select-Object TimeCreated,ProviderName,Id,Message | Format-List | Out-File (Join-Path $out 'windows-events.txt') -Encoding utf8 }
+} catch { Report "Diagnostic error: $($_.Exception.Message)" }
+Report "Send the folder on your Desktop to support: $out"
+Start-Process explorer.exe -ArgumentList "`"$out`""
diff --git a/huobao-source/desktop/diagnostics/使用说明.txt b/huobao-source/desktop/diagnostics/使用说明.txt
new file mode 100644
index 0000000..d330426
--- /dev/null
+++ b/huobao-source/desktop/diagnostics/使用说明.txt
@@ -0,0 +1,21 @@
+火宝短剧 Windows 启动诊断
+
+这是诊断工具，不是安装包，适用于已经安装但打不开的火宝短剧。
+
+1. 将整个压缩包解压到一个文件夹，不要直接在压缩包里运行。
+2. 双击 windows-diagnostics.cmd，等待约 15 秒。
+3. 程序会打开桌面上新建的 HuobaoDrama-diagnostics-日期时间 文件夹。
+4. 把这个文件夹压缩后发给开发者。
+
+如果提示 Application not found：
+右键火宝短剧快捷方式，选择“打开文件所在的位置”。
+把 windows-diagnostics.cmd 和 windows-diagnostics.ps1 一起放到 HuobaoDrama.exe 旁，再双击 CMD。
+也可以把实际的 HuobaoDrama.exe 拖到 windows-diagnostics.cmd 上。
+
+如果提示 Existing HuobaoDrama processes found：
+工具已经记录正在运行的进程，不会强行关闭它们。
+如果没有窗口，先在任务管理器结束 HuobaoDrama，再运行诊断工具。
+
+工具会读取安装资源是否存在、进程状态、启动输出及最近与火宝相关的应用错误事件。
+不会清空项目数据库、删除视频、重装程序或自动结束进程。
+不要双击 PS1 文件；使用 CMD 入口。
diff --git a/huobao-source/desktop/electron-builder.yml b/huobao-source/desktop/electron-builder.yml
new file mode 100644
index 0000000..01cfbfd
--- /dev/null
+++ b/huobao-source/desktop/electron-builder.yml
@@ -0,0 +1,59 @@
+appId: com.huobao.drama
+productName: HuobaoDrama
+directories:
+  output: release
+  buildResources: build
+# 主进程产物 + 后端 bundle + 清单（进入 asar）。
+# backend.mjs 必须在 asar 内：其 externals（sharp/better-sqlite3）经 createRequire
+# 向上解析到 app.asar/node_modules（.node 由 Electron 自动重定向到 app.asar.unpacked）
+files:
+  - dist/**
+  - build/backend.mjs
+  - package.json
+# 原生模块不能留在 asar（.node 需真实文件路径被 dlopen）
+asarUnpack:
+  - "**/node_modules/sharp/**"
+  - "**/node_modules/@img/**"
+  - "**/node_modules/better-sqlite3/**"
+extraResources:
+  - { from: resources/frontend, to: frontend }
+  - { from: resources/workspace-template, to: workspace-template }
+  # 按系统与 CPU 架构选择 ffmpeg/ffprobe，避免 Intel Mac 包带入 ARM 二进制。
+  - { from: "resources/bin-${os}-${arch}", to: bin }
+npmRebuild: true
+# win 交叉打包修复：宿主机（mac）下载的原生预编译是 Mach-O，afterPack 换入官方 win32 .node
+afterPack: scripts/after-pack.mjs
+mac:
+  target:
+    - target: dmg
+      arch: [arm64, x64]
+    # 应用内更新器用的 zip 产物（.app 目录归档），与 dmg 一并产出
+    - target: zip
+      arch: [arm64, x64]
+  category: public.app-category.productivity
+  # 先出未签名包：正式分发需 Apple Developer 签名 + notarize（配置位已留）
+  identity: null
+  icon: assets/icon.icns
+# dmg 窗口内置「修复已损坏」双击脚本：未签名包被浏览器打上 quarantine 后
+# Gatekeeper 误报"已损坏"，用户拖完 app 双击该脚本即自动 xattr -cr
+dmg:
+  window:
+    width: 540
+    height: 400
+  contents:
+    - { x: 130, y: 180, type: file }
+    - { x: 410, y: 180, type: link, path: /Applications }
+    - { x: 270, y: 330, type: file, path: assets/如提示已损坏请双击我.command }
+win:
+  target:
+    - target: nsis
+      arch: [x64]
+  # signExecutable:false 仅跳过签名（未签名分发 SmartScreen 会提示），
+  # 图标与版本信息仍会写入 exe；正式分发需代码签名证书
+  signExecutable: false
+  icon: assets/icon.ico
+nsis:
+  oneClick: false
+  allowToChangeInstallationDirectory: true
+  createDesktopShortcut: always
+  shortcutName: HuobaoDrama
diff --git a/huobao-source/desktop/package-lock.json b/huobao-source/desktop/package-lock.json
new file mode 100644
index 0000000..304ed3a
--- /dev/null
+++ b/huobao-source/desktop/package-lock.json
@@ -0,0 +1,5139 @@
+{
+  "name": "huobao-drama-desktop",
+  "version": "4.0.11",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "huobao-drama-desktop",
+      "version": "4.0.11",
+      "hasInstallScript": true,
+      "dependencies": {
+        "better-sqlite3": "^12.4.1",
+        "sharp": "^0.34.5"
+      },
+      "devDependencies": {
+        "@electron/rebuild": "^4.2.0",
+        "electron": "37.10.3",
+        "electron-builder": "^26.15.3",
+        "esbuild": "^0.28.2",
+        "ffmpeg-static": "^5.3.0",
+        "ffprobe-static": "^3.1.0"
+      },
+      "optionalDependencies": {
+        "@img/sharp-darwin-x64": "^0.34.5",
+        "@img/sharp-libvips-darwin-x64": "^1.2.4",
+        "@img/sharp-win32-x64": "^0.34.5"
+      }
+    },
+    "node_modules/@derhuerst/http-basic": {
+      "version": "8.2.4",
+      "resolved": "https://registry.npmjs.org/@derhuerst/http-basic/-/http-basic-8.2.4.tgz",
+      "integrity": "sha512-F9rL9k9Xjf5blCz8HsJRO4diy111cayL2vkY2XE4r4t3n0yPXVYy3KD3nJ1qbrSn9743UWSXH4IwuCa/HWlGFw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "caseless": "^0.12.0",
+        "concat-stream": "^2.0.0",
+        "http-response-object": "^3.0.1",
+        "parse-cache-control": "^1.0.1"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@electron/asar": {
+      "version": "3.4.1",
+      "resolved": "https://registry.npmjs.org/@electron/asar/-/asar-3.4.1.tgz",
+      "integrity": "sha512-i4/rNPRS84t0vSRa2HorerGRXWyF4vThfHesw0dmcWHp+cspK743UanA0suA5Q5y8kzY2y6YKrvbIUn69BCAiA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "commander": "^5.0.0",
+        "glob": "^7.1.6",
+        "minimatch": "^3.0.4"
+      },
+      "bin": {
+        "asar": "bin/asar.js"
+      },
+      "engines": {
+        "node": ">=10.12.0"
+      }
+    },
+    "node_modules/@electron/asar/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@electron/asar/node_modules/brace-expansion": {
+      "version": "1.1.18",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.18.tgz",
+      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/@electron/asar/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/@electron/fuses": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@electron/fuses/-/fuses-1.8.0.tgz",
+      "integrity": "sha512-zx0EIq78WlY/lBb1uXlziZmDZI4ubcCXIMJ4uGjXzZW0nS19TjSPeXPAjzzTmKQlJUZm0SbmZhPKP7tuQ1SsEw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "chalk": "^4.1.1",
+        "fs-extra": "^9.0.1",
+        "minimist": "^1.2.5"
+      },
+      "bin": {
+        "electron-fuses": "dist/bin.js"
+      }
+    },
+    "node_modules/@electron/fuses/node_modules/fs-extra": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
+      "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "at-least-node": "^1.0.0",
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/@electron/get": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/@electron/get/-/get-2.0.3.tgz",
+      "integrity": "sha512-Qkzpg2s9GnVV2I2BjRksUi43U5e6+zaQMcjoJy0C+C5oxaKl+fmckGDQFtRpZpZV0NQekuZZ+tGz7EA9TVnQtQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.1.1",
+        "env-paths": "^2.2.0",
+        "fs-extra": "^8.1.0",
+        "got": "^11.8.5",
+        "progress": "^2.0.3",
+        "semver": "^6.2.0",
+        "sumchecker": "^3.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "optionalDependencies": {
+        "global-agent": "^3.0.0"
+      }
+    },
+    "node_modules/@electron/get/node_modules/fs-extra": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
+      "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/@electron/get/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/@electron/get/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/@electron/get/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/@electron/notarize": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/@electron/notarize/-/notarize-2.5.0.tgz",
+      "integrity": "sha512-jNT8nwH1f9X5GEITXaQ8IF/KdskvIkOFfB2CvwumsveVidzpSc+mvhhTMdAGSYF3O+Nq49lJ7y+ssODRXu06+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.1.1",
+        "fs-extra": "^9.0.1",
+        "promise-retry": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
+    "node_modules/@electron/notarize/node_modules/fs-extra": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
+      "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "at-least-node": "^1.0.0",
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/@electron/osx-sign": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/@electron/osx-sign/-/osx-sign-1.3.3.tgz",
+      "integrity": "sha512-KZ8mhXvWv2rIEgMbWZ4y33bDHyUKMXnx4M0sTyPNK/vcB81ImdeY9Ggdqy0SWbMDgmbqyQ+phgejh6V3R2QuSg==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "compare-version": "^0.1.2",
+        "debug": "^4.3.4",
+        "fs-extra": "^10.0.0",
+        "isbinaryfile": "^4.0.8",
+        "minimist": "^1.2.6",
+        "plist": "^3.0.5"
+      },
+      "bin": {
+        "electron-osx-flat": "bin/electron-osx-flat.js",
+        "electron-osx-sign": "bin/electron-osx-sign.js"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/@electron/osx-sign/node_modules/isbinaryfile": {
+      "version": "4.0.10",
+      "resolved": "https://registry.npmjs.org/isbinaryfile/-/isbinaryfile-4.0.10.tgz",
+      "integrity": "sha512-iHrqe5shvBUcFbmZq9zOQHBoeOhZJu6RQGrDpBgenUm/Am+F3JM2MgQj+rK3Z601fzrL5gLZWtAPH2OBaSVcyw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 8.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/gjtorikian/"
+      }
+    },
+    "node_modules/@electron/rebuild": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/@electron/rebuild/-/rebuild-4.2.0.tgz",
+      "integrity": "sha512-RKL/O+jGoXJMxrx/5771y1n0xTKmFuOYGO3gMmwypBM6rsH0kou0mswwdXA2JrhIkE4xyC7v9vGk0n6NPzgOxQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@malept/cross-spawn-promise": "^2.0.0",
+        "debug": "^4.1.1",
+        "node-abi": "^4.2.0",
+        "node-api-version": "^0.2.1",
+        "node-gyp": "^12.2.0",
+        "read-binary-file-arch": "^1.0.6"
+      },
+      "bin": {
+        "electron-rebuild": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=22.12.0"
+      }
+    },
+    "node_modules/@electron/universal": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/@electron/universal/-/universal-2.0.3.tgz",
+      "integrity": "sha512-Wn9sPYIVFRFl5HmwMJkARCCf7rqK/EurkfQ/rJZ14mHP3iYTjZSIOSVonEAnhWeAXwtw7zOekGRlc6yTtZ0t+g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@electron/asar": "^3.3.1",
+        "@malept/cross-spawn-promise": "^2.0.0",
+        "debug": "^4.3.1",
+        "dir-compare": "^4.2.0",
+        "fs-extra": "^11.1.1",
+        "minimatch": "^9.0.3",
+        "plist": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=16.4"
+      }
+    },
+    "node_modules/@electron/universal/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@electron/universal/node_modules/brace-expansion": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.4.tgz",
+      "integrity": "sha512-hGfVzPxthbf3+2yjg/RBs60cB0FhqBS/zvdV/4wn4/BmN0bNMMHPc4V/BbFieqf1TKAGGAHnY4eSjajCl0f2Xg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/@electron/universal/node_modules/fs-extra": {
+      "version": "11.4.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.4.0.tgz",
+      "integrity": "sha512-EQsFzMUJkCKGr1ePqlYADkIUmHW1s3ZXr5Yqy6wbGrfUCphpl2maM/kyOIRA2HpP3AaFQTZXD4ldjek+nccddA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=14.14"
+      }
+    },
+    "node_modules/@electron/universal/node_modules/minimatch": {
+      "version": "9.0.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz",
+      "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.2"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/@electron/windows-sign": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/@electron/windows-sign/-/windows-sign-1.2.2.tgz",
+      "integrity": "sha512-dfZeox66AvdPtb2lD8OsIIQh12Tp0GNCRUDfBHIKGpbmopZto2/A8nSpYYLoedPIHpqkeblZ/k8OV0Gy7PYuyQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "optional": true,
+      "dependencies": {
+        "cross-dirname": "^0.1.0",
+        "debug": "^4.3.4",
+        "fs-extra": "^11.1.1",
+        "minimist": "^1.2.8",
+        "postject": "^1.0.0-alpha.6"
+      },
+      "bin": {
+        "electron-windows-sign": "bin/electron-windows-sign.js"
+      },
+      "engines": {
+        "node": ">=14.14"
+      }
+    },
+    "node_modules/@electron/windows-sign/node_modules/fs-extra": {
+      "version": "11.4.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.4.0.tgz",
+      "integrity": "sha512-EQsFzMUJkCKGr1ePqlYADkIUmHW1s3ZXr5Yqy6wbGrfUCphpl2maM/kyOIRA2HpP3AaFQTZXD4ldjek+nccddA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=14.14"
+      }
+    },
+    "node_modules/@emnapi/runtime": {
+      "version": "1.11.3",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.3.tgz",
+      "integrity": "sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
+      "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
+      "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
+      "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
+      "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
+      "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
+      "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
+      "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
+      "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
+      "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
+      "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
+      "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
+      "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
+      "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
+      "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
+      "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
+      "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
+      "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
+      "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
+      "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
+      "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
+      "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@img/colour": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz",
+      "integrity": "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@img/sharp-darwin-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.5.tgz",
+      "integrity": "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-arm64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-darwin-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.5.tgz",
+      "integrity": "sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-darwin-x64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-arm64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.4.tgz",
+      "integrity": "sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-darwin-x64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.4.tgz",
+      "integrity": "sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.4.tgz",
+      "integrity": "sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-arm64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.4.tgz",
+      "integrity": "sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-ppc64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.4.tgz",
+      "integrity": "sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-riscv64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.2.4.tgz",
+      "integrity": "sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-s390x": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.4.tgz",
+      "integrity": "sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linux-x64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.4.tgz",
+      "integrity": "sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-arm64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.4.tgz",
+      "integrity": "sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-libvips-linuxmusl-x64": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.4.tgz",
+      "integrity": "sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.5.tgz",
+      "integrity": "sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.5.tgz",
+      "integrity": "sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-arm64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-ppc64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.5.tgz",
+      "integrity": "sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-ppc64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-riscv64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.34.5.tgz",
+      "integrity": "sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-riscv64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-s390x": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.5.tgz",
+      "integrity": "sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-s390x": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linux-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.5.tgz",
+      "integrity": "sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linux-x64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.5.tgz",
+      "integrity": "sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-linuxmusl-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.5.tgz",
+      "integrity": "sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.4"
+      }
+    },
+    "node_modules/@img/sharp-wasm32": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.5.tgz",
+      "integrity": "sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==",
+      "cpu": [
+        "wasm32"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/runtime": "^1.7.0"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-arm64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.5.tgz",
+      "integrity": "sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-ia32": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.5.tgz",
+      "integrity": "sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@img/sharp-win32-x64": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.5.tgz",
+      "integrity": "sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "Apache-2.0 AND LGPL-3.0-or-later",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      }
+    },
+    "node_modules/@isaacs/fs-minipass": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@isaacs/fs-minipass/-/fs-minipass-4.0.1.tgz",
+      "integrity": "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "minipass": "^7.0.4"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@malept/cross-spawn-promise": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/@malept/cross-spawn-promise/-/cross-spawn-promise-2.0.0.tgz",
+      "integrity": "sha512-1DpKU0Z5ThltBwjNySMC14g0CkbyhCaz9FkhxqNsZI6uAPJXFS8cMXlBKo26FJ8ZuW6S9GCMcR9IO5k2X5/9Fg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/malept"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/subscription/pkg/npm-.malept-cross-spawn-promise?utm_medium=referral&utm_source=npm_fund"
+        }
+      ],
+      "license": "Apache-2.0",
+      "dependencies": {
+        "cross-spawn": "^7.0.1"
+      },
+      "engines": {
+        "node": ">= 12.13.0"
+      }
+    },
+    "node_modules/@malept/flatpak-bundler": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/@malept/flatpak-bundler/-/flatpak-bundler-0.4.0.tgz",
+      "integrity": "sha512-9QOtNffcOF/c1seMCDnjckb3R9WHcG34tky+FHpNKKCW0wc/scYLwMtO+ptyGUfMW0/b/n4qRiALlaFHc9Oj7Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.1.1",
+        "fs-extra": "^9.0.0",
+        "lodash": "^4.17.15",
+        "tmp-promise": "^3.0.2"
+      },
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
+    "node_modules/@malept/flatpak-bundler/node_modules/fs-extra": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
+      "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "at-least-node": "^1.0.0",
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/@noble/hashes": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-2.4.0.tgz",
+      "integrity": "sha512-X5XaVWZIBCT7HHZGm5I7ZQXDwLG+bGXuSrMQAW+7Zvl87h1kmc1ZB1VSRJcpUfoUrGQp4Fkoxm5kZ+Ms+aW+eA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 20.19.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@peculiar/asn1-schema": {
+      "version": "2.9.4",
+      "resolved": "https://registry.npmjs.org/@peculiar/asn1-schema/-/asn1-schema-2.9.4.tgz",
+      "integrity": "sha512-GjzePcT9Iw8NzeOPf73iNS9xM+TBhd/FilAfP+RQGkTMQJTVWtytN3JHJACCjf/ABNau5S7mS3g+DcuxmRgYEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@peculiar/utils": "^2.0.2",
+        "asn1js": "^3.0.10",
+        "tslib": "^2.8.1"
+      },
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@peculiar/json-schema": {
+      "version": "1.1.12",
+      "resolved": "https://registry.npmjs.org/@peculiar/json-schema/-/json-schema-1.1.12.tgz",
+      "integrity": "sha512-coUfuoMeIB7B8/NMekxaDzLhaYmp0HZNPEjYRm9goRou8UZIC3z21s0sL9AWoCw4EG876QyO3kYrc61WNF9B/w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/@peculiar/utils": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/@peculiar/utils/-/utils-2.0.3.tgz",
+      "integrity": "sha512-+oL3HPFRIZ1St2K50lWCXiioIgSoxzz7R1J3uF6neO2yl1sgmpgY6XXJH4BdpoDkMWznQTeYF6oWNDZLCdQ4eQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/@peculiar/webcrypto": {
+      "version": "1.7.1",
+      "resolved": "https://registry.npmjs.org/@peculiar/webcrypto/-/webcrypto-1.7.1.tgz",
+      "integrity": "sha512-ODOov0sGMJMf3jPonOkgGqPknTsu+DdQ7kD++gz8aI+aFMOMHFbWAA2taqXXVTdP+OTOQR/znGvSpmkeI0WTYQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@peculiar/asn1-schema": "^2.7.0",
+        "@peculiar/json-schema": "^1.1.12",
+        "@peculiar/utils": "^2.0.2",
+        "tslib": "^2.8.1",
+        "webcrypto-core": "^1.9.2"
+      },
+      "engines": {
+        "node": ">=14.18.0"
+      }
+    },
+    "node_modules/@sindresorhus/is": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-4.6.0.tgz",
+      "integrity": "sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/is?sponsor=1"
+      }
+    },
+    "node_modules/@szmarczak/http-timer": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/@szmarczak/http-timer/-/http-timer-4.0.6.tgz",
+      "integrity": "sha512-4BAffykYOgO+5nzBWYwE3W90sBgLJoUPRWWcL8wlyiM8IB8ipJz3UMJ9KXQd1RKQXpKp8Tutn80HZtWsu2u76w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "defer-to-connect": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/@types/cacheable-request": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/@types/cacheable-request/-/cacheable-request-6.0.3.tgz",
+      "integrity": "sha512-IQ3EbTzGxIigb1I3qPZc1rWJnH0BmSKv5QYTalEwweFvyBDLSAe24zP0le/hyi7ecGfZVlIVAg4BZqb8WBwKqw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/http-cache-semantics": "*",
+        "@types/keyv": "^3.1.4",
+        "@types/node": "*",
+        "@types/responselike": "^1.0.0"
+      }
+    },
+    "node_modules/@types/debug": {
+      "version": "4.1.13",
+      "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.13.tgz",
+      "integrity": "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/ms": "*"
+      }
+    },
+    "node_modules/@types/fs-extra": {
+      "version": "9.0.13",
+      "resolved": "https://registry.npmjs.org/@types/fs-extra/-/fs-extra-9.0.13.tgz",
+      "integrity": "sha512-nEnwB++1u5lVDM2UI4c1+5R+FYaKfaAzS4OococimjVm3nQw3TuzH5UNsocrcTBbhnerblyHj4A49qXbIiZdpA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/http-cache-semantics": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/@types/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz",
+      "integrity": "sha512-L3LgimLHXtGkWikKnsPg0/VFx9OGZaC+eN1u4r+OB1XRqH3meBIAVC2zr1WdMH+RHmnRkqliQAOHNJ/E0j/e0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/keyv": {
+      "version": "3.1.4",
+      "resolved": "https://registry.npmjs.org/@types/keyv/-/keyv-3.1.4.tgz",
+      "integrity": "sha512-BQ5aZNSCpj7D6K2ksrRCTmKRLEpnPvWDiLPfoGyhZ++8YtiK9d/3DBKPJgry359X/P1PfruyYwvnvwFjuEiEIg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/ms": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
+      "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/node": {
+      "version": "24.13.3",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.3.tgz",
+      "integrity": "sha512-Dh8vAsV36ig5wa9OX4pXvMc9D3Veibfw2wix0CUwYODLD8nkj9UsLjASr49nPg+2eKzxhBV+v7L8pXvT4e639Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~7.18.0"
+      }
+    },
+    "node_modules/@types/responselike": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@types/responselike/-/responselike-1.0.3.tgz",
+      "integrity": "sha512-H/+L+UkTV33uf49PH5pCAUBVPNj2nDBXTN+qS1dOwyyg24l3CcicicCA7ca+HMvJBZcFgl5r8e+RR6elsb4Lyw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/yauzl": {
+      "version": "2.10.3",
+      "resolved": "https://registry.npmjs.org/@types/yauzl/-/yauzl-2.10.3.tgz",
+      "integrity": "sha512-oJoftv0LSuaDZE3Le4DbKX+KS9G36NzOeSap90UIK0yMA/NhKJhqlSGtNDORNRaIbQfzjXDrQa0ytJ6mNRGz/Q==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@xmldom/xmldom": {
+      "version": "0.8.15",
+      "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.8.15.tgz",
+      "integrity": "sha512-/5NV/vDALVFDXgLmfsy9TRCBlKwO2LNBFzpzvb9iIj+jR+eSc6DLYYvVOdivT/jm7MtU6TebYuRmzEOI7w40UA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/abbrev": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-4.0.0.tgz",
+      "integrity": "sha512-a1wflyaL0tHtJSmLSOVybYhy22vRih4eduhhrkcjgrWGnRfrZtovJ2FRjxuTtkkj47O/baf0R86QU5OuYpz8fA==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/agent-base": {
+      "version": "7.1.4",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+      "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/app-builder-lib": {
+      "version": "26.15.3",
+      "resolved": "https://registry.npmjs.org/app-builder-lib/-/app-builder-lib-26.15.3.tgz",
+      "integrity": "sha512-2VnyWkqsP5v5XbBhL3tD5Syx8iNPBYsoU7kY4S2fz7wg8Rj/nztWKCUzGKaFRTv0Xwf3/H058CR1Kvtd/3lRow==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@electron/asar": "3.4.1",
+        "@electron/fuses": "^1.8.0",
+        "@electron/get": "^3.0.0",
+        "@electron/notarize": "2.5.0",
+        "@electron/osx-sign": "1.3.3",
+        "@electron/rebuild": "^4.0.4",
+        "@electron/universal": "2.0.3",
+        "@malept/flatpak-bundler": "^0.4.0",
+        "@noble/hashes": "^2.2.0",
+        "@peculiar/webcrypto": "^1.7.1",
+        "@types/fs-extra": "9.0.13",
+        "ajv": "^8.18.0",
+        "asn1js": "^3.0.10",
+        "async-exit-hook": "^2.0.1",
+        "builder-util": "26.15.3",
+        "builder-util-runtime": "9.7.0",
+        "chromium-pickle-js": "^0.2.0",
+        "ci-info": "4.3.1",
+        "debug": "^4.3.4",
+        "dotenv": "^16.4.5",
+        "dotenv-expand": "^11.0.6",
+        "ejs": "^3.1.8",
+        "electron-publish": "26.15.3",
+        "fs-extra": "^10.1.0",
+        "hosted-git-info": "^4.1.0",
+        "isbinaryfile": "^5.0.0",
+        "jiti": "^2.4.2",
+        "js-yaml": "^4.1.0",
+        "json5": "^2.2.3",
+        "lazy-val": "^1.0.5",
+        "minimatch": "^10.2.5",
+        "pkijs": "^3.4.0",
+        "plist": "3.1.0",
+        "proper-lockfile": "^4.1.2",
+        "resedit": "^1.7.0",
+        "semver": "~7.7.3",
+        "tar": "^7.5.7",
+        "temp-file": "^3.4.0",
+        "tiny-async-pool": "1.3.0",
+        "unzipper": "^0.12.3",
+        "which": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "dmg-builder": "26.15.3",
+        "electron-builder-squirrel-windows": "26.15.3"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/@electron/get": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/@electron/get/-/get-3.1.0.tgz",
+      "integrity": "sha512-F+nKc0xW+kVbBRhFzaMgPy3KwmuNTYX1fx6+FxxoSnNgwYX6LD7AKBTWkU0MQ6IBoe7dz069CNkR673sPAgkCQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.1.1",
+        "env-paths": "^2.2.0",
+        "fs-extra": "^8.1.0",
+        "got": "^11.8.5",
+        "progress": "^2.0.3",
+        "semver": "^6.2.0",
+        "sumchecker": "^3.0.1"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "optionalDependencies": {
+        "global-agent": "^3.0.0"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/@electron/get/node_modules/fs-extra": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
+      "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/@electron/get/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/ci-info": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-4.3.1.tgz",
+      "integrity": "sha512-Wdy2Igu8OcBpI2pZePZ5oWjPC38tmDVx5WKUXKwlLYkA0ozo85sLsLvkBbBn/sZaSCMFOGZJ14fvW9t5/d7kdA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/sibiraj-s"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/isexe": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-3.1.5.tgz",
+      "integrity": "sha512-6B3tLtFqtQS4ekarvLVMZ+X+VlvQekbe4taUkf/rhVO3d/h0M2rfARm/pXLcPEsjjMsFgrFgSrhQIxcSVrBz8w==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/semver": {
+      "version": "7.7.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz",
+      "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/app-builder-lib/node_modules/which": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/which/-/which-5.0.0.tgz",
+      "integrity": "sha512-JEdGzHwwkrbWoGOlIHqQ5gtprKGOenpDHpxE9zVR1bWbOtYRyPPHMe9FaP6x61CmNaTThSkb0DAJte5jD+DmzQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^3.1.1"
+      },
+      "bin": {
+        "node-which": "bin/which.js"
+      },
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "dev": true,
+      "license": "Python-2.0"
+    },
+    "node_modules/asn1js": {
+      "version": "3.0.10",
+      "resolved": "https://registry.npmjs.org/asn1js/-/asn1js-3.0.10.tgz",
+      "integrity": "sha512-S2s3aOytiKdFRdulw2qPE51MzjzVOisppcVv7jVFR+Kw0kxwvFrDcYA0h7Ndqbmj0HkMIXYWaoj7fli8kgx1eg==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "pvtsutils": "^1.3.6",
+        "pvutils": "^1.1.5",
+        "tslib": "^2.8.1"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/async": {
+      "version": "3.2.6",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
+      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/async-exit-hook": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/async-exit-hook/-/async-exit-hook-2.0.1.tgz",
+      "integrity": "sha512-NW2cX8m1Q7KPA7a5M2ULQeZ2wR5qI5PAbw5L0UOMxdioVk9PMZ0h1TmyZEkPYrCvYjDlFICusOu1dlEKAAeXBw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/at-least-node": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/at-least-node/-/at-least-node-1.0.0.tgz",
+      "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/aws4": {
+      "version": "1.13.2",
+      "resolved": "https://registry.npmjs.org/aws4/-/aws4-1.13.2.tgz",
+      "integrity": "sha512-lHe62zvbTB5eEABUVi/AwVh0ZKY9rMMDhmm+eeyuuUQbQ3+J+fONVQOZyj+DdrvD4BY33uYniyRJ4UJIaSKAfw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/balanced-match": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+      "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/better-sqlite3": {
+      "version": "12.11.1",
+      "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-12.11.1.tgz",
+      "integrity": "sha512-dq9AtApgg5PGFtBzPFSBl3HZQjHok5gaQCM6zh2Yk0aSmDCs1CbnVI8/HgASQkNKsWFpseIO9beg5xxpYhbIfA==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "bindings": "^1.5.0",
+        "prebuild-install": "^7.1.1"
+      },
+      "engines": {
+        "node": "20.x || 22.x || 23.x || 24.x || 25.x || 26.x"
+      }
+    },
+    "node_modules/bindings": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz",
+      "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==",
+      "license": "MIT",
+      "dependencies": {
+        "file-uri-to-path": "1.0.0"
+      }
+    },
+    "node_modules/bl": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz",
+      "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==",
+      "license": "MIT",
+      "dependencies": {
+        "buffer": "^5.5.0",
+        "inherits": "^2.0.4",
+        "readable-stream": "^3.4.0"
+      }
+    },
+    "node_modules/bluebird": {
+      "version": "3.7.2",
+      "resolved": "https://registry.npmjs.org/bluebird/-/bluebird-3.7.2.tgz",
+      "integrity": "sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/boolean": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/boolean/-/boolean-3.2.0.tgz",
+      "integrity": "sha512-d0II/GO9uf9lfUHH2BQsjxzRJZBdsjgsBiW4BvhWk/3qoKwQFjIDVN19PfX8F2D/r9PCMTtLWjYVCFrpeYUzsw==",
+      "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.",
+      "dev": true,
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/brace-expansion": {
+      "version": "5.0.9",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
+      "integrity": "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/buffer": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz",
+      "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.1.13"
+      }
+    },
+    "node_modules/buffer-crc32": {
+      "version": "0.2.13",
+      "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz",
+      "integrity": "sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/builder-util": {
+      "version": "26.15.3",
+      "resolved": "https://registry.npmjs.org/builder-util/-/builder-util-26.15.3.tgz",
+      "integrity": "sha512-q2hn7Mbo2nFNkVekPiHFx6Nfo3hURmES3tfBn+k5Pqxl2RkmP3QGqZUhH/q9Pch/4G05NRhPjDlVj1O8q4Txvw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/debug": "^4.1.6",
+        "builder-util-runtime": "9.7.0",
+        "chalk": "^4.1.2",
+        "cross-spawn": "^7.0.6",
+        "debug": "^4.3.4",
+        "fs-extra": "^10.1.0",
+        "http-proxy-agent": "^7.0.0",
+        "https-proxy-agent": "^7.0.0",
+        "js-yaml": "^4.1.0",
+        "sanitize-filename": "^1.6.3",
+        "source-map-support": "^0.5.19",
+        "stat-mode": "^1.0.0",
+        "temp-file": "^3.4.0",
+        "tiny-async-pool": "1.3.0"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/builder-util-runtime": {
+      "version": "9.7.0",
+      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.7.0.tgz",
+      "integrity": "sha512-g/kR520giAFYkSXTzcmF3kqQq7wi8F6N6SzeDgZrqTBN+VHdmgWOyTdD1yD7AATDId/yXLvuP34CxW46/BwCdw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.3.4",
+        "sax": "^1.2.4"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/bytestreamjs": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/bytestreamjs/-/bytestreamjs-2.0.1.tgz",
+      "integrity": "sha512-U1Z/ob71V/bXfVABvNr/Kumf5VyeQRBEm6Txb0PQ6S7V5GpBM3w4Cbqz/xPDicR5tN0uvDifng8C+5qECeGwyQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/cacheable-lookup": {
+      "version": "5.0.4",
+      "resolved": "https://registry.npmjs.org/cacheable-lookup/-/cacheable-lookup-5.0.4.tgz",
+      "integrity": "sha512-2/kNscPhpcxrOigMZzbiWF7dz8ilhb/nIHU3EyZiXWXpeq/au8qJ8VhdftMkty3n7Gj6HIGalQG8oiBNB3AJgA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.6.0"
+      }
+    },
+    "node_modules/cacheable-request": {
+      "version": "7.0.4",
+      "resolved": "https://registry.npmjs.org/cacheable-request/-/cacheable-request-7.0.4.tgz",
+      "integrity": "sha512-v+p6ongsrp0yTGbJXjgxPow2+DL93DASP4kXCDKb8/bwRtt9OEF3whggkkDkGNzgcWy2XaF4a8nZglC7uElscg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "clone-response": "^1.0.2",
+        "get-stream": "^5.1.0",
+        "http-cache-semantics": "^4.0.0",
+        "keyv": "^4.0.0",
+        "lowercase-keys": "^2.0.0",
+        "normalize-url": "^6.0.1",
+        "responselike": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/caseless": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz",
+      "integrity": "sha512-4tYFyifaFfGacoiObjJegolkwSU4xQNGbVgUiNYVUxbQ2x2lUsFvY4hVgVzGiIe6WLOPqycWXA40l+PWsxthUw==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/chownr": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/chownr/-/chownr-3.0.0.tgz",
+      "integrity": "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/chromium-pickle-js": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/chromium-pickle-js/-/chromium-pickle-js-0.2.0.tgz",
+      "integrity": "sha512-1R5Fho+jBq0DDydt+/vHWj5KJNJCKdARKOCwZUen84I5BreWoLqRLANH1U87eJy1tiASPtMnGqJJq0ZsLoRPOw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ci-info": {
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-4.4.0.tgz",
+      "integrity": "sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/sibiraj-s"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/cliui": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
+      "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.1",
+        "wrap-ansi": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/clone-response": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/clone-response/-/clone-response-1.0.3.tgz",
+      "integrity": "sha512-ROoL94jJH2dUVML2Y/5PEDNaSHgeOdSDicUyS7izcF63G6sTc/FTjLub4b8Il9S8S0beOfYt0TaA5qvFK+w0wA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "mimic-response": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/clone-response/node_modules/mimic-response": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-1.0.1.tgz",
+      "integrity": "sha512-j5EctnkH7amfV/q5Hgmoal1g2QHFJRraOtmx0JpIqkxhBhI/lJSl1nMpQ45hVarwNETOoWEimndZ4QK0RHxuxQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/commander": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-5.1.0.tgz",
+      "integrity": "sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/compare-version": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/compare-version/-/compare-version-0.1.2.tgz",
+      "integrity": "sha512-pJDh5/4wrEnXX/VWRZvruAGHkzKdr46z11OlTPN+VrATlWWhSKewNCJ1futCO5C7eJB3nPMFZA1LeYtcFboZ2A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/concat-stream": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz",
+      "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==",
+      "dev": true,
+      "engines": [
+        "node >= 6.0"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.0.2",
+        "typedarray": "^0.0.6"
+      }
+    },
+    "node_modules/core-util-is": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
+      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/cross-dirname": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/cross-dirname/-/cross-dirname-0.1.0.tgz",
+      "integrity": "sha512-+R08/oI0nl3vfPcqftZRpytksBXDzOUveBq/NBVx0sUp1axwzPQrKinNx5yd5sxPu8j1wIy8AfnVQ+5eFdha6Q==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decompress-response": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
+      "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==",
+      "license": "MIT",
+      "dependencies": {
+        "mimic-response": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/deep-extend": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
+      "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/defer-to-connect": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/defer-to-connect/-/defer-to-connect-2.0.1.tgz",
+      "integrity": "sha512-4tvttepXG1VaYGrRibk5EwJd1t4udunSOVMdLSAL6mId1ix438oPwPZMALY41FCijukO1L0twNcGsdzS7dHgDg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/define-data-property": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
+      "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "es-define-property": "^1.0.0",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/define-properties": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",
+      "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "define-data-property": "^1.0.1",
+        "has-property-descriptors": "^1.0.0",
+        "object-keys": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/detect-libc": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/detect-node": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
+      "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/dir-compare": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/dir-compare/-/dir-compare-4.2.0.tgz",
+      "integrity": "sha512-2xMCmOoMrdQIPHdsTawECdNPwlVFB9zGcz3kuhmBO6U3oU+UQjsue0i8ayLKpgBcm+hcXPMVSGUN9d+pvJ6+VQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "minimatch": "^3.0.5",
+        "p-limit": "^3.1.0 "
+      }
+    },
+    "node_modules/dir-compare/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/dir-compare/node_modules/brace-expansion": {
+      "version": "1.1.18",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.18.tgz",
+      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/dir-compare/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/dmg-builder": {
+      "version": "26.15.3",
+      "resolved": "https://registry.npmjs.org/dmg-builder/-/dmg-builder-26.15.3.tgz",
+      "integrity": "sha512-O3zJUFUYHJKgzPqioHxfxzBzlSC1eXCSr79gMSBKBP5AgjjpmrydMsMLotEg9fAJF36vdUncb+4ndRNxoPdlSQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "app-builder-lib": "26.15.3",
+        "builder-util": "26.15.3",
+        "fs-extra": "^10.1.0",
+        "js-yaml": "^4.1.0"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/dotenv-expand": {
+      "version": "11.0.7",
+      "resolved": "https://registry.npmjs.org/dotenv-expand/-/dotenv-expand-11.0.7.tgz",
+      "integrity": "sha512-zIHwmZPRshsCdpMDyVsqGmgyP0yT8GAgXUnkdAoJisxvf33k7yO6OuoKmcTGuXPWSsm8Oh88nZicRLA9Y0rUeA==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "dotenv": "^16.4.5"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/duplexer2": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/duplexer2/-/duplexer2-0.1.4.tgz",
+      "integrity": "sha512-asLFVfWWtJ90ZyOUHMqk7/S2w2guQKxUI2itj3d92ADHhxUSbCMGi1f1cBcJ7xM1To+pE/Khbwo1yuNbMEPKeA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "readable-stream": "^2.0.2"
+      }
+    },
+    "node_modules/duplexer2/node_modules/readable-stream": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "node_modules/duplexer2/node_modules/safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/duplexer2/node_modules/string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
+    "node_modules/ejs": {
+      "version": "3.1.10",
+      "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz",
+      "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "jake": "^10.8.5"
+      },
+      "bin": {
+        "ejs": "bin/cli.js"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/electron": {
+      "version": "37.10.3",
+      "resolved": "https://registry.npmjs.org/electron/-/electron-37.10.3.tgz",
+      "integrity": "sha512-3IjCGSjQmH50IbW2PFveaTzK+KwcFX9PEhE7KXb9v5IT8cLAiryAN7qezm/XzODhDRlLu0xKG1j8xWBtZ/bx/g==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "@electron/get": "^2.0.0",
+        "@types/node": "^22.7.7",
+        "extract-zip": "^2.0.1"
+      },
+      "bin": {
+        "electron": "cli.js"
+      },
+      "engines": {
+        "node": ">= 12.20.55"
+      }
+    },
+    "node_modules/electron-builder": {
+      "version": "26.15.3",
+      "resolved": "https://registry.npmjs.org/electron-builder/-/electron-builder-26.15.3.tgz",
+      "integrity": "sha512-a1KM5heqS3gQCZzizXEI8RjJy3QVogULPdeSknt76uLDpBIW/HDGsMg/XgP0riP6PI9COsRvFITKKGDqA8fJxA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "app-builder-lib": "26.15.3",
+        "builder-util": "26.15.3",
+        "builder-util-runtime": "9.7.0",
+        "chalk": "^4.1.2",
+        "ci-info": "^4.2.0",
+        "dmg-builder": "26.15.3",
+        "fs-extra": "^10.1.0",
+        "lazy-val": "^1.0.5",
+        "simple-update-notifier": "2.0.0",
+        "yargs": "^17.6.2"
+      },
+      "bin": {
+        "electron-builder": "cli.js",
+        "install-app-deps": "install-app-deps.js"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/electron-builder-squirrel-windows": {
+      "version": "26.15.3",
+      "resolved": "https://registry.npmjs.org/electron-builder-squirrel-windows/-/electron-builder-squirrel-windows-26.15.3.tgz",
+      "integrity": "sha512-Jc19XPV9y9+2bAdZPkXuVNGNIEFBq9poHC61l8Kv6FdK7DRG3+Ic0rerC0DXOaeHNz8yW0fg/JnF8GQROOF5MA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "app-builder-lib": "26.15.3",
+        "builder-util": "26.15.3",
+        "electron-winstaller": "5.4.0"
+      }
+    },
+    "node_modules/electron-publish": {
+      "version": "26.15.3",
+      "resolved": "https://registry.npmjs.org/electron-publish/-/electron-publish-26.15.3.tgz",
+      "integrity": "sha512-g/2bn8YTavY4cuS5F+jOS7zmZbXXBV8KZ8yHKfJjFPoKtzBqrpCdNPxBd3tqdBwP7BVd0lGzf7Bk2s0KesWZ4Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/fs-extra": "^9.0.11",
+        "aws4": "^1.13.2",
+        "builder-util": "26.15.3",
+        "builder-util-runtime": "9.7.0",
+        "chalk": "^4.1.2",
+        "form-data": "^4.0.5",
+        "fs-extra": "^10.1.0",
+        "lazy-val": "^1.0.5",
+        "mime": "^2.5.2"
+      }
+    },
+    "node_modules/electron-winstaller": {
+      "version": "5.4.0",
+      "resolved": "https://registry.npmjs.org/electron-winstaller/-/electron-winstaller-5.4.0.tgz",
+      "integrity": "sha512-bO3y10YikuUwUuDUQRM4KfwNkKhnpVO7IPdbsrejwN9/AABJzzTQ4GeHwyzNSrVO+tEH3/Np255a3sVZpZDjvg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "@electron/asar": "^3.2.1",
+        "debug": "^4.1.1",
+        "fs-extra": "^7.0.1",
+        "lodash": "^4.17.21",
+        "temp": "^0.9.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@electron/windows-sign": "^1.1.2"
+      }
+    },
+    "node_modules/electron-winstaller/node_modules/fs-extra": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz",
+      "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.1.2",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/electron-winstaller/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/electron-winstaller/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/electron/node_modules/@types/node": {
+      "version": "22.20.1",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.20.1.tgz",
+      "integrity": "sha512-EANqOCF9QFyra+4pfxUcX9STKJpCLjMbObVzljIJomAWSnuSIEAvyzEU53GaajbXJEgdh0iEcPL+DGvpUd4k1Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/electron/node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/end-of-stream": {
+      "version": "1.4.5",
+      "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz",
+      "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==",
+      "license": "MIT",
+      "dependencies": {
+        "once": "^1.4.0"
+      }
+    },
+    "node_modules/env-paths": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
+      "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/err-code": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/err-code/-/err-code-2.0.3.tgz",
+      "integrity": "sha512-2bmlRpNKBxT/CRmPOlyISQpNj+qSeYvcym/uT0Jx2bMOlKLtSy1ZmLuVxSEKKyor/N5yhvp/ZiG1oE3DEYMSFA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
+      "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es6-error": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/es6-error/-/es6-error-4.1.1.tgz",
+      "integrity": "sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/esbuild": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz",
+      "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.28.2",
+        "@esbuild/android-arm": "0.28.2",
+        "@esbuild/android-arm64": "0.28.2",
+        "@esbuild/android-x64": "0.28.2",
+        "@esbuild/darwin-arm64": "0.28.2",
+        "@esbuild/darwin-x64": "0.28.2",
+        "@esbuild/freebsd-arm64": "0.28.2",
+        "@esbuild/freebsd-x64": "0.28.2",
+        "@esbuild/linux-arm": "0.28.2",
+        "@esbuild/linux-arm64": "0.28.2",
+        "@esbuild/linux-ia32": "0.28.2",
+        "@esbuild/linux-loong64": "0.28.2",
+        "@esbuild/linux-mips64el": "0.28.2",
+        "@esbuild/linux-ppc64": "0.28.2",
+        "@esbuild/linux-riscv64": "0.28.2",
+        "@esbuild/linux-s390x": "0.28.2",
+        "@esbuild/linux-x64": "0.28.2",
+        "@esbuild/netbsd-arm64": "0.28.2",
+        "@esbuild/netbsd-x64": "0.28.2",
+        "@esbuild/openbsd-arm64": "0.28.2",
+        "@esbuild/openbsd-x64": "0.28.2",
+        "@esbuild/openharmony-arm64": "0.28.2",
+        "@esbuild/sunos-x64": "0.28.2",
+        "@esbuild/win32-arm64": "0.28.2",
+        "@esbuild/win32-ia32": "0.28.2",
+        "@esbuild/win32-x64": "0.28.2"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/expand-template": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz",
+      "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==",
+      "license": "(MIT OR WTFPL)",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/exponential-backoff": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/exponential-backoff/-/exponential-backoff-3.1.3.tgz",
+      "integrity": "sha512-ZgEeZXj30q+I0EN+CbSSpIyPaJ5HVQD18Z1m+u1FXbAeT94mr1zw50q4q6jiiC447Nl/YTcIYSAftiGqetwXCA==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/extract-zip": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/extract-zip/-/extract-zip-2.0.1.tgz",
+      "integrity": "sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "debug": "^4.1.1",
+        "get-stream": "^5.1.0",
+        "yauzl": "^2.10.0"
+      },
+      "bin": {
+        "extract-zip": "cli.js"
+      },
+      "engines": {
+        "node": ">= 10.17.0"
+      },
+      "optionalDependencies": {
+        "@types/yauzl": "^2.9.1"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.6",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.6.tgz",
+      "integrity": "sha512-7Ical1vFEMr0onbVzEDIreM22I4khW+fzyQPwvAFWBp1iwdshSZRsL4jjRvPG9JP1uiqMHRto+YU6R2/CzDz5Q==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/fd-slicer": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/fd-slicer/-/fd-slicer-1.1.0.tgz",
+      "integrity": "sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "pend": "~1.2.0"
+      }
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ffmpeg-static": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/ffmpeg-static/-/ffmpeg-static-5.3.0.tgz",
+      "integrity": "sha512-H+K6sW6TiIX6VGend0KQwthe+kaceeH/luE8dIZyOP35ik7ahYojDuqlTV1bOrtEwl01sy2HFNGQfi5IDJvotg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "GPL-3.0-or-later",
+      "dependencies": {
+        "@derhuerst/http-basic": "^8.2.0",
+        "env-paths": "^2.2.0",
+        "https-proxy-agent": "^5.0.0",
+        "progress": "^2.0.3"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/ffmpeg-static/node_modules/agent-base": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz",
+      "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6.0.0"
+      }
+    },
+    "node_modules/ffmpeg-static/node_modules/https-proxy-agent": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",
+      "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "6",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/ffprobe-static": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/ffprobe-static/-/ffprobe-static-3.1.0.tgz",
+      "integrity": "sha512-Dvpa9uhVMOYivhHKWLGDoa512J751qN1WZAIO+Xw4L/mrUSPxS4DApzSUDbCFE/LUq2+xYnznEahTd63AqBSpA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/file-uri-to-path": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz",
+      "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==",
+      "license": "MIT"
+    },
+    "node_modules/filelist": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.6.tgz",
+      "integrity": "sha512-5giy2PkLYY1cP39p17Ech+2xlpTRL9HLspOfEgm0L6CwBXBTgsK5ou0JtzYuepxkaQ/tvhCFIJ5uXo0OrM2DxA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "minimatch": "^5.0.1"
+      }
+    },
+    "node_modules/filelist/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/filelist/node_modules/brace-expansion": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.4.tgz",
+      "integrity": "sha512-hGfVzPxthbf3+2yjg/RBs60cB0FhqBS/zvdV/4wn4/BmN0bNMMHPc4V/BbFieqf1TKAGGAHnY4eSjajCl0f2Xg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/filelist/node_modules/minimatch": {
+      "version": "5.1.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz",
+      "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/form-data": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz",
+      "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.4",
+        "mime-types": "^2.1.35"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/fs-constants": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz",
+      "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==",
+      "license": "MIT"
+    },
+    "node_modules/fs-extra": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
+      "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/fs.realpath": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+      "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/get-stream": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-5.2.0.tgz",
+      "integrity": "sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "pump": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/github-from-package": {
+      "version": "0.0.0",
+      "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz",
+      "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==",
+      "license": "MIT"
+    },
+    "node_modules/glob": {
+      "version": "7.2.3",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.1.1",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/glob/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/glob/node_modules/brace-expansion": {
+      "version": "1.1.18",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.18.tgz",
+      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/glob/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/global-agent": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/global-agent/-/global-agent-3.0.0.tgz",
+      "integrity": "sha512-PT6XReJ+D07JvGoxQMkT6qji/jVNfX/h364XHZOWeRzy64sSFr+xJ5OX7LI3b4MPQzdL4H8Y8M0xzPpsVMwA8Q==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "optional": true,
+      "dependencies": {
+        "boolean": "^3.0.1",
+        "es6-error": "^4.1.1",
+        "matcher": "^3.0.0",
+        "roarr": "^2.15.3",
+        "semver": "^7.3.2",
+        "serialize-error": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=10.0"
+      }
+    },
+    "node_modules/globalthis": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",
+      "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "define-properties": "^1.2.1",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/got": {
+      "version": "11.8.6",
+      "resolved": "https://registry.npmjs.org/got/-/got-11.8.6.tgz",
+      "integrity": "sha512-6tfZ91bOr7bOXnK7PRDCGBLa1H4U080YHNaAQ2KsMGlLEzRbk44nsZF2E1IeRc3vtJHPVbKCYgdFbaGO2ljd8g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sindresorhus/is": "^4.0.0",
+        "@szmarczak/http-timer": "^4.0.5",
+        "@types/cacheable-request": "^6.0.1",
+        "@types/responselike": "^1.0.0",
+        "cacheable-lookup": "^5.0.3",
+        "cacheable-request": "^7.0.2",
+        "decompress-response": "^6.0.0",
+        "http2-wrapper": "^1.0.0-beta.5.2",
+        "lowercase-keys": "^2.0.0",
+        "p-cancelable": "^2.0.0",
+        "responselike": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/got?sponsor=1"
+      }
+    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/has-property-descriptors": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
+      "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "es-define-property": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
+      "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/hosted-git-info": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-4.1.0.tgz",
+      "integrity": "sha512-kyCuEOWjJqZuDbRHzL8V93NzQhwIB71oFWSyzVo+KPZI+pnQPPxucdkrOZvkLRnrf5URsQM+IJ09Dw29cRALIA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "lru-cache": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/http-cache-semantics": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz",
+      "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==",
+      "dev": true,
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/http-proxy-agent": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz",
+      "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "^7.1.0",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/http-response-object": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/http-response-object/-/http-response-object-3.0.2.tgz",
+      "integrity": "sha512-bqX0XTF6fnXSQcEJ2Iuyr75yVakyjIDCqroJQ/aHfSdlM743Cwqoi2nDYMzLGWUcuTWGWy8AAvOKXTfiv6q9RA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "^10.0.3"
+      }
+    },
+    "node_modules/http-response-object/node_modules/@types/node": {
+      "version": "10.17.60",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-10.17.60.tgz",
+      "integrity": "sha512-F0KIgDJfy2nA3zMLmWGKxcH2ZVEtCZXHHdOQs2gSaQ27+lNeEfGxzkIw90aXswATX7AZ33tahPbzy6KAfUreVw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/http2-wrapper": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/http2-wrapper/-/http2-wrapper-1.0.3.tgz",
+      "integrity": "sha512-V+23sDMr12Wnz7iTcDeJr3O6AIxlnvT/bmaAAAP/Xda35C90p9599p0F1eHR/N1KILWSoWVAiOMFjBBXaXSMxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "quick-lru": "^5.1.1",
+        "resolve-alpn": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=10.19.0"
+      }
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+      "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "^7.1.2",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/inflight": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+      "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
+      "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "once": "^1.3.0",
+        "wrappy": "1"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ini": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
+      "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
+      "license": "ISC"
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/isbinaryfile": {
+      "version": "5.0.7",
+      "resolved": "https://registry.npmjs.org/isbinaryfile/-/isbinaryfile-5.0.7.tgz",
+      "integrity": "sha512-gnWD14Jh3FzS3CPhF0AxNOJ8CxqeblPTADzI38r0wt8ZyQl5edpy75myt08EG2oKvpyiqSqsx+Wkz9vtkbTqYQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/gjtorikian/"
+      }
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/jake": {
+      "version": "10.9.4",
+      "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.4.tgz",
+      "integrity": "sha512-wpHYzhxiVQL+IV05BLE2Xn34zW1S223hvjtqk0+gsPrwd/8JNLXJgZZM/iPFsYc1xyphF+6M6EvdE5E9MBGkDA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "async": "^3.2.6",
+        "filelist": "^1.0.4",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "jake": "bin/cli.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/jiti": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.7.0.tgz",
+      "integrity": "sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "jiti": "lib/jiti-cli.mjs"
+      }
+    },
+    "node_modules/js-yaml": {
+      "version": "4.3.2",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.2.tgz",
+      "integrity": "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/puzrin"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/nodeca"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-buffer": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
+      "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/json-stringify-safe": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
+      "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
+      "dev": true,
+      "license": "ISC",
+      "optional": true
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/jsonfile": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz",
+      "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "universalify": "^2.0.0"
+      },
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/keyv": {
+      "version": "4.5.4",
+      "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
+      "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "json-buffer": "3.0.1"
+      }
+    },
+    "node_modules/lazy-val": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/lazy-val/-/lazy-val-1.0.5.tgz",
+      "integrity": "sha512-0/BnGCCfyUMkBpeDgWihanIAF9JmZhHBgUhEqzvf+adhNGLoP6TaiI5oF8oyb3I45P+PcnrqihSf01M0l0G5+Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lodash": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+      "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lowercase-keys": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/lowercase-keys/-/lowercase-keys-2.0.0.tgz",
+      "integrity": "sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/lru-cache": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz",
+      "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/matcher": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/matcher/-/matcher-3.0.0.tgz",
+      "integrity": "sha512-OkeDaAZ/bQCxeFAozM55PKcKU0yJMPGifLwV4Qgjitu+5MoAfSQN4lsLJeXZ1b8w0x+/Emda6MZgXS1jvsapng==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "escape-string-regexp": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/mime": {
+      "version": "2.6.0",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-2.6.0.tgz",
+      "integrity": "sha512-USPkMeET31rOMiarsBNIHZKLGgvKc/LrjofAnBlOttf5ajRvqiRA8QsenbcooctK6d6Ts6aqZXBA+XbkKthiQg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "mime": "cli.js"
+      },
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mimic-response": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz",
+      "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/minimatch": {
+      "version": "10.2.6",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz",
+      "integrity": "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "brace-expansion": "^5.0.8"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
+      "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      }
+    },
+    "node_modules/minizlib": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-3.1.0.tgz",
+      "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "minipass": "^7.1.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/mkdirp": {
+      "version": "0.5.6",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz",
+      "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "minimist": "^1.2.6"
+      },
+      "bin": {
+        "mkdirp": "bin/cmd.js"
+      }
+    },
+    "node_modules/mkdirp-classic": {
+      "version": "0.5.3",
+      "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz",
+      "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==",
+      "license": "MIT"
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/napi-build-utils": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-1.0.2.tgz",
+      "integrity": "sha512-ONmRUqK7zj7DWX0D9ADe03wbwOBZxNAfF20PlGfCWQcD3+/MakShIHrMqx9YwPTfxDdF1zLeL+RGZiR9kGMLdg==",
+      "license": "MIT"
+    },
+    "node_modules/node-abi": {
+      "version": "4.35.0",
+      "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-4.35.0.tgz",
+      "integrity": "sha512-ymk4aIzxdPopw2giv8Fs1Ec6vybGkjmyxUwVqhkI4MCy2tVfXdkOGGWieWVjL0THgH+7a8lRdevyupoYj3Js/Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "semver": "^7.6.3"
+      },
+      "engines": {
+        "node": ">=22.12.0"
+      }
+    },
+    "node_modules/node-api-version": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/node-api-version/-/node-api-version-0.2.1.tgz",
+      "integrity": "sha512-2xP/IGGMmmSQpI1+O/k72jF/ykvZ89JeuKX3TLJAYPDVLUalrshrLHkeVcCCZqG/eEa635cr8IBYzgnDvM2O8Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "semver": "^7.3.5"
+      }
+    },
+    "node_modules/node-gyp": {
+      "version": "12.4.0",
+      "resolved": "https://registry.npmjs.org/node-gyp/-/node-gyp-12.4.0.tgz",
+      "integrity": "sha512-OMcPNvqTCFUnNaBlmdgq+lfNqY7gTiSmNRDjY3uAXRyudeKZEZxu3CLtjMQrx4zZxCX2b/mpNqTtwuCJgXhHkw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "env-paths": "^2.2.0",
+        "exponential-backoff": "^3.1.1",
+        "graceful-fs": "^4.2.6",
+        "nopt": "^9.0.0",
+        "proc-log": "^6.0.0",
+        "semver": "^7.3.5",
+        "tar": "^7.5.4",
+        "tinyglobby": "^0.2.12",
+        "undici": "^6.25.0",
+        "which": "^6.0.0"
+      },
+      "bin": {
+        "node-gyp": "bin/node-gyp.js"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/node-gyp/node_modules/isexe": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-4.0.0.tgz",
+      "integrity": "sha512-FFUtZMpoZ8RqHS3XeXEmHWLA4thH+ZxCv2lOiPIn1Xc7CxrqhWzNSDzD+/chS/zbYezmiwWLdQC09JdQKmthOw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/node-gyp/node_modules/undici": {
+      "version": "6.28.0",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-6.28.0.tgz",
+      "integrity": "sha512-LIY910g9TI13YS95lrMFrs8Rm/u/irgHeTWoKCoteeJ04CUJ92eEfj0rVn+7VKMPBpUPiUoBKfhNyLI23EE/KA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.17"
+      }
+    },
+    "node_modules/node-gyp/node_modules/which": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-6.0.1.tgz",
+      "integrity": "sha512-oGLe46MIrCRqX7ytPUf66EAYvdeMIZYn3WaocqqKZAxrBpkqHfL/qvTyJ/bTk5+AqHCjXmrv3CEWgy368zhRUg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^4.0.0"
+      },
+      "bin": {
+        "node-which": "bin/which.js"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/node-int64": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz",
+      "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/nopt": {
+      "version": "9.0.0",
+      "resolved": "https://registry.npmjs.org/nopt/-/nopt-9.0.0.tgz",
+      "integrity": "sha512-Zhq3a+yFKrYwSBluL4H9XP3m3y5uvQkB/09CwDruCiRmR/UJYnn9W4R48ry0uGC70aeTPKLynBtscP9efFFcPw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "abbrev": "^4.0.0"
+      },
+      "bin": {
+        "nopt": "bin/nopt.js"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/normalize-url": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz",
+      "integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/object-keys": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
+      "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/p-cancelable": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/p-cancelable/-/p-cancelable-2.1.1.tgz",
+      "integrity": "sha512-BZOr3nRQHOntUjTrH8+Lh54smKHoHyur8We1V8DSMVrl5A2malOOwuJRnKRDjSnkoeBh4at6BwEnb5I7Jl31wg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
+      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "yocto-queue": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/parse-cache-control": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/parse-cache-control/-/parse-cache-control-1.0.1.tgz",
+      "integrity": "sha512-60zvsJReQPX5/QP0Kzfd/VrpjScIQ7SHBW6bFCYfEP+fp0Eppr1SHhIO5nd1PjZtvclzSzES9D/p5nFJurwfWg==",
+      "dev": true
+    },
+    "node_modules/path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/pe-library": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/pe-library/-/pe-library-0.4.1.tgz",
+      "integrity": "sha512-eRWB5LBz7PpDu4PUlwT0PhnQfTQJlDDdPa35urV4Osrm0t0AqQFGn+UIkU3klZvwJ8KPO3VbBFsXquA6p6kqZw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12",
+        "npm": ">=6"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/jet2jet"
+      }
+    },
+    "node_modules/pend": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/pend/-/pend-1.2.0.tgz",
+      "integrity": "sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
+      "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pkijs": {
+      "version": "3.4.0",
+      "resolved": "https://registry.npmjs.org/pkijs/-/pkijs-3.4.0.tgz",
+      "integrity": "sha512-emEcLuomt2j03vxD54giVB4SxTjnsqkU692xZOZXHDVoYyypEm+b3jpiTcc+Cf+myooc+/Ly0z01jqeNHVgJGw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@noble/hashes": "1.4.0",
+        "asn1js": "^3.0.6",
+        "bytestreamjs": "^2.0.1",
+        "pvtsutils": "^1.3.6",
+        "pvutils": "^1.1.3",
+        "tslib": "^2.8.1"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/pkijs/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/plist": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/plist/-/plist-3.1.0.tgz",
+      "integrity": "sha512-uysumyrvkUX0rX/dEVqt8gC3sTBzd4zoWfLeS29nb53imdaXVvLINYXTI2GNqzaMuvacNx4uJQ8+b3zXR0pkgQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@xmldom/xmldom": "^0.8.8",
+        "base64-js": "^1.5.1",
+        "xmlbuilder": "^15.1.1"
+      },
+      "engines": {
+        "node": ">=10.4.0"
+      }
+    },
+    "node_modules/postject": {
+      "version": "1.0.0-alpha.6",
+      "resolved": "https://registry.npmjs.org/postject/-/postject-1.0.0-alpha.6.tgz",
+      "integrity": "sha512-b9Eb8h2eVqNE8edvKdwqkrY6O7kAwmI8kcnBv1NScolYJbo59XUF0noFq+lxbC1yN20bmC0WBEbDC5H/7ASb0A==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "commander": "^9.4.0"
+      },
+      "bin": {
+        "postject": "dist/cli.js"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/postject/node_modules/commander": {
+      "version": "9.5.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-9.5.0.tgz",
+      "integrity": "sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": "^12.20.0 || >=14"
+      }
+    },
+    "node_modules/prebuild-install": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.2.tgz",
+      "integrity": "sha512-UnNke3IQb6sgarcZIDU3gbMeTp/9SSU1DAIkil7PrqG1vZlBtY5msYccSKSHDqa3hNg436IXK+SNImReuA1wEQ==",
+      "license": "MIT",
+      "dependencies": {
+        "detect-libc": "^2.0.0",
+        "expand-template": "^2.0.3",
+        "github-from-package": "0.0.0",
+        "minimist": "^1.2.3",
+        "mkdirp-classic": "^0.5.3",
+        "napi-build-utils": "^1.0.1",
+        "node-abi": "^3.3.0",
+        "pump": "^3.0.0",
+        "rc": "^1.2.7",
+        "simple-get": "^4.0.0",
+        "tar-fs": "^2.0.0",
+        "tunnel-agent": "^0.6.0"
+      },
+      "bin": {
+        "prebuild-install": "bin.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/prebuild-install/node_modules/node-abi": {
+      "version": "3.96.0",
+      "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.96.0.tgz",
+      "integrity": "sha512-rebQ/lz7i0EkoLzUVSrKRzA69zMkwLp95kKMWoMDkkM00Suxz0D7zEQPwRml5fQum24mj7bPvmlgLAmu2JCiYg==",
+      "license": "MIT",
+      "dependencies": {
+        "semver": "^7.3.5"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/proc-log": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/proc-log/-/proc-log-6.1.0.tgz",
+      "integrity": "sha512-iG+GYldRf2BQ0UDUAd6JQ/RwzaQy6mXmsk/IzlYyal4A4SNFw54MeH4/tLkF4I5WoWG9SQwuqWzS99jaFQHBuQ==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/process-nextick-args": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/progress": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
+      "integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/promise-retry": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/promise-retry/-/promise-retry-2.0.1.tgz",
+      "integrity": "sha512-y+WKFlBR8BGXnsNlIHFGPZmyDf3DFMoLhaflAnyZgV6rG6xu+JwesTo2Q9R6XwYmtmwAFCkAk3e35jEdoeh/3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "err-code": "^2.0.2",
+        "retry": "^0.12.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/proper-lockfile": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/proper-lockfile/-/proper-lockfile-4.1.2.tgz",
+      "integrity": "sha512-TjNPblN4BwAWMXU8s9AEz4JmQxnD1NNL7bNOY/AKUzyamc379FWASUhc/K1pL2noVb+XmZKLL68cjzLsiOAMaA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.4",
+        "retry": "^0.12.0",
+        "signal-exit": "^3.0.2"
+      }
+    },
+    "node_modules/pump": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.4.tgz",
+      "integrity": "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==",
+      "license": "MIT",
+      "dependencies": {
+        "end-of-stream": "^1.1.0",
+        "once": "^1.3.1"
+      }
+    },
+    "node_modules/pvtsutils": {
+      "version": "1.3.6",
+      "resolved": "https://registry.npmjs.org/pvtsutils/-/pvtsutils-1.3.6.tgz",
+      "integrity": "sha512-PLgQXQ6H2FWCaeRak8vvk1GW462lMxB5s3Jm673N82zI4vqtVUPuZdffdZbPDFRoU8kAhItWFtPCWiPpp4/EDg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/pvutils": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/pvutils/-/pvutils-1.2.0.tgz",
+      "integrity": "sha512-BbubeCEyTuQjVMakvJQ/Sxbc93F2pwmbsxONT/ZRrwU7Ua38d8unYTwXpTVLAKJ4BDuH9IGztCjQcd/N/39Dvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/quick-lru": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-5.1.1.tgz",
+      "integrity": "sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/rc": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz",
+      "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==",
+      "license": "(BSD-2-Clause OR MIT OR Apache-2.0)",
+      "dependencies": {
+        "deep-extend": "^0.6.0",
+        "ini": "~1.3.0",
+        "minimist": "^1.2.0",
+        "strip-json-comments": "~2.0.1"
+      },
+      "bin": {
+        "rc": "cli.js"
+      }
+    },
+    "node_modules/read-binary-file-arch": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/read-binary-file-arch/-/read-binary-file-arch-1.0.6.tgz",
+      "integrity": "sha512-BNg9EN3DD3GsDXX7Aa8O4p92sryjkmzYYgmgTAc6CA4uGLEDzFfxOxugu21akOxpcXHiEgsYkC6nPsQvLLLmEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.3.4"
+      },
+      "bin": {
+        "read-binary-file-arch": "cli.js"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/resedit": {
+      "version": "1.7.2",
+      "resolved": "https://registry.npmjs.org/resedit/-/resedit-1.7.2.tgz",
+      "integrity": "sha512-vHjcY2MlAITJhC0eRD/Vv8Vlgmu9Sd3LX9zZvtGzU5ZImdTN3+d6e/4mnTyV8vEbyf1sgNIrWxhWlrys52OkEA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "pe-library": "^0.4.1"
+      },
+      "engines": {
+        "node": ">=12",
+        "npm": ">=6"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/jet2jet"
+      }
+    },
+    "node_modules/resolve-alpn": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/resolve-alpn/-/resolve-alpn-1.2.1.tgz",
+      "integrity": "sha512-0a1F4l73/ZFZOakJnQ3FvkJ2+gSTQWz/r2KE5OdDY0TxPm5h4GkqkWWfM47T7HsbnOtcJVEF4epCVy6u7Q3K+g==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/responselike": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/responselike/-/responselike-2.0.1.tgz",
+      "integrity": "sha512-4gl03wn3hj1HP3yzgdI7d3lCkF95F21Pz4BPGvKHinyQzALR5CapwC8yIi0Rh58DEMQ/SguC03wFj2k0M/mHhw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "lowercase-keys": "^2.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/retry": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/retry/-/retry-0.12.0.tgz",
+      "integrity": "sha512-9LkiTwjUh6rT555DtE9rTX+BKByPfrMzEAtnlEtdEwr3Nkffwiihqe2bWADg+OQRjt9gl6ICdmB/ZFDCGAtSow==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/rimraf": {
+      "version": "2.6.3",
+      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.6.3.tgz",
+      "integrity": "sha512-mwqeW5XsA2qAejG46gYdENaxXjx9onRNCfn7L0duuP4hCuTIi/QO7PDK07KJfp1d+izWPrzEJDcSqBa0OZQriA==",
+      "deprecated": "Rimraf versions prior to v4 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "glob": "^7.1.3"
+      },
+      "bin": {
+        "rimraf": "bin.js"
+      }
+    },
+    "node_modules/roarr": {
+      "version": "2.15.4",
+      "resolved": "https://registry.npmjs.org/roarr/-/roarr-2.15.4.tgz",
+      "integrity": "sha512-CHhPh+UNHD2GTXNYhPWLnU8ONHdI+5DI+4EYIAOaiD63rHeYlZvyh8P+in5999TTSFgUYuKUAjzRI4mdh/p+2A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "optional": true,
+      "dependencies": {
+        "boolean": "^3.0.1",
+        "detect-node": "^2.0.4",
+        "globalthis": "^1.0.1",
+        "json-stringify-safe": "^5.0.1",
+        "semver-compare": "^1.0.0",
+        "sprintf-js": "^1.1.2"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/sanitize-filename": {
+      "version": "1.6.4",
+      "resolved": "https://registry.npmjs.org/sanitize-filename/-/sanitize-filename-1.6.4.tgz",
+      "integrity": "sha512-9ZyI08PsvdQl2r/bBIGubpVdR3RR9sY6RDiWFPreA21C/EFlQhmgo20UZlNjZMMZNubusLhAQozkA0Od5J21Eg==",
+      "dev": true,
+      "license": "WTFPL OR ISC",
+      "dependencies": {
+        "truncate-utf8-bytes": "^1.0.0"
+      }
+    },
+    "node_modules/sax": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.1.tgz",
+      "integrity": "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=11.0.0"
+      }
+    },
+    "node_modules/semver": {
+      "version": "7.8.5",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/semver-compare": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/semver-compare/-/semver-compare-1.0.0.tgz",
+      "integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/serialize-error": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/serialize-error/-/serialize-error-7.0.1.tgz",
+      "integrity": "sha512-8I8TjW5KMOKsZQTvoxjuSIa7foAwPWGOts+6o7sgjz41/qMD9VQHEDxi6PBvK2l0MXUmqZyNpUK+T2tQaaElvw==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "type-fest": "^0.13.1"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/sharp": {
+      "version": "0.34.5",
+      "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.5.tgz",
+      "integrity": "sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==",
+      "hasInstallScript": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@img/colour": "^1.0.0",
+        "detect-libc": "^2.1.2",
+        "semver": "^7.7.3"
+      },
+      "engines": {
+        "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/libvips"
+      },
+      "optionalDependencies": {
+        "@img/sharp-darwin-arm64": "0.34.5",
+        "@img/sharp-darwin-x64": "0.34.5",
+        "@img/sharp-libvips-darwin-arm64": "1.2.4",
+        "@img/sharp-libvips-darwin-x64": "1.2.4",
+        "@img/sharp-libvips-linux-arm": "1.2.4",
+        "@img/sharp-libvips-linux-arm64": "1.2.4",
+        "@img/sharp-libvips-linux-ppc64": "1.2.4",
+        "@img/sharp-libvips-linux-riscv64": "1.2.4",
+        "@img/sharp-libvips-linux-s390x": "1.2.4",
+        "@img/sharp-libvips-linux-x64": "1.2.4",
+        "@img/sharp-libvips-linuxmusl-arm64": "1.2.4",
+        "@img/sharp-libvips-linuxmusl-x64": "1.2.4",
+        "@img/sharp-linux-arm": "0.34.5",
+        "@img/sharp-linux-arm64": "0.34.5",
+        "@img/sharp-linux-ppc64": "0.34.5",
+        "@img/sharp-linux-riscv64": "0.34.5",
+        "@img/sharp-linux-s390x": "0.34.5",
+        "@img/sharp-linux-x64": "0.34.5",
+        "@img/sharp-linuxmusl-arm64": "0.34.5",
+        "@img/sharp-linuxmusl-x64": "0.34.5",
+        "@img/sharp-wasm32": "0.34.5",
+        "@img/sharp-win32-arm64": "0.34.5",
+        "@img/sharp-win32-ia32": "0.34.5",
+        "@img/sharp-win32-x64": "0.34.5"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/signal-exit": {
+      "version": "3.0.7",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
+      "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/simple-concat": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz",
+      "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/simple-get": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz",
+      "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "decompress-response": "^6.0.0",
+        "once": "^1.3.1",
+        "simple-concat": "^1.0.0"
+      }
+    },
+    "node_modules/simple-update-notifier": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/simple-update-notifier/-/simple-update-notifier-2.0.0.tgz",
+      "integrity": "sha512-a2B9Y0KlNXl9u/vsW6sTIu9vGEpfKu2wRV6l1H3XEas/0gUIzGzBoP/IouTcUQbm9JWZLH3COxyn03TYlFax6w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "semver": "^7.5.3"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/source-map-support": {
+      "version": "0.5.21",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
+      "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "node_modules/sprintf-js": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.3.tgz",
+      "integrity": "sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "optional": true
+    },
+    "node_modules/stat-mode": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/stat-mode/-/stat-mode-1.0.0.tgz",
+      "integrity": "sha512-jH9EhtKIjuXZ2cWxmXS8ZP80XyC3iasQxMDV8jzhNJpfDb7VbQLVW4Wvsxz9QZvzV+G4YoSfBUVKDOyxLzi/sg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz",
+      "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/sumchecker": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/sumchecker/-/sumchecker-3.0.1.tgz",
+      "integrity": "sha512-MvjXzkz/BOfyVDkG0oFOtBxHX2u3gKbMHIF/dXblZsgD3BWOFLmHovIpZY7BykJdAjcqRCBi1WYBNdEC9yI7vg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "debug": "^4.1.0"
+      },
+      "engines": {
+        "node": ">= 8.0"
+      }
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/tar": {
+      "version": "7.5.22",
+      "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.22.tgz",
+      "integrity": "sha512-MFO/QzvtAOmJbkhOaCTvbGcFN9L9b+JunIsDwaKljSOdcLMea3NJ1k9Usz/rjdfSXTq4dfzfeS7W4p4YOAAHeA==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "@isaacs/fs-minipass": "^4.0.0",
+        "chownr": "^3.0.0",
+        "minipass": "^7.1.2",
+        "minizlib": "^3.1.0",
+        "yallist": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tar-fs": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.5.tgz",
+      "integrity": "sha512-OboTd8mmMhZDNPV+UjQcK9yKAatXu2aJ+r1w4im1Otd4M4fl2hwvdoXUxIYHFTHWK/3y3FarBP70v3vwmGlOxw==",
+      "license": "MIT",
+      "dependencies": {
+        "chownr": "^1.1.1",
+        "mkdirp-classic": "^0.5.2",
+        "pump": "^3.0.0",
+        "tar-stream": "^2.1.4"
+      }
+    },
+    "node_modules/tar-fs/node_modules/chownr": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz",
+      "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==",
+      "license": "ISC"
+    },
+    "node_modules/tar-stream": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz",
+      "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==",
+      "license": "MIT",
+      "dependencies": {
+        "bl": "^4.0.3",
+        "end-of-stream": "^1.4.1",
+        "fs-constants": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.1.1"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/tar/node_modules/yallist": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-5.0.0.tgz",
+      "integrity": "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/temp": {
+      "version": "0.9.4",
+      "resolved": "https://registry.npmjs.org/temp/-/temp-0.9.4.tgz",
+      "integrity": "sha512-yYrrsWnrXMcdsnu/7YMYAofM1ktpL5By7vZhf15CrXijWWrEYZks5AXBudalfSWJLlnen/QUJUB5aoB0kqZUGA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "mkdirp": "^0.5.1",
+        "rimraf": "~2.6.2"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/temp-file": {
+      "version": "3.4.0",
+      "resolved": "https://registry.npmjs.org/temp-file/-/temp-file-3.4.0.tgz",
+      "integrity": "sha512-C5tjlC/HCtVUOi3KWVokd4vHVViOmGjtLwIh4MuzPo/nMYTV/p1urt3RnMz2IWXDdKEGJH3k5+KPxtqRsUYGtg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "async-exit-hook": "^2.0.1",
+        "fs-extra": "^10.0.0"
+      }
+    },
+    "node_modules/tiny-async-pool": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/tiny-async-pool/-/tiny-async-pool-1.3.0.tgz",
+      "integrity": "sha512-01EAw5EDrcVrdgyCLgoSPvqznC0sVxDSVeiOz09FUpjh71G79VCqneOr+xvt7T1r76CF6ZZfPjHorN2+d+3mqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "semver": "^5.5.0"
+      }
+    },
+    "node_modules/tiny-async-pool/node_modules/semver": {
+      "version": "5.7.2",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz",
+      "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.17",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+      "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.4"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tmp": {
+      "version": "0.2.7",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.7.tgz",
+      "integrity": "sha512-e0votIpp4Uo2AJYSzVHV6xCcawuiez3DzqDAbrTc3YxBkplN6e+dM13ZeIcZnDg/QpSuU2zfZ3rzwY8ukEnaXw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.14"
+      }
+    },
+    "node_modules/tmp-promise": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/tmp-promise/-/tmp-promise-3.0.3.tgz",
+      "integrity": "sha512-RwM7MoPojPxsOBYnyd2hy0bxtIlVrihNs9pj5SUvY8Zz1sQcQG2tG1hSr8PDxfgEB8RNKDhqbIlroIarSNDNsQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tmp": "^0.2.0"
+      }
+    },
+    "node_modules/truncate-utf8-bytes": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/truncate-utf8-bytes/-/truncate-utf8-bytes-1.0.2.tgz",
+      "integrity": "sha512-95Pu1QXQvruGEhv62XCMO3Mm90GscOCClvrIUwCM0PYOXK3kaF3l3sIHxx71ThJfcbM2O5Au6SO3AWCSEfW4mQ==",
+      "dev": true,
+      "license": "WTFPL",
+      "dependencies": {
+        "utf8-byte-length": "^1.0.1"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "devOptional": true,
+      "license": "0BSD"
+    },
+    "node_modules/tunnel-agent": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz",
+      "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "safe-buffer": "^5.0.1"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/type-fest": {
+      "version": "0.13.1",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.13.1.tgz",
+      "integrity": "sha512-34R7HTnG0XIJcBSn5XhDd7nNFPRcXYRZrBB2O2jdKqYODldSzBAqzsWoZYYvduky73toYS/ESqxPvkDf/F0XMg==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "optional": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/typedarray": {
+      "version": "0.0.6",
+      "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz",
+      "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/undici-types": {
+      "version": "7.18.2",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz",
+      "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/universalify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
+    "node_modules/unzipper": {
+      "version": "0.12.5",
+      "resolved": "https://registry.npmjs.org/unzipper/-/unzipper-0.12.5.tgz",
+      "integrity": "sha512-tXYOi9R57Uj/2Z25SOs5RRSzq886MBQj2gY8dPL+xl/kv6s6SvByoKfAtvfVeEuhntWDgjd2o9p2lb4TVPAz0A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bluebird": "~3.7.2",
+        "duplexer2": "~0.1.4",
+        "fs-extra": "11.3.1",
+        "graceful-fs": "^4.2.2",
+        "node-int64": "^0.4.0"
+      }
+    },
+    "node_modules/unzipper/node_modules/fs-extra": {
+      "version": "11.3.1",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.1.tgz",
+      "integrity": "sha512-eXvGGwZ5CL17ZSwHWd3bbgk7UUpF6IFHtP57NYYakPvHOs8GDgDe5KJI36jIJzDkJ6eJjuzRA8eBQb6SkKue0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=14.14"
+      }
+    },
+    "node_modules/utf8-byte-length": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/utf8-byte-length/-/utf8-byte-length-1.0.5.tgz",
+      "integrity": "sha512-Xn0w3MtiQ6zoz2vFyUVruaCL53O/DwUvkEeOvj+uulMm0BkUGYWmBYVyElqZaSLhY6ZD0ulfU3aBra2aVT4xfA==",
+      "dev": true,
+      "license": "(WTFPL OR MIT)"
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT"
+    },
+    "node_modules/webcrypto-core": {
+      "version": "1.9.2",
+      "resolved": "https://registry.npmjs.org/webcrypto-core/-/webcrypto-core-1.9.2.tgz",
+      "integrity": "sha512-gsXecm82UQNlTBURJGuqOWy1Ww08S3kZUcr3aOJS02Pk0xLtkfeUAVC0u0xhgdonFme80edSJUIJyuvL/7250Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@peculiar/asn1-schema": "^2.7.0",
+        "@peculiar/json-schema": "^1.1.12",
+        "@peculiar/utils": "^2.0.2",
+        "asn1js": "^3.0.10",
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/wrap-ansi": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "license": "ISC"
+    },
+    "node_modules/xmlbuilder": {
+      "version": "15.1.1",
+      "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-15.1.1.tgz",
+      "integrity": "sha512-yMqGBqtXyeN1e3TGYvgNgDVZ3j84W4cwkOXQswghol6APgZWaff9lnbvN7MHYJOiXsvGPXtjTYJEiC9J2wv9Eg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/y18n": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yallist": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz",
+      "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/yargs": {
+      "version": "17.7.3",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.3.tgz",
+      "integrity": "sha512-GZtjxm/J/4TSxuL3FNYjCmLktBTnIw/rVmKSIyKeYAZpmJB2ig9VauCC5xsa82GNKVKDAqpOn3KVzNt0zmrU0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^8.0.1",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "require-directory": "^2.1.1",
+        "string-width": "^4.2.3",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^21.1.1"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "21.1.1",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz",
+      "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/yauzl": {
+      "version": "2.10.0",
+      "resolved": "https://registry.npmjs.org/yauzl/-/yauzl-2.10.0.tgz",
+      "integrity": "sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-crc32": "~0.2.3",
+        "fd-slicer": "~1.1.0"
+      }
+    },
+    "node_modules/yocto-queue": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
+      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    }
+  }
+}
diff --git a/huobao-source/desktop/package.json b/huobao-source/desktop/package.json
new file mode 100644
index 0000000..bf49c91
--- /dev/null
+++ b/huobao-source/desktop/package.json
@@ -0,0 +1,37 @@
+{
+  "name": "huobao-drama-desktop",
+  "productName": "HuobaoDrama",
+  "version": "4.0.11",
+  "private": true,
+  "description": "火宝短剧桌面版（Electron 壳）",
+  "author": "Huobao",
+  "main": "dist/main.js",
+  "scripts": {
+    "build:backend": "node scripts/build-backend.mjs",
+    "build:main": "node scripts/build-main.mjs",
+    "rebuild:native": "electron-builder install-app-deps",
+    "postinstall": "electron-builder install-app-deps",
+    "dev": "npm run build:backend && npm run build:main && electron .",
+    "dist": "npm run build:backend && npm run build:main && node scripts/prepare-resources.mjs && electron-builder --mac",
+    "dist:win": "npm run build:backend && npm run build:main && node scripts/prepare-resources.mjs && electron-builder --win",
+    "feed": "node scripts/make-update-feed.mjs",
+    "publish": "node scripts/publish-release.mjs"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.4.1",
+    "sharp": "^0.34.5"
+  },
+  "devDependencies": {
+    "@electron/rebuild": "^4.2.0",
+    "electron": "37.10.3",
+    "electron-builder": "^26.15.3",
+    "esbuild": "^0.28.2",
+    "ffmpeg-static": "^5.3.0",
+    "ffprobe-static": "^3.1.0"
+  },
+  "optionalDependencies": {
+    "@img/sharp-darwin-x64": "^0.34.5",
+    "@img/sharp-libvips-darwin-x64": "^1.2.4",
+    "@img/sharp-win32-x64": "^0.34.5"
+  }
+}
diff --git a/huobao-source/desktop/scripts/after-pack.mjs b/huobao-source/desktop/scripts/after-pack.mjs
new file mode 100644
index 0000000..3d32e4d
--- /dev/null
+++ b/huobao-source/desktop/scripts/after-pack.mjs
@@ -0,0 +1,68 @@
+/**
+ * electron-builder afterPack 钩子 — 修 Windows 包的 better-sqlite3 原生模块。
+ *
+ * 背景：dist:win 在 mac 上交叉打包，@electron/rebuild/prebuild-install 按宿主机
+ * 平台下载预编译产物，导致 win 包里的 build/Release/better_sqlite3.node 实为
+ * Mach-O（mac 二进制），Windows 上 dlopen 失败 → 后端 exit code 1。
+ *
+ * 修复：打包后（win-unpacked 生成、NSIS 封装前）用官方 win32-x64 预编译 .node
+ * 覆盖。预编译文件缓存于 build/win-bin/better_sqlite3.node（同 ffmpeg.exe 的
+ * 缓存方式；better-sqlite3 或 Electron 主版本升级时需重新下载对应 ABI：
+ * https://github.com/WiseLibs/better-sqlite3/releases）
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { validateWindowsPackage, assertWindowsX64 } from './validate-windows-package.mjs'
+import { Arch } from 'builder-util'
+import { assertMacArchitecture } from './prepare-mac-media.mjs'
+
+const WIN_BIN = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'build', 'win-bin', 'better_sqlite3.node')
+
+export default async function afterPack(context) {
+  // electron-builder 对缺失的 extraResources 只警告不报错（曾导致整包没打进 ffmpeg），
+  // 这里硬性校验：任何平台都必须有本平台的 ffmpeg/ffprobe
+  const resourcesDir = context.electronPlatformName === 'darwin'
+    ? path.join(context.appOutDir, `${context.packager.appInfo.productFilename}.app`, 'Contents', 'Resources')
+    : path.join(context.appOutDir, 'resources')
+  const exe = context.electronPlatformName === 'win32' ? '.exe' : ''
+  for (const name of [`ffmpeg${exe}`, `ffprobe${exe}`]) {
+    const p = path.join(resourcesDir, 'bin', name)
+    if (!fs.existsSync(p)) throw new Error(`打包产物缺少 bin/${name}（检查 prepare-resources 的平台与架构目录）`)
+    if (context.electronPlatformName === 'darwin') assertMacArchitecture(p, Arch[context.arch])
+  }
+
+  if (context.electronPlatformName === 'darwin') {
+    const arch = Arch[context.arch]
+    const nativeRoot = path.join(resourcesDir, 'app.asar.unpacked', 'node_modules')
+    for (const file of [
+      path.join(nativeRoot, 'better-sqlite3', 'build', 'Release', 'better_sqlite3.node'),
+      path.join(nativeRoot, '@img', `sharp-darwin-${arch}`, 'lib', `sharp-darwin-${arch}.node`),
+    ]) assertMacArchitecture(file, arch)
+    const vips = path.join(nativeRoot, '@img', `sharp-libvips-darwin-${arch}`, 'lib')
+    const libraries = fs.readdirSync(vips).filter(file => file.endsWith('.dylib'))
+    if (!libraries.length) throw new Error(`缺少 macOS ${arch} libvips 动态库`)
+    for (const file of libraries) assertMacArchitecture(path.join(vips, file), arch)
+    console.log(`[package-check] macOS ${arch} 媒体工具与原生模块架构一致 ✓`)
+    return
+  }
+  if (context.electronPlatformName !== 'win32') return
+  if (!fs.existsSync(WIN_BIN)) {
+    throw new Error(
+      `缺少 win32 better-sqlite3 预编译: ${WIN_BIN}\n` +
+      '下载 https://github.com/WiseLibs/better-sqlite3/releases/download/v12.11.1/' +
+      'better-sqlite3-v12.11.1-electron-v136-win32-x64.tar.gz 解出 build/Release/better_sqlite3.node 放入该路径',
+    )
+  }
+  const target = path.join(
+    context.appOutDir, 'resources', 'app.asar.unpacked', 'node_modules',
+    'better-sqlite3', 'build', 'Release', 'better_sqlite3.node',
+  )
+  if (!fs.existsSync(target)) throw new Error(`未找到待替换的 better_sqlite3.node: ${target}`)
+  assertWindowsX64(WIN_BIN)
+  fs.copyFileSync(WIN_BIN, target)
+  // 顺手清掉宿主机平台预编译残留（bindings 不会命中，但白占体积）
+  fs.rmSync(path.join(path.dirname(path.dirname(path.dirname(target))), 'bin'), { recursive: true, force: true })
+  console.log(`[after-pack] win32 better_sqlite3.node 已替换为 PE 二进制 (${(fs.statSync(target).size / 1024 / 1024).toFixed(1)}MB)`)
+  validateWindowsPackage(resourcesDir, context.packager.info.framework.version)
+}
diff --git a/huobao-source/desktop/scripts/build-backend.mjs b/huobao-source/desktop/scripts/build-backend.mjs
new file mode 100644
index 0000000..c712d72
--- /dev/null
+++ b/huobao-source/desktop/scripts/build-backend.mjs
@@ -0,0 +1,40 @@
+/**
+ * esbuild 打包后端 — backend/src → desktop/build/backend.mjs（单文件 ESM）
+ *
+ * - format esm：backend 顶层 await initDb() 要求 ESM
+ * - external 四件套：sharp / better-sqlite3（原生模块，electron-builder 按
+ *   Electron ABI 重编并 asarUnpack）、ffmpeg-static / ffprobe-static（postinstall
+ *   下载的二进制，且 ffmpeg.ts 经 createRequire 动态引入，无法静态打包）
+ * - banner 注入 createRequire：externals 在 ESM 产物里经 require 解析到
+ *   desktop/node_modules（与主应用同 ABI 的副本）
+ */
+import { build } from 'esbuild'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+await build({
+  entryPoints: [path.resolve(__dirname, '../../backend/src/index.ts')],
+  outfile: path.resolve(__dirname, '../build/backend.mjs'),
+  bundle: true,
+  format: 'esm',
+  platform: 'node',
+  target: 'node20',
+  sourcemap: true,
+  external: ['sharp', 'better-sqlite3', 'ffmpeg-static', 'ffprobe-static'],
+  banner: {
+    // esbuild 打 CJS→ESM 不垫片 __dirname/__filename/require（fluent-ffmpeg 等依赖），
+    // 在产物顶层统一注入；__dirname 指向 build/ 目录，仅 presets 等未用到的模块相对路径受影响
+    js: [
+      `import { createRequire as __hbCreateRequire } from 'module'`,
+      `import __hbPath from 'path'`,
+      `import { fileURLToPath as __hbFileURLToPath } from 'url'`,
+      `const require = __hbCreateRequire(import.meta.url)`,
+      // 用 var：esbuild 对部分 CJS 依赖也会生成 var __filename，重复声明合法
+      `var __filename = __hbFileURLToPath(import.meta.url)`,
+      `var __dirname = __hbPath.dirname(__filename)`,
+    ].join('\n'),
+  },
+  logLevel: 'info',
+})
diff --git a/huobao-source/desktop/scripts/build-main.mjs b/huobao-source/desktop/scripts/build-main.mjs
new file mode 100644
index 0000000..8b2c57e
--- /dev/null
+++ b/huobao-source/desktop/scripts/build-main.mjs
@@ -0,0 +1,27 @@
+/**
+ * esbuild 打包 Electron 主进程与 preload — desktop/src → desktop/dist/
+ * main.ts → dist/main.js（package.json main 入口）；preload.ts → dist/preload.js
+ */
+import { build } from 'esbuild'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import fs from 'node:fs'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+await build({
+  entryPoints: [
+    { in: path.resolve(__dirname, '../src/main.ts'), out: 'main' },
+    { in: path.resolve(__dirname, '../src/preload.ts'), out: 'preload' },
+  ],
+  outdir: path.resolve(__dirname, '../dist'),
+  bundle: true,
+  format: 'cjs',
+  platform: 'node',
+  target: 'node20',
+  external: ['electron'],
+  sourcemap: true,
+  logLevel: 'info',
+})
+
+fs.copyFileSync(path.resolve(__dirname, '../assets/starting.html'), path.resolve(__dirname, '../dist/starting.html'))
diff --git a/huobao-source/desktop/scripts/cos-upload.mjs b/huobao-source/desktop/scripts/cos-upload.mjs
new file mode 100644
index 0000000..654be64
--- /dev/null
+++ b/huobao-source/desktop/scripts/cos-upload.mjs
@@ -0,0 +1,133 @@
+/**
+ * 腾讯 COS(轻量对象存储)XML API 极简上传客户端 — 零外部依赖
+ *
+ * 用法:
+ *   node scripts/cos-upload.mjs --check                          连通性检查(HeadBucket)
+ *   node scripts/cos-upload.mjs <本地文件> <桶内Key> [--cache-control "no-cache"]
+ *
+ * 密钥来源(按优先级): 命令行环境变量 > desktop/.env.local
+ *   TENCENT_SECRET_ID / TENCENT_SECRET_KEY
+ * 桶与地域(可用环境变量覆盖):
+ *   COS_BUCKET(默认 huobao-installer-1304922933)/ COS_REGION(默认 ap-guangzhou)
+ *
+ * 签名: q-sign-algorithm=sha1(腾讯云 COS XML API 鉴权规范),
+ * 只签 host 头,其余头(Cache-Control 等)透传不参与签名。
+ */
+import fs from 'fs'
+import path from 'path'
+import crypto from 'crypto'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const DESKTOP = path.resolve(__dirname, '..')
+
+// 读取 desktop/.env.local(KEY=VALUE 行),不覆盖已有环境变量
+function loadEnvLocal() {
+  const envFile = path.join(DESKTOP, '.env.local')
+  if (!fs.existsSync(envFile)) return
+  for (const line of fs.readFileSync(envFile, 'utf8').split('\n')) {
+    const m = line.match(/^\s*([A-Z0-9_]+)\s*=\s*(.+?)\s*$/)
+    if (m && !process.env[m[1]]) process.env[m[1]] = m[2]
+  }
+}
+loadEnvLocal()
+
+const SECRET_ID = process.env.TENCENT_SECRET_ID
+const SECRET_KEY = process.env.TENCENT_SECRET_KEY
+const BUCKET = process.env.COS_BUCKET || 'huobao-installer-1304922933'
+const REGION = process.env.COS_REGION || 'ap-guangzhou'
+const HOST = `${BUCKET}.cos.${REGION}.myqcloud.com`
+
+function sha1Hex(input) {
+  return crypto.createHash('sha1').update(input).digest('hex')
+}
+function hmacSha1Hex(key, input) {
+  return crypto.createHmac('sha1', key).update(input).digest('hex')
+}
+
+/** COS q-signature(仅签 host 头、无 url 参数) */
+function authorization(method, uriPathname) {
+  const now = Math.floor(Date.now() / 1000)
+  const keyTime = `${now - 60};${now + 3600}`
+  const signKey = hmacSha1Hex(SECRET_KEY, keyTime)
+  const httpString = `${method.toLowerCase()}\n${uriPathname}\n\nhost=${encodeURIComponent(HOST)}\n`
+  const stringToSign = `sha1\n${keyTime}\n${sha1Hex(httpString)}\n`
+  const signature = hmacSha1Hex(signKey, stringToSign)
+  return `q-sign-algorithm=sha1&q-ak=${SECRET_ID}&q-sign-time=${keyTime}&q-key-time=${keyTime}`
+    + `&q-header-list=host&q-url-param-list=&q-signature=${signature}`
+}
+
+export async function cosPut(localFile, key, { cacheControl, contentType } = {}) {
+  const body = fs.readFileSync(localFile)
+  const uriPathname = `/${key.split('/').map(encodeURIComponent).join('/')}`
+  const headers = {
+    'Host': HOST,
+    'Authorization': authorization('PUT', uriPathname),
+    'Content-Length': String(body.length),
+    'Content-MD5': crypto.createHash('md5').update(body).digest('base64'),
+  }
+  if (cacheControl) headers['Cache-Control'] = cacheControl
+  if (contentType) headers['Content-Type'] = contentType
+
+  const res = await fetch(`https://${HOST}${uriPathname}`, {
+    method: 'PUT',
+    headers,
+    body,
+    signal: AbortSignal.timeout(600_000),
+  })
+  if (!res.ok) {
+    const text = await res.text()
+    throw new Error(`COS PUT ${key} 失败 HTTP ${res.status}: ${text.slice(0, 300)}`)
+  }
+  return `https://${HOST}${uriPathname}`
+}
+
+export async function cosHeadBucket() {
+  const res = await fetch(`https://${HOST}/`, {
+    method: 'HEAD',
+    headers: { 'Host': HOST, 'Authorization': authorization('HEAD', '/') },
+    signal: AbortSignal.timeout(15_000),
+  })
+  return res.status
+}
+
+export async function cosDelete(key) {
+  const uriPathname = `/${key.split('/').map(encodeURIComponent).join('/')}`
+  const res = await fetch(`https://${HOST}${uriPathname}`, {
+    method: 'DELETE',
+    headers: { 'Host': HOST, 'Authorization': authorization('DELETE', uriPathname) },
+    signal: AbortSignal.timeout(15_000),
+  })
+  if (!res.ok && res.status !== 404) throw new Error(`COS DELETE ${key} 失败 HTTP ${res.status}`)
+}
+
+// ---- CLI ----
+const isMain = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+if (isMain) {
+  if (!SECRET_ID || !SECRET_KEY) {
+    console.error('缺少 TENCENT_SECRET_ID / TENCENT_SECRET_KEY(写入 desktop/.env.local 或环境变量)')
+    process.exit(1)
+  }
+  const args = process.argv.slice(2)
+  if (args[0] === '--check') {
+    const status = await cosHeadBucket()
+    console.log(status === 200 ? `连通正常 ✓ (${HOST})` : `HeadBucket 返回 ${status}(401=密钥错,403=无权限,404=桶名错)`)
+    process.exit(status === 200 ? 0 : 1)
+  }
+  if (args[0] === '--rm') {
+    await cosDelete(args[1])
+    console.log(`✓ 已删除 ${args[1]}`)
+    process.exit(0)
+  }
+  const [localFile, key] = args
+  const ccIdx = args.indexOf('--cache-control')
+  const cacheControl = ccIdx >= 0 ? args[ccIdx + 1] : undefined
+  if (!localFile || !key || !fs.existsSync(localFile)) {
+    console.error('用法: node scripts/cos-upload.mjs <本地文件> <桶内Key> [--cache-control "..."]')
+    process.exit(1)
+  }
+  const start = Date.now()
+  const url = await cosPut(localFile, key, { cacheControl })
+  const mb = (fs.statSync(localFile).size / 1048576).toFixed(1)
+  console.log(`✓ ${path.basename(localFile)} (${mb}MB, ${((Date.now() - start) / 1000).toFixed(0)}s)\n  ${url}`)
+}
diff --git a/huobao-source/desktop/scripts/make-update-feed.mjs b/huobao-source/desktop/scripts/make-update-feed.mjs
new file mode 100644
index 0000000..c6b697f
--- /dev/null
+++ b/huobao-source/desktop/scripts/make-update-feed.mjs
@@ -0,0 +1,83 @@
+/**
+ * 生成应用内更新器使用的版本清单 latest.json
+ *
+ * 用法：npm run dist / dist:win 完成后执行 `node scripts/make-update-feed.mjs`
+ *   --base-url <url>  下载基址，默认 GitHub Releases 直链
+ *                     （https://github.com/<owner>/<repo>/releases/download/v<version>）
+ *   --notes "文本"    本次更新说明
+ *
+ * 产物 release/latest.json 结构：
+ * { version, notes, platforms: { "<platform>-<arch>": { url, sha256, size } } }
+ *
+ * 发布：把 latest.json 与安装包一起上传到 GitHub Release（tag 形如 v1.0.1），
+ * 更新器默认拉 releases/latest/download/latest.json 即完成推送。
+ */
+import fs from 'fs'
+import path from 'path'
+import crypto from 'crypto'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const DESKTOP = path.resolve(__dirname, '..')
+const RELEASE = path.join(DESKTOP, 'release')
+
+const argv = process.argv.slice(2)
+function argOf(flag) {
+  const i = argv.indexOf(flag)
+  return i >= 0 ? argv[i + 1] : undefined
+}
+
+const pkg = JSON.parse(fs.readFileSync(path.join(DESKTOP, 'package.json'), 'utf8'))
+const version = pkg.version
+const repo = process.env.GITHUB_REPO || 'chatfire-AI/huobao-drama'
+const baseUrl = argOf('--base-url')
+  || process.env.UPDATE_BASE_URL
+  || `https://github.com/${repo}/releases/download/v${version}`
+const notes = argOf('--notes') || ''
+
+function sha256(file) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha256')
+    fs.createReadStream(file)
+      .on('data', chunk => hash.update(chunk))
+      .on('end', () => resolve(hash.digest('hex')))
+      .on('error', reject)
+  })
+}
+
+// 平台键（与更新器 process.platform-process.arch 一致）→ 产物文件名
+// （electron-builder 的 mac zip 命名带 -mac 后缀）
+const targets = [
+  { key: 'darwin-arm64', file: `HuobaoDrama-${version}-arm64-mac.zip` },
+  { key: 'darwin-x64', file: `HuobaoDrama-${version}-mac.zip` },
+  { key: 'win32-x64', file: `HuobaoDrama Setup ${version}.exe` },
+]
+
+const platforms = {}
+const missing = []
+for (const t of targets) {
+  const file = path.join(RELEASE, t.file)
+  if (!fs.existsSync(file)) {
+    missing.push(t.file)
+    continue
+  }
+  platforms[t.key] = {
+    // GitHub 上传资产时会把空格规范化为点号(gh CLI 与 API 均如此,无法保留空格),
+    // URL 必须按服务端实际资产名生成,否则下载 404
+    url: `${baseUrl}/${encodeURIComponent(t.file.replace(/ /g, '.'))}`,
+    sha256: await sha256(file),
+    size: fs.statSync(file).size,
+  }
+}
+
+if (missing.length === targets.length) {
+  console.error('release/ 下没有任何更新产物，请先运行 npm run dist / dist:win')
+  process.exit(1)
+}
+
+const feed = { version, notes, platforms }
+const out = path.join(RELEASE, 'latest.json')
+fs.writeFileSync(out, JSON.stringify(feed, null, 2))
+console.log(`latest.json ✓ (${Object.keys(platforms).length} 平台)`)
+if (missing.length) console.warn(`缺失产物（未纳入清单）: ${missing.join(', ')}`)
+console.log(out)
diff --git a/huobao-source/desktop/scripts/prepare-mac-media.mjs b/huobao-source/desktop/scripts/prepare-mac-media.mjs
new file mode 100644
index 0000000..7f9b935
--- /dev/null
+++ b/huobao-source/desktop/scripts/prepare-mac-media.mjs
@@ -0,0 +1,63 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { execFile, execFileSync } from 'node:child_process'
+import { createRequire } from 'node:module'
+import { promisify } from 'node:util'
+import { createGunzip } from 'node:zlib'
+import { pipeline } from 'node:stream/promises'
+
+const run = promisify(execFile)
+const require = createRequire(import.meta.url)
+const release = require('ffmpeg-static/package.json')['ffmpeg-static']['binary-release-tag']
+
+export function assertMacArchitecture(file, arch) {
+  execFileSync('lipo', ['-verify_arch', arch === 'x64' ? 'x86_64' : arch, file], { stdio: 'pipe' })
+}
+
+export async function prepareMacMedia(desktop, resources) {
+  // npm skips optional binaries for the other CPU even when they are declared.
+  // Fetch exact versions from sharp's dependency map before cross-packaging.
+  const optional = require('sharp/package.json').optionalDependencies
+  for (const arch of ['arm64', 'x64']) {
+    for (const name of [`sharp-darwin-${arch}`, `sharp-libvips-darwin-${arch}`]) {
+      const destination = path.join(desktop, 'node_modules', '@img', name)
+      if (fs.existsSync(path.join(destination, 'package.json'))) continue
+      const cache = path.join(desktop, 'build', 'mac-native', name)
+      fs.mkdirSync(cache, { recursive: true })
+      const { stdout } = await run('npm', ['pack', `@img/${name}@${optional[`@img/${name}`]}`,
+        '--ignore-scripts', '--json', '--registry=https://registry.npmjs.org', '--pack-destination', cache])
+      const [{ filename }] = JSON.parse(stdout)
+      fs.mkdirSync(destination, { recursive: true })
+      await run('tar', ['-xzf', path.join(cache, filename), '--strip-components=1', '-C', destination])
+      console.log(`[native] ${name} ✓`)
+    }
+  }
+  await Promise.all(['arm64', 'x64'].flatMap(arch => ['ffmpeg', 'ffprobe'].map(async name => {
+    const cache = path.join(desktop, 'build', 'mac-bin', release, arch)
+    const binary = path.join(cache, name)
+    fs.mkdirSync(cache, { recursive: true })
+    if (!fs.existsSync(binary)) {
+      const archive = `${binary}.gz.part`
+      const temporary = `${binary}.part`
+      try {
+        console.log(`[media] downloading ${name} for macOS ${arch} (${release})`)
+        await run('curl', ['--fail', '--location', '--silent', '--show-error', '--retry', '3',
+          '--connect-timeout', '15', '--max-time', '300', '--output', archive,
+          `https://github.com/eugeneware/ffmpeg-static/releases/download/${release}/${name}-darwin-${arch}.gz`])
+        await pipeline(fs.createReadStream(archive), createGunzip(), fs.createWriteStream(temporary))
+        assertMacArchitecture(temporary, arch)
+        fs.chmodSync(temporary, 0o755)
+        fs.renameSync(temporary, binary)
+      } finally {
+        fs.rmSync(archive, { force: true })
+        fs.rmSync(temporary, { force: true })
+      }
+    }
+    assertMacArchitecture(binary, arch)
+    const dest = path.join(resources, `bin-mac-${arch}`)
+    fs.mkdirSync(dest, { recursive: true })
+    fs.copyFileSync(binary, path.join(dest, name))
+    fs.chmodSync(path.join(dest, name), 0o755)
+    console.log(`[media] ${arch}/${name} ✓`)
+  })))
+}
diff --git a/huobao-source/desktop/scripts/prepare-resources.mjs b/huobao-source/desktop/scripts/prepare-resources.mjs
new file mode 100644
index 0000000..0ebb0ef
--- /dev/null
+++ b/huobao-source/desktop/scripts/prepare-resources.mjs
@@ -0,0 +1,56 @@
+/**
+ * 打包资源准备 — 组装 desktop/resources/（electron-builder extraResources 的来源）
+ *
+ * 1. frontend/           ← nuxt generate 产物（.output/public，含 index.html）
+ * 2. workspace-template/ ← backend/workspace（skills + prompts，首启动拷入 userData）
+ * 3. bin-<os>-<arch>/    ← ffmpeg/ffprobe 按平台与架构分目录（electron-builder 宏各取所需，
+ *                          避免 mac 包带 exe、win 包带 mac 二进制白白 +144MB）
+ */
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { createRequire } from 'module'
+import { prepareMacMedia } from './prepare-mac-media.mjs'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const DESKTOP = path.resolve(__dirname, '..')
+const REPO = path.resolve(DESKTOP, '..')
+const RES = path.join(DESKTOP, 'resources')
+
+fs.rmSync(RES, { recursive: true, force: true })
+fs.mkdirSync(RES, { recursive: true })
+
+// 1. 前端静态产物
+const frontendSrc = path.join(REPO, 'frontend', '.output', 'public')
+if (!fs.existsSync(path.join(frontendSrc, 'index.html'))) {
+  console.error('缺少前端产物：请先在 frontend/ 执行 npm run generate')
+  process.exit(1)
+}
+fs.cpSync(frontendSrc, path.join(RES, 'frontend'), { recursive: true })
+console.log('resources/frontend ✓')
+
+// 2. workspace 模板（skills 技能 + prompts 提示词）
+const workspaceSrc = path.join(REPO, 'backend', 'workspace')
+fs.cpSync(workspaceSrc, path.join(RES, 'workspace-template'), { recursive: true })
+console.log('resources/workspace-template ✓')
+
+// 3. macOS 两种架构独立准备；ffprobe-static 的 arm64 目录实际可能含 x64 二进制，
+//    因此两种媒体工具统一使用 ffmpeg-static 对应版本的官方发布产物。
+const req = createRequire(import.meta.url)
+if (process.platform === 'darwin') await prepareMacMedia(DESKTOP, RES)
+const binWin = path.join(RES, 'bin-win-x64')
+fs.mkdirSync(binWin, { recursive: true })
+
+// 3b. Windows 二进制（打 win 包用；不打 win 包时缺失不报错，仅提示）
+const winBinDir = path.join(DESKTOP, 'build', 'win-bin')
+const ffmpegWin = path.join(winBinDir, 'ffmpeg.exe')
+const ffprobeWinSrc = path.join(path.dirname(req.resolve('ffprobe-static/package.json')), 'bin', 'win32', 'x64', 'ffprobe.exe')
+if (!fs.existsSync(ffmpegWin)) {
+  console.warn('提示: 缺少 build/win-bin/ffmpeg.exe，Windows 包将无法内置 ffmpeg。' +
+    '获取: https://github.com/eugeneware/ffmpeg-static/releases/download/b6.0/ffmpeg-win32-x64')
+}
+if (fs.existsSync(ffmpegWin) && fs.existsSync(ffprobeWinSrc)) {
+  fs.copyFileSync(ffmpegWin, path.join(binWin, 'ffmpeg.exe'))
+  fs.copyFileSync(ffprobeWinSrc, path.join(binWin, 'ffprobe.exe'))
+  console.log('resources/bin-win-x64 ✓')
+}
diff --git a/huobao-source/desktop/scripts/publish-release.mjs b/huobao-source/desktop/scripts/publish-release.mjs
new file mode 100644
index 0000000..a712174
--- /dev/null
+++ b/huobao-source/desktop/scripts/publish-release.mjs
@@ -0,0 +1,142 @@
+/**
+ * 一键发布 — GitHub Releases(海外) + 腾讯 COS(国内) 双通道
+ *
+ * 用法(在 desktop/ 下执行):
+ *   npm run publish [-- --notes "更新说明"] [-- --skip-gh]
+ *
+ * 前置:
+ *   - desktop/release/ 已有本版本产物(npm run dist / dist:win 之后)
+ *   - gh 已登录(上传 GitHub);desktop/.env.local 已配 TENCENT_SECRET_ID/KEY(上传 COS)
+ *
+ * 产物布局:
+ *   GitHub: vX.Y.Z Release(空格文件名自动规范化为点号,见 make-update-feed)
+ *   COS:    huobao-drama/vX.Y.Z/<点号文件名> + huobao-drama/latest.json(指向 COS 直链)
+ *
+ * 国内下载基址(COS_BASE_URL)与更新器兜底源保持一致,将来绑自定义域名/加 CDN 只改这一处。
+ */
+import fs from 'fs'
+import path from 'path'
+import crypto from 'crypto'
+import { execFileSync } from 'child_process'
+import { fileURLToPath } from 'url'
+import { cosPut } from './cos-upload.mjs'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const DESKTOP = path.resolve(__dirname, '..')
+const RELEASE = path.join(DESKTOP, 'release')
+
+/** 国内下载基址：默认使用安装包 CDN，可被 COS_BASE_URL 覆盖。 */
+const COS_BASE_URL = process.env.COS_BASE_URL || 'https://installer.firemux.site/huobao-drama'
+const COS_KEY_PREFIX = 'huobao-drama'
+
+const pkg = JSON.parse(fs.readFileSync(path.join(DESKTOP, 'package.json'), 'utf8'))
+const version = pkg.version
+const tag = `v${version}`
+
+const argv = process.argv.slice(2)
+function argOf(flag) { const i = argv.indexOf(flag); return i >= 0 ? argv[i + 1] : undefined }
+const notes = argOf('--notes') || ''
+const skipGh = argv.includes('--skip-gh')
+
+// 与 make-update-feed 相同的产物清单。注意 electron-builder 的 NSIS 本地产物带空格
+// （HuobaoDrama Setup X.Y.Z.exe），GitHub 服务端会规范化为点号；COS key/URL 需自行归一化
+const assets = [
+  `HuobaoDrama-${version}-arm64.dmg`,
+  `HuobaoDrama-${version}.dmg`,
+  `HuobaoDrama-${version}-arm64-mac.zip`,
+  `HuobaoDrama-${version}-mac.zip`,
+  `HuobaoDrama Setup ${version}.exe`,
+]
+// URL/COS key 使用的规范化文件名（空格 → 点号，与 GitHub 服务端一致）
+const dotName = (f) => f.replace(/ /g, '.')
+const existing = assets.filter(f => fs.existsSync(path.join(RELEASE, f)))
+if (existing.length !== assets.length) {
+  console.error(`发布需要全部平台产物，缺少: ${assets.filter(f => !existing.includes(f)).join(', ')}`)
+  process.exit(1)
+}
+
+// ---- 1. GitHub(海外通道) ----
+if (!skipGh) {
+  console.log(`[1/3] GitHub Release ${tag} …`)
+  // gh release upload 要求 Release 已存在，不存在则先创建（--clobber 才能重复传）
+  try {
+    execFileSync('gh', ['release', 'view', tag], { stdio: 'ignore' })
+  } catch {
+    console.log(`  Release 不存在，先创建 …`)
+    execFileSync('gh', ['release', 'create', tag, '--title', tag, '--notes', notes || tag], { stdio: 'inherit' })
+  }
+  const ghArgs = ['release', 'upload', tag, ...existing.map(f => path.join(RELEASE, f)), '--clobber']
+  execFileSync('gh', ghArgs, { stdio: 'inherit' })
+  console.log(`  ✓ 已上传 ${existing.length} 个资产`)
+}
+
+// ---- 2. latest.json(双通道各一份:GitHub 版指向 GitHub,COS 版指向 COS) ----
+console.log('[2/3] 生成更新清单 latest.json …')
+async function sha256(file) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha256')
+    fs.createReadStream(file).on('data', c => hash.update(c)).on('end', () => resolve(hash.digest('hex'))).on('error', reject)
+  })
+}
+const buildFeed = async (baseUrl) => {
+  const platforms = {}
+  for (const f of existing) {
+    const key = f.includes('Setup') ? 'win32-x64'
+      : f.includes('-arm64') ? 'darwin-arm64'
+      : 'darwin-x64'
+    // 同一平台 dmg/zip 都存在时只取 zip(更新器用),dmg 是给手动安装的
+    if (key !== 'win32-x64' && !f.endsWith('.zip')) continue
+    platforms[key] = {
+      url: `${baseUrl}/${encodeURIComponent(dotName(f))}`,
+      sha256: await sha256(path.join(RELEASE, f)),
+      size: fs.statSync(path.join(RELEASE, f)).size,
+    }
+  }
+  return { version, notes, platforms }
+}
+
+// GitHub 版(沿用 make-update-feed 的 base-url 约定)
+const ghFeed = await buildFeed(`https://github.com/chatfire-AI/huobao-drama/releases/download/${tag}`)
+fs.writeFileSync(path.join(RELEASE, 'latest.json'), JSON.stringify(ghFeed, null, 2))
+if (!skipGh) execFileSync('gh', ['release', 'upload', tag, path.join(RELEASE, 'latest.json'), '--clobber'], { stdio: 'inherit' })
+
+// COS 版(桶内固定路径 latest.json,更新器国内源入口)
+const cosFeed = await buildFeed(`${COS_BASE_URL}/v${version}`)
+fs.writeFileSync(path.join(RELEASE, 'latest.cos.json'), JSON.stringify(cosFeed, null, 2))
+console.log(`  ✓ latest.json(GitHub) / latest.cos.json(COS) 平台: ${Object.keys(cosFeed.platforms).join(', ')}`)
+
+// ---- 3. COS(国内通道) ----
+console.log('[3/3] 上传腾讯 COS …')
+for (const f of existing) {
+  await cosPut(path.join(RELEASE, f), `${COS_KEY_PREFIX}/v${version}/${dotName(f)}`, {
+    cacheControl: 'public, max-age=2592000', // 安装包按版本命名内容不变,缓存 30 天
+  })
+  console.log(`  ✓ v${version}/${dotName(f)}`)
+}
+await cosPut(path.join(RELEASE, 'latest.cos.json'), `${COS_KEY_PREFIX}/latest.json`, {
+  cacheControl: 'no-cache', // 更新发现入口,必须实时
+})
+console.log(`  ✓ latest.json (no-cache)`)
+
+// 官网使用脚本清单跨域加载，无需修改 COS 桶级 CORS。安装包全部上传后才更新。
+const websiteRelease = {
+  version,
+  downloads: {
+    'darwin-arm64': `${COS_BASE_URL}/${tag}/HuobaoDrama-${version}-arm64.dmg`,
+    'darwin-x64': `${COS_BASE_URL}/${tag}/HuobaoDrama-${version}.dmg`,
+    'win32-x64': `${COS_BASE_URL}/${tag}/HuobaoDrama.Setup.${version}.exe`,
+  },
+}
+const websiteFeedPath = path.join(RELEASE, 'latest.js')
+fs.writeFileSync(websiteFeedPath, `window.huobaoDramaRelease(${JSON.stringify(websiteRelease)});\n`)
+await cosPut(websiteFeedPath, `${COS_KEY_PREFIX}/latest.js`, {
+  cacheControl: 'no-cache',
+  contentType: 'application/javascript; charset=utf-8',
+})
+console.log('  ✓ latest.js (官网自动下载清单)')
+
+console.log(`
+发布完成:
+  海外  https://github.com/chatfire-AI/huobao-drama/releases/${tag}
+  国内  ${COS_BASE_URL}/latest.json
+`)
diff --git a/huobao-source/desktop/scripts/validate-windows-package.mjs b/huobao-source/desktop/scripts/validate-windows-package.mjs
new file mode 100644
index 0000000..70742ce
--- /dev/null
+++ b/huobao-source/desktop/scripts/validate-windows-package.mjs
@@ -0,0 +1,37 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { createRequire } from 'node:module'
+const require = createRequire(import.meta.url)
+const asar = require('@electron/asar')
+const { getAbi } = require('node-abi')
+
+export function assertWindowsX64(file) {
+  const bytes = fs.readFileSync(file)
+  const offset = bytes.length >= 64 ? bytes.readUInt32LE(60) : 0
+  if (bytes.toString('ascii', 0, 2) !== 'MZ' || offset < 64 || offset + 6 > bytes.length
+      || bytes.toString('ascii', offset, offset + 4) !== 'PE\0\0' || bytes.readUInt16LE(offset + 4) !== 0x8664) {
+    throw new Error(`不是 Windows x64 PE 二进制：${file}`)
+  }
+  return bytes
+}
+
+export function validateWindowsPackage(resourcesDir, electronVersion) {
+  const archive = path.join(resourcesDir, 'app.asar')
+  for (const file of ['dist/main.js', 'dist/preload.js', 'dist/starting.html', 'build/backend.mjs']) {
+    if (!asar.extractFile(archive, file).length) throw new Error(`安装包内容为空：${file}`)
+  }
+  for (const file of ['frontend/index.html', 'workspace-template/prompts/storyboard_breaker.md']) {
+    if (!fs.statSync(path.join(resourcesDir, file)).isFile()) throw new Error(`安装包资源缺失：${file}`)
+  }
+  const nativeRoot = path.join(resourcesDir, 'app.asar.unpacked/node_modules')
+  const sqlite = assertWindowsX64(path.join(nativeRoot, 'better-sqlite3/build/Release/better_sqlite3.node'))
+  const abi = getAbi(electronVersion, 'electron')
+  if (!sqlite.includes(Buffer.from(`node_register_module_v${abi}\0`))) {
+    throw new Error(`Windows SQLite 原生模块与 Electron ${electronVersion} (ABI ${abi}) 不匹配`)
+  }
+  for (const file of ['sharp-win32-x64.node', 'libvips-42.dll', 'libvips-cpp-8.17.3.dll']) {
+    assertWindowsX64(path.join(nativeRoot, '@img/sharp-win32-x64/lib', file))
+  }
+  for (const file of ['ffmpeg.exe', 'ffprobe.exe']) assertWindowsX64(path.join(resourcesDir, 'bin', file))
+  console.log(`[package-check] Windows x64 启动资源完整；SQLite ABI ${abi} ✓`)
+}
diff --git a/huobao-source/desktop/src/main.ts b/huobao-source/desktop/src/main.ts
new file mode 100644
index 0000000..5fc28bb
--- /dev/null
+++ b/huobao-source/desktop/src/main.ts
@@ -0,0 +1,409 @@
+/**
+ * Electron 主进程 — 桌面壳
+ *
+ * 职责：显示启动页 → 读存储配置 / 取空闲端口 → 准备数据与 workspace →
+ * utilityProcess.fork 拉起后端 → 有截止时间的健康检查 → 窗口切入应用页面。
+ * 后端与窗口同源（http://127.0.0.1:<port>），前端全部相对路径，无 CORS 问题。
+ *
+ * 后端可重启（startBackend）：存储位置迁移 = 停后端 → 搬文件 → 换 currentDataDir →
+ * 重启后端（见 migrate.ts）；backendRestarting 期间抑制「异常退出」弹窗。
+ */
+import { app, BrowserWindow, dialog, ipcMain, shell, utilityProcess } from 'electron'
+import type { UtilityProcess } from 'electron'
+import * as net from 'net'
+import * as fs from 'fs'
+import * as fsp from 'fs/promises'
+import * as path from 'path'
+import { registerMigrationIpc } from './migrate'
+import { registerUpdater, markQuitting } from './updater'
+import { createStartupLog, redactStartupLog, waitForBackend } from './startup'
+import { resolveRuntimeResources } from './runtime-resources'
+
+// 主进程打 CJS 产物，__dirname 天然可用（import.meta.url 在 CJS 下为 undefined）
+declare const __dirname: string
+// desktop/dist → desktop 根
+const DESKTOP_ROOT = path.resolve(__dirname, '..')
+// dev 模式下仓库各目录
+const REPO_ROOT = path.resolve(DESKTOP_ROOT, '..')
+const BACKEND_BUNDLE = path.join(DESKTOP_ROOT, 'build', 'backend.mjs')
+let backendBundle = BACKEND_BUNDLE
+let runtimeResourcesDir = ''
+
+/** workspace 模板版本：内置模板更新时递增，触发向用户目录补缺失文件 */
+const TEMPLATE_VERSION = '4'
+const STORAGE_CONFIG_FILE = 'storage-config.json'
+
+let mainWindow: BrowserWindow | null = null
+let backend: UtilityProcess | null = null
+let quitting = false
+let backendRestarting = false
+let backendPort = 0
+let currentDataDir = ''
+let backendReady = false
+let fatalReported = false
+let backendStartupTail = ''
+
+// userData 显式按模式区分：打包版 / dev 版互不干扰（数据库、上传文件、单实例锁均隔离），
+// 不依赖 package.json 命名（打包后与 dev 同名会导致单实例锁误杀）
+const userDataDir = path.join(
+  app.getPath('appData'),
+  app.isPackaged ? 'HuobaoDrama' : 'HuobaoDrama-Dev',
+)
+try {
+  fs.mkdirSync(userDataDir, { recursive: true })
+  app.setPath('userData', userDataDir)
+} catch (error) {
+  dialog.showErrorBox('火宝短剧启动失败', `无法准备用户目录：${userDataDir}\n${(error as Error).message}`)
+  app.exit(1)
+}
+
+const startupLog = createStartupLog(path.join(app.getPath('userData'), 'logs'))
+startupLog.write(`launch version=${app.getVersion()} platform=${process.platform} arch=${process.arch} electron=${process.versions.electron} pid=${process.pid}`)
+
+function failStartup(error: unknown) {
+  if (fatalReported || quitting) return
+  fatalReported = true
+  const message = redactStartupLog(error instanceof Error ? error.message : error)
+  startupLog.write(`fatal: ${error instanceof Error ? error.stack : error}`)
+  showMainWindow()
+  dialog.showErrorBox('火宝短剧启动失败', `${message}\n\n启动日志：${startupLog.file}\n请将此日志发给技术支持，无需删除项目数据。`)
+  app.quit()
+}
+process.on('uncaughtException', failStartup)
+process.on('unhandledRejection', failStartup)
+app.on('child-process-gone', (_event, details) => {
+  startupLog.write(`child-process-gone: ${JSON.stringify(details)}`)
+})
+
+function showMainWindow() {
+  if (!mainWindow || mainWindow.isDestroyed()) return
+  if (mainWindow.isMinimized()) mainWindow.restore()
+  mainWindow.show()
+  mainWindow.focus()
+}
+
+// 从终端启动时若父进程管道关闭（如 `| head` 退出/终端关闭），转发后端日志会写出
+// EPIPE 且属于异步回调抛出，try/catch 拦不住，会弹 "write EPIPE" 未捕获异常框
+process.stdout.on('error', () => {})
+process.stderr.on('error', () => {})
+
+if (!app.requestSingleInstanceLock()) {
+  // 双开会抢 SQLite 写锁；让已有实例聚焦窗口即可
+  startupLog.write('second launch: handing off to existing instance')
+  app.quit()
+} else {
+  app.on('second-instance', () => {
+    startupLog.write('second-instance: showing existing window')
+    showMainWindow()
+  })
+  app.on('activate', showMainWindow)
+  // utilityProcess 要求 app ready 之后才能创建
+  app.whenReady().then(bootstrap).catch(failStartup)
+}
+
+function getFreePort(): Promise<number> {
+  return new Promise((resolve, reject) => {
+    const srv = net.createServer()
+    srv.listen(0, '127.0.0.1', () => {
+      const addr = srv.address() as net.AddressInfo
+      srv.close(() => resolve(addr.port))
+    })
+    srv.on('error', reject)
+  })
+}
+
+async function waitHealthy(port: number, timeoutMs = 60_000): Promise<void> {
+  await waitForBackend(port, timeoutMs, () => quitting || fatalReported)
+  backendReady = true
+}
+
+// ---- 存储配置（userData/storage-config.json，必须在数据目录之外） ----
+
+function storageConfigPath(): string {
+  return path.join(app.getPath('userData'), STORAGE_CONFIG_FILE)
+}
+
+/**
+ * 读存储配置，返回当前数据目录。容错链：文件不存在→默认；解析失败/非法→warn+默认
+ * （不改写坏文件，保留现场）；目录创建失败（盘不在/权限）→warn+默认。永不阻断启动。
+ */
+function loadStorageConfig(): string {
+  const fallback = app.isPackaged ? path.resolve(process.resourcesPath, '../../huobao-data') : path.join(app.getPath('userData'), 'data')
+  const file = storageConfigPath()
+  if (!fs.existsSync(file)) return fallback
+  try {
+    const parsed = JSON.parse(fs.readFileSync(file, 'utf8'))
+    const dir = parsed?.dataDir
+    if (typeof dir !== 'string' || !path.isAbsolute(dir)) throw new Error('dataDir 非绝对路径')
+    fs.mkdirSync(dir, { recursive: true })
+    return dir
+  } catch (err) {
+    console.warn(`[main] ${STORAGE_CONFIG_FILE} 读取失败，回退默认数据目录: ${(err as Error).message}`)
+    return fallback
+  }
+}
+
+/** 原子写存储配置（tmp + rename）；仅迁移成功路径调用 */
+export function writeStorageConfig(dataDir: string): void {
+  const file = storageConfigPath()
+  const tmp = `${file}.tmp`
+  fs.writeFileSync(tmp, JSON.stringify({ version: 1, dataDir }, null, 2))
+  fs.renameSync(tmp, file)
+}
+
+/** win32 路径比较统一小写 */
+export function normCase(p: string): string {
+  return process.platform === 'win32' ? p.toLowerCase() : p
+}
+
+// ---- workspace 模板 ----
+
+/**
+ * workspace 模板拷贝（copy-once + 版本标记）：
+ * - 目标无版本标记（首启动）或版本较旧 → 只补缺失文件，永不覆盖用户编辑
+ * - 版本一致 → 跳过
+ * 例外：prompts/ 随版本升级强制覆盖——prompt 与代码内 DEFAULT_PROMPTS 同源迭代
+ * （设置页有「恢复默认」，且编辑场景少）；skills/ 保持只增不覆盖（可能有用户新建）
+ */
+function syncWorkspaceTemplate(templateDir: string, destDir: string) {
+  const marker = path.join(destDir, '.template-version')
+  if (fs.existsSync(marker) && fs.readFileSync(marker, 'utf8').trim() === TEMPLATE_VERSION) return
+  fs.cpSync(templateDir, destDir, { recursive: true, force: false, errorOnExist: false })
+  fs.cpSync(path.join(templateDir, 'prompts'), path.join(destDir, 'prompts'), { recursive: true, force: true })
+  fs.writeFileSync(marker, TEMPLATE_VERSION)
+}
+
+function resolveResourceDir(): string {
+  // 打包后在 resources/（extraResources）；dev 直指仓库目录
+  return app.isPackaged ? process.resourcesPath : REPO_ROOT
+}
+
+// ---- 后端进程（可重启） ----
+
+/** 停后端并等待退出（kill 后等 exit 事件，5s 超时补刀）；置 backendRestarting 抑制致命弹窗 */
+function stopBackend(): Promise<void> {
+  return new Promise((resolve) => {
+    const cur = backend
+    if (!cur) return resolve()
+    backendRestarting = true
+    const timer = setTimeout(() => cur.kill(), 5000)
+    cur.once('exit', () => {
+      clearTimeout(timer)
+      resolve()
+    })
+    cur.kill()
+  })
+}
+
+function startBackend(): void {
+  backendReady = false
+  backendStartupTail = ''
+  const resources = runtimeResourcesDir || resolveResourceDir()
+  const env: NodeJS.ProcessEnv = {
+    ...process.env,
+    PORT: String(backendPort),
+    HUOBAO_DESKTOP: '1',
+    // 数据目录单一来源：重启/迁移后只需改 currentDataDir
+    HUOBAO_DATA_DIR: currentDataDir,
+    SQLITE_PATH: path.join(currentDataDir, 'huobao.sqlite3'),
+    WORKSPACE_PATH: currentWorkspaceDir,
+    FRONTEND_DIST: currentFrontendDist,
+  }
+  if (app.isPackaged) {
+    const exe = process.platform === 'win32' ? '.exe' : ''
+    env.FFMPEG_BIN = path.join(resources, 'bin', `ffmpeg${exe}`)
+    env.FFPROBE_BIN = path.join(resources, 'bin', `ffprobe${exe}`)
+  }
+
+  backend = utilityProcess.fork(backendBundle, [], {
+    env,
+    serviceName: 'huobao-backend',
+    stdio: 'pipe',
+    cwd: currentDataDir,
+  })
+  const child = backend
+  startupLog.write(`backend forked from ${backendBundle}`)
+  child.on('spawn', () => startupLog.write(`backend spawned pid=${child.pid}`))
+  child.stdout?.on('data', chunk => {
+    process.stdout.write(`[backend] ${chunk}`)
+    if (!backendReady) startupLog.write(`[backend] ${chunk}`)
+  })
+  child.stderr?.on('data', chunk => {
+    process.stderr.write(`[backend] ${chunk}`)
+    if (!backendReady) {
+      const safe = redactStartupLog(String(chunk))
+      backendStartupTail = (backendStartupTail + safe).slice(-3000)
+      startupLog.write(`[backend stderr] ${safe}`)
+    }
+  })
+  child.on('exit', code => {
+    if (backend === child) backend = null
+    startupLog.write(`backend exited code=${code} restarting=${backendRestarting}`)
+    // 迁移/重启期间的退出是预期行为，由调用方接管
+    if (!quitting && !backendRestarting) {
+      failStartup(new Error(`后台服务异常退出（code ${code}）。${backendStartupTail ? '\n' + backendStartupTail : ''}`))
+    }
+  })
+}
+
+// ---- 窗口 ----
+
+function createWindow() {
+  mainWindow = new BrowserWindow({
+    width: 1440,
+    height: 900,
+    title: '火宝短剧',
+    show: true,
+    backgroundColor: '#f6f7fb',
+    webPreferences: {
+      preload: path.join(__dirname, 'preload.js'),
+    },
+  })
+  mainWindow.once('ready-to-show', showMainWindow)
+  mainWindow.webContents.on('render-process-gone', (_event, details) => failStartup(new Error(`界面进程退出：${details.reason} (${details.exitCode})`)))
+  mainWindow.webContents.on('unresponsive', () => startupLog.write('renderer unresponsive'))
+  // 页面标题自带产品名，避免文件路径兜底标题
+  mainWindow.on('page-title-updated', e => e.preventDefault())
+  mainWindow.on('closed', () => { mainWindow = null })
+  // 外链一律交给系统浏览器：应用内不弹新窗（如设置页「前往 api.firemux.cn 获取 Key」）
+  const isAppUrl = (url: string) => {
+    try { return new URL(url).origin === `http://127.0.0.1:${backendPort}` } catch { return false }
+  }
+  mainWindow.webContents.setWindowOpenHandler(({ url }) => {
+    if (/^https?:\/\//i.test(url) && !isAppUrl(url)) void shell.openExternal(url)
+    return { action: 'deny' }
+  })
+  // 主窗口意外导航到外部地址时同样拦下并转浏览器
+  mainWindow.webContents.on('will-navigate', (e, url) => {
+    if (isAppUrl(url)) return
+    e.preventDefault()
+    if (/^https?:\/\//i.test(url)) void shell.openExternal(url)
+  })
+  return mainWindow.loadFile(path.join(__dirname, 'starting.html'))
+}
+
+// ---- 启动 ----
+
+let currentWorkspaceDir = ''
+let currentFrontendDist = ''
+
+async function bootstrap() {
+  try {
+    await createWindow()
+    if (quitting) return
+    backendPort = await getFreePort()
+    const userData = app.getPath('userData')
+    startupLog.write(`port=${backendPort} userData=${userData}`)
+
+    // 存储配置最先读（决定数据目录）；配置损坏时回退默认且不阻断启动
+    currentDataDir = loadStorageConfig()
+    if (app.isPackaged && fs.existsSync(path.join(process.resourcesPath, 'huobao-local-build.json')) && !fs.existsSync(path.join(currentDataDir, 'huobao.sqlite3'))) {
+      throw new Error(`未找到原有数据库，已停止启动以避免创建空项目库。请检查数据目录：${currentDataDir}`)
+    }
+    fs.mkdirSync(currentDataDir, { recursive: true })
+
+    const resources = resolveResourceDir()
+    runtimeResourcesDir = app.isPackaged
+      ? await resolveRuntimeResources(resources, {
+        platform: process.platform,
+        version: app.getVersion(),
+        userDataDir: userData,
+        programDataDir: process.env.ProgramData,
+        log: message => startupLog.write(message),
+      })
+      : resources
+    if (app.isPackaged) backendBundle = path.join(runtimeResourcesDir, 'app.asar', 'build', 'backend.mjs')
+    const templateDir = app.isPackaged
+      ? path.join(runtimeResourcesDir, 'workspace-template')
+      : path.join(REPO_ROOT, 'backend', 'workspace')
+    currentWorkspaceDir = app.isPackaged
+      ? path.join(userData, 'workspace')
+      : templateDir
+    startupLog.write('preparing workspace')
+    if (app.isPackaged) syncWorkspaceTemplate(templateDir, currentWorkspaceDir)
+
+    currentFrontendDist = app.isPackaged
+      ? path.join(runtimeResourcesDir, 'frontend')
+      : path.join(REPO_ROOT, 'frontend', '.output', 'public')
+
+    if (!fs.existsSync(backendBundle)) throw new Error('安装资源缺失：build/backend.mjs')
+    if (!fs.existsSync(path.join(currentFrontendDist, 'index.html'))) throw new Error('安装资源缺失：frontend/index.html')
+    if (quitting) return
+    startBackend()
+    await waitHealthy(backendPort)
+    if (quitting || fatalReported || !mainWindow || mainWindow.isDestroyed()) return
+    backendReady = true
+    startupLog.write('backend healthy, loading application')
+    await mainWindow.loadURL(`http://127.0.0.1:${backendPort}`)
+    showMainWindow()
+    startupLog.write('application loaded')
+  } catch (err) {
+    failStartup(err)
+  }
+}
+
+// ---- IPC：存储位置 ----
+
+/** 可写探针 */
+async function assertWritable(dir: string): Promise<void> {
+  const probe = path.join(dir, `.huobao-probe-${Date.now()}`)
+  await fsp.writeFile(probe, 'probe')
+  await fsp.rm(probe)
+}
+
+ipcMain.handle('huobao:pick-directory', async () => {
+  if (!mainWindow) return { ok: false, error: '窗口未就绪' }
+  const res = await dialog.showOpenDialog(mainWindow, {
+    title: '选择数据存储目录',
+    properties: ['openDirectory', 'createDirectory'],
+  })
+  if (res.canceled || !res.filePaths[0]) return { ok: false, canceled: true }
+  const target = path.resolve(res.filePaths[0])
+
+  // 轻校验（完整校验在迁移引擎 start-migration 时重新执行）
+  const a = normCase(path.resolve(currentDataDir))
+  const b = normCase(target)
+  if (b === a) return { ok: false, error: '不能选择当前数据目录' }
+  if (b.startsWith(a + path.sep)) return { ok: false, error: '目标目录在当前数据目录内部' }
+  if (a.startsWith(b + path.sep)) return { ok: false, error: '目标目录是当前数据目录的上级目录' }
+  try {
+    await assertWritable(target)
+  } catch {
+    return { ok: false, error: '目标目录不可写' }
+  }
+
+  let freeBytes: number | null = null
+  try {
+    const st = await fsp.statfs(target)
+    freeBytes = st.bavail * st.bsize
+  } catch { /* statfs 不可用时跳过剩余空间展示 */ }
+  return { ok: true, path: target, freeBytes }
+})
+
+// 存储迁移 IPC（校验/搬移/重启序列见 migrate.ts）
+const migrationDeps = {
+  getWindow: () => mainWindow,
+  getDataDir: () => currentDataDir,
+  setDataDir: (d: string) => { currentDataDir = d },
+  getPort: () => backendPort,
+  isBackendAlive: () => backend !== null,
+  stopBackend,
+  startBackend,
+  waitHealthy,
+  markRestartingFalse: () => { backendRestarting = false },
+  writeConfig: writeStorageConfig,
+  configPath: storageConfigPath,
+  normCase,
+}
+registerMigrationIpc(migrationDeps)
+registerUpdater(() => mainWindow)
+
+app.on('before-quit', () => {
+  quitting = true
+  markQuitting()
+  backend?.kill()
+})
+
+app.on('window-all-closed', () => {
+  app.quit()
+})
diff --git a/huobao-source/desktop/src/migrate.ts b/huobao-source/desktop/src/migrate.ts
new file mode 100644
index 0000000..042f00b
--- /dev/null
+++ b/huobao-source/desktop/src/migrate.ts
@@ -0,0 +1,278 @@
+/**
+ * 存储迁移引擎（主进程）
+ *
+ * 序列：validate → stop backend → move → write config → restart backend → done
+ * 铁律：copy 校验通过前绝不删旧目录；配置搬完才写；任何失败回滚并以旧目录拉起后端。
+ *
+ * 进度经 IPC 'huobao:migrate-progress' 推送（80ms 节流，done/error 必发）。
+ */
+import { app, dialog, ipcMain } from 'electron'
+import type { BrowserWindow } from 'electron'
+import * as fs from 'fs'
+import * as fsp from 'fs/promises'
+import * as path from 'path'
+
+export interface MigrationDeps {
+  getWindow(): BrowserWindow | null
+  getDataDir(): string
+  setDataDir(dir: string): void
+  getPort(): number
+  isBackendAlive(): boolean
+  /** 停后端并等待退出（内部置 backendRestarting 抑制致命弹窗） */
+  stopBackend(): Promise<void>
+  startBackend(): void
+  waitHealthy(port: number, timeoutMs: number): Promise<void>
+  /** 后端生命周期告一段落（已 healthy 或已恢复）时复位标志 */
+  markRestartingFalse(): void
+  writeConfig(dataDir: string): void
+  configPath(): string
+  normCase(p: string): string
+}
+
+export interface MigrateProgress {
+  phase: 'validating' | 'stopping' | 'moving' | 'config' | 'restarting' | 'done' | 'error'
+  message?: string
+  copiedBytes?: number
+  totalBytes?: number
+}
+
+export interface MigrateOptions {
+  targetDir: string
+  migrateFiles: boolean
+}
+
+export function registerMigrationIpc(deps: MigrationDeps): void {
+  ipcMain.handle('huobao:start-migration', async (_event, opts: MigrateOptions) => {
+    await runMigration(deps, opts)
+    return { ok: true }
+  })
+}
+
+// ---- 进度推送（80ms 节流，done/error 必发） ----
+
+function makeReporter(getWindow: () => BrowserWindow | null) {
+  let lastSent = 0
+  return (progress: MigrateProgress, force = false) => {
+    const now = Date.now()
+    if (!force && progress.phase !== 'done' && progress.phase !== 'error' && now - lastSent < 80) return
+    lastSent = now
+    getWindow()?.webContents.send('huobao:migrate-progress', progress)
+  }
+}
+
+// ---- 校验 ----
+
+async function sameVolume(a: string, b: string): Promise<boolean> {
+  try {
+    const [sa, sb] = await Promise.all([fsp.statfs(a), fsp.statfs(b)])
+    return sa.dev === sb.dev
+  } catch {
+    return false // 判定不了按跨卷（走逐文件 copy，更稳妥）
+  }
+}
+
+async function validateTarget(deps: MigrationDeps, target: string, currentDir: string): Promise<number> {
+  const targetStat = await fsp.stat(target).catch(() => null)
+  if (!targetStat) {
+    await fsp.mkdir(target, { recursive: true })
+  } else if (!targetStat.isDirectory()) {
+    throw new Error('目标路径不是目录')
+  } else {
+    const children = await fsp.readdir(target)
+    if (children.length > 0) throw new Error('目标目录必须为空')
+  }
+
+  // 可写探针
+  const probe = path.join(target, `.huobao-probe-${Date.now()}`)
+  await fsp.writeFile(probe, 'probe')
+  await fsp.rm(probe)
+
+  // 路径关系（win32 大小写不敏感）
+  const a = deps.normCase(path.resolve(currentDir))
+  const b = deps.normCase(path.resolve(target))
+  if (b === a) throw new Error('不能选择当前数据目录')
+  if (b.startsWith(a + path.sep)) throw new Error('目标目录在当前数据目录内部')
+  if (a.startsWith(b + path.sep)) throw new Error('目标目录是当前数据目录的上级目录')
+  const userData = deps.normCase(path.resolve(path.dirname(currentDir))) // <userData>
+  if (b === userData || a.startsWith(b + path.sep)) throw new Error('不能选择应用数据目录及其上级目录')
+
+  // 待搬总量（跨卷空间校验 + 迁移进度共用）
+  let totalBytes = 0
+  const collect = async (dir: string): Promise<void> => {
+    const entries = await fsp.readdir(dir, { withFileTypes: true }).catch(() => [])
+    for (const e of entries) {
+      const full = path.join(dir, e.name)
+      if (e.isDirectory()) await collect(full)
+      else if (e.isFile()) {
+        const st = await fsp.stat(full).catch(() => null)
+        if (st) totalBytes += st.size
+      }
+    }
+  }
+  await collect(currentDir)
+
+  // 跨卷空间校验（同卷 rename 不占额外空间，跳过）
+  if (!(await sameVolume(currentDir, target))) {
+    const st = await fsp.statfs(target)
+    const free = st.bavail * st.bsize
+    if (free < totalBytes * 1.05) {
+      const needGb = ((totalBytes * 1.05) / 1024 ** 3).toFixed(1)
+      const freeGb = (free / 1024 ** 3).toFixed(1)
+      throw new Error(`目标磁盘空间不足：需要约 ${needGb} GB，剩余 ${freeGb} GB`)
+    }
+  }
+  return totalBytes
+}
+
+// ---- 搬移 ----
+
+async function collectFileList(dir: string, base = dir, out: FileEntry[] = []): Promise<FileEntry[]> {
+  const entries = await fsp.readdir(dir, { withFileTypes: true })
+  for (const e of entries) {
+    const full = path.join(dir, e.name)
+    if (e.isDirectory()) await collectFileList(full, base, out)
+    else if (e.isFile()) {
+      const st = await fsp.stat(full)
+      out.push({ rel: path.relative(base, full), size: st.size })
+    }
+  }
+  return out
+}
+
+interface FileEntry {
+  rel: string
+  size: number
+}
+
+/**
+ * 搬移数据目录内容。铁律：复核通过前绝不删旧目录。
+ * 同卷：逐顶层条目 rename（EXDEV 兜底转逐文件 copy）；跨卷：清单 copy + 字节复核 + 删旧。
+ */
+async function moveData(
+  oldDir: string,
+  newDir: string,
+  report: (p: MigrateProgress, force?: boolean) => void,
+): Promise<void> {
+  await fsp.mkdir(newDir, { recursive: true })
+  const topEntries = await fsp.readdir(oldDir, { withFileTypes: true })
+
+  if (await sameVolume(oldDir, newDir)) {
+    for (const e of topEntries) {
+      const src = path.join(oldDir, e.name)
+      const dst = path.join(newDir, e.name)
+      try {
+        fs.renameSync(src, dst)
+      } catch (err: unknown) {
+        if ((err as NodeJS.ErrnoException)?.code === 'EXDEV') {
+          await copyAcross([src], oldDir, newDir, report)
+        } else throw err
+      }
+    }
+    await fsp.rm(oldDir, { recursive: true, force: true })
+    return
+  }
+
+  // 跨卷：全量清单 → 逐文件 copy → 字节复核 → 删旧
+  const files = await collectFileList(oldDir)
+  const totalBytes = files.reduce((s, f) => s + f.size, 0)
+  let copied = 0
+  for (const f of files) {
+    const dst = path.join(newDir, f.rel)
+    await fsp.mkdir(path.dirname(dst), { recursive: true })
+    await fsp.copyFile(path.join(oldDir, f.rel), dst)
+    copied += f.size
+    report({ phase: 'moving', copiedBytes: copied, totalBytes })
+  }
+  // 字节复核
+  const copiedFiles = await collectFileList(newDir)
+  const copiedTotal = copiedFiles.reduce((s, f) => s + f.size, 0)
+  if (copiedFiles.length !== files.length || copiedTotal !== totalBytes) {
+    throw new Error(`迁移校验失败：文件数 ${copiedFiles.length}/${files.length}，字节 ${copiedTotal}/${totalBytes}`)
+  }
+  await fsp.rm(oldDir, { recursive: true, force: true })
+}
+
+/** rename 遇 EXDEV 时对个别顶层条目退化为跨卷 copy（少见路径，进度从简） */
+async function copyAcross(sources: string[], oldDir: string, newDir: string, report: (p: MigrateProgress, force?: boolean) => void): Promise<void> {
+  let total = 0
+  const files: string[] = []
+  for (const src of sources) {
+    const list = await collectFileList(src, oldDir)
+    files.push(...list.map(f => f.rel))
+    total += list.reduce((s, f) => s + f.size, 0)
+  }
+  let done = 0
+  for (const rel of files) {
+    const dst = path.join(newDir, rel)
+    await fsp.mkdir(path.dirname(dst), { recursive: true })
+    await fsp.copyFile(path.join(oldDir, rel), dst)
+    done += 1
+    report({ phase: 'moving', copiedBytes: done, totalBytes: total })
+  }
+}
+
+// ---- 主流程 ----
+
+export async function runMigration(deps: MigrationDeps, opts: MigrateOptions): Promise<void> {
+  const report = makeReporter(deps.getWindow)
+  const oldDir = path.resolve(deps.getDataDir())
+  const target = path.resolve(opts.targetDir)
+  const backendWasAlive = deps.isBackendAlive()
+
+  try {
+    report({ phase: 'validating' }, true)
+    const totalBytes = await validateTarget(deps, target, oldDir)
+
+    if (backendWasAlive) {
+      report({ phase: 'stopping' }, true)
+      await deps.stopBackend()
+    }
+
+    if (opts.migrateFiles) {
+      report({ phase: 'moving', copiedBytes: 0, totalBytes }, true)
+      await moveData(oldDir, target, report)
+    } else {
+      await fsp.mkdir(target, { recursive: true })
+    }
+
+    // 配置在文件搬完后才写；写失败回滚为旧值（或删除 = 回默认目录）
+    report({ phase: 'config' }, true)
+    const configExisted = fs.existsSync(deps.configPath())
+    const oldConfigRaw = configExisted ? fs.readFileSync(deps.configPath(), 'utf8') : null
+    try {
+      deps.writeConfig(target)
+    } catch (err) {
+      if (oldConfigRaw !== null) fs.writeFileSync(deps.configPath(), oldConfigRaw)
+      else fs.rmSync(deps.configPath(), { force: true })
+      throw err
+    }
+
+    report({ phase: 'restarting' }, true)
+    deps.setDataDir(target)
+    deps.startBackend()
+    await deps.waitHealthy(deps.getPort(), 20_000)
+    deps.markRestartingFalse()
+    report({ phase: 'done' }, true)
+  } catch (err) {
+    const message = (err as Error)?.message || String(err)
+    report({ phase: 'error', message }, true)
+
+    // 恢复：后端应处于运行态；恢复失败则明确退出应用，不留僵尸窗口
+    if (backendWasAlive && !deps.isBackendAlive()) {
+      deps.setDataDir(oldDir)
+      try {
+        deps.startBackend()
+        await deps.waitHealthy(deps.getPort(), 20_000)
+        deps.markRestartingFalse()
+      } catch (recoverErr) {
+        console.error('[migrate] 恢复后端失败:', recoverErr)
+        dialog.showErrorBox('火宝短剧', `存储迁移失败且恢复后台服务失败，应用即将关闭。\n原始错误：${message}`)
+        app.quit()
+        return
+      }
+    } else {
+      deps.markRestartingFalse()
+    }
+    throw err
+  }
+}
diff --git a/huobao-source/desktop/src/preload.ts b/huobao-source/desktop/src/preload.ts
new file mode 100644
index 0000000..87a3851
--- /dev/null
+++ b/huobao-source/desktop/src/preload.ts
@@ -0,0 +1,31 @@
+/**
+ * preload — 渲染进程安全桥
+ * 暴露 window.huobaoDesktop：目录选择、迁移触发、迁移进度订阅。
+ * contextIsolation 默认开启，仅经 contextBridge 暴露白名单方法。
+ */
+import { contextBridge, ipcRenderer } from 'electron'
+
+contextBridge.exposeInMainWorld('huobaoDesktop', {
+  /** 弹原生目录选择框；返回 { ok, path?, freeBytes?, error?, canceled? } */
+  pickDirectory: () => ipcRenderer.invoke('huobao:pick-directory'),
+  /** 触发存储迁移；返回 { ok } 或 reject（错误信息见进度事件/异常） */
+  startMigration: (opts: { targetDir: string, migrateFiles: boolean }) =>
+    ipcRenderer.invoke('huobao:start-migration', opts),
+  /** 订阅迁移进度；返回取消订阅函数 */
+  onMigrateProgress: (cb: (progress: { phase: string, copiedBytes?: number, totalBytes?: number, message?: string }) => void) => {
+    const listener = (_event: unknown, progress: Parameters<typeof cb>[0]) => cb(progress)
+    ipcRenderer.on('huobao:migrate-progress', listener)
+    return () => ipcRenderer.removeListener('huobao:migrate-progress', listener)
+  },
+  // ---- 应用内更新 ----
+  getUpdateState: () => ipcRenderer.invoke('huobao:update-state'),
+  checkUpdate: () => ipcRenderer.invoke('huobao:update-check'),
+  downloadUpdate: () => ipcRenderer.invoke('huobao:update-download'),
+  applyUpdate: () => ipcRenderer.invoke('huobao:update-apply'),
+  /** 订阅更新下载进度（0-100）；返回取消订阅函数 */
+  onUpdateProgress: (cb: (percent: number) => void) => {
+    const listener = (_event: unknown, percent: number) => cb(percent)
+    ipcRenderer.on('huobao:update-progress', listener)
+    return () => ipcRenderer.removeListener('huobao:update-progress', listener)
+  },
+})
diff --git a/huobao-source/desktop/src/runtime-resources.ts b/huobao-source/desktop/src/runtime-resources.ts
new file mode 100644
index 0000000..87d5d19
--- /dev/null
+++ b/huobao-source/desktop/src/runtime-resources.ts
@@ -0,0 +1,146 @@
+/**
+ * Windows 非 ASCII 安装路径兼容。
+ *
+ * 后端 bundle、ASAR 原生模块和 FFmpeg 必须统一使用转换后的 resources 路径，
+ * 否则只转换其中一个，createRequire / asarUnpack 仍可能回到原始中文目录。
+ * 优先使用 NTFS 短路径（零拷贝）；系统未启用短文件名时，把只读运行资源
+ * 暂存到 ASCII 目录。业务数据库和用户媒体仍留在原 userData，不参与拷贝。
+ */
+import { execFile } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { createHash } from 'node:crypto'
+
+const READY_FILE = 'runtime-ready.json'
+const RESOURCE_ITEMS = ['app.asar', 'app.asar.unpacked', 'frontend', 'workspace-template', 'bin']
+
+export function isAsciiPath(value: string): boolean {
+  return !/[^\x00-\x7f]/.test(value)
+}
+
+interface RuntimeOptions {
+  version: string
+  userDataDir: string
+  programDataDir?: string
+  log?: (message: string) => void
+}
+
+function sourceSignature(resourcesPath: string): string {
+  const stat = fs.statSync(path.join(resourcesPath, 'app.asar'))
+  return `${stat.size}:${Math.round(stat.mtimeMs)}`
+}
+
+function ready(directory: string, signature: string, version: string): boolean {
+  try {
+    const marker = JSON.parse(fs.readFileSync(path.join(directory, READY_FILE), 'utf8'))
+    return marker.signature === signature && marker.version === version
+      && RESOURCE_ITEMS.every(item => fs.existsSync(path.join(directory, item)))
+  } catch {
+    return false
+  }
+}
+
+function copyResources(resourcesPath: string, target: string): void {
+  for (const item of RESOURCE_ITEMS) {
+    const source = path.join(resourcesPath, item)
+    const destination = path.join(target, item)
+    if (!fs.existsSync(source)) throw new Error(`安装资源缺失：${item}`)
+    if (fs.statSync(source).isDirectory()) {
+      fs.cpSync(source, destination, { recursive: true })
+    } else {
+      fs.mkdirSync(path.dirname(destination), { recursive: true })
+      fs.copyFileSync(source, destination)
+    }
+  }
+}
+
+/** 短路径不可用时的零配置回退；导出以便独立验证资源暂存和缓存更新。 */
+export function stageRuntimeResources(resourcesPath: string, options: RuntimeOptions): string {
+  const signature = sourceSignature(resourcesPath)
+  const identity = createHash('sha256')
+    .update(`${resourcesPath}\0${options.userDataDir}`)
+    .digest('hex')
+    .slice(0, 16)
+  const candidates = [
+    path.join(options.userDataDir, 'runtime'),
+    ...(options.programDataDir ? [path.join(options.programDataDir, 'HuobaoDrama')] : []),
+  ].filter(isAsciiPath)
+  let lastError: unknown = null
+
+  for (const base of candidates) {
+    const directory = path.join(base, `resources-${identity}`)
+    const temporary = `${directory}.tmp-${process.pid}-${Date.now()}`
+    try {
+      if (ready(directory, signature, options.version)) return directory
+      fs.mkdirSync(base, { recursive: true })
+      const probe = path.join(base, `.huobao-write-${process.pid}`)
+      fs.writeFileSync(probe, 'probe')
+      fs.rmSync(probe, { force: true })
+
+      fs.rmSync(temporary, { recursive: true, force: true })
+      fs.mkdirSync(temporary, { recursive: true })
+      copyResources(resourcesPath, temporary)
+      fs.writeFileSync(path.join(temporary, READY_FILE), JSON.stringify({
+        version: options.version,
+        signature,
+      }))
+
+      // 同用户单实例锁正常会串行化这里；另一会话恰好先完成时直接复用。
+      if (ready(directory, signature, options.version)) return directory
+      fs.rmSync(directory, { recursive: true, force: true })
+      fs.renameSync(temporary, directory)
+      return directory
+    } catch (error) {
+      lastError = error
+      options.log?.(`ASCII runtime staging failed at ${base}: ${(error as Error).message}`)
+    } finally {
+      fs.rmSync(temporary, { recursive: true, force: true })
+    }
+  }
+
+  throw new Error(`中文安装路径兼容资源准备失败，请检查磁盘空间和目录权限：${(lastError as Error)?.message || '无可用 ASCII 目录'}`)
+}
+
+function windowsShortPath(directory: string): Promise<string | null> {
+  const escaped = directory.replace(/'/g, "''")
+  const script = [
+    "$ErrorActionPreference='Stop'",
+    '$fso=New-Object -ComObject Scripting.FileSystemObject',
+    `$short=$fso.GetFolder('${escaped}').ShortPath`,
+    'if([string]::IsNullOrWhiteSpace($short)){exit 2}',
+    '[Console]::Write($short)',
+  ].join(';')
+  const encoded = Buffer.from(script, 'utf16le').toString('base64')
+  const powershell = process.env.SystemRoot
+    ? path.join(process.env.SystemRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe')
+    : 'powershell.exe'
+
+  return new Promise(resolve => {
+    execFile(powershell, [
+      '-NoLogo', '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass',
+      '-EncodedCommand', encoded,
+    ], { timeout: 5000, windowsHide: true, encoding: 'utf8', maxBuffer: 64 * 1024 }, (error, stdout) => {
+      if (error) { resolve(null); return }
+      const short = String(stdout).trim()
+      resolve(isAsciiPath(short) && fs.existsSync(path.join(short, 'app.asar')) ? short : null)
+    })
+  })
+}
+
+export async function resolveRuntimeResources(
+  resourcesPath: string,
+  options: RuntimeOptions & { platform: string },
+): Promise<string> {
+  if (options.platform !== 'win32' || isAsciiPath(resourcesPath)) return resourcesPath
+
+  const short = await windowsShortPath(resourcesPath)
+  if (short) {
+    options.log?.(`non-ASCII install path: using Windows short resources path ${short}`)
+    return short
+  }
+
+  options.log?.('non-ASCII install path: short path unavailable, staging runtime resources')
+  const staged = stageRuntimeResources(resourcesPath, options)
+  options.log?.(`non-ASCII install path: using staged resources ${staged}`)
+  return staged
+}
diff --git a/huobao-source/desktop/src/startup.ts b/huobao-source/desktop/src/startup.ts
new file mode 100644
index 0000000..9541920
--- /dev/null
+++ b/huobao-source/desktop/src/startup.ts
@@ -0,0 +1,69 @@
+import * as http from 'node:http'
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+
+/** 每次探测都有独立的硬截止时间，包含连接成功但服务端一直不回包的情况。 */
+function probeHealth(port: number, timeoutMs: number): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const request = http.get({ hostname: '127.0.0.1', port, path: '/api/v1/health', agent: false }, response => {
+      response.resume()
+      if (response.statusCode === 200) finish()
+      else finish(new Error(`Health HTTP ${response.statusCode}`))
+    })
+    const timer = setTimeout(() => {
+      const error = new Error('Health request timed out')
+      request.destroy(error)
+      finish(error)
+    }, timeoutMs)
+    let finished = false
+    function finish(error?: Error) {
+      if (finished) return
+      finished = true
+      clearTimeout(timer)
+      if (error) reject(error)
+      else resolve()
+    }
+    request.on('error', finish)
+  })
+}
+
+export async function waitForBackend(port: number, timeoutMs = 60_000, shouldStop = () => false): Promise<void> {
+  const deadline = Date.now() + timeoutMs
+  let lastError = ''
+  while (Date.now() < deadline) {
+    if (shouldStop()) throw new Error('启动已取消')
+    try {
+      await probeHealth(port, Math.min(1000, Math.max(1, deadline - Date.now())))
+      return
+    } catch (error) { lastError = (error as Error).message }
+    const remaining = deadline - Date.now()
+    if (remaining > 0) await new Promise(resolve => setTimeout(resolve, Math.min(300, remaining)))
+  }
+  throw new Error(`后台服务在 ${Math.round(timeoutMs / 1000)} 秒内未就绪：${lastError}`)
+}
+
+export function redactStartupLog(value: unknown): string {
+  return String(value instanceof Error ? value.stack || value.message : value)
+    .replace(/https?:\/\/[^\s"'<>]+/gi, '[URL omitted]')
+    .replace(/(Bearer\s+)\S+/gi, '$1[redacted]')
+    .replace(/((?:api[_-]?key|signature|token|secret)\s*["']?\s*[:=]\s*["']?)[^\s,"'}&]+/gi, '$1[redacted]')
+    .replace(/\bsk-[\w-]+/g, '[redacted]')
+}
+
+/** 只记录启动和进程状态，不记录业务请求。保留上一份日志，写失败不影响应用。 */
+export function createStartupLog(directory: string) {
+  const file = path.join(directory, 'startup.log')
+  try {
+    fs.mkdirSync(directory, { recursive: true })
+    if (fs.existsSync(file) && fs.statSync(file).size > 2 * 1024 * 1024) {
+      fs.rmSync(`${file}.previous`, { force: true })
+      fs.renameSync(file, `${file}.previous`)
+    }
+  } catch { /* 主进程失败提示仍可提供错误信息 */ }
+  return {
+    file,
+    write(message: unknown) {
+      try { fs.appendFileSync(file, `${new Date().toISOString()} ${redactStartupLog(message).slice(0, 16_384)}\n`) } catch { /* best effort */ }
+    },
+  }
+}
diff --git a/huobao-source/desktop/src/updater.ts b/huobao-source/desktop/src/updater.ts
new file mode 100644
index 0000000..28d263f
--- /dev/null
+++ b/huobao-source/desktop/src/updater.ts
@@ -0,0 +1,288 @@
+/**
+ * 应用内更新器（无 Apple 签名方案，同 Tauri updater 思路）
+ *
+ * - 清单：HUOBAO_UPDATE_FEED；未设置时双源 —— 国内 COS 优先，GitHub Releases 兜底
+ *   （两个源返回同一份清单结构，仅下载 URL 域名不同，见 desktop/scripts/publish-release.mjs）
+ * - macOS：下载 zip（.app 归档）→ sha256 校验 → 解压 → 旧包改名 .old 备胎 → 新包就位
+ *   → `open` 拉起新应用 → 当前实例退出；下次启动清理 .old
+ * - Windows：下载 Setup.exe → sha256 校验 → detached 静默安装（/S）→ 当前实例退出
+ * - 未打包（dev）模式整体禁用
+ */
+import { app, ipcMain } from 'electron'
+import type { BrowserWindow } from 'electron'
+import * as fs from 'fs'
+import * as fsp from 'fs/promises'
+import * as path from 'path'
+import crypto from 'crypto'
+import { spawn, execFile } from 'child_process'
+
+// 双源：COS（国内直连）优先，GitHub（海外）兜底；HUOBAO_UPDATE_FEED 可整体覆盖
+const FEED_URLS = process.env.HUOBAO_UPDATE_FEED
+  ? [process.env.HUOBAO_UPDATE_FEED]
+  : [
+    'https://installer.firemux.site/huobao-drama/latest.json',
+    'https://github.com/chatfire-AI/huobao-drama/releases/latest/download/latest.json',
+  ]
+
+export interface UpdateState {
+  status: 'idle' | 'checking' | 'up-to-date' | 'available' | 'downloading' | 'downloaded' | 'error'
+  currentVersion: string
+  latestVersion?: string
+  notes?: string
+  error?: string
+  downloadProgress?: number
+  downloadedFile?: string
+}
+
+let state: UpdateState = { status: 'idle', currentVersion: '' }
+let mainWindow: () => BrowserWindow | null
+
+function sendProgress(percent: number) {
+  state.downloadProgress = percent
+  mainWindow()?.webContents.send('huobao:update-progress', percent)
+}
+
+function setState(patch: Partial<UpdateState>) {
+  state = { ...state, ...patch }
+}
+
+// ---- 工具 ----
+
+function compareVersions(a: string, b: string): number {
+  const pa = a.replace(/^v/, '').split('.').map(n => parseInt(n, 10) || 0)
+  const pb = b.replace(/^v/, '').split('.').map(n => parseInt(n, 10) || 0)
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) !== (pb[i] ?? 0)) return (pa[i] ?? 0) - (pb[i] ?? 0)
+  }
+  return 0
+}
+
+async function sha256(file: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha256')
+    fs.createReadStream(file)
+      .on('data', chunk => hash.update(chunk))
+      .on('end', () => resolve(hash.digest('hex')))
+      .on('error', reject)
+  })
+}
+
+/** 当前运行的是哪个架构键（与 latest.json 的 platforms 键一致） */
+function platformKey(): string {
+  return `${process.platform}-${process.arch}`
+}
+
+/** 已安装 app 的 .app 路径（仅 macOS、打包态有效） */
+function installedAppBundle(): string {
+  // process.execPath = .../HuobaoDrama.app/Contents/MacOS/HuobaoDrama
+  return path.resolve(path.dirname(process.execPath), '..', '..')
+}
+
+async function fetchFeed(): Promise<{ version: string, notes?: string, platforms: Record<string, { url: string, sha256: string, size?: number }> }> {
+  let lastError: unknown
+  for (const url of FEED_URLS) {
+    try {
+      const res = await fetch(url, { signal: AbortSignal.timeout(15_000) })
+      if (!res.ok) throw new Error(`HTTP ${res.status}`)
+      const feed = await res.json()
+      if (!feed?.version || !feed?.platforms) throw new Error('版本清单格式不正确')
+      return feed
+    } catch (err) {
+      lastError = err
+    }
+  }
+  throw new Error(`版本清单请求失败（已尝试 ${FEED_URLS.length} 个源）：${(lastError as Error)?.message ?? ''}`)
+}
+
+// ---- 检查 ----
+
+async function doCheck(): Promise<UpdateState> {
+  if (!app.isPackaged) {
+    setState({ status: 'error', error: '开发模式不支持更新' })
+    return state
+  }
+  setState({ status: 'checking', error: undefined })
+  try {
+    const feed = await fetchFeed()
+    const latestVersion = feed.version.replace(/^v/, '')
+    setState({
+      status: compareVersions(latestVersion, app.getVersion()) > 0 ? 'available' : 'up-to-date',
+      latestVersion,
+      notes: feed.notes,
+      error: undefined,
+    })
+  } catch (err) {
+    setState({ status: 'error', error: (err as Error).message })
+  }
+  return state
+}
+
+// ---- 下载 ----
+
+async function doDownload(): Promise<UpdateState> {
+  if (state.status !== 'available' && state.status !== 'downloaded') {
+    throw new Error('当前没有可下载的更新')
+  }
+  const feed = await fetchFeed()
+  const asset = feed.platforms[platformKey()]
+  if (!asset) throw new Error(`暂未提供 ${platformKey()} 平台的更新包`)
+
+  setState({ status: 'downloading', downloadProgress: 0 })
+  // 大文件下载不设整体超时（progress 由流驱动）；网络中断会触发 fetch 异常走 error
+  const res = await fetch(asset.url)
+  if (!res.ok || !res.body) throw new Error(`更新包下载失败（HTTP ${res.status}）`)
+
+  const total = asset.size || Number(res.headers.get('content-length')) || 0
+  const dir = path.join(app.getPath('temp'), 'huobao-update')
+  await fsp.mkdir(dir, { recursive: true })
+  const fileName = decodeURIComponent(asset.url.split('/').pop() || `update-${Date.now()}`)
+  const dest = path.join(dir, fileName)
+
+  let received = 0
+  let lastReport = 0
+  const out = fs.createWriteStream(dest)
+  const reader = res.body.getReader()
+  for (;;) {
+    const { done, value } = await reader.read()
+    if (done) break
+    received += value.byteLength
+    if (!out.write(Buffer.from(value))) {
+      await new Promise<void>(r => out.once('drain', r))
+    }
+    const now = Date.now()
+    if (total && now - lastReport > 200) {
+      lastReport = now
+      sendProgress(Math.min(99, Math.round((received / total) * 100)))
+    }
+  }
+  out.end()
+  await new Promise<void>((resolve, reject) => {
+    out.on('finish', resolve)
+    out.on('error', reject)
+  })
+
+  // 完整性校验
+  const actual = await sha256(dest)
+  if (asset.sha256 && actual !== asset.sha256) {
+    await fsp.rm(dest, { force: true })
+    throw new Error('更新包校验失败（sha256 不匹配），已取消安装')
+  }
+
+  setState({ status: 'downloaded', downloadProgress: 100, downloadedFile: dest })
+  sendProgress(100)
+  return state
+}
+
+// ---- 安装（成功后当前实例退出，不会返回） ----
+
+/** 把换包阶段的原始错误转成可行动的中文提示（EPERM 是最常见：macOS「App 管理」隐私权限） */
+function describeApplyError(err: unknown): string {
+  const e = err as NodeJS.ErrnoException
+  if (e?.code === 'EPERM' || e?.code === 'EACCES') {
+    return `系统权限不足（${e.code}）：请在 系统设置 → 隐私与安全性 → App 管理 中允许 HuobaoDrama 后重试；或下载最新 dmg 覆盖安装（数据不受影响）`
+  }
+  if (e?.code === 'EROFS') {
+    return '应用正运行在只读位置（可能直接在 dmg 挂载卷里），请先把 HuobaoDrama 拖入「应用程序」再更新'
+  }
+  return e?.message || String(err)
+}
+
+async function doApply(): Promise<void> {
+  if (state.status !== 'downloaded' || !state.downloadedFile) {
+    // 兜底：直接查询 temp 里的最新产物
+    throw new Error('请先下载更新')
+  }
+  const downloaded = state.downloadedFile
+
+  if (process.platform === 'darwin') {
+    const bundle = installedAppBundle()
+    const tmpExtract = path.join(app.getPath('temp'), `huobao-update-extract-${Date.now()}`)
+    try {
+      await new Promise<void>((resolve, reject) => {
+        execFile('unzip', ['-q', '-o', downloaded, '-d', tmpExtract], err => (err ? reject(err) : resolve()))
+      })
+      const newApp = path.join(tmpExtract, 'HuobaoDrama.app')
+      if (!fs.existsSync(newApp)) throw new Error('更新包内容异常（未找到 HuobaoDrama.app）')
+
+      const oldBundle = `${bundle}.old`
+      fs.rmSync(oldBundle, { recursive: true, force: true })
+      fs.renameSync(bundle, oldBundle)
+      try {
+        fs.renameSync(newApp, bundle)
+      } catch (err) {
+        // 就位失败：旧包回滚
+        fs.renameSync(oldBundle, bundle)
+        throw err
+      }
+      // detached 拉起新应用后当前实例退出；下次启动清理 .old 备胎
+      spawn('open', [bundle], { detached: true, stdio: 'ignore' }).unref()
+      app.quit()
+      return
+    } catch (err) {
+      throw new Error(describeApplyError(err))
+    } finally {
+      // 任何失败路径都不能留解压残留（旧实现 rename 失败时会泄漏整个 .app）
+      fs.rmSync(tmpExtract, { recursive: true, force: true })
+    }
+  }
+
+  if (process.platform === 'win32') {
+    // NSIS 静默安装：detached 拉起安装器后退出当前实例
+    spawn(downloaded, ['/S'], { detached: true, stdio: 'ignore' }).unref()
+    app.quit()
+    return
+  }
+
+  throw new Error(`不支持的平台: ${process.platform}`)
+}
+
+// ---- 注册 ----
+
+export function registerUpdater(getWindow: () => BrowserWindow | null): void {
+  mainWindow = getWindow
+  state.currentVersion = app.getVersion()
+
+  ipcMain.handle('huobao:update-state', () => state)
+  ipcMain.handle('huobao:update-check', () => doCheck())
+  ipcMain.handle('huobao:update-download', async () => {
+    try {
+      return await doDownload()
+    } catch (err) {
+      setState({ status: 'error', error: (err as Error).message })
+      throw err
+    }
+  })
+  ipcMain.handle('huobao:update-apply', async () => {
+    try {
+      await doApply()
+    } catch (err) {
+      // 写入状态让渲染层错误行显示具体原因（否则用户只看到笼统的「安装失败」toast）
+      setState({ status: 'error', error: (err as Error).message })
+      throw err
+    }
+  })
+
+  // 启动后静默检查一次（发现新版时渲染层经 update-state 轮询/toast 提示）
+  setTimeout(() => { if (!quittingApp()) void doCheck() }, 20_000).unref?.()
+
+  // 清理上次更新留下的旧包备胎。延后 3s：更新后首次启动时旧实例可能仍在退出，
+  // 立即删除可能与其收尾写入竞争；失败不阻断（下次启动会再试）
+  if (app.isPackaged && process.platform === 'darwin') {
+    setTimeout(() => {
+      const oldBundle = `${installedAppBundle()}.old`
+      try {
+        if (fs.existsSync(oldBundle)) fs.rmSync(oldBundle, { recursive: true, force: true })
+      } catch { /* 残留留给下次启动重试 */ }
+    }, 3000).unref?.()
+  }
+}
+
+function quittingApp(): boolean {
+  // updater 自身无 quitting 状态，避免循环依赖：main 设置 global 注入
+  return (globalThis as { __huobaoQuitting?: boolean }).__huobaoQuitting === true
+}
+
+/** main.ts 在 before-quit 时调用 */
+export function markQuitting(): void {
+  ;(globalThis as { __huobaoQuitting?: boolean }).__huobaoQuitting = true
+}
diff --git a/huobao-source/desktop/tests/main-startup.test.mjs b/huobao-source/desktop/tests/main-startup.test.mjs
new file mode 100644
index 0000000..b9e552c
--- /dev/null
+++ b/huobao-source/desktop/tests/main-startup.test.mjs
@@ -0,0 +1,95 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import vm from 'node:vm'
+import { EventEmitter } from 'node:events'
+import { createRequire } from 'node:module'
+const require = createRequire(import.meta.url)
+const code = fs.readFileSync(new URL('../dist/main.js', import.meta.url), 'utf8')
+
+async function boot(mode = 'pending', options = {}) {
+  const windows = [], errors = [], logs = [], timers = new Map()
+  let requests = 0, forks = 0, now = 0, timerId = 0, forkArgs = null
+  const app = new EventEmitter()
+  Object.assign(app, { isPackaged: true, getPath: () => '/mock/user', setPath() {}, getVersion: () => 'test', requestSingleInstanceLock: () => true, whenReady: () => Promise.resolve(), quit() { app.emit('before-quit') } })
+  class Window extends EventEmitter {
+    constructor(options) {
+      super(); this.visible = options.show !== false; this.options = options; this.destroyed = false
+      this.webContents = new EventEmitter(); this.webContents.setWindowOpenHandler = () => {}; windows.push(this)
+    }
+    show() { this.visible = true }
+    focus() { this.focused = true }
+    isMinimized() { return false }
+    isDestroyed() { return this.destroyed }
+    loadFile(file) { this.loadedFile = file; return Promise.resolve() }
+    loadURL(url) { this.loadedURL = url; return mode === 'page-failure' ? Promise.reject(new Error('ERR_CONNECTION_RESET')) : Promise.resolve() }
+  }
+  const child = new EventEmitter(); child.stdout = new EventEmitter(); child.stderr = new EventEmitter(); child.kill = () => {}
+  const electron = { app, BrowserWindow: Window, dialog: { showErrorBox: (...args) => errors.push(args) }, ipcMain: { handle() {} }, shell: {}, utilityProcess: { fork(...args) { forks++; forkArgs = args; return child } } }
+  const childProcess = { execFile(_file, _args, _options, callback) {
+    queueMicrotask(() => options.shortPath
+      ? callback(null, options.shortPath, '')
+      : callback(new Error('short path unavailable'), '', ''))
+  } }
+  const filesystem = { existsSync: p => !/storage-config|template-version|startup.log/.test(p), mkdirSync() {}, cpSync() {}, writeFileSync() {}, appendFileSync: (_p, s) => logs.push(s) }
+  const fakeProcess = new EventEmitter()
+  Object.assign(fakeProcess, { platform: 'win32', arch: 'x64', env: {}, versions: { electron: '37.10.3' }, pid: 123, resourcesPath: options.resourcesPath || '/mock/resources', stdout: new EventEmitter(), stderr: new EventEmitter() })
+  fakeProcess.stdout.write = fakeProcess.stderr.write = () => true
+  const net = { createServer() { const s = new EventEmitter(); s.listen = (_p, _h, fn) => fn(); s.address = () => ({port: 43210}); s.close = fn => fn(); return s } }
+  const http = { get(_opts, callback) {
+    requests++
+    const request = new EventEmitter(); request.destroy = err => request.emit('error', err)
+    if (mode !== 'pending') queueMicrotask(() => callback({ statusCode: 200, resume() {} }))
+    return request
+  } }
+  const context = vm.createContext({ require: name => name === 'electron' ? electron : name === 'node:child_process' ? childProcess : /^(node:)?fs$/.test(name) ? filesystem : /^(node:)?net$/.test(name) ? net : name === 'node:http' ? http : require(name),
+    process: fakeProcess, __dirname: '/mock/resources/app.asar/dist', module: {exports:{}}, exports: {}, console: {log(){},warn(){},error(){}}, Buffer, URL,
+    Date: class extends Date { static now() { return now } },
+    setTimeout: (fn, ms) => { const t = { id: ++timerId, at: now + ms, fn, unref() {} }; timers.set(t.id,t); return t },
+    clearTimeout: t => timers.delete(t?.id),
+  })
+  vm.runInContext(code, context)
+  async function flush() { for(let i=0;i<50;i++) await Promise.resolve() }
+  await flush()
+  return { windows, errors, logs, app, child, requests: () => requests, forks: () => forks, forkArgs: () => forkArgs, flush,
+    async expireHealth() { now=60_001; for(const t of [...timers.values()]) if(t.at <= now && t.at <= 1000) {timers.delete(t.id);t.fn()} await flush() } }
+}
+
+test('startup window is visible while health check hangs; deadline yields one actionable error', async () => {
+  const p=await boot(); assert.equal(p.forks(),1); assert.equal(p.requests(),1)
+  assert.equal(p.windows.length,1); assert.equal(p.windows[0].visible,true)
+  assert.match(p.windows[0].loadedFile,/starting.html$/)
+  await p.expireHealth()
+  assert.equal(p.errors.length,1); assert.match(p.errors[0][1],/startup.log/)
+})
+test('successful page load shows window without ready-to-show and a second launch unhides it', async () => {
+  const p=await boot('healthy'); assert.match(p.windows[0].loadedURL,/127.0.0.1:43210/)
+  assert.equal(p.windows[0].visible,true)
+  p.windows[0].visible=false; p.app.emit('second-instance')
+  assert.equal(p.windows[0].visible,true); assert.equal(p.windows[0].focused,true); assert.equal(p.errors.length,0)
+})
+test('backend early exit reports once and includes startup stderr and log location', async () => {
+  const p=await boot(); p.child.stderr.emit('data',Buffer.from('Cannot load native module'))
+  p.child.emit('exit',1); await p.expireHealth()
+  assert.equal(p.errors.length,1); assert.match(p.errors[0][1],/Cannot load native module/)
+  assert.ok(p.logs.some(s=>s.includes('backend exited')))
+})
+test('page load failure reports a visible error instead of leaving a hidden window', async () => {
+  const p=await boot('page-failure'); assert.equal(p.errors.length,1)
+  assert.match(p.errors[0][1],/ERR_CONNECTION_RESET/)
+})
+test('non-ASCII Windows install resources use one short path for backend and media tools', async () => {
+  const shortPath = 'C:\\HUOBAO~1\\resources'
+  const p = await boot('healthy', {
+    resourcesPath: 'C:\\用户\\HuobaoDrama\\resources',
+    shortPath,
+  })
+  assert.ok(p.forkArgs()[0].startsWith(shortPath))
+  assert.ok(p.forkArgs()[2].env.FFMPEG_BIN.startsWith(shortPath))
+  assert.ok(p.forkArgs()[2].env.FFPROBE_BIN.startsWith(shortPath))
+  assert.ok(p.forkArgs()[2].env.FRONTEND_DIST.startsWith(shortPath))
+  assert.equal(p.errors.length, 0)
+})
+test('closing while backend starts cancels silently', async () => {
+  const p=await boot(); p.app.quit(); await p.expireHealth(); assert.equal(p.errors.length,0)
+})
diff --git a/huobao-source/desktop/tests/runtime-resources.test.ts b/huobao-source/desktop/tests/runtime-resources.test.ts
new file mode 100644
index 0000000..d442198
--- /dev/null
+++ b/huobao-source/desktop/tests/runtime-resources.test.ts
@@ -0,0 +1,72 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { isAsciiPath, stageRuntimeResources } from '../src/runtime-resources.js'
+
+function makeResources(root: string): string {
+  const resources = path.join(root, '中文安装目录', 'resources')
+  fs.mkdirSync(path.join(resources, 'app.asar.unpacked', 'node_modules', 'native'), { recursive: true })
+  fs.mkdirSync(path.join(resources, 'frontend'), { recursive: true })
+  fs.mkdirSync(path.join(resources, 'workspace-template', 'prompts'), { recursive: true })
+  fs.mkdirSync(path.join(resources, 'bin'), { recursive: true })
+  fs.writeFileSync(path.join(resources, 'app.asar'), 'asar-v1')
+  fs.writeFileSync(path.join(resources, 'app.asar.unpacked', 'node_modules', 'native', 'module.node'), 'native')
+  fs.writeFileSync(path.join(resources, 'frontend', 'index.html'), 'frontend-v1')
+  fs.writeFileSync(path.join(resources, 'workspace-template', 'prompts', 'agent.md'), 'prompt')
+  fs.writeFileSync(path.join(resources, 'bin', 'ffmpeg.exe'), 'ffmpeg')
+  fs.writeFileSync(path.join(resources, 'bin', 'ffprobe.exe'), 'ffprobe')
+  return resources
+}
+
+test('ASCII detection only accepts paths safe for native runtime loading', () => {
+  assert.equal(isAsciiPath('C:\\Program Files\\HuobaoDrama'), true)
+  assert.equal(isAsciiPath('C:\\用户\\HuobaoDrama'), false)
+  assert.equal(isAsciiPath('D:\\应用\\HuobaoDrama'), false)
+})
+
+test('runtime staging copies every backend dependency, reuses cache and refreshes on package change', () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'huobao-runtime-'))
+  try {
+    const resources = makeResources(root)
+    const options = { version: '1.0.0', userDataDir: path.join(root, 'userData') }
+    const staged = stageRuntimeResources(resources, options)
+    assert.equal(isAsciiPath(staged), true)
+    for (const file of [
+      'app.asar',
+      'app.asar.unpacked/node_modules/native/module.node',
+      'frontend/index.html',
+      'workspace-template/prompts/agent.md',
+      'bin/ffmpeg.exe',
+      'bin/ffprobe.exe',
+    ]) assert.equal(fs.existsSync(path.join(staged, file)), true, file)
+
+    fs.writeFileSync(path.join(resources, 'frontend', 'index.html'), 'frontend-v2')
+    assert.equal(stageRuntimeResources(resources, options), staged)
+    assert.equal(fs.readFileSync(path.join(staged, 'frontend', 'index.html'), 'utf8'), 'frontend-v1')
+
+    fs.appendFileSync(path.join(resources, 'app.asar'), '-updated')
+    assert.equal(stageRuntimeResources(resources, options), staged)
+    assert.equal(fs.readFileSync(path.join(staged, 'frontend', 'index.html'), 'utf8'), 'frontend-v2')
+  } finally {
+    fs.rmSync(root, { recursive: true, force: true })
+  }
+})
+
+test('a Chinese user profile falls back to an ASCII ProgramData runtime cache', () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'huobao-runtime-fallback-'))
+  try {
+    const resources = makeResources(root)
+    const programData = path.join(root, 'ProgramData')
+    const staged = stageRuntimeResources(resources, {
+      version: '1.0.0',
+      userDataDir: path.join(root, '中文用户', 'HuobaoDrama'),
+      programDataDir: programData,
+    })
+    assert.equal(isAsciiPath(staged), true)
+    assert.ok(staged.startsWith(path.join(programData, 'HuobaoDrama')))
+  } finally {
+    fs.rmSync(root, { recursive: true, force: true })
+  }
+})
diff --git a/huobao-source/desktop/tests/startup.test.ts b/huobao-source/desktop/tests/startup.test.ts
new file mode 100644
index 0000000..dfcb109
--- /dev/null
+++ b/huobao-source/desktop/tests/startup.test.ts
@@ -0,0 +1,44 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import http from 'node:http'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { waitForBackend, createStartupLog } from '../src/startup.js'
+
+async function withServer(handler: http.RequestListener, fn: (port: number) => Promise<void>) {
+  const server = http.createServer(handler)
+  await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve))
+  try { await fn((server.address() as import('node:net').AddressInfo).port) }
+  finally { server.closeAllConnections(); await new Promise<void>(resolve => server.close(() => resolve())) }
+}
+test('a health server that accepts connections but never responds hits the overall deadline', async () => {
+  await withServer(() => {}, async port => {
+    const started = Date.now()
+    await assert.rejects(waitForBackend(port, 80), /未就绪/)
+    assert.ok(Date.now() - started < 1000, 'must not wait for fetch/OS default timeout')
+  })
+})
+test('health failures are retried and a subsequent successful response finishes startup', async () => {
+  let count = 0
+  await withServer((_request, response) => { response.writeHead(++count === 1 ? 503 : 200).end() }, async port => {
+    await waitForBackend(port, 1000)
+    assert.equal(count, 2)
+  })
+})
+test('quitting prevents more health requests', async () => {
+  await assert.rejects(waitForBackend(1, 1000, () => true), /取消/)
+})
+test('startup log preserves errors but removes signed URLs and credentials and rotates', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'huobao-startup-log-'))
+  try {
+    fs.writeFileSync(path.join(dir, 'startup.log'), 'x'.repeat(2 * 1024 * 1024 + 1))
+    const log = createStartupLog(dir)
+    log.write('failure https://example.com/file?signature=private-signature Bearer private-token api_key=private-key')
+    const text = fs.readFileSync(log.file, 'utf8')
+    assert.match(text, /failure/)
+    assert.doesNotMatch(text, /private-|https:/)
+    assert.ok(fs.existsSync(log.file + '.previous'))
+    assert.ok(text.length < 500)
+  } finally { fs.rmSync(dir, { recursive: true, force: true }) }
+})
diff --git a/huobao-source/desktop/tests/windows-package.test.mjs b/huobao-source/desktop/tests/windows-package.test.mjs
new file mode 100644
index 0000000..1bf718e
--- /dev/null
+++ b/huobao-source/desktop/tests/windows-package.test.mjs
@@ -0,0 +1,20 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { assertWindowsX64 } from '../scripts/validate-windows-package.mjs'
+
+test('Windows packaging rejects host Mach-O, truncated PE and x86 binaries', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'huobao-pe-test-'))
+  const file = path.join(dir, 'module.node')
+  try {
+    for (const bytes of [Buffer.from([0xcf,0xfa,0xed,0xfe]), Buffer.from('MZ'), Buffer.alloc(64)]) {
+      fs.writeFileSync(file,bytes);assert.throws(()=>assertWindowsX64(file),/Windows x64 PE/)
+    }
+    const bytes=Buffer.alloc(128);bytes.write('MZ');bytes.writeUInt32LE(64,60);bytes.write('PE\0\0',64);bytes.writeUInt16LE(0x14c,68)
+    fs.writeFileSync(file,bytes);assert.throws(()=>assertWindowsX64(file),/Windows x64 PE/)
+    bytes.writeUInt16LE(0x8664,68);fs.writeFileSync(file,bytes)
+    assert.deepEqual(assertWindowsX64(file),bytes)
+  } finally { fs.rmSync(dir,{recursive:true,force:true}) }
+})
diff --git a/huobao-source/docker-compose.yml b/huobao-source/docker-compose.yml
new file mode 100644
index 0000000..6f5768e
--- /dev/null
+++ b/huobao-source/docker-compose.yml
@@ -0,0 +1,47 @@
+# 火宝短剧 Docker 一体化部署：应用 + Watchtower（自动拉新镜像重建容器，支撑应用内一键更新）
+#
+# 使用：
+#   1. 复制 .env.example 为 .env 并修改 WATCHTOWER_TOKEN（两端必须一致）
+#   2. docker compose up -d
+#   3. 访问 http://localhost:5679 ，设置页「关于更新」可检查/一键更新
+#
+# 数据持久化在命名卷 huobao-data（SQLite + 生成的图片/视频 + 可在线编辑的 workspace/skills）。
+
+services:
+  app:
+    image: huobao/huobao-drama:latest
+    build:
+      context: .
+      args:
+        # 构建时注入版本号（发布镜像时务必指定，如 HUOBAO_VERSION=1.2.0）
+        HUOBAO_VERSION: ${HUOBAO_VERSION:-dev}
+    ports:
+      - "5679:5679"
+    environment:
+      # 配置后设置页「关于更新」出现「立即更新」按钮；删除这两行则退化为手动更新提示
+      HUOBAO_WATCHTOWER_URL: http://watchtower:8080
+      HUOBAO_WATCHTOWER_TOKEN: ${WATCHTOWER_TOKEN:-please-change-me}
+      # 发布清单（默认 GitHub Releases latest.json，与桌面版同一份）
+      # HUOBAO_UPDATE_FEED: https://github.com/chatfire-AI/huobao-drama/releases/latest/download/latest.json
+    volumes:
+      - huobao-data:/app/data
+    labels:
+      # Watchtower --label-enable：只更新显式标记的容器
+      com.centurylinklabs.watchtower.enable: "true"
+    restart: unless-stopped
+
+  watchtower:
+    image: containrrr/watchtower:latest
+    command: >
+      --http-api-update
+      --http-api-token ${WATCHTOWER_TOKEN:-please-change-me}
+      --label-enable
+      --cleanup
+      --rolling-restart
+      --interval 86400
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+    restart: unless-stopped
+
+volumes:
+  huobao-data:
diff --git a/huobao-source/docker/entrypoint.sh b/huobao-source/docker/entrypoint.sh
new file mode 100644
index 0000000..20a3ab3
--- /dev/null
+++ b/huobao-source/docker/entrypoint.sh
@@ -0,0 +1,12 @@
+#!/bin/sh
+# 容器入口：workspace 模板 copy-once 到数据卷（与桌面版 userData 同一语义），然后启动后端
+set -e
+
+if [ ! -e /app/data/workspace/.template-version ]; then
+  mkdir -p /app/data/workspace
+  cp -a /app/workspace-template/. /app/data/workspace/
+  touch /app/data/workspace/.template-version
+fi
+
+cd /app/backend
+exec node_modules/.bin/tsx src/index.ts
diff --git a/huobao-source/docs/images/api-key-cta.svg b/huobao-source/docs/images/api-key-cta.svg
new file mode 100644
index 0000000..7ab5477
--- /dev/null
+++ b/huobao-source/docs/images/api-key-cta.svg
@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="440" height="88" viewBox="0 0 440 88" role="img" aria-labelledby="title desc">
+  <title id="title">立即获取 FireMux API Key</title>
+  <desc id="desc">Get your API key</desc>
+  <rect x="1" y="1" width="438" height="86" rx="14" fill="#2563eb" stroke="#1d4ed8" stroke-width="2"/>
+  <rect x="18" y="22" width="44" height="44" rx="12" fill="#ffffff" fill-opacity="0.15"/>
+  <g fill="none" stroke="#ffffff" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+    <circle cx="35" cy="40" r="6"/>
+    <path d="M39.5 44.5 51 56m-5-5 4-4m-8 0 4-4"/>
+  </g>
+  <g font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif" fill="#ffffff">
+    <text x="78" y="40" font-size="21" font-weight="700">立即获取 FireMux API Key</text>
+    <text x="78" y="62" font-size="11" font-weight="600" letter-spacing="1.4" fill="#dbeafe">GET YOUR API KEY</text>
+  </g>
+  <circle cx="404" cy="44" r="17" fill="#ffffff" fill-opacity="0.15"/>
+  <path d="M397 44h14m-6-6 6 6-6 6" fill="none" stroke="#ffffff" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
diff --git a/huobao-source/docs/images/desktop-download-cta.svg b/huobao-source/docs/images/desktop-download-cta.svg
new file mode 100644
index 0000000..91ece73
--- /dev/null
+++ b/huobao-source/docs/images/desktop-download-cta.svg
@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="440" height="88" viewBox="0 0 440 88" role="img" aria-labelledby="title desc">
+  <title id="title">立即下载桌面版</title>
+  <desc id="desc">Download Desktop App for macOS / Windows</desc>
+  <rect x="1" y="1" width="438" height="86" rx="14" fill="#2563eb" stroke="#1d4ed8" stroke-width="2"/>
+  <rect x="18" y="22" width="44" height="44" rx="12" fill="#ffffff" fill-opacity="0.15"/>
+  <g fill="none" stroke="#ffffff" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M40 30v18m-6-6 6 6 6-6M28 49v8h24v-8"/>
+  </g>
+  <g font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif" fill="#ffffff">
+    <text x="78" y="40" font-size="21" font-weight="700">立即下载桌面版</text>
+    <text x="78" y="62" font-size="11" font-weight="600" fill="#dbeafe">DOWNLOAD DESKTOP APP · macOS / Windows</text>
+  </g>
+  <circle cx="404" cy="44" r="17" fill="#ffffff" fill-opacity="0.15"/>
+  <path d="M397 44h14m-6-6 6 6-6 6" fill="none" stroke="#ffffff" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
diff --git a/huobao-source/docs/images/website-cta.svg b/huobao-source/docs/images/website-cta.svg
new file mode 100644
index 0000000..ca6eeea
--- /dev/null
+++ b/huobao-source/docs/images/website-cta.svg
@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="360" height="80" viewBox="0 0 360 80" role="img" aria-labelledby="title desc">
+  <title id="title">访问 FireMux 官网</title>
+  <desc id="desc">Visit the official website</desc>
+  <rect x="1" y="1" width="358" height="78" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="2"/>
+  <g fill="none" stroke="#2563eb" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
+    <circle cx="38" cy="40" r="13"/>
+    <ellipse cx="38" cy="40" rx="6" ry="13"/>
+    <path d="M25 40h26M28 32h20M28 48h20"/>
+  </g>
+  <g font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif">
+    <text x="67" y="36" font-size="20" font-weight="700" fill="#1e3a8a">访问 FireMux 官网</text>
+    <text x="67" y="57" font-size="10" font-weight="600" letter-spacing="0.9" fill="#1d4ed8">VISIT THE OFFICIAL WEBSITE</text>
+  </g>
+  <path d="M320 40h14m-6-6 6 6-6 6" fill="none" stroke="#2563eb" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
diff --git a/huobao-source/docs/images/wx-group.png b/huobao-source/docs/images/wx-group.png
new file mode 100644
index 0000000..a4bec88
Binary files /dev/null and b/huobao-source/docs/images/wx-group.png differ
diff --git a/huobao-source/docs/screenshots/01-projects.png b/huobao-source/docs/screenshots/01-projects.png
new file mode 100644
index 0000000..2371b59
Binary files /dev/null and b/huobao-source/docs/screenshots/01-projects.png differ
diff --git a/huobao-source/docs/screenshots/02-create-drama.png b/huobao-source/docs/screenshots/02-create-drama.png
new file mode 100644
index 0000000..56e6dda
Binary files /dev/null and b/huobao-source/docs/screenshots/02-create-drama.png differ
diff --git a/huobao-source/docs/screenshots/03-settings-quick.png b/huobao-source/docs/screenshots/03-settings-quick.png
new file mode 100644
index 0000000..64db7c0
Binary files /dev/null and b/huobao-source/docs/screenshots/03-settings-quick.png differ
diff --git a/huobao-source/docs/screenshots/04-episodes.png b/huobao-source/docs/screenshots/04-episodes.png
new file mode 100644
index 0000000..0966700
Binary files /dev/null and b/huobao-source/docs/screenshots/04-episodes.png differ
diff --git a/huobao-source/docs/screenshots/05-script.png b/huobao-source/docs/screenshots/05-script.png
new file mode 100644
index 0000000..8ca9f84
Binary files /dev/null and b/huobao-source/docs/screenshots/05-script.png differ
diff --git a/huobao-source/docs/screenshots/06-assets.png b/huobao-source/docs/screenshots/06-assets.png
new file mode 100644
index 0000000..219fa78
Binary files /dev/null and b/huobao-source/docs/screenshots/06-assets.png differ
diff --git a/huobao-source/docs/screenshots/07-storyboard.png b/huobao-source/docs/screenshots/07-storyboard.png
new file mode 100644
index 0000000..bb08184
Binary files /dev/null and b/huobao-source/docs/screenshots/07-storyboard.png differ
diff --git a/huobao-source/docs/screenshots/08-videos.png b/huobao-source/docs/screenshots/08-videos.png
new file mode 100644
index 0000000..e00e404
Binary files /dev/null and b/huobao-source/docs/screenshots/08-videos.png differ
diff --git a/huobao-source/docs/screenshots/09-export.png b/huobao-source/docs/screenshots/09-export.png
new file mode 100644
index 0000000..30022de
Binary files /dev/null and b/huobao-source/docs/screenshots/09-export.png differ
diff --git a/huobao-source/docs/video-delivery-implementation.md b/huobao-source/docs/video-delivery-implementation.md
new file mode 100644
index 0000000..0a0f175
--- /dev/null
+++ b/huobao-source/docs/video-delivery-implementation.md
@@ -0,0 +1,100 @@
+# 视频交付与任务恢复实施方案
+
+采用 Firemux 按渠道异步转存，加短剧端下载恢复。先保存已生成的结果，再进行交付；恢复操作只查询已有任务、下载已有文件，不提交新的生成请求。MiniMax 响应保持 `task.status`、`task.content.url` 结构，保留实际时长。
+
+## 问题依据与处理链路
+
+提供的响应能确认上游任务已成功，但不能确认用户电脑已经下载成功。原实现先下载视频，再保存 result_url；下载异常会使整个本地任务失败，且丢失可供补下载的地址。原 MiniMax 同步响应解析也未保存嵌套 task.id 和实际 duration。这些代码问题足以解释“上游成功、本地失败”的现象；缺少用户电脑日志，无法认定具体网络故障是超时、DNS、签名过期还是其他原因。
+
+当前链路为 Vue/Nuxt 制作页面 → Hono/TypeScript 任务服务 → SQLite sys_task → 厂商适配器 → Firemux Spring Boot 网关 → 上游模型。视频成功后经本地文件存储和 FFmpeg 海报处理回写分镜。新增 Firemux 交付队列使用 MySQL 和已有 COS 配置，把上游媒体下载从用户电脑转移到服务端；短剧端仍需下载自有链接以供本地播放和导出。
+
+实施分为三层：保留直链模式作为兼容开关；对指定渠道启用服务端异步转存；客户端始终具备补下载、重查原任务和重启恢复。自有链接也可能下载失败，因此服务端转存与客户端恢复需要同时保留。
+
+## 实施范围
+
+| 部分 | 实现 | 交付位置 |
+| --- | --- | --- |
+| Firemux | MiniMax 后台转存、租约抢占、有限重试、签名链接、交付恢复接口 | 相邻 firemux 仓库的 gateway/delivery |
+| 短剧后端 | 保存任务来源和生成结果、原子下载、恢复接口、启动恢复、诊断接口 | backend/src/services/generation.ts、video-download.ts |
+| 短剧前端 | URL 在线预览及链接、本地视频自动切换、单条与批量恢复、显式重新生成确认、持续状态同步、复制诊断 | frontend/app/views/drama/episode.vue |
+
+Firemux 开关关闭时保持上游链接直连；启用后可限制到指定渠道。流式代理和客户端自动多地址竞速不在此次实现范围内。
+
+## 状态与数据
+
+短剧端继续使用 `processing/completed/failed` 状态，以兼容已有页面和查询接口。新增 `stage` 表示 `submitting/polling/transferring/downloading/saving/completed`，新增 `error_code` 表示交付失败、上游明确失败、提交结果未知或恢复失败。
+
+`sys_task` 增加 `config_id`、`config_base_url`，只记录配置来源，不复制密钥。旧 SQLite 启动时幂等增加字段。MiniMax 同步结果中的 `task.id`、响应头中的 Firemux 内部任务 ID、实际 duration 都会保留。视频 URL 在下载前保存，实际时长保存到 params.resultDuration。
+
+生成配置已删除、停用或地址变化时，不任意改用其他配置查询。历史任务没有配置 ID 时，仅允许使用同厂商唯一启用的视频配置；配置不明确时停止恢复并提示核对。
+
+Firemux 增加独立 `video_delivery_task` 表，保存来源地址、对象 key、状态、次数、下一次执行时间和租约。生成原始状态、原始响应及账单保持原状。对外查询视图反映交付状态：
+
+| 生成状态 | 交付状态 | MiniMax 查询状态 | 行为 |
+| --- | --- | --- | --- |
+| 已成功 | 等待或转存中 | running | 不返回上游链接，继续查询 |
+| 已成功 | 可下载 | succeeded | 返回新签名的自有存储链接 |
+| 已成功 | 转存失败 | failed，error.code=video_transfer_failed | delivery.generation_status=succeeded，允许恢复交付 |
+
+同步上游成功响应也可转为待交付响应，并额外提供顶层 task_id，兼容旧客户端。每次查询签发有效期最多一小时的链接；对象可用期限默认到生成完成后的第六天，不承诺永久保存。
+
+## 视频展示
+
+任务已有 result_url、尚未完成本地保存时，播放器使用返回 URL，并显示可直接打开的完整链接和“恢复下载”。在线播放加载失败时保留链接及恢复入口。下载完成后自动切换本地文件，并隐藏临时链接提示。HTTP(S) 地址不添加本地路径前缀，保留签名查询参数；临时链接不写为分镜主视频，拼接导出仍使用已保存的视频。历史视频预览同样正确识别远程地址。
+
+## 恢复接口
+
+- `POST /api/v1/tasks/:id/recover`：短剧端只恢复已有任务。已有地址先补下载，失败且有任务 ID 时重新查询；没有地址和任务 ID 的记录拒绝恢复。
+- `GET /api/v1/tasks/:id/diagnostics`：返回阶段、错误码、任务编号、厂商、模型和时间，移除密钥及签名链接。
+- `POST /minimax/v2/query/video_generation/{taskId}/recover`：Firemux 在验证原任务归属后重置失败的交付任务，不调用生成或计费服务。
+- 原 `POST /api/v1/tasks`：同分镜已有运行中任务时拒绝；存在失败任务时，必须显式传入 `force_new: true` 才允许新生成。页面会提示可能再次计费。
+
+同进程重复恢复由任务锁合并。完成状态与分镜回写在 SQLite 事务内提交；如果同一分镜已创建更晚的视频任务，恢复旧任务只保留历史视频，不覆盖分镜主视频。运行中任务不允许删除。
+
+## 下载与转存策略
+
+短剧端每次下载最长 120 秒，最多三次尝试，瞬时网络错误及 HTTP 408/429/5xx 退避重试。HTTP 4xx、格式错误、大小超限及本地文件错误不盲目重试。流式写入 `.part` 文件，校验 MP4/WebM 文件头后原子改名，最大 512 MiB；失败清理临时文件。没有扩展名的视频 URL 也会落为正确的 `.mp4` 或 `.webm`。
+
+Firemux 默认每实例最多两个交付任务并行，每个任务有数据库租约；默认扫描周期十秒，租约十五分钟，异常退出后由过期租约恢复。下载总时限 120 秒，独立 COS 客户端每次请求时限 120 秒，不由 SDK 隐式重试。整个一次执行预算低于租约期限。
+
+自动转存最多尝试五次，退避上限五分钟。对象 key 由内部任务 ID 确定；上传成功而数据库写回失败时，下次复用已存在对象。上传时设置 video/mp4 并校验远端对象大小。失败只保留安全错误码，不将带签名 URL 写入诊断日志。
+
+默认只允许 HTTPS 的 files.metaso.cn 下载源；重定向逐跳验证，DNS 解析拒绝私有、回环和链路本地地址，不向视频地址发送渠道鉴权信息。需要新增 CDN 域名时显式加入允许列表。
+
+## 验收场景
+
+1. 使用提供的 MiniMax 成功响应，正确解析任务 ID、地址与实际 12 秒时长。
+2. 上游成功、本地下载失败，任务仍保留地址与来源；恢复后生成请求次数不增加。
+3. 同时多次恢复，仅执行一次下载；文件下载中断不残留可见的半成品。
+4. 服务重启，有结果的任务恢复；没有上游编号的中断提交保留为待核对。
+5. 恢复旧任务不覆盖新视频；诊断信息不泄露签名链接和密钥。
+6. Firemux 转存等待期间隐藏源地址，完成后使用自有签名链接；失败不改变生成记录。
+7. 两个工作实例同时抢占只有一个成功；旧租约不能覆盖新租约结果；过期对象不再签发有效链接。
+8. 开关关闭或渠道不匹配时，原有返回内容不变。
+
+## 上线顺序
+
+1. Firemux 执行 `backend/src/main/resources/sql/20261013_video_delivery.sql`，先保持功能开关关闭并发布后端。
+2. 发布带任务恢复功能的短剧前后端；桌面版需重新构建后端和前端资源，源码变更不会更新用户已安装版本。
+3. 检查 COS 配置、存储桶权限与生命周期，确保 video-delivery/ 前缀至少保留七天。
+4. 在 Firemux 测试环境或小范围渠道开启转存，验证自有链接下载、Range 播放和真实文件大小。
+5. 观察转存成功率、排队时间、失败次数与磁盘使用，确认后逐步扩展渠道。
+
+Firemux 的环境变量、回滚和运维命令见相邻仓库 `deploy/video-delivery-rollout.md`。没有执行生产迁移、开启生产开关或真实视频生成。
+
+## 本次验证结果（2026-10-13）
+
+- 短剧任务恢复、下载和适配器测试共 13 项通过；后端 TypeScript 检查、前端静态构建通过。
+- Firemux 转存、存储、原有轮询回归及数据库集成测试共 18 项通过。数据库集成使用独立临时 MySQL 9.5，验证并发抢占、过期租约恢复和旧执行者不能覆盖新结果；部署目标 MySQL 8 仍需发布环境验证。
+- Playwright 使用独立 SQLite、模拟配置和本地生成的测试视频，验证诊断复制、重新生成计费提示、补下载完成后自动显示历史视频和播放器。恢复期间仅调用恢复接口，任务总数未增加。
+- 选取的原有结构检查有 3 项失败；在未改动 HEAD 上复现同样失败，涉及已删除的 mysql-schema.ts、旧前端模型路径匹配和旧 Firemux 域名断言，不是此次新增回归。
+- URL 展示补充验收：浏览器验证远程链接保留签名参数且可播放；点击恢复下载后无需刷新页面，播放器自动切换 /static/videos/task-1.mp4，并隐藏远程链接区域。仅发生恢复请求，没有新增生成请求。
+- 尚未执行真实 COS/CDN 上传和播放、生产数据库迁移或桌面安装包发布。这些属于上述灰度上线验收步骤。
+
+## 历史任务边界
+
+客户已有任务如果保存了任务编号或视频地址，可以尝试恢复。没有这些信息时，不能仅凭账单截图关联回本地分镜。已失效的上游签名链接如果查询接口不能刷新，也无法保证找回原视频；此时应先人工核对上游记录。
+
+## 回滚
+
+Firemux 设置 GATEWAY_VIDEO_DELIVERY_ENABLED=false 并重启即可恢复返回原始链接，保留交付表供后续恢复和诊断。新 SQLite 字段均为可空附加字段，回退应用代码时无需删列。不要删除已保存的任务 ID、result_url 或本地媒体文件。
diff --git a/huobao-source/donate.png b/huobao-source/donate.png
new file mode 100644
index 0000000..f9c64ec
Binary files /dev/null and b/huobao-source/donate.png differ
diff --git a/huobao-source/drama.png b/huobao-source/drama.png
new file mode 100644
index 0000000..ec898b4
Binary files /dev/null and b/huobao-source/drama.png differ
diff --git a/huobao-source/frontend/.gitignore b/huobao-source/frontend/.gitignore
new file mode 100644
index 0000000..6547dd4
--- /dev/null
+++ b/huobao-source/frontend/.gitignore
@@ -0,0 +1,4 @@
+node_modules/
+.nuxt/
+.output/
+dist/
diff --git a/huobao-source/frontend/app/app.vue b/huobao-source/frontend/app/app.vue
new file mode 100644
index 0000000..92ef763
--- /dev/null
+++ b/huobao-source/frontend/app/app.vue
@@ -0,0 +1,111 @@
+<template>
+  <NuxtLayout>
+    <NuxtPage />
+  </NuxtLayout>
+  <Toaster position="top-right" :duration="3000" :theme="resolvedTheme" />
+  <MigrateOverlay />
+</template>
+
+<script setup lang="ts">
+import { onMounted } from 'vue'
+import { Toaster, toast } from 'vue-sonner'
+import { useI18n } from 'vue-i18n'
+import MigrateOverlay from '~/components/MigrateOverlay.vue'
+import { useDesktopBridge } from '~/composables/useDesktopBridge'
+import { useMigrateState } from '~/composables/useMigrateState'
+import { useTheme } from '~/composables/useTheme'
+
+const { t } = useI18n()
+const { resolvedTheme } = useTheme()
+
+// 响应式文档标题（nuxt.config.ts 的静态 title 仅作 SSR/兜底）
+useHead(() => ({ title: t('app.title') }))
+
+const bridge = useDesktopBridge()
+const { state, begin, update, end } = useMigrateState()
+
+onMounted(() => {
+  if (!bridge) return
+  bridge.onMigrateProgress((p) => {
+    if (p.phase === 'done') {
+      update(p)
+      // 稍等遮罩展示「完成」，再刷新页面让所有数据源指向新目录
+      setTimeout(() => { end(); location.reload() }, 800)
+      return
+    }
+    if (p.phase === 'error') {
+      end()
+      return // 错误 toast 由触发方（设置页）提示
+    }
+    if (!state.active) begin()
+    update(p)
+  })
+
+  // 启动静默检查更新（主进程 20s 后自检一次，这里稍后取结果提示一次）
+  setTimeout(async () => {
+    try {
+      const s = await bridge.getUpdateState()
+      if (s?.status === 'available') {
+        toast.info(t('app.updateAvailable', { version: s.latestVersion }), { duration: 8000 })
+      }
+    } catch { /* 静默 */ }
+  }, 25_000)
+})
+</script>
+
+<style>
+@import url('./assets/studio.css');
+
+/* === 应用内引导（driver.js）主题覆写 — 跟随设计 token === */
+.huobao-tour-popover {
+  background: var(--surface-raised) !important;
+  color: var(--text-1) !important;
+  border: 1px solid var(--border) !important;
+  border-radius: var(--radius-lg) !important;
+  box-shadow: var(--shadow-elevated) !important;
+  max-width: 340px;
+}
+.huobao-tour-popover .driver-popover-title {
+  color: var(--text-0) !important;
+  font: 700 14px/1.3 var(--font-body) !important;
+  letter-spacing: -0.01em;
+}
+.huobao-tour-popover .driver-popover-description {
+  color: var(--text-2) !important;
+  font: 400 12.5px/1.65 var(--font-body) !important;
+}
+.huobao-tour-popover .driver-popover-progress-text {
+  color: var(--text-3) !important;
+  font-size: 10.5px !important;
+}
+.huobao-tour-popover .driver-popover-close-btn {
+  color: var(--text-3) !important;
+}
+.huobao-tour-popover .driver-popover-navigation-btns {
+  gap: 6px;
+}
+.huobao-tour-popover .driver-popover-navigation-btns button {
+  background: var(--button-bg) !important;
+  color: var(--button-text) !important;
+  border: none !important;
+  border-radius: var(--radius-pill) !important;
+  padding: 5px 14px !important;
+  font: 600 12px var(--font-body) !important;
+  text-shadow: none !important;
+  cursor: pointer;
+}
+.huobao-tour-popover .driver-popover-navigation-btns button.driver-popover-next-btn,
+.huobao-tour-popover .driver-popover-navigation-btns button.driver-popover-done-btn {
+  background: var(--accent-gradient) !important;
+  color: var(--on-accent) !important;
+}
+.driver-overlay {
+  background: var(--scrim) !important;
+  backdrop-filter: blur(2px);
+}
+/* 高亮框描边用品牌橙 */
+.driver-active-element .driver-popover-arrow svg path,
+.driver-active-element .driver-popover-arrow svg polygon {
+  fill: var(--accent) !important;
+}
+</style>
diff --git a/huobao-source/frontend/app/assets/brand-logo.png b/huobao-source/frontend/app/assets/brand-logo.png
new file mode 100644
index 0000000..b080b43
Binary files /dev/null and b/huobao-source/frontend/app/assets/brand-logo.png differ
diff --git a/huobao-source/frontend/app/assets/studio.css b/huobao-source/frontend/app/assets/studio.css
new file mode 100644
index 0000000..3b5fcc4
--- /dev/null
+++ b/huobao-source/frontend/app/assets/studio.css
@@ -0,0 +1,574 @@
+/* === HuoBao Studio — ChatFire 火焰橙 × 现代 SaaS (light / dark) === */
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+:root {
+  --surface-base: #f7f8fa;
+  --surface-raised: #ffffff;
+  --surface-muted: #f7f8fa;
+  --surface-soft: #fafbfc;
+  --surface-input: #ffffff;
+  --surface-outline: #e7e9ee;
+  --surface-outline-strong: #d6dae1;
+
+  --bg-base: var(--surface-base);
+  --bg-0: #fafbfc;
+  --bg-1: #ffffff;
+  --bg-2: #f1f3f6;
+  --bg-3: #e7e9ee;
+  --bg-hover: rgba(23,24,26,0.045);
+  --bg-active: rgba(23,24,26,0.07);
+  --bg-input: var(--surface-input);
+  --bg-surface: var(--surface-raised);
+
+  --border: #e7e9ee;
+  --border-strong: #d6dae1;
+  --border-focus: #f97316;
+
+  --text-0: #17181a;
+  --text-1: #3a3f47;
+  --text-2: #5c6370;
+  --text-3: #9aa1ad;
+
+  /* ChatFire 火焰橙（platform 品牌色） */
+  --accent: #f97316;
+  --accent-dark: #c2410c;
+  --accent-bg: rgba(249,115,22,0.10);
+  --accent-text: #ea580c;
+  --accent-glow: rgba(249,115,22,0.20);
+  --accent-gradient: linear-gradient(135deg, #f97316 0%, #fb923c 100%);
+
+  --action-primary: #f97316;
+  --action-primary-hover: #ea580c;
+  --action-primary-press: #c2410c;
+  --action-primary-text: #ffffff;
+  --action-secondary: #e8eaee;
+  --action-secondary-hover: #dcdfe5;
+  --action-danger: #dc2626;
+  --action-danger-bg: rgba(220,38,38,0.10);
+  --action-danger-solid-hover: #b91c1c;
+
+  --button-height: 36px;
+  --button-height-sm: 30px;
+  --button-height-icon: 36px;
+  --button-padding-x: 18px;
+  --button-radius: var(--radius-pill);
+  --button-bg: #e8eaee;
+  --button-bg-hover: #dcdfe5;
+  --button-bg-active: #d0d4db;
+  --button-border: transparent;
+  --button-border-hover: transparent;
+  --button-text: var(--text-0);
+  --button-text-hover: var(--text-0);
+  --button-focus: rgba(249,115,22,0.20);
+  --button-shadow: 0 1px 2px rgba(16,24,40,0.05);
+  --button-shadow-hover: 0 1px 2px rgba(16,24,40,0.05);
+
+  --panel-bg: var(--surface-raised);
+  --panel-border: var(--surface-outline);
+  --shadow-panel: 0 1px 2px rgba(16,24,40,0.05), 0 4px 14px rgba(16,24,40,0.08);
+
+  --success: #16a34a;
+  --success-bg: rgba(22,163,74,0.10);
+  --error: #dc2626;
+  --error-bg: rgba(220,38,38,0.10);
+  --info: #2563eb;
+  --info-bg: rgba(37,99,235,0.10);
+  --warning: #d97706;
+  --warning-bg: rgba(217,119,6,0.12);
+
+  --shadow-xs: 0 1px 2px rgba(16,24,40,0.05);
+  --shadow-sm: 0 1px 2px rgba(16,24,40,0.05), 0 4px 14px rgba(16,24,40,0.08);
+  --shadow: 0 1px 2px rgba(16,24,40,0.05), 0 4px 14px rgba(16,24,40,0.08);
+  --shadow-lg: 0 4px 14px rgba(16,24,40,0.08), 0 16px 40px rgba(16,24,40,0.14);
+  --shadow-xl: 0 8px 20px rgba(16,24,40,0.12), 0 24px 56px rgba(16,24,40,0.16);
+  --shadow-card: 0 1px 2px rgba(16,24,40,0.05), 0 4px 14px rgba(16,24,40,0.08);
+  --shadow-lift: 0 4px 14px rgba(16,24,40,0.08), 0 16px 40px rgba(16,24,40,0.14);
+  --shadow-elevated: 0 8px 20px rgba(16,24,40,0.12), 0 24px 56px rgba(16,24,40,0.16);
+  --shadow-inset: none;
+
+  --radius-sm: 8px;
+  --radius: 10px;
+  --radius-lg: 14px;
+  --radius-xl: 20px;
+  --radius-pill: 980px;
+
+  --font-display: -apple-system, BlinkMacSystemFont, 'SF Pro Text', 'Helvetica Neue', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+  --font-body: -apple-system, BlinkMacSystemFont, 'SF Pro Text', 'Helvetica Neue', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+  --font-mono: ui-monospace, 'SF Mono', 'SFMono-Regular', Menlo, 'Fira Code', Consolas, monospace;
+
+  --sp-1: 4px;
+  --sp-2: 8px;
+  --sp-3: 12px;
+  --sp-4: 16px;
+  --sp-5: 20px;
+  --sp-6: 24px;
+  --sp-8: 32px;
+  --sp-10: 40px;
+  --sp-12: 48px;
+  --sp-16: 64px;
+
+  --ease-out: cubic-bezier(0.16, 1, 0.3, 1);
+  --ease-spring: var(--ease-out);
+
+  /* semantic tokens (overridden per theme) */
+  --overlay-track: rgba(23,24,26,0.06);
+  --seg-active-bg: #ffffff;
+  --on-accent: #ffffff;
+  --on-media: rgba(255,255,255,0.85);
+  --scrim: rgba(15,23,42,0.45);
+  --header-bg: rgba(247,248,250,0.75);
+  --inverse-surface: #17181a;
+  --on-inverse: #ffffff;
+  /* 视频播放/预览区固定深底（两主题一致，深色块不覆写） */
+  --media-surface: #0b0d10;
+  --scrollbar-thumb: rgba(92,99,112,0.28);
+  --scrollbar-thumb-hover: rgba(92,99,112,0.42);
+  --border-hover: #c3c9d2;
+  --switch-bg: #e8eaee;
+  --action-danger-bg-hover: rgba(220,38,38,0.16);
+  --warn-text: #92400e;
+  --warn-bg: #fffbeb;
+  --warn-border: #fde68a;
+  --warn-link: #b45309;
+  --warn-link-hover-bg: #fef3c7;
+  --tag-success-text: #15803d;
+  --tag-info-text: #1d4ed8;
+  --tag-warning-text: #b45309;
+  --accent-purple: #6366f1;
+  --accent-purple-text: #4f46e5;
+  --accent-purple-bg: rgba(99,102,241,0.10);
+
+  /* z-index 分层：页面内部 1–40；模态 .overlay 100–120；菜单 1000；全屏阻塞 2000 */
+  --z-menu: 1000;
+  --z-blocking: 2000;
+}
+
+:root[data-theme="dark"] {
+  color-scheme: dark;
+
+  /* gateway 石板蓝灰暗色（区别于纯黑，带 slate 蓝调） */
+  --surface-base: #0b0f16;
+  --surface-raised: #131a24;
+  --surface-muted: #131a24;
+  --surface-soft: #0e141d;
+  --surface-input: #131a24;
+  --surface-outline: rgba(148,163,184,0.14);
+  --surface-outline-strong: rgba(148,163,184,0.28);
+
+  --bg-0: #0e141d;
+  --bg-1: #131a24;
+  --bg-2: #182230;
+  --bg-3: #1f2a38;
+  --bg-hover: rgba(148,163,184,0.08);
+  --bg-active: rgba(148,163,184,0.14);
+
+  --border: rgba(148,163,184,0.14);
+  --border-strong: rgba(148,163,184,0.28);
+  --border-focus: #ffb076;
+
+  --text-0: #f1f5f9;
+  --text-1: #dbe2ea;
+  --text-2: rgba(226,232,240,0.65);
+  --text-3: #8b94a3;
+
+  /* 蜜桃橙（dark 下品牌色提亮，platform 同款） */
+  --accent: #ffb076;
+  --accent-dark: #f5934e;
+  --accent-bg: rgba(255,176,118,0.14);
+  --accent-text: #ffb076;
+  --accent-glow: rgba(255,176,118,0.30);
+  --accent-gradient: linear-gradient(135deg, #ffb076 0%, #ff9a5c 100%);
+
+  --action-primary: #ffb076;
+  --action-primary-hover: #ffc194;
+  --action-primary-press: #f5934e;
+  --action-secondary: #1f2a38;
+  --action-secondary-hover: #28364a;
+  --action-danger: #f87171;
+  --action-danger-bg: rgba(248,113,113,0.14);
+  --action-danger-solid-hover: #fca5a5;
+
+  --button-bg: #1f2a38;
+  --button-bg-hover: #28364a;
+  --button-bg-active: #31435c;
+  --button-focus: rgba(255,176,118,0.30);
+  --button-shadow: 0 1px 2px rgba(0,0,0,0.3);
+  --button-shadow-hover: 0 1px 2px rgba(0,0,0,0.3);
+
+  --shadow-panel: 0 1px 2px rgba(0,0,0,0.3), 0 4px 14px rgba(0,0,0,0.35);
+
+  --success: #4ade80;
+  --success-bg: rgba(74,222,128,0.14);
+  --error: #f87171;
+  --error-bg: rgba(248,113,113,0.14);
+  --info: #60a5fa;
+  --info-bg: rgba(96,165,250,0.14);
+  --warning: #fbbf24;
+  --warning-bg: rgba(251,191,36,0.14);
+
+  --shadow-xs: 0 1px 2px rgba(0,0,0,0.3);
+  --shadow-sm: 0 1px 2px rgba(0,0,0,0.3), 0 4px 14px rgba(0,0,0,0.35);
+  --shadow: 0 1px 2px rgba(0,0,0,0.3), 0 4px 14px rgba(0,0,0,0.35);
+  --shadow-lg: 0 4px 14px rgba(0,0,0,0.35), 0 16px 40px rgba(0,0,0,0.5);
+  --shadow-xl: 0 8px 20px rgba(0,0,0,0.45), 0 24px 56px rgba(0,0,0,0.55);
+  --shadow-card: 0 1px 2px rgba(0,0,0,0.3), 0 4px 14px rgba(0,0,0,0.35);
+  --shadow-lift: 0 4px 14px rgba(0,0,0,0.35), 0 16px 40px rgba(0,0,0,0.5);
+  --shadow-elevated: 0 8px 20px rgba(0,0,0,0.45), 0 24px 56px rgba(0,0,0,0.55);
+
+  --overlay-track: rgba(148,163,184,0.10);
+  --seg-active-bg: #28364a;
+  --on-accent: #2a1503;
+  --scrim: rgba(0,0,0,0.60);
+  --header-bg: rgba(11,15,22,0.75);
+  --inverse-surface: #f1f5f9;
+  --on-inverse: #17181a;
+  --scrollbar-thumb: rgba(148,163,184,0.25);
+  --scrollbar-thumb-hover: rgba(148,163,184,0.40);
+  --border-hover: rgba(148,163,184,0.40);
+  --switch-bg: #1f2a38;
+  --action-danger-bg-hover: rgba(248,113,113,0.22);
+  --warn-text: #fbbf24;
+  --warn-bg: rgba(251,191,36,0.12);
+  --warn-border: rgba(251,191,36,0.28);
+  --warn-link: #fcd34d;
+  --warn-link-hover-bg: rgba(251,191,36,0.18);
+  --tag-success-text: #4ade80;
+  --tag-info-text: #60a5fa;
+  --tag-warning-text: #fbbf24;
+  --accent-purple: #818cf8;
+  --accent-purple-text: #a5b4fc;
+  --accent-purple-bg: rgba(129,140,248,0.16);
+}
+
+html, body, #__nuxt { height: 100%; }
+
+body {
+  font-family: var(--font-body);
+  font-size: 14px;
+  background: var(--surface-base);
+  color: var(--text-0);
+  line-height: 1.6;
+  letter-spacing: -0.01em;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  overflow: hidden;
+}
+
+h1, h2, h3, h4, h5 {
+  font-family: var(--font-display);
+  font-weight: 700;
+  line-height: 1.25;
+  color: var(--text-0);
+  letter-spacing: -0.02em;
+}
+h1 { font-size: 2rem; }
+h2 { font-size: 1.5rem; }
+h3 { font-size: 1.2rem; }
+p { line-height: 1.7; }
+
+.btn {
+  appearance: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  min-height: var(--button-height);
+  padding: 0 var(--button-padding-x);
+  border: none;
+  border-radius: var(--button-radius);
+  background: var(--button-bg);
+  color: var(--button-text);
+  box-shadow: var(--button-shadow);
+  font: 600 13px/1 var(--font-body);
+  letter-spacing: -0.01em;
+  text-decoration: none;
+  white-space: nowrap;
+  cursor: pointer;
+  user-select: none;
+  transition: background 0.18s var(--ease-out), color 0.18s var(--ease-out), box-shadow 0.18s var(--ease-out), transform 0.12s var(--ease-out);
+}
+.btn:hover { background: var(--button-bg-hover); color: var(--button-text-hover); box-shadow: var(--button-shadow-hover); }
+.btn:active { transform: scale(0.97); }
+.btn:focus-visible { outline: none; box-shadow: 0 0 0 3.5px var(--button-focus); }
+.btn:disabled { opacity: 0.45; cursor: not-allowed; }
+.btn-primary {
+  /* ChatFire 签名主 CTA：品牌渐变 + 悬停发光 + 轻微放大 */
+  background: var(--accent-gradient);
+  color: var(--on-accent);
+}
+.btn-primary:hover {
+  background: var(--accent-gradient);
+  color: var(--on-accent);
+  box-shadow: 0 2px 10px var(--accent-glow), 0 4px 18px var(--accent-glow);
+  transform: scale(1.03);
+}
+.btn-primary:active { transform: scale(1); filter: brightness(0.94); }
+.btn-danger { background: var(--action-danger-bg); color: var(--action-danger); }
+.btn-danger:hover { background: var(--action-danger-bg-hover); color: var(--action-danger); }
+.btn-ghost { background: transparent; color: var(--accent-text); box-shadow: none; }
+.btn-ghost:hover { background: var(--accent-bg); color: var(--accent-text); box-shadow: none; }
+.btn-sm { min-height: var(--button-height-sm); padding: 0 14px; font-size: 12px; gap: 5px; }
+.btn-icon { width: var(--button-height-icon); min-width: var(--button-height-icon); height: var(--button-height-icon); min-height: var(--button-height-icon); padding: 0; color: var(--text-1); }
+
+.input, .textarea, select.input {
+  width: 100%;
+  padding: 9px 14px;
+  border: 1px solid var(--border-strong);
+  border-radius: var(--radius);
+  outline: none;
+  background: var(--bg-input);
+  color: var(--text-0);
+  font: 13.5px var(--font-body);
+  letter-spacing: -0.01em;
+  transition: border-color 0.16s, box-shadow 0.16s, background 0.16s;
+}
+.input:hover, .textarea:hover { border-color: var(--border-hover); }
+.input:focus, .textarea:focus, select.input:focus {
+  border-color: var(--border-focus);
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+.input::placeholder, .textarea::placeholder { color: var(--text-3); }
+.textarea { resize: none; line-height: 1.7; }
+select.input { appearance: auto; cursor: pointer; padding-right: 14px; }
+
+.tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 3px 10px;
+  border-radius: var(--radius-pill);
+  background: var(--overlay-track);
+  color: var(--text-2);
+  font: 550 11px var(--font-body);
+}
+.tag-accent { background: var(--accent-bg); color: var(--accent-text); }
+.tag-success { background: var(--success-bg); color: var(--tag-success-text); }
+.tag-error { background: var(--error-bg); color: var(--error); }
+.tag-info { background: var(--info-bg); color: var(--tag-info-text); }
+.tag-warning { background: var(--warning-bg); color: var(--tag-warning-text); }
+
+.card {
+  border: 1px solid var(--border);
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+  box-shadow: var(--shadow-card);
+  transition: box-shadow 0.2s var(--ease-out), transform 0.2s var(--ease-out), border-color 0.2s var(--ease-out);
+}
+.card:hover { border-color: var(--border-strong); }
+.card-active { border-color: var(--accent); box-shadow: 0 0 0 3px var(--button-focus); }
+
+/* iOS toggle switch */
+.switch {
+  position: relative;
+  width: 44px;
+  height: 27px;
+  border-radius: 99px;
+  background: var(--switch-bg);
+  border: none;
+  cursor: pointer;
+  transition: background 0.22s var(--ease-out);
+  flex-shrink: 0;
+  padding: 0;
+}
+.switch::after {
+  content: '';
+  position: absolute;
+  top: 2px;
+  left: 2px;
+  width: 23px;
+  height: 23px;
+  border-radius: 50%;
+  background: #fff;
+  box-shadow: 0 2px 6px rgba(0,0,0,0.18), 0 0 1px rgba(0,0,0,0.1);
+  transition: transform 0.22s var(--ease-out);
+}
+.switch.on { background: var(--success); }
+.switch.on::after { transform: translateX(17px); }
+
+/* thin progress bar */
+.progress {
+  height: 5px;
+  border-radius: 99px;
+  background: var(--overlay-track);
+  overflow: hidden;
+}
+.progress > i {
+  display: block;
+  height: 100%;
+  background: var(--accent);
+  border-radius: 99px;
+  transition: width 0.4s var(--ease-out);
+}
+
+/* dialog skeleton (use inside .overlay) */
+.dialog {
+  display: flex;
+  flex-direction: column;
+  max-height: calc(100vh - 96px);
+  border-radius: var(--radius-xl);
+  background: var(--surface-raised);
+  box-shadow: var(--shadow-elevated);
+  animation: scaleIn 0.24s var(--ease-out);
+  overflow: hidden;
+}
+.dialog-head {
+  display: flex;
+  align-items: center;
+  gap: var(--sp-3);
+  padding: var(--sp-5) var(--sp-6) var(--sp-4);
+  border-bottom: 1px solid var(--border);
+}
+.dialog-title { font-size: 17px; font-weight: 700; }
+.dialog-body { padding: var(--sp-6); overflow-y: auto; }
+.dialog-foot {
+  display: flex;
+  justify-content: flex-end;
+  gap: var(--sp-3);
+  padding: var(--sp-4) var(--sp-6);
+  border-top: 1px solid var(--border);
+}
+
+/* segmented control (pill track + raised active segment) */
+.seg {
+  display: inline-flex;
+  gap: 2px;
+  padding: 3px;
+  border-radius: var(--radius-pill);
+  background: var(--overlay-track);
+}
+.seg-item {
+  appearance: none;
+  border: none;
+  cursor: pointer;
+  padding: 7px 16px;
+  border-radius: var(--radius-pill);
+  background: transparent;
+  color: var(--text-2);
+  font: 600 12.5px var(--font-body);
+  letter-spacing: -0.01em;
+  transition: all 0.18s var(--ease-out);
+}
+.seg-item:hover { color: var(--text-0); }
+.seg-item.on { background: var(--seg-active-bg); color: var(--text-0); box-shadow: 0 1px 4px rgba(0,0,0,0.12); }
+.seg-item:focus-visible { outline: none; box-shadow: 0 0 0 3.5px var(--button-focus); }
+
+::-webkit-scrollbar { width: 6px; height: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--scrollbar-thumb); border-radius: 99px; }
+::-webkit-scrollbar-thumb:hover { background: var(--scrollbar-thumb-hover); }
+
+@keyframes spin { to { transform: rotate(360deg); } }
+.animate-spin { animation: spin 0.9s linear infinite; }
+@keyframes fadeIn { from { opacity: 0; } to { opacity: 1; } }
+@keyframes fadeUp { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+@keyframes scaleIn { from { opacity: 0; transform: scale(0.96); } to { opacity: 1; transform: scale(1); } }
+@keyframes slideRight { from { opacity: 0; transform: translateX(-6px); } to { opacity: 1; transform: translateX(0); } }
+@keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.4; } }
+
+.mono { font-family: var(--font-mono); }
+/* gateway 页眉签名：eyebrow 小标签（大写 + 宽字距 + 品牌色） */
+.eyebrow {
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--accent-text);
+}
+.truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dim { color: var(--text-3); }
+.flex { display: flex; }
+.items-center { align-items: center; }
+.justify-between { justify-content: space-between; }
+.gap-1 { gap: 4px; }
+.gap-2 { gap: 8px; }
+.gap-3 { gap: 12px; }
+.gap-4 { gap: 16px; }
+.ml-auto { margin-left: auto; }
+.flex-1 { flex: 1; min-width: 0; }
+.sr-only { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0,0,0,0); }
+
+.overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 100;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--scrim);
+  backdrop-filter: blur(8px);
+  -webkit-backdrop-filter: blur(8px);
+  animation: fadeIn 0.18s var(--ease-out);
+}
+
+.page-enter { animation: fadeUp 0.24s var(--ease-out) both; }
+.stagger-1 { animation-delay: 0.04s; }
+.stagger-2 { animation-delay: 0.08s; }
+.stagger-3 { animation-delay: 0.12s; }
+.stagger-4 { animation-delay: 0.16s; }
+.stagger-5 { animation-delay: 0.2s; }
+
+/* === AppMenu — 全站统一下拉菜单面板（Teleport to body，必须全局样式） === */
+.app-menu-anchor { display: inline-flex; min-width: 0; }
+.app-menu-anchor.block { display: flex; width: 100%; }
+.app-menu {
+  z-index: var(--z-menu);
+  display: flex;
+  flex-direction: column;
+  padding: 5px;
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+  box-shadow: var(--shadow-lg);
+  overflow-y: auto;
+  outline: none;
+}
+.app-menu[data-placement="bottom"] { transform-origin: top center; }
+.app-menu[data-placement="top"] { transform-origin: bottom center; }
+.app-menu-enter-active { transition: opacity 0.16s var(--ease-out), transform 0.16s var(--ease-out); }
+.app-menu-leave-active { transition: opacity 0.12s var(--ease-out), transform 0.12s var(--ease-out); }
+.app-menu-enter-from, .app-menu-leave-to { opacity: 0; transform: translateY(-4px) scale(0.98); }
+.app-menu[data-placement="top"].app-menu-enter-from,
+.app-menu[data-placement="top"].app-menu-leave-to { transform: translateY(4px) scale(0.98); }
+
+.app-menu-item {
+  appearance: none;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  width: 100%;
+  padding: 7px 10px;
+  border: none;
+  border-radius: var(--radius-sm);
+  background: transparent;
+  color: var(--text-1);
+  font: 500 12.5px var(--font-body);
+  text-align: left;
+  cursor: pointer;
+  transition: background 0.12s var(--ease-out), color 0.12s var(--ease-out);
+}
+.app-menu-item:hover,
+.app-menu-item.highlighted { background: var(--bg-hover); color: var(--text-0); }
+.app-menu-item:focus-visible { outline: none; background: var(--bg-hover); color: var(--text-0); }
+.app-menu-item.selected { color: var(--text-0); font-weight: 600; }
+.app-menu-item.danger { color: var(--action-danger); }
+.app-menu-item.danger:hover,
+.app-menu-item.danger.highlighted { background: var(--action-danger-bg); color: var(--action-danger); }
+.app-menu-item:disabled { opacity: 0.45; cursor: not-allowed; }
+.app-menu-item-check { flex-shrink: 0; width: 12px; color: var(--accent); opacity: 0; }
+.app-menu-item.selected .app-menu-item-check { opacity: 1; }
+.app-menu-item-label {
+  flex: 1; min-width: 0;
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}
+.app-menu-item-trailing { flex-shrink: 0; margin-left: auto; display: inline-flex; align-items: center; gap: 4px; }
+.app-menu-group-label {
+  padding: 6px 10px 3px;
+  font-size: 10px;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--text-3);
+}
+.app-menu-sep { height: 1px; margin: 4px 6px; background: var(--border); }
diff --git a/huobao-source/frontend/app/components/AppMenu.vue b/huobao-source/frontend/app/components/AppMenu.vue
new file mode 100644
index 0000000..f7a133e
--- /dev/null
+++ b/huobao-source/frontend/app/components/AppMenu.vue
@@ -0,0 +1,59 @@
+<template>
+  <span ref="anchorEl" class="app-menu-anchor" :class="{ block }" @click="toggle">
+    <slot name="trigger" :open="isOpen" />
+  </span>
+  <Teleport to="body">
+    <Transition name="app-menu">
+      <div
+        v-if="isOpen"
+        ref="panelEl"
+        class="app-menu"
+        :style="panelStyle"
+        :data-placement="placement"
+        role="menu"
+      >
+        <slot />
+      </div>
+    </Transition>
+  </Teleport>
+</template>
+
+<script setup lang="ts">
+import { watch } from 'vue'
+import { usePopover } from '~/composables/usePopover'
+
+/**
+ * AppMenu — 全站统一的下拉菜单面板（Teleport + 统一定位/动效/层级）
+ * 触发器由调用方通过 trigger slot 自定义（保留各自形态），只统一菜单层。
+ * 菜单项请使用 AppMenuItem。
+ */
+const props = withDefaults(defineProps<{
+  open?: boolean
+  placement?: 'bottom-start' | 'bottom-end' | 'bottom'
+  matchWidth?: boolean
+  minWidth?: number
+  maxHeight?: number
+  block?: boolean
+}>(), {
+  open: undefined,
+  placement: 'bottom-start',
+  matchWidth: false,
+  minWidth: 160,
+  maxHeight: 320,
+  block: false,
+})
+const emit = defineEmits<{ 'update:open': [boolean] }>()
+
+const { isOpen, anchorEl, panelEl, panelStyle, placement: actualPlacement, toggle } = usePopover({
+  placement: props.placement,
+  matchWidth: props.matchWidth,
+  minWidth: props.minWidth,
+  maxHeight: props.maxHeight,
+})
+
+// 外部 v-model:open 与内部状态双向桥接
+watch(() => props.open, (v) => { if (v !== undefined && v !== isOpen.value) isOpen.value = v })
+watch(isOpen, (v) => emit('update:open', v))
+
+const placement = actualPlacement
+</script>
diff --git a/huobao-source/frontend/app/components/AppMenuItem.vue b/huobao-source/frontend/app/components/AppMenuItem.vue
new file mode 100644
index 0000000..68ca1da
--- /dev/null
+++ b/huobao-source/frontend/app/components/AppMenuItem.vue
@@ -0,0 +1,25 @@
+<template>
+  <button
+    type="button"
+    class="app-menu-item"
+    :class="{ selected, danger }"
+    :disabled="disabled"
+    role="menuitem"
+    :aria-selected="selected || undefined"
+  >
+    <Check :size="12" class="app-menu-item-check" />
+    <span class="app-menu-item-label"><slot /></span>
+    <span v-if="$slots.trailing" class="app-menu-item-trailing"><slot name="trailing" /></span>
+  </button>
+</template>
+
+<script setup lang="ts">
+import { Check } from 'lucide-vue-next'
+
+/** AppMenuItem — 统一菜单项：选中左侧勾（占位对齐）、危险项、trailing 徽章槽 */
+defineProps<{
+  selected?: boolean
+  danger?: boolean
+  disabled?: boolean
+}>()
+</script>
diff --git a/huobao-source/frontend/app/components/AssetReferenceImages.vue b/huobao-source/frontend/app/components/AssetReferenceImages.vue
new file mode 100644
index 0000000..105e61c
--- /dev/null
+++ b/huobao-source/frontend/app/components/AssetReferenceImages.vue
@@ -0,0 +1,98 @@
+<template>
+  <section class="asset-references" :data-reference-asset="`${kind}:${asset.id}`" :aria-label="t('assetReferences.title')" @click.stop @keydown.enter.stop @keydown.space.stop>
+    <div class="reference-heading">
+      <span class="reference-label"><Images :size="14" />{{ t('assetReferences.title') }} <small>{{ references.length }}/6</small></span>
+      <button type="button" class="btn btn-sm" :disabled="busy || references.length >= 6" @click="fileInput?.click()">
+        <Loader2 v-if="busy" :size="12" class="animate-spin" /><Plus v-else :size="12" />
+        {{ t(busy ? 'assetReferences.saving' : 'assetReferences.add') }}
+      </button>
+      <input ref="fileInput" type="file" class="reference-input" multiple accept=".jpg,.jpeg,.png,.webp,image/jpeg,image/png,image/webp" :disabled="busy" :aria-label="t('assetReferences.add')" @change="upload" />
+    </div>
+    <div v-if="references.length" class="reference-images">
+      <div v-for="(path, index) in references" :key="path" class="reference-image">
+        <button type="button" class="reference-preview" :aria-label="t('assetReferences.preview', { n: index + 1 })" @click="emit('preview', imageUrl(path), t('assetReferences.preview', { n: index + 1 }))">
+          <img :src="imageUrl(path).replace(/\.[^./]+$/, '_thumb.webp')" :alt="t('assetReferences.preview', { n: index + 1 })" loading="lazy" @error="fallback($event, path)" />
+          <span>{{ index + 1 }}</span>
+        </button>
+        <button type="button" class="reference-remove" :disabled="busy" :aria-label="t('assetReferences.remove', { n: index + 1 })" :title="t('assetReferences.remove', { n: index + 1 })" @click="remove(path)"><X :size="11" /></button>
+      </div>
+    </div>
+    <p class="reference-hint">{{ t(references.length ? 'assetReferences.used' : 'assetReferences.empty') }}</p>
+    <p v-if="!references.length" class="reference-formats">{{ t('assetReferences.formats') }}</p>
+  </section>
+</template>
+
+<script setup lang="ts">
+import { Images, Plus, X, Loader2 } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+import { toast } from 'vue-sonner'
+import { assetReferenceAPI, type AssetKind } from '~/composables/useApi'
+import { toastError } from '~/composables/useToast'
+
+const props = defineProps<{ kind: AssetKind; asset: { id: number; reference_images?: string | string[] | null; referenceImages?: string | string[] | null } }>()
+const emit = defineEmits<{ updated: [kind: AssetKind, id: number, references: string[]]; preview: [url: string, title: string] }>()
+const { t } = useI18n()
+const fileInput = ref<HTMLInputElement | null>(null)
+const busyIds = useState<string[]>('asset-reference-busy', () => [])
+const key = computed(() => `${props.kind}:${props.asset.id}`)
+const busy = computed(() => busyIds.value.includes(key.value))
+const references = computed<string[]>(() => {
+  const value = props.asset.reference_images ?? props.asset.referenceImages
+  try { const list = typeof value === 'string' ? JSON.parse(value) : value; return Array.isArray(list) ? list.filter(v => typeof v === 'string') : [] } catch { return [] }
+})
+function imageUrl(path: string) { return /^(https?:\/\/|\/)/i.test(path) ? path : `/${path}` }
+function fallback(event: Event, path: string) {
+  const img = event.target as HTMLImageElement
+  if (!img.dataset.original) { img.dataset.original = 'true'; img.src = imageUrl(path) }
+}
+async function upload(event: Event) {
+  const input = event.target as HTMLInputElement, files = Array.from(input.files || [])
+  input.value = ''
+  if (!files.length || busy.value) return
+  if (references.value.length + files.length > 6) { toast.error(t('assetReferences.limit')); return }
+  if (files.some(file => !/\.(jpe?g|png|webp)$/i.test(file.name) || !file.size || file.size > 20 * 1024 * 1024)) { toast.error(t('assetReferences.invalid')); return }
+  const { kind, asset: { id } } = props, lock = key.value
+  busyIds.value = [...busyIds.value, lock]
+  try {
+    for (const file of files) {
+      const result = await assetReferenceAPI.upload(kind, id, file)
+      emit('updated', kind, id, result.reference_images)
+    }
+    toast.success(t('assetReferences.saved'))
+  } catch (error) { toastError(error) }
+  finally { busyIds.value = busyIds.value.filter(value => value !== lock) }
+}
+async function remove(path: string) {
+  if (busy.value) return
+  const { kind, asset: { id } } = props, lock = key.value
+  busyIds.value = [...busyIds.value, lock]
+  try {
+    const result = await assetReferenceAPI.remove(kind, id, path)
+    emit('updated', kind, id, result.reference_images)
+    toast.success(t('assetReferences.removed'))
+  } catch (error) { toastError(error) }
+  finally { busyIds.value = busyIds.value.filter(value => value !== lock) }
+}
+</script>
+
+<style scoped>
+.asset-references { min-width: 0; border-top: 1px solid var(--border); padding-top: 12px; display: flex; flex-direction: column; gap: 8px; cursor: default; }
+.reference-heading, .reference-label { display: flex; align-items: center; gap: 5px; min-width: 0; }
+.reference-heading { justify-content: space-between; gap: 8px; }
+.reference-label { color: var(--text-1); font-size: 12px; font-weight: 600; }
+.reference-label svg, .reference-label small { color: var(--text-3); flex-shrink: 0; }
+.reference-label small { font-size: 10px; font-weight: 400; }
+.reference-heading .btn { flex-shrink: 0; }
+.reference-input { display: none; }
+.reference-images { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 8px; }
+.reference-image { position: relative; min-width: 0; }
+.reference-preview { position: relative; display: block; width: 100%; aspect-ratio: 1.2; border: 1px solid var(--border); border-radius: 9px; background: var(--bg); padding: 0; overflow: hidden; cursor: zoom-in; }
+.reference-preview img { width: 100%; height: 100%; object-fit: contain; }
+.reference-preview span { position: absolute; left: 4px; bottom: 4px; padding: 1px 5px; border-radius: 4px; background: rgba(0,0,0,.6); color: white; font-size: 10px; }
+.reference-remove { position: absolute; right: -3px; top: -3px; display: grid; place-items: center; width: 21px; height: 21px; padding: 0; border: 1px solid var(--border); border-radius: 50%; background: var(--bg-card, white); color: var(--text-2); cursor: pointer; }
+.reference-remove:hover { color: var(--action-danger); }
+.reference-remove:disabled { opacity: .5; cursor: default; }
+.reference-preview:focus-visible, .reference-remove:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+.reference-hint, .reference-formats { margin: 0; font-size: 11px; line-height: 1.6; color: var(--text-2); }
+.reference-formats { color: var(--text-3); }
+</style>
diff --git a/huobao-source/frontend/app/components/BaseSelect.vue b/huobao-source/frontend/app/components/BaseSelect.vue
new file mode 100644
index 0000000..83ff226
--- /dev/null
+++ b/huobao-source/frontend/app/components/BaseSelect.vue
@@ -0,0 +1,256 @@
+<template>
+  <div class="base-select">
+    <AppMenu v-model:open="isOpen" block match-width :min-width="132" :max-height="380">
+      <template #trigger>
+        <button type="button" class="base-select-trigger" :class="{ open: isOpen }">
+          <span :class="selectedLabel ? '' : 'placeholder'" class="base-select-label">{{ selectedLabel || effectivePlaceholder }}</span>
+          <ChevronDown :size="13" class="base-select-arrow" :class="{ open: isOpen }" />
+        </button>
+      </template>
+
+      <!-- Search（slot 内容随父作用域，scoped 样式可达 Teleport 面板内） -->
+      <div v-if="searchable" class="base-select-search">
+        <Search :size="12" />
+        <input
+          ref="searchInputEl"
+          v-model="searchQuery"
+          class="base-select-search-input"
+          :placeholder="t('components.baseSelect.search')"
+          @keydown="onSearchKeydown"
+        />
+      </div>
+
+      <!-- Options -->
+      <div class="base-select-options">
+        <template v-if="flatOptions.length">
+          <template v-for="(group, gi) in filteredGroups" :key="gi">
+            <div v-if="group.label" class="app-menu-group-label">{{ group.label }}</div>
+            <button
+              v-for="(opt, oi) in group.options"
+              :key="opt.value"
+              type="button"
+              class="app-menu-item"
+              :class="{ selected: opt.value === modelValue, highlighted: highlightedIdx === getGlobalIdx(gi, oi) }"
+              role="menuitem"
+              @click="pick(opt)"
+              @mousemove="highlightedIdx = getGlobalIdx(gi, oi)"
+            >{{ opt.label }}</button>
+          </template>
+        </template>
+        <div v-else class="base-select-empty">{{ t('components.baseSelect.noMatch') }}</div>
+      </div>
+    </AppMenu>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, watch, nextTick } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { ChevronDown, Search } from 'lucide-vue-next'
+
+const props = defineProps({
+  modelValue: { type: [String, Number], default: '' },
+  options: { type: Array, default: () => [] }, // [{ label, value, group? }, ...] or [{ label, group, options: [] }]
+  placeholder: { type: String, default: '' },  // 缺省回退 t('components.baseSelect.placeholder')
+  searchable: { type: Boolean, default: true },
+})
+const emit = defineEmits(['update:modelValue'])
+
+const { t } = useI18n()
+const effectivePlaceholder = computed(() => props.placeholder || t('components.baseSelect.placeholder'))
+
+const isOpen = ref(false)
+const searchQuery = ref('')
+const searchInputEl = ref()
+const highlightedIdx = ref(-1)
+
+// Normalize options: support both flat list and grouped format
+const normalizedGroups = computed(() => {
+  if (!props.options.length) return []
+  // Check if already grouped
+  if (props.options[0]?.options) {
+    return props.options.map(g => ({
+      label: g.label || '',
+      options: g.options.map(o => ({ label: o.label ?? o, value: o.value ?? o })),
+    }))
+  }
+  // Flat list with optional group property
+  const map = new Map()
+  for (const o of props.options) {
+    const label = o.group || ''
+    if (!map.has(label)) map.set(label, [])
+    map.get(label).push({ label: o.label ?? o, value: o.value ?? o })
+  }
+  return Array.from(map.entries()).map(([label, options]) => ({ label, options }))
+})
+
+// Filter by search query
+const filteredGroups = computed(() => {
+  if (!searchQuery.value) return normalizedGroups.value
+  const q = searchQuery.value.toLowerCase()
+  return normalizedGroups.value
+    .map(g => ({
+      label: g.label,
+      options: g.options.filter(o => o.label.toLowerCase().includes(q)),
+    }))
+    .filter(g => g.options.length > 0)
+})
+
+// Flatten for keyboard nav
+const flatOptions = computed(() => filteredGroups.value.flatMap(g => g.options))
+
+function getGlobalIdx(gi, oi) {
+  let idx = 0
+  for (let i = 0; i < gi; i++) idx += normalizedGroups.value[i].options.length
+  return idx + oi
+}
+
+const selectedLabel = computed(() => {
+  for (const g of normalizedGroups.value) {
+    const found = g.options.find(o => o.value === props.modelValue)
+    if (found) return found.label
+  }
+  return ''
+})
+
+function pick(opt) {
+  emit('update:modelValue', opt.value)
+  isOpen.value = false
+}
+
+// 打开时初始化键盘高亮并聚焦搜索框（定位/关闭由 AppMenu 负责）
+watch(isOpen, async (val) => {
+  if (val) {
+    highlightedIdx.value = flatOptions.value.findIndex(o => o.value === props.modelValue)
+    searchQuery.value = ''
+    await nextTick()
+    searchInputEl.value?.focus()
+  } else {
+    searchQuery.value = ''
+  }
+})
+
+function onSearchKeydown(e) {
+  if (e.key === 'ArrowDown') {
+    e.preventDefault()
+    highlightedIdx.value = Math.min(highlightedIdx.value + 1, flatOptions.value.length - 1)
+  } else if (e.key === 'ArrowUp') {
+    e.preventDefault()
+    highlightedIdx.value = Math.max(highlightedIdx.value - 1, 0)
+  } else if (e.key === 'Enter') {
+    e.preventDefault()
+    if (highlightedIdx.value >= 0 && flatOptions.value[highlightedIdx.value]) {
+      pick(flatOptions.value[highlightedIdx.value])
+    }
+  } else if (e.key === 'Escape') {
+    isOpen.value = false
+  }
+}
+</script>
+
+<style scoped>
+.base-select {
+  display: flex;
+  width: 100%;
+  min-width: 0;
+}
+
+.base-select-trigger {
+  appearance: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 6px;
+  min-height: var(--button-height);
+  padding: 0 30px 0 12px;
+  font-size: 12px;
+  font-weight: 600;
+  font-family: var(--font-body);
+  color: var(--button-text);
+  background: var(--button-bg);
+  border: 1px solid var(--button-border);
+  border-radius: var(--button-radius);
+  cursor: pointer;
+  transition: all 0.18s var(--ease-out);
+  white-space: nowrap;
+  min-width: 0;
+  width: 100%;
+  max-width: none;
+  flex-shrink: 0;
+  box-shadow: var(--button-shadow);
+}
+.base-select-trigger:hover {
+  border-color: var(--button-border-hover);
+  background: var(--button-bg-hover);
+  color: var(--button-text-hover);
+  box-shadow: var(--button-shadow-hover);
+}
+.base-select-trigger.open {
+  border-color: var(--action-primary);
+  box-shadow: 0 0 0 3px var(--button-focus), var(--button-shadow-hover);
+  background: var(--button-bg-hover);
+}
+.base-select-trigger:focus-visible {
+  outline: none;
+  border-color: var(--action-primary);
+  box-shadow: 0 0 0 3px var(--button-focus), var(--button-shadow-hover);
+}
+.base-select-trigger .placeholder {
+  color: var(--text-3);
+  font-weight: 300;
+}
+.base-select-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  flex: 1;
+  min-width: 0;
+  text-align: left;
+}
+
+.base-select-arrow {
+  margin-left: auto;
+  color: var(--text-2);
+  transition: transform 0.2s var(--ease-out);
+  flex-shrink: 0;
+}
+.base-select-arrow.open {
+  transform: rotate(180deg);
+}
+
+/* Search（Teleport 面板内的 slot 内容，随父作用域） */
+.base-select-search {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin: -5px -5px 0;   /* 抵消面板 padding，搜索框通栏 */
+  padding: 8px 12px;
+  border-bottom: 1px solid var(--border);
+  border-radius: var(--radius-lg) var(--radius-lg) 0 0;
+  color: var(--text-2);
+}
+.base-select-search-input {
+  flex: 1;
+  border: none;
+  outline: none;
+  background: transparent;
+  font-size: 13px;
+  font-family: var(--font-body);
+  color: var(--text-0);
+}
+.base-select-search-input::placeholder {
+  color: var(--text-3);
+}
+
+.base-select-options {
+  overflow-y: auto;
+  max-height: 260px;
+}
+
+.base-select-empty {
+  padding: 16px 12px;
+  font-size: 13px;
+  color: var(--text-3);
+  text-align: center;
+}
+</style>
diff --git a/huobao-source/frontend/app/components/CharacterVoice.vue b/huobao-source/frontend/app/components/CharacterVoice.vue
new file mode 100644
index 0000000..2260431
--- /dev/null
+++ b/huobao-source/frontend/app/components/CharacterVoice.vue
@@ -0,0 +1,118 @@
+<template>
+  <section class="character-voice" :aria-label="t('characterVoice.forCharacter', { name: character.name })" @click.stop @keydown.stop>
+    <div class="voice-heading">
+      <div class="voice-label"><AudioLines :size="14" /><span>{{ t('characterVoice.title') }}</span></div>
+      <button type="button" class="btn btn-sm" :disabled="busy" @click="fileInput?.click()">
+        <Loader2 v-if="busy" :size="12" class="animate-spin" />
+        <Upload v-else :size="12" />
+        {{ busy ? t('characterVoice.saving') : voiceUrl ? t('characterVoice.replace') : t('characterVoice.upload') }}
+      </button>
+      <input ref="fileInput" class="voice-file-input" type="file" accept=".mp3,.wav,.m4a,.aac,audio/mpeg,audio/wav,audio/mp4,audio/aac" :disabled="busy" :aria-label="t('characterVoice.upload')" @change="upload" />
+    </div>
+    <template v-if="voiceUrl">
+      <div class="voice-file-row">
+        <span class="voice-filename" :title="voiceName">{{ voiceName }}</span>
+        <button type="button" class="voice-remove" :disabled="busy" @click="remove">{{ t('characterVoice.remove') }}</button>
+      </div>
+      <audio :key="voiceUrl" :src="voiceUrl" controls preload="none" data-character-voice :aria-label="t('characterVoice.preview', { name: character.name })" @play="onPlay" @error="playbackError = true" />
+      <p v-if="playbackError" class="voice-error" role="alert">{{ t('characterVoice.playbackError') }}</p>
+    </template>
+    <p v-else class="voice-hint">{{ t('characterVoice.empty') }}</p>
+    <p class="voice-formats">{{ t('characterVoice.formats') }}</p>
+  </section>
+</template>
+
+<script setup lang="ts">
+import { AudioLines, Loader2, Upload } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+import { toast } from 'vue-sonner'
+import { characterAPI, type CharacterVoice } from '~/composables/useApi'
+import { toastError } from '~/composables/useToast'
+
+const props = defineProps<{
+  character: {
+    id: number
+    name?: string
+    voice_audio_url?: string | null
+    voice_audio_name?: string | null
+    voiceAudioUrl?: string | null
+    voiceAudioName?: string | null
+  }
+}>()
+const emit = defineEmits<{ updated: [id: number, voice: CharacterVoice] }>()
+const { t } = useI18n()
+const fileInput = ref<HTMLInputElement | null>(null)
+// 卡片与详情弹窗共用同一个角色的上传锁。
+const busyIds = useState<number[]>('character-voice-busy', () => [])
+const busy = computed(() => busyIds.value.includes(props.character.id))
+const playbackError = ref(false)
+const voiceUrl = computed(() => {
+  const value = props.character.voice_audio_url ?? props.character.voiceAudioUrl ?? ''
+  return value && !value.startsWith('/') && !/^https?:\/\//i.test(value) ? `/${value}` : value
+})
+const voiceName = computed(() => props.character.voice_audio_name || props.character.voiceAudioName || t('characterVoice.sample'))
+watch(voiceUrl, () => { playbackError.value = false })
+
+async function upload(event: Event) {
+  const input = event.target as HTMLInputElement
+  const file = input.files?.[0]
+  input.value = ''
+  if (!file || busy.value) return
+  if (!/\.(mp3|wav|m4a|aac)$/i.test(file.name)) { toast.error(t('characterVoice.invalidFormat')); return }
+  if (!file.size) { toast.error(t('characterVoice.emptyFile')); return }
+  if (file.size > 20 * 1024 * 1024) { toast.error(t('characterVoice.tooLarge')); return }
+  const id = props.character.id
+  busyIds.value = [...busyIds.value, id]
+  try {
+    const voice = await characterAPI.uploadVoice(id, file)
+    emit('updated', id, voice)
+    toast.success(t('characterVoice.saved'))
+  } catch (error) {
+    toastError(error)
+  } finally {
+    busyIds.value = busyIds.value.filter(value => value !== id)
+  }
+}
+
+async function remove() {
+  if (busy.value) return
+  const id = props.character.id
+  busyIds.value = [...busyIds.value, id]
+  try {
+    const voice = await characterAPI.removeVoice(id)
+    emit('updated', id, voice)
+    toast.success(t('characterVoice.removed'))
+  } catch (error) {
+    toastError(error)
+  } finally {
+    busyIds.value = busyIds.value.filter(value => value !== id)
+  }
+}
+
+function onPlay(event: Event) {
+  playbackError.value = false
+  document.querySelectorAll<HTMLAudioElement>('audio[data-character-voice]').forEach(audio => {
+    if (audio !== event.target) audio.pause()
+  })
+}
+</script>
+
+<style scoped>
+.character-voice { min-width: 0; display: flex; flex-direction: column; gap: 8px; border-top: 1px solid var(--border); padding-top: 12px; margin-top: 4px; cursor: default; }
+.voice-heading, .voice-label, .voice-file-row { display: flex; align-items: center; gap: 8px; min-width: 0; }
+.voice-heading, .voice-file-row { justify-content: space-between; }
+.voice-label { color: var(--text-1); font-size: 12px; font-weight: 600; }
+.voice-label svg { color: var(--text-3); flex-shrink: 0; }
+.voice-heading .btn { flex-shrink: 0; }
+.voice-file-input { display: none; }
+.voice-filename { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 12px; color: var(--text-2); }
+.voice-remove { flex-shrink: 0; background: none; border: none; padding: 4px; color: var(--text-3); font: inherit; font-size: 12px; cursor: pointer; transition: color 0.15s; }
+.voice-remove:hover { color: var(--action-danger); }
+.voice-remove:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 4px; }
+.voice-remove:disabled { opacity: 0.5; cursor: default; }
+.character-voice audio { display: block; width: 100%; min-width: 0; height: 36px; }
+.voice-hint, .voice-formats, .voice-error { margin: 0; font-size: 11px; line-height: 1.6; }
+.voice-hint { color: var(--text-2); }
+.voice-formats { color: var(--text-3); }
+.voice-error { color: var(--action-danger); }
+</style>
diff --git a/huobao-source/frontend/app/components/ConfirmDialog.vue b/huobao-source/frontend/app/components/ConfirmDialog.vue
new file mode 100644
index 0000000..a6be704
--- /dev/null
+++ b/huobao-source/frontend/app/components/ConfirmDialog.vue
@@ -0,0 +1,103 @@
+<template>
+  <Teleport to="body">
+    <div v-if="open" class="overlay" @click.self="emit('cancel')">
+      <div class="dialog confirm-dialog" role="alertdialog" aria-modal="true" :aria-label="effectiveTitle">
+        <div class="confirm-icon">
+          <Trash2 :size="20" :stroke-width="1.8" />
+        </div>
+        <h2 class="confirm-title">{{ effectiveTitle }}</h2>
+        <p class="confirm-message">{{ message }}</p>
+        <div class="confirm-actions">
+          <button type="button" class="btn" :disabled="loading" @click="emit('cancel')">{{ t('common.cancel') }}</button>
+          <button type="button" class="btn confirm-danger-btn" :disabled="loading" @click="emit('confirm')">
+            <Loader2 v-if="loading" :size="13" class="animate-spin" />
+            {{ loading ? effectiveLoadingText : effectiveConfirmText }}
+          </button>
+        </div>
+      </div>
+    </div>
+  </Teleport>
+</template>
+
+<script setup>
+import { Trash2, Loader2 } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+
+const { t } = useI18n()
+
+const props = defineProps({
+  open: { type: Boolean, default: false },
+  // 缺省回退组件内 t()，调用方仍可显式覆盖
+  title: { type: String, default: '' },
+  message: { type: String, default: '' },
+  confirmText: { type: String, default: '' },
+  loadingText: { type: String, default: '' },
+  loading: { type: Boolean, default: false },
+})
+
+const emit = defineEmits(['confirm', 'cancel'])
+
+const effectiveTitle = computed(() => props.title || t('components.confirmDialog.title'))
+const effectiveConfirmText = computed(() => props.confirmText || t('common.delete'))
+const effectiveLoadingText = computed(() => props.loadingText || t('common.deleteLoading'))
+
+function onKeydown(e) {
+  if (e.key === 'Escape') emit('cancel')
+  if (e.key === 'Enter') emit('confirm')
+}
+
+watch(() => props.open, (v) => {
+  if (v) window.addEventListener('keydown', onKeydown)
+  else window.removeEventListener('keydown', onKeydown)
+})
+
+onUnmounted(() => window.removeEventListener('keydown', onKeydown))
+</script>
+
+<style scoped>
+.confirm-dialog {
+  width: 400px;
+  max-width: calc(100vw - 48px);
+  padding: 28px 24px 20px;
+  align-items: center;
+  text-align: center;
+}
+.confirm-icon {
+  width: 52px;
+  height: 52px;
+  border-radius: 50%;
+  background: var(--action-danger-bg);
+  color: var(--action-danger);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  margin-bottom: 14px;
+}
+.confirm-title {
+  font-size: 16px;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+  color: var(--text-0);
+}
+.confirm-message {
+  margin-top: 8px;
+  font-size: 13px;
+  line-height: 1.65;
+  color: var(--text-2);
+  max-width: 320px;
+  word-break: break-word;
+}
+.confirm-actions {
+  display: flex;
+  gap: 10px;
+  width: 100%;
+  margin-top: 22px;
+}
+.confirm-actions .btn { flex: 1; }
+.confirm-danger-btn {
+  background: var(--action-danger);
+  color: var(--on-accent);
+}
+.confirm-danger-btn:hover { background: var(--action-danger-solid-hover); color: var(--on-accent); }
+.confirm-danger-btn:disabled { opacity: 0.6; }
+</style>
diff --git a/huobao-source/frontend/app/components/HdVideoStudio.vue b/huobao-source/frontend/app/components/HdVideoStudio.vue
new file mode 100644
index 0000000..97d4466
--- /dev/null
+++ b/huobao-source/frontend/app/components/HdVideoStudio.vue
@@ -0,0 +1,136 @@
+<template>
+  <section class="hd-studio">
+    <header class="hd-header">
+      <div><h2>高清制作 <span>MiniMax H3-VDN-H3</span></h2>
+        <p>依据原分镜与视频参考画面重新生成，动作细节可能变化。原版始终保留，选定版本后再拼接导出。</p></div>
+      <button class="btn" :disabled="loading" @click="load">刷新</button>
+    </header>
+    <p v-if="error" class="hd-error" role="alert">{{ error }}</p>
+    <p v-if="notice" class="hd-notice" role="status">{{ notice }}</p>
+    <p v-if="!configured && !loading" class="hd-error">请在 AI 服务中启用 MiniMax H3-VDN-H3 高清模型。</p>
+    <div v-if="!items.length && !loading" class="hd-empty">先完成分镜与视频制作，再到这里制作高清版。</div>
+    <div class="hd-workspace" v-else>
+      <nav class="hd-shots" aria-label="选择分镜">
+        <button v-for="item in items" :key="item.id" :class="{ active: selectedId === item.id }" @click="selectedId = item.id">
+          <strong>分镜 {{ item.order }} · {{ item.title || '未命名' }}</strong>
+          <span>{{ item.busy ? '制作中' : item.original ? `${item.versions.filter(v => v.status === 'completed').length} 个高清版本` : '等待原视频' }}</span>
+        </button>
+      </nav>
+      <div v-if="selected" class="hd-detail">
+        <div class="hd-controls">
+          <label>高清模型 <select v-model="configId" aria-label="高清模型" :disabled="submitting"><option v-for="c in configs" :key="c.id" :value="c.id">{{ c.name }}</option></select></label>
+          <label>当前镜头显卡 <select v-model="gpu" aria-label="高清生成显卡" :disabled="submitting"><option value="">跟随模型（{{ configGpuLabel }}）</option><option value="auto">自动分配</option><option value="gpu1">GPU1 · ComfyUI 8189</option><option value="gpu2">GPU2 · ComfyUI 8188</option><option value="gpu3">GPU3 · ComfyUI 8191</option></select></label>
+          <label>目标分辨率 <select v-model="resolution"><option value="2K">2K · 2560 × 1440</option><option value="4K">4K · 3840 × 2160</option></select></label>
+          <button class="btn btn-primary" :disabled="!configured || !selected.original || submitting" @click="generate">{{ submitting ? '正在处理，请稍候…' : selected.busy ? `取消并换卡重新生成 ${resolution}` : `生成 ${resolution} 高清版` }}</button>
+        </div>
+        <p class="hd-hint">以上选择仅用于当前镜头。{{ selected.activeTask ? routingLabel(selected.activeTask) : '尚未提交高清任务' }}</p>
+        <p class="hd-hint">支持横屏 16:9 与竖屏 9:16，竖屏自动交换宽高。4K 制作耗时较长。拼接采用所选视频中的最高分辨率；未重制的低清镜头只会缩放，不会增加真实细节。</p>
+        <div class="hd-compare">
+          <article><div class="hd-card-head"><h3>原版</h3><span v-if="selected.current === selected.original">当前用于导出</span></div>
+            <video v-if="selected.original" :key="selected.original" :src="media(selected.original)" controls preload="metadata" />
+            <div v-else class="hd-empty">该分镜还没有完成的视频</div>
+            <button v-if="selected.original" class="btn" :disabled="selected.busy || applying || selected.current === selected.original" @click="chooseOriginal">使用原版导出</button>
+          </article>
+          <article><div class="hd-card-head"><h3>{{ preview?.resolution || '高清版' }}</h3><span v-if="preview?.url && selected.current === preview.url">当前用于导出</span></div>
+            <video v-if="preview?.url" :key="preview.url" :src="media(preview.url)" :poster="poster(preview.url)" controls preload="metadata" />
+            <div v-else class="hd-empty">{{ selected.busy ? '高清任务已提交，完成后显示在这里' : '生成后可在这里与原版对比' }}</div>
+            <button v-if="preview?.url" class="btn btn-primary" :disabled="selected.busy || applying || selected.current === preview.url" @click="choose(preview.id)">使用此高清版导出</button>
+          </article>
+        </div>
+        <div class="hd-history"><h3>高清版本记录</h3>
+          <p v-if="!selected.versions.length" class="hd-hint">尚未生成高清版本</p>
+          <button v-for="version in [...selected.versions].reverse()" :key="version.id" :class="{ active: preview?.id === version.id }" @click="previewId = version.id">
+            <strong>{{ version.resolution }} · {{ routingLabel(version) }} · #{{ version.id }}</strong><span>{{ statusLabel(version.status) }} · {{ new Date(version.createdAt).toLocaleString('zh-CN') }}</span>
+            <small v-if="version.error">{{ version.error }}</small>
+          </button>
+        </div>
+      </div>
+    </div>
+  </section>
+</template>
+
+<script setup lang="ts">
+import { api } from '~/composables/useApi'
+interface Routing { gpu: string; port: number | null; legacy: boolean }
+interface Version { id: number; status: string; resolution: string; gpu?: string; routing?: Routing; url: string | null; error: string | null; createdAt: string }
+interface Shot { id: number; order: number; title: string; original: string | null; current: string | null; busy: boolean; busyTaskId?: number; activeTask?: { id: number; model: string; configId: number; gpu?: string; routing?: Routing }; versions: Version[] }
+const props = defineProps<{ episodeId: number }>()
+const emit = defineEmits<{ selected: [] }>()
+const items = ref<Shot[]>([])
+const configured = ref(false)
+const choices = ref<Record<number, { configId?: number; gpu?: string; resolution?: string }>>({})
+function chooseSettings(patch: { configId?: number; gpu?: string; resolution?: string }) {
+  if (selectedId.value) choices.value = { ...choices.value, [selectedId.value]: { ...choices.value[selectedId.value], ...patch } }
+}
+const gpu = computed({ get: () => selectedId.value ? choices.value[selectedId.value]?.gpu ?? selected.value?.activeTask?.gpu ?? '' : '', set: gpu => chooseSettings({ gpu }) })
+const configs = ref<{ id: number; name: string; gpu: string }[]>([])
+const configId = computed({ get: () => (selectedId.value ? choices.value[selectedId.value]?.configId : undefined) || configs.value.find(c => c.id === selected.value?.activeTask?.configId)?.id || configs.value[0]?.id, set: configId => chooseSettings({ configId, gpu: '' }) })
+const configGpuLabel = computed(() => { const g = configs.value.find(c => c.id === configId.value)?.gpu || 'auto'; return g === 'auto' ? '自动分配' : g.toUpperCase() })
+const selectedId = ref<number>()
+const previewId = ref<number>()
+const resolution = computed({ get: () => selectedId.value ? choices.value[selectedId.value]?.resolution || '2K' : '2K', set: resolution => chooseSettings({ resolution }) })
+const error = ref('')
+const notice = ref('')
+const loading = ref(false)
+const submitting = ref(false)
+const applying = ref(false)
+const selected = computed(() => items.value.find(s => s.id === selectedId.value))
+const preview = computed(() => selected.value?.versions.find(v => v.id === previewId.value) || [...(selected.value?.versions || [])].reverse().find(v => v.status === 'completed'))
+const media = (url: string) => url.startsWith('static/') ? `/${url}` : url
+const poster = (url: string) => media(url).replace(/\.[^./]+$/, '_poster.jpg')
+const statusLabel = (s: string) => ({ completed: '已完成', processing: '制作中', failed: '失败' }[s] || s)
+const routingLabel = (task: { routing?: Routing; model?: string }) => `${task.routing ? `${task.routing.gpu.toUpperCase()} · ${task.routing.legacy ? '旧节点' : `ComfyUI ${task.routing.port}`}` : '等待节点确认'} · ${task.model || 'MiniMax-H3-VDN-H3'}`
+async function load() {
+  if (!props.episodeId || loading.value) return
+  loading.value = true
+  try {
+    const data = await api.get<{ configured: boolean; configs: typeof configs.value; items: Shot[] }>(`/hd/episodes/${props.episodeId}`)
+    items.value = data.items.sort((a, b) => a.order - b.order)
+    configured.value = data.configured
+    configs.value = data.configs
+    if (!configs.value.some(c => c.id === configId.value)) configId.value = configs.value[0]?.id
+    if (!items.value.some(s => s.id === selectedId.value)) selectedId.value = items.value.find(s => s.original)?.id || items.value[0]?.id
+  } catch (e) { error.value = e instanceof Error ? e.message : '读取高清任务失败' }
+  finally { loading.value = false }
+}
+async function generate() {
+  if (!selected.value || submitting.value) return
+  submitting.value = true; error.value = ''; notice.value = ''
+  try {
+    await api.post(`/hd/storyboards/${selected.value.id}`, { resolution: resolution.value, config_id: configId.value,
+      gpu: gpu.value || undefined, replace_task_id: selected.value.busy ? selected.value.busyTaskId : undefined })
+    notice.value = '高清任务已提交。原视频保持不变，完成后可选择用于导出的版本。'
+    await load()
+  } catch (e) { error.value = e instanceof Error ? e.message : '提交失败' }
+  finally { submitting.value = false }
+}
+async function selectVersion(body: { original?: boolean; task_id?: number }) {
+  if (!selected.value) return
+  applying.value = true; error.value = ''
+  try { await api.post(`/hd/storyboards/${selected.value.id}/select`, body); await load(); emit('selected'); notice.value = '导出版本已切换，请在拼接导出页重新拼接成片。' }
+  catch (e) { error.value = e instanceof Error ? e.message : '切换失败' }
+  finally { applying.value = false }
+}
+const chooseOriginal = () => selectVersion({ original: true })
+const choose = (id: number) => selectVersion({ task_id: id })
+let timer: ReturnType<typeof setInterval> | undefined
+onMounted(() => { load(); timer = setInterval(load, 10000) })
+onUnmounted(() => clearInterval(timer))
+watch(() => props.episodeId, () => { items.value = []; selectedId.value = undefined; previewId.value = undefined; load() })
+</script>
+
+<style scoped>
+.hd-studio{padding:24px;overflow:auto;height:100%;color:var(--text-1)}
+.hd-header,.hd-controls,.hd-card-head{display:flex;align-items:center;justify-content:space-between;gap:16px}
+h2{font-size:20px;margin:0}h2 span{font-size:12px;color:var(--accent-text);margin-left:12px}h3{font-size:14px;margin:0}
+.hd-header p,.hd-hint{font-size:12px;line-height:1.7;color:var(--text-3)}
+.hd-workspace{display:grid;grid-template-columns:210px minmax(0,1fr);gap:24px;margin-top:24px}
+.hd-shots,.hd-history{display:flex;flex-direction:column;gap:8px}.hd-shots button,.hd-history button{background:var(--surface-1);color:var(--text-1);border:1px solid var(--border);border-radius:10px;padding:14px;text-align:left;cursor:pointer}
+.hd-shots button.active,.hd-history button.active{border-color:var(--accent);background:var(--sel-bg)}
+.hd-shots span,.hd-history span,.hd-history small{display:block;margin-top:6px;font-size:12px;color:var(--text-3)}
+.hd-controls{justify-content:flex-start;flex-wrap:wrap}.hd-controls label{font-size:12px}.hd-controls select{margin-left:8px;padding:8px;border:1px solid var(--border);border-radius:6px;background:var(--surface-1);color:var(--text-1)}
+.hd-compare{display:grid;grid-template-columns:1fr 1fr;gap:18px;margin:20px 0}.hd-compare article{padding:16px;border:1px solid var(--border);border-radius:12px;min-width:0}.hd-card-head{margin-bottom:14px}.hd-card-head span{font-size:11px;color:var(--accent-text)}
+video{width:100%;height:300px;object-fit:contain;background:#111;border-radius:8px;margin-bottom:14px}.hd-empty{padding:45px 15px;text-align:center;color:var(--text-3);font-size:13px;line-height:1.8}
+.hd-error{color:var(--warning);font-size:13px}.hd-notice{color:var(--success);font-size:13px}.hd-history h3{margin:8px 0}
+@media(max-width:1050px){.hd-workspace{grid-template-columns:1fr}.hd-shots{flex-direction:row;overflow:auto}.hd-shots button{min-width:160px}.hd-compare{grid-template-columns:1fr}}
+</style>
diff --git a/huobao-source/frontend/app/components/LanguageSwitchDialog.vue b/huobao-source/frontend/app/components/LanguageSwitchDialog.vue
new file mode 100644
index 0000000..f59afb2
--- /dev/null
+++ b/huobao-source/frontend/app/components/LanguageSwitchDialog.vue
@@ -0,0 +1,100 @@
+<template>
+  <Teleport to="body">
+    <div v-if="open" class="overlay" @click.self="emit('cancel')">
+      <div class="dialog lang-switch-dialog" role="alertdialog" aria-modal="true" :aria-label="title">
+        <div class="confirm-icon lang-switch-icon">
+          <Languages :size="20" :stroke-width="1.8" />
+        </div>
+        <h2 class="confirm-title">{{ title }}</h2>
+        <p class="confirm-message">{{ message }}</p>
+        <ul class="lang-switch-effects">
+          <li>{{ t('components.langSwitch.effectUi') }}</li>
+          <li>{{ t('components.langSwitch.effectAi') }}</li>
+          <li>{{ t('components.langSwitch.effectRefresh') }}</li>
+        </ul>
+        <div class="confirm-actions">
+          <button type="button" class="btn" @click="emit('cancel')">{{ t('common.cancel') }}</button>
+          <button type="button" class="btn btn-primary" @click="emit('confirm')">
+            {{ t('components.langSwitch.confirm') }}
+          </button>
+        </div>
+      </div>
+    </div>
+  </Teleport>
+</template>
+
+<script setup>
+import { Languages } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+
+const { t } = useI18n()
+
+defineProps({
+  open: { type: Boolean, default: false },
+  title: { type: String, required: true },
+  message: { type: String, required: true },
+})
+
+const emit = defineEmits(['confirm', 'cancel'])
+</script>
+
+<style scoped>
+/* 与 ConfirmDialog 同构的居中弹窗（其为 scoped 样式，这里自带全套） */
+.lang-switch-dialog {
+  width: 420px;
+  max-width: calc(100vw - 48px);
+  padding: 28px 24px 20px;
+  align-items: center;
+  text-align: center;
+}
+.confirm-icon {
+  width: 52px;
+  height: 52px;
+  border-radius: 50%;
+  background: var(--action-danger-bg);
+  color: var(--action-danger);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  margin-bottom: 14px;
+}
+.lang-switch-icon {
+  background: var(--accent-bg);
+  color: var(--accent-text);
+}
+.confirm-title {
+  font-size: 16px;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+  color: var(--text-0);
+}
+.confirm-message {
+  margin-top: 8px;
+  font-size: 13px;
+  line-height: 1.65;
+  color: var(--text-2);
+  max-width: 340px;
+  word-break: break-word;
+}
+.lang-switch-effects {
+  margin: 10px 0 2px;
+  padding-left: 18px;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font-size: 12.5px;
+  color: var(--text-2);
+  line-height: 1.5;
+  text-align: left;
+}
+.lang-switch-effects li::marker {
+  color: var(--accent);
+}
+.confirm-actions {
+  display: flex;
+  gap: 10px;
+  width: 100%;
+  margin-top: 22px;
+}
+.confirm-actions .btn { flex: 1; }
+</style>
diff --git a/huobao-source/frontend/app/components/LocaleSwitcher.vue b/huobao-source/frontend/app/components/LocaleSwitcher.vue
new file mode 100644
index 0000000..e290c03
--- /dev/null
+++ b/huobao-source/frontend/app/components/LocaleSwitcher.vue
@@ -0,0 +1,61 @@
+<template>
+  <AppMenu v-model:open="open" placement="bottom-end" :min-width="140">
+    <template #trigger>
+      <button
+        type="button"
+        class="locale-trigger"
+        :aria-label="t('components.localeSwitcher.label')"
+      >
+        <Languages :size="15" :stroke-width="1.8" />
+        <span class="locale-current">{{ currentLabel }}</span>
+      </button>
+    </template>
+
+    <AppMenuItem
+      v-for="l in UI_LOCALES"
+      :key="l.value"
+      :selected="l.value === locale"
+      @click="select(l.value)"
+    >{{ l.label }}</AppMenuItem>
+  </AppMenu>
+</template>
+
+<script setup>
+import { ref, computed } from 'vue'
+import { Languages } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+import { UI_LOCALES } from '~/composables/i18n'
+import { confirmUnifiedLanguage } from '~/composables/useUnifiedLanguage'
+
+const { t, locale } = useI18n()
+
+const open = ref(false)
+
+const currentLabel = computed(() => UI_LOCALES.find(l => l.value === locale.value)?.label || locale.value)
+
+function select(l) {
+  // UI 语言 = AI 内容语言：确认弹窗 → 统一切换 → 刷新界面
+  void confirmUnifiedLanguage(l)
+  open.value = false
+}
+</script>
+
+<style scoped>
+.locale-trigger {
+  display: flex; align-items: center; gap: 6px;
+  min-height: 32px;
+  padding: 0 12px;
+  border: none; border-radius: var(--radius-pill);
+  background: transparent;
+  font-size: 13px; font-weight: 600;
+  color: var(--text-2); cursor: pointer;
+  transition: all 0.18s var(--ease-out);
+  line-height: 1;
+}
+.locale-trigger:hover { color: var(--text-0); background: var(--bg-hover); }
+.locale-trigger:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+.locale-current { max-width: 88px; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+</style>
diff --git a/huobao-source/frontend/app/components/MentionTextarea.vue b/huobao-source/frontend/app/components/MentionTextarea.vue
new file mode 100644
index 0000000..3cb5cf0
--- /dev/null
+++ b/huobao-source/frontend/app/components/MentionTextarea.vue
@@ -0,0 +1,429 @@
+<template>
+  <div class="mention-textarea" ref="wrapEl">
+    <!-- 高亮镜像层：渲染与 textarea 完全相同的文本，@引用 着彩色；textarea 文字透明、仅显示光标 -->
+    <div ref="backdropEl" :class="[inputClass, 'mention-backdrop']" aria-hidden="true">
+      <div class="mention-backdrop-content" v-html="highlightedHtml"></div>
+    </div>
+    <textarea
+      ref="taEl"
+      :class="[inputClass, 'mention-input']"
+      :rows="rows"
+      :placeholder="placeholder"
+      :value="text"
+      @input="onInput"
+      @keydown="onKeydown"
+      @blur="onBlur"
+      @click="closeMention"
+      @scroll="onScroll"
+    />
+    <Teleport to="body">
+      <div v-if="mention.open" ref="dropdownEl" class="mention-dropdown" :style="mentionStyle">
+        <template v-if="groupedFiltered.length">
+          <template v-for="(group, gi) in groupedFiltered" :key="group.group">
+            <div class="mention-group-label">{{ group.group }}</div>
+            <button
+              v-for="(opt, oi) in group.options"
+              :key="group.group + '-' + opt.value"
+              type="button"
+              :class="['mention-option', { highlighted: flatIndex(gi, oi) === highlightIdx }]"
+              @mousedown.prevent="pick(opt)"
+              @mousemove="highlightIdx = flatIndex(gi, oi)"
+            >
+              <span :class="['mention-avatar', `mention-avatar-${opt.kind === 'scene' ? 'scene' : (opt.kind === 'prop' ? 'prop' : 'role')}`]">
+                <img v-if="opt.image" :src="opt.image" alt="" @error="$event.target.style.display = 'none'" />
+                <component v-else :is="groupIcon(opt.kind)" :size="12" :stroke-width="2" />
+              </span>
+              <span class="mention-name">{{ opt.trigger || '@' }}{{ opt.label }}</span>
+              <span class="mention-type">{{ opt.group }}</span>
+            </button>
+          </template>
+        </template>
+        <div v-else class="mention-empty">{{ t(mention.trigger === '#' ? 'characterVoice.noMatch' : 'components.mention.noMatch') }}</div>
+      </div>
+    </Teleport>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, watch, nextTick, onMounted, onBeforeUnmount } from 'vue'
+import { User, MapPin, Package, AudioLines } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+import { mentionToken, mentionEntries, activeMentionAt, highlightMentions, mentionDeletionRange } from '../utils/prompt-mentions.js'
+
+const { t } = useI18n()
+
+// 无图资产在下拉中显示分组图标兜底（场景=定位、道具=包裹、角色=人物）——按 kind code 判断，不依赖显示文案
+const groupIcon = (kind) => (kind === 'voice' ? AudioLines : kind === 'scene' ? MapPin : kind === 'prop' ? Package : User)
+
+const props = defineProps({
+  modelValue: { type: String, default: '' },
+  // [{ label, value, kind, group, image?, trigger? }] — 默认 @图片引用，#角色音色引用
+  options: { type: Array, default: () => [] },
+  rows: { type: [Number, String], default: 4 },
+  placeholder: { type: String, default: '' },
+  inputClass: { type: String, default: '' },
+})
+const emit = defineEmits(['update:modelValue', 'commit'])
+
+const wrapEl = ref(null)
+const taEl = ref(null)
+const backdropEl = ref(null)
+const text = ref(props.modelValue)
+const mention = ref({ open: false, start: 0, trigger: '@', query: '', top: 0, left: 0 })
+const highlightIdx = ref(0)
+const dropdownEl = ref(null)
+
+// 键盘上下移动高亮时，让高亮项自动滚动进下拉可视区（鼠标 mousemove 触发的跳转也保持可见）
+watch(highlightIdx, () => {
+  nextTick(() => {
+    dropdownEl.value
+      ?.querySelector('.mention-option.highlighted')
+      ?.scrollIntoView({ block: 'nearest' })
+  })
+})
+
+const DROPDOWN_WIDTH = 240
+const DROPDOWN_MAX_HEIGHT = 220
+
+// 下拉 Teleport 到 body 后用 fixed 定位，任何外层滚动/窗口变化都会使其错位 → 直接关闭
+function closeOnOuterScroll(e) {
+  if (mention.value.open && e?.target !== taEl.value && !dropdownEl.value?.contains(e?.target)) closeMention()
+}
+onMounted(() => {
+  window.addEventListener('scroll', closeOnOuterScroll, true)
+  window.addEventListener('resize', closeOnOuterScroll)
+})
+onBeforeUnmount(() => {
+  window.removeEventListener('scroll', closeOnOuterScroll, true)
+  window.removeEventListener('resize', closeOnOuterScroll)
+})
+
+watch(() => props.modelValue, (v) => {
+  if (v !== text.value) { text.value = v; mention.value.open = false }
+})
+
+// 可引用名（按长度降序，保证最长匹配优先）及其分组样式（kind code 判断）
+const mentionNames = computed(() => mentionEntries(props.options))
+const highlightedHtml = computed(() => highlightMentions(text.value, props.options))
+
+// 光标前最近一个 @token（@ 后不含空白），命中则处于引用输入态
+function activeMention() {
+  const ta = taEl.value
+  if (!ta) return null
+  return activeMentionAt(ta.value, ta.selectionStart, props.options)
+}
+
+// 光标紧邻一个完整 @引用（用于整体删除）
+function mentionBeforeCaret() {
+  const ta = taEl.value
+  return mentionDeletionRange(ta.value, ta.selectionStart, props.options, true)
+}
+function mentionAfterCaret() {
+  const ta = taEl.value
+  return mentionDeletionRange(ta.value, ta.selectionStart, props.options, false)
+}
+
+const filteredOptions = computed(() => {
+  const q = mention.value.query.trim().toLowerCase()
+  const options = props.options.filter(o => (o.trigger || '@') === mention.value.trigger)
+  if (!q) return options
+  return options.filter(o =>
+    String(o.value).toLowerCase().includes(q) || String(o.label || '').toLowerCase().includes(q),
+  )
+})
+
+const groupedFiltered = computed(() => {
+  const groups = []
+  for (const opt of filteredOptions.value) {
+    const name = opt.group || t('components.mention.fallbackGroup')
+    const g = groups.find(item => item.group === name)
+    if (g) g.options.push(opt)
+    else groups.push({ group: name, options: [opt] })
+  }
+  return groups
+})
+
+const flatList = computed(() => groupedFiltered.value.flatMap(g => g.options))
+
+function flatIndex(gi, oi) {
+  let idx = 0
+  for (let g = 0; g < gi; g++) idx += groupedFiltered.value[g].options.length
+  return idx + oi
+}
+
+// 下拉为 fixed 定位（Teleport 到 body），坐标基于视口；下方空间不足时翻到光标上方
+const mentionStyle = computed(() => mention.value.above
+  ? { left: `${mention.value.left}px`, bottom: `${window.innerHeight - mention.value.top}px` }
+  : { left: `${mention.value.left}px`, top: `${mention.value.top}px` })
+
+// 镜像 div 测量 textarea 光标坐标
+function getCaretCoordinates(textarea, position) {
+  const div = document.createElement('div')
+  const style = getComputedStyle(textarea)
+  const propsToCopy = [
+    'boxSizing', 'width', 'paddingTop', 'paddingRight', 'paddingBottom', 'paddingLeft',
+    'borderTopWidth', 'borderRightWidth', 'borderBottomWidth', 'borderLeftWidth',
+    'fontFamily', 'fontSize', 'fontWeight', 'lineHeight', 'letterSpacing', 'textIndent',
+  ]
+  div.style.position = 'absolute'
+  div.style.visibility = 'hidden'
+  div.style.whiteSpace = 'pre-wrap'
+  div.style.wordWrap = 'break-word'
+  div.style.top = '0'
+  div.style.left = '-9999px'
+  for (const p of propsToCopy) div.style[p] = style[p]
+  div.textContent = textarea.value.substring(0, position)
+  const span = document.createElement('span')
+  span.textContent = textarea.value.substring(position) || '.'
+  div.appendChild(span)
+  document.body.appendChild(div)
+  const rect = { top: span.offsetTop, left: span.offsetLeft }
+  document.body.removeChild(div)
+  const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.7 || 20
+  return { ...rect, lineHeight }
+}
+
+function updateMentionState() {
+  const active = activeMention()
+  if (!active) { mention.value.open = false; return }
+  // @后文本已精确等于某个完整引用名时不再弹列表（如删除引用尾部空格后光标落在完整引用上）
+  if (mentionNames.value.some(([token]) => token === active.trigger + active.query)) {
+    mention.value.open = false
+    return
+  }
+  const ta = taEl.value
+  const caret = getCaretCoordinates(ta, ta.selectionStart)
+  const rect = ta.getBoundingClientRect()
+  const maxLeft = Math.max(0, (wrapEl.value?.clientWidth || DROPDOWN_WIDTH) - DROPDOWN_WIDTH)
+  const belowTop = rect.top + caret.top + caret.lineHeight - ta.scrollTop + 4
+  // 下方放不下时下拉翻到光标上方（top 记为光标行的视口上沿）
+  const above = belowTop + DROPDOWN_MAX_HEIGHT > window.innerHeight - 8 && caret.top > DROPDOWN_MAX_HEIGHT
+  mention.value = {
+    open: true,
+    start: active.start,
+    trigger: active.trigger,
+    query: active.query,
+    top: above ? rect.top + caret.top - ta.scrollTop - 4 : belowTop,
+    left: rect.left + Math.min(caret.left, maxLeft),
+    above,
+  }
+  highlightIdx.value = 0
+}
+
+function closeMention() {
+  mention.value.open = false
+}
+
+function setText(next, caret) {
+  const ta = taEl.value
+  if (ta) {
+    ta.value = next
+    ta.focus()
+    if (caret != null) ta.setSelectionRange(caret, caret)
+  }
+  text.value = next
+  closeMention()
+  emit('update:modelValue', next)
+  emit('commit', next)
+}
+
+function onInput(e) {
+  text.value = e.target.value
+  emit('update:modelValue', e.target.value)
+  updateMentionState()
+}
+
+function onScroll() {
+  if (backdropEl.value && taEl.value) {
+    backdropEl.value.scrollTop = taEl.value.scrollTop
+    backdropEl.value.scrollLeft = taEl.value.scrollLeft
+  }
+  closeMention()
+}
+
+function onKeydown(e) {
+  if (e.isComposing) return
+  const ta = taEl.value
+  // @引用整体删除：光标在完整引用后按退格 / 在完整引用前按 Delete，整段一次删除
+  if (ta && (e.key === 'Backspace' || e.key === 'Delete') && ta.selectionStart === ta.selectionEnd) {
+    const hit = e.key === 'Backspace' ? mentionBeforeCaret() : mentionAfterCaret()
+    if (hit) {
+      e.preventDefault()
+      const next = ta.value.slice(0, hit.start) + ta.value.slice(hit.end)
+      setText(next, hit.start)
+      return
+    }
+  }
+  if (!mention.value.open) return
+  const total = flatList.value.length
+  if (e.key === 'ArrowDown') {
+    e.preventDefault()
+    if (total) highlightIdx.value = (highlightIdx.value + 1) % total
+  } else if (e.key === 'ArrowUp') {
+    e.preventDefault()
+    if (total) highlightIdx.value = (highlightIdx.value - 1 + total) % total
+  } else if (e.key === 'Enter' || e.key === 'Tab') {
+    if (total) {
+      e.preventDefault()
+      pick(flatList.value[highlightIdx.value] || flatList.value[0])
+    }
+  } else if (e.key === 'Escape') {
+    e.preventDefault()
+    closeMention()
+  }
+}
+
+function pick(opt) {
+  const ta = taEl.value
+  if (!ta) return
+  const pos = ta.selectionStart
+  const before = ta.value.slice(0, mention.value.start)
+  const after = ta.value.slice(pos)
+  const insert = `${mentionToken(opt)}${opt.trigger === '#' ? '' : ' '}`
+  const next = before + insert + after
+  setText(next, before.length + insert.length)
+}
+
+function onBlur(e) {
+  closeMention()
+  emit('commit', e.target.value)
+}
+</script>
+
+<style scoped>
+.mention-textarea {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  flex: 1;
+  min-height: 0;
+}
+/* 高亮镜像层：与 textarea 同款类名保证排版一致，仅背景/边框透明 */
+.mention-backdrop {
+  position: absolute;
+  inset: 0;
+  z-index: 0;
+  background: transparent;
+  border-color: transparent;
+  box-shadow: none;
+  overflow: hidden;
+  pointer-events: none;
+}
+.mention-backdrop-content {
+  white-space: pre-wrap;
+  word-wrap: break-word;
+  overflow-wrap: break-word;
+}
+/* textarea 文本透明，只显示光标；高亮由镜像层透出 */
+.mention-input {
+  position: relative;
+  z-index: 1;
+  flex: 1;
+  min-height: 0;
+  width: 100%;
+  resize: none;
+  background: transparent;
+  color: transparent;
+  caret-color: var(--text-0);
+}
+.mention-input::placeholder {
+  color: var(--text-3);
+}
+/* @引用 着色：不改字距/内边距，保证与透明文本逐字对齐 */
+.mention-backdrop :deep(.mention-token) {
+  border-radius: 4px;
+  font-weight: 600;
+}
+.mention-backdrop :deep(.mention-token-role) {
+  color: var(--accent-text);
+  background: var(--accent-bg);
+}
+.mention-backdrop :deep(.mention-token-scene) {
+  color: var(--tag-success-text);
+  background: var(--success-bg);
+}
+.mention-backdrop :deep(.mention-token-voice) {
+  color: var(--tag-success-text);
+  background: var(--success-bg);
+}
+.mention-dropdown {
+  position: fixed;
+  z-index: var(--z-menu);
+  width: 240px;
+  max-height: 220px;
+  overflow-y: auto;
+  padding: 5px;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+  box-shadow: var(--shadow-lg);
+}
+.mention-group-label {
+  padding: 6px 8px 3px;
+  font-size: 10px;
+  font-weight: 600;
+  color: var(--text-3);
+  letter-spacing: 0.02em;
+}
+.mention-option {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  padding: 5px 8px;
+  border: none;
+  border-radius: var(--radius-sm);
+  background: transparent;
+  cursor: pointer;
+  text-align: left;
+}
+.mention-option.highlighted {
+  background: var(--accent-bg);
+}
+.mention-avatar {
+  width: 20px;
+  height: 20px;
+  border-radius: 50%;
+  background: var(--bg-2);
+  color: var(--text-2);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 10px;
+  font-weight: 700;
+  overflow: hidden;
+  flex-shrink: 0;
+}
+.mention-avatar img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+/* 无图时按分组着色图标底色 */
+.mention-avatar-role { color: var(--accent-text); background: var(--accent-bg); }
+.mention-avatar-scene { color: var(--tag-success-text); background: var(--success-bg); }
+.mention-avatar-prop { color: var(--text-2); background: var(--bg-2); }
+.mention-name {
+  flex: 1;
+  min-width: 0;
+  font-size: 12px;
+  font-weight: 550;
+  color: var(--text-0);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.mention-type {
+  flex-shrink: 0;
+  font-size: 10px;
+  color: var(--text-3);
+}
+.mention-empty {
+  padding: 10px;
+  font-size: 12px;
+  color: var(--text-3);
+  text-align: center;
+}
+</style>
diff --git a/huobao-source/frontend/app/components/MigrateOverlay.vue b/huobao-source/frontend/app/components/MigrateOverlay.vue
new file mode 100644
index 0000000..ed5e2a4
--- /dev/null
+++ b/huobao-source/frontend/app/components/MigrateOverlay.vue
@@ -0,0 +1,76 @@
+<template>
+  <Teleport to="body">
+    <div v-if="state.active" class="migrate-overlay">
+      <div class="migrate-box">
+        <Loader2 :size="26" class="animate-spin" />
+        <div class="migrate-title">{{ t('migrate.title') }}</div>
+        <div class="migrate-msg">{{ state.message }}</div>
+        <div class="migrate-bar">
+          <div class="migrate-bar-fill" :style="{ width: `${state.percent}%` }"></div>
+        </div>
+        <div class="migrate-hint">{{ t('migrate.hint') }}</div>
+      </div>
+    </div>
+  </Teleport>
+</template>
+
+<script setup lang="ts">
+import { Loader2 } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+import { useMigrateState } from '~/composables/useMigrateState'
+
+const { t } = useI18n()
+const { state } = useMigrateState()
+</script>
+
+<style scoped>
+.migrate-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: var(--z-blocking);
+  background: rgba(8, 10, 14, 0.72);
+  backdrop-filter: blur(4px);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.migrate-box {
+  width: 380px;
+  padding: 28px 32px;
+  border-radius: 12px;
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+  box-shadow: var(--shadow-elevated);
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 12px;
+  color: var(--text-0);
+}
+.migrate-title {
+  font-size: 15px;
+  font-weight: 600;
+}
+.migrate-msg {
+  font-size: 12px;
+  color: var(--text-2);
+  min-height: 16px;
+}
+.migrate-bar {
+  width: 100%;
+  height: 6px;
+  border-radius: 3px;
+  background: var(--overlay-track);
+  overflow: hidden;
+}
+.migrate-bar-fill {
+  height: 100%;
+  border-radius: 3px;
+  background: var(--accent);
+  transition: width 0.2s ease;
+}
+.migrate-hint {
+  font-size: 11px;
+  color: var(--text-3);
+}
+</style>
diff --git a/huobao-source/frontend/app/components/ModelSelect.vue b/huobao-source/frontend/app/components/ModelSelect.vue
new file mode 100644
index 0000000..6d0a324
--- /dev/null
+++ b/huobao-source/frontend/app/components/ModelSelect.vue
@@ -0,0 +1,146 @@
+<template>
+  <div class="model-select">
+    <span class="model-select-label">{{ label }}</span>
+    <AppMenu v-model:open="isOpen" :min-width="280">
+      <template #trigger>
+        <button type="button" class="model-select-trigger" :class="{ open: isOpen }">
+          <img v-if="triggerIcon" :src="triggerIcon" class="model-select-icon" alt="" />
+          <span v-else-if="currentOption?.provider" class="model-select-provider">{{ currentOption.provider }}</span>
+          <span class="model-select-value">{{ currentLabel }}</span>
+          <ChevronDown :size="11" class="model-select-arrow" :class="{ open: isOpen }" />
+        </button>
+      </template>
+
+      <AppMenuItem v-if="!hideDefault" :selected="modelValue === ''" @click="pick('')">
+        <img v-if="defaultIcon" :src="defaultIcon" class="model-select-icon sm" alt="" />
+        <span class="model-select-dim">{{ effectiveDefaultLabel }}</span>
+      </AppMenuItem>
+      <AppMenuItem
+        v-for="o in options"
+        :key="o.key || o.model"
+        :selected="modelValue === (o.key || o.model)"
+        :title="`${o.model}${o.configName ? ` · ${o.configName}` : ''}`"
+        @click="pick(o.key || o.model)"
+      >
+        <span class="model-select-option-name">{{ optionLabel(o) }}</span>
+        <template v-if="modelIconUrl(o.provider, o.model)" #trailing>
+          <img :src="modelIconUrl(o.provider, o.model)" class="model-select-icon sm" alt="" />
+        </template>
+      </AppMenuItem>
+    </AppMenu>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { ChevronDown } from 'lucide-vue-next'
+import { modelIconUrl } from '~/composables/useProviderIcon'
+
+const props = defineProps({
+  label: { type: String, required: true },          // 改写 / 图片 / 视频
+  modelValue: { type: String, default: '' },        // '' = 默认（配置首个模型）；选中值为 'provider/model' 复合键
+  options: { type: Array, default: () => [] },      // [{ key, model, provider, configId, configName }]
+  defaultLabel: { type: String, default: '' },      // 缺省回退 t('common.default')
+  showConfig: { type: Boolean, default: false },    // 多配置时显示来源配置名
+  hideDefault: { type: Boolean, default: false },   // 无「默认」语义的选择器（如分辨率）隐藏默认项
+})
+const emit = defineEmits(['update:modelValue'])
+
+const { t } = useI18n()
+
+const isOpen = ref(false)
+
+const effectiveDefaultLabel = computed(() => props.defaultLabel || t('common.default'))
+const currentOption = computed(() => props.options.find(o => (o.key || o.model) === props.modelValue) || null)
+const optionLabel = o => o.gpu && o.gpu !== 'auto'
+  ? `${o.gpu.toUpperCase()}${o.comfyLabel ? ` · ${o.comfyLabel}` : ''} · ${o.model}`
+  : props.showConfig && o.configName ? `${o.model} · ${o.configName}` : o.model
+const currentLabel = computed(() => currentOption.value ? optionLabel(currentOption.value) : effectiveDefaultLabel.value)
+// 默认 = 首个选项；未显式选模型时也展示默认模型的厂商图标（与 defaultLabel 取 options[0] 同口径）
+// 图标按模型名推断（网关 provider=openai 但模型实为 deepseek 等场景），回退 provider
+const defaultIcon = computed(() => modelIconUrl(props.options[0]?.provider, props.options[0]?.model))
+const triggerIcon = computed(() =>
+  currentOption.value
+    ? modelIconUrl(currentOption.value.provider, currentOption.value.model)
+    : defaultIcon.value)
+
+function pick(model) {
+  emit('update:modelValue', model)
+  isOpen.value = false
+}
+</script>
+
+<style scoped>
+.model-select {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+.model-select-label {
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--text-3);
+}
+.model-select-trigger {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  height: 26px;
+  max-width: 210px;
+  padding: 0 8px 0 10px;
+  border: 1px solid var(--border-strong);
+  border-radius: 999px;
+  background: var(--bg-input);
+  color: var(--text-1);
+  font: 11px var(--font-body);
+  cursor: pointer;
+  transition: border-color 0.16s, box-shadow 0.16s, background 0.16s;
+}
+.model-select-trigger:hover { border-color: var(--border-hover); }
+.model-select-trigger.open,
+.model-select-trigger:focus-visible {
+  border-color: var(--border-focus);
+  box-shadow: 0 0 0 3px var(--button-focus);
+  outline: none;
+}
+.model-select-value {
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}
+.model-select-icon {
+  flex-shrink: 0;
+  width: 14px;
+  height: 14px;
+  object-fit: contain;
+  border-radius: 2.5px;
+}
+.model-select-icon.sm { width: 12px; height: 12px; }
+.model-select-provider {
+  flex-shrink: 0;
+  padding: 1px 5px;
+  border-radius: 4px;
+  background: var(--accent-bg);
+  color: var(--accent);
+  font-size: 9px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.02em;
+}
+.model-select-arrow {
+  flex-shrink: 0;
+  color: var(--text-3);
+  transition: transform 0.18s var(--ease-out);
+}
+.model-select-arrow.open { transform: rotate(180deg); }
+
+/* 菜单项：模型名完整优先，超长才省略（tooltip 有全名） */
+.model-select-option-name {
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  max-width: 320px;
+}
+.model-select-dim { color: var(--text-3); }
+</style>
diff --git a/huobao-source/frontend/app/components/ThemeToggle.vue b/huobao-source/frontend/app/components/ThemeToggle.vue
new file mode 100644
index 0000000..6da9407
--- /dev/null
+++ b/huobao-source/frontend/app/components/ThemeToggle.vue
@@ -0,0 +1,47 @@
+<template>
+  <button
+    type="button"
+    class="theme-toggle"
+    :aria-label="t('layout.theme.label')"
+    :title="modeLabel"
+    @click="cycleThemeMode()"
+  >
+    <component :is="modeIcon" :size="15" :stroke-width="1.8" />
+  </button>
+</template>
+
+<script setup>
+import { computed } from 'vue'
+import { Sun, Moon, Monitor } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+import { useTheme } from '~/composables/useTheme'
+
+const { t } = useI18n()
+const { themeMode, cycleThemeMode } = useTheme()
+
+// 图标显示当前模式（system 显示显示器图标，而非 resolved 结果）
+const modeIcon = computed(() => ({ light: Sun, dark: Moon, system: Monitor })[themeMode.value])
+const modeLabel = computed(() => t(`layout.theme.${themeMode.value}`))
+</script>
+
+<style scoped>
+.theme-toggle {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  border: none;
+  border-radius: var(--radius-pill);
+  background: transparent;
+  color: var(--text-2);
+  cursor: pointer;
+  transition: all 0.18s var(--ease-out);
+  line-height: 1;
+}
+.theme-toggle:hover { color: var(--text-0); background: var(--bg-hover); }
+.theme-toggle:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+</style>
diff --git a/huobao-source/frontend/app/composables/i18n.ts b/huobao-source/frontend/app/composables/i18n.ts
new file mode 100644
index 0000000..e295349
--- /dev/null
+++ b/huobao-source/frontend/app/composables/i18n.ts
@@ -0,0 +1,52 @@
+/**
+ * i18n 实例（模块级单例）
+ * - 实例放独立模块而非插件内：useAgent/useMigrateState 等 setup 外代码
+ *   需要 `import { i18n }` 直接用 i18n.global.t
+ * - ssr:false，模块顶层读 localStorage 安全；UI 语言偏好持久化 huobao:locale
+ * - legacy:false 必须显式，否则 global.locale 不是 ref 无法运行时切换
+ */
+import { createI18n } from 'vue-i18n'
+import zh from '../locales/zh.json'
+import en from '../locales/en.json'
+import ja from '../locales/ja.json'
+import ko from '../locales/ko.json'
+
+export const LOCALE_STORAGE_KEY = 'huobao:locale'
+
+export type UiLocale = 'zh' | 'en' | 'ja' | 'ko'
+
+export const UI_LOCALES: Array<{ value: UiLocale; label: string }> = [
+  { value: 'zh', label: '中文' },
+  { value: 'en', label: 'English' },
+  { value: 'ja', label: '日本語' },
+  { value: 'ko', label: '한국어' },
+]
+
+export function readStoredLocale(): UiLocale {
+  try {
+    const v = localStorage.getItem(LOCALE_STORAGE_KEY)
+    if (v && UI_LOCALES.some(l => l.value === v)) return v as UiLocale
+  } catch { /* localStorage 不可用时回退默认 */ }
+  return 'zh'
+}
+
+export function persistLocale(locale: UiLocale) {
+  try {
+    localStorage.setItem(LOCALE_STORAGE_KEY, locale)
+  } catch { /* 忽略持久化失败 */ }
+}
+
+export const i18n = createI18n({
+  legacy: false,
+  locale: readStoredLocale(),
+  fallbackLocale: 'zh',
+  messages: { zh, en, ja, ko },
+  missingWarn: false,
+  fallbackWarn: false,
+})
+
+/** 切换 UI 语言并持久化（LocaleSwitcher 与初始化共用） */
+export function setUiLocale(locale: UiLocale) {
+  i18n.global.locale.value = locale
+  persistLocale(locale)
+}
diff --git a/huobao-source/frontend/app/composables/useAgent.ts b/huobao-source/frontend/app/composables/useAgent.ts
new file mode 100644
index 0000000..961f67e
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useAgent.ts
@@ -0,0 +1,33 @@
+import { toast } from 'vue-sonner'
+import { api } from './useApi'
+import { toastError } from './useToast'
+import { i18n } from './i18n'
+
+export function useAgent() {
+  const running = ref(false)
+  const runningType = ref<string | null>(null)
+
+  async function run(type: string, msg: string, dramaId: number, episodeId: number, onDone?: () => void, model?: string, configId?: number) {
+    if (running.value) { toast.warning(i18n.global.t('composables.agent.busy')); return }
+    running.value = true
+    runningType.value = type
+    try {
+      const data = await api.post<any>(`/agent/${type}/chat`, {
+        message: msg,
+        drama_id: dramaId,
+        episode_id: episodeId,
+        model: model || undefined,
+        config_id: configId || undefined,
+      })
+      toast.success(i18n.global.t('composables.agent.done'))
+      onDone?.()
+    } catch (err: any) {
+      toastError(err)
+    } finally {
+      running.value = false
+      runningType.value = null
+    }
+  }
+
+  return { running, runningType, run }
+}
diff --git a/huobao-source/frontend/app/composables/useApi.ts b/huobao-source/frontend/app/composables/useApi.ts
new file mode 100644
index 0000000..3a3af45
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useApi.ts
@@ -0,0 +1,194 @@
+const BASE = '/api/v1'
+
+async function req<T = any>(method: string, path: string, body?: any): Promise<T> {
+  const opts: RequestInit = { method, headers: { 'Content-Type': 'application/json' } }
+  if (body) opts.body = JSON.stringify(body)
+
+  const start = performance.now()
+  console.log(`%c[API] %c${method} %c${path}`, 'color:#888', 'color:#4fc3f7;font-weight:bold', 'color:#ccc', body || '')
+
+  try {
+    const resp = await fetch(`${BASE}${path}`, opts)
+    const json = await resp.json()
+    const ms = Math.round(performance.now() - start)
+
+    if (!resp.ok || (json.code && json.code >= 400)) {
+      console.log(`%c[API] %c${method} ${path} %c${resp.status} %c${ms}ms`, 'color:#888', 'color:#ef5350', 'color:#ef5350;font-weight:bold', 'color:#888', json.message || '')
+      throw new Error(json.message || `${resp.status}`)
+    }
+
+    console.log(`%c[API] %c${method} ${path} %c${resp.status} %c${ms}ms`, 'color:#888', 'color:#66bb6a', 'color:#66bb6a;font-weight:bold', 'color:#888')
+    return json.data ?? json
+  } catch (err: any) {
+    if (!err.message?.match(/^\d{3}$/)) {
+      const ms = Math.round(performance.now() - start)
+      console.log(`%c[API] %c${method} ${path} %cERROR %c${ms}ms`, 'color:#888', 'color:#ef5350', 'color:#ef5350;font-weight:bold', 'color:#888', err.message)
+    }
+    throw err
+  }
+}
+
+export const api = {
+  get: <T = any>(p: string) => req<T>('GET', p),
+  post: <T = any>(p: string, b?: any) => req<T>('POST', p, b),
+  put: <T = any>(p: string, b?: any) => req<T>('PUT', p, b),
+  del: <T = any>(p: string) => req<T>('DELETE', p),
+}
+
+export const dramaAPI = {
+  list: () => api.get<{ items: any[] }>('/dramas'),
+  get: (id: number) => api.get(`/dramas/${id}`),
+  create: (data: any) => api.post('/dramas', data),
+  update: (id: number, data: any) => api.put(`/dramas/${id}`, data),
+  del: (id: number) => api.del(`/dramas/${id}`),
+}
+
+export const episodeAPI = {
+  create: (data: any) => api.post('/episodes', data),
+  update: (id: number, data: any) => api.put(`/episodes/${id}`, data),
+  del: (id: number) => api.del(`/episodes/${id}`),
+  characters: (id: number) => api.get(`/episodes/${id}/characters`),
+  scenes: (id: number) => api.get(`/episodes/${id}/scenes`),
+  props: (id: number) => api.get(`/episodes/${id}/props`),
+  storyboards: (id: number) => api.get(`/episodes/${id}/storyboards`),
+  pipelineStatus: (id: number) => api.get(`/episodes/${id}/pipeline-status`),
+  extract: (id: number, target: string, model?: string, configId?: number) => api.post(`/episodes/${id}/extract`, { target, model: model || undefined, config_id: configId || undefined }),
+  extractStatus: (id: number) => api.get(`/episodes/${id}/extract-status`),
+  generateVideoPrompts: (id: number, model?: string, configId?: number, storyboardIds?: number[]) => api.post(`/episodes/${id}/generate-video-prompts`, { model: model || undefined, config_id: configId || undefined, storyboard_ids: storyboardIds?.length ? storyboardIds : undefined }),
+  videoPromptsStatus: (id: number) => api.get(`/episodes/${id}/video-prompts-status`),
+}
+
+export const storyboardAPI = {
+  create: (data: any) => api.post('/storyboards', data),
+  update: (id: number, data: any) => api.put(`/storyboards/${id}`, data),
+  del: (id: number) => api.del(`/storyboards/${id}`),
+}
+
+export const characterAPI = {
+  uploadVoice: (id: number, file: File) => uploadReq<CharacterVoice>(`/characters/${id}/voice`, file),
+  removeVoice: (id: number) => api.del<CharacterVoice>(`/characters/${id}/voice`),
+  create: (data: any) => api.post('/characters', data),
+  update: (id: number, data: any) => api.put(`/characters/${id}`, data),
+  del: (id: number) => api.del(`/characters/${id}`),
+  generatePrompt: (id: number, episodeId: number, force = false, textModel?: string, textConfigId?: number) => api.post(`/characters/${id}/generate-prompt`, { episode_id: episodeId, force, text_model: textModel || undefined, text_config_id: textConfigId || undefined }),
+  generateImage: (id: number, episodeId: number, model?: string, configId?: number, textModel?: string, textConfigId?: number) => api.post(`/characters/${id}/generate-image`, { episode_id: episodeId, model: model || undefined, config_id: configId || undefined, text_model: textModel || undefined, text_config_id: textConfigId || undefined }),
+  batchImages: (ids: number[], episodeId: number, model?: string, configId?: number, textModel?: string, textConfigId?: number) => api.post('/characters/batch-generate-images', { character_ids: ids, episode_id: episodeId, model: model || undefined, config_id: configId || undefined, text_model: textModel || undefined, text_config_id: textConfigId || undefined }),
+}
+
+export interface CharacterVoice {
+  voice_audio_url: string | null
+  voice_audio_name: string | null
+}
+
+export type AssetKind = 'character' | 'scene' | 'prop'
+const assetResource = { character: 'characters', scene: 'scenes', prop: 'props' }
+export const assetReferenceAPI = {
+  upload: (kind: AssetKind, id: number, file: File) => uploadReq<{ reference_images: string[] }>(`/${assetResource[kind]}/${id}/reference-images`, file),
+  remove: (kind: AssetKind, id: number, path: string) => req<{ reference_images: string[] }>('DELETE', `/${assetResource[kind]}/${id}/reference-images`, { path }),
+}
+
+export const sceneAPI = {
+  create: (data: any) => api.post('/scenes', data),
+  update: (id: number, data: any) => api.put(`/scenes/${id}`, data),
+  del: (id: number) => api.del(`/scenes/${id}`),
+  generatePrompt: (id: number, episodeId: number, force = false, textModel?: string, textConfigId?: number) => api.post(`/scenes/${id}/generate-prompt`, { episode_id: episodeId, force, text_model: textModel || undefined, text_config_id: textConfigId || undefined }),
+  generateImage: (id: number, episodeId: number, model?: string, configId?: number, textModel?: string, textConfigId?: number) => api.post(`/scenes/${id}/generate-image`, { episode_id: episodeId, model: model || undefined, config_id: configId || undefined, text_model: textModel || undefined, text_config_id: textConfigId || undefined }),
+}
+
+export const propAPI = {
+  create: (data: any) => api.post('/props', data),
+  update: (id: number, data: any) => api.put(`/props/${id}`, data),
+  del: (id: number) => api.del(`/props/${id}`),
+  generatePrompt: (id: number, episodeId: number, force = false, textModel?: string, textConfigId?: number) => api.post(`/props/${id}/generate-prompt`, { episode_id: episodeId, force, text_model: textModel || undefined, text_config_id: textConfigId || undefined }),
+  generateImage: (id: number, episodeId: number, model?: string, configId?: number, textModel?: string, textConfigId?: number) => api.post(`/props/${id}/generate-image`, { episode_id: episodeId, model: model || undefined, config_id: configId || undefined, text_model: textModel || undefined, text_config_id: textConfigId || undefined }),
+}
+
+// 统一生成任务（图片/视频）：POST 带 type 字段，列表按 type 过滤
+export const taskAPI = {
+  generate: (d: any) => api.post('/tasks', d),
+  recover: (id: number) => api.post(`/tasks/${id}/recover`),
+  diagnostics: (id: number) => api.get(`/tasks/${id}/diagnostics`),
+  get: (id: number) => api.get(`/tasks/${id}`),
+  del: (id: number) => api.del(`/tasks/${id}`),
+  list: (params?: { type?: 'image' | 'video'; drama_id?: number; storyboard_id?: number }) => {
+    const query = new URLSearchParams()
+    if (params?.type) query.set('type', params.type)
+    if (params?.drama_id) query.set('drama_id', String(params.drama_id))
+    if (params?.storyboard_id) query.set('storyboard_id', String(params.storyboard_id))
+    return api.get(`/tasks${query.size ? `?${query.toString()}` : ''}`)
+  },
+  // 按集聚合生成任务（sys_task + video_merges）
+  listByEpisode: (episodeId: number) => api.get<{ tasks: any[]; merges: any[] }>(`/episodes/${episodeId}/generation-tasks`),
+}
+
+async function uploadReq<T = any>(path: string, file: File): Promise<T> {
+  const fd = new FormData()
+  fd.append('file', file)
+  console.log(`%c[API] %cPOST %c${path} %c${file.name}`, 'color:#888', 'color:#4fc3f7;font-weight:bold', 'color:#ccc', 'color:#888')
+  const resp = await fetch(`${BASE}${path}`, { method: 'POST', body: fd })
+  const json = await resp.json()
+  if (!resp.ok || (json.code && json.code >= 400)) {
+    console.log(`%c[API] %cPOST ${path} %c${resp.status}`, 'color:#888', 'color:#ef5350', 'color:#ef5350;font-weight:bold')
+    throw new Error(json.message || `${resp.status}`)
+  }
+  return json.data ?? json
+}
+
+export const uploadAPI = {
+  image: (f: File) => uploadReq<{ url: string; path: string }>('/upload/image', f),
+  video: (f: File) => uploadReq<{ url: string; path: string }>('/upload/video', f),
+  audio: (f: File) => uploadReq<{ url: string; path: string }>('/upload/audio', f),
+}
+export const mergeAPI = {
+  merge: (epId: number, storyboardIds?: number[]) => api.post(`/merge/episodes/${epId}/merge`, storyboardIds?.length ? { storyboard_ids: storyboardIds } : {}),
+  status: (epId: number) => api.get(`/merge/episodes/${epId}/merge`),
+  list: (epId: number) => api.get<any[]>(`/merge/episodes/${epId}/merges`),
+}
+export const aiConfigAPI = {
+  list: (t?: string) => api.get(`/ai-configs${t ? `?service_type=${t}` : ''}`),
+  create: (d: any) => api.post('/ai-configs', d),
+  update: (id: number, d: any) => api.put(`/ai-configs/${id}`, d),
+  del: (id: number) => api.del(`/ai-configs/${id}`),
+  test: (d: any) => api.post('/ai-configs/test', d),
+}
+
+// lang 缺省/为 zh 时读写基础版（不带 query，保持原请求形态）
+const langQ = (lang?: string) => (lang && lang !== 'zh' ? `?lang=${lang}` : '')
+
+export const promptAPI = {
+  list: () => api.get('/prompts'),
+  get: (type: string, lang?: string) => api.get(`/prompts/${type}${langQ(lang)}`),
+  update: (type: string, d: any, lang?: string) => api.put(`/prompts/${type}${langQ(lang)}`, d),
+  reset: (type: string, lang?: string) => api.post(`/prompts/${type}/reset${langQ(lang)}`),
+}
+
+export const skillsAPI = {
+  list: (lang?: string) => api.get(`/skills${langQ(lang)}`),
+  get: (id: string, lang?: string) => api.get(`/skills/${id}${langQ(lang)}`),
+  create: (data: { id: string; name: string; description?: string }) => api.post('/skills', data),
+  update: (id: string, content: string, lang?: string) => api.put(`/skills/${id}${langQ(lang)}`, { content }),
+  del: (id: string) => api.del(`/skills/${id}`),
+}
+
+export const stylePresetAPI = {
+  list: (all = false) => api.get(`/style-presets${all ? '?all=1' : ''}`),
+  create: (d: any) => api.post('/style-presets', d),
+  update: (id: number, d: any) => api.put(`/style-presets/${id}`, d),
+  del: (id: number) => api.del(`/style-presets/${id}`),
+}
+
+export const storageAPI = {
+  info: () => api.get('/storage'),
+}
+
+export const settingsAPI = {
+  contentLanguage: () => api.get<{ language: string }>('/settings/content-language'),
+  setContentLanguage: (language: string) => api.put('/settings/content-language', { language }),
+}
+
+// 服务器/Docker 部署的版本检查与更新（桌面版走 useDesktopBridge，不用此 API）
+export const serverUpdateAPI = {
+  state: () => api.get('/server-update/state'),
+  check: () => api.post('/server-update/check'),
+  apply: () => api.post('/server-update/apply'),
+}
diff --git a/huobao-source/frontend/app/composables/useDesktopBridge.ts b/huobao-source/frontend/app/composables/useDesktopBridge.ts
new file mode 100644
index 0000000..204526c
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useDesktopBridge.ts
@@ -0,0 +1,30 @@
+/**
+ * 桌面版桥（preload 注入的 window.huobaoDesktop）类型声明与安全取值。
+ * 非桌面环境（浏览器/服务器部署）返回 null，UI 据此隐藏桌面专属功能。
+ */
+
+export interface UpdateState {
+  status: 'idle' | 'checking' | 'up-to-date' | 'available' | 'downloading' | 'downloaded' | 'error'
+  currentVersion: string
+  latestVersion?: string
+  notes?: string
+  error?: string
+  downloadProgress?: number
+  downloadedFile?: string
+}
+
+export interface HuobaoDesktopBridge {
+  pickDirectory: () => Promise<{ ok: boolean, path?: string, freeBytes?: number | null, error?: string, canceled?: boolean }>
+  startMigration: (opts: { targetDir: string, migrateFiles: boolean }) => Promise<{ ok: boolean }>
+  onMigrateProgress: (cb: (progress: { phase: string, message?: string, copiedBytes?: number, totalBytes?: number }) => void) => () => void
+  getUpdateState: () => Promise<UpdateState>
+  checkUpdate: () => Promise<UpdateState>
+  downloadUpdate: () => Promise<UpdateState>
+  applyUpdate: () => Promise<void>
+  onUpdateProgress: (cb: (percent: number) => void) => () => void
+}
+
+export function useDesktopBridge(): HuobaoDesktopBridge | null {
+  if (typeof window === 'undefined') return null
+  return (window as unknown as { huobaoDesktop?: HuobaoDesktopBridge }).huobaoDesktop ?? null
+}
diff --git a/huobao-source/frontend/app/composables/useMedia.ts b/huobao-source/frontend/app/composables/useMedia.ts
new file mode 100644
index 0000000..e35825f
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useMedia.ts
@@ -0,0 +1,30 @@
+/**
+ * 媒体地址辅助 — 列表/卡片用缩略图与海报帧，大图预览仍用原图
+ *
+ * 命名约定（后端生成产物时自动产出，见 backend/src/utils/storage.ts、video-poster.ts）：
+ *   图片 static/images/x.png      → 缩略图 static/images/x_thumb.webp
+ *   视频 static/videos|merged/x.mp4 → 海报帧 static/videos|merged/x_poster.jpg
+ * 存量文件可用 `npm run backfill-artwork`（backend）补齐。
+ */
+
+/** 图片地址 → 缩略图地址；非 /static 图片（远程 URL 等）原样返回 */
+export function thumbOf(url: string): string {
+  if (!url || !url.includes('/static/')) return url
+  if (!/\.(png|jpe?g|webp|gif)$/i.test(url)) return url
+  return url.replace(/\.[^./]+$/, '_thumb.webp')
+}
+
+/** 缩略图加载失败（老数据未回填）时回退原图 */
+export function thumbFallback(e: Event, orig: string) {
+  const el = e.target as HTMLImageElement
+  if (!el || el.dataset.fbk || !orig) return
+  el.dataset.fbk = '1'
+  el.src = orig
+}
+
+/** 视频地址 → 海报帧地址；无法推导（远程 URL 等）时返回空串，不设置 poster */
+export function posterOf(url: string): string {
+  if (!url || !url.includes('/static/')) return ''
+  if (!/\.(mp4|webm|mov)$/i.test(url)) return ''
+  return url.replace(/\.[^./]+$/, '_poster.jpg')
+}
diff --git a/huobao-source/frontend/app/composables/useMigrateState.ts b/huobao-source/frontend/app/composables/useMigrateState.ts
new file mode 100644
index 0000000..fa2aa7a
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useMigrateState.ts
@@ -0,0 +1,71 @@
+/**
+ * 存储迁移全局状态（模块级单例）。
+ * MigrateOverlay 据此渲染全屏遮罩；迁移由设置页触发，进度经 preload 订阅回填。
+ */
+import { reactive } from 'vue'
+import { i18n } from './i18n'
+
+interface MigrateState {
+  active: boolean
+  phase: string
+  percent: number
+  message: string
+}
+
+const state = reactive<MigrateState>({
+  active: false,
+  phase: '',
+  percent: 0,
+  message: '',
+})
+
+// 渲染/调用时经 i18n.global.t 求值，语言切换即时生效（不能模块级常量固化）
+function phaseText(phase: string): string {
+  const t = i18n.global.t
+  const keys: Record<string, string> = {
+    validating: 'migrate.phases.validating',
+    stopping: 'migrate.phases.stopping',
+    moving: 'migrate.phases.moving',
+    config: 'migrate.phases.config',
+    restarting: 'migrate.phases.restarting',
+    done: 'migrate.phases.done',
+    error: 'migrate.phases.error',
+  }
+  return keys[phase] ? t(keys[phase]) : phase
+}
+
+export function useMigrateState() {
+  function begin() {
+    state.active = true
+    state.phase = 'validating'
+    state.percent = 0
+    state.message = phaseText('validating')
+  }
+
+  function update(p: { phase: string, message?: string, copiedBytes?: number, totalBytes?: number }) {
+    state.phase = p.phase
+    if (p.phase === 'moving' && p.totalBytes) {
+      state.percent = Math.min(99, Math.round(((p.copiedBytes ?? 0) / p.totalBytes) * 100))
+      state.message = i18n.global.t('migrate.phases.movingProgress', {
+        copied: formatBytes(p.copiedBytes ?? 0),
+        total: formatBytes(p.totalBytes),
+      })
+    } else {
+      state.message = p.message || phaseText(p.phase)
+      if (p.phase === 'done') state.percent = 100
+    }
+  }
+
+  function end() {
+    state.active = false
+  }
+
+  return { state, begin, update, end }
+}
+
+function formatBytes(n: number): string {
+  if (n >= 1024 ** 3) return `${(n / 1024 ** 3).toFixed(1)} GB`
+  if (n >= 1024 ** 2) return `${(n / 1024 ** 2).toFixed(0)} MB`
+  if (n >= 1024) return `${(n / 1024).toFixed(0)} KB`
+  return `${n} B`
+}
diff --git a/huobao-source/frontend/app/composables/usePopover.ts b/huobao-source/frontend/app/composables/usePopover.ts
new file mode 100644
index 0000000..8265a58
--- /dev/null
+++ b/huobao-source/frontend/app/composables/usePopover.ts
@@ -0,0 +1,120 @@
+/**
+ * usePopover — 全站统一的浮层定位与生命周期
+ *
+ * 行为规范（所有下拉/菜单强制一致）：
+ * - 定位：fixed + getBoundingClientRect，水平按 placement 对齐并钳制视口，
+ *   下方空间不足且上方更大时翻转到上方
+ * - 滚动（面板自身滚动除外）/ resize → 关闭
+ * - Escape → 关闭并把焦点还回触发器
+ * - pointerdown outside → 关闭（点击继续生效，不用 backdrop 元素：
+ *   backdrop 会盖住触发器导致点触发器关不掉，且要成对维护 z-index）
+ */
+import { ref, watch, nextTick, onBeforeUnmount, type CSSProperties, type Ref } from 'vue'
+
+export interface PopoverOptions {
+  placement?: 'bottom-start' | 'bottom-end' | 'bottom'
+  offset?: number
+  matchWidth?: boolean
+  minWidth?: number
+  maxHeight?: number
+  viewportMargin?: number
+}
+
+export interface PopoverReturn {
+  isOpen: Ref<boolean>
+  anchorEl: Ref<HTMLElement | null>
+  panelEl: Ref<HTMLElement | null>
+  panelStyle: Ref<CSSProperties>
+  placement: Ref<'bottom' | 'top'>
+  open: () => void
+  close: () => void
+  toggle: () => void
+}
+
+export function usePopover(opts: PopoverOptions = {}): PopoverReturn {
+  const isOpen = ref(false)
+  const anchorEl = ref<HTMLElement | null>(null)
+  const panelEl = ref<HTMLElement | null>(null)
+  const panelStyle = ref<CSSProperties>({})
+  const placement = ref<'bottom' | 'top'>('bottom')
+
+  const offset = opts.offset ?? 6
+  const margin = opts.viewportMargin ?? 12
+  const minWidth = opts.minWidth ?? 160
+  const maxHeight = opts.maxHeight ?? 320
+
+  async function position() {
+    const rect = anchorEl.value?.getBoundingClientRect()
+    if (!rect) return
+    const width = opts.matchWidth ? rect.width : Math.max(minWidth, rect.width)
+
+    let left = rect.left
+    if (opts.placement === 'bottom-end') left = rect.right - width
+    else if (opts.placement === 'bottom') left = rect.left + rect.width / 2 - width / 2
+    left = Math.max(margin, Math.min(left, window.innerWidth - width - margin))
+
+    placement.value = 'bottom'
+    panelStyle.value = {
+      position: 'fixed',
+      top: `${rect.bottom + offset}px`,
+      left: `${left}px`,
+      width: `${width}px`,
+      maxHeight: `${maxHeight}px`,
+    }
+
+    // 面板渲染后测真实高度，下方不够且上方更大则翻转
+    await nextTick()
+    const h = panelEl.value?.offsetHeight ?? 0
+    const below = window.innerHeight - rect.bottom - margin
+    const above = rect.top - margin
+    if (below < Math.min(h, 240) && above > below) {
+      placement.value = 'top'
+      panelStyle.value = {
+        ...panelStyle.value,
+        top: `${Math.max(margin, rect.top - h - offset)}px`,
+      }
+    }
+  }
+
+  function onScroll(e: Event) {
+    if (panelEl.value && e.target instanceof Node && panelEl.value.contains(e.target)) return
+    close()
+  }
+  function onResize() { close() }
+  function onKeydown(e: KeyboardEvent) {
+    if (e.key !== 'Escape') return
+    close()
+    anchorEl.value?.focus?.()
+  }
+  function onPointerDown(e: PointerEvent) {
+    const t = e.target as Node
+    if (anchorEl.value?.contains(t) || panelEl.value?.contains(t)) return
+    close()
+  }
+
+  function detachListeners() {
+    document.removeEventListener('scroll', onScroll, true)
+    document.removeEventListener('pointerdown', onPointerDown, true)
+    document.removeEventListener('keydown', onKeydown)
+    window.removeEventListener('resize', onResize)
+  }
+
+  watch(isOpen, async (v) => {
+    if (v) {
+      await position()
+      document.addEventListener('scroll', onScroll, true)
+      document.addEventListener('pointerdown', onPointerDown, true)
+      document.addEventListener('keydown', onKeydown)
+      window.addEventListener('resize', onResize)
+    } else {
+      detachListeners()
+    }
+  })
+  onBeforeUnmount(detachListeners)
+
+  function open() { isOpen.value = true }
+  function close() { isOpen.value = false }
+  function toggle() { isOpen.value ? close() : open() }
+
+  return { isOpen, anchorEl, panelEl, panelStyle, placement, open, close, toggle }
+}
diff --git a/huobao-source/frontend/app/composables/useProviderIcon.ts b/huobao-source/frontend/app/composables/useProviderIcon.ts
new file mode 100644
index 0000000..c7f2bd1
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useProviderIcon.ts
@@ -0,0 +1,56 @@
+/**
+ * 厂商图标 — 双主题本地托管（app/public/icons/{light,dark}/，源自 chatfire-gateway）
+ * resolvedTheme 是模块级 computed，模板中调用本函数会随主题切换响应式更新
+ */
+import { resolvedTheme } from '~/composables/useTheme'
+
+const FILENAMES: Record<string, string> = {
+  openai: 'openai.png',
+  gemini: 'gemini-color.png',
+  volcengine: 'volcengine-color.png',
+  minimax: 'minimax-color.png',
+  claude: 'claude-color.png',
+  deepseek: 'deepseek-color.png',
+  doubao: 'doubao-color.png',
+  moonshot: 'kimi-color.png',
+  qwen: 'qwen-color.png',
+  aliyun: 'qwen-color.png',  // 阿里云 Wan 系列与 Qwen 同属阿里，共用图标
+  zhipu: 'zhipu-color.png',
+  xai: 'grok.png',
+  xiaomi: 'xiaomi-color.png',
+  vidu: 'vidu-color.png',
+  ollama: 'ollama.png',
+  midjourney: 'midjourney.png',
+}
+
+/** provider → 当前主题下的图标 URL；未知厂商返回 undefined（调用方回退字母徽标） */
+export function providerIconUrl(provider?: string | null): string | undefined {
+  const file = FILENAMES[(provider || '').toLowerCase()]
+  return file ? `/icons/${resolvedTheme.value}/${file}` : undefined
+}
+
+/**
+ * 模型名 → 厂商推断（按优先级从上到下，命中即返回）。
+ * 场景：配置走 openai 兼容网关（provider=openai）但模型实为 deepseek/gemini 等，
+ * 此时图标应按模型名而非 provider 展示。
+ * 不含 doubao/seedance：它们由 volcengine 服务，provider 图标更准确。
+ */
+const MODEL_PROVIDER_HINTS: [RegExp, string][] = [
+  [/deepseek/i, 'deepseek'],
+  [/claude/i, 'claude'],
+  [/gemini/i, 'gemini'],
+  [/kimi|moonshot/i, 'moonshot'],
+  [/qwen|^wan[\d.-]/i, 'qwen'],
+  [/glm|zhipu|chatglm/i, 'zhipu'],
+  [/grok/i, 'xai'],
+  [/^(gpt|chatgpt|o[1-9])/i, 'openai'],
+]
+
+/** 模型感知的图标：模型名可识别厂商时优先，否则回退 provider */
+export function modelIconUrl(provider?: string | null, model?: string | null): string | undefined {
+  const m = model || ''
+  for (const [re, p] of MODEL_PROVIDER_HINTS) {
+    if (re.test(m)) return providerIconUrl(p)
+  }
+  return providerIconUrl(provider)
+}
diff --git a/huobao-source/frontend/app/composables/useTheme.ts b/huobao-source/frontend/app/composables/useTheme.ts
new file mode 100644
index 0000000..3c0f5fd
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useTheme.ts
@@ -0,0 +1,73 @@
+/**
+ * 主题模式（模块级单例）
+ * - 与 i18n.ts 同构：ssr:false，模块顶层读 localStorage 安全
+ * - 模块顶层同步写 <html data-theme>，先于首帧执行，避免深色/浅色闪烁
+ *   （不能用 app.vue onMounted——首帧之后才执行必闪）
+ * - 跟随系统：matchMedia('(prefers-color-scheme: dark)')，Web/桌面（Electron
+ *   默认 nativeTheme.themeSource='system'）通用，无需桌面桥
+ */
+import { computed, readonly, ref, watch, type ComputedRef } from 'vue'
+
+export const THEME_STORAGE_KEY = 'huobao:theme'
+
+export type ThemeMode = 'light' | 'dark' | 'system'
+export type ResolvedTheme = 'light' | 'dark'
+
+export const THEME_MODES: ThemeMode[] = ['light', 'dark', 'system']
+
+export function readStoredThemeMode(): ThemeMode {
+  try {
+    const v = localStorage.getItem(THEME_STORAGE_KEY)
+    if (v && (THEME_MODES as string[]).includes(v)) return v as ThemeMode
+  } catch { /* localStorage 不可用时回退默认 */ }
+  return 'system'
+}
+
+export function persistThemeMode(mode: ThemeMode) {
+  try {
+    localStorage.setItem(THEME_STORAGE_KEY, mode)
+  } catch { /* 忽略持久化失败 */ }
+}
+
+const themeMode = ref<ThemeMode>(readStoredThemeMode())
+const systemDark = ref(false)
+
+export const resolvedTheme: ComputedRef<ResolvedTheme> = computed(() =>
+  themeMode.value === 'system' ? (systemDark.value ? 'dark' : 'light') : themeMode.value,
+)
+
+function applyTheme() {
+  document.documentElement.dataset.theme = resolvedTheme.value
+}
+
+if (typeof window !== 'undefined') {
+  const mql = window.matchMedia('(prefers-color-scheme: dark)')
+  systemDark.value = mql.matches
+  applyTheme()
+  mql.addEventListener('change', (e) => {
+    systemDark.value = e.matches
+    applyTheme()
+  })
+  watch(themeMode, applyTheme)
+}
+
+/** 切换主题模式并持久化（设置页外观卡片与 ThemeToggle 共用） */
+export function setThemeMode(mode: ThemeMode) {
+  themeMode.value = mode
+  persistThemeMode(mode)
+}
+
+/** light → dark → system 循环（头部快捷按钮用） */
+export function cycleThemeMode() {
+  const i = THEME_MODES.indexOf(themeMode.value)
+  setThemeMode(THEME_MODES[(i + 1) % THEME_MODES.length])
+}
+
+export function useTheme() {
+  return {
+    themeMode: readonly(themeMode),
+    resolvedTheme,
+    setThemeMode,
+    cycleThemeMode,
+  }
+}
diff --git a/huobao-source/frontend/app/composables/useToast.ts b/huobao-source/frontend/app/composables/useToast.ts
new file mode 100644
index 0000000..909d2c8
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useToast.ts
@@ -0,0 +1,66 @@
+/**
+ * 统一错误提示入口 — 把裸技术错误（Failed to fetch / API error 500: {...} /
+ * 上游错误码 / ffmpeg 输出 / SDK 英文原文）映射为用户可读的友好文案。
+ *
+ * - mapError(err, { fallback? }): 返回友好文案（内联展示复用同一函数）
+ * - toastError(err, { fallback?, duration? }): toast.error(mapError(...))，错误统一 5s
+ * - 后端返回的短中文友好 message（如「镜头不存在」）原样透传
+ * - 原始错误不展示，排障走 DevTools（useApi 已 console.error）
+ */
+import { toast } from 'vue-sonner'
+import { i18n } from '~/composables/i18n'
+
+const t = (key: string, params?: Record<string, unknown>) => i18n.global.t(key, params)
+
+/** 内容审核特征（从 episode.vue 的 videoModerationHint 上移，全站复用） */
+export const MODERATION_RE = /sensitive|moderation|真人|人脸|real[\s_-]?person|审核|内容.*(违规|不合规|未通过)|content[\s_-]?policy|risk[\s_-]?control|violation|blocked/i
+
+const NETWORK_RE = /failed to fetch|network ?error|load failed|network request failed|fetch failed/i
+const NONJSON_RE = /unexpected token|not valid json|failed to parse/i
+const SERVER5XX_RE = /(^|\D)5\d{2}(\D|$)|internal server error|服务器内部错误/i
+const AUTH_RE = /(^|\D)40[13](\D|$)|unauthorized|forbidden|invalid[\s_-]?api[\s_-]?key|authentication|鉴权/i
+const RATELIMIT_RE = /(^|\D)429(\D|$)|rate[\s_-]?limit|too many requests|quota|额度不足|insufficient/i
+const TIMEOUT_RE = /timeout|timed out|polling exceeded|超时/i
+/** 技术特征：出现即判定不可直接透传给用户 */
+const TECHY_RE = /[{}\[\]<>]|https?:\/\/|\b(error|errno|exception|code|stack|undefined|null)\b|[a-z]+_[a-z]+/i
+const CJK_RE = /[一-鿿]/
+
+function messageOf(err: unknown): string {
+  if (err == null) return ''
+  if (typeof err === 'string') return err
+  if (err instanceof Error) return err.message || String(err)
+  const anyErr = err as { message?: unknown; error_msg?: unknown; errorMsg?: unknown }
+  return String(anyErr.message ?? anyErr.error_msg ?? anyErr.errorMsg ?? err)
+}
+
+/**
+ * 错误 → 友好文案。分类按优先级短路：
+ * 网络 → 非JSON → 审核 → 鉴权 → 限频 → 5xx → 超时 → 短中文透传 → 状态码 → 兜底
+ */
+export function mapError(err: unknown, opts?: { fallback?: string }): string {
+  const msg = messageOf(err).trim()
+  if (!msg) return opts?.fallback ? t(opts.fallback) : t('errors.unknown')
+
+  if (NETWORK_RE.test(msg)) return t('errors.network')
+  if (err instanceof SyntaxError || NONJSON_RE.test(msg)) return t('errors.server')
+  if (MODERATION_RE.test(msg)) return t('errors.moderation')
+  if (AUTH_RE.test(msg)) return t('errors.auth')
+  if (RATELIMIT_RE.test(msg)) return t('errors.rateLimit')
+  // Known local worker condition: preserve the actionable GPU/port hint without
+  // exposing arbitrary upstream JSON, URLs or credentials in the task list.
+  if (/GPU1\s*\/\s*8189 暂不可用：旧 GPU1 任务或显存尚未释放/.test(msg)) return t('errors.gpu1Busy')
+  if (SERVER5XX_RE.test(msg)) return t('errors.unavailable')
+  if (TIMEOUT_RE.test(msg)) return t('errors.timeout')
+
+  // 后端友好中文（短、含中文、无技术特征）直接透传
+  if (msg.length <= 40 && CJK_RE.test(msg) && !TECHY_RE.test(msg)) return msg
+
+  if (/^\d{3}$/.test(msg)) return t('errors.requestFailed', { status: msg })
+
+  return opts?.fallback ? t(opts.fallback) : t('errors.unknown')
+}
+
+/** 统一错误 toast（默认 5s，比成功提示长） */
+export function toastError(err: unknown, opts?: { fallback?: string; duration?: number }): void {
+  toast.error(mapError(err, opts), { duration: opts?.duration ?? 5000 })
+}
diff --git a/huobao-source/frontend/app/composables/useTour.ts b/huobao-source/frontend/app/composables/useTour.ts
new file mode 100644
index 0000000..d63a425
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useTour.ts
@@ -0,0 +1,114 @@
+/**
+ * 应用内引导漫游（driver.js）— 轻量方案
+ *
+ * - 各页面定义步骤（selector + i18n 文案 key），经 startTour() 启动
+ * - 「看过」标记存服务端 app_settings（tours_seen）：桌面端每次启动端口随机，
+ *   localStorage 随 origin 失效，故落库；localStorage 仅作离线兜底缓存
+ * - 首次自动弹、帮助按钮随时重看；跳过/完成都算看过
+ * - 主题样式沿用设计 token（火焰橙 accent），见 app.vue 内 .driver-theme 覆写
+ */
+import { driver } from 'driver.js'
+import 'driver.js/dist/driver.css'
+
+const SEEN_KEY = 'huobao:tours'
+
+let seenSet = new Set<string>()
+let hydrated = false
+let hydratePromise: Promise<void> | null = null
+
+function readLocal(): string[] {
+  try { return JSON.parse(localStorage.getItem(SEEN_KEY) || '[]') } catch { return [] }
+}
+
+function writeLocal(ids: string[]) {
+  try { localStorage.setItem(SEEN_KEY, JSON.stringify(ids)) } catch { /* ignore */ }
+}
+
+/**
+ * 从服务端拉取已看过的 tour id，与本地缓存取并集（保留升级前 localStorage 里的标记）。
+ * 由客户端插件在应用启动时调用；autoTour 在 onMounted 后延迟数百 ms 触发，此时已就绪。
+ */
+export function hydrateTours(): Promise<void> {
+  if (hydratePromise) return hydratePromise
+  hydratePromise = (async () => {
+    try {
+      const res = await fetch('/api/v1/settings/tours-seen')
+      const json = await res.json().catch(() => null)
+      const server: string[] = Array.isArray(json?.data?.seen) ? json.data.seen : []
+      seenSet = new Set([...server, ...readLocal()])
+    } catch {
+      seenSet = new Set(readLocal())
+    }
+    hydrated = true
+    writeLocal([...seenSet])
+  })()
+  return hydratePromise
+}
+
+export function tourSeen(id: string): boolean {
+  return seenSet.has(id) || readLocal().includes(id)
+}
+
+export function markTourSeen(id: string) {
+  if (seenSet.has(id)) return
+  seenSet.add(id)
+  writeLocal([...seenSet])
+  // 落库（fire-and-forget）；未水合时先合并服务端数据避免覆盖其他页面已标记的 tour
+  void (async () => {
+    try {
+      if (!hydrated) await hydrateTours()
+      seenSet.add(id)
+      await fetch('/api/v1/settings/tours-seen', {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ seen: [...seenSet] }),
+      })
+    } catch { /* 服务端不可达时 localStorage 已兜底 */ }
+  })()
+}
+
+export interface TourStep {
+  element: string            // CSS selector；'#__nuxt' 等兜底表示居中弹窗（无高亮）
+  titleKey: string           // i18n key
+  descKey: string            // i18n key
+  popoverSide?: 'top' | 'bottom' | 'left' | 'right'
+  popoverAlign?: 'start' | 'center' | 'end'
+}
+
+/**
+ * 启动一段引导。t 为 useI18n 的翻译函数。
+ * 返回是否真正启动（元素缺失或步骤为空时静默跳过）。
+ */
+export function startTour(id: string, steps: TourStep[], t: (key: string) => string): boolean {
+  const usable = steps.filter(s => s.element === '#__nuxt' || document.querySelector(s.element))
+  if (!usable.length) return false
+
+  const drv = driver({
+    showProgress: true,
+    allowClose: true,
+    overlayClickBehavior: 'nextStep',
+    popoverClass: 'huobao-tour-popover',
+    progressText: '{{current}} / {{total}}',
+    nextBtnText: t('tour.next'),
+    prevBtnText: t('tour.prev'),
+    doneBtnText: t('tour.done'),
+    onDestroyed: () => markTourSeen(id),
+    steps: usable.map(s => ({
+      element: s.element,
+      popover: {
+        title: t(s.titleKey),
+        description: t(s.descKey),
+        side: s.popoverSide || 'bottom',
+        align: s.popoverAlign || 'start',
+      },
+    })),
+  })
+  drv.drive()
+  return true
+}
+
+/** 首次进入自动引导：看过或元素未就绪则跳过 */
+export function autoTour(id: string, steps: TourStep[], t: (key: string) => string) {
+  if (tourSeen(id)) return
+  startTour(id, steps, t)
+}
diff --git a/huobao-source/frontend/app/composables/useUnifiedLanguage.ts b/huobao-source/frontend/app/composables/useUnifiedLanguage.ts
new file mode 100644
index 0000000..db75ac9
--- /dev/null
+++ b/huobao-source/frontend/app/composables/useUnifiedLanguage.ts
@@ -0,0 +1,74 @@
+/**
+ * 统一语言切换：UI 语言 = AI 内容语言，同一个开关。
+ *
+ * 两处入口（顶栏 LocaleSwitcher / 设置页通用 tab）都走 confirmUnifiedLanguage：
+ * 1. 弹独立确认弹窗（挂 body，说明影响：界面 + AI 内容 + 刷新）
+ * 2. 确认后：写后端 content_language → 切 vue-i18n locale → 短暂提示 → location.reload()
+ *    （整页重载让所有组件干净重建，避免深嵌组件依赖 watch 的时序问题）
+ */
+import { createApp, h, ref } from 'vue'
+import { i18n, setUiLocale, type UiLocale } from '~/composables/i18n'
+import { settingsAPI } from '~/composables/useApi'
+import LanguageSwitchDialog from '~/components/LanguageSwitchDialog.vue'
+
+let pending: { resolve: (ok: boolean) => void } | null = null
+
+/** 弹确认框；resolve(true) = 用户确认切换 */
+function confirmDialog(lang: UiLocale): Promise<boolean> {
+  return new Promise((resolve) => {
+    const langNameKeys = { zh: 'langNameZh', en: 'langNameEn', ja: 'langNameJa', ko: 'langNameKo' }
+    const nameKey = `settings.general.${langNameKeys[lang] || 'langNameZh'}`
+    const title = i18n.global.t('components.langSwitch.title', { lang: i18n.global.t(nameKey) })
+    const message = i18n.global.t('components.langSwitch.message')
+
+    const open = ref(true)
+    const host = document.createElement('div')
+    document.body.appendChild(host)
+    const app = createApp({
+      setup: () => () => h(LanguageSwitchDialog, {
+        open: open.value,
+        title,
+        message,
+        onConfirm: () => { open.value = false },
+        onCancel: () => { open.value = false },
+      }),
+    })
+    app.use(i18n as unknown as Parameters<typeof app.use>[0])
+    app.mount(host)
+
+    pending = {
+      resolve: (ok) => {
+        app.unmount()
+        host.remove()
+        resolve(ok)
+      },
+    }
+    // open 置 false 后由 watch 关闭并 resolve —— 用简单轮询代替（弹窗体积小，不值得引 watch 复杂度）
+    const timer = setInterval(() => {
+      if (!open.value) {
+        clearInterval(timer)
+        pending?.resolve(true)
+        pending = null
+      }
+    }, 80)
+  })
+}
+
+let switching = false
+
+/** 入口：先弹确认框，确认后执行统一切换并刷新 */
+export async function confirmUnifiedLanguage(lang: UiLocale) {
+  if (switching) return
+  const ok = await confirmDialog(lang)
+  if (!ok) return
+  switching = true
+  try {
+    await settingsAPI.setContentLanguage(lang)
+  } catch { /* 后端失败不阻断界面切换 */ }
+  setUiLocale(lang)
+  try {
+    const { toast } = await import('vue-sonner')
+    toast.info(i18n.global.t('components.langSwitch.refreshing'), { duration: 1200 })
+  } catch { /* 提示失败不阻断 */ }
+  setTimeout(() => location.reload(), 1000)
+}
diff --git a/huobao-source/frontend/app/layouts/default.vue b/huobao-source/frontend/app/layouts/default.vue
new file mode 100644
index 0000000..2b125e4
--- /dev/null
+++ b/huobao-source/frontend/app/layouts/default.vue
@@ -0,0 +1,233 @@
+<template>
+  <div class="shell">
+    <!-- Header -->
+    <header class="header">
+      <div class="header-left">
+        <button class="brand" @click="navigateTo('/')">
+          <div class="brand-mark">
+            <img v-if="showBrandImage" :src="brandLogo" alt="火宝短剧" class="brand-logo" @error="showBrandImage = false" />
+            <span v-else class="brand-fallback">火</span>
+          </div>
+          <div class="brand-text">
+            <span class="brand-name">火宝短剧</span>
+            <span class="brand-sub">Huobao Shorts</span>
+          </div>
+        </button>
+      </div>
+
+      <nav class="header-nav">
+        <NuxtLink to="/" class="nav-link" :class="{ active: route.path === '/' }">
+          <LayoutGrid :size="15" :stroke-width="1.8" />
+          <span>{{ t('layout.nav.projects') }}</span>
+        </NuxtLink>
+        <NuxtLink to="/settings" class="nav-link" :class="{ active: route.path === '/settings' }">
+          <Settings :size="15" :stroke-width="1.8" />
+          <span>{{ t('layout.nav.settings') }}</span>
+        </NuxtLink>
+      </nav>
+
+      <div class="header-right">
+        <a
+          class="github-link"
+          href="https://github.com/chatfire-AI/huobao-drama"
+          target="_blank"
+          rel="noopener"
+          aria-label="GitHub"
+          title="GitHub"
+        >
+          <Github :size="15" :stroke-width="1.8" />
+        </a>
+        <ThemeToggle />
+        <LocaleSwitcher />
+      </div>
+    </header>
+
+    <!-- AI 服务未配置引导横幅(缺任一类型即提示) -->
+    <div v-if="missingConfigLabels.length" class="config-banner">
+      <TriangleAlert :size="14" :stroke-width="1.8" />
+      <span>{{ t('layout.banner.missing', { types: missingConfigLabels.join(t('common.listJoin')) }) }}</span>
+      <NuxtLink to="/settings" class="config-banner-link">{{ t('layout.banner.goSettings') }}</NuxtLink>
+    </div>
+
+    <main class="content">
+      <slot />
+    </main>
+  </div>
+</template>
+
+<script setup>
+import { LayoutGrid, Settings, TriangleAlert, Github } from 'lucide-vue-next'
+import { useI18n } from 'vue-i18n'
+import { aiConfigAPI } from '~/composables/useApi'
+import brandLogo from '~/assets/brand-logo.png'
+
+const { t, locale } = useI18n()
+const route = useRoute()
+const showBrandImage = ref(true)
+
+// 渲染时求值，语言切换即时生效（不能模块级常量固化）
+const SERVICE_TYPE_LABELS = computed(() => ({
+  text: t('common.serviceType.text'),
+  image: t('common.serviceType.image'),
+  video: t('common.serviceType.video'),
+}))
+const missingConfigLabels = ref([])
+
+async function checkAiConfigs() {
+  try {
+    const configs = await aiConfigAPI.list()
+    const labels = SERVICE_TYPE_LABELS.value
+    missingConfigLabels.value = Object.entries(labels)
+      .filter(([type]) => !configs.some(c => c.service_type === type && c.is_active))
+      .map(([, label]) => label)
+  } catch { /* 配置检查失败不阻塞页面 */ }
+}
+
+onMounted(checkAiConfigs)
+// 设置页保存配置后返回时重新检查(布局跨页面复用,onMounted 只触发一次)
+watch(() => route.path, checkAiConfigs)
+// 切换界面语言时横幅中已拼接的类型文案需要重算
+watch(locale, checkAiConfigs)
+</script>
+
+<style scoped>
+.shell {
+  display: flex; flex-direction: column;
+  height: 100vh; overflow: hidden;
+  background: var(--bg-base);
+}
+
+/* === Header === */
+.header {
+  display: flex; align-items: center;
+  height: 60px; flex-shrink: 0;
+  padding: 0 24px;
+  gap: 32px;
+  background: var(--header-bg);
+  backdrop-filter: blur(20px) saturate(180%);
+  -webkit-backdrop-filter: blur(20px) saturate(180%);
+  border-bottom: 1px solid var(--border);
+  position: relative; z-index: 10;
+}
+
+.header-left { display: flex; align-items: center; }
+
+.brand {
+  display: flex; align-items: center; gap: 11px;
+  background: transparent; border: none; cursor: pointer; padding: 4px 8px 4px 4px;
+  text-decoration: none; border-radius: var(--radius);
+  transition: background 0.18s var(--ease-out);
+}
+.brand:hover { background: var(--bg-hover); }
+.brand:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+.brand-mark {
+  width: 32px; height: 32px;
+  display: flex; align-items: center; justify-content: center;
+  border-radius: 9px;
+  overflow: hidden;
+}
+.brand-logo {
+  width: 28px;
+  height: 28px;
+  object-fit: contain;
+  display: block;
+}
+.brand-fallback {
+  font-size: 15px;
+  font-weight: 700;
+  color: var(--text-0);
+  line-height: 1;
+}
+.brand-text { display: flex; flex-direction: column; align-items: flex-start; line-height: 1.15; }
+.brand-name {
+  font-size: 15px; font-weight: 700;
+  /* ChatFire 签名：品牌字标火焰橙渐变 */
+  background: var(--accent-gradient);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+  letter-spacing: -0.01em;
+}
+.brand-sub {
+  font-size: 10px; font-weight: 400;
+  color: var(--text-3); margin-top: 1px;
+  letter-spacing: 0.04em;
+}
+
+/* Nav — pill segmented group */
+.header-nav {
+  display: flex; gap: 2px;
+  padding: 3px;
+  border-radius: var(--radius-pill);
+  background: var(--overlay-track);
+}
+
+/* Header 右侧 — 语言切换器 */
+.header-right {
+  margin-left: auto;
+  display: flex; align-items: center;
+}
+/* GitHub 入口 — 与 ThemeToggle 同款圆形图标按钮 */
+.github-link {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  border-radius: var(--radius-pill);
+  color: var(--text-2);
+  transition: all 0.18s var(--ease-out);
+  line-height: 1;
+}
+.github-link:hover { color: var(--text-0); background: var(--bg-hover); }
+.github-link:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+.nav-link {
+  display: flex; align-items: center; gap: 6px;
+  min-height: 32px;
+  padding: 0 16px; border-radius: var(--radius-pill);
+  font-size: 13px; font-weight: 600;
+  color: var(--text-2); text-decoration: none;
+  transition: all 0.18s var(--ease-out);
+  border: none;
+  line-height: 1;
+}
+.nav-link:hover { color: var(--text-0); }
+.nav-link.active {
+  background: var(--seg-active-bg);
+  color: var(--text-0);
+  box-shadow: 0 1px 4px rgba(0,0,0,0.1);
+}
+.nav-link:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+
+/* Config banner — AI 服务未配置引导 */
+.config-banner {
+  display: flex; align-items: center; gap: 8px;
+  padding: 8px 24px; flex-shrink: 0;
+  font-size: 12.5px; color: var(--warn-text);
+  background: var(--warn-bg);
+  border-bottom: 1px solid var(--warn-border);
+  position: relative; z-index: 9;
+}
+.config-banner-link {
+  margin-left: auto;
+  font-size: 12.5px; font-weight: 600;
+  color: var(--warn-link); text-decoration: none;
+  padding: 2px 10px; border-radius: var(--radius-pill);
+  border: 1px solid var(--warn-border);
+  transition: all 0.18s var(--ease-out);
+  line-height: 1.6;
+}
+.config-banner-link:hover { background: var(--warn-link-hover-bg); color: var(--warn-text); }
+
+/* Content */
+.content { flex: 1; overflow: hidden; display: flex; flex-direction: column; }
+</style>
diff --git a/huobao-source/frontend/app/layouts/studio.vue b/huobao-source/frontend/app/layouts/studio.vue
new file mode 100644
index 0000000..6bd67b9
--- /dev/null
+++ b/huobao-source/frontend/app/layouts/studio.vue
@@ -0,0 +1,9 @@
+<template>
+  <div class="studio-fullscreen">
+    <slot />
+  </div>
+</template>
+
+<style scoped>
+.studio-fullscreen { height: 100vh; display: flex; flex-direction: column; overflow: hidden; background: var(--bg-base); }
+</style>
diff --git a/huobao-source/frontend/app/locales/en.json b/huobao-source/frontend/app/locales/en.json
new file mode 100644
index 0000000..dfa98cd
--- /dev/null
+++ b/huobao-source/frontend/app/locales/en.json
@@ -0,0 +1,989 @@
+{
+  "taskTracking": {
+    "queued": "Queued",
+    "running": "Generating",
+    "checking": "Checking",
+    "reconnecting": "Reconnecting",
+    "missing": "Needs review",
+    "restoreImage": "Recover image"
+  },
+  "assetReferences": {
+    "title": "Image references",
+    "add": "Add references",
+    "saving": "Saving",
+    "preview": "Preview reference {n}",
+    "remove": "Remove reference {n}",
+    "used": "Used in this order when generating or redrawing.",
+    "empty": "Add identity, outfit or style references for generation.",
+    "formats": "JPG / PNG / WebP · Up to 20 MB each · 6 images max",
+    "limit": "Up to 6 references per asset",
+    "invalid": "Choose valid JPG, PNG or WebP files, up to 20 MB each",
+    "saved": "References saved for generation and redraws",
+    "removed": "Reference removed",
+    "wait": "References are saving. Please wait before generating."
+  },
+  "app": {
+    "title": "Huobao Shorts",
+    "updateAvailable": "New version v{version} is available. Upgrade in Settings → About."
+  },
+  "characterVoice": {
+    "title": "Character voice",
+    "forCharacter": "Voice for {name}",
+    "upload": "Upload voice",
+    "replace": "Replace voice",
+    "remove": "Remove",
+    "saving": "Saving…",
+    "empty": "Upload a clear voice recording as this character’s voice sample.",
+    "formats": "MP3 / WAV / M4A / AAC · Up to 20MB",
+    "sample": "Voice sample",
+    "preview": "Preview voice for {name}",
+    "saved": "Character voice saved",
+    "removed": "Character voice removed",
+    "invalidFormat": "Choose an MP3, WAV, M4A or AAC audio file",
+    "tooLarge": "Audio must be no larger than 20MB",
+    "emptyFile": "The audio file is empty",
+    "playbackError": "Unable to play this audio. Check the file or upload it again.",
+    "referenceHint": "Use {'@'}Name for appearance and #Name at each spoken line, e.g. {'@'}Alex looks up; #Alex softly says hello. Use 2–5 second voice samples, up to 15 seconds total.",
+    "noMatch": "No matching voice. Upload a character voice in Assets and add the character to this shot."
+  },
+  "common": {
+    "confirm": "Confirm",
+    "cancel": "Cancel",
+    "back": "Back",
+    "saved": "Saved",
+    "delete": "Delete",
+    "deleteLoading": "Deleting...",
+    "deleteFailed": "Delete failed",
+    "save": "Save",
+    "close": "Close",
+    "refresh": "Refresh",
+    "add": "Add",
+    "copy": "Copy",
+    "download": "Download",
+    "default": "Default",
+    "more": "More",
+    "loading": "Loading…",
+    "listJoin": ", ",
+    "role": "Character",
+    "scene": "Scene",
+    "prop": "Prop",
+    "reference": "Reference",
+    "serviceType": {
+      "text": "Text",
+      "image": "Image",
+      "video": "Video"
+    }
+  },
+  "layout": {
+    "nav": {
+      "projects": "Projects",
+      "settings": "Settings"
+    },
+    "banner": {
+      "missing": "{types} model not configured yet. AI features are unavailable.",
+      "goSettings": "Go to Settings"
+    },
+    "theme": {
+      "label": "Toggle theme",
+      "light": "Light mode",
+      "dark": "Dark mode",
+      "system": "Follow system"
+    }
+  },
+  "migrate": {
+    "title": "Switching storage location",
+    "hint": "Do not close the app during migration",
+    "phases": {
+      "validating": "Validating target directory…",
+      "stopping": "Stopping background services…",
+      "moving": "Migrating data files…",
+      "movingProgress": "Migrating data files… {copied} / {total}",
+      "config": "Updating storage config…",
+      "restarting": "Restarting background services…",
+      "done": "Migration complete",
+      "error": "Migration failed"
+    }
+  },
+  "components": {
+    "mention": {
+      "noMatch": "No matching references",
+      "fallbackGroup": "Reference"
+    },
+    "baseSelect": {
+      "placeholder": "Please select...",
+      "search": "Search...",
+      "noMatch": "No matches"
+    },
+    "confirmDialog": {
+      "title": "Confirm delete"
+    },
+    "localeSwitcher": {
+      "label": "Switch UI language"
+    },
+    "langSwitch": {
+      "title": "Switch language to {lang}?",
+      "message": "The UI language and AI content language will switch together.",
+      "effectUi": "All interface texts switch to this language",
+      "effectAi": "AI output (script rewriting, asset extraction, storyboard, prompts) uses this language, with matching agent prompts/skills",
+      "effectRefresh": "The page refreshes automatically after confirming",
+      "confirm": "Switch & Refresh",
+      "refreshing": "Language switched, refreshing…"
+    }
+  },
+  "composables": {
+    "agent": {
+      "busy": "Operation in progress",
+      "done": "Done"
+    }
+  },
+  "index": {
+    "hero": {
+      "title": "Project Launcher",
+      "sub": "From an idea to a short drama — AI does the whole pipeline for you",
+      "projectCount": "{n} projects",
+      "activeCount": "{n} active",
+      "styleCount": "{n} visual styles"
+    },
+    "create": "New Project",
+    "searchPlaceholder": "Search projects",
+    "sortAria": "Sort projects",
+    "sortUpdated": "Recently updated",
+    "sortTitle": "Project name",
+    "statusBadgeTitle": "Click to set project status",
+    "openProjectAria": "Open project {title}",
+    "openProject": "Open project",
+    "deleteProject": "Delete project",
+    "projectMeta": "{chars} characters · {scenes} scenes · {eps} episodes",
+    "emptyFilteredTitle": "No matching projects",
+    "emptyFilteredDesc": "Adjust the search term or filters.",
+    "emptyTitle": "Create your first drama project",
+    "emptyDesc": "Pick an episode to start producing after creation.",
+    "deleted": "Deleted",
+    "noEpisodes": "No episodes yet",
+    "episodeN": "Episode {n}",
+    "ratio": {
+      "landscape": "16:9 · Landscape",
+      "portrait": "9:16 · Portrait",
+      "square": "1:1 · Square",
+      "adaptive": "Adaptive"
+    },
+    "status": {
+      "all": "All",
+      "draft": "Not started",
+      "active": "In progress",
+      "completed": "Completed"
+    },
+    "createDialog": {
+      "title": "New Project",
+      "desc": "Pick an episode on the project page after creation",
+      "name": "Project name",
+      "namePlaceholder": "e.g. Urban romance drama “The Time Post Office”",
+      "style": "Visual style",
+      "stylePlaceholder": "Select a style",
+      "aspectRatio": "Aspect ratio",
+      "aspectRatioPlaceholder": "Select aspect ratio",
+      "aspectRatioHint": "Fixed after creation; all videos will use this ratio",
+      "submit": "Create project"
+    },
+    "deleteDialog": {
+      "title": "Delete project",
+      "message": "Delete “{title}”? Episodes, storyboards and generation records will be removed. This cannot be undone."
+    },
+    "time": {
+      "justNow": "Just now",
+      "minutesAgo": "{n} min ago",
+      "hoursAgo": "{n} h ago",
+      "daysAgo": "{n} d ago"
+    }
+  },
+  "detail": {
+    "head": {
+      "charCount": "{n} characters",
+      "sceneCount": "{n} scenes",
+      "epCount": "{n} episodes",
+      "addEpisode": "Add Episode"
+    },
+    "tabs": {
+      "episodes": "Episodes",
+      "assets": "Asset Library"
+    },
+    "ep": {
+      "statusTitle": "Click to set episode status",
+      "resTitle": "Click to change video resolution",
+      "deleteTitle": "Delete this episode",
+      "enter": "Open Studio",
+      "scriptReady": "Script ready",
+      "merged": "Merged",
+      "emptyCreateTitle": "Click to create the first episode",
+      "emptyCreateText": "Click to create the first episode",
+      "addNextTitle": "Add Episode {n}",
+      "addNextText": "Add Episode {n}",
+      "episodeN": "Episode {n}",
+      "res720": "720p · HD",
+      "res480": "480p · Smooth",
+      "resSwitched": "Video resolution switched to {res}"
+    },
+    "epCreate": {
+      "title": "Create Episode",
+      "titleField": "Title",
+      "titlePlaceholder": "Auto-named by episode number",
+      "titleHint": "If left blank, it will be named automatically, e.g. “{example}”.",
+      "example": "Episode {n}",
+      "resolution": "Video resolution",
+      "resolutionPlaceholder": "Select resolution",
+      "resolutionHint": "Videos of this episode are generated at this resolution; you can still change it on the episode card later.",
+      "lockCopy": "The currently active image and video generation capabilities will be locked on creation.",
+      "creating": "Creating...",
+      "create": "Create",
+      "added": "Episode added"
+    },
+    "epDelete": {
+      "message": "Delete “{title}”? It will be hidden from the list and its storyboards and generation records will no longer be accessible."
+    },
+    "assets": {
+      "emptyTitle": "No assets yet",
+      "emptyDesc": "Characters, scenes and props extracted in the production workbench will appear here, and you can generate images for them directly.",
+      "emptyKindTitle": "No {kind} assets yet",
+      "emptyKindDesc": "They will appear here after extraction and generation in the workbench.",
+      "todoShort": "TBD"
+    },
+    "mat": {
+      "dialogAria": "Asset detail",
+      "unnamed": "Unnamed",
+      "propTypePlaceholder": "e.g. weapon / keepsake",
+      "personaField": "Character persona",
+      "personaPlaceholder": "Personality, background, motivation…",
+      "locationPlaceholder": "e.g. Hall of Supreme Harmony",
+      "timePlaceholder": "e.g. dusk / midnight",
+      "finalPromptLabel": "Final prompt",
+      "finalPromptSub": "Generated by AI from the info; editable before saving",
+      "genPromptTitle": "Generate final prompt with AI",
+      "needEpisodeFirst": "Create at least one episode in “Episodes” first",
+      "promptPlaceholder": "Click “Generate prompt” for AI to create from the info, or type it manually. Once saved manually, the next image generation will use this prompt.",
+      "genImage": "Generate image",
+      "saving": "Saving…",
+      "generating": "{kind} “{name}” image generating",
+      "genTimeout": "{kind} “{name}” generation timed out; refresh later to check",
+      "uploaded": "{kind} “{name}” image uploaded",
+      "needEpisodeForImage": "Create at least one episode in “Episodes” before generating asset images",
+      "needEpisodeForPrompt": "Create at least one episode in “Episodes” before generating the final prompt",
+      "locationRequired": "Please enter a location"
+    }
+  },
+  "settings": {
+    "groupBase": "Basic",
+    "tabs": {
+      "general": "General",
+      "ai": "AI Services",
+      "styles": "Style Presets",
+      "storage": "Storage",
+      "about": "About & Updates",
+      "agents": "Agent Config"
+    },
+    "common": {
+      "disabled": "Disabled",
+      "custom": "Custom",
+      "empty": "No configs yet"
+    },
+    "general": {
+      "title": "General",
+      "desc": "App-level settings. Language switching applies to both the UI and AI-generated content.",
+      "contentLanguage": "AI Content Language",
+      "contentLanguageSub": "Language used by both the UI and AI output (script/assets/storyboard/prompts)",
+      "languageLabel": "Language",
+      "languageNote": "Switching updates UI and AI content language together, with an automatic refresh",
+      "languageHint": "Both entry points (top-bar button / here) are equivalent and apply globally.",
+      "languageSaved": "Content language saved",
+      "appearance": "Appearance",
+      "appearanceSub": "Interface color theme, applied instantly",
+      "appearanceLabel": "Theme mode",
+      "appearanceNote": "In System mode, follows your OS appearance automatically",
+      "appearanceLight": "Light",
+      "appearanceDark": "Dark",
+      "appearanceSystem": "System",
+      "languageSavedWith": "AI content language switched to {lang} — future generations (script/assets/storyboard/prompts) will use it",
+      "langNameZh": "Chinese",
+      "langNameEn": "English",
+      "langNameJa": "Japanese",
+      "langNameKo": "Korean",
+      "unifiedSwitchWarning": "Switched to {lang} — UI and AI content language update together. Refreshing…"
+    },
+    "ai": {
+      "title": "AI Service Configs",
+      "desc": "Start with a recommended template, then fine-tune per service type. The workbench locks the chosen image and video capabilities when creating an episode.",
+      "quickTitle": "Huobao Quick Config",
+      "recommended": "Recommended",
+      "quickDesc": "Enter a Huobao API Key to write three recommended configs (text, image, video) at once.",
+      "getKey": "Get a Huobao API key",
+      "regionCn": "China",
+      "regionCom": "Global",
+      "applyQuick": "Apply Huobao Config",
+      "manualTitle": "Manual Templates",
+      "manualDesc": "Pick a service type, then fill the recommended `provider / base URL / model` from a template.",
+      "activeCount": "{n} active",
+      "hasKey": "Configured",
+      "noKey": "No key",
+      "currentDefault": "Current default model",
+      "setDefault": "Set as default model for this type",
+      "noBaseUrl": "Base URL not set",
+      "test": "Test",
+      "apiKeyRequired": "Please enter a Huobao API Key",
+      "quickApplied": "Huobao quick config written",
+      "defaultModelSwitched": "Default {type} model switched to {model}",
+      "meta": {
+        "text": "Text capabilities: script rewriting, asset extraction, storyboard breaking",
+        "image": "Static image generation: characters, scenes and shots",
+        "video": "Direct video generation, Seedance 2.0 by default"
+      }
+    },
+    "styles": {
+      "title": "Style Presets",
+      "desc": "The visual style chosen at project creation. Its English prompt fragment is injected into character and scene image generation. Disabled styles are hidden from creation options.",
+      "allTitle": "All Styles",
+      "count": "{active} active · {total} total",
+      "empty": "No style presets"
+    },
+    "storage": {
+      "title": "Storage Location",
+      "desc": "The directory holding the database and generated files (images/videos/merges/uploads). Changing it briefly stops background services and migrates data.",
+      "currentDir": "Current Data Directory",
+      "computedAt": "Computed at {time}",
+      "changeLocation": "Change Location",
+      "dataDir": "Data directory",
+      "desktopMode": "Desktop",
+      "serverMode": "Server",
+      "totalUsage": "Total usage {size}",
+      "counting": "Counting…",
+      "breakdown": {
+        "db": "Database",
+        "images": "Images",
+        "videos": "Videos",
+        "merged": "Merged",
+        "uploads": "Uploads",
+        "temp": "Temp",
+        "other": "Other"
+      },
+      "diskFree": "Disk free {size}",
+      "note": "The data directory holds the SQLite database and all generated media; Agent skills (workspace) are not included and do not migrate.",
+      "serverNote": "For server deployments, configure storage via STORAGE_PATH / SQLITE_PATH environment variables; restart to apply.",
+      "loadFailed": "Failed to load storage info"
+    },
+    "about": {
+      "title": "About & Updates",
+      "desc": "Pulls new versions from the release manifest, verifies sha256 locally, then swaps the package and restarts. User data and configs live in the system data directory and are unaffected by updates.",
+      "currentVersion": "Current version v{v}",
+      "latestVersion": "Latest version v{v}",
+      "check": "Check for Updates",
+      "webMode": "You are in browser/server mode; in-app updates are only available on desktop.",
+      "upToDate": "You're up to date",
+      "found": "New version v{v} available",
+      "downloading": "Downloading {p}%",
+      "download": "Download Update",
+      "ready": "Update package ready",
+      "readyDesc": "The app will quit, install automatically, and reopen.",
+      "restartInstall": "Restart & Install",
+      "checkFailed": "Check failed",
+      "retry": "Retry",
+      "empty": "Click “Check for Updates” to fetch the latest version.",
+      "note": "Note: on macOS the update is applied via directory swap (same approach as Tauri), no Apple signing required; on Windows the installer runs silently.",
+      "checkFailedToast": "Update check failed",
+      "downloadDone": "Update package downloaded, ready to install",
+      "downloadFailed": "Download failed",
+      "installFailed": "Install failed",
+      "serverApply": "Update now",
+      "serverApplyStarted": "Update triggered: Watchtower will pull the new image and recreate the container. Refresh in a few minutes.",
+      "serverApplyFailed": "Failed to trigger update",
+      "serverManualHint": "Server deployment: run this in the deploy directory:",
+      "serverNote": "Note: with Watchtower configured, Docker deployments can update in one click (pulls the new image and recreates the container); otherwise run the command shown above manually."
+    },
+    "agents": {
+      "promptHint": "saved as {file}",
+      "promptPlaceholder": "Agent system prompt...",
+      "reset": "Reset to default",
+      "promptReset": "Default prompt restored (prompt file deleted)",
+      "saved": "{agent} config saved",
+      "scriptRewriter": "Script Rewriter",
+      "extractor": "Asset Extractor",
+      "storyboardBreaker": "Storyboard Breaker",
+      "promptGenerator": "Prompt Generator",
+      "langFallback": "Falls back to Chinese",
+      "followContentLang": "Editing language: {lang} (switch in General → AI Content Language)"
+    },
+    "skills": {
+      "agentList": "Agents",
+      "desc": "Skills act as an advanced prompt layer for Agents and do not affect the regular workbench entry points.",
+      "add": "Add Skill",
+      "emptyTitle": "No skills yet",
+      "emptyDesc": "Click “Add Skill” in the top-right to create the first prompt file",
+      "contentPlaceholder": "Write the SKILL.md content...",
+      "addTitle": "Add Skill — {agent}",
+      "dirName": "Skill directory name",
+      "dirNameHint": "English, unique",
+      "dirNamePlaceholder": "e.g. custom-extraction",
+      "name": "Name",
+      "namePlaceholder": "e.g. Custom extraction rules",
+      "description": "Description",
+      "descPlaceholder": "A short description of this skill",
+      "create": "Create",
+      "created": "Skill created"
+    },
+    "cfg": {
+      "editTitle": "Edit Service Config",
+      "addTitle": "Add {type} Service",
+      "sub": "Pick a template first — a sensible `Base URL` and default models will be filled in automatically.",
+      "name": "Config name",
+      "namePlaceholder": "e.g. Huobao default image service",
+      "provider": "Provider",
+      "providerPlaceholder": "Select a provider",
+      "priority": "Priority",
+      "priorityHint": "Higher wins. The workbench prefers the highest-priority active config of the same type.",
+      "models": "Models",
+      "modelsHint": "First entry is the default model; click a tag to pin it to the top. Paste comma/newline-separated names to add in bulk",
+      "modelPlaceholder": "Type a model name, press Enter to add",
+      "modelChipHint": "Click to set as default (pin to top)",
+      "tempHint": "blank = provider default",
+      "tempPlaceholder": "e.g. 0.6",
+      "tempNote": "Some models enforce a fixed temperature (e.g. kimi-k2 only allows 0.6). If you get an invalid temperature error, set the value here.",
+      "test": "Test Config",
+      "reachable": "Endpoint responded",
+      "unreachable": "Endpoint failed the test",
+      "providerRequired": "Select a provider",
+      "tempInvalid": "Temperature must be a number between 0 and 2"
+    },
+    "styleDialog": {
+      "editTitle": "Edit Style Preset",
+      "addTitle": "Add Style Preset",
+      "sub": "The prompt fragment is in English and is automatically prepended to character and scene image prompts.",
+      "tag": "Style",
+      "name": "Style name",
+      "namePlaceholder": "e.g. 3D, anime, photorealistic",
+      "key": "Style key",
+      "keyPlaceholder": "e.g. 3d, anime (lowercase letters/digits/dashes)",
+      "keyHint": "The style identifier stored in the project; cannot be changed after creation.",
+      "prompt": "Prompt fragment (English)",
+      "promptPlaceholder": "e.g. anime style, cel shading, vibrant colors, clean line art",
+      "description": "Description",
+      "descPlaceholder": "One line about when to use this style",
+      "sort": "Sort order",
+      "required": "Name, key and prompt fragment are required"
+    },
+    "migrate": {
+      "title": "Change Storage Location",
+      "newDir": "New directory",
+      "dataToMove": "Data to migrate",
+      "sizeNote": "About {size}",
+      "freeNote": " · {size} free on target",
+      "moveFiles": "Migrate existing data (database and all generated files)",
+      "emptyWarn": "Warning: the app will start with a fresh empty database. Data in the old directory is kept but will no longer be used.",
+      "note": "Background services will briefly stop during migration; ongoing generation tasks will be interrupted. The page reloads when done.",
+      "start": "Start Migration",
+      "pickFailed": "Failed to pick a directory",
+      "failed": "Migration failed; the original storage location was restored"
+    },
+    "styleDelete": {
+      "title": "Delete Style Preset",
+      "message": "Delete style “{name}”? Projects already using it are unaffected, but a deleted built-in style may be restored on restart — consider disabling instead."
+    },
+    "skillDelete": {
+      "title": "Delete Skill",
+      "message": "Delete skill “{id}”? The corresponding Agent will fall back to its built-in default prompt."
+    }
+  },
+  "episode": {
+    "topbar": {
+      "back": "Back to Project",
+      "episodeN": "Episode {n}",
+      "meta": "{roles} characters · {shots} segments",
+      "tasks": "Tasks",
+      "viewFilm": "View Film",
+      "continue": "Continue",
+      "start": "Start Production",
+      "resolution": "Resolution"
+    },
+    "model": {
+      "defaultWith": "Default · {model}",
+      "notConfigured": "Not configured"
+    },
+    "sidebar": {
+      "inProgress": "In progress",
+      "refreshData": "Refresh Data",
+      "collapse": "Collapse sidebar",
+      "expand": "Expand sidebar"
+    },
+    "nav": {
+      "prev": "Back",
+      "next": "Next",
+      "toExport": "Go to Export"
+    },
+    "stage": {
+      "script": "Script",
+      "scriptDesc": "Rewrite and organize content",
+      "production": "Production",
+      "assets": "Assets",
+      "assetsDesc": "Characters / scenes / props",
+      "videos": "Video Production",
+      "videosDesc": "Storyboard breakdown and video generation",
+      "export": "Export",
+      "exportDesc": "Merge and output the film",
+      "mergeExport": "Merge & Export",
+      "scriptStage": "Script · {step}",
+      "prodStage": "Production · {step}",
+      "exportDone": "Export · done",
+      "exportWaiting": "Export · waiting to merge",
+      "workbench": "Workbench"
+    },
+    "script": {
+      "raw": "Raw Content",
+      "rewrite": "AI Rewrite",
+      "charCount": "{n} chars",
+      "saved": "Saved",
+      "rawPlaceholder": "Paste the novel text, story outline or shot descriptions...",
+      "skipRewrite": "Skip Rewrite",
+      "rewriteAgain": "Rewrite Again",
+      "emptyTitle": "AI rewrite into a formatted script",
+      "emptyDesc": "Use AI to organize the raw content into a formatted script, or skip this step and go straight to asset production.",
+      "startRewrite": "Start Rewrite",
+      "rewriting": "Rewriting the script...",
+      "scriptPlaceholder": "Formatted script content...",
+      "rawRequired": "Please fill in the raw content first",
+      "skipDone": "AI rewrite skipped; the raw content will be used directly"
+    },
+    "prod": {
+      "assets": "Asset Production",
+      "videos": "Video Production",
+      "notReady": "Not ready yet",
+      "readyCount": "{ready}/{total} ready",
+      "extract": "Extract {type}",
+      "reextract": "Re-extract {type}",
+      "batchChar": "Batch Characters",
+      "batchScene": "Batch Scenes",
+      "batchProp": "Batch Props",
+      "extractingTypes": "Extracting {types}...",
+      "extractingTypesDots": "Extracting {types}…",
+      "emptyTitle": "Start Extracting Assets",
+      "emptyDesc": "Characters, scenes and props will appear here after extraction. Extract each type separately or all at once in parallel.",
+      "startExtract": "Start Extraction",
+      "scriptFirst": "Please finish the script first",
+      "goBack": "Go back"
+    },
+    "asset": {
+      "fallbackType": "Asset",
+      "typeChar": "Character asset",
+      "typeScene": "Scene asset",
+      "typeProp": "Prop asset",
+      "detailTitle": "{type} detail",
+      "delChar": "Delete character",
+      "delScene": "Delete scene",
+      "delProp": "Delete prop",
+      "charImageTitle": "{name} character portrait",
+      "sceneImageTitle": "{name} scene image",
+      "propImageTitle": "{name} prop image",
+      "portraitReady": "Portrait ready",
+      "portraitPending": "Portrait generating",
+      "portraitTodo": "Portrait pending",
+      "ready": "Ready",
+      "generating": "Generating",
+      "todo": "Pending",
+      "regen": "Regenerate",
+      "generate": "Generate",
+      "upload": "Upload",
+      "uploadCharImage": "Upload character portrait",
+      "uploadSceneImage": "Upload scene image",
+      "uploadPropImage": "Upload prop image",
+      "uploadImage": "Upload image",
+      "appearance": "Appearance: ",
+      "styling": "Styling: ",
+      "lighting": "Lighting · ",
+      "appearanceTodo": "Appearance TBD",
+      "stylingTodo": "Styling TBD",
+      "sceneDescTodo": "Scene description TBD",
+      "sceneLightTodo": "Scene lighting TBD",
+      "noDescription": "No description",
+      "noTime": "Time not set",
+      "finalPromptTurnaround": "Final prompt · Turnaround",
+      "finalPromptFixed": "Final prompt · Fixed view",
+      "finalPromptWhiteBg": "Final prompt · White-bg product shot",
+      "finalPromptAutoTurnaround": "Auto-generated by the prompt Agent on first portrait generation",
+      "finalPromptAutoFixed": "Auto-generated by the prompt Agent on first image generation (foreground/midground/background)",
+      "finalPromptAutoWhiteBg": "Auto-generated by the prompt Agent on first image generation (white-bg product shot)",
+      "propsEmpty": "No plot-critical props in this episode",
+      "visualPreview": "Visual Preview",
+      "kindLabel": "Type",
+      "charPortrait": "Character portrait",
+      "sceneImage": "Scene image",
+      "roleLabel": "Role",
+      "propTypeLabel": "Prop type",
+      "timeLabel": "Time",
+      "editInfo": "Edit Info",
+      "editHintChar": "Appearance and styling affect the character portrait",
+      "editHintProp": "Object appearance affects the prop image",
+      "editHintScene": "Space and lighting affect the scene image",
+      "appearanceOfObject": "Object appearance",
+      "appearancePlaceholder": "Material, color, shape, size, wear, scratches…",
+      "appearanceField": "Appearance",
+      "appearanceFieldPlaceholder": "Age impression, facial features, build, temperament…",
+      "stylingField": "Styling",
+      "stylingFieldPlaceholder": "Hair, clothing, makeup, accessories…",
+      "sceneDescField": "Scene description",
+      "sceneDescPlaceholder": "Space, furnishings, period texture, key visual elements…",
+      "sceneLightField": "Scene lighting",
+      "sceneLightPlaceholder": "Light sources, color tone, brightness, atmosphere…",
+      "genPrompt": "Generate Prompt",
+      "regenPrompt": "Regenerate",
+      "genPortrait": "Generate Portrait",
+      "regenPortrait": "Regenerate Portrait",
+      "genScene": "Generate Scene",
+      "regenScene": "Regenerate Scene",
+      "genProp": "Generate Prop Image",
+      "regenProp": "Regenerate Prop Image",
+      "promptPlaceholderChar": "Write the turnaround final prompt manually, or click “Generate Prompt” for the Agent",
+      "promptPlaceholderScene": "Write the fixed-view final prompt manually, or click “Generate Prompt” for the Agent",
+      "promptPlaceholderProp": "Write the white-bg final prompt manually, or click “Generate Prompt” for the Agent",
+      "promptHintChar": "The prompt is editable and takes effect on save. After changing appearance or styling and saving, the final prompt is cleared and will be regenerated by the prompt Agent on next portrait generation.",
+      "promptHintScene": "The prompt is editable and takes effect on save. After changing the description or lighting and saving, the final prompt is cleared and will be regenerated by the prompt Agent on next scene image generation.",
+      "promptHintProp": "The prompt is editable and takes effect on save. After changing the object appearance and saving, the final prompt is cleared and will be regenerated by the prompt Agent on next prop image generation.",
+      "generatingPrompt": "Generating final prompt…",
+      "promptGenerated": "Final prompt generated",
+      "promptRegenerated": "Final prompt regenerated",
+      "promptGenFailedRetry": "Final prompt generation failed, please retry",
+      "promptGenFailed": "Final prompt generation failed",
+      "promptCopied": "Final prompt copied",
+      "copyFailed": "Copy failed; please select and copy the text manually",
+      "noChanges": "No changes to save",
+      "saved": "Changes saved",
+      "saveFailed": "Save failed",
+      "saveChanges": "Save Changes",
+      "unnamedChar": "Unnamed character",
+      "unnamedProp": "Unnamed prop",
+      "unnamedScene": "Unnamed scene",
+      "propSingleImage": "Prop product shot",
+      "propImage": "Prop image"
+    },
+    "create": {
+      "title": "Add {type}",
+      "name": "Name",
+      "namePlaceholderChar": "Character name",
+      "namePlaceholderProp": "Prop name",
+      "roleField": "Character role",
+      "rolePlaceholder": "e.g. protagonist / antagonist / supporting",
+      "appearancePlaceholder": "Appearance traits (personality may be blended in)",
+      "stylingPlaceholder": "Clothing, makeup, accessories",
+      "location": "Location",
+      "locationPlaceholder": "Scene location",
+      "time": "Time",
+      "timePlaceholder": "e.g. day / night",
+      "sceneDescPlaceholder": "Environment, furnishings, atmosphere",
+      "lightPlaceholder": "e.g. warm dusk light, cold overhead light",
+      "typeField": "Type",
+      "typePlaceholder": "e.g. weapon / keepsake / document",
+      "appearanceOnlyPlaceholder": "Describe only the object's appearance, nothing else",
+      "locationRequired": "Please enter the scene location",
+      "nameRequired": "Please enter a name",
+      "created": "{type} added"
+    },
+    "delete": {
+      "title": "Delete {type}",
+      "message": "Delete {type} “{name}”? It will be removed from all episodes of this drama.",
+      "deleted": "{type} deleted"
+    },
+    "sb": {
+      "title": "Storyboard Breakdown",
+      "segmentStat": "{n} segments · {dur}s",
+      "rebreak": "Break Again",
+      "startBreak": "Break down & generate prompts",
+      "promptProgress": "Prompts {done}/{total}",
+      "promptSelected": "Generate selected prompts ({n})",
+      "batchPrompts": "Batch Fill Prompts",
+      "listTitle": "Shot List",
+      "listSub": "Check breakdown descriptions and bound characters/scenes",
+      "select": "Select",
+      "selectAll": "Select All",
+      "selectMissing": "Missing Only",
+      "clear": "Clear",
+      "selectedCount": "{n} selected",
+      "generatingProgress": "Generating {done}/{total}",
+      "generateSelected": "Generate video prompts ({n})",
+      "shotN": "Shot #{n}",
+      "totalCount": "{n} in total",
+      "duration": "Duration",
+      "descSection": "Shot Description",
+      "descLabel": "Visual description",
+      "descHint": "Describe each sub-shot as 【Shot 1】【Shot 2】…; dialogue as “Name says: 「line」”, narration as “Narrator: …”",
+      "descPlaceholder": "Shot visual description",
+      "atmosphere": "Atmosphere",
+      "atmospherePlaceholder": "Lighting, color tone, air feel, ambience",
+      "videoPromptSection": "Video Prompt",
+      "regenPrompt": "Regenerate",
+      "aiGenerate": "AI Generate",
+      "videoPromptCopy": "Generated from this shot's visual description (including dialogue/narration) and atmosphere",
+      "videoPromptPlaceholder": "Use {'@'}Name for images and #Name for voices; describe the dialogue, speaker and camera movement…",
+      "breaking": "Breaking the storyboard...",
+      "emptyTitle": "Start Storyboard Breakdown",
+      "emptyDesc": "Break the script into shots based on the script, characters and scenes, producing shot descriptions and bindings.",
+      "hasVideo": "Video generated",
+      "noVideo": "No video yet",
+      "hasVideoShort": "Has video",
+      "videoFlag": "V",
+      "noDescription": "No visual description",
+      "zeroChars": "0 characters",
+      "unboundScene": "No scene bound",
+      "breakFirst": "Break the storyboard first",
+      "selectedMissing": "The selected shots don't exist",
+      "allHavePrompts": "All shots already have video prompts",
+      "batchStarted": "Generating video prompts for {n} shots…",
+      "batchDone": "Batch video prompt generation complete",
+      "batchDoneFailed": "Batch video prompt generation complete, {n} failed",
+      "batchFailed": "Batch video prompt generation failed",
+      "promptGenerated": "Video prompt for shot #{n} generated"
+    },
+    "ref": {
+      "title": "Reference Assets",
+      "copy": "Bind characters / scenes / props as video references",
+      "boundCount": "{bound}/{total} bound",
+      "clickAdd": "Click to add as reference",
+      "clickRemove": "Click to remove from references",
+      "shortChar": "C",
+      "shortScene": "S",
+      "shortProp": "P",
+      "usable": "Usable",
+      "notReady": "Not generated",
+      "unbound": "Unbound",
+      "gotoGenerate": "Go generate →",
+      "empty": "No scenes, characters or props in this episode yet. Extract assets in “Assets” first, then bind them here."
+    },
+    "vid": {
+      "shotCount": "{n} shots",
+      "doneCount": "{done}/{total} generated",
+      "batchVideos": "Batch Videos",
+      "emptyTitle": "Break the storyboard first",
+      "emptyDesc": "Video tasks come from the storyboard breakdown. Generate shot descriptions and video prompts first, then generate videos in batch.",
+      "lockedModel": "Video model for this episode: ",
+      "listTitle": "Video Task List",
+      "listMeta": "In shot order · {n} tasks",
+      "metricPending": "{n} generating",
+      "metricDone": "{n} done",
+      "metricFailed": "{n} failed",
+      "references": "{n} refs",
+      "refCountMeta": "{n} reference assets",
+      "shotN": "Shot #{n}",
+      "playerTitle": "Shot {n}",
+      "setMain": "Set as Main Video",
+      "setMainDone": "Set as main video",
+      "setMainFailed": "Setting failed",
+      "download": "Download",
+      "emptyGenerating": "Video generating…",
+      "emptyNoVideo": "No video generated yet",
+      "emptyGeneratingDesc": "Once generated, it can be previewed here",
+      "emptyNoVideoDesc": "Click the button below to generate a video for this shot",
+      "generateVideo": "Generate Video",
+      "history": "Video History",
+      "current": "Current",
+      "deleteRecord": "Delete this record",
+      "historyDeleted": "History record deleted",
+      "needRefOrPrompt": "At least one reference asset or a video prompt is required",
+      "generating": "Video generating",
+      "genDone": "Video generation complete",
+      "genFailed": "Video generation failed",
+      "genTimeout": "Video generation timed out",
+      "allDone": "All shot videos generated",
+      "moderationHint": "Looks like a real-person/sensitive content moderation rejection — switch video model in the top bar and retry",
+      "resolutionSwitched": "Episode video resolution switched to {label}",
+      "noneToGenerate": "No shots to generate",
+      "batchStarted": "Started {n} video generation tasks",
+      "retryFailed": "Retry failed ({n})",
+      "select": "Select",
+      "selectDone": "{n} selected · Done",
+      "batchSelected": "Generate selected ({n})",
+      "listMetaFiltered": "Filtered · {n}/{total} tasks",
+      "defaultModel": "Default model",
+      "confirmTitle": "Batch generate videos",
+      "confirmShots": "Shots",
+      "confirmShotsValue": "{n}",
+      "confirmTotal": "Total duration",
+      "confirmApprox": "~{n}s",
+      "confirmModel": "Video model",
+      "confirmResolution": "Resolution",
+      "confirmNote": "Generation will start shot by shot with the above config; failed tasks can be retried later via \"Retry failed\".",
+      "confirmStart": "Start ({n})",
+      "selectMissing": "Select without video",
+      "aspectRatio": "Aspect Ratio"
+    },
+    "inspector": {
+      "videoPromptPlaceholder": "Use {'@'}Name for images and #Name for voices; describe the dialogue, speaker and camera movement…",
+      "noRefs": "No reference assets bound to this shot",
+      "refMedia": "Reference images / videos / audio",
+      "imageN": "Image {n}",
+      "videoN": "Video {n}",
+      "audioN": "Audio {n}",
+      "uploadRefImage": "Upload reference image ({used}/{limit})",
+      "uploadRefVideo": "Upload reference video ({used}/{limit})",
+      "uploadRefAudio": "Upload reference audio ({used}/{limit})",
+      "refAudioHint": "Reference audio requires at least 1 reference image or video",
+      "params": "Generation Params",
+      "duration": "Shot duration",
+      "durationUnit": "s (2-30)",
+      "durationHint": "Edits save to the storyboard instantly and apply to list and batch generation",
+      "effective": "{model} · {res} · {dur}s",
+      "boundRefs": "Bound References",
+      "noBoundRefs": "No bound assets (bind in the center \"References\" panel)"
+    },
+    "tasks": {
+      "title": "Generation Tasks",
+      "meta": "Newest first · {n} tasks",
+      "emptyTitle": "No generation tasks",
+      "emptyDesc": "Tasks will appear here automatically after you trigger image/video generation in the assets, storyboard or video steps.",
+      "duration": "took {dur}",
+      "sbN": "Shot #{n}",
+      "generic": "General",
+      "fullMerge": "Full-episode merge",
+      "mergeKind": "Merge"
+    },
+    "export": {
+      "notReadyDesc": "Please finish the storyboard and production steps first",
+      "gotoScript": "Go to Script",
+      "filmList": "Film List",
+      "countN": "{n} items",
+      "empty": "No films yet. Select shots below and click “Merge Selected”.",
+      "shotAssets": "Shot Assets",
+      "shotStat": "{done}/{total} generated · {selected} selected",
+      "clearSelection": "Clear Selection",
+      "selectAllReady": "Select All Generated",
+      "mergeSelected": "Merge Selected ({n})",
+      "selectFirst": "Select at least one shot with a generated video first",
+      "merging": "Merging…",
+      "mergingToast": "Merging...",
+      "mergeDone": "Merge complete",
+      "mergeFailed": "Merge failed",
+      "previewShot": "Play this shot",
+      "shotPreview": "Shot #{n} preview",
+      "markDone": "Mark done",
+      "markedDone": "Done",
+      "markDoneTitle": "Manually mark this episode's export as done (click again to undo)",
+      "markedDoneToast": "Marked as done",
+      "unmarkDoneToast": "Done mark removed"
+    },
+    "image": {
+      "generatingChar": "Character image generating",
+      "generatingScene": "Scene image generating",
+      "generatingProp": "Prop image generating",
+      "batchGeneratingChar": "Batch character images generating",
+      "batchGeneratingScene": "Batch scene images generating",
+      "batchGeneratingProp": "Batch prop images generating",
+      "allCharsDone": "All character images generated",
+      "allScenesDone": "All scene images generated",
+      "allPropsDone": "All prop images generated"
+    },
+    "extract": {
+      "done": "{type} extraction complete",
+      "failed": "{type} extraction failed"
+    },
+    "upload": {
+      "assetDone": "{type} uploaded",
+      "refImageFull": "Reference image limit reached (including scene/character assets)",
+      "refImageDone": "Reference image uploaded",
+      "refMax3": "At most 3 reference {type}",
+      "refDone": "Reference {type} uploaded",
+      "refAudioNeed": "Reference audio requires at least 1 reference image or video",
+      "audio": "audio",
+      "refMax": "At most {n} reference {type}"
+    },
+    "viewer": {
+      "imagePreview": "Image Preview",
+      "filmPreview": "Film Preview",
+      "downloadFilm": "Download Film"
+    },
+    "status": {
+      "done": "Done",
+      "generating": "Generating",
+      "failed": "Failed",
+      "todo": "Pending"
+    },
+    "resolution": {
+      "smooth": "Smooth",
+      "hd": "HD",
+      "uhd": "UHD"
+    },
+    "recovery": {
+      "remotePreview": "Video generated, but not saved locally yet. Play online or open the link below. Playback switches to the local file after download.",
+      "remoteUnavailable": "Online preview could not load. Try opening the link or resuming the download; the link may have expired.",
+      "restoreDownload": "Resume download",
+      "localDownloadFailed": "Generated · Download failed",
+      "restore": "Recover video",
+      "newGeneration": "Generate again",
+      "downloadFailed": "Video generated; delivery or saving failed. Recover the video.",
+      "unknownSubmission": "Submission uncertain. Check the upstream task before generating again.",
+      "downloading": "Video generated; downloading",
+      "diagnostics": "Copy diagnostics",
+      "copied": "Diagnostics copied",
+      "confirmNew": "This submits a new generation task and may incur another charge. Continue?",
+      "restoreFailed": "Recover videos ({n})",
+      "transferring": "Video generated; transferring",
+      "awaitingDelivery": "Video generated; awaiting delivery",
+      "restoreHint": "Recover the existing task instead of generating again"
+    }
+  },
+  "errors": {
+    "network": "Cannot reach the server. Check your network or that the service is running.",
+    "server": "The server returned an unexpected response. Please try again later.",
+    "unavailable": "Service temporarily unavailable. Please try again later.",
+    "gpu1Busy": "GPU1 (ComfyUI 8189) is unavailable: the legacy worker still has tasks or GPU memory in use. Choose GPU2/GPU3 or retry later.",
+    "auth": "Authentication failed. Check your API key settings.",
+    "rateLimit": "Too many requests or insufficient quota. Please try again later.",
+    "timeout": "Generation timed out. Please try again.",
+    "moderation": "Content was blocked by moderation. Adjust the prompt or switch models and retry.",
+    "requestFailed": "Request failed ({status})",
+    "unknown": "Operation failed. Please try again."
+  },
+  "tour": {
+    "next": "Next",
+    "prev": "Back",
+    "done": "Done",
+    "helpTitle": "Guide",
+    "index": {
+      "welcome": {
+        "title": "👋 Welcome to Huobao Drama",
+        "desc": "Novel → script → assets → storyboard → video → final cut, all in one place. Configure AI services first, then create your first project."
+      },
+      "create": {
+        "title": "Step 2 · Create a project",
+        "desc": "Click \"New Project\": name it, pick an aspect ratio (landscape/portrait) and a visual style."
+      },
+      "settings": {
+        "title": "Step 1 · Configure AI services",
+        "desc": "Every AI feature needs this first. Open Settings and paste a Huobao API Key to set up text/image/video in one click."
+      }
+    },
+    "settings": {
+      "quick": {
+        "title": "Fastest setup: Quick Setup",
+        "desc": "Paste a Huobao API Key to write the three recommended configs (text/image/video) at once, with connectivity testing."
+      },
+      "nav": {
+        "title": "Everything lives here",
+        "desc": "Switch sections on the left: AI services, general (UI & content language), style presets, agent prompts & skills, storage, about."
+      }
+    },
+    "episode": {
+      "topbar": {
+        "title": "Top bar: models & status",
+        "desc": "Switch the text/image/video model for this session any time; resolution and duration tiers follow the model."
+      },
+      "script": {
+        "title": "Step 1 · Script",
+        "desc": "(Prerequisite: AI services configured in Settings.) Paste the source novel and run \"AI Rewrite\" to get a shooting script."
+      },
+      "assets": {
+        "title": "Step 2 · Assets",
+        "desc": "Extract characters/scenes/props and generate consistent reference images, injected as reference material for videos."
+      },
+      "videos": {
+        "title": "Step 3 · Video production",
+        "desc": "Break down the storyboard → review prompts → batch-generate videos; retry failures in one click. Then merge & export."
+      },
+      "help": {
+        "title": "Replay anytime",
+        "desc": "Click this \"?\" button to replay this page's guide. Happy creating!"
+      }
+    }
+  }
+}
diff --git a/huobao-source/frontend/app/locales/ja.json b/huobao-source/frontend/app/locales/ja.json
new file mode 100644
index 0000000..2482d4b
--- /dev/null
+++ b/huobao-source/frontend/app/locales/ja.json
@@ -0,0 +1,988 @@
+{
+  "taskTracking": {
+    "queued": "待機中",
+    "running": "生成中",
+    "checking": "確認中",
+    "reconnecting": "再接続中",
+    "missing": "要確認",
+    "restoreImage": "画像を復元"
+  },
+  "assetReferences": {
+    "title": "生成用の参照画像",
+    "add": "参照画像を追加",
+    "saving": "保存中",
+    "preview": "参照画像 {n} を表示",
+    "remove": "参照画像 {n} を削除",
+    "used": "生成・再生成時に、この順序で参照します。",
+    "empty": "人物・衣装・画風の参照画像を追加できます。",
+    "formats": "JPG / PNG / WebP · 1枚20MBまで · 最大6枚",
+    "limit": "素材ごとに参照画像は最大6枚です",
+    "invalid": "20MB以下のJPG・PNG・WebP画像を選択してください",
+    "saved": "参照画像を保存しました",
+    "removed": "参照画像を削除しました",
+    "wait": "参照画像を保存中です。お待ちください。"
+  },
+  "app": {
+    "title": "火宝ショートドラマ",
+    "updateAvailable": "新バージョン v{version} があります。「設定 → 更新について」でアップグレードできます"
+  },
+  "characterVoice": {
+    "title": "キャラクターの声",
+    "forCharacter": "{name}の声",
+    "upload": "音声をアップロード",
+    "replace": "音声を差し替え",
+    "remove": "解除",
+    "saving": "保存中…",
+    "empty": "キャラクターの声のサンプルとして、明瞭な音声をアップロードします。",
+    "formats": "MP3 / WAV / M4A / AAC · 最大20MB",
+    "sample": "音声サンプル",
+    "preview": "{name}の声を試聴",
+    "saved": "キャラクターの声を保存しました",
+    "removed": "キャラクターの声を解除しました",
+    "invalidFormat": "MP3、WAV、M4A、AACの音声ファイルを選択してください",
+    "tooLarge": "音声ファイルは20MB以下にしてください",
+    "emptyFile": "音声ファイルが空です",
+    "playbackError": "音声を再生できません。ファイルを確認するか、再アップロードしてください。",
+    "referenceHint": "{'@'}名前で姿、セリフの #名前で音声を参照。例：{'@'}太郎が顔を上げ、#太郎が優しく話す。音声は各 2〜5 秒、合計 15 秒以内を推奨。",
+    "noMatch": "該当する音声がありません。アセットで音声をアップロードし、このショットにキャラクターを追加してください。"
+  },
+  "common": {
+    "confirm": "確認",
+    "cancel": "キャンセル",
+    "back": "戻る",
+    "saved": "保存しました",
+    "delete": "削除",
+    "deleteLoading": "削除中...",
+    "deleteFailed": "削除に失敗しました",
+    "save": "保存",
+    "close": "閉じる",
+    "refresh": "更新",
+    "add": "追加",
+    "copy": "コピー",
+    "download": "ダウンロード",
+    "default": "デフォルト",
+    "more": "その他",
+    "loading": "読み込み中…",
+    "listJoin": "、",
+    "role": "キャラクター",
+    "scene": "シーン",
+    "prop": "小道具",
+    "reference": "参照",
+    "serviceType": {
+      "text": "テキスト",
+      "image": "画像",
+      "video": "動画"
+    }
+  },
+  "layout": {
+    "nav": {
+      "projects": "プロジェクト",
+      "settings": "設定"
+    },
+    "banner": {
+      "missing": "{types}モデルが未設定のため、AI 機能は使用できません",
+      "goSettings": "設定へ"
+    },
+    "theme": {
+      "label": "テーマを切り替え",
+      "light": "ライトモード",
+      "dark": "ダークモード",
+      "system": "システムに従う"
+    }
+  },
+  "migrate": {
+    "title": "保存場所を切り替えています",
+    "hint": "移行中はアプリを閉じないでください",
+    "phases": {
+      "validating": "移行先ディレクトリを確認中…",
+      "stopping": "バックグラウンドサービスを停止中…",
+      "moving": "データファイルを移行中…",
+      "movingProgress": "データファイルを移行中… {copied} / {total}",
+      "config": "保存設定を更新中…",
+      "restarting": "バックグラウンドサービスを再起動中…",
+      "done": "移行が完了しました",
+      "error": "移行に失敗しました"
+    }
+  },
+  "components": {
+    "mention": {
+      "noMatch": "一致する参照がありません",
+      "fallbackGroup": "参照"
+    },
+    "baseSelect": {
+      "placeholder": "選択してください...",
+      "search": "検索...",
+      "noMatch": "一致する結果がありません"
+    },
+    "confirmDialog": {
+      "title": "削除の確認"
+    },
+    "localeSwitcher": {
+      "label": "表示言語を切り替え"
+    },
+    "langSwitch": {
+      "title": "言語を {lang} に切替しますか？",
+      "message": "UI 言語と AI コンテンツ言語が同期して切り替わります。",
+      "effectUi": "画面表示がすべてこの言語に切り替わります",
+      "effectAi": "脚本リライト・アセット抽出・絵コンテ・プロンプトなどの AI 生成がこの言語になります（Agent プロンプト/スキルも同期）",
+      "effectRefresh": "確認すると画面が自動で再読み込みされます",
+      "confirm": "切替して再読み込み",
+      "refreshing": "言語を切替しました。再読み込み中…"
+    }
+  },
+  "composables": {
+    "agent": {
+      "busy": "処理を実行中です",
+      "done": "完了"
+    }
+  },
+  "index": {
+    "hero": {
+      "title": "プロジェクトランチャー",
+      "sub": "ひとつのアイデアから一本のショートドラマへ、AI が全工程を代行",
+      "projectCount": "{n} 件のプロジェクト",
+      "activeCount": "{n} 件進行中",
+      "styleCount": "{n} 種類のビジュアルスタイル"
+    },
+    "create": "新規プロジェクト",
+    "searchPlaceholder": "プロジェクトを検索",
+    "sortAria": "プロジェクトの並び替え",
+    "sortUpdated": "最近更新",
+    "sortTitle": "プロジェクト名",
+    "statusBadgeTitle": "クリックしてプロジェクト状態を設定",
+    "openProjectAria": "プロジェクト {title} を開く",
+    "openProject": "プロジェクトを開く",
+    "deleteProject": "プロジェクトを削除",
+    "projectMeta": "{chars} キャラクター · {scenes} シーン · {eps} 話",
+    "emptyFilteredTitle": "一致するプロジェクトがありません",
+    "emptyFilteredDesc": "検索語やフィルタ条件を調整してください。",
+    "emptyTitle": "最初のショートドラマプロジェクトを作成",
+    "emptyDesc": "作成後、話を選んで制作を開始します。",
+    "deleted": "削除しました",
+    "noEpisodes": "エピソードがありません",
+    "episodeN": "第 {n} 話",
+    "ratio": {
+      "landscape": "16:9 · 横",
+      "portrait": "9:16 · 縦",
+      "square": "1:1 · 正方形",
+      "adaptive": "自動"
+    },
+    "status": {
+      "all": "すべて",
+      "draft": "未開始",
+      "active": "進行中",
+      "completed": "完了"
+    },
+    "createDialog": {
+      "title": "新規プロジェクト",
+      "desc": "作成後、プロジェクトページで話を選択します",
+      "name": "プロジェクト名",
+      "namePlaceholder": "例：都市ラブストーリー『タイムポスト局』",
+      "style": "ビジュアルスタイル",
+      "stylePlaceholder": "スタイルを選択",
+      "aspectRatio": "アスペクト比",
+      "aspectRatioPlaceholder": "アスペクト比を選択",
+      "aspectRatioHint": "作成後に固定され、動画生成はこの比率で統一されます",
+      "submit": "プロジェクトを作成"
+    },
+    "deleteDialog": {
+      "title": "プロジェクトを削除",
+      "message": "「{title}」を削除しますか？配下のエピソード、分镜、生成記録もすべて削除されます。この操作は元に戻せません。"
+    },
+    "time": {
+      "justNow": "たった今",
+      "minutesAgo": "{n} 分前",
+      "hoursAgo": "{n} 時間前",
+      "daysAgo": "{n} 日前"
+    }
+  },
+  "detail": {
+    "head": {
+      "charCount": "{n} キャラクター",
+      "sceneCount": "{n} シーン",
+      "epCount": "{n} 話",
+      "addEpisode": "話を追加"
+    },
+    "tabs": {
+      "episodes": "エピソード一覧",
+      "assets": "素材ライブラリ"
+    },
+    "ep": {
+      "statusTitle": "クリックしてこの話の状態を設定",
+      "resTitle": "クリックしてこの話の動画解像度を変更",
+      "deleteTitle": "この話を削除",
+      "enter": "制作を開く",
+      "scriptReady": "脚本入力済み",
+      "merged": "結合済み",
+      "emptyCreateTitle": "クリックして第 1 話を作成",
+      "emptyCreateText": "クリックして第 1 話を作成",
+      "addNextTitle": "第 {n} 話を追加",
+      "addNextText": "第 {n} 話を追加",
+      "episodeN": "第 {n} 話",
+      "res720": "720p · 高画質",
+      "res480": "480p · スムーズ",
+      "resSwitched": "この話の動画解像度を {res} に変更しました"
+    },
+    "epCreate": {
+      "title": "新しい話を作成",
+      "titleField": "タイトル",
+      "titlePlaceholder": "話数で自動命名",
+      "titleHint": "空欄の場合は話数で自動命名されます（例：「{example}」）。",
+      "example": "第 {n} 話",
+      "resolution": "動画解像度",
+      "resolutionPlaceholder": "解像度を選択",
+      "resolutionHint": "作成後、この話の動画はこの解像度で生成されます。後から話カードでも変更できます。",
+      "lockCopy": "作成時に現在有効な画像・動画生成能力がロックされます。",
+      "creating": "作成中...",
+      "create": "作成",
+      "added": "新しい話を追加しました"
+    },
+    "epDelete": {
+      "message": "「{title}」を削除しますか？一覧から非表示になり、その分镜と生成記録にもアクセスできなくなります。"
+    },
+    "assets": {
+      "emptyTitle": "素材がまだありません",
+      "emptyDesc": "制作ワークベンチで「資産抽出」によりキャラクター、シーン、小道具を生成すると、ここに自動で収録され、素材画像も直接生成できます。",
+      "emptyKindTitle": "{kind}の素材がありません",
+      "emptyKindDesc": "ワークベンチで抽出・生成すると、ここに表示されます。",
+      "todoShort": "未入力"
+    },
+    "mat": {
+      "dialogAria": "素材詳細",
+      "unnamed": "名称未設定",
+      "propTypePlaceholder": "例：武器 / 形見",
+      "personaField": "人物設定",
+      "personaPlaceholder": "性格、背景、動機…",
+      "locationPlaceholder": "例：故宮・太和殿",
+      "timePlaceholder": "例：夕暮れ / 深夜",
+      "finalPromptLabel": "最終プロンプト",
+      "finalPromptSub": "AI が情報から生成。手動で修正して保存できます",
+      "genPromptTitle": "AI で最終プロンプトを生成",
+      "needEpisodeFirst": "先に「エピソード一覧」で 1 話以上作成してください",
+      "promptPlaceholder": "「プロンプト生成」をクリックして AI に生成させるか、手動で入力してください。手動で保存すると、次回の画像生成でこのプロンプトが使われます。",
+      "genImage": "画像を生成",
+      "saving": "保存中…",
+      "generating": "{kind}「{name}」の画像を生成中",
+      "genTimeout": "{kind}「{name}」の生成がタイムアウトしました。後で更新して確認してください",
+      "uploaded": "{kind}「{name}」の画像をアップロードしました",
+      "needEpisodeForImage": "素材画像を生成するには、先に「エピソード一覧」で 1 話以上作成してください",
+      "needEpisodeForPrompt": "最終プロンプトを生成するには、先に「エピソード一覧」で 1 話以上作成してください",
+      "locationRequired": "場所を入力してください"
+    }
+  },
+  "settings": {
+    "groupBase": "基本",
+    "tabs": {
+      "general": "一般",
+      "ai": "AI サービス",
+      "styles": "スタイルプリセット",
+      "storage": "保存場所",
+      "about": "更新について",
+      "agents": "Agent 設定"
+    },
+    "common": {
+      "disabled": "無効",
+      "custom": "カスタム",
+      "empty": "設定がありません"
+    },
+    "general": {
+      "title": "一般",
+      "desc": "アプリ全体の設定。言語切替は UI と AI 生成コンテンツの両方に適用されます。",
+      "contentLanguage": "AI コンテンツ言語",
+      "contentLanguageSub": "UI と AI 生成（脚本/アセット/絵コンテ/プロンプト）共通の言語",
+      "languageLabel": "言語",
+      "languageNote": "切替すると UI と AI コンテンツ言語が同期し、自動で再読み込みされます",
+      "languageHint": "入口は 2 か所（上部バーの言語ボタン / ここ）どちらも等価で、全体に適用されます。",
+      "languageSaved": "コンテンツ言語を保存しました",
+      "appearance": "外観",
+      "appearanceSub": "画面のカラーテーマ。即時反映されます",
+      "appearanceLabel": "テーマモード",
+      "appearanceNote": "「システム」ではOSの外観に自動で追従します",
+      "appearanceLight": "ライト",
+      "appearanceDark": "ダーク",
+      "appearanceSystem": "システム",
+      "languageSavedWith": "AI コンテンツ言語を {lang} に切替しました。以後の生成（脚本/アセット/絵コンテ/プロンプト）に適用されます",
+      "langNameZh": "中国語",
+      "langNameEn": "英語",
+      "langNameJa": "日本語",
+      "langNameKo": "韓国語",
+      "unifiedSwitchWarning": "{lang} に切替しました。UI と AI コンテンツ言語が同期され、まもなく再読み込みします…"
+    },
+    "ai": {
+      "title": "AI サービス設定",
+      "desc": "まず推奨テンプレートで設定を作成し、サービスタイプごとに微調整します。ワークベンチで話を作成する際に選択した画像・動画能力がロックされます。",
+      "quickTitle": "火宝クイック設定",
+      "recommended": "おすすめ",
+      "quickDesc": "Huobao API Key を入力すると、テキスト・画像・動画の 3 つの推奨設定を一括で書き込みます。",
+      "getKey": "Huobao API Key を取得",
+      "regionCn": "国内",
+      "regionCom": "海外",
+      "applyQuick": "火宝設定を書き込む",
+      "manualTitle": "手動テンプレート",
+      "manualDesc": "サービスタイプを選ぶと、推奨の `provider / base URL / model` がテンプレートから入力されます。",
+      "activeCount": "{n} 件有効",
+      "hasKey": "設定済み",
+      "noKey": "キーなし",
+      "currentDefault": "現在のデフォルトモデル",
+      "setDefault": "このタイプのデフォルトモデルに設定",
+      "noBaseUrl": "Base URL 未設定",
+      "test": "テスト",
+      "apiKeyRequired": "Huobao API Key を入力してください",
+      "quickApplied": "火宝クイック設定を書き込みました",
+      "defaultModelSwitched": "デフォルト{type}モデルを {model} に切り替えました",
+      "meta": {
+        "text": "脚本リライト、キャラクター・シーン抽出、分镜分解などの Agent テキスト能力",
+        "image": "キャラクター図、シーン図、ショット図などの静止画生成",
+        "video": "ショット動画の直接生成（デフォルト Seedance 2.0）"
+      }
+    },
+    "styles": {
+      "title": "スタイルプリセット",
+      "desc": "プロジェクト作成時に選ぶビジュアルスタイル。その英語プロンプト片はキャラクター図・シーン図の生成に自動注入されます。無効なスタイルは作成オプションに表示されません。",
+      "allTitle": "すべてのスタイル",
+      "count": "{active} 件有効 · 全 {total} 件",
+      "empty": "スタイルプリセットがありません"
+    },
+    "storage": {
+      "title": "保存場所",
+      "desc": "データベースと生成ファイル（画像/動画/結合/アップロード）が置かれるディレクトリ。場所を変更するとバックグラウンドサービスが一時停止し、データが移行されます。",
+      "currentDir": "現在のデータディレクトリ",
+      "computedAt": "{time} 時点の集計",
+      "changeLocation": "場所を変更",
+      "dataDir": "データディレクトリ",
+      "desktopMode": "デスクトップ版",
+      "serverMode": "サーバーモード",
+      "totalUsage": "合計使用 {size}",
+      "counting": "集計中…",
+      "breakdown": {
+        "db": "データベース",
+        "images": "画像",
+        "videos": "動画",
+        "merged": "結合",
+        "uploads": "アップロード",
+        "temp": "一時",
+        "other": "その他"
+      },
+      "diskFree": "ディスク空き {size}",
+      "note": "データディレクトリには SQLite データベースとすべての生成メディアが含まれます。Agent スキル（workspace）は含まれず、移行されません。",
+      "serverNote": "サーバーデプロイでは STORAGE_PATH / SQLITE_PATH 環境変数で保存場所を設定し、再起動後に反映されます。",
+      "loadFailed": "保存情報の読み込みに失敗しました"
+    },
+    "about": {
+      "title": "更新について",
+      "desc": "リリースマニフェストから新バージョンを取得し、ローカルで sha256 を検証した後、パッケージを入れ替えて再起動します。ユーザーデータと設定はシステムのデータディレクトリに保存され、更新の影響を受けません。",
+      "currentVersion": "現在のバージョン v{v}",
+      "latestVersion": "最新バージョン v{v}",
+      "check": "更新を確認",
+      "webMode": "現在はブラウザ / サーバーモードのため、アプリ内更新はデスクトップ版のみ利用可能です。",
+      "upToDate": "最新バージョンです",
+      "found": "新バージョン v{v} があります",
+      "downloading": "ダウンロード中 {p}%",
+      "download": "更新をダウンロード",
+      "ready": "更新パッケージの準備ができました",
+      "readyDesc": "クリックするとアプリを終了し、自動でインストールして再起動します。",
+      "restartInstall": "再起動してインストール",
+      "checkFailed": "確認に失敗しました",
+      "retry": "再試行",
+      "empty": "「更新を確認」をクリックして最新バージョンを取得します。",
+      "note": "説明：macOS ではディレクトリ置換で更新します（Tauri と同方式、Apple 署名不要）。Windows ではインストーラーがサイレントインストールします。",
+      "checkFailedToast": "更新の確認に失敗しました",
+      "downloadDone": "更新パッケージのダウンロードが完了しました。インストールできます",
+      "downloadFailed": "ダウンロードに失敗しました",
+      "installFailed": "インストールに失敗しました",
+      "serverApply": "今すぐ更新",
+      "serverApplyStarted": "更新を開始しました：Watchtower が新しいイメージを取得してコンテナを再作成します。数分後にページを更新してください",
+      "serverApplyFailed": "更新の開始に失敗しました",
+      "serverManualHint": "サーバーデプロイ：デプロイディレクトリで実行してください",
+      "serverNote": "補足：Watchtower を設定した Docker デプロイではワンクリック更新（新イメージ取得＋コンテナ再作成）が可能です。未設定の場合は表示されたコマンドを手動で実行してください。"
+    },
+    "agents": {
+      "promptHint": "{file} として保存",
+      "promptPlaceholder": "Agent システムプロンプト...",
+      "reset": "デフォルトに戻す",
+      "promptReset": "デフォルトプロンプトに戻しました（prompt ファイルを削除）",
+      "saved": "{agent} の設定を保存しました",
+      "scriptRewriter": "脚本リライト",
+      "extractor": "キャラクター・シーン抽出",
+      "storyboardBreaker": "分镜分解",
+      "promptGenerator": "プロンプト生成",
+      "langFallback": "中国語にフォールバック",
+      "followContentLang": "編集言語：{lang}（「一般 → AI コンテンツ言語」で切替）"
+    },
+    "skills": {
+      "agentList": "Agent 一覧",
+      "desc": "Skills は Agent の高度なプロンプトレイヤーとしてのみ使用され、ワークベンチの通常の機能入口には影響しません。",
+      "add": "Skill を追加",
+      "emptyTitle": "Skill がありません",
+      "emptyDesc": "右上の「Skill を追加」から最初のプロンプトファイルを作成してください",
+      "contentPlaceholder": "SKILL.md の内容を記述...",
+      "addTitle": "Skill を追加 — {agent}",
+      "dirName": "Skill ディレクトリ名",
+      "dirNameHint": "英語、一意",
+      "dirNamePlaceholder": "例：custom-extraction",
+      "name": "名前",
+      "namePlaceholder": "例：カスタム抽出ルール",
+      "description": "説明",
+      "descPlaceholder": "この Skill の用途を簡単に記述",
+      "create": "作成",
+      "created": "Skill を作成しました"
+    },
+    "cfg": {
+      "editTitle": "サービス設定を編集",
+      "addTitle": "{type}サービスを追加",
+      "sub": "まずテンプレートを選ぶと、適切な `Base URL` とデフォルトモデルが自動入力されます。",
+      "name": "設定名",
+      "namePlaceholder": "例：火宝デフォルト画像サービス",
+      "provider": "プロバイダー",
+      "providerPlaceholder": "プロバイダーを選択",
+      "priority": "優先度",
+      "priorityHint": "数値が大きいほど優先。ワークベンチは同タイプの有効設定のうち優先度が最も高いものを使います。",
+      "models": "モデル",
+      "modelsHint": "先頭がデフォルトモデルです。タグをクリックで先頭に移動。カンマ/改行区切りの一括貼り付けに対応",
+      "modelPlaceholder": "モデル名を入力してEnterで追加",
+      "modelChipHint": "クリックでデフォルトに設定（先頭へ）",
+      "tempHint": "空欄でプロバイダーのデフォルトに従う",
+      "tempPlaceholder": "例：0.6",
+      "tempNote": "温度が固定されたモデル（例：kimi-k2 系は 0.6 のみ）があります。invalid temperature エラーが出た場合はここに値を入力してください。",
+      "test": "設定をテスト",
+      "reachable": "エンドポイントが応答しました",
+      "unreachable": "エンドポイントのテストに失敗しました",
+      "providerRequired": "プロバイダーを選択してください",
+      "tempInvalid": "Temperature は 0〜2 の数値で入力してください"
+    },
+    "styleDialog": {
+      "editTitle": "スタイルプリセットを編集",
+      "addTitle": "スタイルプリセットを追加",
+      "sub": "プロンプト片は英語で、キャラクター図・シーン図の生成時にプロンプトへ自動で追加されます。",
+      "tag": "スタイル",
+      "name": "スタイル名",
+      "namePlaceholder": "例：3D、アニメ、実写映画",
+      "key": "スタイル key",
+      "keyPlaceholder": "例：3d、anime（小文字/数字/ハイフン）",
+      "keyHint": "プロジェクトに保存されるスタイル識別子。作成後は変更できません。",
+      "prompt": "プロンプト片（英語）",
+      "promptPlaceholder": "例：anime style, cel shading, vibrant colors, clean line art",
+      "description": "説明",
+      "descPlaceholder": "このスタイルの用途を一行で",
+      "sort": "並び順",
+      "required": "名前、key、プロンプト片は必須です"
+    },
+    "migrate": {
+      "title": "保存場所を変更",
+      "newDir": "新しいディレクトリ",
+      "dataToMove": "移行するデータ",
+      "sizeNote": "約 {size}",
+      "freeNote": " · 移行先の空き {size}",
+      "moveFiles": "既存データを移行（データベースとすべての生成ファイル）",
+      "emptyWarn": "警告：アプリは新しい空のデータベースで起動します。旧ディレクトリのデータは保持されますが使用されなくなります。",
+      "note": "移行中はバックグラウンドサービスが一時停止し、進行中の生成タスクは中断されます。完了後、ページが自動で再読み込みされます。",
+      "start": "移行を開始",
+      "pickFailed": "ディレクトリの選択に失敗しました",
+      "failed": "移行に失敗しました。元の保存場所に戻しました"
+    },
+    "styleDelete": {
+      "title": "スタイルプリセットを削除",
+      "message": "スタイル「{name}」を削除しますか？使用中のプロジェクトには影響しませんが、削除した組み込みスタイルは再起動で復元される場合があります。「無効化」の利用をおすすめします。"
+    },
+    "skillDelete": {
+      "title": "Skill を削除",
+      "message": "Skill「{id}」を削除しますか？対応する Agent は組み込みのデフォルトプロンプトに戻ります。"
+    }
+  },
+  "episode": {
+    "topbar": {
+      "back": "プロジェクトに戻る",
+      "episodeN": "第 {n} 話",
+      "meta": "{roles} キャラクター · {shots} セグメント",
+      "tasks": "タスク",
+      "viewFilm": "完成映像を見る",
+      "continue": "制作を続ける",
+      "start": "制作を開始",
+      "resolution": "解像度"
+    },
+    "model": {
+      "defaultWith": "デフォルト · {model}",
+      "notConfigured": "未設定"
+    },
+    "sidebar": {
+      "inProgress": "進行中",
+      "refreshData": "データを更新",
+      "collapse": "サイドバーを折りたたむ",
+      "expand": "サイドバーを展開"
+    },
+    "nav": {
+      "prev": "前へ",
+      "next": "次へ",
+      "toExport": "書き出しへ"
+    },
+    "stage": {
+      "script": "脚本",
+      "scriptDesc": "内容のリライトと整理",
+      "production": "制作",
+      "assets": "資産",
+      "assetsDesc": "キャラクター / シーン / 小道具",
+      "videos": "動画制作",
+      "videosDesc": "分镜分解と動画生成",
+      "export": "書き出し",
+      "exportDesc": "結合して映像を出力",
+      "mergeExport": "結合して書き出し",
+      "scriptStage": "脚本段階 · {step}",
+      "prodStage": "制作段階 · {step}",
+      "exportDone": "書き出し段階 · 完了",
+      "exportWaiting": "書き出し段階 · 結合待ち",
+      "workbench": "ワークベンチ"
+    },
+    "script": {
+      "raw": "原文",
+      "rewrite": "AI リライト",
+      "charCount": "{n} 文字",
+      "saved": "保存しました",
+      "rawPlaceholder": "小説の原文、ストーリー概要、分镜メモを貼り付け...",
+      "skipRewrite": "リライトをスキップ",
+      "rewriteAgain": "もう一度リライト",
+      "emptyTitle": "AI で書式付き脚本にリライト",
+      "emptyDesc": "AI で原文を書式付き脚本に整理するか、このステップをスキップして資産制作に進めます。",
+      "startRewrite": "リライトを開始",
+      "rewriting": "脚本をリライト中...",
+      "scriptPlaceholder": "書式付き脚本の内容...",
+      "rawRequired": "先に原文を入力してください",
+      "skipDone": "AI リライトをスキップしました。原文をそのまま使用します"
+    },
+    "prod": {
+      "assets": "アセット制作",
+      "videos": "動画制作",
+      "notReady": "まだ準備ができていません",
+      "readyCount": "{ready}/{total} 準備完了",
+      "extract": "{type}を抽出",
+      "reextract": "{type}を再抽出",
+      "batchChar": "キャラクター一括",
+      "batchScene": "シーン一括",
+      "batchProp": "小道具一括",
+      "extractingTypes": "{types}を抽出中...",
+      "extractingTypesDots": "{types}を抽出中…",
+      "emptyTitle": "資産抽出を開始",
+      "emptyDesc": "キャラクター、シーン、小道具は抽出後ここに表示されます。個別に抽出するか、一括で並行抽出できます。",
+      "startExtract": "抽出を開始",
+      "scriptFirst": "先に脚本を完成させてください",
+      "goBack": "処理に戻る"
+    },
+    "asset": {
+      "fallbackType": "資産",
+      "typeChar": "キャラクター資産",
+      "typeScene": "シーン資産",
+      "typeProp": "小道具資産",
+      "detailTitle": "{type}詳細",
+      "delChar": "キャラクターを削除",
+      "delScene": "シーンを削除",
+      "delProp": "小道具を削除",
+      "charImageTitle": "{name} キャラクターイメージ",
+      "sceneImageTitle": "{name} シーン図",
+      "propImageTitle": "{name} 小道具図",
+      "portraitReady": "イメージ生成済み",
+      "portraitPending": "イメージ生成中",
+      "portraitTodo": "イメージ未生成",
+      "ready": "生成済み",
+      "generating": "生成中",
+      "todo": "未生成",
+      "regen": "再生成",
+      "generate": "生成",
+      "upload": "アップロード",
+      "uploadCharImage": "キャラクターイメージをアップロード",
+      "uploadSceneImage": "シーン図をアップロード",
+      "uploadPropImage": "小道具図をアップロード",
+      "uploadImage": "画像をアップロード",
+      "appearance": "外見：",
+      "styling": "スタイリング：",
+      "lighting": "光照 · ",
+      "appearanceTodo": "外見未入力",
+      "stylingTodo": "スタイリング未入力",
+      "sceneDescTodo": "シーン説明未入力",
+      "sceneLightTodo": "シーン光影未入力",
+      "noDescription": "説明がありません",
+      "noTime": "時間未設定",
+      "finalPromptTurnaround": "最終プロンプト · 三面図",
+      "finalPromptFixed": "最終プロンプト · 固定視点",
+      "finalPromptWhiteBg": "最終プロンプト · 白背景単品",
+      "finalPromptAutoTurnaround": "初回のイメージ生成時にプロンプト Agent が自動生成",
+      "finalPromptAutoFixed": "初回の画像生成時にプロンプト Agent が自動生成（前景/中景/後景）",
+      "finalPromptAutoWhiteBg": "初回の画像生成時にプロンプト Agent が自動生成（白背景単品）",
+      "propsEmpty": "この話に物語上の重要な小道具はありません",
+      "visualPreview": "ビジュアルプレビュー",
+      "kindLabel": "タイプ",
+      "charPortrait": "キャラクターイメージ",
+      "sceneImage": "シーン画像",
+      "roleLabel": "役割",
+      "propTypeLabel": "小道具タイプ",
+      "timeLabel": "時間",
+      "editInfo": "情報を編集",
+      "editHintChar": "外見とスタイリングはキャラクターイメージに影響します",
+      "editHintProp": "物品の外見は小道具図に影響します",
+      "editHintScene": "空間と光影はシーン図に影響します",
+      "appearanceOfObject": "物品の外見",
+      "appearancePlaceholder": "材質、色、形状、大きさ、新旧、傷跡など",
+      "appearanceField": "外見",
+      "appearanceFieldPlaceholder": "年齢感、五官、体格、気質など",
+      "stylingField": "スタイリング",
+      "stylingFieldPlaceholder": "髪型、服装、メイク、アクセサリーなど",
+      "sceneDescField": "シーン説明",
+      "sceneDescPlaceholder": "空間、調度、年代質感、重要な視覚要素など",
+      "sceneLightField": "シーン光影",
+      "sceneLightPlaceholder": "光源、色調、明暗、雰囲気など",
+      "genPrompt": "プロンプトを生成",
+      "regenPrompt": "再生成",
+      "genPortrait": "イメージを生成",
+      "regenPortrait": "イメージを再生成",
+      "genScene": "シーンを生成",
+      "regenScene": "シーンを再生成",
+      "genProp": "小道具図を生成",
+      "regenProp": "小道具図を再生成",
+      "promptPlaceholderChar": "三面図の最終プロンプトを手動で書くか、「プロンプトを生成」で Agent に生成させます",
+      "promptPlaceholderScene": "固定視点の最終プロンプトを手動で書くか、「プロンプトを生成」で Agent に生成させます",
+      "promptPlaceholderProp": "白背景単品の最終プロンプトを手動で書くか、「プロンプトを生成」で Agent に生成させます",
+      "promptHintChar": "プロンプトは直接編集でき、保存後に反映されます。外見やスタイリングを変更して保存すると最終プロンプトがクリアされ、次回のイメージ生成時にプロンプト Agent が再生成します。",
+      "promptHintScene": "プロンプトは直接編集でき、保存後に反映されます。シーン説明や光影を変更して保存すると最終プロンプトがクリアされ、次回のシーン図生成時にプロンプト Agent が再生成します。",
+      "promptHintProp": "プロンプトは直接編集でき、保存後に反映されます。物品の外見を変更して保存すると最終プロンプトがクリアされ、次回の小道具図生成時にプロンプト Agent が再生成します。",
+      "generatingPrompt": "最終プロンプトを生成中…",
+      "promptGenerated": "最終プロンプトを生成しました",
+      "promptRegenerated": "最終プロンプトを再生成しました",
+      "promptGenFailedRetry": "最終プロンプトの生成に失敗しました。もう一度お試しください",
+      "promptGenFailed": "最終プロンプトの生成に失敗しました",
+      "promptCopied": "最終プロンプトをコピーしました",
+      "copyFailed": "コピーに失敗しました。テキストを手動で選択してコピーしてください",
+      "noChanges": "保存する変更がありません",
+      "saved": "変更を保存しました",
+      "saveFailed": "保存に失敗しました",
+      "saveChanges": "変更を保存",
+      "unnamedChar": "名称未設定のキャラクター",
+      "unnamedProp": "名称未設定の小道具",
+      "unnamedScene": "名称未設定のシーン",
+      "propSingleImage": "小道具単品図",
+      "propImage": "小道具図"
+    },
+    "create": {
+      "title": "{type}を追加",
+      "name": "名前",
+      "namePlaceholderChar": "キャラクター名",
+      "namePlaceholderProp": "小道具名",
+      "roleField": "キャラクターの役割",
+      "rolePlaceholder": "例：主人公 / 敵役 / 脇役",
+      "appearancePlaceholder": "外見の特徴（性格も織り込めます）",
+      "stylingPlaceholder": "服装、メイク、アクセサリー",
+      "location": "場所",
+      "locationPlaceholder": "シーンの場所",
+      "time": "時間",
+      "timePlaceholder": "例：昼 / 夜",
+      "sceneDescPlaceholder": "環境、調度、雰囲気",
+      "lightPlaceholder": "例：夕暮れの暖色光、冷たいトップライト",
+      "typeField": "タイプ",
+      "typePlaceholder": "例：武器 / 形見 / 書類",
+      "appearanceOnlyPlaceholder": "物品の外見のみを記述（他の要素は不要）",
+      "locationRequired": "シーンの場所を入力してください",
+      "nameRequired": "名前を入力してください",
+      "created": "{type}を追加しました"
+    },
+    "delete": {
+      "title": "{type}を削除",
+      "message": "{type}「{name}」を削除しますか？この作品のすべての話から取り除かれます。",
+      "deleted": "{type}を削除しました"
+    },
+    "sb": {
+      "title": "分镜分解",
+      "segmentStat": "{n} セグメント · {dur}s",
+      "rebreak": "再分解",
+      "startBreak": "分割してプロンプト生成",
+      "promptProgress": "プロンプト {done}/{total}",
+      "promptSelected": "選択分のプロンプト生成({n})",
+      "batchPrompts": "一括でプロンプトを補完",
+      "listTitle": "分镜一覧",
+      "listSub": "分解の説明と紐付いたキャラクター・シーンを確認",
+      "select": "選択",
+      "selectAll": "すべて選択",
+      "selectMissing": "不足分のみ",
+      "clear": "クリア",
+      "selectedCount": "{n} 件選択中",
+      "generatingProgress": "生成中 {done}/{total}",
+      "generateSelected": "動画プロンプト生成({n})",
+      "shotN": "分镜 #{n}",
+      "totalCount": "全 {n} 件",
+      "duration": "長さ",
+      "descSection": "分镜説明",
+      "descLabel": "画面説明",
+      "descHint": "【ショット1】【ショット2】…と子ショットごとに記述。セリフは「キャラクター名のセリフ：「セリフ」」、ナレーションは「ナレーション：内容」",
+      "descPlaceholder": "分镜の画面説明",
+      "atmosphere": "雰囲気",
+      "atmospherePlaceholder": "光、色調、空気感、環境の雰囲気",
+      "videoPromptSection": "動画プロンプト",
+      "regenPrompt": "再生成",
+      "aiGenerate": "AI で生成",
+      "videoPromptCopy": "この分镜の画面説明（セリフ/ナレーションを含む）と雰囲気から生成",
+      "videoPromptPlaceholder": "{'@'}名前で画像、#名前で音声を参照。セリフ、話者、カメラの動きを記述…",
+      "breaking": "分镜を分解中...",
+      "emptyTitle": "分镜分解を開始",
+      "emptyDesc": "脚本、キャラクター、シーンをもとにショットへ分解し、分镜説明と紐付け情報を生成します。",
+      "hasVideo": "動画生成済み",
+      "noVideo": "動画未生成",
+      "hasVideoShort": "完成済み",
+      "videoFlag": "動",
+      "noDescription": "画面説明がありません",
+      "zeroChars": "0 キャラクター",
+      "unboundScene": "シーン未紐付け",
+      "breakFirst": "先に分镜を分解してください",
+      "selectedMissing": "選択した分镜が存在しません",
+      "allHavePrompts": "すべての分镜に動画プロンプトがあります",
+      "batchStarted": "{n} 件の分镜の動画プロンプトを生成開始…",
+      "batchDone": "動画プロンプトの一括生成が完了しました",
+      "batchDoneFailed": "動画プロンプトの一括生成が完了しました（{n} 件失敗）",
+      "batchFailed": "動画プロンプトの一括生成に失敗しました",
+      "promptGenerated": "分镜 #{n} の動画プロンプトを生成しました"
+    },
+    "ref": {
+      "title": "参照素材",
+      "copy": "キャラクター / シーン / 小道具を動画参照として紐付け",
+      "boundCount": "{bound}/{total} 紐付け済み",
+      "clickAdd": "クリックで参照に追加",
+      "clickRemove": "クリックで参照から除外",
+      "shortChar": "役",
+      "shortScene": "景",
+      "shortProp": "具",
+      "usable": "参照可能",
+      "notReady": "未生成",
+      "unbound": "未紐付け",
+      "gotoGenerate": "生成へ →",
+      "empty": "この話にはシーン、キャラクター、小道具がまだありません。先に「資産」で素材を抽出すると紐付けできます。"
+    },
+    "vid": {
+      "shotCount": "{n} ショット",
+      "doneCount": "{done}/{total} 生成済み",
+      "batchVideos": "動画一括生成",
+      "emptyTitle": "先に分镜を生成",
+      "emptyDesc": "動画タスクは分镜分解の結果から作られます。先に分镜説明と動画プロンプトを生成してから、動画を一括生成してください。",
+      "lockedModel": "この話の動画モデル：",
+      "listTitle": "動画タスク一覧",
+      "listMeta": "ショット順 · {n} 件のタスク",
+      "metricPending": "{n} 生成中",
+      "metricDone": "{n} 完了",
+      "metricFailed": "{n} 失敗",
+      "references": "参照 {n}",
+      "refCountMeta": "{n} 件の参照素材",
+      "shotN": "ショット #{n}",
+      "playerTitle": "分镜 {n}",
+      "setMain": "メイン動画に設定",
+      "setMainDone": "メイン動画に設定しました",
+      "setMainFailed": "設定に失敗しました",
+      "download": "ダウンロード",
+      "emptyGenerating": "動画を生成中…",
+      "emptyNoVideo": "動画がまだ生成されていません",
+      "emptyGeneratingDesc": "生成完了後、ここでプレビューできます",
+      "emptyNoVideoDesc": "下のボタンでこの分镜の動画を生成します",
+      "generateVideo": "動画を生成",
+      "history": "動画履歴",
+      "current": "現在",
+      "deleteRecord": "この記録を削除",
+      "historyDeleted": "この履歴を削除しました",
+      "needRefOrPrompt": "参照素材または動画プロンプトが少なくとも 1 つ必要です",
+      "generating": "動画を生成中",
+      "genDone": "動画生成が完了しました",
+      "genFailed": "動画生成に失敗しました",
+      "genTimeout": "動画生成がタイムアウトしました",
+      "allDone": "すべてのショット動画が生成済みです",
+      "moderationHint": "実写人物/センシティブ内容の審査で拒否された可能性があります。上部バーで別の動画モデルに切り替えて再試行してください",
+      "resolutionSwitched": "このエピソードの動画解像度を {label} に変更しました",
+      "noneToGenerate": "生成するショットがありません",
+      "batchStarted": "{n} 件の動画生成タスクを開始しました",
+      "retryFailed": "失敗を再試行({n})",
+      "select": "選択",
+      "selectDone": "{n} 件選択 · 完了",
+      "batchSelected": "選択分を生成({n})",
+      "listMetaFiltered": "絞り込み結果 · {n}/{total} 件のタスク",
+      "defaultModel": "デフォルトモデル",
+      "confirmTitle": "動画の一括生成",
+      "confirmShots": "ショット数",
+      "confirmShotsValue": "{n} 件",
+      "confirmTotal": "合計時間",
+      "confirmApprox": "約 {n} 秒",
+      "confirmModel": "動画モデル",
+      "confirmResolution": "解像度",
+      "confirmNote": "上記の設定でショットごとに生成を開始します。失敗したタスクは後で「失敗を再試行」からまとめて再実行できます。",
+      "confirmStart": "生成開始 ({n})",
+      "selectMissing": "未生成を選択",
+      "aspectRatio": "アスペクト比"
+    },
+    "inspector": {
+      "videoPromptPlaceholder": "{'@'}名前で画像、#名前で音声を参照。セリフ、話者、カメラの動きを記述…",
+      "noRefs": "この分镜には参照素材が紐付けられていません",
+      "refMedia": "参照画像 / 動画 / 音声",
+      "imageN": "画像 {n}",
+      "videoN": "動画 {n}",
+      "audioN": "音声 {n}",
+      "uploadRefImage": "参照画像をアップロード ({used}/{limit})",
+      "uploadRefVideo": "参照動画をアップロード ({used}/{limit})",
+      "uploadRefAudio": "参照音声をアップロード ({used}/{limit})",
+      "refAudioHint": "参照音声には参照画像または動画が 1 つ以上必要です",
+      "params": "生成パラメータ",
+      "duration": "分镜の長さ",
+      "durationUnit": "秒（2-30）",
+      "durationHint": "変更すると分镜に即時保存され、リストとバッチ生成にも反映されます",
+      "effective": "{model} · {res} · {dur}秒",
+      "boundRefs": "绑定参照画像",
+      "noBoundRefs": "绑定された素材なし（中央の「参照素材」で绑定）"
+    },
+    "tasks": {
+      "title": "生成タスク一覧",
+      "meta": "作成日時の降順 · {n} 件のタスク",
+      "emptyTitle": "生成タスクがありません",
+      "emptyDesc": "資産、分镜、動画の各ステップで画像/動画生成を実行すると、タスクが自動でここに表示されます。",
+      "duration": "所要 {dur}",
+      "sbN": "分镜 #{n}",
+      "generic": "汎用",
+      "fullMerge": "話全体の結合",
+      "mergeKind": "結合"
+    },
+    "export": {
+      "notReadyDesc": "先に分镜と制作の工程を完了してください",
+      "gotoScript": "脚本へ",
+      "filmList": "完成映像一覧",
+      "countN": "{n} 件",
+      "empty": "完成映像がまだありません。下でショットを選択して「選択分を結合」をクリックしてください",
+      "shotAssets": "ショット素材",
+      "shotStat": "{done}/{total} 生成済み · {selected} 選択中",
+      "clearSelection": "選択をクリア",
+      "selectAllReady": "生成済みをすべて選択",
+      "mergeSelected": "選択分を結合 ({n})",
+      "selectFirst": "動画が生成されたショットを 1 つ以上選択してください",
+      "merging": "結合中…",
+      "mergingToast": "結合中...",
+      "mergeDone": "結合が完了しました",
+      "mergeFailed": "結合に失敗しました",
+      "previewShot": "このショットを再生",
+      "shotPreview": "ショット #{n} プレビュー",
+      "markDone": "完了にする",
+      "markedDone": "完了",
+      "markDoneTitle": "このエピソードの書き出しを手動で完了にします（再クリックで解除）",
+      "markedDoneToast": "完了としてマークしました",
+      "unmarkDoneToast": "完了マークを解除しました"
+    },
+    "image": {
+      "generatingChar": "キャラクター画像を生成中",
+      "generatingScene": "シーン画像を生成中",
+      "generatingProp": "小道具画像を生成中",
+      "batchGeneratingChar": "キャラクター画像を一括生成中",
+      "batchGeneratingScene": "シーン画像を一括生成中",
+      "batchGeneratingProp": "小道具画像を一括生成中",
+      "allCharsDone": "すべてのキャラクター画像が生成済みです",
+      "allScenesDone": "すべてのシーン画像が生成済みです",
+      "allPropsDone": "すべての小道具画像が生成済みです"
+    },
+    "extract": {
+      "done": "{type}の抽出が完了しました",
+      "failed": "{type}の抽出に失敗しました"
+    },
+    "upload": {
+      "assetDone": "{type}をアップロードしました",
+      "refImageFull": "参照画像は上限に達しました（シーン/キャラクター素材を含む）",
+      "refImageDone": "参照画像をアップロードしました",
+      "refMax3": "参照{type}は最大 3 つまで",
+      "refDone": "参照{type}をアップロードしました",
+      "refAudioNeed": "参照音声には参照画像または動画が 1 つ以上必要です",
+      "audio": "音声",
+      "refMax": "参照{type}は最大 {n} つまで"
+    },
+    "viewer": {
+      "imagePreview": "画像プレビュー",
+      "filmPreview": "完成映像プレビュー",
+      "downloadFilm": "完成映像をダウンロード"
+    },
+    "status": {
+      "done": "完了",
+      "generating": "生成中",
+      "failed": "失敗",
+      "todo": "未生成"
+    },
+    "resolution": {
+      "smooth": "標準",
+      "hd": "高画質",
+      "uhd": "超高画質"
+    },
+    "recovery": {
+      "remotePreview": "動画は生成済みですが、まだローカルに保存されていません。オンライン再生または下のリンクをご利用ください。ダウンロード後はローカル動画に切り替わります。",
+      "remoteUnavailable": "オンラインプレビューを読み込めません。リンクを開くか、ダウンロードを再開してください。リンクの有効期限が切れている可能性があります。",
+      "restoreDownload": "ダウンロードを再開",
+      "localDownloadFailed": "生成済み · ダウンロード失敗",
+      "restore": "動画を復旧",
+      "newGeneration": "再生成",
+      "downloadFailed": "動画は生成済みですが配信または保存に失敗しました。復旧してください。",
+      "unknownSubmission": "送信結果が不明です。再生成前に上流のタスクを確認してください。",
+      "downloading": "動画生成済み・ダウンロード中",
+      "diagnostics": "診断情報をコピー",
+      "copied": "診断情報をコピーしました",
+      "confirmNew": "新しい生成タスクを送信します。再度料金が発生する可能性があります。続行しますか？",
+      "restoreFailed": "動画を復旧 ({n})",
+      "transferring": "動画生成済み・転送中",
+      "awaitingDelivery": "動画生成済み・配信待ち",
+      "restoreHint": "既存のタスクを復旧し、重複生成を避けます"
+    }
+  },
+  "errors": {
+    "network": "サーバーに接続できません。ネットワークまたはサービスの起動状態を確認してください",
+    "server": "サーバーから異常な応答が返されました。しばらくしてから再試行してください",
+    "unavailable": "サービスは一時的に利用できません。しばらくしてから再試行してください",
+    "auth": "認証に失敗しました。APIキー設定を確認してください",
+    "rateLimit": "リクエストが多すぎるか、クォータが不足しています。しばらくしてから再試行してください",
+    "timeout": "生成がタイムアウトしました。再試行してください",
+    "moderation": "コンテンツが審査を通過しませんでした。プロンプトを調整するかモデルを切り替えて再試行してください",
+    "requestFailed": "リクエストに失敗しました（{status}）",
+    "unknown": "操作に失敗しました。再試行してください"
+  },
+  "tour": {
+    "next": "次へ",
+    "prev": "戻る",
+    "done": "完了",
+    "helpTitle": "ガイド",
+    "index": {
+      "welcome": {
+        "title": "👋 火宝短劇へようこそ",
+        "desc": "小説 → 脚本 → アセット → 絵コンテ → 動画 → 完成、すべてワンストップ。まず AI サービスを設定し、最初のプロジェクトを作成しましょう。"
+      },
+      "create": {
+        "title": "ステップ 2 · プロジェクト作成",
+        "desc": "「新規プロジェクト」で作品名・アスペクト比（縦横）・作画スタイルを選択します。"
+      },
+      "settings": {
+        "title": "ステップ 1 · AI サービスを設定",
+        "desc": "すべての AI 機能に事前設定が必要です。「設定」ページで Huobao API キーを貼り、テキスト/画像/動画をワンクリック設定しましょう。"
+      }
+    },
+    "settings": {
+      "quick": {
+        "title": "最速セットアップ：クイック設定",
+        "desc": "Huobao API キーを貼り付けると推奨 3 設定（テキスト/画像/動画）を一括書き込み。接続テスト対応。"
+      },
+      "nav": {
+        "title": "すべてここに",
+        "desc": "左でセクション切替：AI サービス、一般（UI と生成言語）、スタイルプリセット、Agent プロンプトとスキル、ストレージ、About。"
+      }
+    },
+    "episode": {
+      "topbar": {
+        "title": "上部バー：モデルと状態",
+        "desc": "テキスト/画像/動画モデルをいつでも切替。解像度と尺はモデルに連動します。"
+      },
+      "script": {
+        "title": "ステップ 1 · 脚本",
+        "desc": "（前提：設定ページで AI サービス設定済み）原文を貼り付けて「AI リライト」で撮影用脚本を生成します。"
+      },
+      "assets": {
+        "title": "ステップ 2 · アセット",
+        "desc": "キャラ/シーン/小道具を抽出し一貫性のある参照画像を生成。動画生成時の参照素材になります。"
+      },
+      "videos": {
+        "title": "ステップ 3 · 動画制作",
+        "desc": "絵コンテ分割 → プロンプト確認 → 一括動画生成。失敗はワンクリック再試行。完了後「連結・書き出し」へ。"
+      },
+      "help": {
+        "title": "いつでも再再生",
+        "desc": "この「?」ボタンでこのページのガイドを再表示できます。良い制作を！"
+      }
+    }
+  }
+}
diff --git a/huobao-source/frontend/app/locales/ko.json b/huobao-source/frontend/app/locales/ko.json
new file mode 100644
index 0000000..9ed8fed
--- /dev/null
+++ b/huobao-source/frontend/app/locales/ko.json
@@ -0,0 +1,988 @@
+{
+  "taskTracking": {
+    "queued": "대기 중",
+    "running": "생성 중",
+    "checking": "확인 중",
+    "reconnecting": "재연결 중",
+    "missing": "확인 필요",
+    "restoreImage": "이미지 복구"
+  },
+  "assetReferences": {
+    "title": "생성 참고 이미지",
+    "add": "참고 이미지 추가",
+    "saving": "저장 중",
+    "preview": "참고 이미지 {n} 미리보기",
+    "remove": "참고 이미지 {n} 제거",
+    "used": "생성 또는 다시 그리기 시 이 순서로 사용합니다.",
+    "empty": "인물, 의상 또는 스타일 참고 이미지를 추가하세요.",
+    "formats": "JPG / PNG / WebP · 장당 20MB 이하 · 최대 6장",
+    "limit": "에셋당 참고 이미지는 최대 6장입니다",
+    "invalid": "장당 20MB 이하의 JPG, PNG 또는 WebP 이미지를 선택하세요",
+    "saved": "생성에 사용할 참고 이미지를 저장했습니다",
+    "removed": "참고 이미지를 제거했습니다",
+    "wait": "참고 이미지를 저장 중입니다. 잠시 기다려 주세요."
+  },
+  "app": {
+    "title": "화바오 숏드라마",
+    "updateAvailable": "새 버전 v{version}을 사용할 수 있습니다. 「설정 → 업데이트 정보」에서 업그레이드하세요"
+  },
+  "characterVoice": {
+    "title": "캐릭터 음색",
+    "forCharacter": "{name}의 음색",
+    "upload": "음색 업로드",
+    "replace": "음색 교체",
+    "remove": "제거",
+    "saving": "저장 중…",
+    "empty": "캐릭터 음색 샘플로 사용할 선명한 음성 녹음을 업로드하세요.",
+    "formats": "MP3 / WAV / M4A / AAC · 최대 20MB",
+    "sample": "음색 샘플",
+    "preview": "{name}의 음색 미리 듣기",
+    "saved": "캐릭터 음색이 저장되었습니다",
+    "removed": "캐릭터 음색이 제거되었습니다",
+    "invalidFormat": "MP3, WAV, M4A 또는 AAC 오디오 파일을 선택하세요",
+    "tooLarge": "오디오 파일은 20MB 이하여야 합니다",
+    "emptyFile": "오디오 파일이 비어 있습니다",
+    "playbackError": "오디오를 재생할 수 없습니다. 파일을 확인하거나 다시 업로드하세요.",
+    "referenceHint": "{'@'}이름으로 외형, 대사에서 #이름으로 음색을 참조하세요. 예: {'@'}민수가 고개를 들고 #민수가 부드럽게 말한다. 샘플당 2~5초, 총 15초 이하를 권장합니다.",
+    "noMatch": "일치하는 음색이 없습니다. 에셋에서 음색을 업로드하고 현재 샷에 캐릭터를 추가하세요."
+  },
+  "common": {
+    "confirm": "확인",
+    "cancel": "취소",
+    "back": "뒤로",
+    "saved": "저장됨",
+    "delete": "삭제",
+    "deleteLoading": "삭제 중...",
+    "deleteFailed": "삭제 실패",
+    "save": "저장",
+    "close": "닫기",
+    "refresh": "새로고침",
+    "add": "추가",
+    "copy": "복사",
+    "download": "다운로드",
+    "default": "기본",
+    "more": "더보기",
+    "loading": "로딩 중…",
+    "listJoin": ", ",
+    "role": "캐릭터",
+    "scene": "장면",
+    "prop": "소품",
+    "reference": "참조",
+    "serviceType": {
+      "text": "텍스트",
+      "image": "이미지",
+      "video": "영상"
+    }
+  },
+  "layout": {
+    "nav": {
+      "projects": "프로젝트",
+      "settings": "설정"
+    },
+    "banner": {
+      "missing": "{types} 모델이 아직 설정되지 않아 AI 기능을 사용할 수 없습니다",
+      "goSettings": "설정으로 이동"
+    },
+    "theme": {
+      "label": "테마 전환",
+      "light": "라이트 모드",
+      "dark": "다크 모드",
+      "system": "시스템 설정 따르기"
+    }
+  },
+  "migrate": {
+    "title": "저장 위치를 변경하는 중입니다",
+    "hint": "마이그레이션 중에는 앱을 닫지 마세요",
+    "phases": {
+      "validating": "대상 디렉터리 확인 중…",
+      "stopping": "백그라운드 서비스 중지 중…",
+      "moving": "데이터 파일 마이그레이션 중…",
+      "movingProgress": "데이터 파일 마이그레이션 중… {copied} / {total}",
+      "config": "저장 설정 업데이트 중…",
+      "restarting": "백그라운드 서비스 재시작 중…",
+      "done": "마이그레이션 완료",
+      "error": "마이그레이션 실패"
+    }
+  },
+  "components": {
+    "mention": {
+      "noMatch": "일치하는 참조가 없습니다",
+      "fallbackGroup": "참조"
+    },
+    "baseSelect": {
+      "placeholder": "선택하세요...",
+      "search": "검색...",
+      "noMatch": "일치하는 결과가 없습니다"
+    },
+    "confirmDialog": {
+      "title": "삭제 확인"
+    },
+    "localeSwitcher": {
+      "label": "UI 언어 전환"
+    },
+    "langSwitch": {
+      "title": "언어를 {lang}(으)로 전환할까요?",
+      "message": "UI 언어와 AI 콘텐츠 언어가 함께 전환됩니다.",
+      "effectUi": "화면 표시가 모두 해당 언어로 전환됩니다",
+      "effectAi": "대본 재작성, 에셋 추출, 스토리보드, 프롬프트 등 AI 생성물이 해당 언어로 변경됩니다(Agent 프롬프트/스킬 동기화)",
+      "effectRefresh": "확인하면 화면이 자동으로 새로고침됩니다",
+      "confirm": "전환 및 새로고침",
+      "refreshing": "언어가 전환되었습니다. 새로고침 중…"
+    }
+  },
+  "composables": {
+    "agent": {
+      "busy": "작업 실행 중",
+      "done": "완료"
+    }
+  },
+  "index": {
+    "hero": {
+      "title": "프로젝트 런처",
+      "sub": "하나의 아이디어에서 한 편의 숏드라마까지, AI가 전 과정을 대신합니다",
+      "projectCount": "프로젝트 {n}개",
+      "activeCount": "{n}개 진행 중",
+      "styleCount": "비주얼 스타일 {n}종"
+    },
+    "create": "새 프로젝트",
+    "searchPlaceholder": "프로젝트 검색",
+    "sortAria": "프로젝트 정렬",
+    "sortUpdated": "최근 업데이트",
+    "sortTitle": "프로젝트 이름",
+    "statusBadgeTitle": "클릭하여 프로젝트 상태 설정",
+    "openProjectAria": "프로젝트 {title} 열기",
+    "openProject": "프로젝트 열기",
+    "deleteProject": "프로젝트 삭제",
+    "projectMeta": "캐릭터 {chars} · 장면 {scenes} · {eps}화",
+    "emptyFilteredTitle": "일치하는 프로젝트가 없습니다",
+    "emptyFilteredDesc": "검색어나 필터 조건을 조정하세요.",
+    "emptyTitle": "첫 번째 숏드라마 프로젝트 만들기",
+    "emptyDesc": "생성 후 화를 선택해 제작을 시작합니다.",
+    "deleted": "삭제됨",
+    "noEpisodes": "에피소드가 없습니다",
+    "episodeN": "제 {n}화",
+    "ratio": {
+      "landscape": "16:9 · 가로",
+      "portrait": "9:16 · 세로",
+      "square": "1:1 · 정사각형",
+      "adaptive": "자동"
+    },
+    "status": {
+      "all": "전체",
+      "draft": "시작 전",
+      "active": "진행 중",
+      "completed": "완료"
+    },
+    "createDialog": {
+      "title": "새 프로젝트",
+      "desc": "생성 후 프로젝트 페이지에서 화를 선택합니다",
+      "name": "프로젝트 이름",
+      "namePlaceholder": "예: 도시 로맨스 드라마 『타임 우체국』",
+      "style": "비주얼 스타일",
+      "stylePlaceholder": "스타일 선택",
+      "aspectRatio": "화면 비율",
+      "aspectRatioPlaceholder": "화면 비율 선택",
+      "aspectRatioHint": "생성 후 고정되며, 영상 생성은 이 비율로 통일됩니다",
+      "submit": "프로젝트 생성"
+    },
+    "deleteDialog": {
+      "title": "프로젝트 삭제",
+      "message": "「{title}」을(를) 삭제하시겠습니까? 하위 에피소드, 스토리보드, 생성 기록이 모두 삭제됩니다. 이 작업은 되돌릴 수 없습니다."
+    },
+    "time": {
+      "justNow": "방금",
+      "minutesAgo": "{n}분 전",
+      "hoursAgo": "{n}시간 전",
+      "daysAgo": "{n}일 전"
+    }
+  },
+  "detail": {
+    "head": {
+      "charCount": "캐릭터 {n}",
+      "sceneCount": "장면 {n}",
+      "epCount": "{n}화",
+      "addEpisode": "화 추가"
+    },
+    "tabs": {
+      "episodes": "에피소드 목록",
+      "assets": "에셋 라이브러리"
+    },
+    "ep": {
+      "statusTitle": "클릭하여 이 화의 상태 설정",
+      "resTitle": "클릭하여 이 화의 영상 해상도 변경",
+      "deleteTitle": "이 화 삭제",
+      "enter": "제작 열기",
+      "scriptReady": "대본 입력됨",
+      "merged": "병합됨",
+      "emptyCreateTitle": "클릭하여 제 1화 만들기",
+      "emptyCreateText": "클릭하여 제 1화 만들기",
+      "addNextTitle": "제 {n}화 추가",
+      "addNextText": "제 {n}화 추가",
+      "episodeN": "제 {n}화",
+      "res720": "720p · 고화질",
+      "res480": "480p · 원활",
+      "resSwitched": "이 화의 영상 해상도가 {res}(으)로 변경되었습니다"
+    },
+    "epCreate": {
+      "title": "새 화 만들기",
+      "titleField": "제목",
+      "titlePlaceholder": "화 번호로 자동 명명",
+      "titleHint": "비워 두면 화 번호로 자동 명명됩니다(예: 「{example}」).",
+      "example": "제 {n}화",
+      "resolution": "영상 해상도",
+      "resolutionPlaceholder": "해상도 선택",
+      "resolutionHint": "생성 후 이 화의 영상은 이 해상도로 생성되며, 이후 화 카드에서도 변경할 수 있습니다.",
+      "lockCopy": "생성 시 현재 활성화된 이미지·영상 생성 기능이 고정됩니다.",
+      "creating": "생성 중...",
+      "create": "생성",
+      "added": "새 화가 추가되었습니다"
+    },
+    "epDelete": {
+      "message": "「{title}」을(를) 삭제하시겠습니까? 목록에서 숨겨지며, 해당 스토리보드와 생성 기록에 더 이상 접근할 수 없습니다."
+    },
+    "assets": {
+      "emptyTitle": "아직 에셋이 없습니다",
+      "emptyDesc": "제작 워크벤치에서 「에셋 추출」로 캐릭터, 장면, 소품을 생성하면 이곳에 자동으로 수집되며, 에셋 이미지도 바로 생성할 수 있습니다.",
+      "emptyKindTitle": "{kind} 에셋이 없습니다",
+      "emptyKindDesc": "워크벤치에서 추출·생성하면 이곳에 표시됩니다.",
+      "todoShort": "미입력"
+    },
+    "mat": {
+      "dialogAria": "에셋 상세",
+      "unnamed": "이름 없음",
+      "propTypePlaceholder": "예: 무기 / 유품",
+      "personaField": "인물 설정",
+      "personaPlaceholder": "성격, 배경, 동기…",
+      "locationPlaceholder": "예: 고궁 태화전",
+      "timePlaceholder": "예: 황혼 / 심야",
+      "finalPromptLabel": "최종 프롬프트",
+      "finalPromptSub": "AI가 정보를 바탕으로 생성. 수동으로 수정 후 저장 가능",
+      "genPromptTitle": "AI로 최종 프롬프트 생성",
+      "needEpisodeFirst": "먼저 「에피소드 목록」에서 1화 이상을 생성하세요",
+      "promptPlaceholder": "「프롬프트 생성」을 클릭해 AI로 생성하거나 직접 입력하세요. 수동으로 저장하면 다음 이미지 생성 시 이 프롬프트가 사용됩니다.",
+      "genImage": "이미지 생성",
+      "saving": "저장 중…",
+      "generating": "{kind} 「{name}」 이미지 생성 중",
+      "genTimeout": "{kind} 「{name}」 생성 시간이 초과되었습니다. 나중에 새로고침해 확인하세요",
+      "uploaded": "{kind} 「{name}」 이미지를 업로드했습니다",
+      "needEpisodeForImage": "에셋 이미지를 생성하려면 먼저 「에피소드 목록」에서 1화 이상을 생성하세요",
+      "needEpisodeForPrompt": "최종 프롬프트를 생성하려면 먼저 「에피소드 목록」에서 1화 이상을 생성하세요",
+      "locationRequired": "장소를 입력하세요"
+    }
+  },
+  "settings": {
+    "groupBase": "기본",
+    "tabs": {
+      "general": "일반",
+      "ai": "AI 서비스",
+      "styles": "스타일 프리셋",
+      "storage": "저장 위치",
+      "about": "업데이트 정보",
+      "agents": "Agent 설정"
+    },
+    "common": {
+      "disabled": "비활성화됨",
+      "custom": "사용자 지정",
+      "empty": "설정이 없습니다"
+    },
+    "general": {
+      "title": "일반",
+      "desc": "앱 전체 설정. 언어 전환은 UI와 AI 생성 콘텐츠 모두에 적용됩니다.",
+      "contentLanguage": "AI 콘텐츠 언어",
+      "contentLanguageSub": "UI와 AI 생성(대본/에셋/스토리보드/프롬프트)에 공통으로 사용되는 언어",
+      "languageLabel": "언어",
+      "languageNote": "전환 시 UI와 AI 콘텐츠 언어가 함께 변경되고 자동으로 새로고침됩니다",
+      "languageHint": "두 진입점(상단 바 언어 버튼 / 여기)은 동일하게 전역 적용됩니다.",
+      "languageSaved": "콘텐츠 언어가 저장되었습니다",
+      "appearance": "화면 모드",
+      "appearanceSub": "인터페이스 색상 테마, 즉시 적용됩니다",
+      "appearanceLabel": "테마 모드",
+      "appearanceNote": "시스템 모드에서는 OS 화면 설정을 자동으로 따릅니다",
+      "appearanceLight": "라이트",
+      "appearanceDark": "다크",
+      "appearanceSystem": "시스템",
+      "languageSavedWith": "AI 콘텐츠 언어가 {lang}(으)로 전환되었습니다. 이후 생성(대본/에셋/스토리보드/프롬프트)에 적용됩니다",
+      "langNameZh": "중국어",
+      "langNameEn": "영어",
+      "langNameJa": "일본어",
+      "langNameKo": "한국어",
+      "unifiedSwitchWarning": "{lang}(으)로 전환되었습니다. UI와 AI 콘텐츠 언어가 함께 변경되며 곧 새로고침됩니다…"
+    },
+    "ai": {
+      "title": "AI 서비스 설정",
+      "desc": "먼저 추천 템플릿으로 설정을 만들고, 서비스 유형별로 미세 조정합니다. 워크벤치에서 화를 생성할 때 선택한 이미지·영상 기능이 고정됩니다.",
+      "quickTitle": "화바오 빠른 설정",
+      "recommended": "추천",
+      "quickDesc": "Huobao API Key를 입력하면 텍스트·이미지·영상 세 개의 추천 설정을 한 번에 작성합니다.",
+      "getKey": "Huobao API Key 받기",
+      "regionCn": "중국",
+      "regionCom": "해외",
+      "applyQuick": "화바오 설정 작성",
+      "manualTitle": "수동 템플릿",
+      "manualDesc": "서비스 유형을 선택하면 추천 `provider / base URL / model`이 템플릿에서 입력됩니다.",
+      "activeCount": "{n}개 활성화됨",
+      "hasKey": "설정됨",
+      "noKey": "키 없음",
+      "currentDefault": "현재 기본 모델",
+      "setDefault": "이 유형의 기본 모델로 설정",
+      "noBaseUrl": "Base URL 미설정",
+      "test": "테스트",
+      "apiKeyRequired": "Huobao API Key를 입력하세요",
+      "quickApplied": "화바오 빠른 설정이 작성되었습니다",
+      "defaultModelSwitched": "기본 {type} 모델이 {model}(으)로 변경되었습니다",
+      "meta": {
+        "text": "대본 재작성, 캐릭터·장면 추출, 스토리보드 분해 등 Agent 텍스트 기능",
+        "image": "캐릭터 이미지, 장면 이미지, 샷 이미지 등 정지 이미지 생성",
+        "video": "샷 영상 직접 생성(기본 Seedance 2.0)"
+      }
+    },
+    "styles": {
+      "title": "스타일 프리셋",
+      "desc": "프로젝트 생성 시 선택하는 비주얼 스타일. 해당 영문 프롬프트 조각은 캐릭터·장면 이미지 생성에 자동 주입됩니다. 비활성화된 스타일은 생성 옵션에 표시되지 않습니다.",
+      "allTitle": "모든 스타일",
+      "count": "{active}개 활성 · 총 {total}개",
+      "empty": "스타일 프리셋이 없습니다"
+    },
+    "storage": {
+      "title": "저장 위치",
+      "desc": "데이터베이스와 생성 파일(이미지/영상/병합/업로드)이 위치한 디렉터리. 위치를 변경하면 백그라운드 서비스가 잠시 중지되고 데이터가 마이그레이션됩니다.",
+      "currentDir": "현재 데이터 디렉터리",
+      "computedAt": "{time} 기준 통계",
+      "changeLocation": "위치 변경",
+      "dataDir": "데이터 디렉터리",
+      "desktopMode": "데스크톱 버전",
+      "serverMode": "서버 모드",
+      "totalUsage": "총 사용량 {size}",
+      "counting": "통계 중…",
+      "breakdown": {
+        "db": "데이터베이스",
+        "images": "이미지",
+        "videos": "영상",
+        "merged": "병합",
+        "uploads": "업로드",
+        "temp": "임시",
+        "other": "기타"
+      },
+      "diskFree": "디스크 여유 {size}",
+      "note": "데이터 디렉터리에는 SQLite 데이터베이스와 모든 생성 미디어가 포함됩니다. Agent 스킬(workspace)은 포함되지 않으며 마이그레이션되지 않습니다.",
+      "serverNote": "서버 배포 시 STORAGE_PATH / SQLITE_PATH 환경 변수로 저장 위치를 설정하고, 재시작 후 적용됩니다.",
+      "loadFailed": "저장 정보를 불러오지 못했습니다"
+    },
+    "about": {
+      "title": "업데이트 정보",
+      "desc": "릴리스 매니페스트에서 새 버전을 가져와 로컬에서 sha256을 검증한 후 패키지를 교체하고 재시작합니다. 사용자 데이터와 설정은 시스템 데이터 디렉터리에 저장되며 업데이트의 영향을 받지 않습니다.",
+      "currentVersion": "현재 버전 v{v}",
+      "latestVersion": "최신 버전 v{v}",
+      "check": "업데이트 확인",
+      "webMode": "현재 브라우저/서버 모드이므로 인앱 업데이트는 데스크톱 버전에서만 사용할 수 있습니다.",
+      "upToDate": "최신 버전입니다",
+      "found": "새 버전 v{v}을(를) 사용할 수 있습니다",
+      "downloading": "다운로드 중 {p}%",
+      "download": "업데이트 다운로드",
+      "ready": "업데이트 패키지가 준비되었습니다",
+      "readyDesc": "클릭하면 앱을 종료하고 자동으로 설치한 후 다시 엽니다.",
+      "restartInstall": "재시작 및 설치",
+      "checkFailed": "확인 실패",
+      "retry": "재시도",
+      "empty": "「업데이트 확인」을 클릭하여 최신 버전을 가져옵니다.",
+      "note": "설명: macOS에서는 디렉터리 교체로 업데이트됩니다(Tauri와 동일한 방식, Apple 서명 불필요). Windows에서는 설치 프로그램이 무음 설치됩니다.",
+      "checkFailedToast": "업데이트 확인에 실패했습니다",
+      "downloadDone": "업데이트 패키지 다운로드가 완료되었습니다. 설치할 수 있습니다",
+      "downloadFailed": "다운로드 실패",
+      "installFailed": "설치 실패",
+      "serverApply": "지금 업데이트",
+      "serverApplyStarted": "업데이트가 시작되었습니다: Watchtower가 새 이미지를 받아 컨테이너를 재생성합니다. 몇 분 후 페이지를 새로고침하세요",
+      "serverApplyFailed": "업데이트 시작 실패",
+      "serverManualHint": "서버 배포: 배포 디렉터리에서 다음을 실행하세요",
+      "serverNote": "참고: Watchtower가 설정된 Docker 배포에서는 원클릭 업데이트(새 이미지 pull + 컨테이너 재생성)가 가능합니다. 미설정 시 안낸된 명령을 직접 실행하세요."
+    },
+    "agents": {
+      "promptHint": "{file}(으)로 저장",
+      "promptPlaceholder": "Agent 시스템 프롬프트...",
+      "reset": "기본값으로 복원",
+      "promptReset": "기본 프롬프트로 복원되었습니다(prompt 파일 삭제됨)",
+      "saved": "{agent} 설정이 저장되었습니다",
+      "scriptRewriter": "대본 재작성",
+      "extractor": "캐릭터·장면 추출",
+      "storyboardBreaker": "스토리보드 분해",
+      "promptGenerator": "프롬프트 생성",
+      "langFallback": "중국어로 폴백",
+      "followContentLang": "편집 언어: {lang} (일반 → AI 콘텐츠 언어에서 전환)"
+    },
+    "skills": {
+      "agentList": "Agent 목록",
+      "desc": "Skills는 Agent의 고급 프롬프트 레이어로만 사용되며, 워크벤치의 일반 기능 진입점에는 영향을 주지 않습니다.",
+      "add": "Skill 추가",
+      "emptyTitle": "Skill이 없습니다",
+      "emptyDesc": "오른쪽 위의 「Skill 추가」를 클릭하여 첫 번째 프롬프트 파일을 만드세요",
+      "contentPlaceholder": "SKILL.md 내용 작성...",
+      "addTitle": "Skill 추가 — {agent}",
+      "dirName": "Skill 디렉터리 이름",
+      "dirNameHint": "영문, 고유",
+      "dirNamePlaceholder": "예: custom-extraction",
+      "name": "이름",
+      "namePlaceholder": "예: 사용자 정의 추출 규칙",
+      "description": "설명",
+      "descPlaceholder": "이 Skill의 용도를 간단히 기술",
+      "create": "생성",
+      "created": "Skill이 생성되었습니다"
+    },
+    "cfg": {
+      "editTitle": "서비스 설정 편집",
+      "addTitle": "{type} 서비스 추가",
+      "sub": "먼저 템플릿을 선택하면 적절한 `Base URL`과 기본 모델이 자동으로 입력됩니다.",
+      "name": "설정 이름",
+      "namePlaceholder": "예: 화바오 기본 이미지 서비스",
+      "provider": "제공업체",
+      "providerPlaceholder": "제공업체 선택",
+      "priority": "우선순위",
+      "priorityHint": "숫자가 클수록 우선입니다. 워크벤치는 같은 유형의 활성 설정 중 우선순위가 가장 높은 것을 사용합니다.",
+      "models": "모델",
+      "modelsHint": "첫 번째 항목이 기본 모델입니다. 태그 클릭 시 맨 앞으로 이동하며, 쉼표/줄바꿈 일괄 붙여넣기를 지원합니다",
+      "modelPlaceholder": "모델 이름 입력 후 Enter로 추가",
+      "modelChipHint": "클릭하여 기본값으로 설정(맨 앞으로)",
+      "tempHint": "비워 두면 제공업체 기본값을 따름",
+      "tempPlaceholder": "예: 0.6",
+      "tempNote": "온도가 고정된 모델(예: kimi-k2 계열은 0.6만 허용)이 있습니다. invalid temperature 오류가 발생하면 여기에 값을 입력하세요.",
+      "test": "설정 테스트",
+      "reachable": "엔드포인트가 응답했습니다",
+      "unreachable": "엔드포인트 테스트에 실패했습니다",
+      "providerRequired": "제공업체를 선택하세요",
+      "tempInvalid": "Temperature는 0~2 사이의 숫자여야 합니다"
+    },
+    "styleDialog": {
+      "editTitle": "스타일 프리셋 편집",
+      "addTitle": "스타일 프리셋 추가",
+      "sub": "프롬프트 조각은 영문이며, 캐릭터·장면 이미지 생성 시 프롬프트에 자동으로 추가됩니다.",
+      "tag": "스타일",
+      "name": "스타일 이름",
+      "namePlaceholder": "예: 3D, 애니메, 실사 영화",
+      "key": "스타일 key",
+      "keyPlaceholder": "예: 3d, anime(소문자/숫자/하이픈)",
+      "keyHint": "프로젝트에 저장되는 스타일 식별자. 생성 후에는 변경할 수 없습니다.",
+      "prompt": "프롬프트 조각(영문)",
+      "promptPlaceholder": "예: anime style, cel shading, vibrant colors, clean line art",
+      "description": "설명",
+      "descPlaceholder": "이 스타일의 용도를 한 줄로",
+      "sort": "정렬",
+      "required": "이름, key, 프롬프트 조각은 필수입니다"
+    },
+    "migrate": {
+      "title": "저장 위치 변경",
+      "newDir": "새 디렉터리",
+      "dataToMove": "마이그레이션할 데이터",
+      "sizeNote": "약 {size}",
+      "freeNote": " · 대상 디스크 여유 {size}",
+      "moveFiles": "기존 데이터 마이그레이션(데이터베이스 및 모든 생성 파일)",
+      "emptyWarn": "경고: 앱이 새로운 빈 데이터베이스로 시작됩니다. 이전 디렉터리의 데이터는 보존되지만 더 이상 사용되지 않습니다.",
+      "note": "마이그레이션 중 백그라운드 서비스가 잠시 중지되고 진행 중인 생성 작업이 중단됩니다. 완료 후 페이지가 자동으로 새로고침됩니다.",
+      "start": "마이그레이션 시작",
+      "pickFailed": "디렉터리 선택에 실패했습니다",
+      "failed": "마이그레이션에 실패하여 원래 저장 위치로 복원되었습니다"
+    },
+    "styleDelete": {
+      "title": "스타일 프리셋 삭제",
+      "message": "스타일 「{name}」을(를) 삭제하시겠습니까? 사용 중인 프로젝트에는 영향이 없지만, 삭제된 기본 제공 스타일은 재시작 시 복원될 수 있습니다. 「비활성화」를 권장합니다."
+    },
+    "skillDelete": {
+      "title": "Skill 삭제",
+      "message": "Skill 「{id}」을(를) 삭제하시겠습니까? 해당 Agent는 기본 제공 프롬프트로 돌아갑니다."
+    }
+  },
+  "episode": {
+    "topbar": {
+      "back": "프로젝트로 돌아가기",
+      "episodeN": "제 {n}화",
+      "meta": "캐릭터 {roles} · 세그먼트 {shots}",
+      "tasks": "작업",
+      "viewFilm": "완성 영상 보기",
+      "continue": "제작 계속",
+      "start": "제작 시작",
+      "resolution": "해상도"
+    },
+    "model": {
+      "defaultWith": "기본 · {model}",
+      "notConfigured": "미설정"
+    },
+    "sidebar": {
+      "inProgress": "진행 중",
+      "refreshData": "데이터 새로고침",
+      "collapse": "사이드바 접기",
+      "expand": "사이드바 펼치기"
+    },
+    "nav": {
+      "prev": "이전",
+      "next": "다음",
+      "toExport": "납출로 이동"
+    },
+    "stage": {
+      "script": "대본",
+      "scriptDesc": "내용 재작성 및 정리",
+      "production": "제작",
+      "assets": "에셋",
+      "assetsDesc": "캐릭터 / 장면 / 소품",
+      "videos": "영상 제작",
+      "videosDesc": "스토리보드 분해 및 영상 생성",
+      "export": "납출",
+      "exportDesc": "병합하여 영상 출력",
+      "mergeExport": "병합 납출",
+      "scriptStage": "대본 단계 · {step}",
+      "prodStage": "제작 단계 · {step}",
+      "exportDone": "납출 단계 · 완료",
+      "exportWaiting": "납출 단계 · 병합 대기",
+      "workbench": "워크벤치"
+    },
+    "script": {
+      "raw": "원문",
+      "rewrite": "AI 재작성",
+      "charCount": "{n}자",
+      "saved": "저장되었습니다",
+      "rawPlaceholder": "소설 원문, 스토리 개요, 스토리보드 메모를 붙여넣기...",
+      "skipRewrite": "재작성 건거이",
+      "rewriteAgain": "다시 재작성",
+      "emptyTitle": "AI로 형식화된 대본으로 재작성",
+      "emptyDesc": "AI로 원문을 형식화된 대본으로 정리하거나, 이 단계를 건거이서 에셋 제작으로 바로 진행할 수 있습니다.",
+      "startRewrite": "재작성 시작",
+      "rewriting": "대본을 재작성하는 중...",
+      "scriptPlaceholder": "형식화된 대본 내용...",
+      "rawRequired": "먼저 원문을 입력하세요",
+      "skipDone": "AI 재작성을 건거이습니다. 원문을 그대로 사용합니다"
+    },
+    "prod": {
+      "assets": "에셋 제작",
+      "videos": "영상 제작",
+      "notReady": "아직 준비되지 않았습니다",
+      "readyCount": "{ready}/{total} 준비 완료",
+      "extract": "{type} 추출",
+      "reextract": "{type} 재추출",
+      "batchChar": "캐릭터 일괄",
+      "batchScene": "장면 일괄",
+      "batchProp": "소품 일괄",
+      "extractingTypes": "{types} 추출 중...",
+      "extractingTypesDots": "{types} 추출 중…",
+      "emptyTitle": "에셋 추출 시작",
+      "emptyDesc": "캐릭터, 장면, 소품은 추출 후 이곳에 표시됩니다. 개별로 추출하거나 일괄 병렬 추출할 수 있습니다.",
+      "startExtract": "추출 시작",
+      "scriptFirst": "먼저 대본을 완성하세요",
+      "goBack": "처리로 돌아가기"
+    },
+    "asset": {
+      "fallbackType": "에셋",
+      "typeChar": "캐릭터 에셋",
+      "typeScene": "장면 에셋",
+      "typeProp": "소품 에셋",
+      "detailTitle": "{type} 상세",
+      "delChar": "캐릭터 삭제",
+      "delScene": "장면 삭제",
+      "delProp": "소품 삭제",
+      "charImageTitle": "{name} 캐릭터 이미지",
+      "sceneImageTitle": "{name} 장면 이미지",
+      "propImageTitle": "{name} 소품 이미지",
+      "portraitReady": "이미지 생성됨",
+      "portraitPending": "이미지 생성 중",
+      "portraitTodo": "이미지 미생성",
+      "ready": "생성됨",
+      "generating": "생성 중",
+      "todo": "미생성",
+      "regen": "다시 생성",
+      "generate": "생성",
+      "upload": "업로드",
+      "uploadCharImage": "캐릭터 이미지 업로드",
+      "uploadSceneImage": "장면 이미지 업로드",
+      "uploadPropImage": "소품 이미지 업로드",
+      "uploadImage": "이미지 업로드",
+      "appearance": "외모: ",
+      "styling": "스타일링: ",
+      "lighting": "조명 · ",
+      "appearanceTodo": "외모 미입력",
+      "stylingTodo": "스타일링 미입력",
+      "sceneDescTodo": "장면 설명 미입력",
+      "sceneLightTodo": "장면 조명 미입력",
+      "noDescription": "설명이 없습니다",
+      "noTime": "시간 미설정",
+      "finalPromptTurnaround": "최종 프롬프트 · 삼면 도",
+      "finalPromptFixed": "최종 프롬프트 · 고정 시점",
+      "finalPromptWhiteBg": "최종 프롬프트 · 흰 배경 단품",
+      "finalPromptAutoTurnaround": "첫 이미지 생성 시 프롬프트 Agent가 자동 생성",
+      "finalPromptAutoFixed": "첫 이미지 생성 시 프롬프트 Agent가 자동 생성(전경/중경/후경)",
+      "finalPromptAutoWhiteBg": "첫 이미지 생성 시 프롬프트 Agent가 자동 생성(흰 배경 단품)",
+      "propsEmpty": "이 화에 스토리상 중요한 소품이 없습니다",
+      "visualPreview": "비주얼 미리보기",
+      "kindLabel": "유형",
+      "charPortrait": "캐릭터 이미지",
+      "sceneImage": "장면 이미지",
+      "roleLabel": "역할",
+      "propTypeLabel": "소품 유형",
+      "timeLabel": "시간",
+      "editInfo": "정보 편집",
+      "editHintChar": "외모와 스타일링은 캐릭터 이미지에 영향을 줍니다",
+      "editHintProp": "물품의 외형은 소품 이미지에 영향을 줍니다",
+      "editHintScene": "공간과 조명은 장면 이미지에 영향을 줍니다",
+      "appearanceOfObject": "물품 외형",
+      "appearancePlaceholder": "재질, 색상, 형상, 크기, 신구 정도, 마모 흔적 등",
+      "appearanceField": "외모",
+      "appearanceFieldPlaceholder": "나이 감각, 이목구비, 체형, 분위기 등",
+      "stylingField": "스타일링",
+      "stylingFieldPlaceholder": "헤어스타일, 의상, 메이크업, 액세서리 등",
+      "sceneDescField": "장면 설명",
+      "sceneDescPlaceholder": "공간, 인테리어, 시대 질감, 주요 시각 요소 등",
+      "sceneLightField": "장면 조명",
+      "sceneLightPlaceholder": "광원, 색조, 명암, 분위기 등",
+      "genPrompt": "프롬프트 생성",
+      "regenPrompt": "다시 생성",
+      "genPortrait": "이미지 생성",
+      "regenPortrait": "이미지 다시 생성",
+      "genScene": "장면 생성",
+      "regenScene": "장면 다시 생성",
+      "genProp": "소품 이미지 생성",
+      "regenProp": "소품 이미지 다시 생성",
+      "promptPlaceholderChar": "삼면 도 최종 프롬프트를 직접 작성하거나, 「프롬프트 생성」으로 Agent가 생성하게 합니다",
+      "promptPlaceholderScene": "고정 시점 최종 프롬프트를 직접 작성하거나, 「프롬프트 생성」으로 Agent가 생성하게 합니다",
+      "promptPlaceholderProp": "흰 배경 단품 최종 프롬프트를 직접 작성하거나, 「프롬프트 생성」으로 Agent가 생성하게 합니다",
+      "promptHintChar": "프롬프트는 직접 편집할 수 있으며 저장 후 적용됩니다. 외모나 스타일링을 변경하고 저장하면 최종 프롬프트가 지워지며, 다음 이미지 생성 시 프롬프트 Agent가 다시 생성합니다.",
+      "promptHintScene": "프롬프트는 직접 편집할 수 있으며 저장 후 적용됩니다. 장면 설명이나 조명을 변경하고 저장하면 최종 프롬프트가 지워지며, 다음 장면 이미지 생성 시 프롬프트 Agent가 다시 생성합니다.",
+      "promptHintProp": "프롬프트는 직접 편집할 수 있으며 저장 후 적용됩니다. 물품 외형을 변경하고 저장하면 최종 프롬프트가 지워지며, 다음 소품 이미지 생성 시 프롬프트 Agent가 다시 생성합니다.",
+      "generatingPrompt": "최종 프롬프트 생성 중…",
+      "promptGenerated": "최종 프롬프트가 생성되었습니다",
+      "promptRegenerated": "최종 프롬프트가 다시 생성되었습니다",
+      "promptGenFailedRetry": "최종 프롬프트 생성에 실패했습니다. 다시 시도하세요",
+      "promptGenFailed": "최종 프롬프트 생성에 실패했습니다",
+      "promptCopied": "최종 프롬프트가 복사되었습니다",
+      "copyFailed": "복사에 실패했습니다. 텍스트를 직접 선택해 복사하세요",
+      "noChanges": "저장할 변경 사항이 없습니다",
+      "saved": "변경 사항이 저장되었습니다",
+      "saveFailed": "저장에 실패했습니다",
+      "saveChanges": "변경 사항 저장",
+      "unnamedChar": "이름 없는 캐릭터",
+      "unnamedProp": "이름 없는 소품",
+      "unnamedScene": "이름 없는 장면",
+      "propSingleImage": "소품 단품 이미지",
+      "propImage": "소품 이미지"
+    },
+    "create": {
+      "title": "{type} 추가",
+      "name": "이름",
+      "namePlaceholderChar": "캐릭터 이름",
+      "namePlaceholderProp": "소품 이름",
+      "roleField": "캐릭터 역할",
+      "rolePlaceholder": "예: 주인공 / 악역 / 조연",
+      "appearancePlaceholder": "외형 특징(성격도 포함 가능)",
+      "stylingPlaceholder": "의상, 메이크업, 액세서리",
+      "location": "장소",
+      "locationPlaceholder": "장면 장소",
+      "time": "시간",
+      "timePlaceholder": "예: 낮 / 밤",
+      "sceneDescPlaceholder": "환경, 인테리어, 분위기",
+      "lightPlaceholder": "예: 황혼의 따뜻한 조명, 차가운 탑라이트",
+      "typeField": "유형",
+      "typePlaceholder": "예: 무기 / 유품 / 문서",
+      "appearanceOnlyPlaceholder": "물품의 외형만 기술(다른 요소는 불필요)",
+      "locationRequired": "장면 장소를 입력하세요",
+      "nameRequired": "이름을 입력하세요",
+      "created": "{type}이(가) 추가되었습니다"
+    },
+    "delete": {
+      "title": "{type} 삭제",
+      "message": "{type} 「{name}」을(를) 삭제하시겠습니까? 이 작품의 모든 화에서 제거됩니다.",
+      "deleted": "{type}이(가) 삭제되었습니다"
+    },
+    "sb": {
+      "title": "스토리보드 분해",
+      "segmentStat": "세그먼트 {n}개 · {dur}초",
+      "rebreak": "다시 분해",
+      "startBreak": "분할 및 프롬프트 생성",
+      "promptProgress": "프롬프트 {done}/{total}",
+      "promptSelected": "선택분 프롬프트 생성({n})",
+      "batchPrompts": "일괄 프롬프트 채우기",
+      "listTitle": "스토리보드 목록",
+      "listSub": "분해 설명과 연결된 캐릭터·장면 확인",
+      "select": "선택",
+      "selectAll": "모두 선택",
+      "selectMissing": "누락분만",
+      "clear": "지우기",
+      "selectedCount": "{n}개 선택됨",
+      "generatingProgress": "생성 중 {done}/{total}",
+      "generateSelected": "영상 프롬프트 생성({n})",
+      "shotN": "스토리보드 #{n}",
+      "totalCount": "총 {n}개",
+      "duration": "길이",
+      "descSection": "스토리보드 설명",
+      "descLabel": "화면 설명",
+      "descHint": "【샷1】【샷2】…로 하위 샷마다 기술. 대사는 「캐릭터명의 대사: 「대사」」, 나레이션은 「나레이션: 내용」",
+      "descPlaceholder": "스토리보드 화면 설명",
+      "atmosphere": "분위기",
+      "atmospherePlaceholder": "조명, 색조, 공기감, 환경 분위기",
+      "videoPromptSection": "영상 프롬프트",
+      "regenPrompt": "다시 생성",
+      "aiGenerate": "AI로 생성",
+      "videoPromptCopy": "이 스토리보드의 화면 설명(대사/나레이션 포함)과 분위기를 바탕으로 생성",
+      "videoPromptPlaceholder": "{'@'}이름으로 이미지, #이름으로 음색을 참조하고 대사, 화자, 카메라 움직임을 설명하세요…",
+      "breaking": "스토리보드 분해 중...",
+      "emptyTitle": "스토리보드 분해 시작",
+      "emptyDesc": "대본, 캐릭터, 장면을 바탕으로 샷으로 분해하여 스토리보드 설명과 연결 정보를 생성합니다.",
+      "hasVideo": "영상 생성됨",
+      "noVideo": "영상 미생성",
+      "hasVideoShort": "완성됨",
+      "videoFlag": "영",
+      "noDescription": "화면 설명이 없습니다",
+      "zeroChars": "캐릭터 0명",
+      "unboundScene": "장면 미연결",
+      "breakFirst": "먼저 스토리보드를 분해하세요",
+      "selectedMissing": "선택한 스토리보드가 존재하지 않습니다",
+      "allHavePrompts": "모든 스토리보드에 영상 프롬프트가 있습니다",
+      "batchStarted": "{n}개 스토리보드의 영상 프롬프트 생성 시작…",
+      "batchDone": "영상 프롬프트 일괄 생성이 완료되었습니다",
+      "batchDoneFailed": "영상 프롬프트 일괄 생성이 완료되었습니다({n}개 실패)",
+      "batchFailed": "영상 프롬프트 일괄 생성에 실패했습니다",
+      "promptGenerated": "스토리보드 #{n}의 영상 프롬프트가 생성되었습니다"
+    },
+    "ref": {
+      "title": "참조 소재",
+      "copy": "캐릭터 / 장면 / 소품을 영상 참조로 연결",
+      "boundCount": "{bound}/{total} 연결됨",
+      "clickAdd": "클릭하여 참조에 추가",
+      "clickRemove": "클릭하여 참조에서 제외",
+      "shortChar": "역",
+      "shortScene": "경",
+      "shortProp": "품",
+      "usable": "참조 가능",
+      "notReady": "미생성",
+      "unbound": "미연결",
+      "gotoGenerate": "생성하러 가기 →",
+      "empty": "이 화에는 장면, 캐릭터, 소품이 아직 없습니다. 먼저 「에셋」에서 소재를 추출하면 연결할 수 있습니다."
+    },
+    "vid": {
+      "shotCount": "샷 {n}개",
+      "doneCount": "{done}/{total} 생성됨",
+      "batchVideos": "영상 일괄 생성",
+      "emptyTitle": "먼저 스토리보드 생성",
+      "emptyDesc": "영상 작업은 스토리보드 분해 결과에서 만들어집니다. 먼저 스토리보드 설명과 영상 프롬프트를 생성한 후 영상을 일괄 생성하세요.",
+      "lockedModel": "이 화의 영상 모델: ",
+      "listTitle": "영상 작업 목록",
+      "listMeta": "샷 순서 · 작업 {n}개",
+      "metricPending": "{n} 생성 중",
+      "metricDone": "{n} 완료",
+      "metricFailed": "{n} 실패",
+      "references": "참조 {n}",
+      "refCountMeta": "참조 소재 {n}개",
+      "shotN": "샷 #{n}",
+      "playerTitle": "스토리보드 {n}",
+      "setMain": "메인 영상으로 설정",
+      "setMainDone": "메인 영상으로 설정되었습니다",
+      "setMainFailed": "설정에 실패했습니다",
+      "download": "다운로드",
+      "emptyGenerating": "영상 생성 중…",
+      "emptyNoVideo": "영상이 아직 생성되지 않았습니다",
+      "emptyGeneratingDesc": "생성이 완료되면 여기서 미리 볼 수 있습니다",
+      "emptyNoVideoDesc": "아래 버튼으로 이 스토리보드의 영상을 생성합니다",
+      "generateVideo": "영상 생성",
+      "history": "영상 기록",
+      "current": "현재",
+      "deleteRecord": "이 기록 삭제",
+      "historyDeleted": "이 기록이 삭제되었습니다",
+      "needRefOrPrompt": "참조 소재 또는 영상 프롬프트가 최소 1개 필요합니다",
+      "generating": "영상 생성 중",
+      "genDone": "영상 생성이 완료되었습니다",
+      "genFailed": "영상 생성에 실패했습니다",
+      "genTimeout": "영상 생성 시간이 초과되었습니다",
+      "allDone": "모든 샷 영상이 생성되었습니다",
+      "moderationHint": "실사 인물/민감 콘텐츠 심사에 걸렸을 수 있습니다. 상단 바에서 다른 영상 모델로 전환 후 다시 시도하세요",
+      "resolutionSwitched": "이 에피소드의 영상 해상도가 {label}(으)로 변경되었습니다",
+      "noneToGenerate": "생성할 샷이 없습니다",
+      "batchStarted": "{n}개의 영상 생성 작업을 시작했습니다",
+      "retryFailed": "실패 재시도({n})",
+      "select": "선택",
+      "selectDone": "{n}개 선택 · 완료",
+      "batchSelected": "선택 항목 생성({n})",
+      "listMetaFiltered": "필터 결과 · {n}/{total}개 작업",
+      "defaultModel": "기본 모델",
+      "confirmTitle": "영상 일괄 생성",
+      "confirmShots": "샷 수",
+      "confirmShotsValue": "{n}개",
+      "confirmTotal": "총 길이",
+      "confirmApprox": "약 {n}초",
+      "confirmModel": "영상 모델",
+      "confirmResolution": "해상도",
+      "confirmNote": "위 설정으로 샷별로 생성을 시작합니다. 실패한 작업은 나중에 「실패 재시도」로 한 번에 다시 실행할 수 있습니다.",
+      "confirmStart": "생성 시작 ({n})",
+      "selectMissing": "미생성 선택",
+      "aspectRatio": "화면 비율"
+    },
+    "inspector": {
+      "videoPromptPlaceholder": "{'@'}이름으로 이미지, #이름으로 음색을 참조하고 대사, 화자, 카메라 움직임을 설명하세요…",
+      "noRefs": "이 스토리보드에는 참조 소재가 연결되어 있지 않습니다",
+      "refMedia": "참조 이미지 / 영상 / 오디오",
+      "imageN": "이미지 {n}",
+      "videoN": "영상 {n}",
+      "audioN": "오디오 {n}",
+      "uploadRefImage": "참조 이미지 업로드 ({used}/{limit})",
+      "uploadRefVideo": "참조 영상 업로드 ({used}/{limit})",
+      "uploadRefAudio": "참조 오디오 업로드 ({used}/{limit})",
+      "refAudioHint": "참조 오디오에는 참조 이미지 또는 영상이 1개 이상 필요합니다",
+      "params": "생성 파라미터",
+      "duration": "분镜 길이",
+      "durationUnit": "초(2-30)",
+      "durationHint": "수정 시 스토리보드에 즉시 저장되어 목록 및 배치 생성에도 적용됩니다",
+      "effective": "{model} · {res} · {dur}초",
+      "boundRefs": "바인딩 참조 이미지",
+      "noBoundRefs": "바인딩된 에셋 없음（중앙 \"참조 에셋\"에서 바인딩）"
+    },
+    "tasks": {
+      "title": "생성 작업 목록",
+      "meta": "생성 시간 역순 · 작업 {n}개",
+      "emptyTitle": "생성 작업이 없습니다",
+      "emptyDesc": "에셋, 스토리보드, 영상 각 단계에서 이미지/영상 생성을 실행하면 작업이 자동으로 여기에 표시됩니다.",
+      "duration": "소요 {dur}",
+      "sbN": "스토리보드 #{n}",
+      "generic": "일반",
+      "fullMerge": "화 전체 병합",
+      "mergeKind": "병합"
+    },
+    "export": {
+      "notReadyDesc": "먼저 스토리보드와 제작 단계를 완료하세요",
+      "gotoScript": "대본으로 이동",
+      "filmList": "완성 영상 목록",
+      "countN": "{n}개",
+      "empty": "완성 영상이 아직 없습니다. 아래에서 샷을 선택하고 「선택분 병합」을 클릭하세요",
+      "shotAssets": "샷 소재",
+      "shotStat": "{done}/{total} 생성됨 · {selected}개 선택됨",
+      "clearSelection": "선택 지우기",
+      "selectAllReady": "생성된 것 모두 선택",
+      "mergeSelected": "선택분 병합 ({n})",
+      "selectFirst": "영상이 생성된 샷을 1개 이상 선택하세요",
+      "merging": "병합 중…",
+      "mergingToast": "병합 중...",
+      "mergeDone": "병합이 완료되었습니다",
+      "mergeFailed": "병합에 실패했습니다",
+      "previewShot": "이 샷 재생",
+      "shotPreview": "샷 #{n} 미리보기",
+      "markDone": "완료로 표시",
+      "markedDone": "완료됨",
+      "markDoneTitle": "이 에피소드의 납출을 수동으로 완료 표시(다시 클릭하면 해제)",
+      "markedDoneToast": "완료로 표시했습니다",
+      "unmarkDoneToast": "완료 표시를 해제했습니다"
+    },
+    "image": {
+      "generatingChar": "캐릭터 이미지 생성 중",
+      "generatingScene": "장면 이미지 생성 중",
+      "generatingProp": "소품 이미지 생성 중",
+      "batchGeneratingChar": "캐릭터 이미지 일괄 생성 중",
+      "batchGeneratingScene": "장면 이미지 일괄 생성 중",
+      "batchGeneratingProp": "소품 이미지 일괄 생성 중",
+      "allCharsDone": "모든 캐릭터 이미지가 생성되었습니다",
+      "allScenesDone": "모든 장면 이미지가 생성되었습니다",
+      "allPropsDone": "모든 소품 이미지가 생성되었습니다"
+    },
+    "extract": {
+      "done": "{type} 추출이 완료되었습니다",
+      "failed": "{type} 추출에 실패했습니다"
+    },
+    "upload": {
+      "assetDone": "{type}을(를) 업로드했습니다",
+      "refImageFull": "참조 이미지가 상한에 도달했습니다(장면/캐릭터 소재 포함)",
+      "refImageDone": "참조 이미지를 업로드했습니다",
+      "refMax3": "참조 {type}은(는) 최대 3개까지",
+      "refDone": "참조 {type}을(를) 업로드했습니다",
+      "refAudioNeed": "참조 오디오에는 참조 이미지 또는 영상이 1개 이상 필요합니다",
+      "audio": "오디오",
+      "refMax": "참조 {type}은(는) 최대 {n}개까지"
+    },
+    "viewer": {
+      "imagePreview": "이미지 미리보기",
+      "filmPreview": "완성 영상 미리보기",
+      "downloadFilm": "완성 영상 다운로드"
+    },
+    "status": {
+      "done": "완료",
+      "generating": "생성 중",
+      "failed": "실패",
+      "todo": "미생성"
+    },
+    "resolution": {
+      "smooth": "표준",
+      "hd": "고화질",
+      "uhd": "초고화질"
+    },
+    "recovery": {
+      "remotePreview": "영상이 생성되었지만 아직 로컬에 저장되지 않았습니다. 온라인으로 재생하거나 아래 링크를 여세요. 다운로드가 완료되면 로컬 영상으로 전환됩니다.",
+      "remoteUnavailable": "온라인 미리보기를 불러올 수 없습니다. 링크를 열거나 다운로드를 재개하세요. 링크가 만료되었을 수 있습니다.",
+      "restoreDownload": "다운로드 재개",
+      "localDownloadFailed": "생성됨 · 다운로드 실패",
+      "restore": "영상 복구",
+      "newGeneration": "다시 생성",
+      "downloadFailed": "영상은 생성되었지만 전달 또는 저장에 실패했습니다. 복구해 주세요.",
+      "unknownSubmission": "제출 결과가 불확실합니다. 다시 생성하기 전에 원본 작업을 확인하세요.",
+      "downloading": "영상 생성 완료, 다운로드 중",
+      "diagnostics": "진단 정보 복사",
+      "copied": "진단 정보를 복사했습니다",
+      "confirmNew": "새 생성 작업을 제출하며 추가 요금이 발생할 수 있습니다. 계속할까요?",
+      "restoreFailed": "영상 복구 ({n})",
+      "transferring": "영상 생성 완료, 전송 중",
+      "awaitingDelivery": "영상 생성 완료, 전달 대기 중",
+      "restoreHint": "기존 작업을 복구하여 중복 생성을 방지하세요"
+    }
+  },
+  "errors": {
+    "network": "서버에 연결할 수 없습니다. 네트워크 또는 서버 실행 상태를 확인하세요",
+    "server": "서버가 비정상적인 응답을 반환했습니다. 잠시 후 다시 시도하세요",
+    "unavailable": "서비스를 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도하세요",
+    "auth": "인증에 실패했습니다. API 키 설정을 확인하세요",
+    "rateLimit": "요청이 너무 많거나 할당량이 부족합니다. 잠시 후 다시 시도하세요",
+    "timeout": "생성 시간이 초과되었습니다. 다시 시도하세요",
+    "moderation": "콘텐츠가 심사를 통과하지 못했습니다. 프롬프트를 조정하거나 모델을 변경해 다시 시도하세요",
+    "requestFailed": "요청 실패（{status}）",
+    "unknown": "작업에 실패했습니다. 다시 시도하세요"
+  },
+  "tour": {
+    "next": "다음",
+    "prev": "이전",
+    "done": "완료",
+    "helpTitle": "가이드",
+    "index": {
+      "welcome": {
+        "title": "👋 휘바오 숏드라마에 오신 것을 환영합니다",
+        "desc": "소설 → 대본 → 에셋 → 스토리보드 → 영상 → 완성, 모두 한곳에서. 먼저 AI 서비스를 설정하고 첫 프로젝트를 만들어 보세요."
+      },
+      "create": {
+        "title": "2단계 · 프로젝트 생성",
+        "desc": "\"새 프로젝트\"에서 작품명, 화면 비율(가로/세로), 화풍을 선택합니다."
+      },
+      "settings": {
+        "title": "1단계 · AI 서비스 설정",
+        "desc": "모든 AI 기능에 사전 설정이 필요합니다. 설정 페이지에서 Huobao API 키를 붙여넣어 텍스트/이미지/영상을 한 번에 설정하세요."
+      }
+    },
+    "settings": {
+      "quick": {
+        "title": "가장 빠른 설정: 빠른 설정",
+        "desc": "Huobao API 키를 붙여넣으면 추천 설정 3종(텍스트/이미지/영상)을 한 번에 등록합니다. 연결 테스트 지원."
+      },
+      "nav": {
+        "title": "모든 설정이 여기에",
+        "desc": "왼쪽에서 섹션 전환: AI 서비스, 일반(UI·생성 언어), 스타일 프리셋, Agent 프롬프트와 스킬, 저장소, 정보."
+      }
+    },
+    "episode": {
+      "topbar": {
+        "title": "상단 바: 모델과 상태",
+        "desc": "텍스트/이미지/영상 모델을 언제든 전환. 해상도와 길이는 모델에 연동됩니다."
+      },
+      "script": {
+        "title": "1단계 · 대본",
+        "desc": "(전제: 설정 페이지에서 AI 서비스 설정 완료) 원문을 붙여넣고 \"AI 재작성\"으로 촬영용 대본을 생성합니다."
+      },
+      "assets": {
+        "title": "2단계 · 에셋",
+        "desc": "캐릭터/장면/소품을 추출하고 일관성 있는 참조 이미지를 생성합니다. 영상 생성 시 참조 소재로 사용됩니다."
+      },
+      "videos": {
+        "title": "3단계 · 영상 제작",
+        "desc": "스토리보드 분할 → 프롬프트 확인 → 일괄 영상 생성. 실패는 원클릭 재시도. 완료 후 병합·내보내기."
+      },
+      "help": {
+        "title": "언제든 다시 보기",
+        "desc": "이 \"?\" 버튼으로 이 페이지의 가이드를 다시 재생할 수 있습니다. 즐거운 제작 되세요!"
+      }
+    }
+  }
+}
diff --git a/huobao-source/frontend/app/locales/zh.json b/huobao-source/frontend/app/locales/zh.json
new file mode 100644
index 0000000..c26545e
--- /dev/null
+++ b/huobao-source/frontend/app/locales/zh.json
@@ -0,0 +1,989 @@
+{
+  "taskTracking": {
+    "queued": "排队中",
+    "running": "生成中",
+    "checking": "核对中",
+    "reconnecting": "连接中",
+    "missing": "待核对",
+    "restoreImage": "恢复图片"
+  },
+  "assetReferences": {
+    "title": "生图参考图",
+    "add": "添加参考图",
+    "saving": "保存中",
+    "preview": "预览参考图 {n}",
+    "remove": "移除参考图 {n}",
+    "used": "生成／重绘时自动使用，按顺序作为参考图。",
+    "empty": "上传人物、造型或风格参考，生成／重绘时使用。",
+    "formats": "JPG / PNG / WebP · 单张 ≤ 20MB · 最多 6 张",
+    "limit": "每个资产最多 6 张参考图",
+    "invalid": "请选择有效的 JPG、PNG 或 WebP 图片，单张不超过 20MB",
+    "saved": "参考图已保存，生成／重绘时会自动使用",
+    "removed": "已移除参考图",
+    "wait": "参考图保存中，请稍后生成"
+  },
+  "app": {
+    "title": "火宝短剧",
+    "updateAvailable": "发现新版本 v{version}，可在「设置 → 关于更新」中升级"
+  },
+  "characterVoice": {
+    "title": "角色音色",
+    "forCharacter": "{name}的角色音色",
+    "upload": "上传音色",
+    "replace": "替换音色",
+    "remove": "移除",
+    "saving": "保存中…",
+    "empty": "上传一段清晰的人声，作为角色的音色样本。",
+    "formats": "MP3 / WAV / M4A / AAC · 最大 20MB",
+    "sample": "音色样本",
+    "preview": "试听{name}的音色",
+    "saved": "角色音色已保存",
+    "removed": "已移除角色音色",
+    "invalidFormat": "请选择 MP3、WAV、M4A 或 AAC 音频文件",
+    "tooLarge": "音频文件不能超过 20MB",
+    "emptyFile": "音频文件不能为空",
+    "playbackError": "音频无法播放，请检查文件或重新上传。",
+    "referenceHint": "用 {'@'}角色名引用形象，在对白处用 #角色名引用音色，例如：{'@'}林小雨抬头，#林小雨轻声说。音色建议每段 2–5 秒，总计不超过 15 秒。",
+    "noMatch": "未找到音色，请先在资产制作中上传角色音色，并将角色绑定到当前分镜。"
+  },
+  "common": {
+    "confirm": "确认",
+    "cancel": "取消",
+    "back": "返回",
+    "saved": "已保存",
+    "delete": "删除",
+    "deleteLoading": "删除中...",
+    "deleteFailed": "删除失败",
+    "save": "保存",
+    "close": "关闭",
+    "refresh": "刷新",
+    "add": "新增",
+    "copy": "复制",
+    "download": "下载",
+    "default": "默认",
+    "more": "更多",
+    "loading": "加载中…",
+    "listJoin": "、",
+    "role": "角色",
+    "scene": "场景",
+    "prop": "道具",
+    "reference": "参考",
+    "serviceType": {
+      "text": "文本",
+      "image": "图片",
+      "video": "视频"
+    }
+  },
+  "layout": {
+    "nav": {
+      "projects": "项目",
+      "settings": "设置"
+    },
+    "banner": {
+      "missing": "尚未配置{types}模型,AI 功能无法使用",
+      "goSettings": "前往设置"
+    },
+    "theme": {
+      "label": "切换主题",
+      "light": "浅色模式",
+      "dark": "深色模式",
+      "system": "跟随系统"
+    }
+  },
+  "migrate": {
+    "title": "正在切换存储位置",
+    "hint": "迁移期间请勿关闭应用",
+    "phases": {
+      "validating": "正在校验目标目录…",
+      "stopping": "正在停止后台服务…",
+      "moving": "正在迁移数据文件…",
+      "movingProgress": "正在迁移数据文件… {copied} / {total}",
+      "config": "正在更新存储配置…",
+      "restarting": "正在重启后台服务…",
+      "done": "迁移完成",
+      "error": "迁移失败"
+    }
+  },
+  "components": {
+    "mention": {
+      "noMatch": "无匹配的参考",
+      "fallbackGroup": "参考"
+    },
+    "baseSelect": {
+      "placeholder": "请选择...",
+      "search": "搜索...",
+      "noMatch": "无匹配结果"
+    },
+    "confirmDialog": {
+      "title": "确认删除"
+    },
+    "localeSwitcher": {
+      "label": "切换界面语言"
+    },
+    "langSwitch": {
+      "title": "切换语言为 {lang}？",
+      "message": "界面语言与 AI 内容语言将同步切换。",
+      "effectUi": "界面文案全部切换为该语言",
+      "effectAi": "剧本改写、资产提取、分镜、提示词等 AI 产出改用该语言（Agent 提示词/技能同步）",
+      "effectRefresh": "确认后界面会自动刷新",
+      "confirm": "切换并刷新",
+      "refreshing": "语言已切换，正在刷新…"
+    }
+  },
+  "composables": {
+    "agent": {
+      "busy": "操作执行中",
+      "done": "完成"
+    }
+  },
+  "index": {
+    "hero": {
+      "title": "项目启动台",
+      "sub": "从一个创意到一部短剧，AI 全流程为你代工",
+      "projectCount": "{n} 个项目",
+      "activeCount": "{n} 进行中",
+      "styleCount": "{n} 种视觉风格"
+    },
+    "create": "新建项目",
+    "searchPlaceholder": "搜索项目",
+    "sortAria": "项目排序",
+    "sortUpdated": "最近更新",
+    "sortTitle": "项目名称",
+    "statusBadgeTitle": "点击标记项目状态",
+    "openProjectAria": "打开项目 {title}",
+    "openProject": "打开项目",
+    "deleteProject": "删除项目",
+    "projectMeta": "{chars} 角色 · {scenes} 场景 · {eps} 集",
+    "emptyFilteredTitle": "没有匹配的项目",
+    "emptyFilteredDesc": "调整搜索词或筛选条件。",
+    "emptyTitle": "新建第一个短剧项目",
+    "emptyDesc": "创建后选择集开始制作。",
+    "deleted": "已删除",
+    "noEpisodes": "暂无剧集",
+    "episodeN": "第 {n} 集",
+    "ratio": {
+      "landscape": "16:9 · 横屏",
+      "portrait": "9:16 · 竖屏",
+      "square": "1:1 · 方形",
+      "adaptive": "自适应"
+    },
+    "status": {
+      "all": "全部",
+      "draft": "待开始",
+      "active": "进行中",
+      "completed": "已完成"
+    },
+    "createDialog": {
+      "title": "新建项目",
+      "desc": "创建后进入项目页选择集",
+      "name": "项目名称",
+      "namePlaceholder": "例如：都市情感短剧《时光邮局》",
+      "style": "视觉风格",
+      "stylePlaceholder": "选择风格",
+      "aspectRatio": "画面比例",
+      "aspectRatioPlaceholder": "选择画面比例",
+      "aspectRatioHint": "创建后固定，视频生成将统一使用该比例",
+      "submit": "创建项目"
+    },
+    "deleteDialog": {
+      "title": "删除项目",
+      "message": "确定删除「{title}」？项目下的剧集、分镜与生成记录将一并删除，此操作不可恢复。"
+    },
+    "time": {
+      "justNow": "刚刚",
+      "minutesAgo": "{n} 分钟前",
+      "hoursAgo": "{n} 小时前",
+      "daysAgo": "{n} 天前"
+    }
+  },
+  "detail": {
+    "head": {
+      "charCount": "{n} 角色",
+      "sceneCount": "{n} 场景",
+      "epCount": "{n} 集",
+      "addEpisode": "添加集"
+    },
+    "tabs": {
+      "episodes": "剧集列表",
+      "assets": "素材库"
+    },
+    "ep": {
+      "statusTitle": "点击标记本集状态",
+      "resTitle": "点击修改本集视频分辨率",
+      "deleteTitle": "删除本集",
+      "enter": "进入制作",
+      "scriptReady": "剧本已录入",
+      "merged": "已合成",
+      "emptyCreateTitle": "点击创建第一集",
+      "emptyCreateText": "点击创建第一集",
+      "addNextTitle": "添加第 {n} 集",
+      "addNextText": "添加第 {n} 集",
+      "episodeN": "第 {n} 集",
+      "res720": "720p · 高清",
+      "res480": "480p · 流畅",
+      "resSwitched": "本集视频分辨率已切换为 {res}"
+    },
+    "epCreate": {
+      "title": "创建新集",
+      "titleField": "标题",
+      "titlePlaceholder": "默认按集数自动命名",
+      "titleHint": "留空时会自动按集数命名，例如“{example}”。",
+      "example": "第 {n} 集",
+      "resolution": "视频分辨率",
+      "resolutionPlaceholder": "选择分辨率",
+      "resolutionHint": "创建后本集视频按此分辨率生成，之后仍可在集卡片上修改。",
+      "lockCopy": "创建后自动锁定当前启用的图片与视频生成能力。",
+      "creating": "创建中...",
+      "create": "创建",
+      "added": "已添加新集"
+    },
+    "epDelete": {
+      "message": "确定删除「{title}」？删除后不可在列表中查看，其分镜与生成记录将不再可访问。"
+    },
+    "assets": {
+      "emptyTitle": "还没有任何素材",
+      "emptyDesc": "在剧情工作台中通过「提取资产」生成角色、场景与道具后，会自动收录到这里，并可直接生成素材图。",
+      "emptyKindTitle": "暂无{kind}素材",
+      "emptyKindDesc": "在剧情工作台中提取并生成{kind}后，会显示在这里。",
+      "todoShort": "待补充"
+    },
+    "mat": {
+      "dialogAria": "素材详情",
+      "unnamed": "未命名",
+      "propTypePlaceholder": "如：武器 / 信物",
+      "personaField": "人物设定",
+      "personaPlaceholder": "性格、背景、动机…",
+      "locationPlaceholder": "如：故宫太和殿",
+      "timePlaceholder": "如：黄昏 / 深夜",
+      "finalPromptLabel": "最终提示词",
+      "finalPromptSub": "由 AI 根据信息生成，可手动修改后保存",
+      "genPromptTitle": "由 AI 生成最终提示词",
+      "needEpisodeFirst": "请先在「剧集列表」创建至少一集",
+      "promptPlaceholder": "点击「生成提示词」由 AI 根据信息生成，或在此手动填写。手动修改并保存后，下次生成图片将使用此提示词。",
+      "genImage": "生成图片",
+      "saving": "保存中…",
+      "generating": "{kind}「{name}」图片生成中",
+      "genTimeout": "{kind}「{name}」生成超时，可稍后刷新查看",
+      "uploaded": "{kind}「{name}」图片已上传",
+      "needEpisodeForImage": "请先在「剧集列表」创建至少一集，才能生成素材图",
+      "needEpisodeForPrompt": "请先在「剧集列表」创建至少一集，才能生成最终提示词",
+      "locationRequired": "请填写地点"
+    }
+  },
+  "settings": {
+    "groupBase": "基础",
+    "tabs": {
+      "general": "通用",
+      "ai": "AI 服务",
+      "styles": "风格预设",
+      "storage": "存储位置",
+      "about": "关于更新",
+      "agents": "Agent 配置"
+    },
+    "common": {
+      "disabled": "已停用",
+      "custom": "自定义",
+      "empty": "暂无配置"
+    },
+    "general": {
+      "title": "通用",
+      "desc": "应用级通用设置。语言切换同时作用于界面与 AI 生成内容。",
+      "contentLanguage": "AI 内容语言",
+      "contentLanguageSub": "界面与 AI 产出（剧本/资产/分镜/提示词）统一使用的语言",
+      "languageLabel": "语言",
+      "languageNote": "切换后界面与 AI 内容语言同步更新，并自动刷新",
+      "languageHint": "两处入口（顶栏语言按钮 / 此处）等价，切换即全局生效。",
+      "languageSaved": "内容语言已保存",
+      "appearance": "外观",
+      "appearanceSub": "界面颜色主题，即时生效",
+      "appearanceLabel": "主题模式",
+      "appearanceNote": "跟随系统时，随操作系统外观自动切换",
+      "appearanceLight": "浅色",
+      "appearanceDark": "深色",
+      "appearanceSystem": "跟随系统",
+      "languageSavedWith": "AI 内容语言已切换为 {lang}，后续生成（剧本/资产/分镜/提示词）将使用该语言",
+      "langNameZh": "中文",
+      "langNameEn": "English",
+      "langNameJa": "日本語",
+      "langNameKo": "한국어",
+      "unifiedSwitchWarning": "已切换为 {lang}，界面与 AI 内容语言将同步更新，即将刷新…"
+    },
+    "ai": {
+      "title": "AI 服务配置",
+      "desc": "先用推荐模板快速落配置，再按服务类型微调。工作台创建集时会锁定所选图片和视频能力。",
+      "quickTitle": "火宝快捷配置",
+      "recommended": "推荐",
+      "quickDesc": "输入 Huobao API Key，一次写入文本、图片、视频三条推荐配置。",
+      "getKey": "前往火宝获取 Key",
+      "regionCn": "国内",
+      "regionCom": "国外",
+      "applyQuick": "写入火宝配置",
+      "manualTitle": "手动模板",
+      "manualDesc": "选择服务类型后，直接用模板填充推荐的 `provider / base URL / model`。",
+      "activeCount": "{n} 已启用",
+      "hasKey": "已配置",
+      "noKey": "无密钥",
+      "currentDefault": "当前默认模型",
+      "setDefault": "设为该类型默认模型",
+      "noBaseUrl": "未设置 Base URL",
+      "test": "测试",
+      "apiKeyRequired": "请填写 Huobao API Key",
+      "quickApplied": "火宝快捷配置已写入",
+      "defaultModelSwitched": "默认{type}模型已切换为 {model}",
+      "meta": {
+        "text": "剧本改写、角色场景提取、分镜拆解等 Agent 文本能力",
+        "image": "角色图、场景图与镜头图等静态图像生成",
+        "video": "镜头视频生成，使用当前启用的模型配置"
+      }
+    },
+    "styles": {
+      "title": "风格预设",
+      "desc": "创建项目时选择的视觉风格，其英文提示词片段会自动注入角色图与场景图生成。停用的风格不出现在创建选项中。",
+      "allTitle": "全部风格",
+      "count": "{active} 个启用 · {total} 个总计",
+      "empty": "暂无风格预设"
+    },
+    "storage": {
+      "title": "存储位置",
+      "desc": "数据库与生成文件（图片/视频/拼接/上传）所在的目录。更改位置会短暂停止后台服务并迁移数据。",
+      "currentDir": "当前数据目录",
+      "computedAt": "统计于 {time}",
+      "changeLocation": "更改位置",
+      "dataDir": "数据目录",
+      "desktopMode": "桌面版",
+      "serverMode": "服务器模式",
+      "totalUsage": "总占用 {size}",
+      "counting": "统计中…",
+      "breakdown": {
+        "db": "数据库",
+        "images": "图片",
+        "videos": "视频",
+        "merged": "拼接",
+        "uploads": "上传",
+        "temp": "临时",
+        "other": "其他"
+      },
+      "diskFree": "磁盘剩余 {size}",
+      "note": "数据目录包含 SQLite 数据库与全部生成媒体；Agent 技能（workspace）不在此列，不随迁移。",
+      "serverNote": "服务器部署请通过 STORAGE_PATH / SQLITE_PATH 环境变量配置存储位置，改后重启服务生效。",
+      "loadFailed": "加载存储信息失败"
+    },
+    "about": {
+      "title": "关于更新",
+      "desc": "从发布清单拉取新版本，本地 sha256 校验后自动换包重启。用户数据与配置保存在系统数据目录，不受更新影响。",
+      "currentVersion": "当前版本 v{v}",
+      "latestVersion": "最新版本 v{v}",
+      "check": "检查更新",
+      "webMode": "当前为浏览器 / 服务器模式，应用内更新仅桌面版可用。",
+      "upToDate": "已是最新版本",
+      "found": "发现新版本 v{v}",
+      "downloading": "下载中 {p}%",
+      "download": "下载更新",
+      "ready": "更新包已就绪",
+      "readyDesc": "点击后将退出应用并自动完成安装，随后重新打开。",
+      "restartInstall": "重启并安装",
+      "checkFailed": "检查失败",
+      "retry": "重试",
+      "empty": "点击「检查更新」获取最新版本。",
+      "note": "说明：macOS 上更新通过目录替换完成（与 Tauri 同类方案），无需 Apple 签名；Windows 上下载安装器静默安装。",
+      "checkFailedToast": "检查更新失败",
+      "downloadDone": "更新包下载完成，可以安装",
+      "downloadFailed": "下载失败",
+      "installFailed": "安装失败",
+      "serverApply": "立即更新",
+      "serverApplyStarted": "已触发更新：Watchtower 将拉取新镜像并重建容器，请几分钟后刷新页面",
+      "serverApplyFailed": "触发更新失败",
+      "serverManualHint": "服务器部署：请在部署目录执行",
+      "serverNote": "说明：Docker 部署配置了 Watchtower 时可一键更新（拉取新镜像并重建容器）；未配置时请按提示手动执行更新命令。"
+    },
+    "agents": {
+      "promptHint": "保存为 {file}",
+      "promptPlaceholder": "Agent 系统提示词...",
+      "reset": "恢复默认",
+      "promptReset": "已恢复默认提示词（prompt 文件已删除）",
+      "saved": "{agent} 配置已保存",
+      "scriptRewriter": "剧本改写",
+      "extractor": "角色场景提取",
+      "storyboardBreaker": "分镜拆解",
+      "promptGenerator": "提示词",
+      "langFallback": "跟随中文",
+      "followContentLang": "编辑语言跟随：{lang}（在「通用 → AI 内容语言」切换）"
+    },
+    "skills": {
+      "agentList": "Agent 列表",
+      "desc": "Skills 仅作为 Agent 的高级提示词层使用，不影响工作台常规功能入口。",
+      "add": "新增 Skill",
+      "emptyTitle": "暂无 Skill",
+      "emptyDesc": "点击右上角「新增 Skill」创建第一个提示词文件",
+      "contentPlaceholder": "编写 SKILL.md 内容...",
+      "addTitle": "新增 Skill — {agent}",
+      "dirName": "Skill 目录名",
+      "dirNameHint": "英文，唯一",
+      "dirNamePlaceholder": "如 custom-extraction",
+      "name": "名称",
+      "namePlaceholder": "如 自定义提取规则",
+      "description": "描述",
+      "descPlaceholder": "简短描述此 Skill 的用途",
+      "create": "创建",
+      "created": "Skill 创建成功"
+    },
+    "cfg": {
+      "editTitle": "编辑服务配置",
+      "addTitle": "添加{type}服务",
+      "sub": "推荐先选择模板，系统会自动填入更合理的 `Base URL` 与默认模型。",
+      "name": "配置名称",
+      "namePlaceholder": "如 火宝默认图像服务",
+      "provider": "服务商",
+      "providerPlaceholder": "选择服务商",
+      "priority": "优先级",
+      "priorityHint": "数值越高越优先。工作台默认会优先使用同类型里优先级最高的启用配置。",
+      "models": "模型",
+      "modelsHint": "首位为默认模型；点击标签可置顶，输入框支持逗号/换行批量粘贴",
+      "modelPlaceholder": "输入模型名，回车添加",
+      "modelChipHint": "点击设为默认（置顶）",
+      "tempHint": "留空跟随服务商默认",
+      "tempPlaceholder": "如 0.6",
+      "tempNote": "部分模型强制固定温度（如 kimi-k2 系只允许 0.6），报 invalid temperature 错误时在此填入对应值。",
+      "test": "测试配置",
+      "reachable": "端点已响应",
+      "unreachable": "端点未通过测试",
+      "providerRequired": "选择服务商",
+      "tempInvalid": "Temperature 需为 0~2 的数字"
+    },
+    "styleDialog": {
+      "editTitle": "编辑风格预设",
+      "addTitle": "添加风格预设",
+      "sub": "提示词片段为英文，会在生成角色图与场景图时自动拼入提示词。",
+      "tag": "风格",
+      "name": "风格名称",
+      "namePlaceholder": "如 3D、动漫、写实电影",
+      "key": "风格 key",
+      "keyPlaceholder": "如 3d、anime（小写字母/数字/中划线）",
+      "keyHint": "存入项目的风格标识，创建后不可修改。",
+      "prompt": "提示词片段（英文）",
+      "promptPlaceholder": "如 anime style, cel shading, vibrant colors, clean line art",
+      "description": "描述",
+      "descPlaceholder": "一句话说明该风格的适用场景",
+      "sort": "排序",
+      "required": "名称、key、提示词片段必填"
+    },
+    "migrate": {
+      "title": "更改存储位置",
+      "newDir": "新目录",
+      "dataToMove": "待迁移数据",
+      "sizeNote": "约 {size}",
+      "freeNote": " · 目标盘剩余 {size}",
+      "moveFiles": "迁移已有数据（数据库与全部生成文件）",
+      "emptyWarn": "警告：应用将以全新的空数据库启动，旧目录中的数据会保留但不再被使用。",
+      "note": "迁移期间后台服务会短暂停止，进行中的生成任务会被中断；完成后页面自动刷新。",
+      "start": "开始迁移",
+      "pickFailed": "选择目录失败",
+      "failed": "迁移失败，已恢复原存储位置"
+    },
+    "styleDelete": {
+      "title": "删除风格预设",
+      "message": "确定删除风格「{name}」？已使用此风格的项目不受影响，但删除的内置风格重启后可能恢复，建议改用「停用」。"
+    },
+    "skillDelete": {
+      "title": "删除 Skill",
+      "message": "确定删除 Skill「{id}」？删除后对应 Agent 将回退到内置默认提示词。"
+    }
+  },
+  "episode": {
+    "topbar": {
+      "back": "返回项目",
+      "episodeN": "第 {n} 集",
+      "meta": "{roles} 角色 · {shots} 段落",
+      "tasks": "任务",
+      "viewFilm": "查看成片",
+      "continue": "继续制作",
+      "start": "开始制作",
+      "resolution": "分辨率"
+    },
+    "model": {
+      "defaultWith": "默认 · {model}",
+      "notConfigured": "未配置"
+    },
+    "sidebar": {
+      "inProgress": "进行中",
+      "refreshData": "刷新数据",
+      "collapse": "收起侧栏",
+      "expand": "展开侧栏"
+    },
+    "nav": {
+      "prev": "上一步",
+      "next": "下一步",
+      "toExport": "进入导出"
+    },
+    "stage": {
+      "script": "剧本",
+      "scriptDesc": "内容改写与整理",
+      "production": "制作",
+      "assets": "资产",
+      "assetsDesc": "角色 / 场景 / 道具",
+      "videos": "视频制作",
+      "videosDesc": "分镜拆分与视频生成",
+      "export": "导出",
+      "exportDesc": "拼接与成片输出",
+      "mergeExport": "拼接导出",
+      "scriptStage": "剧本阶段 · {step}",
+      "prodStage": "制作阶段 · {step}",
+      "exportDone": "导出阶段 · 已完成",
+      "exportWaiting": "导出阶段 · 等待拼接",
+      "workbench": "工作台"
+    },
+    "script": {
+      "raw": "原始内容",
+      "rewrite": "AI 改写",
+      "charCount": "{n} 字",
+      "saved": "已保存",
+      "rawPlaceholder": "粘贴小说原文、故事大纲或分镜描述...",
+      "skipRewrite": "跳过改写",
+      "rewriteAgain": "重新改写",
+      "emptyTitle": "AI 改写为格式化剧本",
+      "emptyDesc": "你可以先用 AI 把原始内容整理成格式化剧本，也可以跳过这一步，直接进入资产制作。",
+      "startRewrite": "开始改写",
+      "rewriting": "正在改写剧本...",
+      "scriptPlaceholder": "格式化剧本内容...",
+      "rawRequired": "请先填写原始内容",
+      "skipDone": "已跳过 AI 改写，当前将直接使用原始内容"
+    },
+    "prod": {
+      "assets": "资产制作",
+      "videos": "视频制作",
+      "notReady": "尚未准备就绪",
+      "readyCount": "{ready}/{total} 已就绪",
+      "extract": "提取{type}",
+      "reextract": "重提{type}",
+      "batchChar": "批量角色",
+      "batchScene": "批量场景",
+      "batchProp": "批量道具",
+      "extractingTypes": "正在提取{types}...",
+      "extractingTypesDots": "正在提取{types}…",
+      "emptyTitle": "开始提取资产",
+      "emptyDesc": "角色、场景和道具会在提取后显示在这里，可分别单独提取，也可一键并行提取全部。",
+      "startExtract": "开始提取",
+      "scriptFirst": "请先完成剧本编写",
+      "goBack": "返回处理"
+    },
+    "asset": {
+      "fallbackType": "资产",
+      "typeChar": "角色资产",
+      "typeScene": "场景资产",
+      "typeProp": "道具资产",
+      "detailTitle": "{type}详情",
+      "delChar": "删除角色",
+      "delScene": "删除场景",
+      "delProp": "删除道具",
+      "charImageTitle": "{name} 角色形象",
+      "sceneImageTitle": "{name} 场景图",
+      "propImageTitle": "{name} 道具图",
+      "portraitReady": "形象已生成",
+      "portraitPending": "形象生成中",
+      "portraitTodo": "形象待生成",
+      "ready": "已生成",
+      "generating": "生成中",
+      "todo": "待生成",
+      "regen": "重绘",
+      "generate": "生成",
+      "upload": "上传",
+      "uploadCharImage": "上传角色形象图",
+      "uploadSceneImage": "上传场景图",
+      "uploadPropImage": "上传道具图",
+      "uploadImage": "上传图片",
+      "appearance": "样貌：",
+      "styling": "妆造：",
+      "lighting": "光照 · ",
+      "appearanceTodo": "样貌待补充",
+      "stylingTodo": "妆造待补充",
+      "sceneDescTodo": "场景描述待补充",
+      "sceneLightTodo": "场景光影待补充",
+      "noDescription": "暂无描述",
+      "noTime": "未设时间",
+      "finalPromptTurnaround": "最终提示词 · 三视图",
+      "finalPromptFixed": "最终提示词 · 固定视角",
+      "finalPromptWhiteBg": "最终提示词 · 白底单品",
+      "finalPromptAutoTurnaround": "首次生成形象时由提示词 Agent 自动生成",
+      "finalPromptAutoFixed": "首次生成图片时由提示词 Agent 自动生成（前景/中景/后景）",
+      "finalPromptAutoWhiteBg": "首次生成图片时由提示词 Agent 自动生成（白底单品）",
+      "propsEmpty": "本集暂无涉及事态发展的关键道具",
+      "visualPreview": "视觉预览",
+      "kindLabel": "类型",
+      "charPortrait": "角色形象",
+      "sceneImage": "场景图片",
+      "roleLabel": "定位",
+      "propTypeLabel": "道具类型",
+      "timeLabel": "时间",
+      "editInfo": "编辑信息",
+      "editHintChar": "样貌与妆造会影响角色形象",
+      "editHintProp": "物品外貌会影响道具图",
+      "editHintScene": "空间与光影会影响场景图",
+      "appearanceOfObject": "物品外貌",
+      "appearancePlaceholder": "材质、颜色、形状、大小、新旧程度、磨损痕迹等",
+      "appearanceField": "样貌",
+      "appearanceFieldPlaceholder": "年龄感、五官、体态、气质等",
+      "stylingField": "妆造",
+      "stylingFieldPlaceholder": "发型、服装、妆面、配饰等",
+      "sceneDescField": "场景描述",
+      "sceneDescPlaceholder": "空间、陈设、年代质感、关键视觉元素等",
+      "sceneLightField": "场景光影",
+      "sceneLightPlaceholder": "光源、色调、明暗、氛围等",
+      "genPrompt": "生成提示词",
+      "regenPrompt": "重新生成",
+      "genPortrait": "生成形象",
+      "regenPortrait": "重绘形象",
+      "genScene": "生成场景",
+      "regenScene": "重绘场景",
+      "genProp": "生成道具图",
+      "regenProp": "重绘道具图",
+      "promptPlaceholderChar": "可手动编写三视图最终提示词，或点击「生成提示词」由 Agent 生成",
+      "promptPlaceholderScene": "可手动编写固定视角最终提示词，或点击「生成提示词」由 Agent 生成",
+      "promptPlaceholderProp": "可手动编写白底单品最终提示词，或点击「生成提示词」由 Agent 生成",
+      "promptHintChar": "提示词可直接编辑，保存后生效；修改样貌或妆造并保存后，最终提示词将被清空，下次生成形象时由提示词 Agent 重新生成。",
+      "promptHintScene": "提示词可直接编辑，保存后生效；修改场景描述或光影并保存后，最终提示词将被清空，下次生成场景图时由提示词 Agent 重新生成。",
+      "promptHintProp": "提示词可直接编辑，保存后生效；修改物品外貌并保存后，最终提示词将被清空，下次生成道具图时由提示词 Agent 重新生成。",
+      "generatingPrompt": "正在生成最终提示词…",
+      "promptGenerated": "最终提示词已生成",
+      "promptRegenerated": "最终提示词已重新生成",
+      "promptGenFailedRetry": "最终提示词生成失败，请重试",
+      "promptGenFailed": "最终提示词生成失败",
+      "promptCopied": "最终提示词已复制",
+      "copyFailed": "复制失败，请手动选择文本复制",
+      "noChanges": "没有需要保存的修改",
+      "saved": "修改已保存",
+      "saveFailed": "保存失败",
+      "saveChanges": "保存修改",
+      "unnamedChar": "未命名角色",
+      "unnamedProp": "未命名道具",
+      "unnamedScene": "未命名场景",
+      "propSingleImage": "道具单品图",
+      "propImage": "道具图"
+    },
+    "create": {
+      "title": "新增{type}",
+      "name": "名称",
+      "namePlaceholderChar": "角色名称",
+      "namePlaceholderProp": "道具名称",
+      "roleField": "角色定位",
+      "rolePlaceholder": "如：主角 / 反派 / 配角",
+      "appearancePlaceholder": "外貌特征（可融入性格）",
+      "stylingPlaceholder": "服装、妆容、配饰",
+      "location": "地点",
+      "locationPlaceholder": "场景地点",
+      "time": "时间",
+      "timePlaceholder": "如：白天 / 夜晚",
+      "sceneDescPlaceholder": "环境、陈设、氛围",
+      "lightPlaceholder": "如：黄昏暖光、冷清顶光",
+      "typeField": "类型",
+      "typePlaceholder": "如：武器 / 信物 / 文件",
+      "appearanceOnlyPlaceholder": "只描述物品的外观，与其他无关",
+      "locationRequired": "请填写场景地点",
+      "nameRequired": "请填写名称",
+      "created": "已新增{type}"
+    },
+    "delete": {
+      "title": "删除{type}",
+      "message": "确定删除{type}「{name}」吗？将从本剧所有集中移除。",
+      "deleted": "已删除{type}"
+    },
+    "sb": {
+      "title": "分镜拆分",
+      "segmentStat": "{n} 段落 · {dur}s",
+      "rebreak": "重新拆分",
+      "startBreak": "拆分并生成提示词",
+      "promptProgress": "提示词 {done}/{total}",
+      "promptSelected": "生成所选提示词({n})",
+      "batchPrompts": "批量补齐提示词",
+      "listTitle": "分镜列表",
+      "listSub": "检查拆分描述和绑定的角色场景",
+      "select": "选择",
+      "selectAll": "全选",
+      "selectMissing": "仅缺失",
+      "clear": "清空",
+      "selectedCount": "已选 {n} 个",
+      "generatingProgress": "生成中 {done}/{total}",
+      "generateSelected": "生成视频提示词({n})",
+      "shotN": "分镜 #{n}",
+      "totalCount": "共 {n} 个",
+      "duration": "时长",
+      "descSection": "分镜描述",
+      "descLabel": "画面描述",
+      "descHint": "按【镜头1】【镜头2】…逐子镜头描述；台词写「角色名说：「台词」」，旁白写「旁白：内容」",
+      "descPlaceholder": "分镜画面描述",
+      "atmosphere": "氛围",
+      "atmospherePlaceholder": "光线、色调、空气感、环境氛围",
+      "videoPromptSection": "视频提示词",
+      "regenPrompt": "重新生成",
+      "aiGenerate": "AI 生成",
+      "videoPromptCopy": "根据当前分镜的画面描述（含台词/旁白）与氛围生成",
+      "videoPromptPlaceholder": "用 {'@'}角色名引用图片，用 #角色名引用声音；描述台词、说话角色与镜头运动…",
+      "breaking": "正在拆分分镜...",
+      "emptyTitle": "开始拆分分镜",
+      "emptyDesc": "根据剧本、角色和场景拆分镜头，生成分镜描述和绑定信息。",
+      "hasVideo": "已生成视频",
+      "noVideo": "未生成视频",
+      "hasVideoShort": "已出片",
+      "videoFlag": "视",
+      "noDescription": "暂无画面描述",
+      "zeroChars": "0 角色",
+      "unboundScene": "未绑定场景",
+      "breakFirst": "请先拆分分镜",
+      "selectedMissing": "所选分镜不存在",
+      "allHavePrompts": "所有分镜已有视频提示词",
+      "batchStarted": "开始生成 {n} 个分镜的视频提示词…",
+      "batchDone": "视频提示词批量生成完成",
+      "batchDoneFailed": "视频提示词批量生成完成，{n} 个失败",
+      "batchFailed": "视频提示词批量生成失败",
+      "promptGenerated": "分镜 #{n} 视频提示词已生成"
+    },
+    "ref": {
+      "title": "参考素材",
+      "copy": "绑定角色 / 场景 / 道具作为视频参考",
+      "boundCount": "{bound}/{total} 已绑定",
+      "clickAdd": "点击添加为参考",
+      "clickRemove": "点击移出参考",
+      "shortChar": "角",
+      "shortScene": "景",
+      "shortProp": "具",
+      "usable": "可参考",
+      "notReady": "未生成",
+      "unbound": "未绑定",
+      "gotoGenerate": "去生成 →",
+      "empty": "当前集还没有场景、角色或道具，先到「资产」提取素材后即可绑定。"
+    },
+    "vid": {
+      "shotCount": "{n} 个镜头",
+      "doneCount": "{done}/{total} 已生成",
+      "batchVideos": "批量视频",
+      "emptyTitle": "先生成分镜",
+      "emptyDesc": "视频任务来自分镜拆分结果。先生成分镜描述和视频提示词，再批量生成视频。",
+      "lockedModel": "当前集视频模型：",
+      "listTitle": "视频任务列表",
+      "listMeta": "按镜头顺序 · {n} 个任务",
+      "metricPending": "{n} 生成中",
+      "metricDone": "{n} 完成",
+      "metricFailed": "{n} 失败",
+      "references": "参考 {n}",
+      "refCountMeta": "{n} 个参考素材",
+      "shotN": "镜头 #{n}",
+      "playerTitle": "分镜 {n}",
+      "setMain": "设为主视频",
+      "setMainDone": "已设为主视频",
+      "setMainFailed": "设置失败",
+      "download": "下载",
+      "emptyGenerating": "视频生成中…",
+      "emptyNoVideo": "尚未生成视频",
+      "emptyGeneratingDesc": "生成完成后可在此播放预览",
+      "emptyNoVideoDesc": "点击下方按钮为当前分镜生成视频",
+      "generateVideo": "生成视频",
+      "history": "历史视频",
+      "current": "当前",
+      "deleteRecord": "删除该记录",
+      "historyDeleted": "已删除该历史记录",
+      "needRefOrPrompt": "需要至少一个参考素材或视频提示词",
+      "generating": "视频生成中",
+      "genDone": "视频生成完成",
+      "genFailed": "视频生成失败",
+      "genTimeout": "视频生成超时",
+      "allDone": "所有镜头视频已生成",
+      "moderationHint": "疑似真人/敏感内容审核未通过，可在顶栏切换其他视频模型后重试",
+      "resolutionSwitched": "本集视频分辨率已切换为 {label}",
+      "noneToGenerate": "没有可生成的镜头",
+      "batchStarted": "已发起 {n} 个视频生成任务",
+      "retryFailed": "重试失败({n})",
+      "select": "选择",
+      "selectDone": "已选 {n} · 完成",
+      "batchSelected": "生成所选({n})",
+      "listMetaFiltered": "筛选结果 · {n}/{total} 个任务",
+      "defaultModel": "默认模型",
+      "confirmTitle": "批量生成视频",
+      "confirmShots": "镜头数",
+      "confirmShotsValue": "{n} 个",
+      "confirmTotal": "总时长",
+      "confirmApprox": "约 {n}s",
+      "confirmModel": "视频模型",
+      "confirmResolution": "分辨率",
+      "confirmNote": "将按以上配置逐镜头发起生成；失败的任务之后可点「重试失败」一键重跑。",
+      "confirmStart": "开始生成 ({n})",
+      "selectMissing": "选未生成",
+      "aspectRatio": "画面比例"
+    },
+    "inspector": {
+      "videoPromptPlaceholder": "用 {'@'}角色名引用图片，用 #角色名引用声音；描述台词、说话角色与镜头运动…",
+      "noRefs": "当前分镜未绑定参考素材",
+      "refMedia": "参考图片 / 视频 / 音频",
+      "imageN": "图片 {n}",
+      "videoN": "视频 {n}",
+      "audioN": "音频 {n}",
+      "uploadRefImage": "上传参考图片 ({used}/{limit})",
+      "uploadRefVideo": "上传参考视频 ({used}/{limit})",
+      "uploadRefAudio": "上传参考音频 ({used}/{limit})",
+      "refAudioHint": "参考音频需至少 1 个参考图片或视频",
+      "params": "生成参数",
+      "duration": "分镜时长",
+      "durationUnit": "s（2-30）",
+      "durationHint": "修改即保存到分镜，列表与批量生成同步生效",
+      "effective": "{model} · {res} · {dur}s",
+      "boundRefs": "绑定参考图",
+      "noBoundRefs": "暂无绑定素材（在中间「参考素材」区点击绑定）"
+    },
+    "tasks": {
+      "title": "生成任务列表",
+      "meta": "按创建时间倒序 · {n} 个任务",
+      "emptyTitle": "暂无生成任务",
+      "emptyDesc": "在资产、分镜或视频步骤中触发图片 / 视频生成后,任务会自动出现在这里。",
+      "duration": "耗时 {dur}",
+      "sbN": "分镜 #{n}",
+      "generic": "通用",
+      "fullMerge": "整集拼接",
+      "mergeKind": "合并"
+    },
+    "export": {
+      "notReadyDesc": "请先完成分镜和制作流程",
+      "gotoScript": "前往剧本",
+      "filmList": "成片列表",
+      "countN": "{n} 个",
+      "empty": "暂无成片，在下方勾选镜头后点击「拼接所选」",
+      "shotAssets": "镜头素材",
+      "shotStat": "{done}/{total} 已生成 · 已选 {selected}",
+      "clearSelection": "清空选择",
+      "selectAllReady": "全选已生成",
+      "mergeSelected": "拼接所选 ({n})",
+      "selectFirst": "请先勾选至少一个已生成视频的镜头",
+      "merging": "拼接中…",
+      "mergingToast": "拼接中...",
+      "mergeDone": "拼接完成",
+      "mergeFailed": "拼接失败",
+      "previewShot": "播放该镜头",
+      "shotPreview": "镜头 #{n} 预览",
+      "markDone": "标记完成",
+      "markedDone": "已完成",
+      "markDoneTitle": "手动标记本集导出完成（可再次点击取消）",
+      "markedDoneToast": "已标记为完成",
+      "unmarkDoneToast": "已取消完成标记"
+    },
+    "image": {
+      "generatingChar": "角色图片生成中",
+      "generatingScene": "场景图片生成中",
+      "generatingProp": "道具图片生成中",
+      "batchGeneratingChar": "角色图片批量生成中",
+      "batchGeneratingScene": "场景图片批量生成中",
+      "batchGeneratingProp": "道具图片批量生成中",
+      "allCharsDone": "所有角色图片已生成",
+      "allScenesDone": "所有场景图片已生成",
+      "allPropsDone": "所有道具图片已生成"
+    },
+    "extract": {
+      "done": "{type}提取完成",
+      "failed": "{type}提取失败"
+    },
+    "upload": {
+      "assetDone": "{type}已上传",
+      "refImageFull": "参考图片已达上限（含场景/角色素材）",
+      "refImageDone": "参考图片已上传",
+      "refMax3": "参考{type}最多 3 个",
+      "refDone": "参考{type}已上传",
+      "refAudioNeed": "参考音频需要至少 1 个参考图片或视频",
+      "audio": "音频",
+      "refMax": "参考{type}最多 {n} 个"
+    },
+    "viewer": {
+      "imagePreview": "图片预览",
+      "filmPreview": "成片预览",
+      "downloadFilm": "下载成片"
+    },
+    "status": {
+      "done": "已完成",
+      "generating": "生成中",
+      "failed": "失败",
+      "todo": "待生成"
+    },
+    "resolution": {
+      "smooth": "流畅",
+      "hd": "高清",
+      "uhd": "超清"
+    },
+    "recovery": {
+      "remotePreview": "视频已生成，暂未保存到本地。可在线播放或打开下方链接，下载完成后自动切换本地视频。",
+      "remoteUnavailable": "在线预览无法加载，可尝试打开链接或恢复下载；链接可能已过期。",
+      "restoreDownload": "恢复下载",
+      "localDownloadFailed": "已生成 · 本地下载失败",
+      "restore": "恢复视频",
+      "newGeneration": "重新生成",
+      "downloadFailed": "视频已生成，交付或保存失败，请恢复视频",
+      "unknownSubmission": "提交结果待确认，请先核对上游记录",
+      "downloading": "视频已生成，下载中",
+      "diagnostics": "复制诊断信息",
+      "copied": "诊断信息已复制",
+      "confirmNew": "重新生成会提交新的任务，可能再次计费。确定继续吗？",
+      "restoreFailed": "恢复视频({n})",
+      "transferring": "视频已生成，转存中",
+      "awaitingDelivery": "视频已生成，等待交付",
+      "restoreHint": "恢复已有任务，避免重复生成"
+    }
+  },
+  "errors": {
+    "network": "无法连接服务器，请检查网络或服务是否已启动",
+    "server": "服务返回异常，请稍后重试",
+    "unavailable": "服务暂时不可用，请稍后重试",
+    "gpu1Busy": "GPU1（ComfyUI 8189）暂不可用：旧节点任务或显存尚未释放。可改选 GPU2／GPU3，或稍后重试。",
+    "auth": "鉴权失败，请检查 API Key 配置",
+    "rateLimit": "请求过于频繁或额度不足，请稍后重试",
+    "timeout": "生成超时，请重试",
+    "moderation": "内容未通过审核，请调整提示词或切换模型后重试",
+    "requestFailed": "请求失败（{status}）",
+    "unknown": "操作失败，请重试"
+  },
+  "tour": {
+    "next": "下一步",
+    "prev": "上一步",
+    "done": "完成",
+    "helpTitle": "使用引导",
+    "index": {
+      "welcome": {
+        "title": "👋 欢迎使用火宝短剧",
+        "desc": "小说 → 剧本 → 资产 → 分镜 → 视频 → 成片，一站式 AI 短剧制作。先配置 AI 服务，再创建第一个项目。"
+      },
+      "create": {
+        "title": "第 2 步 · 新建项目",
+        "desc": "点「新建项目」：填写剧名、选择画面比例（横竖屏）与画面风格。"
+      },
+      "settings": {
+        "title": "第 1 步 · 配置 AI 服务",
+        "desc": "所有 AI 功能都要先配置。点这里进「设置」页，粘贴 Huobao API Key 一键完成文本/图片/视频三条配置。"
+      }
+    },
+    "settings": {
+      "quick": {
+        "title": "最快上手：快捷配置",
+        "desc": "粘贴 Huobao API Key，一键写入文本、图片、视频三条推荐配置，支持连通性测试。"
+      },
+      "nav": {
+        "title": "全部配置都在这",
+        "desc": "左侧切换：AI 服务、通用（界面语言/内容语言）、风格预设、Agent 提示词与技能、存储位置、关于更新。"
+      }
+    },
+    "episode": {
+      "topbar": {
+        "title": "顶栏：模型与状态",
+        "desc": "随时切换本次生成用的文本/图片/视频模型；分辨率与时长档位随模型联动。"
+      },
+      "script": {
+        "title": "第 1 步 · 剧本",
+        "desc": "（前提：设置页已配置 AI 服务）粘贴原始小说，点「AI 改写」生成拍摄剧本；满意后进入制作。"
+      },
+      "assets": {
+        "title": "第 2 步 · 资产制作",
+        "desc": "提取角色/场景/道具并生成一致性参考图，生视频时自动作为参考素材。"
+      },
+      "videos": {
+        "title": "第 3 步 · 视频制作",
+        "desc": "拆分分镜 → 检查提示词 → 批量生成视频；失败可一键重试。完成后在「拼接导出」合成成片。"
+      },
+      "help": {
+        "title": "随时重看引导",
+        "desc": "点这个「?」按钮可重新播放本页引导。祝创作顺利！"
+      }
+    }
+  }
+}
diff --git a/huobao-source/frontend/app/pages/index.vue b/huobao-source/frontend/app/pages/index.vue
new file mode 100644
index 0000000..40a0cd0
--- /dev/null
+++ b/huobao-source/frontend/app/pages/index.vue
@@ -0,0 +1,660 @@
+<template>
+  <div class="page">
+    <!-- 紧凑头部：标题 + 统计 + 新建 一行 -->
+    <div class="launcher-head">
+      <div class="head-left">
+        <h1 class="launcher-title">{{ t('index.hero.title') }}</h1>
+        <span class="launcher-sub">{{ t('index.hero.sub') }}</span>
+      </div>
+      <div class="hero-stats">
+        <span class="tag">{{ t('index.hero.projectCount', { n: dramas.length }) }}</span>
+        <span class="tag tag-success">{{ t('index.hero.activeCount', { n: dramas.filter(d => currentStatus(d) === 'active').length }) }}</span>
+        <span class="tag tag-accent">{{ t('index.hero.styleCount', { n: stylePresets.length }) }}</span>
+      </div>
+      <div class="head-actions">
+        <button class="btn btn-icon tour-help-btn" :title="t('tour.helpTitle')" @click="startTour('index', INDEX_TOUR, t)">
+          <CircleHelp :size="15" :stroke-width="1.8" />
+        </button>
+        <button class="btn btn-primary" @click="showCreate = true">
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round">
+            <line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/>
+          </svg>
+          {{ t('index.create') }}
+        </button>
+      </div>
+    </div>
+
+    <div class="toolbar">
+      <label class="search-box">
+        <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round">
+          <circle cx="11" cy="11" r="7"/><path d="m21 21-4.35-4.35"/>
+        </svg>
+        <input v-model.trim="searchKeyword" class="input" :placeholder="t('index.searchPlaceholder')" />
+      </label>
+      <div class="chip-row">
+        <button
+          v-for="f in filters"
+          :key="f.value"
+          type="button"
+          class="filter-chip"
+          :class="{ on: statusFilter === f.value }"
+          @click="statusFilter = f.value"
+        >
+          {{ f.label }}
+        </button>
+      </div>
+      <div class="sort-select-wrap">
+        <BaseSelect v-model="sortMode" :options="sortOptions" :searchable="false" />
+      </div>
+    </div>
+
+    <!-- 加载骨架：卡片 -->
+    <div v-if="loading" class="project-grid">
+      <div v-for="i in 8" :key="i" class="card skeleton-card">
+        <div class="skeleton-cover"></div>
+        <div class="skeleton-body">
+          <div class="skeleton-line w-60"></div>
+          <div class="skeleton-line w-40"></div>
+        </div>
+      </div>
+    </div>
+
+    <!-- 项目卡片网格 -->
+    <div v-else-if="filteredDramas.length" class="project-grid">
+      <article
+        v-for="(d, i) in filteredDramas"
+        :key="d.id"
+        class="card project-card"
+        :style="{ animationDelay: `${i * 0.04}s` }"
+        tabindex="0"
+        role="button"
+        :aria-label="t('index.openProjectAria', { title: d.title })"
+        @click="openDrama(d)"
+        @keydown.enter.prevent="openDrama(d)"
+        @keydown.space.prevent="openDrama(d)"
+      >
+        <div class="project-cover">
+          <span class="cover-initial">{{ coverInitial(d) }}</span>
+          <span v-if="d.aspect_ratio && d.aspect_ratio !== 'adaptive'" class="cover-ratio">{{ d.aspect_ratio }}</span>
+          <div class="status-wrap" @click.stop>
+            <AppMenu
+              :open="statusMenuId === d.id"
+              placement="bottom-start"
+              :min-width="120"
+              @update:open="(v) => { statusMenuId = v ? d.id : null }"
+            >
+              <template #trigger>
+                <button type="button" class="cover-badge status-badge" :title="t('index.statusBadgeTitle')">
+                  <span class="status-dot" :class="statusDotClass(d)"></span>
+                  {{ projectStatus(d) }}
+                </button>
+              </template>
+              <AppMenuItem
+                v-for="s in statusOptions"
+                :key="s.value"
+                :selected="currentStatus(d) === s.value"
+                @click="setDramaStatus(d, s.value)"
+              >{{ s.label }}</AppMenuItem>
+            </AppMenu>
+          </div>
+          <div class="more-wrap" @click.stop>
+            <AppMenu
+              :open="activeMenuId === d.id"
+              placement="bottom-end"
+              :min-width="140"
+              @update:open="(v) => { activeMenuId = v ? d.id : null }"
+            >
+              <template #trigger>
+                <button class="btn btn-icon btn-sm cover-more" type="button" :title="t('common.more')">
+                  <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round">
+                    <circle cx="5" cy="12" r="1"/><circle cx="12" cy="12" r="1"/><circle cx="19" cy="12" r="1"/>
+                  </svg>
+                </button>
+              </template>
+              <AppMenuItem @click="activeMenuId = null; openDrama(d)">{{ t('index.openProject') }}</AppMenuItem>
+              <AppMenuItem danger @click="activeMenuId = null; dramaToDelete = d">{{ t('index.deleteProject') }}</AppMenuItem>
+            </AppMenu>
+          </div>
+        </div>
+        <div class="project-body">
+          <h2 class="project-name truncate">{{ d.title }}</h2>
+          <div class="project-meta">
+            <span v-if="d.style" class="tag tag-accent">{{ styleLabel(d.style) }}</span>
+            <span class="dim">{{ t('index.projectMeta', { chars: d.characters?.length || 0, scenes: d.scenes?.length || 0, eps: d.episodes?.length || 0 }) }}</span>
+          </div>
+          <div class="project-foot dim">
+            <Clock :size="11" :stroke-width="1.8" />
+            {{ fmtDate(d.updated_at || d.updatedAt) }}
+          </div>
+        </div>
+      </article>
+    </div>
+
+    <div v-else class="empty-state">
+      <div class="empty-icon">
+        <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round">
+          <rect x="3" y="3" width="18" height="18" rx="3"/>
+          <line x1="12" y1="8" x2="12" y2="16"/>
+          <line x1="8" y1="12" x2="16" y2="12"/>
+        </svg>
+      </div>
+      <p class="empty-title">{{ dramas.length ? t('index.emptyFilteredTitle') : t('index.emptyTitle') }}</p>
+      <p class="empty-desc">{{ dramas.length ? t('index.emptyFilteredDesc') : t('index.emptyDesc') }}</p>
+      <button v-if="!dramas.length" class="btn btn-primary" @click="showCreate = true">{{ t('index.create') }}</button>
+    </div>
+
+    <div v-if="showCreate" class="overlay" @click.self="showCreate = false">
+      <div class="dialog create-dialog">
+        <div class="dialog-head">
+          <div class="modal-icon">
+            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round">
+              <rect x="3" y="3" width="18" height="18" rx="3"/>
+              <line x1="12" y1="8" x2="12" y2="16"/><line x1="8" y1="12" x2="16" y2="12"/>
+            </svg>
+          </div>
+          <div class="dialog-head-copy">
+            <h2 class="dialog-title">{{ t('index.createDialog.title') }}</h2>
+            <p class="dialog-desc">{{ t('index.createDialog.desc') }}</p>
+          </div>
+        </div>
+        <form @submit.prevent="create" class="dialog-form">
+          <div class="dialog-body">
+            <label class="field">
+              <span class="field-label">{{ t('index.createDialog.name') }} <span class="required">*</span></span>
+              <input v-model="form.title" class="input" :placeholder="t('index.createDialog.namePlaceholder')" required autofocus />
+            </label>
+            <label class="field">
+              <span class="field-label">{{ t('index.createDialog.style') }}</span>
+              <BaseSelect v-model="form.style" :options="styleSelectOptions" :placeholder="t('index.createDialog.stylePlaceholder')" searchable />
+              <span v-if="selectedStyleDesc" class="field-hint">{{ selectedStyleDesc }}</span>
+            </label>
+            <label class="field">
+              <span class="field-label">{{ t('index.createDialog.aspectRatio') }}</span>
+              <BaseSelect v-model="form.aspect_ratio" :options="aspectRatioOptions" :placeholder="t('index.createDialog.aspectRatioPlaceholder')" />
+              <span class="field-hint">{{ t('index.createDialog.aspectRatioHint') }}</span>
+            </label>
+          </div>
+          <div class="dialog-foot">
+            <button type="button" class="btn" @click="showCreate = false">{{ t('common.cancel') }}</button>
+            <button type="submit" class="btn btn-primary">
+              <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round">
+                <line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/>
+              </svg>
+              {{ t('index.createDialog.submit') }}
+            </button>
+          </div>
+        </form>
+      </div>
+    </div>
+    <ConfirmDialog
+      :open="!!dramaToDelete"
+      :title="t('index.deleteDialog.title')"
+      :message="t('index.deleteDialog.message', { title: dramaToDelete?.title })"
+      :loading="deletingDrama"
+      @confirm="confirmDelDrama"
+      @cancel="dramaToDelete = null"
+    />
+  </div>
+</template>
+
+<script setup>
+import { toast } from 'vue-sonner'
+import { toastError } from '~/composables/useToast'
+import { useI18n } from 'vue-i18n'
+import { Clock, CircleHelp } from 'lucide-vue-next'
+import { dramaAPI, stylePresetAPI } from '~/composables/useApi'
+import BaseSelect from '~/components/BaseSelect.vue'
+import { startTour, autoTour } from '~/composables/useTour'
+
+const { t, locale } = useI18n()
+
+const dramas = ref([])
+const loading = ref(false)
+const showCreate = ref(false)
+const searchKeyword = ref('')
+const statusFilter = ref('all')
+const sortMode = ref('updated')
+const sortOptions = computed(() => ([
+  { label: t('index.sortUpdated'), value: 'updated' },
+  { label: t('index.sortTitle'), value: 'title' },
+]))
+const activeMenuId = ref(null)
+const dramaToDelete = ref(null)
+const deletingDrama = ref(false)
+const form = ref({ title: '', style: '', aspect_ratio: '16:9' })
+const stylePresets = ref([])
+const styleSelectOptions = computed(() => stylePresets.value.map(p => ({ label: p.name, value: p.value })))
+const selectedStyleDesc = computed(() => stylePresets.value.find(p => p.value === form.value.style)?.description || '')
+// 常量数组 label 渲染时求值（语言切换即时生效），value 为逻辑值
+const aspectRatioOptions = computed(() => ([
+  { label: t('index.ratio.landscape'), value: '16:9' },
+  { label: t('index.ratio.portrait'), value: '9:16' },
+  { label: t('index.ratio.square'), value: '1:1' },
+  { label: t('index.ratio.adaptive'), value: 'adaptive' },
+]))
+const filters = computed(() => ([
+  { label: t('index.status.all'), value: 'all' },
+  { label: t('index.status.draft'), value: 'draft' },
+  { label: t('index.status.active'), value: 'active' },
+  { label: t('index.status.completed'), value: 'completed' },
+]))
+// 项目状态由用户手动标记（持久化到 dramas.status），不再按内容自动推算
+const statusOptions = computed(() => ([
+  { label: t('index.status.draft'), value: 'draft' },
+  { label: t('index.status.active'), value: 'active' },
+  { label: t('index.status.completed'), value: 'completed' },
+]))
+const statusMenuId = ref(null)
+
+function currentStatus(d) { return d.status || 'draft' }
+function projectStatus(d) { return statusOptions.value.find(s => s.value === currentStatus(d))?.label || t('index.status.draft') }
+function statusDotClass(d) { return currentStatus(d) === 'active' ? 'on' : currentStatus(d) === 'completed' ? 'done' : '' }
+
+async function setDramaStatus(d, status) {
+  statusMenuId.value = null
+  if (currentStatus(d) === status) return
+  const prev = d.status
+  d.status = status
+  try {
+    await dramaAPI.update(d.id, { status })
+  } catch (e) {
+    d.status = prev
+    toastError(e)
+  }
+}
+
+function styleLabel(key) {
+  return stylePresets.value.find(p => p.value === key)?.name || key || ''
+}
+
+// 封面：单色灰阶 + 首字符（状态色只以小圆点出现，封面保持中性）
+function coverInitial(d) {
+  return String(d.title || '?').trim().slice(0, 1).toUpperCase() || '?'
+}
+
+const filteredDramas = computed(() => {
+  const keyword = searchKeyword.value.trim().toLowerCase()
+  const items = dramas.value.filter((d) => {
+    const text = [d.title, d.style, styleLabel(d.style), projectStatus(d)].filter(Boolean).join(' ').toLowerCase()
+    const matchesSearch = !keyword || text.includes(keyword)
+    const matchesStatus = statusFilter.value === 'all' || currentStatus(d) === statusFilter.value
+    return matchesSearch && matchesStatus
+  })
+
+  return [...items].sort((a, b) => {
+    if (sortMode.value === 'title') return String(a.title || '').localeCompare(String(b.title || ''), 'zh-CN')
+    return new Date(b.updated_at || b.updatedAt || 0).getTime() - new Date(a.updated_at || a.updatedAt || 0).getTime()
+  })
+})
+
+async function load() {
+  loading.value = true
+  try {
+    const [res, presets] = await Promise.all([dramaAPI.list(), stylePresetAPI.list()])
+    dramas.value = res.items || []
+    stylePresets.value = presets || []
+    if (!form.value.style && stylePresets.value.length) {
+      form.value.style = stylePresets.value[0].value
+    }
+  } catch (e) {
+    toastError(e)
+  } finally {
+    loading.value = false
+  }
+}
+
+async function create() {
+  if (!form.value.title?.trim()) return
+  try {
+    const d = await dramaAPI.create(form.value)
+    showCreate.value = false
+    navigateTo(`/drama/${d.id}`)
+  } catch (e) {
+    toastError(e)
+  }
+}
+
+async function confirmDelDrama() {
+  const d = dramaToDelete.value
+  if (!d) return
+  try {
+    deletingDrama.value = true
+    await dramaAPI.del(d.id)
+    toast.success(t('index.deleted'))
+    dramaToDelete.value = null
+    load()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    deletingDrama.value = false
+  }
+}
+
+function getEpisodeNumber(d) {
+  const episodes = [...(d.episodes || [])]
+  if (!episodes.length) return 1
+  episodes.sort((a, b) => Number(a.episode_number || a.episodeNumber || 1) - Number(b.episode_number || b.episodeNumber || 1))
+  return Number(episodes[0].episode_number || episodes[0].episodeNumber || 1)
+}
+
+function getDramaPath(d) {
+  return `/drama/${d.id}`
+}
+
+function openDrama(d) {
+  activeMenuId.value = null
+  navigateTo(getDramaPath(d))
+}
+
+function latestEpisodeLabel(d) {
+  if (!d.episodes?.length) return t('index.noEpisodes')
+  return t('index.episodeN', { n: getEpisodeNumber(d) })
+}
+
+function fmtDate(s) {
+  if (!s) return ''
+  const d = new Date(s)
+  const now = new Date()
+  const diff = now.getTime() - d.getTime()
+  if (diff < 60000) return t('index.time.justNow')
+  if (diff < 3600000) return t('index.time.minutesAgo', { n: Math.floor(diff / 60000) })
+  if (diff < 86400000) return t('index.time.hoursAgo', { n: Math.floor(diff / 3600000) })
+  if (diff < 604800000) return t('index.time.daysAgo', { n: Math.floor(diff / 86400000) })
+  return d.toLocaleDateString(locale.value === 'zh' ? 'zh-CN' : locale.value, { month: 'short', day: 'numeric' })
+}
+
+onMounted(load)
+
+// ===== 应用内引导（首页）：3 步 — 欢迎 / 新建项目 / AI 配置提醒 =====
+const INDEX_TOUR = [
+  { element: '#__nuxt', titleKey: 'tour.index.welcome.title', descKey: 'tour.index.welcome.desc' },
+  { element: '.nav-link[href="/settings"]', titleKey: 'tour.index.settings.title', descKey: 'tour.index.settings.desc', popoverSide: 'bottom' },
+  { element: '.head-actions .btn-primary', titleKey: 'tour.index.create.title', descKey: 'tour.index.create.desc', popoverSide: 'bottom', popoverAlign: 'end' },
+]
+onMounted(() => setTimeout(() => autoTour('index', INDEX_TOUR, t), 600))
+</script>
+
+<style scoped>
+.page {
+  padding: 20px 28px 48px;
+  overflow-y: auto;
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+  animation: fadeUp 0.35s var(--ease-out) both;
+  background: var(--surface-base);
+}
+
+/* 紧凑头部：标题 + 副标题 + 统计 + 新建 一行 */
+.launcher-head {
+  display: flex;
+  align-items: center;
+  gap: var(--sp-4);
+  padding-bottom: var(--sp-4);
+}
+.head-left { display: flex; align-items: baseline; gap: 12px; min-width: 0; }
+.launcher-title {
+  font-size: 20px;
+  font-weight: 650;
+  letter-spacing: -0.02em;
+  color: var(--text-0);
+  white-space: nowrap;
+}
+.launcher-sub { color: var(--text-3); font-size: 12.5px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.hero-stats { display: flex; gap: var(--sp-2); margin-left: auto; }
+.launcher-head .btn { flex-shrink: 0; }
+.head-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }
+
+.toolbar {
+  display: flex;
+  align-items: center;
+  gap: var(--sp-3);
+  margin-bottom: var(--sp-4);
+}
+.search-box { position: relative; width: 240px; flex: 0 0 auto; }
+.search-box svg {
+  position: absolute;
+  left: 12px;
+  top: 50%;
+  transform: translateY(-50%);
+  color: var(--text-3);
+  pointer-events: none;
+}
+.search-box .input {
+  padding-left: 34px;
+  border-radius: var(--radius-pill);
+  border-color: var(--border);
+  background: var(--bg-hover);
+}
+.search-box .input:focus { background: var(--surface-input); }
+.chip-row { display: flex; gap: 6px; overflow-x: auto; padding-bottom: 1px; }
+.filter-chip {
+  appearance: none;
+  cursor: pointer;
+  padding: 6px 14px;
+  border: none;
+  border-radius: var(--radius-pill);
+  background: var(--overlay-track);
+  color: var(--text-2);
+  font-size: 12px;
+  font-weight: 600;
+  white-space: nowrap;
+  transition: all 0.16s var(--ease-out);
+}
+.filter-chip:hover { color: var(--text-0); background: var(--bg-active); }
+.filter-chip:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+.filter-chip.on { background: var(--inverse-surface); color: var(--on-inverse); }
+.sort-select-wrap { margin-left: auto; width: 132px; flex-shrink: 0; }
+
+/* 项目卡片网格 */
+.project-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
+  gap: 16px;
+}
+.project-card {
+  position: relative;
+  overflow: hidden;
+  cursor: pointer;
+  animation: fadeUp 0.32s var(--ease-out) both;
+  transition: border-color 0.16s var(--ease-out), background 0.16s var(--ease-out);
+}
+.project-card:hover { border-color: var(--border-strong); }
+.project-card:focus-visible {
+  outline: none;
+  border-color: var(--accent);
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+
+/* 封面：品牌柔光洗色 + 首字符，状态色只在圆点上出现 */
+.project-cover {
+  position: relative;
+  aspect-ratio: 2.1 / 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: linear-gradient(135deg, var(--accent-bg) 0%, var(--bg-1) 70%);
+  border-bottom: 1px solid var(--border);
+}
+.cover-initial {
+  font-size: 30px;
+  font-weight: 700;
+  color: var(--accent-text);
+  opacity: 0.55;
+  user-select: none;
+}
+.cover-ratio {
+  position: absolute;
+  right: 10px;
+  bottom: 8px;
+  padding: 2px 7px;
+  border-radius: 5px;
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+  color: var(--text-3);
+  font-size: 10px;
+  font-weight: 500;
+  letter-spacing: 0.02em;
+  font-family: var(--font-mono);
+}
+.cover-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 10px;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-pill);
+  background: var(--surface-raised);
+  color: var(--text-2);
+  font-size: 11px;
+  font-weight: 500;
+  white-space: nowrap;
+}
+.status-badge { cursor: pointer; transition: background 0.14s var(--ease-out), color 0.14s var(--ease-out); }
+.status-badge:hover { color: var(--text-0); background: var(--bg-1); }
+.status-dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--text-3);
+}
+.status-dot.on { background: var(--success); }
+.status-dot.done { background: var(--accent); }
+.status-wrap { position: absolute; top: 10px; left: 10px; }
+
+.more-wrap { position: absolute; top: 8px; right: 8px; }
+.cover-more {
+  width: 30px;
+  min-width: 30px;
+  height: 30px;
+  min-height: 30px;
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+  color: var(--text-2);
+  opacity: 0;
+  transition: opacity 0.15s var(--ease-out), color 0.15s var(--ease-out);
+}
+.cover-more:hover { color: var(--text-0); }
+.project-card:hover .cover-more,
+.more-wrap:focus-within .cover-more { opacity: 1; }
+
+/* 卡身 */
+.project-body { padding: 12px 14px 13px; }
+.project-name {
+  margin: 0;
+  font-size: 14px;
+  font-weight: 600;
+  letter-spacing: -0.01em;
+  color: var(--text-0);
+}
+.project-meta {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-top: 7px;
+  font-size: 11.5px;
+  flex-wrap: wrap;
+}
+.project-foot {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  margin-top: 10px;
+  font-size: 11px;
+  color: var(--text-3);
+  white-space: nowrap;
+}
+
+/* 骨架卡片 */
+.skeleton-card { overflow: hidden; }
+.skeleton-cover {
+  aspect-ratio: 2.1 / 1;
+  background: var(--bg-2);
+  animation: skeleton-pulse 1.4s ease-in-out infinite alternate;
+}
+.skeleton-body { padding: 12px 14px 14px; display: grid; gap: 10px; }
+.skeleton-line {
+  height: 12px;
+  border-radius: 99px;
+  background: var(--bg-2);
+  animation: skeleton-pulse 1.4s ease-in-out infinite alternate;
+}
+.skeleton-line.w-60 { width: 60%; }
+.skeleton-line.w-40 { width: 40%; }
+@keyframes skeleton-pulse { to { opacity: 0.55; } }
+
+/* 空状态吃掉剩余高度 */
+.empty-state {
+  flex: 1;
+  min-height: 240px;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 10px;
+  border: 1px dashed var(--border-strong);
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+  text-align: center;
+}
+.empty-icon {
+  width: 56px;
+  height: 56px;
+  border-radius: var(--radius-lg);
+  background: var(--bg-2);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--text-3);
+  margin-bottom: 4px;
+}
+.empty-title { font-size: 14px; font-weight: 600; color: var(--text-1); }
+.empty-desc { font-size: 12px; color: var(--text-3); max-width: 240px; line-height: 1.6; }
+
+.create-dialog { width: 460px; max-width: calc(100vw - 32px); }
+.dialog-head-copy { display: flex; flex-direction: column; gap: 2px; }
+.dialog-desc { font-size: 12.5px; color: var(--text-3); }
+.modal-icon {
+  width: 40px;
+  height: 40px;
+  flex: 0 0 auto;
+  border-radius: var(--radius);
+  background: var(--accent-bg);
+  color: var(--accent);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.dialog-form {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-height: 0;
+}
+.dialog-body { display: flex; flex-direction: column; gap: 16px; }
+.field { display: flex; flex-direction: column; gap: 6px; }
+.field-label { font-size: 12px; font-weight: 600; color: var(--text-1); }
+.required { color: var(--error); }
+.field-hint { font-size: 11px; color: var(--text-3); line-height: 1.5; }
+.field-row { display: grid; grid-template-columns: 1fr 1fr; gap: 14px; }
+
+@media (max-width: 900px) {
+  .project-grid { grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 12px; }
+}
+@media (max-width: 760px) {
+  .page { padding: 16px 16px 40px; }
+  .launcher-head { flex-wrap: wrap; }
+  .launcher-sub { display: none; }
+  .hero-stats { display: none; }
+  .toolbar { flex-wrap: wrap; }
+  .search-box { width: 100%; flex: 1 1 100%; }
+  .sort-select-wrap { margin-left: 0; flex: 1; }
+  .project-grid { grid-template-columns: repeat(auto-fill, minmax(160px, 1fr)); }
+  .field-row { grid-template-columns: 1fr; }
+  .dialog-foot { flex-direction: column-reverse; }
+  .dialog-foot .btn { width: 100%; }
+}
+</style>
diff --git a/huobao-source/frontend/app/pages/settings.vue b/huobao-source/frontend/app/pages/settings.vue
new file mode 100644
index 0000000..b0077f0
--- /dev/null
+++ b/huobao-source/frontend/app/pages/settings.vue
@@ -0,0 +1,1860 @@
+<template>
+  <div class="settings-page">
+    <div class="settings-layout">
+      <aside class="settings-nav">
+        <div class="nav-group">
+          <div class="nav-group-label">{{ t('settings.groupBase') }}</div>
+          <button v-for="nt in baseTabs" :key="nt.id" :class="['nav-item', { active: tab === nt.id }]" @click="tab = nt.id">
+            <component :is="nt.icon" :size="14" />
+            {{ nt.label }}
+          </button>
+        </div>
+      </aside>
+
+      <div class="settings-content">
+
+        <!-- ===== 通用（内容语言） ===== -->
+        <div v-if="tab === 'general'" class="settings-scroll">
+          <div class="settings-head">
+            <h2 class="settings-title">{{ t('settings.general.title') }}</h2>
+            <p class="settings-desc">{{ t('settings.general.desc') }}</p>
+          </div>
+          <section class="card svc-group">
+            <div class="svc-group-head">
+              <div class="svc-group-heading">
+                <span class="svc-group-title">{{ t('settings.general.contentLanguage') }}</span>
+                <div class="svc-group-sub">{{ t('settings.general.contentLanguageSub') }}</div>
+              </div>
+            </div>
+            <div class="config-row">
+              <div class="provider-badge" style="background:var(--accent-bg);color:var(--accent)"><Languages :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line"><span class="config-name">{{ t('settings.general.languageLabel') }}</span></div>
+                <div class="config-sub">{{ t('settings.general.languageNote') }}</div>
+              </div>
+              <div class="lang-picker">
+                <button
+                  v-for="l in contentLangOptions"
+                  :key="l.value"
+                  type="button"
+                  :class="['lang-option', { on: contentLanguage === l.value }]"
+                  @click="setContentLanguage(l.value)"
+                >{{ l.label }}</button>
+              </div>
+            </div>
+            <p class="config-empty">{{ t('settings.general.languageHint') }}</p>
+          </section>
+
+          <!-- 外观主题 -->
+          <section class="card svc-group">
+            <div class="svc-group-head">
+              <div class="svc-group-heading">
+                <span class="svc-group-title">{{ t('settings.general.appearance') }}</span>
+                <div class="svc-group-sub">{{ t('settings.general.appearanceSub') }}</div>
+              </div>
+            </div>
+            <div class="config-row">
+              <div class="provider-badge" style="background:var(--accent-bg);color:var(--accent)"><SunMoon :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line"><span class="config-name">{{ t('settings.general.appearanceLabel') }}</span></div>
+                <div class="config-sub">{{ t('settings.general.appearanceNote') }}</div>
+              </div>
+              <div class="lang-picker">
+                <button
+                  v-for="o in themeOptions"
+                  :key="o.value"
+                  type="button"
+                  :class="['lang-option', { on: themeMode === o.value }]"
+                  @click="setThemeMode(o.value)"
+                >{{ o.label }}</button>
+              </div>
+            </div>
+          </section>
+        </div>
+
+        <!-- ===== AI 服务配置 ===== -->
+        <div v-if="tab === 'ai'" class="settings-scroll">
+          <div class="settings-head">
+            <h2 class="settings-title">{{ t('settings.ai.title') }}</h2>
+            <p class="settings-desc">{{ t('settings.ai.desc') }}</p>
+          </div>
+          <section class="card quick-card">
+            <div class="quick-card-head">
+              <div class="setup-title">{{ t('settings.ai.quickTitle') }}</div>
+              <span class="tag tag-accent">{{ t('settings.ai.recommended') }}</span>
+            </div>
+            <p class="setup-desc">
+              {{ t('settings.ai.quickDesc') }}
+              <a class="huobao-site-link" :href="huobaoSiteUrl" target="_blank" rel="noopener noreferrer">
+                {{ t('settings.ai.getKey') }}
+                <ExternalLink :size="12" :stroke-width="1.8" />
+              </a>
+            </p>
+            <div class="huobao-quick-row">
+              <input v-model="huobaoApiKey" class="input" type="password" placeholder="Huobao API Key" />
+              <div class="lang-picker">
+                <button
+                  type="button"
+                  :class="['lang-option', { on: huobaoRegion === 'cn' }]"
+                  @click="huobaoRegion = 'cn'"
+                >{{ t('settings.ai.regionCn') }}</button>
+                <button
+                  type="button"
+                  :class="['lang-option', { on: huobaoRegion === 'com' }]"
+                  @click="huobaoRegion = 'com'"
+                >{{ t('settings.ai.regionCom') }}</button>
+              </div>
+              <button class="btn btn-primary" :disabled="huobaoSaving" @click="applyHuobaoQuickConfig">
+                <Loader2 v-if="huobaoSaving" :size="13" class="animate-spin" />
+                <Sparkles v-else :size="13" />
+                {{ t('settings.ai.applyQuick') }}
+              </button>
+            </div>
+            <div class="huobao-quick-models">
+              <div v-for="q in huobaoQuickConfigs" :key="q.name" class="hqm-row">
+                <span class="hqm-label">{{ serviceMeta[q.service_type].label }}</span>
+                <span class="hqm-provider">
+                  <img v-if="providerIconUrl(q.provider)" :src="providerIconUrl(q.provider)" class="hqm-provider-icon" alt="" />
+                  {{ q.provider }}
+                </span>
+                <span class="hqm-models mono">
+                  <span v-for="(m, i) in q.model" :key="m" :class="['hqm-model', { 'is-default': i === 0 }]">
+                    {{ m }}<em v-if="i === 0">{{ t('common.default') }}</em>
+                  </span>
+                </span>
+              </div>
+            </div>
+          </section>
+          <section class="card setup-panel">
+            <div class="setup-panel-head compact">
+              <div>
+                <div class="setup-title">{{ t('settings.ai.manualTitle') }}</div>
+                <div class="setup-desc">{{ t('settings.ai.manualDesc') }}</div>
+              </div>
+            </div>
+            <div class="template-row">
+              <button
+                v-for="st in serviceTypes"
+                :key="st.type"
+                class="template-type-chip"
+                @click="startAddCfg(st.type)"
+              >
+                {{ st.label }}
+              </button>
+            </div>
+          </section>
+          <div class="sections">
+            <section v-for="st in serviceTypes" :key="st.type" class="card svc-group">
+              <div class="svc-group-head">
+                <div class="svc-group-heading">
+                  <span class="svc-group-title">{{ st.label }}</span>
+                  <div class="svc-group-sub">{{ serviceMeta[st.type].desc }}</div>
+                </div>
+                <span v-if="countActive(st.type)" class="tag tag-accent">{{ t('settings.ai.activeCount', { n: countActive(st.type) }) }}</span>
+                <button class="btn btn-ghost btn-sm ml-auto" @click="startAddCfg(st.type)"><Plus :size="13" /> {{ t('common.add') }}</button>
+              </div>
+              <div v-for="c in byType(st.type)" :key="c.id" class="config-row">
+                <div class="provider-badge" :class="{ 'has-icon': !!providerIconUrl(c.provider) }" :data-provider="c.provider">
+                  <img v-if="providerIconUrl(c.provider)" class="provider-badge-icon" :src="providerIconUrl(c.provider)" alt="" />
+                  <template v-else>{{ c.provider.slice(0, 1).toUpperCase() }}</template>
+                </div>
+                <div class="config-main">
+                  <div class="config-line">
+                    <span class="config-name">{{ c.name || `${c.provider}-${c.service_type}` }}</span>
+                    <span :class="['tag', c.api_key ? 'tag-success' : 'tag-error']">{{ c.api_key ? t('settings.ai.hasKey') : t('settings.ai.noKey') }}</span>
+                    <span v-if="!c.is_active" class="tag">{{ t('settings.common.disabled') }}</span>
+                    <span v-if="isGpuConfig(c)" class="tag tag-accent">{{ gpuLabel(c.gpu) }}</span>
+                  </div>
+                  <div class="config-models">
+                    <button
+                      v-for="m in c.model" :key="m" type="button"
+                      :class="['cfg-model-chip mono', { 'is-default': isDefaultModel(st.type, c, m) }]"
+                      :title="isDefaultModel(st.type, c, m) ? t('settings.ai.currentDefault') : t('settings.ai.setDefault')"
+                      @click="setDefaultModel(st.type, c, m)"
+                    >
+                      <Star v-if="isDefaultModel(st.type, c, m)" :size="9" class="cfg-model-star" />
+                      {{ m }}
+                    </button>
+                  </div>
+                  <div class="config-sub mono truncate">{{ c.base_url || t('settings.ai.noBaseUrl') }}</div>
+                </div>
+                <button v-if="st.type === 'text'" class="btn btn-ghost btn-sm" @click="testExistingCfg(c)">{{ t('settings.ai.test') }}</button>
+                <label class="config-switch">
+                  <input type="checkbox" class="sr-only" :checked="c.is_active" @change="toggleCfg(c)">
+                  <span class="switch" :class="{ on: c.is_active }"></span>
+                </label>
+                <button class="btn btn-ghost btn-icon btn-sm" @click="startEditCfg(c)"><Pencil :size="13" /></button>
+                <button class="btn btn-danger btn-icon btn-sm" @click="delCfg(c.id)"><Trash2 :size="13" /></button>
+              </div>
+              <p v-if="!byType(st.type).length" class="config-empty">{{ t('settings.common.empty') }}</p>
+            </section>
+          </div>
+        </div>
+
+        <!-- ===== 风格预设 ===== -->
+        <div v-else-if="tab === 'styles'" class="settings-scroll">
+          <div class="settings-head">
+            <h2 class="settings-title">{{ t('settings.styles.title') }}</h2>
+            <p class="settings-desc">{{ t('settings.styles.desc') }}</p>
+          </div>
+          <section class="card svc-group">
+            <div class="svc-group-head">
+              <div class="svc-group-heading">
+                <span class="svc-group-title">{{ t('settings.styles.allTitle') }}</span>
+                <div class="svc-group-sub">{{ t('settings.styles.count', { active: stylePresets.filter(p => p.is_active).length, total: stylePresets.length }) }}</div>
+              </div>
+              <button class="btn btn-ghost btn-sm ml-auto" @click="startAddStyle"><Plus :size="13" /> {{ t('common.add') }}</button>
+            </div>
+            <div v-for="p in stylePresets" :key="p.id" class="config-row">
+              <div class="provider-badge style-badge"><Palette :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line">
+                  <span class="config-name">{{ p.name }}</span>
+                  <span class="tag mono">{{ p.value }}</span>
+                  <span v-if="!p.is_active" class="tag">{{ t('settings.common.disabled') }}</span>
+                </div>
+                <div class="config-sub mono truncate">{{ p.prompt }}</div>
+                <div v-if="p.description" class="config-sub truncate">{{ p.description }}</div>
+              </div>
+              <label class="config-switch">
+                <input type="checkbox" class="sr-only" :checked="p.is_active" @change="toggleStyle(p)">
+                <span class="switch" :class="{ on: p.is_active }"></span>
+              </label>
+              <button class="btn btn-ghost btn-icon btn-sm" @click="startEditStyle(p)"><Pencil :size="13" /></button>
+              <button class="btn btn-danger btn-icon btn-sm" @click="styleToDelete = p"><Trash2 :size="13" /></button>
+            </div>
+            <p v-if="!stylePresets.length" class="config-empty">{{ t('settings.styles.empty') }}</p>
+          </section>
+        </div>
+
+        <!-- ===== 存储位置 ===== -->
+        <div v-else-if="tab === 'storage'" class="settings-scroll">
+          <div class="settings-head">
+            <h2 class="settings-title">{{ t('settings.storage.title') }}</h2>
+            <p class="settings-desc">{{ t('settings.storage.desc') }}</p>
+          </div>
+          <section class="card svc-group">
+            <div class="svc-group-head">
+              <div class="svc-group-heading">
+                <span class="svc-group-title">{{ t('settings.storage.currentDir') }}</span>
+                <div v-if="storageInfo?.computedAt" class="svc-group-sub">{{ t('settings.storage.computedAt', { time: new Date(storageInfo.computedAt).toLocaleString() }) }}</div>
+              </div>
+              <button v-if="isDesktopMode" class="btn btn-primary btn-sm ml-auto" :disabled="migrating" @click="pickTarget">
+                <HardDrive :size="13" /> {{ t('settings.storage.changeLocation') }}
+              </button>
+            </div>
+            <div class="config-row">
+              <div class="provider-badge style-badge"><HardDrive :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line"><span class="config-name">{{ t('settings.storage.dataDir') }}</span><span class="tag mono">{{ storageInfo?.mode === 'desktop' ? t('settings.storage.desktopMode') : t('settings.storage.serverMode') }}</span></div>
+                <div class="config-sub mono truncate">{{ storageInfo?.dataDir || t('common.loading') }}</div>
+                <div class="config-sub mono truncate">{{ storageInfo?.sqlitePath || '' }}</div>
+              </div>
+            </div>
+            <div v-if="storageInfo?.usage" class="config-row">
+              <div class="provider-badge style-badge"><Database :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line">
+                  <span class="config-name">{{ t('settings.storage.totalUsage', { size: formatBytes(storageInfo.usage.total) }) }}</span>
+                  <span v-if="storageInfo.usageStale" class="tag">{{ t('settings.storage.counting') }}</span>
+                </div>
+                <div class="storage-breakdown">
+                  <span class="tag mono">{{ t('settings.storage.breakdown.db') }} {{ formatBytes(storageInfo.usage.db) }}</span>
+                  <span class="tag mono">{{ t('settings.storage.breakdown.images') }} {{ formatBytes(storageInfo.usage.images) }}</span>
+                  <span class="tag mono">{{ t('settings.storage.breakdown.videos') }} {{ formatBytes(storageInfo.usage.videos) }}</span>
+                  <span class="tag mono">{{ t('settings.storage.breakdown.merged') }} {{ formatBytes(storageInfo.usage.merged) }}</span>
+                  <span class="tag mono">{{ t('settings.storage.breakdown.uploads') }} {{ formatBytes(storageInfo.usage.uploads) }}</span>
+                  <span v-if="storageInfo.usage.temp" class="tag mono">{{ t('settings.storage.breakdown.temp') }} {{ formatBytes(storageInfo.usage.temp) }}</span>
+                  <span v-if="storageInfo.usage.other" class="tag mono">{{ t('settings.storage.breakdown.other') }} {{ formatBytes(storageInfo.usage.other) }}</span>
+                </div>
+                <div v-if="storageInfo.freeBytes != null" class="config-sub">{{ t('settings.storage.diskFree', { size: formatBytes(storageInfo.freeBytes) }) }}</div>
+              </div>
+            </div>
+            <p class="config-empty">{{ t('settings.storage.note') }}</p>
+            <p v-if="!isDesktopMode" class="config-empty">{{ t('settings.storage.serverNote') }}</p>
+          </section>
+        </div>
+
+        <!-- ===== 关于更新 ===== -->
+        <div v-else-if="tab === 'about'" class="settings-scroll">
+          <div class="settings-head">
+            <h2 class="settings-title">{{ t('settings.about.title') }}</h2>
+            <p class="settings-desc">{{ t('settings.about.desc') }}</p>
+          </div>
+          <section class="card svc-group">
+            <div class="svc-group-head">
+              <div class="svc-group-heading">
+                <span class="svc-group-title">{{ t('settings.about.currentVersion', { v: updateState?.currentVersion || '…' }) }}</span>
+                <div v-if="updateState?.latestVersion" class="svc-group-sub">{{ t('settings.about.latestVersion', { v: updateState.latestVersion }) }}</div>
+              </div>
+              <button class="btn btn-primary btn-sm ml-auto" :disabled="updateChecking" @click="checkUpdate">
+                <Loader2 v-if="updateChecking" :size="13" class="animate-spin" />
+                <RefreshCw v-else :size="13" />
+                {{ t('settings.about.check') }}
+              </button>
+            </div>
+
+            <div v-if="updateState?.status === 'up-to-date'" class="config-row">
+              <div class="provider-badge style-badge"><Check :size="15" /></div>
+              <div class="config-main"><div class="config-line"><span class="config-name">{{ t('settings.about.upToDate') }}</span></div></div>
+            </div>
+            <div v-else-if="updateState?.status === 'available' || updateState?.status === 'downloading'" class="config-row">
+              <div class="provider-badge style-badge"><Sparkles :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line"><span class="config-name">{{ t('settings.about.found', { v: updateState.latestVersion }) }}</span></div>
+                <div v-if="updateState.notes" class="config-sub">{{ updateState.notes }}</div>
+                <div v-if="updateState.status === 'downloading' || updateDownloading" class="update-bar">
+                  <div class="update-bar-fill" :style="{ width: `${updateProgress}%` }"></div>
+                </div>
+                <!-- 服务器手动模式：无 Watchtower，给出更新命令 -->
+                <div v-if="!desktopBridge && serverUpdateMode === 'manual'" class="config-sub">
+                  {{ t('settings.about.serverManualHint') }} <span class="mono">docker compose pull && docker compose up -d</span>
+                </div>
+              </div>
+              <!-- 桌面版：下载更新包 -->
+              <button v-if="desktopBridge" class="btn btn-primary btn-sm" :disabled="updateDownloading" @click="downloadUpdate">
+                <Loader2 v-if="updateDownloading" :size="13" class="animate-spin" />
+                <Download v-else :size="13" />
+                {{ updateDownloading ? t('settings.about.downloading', { p: updateProgress }) : t('settings.about.download') }}
+              </button>
+              <!-- 服务器 + Watchtower：一键触发拉镜像重建 -->
+              <button v-else-if="serverUpdateMode === 'watchtower'" class="btn btn-primary btn-sm" :disabled="updateApplying" @click="applyUpdate">
+                <Loader2 v-if="updateApplying" :size="13" class="animate-spin" />
+                <Download v-else :size="13" />
+                {{ t('settings.about.serverApply') }}
+              </button>
+            </div>
+            <div v-else-if="updateState?.status === 'downloaded'" class="config-row">
+              <div class="provider-badge style-badge"><Download :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line"><span class="config-name">{{ t('settings.about.ready') }}</span></div>
+                <div class="config-sub">{{ t('settings.about.readyDesc') }}</div>
+              </div>
+              <button class="btn btn-primary btn-sm" :disabled="updateApplying" @click="applyUpdate">
+                <Loader2 v-if="updateApplying" :size="13" class="animate-spin" />
+                {{ t('settings.about.restartInstall') }}
+              </button>
+            </div>
+            <div v-else-if="updateState?.status === 'error'" class="config-row">
+              <div class="provider-badge style-badge"><RefreshCw :size="15" /></div>
+              <div class="config-main">
+                <div class="config-line"><span class="config-name">{{ t('settings.about.checkFailed') }}</span></div>
+                <div class="config-sub">{{ updateState.error }}</div>
+              </div>
+              <button class="btn btn-ghost btn-sm" @click="checkUpdate">{{ t('settings.about.retry') }}</button>
+            </div>
+            <p v-else class="config-empty">{{ t('settings.about.empty') }}</p>
+          </section>
+          <p v-if="desktopBridge" class="config-empty">{{ t('settings.about.note') }}</p>
+          <p v-else class="config-empty">{{ t('settings.about.serverNote') }}</p>
+        </div>
+
+        <!-- ===== Agent 配置（左侧 tab 切换，Prompt 与 Skills 整合在同一 Agent 下） ===== -->
+        <div v-else-if="tab === 'agents'" class="skills-layout">
+          <!-- Agent 左侧 tab 列表 -->
+          <aside class="skills-agent-list">
+            <div class="skills-agent-title">{{ t('settings.skills.agentList') }}</div>
+            <button
+              v-for="a in agentDefs"
+              :key="a.type"
+              :class="['skills-agent-item', { active: selectedAgent === a.type }]"
+              @click="selectAgent(a.type)"
+            >
+              <span class="agent-type-badge">{{ a.icon }}</span>
+              <span class="skills-agent-label">{{ a.label }}</span>
+              <span v-if="agentSkillCount(a.type) > 0" class="skill-count-badge">{{ agentSkillCount(a.type) }}</span>
+            </button>
+          </aside>
+
+          <!-- 右侧主区域 -->
+          <div class="settings-scroll skills-main">
+            <div class="settings-head skills-head">
+              <span class="agent-type-badge skills-head-badge">{{ selectedAgentIcon }}</span>
+              <div class="skills-head-copy">
+                <h2 class="settings-title">{{ selectedAgentLabel }}</h2>
+                <div class="dim" style="font-size:12px;margin-top:2px;display:flex;align-items:center;gap:6px">
+                  {{ selectedAgentType }}
+                  <span v-if="getAgentCfg(selectedAgent) && !getAgentCfg(selectedAgent).is_default" class="tag tag-success">{{ t('settings.common.custom') }}</span>
+                  <span v-else class="tag">{{ t('common.default') }}</span>
+                </div>
+              </div>
+              <button v-if="agentPane === 'skills'" class="btn btn-primary btn-sm ml-auto" @click="startAddSkill">
+                <Plus :size="13" /> {{ t('settings.skills.add') }}
+              </button>
+            </div>
+
+            <!-- Prompt 面板（子 tab 作为卡片头，与卡片同宽对齐） -->
+            <div v-if="agentPane === 'prompt'" class="card agent-card">
+              <div class="agent-pane-tabs">
+                <div class="agent-pane-tabs-nav">
+                  <button :class="['agent-pane-tab', { active: agentPane === 'prompt' }]" @click="agentPane = 'prompt'">System Prompt</button>
+                  <button :class="['agent-pane-tab', { active: agentPane === 'skills' }]" @click="agentPane = 'skills'">
+                    Skills<template v-if="agentSkillCount(selectedAgent) > 0"> ({{ agentSkillCount(selectedAgent) }})</template>
+                  </button>
+                </div>
+                <span class="agent-lang-follow dim">
+                  {{ t('settings.agents.followContentLang', { lang: contentLangLabel }) }}
+                </span>
+              </div>
+              <div class="agent-card-body">
+                <label class="field">
+                  <span class="field-label">System Prompt <span class="dim">({{ t('settings.agents.promptHint', { file: promptFileName }) }})</span>
+                    <span v-if="agentPromptFallback" class="tag agent-fallback-tag">{{ t('settings.agents.langFallback') }}</span>
+                  </span>
+                  <textarea v-model="agentForm.system_prompt" class="textarea agent-prompt-input" rows="16" :placeholder="t('settings.agents.promptPlaceholder')" />
+                </label>
+                <div class="agent-card-foot">
+                  <button class="btn btn-ghost btn-sm" @click="resetAgentPrompt(selectedAgent)">{{ t('settings.agents.reset') }}</button>
+                  <span v-if="agentSaved === selectedAgent" class="tag tag-success" style="margin-left:8px">
+                    <Check :size="10" /> {{ t('common.saved') }}
+                  </span>
+                  <button class="btn btn-primary btn-sm ml-auto" :disabled="agentSaving" @click="saveAgentCfg(selectedAgent)">
+                    <Loader2 v-if="agentSaving" :size="12" class="animate-spin" />
+                    {{ t('common.save') }}
+                  </button>
+                </div>
+              </div>
+            </div>
+
+            <!-- Skills 面板（子 tab 同为卡片头） -->
+            <template v-else>
+              <div class="agent-pane-tabs-wrap card">
+                <div class="agent-pane-tabs">
+                  <div class="agent-pane-tabs-nav">
+                    <button :class="['agent-pane-tab', { active: agentPane === 'prompt' }]" @click="agentPane = 'prompt'">System Prompt</button>
+                    <button :class="['agent-pane-tab', { active: agentPane === 'skills' }]" @click="agentPane = 'skills'">
+                      Skills<template v-if="agentSkillCount(selectedAgent) > 0"> ({{ agentSkillCount(selectedAgent) }})</template>
+                    </button>
+                  </div>
+                  <span class="agent-lang-follow dim">
+                    {{ t('settings.agents.followContentLang', { lang: contentLangLabel }) }}
+                  </span>
+                </div>
+              </div>
+              <p class="settings-desc" style="margin-top:0">{{ t('settings.skills.desc') }}</p>
+
+              <!-- 无 skill 提示 -->
+              <div v-if="!currentSkills.length" class="card skills-empty">
+                <div class="skills-empty-icon">
+                  <FileText :size="24" />
+                </div>
+                <div class="skills-empty-title">{{ t('settings.skills.emptyTitle') }}</div>
+                <div class="skills-empty-desc">{{ t('settings.skills.emptyDesc') }}</div>
+              </div>
+
+              <!-- Skill 列表 -->
+              <div class="skill-list" v-else>
+                <div v-for="s in currentSkills" :key="s.id" class="card skill-card">
+                  <div class="skill-card-head" @click="toggleSkillEdit(s.id)">
+                    <FileText :size="14" style="color:var(--accent);flex-shrink:0" />
+                    <div style="flex:1;min-width:0">
+                      <div style="font-weight:600;font-size:13px">{{ s.name }}</div>
+                      <div class="dim" style="font-size:11px">{{ s.description }}</div>
+                    </div>
+                    <button class="btn btn-danger btn-icon btn-sm" style="margin-right:4px" @click.stop="skillToDelete = s.id">
+                      <Trash2 :size="13" />
+                    </button>
+                    <ChevronDown :size="14" :style="{ transform: editingSkill === s.id ? 'rotate(180deg)' : '', transition: '0.2s' }" />
+                  </div>
+                  <div v-if="editingSkill === s.id" class="skill-card-body">
+                    <textarea
+                      v-model="skillContent"
+                      class="textarea mono skill-content-input"
+                      rows="20"
+                      style="font-size:12px;line-height:1.6"
+                      :placeholder="t('settings.skills.contentPlaceholder')"
+                    />
+                    <div class="skill-card-foot">
+                      <span class="dim" style="font-size:11px">skills/{{ s.id }}/{{ skillFileName }}</span>
+                      <span v-if="skillContentFallback" class="tag agent-fallback-tag">{{ t('settings.agents.langFallback') }}</span>
+                      <span v-if="skillSaved === s.id" class="tag tag-success" style="margin-left:8px">
+                        <Check :size="10" /> {{ t('common.saved') }}
+                      </span>
+                      <button class="btn btn-primary btn-sm ml-auto" :disabled="skillSaving" @click="saveSkill(s.id)">
+                        <Loader2 v-if="skillSaving" :size="12" class="animate-spin" />
+                        {{ t('common.save') }}
+                      </button>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </template>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <!-- AI Config Dialog -->
+    <div v-if="cfgDialog" class="overlay" @click.self="cfgDialog = false">
+      <form class="dialog config-dialog" @submit.prevent="saveCfg">
+        <div class="dialog-head">
+          <div>
+            <div class="dialog-title">{{ cfgEditId ? t('settings.cfg.editTitle') : t('settings.cfg.addTitle', { type: serviceMeta[cfgForm.service_type].label }) }}</div>
+            <div class="dialog-sub">{{ t('settings.cfg.sub') }}</div>
+          </div>
+          <span class="tag tag-accent ml-auto">{{ serviceMeta[cfgForm.service_type].label }}</span>
+        </div>
+        <div class="dialog-body config-dialog-body">
+          <div class="preset-picker">
+            <button
+              v-for="preset in presetsByType(cfgForm.service_type)"
+              :key="`${cfgForm.service_type}-${preset.provider}`"
+              type="button"
+              class="preset-pill"
+              @click="applyProviderPreset(cfgForm.service_type, preset.provider)"
+            >
+              {{ preset.label }}
+            </button>
+          </div>
+          <label class="field">
+            <span class="field-label">{{ t('settings.cfg.name') }}</span>
+            <input v-model="cfgForm.name" class="input" :placeholder="t('settings.cfg.namePlaceholder')" />
+          </label>
+          <label class="field"><span class="field-label">{{ t('settings.cfg.provider') }}</span>
+            <BaseSelect v-model="cfgForm.provider" :options="providerSelectOptions" :placeholder="t('settings.cfg.providerPlaceholder')" searchable />
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('settings.cfg.priority') }}</span>
+            <input v-model.number="cfgForm.priority" class="input" type="number" min="0" max="999" />
+            <span class="field-hint">{{ t('settings.cfg.priorityHint') }}</span>
+          </label>
+          <label class="field"><span class="field-label">API Key</span><input v-model="cfgForm.api_key" class="input" type="password" placeholder="sk-..." /></label>
+          <label class="field"><span class="field-label">Base URL</span><input v-model="cfgForm.base_url" class="input" placeholder="https://..." /></label>
+          <label v-if="isGpuConfig(cfgForm)" class="field">
+            <span class="field-label">使用显卡</span>
+            <select v-model="cfgForm.gpu" class="input" aria-label="使用显卡">
+              <option value="auto">自动分配 · GPU1 / GPU2 / GPU3</option>
+              <option value="gpu1">GPU1 · 服务器编号 1</option>
+              <option value="gpu2">GPU2 · 服务器编号 2</option>
+              <option value="gpu3">GPU3 · 服务器编号 3</option>
+            </select>
+            <span class="field-hint">按此模型配置单独保存，对新任务生效。指定的显卡不可用时会报错；正在运行的任务继续留在原显卡。</span>
+          </label>
+          <div class="field">
+            <span class="field-label">{{ t('settings.cfg.models') }}</span>
+            <div v-if="cfgForm.models.length" class="model-chips">
+              <span
+                v-for="(m, i) in cfgForm.models" :key="`${m}-${i}`"
+                :class="['model-chip', { 'is-default': i === 0 }]"
+                :title="t('settings.cfg.modelChipHint')"
+                @click="pinModelTop(i)"
+              >
+                {{ m }}<em v-if="i === 0">{{ t('common.default') }}</em>
+                <button type="button" class="model-chip-x" :title="t('common.delete')" @click.stop="removeModel(i)"><X :size="11" /></button>
+              </span>
+            </div>
+            <div class="model-add-row">
+              <input
+                v-model="modelInput" class="input" :placeholder="t('settings.cfg.modelPlaceholder')"
+                @keydown.enter.prevent="addModel"
+                @paste="onModelPaste"
+              />
+              <button type="button" class="btn btn-sm" :disabled="!modelInput.trim()" @click="addModel">{{ t('common.add') }}</button>
+            </div>
+            <span class="field-hint">{{ t('settings.cfg.modelsHint') }}</span>
+          </div>
+          <label v-if="cfgForm.service_type === 'text'" class="field">
+            <span class="field-label">Temperature <span class="dim">({{ t('settings.cfg.tempHint') }})</span></span>
+            <input v-model="cfgForm.temperature" class="input" type="number" step="0.1" min="0" max="2" :placeholder="t('settings.cfg.tempPlaceholder')" />
+            <span class="field-hint">{{ t('settings.cfg.tempNote') }}</span>
+          </label>
+          <div v-if="cfgTestResult" class="test-result" :class="{ ok: cfgTestResult.reachable, bad: !cfgTestResult.reachable }">
+            <div class="test-result-head">
+              <span class="tag" :class="cfgTestResult.reachable ? 'tag-success' : 'tag-error'">{{ cfgTestResult.status || 'ERROR' }}</span>
+              <span>{{ cfgTestResult.message }}</span>
+            </div>
+            <div class="mono test-result-url">{{ cfgTestResult.method }} {{ cfgTestResult.url }}</div>
+            <div v-if="cfgTestResult.response_preview" class="mono test-result-preview">{{ cfgTestResult.response_preview }}</div>
+          </div>
+        </div>
+        <div class="dialog-foot">
+          <button type="button" class="btn btn-ghost test-draft-btn" :disabled="cfgTesting" @click="testDraftCfg">
+            <Loader2 v-if="cfgTesting" :size="12" class="animate-spin" />
+            <span v-else>{{ t('settings.cfg.test') }}</span>
+          </button>
+          <button type="button" class="btn" @click="cfgDialog = false">{{ t('common.cancel') }}</button>
+          <button type="submit" class="btn btn-primary">{{ t('common.save') }}</button>
+        </div>
+      </form>
+    </div>
+
+    <!-- Add Skill Dialog -->
+    <div v-if="addSkillDialog" class="overlay" @click.self="addSkillDialog = false">
+      <form class="dialog skill-dialog" @submit.prevent="confirmAddSkill">
+        <div class="dialog-head">
+          <div class="dialog-title">{{ t('settings.skills.addTitle', { agent: selectedAgentLabel }) }}</div>
+        </div>
+        <div class="dialog-body skill-dialog-body">
+          <label class="field">
+            <span class="field-label">{{ t('settings.skills.dirName') }} <span class="dim">({{ t('settings.skills.dirNameHint') }})</span></span>
+            <input v-model="newSkillForm.id" class="input" :placeholder="t('settings.skills.dirNamePlaceholder')" />
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('settings.skills.name') }}</span>
+            <input v-model="newSkillForm.name" class="input" :placeholder="t('settings.skills.namePlaceholder')" />
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('settings.skills.description') }}</span>
+            <input v-model="newSkillForm.description" class="input" :placeholder="t('settings.skills.descPlaceholder')" />
+          </label>
+        </div>
+        <div class="dialog-foot">
+          <button type="button" class="btn" @click="addSkillDialog = false">{{ t('common.cancel') }}</button>
+          <button type="submit" class="btn btn-primary" :disabled="!newSkillForm.id">{{ t('settings.skills.create') }}</button>
+        </div>
+      </form>
+    </div>
+
+    <!-- Style Preset Dialog -->
+    <div v-if="styleDialog" class="overlay" @click.self="styleDialog = false">
+      <form class="dialog config-dialog" @submit.prevent="saveStyle">
+        <div class="dialog-head">
+          <div>
+            <div class="dialog-title">{{ styleEditId ? t('settings.styleDialog.editTitle') : t('settings.styleDialog.addTitle') }}</div>
+            <div class="dialog-sub">{{ t('settings.styleDialog.sub') }}</div>
+          </div>
+          <span class="tag tag-accent ml-auto"><Palette :size="12" /> {{ t('settings.styleDialog.tag') }}</span>
+        </div>
+        <div class="dialog-body config-dialog-body">
+          <label class="field">
+            <span class="field-label">{{ t('settings.styleDialog.name') }} <span class="required">*</span></span>
+            <input v-model="styleForm.name" class="input" :placeholder="t('settings.styleDialog.namePlaceholder')" />
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('settings.styleDialog.key') }} <span class="required">*</span></span>
+            <input v-model="styleForm.value" class="input mono" :placeholder="t('settings.styleDialog.keyPlaceholder')" :disabled="!!styleEditId" />
+            <span class="field-hint">{{ t('settings.styleDialog.keyHint') }}</span>
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('settings.styleDialog.prompt') }} <span class="required">*</span></span>
+            <textarea v-model="styleForm.prompt" class="textarea" rows="3" :placeholder="t('settings.styleDialog.promptPlaceholder')"></textarea>
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('settings.styleDialog.description') }}</span>
+            <input v-model="styleForm.description" class="input" :placeholder="t('settings.styleDialog.descPlaceholder')" />
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('settings.styleDialog.sort') }}</span>
+            <input v-model.number="styleForm.sort_order" class="input" type="number" min="0" max="999" />
+          </label>
+        </div>
+        <div class="dialog-foot">
+          <button type="button" class="btn" @click="styleDialog = false">{{ t('common.cancel') }}</button>
+          <button type="submit" class="btn btn-primary">{{ t('common.save') }}</button>
+        </div>
+      </form>
+    </div>
+    <!-- 迁移确认（自建 dialog：ConfirmDialog 的删除语义/Enter 快捷键不合此处） -->
+    <div v-if="migrateDialog" class="overlay" @click.self="!migrating && (migrateDialog = false)">
+      <form class="dialog" @submit.prevent="startMigrate">
+        <div class="dialog-head"><span class="dialog-title">{{ t('settings.migrate.title') }}</span></div>
+        <div class="dialog-body">
+          <div class="field">
+            <span class="field-label">{{ t('settings.migrate.newDir') }}</span>
+            <div class="input mono" style="word-break: break-all">{{ migrateTarget }}</div>
+          </div>
+          <div class="field">
+            <span class="field-label">{{ t('settings.migrate.dataToMove') }}</span>
+            <div class="field-hint">
+              {{ t('settings.migrate.sizeNote', { size: formatBytes(storageInfo?.usage?.total || 0) }) }}<template v-if="migrateTargetFree != null">{{ t('settings.migrate.freeNote', { size: formatBytes(migrateTargetFree) }) }}</template>
+            </div>
+          </div>
+          <label class="field" style="display:flex; align-items:center; gap:8px; cursor:pointer">
+            <input v-model="migrateFiles" type="checkbox" :disabled="migrating" />
+            <span class="field-label" style="margin:0">{{ t('settings.migrate.moveFiles') }}</span>
+          </label>
+          <p v-if="!migrateFiles" class="field-hint migrate-warn">{{ t('settings.migrate.emptyWarn') }}</p>
+          <p class="field-hint">{{ t('settings.migrate.note') }}</p>
+        </div>
+        <div class="dialog-foot">
+          <button type="button" class="btn" :disabled="migrating" @click="migrateDialog = false">{{ t('common.cancel') }}</button>
+          <button type="submit" class="btn btn-primary" :disabled="migrating">
+            <Loader2 v-if="migrating" :size="12" class="animate-spin" />
+            {{ t('settings.migrate.start') }}
+          </button>
+        </div>
+      </form>
+    </div>
+    <ConfirmDialog
+      :open="!!styleToDelete"
+      :title="t('settings.styleDelete.title')"
+      :message="t('settings.styleDelete.message', { name: styleToDelete?.name })"
+      :loading="deletingStyle"
+      @confirm="confirmDelStyle"
+      @cancel="styleToDelete = null"
+    />
+    <ConfirmDialog
+      :open="!!skillToDelete"
+      :title="t('settings.skillDelete.title')"
+      :message="t('settings.skillDelete.message', { id: skillToDelete })"
+      :loading="deletingSkill"
+      @confirm="confirmDelSkill"
+      @cancel="skillToDelete = null"
+    />
+  </div>
+</template>
+
+<script setup>
+import { Plus, Pencil, Trash2, FileText, ChevronDown, Check, Loader2, Bot, Cpu, Sparkles, Palette, ExternalLink, Star, HardDrive, Database, RefreshCw, Download, Languages, SunMoon, X } from 'lucide-vue-next'
+import BaseSelect from '~/components/BaseSelect.vue'
+import { toast } from 'vue-sonner'
+import { toastError } from '~/composables/useToast'
+import { useI18n } from 'vue-i18n'
+import { aiConfigAPI, promptAPI, skillsAPI, storageAPI, stylePresetAPI, settingsAPI, serverUpdateAPI } from '~/composables/useApi'
+import { useDesktopBridge } from '~/composables/useDesktopBridge'
+import { useMigrateState } from '~/composables/useMigrateState'
+import { useTheme } from '~/composables/useTheme'
+import { providerIconUrl } from '~/composables/useProviderIcon'
+import { startTour, autoTour } from '~/composables/useTour'
+import { confirmUnifiedLanguage } from '~/composables/useUnifiedLanguage'
+
+const { t, locale } = useI18n()
+
+const showBrandImage = ref(true)
+const tab = ref('ai')
+const baseTabs = computed(() => [
+  { id: 'ai', label: t('settings.tabs.ai'), icon: Cpu },
+  { id: 'general', label: t('settings.tabs.general'), icon: Languages },
+  { id: 'styles', label: t('settings.tabs.styles'), icon: Palette },
+  { id: 'agents', label: t('settings.tabs.agents'), icon: Bot },
+  { id: 'storage', label: t('settings.tabs.storage'), icon: HardDrive },
+  { id: 'about', label: t('settings.tabs.about'), icon: RefreshCw },
+])
+
+// ===== AI Service Configs =====
+const cfgs = ref([])
+const cfgDialog = ref(false)
+const cfgEditId = ref(null)
+const cfgTesting = ref(false)
+const cfgTestResult = ref(null)
+const huobaoApiKey = ref('')
+const huobaoSaving = ref(false)
+// 火宝节点选择：默认跟随界面语言（中文→国内 .cn，其他→国外 .com），一键配置与取 Key 链接共用
+const huobaoRegion = ref(locale.value?.startsWith('zh') ? 'cn' : 'com')
+const huobaoSiteUrl = computed(() => `https://api.firemux.${huobaoRegion.value}`)
+const cfgForm = reactive({ name: '', provider: '', api_key: '', base_url: '', models: [], service_type: 'text', priority: 0, temperature: '', gpu: 'auto' })
+function isGpuConfig(c) {
+  const models = c.models || c.model || []
+  return c.provider === 'localvideo'
+    || (c.service_type === 'image' && models.includes('qwen_image_2_1'))
+    || (c.service_type === 'video' && c.provider === 'minimax' && /:18792(?:\/|$)/.test(c.base_url || ''))
+}
+const gpuLabel = gpu => ['gpu1', 'gpu2', 'gpu3'].includes(gpu) ? `指定 ${gpu.toUpperCase()}` : '显卡自动分配'
+// 模型标签编辑器：首位即默认模型；输入框支持回车添加、逗号/换行批量粘贴
+const modelInput = ref('')
+function addModel() {
+  const names = modelInput.value.split(/[,，\n]/).map(s => s.trim()).filter(Boolean)
+  for (const n of names) if (!cfgForm.models.includes(n)) cfgForm.models.push(n)
+  modelInput.value = ''
+}
+function onModelPaste(e) {
+  const text = e.clipboardData?.getData('text') || ''
+  if (!/[,，\n]/.test(text)) return // 单模型走默认粘贴
+  e.preventDefault()
+  for (const n of text.split(/[,，\n]/).map(s => s.trim()).filter(Boolean)) {
+    if (!cfgForm.models.includes(n)) cfgForm.models.push(n)
+  }
+}
+function removeModel(i) { cfgForm.models.splice(i, 1) }
+function pinModelTop(i) {
+  if (i <= 0) return
+  const [m] = cfgForm.models.splice(i, 1)
+  cfgForm.models.unshift(m)
+}
+// 服务类型 label/desc 渲染时求值（语言切换即时生效），type 为逻辑值
+const serviceTypes = computed(() => [
+  { type: 'text', label: t('common.serviceType.text') },
+  { type: 'image', label: t('common.serviceType.image') },
+  { type: 'video', label: t('common.serviceType.video') },
+])
+const providers = ['gemini', 'openai', 'volcengine', 'minimax', 'aliyun', 'localvideo']
+const providerSelectOptions = computed(() => providers.map(p => ({ label: p, value: p })))
+const serviceMeta = computed(() => ({
+  text: { label: t('common.serviceType.text'), desc: t('settings.ai.meta.text') },
+  image: { label: t('common.serviceType.image'), desc: t('settings.ai.meta.image') },
+  video: { label: t('common.serviceType.video'), desc: t('settings.ai.meta.video') },
+}))
+const providerPresets = {
+  text: {
+    gemini: { label: 'Gemini 官方', baseUrl: 'https://generativelanguage.googleapis.com', models: ['gemini-3.8-flash', 'gemini-3.1-pro-preview', 'gemini-3-flash-preview'] },
+    openai: { label: 'OpenAI 官方', baseUrl: 'https://api.openai.com', models: ['deepseek-v4-pro', 'gpt-5.6-terra'] },
+  },
+  image: {
+    gemini: { label: 'Gemini 官方', baseUrl: 'https://generativelanguage.googleapis.com', models: ['gemini-3-pro-image', 'gemini-3.1-flash-image'] },
+    openai: { label: 'OpenAI 官方', baseUrl: 'https://api.openai.com', models: ['gpt-image-2'] },
+  },
+  video: {
+    aliyun: { label: '阿里云百炼 Wan 3.0', baseUrl: 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com', models: ['wan3.0-video', 'wan3.0-video-prime'] },
+    volcengine: { label: 'Seedance 2.0 官方', baseUrl: 'https://ark.cn-beijing.volces.com', models: ['doubao-seedance-2-0-mini-260615', 'doubao-seedance-2-0-fast-260128', 'doubao-seedance-2-0-260128'] },
+    minimax: { label: 'MiniMax H3 官方', baseUrl: 'https://api.minimaxi.com', models: ['MiniMax-H3'] },
+    localvideo: { label: '本地视频任务池', baseUrl: '', models: ['MiniMax-H3-Hybrid', 'MiniMax-H3-R2V-4Step', 'LTX-2.3', 'LTX-2.3-Text-Preserve', 'Wan2.2-I2V', 'MiniMax-H3-VDN-H3'] },
+  },
+}
+const huobaoQuickConfigs = computed(() => {
+  const base = huobaoSiteUrl.value
+  return [
+    { service_type: 'text', provider: 'gemini', name: '火宝文本服务 · Gemini', base_url: base, model: ['gemini-3.8-flash', 'gemini-3.1-pro-preview', 'gemini-3-flash-preview'], priority: 101 },
+    { service_type: 'text', provider: 'openai', name: '火宝文本服务 · OpenAI', base_url: base, model: ['deepseek-v4-pro', 'deepseek-v4-flash', 'gpt-5.6-terra'], priority: 100 },
+    { service_type: 'image', provider: 'openai', name: '火宝图片服务 · OpenAI', base_url: base, model: ['gpt-image-2'], priority: 99 },
+    { service_type: 'image', provider: 'gemini', name: '火宝图片服务 · Gemini', base_url: base, model: ['gemini-3-pro-image', 'gemini-3.1-flash-image'], priority: 97 },
+    { service_type: 'video', provider: 'aliyun', name: '火宝视频服务 · Wan 3.0', base_url: `${base}/qwen`, model: ['wan3.0-video', 'wan3.0-video-prime'], priority: 97 },
+    { service_type: 'video', provider: 'volcengine', name: '火宝视频服务 · Seedance', base_url: `${base}/volcengine`, model: ['doubao-seedance-2-0-mini-260615', 'doubao-seedance-2-0-fast-260128', 'doubao-seedance-2-0-260128'], priority: 96 },
+    { service_type: 'video', provider: 'minimax', name: '火宝视频服务 · MiniMax', base_url: `${base}/minimax`, model: ['MiniMax-H3'], priority: 98 },
+  ]
+})
+
+function byType(t) { return cfgs.value.filter(c => c.service_type === t) }
+function countActive(t) { return byType(t).filter(c => c.is_active).length }
+function fmtModel(m) { return Array.isArray(m) ? m.join(', ') : m || '—' }
+function presetsByType(type) {
+  const group = providerPresets[type] || {}
+  return Object.entries(group).map(([provider, preset]) => ({ provider, ...preset }))
+}
+function applyProviderPreset(type, provider) {
+  const preset = providerPresets[type]?.[provider]
+  if (!preset) return
+  cfgForm.provider = provider
+  cfgForm.base_url = preset.baseUrl
+  cfgForm.models = [...preset.models]
+  // 配置名持久化进 DB：用 provider 英文 + 服务类型英文标识拼，不随界面语言漂移
+  cfgForm.name = `${preset.label}-${type}`
+}
+
+async function loadCfgs() { try { cfgs.value = await aiConfigAPI.list() } catch (e) { toastError(e) } }
+
+// ===== 默认模型选择 =====
+// 默认解析规则与工作台/后端一致：启用配置中优先级最高者的模型列表首位
+function defaultModelOf(type) {
+  const active = cfgs.value.filter(c => c.service_type === type && c.is_active)
+  if (!active.length) return null
+  const top = [...active].sort((a, b) => (b.priority || 0) - (a.priority || 0))[0]
+  const first = Array.isArray(top.model) ? top.model[0] : null
+  return first ? { configId: top.id, model: first } : null
+}
+function isDefaultModel(type, c, m) {
+  const d = defaultModelOf(type)
+  return !!d && d.configId === c.id && d.model === m
+}
+const defaultSaving = ref(false)
+async function setDefaultModel(type, c, m) {
+  if (defaultSaving.value || isDefaultModel(type, c, m)) return
+  defaultSaving.value = true
+  try {
+    const models = [m, ...(Array.isArray(c.model) ? c.model : []).filter(x => x !== m)]
+    const maxPriority = Math.max(0, ...cfgs.value.filter(x => x.service_type === type).map(x => x.priority || 0))
+    const payload = { model: models }
+    if ((c.priority || 0) < maxPriority) payload.priority = maxPriority + 1
+    if (!c.is_active) payload.is_active = true // 停用配置无法成为默认,选择即启用
+    await aiConfigAPI.update(c.id, payload)
+    toast.success(t('settings.ai.defaultModelSwitched', { type: serviceMeta.value[type].label, model: m }))
+    await loadCfgs()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    defaultSaving.value = false
+  }
+}
+async function toggleCfg(c) { await aiConfigAPI.update(c.id, { is_active: !c.is_active }); loadCfgs() }
+async function delCfg(id) { await aiConfigAPI.del(id); toast.success(t('index.deleted')); loadCfgs() }
+async function applyHuobaoQuickConfig() {
+  const apiKey = huobaoApiKey.value.trim()
+  if (!apiKey) { toast.warning(t('settings.ai.apiKeyRequired')); return }
+  huobaoSaving.value = true
+  try {
+    for (const preset of huobaoQuickConfigs.value) {
+      const payload = { ...preset, api_key: apiKey }
+      const existing = cfgs.value.find(c => c.name === preset.name || (c.service_type === preset.service_type && c.provider === preset.provider && c.base_url === preset.base_url))
+      if (existing) await aiConfigAPI.update(existing.id, payload)
+      else await aiConfigAPI.create(payload)
+    }
+    toast.success(t('settings.ai.quickApplied'))
+    huobaoApiKey.value = ''
+    await loadCfgs()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    huobaoSaving.value = false
+  }
+}
+function startAddCfg(t) {
+  cfgEditId.value = null
+  cfgTestResult.value = null
+  Object.assign(cfgForm, { name: '', provider: '', api_key: '', base_url: '', models: [], service_type: t, priority: 0, temperature: '', gpu: 'auto' })
+  const firstPreset = presetsByType(t)[0]
+  if (firstPreset) applyProviderPreset(t, firstPreset.provider)
+  cfgDialog.value = true
+}
+function startEditCfg(c) {
+  cfgEditId.value = c.id
+  cfgTestResult.value = null
+  Object.assign(cfgForm, {
+    name: c.name || '',
+    provider: c.provider,
+    api_key: c.api_key || '',
+    base_url: c.base_url || '',
+    models: Array.isArray(c.model) ? [...c.model] : String(c.model || '').split(',').map(s => s.trim()).filter(Boolean),
+    service_type: c.service_type,
+    priority: c.priority ?? 0,
+    temperature: c.temperature ?? '',
+    gpu: c.gpu || 'auto',
+  })
+  cfgDialog.value = true
+}
+async function testCfgPayload(payload) {
+  cfgTesting.value = true
+  try {
+    cfgTestResult.value = await aiConfigAPI.test(payload)
+    if (cfgTestResult.value.reachable) toast.success(t('settings.cfg.reachable'))
+    else toast.warning(t('settings.cfg.unreachable'))
+  } catch (e) {
+    toastError(e)
+  } finally {
+    cfgTesting.value = false
+  }
+}
+async function testDraftCfg() {
+  await testCfgPayload({
+    service_type: cfgForm.service_type,
+    provider: cfgForm.provider,
+    api_key: cfgForm.api_key,
+    base_url: cfgForm.base_url,
+    model: [...cfgForm.models],
+  })
+}
+async function testExistingCfg(c) {
+  startEditCfg(c)
+  await testCfgPayload({
+    service_type: c.service_type,
+    provider: c.provider,
+    api_key: c.api_key || '',
+    base_url: c.base_url || '',
+    model: Array.isArray(c.model) ? c.model : [],
+  })
+}
+async function saveCfg() {
+  if (!cfgForm.provider) { toast.warning(t('settings.cfg.providerRequired')); return }
+  const models = [...cfgForm.models]
+  const temperature = cfgForm.temperature === '' || cfgForm.temperature === null ? null : Number(cfgForm.temperature)
+  if (temperature !== null && (!Number.isFinite(temperature) || temperature < 0 || temperature > 2)) {
+    toast.warning(t('settings.cfg.tempInvalid')); return
+  }
+  try {
+    const gpu = isGpuConfig(cfgForm) ? cfgForm.gpu : 'auto'
+    if (cfgEditId.value) await aiConfigAPI.update(cfgEditId.value, { name: cfgForm.name, provider: cfgForm.provider, api_key: cfgForm.api_key, base_url: cfgForm.base_url, model: models, priority: cfgForm.priority, temperature, gpu })
+    else await aiConfigAPI.create({ service_type: cfgForm.service_type, provider: cfgForm.provider, name: cfgForm.name || `${cfgForm.provider}-${cfgForm.service_type}`, api_key: cfgForm.api_key, base_url: cfgForm.base_url, model: models, priority: cfgForm.priority, temperature, gpu })
+    cfgDialog.value = false; toast.success(t('common.saved')); loadCfgs()
+  } catch (e) { toastError(e) }
+}
+
+// ===== Agent Configs =====
+const agentCfgs = ref([])
+const agentPane = ref('prompt')   // 右侧子 tab：prompt | skills
+const agentSaving = ref(false)
+const agentSaved = ref(null)
+const agentForm = reactive({ system_prompt: '' })
+
+const agentDefs = computed(() => [
+  { type: 'script_rewriter', label: t('settings.agents.scriptRewriter'), icon: '📝' },
+  { type: 'extractor', label: t('settings.agents.extractor'), icon: '🔍' },
+  { type: 'storyboard_breaker', label: t('settings.agents.storyboardBreaker'), icon: '🎬' },
+  { type: 'prompt_generator', label: t('settings.agents.promptGenerator'), icon: '🖼' },
+])
+
+function getAgentCfg(type) {
+  return agentCfgs.value.find(a => a.agent_type === type)
+}
+
+
+async function loadAgents() {
+  try { agentCfgs.value = await promptAPI.list() }
+  catch (e) { toastError(e) }
+}
+
+async function loadAgentPrompt(type) {
+  try {
+    const cfg = await promptAPI.get(type, editLang.value)
+    if (selectedAgent.value === type) {
+      agentForm.system_prompt = cfg.system_prompt || ''
+      agentPromptFallback.value = editLang.value !== 'zh' && !!cfg.is_default
+    }
+    agentSaved.value = null
+  } catch (e) { toastError(e) }
+}
+
+async function resetAgentPrompt(type) {
+  try {
+    await promptAPI.reset(type, editLang.value)
+    await loadAgents()
+    const cfg = await promptAPI.get(type, editLang.value)
+    agentForm.system_prompt = cfg.system_prompt || ''
+    agentPromptFallback.value = editLang.value !== 'zh' && !!cfg.is_default
+    toast.success(t('settings.agents.promptReset'))
+  } catch (e) { toastError(e) }
+}
+
+async function saveAgentCfg(type) {
+  agentSaving.value = true
+  agentSaved.value = null
+  try {
+    await promptAPI.update(type, {
+      name: agentDefs.value.find(a => a.type === type)?.label || type,
+      system_prompt: agentForm.system_prompt,
+    }, editLang.value)
+    await loadAgents()
+    agentPromptFallback.value = false
+    agentSaved.value = type
+    toast.success(t('settings.agents.saved', { agent: agentDefs.value.find(a => a.type === type)?.label }))
+    setTimeout(() => { if (agentSaved.value === type) agentSaved.value = null }, 3000)
+  } catch (e) {
+    toastError(e)
+  } finally {
+    agentSaving.value = false
+  }
+}
+
+// ===== Skills =====
+const selectedAgent = ref('script_rewriter')
+const allSkills = ref([])   // { id, name, description }[]
+const editingSkill = ref(null)
+const skillContent = ref('')
+const skillSaving = ref(false)
+const skillSaved = ref(null)
+const addSkillDialog = ref(false)
+const newSkillForm = reactive({ id: '', name: '', description: '' })
+
+const selectedAgentType = computed(() => selectedAgent.value)
+const selectedAgentLabel = computed(() => agentDefs.value.find(a => a.type === selectedAgent.value)?.label || '')
+const selectedAgentIcon = computed(() => agentDefs.value.find(a => a.type === selectedAgent.value)?.icon || '')
+
+// ===== 通用：AI 内容语言（全局设置，与界面语言相互独立） =====
+const contentLanguage = ref('zh')
+const contentLangOptions = [
+  { value: 'zh', label: '中文', shortLabel: '中文' },
+  { value: 'en', label: 'English', shortLabel: 'EN' },
+  { value: 'ja', label: '日本語', shortLabel: '日本語' },
+  { value: 'ko', label: '한국어', shortLabel: '한국어' },
+]
+// ===== Agent 配置：prompt/skill 编辑的语言版本（只读跟随内容语言） =====
+const agentPromptFallback = ref(false)   // 当前语言无独立 prompt 文件，展示的是回退内容
+const skillContentFallback = ref(false)  // 同上，skill 编辑器
+const promptFileName = computed(() => `workspace/prompts/${selectedAgent.value}${editLang.value !== 'zh' ? `.${editLang.value}` : ''}.md`)
+const skillFileName = computed(() => `SKILL${editLang.value !== 'zh' ? `.${editLang.value}` : ''}.md`)
+
+// Agent 编辑语言 = 全局内容语言的只读镜像（改语言请到「通用」页）
+const editLang = computed(() => contentLanguage.value)
+const contentLangLabel = computed(() =>
+  contentLangOptions.find(l => l.value === contentLanguage.value)?.label || contentLanguage.value)
+
+// 内容语言变化时同步刷新 Agent 面板（提示词、Skill 列表与展开内容）
+// 内容语言切换后整页刷新（setUnifiedLanguage），无需局部 watch 同步
+// ===== 通用：外观主题（localStorage 持久化，即时生效） =====
+const { themeMode, setThemeMode } = useTheme()
+const themeOptions = computed(() => [
+  { value: 'light', label: t('settings.general.appearanceLight') },
+  { value: 'dark', label: t('settings.general.appearanceDark') },
+  { value: 'system', label: t('settings.general.appearanceSystem') },
+])
+
+async function loadContentLanguage() {
+  try {
+    const lang = (await settingsAPI.contentLanguage())?.language || 'zh'
+    contentLanguage.value = lang
+    editLang.value = lang  // Agent 编辑器默认跟随内容语言
+  } catch { /* 保持默认 */ }
+}
+async function setContentLanguage(lang) {
+  if (contentLanguage.value === lang) return
+  // UI 语言 = AI 内容语言：确认弹窗 → 统一切换 → 刷新（顶栏 LocaleSwitcher 同一入口）
+  await confirmUnifiedLanguage(lang)
+}
+onMounted(loadContentLanguage)
+
+// agent type 用下划线（script_rewriter），skill 目录按 Mastra 规范用连字符（script-rewriter）
+const skillDirOf = (type) => type.replace(/_/g, '-')
+const skillBelongsTo = (skillId, type) => {
+  const dir = skillDirOf(type)
+  return skillId === dir || skillId.startsWith(dir + '/')
+}
+
+function agentSkillCount(type) {
+  return allSkills.value.filter(s => skillBelongsTo(s.id, type)).length
+}
+
+const currentSkills = computed(() =>
+  allSkills.value.filter(s => skillBelongsTo(s.id, selectedAgent.value))
+)
+
+async function loadAllSkills() {
+  try { allSkills.value = await skillsAPI.list(editLang.value) }
+  catch (e) { toastError(e) }
+}
+
+async function selectAgent(type) {
+  if (selectedAgent.value !== type) {
+    selectedAgent.value = type
+    editingSkill.value = null
+  }
+  await loadAgentPrompt(type)
+}
+
+function startAddSkill() {
+  newSkillForm.id = ''
+  newSkillForm.name = ''
+  newSkillForm.description = ''
+  addSkillDialog.value = true
+}
+
+async function confirmAddSkill() {
+  if (!newSkillForm.id) return
+  const skillId = `${skillDirOf(selectedAgent.value)}/${newSkillForm.id}`
+  try {
+    await skillsAPI.create({ id: skillId, name: newSkillForm.name, description: newSkillForm.description })
+    addSkillDialog.value = false
+    await loadAllSkills()
+    toast.success(t('settings.skills.created'))
+  } catch (e) {
+    toastError(e)
+  }
+}
+
+const skillToDelete = ref(null)
+const deletingSkill = ref(false)
+
+async function confirmDelSkill() {
+  const id = skillToDelete.value
+  if (!id) return
+  try {
+    deletingSkill.value = true
+    await skillsAPI.del(id)
+    if (editingSkill.value === id) editingSkill.value = null
+    await loadAllSkills()
+    skillToDelete.value = null
+    toast.success(t('index.deleted'))
+  } catch (e) {
+    toastError(e)
+  } finally {
+    deletingSkill.value = false
+  }
+}
+
+async function toggleSkillEdit(id) {
+  if (editingSkill.value === id) { editingSkill.value = null; return }
+  try {
+    const res = await skillsAPI.get(id, editLang.value)
+    skillContent.value = res.content
+    skillContentFallback.value = editLang.value !== 'zh' && !!res.is_default
+    skillSaved.value = null
+    editingSkill.value = id
+  } catch (e) { toastError(e) }
+}
+
+async function saveSkill(id) {
+  skillSaving.value = true
+  skillSaved.value = null
+  try {
+    await skillsAPI.update(id, skillContent.value, editLang.value)
+    await loadAllSkills()
+    skillContentFallback.value = false
+    skillSaved.value = id
+    toast.success(t('common.saved'))
+    setTimeout(() => { if (skillSaved.value === id) skillSaved.value = null }, 3000)
+  } catch (e) {
+    toastError(e)
+  } finally {
+    skillSaving.value = false
+  }
+}
+
+// ===== Style Presets =====
+const stylePresets = ref([])
+const styleDialog = ref(false)
+const styleEditId = ref(null)
+const styleForm = reactive({ name: '', value: '', prompt: '', description: '', sort_order: 0 })
+
+async function loadStylePresets() {
+  try { stylePresets.value = await stylePresetAPI.list(true) } catch (e) { toastError(e) }
+}
+
+async function toggleStyle(p) {
+  try {
+    await stylePresetAPI.update(p.id, { is_active: !p.is_active })
+    loadStylePresets()
+  } catch (e) { toastError(e) }
+}
+
+const styleToDelete = ref(null)
+const deletingStyle = ref(false)
+
+async function confirmDelStyle() {
+  const p = styleToDelete.value
+  if (!p) return
+  try {
+    deletingStyle.value = true
+    await stylePresetAPI.del(p.id)
+    styleToDelete.value = null
+    toast.success(t('index.deleted'))
+    loadStylePresets()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    deletingStyle.value = false
+  }
+}
+
+function startAddStyle() {
+  styleEditId.value = null
+  Object.assign(styleForm, {
+    name: '', value: '', prompt: '', description: '',
+    sort_order: (stylePresets.value.at(-1)?.sort_order ?? 0) + 1,
+  })
+  styleDialog.value = true
+}
+
+function startEditStyle(p) {
+  styleEditId.value = p.id
+  Object.assign(styleForm, {
+    name: p.name,
+    value: p.value,
+    prompt: p.prompt,
+    description: p.description || '',
+    sort_order: p.sort_order ?? 0,
+  })
+  styleDialog.value = true
+}
+
+async function saveStyle() {
+  if (!styleForm.name?.trim() || !styleForm.prompt?.trim() || (!styleEditId.value && !styleForm.value?.trim())) {
+    toast.warning(t('settings.styleDialog.required'))
+    return
+  }
+  try {
+    if (styleEditId.value) {
+      await stylePresetAPI.update(styleEditId.value, {
+        name: styleForm.name,
+        prompt: styleForm.prompt,
+        description: styleForm.description,
+        sort_order: styleForm.sort_order,
+      })
+    } else {
+      await stylePresetAPI.create({ ...styleForm })
+    }
+    styleDialog.value = false
+    toast.success(t('common.saved'))
+    loadStylePresets()
+  } catch (e) { toastError(e) }
+}
+
+onMounted(() => { loadCfgs(); loadAgents(); loadAllSkills(); loadAgentPrompt(selectedAgent.value); loadStylePresets() })
+
+// ===== 应用内引导（设置页）：快捷配置 + 手动模板两步 =====
+const SETTINGS_TOUR = [
+  { element: '.quick-card', titleKey: 'tour.settings.quick.title', descKey: 'tour.settings.quick.desc', popoverSide: 'bottom' },
+  { element: '.nav-item:has(.lucide-cpu), .nav-item:nth-of-type(1)', titleKey: 'tour.settings.nav.title', descKey: 'tour.settings.nav.desc', popoverSide: 'right' },
+]
+onMounted(() => setTimeout(() => autoTour('settings', SETTINGS_TOUR, t), 800))
+function replaySettingsTour() { startTour('settings', SETTINGS_TOUR, t) }
+
+// ===== 存储位置 =====
+const desktopBridge = useDesktopBridge()
+const { begin: beginMigrate, update: updateMigrate, end: endMigrate } = useMigrateState()
+
+const storageInfo = ref(null)
+const migrateDialog = ref(false)
+const migrateTarget = ref('')
+const migrateTargetFree = ref(null)
+const migrateFiles = ref(true)
+const migrating = ref(false)
+
+const isDesktopMode = computed(() => storageInfo.value?.mode === 'desktop' && !!desktopBridge)
+
+let usagePollTimer = null
+
+function stopUsagePoll() {
+  if (usagePollTimer) { clearInterval(usagePollTimer); usagePollTimer = null }
+}
+
+async function loadStorage() {
+  try {
+    storageInfo.value = await storageAPI.info()
+    // 占用为空或统计已过期时 2s 轮询至新鲜（后端 stale-while-revalidate）
+    stopUsagePoll()
+    if (storageInfo.value?.usageStale || !storageInfo.value?.usage) {
+      usagePollTimer = setInterval(async () => {
+        try {
+          storageInfo.value = await storageAPI.info()
+          if (storageInfo.value?.usage && !storageInfo.value?.usageStale) stopUsagePoll()
+        } catch { /* 轮询错误静默 */ }
+      }, 2000)
+    }
+  } catch (e) { toastError(e, { fallback: 'settings.storage.loadFailed' }) }
+}
+
+watch(tab, (active) => {
+  if (active === 'storage') loadStorage()
+  else stopUsagePoll()
+})
+
+async function pickTarget() {
+  if (!desktopBridge) return
+  const res = await desktopBridge.pickDirectory()
+  if (res.canceled) return
+  if (!res.ok || !res.path) { toastError(res.error, { fallback: 'settings.migrate.pickFailed' }); return }
+  migrateTarget.value = res.path
+  migrateTargetFree.value = res.freeBytes ?? null
+  migrateFiles.value = true
+  migrateDialog.value = true
+}
+
+async function startMigrate() {
+  if (!desktopBridge || !migrateTarget.value) return
+  migrating.value = true
+  beginMigrate()
+  try {
+    await desktopBridge.startMigration({ targetDir: migrateTarget.value, migrateFiles: migrateFiles.value })
+    // 成功的完成提示与页面刷新由全局进度订阅（app.vue）处理
+  } catch (e) {
+    endMigrate()
+    toastError(e, { fallback: 'settings.migrate.failed' })
+  } finally {
+    migrating.value = false
+    migrateDialog.value = false
+    stopUsagePoll()
+  }
+}
+
+function formatBytes(n) {
+  if (!Number.isFinite(n)) return '—'
+  if (n >= 1024 ** 3) return `${(n / 1024 ** 3).toFixed(1)} GB`
+  if (n >= 1024 ** 2) return `${(n / 1024 ** 2).toFixed(0)} MB`
+  if (n >= 1024) return `${(n / 1024).toFixed(0)} KB`
+  return `${n} B`
+}
+
+// ===== 应用内更新（桌面版走 Electron 桥；服务器/Docker 走后端 server-update 路由） =====
+const updateState = ref(null)
+const updateChecking = ref(false)
+const updateDownloading = ref(false)
+const updateProgress = ref(0)
+const updateApplying = ref(false)
+const serverUpdateMode = ref('manual') // 'watchtower' | 'manual'，仅服务器模式有意义
+
+async function refreshUpdateState() {
+  try {
+    if (desktopBridge) {
+      updateState.value = await desktopBridge.getUpdateState()
+    } else {
+      const s = await serverUpdateAPI.state()
+      serverUpdateMode.value = s.updateMode || 'manual'
+      updateState.value = s
+    }
+  } catch { /* 静默 */ }
+}
+
+async function checkUpdate() {
+  updateChecking.value = true
+  try {
+    if (desktopBridge) {
+      updateState.value = await desktopBridge.checkUpdate()
+    } else {
+      const s = await serverUpdateAPI.check()
+      serverUpdateMode.value = s.updateMode || 'manual'
+      updateState.value = s
+    }
+    if (updateState.value?.status === 'up-to-date') toast.success(t('settings.about.upToDate'))
+  } catch (e) {
+    toastError(e, { fallback: 'settings.about.checkFailedToast' })
+    refreshUpdateState()
+  } finally { updateChecking.value = false }
+}
+
+async function downloadUpdate() {
+  if (!desktopBridge) return
+  updateDownloading.value = true
+  updateProgress.value = 0
+  const unProgress = desktopBridge.onUpdateProgress((p) => { updateProgress.value = p })
+  try {
+    updateState.value = await desktopBridge.downloadUpdate()
+    toast.success(t('settings.about.downloadDone'))
+  } catch (e) {
+    toastError(e, { fallback: 'settings.about.downloadFailed' })
+    refreshUpdateState()
+  } finally {
+    unProgress()
+    updateDownloading.value = false
+  }
+}
+
+async function applyUpdate() {
+  updateApplying.value = true
+  try {
+    if (desktopBridge) {
+      await desktopBridge.applyUpdate()
+      // 成功路径：应用退出并由更新后的版本接管，不会走到这里
+    } else {
+      await serverUpdateAPI.apply()
+      // Watchtower 异步拉镜像重建容器，本进程随后被替换
+      toast.success(t('settings.about.serverApplyStarted'), { duration: 8000 })
+      updateApplying.value = false
+    }
+  } catch (e) {
+    updateApplying.value = false
+    toastError(e, { fallback: desktopBridge ? 'settings.about.installFailed' : 'settings.about.serverApplyFailed' })
+    refreshUpdateState()  // 桌面端 apply 失败会把具体原因写进 updateState.error，刷新显示在错误行
+  }
+}
+
+watch(tab, (t) => {
+  if (t === 'about') refreshUpdateState()
+  // 进入 Agent 页总是按当前内容语言重载（幂等）：兜住「先切语言、后进 Agent」的时序
+  if (t === 'agents') {
+    loadAgentPrompt(selectedAgent.value)
+    loadAllSkills()
+  }
+})
+
+onBeforeUnmount(stopUsagePoll)
+</script>
+
+<style scoped>
+.settings-page { display: flex; flex-direction: column; height: 100%; background: var(--bg-base); }
+
+.settings-layout { display: flex; flex: 1; min-height: 0; }
+
+.settings-nav {
+  width: 220px; flex-shrink: 0; padding: 16px 12px 16px; border-right: 1px solid var(--border);
+  display: flex; flex-direction: column; gap: 14px;
+}
+.nav-group { display: flex; flex-direction: column; gap: 2px; }
+.nav-group-label {
+  font-size: 11px; font-weight: 650; color: var(--text-3);
+  letter-spacing: 0.06em; padding: 8px 12px 4px;
+}
+.nav-item {
+  display: flex; align-items: center; gap: 8px;
+  padding: 8px 12px; font-size: 13px; font-weight: 550;
+  border: none; border-radius: var(--radius); background: transparent; color: var(--text-1);
+  cursor: pointer; transition: all 0.16s var(--ease-out); text-align: left; width: 100%;
+}
+.nav-item:hover { background: var(--bg-hover); color: var(--text-0); }
+.nav-item.active { background: var(--accent-bg); color: var(--accent-text); font-weight: 650; }
+.nav-item:focus-visible { outline: none; box-shadow: 0 0 0 3.5px var(--button-focus); }
+
+.settings-content { flex: 1; min-width: 0; min-height: 0; overflow: hidden; }
+.settings-scroll { height: 100%; overflow-y: auto; padding: 20px 28px 48px; animation: fadeUp 0.3s var(--ease-out); }
+/* 各分组卡片之间的间距（通用页内容语言/外观等） */
+.settings-scroll > .card + .card { margin-top: 14px; }
+/* 宽屏下内容列限宽居中，两侧留出呼吸空间 */
+.settings-scroll > * { max-width: 1080px; margin-left: auto; margin-right: auto; }
+.settings-head { margin-bottom: 20px; }
+.settings-title { font-size: 22px; font-weight: 800; letter-spacing: -0.02em; }
+.settings-desc { font-size: 13px; color: var(--text-2); margin-top: 6px; }
+
+/* 火宝快捷配置 */
+.quick-card {
+  padding: 20px;
+  margin-bottom: 16px;
+  border: 1.5px solid var(--accent);
+}
+.quick-card:hover { border-color: var(--accent); }
+.quick-card-head { display: flex; align-items: center; gap: 10px; margin-bottom: 6px; }
+.setup-title { font-size: 15px; font-weight: 700; color: var(--text-0); }
+.setup-desc { font-size: 12.5px; color: var(--text-2); margin-bottom: 14px; }
+.huobao-site-link {
+  display: inline-flex; align-items: center; gap: 3px;
+  margin-left: 6px;
+  color: var(--accent); text-decoration: none;
+  font-weight: 600; white-space: nowrap;
+}
+.huobao-site-link:hover { text-decoration: underline; }
+.huobao-quick-row {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto auto;
+  gap: 10px;
+  align-items: center;
+}
+.huobao-quick-models {
+  margin-top: 14px;
+  display: flex;
+  flex-direction: column;
+  gap: 7px;
+}
+.hqm-row {
+  display: flex;
+  align-items: baseline;
+  gap: 10px;
+  font-size: 11px;
+  line-height: 1.6;
+}
+.hqm-label {
+  flex-shrink: 0;
+  width: 28px;
+  font-weight: 600;
+  color: var(--text-2);
+}
+.hqm-provider {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 1px 6px;
+  border-radius: 4px;
+  background: var(--accent-bg);
+  color: var(--accent);
+  font-size: 9px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.02em;
+}
+.hqm-provider-icon { width: 11px; height: 11px; object-fit: contain; border-radius: 2px; }
+.hqm-models {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 12px;
+  color: var(--text-3);
+}
+.hqm-model.is-default { color: var(--text-1); font-weight: 600; }
+.hqm-model em {
+  font-style: normal;
+  margin-left: 4px;
+  padding: 0 5px;
+  border-radius: 5px;
+  font-size: 10px;
+  font-weight: 600;
+  color: var(--accent-text);
+  background: var(--accent-bg);
+}
+
+/* 模型标签编辑器（配置弹窗） */
+.model-chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-bottom: 8px;
+}
+.model-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 4px 8px;
+  border: 1px solid var(--border);
+  border-radius: 7px;
+  font-size: 12px;
+  color: var(--text-2);
+  background: var(--bg-2);
+  cursor: pointer;
+  user-select: none;
+  transition: border-color .15s, color .15s;
+}
+.model-chip:hover { border-color: var(--accent); color: var(--text-1); }
+.model-chip.is-default { color: var(--text-1); font-weight: 600; border-color: var(--accent); }
+.model-chip em {
+  font-style: normal;
+  padding: 0 5px;
+  border-radius: 5px;
+  font-size: 10px;
+  font-weight: 600;
+  color: var(--accent-text);
+  background: var(--accent-bg);
+}
+.model-chip-x {
+  display: inline-flex;
+  align-items: center;
+  padding: 1px;
+  border: none;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--text-3);
+  cursor: pointer;
+}
+.model-chip-x:hover { color: var(--error); background: var(--bg-3); }
+.model-add-row { display: flex; gap: 8px; }
+.model-add-row .input { flex: 1; }
+
+/* 手动模板 */
+.setup-panel { padding: 18px 20px; margin-bottom: 16px; }
+.setup-panel-head {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 14px;
+}
+.setup-panel-head.compact { margin-bottom: 12px; }
+.template-row { display: flex; flex-wrap: wrap; gap: 8px; }
+.template-type-chip {
+  min-height: var(--button-height-sm);
+  padding: 0 14px;
+  border: none;
+  border-radius: var(--radius-pill);
+  background: var(--button-bg);
+  color: var(--text-1);
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 1;
+  cursor: pointer;
+  transition: all 0.16s var(--ease-out);
+}
+.template-type-chip:hover { background: var(--button-bg-hover); color: var(--text-0); }
+.template-type-chip:focus-visible { outline: none; box-shadow: 0 0 0 3.5px var(--button-focus); }
+
+/* ===== 内容语言选择器（通用 tab） ===== */
+.lang-picker { display: flex; gap: 2px; padding: 3px; border-radius: var(--radius-pill); background: var(--overlay-track); }
+.lang-option {
+  min-height: 30px;
+  padding: 0 14px;
+  border: none;
+  border-radius: var(--radius-pill);
+  background: transparent;
+  color: var(--text-2);
+  font-size: 12.5px;
+  font-weight: 600;
+  line-height: 1;
+  cursor: pointer;
+  transition: all 0.16s var(--ease-out);
+  white-space: nowrap;
+}
+.lang-option:hover { color: var(--text-0); }
+.lang-option.on { background: var(--seg-active-bg); color: var(--text-0); box-shadow: 0 1px 4px rgba(0,0,0,0.1); }
+.lang-option:focus-visible { outline: none; box-shadow: 0 0 0 3.5px var(--button-focus); }
+
+/* 按服务类型分组的配置卡 */
+.sections { display: flex; flex-direction: column; gap: 16px; }
+.svc-group { overflow: hidden; }
+.svc-group-head {
+  display: flex; align-items: center; gap: 10px;
+  padding: 14px 20px;
+  border-bottom: 1px solid var(--border);
+}
+.svc-group-heading { min-width: 0; }
+.svc-group-title { font-size: 14px; font-weight: 700; color: var(--text-0); }
+.svc-group-sub { font-size: 11.5px; color: var(--text-3); margin-top: 2px; }
+.config-row { display: flex; align-items: center; gap: 12px; padding: 12px 20px; }
+.config-row + .config-row { border-top: 1px solid var(--border); }
+.provider-badge {
+  width: 36px; height: 36px; border-radius: 10px; flex-shrink: 0;
+  display: flex; align-items: center; justify-content: center;
+  font-weight: 700; font-size: 14px; color: var(--on-accent);
+  background: var(--accent);
+  box-shadow: 0 1px 4px rgba(0,0,0,0.12);
+}
+.provider-badge[data-provider="openai"] { background: #10a37f; }
+.provider-badge[data-provider="gemini"] { background: #4285f4; }
+.provider-badge[data-provider="volcengine"] { background: #ff5c39; }
+/* 有厂商图标时用中性底，彩色图标直接展示 */
+.provider-badge.has-icon { background: var(--bg-2); }
+.provider-badge-icon { width: 20px; height: 20px; object-fit: contain; }
+.config-main { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 3px; }
+.config-line { display: flex; align-items: center; gap: 8px; min-width: 0; }
+.config-name { font-size: 13.5px; font-weight: 650; color: var(--text-0); }
+.config-sub { font-size: 11.5px; color: var(--text-3); }
+.config-models { display: flex; flex-wrap: wrap; gap: 4px; margin: 3px 0; }
+.cfg-model-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  padding: 1px 7px;
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  background: transparent;
+  color: var(--text-2);
+  font-size: 10.5px;
+  cursor: pointer;
+  transition: border-color 0.12s, color 0.12s, background 0.12s;
+}
+.cfg-model-chip:hover { border-color: var(--accent); color: var(--accent); }
+.cfg-model-chip.is-default {
+  border-color: var(--accent);
+  background: var(--accent-bg);
+  color: var(--accent);
+  font-weight: 600;
+  cursor: default;
+}
+.cfg-model-star { fill: currentColor; }
+.config-empty { font-size: 12px; color: var(--text-3); padding: 14px 20px; }
+.config-switch { display: inline-flex; flex-shrink: 0; cursor: pointer; }
+.config-switch input:focus-visible + .switch { box-shadow: 0 0 0 3.5px var(--button-focus); }
+.btn-icon.btn-sm { width: 30px; min-width: 30px; height: 30px; min-height: 30px; }
+
+/* Agent */
+.agent-card { overflow: hidden; }
+.agent-type-badge {
+  width: 36px; height: 36px; border-radius: 10px;
+  background: var(--accent-bg); color: var(--accent-text);
+  display: flex; align-items: center; justify-content: center;
+  font-size: 16px; flex-shrink: 0;
+}
+.agent-card-body { padding: 16px 18px 18px; display: flex; flex-direction: column; gap: 12px; }
+/* tab 头在上，body 不再需要顶边框（头自带 border-bottom） */
+.agent-card-foot { display: flex; align-items: center; gap: 8px; padding-top: 4px; }
+
+/* Agent 右侧子 tab（System Prompt / Skills）：作为卡片头，与卡片同宽，不再单独悬浮 */
+.agent-pane-tabs {
+  display: flex; align-items: center; justify-content: space-between; gap: 12px;
+  padding: 10px 16px;
+  border-bottom: 1px solid var(--border);
+}
+.agent-pane-tabs-wrap .agent-pane-tabs { border-bottom: 1px solid var(--border); }
+.agent-pane-tabs-wrap { padding: 0; margin-bottom: 14px; overflow: hidden; }
+.agent-pane-tabs-nav {
+  display: grid; grid-auto-flow: column; grid-auto-columns: 1fr; padding: 3px;
+  background: var(--bg-1); border: 1px solid var(--border); border-radius: 10px;
+}
+.agent-pane-tab {
+  padding: 5px 18px; border: none; border-radius: 7px;
+  background: transparent; color: var(--text-2);
+  font: 600 12px var(--font-body); cursor: pointer;
+  white-space: nowrap; text-align: center;
+  transition: background 0.15s, color 0.15s;
+}
+.agent-pane-tab:hover { color: var(--text-0); }
+.agent-pane-tab.active { background: var(--accent-bg); color: var(--accent-text); }
+
+/* Agent 编辑语言跟随提示（卡片头右侧只读说明，切换请到「通用」页） */
+.agent-lang-follow { font-size: 11px; }
+
+/* 「跟随中文」回退提示 */
+.agent-fallback-tag {
+  margin-left: 6px;
+  background: var(--bg-2); color: var(--text-3);
+  font-size: 10px; font-weight: 500;
+}
+
+/* 编辑器尽量占满剩余视口高度，仍可手动拖拽 */
+.agent-prompt-input { min-height: max(320px, calc(100vh - 340px)); resize: vertical; }
+.skill-content-input { min-height: max(300px, calc(100vh - 420px)); resize: vertical; }
+
+/* Skills 布局 */
+.skills-layout { display: flex; height: 100%; overflow: hidden; }
+.skills-agent-list {
+  width: 210px; flex-shrink: 0; border-right: 1px solid var(--border);
+  display: flex; flex-direction: column; gap: 4px;
+  overflow-y: auto; padding: 20px 10px 16px;  /* 顶 padding 与右侧标题行起点对齐 */
+}
+.skills-agent-title {
+  font-size: 11px; font-weight: 650; letter-spacing: 0.06em;
+  color: var(--text-3); padding: 8px 10px 4px;
+}
+.skills-agent-item {
+  display: flex; align-items: center; gap: 8px;
+  padding: 7px 10px; font-size: 13px; font-weight: 550; cursor: pointer;
+  border: none; border-radius: var(--radius); background: transparent; color: var(--text-1);
+  transition: all 0.16s var(--ease-out); width: 100%; text-align: left;
+}
+.skills-agent-item:hover { background: var(--bg-hover); color: var(--text-0); }
+.skills-agent-item.active { background: var(--accent-bg); color: var(--accent-text); font-weight: 650; }
+.skills-agent-item:focus-visible { outline: none; box-shadow: 0 0 0 3.5px var(--button-focus); }
+.skills-agent-item .agent-type-badge { width: 26px; height: 26px; border-radius: 8px; font-size: 13px; }
+.skills-agent-label { flex: 1; min-width: 0; }
+.skill-count-badge {
+  font-size: 10px; font-weight: 700; font-family: var(--font-mono);
+  background: var(--bg-active); color: var(--text-2);
+  padding: 1px 6px; border-radius: 99px;
+}
+.skills-agent-item.active .skill-count-badge { background: var(--accent-bg); color: var(--accent-text); }
+.skills-main { flex: 1; min-width: 0; }
+.skills-head {
+  display: flex;
+  align-items: flex-start;   /* 以标题块顶部为基线，徽章/按钮对齐标题第一行 */
+  gap: 12px;
+}
+.skills-head .settings-title { line-height: 26px; }
+.skills-head .btn { margin-top: -2px; }  /* 视觉上与标题第一行居中（按钮比标题行高） */
+.skills-head-badge { width: 32px; height: 32px; font-size: 16px; }
+.skills-head-copy { min-width: 0; }
+.skills-empty { padding: 48px 24px; text-align: center; }
+.skills-empty-icon {
+  width: 56px; height: 56px; border-radius: 16px; margin: 0 auto 12px;
+  background: var(--accent-bg); color: var(--accent-text);
+  display: flex; align-items: center; justify-content: center;
+}
+.skills-empty-title { font-size: 14px; font-weight: 650; color: var(--text-0); }
+.skills-empty-desc { font-size: 12px; color: var(--text-3); margin-top: 4px; }
+
+/* Skill */
+.skill-list { display: flex; flex-direction: column; gap: 10px; }
+.skill-card { overflow: hidden; }
+.skill-card-head { display: flex; align-items: center; gap: 10px; padding: 12px 16px; cursor: pointer; transition: background 0.15s; }
+.skill-card-head:hover { background: var(--bg-hover); }
+.skill-card-body { padding: 14px 16px 16px; display: flex; flex-direction: column; gap: 10px; border-top: 1px solid var(--border); }
+.skill-card-foot { display: flex; align-items: center; gap: 8px; }
+
+/* Shared */
+.field { display: flex; flex-direction: column; gap: 5px; }
+.field-label { font-size: 12px; font-weight: 550; color: var(--text-1); }
+.field-hint { font-size: 11px; color: var(--text-3); margin-top: 2px; }
+.required { color: var(--error); }
+.field-row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
+
+/* Dialogs */
+.config-dialog { width: min(720px, calc(100vw - 40px)); }
+.config-dialog-body { display: flex; flex-direction: column; gap: 14px; }
+.skill-dialog { width: 440px; }
+.skill-dialog-body { display: flex; flex-direction: column; gap: 12px; }
+.dialog-sub { margin-top: 4px; font-size: 12px; color: var(--text-2); }
+.test-draft-btn { margin-right: auto; }
+.preset-picker { display: flex; flex-wrap: wrap; gap: 8px; }
+.preset-pill {
+  min-height: var(--button-height-sm);
+  padding: 0 14px;
+  border: none;
+  border-radius: var(--radius-pill);
+  background: var(--button-bg);
+  color: var(--text-1);
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 1;
+  cursor: pointer;
+  transition: all 0.16s var(--ease-out);
+}
+.preset-pill:hover { background: var(--button-bg-hover); color: var(--text-0); }
+.preset-pill:focus-visible { outline: none; box-shadow: 0 0 0 3.5px var(--button-focus); }
+.test-result {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  border-radius: var(--radius-lg);
+  padding: 12px 14px;
+  border: 1px solid var(--border);
+  background: var(--bg-0);
+}
+.test-result.ok { border-color: var(--success); background: var(--success-bg); }
+.test-result.bad { border-color: var(--error); background: var(--error-bg); }
+.test-result-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  color: var(--text-1);
+}
+.test-result-url,
+.test-result-preview {
+  font-size: 11px;
+  color: var(--text-2);
+  word-break: break-all;
+}
+
+/* 存储位置 */
+.storage-breakdown {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 2px;
+}
+.migrate-warn {
+  color: var(--error);
+}
+.update-bar {
+  width: 220px;
+  height: 5px;
+  border-radius: 3px;
+  background: var(--overlay-track);
+  overflow: hidden;
+  margin-top: 6px;
+}
+.update-bar-fill {
+  height: 100%;
+  border-radius: 3px;
+  background: var(--accent);
+  transition: width 0.2s ease;
+}
+</style>
diff --git a/huobao-source/frontend/app/plugins/i18n.client.ts b/huobao-source/frontend/app/plugins/i18n.client.ts
new file mode 100644
index 0000000..e30b69b
--- /dev/null
+++ b/huobao-source/frontend/app/plugins/i18n.client.ts
@@ -0,0 +1,5 @@
+import { i18n } from '~/composables/i18n'
+
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.vueApp.use(i18n)
+})
diff --git a/huobao-source/frontend/app/plugins/tour.client.ts b/huobao-source/frontend/app/plugins/tour.client.ts
new file mode 100644
index 0000000..d94fe44
--- /dev/null
+++ b/huobao-source/frontend/app/plugins/tour.client.ts
@@ -0,0 +1,10 @@
+/**
+ * 启动时预取「已看过的引导漫游」标记（存服务端 app_settings）。
+ * 不 await：autoTour 在各页面 onMounted 后延迟数百 ms 触发，水合早已完成；
+ * 失败时 useTour 自动回退 localStorage。
+ */
+import { hydrateTours } from '~/composables/useTour'
+
+export default defineNuxtPlugin(() => {
+  void hydrateTours()
+})
diff --git a/huobao-source/frontend/app/public/favicon.png b/huobao-source/frontend/app/public/favicon.png
new file mode 100644
index 0000000..dfb21b8
Binary files /dev/null and b/huobao-source/frontend/app/public/favicon.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/claude-color.png b/huobao-source/frontend/app/public/icons/dark/claude-color.png
new file mode 100644
index 0000000..e29be47
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/claude-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/deepseek-color.png b/huobao-source/frontend/app/public/icons/dark/deepseek-color.png
new file mode 100644
index 0000000..3b2b8a2
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/deepseek-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/doubao-color.png b/huobao-source/frontend/app/public/icons/dark/doubao-color.png
new file mode 100644
index 0000000..fbd70c1
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/doubao-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/gemini-color.png b/huobao-source/frontend/app/public/icons/dark/gemini-color.png
new file mode 100644
index 0000000..e539633
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/gemini-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/grok.png b/huobao-source/frontend/app/public/icons/dark/grok.png
new file mode 100644
index 0000000..04f4b59
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/grok.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/kimi-color.png b/huobao-source/frontend/app/public/icons/dark/kimi-color.png
new file mode 100644
index 0000000..374b0dd
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/kimi-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/midjourney.png b/huobao-source/frontend/app/public/icons/dark/midjourney.png
new file mode 100644
index 0000000..094c72d
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/midjourney.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/minimax-color.png b/huobao-source/frontend/app/public/icons/dark/minimax-color.png
new file mode 100644
index 0000000..e9472c6
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/minimax-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/ollama.png b/huobao-source/frontend/app/public/icons/dark/ollama.png
new file mode 100644
index 0000000..873fe7c
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/ollama.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/openai.png b/huobao-source/frontend/app/public/icons/dark/openai.png
new file mode 100644
index 0000000..c784cfb
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/openai.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/qwen-color.png b/huobao-source/frontend/app/public/icons/dark/qwen-color.png
new file mode 100644
index 0000000..2667528
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/qwen-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/vidu-color.png b/huobao-source/frontend/app/public/icons/dark/vidu-color.png
new file mode 100644
index 0000000..9ac18c2
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/vidu-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/volcengine-color.png b/huobao-source/frontend/app/public/icons/dark/volcengine-color.png
new file mode 100644
index 0000000..3c3bd3f
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/volcengine-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/xiaomi-color.png b/huobao-source/frontend/app/public/icons/dark/xiaomi-color.png
new file mode 100644
index 0000000..f209e12
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/xiaomi-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/dark/zhipu-color.png b/huobao-source/frontend/app/public/icons/dark/zhipu-color.png
new file mode 100644
index 0000000..25ad4f4
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/dark/zhipu-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/claude-color.png b/huobao-source/frontend/app/public/icons/light/claude-color.png
new file mode 100644
index 0000000..e29be47
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/claude-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/deepseek-color.png b/huobao-source/frontend/app/public/icons/light/deepseek-color.png
new file mode 100644
index 0000000..3b2b8a2
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/deepseek-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/doubao-color.png b/huobao-source/frontend/app/public/icons/light/doubao-color.png
new file mode 100644
index 0000000..fbd70c1
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/doubao-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/gemini-color.png b/huobao-source/frontend/app/public/icons/light/gemini-color.png
new file mode 100644
index 0000000..e539633
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/gemini-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/grok.png b/huobao-source/frontend/app/public/icons/light/grok.png
new file mode 100644
index 0000000..0a3bd48
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/grok.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/kimi-color.png b/huobao-source/frontend/app/public/icons/light/kimi-color.png
new file mode 100644
index 0000000..a0491bf
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/kimi-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/midjourney.png b/huobao-source/frontend/app/public/icons/light/midjourney.png
new file mode 100644
index 0000000..23728c7
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/midjourney.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/minimax-color.png b/huobao-source/frontend/app/public/icons/light/minimax-color.png
new file mode 100644
index 0000000..e9472c6
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/minimax-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/ollama.png b/huobao-source/frontend/app/public/icons/light/ollama.png
new file mode 100644
index 0000000..bda0a8b
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/ollama.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/openai.png b/huobao-source/frontend/app/public/icons/light/openai.png
new file mode 100644
index 0000000..0a3405d
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/openai.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/qwen-color.png b/huobao-source/frontend/app/public/icons/light/qwen-color.png
new file mode 100644
index 0000000..2667528
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/qwen-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/vidu-color.png b/huobao-source/frontend/app/public/icons/light/vidu-color.png
new file mode 100644
index 0000000..9ac18c2
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/vidu-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/volcengine-color.png b/huobao-source/frontend/app/public/icons/light/volcengine-color.png
new file mode 100644
index 0000000..3c3bd3f
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/volcengine-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/xiaomi-color.png b/huobao-source/frontend/app/public/icons/light/xiaomi-color.png
new file mode 100644
index 0000000..f209e12
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/xiaomi-color.png differ
diff --git a/huobao-source/frontend/app/public/icons/light/zhipu-color.png b/huobao-source/frontend/app/public/icons/light/zhipu-color.png
new file mode 100644
index 0000000..25ad4f4
Binary files /dev/null and b/huobao-source/frontend/app/public/icons/light/zhipu-color.png differ
diff --git a/huobao-source/frontend/app/utils/prompt-mentions.js b/huobao-source/frontend/app/utils/prompt-mentions.js
new file mode 100644
index 0000000..9a9e0f8
--- /dev/null
+++ b/huobao-source/frontend/app/utils/prompt-mentions.js
@@ -0,0 +1,53 @@
+export const mentionToken = option => `${option.trigger || '@'}${option.value}`
+
+export function mentionEntries(options) {
+  const seen = new Map()
+  for (const option of options) {
+    const token = mentionToken(option)
+    if (option.value && !seen.has(token)) {
+      seen.set(token, option.kind === 'voice' ? 'voice' : option.kind === 'scene' ? 'scene' : 'role')
+    }
+  }
+  // Legacy saved voice tokens remain highlighted/deletable; new insertions use #Name.
+  for (const option of options) {
+    for (const alias of option.aliases || []) {
+      const token = `${option.trigger || '@'}${alias}`
+      if (!seen.has(token)) seen.set(token, option.kind === 'voice' ? 'voice' : 'role')
+    }
+  }
+  return [...seen.entries()].sort((a, b) => b[0].length - a[0].length)
+}
+
+export function activeMentionAt(text, position, options) {
+  const match = text.slice(0, position).match(/([@#])([^\s@#]{0,100})$/)
+  // Chinese dialogue follows a token without spaces: #林小雨轻声说. Do not reopen
+  // the dropdown while typing the dialogue, but allow searching for a longer name.
+  if (match && options && mentionEntries(options).some(([token]) => match[0].startsWith(token)) &&
+      !options.some(option => (option.trigger || '@') === match[1] && String(option.value).toLowerCase().includes(match[2].toLowerCase()))) return null
+  return match ? { start: position - match[0].length, trigger: match[1], query: match[2] } : null
+}
+
+const escapeHtml = text => text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+const escapeRegExp = text => text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+
+export function highlightMentions(text, options) {
+  const entries = mentionEntries(options)
+  if (!entries.length) return escapeHtml(text) + (text.endsWith('\n') ? '\u200b' : '')
+  const pattern = new RegExp(entries.map(([token]) => escapeRegExp(token)).join('|'), 'g')
+  const styles = new Map(entries)
+  let html = '', start = 0
+  for (const match of text.matchAll(pattern)) {
+    html += escapeHtml(text.slice(start, match.index))
+    html += `<span class="mention-token mention-token-${styles.get(match[0])}">${escapeHtml(match[0])}</span>`
+    start = match.index + match[0].length
+  }
+  return html + escapeHtml(text.slice(start)) + (text.endsWith('\n') ? '\u200b' : '')
+}
+
+export function mentionDeletionRange(text, position, options, backwards) {
+  for (const [token] of mentionEntries(options)) {
+    if (backwards && text.slice(0, position).endsWith(token)) return { start: position - token.length, end: position }
+    if (!backwards && text.slice(position).startsWith(token)) return { start: position, end: position + token.length }
+  }
+  return null
+}
diff --git a/huobao-source/frontend/app/utils/text-model-selection.ts b/huobao-source/frontend/app/utils/text-model-selection.ts
new file mode 100644
index 0000000..b065ed1
--- /dev/null
+++ b/huobao-source/frontend/app/utils/text-model-selection.ts
@@ -0,0 +1,13 @@
+interface TextModelOption {
+  key: string
+  model: string
+  configId: number
+}
+
+/** 默认项显示 options[0]，请求也必须使用同一模型及其配置，避免后端再次选型。 */
+export function resolveTextModelSelection(options: TextModelOption[], selectedKey: string) {
+  const selected = options.find(option => option.key === selectedKey)
+    ?? options.find(option => option.model === selectedKey) // 兼容旧版存储的裸模型名
+    ?? options[0]
+  return { model: selected?.model, configId: selected?.configId }
+}
diff --git a/huobao-source/frontend/app/views/drama/detail.vue b/huobao-source/frontend/app/views/drama/detail.vue
new file mode 100644
index 0000000..d8f3afc
--- /dev/null
+++ b/huobao-source/frontend/app/views/drama/detail.vue
@@ -0,0 +1,1635 @@
+<template>
+  <div class="page" v-if="drama">
+    <!-- Header：单行紧凑 -->
+    <div class="page-head card">
+      <button class="back-btn" :title="t('common.back')" @click="navigateTo('/')">
+        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <line x1="19" y1="12" x2="5" y2="12"/><polyline points="12 19 5 12 12 5"/>
+        </svg>
+      </button>
+      <div class="head-info">
+        <h1 class="page-title">{{ drama.title }}</h1>
+        <span v-if="drama.style" class="tag tag-accent">{{ drama.style }}</span>
+        <div class="page-meta">
+          <span class="meta-item">
+            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/><circle cx="12" cy="7" r="4"/></svg>
+            {{ t('detail.head.charCount', { n: drama.characters?.length || 0 }) }}
+          </span>
+          <span class="meta-item">
+            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18"/></svg>
+            {{ t('detail.head.sceneCount', { n: drama.scenes?.length || 0 }) }}
+          </span>
+          <span class="meta-item">
+            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="2" width="20" height="20" rx="2.5"/><line x1="7" y1="8" x2="7" y2="16"/><line x1="10" y1="8" x2="10" y2="16"/><line x1="13" y1="8" x2="13" y2="16"/><line x1="16" y1="8" x2="16" y2="16"/></svg>
+            {{ t('detail.head.epCount', { n: drama.episodes?.length || 0 }) }}
+          </span>
+        </div>
+      </div>
+      <button class="btn btn-primary head-action" @click="openAddEpisode">
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round">
+          <line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/>
+        </svg>
+        {{ t('detail.head.addEpisode') }}
+      </button>
+    </div>
+
+    <!-- 主 Tab：剧集列表 / 素材库 -->
+    <nav class="page-tabs">
+      <button type="button" :class="['tab-btn', { on: activeTab === 'episodes' }]" @click="activeTab = 'episodes'">
+        <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="2" width="20" height="20" rx="2.5"/><line x1="7" y1="8" x2="7" y2="16"/><line x1="10" y1="8" x2="10" y2="16"/><line x1="13" y1="8" x2="13" y2="16"/><line x1="16" y1="8" x2="16" y2="16"/></svg>
+        {{ t('detail.tabs.episodes') }}
+        <span class="tab-count">{{ drama.episodes?.length || 0 }}</span>
+      </button>
+      <button type="button" :class="['tab-btn', { on: activeTab === 'assets' }]" @click="switchToAssets">
+        <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><polyline points="21 15 16 10 5 21"/></svg>
+        {{ t('detail.tabs.assets') }}
+        <span v-if="assetTotal > 0" class="tab-count">{{ assetTotal }}</span>
+      </button>
+    </nav>
+
+    <div v-if="activeTab === 'episodes'" class="ep-grid">
+      <div
+        v-for="(ep, i) in drama.episodes"
+        :key="ep.id"
+        :class="['card', 'ep-card', `ep-card-${epStatus(ep)}`]"
+        :style="{ animationDelay: `${i * 0.05}s` }"
+        @click="navigateTo(`/drama/${drama.id}/episode/${ep.episode_number || ep.episodeNumber}`)"
+      >
+        <!-- 上区：编号 + 标题元数据 + 状态 -->
+        <div class="ep-card-top">
+          <div :class="['ep-number', `ep-num-${epStatus(ep)}`]">
+            <span class="ep-num-label">EP</span>
+            <b>{{ String(ep.episode_number || ep.episodeNumber).padStart(2, '0') }}</b>
+          </div>
+          <div class="ep-main">
+            <h3 class="ep-title">{{ ep.title }}</h3>
+            <div class="ep-meta-row">
+              <span v-if="ep.duration" class="ep-meta">
+                <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg>
+                {{ ep.duration }}s
+              </span>
+              <span v-if="ep.scriptContent || ep.script_content" class="ep-meta ep-meta-ok">
+                <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/></svg>
+                {{ t('detail.ep.scriptReady') }}
+              </span>
+              <span v-if="ep.videoUrl || ep.video_url" class="ep-meta ep-meta-ok">
+                <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2"/></svg>
+                {{ t('detail.ep.merged') }}
+              </span>
+              <span v-if="ep.updatedAt || ep.updated_at" class="ep-meta ep-time">{{ formatEpTime(ep.updatedAt || ep.updated_at) }}</span>
+            </div>
+          </div>
+          <div class="ep-badges" @click.stop>
+            <AppMenu
+              :open="epStatusMenuId === ep.id"
+              placement="bottom-end"
+              :min-width="110"
+              @update:open="(v) => { epStatusMenuId = v ? ep.id : null }"
+            >
+              <template #trigger>
+                <button type="button" :class="['tag', 'ep-status-btn', `ep-status-${epStatus(ep)}`]" :title="t('detail.ep.statusTitle')">
+                  <span :class="['status-dot', epStatusDotClass(ep)]"></span>
+                  {{ epStatusLabel(ep) }}
+                </button>
+              </template>
+              <AppMenuItem
+                v-for="s in epStatusOptions"
+                :key="s.value"
+                :selected="epStatus(ep) === s.value"
+                @click="setEpisodeStatus(ep, s.value)"
+              >{{ s.label }}</AppMenuItem>
+            </AppMenu>
+          </div>
+        </div>
+
+        <!-- 下区：常驻操作条 — 分辨率 / 删除 / 进入制作 -->
+        <div class="ep-card-foot" @click.stop>
+          <AppMenu
+            :open="epResMenuId === ep.id"
+            placement="top-start"
+            :min-width="110"
+            @update:open="(v) => { epResMenuId = v ? ep.id : null }"
+          >
+            <template #trigger>
+              <button type="button" :class="['tag', 'ep-res-btn']" :title="t('detail.ep.resTitle')">
+                {{ epResolution(ep) }}
+              </button>
+            </template>
+            <AppMenuItem
+              v-for="r in resolutionOptions"
+              :key="r.value"
+              :selected="epResolution(ep) === r.value"
+              @click="setEpisodeResolution(ep, r.value)"
+            >{{ r.label }}</AppMenuItem>
+          </AppMenu>
+          <span class="ep-foot-spacer"></span>
+          <button
+            class="btn btn-icon btn-sm ep-delete"
+            type="button"
+            :title="t('detail.ep.deleteTitle')"
+            @click="episodeToDelete = ep"
+          >
+            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
+              <polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/>
+            </svg>
+          </button>
+          <button
+            type="button"
+            class="ep-enter"
+            @click="navigateTo(`/drama/${drama.id}/episode/${ep.episode_number || ep.episodeNumber}`)"
+          >
+            {{ t('detail.ep.enter') }}
+            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+              <polyline points="9 18 15 12 9 6"/>
+            </svg>
+          </button>
+        </div>
+      </div>
+
+      <!-- Empty episode state（点击也可直接添加第一集） -->
+      <div v-if="!drama.episodes?.length" class="card ep-empty" role="button" tabindex="0" :title="t('detail.ep.emptyCreateTitle')" @click="openAddEpisode" @keydown.enter="openAddEpisode">
+        <div class="ep-empty-icon">
+          <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round">
+            <circle cx="12" cy="12" r="10"/>
+            <line x1="12" y1="8" x2="12" y2="16"/>
+            <line x1="8" y1="12" x2="16" y2="12"/>
+          </svg>
+        </div>
+        <p>{{ t('detail.ep.emptyCreateText') }}</p>
+      </div>
+
+      <!-- 已有剧集时，列表末尾常驻「添加下一集」卡片 -->
+      <div v-else class="card ep-empty ep-add" role="button" tabindex="0" :title="t('detail.ep.addNextTitle', { n: (drama.episodes?.length || 0) + 1 })" @click="openAddEpisode" @keydown.enter="openAddEpisode">
+        <div class="ep-empty-icon">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round">
+            <circle cx="12" cy="12" r="10"/>
+            <line x1="12" y1="8" x2="12" y2="16"/>
+            <line x1="8" y1="12" x2="16" y2="12"/>
+          </svg>
+        </div>
+        <p>{{ t('detail.ep.addNextText', { n: (drama.episodes?.length || 0) + 1 }) }}</p>
+      </div>
+    </div>
+
+    <!-- 素材库 -->
+    <div v-else-if="activeTab === 'assets'" class="assets-wrap">
+      <div class="seg asset-filter">
+        <button
+          v-for="t in assetTabs"
+          :key="t.value"
+          type="button"
+          class="seg-item"
+          :class="{ on: assetTab === t.value }"
+          @click="assetTab = t.value"
+        >{{ t.label }}</button>
+      </div>
+
+      <!-- 全部素材为空 -->
+      <div v-if="!materials.length" class="empty-state">
+        <div class="empty-icon">
+          <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round">
+            <rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><polyline points="21 15 16 10 5 21"/>
+          </svg>
+        </div>
+        <p class="empty-title">{{ t('detail.assets.emptyTitle') }}</p>
+        <p class="empty-desc">{{ t('detail.assets.emptyDesc') }}</p>
+      </div>
+
+      <div v-else-if="materials.length" class="asset-groups">
+        <template v-for="g in assetGroups" :key="g.kindKey">
+          <template v-if="g.items.length">
+            <div v-if="assetTab === 'all'" class="asset-group-head" :class="tagClass(g.kindKey)">
+              <span class="group-icon">
+                <svg v-if="g.kindKey === 'character'" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/><circle cx="12" cy="7" r="4"/></svg>
+                <svg v-else-if="g.kindKey === 'scene'" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M21 10c0 7-9 12-9 12s-9-5-9-12a9 9 0 0 1 18 0Z"/><circle cx="12" cy="10" r="3"/></svg>
+                <svg v-else width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16Z"/><path d="M3.27 6.96 12 12l8.73-5.04M12 22.08V12"/></svg>
+              </span>
+              <span class="group-label">{{ g.label }}</span>
+              <span class="group-count">{{ g.items.length }}</span>
+            </div>
+
+            <!-- 角色：横向布局卡片（头像 + 样貌/妆造 + 三视图提示词） -->
+            <div v-if="g.kindKey === 'character'" class="character-asset-grid">
+              <article
+                v-for="m in g.items"
+                :key="'character-' + m.id"
+                class="card character-asset-card"
+                tabindex="0"
+                role="button"
+                @click="openEdit(m)"
+                @keydown.enter.self.prevent="openEdit(m)"
+                @keydown.space.self.prevent="openEdit(m)"
+              >
+                <div class="character-asset-main">
+                  <div class="character-asset-overview">
+                    <div class="character-portrait">
+                      <img v-if="matHasImage(m)" :src="thumbOf(assetSrc(m))" class="previewable-image" loading="lazy" @error="thumbFallback($event, assetSrc(m))" @click.stop="openAssetViewer(m)" />
+                      <div v-else class="character-portrait-empty">
+                        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/><circle cx="12" cy="7" r="4"/></svg>
+                      </div>
+                      <span class="asset-cover-badge" :class="matHasImage(m) ? 'is-ready' : (isPending(m) ? 'is-pending' : '')">
+                        {{ matHasImage(m) ? t('episode.asset.portraitReady') : (isPending(m) ? t('episode.asset.portraitPending') : t('episode.asset.portraitTodo')) }}
+                      </span>
+                    </div>
+                    <div class="character-asset-head">
+                      <div class="character-title-block">
+                        <div class="character-name-row">
+                          <strong class="character-name">{{ m.name }}</strong>
+                          <span class="tag">{{ m.role || t('common.role') }}</span>
+                        </div>
+                        <div class="character-visual-summary" :title="matDesc(m)">
+                          <span>{{ t('episode.asset.appearance') }}{{ m.appearance || t('detail.assets.todoShort') }}</span>
+                          <span>{{ t('episode.asset.styling') }}{{ m.styling || t('detail.assets.todoShort') }}</span>
+                        </div>
+                      </div>
+                      <button class="btn btn-sm character-gen-btn" type="button" :disabled="isPending(m)" @click.stop="generateMaterial(m)">
+                        <span v-if="isPending(m)" class="ring-spinner sm"></span>
+                        {{ matHasImage(m) ? t('episode.asset.regen') : (isPending(m) ? t('episode.asset.generating') : t('episode.asset.generate')) }}
+                      </button>
+                      <button class="btn btn-sm" type="button" :title="t('episode.asset.uploadCharImage')" :disabled="isUploading(m)" @click.stop="uploadMaterial(m)">
+                        <span v-if="isUploading(m)" class="ring-spinner sm"></span>
+                        <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
+                        {{ t('episode.asset.upload') }}
+                      </button>
+                    </div>
+                  </div>
+                  <div class="asset-final-prompt" :title="m.finalPrompt || ''">
+                    <span class="afp-label">{{ t('episode.asset.finalPromptTurnaround') }}</span>
+                    <span :class="['afp-text', !m.finalPrompt && 'dim']">{{ m.finalPrompt || t('episode.asset.finalPromptAutoTurnaround') }}</span>
+                  </div>
+                  <CharacterVoice :character="m" @updated="updateCharacterVoice" />
+                </div>
+              </article>
+            </div>
+
+            <!-- 场景 / 道具：竖向布局卡片（封面 + 描述/光影/类型 + 最终提示词 + 底部状态） -->
+            <div v-else class="asset-grid">
+              <div
+                v-for="m in g.items"
+                :key="g.kindKey + '-' + m.id"
+                :class="['card', 'asset-card', 'asset-click-card', g.kindKey === 'prop' ? 'prop-card' : '']"
+                tabindex="0"
+                role="button"
+                @click="openEdit(m)"
+                @keydown.enter.prevent="openEdit(m)"
+                @keydown.space.prevent="openEdit(m)"
+              >
+                <div class="asset-cover wide">
+                  <img v-if="matHasImage(m)" :src="thumbOf(assetSrc(m))" class="previewable-image" loading="lazy" @error="thumbFallback($event, assetSrc(m))" @click.stop="openAssetViewer(m)" />
+                  <div v-else class="asset-cover-empty">
+                    <svg v-if="g.kindKey === 'scene'" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z"/><circle cx="12" cy="10" r="3"/></svg>
+                    <svg v-else width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/></svg>
+                  </div>
+                  <span class="asset-cover-badge" :class="matHasImage(m) ? 'is-ready' : (isPending(m) ? 'is-pending' : '')">
+                    {{ matHasImage(m) ? t('episode.asset.ready') : (isPending(m) ? t('episode.asset.generating') : t('episode.asset.todo')) }}
+                  </span>
+                </div>
+                <div class="asset-body">
+                  <template v-if="g.kindKey === 'scene'">
+                    <div class="asset-name" :title="m.location">{{ m.location }}</div>
+                    <div class="asset-meta asset-desc dim" :title="matDesc(m)">{{ matDesc(m) || t('episode.asset.sceneDescTodo') }}</div>
+                    <div v-if="m.lighting" class="asset-meta asset-light dim" :title="m.lighting">{{ t('episode.asset.lighting') }}{{ m.lighting }}</div>
+                  </template>
+                  <template v-else>
+                    <div class="prop-name-row">
+                      <span class="asset-name" :title="m.name">{{ m.name }}</span>
+                      <span class="tag">{{ m.type || t('common.prop') }}</span>
+                    </div>
+                    <div class="asset-meta asset-desc dim" :title="m.description || ''">{{ m.description || t('episode.asset.noDescription') }}</div>
+                  </template>
+                  <div class="asset-meta asset-final" :class="{ dim: !m.finalPrompt }" :title="m.finalPrompt || ''">
+                    <span class="afp-label">{{ g.kindKey === 'scene' ? t('episode.asset.finalPromptFixed') : t('episode.asset.finalPromptWhiteBg') }}</span>
+                    {{ m.finalPrompt || (g.kindKey === 'scene' ? t('episode.asset.finalPromptAutoFixed') : t('episode.asset.finalPromptAutoWhiteBg')) }}
+                  </div>
+                </div>
+                <div class="asset-foot">
+                  <span :class="['dot', matHasImage(m) && 'ok', isPending(m) && 'pending']" />
+                  <button class="btn btn-sm ml-auto" type="button" :title="t('episode.asset.uploadImage')" :disabled="isUploading(m)" @click.stop="uploadMaterial(m)">
+                    <span v-if="isUploading(m)" class="ring-spinner sm"></span>
+                    <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
+                    {{ t('episode.asset.upload') }}
+                  </button>
+                  <button class="btn btn-sm" type="button" :disabled="isPending(m)" @click.stop="generateMaterial(m)">
+                    <span v-if="isPending(m)" class="ring-spinner sm"></span>
+                    {{ matHasImage(m) ? t('episode.asset.regen') : (isPending(m) ? t('episode.asset.generating') : t('episode.asset.generate')) }}
+                  </button>
+                </div>
+              </div>
+            </div>
+          </template>
+        </template>
+
+        <!-- 筛选某一类但该类暂无素材 -->
+        <div v-if="assetTab !== 'all' && !visibleAssets.length" class="empty-state">
+          <div class="empty-icon">
+            <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round">
+              <rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><polyline points="21 15 16 10 5 21"/>
+            </svg>
+          </div>
+          <p class="empty-title">{{ t('detail.assets.emptyKindTitle', { kind: tabLabel(assetTab) }) }}</p>
+          <p class="empty-desc">{{ t('detail.assets.emptyKindDesc', { kind: tabLabel(assetTab) }) }}</p>
+        </div>
+      </div>
+
+      <!-- 素材详情 / 编辑对话框（与工作台资产卡片同款布局） -->
+      <div v-if="editDialog && editTarget" class="overlay mat-detail-overlay" @click.self="closeEdit">
+        <section class="dialog mat-detail-dialog" :aria-label="t('detail.mat.dialogAria')">
+          <header class="dialog-head mat-detail-head">
+            <div class="mat-detail-title-block">
+              <span class="mat-detail-kicker">{{ editTarget.kindKey === 'character' ? t('episode.asset.typeChar') : editTarget.kindKey === 'scene' ? t('episode.asset.typeScene') : t('episode.asset.typeProp') }}</span>
+              <h2 class="mat-detail-title">{{ editTarget.name || t('detail.mat.unnamed') }}</h2>
+            </div>
+            <div class="mat-detail-head-actions">
+              <span v-if="editTarget.kindKey === 'character'" class="tag">{{ editTarget.role || t('common.role') }}</span>
+              <span v-else-if="editTarget.kindKey === 'prop'" class="tag">{{ editTarget.type || t('common.prop') }}</span>
+              <span v-else class="tag">{{ editTarget.time || t('episode.asset.noTime') }}</span>
+              <button class="btn btn-ghost btn-icon" @click="closeEdit">
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+              </button>
+            </div>
+          </header>
+
+          <div class="dialog-body mat-detail-body">
+            <div class="mat-detail-shell">
+              <!-- 左侧：视觉预览 -->
+              <aside class="mat-detail-preview-panel">
+                <div class="mat-detail-section-title">
+                  <span>{{ t('episode.asset.visualPreview') }}</span>
+                  <span :class="['mat-detail-state', matHasImage(editTarget) ? 'is-ready' : '']">
+                    {{ matHasImage(editTarget) ? t('episode.asset.ready') : t('episode.asset.todo') }}
+                  </span>
+                </div>
+
+                <button
+                  type="button"
+                  class="mat-detail-media-frame"
+                  :disabled="!matHasImage(editTarget)"
+                  @click.stop="openAssetViewer(editTarget)"
+                >
+                  <img v-if="matHasImage(editTarget)" :src="thumbOf(assetSrc(editTarget))" @error="thumbFallback($event, assetSrc(editTarget))" />
+                  <span v-else class="mat-detail-media-empty">
+                    <svg v-if="editTarget.kindKey === 'character'" width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/><circle cx="12" cy="7" r="4"/></svg>
+                    <svg v-else-if="editTarget.kindKey === 'prop'" width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/></svg>
+                    <svg v-else width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z"/><circle cx="12" cy="10" r="3"/></svg>
+                  </span>
+                </button>
+
+                <div class="mat-detail-meta-row">
+                  <div class="mat-detail-meta-item">
+                    <span>{{ t('episode.asset.kindLabel') }}</span>
+                    <strong>{{ editTarget.kindKey === 'character' ? t('episode.asset.charPortrait') : editTarget.kindKey === 'prop' ? t('common.prop') : t('episode.asset.sceneImage') }}</strong>
+                  </div>
+                  <div class="mat-detail-meta-item">
+                    <span>{{ editTarget.kindKey === 'character' ? t('episode.asset.roleLabel') : editTarget.kindKey === 'prop' ? t('episode.asset.propTypeLabel') : t('episode.asset.timeLabel') }}</span>
+                    <strong>{{ editTarget.kindKey === 'character' ? (editTarget.role || t('common.role')) : editTarget.kindKey === 'prop' ? (editTarget.type || t('common.prop')) : (editTarget.time || t('episode.asset.noTime')) }}</strong>
+                  </div>
+                </div>
+                <CharacterVoice v-if="editTarget.kindKey === 'character'" :key="editTarget.id" :character="editTarget" @updated="updateCharacterVoice" />
+              </aside>
+
+              <!-- 右侧：编辑信息 -->
+              <section class="mat-detail-editor-panel">
+                <div class="mat-detail-section-title">
+                  <span>{{ t('episode.asset.editInfo') }}</span>
+                  <span class="dim">{{ editTarget.kindKey === 'character' ? t('episode.asset.editHintChar') : editTarget.kindKey === 'prop' ? t('episode.asset.editHintProp') : t('episode.asset.editHintScene') }}</span>
+                </div>
+
+                <!-- 道具：单列物品外貌 -->
+                <div v-if="editTarget.kindKey === 'prop'" class="mat-detail-edit-grid mat-detail-edit-grid--prop">
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.create.name') }}</span>
+                    <input v-model="editDraft.name" class="input" :placeholder="t('episode.create.namePlaceholderProp')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.create.typeField') }}</span>
+                    <input v-model="editDraft.type" class="input" :placeholder="t('detail.mat.propTypePlaceholder')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.asset.appearanceOfObject') }}</span>
+                    <textarea v-model="editDraft.description" class="textarea mat-detail-textarea" rows="6" :placeholder="t('episode.asset.appearancePlaceholder')" />
+                  </label>
+                </div>
+
+                <!-- 角色：样貌 + 妆造 -->
+                <div v-else-if="editTarget.kindKey === 'character'" class="mat-detail-edit-grid mat-detail-edit-grid--character">
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.create.name') }}</span>
+                    <input v-model="editDraft.name" class="input" :placeholder="t('episode.create.namePlaceholderChar')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.create.roleField') }}</span>
+                    <input v-model="editDraft.role" class="input" :placeholder="t('episode.create.rolePlaceholder')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.asset.appearanceField') }}</span>
+                    <textarea v-model="editDraft.appearance" class="textarea mat-detail-textarea" rows="5" :placeholder="t('episode.asset.appearanceFieldPlaceholder')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.asset.stylingField') }}</span>
+                    <textarea v-model="editDraft.styling" class="textarea mat-detail-textarea" rows="5" :placeholder="t('episode.asset.stylingFieldPlaceholder')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('detail.mat.personaField') }}</span>
+                    <textarea v-model="editDraft.description" class="textarea mat-detail-textarea" rows="4" :placeholder="t('detail.mat.personaPlaceholder')" />
+                  </label>
+                </div>
+
+                <!-- 场景：描述 + 光影 -->
+                <div v-else class="mat-detail-edit-grid mat-detail-edit-grid--scene">
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.create.location') }}</span>
+                    <input v-model="editDraft.location" class="input" :placeholder="t('detail.mat.locationPlaceholder')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.create.time') }}</span>
+                    <input v-model="editDraft.time" class="input" :placeholder="t('detail.mat.timePlaceholder')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.asset.sceneDescField') }}</span>
+                    <textarea v-model="editDraft.prompt" class="textarea mat-detail-textarea" rows="5" :placeholder="t('episode.asset.sceneDescPlaceholder')" />
+                  </label>
+                  <label class="mat-detail-edit-field">
+                    <span>{{ t('episode.asset.sceneLightField') }}</span>
+                    <textarea v-model="editDraft.lighting" class="textarea mat-detail-textarea" rows="5" :placeholder="t('episode.asset.sceneLightPlaceholder')" />
+                  </label>
+                </div>
+              </section>
+            </div>
+
+            <!-- 最终提示词：可生成 / 重新生成 / 手动编辑 -->
+            <section class="mat-detail-prompt-panel">
+              <div class="mat-detail-section-title">
+                <span>{{ t('detail.mat.finalPromptLabel') }}</span>
+                <span class="dim">{{ t('detail.mat.finalPromptSub') }}</span>
+                <button
+                  class="btn btn-sm mat-detail-prompt-gen"
+                  :disabled="finalPromptGen || !firstEpisodeId"
+                  :title="firstEpisodeId ? t('detail.mat.genPromptTitle') : t('detail.mat.needEpisodeFirst')"
+                  @click="generateFinalPrompt(editTarget)"
+                >
+                  <svg v-if="!finalPromptGen" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3v3m0 12v3m9-9h-3M6 12H3m13.5-6.5L14 8m-4 8-2.5 2.5m11 0L16 16M8 8 5.5 5.5"/><circle cx="12" cy="12" r="3"/></svg>
+                  {{ finalPromptGen ? t('episode.asset.generating') + '…' : (editDraft.finalPrompt ? t('episode.sb.regenPrompt') : t('episode.asset.genPrompt')) }}
+                </button>
+              </div>
+              <textarea
+                v-model="editDraft.finalPrompt"
+                class="textarea mat-detail-prompt-text"
+                rows="5"
+                :placeholder="t('detail.mat.promptPlaceholder')"
+              ></textarea>
+            </section>
+          </div>
+
+          <footer class="dialog-foot mat-detail-foot">
+            <div class="mat-detail-secondary-actions">
+              <button class="btn" @click="closeEdit">{{ t('common.close') }}</button>
+            </div>
+            <div class="mat-detail-primary-actions">
+              <button
+                class="btn"
+                :disabled="isUploading(editTarget)"
+                @click="uploadMaterial(editTarget)"
+              >
+                <span v-if="isUploading(editTarget)" class="ring-spinner sm"></span>
+                <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
+                {{ t('episode.asset.uploadImage') }}
+              </button>
+              <button
+                class="btn"
+                :disabled="isPending(editTarget)"
+                @click="generateMaterial(editTarget)"
+              >
+                {{ matHasImage(editTarget) ? t('episode.sb.regenPrompt') : (isPending(editTarget) ? t('episode.asset.generating') + '…' : t('detail.mat.genImage')) }}
+              </button>
+              <button class="btn btn-primary" :disabled="editSaving" @click="saveEdit">
+                {{ editSaving ? t('detail.mat.saving') : t('episode.asset.saveChanges') }}
+              </button>
+            </div>
+          </footer>
+        </section>
+      </div>
+
+      <!-- 图片查看器 -->
+      <div v-if="assetViewer.open" class="overlay viewer-overlay" @click.self="closeAssetViewer">
+        <div class="dialog viewer-dialog">
+          <div class="viewer-head">
+            <span class="viewer-title">{{ assetViewer.title }}</span>
+            <button class="btn btn-icon btn-sm btn-ghost" @click="closeAssetViewer">
+              <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+            </button>
+          </div>
+          <img :src="assetViewer.src" :alt="assetViewer.title" class="viewer-img" />
+        </div>
+      </div>
+    </div>
+
+    <div v-if="addDialog" class="overlay" @click.self="addDialog = false">
+      <div class="dialog ep-dialog">
+        <div class="dialog-head">
+          <div class="dialog-title">{{ t('detail.epCreate.title') }}</div>
+          <button class="btn btn-icon btn-sm btn-ghost ml-auto dialog-close" @click="addDialog = false">
+            <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+          </button>
+        </div>
+        <div class="dialog-body">
+          <label class="field">
+            <span class="field-label">{{ t('detail.epCreate.titleField') }}</span>
+            <input v-model="newEpisodeTitle" class="input" :placeholder="t('detail.epCreate.titlePlaceholder')" />
+            <span class="field-hint">{{ t('detail.epCreate.titleHint', { example: t('detail.epCreate.example', { n: 3 }) }) }}</span>
+          </label>
+          <label class="field">
+            <span class="field-label">{{ t('detail.epCreate.resolution') }}</span>
+            <BaseSelect v-model="newEpisodeResolution" :options="resolutionOptions" :placeholder="t('detail.epCreate.resolutionPlaceholder')" />
+            <span class="field-hint">{{ t('detail.epCreate.resolutionHint') }}</span>
+          </label>
+        </div>
+        <div class="dialog-foot">
+          <span class="dialog-foot-copy">{{ t('detail.epCreate.lockCopy') }}</span>
+          <button class="btn" @click="addDialog = false">{{ t('common.cancel') }}</button>
+          <button class="btn btn-primary" :disabled="creatingEpisode" @click="addEpisode">
+            {{ creatingEpisode ? t('detail.epCreate.creating') : t('detail.epCreate.create') }}
+          </button>
+        </div>
+      </div>
+    </div>
+    <ConfirmDialog
+      :open="!!episodeToDelete"
+      :title="t('detail.ep.deleteTitle')"
+      :message="t('detail.epDelete.message', { title: episodeToDelete?.title || t('detail.ep.episodeN', { n: episodeToDelete?.episode_number || episodeToDelete?.episodeNumber }) })"
+      :loading="deletingEpisode"
+      @confirm="confirmDelEpisode"
+      @cancel="episodeToDelete = null"
+    />
+  </div>
+</template>
+
+<script setup>
+import { toast } from 'vue-sonner'
+import { toastError } from '~/composables/useToast'
+import { useI18n } from 'vue-i18n'
+import { dramaAPI, episodeAPI, characterAPI, sceneAPI, propAPI, uploadAPI } from '~/composables/useApi'
+import BaseSelect from '~/components/BaseSelect.vue'
+
+const { t, locale } = useI18n()
+
+const route = useRoute()
+const drama = ref(null)
+const dramaId = Number(route.params.id)
+const addDialog = ref(false)
+const creatingEpisode = ref(false)
+const newEpisodeTitle = ref('')
+const episodeToDelete = ref(null)
+const deletingEpisode = ref(false)
+
+// 视频分辨率：创建集时固定（持久化到 episodes.resolution），集卡片上可修改
+const resolutionOptions = computed(() => ([
+  { label: t('detail.ep.res720'), value: '720p' },
+  { label: t('detail.ep.res480'), value: '480p' },
+]))
+const newEpisodeResolution = ref('720p')
+const epResMenuId = ref(null)
+
+function epResolution(ep) { return ep.resolution === '480p' ? '480p' : '720p' }
+
+async function setEpisodeResolution(ep, resolution) {
+  epResMenuId.value = null
+  if (epResolution(ep) === resolution) return
+  const prev = ep.resolution
+  ep.resolution = resolution
+  try {
+    await episodeAPI.update(ep.id, { resolution })
+    toast.success(t('detail.ep.resSwitched', { res: resolution }))
+  } catch (e) {
+    ep.resolution = prev
+    toastError(e)
+  }
+}
+
+// 集状态由用户手动标记（持久化到 episodes.status），不再按剧本内容自动推算
+const epStatusOptions = computed(() => ([
+  { label: t('index.status.draft'), value: 'draft' },
+  { label: t('index.status.active'), value: 'active' },
+  { label: t('index.status.completed'), value: 'completed' },
+]))
+const epStatusMenuId = ref(null)
+
+function epStatus(ep) { return ep.status || 'draft' }
+function epStatusLabel(ep) { return epStatusOptions.value.find(s => s.value === epStatus(ep))?.label || t('index.status.draft') }
+function epStatusDotClass(ep) { return epStatus(ep) === 'active' ? 'dot-active' : epStatus(ep) === 'completed' ? 'dot-done' : 'dot-pending' }
+
+function formatEpTime(ts) {
+  if (!ts) return ''
+  const d = new Date(ts)
+  const now = new Date()
+  const diff = now - d
+  if (diff < 60_000) return t('index.time.justNow')
+  if (diff < 3600_000) return t('index.time.minutesAgo', { n: Math.floor(diff / 60000) })
+  if (diff < 86400_000) return t('index.time.hoursAgo', { n: Math.floor(diff / 3600000) })
+  return `${d.getMonth() + 1}/${d.getDate()}`
+}
+
+async function setEpisodeStatus(ep, status) {
+  epStatusMenuId.value = null
+  if (epStatus(ep) === status) return
+  const prev = ep.status
+  ep.status = status
+  try {
+    await episodeAPI.update(ep.id, { status })
+  } catch (e) {
+    ep.status = prev
+    toastError(e)
+  }
+}
+
+async function load() {
+  try {
+    drama.value = await dramaAPI.get(dramaId)
+  } catch (e) {
+    toastError(e)
+  }
+}
+
+function openAddEpisode() {
+  newEpisodeTitle.value = ''
+  newEpisodeResolution.value = '720p'
+  addDialog.value = true
+}
+
+async function addEpisode() {
+  try {
+    creatingEpisode.value = true
+    // 图片/视频生成配置由后端自动锁定为当前启用的最高优先级配置；分辨率随集固定
+    await episodeAPI.create({
+      drama_id: dramaId,
+      title: newEpisodeTitle.value || undefined,
+      resolution: newEpisodeResolution.value,
+    })
+    toast.success(t('detail.epCreate.added'))
+    addDialog.value = false
+    load()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    creatingEpisode.value = false
+  }
+}
+
+async function confirmDelEpisode() {
+  const ep = episodeToDelete.value
+  if (!ep) return
+  try {
+    deletingEpisode.value = true
+    await episodeAPI.del(ep.id)
+    toast.success(t('index.deleted'))
+    episodeToDelete.value = null
+    load()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    deletingEpisode.value = false
+  }
+}
+
+/* ===== 素材库 Tab ===== */
+const activeTab = ref('episodes')
+const assetTab = ref('all')
+const assetViewer = ref({ open: false, src: '', title: '' })
+const pendingMaterials = ref(new Set())
+const assetTabs = computed(() => ([
+  { label: t('index.status.all'), value: 'all' },
+  { label: t('common.role'), value: 'character' },
+  { label: t('common.scene'), value: 'scene' },
+  { label: t('common.prop'), value: 'prop' },
+]))
+const KIND_ORDER = { character: 0, scene: 1, prop: 2 }
+
+// 素材库以 characters / scenes / props 三张资产表为源（后端生图会写回其 imageUrl）
+function matImage(m) { return m.image_url || m.imageUrl || m.localPath || m.local_path || '' }
+function matHasImage(m) { return !!matImage(m) }
+function assetSrc(m) {
+  const raw = matImage(m)
+  if (!raw) return ''
+  return /^https?:\/\//i.test(raw) || raw.startsWith('/') ? raw : `/${raw}`
+}
+function matCreatedAt(m) { return m.created_at || m.updated_at || m.createdAt || m.updatedAt }
+function matDesc(m) {
+  if (m.kindKey === 'character') return m.appearance || m.description || ''
+  if (m.kindKey === 'scene') return m.prompt || m.description || ''
+  return m.description || ''
+}
+function tagClass(kindKey) {
+  return kindKey === 'character' ? 'is-character' : kindKey === 'scene' ? 'is-scene' : 'is-prop'
+}
+function tabLabel(v) { return assetTabs.value.find(x => x.value === v)?.label || '' }
+
+// kind 为显示名（渲染时求值），kindKey 为逻辑值
+const materials = computed(() => {
+  const d = drama.value
+  if (!d) return []
+  const list = []
+  for (const c of d.characters || []) list.push({ ...c, kind: t('common.role'), kindKey: 'character' })
+  for (const s of d.scenes || []) list.push({ ...s, kind: t('common.scene'), kindKey: 'scene' })
+  for (const p of d.props || []) list.push({ ...p, kind: t('common.prop'), kindKey: 'prop' })
+  return list.sort((a, b) => (KIND_ORDER[a.kindKey] - KIND_ORDER[b.kindKey]) || (a.id - b.id))
+})
+const visibleAssets = computed(() =>
+  assetTab.value === 'all' ? materials.value : materials.value.filter(m => m.kindKey === assetTab.value),
+)
+const assetTotal = computed(() => materials.value.length)
+// 按类型分组：全部模式下分成 角色 / 场景 / 道具 三个分区；筛选单类时只保留该类
+const assetGroups = computed(() => {
+  const groups = [
+    { kindKey: 'character', label: t('common.role'), items: materials.value.filter(m => m.kindKey === 'character') },
+    { kindKey: 'scene', label: t('common.scene'), items: materials.value.filter(m => m.kindKey === 'scene') },
+    { kindKey: 'prop', label: t('common.prop'), items: materials.value.filter(m => m.kindKey === 'prop') },
+  ]
+  return assetTab.value === 'all'
+    ? groups
+    : groups.filter(g => g.kindKey === assetTab.value)
+})
+
+function pendingKey(m) { return `${m.kindKey}:${m.id}` }
+function isPending(m) { return pendingMaterials.value.has(pendingKey(m)) }
+
+function sleep(ms) { return new Promise(r => setTimeout(r, ms)) }
+
+async function generateMaterial(m) {
+  const epId = drama.value?.episodes?.[0]?.id
+  if (!epId) { toast.error(t('detail.mat.needEpisodeForImage')); return }
+  const key = pendingKey(m)
+  if (pendingMaterials.value.has(key)) return
+  pendingMaterials.value = new Set(pendingMaterials.value).add(key)
+  try {
+    if (m.kindKey === 'character') await characterAPI.generateImage(m.id, epId)
+    else if (m.kindKey === 'scene') await sceneAPI.generateImage(m.id, epId)
+    else await propAPI.generateImage(m.id, epId)
+    toast.success(t('detail.mat.generating', { kind: m.kind, name: m.name }))
+    pollMaterial(m)
+  } catch (e) {
+    pendingMaterials.value = new Set([...pendingMaterials.value].filter(k => k !== key))
+    toastError(e)
+  }
+}
+
+// 生图为异步任务：轮询重新加载 drama，直到该素材 imageUrl 出现
+async function pollMaterial(m) {
+  const key = pendingKey(m)
+  for (let i = 0; i < 40; i++) {
+    await sleep(2500)
+    await load()
+    const d = drama.value
+    const list = m.kindKey === 'character' ? d?.characters : m.kindKey === 'scene' ? d?.scenes : d?.props
+    const rec = list?.find(x => x.id === m.id)
+    if (rec && matImage(rec)) {
+      pendingMaterials.value = new Set([...pendingMaterials.value].filter(k => k !== key))
+      return
+    }
+  }
+  pendingMaterials.value = new Set([...pendingMaterials.value].filter(k => k !== key))
+  toast.info(t('detail.mat.genTimeout', { kind: m.kind, name: m.name }))
+}
+
+function switchToAssets() {
+  activeTab.value = 'assets'
+}
+
+/* ===== 素材图片手动上传（角色形象 / 场景图 / 道具图） ===== */
+const uploadingMaterials = ref(new Set())
+function isUploading(m) { return uploadingMaterials.value.has(pendingKey(m)) }
+
+function uploadMaterial(m) {
+  const key = pendingKey(m)
+  if (uploadingMaterials.value.has(key)) return
+  const input = document.createElement('input')
+  input.type = 'file'
+  input.accept = 'image/jpeg,image/png,image/webp,.jpg,.jpeg,.png,.webp'
+  input.onchange = async () => {
+    const file = input.files?.[0]
+    if (!file) return
+    uploadingMaterials.value = new Set(uploadingMaterials.value).add(key)
+    try {
+      const res = await uploadAPI.image(file)
+      // 与生图回写保持一致：存相对路径（static/...），展示时补前导斜杠
+      const payload = { image_url: res.path, local_path: res.path }
+      if (m.kindKey === 'character') await characterAPI.update(m.id, payload)
+      else if (m.kindKey === 'scene') await sceneAPI.update(m.id, payload)
+      else await propAPI.update(m.id, payload)
+      toast.success(t('detail.mat.uploaded', { kind: m.kind, name: m.name }))
+      await load()
+      // 详情弹窗打开时同步刷新预览
+      if (editTarget.value && editTarget.value.kindKey === m.kindKey && editTarget.value.id === m.id) {
+        editTarget.value = { ...editTarget.value, image_url: res.path, local_path: res.path }
+      }
+    } catch (e) {
+      toastError(e)
+    } finally {
+      uploadingMaterials.value = new Set([...uploadingMaterials.value].filter(k => k !== key))
+    }
+  }
+  input.click()
+}
+
+function openAssetViewer(m) {
+  assetViewer.value = { open: true, src: assetSrc(m), title: `${m.kind} · ${m.name}` }
+}
+function closeAssetViewer() {
+  assetViewer.value = { open: false, src: '', title: '' }
+}
+
+function fmtDate(s) {
+  if (!s) return ''
+  const d = new Date(s)
+  if (isNaN(d.getTime())) return ''
+  return d.toLocaleDateString(locale.value === 'zh' ? 'zh-CN' : locale.value, { month: 'short', day: 'numeric' })
+}
+
+/* ===== 素材信息编辑 ===== */
+const editDialog = ref(false)
+const editSaving = ref(false)
+const editTarget = ref(null)
+function updateCharacterVoice(id, voice) {
+  const patch = { ...voice, voiceAudioUrl: voice.voice_audio_url, voiceAudioName: voice.voice_audio_name }
+  const character = drama.value?.characters?.find(item => item.id === id)
+  if (character) Object.assign(character, patch)
+  if (editTarget.value?.kindKey === 'character' && editTarget.value.id === id) Object.assign(editTarget.value, patch)
+}
+const editDraft = reactive({})
+
+function openEdit(m) {
+  editTarget.value = m
+  // 按类型初始化 draft
+  Object.keys(editDraft).forEach(k => delete editDraft[k])
+  if (m.kindKey === 'character') {
+    Object.assign(editDraft, { name: m.name || '', role: m.role || '', appearance: m.appearance || '', description: m.description || '', styling: m.styling || '' })
+  } else if (m.kindKey === 'scene') {
+    Object.assign(editDraft, { location: m.location || '', time: m.time || '', prompt: m.prompt || '', lighting: m.lighting || '' })
+  } else {
+    Object.assign(editDraft, { name: m.name || '', type: m.type || '', description: m.description || '' })
+  }
+  editDraft.finalPrompt = m.finalPrompt || m.final_prompt || ''
+  editDialog.value = true
+}
+
+// 生成/重新生成最终提示词（不生图）：调用各类型 generate-prompt 接口，结果写回 draft
+const finalPromptGen = ref(false)
+const firstEpisodeId = computed(() => drama.value?.episodes?.[0]?.id || null)
+async function generateFinalPrompt(m) {
+  const epId = firstEpisodeId.value
+  if (!epId) { toast.error(t('detail.mat.needEpisodeForPrompt')); return }
+  finalPromptGen.value = true
+  try {
+    let res
+    if (m.kindKey === 'character') res = await characterAPI.generatePrompt(m.id, epId, true)
+    else if (m.kindKey === 'scene') res = await sceneAPI.generatePrompt(m.id, epId, true)
+    else res = await propAPI.generatePrompt(m.id, epId, true)
+    const fp = res?.final_prompt || res?.finalPrompt
+    if (!fp) throw new Error(t('episode.asset.promptGenFailedRetry'))
+    editTarget.value = { ...m, finalPrompt: fp }
+    editDraft.finalPrompt = fp
+    toast.success(t('episode.asset.promptGenerated'))
+  } catch (e) {
+    toastError(e)
+  } finally {
+    finalPromptGen.value = false
+  }
+}
+
+function closeEdit() {
+  editDialog.value = false
+  editTarget.value = null
+}
+
+async function saveEdit() {
+  const target = editTarget.value
+  if (!target) return
+  // 必填校验
+  if (target.kindKey === 'character' && !String(editDraft.name ?? '').trim()) { toast.error(t('episode.create.nameRequired')); return }
+  if (target.kindKey === 'scene' && !String(editDraft.location ?? '').trim()) { toast.error(t('detail.mat.locationRequired')); return }
+  if (target.kindKey === 'prop' && !String(editDraft.name ?? '').trim()) { toast.error(t('episode.create.nameRequired')); return }
+  editSaving.value = true
+  try {
+    const fp = editDraft.finalPrompt || null
+    if (target.kindKey === 'character') await characterAPI.update(target.id, { name: editDraft.name, role: editDraft.role, appearance: editDraft.appearance, description: editDraft.description, styling: editDraft.styling, finalPrompt: fp })
+    else if (target.kindKey === 'scene') await sceneAPI.update(target.id, { location: editDraft.location, time: editDraft.time, prompt: editDraft.prompt, lighting: editDraft.lighting, finalPrompt: fp })
+    else await propAPI.update(target.id, { name: editDraft.name, type: editDraft.type, description: editDraft.description, finalPrompt: fp })
+    toast.success(t('common.saved'))
+    closeEdit()
+    load()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    editSaving.value = false
+  }
+}
+
+onMounted(load)
+</script>
+
+<style scoped>
+.page {
+  padding: 20px 28px 40px;
+  overflow-y: auto;
+  height: 100%;
+  animation: fadeUp 0.35s var(--ease-out) both;
+}
+
+/* Header card：单行紧凑 */
+.page-head {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 10px 16px;
+  border-radius: var(--radius-lg);
+  margin-bottom: 14px;
+}
+.head-info { flex: 1; min-width: 0; display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+.head-action { flex-shrink: 0; }
+
+.back-btn {
+  width: 30px; height: 30px; flex-shrink: 0;
+  display: flex; align-items: center; justify-content: center;
+  border: none; border-radius: 50%;
+  background: var(--overlay-track); color: var(--text-1);
+  cursor: pointer;
+  transition: background 0.16s var(--ease-out), color 0.16s var(--ease-out), box-shadow 0.16s var(--ease-out);
+}
+.back-btn:hover { background: var(--bg-active); color: var(--text-0); }
+.back-btn:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+
+.page-title {
+  font-size: 17px; font-weight: 700;
+  letter-spacing: -0.02em;
+  line-height: 1.2;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.page-meta { display: flex; align-items: center; gap: 14px; flex-wrap: wrap; }
+.meta-item {
+  display: flex; align-items: center; gap: 5px;
+  font-size: 12px; color: var(--text-2);
+}
+
+/* 主 Tab 导航 */
+.page-tabs {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  border-bottom: 1px solid var(--border);
+  margin-bottom: 14px;
+}
+.tab-btn {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  gap: 7px;
+  border: none;
+  background: transparent;
+  padding: 8px 4px 10px;
+  margin-right: 20px;
+  font-size: 13.5px;
+  font-weight: 600;
+  color: var(--text-2);
+  cursor: pointer;
+  transition: color 0.16s var(--ease-out);
+}
+.tab-btn svg { opacity: 0.75; }
+.tab-btn::after {
+  content: '';
+  position: absolute;
+  left: 0; right: 0; bottom: -1px;
+  height: 2px;
+  border-radius: 2px;
+  background: transparent;
+  transition: background 0.16s var(--ease-out);
+}
+.tab-btn:hover { color: var(--text-0); }
+.tab-btn.on { color: var(--text-0); font-weight: 650; }
+.tab-btn.on::after { background: var(--accent); }
+.tab-count {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 18px;
+  height: 18px;
+  padding: 0 5px;
+  border-radius: 9px;
+  font-size: 11px;
+  font-weight: 700;
+  font-family: var(--font-mono);
+  background: var(--bg-2);
+  color: var(--text-2);
+}
+.tab-btn.on .tab-count { background: var(--accent-bg); color: var(--accent-text); }
+
+/* Episode Grid — 横向紧凑卡片，多列 */
+.ep-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(360px, 1fr));
+  gap: 10px;
+}
+
+/* 卡片主体 — 上信息区 + 下常驻操作条 */
+.ep-card {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 12px 14px 10px;
+  cursor: pointer;
+  animation: fadeUp 0.35s var(--ease-out) both;
+  transition: border-color 0.18s var(--ease-out), background 0.18s var(--ease-out);
+}
+.ep-card:hover {
+  border-color: var(--border-strong);
+}
+
+/* 上区：编号 + 标题元数据 + 状态 */
+.ep-card-top { display: flex; align-items: center; gap: 12px; min-width: 0; }
+
+/* 编号徽标：统一中性，状态由圆点表达 */
+.ep-number {
+  width: 40px; height: 40px; flex-shrink: 0;
+  border-radius: var(--radius);
+  border: 1px solid var(--border);
+  display: flex; flex-direction: column; align-items: center; justify-content: center;
+  font-family: var(--font-mono);
+  background: var(--bg-2); color: var(--text-1);
+}
+.ep-num-label {
+  font-size: 7.5px; letter-spacing: 0.18em; font-weight: 600;
+  opacity: 0.55; line-height: 1; margin-bottom: 1px;
+}
+.ep-number b {
+  font-size: 15px; font-weight: 600; line-height: 1;
+}
+
+/* 中部：标题 + 元数据（单行不换行，防止卡片被撑高错位） */
+.ep-main { flex: 1; min-width: 0; display: flex; flex-direction: column; justify-content: center; gap: 2px; }
+.ep-title {
+  font-size: 13.5px; font-weight: 600; color: var(--text-0);
+  line-height: 1.35; margin: 0;
+  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+}
+.ep-meta-row {
+  display: flex; align-items: center; gap: 8px;
+  flex-wrap: nowrap; overflow: hidden;
+  white-space: nowrap;
+}
+.ep-meta {
+  display: inline-flex; align-items: center; gap: 4px;
+  font-size: 11px; color: var(--text-3);
+  white-space: nowrap; flex-shrink: 0;
+}
+.ep-meta svg { opacity: 0.7; flex-shrink: 0; }
+.ep-meta-ok { color: var(--text-2); }
+.ep-time { flex-shrink: 1; overflow: hidden; text-overflow: ellipsis; }
+
+/* 状态胶囊：中性底 + 彩色圆点，颜色只出现在点上 */
+.ep-badges { display: flex; align-items: center; flex-shrink: 0; }
+
+/* 下区：常驻操作条 */
+.ep-card-foot {
+  display: flex; align-items: center; gap: 6px;
+  padding-top: 9px;
+  border-top: 1px solid var(--border);
+}
+.ep-foot-spacer { flex: 1; }
+
+/* 进入制作 — 卡片主操作 */
+.ep-enter {
+  display: inline-flex; align-items: center; gap: 4px;
+  padding: 4px 12px;
+  border: none; border-radius: var(--radius);
+  background: var(--accent-bg); color: var(--accent-text);
+  font-size: 12px; font-weight: 600;
+  cursor: pointer;
+  transition: background 0.15s, color 0.15s;
+  white-space: nowrap;
+}
+.ep-enter:hover {
+  background: var(--accent-gradient); color: var(--on-accent, #fff);
+  box-shadow: 0 2px 8px var(--accent-glow);
+}
+.ep-enter svg { transition: transform 0.18s var(--ease-out); }
+.ep-enter:hover svg { transform: translateX(2px); }
+.ep-status-btn {
+  cursor: pointer; border: none; font: inherit;
+  display: inline-flex; align-items: center; gap: 5px;
+  padding: 3px 10px; border-radius: 20px;
+  background: var(--bg-2); color: var(--text-2);
+  font-size: 11px; font-weight: 500;
+  transition: background 0.14s, color 0.14s;
+  white-space: nowrap;
+}
+.ep-status-btn:hover { color: var(--text-0); background: var(--bg-3); }
+
+/* 分辨率标签 */
+.ep-res-btn {
+  cursor: pointer; border: none; font: inherit;
+  display: inline-flex; align-items: center;
+  padding: 2px 8px; border-radius: 6px;
+  font-size: 11px; font-weight: 600;
+  background: var(--bg-2); color: var(--text-2);
+  transition: background 0.14s, color 0.14s;
+}
+.ep-res-btn:hover { background: var(--bg-hover); color: var(--text-1); }
+
+/* 状态圆点 */
+.status-dot {
+  width: 6px; height: 6px; border-radius: 50%; flex-shrink: 0;
+}
+.dot-active { background: var(--success); }
+.dot-done { background: var(--accent); }
+.dot-pending { background: var(--text-3); }
+
+/* 删除按钮 */
+.ep-delete {
+  color: var(--text-3);
+  transition: color 0.15s;
+}
+.ep-delete:hover { color: var(--action-danger); }
+
+/* Empty / 添加卡片：与剧集卡片等高的虚线条 */
+.ep-empty {
+  display: flex; flex-direction: row; align-items: center; justify-content: center; gap: 8px;
+  min-height: 104px;
+  padding: 8px; text-align: center; color: var(--text-3); font-size: 12.5px;
+  border-style: dashed;
+  cursor: pointer;
+  transition: border-color 0.2s, color 0.2s, background 0.2s;
+}
+.ep-empty:hover { border-color: var(--accent-text); color: var(--accent-text); background: var(--accent-bg); }
+.ep-empty-icon {
+  width: 28px; height: 28px; border-radius: 50%;
+  background: var(--bg-2); color: var(--text-3);
+  display: flex; align-items: center; justify-content: center; flex-shrink: 0;
+  transition: transform 0.2s, background 0.2s, color 0.2s;
+}
+.ep-empty:hover .ep-empty-icon { background: var(--accent-bg); color: var(--accent-text); }
+
+/* Create Episode Dialog (on top of global .dialog skeleton) */
+.ep-dialog { width: min(480px, 100%); }
+.dialog-close { flex-shrink: 0; color: var(--text-2); }
+.dialog-body { display: flex; flex-direction: column; gap: 20px; }
+
+.field { display: flex; flex-direction: column; gap: 8px; }
+.field-label { font-size: 12.5px; font-weight: 600; color: var(--text-1); }
+.field-hint { font-size: 12px; color: var(--text-3); }
+
+.dialog-foot-copy {
+  margin-right: auto;
+  font-size: 12px;
+  line-height: 1.6;
+  color: var(--text-3);
+}
+
+/* ===== 素材库 ===== */
+.asset-filter { margin-bottom: 16px; }
+
+.asset-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(190px, 1fr)); gap: 12px; align-items: stretch; }
+.character-asset-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(230px, 260px));
+  justify-content: start;
+  gap: 10px;
+}
+/* 分组标题：角色 / 场景 / 道具，彩色左条 + 图标 + 数量 */
+.asset-group-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 7px 14px;
+  margin: 4px 0 14px;
+  border-radius: var(--radius);
+  border-left: 3px solid var(--text-3);
+  background: var(--bg-1);
+  font-size: 13.5px;
+  font-weight: 700;
+  color: var(--text-1);
+}
+.asset-group-head .group-icon { display: inline-flex; color: var(--text-2); }
+.asset-group-head .group-label { letter-spacing: 0.02em; }
+.asset-group-head .group-count {
+  margin-left: auto;
+  font-size: 11.5px;
+  font-weight: 600;
+  color: var(--text-3);
+  background: var(--bg-2);
+  border-radius: 99px;
+  padding: 1px 9px;
+}
+.asset-group-head.is-character { border-left-color: var(--accent); background: var(--accent-bg); color: var(--accent-text); }
+.asset-group-head.is-character .group-icon { color: var(--accent-text); }
+.asset-group-head.is-scene { border-left-color: var(--success); background: var(--success-bg); color: var(--tag-success-text); }
+.asset-group-head.is-scene .group-icon { color: var(--tag-success-text); }
+.asset-group-head.is-prop { border-left-color: var(--warning); background: var(--warning-bg); color: var(--warn-text); }
+.asset-group-head.is-prop .group-icon { color: var(--warn-text); }
+.asset-card {
+  display: flex; flex-direction: column; overflow: hidden;
+  transition: transform 0.18s var(--ease-out), box-shadow 0.18s var(--ease-out), border-color 0.18s var(--ease-out);
+}
+.asset-card:hover { transform: translateY(-2px); box-shadow: var(--shadow-lift); }
+.asset-click-card,
+.character-asset-card {
+  cursor: pointer;
+}
+.asset-click-card:focus-visible,
+.character-asset-card:focus-visible {
+  outline: none;
+  border-color: var(--accent-glow);
+  box-shadow: 0 0 0 3px var(--button-focus), var(--shadow-panel);
+}
+.character-asset-card {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  min-height: 0;
+  transition: transform 0.18s var(--ease-out), box-shadow 0.18s var(--ease-out), border-color 0.18s var(--ease-out);
+}
+.character-asset-card:hover {
+  transform: translateY(-2px);
+  box-shadow: var(--shadow-lift);
+  border-color: var(--border-strong);
+}
+.character-portrait {
+  position: relative;
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  align-self: start;
+  margin: 0;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--bg-2);
+  overflow: hidden;
+}
+.character-portrait img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+.character-portrait-empty {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--text-3);
+}
+.character-asset-main {
+  min-width: 0;
+  width: 100%;
+  padding: 8px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.character-asset-overview {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.character-asset-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  min-width: 0;
+}
+.character-title-block {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.character-name-row {
+  display: flex;
+  align-items: center;
+  gap: 5px;
+  min-width: 0;
+  flex-wrap: wrap;
+}
+.character-name {
+  font-size: 13px;
+  line-height: 1.25;
+  color: var(--text-0);
+}
+.character-gen-btn { flex-shrink: 0; align-self: center; }
+.asset-final-prompt {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding-top: 7px;
+  border-top: 1px solid var(--border);
+  font-size: 10.5px;
+  line-height: 1.5;
+}
+.afp-label {
+  font-size: 9.5px;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  color: var(--text-3);
+}
+.afp-text {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  overflow: hidden;
+  word-break: break-word;
+  color: var(--text-2);
+}
+.afp-text.dim { color: var(--text-3); }
+.asset-final {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  overflow: hidden;
+  word-break: break-word;
+  color: var(--text-2);
+}
+.asset-final .afp-label { margin-right: 4px; }
+.character-visual-summary {
+  max-width: 100%;
+  display: flex;
+  gap: 8px;
+  overflow: hidden;
+  color: var(--text-3);
+  font-size: 10.5px;
+  line-height: 1.45;
+  white-space: nowrap;
+}
+.character-visual-summary span {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.asset-cover { position: relative; aspect-ratio: 1; background: var(--bg-2); overflow: hidden; }
+.asset-cover.wide { aspect-ratio: 16/9; }
+.asset-cover img { width: 100%; height: 100%; object-fit: cover; }
+.previewable-image { cursor: zoom-in; transition: transform 0.18s var(--ease-out), filter 0.18s var(--ease-out); }
+.previewable-image:hover { transform: scale(1.015); filter: saturate(1.04); }
+.asset-cover-badge {
+  position: absolute;
+  top: 7px;
+  left: 7px;
+  display: inline-flex;
+  align-items: center;
+  padding: 2px 7px;
+  border-radius: 999px;
+  background: var(--header-bg);
+  backdrop-filter: blur(10px);
+  -webkit-backdrop-filter: blur(10px);
+  box-shadow: var(--shadow-xs);
+  color: var(--text-2);
+  font-size: 9.5px;
+  font-weight: 700;
+}
+.asset-cover-badge.is-ready {
+  background: var(--success-bg);
+  color: var(--tag-success-text);
+}
+.asset-cover-badge.is-pending {
+  background: var(--accent-bg);
+  color: var(--accent-text);
+}
+.asset-cover-empty { width: 100%; height: 100%; display: flex; align-items: center; justify-content: center; color: var(--text-3); }
+.asset-body {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  padding: 9px 11px 8px;
+  min-width: 0;
+}
+.asset-name {
+  font-size: 13px;
+  font-weight: 650;
+  color: var(--text-0);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.asset-meta { font-size: 11px; line-height: 1.5; }
+.asset-desc {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  overflow: hidden;
+  word-break: break-word;
+}
+.asset-light {
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.asset-foot { display: flex; align-items: center; gap: 4px; padding: 7px 11px; border-top: 1px solid var(--border); }
+.prop-name-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+.prop-name-row .asset-name { min-width: 0; }
+.dot { width: 7px; height: 7px; border-radius: 50%; background: var(--bg-3); flex-shrink: 0; }
+.dot.ok { background: var(--success); }
+.dot.pending { background: var(--accent); }
+.ring-spinner {
+  width: 22px; height: 22px;
+  border: 2.5px solid var(--border);
+  border-top-color: var(--accent);
+  border-radius: 50%;
+  animation: spin 0.8s linear infinite;
+}
+.ring-spinner.sm { width: 13px; height: 13px; border-width: 2px; }
+@keyframes spin { to { transform: rotate(360deg); } }
+
+.empty-state {
+  min-height: 280px;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 10px;
+  border: 1px dashed var(--border-strong);
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+  text-align: center;
+}
+.empty-icon {
+  width: 56px; height: 56px; border-radius: var(--radius-lg);
+  background: var(--bg-2); color: var(--text-3);
+  display: flex; align-items: center; justify-content: center;
+  margin-bottom: 4px;
+}
+.empty-title { font-size: 14px; font-weight: 600; color: var(--text-1); }
+.empty-desc { font-size: 12px; color: var(--text-3); max-width: 260px; line-height: 1.6; }
+
+.viewer-overlay { align-items: center; }
+.viewer-dialog { width: min(960px, calc(100vw - 48px)); padding: 14px; }
+.viewer-head { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 10px; }
+.viewer-title { font-size: 13px; font-weight: 600; color: var(--text-1); }
+.viewer-img { width: 100%; max-height: 76vh; object-fit: contain; border-radius: var(--radius); background: var(--bg-2); display: block; }
+
+/* ===== 素材详情 / 编辑对话框（与工作台资产卡片同款布局） ===== */
+.mat-detail-overlay { z-index: 118; padding: 28px; }
+.mat-detail-dialog {
+  width: min(1040px, calc(100vw - 56px));
+  max-height: calc(100vh - 56px);
+}
+.mat-detail-head {
+  display: flex; align-items: center; justify-content: space-between;
+  gap: 12px; padding: 14px 16px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.mat-detail-title-block { min-width: 0; display: flex; flex-direction: column; gap: 4px; }
+.mat-detail-kicker {
+  color: var(--text-3); font-size: 10px; font-weight: 800;
+  letter-spacing: 0.12em; text-transform: uppercase;
+}
+.mat-detail-title {
+  margin: 0; color: var(--text-0); font-size: 18px;
+  line-height: 1.2; font-family: var(--font-display);
+}
+.mat-detail-head-actions {
+  display: flex; align-items: center; gap: 8px; flex-shrink: 0;
+}
+.mat-detail-body { min-height: 0; overflow: auto; padding: 16px; }
+.mat-detail-shell {
+  display: grid;
+  grid-template-columns: minmax(280px, 380px) minmax(0, 1fr);
+  gap: 14px; align-items: start;
+}
+.mat-detail-preview-panel,
+.mat-detail-editor-panel {
+  min-width: 0; display: flex; flex-direction: column; gap: 12px;
+}
+.mat-detail-preview-panel { position: sticky; top: 0; }
+
+.mat-detail-section-title {
+  min-height: 24px; display: flex; align-items: center;
+  justify-content: space-between; gap: 10px;
+  color: var(--text-1); font-size: 12px; font-weight: 820; letter-spacing: 0.02em;
+}
+.mat-detail-section-title .dim {
+  font-size: 11px; font-weight: 560; letter-spacing: 0; text-align: right;
+}
+
+/* 最终提示词面板 */
+.mat-detail-prompt-panel {
+  margin-top: 18px;
+  border-top: 1px solid var(--border);
+  padding-top: 16px;
+}
+.mat-detail-prompt-gen {
+  margin-left: auto;
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+}
+.mat-detail-prompt-text {
+  width: 100%;
+  margin-top: 10px;
+  padding: 10px 12px;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--surface);
+  color: var(--text-0);
+  font-size: 12.5px;
+  line-height: 1.6;
+  resize: vertical;
+  min-height: 112px;
+  font-family: inherit;
+}
+.mat-detail-prompt-text:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-bg); }
+.mat-detail-prompt-text::placeholder { color: var(--text-3); }
+
+/* 状态标签 */
+.mat-detail-state {
+  min-height: 20px; display: inline-flex; align-items: center;
+  padding: 0 7px; border-radius: 999px;
+  background: var(--overlay-track); color: var(--text-3);
+  font-size: 10px; font-weight: 760; white-space: nowrap;
+}
+.mat-detail-state.is-ready { color: var(--success); background: var(--success-bg); }
+
+/* 图片预览框 */
+.mat-detail-media-frame {
+  position: relative; width: 100%; aspect-ratio: 16/9;
+  display: block; padding: 0;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius); background: var(--bg-2);
+  color: var(--text-3); overflow: hidden; cursor: zoom-in;
+}
+.mat-detail-media-frame:disabled { cursor: default; opacity: 1; }
+.mat-detail-media-frame:focus-visible {
+  outline: none; border-color: var(--action-primary);
+  box-shadow: 0 0 0 3px var(--button-focus);
+}
+.mat-detail-media-frame img { width: 100%; height: 100%; display: block; object-fit: cover; }
+.mat-detail-media-empty {
+  width: 100%; height: 100%;
+  display: flex; align-items: center; justify-content: center;
+  color: var(--text-3);
+}
+
+/* 元数据行（类型 + 定位） */
+.mat-detail-meta-row {
+  display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 8px;
+}
+.mat-detail-meta-item {
+  min-width: 0; padding: 9px 10px;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius); background: var(--surface-muted);
+}
+.mat-detail-meta-item span {
+  display: block; color: var(--text-3);
+  font-size: 10px; font-weight: 780; letter-spacing: 0.04em;
+}
+.mat-detail-meta-item strong {
+  display: block; margin-top: 4px; min-width: 0;
+  color: var(--text-0); font-size: 12px;
+  line-height: 1.35; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+}
+
+/* 编辑区域 */
+.mat-detail-edit-grid {
+  display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px;
+}
+.mat-detail-edit-grid--character,
+.mat-detail-edit-grid--scene { grid-template-columns: 1fr; }
+.mat-detail-edit-field {
+  min-width: 0; display: flex; flex-direction: column; gap: 7px;
+}
+.mat-detail-edit-field > span,
+.mat-detail-edit-field > input::placeholder,
+.mat-detail-textarea::placeholder {
+  color: var(--text-3); font-size: 10px; font-weight: 780; letter-spacing: 0.04em;
+}
+.mat-detail-textarea { min-height: 138px; resize: vertical; }
+.mat-detail-edit-grid--character .mat-detail-textarea,
+.mat-detail-edit-grid--scene .mat-detail-textarea { min-height: 164px; }
+
+/* 底部操作栏 */
+.mat-detail-foot {
+  display: flex; align-items: center; justify-content: space-between;
+  gap: 8px; padding: 12px 16px;
+  border-top: 1px solid var(--surface-outline);
+}
+.mat-detail-secondary-actions,
+.mat-detail-primary-actions { display: flex; align-items: center; gap: 8px; }
+
+@media (max-width: 860px) {
+  .page { padding: 16px 16px 32px; }
+  .page-head { flex-wrap: wrap; }
+  .ep-grid { grid-template-columns: 1fr; }
+  .ep-actions { opacity: 1; } /* 移动端始终显示操作按钮 */
+  .dialog-foot { flex-wrap: wrap; gap: 10px; }
+  .dialog-foot-copy { display: none; }
+}
+</style>
diff --git a/huobao-source/frontend/app/views/drama/episode.vue b/huobao-source/frontend/app/views/drama/episode.vue
new file mode 100644
index 0000000..4c9b345
--- /dev/null
+++ b/huobao-source/frontend/app/views/drama/episode.vue
@@ -0,0 +1,6342 @@
+<template>
+  <div class="studio" v-if="drama">
+    <header class="studio-topbar">
+      <div class="studio-topbar-main">
+        <button class="back-btn topbar-back" @click="navigateTo(`/drama/${dramaId}`)">
+          <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.1" stroke-linecap="round" stroke-linejoin="round">
+            <line x1="19" y1="12" x2="5" y2="12"/><polyline points="12 19 5 12 12 5"/>
+          </svg>
+          {{ t('episode.topbar.back') }}
+        </button>
+        <div class="studio-identity">
+          <h1 class="studio-title">{{ drama.title }}</h1>
+          <span class="studio-episode-chip">{{ t('episode.topbar.episodeN', { n: episodeNumber }) }}</span>
+          <div class="studio-meta-row">
+            <span class="studio-meta-pill">{{ currentSubStageLabel }}</span>
+            <span class="studio-meta-pill is-progress">{{ pipelineProgress }}/{{ pipelineTotal }}</span>
+            <span class="studio-meta-inline">{{ t('episode.topbar.meta', { roles: chars.length, shots: sbs.length }) }}</span>
+          </div>
+        </div>
+      </div>
+
+      <div class="studio-topbar-side">
+        <div class="studio-model-picks">
+          <ModelSelect
+            v-if="textModelOptions.length"
+            v-model="chatModel"
+            :label="t('common.serviceType.text')"
+            :options="textModelOptions"
+            :default-label="t('episode.model.defaultWith', { model: textModelOptions[0].model })"
+            :show-config="textModelMultiCfg"
+          />
+          <ModelSelect
+            v-if="imageModelOptions.length"
+            v-model="imageModel"
+            :label="t('common.serviceType.image')"
+            :options="imageModelOptions"
+            :default-label="t('episode.model.defaultWith', { model: imageModelOptions[0].model })"
+            :show-config="imageModelMultiCfg"
+          />
+          <ModelSelect
+            v-if="videoModelOptions.length"
+            v-model="videoModel"
+            label="视频默认"
+            :options="videoModelOptions"
+            :default-label="t('episode.model.defaultWith', { model: videoModelOptions[0].model })"
+            :show-config="videoModelMultiCfg"
+          />
+          <ModelSelect
+            v-model="episodeResolution"
+            :label="t('episode.topbar.resolution')"
+            :options="resolutionOptions"
+            hide-default
+          />
+        </div>
+        <div class="studio-actions">
+          <LocaleSwitcher />
+          <button class="btn btn-icon tour-help-btn" :title="t('tour.helpTitle')" @click="startTour('episode', EPISODE_TOUR, t)">
+            <CircleHelp :size="14" :stroke-width="1.8" />
+          </button>
+          <button class="btn" @click="refresh">
+            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polyline points="23 4 23 10 17 10"/><polyline points="1 20 1 14 7 14"/><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/></svg>
+            {{ t('common.refresh') }}
+          </button>
+          <button class="btn task-drawer-trigger" @click="openTaskDrawer">
+            <ListTodo :size="12" />
+            {{ t('episode.topbar.tasks') }}
+            <span v-if="genTaskActiveCount" class="task-drawer-badge">{{ genTaskActiveCount }}</span>
+          </button>
+        </div>
+      </div>
+    </header>
+
+    <div class="studio-body">
+    <!-- ========== LEFT SIDEBAR ========== -->
+    <aside class="sidebar" :class="{ collapsed: sidebarCollapsed }">
+      <nav class="pipeline">
+        <div
+          v-for="section in sidebarSections"
+          :key="section.id"
+          :class="['pipe-section', 'is-' + sectionState(section.id)]"
+        >
+          <div class="pipe-section-label">
+            <span v-if="sectionState(section.id) !== 'none'" class="pipe-section-state">
+              <svg v-if="sectionState(section.id) === 'done'" width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><polyline points="20 6 9 17 4 12"/></svg>
+              <span v-else-if="sectionState(section.id) === 'active'" class="pipe-section-pulse" />
+              <span v-else class="pipe-section-dot" />
+            </span>
+            <span>{{ section.label }}</span>
+            <span v-if="sectionState(section.id) === 'active'" class="pipe-section-tag">{{ t('episode.sidebar.inProgress') }}</span>
+          </div>
+          <button
+            v-for="item in section.items"
+            :key="item.key"
+            :class="['pipe-item pipe-item-sub', {
+              active: activeSubStepKey === item.key,
+              done: sectionState(section.id) === 'done',
+              doing: sectionState(section.id) === 'active',
+            }]"
+            :title="sidebarCollapsed ? item.label : undefined"
+            @click="goSubStep(item.key)"
+          >
+            <span class="pipe-icon" :class="sectionState(section.id) === 'done' ? 'icon-done' : activeSubStepKey === item.key ? 'icon-active' : ''">
+              <!-- 收起态：始终显示步骤图标，进行中用右上角小脉冲点表达 -->
+              <template v-if="sidebarCollapsed">
+                <component :is="item.icon" :size="12" />
+                <span v-if="sectionState(section.id) === 'active'" class="pipe-mini-pulse" />
+              </template>
+              <svg v-else-if="sectionState(section.id) === 'done'" width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><polyline points="20 6 9 17 4 12"/></svg>
+              <span v-else-if="sectionState(section.id) === 'active'" class="pipe-item-pulse" />
+              <component v-else :is="item.icon" :size="11" />
+            </span>
+            <span class="pipe-copy">
+              <span class="pipe-label">{{ item.label }}</span>
+              <span v-if="item.desc" class="pipe-sub">{{ item.desc }}</span>
+            </span>
+          </button>
+        </div>
+      </nav>
+
+      <!-- Bottom: 收起/展开 + Stage marquee + Refresh -->
+      <div class="sidebar-bottom">
+        <button
+          type="button"
+          class="sidebar-toggle"
+          :title="t(sidebarCollapsed ? 'episode.sidebar.expand' : 'episode.sidebar.collapse')"
+          @click="toggleSidebar"
+        >
+          <svg class="sidebar-toggle-icon" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><polyline points="15 18 9 12 15 6"/></svg>
+          <span v-if="!sidebarCollapsed">{{ t('episode.sidebar.collapse') }}</span>
+        </button>
+        <!-- 步骤跑马灯：四段主流程进度，当前段流动光效，点击段可跳转 -->
+        <div class="sidebar-progress">
+          <div class="sidebar-progress-head">
+            <span class="sidebar-progress-title">{{ currentStageLabel }}</span>
+            <span class="sidebar-progress-count">{{ currentMainIdx + 1 }}/{{ mainProgressSteps.length }}</span>
+          </div>
+          <div class="sidebar-progress-track">
+            <button
+              v-for="(s, i) in mainProgressSteps"
+              :key="s.id"
+              type="button"
+              :class="['sidebar-progress-seg', { done: i < currentMainIdx || mainStageDone(s.id), current: i === currentMainIdx }]"
+              :title="s.label"
+              @click="goMainStage(s.id)"
+            ><span class="sidebar-progress-seg-fill" /></button>
+          </div>
+          <div class="sidebar-progress-labels">
+            <span
+              v-for="(s, i) in mainProgressSteps"
+              :key="s.id"
+              :class="{ on: i === currentMainIdx, done: i < currentMainIdx || mainStageDone(s.id) }"
+            >{{ s.label }}</span>
+          </div>
+        </div>
+        <button class="refresh-btn" @click="refresh">
+          <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polyline points="23 4 23 10 17 10"/><polyline points="1 20 1 14 7 14"/><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/></svg>
+          {{ t('episode.sidebar.refreshData') }}
+        </button>
+      </div>
+    </aside>
+
+    <!-- ========== MAIN CONTENT ========== -->
+    <main class="main">
+      <!-- ===== SCRIPT PANEL ===== -->
+      <div v-if="panel === 'script'" class="content-panel">
+        <!-- Step 0: Raw Content -->
+        <div v-if="scriptStep === 0" class="step-editor">
+          <div class="step-toolbar">
+            <div class="toolbar-left">
+              <div class="step-indicator">
+                <span class="step-num">01</span>
+                <span class="step-name">{{ t('episode.script.raw') }}</span>
+              </div>
+            </div>
+            <div class="toolbar-right">
+              <span v-if="rawLen" class="char-count">{{ t('episode.script.charCount', { n: rawLen }) }}</span>
+              <button class="btn btn-sm" @click="saveRaw(); toast.success(t('episode.script.saved'))">
+                <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M19 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11l5 5v11a2 2 0 0 1-2 2z"/><polyline points="17 21 17 13 7 13 7 21"/><polyline points="7 3 7 8 15 8"/></svg>
+                {{ t('common.save') }}
+              </button>
+            </div>
+          </div>
+          <textarea
+            class="fill-textarea"
+            v-model="localRaw"
+            :placeholder="t('episode.script.rawPlaceholder')"
+          />
+        </div>
+
+        <!-- Step 1: Rewrite -->
+        <div v-else-if="scriptStep === 1" class="step-editor">
+          <div class="step-toolbar">
+            <div class="toolbar-left">
+              <div class="step-indicator">
+                <span class="step-num">02</span>
+                <span class="step-name">{{ t('episode.script.rewrite') }}</span>
+              </div>
+            </div>
+            <div class="toolbar-right">
+              <span v-if="scriptLen" class="char-count">{{ t('episode.script.charCount', { n: scriptLen }) }}</span>
+              <button v-if="rawContent" class="btn btn-sm" @click="skipRewrite">
+                <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M5 12h14"/><path d="M13 18l6-6-6-6"/></svg>
+                {{ t('episode.script.skipRewrite') }}
+              </button>
+              <button v-if="scriptContent" class="btn btn-sm" @click="doRewrite" :disabled="rn">
+                <Loader2 v-if="rn && rt === 'script_rewriter'" :size="11" class="animate-spin" />
+                <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M15 3h4a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-4"/><polyline points="10 17 15 12 10 7"/><line x1="15" y1="12" x2="3" y2="12"/></svg>
+                {{ t('episode.script.rewriteAgain') }}
+              </button>
+            </div>
+          </div>
+
+          <div v-if="!scriptContent && !rn" class="step-empty">
+            <div class="empty-visual">
+              <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round">
+                <path d="M15 3h4a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-4"/><polyline points="10 17 15 12 10 7"/><line x1="15" y1="12" x2="3" y2="12"/>
+              </svg>
+            </div>
+            <div class="empty-title">{{ t('episode.script.emptyTitle') }}</div>
+            <div class="empty-desc">{{ t('episode.script.emptyDesc') }}</div>
+            <div class="step-empty-actions">
+              <button class="btn btn-primary" @click="doRewrite">
+                <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg>
+                {{ t('episode.script.startRewrite') }}
+              </button>
+              <button class="btn" @click="skipRewrite">
+                <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round"><path d="M5 12h14"/><path d="M13 18l6-6-6-6"/></svg>
+                {{ t('episode.script.skipRewrite') }}
+              </button>
+            </div>
+          </div>
+          <div v-else-if="rn && rt === 'script_rewriter'" class="step-loading">
+            <Loader2 :size="24" class="animate-spin" style="color:var(--accent)" />
+            <div class="loading-text">{{ t('episode.script.rewriting') }}</div>
+          </div>
+          <textarea v-else class="fill-textarea" v-model="localScript" :placeholder="t('episode.script.scriptPlaceholder')" />
+        </div>
+      </div>
+
+      <!-- ===== PRODUCTION PANEL ===== -->
+      <div v-else-if="panel === 'production'" class="content-panel">
+        <!-- Guard: current production step prerequisites -->
+        <div v-if="productionBlockMessage" class="step-empty" style="flex:1">
+          <div class="empty-visual">
+            <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
+          </div>
+          <div class="empty-title">{{ t('episode.prod.notReady') }}</div>
+          <div class="empty-desc">{{ productionBlockMessage }}</div>
+          <button class="btn btn-primary" @click="goProductionBlockTarget">{{ productionBlockActionLabel }}</button>
+        </div>
+
+        <template v-else>
+          <!-- 制作子步骤导航（资产/分镜拆分/视频生成）由左侧栏承担，顶部不再重复展示 -->
+          <!-- Sub: Assets -->
+          <div v-if="prodTab === 'assets'" class="prod-content">
+            <div class="prod-section-bar">
+              <span class="dim" style="font-size:12px">{{ t('episode.prod.assets') }}</span>
+              <span class="tag mono">{{ t('episode.prod.readyCount', { ready: assetReadyCount, total: assetTotalCount }) }}</span>
+              <div class="ml-auto flex gap-1 asset-bar-actions">
+                <button
+                  v-for="et in EXTRACT_TARGETS"
+                  :key="et.key"
+                  class="btn btn-sm asset-btn-extract"
+                  :disabled="isExtracting(et.key)"
+                  @click="doExtract(et.key)"
+                >
+                  <Loader2 v-if="isExtracting(et.key)" :size="11" class="animate-spin" />
+                  <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
+                  {{ (et.key === 'characters' ? chars.length : et.key === 'scenes' ? scenes.length : propItems.length) ? t('episode.prod.reextract', { type: et.label }) : t('episode.prod.extract', { type: et.label }) }}
+                </button>
+                <span class="asset-bar-divider" />
+                <button class="btn btn-sm asset-btn-batch" @click="batchCharImages">
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><polyline points="21 15 16 10 5 21"/></svg>
+                  {{ t('episode.prod.batchChar') }}
+                </button>
+                <button class="btn btn-sm asset-btn-batch" @click="batchSceneImages">
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><polyline points="21 15 16 10 5 21"/></svg>
+                  {{ t('episode.prod.batchScene') }}
+                </button>
+                <button class="btn btn-sm asset-btn-batch" @click="batchPropImages">
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><polyline points="21 15 16 10 5 21"/></svg>
+                  {{ t('episode.prod.batchProp') }}
+                </button>
+              </div>
+            </div>
+            <div v-if="extractingTargets.length && !chars.length && !scenes.length && !propItems.length" class="step-loading">
+              <Loader2 :size="24" class="animate-spin" style="color:var(--accent)" />
+              <div class="loading-text">{{ t('episode.prod.extractingTypes', { types: extractingLabels }) }}</div>
+            </div>
+            <div v-else-if="!chars.length && !scenes.length && !propItems.length" class="step-empty asset-empty-state">
+              <div class="empty-visual">
+                <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
+              </div>
+              <div class="empty-title">{{ t('episode.prod.emptyTitle') }}</div>
+              <div class="empty-desc">{{ t('episode.prod.emptyDesc') }}</div>
+              <button class="btn btn-primary" :disabled="!!extractingTargets.length" @click="doExtractAll">
+                <Loader2 v-if="extractingTargets.length" :size="13" class="animate-spin" />
+                <svg v-else width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg>
+                {{ extractingTargets.length ? t('episode.prod.extractingTypesDots', { types: extractingLabels }) : t('episode.prod.startExtract') }}
+              </button>
+            </div>
+            <template v-else>
+            <div class="asset-section-title">
+              {{ t('common.role') }}
+              <button class="asset-add-btn" @click="openAssetCreate('character')"><Plus :size="11" /> {{ t('common.add') }}</button>
+            </div>
+            <template v-if="visualChars.length">
+            <div class="character-asset-grid">
+              <article
+                v-for="c in visualChars"
+                :key="c.id"
+                class="card character-asset-card"
+                tabindex="0"
+                role="button"
+                @click="openAssetDetail('character', c)"
+                @keydown.enter.self.prevent="openAssetDetail('character', c)"
+                @keydown.space.self.prevent="openAssetDetail('character', c)"
+              >
+                <button class="asset-del-btn" :title="t('episode.asset.delChar')" @click.stop="askDeleteAsset('character', c)"><X :size="11" /></button>
+                <div class="character-asset-main">
+                  <div class="character-asset-overview"><div class="character-portrait">
+                      <img
+                        v-if="c.image_url || c.imageUrl"
+                        :src="thumbOf(assetImageSrc(c))"
+                        class="previewable-image"
+                        loading="lazy"
+                        @error="thumbFallback($event, assetImageSrc(c))"
+                        @click.stop="openImageViewer(assetImageSrc(c), t('episode.asset.charImageTitle', { name: c.name }))"
+                      />
+                      <div v-else class="character-portrait-empty">
+                        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/><circle cx="12" cy="7" r="4"/></svg>
+                      </div>
+                      <span class="asset-cover-badge" :class="(c.image_url || c.imageUrl) ? 'is-ready' : (isPendingCharImage(c.id) ? 'is-pending' : '')">
+                        {{ (c.image_url || c.imageUrl) ? t('episode.asset.portraitReady') : (isPendingCharImage(c.id) ? t('episode.asset.portraitPending') : t('episode.asset.portraitTodo')) }}
+                      </span>
+                    </div>
+
+                    <div class="character-asset-head">
+                      <div class="character-title-block">
+                        <div class="character-name-row">
+                          <strong class="character-name">{{ c.name }}</strong>
+                          <span class="tag">{{ c.role || t('common.role') }}</span>
+                        </div>
+                        <div class="character-visual-summary" :title="characterVisualSummary(c)">
+                          <span>{{ t('episode.asset.appearance') }}{{ characterAppearanceValue(c) }}</span>
+                          <span>{{ t('episode.asset.styling') }}{{ characterStylingValue(c) }}</span>
+                        </div>
+                      </div>
+                      <button class="btn btn-sm character-gen-btn" :disabled="isPendingCharImage(c.id) || referencesSaving('character', c.id)" @click.stop="genCharImg(c.id)">
+                        <Loader2 v-if="isPendingCharImage(c.id)" :size="11" class="animate-spin" />
+                        {{ (c.image_url || c.imageUrl) ? t('episode.asset.regen') : (isPendingCharImage(c.id) ? t('episode.asset.generating') : t('episode.asset.generate')) }}
+                      </button>
+                      <button class="btn btn-sm" :title="t('episode.asset.uploadCharImage')" :disabled="isUploadingAsset('character', c.id)" @click.stop="uploadAssetImage('character', c.id)">
+                        <Loader2 v-if="isUploadingAsset('character', c.id)" :size="11" class="animate-spin" />
+                        <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
+                        {{ t('episode.asset.upload') }}
+                      </button>
+                    </div>
+                  </div>
+                  <div class="asset-final-prompt" :title="c.final_prompt || c.finalPrompt || ''">
+                    <span class="afp-label">{{ t('episode.asset.finalPromptTurnaround') }}</span>
+                    <span :class="['afp-text', !(c.final_prompt || c.finalPrompt) && 'dim']">{{ c.final_prompt || c.finalPrompt || t('episode.asset.finalPromptAutoTurnaround') }}</span>
+                  </div>
+                  <AssetReferenceImages kind="character" :asset="c" @updated="updateAssetReferences" @preview="openImageViewer" />
+                  <CharacterVoice :character="c" @updated="updateCharacterVoice" />
+                </div>
+              </article>
+            </div>
+            </template>
+
+            <div class="asset-section-title">
+              {{ t('common.scene') }}
+              <button class="asset-add-btn" @click="openAssetCreate('scene')"><Plus :size="11" /> {{ t('common.add') }}</button>
+            </div>
+            <template v-if="scenes.length">
+            <div class="asset-grid">
+              <div
+                v-for="s in scenes"
+                :key="s.id"
+                class="card asset-card asset-click-card"
+                tabindex="0"
+                role="button"
+                @click="openAssetDetail('scene', s)"
+                @keydown.enter.prevent="openAssetDetail('scene', s)"
+                @keydown.space.prevent="openAssetDetail('scene', s)"
+              >
+                <button class="asset-del-btn" :title="t('episode.asset.delScene')" @click.stop="askDeleteAsset('scene', s)"><X :size="11" /></button>
+                <div class="asset-cover wide">
+                  <img
+                    v-if="s.image_url || s.imageUrl"
+                    :src="thumbOf(assetImageSrc(s))"
+                    class="previewable-image"
+                    loading="lazy"
+                    @error="thumbFallback($event, assetImageSrc(s))"
+                    @click.stop="openImageViewer(assetImageSrc(s), t('episode.asset.sceneImageTitle', { name: s.location }))"
+                  />
+                  <div v-else class="asset-cover-empty">
+                    <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z"/><circle cx="12" cy="10" r="3"/></svg>
+                  </div>
+                  <span class="asset-cover-badge" :class="(s.image_url || s.imageUrl) ? 'is-ready' : (isPendingSceneImage(s.id) ? 'is-pending' : '')">{{ (s.image_url || s.imageUrl) ? t('episode.asset.ready') : (isPendingSceneImage(s.id) ? t('episode.asset.generating') : t('episode.asset.todo')) }}</span>
+                </div>
+                <div class="asset-body">
+                  <div class="asset-name" :title="s.location">{{ s.location }}</div>
+                  <div class="asset-meta asset-desc dim" :title="sceneDescriptionValue(s)">{{ sceneDescriptionValue(s) }}</div>
+                  <div v-if="sceneLightingValue(s)" class="asset-meta asset-light dim" :title="sceneLightingValue(s)">{{ t('episode.asset.lighting') }}{{ sceneLightingValue(s) }}</div>
+                  <div class="asset-meta asset-final" :class="{ dim: !(s.final_prompt || s.finalPrompt) }" :title="s.final_prompt || s.finalPrompt || ''">
+                    <span class="afp-label">{{ t('episode.asset.finalPromptFixed') }}</span>
+                    {{ s.final_prompt || s.finalPrompt || t('episode.asset.finalPromptAutoFixed') }}
+                  </div>
+                </div>
+                <div class="asset-foot">
+                  <span :class="['dot', (s.image_url || s.imageUrl) && 'ok', isPendingSceneImage(s.id) && 'pending']" />
+                  <button class="btn btn-sm ml-auto" :title="t('episode.asset.uploadSceneImage')" :disabled="isUploadingAsset('scene', s.id)" @click.stop="uploadAssetImage('scene', s.id)">
+                    <Loader2 v-if="isUploadingAsset('scene', s.id)" :size="11" class="animate-spin" />
+                    <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
+                    {{ t('episode.asset.upload') }}
+                  </button>
+                  <button class="btn btn-sm" :disabled="isPendingSceneImage(s.id) || referencesSaving('scene', s.id)" @click.stop="genSceneImg(s.id)">
+                    <Loader2 v-if="isPendingSceneImage(s.id)" :size="11" class="animate-spin" />
+                    {{ (s.image_url || s.imageUrl) ? t('episode.asset.regen') : (isPendingSceneImage(s.id) ? t('episode.asset.generating') : t('episode.asset.generate')) }}
+                  </button>
+                </div>
+                <AssetReferenceImages kind="scene" :asset="s" @updated="updateAssetReferences" @preview="openImageViewer" />
+              </div>
+            </div>
+            </template>
+
+            <div class="asset-section-title">
+              {{ t('common.prop') }}
+              <button class="asset-add-btn" @click="openAssetCreate('prop')"><Plus :size="11" /> {{ t('common.add') }}</button>
+            </div>
+            <div v-if="propItems.length" class="asset-grid">
+              <div
+                v-for="p in propItems"
+                :key="p.id"
+                class="card asset-card asset-click-card prop-card"
+                tabindex="0"
+                role="button"
+                @click="openAssetDetail('prop', p)"
+                @keydown.enter.prevent="openAssetDetail('prop', p)"
+                @keydown.space.prevent="openAssetDetail('prop', p)"
+              >
+                <button class="asset-del-btn" :title="t('episode.asset.delProp')" @click.stop="askDeleteAsset('prop', p)"><X :size="11" /></button>
+                <div class="asset-cover wide">
+                  <img
+                    v-if="p.image_url || p.imageUrl"
+                    :src="thumbOf(assetImageSrc(p))"
+                    class="previewable-image"
+                    loading="lazy"
+                    @error="thumbFallback($event, assetImageSrc(p))"
+                    @click.stop="openImageViewer(assetImageSrc(p), t('episode.asset.propImageTitle', { name: p.name }))"
+                  />
+                  <div v-else class="asset-cover-empty">
+                    <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/></svg>
+                  </div>
+                  <span class="asset-cover-badge" :class="(p.image_url || p.imageUrl) ? 'is-ready' : (isPendingPropImage(p.id) ? 'is-pending' : '')">{{ (p.image_url || p.imageUrl) ? t('episode.asset.ready') : (isPendingPropImage(p.id) ? t('episode.asset.generating') : t('episode.asset.todo')) }}</span>
+                </div>
+                <div class="asset-body">
+                  <div class="prop-name-row">
+                    <span class="asset-name" :title="p.name">{{ p.name }}</span>
+                    <span class="tag">{{ p.type || t('common.prop') }}</span>
+                  </div>
+                  <div class="asset-meta asset-desc dim" :title="p.description || ''">{{ p.description || t('episode.asset.noDescription') }}</div>
+                  <div class="asset-meta asset-final" :class="{ dim: !(p.final_prompt || p.finalPrompt) }" :title="p.final_prompt || p.finalPrompt || ''">
+                    <span class="afp-label">{{ t('episode.asset.finalPromptWhiteBg') }}</span>
+                    {{ p.final_prompt || p.finalPrompt || t('episode.asset.finalPromptAutoWhiteBg') }}
+                  </div>
+                </div>
+                <div class="asset-foot">
+                  <span :class="['dot', (p.image_url || p.imageUrl) && 'ok', isPendingPropImage(p.id) && 'pending']" />
+                  <button class="btn btn-sm ml-auto" :title="t('episode.asset.uploadPropImage')" :disabled="isUploadingAsset('prop', p.id)" @click.stop="uploadAssetImage('prop', p.id)">
+                    <Loader2 v-if="isUploadingAsset('prop', p.id)" :size="11" class="animate-spin" />
+                    <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
+                    {{ t('episode.asset.upload') }}
+                  </button>
+                  <button class="btn btn-sm" :disabled="isPendingPropImage(p.id) || referencesSaving('prop', p.id)" @click.stop="genPropImg(p.id)">
+                    <Loader2 v-if="isPendingPropImage(p.id)" :size="11" class="animate-spin" />
+                    {{ (p.image_url || p.imageUrl) ? t('episode.asset.regen') : (isPendingPropImage(p.id) ? t('episode.asset.generating') : t('episode.asset.generate')) }}
+                  </button>
+                </div>
+                <AssetReferenceImages kind="prop" :asset="p" @updated="updateAssetReferences" @preview="openImageViewer" />
+              </div>
+            </div>
+            <div v-else class="asset-props-empty">{{ t('episode.asset.propsEmpty') }}</div>
+            </template>
+          </div>
+
+          <!-- Sub: Video Production（分镜拆分 + 视频生成 合并） -->
+          <div v-if="prodTab === 'videos'" class="prod-content">
+            <div class="prod-section-bar">
+              <span class="dim" style="font-size:12px">{{ t('episode.prod.videos') }}</span>
+              <span class="tag mono">{{ t('episode.sb.segmentStat', { n: sbs.length, dur: totalDuration }) }}</span>
+              <span class="tag mono" :title="t('episode.vid.aspectRatio')">{{ dramaAspectRatio }}</span>
+              <div class="ml-auto flex gap-1">
+                <button class="btn btn-sm" :disabled="rn" @click="doBreakdown">
+                  <Loader2 v-if="rt === 'storyboard_breaker'" :size="11" class="animate-spin" />
+                  <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg>
+                  {{ sbs.length ? t('episode.sb.rebreak') : t('episode.sb.startBreak') }}
+                </button>
+                <button class="btn btn-sm" :disabled="videoPromptBatch.running || !sbs.length" @click="batchVideoPrompts">
+                  <Loader2 v-if="videoPromptBatch.running" :size="11" class="animate-spin" />
+                  <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/></svg>
+                  {{ videoPromptBatch.running ? t('episode.sb.promptProgress', { done: videoPromptBatch.completed, total: videoPromptBatch.total }) : (videoSelectMode && selectedVideoSbIds.length ? t('episode.sb.promptSelected', { n: selectedVideoSbIds.length }) : t('episode.sb.batchPrompts')) }}
+                </button>
+                <button v-if="recoverableVideoCount" class="btn btn-sm video-retry-failed" @click="retryFailedVideos">
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polyline points="23 4 23 10 17 10"/><polyline points="1 20 1 14 7 14"/><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/></svg>
+                  {{ t('episode.recovery.restoreFailed', { n: recoverableVideoCount }) }}
+                </button>
+                <button class="btn btn-sm" :class="{ 'is-on': videoSelectMode }" @click="toggleVideoSelectMode">
+                  {{ videoSelectMode ? t('episode.vid.selectDone', { n: selectedVideoSbIds.length }) : t('episode.vid.select') }}
+                </button>
+                <button class="btn btn-sm" :disabled="!sbs.length" @click="batchVideos">
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
+                  {{ videoSelectMode && selectedVideoSbIds.length ? t('episode.vid.batchSelected', { n: selectedVideoSbIds.length }) : t('episode.vid.batchVideos') }}
+                </button>
+              </div>
+            </div>
+            <div v-if="!sbs.length" class="step-empty video-task-empty-state">
+              <div class="empty-visual">
+                <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><rect x="2" y="2" width="20" height="20" rx="2.5"/><line x1="7" y1="8" x2="7" y2="16"/><line x1="10" y1="8" x2="10" y2="16"/><line x1="13" y1="8" x2="13" y2="16"/></svg>
+              </div>
+              <div class="empty-title">{{ t('episode.sb.emptyTitle') }}</div>
+              <div class="empty-desc">{{ t('episode.sb.emptyDesc') }}</div>
+              <div class="locked-config-banner">{{ t('episode.vid.lockedModel') }}{{ effectiveVideoModelLabel }}</div>
+              <button class="btn btn-primary" :disabled="rn" @click="doBreakdown">
+                <Loader2 v-if="rt === 'storyboard_breaker'" :size="13" class="animate-spin" />
+                <svg v-else width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg>
+                {{ t('episode.sb.startBreak') }}
+              </button>
+            </div>
+            <div v-else class="video-task-workbench has-player" :style="{ '--vleft': videoLeftW + 'px', '--vright': videoRightW + 'px' }">
+              <section class="video-task-list">
+                <div class="video-task-head">
+                <div>
+                  <div class="video-task-title">{{ t('episode.vid.listTitle') }}</div>
+                  <div class="video-task-meta">{{ videoListFilter ? t('episode.vid.listMetaFiltered', { n: videoTaskRows.length, total: allVideoTaskRows.length }) : t('episode.vid.listMeta', { n: videoTaskRows.length }) }}</div>
+                </div>
+                <div class="video-task-metrics">
+                  <button type="button" class="video-task-metric is-pending" :class="{ on: videoListFilter === 'pending' }" @click="toggleVideoFilter('pending')">{{ t('episode.vid.metricPending', { n: pendingVideoIds.length }) }}</button>
+                  <button type="button" class="video-task-metric is-done" :class="{ on: videoListFilter === 'done' }" @click="toggleVideoFilter('done')">{{ t('episode.vid.metricDone', { n: videoTaskDoneCount }) }}</button>
+                  <button type="button" class="video-task-metric is-failed" :class="{ on: videoListFilter === 'failed' }" @click="toggleVideoFilter('failed')">{{ t('episode.vid.metricFailed', { n: videoTaskFailedCount }) }}</button>
+                </div>
+                </div>
+                <div v-if="videoSelectMode" class="shot-quick-actions video-quick-actions">
+                  <button class="shot-quick-btn" @click="toggleSelectAllVideos">{{ t('episode.sb.selectAll') }}</button>
+                  <button class="shot-quick-btn" @click="selectMissingVideos">{{ t('episode.vid.selectMissing') }}</button>
+                  <button class="shot-quick-btn" @click="selectedVideoSbIds = []">{{ t('episode.sb.clear') }}</button>
+                </div>
+                <div class="video-task-table">
+                <div
+                  v-for="task in videoTaskRows"
+                  :key="task.id"
+                  :class="['video-task-row', 'is-' + videoTaskState(task.storyboard), { active: !videoSelectMode && selectedSb?.id === task.storyboard.id, 'is-selected': videoSelectMode && isVideoSbSelected(task.id) }]"
+                  role="button"
+                  tabindex="0"
+                  @click="onVideoTaskRowClick(task.storyboard)"
+                  @keydown.enter.prevent="onVideoTaskRowClick(task.storyboard)"
+                  @keydown.space.prevent="onVideoTaskRowClick(task.storyboard)"
+                >
+                  <div class="video-task-preview">
+                    <span
+                      v-if="videoSelectMode"
+                      class="shot-check video-task-check"
+                      :class="{ on: isVideoSbSelected(task.id) }"
+                    >
+                      <svg v-if="isVideoSbSelected(task.id)" width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3.2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>
+                    </span>
+                    <video
+                      v-if="hasVid(task.storyboard)"
+                      :src="'/' + getVideoUrl(task.storyboard)"
+                      :poster="posterOf('/' + getVideoUrl(task.storyboard)) || undefined"
+                      preload="none"
+                      playsinline
+                      muted
+                      tabindex="-1"
+                    />
+                    <div v-else class="video-task-empty">
+                      <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
+                    </div>
+                    <span class="video-task-index">#{{ String(task.index + 1).padStart(2, '0') }}</span>
+                  </div>
+                  <div class="video-task-main">
+                    <div class="video-task-line">
+                      <strong class="video-task-name">{{ task.title }}</strong>
+                    </div>
+                    <div class="video-task-meta-line">
+                      <span :class="['video-task-state', 'is-' + videoTaskState(task.storyboard)]">
+                        <i :class="['dot', videoTaskState(task.storyboard) === 'done' && 'ok', videoTaskState(task.storyboard) === 'pending' && 'pending']" />{{ videoTaskStatusLabel(task.storyboard) }}
+                      </span>
+                      <span class="video-task-sep">·</span>
+                      <span>{{ task.duration }}s</span>
+                      <template v-if="task.meta">
+                        <span class="video-task-sep">·</span>
+                        <span class="video-task-loc truncate">{{ task.meta }}</span>
+                      </template>
+                    </div>
+                    <div v-if="latestVideoTask(task.id)" class="video-task-routing" :title="videoTaskRoutingLabel(latestVideoTask(task.id))" style="font-size:11px;color:var(--text-3);margin-top:4px;line-height:1.4;overflow-wrap:anywhere">{{ videoTaskRoutingLabel(latestVideoTask(task.id), true) }}</div>
+                    <div v-if="task.error" class="video-task-error" :title="task.error">
+                      {{ videoErrorLabel(task.id, task.error) }}
+                      <div class="flex gap-2">
+                        <button class="btn btn-sm" @click.stop="copyVideoDiagnostics(task.id)">{{ t('episode.recovery.diagnostics') }}</button>
+                        <button v-if="canRecoverVideo(task.id)" class="btn btn-sm" @click.stop="genVid(task.storyboard, { forceNew: true })">{{ t('episode.recovery.newGeneration') }}</button>
+                      </div>
+                      <div v-if="videoModerationHint(task.error)" class="video-task-error-hint">{{ videoModerationHint(task.error) }}</div>
+                    </div>
+                  </div>
+                  <button
+                    class="btn btn-icon btn-sm video-task-action"
+                    :title="videoTaskActionLabel(task.storyboard)"
+                    :disabled="videoTaskState(task.storyboard) === 'pending'"
+                    @click.stop="genVid(task.storyboard)"
+                  >
+                    <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
+                  </button>
+                </div>
+                </div>
+              </section>
+
+              <div v-if="selectedSb" class="video-task-side">
+              <div class="video-main-col">
+              <div class="video-main-scroll">
+                <div class="video-main-grid">
+                  <section class="video-inspector-section">
+                    <span class="video-inspector-label">{{ t('episode.sb.descSection') }}</span>
+                    <label class="field">
+                      <span class="field-label">{{ t('episode.sb.descLabel') }} <span class="dim">({{ t('episode.sb.descHint') }})</span></span>
+                      <textarea :value="selectedSb.description || ''" class="textarea" rows="7" @blur="updateField(selectedSb, 'description', $event.target.value)" :placeholder="t('episode.sb.descPlaceholder')" />
+                    </label>
+                    <label class="field">
+                      <span class="field-label">{{ t('episode.sb.atmosphere') }}</span>
+                      <textarea :value="selectedSb.atmosphere || ''" class="textarea" rows="2" @blur="updateField(selectedSb, 'atmosphere', $event.target.value)" :placeholder="t('episode.sb.atmospherePlaceholder')" />
+                    </label>
+                  </section>
+
+                  <section class="video-inspector-section">
+                    <div class="video-inspector-prompt-head">
+                      <span class="video-inspector-label">{{ t('episode.ref.title') }}</span>
+                      <span class="tag mono">{{ t('episode.ref.boundCount', { bound: refBindableAssets.filter(a => a.bound).length, total: refBindableAssets.length }) }}</span>
+                    </div>
+                    <div class="storyboard-ref-list is-embedded">
+                      <template v-for="g in REF_KINDS" :key="g.kind">
+                        <div v-if="refBindableAssets.filter(a => a.kind === g.kind).length" class="storyboard-ref-group">
+                          <div class="storyboard-ref-group-label">{{ g.label }}</div>
+                          <div
+                            v-for="asset in refBindableAssets.filter(a => a.kind === g.kind)"
+                            :key="asset.key"
+                            :class="['storyboard-ref-item', { bound: asset.bound }]"
+                            :title="asset.bound ? t('episode.ref.clickRemove') : t('episode.ref.clickAdd')"
+                            @click="toggleShotBind(selectedSb, asset)"
+                          >
+                            <button
+                              type="button"
+                              class="storyboard-ref-thumb"
+                              :disabled="!asset.ready"
+                              @click.stop="asset.ready && openImageViewer(assetImageSrc({ imageUrl: asset.imageUrl }), `${asset.name} ${asset.typeLabel}`)"
+                            >
+                              <img v-if="asset.ready" :src="thumbOf(assetImageSrc({ imageUrl: asset.imageUrl }))" class="previewable-image" loading="lazy" @error="thumbFallback($event, assetImageSrc({ imageUrl: asset.imageUrl }))" />
+                              <span v-else>{{ asset.kind === 'scene' ? t('episode.ref.shortScene') : asset.kind === 'prop' ? t('episode.ref.shortProp') : t('episode.ref.shortChar') }}</span>
+                            </button>
+                            <div class="storyboard-ref-main">
+                              <span class="storyboard-ref-name">{{ asset.name }}</span>
+                              <span class="storyboard-ref-meta">{{ asset.typeLabel }} · {{ asset.meta }}</span>
+                              <span :class="['storyboard-ref-state', asset.bound && asset.ready ? 'is-ready' : '']">
+                                {{ asset.bound ? (asset.ready ? t('episode.ref.usable') : t('episode.ref.notReady')) : t('episode.ref.unbound') }}
+                              </span>
+                              <button v-if="asset.bound && !asset.ready" type="button" class="storyboard-ref-goto" @click.stop="prodTab = 'assets'">{{ t('episode.ref.gotoGenerate') }}</button>
+                            </div>
+                          </div>
+                        </div>
+                      </template>
+                      <div v-if="!refBindableAssets.length" class="storyboard-ref-empty">{{ t('episode.ref.empty') }}</div>
+                    </div>
+                  </section>
+                </div>
+
+                  <section class="video-inspector-section">
+                    <div class="video-inspector-prompt-head">
+                      <span class="video-inspector-label video-inspector-label-hero">{{ t('episode.sb.videoPromptSection') }}</span>
+                      <button
+                        type="button"
+                        class="btn btn-sm"
+                        :disabled="videoPromptGeneratingIds.includes(selectedSb?.id) || videoPromptBatch.running"
+                        @click="genVideoPrompt(selectedSb)"
+                      >
+                        <Loader2 v-if="videoPromptGeneratingIds.includes(selectedSb?.id)" :size="11" class="animate-spin" />
+                        {{ (selectedSb.video_prompt || selectedSb.videoPrompt) ? t('episode.sb.regenPrompt') : t('episode.sb.aiGenerate') }}
+                      </button>
+                    </div>
+                    <MentionTextarea
+                      :model-value="selectedSb.video_prompt || selectedSb.videoPrompt || ''"
+                      :options="mentionOptions"
+                      :rows="14"
+                      input-class="textarea video-inspector-prompt"
+                      :placeholder="t('episode.inspector.videoPromptPlaceholder')"
+                      @commit="v => updateField(selectedSb, 'video_prompt', v)"
+                    />
+                    <p class="voice-reference-hint">{{ t('characterVoice.referenceHint') }}</p>
+                  </section>
+              </div>
+              </div>
+
+              <aside class="video-task-inspector">
+            <aside class="video-task-player">
+              <div class="video-player-head">
+                <div class="video-player-head-info">
+                  <div class="video-player-title">{{ t('episode.vid.playerTitle', { n: String(selectedVideoTaskNumber).padStart(2, '0') }) }}</div>
+                  <span :class="['video-task-status', 'is-' + videoTaskState(selectedSb)]">
+                    <span :class="['dot', videoTaskState(selectedSb) === 'done' && 'ok', videoTaskState(selectedSb) === 'pending' && 'pending']" />
+                    {{ videoTaskStatusLabel(selectedSb) }}
+                  </span>
+                  <span v-if="selectedSb.duration" class="video-player-sub">{{ selectedSb.duration }}s</span>
+                </div>
+                <button
+                  v-if="previewVideoUrl && !playerIsRemote"
+                  class="btn btn-sm btn-primary"
+                  @click="setAsMainVideo"
+                >
+                  {{ t('episode.vid.setMain') }}
+                </button>
+                <a
+                  v-if="playerVideoUrl"
+                  :href="playerVideoUrl"
+                  :target="playerIsRemote ? '_blank' : undefined"
+                  rel="noopener noreferrer"
+                  download
+                  class="btn btn-sm"
+                >
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+                  {{ t('common.download') }}
+                </a>
+              </div>
+              <div class="video-player-stage">
+                <video
+                  v-if="playerVideoUrl"
+                  :key="playerVideoUrl"
+                  :src="playerVideoUrl"
+                  :poster="playerIsRemote ? undefined : posterOf(playerVideoUrl) || undefined"
+                  @error="playerLoadFailed = true"
+                  controls
+                  preload="metadata"
+                  playsinline
+                  class="video-player-video"
+                />
+                <div v-else class="video-player-empty">
+                  <svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
+                  <div class="video-player-empty-copy">
+                    <div class="video-player-empty-title">{{ videoAwaitingDelivery(selectedSb) ? t('episode.recovery.awaitingDelivery') : videoTaskState(selectedSb) === 'pending' ? t('episode.vid.emptyGenerating') : t('episode.vid.emptyNoVideo') }}</div>
+                    <div class="video-player-empty-desc">{{ videoAwaitingDelivery(selectedSb) || canRecoverVideo(selectedSb?.id) ? t('episode.recovery.restoreHint') : videoTaskState(selectedSb) === 'pending' ? t('episode.vid.emptyGeneratingDesc') : t('episode.vid.emptyNoVideoDesc') }}</div>
+                  </div>
+                  <button
+                    v-if="videoTaskState(selectedSb) !== 'pending'"
+                    class="btn btn-primary btn-sm video-player-empty-action"
+                    @click="genVid(selectedSb)"
+                  >
+                    {{ videoTaskActionLabel(selectedSb) }}
+                  </button>
+                </div>
+              </div>
+              <div v-if="playerIsRemote" class="video-remote-source">
+                <span>{{ t('episode.recovery.remotePreview') }}</span>
+                <a :href="playerVideoUrl" target="_blank" rel="noopener noreferrer" referrerpolicy="no-referrer">{{ playerVideoUrl }}</a>
+                <span v-if="playerLoadFailed">{{ t('episode.recovery.remoteUnavailable') }}</span>
+                <button v-if="!previewVideoUrl && canRecoverVideo(selectedSb?.id)" class="btn btn-sm" @click="recoverVideo(selectedSb)">{{ t('episode.recovery.restoreDownload') }}</button>
+              </div>
+            </aside>
+
+            <div v-if="sbVideoHistory.length" class="video-player-history">
+              <div class="video-player-history-head">
+                <span>{{ t('episode.vid.history') }}</span>
+                <span class="video-player-history-count">{{ sbVideoHistory.length }}</span>
+              </div>
+              <div class="video-player-history-list">
+                <div
+                  v-for="h in sbVideoHistory"
+                  :key="h.id"
+                  :class="['video-history-item', { current: isCurrentVideo(h), viewing: !!previewVideoUrl && previewVideoUrl === taskVideoPath(h) }]"
+                  role="button"
+                  tabindex="0"
+                  @click="previewHistoryVideo(h)"
+                  @keydown.enter.prevent="previewHistoryVideo(h)"
+                >
+                  <video :src="videoSourceUrl(taskVideoPath(h))" :poster="posterOf(videoSourceUrl(taskVideoPath(h))) || undefined" preload="none" muted playsinline tabindex="-1" />
+                  <span class="video-history-time">{{ formatHistoryTime(taskCreatedAt(h)) }}</span>
+                  <span v-if="isCurrentVideo(h)" class="video-history-badge">{{ t('episode.vid.current') }}</span>
+                  <button v-else type="button" class="video-history-del" :title="t('episode.vid.deleteRecord')" @click.stop="removeHistoryVideo(h)">×</button>
+                </div>
+              </div>
+            </div>
+                <div class="video-inspector-body">
+                  <section class="video-inspector-section">
+                    <div class="video-inspector-prompt-head">
+                      <span class="video-inspector-label">{{ t('episode.inspector.boundRefs') }}</span>
+                      <span class="tag mono">{{ boundRefAssets.length }}</span>
+                    </div>
+                    <div v-if="boundRefAssets.length" class="video-bound-refs">
+                      <button
+                        v-for="asset in boundRefAssets"
+                        :key="asset.key"
+                        type="button"
+                        class="video-bound-ref"
+                        :disabled="!asset.ready"
+                        :title="`${asset.name} · ${asset.typeLabel}`"
+                        @click="asset.ready && openImageViewer(assetImageSrc({ imageUrl: asset.imageUrl }), `${asset.name} ${asset.typeLabel}`)"
+                      >
+                        <img v-if="asset.ready" :src="thumbOf(assetImageSrc({ imageUrl: asset.imageUrl }))" :alt="asset.name" loading="lazy" @error="thumbFallback($event, assetImageSrc({ imageUrl: asset.imageUrl }))" />
+                        <span v-else class="video-bound-ref-empty">{{ asset.kind === 'scene' ? t('episode.ref.shortScene') : asset.kind === 'prop' ? t('episode.ref.shortProp') : t('episode.ref.shortChar') }}</span>
+                        <small>{{ asset.name }}</small>
+                      </button>
+                    </div>
+                    <div v-else class="video-bound-refs-empty">{{ t('episode.inspector.noBoundRefs') }}</div>
+                  </section>
+                </div>
+
+                <!-- 分镜时长 + 生成操作常驻底部：不随检查器内容滚动 -->
+                <div class="video-inspector-footer">
+                  <p class="video-param-hint" style="margin-bottom:8px">仅设置当前镜头，其他镜头和批量默认不变。</p>
+                  <ModelSelect v-model="shotVideoModel" label="当前镜头模型" :options="videoModelOptions" :show-config="true" default-label="跟随顶部视频默认" />
+                  <p class="video-param-hint" style="margin:8px 0" data-testid="shot-actual-routing">{{ videoTaskRoutingLabel(latestVideoTask(selectedSb.id)) }}</p>
+                  <label v-if="supportsVideoGpu" class="video-param-row" style="margin-bottom:10px">
+                    <span class="video-param-name">本次生成显卡</span>
+                    <select v-model="videoGpu" class="input" style="width:200px" aria-label="本次生成显卡" :disabled="videoSubmittingIds.includes(selectedSb.id)">
+                      <option value="">跟随模型（{{ configGpuLabel }}）</option>
+                      <option value="auto">自动分配</option><option value="gpu1">GPU1 · ComfyUI 8189</option><option value="gpu2">GPU2 · ComfyUI 8188</option><option value="gpu3">GPU3 · ComfyUI 8191</option>
+                    </select>
+                  </label>
+                  <section class="video-inspector-section video-params-card">
+                    <div class="video-param-row">
+                      <span class="video-param-name">{{ t('episode.inspector.duration') }}</span>
+                      <span class="video-param-control">
+                        <input
+                          :value="selectedSb.duration || 10"
+                          type="number"
+                          min="2"
+                          max="30"
+                          class="input video-duration-input"
+                          @change="onVideoDurationChange"
+                        />
+                        <span class="video-param-unit">{{ t('episode.inspector.durationUnit') }}</span>
+                      </span>
+                    </div>
+                    <div class="video-param-hint">{{ t('episode.inspector.durationHint') }}</div>
+                  </section>
+                  <div class="video-inspector-effective">
+                    {{ t('episode.inspector.effective', { model: effectiveShotModelLabel || t('episode.vid.defaultModel'), res: episodeResolutionShort, dur: effectiveVideoDuration }) }}
+                  </div>
+                  <button
+                    class="btn btn-primary video-inspector-action"
+                    :disabled="videoSubmittingIds.includes(selectedSb.id) || (isPendingVideo(selectedSb.id) && !canReplaceVideo(selectedSb))"
+                    @click="genVid(selectedSb, { forceNew: true, replace: canReplaceVideo(selectedSb) })"
+                  >
+                    {{ videoSubmittingIds.includes(selectedSb.id) ? '正在处理，请稍候…' : canReplaceVideo(selectedSb) ? '取消并换卡重新生成' : isPendingVideo(selectedSb.id) ? '正在提交或保存，请等待…' : '按所选模型 / 显卡生成' }}
+                  </button>
+                </div>
+              </aside>
+              </div>
+              <div
+                class="video-col-divider is-left"
+                role="separator"
+                aria-orientation="vertical"
+                @pointerdown="startVideoColDrag('left', $event)"
+                @dblclick="videoLeftW = VIDEO_COL_DEFAULTS.left"
+              ></div>
+              <div
+                class="video-col-divider is-right"
+                role="separator"
+                aria-orientation="vertical"
+                @pointerdown="startVideoColDrag('right', $event)"
+                @dblclick="videoRightW = VIDEO_COL_DEFAULTS.right"
+              ></div>
+            </div>
+          </div>
+
+          <!-- Production Navigator -->
+        </template>
+      </div>
+
+      <div v-else-if="panel === 'hd'" class="content-panel">
+        <HdVideoStudio :episode-id="epId" @selected="refresh" />
+      </div>
+
+      <!-- ===== EXPORT PANEL ===== -->
+      <div v-else class="content-panel">
+        <div v-if="!sbs.length" class="step-empty" style="flex:1">
+          <div class="empty-visual">
+            <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+          </div>
+          <div class="empty-title">{{ t('episode.prod.notReady') }}</div>
+          <div class="empty-desc">{{ t('episode.export.notReadyDesc') }}</div>
+          <button class="btn btn-primary" @click="panel = 'script'">{{ t('episode.export.gotoScript') }}</button>
+        </div>
+        <div v-else class="export-split">
+          <div class="export-main">
+            <!-- 上方:成片列表 -->
+            <div class="export-section">
+              <div class="export-section-head">
+                <span class="export-section-title">{{ t('episode.export.filmList') }}</span>
+                <span class="dim" style="font-size:11px">{{ t('episode.export.countN', { n: exportMerges.length }) }}</span>
+                <button
+                  :class="['btn btn-sm ml-auto export-done-btn', { on: exportDone }]"
+                  :title="t('episode.export.markDoneTitle')"
+                  @click="toggleExportDone"
+                >
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>
+                  {{ exportDone ? t('episode.export.markedDone') : t('episode.export.markDone') }}
+                </button>
+                <button class="btn btn-sm" @click="loadExportMerges">
+                  <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polyline points="23 4 23 10 17 10"/><polyline points="1 20 1 14 7 14"/><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/></svg>
+                  {{ t('common.refresh') }}
+                </button>
+              </div>
+              <div v-if="exportMerges.length" class="export-merge-strip">
+                <div
+                  v-for="m in exportMerges"
+                  :key="m.id"
+                  :class="['merge-card', m.status === 'completed' && m.merged_url && 'playable']"
+                  :role="m.status === 'completed' && m.merged_url ? 'button' : undefined"
+                  :tabindex="m.status === 'completed' && m.merged_url ? 0 : undefined"
+                  @click="m.status === 'completed' && m.merged_url && (activeMerge = m)"
+                  @keydown.enter.prevent="m.status === 'completed' && m.merged_url && (activeMerge = m)"
+                >
+                  <div class="merge-card-thumb">
+                    <video
+                      v-if="m.status === 'completed' && m.merged_url"
+                      :src="'/' + m.merged_url"
+                      :poster="posterOf('/' + m.merged_url) || undefined"
+                      preload="none"
+                      muted
+                      playsinline
+                      tabindex="-1"
+                    />
+                    <div v-else :class="['merge-card-pending', m.status === 'failed' && 'is-failed']" :title="m.status === 'failed' ? m.error_msg : null">
+                      {{ m.status === 'failed' ? mapError(m.error_msg, { fallback: 'episode.export.mergeFailed' }) : t('episode.export.merging') }}
+                    </div>
+                    <span v-if="m.status === 'completed' && m.merged_url" class="merge-card-play">
+                      <svg width="22" height="22" viewBox="0 0 24 24" fill="currentColor" stroke="none"><polygon points="6 3 20 12 6 21 6 3"/></svg>
+                    </span>
+                  </div>
+                  <div class="merge-card-meta">
+                    <span class="mono">{{ formatHistoryTime(m.created_at) }}</span>
+                    <span v-if="m.duration">· {{ m.duration }}s</span>
+                    <a
+                      v-if="m.status === 'completed' && m.merged_url"
+                      :href="'/' + m.merged_url"
+                      download
+                      class="btn btn-sm"
+                      @click.stop
+                    >
+                      <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+                      {{ t('common.download') }}
+                    </a>
+                  </div>
+                </div>
+              </div>
+              <div v-else class="export-merge-empty">{{ t('episode.export.empty') }}</div>
+            </div>
+
+            <!-- 下方:镜头素材(可勾选) -->
+            <div class="export-section export-section-grow">
+              <div class="export-section-head">
+                <span class="export-section-title">{{ t('episode.export.shotAssets') }}</span>
+                <span class="dim" style="font-size:11px">{{ t('episode.export.shotStat', { done: shotVidCount, total: sbs.length, selected: exportSelectedReadyIds.length }) }}</span>
+                <div class="ml-auto flex gap-1">
+                  <button class="btn btn-sm" :disabled="!exportReadyIds.length" @click="toggleSelectAllExport">
+                    {{ exportSelectedReadyIds.length === exportReadyIds.length && exportReadyIds.length ? t('episode.export.clearSelection') : t('episode.export.selectAllReady') }}
+                  </button>
+                  <button
+                    class="btn btn-sm btn-primary"
+                    :disabled="!exportSelectedReadyIds.length"
+                    @click="doMerge(exportSelectedReadyIds)"
+                  >
+                    <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round"><rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/></svg>
+                    {{ t('episode.export.mergeSelected', { n: exportSelectedReadyIds.length }) }}
+                  </button>
+                </div>
+              </div>
+              <div class="export-grid">
+                <div
+                  v-for="(sb, i) in sbs"
+                  :key="sb.id"
+                  :class="['exp-card', { selected: isExportSelected(sb.id), playable: hasVid(sb) }]"
+                  :role="hasVid(sb) ? 'button' : undefined"
+                  :tabindex="hasVid(sb) ? 0 : undefined"
+                  @click="toggleExportSelect(sb)"
+                  @keydown.enter.prevent="toggleExportSelect(sb)"
+                >
+                  <div class="exp-thumb">
+                    <video
+                      v-if="hasVid(sb)"
+                      :src="'/' + getVideoUrl(sb)"
+                      :poster="posterOf('/' + getVideoUrl(sb)) || undefined"
+                      preload="none"
+                      muted
+                      playsinline
+                      tabindex="-1"
+                    />
+                    <div v-else class="exp-thumb-empty">
+                      <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
+                    </div>
+                    <span class="exp-thumb-index">#{{ String(i+1).padStart(2,'0') }}</span>
+                    <span v-if="sb.duration" class="exp-thumb-duration">{{ sb.duration }}s</span>
+                    <span
+                      v-if="hasVid(sb)"
+                      class="exp-play"
+                      :title="t('episode.export.previewShot')"
+                      @click.stop="previewShot = sb"
+                    >
+                      <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" stroke="none"><polygon points="6 3 20 12 6 21 6 3"/></svg>
+                    </span>
+                    <span v-if="hasVid(sb)" :class="['exp-check', isExportSelected(sb.id) && 'on']">
+                      <svg v-if="isExportSelected(sb.id)" width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3.2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>
+                    </span>
+                  </div>
+                  <div class="exp-row-line">
+                    <span class="truncate" style="flex:1;font-size:11px">{{ sb.description || sb.title || '—' }}</span>
+                    <span :class="['dot', hasVid(sb) && 'ok']" />
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <!-- ===== TASK DRAWER ===== -->
+      <div v-if="taskDrawer" class="task-drawer-overlay" @click.self="closeTaskDrawer">
+        <aside class="task-drawer" role="dialog" aria-modal="true" :aria-label="t('episode.tasks.title')">
+          <header class="task-drawer-head">
+            <div>
+              <div class="video-task-title">{{ t('episode.tasks.title') }}</div>
+              <div class="video-task-meta">{{ t('episode.tasks.meta', { n: genTaskRows.length }) }}</div>
+            </div>
+            <div class="task-drawer-head-actions">
+              <button class="btn btn-sm" @click="loadGenTasks">
+                <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><polyline points="23 4 23 10 17 10"/><polyline points="1 20 1 14 7 14"/><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/></svg>
+                {{ t('common.refresh') }}
+              </button>
+              <button class="btn btn-ghost btn-icon" @click="closeTaskDrawer"><X :size="14" /></button>
+            </div>
+          </header>
+          <div class="video-task-metrics task-drawer-metrics">
+            <span class="video-task-metric is-pending">{{ t('episode.vid.metricPending', { n: genTaskActiveCount }) }}</span>
+            <span class="video-task-metric is-done">{{ t('episode.vid.metricDone', { n: genTaskDoneCount }) }}</span>
+            <span class="video-task-metric is-failed">{{ t('episode.vid.metricFailed', { n: genTaskFailedCount }) }}</span>
+          </div>
+          <div v-if="!genTaskRows.length" class="step-empty task-drawer-empty">
+            <div class="empty-visual">
+              <ListTodo :size="32" />
+            </div>
+            <div class="empty-title">{{ t('episode.tasks.emptyTitle') }}</div>
+            <div class="empty-desc">{{ t('episode.tasks.emptyDesc') }}</div>
+          </div>
+          <div v-else class="video-task-table task-drawer-body">
+            <div
+              v-for="row in genTaskRows"
+              :key="row.key"
+              :class="['video-task-row', 'gen-task-row', 'is-' + genTaskStateClass(row.status)]"
+            >
+              <div class="video-task-preview">
+                <video
+                  v-if="row.previewUrl && (row.kind === 'video' || row.kind === 'merge')"
+                  :src="genTaskPreviewSrc(row.previewUrl)"
+                  :poster="posterOf(genTaskPreviewSrc(row.previewUrl)) || undefined"
+                  controls
+                  preload="none"
+                  playsinline
+                />
+                <img
+                  v-else-if="row.previewUrl"
+                  :src="thumbOf(genTaskPreviewSrc(row.previewUrl))"
+                  :alt="row.targetLabel"
+                  loading="lazy"
+                  @error="thumbFallback($event, genTaskPreviewSrc(row.previewUrl))"
+                  @click="openImageViewer(genTaskPreviewSrc(row.previewUrl), row.targetLabel)"
+                />
+                <div v-else class="video-task-empty">
+                  <Loader2 v-if="genTaskStateClass(row.status) === 'pending'" :size="18" class="animate-spin" />
+                  <svg v-else width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><circle cx="12" cy="12" r="10"/><line x1="15" y1="9" x2="9" y2="15"/><line x1="9" y1="9" x2="15" y2="15"/></svg>
+                </div>
+                <span class="video-task-index">{{ genTaskKindLabel(row.kind) }}</span>
+              </div>
+              <div class="video-task-main">
+                <div class="video-task-line">
+                  <strong class="video-task-name truncate">{{ row.targetLabel }}</strong>
+                </div>
+                <div class="video-task-meta-line">
+                  <span class="video-task-loc truncate">{{ row.provider }}{{ row.model ? ' · ' + row.model : '' }}</span>
+                  <template v-if="genTaskDuration(row)">
+                    <span class="video-task-sep">·</span>
+                    <span>{{ t('episode.tasks.duration', { dur: genTaskDuration(row) }) }}</span>
+                  </template>
+                  <span class="video-task-sep">·</span>
+                  <span>#{{ row.id }}</span>
+                </div>
+                <div v-if="row.errorMsg" class="video-task-error" :title="row.errorMsg">
+                  {{ mapError(row.errorMsg) }}
+                  <div v-if="row.kind !== 'merge'" class="flex gap-2">
+                    <button v-if="row.recoverable" class="btn btn-sm" @click.stop="recoverTask(row.id, row.storyboardId)">{{ t(row.kind === 'image' ? 'taskTracking.restoreImage' : 'episode.recovery.restore') }}</button>
+                    <button class="btn btn-sm" @click.stop="copyTaskDiagnostics(row.id)">{{ t('episode.recovery.diagnostics') }}</button>
+                  </div>
+                  <div v-if="row.kind === 'video' && videoModerationHint(row.errorMsg)" class="video-task-error-hint">{{ videoModerationHint(row.errorMsg) }}</div>
+                </div>
+              </div>
+              <span :class="['video-task-status', 'is-' + genTaskStateClass(row.status)]">
+                <span :class="['dot', genTaskStateClass(row.status) === 'done' && 'ok', genTaskStateClass(row.status) === 'pending' && 'pending']" />
+                {{ genTaskStatusLabel(row.status, row.stage, row.errorCode) }}
+              </span>
+            </div>
+          </div>
+        </aside>
+      </div>
+
+      <div v-if="assetDetail.open && assetDetail.item" class="overlay asset-detail-overlay" @click.self="closeAssetDetail">
+        <section
+          class="dialog asset-detail-dialog"
+          role="dialog"
+          aria-modal="true"
+          :aria-label="t('episode.asset.detailTitle', { type: assetTypeLabel(assetDetail.type) })"
+        >
+          <header class="dialog-head asset-detail-head">
+            <div class="asset-detail-title-block">
+              <span class="asset-detail-kicker">{{ assetTypeLabel(assetDetail.type) }}</span>
+              <h2 class="asset-detail-title">{{ assetDetailTitle(assetDetail) }}</h2>
+            </div>
+            <div class="asset-detail-head-actions">
+              <span class="tag" v-if="assetDetail.type === 'character'">{{ assetDetail.item.role || t('common.role') }}</span>
+              <span class="tag" v-else-if="assetDetail.type === 'prop'">{{ assetDetail.item.type || t('common.prop') }}</span>
+              <span class="tag" v-else>{{ assetDetail.item.time || t('episode.asset.noTime') }}</span>
+              <button class="btn btn-ghost btn-icon" @click="closeAssetDetail">
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+              </button>
+            </div>
+          </header>
+
+          <div class="dialog-body asset-detail-body">
+            <div class="asset-detail-shell">
+              <aside class="asset-detail-preview-panel">
+                <div class="asset-detail-section-title">
+                  <span>{{ t('episode.asset.visualPreview') }}</span>
+                  <span :class="['asset-detail-state', assetImageSrc(assetDetail.item) ? 'is-ready' : '']">
+                    {{ assetImageSrc(assetDetail.item) ? t('episode.asset.ready') : t('episode.asset.todo') }}
+                  </span>
+                </div>
+
+                <button
+                  type="button"
+                  class="asset-detail-media-frame"
+                  :disabled="!assetImageSrc(assetDetail.item)"
+                  @click.stop="openImageViewer(assetImageSrc(assetDetail.item), assetDetailImageTitle(assetDetail))"
+                >
+                  <img
+                    v-if="assetImageSrc(assetDetail.item)"
+                    :src="thumbOf(assetImageSrc(assetDetail.item))"
+                    class="previewable-image"
+                    @error="thumbFallback($event, assetImageSrc(assetDetail.item))"
+                  />
+                  <span v-else class="asset-detail-media-empty">
+                    <svg v-if="assetDetail.type === 'character'" width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"/><circle cx="12" cy="7" r="4"/></svg>
+                    <svg v-else-if="assetDetail.type === 'prop'" width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/></svg>
+                    <svg v-else width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"><path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z"/><circle cx="12" cy="10" r="3"/></svg>
+                  </span>
+                </button>
+
+                <div class="asset-detail-meta-row">
+                  <div class="asset-detail-meta-item">
+                    <span>{{ t('episode.asset.kindLabel') }}</span>
+                    <strong>{{ assetDetail.type === 'character' ? t('episode.asset.charPortrait') : assetDetail.type === 'prop' ? t('common.prop') : t('episode.asset.sceneImage') }}</strong>
+                  </div>
+                  <div class="asset-detail-meta-item">
+                    <span>{{ assetDetail.type === 'character' ? t('episode.asset.roleLabel') : assetDetail.type === 'prop' ? t('episode.asset.propTypeLabel') : t('episode.asset.timeLabel') }}</span>
+                    <strong>{{ assetDetail.type === 'character' ? (assetDetail.item.role || t('common.role')) : assetDetail.type === 'prop' ? (assetDetail.item.type || t('common.prop')) : (assetDetail.item.time || t('episode.asset.noTime')) }}</strong>
+                  </div>
+                </div>
+                <AssetReferenceImages :key="assetDetail.type + assetDetail.item.id" :kind="assetDetail.type" :asset="assetDetail.item" @updated="updateAssetReferences" @preview="openImageViewer" />
+                <CharacterVoice v-if="assetDetail.type === 'character'" :key="assetDetail.item.id" :character="assetDetail.item" @updated="updateCharacterVoice" />
+              </aside>
+
+              <section class="asset-detail-editor-panel">
+                <div class="asset-detail-section-title">
+                  <span>{{ t('episode.asset.editInfo') }}</span>
+                  <span class="dim">{{ assetDetail.type === 'character' ? t('episode.asset.editHintChar') : assetDetail.type === 'prop' ? t('episode.asset.editHintProp') : t('episode.asset.editHintScene') }}</span>
+                </div>
+
+                <div v-if="assetDetail.type === 'prop'" class="asset-detail-edit-grid asset-detail-edit-grid--prop">
+                  <label class="asset-detail-edit-field">
+                    <span>{{ t('episode.asset.appearanceOfObject') }}</span>
+                    <textarea
+                      v-model="assetDetailDraft.description"
+                      class="textarea asset-detail-textarea"
+                      rows="6"
+                      :placeholder="t('episode.asset.appearancePlaceholder')"
+                    />
+                  </label>
+                </div>
+
+                <div v-else :class="['asset-detail-edit-grid', `asset-detail-edit-grid--${assetDetail.type}`]">
+                  <label v-if="assetDetail.type === 'character'" class="asset-detail-edit-field">
+                    <span>{{ t('episode.asset.appearanceField') }}</span>
+                    <textarea
+                      v-model="assetDetailDraft.appearance"
+                      class="textarea asset-detail-textarea"
+                      rows="6"
+                      :placeholder="t('episode.asset.appearanceFieldPlaceholder')"
+                    />
+                  </label>
+                  <label v-if="assetDetail.type === 'character'" class="asset-detail-edit-field">
+                    <span>{{ t('episode.asset.stylingField') }}</span>
+                    <textarea
+                      v-model="assetDetailDraft.styling"
+                      class="textarea asset-detail-textarea"
+                      rows="6"
+                      :placeholder="t('episode.asset.stylingFieldPlaceholder')"
+                    />
+                  </label>
+                  <label v-if="assetDetail.type === 'scene'" class="asset-detail-edit-field">
+                    <span>{{ t('episode.asset.sceneDescField') }}</span>
+                    <textarea
+                      v-model="assetDetailDraft.prompt"
+                      class="textarea asset-detail-textarea"
+                      rows="5"
+                      :placeholder="t('episode.asset.sceneDescPlaceholder')"
+                    />
+                  </label>
+                  <label v-if="assetDetail.type === 'scene'" class="asset-detail-edit-field">
+                    <span>{{ t('episode.asset.sceneLightField') }}</span>
+                    <textarea
+                      v-model="assetDetailDraft.lighting"
+                      class="textarea asset-detail-textarea"
+                      rows="5"
+                      :placeholder="t('episode.asset.sceneLightPlaceholder')"
+                    />
+                  </label>
+                </div>
+
+              </section>
+            </div>
+
+            <section class="asset-detail-prompt-panel">
+              <div class="asset-detail-section-title">
+                <span>{{ assetDetail.type === 'character' ? t('episode.asset.finalPromptTurnaround') : assetDetail.type === 'scene' ? t('episode.asset.finalPromptFixed') : t('episode.asset.finalPromptWhiteBg') }}</span>
+                <div class="asset-detail-prompt-head-actions">
+                  <button
+                    class="btn btn-sm"
+                    :disabled="isGeneratingPrompt(assetDetail.type, assetDetail.item.id) || isAssetImagePending(assetDetail.type, assetDetail.item.id)"
+                    @click="genAssetFinalPrompt"
+                  >
+                    <Loader2 v-if="isGeneratingPrompt(assetDetail.type, assetDetail.item.id)" :size="11" class="animate-spin" />
+                    {{ isGeneratingPrompt(assetDetail.type, assetDetail.item.id) ? t('episode.asset.generating') : (assetFinalPrompt ? t('episode.asset.regenPrompt') : t('episode.asset.genPrompt')) }}
+                  </button>
+                  <span :class="['asset-detail-state', assetFinalPrompt && 'is-ready']">
+                    {{ assetFinalPrompt ? t('episode.asset.ready') : t('episode.asset.todo') }}
+                  </span>
+                  <button
+                    v-if="assetPromptDraft"
+                    class="btn btn-ghost btn-sm asset-detail-copy-btn"
+                    @click="copyAssetFinalPrompt"
+                  >
+                    <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+                    {{ t('common.copy') }}
+                  </button>
+                </div>
+              </div>
+              <textarea
+                :value="assetPromptDraft"
+                @input="onAssetPromptInput"
+                class="textarea asset-detail-prompt-textarea"
+                rows="5"
+                :placeholder="assetDetail.type === 'character'
+                  ? t('episode.asset.promptPlaceholderChar')
+                  : assetDetail.type === 'scene'
+                    ? t('episode.asset.promptPlaceholderScene')
+                    : t('episode.asset.promptPlaceholderProp')"
+              />
+              <p class="asset-detail-prompt-hint">
+                {{ assetDetail.type === 'character'
+                  ? t('episode.asset.promptHintChar')
+                  : assetDetail.type === 'scene'
+                    ? t('episode.asset.promptHintScene')
+                    : t('episode.asset.promptHintProp') }}
+              </p>
+            </section>
+          </div>
+
+          <footer class="dialog-foot asset-detail-foot">
+            <div class="asset-detail-secondary-actions">
+              <button class="btn btn-danger" @click="askDeleteAsset(assetDetail.type, assetDetail.item)">{{ t('common.delete') }}</button>
+              <button class="btn" @click="closeAssetDetail">{{ t('common.close') }}</button>
+            </div>
+            <div class="asset-detail-primary-actions">
+              <button
+                class="btn"
+                :disabled="isUploadingAsset(assetDetail.type, assetDetail.item.id)"
+                @click="uploadAssetImage(assetDetail.type, assetDetail.item.id)"
+              >
+                <Loader2 v-if="isUploadingAsset(assetDetail.type, assetDetail.item.id)" :size="11" class="animate-spin" />
+                <svg v-else width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
+                {{ t('episode.asset.uploadImage') }}
+              </button>
+              <button
+                v-if="assetDetail.type === 'character'"
+                class="btn"
+                :disabled="isPendingCharImage(assetDetail.item.id) || referencesSaving('character', assetDetail.item.id)"
+                @click="genCharImg(assetDetail.item.id)"
+              >
+                {{ assetImageSrc(assetDetail.item) ? t('episode.asset.regenPortrait') : (isPendingCharImage(assetDetail.item.id) ? t('episode.asset.generating') : t('episode.asset.genPortrait')) }}
+              </button>
+              <button
+                v-else-if="assetDetail.type === 'scene'"
+                class="btn"
+                :disabled="isPendingSceneImage(assetDetail.item.id) || referencesSaving('scene', assetDetail.item.id)"
+                @click="genSceneImg(assetDetail.item.id)"
+              >
+                {{ assetImageSrc(assetDetail.item) ? t('episode.asset.regenScene') : (isPendingSceneImage(assetDetail.item.id) ? t('episode.asset.generating') : t('episode.asset.genScene')) }}
+              </button>
+              <button
+                v-else-if="assetDetail.type === 'prop'"
+                class="btn"
+                :disabled="isPendingPropImage(assetDetail.item.id) || referencesSaving('prop', assetDetail.item.id)"
+                @click="genPropImg(assetDetail.item.id)"
+              >
+                {{ assetImageSrc(assetDetail.item) ? t('episode.asset.regenProp') : (isPendingPropImage(assetDetail.item.id) ? t('episode.asset.generating') : t('episode.asset.genProp')) }}
+              </button>
+              <button class="btn btn-primary" :disabled="savingAssetDetail" @click="saveAssetDetail">
+                <Loader2 v-if="savingAssetDetail" :size="12" class="animate-spin" />
+                {{ t('episode.asset.saveChanges') }}
+              </button>
+            </div>
+          </footer>
+        </section>
+      </div>
+
+      <div v-if="imageViewer.open && imageViewer.src" class="overlay image-viewer-overlay" @click.self="closeImageViewer">
+        <div class="dialog image-viewer-dialog">
+          <div class="image-viewer-head">
+            <div class="image-viewer-title">{{ imageViewer.title || t('episode.viewer.imagePreview') }}</div>
+            <button class="btn btn-ghost btn-icon" @click="closeImageViewer">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+            </button>
+          </div>
+          <div class="image-viewer-body">
+            <img :src="imageViewer.src" :alt="imageViewer.title || t('episode.viewer.imagePreview')" class="image-viewer-img" />
+          </div>
+        </div>
+      </div>
+
+      <div v-if="previewShot" class="overlay image-viewer-overlay" @click.self="previewShot = null">
+        <div class="dialog image-viewer-dialog merge-viewer-dialog">
+          <div class="image-viewer-head">
+            <div class="image-viewer-title">{{ t('episode.export.shotPreview', { n: shotNumberOf(previewShot) }) }}</div>
+            <span v-if="previewShot.duration" class="dim" style="font-size:11px">{{ previewShot.duration }}s</span>
+            <a :href="'/' + getVideoUrl(previewShot)" download class="btn btn-sm" style="margin-left:auto">
+              <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+              {{ t('common.download') }}
+            </a>
+            <button class="btn btn-ghost btn-icon" @click="previewShot = null">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+            </button>
+          </div>
+          <div class="merge-viewer-body">
+            <video
+              :key="previewShot.id"
+              :src="'/' + getVideoUrl(previewShot)"
+              controls
+              autoplay
+              playsinline
+              class="merge-viewer-video"
+            />
+          </div>
+        </div>
+      </div>
+
+      <div v-if="activeMerge" class="overlay image-viewer-overlay" @click.self="activeMerge = null">
+        <div class="dialog image-viewer-dialog merge-viewer-dialog">
+          <div class="image-viewer-head">
+            <div class="image-viewer-title">{{ t('episode.viewer.filmPreview') }}</div>
+            <span class="dim" style="font-size:11px">{{ formatHistoryTime(activeMerge.created_at) }}<template v-if="activeMerge.duration"> · {{ activeMerge.duration }}s</template></span>
+            <a :href="'/' + activeMerge.merged_url" download class="btn btn-sm" style="margin-left:auto">
+              <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+              {{ t('episode.viewer.downloadFilm') }}
+            </a>
+            <button class="btn btn-ghost btn-icon" @click="activeMerge = null">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+            </button>
+          </div>
+          <div class="merge-viewer-body">
+            <video
+              :key="activeMerge.id"
+              :src="'/' + activeMerge.merged_url"
+              controls
+              autoplay
+              playsinline
+              class="merge-viewer-video"
+            />
+          </div>
+        </div>
+      </div>
+
+      <div v-if="assetCreate.open" class="overlay" @click.self="assetCreate.open = false">
+        <div class="dialog asset-create-dialog">
+          <header class="dialog-head">
+            <h2 class="dialog-title">{{ t('episode.create.title', { type: assetCreateTypeLabel }) }}</h2>
+            <button class="btn btn-ghost btn-icon" @click="assetCreate.open = false">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+            </button>
+          </header>
+          <div class="dialog-body asset-create-body">
+            <template v-if="assetCreate.type === 'character'">
+              <label class="field"><span class="field-label">{{ t('episode.create.name') }}</span><input v-model="assetCreateDraft.name" class="input" :placeholder="t('episode.create.namePlaceholderChar')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.create.roleField') }}</span><input v-model="assetCreateDraft.role" class="input" :placeholder="t('episode.create.rolePlaceholder')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.asset.appearanceField') }}</span><textarea v-model="assetCreateDraft.appearance" class="textarea" rows="3" :placeholder="t('episode.create.appearancePlaceholder')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.asset.stylingField') }}</span><textarea v-model="assetCreateDraft.styling" class="textarea" rows="2" :placeholder="t('episode.create.stylingPlaceholder')" /></label>
+            </template>
+            <template v-else-if="assetCreate.type === 'scene'">
+              <label class="field"><span class="field-label">{{ t('episode.create.location') }}</span><input v-model="assetCreateDraft.location" class="input" :placeholder="t('episode.create.locationPlaceholder')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.create.time') }}</span><input v-model="assetCreateDraft.time" class="input" :placeholder="t('episode.create.timePlaceholder')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.asset.sceneDescField') }}</span><textarea v-model="assetCreateDraft.prompt" class="textarea" rows="3" :placeholder="t('episode.create.sceneDescPlaceholder')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.asset.sceneLightField') }}</span><input v-model="assetCreateDraft.lighting" class="input" :placeholder="t('episode.create.lightPlaceholder')" /></label>
+            </template>
+            <template v-else>
+              <label class="field"><span class="field-label">{{ t('episode.create.name') }}</span><input v-model="assetCreateDraft.name" class="input" :placeholder="t('episode.create.namePlaceholderProp')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.create.typeField') }}</span><input v-model="assetCreateDraft.type" class="input" :placeholder="t('episode.create.typePlaceholder')" /></label>
+              <label class="field"><span class="field-label">{{ t('episode.asset.appearanceOfObject') }}</span><textarea v-model="assetCreateDraft.description" class="textarea" rows="3" :placeholder="t('episode.create.appearanceOnlyPlaceholder')" /></label>
+            </template>
+          </div>
+          <footer class="dialog-foot">
+            <button class="btn" @click="assetCreate.open = false">{{ t('common.cancel') }}</button>
+            <button class="btn btn-primary" :disabled="assetCreate.saving" @click="saveAssetCreate">
+              <Loader2 v-if="assetCreate.saving" :size="12" class="animate-spin" />
+              {{ t('common.add') }}
+            </button>
+          </footer>
+        </div>
+      </div>
+
+      <div v-if="batchVideoConfirm.open" class="overlay" @click.self="batchVideoConfirm.open = false">
+        <div class="dialog batch-video-dialog">
+          <header class="dialog-head">
+            <h2 class="dialog-title">{{ t('episode.vid.confirmTitle') }}</h2>
+            <button class="btn btn-ghost btn-icon" @click="batchVideoConfirm.open = false">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+            </button>
+          </header>
+          <div class="dialog-body batch-video-body">
+            <div class="batch-video-row"><span>{{ t('episode.vid.confirmShots') }}</span><strong>{{ t('episode.vid.confirmShotsValue', { n: batchVideoConfirm.targets.length }) }}</strong></div>
+            <div class="batch-video-row"><span>{{ t('episode.vid.confirmTotal') }}</span><strong>{{ t('episode.vid.confirmApprox', { n: batchVideoTotalDuration }) }}</strong></div>
+            <div class="batch-video-row"><span>{{ t('episode.vid.confirmModel') }}</span><strong>{{ effectiveVideoModelLabel || t('episode.vid.defaultModel') }}</strong></div>
+            <div class="batch-video-row"><span>批量显卡</span><strong>{{ configGpu(selectedVideoConfig) === 'auto' ? '自动分配' : configGpu(selectedVideoConfig).toUpperCase() }}（跟随顶部默认模型）</strong></div>
+            <div class="batch-video-row"><span>{{ t('episode.vid.confirmResolution') }}</span><strong>{{ episodeResolutionLabel }}</strong></div>
+            <p class="batch-video-note">{{ t('episode.vid.confirmNote') }}</p>
+          </div>
+          <footer class="dialog-foot">
+            <button class="btn" @click="batchVideoConfirm.open = false">{{ t('common.cancel') }}</button>
+            <button class="btn btn-primary" @click="confirmBatchVideos">{{ t('episode.vid.confirmStart', { n: batchVideoConfirm.targets.length }) }}</button>
+          </footer>
+        </div>
+      </div>
+
+      <ConfirmDialog
+        :open="assetDelete.open"
+        :title="t('episode.delete.title', { type: assetDeleteTypeLabel })"
+        :message="t('episode.delete.message', { type: assetDeleteTypeLabel, name: assetDeleteName })"
+        :loading="assetDelete.loading"
+        @confirm="confirmDeleteAsset"
+        @cancel="assetDelete.open = false"
+      />
+    </main>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { toast } from 'vue-sonner'
+import { useI18n } from 'vue-i18n'
+import {
+  Users, FileText, FolderKanban, Clapperboard, Download, Loader2,
+  Plus, X, ListTodo, CircleHelp,
+} from 'lucide-vue-next'
+import { api, dramaAPI, episodeAPI, storyboardAPI, characterAPI, sceneAPI, propAPI, taskAPI, mergeAPI, aiConfigAPI, uploadAPI } from '~/composables/useApi'
+import { startTour, autoTour } from '~/composables/useTour'
+import { useAgent } from '~/composables/useAgent'
+import { resolveTextModelSelection } from '~/utils/text-model-selection'
+import { toastError, mapError, MODERATION_RE } from '~/composables/useToast'
+import LocaleSwitcher from '~/components/LocaleSwitcher.vue'
+
+definePageMeta({ layout: 'studio' })
+
+const { t } = useI18n()
+
+const route = useRoute()
+const dramaId = Number(route.params.id)
+const episodeNumber = Number(route.params.episodeNumber)
+
+const drama = ref(null), episode = ref(null), chars = ref([]), scenes = ref([]), propItems = ref([]), sbs = ref([]), mergeData = ref(null)
+// 工作台面板位置记忆（按剧集隔离）：仅页面刷新(reload)时恢复到上次所在步骤；
+// 从列表/详情页点击进入时始终默认「剧本」面板
+const PANEL_STORE_KEY = `huobao:workbench:panel:${dramaId}:${episodeNumber}`
+const isPageReload = (() => {
+  try { return performance.getEntriesByType('navigation')[0]?.type === 'reload' } catch { return false }
+})()
+const storedPanel = (() => {
+  if (!isPageReload) return null
+  try { return JSON.parse(localStorage.getItem(PANEL_STORE_KEY) || 'null') } catch { return null }
+})()
+// 首个 refresh 时若已恢复面板位置，跳过按内容自动重置 scriptStep
+let panelRestored = !!storedPanel
+const panel = ref(['production', 'export'].includes(storedPanel?.panel) ? storedPanel.panel : 'script')
+const { running: rn, runningType: rt, run: runAgent } = useAgent()
+
+const localRaw = ref(''), localScript = ref('')
+const rawContent = computed(() => episode.value?.content || '')
+const scriptContent = computed(() => episode.value?.script_content || episode.value?.scriptContent || '')
+const epId = computed(() => episode.value?.id || 0)
+const rawLen = computed(() => localRaw.value.replace(/\s/g, '').length || 0)
+const scriptLen = computed(() => localScript.value.replace(/\s/g, '').length || 0)
+
+// ===== 拼接导出:镜头选择 + 成片列表 =====
+const exportSelectedIds = ref([]) // 勾选的镜头 id
+const exportMerges = ref([])      // 成片(拼接记录)列表
+let exportSelTouched = false      // 用户手动操作过选择后,不再自动全选
+
+const exportReadyIds = computed(() => sbs.value.filter(s => hasVid(s)).map(s => s.id))
+const exportSelectedReadyIds = computed(() => exportSelectedIds.value.filter(id => exportReadyIds.value.includes(id)))
+
+watch(exportReadyIds, (ids) => {
+  if (exportSelTouched) {
+    exportSelectedIds.value = exportSelectedIds.value.filter(id => ids.includes(id))
+  } else {
+    exportSelectedIds.value = [...ids]
+  }
+})
+
+function isExportSelected(id) { return exportSelectedIds.value.includes(id) }
+function toggleExportSelect(sb) {
+  if (!hasVid(sb)) return
+  exportSelTouched = true
+  exportSelectedIds.value = isExportSelected(sb.id)
+    ? exportSelectedIds.value.filter(x => x !== sb.id)
+    : [...exportSelectedIds.value, sb.id]
+}
+function toggleSelectAllExport() {
+  exportSelTouched = true
+  exportSelectedIds.value = exportSelectedReadyIds.value.length === exportReadyIds.value.length ? [] : [...exportReadyIds.value]
+}
+
+async function loadExportMerges() {
+  if (!epId.value) return
+  try { exportMerges.value = await mergeAPI.list(epId.value) || [] } catch { /* 静默 */ }
+}
+
+const scriptStep = ref(storedPanel ? (storedPanel.scriptStep === 0 ? 0 : 1) : 0)
+// 旧版本地存储的 'storyboard' 子步骤已并入 'videos'（视频制作）
+const storedProdTab = storedPanel?.prodTab === 'storyboard' ? 'videos' : storedPanel?.prodTab
+const prodTab = ref(['assets', 'videos'].includes(storedProdTab) ? storedProdTab : 'assets')
+// 面板位置变化即持久化
+watch([panel, scriptStep, prodTab], ([p, s, pt]) => {
+  try { localStorage.setItem(PANEL_STORE_KEY, JSON.stringify({ panel: p, scriptStep: s, prodTab: pt })) } catch { /* 静默 */ }
+})
+// ===== 视频制作三栏宽度：拖拽调节 + 全局持久化（双击分隔条恢复默认） =====
+const VIDEO_COL_STORE_KEY = 'huobao:workbench:video-cols'
+const VIDEO_COL_DEFAULTS = { left: 236, right: 340 }
+const VIDEO_COL_LIMITS = { left: [180, 420], right: [260, 560] }
+const storedVideoCols = (() => {
+  try {
+    const c = JSON.parse(localStorage.getItem(VIDEO_COL_STORE_KEY) || 'null')
+    return c && typeof c === 'object' ? c : null
+  } catch { return null }
+})()
+const clampVideoCol = (which, w) => Math.min(VIDEO_COL_LIMITS[which][1], Math.max(VIDEO_COL_LIMITS[which][0], Math.round(w)))
+const videoLeftW = ref(clampVideoCol('left', Number(storedVideoCols?.left) || VIDEO_COL_DEFAULTS.left))
+const videoRightW = ref(clampVideoCol('right', Number(storedVideoCols?.right) || VIDEO_COL_DEFAULTS.right))
+watch([videoLeftW, videoRightW], ([l, r]) => {
+  try { localStorage.setItem(VIDEO_COL_STORE_KEY, JSON.stringify({ left: l, right: r })) } catch { /* 静默 */ }
+})
+function startVideoColDrag(which, e) {
+  if (e.button !== 0) return
+  e.preventDefault()
+  const target = e.currentTarget
+  const startX = e.clientX
+  const startW = which === 'left' ? videoLeftW.value : videoRightW.value
+  const onMove = (ev) => {
+    const dx = ev.clientX - startX
+    const w = clampVideoCol(which, which === 'left' ? startW + dx : startW - dx)
+    if (which === 'left') videoLeftW.value = w
+    else videoRightW.value = w
+  }
+  const onUp = () => {
+    target.removeEventListener('pointermove', onMove)
+    target.removeEventListener('pointerup', onUp)
+    target.removeEventListener('pointercancel', onUp)
+    document.body.classList.remove('is-video-col-dragging')
+  }
+  document.body.classList.add('is-video-col-dragging')
+  target.addEventListener('pointermove', onMove)
+  target.addEventListener('pointerup', onUp)
+  target.addEventListener('pointercancel', onUp)
+  target.setPointerCapture?.(e.pointerId)
+}
+const activeExtractTab = ref('characters')
+const prodTabIdx = computed({
+  get: () => prodTabDefs.value.findIndex(d => d.id === prodTab.value),
+  set: (v) => { prodTab.value = prodTabDefs.value[v]?.id || 'assets' },
+})
+const imageConfigs = ref([])
+const videoConfigs = ref([])
+const textConfigs = ref([])
+// 生成时可选模型：空串 = 跟随配置默认（models[0]）；选择持久化到 localStorage，刷新页面后保留
+const MODEL_STORE_KEYS = { chat: 'huobao:model:chat', image: 'huobao:model:image', video: 'huobao:model:video' }
+function readStoredModel(key, legacyKey = '') {
+  try { return localStorage.getItem(key) || (legacyKey && localStorage.getItem(legacyKey)) || '' } catch { return '' }
+}
+// 顶栏文本模型：适用于所有 Chat Agent 调用（改写/提取/拆镜/视频提示词/最终提示词），空串 = 跟随配置默认
+const chatModel = ref(readStoredModel(MODEL_STORE_KEYS.chat, 'huobao:model:rewrite'))
+const imageModel = ref(readStoredModel(MODEL_STORE_KEYS.image))
+const videoModel = ref(readStoredModel(MODEL_STORE_KEYS.video))
+function persistModel(modelRef, key) {
+  watch(modelRef, v => {
+    try { v ? localStorage.setItem(key, v) : localStorage.removeItem(key) } catch {}
+  })
+}
+persistModel(chatModel, MODEL_STORE_KEYS.chat)
+persistModel(imageModel, MODEL_STORE_KEYS.image)
+persistModel(videoModel, MODEL_STORE_KEYS.video)
+// 左侧菜单栏收起/展开：收起为窄图标栏给内容区让位，持久化到 localStorage
+const SIDEBAR_COLLAPSED_KEY = 'huobao:sidebar-collapsed'
+const sidebarCollapsed = ref((() => {
+  try { return localStorage.getItem(SIDEBAR_COLLAPSED_KEY) === '1' } catch { return false }
+})())
+function toggleSidebar() {
+  sidebarCollapsed.value = !sidebarCollapsed.value
+  try {
+    sidebarCollapsed.value
+      ? localStorage.setItem(SIDEBAR_COLLAPSED_KEY, '1')
+      : localStorage.removeItem(SIDEBAR_COLLAPSED_KEY)
+  } catch { /* 静默 */ }
+}
+/** 默认项也传出界面显示的模型和所属配置，覆盖 Agent 文件中的其他默认模型。 */
+function chatModelOverride() { return resolveTextModelSelection(textModelOptions.value, chatModel.value).model }
+function chatConfigId() { return resolveTextModelSelection(textModelOptions.value, chatModel.value).configId }
+const pendingCharImageIds = ref([])
+const pendingSceneImageIds = ref([])
+const pendingPropImageIds = ref([])
+const pendingVideoIds = ref([])
+const failedVideoMessages = ref({})
+// 任务列表面板：顶栏按钮触发的右侧抽屉,按集聚合 sys_task + video_merges
+const genTasks = ref([])
+const genMerges = ref([])
+const taskDrawer = ref(false)
+let genTasksTimer = null
+
+function openTaskDrawer() {
+  taskDrawer.value = true
+  loadGenTasks()
+}
+function closeTaskDrawer() {
+  taskDrawer.value = false
+}
+const imageViewer = ref({ open: false, src: '', title: '' })
+const activeMerge = ref(null) // 成片大预览弹窗中正在播放的拼接记录
+const previewShot = ref(null) // 导出页镜头素材预览弹窗中正在播放的分镜
+function shotNumberOf(sb) {
+  const i = sbs.value.findIndex(s => s.id === sb?.id)
+  return i >= 0 ? i + 1 : 0
+}
+// 导出步骤完成 = 用户手动标记（episodes.status = 'completed'），不再按最新拼接记录推算
+const exportDone = computed(() => episode.value?.status === 'completed')
+async function toggleExportDone() {
+  if (!epId.value) return
+  const status = exportDone.value ? 'active' : 'completed'
+  try {
+    await episodeAPI.update(epId.value, { status })
+    if (episode.value) episode.value.status = status
+    toast.success(status === 'completed' ? t('episode.export.markedDoneToast') : t('episode.export.unmarkDoneToast'))
+  } catch (e) {
+    toastError(e)
+  }
+}
+const assetDetail = ref({ open: false, type: '', item: null })
+const referenceBusyIds = useState('asset-reference-busy', () => [])
+function referencesSaving(type, id) { return referenceBusyIds.value.includes(`${type}:${id}`) }
+function updateAssetReferences(type, id, references) {
+  const patch = { reference_images: references, referenceImages: references }
+  const items = type === 'character' ? chars.value : type === 'scene' ? scenes.value : propItems.value
+  const item = items.find(value => value.id === id)
+  if (item) Object.assign(item, patch)
+  if (assetDetail.value.type === type && assetDetail.value.item?.id === id) Object.assign(assetDetail.value.item, patch)
+}
+
+function updateCharacterVoice(id, voice) {
+  const patch = { ...voice, voiceAudioUrl: voice.voice_audio_url, voiceAudioName: voice.voice_audio_name }
+  const character = chars.value.find(item => item.id === id)
+  if (character) Object.assign(character, patch)
+  if (assetDetail.value.type === 'character' && assetDetail.value.item?.id === id) Object.assign(assetDetail.value.item, patch)
+}
+const assetDetailDraft = ref({ appearance: '', styling: '', prompt: '', lighting: '', description: '' })
+// 最终提示词手动编辑：dirty 时才随保存提交，避免无修改保存误清空 Agent 生成的提示词
+const assetPromptDraft = ref('')
+const assetPromptDirty = ref(false)
+const savingAssetDetail = ref(false)
+
+function isPendingCharImage(id) {
+  return pendingCharImageIds.value.includes(id)
+}
+
+function openImageViewer(src, title = '') {
+  if (!src) return
+  imageViewer.value = { open: true, src, title }
+}
+
+function closeImageViewer() {
+  imageViewer.value = { open: false, src: '', title: '' }
+}
+
+function openAssetDetail(type, item) {
+  if (!item) return
+  assetDetail.value = { open: true, type, item }
+  assetDetailDraft.value = {
+    appearance: item.appearance || '',
+    styling: item.styling || '',
+    prompt: item.prompt || (type === 'prop' ? '' : item.description) || '',
+    lighting: item.lighting || '',
+    description: item.description || '',
+  }
+  assetPromptDraft.value = item.final_prompt || item.finalPrompt || ''
+  assetPromptDirty.value = false
+}
+
+function closeAssetDetail() {
+  assetDetail.value = { open: false, type: '', item: null }
+  assetDetailDraft.value = { appearance: '', styling: '', prompt: '', lighting: '', description: '' }
+  assetPromptDraft.value = ''
+  assetPromptDirty.value = false
+}
+
+// ─── 手动新增资产 ────────────────────────────────────────────
+// 类型短显示名渲染时求值（不模块级固化），逻辑判断一律用 kind code
+const assetKindLabelMap = computed(() => ({
+  character: t('common.role'),
+  scene: t('common.scene'),
+  prop: t('common.prop'),
+}))
+function assetKindLabel(type) {
+  return assetKindLabelMap.value[type] || t('episode.asset.fallbackType')
+}
+const assetCreate = ref({ open: false, type: 'character', saving: false })
+const assetCreateDraft = ref({})
+const assetCreateTypeLabel = computed(() => assetKindLabel(assetCreate.value.type))
+
+function openAssetCreate(type) {
+  assetCreateDraft.value = { name: '', role: '', appearance: '', styling: '', location: '', time: '', prompt: '', lighting: '', type: '', description: '' }
+  assetCreate.value = { open: true, type, saving: false }
+}
+
+async function saveAssetCreate() {
+  const d = assetCreateDraft.value
+  const type = assetCreate.value.type
+  if (assetCreate.value.saving) return
+  if (type === 'scene' ? !d.location?.trim() : !d.name?.trim()) {
+    toast.warning(type === 'scene' ? t('episode.create.locationRequired') : t('episode.create.nameRequired'))
+    return
+  }
+  assetCreate.value.saving = true
+  try {
+    const base = { drama_id: dramaId, episode_id: epId.value }
+    if (type === 'character') await characterAPI.create({ ...base, name: d.name, role: d.role, appearance: d.appearance, styling: d.styling })
+    else if (type === 'scene') await sceneAPI.create({ ...base, location: d.location, time: d.time, prompt: d.prompt, lighting: d.lighting })
+    else await propAPI.create({ ...base, name: d.name, type: d.type, description: d.description })
+    toast.success(t('episode.create.created', { type: assetCreateTypeLabel.value }))
+    assetCreate.value.open = false
+    await refresh()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    assetCreate.value.saving = false
+  }
+}
+
+// ─── 删除资产 ────────────────────────────────────────────────
+const assetDelete = ref({ open: false, type: '', item: null, loading: false })
+const assetDeleteTypeLabel = computed(() => assetKindLabel(assetDelete.value.type))
+const assetDeleteName = computed(() => assetDelete.value.item?.name || assetDelete.value.item?.location || '')
+
+function askDeleteAsset(type, item) {
+  assetDelete.value = { open: true, type, item, loading: false }
+}
+
+async function confirmDeleteAsset() {
+  const { type, item } = assetDelete.value
+  if (!item || assetDelete.value.loading) return
+  assetDelete.value.loading = true
+  try {
+    if (type === 'character') await characterAPI.del(item.id)
+    else if (type === 'scene') await sceneAPI.del(item.id)
+    else await propAPI.del(item.id)
+    toast.success(t('episode.delete.deleted', { type: assetDeleteTypeLabel.value }))
+    assetDelete.value.open = false
+    if (assetDetail.value.open && assetDetail.value.type === type && assetDetail.value.item?.id === item.id) closeAssetDetail()
+    await refresh()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    assetDelete.value.loading = false
+  }
+}
+
+function onAssetPromptInput(event) {
+  assetPromptDraft.value = event.target.value
+  assetPromptDirty.value = true
+}
+
+const assetFinalPrompt = computed(() => {
+  const item = assetDetail.value?.item
+  return item?.final_prompt || item?.finalPrompt || ''
+})
+
+/** 把生成好的最终提示词同步到列表项与弹窗项 */
+function applyFinalPrompt(type, id, fp) {
+  const patch = { final_prompt: fp, finalPrompt: fp }
+  const list = type === 'character' ? chars.value : type === 'scene' ? scenes.value : propItems.value
+  const target = list.find(x => x.id === id)
+  if (target) Object.assign(target, patch)
+  if (assetDetail.value.open && assetDetail.value.type === type && assetDetail.value.item?.id === id) {
+    Object.assign(assetDetail.value.item, patch)
+  }
+}
+
+const generatingPromptKeys = ref([])
+
+function isGeneratingPrompt(type, id) {
+  return generatingPromptKeys.value.includes(`${type}:${id}`)
+}
+
+/** 该资产图片是否在外层「生成」流程中（含提示词阶段与生图阶段） */
+function isAssetImagePending(type, id) {
+  return type === 'character' ? isPendingCharImage(id) : type === 'scene' ? isPendingSceneImage(id) : isPendingPropImage(id)
+}
+
+/**
+ * 生成最终提示词（弹窗按钮与外层两段式生图共用同一 key 状态，避免重复触发）
+ * force=true 时忽略已有提示词强制重新生成
+ * 返回最终提示词；生成失败由接口抛错，Agent 返回空时返回 ''
+ */
+async function ensureAssetPrompt(type, id, force = false) {
+  const key = `${type}:${id}`
+  if (generatingPromptKeys.value.includes(key)) return ''
+  generatingPromptKeys.value.push(key)
+  try {
+    const res = type === 'character'
+      ? await characterAPI.generatePrompt(id, epId.value, force, chatModelOverride(), chatConfigId())
+      : type === 'scene'
+        ? await sceneAPI.generatePrompt(id, epId.value, force, chatModelOverride(), chatConfigId())
+        : await propAPI.generatePrompt(id, epId.value, force, chatModelOverride(), chatConfigId())
+    const fp = res?.final_prompt || res?.finalPrompt || ''
+    if (fp) applyFinalPrompt(type, id, fp)
+    return fp
+  } finally {
+    generatingPromptKeys.value = generatingPromptKeys.value.filter(k => k !== key)
+  }
+}
+
+/** 弹窗内生成最终提示词（不生图）；已有最终提示词时重新生成（force） */
+async function genAssetFinalPrompt() {
+  const detail = assetDetail.value
+  if (!detail.open || !detail.item?.id) return
+  const force = !!assetFinalPrompt.value
+  try {
+    const fp = await ensureAssetPrompt(detail.type, detail.item.id, force)
+    if (!fp) throw new Error(t('episode.asset.promptGenFailedRetry'))
+    assetPromptDraft.value = fp
+    assetPromptDirty.value = false
+    toast.success(force ? t('episode.asset.promptRegenerated') : t('episode.asset.promptGenerated'))
+  } catch (e) {
+    toastError(e, { fallback: 'episode.asset.promptGenFailed' })
+  }
+}
+
+async function copyAssetFinalPrompt() {
+  const text = assetPromptDraft.value || assetFinalPrompt.value
+  if (!text) return
+  try {
+    await navigator.clipboard.writeText(text)
+    toast.success(t('episode.asset.promptCopied'))
+  } catch {
+    toast.error(t('episode.asset.copyFailed'))
+  }
+}
+
+async function saveAssetDetail() {
+  const detail = assetDetail.value
+  if (!detail.open || !detail.item?.id) return
+  const item = detail.item
+  // 只提交真正修改过的字段：无修改保存不应触发后端的提示词失效置空
+  const payload = {}
+  let infoChanged = false
+  if (detail.type === 'character') {
+    if (assetDetailDraft.value.appearance !== (item.appearance || '')) payload.appearance = assetDetailDraft.value.appearance
+    if (assetDetailDraft.value.styling !== (item.styling || '')) payload.styling = assetDetailDraft.value.styling
+  } else if (detail.type === 'scene') {
+    if (assetDetailDraft.value.prompt !== (item.prompt || '')) payload.prompt = assetDetailDraft.value.prompt
+    if (assetDetailDraft.value.lighting !== (item.lighting || '')) payload.lighting = assetDetailDraft.value.lighting
+  } else {
+    if (assetDetailDraft.value.description !== (item.description || '')) payload.description = assetDetailDraft.value.description
+  }
+  infoChanged = Object.keys(payload).length > 0
+  // 手动编辑过最终提示词才提交；空串视为清空
+  if (assetPromptDirty.value) payload.final_prompt = assetPromptDraft.value.trim() || ''
+  if (!infoChanged && !assetPromptDirty.value) {
+    toast.info(t('episode.asset.noChanges'))
+    return
+  }
+  savingAssetDetail.value = true
+  try {
+    if (detail.type === 'character') await characterAPI.update(item.id, payload)
+    else if (detail.type === 'scene') await sceneAPI.update(item.id, payload)
+    else await propAPI.update(item.id, payload)
+    // 本地同步：手动编辑的提示词以草稿为准；仅信息字段变更时提示词已被后端置空
+    const { final_prompt, ...infoPatch } = payload
+    const promptValue = assetPromptDirty.value ? (payload.final_prompt || null) : (infoChanged ? null : (item.final_prompt || item.finalPrompt || null))
+    Object.assign(item, infoPatch, { final_prompt: promptValue, finalPrompt: promptValue })
+    const list = detail.type === 'character' ? chars.value : detail.type === 'scene' ? scenes.value : propItems.value
+    const target = list.find(x => x.id === item.id)
+    if (target) Object.assign(target, infoPatch, { final_prompt: promptValue, finalPrompt: promptValue })
+    if (assetPromptDirty.value) assetPromptDraft.value = payload.final_prompt || ''
+    assetPromptDirty.value = false
+    toast.success(t('episode.asset.saved'))
+  } catch (e) {
+    toastError(e, { fallback: 'episode.asset.saveFailed' })
+  } finally {
+    savingAssetDetail.value = false
+  }
+}
+
+function assetImageSrc(item) {
+  const raw = item?.image_url || item?.imageUrl || ''
+  if (!raw) return ''
+  if (/^https?:\/\//i.test(raw) || raw.startsWith('/')) return raw
+  return `/${raw}`
+}
+
+function assetDetailTitle(detail) {
+  if (!detail?.item) return ''
+  if (detail.type === 'character') return detail.item.name || t('episode.asset.unnamedChar')
+  if (detail.type === 'prop') return detail.item.name || t('episode.asset.unnamedProp')
+  return detail.item.location || t('episode.asset.unnamedScene')
+}
+
+/** 资产详情弹窗 kicker / aria-label 用长标签 */
+function assetTypeLabel(type) {
+  return { character: t('episode.asset.typeChar'), scene: t('episode.asset.typeScene'), prop: t('episode.asset.typeProp') }[type] || t('episode.asset.fallbackType')
+}
+
+/** 资产详情预览图标题（角色形象/场景图/道具图） */
+function assetDetailImageTitle(detail) {
+  if (!detail?.item) return ''
+  const kindLabel = detail.type === 'character' ? t('episode.asset.charPortrait') : detail.type === 'scene' ? t('episode.asset.sceneImage') : t('common.prop')
+  return `${assetDetailTitle(detail)} ${kindLabel}`
+}
+
+function characterAppearanceValue(char) {
+  return char?.appearance || t('episode.asset.appearanceTodo')
+}
+
+function characterStylingValue(char) {
+  return char?.styling || t('episode.asset.stylingTodo')
+}
+
+function characterVisualSummary(char) {
+  return `${t('episode.asset.appearance')}${characterAppearanceValue(char)} · ${t('episode.asset.styling')}${characterStylingValue(char)}`
+}
+
+function sceneDescriptionValue(scene) {
+  return scene?.prompt || scene?.description || t('episode.asset.sceneDescTodo')
+}
+
+function sceneLightingValue(scene) {
+  return scene?.lighting || t('episode.asset.sceneLightTodo')
+}
+
+function handleImageViewerKeydown(event) {
+  if (event.key !== 'Escape') return
+  if (imageViewer.value.open) closeImageViewer()
+  else if (assetDetail.value.open) closeAssetDetail()
+  else if (taskDrawer.value) closeTaskDrawer()
+}
+
+onMounted(() => {
+  window.addEventListener('keydown', handleImageViewerKeydown)
+})
+
+onBeforeUnmount(() => {
+  window.removeEventListener('keydown', handleImageViewerKeydown)
+  stopGenTasksPolling()
+})
+
+function isPendingSceneImage(id) {
+  return pendingSceneImageIds.value.includes(id)
+}
+
+function isPendingVideo(id) {
+  return pendingVideoIds.value.includes(id)
+}
+
+function videoFailMessage(id) {
+  return failedVideoMessages.value[id] || ''
+}
+
+// 内容审核类失败（真人/敏感内容，如火山的 OutputVideoSensitiveContentDetected）：
+// 各厂商审核尺度不同，给出切换模型重试的引导
+function videoModerationHint(msg) {
+  return MODERATION_RE.test(String(msg || '')) ? t('episode.vid.moderationHint') : ''
+}
+
+function videoTaskState(sb) {
+  if (isPendingVideo(sb?.id)) return 'pending'
+  if (hasVid(sb)) return 'done'
+  if (videoFailMessage(sb?.id)) return 'failed'
+  return 'ready'
+}
+
+function latestVideoTask(id) {
+  return genTasks.value.filter(task => task.type === 'video' && task.storyboard_id === id)
+    .sort((a, b) => b.id - a.id)[0]
+}
+const recoverableVideoCount = computed(() => sbs.value.filter(sb => canRecoverVideo(sb.id)).length)
+function canRecoverVideo(id) {
+  const task = latestVideoTask(id)
+  return !!task && task.status === 'failed' && !['generation_failed', 'user_cancelled'].includes(task.error_code)
+    && !!(task.task_id || task.result_url)
+}
+function videoAwaitingDelivery(sb) {
+  const task = latestVideoTask(sb?.id)
+  return !!task && (!!task.result_url || task.error_code === 'delivery_failed' || task.stage === 'transferring')
+}
+function videoErrorLabel(id, error) {
+  const task = latestVideoTask(id)
+  if (task?.error_code === 'delivery_failed' || (task?.result_url && task?.status === 'failed')) return t('episode.recovery.downloadFailed')
+  if (task?.error_code === 'submission_unknown') return t('episode.recovery.unknownSubmission')
+  return mapError(error)
+}
+async function copyVideoDiagnostics(id) {
+  const task = latestVideoTask(id)
+  if (task) await copyTaskDiagnostics(task.id)
+}
+async function copyTaskDiagnostics(taskId) {
+  try {
+    const info = await taskAPI.diagnostics(taskId)
+    await navigator.clipboard.writeText(JSON.stringify(info, null, 2))
+    toast.success(t('episode.recovery.copied'))
+  } catch (error) { toastError(error) }
+}
+async function recoverVideo(sb) {
+  const task = latestVideoTask(sb.id)
+  if (!task) return
+  return recoverTask(task.id, sb.id)
+}
+async function recoverTask(taskId, storyboardId) {
+  if (storyboardId && isPendingVideo(storyboardId)) return
+  if (storyboardId) pendingVideoIds.value.push(storyboardId)
+  try {
+    await taskAPI.recover(taskId)
+    delete failedVideoMessages.value[storyboardId]
+    await refresh()
+    if (storyboardId) pollVideoGeneration(taskId, storyboardId)
+  } catch (error) {
+    pendingVideoIds.value = pendingVideoIds.value.filter(id => id !== storyboardId)
+    toastError(error)
+  }
+}
+
+function videoTaskStatusLabel(sb) {
+  const state = videoTaskState(sb)
+  if (state === 'done') return t('episode.status.done')
+  if (state === 'pending') {
+    const stage = latestVideoTask(sb.id)?.stage
+    return stage === 'downloading' ? t('episode.recovery.downloading')
+      : stage === 'transferring' ? t('episode.recovery.transferring') : trackedStageLabel(stage) || t('episode.status.generating')
+  }
+  if (latestVideoTask(sb?.id)?.error_code === 'upstream_missing') return t('taskTracking.missing')
+  if (state === 'failed' && latestVideoTask(sb?.id)?.result_url) return t('episode.recovery.localDownloadFailed')
+  if (state === 'failed') return t('episode.status.failed')
+  return t('episode.status.todo')
+}
+
+function videoTaskActionLabel(sb) {
+  if (canRecoverVideo(sb?.id)) return t('episode.recovery.restore')
+  if (latestVideoTask(sb?.id)?.status === 'failed') return t('episode.recovery.newGeneration')
+  const state = videoTaskState(sb)
+  if (state === 'done') return t('episode.asset.regen')
+  if (state === 'pending') return t('episode.asset.generating')
+  return t('episode.asset.generate')
+}
+
+const allVideoTaskRows = computed(() => sbs.value.map((sb, index) => {
+  const duration = Number(sb.duration || 5)
+  const referenceCount = getShotReferenceImages(sb).length
+  const sceneName = getSceneName(sb)
+  return {
+    id: sb.id,
+    index,
+    storyboard: sb,
+    title: sb.description || t('episode.vid.shotN', { n: String(index + 1).padStart(2, '0') }),
+    meta: sceneName,
+    duration: Number.isFinite(duration) ? duration : 5,
+    referenceCount,
+    state: videoTaskState(sb),
+    // 只有当前处于失败状态才显示错误,避免重试成功的分镜残留历史错误信息
+    error: videoTaskState(sb) === 'failed' ? videoFailMessage(sb.id) : '',
+  }
+}))
+// 列表筛选：点击顶部统计徽章过滤（再点一次取消）
+const videoListFilter = ref('')
+const videoTaskRows = computed(() => videoListFilter.value
+  ? allVideoTaskRows.value.filter(task => task.state === videoListFilter.value)
+  : allVideoTaskRows.value)
+const videoTaskDoneCount = computed(() => allVideoTaskRows.value.filter(task => task.state === 'done').length)
+const videoTaskFailedCount = computed(() => allVideoTaskRows.value.filter(task => task.state === 'failed').length)
+function toggleVideoFilter(state) {
+  videoListFilter.value = videoListFilter.value === state ? '' : state
+}
+
+// ===== 批量视频：选择模式 + 生成前确认（视频生成成本高，避免误触全量触发） =====
+const videoSelectMode = ref(false)
+const selectedVideoSbIds = ref([])
+const batchVideoConfirm = ref({ open: false, targets: [] })
+
+function isVideoSbSelected(id) { return selectedVideoSbIds.value.includes(id) }
+function toggleVideoSbSelect(id) {
+  selectedVideoSbIds.value = isVideoSbSelected(id)
+    ? selectedVideoSbIds.value.filter(item => item !== id)
+    : [...selectedVideoSbIds.value, id]
+}
+function toggleVideoSelectMode() {
+  videoSelectMode.value = !videoSelectMode.value
+  if (!videoSelectMode.value) selectedVideoSbIds.value = []
+}
+function onVideoTaskRowClick(sb) {
+  if (videoSelectMode.value) toggleVideoSbSelect(sb.id)
+  else selectedSb.value = sb
+}
+
+// 旁白角色识别：按内容语言的关键词匹配（提取产物中的旁白角色不参与画面生成）
+function isNarratorCharacter(char) {
+  const text = `${char?.name || ''} ${char?.role || ''}`.toLowerCase()
+  return ['旁白', '画外音', 'narrator', 'ナレーター', 'ナレーション', '내레이션', '해설'].some(k => text.includes(k))
+}
+
+const visualChars = computed(() => chars.value.filter(c => !isNarratorCharacter(c)))
+const lockedVideoConfigId = computed(() => episode.value?.video_config_id || episode.value?.videoConfigId || null)
+// 集视频分辨率：顶栏直接修改（持久化 episodes.resolution，生成任务按此值锁定）。
+// 内部统一存 480p/720p/1080p 三档，界面按当前选中的视频模型显示厂商原生档位
+// （Seedance 480p/720p、MiniMax 768P/2K、Wan 3.0 480P/720P/1080P），适配器再映射为官方枚举
+const RESOLUTION_TIERS = {
+  volcengine: ['480p', '720p'],
+  minimax: ['720p', '1080p'],
+  aliyun: ['480p', '720p', '1080p'],
+}
+const RESOLUTION_DISPLAY = {
+  volcengine: { '480p': '480p', '720p': '720p', '1080p': '720p' },
+  minimax: { '480p': '768P', '720p': '768P', '1080p': '2K' },
+  aliyun: { '480p': '480P', '720p': '720P', '1080p': '1080P' },
+}
+const resolutionProvider = computed(() => RESOLUTION_TIERS[selectedVideoConfig.value?.provider] ? selectedVideoConfig.value.provider : 'volcengine')
+const resolutionOptions = computed(() => RESOLUTION_TIERS[resolutionProvider.value].map(key => ({
+  key,
+  model: `${RESOLUTION_DISPLAY[resolutionProvider.value][key]} · ${t(`episode.resolution.${key === '480p' ? 'smooth' : key === '720p' ? 'hd' : 'uhd'}`)}`,
+})))
+const episodeResolution = computed({
+  get: () => {
+    const v = episode.value?.resolution
+    return resolutionOptions.value.some(o => o.key === v) ? v : '720p'
+  },
+  set: (val) => { void changeEpisodeResolution(val) },
+})
+async function changeEpisodeResolution(val) {
+  if (!episode.value || val === episodeResolution.value) return
+  const prev = episode.value.resolution
+  episode.value.resolution = val
+  const label = resolutionOptions.value.find(o => o.key === val)?.model || val
+  try {
+    await episodeAPI.update(epId.value, { resolution: val })
+    toast.success(t('episode.vid.resolutionSwitched', { label }))
+  } catch (e) {
+    episode.value.resolution = prev
+    toastError(e)
+  }
+}
+// 画面比例在创建项目时固定，视频生成统一使用
+const dramaAspectRatio = computed(() => drama.value?.aspect_ratio || drama.value?.aspectRatio || '16:9')
+
+// 生成可选模型列表：配置中的模型数组（首位为配置默认）；API 可能返回数组或 JSON 字符串
+function configModels(cfg) {
+  const raw = cfg?.model
+  if (!raw) return []
+  if (Array.isArray(raw)) return raw.filter(Boolean)
+  try { const m = JSON.parse(raw); return Array.isArray(m) ? m.filter(Boolean) : [m].filter(Boolean) } catch { return [raw].filter(Boolean) }
+}
+// 汇总该类型全部启用配置的模型（按 厂商+模型 去重，按优先级排序），选中模型时连同所属配置一起调用
+// 选中值使用 'provider/model' 复合键：同名模型可能来自不同厂商（如中转站与官方），必须区分
+function collectModelOptions(cfgs) {
+  const seen = new Set()
+  const out = []
+  const sorted = [...cfgs].filter(c => c.is_active).sort((a, b) => (b.priority || 0) - (a.priority || 0))
+  for (const c of sorted) {
+    for (const m of configModels(c)) {
+      const key = `${c.provider}:${c.id}/${m}`
+      if (seen.has(key)) continue
+      seen.add(key)
+      out.push({ key, model: m, provider: c.provider, configId: c.id, configName: c.name || c.provider, gpu: configGpu(c), comfyLabel: configComfyLabel(c) })
+    }
+  }
+  return out
+}
+// 复合键 → 裸模型名（后端适配器按厂商校验模型名，不能带 provider 前缀）
+function bareModelName(key) {
+  if (!key) return ''
+  const i = key.indexOf('/')
+  return i >= 0 ? key.slice(i + 1) : key
+}
+function ownerConfigId(options, key) {
+  return key ? (options.find(o => o.key === key)?.configId || undefined) : undefined
+}
+function hasMultiConfigs(options) {
+  return new Set(options.map(o => o.configId)).size > 1
+}
+const textModelOptions = computed(() => collectModelOptions(textConfigs.value))
+const imageModelOptions = computed(() => collectModelOptions(imageConfigs.value))
+const videoModelOptions = computed(() => collectModelOptions(videoConfigs.value).filter(option => option.model !== 'MiniMax-H3-VDN-H3'))
+const selectedVideoConfig = computed(() => {
+  const selected = videoModelOptions.value.find(option => option.key === videoModel.value)
+  if (selected) return videoConfigs.value.find(config => config.id === selected.configId)
+  const locked = videoConfigs.value.find(config => config.id === lockedVideoConfigId.value && config.is_active)
+  if (locked) return locked
+  return [...videoConfigs.value]
+    .filter(config => config.is_active)
+    .sort((a, b) => (b.priority || 0) - (a.priority || 0))[0]
+})
+const shotVideoChoices = ref({})
+function taskParams(task) { try { return JSON.parse(task?.params || '{}') } catch { return {} } }
+function modelForShot(id) {
+  const choice = shotVideoChoices.value[id]
+  if (choice && 'model' in choice) return choice.model || videoModel.value
+  const task = latestVideoTask(id)
+  return videoModelOptions.value.find(o => o.configId === task?.config_id && o.model === task?.model)?.key || videoModel.value
+}
+function gpuForShot(id) {
+  const choice = shotVideoChoices.value[id]
+  return choice && 'gpu' in choice ? choice.gpu : taskParams(latestVideoTask(id)).gpu || ''
+}
+function setShotChoice(patch) {
+  const id = selectedSb.value?.id
+  if (id) shotVideoChoices.value = { ...shotVideoChoices.value, [id]: { ...shotVideoChoices.value[id], ...patch } }
+}
+const shotVideoModel = computed({ get: () => modelForShot(selectedSb.value?.id), set: model => setShotChoice({ model, gpu: '' }) })
+const videoGpu = computed({ get: () => gpuForShot(selectedSb.value?.id), set: gpu => setShotChoice({ gpu }) })
+function configForModel(key) {
+  const id = ownerConfigId(videoModelOptions.value, key)
+  return videoConfigs.value.find(c => c.id === id) || selectedVideoConfig.value
+}
+const selectedShotVideoConfig = computed(() => configForModel(shotVideoModel.value))
+const effectiveShotModelLabel = computed(() => bareModelName(shotVideoModel.value) || configModels(selectedShotVideoConfig.value)[0] || '')
+const videoSubmittingIds = ref([])
+const supportsVideoGpu = computed(() => ['minimax', 'localvideo'].includes(selectedShotVideoConfig.value?.provider))
+function configGpu(config) {
+  try { return config?.gpu || JSON.parse(config?.settings || '{}').gpu || 'auto' } catch { return 'auto' }
+}
+function configComfyLabel(config) {
+  return config?.name?.match(/ComfyUI \d+(?:（容器内）)?/)?.[0] || ''
+}
+const configGpuLabel = computed(() => configGpu(selectedShotVideoConfig.value) === 'auto' ? '自动分配' : configGpu(selectedShotVideoConfig.value).toUpperCase())
+function videoTaskRoutingLabel(task, compact = false) {
+  if (!task) return '尚未提交生成任务'
+  const route = task.routing || taskParams(task).routing
+  const status = ({ processing: '当前任务', completed: '已完成', failed: '上次任务' })[task.status] || '任务'
+  const worker = route?.gpu ? `${route.gpu.toUpperCase()} · ${route.legacy ? '旧节点' : `ComfyUI ${route.port}`}` : '等待节点确认'
+  if (compact) return `${route?.gpu ? `${route.gpu.toUpperCase()} ${route.legacy ? '旧节点' : ':' + route.port}` : '节点待确认'} · ${task.model || '视频模型'}`
+  return `${status}：${worker} · ${task.model || '视频模型'}`
+}
+function canReplaceVideo(sb) {
+  const task = latestVideoTask(sb?.id)
+  return task?.status === 'processing' && !!task.task_id && ['minimax', 'localvideo'].includes(task.provider)
+    && !task.result_url && !['submitting', 'transferring', 'downloading', 'saving'].includes(task.stage)
+}
+const isWan3Video = computed(() => selectedVideoConfig.value?.provider === 'aliyun'
+  || bareModelName(videoModel.value).startsWith('wan3.0-video'))
+
+// 参考图上限（Wan 3.0 官方 10 张，其他模型 9 张），绑定素材收集与 @名字 映射统一读取
+const refImageLimit = computed(() => isWan3Video.value ? 10 : 9)
+
+// 本次生成的生效配置（模型/分辨率/时长），用于右侧小结与批量确认弹窗
+const effectiveVideoModelLabel = computed(() => {
+  const explicit = bareModelName(videoModel.value)
+  if (explicit) return explicit
+  return configModels(selectedVideoConfig.value)[0] || ''
+})
+const episodeResolutionLabel = computed(() =>
+  resolutionOptions.value.find(o => o.key === episodeResolution.value)?.model || episodeResolution.value)
+// 短档位标签（480p / 768P / 2K 等厂商原生档位），用于底部生效配置小结
+const episodeResolutionShort = computed(() =>
+  RESOLUTION_DISPLAY[resolutionProvider.value][episodeResolution.value] || episodeResolution.value)
+const effectiveVideoDuration = computed(() => Number(selectedSb.value?.duration || 10))
+const batchVideoTotalDuration = computed(() =>
+  batchVideoConfirm.value.targets.reduce((sum, sb) => sum + (Number(sb.duration) || 5), 0))
+
+function openBatchVideoConfirm(pool) {
+  const targets = pool.filter(s => !isPendingVideo(s.id))
+  if (!targets.length) { toast.info(t('episode.vid.noneToGenerate')); return }
+  batchVideoConfirm.value = { open: true, targets }
+}
+function batchVideos() {
+  // 选择模式且有勾选 → 仅所选（允许重出已完成镜头）；否则全部未完成（待生成+失败）
+  const useSelection = videoSelectMode.value && selectedVideoSbIds.value.length
+  const pool = useSelection
+    ? sbs.value.filter(s => selectedVideoSbIds.value.includes(s.id))
+    : sbs.value.filter(s => !hasVid(s))
+  openBatchVideoConfirm(pool)
+}
+async function retryFailedVideos() {
+  await Promise.allSettled(sbs.value.filter(sb => canRecoverVideo(sb.id)).map(recoverVideo))
+}
+function confirmBatchVideos() {
+  const targets = [...batchVideoConfirm.value.targets]
+  batchVideoConfirm.value = { open: false, targets: [] }
+  if (!targets.length) return
+  const ids = targets.map(s => s.id)
+  targets.forEach(sb => genVid(sb, { silent: true, batch: true }))
+  toast.success(t('episode.vid.batchStarted', { n: ids.length }))
+  watchAsyncResult(() => ids.every(id => {
+    const target = sbs.value.find(s => s.id === id)
+    const done = !!getVideoUrl(target)
+    if (done) pendingVideoIds.value = pendingVideoIds.value.filter(item => item !== id)
+    return done
+  }), 80, 4000)
+  if (videoSelectMode.value) toggleVideoSelectMode()
+}
+
+// 配置变化后校验持久化的模型是否仍存在（配置被删/模型被移除时回退默认，避免把失效模型传给后端）
+function pruneStaleModel(modelRef, optionsRef) {
+  watch(optionsRef, opts => {
+    if (!modelRef.value || !opts.length) return
+    if (opts.some(o => o.key === modelRef.value)) return
+    // 旧版本地存储只有裸模型名：能对上则升级为复合键，对不上回退默认
+    const legacy = opts.filter(o => o.model === modelRef.value || `${o.provider}/${o.model}` === modelRef.value)
+    modelRef.value = legacy.length ? legacy[0].key : ''
+  }, { immediate: true })
+}
+pruneStaleModel(chatModel, textModelOptions)
+pruneStaleModel(imageModel, imageModelOptions)
+pruneStaleModel(videoModel, videoModelOptions)
+const textModelMultiCfg = computed(() => hasMultiConfigs(textModelOptions.value))
+const imageModelMultiCfg = computed(() => hasMultiConfigs(imageModelOptions.value))
+const videoModelMultiCfg = computed(() => hasMultiConfigs(videoModelOptions.value))
+
+// Production step helpers
+// ========== 任务列表面板 ==========
+async function loadGenTasks() {
+  if (!epId.value) return
+  try {
+    const data = await taskAPI.listByEpisode(epId.value)
+    genTasks.value = data?.tasks || []
+    genMerges.value = data?.merges || []
+
+    // 生成中/失败状态只存在内存里,页面刷新后丢失;从 sys_task 记录按分镜恢复,
+    // 否则已失败的镜头刷新后会退化成"待生成"
+    const videoTasks = genTasks.value.filter(t => t.type === 'video' && t.storyboard_id)
+    // 每个分镜只取最新一条任务(created_at 降序、id 兜底),旧任务不干预当前状态
+    const latestBySb = new Map()
+    for (const t of videoTasks) {
+      const prev = latestBySb.get(t.storyboard_id)
+      if (!prev || t.id > prev.id) {
+        latestBySb.set(t.storyboard_id, t)
+      }
+    }
+    // pending/failed 全量重建而非与现有值并集——否则刷新恢复的"生成中"在任务失败后
+    // 永不消退(videoTaskState 中 pending 优先于 failed,重试按钮还被禁用)
+    const pending = new Set()
+    const failed = {}
+    for (const [sbId, t] of latestBySb) {
+      if (t.status === 'processing') pending.add(sbId)
+      else if (t.status === 'failed' && !hasVid(sbs.value.find(s => s.id === sbId))) failed[sbId] = t.error_msg || 'Task failed'
+    }
+    // 刚点击提交、任务记录尚未加载出来的本地状态保留,避免状态闪退
+    for (const id of pendingVideoIds.value) if (!latestBySb.has(id)) pending.add(id)
+    for (const id of Object.keys(failedVideoMessages.value)) {
+      if (!latestBySb.has(Number(id))) failed[id] = failedVideoMessages.value[id]
+    }
+    pendingVideoIds.value = [...pending]
+    failedVideoMessages.value = failed
+  } catch { /* 静默失败,不打断其他刷新 */ }
+}
+
+function stopGenTasksPolling() {
+  if (genTasksTimer) { clearInterval(genTasksTimer); genTasksTimer = null }
+}
+
+const genTaskActiveCount = computed(() =>
+  genTasks.value.filter(t => t.status === 'processing').length +
+  genMerges.value.filter(m => m.status === 'processing' || m.status === 'pending').length
+)
+const genTaskDoneCount = computed(() =>
+  genTasks.value.filter(t => t.status === 'completed').length +
+  genMerges.value.filter(m => m.status === 'completed').length
+)
+const genTaskFailedCount = computed(() =>
+  genTasks.value.filter(t => t.status === 'failed').length +
+  genMerges.value.filter(m => m.status === 'failed').length
+)
+
+function genTaskTargetLabel(task) {
+  if (task.storyboard_id) {
+    const sb = sbs.value.find(x => x.id === task.storyboard_id)
+    return t('episode.tasks.sbN', { n: sb?.storyboard_number ?? sb?.storyboardNumber ?? task.storyboard_id })
+  }
+  if (task.character_id) {
+    const c = chars.value.find(x => x.id === task.character_id)
+    return `${t('common.role')} · ${c?.name || task.character_id}`
+  }
+  if (task.scene_id) {
+    const s = scenes.value.find(x => x.id === task.scene_id)
+    return `${t('common.scene')} · ${s?.location || task.scene_id}`
+  }
+  if (task.prop_id) {
+    const p = propItems.value.find(x => x.id === task.prop_id)
+    return `${t('common.prop')} · ${p?.name || task.prop_id}`
+  }
+  return t('episode.tasks.generic')
+}
+
+// 统一行结构：image / video / merge 三类合并按时间倒序
+const genTaskRows = computed(() => {
+  const taskRows = genTasks.value.map(t => ({
+    key: `task-${t.id}`,
+    kind: t.type, // image | video
+    id: t.id,
+    targetLabel: genTaskTargetLabel(t),
+    provider: t.provider || '',
+    model: t.model || '',
+    status: t.status || 'processing',
+    errorMsg: t.error_msg || '',
+    stage: t.stage || '',
+    errorCode: t.error_code || '',
+    storyboardId: t.storyboard_id,
+    recoverable: !['generation_failed', 'user_cancelled'].includes(t.error_code) && !!(t.task_id || t.result_url),
+    previewUrl: t.local_path || t.result_url || '',
+    prompt: t.prompt || '',
+    createdAt: t.created_at || '',
+    completedAt: t.completed_at || '',
+  }))
+  const mergeRows = genMerges.value.map(m => ({
+    key: `merge-${m.id}`,
+    kind: 'merge',
+    id: m.id,
+    targetLabel: t('episode.tasks.fullMerge'),
+    provider: m.provider || 'ffmpeg',
+    model: m.model || '',
+    status: m.status || 'pending',
+    errorMsg: m.error_msg || '',
+    previewUrl: m.merged_url || '',
+    prompt: '',
+    createdAt: m.created_at || '',
+    completedAt: m.completed_at || '',
+  }))
+  return [...taskRows, ...mergeRows].sort((a, b) => (b.createdAt || '').localeCompare(a.createdAt || ''))
+})
+
+function genTaskKindLabel(kind) {
+  return kind === 'image' ? t('common.serviceType.image') : kind === 'video' ? t('common.serviceType.video') : t('episode.tasks.mergeKind')
+}
+
+function trackedStageLabel(stage) {
+  return ['queued', 'running', 'checking', 'reconnecting'].includes(stage) ? t('taskTracking.' + stage) : ''
+}
+function genTaskStatusLabel(status, stage, errorCode) {
+  if (errorCode === 'upstream_missing') return t('taskTracking.missing')
+  if (status === 'completed') return t('episode.status.done')
+  if (status === 'failed') return t('episode.status.failed')
+  return trackedStageLabel(stage) || t('episode.status.generating')
+}
+
+// 映射到现有 video-task-status 的样式类:is-done / is-pending / is-failed
+function genTaskStateClass(status) {
+  if (status === 'completed') return 'done'
+  if (status === 'failed') return 'failed'
+  return 'pending'
+}
+
+// local_path 为站内相对路径补 '/',远端 result_url 原样使用
+function genTaskPreviewSrc(url) {
+  if (!url) return ''
+  return /^https?:\/\//.test(url) ? url : '/' + url
+}
+
+function genTaskDuration(row) {
+  if (!row.createdAt || !row.completedAt) return ''
+  const ms = new Date(row.completedAt).getTime() - new Date(row.createdAt).getTime()
+  if (!Number.isFinite(ms) || ms < 0) return ''
+  return ms >= 60000 ? `${Math.floor(ms / 60000)}m${Math.round((ms % 60000) / 1000)}s` : `${Math.round(ms / 1000)}s`
+}
+
+// 后端任务在刷新/重启后仍可能运行，工作台持续同步，不依赖抽屉是否打开。
+let refreshingTasks = false
+watch(genTaskActiveCount, active => {
+  stopGenTasksPolling()
+  if (active > 0) genTasksTimer = setInterval(async () => {
+    if (refreshingTasks) return
+    refreshingTasks = true
+    try { await refresh() } finally { refreshingTasks = false }
+  }, 4000)
+})
+
+const productionBlockMessage = computed(() => {
+  if (!scriptContent.value) return t('episode.prod.scriptFirst')
+  return ''
+})
+const productionBlockActionLabel = computed(() => {
+  if (!scriptContent.value) return t('episode.export.gotoScript')
+  return t('episode.prod.goBack')
+})
+function goProductionBlockTarget() {
+  if (!scriptContent.value) {
+    panel.value = 'script'
+    scriptStep.value = rawContent.value ? 1 : 0
+    return
+  }
+  panel.value = 'production'
+  prodTab.value = 'assets'
+}
+const stepLabels = computed(() => [t('episode.script.raw'), t('episode.script.rewrite')])
+
+const charImgCount = computed(() => visualChars.value.filter(c => c.image_url || c.imageUrl).length)
+const sceneImgCount = computed(() => scenes.value.filter(s => s.image_url || s.imageUrl).length)
+const propImgCount = computed(() => propItems.value.filter(p => p.image_url || p.imageUrl).length)
+const shotVidCount = computed(() => sbs.value.filter(s => s.video_url || s.videoUrl).length)
+const visualCharTotal = computed(() => visualChars.value.length)
+const pendingCharacterImageCount = computed(() => Math.max(visualCharTotal.value - charImgCount.value, 0))
+const pendingSceneImageCount = computed(() => Math.max(scenes.value.length - sceneImgCount.value, 0))
+const pendingAssetImageCount = computed(() => pendingCharacterImageCount.value + pendingSceneImageCount.value)
+const assetTotalCount = computed(() => visualCharTotal.value + scenes.value.length + propItems.value.length)
+const assetReadyCount = computed(() => charImgCount.value + sceneImgCount.value + propImgCount.value)
+
+const prodTabDefs = computed(() => [
+  { id: 'assets', label: t('episode.prod.assets'), icon: FolderKanban, badge: assetTotalCount.value ? `${assetReadyCount.value}/${assetTotalCount.value}` : '' },
+  { id: 'videos', label: t('episode.prod.videos'), icon: Clapperboard, badge: sbs.value.length ? `${shotVidCount.value}/${sbs.value.length}` : '' },
+])
+
+const mainStageDefs = computed(() => ([
+  { id: 'script', label: t('episode.stage.script'), desc: t('episode.stage.scriptDesc'), icon: FileText },
+  { id: 'assets', label: t('episode.prod.assets'), desc: t('episode.stage.assetsDesc'), icon: FolderKanban },
+  { id: 'videos', label: t('episode.stage.videos'), desc: t('episode.stage.videosDesc'), icon: Clapperboard },
+  { id: 'export', label: t('episode.stage.export'), desc: t('episode.stage.exportDesc'), icon: Download },
+]))
+
+const sidebarSections = computed(() => ([
+  {
+    id: 'script',
+    label: t('episode.stage.script'),
+    items: [
+      { key: 'script:raw', label: t('episode.script.raw'), desc: '', icon: FileText },
+      { key: 'script:rewrite', label: t('episode.script.rewrite'), desc: '', icon: FileText },
+    ],
+  },
+  {
+    id: 'production',
+    label: t('episode.stage.production'),
+    items: [
+      { key: 'prod:assets', label: t('episode.prod.assets'), desc: '', icon: Users },
+      { key: 'prod:videos', label: t('episode.prod.videos'), desc: '', icon: Clapperboard },
+      { key: 'hd', label: '高清制作', desc: 'VDN-H3 · 2K / 4K', icon: Clapperboard },
+    ],
+  },
+  {
+    id: 'export',
+    label: t('episode.stage.export'),
+    items: [
+      { key: 'export:merge', label: t('episode.stage.mergeExport'), desc: '', icon: Download },
+    ],
+  },
+]))
+
+// 大环节状态:pending(未开始)/ active(进行中)/ done(已完成)/ none(不显示状态,导出用)
+// 进行中 = 环节内有任意进度但未全部完成,或当前正处于该环节
+function sectionState(sectionId) {
+  if (sectionId === 'export') return 'none'
+  const done = sectionId === 'script'
+    ? mainStageDone('script')
+    : mainStageDone('assets') && mainStageDone('videos')
+  if (done) return 'done'
+
+  const hasProgress = sectionId === 'script'
+    ? !!(rawContent.value || scriptContent.value)
+    : !!(chars.value.length || scenes.value.length || propItems.value.length || sbs.value.length || shotVidCount.value)
+  const isCurrent = sectionId === 'script'
+    ? panel.value === 'script'
+    : panel.value === 'production'
+  return (hasProgress || isCurrent) ? 'active' : 'pending'
+}
+
+const activeMainStage = computed(() => {
+  if (panel.value === 'hd') return 'hd'
+  if (panel.value === 'export') return 'export'
+  if (panel.value === 'production') {
+    return prodTab.value === 'assets' ? 'assets' : 'videos'
+  }
+  return 'script'
+})
+
+function mainStageDone(stageId) {
+  if (stageId === 'script') return !!scriptContent.value
+  if (stageId === 'assets') return assetTotalCount.value > 0 && assetReadyCount.value === assetTotalCount.value
+  if (stageId === 'videos') {
+    return !!sbs.value.length && shotVidCount.value === sbs.value.length
+  }
+  if (stageId === 'export') return exportDone.value
+  return false
+}
+
+function goMainStage(stageId) {
+  if (stageId === 'hd') { panel.value = 'hd'; return }
+  if (stageId === 'script') {
+    panel.value = 'script'
+    scriptStep.value = Math.min(scriptStep.value, 1)
+    return
+  }
+  if (stageId === 'assets') {
+    panel.value = 'production'
+    prodTab.value = 'assets'
+    return
+  }
+  if (stageId === 'videos') {
+    panel.value = 'production'
+    prodTab.value = 'videos'
+    return
+  }
+  panel.value = 'export'
+}
+
+const activeSubStepKey = computed(() => {
+  if (panel.value === 'hd') return 'hd'
+  if (panel.value === 'script') {
+    if (scriptStep.value === 0) return 'script:raw'
+    return 'script:rewrite'
+  }
+  if (panel.value === 'production') return `prod:${prodTab.value}`
+  return 'export:merge'
+})
+
+// 步骤跑马灯：四段主流程（剧本 → 资产制作 → 视频制作 → 导出），段点击跳转、当前段流动光效
+const mainProgressSteps = computed(() => [
+  { id: 'script', label: t('episode.stage.script') },
+  { id: 'assets', label: t('episode.prod.assets') },
+  { id: 'videos', label: t('episode.stage.videos') },
+  { id: 'hd', label: '高清制作' },
+  { id: 'export', label: t('episode.stage.export') },
+])
+const currentMainIdx = computed(() => {
+  const i = mainProgressSteps.value.findIndex(s => s.id === activeMainStage.value)
+  return i < 0 ? 0 : i
+})
+
+function goSubStep(key) {
+  if (key === 'hd') { panel.value = 'hd'; return }
+  if (key.startsWith('script:')) {
+    panel.value = 'script'
+    const stepMap = {
+      'script:raw': 0,
+      'script:rewrite': 1,
+    }
+    scriptStep.value = stepMap[key] ?? 0
+    return
+  }
+  if (key.startsWith('prod:')) {
+    panel.value = 'production'
+    prodTab.value = key.replace('prod:', '')
+    return
+  }
+  panel.value = 'export'
+}
+
+const pipelineTotal = 2
+const pipelineProgress = computed(() =>
+  ['script', 'production'].filter(id => sectionState(id) === 'done').length
+)
+
+const currentStageLabel = computed(() => {
+  if (panel.value === 'hd') return '高清制作 · MiniMax H3-VDN-H3'
+  if (panel.value === 'script') return t('episode.stage.scriptStage', { step: stepLabels.value[scriptStep.value] })
+  if (panel.value === 'production') return t('episode.stage.prodStage', { step: prodTabDefs.value[prodTabIdx.value]?.label || t('episode.stage.production') })
+  return exportDone.value ? t('episode.stage.exportDone') : t('episode.stage.exportWaiting')
+})
+
+const currentMainStageLabel = computed(() => {
+  const current = mainStageDefs.value.find(stage => stage.id === activeMainStage.value)
+  return current?.label || t('episode.stage.workbench')
+})
+
+const currentSubStageLabel = computed(() => currentStageLabel.value)
+
+const totalDuration = computed(() => sbs.value.reduce((s, sb) => s + (sb.duration || 10), 0))
+const selectedSb = ref(null)
+const selectedVideoTaskNumber = computed(() => {
+  const index = videoTaskRows.value.findIndex(task => String(task.id) === String(selectedSb.value?.id))
+  return index >= 0 ? index + 1 : 0
+})
+
+function updateField(sb, field, value) {
+  const current = sb[field] ?? sb[toCamel(field)]
+  if (current === value) return
+  sb[field] = value
+  const camelField = toCamel(field)
+  if (camelField !== field) sb[camelField] = value
+  storyboardAPI.update(sb.id, { [field]: value }).catch(e => toastError(e))
+}
+
+function toCamel(field) {
+  return field.replace(/_([a-z])/g, (_, c) => c.toUpperCase())
+}
+
+function getStoryboardCharacterIds(sb) {
+  return sb?.character_ids || sb?.characterIds || []
+}
+
+function getStoryboardCharacters(sb) {
+  const ids = getStoryboardCharacterIds(sb)
+  return visualChars.value.filter(char => ids.includes(char.id))
+}
+
+function getStoryboardScene(sb) {
+  const sceneId = sb?.scene_id || sb?.sceneId
+  if (!sceneId) return null
+  return scenes.value.find(s => s.id === sceneId) || null
+}
+
+function isStoryboardCharacterSelected(sb, charId) {
+  return getStoryboardCharacterIds(sb).includes(charId)
+}
+
+function toggleStoryboardCharacter(sb, charId) {
+  const currentIds = getStoryboardCharacterIds(sb)
+  const nextIds = currentIds.includes(charId)
+    ? currentIds.filter(id => id !== charId)
+    : [...currentIds, charId]
+  updateField(sb, 'character_ids', nextIds)
+}
+
+function getStoryboardPropIds(sb) {
+  return sb?.prop_ids || sb?.propIds || []
+}
+
+function getStoryboardProps(sb) {
+  const ids = getStoryboardPropIds(sb)
+  return propItems.value.filter(p => ids.includes(p.id))
+}
+
+function isStoryboardPropSelected(sb, propId) {
+  return getStoryboardPropIds(sb).includes(propId)
+}
+
+function toggleStoryboardProp(sb, propId) {
+  const currentIds = getStoryboardPropIds(sb)
+  const nextIds = currentIds.includes(propId)
+    ? currentIds.filter(id => id !== propId)
+    : [...currentIds, propId]
+  updateField(sb, 'prop_ids', nextIds)
+}
+
+function getSceneName(sb) {
+  const scene = getStoryboardScene(sb)
+  if (!scene) return ''
+  return `${scene.location} · ${scene.time || t('episode.asset.noTime')}`
+}
+
+const sceneOptions = computed(() => [
+  { label: t('episode.sb.unboundScene'), value: '' },
+  ...scenes.value.map(s => ({ label: `${s.location} · ${s.time || t('episode.asset.noTime')}`, value: s.id })),
+])
+
+
+function sceneShotCount(sceneId) {
+  return sbs.value.filter(sb => String(sb?.scene_id || sb?.sceneId || '') === String(sceneId)).length
+}
+
+watch(rawContent, v => { localRaw.value = v }, { immediate: true })
+watch(scriptContent, v => { localScript.value = v }, { immediate: true })
+
+async function refresh() {
+  try {
+    drama.value = await dramaAPI.get(dramaId)
+    const ep = drama.value.episodes?.find(e => (e.episode_number || e.episodeNumber) === episodeNumber)
+    if (ep) {
+      episode.value = ep
+      try { chars.value = await episodeAPI.characters(ep.id) } catch { chars.value = [] }
+      try { scenes.value = await episodeAPI.scenes(ep.id) } catch { scenes.value = [] }
+      try { propItems.value = await episodeAPI.props(ep.id) } catch { propItems.value = [] }
+      sbs.value = await episodeAPI.storyboards(ep.id)
+      selectedVideoSbIds.value = selectedVideoSbIds.value.filter(id => sbs.value.some(sb => sb.id === id))
+      if (sbs.value.length) {
+        const currentSelectedId = selectedSb.value?.id
+        selectedSb.value = sbs.value.find(sb => sb.id === currentSelectedId) || sbs.value[0]
+      } else {
+        selectedSb.value = null
+      }
+
+      const epHasContent = !!(episode.value?.content)
+      const epHasScript = !!(episode.value?.script_content || episode.value?.scriptContent)
+
+      if (panelRestored) {
+        // 已恢复到上次所在步骤，跳过自动重置（仅首次加载生效）
+        panelRestored = false
+      } else if (epHasScript || epHasContent) scriptStep.value = 1
+      else scriptStep.value = 0
+    }
+  } catch (e) {
+    toastError(e)
+  }
+  try { mergeData.value = await mergeAPI.status(epId.value) } catch {}
+  await Promise.all([loadGenTasks(), loadExportMerges()])
+}
+
+function saveRaw() { episodeAPI.update(epId.value, { content: localRaw.value }); episode.value.content = localRaw.value }
+function saveScr() { episodeAPI.update(epId.value, { script_content: localScript.value }); episode.value.script_content = localScript.value }
+// 发给 Agent 的 message 是功能性提示词而非 UI 文案：产出语言由后端全局「内容语言」指令控制，
+// 这里保持中文不随界面语言变化
+function doRewrite() { saveRaw(); runAgent('script_rewriter', '请读取剧本并改写为格式化剧本，然后保存', dramaId, epId.value, refresh, chatModelOverride(), chatConfigId()) }
+function skipRewrite() {
+  const raw = (localRaw.value || rawContent.value || '').trim()
+  if (!raw) {
+    toast.warning(t('episode.script.rawRequired'))
+    return
+  }
+  localScript.value = raw
+  saveScr()
+  toast.success(t('episode.script.skipDone'))
+  panel.value = 'production'
+  prodTab.value = 'assets'
+}
+// 资产提取：按类型独立的异步任务（后端任务表驱动），三类可并行；前端轮询状态直到完成
+// label 渲染时求值（语言切换即时生效），key 为逻辑值
+const EXTRACT_TARGETS = computed(() => [
+  { key: 'characters', label: t('common.role') },
+  { key: 'scenes', label: t('common.scene') },
+  { key: 'props', label: t('common.prop') },
+])
+const extractingTargets = ref([])
+const extractingLabels = computed(() => EXTRACT_TARGETS.value.filter(x => extractingTargets.value.includes(x.key)).map(x => x.label).join(t('common.listJoin')))
+function isExtracting(target) { return extractingTargets.value.includes(target) }
+
+function doExtract(target) {
+  if (isExtracting(target) || !epId.value) return
+  saveScr()
+  extractingTargets.value.push(target)
+  episodeAPI.extract(epId.value, target, chatModelOverride(), chatConfigId())
+    .then(() => pollExtractStatus(target))
+    .catch(e => {
+      extractingTargets.value = extractingTargets.value.filter(x => x !== target)
+      toastError(e)
+    })
+}
+function doExtractAll() { EXTRACT_TARGETS.value.forEach(x => doExtract(x.key)) }
+
+function pollExtractStatus(target, attempts = 150) {
+  const label = EXTRACT_TARGETS.value.find(x => x.key === target)?.label || target
+  const tick = async (left) => {
+    try {
+      const st = await episodeAPI.extractStatus(epId.value)
+      const task = st?.[target]
+      if (task && task.status !== 'running') {
+        extractingTargets.value = extractingTargets.value.filter(x => x !== target)
+        if (task.status === 'done') {
+          toast.success(t('episode.extract.done', { type: label }))
+          await refresh()
+        } else {
+          toastError(task.error, { fallback: 'episode.extract.failed' })
+        }
+        return
+      }
+    } catch {}
+    if (left > 0) setTimeout(() => tick(left - 1), 2500)
+    else extractingTargets.value = extractingTargets.value.filter(x => x !== target)
+  }
+  setTimeout(() => tick(attempts), 2500)
+}
+
+/** 页面加载后恢复仍在运行的提取任务状态（刷新页面不丢进度展示） */
+async function syncExtractStatus() {
+  if (!epId.value) return
+  try {
+    const st = await episodeAPI.extractStatus(epId.value)
+    for (const x of EXTRACT_TARGETS.value) {
+      if (st?.[x.key]?.status === 'running' && !isExtracting(x.key)) {
+        extractingTargets.value.push(x.key)
+        pollExtractStatus(x.key)
+      }
+    }
+  } catch {}
+  try {
+    const vp = await episodeAPI.videoPromptsStatus(epId.value)
+    if (vp?.status === 'running' && !videoPromptBatch.value.running) {
+      videoPromptBatch.value = { running: true, total: vp.total || 0, completed: vp.completed || 0 }
+      pollVideoPromptBatch()
+    }
+  } catch {}
+}
+
+// ─── 批量视频提示词：后端异步逐分镜生成，前端轮询进度 ──────────
+const videoPromptBatch = ref({ running: false, total: 0, completed: 0 })
+// 单个视频提示词生成：按分镜 ID 跟踪，允许不同分镜并行生成（不走全局 rn 锁）
+const videoPromptGeneratingIds = ref([])
+// 视频制作页多选快捷操作：全选 / 仅选未生成视频（勾选集与批量视频共用 selectedVideoSbIds）
+function toggleSelectAllVideos() {
+  selectedVideoSbIds.value = selectedVideoSbIds.value.length === sbs.value.length ? [] : sbs.value.map(sb => sb.id)
+}
+function selectMissingVideos() {
+  selectedVideoSbIds.value = sbs.value.filter(sb => !hasVid(sb)).map(sb => sb.id)
+}
+
+async function batchVideoPrompts() {
+  if (videoPromptBatch.value.running || !epId.value) return
+  if (!sbs.value.length) { toast.warning(t('episode.sb.breakFirst')); return }
+  // 选择模式下有勾选 → 仅补齐所选；否则全量补齐缺失
+  const ids = (videoSelectMode.value && selectedVideoSbIds.value.length) ? [...selectedVideoSbIds.value] : undefined
+  try {
+    const res = await episodeAPI.generateVideoPrompts(epId.value, chatModelOverride(), chatConfigId(), ids)
+    if (!res?.total) {
+      if (res?.already_running) {
+        videoPromptBatch.value = { running: true, total: 0, completed: 0 }
+        pollVideoPromptBatch()
+      } else toast.info(ids ? t('episode.sb.selectedMissing') : t('episode.sb.allHavePrompts'))
+      return
+    }
+    videoPromptBatch.value = { running: true, total: res.total, completed: 0 }
+    toast.info(t('episode.sb.batchStarted', { n: res.total }))
+    pollVideoPromptBatch()
+  } catch (e) {
+    toastError(e)
+  }
+}
+
+function pollVideoPromptBatch(attempts = 240) {
+  const tick = async (left) => {
+    try {
+      const st = await episodeAPI.videoPromptsStatus(epId.value)
+      if (st && st.status !== 'running') {
+        videoPromptBatch.value = { running: false, total: 0, completed: 0 }
+        await refresh()
+        if (st.status === 'done') {
+          toast.success(st.failed ? t('episode.sb.batchDoneFailed', { n: st.failed }) : t('episode.sb.batchDone'))
+        } else {
+          toastError(st.error, { fallback: 'episode.sb.batchFailed' })
+        }
+        return
+      }
+      if (st) {
+        const prev = videoPromptBatch.value.completed
+        videoPromptBatch.value = { running: true, total: st.total || 0, completed: st.completed || 0 }
+        if ((st.completed || 0) !== prev) await refresh() // 每完成一条刷新，提示词逐步出现
+      }
+    } catch {}
+    if (left > 0) setTimeout(() => tick(left - 1), 2500)
+    else videoPromptBatch.value = { running: false, total: 0, completed: 0 }
+  }
+  setTimeout(() => tick(attempts), 2500)
+}
+function doBreakdown() {
+  const charList = chars.value.length
+    ? chars.value.map(c => `${c.name}(ID:${c.id})`).join('、')
+    : '（当前集还没有角色）'
+  const sceneList = scenes.value.length
+    ? scenes.value.map(s => `${s.location} · ${s.time || '未设时间'}(ID:${s.id})`).join('、')
+    : '（当前集还没有场景）'
+  const propList = propItems.value.length
+    ? propItems.value.map(p => `${p.name}(ID:${p.id})`).join('、')
+    : '（当前集还没有道具）'
+  runAgent('storyboard_breaker', `请基于当前集剧本拆分分镜，并为每个分镜段落同时生成 video_prompt（视频生成提示词）。
+本次视频模型：${effectiveVideoModelLabel.value}，请按该模型的特性与时长限制生成 video_prompt。
+
+当前集已有角色：${charList}
+当前集已有场景：${sceneList}
+当前集已有道具：${propList}
+
+绑定要求：
+- 每个镜头必须根据剧本内容，从上述当前集已有角色中选出出场的角色绑定 character_ids（ID 必须来自上述列表；有角色出场就必须绑定，不要遗漏）
+- 每个镜头尽量匹配上述已有场景填写 scene_id（ID 必须来自上述列表），不要凭空创造新场景
+- 每个镜头出现关键道具（被使用、交接、特写或在画面中明显可见）时，从上述当前集已有道具中绑定 prop_ids（ID 必须来自上述列表）；没有道具出现可传空数组
+- 只有纯环境空镜头才可以不绑定角色`, dramaId, epId.value, onBreakdownDone, chatModelOverride(), chatConfigId())
+}
+
+/** 拆分完成后刷新并自动补齐缺失的视频提示词（兜住 Agent 漏写/截断） */
+async function onBreakdownDone() {
+  await refresh()
+  const missing = sbs.value.filter(sb => !(sb.video_prompt || sb.videoPrompt || '').trim())
+  if (missing.length) batchVideoPrompts()
+}
+
+// 按需为单个分镜生成视频提示词：由 prompt_generator 读取分镜字段生成并保存到 video_prompt
+async function genVideoPrompt(sb) {
+  if (!sb || videoPromptGeneratingIds.value.includes(sb.id)) return
+  const idx = sbs.value.indexOf(sb) + 1
+  const cfg = selectedVideoConfig.value
+  const label = cfg ? `${cfg.name} (${cfg.provider})` : '默认'
+  const charNames = getStoryboardCharacters(sb).map(c => c.name).join('、') || '无'
+  const propNames = getStoryboardProps(sb).map(p => p.name).join('、') || '无'
+  videoPromptGeneratingIds.value.push(sb.id)
+  try {
+    await api.post(`/agent/prompt_generator/chat`, {
+      message: `请为分镜 #${idx}(ID:${sb.id})生成视频提示词(video_prompt)。视频模型:${label},请根据该模型的特性和时长限制生成。
+
+该分镜信息:时长 ${sb.duration || 10}s;场景:${getSceneName(sb) || '未绑定'};角色:${charNames};道具:${propNames}。
+
+请先调用 read_storyboard_context 获取该分镜的画面描述(含【镜头N】子镜头与台词/旁白)、氛围及时长,据此生成 video_prompt(按 3 秒分段换行、用 @角色名/@场景名/@道具名 引用参考素材；段落内允许多镜头切镜,但不跨场景,切镜点对齐 description 的【镜头N】结构),然后调用 update_storyboard 保存到分镜 ID:${sb.id}。只更新 video_prompt 字段,不要改动其他字段,不要重新拆分整集。`,
+      drama_id: dramaId,
+      episode_id: epId.value,
+      model: chatModelOverride() || undefined,
+      config_id: chatConfigId() || undefined,
+    })
+    toast.success(t('episode.sb.promptGenerated', { n: idx }))
+    await refresh()
+  } catch (e) {
+    toastError(e)
+  } finally {
+    videoPromptGeneratingIds.value = videoPromptGeneratingIds.value.filter(id => id !== sb.id)
+  }
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+function watchAsyncResult(check, attempts = 24, delay = 2500) {
+  void (async () => {
+    for (let i = 0; i < attempts; i++) {
+      await sleep(delay)
+      await refresh()
+      if (check()) return
+    }
+  })()
+}
+
+async function genCharImg(id) {
+  if (referencesSaving('character', id)) { toast.info(t('assetReferences.wait')); return }
+  try {
+    if (!isPendingCharImage(id)) pendingCharImageIds.value.push(id)
+    const char = chars.value.find(c => c.id === id)
+    if (char && !(char.final_prompt || char.finalPrompt)) {
+      toast.info(t('episode.asset.generatingPrompt'))
+      try {
+        await ensureAssetPrompt('character', id)
+      } catch {} // 提示词生成失败不阻断：后端生图前会再兜底生成或回退本地拼接
+    }
+    await characterAPI.generateImage(id, epId.value, bareModelName(imageModel.value) || undefined, ownerConfigId(imageModelOptions.value, imageModel.value), chatModelOverride(), chatConfigId())
+    toast.success(t('episode.image.generatingChar'))
+    await refresh()
+    watchAsyncResult(() => {
+      const char = chars.value.find(c => c.id === id)
+      const done = !!(char?.image_url || char?.imageUrl)
+      if (done) pendingCharImageIds.value = pendingCharImageIds.value.filter(item => item !== id)
+      return done
+    })
+  } catch (e) {
+    pendingCharImageIds.value = pendingCharImageIds.value.filter(item => item !== id)
+    toastError(e)
+  }
+}
+function batchCharImages() {
+  if (referenceBusyIds.value.length) { toast.info(t('assetReferences.wait')); return }
+  const ids = visualChars.value.filter(c => !(c.image_url || c.imageUrl)).map(c => c.id)
+  if (!ids.length) { toast.info(t('episode.image.allCharsDone')); return }
+  pendingCharImageIds.value = [...new Set([...pendingCharImageIds.value, ...ids])]
+  characterAPI.batchImages(ids, epId.value, bareModelName(imageModel.value) || undefined, ownerConfigId(imageModelOptions.value, imageModel.value), chatModelOverride(), chatConfigId()).then(async () => {
+    toast.success(t('episode.image.batchGeneratingChar'))
+    await refresh()
+    watchAsyncResult(() => ids.every(id => {
+      const char = chars.value.find(c => c.id === id)
+      const done = !!(char?.image_url || char?.imageUrl)
+      if (done) pendingCharImageIds.value = pendingCharImageIds.value.filter(item => item !== id)
+      return done
+    }), 36)
+  }).catch(e => {
+    pendingCharImageIds.value = pendingCharImageIds.value.filter(item => !ids.includes(item))
+    toastError(e)
+  })
+}
+async function genSceneImg(id) {
+  if (referencesSaving('scene', id)) { toast.info(t('assetReferences.wait')); return }
+  try {
+    if (!isPendingSceneImage(id)) pendingSceneImageIds.value.push(id)
+    const scene = scenes.value.find(s => s.id === id)
+    if (scene && !(scene.final_prompt || scene.finalPrompt)) {
+      toast.info(t('episode.asset.generatingPrompt'))
+      try {
+        await ensureAssetPrompt('scene', id)
+      } catch {} // 提示词生成失败不阻断：后端生图前会再兜底生成或回退本地拼接
+    }
+    await sceneAPI.generateImage(id, epId.value, bareModelName(imageModel.value) || undefined, ownerConfigId(imageModelOptions.value, imageModel.value), chatModelOverride(), chatConfigId())
+    toast.success(t('episode.image.generatingScene'))
+    await refresh()
+    watchAsyncResult(() => {
+      const scene = scenes.value.find(s => s.id === id)
+      const done = !!(scene?.image_url || scene?.imageUrl)
+      if (done) pendingSceneImageIds.value = pendingSceneImageIds.value.filter(item => item !== id)
+      return done
+    })
+  } catch (e) {
+    pendingSceneImageIds.value = pendingSceneImageIds.value.filter(item => item !== id)
+    toastError(e)
+  }
+}
+function isPendingPropImage(id) {
+  return pendingPropImageIds.value.includes(id)
+}
+async function genPropImg(id) {
+  if (referencesSaving('prop', id)) { toast.info(t('assetReferences.wait')); return }
+  try {
+    if (!isPendingPropImage(id)) pendingPropImageIds.value.push(id)
+    const prop = propItems.value.find(p => p.id === id)
+    if (prop && !(prop.final_prompt || prop.finalPrompt)) {
+      toast.info(t('episode.asset.generatingPrompt'))
+      try {
+        await ensureAssetPrompt('prop', id)
+      } catch {} // 提示词生成失败不阻断：后端生图前会再兜底生成或回退本地拼接
+    }
+    await propAPI.generateImage(id, epId.value, bareModelName(imageModel.value) || undefined, ownerConfigId(imageModelOptions.value, imageModel.value), chatModelOverride(), chatConfigId())
+    toast.success(t('episode.image.generatingProp'))
+    await refresh()
+    watchAsyncResult(() => {
+      const prop = propItems.value.find(p => p.id === id)
+      const done = !!(prop?.image_url || prop?.imageUrl)
+      if (done) pendingPropImageIds.value = pendingPropImageIds.value.filter(item => item !== id)
+      return done
+    })
+  } catch (e) {
+    pendingPropImageIds.value = pendingPropImageIds.value.filter(item => item !== id)
+    toastError(e)
+  }
+}
+function batchSceneImages() {
+  if (referenceBusyIds.value.length) { toast.info(t('assetReferences.wait')); return }
+  const ids = scenes.value.filter(s => !(s.image_url || s.imageUrl)).map(s => s.id)
+  if (!ids.length) { toast.info(t('episode.image.allScenesDone')); return }
+  pendingSceneImageIds.value = [...new Set([...pendingSceneImageIds.value, ...ids])]
+  ids.forEach(id => { sceneAPI.generateImage(id, epId.value, bareModelName(imageModel.value) || undefined, ownerConfigId(imageModelOptions.value, imageModel.value), chatModelOverride(), chatConfigId()).then(() => refresh()).catch(e => toastError(e)) })
+  toast.success(t('episode.image.batchGeneratingScene'))
+  watchAsyncResult(() => ids.every(id => {
+    const scene = scenes.value.find(s => s.id === id)
+    const done = !!(scene?.image_url || scene?.imageUrl)
+    if (done) pendingSceneImageIds.value = pendingSceneImageIds.value.filter(item => item !== id)
+    return done
+  }), 36)
+}
+function batchPropImages() {
+  if (referenceBusyIds.value.length) { toast.info(t('assetReferences.wait')); return }
+  const ids = propItems.value.filter(p => !(p.image_url || p.imageUrl)).map(p => p.id)
+  if (!ids.length) { toast.info(t('episode.image.allPropsDone')); return }
+  pendingPropImageIds.value = [...new Set([...pendingPropImageIds.value, ...ids])]
+  ids.forEach(id => { propAPI.generateImage(id, epId.value, bareModelName(imageModel.value) || undefined, ownerConfigId(imageModelOptions.value, imageModel.value), chatModelOverride(), chatConfigId()).then(() => refresh()).catch(e => toastError(e)) })
+  toast.success(t('episode.image.batchGeneratingProp'))
+  watchAsyncResult(() => ids.every(id => {
+    const prop = propItems.value.find(p => p.id === id)
+    const done = !!(prop?.image_url || prop?.imageUrl)
+    if (done) pendingPropImageIds.value = pendingPropImageIds.value.filter(item => item !== id)
+    return done
+  }), 36)
+}
+function getVideoUrl(s) { return s?.video_url || s?.videoUrl || s?.composed_video_url || s?.composedVideoUrl || null }
+function hasVid(s) { return !!getVideoUrl(s) }
+
+// ===== 分镜视频历史（一个分镜可能生成多个视频,sys_task 留存全部记录）=====
+const sbVideoHistory = ref([])
+const previewVideoUrl = ref('') // 空表示当前分镜；历史视频可以是本地路径或远程 URL
+const playerLoadFailed = ref(false)
+function videoSourceUrl(value) {
+  if (!value) return ''
+  return /^https?:\/\//i.test(value) ? value : '/' + value.replace(/^\/+/, '')
+}
+// 未保存完成的新结果先在线播放；下载完成后 refresh 回写的本地视频自动接替。
+// 不把临时签名 URL 写入分镜主视频，避免影响本地拼接导出。
+const playerVideoUrl = computed(() => {
+  if (previewVideoUrl.value) return videoSourceUrl(previewVideoUrl.value)
+  const task = latestVideoTask(selectedSb.value?.id)
+  const pendingResult = task && task.status !== 'completed' ? taskVideoPath(task) : ''
+  return videoSourceUrl(pendingResult || getVideoUrl(selectedSb.value))
+})
+const playerIsRemote = computed(() => /^https?:\/\//i.test(playerVideoUrl.value))
+watch(playerVideoUrl, () => { playerLoadFailed.value = false })
+
+// 注意:/tasks 返回原始行(camelCase),/episodes/:id/generation-tasks 返回 snake_case,两种命名都兼容
+function taskVideoPath(t) { return t?.local_path || t?.localPath || t?.result_url || t?.resultUrl || '' }
+function taskCreatedAt(t) { return t?.created_at || t?.createdAt || '' }
+function isCurrentVideo(t) { const p = taskVideoPath(t); return !!p && p === getVideoUrl(selectedSb.value) }
+
+async function loadSbVideoHistory() {
+  previewVideoUrl.value = ''
+  if (!selectedSb.value?.id) { sbVideoHistory.value = []; return }
+  try {
+    const rows = await taskAPI.list({ type: 'video', storyboard_id: selectedSb.value.id })
+    sbVideoHistory.value = (Array.isArray(rows) ? rows : [])
+      .filter(t => t.status === 'completed' && taskVideoPath(t))
+      .sort((a, b) => taskCreatedAt(b).localeCompare(taskCreatedAt(a)))
+  } catch { sbVideoHistory.value = [] }
+}
+
+watch(() => [selectedSb.value?.id, getVideoUrl(selectedSb.value)], () => { loadSbVideoHistory() })
+
+function previewHistoryVideo(t) {
+  previewVideoUrl.value = isCurrentVideo(t) ? '' : taskVideoPath(t)
+}
+
+async function setAsMainVideo() {
+  const sb = selectedSb.value
+  if (!sb || !previewVideoUrl.value || playerIsRemote.value) return
+  try {
+    await storyboardAPI.update(sb.id, { video_url: previewVideoUrl.value })
+    sb.video_url = previewVideoUrl.value
+    sb.videoUrl = previewVideoUrl.value
+    toast.success(t('episode.vid.setMainDone'))
+  } catch (e) { toastError(e, { fallback: 'episode.vid.setMainFailed' }) }
+}
+
+async function removeHistoryVideo(t) {
+  try {
+    await taskAPI.del(t.id)
+    sbVideoHistory.value = sbVideoHistory.value.filter(x => x.id !== t.id)
+    if (previewVideoUrl.value === taskVideoPath(t)) previewVideoUrl.value = ''
+    toast.success(t('episode.vid.historyDeleted'))
+  } catch (e) { toastError(e, { fallback: 'common.deleteFailed' }) }
+}
+
+function formatHistoryTime(iso) {
+  if (!iso) return ''
+  const d = new Date(iso)
+  if (Number.isNaN(d.getTime())) return ''
+  const p = n => String(n).padStart(2, '0')
+  return `${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
+}
+
+function getShotReferenceImages(sb) {
+  const refs = []
+  const pushRef = (value) => {
+    if (!value || refs.includes(value) || refs.length >= refImageLimit.value) return
+    refs.push(value)
+  }
+  const scene = getStoryboardScene(sb)
+  pushRef(scene?.image_url || scene?.imageUrl)
+  for (const char of getStoryboardCharacters(sb)) {
+    pushRef(char?.image_url || char?.imageUrl)
+  }
+  for (const prop of getStoryboardProps(sb)) {
+    pushRef(prop?.image_url || prop?.imageUrl)
+  }
+  return refs
+}
+
+// 右侧参考素材面板：本集全部可绑定素材（场景单选、角色/道具多选），bound 标记是否已绑定
+// kind 为英文 code（逻辑值）；typeLabel 为显示名（渲染时求值）
+function shotBindableAssets(sb) {
+  const out = []
+  for (const char of visualChars.value) {
+    const imageUrl = char.image_url || char.imageUrl || ''
+    out.push({
+      key: `character-${char.id}`,
+      id: char.id,
+      kind: 'character',
+      typeLabel: t('common.role'),
+      name: char.name || t('episode.asset.unnamedChar'),
+      meta: char.role || t('episode.asset.charPortrait'),
+      imageUrl,
+      ready: !!imageUrl,
+      bound: getStoryboardCharacterIds(sb).includes(char.id),
+    })
+  }
+  for (const scene of scenes.value) {
+    const imageUrl = scene.image_url || scene.imageUrl || ''
+    out.push({
+      key: `scene-${scene.id}`,
+      id: scene.id,
+      kind: 'scene',
+      typeLabel: t('common.scene'),
+      name: `${scene.location} · ${scene.time || t('episode.asset.noTime')}`,
+      meta: scene.time || t('episode.asset.sceneImage'),
+      imageUrl,
+      ready: !!imageUrl,
+      bound: (sb?.scene_id || sb?.sceneId) === scene.id,
+    })
+  }
+  for (const prop of propItems.value) {
+    const imageUrl = prop.image_url || prop.imageUrl || ''
+    out.push({
+      key: `prop-${prop.id}`,
+      id: prop.id,
+      kind: 'prop',
+      typeLabel: t('common.prop'),
+      name: prop.name || t('episode.asset.unnamedProp'),
+      meta: prop.type || t('episode.asset.propSingleImage'),
+      imageUrl,
+      ready: !!imageUrl,
+      bound: getStoryboardPropIds(sb).includes(prop.id),
+    })
+  }
+  // 固定顺序（角色→场景→道具，按资产原顺序）：点击绑定/解绑不重排，避免跳动
+  return out
+}
+
+// 右侧参考素材面板渲染用：当前分镜可绑定的全部素材
+const refBindableAssets = computed(() => {
+  const sb = selectedSb.value
+  return sb ? shotBindableAssets(sb) : []
+})
+
+// 右栏「绑定参考图」：当前分镜已绑定素材（生成时作为参考图提交），按分组顺序平铺展示
+const boundRefAssets = computed(() => refBindableAssets.value.filter(a => a.bound))
+
+// 参考面板分组顺序（kind code 驱动，label 渲染时求值）
+const REF_KINDS = computed(() => ([
+  { kind: 'character', label: t('common.role') },
+  { kind: 'scene', label: t('common.scene') },
+  { kind: 'prop', label: t('common.prop') },
+]))
+
+// 右侧面板切换绑定：场景单选（切换/解绑），角色/道具多选（kind code 判断，不依赖显示文案）
+function toggleShotBind(sb, asset) {
+  if (asset.kind === 'scene') {
+    const current = sb?.scene_id || sb?.sceneId
+    updateField(sb, 'scene_id', current === asset.id ? null : asset.id)
+    return
+  }
+  if (asset.kind === 'character') {
+    toggleStoryboardCharacter(sb, asset.id)
+    return
+  }
+  toggleStoryboardProp(sb, asset.id)
+}
+
+// 视频提示词 @ 引用候选：仅当前分镜已绑定的角色与道具（按名字引用）、场景（按地点引用），展示顺序：角色 → 场景 → 道具
+// kind 为逻辑值（MentionTextarea 按 kind 着色/选图标），group 为显示文案
+const mentionOptions = computed(() => {
+  const sb = selectedSb.value
+  if (!sb) return []
+  const scene = getStoryboardScene(sb)
+  return [
+    ...getStoryboardCharacters(sb).map(c => ({
+      label: c.name,
+      value: c.name,
+      kind: 'character',
+      group: t('common.role'),
+      image: thumbOf(assetImageSrc(c)),
+    })),
+    ...getStoryboardCharacters(sb).filter(c => c.voice_audio_url || c.voiceAudioUrl).map(c => ({
+      label: c.name,
+      value: c.name,
+      aliases: [`${c.name}音色`],
+      trigger: '#',
+      kind: 'voice',
+      group: t('characterVoice.title'),
+    })),
+    ...(scene ? [{
+      label: `${scene.location} · ${scene.time || t('episode.asset.noTime')}`,
+      value: scene.location,
+      kind: 'scene',
+      group: t('common.scene'),
+      image: thumbOf(assetImageSrc(scene)),
+    }] : []),
+    ...getStoryboardProps(sb).map(p => ({
+      label: p.name,
+      value: p.name,
+      kind: 'prop',
+      group: t('common.prop'),
+      image: thumbOf(assetImageSrc(p)),
+    })),
+  ]
+})
+
+// 按参考图顺序（场景图在前、角色图居中、道具图在后）为 @名字 建立索引映射，供视频提示词引用替换
+function getShotReferenceIndexMap(sb) {
+  const ordered = []
+  const seen = new Set()
+  const push = (name, url) => {
+    if (!url || seen.has(url) || ordered.length >= refImageLimit.value) return
+    seen.add(url)
+    ordered.push({ name, imageUrl: url })
+  }
+  const scene = getStoryboardScene(sb)
+  push(scene?.location || '', scene?.image_url || scene?.imageUrl)
+  for (const char of getStoryboardCharacters(sb)) {
+    push(char.name || '', char?.image_url || char?.imageUrl)
+  }
+  for (const prop of getStoryboardProps(sb)) {
+    push(prop.name || '', prop?.image_url || prop?.imageUrl)
+  }
+  const nameToIndex = {}
+  ordered.forEach((a, i) => { if (a.name && !(a.name in nameToIndex)) nameToIndex[a.name] = i + 1 })
+  return nameToIndex
+}
+
+// 将视频提示词里的 @名字 替换为 @图片N名字（N 为参考图序号，1 起），生成时使用
+function resolveVideoPromptRefs(sb) {
+  const prompt = sb.video_prompt || sb.videoPrompt || ''
+  const map = getShotReferenceIndexMap(sb)
+  const names = Object.keys(map).sort((a, b) => b.length - a.length)
+  if (!names.length) return prompt
+  return prompt.replace(/@([^\s@#]+)/g, (m, raw) => {
+    for (const name of names) {
+      if (raw.startsWith(name)) {
+        return `@图片${map[name]}${name}${raw.slice(name.length)}`
+      }
+    }
+    return m
+  })
+}
+
+// 分镜时长（视频生成参数区直接编辑并保存到分镜）：
+// 统一限制 2-30s，列表/批量/单次生成统一读取该值；超出厂商支持范围由后端适配器收敛
+function onVideoDurationChange(e) {
+  const sb = selectedSb.value
+  if (!sb) return
+  const min = 2
+  const max = 30
+  let v = Math.round(Number(e.target.value))
+  if (!Number.isFinite(v)) v = Number(sb.duration || 10)
+  v = Math.min(max, Math.max(min, v))
+  e.target.value = v
+  updateField(sb, 'duration', v)
+}
+
+function pickFile(accept, cb) {
+  const input = document.createElement('input')
+  input.type = 'file'
+  input.accept = accept
+  input.onchange = () => { const f = input.files?.[0]; if (f) cb(f) }
+  input.click()
+}
+
+// ===== 资产图片手动上传（角色形象 / 场景图 / 道具图）=====
+// 上传类型显示名渲染时求值
+const assetUploadLabelMap = computed(() => ({
+  character: t('episode.asset.charPortrait'),
+  scene: t('episode.asset.sceneImage'),
+  prop: t('episode.asset.propImage'),
+}))
+const uploadingAssetKeys = ref([])
+function isUploadingAsset(kind, id) { return uploadingAssetKeys.value.includes(`${kind}:${id}`) }
+function uploadAssetImage(kind, id) {
+  pickFile('image/jpeg,image/png,image/webp,.jpg,.jpeg,.png,.webp', async (file) => {
+    const key = `${kind}:${id}`
+    if (!uploadingAssetKeys.value.includes(key)) uploadingAssetKeys.value.push(key)
+    try {
+      const res = await uploadAPI.image(file)
+      // 与生图回写保持一致：存相对路径（static/...），前端展示时补前导斜杠
+      const payload = { image_url: res.path, local_path: res.path }
+      if (kind === 'character') await characterAPI.update(id, payload)
+      else if (kind === 'scene') await sceneAPI.update(id, payload)
+      else await propAPI.update(id, payload)
+      toast.success(t('episode.upload.assetDone', { type: assetUploadLabelMap.value[kind] || '' }))
+      await refresh()
+    } catch (e) {
+      toastError(e)
+    } finally {
+      uploadingAssetKeys.value = uploadingAssetKeys.value.filter(k => k !== key)
+    }
+  })
+}
+
+async function genVid(sb, opts = {}) {
+  if (videoSubmittingIds.value.includes(sb.id)) return
+  if (!opts.forceNew && canRecoverVideo(sb.id)) return recoverVideo(sb)
+  const latest = latestVideoTask(sb.id)
+  if (latest?.status === 'processing' && !opts.replace) return
+  const forceNew = opts.forceNew || latest?.status === 'failed'
+  if (!opts.replace && latest?.status === 'failed' && !window.confirm(t('episode.recovery.confirmNew'))) return
+  const referenceImages = getShotReferenceImages(sb)
+  const modelKey = opts.batch ? videoModel.value : modelForShot(sb.id)
+  const chosenConfig = configForModel(modelKey)
+  // 参考素材完全来自分镜绑定的角色/场景/道具图片
+  const params = {
+    storyboard_id: sb.id,
+    drama_id: dramaId,
+    prompt: resolveVideoPromptRefs(sb),
+    duration: Number(sb.duration || 10),
+    aspect_ratio: dramaAspectRatio.value,
+    generate_audio: true,
+    model: bareModelName(modelKey) || undefined,
+    config_id: ownerConfigId(videoModelOptions.value, modelKey),
+    gpu: !opts.batch && ['minimax', 'localvideo'].includes(chosenConfig?.provider) ? (gpuForShot(sb.id) || undefined) : undefined,
+    replace_task_id: opts.replace ? latest?.id : undefined,
+    reference_image_urls: referenceImages,
+  }
+  if (!params.prompt && !referenceImages.length) {
+    toast.error(t('episode.vid.needRefOrPrompt'))
+    return
+  }
+  try {
+    videoSubmittingIds.value.push(sb.id)
+    delete failedVideoMessages.value[sb.id]
+    if (!isPendingVideo(sb.id)) pendingVideoIds.value.push(sb.id)
+    const generation = await taskAPI.generate({ type: 'video', ...params, force_new: !!forceNew })
+    if (!opts.silent) toast.success(t('episode.vid.generating'))
+    await refresh()
+    pollVideoGeneration(generation?.id, sb.id)
+  } catch (e) {
+    pendingVideoIds.value = pendingVideoIds.value.filter(item => item !== sb.id)
+    failedVideoMessages.value = {
+      ...failedVideoMessages.value,
+      [sb.id]: e.message || t('episode.vid.genFailed'),
+    }
+    toastError(e, { fallback: 'episode.vid.genFailed' })
+  } finally {
+    videoSubmittingIds.value = videoSubmittingIds.value.filter(id => id !== sb.id)
+    await loadGenTasks()
+  }
+}
+async function pollVideoGeneration(generationId, storyboardId) {
+  if (!generationId) {
+    watchAsyncResult(() => {
+      const target = sbs.value.find(s => s.id === storyboardId)
+      const done = !!(target?.video_url || target?.videoUrl)
+      if (done) pendingVideoIds.value = pendingVideoIds.value.filter(item => item !== storyboardId)
+      return done
+    }, 60, 4000)
+    return
+  }
+  for (let i = 0; i < 120; i++) {
+    await sleep(4000)
+    try {
+      const res = await taskAPI.get(generationId)
+      await refresh()
+      if (latestVideoTask(storyboardId)?.id !== generationId) return
+      if (res?.status === 'completed') {
+        pendingVideoIds.value = pendingVideoIds.value.filter(item => item !== storyboardId)
+        delete failedVideoMessages.value[storyboardId]
+        toast.success(t('episode.vid.genDone'))
+        return
+      }
+      if (res?.status === 'failed') {
+        pendingVideoIds.value = pendingVideoIds.value.filter(item => item !== storyboardId)
+        const errMsg = res?.error_msg || res?.errorMsg || t('episode.vid.genFailed')
+        failedVideoMessages.value = {
+          ...failedVideoMessages.value,
+          [storyboardId]: errMsg,
+        }
+        toastError(errMsg, { fallback: 'episode.vid.genFailed' })
+        return
+      }
+    } catch {}
+  }
+  // 页面等待结束不代表上游失败；后续由任务列表轮询继续跟踪。
+  await loadGenTasks()
+}
+async function doMerge(ids) {
+  const storyboardIds = Array.isArray(ids) ? ids : undefined
+  if (storyboardIds && !storyboardIds.length) {
+    toast.error(t('episode.export.selectFirst'))
+    return
+  }
+  try {
+    await mergeAPI.merge(epId.value, storyboardIds)
+    toast.success(t('episode.export.mergingToast'))
+  } catch (e) {
+    toastError(e, { fallback: 'episode.export.mergeFailed' })
+    return
+  }
+  const poll = setInterval(async () => {
+    try { mergeData.value = await mergeAPI.status(epId.value) } catch {}
+    if (mergeData.value?.status === 'completed' || mergeData.value?.status === 'failed') {
+      clearInterval(poll)
+      if (mergeData.value.status === 'completed') {
+        toast.success(t('episode.export.mergeDone'))
+        loadExportMerges()
+      } else {
+        toastError(mergeData.value?.error_msg || mergeData.value?.errorMsg, { fallback: 'episode.export.mergeFailed' })
+      }
+    }
+  }, 3000)
+}
+async function loadConfigs() {
+  try {
+    const [imgCfgs, vidCfgs, txtCfgs] = await Promise.all([
+      aiConfigAPI.list('image'),
+      aiConfigAPI.list('video'),
+      aiConfigAPI.list('text'),
+    ])
+    imageConfigs.value = imgCfgs || []
+    videoConfigs.value = vidCfgs || []
+    textConfigs.value = txtCfgs || []
+  } catch (e) { console.error('Failed to load AI configs', e) }
+}
+
+onMounted(async () => { await refresh(); loadConfigs(); syncExtractStatus() })
+
+// ===== 应用内引导（工作台）：沿左侧进度栏走 6 步流水线 =====
+const EPISODE_TOUR = [
+  { element: '.studio-topbar-main', titleKey: 'tour.episode.topbar.title', descKey: 'tour.episode.topbar.desc', popoverSide: 'bottom' },
+  { element: '.pipe-section:nth-of-type(1)', titleKey: 'tour.episode.script.title', descKey: 'tour.episode.script.desc', popoverSide: 'right' },
+  { element: '.pipe-section:nth-of-type(2)', titleKey: 'tour.episode.assets.title', descKey: 'tour.episode.assets.desc', popoverSide: 'right' },
+  { element: '.pipe-section:nth-of-type(2) .pipe-item:last-child', titleKey: 'tour.episode.videos.title', descKey: 'tour.episode.videos.desc', popoverSide: 'right' },
+  { element: '.studio-actions .tour-help-btn', titleKey: 'tour.episode.help.title', descKey: 'tour.episode.help.desc', popoverSide: 'bottom', popoverAlign: 'end' },
+]
+onMounted(() => setTimeout(() => autoTour('episode', EPISODE_TOUR, t), 900))
+</script>
+
+<style scoped>
+.voice-reference-hint {
+  margin: 8px 0 0;
+  font-size: 11px;
+  line-height: 1.6;
+  color: var(--text-3);
+}
+/* ===== Studio Layout ===== */
+.studio {
+  display: flex;
+  flex-direction: column;
+  height: 100vh;
+  overflow: hidden;
+  padding: 8px;
+  gap: 8px;
+  background: var(--surface-base);
+  /* 选中态:中性反色(浅色近黑/深色近白),与进行中(蓝脉冲)/已完成(绿勾)区分,
+     遵循「颜色只承担状态指示」——选中不是状态,保持无色 */
+  --sel: var(--text-0);
+  --sel-bg: var(--bg-active);
+  --sel-text: var(--text-0);
+  --sel-glow: var(--bg-hover);
+}
+
+.studio-topbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  flex-shrink: 0;
+  min-height: 40px;
+  padding: 4px 10px;
+  border-radius: var(--radius-lg);
+  background: var(--header-bg);
+  border: 1px solid var(--border);
+  box-shadow: var(--shadow-card);
+  backdrop-filter: blur(20px) saturate(180%);
+  -webkit-backdrop-filter: blur(20px) saturate(180%);
+}
+
+.studio-topbar-main,
+.sidebar,
+.main {
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+  box-shadow: var(--shadow-card);
+}
+
+.studio-topbar-main {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 0;
+  border: 0;
+  box-shadow: none;
+  backdrop-filter: none;
+  background: transparent;
+  min-width: 0;
+}
+
+/* 用更高特异性压过后面的 .back-btn{height:40px}，保持顶栏紧凑 */
+.studio-topbar .topbar-back {
+  width: auto;
+  min-width: 72px;
+  padding: 0 12px;
+  height: 26px;
+  border-radius: var(--radius-pill);
+  white-space: nowrap;
+  font-size: 11px;
+}
+
+.studio-identity {
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+.studio-overline {
+  display: none;
+  font-size: 8px;
+  font-weight: 700;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--text-3);
+}
+
+.studio-title-row {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+
+.studio-title {
+  font-size: 13px;
+  line-height: 1;
+  letter-spacing: -0.04em;
+  white-space: nowrap;
+}
+
+.studio-episode-chip {
+  display: inline-flex;
+  align-items: center;
+  height: 18px;
+  padding: 0 8px;
+  border-radius: var(--radius-pill);
+  background: var(--accent-bg);
+  color: var(--accent-text);
+  font-size: 9px;
+  font-weight: 700;
+}
+
+.studio-meta-row {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  flex-wrap: nowrap;
+  min-width: 0;
+}
+
+.studio-meta-pill {
+  display: inline-flex;
+  align-items: center;
+  height: 18px;
+  padding: 0 8px;
+  border-radius: var(--radius-pill);
+  background: var(--accent-bg);
+  color: var(--accent-text);
+  font-size: 8px;
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.studio-meta-pill.is-stage {
+  background: var(--accent-bg);
+  color: var(--accent-text);
+}
+.studio-meta-pill.is-progress {
+  background: var(--success-bg);
+  color: var(--success);
+}
+.studio-meta-inline {
+  font-size: 9px;
+  color: var(--text-3);
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.studio-topbar-side {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-shrink: 0;
+}
+
+.studio-actions {
+  display: flex;
+  gap: 6px;
+}
+.studio-topbar .btn {
+  height: 26px;
+  padding: 0 9px;
+  font-size: 10.5px;
+  white-space: nowrap;
+}
+
+.studio-body {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);  /* 列宽跟随侧栏实际宽度（收起时 46px） */
+  gap: 8px;
+  min-height: 0;
+  flex: 1;
+}
+
+/* ===== Sidebar ===== */
+.sidebar {
+  width: 208px;
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  min-height: 0;
+  border-radius: var(--radius);
+}
+.back-btn {
+  min-width: 40px; width: auto; height: 40px; flex-shrink: 0;
+  display: flex; align-items: center; justify-content: center;
+  gap: 6px;
+  padding: 0 12px;
+  border: none; border-radius: var(--radius-pill);
+  background: var(--overlay-track); color: var(--text-1);
+  cursor: pointer; transition: all 0.18s var(--ease-out);
+  font-size: 12px;
+  font-weight: 650;
+  line-height: 1;
+}
+.back-btn:hover {
+  background: var(--bg-active);
+  color: var(--text-0);
+}
+.back-btn:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3.5px var(--button-focus);
+}
+
+/* Pipeline Nav */
+.pipeline { flex: 1; overflow-y: auto; padding: 12px 10px 8px; display: flex; flex-direction: column; gap: 8px; }
+.pipe-section { display: flex; flex-direction: column; gap: 2px; }
+.pipe-section-label {
+  display: flex; align-items: center; gap: 5px;
+  font-size: 10.5px; font-weight: 700; color: var(--text-3);
+  text-transform: uppercase; letter-spacing: 0.06em;
+  padding: 0 7px 2px;
+}
+/* 分组标题保持中性灰,状态色只在左侧小指示器上 */
+.pipe-section-state {
+  width: 13px; height: 13px; border-radius: 999px; flex-shrink: 0;
+  display: inline-flex; align-items: center; justify-content: center;
+}
+.pipe-section.is-done .pipe-section-state {
+  background: var(--success-bg); color: var(--success);
+  border: 1px solid var(--success-bg);
+}
+.pipe-section-dot {
+  width: 5px; height: 5px; border-radius: 999px;
+  background: var(--text-3); opacity: 0.55;
+}
+.pipe-section-pulse {
+  width: 6px; height: 6px; border-radius: 999px;
+  background: var(--accent);
+  animation: pipeSectionPulse 1.6s var(--ease-out) infinite;
+}
+@keyframes pipeSectionPulse {
+  0% { box-shadow: 0 0 0 0 var(--accent-glow); }
+  70% { box-shadow: 0 0 0 5px transparent; }
+  100% { box-shadow: 0 0 0 0 transparent; }
+}
+.pipe-section-tag {
+  font-size: 9.5px; font-weight: 600; letter-spacing: 0.03em;
+  color: var(--text-2); background: var(--bg-2);
+  border-radius: 999px; padding: 1px 5px;
+  text-transform: none;
+}
+/* 子步骤进行中:与大环节同步的脉冲点 */
+.pipe-item.doing { color: var(--text-1); }
+.pipe-item.doing .pipe-icon {
+  background: var(--accent-bg);
+  border-color: var(--accent-glow);
+}
+.pipe-item-pulse {
+  width: 6px; height: 6px; border-radius: 999px;
+  background: var(--accent);
+  animation: pipeSectionPulse 1.6s var(--ease-out) infinite;
+}
+.pipe-item {
+  position: relative;
+  display: grid; grid-template-columns: auto 1fr auto; align-items: center; gap: 10px;
+  padding: 7px 10px;
+  border-radius: var(--radius);
+  font-size: 13px; font-weight: 600;
+  background: transparent; border: 1px solid transparent; color: var(--text-2); cursor: pointer;
+  transition: all 0.18s var(--ease-out); width: 100%; text-align: left;
+}
+.pipe-item:hover {
+  background: var(--bg-hover);
+  border-color: transparent;
+  color: var(--text-0);
+}
+.pipe-item.active {
+  background: var(--sel-bg);
+  color: var(--sel-text);
+  border-color: transparent;
+  box-shadow: none;
+}
+/* ChatFire 签名：激活步骤左侧 3px 品牌色圆角指示条 */
+.pipe-item.active::before {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 9px;
+  bottom: 9px;
+  width: 3px;
+  border-radius: 999px;
+  background: var(--accent);
+}
+.pipe-item:focus-visible {
+  outline: none;
+  border-color: var(--action-primary);
+  box-shadow: 0 0 0 3px var(--button-focus), var(--button-shadow);
+}
+.pipe-item.done { color: var(--text-2); }
+.pipe-item-sub {
+  grid-template-columns: auto minmax(0, 1fr);
+  align-items: center;
+  padding: 5px 8px;
+  position: relative;
+  min-height: 34px;
+}
+
+.pipe-item-sub:not(:last-child)::after {
+  content: '';
+  position: absolute;
+  left: 15px;
+  top: 23px;
+  bottom: -6px;
+  width: 1px;
+  background: var(--border);
+}
+
+.pipe-icon {
+  width: 16px; height: 16px; border-radius: 50%;
+  display: flex; align-items: center; justify-content: center;
+  background: var(--bg-2); border: 1px solid var(--border);
+  color: var(--text-3); flex-shrink: 0; transition: all 0.15s;
+  position: relative;
+  z-index: 1;
+}
+.pipe-item.active .pipe-icon { background: var(--sel); border-color: var(--sel); color: var(--surface-raised); }
+.pipe-item.done .pipe-icon { background: var(--success-bg); border-color: var(--success-bg); color: var(--success); }
+.pipe-item.active.done .pipe-icon { background: var(--sel); border-color: var(--sel); color: var(--surface-raised); }
+.icon-active { background: var(--sel) !important; border-color: var(--sel) !important; color: var(--surface-raised) !important; }
+.icon-done { background: var(--success-bg) !important; border-color: var(--success-bg) !important; color: var(--success) !important; }
+.pipe-item.active.done .icon-done { background: var(--sel) !important; border-color: var(--sel) !important; color: var(--surface-raised) !important; }
+
+.pipe-label { flex: 1; font-size: 12.5px; }
+.pipe-copy { min-width: 0; display: flex; flex-direction: column; gap: 1px; }
+.pipe-sub {
+  display: none;
+  font-size: 10px;
+  line-height: 1.35;
+  color: var(--text-3);
+  font-weight: 500;
+}
+.pipe-badge {
+  font-size: 9px; font-weight: 700; padding: 1px 5px;
+  border-radius: 99px; background: var(--bg-3); color: var(--text-3);
+  font-family: var(--font-mono);
+}
+.pipe-badge.badge-done { background: var(--success-bg); color: var(--success); }
+.pipe-spinner { width: 10px; height: 10px; border: 1.5px solid var(--accent-bg); border-top-color: var(--accent); border-radius: 50%; animation: spin 0.8s linear infinite; }
+
+/* Sidebar Bottom */
+.sidebar-bottom {
+  padding: 9px 10px 10px;
+  border-top: 1px solid var(--border);
+  display: flex; flex-direction: column; gap: 7px;
+  flex-shrink: 0;
+  background: var(--surface-soft);
+}
+/* 收起/展开按钮 */
+.sidebar-toggle {
+  display: flex; align-items: center; justify-content: center; gap: 5px;
+  width: 100%; min-height: 22px;
+  border: none; border-radius: 6px;
+  background: transparent; color: var(--text-3);
+  font: 600 11px var(--font-body);
+  cursor: pointer; transition: background 0.14s, color 0.14s;
+}
+.sidebar-toggle:hover { background: var(--bg-hover); color: var(--text-0); }
+.sidebar-toggle-icon { transition: transform 0.22s var(--ease-out); flex-shrink: 0; }
+.sidebar.collapsed .sidebar-toggle-icon { transform: rotate(180deg); }
+
+/* ===== 收起态：窄图标栏 ===== */
+.sidebar { transition: width 0.22s var(--ease-out); }
+.sidebar.collapsed { width: 46px; }
+.sidebar.collapsed .pipeline { padding: 12px 5px 8px; gap: 10px; }
+.sidebar.collapsed .pipe-section-label { justify-content: center; padding: 0 0 2px; }
+.sidebar.collapsed .pipe-section-label > span:not(.pipe-section-state) { display: none; }
+.sidebar.collapsed .pipe-item {
+  grid-template-columns: auto; justify-content: center;
+  padding: 6px 0; min-height: 0;
+}
+.sidebar.collapsed .pipe-item .pipe-copy { display: none; }
+.sidebar.collapsed .pipe-item-sub:not(:last-child)::after { display: none; }
+.sidebar.collapsed .pipe-icon { width: 22px; height: 22px; }
+/* 收起态：进行中步骤的角标脉冲点 */
+.pipe-mini-pulse {
+  position: absolute; top: -3px; right: -3px;
+  width: 7px; height: 7px; border-radius: 50%;
+  background: var(--accent);
+  border: 1.5px solid var(--surface-raised);
+  animation: pipeSectionPulse 1.6s var(--ease-out) infinite;
+}
+.sidebar.collapsed .sidebar-progress { display: none; }
+.sidebar.collapsed .sidebar-bottom { padding: 9px 6px 10px; align-items: center; }
+.sidebar.collapsed .refresh-btn { width: 28px; min-height: 28px; padding: 0; font-size: 0; gap: 0; }
+/* 步骤跑马灯：四段主流程进度条，当前段流动光效 */
+.sidebar-progress {
+  display: flex;
+  flex-direction: column;
+  gap: 7px;
+  padding: 2px 2px 4px;
+}
+.sidebar-progress-head {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 8px;
+}
+.sidebar-progress-title {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12.5px;
+  font-weight: 700;
+  color: var(--text-1);
+}
+.sidebar-progress-count {
+  flex-shrink: 0;
+  font-family: var(--font-mono);
+  font-size: 11px;
+  color: var(--text-3);
+}
+.sidebar-progress-track {
+  display: flex;
+  gap: 4px;
+}
+.sidebar-progress-seg {
+  position: relative;
+  flex: 1;
+  height: 5px;
+  padding: 0;
+  border: none;
+  border-radius: 999px;
+  background: var(--overlay-track);
+  cursor: pointer;
+  overflow: hidden;
+  transition: background 0.2s var(--ease-out), transform 0.15s var(--ease-out);
+}
+.sidebar-progress-seg:hover { transform: scaleY(1.6); }
+.sidebar-progress-seg:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px var(--button-focus);
+}
+.sidebar-progress-seg.done { background: var(--success); }
+.sidebar-progress-seg.current { background: var(--accent-bg); }
+/* 跑马灯流动光：当前段内的渐变高光持续滑动 */
+.sidebar-progress-seg.current .sidebar-progress-seg-fill {
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(90deg,
+    var(--accent) 0%,
+    color-mix(in srgb, var(--accent) 30%, #fff 70%) 50%,
+    var(--accent) 100%);
+  background-size: 220% 100%;
+  animation: seg-marquee 1.5s linear infinite;
+}
+.sidebar-progress-seg:not(.current) .sidebar-progress-seg-fill { display: none; }
+@keyframes seg-marquee {
+  from { background-position: 220% 0; }
+  to { background-position: -220% 0; }
+}
+.sidebar-progress-labels {
+  display: flex;
+  gap: 4px;
+}
+.sidebar-progress-labels span {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  text-align: center;
+  font-size: 10.5px;
+  color: var(--text-3);
+}
+.sidebar-progress-labels span.done { color: var(--success); }
+.sidebar-progress-labels span.on {
+  color: var(--accent-text);
+  font-weight: 700;
+}
+.refresh-btn {
+  width: 100%; display: flex; align-items: center; justify-content: center; gap: 6px;
+  min-height: 28px;
+  padding: 0 10px; font-size: 12.5px; font-weight: 650; color: var(--button-text);
+  background: var(--button-bg); border: 1px solid var(--button-border); border-radius: var(--button-radius);
+  cursor: pointer; transition: all 0.18s var(--ease-out);
+  box-shadow: var(--button-shadow);
+}
+.refresh-btn:hover {
+  background: var(--button-bg-hover);
+  border-color: var(--button-border-hover);
+  color: var(--button-text-hover);
+  box-shadow: var(--button-shadow-hover);
+}
+.refresh-btn:focus-visible {
+  outline: none;
+  border-color: var(--action-primary);
+  box-shadow: 0 0 0 3px var(--button-focus), var(--button-shadow-hover);
+}
+
+/* ===== Main Content ===== */
+.main { flex: 1; display: flex; flex-direction: column; overflow: hidden; min-width: 0; min-height: 0; border-radius: var(--radius); }
+.content-panel { flex: 1; display: flex; flex-direction: column; overflow: hidden; position: relative; min-height: 0; }
+.stage-subnav {
+  align-self: flex-start;
+  margin: 4px 12px 0;
+  max-width: calc(100% - 24px);
+  overflow-x: auto;
+  flex-shrink: 0;
+}
+.stage-subnav-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  white-space: nowrap;
+  /* 压过全局 .seg-item{padding:7px 16px}，收紧子导航高度 */
+  padding: 4px 13px;
+  font-size: 12px;
+}
+.stage-subnav-item.active {
+  background: var(--seg-active-bg);
+  color: var(--text-0);
+  box-shadow: 0 1px 4px rgba(0,0,0,0.12);
+}
+.stage-subnav-item.done {
+  color: var(--text-1);
+}
+.stage-subnav-item.active.done {
+  color: var(--text-0);
+}
+.stage-subnav-dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 999px;
+  background: var(--success);
+}
+
+/* Toolbar */
+.step-toolbar {
+  display: flex; align-items: center; gap: 10px;
+  min-height: 44px;
+  padding: 8px 12px; border-bottom: 1px solid var(--border);
+  background: var(--surface-raised); flex-shrink: 0;
+}
+.prod-toolbar { background: var(--surface-raised); }
+.toolbar-left { display: flex; align-items: center; gap: 8px; flex: 1; }
+.toolbar-right { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.step-indicator { display: flex; align-items: center; gap: 8px; }
+.step-num {
+  width: 26px; height: 26px; border-radius: 10px;
+  display: inline-flex; align-items: center; justify-content: center;
+  background: var(--accent-bg);
+  font-family: var(--font-mono); font-size: 10px; font-weight: 800; color: var(--accent-text); letter-spacing: 0.05em;
+}
+.step-name { font-size: 12.5px; font-weight: 700; color: var(--text-1); font-family: var(--font-display); }
+.char-count { font-size: 11px; color: var(--text-3); font-family: var(--font-mono); }
+
+/* Editor Area */
+.step-editor { flex: 1; display: flex; flex-direction: column; min-height: 0; }
+.fill-textarea {
+  flex: 1; border: none; border-radius: 0; padding: 26px 28px;
+  font-size: 13.5px; line-height: 1.9; resize: none; outline: none;
+  font-family: var(--font-body); background: var(--bg-input); color: var(--text-0);
+}
+.fill-textarea:focus { box-shadow: none; }
+
+/* Step Empty State */
+.step-empty {
+  display: flex; flex-direction: column; align-items: center; justify-content: center;
+  flex: 1; min-height: 300px; gap: 10px; padding: 46px;
+  animation: fadeIn 0.3s var(--ease-out);
+}
+.empty-visual {
+  width: 72px; height: 72px; border-radius: 22px;
+  background: var(--bg-1); color: var(--accent);
+  border: 1px solid var(--border);
+  box-shadow: var(--shadow-sm);
+  display: flex; align-items: center; justify-content: center;
+  margin-bottom: 8px;
+}
+.empty-title { font-size: 22px; font-weight: 700; font-family: var(--font-display); color: var(--text-0); }
+.empty-desc { font-size: 13px; color: var(--text-2); max-width: 420px; text-align: center; line-height: 1.8; }
+.step-empty-actions { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; justify-content: center; }
+
+/* Step Loading */
+.step-loading {
+  display: flex; flex-direction: column; align-items: center; justify-content: center;
+  flex: 1; gap: 12px;
+}
+.loading-text { font-size: 13px; color: var(--text-2); }
+
+.storyboard-ref-list {
+  min-height: 0;
+  overflow-y: auto;
+  padding: 10px;
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+}
+/* 嵌入中栏时：不自带内边距；高度封顶内部滚动，避免把下方提示词顶出首屏 */
+.storyboard-ref-list.is-embedded { overflow: visible; padding: 0; }
+.video-main-grid .storyboard-ref-list.is-embedded { max-height: 300px; overflow-y: auto; }
+/* 视频列表选择模式快捷操作：复用分段芯片样式，去掉顶部虚线分隔 */
+.video-quick-actions { margin: 0 12px 10px; padding-top: 0; border-top: none; }
+.storyboard-ref-group {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 5px;
+}
+.storyboard-ref-group + .storyboard-ref-group {
+  margin-top: 4px;
+}
+.storyboard-ref-group-label {
+  grid-column: 1 / -1;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--text-3);
+  letter-spacing: 0.02em;
+  padding: 0 2px;
+}
+.storyboard-ref-goto {
+  flex-shrink: 0;
+  align-self: center;
+  border: none;
+  background: transparent;
+  padding: 0 2px;
+  border-radius: var(--radius-sm, 6px);
+  font-size: 10.5px;
+  font-weight: 600;
+  color: var(--accent);
+  cursor: pointer;
+}
+.storyboard-ref-goto:hover {
+  background: var(--accent-bg);
+}
+.storyboard-ref-item {
+  display: grid;
+  grid-template-columns: 30px minmax(0, 1fr);
+  gap: 8px;
+  align-items: center;
+  padding: 5px 7px;
+  border-radius: var(--radius);
+  border: 1px solid var(--border);
+  background: var(--surface-raised);
+  cursor: pointer;
+  transition: border-color 0.15s var(--ease-out), opacity 0.15s var(--ease-out);
+}
+.storyboard-ref-item:hover { border-color: var(--accent); }
+.storyboard-ref-item:not(.bound) {
+  background: transparent;
+  border-color: var(--border);
+  opacity: 0.72;
+}
+.storyboard-ref-item:not(.bound):hover { opacity: 1; border-color: var(--accent); }
+.storyboard-ref-item:not(.bound) .storyboard-ref-main .storyboard-ref-name { color: var(--text-2); }
+.storyboard-ref-item.bound {
+  border-color: var(--accent);
+  background: var(--accent-bg);
+}
+.storyboard-ref-item.bound:hover { border-color: var(--accent); }
+.storyboard-ref-thumb {
+  width: 30px;
+  aspect-ratio: 1;
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--surface-outline);
+  overflow: hidden;
+  background: var(--bg-2);
+  color: var(--text-3);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 10px;
+  font-weight: 800;
+}
+.storyboard-ref-thumb:disabled { cursor: default; }
+.storyboard-ref-thumb img { width: 100%; height: 100%; object-fit: cover; display: block; }
+.storyboard-ref-main { min-width: 0; display: flex; align-items: baseline; flex-wrap: wrap; gap: 2px 6px; }
+.storyboard-ref-name {
+  flex: none;
+  max-width: 42%;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12px;
+  font-weight: 700;
+  color: var(--text-0);
+}
+.storyboard-ref-state {
+  flex-shrink: 0;
+  margin-left: auto;
+  font-size: 10px;
+  color: var(--text-3);
+}
+.storyboard-ref-state.is-ready { color: var(--success); }
+.storyboard-ref-meta {
+  flex: 1;
+  min-width: 0;
+  font-size: 10.5px;
+  color: var(--text-3);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.storyboard-ref-empty {
+  padding: 14px 10px;
+  color: var(--text-3);
+  font-size: 12px;
+  line-height: 1.5;
+  border: 1px dashed var(--surface-outline);
+  border-radius: var(--radius);
+}
+.detail-panel { flex: 1; display: flex; flex-direction: column; overflow-y: auto; min-width: 0; }
+.detail-head { display: flex; align-items: center; gap: 8px; padding: 9px 14px; border-bottom: 1px solid var(--border); flex-shrink: 0; }
+.detail-head-copy { display: flex; flex-direction: column; gap: 2px; }
+.detail-head-title { font-size: 14px; font-weight: 700; color: var(--text-0); }
+.detail-body { padding: 14px 16px; display: flex; flex-direction: column; gap: 12px; }
+.detail-hero {
+  display: grid;
+  grid-template-columns: minmax(0, 1.2fr) minmax(220px, 0.9fr);
+  gap: 12px;
+  padding: 12px;
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+}
+.detail-hero-copy { display: flex; flex-direction: column; gap: 8px; min-width: 0; }
+.detail-hero-label {
+  font-size: 10px; font-weight: 700; letter-spacing: 0.12em;
+  text-transform: uppercase; color: var(--text-3);
+}
+.detail-hero-text { font-size: 13px; color: var(--text-1); line-height: 1.7; }
+.detail-status-row { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.detail-section {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 12px 14px;
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+}
+.detail-section-head {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+.detail-section-title { font-size: 12px; font-weight: 700; color: var(--text-0); }
+.detail-section-copy { font-size: 11px; color: var(--text-3); }
+
+/* Field */
+.field { display: flex; flex-direction: column; gap: 5px; }
+.field-label { font-size: 12px; font-weight: 500; color: var(--text-1); }
+.field-row { display: flex; gap: 12px; }
+.field-grid { display: grid; gap: 12px; }
+.field-grid-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+.field-grid-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
+.locked-config {
+  display: inline-flex;
+  align-items: center;
+  height: 30px;
+  padding: 0 12px;
+  border-radius: 999px;
+  background: var(--surface-muted);
+  border: 1px solid var(--surface-outline);
+  color: var(--text-1);
+  font-size: 11px;
+  font-weight: 600;
+}
+.locked-config-banner {
+  margin-bottom: 8px;
+  font-size: 12px;
+  color: var(--text-2);
+}
+
+/* Production tabs */
+.prod-tabs { display: flex; gap: 4px; background: var(--bg-2); border-radius: var(--radius); padding: 2px; }
+.prod-tab {
+  display: flex; align-items: center; gap: 4px; min-height: 26px; padding: 0 10px; font-size: 11px;
+  border: 1px solid transparent; background: transparent; color: var(--text-2); cursor: pointer;
+  border-radius: calc(var(--radius) - 2px); transition: all 0.18s var(--ease-out); font-weight: 650;
+  line-height: 1;
+}
+.prod-tab:hover { color: var(--text-0); background: var(--button-bg); border-color: var(--button-border); }
+.prod-tab.active { background: var(--accent-bg); color: var(--accent-text); font-weight: 650; border-color: var(--accent-glow); box-shadow: none; }
+.prod-tab:focus-visible {
+  outline: none;
+  border-color: var(--action-primary);
+  box-shadow: 0 0 0 3px var(--button-focus), var(--button-shadow);
+}
+.prod-tab-badge { font-size: 10px; font-family: var(--font-mono); padding: 0 4px; background: var(--bg-3); border-radius: 99px; }
+.prod-tab.active .prod-tab-badge { background: var(--accent-bg); color: var(--accent-text); }
+
+/* Production content */
+.prod-content { flex: 1; overflow-y: auto; padding: 10px 12px 12px; display: flex; flex-direction: column; gap: 10px; }
+.prod-section-bar { display: flex; align-items: center; gap: 7px; flex-wrap: wrap; }
+
+/* 资产栏动作：提取（虚线中性）与批量生成（强调色）视觉分组 */
+.asset-bar-actions { align-items: center; }
+.asset-bar-divider { width: 1px; height: 16px; margin: 0 4px; background: var(--surface-outline-strong); }
+.asset-btn-extract {
+  background: transparent;
+  color: var(--text-2);
+  box-shadow: none;
+  border: 1px dashed var(--surface-outline-strong);
+}
+.asset-btn-extract:hover { background: var(--surface-muted); color: var(--text-1); }
+.asset-btn-batch {
+  background: var(--accent-bg);
+  color: var(--accent-text);
+  box-shadow: none;
+}
+.asset-btn-batch:hover { background: var(--accent); color: var(--on-accent); }
+
+/* 资产分区标题：新增入口 + 卡片删除按钮 */
+.asset-section-title { display: flex; align-items: center; gap: 8px; }
+.asset-add-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  padding: 2px 8px;
+  border-radius: 999px;
+  border: 1px dashed var(--surface-outline-strong);
+  background: transparent;
+  color: var(--text-3);
+  font-size: 11px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: color 0.15s, border-color 0.15s;
+}
+.asset-add-btn:hover { color: var(--accent-text); border-color: var(--accent-text); }
+.character-asset-card, .asset-click-card { position: relative; }
+.asset-del-btn {
+  position: absolute;
+  top: 8px;
+  right: 8px;
+  z-index: 3;
+  width: 22px;
+  height: 22px;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  background: rgba(0, 0, 0, 0.5);
+  color: #fff;
+  cursor: pointer;
+  opacity: 0;
+  transition: opacity 0.15s, background 0.15s;
+}
+.asset-del-btn:hover { background: var(--action-danger); }
+.character-asset-card:hover .asset-del-btn,
+.asset-click-card:hover .asset-del-btn { opacity: 1; }
+
+/* 分镜勾选：选择后批量生成视频提示词 */
+.shot-check {
+  flex: none;
+  width: 14px;
+  height: 14px;
+  border-radius: 4px;
+  border: 1.5px solid var(--surface-outline-strong);
+  background: transparent;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--on-accent);
+  cursor: pointer;
+  transition: background 0.15s, border-color 0.15s;
+}
+.shot-check:hover { border-color: var(--accent); }
+.shot-check.on { background: var(--accent); border-color: var(--accent); }
+.shot-quick-btn {
+  border: none;
+  background: transparent;
+  color: var(--accent-text);
+  font-size: 11px;
+  font-weight: 600;
+  cursor: pointer;
+  padding: 0;
+  white-space: nowrap;
+}
+.shot-quick-btn:hover { text-decoration: underline; }
+/* 多选模式：头部快捷操作独立一行，分段芯片样式 */
+.shot-quick-actions {
+  display: flex;
+  gap: 6px;
+  margin-top: 10px;
+  padding-top: 10px;
+  border-top: 1px dashed var(--surface-outline);
+}
+.shot-quick-actions .shot-quick-btn {
+  flex: 1;
+  padding: 5px 0;
+  border-radius: 6px;
+  background: var(--bg-2);
+  color: var(--text-2);
+  text-align: center;
+  transition: background 0.15s, color 0.15s;
+}
+.shot-quick-actions .shot-quick-btn:hover {
+  background: var(--accent-bg);
+  color: var(--accent-text);
+  text-decoration: none;
+}
+
+/* 新增资产弹窗 */
+.asset-create-dialog { width: 440px; max-width: calc(100vw - 48px); }
+.asset-create-body { display: flex; flex-direction: column; gap: 10px; }
+
+/* Asset grid */
+.asset-section-title {
+  margin-top: 2px;
+  font-size: 12px;
+  font-weight: 800;
+  color: var(--text-1);
+  letter-spacing: 0.04em;
+}
+.prop-name-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+.prop-name-row .asset-name {
+  min-width: 0;
+}
+.asset-props-empty {
+  padding: 14px;
+  border: 1px dashed var(--surface-outline);
+  border-radius: var(--radius);
+  color: var(--text-3);
+  font-size: 12px;
+  text-align: center;
+}
+.asset-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(190px, 1fr)); gap: 12px; align-items: stretch; }
+.character-asset-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(230px, 260px));
+  justify-content: start;
+  gap: 10px;
+}
+.asset-card {
+  display: flex; flex-direction: column; overflow: hidden;
+  transition: transform 0.18s var(--ease-out), box-shadow 0.18s var(--ease-out), border-color 0.18s var(--ease-out);
+}
+.asset-card:hover { transform: translateY(-2px); box-shadow: var(--shadow-lift); }
+.asset-click-card,
+.character-asset-card {
+  cursor: pointer;
+}
+.asset-click-card:focus-visible,
+.character-asset-card:focus-visible {
+  outline: none;
+  border-color: var(--accent-glow);
+  box-shadow: 0 0 0 3px var(--button-focus), var(--shadow-panel);
+}
+.character-asset-card {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  min-height: 0;
+  transition: transform 0.18s var(--ease-out), box-shadow 0.18s var(--ease-out), border-color 0.18s var(--ease-out);
+}
+.character-asset-card:hover {
+  transform: translateY(-2px);
+  box-shadow: var(--shadow-lift);
+  border-color: var(--border-strong);
+}
+.character-portrait {
+  position: relative;
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  align-self: start;
+  margin: 0;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--bg-2);
+  overflow: hidden;
+}
+.character-portrait img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+.character-portrait-empty {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--text-3);
+}
+.character-asset-main {
+  min-width: 0;
+  width: 100%;
+  padding: 8px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.character-asset-overview {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.character-asset-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  min-width: 0;
+}
+.character-title-block {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.character-name-row {
+  display: flex;
+  align-items: center;
+  gap: 5px;
+  min-width: 0;
+  flex-wrap: wrap;
+}
+.character-name {
+  font-size: 13px;
+  line-height: 1.25;
+  color: var(--text-0);
+}
+.character-gen-btn { flex-shrink: 0; align-self: center; }
+.studio-model-picks {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-right: 12px;
+  padding-right: 12px;
+  border-right: 1px solid var(--border);
+}
+.asset-final-prompt {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding-top: 7px;
+  border-top: 1px solid var(--border);
+  font-size: 10.5px;
+  line-height: 1.5;
+}
+.afp-label {
+  font-size: 9.5px;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  color: var(--text-3);
+}
+.afp-text {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  overflow: hidden;
+  word-break: break-word;
+  color: var(--text-2);
+}
+.afp-text.dim { color: var(--text-3); }
+.asset-final {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  overflow: hidden;
+  word-break: break-word;
+  color: var(--text-2);
+}
+.asset-final .afp-label { margin-right: 4px; }
+.character-visual-summary {
+  max-width: 100%;
+  display: flex;
+  gap: 8px;
+  overflow: hidden;
+  color: var(--text-3);
+  font-size: 10.5px;
+  line-height: 1.45;
+  white-space: nowrap;
+}
+.character-visual-summary span {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.asset-cover { position: relative; aspect-ratio: 1; background: var(--bg-2); overflow: hidden; }
+.asset-cover.wide { aspect-ratio: 16/9; }
+.asset-cover img { width: 100%; height: 100%; object-fit: cover; }
+.previewable-image { cursor: zoom-in; transition: transform 0.18s var(--ease-out), filter 0.18s var(--ease-out); }
+.previewable-image:hover { transform: scale(1.015); filter: saturate(1.04); }
+.asset-cover-badge {
+  position: absolute;
+  top: 7px;
+  left: 7px;
+  display: inline-flex;
+  align-items: center;
+  padding: 2px 7px;
+  border-radius: 999px;
+  background: rgba(255,255,255,0.85);
+  backdrop-filter: blur(10px);
+  -webkit-backdrop-filter: blur(10px);
+  box-shadow: 0 1px 4px rgba(0,0,0,0.08);
+  color: var(--text-2);
+  font-size: 9.5px;
+  font-weight: 700;
+}
+.asset-cover-badge.is-ready {
+  background: var(--success-bg);
+  color: var(--tag-success-text);
+}
+.asset-cover-badge.is-pending {
+  background: var(--accent-bg);
+  color: var(--accent-text);
+}
+.asset-cover-empty { width: 100%; height: 100%; display: flex; align-items: center; justify-content: center; color: var(--text-3); }
+.asset-body {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  padding: 9px 11px 8px;
+  min-width: 0;
+}
+.asset-name {
+  font-size: 13px;
+  font-weight: 650;
+  color: var(--text-0);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.asset-meta { font-size: 11px; line-height: 1.5; }
+.asset-desc {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  overflow: hidden;
+  word-break: break-word;
+}
+.asset-light {
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.asset-foot { display: flex; align-items: center; gap: 4px; padding: 7px 11px; border-top: 1px solid var(--border); }
+
+/* Frame grid */
+.frame-grid { display: flex; flex-direction: column; gap: 8px; }
+.frame-row {
+  display: flex; align-items: center; gap: 14px;
+  padding: 12px 14px; cursor: pointer;
+  border-radius: var(--radius-lg);
+  transition: all 0.15s;
+  border: 1.5px solid transparent;
+}
+.frame-row:hover { background: var(--bg-0); border-color: var(--border); }
+.frame-row.active {
+  background: var(--bg-0);
+  border-color: var(--accent);
+  box-shadow: 0 0 0 3px var(--accent-glow);
+}
+.frame-info { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 6px; }
+.frame-top { display: flex; align-items: center; gap: 8px; }
+.frame-num {
+  font-size: 13px; font-family: var(--font-mono); font-weight: 800;
+  color: var(--accent);
+}
+.frame-badge {
+  font-size: 11px; font-weight: 600; padding: 2px 8px;
+  border-radius: 20px;
+  background: var(--accent-bg); color: var(--accent);
+  border: 1px solid var(--accent-glow);
+  white-space: nowrap;
+}
+.frame-desc {
+  font-size: 12px; line-height: 1.5; color: var(--text-1);
+  display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+.frame-meta { display: flex; align-items: center; gap: 6px; }
+.frame-thumbs { display: flex; gap: 8px; flex-shrink: 0; }
+.frame-thumb-wrap { display: flex; flex-direction: column; gap: 3px; align-items: center; }
+.frame-thumb-label { font-size: 10px; font-weight: 600; color: var(--text-3); }
+.frame-thumb {
+  position: relative; width: 130px; aspect-ratio: 16/9;
+  border-radius: 6px; overflow: hidden;
+  background: var(--bg-2); cursor: pointer;
+  transition: all 0.15s; border: 1.5px solid var(--border);
+}
+.frame-thumb:hover { border-color: var(--accent); box-shadow: 0 2px 8px rgba(0,0,0,0.2); }
+.frame-thumb img { width: 100%; height: 100%; object-fit: cover; }
+.frame-thumb-empty { width: 100%; height: 100%; display: flex; align-items: center; justify-content: center; color: var(--text-3); }
+.frame-re {
+  position: absolute; top: 3px; right: 3px; width: 18px; height: 18px;
+  border-radius: 50%; background: rgba(0,0,0,0.5); color: #fff;
+  display: none; align-items: center; justify-content: center;
+}
+.frame-thumb:hover .frame-re { display: flex; }
+.frame-scroll { flex: 1; overflow-y: auto; padding: 10px 12px; }
+.dot { width: 7px; height: 7px; border-radius: 50%; background: var(--bg-3); flex-shrink: 0; }
+.dot.ok { background: var(--success); }
+.dot.pending {
+  background: var(--accent);
+  box-shadow: 0 0 0 3px var(--accent-glow);
+}
+
+/* Video tasks */
+.video-task-workbench {
+  position: relative;
+  flex: 1;
+  min-height: 0;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(460px, 55%);
+  overflow: hidden;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius-lg);
+  background: var(--surface-raised);
+}
+.video-task-workbench.has-player {
+  grid-template-columns: var(--vleft, 236px) minmax(0, 1fr);
+}
+.video-task-side {
+  min-width: 0;
+  min-height: 0;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) var(--vright, 340px);
+  border-left: 1px solid var(--border);
+  background: var(--surface-muted);
+}
+/* 三栏拖拽分隔条：透明热区覆盖分界，悬停/拖动时亮起 */
+.video-col-divider {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  width: 9px;
+  z-index: 6;
+  cursor: col-resize;
+  touch-action: none;
+}
+.video-col-divider.is-left { left: calc(var(--vleft, 236px) - 4px); }
+.video-col-divider.is-right { right: calc(var(--vright, 340px) - 4px); }
+.video-col-divider::after {
+  content: '';
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 4px;
+  width: 1px;
+  background: transparent;
+  transition: background 0.15s, box-shadow 0.15s;
+}
+.video-col-divider:hover::after,
+.video-col-divider:active::after {
+  background: var(--accent);
+  box-shadow: 0 0 6px var(--accent-glow);
+}
+:global(body.is-video-col-dragging) { cursor: col-resize; user-select: none; }
+/* 中列：纯编辑区（分镜描述/氛围/视频提示词），占满高度 */
+.video-main-col {
+  min-width: 0;
+  min-height: 0;
+  display: flex;
+}
+.video-main-scroll {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+  padding: 14px 16px 16px;
+  background: var(--surface-raised);
+}
+/* 生成前检查动线集中一屏：上双栏（画面描述/氛围 ｜ 参考绑定），下整宽（视频提示词） */
+.video-main-grid {
+  display: grid;
+  grid-template-columns: minmax(0, 1.05fr) minmax(0, 1fr);
+  gap: 16px;
+  align-items: start;
+}
+.video-remote-source {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 8px;
+  padding: 12px;
+  font-size: 12px;
+  color: var(--text-2);
+}
+.video-remote-source a { max-width: 100%; overflow-wrap: anywhere; color: var(--accent); }
+
+.video-player-history {
+  min-height: 0;
+  padding: 8px 12px 10px;
+  border-bottom: 1px solid var(--border);
+  background: var(--surface-raised);
+}
+.video-player-history-head {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-bottom: 7px;
+  font-size: 11px;
+  font-weight: 700;
+  color: var(--text-2);
+}
+.video-player-history-count {
+  padding: 0 6px;
+  border-radius: 999px;
+  background: var(--overlay-track);
+  color: var(--text-3);
+  font-size: 10px;
+  font-weight: 750;
+}
+.video-player-history-list {
+  display: flex;
+  gap: 8px;
+  overflow-x: auto;
+  padding-bottom: 2px;
+}
+.video-history-item {
+  position: relative;
+  flex: 0 0 auto;
+  width: 96px;
+  aspect-ratio: 16 / 9;
+  overflow: hidden;
+  border: 1.5px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--media-surface);
+  cursor: pointer;
+  transition: border-color 0.16s var(--ease-out), box-shadow 0.16s var(--ease-out);
+}
+.video-history-item:hover { border-color: var(--border-strong); }
+.video-history-item video {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+.video-history-item.current {
+  border-color: var(--accent);
+}
+.video-history-item.viewing {
+  border-color: var(--accent);
+  box-shadow: 0 0 0 3px var(--accent-glow);
+}
+.video-history-time {
+  position: absolute;
+  left: 4px;
+  bottom: 4px;
+  padding: 1px 4px;
+  border-radius: 3px;
+  background: rgba(0,0,0,0.6);
+  color: #fff;
+  font-family: var(--font-mono);
+  font-size: 9px;
+}
+.video-history-badge {
+  position: absolute;
+  right: 4px;
+  top: 4px;
+  padding: 1px 5px;
+  border-radius: 999px;
+  background: var(--accent);
+  color: var(--on-accent);
+  font-size: 9px;
+  font-weight: 700;
+}
+.video-history-del {
+  position: absolute;
+  right: 3px;
+  top: 3px;
+  width: 16px;
+  height: 16px;
+  display: none;
+  align-items: center;
+  justify-content: center;
+  border: 0;
+  border-radius: 50%;
+  background: rgba(0,0,0,0.62);
+  color: #fff;
+  font-size: 11px;
+  line-height: 1;
+  cursor: pointer;
+}
+.video-history-item:hover .video-history-del { display: flex; }
+.video-task-player {
+  min-width: 0;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+  border-bottom: 1px solid var(--border);
+  background: var(--surface-raised);
+}
+.video-player-head {
+  min-height: 44px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  flex-wrap: wrap;
+  gap: 6px 12px;
+  padding: 8px 14px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.video-player-head-info {
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.video-player-title { color: var(--text-0); font-size: 13px; font-weight: 700; white-space: nowrap; }
+.video-player-sub { color: var(--text-3); font-size: 11px; white-space: nowrap; }
+.video-player-stage {
+  flex: none;
+  aspect-ratio: 16 / 9;
+  max-height: 220px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--media-surface);
+}
+.video-player-video {
+  width: 100%;
+  height: 100%;
+  max-width: 100%;
+  max-height: 100%;
+  object-fit: contain;
+  display: block;
+}
+/* 空态：保留 16:9 播放框，内容居中（图标 + 文案 + 生成按钮） */
+.video-player-empty {
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  text-align: center;
+  gap: 6px;
+  padding: 14px 16px;
+  color: var(--text-3);
+}
+.video-player-empty-copy { display: flex; flex-direction: column; align-items: center; }
+.video-player-empty-title { color: var(--text-1); font-size: 12.5px; font-weight: 700; }
+.video-player-empty-desc { margin-top: 2px; font-size: 11px; line-height: 1.5; }
+.video-player-empty-action { flex-shrink: 0; margin-top: 4px; }
+.video-task-list {
+  min-height: 0;
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+  border: 0;
+  border-radius: 0;
+  background: var(--surface-raised);
+}
+.video-task-head {
+  min-height: 48px;
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 8px 12px;
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.video-task-title {
+  font-size: 13px;
+  line-height: 1.2;
+  font-weight: 850;
+  color: var(--text-0);
+}
+.video-task-meta {
+  margin-top: 3px;
+  font-size: 11px;
+  line-height: 1.35;
+  color: var(--text-3);
+}
+.video-task-metrics {
+  margin-left: auto;
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+.video-task-metric,
+.video-task-status {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  min-height: 22px;
+  padding: 0 8px;
+  border: 1px solid var(--surface-outline);
+  border-radius: 999px;
+  background: var(--overlay-track);
+  color: var(--text-2);
+  font-size: 11px;
+  font-weight: 750;
+  white-space: nowrap;
+}
+.video-task-metric.is-done,
+.video-task-status.is-done {
+  color: var(--success);
+  border-color: var(--success-bg);
+  background: var(--success-bg);
+}
+.video-task-metric.is-pending,
+.video-task-status.is-pending,
+.video-task-status.is-ready {
+  color: var(--accent-text);
+  border-color: var(--accent-glow);
+  background: var(--accent-bg);
+}
+.video-task-metric.is-failed,
+.video-task-status.is-failed,
+.video-task-status.is-blocked {
+  color: var(--warning);
+  border-color: var(--warning-bg);
+  background: var(--warning-bg);
+}
+.video-task-table {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+}
+/* 统计徽章兼作筛选器 */
+button.video-task-metric { cursor: pointer; font-family: inherit; transition: box-shadow 0.15s; }
+button.video-task-metric:hover { box-shadow: 0 0 0 2px var(--sel-glow); }
+button.video-task-metric.on { box-shadow: 0 0 0 2px var(--accent); }
+/* 批量视频：选择模式 */
+.btn.is-on { border-color: var(--accent); color: var(--accent-text); background: var(--accent-bg); }
+.video-retry-failed { color: var(--warning); border-color: var(--warning-bg); }
+.video-task-row.is-selected { background: var(--sel-bg); box-shadow: inset 0 0 0 1.5px var(--sel); }
+.video-task-check {
+  position: absolute;
+  top: 5px;
+  right: 5px;
+  z-index: 2;
+  background: rgba(0,0,0,0.45);
+  border-color: rgba(255,255,255,0.55);
+}
+.video-task-check.on { background: var(--accent); border-color: var(--accent); }
+/* 生成前生效配置小结 */
+.video-inspector-effective {
+  margin: 0;
+  padding: 4px 8px;
+  border: 1px solid var(--accent-glow);
+  border-radius: var(--radius);
+  background: var(--accent-bg);
+  color: var(--accent-text);
+  font-family: var(--font-mono);
+  font-size: 10.5px;
+  font-weight: 600;
+  line-height: 1.4;
+  text-align: center;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+/* 生成参数：强调卡片，时长是当前分镜生成的核心参数 */
+.video-params-card {
+  padding: 7px 10px;
+  border: 1px solid var(--accent-glow);
+  border-radius: var(--radius-lg);
+  background: var(--accent-bg);
+}
+/* 审核失败引导 */
+.video-task-error-hint {
+  margin-top: 3px;
+  color: var(--accent-text);
+  font-weight: 600;
+}
+/* 批量生成确认弹窗 */
+.batch-video-dialog { width: 420px; max-width: calc(100vw - 48px); }
+.batch-video-body { display: flex; flex-direction: column; gap: 10px; }
+.batch-video-row {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  font-size: 13px;
+  color: var(--text-2);
+  padding: 8px 12px;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--bg-input);
+}
+.batch-video-row strong { color: var(--text-0); font-weight: 600; }
+.batch-video-note { margin: 4px 0 0; font-size: 11px; color: var(--text-3); line-height: 1.6; }
+.video-task-row {
+  display: grid;
+  grid-template-columns: 56px minmax(0, 1fr) auto;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 8px;
+  border-top: 1px solid var(--surface-outline);
+  transition: background 0.16s var(--ease-out), border-color 0.16s var(--ease-out);
+  cursor: pointer;
+}
+.video-task-row:first-child {
+  border-top: 0;
+}
+.video-task-row:hover,
+.video-task-row.is-pending {
+  background: var(--bg-hover);
+}
+.video-task-row.is-failed {
+  background: var(--error-bg);
+}
+.video-task-row.active {
+  background: var(--sel-bg);
+  box-shadow: inset 0 0 0 1.5px var(--sel), 0 0 0 3px var(--sel-glow);
+}
+.video-task-row:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: -2px;
+}
+.video-task-preview {
+  position: relative;
+  width: 56px;
+  aspect-ratio: 16 / 9;
+  overflow: hidden;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius-sm);
+  background: var(--bg-2);
+}
+.video-task-preview video,
+.video-task-preview img {
+  width: 100%;
+  height: 100%;
+  display: block;
+  object-fit: cover;
+}
+.video-task-empty {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--text-3);
+}
+.video-task-index {
+  position: absolute;
+  left: 3px;
+  top: 3px;
+  padding: 0 4px;
+  border-radius: 3px;
+  background: rgba(0,0,0,0.56);
+  color: #fff;
+  font-family: var(--font-mono);
+  font-size: 9px;
+  font-weight: 800;
+}
+.video-task-main {
+  min-width: 0;
+}
+.video-task-line {
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.video-task-name {
+  min-width: 0;
+  font-size: 12px;
+  line-height: 1.35;
+  color: var(--text-0);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.video-task-meta-line {
+  display: flex;
+  align-items: center;
+  gap: 5px;
+  margin-top: 2px;
+  font-size: 10.5px;
+  color: var(--text-3);
+  min-width: 0;
+  white-space: nowrap;
+  overflow: hidden;
+}
+.video-task-loc {
+  color: var(--text-2);
+}
+.video-task-sep { color: var(--text-3); opacity: 0.5; }
+.video-task-error {
+  margin-top: 5px;
+  font-size: 11px;
+  line-height: 1.45;
+  color: var(--error);
+}
+.video-task-error-hint {
+  margin-top: 3px;
+  color: var(--accent-text, var(--accent));
+  font-weight: 600;
+}
+.video-task-status {
+  justify-self: end;
+  align-self: center;
+}
+/* 行内紧凑状态（窄列表用）：小圆点 + 文字 */
+.video-task-state {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  flex-shrink: 0;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--text-3);
+  white-space: nowrap;
+}
+.video-task-state.is-done { color: var(--success); }
+.video-task-state.is-pending { color: var(--accent-text); }
+.video-task-state.is-failed { color: var(--warning); }
+.video-task-action {
+  justify-self: end;
+  align-self: center;
+  min-width: 0;
+  width: 24px;
+  height: 24px;
+  padding: 0;
+}
+.video-task-inspector {
+  min-width: 0;
+  min-height: 0;
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+  border-left: 1px solid var(--border);
+  background: var(--surface-muted);
+}
+.video-task-inspector .video-task-player,
+.video-task-inspector .video-player-history {
+  flex: none;
+}
+.video-inspector-head {
+  min-height: 56px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 12px 16px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.video-inspector-title { color: var(--text-0); font-size: 14px; font-weight: 700; }
+.video-inspector-sub { margin-top: 2px; color: var(--text-3); font-size: 11px; }
+.video-inspector-body { flex: 1; min-height: 0; overflow-y: auto; display: flex; flex-direction: column; gap: 16px; padding: 16px 18px 18px; }
+/* 时长参数 + 生成操作常驻底部：不随检查器滚动 */
+.video-inspector-footer {
+  flex: none;
+  display: flex;
+  flex-direction: column;
+  gap: 7px;
+  padding: 9px 14px 11px;
+  border-top: 1px solid var(--border);
+  background: var(--surface-muted);
+}
+.video-inspector-section { display: flex; flex-direction: column; gap: 7px; }
+.video-inspector-label { color: var(--text-0); font-size: 12px; font-weight: 700; }
+.video-inspector-label-hero {
+  color: var(--accent);
+  font-size: 13px;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+.video-inspector-label-hero::before {
+  content: '';
+  width: 3px;
+  height: 13px;
+  border-radius: 2px;
+  background: var(--accent);
+}
+.video-inspector-prompt-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+/* MentionTextarea 内部元素需 :deep 穿透（scoped 样式默认到不了子组件内部） */
+:deep(.video-inspector-prompt) {
+  min-height: 176px;
+  font-size: 13px;
+  line-height: 1.6;
+}
+.video-inspector-params { display: grid; gap: 8px; }
+.video-inspector-params div { display: flex; justify-content: space-between; gap: 12px; font-size: 12px; }
+.video-inspector-params dt { color: var(--text-3); }
+.video-inspector-params dd { margin: 0; color: var(--text-1); text-align: right; }
+.video-inspector-action { width: 100%; min-height: 32px; height: 32px; padding: 0 12px; font-size: 12.5px; }
+/* 绑定参考图：当前分镜已绑定素材的图片平铺（生成时作为参考图提交） */
+.video-bound-refs { display: grid; grid-template-columns: repeat(auto-fill, minmax(64px, 1fr)); gap: 8px; }
+.video-bound-ref {
+  position: relative;
+  aspect-ratio: 1;
+  overflow: hidden;
+  padding: 0;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--bg-2);
+  color: var(--text-3);
+  cursor: pointer;
+  transition: border-color 0.15s var(--ease-out);
+}
+.video-bound-ref:hover { border-color: var(--accent); }
+.video-bound-ref:disabled { cursor: default; }
+.video-bound-ref:disabled:hover { border-color: var(--surface-outline); }
+.video-bound-ref img { width: 100%; height: 100%; object-fit: cover; display: block; }
+.video-bound-ref small {
+  position: absolute;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  padding: 2px 5px;
+  background: rgba(0,0,0,0.58);
+  color: #fff;
+  font-size: 9.5px;
+  text-align: left;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.video-bound-ref-empty { width: 100%; height: 100%; display: flex; align-items: center; justify-content: center; font-size: 11px; }
+.video-bound-refs-empty { padding: 10px; border: 1px dashed var(--surface-outline); border-radius: var(--radius); color: var(--text-3); font-size: 11px; line-height: 1.5; }
+.video-param-row { display: flex; align-items: center; justify-content: space-between; gap: 10px; font-size: 12px; white-space: nowrap; }
+.video-param-name { color: var(--text-1); font-weight: 600; flex-shrink: 0; }
+.video-param-value { color: var(--text-1); text-align: right; font-size: 11px; }
+.video-param-control { display: inline-flex; align-items: center; gap: 6px; }
+.video-param-unit { font-size: 11px; color: var(--text-2); }
+.video-duration-input { width: 56px; height: 24px; padding: 2px 6px; font-size: 12px; font-weight: 700; font-family: var(--font-mono); text-align: center; }
+
+/* Prod grid */
+.prod-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(190px, 1fr)); gap: 12px; }
+.prod-card {
+  display: flex; flex-direction: column; overflow: hidden;
+  transition: transform 0.18s var(--ease-out), box-shadow 0.18s var(--ease-out), border-color 0.18s var(--ease-out);
+  border-radius: 20px;
+  background: var(--surface-raised);
+  border: 1px solid var(--surface-outline);
+}
+.prod-card:hover { transform: translateY(-2px); box-shadow: var(--shadow-lift); }
+.prod-cover { position: relative; aspect-ratio: 16/9; background: var(--bg-2); overflow: hidden; }
+.prod-cover img { width: 100%; height: 100%; object-fit: cover; }
+.prod-video { width: 100%; height: 100%; object-fit: cover; background: #000; display: block; }
+.prod-cover-empty { width: 100%; height: 100%; display: flex; align-items: center; justify-content: center; color: var(--text-3); }
+.prod-idx {
+  position: absolute; top: 5px; left: 5px; font-size: 10px; font-weight: 700;
+  font-family: var(--font-mono); background: rgba(0,0,0,0.5); color: #fff; padding: 1px 5px; border-radius: 3px;
+}
+.prod-overlay-badge {
+  position: absolute; bottom: 5px; right: 5px; font-size: 10px; font-weight: 600;
+  background: var(--success); color: var(--on-accent); padding: 1px 5px; border-radius: 3px;
+}
+.prod-info { padding: 10px 12px 8px; }
+.prod-desc { font-size: 12px; line-height: 1.4; }
+.prod-meta-line { margin-top: 5px; font-size: 10px; color: var(--text-3); }
+.prod-dots { display: flex; align-items: center; gap: 4px; margin-top: 5px; color: var(--text-3); }
+.prod-error {
+  margin-top: 6px;
+  font-size: 11px;
+  line-height: 1.45;
+  color: var(--error);
+}
+.prod-actions { display: flex; gap: 6px; padding: 8px 10px 10px; border-top: 1px solid var(--surface-outline); }
+.prod-actions .btn { flex: 1; justify-content: center; }
+
+/* Asset detail dialog */
+.asset-detail-overlay {
+  z-index: 118;
+  padding: 28px;
+}
+.asset-detail-dialog {
+  width: min(1040px, calc(100vw - 56px));
+  max-height: calc(100vh - 56px);
+}
+.asset-detail-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.asset-detail-title-block {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.asset-detail-kicker {
+  color: var(--text-3);
+  font-size: 10px;
+  font-weight: 800;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+}
+.asset-detail-title {
+  margin: 0;
+  color: var(--text-0);
+  font-size: 18px;
+  line-height: 1.2;
+  font-family: var(--font-display);
+}
+.asset-detail-head-actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-shrink: 0;
+}
+.asset-detail-body {
+  min-height: 0;
+  overflow: auto;
+  padding: 16px;
+}
+.asset-detail-shell {
+  display: grid;
+  grid-template-columns: minmax(280px, 380px) minmax(0, 1fr);
+  gap: 14px;
+  align-items: start;
+}
+.asset-detail-preview-panel,
+.asset-detail-editor-panel {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.asset-detail-preview-panel {
+  position: sticky;
+  top: 0;
+}
+.asset-detail-section-title {
+  min-height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+  color: var(--text-1);
+  font-size: 12px;
+  font-weight: 820;
+  letter-spacing: 0.02em;
+}
+.asset-detail-section-title .dim {
+  font-size: 11px;
+  font-weight: 560;
+  letter-spacing: 0;
+  text-align: right;
+}
+.asset-detail-state {
+  min-height: 20px;
+  display: inline-flex;
+  align-items: center;
+  padding: 0 7px;
+  border-radius: 999px;
+  background: var(--overlay-track);
+  color: var(--text-3);
+  font-size: 10px;
+  font-weight: 760;
+  white-space: nowrap;
+}
+.asset-detail-state.is-ready {
+  color: var(--success);
+  background: var(--success-bg);
+}
+.asset-detail-media-frame {
+  position: relative;
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  display: block;
+  padding: 0;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--bg-2);
+  color: var(--text-3);
+  overflow: hidden;
+  cursor: zoom-in;
+}
+.asset-detail-media-frame:disabled {
+  cursor: default;
+  opacity: 1;
+}
+.asset-detail-media-frame:focus-visible {
+  outline: none;
+  border-color: var(--action-primary);
+  box-shadow: 0 0 0 3px var(--button-focus);
+}
+.asset-detail-media-frame img {
+  width: 100%;
+  height: 100%;
+  display: block;
+  object-fit: cover;
+}
+.asset-detail-media-empty {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--text-3);
+}
+.asset-detail-desc {
+  margin: 0;
+  color: var(--text-1);
+  font-size: 13px;
+  line-height: 1.7;
+}
+.asset-detail-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 8px;
+}
+.asset-detail-field {
+  min-width: 0;
+  padding: 9px 10px;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--surface-muted);
+}
+.asset-detail-field span,
+.asset-detail-edit-field span,
+.asset-detail-text-block span,
+.asset-detail-shot-head {
+  display: block;
+  color: var(--text-3);
+  font-size: 10px;
+  font-weight: 780;
+  letter-spacing: 0.04em;
+}
+.asset-detail-field strong {
+  display: block;
+  margin-top: 5px;
+  min-width: 0;
+  overflow: hidden;
+  color: var(--text-0);
+  font-size: 12px;
+  line-height: 1.35;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.asset-detail-text-block {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 8px;
+}
+.asset-detail-edit-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 10px;
+}
+.asset-detail-edit-grid--character,
+.asset-detail-edit-grid--scene {
+  grid-template-columns: 1fr;
+}
+.asset-detail-edit-field {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 7px;
+}
+.asset-detail-textarea {
+  min-height: 138px;
+  resize: vertical;
+}
+.asset-detail-edit-grid--character .asset-detail-textarea,
+.asset-detail-edit-grid--scene .asset-detail-textarea {
+  min-height: 164px;
+}
+.asset-detail-meta-row {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 8px;
+}
+.asset-detail-meta-item {
+  min-width: 0;
+  padding: 9px 10px;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--surface-muted);
+}
+.asset-detail-meta-item span {
+  display: block;
+  color: var(--text-3);
+  font-size: 10px;
+  font-weight: 780;
+  letter-spacing: 0.04em;
+}
+.asset-detail-meta-item strong {
+  display: block;
+  margin-top: 4px;
+  min-width: 0;
+  color: var(--text-0);
+  font-size: 12px;
+  line-height: 1.35;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.asset-detail-text-block > div,
+.asset-detail-shot-list {
+  padding: 10px;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--surface-muted);
+}
+.asset-detail-text-block p {
+  margin: 5px 0 0;
+  color: var(--text-2);
+  font-size: 12px;
+  line-height: 1.55;
+}
+.asset-detail-shot-list {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.asset-detail-shot-items {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.asset-detail-shot-row {
+  display: grid;
+  grid-template-columns: 36px minmax(0, 1fr) auto;
+  align-items: center;
+  gap: 8px;
+  color: var(--text-2);
+  font-size: 11px;
+}
+.asset-detail-shot-row strong {
+  min-width: 0;
+  overflow: hidden;
+  color: var(--text-1);
+  font-weight: 650;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.asset-detail-shot-row small,
+.asset-detail-empty {
+  color: var(--text-3);
+  font-size: 11px;
+}
+.asset-detail-foot {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 12px 16px;
+  border-top: 1px solid var(--surface-outline);
+}
+.asset-detail-secondary-actions,
+.asset-detail-primary-actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.asset-detail-prompt-panel {
+  min-width: 0;
+  margin-top: 14px;
+  padding-top: 14px;
+  border-top: 1px solid var(--surface-outline);
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.asset-detail-prompt-head-actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-shrink: 0;
+}
+.asset-detail-copy-btn {
+  gap: 5px;
+}
+.asset-detail-prompt-textarea {
+  min-height: 96px;
+  max-height: 260px;
+  overflow: auto;
+  padding: 12px 14px;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--surface-muted);
+  color: var(--text-1);
+  font-size: 12px;
+  line-height: 1.65;
+  white-space: pre-wrap;
+  word-break: break-word;
+  resize: vertical;
+  width: 100%;
+}
+.asset-detail-prompt-hint {
+  margin: 0;
+  color: var(--text-3);
+  font-size: 11px;
+  line-height: 1.5;
+}
+.asset-detail-readonly-grid {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.asset-detail-readonly {
+  min-width: 0;
+  padding: 10px 12px;
+  border: 1px solid var(--surface-outline);
+  border-radius: var(--radius);
+  background: var(--surface-muted);
+}
+.asset-detail-readonly span {
+  display: block;
+  color: var(--text-3);
+  font-size: 10px;
+  font-weight: 780;
+  letter-spacing: 0.04em;
+}
+.asset-detail-readonly p {
+  margin: 6px 0 0;
+  color: var(--text-1);
+  font-size: 12px;
+  line-height: 1.65;
+  white-space: pre-wrap;
+  word-break: break-word;
+  user-select: text;
+}
+.asset-detail-readonly p.dim {
+  color: var(--text-3);
+}
+
+/* Image viewer */
+.image-viewer-overlay {
+  z-index: 120;
+  padding: 28px;
+}
+.image-viewer-dialog {
+  width: min(1100px, calc(100vw - 56px));
+  max-height: calc(100vh - 56px);
+  background: var(--header-bg);
+  backdrop-filter: blur(20px) saturate(180%);
+  -webkit-backdrop-filter: blur(20px) saturate(180%);
+}
+.image-viewer-head {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 16px 18px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.image-viewer-title {
+  font-size: 14px;
+  font-weight: 700;
+  color: var(--text-1);
+  font-family: var(--font-display);
+}
+.image-viewer-body {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 20px;
+  overflow: auto;
+  min-height: 0;
+}
+.image-viewer-img {
+  display: block;
+  max-width: 100%;
+  max-height: calc(100vh - 140px);
+  border-radius: 18px;
+  box-shadow: var(--shadow-xl);
+  background: var(--surface-muted);
+}
+
+/* Export */
+.export-split { flex: 1; display: flex; min-height: 0; }
+.export-main { flex: 1; min-height: 0; overflow-y: auto; display: flex; flex-direction: column; align-items: stretch; gap: 18px; padding: 16px 20px 24px; }
+.export-section { display: flex; flex-direction: column; min-height: 0; }
+.export-section-grow { flex: 1; }
+.export-section-head { display: flex; align-items: center; gap: 8px; margin-bottom: 10px; }
+.export-section-title { font-size: 13px; font-weight: 800; color: var(--text-0); }
+.export-merge-strip { display: flex; gap: 12px; overflow-x: auto; padding-bottom: 4px; }
+.merge-card {
+  flex: 0 0 auto;
+  width: 260px;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 8px;
+  border-radius: var(--radius);
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+}
+.merge-card video {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  border-radius: 6px;
+  background: var(--media-surface);
+  display: block;
+}
+.merge-card-pending {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0 12px;
+  border-radius: 6px;
+  background: var(--surface-muted);
+  color: var(--text-3);
+  font-size: 11px;
+  text-align: center;
+}
+.merge-card-pending.is-failed { color: var(--error); background: var(--error-bg); }
+.merge-card-meta { display: flex; align-items: center; gap: 6px; font-size: 11px; color: var(--text-3); min-width: 0; }
+.merge-card-meta .btn { margin-left: auto; }
+.merge-card.playable { cursor: pointer; }
+.merge-card.playable:hover { border-color: var(--border-strong); box-shadow: var(--shadow-card); }
+.merge-card-thumb { position: relative; }
+.merge-card-play {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 6px;
+  background: rgba(0,0,0,0.28);
+  color: #fff;
+  opacity: 0;
+  transition: opacity 0.15s var(--ease-out);
+  pointer-events: none;
+}
+.merge-card.playable:hover .merge-card-play { opacity: 1; }
+.merge-viewer-dialog { width: min(1080px, calc(100vw - 56px)); }
+.merge-viewer-body {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 18px;
+  min-height: 0;
+}
+.merge-viewer-video {
+  width: 100%;
+  max-height: calc(100vh - 220px);
+  border-radius: var(--radius);
+  background: #000;
+  display: block;
+}
+.export-merge-empty {
+  padding: 14px;
+  border: 1px dashed var(--border);
+  border-radius: var(--radius);
+  color: var(--text-3);
+  font-size: 12px;
+  text-align: center;
+}
+.export-grid {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  align-content: start;
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 12px;
+}
+.exp-card { display: flex; flex-direction: column; align-items: stretch; gap: 6px; padding: 8px; border-radius: var(--radius); background: var(--surface-raised); border: 1px solid var(--border); }
+.exp-card:hover { border-color: var(--border-strong); box-shadow: var(--shadow-card); }
+.exp-card.playable { cursor: pointer; }
+.exp-card.selected { border-color: var(--accent); box-shadow: 0 0 0 2px var(--accent-glow); }
+.exp-check {
+  position: absolute;
+  right: 6px;
+  top: 6px;
+  width: 18px;
+  height: 18px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  border: 1.5px solid rgba(255,255,255,0.9);
+  background: rgba(0,0,0,0.35);
+  color: #fff;
+}
+.exp-check.on { background: var(--accent); border-color: var(--accent); }
+.exp-thumb {
+  position: relative;
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  overflow: hidden;
+  border: 1px solid var(--surface-outline);
+  border-radius: 6px;
+  background: var(--media-surface);
+}
+.exp-thumb video { width: 100%; height: 100%; object-fit: cover; display: block; }
+.exp-thumb-empty { width: 100%; height: 100%; display: flex; align-items: center; justify-content: center; color: var(--text-3); }
+.exp-thumb-index {
+  position: absolute;
+  left: 5px;
+  top: 5px;
+  padding: 1px 5px;
+  border-radius: 4px;
+  background: rgba(0,0,0,0.56);
+  color: #fff;
+  font-family: var(--font-mono);
+  font-size: 10px;
+  font-weight: 800;
+}
+.exp-thumb-duration {
+  position: absolute;
+  right: 5px;
+  bottom: 5px;
+  padding: 1px 4px;
+  border-radius: 3px;
+  background: rgba(0,0,0,0.6);
+  color: #fff;
+  font-family: var(--font-mono);
+  font-size: 9px;
+}
+/* 镜头预览：悬停浮现的居中播放钮，点击打开预览弹窗（不影响卡片勾选） */
+.exp-play {
+  position: absolute;
+  left: 50%;
+  top: 50%;
+  transform: translate(-50%, -50%) scale(0.9);
+  width: 36px;
+  height: 36px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  background: rgba(0,0,0,0.62);
+  color: #fff;
+  opacity: 0;
+  cursor: pointer;
+  transition: opacity 0.15s, transform 0.15s, background 0.15s;
+}
+.exp-card:hover .exp-play { opacity: 1; transform: translate(-50%, -50%) scale(1); }
+.exp-play:hover { background: var(--accent); }
+/* 导出完成手动标记按钮 */
+.export-done-btn.on {
+  background: var(--success-bg, var(--accent-bg));
+  color: var(--success, var(--accent-text));
+  border-color: transparent;
+  font-weight: 600;
+}
+.exp-row-line { display: flex; align-items: center; gap: 8px; min-width: 0; }
+
+/* Shared */
+.dim { color: var(--text-3); }
+
+@media (max-width: 1080px) {
+  .studio-body {
+    grid-template-columns: 1fr;
+  }
+
+  .video-task-workbench.has-player {
+    grid-template-columns: var(--vleft, 208px) minmax(0, 1fr);
+  }
+
+  .video-task-side {
+    grid-template-columns: minmax(0, 1fr) var(--vright, 260px);
+  }
+
+  .video-main-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .split-layout,
+  .export-split {
+    flex-direction: column;
+  }
+
+  .sb-scene-select { max-width: none; flex: 1; }
+
+  .detail-panel {
+    min-height: 420px;
+  }
+
+  .field-grid-4 {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+
+  .character-asset-grid {
+    grid-template-columns: repeat(auto-fill, minmax(420px, 1fr));
+  }
+
+  .video-task-head {
+    align-items: flex-start;
+    flex-direction: column;
+  }
+
+  .video-task-metrics {
+    width: 100%;
+    margin-left: 0;
+    justify-content: flex-start;
+  }
+
+  .video-task-row {
+    grid-template-columns: 56px minmax(0, 1fr);
+  }
+
+  .video-task-action {
+    justify-self: start;
+  }
+
+  .image-viewer-overlay {
+    padding: 16px;
+  }
+
+  .image-viewer-dialog {
+    width: calc(100vw - 32px);
+    max-height: calc(100vh - 32px);
+  }
+
+  .asset-detail-overlay {
+    padding: 16px;
+  }
+
+  .asset-detail-dialog {
+    width: calc(100vw - 32px);
+    max-height: calc(100vh - 32px);
+  }
+
+  .asset-detail-shell {
+    grid-template-columns: 1fr;
+  }
+
+  .asset-detail-preview-panel {
+    position: static;
+  }
+
+  .asset-detail-grid,
+  .asset-detail-edit-grid,
+  .asset-detail-text-block {
+    grid-template-columns: 1fr;
+  }
+
+}
+
+/* ===== 任务列表面板 ===== */
+.gen-task-row {
+  grid-template-columns: 84px minmax(0, 1fr) auto;
+  cursor: default;
+}
+.gen-task-row .video-task-preview img {
+  cursor: zoom-in;
+}
+
+/* 任务触发按钮(顶栏) */
+.task-drawer-trigger {
+  position: relative;
+}
+.task-drawer-badge {
+  min-width: 16px;
+  height: 16px;
+  padding: 0 4px;
+  border-radius: 999px;
+  background: var(--accent);
+  color: var(--action-primary-text);
+  font-size: 10px;
+  font-weight: 700;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  line-height: 1;
+}
+
+/* 右侧抽屉 */
+.task-drawer-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 118;
+  display: flex;
+  justify-content: flex-end;
+  background: var(--scrim);
+  backdrop-filter: blur(8px);
+  -webkit-backdrop-filter: blur(8px);
+  animation: fadeIn 0.18s var(--ease-out);
+}
+.task-drawer {
+  width: min(560px, 100vw);
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+  background: var(--panel-bg);
+  border-left: 1px solid var(--panel-border);
+  box-shadow: var(--shadow-xl);
+  animation: taskDrawerIn 0.22s var(--ease-out);
+}
+@keyframes taskDrawerIn {
+  from { transform: translateX(24px); opacity: 0; }
+  to { transform: translateX(0); opacity: 1; }
+}
+.task-drawer-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.task-drawer-head-actions {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+.task-drawer-metrics {
+  padding: 10px 16px;
+  border-bottom: 1px solid var(--surface-outline);
+}
+.task-drawer-body {
+  flex: 1;
+  overflow-y: auto;
+}
+.task-drawer-empty {
+  flex: 1;
+  justify-content: center;
+}
+
+@media (max-width: 860px) {
+  .studio {
+    padding: 8px;
+    gap: 8px;
+  }
+
+  .studio-topbar-main {
+    align-items: flex-start;
+  }
+
+  .studio-topbar {
+    flex-direction: column;
+    align-items: stretch;
+  }
+
+  .studio-topbar-side {
+    justify-content: space-between;
+  }
+
+  .sidebar {
+    max-height: 340px;
+  }
+
+  .studio-topbar-side,
+  .studio-actions {
+    flex-wrap: wrap;
+  }
+
+  .toolbar-right,
+  .export-bar {
+    flex-wrap: wrap;
+  }
+
+  .asset-grid,
+  .character-asset-grid,
+  .prod-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .character-asset-card {
+    min-height: 0;
+  }
+
+  .character-asset-overview {
+    grid-template-columns: 1fr;
+  }
+
+  .character-portrait {
+    width: auto;
+  }
+
+  .character-asset-main {
+    padding: 10px;
+  }
+
+  .character-asset-head {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .video-task-workbench {
+    grid-template-columns: 1fr;
+    overflow-y: auto;
+  }
+
+  /* 窄屏纵向堆叠后无栏间分界，隐藏拖拽分隔条 */
+  .video-col-divider { display: none; }
+
+  .video-task-inspector {
+    border-top: 1px solid var(--surface-outline);
+    border-left: 0;
+  }
+
+  .video-task-side {
+    display: flex;
+    flex-direction: column;
+    border-top: 1px solid var(--surface-outline);
+    border-left: 0;
+  }
+
+  /* 窄屏：中列改为纵向堆叠，由外层 workbench 整体滚动 */
+  .video-main-col {
+    display: flex;
+    flex-direction: column;
+    flex: none;
+  }
+
+  .video-main-scroll {
+    flex: none;
+    overflow: visible;
+  }
+
+  .video-task-side .video-task-inspector {
+    flex: none; /* 窄屏下由外层 workbench 整体滚动，检查器按内容撑开，不参与 flex 收缩 */
+    border-top: 0;
+    display: flex;
+    flex-direction: column;
+    overflow: visible;
+  }
+
+  .video-inspector-body {
+    overflow: visible;
+  }
+
+  .video-task-player {
+    flex: none; /* 禁止收缩：否则 stage 的 min-height 会使其溢出播放器并遮挡下方检查器 */
+  }
+
+  .video-player-stage {
+    flex: none;
+    max-height: 220px;
+  }
+
+  .frame-row {
+    flex-direction: column;
+    align-items: stretch;
+  }
+
+  .detail-hero {
+    grid-template-columns: 1fr;
+  }
+
+  .field-grid-2,
+  .field-grid-4 {
+    grid-template-columns: 1fr;
+  }
+
+  .frame-thumbs {
+    width: 100%;
+  }
+
+  .frame-thumb {
+    width: 100%;
+  }
+
+}
+</style>
diff --git a/huobao-source/frontend/nuxt.config.ts b/huobao-source/frontend/nuxt.config.ts
new file mode 100644
index 0000000..7e0c952
--- /dev/null
+++ b/huobao-source/frontend/nuxt.config.ts
@@ -0,0 +1,48 @@
+import { fileURLToPath } from 'node:url'
+
+export default defineNuxtConfig({
+  srcDir: 'app/',
+  ssr: false,
+  devtools: { enabled: false },
+  experimental: {
+    appManifest: false,
+  },
+  hooks: {
+    // 动态路由页面统一放在 app/views/ 手动注册，避免文件路径中出现 [id] 方括号
+    // （方括号路径在 git/shell 中需转义，且部分部署环境不兼容）。URL 保持不变。
+    'pages:extend'(pages) {
+      pages.push(
+        {
+          name: 'drama-detail',
+          path: '/drama/:id',
+          file: fileURLToPath(new URL('./app/views/drama/detail.vue', import.meta.url)),
+        },
+        {
+          name: 'drama-episode',
+          path: '/drama/:id/episode/:episodeNumber',
+          file: fileURLToPath(new URL('./app/views/drama/episode.vue', import.meta.url)),
+        },
+      )
+    },
+  },
+  app: {
+    head: {
+      title: '火宝短剧',
+      meta: [{ name: 'viewport', content: 'width=device-width, initial-scale=1' }],
+      link: [
+        // v 参数用于 favicon 缓存穿透（浏览器对 favicon 缓存独立于 HTTP 缓存，换图必须 bump）
+        { rel: 'icon', type: 'image/png', sizes: '32x32', href: '/favicon.png?v=20261002' },
+        { rel: 'shortcut icon', type: 'image/png', href: '/favicon.png?v=20261002' },
+      ],
+    },
+  },
+  vite: {
+    server: {
+      proxy: {
+        '/api': { target: 'http://localhost:5679', changeOrigin: true },
+        '/static': { target: 'http://localhost:5679', changeOrigin: true },
+      },
+    },
+  },
+  compatibilityDate: '2025-05-15',
+})
diff --git a/huobao-source/frontend/package-lock.json b/huobao-source/frontend/package-lock.json
new file mode 100644
index 0000000..95bd946
--- /dev/null
+++ b/huobao-source/frontend/package-lock.json
@@ -0,0 +1,10069 @@
+{
+  "name": "huobao-drama-frontend",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "huobao-drama-frontend",
+      "hasInstallScript": true,
+      "dependencies": {
+        "driver.js": "^1.8.0",
+        "lucide-vue-next": "^0.511.0",
+        "nuxt": "^3.17.5",
+        "vue": "^3.5.13",
+        "vue-i18n": "^11.4.10",
+        "vue-router": "^4.5.1",
+        "vue-sonner": "^1.2.4"
+      },
+      "devDependencies": {
+        "typescript": "^5.8.3"
+      }
+    },
+    "node_modules/@babel/code-frame": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz",
+      "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/compat-data": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.0.tgz",
+      "integrity": "sha512-T1NCJqT/j9+cn8fvkt7jtwbLBfLC/1y1c7NtCeXFRgzGTsafi68MRv8yzkYSapBnFA6L3U2VSc02ciDzoAJhJg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/core": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.0.tgz",
+      "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@babel/code-frame": "^7.29.0",
+        "@babel/generator": "^7.29.0",
+        "@babel/helper-compilation-targets": "^7.28.6",
+        "@babel/helper-module-transforms": "^7.28.6",
+        "@babel/helpers": "^7.28.6",
+        "@babel/parser": "^7.29.0",
+        "@babel/template": "^7.28.6",
+        "@babel/traverse": "^7.29.0",
+        "@babel/types": "^7.29.0",
+        "@jridgewell/remapping": "^2.3.5",
+        "convert-source-map": "^2.0.0",
+        "debug": "^4.1.0",
+        "gensync": "^1.0.0-beta.2",
+        "json5": "^2.2.3",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/babel"
+      }
+    },
+    "node_modules/@babel/core/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/@babel/generator": {
+      "version": "7.29.1",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.1.tgz",
+      "integrity": "sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.0",
+        "@babel/types": "^7.29.0",
+        "@jridgewell/gen-mapping": "^0.3.12",
+        "@jridgewell/trace-mapping": "^0.3.28",
+        "jsesc": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-annotate-as-pure": {
+      "version": "7.27.3",
+      "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.27.3.tgz",
+      "integrity": "sha512-fXSwMQqitTGeHLBC08Eq5yXz2m37E4pJX1qAU1+2cNedz/ifv/bVXft90VeSav5nFO61EcNgwr0aJxbyPaWBPg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.27.3"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.28.6.tgz",
+      "integrity": "sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/compat-data": "^7.28.6",
+        "@babel/helper-validator-option": "^7.27.1",
+        "browserslist": "^4.24.0",
+        "lru-cache": "^5.1.1",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/@babel/helper-create-class-features-plugin": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.28.6.tgz",
+      "integrity": "sha512-dTOdvsjnG3xNT9Y0AUg1wAl38y+4Rl4sf9caSQZOXdNqVn+H+HbbJ4IyyHaIqNR6SW9oJpA/RuRjsjCw2IdIow==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.27.3",
+        "@babel/helper-member-expression-to-functions": "^7.28.5",
+        "@babel/helper-optimise-call-expression": "^7.27.1",
+        "@babel/helper-replace-supers": "^7.28.6",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.27.1",
+        "@babel/traverse": "^7.28.6",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-create-class-features-plugin/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/@babel/helper-globals": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
+      "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-member-expression-to-functions": {
+      "version": "7.28.5",
+      "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.28.5.tgz",
+      "integrity": "sha512-cwM7SBRZcPCLgl8a7cY0soT1SptSzAlMH39vwiRpOQkJlh53r5hdHwLSCZpQdVLT39sZt+CRpNwYG4Y2v77atg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.28.5",
+        "@babel/types": "^7.28.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-imports": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.28.6.tgz",
+      "integrity": "sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-transforms": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.6.tgz",
+      "integrity": "sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.28.6",
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "@babel/traverse": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-optimise-call-expression": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.27.1.tgz",
+      "integrity": "sha512-URMGH08NzYFhubNSGJrpUEphGKQwMQYBySzat5cAByY1/YgIRkULnIy3tAMeszlL/so2HbeilYloUmSpd7GdVw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-plugin-utils": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.28.6.tgz",
+      "integrity": "sha512-S9gzZ/bz83GRysI7gAD4wPT/AI3uCnY+9xn+Mx/KPs2JwHJIz1W8PZkg2cqyt3RNOBM8ejcXhV6y8Og7ly/Dug==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-replace-supers": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.28.6.tgz",
+      "integrity": "sha512-mq8e+laIk94/yFec3DxSjCRD2Z0TAjhVbEJY3UQrlwVo15Lmt7C2wAUbK4bjnTs4APkwsYLTahXRraQXhb1WCg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-member-expression-to-functions": "^7.28.5",
+        "@babel/helper-optimise-call-expression": "^7.27.1",
+        "@babel/traverse": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-skip-transparent-expression-wrappers": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.27.1.tgz",
+      "integrity": "sha512-Tub4ZKEXqbPjXgWLl2+3JpQAYBJ8+ikpQ2Ocj/q/r0LwE3UhENh7EUabyHjz2kCEsrRY83ew2DQdHluuiDQFzg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.27.1",
+        "@babel/types": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
+      "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.28.5",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
+      "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-option": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
+      "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helpers": {
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.2.tgz",
+      "integrity": "sha512-HoGuUs4sCZNezVEKdVcwqmZN8GoHirLUcLaYVNBK2J0DadGtdcqgr3BCbvH8+XUo4NGjNl3VOtSjEKNzqfFgKw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/template": "^7.28.6",
+        "@babel/types": "^7.29.0"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.2.tgz",
+      "integrity": "sha512-4GgRzy/+fsBa72/RZVJmGKPmZu9Byn8o4MoLpmNe1m8ZfYnz5emHLQz3U4gLud6Zwl0RZIcgiLD7Uq7ySFuDLA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.0"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-jsx": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.28.6.tgz",
+      "integrity": "sha512-wgEmr06G6sIpqr8YDwA2dSRTE3bJ+V0IfpzfSY3Lfgd7YWOaAdlykvJi13ZKBt8cZHfgH1IXN+CL656W3uUa4w==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-typescript": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.28.6.tgz",
+      "integrity": "sha512-+nDNmQye7nlnuuHDboPbGm00Vqg3oO8niRRL27/4LYHUsHYh0zJ1xWOz0uRwNFmM1Avzk8wZbc6rdiYhomzv/A==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-typescript": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typescript/-/plugin-transform-typescript-7.28.6.tgz",
+      "integrity": "sha512-0YWL2RFxOqEm9Efk5PvreamxPME8OyY0wM5wh5lHjF+VtVhdneCWGzZeSqzOfiobVqQaNCd2z0tQvnI9DaPWPw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.27.3",
+        "@babel/helper-create-class-features-plugin": "^7.28.6",
+        "@babel/helper-plugin-utils": "^7.28.6",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.27.1",
+        "@babel/plugin-syntax-typescript": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/template": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz",
+      "integrity": "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.28.6",
+        "@babel/parser": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/traverse": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.0.tgz",
+      "integrity": "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.0",
+        "@babel/generator": "^7.29.0",
+        "@babel/helper-globals": "^7.28.0",
+        "@babel/parser": "^7.29.0",
+        "@babel/template": "^7.28.6",
+        "@babel/types": "^7.29.0",
+        "debug": "^4.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz",
+      "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.27.1",
+        "@babel/helper-validator-identifier": "^7.28.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@bomb.sh/tab": {
+      "version": "0.0.14",
+      "resolved": "https://registry.npmjs.org/@bomb.sh/tab/-/tab-0.0.14.tgz",
+      "integrity": "sha512-cHMk2LI430MVoX1unTt9oK1iZzQS4CYDz97MSxKLNErW69T43Z2QLFTpdS/3jVOIKrIADWfuxQ+nQNJkNV7E4w==",
+      "license": "MIT",
+      "bin": {
+        "tab": "dist/bin/cli.mjs"
+      },
+      "peerDependencies": {
+        "cac": "^6.7.14",
+        "citty": "^0.1.6 || ^0.2.0",
+        "commander": "^13.1.0"
+      },
+      "peerDependenciesMeta": {
+        "cac": {
+          "optional": true
+        },
+        "citty": {
+          "optional": true
+        },
+        "commander": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@clack/core": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@clack/core/-/core-1.1.0.tgz",
+      "integrity": "sha512-SVcm4Dqm2ukn64/8Gub2wnlA5nS2iWJyCkdNHcvNHPIeBTGojpdJ+9cZKwLfmqy7irD4N5qLteSilJlE0WLAtA==",
+      "license": "MIT",
+      "dependencies": {
+        "sisteransi": "^1.0.5"
+      }
+    },
+    "node_modules/@clack/prompts": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@clack/prompts/-/prompts-1.1.0.tgz",
+      "integrity": "sha512-pkqbPGtohJAvm4Dphs2M8xE29ggupihHdy1x84HNojZuMtFsHiUlRvqD24tM2+XmI+61LlfNceM3Wr7U5QES5g==",
+      "license": "MIT",
+      "dependencies": {
+        "@clack/core": "1.1.0",
+        "sisteransi": "^1.0.5"
+      }
+    },
+    "node_modules/@cloudflare/kv-asset-handler": {
+      "version": "0.4.2",
+      "resolved": "https://registry.npmjs.org/@cloudflare/kv-asset-handler/-/kv-asset-handler-0.4.2.tgz",
+      "integrity": "sha512-SIOD2DxrRRwQ+jgzlXCqoEFiKOFqaPjhnNTGKXSRLvp1HiOvapLaFG2kEr9dYQTYe8rKrd9uvDUzmAITeNyaHQ==",
+      "license": "MIT OR Apache-2.0",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@dxup/nuxt": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/@dxup/nuxt/-/nuxt-0.4.0.tgz",
+      "integrity": "sha512-28LDotpr9G2knUse3cQYsOo6NJq5yhABv4ByRVRYJUmzf9Q31DI7rpRek4POlKy1aAcYyKgu5J2616pyqLohYg==",
+      "license": "MIT",
+      "dependencies": {
+        "@dxup/unimport": "^0.1.2",
+        "@nuxt/kit": "^4.2.2",
+        "chokidar": "^5.0.0",
+        "pathe": "^2.0.3",
+        "tinyglobby": "^0.2.15"
+      },
+      "peerDependencies": {
+        "typescript": "*"
+      }
+    },
+    "node_modules/@dxup/nuxt/node_modules/@nuxt/kit": {
+      "version": "4.4.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/kit/-/kit-4.4.2.tgz",
+      "integrity": "sha512-5+IPRNX2CjkBhuWUwz0hBuLqiaJPRoKzQ+SvcdrQDbAyE+VDeFt74VpSFr5/R0ujrK4b+XnSHUJWdS72w6hsog==",
+      "license": "MIT",
+      "dependencies": {
+        "c12": "^3.3.3",
+        "consola": "^3.4.2",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "errx": "^0.1.0",
+        "exsolve": "^1.0.8",
+        "ignore": "^7.0.5",
+        "jiti": "^2.6.1",
+        "klona": "^2.0.6",
+        "mlly": "^1.8.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0",
+        "rc9": "^3.0.0",
+        "scule": "^1.3.0",
+        "semver": "^7.7.4",
+        "tinyglobby": "^0.2.15",
+        "ufo": "^1.6.3",
+        "unctx": "^2.5.0",
+        "untyped": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/@dxup/unimport": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@dxup/unimport/-/unimport-0.1.2.tgz",
+      "integrity": "sha512-/B8YJGPzaYq1NbsQmwgP8EZqg40NpTw4ZB3suuI0TplbxKHeK94jeaawLmVhCv+YwUnOpiWEz9U6SeThku/8JQ==",
+      "license": "MIT"
+    },
+    "node_modules/@emnapi/core": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.9.1.tgz",
+      "integrity": "sha512-mukuNALVsoix/w1BJwFzwXBN/dHeejQtuVzcDsfOEsdpCumXb/E9j8w11h5S54tT1xhifGfbbSm/ICrObRb3KA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/wasi-threads": "1.2.0",
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@emnapi/runtime": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.9.1.tgz",
+      "integrity": "sha512-VYi5+ZVLhpgK4hQ0TAjiQiZ6ol0oe4mBx7mVv7IflsiEp0OWoVsp/+f9Vc1hOhE0TtkORVrI1GvzyreqpgWtkA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@emnapi/wasi-threads": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.0.tgz",
+      "integrity": "sha512-N10dEJNSsUx41Z6pZsXU8FjPjpBEplgH24sfkmITrBED1/U2Esum9F3lfLrMjKHHjmi557zQn7kR9R+XWXu5Rg==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.4.tgz",
+      "integrity": "sha512-cQPwL2mp2nSmHHJlCyoXgHGhbEPMrEEU5xhkcy3Hs/O7nGZqEpZ2sUtLaL9MORLtDfRvVl2/3PAuEkYZH0Ty8Q==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.4.tgz",
+      "integrity": "sha512-X9bUgvxiC8CHAGKYufLIHGXPJWnr0OCdR0anD2e21vdvgCI8lIfqFbnoeOz7lBjdrAGUhqLZLcQo6MLhTO2DKQ==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.4.tgz",
+      "integrity": "sha512-gdLscB7v75wRfu7QSm/zg6Rx29VLdy9eTr2t44sfTW7CxwAtQghZ4ZnqHk3/ogz7xao0QAgrkradbBzcqFPasw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.4.tgz",
+      "integrity": "sha512-PzPFnBNVF292sfpfhiyiXCGSn9HZg5BcAz+ivBuSsl6Rk4ga1oEXAamhOXRFyMcjwr2DVtm40G65N3GLeH1Lvw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.4.tgz",
+      "integrity": "sha512-b7xaGIwdJlht8ZFCvMkpDN6uiSmnxxK56N2GDTMYPr2/gzvfdQN8rTfBsvVKmIVY/X7EM+/hJKEIbbHs9oA4tQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.4.tgz",
+      "integrity": "sha512-sR+OiKLwd15nmCdqpXMnuJ9W2kpy0KigzqScqHI3Hqwr7IXxBp3Yva+yJwoqh7rE8V77tdoheRYataNKL4QrPw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-jnfpKe+p79tCnm4GVav68A7tUFeKQwQyLgESwEAUzyxk/TJr4QdGog9sqWNcUbr/bZt/O/HXouspuQDd9JxFSw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.4.tgz",
+      "integrity": "sha512-2kb4ceA/CpfUrIcTUl1wrP/9ad9Atrp5J94Lq69w7UwOMolPIGrfLSvAKJp0RTvkPPyn6CIWrNy13kyLikZRZQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.4.tgz",
+      "integrity": "sha512-aBYgcIxX/wd5n2ys0yESGeYMGF+pv6g0DhZr3G1ZG4jMfruU9Tl1i2Z+Wnj9/KjGz1lTLCcorqE2viePZqj4Eg==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.4.tgz",
+      "integrity": "sha512-7nQOttdzVGth1iz57kxg9uCz57dxQLHWxopL6mYuYthohPKEK0vU0C3O21CcBK6KDlkYVcnDXY099HcCDXd9dA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.4.tgz",
+      "integrity": "sha512-oPtixtAIzgvzYcKBQM/qZ3R+9TEUd1aNJQu0HhGyqtx6oS7qTpvjheIWBbes4+qu1bNlo2V4cbkISr8q6gRBFA==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.4.tgz",
+      "integrity": "sha512-8mL/vh8qeCoRcFH2nM8wm5uJP+ZcVYGGayMavi8GmRJjuI3g1v6Z7Ni0JJKAJW+m0EtUuARb6Lmp4hMjzCBWzA==",
+      "cpu": [
+        "loong64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.4.tgz",
+      "integrity": "sha512-1RdrWFFiiLIW7LQq9Q2NES+HiD4NyT8Itj9AUeCl0IVCA459WnPhREKgwrpaIfTOe+/2rdntisegiPWn/r/aAw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.4.tgz",
+      "integrity": "sha512-tLCwNG47l3sd9lpfyx9LAGEGItCUeRCWeAx6x2Jmbav65nAwoPXfewtAdtbtit/pJFLUWOhpv0FpS6GQAmPrHA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.4.tgz",
+      "integrity": "sha512-BnASypppbUWyqjd1KIpU4AUBiIhVr6YlHx/cnPgqEkNoVOhHg+YiSVxM1RLfiy4t9cAulbRGTNCKOcqHrEQLIw==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.4.tgz",
+      "integrity": "sha512-+eUqgb/Z7vxVLezG8bVB9SfBie89gMueS+I0xYh2tJdw3vqA/0ImZJ2ROeWwVJN59ihBeZ7Tu92dF/5dy5FttA==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.4.tgz",
+      "integrity": "sha512-S5qOXrKV8BQEzJPVxAwnryi2+Iq5pB40gTEIT69BQONqR7JH1EPIcQ/Uiv9mCnn05jff9umq/5nqzxlqTOg9NA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-xHT8X4sb0GS8qTqiwzHqpY00C95DPAq7nAwX35Ie/s+LO9830hrMd3oX0ZMKLvy7vsonee73x0lmcdOVXFzd6Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.4.tgz",
+      "integrity": "sha512-RugOvOdXfdyi5Tyv40kgQnI0byv66BFgAqjdgtAKqHoZTbTF2QqfQrFwa7cHEORJf6X2ht+l9ABLMP0dnKYsgg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-2MyL3IAaTX+1/qP0O1SwskwcwCoOI4kV2IBX1xYnDDqthmq5ArrW94qSIKCAuRraMgPOmG0RDTA74mzYNQA9ow==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.4.tgz",
+      "integrity": "sha512-u8fg/jQ5aQDfsnIV6+KwLOf1CmJnfu1ShpwqdwC0uA7ZPwFws55Ngc12vBdeUdnuWoQYx/SOQLGDcdlfXhYmXQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.4.tgz",
+      "integrity": "sha512-JkTZrl6VbyO8lDQO3yv26nNr2RM2yZzNrNHEsj9bm6dOwwu9OYN28CjzZkH57bh4w0I2F7IodpQvUAEd1mbWXg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.4.tgz",
+      "integrity": "sha512-/gOzgaewZJfeJTlsWhvUEmUG4tWEY2Spp5M20INYRg2ZKl9QPO3QEEgPeRtLjEWSW8FilRNacPOg8R1uaYkA6g==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.4.tgz",
+      "integrity": "sha512-Z9SExBg2y32smoDQdf1HRwHRt6vAHLXcxD2uGgO/v2jK7Y718Ix4ndsbNMU/+1Qiem9OiOdaqitioZwxivhXYg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.4.tgz",
+      "integrity": "sha512-DAyGLS0Jz5G5iixEbMHi5KdiApqHBWMGzTtMiJ72ZOLhbu/bzxgAe8Ue8CTS3n3HbIUHQz/L51yMdGMeoxXNJw==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.4.tgz",
+      "integrity": "sha512-+knoa0BDoeXgkNvvV1vvbZX4+hizelrkwmGJBdT17t8FNPwG2lKemmuMZlmaNQ3ws3DKKCxpb4zRZEIp3UxFCg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@intlify/core-base": {
+      "version": "11.4.10",
+      "resolved": "https://registry.npmjs.org/@intlify/core-base/-/core-base-11.4.10.tgz",
+      "integrity": "sha512-+yJ74JRWVJokdgG9zYNMyTSzeNV3O9T4vVxk8PvLFHmI+R/BYA//cITh7vhRK37hWLZ4/kTcKcUz1dlWOpypIg==",
+      "license": "MIT",
+      "dependencies": {
+        "@intlify/devtools-types": "11.4.10",
+        "@intlify/message-compiler": "11.4.10",
+        "@intlify/shared": "11.4.10"
+      },
+      "engines": {
+        "node": ">= 22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/kazupon"
+      }
+    },
+    "node_modules/@intlify/devtools-types": {
+      "version": "11.4.10",
+      "resolved": "https://registry.npmjs.org/@intlify/devtools-types/-/devtools-types-11.4.10.tgz",
+      "integrity": "sha512-xZxzZsAuu6/0zoLRVQWdpXWe5Kjl0LnWpjlQA3r9u9FbLYMhapqt7IwkgQyn0Tm2GUNAqhj9eZiUmYOrB024BQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@intlify/core-base": "11.4.10",
+        "@intlify/shared": "11.4.10"
+      },
+      "engines": {
+        "node": ">= 22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/kazupon"
+      }
+    },
+    "node_modules/@intlify/message-compiler": {
+      "version": "11.4.10",
+      "resolved": "https://registry.npmjs.org/@intlify/message-compiler/-/message-compiler-11.4.10.tgz",
+      "integrity": "sha512-oUB/scz2EJENXDiUJ7JjZffOrH8UIZ1BuZeHvonbi5fWLavLt04aivuk2OIByOZA0tsci1bkeeQRmwhb5M8Imw==",
+      "license": "MIT",
+      "dependencies": {
+        "@intlify/shared": "11.4.10",
+        "source-map-js": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/kazupon"
+      }
+    },
+    "node_modules/@intlify/shared": {
+      "version": "11.4.10",
+      "resolved": "https://registry.npmjs.org/@intlify/shared/-/shared-11.4.10.tgz",
+      "integrity": "sha512-FeImVdPeoSHTm3NBFFZHv0eRP9gQ3F4lj2puDBX5Kw7iiM1uJW6JTf39ian0K/17pbXCI3ef5i9RVsRrALqI6Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/kazupon"
+      }
+    },
+    "node_modules/@ioredis/commands": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/@ioredis/commands/-/commands-1.5.1.tgz",
+      "integrity": "sha512-JH8ZL/ywcJyR9MmJ5BNqZllXNZQqQbnVZOqpPQqE1vHiFgAw4NHbvE0FOduNU8IX9babitBT46571OnPTT0Zcw==",
+      "license": "MIT"
+    },
+    "node_modules/@isaacs/cliui": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
+      "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^5.1.2",
+        "string-width-cjs": "npm:string-width@^4.2.0",
+        "strip-ansi": "^7.0.1",
+        "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+        "wrap-ansi": "^8.1.0",
+        "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/emoji-regex": {
+      "version": "9.2.2",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+      "license": "MIT"
+    },
+    "node_modules/@isaacs/cliui/node_modules/string-width": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
+      "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+      "license": "MIT",
+      "dependencies": {
+        "eastasianwidth": "^0.2.0",
+        "emoji-regex": "^9.2.2",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/wrap-ansi": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
+      "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.1.0",
+        "string-width": "^5.0.1",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/@isaacs/fs-minipass": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@isaacs/fs-minipass/-/fs-minipass-4.0.1.tgz",
+      "integrity": "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==",
+      "license": "ISC",
+      "dependencies": {
+        "minipass": "^7.0.4"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@jridgewell/gen-mapping": {
+      "version": "0.3.13",
+      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/remapping": {
+      "version": "2.3.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/source-map": {
+      "version": "0.3.11",
+      "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.11.tgz",
+      "integrity": "sha512-ZMp1V8ZFcPG5dIWnQLr3NSI1MiCU7UETdS/A0G8V/XWHvJv3ZsFqutJn1Y5RPmAPX6F3BiE397OqveU/9NCuIA==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.25"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@kwsites/file-exists": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/@kwsites/file-exists/-/file-exists-1.1.1.tgz",
+      "integrity": "sha512-m9/5YGR18lIwxSFDwfE3oA7bWuq9kdau6ugN4H2rJeyhFQZcG9AgSHkQtSD15a8WvTgfz9aikZMrKPHvbpqFiw==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.1.1"
+      }
+    },
+    "node_modules/@kwsites/promise-deferred": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/@kwsites/promise-deferred/-/promise-deferred-1.1.1.tgz",
+      "integrity": "sha512-GaHYm+c0O9MjZRu0ongGBRbinu8gVAMd2UZjji6jVmqKtZluZnptXGWhz1E8j8D2HJ3f/yMxKAUC0b+57wncIw==",
+      "license": "MIT"
+    },
+    "node_modules/@mapbox/node-pre-gyp": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/@mapbox/node-pre-gyp/-/node-pre-gyp-2.0.3.tgz",
+      "integrity": "sha512-uwPAhccfFJlsfCxMYTwOdVfOz3xqyj8xYL3zJj8f0pb30tLohnnFPhLuqp4/qoEz8sNxe4SESZedcBojRefIzg==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "consola": "^3.2.3",
+        "detect-libc": "^2.0.0",
+        "https-proxy-agent": "^7.0.5",
+        "node-fetch": "^2.6.7",
+        "nopt": "^8.0.0",
+        "semver": "^7.5.3",
+        "tar": "^7.4.0"
+      },
+      "bin": {
+        "node-pre-gyp": "bin/node-pre-gyp"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@napi-rs/wasm-runtime": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.1.1.tgz",
+      "integrity": "sha512-p64ah1M1ld8xjWv3qbvFwHiFVWrq1yFvV4f7w+mzaqiR4IlSgkqhcRdHwsGgomwzBH51sRY4NEowLxnaBjcW/A==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@emnapi/core": "^1.7.1",
+        "@emnapi/runtime": "^1.7.1",
+        "@tybys/wasm-util": "^0.10.1"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@nodelib/fs.scandir": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
+      "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
+      "license": "MIT",
+      "dependencies": {
+        "@nodelib/fs.stat": "2.0.5",
+        "run-parallel": "^1.1.9"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.stat": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
+      "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.walk": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
+      "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
+      "license": "MIT",
+      "dependencies": {
+        "@nodelib/fs.scandir": "2.1.5",
+        "fastq": "^1.6.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nuxt/cli": {
+      "version": "3.34.0",
+      "resolved": "https://registry.npmjs.org/@nuxt/cli/-/cli-3.34.0.tgz",
+      "integrity": "sha512-KVI4xSo96UtUUbmxr9ouWTytbj1LzTw5alsM4vC/gSY/l8kPMRAlq0XpNSAVTDJyALzLY70WhaIMX24LJLpdFw==",
+      "license": "MIT",
+      "dependencies": {
+        "@bomb.sh/tab": "^0.0.14",
+        "@clack/prompts": "^1.1.0",
+        "c12": "^3.3.3",
+        "citty": "^0.2.1",
+        "confbox": "^0.2.4",
+        "consola": "^3.4.2",
+        "debug": "^4.4.3",
+        "defu": "^6.1.4",
+        "exsolve": "^1.0.8",
+        "fuse.js": "^7.1.0",
+        "fzf": "^0.5.2",
+        "giget": "^3.1.2",
+        "jiti": "^2.6.1",
+        "listhen": "^1.9.0",
+        "nypm": "^0.6.5",
+        "ofetch": "^1.5.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "perfect-debounce": "^2.1.0",
+        "pkg-types": "^2.3.0",
+        "scule": "^1.3.0",
+        "semver": "^7.7.4",
+        "srvx": "^0.11.9",
+        "std-env": "^3.10.0",
+        "tinyclip": "^0.1.12",
+        "tinyexec": "^1.0.2",
+        "ufo": "^1.6.3",
+        "youch": "^4.1.0"
+      },
+      "bin": {
+        "nuxi": "bin/nuxi.mjs",
+        "nuxi-ng": "bin/nuxi.mjs",
+        "nuxt": "bin/nuxi.mjs",
+        "nuxt-cli": "bin/nuxi.mjs"
+      },
+      "engines": {
+        "node": "^16.14.0 || >=18.0.0"
+      },
+      "peerDependencies": {
+        "@nuxt/schema": "^4.3.1"
+      },
+      "peerDependenciesMeta": {
+        "@nuxt/schema": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@nuxt/cli/node_modules/std-env": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz",
+      "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==",
+      "license": "MIT"
+    },
+    "node_modules/@nuxt/devalue": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/devalue/-/devalue-2.0.2.tgz",
+      "integrity": "sha512-GBzP8zOc7CGWyFQS6dv1lQz8VVpz5C2yRszbXufwG/9zhStTIH50EtD87NmWbTMwXDvZLNg8GIpb1UFdH93JCA==",
+      "license": "MIT"
+    },
+    "node_modules/@nuxt/devtools": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@nuxt/devtools/-/devtools-3.2.4.tgz",
+      "integrity": "sha512-VPbFy7hlPzWpEZk4BsuVpNuHq1ZYGV9xezjb7/NGuePuNLqeNn74YZugU+PCtva7OwKhEeTXmMK0Mqo/6+nwNA==",
+      "license": "MIT",
+      "dependencies": {
+        "@nuxt/devtools-kit": "3.2.4",
+        "@nuxt/devtools-wizard": "3.2.4",
+        "@nuxt/kit": "^4.4.2",
+        "@vue/devtools-core": "^8.1.0",
+        "@vue/devtools-kit": "^8.1.0",
+        "birpc": "^4.0.0",
+        "consola": "^3.4.2",
+        "destr": "^2.0.5",
+        "error-stack-parser-es": "^1.0.5",
+        "execa": "^8.0.1",
+        "fast-npm-meta": "^1.4.2",
+        "get-port-please": "^3.2.0",
+        "hookable": "^6.1.0",
+        "image-meta": "^0.2.2",
+        "is-installed-globally": "^1.0.0",
+        "launch-editor": "^2.13.1",
+        "local-pkg": "^1.1.2",
+        "magicast": "^0.5.2",
+        "nypm": "^0.6.5",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "perfect-debounce": "^2.1.0",
+        "pkg-types": "^2.3.0",
+        "semver": "^7.7.4",
+        "simple-git": "^3.33.0",
+        "sirv": "^3.0.2",
+        "structured-clone-es": "^2.0.0",
+        "tinyglobby": "^0.2.15",
+        "vite-plugin-inspect": "^11.3.3",
+        "vite-plugin-vue-tracer": "^1.3.0",
+        "which": "^6.0.1",
+        "ws": "^8.19.0"
+      },
+      "bin": {
+        "devtools": "cli.mjs"
+      },
+      "peerDependencies": {
+        "@vitejs/devtools": "*",
+        "vite": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "@vitejs/devtools": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@nuxt/devtools-kit": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@nuxt/devtools-kit/-/devtools-kit-3.2.4.tgz",
+      "integrity": "sha512-Yxy2Xgmq5hf3dQy983V0xh0OJV2mYwRZz9eVIGc3EaribdFGPDNGMMbYqX9qCty3Pbxn/bCF3J0UyPaNlHVayQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@nuxt/kit": "^4.4.2",
+        "execa": "^8.0.1"
+      },
+      "peerDependencies": {
+        "vite": ">=6.0"
+      }
+    },
+    "node_modules/@nuxt/devtools-kit/node_modules/@nuxt/kit": {
+      "version": "4.4.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/kit/-/kit-4.4.2.tgz",
+      "integrity": "sha512-5+IPRNX2CjkBhuWUwz0hBuLqiaJPRoKzQ+SvcdrQDbAyE+VDeFt74VpSFr5/R0ujrK4b+XnSHUJWdS72w6hsog==",
+      "license": "MIT",
+      "dependencies": {
+        "c12": "^3.3.3",
+        "consola": "^3.4.2",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "errx": "^0.1.0",
+        "exsolve": "^1.0.8",
+        "ignore": "^7.0.5",
+        "jiti": "^2.6.1",
+        "klona": "^2.0.6",
+        "mlly": "^1.8.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0",
+        "rc9": "^3.0.0",
+        "scule": "^1.3.0",
+        "semver": "^7.7.4",
+        "tinyglobby": "^0.2.15",
+        "ufo": "^1.6.3",
+        "unctx": "^2.5.0",
+        "untyped": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/@nuxt/devtools-wizard": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/@nuxt/devtools-wizard/-/devtools-wizard-3.2.4.tgz",
+      "integrity": "sha512-5tu2+Quu9XTxwtpzM8CUN0UKn/bzZIfJcoGd+at5Yy1RiUQJ4E52tRK0idW1rMSUDkbkvX3dSnu8Tpj7SAtWdQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@clack/prompts": "^1.1.0",
+        "consola": "^3.4.2",
+        "diff": "^8.0.3",
+        "execa": "^8.0.1",
+        "magicast": "^0.5.2",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0",
+        "semver": "^7.7.4"
+      },
+      "bin": {
+        "devtools-wizard": "cli.mjs"
+      }
+    },
+    "node_modules/@nuxt/devtools/node_modules/@nuxt/kit": {
+      "version": "4.4.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/kit/-/kit-4.4.2.tgz",
+      "integrity": "sha512-5+IPRNX2CjkBhuWUwz0hBuLqiaJPRoKzQ+SvcdrQDbAyE+VDeFt74VpSFr5/R0ujrK4b+XnSHUJWdS72w6hsog==",
+      "license": "MIT",
+      "dependencies": {
+        "c12": "^3.3.3",
+        "consola": "^3.4.2",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "errx": "^0.1.0",
+        "exsolve": "^1.0.8",
+        "ignore": "^7.0.5",
+        "jiti": "^2.6.1",
+        "klona": "^2.0.6",
+        "mlly": "^1.8.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0",
+        "rc9": "^3.0.0",
+        "scule": "^1.3.0",
+        "semver": "^7.7.4",
+        "tinyglobby": "^0.2.15",
+        "ufo": "^1.6.3",
+        "unctx": "^2.5.0",
+        "untyped": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/@nuxt/devtools/node_modules/hookable": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/hookable/-/hookable-6.1.0.tgz",
+      "integrity": "sha512-ZoKZSJgu8voGK2geJS+6YtYjvIzu9AOM/KZXsBxr83uhLL++e9pEv/dlgwgy3dvHg06kTz6JOh1hk3C8Ceiymw==",
+      "license": "MIT"
+    },
+    "node_modules/@nuxt/kit": {
+      "version": "3.21.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/kit/-/kit-3.21.2.tgz",
+      "integrity": "sha512-Bd6m6mrDrqpBEbX+g0rc66/ALd1sxlgdx5nfK9MAYO0yKLTOSK7McSYz1KcOYn3LQFCXOWfvXwaqih/b+REI1g==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "c12": "^3.3.3",
+        "consola": "^3.4.2",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "errx": "^0.1.0",
+        "exsolve": "^1.0.8",
+        "ignore": "^7.0.5",
+        "jiti": "^2.6.1",
+        "klona": "^2.0.6",
+        "knitwork": "^1.3.0",
+        "mlly": "^1.8.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0",
+        "rc9": "^3.0.0",
+        "scule": "^1.3.0",
+        "semver": "^7.7.4",
+        "tinyglobby": "^0.2.15",
+        "ufo": "^1.6.3",
+        "unctx": "^2.5.0",
+        "untyped": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/@nuxt/nitro-server": {
+      "version": "3.21.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/nitro-server/-/nitro-server-3.21.2.tgz",
+      "integrity": "sha512-tJiyrG+chze1JP1JNDFR2Ib+EhnMzmZXW7AmW7Wbxz2LLTSapLzJCLgHcy4OBcBK22bs06bI/ivn95JNvvxWbQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@nuxt/devalue": "^2.0.2",
+        "@nuxt/kit": "3.21.2",
+        "@unhead/vue": "^2.1.12",
+        "@vue/shared": "^3.5.30",
+        "consola": "^3.4.2",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "devalue": "^5.6.3",
+        "errx": "^0.1.0",
+        "escape-string-regexp": "^5.0.0",
+        "exsolve": "^1.0.8",
+        "h3": "^1.15.6",
+        "impound": "^1.1.5",
+        "klona": "^2.0.6",
+        "mocked-exports": "^0.1.1",
+        "nitropack": "^2.13.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0",
+        "rou3": "^0.8.1",
+        "std-env": "^4.0.0",
+        "ufo": "^1.6.3",
+        "unctx": "^2.5.0",
+        "unstorage": "^1.17.4",
+        "vue": "^3.5.30",
+        "vue-bundle-renderer": "^2.2.0",
+        "vue-devtools-stub": "^0.1.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "nuxt": "^3.21.2"
+      }
+    },
+    "node_modules/@nuxt/telemetry": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/@nuxt/telemetry/-/telemetry-2.7.0.tgz",
+      "integrity": "sha512-mrKC3NjAlBOooLLVTYcIUie1meipoYq5vkoESoVTEWTB34T3a0QJzOfOPch+HYlUR+5Lqy1zLMv6epHFgYAKLA==",
+      "license": "MIT",
+      "dependencies": {
+        "citty": "^0.2.0",
+        "consola": "^3.4.2",
+        "ofetch": "^2.0.0-alpha.3",
+        "rc9": "^3.0.0",
+        "std-env": "^3.10.0"
+      },
+      "bin": {
+        "nuxt-telemetry": "bin/nuxt-telemetry.mjs"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      },
+      "peerDependencies": {
+        "@nuxt/kit": ">=3.0.0"
+      }
+    },
+    "node_modules/@nuxt/telemetry/node_modules/ofetch": {
+      "version": "2.0.0-alpha.3",
+      "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-2.0.0-alpha.3.tgz",
+      "integrity": "sha512-zpYTCs2byOuft65vI3z43Dd6iSdFbOZZLb9/d21aCpx2rGastVU9dOCv0lu4ykc1Ur1anAYjDi3SUvR0vq50JA==",
+      "license": "MIT"
+    },
+    "node_modules/@nuxt/telemetry/node_modules/std-env": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz",
+      "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==",
+      "license": "MIT"
+    },
+    "node_modules/@nuxt/vite-builder": {
+      "version": "3.21.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/vite-builder/-/vite-builder-3.21.2.tgz",
+      "integrity": "sha512-AwfvmogMzBmX8oS8QPjh9uZiUtnWmOV8w4Ei4DMukVELemkRugDOqWzCzuFneOFQ8khhOOMZ/lRcoTiPryZS5A==",
+      "license": "MIT",
+      "dependencies": {
+        "@nuxt/kit": "3.21.2",
+        "@rollup/plugin-replace": "^6.0.3",
+        "@vitejs/plugin-vue": "^6.0.4",
+        "@vitejs/plugin-vue-jsx": "^5.1.4",
+        "autoprefixer": "^10.4.27",
+        "consola": "^3.4.2",
+        "cssnano": "^7.1.3",
+        "defu": "^6.1.4",
+        "escape-string-regexp": "^5.0.0",
+        "exsolve": "^1.0.8",
+        "externality": "^1.0.2",
+        "get-port-please": "^3.2.0",
+        "jiti": "^2.6.1",
+        "knitwork": "^1.3.0",
+        "magic-string": "^0.30.21",
+        "mlly": "^1.8.1",
+        "mocked-exports": "^0.1.1",
+        "nypm": "^0.6.5",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "perfect-debounce": "^2.1.0",
+        "pkg-types": "^2.3.0",
+        "postcss": "^8.5.8",
+        "seroval": "^1.5.1",
+        "std-env": "^4.0.0",
+        "ufo": "^1.6.3",
+        "unenv": "^2.0.0-rc.24",
+        "vite": "^7.3.1",
+        "vite-node": "^5.3.0",
+        "vite-plugin-checker": "^0.12.0",
+        "vue-bundle-renderer": "^2.2.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "nuxt": "3.21.2",
+        "rolldown": "^1.0.0-beta.38",
+        "rollup-plugin-visualizer": "^6.0.0 || ^7.0.1",
+        "vue": "^3.3.4"
+      },
+      "peerDependenciesMeta": {
+        "rolldown": {
+          "optional": true
+        },
+        "rollup-plugin-visualizer": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@oxc-minify/binding-android-arm-eabi": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-android-arm-eabi/-/binding-android-arm-eabi-0.117.0.tgz",
+      "integrity": "sha512-5Hf2KsGRjxp3HnPU/mse7cQJa5tWfMFUPZQcgSMVsv2JZnGFFOIDzA0Oja2KDD+VPJqMpEJKc2dCHAGZgJxsGg==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-android-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-android-arm64/-/binding-android-arm64-0.117.0.tgz",
+      "integrity": "sha512-uuxGwxA5J4Sap+gz4nxyM/rer6q2A4X1Oe8HpE0CZQyb5cSBULQ15btZiVG3xOBctI5O+c2dwR1aZAP4oGKcLw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-darwin-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-darwin-arm64/-/binding-darwin-arm64-0.117.0.tgz",
+      "integrity": "sha512-lLBf75cxUSLydumToKtGTwbLqO/1urScblJ33Vx0uF38M2ZbL2x51AybBV5vlfLjYNrxvQ8ov0Bj/OhsVO/biA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-darwin-x64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-darwin-x64/-/binding-darwin-x64-0.117.0.tgz",
+      "integrity": "sha512-wBWwP1voLZMuN4hpe1HRtkPBd4/o/1qan5XssmmI/hewBvGHEHkyvVLS0zu+cKqXDxYzYvb/p+EqU+xSXhEl4A==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-freebsd-x64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-freebsd-x64/-/binding-freebsd-x64-0.117.0.tgz",
+      "integrity": "sha512-pYSacHw698oH2vb70iP1cHk6x0zhvAuOvdskvNtEqvfziu8MSjKXa699vA9Cx72+DH5rwVuj1I3f+7no2fWglA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-arm-gnueabihf": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-0.117.0.tgz",
+      "integrity": "sha512-Ugm4Qj7F2+bccjhHCjjnSNHBDPyvjPXWrntID4WJpSrPqt+Az/o0EGdty9sWOjQXRZiTVpa80uqCWZQUn94yTA==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-arm-musleabihf": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-arm-musleabihf/-/binding-linux-arm-musleabihf-0.117.0.tgz",
+      "integrity": "sha512-qrY6ZviO9wVRI/jl4nRZO4B9os8jaJQemMeWIyFInZNk3lhqihId8iBqMKibJnRaf+JRxLM9j68atXkFRhOHrg==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-arm64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-0.117.0.tgz",
+      "integrity": "sha512-2VLJHKEFBRhCihT/8uesuDPhXpbWu1OlHCxqQ7pdFVqKik1Maj5E9oSDcYzxqfaCRStvTHkmLVWJBK5CVcIadg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-arm64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-arm64-musl/-/binding-linux-arm64-musl-0.117.0.tgz",
+      "integrity": "sha512-C3zapJconWpl2Y7LR3GkRkH6jxpuV2iVUfkFcHT5Ffn4Zu7l88mZa2dhcfdULZDybN1Phka/P34YUzuskUUrXw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-ppc64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-0.117.0.tgz",
+      "integrity": "sha512-2T/Bm+3/qTfuNS4gKSzL8qbiYk+ErHW2122CtDx+ilZAzvWcJ8IbqdZIbEWOlwwe03lESTxPwTBLFqVgQU2OeQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-riscv64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-riscv64-gnu/-/binding-linux-riscv64-gnu-0.117.0.tgz",
+      "integrity": "sha512-MKLjpldYkeoB4T+yAi4aIAb0waifxUjLcKkCUDmYAY3RqBJTvWK34KtfaKZL0IBMIXfD92CbKkcxQirDUS9Xcg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-riscv64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-riscv64-musl/-/binding-linux-riscv64-musl-0.117.0.tgz",
+      "integrity": "sha512-UFVcbPvKUStry6JffriobBp8BHtjmLLPl4bCY+JMxIn/Q3pykCpZzRwFTcDurG/kY8tm+uSNfKKdRNa5Nh9A7g==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-s390x-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-0.117.0.tgz",
+      "integrity": "sha512-B9GyPQ1NKbvpETVAMyJMfRlD3c6UJ7kiuFUAlx9LTYiQL+YIyT6vpuRlq1zgsXxavZluVrfeJv6x0owV4KDx4Q==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-x64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-x64-gnu/-/binding-linux-x64-gnu-0.117.0.tgz",
+      "integrity": "sha512-fXfhtr+WWBGNy4M5GjAF5vu/lpulR4Me34FjTyaK9nDrTZs7LM595UDsP1wliksqp4hD/KdoqHGmbCrC+6d4vA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-linux-x64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-linux-x64-musl/-/binding-linux-x64-musl-0.117.0.tgz",
+      "integrity": "sha512-jFBgGbx1oLadb83ntJmy1dWlAHSQanXTS21G4PgkxyONmxZdZ/UMKr7KsADzMuoPsd2YhJHxzRpwJd9U+4BFBw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-openharmony-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-openharmony-arm64/-/binding-openharmony-arm64-0.117.0.tgz",
+      "integrity": "sha512-nxPd9vx1vYz8IlIMdl9HFdOK/ood1H5hzbSFsyO8JU55tkcJoBL8TLCbuFf9pHpOy27l2gcPyV6z3p4eAcTH5Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-wasm32-wasi": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-wasm32-wasi/-/binding-wasm32-wasi-0.117.0.tgz",
+      "integrity": "sha512-pSvjJ6cCCfEXSteWSiVfZhdRzvpmS3tLhlXrXTYiuTDFrkRCobRP39SRwAzK23rE9i/m2JAaES2xPEW6+xu85g==",
+      "cpu": [
+        "wasm32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@napi-rs/wasm-runtime": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-win32-arm64-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-0.117.0.tgz",
+      "integrity": "sha512-9NoT9baFrWPdJRIZVQ1jzPZW9TjPT2sbzQyDdoK7uD1V8JXCe1L2y7sp9k2ldZZheaIcmtNwHc7jyD7kYz/0XQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-win32-ia32-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-win32-ia32-msvc/-/binding-win32-ia32-msvc-0.117.0.tgz",
+      "integrity": "sha512-E51LTjkRei5u2dpFiYSObuh+e43xg45qlmilSTd0XDGFdYJCOv62Q0MEn61TR+efQYPNleYwWdTS9t+tp9p/4w==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-minify/binding-win32-x64-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-minify/binding-win32-x64-msvc/-/binding-win32-x64-msvc-0.117.0.tgz",
+      "integrity": "sha512-I8vniPOxWQdxfIbXNvQLaJ1n8SrnqES6wuiAX10CU72sKsizkds9kDaJ1KzWvDy39RKhTBmD1cJsU2uxPFgizQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-android-arm-eabi": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-android-arm-eabi/-/binding-android-arm-eabi-0.117.0.tgz",
+      "integrity": "sha512-XarGPJpaobgKjfm7xRfCGWWszuPbm/OeP91NdMhxtcLZ/qLTmWF0P0z0gqmr0Uysi1F1v1BNtcST11THMrcEOw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-android-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-android-arm64/-/binding-android-arm64-0.117.0.tgz",
+      "integrity": "sha512-EPTs2EBijGmyhPso4rXAL0NSpECXER9IaVKFZEv83YcA6h4uhKW47kmYt+OZcSp130zhHx+lTWILDQ/LDkCRNA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-darwin-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-darwin-arm64/-/binding-darwin-arm64-0.117.0.tgz",
+      "integrity": "sha512-3bAEpyih6r/Kb+Xzn1em1qBMClOS7NsVWgF86k95jpysR5ix/HlKFKSy7cax6PcS96HeHR4kjlME20n/XK1zNg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-darwin-x64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-darwin-x64/-/binding-darwin-x64-0.117.0.tgz",
+      "integrity": "sha512-W7S99zFwVZhSbCxvjfZkioStFU249DBc4TJw/kK6kfKwx2Zew+jvizX5Y3ZPkAh7fBVUSNOdSeOqLBHLiP50tw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-freebsd-x64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-freebsd-x64/-/binding-freebsd-x64-0.117.0.tgz",
+      "integrity": "sha512-xH76lqSdjCSY0KUMPwLXlvQ3YEm3FFVEQmgiOCGNf+stZ6E4Mo3nC102Bo8yKd7aW0foIPAFLYsHgj7vVI/axw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm-gnueabihf": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-0.117.0.tgz",
+      "integrity": "sha512-9Hdm1imzrn4RdMYnQKKcy+7p7QsSPIrgVIZmpGSJT02nYDuBWLdG1pdYMPFoEo46yiXry3tS3RoHIpNbT1IiyQ==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm-musleabihf": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm-musleabihf/-/binding-linux-arm-musleabihf-0.117.0.tgz",
+      "integrity": "sha512-Itszer/VCeYhYVJLcuKnHktlY8QyGnVxapltP68S1XRGlV6IsM9HQAElJRMwQhT6/GkMjOhANmkv2Qu/9v44lw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-0.117.0.tgz",
+      "integrity": "sha512-jBxD7DtlHQ36ivjjZdH0noQJgWNouenzpLmXNKnYaCsBfo3jY95m5iyjYQEiWkvkhJ3TJUAs7tQ1/kEpY7x/Kg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-arm64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-arm64-musl/-/binding-linux-arm64-musl-0.117.0.tgz",
+      "integrity": "sha512-QagKTDF4lrz8bCXbUi39Uq5xs7C7itAseKm51f33U+Dyar9eJY/zGKqfME9mKLOiahX7Fc1J3xMWVS0AdDXLPg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-ppc64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-0.117.0.tgz",
+      "integrity": "sha512-RPddpcE/0xxWaommWy0c5i/JdrXcXAkxBS2GOrAUh5LKmyCh03hpJedOAWszG4ADsKQwoUQQ1/tZVGRhZIWtKA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-riscv64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-riscv64-gnu/-/binding-linux-riscv64-gnu-0.117.0.tgz",
+      "integrity": "sha512-ur/WVZF9FSOiZGxyP+nfxZzuv6r5OJDYoVxJnUR7fM/hhXLh4V/be6rjbzm9KLCDBRwYCEKJtt+XXNccwd06IA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-riscv64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-riscv64-musl/-/binding-linux-riscv64-musl-0.117.0.tgz",
+      "integrity": "sha512-ujGcAx8xAMvhy7X5sBFi3GXML1EtyORuJZ5z2T6UV3U416WgDX/4OCi3GnoteeenvxIf6JgP45B+YTHpt71vpA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-s390x-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-0.117.0.tgz",
+      "integrity": "sha512-hbsfKjUwRjcMZZvvmpZSc+qS0bHcHRu8aV/I3Ikn9BzOA0ZAgUE7ctPtce5zCU7bM8dnTLi4sJ1Pi9YHdx6Urw==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-x64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-x64-gnu/-/binding-linux-x64-gnu-0.117.0.tgz",
+      "integrity": "sha512-1QrTrf8rige7UPJrYuDKJLQOuJlgkt+nRSJLBMHWNm9TdivzP48HaK3f4q18EjNlglKtn03lgjMu4fryDm8X4A==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-linux-x64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-linux-x64-musl/-/binding-linux-x64-musl-0.117.0.tgz",
+      "integrity": "sha512-gRvK6HPzF5ITRL68fqb2WYYs/hGviPIbkV84HWCgiJX+LkaOpp+HIHQl3zVZdyKHwopXToTbXbtx/oFjDjl8pg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-openharmony-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-openharmony-arm64/-/binding-openharmony-arm64-0.117.0.tgz",
+      "integrity": "sha512-QPJvFbnnDZZY7xc+xpbIBWLThcGBakwaYA9vKV8b3+oS5MGfAZUoTFJcix5+Zg2Ri46sOfrUim6Y6jsKNcssAQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-wasm32-wasi": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-wasm32-wasi/-/binding-wasm32-wasi-0.117.0.tgz",
+      "integrity": "sha512-+XRSNA0xt3pk/6CUHM7pykVe7M8SdifJk8LX1+fIp/zefvR3HBieZCbwG5un8gogNgh7srLycoh/cQA9uozv5g==",
+      "cpu": [
+        "wasm32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@napi-rs/wasm-runtime": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-win32-arm64-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-0.117.0.tgz",
+      "integrity": "sha512-GpxeGS+Vo030DsrXeRPc7OSJOQIyAHkM3mzwBcnQjg/79XnOIDDMXJ5X6/aNdkVt/+Pv35pqKzGA4TQau97x8w==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-win32-ia32-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-win32-ia32-msvc/-/binding-win32-ia32-msvc-0.117.0.tgz",
+      "integrity": "sha512-tchWEYiso1+objTZirmlR+w3fcIel6PVBOJ8NuC2Jr30dxBOiKUfFLovJLANwHg1+TzeD6pVSLIIIEf2T5o5lQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-parser/binding-win32-x64-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-parser/binding-win32-x64-msvc/-/binding-win32-x64-msvc-0.117.0.tgz",
+      "integrity": "sha512-ysRJAjIbB4e5y+t9PZs7TwbgOV/GVT//s30AORLCT/pedYwpYzHq6ApXK7is9fvyfZtgT3anNir8+esurmyaDw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-project/types": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.117.0.tgz",
+      "integrity": "sha512-C/kPXBphID44fXdsa2xSOCuzX8fKZiFxPsvucJ6Yfkr6CJlMA+kNLPNKyLoI+l9XlDsNxBrz6h7IIjKU8pB69w==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/Boshen"
+      }
+    },
+    "node_modules/@oxc-transform/binding-android-arm-eabi": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-android-arm-eabi/-/binding-android-arm-eabi-0.117.0.tgz",
+      "integrity": "sha512-17giX7h5VR9Eodru4OoSCFdgwLFIaUxeEn8JWe0vMZrAuRbT9NiDTy5dXdbGQBoO8aXPkbGS38FGlvbi31aujw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-android-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-android-arm64/-/binding-android-arm64-0.117.0.tgz",
+      "integrity": "sha512-1LrDd1CPochtLx04pAafdah6QtOQQj0/Evttevi+0u8rCI5FKucIG7pqBHkIQi/y7pycFYIj+GebhET80maeUg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-darwin-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-darwin-arm64/-/binding-darwin-arm64-0.117.0.tgz",
+      "integrity": "sha512-K1Xo52xJOvFfHSkz2ax9X5Qsku23RCfTIPbHZWdUCAQ1TQooI+sFcewSubhVUJ4DVK12/tYT//XXboumin+FHA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-darwin-x64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-darwin-x64/-/binding-darwin-x64-0.117.0.tgz",
+      "integrity": "sha512-ftFT/8Laolfq49mRRWLkIhd1AbJ0MI5bW3LwddvdoAg9zXwkx4qhzTYyBPRZhvXWftts+NjlHfHsXCOqI4tPtw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-freebsd-x64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-freebsd-x64/-/binding-freebsd-x64-0.117.0.tgz",
+      "integrity": "sha512-QDRyw0atg9BMnwOwnJeW6REzWPLEjiWtsCc2Sj612F1hCdvP+n0L3o8sHinEWM+BiOkOYtUxHA69WjUslc3G+g==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-arm-gnueabihf": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-0.117.0.tgz",
+      "integrity": "sha512-UvpvOjyQVgiIJahIpMT0qAsLJT8O1ibHTBgXGOsZkQgw1xmjARPQ07dpRcucPPn6cqCF3wrxfbqtr2vFHaMkdA==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-arm-musleabihf": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-arm-musleabihf/-/binding-linux-arm-musleabihf-0.117.0.tgz",
+      "integrity": "sha512-cIhztGFjKk8ngP+/7EPkEhzWMGr2neezxgWirSn/f/MirjH234oHHGJ2diKIbGQEsy0aOuJMTkL9NLfzfmH51A==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-arm64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-0.117.0.tgz",
+      "integrity": "sha512-mXbDfvDN0RZVg7v4LohNzU0kK3fMAZgkUKTkpFVgxEvzibEG5VpSznkypUwHI4a8U8pz+K6mGaLetX3Xt+CvvA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-arm64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-arm64-musl/-/binding-linux-arm64-musl-0.117.0.tgz",
+      "integrity": "sha512-ykxpPQp0eAcSmhy0Y3qKvdanHY4d8THPonDfmCoktUXb6r0X6qnjpJB3V+taN1wevW55bOEZd97kxtjTKjqhmg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-ppc64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-0.117.0.tgz",
+      "integrity": "sha512-Rvspti4Kr7eq6zSrURK5WjscfWQPvmy/KjJZV45neRKW8RLonE3r9+NgrwSLGoHvQ3F24fbqlkplox1RtlhH5A==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-riscv64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-riscv64-gnu/-/binding-linux-riscv64-gnu-0.117.0.tgz",
+      "integrity": "sha512-Dr2ZW9ZZ4l1eQ5JUEUY3smBh4JFPCPuybWaDZTLn3ADZjyd8ZtNXEjeMT8rQbbhbgSL9hEgbwaqraole3FNThQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-riscv64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-riscv64-musl/-/binding-linux-riscv64-musl-0.117.0.tgz",
+      "integrity": "sha512-oD1Bnes1bIC3LVBSrWEoSUBj6fvatESPwAVWfJVGVQlqWuOs/ZBn1e4Nmbipo3KGPHK7DJY75r/j7CQCxhrOFQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-s390x-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-0.117.0.tgz",
+      "integrity": "sha512-qT//IAPLvse844t99Kff5j055qEbXfwzWgvCMb0FyjisnB8foy25iHZxZIocNBe6qwrCYWUP1M8rNrB/WyfS1Q==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-x64-gnu": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-x64-gnu/-/binding-linux-x64-gnu-0.117.0.tgz",
+      "integrity": "sha512-2YEO5X+KgNzFqRVO5dAkhjcI5gwxus4NSWVl/+cs2sI6P0MNPjqE3VWPawl4RTC11LvetiiZdHcujUCPM8aaUw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-linux-x64-musl": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-linux-x64-musl/-/binding-linux-x64-musl-0.117.0.tgz",
+      "integrity": "sha512-3wqWbTSaIFZvDr1aqmTul4cg8PRWYh6VC52E8bLI7ytgS/BwJLW+sDUU2YaGIds4sAf/1yKeJRmudRCDPW9INg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-openharmony-arm64": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-openharmony-arm64/-/binding-openharmony-arm64-0.117.0.tgz",
+      "integrity": "sha512-Ebxx6NPqhzlrjvx4+PdSqbOq+li0f7X59XtJljDghkbJsbnkHvhLmPR09ifHt5X32UlZN63ekjwcg/nbmHLLlA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-wasm32-wasi": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-wasm32-wasi/-/binding-wasm32-wasi-0.117.0.tgz",
+      "integrity": "sha512-Nn8mmcBiQ0XKHLTb05QBlH+CDkn7jf5YDVv9FtKhy4zJT0NEU9y3dXVbfcurOpsVrG9me4ktzDQNCaAoJjUQyw==",
+      "cpu": [
+        "wasm32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@napi-rs/wasm-runtime": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-win32-arm64-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-0.117.0.tgz",
+      "integrity": "sha512-15cbsF8diXWGnHrTsVgVeabETiT/KdMAfRAcot99xsaVecJs3pITNNjC6Qj+/TPNpehbgIFjlhhxOVSbQsTBgg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-win32-ia32-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-win32-ia32-msvc/-/binding-win32-ia32-msvc-0.117.0.tgz",
+      "integrity": "sha512-I6DkhCuFX6p9rckdWiLuZfBWrrYUC7sNX+zLaCfa5zvrPNwo1/29KkefvqXVxu3AWT/6oZAbtc0A8/mqhETJPQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@oxc-transform/binding-win32-x64-msvc": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/@oxc-transform/binding-win32-x64-msvc/-/binding-win32-x64-msvc-0.117.0.tgz",
+      "integrity": "sha512-V7YzavQnYcRJBeJkp0qpb3FKrlm5I57XJetCYB4jsjStuboQmnFMZ/XQH55Szlf/kVyeU9ddQwv72gJJ5BrGjQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/@parcel/watcher": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher/-/watcher-2.5.6.tgz",
+      "integrity": "sha512-tmmZ3lQxAe/k/+rNnXQRawJ4NjxO2hqiOLTHvWchtGZULp4RyFeh6aU4XdOYBFe2KE1oShQTv4AblOs2iOrNnQ==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "detect-libc": "^2.0.3",
+        "is-glob": "^4.0.3",
+        "node-addon-api": "^7.0.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      },
+      "optionalDependencies": {
+        "@parcel/watcher-android-arm64": "2.5.6",
+        "@parcel/watcher-darwin-arm64": "2.5.6",
+        "@parcel/watcher-darwin-x64": "2.5.6",
+        "@parcel/watcher-freebsd-x64": "2.5.6",
+        "@parcel/watcher-linux-arm-glibc": "2.5.6",
+        "@parcel/watcher-linux-arm-musl": "2.5.6",
+        "@parcel/watcher-linux-arm64-glibc": "2.5.6",
+        "@parcel/watcher-linux-arm64-musl": "2.5.6",
+        "@parcel/watcher-linux-x64-glibc": "2.5.6",
+        "@parcel/watcher-linux-x64-musl": "2.5.6",
+        "@parcel/watcher-win32-arm64": "2.5.6",
+        "@parcel/watcher-win32-ia32": "2.5.6",
+        "@parcel/watcher-win32-x64": "2.5.6"
+      }
+    },
+    "node_modules/@parcel/watcher-android-arm64": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-android-arm64/-/watcher-android-arm64-2.5.6.tgz",
+      "integrity": "sha512-YQxSS34tPF/6ZG7r/Ih9xy+kP/WwediEUsqmtf0cuCV5TPPKw/PQHRhueUo6JdeFJaqV3pyjm0GdYjZotbRt/A==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-darwin-arm64": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-darwin-arm64/-/watcher-darwin-arm64-2.5.6.tgz",
+      "integrity": "sha512-Z2ZdrnwyXvvvdtRHLmM4knydIdU9adO3D4n/0cVipF3rRiwP+3/sfzpAwA/qKFL6i1ModaabkU7IbpeMBgiVEA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-darwin-x64": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-darwin-x64/-/watcher-darwin-x64-2.5.6.tgz",
+      "integrity": "sha512-HgvOf3W9dhithcwOWX9uDZyn1lW9R+7tPZ4sug+NGrGIo4Rk1hAXLEbcH1TQSqxts0NYXXlOWqVpvS1SFS4fRg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-freebsd-x64": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-freebsd-x64/-/watcher-freebsd-x64-2.5.6.tgz",
+      "integrity": "sha512-vJVi8yd/qzJxEKHkeemh7w3YAn6RJCtYlE4HPMoVnCpIXEzSrxErBW5SJBgKLbXU3WdIpkjBTeUNtyBVn8TRng==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm-glibc": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm-glibc/-/watcher-linux-arm-glibc-2.5.6.tgz",
+      "integrity": "sha512-9JiYfB6h6BgV50CCfasfLf/uvOcJskMSwcdH1PHH9rvS1IrNy8zad6IUVPVUfmXr+u+Km9IxcfMLzgdOudz9EQ==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm-musl": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm-musl/-/watcher-linux-arm-musl-2.5.6.tgz",
+      "integrity": "sha512-Ve3gUCG57nuUUSyjBq/MAM0CzArtuIOxsBdQ+ftz6ho8n7s1i9E1Nmk/xmP323r2YL0SONs1EuwqBp2u1k5fxg==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm64-glibc": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm64-glibc/-/watcher-linux-arm64-glibc-2.5.6.tgz",
+      "integrity": "sha512-f2g/DT3NhGPdBmMWYoxixqYr3v/UXcmLOYy16Bx0TM20Tchduwr4EaCbmxh1321TABqPGDpS8D/ggOTaljijOA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm64-musl": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm64-musl/-/watcher-linux-arm64-musl-2.5.6.tgz",
+      "integrity": "sha512-qb6naMDGlbCwdhLj6hgoVKJl2odL34z2sqkC7Z6kzir8b5W65WYDpLB6R06KabvZdgoHI/zxke4b3zR0wAbDTA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-x64-glibc": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-x64-glibc/-/watcher-linux-x64-glibc-2.5.6.tgz",
+      "integrity": "sha512-kbT5wvNQlx7NaGjzPFu8nVIW1rWqV780O7ZtkjuWaPUgpv2NMFpjYERVi0UYj1msZNyCzGlaCWEtzc+exjMGbQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-x64-musl": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-x64-musl/-/watcher-linux-x64-musl-2.5.6.tgz",
+      "integrity": "sha512-1JRFeC+h7RdXwldHzTsmdtYR/Ku8SylLgTU/reMuqdVD7CtLwf0VR1FqeprZ0eHQkO0vqsbvFLXUmYm/uNKJBg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-wasm": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-wasm/-/watcher-wasm-2.5.6.tgz",
+      "integrity": "sha512-byAiBZ1t3tXQvc8dMD/eoyE7lTXYorhn+6uVW5AC+JGI1KtJC/LvDche5cfUE+qiefH+Ybq0bUCJU0aB1cSHUA==",
+      "bundleDependencies": [
+        "napi-wasm"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "is-glob": "^4.0.3",
+        "napi-wasm": "^1.1.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-wasm/node_modules/napi-wasm": {
+      "version": "1.1.0",
+      "inBundle": true,
+      "license": "MIT"
+    },
+    "node_modules/@parcel/watcher-win32-arm64": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-arm64/-/watcher-win32-arm64-2.5.6.tgz",
+      "integrity": "sha512-3ukyebjc6eGlw9yRt678DxVF7rjXatWiHvTXqphZLvo7aC5NdEgFufVwjFfY51ijYEWpXbqF5jtrK275z52D4Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-win32-ia32": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-ia32/-/watcher-win32-ia32-2.5.6.tgz",
+      "integrity": "sha512-k35yLp1ZMwwee3Ez/pxBi5cf4AoBKYXj00CZ80jUz5h8prpiaQsiRPKQMxoLstNuqe2vR4RNPEAEcjEFzhEz/g==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-win32-x64": {
+      "version": "2.5.6",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-x64/-/watcher-win32-x64-2.5.6.tgz",
+      "integrity": "sha512-hbQlYcCq5dlAX9Qx+kFb0FHue6vbjlf0FrNzSKdYK2APUf7tGfGxQCk2ihEREmbR6ZMc0MVAD5RIX/41gpUzTw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@pkgjs/parseargs": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
+      "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@polka/url": {
+      "version": "1.0.0-next.29",
+      "resolved": "https://registry.npmjs.org/@polka/url/-/url-1.0.0-next.29.tgz",
+      "integrity": "sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==",
+      "license": "MIT"
+    },
+    "node_modules/@poppinss/colors": {
+      "version": "4.1.6",
+      "resolved": "https://registry.npmjs.org/@poppinss/colors/-/colors-4.1.6.tgz",
+      "integrity": "sha512-H9xkIdFswbS8n1d6vmRd8+c10t2Qe+rZITbbDHHkQixH5+2x1FDGmi/0K+WgWiqQFKPSlIYB7jlH6Kpfn6Fleg==",
+      "license": "MIT",
+      "dependencies": {
+        "kleur": "^4.1.5"
+      }
+    },
+    "node_modules/@poppinss/dumper": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/@poppinss/dumper/-/dumper-0.7.0.tgz",
+      "integrity": "sha512-0UTYalzk2t6S4rA2uHOz5bSSW2CHdv4vggJI6Alg90yvl0UgXs6XSXpH96OH+bRkX4J/06djv29pqXJ0lq5Kag==",
+      "license": "MIT",
+      "dependencies": {
+        "@poppinss/colors": "^4.1.5",
+        "@sindresorhus/is": "^7.0.2",
+        "supports-color": "^10.0.0"
+      }
+    },
+    "node_modules/@poppinss/exception": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/@poppinss/exception/-/exception-1.2.3.tgz",
+      "integrity": "sha512-dCED+QRChTVatE9ibtoaxc+WkdzOSjYTKi/+uacHWIsfodVfpsueo3+DKpgU5Px8qXjgmXkSvhXvSCz3fnP9lw==",
+      "license": "MIT"
+    },
+    "node_modules/@rolldown/pluginutils": {
+      "version": "1.0.0-rc.2",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-rc.2.tgz",
+      "integrity": "sha512-izyXV/v+cHiRfozX62W9htOAvwMo4/bXKDrQ+vom1L1qRuexPock/7VZDAhnpHCLNejd3NJ6hiab+tO0D44Rgw==",
+      "license": "MIT"
+    },
+    "node_modules/@rollup/plugin-alias": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-alias/-/plugin-alias-6.0.0.tgz",
+      "integrity": "sha512-tPCzJOtS7uuVZd+xPhoy5W4vThe6KWXNmsFCNktaAh5RTqcLiSfT4huPQIXkgJ6YCOjJHvecOAzQxLFhPxKr+g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "peerDependencies": {
+        "rollup": ">=4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-commonjs": {
+      "version": "29.0.2",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-commonjs/-/plugin-commonjs-29.0.2.tgz",
+      "integrity": "sha512-S/ggWH1LU7jTyi9DxZOKyxpVd4hF/OZ0JrEbeLjXk/DFXwRny0tjD2c992zOUYQobLrVkRVMDdmHP16HKP7GRg==",
+      "license": "MIT",
+      "dependencies": {
+        "@rollup/pluginutils": "^5.0.1",
+        "commondir": "^1.0.1",
+        "estree-walker": "^2.0.2",
+        "fdir": "^6.2.0",
+        "is-reference": "1.2.1",
+        "magic-string": "^0.30.3",
+        "picomatch": "^4.0.2"
+      },
+      "engines": {
+        "node": ">=16.0.0 || 14 >= 14.17"
+      },
+      "peerDependencies": {
+        "rollup": "^2.68.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-inject": {
+      "version": "5.0.5",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-inject/-/plugin-inject-5.0.5.tgz",
+      "integrity": "sha512-2+DEJbNBoPROPkgTDNe8/1YXWcqxbN5DTjASVIOx8HS+pITXushyNiBV56RB08zuptzz8gT3YfkqriTBVycepg==",
+      "license": "MIT",
+      "dependencies": {
+        "@rollup/pluginutils": "^5.0.1",
+        "estree-walker": "^2.0.2",
+        "magic-string": "^0.30.3"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-json": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-json/-/plugin-json-6.1.0.tgz",
+      "integrity": "sha512-EGI2te5ENk1coGeADSIwZ7G2Q8CJS2sF120T7jLw4xFw9n7wIOXHo+kIYRAoVpJAN+kmqZSoO3Fp4JtoNF4ReA==",
+      "license": "MIT",
+      "dependencies": {
+        "@rollup/pluginutils": "^5.1.0"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-node-resolve": {
+      "version": "16.0.3",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-node-resolve/-/plugin-node-resolve-16.0.3.tgz",
+      "integrity": "sha512-lUYM3UBGuM93CnMPG1YocWu7X802BrNF3jW2zny5gQyLQgRFJhV1Sq0Zi74+dh/6NBx1DxFC4b4GXg9wUCG5Qg==",
+      "license": "MIT",
+      "dependencies": {
+        "@rollup/pluginutils": "^5.0.1",
+        "@types/resolve": "1.20.2",
+        "deepmerge": "^4.2.2",
+        "is-module": "^1.0.0",
+        "resolve": "^1.22.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^2.78.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-replace": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-replace/-/plugin-replace-6.0.3.tgz",
+      "integrity": "sha512-J4RZarRvQAm5IF0/LwUUg+obsm+xZhYnbMXmXROyoSE1ATJe3oXSb9L5MMppdxP2ylNSjv6zFBwKYjcKMucVfA==",
+      "license": "MIT",
+      "dependencies": {
+        "@rollup/pluginutils": "^5.0.1",
+        "magic-string": "^0.30.3"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-terser": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-terser/-/plugin-terser-1.0.0.tgz",
+      "integrity": "sha512-FnCxhTBx6bMOYQrar6C8h3scPt8/JwIzw3+AJ2K++6guogH5fYaIFia+zZuhqv0eo1RN7W1Pz630SyvLbDjhtQ==",
+      "license": "MIT",
+      "dependencies": {
+        "serialize-javascript": "^7.0.3",
+        "smob": "^1.0.0",
+        "terser": "^5.17.4"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/pluginutils": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.3.0.tgz",
+      "integrity": "sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0",
+        "estree-walker": "^2.0.2",
+        "picomatch": "^4.0.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.0.tgz",
+      "integrity": "sha512-WOhNW9K8bR3kf4zLxbfg6Pxu2ybOUbB2AjMDHSQx86LIF4rH4Ft7vmMwNt0loO0eonglSNy4cpD3MKXXKQu0/A==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.0.tgz",
+      "integrity": "sha512-u6JHLll5QKRvjciE78bQXDmqRqNs5M/3GVqZeMwvmjaNODJih/WIrJlFVEihvV0MiYFmd+ZyPr9wxOVbPAG2Iw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.0.tgz",
+      "integrity": "sha512-qEF7CsKKzSRc20Ciu2Zw1wRrBz4g56F7r/vRwY430UPp/nt1x21Q/fpJ9N5l47WWvJlkNCPJz3QRVw008fi7yA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.0.tgz",
+      "integrity": "sha512-WADYozJ4QCnXCH4wPB+3FuGmDPoFseVCUrANmA5LWwGmC6FL14BWC7pcq+FstOZv3baGX65tZ378uT6WG8ynTw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.0.tgz",
+      "integrity": "sha512-6b8wGHJlDrGeSE3aH5mGNHBjA0TTkxdoNHik5EkvPHCt351XnigA4pS7Wsj/Eo9Y8RBU6f35cjN9SYmCFBtzxw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.0.tgz",
+      "integrity": "sha512-h25Ga0t4jaylMB8M/JKAyrvvfxGRjnPQIR8lnCayyzEjEOx2EJIlIiMbhpWxDRKGKF8jbNH01NnN663dH638mA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.0.tgz",
+      "integrity": "sha512-RzeBwv0B3qtVBWtcuABtSuCzToo2IEAIQrcyB/b2zMvBWVbjo8bZDjACUpnaafaxhTw2W+imQbP2BD1usasK4g==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.0.tgz",
+      "integrity": "sha512-Sf7zusNI2CIU1HLzuu9Tc5YGAHEZs5Lu7N1ssJG4Tkw6e0MEsN7NdjUDDfGNHy2IU+ENyWT+L2obgWiguWibWQ==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.0.tgz",
+      "integrity": "sha512-DX2x7CMcrJzsE91q7/O02IJQ5/aLkVtYFryqCjduJhUfGKG6yJV8hxaw8pZa93lLEpPTP/ohdN4wFz7yp/ry9A==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.0.tgz",
+      "integrity": "sha512-09EL+yFVbJZlhcQfShpswwRZ0Rg+z/CsSELFCnPt3iK+iqwGsI4zht3secj5vLEs957QvFFXnzAT0FFPIxSrkQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.0.tgz",
+      "integrity": "sha512-i9IcCMPr3EXm8EQg5jnja0Zyc1iFxJjZWlb4wr7U2Wx/GrddOuEafxRdMPRYVaXjgbhvqalp6np07hN1w9kAKw==",
+      "cpu": [
+        "loong64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.0.tgz",
+      "integrity": "sha512-DGzdJK9kyJ+B78MCkWeGnpXJ91tK/iKA6HwHxF4TAlPIY7GXEvMe8hBFRgdrR9Ly4qebR/7gfUs9y2IoaVEyog==",
+      "cpu": [
+        "loong64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.0.tgz",
+      "integrity": "sha512-RwpnLsqC8qbS8z1H1AxBA1H6qknR4YpPR9w2XX0vo2Sz10miu57PkNcnHVaZkbqyw/kUWfKMI73jhmfi9BRMUQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.0.tgz",
+      "integrity": "sha512-Z8pPf54Ly3aqtdWC3G4rFigZgNvd+qJlOE52fmko3KST9SoGfAdSRCwyoyG05q1HrrAblLbk1/PSIV+80/pxLg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.0.tgz",
+      "integrity": "sha512-3a3qQustp3COCGvnP4SvrMHnPQ9d1vzCakQVRTliaz8cIp/wULGjiGpbcqrkv0WrHTEp8bQD/B3HBjzujVWLOA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.0.tgz",
+      "integrity": "sha512-pjZDsVH/1VsghMJ2/kAaxt6dL0psT6ZexQVrijczOf+PeP2BUqTHYejk3l6TlPRydggINOeNRhvpLa0AYpCWSQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.0.tgz",
+      "integrity": "sha512-3ObQs0BhvPgiUVZrN7gqCSvmFuMWvWvsjG5ayJ3Lraqv+2KhOsp+pUbigqbeWqueGIsnn+09HBw27rJ+gYK4VQ==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.0.tgz",
+      "integrity": "sha512-EtylprDtQPdS5rXvAayrNDYoJhIz1/vzN2fEubo3yLE7tfAw+948dO0g4M0vkTVFhKojnF+n6C8bDNe+gDRdTg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.0.tgz",
+      "integrity": "sha512-k09oiRCi/bHU9UVFqD17r3eJR9bn03TyKraCrlz5ULFJGdJGi7VOmm9jl44vOJvRJ6P7WuBi/s2A97LxxHGIdw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.0.tgz",
+      "integrity": "sha512-1o/0/pIhozoSaDJoDcec+IVLbnRtQmHwPV730+AOD29lHEEo4F5BEUB24H0OBdhbBBDwIOSuf7vgg0Ywxdfiiw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.0.tgz",
+      "integrity": "sha512-pESDkos/PDzYwtyzB5p/UoNU/8fJo68vcXM9ZW2V0kjYayj1KaaUfi1NmTUTUpMn4UhU4gTuK8gIaFO4UGuMbA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.0.tgz",
+      "integrity": "sha512-hj1wFStD7B1YBeYmvY+lWXZ7ey73YGPcViMShYikqKT1GtstIKQAtfUI6yrzPjAy/O7pO0VLXGmUVWXQMaYgTQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.0.tgz",
+      "integrity": "sha512-SyaIPFoxmUPlNDq5EHkTbiKzmSEmq/gOYFI/3HHJ8iS/v1mbugVa7dXUzcJGQfoytp9DJFLhHH4U3/eTy2Bq4w==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.0.tgz",
+      "integrity": "sha512-RdcryEfzZr+lAr5kRm2ucN9aVlCCa2QNq4hXelZxb8GG0NJSazq44Z3PCCc8wISRuCVnGs0lQJVX5Vp6fKA+IA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.0.tgz",
+      "integrity": "sha512-PrsWNQ8BuE00O3Xsx3ALh2Df8fAj9+cvvX9AIA6o4KpATR98c9mud4XtDWVvsEuyia5U4tVSTKygawyJkjm60w==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@sindresorhus/is": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-7.2.0.tgz",
+      "integrity": "sha512-P1Cz1dWaFfR4IR+U13mqqiGsLFf1KbayybWwdd2vfctdV6hDpUkgCY0nKOLLTMSoRd/jJNjtbqzf13K8DCCXQw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/is?sponsor=1"
+      }
+    },
+    "node_modules/@sindresorhus/merge-streams": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/merge-streams/-/merge-streams-4.0.0.tgz",
+      "integrity": "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@speed-highlight/core": {
+      "version": "1.2.15",
+      "resolved": "https://registry.npmjs.org/@speed-highlight/core/-/core-1.2.15.tgz",
+      "integrity": "sha512-BMq1K3DsElxDWawkX6eLg9+CKJrTVGCBAWVuHXVUV2u0s2711qiChLSId6ikYPfxhdYocLNt3wWwSvDiTvFabw==",
+      "license": "CC0-1.0"
+    },
+    "node_modules/@tybys/wasm-util": {
+      "version": "0.10.1",
+      "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.1.tgz",
+      "integrity": "sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "tslib": "^2.4.0"
+      }
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "license": "MIT"
+    },
+    "node_modules/@types/resolve": {
+      "version": "1.20.2",
+      "resolved": "https://registry.npmjs.org/@types/resolve/-/resolve-1.20.2.tgz",
+      "integrity": "sha512-60BCwRFOZCQhDncwQdxxeOEEkbc5dIMccYLwbxsS4TUNeVECQ/pBJ0j09mrHOl/JJvpRPGwO9SvE4nR2Nb/a4Q==",
+      "license": "MIT"
+    },
+    "node_modules/@unhead/vue": {
+      "version": "2.1.12",
+      "resolved": "https://registry.npmjs.org/@unhead/vue/-/vue-2.1.12.tgz",
+      "integrity": "sha512-zEWqg0nZM8acpuTZE40wkeUl8AhIe0tU0OkilVi1D4fmVjACrwoh5HP6aNqJ8kUnKsoy6D+R3Vi/O+fmdNGO7g==",
+      "license": "MIT",
+      "dependencies": {
+        "hookable": "^6.0.1",
+        "unhead": "2.1.12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/harlan-zw"
+      },
+      "peerDependencies": {
+        "vue": ">=3.5.18"
+      }
+    },
+    "node_modules/@unhead/vue/node_modules/hookable": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/hookable/-/hookable-6.1.0.tgz",
+      "integrity": "sha512-ZoKZSJgu8voGK2geJS+6YtYjvIzu9AOM/KZXsBxr83uhLL++e9pEv/dlgwgy3dvHg06kTz6JOh1hk3C8Ceiymw==",
+      "license": "MIT"
+    },
+    "node_modules/@vercel/nft": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@vercel/nft/-/nft-1.5.0.tgz",
+      "integrity": "sha512-IWTDeIoWhQ7ZtRO/JRKH+jhmeQvZYhtGPmzw/QGDY+wDCQqfm25P9yIdoAFagu4fWsK4IwZXDFIjrmp5rRm/sA==",
+      "license": "MIT",
+      "dependencies": {
+        "@mapbox/node-pre-gyp": "^2.0.0",
+        "@rollup/pluginutils": "^5.1.3",
+        "acorn": "^8.6.0",
+        "acorn-import-attributes": "^1.9.5",
+        "async-sema": "^3.1.1",
+        "bindings": "^1.4.0",
+        "estree-walker": "2.0.2",
+        "glob": "^13.0.0",
+        "graceful-fs": "^4.2.9",
+        "node-gyp-build": "^4.2.2",
+        "picomatch": "^4.0.2",
+        "resolve-from": "^5.0.0"
+      },
+      "bin": {
+        "nft": "out/cli.js"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/@vitejs/plugin-vue": {
+      "version": "6.0.5",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.5.tgz",
+      "integrity": "sha512-bL3AxKuQySfk1iGcBsQnoRVexTPJq0Z/ixFVM8OhVJAP6ZXXXLtM7NFKWhLl30Kg7uTBqIaPXbh+nuQCuBDedg==",
+      "license": "MIT",
+      "dependencies": {
+        "@rolldown/pluginutils": "1.0.0-rc.2"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+        "vue": "^3.2.25"
+      }
+    },
+    "node_modules/@vitejs/plugin-vue-jsx": {
+      "version": "5.1.5",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue-jsx/-/plugin-vue-jsx-5.1.5.tgz",
+      "integrity": "sha512-jIAsvHOEtWpslLOI2MeElGFxH7M8pM83BU/Tor4RLyiwH0FM4nUW3xdvbw20EeU9wc5IspQwMq225K3CMnJEpA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/core": "^7.29.0",
+        "@babel/plugin-syntax-typescript": "^7.28.6",
+        "@babel/plugin-transform-typescript": "^7.28.6",
+        "@rolldown/pluginutils": "^1.0.0-rc.2",
+        "@vue/babel-plugin-jsx": "^2.0.1"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+        "vue": "^3.0.0"
+      }
+    },
+    "node_modules/@volar/language-core": {
+      "version": "2.4.28",
+      "resolved": "https://registry.npmjs.org/@volar/language-core/-/language-core-2.4.28.tgz",
+      "integrity": "sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@volar/source-map": "2.4.28"
+      }
+    },
+    "node_modules/@volar/source-map": {
+      "version": "2.4.28",
+      "resolved": "https://registry.npmjs.org/@volar/source-map/-/source-map-2.4.28.tgz",
+      "integrity": "sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ==",
+      "license": "MIT"
+    },
+    "node_modules/@vue-macros/common": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@vue-macros/common/-/common-3.1.2.tgz",
+      "integrity": "sha512-h9t4ArDdniO9ekYHAD95t9AZcAbb19lEGK+26iAjUODOIJKmObDNBSe4+6ELQAA3vtYiFPPBtHh7+cQCKi3Dng==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-sfc": "^3.5.22",
+        "ast-kit": "^2.1.2",
+        "local-pkg": "^1.1.2",
+        "magic-string-ast": "^1.0.2",
+        "unplugin-utils": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/vue-macros"
+      },
+      "peerDependencies": {
+        "vue": "^2.7.0 || ^3.2.25"
+      },
+      "peerDependenciesMeta": {
+        "vue": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@vue/babel-helper-vue-transform-on": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@vue/babel-helper-vue-transform-on/-/babel-helper-vue-transform-on-2.0.1.tgz",
+      "integrity": "sha512-uZ66EaFbnnZSYqYEyplWvn46GhZ1KuYSThdT68p+am7MgBNbQ3hphTL9L+xSIsWkdktwhPYLwPgVWqo96jDdRA==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/babel-plugin-jsx": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@vue/babel-plugin-jsx/-/babel-plugin-jsx-2.0.1.tgz",
+      "integrity": "sha512-a8CaLQjD/s4PVdhrLD/zT574ZNPnZBOY+IhdtKWRB4HRZ0I2tXBi5ne7d9eCfaYwp5gU5+4KIyFTV1W1YL9xZA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.27.1",
+        "@babel/helper-plugin-utils": "^7.27.1",
+        "@babel/plugin-syntax-jsx": "^7.27.1",
+        "@babel/template": "^7.27.2",
+        "@babel/traverse": "^7.28.4",
+        "@babel/types": "^7.28.4",
+        "@vue/babel-helper-vue-transform-on": "2.0.1",
+        "@vue/babel-plugin-resolve-type": "2.0.1",
+        "@vue/shared": "^3.5.22"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      },
+      "peerDependenciesMeta": {
+        "@babel/core": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@vue/babel-plugin-resolve-type": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@vue/babel-plugin-resolve-type/-/babel-plugin-resolve-type-2.0.1.tgz",
+      "integrity": "sha512-ybwgIuRGRRBhOU37GImDoWQoz+TlSqap65qVI6iwg/J7FfLTLmMf97TS7xQH9I7Qtr/gp161kYVdhr1ZMraSYQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.27.1",
+        "@babel/helper-module-imports": "^7.27.1",
+        "@babel/helper-plugin-utils": "^7.27.1",
+        "@babel/parser": "^7.28.4",
+        "@vue/compiler-sfc": "^3.5.22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@vue/compiler-core": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.31.tgz",
+      "integrity": "sha512-k/ueL14aNIEy5Onf0OVzR8kiqF/WThgLdFhxwa4e/KF/0qe38IwIdofoSWBTvvxQOesaz6riAFAUaYjoF9fLLQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.2",
+        "@vue/shared": "3.5.31",
+        "entities": "^7.0.1",
+        "estree-walker": "^2.0.2",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-dom": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.31.tgz",
+      "integrity": "sha512-BMY/ozS/xxjYqRFL+tKdRpATJYDTTgWSo0+AJvJNg4ig+Hgb0dOsHPXvloHQ5hmlivUqw1Yt2pPIqp4e0v1GUw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-core": "3.5.31",
+        "@vue/shared": "3.5.31"
+      }
+    },
+    "node_modules/@vue/compiler-sfc": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.31.tgz",
+      "integrity": "sha512-M8wpPgR9UJ8MiRGjppvx9uWJfLV7A/T+/rL8s/y3QG3u0c2/YZgff3d6SuimKRIhcYnWg5fTfDMlz2E6seUW8Q==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@babel/parser": "^7.29.2",
+        "@vue/compiler-core": "3.5.31",
+        "@vue/compiler-dom": "3.5.31",
+        "@vue/compiler-ssr": "3.5.31",
+        "@vue/shared": "3.5.31",
+        "estree-walker": "^2.0.2",
+        "magic-string": "^0.30.21",
+        "postcss": "^8.5.8",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-ssr": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.31.tgz",
+      "integrity": "sha512-h0xIMxrt/LHOvJKMri+vdYT92BrK3HFLtDqq9Pr/lVVfE4IyKZKvWf0vJFW10Yr6nX02OR4MkJwI0c1HDa1hog==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.31",
+        "@vue/shared": "3.5.31"
+      }
+    },
+    "node_modules/@vue/devtools-api": {
+      "version": "6.6.4",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-api/-/devtools-api-6.6.4.tgz",
+      "integrity": "sha512-sGhTPMuXqZ1rVOk32RylztWkfXTRhuS7vgAKv0zjqk8gbsHkJ7xfFf+jbySxt7tWObEJwyKaHMikV/WGDiQm8g==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/devtools-core": {
+      "version": "8.1.1",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-core/-/devtools-core-8.1.1.tgz",
+      "integrity": "sha512-bCCsSABp1/ot4j8xJEycM6Mtt2wbuucfByr6hMgjbYhrtlscOJypZKvy8f1FyWLYrLTchB5Qz216Lm92wfbq0A==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-kit": "^8.1.1",
+        "@vue/devtools-shared": "^8.1.1"
+      },
+      "peerDependencies": {
+        "vue": "^3.0.0"
+      }
+    },
+    "node_modules/@vue/devtools-kit": {
+      "version": "8.1.1",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-kit/-/devtools-kit-8.1.1.tgz",
+      "integrity": "sha512-gVBaBv++i+adg4JpH71k9ppl4soyR7Y2McEqO5YNgv0BI1kMZ7BDX5gnwkZ5COYgiCyhejZG+yGNrBAjj6Coqg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-shared": "^8.1.1",
+        "birpc": "^2.6.1",
+        "hookable": "^5.5.3",
+        "perfect-debounce": "^2.0.0"
+      }
+    },
+    "node_modules/@vue/devtools-kit/node_modules/birpc": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/birpc/-/birpc-2.9.0.tgz",
+      "integrity": "sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/@vue/devtools-shared": {
+      "version": "8.1.1",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-shared/-/devtools-shared-8.1.1.tgz",
+      "integrity": "sha512-+h4ttmJYl/txpxHKaoZcaKpC+pvckgLzIDiSQlaQ7kKthKh8KuwoLW2D8hPJEnqKzXOvu15UHEoGyngAXCz0EQ==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/language-core": {
+      "version": "3.2.6",
+      "resolved": "https://registry.npmjs.org/@vue/language-core/-/language-core-3.2.6.tgz",
+      "integrity": "sha512-xYYYX3/aVup576tP/23sEUpgiEnujrENaoNRbaozC1/MA9I6EGFQRJb4xrt/MmUCAGlxTKL2RmT8JLTPqagCkg==",
+      "license": "MIT",
+      "dependencies": {
+        "@volar/language-core": "2.4.28",
+        "@vue/compiler-dom": "^3.5.0",
+        "@vue/shared": "^3.5.0",
+        "alien-signals": "^3.0.0",
+        "muggle-string": "^0.4.1",
+        "path-browserify": "^1.0.1",
+        "picomatch": "^4.0.2"
+      }
+    },
+    "node_modules/@vue/reactivity": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.31.tgz",
+      "integrity": "sha512-DtKXxk9E/KuVvt8VxWu+6Luc9I9ETNcqR1T1oW1gf02nXaZ1kuAx58oVu7uX9XxJR0iJCro6fqBLw9oSBELo5g==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/shared": "3.5.31"
+      }
+    },
+    "node_modules/@vue/runtime-core": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.31.tgz",
+      "integrity": "sha512-AZPmIHXEAyhpkmN7aWlqjSfYynmkWlluDNPHMCZKFHH+lLtxP/30UJmoVhXmbDoP1Ng0jG0fyY2zCj1PnSSA6Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.31",
+        "@vue/shared": "3.5.31"
+      }
+    },
+    "node_modules/@vue/runtime-dom": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.31.tgz",
+      "integrity": "sha512-xQJsNRmGPeDCJq/u813tyonNgWBFjzfVkBwDREdEWndBnGdHLHgkwNBQxLtg4zDrzKTEcnikUy1UUNecb3lJ6g==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.31",
+        "@vue/runtime-core": "3.5.31",
+        "@vue/shared": "3.5.31",
+        "csstype": "^3.2.3"
+      }
+    },
+    "node_modules/@vue/server-renderer": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.31.tgz",
+      "integrity": "sha512-GJuwRvMcdZX/CriUnyIIOGkx3rMV3H6sOu0JhdKbduaeCji6zb60iOGMY7tFoN24NfsUYoFBhshZtGxGpxO4iA==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-ssr": "3.5.31",
+        "@vue/shared": "3.5.31"
+      },
+      "peerDependencies": {
+        "vue": "3.5.31"
+      }
+    },
+    "node_modules/@vue/shared": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.31.tgz",
+      "integrity": "sha512-nBxuiuS9Lj5bPkPbWogPUnjxxWpkRniX7e5UBQDWl6Fsf4roq9wwV+cR7ezQ4zXswNvPIlsdj1slcLB7XCsRAw==",
+      "license": "MIT"
+    },
+    "node_modules/abbrev": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-3.0.1.tgz",
+      "integrity": "sha512-AO2ac6pjRB3SJmGJo+v5/aK6Omggp6fsLrs6wN9bd35ulu4cCwaAU9+7ZhXjeqHVkaHThLuzH0nZr0YpCDhygg==",
+      "license": "ISC",
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
+    "node_modules/abort-controller": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz",
+      "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==",
+      "license": "MIT",
+      "dependencies": {
+        "event-target-shim": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=6.5"
+      }
+    },
+    "node_modules/acorn": {
+      "version": "8.16.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz",
+      "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/acorn-import-attributes": {
+      "version": "1.9.5",
+      "resolved": "https://registry.npmjs.org/acorn-import-attributes/-/acorn-import-attributes-1.9.5.tgz",
+      "integrity": "sha512-n02Vykv5uA3eHGM/Z2dQrcD56kL8TyDb2p1+0P83PClMnC/nc+anbQRhIOWnSq4Ke/KvDPrY3C9hDtC/A3eHnQ==",
+      "license": "MIT",
+      "peerDependencies": {
+        "acorn": "^8"
+      }
+    },
+    "node_modules/agent-base": {
+      "version": "7.1.4",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+      "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/alien-signals": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/alien-signals/-/alien-signals-3.1.2.tgz",
+      "integrity": "sha512-d9dYqZTS90WLiU0I5c6DHj/HcKkF8ZyGN3G5x8wSbslulz70KOxaqCT0hQCo9KOyhVqzqGojvNdJXoTumZOtcw==",
+      "license": "MIT"
+    },
+    "node_modules/ansi-regex": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
+      "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "6.2.3",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/ansis": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/ansis/-/ansis-4.2.0.tgz",
+      "integrity": "sha512-HqZ5rWlFjGiV0tDm3UxxgNRqsOTniqoKZu0pIAfh7TZQMGuZK+hH0drySty0si0QXj1ieop4+SkSfPZBPPkHig==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/anymatch": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
+      "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
+      "license": "ISC",
+      "dependencies": {
+        "normalize-path": "^3.0.0",
+        "picomatch": "^2.0.4"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/anymatch/node_modules/picomatch": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/archiver": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/archiver/-/archiver-7.0.1.tgz",
+      "integrity": "sha512-ZcbTaIqJOfCc03QwD468Unz/5Ir8ATtvAHsK+FdXbDIbGfihqh9mrvdcYunQzqn4HrvWWaFyaxJhGZagaJJpPQ==",
+      "license": "MIT",
+      "dependencies": {
+        "archiver-utils": "^5.0.2",
+        "async": "^3.2.4",
+        "buffer-crc32": "^1.0.0",
+        "readable-stream": "^4.0.0",
+        "readdir-glob": "^1.1.2",
+        "tar-stream": "^3.0.0",
+        "zip-stream": "^6.0.1"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/archiver-utils": {
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/archiver-utils/-/archiver-utils-5.0.2.tgz",
+      "integrity": "sha512-wuLJMmIBQYCsGZgYLTy5FIB2pF6Lfb6cXMSF8Qywwk3t20zWnAi7zLcQFdKQmIB8wyZpY5ER38x08GbwtR2cLA==",
+      "license": "MIT",
+      "dependencies": {
+        "glob": "^10.0.0",
+        "graceful-fs": "^4.2.0",
+        "is-stream": "^2.0.1",
+        "lazystream": "^1.0.0",
+        "lodash": "^4.17.15",
+        "normalize-path": "^3.0.0",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/archiver-utils/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "license": "MIT"
+    },
+    "node_modules/archiver-utils/node_modules/brace-expansion": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz",
+      "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==",
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/archiver-utils/node_modules/glob": {
+      "version": "10.5.0",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz",
+      "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==",
+      "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me",
+      "license": "ISC",
+      "dependencies": {
+        "foreground-child": "^3.1.0",
+        "jackspeak": "^3.1.2",
+        "minimatch": "^9.0.4",
+        "minipass": "^7.1.2",
+        "package-json-from-dist": "^1.0.0",
+        "path-scurry": "^1.11.1"
+      },
+      "bin": {
+        "glob": "dist/esm/bin.mjs"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/archiver-utils/node_modules/is-stream": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/archiver-utils/node_modules/lru-cache": {
+      "version": "10.4.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+      "license": "ISC"
+    },
+    "node_modules/archiver-utils/node_modules/minimatch": {
+      "version": "9.0.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz",
+      "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==",
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.2"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/archiver-utils/node_modules/path-scurry": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
+      "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==",
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "lru-cache": "^10.2.0",
+        "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/ast-kit": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/ast-kit/-/ast-kit-2.2.0.tgz",
+      "integrity": "sha512-m1Q/RaVOnTp9JxPX+F+Zn7IcLYMzM8kZofDImfsKZd8MbR+ikdOzTeztStWqfrqIxZnYWryyI9ePm3NGjnZgGw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.28.5",
+        "pathe": "^2.0.3"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      }
+    },
+    "node_modules/ast-walker-scope": {
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/ast-walker-scope/-/ast-walker-scope-0.8.3.tgz",
+      "integrity": "sha512-cbdCP0PGOBq0ASG+sjnKIoYkWMKhhz+F/h9pRexUdX2Hd38+WOlBkRKlqkGOSm0YQpcFMQBJeK4WspUAkwsEdg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.28.4",
+        "ast-kit": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      }
+    },
+    "node_modules/async": {
+      "version": "3.2.6",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
+      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
+      "license": "MIT"
+    },
+    "node_modules/async-sema": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/async-sema/-/async-sema-3.1.1.tgz",
+      "integrity": "sha512-tLRNUXati5MFePdAk8dw7Qt7DpxPB60ofAgn8WRhW6a2rcimZnYBP9oxHiv0OHy+Wz7kPMG+t4LGdt31+4EmGg==",
+      "license": "MIT"
+    },
+    "node_modules/autoprefixer": {
+      "version": "10.4.27",
+      "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.27.tgz",
+      "integrity": "sha512-NP9APE+tO+LuJGn7/9+cohklunJsXWiaWEfV3si4Gi/XHDwVNgkwr1J3RQYFIvPy76GmJ9/bW8vyoU1LcxwKHA==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/autoprefixer"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "caniuse-lite": "^1.0.30001774",
+        "fraction.js": "^5.3.4",
+        "picocolors": "^1.1.1",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "bin": {
+        "autoprefixer": "bin/autoprefixer"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      },
+      "peerDependencies": {
+        "postcss": "^8.1.0"
+      }
+    },
+    "node_modules/b4a": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/b4a/-/b4a-1.8.0.tgz",
+      "integrity": "sha512-qRuSmNSkGQaHwNbM7J78Wwy+ghLEYF1zNrSeMxj4Kgw6y33O3mXcQ6Ie9fRvfU/YnxWkOchPXbaLb73TkIsfdg==",
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "react-native-b4a": "*"
+      },
+      "peerDependenciesMeta": {
+        "react-native-b4a": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/balanced-match": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+      "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/bare-events": {
+      "version": "2.8.2",
+      "resolved": "https://registry.npmjs.org/bare-events/-/bare-events-2.8.2.tgz",
+      "integrity": "sha512-riJjyv1/mHLIPX4RwiK+oW9/4c3TEUeORHKefKAKnZ5kyslbN+HXowtbaVEqt4IMUB7OXlfixcs6gsFeo/jhiQ==",
+      "license": "Apache-2.0",
+      "peer": true,
+      "peerDependencies": {
+        "bare-abort-controller": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-abort-controller": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/bare-fs": {
+      "version": "4.5.6",
+      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.5.6.tgz",
+      "integrity": "sha512-1QovqDrR80Pmt5HPAsMsXTCFcDYr+NSUKW6nd6WO5v0JBmnItc/irNRzm2KOQ5oZ69P37y+AMujNyNtG+1Rggw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bare-events": "^2.5.4",
+        "bare-path": "^3.0.0",
+        "bare-stream": "^2.6.4",
+        "bare-url": "^2.2.2",
+        "fast-fifo": "^1.3.2"
+      },
+      "engines": {
+        "bare": ">=1.16.0"
+      },
+      "peerDependencies": {
+        "bare-buffer": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-buffer": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/bare-os": {
+      "version": "3.8.0",
+      "resolved": "https://registry.npmjs.org/bare-os/-/bare-os-3.8.0.tgz",
+      "integrity": "sha512-Dc9/SlwfxkXIGYhvMQNUtKaXCaGkZYGcd1vuNUUADVqzu4/vQfvnMkYYOUnt2VwQ2AqKr/8qAVFRtwETljgeFg==",
+      "license": "Apache-2.0",
+      "engines": {
+        "bare": ">=1.14.0"
+      }
+    },
+    "node_modules/bare-path": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/bare-path/-/bare-path-3.0.0.tgz",
+      "integrity": "sha512-tyfW2cQcB5NN8Saijrhqn0Zh7AnFNsnczRcuWODH0eYAXBsJ5gVxAUuNr7tsHSC6IZ77cA0SitzT+s47kot8Mw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bare-os": "^3.0.1"
+      }
+    },
+    "node_modules/bare-stream": {
+      "version": "2.11.0",
+      "resolved": "https://registry.npmjs.org/bare-stream/-/bare-stream-2.11.0.tgz",
+      "integrity": "sha512-Y/+iQ49fL3rIn6w/AVxI/2+BRrpmzJvdWt5Jv8Za6Ngqc6V227c+pYjYYgLdpR3MwQ9ObVXD0ZrqoBztakM0rw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "streamx": "^2.25.0",
+        "teex": "^1.0.1"
+      },
+      "peerDependencies": {
+        "bare-abort-controller": "*",
+        "bare-buffer": "*",
+        "bare-events": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-abort-controller": {
+          "optional": true
+        },
+        "bare-buffer": {
+          "optional": true
+        },
+        "bare-events": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/bare-url": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.4.0.tgz",
+      "integrity": "sha512-NSTU5WN+fy/L0DDenfE8SXQna4voXuW0FHM7wH8i3/q9khUSchfPbPezO4zSFMnDGIf9YE+mt/RWhZgNRKRIXA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bare-path": "^3.0.0"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/baseline-browser-mapping": {
+      "version": "2.10.11",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.11.tgz",
+      "integrity": "sha512-DAKrHphkJyiGuau/cFieRYhcTFeK/lBuD++C7cZ6KZHbMhBrisoi+EvhQ5RZrIfV5qwsW8kgQ07JIC+MDJRAhg==",
+      "license": "Apache-2.0",
+      "bin": {
+        "baseline-browser-mapping": "dist/cli.cjs"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/bindings": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz",
+      "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==",
+      "license": "MIT",
+      "dependencies": {
+        "file-uri-to-path": "1.0.0"
+      }
+    },
+    "node_modules/birpc": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/birpc/-/birpc-4.0.0.tgz",
+      "integrity": "sha512-LShSxJP0KTmd101b6DRyGBj57LZxSDYWKitQNW/mi8GRMvZb078Uf9+pveax1DrVL89vm7mWe+TovdI/UDOuPw==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/boolbase": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
+      "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==",
+      "license": "ISC"
+    },
+    "node_modules/brace-expansion": {
+      "version": "5.0.5",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz",
+      "integrity": "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==",
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "license": "MIT",
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/browserslist": {
+      "version": "4.28.1",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz",
+      "integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "baseline-browser-mapping": "^2.9.0",
+        "caniuse-lite": "^1.0.30001759",
+        "electron-to-chromium": "^1.5.263",
+        "node-releases": "^2.0.27",
+        "update-browserslist-db": "^1.2.0"
+      },
+      "bin": {
+        "browserslist": "cli.js"
+      },
+      "engines": {
+        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
+      }
+    },
+    "node_modules/buffer": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz",
+      "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.2.1"
+      }
+    },
+    "node_modules/buffer-crc32": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-1.0.0.tgz",
+      "integrity": "sha512-Db1SbgBS/fg/392AblrMJk97KggmvYhr4pB5ZIMTWtaivCPMWLkmb7m21cJvpvgK+J3nsU2CmmixNBZx4vFj/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "license": "MIT"
+    },
+    "node_modules/bundle-name": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/bundle-name/-/bundle-name-4.1.0.tgz",
+      "integrity": "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==",
+      "license": "MIT",
+      "dependencies": {
+        "run-applescript": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/c12": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/c12/-/c12-3.3.3.tgz",
+      "integrity": "sha512-750hTRvgBy5kcMNPdh95Qo+XUBeGo8C7nsKSmedDmaQI+E0r82DwHeM6vBewDe4rGFbnxoa4V9pw+sPh5+Iz8Q==",
+      "license": "MIT",
+      "dependencies": {
+        "chokidar": "^5.0.0",
+        "confbox": "^0.2.2",
+        "defu": "^6.1.4",
+        "dotenv": "^17.2.3",
+        "exsolve": "^1.0.8",
+        "giget": "^2.0.0",
+        "jiti": "^2.6.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "perfect-debounce": "^2.0.0",
+        "pkg-types": "^2.3.0",
+        "rc9": "^2.1.2"
+      },
+      "peerDependencies": {
+        "magicast": "*"
+      },
+      "peerDependenciesMeta": {
+        "magicast": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/c12/node_modules/citty": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/citty/-/citty-0.1.6.tgz",
+      "integrity": "sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ==",
+      "license": "MIT",
+      "dependencies": {
+        "consola": "^3.2.3"
+      }
+    },
+    "node_modules/c12/node_modules/giget": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/giget/-/giget-2.0.0.tgz",
+      "integrity": "sha512-L5bGsVkxJbJgdnwyuheIunkGatUF/zssUoxxjACCseZYAVbaqdh9Tsmmlkl8vYan09H7sbvKt4pS8GqKLBrEzA==",
+      "license": "MIT",
+      "dependencies": {
+        "citty": "^0.1.6",
+        "consola": "^3.4.0",
+        "defu": "^6.1.4",
+        "node-fetch-native": "^1.6.6",
+        "nypm": "^0.6.0",
+        "pathe": "^2.0.3"
+      },
+      "bin": {
+        "giget": "dist/cli.mjs"
+      }
+    },
+    "node_modules/c12/node_modules/rc9": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/rc9/-/rc9-2.1.2.tgz",
+      "integrity": "sha512-btXCnMmRIBINM2LDZoEmOogIZU7Qe7zn4BpomSKZ/ykbLObuBdvG+mFq11DL6fjH1DRwHhrlgtYWG96bJiC7Cg==",
+      "license": "MIT",
+      "dependencies": {
+        "defu": "^6.1.4",
+        "destr": "^2.0.3"
+      }
+    },
+    "node_modules/cac": {
+      "version": "6.7.14",
+      "resolved": "https://registry.npmjs.org/cac/-/cac-6.7.14.tgz",
+      "integrity": "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==",
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/caniuse-api": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/caniuse-api/-/caniuse-api-3.0.0.tgz",
+      "integrity": "sha512-bsTwuIg/BZZK/vreVTYYbSWoe2F+71P7K5QGEX+pT250DZbfU1MQ5prOKpPR+LL6uWKK3KMwMCAS74QB3Um1uw==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.0.0",
+        "caniuse-lite": "^1.0.0",
+        "lodash.memoize": "^4.1.2",
+        "lodash.uniq": "^4.5.0"
+      }
+    },
+    "node_modules/caniuse-lite": {
+      "version": "1.0.30001781",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001781.tgz",
+      "integrity": "sha512-RdwNCyMsNBftLjW6w01z8bKEvT6e/5tpPVEgtn22TiLGlstHOVecsX2KHFkD5e/vRnIE4EGzpuIODb3mtswtkw==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "CC-BY-4.0"
+    },
+    "node_modules/chokidar": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz",
+      "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==",
+      "license": "MIT",
+      "dependencies": {
+        "readdirp": "^5.0.0"
+      },
+      "engines": {
+        "node": ">= 20.19.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/chownr": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/chownr/-/chownr-3.0.0.tgz",
+      "integrity": "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/citty": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/citty/-/citty-0.2.1.tgz",
+      "integrity": "sha512-kEV95lFBhQgtogAPlQfJJ0WGVSokvLr/UEoFPiKKOXF7pl98HfUVUD0ejsuTCld/9xH9vogSywZ5KqHzXrZpqg==",
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/clipboardy": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/clipboardy/-/clipboardy-4.0.0.tgz",
+      "integrity": "sha512-5mOlNS0mhX0707P2I0aZ2V/cmHUEO/fL7VFLqszkhUsxt7RwnmrInf/eEQKlf5GzvYeHIjT+Ov1HRfNmymlG0w==",
+      "license": "MIT",
+      "dependencies": {
+        "execa": "^8.0.1",
+        "is-wsl": "^3.1.0",
+        "is64bit": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cliui": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz",
+      "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==",
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^7.2.0",
+        "strip-ansi": "^7.1.0",
+        "wrap-ansi": "^9.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/cluster-key-slot": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/cluster-key-slot/-/cluster-key-slot-1.1.2.tgz",
+      "integrity": "sha512-RMr0FhtfXemyinomL4hrWcYJxmX6deFdCxpJzhDttxgO1+bcCnkk+9drydLVDmAMG7NE6aN/fl4F7ucU/90gAA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "license": "MIT"
+    },
+    "node_modules/colord": {
+      "version": "2.9.3",
+      "resolved": "https://registry.npmjs.org/colord/-/colord-2.9.3.tgz",
+      "integrity": "sha512-jeC1axXpnb0/2nn/Y1LPuLdgXBLH7aDcHu4KEKfqw3CUhX7ZpfBSlPKyqXE6btIgEzfWtrX3/tyBCaCvXvMkOw==",
+      "license": "MIT"
+    },
+    "node_modules/commondir": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/commondir/-/commondir-1.0.1.tgz",
+      "integrity": "sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==",
+      "license": "MIT"
+    },
+    "node_modules/compatx": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/compatx/-/compatx-0.2.0.tgz",
+      "integrity": "sha512-6gLRNt4ygsi5NyMVhceOCFv14CIdDFN7fQjX1U4+47qVE/+kjPoXMK65KWK+dWxmFzMTuKazoQ9sch6pM0p5oA==",
+      "license": "MIT"
+    },
+    "node_modules/compress-commons": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/compress-commons/-/compress-commons-6.0.2.tgz",
+      "integrity": "sha512-6FqVXeETqWPoGcfzrXb37E50NP0LXT8kAMu5ooZayhWWdgEY4lBEEcbQNXtkuKQsGduxiIcI4gOTsxTmuq/bSg==",
+      "license": "MIT",
+      "dependencies": {
+        "crc-32": "^1.2.0",
+        "crc32-stream": "^6.0.0",
+        "is-stream": "^2.0.1",
+        "normalize-path": "^3.0.0",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/compress-commons/node_modules/is-stream": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/confbox": {
+      "version": "0.2.4",
+      "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.2.4.tgz",
+      "integrity": "sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==",
+      "license": "MIT"
+    },
+    "node_modules/consola": {
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/consola/-/consola-3.4.2.tgz",
+      "integrity": "sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==",
+      "license": "MIT",
+      "engines": {
+        "node": "^14.18.0 || >=16.10.0"
+      }
+    },
+    "node_modules/convert-source-map": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+      "license": "MIT"
+    },
+    "node_modules/cookie-es": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-2.0.0.tgz",
+      "integrity": "sha512-RAj4E421UYRgqokKUmotqAwuplYw15qtdXfY+hGzgCJ/MBjCVZcSoHK/kH9kocfjRjcDME7IiDWR/1WX1TM2Pg==",
+      "license": "MIT"
+    },
+    "node_modules/core-util-is": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
+      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
+      "license": "MIT"
+    },
+    "node_modules/crc-32": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/crc-32/-/crc-32-1.2.2.tgz",
+      "integrity": "sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==",
+      "license": "Apache-2.0",
+      "bin": {
+        "crc32": "bin/crc32.njs"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/crc32-stream": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/crc32-stream/-/crc32-stream-6.0.0.tgz",
+      "integrity": "sha512-piICUB6ei4IlTv1+653yq5+KoqfBYmj9bw6LqXoOneTMDXk5nM1qt12mFW1caG3LlJXEKW1Bp0WggEmIfQB34g==",
+      "license": "MIT",
+      "dependencies": {
+        "crc-32": "^1.2.0",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/croner": {
+      "version": "10.0.1",
+      "resolved": "https://registry.npmjs.org/croner/-/croner-10.0.1.tgz",
+      "integrity": "sha512-ixNtAJndqh173VQ4KodSdJEI6nuioBWI0V1ITNKhZZsO0pEMoDxz539T4FTTbSZ/xIOSuDnzxLVRqBVSvPNE2g==",
+      "funding": [
+        {
+          "type": "other",
+          "url": "https://paypal.me/hexagonpp"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/hexagon"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0"
+      }
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/cross-spawn/node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "license": "ISC"
+    },
+    "node_modules/cross-spawn/node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/crossws": {
+      "version": "0.3.5",
+      "resolved": "https://registry.npmjs.org/crossws/-/crossws-0.3.5.tgz",
+      "integrity": "sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==",
+      "license": "MIT",
+      "dependencies": {
+        "uncrypto": "^0.1.3"
+      }
+    },
+    "node_modules/css-declaration-sorter": {
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/css-declaration-sorter/-/css-declaration-sorter-7.3.1.tgz",
+      "integrity": "sha512-gz6x+KkgNCjxq3Var03pRYLhyNfwhkKF1g/yoLgDNtFvVu0/fOLV9C8fFEZRjACp/XQLumjAYo7JVjzH3wLbxA==",
+      "license": "ISC",
+      "engines": {
+        "node": "^14 || ^16 || >=18"
+      },
+      "peerDependencies": {
+        "postcss": "^8.0.9"
+      }
+    },
+    "node_modules/css-select": {
+      "version": "5.2.2",
+      "resolved": "https://registry.npmjs.org/css-select/-/css-select-5.2.2.tgz",
+      "integrity": "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==",
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "boolbase": "^1.0.0",
+        "css-what": "^6.1.0",
+        "domhandler": "^5.0.2",
+        "domutils": "^3.0.1",
+        "nth-check": "^2.0.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/fb55"
+      }
+    },
+    "node_modules/css-tree": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz",
+      "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==",
+      "license": "MIT",
+      "dependencies": {
+        "mdn-data": "2.27.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0"
+      }
+    },
+    "node_modules/css-what": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.2.2.tgz",
+      "integrity": "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">= 6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/fb55"
+      }
+    },
+    "node_modules/cssesc": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
+      "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
+      "license": "MIT",
+      "bin": {
+        "cssesc": "bin/cssesc"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/cssnano": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/cssnano/-/cssnano-7.1.3.tgz",
+      "integrity": "sha512-mLFHQAzyapMVFLiJIn7Ef4C2UCEvtlTlbyILR6B5ZsUAV3D/Pa761R5uC1YPhyBkRd3eqaDm2ncaNrD7R4mTRg==",
+      "license": "MIT",
+      "dependencies": {
+        "cssnano-preset-default": "^7.0.11",
+        "lilconfig": "^3.1.3"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/cssnano"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/cssnano-preset-default": {
+      "version": "7.0.11",
+      "resolved": "https://registry.npmjs.org/cssnano-preset-default/-/cssnano-preset-default-7.0.11.tgz",
+      "integrity": "sha512-waWlAMuCakP7//UCY+JPrQS1z0OSLeOXk2sKWJximKWGupVxre50bzPlvpbUwZIDylhf/ptf0Pk+Yf7C+hoa3g==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "css-declaration-sorter": "^7.2.0",
+        "cssnano-utils": "^5.0.1",
+        "postcss-calc": "^10.1.1",
+        "postcss-colormin": "^7.0.6",
+        "postcss-convert-values": "^7.0.9",
+        "postcss-discard-comments": "^7.0.6",
+        "postcss-discard-duplicates": "^7.0.2",
+        "postcss-discard-empty": "^7.0.1",
+        "postcss-discard-overridden": "^7.0.1",
+        "postcss-merge-longhand": "^7.0.5",
+        "postcss-merge-rules": "^7.0.8",
+        "postcss-minify-font-values": "^7.0.1",
+        "postcss-minify-gradients": "^7.0.1",
+        "postcss-minify-params": "^7.0.6",
+        "postcss-minify-selectors": "^7.0.6",
+        "postcss-normalize-charset": "^7.0.1",
+        "postcss-normalize-display-values": "^7.0.1",
+        "postcss-normalize-positions": "^7.0.1",
+        "postcss-normalize-repeat-style": "^7.0.1",
+        "postcss-normalize-string": "^7.0.1",
+        "postcss-normalize-timing-functions": "^7.0.1",
+        "postcss-normalize-unicode": "^7.0.6",
+        "postcss-normalize-url": "^7.0.1",
+        "postcss-normalize-whitespace": "^7.0.1",
+        "postcss-ordered-values": "^7.0.2",
+        "postcss-reduce-initial": "^7.0.6",
+        "postcss-reduce-transforms": "^7.0.1",
+        "postcss-svgo": "^7.1.1",
+        "postcss-unique-selectors": "^7.0.5"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/cssnano-utils": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/cssnano-utils/-/cssnano-utils-5.0.1.tgz",
+      "integrity": "sha512-ZIP71eQgG9JwjVZsTPSqhc6GHgEr53uJ7tK5///VfyWj6Xp2DBmixWHqJgPno+PqATzn48pL42ww9x5SSGmhZg==",
+      "license": "MIT",
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/csso": {
+      "version": "5.0.5",
+      "resolved": "https://registry.npmjs.org/csso/-/csso-5.0.5.tgz",
+      "integrity": "sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==",
+      "license": "MIT",
+      "dependencies": {
+        "css-tree": "~2.2.0"
+      },
+      "engines": {
+        "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0",
+        "npm": ">=7.0.0"
+      }
+    },
+    "node_modules/csso/node_modules/css-tree": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-2.2.1.tgz",
+      "integrity": "sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==",
+      "license": "MIT",
+      "dependencies": {
+        "mdn-data": "2.0.28",
+        "source-map-js": "^1.0.1"
+      },
+      "engines": {
+        "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0",
+        "npm": ">=7.0.0"
+      }
+    },
+    "node_modules/csso/node_modules/mdn-data": {
+      "version": "2.0.28",
+      "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.28.tgz",
+      "integrity": "sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==",
+      "license": "CC0-1.0"
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "license": "MIT"
+    },
+    "node_modules/db0": {
+      "version": "0.3.4",
+      "resolved": "https://registry.npmjs.org/db0/-/db0-0.3.4.tgz",
+      "integrity": "sha512-RiXXi4WaNzPTHEOu8UPQKMooIbqOEyqA1t7Z6MsdxSCeb8iUC9ko3LcmsLmeUt2SM5bctfArZKkRQggKZz7JNw==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@electric-sql/pglite": "*",
+        "@libsql/client": "*",
+        "better-sqlite3": "*",
+        "drizzle-orm": "*",
+        "mysql2": "*",
+        "sqlite3": "*"
+      },
+      "peerDependenciesMeta": {
+        "@electric-sql/pglite": {
+          "optional": true
+        },
+        "@libsql/client": {
+          "optional": true
+        },
+        "better-sqlite3": {
+          "optional": true
+        },
+        "drizzle-orm": {
+          "optional": true
+        },
+        "mysql2": {
+          "optional": true
+        },
+        "sqlite3": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/deepmerge": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz",
+      "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/default-browser": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz",
+      "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==",
+      "license": "MIT",
+      "dependencies": {
+        "bundle-name": "^4.1.0",
+        "default-browser-id": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/default-browser-id": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz",
+      "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/define-lazy-prop": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-3.0.0.tgz",
+      "integrity": "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/defu": {
+      "version": "6.1.4",
+      "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.4.tgz",
+      "integrity": "sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==",
+      "license": "MIT"
+    },
+    "node_modules/denque": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz",
+      "integrity": "sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/destr": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz",
+      "integrity": "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==",
+      "license": "MIT"
+    },
+    "node_modules/detect-libc": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/devalue": {
+      "version": "5.6.4",
+      "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.6.4.tgz",
+      "integrity": "sha512-Gp6rDldRsFh/7XuouDbxMH3Mx8GMCcgzIb1pDTvNyn8pZGQ22u+Wa+lGV9dQCltFQ7uVw0MhRyb8XDskNFOReA==",
+      "license": "MIT"
+    },
+    "node_modules/diff": {
+      "version": "8.0.4",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-8.0.4.tgz",
+      "integrity": "sha512-DPi0FmjiSU5EvQV0++GFDOJ9ASQUVFh5kD+OzOnYdi7n3Wpm9hWWGfB/O2blfHcMVTL5WkQXSnRiK9makhrcnw==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
+    "node_modules/dom-serializer": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz",
+      "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==",
+      "license": "MIT",
+      "dependencies": {
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.2",
+        "entities": "^4.2.0"
+      },
+      "funding": {
+        "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"
+      }
+    },
+    "node_modules/dom-serializer/node_modules/entities": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz",
+      "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/domelementtype": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",
+      "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fb55"
+        }
+      ],
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/domhandler": {
+      "version": "5.0.3",
+      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz",
+      "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==",
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "domelementtype": "^2.3.0"
+      },
+      "engines": {
+        "node": ">= 4"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/domhandler?sponsor=1"
+      }
+    },
+    "node_modules/domutils": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz",
+      "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==",
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "dom-serializer": "^2.0.0",
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.3"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/domutils?sponsor=1"
+      }
+    },
+    "node_modules/dot-prop": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/dot-prop/-/dot-prop-10.1.0.tgz",
+      "integrity": "sha512-MVUtAugQMOff5RnBy2d9N31iG0lNwg1qAoAOn7pOK5wf94WIaE3My2p3uwTQuvS2AcqchkcR3bHByjaM0mmi7Q==",
+      "license": "MIT",
+      "dependencies": {
+        "type-fest": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "17.3.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.3.1.tgz",
+      "integrity": "sha512-IO8C/dzEb6O3F9/twg6ZLXz164a2fhTnEWb95H23Dm4OuN+92NmEAlTrupP9VW6Jm3sO26tQlqyvyi4CsnY9GA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/driver.js": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/driver.js/-/driver.js-1.8.0.tgz",
+      "integrity": "sha512-+8/IO7h1v14IzWh2GP60N7T3PFZweXwdn5e5POuxRSBoCYUojsBxzqawPeXh3YZIibRy7EehYNEyxe7slwwtdg==",
+      "license": "MIT"
+    },
+    "node_modules/duplexer": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/duplexer/-/duplexer-0.1.2.tgz",
+      "integrity": "sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg==",
+      "license": "MIT"
+    },
+    "node_modules/eastasianwidth": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
+      "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
+      "license": "MIT"
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
+    "node_modules/electron-to-chromium": {
+      "version": "1.5.328",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.328.tgz",
+      "integrity": "sha512-QNQ5l45DzYytThO21403XN3FvK0hOkWDG8viNf6jqS42msJ8I4tGDSpBCgvDRRPnkffafiwAym2X2eHeGD2V0w==",
+      "license": "ISC"
+    },
+    "node_modules/emoji-regex": {
+      "version": "10.6.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",
+      "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==",
+      "license": "MIT"
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/enhanced-resolve": {
+      "version": "5.20.1",
+      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.20.1.tgz",
+      "integrity": "sha512-Qohcme7V1inbAfvjItgw0EaxVX5q2rdVEZHRBrEQdRZTssLDGsL8Lwrznl8oQ/6kuTJONLaDcGjkNP247XEhcA==",
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.4",
+        "tapable": "^2.3.0"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
+    "node_modules/entities": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
+      "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/error-stack-parser-es": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/error-stack-parser-es/-/error-stack-parser-es-1.0.5.tgz",
+      "integrity": "sha512-5qucVt2XcuGMcEGgWI7i+yZpmpByQ8J1lHhcL7PwqCwu9FPP3VUXzT4ltHe5i2z9dePwEHcDVOAfSnHsOlCXRA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/errx": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/errx/-/errx-0.1.0.tgz",
+      "integrity": "sha512-fZmsRiDNv07K6s2KkKFTiD2aIvECa7++PKyD5NC32tpRw46qZA3sOz+aM+/V9V0GDHxVTKLziveV4JhzBHDp9Q==",
+      "license": "MIT"
+    },
+    "node_modules/es-module-lexer": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.0.0.tgz",
+      "integrity": "sha512-5POEcUuZybH7IdmGsD8wlf0AI55wMecM9rVBTI/qEAy2c1kTOm3DjFYjrBdI2K3BaJjJYfYFeRtM0t9ssnRuxw==",
+      "license": "MIT"
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.4.tgz",
+      "integrity": "sha512-Rq4vbHnYkK5fws5NF7MYTU68FPRE1ajX7heQ/8QXXWqNgqqJ/GkmmyxIzUnf2Sr/bakf8l54716CcMGHYhMrrQ==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.4",
+        "@esbuild/android-arm": "0.27.4",
+        "@esbuild/android-arm64": "0.27.4",
+        "@esbuild/android-x64": "0.27.4",
+        "@esbuild/darwin-arm64": "0.27.4",
+        "@esbuild/darwin-x64": "0.27.4",
+        "@esbuild/freebsd-arm64": "0.27.4",
+        "@esbuild/freebsd-x64": "0.27.4",
+        "@esbuild/linux-arm": "0.27.4",
+        "@esbuild/linux-arm64": "0.27.4",
+        "@esbuild/linux-ia32": "0.27.4",
+        "@esbuild/linux-loong64": "0.27.4",
+        "@esbuild/linux-mips64el": "0.27.4",
+        "@esbuild/linux-ppc64": "0.27.4",
+        "@esbuild/linux-riscv64": "0.27.4",
+        "@esbuild/linux-s390x": "0.27.4",
+        "@esbuild/linux-x64": "0.27.4",
+        "@esbuild/netbsd-arm64": "0.27.4",
+        "@esbuild/netbsd-x64": "0.27.4",
+        "@esbuild/openbsd-arm64": "0.27.4",
+        "@esbuild/openbsd-x64": "0.27.4",
+        "@esbuild/openharmony-arm64": "0.27.4",
+        "@esbuild/sunos-x64": "0.27.4",
+        "@esbuild/win32-arm64": "0.27.4",
+        "@esbuild/win32-ia32": "0.27.4",
+        "@esbuild/win32-x64": "0.27.4"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",
+      "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/estree-walker": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz",
+      "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
+      "license": "MIT"
+    },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/event-target-shim": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz",
+      "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/events": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
+      "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.8.x"
+      }
+    },
+    "node_modules/events-universal": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/events-universal/-/events-universal-1.0.1.tgz",
+      "integrity": "sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bare-events": "^2.7.0"
+      }
+    },
+    "node_modules/execa": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-8.0.1.tgz",
+      "integrity": "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==",
+      "license": "MIT",
+      "dependencies": {
+        "cross-spawn": "^7.0.3",
+        "get-stream": "^8.0.1",
+        "human-signals": "^5.0.0",
+        "is-stream": "^3.0.0",
+        "merge-stream": "^2.0.0",
+        "npm-run-path": "^5.1.0",
+        "onetime": "^6.0.0",
+        "signal-exit": "^4.1.0",
+        "strip-final-newline": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=16.17"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/execa?sponsor=1"
+      }
+    },
+    "node_modules/exsolve": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/exsolve/-/exsolve-1.0.8.tgz",
+      "integrity": "sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==",
+      "license": "MIT"
+    },
+    "node_modules/externality": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/externality/-/externality-1.0.2.tgz",
+      "integrity": "sha512-LyExtJWKxtgVzmgtEHyQtLFpw1KFhQphF9nTG8TpAIVkiI/xQ3FJh75tRFLYl4hkn7BNIIdLJInuDAavX35pMw==",
+      "license": "MIT",
+      "dependencies": {
+        "enhanced-resolve": "^5.14.1",
+        "mlly": "^1.3.0",
+        "pathe": "^1.1.1",
+        "ufo": "^1.1.2"
+      }
+    },
+    "node_modules/externality/node_modules/pathe": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz",
+      "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==",
+      "license": "MIT"
+    },
+    "node_modules/fast-fifo": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/fast-fifo/-/fast-fifo-1.3.2.tgz",
+      "integrity": "sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==",
+      "license": "MIT"
+    },
+    "node_modules/fast-glob": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
+      "license": "MIT",
+      "dependencies": {
+        "@nodelib/fs.stat": "^2.0.2",
+        "@nodelib/fs.walk": "^1.2.3",
+        "glob-parent": "^5.1.2",
+        "merge2": "^1.3.0",
+        "micromatch": "^4.0.8"
+      },
+      "engines": {
+        "node": ">=8.6.0"
+      }
+    },
+    "node_modules/fast-npm-meta": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/fast-npm-meta/-/fast-npm-meta-1.4.2.tgz",
+      "integrity": "sha512-XXyd9d3ie/JeIIjm6WeKalvapGGFI4ShAjPJM78vgUFYzoEsuNSjvvVTuht0XZcwbVdOnEEGzhxwguRbxkIcDg==",
+      "license": "MIT",
+      "bin": {
+        "fast-npm-meta": "dist/cli.mjs"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/fastq": {
+      "version": "1.20.1",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz",
+      "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==",
+      "license": "ISC",
+      "dependencies": {
+        "reusify": "^1.0.4"
+      }
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/file-uri-to-path": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz",
+      "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==",
+      "license": "MIT"
+    },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "license": "MIT",
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/foreground-child": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
+      "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
+      "license": "ISC",
+      "dependencies": {
+        "cross-spawn": "^7.0.6",
+        "signal-exit": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/fraction.js": {
+      "version": "5.3.4",
+      "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-5.3.4.tgz",
+      "integrity": "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ==",
+      "license": "MIT",
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/rawify"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
+      "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/fuse.js": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/fuse.js/-/fuse.js-7.1.0.tgz",
+      "integrity": "sha512-trLf4SzuuUxfusZADLINj+dE8clK1frKdmqiJNb1Es75fmI5oY6X2mxLVUciLLjxqw/xr72Dhy+lER6dGd02FQ==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/fzf": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/fzf/-/fzf-0.5.2.tgz",
+      "integrity": "sha512-Tt4kuxLXFKHy8KT40zwsUPUkg1CrsgY25FxA2U/j/0WgEDCk3ddc/zLTCCcbSHX9FcKtLuVaDGtGE/STWC+j3Q==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/gensync": {
+      "version": "1.0.0-beta.2",
+      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
+      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "license": "ISC",
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/get-east-asian-width": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.5.0.tgz",
+      "integrity": "sha512-CQ+bEO+Tva/qlmw24dCejulK5pMzVnUOFOijVogd3KQs07HnRIgp8TGipvCCRT06xeYEbpbgwaCxglFyiuIcmA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/get-port-please": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.2.0.tgz",
+      "integrity": "sha512-I9QVvBw5U/hw3RmWpYKRumUeaDgxTPd401x364rLmWBJcOQ753eov1eTgzDqRG9bqFIfDc7gfzcQEWrUri3o1A==",
+      "license": "MIT"
+    },
+    "node_modules/get-stream": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-8.0.1.tgz",
+      "integrity": "sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/giget": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/giget/-/giget-3.2.0.tgz",
+      "integrity": "sha512-GvHTWcykIR/fP8cj8dMpuMMkvaeJfPvYnhq0oW+chSeIr+ldX21ifU2Ms6KBoyKZQZmVaUAAhQ2EZ68KJF8a7A==",
+      "license": "MIT",
+      "bin": {
+        "giget": "dist/cli.mjs"
+      }
+    },
+    "node_modules/glob": {
+      "version": "13.0.6",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz",
+      "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==",
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "minimatch": "^10.2.2",
+        "minipass": "^7.1.3",
+        "path-scurry": "^2.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/glob-parent": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+      "license": "ISC",
+      "dependencies": {
+        "is-glob": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/global-directory": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/global-directory/-/global-directory-4.0.1.tgz",
+      "integrity": "sha512-wHTUcDUoZ1H5/0iVqEudYW4/kAlN5cZ3j/bXn0Dpbizl9iaUVeWSHqiOjsgk6OW2bkLclbBjzewBz6weQ1zA2Q==",
+      "license": "MIT",
+      "dependencies": {
+        "ini": "4.1.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/globby": {
+      "version": "16.2.0",
+      "resolved": "https://registry.npmjs.org/globby/-/globby-16.2.0.tgz",
+      "integrity": "sha512-QrJia2qDf5BB/V6HYlDTs0I0lBahyjLzpGQg3KT7FnCdTonAyPy2RtY802m2k4ALx6Dp752f82WsOczEVr3l6Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@sindresorhus/merge-streams": "^4.0.0",
+        "fast-glob": "^3.3.3",
+        "ignore": "^7.0.5",
+        "is-path-inside": "^4.0.0",
+        "slash": "^5.1.0",
+        "unicorn-magic": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "license": "ISC"
+    },
+    "node_modules/gzip-size": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/gzip-size/-/gzip-size-7.0.0.tgz",
+      "integrity": "sha512-O1Ld7Dr+nqPnmGpdhzLmMTQ4vAsD+rHwMm1NLUmoUFFymBOMKxCCrtDxqdBRYXdeEPEi3SyoR4TizJLQrnKBNA==",
+      "license": "MIT",
+      "dependencies": {
+        "duplexer": "^0.1.2"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/h3": {
+      "version": "1.15.10",
+      "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.10.tgz",
+      "integrity": "sha512-YzJeWSkDZxAhvmp8dexjRK5hxziRO7I9m0N53WhvYL5NiWfkUkzssVzY9jvGu0HBoLFW6+duYmNSn6MaZBCCtg==",
+      "license": "MIT",
+      "dependencies": {
+        "cookie-es": "^1.2.2",
+        "crossws": "^0.3.5",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "iron-webcrypto": "^1.2.1",
+        "node-mock-http": "^1.0.4",
+        "radix3": "^1.1.2",
+        "ufo": "^1.6.3",
+        "uncrypto": "^0.1.3"
+      }
+    },
+    "node_modules/h3/node_modules/cookie-es": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-1.2.2.tgz",
+      "integrity": "sha512-+W7VmiVINB+ywl1HGXJXmrqkOhpKrIiVZV6tQuV54ZyQC7MMuBt81Vc336GMLoHBq5hV/F9eXgt5Mnx0Rha5Fg==",
+      "license": "MIT"
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/hookable": {
+      "version": "5.5.3",
+      "resolved": "https://registry.npmjs.org/hookable/-/hookable-5.5.3.tgz",
+      "integrity": "sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==",
+      "license": "MIT"
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/http-shutdown": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/http-shutdown/-/http-shutdown-1.2.2.tgz",
+      "integrity": "sha512-S9wWkJ/VSY9/k4qcjG318bqJNruzE4HySUhFYknwmu6LBP97KLLfwNf+n4V1BHurvFNkSKLFnK/RsuUnRTf9Vw==",
+      "license": "MIT",
+      "engines": {
+        "iojs": ">= 1.0.0",
+        "node": ">= 0.12.0"
+      }
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+      "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "^7.1.2",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/httpxy": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/httpxy/-/httpxy-0.3.1.tgz",
+      "integrity": "sha512-XjG/CEoofEisMrnFr0D6U6xOZ4mRfnwcYQ9qvvnT4lvnX8BoeA3x3WofB75D+vZwpaobFVkBIHrZzoK40w8XSw==",
+      "license": "MIT"
+    },
+    "node_modules/human-signals": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-5.0.0.tgz",
+      "integrity": "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=16.17.0"
+      }
+    },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/ignore": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz",
+      "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/image-meta": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/image-meta/-/image-meta-0.2.2.tgz",
+      "integrity": "sha512-3MOLanc3sb3LNGWQl1RlQlNWURE5g32aUphrDyFeCsxBTk08iE3VNe4CwsUZ0Qs1X+EfX0+r29Sxdpza4B+yRA==",
+      "license": "MIT"
+    },
+    "node_modules/impound": {
+      "version": "1.1.5",
+      "resolved": "https://registry.npmjs.org/impound/-/impound-1.1.5.tgz",
+      "integrity": "sha512-5AUn+QE0UofqNHu5f2Skf6Svukdg4ehOIq8O0EtqIx4jta0CDZYBPqpIHt0zrlUTiFVYlLpeH39DoikXBjPKpA==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/trace-mapping": "^0.3.31",
+        "es-module-lexer": "^2.0.0",
+        "pathe": "^2.0.3",
+        "unplugin": "^3.0.0",
+        "unplugin-utils": "^0.3.1"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ini": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-4.1.1.tgz",
+      "integrity": "sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==",
+      "license": "ISC",
+      "engines": {
+        "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
+      }
+    },
+    "node_modules/ioredis": {
+      "version": "5.10.1",
+      "resolved": "https://registry.npmjs.org/ioredis/-/ioredis-5.10.1.tgz",
+      "integrity": "sha512-HuEDBTI70aYdx1v6U97SbNx9F1+svQKBDo30o0b9fw055LMepzpOOd0Ccg9Q6tbqmBSJaMuY0fB7yw9/vjBYCA==",
+      "license": "MIT",
+      "dependencies": {
+        "@ioredis/commands": "1.5.1",
+        "cluster-key-slot": "^1.1.0",
+        "debug": "^4.3.4",
+        "denque": "^2.1.0",
+        "lodash.defaults": "^4.2.0",
+        "lodash.isarguments": "^3.1.0",
+        "redis-errors": "^1.2.0",
+        "redis-parser": "^3.0.0",
+        "standard-as-callback": "^2.1.0"
+      },
+      "engines": {
+        "node": ">=12.22.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/ioredis"
+      }
+    },
+    "node_modules/iron-webcrypto": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/iron-webcrypto/-/iron-webcrypto-1.2.1.tgz",
+      "integrity": "sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/brc-dd"
+      }
+    },
+    "node_modules/is-core-module": {
+      "version": "2.16.1",
+      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
+      "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==",
+      "license": "MIT",
+      "dependencies": {
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-docker": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz",
+      "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==",
+      "license": "MIT",
+      "bin": {
+        "is-docker": "cli.js"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "license": "MIT",
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-in-ssh": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-in-ssh/-/is-in-ssh-1.0.0.tgz",
+      "integrity": "sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-inside-container": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz",
+      "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==",
+      "license": "MIT",
+      "dependencies": {
+        "is-docker": "^3.0.0"
+      },
+      "bin": {
+        "is-inside-container": "cli.js"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-installed-globally": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-installed-globally/-/is-installed-globally-1.0.0.tgz",
+      "integrity": "sha512-K55T22lfpQ63N4KEN57jZUAaAYqYHEe8veb/TycJRk9DdSCLLcovXz/mL6mOnhQaZsQGwPhuFopdQIlqGSEjiQ==",
+      "license": "MIT",
+      "dependencies": {
+        "global-directory": "^4.0.1",
+        "is-path-inside": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-module": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-module/-/is-module-1.0.0.tgz",
+      "integrity": "sha512-51ypPSPCoTEIN9dy5Oy+h4pShgJmPCygKfyRCISBI+JoWT/2oJvK8QPxmwv7b/p239jXrm9M1mlQbyKJ5A152g==",
+      "license": "MIT"
+    },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
+    "node_modules/is-path-inside": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-4.0.0.tgz",
+      "integrity": "sha512-lJJV/5dYS+RcL8uQdBDW9c9uWFLLBNRyFhnAKXw5tVqLlKZ4RMGZKv+YQ/IA3OhD+RpbJa1LLFM1FQPGyIXvOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-reference": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/is-reference/-/is-reference-1.2.1.tgz",
+      "integrity": "sha512-U82MsXXiFIrjCK4otLT+o2NA2Cd2g5MLoOVXUZjIOhLurrRxpEXzI8O0KZHr3IjLvlAH1kTPYSuqer5T9ZVBKQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "*"
+      }
+    },
+    "node_modules/is-stream": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz",
+      "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-wsl": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz",
+      "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==",
+      "license": "MIT",
+      "dependencies": {
+        "is-inside-container": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is64bit": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/is64bit/-/is64bit-2.0.0.tgz",
+      "integrity": "sha512-jv+8jaWCl0g2lSBkNSVXdzfBA0npK1HGC2KtWM9FumFRoGS94g3NbCCLVnCYHLjp4GrW2KZeeSTMo5ddtznmGw==",
+      "license": "MIT",
+      "dependencies": {
+        "system-architecture": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "license": "MIT"
+    },
+    "node_modules/isexe": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-4.0.0.tgz",
+      "integrity": "sha512-FFUtZMpoZ8RqHS3XeXEmHWLA4thH+ZxCv2lOiPIn1Xc7CxrqhWzNSDzD+/chS/zbYezmiwWLdQC09JdQKmthOw==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/jackspeak": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz",
+      "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==",
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "@isaacs/cliui": "^8.0.2"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      },
+      "optionalDependencies": {
+        "@pkgjs/parseargs": "^0.11.0"
+      }
+    },
+    "node_modules/jiti": {
+      "version": "2.6.1",
+      "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz",
+      "integrity": "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==",
+      "license": "MIT",
+      "bin": {
+        "jiti": "lib/jiti-cli.mjs"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "license": "MIT"
+    },
+    "node_modules/jsesc": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
+      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
+      "license": "MIT",
+      "bin": {
+        "jsesc": "bin/jsesc"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "license": "MIT",
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/kleur": {
+      "version": "4.1.5",
+      "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz",
+      "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/klona": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/klona/-/klona-2.0.6.tgz",
+      "integrity": "sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/knitwork": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/knitwork/-/knitwork-1.3.0.tgz",
+      "integrity": "sha512-4LqMNoONzR43B1W0ek0fhXMsDNW/zxa1NdFAVMY+k28pgZLovR4G3PB5MrpTxCy1QaZCqNoiaKPr5w5qZHfSNw==",
+      "license": "MIT"
+    },
+    "node_modules/launch-editor": {
+      "version": "2.13.2",
+      "resolved": "https://registry.npmjs.org/launch-editor/-/launch-editor-2.13.2.tgz",
+      "integrity": "sha512-4VVDnbOpLXy/s8rdRCSXb+zfMeFR0WlJWpET1iA9CQdlZDfwyLjUuGQzXU4VeOoey6AicSAluWan7Etga6Kcmg==",
+      "license": "MIT",
+      "dependencies": {
+        "picocolors": "^1.1.1",
+        "shell-quote": "^1.8.3"
+      }
+    },
+    "node_modules/lazystream": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/lazystream/-/lazystream-1.0.1.tgz",
+      "integrity": "sha512-b94GiNHQNy6JNTrt5w6zNyffMrNkXZb3KTkCZJb2V1xaEGCk093vkZ2jk3tpaeP33/OiXC+WvK9AxUebnf5nbw==",
+      "license": "MIT",
+      "dependencies": {
+        "readable-stream": "^2.0.5"
+      },
+      "engines": {
+        "node": ">= 0.6.3"
+      }
+    },
+    "node_modules/lazystream/node_modules/readable-stream": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+      "license": "MIT",
+      "dependencies": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "node_modules/lazystream/node_modules/safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "license": "MIT"
+    },
+    "node_modules/lazystream/node_modules/string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
+    "node_modules/lilconfig": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz",
+      "integrity": "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antonk52"
+      }
+    },
+    "node_modules/listhen": {
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/listhen/-/listhen-1.9.0.tgz",
+      "integrity": "sha512-I8oW2+QL5KJo8zXNWX046M134WchxsXC7SawLPvRQpogCbkyQIaFxPE89A2HiwR7vAK2Dm2ERBAmyjTYGYEpBg==",
+      "license": "MIT",
+      "dependencies": {
+        "@parcel/watcher": "^2.4.1",
+        "@parcel/watcher-wasm": "^2.4.1",
+        "citty": "^0.1.6",
+        "clipboardy": "^4.0.0",
+        "consola": "^3.2.3",
+        "crossws": ">=0.2.0 <0.4.0",
+        "defu": "^6.1.4",
+        "get-port-please": "^3.1.2",
+        "h3": "^1.12.0",
+        "http-shutdown": "^1.2.2",
+        "jiti": "^2.1.2",
+        "mlly": "^1.7.1",
+        "node-forge": "^1.3.1",
+        "pathe": "^1.1.2",
+        "std-env": "^3.7.0",
+        "ufo": "^1.5.4",
+        "untun": "^0.1.3",
+        "uqr": "^0.1.2"
+      },
+      "bin": {
+        "listen": "bin/listhen.mjs",
+        "listhen": "bin/listhen.mjs"
+      }
+    },
+    "node_modules/listhen/node_modules/citty": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/citty/-/citty-0.1.6.tgz",
+      "integrity": "sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ==",
+      "license": "MIT",
+      "dependencies": {
+        "consola": "^3.2.3"
+      }
+    },
+    "node_modules/listhen/node_modules/pathe": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz",
+      "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==",
+      "license": "MIT"
+    },
+    "node_modules/listhen/node_modules/std-env": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz",
+      "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==",
+      "license": "MIT"
+    },
+    "node_modules/local-pkg": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/local-pkg/-/local-pkg-1.1.2.tgz",
+      "integrity": "sha512-arhlxbFRmoQHl33a0Zkle/YWlmNwoyt6QNZEIJcqNbdrsix5Lvc4HyyI3EnwxTYlZYc32EbYrQ8SzEZ7dqgg9A==",
+      "license": "MIT",
+      "dependencies": {
+        "mlly": "^1.7.4",
+        "pkg-types": "^2.3.0",
+        "quansync": "^0.2.11"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/lodash": {
+      "version": "4.17.23",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz",
+      "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.defaults": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/lodash.defaults/-/lodash.defaults-4.2.0.tgz",
+      "integrity": "sha512-qjxPLHd3r5DnsdGacqOMU6pb/avJzdh9tFX2ymgoZE27BmjXrNy/y4LoaiTeAb+O3gL8AfpJGtqfX/ae2leYYQ==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.isarguments": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/lodash.isarguments/-/lodash.isarguments-3.1.0.tgz",
+      "integrity": "sha512-chi4NHZlZqZD18a0imDHnZPrDeBbTtVN7GXMwuGdRH9qotxAjYs3aVLKc7zNOG9eddR5Ksd8rvFEBc9SsggPpg==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.memoize": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz",
+      "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.uniq": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz",
+      "integrity": "sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==",
+      "license": "MIT"
+    },
+    "node_modules/lru-cache": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
+      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^3.0.2"
+      }
+    },
+    "node_modules/lucide-vue-next": {
+      "version": "0.511.0",
+      "resolved": "https://registry.npmjs.org/lucide-vue-next/-/lucide-vue-next-0.511.0.tgz",
+      "integrity": "sha512-VSv0F3pHniGN7JMMzDcLFNMQbl8381+shNnHwV8hi+El7xl2ZL8qdNuzPoiBViKk8mTKK5K3ZDfmE/wEcTZVIQ==",
+      "license": "ISC",
+      "peerDependencies": {
+        "vue": ">=3.0.1"
+      }
+    },
+    "node_modules/magic-regexp": {
+      "version": "0.10.0",
+      "resolved": "https://registry.npmjs.org/magic-regexp/-/magic-regexp-0.10.0.tgz",
+      "integrity": "sha512-Uly1Bu4lO1hwHUW0CQeSWuRtzCMNO00CmXtS8N6fyvB3B979GOEEeAkiTUDsmbYLAbvpUS/Kt5c4ibosAzVyVg==",
+      "license": "MIT",
+      "dependencies": {
+        "estree-walker": "^3.0.3",
+        "magic-string": "^0.30.12",
+        "mlly": "^1.7.2",
+        "regexp-tree": "^0.1.27",
+        "type-level-regexp": "~0.1.17",
+        "ufo": "^1.5.4",
+        "unplugin": "^2.0.0"
+      }
+    },
+    "node_modules/magic-regexp/node_modules/estree-walker": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0"
+      }
+    },
+    "node_modules/magic-regexp/node_modules/unplugin": {
+      "version": "2.3.11",
+      "resolved": "https://registry.npmjs.org/unplugin/-/unplugin-2.3.11.tgz",
+      "integrity": "sha512-5uKD0nqiYVzlmCRs01Fhs2BdkEgBS3SAVP6ndrBsuK42iC2+JHyxM05Rm9G8+5mkmRtzMZGY8Ct5+mliZxU/Ww==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.5",
+        "acorn": "^8.15.0",
+        "picomatch": "^4.0.3",
+        "webpack-virtual-modules": "^0.6.2"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/magic-string": {
+      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.5"
+      }
+    },
+    "node_modules/magic-string-ast": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/magic-string-ast/-/magic-string-ast-1.0.3.tgz",
+      "integrity": "sha512-CvkkH1i81zl7mmb94DsRiFeG9V2fR2JeuK8yDgS8oiZSFa++wWLEgZ5ufEOyLHbvSbD1gTRKv9NdX69Rnvr9JA==",
+      "license": "MIT",
+      "dependencies": {
+        "magic-string": "^0.30.19"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      }
+    },
+    "node_modules/magicast": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.5.2.tgz",
+      "integrity": "sha512-E3ZJh4J3S9KfwdjZhe2afj6R9lGIN5Pher1pF39UGrXRqq/VDaGVIGN13BjHd2u8B61hArAGOnso7nBOouW3TQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.0",
+        "@babel/types": "^7.29.0",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/mdn-data": {
+      "version": "2.27.1",
+      "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz",
+      "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==",
+      "license": "CC0-1.0"
+    },
+    "node_modules/merge-stream": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
+      "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
+      "license": "MIT"
+    },
+    "node_modules/merge2": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
+      "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/micromatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+      "license": "MIT",
+      "dependencies": {
+        "braces": "^3.0.3",
+        "picomatch": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/micromatch/node_modules/picomatch": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/mime": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-4.1.0.tgz",
+      "integrity": "sha512-X5ju04+cAzsojXKes0B/S4tcYtFAJ6tTMuSPBEn9CPGlrWr8Fiw7qYeLT0XyH80HSoAoqWCaz+MWKh22P7G1cw==",
+      "funding": [
+        "https://github.com/sponsors/broofa"
+      ],
+      "license": "MIT",
+      "bin": {
+        "mime": "bin/cli.js"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.54.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz",
+      "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "^1.54.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/mimic-fn": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz",
+      "integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/minimatch": {
+      "version": "10.2.4",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz",
+      "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==",
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "brace-expansion": "^5.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
+      "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      }
+    },
+    "node_modules/minizlib": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-3.1.0.tgz",
+      "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==",
+      "license": "MIT",
+      "dependencies": {
+        "minipass": "^7.1.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/mlly": {
+      "version": "1.8.2",
+      "resolved": "https://registry.npmjs.org/mlly/-/mlly-1.8.2.tgz",
+      "integrity": "sha512-d+ObxMQFmbt10sretNDytwt85VrbkhhUA/JBGm1MPaWJ65Cl4wOgLaB1NYvJSZ0Ef03MMEU/0xpPMXUIQ29UfA==",
+      "license": "MIT",
+      "dependencies": {
+        "acorn": "^8.16.0",
+        "pathe": "^2.0.3",
+        "pkg-types": "^1.3.1",
+        "ufo": "^1.6.3"
+      }
+    },
+    "node_modules/mlly/node_modules/confbox": {
+      "version": "0.1.8",
+      "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.1.8.tgz",
+      "integrity": "sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==",
+      "license": "MIT"
+    },
+    "node_modules/mlly/node_modules/pkg-types": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-1.3.1.tgz",
+      "integrity": "sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==",
+      "license": "MIT",
+      "dependencies": {
+        "confbox": "^0.1.8",
+        "mlly": "^1.7.4",
+        "pathe": "^2.0.1"
+      }
+    },
+    "node_modules/mocked-exports": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/mocked-exports/-/mocked-exports-0.1.1.tgz",
+      "integrity": "sha512-aF7yRQr/Q0O2/4pIXm6PZ5G+jAd7QS4Yu8m+WEeEHGnbo+7mE36CbLSDQiXYV8bVL3NfmdeqPJct0tUlnjVSnA==",
+      "license": "MIT"
+    },
+    "node_modules/mrmime": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/mrmime/-/mrmime-2.0.1.tgz",
+      "integrity": "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/muggle-string": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/muggle-string/-/muggle-string-0.4.1.tgz",
+      "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==",
+      "license": "MIT"
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/nanotar": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/nanotar/-/nanotar-0.3.0.tgz",
+      "integrity": "sha512-Kv2JYYiCzt16Kt5QwAc9BFG89xfPNBx+oQL4GQXD9nLqPkZBiNaqaCWtwnbk/q7UVsTYevvM1b0UF8zmEI4pCg==",
+      "license": "MIT"
+    },
+    "node_modules/nitropack": {
+      "version": "2.13.2",
+      "resolved": "https://registry.npmjs.org/nitropack/-/nitropack-2.13.2.tgz",
+      "integrity": "sha512-R5TMzSBoTDG4gi6Y+pvvyCNnooShHePHsHxMLP9EXDGdrlR5RvNdSd4e5k8z0/EzP9Ske7ABRMDWg6O7Dm2OYw==",
+      "license": "MIT",
+      "dependencies": {
+        "@cloudflare/kv-asset-handler": "^0.4.2",
+        "@rollup/plugin-alias": "^6.0.0",
+        "@rollup/plugin-commonjs": "^29.0.2",
+        "@rollup/plugin-inject": "^5.0.5",
+        "@rollup/plugin-json": "^6.1.0",
+        "@rollup/plugin-node-resolve": "^16.0.3",
+        "@rollup/plugin-replace": "^6.0.3",
+        "@rollup/plugin-terser": "^1.0.0",
+        "@vercel/nft": "^1.4.0",
+        "archiver": "^7.0.1",
+        "c12": "^3.3.3",
+        "chokidar": "^5.0.0",
+        "citty": "^0.2.1",
+        "compatx": "^0.2.0",
+        "confbox": "^0.2.4",
+        "consola": "^3.4.2",
+        "cookie-es": "^2.0.0",
+        "croner": "^10.0.1",
+        "crossws": "^0.3.5",
+        "db0": "^0.3.4",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "dot-prop": "^10.1.0",
+        "esbuild": "^0.27.4",
+        "escape-string-regexp": "^5.0.0",
+        "etag": "^1.8.1",
+        "exsolve": "^1.0.8",
+        "globby": "^16.1.1",
+        "gzip-size": "^7.0.0",
+        "h3": "^1.15.9",
+        "hookable": "^5.5.3",
+        "httpxy": "^0.3.1",
+        "ioredis": "^5.10.1",
+        "jiti": "^2.6.1",
+        "klona": "^2.0.6",
+        "knitwork": "^1.3.0",
+        "listhen": "^1.9.0",
+        "magic-string": "^0.30.21",
+        "magicast": "^0.5.2",
+        "mime": "^4.1.0",
+        "mlly": "^1.8.2",
+        "node-fetch-native": "^1.6.7",
+        "node-mock-http": "^1.0.4",
+        "ofetch": "^1.5.1",
+        "ohash": "^2.0.11",
+        "pathe": "^2.0.3",
+        "perfect-debounce": "^2.1.0",
+        "pkg-types": "^2.3.0",
+        "pretty-bytes": "^7.1.0",
+        "radix3": "^1.1.2",
+        "rollup": "^4.59.0",
+        "rollup-plugin-visualizer": "^7.0.1",
+        "scule": "^1.3.0",
+        "semver": "^7.7.4",
+        "serve-placeholder": "^2.0.2",
+        "serve-static": "^2.2.1",
+        "source-map": "^0.7.6",
+        "std-env": "^4.0.0",
+        "ufo": "^1.6.3",
+        "ultrahtml": "^1.6.0",
+        "uncrypto": "^0.1.3",
+        "unctx": "^2.5.0",
+        "unenv": "^2.0.0-rc.24",
+        "unimport": "^6.0.2",
+        "unplugin-utils": "^0.3.1",
+        "unstorage": "^1.17.4",
+        "untyped": "^2.0.0",
+        "unwasm": "^0.5.3",
+        "youch": "^4.1.0",
+        "youch-core": "^0.3.3"
+      },
+      "bin": {
+        "nitro": "dist/cli/index.mjs",
+        "nitropack": "dist/cli/index.mjs"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "xml2js": "^0.6.2"
+      },
+      "peerDependenciesMeta": {
+        "xml2js": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/node-addon-api": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-7.1.1.tgz",
+      "integrity": "sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==",
+      "license": "MIT"
+    },
+    "node_modules/node-fetch": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
+      "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==",
+      "license": "MIT",
+      "dependencies": {
+        "whatwg-url": "^5.0.0"
+      },
+      "engines": {
+        "node": "4.x || >=6.0.0"
+      },
+      "peerDependencies": {
+        "encoding": "^0.1.0"
+      },
+      "peerDependenciesMeta": {
+        "encoding": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/node-fetch-native": {
+      "version": "1.6.7",
+      "resolved": "https://registry.npmjs.org/node-fetch-native/-/node-fetch-native-1.6.7.tgz",
+      "integrity": "sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==",
+      "license": "MIT"
+    },
+    "node_modules/node-forge": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/node-forge/-/node-forge-1.4.0.tgz",
+      "integrity": "sha512-LarFH0+6VfriEhqMMcLX2F7SwSXeWwnEAJEsYm5QKWchiVYVvJyV9v7UDvUv+w5HO23ZpQTXDv/GxdDdMyOuoQ==",
+      "license": "(BSD-3-Clause OR GPL-2.0)",
+      "engines": {
+        "node": ">= 6.13.0"
+      }
+    },
+    "node_modules/node-gyp-build": {
+      "version": "4.8.4",
+      "resolved": "https://registry.npmjs.org/node-gyp-build/-/node-gyp-build-4.8.4.tgz",
+      "integrity": "sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ==",
+      "license": "MIT",
+      "bin": {
+        "node-gyp-build": "bin.js",
+        "node-gyp-build-optional": "optional.js",
+        "node-gyp-build-test": "build-test.js"
+      }
+    },
+    "node_modules/node-mock-http": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.4.tgz",
+      "integrity": "sha512-8DY+kFsDkNXy1sJglUfuODx1/opAGJGyrTuFqEoN90oRc2Vk0ZbD4K2qmKXBBEhZQzdKHIVfEJpDU8Ak2NJEvQ==",
+      "license": "MIT"
+    },
+    "node_modules/node-releases": {
+      "version": "2.0.36",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.36.tgz",
+      "integrity": "sha512-TdC8FSgHz8Mwtw9g5L4gR/Sh9XhSP/0DEkQxfEFXOpiul5IiHgHan2VhYYb6agDSfp4KuvltmGApc8HMgUrIkA==",
+      "license": "MIT"
+    },
+    "node_modules/nopt": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/nopt/-/nopt-8.1.0.tgz",
+      "integrity": "sha512-ieGu42u/Qsa4TFktmaKEwM6MQH0pOWnaB3htzh0JRtx84+Mebc0cbZYN5bC+6WTZ4+77xrL9Pn5m7CV6VIkV7A==",
+      "license": "ISC",
+      "dependencies": {
+        "abbrev": "^3.0.0"
+      },
+      "bin": {
+        "nopt": "bin/nopt.js"
+      },
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
+    "node_modules/normalize-path": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/npm-run-path": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-5.3.0.tgz",
+      "integrity": "sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==",
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^4.0.0"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/npm-run-path/node_modules/path-key": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+      "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/nth-check": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
+      "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==",
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "boolbase": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/nth-check?sponsor=1"
+      }
+    },
+    "node_modules/nuxt": {
+      "version": "3.21.2",
+      "resolved": "https://registry.npmjs.org/nuxt/-/nuxt-3.21.2.tgz",
+      "integrity": "sha512-XzZFj2KMK16zE0TfrGpjvgc378wZWvDzIpunHOHOT0Jj8zbV5qT1uQKaJb+fAHv6lf1A4nOMMWHrTmjAK4u0Zg==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@dxup/nuxt": "^0.4.0",
+        "@nuxt/cli": "^3.34.0",
+        "@nuxt/devtools": "^3.2.3",
+        "@nuxt/kit": "3.21.2",
+        "@nuxt/nitro-server": "3.21.2",
+        "@nuxt/schema": "3.21.2",
+        "@nuxt/telemetry": "^2.7.0",
+        "@nuxt/vite-builder": "3.21.2",
+        "@unhead/vue": "^2.1.12",
+        "@vue/shared": "^3.5.30",
+        "c12": "^3.3.3",
+        "chokidar": "^5.0.0",
+        "compatx": "^0.2.0",
+        "consola": "^3.4.2",
+        "cookie-es": "^2.0.0",
+        "defu": "^6.1.4",
+        "destr": "^2.0.5",
+        "devalue": "^5.6.3",
+        "errx": "^0.1.0",
+        "escape-string-regexp": "^5.0.0",
+        "exsolve": "^1.0.8",
+        "h3": "^1.15.6",
+        "hookable": "^5.5.3",
+        "ignore": "^7.0.5",
+        "impound": "^1.1.5",
+        "jiti": "^2.6.1",
+        "klona": "^2.0.6",
+        "knitwork": "^1.3.0",
+        "magic-string": "^0.30.21",
+        "mlly": "^1.8.1",
+        "nanotar": "^0.3.0",
+        "nypm": "^0.6.5",
+        "ofetch": "^1.5.1",
+        "ohash": "^2.0.11",
+        "on-change": "^6.0.2",
+        "oxc-minify": "^0.117.0",
+        "oxc-parser": "^0.117.0",
+        "oxc-transform": "^0.117.0",
+        "oxc-walker": "^0.7.0",
+        "pathe": "^2.0.3",
+        "perfect-debounce": "^2.1.0",
+        "pkg-types": "^2.3.0",
+        "rou3": "^0.8.1",
+        "scule": "^1.3.0",
+        "semver": "^7.7.4",
+        "std-env": "^4.0.0",
+        "tinyglobby": "^0.2.15",
+        "ufo": "^1.6.3",
+        "ultrahtml": "^1.6.0",
+        "uncrypto": "^0.1.3",
+        "unctx": "^2.5.0",
+        "unimport": "^6.0.1",
+        "unplugin": "^3.0.0",
+        "unplugin-vue-router": "^0.19.2",
+        "untyped": "^2.0.0",
+        "vue": "^3.5.30",
+        "vue-router": "^4.6.4"
+      },
+      "bin": {
+        "nuxi": "bin/nuxt.mjs",
+        "nuxt": "bin/nuxt.mjs"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "@parcel/watcher": "^2.1.0",
+        "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@parcel/watcher": {
+          "optional": true
+        },
+        "@types/node": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/nuxt/node_modules/@nuxt/schema": {
+      "version": "3.21.2",
+      "resolved": "https://registry.npmjs.org/@nuxt/schema/-/schema-3.21.2.tgz",
+      "integrity": "sha512-yZaJrZizRP4OQVCM7qRG3xIJ1xZ59npgg9jd3ng+BDs5ZvLqYP9rXnFikShc8EPUtR6+zhSPgKgy6L8wWcBKzQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/shared": "^3.5.30",
+        "defu": "^6.1.4",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0",
+        "std-env": "^4.0.0"
+      },
+      "engines": {
+        "node": "^14.18.0 || >=16.10.0"
+      }
+    },
+    "node_modules/nypm": {
+      "version": "0.6.5",
+      "resolved": "https://registry.npmjs.org/nypm/-/nypm-0.6.5.tgz",
+      "integrity": "sha512-K6AJy1GMVyfyMXRVB88700BJqNUkByijGJM8kEHpLdcAt+vSQAVfkWWHYzuRXHSY6xA2sNc5RjTj0p9rE2izVQ==",
+      "license": "MIT",
+      "dependencies": {
+        "citty": "^0.2.0",
+        "pathe": "^2.0.3",
+        "tinyexec": "^1.0.2"
+      },
+      "bin": {
+        "nypm": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/obug": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.1.tgz",
+      "integrity": "sha512-uTqF9MuPraAQ+IsnPf366RG4cP9RtUi7MLO1N3KEc+wb0a6yKpeL0lmk2IB1jY5KHPAlTc6T/JRdC/YqxHNwkQ==",
+      "funding": [
+        "https://github.com/sponsors/sxzz",
+        "https://opencollective.com/debug"
+      ],
+      "license": "MIT"
+    },
+    "node_modules/ofetch": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-1.5.1.tgz",
+      "integrity": "sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==",
+      "license": "MIT",
+      "dependencies": {
+        "destr": "^2.0.5",
+        "node-fetch-native": "^1.6.7",
+        "ufo": "^1.6.1"
+      }
+    },
+    "node_modules/ohash": {
+      "version": "2.0.11",
+      "resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.11.tgz",
+      "integrity": "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==",
+      "license": "MIT"
+    },
+    "node_modules/on-change": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/on-change/-/on-change-6.0.2.tgz",
+      "integrity": "sha512-08+12qcOVEA0fS9g/VxKS27HaT94nRutUT77J2dr8zv/unzXopvhBuF8tNLWsoLQ5IgrQ6eptGeGqUYat82U1w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/on-change?sponsor=1"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/onetime": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/onetime/-/onetime-6.0.0.tgz",
+      "integrity": "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==",
+      "license": "MIT",
+      "dependencies": {
+        "mimic-fn": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/open": {
+      "version": "11.0.0",
+      "resolved": "https://registry.npmjs.org/open/-/open-11.0.0.tgz",
+      "integrity": "sha512-smsWv2LzFjP03xmvFoJ331ss6h+jixfA4UUV/Bsiyuu4YJPfN+FIQGOIiv4w9/+MoHkfkJ22UIaQWRVFRfH6Vw==",
+      "license": "MIT",
+      "dependencies": {
+        "default-browser": "^5.4.0",
+        "define-lazy-prop": "^3.0.0",
+        "is-in-ssh": "^1.0.0",
+        "is-inside-container": "^1.0.0",
+        "powershell-utils": "^0.1.0",
+        "wsl-utils": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/oxc-minify": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/oxc-minify/-/oxc-minify-0.117.0.tgz",
+      "integrity": "sha512-JHsv/b+bmBJkAzkHXgTN7RThloVxLHPT0ojHfjqxVeHuQB7LPpLUbJ2qfwz37sto9stZ9+AVwUP4b3gtR7p/Tw==",
+      "license": "MIT",
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/Boshen"
+      },
+      "optionalDependencies": {
+        "@oxc-minify/binding-android-arm-eabi": "0.117.0",
+        "@oxc-minify/binding-android-arm64": "0.117.0",
+        "@oxc-minify/binding-darwin-arm64": "0.117.0",
+        "@oxc-minify/binding-darwin-x64": "0.117.0",
+        "@oxc-minify/binding-freebsd-x64": "0.117.0",
+        "@oxc-minify/binding-linux-arm-gnueabihf": "0.117.0",
+        "@oxc-minify/binding-linux-arm-musleabihf": "0.117.0",
+        "@oxc-minify/binding-linux-arm64-gnu": "0.117.0",
+        "@oxc-minify/binding-linux-arm64-musl": "0.117.0",
+        "@oxc-minify/binding-linux-ppc64-gnu": "0.117.0",
+        "@oxc-minify/binding-linux-riscv64-gnu": "0.117.0",
+        "@oxc-minify/binding-linux-riscv64-musl": "0.117.0",
+        "@oxc-minify/binding-linux-s390x-gnu": "0.117.0",
+        "@oxc-minify/binding-linux-x64-gnu": "0.117.0",
+        "@oxc-minify/binding-linux-x64-musl": "0.117.0",
+        "@oxc-minify/binding-openharmony-arm64": "0.117.0",
+        "@oxc-minify/binding-wasm32-wasi": "0.117.0",
+        "@oxc-minify/binding-win32-arm64-msvc": "0.117.0",
+        "@oxc-minify/binding-win32-ia32-msvc": "0.117.0",
+        "@oxc-minify/binding-win32-x64-msvc": "0.117.0"
+      }
+    },
+    "node_modules/oxc-parser": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/oxc-parser/-/oxc-parser-0.117.0.tgz",
+      "integrity": "sha512-l3cbgK5wUvWDVNWM/JFU77qDdGZK1wudnLsFcrRyNo/bL1CyU8pC25vDhMHikVY29lbK2InTWsX42RxVSutUdQ==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@oxc-project/types": "^0.117.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/Boshen"
+      },
+      "optionalDependencies": {
+        "@oxc-parser/binding-android-arm-eabi": "0.117.0",
+        "@oxc-parser/binding-android-arm64": "0.117.0",
+        "@oxc-parser/binding-darwin-arm64": "0.117.0",
+        "@oxc-parser/binding-darwin-x64": "0.117.0",
+        "@oxc-parser/binding-freebsd-x64": "0.117.0",
+        "@oxc-parser/binding-linux-arm-gnueabihf": "0.117.0",
+        "@oxc-parser/binding-linux-arm-musleabihf": "0.117.0",
+        "@oxc-parser/binding-linux-arm64-gnu": "0.117.0",
+        "@oxc-parser/binding-linux-arm64-musl": "0.117.0",
+        "@oxc-parser/binding-linux-ppc64-gnu": "0.117.0",
+        "@oxc-parser/binding-linux-riscv64-gnu": "0.117.0",
+        "@oxc-parser/binding-linux-riscv64-musl": "0.117.0",
+        "@oxc-parser/binding-linux-s390x-gnu": "0.117.0",
+        "@oxc-parser/binding-linux-x64-gnu": "0.117.0",
+        "@oxc-parser/binding-linux-x64-musl": "0.117.0",
+        "@oxc-parser/binding-openharmony-arm64": "0.117.0",
+        "@oxc-parser/binding-wasm32-wasi": "0.117.0",
+        "@oxc-parser/binding-win32-arm64-msvc": "0.117.0",
+        "@oxc-parser/binding-win32-ia32-msvc": "0.117.0",
+        "@oxc-parser/binding-win32-x64-msvc": "0.117.0"
+      }
+    },
+    "node_modules/oxc-transform": {
+      "version": "0.117.0",
+      "resolved": "https://registry.npmjs.org/oxc-transform/-/oxc-transform-0.117.0.tgz",
+      "integrity": "sha512-u1Stl2uhDh9bFuOGjGXQIqx46IRUNMyHQkq59LayXNGS2flNv7RpZpRSWs5S5deuNP6jJZ12gtMBze+m4dOhmw==",
+      "license": "MIT",
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/Boshen"
+      },
+      "optionalDependencies": {
+        "@oxc-transform/binding-android-arm-eabi": "0.117.0",
+        "@oxc-transform/binding-android-arm64": "0.117.0",
+        "@oxc-transform/binding-darwin-arm64": "0.117.0",
+        "@oxc-transform/binding-darwin-x64": "0.117.0",
+        "@oxc-transform/binding-freebsd-x64": "0.117.0",
+        "@oxc-transform/binding-linux-arm-gnueabihf": "0.117.0",
+        "@oxc-transform/binding-linux-arm-musleabihf": "0.117.0",
+        "@oxc-transform/binding-linux-arm64-gnu": "0.117.0",
+        "@oxc-transform/binding-linux-arm64-musl": "0.117.0",
+        "@oxc-transform/binding-linux-ppc64-gnu": "0.117.0",
+        "@oxc-transform/binding-linux-riscv64-gnu": "0.117.0",
+        "@oxc-transform/binding-linux-riscv64-musl": "0.117.0",
+        "@oxc-transform/binding-linux-s390x-gnu": "0.117.0",
+        "@oxc-transform/binding-linux-x64-gnu": "0.117.0",
+        "@oxc-transform/binding-linux-x64-musl": "0.117.0",
+        "@oxc-transform/binding-openharmony-arm64": "0.117.0",
+        "@oxc-transform/binding-wasm32-wasi": "0.117.0",
+        "@oxc-transform/binding-win32-arm64-msvc": "0.117.0",
+        "@oxc-transform/binding-win32-ia32-msvc": "0.117.0",
+        "@oxc-transform/binding-win32-x64-msvc": "0.117.0"
+      }
+    },
+    "node_modules/oxc-walker": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/oxc-walker/-/oxc-walker-0.7.0.tgz",
+      "integrity": "sha512-54B4KUhrzbzc4sKvKwVYm7E2PgeROpGba0/2nlNZMqfDyca+yOor5IMb4WLGBatGDT0nkzYdYuzylg7n3YfB7A==",
+      "license": "MIT",
+      "dependencies": {
+        "magic-regexp": "^0.10.0"
+      },
+      "peerDependencies": {
+        "oxc-parser": ">=0.98.0"
+      }
+    },
+    "node_modules/package-json-from-dist": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+      "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+      "license": "BlueOak-1.0.0"
+    },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/path-browserify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz",
+      "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==",
+      "license": "MIT"
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+      "license": "MIT"
+    },
+    "node_modules/path-scurry": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz",
+      "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==",
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "lru-cache": "^11.0.0",
+        "minipass": "^7.1.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/path-scurry/node_modules/lru-cache": {
+      "version": "11.2.7",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz",
+      "integrity": "sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/pathe": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
+      "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
+      "license": "MIT"
+    },
+    "node_modules/perfect-debounce": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/perfect-debounce/-/perfect-debounce-2.1.0.tgz",
+      "integrity": "sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==",
+      "license": "MIT"
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pkg-types": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-2.3.0.tgz",
+      "integrity": "sha512-SIqCzDRg0s9npO5XQ3tNZioRY1uK06lA41ynBC1YmFTmnY6FjUjVt6s4LoADmwoig1qqD0oK8h1p/8mlMx8Oig==",
+      "license": "MIT",
+      "dependencies": {
+        "confbox": "^0.2.2",
+        "exsolve": "^1.0.7",
+        "pathe": "^2.0.3"
+      }
+    },
+    "node_modules/postcss": {
+      "version": "8.5.8",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.8.tgz",
+      "integrity": "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/postcss-calc": {
+      "version": "10.1.1",
+      "resolved": "https://registry.npmjs.org/postcss-calc/-/postcss-calc-10.1.1.tgz",
+      "integrity": "sha512-NYEsLHh8DgG/PRH2+G9BTuUdtf9ViS+vdoQ0YA5OQdGsfN4ztiwtDWNtBl9EKeqNMFnIu8IKZ0cLxEQ5r5KVMw==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-selector-parser": "^7.0.0",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12 || ^20.9 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.38"
+      }
+    },
+    "node_modules/postcss-colormin": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/postcss-colormin/-/postcss-colormin-7.0.6.tgz",
+      "integrity": "sha512-oXM2mdx6IBTRm39797QguYzVEWzbdlFiMNfq88fCCN1Wepw3CYmJ/1/Ifa/KjWo+j5ZURDl2NTldLJIw51IeNQ==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "caniuse-api": "^3.0.0",
+        "colord": "^2.9.3",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-convert-values": {
+      "version": "7.0.9",
+      "resolved": "https://registry.npmjs.org/postcss-convert-values/-/postcss-convert-values-7.0.9.tgz",
+      "integrity": "sha512-l6uATQATZaCa0bckHV+r6dLXfWtUBKXxO3jK+AtxxJJtgMPD+VhhPCCx51I4/5w8U5uHV67g3w7PXj+V3wlMlg==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-discard-comments": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/postcss-discard-comments/-/postcss-discard-comments-7.0.6.tgz",
+      "integrity": "sha512-Sq+Fzj1Eg5/CPf1ERb0wS1Im5cvE2gDXCE+si4HCn1sf+jpQZxDI4DXEp8t77B/ImzDceWE2ebJQFXdqZ6GRJw==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-selector-parser": "^7.1.1"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-discard-duplicates": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/postcss-discard-duplicates/-/postcss-discard-duplicates-7.0.2.tgz",
+      "integrity": "sha512-eTonaQvPZ/3i1ASDHOKkYwAybiM45zFIc7KXils4mQmHLqIswXD9XNOKEVxtTFnsmwYzF66u4LMgSr0abDlh5w==",
+      "license": "MIT",
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-discard-empty": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-discard-empty/-/postcss-discard-empty-7.0.1.tgz",
+      "integrity": "sha512-cFrJKZvcg/uxB6Ijr4l6qmn3pXQBna9zyrPC+sK0zjbkDUZew+6xDltSF7OeB7rAtzaaMVYSdbod+sZOCWnMOg==",
+      "license": "MIT",
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-discard-overridden": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-discard-overridden/-/postcss-discard-overridden-7.0.1.tgz",
+      "integrity": "sha512-7c3MMjjSZ/qYrx3uc1940GSOzN1Iqjtlqe8uoSg+qdVPYyRb0TILSqqmtlSFuE4mTDECwsm397Ya7iXGzfF7lg==",
+      "license": "MIT",
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-merge-longhand": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/postcss-merge-longhand/-/postcss-merge-longhand-7.0.5.tgz",
+      "integrity": "sha512-Kpu5v4Ys6QI59FxmxtNB/iHUVDn9Y9sYw66D6+SZoIk4QTz1prC4aYkhIESu+ieG1iylod1f8MILMs1Em3mmIw==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0",
+        "stylehacks": "^7.0.5"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-merge-rules": {
+      "version": "7.0.8",
+      "resolved": "https://registry.npmjs.org/postcss-merge-rules/-/postcss-merge-rules-7.0.8.tgz",
+      "integrity": "sha512-BOR1iAM8jnr7zoQSlpeBmCsWV5Uudi/+5j7k05D0O/WP3+OFMPD86c1j/20xiuRtyt45bhxw/7hnhZNhW2mNFA==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "caniuse-api": "^3.0.0",
+        "cssnano-utils": "^5.0.1",
+        "postcss-selector-parser": "^7.1.1"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-minify-font-values": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-minify-font-values/-/postcss-minify-font-values-7.0.1.tgz",
+      "integrity": "sha512-2m1uiuJeTplll+tq4ENOQSzB8LRnSUChBv7oSyFLsJRtUgAAJGP6LLz0/8lkinTgxrmJSPOEhgY1bMXOQ4ZXhQ==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-minify-gradients": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-minify-gradients/-/postcss-minify-gradients-7.0.1.tgz",
+      "integrity": "sha512-X9JjaysZJwlqNkJbUDgOclyG3jZEpAMOfof6PUZjPnPrePnPG62pS17CjdM32uT1Uq1jFvNSff9l7kNbmMSL2A==",
+      "license": "MIT",
+      "dependencies": {
+        "colord": "^2.9.3",
+        "cssnano-utils": "^5.0.1",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-minify-params": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/postcss-minify-params/-/postcss-minify-params-7.0.6.tgz",
+      "integrity": "sha512-YOn02gC68JijlaXVuKvFSCvQOhTpblkcfDre2hb/Aaa58r2BIaK4AtE/cyZf2wV7YKAG+UlP9DT+By0ry1E4VQ==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "cssnano-utils": "^5.0.1",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-minify-selectors": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/postcss-minify-selectors/-/postcss-minify-selectors-7.0.6.tgz",
+      "integrity": "sha512-lIbC0jy3AAwDxEgciZlBullDiMBeBCT+fz5G8RcA9MWqh/hfUkpOI3vNDUNEZHgokaoiv0juB9Y8fGcON7rU/A==",
+      "license": "MIT",
+      "dependencies": {
+        "cssesc": "^3.0.0",
+        "postcss-selector-parser": "^7.1.1"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-charset": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-charset/-/postcss-normalize-charset-7.0.1.tgz",
+      "integrity": "sha512-sn413ofhSQHlZFae//m9FTOfkmiZ+YQXsbosqOWRiVQncU2BA3daX3n0VF3cG6rGLSFVc5Di/yns0dFfh8NFgQ==",
+      "license": "MIT",
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-display-values": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-display-values/-/postcss-normalize-display-values-7.0.1.tgz",
+      "integrity": "sha512-E5nnB26XjSYz/mGITm6JgiDpAbVuAkzXwLzRZtts19jHDUBFxZ0BkXAehy0uimrOjYJbocby4FVswA/5noOxrQ==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-positions": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-positions/-/postcss-normalize-positions-7.0.1.tgz",
+      "integrity": "sha512-pB/SzrIP2l50ZIYu+yQZyMNmnAcwyYb9R1fVWPRxm4zcUFCY2ign7rcntGFuMXDdd9L2pPNUgoODDk91PzRZuQ==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-repeat-style": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-repeat-style/-/postcss-normalize-repeat-style-7.0.1.tgz",
+      "integrity": "sha512-NsSQJ8zj8TIDiF0ig44Byo3Jk9e4gNt9x2VIlJudnQQ5DhWAHJPF4Tr1ITwyHio2BUi/I6Iv0HRO7beHYOloYQ==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-string": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-string/-/postcss-normalize-string-7.0.1.tgz",
+      "integrity": "sha512-QByrI7hAhsoze992kpbMlJSbZ8FuCEc1OT9EFbZ6HldXNpsdpZr+YXC5di3UEv0+jeZlHbZcoCADgb7a+lPmmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-timing-functions": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-timing-functions/-/postcss-normalize-timing-functions-7.0.1.tgz",
+      "integrity": "sha512-bHifyuuSNdKKsnNJ0s8fmfLMlvsQwYVxIoUBnowIVl2ZAdrkYQNGVB4RxjfpvkMjipqvbz0u7feBZybkl/6NJg==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-unicode": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-unicode/-/postcss-normalize-unicode-7.0.6.tgz",
+      "integrity": "sha512-z6bwTV84YW6ZvvNoaNLuzRW4/uWxDKYI1iIDrzk6D2YTL7hICApy+Q1LP6vBEsljX8FM7YSuV9qI79XESd4ddQ==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-url": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-url/-/postcss-normalize-url-7.0.1.tgz",
+      "integrity": "sha512-sUcD2cWtyK1AOL/82Fwy1aIVm/wwj5SdZkgZ3QiUzSzQQofrbq15jWJ3BA7Z+yVRwamCjJgZJN0I9IS7c6tgeQ==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-normalize-whitespace": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-whitespace/-/postcss-normalize-whitespace-7.0.1.tgz",
+      "integrity": "sha512-vsbgFHMFQrJBJKrUFJNZ2pgBeBkC2IvvoHjz1to0/0Xk7sII24T0qFOiJzG6Fu3zJoq/0yI4rKWi7WhApW+EFA==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-ordered-values": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/postcss-ordered-values/-/postcss-ordered-values-7.0.2.tgz",
+      "integrity": "sha512-AMJjt1ECBffF7CEON/Y0rekRLS6KsePU6PRP08UqYW4UGFRnTXNrByUzYK1h8AC7UWTZdQ9O3Oq9kFIhm0SFEw==",
+      "license": "MIT",
+      "dependencies": {
+        "cssnano-utils": "^5.0.1",
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-reduce-initial": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/postcss-reduce-initial/-/postcss-reduce-initial-7.0.6.tgz",
+      "integrity": "sha512-G6ZyK68AmrPdMB6wyeA37ejnnRG2S8xinJrZJnOv+IaRKf6koPAVbQsiC7MfkmXaGmF1UO+QCijb27wfpxuRNg==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "caniuse-api": "^3.0.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-reduce-transforms": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-reduce-transforms/-/postcss-reduce-transforms-7.0.1.tgz",
+      "integrity": "sha512-MhyEbfrm+Mlp/36hvZ9mT9DaO7dbncU0CvWI8V93LRkY6IYlu38OPg3FObnuKTUxJ4qA8HpurdQOo5CyqqO76g==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-selector-parser": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.1.tgz",
+      "integrity": "sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==",
+      "license": "MIT",
+      "dependencies": {
+        "cssesc": "^3.0.0",
+        "util-deprecate": "^1.0.2"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/postcss-svgo": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/postcss-svgo/-/postcss-svgo-7.1.1.tgz",
+      "integrity": "sha512-zU9H9oEDrUFKa0JB7w+IYL7Qs9ey1mZyjhbf0KLxwJDdDRtoPvCmaEfknzqfHj44QS9VD6c5sJnBAVYTLRg/Sg==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-value-parser": "^4.2.0",
+        "svgo": "^4.0.1"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >= 18"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-unique-selectors": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/postcss-unique-selectors/-/postcss-unique-selectors-7.0.5.tgz",
+      "integrity": "sha512-3QoYmEt4qg/rUWDn6Tc8+ZVPmbp4G1hXDtCNWDx0st8SjtCbRcxRXDDM1QrEiXGG3A45zscSJFb4QH90LViyxg==",
+      "license": "MIT",
+      "dependencies": {
+        "postcss-selector-parser": "^7.1.1"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/postcss-value-parser": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
+      "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
+      "license": "MIT"
+    },
+    "node_modules/powershell-utils": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/powershell-utils/-/powershell-utils-0.1.0.tgz",
+      "integrity": "sha512-dM0jVuXJPsDN6DvRpea484tCUaMiXWjuCn++HGTqUWzGDjv5tZkEZldAJ/UMlqRYGFrD/etByo4/xOuC/snX2A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/pretty-bytes": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-7.1.0.tgz",
+      "integrity": "sha512-nODzvTiYVRGRqAOvE84Vk5JDPyyxsVk0/fbA/bq7RqlnhksGpset09XTxbpvLTIjoaF7K8Z8DG8yHtKGTPSYRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/process": {
+      "version": "0.11.10",
+      "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
+      "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6.0"
+      }
+    },
+    "node_modules/process-nextick-args": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+      "license": "MIT"
+    },
+    "node_modules/quansync": {
+      "version": "0.2.11",
+      "resolved": "https://registry.npmjs.org/quansync/-/quansync-0.2.11.tgz",
+      "integrity": "sha512-AifT7QEbW9Nri4tAwR5M/uzpBuqfZf+zwaEM/QkzEjj7NBuFD2rBuy0K3dE+8wltbezDV7JMA0WfnCPYRSYbXA==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/antfu"
+        },
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/sxzz"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/queue-microtask": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
+      "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/radix3": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/radix3/-/radix3-1.1.2.tgz",
+      "integrity": "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==",
+      "license": "MIT"
+    },
+    "node_modules/range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/rc9": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/rc9/-/rc9-3.0.0.tgz",
+      "integrity": "sha512-MGOue0VqscKWQ104udASX/3GYDcKyPI4j4F8gu/jHHzglpmy9a/anZK3PNe8ug6aZFl+9GxLtdhe3kVZuMaQbA==",
+      "license": "MIT",
+      "dependencies": {
+        "defu": "^6.1.4",
+        "destr": "^2.0.5"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "4.7.0",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-4.7.0.tgz",
+      "integrity": "sha512-oIGGmcpTLwPga8Bn6/Z75SVaH1z5dUut2ibSyAMVhmUggWpmDn2dapB0n7f8nwaSiRtepAsfJyfXIO5DCVAODg==",
+      "license": "MIT",
+      "dependencies": {
+        "abort-controller": "^3.0.0",
+        "buffer": "^6.0.3",
+        "events": "^3.3.0",
+        "process": "^0.11.10",
+        "string_decoder": "^1.3.0"
+      },
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      }
+    },
+    "node_modules/readdir-glob": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/readdir-glob/-/readdir-glob-1.1.3.tgz",
+      "integrity": "sha512-v05I2k7xN8zXvPD9N+z/uhXPaj0sUFCe2rcWZIpBsqxfP7xXFQ0tipAd/wjj1YxWyWtUS5IDJpOG82JKt2EAVA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "minimatch": "^5.1.0"
+      }
+    },
+    "node_modules/readdir-glob/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "license": "MIT"
+    },
+    "node_modules/readdir-glob/node_modules/brace-expansion": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz",
+      "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==",
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/readdir-glob/node_modules/minimatch": {
+      "version": "5.1.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz",
+      "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==",
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/readdirp": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.0.0.tgz",
+      "integrity": "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 20.19.0"
+      },
+      "funding": {
+        "type": "individual",
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/redis-errors": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/redis-errors/-/redis-errors-1.2.0.tgz",
+      "integrity": "sha512-1qny3OExCf0UvUV/5wpYKf2YwPcOqXzkwKKSmKHiE6ZMQs5heeE/c8eXK+PNllPvmjgAbfnsbpkGZWy8cBpn9w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/redis-parser": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/redis-parser/-/redis-parser-3.0.0.tgz",
+      "integrity": "sha512-DJnGAeenTdpMEH6uAJRK/uiyEIH9WVsUmoLwzudwGJUwZPp80PDBWPHXSAGNPwNvIXAbe7MSUB1zQFugFml66A==",
+      "license": "MIT",
+      "dependencies": {
+        "redis-errors": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/regexp-tree": {
+      "version": "0.1.27",
+      "resolved": "https://registry.npmjs.org/regexp-tree/-/regexp-tree-0.1.27.tgz",
+      "integrity": "sha512-iETxpjK6YoRWJG5o6hXLwvjYAoW+FEZn9os0PD/b6AP6xQwsa/Y7lCVgIixBbUPMfhu+i2LtdeAqVTgGlQarfA==",
+      "license": "MIT",
+      "bin": {
+        "regexp-tree": "bin/regexp-tree"
+      }
+    },
+    "node_modules/resolve": {
+      "version": "1.22.11",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz",
+      "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==",
+      "license": "MIT",
+      "dependencies": {
+        "is-core-module": "^2.16.1",
+        "path-parse": "^1.0.7",
+        "supports-preserve-symlinks-flag": "^1.0.0"
+      },
+      "bin": {
+        "resolve": "bin/resolve"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/resolve-from": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz",
+      "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/reusify": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
+      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
+      "license": "MIT",
+      "engines": {
+        "iojs": ">=1.0.0",
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.0.tgz",
+      "integrity": "sha512-yqjxruMGBQJ2gG4HtjZtAfXArHomazDHoFwFFmZZl0r7Pdo7qCIXKqKHZc8yeoMgzJJ+pO6pEEHa+V7uzWlrAQ==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/estree": "1.0.8"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.60.0",
+        "@rollup/rollup-android-arm64": "4.60.0",
+        "@rollup/rollup-darwin-arm64": "4.60.0",
+        "@rollup/rollup-darwin-x64": "4.60.0",
+        "@rollup/rollup-freebsd-arm64": "4.60.0",
+        "@rollup/rollup-freebsd-x64": "4.60.0",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.60.0",
+        "@rollup/rollup-linux-arm-musleabihf": "4.60.0",
+        "@rollup/rollup-linux-arm64-gnu": "4.60.0",
+        "@rollup/rollup-linux-arm64-musl": "4.60.0",
+        "@rollup/rollup-linux-loong64-gnu": "4.60.0",
+        "@rollup/rollup-linux-loong64-musl": "4.60.0",
+        "@rollup/rollup-linux-ppc64-gnu": "4.60.0",
+        "@rollup/rollup-linux-ppc64-musl": "4.60.0",
+        "@rollup/rollup-linux-riscv64-gnu": "4.60.0",
+        "@rollup/rollup-linux-riscv64-musl": "4.60.0",
+        "@rollup/rollup-linux-s390x-gnu": "4.60.0",
+        "@rollup/rollup-linux-x64-gnu": "4.60.0",
+        "@rollup/rollup-linux-x64-musl": "4.60.0",
+        "@rollup/rollup-openbsd-x64": "4.60.0",
+        "@rollup/rollup-openharmony-arm64": "4.60.0",
+        "@rollup/rollup-win32-arm64-msvc": "4.60.0",
+        "@rollup/rollup-win32-ia32-msvc": "4.60.0",
+        "@rollup/rollup-win32-x64-gnu": "4.60.0",
+        "@rollup/rollup-win32-x64-msvc": "4.60.0",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/rollup-plugin-visualizer": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/rollup-plugin-visualizer/-/rollup-plugin-visualizer-7.0.1.tgz",
+      "integrity": "sha512-UJUT4+1Ho4OcWmPYU3sYXgUqI8B8Ayfe06MX7y0qCJ1K8aGoKtR/NDd/2nZqM7ADkrzny+I99Ul7GgyoiVNAgg==",
+      "license": "MIT",
+      "dependencies": {
+        "open": "^11.0.0",
+        "picomatch": "^4.0.2",
+        "source-map": "^0.7.4",
+        "yargs": "^18.0.0"
+      },
+      "bin": {
+        "rollup-plugin-visualizer": "dist/bin/cli.js"
+      },
+      "engines": {
+        "node": ">=22"
+      },
+      "peerDependencies": {
+        "rolldown": "1.x || ^1.0.0-beta || ^1.0.0-rc",
+        "rollup": "2.x || 3.x || 4.x"
+      },
+      "peerDependenciesMeta": {
+        "rolldown": {
+          "optional": true
+        },
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/rou3": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/rou3/-/rou3-0.8.1.tgz",
+      "integrity": "sha512-ePa+XGk00/3HuCqrEnK3LxJW7I0SdNg6EFzKUJG73hMAdDcOUC/i/aSz7LSDwLrGr33kal/rqOGydzwl6U7zBA==",
+      "license": "MIT"
+    },
+    "node_modules/run-applescript": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/run-applescript/-/run-applescript-7.1.0.tgz",
+      "integrity": "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/run-parallel": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
+      "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "queue-microtask": "^1.2.2"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/sax": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.0.tgz",
+      "integrity": "sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=11.0.0"
+      }
+    },
+    "node_modules/scule": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/scule/-/scule-1.3.0.tgz",
+      "integrity": "sha512-6FtHJEvt+pVMIB9IBY+IcCJ6Z5f1iQnytgyfKMhDKgmzYG+TeH/wx1y3l27rshSbLiSanrR9ffZDrEsmjlQF2g==",
+      "license": "MIT"
+    },
+    "node_modules/semver": {
+      "version": "7.7.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz",
+      "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.3",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.1",
+        "mime-types": "^3.0.2",
+        "ms": "^2.1.3",
+        "on-finished": "^2.4.1",
+        "range-parser": "^1.2.1",
+        "statuses": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/serialize-javascript": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-7.0.5.tgz",
+      "integrity": "sha512-F4LcB0UqUl1zErq+1nYEEzSHJnIwb3AF2XWB94b+afhrekOUijwooAYqFyRbjYkm2PAKBabx6oYv/xDxNi8IBw==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/seroval": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/seroval/-/seroval-1.5.1.tgz",
+      "integrity": "sha512-OwrZRZAfhHww0WEnKHDY8OM0U/Qs8OTfIDWhUD4BLpNJUfXK4cGmjiagGze086m+mhI+V2nD0gfbHEnJjb9STA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/serve-placeholder": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/serve-placeholder/-/serve-placeholder-2.0.2.tgz",
+      "integrity": "sha512-/TMG8SboeiQbZJWRlfTCqMs2DD3SZgWp0kDQePz9yUuCnDfDh/92gf7/PxGhzXTKBIPASIHxFcZndoNbp6QOLQ==",
+      "license": "MIT",
+      "dependencies": {
+        "defu": "^6.1.4"
+      }
+    },
+    "node_modules/serve-static": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz",
+      "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "parseurl": "^1.3.3",
+        "send": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shell-quote": {
+      "version": "1.8.3",
+      "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.8.3.tgz",
+      "integrity": "sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/simple-git": {
+      "version": "3.33.0",
+      "resolved": "https://registry.npmjs.org/simple-git/-/simple-git-3.33.0.tgz",
+      "integrity": "sha512-D4V/tGC2sjsoNhoMybKyGoE+v8A60hRawKQ1iFRA1zwuDgGZCBJ4ByOzZ5J8joBbi4Oam0qiPH+GhzmSBwbJng==",
+      "license": "MIT",
+      "dependencies": {
+        "@kwsites/file-exists": "^1.1.1",
+        "@kwsites/promise-deferred": "^1.1.1",
+        "debug": "^4.4.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/steveukx/git-js?sponsor=1"
+      }
+    },
+    "node_modules/sirv": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/sirv/-/sirv-3.0.2.tgz",
+      "integrity": "sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==",
+      "license": "MIT",
+      "dependencies": {
+        "@polka/url": "^1.0.0-next.24",
+        "mrmime": "^2.0.0",
+        "totalist": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/sisteransi": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
+      "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
+      "license": "MIT"
+    },
+    "node_modules/slash": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/slash/-/slash-5.1.0.tgz",
+      "integrity": "sha512-ZA6oR3T/pEyuqwMgAKT0/hAv8oAXckzbkmR0UkUosQ+Mc4RxGoJkRmwHgHufaenlyAgE1Mxgpdcrf75y6XcnDg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/smob": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/smob/-/smob-1.6.1.tgz",
+      "integrity": "sha512-KAkBqZl3c2GvNgNhcoyJae1aKldDW0LO279wF9bk1PnluRTETKBq0WyzRXxEhoQLk56yHaOY4JCBEKDuJIET5g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/source-map": {
+      "version": "0.7.6",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.6.tgz",
+      "integrity": "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/source-map-support": {
+      "version": "0.5.21",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
+      "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "node_modules/source-map-support/node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/srvx": {
+      "version": "0.11.13",
+      "resolved": "https://registry.npmjs.org/srvx/-/srvx-0.11.13.tgz",
+      "integrity": "sha512-oknN6qduuMPafxKtHucUeG32Q963pjriA5g3/Bl05cwEsUe5VVbIU4qR9LrALHbipSCyBe+VmfDGGydqazDRkw==",
+      "license": "MIT",
+      "bin": {
+        "srvx": "bin/srvx.mjs"
+      },
+      "engines": {
+        "node": ">=20.16.0"
+      }
+    },
+    "node_modules/standard-as-callback": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/standard-as-callback/-/standard-as-callback-2.1.0.tgz",
+      "integrity": "sha512-qoRRSyROncaz1z0mvYqIE4lCd9p2R90i6GxW3uZv5ucSu8tU7B5HXUP1gG8pVZsYNVaXjk8ClXHPttLyxAL48A==",
+      "license": "MIT"
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/std-env": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.0.0.tgz",
+      "integrity": "sha512-zUMPtQ/HBY3/50VbpkupYHbRroTRZJPRLvreamgErJVys0ceuzMkD44J/QjqhHjOzK42GQ3QZIeFG1OYfOtKqQ==",
+      "license": "MIT"
+    },
+    "node_modules/streamx": {
+      "version": "2.25.0",
+      "resolved": "https://registry.npmjs.org/streamx/-/streamx-2.25.0.tgz",
+      "integrity": "sha512-0nQuG6jf1w+wddNEEXCF4nTg3LtufWINB5eFEN+5TNZW7KWJp6x87+JFL43vaAUPyCfH1wID+mNVyW6OHtFamg==",
+      "license": "MIT",
+      "dependencies": {
+        "events-universal": "^1.0.0",
+        "fast-fifo": "^1.3.2",
+        "text-decoder": "^1.1.0"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/string-width-cjs": {
+      "name": "string-width",
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT"
+    },
+    "node_modules/string-width-cjs/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
+      "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.2.2"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/strip-ansi-cjs": {
+      "name": "strip-ansi",
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-final-newline": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-3.0.0.tgz",
+      "integrity": "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/strip-literal": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/strip-literal/-/strip-literal-3.1.0.tgz",
+      "integrity": "sha512-8r3mkIM/2+PpjHoOtiAW8Rg3jJLHaV7xPwG+YRGrv6FP0wwk/toTpATxWYOW0BKdWwl82VT2tFYi5DlROa0Mxg==",
+      "license": "MIT",
+      "dependencies": {
+        "js-tokens": "^9.0.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/strip-literal/node_modules/js-tokens": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-9.0.1.tgz",
+      "integrity": "sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==",
+      "license": "MIT"
+    },
+    "node_modules/structured-clone-es": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/structured-clone-es/-/structured-clone-es-2.0.0.tgz",
+      "integrity": "sha512-5UuAHmBLXYPCl22xWJrFuGmIhBKQzxISPVz6E7nmTmTcAOpUzlbjKJsRrCE4vADmMQ0dzeCnlWn9XufnAGf76Q==",
+      "license": "ISC"
+    },
+    "node_modules/stylehacks": {
+      "version": "7.0.8",
+      "resolved": "https://registry.npmjs.org/stylehacks/-/stylehacks-7.0.8.tgz",
+      "integrity": "sha512-I3f053GBLIiS5Fg6OMFhq/c+yW+5Hc2+1fgq7gElDMMSqwlRb3tBf2ef6ucLStYRpId4q//bQO1FjcyNyy4yDQ==",
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1",
+        "postcss-selector-parser": "^7.1.1"
+      },
+      "engines": {
+        "node": "^18.12.0 || ^20.9.0 || >=22.0"
+      },
+      "peerDependencies": {
+        "postcss": "^8.4.32"
+      }
+    },
+    "node_modules/supports-color": {
+      "version": "10.2.2",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-10.2.2.tgz",
+      "integrity": "sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/supports-color?sponsor=1"
+      }
+    },
+    "node_modules/supports-preserve-symlinks-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
+      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/svgo": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/svgo/-/svgo-4.0.1.tgz",
+      "integrity": "sha512-XDpWUOPC6FEibaLzjfe0ucaV0YrOjYotGJO1WpF0Zd+n6ZGEQUsSugaoLq9QkEZtAfQIxT42UChcssDVPP3+/w==",
+      "license": "MIT",
+      "dependencies": {
+        "commander": "^11.1.0",
+        "css-select": "^5.1.0",
+        "css-tree": "^3.0.1",
+        "css-what": "^6.1.0",
+        "csso": "^5.0.5",
+        "picocolors": "^1.1.1",
+        "sax": "^1.5.0"
+      },
+      "bin": {
+        "svgo": "bin/svgo.js"
+      },
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/svgo"
+      }
+    },
+    "node_modules/svgo/node_modules/commander": {
+      "version": "11.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz",
+      "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/system-architecture": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/system-architecture/-/system-architecture-0.1.0.tgz",
+      "integrity": "sha512-ulAk51I9UVUyJgxlv9M6lFot2WP3e7t8Kz9+IS6D4rVba1tR9kON+Ey69f+1R4Q8cd45Lod6a4IcJIxnzGc/zA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/tagged-tag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/tagged-tag/-/tagged-tag-1.0.0.tgz",
+      "integrity": "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/tapable": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.2.tgz",
+      "integrity": "sha512-1MOpMXuhGzGL5TTCZFItxCc0AARf1EZFQkGqMm7ERKj8+Hgr5oLvJOVFcC+lRmR8hCe2S3jC4T5D7Vg/d7/fhA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/webpack"
+      }
+    },
+    "node_modules/tar": {
+      "version": "7.5.13",
+      "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.13.tgz",
+      "integrity": "sha512-tOG/7GyXpFevhXVh8jOPJrmtRpOTsYqUIkVdVooZYJS/z8WhfQUX8RJILmeuJNinGAMSu1veBr4asSHFt5/hng==",
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "@isaacs/fs-minipass": "^4.0.0",
+        "chownr": "^3.0.0",
+        "minipass": "^7.1.2",
+        "minizlib": "^3.1.0",
+        "yallist": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tar-stream": {
+      "version": "3.1.8",
+      "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-3.1.8.tgz",
+      "integrity": "sha512-U6QpVRyCGHva435KoNWy9PRoi2IFYCgtEhq9nmrPPpbRacPs9IH4aJ3gbrFC8dPcXvdSZ4XXfXT5Fshbp2MtlQ==",
+      "license": "MIT",
+      "dependencies": {
+        "b4a": "^1.6.4",
+        "bare-fs": "^4.5.5",
+        "fast-fifo": "^1.2.0",
+        "streamx": "^2.15.0"
+      }
+    },
+    "node_modules/tar/node_modules/yallist": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-5.0.0.tgz",
+      "integrity": "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/teex": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/teex/-/teex-1.0.1.tgz",
+      "integrity": "sha512-eYE6iEI62Ni1H8oIa7KlDU6uQBtqr4Eajni3wX7rpfXD8ysFx8z0+dri+KWEPWpBsxXfxu58x/0jvTVT1ekOSg==",
+      "license": "MIT",
+      "dependencies": {
+        "streamx": "^2.12.5"
+      }
+    },
+    "node_modules/terser": {
+      "version": "5.46.1",
+      "resolved": "https://registry.npmjs.org/terser/-/terser-5.46.1.tgz",
+      "integrity": "sha512-vzCjQO/rgUuK9sf8VJZvjqiqiHFaZLnOiimmUuOKODxWL8mm/xua7viT7aqX7dgPY60otQjUotzFMmCB4VdmqQ==",
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "@jridgewell/source-map": "^0.3.3",
+        "acorn": "^8.15.0",
+        "commander": "^2.20.0",
+        "source-map-support": "~0.5.20"
+      },
+      "bin": {
+        "terser": "bin/terser"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/terser/node_modules/commander": {
+      "version": "2.20.3",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
+      "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
+      "license": "MIT"
+    },
+    "node_modules/text-decoder": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/text-decoder/-/text-decoder-1.2.7.tgz",
+      "integrity": "sha512-vlLytXkeP4xvEq2otHeJfSQIRyWxo/oZGEbXrtEEF9Hnmrdly59sUbzZ/QgyWuLYHctCHxFF4tRQZNQ9k60ExQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "b4a": "^1.6.4"
+      }
+    },
+    "node_modules/tiny-invariant": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.3.3.tgz",
+      "integrity": "sha512-+FbBPE1o9QAYvviau/qC5SE3caw21q3xkvWKBtja5vgqOWIHHJ3ioaq1VPfn/Szqctz2bU/oYeKd9/z5BL+PVg==",
+      "license": "MIT"
+    },
+    "node_modules/tinyclip": {
+      "version": "0.1.12",
+      "resolved": "https://registry.npmjs.org/tinyclip/-/tinyclip-0.1.12.tgz",
+      "integrity": "sha512-Ae3OVUqifDw0wBriIBS7yVaW44Dp6eSHQcyq4Igc7eN2TJH/2YsicswaW+J/OuMvhpDPOKEgpAZCjkb4hpoyeA==",
+      "license": "MIT",
+      "engines": {
+        "node": "^16.14.0 || >= 17.3.0"
+      }
+    },
+    "node_modules/tinyexec": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.0.4.tgz",
+      "integrity": "sha512-u9r3uZC0bdpGOXtlxUIdwf9pkmvhqJdrVCH9fapQtgy/OeTTMZ1nqH7agtvEfmGui6e1XxjcdrlxvxJvc3sMqw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "license": "MIT",
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/totalist": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/totalist/-/totalist-3.0.1.tgz",
+      "integrity": "sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/tr46": {
+      "version": "0.0.3",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
+      "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==",
+      "license": "MIT"
+    },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "license": "0BSD",
+      "optional": true
+    },
+    "node_modules/type-fest": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.5.0.tgz",
+      "integrity": "sha512-PlBfpQwiUvGViBNX84Yxwjsdhd1TUlXr6zjX7eoirtCPIr08NAmxwa+fcYBTeRQxHo9YC9wwF3m9i700sHma8g==",
+      "license": "(MIT OR CC0-1.0)",
+      "dependencies": {
+        "tagged-tag": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/type-level-regexp": {
+      "version": "0.1.17",
+      "resolved": "https://registry.npmjs.org/type-level-regexp/-/type-level-regexp-0.1.17.tgz",
+      "integrity": "sha512-wTk4DH3cxwk196uGLK/E9pE45aLfeKJacKmcEgEOA/q5dnPGNxXt0cfYdFxb57L+sEpf1oJH4Dnx/pnRcku9jg==",
+      "license": "MIT"
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "license": "Apache-2.0",
+      "peer": true,
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/ufo": {
+      "version": "1.6.3",
+      "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.3.tgz",
+      "integrity": "sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q==",
+      "license": "MIT"
+    },
+    "node_modules/ultrahtml": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/ultrahtml/-/ultrahtml-1.6.0.tgz",
+      "integrity": "sha512-R9fBn90VTJrqqLDwyMph+HGne8eqY1iPfYhPzZrvKpIfwkWZbcYlfpsb8B9dTvBfpy1/hqAD7Wi8EKfP9e8zdw==",
+      "license": "MIT"
+    },
+    "node_modules/uncrypto": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/uncrypto/-/uncrypto-0.1.3.tgz",
+      "integrity": "sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==",
+      "license": "MIT"
+    },
+    "node_modules/unctx": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/unctx/-/unctx-2.5.0.tgz",
+      "integrity": "sha512-p+Rz9x0R7X+CYDkT+Xg8/GhpcShTlU8n+cf9OtOEf7zEQsNcCZO1dPKNRDqvUTaq+P32PMMkxWHwfrxkqfqAYg==",
+      "license": "MIT",
+      "dependencies": {
+        "acorn": "^8.15.0",
+        "estree-walker": "^3.0.3",
+        "magic-string": "^0.30.21",
+        "unplugin": "^2.3.11"
+      }
+    },
+    "node_modules/unctx/node_modules/estree-walker": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0"
+      }
+    },
+    "node_modules/unctx/node_modules/unplugin": {
+      "version": "2.3.11",
+      "resolved": "https://registry.npmjs.org/unplugin/-/unplugin-2.3.11.tgz",
+      "integrity": "sha512-5uKD0nqiYVzlmCRs01Fhs2BdkEgBS3SAVP6ndrBsuK42iC2+JHyxM05Rm9G8+5mkmRtzMZGY8Ct5+mliZxU/Ww==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.5",
+        "acorn": "^8.15.0",
+        "picomatch": "^4.0.3",
+        "webpack-virtual-modules": "^0.6.2"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/unenv": {
+      "version": "2.0.0-rc.24",
+      "resolved": "https://registry.npmjs.org/unenv/-/unenv-2.0.0-rc.24.tgz",
+      "integrity": "sha512-i7qRCmY42zmCwnYlh9H2SvLEypEFGye5iRmEMKjcGi7zk9UquigRjFtTLz0TYqr0ZGLZhaMHl/foy1bZR+Cwlw==",
+      "license": "MIT",
+      "dependencies": {
+        "pathe": "^2.0.3"
+      }
+    },
+    "node_modules/unhead": {
+      "version": "2.1.12",
+      "resolved": "https://registry.npmjs.org/unhead/-/unhead-2.1.12.tgz",
+      "integrity": "sha512-iTHdWD9ztTunOErtfUFk6Wr11BxvzumcYJ0CzaSCBUOEtg+DUZ9+gnE99i8QkLFT2q1rZD48BYYGXpOZVDLYkA==",
+      "license": "MIT",
+      "dependencies": {
+        "hookable": "^6.0.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/harlan-zw"
+      }
+    },
+    "node_modules/unhead/node_modules/hookable": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/hookable/-/hookable-6.1.0.tgz",
+      "integrity": "sha512-ZoKZSJgu8voGK2geJS+6YtYjvIzu9AOM/KZXsBxr83uhLL++e9pEv/dlgwgy3dvHg06kTz6JOh1hk3C8Ceiymw==",
+      "license": "MIT"
+    },
+    "node_modules/unicorn-magic": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.4.0.tgz",
+      "integrity": "sha512-wH590V9VNgYH9g3lH9wWjTrUoKsjLF6sGLjhR4sH1LWpLmCOH0Zf7PukhDA8BiS7KHe4oPNkcTHqYkj7SOGUOw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/unimport": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/unimport/-/unimport-6.0.2.tgz",
+      "integrity": "sha512-ZSOkrDw380w+KIPniY3smyXh2h7H9v2MNr9zejDuh239o5sdea44DRAYrv+rfUi2QGT186P2h0GPGKvy8avQ5g==",
+      "license": "MIT",
+      "dependencies": {
+        "acorn": "^8.16.0",
+        "escape-string-regexp": "^5.0.0",
+        "estree-walker": "^3.0.3",
+        "local-pkg": "^1.1.2",
+        "magic-string": "^0.30.21",
+        "mlly": "^1.8.1",
+        "pathe": "^2.0.3",
+        "picomatch": "^4.0.3",
+        "pkg-types": "^2.3.0",
+        "scule": "^1.3.0",
+        "strip-literal": "^3.1.0",
+        "tinyglobby": "^0.2.15",
+        "unplugin": "^3.0.0",
+        "unplugin-utils": "^0.3.1"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/unimport/node_modules/estree-walker": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0"
+      }
+    },
+    "node_modules/unplugin": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/unplugin/-/unplugin-3.0.0.tgz",
+      "integrity": "sha512-0Mqk3AT2TZCXWKdcoaufeXNukv2mTrEZExeXlHIOZXdqYoHHr4n51pymnwV8x2BOVxwXbK2HLlI7usrqMpycdg==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.5",
+        "picomatch": "^4.0.3",
+        "webpack-virtual-modules": "^0.6.2"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      }
+    },
+    "node_modules/unplugin-utils": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/unplugin-utils/-/unplugin-utils-0.3.1.tgz",
+      "integrity": "sha512-5lWVjgi6vuHhJ526bI4nlCOmkCIF3nnfXkCMDeMJrtdvxTs6ZFCM8oNufGTsDbKv/tJ/xj8RpvXjRuPBZJuJog==",
+      "license": "MIT",
+      "dependencies": {
+        "pathe": "^2.0.3",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sxzz"
+      }
+    },
+    "node_modules/unplugin-vue-router": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmjs.org/unplugin-vue-router/-/unplugin-vue-router-0.19.2.tgz",
+      "integrity": "sha512-u5dgLBarxE5cyDK/hzJGfpCTLIAyiTXGlo85COuD4Nssj6G7NxS+i9mhCWz/1p/ud1eMwdcUbTXehQe41jYZUA==",
+      "deprecated": "Merged into vuejs/router. Migrate: https://router.vuejs.org/guide/migration/v4-to-v5.html",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/generator": "^7.28.5",
+        "@vue-macros/common": "^3.1.1",
+        "@vue/language-core": "^3.2.1",
+        "ast-walker-scope": "^0.8.3",
+        "chokidar": "^5.0.0",
+        "json5": "^2.2.3",
+        "local-pkg": "^1.1.2",
+        "magic-string": "^0.30.21",
+        "mlly": "^1.8.0",
+        "muggle-string": "^0.4.1",
+        "pathe": "^2.0.3",
+        "picomatch": "^4.0.3",
+        "scule": "^1.3.0",
+        "tinyglobby": "^0.2.15",
+        "unplugin": "^2.3.11",
+        "unplugin-utils": "^0.3.1",
+        "yaml": "^2.8.2"
+      },
+      "peerDependencies": {
+        "@vue/compiler-sfc": "^3.5.17",
+        "vue-router": "^4.6.0"
+      },
+      "peerDependenciesMeta": {
+        "vue-router": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/unplugin-vue-router/node_modules/unplugin": {
+      "version": "2.3.11",
+      "resolved": "https://registry.npmjs.org/unplugin/-/unplugin-2.3.11.tgz",
+      "integrity": "sha512-5uKD0nqiYVzlmCRs01Fhs2BdkEgBS3SAVP6ndrBsuK42iC2+JHyxM05Rm9G8+5mkmRtzMZGY8Ct5+mliZxU/Ww==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.5",
+        "acorn": "^8.15.0",
+        "picomatch": "^4.0.3",
+        "webpack-virtual-modules": "^0.6.2"
+      },
+      "engines": {
+        "node": ">=18.12.0"
+      }
+    },
+    "node_modules/unstorage": {
+      "version": "1.17.5",
+      "resolved": "https://registry.npmjs.org/unstorage/-/unstorage-1.17.5.tgz",
+      "integrity": "sha512-0i3iqvRfx29hkNntHyQvJTpf5W9dQ9ZadSoRU8+xVlhVtT7jAX57fazYO9EHvcRCfBCyi5YRya7XCDOsbTgkPg==",
+      "license": "MIT",
+      "dependencies": {
+        "anymatch": "^3.1.3",
+        "chokidar": "^5.0.0",
+        "destr": "^2.0.5",
+        "h3": "^1.15.10",
+        "lru-cache": "^11.2.7",
+        "node-fetch-native": "^1.6.7",
+        "ofetch": "^1.5.1",
+        "ufo": "^1.6.3"
+      },
+      "peerDependencies": {
+        "@azure/app-configuration": "^1.8.0",
+        "@azure/cosmos": "^4.2.0",
+        "@azure/data-tables": "^13.3.0",
+        "@azure/identity": "^4.6.0",
+        "@azure/keyvault-secrets": "^4.9.0",
+        "@azure/storage-blob": "^12.26.0",
+        "@capacitor/preferences": "^6 || ^7 || ^8",
+        "@deno/kv": ">=0.9.0",
+        "@netlify/blobs": "^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0",
+        "@planetscale/database": "^1.19.0",
+        "@upstash/redis": "^1.34.3",
+        "@vercel/blob": ">=0.27.1",
+        "@vercel/functions": "^2.2.12 || ^3.0.0",
+        "@vercel/kv": "^1 || ^2 || ^3",
+        "aws4fetch": "^1.0.20",
+        "db0": ">=0.2.1",
+        "idb-keyval": "^6.2.1",
+        "ioredis": "^5.4.2",
+        "uploadthing": "^7.4.4"
+      },
+      "peerDependenciesMeta": {
+        "@azure/app-configuration": {
+          "optional": true
+        },
+        "@azure/cosmos": {
+          "optional": true
+        },
+        "@azure/data-tables": {
+          "optional": true
+        },
+        "@azure/identity": {
+          "optional": true
+        },
+        "@azure/keyvault-secrets": {
+          "optional": true
+        },
+        "@azure/storage-blob": {
+          "optional": true
+        },
+        "@capacitor/preferences": {
+          "optional": true
+        },
+        "@deno/kv": {
+          "optional": true
+        },
+        "@netlify/blobs": {
+          "optional": true
+        },
+        "@planetscale/database": {
+          "optional": true
+        },
+        "@upstash/redis": {
+          "optional": true
+        },
+        "@vercel/blob": {
+          "optional": true
+        },
+        "@vercel/functions": {
+          "optional": true
+        },
+        "@vercel/kv": {
+          "optional": true
+        },
+        "aws4fetch": {
+          "optional": true
+        },
+        "db0": {
+          "optional": true
+        },
+        "idb-keyval": {
+          "optional": true
+        },
+        "ioredis": {
+          "optional": true
+        },
+        "uploadthing": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/unstorage/node_modules/lru-cache": {
+      "version": "11.2.7",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz",
+      "integrity": "sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/untun": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/untun/-/untun-0.1.3.tgz",
+      "integrity": "sha512-4luGP9LMYszMRZwsvyUd9MrxgEGZdZuZgpVQHEEX0lCYFESasVRvZd0EYpCkOIbJKHMuv0LskpXc/8Un+MJzEQ==",
+      "license": "MIT",
+      "dependencies": {
+        "citty": "^0.1.5",
+        "consola": "^3.2.3",
+        "pathe": "^1.1.1"
+      },
+      "bin": {
+        "untun": "bin/untun.mjs"
+      }
+    },
+    "node_modules/untun/node_modules/citty": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/citty/-/citty-0.1.6.tgz",
+      "integrity": "sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ==",
+      "license": "MIT",
+      "dependencies": {
+        "consola": "^3.2.3"
+      }
+    },
+    "node_modules/untun/node_modules/pathe": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz",
+      "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==",
+      "license": "MIT"
+    },
+    "node_modules/untyped": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/untyped/-/untyped-2.0.0.tgz",
+      "integrity": "sha512-nwNCjxJTjNuLCgFr42fEak5OcLuB3ecca+9ksPFNvtfYSLpjf+iJqSIaSnIile6ZPbKYxI5k2AfXqeopGudK/g==",
+      "license": "MIT",
+      "dependencies": {
+        "citty": "^0.1.6",
+        "defu": "^6.1.4",
+        "jiti": "^2.4.2",
+        "knitwork": "^1.2.0",
+        "scule": "^1.3.0"
+      },
+      "bin": {
+        "untyped": "dist/cli.mjs"
+      }
+    },
+    "node_modules/untyped/node_modules/citty": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/citty/-/citty-0.1.6.tgz",
+      "integrity": "sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ==",
+      "license": "MIT",
+      "dependencies": {
+        "consola": "^3.2.3"
+      }
+    },
+    "node_modules/unwasm": {
+      "version": "0.5.3",
+      "resolved": "https://registry.npmjs.org/unwasm/-/unwasm-0.5.3.tgz",
+      "integrity": "sha512-keBgTSfp3r6+s9ZcSma+0chwxQdmLbB5+dAD9vjtB21UTMYuKAxHXCU1K2CbCtnP09EaWeRvACnXk0EJtUx+hw==",
+      "license": "MIT",
+      "dependencies": {
+        "exsolve": "^1.0.8",
+        "knitwork": "^1.3.0",
+        "magic-string": "^0.30.21",
+        "mlly": "^1.8.0",
+        "pathe": "^2.0.3",
+        "pkg-types": "^2.3.0"
+      }
+    },
+    "node_modules/update-browserslist-db": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz",
+      "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "escalade": "^3.2.0",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "update-browserslist-db": "cli.js"
+      },
+      "peerDependencies": {
+        "browserslist": ">= 4.21.0"
+      }
+    },
+    "node_modules/uqr": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/uqr/-/uqr-0.1.2.tgz",
+      "integrity": "sha512-MJu7ypHq6QasgF5YRTjqscSzQp/W11zoUk6kvmlH+fmWEs63Y0Eib13hYFwAzagRJcVY8WVnlV+eBDUGMJ5IbA==",
+      "license": "MIT"
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT"
+    },
+    "node_modules/vite": {
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz",
+      "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "esbuild": "^0.27.0",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
+        "postcss": "^8.5.6",
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "lightningcss": "^1.21.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-dev-rpc": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/vite-dev-rpc/-/vite-dev-rpc-1.1.0.tgz",
+      "integrity": "sha512-pKXZlgoXGoE8sEKiKJSng4hI1sQ4wi5YT24FCrwrLt6opmkjlqPPVmiPWWJn8M8byMxRGzp1CrFuqQs4M/Z39A==",
+      "license": "MIT",
+      "dependencies": {
+        "birpc": "^2.4.0",
+        "vite-hot-client": "^2.1.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^2.9.0 || ^3.0.0-0 || ^4.0.0-0 || ^5.0.0-0 || ^6.0.1 || ^7.0.0-0"
+      }
+    },
+    "node_modules/vite-dev-rpc/node_modules/birpc": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/birpc/-/birpc-2.9.0.tgz",
+      "integrity": "sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      }
+    },
+    "node_modules/vite-hot-client": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/vite-hot-client/-/vite-hot-client-2.1.0.tgz",
+      "integrity": "sha512-7SpgZmU7R+dDnSmvXE1mfDtnHLHQSisdySVR7lO8ceAXvM0otZeuQQ6C8LrS5d/aYyP/QZ0hI0L+dIPrm4YlFQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^2.6.0 || ^3.0.0 || ^4.0.0 || ^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0"
+      }
+    },
+    "node_modules/vite-node": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/vite-node/-/vite-node-5.3.0.tgz",
+      "integrity": "sha512-8f20COPYJujc3OKPX6OuyBy3ZIv2det4eRRU4GY1y2MjbeGSUmPjedxg1b72KnTagCofwvZ65ThzjxDW2AtQFQ==",
+      "license": "MIT",
+      "dependencies": {
+        "cac": "^6.7.14",
+        "es-module-lexer": "^2.0.0",
+        "obug": "^2.1.1",
+        "pathe": "^2.0.3",
+        "vite": "^7.3.1"
+      },
+      "bin": {
+        "vite-node": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/antfu"
+      }
+    },
+    "node_modules/vite-plugin-checker": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/vite-plugin-checker/-/vite-plugin-checker-0.12.0.tgz",
+      "integrity": "sha512-CmdZdDOGss7kdQwv73UyVgLPv0FVYe5czAgnmRX2oKljgEvSrODGuClaV3PDR2+3ou7N/OKGauDDBjy2MB07Rg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.27.1",
+        "chokidar": "^4.0.3",
+        "npm-run-path": "^6.0.0",
+        "picocolors": "^1.1.1",
+        "picomatch": "^4.0.3",
+        "tiny-invariant": "^1.3.3",
+        "tinyglobby": "^0.2.15",
+        "vscode-uri": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=16.11"
+      },
+      "peerDependencies": {
+        "@biomejs/biome": ">=1.7",
+        "eslint": ">=9.39.1",
+        "meow": "^13.2.0",
+        "optionator": "^0.9.4",
+        "oxlint": ">=1",
+        "stylelint": ">=16",
+        "typescript": "*",
+        "vite": ">=5.4.21",
+        "vls": "*",
+        "vti": "*",
+        "vue-tsc": "~2.2.10 || ^3.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@biomejs/biome": {
+          "optional": true
+        },
+        "eslint": {
+          "optional": true
+        },
+        "meow": {
+          "optional": true
+        },
+        "optionator": {
+          "optional": true
+        },
+        "oxlint": {
+          "optional": true
+        },
+        "stylelint": {
+          "optional": true
+        },
+        "typescript": {
+          "optional": true
+        },
+        "vls": {
+          "optional": true
+        },
+        "vti": {
+          "optional": true
+        },
+        "vue-tsc": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-plugin-checker/node_modules/chokidar": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
+      "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
+      "license": "MIT",
+      "dependencies": {
+        "readdirp": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 14.16.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/vite-plugin-checker/node_modules/npm-run-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-6.0.0.tgz",
+      "integrity": "sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA==",
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^4.0.0",
+        "unicorn-magic": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/vite-plugin-checker/node_modules/path-key": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+      "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/vite-plugin-checker/node_modules/readdirp": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
+      "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14.18.0"
+      },
+      "funding": {
+        "type": "individual",
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/vite-plugin-checker/node_modules/unicorn-magic": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.3.0.tgz",
+      "integrity": "sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/vite-plugin-inspect": {
+      "version": "11.3.3",
+      "resolved": "https://registry.npmjs.org/vite-plugin-inspect/-/vite-plugin-inspect-11.3.3.tgz",
+      "integrity": "sha512-u2eV5La99oHoYPHE6UvbwgEqKKOQGz86wMg40CCosP6q8BkB6e5xPneZfYagK4ojPJSj5anHCrnvC20DpwVdRA==",
+      "license": "MIT",
+      "dependencies": {
+        "ansis": "^4.1.0",
+        "debug": "^4.4.1",
+        "error-stack-parser-es": "^1.0.5",
+        "ohash": "^2.0.11",
+        "open": "^10.2.0",
+        "perfect-debounce": "^2.0.0",
+        "sirv": "^3.0.1",
+        "unplugin-utils": "^0.3.0",
+        "vite-dev-rpc": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^6.0.0 || ^7.0.0-0"
+      },
+      "peerDependenciesMeta": {
+        "@nuxt/kit": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-plugin-inspect/node_modules/open": {
+      "version": "10.2.0",
+      "resolved": "https://registry.npmjs.org/open/-/open-10.2.0.tgz",
+      "integrity": "sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==",
+      "license": "MIT",
+      "dependencies": {
+        "default-browser": "^5.2.1",
+        "define-lazy-prop": "^3.0.0",
+        "is-inside-container": "^1.0.0",
+        "wsl-utils": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/vite-plugin-inspect/node_modules/wsl-utils": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/wsl-utils/-/wsl-utils-0.1.0.tgz",
+      "integrity": "sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==",
+      "license": "MIT",
+      "dependencies": {
+        "is-wsl": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/vite-plugin-vue-tracer": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/vite-plugin-vue-tracer/-/vite-plugin-vue-tracer-1.3.0.tgz",
+      "integrity": "sha512-Cgfce6VikzOw5MUJTpeg50s5rRjzU1Vr61ZjuHunVVHLjZZ5AUlgyExHthZ3r59vtoz9W2rDt23FYG81avYBKw==",
+      "license": "MIT",
+      "dependencies": {
+        "estree-walker": "^3.0.3",
+        "exsolve": "^1.0.8",
+        "magic-string": "^0.30.21",
+        "pathe": "^2.0.3",
+        "source-map-js": "^1.2.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "vite": "^6.0.0 || ^7.0.0",
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/vite-plugin-vue-tracer/node_modules/estree-walker": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0"
+      }
+    },
+    "node_modules/vscode-uri": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.1.0.tgz",
+      "integrity": "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==",
+      "license": "MIT"
+    },
+    "node_modules/vue": {
+      "version": "3.5.31",
+      "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.31.tgz",
+      "integrity": "sha512-iV/sU9SzOlmA/0tygSmjkEN6Jbs3nPoIPFhCMLD2STrjgOU8DX7ZtzMhg4ahVwf5Rp9KoFzcXeB1ZrVbLBp5/Q==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.31",
+        "@vue/compiler-sfc": "3.5.31",
+        "@vue/runtime-dom": "3.5.31",
+        "@vue/server-renderer": "3.5.31",
+        "@vue/shared": "3.5.31"
+      },
+      "peerDependencies": {
+        "typescript": "*"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue-bundle-renderer": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/vue-bundle-renderer/-/vue-bundle-renderer-2.2.0.tgz",
+      "integrity": "sha512-sz/0WEdYH1KfaOm0XaBmRZOWgYTEvUDt6yPYaUzl4E52qzgWLlknaPPTTZmp6benaPTlQAI/hN1x3tAzZygycg==",
+      "license": "MIT",
+      "dependencies": {
+        "ufo": "^1.6.1"
+      }
+    },
+    "node_modules/vue-devtools-stub": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/vue-devtools-stub/-/vue-devtools-stub-0.1.0.tgz",
+      "integrity": "sha512-RutnB7X8c5hjq39NceArgXg28WZtZpGc3+J16ljMiYnFhKvd8hITxSWQSQ5bvldxMDU6gG5mkxl1MTQLXckVSQ==",
+      "license": "MIT"
+    },
+    "node_modules/vue-i18n": {
+      "version": "11.4.10",
+      "resolved": "https://registry.npmjs.org/vue-i18n/-/vue-i18n-11.4.10.tgz",
+      "integrity": "sha512-Lp+BjOxqzOY87DS6Z8KrQrpiTr9IN/Lt4kZEilwyXG2Wrx+AcU6IVsAW92HNXtVcn1HFFPV6ty41p9e/qDpyvg==",
+      "license": "MIT",
+      "dependencies": {
+        "@intlify/core-base": "11.4.10",
+        "@intlify/devtools-types": "11.4.10",
+        "@intlify/shared": "11.4.10",
+        "@vue/devtools-api": "^6.5.0"
+      },
+      "engines": {
+        "node": ">= 22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/kazupon"
+      },
+      "peerDependencies": {
+        "vue": "^3.0.0"
+      }
+    },
+    "node_modules/vue-router": {
+      "version": "4.6.4",
+      "resolved": "https://registry.npmjs.org/vue-router/-/vue-router-4.6.4.tgz",
+      "integrity": "sha512-Hz9q5sa33Yhduglwz6g9skT8OBPii+4bFn88w6J+J4MfEo4KRRpmiNG/hHHkdbRFlLBOqxN8y8gf2Fb0MTUgVg==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@vue/devtools-api": "^6.6.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/posva"
+      },
+      "peerDependencies": {
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/vue-sonner": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/vue-sonner/-/vue-sonner-1.3.2.tgz",
+      "integrity": "sha512-UbZ48E9VIya3ToiRHAZUbodKute/z/M1iT8/3fU8zEbwBRE11AKuHikssv18LMk2gTTr6eMQT4qf6JoLHWuj/A==",
+      "license": "MIT"
+    },
+    "node_modules/webidl-conversions": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
+      "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==",
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/webpack-virtual-modules": {
+      "version": "0.6.2",
+      "resolved": "https://registry.npmjs.org/webpack-virtual-modules/-/webpack-virtual-modules-0.6.2.tgz",
+      "integrity": "sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==",
+      "license": "MIT"
+    },
+    "node_modules/whatwg-url": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
+      "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==",
+      "license": "MIT",
+      "dependencies": {
+        "tr46": "~0.0.3",
+        "webidl-conversions": "^3.0.0"
+      }
+    },
+    "node_modules/which": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-6.0.1.tgz",
+      "integrity": "sha512-oGLe46MIrCRqX7ytPUf66EAYvdeMIZYn3WaocqqKZAxrBpkqHfL/qvTyJ/bTk5+AqHCjXmrv3CEWgy368zhRUg==",
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^4.0.0"
+      },
+      "bin": {
+        "node-which": "bin/which.js"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/wrap-ansi": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz",
+      "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "string-width": "^7.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs": {
+      "name": "wrap-ansi",
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT"
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ws": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
+      "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/wsl-utils": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/wsl-utils/-/wsl-utils-0.3.1.tgz",
+      "integrity": "sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg==",
+      "license": "MIT",
+      "dependencies": {
+        "is-wsl": "^3.1.0",
+        "powershell-utils": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/y18n": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yallist": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
+      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
+      "license": "ISC"
+    },
+    "node_modules/yaml": {
+      "version": "2.8.3",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.3.tgz",
+      "integrity": "sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg==",
+      "license": "ISC",
+      "peer": true,
+      "bin": {
+        "yaml": "bin.mjs"
+      },
+      "engines": {
+        "node": ">= 14.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/eemeli"
+      }
+    },
+    "node_modules/yargs": {
+      "version": "18.0.0",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.0.0.tgz",
+      "integrity": "sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==",
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^9.0.1",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "string-width": "^7.2.0",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^22.0.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.12.0 || >=23"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "22.0.0",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz",
+      "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==",
+      "license": "ISC",
+      "engines": {
+        "node": "^20.19.0 || ^22.12.0 || >=23"
+      }
+    },
+    "node_modules/youch": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/youch/-/youch-4.1.0.tgz",
+      "integrity": "sha512-cYekNh2tUoU+voS11X0D0UQntVCSO6LQ1h10VriQGmfbpf0mnGTruwZICts23UUNiZCXm8H8hQBtRrdsbhuNNg==",
+      "license": "MIT",
+      "dependencies": {
+        "@poppinss/colors": "^4.1.6",
+        "@poppinss/dumper": "^0.7.0",
+        "@speed-highlight/core": "^1.2.14",
+        "cookie-es": "^2.0.0",
+        "youch-core": "^0.3.3"
+      }
+    },
+    "node_modules/youch-core": {
+      "version": "0.3.3",
+      "resolved": "https://registry.npmjs.org/youch-core/-/youch-core-0.3.3.tgz",
+      "integrity": "sha512-ho7XuGjLaJ2hWHoK8yFnsUGy2Y5uDpqSTq1FkHLK4/oqKtyUU1AFbOOxY4IpC9f0fTLjwYbslUz0Po5BpD1wrA==",
+      "license": "MIT",
+      "dependencies": {
+        "@poppinss/exception": "^1.2.2",
+        "error-stack-parser-es": "^1.0.5"
+      }
+    },
+    "node_modules/zip-stream": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/zip-stream/-/zip-stream-6.0.1.tgz",
+      "integrity": "sha512-zK7YHHz4ZXpW89AHXUPbQVGKI7uvkd3hzusTdotCg1UxyaVtg0zFJSTfW/Dq5f7OBBVnq6cZIaC8Ti4hb6dtCA==",
+      "license": "MIT",
+      "dependencies": {
+        "archiver-utils": "^5.0.0",
+        "compress-commons": "^6.0.2",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    }
+  }
+}
diff --git a/huobao-source/frontend/package.json b/huobao-source/frontend/package.json
new file mode 100644
index 0000000..964affa
--- /dev/null
+++ b/huobao-source/frontend/package.json
@@ -0,0 +1,28 @@
+{
+  "name": "huobao-drama-frontend",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "nuxt dev --port 3013",
+    "build": "nuxt build",
+    "generate": "nuxt generate",
+    "preview": "nuxt preview",
+    "postinstall": "nuxt prepare"
+  },
+  "dependencies": {
+    "driver.js": "^1.8.0",
+    "lucide-vue-next": "^0.511.0",
+    "nuxt": "^3.17.5",
+    "vue": "^3.5.13",
+    "vue-i18n": "^11.4.10",
+    "vue-router": "^4.5.1",
+    "vue-sonner": "^1.2.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "allowScripts": {
+    "esbuild@0.27.4": true,
+    "@parcel/watcher@2.5.6": true
+  }
+}
diff --git a/huobao-source/frontend/tests/apple-light-theme-structure.test.mjs b/huobao-source/frontend/tests/apple-light-theme-structure.test.mjs
new file mode 100644
index 0000000..4f883cd
--- /dev/null
+++ b/huobao-source/frontend/tests/apple-light-theme-structure.test.mjs
@@ -0,0 +1,31 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const read = path => readFileSync(new URL(path, import.meta.url), 'utf8')
+const studioCss = read('../app/assets/studio.css')
+const layout = read('../app/layouts/default.vue')
+const surfaces = [
+  studioCss,
+  layout,
+  read('../app/pages/index.vue'),
+  read('../app/pages/drama/[id]/index.vue'),
+  read('../app/pages/drama/[id]/episode/[episodeNumber].vue'),
+  read('../app/pages/settings.vue'),
+].join('\n')
+
+test('apple light theme exposes the selected neutral and system-blue tokens', () => {
+  assert.match(studioCss, /--surface-base:\s*#f5f5f7/i)
+  assert.match(studioCss, /--surface-raised:\s*#ffffff/i)
+  assert.match(studioCss, /--accent:\s*#0071e3/i)
+  assert.match(studioCss, /--success:\s*#34c759/i)
+  assert.match(studioCss, /--font-body:\s*-apple-system,\s*BlinkMacSystemFont,\s*'SF Pro Text'/)
+})
+
+test('core surfaces remove the old film-console and graphite decoration', () => {
+  assert.doesNotMatch(surfaces, /#d96f27|rgba\(217\s*,\s*111\s*,\s*39/i)
+  assert.doesNotMatch(surfaces, /linear-gradient|radial-gradient|repeating-linear-gradient/i)
+  assert.doesNotMatch(surfaces, /Noto Serif SC|film-strip|film-frame/i)
+  assert.doesNotMatch(surfaces, /#15171a|#1c1f23|#20242a|#30343a/i)
+  assert.doesNotMatch(surfaces, /#4c8dff|rgba\(76\s*,\s*141\s*,\s*255/i)
+})
diff --git a/huobao-source/frontend/tests/asset-library-structure.test.mjs b/huobao-source/frontend/tests/asset-library-structure.test.mjs
new file mode 100644
index 0000000..c626c83
--- /dev/null
+++ b/huobao-source/frontend/tests/asset-library-structure.test.mjs
@@ -0,0 +1,65 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('episode card exposes a delete action', () => {
+  const page = read('app/pages/drama/[id]/index.vue')
+  const useApi = read('app/composables/useApi.ts')
+
+  assert.match(useApi, /episodeAPI = \{[\s\S]*?del: \(id: number\) => api\.del\(`\/episodes\/\$\{id\}`\)/)
+  assert.match(page, /class="btn btn-icon btn-sm ep-delete"/)
+  assert.match(page, /@click\.stop="episodeToDelete = ep"/)
+  assert.match(page, /<ConfirmDialog/)
+  assert.match(page, /确定删除「/)
+  assert.match(page, /await episodeAPI\.del\(ep\.id\)/)
+  // 不使用浏览器原生确认弹窗
+  assert.doesNotMatch(page, /[^D]confirm\(/)
+})
+
+test('drama detail header links to the asset library page', () => {
+  const page = read('app/pages/drama/[id]/index.vue')
+
+  assert.match(page, /素材库/)
+  assert.match(page, /navigateTo\(`\/drama\/\$\{drama\.id\}\/assets`\)/)
+})
+
+test('episode status is manually marked, not derived from script content', () => {
+  const page = read('app/pages/drama/[id]/index.vue')
+
+  // 手动状态：选项 + 下拉标记 + 持久化到 episodes.status
+  assert.match(page, /const epStatusOptions = \[/)
+  assert.match(page, /function epStatus\(ep\) \{ return ep\.status \|\| 'draft' \}/)
+  assert.match(page, /function setEpisodeStatus/)
+  assert.match(page, /episodeAPI\.update\(ep\.id, \{ status \}\)/)
+  assert.match(page, /epStatusMenuId/)
+  // 自动推算已移除
+  assert.doesNotMatch(page, /hasScript/)
+  assert.doesNotMatch(page, /已完成剧本/)
+  assert.doesNotMatch(page, /待编写/)
+})
+
+test('asset library page lists character and scene images', () => {
+  const page = read('app/pages/drama/[id]/assets.vue')
+
+  // 数据源：项目全部图片生成记录 + 项目详情（名称解析）
+  assert.match(page, /taskAPI\.list\(\{ type: 'image', drama_id: dramaId \}\)/)
+  assert.match(page, /dramaAPI\.get\(dramaId\)/)
+  // 只收录完成的角色/场景图
+  assert.match(page, /r\.status === 'completed' && \(r\.characterId \|\| r\.sceneId\)/)
+  // 全部 / 角色 / 场景 筛选
+  assert.match(page, /\{ label: '全部', value: 'all' \}/)
+  assert.match(page, /\{ label: '角色', value: 'character' \}/)
+  assert.match(page, /\{ label: '场景', value: 'scene' \}/)
+  assert.match(page, /characterAssets/)
+  assert.match(page, /sceneAssets/)
+  // 网格 + 预览
+  assert.match(page, /class="card asset-card"/)
+  assert.match(page, /openViewer\(asset\)/)
+  assert.match(page, /viewer-overlay/)
+  // 空态引导
+  assert.match(page, /暂无/)
+  assert.match(page, /会自动收录到这里/)
+})
diff --git a/huobao-source/frontend/tests/button-system-structure.test.mjs b/huobao-source/frontend/tests/button-system-structure.test.mjs
new file mode 100644
index 0000000..1d9daba
--- /dev/null
+++ b/huobao-source/frontend/tests/button-system-structure.test.mjs
@@ -0,0 +1,39 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const studioCss = readFileSync(new URL('../app/assets/studio.css', import.meta.url), 'utf8')
+const indexPage = readFileSync(new URL('../app/pages/index.vue', import.meta.url), 'utf8')
+const defaultLayout = readFileSync(new URL('../app/layouts/default.vue', import.meta.url), 'utf8')
+const baseSelect = readFileSync(new URL('../app/components/BaseSelect.vue', import.meta.url), 'utf8')
+const dramaDetail = readFileSync(new URL('../app/pages/drama/[id]/index.vue', import.meta.url), 'utf8')
+const episodeWorkbench = readFileSync(new URL('../app/pages/drama/[id]/episode/[episodeNumber].vue', import.meta.url), 'utf8')
+
+test('global button system exposes complete button tokens and states', () => {
+  assert.match(studioCss, /--button-height:\s*36px/)
+  assert.match(studioCss, /--button-height-sm:\s*30px/)
+  assert.match(studioCss, /--button-height-icon:\s*36px/)
+  assert.match(studioCss, /--button-border:\s*transparent/)
+  assert.match(studioCss, /--button-focus:\s*rgba\(0,113,227,0\.18\)/)
+  assert.match(studioCss, /--radius-pill:\s*980px/)
+  assert.match(studioCss, /\.btn\s*\{[\s\S]*?border-radius:\s*var\(--button-radius\)/)
+  assert.match(studioCss, /\.btn:focus-visible\s*\{/)
+  assert.match(studioCss, /\.btn-danger\s*\{/)
+  assert.match(studioCss, /\.btn-danger:hover\s*\{/)
+})
+
+test('button-like controls share focus-visible and active hooks', () => {
+  assert.match(indexPage, /\.filter-chip:focus-visible\s*\{/)
+  assert.match(indexPage, /\.menu-item:focus-visible\s*\{/)
+  assert.match(defaultLayout, /\.nav-link:focus-visible\s*\{/)
+  assert.match(defaultLayout, /\.brand:focus-visible\s*\{/)
+  assert.match(baseSelect, /\.base-select-trigger:focus-visible\s*\{/)
+  assert.match(baseSelect, /\.base-select-option:focus-visible\s*\{/)
+})
+
+test('custom return buttons use the unified quiet circular surface', () => {
+  assert.match(dramaDetail, /\.back-btn\s*\{[\s\S]*?background:\s*rgba\(0,0,0,0\.05\)/)
+  assert.match(dramaDetail, /\.back-btn:focus-visible\s*\{/)
+  assert.match(episodeWorkbench, /\.back-btn\s*\{[\s\S]*?background:\s*rgba\(0,0,0,0\.05\)/)
+  assert.match(episodeWorkbench, /\.back-btn:focus-visible\s*\{/)
+})
diff --git a/huobao-source/frontend/tests/episode-create-dialog-structure.test.mjs b/huobao-source/frontend/tests/episode-create-dialog-structure.test.mjs
new file mode 100644
index 0000000..3ba5b59
--- /dev/null
+++ b/huobao-source/frontend/tests/episode-create-dialog-structure.test.mjs
@@ -0,0 +1,66 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('add episode dialog asks for a title and a fixed video resolution', () => {
+  const page = read('app/pages/drama/[id]/index.vue')
+
+  // 删除图片/视频服务选择 UI
+  assert.doesNotMatch(page, /图片生成服务/)
+  assert.doesNotMatch(page, /视频生成服务/)
+  assert.doesNotMatch(page, /svc-card/)
+  assert.doesNotMatch(page, /svc-pick/)
+  assert.doesNotMatch(page, /imageConfigs|videoConfigs/)
+  assert.doesNotMatch(page, /配置将锁定/)
+  assert.doesNotMatch(page, /创建并锁定配置/)
+
+  // 保留标题输入与提交
+  assert.match(page, /v-model="newEpisodeTitle"/)
+  assert.match(page, /placeholder="默认按集数自动命名"/)
+  assert.match(page, /留空时会自动按集数命名/)
+  assert.match(page, /创建后自动锁定当前启用的图片与视频生成能力/)
+  assert.match(page, /creatingEpisode \? '创建中\.\.\.' : '创建'/)
+
+  // 视频分辨率：创建集时固定（480p/720p，默认 720p）
+  assert.match(page, /视频分辨率/)
+  assert.match(page, /v-model="newEpisodeResolution"/)
+  assert.match(page, /const resolutionOptions = \[/)
+  assert.match(page, /720p · 高清/)
+  assert.match(page, /480p · 流畅/)
+  assert.match(page, /newEpisodeResolution = ref\('720p'\)/)
+  assert.match(page, /之后仍可在集卡片上修改/)
+})
+
+test('addEpisode posts drama_id, title and resolution', () => {
+  const page = read('app/pages/drama/[id]/index.vue')
+
+  const addEpisodeBody = page.slice(page.indexOf('async function addEpisode'), page.indexOf('onMounted(load)'))
+  assert.match(addEpisodeBody, /drama_id: dramaId/)
+  assert.match(addEpisodeBody, /title: newEpisodeTitle\.value/)
+  assert.match(addEpisodeBody, /resolution: newEpisodeResolution\.value/)
+  assert.doesNotMatch(addEpisodeBody, /image_config_id/)
+  assert.doesNotMatch(addEpisodeBody, /video_config_id/)
+  assert.doesNotMatch(addEpisodeBody, /aiConfigAPI/)
+})
+
+test('episode card resolution is editable via a dropdown persisted to episodes.resolution', () => {
+  const page = read('app/pages/drama/[id]/index.vue')
+
+  // 卡片上的分辨率标签 + 下拉修改
+  assert.match(page, /点击修改本集视频分辨率/)
+  assert.match(page, /epResMenuId/)
+  assert.match(page, /function epResolution\(ep\) \{ return ep\.resolution === '480p' \? '480p' : '720p' \}/)
+  assert.match(page, /function setEpisodeResolution/)
+  assert.match(page, /episodeAPI\.update\(ep\.id, \{ resolution \}\)/)
+})
+
+test('add episode dialog does not preload config lists', () => {
+  const page = read('app/pages/drama/[id]/index.vue')
+
+  assert.doesNotMatch(page, /loadConfigs/)
+  assert.doesNotMatch(page, /aiConfigAPI\.list/)
+  assert.doesNotMatch(page, /canCreateEpisode/)
+})
\ No newline at end of file
diff --git a/huobao-source/frontend/tests/model-selection-structure.test.mjs b/huobao-source/frontend/tests/model-selection-structure.test.mjs
new file mode 100644
index 0000000..62d3f85
--- /dev/null
+++ b/huobao-source/frontend/tests/model-selection-structure.test.mjs
@@ -0,0 +1,61 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+const page = read('app/pages/drama/[id]/episode/[episodeNumber].vue')
+const useAgent = read('app/composables/useAgent.ts')
+const useApi = read('app/composables/useApi.ts')
+
+test('workbench offers model selectors for rewrite, image and video generation', () => {
+  // 三个选择器（自定义 ModelSelect 弹窗组件，非原生 select）
+  assert.match(page, /<ModelSelect/)
+  assert.match(page, /v-model="chatModel"/)
+  assert.match(page, /v-model="imageModel"/)
+  assert.match(page, /v-model="videoModel"/)
+  assert.doesNotMatch(page, /<select v-model="chatModel"/)
+  // 选项汇总该类型全部启用配置的模型（去重、按优先级），API 返回的 model 可能已是数组
+  assert.match(page, /function collectModelOptions\(cfgs\)/)
+  assert.match(page, /if \(Array\.isArray\(raw\)\) return raw\.filter\(Boolean\)/)
+  assert.match(page, /collectModelOptions\(textConfigs\.value\)/)
+  assert.match(page, /collectModelOptions\(imageConfigs\.value\)/)
+  assert.match(page, /collectModelOptions\(videoConfigs\.value\)/)
+  assert.match(page, /aiConfigAPI\.list\('text'\)/)
+})
+
+test('model select dropdown is a custom designed popover', () => {
+  const component = read('app/components/ModelSelect.vue')
+
+  assert.match(component, /Teleport to="body"/)
+  assert.match(component, /model-select-menu/)
+  assert.match(component, /model-select-option/)
+  assert.match(component, /Check :size="12"/)
+  assert.match(component, /model-select-backdrop/)
+  assert.match(component, /emit\('update:modelValue', model\)/)
+  // 多配置时展示来源配置名
+  assert.match(component, /showConfig/)
+  assert.match(component, /opt-config/)
+})
+
+test('selected models are sent with rewrite, image and video generation requests', () => {
+  // 选中模型时连同其所属配置一起调用
+  assert.match(page, /function ownerConfigId\(options, model\)/)
+  // 改写（Agent）透传模型与配置
+  assert.match(useAgent, /model: model \|\| undefined/)
+  assert.match(useAgent, /config_id: configId \|\| undefined/)
+  assert.match(page, /runAgent\('script_rewriter'[\s\S]*?chatModelOverride\(\), chatConfigId\(\)\)/)
+  // 图片生成透传模型与配置
+  assert.match(useApi, /generateImage: \(id: number, episodeId: number, model\?: string, configId\?: number, textModel\?: string, textConfigId\?: number\)/)
+  // 文本模型覆盖随生图/提取请求透传（缺提示词时后端触发提示词 Agent）
+  assert.match(useApi, /text_model: textModel \|\| undefined/)
+  assert.match(useApi, /text_config_id: textConfigId \|\| undefined/)
+  assert.match(useApi, /config_id: configId \|\| undefined/)
+  assert.match(page, /characterAPI\.generateImage\(id, epId\.value, imageModel\.value \|\| undefined, ownerConfigId\(imageModelOptions\.value, imageModel\.value\), chatModelOverride\(\), chatConfigId\(\)\)/)
+  assert.match(page, /sceneAPI\.generateImage\(id, epId\.value, imageModel\.value \|\| undefined, ownerConfigId\(imageModelOptions\.value, imageModel\.value\), chatModelOverride\(\), chatConfigId\(\)\)/)
+  assert.match(page, /characterAPI\.batchImages\(ids, epId\.value, imageModel\.value \|\| undefined, ownerConfigId\(imageModelOptions\.value, imageModel\.value\), chatModelOverride\(\), chatConfigId\(\)\)/)
+  // 视频生成透传模型与配置
+  assert.match(page, /model: videoModel\.value \|\| undefined/)
+  assert.match(page, /config_id: ownerConfigId\(videoModelOptions\.value, videoModel\.value\)/)
+})
diff --git a/huobao-source/frontend/tests/official-provider-settings.test.mjs b/huobao-source/frontend/tests/official-provider-settings.test.mjs
new file mode 100644
index 0000000..3cc5396
--- /dev/null
+++ b/huobao-source/frontend/tests/official-provider-settings.test.mjs
@@ -0,0 +1,98 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const settingsPage = readFileSync(new URL('../app/pages/settings.vue', import.meta.url), 'utf8')
+const useApi = readFileSync(new URL('../app/composables/useApi.ts', import.meta.url), 'utf8')
+
+function providerPresetBlock(serviceType) {
+  const presetsStart = settingsPage.indexOf('const providerPresets = {')
+  assert.notEqual(presetsStart, -1, 'missing providerPresets')
+  const marker = `  ${serviceType}: {`
+  const start = settingsPage.indexOf(marker, presetsStart)
+  assert.notEqual(start, -1, `missing ${serviceType} provider presets`)
+  const end = settingsPage.indexOf('\n  },', start)
+  assert.notEqual(end, -1, `unterminated ${serviceType} provider presets`)
+  return settingsPage.slice(start, end)
+}
+
+test('settings page exposes official provider templates only', () => {
+  assert.doesNotMatch(settingsPage, /provider:\s*'chatfire'/i)
+  assert.doesNotMatch(settingsPage, /openrouter/i)
+  assert.doesNotMatch(settingsPage, /huobaoPreset/i)
+  assert.doesNotMatch(settingsPage, /applyHuobaoPreset/i)
+  assert.doesNotMatch(settingsPage, /\/huobao-preset/)
+  assert.doesNotMatch(useApi, /api\.firemux\.com/i)
+  assert.doesNotMatch(useApi, /applyHuobaoPreset/i)
+  assert.doesNotMatch(useApi, /openrouter/i)
+  assert.doesNotMatch(useApi, /huobaoPreset/i)
+  assert.doesNotMatch(useApi, /\/huobao-preset/)
+
+  assert.match(settingsPage, /const providers = \['gemini', 'openai', 'volcengine', 'minimax', 'aliyun'\]/)
+  assert.match(settingsPage, /https:\/\/generativelanguage\.googleapis\.com/)
+  assert.match(settingsPage, /https:\/\/api\.openai\.com/)
+  assert.match(settingsPage, /https:\/\/ark\.cn-beijing\.volces\.com/)
+  assert.match(settingsPage, /https:\/\/\{WorkspaceId\}\.cn-beijing\.maas\.aliyuncs\.com/)
+  assert.doesNotMatch(settingsPage, /https:\/\/api\.deepseek\.com/)
+  assert.doesNotMatch(settingsPage, /https:\/\/dashscope\.aliyuncs\.com/)
+  assert.doesNotMatch(settingsPage, /https:\/\/api\.vidu\.com/)
+  assert.doesNotMatch(settingsPage, /\['ali'|'ali',|, 'ali'\]/)
+  assert.match(settingsPage, /火宝快捷配置/)
+  assert.match(settingsPage, /https:\/\/api\.firemux\.com/)
+  assert.match(settingsPage, /applyHuobaoQuickConfig/)
+  assert.doesNotMatch(settingsPage, /https:\/\/api\.minimax\.io/)
+})
+
+test('settings page offers official default model IDs', () => {
+  assert.match(settingsPage, /gemini-3\.1-pro-preview/)
+  assert.match(settingsPage, /gemini-3\.5-flash/)
+  assert.match(settingsPage, /gemini-3-flash-preview/)
+  assert.match(settingsPage, /gpt-5\.6-terra/)
+  assert.match(settingsPage, /deepseek-v4-flash/)
+  assert.match(settingsPage, /gemini-3-pro-image/)
+  assert.match(settingsPage, /gemini-3\.1-flash-image/)
+  assert.match(settingsPage, /gpt-image-2/)
+  assert.match(settingsPage, /doubao-seedance-2-0-260128/)
+  assert.match(settingsPage, /doubao-seedance-2-0-fast-260128/)
+  assert.match(settingsPage, /doubao-seedance-2-0-mini-260615/)
+  assert.match(settingsPage, /wan3\.0-video-prime/)
+  assert.match(settingsPage, /wan3\.0-video/)
+  assert.match(settingsPage, /deepseek-v4-pro/)
+  assert.doesNotMatch(settingsPage, /gpt-5\.4/)
+  assert.doesNotMatch(settingsPage, /doubao-seed-1-6/)
+  assert.doesNotMatch(settingsPage, /wan2\.6-t2i/)
+  assert.doesNotMatch(settingsPage, /wan2\.6-i2v-flash/)
+  assert.doesNotMatch(settingsPage, /viduq3-turbo/)
+  assert.doesNotMatch(settingsPage, /viduq3-pro/)
+  assert.doesNotMatch(settingsPage, /gemini-2\.5-flash/)
+  assert.doesNotMatch(settingsPage, /gpt-4\.1-mini/)
+  assert.doesNotMatch(settingsPage, /gpt-image-1/)
+  assert.doesNotMatch(settingsPage, /gemini-3-pro-image-preview/)
+  assert.doesNotMatch(settingsPage, /gemini-3\.1-flash-image-preview/)
+  assert.doesNotMatch(settingsPage, /doubao-seedream/)
+  assert.doesNotMatch(settingsPage, /speech-2\.8-hd/)
+})
+
+test('only text service configs expose the connection test button', () => {
+  assert.match(settingsPage, /v-if="st\.type === 'text'" class="btn btn-ghost btn-sm" @click="testExistingCfg\(c\)">\{\{ t\('settings\.ai\.test'\) \}\}/)
+})
+
+test('settings page offers the supported official provider presets', () => {
+  assert.match(providerPresetBlock('text'), /deepseek-v4-pro/)
+  assert.doesNotMatch(providerPresetBlock('text'), /minimax/i)
+  assert.doesNotMatch(providerPresetBlock('image'), /'ali'|minimax/i)
+  assert.match(providerPresetBlock('video'), /volcengine/)
+  assert.match(providerPresetBlock('video'), /minimax/)
+  assert.match(providerPresetBlock('video'), /aliyun/)
+  assert.doesNotMatch(providerPresetBlock('video'), /'vidu'/i)
+  assert.doesNotMatch(settingsPage, /audio:\s*\{/)
+})
+
+test('Huobao quick config includes Wan 3.0 through the Qwen gateway route', () => {
+  const quickStart = settingsPage.indexOf('const huobaoQuickConfigs = [')
+  assert.notEqual(quickStart, -1)
+  const quickConfigs = settingsPage.slice(quickStart, settingsPage.indexOf('\n]', quickStart) + 2)
+  assert.match(quickConfigs, /provider:\s*'aliyun'/)
+  assert.match(quickConfigs, /base_url:\s*'https:\/\/api\.firemux\.com\/qwen'/)
+  assert.match(quickConfigs, /model:\s*\['wan3\.0-video-prime', 'wan3\.0-video'\]/)
+})
diff --git a/huobao-source/frontend/tests/professional-redesign-surface.test.mjs b/huobao-source/frontend/tests/professional-redesign-surface.test.mjs
new file mode 100644
index 0000000..e140849
--- /dev/null
+++ b/huobao-source/frontend/tests/professional-redesign-surface.test.mjs
@@ -0,0 +1,100 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const studioCss = readFileSync(new URL('../app/assets/studio.css', import.meta.url), 'utf8')
+const indexPage = readFileSync(new URL('../app/pages/index.vue', import.meta.url), 'utf8')
+const defaultLayout = readFileSync(new URL('../app/layouts/default.vue', import.meta.url), 'utf8')
+const episodeWorkbench = readFileSync(new URL('../app/pages/drama/[id]/episode/[episodeNumber].vue', import.meta.url), 'utf8')
+const dramaDetail = readFileSync(new URL('../app/pages/drama/[id]/index.vue', import.meta.url), 'utf8')
+const settingsPage = readFileSync(new URL('../app/pages/settings.vue', import.meta.url), 'utf8')
+
+function cssBlock(source, selector) {
+  const start = source.indexOf(selector)
+  assert.notEqual(start, -1, `missing selector ${selector}`)
+  const open = source.indexOf('{', start)
+  assert.notEqual(open, -1, `missing block for ${selector}`)
+
+  let depth = 0
+  for (let i = open; i < source.length; i += 1) {
+    if (source[i] === '{') depth += 1
+    if (source[i] === '}') {
+      depth -= 1
+      if (depth === 0) return source.slice(start, i + 1)
+    }
+  }
+
+  throw new Error(`unterminated block for ${selector}`)
+}
+
+test('theme exposes an apple-inspired light material system', () => {
+  assert.match(studioCss, /--surface-base:\s*#f5f5f7/)
+  assert.match(studioCss, /--surface-raised:\s*#ffffff/)
+  assert.match(studioCss, /--surface-muted:\s*#f5f5f7/)
+  assert.match(studioCss, /--surface-outline:\s*rgba\(0,0,0,0\.08\)/)
+  assert.match(studioCss, /--accent:\s*#0071e3/)
+})
+
+test('project entry is redesigned as a poster card grid', () => {
+  assert.match(indexPage, /class="project-grid"/)
+  assert.match(indexPage, /class="card project-card"/)
+  assert.match(indexPage, /class="project-thumb"/)
+  assert.match(indexPage, /repeat\(auto-fill,\s*minmax\(258px,\s*1fr\)\)/)
+  assert.match(indexPage, /box-shadow:\s*var\(--shadow-lift\)/)
+})
+
+test('global header uses the frosted glass material', () => {
+  assert.match(defaultLayout, /background:\s*rgba\(251,251,253,0\.72\)/)
+  assert.match(defaultLayout, /backdrop-filter:\s*blur\(20px\)\s*saturate\(180%\)/)
+  assert.match(defaultLayout, /border-bottom:\s*1px solid var\(--border\)/)
+})
+
+test('workbench removes legacy light panels from the main production surface', () => {
+  assert.match(episodeWorkbench, /background:\s*var\(--surface-raised\)/)
+  assert.match(episodeWorkbench, /background:\s*var\(--surface-muted\)/)
+  assert.doesNotMatch(episodeWorkbench, /rgba\(246,\s*248,\s*252,\s*0\.92\)/)
+  assert.doesNotMatch(episodeWorkbench, /rgba\(27,\s*41,\s*64,\s*0\.08\)/)
+})
+
+test('settings page removes the legacy quick setup recommendation cards', () => {
+  assert.doesNotMatch(settingsPage, /Quick Setup/)
+  assert.doesNotMatch(settingsPage, /官方推荐配置/)
+  assert.doesNotMatch(settingsPage, /officialPresetCards/)
+  assert.doesNotMatch(settingsPage, /\.preset-card\s*\{/)
+  assert.doesNotMatch(settingsPage, /background:\s*rgba\(255,255,255,0\.82\)/)
+  assert.doesNotMatch(settingsPage, /background:\s*rgba\(244,248,255,0\.72\)/)
+  assert.doesNotMatch(settingsPage, /background:\s*rgba\(255,255,255,0\.72\)/)
+})
+
+test('project episode dialog follows the light brand system', () => {
+  assert.doesNotMatch(dramaDetail, /rgba\(122,167,255/)
+  assert.doesNotMatch(dramaDetail, /rgba\(76,125,255/)
+  assert.doesNotMatch(dramaDetail, /rgba\(242,247,255,0\.92\)/)
+  assert.doesNotMatch(dramaDetail, /rgba\(244,248,255,0\.96\)/)
+})
+
+test('workbench active navigation uses quiet system-blue accents', () => {
+  const pipeActive = cssBlock(episodeWorkbench, '.pipe-item.active')
+  const iconActive = cssBlock(episodeWorkbench, '.icon-active')
+
+  assert.match(pipeActive, /background:\s*var\(--accent-bg\)/)
+  assert.match(pipeActive, /color:\s*var\(--accent-text\)/)
+  assert.doesNotMatch(pipeActive, /inset 3px 0 0 var\(--accent\)/)
+  assert.match(iconActive, /background:\s*var\(--accent\)/)
+})
+
+test('workbench completed navigation uses quiet success states', () => {
+  const doneItem = cssBlock(episodeWorkbench, '.pipe-item.done')
+  const doneIcon = cssBlock(episodeWorkbench, '.pipe-item.done .pipe-icon')
+  const iconDone = cssBlock(episodeWorkbench, '.icon-done')
+  const sidebarDoneDot = cssBlock(episodeWorkbench, '.sidebar-jump-dot.done')
+  const stageDoneDot = cssBlock(episodeWorkbench, '.stage-subnav-dot')
+
+  assert.doesNotMatch(doneItem, /#9fcaa7/)
+  assert.match(doneIcon, /background:\s*var\(--success-bg\)/)
+  assert.match(doneIcon, /color:\s*var\(--success\)/)
+  assert.match(iconDone, /background:\s*var\(--success-bg\)/)
+  assert.match(sidebarDoneDot, /background:\s*var\(--success\)/)
+  assert.doesNotMatch(stageDoneDot, /#9fcaa7/)
+  assert.match(episodeWorkbench, /\.pipe-item\.active\.done \.pipe-icon\s*\{/)
+})
diff --git a/huobao-source/frontend/tests/project-launcher-structure.test.mjs b/huobao-source/frontend/tests/project-launcher-structure.test.mjs
new file mode 100644
index 0000000..7a70be0
--- /dev/null
+++ b/huobao-source/frontend/tests/project-launcher-structure.test.mjs
@@ -0,0 +1,60 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const page = readFileSync(new URL('../app/pages/index.vue', import.meta.url), 'utf8')
+const studioCss = readFileSync(new URL('../app/assets/studio.css', import.meta.url), 'utf8')
+
+test('project list opens project detail before choosing an episode', () => {
+  assert.match(page, /项目启动台/)
+  assert.match(page, /openDrama/)
+  assert.match(page, /getDramaPath/)
+  assert.match(page, /打开项目/)
+  assert.match(page, /navigateTo\(getDramaPath\(d\)\)/)
+  assert.doesNotMatch(page, /openWorkbench/)
+})
+
+test('project status is manually marked, not derived from content', () => {
+  // 手动状态：选项 + 下拉标记 + 持久化到 dramas.status
+  assert.match(page, /const statusOptions = \[/)
+  assert.match(page, /待开始.*draft/s)
+  assert.match(page, /进行中.*active/s)
+  assert.match(page, /已完成.*completed/s)
+  assert.match(page, /function currentStatus\(d\) \{ return d\.status \|\| 'draft' \}/)
+  assert.match(page, /function setDramaStatus/)
+  assert.match(page, /dramaAPI\.update\(d\.id, \{ status \}\)/)
+  assert.match(page, /statusMenuId/)
+  // 筛选与统计基于手动状态
+  assert.match(page, /currentStatus\(d\) === statusFilter\.value/)
+  assert.match(page, /currentStatus\(d\) === 'active'/)
+  // 自动推算已移除：无进度条、无 episodes.length 状态派生
+  assert.doesNotMatch(page, /getProgress/)
+  assert.doesNotMatch(page, /d\.episodes\?\.length \? '进行中' : '待开始'/)
+})
+
+test('project launcher keeps controls simple', () => {
+  assert.match(page, /搜索项目/)
+  assert.match(page, /新建项目/)
+  assert.doesNotMatch(page, /剧集列表/)
+  assert.doesNotMatch(page, /制作队列/)
+  assert.doesNotMatch(page, /最近活动/)
+})
+
+test('create dialog fixes aspect ratio at project creation', () => {
+  assert.match(page, /画面比例/)
+  assert.match(page, /form\.aspect_ratio/)
+  assert.match(page, /aspectRatioOptions/)
+  assert.match(page, /aspect_ratio: '16:9'/)
+  assert.match(page, /创建后固定/)
+  assert.match(page, /16:9 · 横屏/)
+  assert.match(page, /9:16 · 竖屏/)
+  assert.match(page, /1:1 · 方形/)
+  assert.doesNotMatch(page, /计划集数/)
+})
+
+test('global buttons use the apple-inspired action palette', () => {
+  assert.match(studioCss, /--action-primary:\s*#0071e3/)
+  assert.match(studioCss, /--action-secondary:\s*#e8e8ed/)
+  assert.match(studioCss, /--action-danger:\s*#ff3b30/)
+  assert.match(studioCss, /\.btn-primary\s*\{/)
+})
diff --git a/huobao-source/frontend/tests/prompt-mentions.test.mjs b/huobao-source/frontend/tests/prompt-mentions.test.mjs
new file mode 100644
index 0000000..20643e8
--- /dev/null
+++ b/huobao-source/frontend/tests/prompt-mentions.test.mjs
@@ -0,0 +1,46 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { activeMentionAt, mentionToken, highlightMentions, mentionDeletionRange } from '../app/utils/prompt-mentions.js'
+
+const options = [
+  { value: '小雨', kind: 'character' },
+  { value: '小雨', aliases: ['小雨音色'], trigger: '#', kind: 'voice' },
+  { value: '小雨姐姐', aliases: ['小雨姐姐音色'], trigger: '#', kind: 'voice' },
+  { value: 'A&B<', trigger: '#', kind: 'voice' },
+]
+
+test('image and voice triggers stay independent, including adjacent references', () => {
+  assert.deepEqual(activeMentionAt('@小雨#小', 5), { start: 3, trigger: '#', query: '小' })
+  assert.deepEqual(activeMentionAt('场景 @', 4), { start: 3, trigger: '@', query: '' })
+  assert.equal(activeMentionAt('#小雨音色 台词', 8), null)
+  assert.equal(mentionToken(options[0]), '@小雨')
+  assert.equal(mentionToken(options[1]), '#小雨')
+})
+
+test('highlighting preserves literal text, safely escapes HTML, and prefers complete names', () => {
+  const html = highlightMentions('@小雨抬头，#小雨姐姐轻声说，#A&B<回应 <script>\n', options)
+  assert.match(html, /mention-token-role">@小雨<\/span>/)
+  assert.match(html, /mention-token-voice">#小雨姐姐<\/span>轻声说/)
+  assert.match(html, /mention-token-voice">#A&amp;B&lt;<\/span>回应/)
+  assert.match(html, /&lt;script&gt;\n\u200b$/)
+  assert.equal(highlightMentions('#未知音色', options), '#未知音色')
+})
+
+test('Backspace and Delete remove whole voice tokens without consuming surrounding text', () => {
+  const text = '@小雨#小雨轻声说话'
+  assert.deepEqual(mentionDeletionRange(text, 6, options, true), { start: 3, end: 6 })
+  assert.deepEqual(mentionDeletionRange(text, 3, options, false), { start: 3, end: 6 })
+  assert.equal(mentionDeletionRange(text, 5, options, true), null)
+  assert.deepEqual(mentionDeletionRange(text, 3, options, true), { start: 0, end: 3 })
+})
+
+test('typing dialogue immediately after a voice name keeps the menu closed; longer names can still be searched', () => {
+  const speech = '#小雨轻声说'
+  assert.equal(activeMentionAt(speech, speech.length, options), null)
+  assert.deepEqual(activeMentionAt('#小雨姐', 4, options), { start: 0, trigger: '#', query: '小雨姐' })
+})
+
+test('previously saved suffix tokens are highlighted and deleted as one mention', () => {
+  assert.match(highlightMentions('#小雨音色说话', options), /mention-token-voice">#小雨音色<\/span>说话/)
+  assert.deepEqual(mentionDeletionRange('#小雨音色说话', 5, options, true), { start: 0, end: 5 })
+})
diff --git a/huobao-source/frontend/tests/remove-audio-voice-structure.test.mjs b/huobao-source/frontend/tests/remove-audio-voice-structure.test.mjs
new file mode 100644
index 0000000..a95b419
--- /dev/null
+++ b/huobao-source/frontend/tests/remove-audio-voice-structure.test.mjs
@@ -0,0 +1,44 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const appRoot = new URL('../app/', import.meta.url)
+const readApp = (path) => readFileSync(new URL(path, appRoot), 'utf8')
+
+const episodePage = readApp('views/drama/episode.vue')
+const dramaPage = readApp('views/drama/detail.vue')
+const settingsPage = readApp('pages/settings.vue')
+const useApi = readApp('composables/useApi.ts')
+
+test('frontend API client no longer exposes TTS or voice endpoints', () => {
+  assert.doesNotMatch(useApi, /generateTTS/)
+  assert.doesNotMatch(useApi, /voiceSample/)
+  assert.doesNotMatch(useApi, /voicesAPI/)
+  assert.doesNotMatch(useApi, /ai-voices/)
+  assert.doesNotMatch(useApi, /generate-voice-sample/)
+  assert.doesNotMatch(useApi, /generate-tts/)
+})
+
+test('uploaded character voices do not restore AI voice assignment or TTS controls', () => {
+  assert.doesNotMatch(episodePage, /voice_assigner/)
+  assert.doesNotMatch(episodePage, /AI 匹配声音/)
+  assert.doesNotMatch(episodePage, /批量试听/)
+  assert.doesNotMatch(episodePage, /已配音色/)
+  assert.doesNotMatch(episodePage, /待音色/)
+  assert.doesNotMatch(episodePage, /updateCharVoice/)
+  assert.doesNotMatch(episodePage, /previewVoiceSample/)
+  assert.doesNotMatch(episodePage, /voiceProfiles/)
+  assert.doesNotMatch(episodePage, /audioConfigs/)
+  assert.doesNotMatch(episodePage, /voicesAPI/)
+})
+
+test('project and settings pages remove audio service configuration', () => {
+  assert.doesNotMatch(dramaPage, /audio_config_id/)
+  assert.doesNotMatch(dramaPage, /audioConfigs/)
+  assert.doesNotMatch(dramaPage, /音频/)
+  assert.doesNotMatch(settingsPage, /voice_assigner/)
+  assert.doesNotMatch(settingsPage, /音色分配/)
+  assert.doesNotMatch(settingsPage, /serviceTypes[\s\S]*audio/)
+  assert.doesNotMatch(settingsPage, /音频/)
+  assert.doesNotMatch(settingsPage, /speech-2\.8-hd/)
+})
diff --git a/huobao-source/frontend/tests/remove-grid-feature-structure.test.mjs b/huobao-source/frontend/tests/remove-grid-feature-structure.test.mjs
new file mode 100644
index 0000000..ec1e3da
--- /dev/null
+++ b/huobao-source/frontend/tests/remove-grid-feature-structure.test.mjs
@@ -0,0 +1,39 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const appRoot = new URL('../app/', import.meta.url)
+const readApp = (path) => readFileSync(new URL(path, appRoot), 'utf8')
+
+const episodePage = readApp('pages/drama/[id]/episode/[episodeNumber].vue')
+const settingsPage = readApp('pages/settings.vue')
+const useApi = readApp('composables/useApi.ts')
+
+test('frontend API client no longer exposes grid image endpoints', () => {
+  assert.doesNotMatch(useApi, /gridAPI/)
+  assert.doesNotMatch(useApi, /\/grid\/prompt/)
+  assert.doesNotMatch(useApi, /\/grid\/generate/)
+  assert.doesNotMatch(useApi, /\/grid\/split/)
+  assert.doesNotMatch(useApi, /\/grid\/status/)
+})
+
+test('episode workbench removes the grid image tool and history UI', () => {
+  assert.doesNotMatch(episodePage, /宫格图/)
+  assert.doesNotMatch(episodePage, /openGridTool/)
+  assert.doesNotMatch(episodePage, /gridDialog/)
+  assert.doesNotMatch(episodePage, /gridAPI/)
+  assert.doesNotMatch(episodePage, /generateGridPrompt/)
+  assert.doesNotMatch(episodePage, /startGridGen/)
+  assert.doesNotMatch(episodePage, /doGridSplit/)
+  assert.doesNotMatch(episodePage, /latest-grid-strip/)
+  assert.doesNotMatch(episodePage, /grid-history/)
+})
+
+test('settings image prompt agent copy only describes role and scene prompts', () => {
+  assert.match(settingsPage, /prompt_generator/)
+  assert.doesNotMatch(settingsPage, /宫格图/)
+  assert.doesNotMatch(settingsPage, /read_shots_for_grid/)
+  assert.doesNotMatch(settingsPage, /generate_grid_prompt/)
+  assert.doesNotMatch(settingsPage, /grid_prompt（/)
+  assert.doesNotMatch(settingsPage, /cell_prompts/)
+})
diff --git a/huobao-source/frontend/tests/style-preset-structure.test.mjs b/huobao-source/frontend/tests/style-preset-structure.test.mjs
new file mode 100644
index 0000000..92dba0b
--- /dev/null
+++ b/huobao-source/frontend/tests/style-preset-structure.test.mjs
@@ -0,0 +1,52 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const root = new URL('..', import.meta.url)
+const read = (path) => readFileSync(new URL(path, root), 'utf8')
+
+test('project creation dialog only asks for title and visual style', () => {
+  const page = read('app/pages/index.vue')
+
+  assert.match(page, /新建项目/)
+  assert.match(page, /视觉风格/)
+  assert.doesNotMatch(page, /total_episodes/)
+  assert.doesNotMatch(page, /计划集数/)
+  // 硬编码风格列表已移除，预设来自 API
+  assert.doesNotMatch(page, /\['realistic', 'anime'/)
+  assert.match(page, /stylePresetAPI/)
+  assert.match(page, /stylePresetAPI\.list\(\)/)
+  assert.match(page, /styleLabel\(d\.style\)/)
+  assert.match(page, /stylePresets\.length \}\} 种视觉风格/)
+})
+
+test('useApi exposes style preset endpoints', () => {
+  const useApi = read('app/composables/useApi.ts')
+
+  assert.match(useApi, /stylePresetAPI/)
+  assert.match(useApi, /\/style-presets/)
+  assert.match(useApi, /\?all=1/)
+})
+
+test('settings page manages style presets in a base tab', () => {
+  const settings = read('app/pages/settings.vue')
+
+  assert.match(settings, /风格预设/)
+  assert.match(settings, /Palette/)
+  assert.match(settings, /stylePresetAPI/)
+  assert.match(settings, /\{ id: 'styles', label: '风格预设'/)
+  assert.match(settings, /startAddStyle/)
+  assert.match(settings, /startEditStyle/)
+  assert.match(settings, /toggleStyle/)
+  assert.match(settings, /confirmDelStyle/)
+  assert.match(settings, /styleToDelete/)
+  assert.match(settings, /<ConfirmDialog/)
+  assert.match(settings, /loadStylePresets/)
+  // 关闭高级开关时只重置高级 tab，不影响基础 tab
+  assert.match(settings, /advancedTabs\.some/)
+  assert.doesNotMatch(settings, /if \(!v && tab\.value !== 'ai'\)/)
+  // 风格 key 编辑时不可修改
+  assert.match(settings, /:disabled="!!styleEditId"/)
+  // image_prompt_generator 默认提示词副本同步更新
+  assert.doesNotMatch(settings, /必须包含 "consistent art style"/)
+})
diff --git a/huobao-source/frontend/tests/video-direct-generation-config.test.mjs b/huobao-source/frontend/tests/video-direct-generation-config.test.mjs
new file mode 100644
index 0000000..28fac7a
--- /dev/null
+++ b/huobao-source/frontend/tests/video-direct-generation-config.test.mjs
@@ -0,0 +1,33 @@
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+const settingsPage = readFileSync(new URL('../app/pages/settings.vue', import.meta.url), 'utf8')
+const aiConfigRoute = readFileSync(new URL('../../backend/src/routes/aiConfigs.ts', import.meta.url), 'utf8')
+const volcengineAdapter = readFileSync(new URL('../../backend/src/services/adapters/volcengine-video.ts', import.meta.url), 'utf8')
+
+test('video presets default to direct Seedance 2.0 generation', () => {
+  const combined = `${settingsPage}\n${aiConfigRoute}\n${volcengineAdapter}`
+  assert.doesNotMatch(combined, /doubao-seedance-1-5-pro-251215/)
+  assert.match(settingsPage, /Seedance 2\.0/)
+  assert.match(settingsPage, /doubao-seedance-2-0-260128/)
+  assert.match(settingsPage, /doubao-seedance-2-0-fast-260128/)
+  assert.match(settingsPage, /doubao-seedance-2-0-mini-260615/)
+})
+
+test('video presets use official provider endpoints', () => {
+  const presetsStart = settingsPage.indexOf('const providerPresets = {')
+  const quickStart = settingsPage.indexOf('const huobaoQuickConfigs = [')
+  const providerPresets = settingsPage.slice(presetsStart, quickStart)
+  assert.doesNotMatch(providerPresets, /api\.firemux\.com/)
+  assert.match(settingsPage, /https:\/\/ark\.cn-beijing\.volces\.com/)
+  assert.match(providerPresets, /https:\/\/\{WorkspaceId\}\.cn-beijing\.maas\.aliyuncs\.com/)
+  assert.doesNotMatch(settingsPage, /https:\/\/dashscope\.aliyuncs\.com/)
+  assert.doesNotMatch(settingsPage, /https:\/\/api\.vidu\.com/)
+})
+
+test('Wan 3.0 quick preset targets the Qwen gateway namespace', () => {
+  const quickStart = settingsPage.indexOf('const huobaoQuickConfigs = [')
+  const quickConfigs = settingsPage.slice(quickStart)
+  assert.match(quickConfigs, /provider:\s*'aliyun'.*base_url:\s*'https:\/\/api\.firemux\.com\/qwen'.*wan3\.0-video-prime.*wan3\.0-video/s)
+})
diff --git a/huobao-source/frontend/tsconfig.json b/huobao-source/frontend/tsconfig.json
new file mode 100644
index 0000000..4b34df1
--- /dev/null
+++ b/huobao-source/frontend/tsconfig.json
@@ -0,0 +1,3 @@
+{
+  "extends": "./.nuxt/tsconfig.json"
+}
diff --git a/huobao-source/package.json b/huobao-source/package.json
new file mode 100644
index 0000000..ae3d00f
--- /dev/null
+++ b/huobao-source/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "huobao-drama",
+  "version": "1.0.0",
+  "private": true,
+  "description": "火宝短剧 — AI 短剧制作工具（桌面版编排入口）",
+  "scripts": {
+    "dev:backend": "cd backend && npm run dev",
+    "dev:frontend": "cd frontend && npm run dev",
+    "dev:desktop": "cd desktop && npm run dev",
+    "build:frontend": "cd frontend && npm run generate",
+    "dist": "cd desktop && npm run dist"
+  }
+}
diff --git a/integration-work/8189-plugin-init.py b/integration-work/8189-plugin-init.py
new file mode 100644
index 0000000..f75f03b
--- /dev/null
+++ b/integration-work/8189-plugin-init.py
@@ -0,0 +1,400 @@
+"""Single Comfy job: detect -> bounded LTX cleanup -> verify -> literal captions.
+
+No nested HTTP jobs, raw-video output nodes, dynamic package installs, or audio
+replacement. Expansion keeps samplers in Comfy's normal cancellation scheduler.
+"""
+from __future__ import annotations
+
+import json
+import math
+import os
+from pathlib import Path
+import threading
+import time
+import uuid
+
+from . import caption_core as core
+from . import literal_renderer as renderer
+from . import vision_verifier as vision
+from .sttn_repair import H3STTNRepair
+from .generation_stage import H3GenerationModelStage
+
+MODEL_NAMES = {
+    'unet': 'ltx-2.3-22b-distilled-1.1_transformer_only_fp8_scaled.safetensors',
+    'lora': 'h3-rh-local-20261009-8a5f/ltx23_inpaint_rank128_v1_10000steps.safetensors',
+    'clip': 'h3-rh-local-20261009-8a5f/gemma_3_12B_it_fp8_e4m3fn.safetensors',
+    'projection': 'ltx-2.3_text_projection_bf16.safetensors',
+    'video_vae': 'LTX23_video_vae_bf16.safetensors',
+    'audio_vae': 'LTX23_audio_vae_bf16.safetensors',
+}
+_CONDITION_LOCK=threading.Lock()
+_CONDITION_KEY=None
+_CONDITION_VALUE=None
+REPAIR_ENGINE='sttn-v1'
+
+
+def clone_conditioning(value):
+    import torch
+    if isinstance(value,torch.Tensor):return value.detach().to('cpu').clone()
+    if isinstance(value,list):return [clone_conditioning(v) for v in value]
+    if isinstance(value,tuple):return tuple(clone_conditioning(v) for v in value)
+    if isinstance(value,dict):return {k:clone_conditioning(v) for k,v in value.items()}
+    if value is None or isinstance(value,(str,int,float,bool)):return value
+    core.failure('H3_SUBTITLE_DEPENDENCY','固定字幕清理条件含不支持的数据类型')
+
+
+def conditioning_key():
+    import folder_paths
+    result=[]
+    for key in ['clip','projection']:
+        path=Path(folder_paths.get_full_path_or_raise('text_encoders',MODEL_NAMES[key]))
+        stat=path.stat();result.append((str(path),stat.st_size,stat.st_mtime_ns,stat.st_ctime_ns))
+    return tuple(result)
+
+
+class H3InpaintConditioningCache:
+    @classmethod
+    def INPUT_TYPES(cls):return {'required':{}}
+    RETURN_TYPES=('CONDITIONING','CONDITIONING')
+    FUNCTION='load'
+    CATEGORY='video/h3-verified/internal'
+
+    @classmethod
+    def IS_CHANGED(cls):return conditioning_key()
+
+    def load(self):
+        global _CONDITION_KEY,_CONDITION_VALUE
+        import nodes
+        key=conditioning_key()
+        with _CONDITION_LOCK:
+            if _CONDITION_KEY!=key or _CONDITION_VALUE is None:
+                # These are fixed inpainting prompts, never user dialogue. Keep
+                # detached CPU tensors rather than the 13B encoder/model object.
+                clip=nodes.DualCLIPLoader().load_clip(MODEL_NAMES['clip'],MODEL_NAMES['projection'],'ltxv',device='cpu')[0]
+                positive=nodes.CLIPTextEncode().encode(clip,'')[0]
+                negative=nodes.CLIPTextEncode().encode(clip,'text, subtitles, watermark')[0]
+                value=clone_conditioning((positive,negative))
+                _CONDITION_VALUE=value;_CONDITION_KEY=key
+                del clip,positive,negative
+            # Guide nodes add per-video metadata. Never let it mutate the cache
+            # or leak conditioning state between two users/tasks.
+            return clone_conditioning(_CONDITION_VALUE)
+
+
+class H3CaptionWarmup:
+    @classmethod
+    def INPUT_TYPES(cls):return {'required':{}}
+    RETURN_TYPES=()
+    FUNCTION='warm'
+    OUTPUT_NODE=True
+    CATEGORY='video/h3-verified/internal'
+
+    @classmethod
+    def IS_CHANGED(cls):return float('nan')
+
+    def warm(self):
+        import comfy.model_management
+        resource_check()
+        if REPAIR_ENGINE=='sttn-v1':
+            from .sttn_repair import load_model
+            load_model()
+        else:
+            H3InpaintConditioningCache().load()
+        # This output-only maintenance job is submitted before opening a new
+        # worker to production, never concurrently with a generation on it.
+        comfy.model_management.unload_all_models()
+        return {'ui':{'text':['H3 fixed inpaint conditioning cache ready']},'result':()}
+
+
+def interrupt():
+    from comfy.model_management import throw_exception_if_processing_interrupted
+    throw_exception_if_processing_interrupted()
+
+
+def audit_logger():
+    identifier=uuid.uuid4().hex
+    def record(event):
+        # Coordinates and enum decisions only; never log image pixels, dialogue,
+        # model prompts or credentials. Preserve diagnostics even if a gate fails.
+        print('H3_REGION_AUDIT '+json.dumps({'id':identifier,**event}),flush=True)
+    return record
+
+
+def array_frames(images):
+    from .frame_pixels import uint8_frames
+    return uint8_frames(images, interrupt)
+
+
+def font_supports(text):
+    from fontTools.ttLib import TTFont
+    path = renderer.font_path()
+    with TTFont(str(path), fontNumber=0, lazy=True) as font:
+        cmap = font.getBestCmap()
+        if any(not c.isspace() and ord(c) not in cmap for c in text):
+            core.failure('H3_SUBTITLE_FONT', '字幕含字体不支持的字符，已停止以避免方框乱码')
+
+
+def resource_check():
+    import folder_paths
+    vision.validate_assets()
+    if REPAIR_ENGINE=='sttn-v1':
+        from .sttn_repair import model_path
+        model_path()
+        return
+    if REPAIR_ENGINE!='ltx-v1':
+        core.failure('H3_SUBTITLE_DEPENDENCY','字幕修复引擎配置无效')
+    for group,key in [('diffusion_models','unet'),('loras','lora'),('text_encoders','clip'),
+                      ('text_encoders','projection'),('vae','video_vae'),('vae','audio_vae')]:
+        if not folder_paths.get_full_path(group, MODEL_NAMES[key]):
+            core.failure('H3_SUBTITLE_DEPENDENCY', '缺少已验证的字幕清理模型，未返回未清理视频')
+
+
+def speech_cues(text, audio, duration):
+    if not text:
+        return []
+    if audio is None:
+        core.failure('H3_SUBTITLE_ALIGNMENT', '口播任务缺少原音轨')
+    import torch
+    import torchaudio
+    waveform = audio.get('waveform')
+    rate = audio.get('sample_rate')
+    if not isinstance(waveform,torch.Tensor) or waveform.ndim != 3 or waveform.shape[0] != 1 or not isinstance(rate,int) or rate < 8000:
+        core.failure('H3_SUBTITLE_ALIGNMENT', '原音轨格式不支持，未猜测字幕时间')
+    if not torch.isfinite(waveform).all() or abs(waveform.shape[-1]/rate-duration) > .4:
+        core.failure('H3_SUBTITLE_ALIGNMENT','原音轨时长与视频不一致')
+    # ASR receives a new CPU/mono buffer. The original AUDIO input bypasses this
+    # node and remains wired directly to the final video writer.
+    samples = waveform.detach().to(device='cpu',dtype=torch.float32).mean(dim=1)[0]
+    samples = torchaudio.functional.resample(samples,rate,16000).numpy()
+    return core.align_literal_cues(text, core.transcribe_words(samples,interrupt),duration)
+
+
+class H3CaptionPipeline:
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {'required': {'images':('IMAGE',), 'fps':('FLOAT',{'default':24.0,'min':1.0,'max':60.0}),
+                'subtitle_text':('STRING',{'multiline':True}), 'seed':('INT',{'default':42,'min':0,'max':2**64-1})},
+                'optional': {'audio':('AUDIO',),'classifier_clip':('CLIP',)}}
+    RETURN_TYPES=('IMAGE',)
+    FUNCTION='process'
+    CATEGORY='video/h3-verified'
+
+    @classmethod
+    def VALIDATE_INPUTS(cls, subtitle_text):
+        try:
+            import importlib.util
+            resource_check()
+            for package in ['rapidocr_onnxruntime','onnxruntime','opencc','fontTools','faster_whisper']:
+                if importlib.util.find_spec(package) is None:
+                    core.failure('H3_SUBTITLE_DEPENDENCY','字幕处理组件未就绪')
+            if subtitle_text:
+                font_supports(subtitle_text)
+                model=Path(os.environ.get('H3_SUBTITLE_ASR_MODEL','/nonexistent'))
+                if not all((model/name).is_file() for name in ['model.bin','config.json','tokenizer.json']):
+                    core.failure('H3_SUBTITLE_DEPENDENCY','离线口播模型未就绪')
+            return True
+        except (ValueError, ImportError, OSError) as exc:
+            return str(exc) if str(exc).startswith('H3_') else 'H3_SUBTITLE_DEPENDENCY: 字幕处理依赖未就绪'
+
+    def process(self, images, fps, subtitle_text, seed, audio=None, classifier_clip=None):
+        import torch
+        from comfy_execution.graph_utils import GraphBuilder
+        interrupt()
+        if not math.isfinite(fps) or fps <= 0 or not isinstance(subtitle_text,str) or len(subtitle_text)>4096:
+            core.failure('H3_SUBTITLE_INPUT','字幕文案或帧率无效')
+        original = images.detach().to(device='cpu',dtype=torch.float32)
+        pixels = array_frames(original)
+        if subtitle_text:
+            font_supports(subtitle_text)
+        cues = speech_cues(subtitle_text,audio,len(original)/fps)
+        check_started=time.monotonic()
+        audit=audit_logger()
+        classify=lambda samples,interrupt:vision.classify_many(samples,interrupt,clip=classifier_clip,audit=audit)
+        review=lambda groups,interrupt:vision.review_many(groups,interrupt,clip=classifier_clip,audit=audit)
+        plan = core.caption_plan(pixels,fps,interrupt=interrupt,classify_many=classify,audit=audit,review_many=review)
+        crop_json=json.dumps(core.context_crop(plan))
+        graph = GraphBuilder()
+        accumulated = original
+        if plan['regions'] and REPAIR_ENGINE=='sttn-v1':
+            resource_check()
+            masks=torch.from_numpy(core.mask_from_plan(plan,pixels))
+            repaired=graph.node('H3STTNRepair',images=original,masks=masks)
+            accumulated=repaired.out(0)
+        elif plan['regions']:
+            resource_check()
+            masks = torch.from_numpy(core.mask_from_plan(plan,pixels))
+            model=graph.node('UNETLoader',unet_name=MODEL_NAMES['unet'],weight_dtype='fp8_e4m3fn_fast')
+            lora=graph.node('LoraLoaderModelOnly',model=model.out(0),lora_name=MODEL_NAMES['lora'],strength_model=1.0)
+            # Native attention: the source workflow's SageAttention failed on
+            # this runtime. The successful isolated proof used this exact bypass.
+            vae=graph.node('VAELoaderKJ',vae_name=MODEL_NAMES['video_vae'],device='main_device',weight_dtype='bf16')
+            audio_vae=graph.node('VAELoaderKJ',vae_name=MODEL_NAMES['audio_vae'],device='main_device',weight_dtype='bf16')
+            fixed=graph.node('H3InpaintConditioningCache')
+            cond=graph.node('LTXVConditioning',positive=fixed.out(0),negative=fixed.out(1),frame_rate=fps)
+            sampler=graph.node('KSamplerSelect',sampler_name='euler_ancestral')
+            sigmas=graph.node('ManualSigmas',sigmas='1.0, 0.99375, 0.9875, 0.98125, 0.975, 0.909375, 0.725, 0.421875, 0.0')
+            for begin,end,core_begin,core_end in core.chunk_windows(len(original)):
+                if not masks[core_begin:core_end].any():
+                    continue
+                # previous serializes chunks, avoiding parallel intermediate VRAM
+                # allocation. Model/CLIP/VAE nodes are shared, not loaded per chunk.
+                source=graph.node('H3CaptionChunkSource',images=original,masks=masks,begin=begin,end=end,previous=accumulated,crop_json=crop_json)
+                encoded=graph.node('VAEEncode',pixels=source.out(0),vae=vae.out(0))
+                guides=graph.node('LTXVAddGuideMulti',positive=cond.out(0),negative=cond.out(1),vae=vae.out(0),latent=encoded.out(0),
+                    **{'num_guides':'1','num_guides.image_1':source.out(0),'num_guides.frame_idx_1':0,'num_guides.strength_1':1.0})
+                empty_audio=graph.node('LTXVEmptyLatentAudio',frames_number=end-begin,frame_rate=fps,batch_size=1,audio_vae=audio_vae.out(0))
+                latent=graph.node('LTXVConcatAVLatent',video_latent=guides.out(2),audio_latent=empty_audio.out(0))
+                noise=graph.node('RandomNoise',noise_seed=(seed+core_begin)%(2**64))
+                guider=graph.node('CFGGuider',model=lora.out(0),positive=guides.out(0),negative=guides.out(1),cfg=1.0)
+                sampled=graph.node('SamplerCustomAdvanced',noise=noise.out(0),guider=guider.out(0),sampler=sampler.out(0),sigmas=sigmas.out(0),latent_image=latent.out(0))
+                separated=graph.node('LTXVSeparateAVLatent',av_latent=sampled.out(0))
+                cropped=graph.node('LTXVCropGuides',positive=guides.out(0),negative=guides.out(1),latent=separated.out(0))
+                decoded=graph.node('VAEDecode',samples=cropped.out(2),vae=vae.out(0))
+                mixed=graph.node('H3CaptionBlendChunk',previous=accumulated,original=original,cleaned=decoded.out(0),masks=masks,
+                    begin=begin,end=end,core_begin=core_begin,core_end=core_end,crop_json=crop_json)
+                accumulated=mixed.out(0)
+        final=graph.node('H3CaptionFinalize',images=accumulated,fps=fps,subtitle_text=subtitle_text,
+                         cue_json=json.dumps(cues,ensure_ascii=False),plan_json=json.dumps(plan),needs_recheck=bool(plan['regions']))
+        summary={'overlays':len(plan['regions']),'semantic_tracks':len(plan.get('semantic_audit',[])),
+               'inspection_seconds':time.monotonic()-check_started}
+        return {'result':(final.out(0),),'expand':graph.finalize(),'ui':{'h3_verification':[summary]}}
+
+
+class H3TextRegionVerifier:
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {'required':{'images':('IMAGE',),'regions':('STRING',{'multiline':True,'default':'[]'}),'classifier_clip':('CLIP',)},'optional':{'temporal_review':('BOOLEAN',{'default':False}),'scene_context':('BOOLEAN',{'default':False})}}
+    RETURN_TYPES=('STRING',)
+    FUNCTION='verify'
+    OUTPUT_NODE=True
+    CATEGORY='video/h3-verified/internal'
+
+    def verify(self,images,regions,classifier_clip,temporal_review=False,scene_context=False):
+        try:rows=json.loads(regions)
+        except ValueError:core.failure('H3_SUBTITLE_INPUT','文字区域列表无效')
+        if not isinstance(rows,list) or len(rows)>768:core.failure('H3_SUBTITLE_INPUT','文字区域数量无效')
+        pixels=array_frames(images);samples=[]
+        for row in rows:
+            if not isinstance(row,dict) or not isinstance(row.get('frame'),int) or not 0<=row['frame']<len(pixels):
+                core.failure('H3_SUBTITLE_INPUT','文字区域帧号无效')
+            box=row.get('box')
+            if not isinstance(box,list) or len(box)!=4 or any(not isinstance(x,int) for x in box):
+                core.failure('H3_SUBTITLE_INPUT','文字区域坐标无效')
+            samples.append((pixels[row['frame']],box))
+        started=time.monotonic()
+        if scene_context and temporal_review:core.failure('H3_SUBTITLE_INPUT','诊断模式不能同时启用')
+        if scene_context:labels=vision.classify_scene_many(samples,interrupt,clip=classifier_clip)
+        else:labels=vision.review_many([samples],interrupt,clip=classifier_clip) if temporal_review else vision.classify_many(samples,interrupt,clip=classifier_clip)
+        result=json.dumps({'labels':labels,'seconds':time.monotonic()-started})
+        return {'result':(result,),'ui':{'text':[result]}}
+
+
+class H3CaptionChunkSource:
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {'required':{'images':('IMAGE',),'masks':('MASK',),'begin':('INT',),'end':('INT',),'previous':('IMAGE',)},'optional':{'crop_json':('STRING',{'default':''})}}
+    RETURN_TYPES=('IMAGE',)
+    FUNCTION='prepare'
+    CATEGORY='video/h3-verified/internal'
+
+    def prepare(self,images,masks,begin,end,previous,crop_json=''):
+        import torch
+        import torch.nn.functional as F
+        interrupt()
+        if not 0 <= begin < end <= len(images) or end-begin > 96:
+            core.failure('H3_SUBTITLE_INPUT','清理分块边界无效')
+        x,y,w,h=json.loads(crop_json) if crop_json else [0,0,images.shape[2],images.shape[1]]
+        if not (0<=x<x+w<=images.shape[2] and 0<=y<y+h<=images.shape[1]):
+            core.failure('H3_SUBTITLE_INPUT','字幕上下文裁剪越界')
+        rgb=images[begin:end,y:y+h,x:x+w].cpu();mask=masks[begin:end,y:y+h,x:x+w].cpu()
+        h,w=rgb.shape[1:3];scale=min(1.0,1024/max(h,w));nh=max(32,round(h*scale/32)*32);nw=max(32,round(w*scale/32)*32)
+        if (h,w)!=(nh,nw):
+            rgb=F.interpolate(rgb.permute(0,3,1,2),size=(nh,nw),mode='bilinear',align_corners=False).permute(0,2,3,1)
+            mask=F.interpolate(mask[:,None],size=(nh,nw),mode='nearest')[:,0]
+        painted=torch.where(mask[:,:,:,None]>0,torch.ones_like(rgb),rgb)
+        pad=(1-len(painted))%4
+        if pad:painted=torch.cat([painted[:1].repeat(pad,1,1,1),painted])
+        return (painted,)
+
+
+class H3CaptionBlendChunk:
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {'required':{'previous':('IMAGE',),'original':('IMAGE',),'cleaned':('IMAGE',),'masks':('MASK',),
+                'begin':('INT',),'end':('INT',),'core_begin':('INT',),'core_end':('INT',)},'optional':{'crop_json':('STRING',{'default':''})}}
+    RETURN_TYPES=('IMAGE',)
+    FUNCTION='blend'
+    CATEGORY='video/h3-verified/internal'
+
+    def blend(self,previous,original,cleaned,masks,begin,end,core_begin,core_end,crop_json=''):
+        import torch
+        import torch.nn.functional as F
+        interrupt()
+        pad=(1-(end-begin))%4
+        if len(cleaned) != end-begin+pad or previous.shape != original.shape:
+            core.failure('H3_SUBTITLE_FRAME_COUNT','清理前后帧数不一致，未截断原视频')
+        cleaned=cleaned[pad:].detach().cpu()
+        x,y,w,h=json.loads(crop_json) if crop_json else [0,0,original.shape[2],original.shape[1]]
+        if cleaned.shape[1:3] != (h,w):
+            cleaned=F.interpolate(cleaned.permute(0,3,1,2),size=(h,w),mode='bilinear',align_corners=False).permute(0,2,3,1)
+        mask=masks[core_begin:core_end].cpu();source=original[core_begin:core_end]
+        generated=cleaned[core_begin-begin:core_end-begin]
+        import numpy as np
+        mixed=source.clone()
+        for i in range(len(source)):
+            interrupt()
+            base=(source[i].clamp(0,1).numpy()*255).round().astype(np.uint8)
+            replacement=base.copy()
+            replacement[y:y+h,x:x+w]=(generated[i].clamp(0,1).numpy()*255).round().astype(np.uint8)
+            merged=core.composite_poisson(base,replacement,mask[i].numpy())
+            mixed[i]=torch.where(mask[i,:,:,None]>0,torch.from_numpy(merged).to(source.dtype)/255,source[i])
+        if not torch.isfinite(mixed).all():core.failure('H3_SUBTITLE_OUTPUT','字幕清理输出含无效像素')
+        output=previous.clone();output[core_begin:core_end]=mixed
+        return (output,)
+
+
+class H3CaptionFinalize:
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {'required':{'images':('IMAGE',),'fps':('FLOAT',),'subtitle_text':('STRING',),
+                'cue_json':('STRING',),'plan_json':('STRING',),'needs_recheck':('BOOLEAN',)},'optional':{'classifier_clip':('CLIP',)}}
+    RETURN_TYPES=('IMAGE',)
+    FUNCTION='finish'
+    CATEGORY='video/h3-verified'
+
+    def finish(self,images,fps,subtitle_text,cue_json,plan_json,needs_recheck,classifier_clip=None):
+        import torch
+        import numpy as np
+        from PIL import Image
+        interrupt();plan=json.loads(plan_json)
+        if tuple(images.shape) != (plan['frames'],plan['height'],plan['width'],3):
+            core.failure('H3_SUBTITLE_FRAME_COUNT','字幕处理改变了视频尺寸或帧数')
+        if needs_recheck:
+            audit=audit_logger()
+            classify=lambda samples,interrupt:vision.classify_many(samples,interrupt,clip=classifier_clip,audit=audit)
+            review=lambda groups,interrupt:vision.review_many(groups,interrupt,clip=classifier_clip,audit=audit)
+            after=core.caption_plan(array_frames(images),fps,interrupt=interrupt,classify_many=classify,audit=audit,review_many=review)
+            if after['regions']:
+                core.failure('H3_SUBTITLE_RESIDUAL','仍检测到原生字幕，未返回双层字幕视频')
+        if not subtitle_text:
+            return (images,)
+        font_supports(subtitle_text)
+        cues=renderer.build_cues(subtitle_text,len(images),fps,images.shape[2],images.shape[1],cue_json)
+        result=images.clone()
+        for i in range(len(images)):
+            interrupt()
+            active=next((c for c in cues if c['start']<=i/fps<c['end']),None)
+            if active is None:continue
+            rgb=(images[i].cpu().clamp(0,1).numpy()*255).round().astype(np.uint8)
+            drawn=np.array(renderer.render_frame(Image.fromarray(rgb),active['text']))
+            changed=torch.from_numpy(np.any(drawn!=rgb,axis=2))[:,:,None]
+            # Preserve original floating-point pixels outside the font glyphs.
+            result[i]=torch.where(changed,torch.from_numpy(drawn).to(images.dtype)/255,images[i].cpu())
+        return (result,)
+
+
+NODE_CLASS_MAPPINGS={c.__name__:c for c in [H3CaptionPipeline,H3CaptionChunkSource,H3CaptionBlendChunk,H3CaptionFinalize,H3InpaintConditioningCache,H3CaptionWarmup,H3TextRegionVerifier,H3STTNRepair,H3GenerationModelStage]}
+NODE_DISPLAY_NAME_MAPPINGS={'H3CaptionPipeline':'H3 统一字幕处理（检测/清理/校验/烧录）'}
+
+from .worker_state import register_worker_state
+register_worker_state()
diff --git a/integration-work/8189-worker-state.py b/integration-work/8189-worker-state.py
new file mode 100644
index 0000000..798fcea
--- /dev/null
+++ b/integration-work/8189-worker-state.py
@@ -0,0 +1,86 @@
+"""Worker drain and verified history restore for rolling updates.
+
+Control files are operator-owned, read-only mounts. They cannot be supplied in a
+generation prompt. Existing history and output reads are never gated by drain.
+"""
+import hashlib
+import json
+import os
+from pathlib import Path
+import secrets
+import sys
+import uuid
+
+
+def maintenance_enabled(path):
+    try:
+        data=Path(path).read_bytes()
+        if len(data)>4096:return True
+        value=json.loads(data)
+        if value.get('schema')!=1 or not isinstance(value.get('maintenance'),bool):return True
+        return value['maintenance']
+    except (OSError,ValueError,TypeError):return True
+
+
+def make_middleware(path,canary_token):
+    from aiohttp import web
+    @web.middleware
+    async def gate(request,handler):
+        controlled=(request.method=='GET' and request.path in ['/queue','/api/queue']) or (
+                    request.method=='POST' and request.path in ['/prompt','/api/prompt'])
+        supplied=request.headers.get('X-H3-Canary-Token','')
+        bypass=bool(canary_token and secrets.compare_digest(supplied,canary_token))
+        if controlled and not bypass and maintenance_enabled(path):
+            return web.json_response({'error':{'type':'h3_worker_draining',
+                'message':'Worker maintenance: existing jobs/results are retained; new jobs use the other worker.'}},status=503,
+                headers={'Retry-After':'10'})
+        # Authentication is still handled by the original middleware/handler.
+        # A canary token only bypasses drain, never normal API authorization.
+        return await handler(request)
+    return gate
+
+
+def restore_history(queue,path,expected_sha256,expected_source):
+    p=Path(path)
+    if p.stat().st_size>256*1024**2:raise ValueError('History snapshot exceeds the audited size bound')
+    raw=p.read_bytes()
+    if not expected_sha256 or hashlib.sha256(raw).hexdigest()!=expected_sha256:
+        raise ValueError('History snapshot SHA256 mismatch')
+    snapshot=json.loads(raw)
+    if snapshot.get('schema')!=1 or snapshot.get('queue_empty') is not True or snapshot.get('source_container_id')!=expected_source:
+        raise ValueError('History snapshot identity or drain state mismatch')
+    history=snapshot.get('history')
+    if not isinstance(history,dict):raise ValueError('History snapshot must contain a dictionary')
+    for key,value in history.items():
+        uuid.UUID(key)
+        if not isinstance(value,dict) or value.get('status',{}).get('status_str') not in ['success','error']:
+            raise ValueError('A nonterminal history entry cannot be imported')
+    with queue.mutex:
+        if queue.queue or queue.currently_running:
+            raise ValueError('Never restore a snapshot into a worker already executing jobs')
+        overlap=set(history)&set(queue.history)
+        if any(history[k]!=queue.history[k] for k in overlap):raise ValueError('History identifier collision')
+        queue.history.update(history)
+    return len(history)
+
+
+def register_worker_state():
+    server=sys.modules.get('server')
+    instance=getattr(getattr(server,'PromptServer',None),'instance',None)
+    if instance is None or getattr(instance,'_h3_worker_state_registered',False):return
+    control=os.environ.get('H3_WORKER_CONTROL_FILE','')
+    if control:
+        token=os.environ.get('H3_CANARY_TOKEN','')
+        token_file=os.environ.get('H3_CANARY_TOKEN_FILE','')
+        if token_file:
+            token=Path(token_file).read_text().strip()
+            if len(token)<16:raise ValueError('Canary token file is missing a valid operator token')
+        instance.app.middlewares.append(make_middleware(control,token))
+    snapshot=os.environ.get('H3_HISTORY_SNAPSHOT','')
+    if snapshot:
+        async def restore_before_listen(app):
+            count=restore_history(instance.prompt_queue,snapshot,os.environ.get('H3_HISTORY_SNAPSHOT_SHA256',''),
+                                  os.environ.get('H3_HISTORY_SOURCE_CONTAINER_ID',''))
+            print(f'H3 verified history restored: {count} terminal jobs; no prompt resubmission',flush=True)
+        instance.app.on_startup.append(restore_before_listen)
+    instance._h3_worker_state_registered=True
diff --git a/integration-work/add_asset_reference_ui.py b/integration-work/add_asset_reference_ui.py
new file mode 100644
index 0000000..d8c795d
--- /dev/null
+++ b/integration-work/add_asset_reference_ui.py
@@ -0,0 +1,43 @@
+from pathlib import Path
+import json
+root=Path('D:/web/dj/huobao-source/frontend/app')
+p=root/'views/drama/episode.vue';s=p.read_text(encoding='utf-8')
+component=lambda kind,item:f'<AssetReferenceImages kind="{kind}" :asset="{item}" @updated="updateAssetReferences" @preview="openImageViewer" />'
+s=s.replace('<CharacterVoice :character="c"',component('character','c')+'\n                  <CharacterVoice :character="c"',1)
+for kind,item in [('scene','s'),('prop','p')]:
+    needle=':disabled="isPending'+('Scene' if kind=='scene' else 'Prop')+'Image('+item+'.id)" @click.stop="gen'
+    pos=s.index(needle);end=s.index('                </div>\n              </div>',pos)+len('                </div>')
+    s=s[:end]+'\n                '+component(kind,item)+s[end:]
+s=s.replace('<CharacterVoice v-if="assetDetail.type', '<AssetReferenceImages :key="assetDetail.type + assetDetail.item.id" :kind="assetDetail.type" :asset="assetDetail.item" @updated="updateAssetReferences" @preview="openImageViewer" />\n                <CharacterVoice v-if="assetDetail.type',1)
+needle="const assetDetail = ref({ open: false, type: '', item: null })"
+assert s.count(needle)==1
+s=s.replace(needle,needle+'''
+const referenceBusyIds = useState('asset-reference-busy', () => [])
+function referencesSaving(type, id) { return referenceBusyIds.value.includes(`${type}:${id}`) }
+function updateAssetReferences(type, id, references) {
+  const patch = { reference_images: references, referenceImages: references }
+  const items = type === 'character' ? chars.value : type === 'scene' ? scenes.value : propItems.value
+  const item = items.find(value => value.id === id)
+  if (item) Object.assign(item, patch)
+  if (assetDetail.value.type === type && assetDetail.value.item?.id === id) Object.assign(assetDetail.value.item, patch)
+}
+''',1)
+for kind,suffix,item in [('character','Char','c'),('scene','Scene','s'),('prop','Prop','p')]:
+    needle=f'async function gen{suffix}Img(id) {{'
+    s=s.replace(needle,needle+f"\n  if (referencesSaving('{kind}', id)) {{ toast.info(t('assetReferences.wait')); return }}",1)
+    for expr in [item+'.id','assetDetail.item.id']:
+        s=s.replace(f':disabled="isPending{suffix}Image({expr})"',f':disabled="isPending{suffix}Image({expr}) || referencesSaving(\'{kind}\', {expr})"')
+for name in ('batchCharImages','batchSceneImages','batchPropImages'):
+    needle=f'function {name}() {{';s=s.replace(needle,needle+"\n  if (referenceBusyIds.value.length) { toast.info(t('assetReferences.wait')); return }",1)
+p.write_text(s,encoding='utf-8')
+translations={
+ 'zh':dict(title='生图参考图',add='添加参考图',saving='保存中',preview='预览参考图 {n}',remove='移除参考图 {n}',used='生成／重绘时自动使用，按顺序作为参考图。',empty='上传人物、造型或风格参考，生成／重绘时使用。',formats='JPG / PNG / WebP · 单张 ≤ 20MB · 最多 6 张',limit='每个资产最多 6 张参考图',invalid='请选择有效的 JPG、PNG 或 WebP 图片，单张不超过 20MB',saved='参考图已保存，生成／重绘时会自动使用',removed='已移除参考图',wait='参考图保存中，请稍后生成'),
+ 'en':dict(title='Image references',add='Add references',saving='Saving',preview='Preview reference {n}',remove='Remove reference {n}',used='Used in this order when generating or redrawing.',empty='Add identity, outfit or style references for generation.',formats='JPG / PNG / WebP · Up to 20 MB each · 6 images max',limit='Up to 6 references per asset',invalid='Choose valid JPG, PNG or WebP files, up to 20 MB each',saved='References saved for generation and redraws',removed='Reference removed',wait='References are saving. Please wait before generating.'),
+ 'ja':dict(title='生成用の参照画像',add='参照画像を追加',saving='保存中',preview='参照画像 {n} を表示',remove='参照画像 {n} を削除',used='生成・再生成時に、この順序で参照します。',empty='人物・衣装・画風の参照画像を追加できます。',formats='JPG / PNG / WebP · 1枚20MBまで · 最大6枚',limit='素材ごとに参照画像は最大6枚です',invalid='20MB以下のJPG・PNG・WebP画像を選択してください',saved='参照画像を保存しました',removed='参照画像を削除しました',wait='参照画像を保存中です。お待ちください。'),
+ 'ko':dict(title='생성 참고 이미지',add='참고 이미지 추가',saving='저장 중',preview='참고 이미지 {n} 미리보기',remove='참고 이미지 {n} 제거',used='생성 또는 다시 그리기 시 이 순서로 사용합니다.',empty='인물, 의상 또는 스타일 참고 이미지를 추가하세요.',formats='JPG / PNG / WebP · 장당 20MB 이하 · 최대 6장',limit='에셋당 참고 이미지는 최대 6장입니다',invalid='장당 20MB 이하의 JPG, PNG 또는 WebP 이미지를 선택하세요',saved='생성에 사용할 참고 이미지를 저장했습니다',removed='참고 이미지를 제거했습니다',wait='참고 이미지를 저장 중입니다. 잠시 기다려 주세요.')
+}
+for lang,values in translations.items():
+    p=root/'locales'/(lang+'.json');s=p.read_text(encoding='utf-8');assert '"assetReferences"' not in s
+    block=json.dumps(values,ensure_ascii=False,indent=2).replace('\n','\n  ')
+    s=s.replace('{','{\n  "assetReferences": '+block+',',1);json.loads(s);p.write_text(s,encoding='utf-8')
+print('Reference components and translations added')
diff --git a/integration-work/admit_three_gpus.py b/integration-work/admit_three_gpus.py
new file mode 100644
index 0000000..1b1b294
--- /dev/null
+++ b/integration-work/admit_three_gpus.py
@@ -0,0 +1,15 @@
+import pathlib,json,os,subprocess
+root=pathlib.Path('/home/ps/huobao-gpu-selection');state=json.loads((root/'state.json').read_text())
+data=json.loads((root/'three-gpu-preflight.json').read_text())
+assert set(data)=={'default','gpu1','gpu3'} and all(not d['vdn_missing'] for d in data.values())
+for name in ('canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer'):
+ code="import app; assert set(app.providers())=={'default','gpu1','gpu3'}; [app.provider_headers(p) for p in app.providers().values()]; print('Provider token access verified')"
+ subprocess.run(['docker','exec',name,'python','-c',code],check=True)
+meta=json.loads((root/'gpu3-vdn/created.json').read_text());control=pathlib.Path(meta['control'])
+original=(root/'gpu3-vdn/original-control.json').read_bytes();expected=json.loads(original);expected['maintenance']=True
+assert json.loads(control.read_text())==expected
+control.write_bytes(original)
+admission=pathlib.Path(state['admission']);assert json.loads(admission.read_text())=={'schema':1,'admit':['default']}
+tmp=admission.with_name('admission.huobao-ready.json');tmp.write_text(json.dumps({'schema':1,'admit':['default','gpu1','gpu3']}));tmp.chmod(admission.stat().st_mode&0o777);os.replace(tmp,admission)
+state['phase']='three-gpus-admitted';(root/'state.json').write_text(json.dumps(state,indent=2))
+print('Enabled GPU1/GPU2/GPU3; GPU3 original control restored, GPU1 token gate retained')
diff --git a/integration-work/bridge-live-before.py b/integration-work/bridge-live-before.py
new file mode 100644
index 0000000..2cfc5b1
--- /dev/null
+++ b/integration-work/bridge-live-before.py
@@ -0,0 +1,572 @@
+"""Private adapters for Huobao: Dify, Qwen Image, local H3, and Grok CLI."""
+from __future__ import annotations
+
+import asyncio
+import base64
+from contextlib import closing
+from email import policy
+from email.parser import BytesParser
+import hashlib
+import hmac
+import json
+import math
+import os
+from pathlib import Path
+import re
+import secrets
+import sqlite3
+import struct
+import tempfile
+import time
+from urllib.parse import quote
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Request
+from fastapi.responses import JSONResponse, StreamingResponse
+
+
+def chat_query(body):
+    messages = body.get("messages")
+    if not isinstance(messages, list) or not messages:
+        raise HTTPException(400, "messages must be a non-empty array")
+    if body.get("tool_choice") == "required" or isinstance(body.get("tool_choice"), dict):
+        raise HTTPException(400, "This chatflow does not support required tool calls; use DeepSeek")
+    parts = []
+    for item in messages:
+        content = item.get("content", "")
+        if isinstance(content, list):
+            if any(p.get("type") != "text" for p in content):
+                raise HTTPException(400, "This adapter accepts text messages only")
+            content = "\n".join(p.get("text", "") for p in content)
+        if content:
+            parts.append(f"[{item.get('role', 'user')}]\n{content}")
+    fmt = body.get("response_format") or {}
+    if fmt.get("type") == "json_schema":
+        parts.append("Return only JSON matching this schema:\n" + json.dumps(fmt.get("json_schema", {}).get("schema", {}), ensure_ascii=False))
+    elif fmt.get("type") == "json_object":
+        parts.append("Return only a valid JSON object, without Markdown fences.")
+    if not parts:
+        raise HTTPException(400, "Empty messages")
+    return "\n\n".join(parts)
+
+
+def image_dimensions(data_url):
+    try:
+        data = base64.b64decode(data_url.split(",", 1)[1], validate=True)
+        if data.startswith(b"\x89PNG\r\n\x1a\n"):
+            return struct.unpack(">II", data[16:24])
+        if data.startswith((b"GIF87a", b"GIF89a")):
+            return struct.unpack("<HH", data[6:10])
+        if data[:2] == b"\xff\xd8":
+            offset = 2
+            while offset + 4 < len(data):
+                if data[offset] != 255:
+                    offset += 1
+                    continue
+                while data[offset] == 255:
+                    offset += 1
+                marker = data[offset]
+                offset += 1
+                if marker in {0xD8, 0xD9} or 0xD0 <= marker <= 0xD7:
+                    continue
+                size = int.from_bytes(data[offset:offset + 2], "big")
+                if marker in {0xC0, 0xC1, 0xC2, 0xC3, 0xC5, 0xC6, 0xC7, 0xC9, 0xCA, 0xCB, 0xCD, 0xCE, 0xCF}:
+                    height, width = struct.unpack(">HH", data[offset + 3:offset + 7])
+                    return width, height
+                if size < 2:
+                    break
+                offset += size
+        if data[:4] == b"RIFF" and data[8:12] == b"WEBP":
+            if data[12:16] == b"VP8X":
+                return 1 + int.from_bytes(data[24:27], "little"), 1 + int.from_bytes(data[27:30], "little")
+            if data[12:16] == b"VP8L" and data[20] == 0x2F:
+                bits = int.from_bytes(data[21:25], "little")
+                return (bits & 0x3FFF) + 1, ((bits >> 14) & 0x3FFF) + 1
+            if data[12:16] == b"VP8 " and data[23:26] == b"\x9d\x01\x2a":
+                width, height = struct.unpack("<HH", data[26:30])
+                return width & 0x3FFF, height & 0x3FFF
+    except (ValueError, IndexError, struct.error):
+        pass
+    raise HTTPException(400, "Unable to read first-frame dimensions; use PNG, JPEG or WebP")
+
+
+VIDEO_MODELS = {
+    "MiniMax-H3-VDN-H3": {"reference": "minimax_h3_vdn_hd", "min_images": 1, "max_images": 9},
+    "MiniMax-H3": {"text": "minimax_h3_t2v_official", "first": "minimax_h3_i2v", "reference": "minimax_h3_r2v", "min_images": 0, "max_images": 9},
+    "MiniMax-H3-Hybrid": {"text": "minimax_h3_hybrid_v0331_t2v", "first": "minimax_h3_hybrid_v0331_i2v", "reference": "minimax_h3_hybrid_v0331_i2v", "min_images": 0, "max_images": 9},
+    "MiniMax-H3-R2V-4Step": {"reference": "minimax_h3_r2v_4step", "min_images": 1, "max_images": 9},
+    "LTX-2.3": {"text": "ltx23_t2v", "first": "ltx23_t2v", "reference": "ltx23_t2v", "min_images": 0, "max_images": 1},
+    "LTX-2.3-Text-Preserve": {"text": "ltx23_t2v_text_preserve", "first": "ltx23_t2v_text_preserve", "reference": "ltx23_t2v_text_preserve", "min_images": 0, "max_images": 1},
+    "Wan2.2-I2V": {"first": "wan22_simple", "reference": "wan22_simple", "min_images": 1, "max_images": 1},
+}
+
+
+def video_workflows(spec):
+    return {spec[mode] for mode in ("text", "first", "reference") if mode in spec}
+
+
+def gpu_routing(body):
+    gpu = body.get("gpu", "auto")
+    if gpu not in ("auto", "gpu1", "gpu2", "gpu3"):
+        raise HTTPException(400, "gpu must be auto, gpu1, gpu2 or gpu3")
+    if gpu == "auto":
+        return {"provider_id": "default"}
+    return {"provider_id": "default" if gpu == "gpu2" else gpu, "strict_provider": True}
+
+
+def h3_request(body):
+    """Translate the local video protocol. 'default' means upstream auto-balance."""
+    model = body.get("model", "MiniMax-H3")
+    spec = VIDEO_MODELS.get(model)
+    if spec is None:
+        raise HTTPException(400, "Unknown local video model; query /v1/models")
+    content = body.get("content") or []
+    if not isinstance(content, list):
+        raise HTTPException(400, "content must be an array")
+    prompt = "\n".join(str(c.get("text", "")) for c in content if c.get("type") == "text").strip()
+    if not prompt or len(prompt) > 7000:
+        raise HTTPException(400, "A prompt of 1-7000 characters is required")
+    images, roles = [], []
+    for item in content:
+        kind = item.get("type")
+        if kind == "text":
+            continue
+        if kind != "image_url" or item.get("role") == "last_frame":
+            raise HTTPException(400, "Local video supports first-frame/reference images; last frames, reference video and voice samples are unsupported")
+        raw = item.get("image_url") or {}
+        url = raw.get("url", "") if isinstance(raw, dict) else raw
+        if not isinstance(url, str) or not url.startswith("data:image/"):
+            raise HTTPException(400, "Local video requires inline image data; enable Huobao's local-image conversion")
+        images.append(url)
+        roles.append(item.get("role", "reference_image"))
+    if not spec["min_images"] <= len(images) <= spec["max_images"]:
+        raise HTTPException(400, f"{model} requires {spec['min_images']}-{spec['max_images']} images")
+    if "first_frame" in roles and len(images) != 1:
+        raise HTTPException(400, "Use either one fixed first frame or reference images; these modes cannot be combined")
+    mode = "text" if not images else "first" if roles == ["first_frame"] else "reference"
+    if mode not in spec:
+        raise HTTPException(400, f"{model} does not support {mode} mode; use reference images")
+    try:
+        duration = float(body.get("duration", 5))
+    except (ValueError, TypeError):
+        raise HTTPException(400, "Invalid duration")
+    if not math.isfinite(duration) or not 4 <= duration <= 15:
+        raise HTTPException(400, "Duration must be 4-15 seconds")
+    ratio = body.get("ratio", "16:9")
+    if ratio not in {"16:9", "9:16", "1:1", "4:3", "3:4", "21:9"}:
+        raise HTTPException(400, "Unsupported aspect ratio")
+    resolution = str(body.get("resolution", "768P")).upper()
+    resolutions = {"480P": 480, "720P": 720, "1080P": 1080, "768P": 768, "2K": 1152}
+    if model == "MiniMax-H3-VDN-H3":
+        if ratio not in {"16:9", "9:16"}:
+            raise HTTPException(400, "VDN HD supports 16:9 or 9:16")
+        resolutions = {"2K": 1440, "4K": 2160}
+    if resolution not in resolutions:
+        raise HTTPException(400, "Unsupported video resolution")
+    short = resolutions[resolution]
+    a, b = map(int, ratio.split(":"))
+    if roles == ["first_frame"] and "ratio" not in body:
+        a, b = image_dimensions(images[0])
+        if a <= 0 or b <= 0:
+            raise HTTPException(400, "Invalid first-frame dimensions")
+    width = round(short * max(1, a / b) / 64) * 64
+    height = round(short * max(1, b / a) / 64) * 64
+    if model == "MiniMax-H3-VDN-H3":
+        width, height = (short * 16 // 9, short) if a > b else (short, short * 16 // 9)
+    workflow = spec[mode]
+    request = {**gpu_routing(body), "workflow_key": workflow, "prompt": prompt,
+            "input_images": images, "duration": duration, "width": width, "height": height,
+            "metadata": {"source": "huobao-drama", "model": model}}
+    if body.get("seed") is not None:
+        if not isinstance(body["seed"], int) or not 0 <= body["seed"] < 2**63:
+            raise HTTPException(400, "Invalid seed")
+        request["seed"] = body["seed"]
+    return request
+
+
+def qwen_image_request(body, images=None):
+    if body.get("model") != "qwen_image_2_1":
+        raise HTTPException(400, "Use model qwen_image_2_1")
+    prompt = body.get("prompt")
+    if not isinstance(prompt, str) or not prompt.strip() or len(prompt) > 32000:
+        raise HTTPException(400, "A prompt of 1-32000 characters is required")
+    if str(body.get("n", 1)) != "1":
+        raise HTTPException(400, "This image adapter supports n=1 per task")
+    if body.get("response_format", "url") != "url":
+        raise HTTPException(400, "Asynchronous image tasks require response_format=url")
+    size = str(body.get("size", "1024x1024")).lower()
+    if size == "auto":
+        size = "1024x1024"
+    match = re.fullmatch(r"(\d{3,4})x(\d{3,4})", size)
+    if not match or not all(256 <= int(d) <= 4096 for d in match.groups()):
+        raise HTTPException(400, "size must be WIDTHxHEIGHT with dimensions 256-4096")
+    width, height = map(int, match.groups())
+    refs = images or []
+    if len(refs) > 6:
+        raise HTTPException(400, "Qwen Image 2.1 supports at most 6 reference images")
+    return {**gpu_routing(body), "workflow_key": "qwen_image_2_1", "prompt": prompt.strip(),
+            "width": width, "height": height, "batch_size": 1, "input_images": refs,
+            "metadata": {"source": "huobao-drama", "output_type": "image"}}
+
+
+async def parse_image_edit(request):
+    content_type = request.headers.get("content-type", "")
+    if not content_type.lower().startswith("multipart/form-data;"):
+        raise HTTPException(415, "Image edits require multipart/form-data")
+    raw = bytearray()
+    async for chunk in request.stream():
+        raw.extend(chunk)
+        if len(raw) > 64 * 1024 * 1024:
+            raise HTTPException(413, "Reference uploads exceed 64 MiB")
+    message = BytesParser(policy=policy.default).parsebytes(
+        ("Content-Type: " + content_type + "\r\nMIME-Version: 1.0\r\n\r\n").encode() + raw)
+    if not message.is_multipart() or message.defects:
+        raise HTTPException(400, "Invalid multipart image request")
+    fields, images = {}, []
+    for part in message.iter_parts():
+        name = part.get_param("name", header="content-disposition")
+        data = part.get_payload(decode=True)
+        if not isinstance(data, bytes):
+            raise HTTPException(400, "Invalid multipart field")
+        if name in {"image", "image[]"}:
+            mime = part.get_content_type()
+            if mime not in {"image/png", "image/jpeg", "image/webp"} or not data or len(data) > 10 * 1024 * 1024:
+                raise HTTPException(400, "Each reference must be PNG, JPEG or WebP, up to 10 MiB")
+            url = "data:" + mime + ";base64," + base64.b64encode(data).decode()
+            width, height = image_dimensions(url)
+            if not (0 < width <= 16384 and 0 < height <= 16384):
+                raise HTTPException(400, "Invalid reference image dimensions")
+            images.append(url)
+            if len(images) > 6:
+                raise HTTPException(400, "Qwen Image 2.1 supports at most 6 reference images")
+        elif name in {"model", "prompt", "size", "n", "response_format", "gpu"}:
+            if name in fields or len(data) > 128000:
+                raise HTTPException(400, "Duplicate or oversized form field")
+            try:
+                fields[name] = data.decode("utf-8")
+            except UnicodeDecodeError:
+                raise HTTPException(400, "Form text must be UTF-8")
+        else:
+            raise HTTPException(400, "Unsupported image edit field: " + str(name)[:60])
+    if not images:
+        raise HTTPException(400, "At least one reference image is required")
+    return qwen_image_request(fields, images)
+
+
+def create_app(config):
+    app = FastAPI(title="Huobao private model bridge", docs_url=None, redoc_url=None)
+    state_dir = Path(config.get("state_dir", "./state"))
+    state_dir.mkdir(parents=True, exist_ok=True)
+    db_path = state_dir / "jobs.sqlite3"
+    with closing(sqlite3.connect(db_path)) as db, db:
+        db.execute("CREATE TABLE IF NOT EXISTS jobs (id TEXT PRIMARY KEY, duration REAL NOT NULL, created REAL NOT NULL)")
+        db.execute("CREATE TABLE IF NOT EXISTS image_jobs (id TEXT PRIMARY KEY, created REAL NOT NULL)")
+
+    def auth(authorization: str | None = Header(default=None)):
+        expected = config.get("token", "")
+        if not expected or not secrets.compare_digest(authorization or "", "Bearer " + expected):
+            raise HTTPException(401, "Invalid bridge token")
+
+    @app.exception_handler(HTTPException)
+    async def http_error(request, exc):
+        return JSONResponse({"error": {"message": str(exc.detail), "type": "bridge_error", "code": exc.status_code}}, status_code=exc.status_code)
+
+    @app.exception_handler(httpx.HTTPError)
+    async def upstream_error(request, exc):
+        return JSONResponse({"error": {"message": "Upstream connection failed: " + type(exc).__name__, "type": "upstream_error"}}, status_code=502)
+
+    def upstream_headers():
+        return {"Authorization": "Bearer " + config["h3"]["token"]}
+
+    async def upstream(method, path, body=None):
+        if not config.get("h3"):
+            raise HTTPException(404, "H3 is not configured on this bridge")
+        async with httpx.AsyncClient(timeout=httpx.Timeout(180, connect=10), trust_env=False) as client:
+            r = await client.request(method, config["h3"]["url"] + path, headers=upstream_headers(), json=body)
+        if r.is_error:
+            try:
+                detail = r.json().get("detail", "Model service request failed")
+            except ValueError:
+                detail = "Model service request failed"
+            raise HTTPException(r.status_code, str(detail)[:600])
+        return r.json()
+
+    @app.get("/health")
+    async def health():
+        return {"status": "ok", "service": "huobao-model-bridge"}
+
+    @app.get("/v1/models", dependencies=[Depends(auth)])
+    async def models():
+        names = list(config.get("dify", {}))
+        if config.get("h3"):
+            # Verify the real service, instead of making a local catalogue look healthy.
+            registry = await upstream("GET", "/v1/models")
+            available = {m["id"] for m in registry.get("data", [])}
+            names.extend(name for name, spec in VIDEO_MODELS.items() if video_workflows(spec) <= available)
+            if any(m.get("id") == "qwen_image_2_1" and m.get("model_type") == "image" for m in registry.get("data", [])):
+                names.append("qwen_image_2_1")
+        if config.get("grok"):
+            names.append("grok-local")
+        return {"object": "list", "data": [{"id": n, "object": "model", "owned_by": "private"} for n in names]}
+
+    async def dify_events(model, query):
+        upstream_config = config["dify"][model]
+        payload = {"inputs": {}, "query": query, "response_mode": "streaming",
+                   "user": "huobao-" + secrets.token_hex(8), "auto_generate_name": False}
+        finished, usage = False, {}
+        async with httpx.AsyncClient(timeout=httpx.Timeout(240, connect=10), trust_env=False) as client:
+            async with client.stream("POST", upstream_config["url"] + "/chat-messages",
+                                     headers={"Authorization": "Bearer " + upstream_config["key"]}, json=payload) as response:
+                if response.is_error:
+                    await response.aread()
+                    try:
+                        message = response.json().get("message", "Dify request failed")
+                    except ValueError:
+                        message = "Dify request failed"
+                    raise HTTPException(response.status_code, str(message)[:400])
+                async for line in response.aiter_lines():
+                    if not line.startswith("data:"):
+                        continue
+                    event = json.loads(line[5:].strip())
+                    kind = event.get("event")
+                    if kind in {"message", "agent_message"}:
+                        yield "text", event.get("answer", "")
+                    elif kind == "error":
+                        raise HTTPException(502, str(event.get("message", "Dify generation failed"))[:400])
+                    elif kind == "message_end":
+                        finished = True
+                        usage = event.get("metadata", {}).get("usage", {})
+                    elif kind == "workflow_finished":
+                        data = event.get("data") or {}
+                        if data.get("status") not in {None, "succeeded"}:
+                            raise HTTPException(502, str(data.get("error") or "Dify workflow failed")[:400])
+                if not finished:
+                    raise HTTPException(502, "Dify stream ended before message_end")
+        yield "usage", usage
+
+    async def grok_events(query):
+        item = config["grok"]
+        args = [item["exe"], "--cwd", item["cwd"], "--output-format", "json", "--verbatim",
+                "--no-subagents", "--no-memory", "--disable-web-search", "--max-turns", "1",
+                "--tools", "", "--deny", "MCPTool", "--permission-mode", "dontAsk",
+                "--system-prompt-override", "Answer the supplied writing request using text only. Do not use tools."]
+        options = {"creationflags": 0x08000000} if os.name == "nt" else {}
+        # A file avoids the Windows command-line length limit for full scripts.
+        with tempfile.TemporaryDirectory(prefix="huobao-grok-") as scratch:
+            prompt_file = Path(scratch) / "prompt.txt"
+            prompt_file.write_text(query, encoding="utf-8")
+            args += ["--prompt-file", str(prompt_file)]
+            process = await asyncio.create_subprocess_exec(*args, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.PIPE, **options)
+            try:
+                out, err = await asyncio.wait_for(process.communicate(), timeout=240)
+            except (asyncio.TimeoutError, asyncio.CancelledError):
+                process.kill()
+                await process.wait()
+                raise
+        try:
+            data = json.loads(out.decode("utf-8"))
+        except (ValueError, UnicodeDecodeError):
+            raise HTTPException(502, "Grok CLI did not return JSON; run Grok login on this computer")
+        if process.returncode or not data.get("text"):
+            raise HTTPException(502, "Grok CLI failed; check local login and available quota")
+        yield "text", data["text"]
+        yield "usage", data.get("usage", {})
+
+    @app.post("/v1/chat/completions", dependencies=[Depends(auth)])
+    async def chat(body: dict):
+        model = body.get("model", "")
+        if model not in config.get("dify", {}) and not (model == "grok-local" and config.get("grok")):
+            raise HTTPException(404, "Unknown text model")
+        query = chat_query(body)
+        events = grok_events(query) if model == "grok-local" else dify_events(model, query)
+        cid, created = "chatcmpl-" + secrets.token_hex(12), int(time.time())
+
+        def chunk(delta, finish=None):
+            return {"id": cid, "object": "chat.completion.chunk", "created": created, "model": model,
+                    "choices": [{"index": 0, "delta": delta, "finish_reason": finish}]}
+
+        if body.get("stream"):
+            async def stream():
+                def encode(value):
+                    return "data: " + json.dumps(value, ensure_ascii=False) + "\n\n"
+                yield encode(chunk({"role": "assistant", "content": ""}))
+                try:
+                    async for kind, value in events:
+                        if kind == "text":
+                            yield encode(chunk({"content": value}))
+                    yield encode(chunk({}, "stop"))
+                except (HTTPException, httpx.HTTPError) as error:
+                    message = str(error.detail) if isinstance(error, HTTPException) else "Upstream connection failed"
+                    yield encode({"error": {"message": message, "type": "upstream_error"}})
+                yield "data: [DONE]\n\n"
+            return StreamingResponse(stream(), media_type="text/event-stream", headers={"Cache-Control": "no-cache"})
+        text, usage = "", {}
+        async for kind, value in events:
+            if kind == "text":
+                text += value
+            else:
+                usage = value
+        return {"id": cid, "object": "chat.completion", "created": created, "model": model,
+                "choices": [{"index": 0, "message": {"role": "assistant", "content": text}, "finish_reason": "stop"}],
+                "usage": {"prompt_tokens": usage.get("prompt_tokens", usage.get("input_tokens", 0)),
+                          "completion_tokens": usage.get("completion_tokens", usage.get("output_tokens", 0)),
+                          "total_tokens": usage.get("total_tokens", 0)}}
+
+    async def require_qwen_image():
+        registry = await upstream("GET", "/v1/models")
+        if not any(m.get("id") == "qwen_image_2_1" and m.get("model_type") == "image" for m in registry.get("data", [])):
+            raise HTTPException(503, "Qwen Image 2.1 workflow is unavailable")
+
+    @app.get("/v1/images/pool", dependencies=[Depends(auth)])
+    async def image_pool():
+        await require_qwen_image()
+        health, catalogue = await asyncio.gather(upstream("GET", "/health"), upstream("GET", "/v1/providers"))
+        return {"model": "qwen_image_2_1", "auto_balance": health.get("autoBalance") is True,
+                "routing": "shortest-queue-with-reservations" if health.get("autoBalance") is True else "single-provider",
+                "configured_workers": [{"id": p["id"], "name": p.get("name", p["id"])} for p in catalogue.get("providers", [])]}
+
+    async def submit_image(payload):
+        await require_qwen_image()
+        result = await upstream("POST", "/v1/jobs", payload)
+        jid = result.get("id")
+        if not isinstance(jid, str) or not jid:
+            raise HTTPException(502, "Image service did not return a task ID")
+        with closing(sqlite3.connect(db_path)) as db, db:
+            db.execute("INSERT INTO image_jobs VALUES(?,?)", (jid, time.time()))
+        return {"task_id": jid, "status": "processing", "provider_id": result.get("providerId")}
+
+    @app.post("/v1/images/validate", dependencies=[Depends(auth)])
+    async def validate_image(body: dict):
+        payload = qwen_image_request(body)
+        await require_qwen_image()
+        return {"valid": True, "workflow": payload["workflow_key"], "requested_size": [payload["width"], payload["height"]], "max_reference_images": 6,
+                "pool": await image_pool()}
+
+    @app.post("/v1/images/generations", dependencies=[Depends(auth)])
+    async def generate_image(body: dict):
+        return await submit_image(qwen_image_request(body))
+
+    @app.post("/v1/images/edits", dependencies=[Depends(auth)])
+    async def edit_image(request: Request):
+        return await submit_image(await parse_image_edit(request))
+
+    @app.get("/v1/images/task/{jid}", dependencies=[Depends(auth)])
+    async def poll_image(jid: str):
+        with closing(sqlite3.connect(db_path)) as db:
+            found = db.execute("SELECT 1 FROM image_jobs WHERE id=?", (jid,)).fetchone()
+        if not found:
+            raise HTTPException(404, "Unknown image task")
+        result = await upstream("GET", "/v1/jobs/" + quote(jid, safe=""))
+        state = result.get("status", "running")
+        if state in {"failed", "cancelled"}:
+            return {"status": "failed", "error": {"message": str(result.get("error") or "Image generation failed")[:600]}}
+        if state != "succeeded":
+            return {"status": "processing", "provider_id": result.get("providerId")}
+        output = next((o for o in result.get("outputs", []) if o.get("kind") == "image"), None)
+        if output is None:
+            return {"status": "failed", "error": {"message": "Task completed without an image output"}}
+        index, expiry = int(output["index"]), int(time.time()) + 86400
+        extension = {"image/png": "png", "image/jpeg": "jpg", "image/webp": "webp"}.get(output.get("mimeType"), "png")
+        # Huobao determines the saved extension from the URL, not Content-Type.
+        url = f"{config['public_url']}/media/{quote(jid, safe='')}/{index}/image.{extension}?expires={expiry}&sig={signature(jid, index, expiry)}"
+        return {"status": "completed", "image_url": url, "data": [{"url": url}], "provider_id": result.get("providerId")}
+
+    @app.post("/v2/video_generation/validate", dependencies=[Depends(auth)])
+    async def validate_video(body: dict):
+        request = h3_request(body)
+        registry = await upstream("GET", "/v1/models")
+        if request["workflow_key"] not in {m["id"] for m in registry.get("data", [])}:
+            raise HTTPException(503, "Selected video workflow is unavailable")
+        plan = await upstream("POST", "/v1/audio-plan", request)
+        return {"valid": plan.get("status", "ready") == "ready", "workflow": request["workflow_key"],
+                "width": request["width"], "height": request["height"], "duration": request["duration"], "audio_plan": plan,
+                "routing": "upstream-auto-balance"}
+
+    @app.post("/v2/video_generation", dependencies=[Depends(auth)])
+    async def video(body: dict):
+        # Huobao probes video providers with an empty body. Check the real
+        # upstream without submitting a GPU task, then report readiness.
+        if not body:
+            registry = await upstream("GET", "/v1/models")
+            available = {m["id"] for m in registry.get("data", [])}
+            if not {"minimax_h3_t2v_official", "minimax_h3_i2v", "minimax_h3_r2v"} <= available:
+                raise HTTPException(503, "Required H3 workflows are unavailable")
+            return {"status": "ready", "probe": True, "model": "MiniMax-H3"}
+        request = h3_request(body)
+        registry = await upstream("GET", "/v1/models")
+        if request["workflow_key"] not in {m["id"] for m in registry.get("data", [])}:
+            raise HTTPException(503, "Selected video workflow is unavailable")
+        result = await upstream("POST", "/v1/jobs", request)
+        jid = result.get("id")
+        if not isinstance(jid, str) or not jid:
+            raise HTTPException(502, "Video service did not return a job ID")
+        with closing(sqlite3.connect(db_path)) as db, db:
+            db.execute("INSERT INTO jobs VALUES(?,?,?)", (jid, request["duration"], time.time()))
+        return {"task_id": jid, "status": "submitted", "provider_id": result.get("providerId")}
+
+    def get_job(jid):
+        with closing(sqlite3.connect(db_path)) as db:
+            row = db.execute("SELECT duration FROM jobs WHERE id=?", (jid,)).fetchone()
+        if not row:
+            raise HTTPException(404, "Unknown bridge job")
+        return row[0]
+
+    def signature(jid, index, expiry):
+        data = f"{jid}:{index}:{expiry}".encode()
+        return hmac.new(config["token"].encode(), data, hashlib.sha256).hexdigest()
+
+    @app.get("/v2/query/video_generation/{jid}", dependencies=[Depends(auth)])
+    async def poll(jid: str):
+        duration = get_job(jid)
+        result = await upstream("GET", "/v1/jobs/" + quote(jid, safe=""))
+        state = result.get("status", "running")
+        task = {"id": jid, "status": state, "duration": duration, "provider_id": result.get("providerId")}
+        if state == "succeeded":
+            output = next((o for o in result.get("outputs", []) if o.get("kind") == "video"), None)
+            if not output:
+                task.update(status="failed", error="Video task completed without a video output")
+            else:
+                index, expiry = int(output["index"]), int(time.time()) + 86400
+                url = f"{config['public_url']}/media/{quote(jid, safe='')}/{index}/video.mp4?expires={expiry}&sig={signature(jid, index, expiry)}"
+                task["content"] = {"url": url}
+        elif state in {"failed", "cancelled"}:
+            task["error"] = str(result.get("error") or "Video task failed")[:600]
+        return {"task": task}
+
+    @app.get("/media/{jid}/{index}")
+    @app.get("/media/{jid}/{index}/{filename}")
+    async def media(jid: str, index: int, expires: int, sig: str, filename: str | None = None):
+        if filename is not None and not re.fullmatch(r"image\.(png|jpg|webp)|video\.mp4", filename):
+            raise HTTPException(404, "Unknown media filename")
+        with closing(sqlite3.connect(db_path)) as db:
+            found = db.execute("SELECT 1 FROM jobs WHERE id=? UNION ALL SELECT 1 FROM image_jobs WHERE id=?", (jid, jid)).fetchone()
+        if not found:
+            raise HTTPException(404, "Unknown bridge task")
+        if expires < time.time() or not hmac.compare_digest(sig, signature(jid, index, expires)):
+            raise HTTPException(403, "Invalid or expired media link; poll the task again")
+        client = httpx.AsyncClient(timeout=httpx.Timeout(180, connect=10), trust_env=False)
+        url = config["h3"]["url"] + f"/v1/jobs/{quote(jid, safe='')}/outputs/{index}"
+        try:
+            response = await client.send(client.build_request("GET", url, headers=upstream_headers()), stream=True)
+            if response.is_error:
+                await response.aclose()
+                await client.aclose()
+                raise HTTPException(response.status_code, "Model output is not available")
+        except BaseException:
+            await client.aclose()
+            raise
+        async def download():
+            try:
+                async for part in response.aiter_bytes():
+                    yield part
+            finally:
+                await response.aclose()
+                await client.aclose()
+        return StreamingResponse(download(), media_type=response.headers.get("content-type", "video/mp4"))
+
+    return app
+
+
+def create_from_file():
+    path = Path(os.environ.get("HUOBAO_BRIDGE_CONFIG", "/bridge/config.json"))
+    return create_app(json.loads(path.read_text(encoding="utf-8")))
diff --git a/integration-work/bridge-vdn-live-before.py b/integration-work/bridge-vdn-live-before.py
new file mode 100644
index 0000000..2cfc5b1
--- /dev/null
+++ b/integration-work/bridge-vdn-live-before.py
@@ -0,0 +1,572 @@
+"""Private adapters for Huobao: Dify, Qwen Image, local H3, and Grok CLI."""
+from __future__ import annotations
+
+import asyncio
+import base64
+from contextlib import closing
+from email import policy
+from email.parser import BytesParser
+import hashlib
+import hmac
+import json
+import math
+import os
+from pathlib import Path
+import re
+import secrets
+import sqlite3
+import struct
+import tempfile
+import time
+from urllib.parse import quote
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Request
+from fastapi.responses import JSONResponse, StreamingResponse
+
+
+def chat_query(body):
+    messages = body.get("messages")
+    if not isinstance(messages, list) or not messages:
+        raise HTTPException(400, "messages must be a non-empty array")
+    if body.get("tool_choice") == "required" or isinstance(body.get("tool_choice"), dict):
+        raise HTTPException(400, "This chatflow does not support required tool calls; use DeepSeek")
+    parts = []
+    for item in messages:
+        content = item.get("content", "")
+        if isinstance(content, list):
+            if any(p.get("type") != "text" for p in content):
+                raise HTTPException(400, "This adapter accepts text messages only")
+            content = "\n".join(p.get("text", "") for p in content)
+        if content:
+            parts.append(f"[{item.get('role', 'user')}]\n{content}")
+    fmt = body.get("response_format") or {}
+    if fmt.get("type") == "json_schema":
+        parts.append("Return only JSON matching this schema:\n" + json.dumps(fmt.get("json_schema", {}).get("schema", {}), ensure_ascii=False))
+    elif fmt.get("type") == "json_object":
+        parts.append("Return only a valid JSON object, without Markdown fences.")
+    if not parts:
+        raise HTTPException(400, "Empty messages")
+    return "\n\n".join(parts)
+
+
+def image_dimensions(data_url):
+    try:
+        data = base64.b64decode(data_url.split(",", 1)[1], validate=True)
+        if data.startswith(b"\x89PNG\r\n\x1a\n"):
+            return struct.unpack(">II", data[16:24])
+        if data.startswith((b"GIF87a", b"GIF89a")):
+            return struct.unpack("<HH", data[6:10])
+        if data[:2] == b"\xff\xd8":
+            offset = 2
+            while offset + 4 < len(data):
+                if data[offset] != 255:
+                    offset += 1
+                    continue
+                while data[offset] == 255:
+                    offset += 1
+                marker = data[offset]
+                offset += 1
+                if marker in {0xD8, 0xD9} or 0xD0 <= marker <= 0xD7:
+                    continue
+                size = int.from_bytes(data[offset:offset + 2], "big")
+                if marker in {0xC0, 0xC1, 0xC2, 0xC3, 0xC5, 0xC6, 0xC7, 0xC9, 0xCA, 0xCB, 0xCD, 0xCE, 0xCF}:
+                    height, width = struct.unpack(">HH", data[offset + 3:offset + 7])
+                    return width, height
+                if size < 2:
+                    break
+                offset += size
+        if data[:4] == b"RIFF" and data[8:12] == b"WEBP":
+            if data[12:16] == b"VP8X":
+                return 1 + int.from_bytes(data[24:27], "little"), 1 + int.from_bytes(data[27:30], "little")
+            if data[12:16] == b"VP8L" and data[20] == 0x2F:
+                bits = int.from_bytes(data[21:25], "little")
+                return (bits & 0x3FFF) + 1, ((bits >> 14) & 0x3FFF) + 1
+            if data[12:16] == b"VP8 " and data[23:26] == b"\x9d\x01\x2a":
+                width, height = struct.unpack("<HH", data[26:30])
+                return width & 0x3FFF, height & 0x3FFF
+    except (ValueError, IndexError, struct.error):
+        pass
+    raise HTTPException(400, "Unable to read first-frame dimensions; use PNG, JPEG or WebP")
+
+
+VIDEO_MODELS = {
+    "MiniMax-H3-VDN-H3": {"reference": "minimax_h3_vdn_hd", "min_images": 1, "max_images": 9},
+    "MiniMax-H3": {"text": "minimax_h3_t2v_official", "first": "minimax_h3_i2v", "reference": "minimax_h3_r2v", "min_images": 0, "max_images": 9},
+    "MiniMax-H3-Hybrid": {"text": "minimax_h3_hybrid_v0331_t2v", "first": "minimax_h3_hybrid_v0331_i2v", "reference": "minimax_h3_hybrid_v0331_i2v", "min_images": 0, "max_images": 9},
+    "MiniMax-H3-R2V-4Step": {"reference": "minimax_h3_r2v_4step", "min_images": 1, "max_images": 9},
+    "LTX-2.3": {"text": "ltx23_t2v", "first": "ltx23_t2v", "reference": "ltx23_t2v", "min_images": 0, "max_images": 1},
+    "LTX-2.3-Text-Preserve": {"text": "ltx23_t2v_text_preserve", "first": "ltx23_t2v_text_preserve", "reference": "ltx23_t2v_text_preserve", "min_images": 0, "max_images": 1},
+    "Wan2.2-I2V": {"first": "wan22_simple", "reference": "wan22_simple", "min_images": 1, "max_images": 1},
+}
+
+
+def video_workflows(spec):
+    return {spec[mode] for mode in ("text", "first", "reference") if mode in spec}
+
+
+def gpu_routing(body):
+    gpu = body.get("gpu", "auto")
+    if gpu not in ("auto", "gpu1", "gpu2", "gpu3"):
+        raise HTTPException(400, "gpu must be auto, gpu1, gpu2 or gpu3")
+    if gpu == "auto":
+        return {"provider_id": "default"}
+    return {"provider_id": "default" if gpu == "gpu2" else gpu, "strict_provider": True}
+
+
+def h3_request(body):
+    """Translate the local video protocol. 'default' means upstream auto-balance."""
+    model = body.get("model", "MiniMax-H3")
+    spec = VIDEO_MODELS.get(model)
+    if spec is None:
+        raise HTTPException(400, "Unknown local video model; query /v1/models")
+    content = body.get("content") or []
+    if not isinstance(content, list):
+        raise HTTPException(400, "content must be an array")
+    prompt = "\n".join(str(c.get("text", "")) for c in content if c.get("type") == "text").strip()
+    if not prompt or len(prompt) > 7000:
+        raise HTTPException(400, "A prompt of 1-7000 characters is required")
+    images, roles = [], []
+    for item in content:
+        kind = item.get("type")
+        if kind == "text":
+            continue
+        if kind != "image_url" or item.get("role") == "last_frame":
+            raise HTTPException(400, "Local video supports first-frame/reference images; last frames, reference video and voice samples are unsupported")
+        raw = item.get("image_url") or {}
+        url = raw.get("url", "") if isinstance(raw, dict) else raw
+        if not isinstance(url, str) or not url.startswith("data:image/"):
+            raise HTTPException(400, "Local video requires inline image data; enable Huobao's local-image conversion")
+        images.append(url)
+        roles.append(item.get("role", "reference_image"))
+    if not spec["min_images"] <= len(images) <= spec["max_images"]:
+        raise HTTPException(400, f"{model} requires {spec['min_images']}-{spec['max_images']} images")
+    if "first_frame" in roles and len(images) != 1:
+        raise HTTPException(400, "Use either one fixed first frame or reference images; these modes cannot be combined")
+    mode = "text" if not images else "first" if roles == ["first_frame"] else "reference"
+    if mode not in spec:
+        raise HTTPException(400, f"{model} does not support {mode} mode; use reference images")
+    try:
+        duration = float(body.get("duration", 5))
+    except (ValueError, TypeError):
+        raise HTTPException(400, "Invalid duration")
+    if not math.isfinite(duration) or not 4 <= duration <= 15:
+        raise HTTPException(400, "Duration must be 4-15 seconds")
+    ratio = body.get("ratio", "16:9")
+    if ratio not in {"16:9", "9:16", "1:1", "4:3", "3:4", "21:9"}:
+        raise HTTPException(400, "Unsupported aspect ratio")
+    resolution = str(body.get("resolution", "768P")).upper()
+    resolutions = {"480P": 480, "720P": 720, "1080P": 1080, "768P": 768, "2K": 1152}
+    if model == "MiniMax-H3-VDN-H3":
+        if ratio not in {"16:9", "9:16"}:
+            raise HTTPException(400, "VDN HD supports 16:9 or 9:16")
+        resolutions = {"2K": 1440, "4K": 2160}
+    if resolution not in resolutions:
+        raise HTTPException(400, "Unsupported video resolution")
+    short = resolutions[resolution]
+    a, b = map(int, ratio.split(":"))
+    if roles == ["first_frame"] and "ratio" not in body:
+        a, b = image_dimensions(images[0])
+        if a <= 0 or b <= 0:
+            raise HTTPException(400, "Invalid first-frame dimensions")
+    width = round(short * max(1, a / b) / 64) * 64
+    height = round(short * max(1, b / a) / 64) * 64
+    if model == "MiniMax-H3-VDN-H3":
+        width, height = (short * 16 // 9, short) if a > b else (short, short * 16 // 9)
+    workflow = spec[mode]
+    request = {**gpu_routing(body), "workflow_key": workflow, "prompt": prompt,
+            "input_images": images, "duration": duration, "width": width, "height": height,
+            "metadata": {"source": "huobao-drama", "model": model}}
+    if body.get("seed") is not None:
+        if not isinstance(body["seed"], int) or not 0 <= body["seed"] < 2**63:
+            raise HTTPException(400, "Invalid seed")
+        request["seed"] = body["seed"]
+    return request
+
+
+def qwen_image_request(body, images=None):
+    if body.get("model") != "qwen_image_2_1":
+        raise HTTPException(400, "Use model qwen_image_2_1")
+    prompt = body.get("prompt")
+    if not isinstance(prompt, str) or not prompt.strip() or len(prompt) > 32000:
+        raise HTTPException(400, "A prompt of 1-32000 characters is required")
+    if str(body.get("n", 1)) != "1":
+        raise HTTPException(400, "This image adapter supports n=1 per task")
+    if body.get("response_format", "url") != "url":
+        raise HTTPException(400, "Asynchronous image tasks require response_format=url")
+    size = str(body.get("size", "1024x1024")).lower()
+    if size == "auto":
+        size = "1024x1024"
+    match = re.fullmatch(r"(\d{3,4})x(\d{3,4})", size)
+    if not match or not all(256 <= int(d) <= 4096 for d in match.groups()):
+        raise HTTPException(400, "size must be WIDTHxHEIGHT with dimensions 256-4096")
+    width, height = map(int, match.groups())
+    refs = images or []
+    if len(refs) > 6:
+        raise HTTPException(400, "Qwen Image 2.1 supports at most 6 reference images")
+    return {**gpu_routing(body), "workflow_key": "qwen_image_2_1", "prompt": prompt.strip(),
+            "width": width, "height": height, "batch_size": 1, "input_images": refs,
+            "metadata": {"source": "huobao-drama", "output_type": "image"}}
+
+
+async def parse_image_edit(request):
+    content_type = request.headers.get("content-type", "")
+    if not content_type.lower().startswith("multipart/form-data;"):
+        raise HTTPException(415, "Image edits require multipart/form-data")
+    raw = bytearray()
+    async for chunk in request.stream():
+        raw.extend(chunk)
+        if len(raw) > 64 * 1024 * 1024:
+            raise HTTPException(413, "Reference uploads exceed 64 MiB")
+    message = BytesParser(policy=policy.default).parsebytes(
+        ("Content-Type: " + content_type + "\r\nMIME-Version: 1.0\r\n\r\n").encode() + raw)
+    if not message.is_multipart() or message.defects:
+        raise HTTPException(400, "Invalid multipart image request")
+    fields, images = {}, []
+    for part in message.iter_parts():
+        name = part.get_param("name", header="content-disposition")
+        data = part.get_payload(decode=True)
+        if not isinstance(data, bytes):
+            raise HTTPException(400, "Invalid multipart field")
+        if name in {"image", "image[]"}:
+            mime = part.get_content_type()
+            if mime not in {"image/png", "image/jpeg", "image/webp"} or not data or len(data) > 10 * 1024 * 1024:
+                raise HTTPException(400, "Each reference must be PNG, JPEG or WebP, up to 10 MiB")
+            url = "data:" + mime + ";base64," + base64.b64encode(data).decode()
+            width, height = image_dimensions(url)
+            if not (0 < width <= 16384 and 0 < height <= 16384):
+                raise HTTPException(400, "Invalid reference image dimensions")
+            images.append(url)
+            if len(images) > 6:
+                raise HTTPException(400, "Qwen Image 2.1 supports at most 6 reference images")
+        elif name in {"model", "prompt", "size", "n", "response_format", "gpu"}:
+            if name in fields or len(data) > 128000:
+                raise HTTPException(400, "Duplicate or oversized form field")
+            try:
+                fields[name] = data.decode("utf-8")
+            except UnicodeDecodeError:
+                raise HTTPException(400, "Form text must be UTF-8")
+        else:
+            raise HTTPException(400, "Unsupported image edit field: " + str(name)[:60])
+    if not images:
+        raise HTTPException(400, "At least one reference image is required")
+    return qwen_image_request(fields, images)
+
+
+def create_app(config):
+    app = FastAPI(title="Huobao private model bridge", docs_url=None, redoc_url=None)
+    state_dir = Path(config.get("state_dir", "./state"))
+    state_dir.mkdir(parents=True, exist_ok=True)
+    db_path = state_dir / "jobs.sqlite3"
+    with closing(sqlite3.connect(db_path)) as db, db:
+        db.execute("CREATE TABLE IF NOT EXISTS jobs (id TEXT PRIMARY KEY, duration REAL NOT NULL, created REAL NOT NULL)")
+        db.execute("CREATE TABLE IF NOT EXISTS image_jobs (id TEXT PRIMARY KEY, created REAL NOT NULL)")
+
+    def auth(authorization: str | None = Header(default=None)):
+        expected = config.get("token", "")
+        if not expected or not secrets.compare_digest(authorization or "", "Bearer " + expected):
+            raise HTTPException(401, "Invalid bridge token")
+
+    @app.exception_handler(HTTPException)
+    async def http_error(request, exc):
+        return JSONResponse({"error": {"message": str(exc.detail), "type": "bridge_error", "code": exc.status_code}}, status_code=exc.status_code)
+
+    @app.exception_handler(httpx.HTTPError)
+    async def upstream_error(request, exc):
+        return JSONResponse({"error": {"message": "Upstream connection failed: " + type(exc).__name__, "type": "upstream_error"}}, status_code=502)
+
+    def upstream_headers():
+        return {"Authorization": "Bearer " + config["h3"]["token"]}
+
+    async def upstream(method, path, body=None):
+        if not config.get("h3"):
+            raise HTTPException(404, "H3 is not configured on this bridge")
+        async with httpx.AsyncClient(timeout=httpx.Timeout(180, connect=10), trust_env=False) as client:
+            r = await client.request(method, config["h3"]["url"] + path, headers=upstream_headers(), json=body)
+        if r.is_error:
+            try:
+                detail = r.json().get("detail", "Model service request failed")
+            except ValueError:
+                detail = "Model service request failed"
+            raise HTTPException(r.status_code, str(detail)[:600])
+        return r.json()
+
+    @app.get("/health")
+    async def health():
+        return {"status": "ok", "service": "huobao-model-bridge"}
+
+    @app.get("/v1/models", dependencies=[Depends(auth)])
+    async def models():
+        names = list(config.get("dify", {}))
+        if config.get("h3"):
+            # Verify the real service, instead of making a local catalogue look healthy.
+            registry = await upstream("GET", "/v1/models")
+            available = {m["id"] for m in registry.get("data", [])}
+            names.extend(name for name, spec in VIDEO_MODELS.items() if video_workflows(spec) <= available)
+            if any(m.get("id") == "qwen_image_2_1" and m.get("model_type") == "image" for m in registry.get("data", [])):
+                names.append("qwen_image_2_1")
+        if config.get("grok"):
+            names.append("grok-local")
+        return {"object": "list", "data": [{"id": n, "object": "model", "owned_by": "private"} for n in names]}
+
+    async def dify_events(model, query):
+        upstream_config = config["dify"][model]
+        payload = {"inputs": {}, "query": query, "response_mode": "streaming",
+                   "user": "huobao-" + secrets.token_hex(8), "auto_generate_name": False}
+        finished, usage = False, {}
+        async with httpx.AsyncClient(timeout=httpx.Timeout(240, connect=10), trust_env=False) as client:
+            async with client.stream("POST", upstream_config["url"] + "/chat-messages",
+                                     headers={"Authorization": "Bearer " + upstream_config["key"]}, json=payload) as response:
+                if response.is_error:
+                    await response.aread()
+                    try:
+                        message = response.json().get("message", "Dify request failed")
+                    except ValueError:
+                        message = "Dify request failed"
+                    raise HTTPException(response.status_code, str(message)[:400])
+                async for line in response.aiter_lines():
+                    if not line.startswith("data:"):
+                        continue
+                    event = json.loads(line[5:].strip())
+                    kind = event.get("event")
+                    if kind in {"message", "agent_message"}:
+                        yield "text", event.get("answer", "")
+                    elif kind == "error":
+                        raise HTTPException(502, str(event.get("message", "Dify generation failed"))[:400])
+                    elif kind == "message_end":
+                        finished = True
+                        usage = event.get("metadata", {}).get("usage", {})
+                    elif kind == "workflow_finished":
+                        data = event.get("data") or {}
+                        if data.get("status") not in {None, "succeeded"}:
+                            raise HTTPException(502, str(data.get("error") or "Dify workflow failed")[:400])
+                if not finished:
+                    raise HTTPException(502, "Dify stream ended before message_end")
+        yield "usage", usage
+
+    async def grok_events(query):
+        item = config["grok"]
+        args = [item["exe"], "--cwd", item["cwd"], "--output-format", "json", "--verbatim",
+                "--no-subagents", "--no-memory", "--disable-web-search", "--max-turns", "1",
+                "--tools", "", "--deny", "MCPTool", "--permission-mode", "dontAsk",
+                "--system-prompt-override", "Answer the supplied writing request using text only. Do not use tools."]
+        options = {"creationflags": 0x08000000} if os.name == "nt" else {}
+        # A file avoids the Windows command-line length limit for full scripts.
+        with tempfile.TemporaryDirectory(prefix="huobao-grok-") as scratch:
+            prompt_file = Path(scratch) / "prompt.txt"
+            prompt_file.write_text(query, encoding="utf-8")
+            args += ["--prompt-file", str(prompt_file)]
+            process = await asyncio.create_subprocess_exec(*args, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.PIPE, **options)
+            try:
+                out, err = await asyncio.wait_for(process.communicate(), timeout=240)
+            except (asyncio.TimeoutError, asyncio.CancelledError):
+                process.kill()
+                await process.wait()
+                raise
+        try:
+            data = json.loads(out.decode("utf-8"))
+        except (ValueError, UnicodeDecodeError):
+            raise HTTPException(502, "Grok CLI did not return JSON; run Grok login on this computer")
+        if process.returncode or not data.get("text"):
+            raise HTTPException(502, "Grok CLI failed; check local login and available quota")
+        yield "text", data["text"]
+        yield "usage", data.get("usage", {})
+
+    @app.post("/v1/chat/completions", dependencies=[Depends(auth)])
+    async def chat(body: dict):
+        model = body.get("model", "")
+        if model not in config.get("dify", {}) and not (model == "grok-local" and config.get("grok")):
+            raise HTTPException(404, "Unknown text model")
+        query = chat_query(body)
+        events = grok_events(query) if model == "grok-local" else dify_events(model, query)
+        cid, created = "chatcmpl-" + secrets.token_hex(12), int(time.time())
+
+        def chunk(delta, finish=None):
+            return {"id": cid, "object": "chat.completion.chunk", "created": created, "model": model,
+                    "choices": [{"index": 0, "delta": delta, "finish_reason": finish}]}
+
+        if body.get("stream"):
+            async def stream():
+                def encode(value):
+                    return "data: " + json.dumps(value, ensure_ascii=False) + "\n\n"
+                yield encode(chunk({"role": "assistant", "content": ""}))
+                try:
+                    async for kind, value in events:
+                        if kind == "text":
+                            yield encode(chunk({"content": value}))
+                    yield encode(chunk({}, "stop"))
+                except (HTTPException, httpx.HTTPError) as error:
+                    message = str(error.detail) if isinstance(error, HTTPException) else "Upstream connection failed"
+                    yield encode({"error": {"message": message, "type": "upstream_error"}})
+                yield "data: [DONE]\n\n"
+            return StreamingResponse(stream(), media_type="text/event-stream", headers={"Cache-Control": "no-cache"})
+        text, usage = "", {}
+        async for kind, value in events:
+            if kind == "text":
+                text += value
+            else:
+                usage = value
+        return {"id": cid, "object": "chat.completion", "created": created, "model": model,
+                "choices": [{"index": 0, "message": {"role": "assistant", "content": text}, "finish_reason": "stop"}],
+                "usage": {"prompt_tokens": usage.get("prompt_tokens", usage.get("input_tokens", 0)),
+                          "completion_tokens": usage.get("completion_tokens", usage.get("output_tokens", 0)),
+                          "total_tokens": usage.get("total_tokens", 0)}}
+
+    async def require_qwen_image():
+        registry = await upstream("GET", "/v1/models")
+        if not any(m.get("id") == "qwen_image_2_1" and m.get("model_type") == "image" for m in registry.get("data", [])):
+            raise HTTPException(503, "Qwen Image 2.1 workflow is unavailable")
+
+    @app.get("/v1/images/pool", dependencies=[Depends(auth)])
+    async def image_pool():
+        await require_qwen_image()
+        health, catalogue = await asyncio.gather(upstream("GET", "/health"), upstream("GET", "/v1/providers"))
+        return {"model": "qwen_image_2_1", "auto_balance": health.get("autoBalance") is True,
+                "routing": "shortest-queue-with-reservations" if health.get("autoBalance") is True else "single-provider",
+                "configured_workers": [{"id": p["id"], "name": p.get("name", p["id"])} for p in catalogue.get("providers", [])]}
+
+    async def submit_image(payload):
+        await require_qwen_image()
+        result = await upstream("POST", "/v1/jobs", payload)
+        jid = result.get("id")
+        if not isinstance(jid, str) or not jid:
+            raise HTTPException(502, "Image service did not return a task ID")
+        with closing(sqlite3.connect(db_path)) as db, db:
+            db.execute("INSERT INTO image_jobs VALUES(?,?)", (jid, time.time()))
+        return {"task_id": jid, "status": "processing", "provider_id": result.get("providerId")}
+
+    @app.post("/v1/images/validate", dependencies=[Depends(auth)])
+    async def validate_image(body: dict):
+        payload = qwen_image_request(body)
+        await require_qwen_image()
+        return {"valid": True, "workflow": payload["workflow_key"], "requested_size": [payload["width"], payload["height"]], "max_reference_images": 6,
+                "pool": await image_pool()}
+
+    @app.post("/v1/images/generations", dependencies=[Depends(auth)])
+    async def generate_image(body: dict):
+        return await submit_image(qwen_image_request(body))
+
+    @app.post("/v1/images/edits", dependencies=[Depends(auth)])
+    async def edit_image(request: Request):
+        return await submit_image(await parse_image_edit(request))
+
+    @app.get("/v1/images/task/{jid}", dependencies=[Depends(auth)])
+    async def poll_image(jid: str):
+        with closing(sqlite3.connect(db_path)) as db:
+            found = db.execute("SELECT 1 FROM image_jobs WHERE id=?", (jid,)).fetchone()
+        if not found:
+            raise HTTPException(404, "Unknown image task")
+        result = await upstream("GET", "/v1/jobs/" + quote(jid, safe=""))
+        state = result.get("status", "running")
+        if state in {"failed", "cancelled"}:
+            return {"status": "failed", "error": {"message": str(result.get("error") or "Image generation failed")[:600]}}
+        if state != "succeeded":
+            return {"status": "processing", "provider_id": result.get("providerId")}
+        output = next((o for o in result.get("outputs", []) if o.get("kind") == "image"), None)
+        if output is None:
+            return {"status": "failed", "error": {"message": "Task completed without an image output"}}
+        index, expiry = int(output["index"]), int(time.time()) + 86400
+        extension = {"image/png": "png", "image/jpeg": "jpg", "image/webp": "webp"}.get(output.get("mimeType"), "png")
+        # Huobao determines the saved extension from the URL, not Content-Type.
+        url = f"{config['public_url']}/media/{quote(jid, safe='')}/{index}/image.{extension}?expires={expiry}&sig={signature(jid, index, expiry)}"
+        return {"status": "completed", "image_url": url, "data": [{"url": url}], "provider_id": result.get("providerId")}
+
+    @app.post("/v2/video_generation/validate", dependencies=[Depends(auth)])
+    async def validate_video(body: dict):
+        request = h3_request(body)
+        registry = await upstream("GET", "/v1/models")
+        if request["workflow_key"] not in {m["id"] for m in registry.get("data", [])}:
+            raise HTTPException(503, "Selected video workflow is unavailable")
+        plan = await upstream("POST", "/v1/audio-plan", request)
+        return {"valid": plan.get("status", "ready") == "ready", "workflow": request["workflow_key"],
+                "width": request["width"], "height": request["height"], "duration": request["duration"], "audio_plan": plan,
+                "routing": "upstream-auto-balance"}
+
+    @app.post("/v2/video_generation", dependencies=[Depends(auth)])
+    async def video(body: dict):
+        # Huobao probes video providers with an empty body. Check the real
+        # upstream without submitting a GPU task, then report readiness.
+        if not body:
+            registry = await upstream("GET", "/v1/models")
+            available = {m["id"] for m in registry.get("data", [])}
+            if not {"minimax_h3_t2v_official", "minimax_h3_i2v", "minimax_h3_r2v"} <= available:
+                raise HTTPException(503, "Required H3 workflows are unavailable")
+            return {"status": "ready", "probe": True, "model": "MiniMax-H3"}
+        request = h3_request(body)
+        registry = await upstream("GET", "/v1/models")
+        if request["workflow_key"] not in {m["id"] for m in registry.get("data", [])}:
+            raise HTTPException(503, "Selected video workflow is unavailable")
+        result = await upstream("POST", "/v1/jobs", request)
+        jid = result.get("id")
+        if not isinstance(jid, str) or not jid:
+            raise HTTPException(502, "Video service did not return a job ID")
+        with closing(sqlite3.connect(db_path)) as db, db:
+            db.execute("INSERT INTO jobs VALUES(?,?,?)", (jid, request["duration"], time.time()))
+        return {"task_id": jid, "status": "submitted", "provider_id": result.get("providerId")}
+
+    def get_job(jid):
+        with closing(sqlite3.connect(db_path)) as db:
+            row = db.execute("SELECT duration FROM jobs WHERE id=?", (jid,)).fetchone()
+        if not row:
+            raise HTTPException(404, "Unknown bridge job")
+        return row[0]
+
+    def signature(jid, index, expiry):
+        data = f"{jid}:{index}:{expiry}".encode()
+        return hmac.new(config["token"].encode(), data, hashlib.sha256).hexdigest()
+
+    @app.get("/v2/query/video_generation/{jid}", dependencies=[Depends(auth)])
+    async def poll(jid: str):
+        duration = get_job(jid)
+        result = await upstream("GET", "/v1/jobs/" + quote(jid, safe=""))
+        state = result.get("status", "running")
+        task = {"id": jid, "status": state, "duration": duration, "provider_id": result.get("providerId")}
+        if state == "succeeded":
+            output = next((o for o in result.get("outputs", []) if o.get("kind") == "video"), None)
+            if not output:
+                task.update(status="failed", error="Video task completed without a video output")
+            else:
+                index, expiry = int(output["index"]), int(time.time()) + 86400
+                url = f"{config['public_url']}/media/{quote(jid, safe='')}/{index}/video.mp4?expires={expiry}&sig={signature(jid, index, expiry)}"
+                task["content"] = {"url": url}
+        elif state in {"failed", "cancelled"}:
+            task["error"] = str(result.get("error") or "Video task failed")[:600]
+        return {"task": task}
+
+    @app.get("/media/{jid}/{index}")
+    @app.get("/media/{jid}/{index}/{filename}")
+    async def media(jid: str, index: int, expires: int, sig: str, filename: str | None = None):
+        if filename is not None and not re.fullmatch(r"image\.(png|jpg|webp)|video\.mp4", filename):
+            raise HTTPException(404, "Unknown media filename")
+        with closing(sqlite3.connect(db_path)) as db:
+            found = db.execute("SELECT 1 FROM jobs WHERE id=? UNION ALL SELECT 1 FROM image_jobs WHERE id=?", (jid, jid)).fetchone()
+        if not found:
+            raise HTTPException(404, "Unknown bridge task")
+        if expires < time.time() or not hmac.compare_digest(sig, signature(jid, index, expires)):
+            raise HTTPException(403, "Invalid or expired media link; poll the task again")
+        client = httpx.AsyncClient(timeout=httpx.Timeout(180, connect=10), trust_env=False)
+        url = config["h3"]["url"] + f"/v1/jobs/{quote(jid, safe='')}/outputs/{index}"
+        try:
+            response = await client.send(client.build_request("GET", url, headers=upstream_headers()), stream=True)
+            if response.is_error:
+                await response.aclose()
+                await client.aclose()
+                raise HTTPException(response.status_code, "Model output is not available")
+        except BaseException:
+            await client.aclose()
+            raise
+        async def download():
+            try:
+                async for part in response.aiter_bytes():
+                    yield part
+            finally:
+                await response.aclose()
+                await client.aclose()
+        return StreamingResponse(download(), media_type=response.headers.get("content-type", "video/mp4"))
+
+    return app
+
+
+def create_from_file():
+    path = Path(os.environ.get("HUOBAO_BRIDGE_CONFIG", "/bridge/config.json"))
+    return create_app(json.loads(path.read_text(encoding="utf-8")))
diff --git a/integration-work/browser-test/probe.cjs b/integration-work/browser-test/probe.cjs
new file mode 100644
index 0000000..f4e7b2b
--- /dev/null
+++ b/integration-work/browser-test/probe.cjs
@@ -0,0 +1,14 @@
+const {chromium}=require('playwright-core');
+(async()=>{
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ const page=await browser.newPage({viewport:{width:1440,height:1000}});
+ const errors=[];page.on('pageerror',e=>errors.push(e.message));
+ await page.goto('http://127.0.0.1:18879/',{waitUntil:'networkidle'});
+ await page.getByText('高清功能验证（隔离测试）',{exact:true}).click();
+ await page.waitForTimeout(800);
+ console.log('URL',page.url());
+ console.log('links',await page.locator('a').evaluateAll(es=>es.map(e=>({text:e.innerText,href:e.getAttribute('href')}))));
+ console.log('buttons',await page.locator('button').allTextContents());
+ console.log('errors',errors);
+ await browser.close();
+})().catch(e=>{console.error(e.message);process.exit(1)});
diff --git a/integration-work/browser-test/test_asset_references_ui.cjs b/integration-work/browser-test/test_asset_references_ui.cjs
new file mode 100644
index 0000000..9b8122d
--- /dev/null
+++ b/integration-work/browser-test/test_asset_references_ui.cjs
@@ -0,0 +1,45 @@
+const {chromium}=require('playwright-core'),fs=require('node:fs'),assert=require('node:assert/strict');
+const root='D:/web/dj/integration-work/',base='http://127.0.0.1:18886';
+(async()=>{
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try{
+  const page=await browser.newPage({viewport:{width:1550,height:1050}}),errors=[];
+  page.on('pageerror',e=>errors.push(e.message));
+  // UI checks must never generate media or change application defaults.
+  await page.route('**/api/**',async route=>{
+   const r=route.request();if(!['GET','HEAD'].includes(r.method())&&!new URL(r.url()).pathname.endsWith('/reference-images'))return route.abort();
+   if(r.method()==='POST')await new Promise(resolve=>setTimeout(resolve,500));
+   return route.continue();
+  });
+  async function open(){await page.goto(base+'/drama/6/episode/1',{waitUntil:'networkidle'});await page.getByRole('navigation').getByRole('button',{name:/^资产制作/}).click();}
+  await open();
+  const refs=page.locator('[data-reference-asset="character:26"]').first();
+  await refs.locator('.reference-image').nth(1).waitFor();
+  assert.equal(await refs.locator('.reference-image').count(),2);
+  assert.equal(await page.locator('[data-reference-asset="character:27"] .reference-image').count(),1);
+  assert.equal(await page.locator('[data-reference-asset="scene:22"] .reference-image').count(),2);
+  assert.equal(await page.locator('[data-reference-asset="prop:1"] .reference-image').count(),2);
+  const card=page.locator('.character-asset-card').filter({has:refs});
+  const original=await card.locator('.character-portrait img').getAttribute('src');
+  await refs.locator('input[type=file]').setInputFiles([root+'hd-test-references/blue.png',root+'hd-test-references/green.png']);
+  assert.equal(await refs.getByRole('button',{name:'保存中'}).isDisabled(),true);
+  await refs.locator('.reference-image').nth(3).waitFor();
+  await refs.getByRole('button',{name:'添加参考图'}).waitFor();
+  await open();assert.equal(await refs.locator('.reference-image').count(),4);
+  await refs.getByRole('button',{name:'预览参考图 1',exact:true}).click();
+  await page.locator('.image-viewer-overlay').waitFor();
+  await page.keyboard.press('Escape');
+  await page.locator('.image-viewer-overlay').waitFor({state:'hidden'});
+  for(const n of [4,3]){
+   await refs.getByRole('button',{name:'移除参考图 '+n,exact:true}).click();
+   await page.waitForFunction(({n})=>document.querySelectorAll('[data-reference-asset="character:26"] .reference-image').length===n-1,{n});
+  }
+  await open();assert.equal(await refs.locator('.reference-image').count(),2);
+  assert.equal(await card.locator('.character-portrait img').getAttribute('src'),original);
+  assert.equal(await page.locator('[data-reference-asset="character:27"] .reference-image').count(),1);
+  await refs.scrollIntoViewIfNeeded();
+  await page.screenshot({path:root+'asset-reference-ui.png'});
+  assert.deepEqual(errors,[]);
+  console.log('PASS: all asset types, multiple uploads, busy lock, reload persistence, preview, removal and asset isolation');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/test_gpu_regenerate_ui.cjs b/integration-work/browser-test/test_gpu_regenerate_ui.cjs
new file mode 100644
index 0000000..1434366
--- /dev/null
+++ b/integration-work/browser-test/test_gpu_regenerate_ui.cjs
@@ -0,0 +1,56 @@
+const {chromium}=require('playwright-core');
+const assert=require('node:assert/strict'),fs=require('node:fs');
+const root='D:/web/dj/integration-work/',base='http://127.0.0.1:18883';
+const fixture=JSON.parse(fs.readFileSync(root+'hd-test-regenerate/ui-fixture.json'));
+(async()=>{
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try{
+  const page=await browser.newPage({viewport:{width:1600,height:1100}}),errors=[];
+  page.on('pageerror',e=>errors.push(e.message));
+  await page.goto(base+'/drama/1/episode/1',{waitUntil:'networkidle'});
+  await page.getByRole('navigation').getByRole('button',{name:/^视频制作/}).click();
+  const selector=page.getByLabel('本次生成显卡',{exact:true});
+  await selector.waitFor();
+  assert.deepEqual(await selector.locator('option').evaluateAll(es=>es.map(e=>e.value)),['','auto','gpu1','gpu2','gpu3']);
+  const pick=page.locator('.model-select').filter({has:page.locator('.model-select-label',{hasText:/^视频$/})});
+  await pick.locator('button').click();
+  const modelLabel=gpu=>new RegExp('^'+gpu+' · (?:ComfyUI 8188(?:（容器内）)? · )?MiniMax-H3$');
+  for(const gpu of ['GPU1','GPU2','GPU3'])await page.getByText(modelLabel(gpu)).last().waitFor();
+  await page.getByText(modelLabel('GPU2')).last().click();
+  assert.match(await selector.locator('option').first().innerText(),/GPU2/);
+  await selector.selectOption('gpu3');
+  const button=page.getByRole('button',{name:'取消并换卡重新生成',exact:true});
+  assert.ok(await button.isEnabled());
+  await page.screenshot({path:root+'gpu-regenerate-video-ui.png'});
+  let payload;
+  await page.route('**/api/v1/tasks',route=>{
+   if(route.request().method()!=='POST')return route.continue();
+   payload=route.request().postDataJSON();
+   return route.fulfill({status:400,contentType:'application/json',body:JSON.stringify({message:'隔离界面测试：未提交实际生成'})});
+  });
+  await button.click(); await page.waitForFunction(()=>!document.querySelector('.video-inspector-action')?.disabled);
+  assert.equal(payload.gpu,'gpu3'); assert.equal(payload.replace_task_id,fixture.task);
+  assert.equal(payload.force_new,true); assert.ok(payload.config_id>10); assert.equal(payload.model,'MiniMax-H3');
+  await page.getByRole('navigation').getByRole('button',{name:/^高清制作/}).click();
+  const hd=page.getByLabel('高清模型',{exact:true}); await hd.waitFor();
+  assert.equal(await hd.locator('option').count(),4);
+  const option=await hd.locator('option').filter({hasText:'GPU1'}).getAttribute('value');
+  await hd.selectOption(option);
+  const hdGpu=page.getByLabel('高清生成显卡',{exact:true});
+  await hdGpu.selectOption('gpu3');
+  await page.locator('.hd-studio').getByRole('button',{name:'刷新',exact:true}).click();
+  assert.equal(await hdGpu.inputValue(),'gpu3');
+  await page.getByLabel('目标分辨率').selectOption('4K');
+  let hdBody;
+  await page.route('**/api/v1/hd/storyboards/1',route=>{
+   hdBody=route.request().postDataJSON(); return route.fulfill({status:400,contentType:'application/json',body:JSON.stringify({message:'隔离界面测试：未提交实际生成'})});
+  });
+  await page.screenshot({path:root+'gpu-regenerate-hd-ui.png'});
+  await page.getByRole('button',{name:'取消并换卡重新生成 4K',exact:true}).click();
+  await page.getByRole('alert').filter({hasText:'隔离界面测试'}).waitFor();
+  assert.equal(hdBody.gpu,'gpu3'); assert.equal(hdBody.replace_task_id,fixture.task);assert.equal(hdBody.config_id,Number(option));
+  assert.deepEqual(errors,[]);
+  fs.writeFileSync(root+'gpu-regenerate-ui-result.json',JSON.stringify({passed:true,checks:['all three fixed models visible','ordinary GPU override','exact task replacement payload','HD model and GPU selection','selection survives refresh'],errors},null,2));
+  console.log('PASS: fixed GPU models, video/HD selectors and targeted regeneration controls; no page errors');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/test_gpu_settings.cjs b/integration-work/browser-test/test_gpu_settings.cjs
new file mode 100644
index 0000000..6a900a4
--- /dev/null
+++ b/integration-work/browser-test/test_gpu_settings.cjs
@@ -0,0 +1,37 @@
+const {chromium}=require('playwright-core');
+const assert=require('node:assert/strict'),fs=require('node:fs');
+const base='http://127.0.0.1:18882/api/v1';
+async function api(path,body){const r=await fetch(base+path,{method:body?'PUT':'GET',headers:{'Content-Type':'application/json'},body:body?JSON.stringify(body):undefined});const data=await r.json();return {status:r.status,data:data.data};}
+(async()=>{
+ const baseline=(await api('/ai-configs')).data;
+ const image=baseline.find(c=>c.id===6),video=baseline.find(c=>c.id===4),hd=baseline.find(c=>c.id===10);
+ assert.ok(image&&video&&hd);
+ for(const [id,gpu] of [[6,'gpu1'],[4,'gpu2'],[10,'gpu3']])assert.equal((await api('/ai-configs/'+id,{gpu})).status,200);
+ assert.equal((await api('/ai-configs/6',{gpu:'gpu0'})).status,400);
+ assert.equal((await api('/ai-configs/6')).data.gpu,'gpu1');
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try{
+  const page=await browser.newPage({viewport:{width:1440,height:1000}});const errors=[];page.on('pageerror',e=>errors.push(e.message));
+  await page.goto('http://127.0.0.1:18882/settings',{waitUntil:'networkidle'});
+  const row=page.locator('.config-row').filter({hasText:'Qwen Image 2.1'});
+  await row.locator('button.btn-icon').first().click();
+  const select=page.getByLabel('使用显卡',{exact:true});
+  assert.deepEqual(await select.locator('option').evaluateAll(es=>es.map(e=>e.value)),['auto','gpu1','gpu2','gpu3']);
+  assert.equal(await select.inputValue(),'gpu1');await select.selectOption('gpu3');
+  await page.locator('form.config-dialog button[type=submit]').click();await page.locator('form.config-dialog').waitFor({state:'hidden'});
+  assert.equal((await api('/ai-configs/6')).data.gpu,'gpu3');
+  assert.equal((await api('/ai-configs/4')).data.gpu,'gpu2');
+  assert.equal((await api('/ai-configs/10')).data.gpu,'gpu3');
+  await page.reload({waitUntil:'networkidle'});await row.locator('button.btn-icon').first().click();
+  assert.equal(await select.inputValue(),'gpu3');
+  await page.waitForTimeout(400);
+  await page.screenshot({path:'D:/web/dj/integration-work/gpu-settings-verified.png'});
+  await select.selectOption('auto');await page.locator('form.config-dialog button[type=submit]').click();await page.locator('form.config-dialog').waitFor({state:'hidden'});
+  const after=(await api('/ai-configs/6')).data;
+  assert.equal(after.gpu,'auto');
+  for(const key of ['api_key','base_url','model','priority','is_active'])assert.deepEqual(after[key],image[key]);
+  assert.deepEqual(errors,[]);
+  fs.writeFileSync('D:/web/dj/integration-work/gpu-settings-ui-result.json',JSON.stringify({passed:true,checks:['three GPUs plus automatic','per-model independence','reload persistence','invalid GPU rejected','protected config fields unchanged'],errors},null,2));
+  console.log('PASS: GPU1/2/3 and automatic selection persist independently; model credentials unchanged; no UI errors');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/test_hd_ui.cjs b/integration-work/browser-test/test_hd_ui.cjs
new file mode 100644
index 0000000..af4d227
--- /dev/null
+++ b/integration-work/browser-test/test_hd_ui.cjs
@@ -0,0 +1,33 @@
+const {chromium}=require('playwright-core');
+const assert=require('node:assert/strict');
+const fs=require('node:fs');
+(async()=>{
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try {
+  const page=await browser.newPage({viewport:{width:1440,height:1000}});
+  const errors=[];page.on('pageerror',e=>errors.push(e.message));
+  await page.goto('http://127.0.0.1:18879/',{waitUntil:'networkidle'});
+  await page.getByText('高清功能验证（隔离测试）',{exact:true}).click();
+  await page.getByRole('button',{name:/进入制作/}).click();
+  await page.getByRole('navigation').getByRole('button',{name:/^高清制作/}).click();
+  await page.getByRole('heading',{name:'高清制作 MiniMax H3-VDN-H3'}).waitFor();
+  await page.getByText('原版',{exact:true}).waitFor();
+  const selector=page.getByLabel(/目标分辨率/);
+  await selector.selectOption('4K');
+  assert.equal(await selector.inputValue(),'4K');
+  await page.waitForFunction(()=>document.querySelectorAll('.hd-compare video').length===2 && [...document.querySelectorAll('.hd-compare video')].every(v=>v.videoWidth>0));
+  const videos=await page.locator('.hd-compare video').evaluateAll(es=>es.map(e=>({src:e.getAttribute('src'),width:e.videoWidth,height:e.videoHeight})));
+  assert.equal(videos[0].width,512);assert.equal(videos[0].height,288);
+  assert.equal(videos[1].width,3840);assert.equal(videos[1].height,2160);
+  assert.equal(await page.getByRole('button',{name:'生成 4K 高清版'}).isEnabled(),true);
+  const playback=await page.locator('.hd-compare video').nth(1).evaluate(async v=>{
+   v.muted=true;await v.play();await new Promise(r=>setTimeout(r,700));v.pause();
+   return {time:v.currentTime,error:v.error?.message||null};
+  });
+  assert.ok(playback.time>0);assert.equal(playback.error,null);
+  assert.deepEqual(errors,[]);
+  await page.screenshot({path:'D:/web/dj/integration-work/hd-page-verified.png',fullPage:true});
+  fs.writeFileSync('D:/web/dj/integration-work/hd-ui-result.json',JSON.stringify({passed:true,url:page.url(),videos,playback,errors},null,2));
+  console.log('PASS: HD navigation, 2K/4K selection, original + real 4K playback; no page errors');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/test_shot_routing_ui.cjs b/integration-work/browser-test/test_shot_routing_ui.cjs
new file mode 100644
index 0000000..b735997
--- /dev/null
+++ b/integration-work/browser-test/test_shot_routing_ui.cjs
@@ -0,0 +1,73 @@
+const {chromium}=require('playwright-core'),assert=require('node:assert/strict'),fs=require('node:fs');
+const root='D:/web/dj/integration-work/',base='http://127.0.0.1:18885';
+const fixture=JSON.parse(fs.readFileSync(root+'hd-test-panels/shot-ui-fixture.json'));
+(async()=>{
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try{
+  const page=await browser.newPage({viewport:{width:1700,height:1150}}),errors=[];
+  page.on('pageerror',e=>errors.push(e.message));
+  let submitted=null,replacement=null;
+  await page.route('**/api/v1/tasks**',async route=>{
+   const req=route.request(),u=new URL(req.url());
+   if(req.method()==='POST'&&u.pathname==='/api/v1/tasks'){
+    submitted=req.postDataJSON();
+    replacement={id:fixture.ids[1]+100,type:'video',storyboard_id:1,drama_id:1,provider:'minimax',model:submitted.model,config_id:submitted.config_id,
+      task_id:'ui-new-job',status:'processing',stage:'polling',created_at:new Date().toISOString(),params:JSON.stringify({gpu:submitted.gpu}),routing:{gpu:'gpu1',port:8189,legacy:false}};
+    return route.fulfill({status:201,contentType:'application/json',body:JSON.stringify({data:replacement})});
+   }
+   if(req.method()==='GET'&&replacement){
+    if(u.pathname==='/api/v1/tasks/'+replacement.id)return route.fulfill({json:{data:replacement}});
+    if(u.pathname==='/api/v1/tasks'){
+     const response=await route.fetch(),json=await response.json();
+     json.data=json.data.map(t=>t.id===fixture.ids[0]?{...t,status:'failed',error_code:'user_cancelled'}:t);
+     if(!u.searchParams.has('type')||u.searchParams.get('type')==='video')json.data.push(replacement);
+     return route.fulfill({response,json});
+    }
+   }
+   return route.continue();
+  });
+  await page.route('**/api/v1/episodes/1/generation-tasks',async route=>{
+    const response=await route.fetch(),json=await response.json();
+    if(replacement){json.data.tasks=json.data.tasks.map(t=>t.id===fixture.ids[0]?{...t,status:'failed',error_code:'user_cancelled'}:t);json.data.tasks.push(replacement)}
+    return route.fulfill({response,json});
+  });
+  await page.goto(base+'/drama/1/episode/1',{waitUntil:'networkidle'});
+  await page.getByRole('navigation').getByRole('button',{name:/^视频制作/}).click();
+  const rows=page.locator('.video-task-row'),gpu=page.getByLabel('本次生成显卡',{exact:true});
+  const actual=page.getByTestId('shot-actual-routing');
+  await actual.filter({hasText:'GPU2 · ComfyUI 8188'}).waitFor();
+  const top=page.locator('.studio-topbar .model-select').filter({has:page.locator('.model-select-label',{hasText:'视频默认'})});
+  const beforeDefault=await top.innerText();
+  const shotModel=page.locator('.video-inspector-footer .model-select');
+  await shotModel.locator('button').click();
+  await page.getByText('GPU1 · ComfyUI 8189 · MiniMax-H3',{exact:true}).last().click();
+  await gpu.selectOption('gpu1');
+  assert.equal(await top.innerText(),beforeDefault);
+  await rows.nth(1).click();
+  assert.equal(await gpu.inputValue(),'gpu3');
+  assert.match(await actual.innerText(),/GPU3 · ComfyUI 8191/);
+  await rows.first().click();assert.equal(await gpu.inputValue(),'gpu1');
+  // Before submission, the current-job badge still reports the old confirmed worker.
+  assert.match(await actual.innerText(),/GPU2 · ComfyUI 8188/);
+  await page.getByRole('button',{name:'取消并换卡重新生成',exact:true}).click();
+  await actual.filter({hasText:'GPU1 · ComfyUI 8189'}).waitFor();
+  assert.equal(submitted.storyboard_id,1);assert.equal(submitted.replace_task_id,fixture.ids[0]);assert.equal(submitted.gpu,'gpu1');assert.equal(submitted.config_id,11);
+  assert.match(await rows.nth(1).locator('.video-task-routing').innerText(),/GPU3 :8191/);
+  assert.match(await rows.first().locator('.video-task-state').innerText(),/生成中/);
+  await page.screenshot({path:root+'shot-specific-routing-ui.png'});
+  await page.reload({waitUntil:'networkidle'});
+  await page.getByRole('navigation').getByRole('button',{name:/^视频制作/}).click();
+  await actual.filter({hasText:'GPU1 · ComfyUI 8189'}).waitFor();
+  await page.getByRole('navigation').getByRole('button',{name:/^高清制作/}).click();
+  const hdGpu=page.getByLabel('高清生成显卡',{exact:true});await hdGpu.waitFor();
+  await hdGpu.selectOption('gpu1');await page.getByLabel('目标分辨率').selectOption('4K');
+  const shots=page.locator('.hd-shots button');await shots.nth(1).click();
+  assert.notEqual(await hdGpu.inputValue(),'gpu1');assert.equal(await page.getByLabel('目标分辨率').inputValue(),'2K');
+  await hdGpu.selectOption('gpu3');await shots.first().click();
+  assert.equal(await hdGpu.inputValue(),'gpu1');assert.equal(await page.getByLabel('目标分辨率').inputValue(),'4K');
+  await page.locator('.hd-studio').getByRole('button',{name:'刷新',exact:true}).click();assert.equal(await hdGpu.inputValue(),'gpu1');
+  assert.deepEqual(errors,[]);
+  fs.writeFileSync(root+'shot-routing-ui-result.json',JSON.stringify({passed:true,checks:['per-shot model and GPU choices','batch default unchanged','exact selected task replacement','confirmed routing appears only after submission','other shot unchanged','routing survives reload','HD settings scoped per shot'],errors},null,2));
+  console.log('PASS: individual shot model/GPU selection and actual worker badges, persistent task routing, independent HD choices');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/verify_asset_references_live.cjs b/integration-work/browser-test/verify_asset_references_live.cjs
new file mode 100644
index 0000000..e196653
--- /dev/null
+++ b/integration-work/browser-test/verify_asset_references_live.cjs
@@ -0,0 +1,26 @@
+const {chromium}=require('playwright-core'),fs=require('node:fs'),assert=require('node:assert/strict');
+(async()=>{
+ const base=JSON.parse(fs.readFileSync('D:/web/dj/huobao-data/last-launch.json')).api.replace('/api/v1','');
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try{
+  const page=await browser.newPage({viewport:{width:1550,height:1050}}),errors=[];
+  page.on('pageerror',e=>errors.push(e.message));
+  await page.route('**/api/**',r=>['GET','HEAD'].includes(r.request().method())?r.continue():r.abort());
+  await page.goto(base+'/drama/6/episode/1',{waitUntil:'networkidle'});
+  await page.getByRole('navigation').getByRole('button',{name:/^资产制作/}).click();
+  const refs=page.locator('.asset-references');await refs.first().waitFor();
+  assert.equal(await refs.count(),9);
+  assert.equal(await refs.locator('.reference-image').count(),0,'No test references may leak into live data');
+  const char=page.locator('.character-asset-card').first();
+  assert.equal(await char.getByRole('button',{name:'添加参考图',exact:true}).count(),1);
+  await char.locator('.character-name').click();
+  const dialog=page.locator('.asset-detail-dialog');await dialog.waitFor();
+  assert.equal(await dialog.getByRole('button',{name:'添加参考图',exact:true}).count(),1);
+  await page.keyboard.press('Escape');
+  await dialog.waitFor({state:'hidden'});
+  await refs.first().scrollIntoViewIfNeeded();
+  await page.screenshot({path:'D:/web/dj/integration-work/asset-references-installed.png'});
+  assert.deepEqual(errors,[]);
+  console.log('PASS: installed app has 9 independent reference controls, detail panel works, no test data or runtime errors');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/verify_gpu1_error_live.cjs b/integration-work/browser-test/verify_gpu1_error_live.cjs
new file mode 100644
index 0000000..cc3ff9a
--- /dev/null
+++ b/integration-work/browser-test/verify_gpu1_error_live.cjs
@@ -0,0 +1,20 @@
+const {chromium}=require('playwright-core');
+const fs=require('node:fs'),assert=require('node:assert/strict');
+(async()=>{
+ const base=JSON.parse(fs.readFileSync('D:/web/dj/huobao-data/last-launch.json')).api.replace('/api/v1','');
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try {
+  const page=await browser.newPage({viewport:{width:1500,height:1100}}),errors=[];
+  page.on('pageerror',e=>errors.push(e.message));
+  await page.route('**/api/**',route=>['GET','HEAD'].includes(route.request().method())?route.continue():route.abort());
+  await page.goto(base+'/drama/6/episode/1',{waitUntil:'networkidle'});
+  await page.locator('.task-drawer-trigger').click();
+  await page.locator('.task-drawer .gen-task-row').first().waitFor();
+  const hint=page.getByText('GPU1（ComfyUI 8189）暂不可用：旧节点任务或显存尚未释放。可改选 GPU2／GPU3，或稍后重试。',{exact:true});
+  await hint.first().waitFor({timeout:5000});assert.ok(await hint.count()>=12);
+  await hint.first().scrollIntoViewIfNeeded();
+  await page.screenshot({path:'D:/web/dj/integration-work/gpu1-error-ui-verified.png'});
+  assert.deepEqual(errors,[]);
+  console.log('PASS: installed task drawer shows specific GPU1 / ComfyUI 8189 error, no runtime errors, no writes permitted');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/verify_gpu_live.cjs b/integration-work/browser-test/verify_gpu_live.cjs
new file mode 100644
index 0000000..d0737c7
--- /dev/null
+++ b/integration-work/browser-test/verify_gpu_live.cjs
@@ -0,0 +1,22 @@
+const {chromium}=require('playwright-core');
+const assert=require('node:assert/strict'),fs=require('node:fs');
+(async()=>{
+ const base=JSON.parse(fs.readFileSync('D:/web/dj/huobao-data/last-launch.json')).api.replace('/api/v1','');
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try{
+  const page=await browser.newPage({viewport:{width:1500,height:1000}}),errors=[];
+  page.on('pageerror',e=>errors.push(e.message));
+  await page.goto(base+'/settings',{waitUntil:'networkidle'});
+  const rows=page.locator('.config-row');
+  assert.equal(await rows.count(),28);
+  assert.equal(await rows.filter({hasText:'ComfyUI'}).count(),24);
+  assert.equal(await rows.filter({hasText:/端口 1879[24]/}).count(),0);
+  for(const [gpu,port] of [['GPU1',8189],['GPU2',8188],['GPU3',8191]])assert.equal(await rows.filter({hasText:gpu+' · ComfyUI '+port}).count(),6);
+  assert.equal(await rows.filter({hasText:'容器内'}).count(),0);
+  for(const gpu of ['GPU1','GPU2','GPU3'])assert.equal(await rows.filter({hasText:new RegExp(' · '+gpu)}).count(),6);
+  await rows.filter({hasText:'MiniMax H3 · GPU1'}).scrollIntoViewIfNeeded();
+  await page.screenshot({path:'D:/web/dj/integration-work/gpu-live-model-configs.png'});
+  assert.deepEqual(errors,[]);
+  console.log('PASS: 24 ComfyUI labels with actual 8189/8188/8191 panel mapping; no UI errors');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/browser-test/verify_task_tracking_live.cjs b/integration-work/browser-test/verify_task_tracking_live.cjs
new file mode 100644
index 0000000..8a0102e
--- /dev/null
+++ b/integration-work/browser-test/verify_task_tracking_live.cjs
@@ -0,0 +1,21 @@
+const {chromium}=require('playwright-core'),fs=require('node:fs'),assert=require('node:assert/strict');
+(async()=>{
+ const base=JSON.parse(fs.readFileSync('D:/web/dj/huobao-data/last-launch.json')).api.replace('/api/v1','');
+ const browser=await chromium.launch({channel:'chrome',headless:true});
+ try{
+  const page=await browser.newPage({viewport:{width:1550,height:1050}}),errors=[];
+  page.on('pageerror',e=>errors.push(e.message));
+  await page.route('**/api/**',r=>['GET','HEAD'].includes(r.request().method())?r.continue():r.abort());
+  await page.goto(base+'/drama/5/episode/1',{waitUntil:'networkidle'});await page.locator('.task-drawer-trigger').click();
+  const row=id=>page.locator('.task-drawer .gen-task-row').filter({has:page.locator('.video-task-meta-line',{hasText:new RegExp('#'+id+'$')})});
+  await row(205).waitFor();assert.match(await row(205).innerText(),/已完成/);
+  assert.match(await row(203).innerText(),/待核对/);
+  assert.match(await row(203).innerText(),/显卡节点已找不到此任务/);
+  assert.equal(await row(174).getByRole('button',{name:'恢复视频',exact:true}).count(),0);
+  await row(205).scrollIntoViewIfNeeded();await page.screenshot({path:'D:/web/dj/integration-work/task-205-recovered.png'});
+  await page.goto(base+'/drama/6/episode/1',{waitUntil:'networkidle'});await page.locator('.task-drawer-trigger').click();
+  await page.locator('.task-drawer .video-task-status').filter({hasText:'排队中'}).first().waitFor();
+  assert.deepEqual(errors,[]);
+  console.log('PASS: #205 completed, missing node record clearly marked, queued tasks visible, cancelled task cannot recover, no writes or runtime errors');
+ }finally{await browser.close()}
+})().catch(e=>{console.error(e.stack);process.exit(1)});
diff --git a/integration-work/cancel_alignment_queue.py b/integration-work/cancel_alignment_queue.py
new file mode 100644
index 0000000..34e67de
--- /dev/null
+++ b/integration-work/cancel_alignment_queue.py
@@ -0,0 +1,14 @@
+import subprocess
+code='''import asyncio,httpx,json,app
+async def main():
+ p=app.providers()['default'];jid='1c6f7d58-5f0a-4f4d-997e-a844d8b0d507'
+ async with httpx.AsyncClient(timeout=20) as c:
+  q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+  assert not any(x[1]==jid for x in q.get('queue_running',[])), 'Do not interrupt running worker'
+  if any(x[1]==jid for x in q.get('queue_pending',[])):
+   r=await c.post(p.base_url+'/queue',headers=app.provider_headers(p),json={'delete':[jid]});r.raise_for_status()
+   print('Removed only isolated alignment-test job from pending queue')
+  else: print('Isolated alignment-test job not pending')
+asyncio.run(main())
+'''
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
diff --git a/integration-work/cancel_approved_eleven.py b/integration-work/cancel_approved_eleven.py
new file mode 100644
index 0000000..460efba
--- /dev/null
+++ b/integration-work/cancel_approved_eleven.py
@@ -0,0 +1,23 @@
+"""Only the 11 Huobao tasks explicitly approved by the user for cancellation."""
+import subprocess,json,pathlib
+ids=['8c75d5aa-d171-4591-8d4e-3ef3adc3c395','db146728-576c-443b-825a-cafef33125cf','11c9aa8c-eb8a-48d1-b7f5-4ced56201c3b','c391b659-bbde-49d0-9810-5d3010a10975','62ad95b4-90b4-4ac8-9707-8d82b43199f0','5dd36c20-80d0-456f-80a8-6fc63ac514c5','b31adacb-32b8-4ed0-b0cf-61913a1f314f','813fb420-aeed-4566-8649-35186ce2cefd','a5969921-5676-4fa3-9bfa-571d728b8501','8c7ab7aa-7a5b-41e7-af47-731f938e9ad7','2cbd3308-b9cc-4f75-9589-cea59ef3a45b']
+code='''import asyncio,httpx,json,app
+APPROVED=__IDS__
+async def main():
+ p=app.providers()['default'];headers=app.provider_headers(p)
+ async with httpx.AsyncClient(timeout=30) as c:
+  q=(await c.get(p.base_url+'/queue',headers=headers)).json()
+  pending=[x[1] for x in q.get('queue_pending',[]) if x[1] in APPROVED]
+  if pending:
+   r=await c.post(p.base_url+'/queue',headers=headers,json={'delete':pending});r.raise_for_status()
+  q=(await c.get(p.base_url+'/queue',headers=headers)).json()
+  running=[x[1] for x in q.get('queue_running',[])]
+  interrupted=[]
+  if running and all(x in APPROVED for x in running) and not q.get('queue_pending'):
+   r=await c.post(p.base_url+'/interrupt',headers=headers,json={});r.raise_for_status();interrupted=running
+  print(json.dumps({'removed_pending':pending,'interrupted':interrupted,'all_other_jobs_preserved':True}))
+asyncio.run(main())
+'''.replace('__IDS__',repr(set(ids)))
+out=subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True)
+pathlib.Path('/home/ps/huobao-gpu-selection/cancel-approved-eleven.json').write_text(out)
+print(out)
diff --git a/integration-work/check_4k_progress.py b/integration-work/check_4k_progress.py
new file mode 100644
index 0000000..5b8c94a
--- /dev/null
+++ b/integration-work/check_4k_progress.py
@@ -0,0 +1,15 @@
+import subprocess
+code="""import asyncio,httpx,json,app
+async def main():
+ p=app.providers()['default'];jid='270cbfd0-dda1-438f-8b49-a85dcd5e3558'
+ async with httpx.AsyncClient(timeout=20) as c:
+  h=(await c.get(p.base_url+'/history/'+jid,headers=app.provider_headers(p))).json().get(jid,{})
+  q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+  print(json.dumps({'history':h.get('status'), 'output_nodes':list(h.get('outputs',{})), 'running':any(x[1]==jid for x in q.get('queue_running',[])), 'queued':any(x[1]==jid for x in q.get('queue_pending',[]))}))
+asyncio.run(main())
+"""
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
+r=subprocess.run(['docker','logs','--tail','35','comfyui'],capture_output=True,text=True)
+text=r.stdout+r.stderr
+lines=[l for l in text.replace('\r','\n').splitlines() if any(word in l for word in ['SelfLift','%|','Exception','Error','VDN','Prompt executed','OOM'])]
+print('\n'.join(lines[-12:]))
diff --git a/integration-work/check_cleared_task_states.py b/integration-work/check_cleared_task_states.py
new file mode 100644
index 0000000..3093bbb
--- /dev/null
+++ b/integration-work/check_cleared_task_states.py
@@ -0,0 +1,23 @@
+import pathlib,json,subprocess,base64
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+rows=[r for r in json.loads((root/'production-task-ids.json').read_text()) if r[2]=='processing']
+lookup={}
+for tid,encoded,status in rows:
+ try:
+  value=encoded.removeprefix('h3v2.');provider,jid=base64.urlsafe_b64decode(value+'='*(-len(value)%4)).decode().split(':',1)
+  lookup[str(tid)]={'provider':provider,'id':jid,'encoded':encoded}
+ except Exception:pass
+code='''import asyncio,httpx,json,app
+LOOKUP=__LOOKUP__
+async def main():
+ async with httpx.AsyncClient(timeout=30) as c:
+  for provider in set(x['provider'] for x in LOOKUP.values()):
+   p=app.providers()[provider];h=(await c.get(p.base_url+'/history',headers=app.provider_headers(p))).json();q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+   ids={x[1] for key in ('queue_pending','queue_running') for x in q.get(key,[])}
+   for item in LOOKUP.values():
+    if item['provider']==provider:item.update(in_queue=item['id'] in ids,remote_status=(h.get(item['id'],{}).get('status') or {}).get('status_str'))
+ print(json.dumps(LOOKUP))
+asyncio.run(main())
+'''.replace('__LOOKUP__',repr(lookup))
+out=subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True)
+(root/'cleared-task-states.json').write_text(out);print(out)
diff --git a/integration-work/check_deleted_queue.py b/integration-work/check_deleted_queue.py
new file mode 100644
index 0000000..d8defbf
--- /dev/null
+++ b/integration-work/check_deleted_queue.py
@@ -0,0 +1,20 @@
+import sqlite3,json,subprocess,pathlib,base64
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+active={r[1] for r in json.loads((root/'production-task-ids.json').read_text()) if r[2]=='processing'}
+for loc in ('/home/ps/huobao-model-bridge/state/jobs.sqlite3','/home/ps/huobao-vdn/bridge-state/jobs.sqlite3'):
+ with sqlite3.connect(loc) as db:
+  print(loc,'tables',db.execute("select name,sql from sqlite_master where type='table'").fetchall())
+code='''import asyncio,httpx,json,app
+async def main():
+ async with httpx.AsyncClient(timeout=20) as c:
+  out={}
+  for p in app.providers().values():
+   q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+   out[p.id]={k:[x[1] for x in q.get(k,[])] for k in ('queue_running','queue_pending')}
+  print(json.dumps(out))
+asyncio.run(main())
+'''
+out=subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True)
+print('queues',out)
+print('active Huobao IDs',len(active))
+(root/'queue-before-deleted-cleanup.json').write_text(out)
diff --git a/integration-work/check_pinned_hd_progress.py b/integration-work/check_pinned_hd_progress.py
new file mode 100644
index 0000000..196c43a
--- /dev/null
+++ b/integration-work/check_pinned_hd_progress.py
@@ -0,0 +1,7 @@
+import subprocess
+for name in ('huobao-comfy-gpu1','h3-caption-gpu3-canary-8a5f'):
+ r=subprocess.run(['docker','logs','--tail','70',name],capture_output=True,text=True)
+ lines=(r.stdout+r.stderr).replace('\r','\n').splitlines()
+ selected=[l for l in lines if any(s in l for s in ('SelfLift timing','Prompt executed','Error','Exception','out of memory','%|'))]
+ print(name,'\n'+'\n'.join(selected[-9:]))
+print(subprocess.check_output(['nvidia-smi','--query-gpu=index,memory.used,utilization.gpu','--format=csv,noheader'],text=True))
diff --git a/integration-work/check_vdn.py b/integration-work/check_vdn.py
new file mode 100644
index 0000000..d103d32
--- /dev/null
+++ b/integration-work/check_vdn.py
@@ -0,0 +1,10 @@
+import subprocess,json,urllib.request
+from pathlib import Path
+def run(*a): return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+for n in ('huobao-vdn-normalizer','huobao-vdn-bridge'):
+    info=json.loads(run('docker','inspect',n))[0]
+    print(n,info['State']['Status'])
+    if info['State']['Status']!='running': print(run('docker','logs','--tail','16',n))
+cfg=json.loads(Path('/home/ps/huobao-vdn/bridge/config.json').read_text())
+req=urllib.request.Request('http://192.168.110.111:18794/v1/models',headers={'Authorization':'Bearer '+cfg['token']})
+print(urllib.request.urlopen(req,timeout=15).read().decode())
diff --git a/integration-work/check_vdn_workers.py b/integration-work/check_vdn_workers.py
new file mode 100644
index 0000000..141f820
--- /dev/null
+++ b/integration-work/check_vdn_workers.py
@@ -0,0 +1,14 @@
+import subprocess
+code='''import asyncio,httpx
+from app import providers,provider_headers,admission_ids
+async def main():
+ print('admitted',sorted(admission_ids(providers())))
+ async with httpx.AsyncClient(timeout=20) as c:
+  for p in providers().values():
+   for endpoint in ('/object_info/ApplyVDNH3','/object_info','/queue'):
+    r=await c.get(p.base_url+endpoint,headers=provider_headers(p))
+    d=r.json() if r.status_code==200 else {}
+    print(p.id,endpoint,r.status_code,('ApplyVDNH3' in d) if 'object' in endpoint else {k:len(d.get(k,[])) for k in ('queue_running','queue_pending')})
+asyncio.run(main())
+'''
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
diff --git a/integration-work/cleanup_deleted_huobao_jobs.py b/integration-work/cleanup_deleted_huobao_jobs.py
new file mode 100644
index 0000000..c6db86d
--- /dev/null
+++ b/integration-work/cleanup_deleted_huobao_jobs.py
@@ -0,0 +1,32 @@
+"""Cancel only the user's cleared Huobao jobs, identified by private bridge records."""
+import sqlite3,json,subprocess,pathlib,base64
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+known=set()
+for loc in ('/home/ps/huobao-model-bridge/state/jobs.sqlite3','/home/ps/huobao-vdn/bridge-state/jobs.sqlite3'):
+ with sqlite3.connect(loc) as db:
+  for table in ('jobs','image_jobs'):
+   for (encoded,) in db.execute('select id from '+table):
+    try:
+     raw=encoded.removeprefix('h3v2.');known.add(base64.urlsafe_b64decode(raw+'='*(-len(raw)%4)).decode().split(':',1)[1])
+    except Exception:pass
+code='''import asyncio,httpx,json,app
+KNOWN=__KNOWN__
+async def main():
+ async with httpx.AsyncClient(timeout=30) as c:
+  removed=[]
+  for p in app.providers().values():
+   headers=app.provider_headers(p)
+   q=(await c.get(p.base_url+'/queue',headers=headers)).json()
+   ids=[x[1] for x in q.get('queue_pending',[]) if x[1] in KNOWN]
+   if ids:
+    r=await c.post(p.base_url+'/queue',headers=headers,json={'delete':ids});r.raise_for_status();removed+=ids
+   q=(await c.get(p.base_url+'/queue',headers=headers)).json()
+   running=[x[1] for x in q.get('queue_running',[])]
+   if running and all(x in KNOWN for x in running):
+    r=await c.post(p.base_url+'/interrupt',headers=headers,json={});r.raise_for_status();removed+=running
+   print(json.dumps({'worker':p.id,'removed_pending':ids,'interrupted_running':[x for x in running if x in KNOWN],'unrelated_kept':[x for x in running if x not in KNOWN]}))
+  print('CANCELLED_IDS='+json.dumps(removed))
+asyncio.run(main())
+'''.replace('__KNOWN__',repr(known))
+out=subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True)
+print(out);(root/'cancelled-huobao-jobs.txt').write_text(out)
diff --git a/integration-work/connect_vdn_networks.py b/integration-work/connect_vdn_networks.py
new file mode 100644
index 0000000..0850647
--- /dev/null
+++ b/integration-work/connect_vdn_networks.py
@@ -0,0 +1,13 @@
+import json,subprocess
+def run(*a):return subprocess.check_output(a,text=True)
+old=json.loads(run('docker','inspect','canvas-h3-prompt-normalizer-healthy-20261026'))[0]
+new=json.loads(run('docker','inspect','huobao-vdn-normalizer'))[0]
+network='zq-platform-network'
+assert network in old['NetworkSettings']['Networks']
+for worker in ('comfyui','h3-caption-gpu3-canary-8a5f'):
+    info=json.loads(run('docker','inspect',worker))[0]
+    assert network in info['NetworkSettings']['Networks']
+if network not in new['NetworkSettings']['Networks']:
+    # Execute only after the user's pending, specific network approval arrives.
+    run('docker','network','connect',network,'huobao-vdn-normalizer')
+print('VDN adapter connected only to the approved worker network:',network)
diff --git a/integration-work/deploy_8189_huobao.py b/integration-work/deploy_8189_huobao.py
new file mode 100644
index 0000000..ef0391d
--- /dev/null
+++ b/integration-work/deploy_8189_huobao.py
@@ -0,0 +1,42 @@
+import pathlib,json,sys,hashlib,datetime,time,urllib.request
+sys.path.insert(0,'/home/ps/huobao-gpu-selection')
+from docker_worker_ops import api,inspect,write_json,set_env
+work=pathlib.Path('/home/ps/huobao-gpu-selection/panel-8189');name='comfyui-manju'
+before=json.loads((work/'before.json').read_text());current=inspect(name)
+assert current['Id']==before['Id'],'8189 changed since preparation'
+def get(path,token=None):
+ h={'X-H3-Canary-Token':token} if token else {}
+ with urllib.request.urlopen(urllib.request.Request('http://192.168.110.111:8189'+path,headers=h),timeout=4) as r:return json.load(r)
+q=get('/queue');assert not q['queue_running'] and not q['queue_pending'],'8189 is busy; no restart performed'
+history=get('/history');snapshot={'schema':1,'queue_empty':True,'source_container_id':before['Id'],'history':history}
+assert all(v.get('status',{}).get('status_str') in ('success','error') for v in history.values())
+(work/'history.json').write_text(json.dumps(snapshot));(work/'history.json').chmod(0o644)
+cfg=json.loads((work/'create.json').read_text());k='H3_HISTORY_SNAPSHOT_SHA256';v=hashlib.sha256((work/'history.json').read_bytes()).hexdigest()
+set_env(cfg,k,v);cfg['Cmd'].insert(cfg['Cmd'].index('/opt/conda/bin/python3'),k+'='+v)
+write_json(work/'create.json',cfg)
+q=get('/queue');assert not q['queue_running'] and not q['queue_pending'],'8189 received a new job; leaving it running'
+stamp=datetime.datetime.now().strftime('%Y%m%d-%H%M%S');old=name+'-before-huobao-'+stamp
+api('POST','/containers/'+name+'/stop?t=20');api('POST','/containers/'+name+'/rename?name='+old)
+created=False
+try:
+ api('POST','/containers/create?name='+name,cfg);created=True;api('POST','/containers/'+name+'/start')
+ token=(work/'control/canary.token').read_text()
+ for _ in range(35):
+  try:
+   info=get('/object_info',token)
+   if 'H3CaptionPipeline' in info:break
+  except Exception:pass
+  time.sleep(1)
+ else:raise RuntimeError('8189 did not become ready')
+ required=set(json.loads((work/'allowed_node_classes.json').read_text())['required_classes'])
+ assert required<=set(info),'A previously available class is missing'
+ restored=get('/history',token)
+ assert all(restored.get(k)==v for k,v in history.items()),'History verification failed'
+ (work/'control/control.json').write_text(json.dumps({'schema':1,'maintenance':False}))
+ write_json(work/'deployed.json',{'old_container':old,'new_id':inspect(name)['Id'],'history_count':len(history),'classes':len(info)})
+ print(json.dumps({'deployed':name,'port':8189,'history_preserved':len(history),'classes':len(info),'previous_container':old}))
+except Exception:
+ if created:
+  api('POST','/containers/'+name+'/stop?t=10');api('POST','/containers/'+name+'/rename?name='+name+'-failed-'+stamp)
+ api('POST','/containers/'+old+'/rename?name='+name);api('POST','/containers/'+name+'/start')
+ raise
diff --git a/integration-work/deploy_gpu1_idle_fix.py b/integration-work/deploy_gpu1_idle_fix.py
new file mode 100644
index 0000000..2da9e45
--- /dev/null
+++ b/integration-work/deploy_gpu1_idle_fix.py
@@ -0,0 +1,28 @@
+import pathlib,json,hashlib,subprocess,time
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+folder=pathlib.Path(json.loads((root/'idle-baseline-fix-current.json').read_text())['directory'])
+manifest=json.loads((folder/'manifest.json').read_text())
+# Verify every source before changing either live bind mount.
+for m in manifest.values():
+ assert hashlib.sha256(pathlib.Path(m['path']).read_bytes()).hexdigest()==m['before']
+ assert hashlib.sha256(pathlib.Path(m['candidate']).read_bytes()).hexdigest()==m['after']
+for short,m in manifest.items():
+ p=pathlib.Path(m['path']);p.write_bytes(pathlib.Path(m['candidate']).read_bytes())
+ try:
+  subprocess.run(['docker','restart','--timeout','60',m['name']],check=True,stdout=subprocess.DEVNULL)
+  code='''import asyncio,app,json
+async def main():
+ p=await app.select_provider('gpu1_8189',True,True)
+ print(json.dumps({'ready':True,'provider':p.id,'url':p.base_url}))
+asyncio.run(main())'''
+  for attempt in range(10):
+   r=subprocess.run(['docker','exec',m['name'],'python','-c',code],capture_output=True,text=True)
+   if r.returncode==0:break
+   time.sleep(1)
+  if r.returncode:raise RuntimeError(r.stderr[-1200:])
+  print(short,r.stdout.strip())
+ except Exception:
+  p.write_bytes((folder/(short+'.before.py')).read_bytes())
+  subprocess.run(['docker','restart','--timeout','60',m['name']],check=True,stdout=subprocess.DEVNULL)
+  raise
+print('BACKUP',str(folder))
diff --git a/integration-work/deploy_gpu_normalizers.py b/integration-work/deploy_gpu_normalizers.py
new file mode 100644
index 0000000..406a36a
--- /dev/null
+++ b/integration-work/deploy_gpu_normalizers.py
@@ -0,0 +1,22 @@
+import pathlib,json,sys,datetime
+sys.path.insert(0,'/home/ps/huobao-gpu-selection')
+from docker_worker_ops import api,inspect,clone,write_json
+root=pathlib.Path('/home/ps/huobao-gpu-selection');stamp=datetime.datetime.now().strftime('%Y%m%d-%H%M%S')
+for name in ('canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer'):
+ candidate=root/(name+'.candidate.py');compile(candidate.read_text(),str(candidate),'exec')
+ source=inspect(name)
+ if any(m['Source']==str(candidate) and m['Destination']=='/app/app.py' for m in source['Mounts']):
+  print('Already deployed:',name);continue
+ write_json(root/(name+'.before-routing.json'),source)
+ cfg=clone(source,name)
+ cfg['Labels'].update(source['Config'].get('Labels') or {})
+ # Keep existing credentials, immutable root and exact existing network membership.
+ for dest,src in [('/app/app.py',candidate),('/app/huobao-extra-providers.json',root/'extra-providers.json')]:
+  assert src.exists()
+  cfg['HostConfig']['Binds']=[b for b in cfg['HostConfig'].get('Binds',[]) if b.split(':')[1]!=dest]+[str(src)+':'+dest+':ro']
+ cfg['NetworkingConfig']={'EndpointsConfig':{network:{'Aliases':[a for a in (info.get('Aliases') or []) if a not in (source['Id'],source['Id'][:12])]} for network,info in source['NetworkSettings']['Networks'].items()}}
+ write_json(root/(name+'.create-routing.json'),cfg)
+ api('POST','/containers/'+name+'/stop?t=20');api('POST','/containers/'+name+'/rename?name='+name+'-before-gpu-routing-'+stamp)
+ created=api('POST','/containers/create?name='+name,cfg);api('POST','/containers/'+name+'/start')
+ print('Recreated routing service with exact original networks/security:',name,'user',cfg['User'],'readonly',cfg['HostConfig']['ReadonlyRootfs'])
+write_json(root/'routing-normalizers-deployed.json',{'at':stamp})
diff --git a/integration-work/deploy_gpu_routing.py b/integration-work/deploy_gpu_routing.py
new file mode 100644
index 0000000..5ae6cb0
--- /dev/null
+++ b/integration-work/deploy_gpu_routing.py
@@ -0,0 +1,12 @@
+import pathlib,json,subprocess,shutil,sqlite3,datetime,hashlib
+root=pathlib.Path('/home/ps/huobao-gpu-selection');state=json.loads((root/'state.json').read_text())
+stamp=datetime.datetime.now().strftime('%Y%m%d-%H%M%S')
+assert (root/'routing-normalizers-deployed.json').exists(),'Deploy verified normalizer candidates first'
+candidate=root/'bridge-gpu.candidate.py';compile(candidate.read_text(),str(candidate),'exec')
+for folder,name,statefolder in [('/home/ps/huobao-model-bridge','huobao-model-bridge','state'),('/home/ps/huobao-vdn/bridge','huobao-vdn-bridge','../bridge-state')]:
+ p=pathlib.Path(folder);backup=root/(name+'-backup-'+stamp);backup.mkdir(mode=0o700)
+ shutil.copy2(p/'bridge.py',backup/'bridge.py');shutil.copy2(p/'config.json',backup/'config.json')
+ with sqlite3.connect(p/statefolder/'jobs.sqlite3') as src,sqlite3.connect(backup/'jobs.sqlite3') as dest:src.backup(dest)
+ shutil.copy2(candidate,p/'bridge.py');subprocess.run(['docker','restart',name],check=True,stdout=subprocess.DEVNULL)
+ print('Updated Huobao bridge:',name)
+state['routing_deployed']=stamp;(root/'state.json').write_text(json.dumps(state,indent=2))
diff --git a/integration-work/deploy_image_pool.py b/integration-work/deploy_image_pool.py
new file mode 100644
index 0000000..837606c
--- /dev/null
+++ b/integration-work/deploy_image_pool.py
@@ -0,0 +1,13 @@
+from pathlib import Path
+import datetime,shutil,sqlite3,subprocess
+root=Path('/home/ps/huobao-model-bridge')
+candidate=root/'bridge-image-pool.candidate.py'
+compile(candidate.read_text(),str(candidate),'exec')
+backup=root/'backups'/('image-pool-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S'))
+backup.mkdir(parents=True,mode=0o700)
+shutil.copy2(root/'bridge.py',backup/'bridge.py')
+shutil.copy2(root/'config.json',backup/'config.json')
+with sqlite3.connect(root/'state/jobs.sqlite3') as src,sqlite3.connect(backup/'jobs.sqlite3') as dst:src.backup(dst)
+shutil.copy2(candidate,root/'bridge.py')
+subprocess.run(['docker','restart','huobao-model-bridge'],check=True)
+print('Updated only the Huobao bridge; model jobs and credentials preserved. Backup:',backup)
diff --git a/integration-work/deploy_panel_routing.py b/integration-work/deploy_panel_routing.py
new file mode 100644
index 0000000..5aab61f
--- /dev/null
+++ b/integration-work/deploy_panel_routing.py
@@ -0,0 +1,38 @@
+import pathlib,json,sys,hashlib,datetime,shutil,subprocess,sqlite3
+root=pathlib.Path('/home/ps/huobao-gpu-selection');work=root/'panel-8189'
+assert (work/'deployed.json').exists(),'8189 has not passed node/history checks'
+manifest=json.loads((root/'panel-routing-manifest.json').read_text())
+stamp=datetime.datetime.now().strftime('%Y%m%d-%H%M%S');backup=root/('before-panel-routing-'+stamp);backup.mkdir(mode=0o700)
+targets=[('general','canvas-h3-prompt-normalizer-healthy-20261026'),('vdn','huobao-vdn-normalizer')]
+for short,name in targets:
+ p=root/(name+'.candidate.py');assert hashlib.sha256(p.read_bytes()).hexdigest()==manifest[short]['before'],'Live normalizer changed; review first'
+ candidate=root/(short+'-normalizer-panels.py');assert hashlib.sha256(candidate.read_bytes()).hexdigest()==manifest[short]['after'];compile(candidate.read_text(),str(candidate),'exec')
+bridges=[('/home/ps/huobao-model-bridge','huobao-model-bridge','state'),('/home/ps/huobao-vdn/bridge','huobao-vdn-bridge','../bridge-state')]
+for folder,_,_ in bridges:assert hashlib.sha256((pathlib.Path(folder)/'bridge.py').read_bytes()).hexdigest()==manifest['bridge']['before'],'Bridge changed; review first'
+extra=root/'extra-providers.json';shutil.copy2(extra,backup/'extra-providers.json')
+state=json.loads((root/'state.json').read_text());admission=pathlib.Path(state['admission']);shutil.copy2(admission,backup/'admission.json')
+# Stage code that accepts both provider IDs before exposing the new provider entry.
+for short,name in targets:
+ live=root/(name+'.candidate.py');shutil.copy2(live,backup/(name+'.py'))
+ live.write_bytes((root/(short+'-normalizer-panels.py')).read_bytes())
+ subprocess.run(['docker','restart','--timeout','60',name],check=True,stdout=subprocess.DEVNULL)
+normalizer=json.loads(subprocess.check_output(['docker','inspect',targets[0][1]],text=True))[0]
+tokens=pathlib.Path(next(m['Source'] for m in normalizer['Mounts'] if m['Destination']=='/run/h3-workers'))
+token=tokens/'gpu1_8189.token';assert not token.exists(),'New token already exists; inspect first'
+token.write_bytes((work/'control/canary.token').read_bytes());token.chmod(0o600)
+subprocess.run(['setfacl','-m','u:65534:r--',str(token)],check=True)
+assert token.stat().st_mode & 0o007==0
+providers=json.loads(extra.read_text());providers.append({'id':'gpu1_8189','name':'ComfyUI GPU1 :8189','base_url':'http://192.168.110.111:8189','control_token_file':'/run/h3-workers/gpu1_8189.token'})
+extra.write_text(json.dumps(providers));extra.chmod(0o644)
+policy=json.loads(admission.read_text());policy['admit']=[i for i in policy['admit'] if i!='gpu1']+['gpu1_8189']
+admission.write_text(json.dumps(policy))
+# Preserve all old IDs and job tables; only new Huobao submissions use the panel pool.
+candidate=root/'bridge-panels.py';assert hashlib.sha256(candidate.read_bytes()).hexdigest()==manifest['bridge']['after']
+for folder,name,statefolder in bridges:
+ p=pathlib.Path(folder);dest=backup/name;dest.mkdir(mode=0o700)
+ shutil.copy2(p/'bridge.py',dest/'bridge.py');shutil.copy2(p/'config.json',dest/'config.json')
+ with sqlite3.connect(p/statefolder/'jobs.sqlite3') as src,sqlite3.connect(dest/'jobs.sqlite3') as target:src.backup(target)
+ (p/'bridge.py').write_bytes(candidate.read_bytes())
+ subprocess.run(['docker','restart','--timeout','60',name],check=True,stdout=subprocess.DEVNULL)
+(root/'panel-routing-deployed.json').write_text(json.dumps({'backup':str(backup),'ports':{'gpu1':8189,'gpu2':8188,'gpu3':8191},'legacy_worker_retained':True}))
+print(json.dumps({'backup':str(backup),'new_submission_ports':[8188,8189,8191],'legacy_jobs_preserved':True}))
diff --git a/integration-work/deploy_scoped_cancel_bridge.py b/integration-work/deploy_scoped_cancel_bridge.py
new file mode 100644
index 0000000..56a2595
--- /dev/null
+++ b/integration-work/deploy_scoped_cancel_bridge.py
@@ -0,0 +1,17 @@
+import datetime, hashlib, json, pathlib, shutil, sqlite3, subprocess
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+candidate=root/'bridge-cancel.candidate.py'
+compile(candidate.read_text(),str(candidate),'exec')
+expected='7fde4e2bf1a188374cea8f25c4d60538362965cbc48f057b983876260b999a61'
+entries=[('/home/ps/huobao-model-bridge','huobao-model-bridge','state'),('/home/ps/huobao-vdn/bridge','huobao-vdn-bridge','../bridge-state')]
+for folder,_,_ in entries:
+ assert hashlib.sha256((pathlib.Path(folder)/'bridge.py').read_bytes()).hexdigest()==expected,'Live bridge changed; review before replacing'
+stamp=datetime.datetime.now().strftime('%Y%m%d-%H%M%S')
+for folder,name,statefolder in entries:
+ p=pathlib.Path(folder); backup=root/(name+'-cancel-backup-'+stamp); backup.mkdir(mode=0o700)
+ shutil.copy2(p/'bridge.py',backup/'bridge.py');shutil.copy2(p/'config.json',backup/'config.json')
+ with sqlite3.connect(p/statefolder/'jobs.sqlite3') as src,sqlite3.connect(backup/'jobs.sqlite3') as dest:src.backup(dest)
+ shutil.copy2(candidate,p/'bridge.py')
+ # Give ongoing HTTP requests time to finish; GPU workers keep running.
+ subprocess.run(['docker','restart','--timeout','60',name],check=True,stdout=subprocess.DEVNULL)
+ print(json.dumps({'updated':name,'backup':str(backup),'hash':hashlib.sha256((p/'bridge.py').read_bytes()).hexdigest()}))
diff --git a/integration-work/deploy_task_tracking.py b/integration-work/deploy_task_tracking.py
new file mode 100644
index 0000000..d370c76
--- /dev/null
+++ b/integration-work/deploy_task_tracking.py
@@ -0,0 +1,36 @@
+import pathlib,json,hashlib,subprocess,sqlite3,urllib.request,time
+root=pathlib.Path('/home/ps/huobao-gpu-selection');folder=pathlib.Path(json.loads((root/'task-tracking-current.json').read_text())['directory']);manifest=json.loads((folder/'manifest.json').read_text())
+for entry in manifest.values():assert hashlib.sha256(pathlib.Path(entry['path']).read_bytes()).hexdigest()==entry['before'],entry['path']+' changed since preparation'
+for key,p in [('main','/home/ps/huobao-model-bridge/state/jobs.sqlite3'),('hd','/home/ps/huobao-vdn/bridge-state/jobs.sqlite3')]:
+ with sqlite3.connect(p) as src,sqlite3.connect(folder/(key+'-jobs.sqlite3')) as dest:src.backup(dest)
+changes=[]
+try:
+ for short in ['general','vdn']:
+  m=manifest[short];p=pathlib.Path(m['path']);p.write_bytes(pathlib.Path(m['candidate']).read_bytes());changes.append((p,folder/(short+'.before.py'),m['name']))
+  subprocess.run(['docker','restart','--timeout','60',m['name']],check=True,stdout=subprocess.DEVNULL)
+ for short,name,port,config in [('main','huobao-model-bridge',18792,'/home/ps/huobao-model-bridge/config.json'),('hd','huobao-vdn-bridge',18794,'/home/ps/huobao-vdn/bridge/config.json')]:
+  p=pathlib.Path(manifest[short+'-bridge']['path']);p.write_bytes((folder/'bridge.after.py').read_bytes());changes.append((p,folder/(short+'-bridge.before.py'),name))
+  subprocess.run(['docker','restart','--timeout','60',name],check=True,stdout=subprocess.DEVNULL)
+  cfg=json.loads(pathlib.Path(config).read_text())
+  for attempt in range(10):
+   try:
+    req=urllib.request.Request(f'http://192.168.110.111:{port}/v1/models',headers={'Authorization':'Bearer '+cfg['token']})
+    with urllib.request.urlopen(req,timeout=10) as r:assert r.status==200
+    break
+   except Exception:
+    if attempt==9:raise
+    time.sleep(1)
+  print('READY',name)
+ cfg=json.loads(pathlib.Path('/home/ps/huobao-model-bridge/config.json').read_text())
+ jid='Z3B1MzpkOTJkZmMxOS0zNWIxLTRmNDEtYjkzZS1mZTJmZjk2OGY0ODc'
+ req=urllib.request.Request('http://192.168.110.111:18792/v2/query/video_generation/'+jid,headers={'Authorization':'Bearer '+cfg['token']})
+ with urllib.request.urlopen(req,timeout=20) as r:task=json.load(r)['task']
+ print(json.dumps({'task':205,'state':task.get('status'),'worker_state':task.get('worker_state'),'routing':task.get('routing')}))
+except Exception:
+ for p,before,name in reversed(changes):
+  p.write_bytes(before.read_bytes());subprocess.run(['docker','restart','--timeout','60',name],check=True,stdout=subprocess.DEVNULL)
+ raise
+print('BACKUP',folder)
+r=subprocess.run(['docker','logs','--tail','1200','comfyui-manju-before-qwentts-20261109'],capture_output=True,text=True)
+for line in (r.stdout+r.stderr).splitlines():
+ if any(word in line for word in ['RuntimeError:','OutOfMemoryError:','ValueError:','CUDA error:','H3_SPEECH_MISMATCH','H3_SUBTITLE_']):print('PREVIOUS_GPU1_ERROR',line[:300])
diff --git a/integration-work/deploy_vdn.py b/integration-work/deploy_vdn.py
new file mode 100644
index 0000000..53a0b76
--- /dev/null
+++ b/integration-work/deploy_vdn.py
@@ -0,0 +1,91 @@
+"""Deploy an isolated VDN adapter, preserving the existing production services."""
+import json, math, pathlib, subprocess, time
+root=pathlib.Path('/home/ps/huobao-vdn')
+existing=set(subprocess.check_output(['docker','ps','-a','--format','{{.Names}}'],text=True).splitlines())
+if {'huobao-vdn-normalizer','huobao-vdn-bridge'} & existing:
+    raise RuntimeError('VDN already deployed: inspect and back up existing services before changing files')
+root.mkdir(exist_ok=True)
+root.chmod(0o700)
+def run(*args):
+    return subprocess.check_output(args,text=True)
+name='canvas-h3-prompt-normalizer-healthy-20261026'
+old=json.loads(run('docker','inspect',name))[0]
+config=json.loads(pathlib.Path('/home/ps/huobao-model-bridge/config.json').read_text())
+env=dict(x.split('=',1) for x in old['Config']['Env'])
+for f in ('app.py','workflow.py'):
+    (root/f).write_text(run('docker','exec',name,'cat','/app/'+f))
+app=(root/'app.py').read_text()
+anchor='            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))'
+assert app.count(anchor)>=1
+app=app.replace(anchor, '''            capabilities = await client.get(f"{provider.base_url}/object_info/ApplyVDNH3", headers=provider_headers(provider))
+            capabilities.raise_for_status()
+            if 'ApplyVDNH3' not in capabilities.json():
+                return None
+'''+anchor,1)
+anchor='            response.raise_for_status()\n            payload = response.json()\n    finally:'
+assert app.count(anchor)==1
+app=app.replace(anchor, '''            if response.status_code == 400:
+                rejected = response.json()
+                issues = []
+                for node, info in (rejected.get('node_errors') or {}).items():
+                    for error in info.get('errors', []):
+                        issues.append(str(node) + ': ' + str(error.get('message', '')) + ': ' + str(error.get('details', ''))[:300])
+                if not issues:
+                    issues = [str(rejected.get('error', 'Workflow validation failed'))[:600]]
+                raise HTTPException(status_code=400, detail='; '.join(issues)[:1800])
+'''+anchor)
+(root/'app.py').write_text(app)
+workflow=(root/'workflow.py').read_text()
+anchor='    count = max(1, min(int(request.get("batch_size") or 1), 4))'
+assert workflow.count(anchor)==1
+workflow=workflow.replace(anchor, '''    if spec.key == 'minimax_h3_vdn_hd':
+        width, height = int(request['width']), int(request['height'])
+        if (width, height) not in {(2560,1440),(1440,2560),(3840,2160),(2160,3840)}:
+            raise ValueError('VDN HD requires exact 2K or 4K dimensions')
+        _patch_node(workflow, '8', {'width': math.ceil(width / 32) * 32, 'height': math.ceil(height / 32) * 32,
+                                  'length': round(float(request.get('duration', 5)) * 24) + 1})
+        # SelfLift performs low-resolution and high-resolution diffusion stages.
+        # Decode at the requested area; crop alignment padding instead of pixel upscaling.
+        _patch_node(workflow, '12', {'highres_tiling': width * height > 2560 * 1440})
+'''+anchor)
+(root/'workflow.py').write_text(workflow)
+workflows=root/'workflows'; workflows.mkdir(exist_ok=True)
+graph=json.loads((root/'source-graph.json').read_text())
+graph['8']['inputs']['prompt']='A quiet cinematic mountain landscape. No dialogue. No text.'
+graph['8']['inputs'].update(width=2560,height=1440,length=97)
+graph.pop('15', None)
+graph['16']['inputs']['images']=['13',0]
+graph['16']['inputs']['filename_prefix']='huobao_vdn/HD'
+(workflows/'vdn_hd.json').write_text(json.dumps(graph,ensure_ascii=False))
+spec={'key':'minimax_h3_vdn_hd','name':'MiniMax H3 VDN 高清重生成','mode':'image','file':'vdn_hd.json',
+      'prompt_node':'8','prompt_input':'prompt','seed_node':'12','seed_input':'seed','save_node':'16','save_prefix':'huobao_vdn/HD',
+      'reference_node':'8','reference_input_prefix':'ref_images.ref_image_',
+      'width_node':'8','height_node':'8','width_input':'width','height_input':'height','enabled':True}
+(workflows/'manifest.json').write_text(json.dumps({'version':1,'workflows':[spec]}))
+state=root/'state'; state.mkdir(exist_ok=True)
+private=root/'normalizer.env'
+private.write_text('\n'.join(k+'='+v for k,v in env.items() if k not in {'PATH','PYTHON_VERSION','PYTHON_SHA256','GPG_KEY','LANG'}))
+private.chmod(0o600)
+exists=run('docker','ps','-a','--format','{{.Names}}').splitlines()
+if 'huobao-vdn-normalizer' in exists: raise RuntimeError('VDN already deployed: inspect before changing it')
+args=['docker','run','-d','--name','huobao-vdn-normalizer','--restart','unless-stopped','--network','open-ai-canvas_default',
+      '--env-file',str(private),'-v',str(root/'app.py')+':/app/app.py:ro','-v',str(root/'workflow.py')+':/app/workflow.py:ro',
+      '-v',str(workflows)+':/app/workflows:ro','-v',str(state)+':/var/lib/h3-audio-validation']
+for m in old['Mounts']:
+    if m['Destination'].startswith('/run/'):
+        args+=['-v',m['Source']+':'+m['Destination']+':ro']
+args+=[old['Image']]+old['Config']['Cmd']
+print('normalizer',run(*args).strip()[:12])
+run('docker','network','connect','zq-platform-network','huobao-vdn-normalizer')
+broot=root/'bridge'; broot.mkdir(exist_ok=True)
+bridge_config={'token':config['token'],'h3':dict(config['h3'],url='http://huobao-vdn-normalizer:8105'),
+               'state_dir':'/state','public_url':'http://192.168.110.111:18794'}
+(broot/'config.json').write_text(json.dumps(bridge_config)); (broot/'config.json').chmod(0o600)
+(broot/'bridge.py').write_text((root/'bridge.py').read_text())
+bstate=root/'bridge-state'; bstate.mkdir(exist_ok=True)
+oldbridge=json.loads(run('docker','inspect','huobao-model-bridge'))[0]
+print('bridge',run('docker','run','-d','--name','huobao-vdn-bridge','--restart','unless-stopped',
+      '--network','open-ai-canvas_default','--user','1000:1000','--read-only','--tmpfs','/tmp:rw,noexec,nosuid,size=64m',
+      '-p','192.168.110.111:18794:8080','-v',str(broot)+':/bridge:ro','-v',str(bstate)+':/state',
+      '-w','/bridge','--entrypoint','python',oldbridge['Image'],*oldbridge['Config']['Cmd']).strip()[:12])
+print('deployed isolated VDN services; original services unchanged')
diff --git a/integration-work/diagnose_gpu1_images.py b/integration-work/diagnose_gpu1_images.py
new file mode 100644
index 0000000..e3f0cf8
--- /dev/null
+++ b/integration-work/diagnose_gpu1_images.py
@@ -0,0 +1,27 @@
+import subprocess, json
+names=['huobao-comfy-gpu1','comfyui-manju','comfyui','h3-caption-gpu3-canary-8a5f','canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer']
+for name in names:
+ r=subprocess.run(['docker','inspect',name],capture_output=True,text=True)
+ if r.returncode: print(name,'not found');continue
+ d=json.loads(r.stdout)[0]
+ print(json.dumps({'name':name,'status':d['State']['Status'],'started':d['State']['StartedAt'],'pid':d['State']['Pid']}))
+print(subprocess.check_output(['nvidia-smi','--query-compute-apps=gpu_uuid,pid,process_name,used_memory','--format=csv,noheader'],text=True))
+code='''import asyncio,httpx,json,app,hashlib,inspect
+print('app_sha',hashlib.sha256(open('/app/app.py','rb').read()).hexdigest())
+print(inspect.getsource(app.provider_queue_depth))
+async def main():
+ async with httpx.AsyncClient(timeout=8) as c:
+  for p in app.providers().values():
+   try:
+    q=await c.get(p.base_url+'/queue',headers=app.provider_headers(p));q.raise_for_status();q=q.json()
+    s=await c.get(p.base_url+'/system_stats',headers=app.provider_headers(p));s.raise_for_status();s=s.json()
+    print(json.dumps({'provider':p.id,'url':p.base_url,'running':[x[1] for x in q.get('queue_running',[])],'pending':[x[1] for x in q.get('queue_pending',[])],'devices':s.get('devices',[])}))
+   except Exception as e: print(json.dumps({'provider':p.id,'error':str(e)}))
+asyncio.run(main())
+'''
+print(subprocess.check_output(['docker','exec','canvas-h3-prompt-normalizer-healthy-20261026','python','-c',code],text=True))
+for name in ['huobao-comfy-gpu1','comfyui-manju']:
+ r=subprocess.run(['docker','logs','--tail','50',name],capture_output=True,text=True)
+ print('LOG',name)
+ for line in (r.stdout+r.stderr).replace('\r','\n').splitlines():
+  if any(x.lower() in line.lower() for x in ['%|','Prompt executed','error','memory','free','unload','traceback','GET /queue','POST /free']):print(line[:300])
diff --git a/integration-work/diagnose_video_timeouts.py b/integration-work/diagnose_video_timeouts.py
new file mode 100644
index 0000000..17e4009
--- /dev/null
+++ b/integration-work/diagnose_video_timeouts.py
@@ -0,0 +1,22 @@
+import subprocess,json
+jobs={202:'Z3B1MV84MTg5OjA3MjIxMTkyLWViZTAtNDQ2OC04Zjg2LTA5YWRiMjdhMjhmYw',203:'Z3B1MV84MTg5OjliY2JiNmY4LWU1OWMtNDg5YS1hN2Y0LThmZDdkMTU3MmFlYg',204:'ZGVmYXVsdDo4MTgxY2IzOS1jYTg0LTQ2ODItODg2MC01ZjNjZWNmMDZhZjA',205:'Z3B1MzpkOTJkZmMxOS0zNWIxLTRmNDEtYjkzZS1mZTJmZjk2OGY0ODc'}
+code='''import asyncio,httpx,json,app
+jobs=JOBS
+async def main():
+ async with httpx.AsyncClient(timeout=15) as c:
+  for appid,jid in jobs.items():
+   p,pid=app.decode_job(jid)
+   q=await c.get(p.base_url+'/queue',headers=app.provider_headers(p));q.raise_for_status();q=q.json()
+   pending=[x[1] for x in q.get('queue_pending',[])];running=[x[1] for x in q.get('queue_running',[])]
+   h=await c.get(p.base_url+'/history/'+pid,headers=app.provider_headers(p));h.raise_for_status();entry=h.json().get(pid,{})
+   info={'id':appid,'worker':p.id,'running':pid in running,'queue_position':pending.index(pid)+1 if pid in pending else None,'pending_count':len(pending),'status':entry.get('status'),'output_nodes':list(entry.get('outputs',{}))}
+   # Avoid prompts/tensors in failure diagnostics, retain the actual exception and node.
+   status=info.pop('status') or {};info['history_status']=status.get('status_str');info['completed']=status.get('completed')
+   info['errors']=[{k:e[1].get(k) for k in ['node_id','node_type','exception_type','exception_message','traceback'] if k in e[1]} for e in status.get('messages',[]) if e[0] in ['execution_error','execution_interrupted']]
+   try:
+    result=await app.get_job(jid);info['normalizer']={k:result.get(k) for k in ['status','error','providerId']}
+   except Exception as e:info['normalizer_error']=str(getattr(e,'detail',e))
+   print(json.dumps(info,ensure_ascii=False))
+asyncio.run(main())'''.replace('JOBS',repr(jobs))
+r=subprocess.run(['docker','exec','canvas-h3-prompt-normalizer-healthy-20261026','python','-c',code],capture_output=True,text=True)
+print(r.stdout);print(r.stderr);raise SystemExit(r.returncode)
diff --git a/integration-work/docker_worker_ops.py b/integration-work/docker_worker_ops.py
new file mode 100644
index 0000000..862ca57
--- /dev/null
+++ b/integration-work/docker_worker_ops.py
@@ -0,0 +1,32 @@
+"""Docker clone helpers: retain existing security and networks, publish no new ports."""
+import copy,http.client,json,socket,subprocess,pathlib
+class UnixHTTP(http.client.HTTPConnection):
+ def __init__(self): super().__init__('localhost',timeout=40)
+ def connect(self):
+  self.sock=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM);self.sock.settimeout(self.timeout);self.sock.connect('/var/run/docker.sock')
+def api(method,path,body=None):
+ c=UnixHTTP();raw=None if body is None else json.dumps(body).encode()
+ c.request(method,path,body=raw,headers={'Content-Type':'application/json'});r=c.getresponse();data=r.read();c.close()
+ if r.status>=300:raise RuntimeError(f'Docker {method} {path} failed: {r.status} '+data.decode()[:300])
+ return json.loads(data) if data else None
+def inspect(name):return api('GET','/containers/'+name+'/json')
+def clone(d,name):
+ cfg=copy.deepcopy(d['Config']);cfg['Hostname']=name;cfg['Image']=d['Image']
+ cfg['Labels']={k:v for k,v in cfg.get('Labels',{}).items() if not k.startswith('com.docker.compose.')}
+ cfg['Labels']['huobao.local.worker']=name
+ cfg['HostConfig']=copy.deepcopy(d['HostConfig'])
+ for k in ('ContainerIDFile','PidMode','IpcMode'):
+  if k=='ContainerIDFile':cfg['HostConfig'][k]=''
+ cfg['HostConfig']['AutoRemove']=False
+ return cfg
+def set_env(cfg,key,value):
+ cfg['Env']=[x for x in cfg.get('Env',[]) if not x.startswith(key+'=')]+[key+'='+value]
+ cfg['Cmd']=[key+'='+value if x.startswith(key+'=') else x for x in cfg.get('Cmd',[])]
+def replace_bind(cfg,destination,source):
+ binds=cfg['HostConfig'].get('Binds') or []
+ found=[x for x in binds if x.split(':')[1]==destination]
+ assert len(found)==1,(destination,found)
+ parts=found[0].split(':');parts[0]=str(source)
+ cfg['HostConfig']['Binds']=[(':'.join(parts) if x==found[0] else x) for x in binds]
+def write_json(path,value):
+ path=pathlib.Path(path);path.write_text(json.dumps(value,ensure_ascii=False));path.chmod(0o600)
diff --git a/integration-work/final_gpu_audit.py b/integration-work/final_gpu_audit.py
new file mode 100644
index 0000000..72a929c
--- /dev/null
+++ b/integration-work/final_gpu_audit.py
@@ -0,0 +1,25 @@
+import json,pathlib,subprocess,stat
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+def run(*a):return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+report={'workers':{},'existing_gpu1_services':{}}
+for name in ('huobao-comfy-gpu1','comfyui','h3-caption-gpu3-canary-8a5f'):
+ d=json.loads(run('docker','inspect',name))[0]
+ report['workers'][name]={'running':d['State']['Running'],'started_at':d['State']['StartedAt'],'gpu':d['HostConfig'].get('DeviceRequests'),'networks':list(d['NetworkSettings']['Networks'])}
+ if name=='huobao-comfy-gpu1':
+  assert not d['HostConfig']['PortBindings'] and d['HostConfig']['ReadonlyRootfs'] and not d['HostConfig']['Privileged']
+  assert list(d['NetworkSettings']['Networks'])==['zq-platform-network']
+  assert d['HostConfig']['DeviceRequests'][0]['DeviceIDs']==['1']
+for name in ('comfyui-manju','canvas-minimax-lipsync','canvas-cosyvoice','followup-audio-asr'):
+ d=json.loads(run('docker','inspect',name))[0]
+ report['existing_gpu1_services'][name]={'running':d['State']['Running'],'started_at':d['State']['StartedAt']}
+ assert d['State']['Running']
+d=json.loads(run('docker','inspect','canvas-h3-prompt-normalizer-healthy-20261026'))[0]
+tokens=pathlib.Path(next(m['Source'] for m in d['Mounts'] if m['Destination']=='/run/h3-workers'))
+assert stat.S_IMODE((tokens/'gpu1.token').stat().st_mode)&0o007==0
+report['gpu1_token_not_world_readable']=True
+state=json.loads((root/'state.json').read_text());report['admission']=json.loads(pathlib.Path(state['admission']).read_text())
+assert set(report['admission']['admit'])=={'default','gpu1','gpu3'}
+assert all(v['running'] for v in report['workers'].values())
+(root/'final-audit.json').write_text(json.dumps(report,indent=2))
+print(json.dumps(report,ensure_ascii=False))
+print(run('nvidia-smi','--query-gpu=index,memory.total,memory.used,memory.free','--format=csv,noheader'))
diff --git a/integration-work/fix_gpu1_token_name.py b/integration-work/fix_gpu1_token_name.py
new file mode 100644
index 0000000..8a2445b
--- /dev/null
+++ b/integration-work/fix_gpu1_token_name.py
@@ -0,0 +1,11 @@
+import pathlib,json,subprocess
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+d=json.loads(subprocess.check_output(['docker','inspect','canvas-h3-prompt-normalizer-healthy-20261026'],text=True))[0]
+tokens=pathlib.Path(next(m['Source'] for m in d['Mounts'] if m['Destination']=='/run/h3-workers'))
+source=tokens/'huobao-gpu1.token';target=tokens/'gpu1.token'
+assert source.resolve().parent==tokens.resolve() and target.resolve().parent==tokens.resolve()
+assert not target.exists()
+source.rename(target)  # Preserve the named-user ACL and private permissions.
+assert target.stat().st_mode&0o007==0
+p=root/'extra-providers.json';rows=json.loads(p.read_text());rows[0]['control_token_file']='/run/h3-workers/gpu1.token';p.write_text(json.dumps(rows))
+print('GPU1 token path now follows the existing provider-ID rule; token protection unchanged')
diff --git a/integration-work/fix_gpu3_plugin_mount.py b/integration-work/fix_gpu3_plugin_mount.py
new file mode 100644
index 0000000..d1f755d
--- /dev/null
+++ b/integration-work/fix_gpu3_plugin_mount.py
@@ -0,0 +1,22 @@
+import pathlib,json,sys,shutil,os,datetime
+sys.path.insert(0,'/home/ps/huobao-gpu-selection')
+from docker_worker_ops import api,inspect,replace_bind,write_json
+root=pathlib.Path('/home/ps/huobao-gpu-selection/gpu3-vdn');name='h3-caption-gpu3-canary-8a5f'
+d=inspect(name);assert d['State']['Status']=='created','Only repair the not-started candidate'
+original=json.loads((root/'source.inspect.json').read_text())
+source=pathlib.Path(next(m['Source'] for m in original['Mounts'] if m['Destination']=='/app/custom_nodes'))
+target=root/'custom_nodes';assert not target.exists()
+def link_or_copy(src,dst):
+ try:os.link(src,dst)
+ except OSError:shutil.copy2(src,dst)
+ return dst
+shutil.copytree(source,target,copy_function=link_or_copy,symlinks=True,ignore=shutil.ignore_patterns('__pycache__','.git'))
+shutil.copytree(root/'ComfyUI-VDN-H3',target/'ComfyUI-VDN-H3')
+cfg=json.loads((root/'create.json').read_text())
+cfg['HostConfig']['Binds']=[b for b in cfg['HostConfig']['Binds'] if b.split(':')[1]!='/app/custom_nodes/ComfyUI-VDN-H3']
+replace_bind(cfg,'/app/custom_nodes',target)
+write_json(root/'create-fixed.json',cfg)
+api('POST','/containers/'+name+'/rename?name='+name+'-mount-failed-'+datetime.datetime.now().strftime('%H%M%S'))
+created=api('POST','/containers/create?name='+name,cfg);api('POST','/containers/'+name+'/start')
+write_json(root/'fixed-created.json',created)
+print('Started GPU3 with isolated complete plugin directory; shared plugin directory unchanged:',created['Id'][:12])
diff --git a/integration-work/fix_gpu_routing_permissions.py b/integration-work/fix_gpu_routing_permissions.py
new file mode 100644
index 0000000..2aa67d9
--- /dev/null
+++ b/integration-work/fix_gpu_routing_permissions.py
@@ -0,0 +1,14 @@
+import pathlib,json,subprocess,stat,shutil
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+# The extra provider file contains only node names, URLs and token-file paths.
+(root/'extra-providers.json').chmod(0o644)
+d=json.loads(subprocess.check_output(['docker','inspect','canvas-h3-prompt-normalizer-healthy-20261026'],text=True))[0]
+tokens=pathlib.Path(next(m['Source'] for m in d['Mounts'] if m['Destination']=='/run/h3-workers'))
+files=[p for p in tokens.iterdir() if p.name!='huobao-gpu1.token' and p.is_file()]
+print('Existing token file permissions',[(p.name,oct(stat.S_IMODE(p.stat().st_mode)),p.stat().st_uid,p.stat().st_gid) for p in files])
+assert shutil.which('setfacl'),'A named service-user ACL is required; keep the private token unchanged otherwise'
+target=tokens/'huobao-gpu1.token'
+assert stat.S_IMODE(target.stat().st_mode)&0o007==0,'Token must not be world-readable'
+subprocess.run(['setfacl','-m','u:65534:r--',str(target)],check=True)
+assert stat.S_IMODE(target.stat().st_mode)&0o007==0
+print('Only the existing normalizer service UID 65534 receives read access; token remains inaccessible to other users')
diff --git a/integration-work/fix_vdn_bridge.py b/integration-work/fix_vdn_bridge.py
new file mode 100644
index 0000000..2faa464
--- /dev/null
+++ b/integration-work/fix_vdn_bridge.py
@@ -0,0 +1,11 @@
+import subprocess,json
+def run(*a): return subprocess.check_output(a,text=True)
+old=json.loads(run('docker','inspect','huobao-model-bridge'))[0]
+new=json.loads(run('docker','inspect','huobao-vdn-bridge'))[0]
+assert new['State']['Status']=='created', 'only replace the failed, never-started new container'
+run('docker','rm','huobao-vdn-bridge')
+root='/home/ps/huobao-vdn'
+print(run('docker','run','-d','--name','huobao-vdn-bridge','--restart','unless-stopped',
+    '--network','open-ai-canvas_default','--user','1000:1000','--read-only','--tmpfs','/tmp:rw,noexec,nosuid,size=64m',
+    '-p','192.168.110.111:18794:8080','-v',root+'/bridge:/bridge:ro','-v',root+'/bridge-state:/state',
+    '-w','/bridge','--entrypoint','python',old['Image'],*old['Config']['Cmd']).strip()[:12])
diff --git a/integration-work/fix_vdn_crop.py b/integration-work/fix_vdn_crop.py
new file mode 100644
index 0000000..be31737
--- /dev/null
+++ b/integration-work/fix_vdn_crop.py
@@ -0,0 +1,12 @@
+from pathlib import Path
+import json,subprocess
+root=Path('/home/ps/huobao-vdn')
+p=root/'workflows/vdn_hd.json'; graph=json.loads(p.read_text())
+graph.pop('15',None)
+graph['16']['inputs']['images']=['13',0]
+p.write_text(json.dumps(graph))
+p=root/'workflow.py'; text=p.read_text()
+text=text.replace("        _patch_node(workflow, '15', {'width': width, 'height': height})\n",'')
+p.write_text(text)
+subprocess.run(['docker','restart','huobao-vdn-normalizer'],check=True)
+print('VDN decodes full native aligned dimensions; desktop trims only alignment padding')
diff --git a/integration-work/fix_vdn_errors.py b/integration-work/fix_vdn_errors.py
new file mode 100644
index 0000000..8c7e2b4
--- /dev/null
+++ b/integration-work/fix_vdn_errors.py
@@ -0,0 +1,21 @@
+from pathlib import Path
+import subprocess
+p=Path('/home/ps/huobao-vdn/app.py')
+s=p.read_text()
+anchor='            response.raise_for_status()\n            payload = response.json()\n    finally:'
+assert s.count(anchor)==1
+replacement='''            if response.status_code == 400:
+                rejected = response.json()
+                issues = []
+                for node, info in (rejected.get('node_errors') or {}).items():
+                    for error in info.get('errors', []):
+                        issues.append(str(node) + ': ' + str(error.get('message', '')) + ': ' + str(error.get('details', ''))[:300])
+                if not issues:
+                    issues = [str(rejected.get('error', 'Workflow validation failed'))[:600]]
+                raise HTTPException(status_code=400, detail='; '.join(issues)[:1800])
+            response.raise_for_status()
+            payload = response.json()
+    finally:'''
+p.write_text(s.replace(anchor,replacement))
+subprocess.run(['docker','restart','huobao-vdn-normalizer'],check=True)
+print('VDN validation errors now report the failing node')
diff --git a/integration-work/general-normalizer-interface-before.py b/integration-work/general-normalizer-interface-before.py
new file mode 100644
index 0000000..d53faf7
--- /dev/null
+++ b/integration-work/general-normalizer-interface-before.py
@@ -0,0 +1,586 @@
+from __future__ import annotations
+
+import base64
+import asyncio
+import ipaddress
+import json
+import mimetypes
+import os
+import secrets
+import socket
+from pathlib import Path
+from job_cancellation import dispatched as cancellation_dispatched, record as record_cancellation
+from dataclasses import dataclass
+from typing import Any
+from urllib.parse import quote, urlencode, urlsplit
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Response
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel, Field
+
+from workflow import MAX_VIDEO_DURATION_SECONDS, compile_workflow, load_registry, public_model, public_workflow, validate_h3_references
+from h3_audio_intent import plan_h3_audio
+from h3_audio_validation import AudioOutputValidator, attach_audio_policy
+from h3_visual_guard import VISUAL_REVISION, validate_visual_dimensions
+from h3_audio_conditioning import AudioConditioningError, prepare_audio_conditioning
+from h3_audio_output_guard import AudioQualityError
+
+
+@dataclass(frozen=True)
+class Provider:
+    id: str
+    name: str
+    base_url: str
+    api_key: str = ""
+    control_token_file: str = ""
+
+
+class JobRequest(BaseModel):
+    provider_id: str = "default"
+    strict_provider: bool = False
+    workflow_key: str
+    prompt: str
+    negative_prompt: str = ""
+    input_images: list[str] = Field(default_factory=list, max_length=9)
+    width: int | None = Field(default=None, ge=64, le=8192)
+    height: int | None = Field(default=None, ge=64, le=8192)
+    duration: float | None = Field(default=None, gt=0, le=MAX_VIDEO_DURATION_SECONDS)
+    generate_audio: bool | None = None
+    seed: int | None = Field(default=None, ge=0)
+    batch_size: int = Field(default=1, ge=1, le=4)
+    denoise: float | None = Field(default=None, ge=0, le=1)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+app = FastAPI(title="Canvas ComfyUI Workflow Adapter", version="1.0.0")
+audio_validator = AudioOutputValidator()
+provider_selection_lock = asyncio.Lock()
+provider_reservations: dict[str, int] = {}
+
+
+def auto_balance_enabled() -> bool:
+    return os.getenv("COMFY_AUTO_BALANCE", "").strip().lower() in {"1", "true", "yes", "on"}
+
+
+def providers() -> dict[str, Provider]:
+    raw = os.getenv("COMFY_PROVIDERS_JSON", "").strip()
+    rows: list[dict[str, Any]] = []
+    if raw:
+        parsed = json.loads(raw)
+        rows = parsed if isinstance(parsed, list) else []
+    elif os.getenv("COMFY_URL", "").strip():
+        rows = [{"id": "default", "name": "ComfyUI", "base_url": os.getenv("COMFY_URL"), "api_key": os.getenv("COMFY_API_KEY", "")}]
+    extra_path = Path('/app/huobao-extra-providers.json')
+    if extra_path.exists():
+        extra = json.loads(extra_path.read_text())
+        if not isinstance(extra, list) or any(not isinstance(row, dict) or row.get('id') != 'gpu1' for row in extra):
+            raise ValueError('Invalid Huobao extra provider configuration')
+        existing_ids = {row.get('id') for row in rows}
+        rows.extend(row for row in extra if row['id'] not in existing_ids)
+    result: dict[str, Provider] = {}
+    for row in rows:
+        provider = Provider(id=str(row.get("id") or "").strip(), name=str(row.get("name") or row.get("id") or "ComfyUI"), base_url=str(row.get("base_url") or "").strip().rstrip("/"), api_key=str(row.get("api_key") or ""), control_token_file=str(row.get("control_token_file") or ""))
+        if provider.id and provider.base_url.startswith(("http://", "https://")):
+            result[provider.id] = provider
+    return result
+
+
+def require_token(authorization: str | None = Header(default=None)) -> None:
+    expected = os.getenv("COMFY_ADAPTER_TOKEN", "").strip()
+    if expected and not secrets.compare_digest(authorization or "", f"Bearer {expected}"):
+        raise HTTPException(status_code=401, detail="invalid adapter token")
+
+
+def provider_headers(provider: Provider) -> dict[str, str]:
+    headers = {"Authorization": f"Bearer {provider.api_key}"} if provider.api_key else {}
+    if provider.control_token_file:
+        path = Path(provider.control_token_file)
+        try:
+            # Operator-mounted token only; it is never accepted from JobRequest
+            # or exposed by the public provider catalogue.
+            if path.parent != Path('/run/h3-workers') or path.name != provider.id + '.token':
+                raise ValueError('invalid worker control token path')
+            token = path.read_text().strip()
+            if not 16 <= len(token) <= 512 or any(ord(x) < 33 or ord(x) > 126 for x in token):
+                raise ValueError('invalid worker control token')
+            headers['X-H3-Canary-Token'] = token
+        except (OSError, ValueError):
+            raise HTTPException(status_code=503, detail="生成节点控制配置未就绪，任务未提交")
+    return headers
+
+
+async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        async with httpx.AsyncClient(timeout=5) as client:
+            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    except (httpx.HTTPError, ValueError, TypeError):
+        return None
+    return len(payload.get("queue_running") or []) + len(payload.get("queue_pending") or [])
+
+
+def admission_ids(configured: dict[str, Provider]) -> set[str]:
+    path = os.getenv("COMFY_ADMISSION_FILE", "").strip()
+    if not path:
+        return set(configured)
+    try:
+        raw = Path(path).read_bytes()
+        if len(raw) > 4096:
+            raise ValueError("oversized admission configuration")
+        value = json.loads(raw)
+        if not isinstance(value, dict):
+            raise ValueError("invalid admission configuration")
+        allowed = value.get("admit")
+        if type(value.get("schema")) is not int or value.get("schema") != 1 or not isinstance(allowed, list) or any(not isinstance(x, str) for x in allowed):
+            raise ValueError("invalid admission configuration")
+        if len(set(allowed)) != len(allowed) or not set(allowed) <= set(configured):
+            raise ValueError("unknown or duplicate admission provider")
+        return set(allowed)
+    except (OSError, ValueError, TypeError):
+        # Drain changes affect only new submissions; job lookup always retains
+        # both stable provider IDs and their existing history/output routes.
+        raise HTTPException(status_code=503, detail="生成服务正在切换，任务尚未提交，请稍后重试")
+
+
+async def select_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:
+    configured = providers()
+    requested = configured.get(requested_provider_id)
+    admitted = admission_ids(configured)
+    if requested is None:
+        return None
+    if strict_provider:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="指定显卡正在维护或排空，任务未提交；请稍后重试或选择自动分配")
+        if await provider_queue_depth(requested) is None:
+            raise HTTPException(status_code=503, detail="指定显卡不可用或缺少所需工作流，任务未提交")
+        return requested
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="该生成节点正在排空，现有任务继续执行，新任务请稍后提交")
+        return requested
+
+    candidates = [provider for provider in configured.values() if provider.id in admitted]
+    if not candidates:
+        raise HTTPException(status_code=503, detail="生成节点正在排空，现有任务和结果保持不变")
+    depths = await asyncio.gather(*(provider_queue_depth(provider) for provider in candidates))
+    available = [
+        (depth + provider_reservations.get(provider.id, 0), 0 if provider.id == requested_provider_id else 1, provider)
+        for provider, depth in zip(candidates, depths)
+        if depth is not None
+    ]
+    if not available:
+        if os.getenv("COMFY_ADMISSION_FILE", "").strip():
+            raise HTTPException(status_code=503, detail="生成节点尚未就绪，任务未提交，请稍后重试")
+        return requested
+    return min(available, key=lambda item: (item[0], item[1]))[2]
+
+
+async def reserve_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:
+    async with provider_selection_lock:
+        provider = await select_provider(requested_provider_id, strict_provider)
+        if provider is not None:
+            provider_reservations[provider.id] = provider_reservations.get(provider.id, 0) + 1
+        return provider
+
+
+async def release_provider(provider: Provider) -> None:
+    async with provider_selection_lock:
+        remaining = provider_reservations.get(provider.id, 0) - 1
+        if remaining > 0:
+            provider_reservations[provider.id] = remaining
+        else:
+            provider_reservations.pop(provider.id, None)
+
+
+def input_host_allowlist() -> set[str]:
+    return {value.strip().lower().rstrip(".") for value in os.getenv("COMFY_INPUT_HOST_ALLOWLIST", "").split(",") if value.strip()}
+
+
+async def validate_input_url(value: str) -> None:
+    parsed = urlsplit(value)
+    host = (parsed.hostname or "").lower().rstrip(".")
+    if parsed.scheme not in {"http", "https"} or not host or parsed.username or parsed.password:
+        raise HTTPException(status_code=400, detail="reference image URL is invalid")
+    if host in input_host_allowlist():
+        return
+    try:
+        infos = await asyncio.to_thread(socket.getaddrinfo, host, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
+    except OSError as exc:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved") from exc
+    if not infos:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved")
+    for info in infos:
+        address = ipaddress.ip_address(info[4][0])
+        if not address.is_global:
+            raise HTTPException(status_code=400, detail="reference image URL cannot target a private address")
+
+
+async def download_input_image(client: httpx.AsyncClient, value: str) -> tuple[bytes, str]:
+    await validate_input_url(value)
+    chunks: list[bytes] = []
+    total = 0
+    async with client.stream("GET", value, follow_redirects=False) as response:
+        response.raise_for_status()
+        if 300 <= response.status_code < 400:
+            raise HTTPException(status_code=400, detail="reference image redirects are not accepted")
+        mime_type = response.headers.get("content-type", "image/png").split(";", 1)[0]
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference image URL did not return an image")
+        async for chunk in response.aiter_bytes():
+            total += len(chunk)
+            if total > 30 * 1024 * 1024:
+                raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+            chunks.append(chunk)
+    return b"".join(chunks), mime_type
+
+
+def encode_job(provider_id: str, prompt_id: str) -> str:
+    return base64.urlsafe_b64encode(f"{provider_id}:{prompt_id}".encode()).decode().rstrip("=")
+
+
+def decode_job(job_id: str) -> tuple[Provider, str]:
+    if job_id.startswith(("h3a1.", "h3v2.")):
+        job_id = job_id.split(".", 1)[1]
+    try:
+        raw = base64.urlsafe_b64decode(job_id + "=" * (-len(job_id) % 4)).decode()
+        provider_id, prompt_id = raw.split(":", 1)
+        provider = providers()[provider_id]
+    except Exception as exc:
+        raise HTTPException(status_code=404, detail="job not found") from exc
+    return provider, prompt_id
+
+
+def output_validation_mode() -> str:
+    mode = os.getenv("H3_OUTPUT_VALIDATION_MODE", "guarded").strip()
+    if mode not in {"guarded", "prompt-only"}:
+        raise HTTPException(status_code=503, detail="视频处理模式配置无效，任务未提交")
+    return mode
+
+
+@app.get("/health")
+async def health() -> dict[str, Any]:
+    return {
+        "status": "ok",
+        "providers": len(providers()),
+        "workflows": len(load_registry()),
+        "autoBalance": auto_balance_enabled(),
+        "outputValidationMode": output_validation_mode(),
+    }
+
+
+@app.get("/v1/providers", dependencies=[Depends(require_token)])
+async def list_providers() -> dict[str, Any]:
+    return {"providers": [{"id": item.id, "name": item.name, "baseUrl": item.base_url} for item in providers().values()]}
+
+
+@app.get("/v1/workflows", dependencies=[Depends(require_token)])
+async def list_workflows() -> dict[str, Any]:
+    return {"workflows": [public_workflow(item) for item in load_registry().values()]}
+
+
+@app.get("/v1/models", dependencies=[Depends(require_token)])
+async def list_models() -> dict[str, Any]:
+    return {"object": "list", "data": [public_model(item) for item in load_registry().values()]}
+
+
+async def upload_image(client: httpx.AsyncClient, provider: Provider, value: str, index: int, client_id: str) -> str:
+    value = value.strip()
+    if value.startswith("comfy://"):
+        return value.removeprefix("comfy://")
+    if value.startswith("data:"):
+        header, encoded = value.split(",", 1)
+        mime_type = header.split(";", 1)[0].removeprefix("data:") or "image/png"
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference data URL must contain an image")
+        try:
+            data = base64.b64decode(encoded, validate=True)
+        except (ValueError, base64.binascii.Error) as exc:
+            raise HTTPException(status_code=400, detail="reference image data URL is invalid") from exc
+    elif value.startswith(("http://", "https://")):
+        data, mime_type = await download_input_image(client, value)
+    else:
+        raise HTTPException(status_code=400, detail="input_images must contain http(s), data, or comfy URLs")
+    if len(data) > 30 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+    extension = mimetypes.guess_extension(mime_type) or ".png"
+    filename = f"{client_id}-reference-{index}{extension}"
+    response = await client.post(f"{provider.base_url}/upload/image", files={"image": (filename, data, mime_type)}, data={"overwrite": "true"}, headers=provider_headers(provider))
+    response.raise_for_status()
+    payload = response.json()
+    return str(payload.get("name") or filename)
+
+
+def request_audio_plan(spec, request: JobRequest) -> dict:
+    if not (spec.raw.get("speech_prompt_policy") == "minimax_h3" and spec.raw.get("native_audio_control")):
+        return {"supported": False}
+    if request.generate_audio is False:
+        return {"supported": True, "status": "ready", "normalized_prompt": request.prompt,
+                "dialogue_base_prompt": request.prompt, "dialogue": [], "sound_effects": [],
+                "music": [], "audio_mode": "silent", "silent": True, "speech_requested": False,
+                "expected_transcript": "", "required_seconds": 0, "max_duration_seconds": 15, "issues": []}
+    plan = plan_h3_audio(request.prompt, float(request.duration or 5))
+    if output_validation_mode() == "prompt-only" and not plan["silent"] and plan["audio_mode"] == "silent":
+        plan["audio_mode"] = "effects"
+    return {"supported": True, **plan}
+
+
+@app.post("/v1/audio-plan", dependencies=[Depends(require_token)])
+async def preview_audio_plan(request: JobRequest) -> dict:
+    spec = load_registry().get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    return request_audio_plan(spec, request)
+
+
+@app.post("/v1/jobs", dependencies=[Depends(require_token)])
+async def create_job(request: JobRequest) -> dict[str, Any]:
+    registry = load_registry()
+    spec = registry.get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    try:
+        validate_h3_references(spec, len(request.input_images))
+    except ValueError as error:
+        raise HTTPException(status_code=400, detail=str(error)) from error
+    audio_plan = request_audio_plan(spec, request)
+    guarded_output = bool(audio_plan.get("supported")) and output_validation_mode() == "guarded"
+    if audio_plan.get("supported"):
+        if audio_plan.get("status") != "ready":
+            raise HTTPException(status_code=400, detail="H3_AUDIO_CONFIRMATION_REQUIRED: 请先确认台词及视频时长，再提交视频生成")
+        if not guarded_output:
+            request = request.model_copy(update={"prompt": audio_plan["normalized_prompt"]})
+        try:
+            if guarded_output:
+                validate_visual_dimensions(request.width, request.height)
+                await audio_validator.ready(visual_required=True, audio_required=audio_plan.get("audio_mode") in {"dialogue", "effects"})
+                if audio_plan.get("audio_mode") in {"dialogue", "effects"}:
+                    prompt = await prepare_audio_conditioning(audio_plan, request.prompt, float(request.duration or 5), len(request.input_images))
+                    request = request.model_copy(update={"prompt": prompt})
+        except AudioQualityError as error:
+            raise HTTPException(status_code=503 if error.code.endswith("_UNAVAILABLE") else 400, detail=str(error)) from error
+        except AudioConditioningError as error:
+            raise HTTPException(status_code=503 if error.code == "H3_AUDIO_NORMALIZER_UNAVAILABLE" else 400, detail=str(error)) from error
+    provider = await reserve_provider(request.provider_id, request.strict_provider)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="provider is not configured")
+    try:
+        client_id = ("canvas-h3v2-" if guarded_output else "canvas-") + secrets.token_hex(8)
+        async with httpx.AsyncClient(timeout=60) as client:
+            uploaded = [await upload_image(client, provider, value, index, client_id) for index, value in enumerate(request.input_images, start=1)]
+            try:
+                workflow = compile_workflow(spec, request.model_dump(), uploaded, client_id, preserve_requested_audio=not guarded_output and bool(audio_plan.get("supported")))
+                if guarded_output:
+                    attach_audio_policy(workflow, audio_plan, float(request.duration or 5), str(spec.raw.get("save_node")), visual_required=True)
+            except ValueError as exc:
+                raise HTTPException(status_code=400, detail=str(exc)) from exc
+            response = await client.post(f"{provider.base_url}/prompt", json={"prompt": workflow, "client_id": client_id}, headers=provider_headers(provider))
+            if response.status_code == 400 and spec.raw.get("speech_prompt_policy") == "minimax_h3":
+                try:
+                    rejected = response.json()
+                except ValueError:
+                    rejected = {}
+                if "h3_caption_pipeline" in (rejected.get("node_errors") or {}) or "H3CaptionPipeline" in str((rejected.get("error") or {}).get("details") or ""):
+                    raise HTTPException(status_code=503, detail="字幕工作流预检未通过，处理组件、模型或字体尚未就绪；任务未进入 GPU 生成，请联系管理员。")
+            response.raise_for_status()
+            payload = response.json()
+    finally:
+        await release_provider(provider)
+    prompt_id = str(payload.get("prompt_id") or "").strip()
+    if not prompt_id:
+        raise HTTPException(status_code=502, detail="ComfyUI did not return prompt_id")
+    job_id = encode_job(provider.id, prompt_id)
+    persisted = True
+    if guarded_output:
+        job_id = "h3v2." + job_id
+        try:
+            audio_validator.register_policy(job_id, audio_plan, float(request.duration or 5), visual_required=True)
+        except AudioQualityError as error:
+            raise HTTPException(status_code=502, detail=str(error)) from error
+        except OSError:
+            # The provider already accepted this exact job. Return its ID rather
+            # than an ambiguous 500 inviting another GPU submission. Its graph
+            # carries the same policy; missing evidence still fails closed.
+            persisted = False
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "workflowKey": spec.key, "workflowRevision": spec.revision, "status": "submitted", "policyPersisted": persisted}
+
+
+def extract_outputs(entry: dict[str, Any], job_id: str) -> list[dict[str, Any]]:
+    result: list[dict[str, Any]] = []
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if not isinstance(item, dict) or not item.get("filename"):
+                    continue
+                filename = str(item["filename"])
+                mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                kind = "video" if mime_type.startswith("video/") or filename.lower().endswith((".gif", ".webp")) and field == "gifs" else "audio" if mime_type.startswith("audio/") else "image"
+                index = len(result)
+                result.append({"index": index, "kind": kind, "mimeType": mime_type, "filename": filename, "url": f"/jobs/{quote(job_id, safe='')}/outputs/{index}"})
+    return result
+
+
+async def job_state(job_id: str) -> tuple[Provider, str, dict[str, Any], list[dict[str, Any]]]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.get(f"{provider.base_url}/history/{quote(prompt_id, safe='')}", headers=provider_headers(provider))
+        response.raise_for_status()
+        history = response.json()
+    entry = history.get(prompt_id) or {}
+    outputs = extract_outputs(entry, job_id)
+    return provider, prompt_id, entry, outputs
+
+
+@app.get("/v1/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def get_job(job_id: str) -> dict[str, Any]:
+    try:
+        provider, prompt_id, entry, outputs = await job_state(job_id)
+    except httpx.TimeoutException:
+        provider, prompt_id = decode_job(job_id)
+        return {
+            "id": job_id,
+            "promptId": prompt_id,
+            "providerId": provider.id,
+            "status": "running",
+            "outputs": [],
+            "error": "",
+            "pollDeferred": True,
+        }
+    status_payload = entry.get("status") or {}
+    if status_payload.get("status_str") == "error":
+        status = "failed"
+    elif outputs and not (job_id.startswith("h3v2.") and not status_payload.get("completed")):
+        status = "succeeded"
+    elif status_payload.get("completed"):
+        status = "failed"
+    else:
+        status = "running"
+    if job_id.startswith("h3v2.") and status != "succeeded":
+        outputs = []
+    if status != "succeeded" and cancellation_dispatched(job_id):
+        # An acknowledged interrupt is not terminal until this exact prompt
+        # disappears from the worker queue. Never infer it from HTTP 200 alone.
+        try:
+            async with httpx.AsyncClient(timeout=10) as client:
+                response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+                response.raise_for_status()
+                queue = response.json()
+            if not isinstance(queue, dict) or not isinstance(queue.get("queue_running"), list) or not isinstance(queue.get("queue_pending"), list):
+                raise ValueError("invalid queue response")
+            remaining = {str(item[1]) for item in queue["queue_running"] + queue["queue_pending"] if isinstance(item, list) and len(item) > 1}
+            if prompt_id not in remaining:
+                status, outputs = "cancelled", []
+            else:
+                return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在取消生成", "cancelRequested": True}
+        except (httpx.HTTPError, ValueError):
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在确认取消", "cancelRequested": True}
+    error = "ComfyUI execution failed" if status == "failed" else ""
+    if status == "failed":
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            # 只映射已识别的内核错误，不向用户返回节点输入、提示词或 traceback。
+            if "tensor strides exceed int32 range" in str(event[1].get("exception_message") or ""):
+                error = "当前时长与分辨率组合超出采样内核范围，请缩短时长后重试（最多 15 秒）"
+                break
+    if status == "failed":
+        hints = {
+            "H3_SUBTITLE_MASK_UNCERTAIN": "检测到疑似字幕，但无法安全区分字幕和产品文字，任务已停止，未返回未清理视频。",
+            "H3_SUBTITLE_RESIDUAL": "字幕清理后仍检测到残留，任务已停止，避免生成双层字幕。",
+            "H3_SPEECH_MISMATCH": "实际口播与原台词不一致，未生成误导字幕；请缩短台词或调整后重试。",
+            "H3_SUBTITLE_ALIGNMENT": "口播时间轴校验未通过，无法准确烧录字幕；请缩短单句台词后重试。",
+            "H3_SUBTITLE_FONT": "字幕含字体不支持的字符，已停止以避免乱码；请使用常见文字。",
+            "H3_SUBTITLE_DEPENDENCY": "字幕处理服务依赖未就绪，请联系管理员；原任务未自动重试。",
+            "H3_SUBTITLE_FRAME_COUNT": "字幕处理前后帧数或尺寸不一致，已停止输出，请联系管理员。",
+        }
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            message = str(event[1].get("exception_message") or "")
+            for code, hint in hints.items():
+                if message.startswith(code + ":"):
+                    error = hint
+                    break
+        # Never expose a partial/raw output from a failed cleanup/quality gate.
+        outputs = []
+    if status == "succeeded":
+        quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+        if quality["status"] in {"pending", "unavailable"}:
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running",
+                    "outputs": [], "error": "", "stage": "正在校验字幕与音轨" if job_id.startswith("h3v2.") or quality.get("visual_required") else "正在校验视频音轨", "pollDeferred": True}
+        if quality["status"] == "failed":
+            status, outputs, error = "failed", [], quality["error"]
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": status, "outputs": outputs, "error": error}
+
+
+@app.post("/v1/jobs/{job_id}/cancel", dependencies=[Depends(require_token)])
+async def cancel_job(job_id: str) -> dict[str, Any]:
+    provider, prompt_id = decode_job(job_id)
+    # Write intent before sending; disk failure must not produce an untracked
+    # cancellation. The worker API atomically compares the running prompt ID.
+    record_cancellation(job_id, False)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.post(f"{provider.base_url}/api/jobs/{quote(prompt_id, safe='')}/cancel", json={}, headers=provider_headers(provider))
+        if response.status_code in (404, 405):
+            raise HTTPException(status_code=409, detail="生成节点未提供按任务取消接口，未中断其他任务")
+        response.raise_for_status()
+        acknowledged = response.json().get("cancelled")
+        if type(acknowledged) is not bool:
+            raise HTTPException(status_code=502, detail="生成节点取消回执无效，请核对原任务状态")
+        if acknowledged:
+            record_cancellation(job_id, True)
+    return await get_job(job_id)
+
+
+@app.get("/v1/jobs/{job_id}/outputs/{index}", dependencies=[Depends(require_token)])
+async def get_output(job_id: str, index: int) -> Response:
+    provider, _, entry, outputs = await job_state(job_id)
+    if (entry.get("status") or {}).get("status_str") == "error":
+        raise HTTPException(status_code=409, detail="任务未成功，未返回部分输出")
+    if not outputs or job_id.startswith("h3v2.") and not (entry.get("status") or {}).get("completed"):
+        raise HTTPException(status_code=409, detail="视频生成尚未完成，未返回部分输出")
+    quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+    if quality["status"] != "verified":
+        raise HTTPException(status_code=422 if quality["status"] == "failed" else 409,
+                            detail=quality.get("error", "视频核验尚未完成，请稍后查询原任务"))
+    if index < 0 or index >= len(outputs):
+        raise HTTPException(status_code=404, detail="output not found")
+    wanted = outputs[index]
+    locator: dict[str, Any] | None = None
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if isinstance(item, dict) and str(item.get("filename")) == wanted["filename"]:
+                    locator = item
+                    break
+            if locator: break
+        if locator: break
+    if locator is None:
+        raise HTTPException(status_code=404, detail="output locator not found")
+    if quality.get("visual_revision") == VISUAL_REVISION:
+        bound_locator = {key: locator.get(key, "output" if key == "type" else "") for key in ("filename", "subfolder", "type")}
+        try:
+            media = await audio_validator.verified_download(quality, bound_locator, provider.base_url, provider_headers(provider))
+        except AudioQualityError as error:
+            raise HTTPException(status_code=422, detail=str(error)) from error
+        except (httpx.HTTPError, OSError, asyncio.TimeoutError):
+            raise HTTPException(status_code=503, detail="H3_VISUAL_VALIDATION_UNAVAILABLE: 已核验视频暂不可读取，请查询原任务") from None
+        return Response(content=media, media_type=wanted["mimeType"], headers={"Cache-Control": "private, no-store"})
+    query = urlencode({"filename": locator.get("filename", ""), "subfolder": locator.get("subfolder", ""), "type": locator.get("type", "output")})
+    client = httpx.AsyncClient(timeout=120)
+    response = await client.send(client.build_request("GET", f"{provider.base_url}/view?{query}", headers=provider_headers(provider)), stream=True)
+    if response.status_code >= 400:
+        await response.aclose(); await client.aclose()
+        raise HTTPException(status_code=502, detail="failed to read ComfyUI output")
+    async def stream():
+        try:
+            async for chunk in response.aiter_bytes():
+                yield chunk
+        finally:
+            await response.aclose(); await client.aclose()
+    return StreamingResponse(stream(), media_type=response.headers.get("content-type", wanted["mimeType"]))
diff --git a/integration-work/general-normalizer-panels.py b/integration-work/general-normalizer-panels.py
new file mode 100644
index 0000000..a7d482f
--- /dev/null
+++ b/integration-work/general-normalizer-panels.py
@@ -0,0 +1,656 @@
+from __future__ import annotations
+
+import base64
+import asyncio
+import ipaddress
+import json
+import mimetypes
+import os
+import secrets
+import socket
+from pathlib import Path
+from job_cancellation import dispatched as cancellation_dispatched, record as record_cancellation
+from dataclasses import dataclass, replace
+from typing import Any
+from urllib.parse import quote, urlencode, urlsplit
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Response
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel, Field
+
+from workflow import MAX_VIDEO_DURATION_SECONDS, compile_workflow, load_registry, public_model, public_workflow, validate_h3_references
+from h3_audio_intent import plan_h3_audio
+from h3_audio_validation import AudioOutputValidator, attach_audio_policy
+from h3_visual_guard import VISUAL_REVISION, validate_visual_dimensions
+from h3_audio_conditioning import AudioConditioningError, prepare_audio_conditioning
+from h3_audio_output_guard import AudioQualityError
+
+
+@dataclass(frozen=True)
+class Provider:
+    id: str
+    name: str
+    base_url: str
+    api_key: str = ""
+    control_token_file: str = ""
+
+
+class JobRequest(BaseModel):
+    provider_id: str = "default"
+    strict_provider: bool = False
+    huobao_panels: bool = False
+    workflow_key: str
+    prompt: str
+    negative_prompt: str = ""
+    input_images: list[str] = Field(default_factory=list, max_length=9)
+    width: int | None = Field(default=None, ge=64, le=8192)
+    height: int | None = Field(default=None, ge=64, le=8192)
+    duration: float | None = Field(default=None, gt=0, le=MAX_VIDEO_DURATION_SECONDS)
+    generate_audio: bool | None = None
+    seed: int | None = Field(default=None, ge=0)
+    batch_size: int = Field(default=1, ge=1, le=4)
+    denoise: float | None = Field(default=None, ge=0, le=1)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+app = FastAPI(title="Canvas ComfyUI Workflow Adapter", version="1.0.0")
+audio_validator = AudioOutputValidator()
+provider_selection_lock = asyncio.Lock()
+provider_reservations: dict[str, int] = {}
+
+
+def auto_balance_enabled() -> bool:
+    return os.getenv("COMFY_AUTO_BALANCE", "").strip().lower() in {"1", "true", "yes", "on"}
+
+
+def providers() -> dict[str, Provider]:
+    raw = os.getenv("COMFY_PROVIDERS_JSON", "").strip()
+    rows: list[dict[str, Any]] = []
+    if raw:
+        parsed = json.loads(raw)
+        rows = parsed if isinstance(parsed, list) else []
+    elif os.getenv("COMFY_URL", "").strip():
+        rows = [{"id": "default", "name": "ComfyUI", "base_url": os.getenv("COMFY_URL"), "api_key": os.getenv("COMFY_API_KEY", "")}]
+    extra_path = Path('/app/huobao-extra-providers.json')
+    if extra_path.exists():
+        extra = json.loads(extra_path.read_text())
+        if not isinstance(extra, list) or any(not isinstance(row, dict) or row.get('id') not in ('gpu1', 'gpu1_8189') for row in extra):
+            raise ValueError('Invalid Huobao extra provider configuration')
+        existing_ids = {row.get('id') for row in rows}
+        rows.extend(row for row in extra if row['id'] not in existing_ids)
+    result: dict[str, Provider] = {}
+    for row in rows:
+        provider = Provider(id=str(row.get("id") or "").strip(), name=str(row.get("name") or row.get("id") or "ComfyUI"), base_url=str(row.get("base_url") or "").strip().rstrip("/"), api_key=str(row.get("api_key") or ""), control_token_file=str(row.get("control_token_file") or ""))
+        if provider.id and provider.base_url.startswith(("http://", "https://")):
+            result[provider.id] = provider
+    return result
+
+
+def require_token(authorization: str | None = Header(default=None)) -> None:
+    expected = os.getenv("COMFY_ADAPTER_TOKEN", "").strip()
+    if expected and not secrets.compare_digest(authorization or "", f"Bearer {expected}"):
+        raise HTTPException(status_code=401, detail="invalid adapter token")
+
+
+def provider_headers(provider: Provider) -> dict[str, str]:
+    headers = {"Authorization": f"Bearer {provider.api_key}"} if provider.api_key else {}
+    if provider.control_token_file:
+        path = Path(provider.control_token_file)
+        try:
+            # Operator-mounted token only; it is never accepted from JobRequest
+            # or exposed by the public provider catalogue.
+            if path.parent != Path('/run/h3-workers') or path.name != provider.id + '.token':
+                raise ValueError('invalid worker control token path')
+            token = path.read_text().strip()
+            if not 16 <= len(token) <= 512 or any(ord(x) < 33 or ord(x) > 126 for x in token):
+                raise ValueError('invalid worker control token')
+            headers['X-H3-Canary-Token'] = token
+        except (OSError, ValueError):
+            raise HTTPException(status_code=503, detail="生成节点控制配置未就绪，任务未提交")
+    return headers
+
+
+async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        if provider.id == 'gpu1_8189':
+            # Same physical card: finish old accepted jobs without moving or cancelling them.
+            legacy = providers().get('gpu1')
+            if legacy:
+                async with httpx.AsyncClient(timeout=5) as client:
+                    old = await client.get(f'{legacy.base_url}/queue', headers=provider_headers(legacy))
+                    old.raise_for_status()
+                    queue = old.json()
+                    if queue.get('queue_running') or queue.get('queue_pending'):
+                        return None
+                    stats = await client.get(f'{legacy.base_url}/system_stats', headers=provider_headers(legacy))
+                    stats.raise_for_status()
+                    devices = stats.json().get('devices')
+                    if not isinstance(devices, list) or not devices or any(
+                        not isinstance(d, dict) or type(d.get('torch_vram_total')) not in (int, float)
+                        or not 0 <= d['torch_vram_total'] < float('inf') for d in devices
+                    ):
+                        return None
+                    # An idle cudaMallocAsync worker retains ~2.2 GiB of persistent tensors.
+                    # Allow at most 4 GiB within the new worker's existing 8 GiB reserve;
+                    # active/queued legacy jobs still block above, and large caches drain below.
+                    if sum(d['torch_vram_total'] for d in devices) > 4 * 1024**3:
+                        # Release only idle model caches; queue contents and results stay intact.
+                        released = await client.post(f'{legacy.base_url}/free', json={'unload_models': True, 'free_memory': True}, headers=provider_headers(legacy))
+                        released.raise_for_status()
+                        return None
+        async with httpx.AsyncClient(timeout=5) as client:
+            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    except (httpx.HTTPError, ValueError, TypeError):
+        return None
+    return len(payload.get("queue_running") or []) + len(payload.get("queue_pending") or [])
+
+
+def admission_ids(configured: dict[str, Provider]) -> set[str]:
+    path = os.getenv("COMFY_ADMISSION_FILE", "").strip()
+    if not path:
+        return set(configured)
+    try:
+        raw = Path(path).read_bytes()
+        if len(raw) > 4096:
+            raise ValueError("oversized admission configuration")
+        value = json.loads(raw)
+        if not isinstance(value, dict):
+            raise ValueError("invalid admission configuration")
+        allowed = value.get("admit")
+        if type(value.get("schema")) is not int or value.get("schema") != 1 or not isinstance(allowed, list) or any(not isinstance(x, str) for x in allowed):
+            raise ValueError("invalid admission configuration")
+        if len(set(allowed)) != len(allowed) or not set(allowed) <= set(configured):
+            raise ValueError("unknown or duplicate admission provider")
+        return set(allowed)
+    except (OSError, ValueError, TypeError):
+        # Drain changes affect only new submissions; job lookup always retains
+        # both stable provider IDs and their existing history/output routes.
+        raise HTTPException(status_code=503, detail="生成服务正在切换，任务尚未提交，请稍后重试")
+
+
+async def select_provider(requested_provider_id: str, strict_provider: bool = False, huobao_panels: bool = False) -> Provider | None:
+    configured = providers()
+    admitted = admission_ids(configured)
+    if huobao_panels:
+        ports = {'default': 8188, 'gpu1_8189': 8189, 'gpu3': 8191}
+        configured = {key: replace(value, base_url=f'http://192.168.110.111:{ports[key]}') for key, value in configured.items() if key in ports}
+    else:
+        # Other applications retain their original worker selection.
+        configured = {key: value for key, value in configured.items() if key != 'gpu1_8189'}
+    requested = configured.get(requested_provider_id)
+    if requested is None:
+        return None
+    if strict_provider:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="指定显卡正在维护或排空，任务未提交；请稍后重试或选择自动分配")
+        if await provider_queue_depth(requested) is None:
+            raise HTTPException(status_code=503, detail=("GPU1 / 8189 暂不可用：旧 GPU1 任务或显存尚未释放，未取消原任务，也未提交新任务" if requested_provider_id == "gpu1_8189" else "指定显卡不可用或缺少所需工作流，任务未提交"))
+        return requested
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="该生成节点正在排空，现有任务继续执行，新任务请稍后提交")
+        return requested
+
+    candidates = [provider for provider in configured.values() if provider.id in admitted]
+    if not candidates:
+        raise HTTPException(status_code=503, detail="生成节点正在排空，现有任务和结果保持不变")
+    depths = await asyncio.gather(*(provider_queue_depth(provider) for provider in candidates))
+    available = [
+        (depth + provider_reservations.get(provider.id, 0), 0 if provider.id == requested_provider_id else 1, provider)
+        for provider, depth in zip(candidates, depths)
+        if depth is not None
+    ]
+    if not available:
+        if os.getenv("COMFY_ADMISSION_FILE", "").strip():
+            raise HTTPException(status_code=503, detail="生成节点尚未就绪，任务未提交，请稍后重试")
+        return requested
+    return min(available, key=lambda item: (item[0], item[1]))[2]
+
+
+async def reserve_provider(requested_provider_id: str, strict_provider: bool = False, huobao_panels: bool = False) -> Provider | None:
+    async with provider_selection_lock:
+        provider = await select_provider(requested_provider_id, strict_provider, huobao_panels)
+        if provider is not None:
+            provider_reservations[provider.id] = provider_reservations.get(provider.id, 0) + 1
+        return provider
+
+
+async def release_provider(provider: Provider) -> None:
+    async with provider_selection_lock:
+        remaining = provider_reservations.get(provider.id, 0) - 1
+        if remaining > 0:
+            provider_reservations[provider.id] = remaining
+        else:
+            provider_reservations.pop(provider.id, None)
+
+
+def input_host_allowlist() -> set[str]:
+    return {value.strip().lower().rstrip(".") for value in os.getenv("COMFY_INPUT_HOST_ALLOWLIST", "").split(",") if value.strip()}
+
+
+async def validate_input_url(value: str) -> None:
+    parsed = urlsplit(value)
+    host = (parsed.hostname or "").lower().rstrip(".")
+    if parsed.scheme not in {"http", "https"} or not host or parsed.username or parsed.password:
+        raise HTTPException(status_code=400, detail="reference image URL is invalid")
+    if host in input_host_allowlist():
+        return
+    try:
+        infos = await asyncio.to_thread(socket.getaddrinfo, host, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
+    except OSError as exc:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved") from exc
+    if not infos:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved")
+    for info in infos:
+        address = ipaddress.ip_address(info[4][0])
+        if not address.is_global:
+            raise HTTPException(status_code=400, detail="reference image URL cannot target a private address")
+
+
+async def download_input_image(client: httpx.AsyncClient, value: str) -> tuple[bytes, str]:
+    await validate_input_url(value)
+    chunks: list[bytes] = []
+    total = 0
+    async with client.stream("GET", value, follow_redirects=False) as response:
+        response.raise_for_status()
+        if 300 <= response.status_code < 400:
+            raise HTTPException(status_code=400, detail="reference image redirects are not accepted")
+        mime_type = response.headers.get("content-type", "image/png").split(";", 1)[0]
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference image URL did not return an image")
+        async for chunk in response.aiter_bytes():
+            total += len(chunk)
+            if total > 30 * 1024 * 1024:
+                raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+            chunks.append(chunk)
+    return b"".join(chunks), mime_type
+
+
+def encode_job(provider_id: str, prompt_id: str) -> str:
+    return base64.urlsafe_b64encode(f"{provider_id}:{prompt_id}".encode()).decode().rstrip("=")
+
+
+def decode_job(job_id: str) -> tuple[Provider, str]:
+    if job_id.startswith(("h3a1.", "h3v2.")):
+        job_id = job_id.split(".", 1)[1]
+    try:
+        raw = base64.urlsafe_b64decode(job_id + "=" * (-len(job_id) % 4)).decode()
+        provider_id, prompt_id = raw.split(":", 1)
+        provider = providers()[provider_id]
+    except Exception as exc:
+        raise HTTPException(status_code=404, detail="job not found") from exc
+    return provider, prompt_id
+
+
+def output_validation_mode() -> str:
+    mode = os.getenv("H3_OUTPUT_VALIDATION_MODE", "guarded").strip()
+    if mode not in {"guarded", "prompt-only"}:
+        raise HTTPException(status_code=503, detail="视频处理模式配置无效，任务未提交")
+    return mode
+
+
+@app.get("/health")
+async def health() -> dict[str, Any]:
+    return {
+        "status": "ok",
+        "providers": len(providers()),
+        "workflows": len(load_registry()),
+        "autoBalance": auto_balance_enabled(),
+        "outputValidationMode": output_validation_mode(),
+    }
+
+
+@app.get("/v1/providers", dependencies=[Depends(require_token)])
+async def list_providers() -> dict[str, Any]:
+    return {"providers": [{"id": item.id, "name": item.name, "baseUrl": item.base_url} for item in providers().values()]}
+
+
+@app.get("/v1/workflows", dependencies=[Depends(require_token)])
+async def list_workflows() -> dict[str, Any]:
+    return {"workflows": [public_workflow(item) for item in load_registry().values()]}
+
+
+@app.get("/v1/models", dependencies=[Depends(require_token)])
+async def list_models() -> dict[str, Any]:
+    return {"object": "list", "data": [public_model(item) for item in load_registry().values()]}
+
+
+async def upload_image(client: httpx.AsyncClient, provider: Provider, value: str, index: int, client_id: str) -> str:
+    value = value.strip()
+    if value.startswith("comfy://"):
+        return value.removeprefix("comfy://")
+    if value.startswith("data:"):
+        header, encoded = value.split(",", 1)
+        mime_type = header.split(";", 1)[0].removeprefix("data:") or "image/png"
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference data URL must contain an image")
+        try:
+            data = base64.b64decode(encoded, validate=True)
+        except (ValueError, base64.binascii.Error) as exc:
+            raise HTTPException(status_code=400, detail="reference image data URL is invalid") from exc
+    elif value.startswith(("http://", "https://")):
+        data, mime_type = await download_input_image(client, value)
+    else:
+        raise HTTPException(status_code=400, detail="input_images must contain http(s), data, or comfy URLs")
+    if len(data) > 30 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+    extension = mimetypes.guess_extension(mime_type) or ".png"
+    filename = f"{client_id}-reference-{index}{extension}"
+    response = await client.post(f"{provider.base_url}/upload/image", files={"image": (filename, data, mime_type)}, data={"overwrite": "true"}, headers=provider_headers(provider))
+    response.raise_for_status()
+    payload = response.json()
+    return str(payload.get("name") or filename)
+
+
+def request_audio_plan(spec, request: JobRequest) -> dict:
+    if not (spec.raw.get("speech_prompt_policy") == "minimax_h3" and spec.raw.get("native_audio_control")):
+        return {"supported": False}
+    if request.generate_audio is False:
+        return {"supported": True, "status": "ready", "normalized_prompt": request.prompt,
+                "dialogue_base_prompt": request.prompt, "dialogue": [], "sound_effects": [],
+                "music": [], "audio_mode": "silent", "silent": True, "speech_requested": False,
+                "expected_transcript": "", "required_seconds": 0, "max_duration_seconds": 15, "issues": []}
+    plan = plan_h3_audio(request.prompt, float(request.duration or 5))
+    if output_validation_mode() == "prompt-only" and not plan["silent"] and plan["audio_mode"] == "silent":
+        plan["audio_mode"] = "effects"
+    return {"supported": True, **plan}
+
+
+@app.post("/v1/audio-plan", dependencies=[Depends(require_token)])
+async def preview_audio_plan(request: JobRequest) -> dict:
+    spec = load_registry().get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    return request_audio_plan(spec, request)
+
+
+@app.post("/v1/jobs", dependencies=[Depends(require_token)])
+async def create_job(request: JobRequest) -> dict[str, Any]:
+    registry = load_registry()
+    spec = registry.get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    try:
+        validate_h3_references(spec, len(request.input_images))
+    except ValueError as error:
+        raise HTTPException(status_code=400, detail=str(error)) from error
+    audio_plan = request_audio_plan(spec, request)
+    guarded_output = bool(audio_plan.get("supported")) and output_validation_mode() == "guarded"
+    if audio_plan.get("supported"):
+        if audio_plan.get("status") != "ready":
+            raise HTTPException(status_code=400, detail="H3_AUDIO_CONFIRMATION_REQUIRED: 请先确认台词及视频时长，再提交视频生成")
+        if not guarded_output:
+            request = request.model_copy(update={"prompt": audio_plan["normalized_prompt"]})
+        try:
+            if guarded_output:
+                validate_visual_dimensions(request.width, request.height)
+                await audio_validator.ready(visual_required=True, audio_required=audio_plan.get("audio_mode") in {"dialogue", "effects"})
+                if audio_plan.get("audio_mode") in {"dialogue", "effects"}:
+                    prompt = await prepare_audio_conditioning(audio_plan, request.prompt, float(request.duration or 5), len(request.input_images))
+                    request = request.model_copy(update={"prompt": prompt})
+        except AudioQualityError as error:
+            raise HTTPException(status_code=503 if error.code.endswith("_UNAVAILABLE") else 400, detail=str(error)) from error
+        except AudioConditioningError as error:
+            raise HTTPException(status_code=503 if error.code == "H3_AUDIO_NORMALIZER_UNAVAILABLE" else 400, detail=str(error)) from error
+    provider = await reserve_provider(request.provider_id, request.strict_provider, request.huobao_panels)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="provider is not configured")
+    try:
+        client_id = ("canvas-h3v2-" if guarded_output else "canvas-") + secrets.token_hex(8)
+        async with httpx.AsyncClient(timeout=60) as client:
+            uploaded = [await upload_image(client, provider, value, index, client_id) for index, value in enumerate(request.input_images, start=1)]
+            try:
+                workflow = compile_workflow(spec, request.model_dump(), uploaded, client_id, preserve_requested_audio=not guarded_output and bool(audio_plan.get("supported")))
+                if guarded_output:
+                    attach_audio_policy(workflow, audio_plan, float(request.duration or 5), str(spec.raw.get("save_node")), visual_required=True)
+            except ValueError as exc:
+                raise HTTPException(status_code=400, detail=str(exc)) from exc
+            response = await client.post(f"{provider.base_url}/prompt", json={"prompt": workflow, "client_id": client_id}, headers=provider_headers(provider))
+            if response.status_code == 400 and spec.raw.get("speech_prompt_policy") == "minimax_h3":
+                try:
+                    rejected = response.json()
+                except ValueError:
+                    rejected = {}
+                if "h3_caption_pipeline" in (rejected.get("node_errors") or {}) or "H3CaptionPipeline" in str((rejected.get("error") or {}).get("details") or ""):
+                    raise HTTPException(status_code=503, detail="字幕工作流预检未通过，处理组件、模型或字体尚未就绪；任务未进入 GPU 生成，请联系管理员。")
+            response.raise_for_status()
+            payload = response.json()
+    finally:
+        await release_provider(provider)
+    prompt_id = str(payload.get("prompt_id") or "").strip()
+    if not prompt_id:
+        raise HTTPException(status_code=502, detail="ComfyUI did not return prompt_id")
+    job_id = encode_job(provider.id, prompt_id)
+    persisted = True
+    if guarded_output:
+        job_id = "h3v2." + job_id
+        try:
+            audio_validator.register_policy(job_id, audio_plan, float(request.duration or 5), visual_required=True)
+        except AudioQualityError as error:
+            raise HTTPException(status_code=502, detail=str(error)) from error
+        except OSError:
+            # The provider already accepted this exact job. Return its ID rather
+            # than an ambiguous 500 inviting another GPU submission. Its graph
+            # carries the same policy; missing evidence still fails closed.
+            persisted = False
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "workflowKey": spec.key, "workflowRevision": spec.revision, "status": "submitted", "policyPersisted": persisted}
+
+
+def extract_outputs(entry: dict[str, Any], job_id: str) -> list[dict[str, Any]]:
+    result: list[dict[str, Any]] = []
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if not isinstance(item, dict) or not item.get("filename"):
+                    continue
+                filename = str(item["filename"])
+                mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                kind = "video" if mime_type.startswith("video/") or filename.lower().endswith((".gif", ".webp")) and field == "gifs" else "audio" if mime_type.startswith("audio/") else "image"
+                index = len(result)
+                result.append({"index": index, "kind": kind, "mimeType": mime_type, "filename": filename, "url": f"/jobs/{quote(job_id, safe='')}/outputs/{index}"})
+    return result
+
+
+async def job_state(job_id: str) -> tuple[Provider, str, dict[str, Any], list[dict[str, Any]]]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.get(f"{provider.base_url}/history/{quote(prompt_id, safe='')}", headers=provider_headers(provider))
+        response.raise_for_status()
+        history = response.json()
+    entry = history.get(prompt_id) or {}
+    outputs = extract_outputs(entry, job_id)
+    return provider, prompt_id, entry, outputs
+
+
+@app.get("/v1/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def get_job(job_id: str) -> dict[str, Any]:
+    try:
+        provider, prompt_id, entry, outputs = await job_state(job_id)
+    except httpx.TimeoutException:
+        provider, prompt_id = decode_job(job_id)
+        return {
+            "id": job_id,
+            "promptId": prompt_id,
+            "providerId": provider.id,
+            "status": "running",
+            "outputs": [],
+            "error": "",
+            "pollDeferred": True,
+        }
+    status_payload = entry.get("status") or {}
+    if status_payload.get("status_str") == "error":
+        status = "failed"
+    elif outputs and not (job_id.startswith("h3v2.") and not status_payload.get("completed")):
+        status = "succeeded"
+    elif status_payload.get("completed"):
+        status = "failed"
+    else:
+        status = "running"
+    if job_id.startswith("h3v2.") and status != "succeeded":
+        outputs = []
+    if status != "succeeded" and cancellation_dispatched(job_id):
+        # An acknowledged interrupt is not terminal until this exact prompt
+        # disappears from the worker queue. Never infer it from HTTP 200 alone.
+        try:
+            async with httpx.AsyncClient(timeout=10) as client:
+                response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+                response.raise_for_status()
+                queue = response.json()
+            if not isinstance(queue, dict) or not isinstance(queue.get("queue_running"), list) or not isinstance(queue.get("queue_pending"), list):
+                raise ValueError("invalid queue response")
+            remaining = {str(item[1]) for item in queue["queue_running"] + queue["queue_pending"] if isinstance(item, list) and len(item) > 1}
+            if prompt_id not in remaining:
+                status, outputs = "cancelled", []
+            else:
+                return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在取消生成", "cancelRequested": True}
+        except (httpx.HTTPError, ValueError):
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在确认取消", "cancelRequested": True}
+    error = "ComfyUI execution failed" if status == "failed" else ""
+    if status == "failed":
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            # 只映射已识别的内核错误，不向用户返回节点输入、提示词或 traceback。
+            if "tensor strides exceed int32 range" in str(event[1].get("exception_message") or ""):
+                error = "当前时长与分辨率组合超出采样内核范围，请缩短时长后重试（最多 15 秒）"
+                break
+    if status == "failed":
+        hints = {
+            "H3_SUBTITLE_MASK_UNCERTAIN": "检测到疑似字幕，但无法安全区分字幕和产品文字，任务已停止，未返回未清理视频。",
+            "H3_SUBTITLE_RESIDUAL": "字幕清理后仍检测到残留，任务已停止，避免生成双层字幕。",
+            "H3_SPEECH_MISMATCH": "实际口播与原台词不一致，未生成误导字幕；请缩短台词或调整后重试。",
+            "H3_SUBTITLE_ALIGNMENT": "口播时间轴校验未通过，无法准确烧录字幕；请缩短单句台词后重试。",
+            "H3_SUBTITLE_FONT": "字幕含字体不支持的字符，已停止以避免乱码；请使用常见文字。",
+            "H3_SUBTITLE_DEPENDENCY": "字幕处理服务依赖未就绪，请联系管理员；原任务未自动重试。",
+            "H3_SUBTITLE_FRAME_COUNT": "字幕处理前后帧数或尺寸不一致，已停止输出，请联系管理员。",
+        }
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            message = str(event[1].get("exception_message") or "")
+            for code, hint in hints.items():
+                if message.startswith(code + ":"):
+                    error = hint
+                    break
+        # Never expose a partial/raw output from a failed cleanup/quality gate.
+        outputs = []
+    if status == "succeeded":
+        quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+        if quality["status"] in {"pending", "unavailable"}:
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running",
+                    "outputs": [], "error": "", "stage": "正在校验字幕与音轨" if job_id.startswith("h3v2.") or quality.get("visual_required") else "正在校验视频音轨", "pollDeferred": True}
+        if quality["status"] == "failed":
+            status, outputs, error = "failed", [], quality["error"]
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": status, "outputs": outputs, "error": error}
+
+
+@app.post("/v1/jobs/{job_id}/cancel", dependencies=[Depends(require_token)])
+async def cancel_job(job_id: str) -> dict[str, Any]:
+    provider, prompt_id = decode_job(job_id)
+    # Write intent before sending; disk failure must not produce an untracked
+    # cancellation. The worker API atomically compares the running prompt ID.
+    record_cancellation(job_id, False)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.post(f"{provider.base_url}/api/jobs/{quote(prompt_id, safe='')}/cancel", json={}, headers=provider_headers(provider))
+        if response.status_code in (404, 405):
+            raise HTTPException(status_code=409, detail="生成节点未提供按任务取消接口，未中断其他任务")
+        response.raise_for_status()
+        acknowledged = response.json().get("cancelled")
+        if type(acknowledged) is not bool:
+            raise HTTPException(status_code=502, detail="生成节点取消回执无效，请核对原任务状态")
+        if acknowledged:
+            record_cancellation(job_id, True)
+    return await get_job(job_id)
+
+
+@app.get("/v1/jobs/{job_id}/outputs/{index}", dependencies=[Depends(require_token)])
+async def get_output(job_id: str, index: int) -> Response:
+    provider, _, entry, outputs = await job_state(job_id)
+    if (entry.get("status") or {}).get("status_str") == "error":
+        raise HTTPException(status_code=409, detail="任务未成功，未返回部分输出")
+    if not outputs or job_id.startswith("h3v2.") and not (entry.get("status") or {}).get("completed"):
+        raise HTTPException(status_code=409, detail="视频生成尚未完成，未返回部分输出")
+    quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+    if quality["status"] != "verified":
+        raise HTTPException(status_code=422 if quality["status"] == "failed" else 409,
+                            detail=quality.get("error", "视频核验尚未完成，请稍后查询原任务"))
+    if index < 0 or index >= len(outputs):
+        raise HTTPException(status_code=404, detail="output not found")
+    wanted = outputs[index]
+    locator: dict[str, Any] | None = None
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if isinstance(item, dict) and str(item.get("filename")) == wanted["filename"]:
+                    locator = item
+                    break
+            if locator: break
+        if locator: break
+    if locator is None:
+        raise HTTPException(status_code=404, detail="output locator not found")
+    if quality.get("visual_revision") == VISUAL_REVISION:
+        bound_locator = {key: locator.get(key, "output" if key == "type" else "") for key in ("filename", "subfolder", "type")}
+        try:
+            media = await audio_validator.verified_download(quality, bound_locator, provider.base_url, provider_headers(provider))
+        except AudioQualityError as error:
+            raise HTTPException(status_code=422, detail=str(error)) from error
+        except (httpx.HTTPError, OSError, asyncio.TimeoutError):
+            raise HTTPException(status_code=503, detail="H3_VISUAL_VALIDATION_UNAVAILABLE: 已核验视频暂不可读取，请查询原任务") from None
+        return Response(content=media, media_type=wanted["mimeType"], headers={"Cache-Control": "private, no-store"})
+    query = urlencode({"filename": locator.get("filename", ""), "subfolder": locator.get("subfolder", ""), "type": locator.get("type", "output")})
+    client = httpx.AsyncClient(timeout=120)
+    response = await client.send(client.build_request("GET", f"{provider.base_url}/view?{query}", headers=provider_headers(provider)), stream=True)
+    if response.status_code >= 400:
+        await response.aclose(); await client.aclose()
+        raise HTTPException(status_code=502, detail="failed to read ComfyUI output")
+    async def stream():
+        try:
+            async for chunk in response.aiter_bytes():
+                yield chunk
+        finally:
+            await response.aclose(); await client.aclose()
+    return StreamingResponse(stream(), media_type=response.headers.get("content-type", wanted["mimeType"]))
+
+@app.post("/v1/huobao/route", dependencies=[Depends(require_token)])
+async def huobao_route(request: JobRequest) -> dict[str, Any]:
+    provider = await select_provider(request.provider_id, request.strict_provider, True)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="unknown requested worker")
+    return {"providerId": provider.id, "baseUrl": provider.base_url, "ready": True}
+
+
+
+@app.get("/v1/huobao/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def huobao_job_status(job_id: str) -> dict[str, Any]:
+    # Keep the general API contract unchanged; Huobao needs actual queue state.
+    result = await get_job(job_id)
+    if result.get("status") != "running":
+        return {**result, "worker_state": result.get("status")}
+    if result.get("pollDeferred"):
+        return {**result, "worker_state": "checking"}
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=10) as client:
+        response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+        response.raise_for_status()
+        queue = response.json()
+    running = [row[1] for row in queue.get("queue_running", [])]
+    pending = [row[1] for row in queue.get("queue_pending", [])]
+    if prompt_id in running:
+        return {**result, "worker_state": "running"}
+    if prompt_id in pending:
+        return {**result, "worker_state": "queued", "queue_position": pending.index(prompt_id) + 1}
+    # A task may finish between the first history read and the queue read.
+    fresh = await get_job(job_id)
+    if fresh.get("status") != "running":
+        return {**fresh, "worker_state": fresh.get("status")}
+    if fresh.get("pollDeferred"):
+        return {**fresh, "worker_state": "checking"}
+    # Do not invent success/failure or submit again when a worker has lost history.
+    return {**fresh, "worker_state": "missing"}
diff --git a/integration-work/gpu_queue_status.py b/integration-work/gpu_queue_status.py
new file mode 100644
index 0000000..a883b9c
--- /dev/null
+++ b/integration-work/gpu_queue_status.py
@@ -0,0 +1,10 @@
+import subprocess
+code='''import asyncio,httpx,json,app
+async def main():
+ async with httpx.AsyncClient(timeout=20) as c:
+  for p in app.providers().values():
+   q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+   print(p.id,json.dumps({k:[{'id':x[1],'nodes':sorted({n['class_type'] for n in x[2].values() if isinstance(n,dict) and 'class_type' in n})} for x in q.get(k,[])] for k in ('queue_running','queue_pending')}))
+asyncio.run(main())
+'''
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
diff --git a/integration-work/h3-current-app.py b/integration-work/h3-current-app.py
new file mode 100644
index 0000000..9fad613
--- /dev/null
+++ b/integration-work/h3-current-app.py
@@ -0,0 +1,572 @@
+from __future__ import annotations
+
+import base64
+import asyncio
+import ipaddress
+import json
+import mimetypes
+import os
+import secrets
+import socket
+from pathlib import Path
+from job_cancellation import dispatched as cancellation_dispatched, record as record_cancellation
+from dataclasses import dataclass
+from typing import Any
+from urllib.parse import quote, urlencode, urlsplit
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Response
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel, Field
+
+from workflow import MAX_VIDEO_DURATION_SECONDS, compile_workflow, load_registry, public_model, public_workflow, validate_h3_references
+from h3_audio_intent import plan_h3_audio
+from h3_audio_validation import AudioOutputValidator, attach_audio_policy
+from h3_visual_guard import VISUAL_REVISION, validate_visual_dimensions
+from h3_audio_conditioning import AudioConditioningError, prepare_audio_conditioning
+from h3_audio_output_guard import AudioQualityError
+
+
+@dataclass(frozen=True)
+class Provider:
+    id: str
+    name: str
+    base_url: str
+    api_key: str = ""
+    control_token_file: str = ""
+
+
+class JobRequest(BaseModel):
+    provider_id: str = "default"
+    workflow_key: str
+    prompt: str
+    negative_prompt: str = ""
+    input_images: list[str] = Field(default_factory=list, max_length=9)
+    width: int | None = Field(default=None, ge=64, le=8192)
+    height: int | None = Field(default=None, ge=64, le=8192)
+    duration: float | None = Field(default=None, gt=0, le=MAX_VIDEO_DURATION_SECONDS)
+    generate_audio: bool | None = None
+    seed: int | None = Field(default=None, ge=0)
+    batch_size: int = Field(default=1, ge=1, le=4)
+    denoise: float | None = Field(default=None, ge=0, le=1)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+app = FastAPI(title="Canvas ComfyUI Workflow Adapter", version="1.0.0")
+audio_validator = AudioOutputValidator()
+provider_selection_lock = asyncio.Lock()
+provider_reservations: dict[str, int] = {}
+
+
+def auto_balance_enabled() -> bool:
+    return os.getenv("COMFY_AUTO_BALANCE", "").strip().lower() in {"1", "true", "yes", "on"}
+
+
+def providers() -> dict[str, Provider]:
+    raw = os.getenv("COMFY_PROVIDERS_JSON", "").strip()
+    rows: list[dict[str, Any]] = []
+    if raw:
+        parsed = json.loads(raw)
+        rows = parsed if isinstance(parsed, list) else []
+    elif os.getenv("COMFY_URL", "").strip():
+        rows = [{"id": "default", "name": "ComfyUI", "base_url": os.getenv("COMFY_URL"), "api_key": os.getenv("COMFY_API_KEY", "")}]
+    result: dict[str, Provider] = {}
+    for row in rows:
+        provider = Provider(id=str(row.get("id") or "").strip(), name=str(row.get("name") or row.get("id") or "ComfyUI"), base_url=str(row.get("base_url") or "").strip().rstrip("/"), api_key=str(row.get("api_key") or ""), control_token_file=str(row.get("control_token_file") or ""))
+        if provider.id and provider.base_url.startswith(("http://", "https://")):
+            result[provider.id] = provider
+    return result
+
+
+def require_token(authorization: str | None = Header(default=None)) -> None:
+    expected = os.getenv("COMFY_ADAPTER_TOKEN", "").strip()
+    if expected and not secrets.compare_digest(authorization or "", f"Bearer {expected}"):
+        raise HTTPException(status_code=401, detail="invalid adapter token")
+
+
+def provider_headers(provider: Provider) -> dict[str, str]:
+    headers = {"Authorization": f"Bearer {provider.api_key}"} if provider.api_key else {}
+    if provider.control_token_file:
+        path = Path(provider.control_token_file)
+        try:
+            # Operator-mounted token only; it is never accepted from JobRequest
+            # or exposed by the public provider catalogue.
+            if path.parent != Path('/run/h3-workers') or path.name != provider.id + '.token':
+                raise ValueError('invalid worker control token path')
+            token = path.read_text().strip()
+            if not 16 <= len(token) <= 512 or any(ord(x) < 33 or ord(x) > 126 for x in token):
+                raise ValueError('invalid worker control token')
+            headers['X-H3-Canary-Token'] = token
+        except (OSError, ValueError):
+            raise HTTPException(status_code=503, detail="生成节点控制配置未就绪，任务未提交")
+    return headers
+
+
+async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        async with httpx.AsyncClient(timeout=5) as client:
+            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    except (httpx.HTTPError, ValueError, TypeError):
+        return None
+    return len(payload.get("queue_running") or []) + len(payload.get("queue_pending") or [])
+
+
+def admission_ids(configured: dict[str, Provider]) -> set[str]:
+    path = os.getenv("COMFY_ADMISSION_FILE", "").strip()
+    if not path:
+        return set(configured)
+    try:
+        raw = Path(path).read_bytes()
+        if len(raw) > 4096:
+            raise ValueError("oversized admission configuration")
+        value = json.loads(raw)
+        if not isinstance(value, dict):
+            raise ValueError("invalid admission configuration")
+        allowed = value.get("admit")
+        if type(value.get("schema")) is not int or value.get("schema") != 1 or not isinstance(allowed, list) or any(not isinstance(x, str) for x in allowed):
+            raise ValueError("invalid admission configuration")
+        if len(set(allowed)) != len(allowed) or not set(allowed) <= set(configured):
+            raise ValueError("unknown or duplicate admission provider")
+        return set(allowed)
+    except (OSError, ValueError, TypeError):
+        # Drain changes affect only new submissions; job lookup always retains
+        # both stable provider IDs and their existing history/output routes.
+        raise HTTPException(status_code=503, detail="生成服务正在切换，任务尚未提交，请稍后重试")
+
+
+async def select_provider(requested_provider_id: str) -> Provider | None:
+    configured = providers()
+    requested = configured.get(requested_provider_id)
+    admitted = admission_ids(configured)
+    if requested is None:
+        return None
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="该生成节点正在排空，现有任务继续执行，新任务请稍后提交")
+        return requested
+
+    candidates = [provider for provider in configured.values() if provider.id in admitted]
+    if not candidates:
+        raise HTTPException(status_code=503, detail="生成节点正在排空，现有任务和结果保持不变")
+    depths = await asyncio.gather(*(provider_queue_depth(provider) for provider in candidates))
+    available = [
+        (depth + provider_reservations.get(provider.id, 0), 0 if provider.id == requested_provider_id else 1, provider)
+        for provider, depth in zip(candidates, depths)
+        if depth is not None
+    ]
+    if not available:
+        if os.getenv("COMFY_ADMISSION_FILE", "").strip():
+            raise HTTPException(status_code=503, detail="生成节点尚未就绪，任务未提交，请稍后重试")
+        return requested
+    return min(available, key=lambda item: (item[0], item[1]))[2]
+
+
+async def reserve_provider(requested_provider_id: str) -> Provider | None:
+    async with provider_selection_lock:
+        provider = await select_provider(requested_provider_id)
+        if provider is not None:
+            provider_reservations[provider.id] = provider_reservations.get(provider.id, 0) + 1
+        return provider
+
+
+async def release_provider(provider: Provider) -> None:
+    async with provider_selection_lock:
+        remaining = provider_reservations.get(provider.id, 0) - 1
+        if remaining > 0:
+            provider_reservations[provider.id] = remaining
+        else:
+            provider_reservations.pop(provider.id, None)
+
+
+def input_host_allowlist() -> set[str]:
+    return {value.strip().lower().rstrip(".") for value in os.getenv("COMFY_INPUT_HOST_ALLOWLIST", "").split(",") if value.strip()}
+
+
+async def validate_input_url(value: str) -> None:
+    parsed = urlsplit(value)
+    host = (parsed.hostname or "").lower().rstrip(".")
+    if parsed.scheme not in {"http", "https"} or not host or parsed.username or parsed.password:
+        raise HTTPException(status_code=400, detail="reference image URL is invalid")
+    if host in input_host_allowlist():
+        return
+    try:
+        infos = await asyncio.to_thread(socket.getaddrinfo, host, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
+    except OSError as exc:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved") from exc
+    if not infos:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved")
+    for info in infos:
+        address = ipaddress.ip_address(info[4][0])
+        if not address.is_global:
+            raise HTTPException(status_code=400, detail="reference image URL cannot target a private address")
+
+
+async def download_input_image(client: httpx.AsyncClient, value: str) -> tuple[bytes, str]:
+    await validate_input_url(value)
+    chunks: list[bytes] = []
+    total = 0
+    async with client.stream("GET", value, follow_redirects=False) as response:
+        response.raise_for_status()
+        if 300 <= response.status_code < 400:
+            raise HTTPException(status_code=400, detail="reference image redirects are not accepted")
+        mime_type = response.headers.get("content-type", "image/png").split(";", 1)[0]
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference image URL did not return an image")
+        async for chunk in response.aiter_bytes():
+            total += len(chunk)
+            if total > 30 * 1024 * 1024:
+                raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+            chunks.append(chunk)
+    return b"".join(chunks), mime_type
+
+
+def encode_job(provider_id: str, prompt_id: str) -> str:
+    return base64.urlsafe_b64encode(f"{provider_id}:{prompt_id}".encode()).decode().rstrip("=")
+
+
+def decode_job(job_id: str) -> tuple[Provider, str]:
+    if job_id.startswith(("h3a1.", "h3v2.")):
+        job_id = job_id.split(".", 1)[1]
+    try:
+        raw = base64.urlsafe_b64decode(job_id + "=" * (-len(job_id) % 4)).decode()
+        provider_id, prompt_id = raw.split(":", 1)
+        provider = providers()[provider_id]
+    except Exception as exc:
+        raise HTTPException(status_code=404, detail="job not found") from exc
+    return provider, prompt_id
+
+
+def output_validation_mode() -> str:
+    mode = os.getenv("H3_OUTPUT_VALIDATION_MODE", "guarded").strip()
+    if mode not in {"guarded", "prompt-only"}:
+        raise HTTPException(status_code=503, detail="视频处理模式配置无效，任务未提交")
+    return mode
+
+
+@app.get("/health")
+async def health() -> dict[str, Any]:
+    return {
+        "status": "ok",
+        "providers": len(providers()),
+        "workflows": len(load_registry()),
+        "autoBalance": auto_balance_enabled(),
+        "outputValidationMode": output_validation_mode(),
+    }
+
+
+@app.get("/v1/providers", dependencies=[Depends(require_token)])
+async def list_providers() -> dict[str, Any]:
+    return {"providers": [{"id": item.id, "name": item.name, "baseUrl": item.base_url} for item in providers().values()]}
+
+
+@app.get("/v1/workflows", dependencies=[Depends(require_token)])
+async def list_workflows() -> dict[str, Any]:
+    return {"workflows": [public_workflow(item) for item in load_registry().values()]}
+
+
+@app.get("/v1/models", dependencies=[Depends(require_token)])
+async def list_models() -> dict[str, Any]:
+    return {"object": "list", "data": [public_model(item) for item in load_registry().values()]}
+
+
+async def upload_image(client: httpx.AsyncClient, provider: Provider, value: str, index: int, client_id: str) -> str:
+    value = value.strip()
+    if value.startswith("comfy://"):
+        return value.removeprefix("comfy://")
+    if value.startswith("data:"):
+        header, encoded = value.split(",", 1)
+        mime_type = header.split(";", 1)[0].removeprefix("data:") or "image/png"
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference data URL must contain an image")
+        try:
+            data = base64.b64decode(encoded, validate=True)
+        except (ValueError, base64.binascii.Error) as exc:
+            raise HTTPException(status_code=400, detail="reference image data URL is invalid") from exc
+    elif value.startswith(("http://", "https://")):
+        data, mime_type = await download_input_image(client, value)
+    else:
+        raise HTTPException(status_code=400, detail="input_images must contain http(s), data, or comfy URLs")
+    if len(data) > 30 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+    extension = mimetypes.guess_extension(mime_type) or ".png"
+    filename = f"{client_id}-reference-{index}{extension}"
+    response = await client.post(f"{provider.base_url}/upload/image", files={"image": (filename, data, mime_type)}, data={"overwrite": "true"}, headers=provider_headers(provider))
+    response.raise_for_status()
+    payload = response.json()
+    return str(payload.get("name") or filename)
+
+
+def request_audio_plan(spec, request: JobRequest) -> dict:
+    if not (spec.raw.get("speech_prompt_policy") == "minimax_h3" and spec.raw.get("native_audio_control")):
+        return {"supported": False}
+    if request.generate_audio is False:
+        return {"supported": True, "status": "ready", "normalized_prompt": request.prompt,
+                "dialogue_base_prompt": request.prompt, "dialogue": [], "sound_effects": [],
+                "music": [], "audio_mode": "silent", "silent": True, "speech_requested": False,
+                "expected_transcript": "", "required_seconds": 0, "max_duration_seconds": 15, "issues": []}
+    plan = plan_h3_audio(request.prompt, float(request.duration or 5))
+    if output_validation_mode() == "prompt-only" and not plan["silent"] and plan["audio_mode"] == "silent":
+        plan["audio_mode"] = "effects"
+    return {"supported": True, **plan}
+
+
+@app.post("/v1/audio-plan", dependencies=[Depends(require_token)])
+async def preview_audio_plan(request: JobRequest) -> dict:
+    spec = load_registry().get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    return request_audio_plan(spec, request)
+
+
+@app.post("/v1/jobs", dependencies=[Depends(require_token)])
+async def create_job(request: JobRequest) -> dict[str, Any]:
+    registry = load_registry()
+    spec = registry.get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    try:
+        validate_h3_references(spec, len(request.input_images))
+    except ValueError as error:
+        raise HTTPException(status_code=400, detail=str(error)) from error
+    audio_plan = request_audio_plan(spec, request)
+    guarded_output = bool(audio_plan.get("supported")) and output_validation_mode() == "guarded"
+    if audio_plan.get("supported"):
+        if audio_plan.get("status") != "ready":
+            raise HTTPException(status_code=400, detail="H3_AUDIO_CONFIRMATION_REQUIRED: 请先确认台词及视频时长，再提交视频生成")
+        if not guarded_output:
+            request = request.model_copy(update={"prompt": audio_plan["normalized_prompt"]})
+        try:
+            if guarded_output:
+                validate_visual_dimensions(request.width, request.height)
+                await audio_validator.ready(visual_required=True, audio_required=audio_plan.get("audio_mode") in {"dialogue", "effects"})
+                if audio_plan.get("audio_mode") in {"dialogue", "effects"}:
+                    prompt = await prepare_audio_conditioning(audio_plan, request.prompt, float(request.duration or 5), len(request.input_images))
+                    request = request.model_copy(update={"prompt": prompt})
+        except AudioQualityError as error:
+            raise HTTPException(status_code=503 if error.code.endswith("_UNAVAILABLE") else 400, detail=str(error)) from error
+        except AudioConditioningError as error:
+            raise HTTPException(status_code=503 if error.code == "H3_AUDIO_NORMALIZER_UNAVAILABLE" else 400, detail=str(error)) from error
+    provider = await reserve_provider(request.provider_id)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="provider is not configured")
+    try:
+        client_id = ("canvas-h3v2-" if guarded_output else "canvas-") + secrets.token_hex(8)
+        async with httpx.AsyncClient(timeout=60) as client:
+            uploaded = [await upload_image(client, provider, value, index, client_id) for index, value in enumerate(request.input_images, start=1)]
+            try:
+                workflow = compile_workflow(spec, request.model_dump(), uploaded, client_id, preserve_requested_audio=not guarded_output and bool(audio_plan.get("supported")))
+                if guarded_output:
+                    attach_audio_policy(workflow, audio_plan, float(request.duration or 5), str(spec.raw.get("save_node")), visual_required=True)
+            except ValueError as exc:
+                raise HTTPException(status_code=400, detail=str(exc)) from exc
+            response = await client.post(f"{provider.base_url}/prompt", json={"prompt": workflow, "client_id": client_id}, headers=provider_headers(provider))
+            if response.status_code == 400 and spec.raw.get("speech_prompt_policy") == "minimax_h3":
+                try:
+                    rejected = response.json()
+                except ValueError:
+                    rejected = {}
+                if "h3_caption_pipeline" in (rejected.get("node_errors") or {}) or "H3CaptionPipeline" in str((rejected.get("error") or {}).get("details") or ""):
+                    raise HTTPException(status_code=503, detail="字幕工作流预检未通过，处理组件、模型或字体尚未就绪；任务未进入 GPU 生成，请联系管理员。")
+            response.raise_for_status()
+            payload = response.json()
+    finally:
+        await release_provider(provider)
+    prompt_id = str(payload.get("prompt_id") or "").strip()
+    if not prompt_id:
+        raise HTTPException(status_code=502, detail="ComfyUI did not return prompt_id")
+    job_id = encode_job(provider.id, prompt_id)
+    persisted = True
+    if guarded_output:
+        job_id = "h3v2." + job_id
+        try:
+            audio_validator.register_policy(job_id, audio_plan, float(request.duration or 5), visual_required=True)
+        except AudioQualityError as error:
+            raise HTTPException(status_code=502, detail=str(error)) from error
+        except OSError:
+            # The provider already accepted this exact job. Return its ID rather
+            # than an ambiguous 500 inviting another GPU submission. Its graph
+            # carries the same policy; missing evidence still fails closed.
+            persisted = False
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "workflowKey": spec.key, "workflowRevision": spec.revision, "status": "submitted", "policyPersisted": persisted}
+
+
+def extract_outputs(entry: dict[str, Any], job_id: str) -> list[dict[str, Any]]:
+    result: list[dict[str, Any]] = []
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if not isinstance(item, dict) or not item.get("filename"):
+                    continue
+                filename = str(item["filename"])
+                mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                kind = "video" if mime_type.startswith("video/") or filename.lower().endswith((".gif", ".webp")) and field == "gifs" else "audio" if mime_type.startswith("audio/") else "image"
+                index = len(result)
+                result.append({"index": index, "kind": kind, "mimeType": mime_type, "filename": filename, "url": f"/jobs/{quote(job_id, safe='')}/outputs/{index}"})
+    return result
+
+
+async def job_state(job_id: str) -> tuple[Provider, str, dict[str, Any], list[dict[str, Any]]]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.get(f"{provider.base_url}/history/{quote(prompt_id, safe='')}", headers=provider_headers(provider))
+        response.raise_for_status()
+        history = response.json()
+    entry = history.get(prompt_id) or {}
+    outputs = extract_outputs(entry, job_id)
+    return provider, prompt_id, entry, outputs
+
+
+@app.get("/v1/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def get_job(job_id: str) -> dict[str, Any]:
+    try:
+        provider, prompt_id, entry, outputs = await job_state(job_id)
+    except httpx.TimeoutException:
+        provider, prompt_id = decode_job(job_id)
+        return {
+            "id": job_id,
+            "promptId": prompt_id,
+            "providerId": provider.id,
+            "status": "running",
+            "outputs": [],
+            "error": "",
+            "pollDeferred": True,
+        }
+    status_payload = entry.get("status") or {}
+    if status_payload.get("status_str") == "error":
+        status = "failed"
+    elif outputs and not (job_id.startswith("h3v2.") and not status_payload.get("completed")):
+        status = "succeeded"
+    elif status_payload.get("completed"):
+        status = "failed"
+    else:
+        status = "running"
+    if job_id.startswith("h3v2.") and status != "succeeded":
+        outputs = []
+    if status != "succeeded" and cancellation_dispatched(job_id):
+        # An acknowledged interrupt is not terminal until this exact prompt
+        # disappears from the worker queue. Never infer it from HTTP 200 alone.
+        try:
+            async with httpx.AsyncClient(timeout=10) as client:
+                response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+                response.raise_for_status()
+                queue = response.json()
+            if not isinstance(queue, dict) or not isinstance(queue.get("queue_running"), list) or not isinstance(queue.get("queue_pending"), list):
+                raise ValueError("invalid queue response")
+            remaining = {str(item[1]) for item in queue["queue_running"] + queue["queue_pending"] if isinstance(item, list) and len(item) > 1}
+            if prompt_id not in remaining:
+                status, outputs = "cancelled", []
+            else:
+                return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在取消生成", "cancelRequested": True}
+        except (httpx.HTTPError, ValueError):
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在确认取消", "cancelRequested": True}
+    error = "ComfyUI execution failed" if status == "failed" else ""
+    if status == "failed":
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            # 只映射已识别的内核错误，不向用户返回节点输入、提示词或 traceback。
+            if "tensor strides exceed int32 range" in str(event[1].get("exception_message") or ""):
+                error = "当前时长与分辨率组合超出采样内核范围，请缩短时长后重试（最多 15 秒）"
+                break
+    if status == "failed":
+        hints = {
+            "H3_SUBTITLE_MASK_UNCERTAIN": "检测到疑似字幕，但无法安全区分字幕和产品文字，任务已停止，未返回未清理视频。",
+            "H3_SUBTITLE_RESIDUAL": "字幕清理后仍检测到残留，任务已停止，避免生成双层字幕。",
+            "H3_SPEECH_MISMATCH": "实际口播与原台词不一致，未生成误导字幕；请缩短台词或调整后重试。",
+            "H3_SUBTITLE_ALIGNMENT": "口播时间轴校验未通过，无法准确烧录字幕；请缩短单句台词后重试。",
+            "H3_SUBTITLE_FONT": "字幕含字体不支持的字符，已停止以避免乱码；请使用常见文字。",
+            "H3_SUBTITLE_DEPENDENCY": "字幕处理服务依赖未就绪，请联系管理员；原任务未自动重试。",
+            "H3_SUBTITLE_FRAME_COUNT": "字幕处理前后帧数或尺寸不一致，已停止输出，请联系管理员。",
+        }
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            message = str(event[1].get("exception_message") or "")
+            for code, hint in hints.items():
+                if message.startswith(code + ":"):
+                    error = hint
+                    break
+        # Never expose a partial/raw output from a failed cleanup/quality gate.
+        outputs = []
+    if status == "succeeded":
+        quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+        if quality["status"] in {"pending", "unavailable"}:
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running",
+                    "outputs": [], "error": "", "stage": "正在校验字幕与音轨" if job_id.startswith("h3v2.") or quality.get("visual_required") else "正在校验视频音轨", "pollDeferred": True}
+        if quality["status"] == "failed":
+            status, outputs, error = "failed", [], quality["error"]
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": status, "outputs": outputs, "error": error}
+
+
+@app.post("/v1/jobs/{job_id}/cancel", dependencies=[Depends(require_token)])
+async def cancel_job(job_id: str) -> dict[str, Any]:
+    provider, prompt_id = decode_job(job_id)
+    # Write intent before sending; disk failure must not produce an untracked
+    # cancellation. The worker API atomically compares the running prompt ID.
+    record_cancellation(job_id, False)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.post(f"{provider.base_url}/api/jobs/{quote(prompt_id, safe='')}/cancel", json={}, headers=provider_headers(provider))
+        if response.status_code in (404, 405):
+            raise HTTPException(status_code=409, detail="生成节点未提供按任务取消接口，未中断其他任务")
+        response.raise_for_status()
+        acknowledged = response.json().get("cancelled")
+        if type(acknowledged) is not bool:
+            raise HTTPException(status_code=502, detail="生成节点取消回执无效，请核对原任务状态")
+        if acknowledged:
+            record_cancellation(job_id, True)
+    return await get_job(job_id)
+
+
+@app.get("/v1/jobs/{job_id}/outputs/{index}", dependencies=[Depends(require_token)])
+async def get_output(job_id: str, index: int) -> Response:
+    provider, _, entry, outputs = await job_state(job_id)
+    if (entry.get("status") or {}).get("status_str") == "error":
+        raise HTTPException(status_code=409, detail="任务未成功，未返回部分输出")
+    if not outputs or job_id.startswith("h3v2.") and not (entry.get("status") or {}).get("completed"):
+        raise HTTPException(status_code=409, detail="视频生成尚未完成，未返回部分输出")
+    quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+    if quality["status"] != "verified":
+        raise HTTPException(status_code=422 if quality["status"] == "failed" else 409,
+                            detail=quality.get("error", "视频核验尚未完成，请稍后查询原任务"))
+    if index < 0 or index >= len(outputs):
+        raise HTTPException(status_code=404, detail="output not found")
+    wanted = outputs[index]
+    locator: dict[str, Any] | None = None
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if isinstance(item, dict) and str(item.get("filename")) == wanted["filename"]:
+                    locator = item
+                    break
+            if locator: break
+        if locator: break
+    if locator is None:
+        raise HTTPException(status_code=404, detail="output locator not found")
+    if quality.get("visual_revision") == VISUAL_REVISION:
+        bound_locator = {key: locator.get(key, "output" if key == "type" else "") for key in ("filename", "subfolder", "type")}
+        try:
+            media = await audio_validator.verified_download(quality, bound_locator, provider.base_url, provider_headers(provider))
+        except AudioQualityError as error:
+            raise HTTPException(status_code=422, detail=str(error)) from error
+        except (httpx.HTTPError, OSError, asyncio.TimeoutError):
+            raise HTTPException(status_code=503, detail="H3_VISUAL_VALIDATION_UNAVAILABLE: 已核验视频暂不可读取，请查询原任务") from None
+        return Response(content=media, media_type=wanted["mimeType"], headers={"Cache-Control": "private, no-store"})
+    query = urlencode({"filename": locator.get("filename", ""), "subfolder": locator.get("subfolder", ""), "type": locator.get("type", "output")})
+    client = httpx.AsyncClient(timeout=120)
+    response = await client.send(client.build_request("GET", f"{provider.base_url}/view?{query}", headers=provider_headers(provider)), stream=True)
+    if response.status_code >= 400:
+        await response.aclose(); await client.aclose()
+        raise HTTPException(status_code=502, detail="failed to read ComfyUI output")
+    async def stream():
+        try:
+            async for chunk in response.aiter_bytes():
+                yield chunk
+        finally:
+            await response.aclose(); await client.aclose()
+    return StreamingResponse(stream(), media_type=response.headers.get("content-type", wanted["mimeType"]))
diff --git a/integration-work/h3-current-workflow.py b/integration-work/h3-current-workflow.py
new file mode 100644
index 0000000..99906b8
--- /dev/null
+++ b/integration-work/h3-current-workflow.py
@@ -0,0 +1,555 @@
+from __future__ import annotations
+
+import copy
+import hashlib
+import json
+import math
+import random
+import re
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+from h3_audio_intent import plan_h3_audio
+from h3_audio_prompt import normalized_h3_audio_prompt
+
+
+WORKFLOW_DIR = Path(__file__).resolve().parent / "workflows"
+MAX_VIDEO_DURATION_SECONDS = 15
+CAPABILITY_BY_MODE = {"t2i": "image", "i2i": "image", "t2i_i2i": "image", "text": "video", "image": "video"}
+VISIBLE_TEXT_CONFLICTS = {
+    "text", "words", "readable words", "readable text", "letters", "digits", "numbers",
+    "chinese text", "chinese characters", "random text", "garbled text", "gibberish text",
+    "pseudo-text", "pseudo-chinese glyphs", "malformed han characters", "mojibake",
+    "corrupted glyphs", "labels", "signage", "typography", "text overlay", "logo",
+    "brand logo", "brand name", "trademark", "printed words", "printed numbers",
+}
+H3_DIALOGUE_TAG = re.compile(r"<d>\[(?P<language>[^\]]+)](?P<text>.*?)</d>", re.IGNORECASE | re.DOTALL)
+H3_SPEECH_PREFIX = r"(?P<prefix>(?:口播(?:内容|文案)?|台词|对白|旁白|朗读|说(?:道|出)?|讲(?:道)?|\b(?:says?|said|speaks?|spoke|narrates?)\b)\s*[：:]?\s*)"
+H3_QUOTED_DIALOGUE = tuple(
+    re.compile(
+        H3_SPEECH_PREFIX + re.escape(left) + r"(?P<text>(?:\\.|[^" + re.escape(right) + r"\\]"
+        + (r"|(?<=[A-Za-z])'(?=[A-Za-z])" if right == "'" else "") + r")*)" + re.escape(right),
+        re.IGNORECASE,
+    )
+    for left, right in (("“", "”"), ('"', '"'), ("‘", "’"), ("'", "'"), ("「", "」"), ("『", "』"))
+)
+H3_BARE_DIALOGUE = re.compile(r"(?:^|(?<=\t))(?P<prefix>[ ]*(?:口播(?:内容|文案)?|台词|对白|旁白|dialogue|voiceover|narration)[ ]*[：:][ ]*)(?P<text>[^\t\r\n]*)(?=[\t\r\n]|$)", re.IGNORECASE | re.MULTILINE)
+H3_QUOTED_SPEECH_START = re.compile(H3_SPEECH_PREFIX + r"[\"“‘'「『]", re.IGNORECASE)
+H3_COMPLETE_SILENCE = re.compile(
+    r"(?:全程|完全|绝对)[ \t]*(?:绝对)?[ \t]*静音"
+    r"|(?:不要|无需|不需要|禁止|关闭|移除|不生成|不输出)[ \t]*(?:任何|全部|所有)?[ \t]*(?:音频|声音|音轨)"
+    r"|\b(?:no audio|mute all audio|complete silence|silent video)\b",
+    re.IGNORECASE,
+)
+H3_AUDIO_OUTPUT_POLICY_VERSION = "h3-audio-plan-verified-v25"
+H3_CAPTION_PIPELINE_VERSION = "native-full-attention-realism04-manju-v24"
+H3_VERIFIED_TEXT_ENCODER = "qwen3vl_32b_minimax_h3_int8_convrot.safetensors"
+H3_CLEAR_FRAME_RULE = (
+    "No text, no subtitles, no captions, no watermark anywhere in the frame."
+)
+# Visual mouth movements or chatting are not consent to invent spoken words.
+H3_SPEECH_INTENT = re.compile(r"口播|台词|对白|旁白|朗读|配音|(?:输出|生成|需要|播放)[^，。！？；\n]{0,12}(?:语音|人声)|(?:说(?:道|出)?|讲(?:道)?)\s*[：:\"“‘'「『]|\b(?:narrates?|narrator|dialogue|narration|voice[- ]?over|spoken words|spoken audio)\b", re.IGNORECASE)
+H3_SILENT_CLAUSE = re.compile(
+    r"(?:无|没有|不要|不许|禁止|无需|不需要|不)(?:(?:任何|额外的?|其他|背景|人物|角色|进行|出现|加入|添加|自动|输出|生成|播放|允许|需要|加|再)){0,3}(?:口播|台词|对白|旁白|说话|讲话|聊天|交谈|朗读|配音|人声|语音)"
+    r"|\b(?:no|not|without|never)\s+(?:(?:additional|other|background|characters?|one|any|human|audible)\s+){0,4}(?:speech|dialogue|narration|voiceover|talking|speaking|speaks?|talks?)(?:\s*(?:,|or|and)\s*(?:speech|dialogue|narration|voiceover|talking|speaking|voices?))*",
+    re.IGNORECASE,
+)
+H3_NO_SPEECH_RULE = (
+    "H3 audio compliance: Background-only audio. Preserve the requested environmental ambience, "
+    "physical sound effects and instrumental background music. Do not add music unless requested. "
+    "No character speaks audibly. No voiceover, narration, dialogue, lyrics, chanting, "
+    "background conversation or invented language is audible. Do not generate human words or syllables. "
+    "Keep the visual actions in the prompt unchanged."
+)
+H3_DIALOGUE_RULE = (
+    "H3 audio compliance: Keep the speaker identities, on-screen/off-screen positions and audio sources described above. "
+    "Render the tagged dialogue in its declared language and written order. "
+    "Do not translate, paraphrase, replace, repeat, or invent any syllable beyond the written dialogue. "
+    "Keep all non-speech audio requirements unchanged."
+)
+
+
+@dataclass(frozen=True)
+class WorkflowSpec:
+    key: str
+    name: str
+    mode: str
+    file: str
+    raw: dict[str, Any]
+    revision: str
+
+    @property
+    def capability(self) -> str:
+        return CAPABILITY_BY_MODE[self.mode]
+
+    @property
+    def path(self) -> Path:
+        return WORKFLOW_DIR / self.file
+
+
+def load_registry() -> dict[str, WorkflowSpec]:
+    manifest = json.loads((WORKFLOW_DIR / "manifest.json").read_text(encoding="utf-8"))
+    result: dict[str, WorkflowSpec] = {}
+    for row in manifest.get("workflows") or []:
+        if not row.get("enabled", True):
+            continue
+        mode = str(row.get("mode") or "")
+        if mode not in CAPABILITY_BY_MODE:
+            raise ValueError(f"unsupported workflow mode: {mode}")
+        path = WORKFLOW_DIR / str(row["file"])
+        payload = path.read_bytes()
+        revision_material = payload + b"\0" + str(row.get("revision_salt") or "").encode("utf-8")
+        if row.get("speech_prompt_policy") == "minimax_h3":
+            revision_material += b"\0" + H3_AUDIO_OUTPUT_POLICY_VERSION.encode("utf-8")
+            revision_material += b"\0" + H3_CAPTION_PIPELINE_VERSION.encode("utf-8")
+        key = str(row["key"])
+        result[key] = WorkflowSpec(
+            key=key,
+            name=str(row.get("name") or key),
+            mode=mode,
+            file=str(row["file"]),
+            raw=dict(row),
+            revision=hashlib.sha256(revision_material).hexdigest()[:16],
+        )
+    return result
+
+
+def public_workflow(spec: WorkflowSpec) -> dict[str, Any]:
+    return {
+        "key": spec.key,
+        "name": spec.name,
+        "mode": spec.mode,
+        "capability": spec.capability,
+        "revision": spec.revision,
+        "supportsReferences": bool(spec.raw.get("load_image_node") or spec.raw.get("reference_node") or spec.raw.get("image_refs_node")),
+    }
+
+
+def public_model(spec: WorkflowSpec) -> dict[str, Any]:
+    supports_references = bool(spec.raw.get("load_image_node") or spec.raw.get("reference_node") or spec.raw.get("image_refs_node"))
+    if spec.mode == "t2i":
+        operations = ["text_to_image"]
+        min_images, max_images = 0, 0
+    elif spec.mode == "i2i":
+        operations = ["image_to_image"]
+        min_images, max_images = 1, 1
+    elif spec.mode == "t2i_i2i":
+        operations = ["text_to_image", "image_to_image"]
+        min_images, max_images = 0, int(spec.raw.get("max_reference_images") or 6)
+    elif spec.mode == "text":
+        operations = ["text_to_video"]
+        if supports_references:
+            operations.append("image_to_video")
+        min_images, max_images = 0, 1 if supports_references else 0
+    else:
+        operations = ["image_to_video"]
+        if spec.raw.get("reference_node"):
+            operations.append("reference_to_video")
+            min_images, max_images = 1, 9
+        else:
+            min_images, max_images = 1, 1
+
+    aspect_ratios = ["1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"]
+    endpoint_types = ["comfyui-workflow", *operations]
+    item: dict[str, Any] = {
+        "id": spec.key,
+        "object": "model",
+        "owned_by": "comfyui-workflow",
+        "display_name": spec.name,
+        "model_type": spec.capability,
+        "supported_endpoint_types": endpoint_types,
+        "supports_images": supports_references,
+        "min_images": min_images,
+        "max_images": max_images,
+        "default_parameters": {"aspect_ratio": "1:1" if spec.capability == "image" else "16:9"},
+        "options": {
+            "aspect_ratio": [{"value": value, "label": value} for value in aspect_ratios],
+        },
+    }
+    if spec.capability == "video":
+        item["default_parameters"].update({"duration_seconds": "5", "resolution": "720p"})
+        item["options"].update({
+            "duration_seconds": [{"value": str(value), "label": f"{value} 秒"} for value in range(1, MAX_VIDEO_DURATION_SECONDS + 1)],
+            "resolution": [{"value": value, "label": value.upper()} for value in ("480p", "720p", "1080p")],
+        })
+    return item
+
+
+def _patch_node(workflow: dict[str, Any], node_id: str | None, values: dict[str, Any]) -> None:
+    if not node_id:
+        return
+    if node_id not in workflow:
+        raise ValueError(f"workflow is missing configured node {node_id}")
+    workflow[node_id].setdefault("inputs", {}).update(values)
+
+
+def _fit_aligned_resolution(
+    width: int,
+    height: int,
+    *,
+    max_megapixels: float | None,
+    align: int,
+) -> tuple[int, int]:
+    """Preserve aspect ratio while fitting the first pass to the workflow budget."""
+    align = max(1, int(align))
+    target_width = max(align, int(width))
+    target_height = max(align, int(height))
+    if max_megapixels is not None and float(max_megapixels) > 0:
+        max_pixels = float(max_megapixels) * 1024 * 1024
+        area = target_width * target_height
+        if area > max_pixels:
+            scale = math.sqrt(max_pixels / area)
+            target_width = max(align, round(target_width * scale))
+            target_height = max(align, round(target_height * scale))
+
+    target_width = max(align, round(target_width / align) * align)
+    target_height = max(align, round(target_height / align) * align)
+    if max_megapixels is not None and float(max_megapixels) > 0:
+        max_pixels = float(max_megapixels) * 1024 * 1024
+        while target_width * target_height > max_pixels:
+            if target_width >= target_height and target_width > align:
+                target_width -= align
+            elif target_height > align:
+                target_height -= align
+            else:
+                break
+    return target_width, target_height
+
+
+def _negative_prompt(spec: WorkflowSpec, current: str, requested: str) -> str:
+    parts: list[str] = []
+    seen: set[str] = set()
+    for value in (current, requested):
+        for raw in value.split(","):
+            term = raw.strip(" .")
+            normalized = " ".join(term.casefold().split())
+            if not term or normalized in seen:
+                continue
+            if spec.raw.get("preserve_visible_text") and normalized in VISIBLE_TEXT_CONFLICTS:
+                continue
+            seen.add(normalized)
+            parts.append(term)
+    return ", ".join(parts)
+
+
+def _spoken_language(value: str) -> str:
+    if re.search(r"[\u3040-\u30ff]", value):
+        return "Japanese"
+    if re.search(r"[\uac00-\ud7af]", value):
+        return "Korean"
+    if re.search(r"[\u3400-\u9fff]", value):
+        return "Chinese"
+    return "English"
+
+
+def _h3_audio_prompt(prompt: str, duration: float) -> str:
+    return normalized_h3_audio_prompt(prompt, duration)
+
+
+def _h3_without_native_caption_instructions(prompt: str) -> str:
+    instruction = re.compile(
+        r"(?:请|需要|要求|同时|并且|并|自动|不要|不需要|无需|禁止|关闭|不显示|不加|不添加|无|添加|显示|生成|加上|加入|配上|带|烧录)+"
+        r"(?:任何|中文|英文|双语|同步|口播|对白|底部|居中|的)*字幕"
+        r"(?:[：:][^，,。；;\n]*)?"
+        r"|\b(?:add|show|generate|include|burn(?: in)?|with|no|without|disable)\s+"
+        r"(?:(?:chinese|english|bilingual|synchronized|any)\s+)?(?:subtitles|captions)\b", re.IGNORECASE)
+    protected = re.compile(H3_DIALOGUE_TAG.pattern + r'|“[^”]*”|"[^"\n]*"|「[^」]*」|『[^』]*』', re.IGNORECASE | re.DOTALL)
+    parts, cursor = [], 0
+    for match in protected.finditer(prompt):
+        parts.extend([instruction.sub("", prompt[cursor:match.start()]), match.group(0)])
+        cursor = match.end()
+    parts.append(instruction.sub("", prompt[cursor:]))
+    return "".join(parts)
+
+
+def _apply_h3_generation_stage(graph: dict[str, Any]) -> None:
+    stage_id = "h3_generation_stage"
+    if stage_id in graph:
+        raise ValueError("H3_SUBTITLE_GRAPH_UNSUPPORTED: 生成阶段节点标识冲突")
+    loaders = [
+        ("unet", "127", "UNETLoader", {"unet_name", "weight_dtype"}, set()),
+        ("clip", "128", "CLIPLoader", {"clip_name", "type"}, {"device"}),
+        ("video_vae", "119", "VAELoader", {"vae_name"}, set()),
+        ("audio_vae", "120", "VAELoader", {"vae_name"}, set()),
+    ]
+    models = {}
+    ports = {}
+    for index, (name, node_id, kind, required, optional) in enumerate(loaders):
+        node = graph.get(node_id, {})
+        inputs = node.get("inputs")
+        if (node.get("class_type") != kind or not isinstance(inputs, dict)
+                or not required <= set(inputs) or not set(inputs) <= required | optional
+                or any(not isinstance(v, str) or not v for v in inputs.values())):
+            raise ValueError("H3_SUBTITLE_GRAPH_UNSUPPORTED: 生成模型入口与已验证的阶段协议不一致")
+        models[name] = dict(inputs)
+        ports[node_id] = index
+
+    def rewire(value: Any) -> Any:
+        if isinstance(value, list):
+            if len(value) == 2 and isinstance(value[0], str) and value[0] in ports:
+                if type(value[1]) is not int or value[1] != 0:
+                    raise ValueError("H3_SUBTITLE_GRAPH_UNSUPPORTED: 生成模型输出端口无效")
+                return [stage_id, ports[value[0]]]
+            return [rewire(item) for item in value]
+        if isinstance(value, dict):
+            return {key: rewire(item) for key, item in value.items()}
+        return value
+
+    # The gate receives filenames, not already-loaded GPU objects. Loader
+    # expansion occurs only after the private vision service confirms sleep.
+    for node in graph.values():
+        if "inputs" in node:
+            node["inputs"] = rewire(node["inputs"])
+    for node_id in ports:
+        del graph[node_id]
+    graph[stage_id] = {"class_type": "H3GenerationModelStage",
+                       "inputs": {"models_json": json.dumps(models, ensure_ascii=False)}}
+
+
+def _h3_manju_background_layout(value: str, references: int) -> str | None:
+    # Keep the GPU-verified layout narrow: literal speech, explicit sound/music
+    # and multi-reference identity assignments retain the original path.
+    if not value.endswith(H3_NO_SPEECH_RULE) or H3_DIALOGUE_TAG.search(value) or references > 1:
+        return None
+    scene = value[:-len(H3_NO_SPEECH_RULE)].rstrip()
+    if re.search(r'音乐|配乐|音效|环境音|声音|静音|声响|\b(?:music|BGM|sound|audio|silent|silence)\b', scene, re.IGNORECASE):
+        return None
+    reference = (
+        'Picture 1 is the reference for the people, setting and product. Preserve their appearance, '
+        'including the existing printing on the product packaging.\n\n'
+    ) if references == 1 else ''
+    return (reference + 'integrated_multimodal_description:\n' + scene
+            + '\n\noverall_soundscape: Environmental ambience only. The people remain silent throughout.'
+            + '\n\nnon_diegetic_music: N/A'
+            + '\n\nNo added text, no subtitles, no captions, no watermark anywhere in the frame.')
+
+
+def _apply_h3_frame_policy(spec: WorkflowSpec, graph: dict[str, Any], request: dict[str, Any]) -> None:
+    metadata = request.get("metadata") or {}
+    if not isinstance(metadata, dict):
+        raise ValueError("H3 metadata must be an object")
+    for key in ("h3_native_subtitles", "h3_suppress_subtitles", "h3_subtitles"):
+        if key in metadata and not isinstance(metadata[key], bool):
+            raise ValueError(f"{key} must be a boolean")
+    if metadata.get("h3_native_subtitles") is True or metadata.get("h3_suppress_subtitles") is False:
+        raise ValueError("原生字幕已禁用，当前仅保留生成阶段字幕抑制，字幕烧录已暂停")
+    encoder = graph.get("128", {})
+    if encoder.get("class_type") != "CLIPLoader" or encoder.get("inputs", {}).get("type") != "minimax":
+        raise ValueError("H3_SUBTITLE_GRAPH_UNSUPPORTED: 当前工作流缺少已验证的 H3 文本编码器入口")
+    # The identical-seed P2 comparison passed literal speech validation only
+    # with the reference-quality encoder. Keep sampler, LoRA and audio untouched.
+    encoder["inputs"]["clip_name"] = H3_VERIFIED_TEXT_ENCODER
+    save = graph[str(spec.raw.get("save_node"))]
+    if save.get("class_type") != "VHS_VideoCombine" or "images" not in save.get("inputs", {}):
+        raise ValueError("H3_SUBTITLE_GRAPH_UNSUPPORTED: 当前工作流缺少可校验的视频帧输出")
+    if any(n.get("class_type") in {"BurnChineseSubtitles", "SoftChineseSubtitles", "H3VerifiedSubtitleFrames"} for n in graph.values()):
+        raise ValueError("H3_SUBTITLE_LEGACY_NODE: 字幕烧录已暂停，工作流仍包含旧字幕节点")
+    if any(n.get("class_type") in {"H3CaptionPipeline", "H3CaptionFinalize", "H3STTNRepair"}
+           for n in graph.values()):
+        raise ValueError("H3_SUBTITLE_GRAPH_UNSUPPORTED: 字幕后处理已暂停，工作流仍包含后处理节点")
+    # Operator policy: even a stored h3_subtitles=True does not re-enable the
+    # expensive cleanup/burn-in chain. Leave the raw decoded frames and the
+    # existing opt-in audio connection intact; this is suppression, not erasure.
+    visited_prompt_fields = set()
+    for node_key, input_key in (("prompt_node", "prompt_input"), ("motion_node", "motion_input")):
+        node = spec.raw.get(node_key)
+        if node:
+            key = str(spec.raw.get(input_key) or "text")
+            field = (str(node), key)
+            if field in visited_prompt_fields:
+                continue
+            visited_prompt_fields.add(field)
+            value = str(graph[str(node)]["inputs"].get(key) or "")
+            value = _h3_without_native_caption_instructions(value).rstrip()
+            structured = None
+            if spec.raw.get('h3_background_prompt_layout') == 'manju-v1':
+                reference_count = sum(k.startswith('canvas_reference_') for k in graph)
+                structured = _h3_manju_background_layout(value, reference_count)
+            graph[str(node)]["inputs"][key] = structured or (value + "\n\n" + H3_CLEAR_FRAME_RULE)
+    _apply_h3_generation_stage(graph)
+
+
+def validate_h3_references(spec: WorkflowSpec, count: int) -> None:
+    if spec.raw.get("speech_prompt_policy") != "minimax_h3":
+        return
+    catalog = public_model(spec)
+    if catalog["max_images"] > 0 and count > catalog["max_images"]:
+        raise ValueError(f"H3_AUDIO_CONDITIONING_INVALID: this workflow supports at most {catalog['max_images']} reference images")
+    if not catalog["min_images"] <= count <= catalog["max_images"]:
+        raise ValueError("H3_AUDIO_CONDITIONING_INVALID: 参考图片数量与工作流不匹配，请选择对应图生或文生视频工作流；未忽略参考图")
+
+
+def compile_workflow(spec: WorkflowSpec, request: dict[str, Any], uploaded_images: list[str], job_id: str, *, preserve_requested_audio: bool = False) -> dict[str, Any]:
+    if spec.capability == "video":
+        duration = float(request.get("duration") if request.get("duration") is not None else 5)
+        if not math.isfinite(duration) or duration <= 0 or duration > MAX_VIDEO_DURATION_SECONDS:
+            raise ValueError("视频时长必须大于 0 且最多 15 秒")
+    validate_h3_references(spec, len(uploaded_images))
+    workflow = copy.deepcopy(json.loads(spec.path.read_text(encoding="utf-8")))
+    prompt = str(request.get("prompt") or "").strip()
+    if not prompt:
+        raise ValueError("prompt is required")
+    native_audio_control = bool(spec.raw.get("native_audio_control"))
+    generate_audio = request.get("generate_audio")
+    if native_audio_control and generate_audio is None:
+        generate_audio = bool(spec.raw.get("native_audio_default", True))
+    if native_audio_control and generate_audio and spec.raw.get("speech_prompt_policy") == "minimax_h3":
+        audio_plan = plan_h3_audio(prompt, float(request.get("duration") or 5))
+        prompt = _h3_audio_prompt(prompt, float(request.get("duration") or 5))
+        # Explicit effects/music use the native track only behind the new ASR
+        # output gate. Unrequested audio remains disconnected as in v24.
+        generate_audio = not audio_plan["silent"] if preserve_requested_audio else audio_plan["audio_mode"] in {"dialogue", "effects"}
+    negative_prompt = str(request.get("negative_prompt") or "").strip()
+    seed = request.get("seed")
+    if seed is None:
+        seed = random.SystemRandom().randint(0, 2**63 - 1)
+
+    _patch_node(workflow, spec.raw.get("prompt_node"), {str(spec.raw.get("prompt_input") or "text"): prompt})
+    _patch_node(workflow, spec.raw.get("motion_node"), {str(spec.raw.get("motion_input") or "text"): prompt})
+    _patch_node(workflow, spec.raw.get("seed_node"), {str(spec.raw.get("seed_input") or "noise_seed"): int(seed)})
+    if negative_prompt and spec.raw.get("negative_node"):
+        node_id = str(spec.raw["negative_node"])
+        input_key = str(spec.raw.get("negative_input") or "text")
+        current = str((workflow.get(node_id, {}).get("inputs") or {}).get(input_key) or "").strip()
+        _patch_node(workflow, node_id, {input_key: _negative_prompt(spec, current, negative_prompt)})
+    requested_width = request.get("width")
+    requested_height = request.get("height")
+    if spec.raw.get("h3_native_optimized"):
+        frame = workflow[str(spec.raw["width_node"])]["inputs"]
+        width = int(requested_width if requested_width is not None else frame[str(spec.raw["width_input"])])
+        height = int(requested_height if requested_height is not None else frame[str(spec.raw["height_input"])])
+        width, height = _fit_aligned_resolution(width, height, max_megapixels=None,
+                                               align=int(spec.raw.get("dimension_align") or 32))
+        if width * height > 4096 * 2160:
+            raise ValueError("H3 字幕处理支持的最大画面面积为 4096×2160，请调整分辨率后提交")
+        _patch_node(workflow, spec.raw["width_node"], {str(spec.raw["width_input"]): width})
+        _patch_node(workflow, spec.raw["height_node"], {str(spec.raw["height_input"]): height})
+    elif requested_width is not None and requested_height is not None and spec.raw.get("base_max_megapixels") is not None:
+        align = max(1, int(spec.raw.get("dimension_align") or 1))
+        base_width, base_height = _fit_aligned_resolution(
+            int(requested_width),
+            int(requested_height),
+            max_megapixels=float(spec.raw["base_max_megapixels"]),
+            align=align,
+        )
+        _patch_node(workflow, spec.raw.get("width_node"), {str(spec.raw.get("width_input") or "value"): base_width})
+        _patch_node(workflow, spec.raw.get("height_node"), {str(spec.raw.get("height_input") or "value"): base_height})
+        if spec.raw.get("upscale_node"):
+            final_width, final_height = _fit_aligned_resolution(
+                int(requested_width),
+                int(requested_height),
+                max_megapixels=None,
+                align=align,
+            )
+            upscale_values: dict[str, Any] = {
+                str(spec.raw.get("upscale_mode_input") or "mode"): str(spec.raw.get("upscale_mode") or "target dimensions"),
+                str(spec.raw.get("upscale_width_input") or "mode.width"): final_width,
+                str(spec.raw.get("upscale_height_input") or "mode.height"): final_height,
+            }
+            chunking_input = spec.raw.get("upscale_chunking_input")
+            threshold = spec.raw.get("upscale_chunking_threshold_sec")
+            if chunking_input and threshold is not None:
+                upscale_values[str(chunking_input)] = float(request.get("duration") or 0) > float(threshold)
+            _patch_node(workflow, str(spec.raw["upscale_node"]), upscale_values)
+    else:
+        if requested_width is not None:
+            _patch_node(workflow, spec.raw.get("width_node"), {str(spec.raw.get("width_input") or "value"): int(requested_width)})
+        if requested_height is not None:
+            _patch_node(workflow, spec.raw.get("height_node"), {str(spec.raw.get("height_input") or "value"): int(requested_height)})
+    if request.get("duration") is not None:
+        _patch_node(workflow, spec.raw.get("duration_node"), {"value": float(request["duration"])})
+    count = max(1, min(int(request.get("batch_size") or 1), 4))
+    if spec.raw.get("batch_node"):
+        _patch_node(workflow, str(spec.raw["batch_node"]), {str(spec.raw.get("batch_input") or "batch_size"): count})
+    elif count > 1 and spec.raw.get("batch_source_node") and spec.raw.get("batch_target_node"):
+        source_node = str(spec.raw["batch_source_node"])
+        target_node = str(spec.raw["batch_target_node"])
+        if source_node not in workflow or target_node not in workflow:
+            raise ValueError("workflow batch source or target node is missing")
+        batch_node = "canvas_repeat_latent_batch"
+        while batch_node in workflow:
+            batch_node = "_" + batch_node
+        workflow[batch_node] = {"class_type": "RepeatLatentBatch", "inputs": {"samples": [source_node, 0], "amount": count}, "_meta": {"title": "Canvas Batch Output"}}
+        _patch_node(workflow, target_node, {str(spec.raw.get("batch_target_input") or "latent_image"): [batch_node, 0]})
+    if spec.raw.get("enhance_node") is not None and spec.raw.get("enhance_default") is not None:
+        _patch_node(workflow, str(spec.raw["enhance_node"]), {str(spec.raw.get("enhance_input") or "value"): bool(spec.raw["enhance_default"])})
+    if spec.raw.get("denoise_node") and (request.get("denoise") is not None or spec.raw.get("denoise_default") is not None):
+        denoise = request.get("denoise") if request.get("denoise") is not None else spec.raw.get("denoise_default")
+        _patch_node(workflow, str(spec.raw["denoise_node"]), {str(spec.raw.get("denoise_input") or "denoise"): float(denoise)})
+    if spec.raw.get("max_dimension_node") and (request.get("width") is not None or request.get("height") is not None):
+        maximum = max(int(request.get("width") or 0), int(request.get("height") or 0), 64)
+        _patch_node(workflow, str(spec.raw["max_dimension_node"]), {str(spec.raw.get("max_dimension_input") or "largest_size"): maximum})
+
+    if spec.raw.get("image_refs_node"):
+        max_reference_images = int(spec.raw.get("max_reference_images") or 6)
+        if len(uploaded_images) > max_reference_images:
+            raise ValueError(f"this workflow supports at most {max_reference_images} reference images")
+        if uploaded_images:
+            encode_node = str(spec.raw["image_refs_node"])
+            if encode_node not in workflow:
+                raise ValueError("workflow image reference node is missing")
+            if requested_width is not None and requested_height is not None:
+                aligned_width, aligned_height = _fit_aligned_resolution(
+                    int(requested_width), int(requested_height),
+                    max_megapixels=float(spec.raw.get("base_max_megapixels") or 1), align=32,
+                )
+                reference_resolution = max(32, round(math.sqrt(aligned_width * aligned_height) / 32) * 32)
+                _patch_node(workflow, encode_node, {"resolution": reference_resolution})
+            prefix = str(spec.raw.get("image_refs_input_prefix") or "images.image_")
+            for index, image_name in enumerate(uploaded_images, start=1):
+                node_id = f"canvas_reference_{index}"
+                while node_id in workflow:
+                    node_id = "_" + node_id
+                workflow[node_id] = {"class_type": "LoadImage", "inputs": {"image": image_name}, "_meta": {"title": f"Canvas reference {index}"}}
+                _patch_node(workflow, encode_node, {f"{prefix}{index}": [node_id, 0]})
+            vae_node = str(spec.raw["image_refs_vae_node"])
+            _patch_node(workflow, encode_node, {"vae": [vae_node, 0]})
+            sampler_node = str(spec.raw["image_refs_sampler_node"])
+            latent_source = [encode_node, 2]
+            if count > 1:
+                batch_node = "canvas_repeat_reference_latent"
+                workflow[batch_node] = {"class_type": "RepeatLatentBatch", "inputs": {"samples": latent_source, "amount": count}, "_meta": {"title": "Canvas reference batch"}}
+                latent_source = [batch_node, 0]
+            _patch_node(workflow, sampler_node, {"latent_image": latent_source})
+    elif spec.raw.get("reference_node"):
+        if not uploaded_images:
+            raise ValueError("this workflow requires at least one reference image")
+        max_reference_images = int(spec.raw.get("max_reference_images") or 9)
+        if len(uploaded_images) > max_reference_images:
+            raise ValueError(f"this workflow supports at most {max_reference_images} reference images")
+        reference_inputs: dict[str, Any] = {}
+        prefix = str(spec.raw.get("reference_input_prefix") or "ref_images.ref_image_")
+        for index, image_name in enumerate(uploaded_images):
+            node_id = f"canvas_reference_{index + 1}"
+            while node_id in workflow:
+                node_id = "_" + node_id
+            workflow[node_id] = {"class_type": "LoadImage", "inputs": {"image": image_name}, "_meta": {"title": f"Canvas reference {index + 1}"}}
+            reference_inputs[f"{prefix}{index}"] = [node_id, 0]
+        _patch_node(workflow, str(spec.raw["reference_node"]), reference_inputs)
+    elif spec.raw.get("load_image_node"):
+        if spec.mode in {"i2i", "image"} and not uploaded_images:
+            raise ValueError("this workflow requires an input image")
+        if uploaded_images:
+            load_node = str(spec.raw["load_image_node"])
+            if load_node not in workflow and spec.mode == "text":
+                workflow[load_node] = {"class_type": "LoadImage", "inputs": {"image": uploaded_images[0]}, "_meta": {"title": "Canvas Reference Image"}}
+            else:
+                _patch_node(workflow, load_node, {"image": uploaded_images[0]})
+            if spec.raw.get("image_resize_node"):
+                resize_node = str(spec.raw["image_resize_node"])
+                if resize_node in workflow:
+                    _patch_node(workflow, resize_node, {"input": [load_node, 0]})
+            if spec.raw.get("t2v_switch_node"):
+                _patch_node(workflow, str(spec.raw["t2v_switch_node"]), {"value": False})
+        elif spec.raw.get("t2v_switch_node"):
+            _patch_node(workflow, str(spec.raw["t2v_switch_node"]), {"value": True})
+
+    save_node = spec.raw.get("save_node")
+    if save_node:
+        prefix = str(spec.raw.get("save_prefix") or spec.key)
+        _patch_node(workflow, str(save_node), {"filename_prefix": f"{prefix}_{job_id}"})
+        if native_audio_control and not generate_audio:
+            workflow[str(save_node)].setdefault("inputs", {}).pop("audio", None)
+    if spec.raw.get("speech_prompt_policy") == "minimax_h3":
+        _apply_h3_frame_policy(spec, workflow, request)
+    return workflow
diff --git a/integration-work/h3-live-app-20261106.py b/integration-work/h3-live-app-20261106.py
new file mode 100644
index 0000000..9fad613
--- /dev/null
+++ b/integration-work/h3-live-app-20261106.py
@@ -0,0 +1,572 @@
+from __future__ import annotations
+
+import base64
+import asyncio
+import ipaddress
+import json
+import mimetypes
+import os
+import secrets
+import socket
+from pathlib import Path
+from job_cancellation import dispatched as cancellation_dispatched, record as record_cancellation
+from dataclasses import dataclass
+from typing import Any
+from urllib.parse import quote, urlencode, urlsplit
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Response
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel, Field
+
+from workflow import MAX_VIDEO_DURATION_SECONDS, compile_workflow, load_registry, public_model, public_workflow, validate_h3_references
+from h3_audio_intent import plan_h3_audio
+from h3_audio_validation import AudioOutputValidator, attach_audio_policy
+from h3_visual_guard import VISUAL_REVISION, validate_visual_dimensions
+from h3_audio_conditioning import AudioConditioningError, prepare_audio_conditioning
+from h3_audio_output_guard import AudioQualityError
+
+
+@dataclass(frozen=True)
+class Provider:
+    id: str
+    name: str
+    base_url: str
+    api_key: str = ""
+    control_token_file: str = ""
+
+
+class JobRequest(BaseModel):
+    provider_id: str = "default"
+    workflow_key: str
+    prompt: str
+    negative_prompt: str = ""
+    input_images: list[str] = Field(default_factory=list, max_length=9)
+    width: int | None = Field(default=None, ge=64, le=8192)
+    height: int | None = Field(default=None, ge=64, le=8192)
+    duration: float | None = Field(default=None, gt=0, le=MAX_VIDEO_DURATION_SECONDS)
+    generate_audio: bool | None = None
+    seed: int | None = Field(default=None, ge=0)
+    batch_size: int = Field(default=1, ge=1, le=4)
+    denoise: float | None = Field(default=None, ge=0, le=1)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+app = FastAPI(title="Canvas ComfyUI Workflow Adapter", version="1.0.0")
+audio_validator = AudioOutputValidator()
+provider_selection_lock = asyncio.Lock()
+provider_reservations: dict[str, int] = {}
+
+
+def auto_balance_enabled() -> bool:
+    return os.getenv("COMFY_AUTO_BALANCE", "").strip().lower() in {"1", "true", "yes", "on"}
+
+
+def providers() -> dict[str, Provider]:
+    raw = os.getenv("COMFY_PROVIDERS_JSON", "").strip()
+    rows: list[dict[str, Any]] = []
+    if raw:
+        parsed = json.loads(raw)
+        rows = parsed if isinstance(parsed, list) else []
+    elif os.getenv("COMFY_URL", "").strip():
+        rows = [{"id": "default", "name": "ComfyUI", "base_url": os.getenv("COMFY_URL"), "api_key": os.getenv("COMFY_API_KEY", "")}]
+    result: dict[str, Provider] = {}
+    for row in rows:
+        provider = Provider(id=str(row.get("id") or "").strip(), name=str(row.get("name") or row.get("id") or "ComfyUI"), base_url=str(row.get("base_url") or "").strip().rstrip("/"), api_key=str(row.get("api_key") or ""), control_token_file=str(row.get("control_token_file") or ""))
+        if provider.id and provider.base_url.startswith(("http://", "https://")):
+            result[provider.id] = provider
+    return result
+
+
+def require_token(authorization: str | None = Header(default=None)) -> None:
+    expected = os.getenv("COMFY_ADAPTER_TOKEN", "").strip()
+    if expected and not secrets.compare_digest(authorization or "", f"Bearer {expected}"):
+        raise HTTPException(status_code=401, detail="invalid adapter token")
+
+
+def provider_headers(provider: Provider) -> dict[str, str]:
+    headers = {"Authorization": f"Bearer {provider.api_key}"} if provider.api_key else {}
+    if provider.control_token_file:
+        path = Path(provider.control_token_file)
+        try:
+            # Operator-mounted token only; it is never accepted from JobRequest
+            # or exposed by the public provider catalogue.
+            if path.parent != Path('/run/h3-workers') or path.name != provider.id + '.token':
+                raise ValueError('invalid worker control token path')
+            token = path.read_text().strip()
+            if not 16 <= len(token) <= 512 or any(ord(x) < 33 or ord(x) > 126 for x in token):
+                raise ValueError('invalid worker control token')
+            headers['X-H3-Canary-Token'] = token
+        except (OSError, ValueError):
+            raise HTTPException(status_code=503, detail="生成节点控制配置未就绪，任务未提交")
+    return headers
+
+
+async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        async with httpx.AsyncClient(timeout=5) as client:
+            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    except (httpx.HTTPError, ValueError, TypeError):
+        return None
+    return len(payload.get("queue_running") or []) + len(payload.get("queue_pending") or [])
+
+
+def admission_ids(configured: dict[str, Provider]) -> set[str]:
+    path = os.getenv("COMFY_ADMISSION_FILE", "").strip()
+    if not path:
+        return set(configured)
+    try:
+        raw = Path(path).read_bytes()
+        if len(raw) > 4096:
+            raise ValueError("oversized admission configuration")
+        value = json.loads(raw)
+        if not isinstance(value, dict):
+            raise ValueError("invalid admission configuration")
+        allowed = value.get("admit")
+        if type(value.get("schema")) is not int or value.get("schema") != 1 or not isinstance(allowed, list) or any(not isinstance(x, str) for x in allowed):
+            raise ValueError("invalid admission configuration")
+        if len(set(allowed)) != len(allowed) or not set(allowed) <= set(configured):
+            raise ValueError("unknown or duplicate admission provider")
+        return set(allowed)
+    except (OSError, ValueError, TypeError):
+        # Drain changes affect only new submissions; job lookup always retains
+        # both stable provider IDs and their existing history/output routes.
+        raise HTTPException(status_code=503, detail="生成服务正在切换，任务尚未提交，请稍后重试")
+
+
+async def select_provider(requested_provider_id: str) -> Provider | None:
+    configured = providers()
+    requested = configured.get(requested_provider_id)
+    admitted = admission_ids(configured)
+    if requested is None:
+        return None
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="该生成节点正在排空，现有任务继续执行，新任务请稍后提交")
+        return requested
+
+    candidates = [provider for provider in configured.values() if provider.id in admitted]
+    if not candidates:
+        raise HTTPException(status_code=503, detail="生成节点正在排空，现有任务和结果保持不变")
+    depths = await asyncio.gather(*(provider_queue_depth(provider) for provider in candidates))
+    available = [
+        (depth + provider_reservations.get(provider.id, 0), 0 if provider.id == requested_provider_id else 1, provider)
+        for provider, depth in zip(candidates, depths)
+        if depth is not None
+    ]
+    if not available:
+        if os.getenv("COMFY_ADMISSION_FILE", "").strip():
+            raise HTTPException(status_code=503, detail="生成节点尚未就绪，任务未提交，请稍后重试")
+        return requested
+    return min(available, key=lambda item: (item[0], item[1]))[2]
+
+
+async def reserve_provider(requested_provider_id: str) -> Provider | None:
+    async with provider_selection_lock:
+        provider = await select_provider(requested_provider_id)
+        if provider is not None:
+            provider_reservations[provider.id] = provider_reservations.get(provider.id, 0) + 1
+        return provider
+
+
+async def release_provider(provider: Provider) -> None:
+    async with provider_selection_lock:
+        remaining = provider_reservations.get(provider.id, 0) - 1
+        if remaining > 0:
+            provider_reservations[provider.id] = remaining
+        else:
+            provider_reservations.pop(provider.id, None)
+
+
+def input_host_allowlist() -> set[str]:
+    return {value.strip().lower().rstrip(".") for value in os.getenv("COMFY_INPUT_HOST_ALLOWLIST", "").split(",") if value.strip()}
+
+
+async def validate_input_url(value: str) -> None:
+    parsed = urlsplit(value)
+    host = (parsed.hostname or "").lower().rstrip(".")
+    if parsed.scheme not in {"http", "https"} or not host or parsed.username or parsed.password:
+        raise HTTPException(status_code=400, detail="reference image URL is invalid")
+    if host in input_host_allowlist():
+        return
+    try:
+        infos = await asyncio.to_thread(socket.getaddrinfo, host, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
+    except OSError as exc:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved") from exc
+    if not infos:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved")
+    for info in infos:
+        address = ipaddress.ip_address(info[4][0])
+        if not address.is_global:
+            raise HTTPException(status_code=400, detail="reference image URL cannot target a private address")
+
+
+async def download_input_image(client: httpx.AsyncClient, value: str) -> tuple[bytes, str]:
+    await validate_input_url(value)
+    chunks: list[bytes] = []
+    total = 0
+    async with client.stream("GET", value, follow_redirects=False) as response:
+        response.raise_for_status()
+        if 300 <= response.status_code < 400:
+            raise HTTPException(status_code=400, detail="reference image redirects are not accepted")
+        mime_type = response.headers.get("content-type", "image/png").split(";", 1)[0]
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference image URL did not return an image")
+        async for chunk in response.aiter_bytes():
+            total += len(chunk)
+            if total > 30 * 1024 * 1024:
+                raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+            chunks.append(chunk)
+    return b"".join(chunks), mime_type
+
+
+def encode_job(provider_id: str, prompt_id: str) -> str:
+    return base64.urlsafe_b64encode(f"{provider_id}:{prompt_id}".encode()).decode().rstrip("=")
+
+
+def decode_job(job_id: str) -> tuple[Provider, str]:
+    if job_id.startswith(("h3a1.", "h3v2.")):
+        job_id = job_id.split(".", 1)[1]
+    try:
+        raw = base64.urlsafe_b64decode(job_id + "=" * (-len(job_id) % 4)).decode()
+        provider_id, prompt_id = raw.split(":", 1)
+        provider = providers()[provider_id]
+    except Exception as exc:
+        raise HTTPException(status_code=404, detail="job not found") from exc
+    return provider, prompt_id
+
+
+def output_validation_mode() -> str:
+    mode = os.getenv("H3_OUTPUT_VALIDATION_MODE", "guarded").strip()
+    if mode not in {"guarded", "prompt-only"}:
+        raise HTTPException(status_code=503, detail="视频处理模式配置无效，任务未提交")
+    return mode
+
+
+@app.get("/health")
+async def health() -> dict[str, Any]:
+    return {
+        "status": "ok",
+        "providers": len(providers()),
+        "workflows": len(load_registry()),
+        "autoBalance": auto_balance_enabled(),
+        "outputValidationMode": output_validation_mode(),
+    }
+
+
+@app.get("/v1/providers", dependencies=[Depends(require_token)])
+async def list_providers() -> dict[str, Any]:
+    return {"providers": [{"id": item.id, "name": item.name, "baseUrl": item.base_url} for item in providers().values()]}
+
+
+@app.get("/v1/workflows", dependencies=[Depends(require_token)])
+async def list_workflows() -> dict[str, Any]:
+    return {"workflows": [public_workflow(item) for item in load_registry().values()]}
+
+
+@app.get("/v1/models", dependencies=[Depends(require_token)])
+async def list_models() -> dict[str, Any]:
+    return {"object": "list", "data": [public_model(item) for item in load_registry().values()]}
+
+
+async def upload_image(client: httpx.AsyncClient, provider: Provider, value: str, index: int, client_id: str) -> str:
+    value = value.strip()
+    if value.startswith("comfy://"):
+        return value.removeprefix("comfy://")
+    if value.startswith("data:"):
+        header, encoded = value.split(",", 1)
+        mime_type = header.split(";", 1)[0].removeprefix("data:") or "image/png"
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference data URL must contain an image")
+        try:
+            data = base64.b64decode(encoded, validate=True)
+        except (ValueError, base64.binascii.Error) as exc:
+            raise HTTPException(status_code=400, detail="reference image data URL is invalid") from exc
+    elif value.startswith(("http://", "https://")):
+        data, mime_type = await download_input_image(client, value)
+    else:
+        raise HTTPException(status_code=400, detail="input_images must contain http(s), data, or comfy URLs")
+    if len(data) > 30 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+    extension = mimetypes.guess_extension(mime_type) or ".png"
+    filename = f"{client_id}-reference-{index}{extension}"
+    response = await client.post(f"{provider.base_url}/upload/image", files={"image": (filename, data, mime_type)}, data={"overwrite": "true"}, headers=provider_headers(provider))
+    response.raise_for_status()
+    payload = response.json()
+    return str(payload.get("name") or filename)
+
+
+def request_audio_plan(spec, request: JobRequest) -> dict:
+    if not (spec.raw.get("speech_prompt_policy") == "minimax_h3" and spec.raw.get("native_audio_control")):
+        return {"supported": False}
+    if request.generate_audio is False:
+        return {"supported": True, "status": "ready", "normalized_prompt": request.prompt,
+                "dialogue_base_prompt": request.prompt, "dialogue": [], "sound_effects": [],
+                "music": [], "audio_mode": "silent", "silent": True, "speech_requested": False,
+                "expected_transcript": "", "required_seconds": 0, "max_duration_seconds": 15, "issues": []}
+    plan = plan_h3_audio(request.prompt, float(request.duration or 5))
+    if output_validation_mode() == "prompt-only" and not plan["silent"] and plan["audio_mode"] == "silent":
+        plan["audio_mode"] = "effects"
+    return {"supported": True, **plan}
+
+
+@app.post("/v1/audio-plan", dependencies=[Depends(require_token)])
+async def preview_audio_plan(request: JobRequest) -> dict:
+    spec = load_registry().get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    return request_audio_plan(spec, request)
+
+
+@app.post("/v1/jobs", dependencies=[Depends(require_token)])
+async def create_job(request: JobRequest) -> dict[str, Any]:
+    registry = load_registry()
+    spec = registry.get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    try:
+        validate_h3_references(spec, len(request.input_images))
+    except ValueError as error:
+        raise HTTPException(status_code=400, detail=str(error)) from error
+    audio_plan = request_audio_plan(spec, request)
+    guarded_output = bool(audio_plan.get("supported")) and output_validation_mode() == "guarded"
+    if audio_plan.get("supported"):
+        if audio_plan.get("status") != "ready":
+            raise HTTPException(status_code=400, detail="H3_AUDIO_CONFIRMATION_REQUIRED: 请先确认台词及视频时长，再提交视频生成")
+        if not guarded_output:
+            request = request.model_copy(update={"prompt": audio_plan["normalized_prompt"]})
+        try:
+            if guarded_output:
+                validate_visual_dimensions(request.width, request.height)
+                await audio_validator.ready(visual_required=True, audio_required=audio_plan.get("audio_mode") in {"dialogue", "effects"})
+                if audio_plan.get("audio_mode") in {"dialogue", "effects"}:
+                    prompt = await prepare_audio_conditioning(audio_plan, request.prompt, float(request.duration or 5), len(request.input_images))
+                    request = request.model_copy(update={"prompt": prompt})
+        except AudioQualityError as error:
+            raise HTTPException(status_code=503 if error.code.endswith("_UNAVAILABLE") else 400, detail=str(error)) from error
+        except AudioConditioningError as error:
+            raise HTTPException(status_code=503 if error.code == "H3_AUDIO_NORMALIZER_UNAVAILABLE" else 400, detail=str(error)) from error
+    provider = await reserve_provider(request.provider_id)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="provider is not configured")
+    try:
+        client_id = ("canvas-h3v2-" if guarded_output else "canvas-") + secrets.token_hex(8)
+        async with httpx.AsyncClient(timeout=60) as client:
+            uploaded = [await upload_image(client, provider, value, index, client_id) for index, value in enumerate(request.input_images, start=1)]
+            try:
+                workflow = compile_workflow(spec, request.model_dump(), uploaded, client_id, preserve_requested_audio=not guarded_output and bool(audio_plan.get("supported")))
+                if guarded_output:
+                    attach_audio_policy(workflow, audio_plan, float(request.duration or 5), str(spec.raw.get("save_node")), visual_required=True)
+            except ValueError as exc:
+                raise HTTPException(status_code=400, detail=str(exc)) from exc
+            response = await client.post(f"{provider.base_url}/prompt", json={"prompt": workflow, "client_id": client_id}, headers=provider_headers(provider))
+            if response.status_code == 400 and spec.raw.get("speech_prompt_policy") == "minimax_h3":
+                try:
+                    rejected = response.json()
+                except ValueError:
+                    rejected = {}
+                if "h3_caption_pipeline" in (rejected.get("node_errors") or {}) or "H3CaptionPipeline" in str((rejected.get("error") or {}).get("details") or ""):
+                    raise HTTPException(status_code=503, detail="字幕工作流预检未通过，处理组件、模型或字体尚未就绪；任务未进入 GPU 生成，请联系管理员。")
+            response.raise_for_status()
+            payload = response.json()
+    finally:
+        await release_provider(provider)
+    prompt_id = str(payload.get("prompt_id") or "").strip()
+    if not prompt_id:
+        raise HTTPException(status_code=502, detail="ComfyUI did not return prompt_id")
+    job_id = encode_job(provider.id, prompt_id)
+    persisted = True
+    if guarded_output:
+        job_id = "h3v2." + job_id
+        try:
+            audio_validator.register_policy(job_id, audio_plan, float(request.duration or 5), visual_required=True)
+        except AudioQualityError as error:
+            raise HTTPException(status_code=502, detail=str(error)) from error
+        except OSError:
+            # The provider already accepted this exact job. Return its ID rather
+            # than an ambiguous 500 inviting another GPU submission. Its graph
+            # carries the same policy; missing evidence still fails closed.
+            persisted = False
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "workflowKey": spec.key, "workflowRevision": spec.revision, "status": "submitted", "policyPersisted": persisted}
+
+
+def extract_outputs(entry: dict[str, Any], job_id: str) -> list[dict[str, Any]]:
+    result: list[dict[str, Any]] = []
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if not isinstance(item, dict) or not item.get("filename"):
+                    continue
+                filename = str(item["filename"])
+                mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                kind = "video" if mime_type.startswith("video/") or filename.lower().endswith((".gif", ".webp")) and field == "gifs" else "audio" if mime_type.startswith("audio/") else "image"
+                index = len(result)
+                result.append({"index": index, "kind": kind, "mimeType": mime_type, "filename": filename, "url": f"/jobs/{quote(job_id, safe='')}/outputs/{index}"})
+    return result
+
+
+async def job_state(job_id: str) -> tuple[Provider, str, dict[str, Any], list[dict[str, Any]]]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.get(f"{provider.base_url}/history/{quote(prompt_id, safe='')}", headers=provider_headers(provider))
+        response.raise_for_status()
+        history = response.json()
+    entry = history.get(prompt_id) or {}
+    outputs = extract_outputs(entry, job_id)
+    return provider, prompt_id, entry, outputs
+
+
+@app.get("/v1/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def get_job(job_id: str) -> dict[str, Any]:
+    try:
+        provider, prompt_id, entry, outputs = await job_state(job_id)
+    except httpx.TimeoutException:
+        provider, prompt_id = decode_job(job_id)
+        return {
+            "id": job_id,
+            "promptId": prompt_id,
+            "providerId": provider.id,
+            "status": "running",
+            "outputs": [],
+            "error": "",
+            "pollDeferred": True,
+        }
+    status_payload = entry.get("status") or {}
+    if status_payload.get("status_str") == "error":
+        status = "failed"
+    elif outputs and not (job_id.startswith("h3v2.") and not status_payload.get("completed")):
+        status = "succeeded"
+    elif status_payload.get("completed"):
+        status = "failed"
+    else:
+        status = "running"
+    if job_id.startswith("h3v2.") and status != "succeeded":
+        outputs = []
+    if status != "succeeded" and cancellation_dispatched(job_id):
+        # An acknowledged interrupt is not terminal until this exact prompt
+        # disappears from the worker queue. Never infer it from HTTP 200 alone.
+        try:
+            async with httpx.AsyncClient(timeout=10) as client:
+                response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+                response.raise_for_status()
+                queue = response.json()
+            if not isinstance(queue, dict) or not isinstance(queue.get("queue_running"), list) or not isinstance(queue.get("queue_pending"), list):
+                raise ValueError("invalid queue response")
+            remaining = {str(item[1]) for item in queue["queue_running"] + queue["queue_pending"] if isinstance(item, list) and len(item) > 1}
+            if prompt_id not in remaining:
+                status, outputs = "cancelled", []
+            else:
+                return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在取消生成", "cancelRequested": True}
+        except (httpx.HTTPError, ValueError):
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在确认取消", "cancelRequested": True}
+    error = "ComfyUI execution failed" if status == "failed" else ""
+    if status == "failed":
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            # 只映射已识别的内核错误，不向用户返回节点输入、提示词或 traceback。
+            if "tensor strides exceed int32 range" in str(event[1].get("exception_message") or ""):
+                error = "当前时长与分辨率组合超出采样内核范围，请缩短时长后重试（最多 15 秒）"
+                break
+    if status == "failed":
+        hints = {
+            "H3_SUBTITLE_MASK_UNCERTAIN": "检测到疑似字幕，但无法安全区分字幕和产品文字，任务已停止，未返回未清理视频。",
+            "H3_SUBTITLE_RESIDUAL": "字幕清理后仍检测到残留，任务已停止，避免生成双层字幕。",
+            "H3_SPEECH_MISMATCH": "实际口播与原台词不一致，未生成误导字幕；请缩短台词或调整后重试。",
+            "H3_SUBTITLE_ALIGNMENT": "口播时间轴校验未通过，无法准确烧录字幕；请缩短单句台词后重试。",
+            "H3_SUBTITLE_FONT": "字幕含字体不支持的字符，已停止以避免乱码；请使用常见文字。",
+            "H3_SUBTITLE_DEPENDENCY": "字幕处理服务依赖未就绪，请联系管理员；原任务未自动重试。",
+            "H3_SUBTITLE_FRAME_COUNT": "字幕处理前后帧数或尺寸不一致，已停止输出，请联系管理员。",
+        }
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            message = str(event[1].get("exception_message") or "")
+            for code, hint in hints.items():
+                if message.startswith(code + ":"):
+                    error = hint
+                    break
+        # Never expose a partial/raw output from a failed cleanup/quality gate.
+        outputs = []
+    if status == "succeeded":
+        quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+        if quality["status"] in {"pending", "unavailable"}:
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running",
+                    "outputs": [], "error": "", "stage": "正在校验字幕与音轨" if job_id.startswith("h3v2.") or quality.get("visual_required") else "正在校验视频音轨", "pollDeferred": True}
+        if quality["status"] == "failed":
+            status, outputs, error = "failed", [], quality["error"]
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": status, "outputs": outputs, "error": error}
+
+
+@app.post("/v1/jobs/{job_id}/cancel", dependencies=[Depends(require_token)])
+async def cancel_job(job_id: str) -> dict[str, Any]:
+    provider, prompt_id = decode_job(job_id)
+    # Write intent before sending; disk failure must not produce an untracked
+    # cancellation. The worker API atomically compares the running prompt ID.
+    record_cancellation(job_id, False)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.post(f"{provider.base_url}/api/jobs/{quote(prompt_id, safe='')}/cancel", json={}, headers=provider_headers(provider))
+        if response.status_code in (404, 405):
+            raise HTTPException(status_code=409, detail="生成节点未提供按任务取消接口，未中断其他任务")
+        response.raise_for_status()
+        acknowledged = response.json().get("cancelled")
+        if type(acknowledged) is not bool:
+            raise HTTPException(status_code=502, detail="生成节点取消回执无效，请核对原任务状态")
+        if acknowledged:
+            record_cancellation(job_id, True)
+    return await get_job(job_id)
+
+
+@app.get("/v1/jobs/{job_id}/outputs/{index}", dependencies=[Depends(require_token)])
+async def get_output(job_id: str, index: int) -> Response:
+    provider, _, entry, outputs = await job_state(job_id)
+    if (entry.get("status") or {}).get("status_str") == "error":
+        raise HTTPException(status_code=409, detail="任务未成功，未返回部分输出")
+    if not outputs or job_id.startswith("h3v2.") and not (entry.get("status") or {}).get("completed"):
+        raise HTTPException(status_code=409, detail="视频生成尚未完成，未返回部分输出")
+    quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+    if quality["status"] != "verified":
+        raise HTTPException(status_code=422 if quality["status"] == "failed" else 409,
+                            detail=quality.get("error", "视频核验尚未完成，请稍后查询原任务"))
+    if index < 0 or index >= len(outputs):
+        raise HTTPException(status_code=404, detail="output not found")
+    wanted = outputs[index]
+    locator: dict[str, Any] | None = None
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if isinstance(item, dict) and str(item.get("filename")) == wanted["filename"]:
+                    locator = item
+                    break
+            if locator: break
+        if locator: break
+    if locator is None:
+        raise HTTPException(status_code=404, detail="output locator not found")
+    if quality.get("visual_revision") == VISUAL_REVISION:
+        bound_locator = {key: locator.get(key, "output" if key == "type" else "") for key in ("filename", "subfolder", "type")}
+        try:
+            media = await audio_validator.verified_download(quality, bound_locator, provider.base_url, provider_headers(provider))
+        except AudioQualityError as error:
+            raise HTTPException(status_code=422, detail=str(error)) from error
+        except (httpx.HTTPError, OSError, asyncio.TimeoutError):
+            raise HTTPException(status_code=503, detail="H3_VISUAL_VALIDATION_UNAVAILABLE: 已核验视频暂不可读取，请查询原任务") from None
+        return Response(content=media, media_type=wanted["mimeType"], headers={"Cache-Control": "private, no-store"})
+    query = urlencode({"filename": locator.get("filename", ""), "subfolder": locator.get("subfolder", ""), "type": locator.get("type", "output")})
+    client = httpx.AsyncClient(timeout=120)
+    response = await client.send(client.build_request("GET", f"{provider.base_url}/view?{query}", headers=provider_headers(provider)), stream=True)
+    if response.status_code >= 400:
+        await response.aclose(); await client.aclose()
+        raise HTTPException(status_code=502, detail="failed to read ComfyUI output")
+    async def stream():
+        try:
+            async for chunk in response.aiter_bytes():
+                yield chunk
+        finally:
+            await response.aclose(); await client.aclose()
+    return StreamingResponse(stream(), media_type=response.headers.get("content-type", wanted["mimeType"]))
diff --git a/integration-work/image-pool-preflight.py b/integration-work/image-pool-preflight.py
new file mode 100644
index 0000000..75a0b6c
--- /dev/null
+++ b/integration-work/image-pool-preflight.py
@@ -0,0 +1,38 @@
+"""Read-only live image workflow and scheduler checks; never submits a prompt."""
+import asyncio,json
+from unittest.mock import patch
+import httpx,app
+from workflow import compile_workflow,load_registry
+async def main():
+    spec=load_registry()['qwen_image_2_1']
+    report={'auto_balance':app.auto_balance_enabled(),'admitted':sorted(app.admission_ids(app.providers())),'workers':[]}
+    async with httpx.AsyncClient(timeout=30) as client:
+        for p in app.providers().values():
+            r=await client.get(p.base_url+'/object_info',headers=app.provider_headers(p));r.raise_for_status();info=r.json()
+            modes={}
+            for refs in (0,1):
+                graph=compile_workflow(spec,{'prompt':'A ceramic teacup on a wooden table.','width':512,'height':512,'batch_size':1},['preflight.png']*refs,'image-pool-preflight')
+                missing=sorted({n['class_type'] for n in graph.values()}-set(info))
+                choices=[]
+                for node in graph.values():
+                    ni=info.get(node['class_type'],{}).get('input',{})
+                    fields={**ni.get('required',{}),**ni.get('optional',{})}
+                    for name,value in node.get('inputs',{}).items():
+                        field=fields.get(name)
+                        if not isinstance(value,str) or not field or name=='image':continue
+                        options=field[0] if isinstance(field[0],list) else field[1].get('options') if len(field)>1 and isinstance(field[1],dict) else None
+                        if options: options=[o.get('key') if isinstance(o,dict) else o for o in options]
+                        if options and value not in options: choices.append([node['class_type'],name,value])
+                modes['reference' if refs else 'text']={'missing_nodes':missing,'missing_models_or_options':choices}
+            report['workers'].append({'id':p.id,'queue_depth':await app.provider_queue_depth(p),'modes':modes})
+    async def depth(p):return depths[p.id]
+    with patch.object(app,'provider_queue_depth',depth):
+        report['scheduler']={}
+        for label,depths in [('gpu2_busy',{'default':2,'gpu3':0}),('gpu3_busy',{'default':0,'gpu3':2}),('gpu2_unavailable',{'default':None,'gpu3':0})]:
+            report['scheduler'][label]=(await app.select_provider('default')).id
+        depths={'default':0,'gpu3':0}
+        first=await app.reserve_provider('default');second=await app.reserve_provider('default')
+        report['scheduler']['parallel_submissions']=[first.id,second.id]
+        await app.release_provider(first);await app.release_provider(second)
+    print(json.dumps(report))
+asyncio.run(main())
diff --git a/integration-work/inspect_8189_integration.py b/integration-work/inspect_8189_integration.py
new file mode 100644
index 0000000..e7c65db
--- /dev/null
+++ b/integration-work/inspect_8189_integration.py
@@ -0,0 +1,33 @@
+import subprocess,json,pathlib
+def run(*a):return subprocess.check_output(a,text=True)
+for name in ('comfyui-manju',):
+ code="""import pathlib,json,urllib.request
+p=pathlib.Path('/app/server.py'); s=p.read_text();print('scoped_cancel_api', '/api/jobs/{job_id}/cancel' in s)
+with urllib.request.urlopen('http://127.0.0.1:8188/queue') as r:q=json.load(r)
+print('queue', {k:[x[1] for x in q.get(k,[])] for k in ('queue_running','queue_pending')})
+with urllib.request.urlopen('http://127.0.0.1:8188/history') as r:h=json.load(r)
+print('history_count',len(h))
+p=pathlib.Path('/recovery/allowed_node_classes.json');print('allowlist_count',len(json.loads(p.read_text())['required_classes']) if p.exists() else 0)
+"""
+ print(name,run('docker','exec',name,'python','-c',code))
+code="""import app,inspect
+for name in ('submit_job','create_job','provider_queue_depth','job_state'):
+ f=getattr(app,name,None)
+ if f:print(inspect.getsource(f))
+"""
+path=pathlib.Path('/home/ps/huobao-gpu-selection/normalizer-current-read.txt')
+path.write_text(run('docker','exec','huobao-vdn-normalizer','python','-c',code))
+print('normalizer functions saved',path)
+code="""import app,asyncio,httpx,json
+async def main():
+ async with httpx.AsyncClient(timeout=10) as c:
+  for p in app.providers().values():
+   q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+   print(json.dumps({'id':p.id,'queue':{k:[x[1] for x in q.get(k,[])] for k in ('queue_running','queue_pending')}}))
+asyncio.run(main())
+"""
+print(run('docker','exec','huobao-vdn-normalizer','python','-c',code))
+# Verify GPU3 panel upstream identity without printing credentials.
+p=pathlib.Path('/home/www/open-ai-canvas/.releases/h3-gpu3-panel-8191-20261014-8a5f/nginx.conf')
+for line in p.read_text().splitlines():
+ if 'set $gpu3' in line:print(line)
diff --git a/integration-work/inspect_bridge_live.py b/integration-work/inspect_bridge_live.py
new file mode 100644
index 0000000..1151929
--- /dev/null
+++ b/integration-work/inspect_bridge_live.py
@@ -0,0 +1,4 @@
+import hashlib,pathlib
+for folder in ('/home/ps/huobao-model-bridge','/home/ps/huobao-vdn/bridge'):
+ p=pathlib.Path(folder)/'bridge.py'
+ print(folder, hashlib.sha256(p.read_bytes()).hexdigest(), 'cancel route:', '/cancel' in p.read_text())
diff --git a/integration-work/inspect_comfy_ports.py b/integration-work/inspect_comfy_ports.py
new file mode 100644
index 0000000..3e07593
--- /dev/null
+++ b/integration-work/inspect_comfy_ports.py
@@ -0,0 +1,7 @@
+import json,subprocess
+for name in ('huobao-comfy-gpu1','comfyui','h3-caption-gpu3-canary-8a5f'):
+ d=json.loads(subprocess.check_output(['docker','inspect',name],text=True))[0]
+ print(json.dumps({'name':name,'running':d['State']['Running'],'ports':d['NetworkSettings']['Ports'],
+  'port_bindings':d['HostConfig']['PortBindings'],'exposed_ports':d['Config'].get('ExposedPorts'),
+  'gpu':d['HostConfig'].get('DeviceRequests'),
+  'networks':{k:{'aliases':v.get('Aliases'),'ipv4':v.get('IPAddress')} for k,v in d['NetworkSettings']['Networks'].items()}}))
diff --git a/integration-work/inspect_gpu1.py b/integration-work/inspect_gpu1.py
new file mode 100644
index 0000000..4270fa0
--- /dev/null
+++ b/integration-work/inspect_gpu1.py
@@ -0,0 +1,14 @@
+import subprocess,json,pathlib
+def run(*a):return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+print(run('nvidia-smi','--query-compute-apps=gpu_uuid,pid,process_name,used_gpu_memory','--format=csv,noheader'))
+for name in run('docker','ps','--format','{{.Names}}').splitlines():
+ d=json.loads(run('docker','inspect',name))[0]
+ req=d['HostConfig'].get('DeviceRequests')
+ if req:
+  print(json.dumps({'name':name,'devices':req,'state':d['State']['Status'],'image':d['Config']['Image']},ensure_ascii=False))
+for name in ('comfyui','h3-caption-gpu3-canary-8a5f'):
+ d=json.loads(run('docker','inspect',name))[0]
+ print(name,'security',{'user':d['Config']['User'],'readOnly':d['HostConfig']['ReadonlyRootfs'],'privileged':d['HostConfig']['Privileged'],'capAdd':d['HostConfig']['CapAdd'],'network':list(d['NetworkSettings']['Networks'])})
+ if name.startswith('h3-caption'):
+  for m in d['Mounts']:
+   if m['Destination']=='/run/h3-control': print('control',json.loads((pathlib.Path(m['Source'])/'control.json').read_text()))
diff --git a/integration-work/inspect_gpu3_history.py b/integration-work/inspect_gpu3_history.py
new file mode 100644
index 0000000..81c7149
--- /dev/null
+++ b/integration-work/inspect_gpu3_history.py
@@ -0,0 +1,17 @@
+import json,subprocess,pathlib
+def run(*a):return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+code="""from pathlib import Path
+files=[Path('/app')/n for n in ('main.py','server.py','execution.py','comfy_extras/nodes_string.py')]
+files+=list(Path('/app/custom_nodes/ComfyUI-H3CaptionPipeline').rglob('*.py'))
+for p in files:
+ lines=p.read_text(errors='replace').splitlines()
+ for i,line in enumerate(lines):
+  if 'H3_HISTORY' in line or 'history_snapshot' in line or 'WORKER_CONTROL' in line:
+   print(str(p),i+1,'\\n'.join(lines[max(0,i-3):i+8]))
+"""
+print(run('docker','exec','h3-caption-gpu3-canary-8a5f','python','-c',code))
+root='/home/www/open-ai-canvas/.releases/h3-rolling-gpu-update-20261009-8a5f/comfy-veda-v14-20261010/custom_nodes'
+names=run('docker','ps','-a','--format','{{.Names}}').splitlines()
+for name in names:
+ d=json.loads(run('docker','inspect',name))[0]
+ if any(m['Source']==root for m in d['Mounts']): print('shares GPU3 plugin root:',name)
diff --git a/integration-work/inspect_gpu3_install.py b/integration-work/inspect_gpu3_install.py
new file mode 100644
index 0000000..1f2a36f
--- /dev/null
+++ b/integration-work/inspect_gpu3_install.py
@@ -0,0 +1,31 @@
+import subprocess,json,pathlib
+def run(*a):return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+for name in ('comfyui','h3-caption-gpu3-canary-8a5f'):
+ d=json.loads(run('docker','inspect',name))[0]
+ print(name,'entrypoint',d['Config']['Entrypoint'],'restart',d['HostConfig']['RestartPolicy'])
+ code="""import pathlib,json
+p=pathlib.Path('/app/custom_nodes')
+print('plugins',[(x.name, x.is_dir()) for x in p.iterdir() if not x.name.startswith('.')])
+for name in ('ComfyUI-VDN-H3','comfyui-SelfLift','ComfyUI-MMH3Tools','Comfyui_Minimax_h3_latent_Upscaler'):
+ d=p/name
+ print(name,'exists',d.exists())
+ for req in ('requirements.txt','pyproject.toml'):
+  f=d/req
+  if f.exists(): print(name,req,f.read_text()[:2500])
+"""
+ print(run('docker','exec',name,'python','-c',code))
+code="""import asyncio,httpx,json,app
+async def main():
+ async with httpx.AsyncClient(timeout=20) as c:
+  graph=json.load(open('/app/workflows/vdn_hd.json'))
+  for p in app.providers().values():
+   objects=(await c.get(p.base_url+'/object_info',headers=app.provider_headers(p))).json()
+   queue=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+   print(p.id, 'missing', sorted({v['class_type'] for v in graph.values()}-objects.keys()), 'queue', {k:[x[1] for x in queue.get(k,[])] for k in ('queue_running','queue_pending')})
+ for name in ('providers','admission_ids','create_job'):
+  import inspect
+  try: print(inspect.getsource(getattr(app,name)))
+  except: pass
+asyncio.run(main())
+"""
+print(run('docker','exec','huobao-vdn-normalizer','python','-c',code))
diff --git a/integration-work/inspect_gpu_maintenance.py b/integration-work/inspect_gpu_maintenance.py
new file mode 100644
index 0000000..1bb4c2c
--- /dev/null
+++ b/integration-work/inspect_gpu_maintenance.py
@@ -0,0 +1,16 @@
+import subprocess,json,pathlib,os
+def run(*a):return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+gpu=json.loads(run('docker','inspect','h3-caption-gpu3-canary-8a5f'))[0]
+env=dict(x.split('=',1) for x in gpu['Config']['Env'])
+print('history environment',{k:v for k,v in env.items() if k.startswith('H3_HISTORY')})
+for k in ('H3_WORKER_CONTROL_FILE','H3_CANARY_TOKEN_FILE'): print(k,env.get(k))
+for m in gpu['Mounts']:
+ if m['Destination'] in ('/h3-process-launch.py','/run/h3-control','/app/custom_nodes','/run/h3-history.json'):
+  p=pathlib.Path(m['Source']);print('path',str(p),'writable',os.access(p,os.W_OK))
+  if p.name=='process_launch.py': print(p.read_text()[:12000])
+print('GPU3 main boot',run('docker','exec','h3-caption-gpu3-canary-8a5f','python','-c',"from pathlib import Path; p=Path('/app/main.py');s=p.read_text();print(s[:7000])"))
+normal=json.loads(run('docker','inspect','canvas-h3-prompt-normalizer-healthy-20261026'))[0]
+en=dict(x.split('=',1) for x in normal['Config']['Env']);fn=en.get('COMFY_ADMISSION_FILE');print('admission file',fn)
+for m in normal['Mounts']:
+ if fn and fn.startswith(m['Destination']+'/'):
+  p=pathlib.Path(m['Source'])/fn[len(m['Destination'])+1:];print('admission host',str(p),'writable',os.access(p,os.W_OK),'content',p.read_text())
diff --git a/integration-work/inspect_gpu_selection.py b/integration-work/inspect_gpu_selection.py
new file mode 100644
index 0000000..d8f64f4
--- /dev/null
+++ b/integration-work/inspect_gpu_selection.py
@@ -0,0 +1,24 @@
+import json,subprocess
+def run(*a): return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+print(run('nvidia-smi','--query-gpu=index,uuid,name,memory.used,utilization.gpu','--format=csv,noheader'))
+for name in ('comfyui','h3-caption-gpu3-canary-8a5f','canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer'):
+ d=json.loads(run('docker','inspect',name))[0]
+ print(json.dumps({'name':name,'image':d['Config']['Image'],'gpu':d['HostConfig'].get('DeviceRequests'),'mounts':[{'src':m['Source'],'dst':m['Destination'],'rw':m['RW']} for m in d['Mounts']],'cmd':d['Config']['Cmd']},ensure_ascii=False))
+for name in ('comfyui','h3-caption-gpu3-canary-8a5f'):
+ code="""import json,pathlib
+for root in ('/app/ComfyUI','/workspace/ComfyUI','/comfyui','/opt/ComfyUI'):
+ p=pathlib.Path(root)
+ if (p/'custom_nodes').exists():
+  print(root, [x.name for x in (p/'custom_nodes').iterdir() if x.is_dir()])
+"""
+ print(name,run('docker','exec',name,'python','-c',code))
+code="""import inspect,app
+for name in dir(app):
+ if any(s in name.lower() for s in ('select_provider','choose_provider','reserve_provider','queue_depth')):
+  value=getattr(app,name)
+  if callable(value):
+   try: print(inspect.getsource(value))
+   except: pass
+print(inspect.getsource(app.JobRequest) if hasattr(app,'JobRequest') else '')
+"""
+print(run('docker','exec','huobao-vdn-normalizer','python','-c',code))
diff --git a/integration-work/inspect_image_details.py b/integration-work/inspect_image_details.py
new file mode 100644
index 0000000..c383124
--- /dev/null
+++ b/integration-work/inspect_image_details.py
@@ -0,0 +1,17 @@
+import subprocess
+code="""import asyncio,httpx,json,app
+async def main():
+ p=app.providers()['default']
+ async with httpx.AsyncClient(timeout=20) as c:
+  d=(await c.get(p.base_url+'/object_info',headers=app.provider_headers(p))).json()
+  print('save_format',json.dumps(d['SaveImageAdvanced']['input']))
+  r=await c.get(p.base_url+'/history/b20376e4-1cb3-4d70-95f5-e07f8794e3df',headers=app.provider_headers(p))
+  j=r.json().get('b20376e4-1cb3-4d70-95f5-e07f8794e3df',{})
+  print('VDN history',json.dumps({'status':j.get('status'),'outputs':list(j.get('outputs',{}))}))
+  q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+  print('queues',json.dumps({k:[{'id':i[1],'nodes':len(i[2])} for i in q.get(k,[])] for k in ['queue_running','queue_pending']}))
+asyncio.run(main())
+"""
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
+logs=subprocess.run(['docker','logs','--tail','12','comfyui'],text=True,capture_output=True)
+print((logs.stdout+logs.stderr)[-3000:])
diff --git a/integration-work/inspect_image_pool.py b/integration-work/inspect_image_pool.py
new file mode 100644
index 0000000..14e75c0
--- /dev/null
+++ b/integration-work/inspect_image_pool.py
@@ -0,0 +1,6 @@
+import subprocess
+from pathlib import Path
+code=Path('/home/ps/huobao-model-bridge/image-pool-preflight.py').read_text()
+r=subprocess.run(['docker','exec','-i','canvas-h3-prompt-normalizer-healthy-20261026','python','-'],input=code,capture_output=True,text=True,check=True)
+print(r.stdout)
+print(subprocess.check_output(['nvidia-smi','--query-gpu=index,memory.used,memory.total,utilization.gpu','--format=csv,noheader'],text=True))
diff --git a/integration-work/inspect_interface_workflows.py b/integration-work/inspect_interface_workflows.py
new file mode 100644
index 0000000..4ad715a
--- /dev/null
+++ b/integration-work/inspect_interface_workflows.py
@@ -0,0 +1,17 @@
+import json,subprocess,urllib.request
+for port in (8188,8189,8191):
+ with urllib.request.urlopen(f'http://192.168.110.111:{port}/object_info',timeout=30) as r:obj=json.load(r)
+ with urllib.request.urlopen(f'http://192.168.110.111:{port}/queue',timeout=10) as r:q=json.load(r)
+ wanted=['ApplyVDNH3','H3ModelLoader','H3VideoSampler','QwenImage','LTX','Wan','MiniMax','H3']
+ names=[k for k in obj if any(w.lower() in k.lower() for w in wanted)]
+ print(json.dumps({'port':port,'node_count':len(obj),'relevant_nodes':names,'queue':{k:[x[1] for x in q.get(k,[])] for k in ('queue_running','queue_pending')}}))
+for name in ('comfyui-manju','h3-gpu3-panel-8191-8a5f'):
+ d=json.loads(subprocess.check_output(['docker','inspect',name],text=True))[0]
+ print(json.dumps({'name':name,'mounts':[{'source':m['Source'],'dest':m['Destination'],'rw':m['RW']} for m in d['Mounts']],
+   'command':d['Config']['Cmd'],'user':d['Config']['User'],'readonly':d['HostConfig']['ReadonlyRootfs']}))
+ if 'panel' in name:
+  # Only proxy directives, never auth/password header values.
+  raw=subprocess.run(['docker','exec',name,'nginx','-T'],capture_output=True,text=True)
+  print('\n'.join(l for l in raw.stdout.splitlines() if any(x in l for x in ('listen ','upstream ','server comfy','proxy_pass','location ','proxy_read_timeout'))))
+code="import app,inspect;print(inspect.getsource(app.provider_headers));print(inspect.getsource(app.providers))"
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
diff --git a/integration-work/inspect_new_workers.py b/integration-work/inspect_new_workers.py
new file mode 100644
index 0000000..09b622a
--- /dev/null
+++ b/integration-work/inspect_new_workers.py
@@ -0,0 +1,21 @@
+import subprocess,json
+def run(*a):return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+for name in ('h3-caption-gpu3-canary-8a5f','huobao-comfy-gpu1'):
+ try:d=json.loads(run('docker','inspect',name))[0]
+ except subprocess.CalledProcessError:continue
+ print(name,d['State']['Status'])
+ r=subprocess.run(['docker','logs','--tail','100',name],capture_output=True,text=True)
+ lines=(r.stdout+r.stderr).replace('\r','\n').splitlines()
+ for l in lines:
+  if any(s in l for s in ('Traceback','Error','VDN','history restored','Cannot import','To see the GUI','Starting server','SelfLift','Total VRAM')):print(l[:700])
+code='''import asyncio,httpx,json,app
+async def main():
+ async with httpx.AsyncClient(timeout=15) as c:
+  for p in app.providers().values():
+   try:
+    r=await c.get(p.base_url+'/object_info/ApplyVDNH3',headers=app.provider_headers(p));d=r.json()
+    print(p.id,'VDN ready',r.status_code==200 and 'ApplyVDNH3' in d)
+   except Exception as e:print(p.id,type(e).__name__)
+asyncio.run(main())
+'''
+print(run('docker','exec','huobao-vdn-normalizer','python','-c',code))
diff --git a/integration-work/inspect_scoped_worker.py b/integration-work/inspect_scoped_worker.py
new file mode 100644
index 0000000..d934a9e
--- /dev/null
+++ b/integration-work/inspect_scoped_worker.py
@@ -0,0 +1,10 @@
+import subprocess
+for name in ('huobao-comfy-gpu1','comfyui','h3-caption-gpu3-canary-8a5f'):
+    code="""from pathlib import Path
+for p in [Path('/app/server.py'), *Path('/app/app').rglob('*.py'), *Path('/app/custom_nodes/ComfyUI-H3CaptionPipeline').rglob('*.py')]:
+ s=p.read_text(errors='replace'); lines=s.splitlines()
+ for i,line in enumerate(lines):
+  if '/cancel' in line and ('route' in line or 'jobs' in line):
+   print(str(p), '\\n'.join(lines[max(0,i-3):i+55]))
+"""
+    print(name,subprocess.check_output(['docker','exec',name,'python','-c',code],text=True))
diff --git a/integration-work/inspect_targeted_cancel.py b/integration-work/inspect_targeted_cancel.py
new file mode 100644
index 0000000..ba8408a
--- /dev/null
+++ b/integration-work/inspect_targeted_cancel.py
@@ -0,0 +1,10 @@
+import subprocess
+code="""from pathlib import Path
+lines=Path('/app/server.py').read_text().splitlines()
+for i,line in enumerate(lines):
+ if '@routes.post(\"/interrupt\")' in line or '@routes.post(\"/queue\")' in line:
+  print('\\n'.join(lines[i:i+38]))
+"""
+for name in ('comfyui','h3-caption-gpu3-canary-8a5f'):
+ print(name,subprocess.check_output(['docker','exec',name,'python','-c',code],text=True))
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',"import app,inspect; print(inspect.getsource(app.decode_job)); print(inspect.getsource(app.get_job))"],text=True))
diff --git a/integration-work/inspect_three_comfy_interfaces.py b/integration-work/inspect_three_comfy_interfaces.py
new file mode 100644
index 0000000..2296938
--- /dev/null
+++ b/integration-work/inspect_three_comfy_interfaces.py
@@ -0,0 +1,23 @@
+import json,subprocess,urllib.request,urllib.error
+ids=subprocess.check_output(['docker','ps','-q'],text=True).split()
+for cid in ids:
+ d=json.loads(subprocess.check_output(['docker','inspect',cid],text=True))[0]
+ name=d['Name'].lstrip('/'); ports=d['NetworkSettings'].get('Ports') or {}
+ published={x.get('HostPort') for values in ports.values() for x in (values or [])}
+ if not ('comfy' in name or published.intersection({'8188','8189','8191'})):continue
+ print(json.dumps({'container':name,'ports':ports,'gpu':d['HostConfig'].get('DeviceRequests'),
+ 'image':d['Config']['Image'],'networks':{k:{'ip':v.get('IPAddress'),'aliases':v.get('Aliases')} for k,v in d['NetworkSettings']['Networks'].items()}}))
+print(subprocess.check_output(['ss','-ltn'],text=True))
+for port in (8188,8189,8191):
+ for endpoint in ('/','/system_stats'):
+  try:
+   with urllib.request.urlopen(f'http://192.168.110.111:{port}'+endpoint,timeout=10) as r:
+    content=r.read(); report={'port':port,'path':endpoint,'status':r.status,'type':r.headers.get('Content-Type')}
+    if endpoint=='/system_stats':
+     try:report['devices']=json.loads(content).get('devices')
+     except ValueError:pass
+    print(json.dumps(report))
+  except Exception as e:print(json.dumps({'port':port,'path':endpoint,'error':type(e).__name__,'status':getattr(e,'code',None)}))
+for name in ('canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer'):
+ code="import app,json;print(json.dumps([{'id':p.id,'url':p.base_url} for p in app.providers().values()]))"
+ print(name,subprocess.check_output(['docker','exec',name,'python','-c',code],text=True))
diff --git a/integration-work/inspect_timeout_workers.py b/integration-work/inspect_timeout_workers.py
new file mode 100644
index 0000000..d61c333
--- /dev/null
+++ b/integration-work/inspect_timeout_workers.py
@@ -0,0 +1,17 @@
+import subprocess,json,pathlib
+for name in ['comfyui-manju','huobao-comfy-gpu1','comfyui','h3-caption-gpu3-canary-8a5f','canvas-h3-prompt-normalizer-healthy-20261026']:
+ d=json.loads(subprocess.check_output(['docker','inspect',name],text=True))[0]
+ print(json.dumps({'name':name,'status':d['State']['Status'],'started':d['State']['StartedAt'],'restarts':d['RestartCount'],'oom_killed':d['State']['OOMKilled'],'image':d['Config']['Image'],'command':d['Config']['Cmd'][-10:]}))
+ if name=='comfyui-manju':
+  print('MOUNTS',json.dumps([{k:m.get(k) for k in ['Source','Destination']} for m in d['Mounts'] if 'history' in m.get('Destination','') or 'control' in m.get('Destination','')]))
+  r=subprocess.run(['docker','logs','--tail','160',name],capture_output=True,text=True)
+  lines=(r.stdout+r.stderr).replace('\r','\n').splitlines()
+  for line in lines:
+   if any(w.lower() in line.lower() for w in ['error','exception','traceback','Prompt executed','restor','%|','out of memory','starting server']):print(line[:400])
+code='''import app,json,asyncio,httpx
+async def main():
+ async with httpx.AsyncClient(timeout=15) as c:
+  p=app.providers()['gpu1_8189'];r=await c.get(p.base_url+'/history',headers=app.provider_headers(p));h=r.json()
+  print(json.dumps({'gpu1_history_count':len(h),'history_ids':list(h)[-12:]}))
+asyncio.run(main())'''
+print(subprocess.check_output(['docker','exec','canvas-h3-prompt-normalizer-healthy-20261026','python','-c',code],text=True))
diff --git a/integration-work/inspect_token_rule.py b/integration-work/inspect_token_rule.py
new file mode 100644
index 0000000..e088e36
--- /dev/null
+++ b/integration-work/inspect_token_rule.py
@@ -0,0 +1,2 @@
+import subprocess
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c','import app,inspect; print(inspect.getsource(app.provider_headers))'],text=True))
diff --git a/integration-work/inspect_vdn.py b/integration-work/inspect_vdn.py
new file mode 100644
index 0000000..dcbdc9f
--- /dev/null
+++ b/integration-work/inspect_vdn.py
@@ -0,0 +1,16 @@
+import subprocess,json
+def run(*args):
+    return subprocess.check_output(args,text=True)
+n=json.loads(run('docker','inspect','canvas-h3-prompt-normalizer-healthy-20261026'))[0]
+env=dict(x.split('=',1) for x in n['Config']['Env'])
+print('env', {k:v for k,v in env.items() if k in ('COMFY_PROVIDERS_JSON','COMFY_AUTO_BALANCE','H3_OUTPUT_VALIDATION_MODE','H3_ADMISSION_FILE')})
+print('mounts', [(m['Source'],m['Destination']) for m in n['Mounts']])
+print('cmd',n['Config']['Cmd'])
+print('image',n['Image'])
+code='''import urllib.request,json
+data=json.load(urllib.request.urlopen('http://comfyui:8188/object_info'))
+names=['ApplyVDNH3','PrimitiveFloat','Float','FloatConstant','MathExpression|pysssss','MiniMaxH3ReferenceToVideo','SelfLiftH3Sampler','VHS_VideoCombine']
+for name in names:
+ if name in data: print(json.dumps({name:data[name]['input']}))
+'''
+print(run('docker','exec','canvas-h3-prompt-normalizer-healthy-20261026','python','-c',code))
diff --git a/integration-work/inspect_vdn_networks.py b/integration-work/inspect_vdn_networks.py
new file mode 100644
index 0000000..8041175
--- /dev/null
+++ b/integration-work/inspect_vdn_networks.py
@@ -0,0 +1,4 @@
+import json,subprocess
+for name in ('canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer','comfyui','h3-caption-gpu3-canary-8a5f'):
+    obj=json.loads(subprocess.check_output(['docker','inspect',name],text=True))[0]
+    print(name, 'networks', list(obj['NetworkSettings']['Networks']), 'extra_hosts',obj['HostConfig']['ExtraHosts'])
diff --git a/integration-work/inspect_vdn_stage.py b/integration-work/inspect_vdn_stage.py
new file mode 100644
index 0000000..19a8794
--- /dev/null
+++ b/integration-work/inspect_vdn_stage.py
@@ -0,0 +1,4 @@
+from pathlib import Path
+p=Path('/home/ps/huobao-vdn/app.py').read_text()
+i=p.find('async def provider_queue_depth')
+print(p[i:i+2000])
diff --git a/integration-work/install_gpu1_worker.py b/integration-work/install_gpu1_worker.py
new file mode 100644
index 0000000..f0b6737
--- /dev/null
+++ b/integration-work/install_gpu1_worker.py
@@ -0,0 +1,35 @@
+"""Prepare a reviewable GPU1 container definition; this script starts no services."""
+import pathlib,json,hashlib,secrets,subprocess,sys
+sys.path.insert(0,'/home/ps/huobao-gpu-selection')
+from docker_worker_ops import api,inspect,clone,set_env,replace_bind,write_json
+root=pathlib.Path('/home/ps/huobao-gpu-selection');work=root/'gpu1';name='huobao-comfy-gpu1'
+assert not work.exists(),'GPU1 preparation already exists; inspect rather than overwrite'
+work.mkdir(mode=0o700)
+source=inspect('comfyui');cfg=clone(source,name)
+write_json(work/'source.inspect.json',source)
+for kind in ('input','output','user','temp','control'):(work/kind).mkdir(mode=0o700)
+token=secrets.token_hex(32);(work/'control/canary.token').write_text(token);(work/'control/canary.token').chmod(0o600)
+write_json(work/'control/control.json',{'schema':1,'maintenance':True,'purpose':'Huobao GPU1 authenticated submissions only'})
+hist=work/'history.json';write_json(hist,{'schema':1,'queue_empty':True,'source_container_id':'huobao-gpu1-initial','history':{}})
+for kind in ('input','output','user','temp'):replace_bind(cfg,'/app/'+kind,work/kind)
+replace_bind(cfg,'/run/h3-control',work/'control')
+replace_bind(cfg,'/run/h3-history.json',hist)
+set_env(cfg,'H3_HISTORY_SNAPSHOT_SHA256',hashlib.sha256(hist.read_bytes()).hexdigest())
+set_env(cfg,'H3_HISTORY_SOURCE_CONTAINER_ID','huobao-gpu1-initial')
+# Reuse the existing read-only visual-verification socket, not its GPU workload.
+control=next(m['Source'] for m in source['Mounts'] if m['Destination']=='/run/h3-control')
+vision=pathlib.Path(control)/'vision'
+if vision.exists():
+ cfg['HostConfig']['Binds'].append(str(vision)+':/run/h3-shared-vision:ro')
+ set_env(cfg,'H3_VISION_SOCKET','/run/h3-shared-vision/vision.sock')
+for i,a in enumerate(cfg['Cmd']):
+ if a=='--temp-directory':cfg['Cmd'][i+1]='/app/temp'
+cfg['Cmd']+=['--reserve-vram','8']
+cfg['HostConfig']['DeviceRequests']=[{'Driver':'nvidia','Count':0,'DeviceIDs':['1'],'Capabilities':[['gpu','gpu']],'Options':{}}]
+cfg['HostConfig']['PortBindings']={};cfg['HostConfig']['PublishAllPorts']=False
+cfg['HostConfig']['NetworkMode']='zq-platform-network'
+cfg['NetworkingConfig']={'EndpointsConfig':{'zq-platform-network':{'Aliases':[name]}}}
+cfg['HostConfig']['RestartPolicy']={'Name':'unless-stopped','MaximumRetryCount':0}
+assert cfg['HostConfig']['Privileged'] is False and cfg['HostConfig']['ReadonlyRootfs'] is True
+write_json(work/'create.json',cfg)
+print('Prepared GPU1 definition only; no container created or started. Device 1, reserve 8 GiB, private zq-platform-network, no host ports, read-only root, user 1000.')
diff --git a/integration-work/install_gpu3_vdn.py b/integration-work/install_gpu3_vdn.py
new file mode 100644
index 0000000..a13eb16
--- /dev/null
+++ b/integration-work/install_gpu3_vdn.py
@@ -0,0 +1,41 @@
+import pathlib,json,hashlib,subprocess,sys,datetime,shutil
+sys.path.insert(0,'/home/ps/huobao-gpu-selection')
+from docker_worker_ops import api,inspect,clone,set_env,replace_bind,write_json
+root=pathlib.Path('/home/ps/huobao-gpu-selection');work=root/'gpu3-vdn';name='h3-caption-gpu3-canary-8a5f'
+assert not work.exists(),'GPU3 preparation already exists; inspect rather than overwrite'
+work.mkdir(mode=0o700);source=inspect(name);write_json(work/'source.inspect.json',source)
+control=pathlib.Path(next(m['Source'] for m in source['Mounts'] if m['Destination']=='/run/h3-control'))/'control.json'
+original=control.read_bytes();(work/'original-control.json').write_bytes(original)
+value=json.loads(original);value['maintenance']=True;control.write_text(json.dumps(value))
+code='''import asyncio,httpx,json,app
+async def main():
+ p=app.providers()['gpu3']
+ async with httpx.AsyncClient(timeout=40) as c:
+  q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+  assert not q.get('queue_running') and not q.get('queue_pending'),'GPU3 still has jobs; no restart allowed'
+  r=await c.get(p.base_url+'/history',headers=app.provider_headers(p));r.raise_for_status();history=r.json()
+  assert all(v.get('status',{}).get('status_str') in ('success','error') for v in history.values())
+  q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+  assert not q.get('queue_running') and not q.get('queue_pending'),'GPU3 changed while snapshotting'
+  print(json.dumps(history))
+asyncio.run(main())
+'''
+try:
+ history=json.loads(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
+except Exception:
+ control.write_bytes(original);raise
+hist=work/'history.json';write_json(hist,{'schema':1,'queue_empty':True,'source_container_id':source['Id'],'history':history})
+assert hist.stat().st_size<256*1024**2
+gpu2=inspect('comfyui');nodes=pathlib.Path(next(m['Source'] for m in gpu2['Mounts'] if m['Destination']=='/app/custom_nodes'))
+plugin=work/'ComfyUI-VDN-H3';shutil.copytree(nodes/'ComfyUI-VDN-H3',plugin,ignore=shutil.ignore_patterns('__pycache__','.git'))
+assert (plugin/'__init__.py').is_file()
+cfg=clone(source,name);replace_bind(cfg,'/run/h3-history.json',hist)
+cfg['HostConfig']['Binds'].append(str(plugin)+':/app/custom_nodes/ComfyUI-VDN-H3:ro')
+set_env(cfg,'H3_HISTORY_SNAPSHOT_SHA256',hashlib.sha256(hist.read_bytes()).hexdigest());set_env(cfg,'H3_HISTORY_SOURCE_CONTAINER_ID',source['Id'])
+cfg['NetworkingConfig']={'EndpointsConfig':{network:{'Aliases':[a for a in info.get('Aliases',[]) if a not in (source['Id'],source['Id'][:12])]} for network,info in source['NetworkSettings']['Networks'].items()}}
+write_json(work/'create.json',cfg)
+oldname=name+'-before-vdn-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S')
+api('POST','/containers/'+name+'/stop?t=30');api('POST','/containers/'+name+'/rename?name='+oldname)
+created=api('POST','/containers/create?name='+name,cfg);write_json(work/'created.json',{'id':created['Id'],'retained':oldname,'history_count':len(history),'control':str(control)})
+api('POST','/containers/'+name+'/start')
+print('GPU3 VDN added with original networks and tokens; verified terminal history saved:',len(history),'retained:',oldname)
diff --git a/integration-work/patch_idle_legacy_release.py b/integration-work/patch_idle_legacy_release.py
new file mode 100644
index 0000000..7e17093
--- /dev/null
+++ b/integration-work/patch_idle_legacy_release.py
@@ -0,0 +1,15 @@
+import pathlib,hashlib,json,shutil,subprocess,datetime
+root=pathlib.Path('/home/ps/huobao-gpu-selection');manifest=json.loads((root/'panel-routing-manifest.json').read_text())
+old="""                    if any(d.get('torch_vram_total', 0) > 1024**3 for d in stats.json().get('devices', [])):
+                        return None"""
+new="""                    if any(d.get('torch_vram_total', 0) > 1024**3 for d in stats.json().get('devices', [])):
+                        # Release only idle model caches; queue contents and results stay intact.
+                        released = await client.post(f'{legacy.base_url}/free', json={'unload_models': True, 'free_memory': True}, headers=provider_headers(legacy))
+                        released.raise_for_status()
+                        return None"""
+for short,name in [('general','canvas-h3-prompt-normalizer-healthy-20261026'),('vdn','huobao-vdn-normalizer')]:
+ p=root/(name+'.candidate.py');assert hashlib.sha256(p.read_bytes()).hexdigest()==manifest[short]['after']
+ source=p.read_text();assert source.count(old)==1
+ shutil.copy2(p,root/(name+'.before-idle-release-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S')+'.py'))
+ p.write_text(source.replace(old,new));subprocess.run(['docker','restart','--timeout','60',name],check=True,stdout=subprocess.DEVNULL)
+ print('Idle cache release enabled:',name)
diff --git a/integration-work/preflight_all_workflows.py b/integration-work/preflight_all_workflows.py
new file mode 100644
index 0000000..01594f8
--- /dev/null
+++ b/integration-work/preflight_all_workflows.py
@@ -0,0 +1,33 @@
+import subprocess,json,pathlib
+code='''import asyncio,json,httpx,app
+from workflow import compile_workflow,load_registry
+workflows={'minimax_h3_t2v_official':0,'minimax_h3_i2v':1,'minimax_h3_r2v':1,'minimax_h3_hybrid_v0331_t2v':0,'minimax_h3_hybrid_v0331_i2v':1,'minimax_h3_r2v_4step':1,'ltx23_t2v':0,'ltx23_t2v_text_preserve':0,'wan22_simple':1,'qwen_image_2_1':0}
+async def main():
+ registry=load_registry();report={}
+ async with httpx.AsyncClient(timeout=30) as c:
+  for p in app.providers().values():
+   r=await c.get(p.base_url+'/object_info',headers=app.provider_headers(p));r.raise_for_status();info=r.json();checks={}
+   for key,refs in list(workflows.items())+[('qwen_image_2_1',1)]:
+    spec=registry[key];req=app.JobRequest(workflow_key=key,prompt='A quiet mountain lake. No dialogue.',duration=4,width=512,height=512)
+    plan=app.request_audio_plan(spec,req)
+    if plan.get('supported'):req=req.model_copy(update={'prompt':plan['normalized_prompt']})
+    graph=compile_workflow(spec,req.model_dump(),['preflight.png']*refs,'huobao-check',preserve_requested_audio=bool(plan.get('supported')))
+    missing=[]
+    for node in graph.values():
+     typ=node['class_type']
+     if typ not in info:missing.append(typ);continue
+     ni=info[typ].get('input',{});fields={**ni.get('required',{}),**ni.get('optional',{})}
+     for field,val in node['inputs'].items():
+      opt=fields.get(field)
+      if not isinstance(val,str) or not opt or field=='image':continue
+      options=opt[0] if isinstance(opt[0],list) else opt[1].get('options') if len(opt)>1 and isinstance(opt[1],dict) else None
+      if options and val not in [v.get('key') if isinstance(v,dict) else v for v in options]:missing.append(typ+':'+field+':'+val)
+    checks[key+('-reference' if refs else '')]=missing
+   report[p.id]=checks
+ print(json.dumps(report))
+asyncio.run(main())
+'''
+out=subprocess.check_output(['docker','exec','canvas-h3-prompt-normalizer-healthy-20261026','python','-c',code],text=True)
+report=json.loads(out);pathlib.Path('/home/ps/huobao-gpu-selection/all-workflows-preflight.json').write_text(json.dumps(report,indent=2))
+for provider,checks in report.items():print(provider,'checked',len(checks),'missing',{k:v for k,v in checks.items() if v})
+assert all(not issues for checks in report.values() for issues in checks.values())
diff --git a/integration-work/prepare_8189_huobao.py b/integration-work/prepare_8189_huobao.py
new file mode 100644
index 0000000..6224449
--- /dev/null
+++ b/integration-work/prepare_8189_huobao.py
@@ -0,0 +1,41 @@
+"""Prepare an isolated node extension for the existing 8189 UI; no restart here."""
+import pathlib,json,sys,shutil,os,hashlib,secrets
+sys.path.insert(0,'/home/ps/huobao-gpu-selection')
+from docker_worker_ops import inspect,clone,replace_bind,write_json,set_env
+root=pathlib.Path('/home/ps/huobao-gpu-selection');work=root/'panel-8189'
+assert not work.exists(),'Inspect existing prepared work before rerunning'
+work.mkdir(mode=0o700)
+old=inspect('comfyui-manju');source=inspect('huobao-comfy-gpu1')
+write_json(work/'before.json',old)
+current_nodes=pathlib.Path(next(m['Source'] for m in old['Mounts'] if m['Destination']=='/app/custom_nodes'))
+source_nodes=pathlib.Path(next(m['Source'] for m in source['Mounts'] if m['Destination']=='/app/custom_nodes'))
+shutil.copytree(current_nodes,work/'custom_nodes',copy_function=os.link,symlinks=True)
+shutil.copytree(source_nodes/'ComfyUI-H3CaptionPipeline',work/'custom_nodes/ComfyUI-H3CaptionPipeline',symlinks=True)
+allow=pathlib.Path(next(m['Source'] for m in old['Mounts'] if m['Destination']=='/recovery/allowed_node_classes.json'))
+allowed=json.loads(allow.read_text())
+extra=['H3CaptionPipeline','H3CaptionChunkSource','H3CaptionBlendChunk','H3CaptionFinalize','H3InpaintConditioningCache','H3CaptionWarmup','H3TextRegionVerifier','H3STTNRepair','H3GenerationModelStage']
+allowed['required_classes']=sorted(set(allowed['required_classes'])|set(extra))
+allowed['reason']+='; Huobao user requested direct 8189 queue: existing reviewed H3CaptionPipeline classes only'
+(work/'allowed_node_classes.json').write_text(json.dumps(allowed));(work/'allowed_node_classes.json').chmod(0o644)
+(work/'control').mkdir(mode=0o700)
+token=secrets.token_hex(32);(work/'control/canary.token').write_text(token);(work/'control/canary.token').chmod(0o600)
+(work/'control/control.json').write_text(json.dumps({'schema':1,'maintenance':True}))
+cfg=clone(old,'comfyui-manju')
+replace_bind(cfg,'/app/custom_nodes',work/'custom_nodes')
+replace_bind(cfg,'/recovery/allowed_node_classes.json',work/'allowed_node_classes.json')
+cfg['Cmd'].insert(cfg['Cmd'].index('--extra-model-paths-config'),'ComfyUI-H3CaptionPipeline')
+if '--reserve-vram' not in cfg['Cmd']:cfg['Cmd']+=['--reserve-vram','8']
+for dest in ('/app/h3-sttn','/app/h3-speech-validator','/run/h3-shared-vision'):
+ m=next(m for m in source['Mounts'] if m['Destination']==dest)
+ cfg['HostConfig']['Binds'].append(m['Source']+':'+dest+':ro')
+cfg['HostConfig']['Binds'] += [str(work/'control')+':/run/huobao-8189-control:ro',str(work/'history.json')+':/run/huobao-8189-history.json:ro']
+def env(k,v):
+ set_env(cfg,k,v)
+ if not any(x.startswith(k+'=') for x in cfg['Cmd']):cfg['Cmd'].insert(cfg['Cmd'].index('/opt/conda/bin/python3'),k+'='+v)
+for k,v in {'H3_WORKER_CONTROL_FILE':'/run/huobao-8189-control/control.json','H3_CANARY_TOKEN_FILE':'/run/huobao-8189-control/canary.token','H3_VISION_SOCKET':'/run/h3-shared-vision/vision.sock','H3_HISTORY_SNAPSHOT':'/run/huobao-8189-history.json','H3_HISTORY_SOURCE_CONTAINER_ID':old['Id']}.items():env(k,v)
+cfg['NetworkingConfig']={'EndpointsConfig':{n:{'Aliases':d.get('Aliases') or []} for n,d in old['NetworkSettings']['Networks'].items()}}
+assert cfg['HostConfig']['DeviceRequests']==old['HostConfig']['DeviceRequests']
+assert cfg['HostConfig']['PortBindings']==old['HostConfig']['PortBindings']
+assert set(cfg['NetworkingConfig']['EndpointsConfig'])==set(old['NetworkSettings']['Networks'])
+write_json(work/'create.json',cfg)
+print(json.dumps({'prepared':str(work),'gpu':'1','existing_port':8189,'added_classes':extra,'existing_classes':len(allowed['required_classes'])-len(extra),'restart_performed':False}))
diff --git a/integration-work/prepare_gpu1_idle_fix.py b/integration-work/prepare_gpu1_idle_fix.py
new file mode 100644
index 0000000..5a7937d
--- /dev/null
+++ b/integration-work/prepare_gpu1_idle_fix.py
@@ -0,0 +1,27 @@
+import pathlib, hashlib, json, shutil, datetime
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+out=root/('idle-baseline-fix-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S'))
+out.mkdir(mode=0o700)
+old="""                    if any(d.get('torch_vram_total', 0) > 1024**3 for d in stats.json().get('devices', [])):
+                        # Release only idle model caches; queue contents and results stay intact."""
+new="""                    devices = stats.json().get('devices')
+                    if not isinstance(devices, list) or not devices or any(
+                        not isinstance(d, dict) or type(d.get('torch_vram_total')) not in (int, float)
+                        or not 0 <= d['torch_vram_total'] < float('inf') for d in devices
+                    ):
+                        return None
+                    # An idle cudaMallocAsync worker retains ~2.2 GiB of persistent tensors.
+                    # Allow at most 4 GiB within the new worker's existing 8 GiB reserve;
+                    # active/queued legacy jobs still block above, and large caches drain below.
+                    if sum(d['torch_vram_total'] for d in devices) > 4 * 1024**3:
+                        # Release only idle model caches; queue contents and results stay intact."""
+manifest={}
+for short,name in [('general','canvas-h3-prompt-normalizer-healthy-20261026'),('vdn','huobao-vdn-normalizer')]:
+ p=root/(name+'.candidate.py');source=p.read_text();assert source.count(old)==1
+ before=out/(short+'.before.py');shutil.copy2(p,before)
+ candidate=out/(short+'.after.py');candidate.write_text(source.replace(old,new));candidate.chmod(0o600)
+ compile(candidate.read_text(),str(candidate),'exec')
+ manifest[short]={'name':name,'path':str(p),'candidate':str(candidate),'before':hashlib.sha256(p.read_bytes()).hexdigest(),'after':hashlib.sha256(candidate.read_bytes()).hexdigest()}
+(out/'manifest.json').write_text(json.dumps(manifest,indent=2))
+(root/'idle-baseline-fix-current.json').write_text(json.dumps({'directory':str(out)}))
+print(json.dumps({'prepared':str(out),'hashes':{k:{x:v[x] for x in ('before','after')} for k,v in manifest.items()}}))
diff --git a/integration-work/prepare_gpu_selection.py b/integration-work/prepare_gpu_selection.py
new file mode 100644
index 0000000..fa44747
--- /dev/null
+++ b/integration-work/prepare_gpu_selection.py
@@ -0,0 +1,22 @@
+import json,pathlib,subprocess,datetime,os,hashlib,shutil
+def run(*a):return subprocess.check_output(a,text=True,stderr=subprocess.STDOUT)
+root=pathlib.Path('/home/ps/huobao-gpu-selection');root.mkdir(exist_ok=True,mode=0o700);root.chmod(0o700)
+state=root/'state.json'
+if state.exists(): raise SystemExit('Preparation already recorded; inspect state instead of repeating')
+backup=root/('backup-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S'));backup.mkdir(mode=0o700)
+for name in ('comfyui','h3-caption-gpu3-canary-8a5f','canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer','huobao-model-bridge','huobao-vdn-bridge'):
+ (backup/(name+'.inspect.json')).write_text(run('docker','inspect',name))
+for name in ('canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer'):
+ (backup/(name+'.app.py')).write_text(run('docker','exec',name,'cat','/app/app.py'))
+d=json.loads((backup/'canvas-h3-prompt-normalizer-healthy-20261026.inspect.json').read_text())[0]
+env=dict(x.split('=',1) for x in d['Config']['Env']);fn=env['COMFY_ADMISSION_FILE']
+m=next(m for m in d['Mounts'] if fn.startswith(m['Destination']+'/'))
+admission=pathlib.Path(m['Source'])/fn[len(m['Destination'])+1:]
+raw=admission.read_bytes();value=json.loads(raw)
+assert value=={'schema':1,'admit':['default','gpu3']},'Unexpected admission; no change made'
+(backup/'admission.json').write_bytes(raw)
+data={'backup':str(backup),'admission':str(admission),'original_admission_sha256':hashlib.sha256(raw).hexdigest(),'phase':'prepared'}
+state.write_text(json.dumps(data,indent=2));state.chmod(0o600)
+tmp=admission.with_name('admission.huobao-tmp.json');tmp.write_text(json.dumps({'schema':1,'admit':['default']}));tmp.chmod(admission.stat().st_mode & 0o777);os.replace(tmp,admission)
+data['phase']='gpu3-draining';state.write_text(json.dumps(data,indent=2))
+print('Backed up service definitions and temporarily stopped new GPU3 admission; existing jobs continue.',backup)
diff --git a/integration-work/prepare_hd_test.py b/integration-work/prepare_hd_test.py
new file mode 100644
index 0000000..c2c618b
--- /dev/null
+++ b/integration-work/prepare_hd_test.py
@@ -0,0 +1,24 @@
+from pathlib import Path
+import json,sqlite3,subprocess,os
+root=Path(__file__).resolve().parent.parent
+test=root/'integration-work'/os.environ.get('HUOBAO_TEST_FOLDER','hd-test')
+assert test.resolve().is_relative_to(root/'integration-work') and test.name.startswith('hd-test')
+test.mkdir(exist_ok=False)
+subprocess.run(['icacls',str(test),'/inheritance:r','/grant:r',os.environ['USERNAME']+':(OI)(CI)(F)','SYSTEM:(OI)(CI)(F)'],capture_output=True,check=True)
+with sqlite3.connect((root/'huobao-data/huobao.sqlite3').as_uri()+'?mode=ro',uri=True) as src, sqlite3.connect(test/'huobao.sqlite3') as db:
+    src.backup(db)
+    db.execute("UPDATE sys_task SET status='failed' WHERE status='processing'")
+    db.execute("UPDATE video_merges SET status='failed' WHERE status='processing'")
+    sid,eid=db.execute('SELECT id,episode_id FROM storyboards ORDER BY id LIMIT 1').fetchone()
+    original='static/videos/hd-test-original.mp4'
+    db.execute('UPDATE storyboards SET video_url=?,video_prompt=?,duration=4 WHERE id=?',(original,'A cinematic live-action landscape of a quiet mountain lake at sunrise, light mist drifts above still water, slow camera push forward, no people, no text, no dialogue.',sid))
+    cfg=json.loads((root/'model-bridge/client.json').read_text())
+    db.execute('INSERT INTO ai_service_configs (name,service_type,provider,base_url,api_key,model,priority,is_active,created_at,updated_at) VALUES (?,?,?,?,?,?,?,?,datetime(\'now\'),datetime(\'now\'))',
+        ('VDN test','video','localvideo','http://192.168.110.111:18794',cfg['token'],'["MiniMax-H3-VDN-H3"]',40,1))
+    db.commit()
+(test/'static/videos').mkdir(parents=True)
+ffmpeg=root/'integration-work/stage-4.0.11/app/resources/bin/ffmpeg.exe'
+subprocess.run([str(ffmpeg),'-hide_banner','-loglevel','error','-f','lavfi','-i','color=c=0x547d89:s=512x288:r=24:d=4','-vf','drawbox=x=0:y=180:w=512:h=108:color=0x284c39:t=fill',
+    '-c:v','libx264','-pix_fmt','yuv420p',str(test/original)],check=True,creationflags=0x08000000)
+(test/'fixture.json').write_text(json.dumps({'storyboard':sid,'episode':eid,'original':original}))
+print('Isolated test fixture ready:',sid,eid)
diff --git a/integration-work/prepare_hd_ui.py b/integration-work/prepare_hd_ui.py
new file mode 100644
index 0000000..d4d7d9a
--- /dev/null
+++ b/integration-work/prepare_hd_ui.py
@@ -0,0 +1,8 @@
+import sqlite3
+from pathlib import Path
+p=Path(__file__).resolve().parent/'hd-test/huobao.sqlite3'
+assert p.parent.name=='hd-test'
+with sqlite3.connect(p) as db:
+    db.execute("UPDATE dramas SET deleted_at=NULL,title='高清功能验证（隔离测试）' WHERE id=1")
+    db.execute("UPDATE episodes SET deleted_at=NULL WHERE id=1")
+print('Only the isolated fixture is visible; production deletion states unchanged')
diff --git a/integration-work/prepare_local_poll_status.py b/integration-work/prepare_local_poll_status.py
new file mode 100644
index 0000000..280f48e
--- /dev/null
+++ b/integration-work/prepare_local_poll_status.py
@@ -0,0 +1,45 @@
+import pathlib,datetime,json,hashlib,shutil,subprocess
+root=pathlib.Path('/home/ps/huobao-gpu-selection');folder=root/('task-tracking-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S'));folder.mkdir(mode=0o700)
+addition='''
+
+@app.get("/v1/huobao/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def huobao_job_status(job_id: str) -> dict[str, Any]:
+    # Keep the general API contract unchanged; Huobao needs actual queue state.
+    result = await get_job(job_id)
+    if result.get("status") != "running":
+        return {**result, "worker_state": result.get("status")}
+    if result.get("pollDeferred"):
+        return {**result, "worker_state": "checking"}
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=10) as client:
+        response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+        response.raise_for_status()
+        queue = response.json()
+    running = [row[1] for row in queue.get("queue_running", [])]
+    pending = [row[1] for row in queue.get("queue_pending", [])]
+    if prompt_id in running:
+        return {**result, "worker_state": "running"}
+    if prompt_id in pending:
+        return {**result, "worker_state": "queued", "queue_position": pending.index(prompt_id) + 1}
+    # A task may finish between the first history read and the queue read.
+    fresh = await get_job(job_id)
+    if fresh.get("status") != "running":
+        return {**fresh, "worker_state": fresh.get("status")}
+    if fresh.get("pollDeferred"):
+        return {**fresh, "worker_state": "checking"}
+    # Do not invent success/failure or submit again when a worker has lost history.
+    return {**fresh, "worker_state": "missing"}
+'''
+manifest={}
+for short,name in [('general','canvas-h3-prompt-normalizer-healthy-20261026'),('vdn','huobao-vdn-normalizer')]:
+ p=root/(name+'.candidate.py');source=p.read_text();assert '/v1/huobao/jobs/{job_id}' not in source
+ shutil.copy2(p,folder/(short+'.before.py'))
+ candidate=folder/(short+'.after.py');candidate.write_text(source+addition);compile(candidate.read_text(),str(candidate),'exec')
+ manifest[short]={'name':name,'path':str(p),'candidate':str(candidate),'before':hashlib.sha256(p.read_bytes()).hexdigest(),'after':hashlib.sha256(candidate.read_bytes()).hexdigest()}
+for short,foldername in [('main','huobao-model-bridge'),('hd','huobao-vdn/bridge')]:
+ p=pathlib.Path('/home/ps')/foldername/'bridge.py';shutil.copy2(p,folder/(short+'-bridge.before.py'))
+ manifest[short+'-bridge']={'path':str(p),'before':hashlib.sha256(p.read_bytes()).hexdigest()}
+(folder/'manifest.json').write_text(json.dumps(manifest,indent=2));(root/'task-tracking-current.json').write_text(json.dumps({'directory':str(folder)}))
+print('Prepared',str(folder))
+names=subprocess.check_output(['docker','ps','-a','--format','{{.Names}}'],text=True).splitlines()
+print('MANJU_CONTAINERS',[n for n in names if 'manju' in n])
diff --git a/integration-work/prepare_reference_test.py b/integration-work/prepare_reference_test.py
new file mode 100644
index 0000000..2156fbe
--- /dev/null
+++ b/integration-work/prepare_reference_test.py
@@ -0,0 +1,23 @@
+from pathlib import Path
+import sqlite3,shutil,json
+from PIL import Image
+root=Path('D:/web/dj');data=root/'integration-work/hd-test-references'
+data.mkdir(exist_ok=True)
+assert not (data/'huobao.sqlite3').exists(), 'Existing fixture: do not overwrite'
+with sqlite3.connect(root/'huobao-data/huobao.sqlite3') as src,sqlite3.connect(data/'huobao.sqlite3') as db:
+ src.backup(db)
+ db.execute('DELETE FROM sys_task')
+ db.execute("UPDATE ai_service_configs SET base_url='http://127.0.0.1:18887/v1',api_key='reference-test-key'")
+ for table in ['characters','scenes','props']:
+  db.execute(f"UPDATE {table} SET final_prompt='Reference fixture: studio photograph, retain identity and shape.'")
+  for image,local in db.execute(f'SELECT image_url,local_path FROM {table}'):
+   for value in (image,local):
+    if value and value.lstrip('/').startswith('static/'):
+     rel=Path(value.lstrip('/'));source=root/'huobao-data'/rel;target=data/rel
+     if source.is_file():target.parent.mkdir(parents=True,exist_ok=True);shutil.copy2(source,target)
+ for table,id in [('characters',26),('characters',27),('scenes',22),('props',1)]:
+  db.execute(f'UPDATE {table} SET deleted_at=NULL WHERE id=?',(id,))
+ db.execute('UPDATE props SET drama_id=6 WHERE id=1')
+ db.execute("INSERT OR IGNORE INTO episode_props(episode_id,prop_id,created_at) VALUES(7,1,datetime('now'))")
+for name,color in [('red',(210,30,30)),('blue',(30,40,220)),('green',(25,190,40))]:Image.new('RGB',(256,256),color).save(data/(name+'.png'))
+print(str(data))
diff --git a/integration-work/prepare_shot_ui_fixture.py b/integration-work/prepare_shot_ui_fixture.py
new file mode 100644
index 0000000..90d09b5
--- /dev/null
+++ b/integration-work/prepare_shot_ui_fixture.py
@@ -0,0 +1,19 @@
+from pathlib import Path
+import sqlite3,json,base64,uuid,re
+root=Path(__file__).resolve().parent; data=root/'hd-test-panels'
+assert data.is_relative_to(root)
+with sqlite3.connect(data/'huobao.sqlite3') as db:
+ db.execute("UPDATE sys_task SET status='failed' WHERE status='processing'")
+ rows=db.execute('SELECT id,name,settings FROM ai_service_configs').fetchall()
+ for id,name,raw in rows:
+  gpu=json.loads(raw or '{}').get('gpu')
+  if gpu in ('gpu1','gpu2','gpu3'):
+   name=re.sub(r' · (?:端口 \d+|ComfyUI [\d/]+(?:（[^）]*）)?)$','',name)+' · ComfyUI '+{'gpu1':'8189','gpu2':'8188','gpu3':'8191'}[gpu]
+   db.execute('UPDATE ai_service_configs SET name=? WHERE id=?',(name,id))
+ ids=[]
+ for sb,cfg,gpu,provider in ((1,12,'gpu2','default'),(2,13,'gpu3','gpu3')):
+  encoded=base64.urlsafe_b64encode((provider+':'+str(uuid.uuid4())).encode()).decode().rstrip('=')
+  cur=db.execute("INSERT INTO sys_task(type,storyboard_id,drama_id,provider,model,config_id,config_base_url,task_id,status,stage,params,created_at,updated_at) VALUES ('video',?,1,'minimax','MiniMax-H3',?,'http://127.0.0.1:18884',?,'processing','polling',?,datetime('now'),datetime('now'))",(sb,cfg,encoded,json.dumps({'gpu':gpu})))
+  ids.append(cur.lastrowid)
+(data/'shot-ui-fixture.json').write_text(json.dumps({'ids':ids}))
+print('Prepared two independent shot tasks:',ids)
diff --git a/integration-work/prepare_vdn.py b/integration-work/prepare_vdn.py
new file mode 100644
index 0000000..af7dd83
--- /dev/null
+++ b/integration-work/prepare_vdn.py
@@ -0,0 +1,5 @@
+from pathlib import Path
+p=Path('/home/ps/huobao-vdn')
+p.mkdir(exist_ok=True)
+p.chmod(0o700)
+print('isolated VDN directory ready')
diff --git a/integration-work/read_8189_plugin_requirements.py b/integration-work/read_8189_plugin_requirements.py
new file mode 100644
index 0000000..ba520da
--- /dev/null
+++ b/integration-work/read_8189_plugin_requirements.py
@@ -0,0 +1,14 @@
+import subprocess,json,pathlib
+def run(*a):return subprocess.check_output(a,text=True)
+name='huobao-comfy-gpu1';d=json.loads(run('docker','inspect',name))[0]
+source=next(m['Source'] for m in d['Mounts'] if m['Destination']=='/app/custom_nodes')
+root=pathlib.Path(source)/'ComfyUI-H3CaptionPipeline'
+print('plugin_source',str(root))
+for f in ('__init__.py','worker_state.py'):
+ s=(root/f).read_text();target=pathlib.Path('/home/ps/huobao-gpu-selection')/('8189-'+f);target.write_text(s)
+ print('saved',target)
+for e in d['Config'].get('Env',[]):
+ k=e.split('=',1)[0]
+ if k.startswith('H3_') and 'TOKEN' not in k and 'KEY' not in k:print(e)
+print('plugin_files',[p.name for p in root.iterdir()])
+print('support_mounts',[{'source':m['Source'],'dest':m['Destination'],'rw':m['RW']} for m in d['Mounts'] if 'h3-' in m['Destination'] or 'vision' in m['Destination']])
diff --git a/integration-work/read_cancel_api.py b/integration-work/read_cancel_api.py
new file mode 100644
index 0000000..ddc66d9
--- /dev/null
+++ b/integration-work/read_cancel_api.py
@@ -0,0 +1,9 @@
+import subprocess
+for name in ('canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer'):
+    code="""from pathlib import Path
+s=Path('/app/app.py').read_text(); lines=s.splitlines()
+for i,line in enumerate(lines):
+ if 'def cancel' in line or 'def cancellation_' in line:
+  print('\\n'.join(lines[max(0,i-1):i+90]))
+"""
+    print(name, subprocess.check_output(['docker','exec',name,'python','-c',code],text=True))
diff --git a/integration-work/read_worker_state.py b/integration-work/read_worker_state.py
new file mode 100644
index 0000000..4fa5545
--- /dev/null
+++ b/integration-work/read_worker_state.py
@@ -0,0 +1,4 @@
+import subprocess
+for file in ('/app/custom_nodes/ComfyUI-H3CaptionPipeline/worker_state.py','/app/custom_nodes/ComfyUI-H3CaptionPipeline/worker_control.py'):
+ r=subprocess.run(['docker','exec','h3-caption-gpu3-canary-8a5f','cat',file],capture_output=True,text=True)
+ print(file,r.stdout)
diff --git a/integration-work/server-h3-app.py b/integration-work/server-h3-app.py
new file mode 100644
index 0000000..30d4358
--- /dev/null
+++ b/integration-work/server-h3-app.py
@@ -0,0 +1,371 @@
+from __future__ import annotations
+
+import base64
+import asyncio
+import ipaddress
+import json
+import mimetypes
+import os
+import secrets
+import socket
+from dataclasses import dataclass
+from typing import Any
+from urllib.parse import quote, urlencode, urlsplit
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Response
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel, Field
+
+from workflow import MAX_VIDEO_DURATION_SECONDS, compile_workflow, load_registry, public_model, public_workflow
+
+
+@dataclass(frozen=True)
+class Provider:
+    id: str
+    name: str
+    base_url: str
+    api_key: str = ""
+
+
+class JobRequest(BaseModel):
+    provider_id: str = "default"
+    workflow_key: str
+    prompt: str
+    negative_prompt: str = ""
+    input_images: list[str] = Field(default_factory=list, max_length=9)
+    width: int | None = Field(default=None, ge=64, le=8192)
+    height: int | None = Field(default=None, ge=64, le=8192)
+    duration: float | None = Field(default=None, gt=0, le=MAX_VIDEO_DURATION_SECONDS)
+    generate_audio: bool | None = None
+    seed: int | None = Field(default=None, ge=0)
+    batch_size: int = Field(default=1, ge=1, le=4)
+    denoise: float | None = Field(default=None, ge=0, le=1)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+app = FastAPI(title="Canvas ComfyUI Workflow Adapter", version="1.0.0")
+provider_selection_lock = asyncio.Lock()
+provider_reservations: dict[str, int] = {}
+
+
+def auto_balance_enabled() -> bool:
+    return os.getenv("COMFY_AUTO_BALANCE", "").strip().lower() in {"1", "true", "yes", "on"}
+
+
+def providers() -> dict[str, Provider]:
+    raw = os.getenv("COMFY_PROVIDERS_JSON", "").strip()
+    rows: list[dict[str, Any]] = []
+    if raw:
+        parsed = json.loads(raw)
+        rows = parsed if isinstance(parsed, list) else []
+    elif os.getenv("COMFY_URL", "").strip():
+        rows = [{"id": "default", "name": "ComfyUI", "base_url": os.getenv("COMFY_URL"), "api_key": os.getenv("COMFY_API_KEY", "")}]
+    result: dict[str, Provider] = {}
+    for row in rows:
+        provider = Provider(id=str(row.get("id") or "").strip(), name=str(row.get("name") or row.get("id") or "ComfyUI"), base_url=str(row.get("base_url") or "").strip().rstrip("/"), api_key=str(row.get("api_key") or ""))
+        if provider.id and provider.base_url.startswith(("http://", "https://")):
+            result[provider.id] = provider
+    return result
+
+
+def require_token(authorization: str | None = Header(default=None)) -> None:
+    expected = os.getenv("COMFY_ADAPTER_TOKEN", "").strip()
+    if expected and not secrets.compare_digest(authorization or "", f"Bearer {expected}"):
+        raise HTTPException(status_code=401, detail="invalid adapter token")
+
+
+def provider_headers(provider: Provider) -> dict[str, str]:
+    return {"Authorization": f"Bearer {provider.api_key}"} if provider.api_key else {}
+
+
+async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        async with httpx.AsyncClient(timeout=5) as client:
+            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    except (httpx.HTTPError, ValueError, TypeError):
+        return None
+    return len(payload.get("queue_running") or []) + len(payload.get("queue_pending") or [])
+
+
+async def select_provider(requested_provider_id: str) -> Provider | None:
+    configured = providers()
+    requested = configured.get(requested_provider_id)
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:
+        return requested
+
+    candidates = list(configured.values())
+    depths = await asyncio.gather(*(provider_queue_depth(provider) for provider in candidates))
+    available = [
+        (depth + provider_reservations.get(provider.id, 0), 0 if provider.id == requested_provider_id else 1, provider)
+        for provider, depth in zip(candidates, depths)
+        if depth is not None
+    ]
+    if not available:
+        return requested
+    return min(available, key=lambda item: (item[0], item[1]))[2]
+
+
+async def reserve_provider(requested_provider_id: str) -> Provider | None:
+    async with provider_selection_lock:
+        provider = await select_provider(requested_provider_id)
+        if provider is not None:
+            provider_reservations[provider.id] = provider_reservations.get(provider.id, 0) + 1
+        return provider
+
+
+async def release_provider(provider: Provider) -> None:
+    async with provider_selection_lock:
+        remaining = provider_reservations.get(provider.id, 0) - 1
+        if remaining > 0:
+            provider_reservations[provider.id] = remaining
+        else:
+            provider_reservations.pop(provider.id, None)
+
+
+def input_host_allowlist() -> set[str]:
+    return {value.strip().lower().rstrip(".") for value in os.getenv("COMFY_INPUT_HOST_ALLOWLIST", "").split(",") if value.strip()}
+
+
+async def validate_input_url(value: str) -> None:
+    parsed = urlsplit(value)
+    host = (parsed.hostname or "").lower().rstrip(".")
+    if parsed.scheme not in {"http", "https"} or not host or parsed.username or parsed.password:
+        raise HTTPException(status_code=400, detail="reference image URL is invalid")
+    if host in input_host_allowlist():
+        return
+    try:
+        infos = await asyncio.to_thread(socket.getaddrinfo, host, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
+    except OSError as exc:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved") from exc
+    if not infos:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved")
+    for info in infos:
+        address = ipaddress.ip_address(info[4][0])
+        if not address.is_global:
+            raise HTTPException(status_code=400, detail="reference image URL cannot target a private address")
+
+
+async def download_input_image(client: httpx.AsyncClient, value: str) -> tuple[bytes, str]:
+    await validate_input_url(value)
+    chunks: list[bytes] = []
+    total = 0
+    async with client.stream("GET", value, follow_redirects=False) as response:
+        response.raise_for_status()
+        if 300 <= response.status_code < 400:
+            raise HTTPException(status_code=400, detail="reference image redirects are not accepted")
+        mime_type = response.headers.get("content-type", "image/png").split(";", 1)[0]
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference image URL did not return an image")
+        async for chunk in response.aiter_bytes():
+            total += len(chunk)
+            if total > 30 * 1024 * 1024:
+                raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+            chunks.append(chunk)
+    return b"".join(chunks), mime_type
+
+
+def encode_job(provider_id: str, prompt_id: str) -> str:
+    return base64.urlsafe_b64encode(f"{provider_id}:{prompt_id}".encode()).decode().rstrip("=")
+
+
+def decode_job(job_id: str) -> tuple[Provider, str]:
+    try:
+        raw = base64.urlsafe_b64decode(job_id + "=" * (-len(job_id) % 4)).decode()
+        provider_id, prompt_id = raw.split(":", 1)
+        provider = providers()[provider_id]
+    except Exception as exc:
+        raise HTTPException(status_code=404, detail="job not found") from exc
+    return provider, prompt_id
+
+
+@app.get("/health")
+async def health() -> dict[str, Any]:
+    return {
+        "status": "ok",
+        "providers": len(providers()),
+        "workflows": len(load_registry()),
+        "autoBalance": auto_balance_enabled(),
+    }
+
+
+@app.get("/v1/providers", dependencies=[Depends(require_token)])
+async def list_providers() -> dict[str, Any]:
+    return {"providers": [{"id": item.id, "name": item.name, "baseUrl": item.base_url} for item in providers().values()]}
+
+
+@app.get("/v1/workflows", dependencies=[Depends(require_token)])
+async def list_workflows() -> dict[str, Any]:
+    return {"workflows": [public_workflow(item) for item in load_registry().values()]}
+
+
+@app.get("/v1/models", dependencies=[Depends(require_token)])
+async def list_models() -> dict[str, Any]:
+    return {"object": "list", "data": [public_model(item) for item in load_registry().values()]}
+
+
+async def upload_image(client: httpx.AsyncClient, provider: Provider, value: str, index: int, client_id: str) -> str:
+    value = value.strip()
+    if value.startswith("comfy://"):
+        return value.removeprefix("comfy://")
+    if value.startswith("data:"):
+        header, encoded = value.split(",", 1)
+        mime_type = header.split(";", 1)[0].removeprefix("data:") or "image/png"
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference data URL must contain an image")
+        try:
+            data = base64.b64decode(encoded, validate=True)
+        except (ValueError, base64.binascii.Error) as exc:
+            raise HTTPException(status_code=400, detail="reference image data URL is invalid") from exc
+    elif value.startswith(("http://", "https://")):
+        data, mime_type = await download_input_image(client, value)
+    else:
+        raise HTTPException(status_code=400, detail="input_images must contain http(s), data, or comfy URLs")
+    if len(data) > 30 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+    extension = mimetypes.guess_extension(mime_type) or ".png"
+    filename = f"{client_id}-reference-{index}{extension}"
+    response = await client.post(f"{provider.base_url}/upload/image", files={"image": (filename, data, mime_type)}, data={"overwrite": "true"}, headers=provider_headers(provider))
+    response.raise_for_status()
+    payload = response.json()
+    return str(payload.get("name") or filename)
+
+
+@app.post("/v1/jobs", dependencies=[Depends(require_token)])
+async def create_job(request: JobRequest) -> dict[str, Any]:
+    registry = load_registry()
+    spec = registry.get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    provider = await reserve_provider(request.provider_id)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="provider is not configured")
+    try:
+        client_id = f"canvas-{secrets.token_hex(8)}"
+        async with httpx.AsyncClient(timeout=60) as client:
+            uploaded = [await upload_image(client, provider, value, index, client_id) for index, value in enumerate(request.input_images, start=1)]
+            try:
+                workflow = compile_workflow(spec, request.model_dump(), uploaded, client_id)
+            except ValueError as exc:
+                raise HTTPException(status_code=400, detail=str(exc)) from exc
+            response = await client.post(f"{provider.base_url}/prompt", json={"prompt": workflow, "client_id": client_id}, headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    finally:
+        await release_provider(provider)
+    prompt_id = str(payload.get("prompt_id") or "").strip()
+    if not prompt_id:
+        raise HTTPException(status_code=502, detail="ComfyUI did not return prompt_id")
+    return {"id": encode_job(provider.id, prompt_id), "promptId": prompt_id, "providerId": provider.id, "workflowKey": spec.key, "workflowRevision": spec.revision, "status": "submitted"}
+
+
+def extract_outputs(entry: dict[str, Any], job_id: str) -> list[dict[str, Any]]:
+    result: list[dict[str, Any]] = []
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if not isinstance(item, dict) or not item.get("filename"):
+                    continue
+                filename = str(item["filename"])
+                mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                kind = "video" if mime_type.startswith("video/") or filename.lower().endswith((".gif", ".webp")) and field == "gifs" else "audio" if mime_type.startswith("audio/") else "image"
+                index = len(result)
+                result.append({"index": index, "kind": kind, "mimeType": mime_type, "filename": filename, "url": f"/jobs/{quote(job_id, safe='')}/outputs/{index}"})
+    return result
+
+
+async def job_state(job_id: str) -> tuple[Provider, str, dict[str, Any], list[dict[str, Any]]]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.get(f"{provider.base_url}/history/{quote(prompt_id, safe='')}", headers=provider_headers(provider))
+        response.raise_for_status()
+        history = response.json()
+    entry = history.get(prompt_id) or {}
+    outputs = extract_outputs(entry, job_id)
+    return provider, prompt_id, entry, outputs
+
+
+@app.get("/v1/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def get_job(job_id: str) -> dict[str, Any]:
+    try:
+        provider, prompt_id, entry, outputs = await job_state(job_id)
+    except httpx.TimeoutException:
+        provider, prompt_id = decode_job(job_id)
+        return {
+            "id": job_id,
+            "promptId": prompt_id,
+            "providerId": provider.id,
+            "status": "running",
+            "outputs": [],
+            "error": "",
+            "pollDeferred": True,
+        }
+    status_payload = entry.get("status") or {}
+    if status_payload.get("status_str") == "error":
+        status = "failed"
+    elif outputs:
+        status = "succeeded"
+    elif status_payload.get("completed"):
+        status = "failed"
+    else:
+        status = "running"
+    error = "ComfyUI execution failed" if status == "failed" else ""
+    if status == "failed":
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            # 只映射已识别的内核错误，不向用户返回节点输入、提示词或 traceback。
+            if "tensor strides exceed int32 range" in str(event[1].get("exception_message") or ""):
+                error = "当前时长与分辨率组合超出采样内核范围，请缩短时长后重试（最多 15 秒）"
+                break
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": status, "outputs": outputs, "error": error}
+
+
+@app.post("/v1/jobs/{job_id}/cancel", dependencies=[Depends(require_token)])
+async def cancel_job(job_id: str) -> dict[str, Any]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        queue = (await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))).json()
+        running = {str(item[1]) for item in queue.get("queue_running") or [] if isinstance(item, list) and len(item) > 1}
+        if prompt_id in running:
+            await client.post(f"{provider.base_url}/interrupt", json={}, headers=provider_headers(provider))
+        await client.post(f"{provider.base_url}/queue", json={"delete": [prompt_id]}, headers=provider_headers(provider))
+    return {"id": job_id, "status": "cancelled"}
+
+
+@app.get("/v1/jobs/{job_id}/outputs/{index}", dependencies=[Depends(require_token)])
+async def get_output(job_id: str, index: int) -> Response:
+    provider, _, entry, outputs = await job_state(job_id)
+    if index < 0 or index >= len(outputs):
+        raise HTTPException(status_code=404, detail="output not found")
+    wanted = outputs[index]
+    locator: dict[str, Any] | None = None
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if isinstance(item, dict) and str(item.get("filename")) == wanted["filename"]:
+                    locator = item
+                    break
+            if locator: break
+        if locator: break
+    if locator is None:
+        raise HTTPException(status_code=404, detail="output locator not found")
+    query = urlencode({"filename": locator.get("filename", ""), "subfolder": locator.get("subfolder", ""), "type": locator.get("type", "output")})
+    client = httpx.AsyncClient(timeout=120)
+    response = await client.send(client.build_request("GET", f"{provider.base_url}/view?{query}", headers=provider_headers(provider)), stream=True)
+    if response.status_code >= 400:
+        await response.aclose(); await client.aclose()
+        raise HTTPException(status_code=502, detail="failed to read ComfyUI output")
+    async def stream():
+        try:
+            async for chunk in response.aiter_bytes():
+                yield chunk
+        finally:
+            await response.aclose(); await client.aclose()
+    return StreamingResponse(stream(), media_type=response.headers.get("content-type", wanted["mimeType"]))
diff --git a/integration-work/stage_panel_routing.py b/integration-work/stage_panel_routing.py
new file mode 100644
index 0000000..ffa1bd8
--- /dev/null
+++ b/integration-work/stage_panel_routing.py
@@ -0,0 +1,59 @@
+"""Build routing candidates from the inspected live sources; deploy separately."""
+from pathlib import Path
+root=Path(__file__).resolve().parent
+for short in ('general','vdn'):
+ source=(root/f'{short}-normalizer-interface-before.py').read_text(encoding='utf-8')
+ def replace(old,new):
+  global source
+  assert source.count(old)==1,(short,old,source.count(old))
+  source=source.replace(old,new)
+ replace('from dataclasses import dataclass','from dataclasses import dataclass, replace')
+ replace('    strict_provider: bool = False\n','    strict_provider: bool = False\n    huobao_panels: bool = False\n')
+ replace("row.get('id') != 'gpu1'","row.get('id') not in ('gpu1', 'gpu1_8189')")
+ replace('async def select_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:',
+         'async def select_provider(requested_provider_id: str, strict_provider: bool = False, huobao_panels: bool = False) -> Provider | None:')
+ replace('    requested = configured.get(requested_provider_id)\n    admitted = admission_ids(configured)', '''    admitted = admission_ids(configured)
+    if huobao_panels:
+        ports = {'default': 8188, 'gpu1_8189': 8189, 'gpu3': 8191}
+        configured = {key: replace(value, base_url=f'http://192.168.110.111:{ports[key]}') for key, value in configured.items() if key in ports}
+    else:
+        # Other applications retain their original worker selection.
+        configured = {key: value for key, value in configured.items() if key != 'gpu1_8189'}
+    requested = configured.get(requested_provider_id)''')
+ replace('async def reserve_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:',
+         'async def reserve_provider(requested_provider_id: str, strict_provider: bool = False, huobao_panels: bool = False) -> Provider | None:')
+ replace('provider = await select_provider(requested_provider_id, strict_provider)','provider = await select_provider(requested_provider_id, strict_provider, huobao_panels)')
+ replace('provider = await reserve_provider(request.provider_id, request.strict_provider)','provider = await reserve_provider(request.provider_id, request.strict_provider, request.huobao_panels)')
+ replace('async def provider_queue_depth(provider: Provider) -> int | None:\n    try:', '''async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        if provider.id == 'gpu1_8189':
+            # Same physical card: finish old accepted jobs without moving or cancelling them.
+            legacy = providers().get('gpu1')
+            if legacy:
+                async with httpx.AsyncClient(timeout=5) as client:
+                    old = await client.get(f'{legacy.base_url}/queue', headers=provider_headers(legacy))
+                    old.raise_for_status()
+                    queue = old.json()
+                    if queue.get('queue_running') or queue.get('queue_pending'):
+                        return None
+                    stats = await client.get(f'{legacy.base_url}/system_stats', headers=provider_headers(legacy))
+                    stats.raise_for_status()
+                    if any(d.get('torch_vram_total', 0) > 1024**3 for d in stats.json().get('devices', [])):
+                        # Release only idle model caches; queue contents and results stay intact.
+                        released = await client.post(f'{legacy.base_url}/free', json={'unload_models': True, 'free_memory': True}, headers=provider_headers(legacy))
+                        released.raise_for_status()
+                        return None''')
+ replace('detail="指定显卡不可用或缺少所需工作流，任务未提交"', 'detail=("GPU1 / 8189 暂不可用：旧 GPU1 任务或显存尚未释放，未取消原任务，也未提交新任务" if requested_provider_id == "gpu1_8189" else "指定显卡不可用或缺少所需工作流，任务未提交")')
+ route='''
+@app.post("/v1/huobao/route", dependencies=[Depends(require_token)])
+async def huobao_route(request: JobRequest) -> dict[str, Any]:
+    provider = await select_provider(request.provider_id, request.strict_provider, True)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="unknown requested worker")
+    return {"providerId": provider.id, "baseUrl": provider.base_url, "ready": True}
+
+'''
+ source+=route
+ compile(source,short,'exec')
+ (root/f'{short}-normalizer-panels.py').write_text(source,encoding='utf-8')
+ print('Prepared',short)
diff --git a/integration-work/stage_strict_gpu.py b/integration-work/stage_strict_gpu.py
new file mode 100644
index 0000000..dd1bc92
--- /dev/null
+++ b/integration-work/stage_strict_gpu.py
@@ -0,0 +1,69 @@
+"""Prepare and test a backwards-compatible pin extension without deploying it."""
+import pathlib,json,subprocess,ast
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+state=json.loads((root/'state.json').read_text());backup=pathlib.Path(state['backup'])
+targets=('canvas-h3-prompt-normalizer-healthy-20261026','huobao-vdn-normalizer')
+for name in targets:
+ source=(backup/(name+'.app.py')).read_text()
+ replacements={
+  '    result: dict[str, Provider] = {}':'''    extra_path = Path('/app/huobao-extra-providers.json')
+    if extra_path.exists():
+        extra = json.loads(extra_path.read_text())
+        if not isinstance(extra, list) or any(not isinstance(row, dict) or row.get('id') != 'gpu1' for row in extra):
+            raise ValueError('Invalid Huobao extra provider configuration')
+        existing_ids = {row.get('id') for row in rows}
+        rows.extend(row for row in extra if row['id'] not in existing_ids)
+    result: dict[str, Provider] = {}''',
+  '    provider_id: str = "default"\n':'    provider_id: str = "default"\n    strict_provider: bool = False\n',
+  'async def select_provider(requested_provider_id: str) -> Provider | None:':'async def select_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:',
+  '    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:':'''    if strict_provider:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="指定显卡正在维护或排空，任务未提交；请稍后重试或选择自动分配")
+        if await provider_queue_depth(requested) is None:
+            raise HTTPException(status_code=503, detail="指定显卡不可用或缺少所需工作流，任务未提交")
+        return requested
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:''',
+  'async def reserve_provider(requested_provider_id: str) -> Provider | None:':'async def reserve_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:',
+  '        provider = await select_provider(requested_provider_id)':'        provider = await select_provider(requested_provider_id, strict_provider)',
+  '    provider = await reserve_provider(request.provider_id)':'    provider = await reserve_provider(request.provider_id, request.strict_provider)',
+ }
+ for old,new in replacements.items():
+  assert source.count(old)==1,(name,old,source.count(old))
+  source=source.replace(old,new)
+ compile(source,name,'exec')
+ out=root/(name+'.candidate.py');out.write_text(source)
+ # Execute the production selector itself with deterministic queue/admission state.
+ module=ast.parse(source)
+ selection=next(n for n in module.body if isinstance(n,ast.AsyncFunctionDef) and n.name=='select_provider')
+ test='''import asyncio
+from types import SimpleNamespace
+class HTTPException(Exception):
+ def __init__(self,status_code,detail):self.status_code=status_code
+Provider=SimpleNamespace
+pool={k:Provider(id=k) for k in ('default','gpu1','gpu3')}
+providers=lambda:pool
+admitted={'default','gpu1','gpu3'}
+admission_ids=lambda _:admitted
+auto_balance_enabled=lambda:True
+provider_reservations={}
+depths={'default':8,'gpu1':4,'gpu3':0}
+async def provider_queue_depth(p):return depths[p.id]
+'''+ast.unparse(selection)+'''
+async def test():
+ assert (await select_provider('default')).id=='gpu3'
+ assert (await select_provider('default',True)).id=='default'
+ assert (await select_provider('gpu3',True)).id=='gpu3'
+ assert (await select_provider('gpu1',True)).id=='gpu1'
+ depths['default']=None
+ try:await select_provider('default',True)
+ except HTTPException as e:assert e.status_code==503
+ else:raise AssertionError('Pin silently fell back')
+ admitted.remove('gpu3')
+ try:await select_provider('gpu3',True)
+ except HTTPException as e:assert e.status_code==503
+ else:raise AssertionError('Pin bypassed drain')
+ print('PASS: auto balance, both pins, no fallback, admission gate')
+asyncio.run(test())
+'''
+ exec(compile(test,name+'-tests','exec'),{})
+ print('Prepared',name)
diff --git a/integration-work/start_hd_test.ps1 b/integration-work/start_hd_test.ps1
new file mode 100644
index 0000000..ee0a213
--- /dev/null
+++ b/integration-work/start_hd_test.ps1
@@ -0,0 +1,18 @@
+param([string]$DataDir = 'D:\web\dj\integration-work\hd-test', [string]$Port = '18879')
+$ErrorActionPreference = 'Stop'
+$stage = 'D:\web\dj\integration-work\stage-4.0.11\app'
+$test = [IO.Path]::GetFullPath($DataDir)
+if (-not $test.StartsWith('D:\web\dj\integration-work\hd-test', [StringComparison]::OrdinalIgnoreCase)) { throw 'Test path outside isolated test directory' }
+$env:ELECTRON_RUN_AS_NODE = '1'
+$env:PORT = $Port
+$env:HUOBAO_DESKTOP = '1'
+$env:HUOBAO_VERSION = '4.0.11-test'
+$env:HUOBAO_DATA_DIR = $test
+$env:SQLITE_PATH = Join-Path $test 'huobao.sqlite3'
+$env:WORKSPACE_PATH = Join-Path $stage 'resources\workspace-template'
+$env:FRONTEND_DIST = Join-Path $stage 'resources\frontend'
+$env:FFMPEG_BIN = Join-Path $stage 'resources\bin\ffmpeg.exe'
+$env:FFPROBE_BIN = Join-Path $stage 'resources\bin\ffprobe.exe'
+$process = Start-Process -FilePath (Join-Path $stage 'HuobaoDrama.exe') -ArgumentList (Join-Path $stage 'resources\app.asar\build\backend.mjs') -WorkingDirectory $test -WindowStyle Hidden -RedirectStandardOutput (Join-Path $test 'backend.log') -RedirectStandardError (Join-Path $test 'backend.err') -PassThru
+$process.Id | Set-Content (Join-Path $test 'pid.txt')
+Write-Output "Test backend PID: $($process.Id)"
diff --git a/integration-work/start_prepared_gpu1.py b/integration-work/start_prepared_gpu1.py
new file mode 100644
index 0000000..0fcdb02
--- /dev/null
+++ b/integration-work/start_prepared_gpu1.py
@@ -0,0 +1,20 @@
+import pathlib,json,sys,subprocess
+sys.path.insert(0,'/home/ps/huobao-gpu-selection')
+from docker_worker_ops import api,inspect,write_json
+root=pathlib.Path('/home/ps/huobao-gpu-selection');work=root/'gpu1';name='huobao-comfy-gpu1'
+cfg=json.loads((work/'create.json').read_text())
+assert cfg['HostConfig']['DeviceRequests'][0]['DeviceIDs']==['1']
+assert not cfg['HostConfig']['PortBindings'] and not cfg['HostConfig']['Privileged']
+assert list(cfg['NetworkingConfig']['EndpointsConfig'])==['zq-platform-network']
+assert cfg['HostConfig']['ReadonlyRootfs'] and cfg['User']=='1000:1000'
+assert cfg['Cmd'][-2:]==['--reserve-vram','8']
+created=api('POST','/containers/create?name='+name,cfg);write_json(work/'created.json',created)
+api('POST','/containers/'+name+'/start')
+normal=inspect('canvas-h3-prompt-normalizer-healthy-20261026')
+tokens=pathlib.Path(next(m['Source'] for m in normal['Mounts'] if m['Destination']=='/run/h3-workers'))
+target=tokens/'gpu1.token';assert not target.exists()
+target.write_text((work/'control/canary.token').read_text());target.chmod(0o600)
+subprocess.run(['setfacl','-m','u:65534:r--',str(target)],check=True)
+write_json(root/'extra-providers.json',[{'id':'gpu1','name':'ComfyUI GPU1','base_url':'http://huobao-comfy-gpu1:8188','control_token_file':'/run/h3-workers/gpu1.token'}])
+(root/'extra-providers.json').chmod(0o644) # Nonsecret catalogue: names, URL and token path only.
+print('Started prepared private GPU1 worker; existing services untouched:',created['Id'][:12])
diff --git a/integration-work/submit_hd_test.py b/integration-work/submit_hd_test.py
new file mode 100644
index 0000000..c1a36ff
--- /dev/null
+++ b/integration-work/submit_hd_test.py
@@ -0,0 +1,22 @@
+import json,urllib.request,urllib.error,time,sys
+from pathlib import Path
+root=Path(__file__).resolve().parent/'hd-test'
+fixture=json.loads((root/'fixture.json').read_text())
+base='http://127.0.0.1:18879/api/v1'
+def request(path,body=None):
+    req=urllib.request.Request(base+path,data=json.dumps(body).encode() if body else None,headers={'Content-Type':'application/json'})
+    try:
+        with urllib.request.urlopen(req,timeout=30) as r: return json.load(r)
+    except urllib.error.HTTPError as e: raise RuntimeError(e.read().decode())
+print(request('/health'))
+data=request('/hd/episodes/'+str(fixture['episode']))['data']
+assert data['configured']
+row=next(i for i in data['items'] if i['id']==fixture['storyboard'])
+assert row['original']==fixture['original'] and not row['busy']
+resolution=sys.argv[1] if len(sys.argv)>1 else '2K'
+assert resolution in ('2K','4K')
+result=request('/hd/storyboards/'+str(fixture['storyboard']),{'resolution':resolution})
+fixture['task']=result['data']['id']
+fixture.setdefault('real_tasks',{})[resolution]=fixture['task']
+(root/'fixture.json').write_text(json.dumps(fixture))
+print('Submitted isolated',resolution,'test task:',fixture['task'])
diff --git a/integration-work/test-local-adapter.cjs b/integration-work/test-local-adapter.cjs
new file mode 100644
index 0000000..cccd7e4
--- /dev/null
+++ b/integration-work/test-local-adapter.cjs
@@ -0,0 +1,198 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// ../huobao-source/backend/src/services/adapters/local-video.ts
+var local_video_exports = {};
+__export(local_video_exports, {
+  LocalVideoAdapter: () => LocalVideoAdapter
+});
+module.exports = __toCommonJS(local_video_exports);
+
+// ../huobao-source/backend/src/services/adapters/url.ts
+function joinProviderUrl(baseUrl, requiredPrefix, path) {
+  const normalizedBase = (baseUrl || "").replace(/\/+$/, "");
+  const normalizedPrefix = normalizeSegment(requiredPrefix);
+  const normalizedPath = normalizeSegment(path);
+  if (!normalizedBase) {
+    return `${normalizedPrefix}${normalizedPath}`;
+  }
+  try {
+    const url = new URL(normalizedBase);
+    const currentPath = url.pathname.replace(/\/+$/, "");
+    const mergedPrefix = currentPath.endsWith(normalizedPrefix) ? currentPath : `${currentPath}${normalizedPrefix}`;
+    url.pathname = `${mergedPrefix}${normalizedPath}`.replace(/\/{2,}/g, "/");
+    return url.toString();
+  } catch {
+    const basePath = normalizedBase.endsWith(normalizedPrefix) ? normalizedBase : `${normalizedBase}${normalizedPrefix}`;
+    return `${basePath}${normalizedPath}`;
+  }
+}
+function normalizeSegment(segment) {
+  if (!segment) return "";
+  return segment.startsWith("/") ? segment : `/${segment}`;
+}
+
+// ../huobao-source/backend/src/services/adapters/minimax-video.ts
+var H3_MODEL_PREFIX = "minimax-h3";
+var DEFAULT_MODEL = "MiniMax-H3";
+var REF_LIMITS = { images: 9, videos: 3, audios: 3, total: 12 };
+var PROMPT_MAX_CHARS = 7e3;
+var VALID_RATIOS = /* @__PURE__ */ new Set(["16:9", "9:16", "1:1", "4:3", "3:4", "21:9"]);
+function parseUrlArray(raw) {
+  if (!raw) return [];
+  try {
+    const arr = JSON.parse(raw);
+    return Array.isArray(arr) ? arr.filter((u) => typeof u === "string" && u.trim()) : [];
+  } catch {
+    return [];
+  }
+}
+var MiniMaxVideoAdapter = class {
+  provider = "minimax";
+  buildGenerateRequest(config, record) {
+    const model = record.model || config.model || DEFAULT_MODEL;
+    if (!model.toLowerCase().startsWith(H3_MODEL_PREFIX)) {
+      throw new Error(`\u4EC5\u652F\u6301 MiniMax H3 \u7CFB\u5217\u6A21\u578B\uFF08MiniMax-H3*\uFF09\uFF0C\u5F53\u524D: ${model}`);
+    }
+    const prompt = (record.prompt || "").trim();
+    const refImages = parseUrlArray(record.referenceImageUrls);
+    const refVideos = parseUrlArray(record.referenceVideoUrls);
+    const refAudios = parseUrlArray(record.referenceAudioUrls);
+    const firstFrame = (record.firstFrameUrl || record.imageUrl || "").trim();
+    const lastFrame = (record.lastFrameUrl || "").trim();
+    if (!prompt) throw new Error("MiniMax H3 \u8981\u6C42\u5FC5\u987B\u63D0\u4F9B\u63D0\u793A\u8BCD\uFF08text content\uFF09");
+    if (prompt.length > PROMPT_MAX_CHARS) {
+      throw new Error(`\u63D0\u793A\u8BCD\u8D85\u957F\uFF1AMiniMax H3 \u4E0A\u9650 ${PROMPT_MAX_CHARS} \u5B57\u7B26\uFF0C\u5F53\u524D ${prompt.length}`);
+    }
+    const totalRefs = refImages.length + refVideos.length + refAudios.length + (firstFrame ? 1 : 0) + (lastFrame ? 1 : 0);
+    if (refImages.length > REF_LIMITS.images || refVideos.length > REF_LIMITS.videos || refAudios.length > REF_LIMITS.audios || totalRefs > REF_LIMITS.total) {
+      throw new Error(`\u53C2\u8003\u7D20\u6750\u8D85\u9650\uFF1A\u56FE\u7247\u2264${REF_LIMITS.images}\u3001\u89C6\u9891\u2264${REF_LIMITS.videos}\u3001\u97F3\u9891\u2264${REF_LIMITS.audios}\u3001\u603B\u6570\u2264${REF_LIMITS.total}`);
+    }
+    const content = [{ type: "text", text: prompt }];
+    if (firstFrame) content.push({ type: "image_url", image_url: { url: firstFrame }, role: "first_frame" });
+    if (lastFrame) content.push({ type: "image_url", image_url: { url: lastFrame }, role: "last_frame" });
+    for (const url of refImages) {
+      content.push({ type: "image_url", image_url: { url }, role: "reference_image" });
+    }
+    for (const url of refVideos) {
+      content.push({ type: "video_url", video_url: { url }, role: "reference_video" });
+    }
+    for (const url of refAudios) {
+      content.push({ type: "audio_url", audio_url: { url }, role: "reference_audio" });
+    }
+    const body = {
+      model,
+      content,
+      duration: this.normalizeDuration(record.duration),
+      resolution: this.normalizeResolution(record.resolution)
+    };
+    if (config.gpu && config.gpu !== "auto") body.gpu = config.gpu;
+    if (!firstFrame) {
+      const ratio = (record.aspectRatio || "").trim();
+      body.ratio = VALID_RATIOS.has(ratio) ? ratio : "16:9";
+    }
+    return {
+      url: joinProviderUrl(config.baseUrl, "/v2", "/video_generation"),
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body
+    };
+  }
+  parseGenerateResponse(result) {
+    const taskId = result.task_id ?? result.task?.id;
+    const state = result.task?.status ?? result.status;
+    const videoUrl = result.task?.content?.url || result.content?.url || result.video_url;
+    if (videoUrl && (!state || state === "succeeded")) {
+      return { isAsync: false, videoUrl, taskId: taskId == null ? void 0 : String(taskId), duration: result.task?.duration ?? result.duration };
+    }
+    if (taskId != null) return { isAsync: true, taskId: String(taskId) };
+    throw new Error("No task_id or video url in response");
+  }
+  buildPollRequest(config, taskId) {
+    return {
+      url: joinProviderUrl(config.baseUrl, "/v2", `/query/video_generation/${taskId}`),
+      method: "GET",
+      headers: {
+        "Authorization": `Bearer ${config.apiKey}`
+      },
+      body: void 0
+    };
+  }
+  parsePollResponse(result) {
+    const task = result.task && typeof result.task === "object" ? result.task : result;
+    const status = task.status;
+    if (status === "succeeded") {
+      return {
+        status: "completed",
+        videoUrl: task.content?.url || task.video_url,
+        duration: task.duration
+      };
+    }
+    if (status === "failed" || status === "cancelled") {
+      const err = task.error;
+      const msg = typeof err === "string" ? err : err?.message || JSON.stringify(err) || "Video generation failed";
+      const code = err && typeof err === "object" && err.code ? `[${err.code}] ` : "";
+      return { status: "failed", error: `${code}${msg}` };
+    }
+    return { status: "processing", stage: task.delivery?.status === "transferring" ? "transferring" : void 0 };
+  }
+  extractVideoUrl(result) {
+    const task = result.task && typeof result.task === "object" ? result.task : result;
+    return task.content?.url || task.video_url || null;
+  }
+  normalizeDuration(duration) {
+    const parsed = Math.round(Number(duration || 5));
+    if (!Number.isFinite(parsed)) return 5;
+    return Math.min(15, Math.max(4, parsed));
+  }
+  /** MiniMax 仅 768P / 2K 两档；项目侧 480p/720p 统一归到 768P，1080p/2K 归到 2K */
+  normalizeResolution(resolution) {
+    const r = (resolution || "").toLowerCase();
+    if (r === "2k" || r === "1080p") return "2K";
+    return "768P";
+  }
+};
+
+// ../huobao-source/backend/src/services/adapters/local-video.ts
+var MODELS = /* @__PURE__ */ new Set(["MiniMax-H3", "MiniMax-H3-Hybrid", "MiniMax-H3-R2V-4Step", "LTX-2.3", "LTX-2.3-Text-Preserve", "Wan2.2-I2V", "MiniMax-H3-VDN-H3"]);
+var LocalVideoAdapter = class extends MiniMaxVideoAdapter {
+  provider = "localvideo";
+  buildGenerateRequest(config, record) {
+    const model = record.model || config.model || "MiniMax-H3";
+    if (!MODELS.has(model)) throw new Error(`\u672C\u5730\u89C6\u9891\u4EFB\u52A1\u6C60\u4E0D\u652F\u6301\u6A21\u578B\uFF1A${model}`);
+    if (record.referenceFileUrl || record.referenceLinkUrl) throw new Error("\u672C\u5730\u89C6\u9891\u6682\u4E0D\u652F\u6301 file / link \u53C2\u8003\u7D20\u6750");
+    const request = super.buildGenerateRequest(config, { ...record, model: "MiniMax-H3" });
+    const body = request.body;
+    const resolution = String(record.resolution || "768P").toUpperCase();
+    if (!["480P", "720P", "768P", "1080P", "2K", "4K"].includes(resolution)) throw new Error("\u4E0D\u652F\u6301\u7684\u672C\u5730\u89C6\u9891\u5206\u8FA8\u7387");
+    if (resolution === "4K" && model !== "MiniMax-H3-VDN-H3") throw new Error("4K \u9700\u8981 VDN-H3 \u9AD8\u6E05\u5236\u4F5C\u6A21\u578B");
+    body.model = model;
+    body.resolution = resolution;
+    if (config.gpu && config.gpu !== "auto") body.gpu = config.gpu;
+    if (record.seed != null) body.seed = record.seed;
+    return request;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalVideoAdapter
+});
diff --git a/integration-work/test_asset_references.py b/integration-work/test_asset_references.py
new file mode 100644
index 0000000..3344602
--- /dev/null
+++ b/integration-work/test_asset_references.py
@@ -0,0 +1,88 @@
+import concurrent.futures,io,json,sqlite3,threading,time,uuid,hashlib
+from email import policy
+from email.parser import BytesParser
+from http.server import BaseHTTPRequestHandler,ThreadingHTTPServer
+from pathlib import Path
+import requests
+from PIL import Image
+
+data=Path('D:/web/dj/integration-work/hd-test-references');base='http://127.0.0.1:18886/api/v1'
+calls=[]
+class Mock(BaseHTTPRequestHandler):
+ def log_message(self,*args):pass
+ def do_POST(self):
+  raw=self.rfile.read(int(self.headers['Content-Length']));content_type=self.headers.get('Content-Type','')
+  fields={};images=[]
+  if 'multipart' in content_type:
+   msg=BytesParser(policy=policy.default).parsebytes(('Content-Type: '+content_type+'\r\n\r\n').encode()+raw)
+   for part in msg.iter_parts():
+    name=part.get_param('name',header='content-disposition');value=part.get_payload(decode=True)
+    if name=='image[]':
+     with Image.open(io.BytesIO(value)) as im:images.append(list(im.convert('RGB').getpixel((50,50))))
+    else:fields[name]=value.decode()
+  else:fields=json.loads(raw)
+  calls.append({'path':self.path,'fields':fields,'images':images})
+  response=json.dumps({'data':[{'url':'http://127.0.0.1:18887/result.png'}]}).encode()
+  self.send_response(200);self.send_header('Content-Type','application/json');self.end_headers();self.wfile.write(response)
+ def do_GET(self):
+  raw=(data/'green.png').read_bytes();self.send_response(200);self.send_header('Content-Type','image/png');self.end_headers();self.wfile.write(raw)
+server=ThreadingHTTPServer(('127.0.0.1',18887),Mock)
+threading.Thread(target=server.serve_forever,daemon=True).start()
+def sql(query,args=()):
+ with sqlite3.connect(data/'huobao.sqlite3') as db:
+  db.row_factory=sqlite3.Row;return [dict(x) for x in db.execute(query,args)]
+def upload(kind,id,color='red'):
+ with (data/(color+'.png')).open('rb') as f:r=requests.post(f'{base}/{kind}/{id}/reference-images',files={'file':(color+'.png',f,'image/png')},timeout=10)
+ return r
+def refs(kind,id):return json.loads(sql(f'SELECT reference_images FROM {kind} WHERE id=?',(id,))[0]['reference_images'] or '[]')
+def remove(kind,id,path):
+ r=requests.delete(f'{base}/{kind}/{id}/reference-images',json={'path':path});assert r.status_code==200,r.text
+def generate(kind,id,cfg=14):
+ r=requests.post(f'{base}/{kind}/{id}/generate-image',json={'episode_id':7,'model':'qwen_image_2_1','config_id':cfg},timeout=20)
+ assert r.status_code==200,r.text
+ tid=r.json()['data']['image_generation_id'];return wait(tid)
+def wait(tid):
+ for _ in range(100):
+  row=sql('SELECT * FROM sys_task WHERE id=?',(tid,))[0]
+  if row['status']!='processing':return row
+  time.sleep(.1)
+ raise AssertionError(('task timeout',tid))
+try:
+ before={table:sql(f'SELECT image_url,local_path FROM {table} WHERE id=?',(id,))[0] for table,id in [('characters',26),('scenes',22),('props',1)]}
+ for table,id in [('characters',26),('scenes',22),('props',1)]:
+  for color in ['red','blue']:
+   r=upload(table,id,color);assert r.status_code==200,r.text
+  assert len(refs(table,id))==2
+  assert sql(f'SELECT image_url,local_path FROM {table} WHERE id=?',(id,))[0]==before[table]
+  row=generate(table,id);assert row['status']=='completed',row['error_msg']
+  assert len(json.loads(row['params'])['referenceImages'])==2
+  call=calls[-1];assert call['path']=='/v1/images/edits' and call['fields']['gpu']=='gpu1',call
+  assert len(call['images'])==2 and call['images'][0][0]>180 and call['images'][1][2]>180,call
+ print('PASS: character/scene/prop persist references, preserve current output on upload, send ordered multipart images with GPU1')
+ # Independent assets and per-character batch snapshots.
+ assert upload('characters',27,'green').status_code==200
+ r=requests.post(base+'/characters/batch-generate-images',json={'character_ids':[26,27],'episode_id':7,'model':'qwen_image_2_1','config_id':16},timeout=20)
+ assert r.status_code==200,r.text
+ for tid in r.json()['data']['ids']:assert wait(tid)['status']=='completed'
+ batch=calls[-2:];assert sorted(len(c['images']) for c in batch)==[1,2] and all(c['fields']['gpu']=='gpu3' for c in batch)
+ print('PASS: batch retains different per-character references and selected GPU3')
+ # Removing references does not erase files already snapshotted into past tasks.
+ saved=refs('characters',26);oldpaths=sql('SELECT image_url,local_path FROM characters WHERE id=26')[0]
+ for path in saved:remove('characters',26,path);assert (data/path).is_file()
+ assert refs('characters',26)==[] and sql('SELECT image_url,local_path FROM characters WHERE id=26')[0]==oldpaths
+ assert generate('characters',26)['status']=='completed' and calls[-1]['path']=='/v1/images/generations'
+ # Invalid uploads, unknown/deleted assets and concurrent cap enforcement.
+ r=requests.post(base+'/characters/26/reference-images',files={'file':('fake.png',b'not an image','image/png')});assert r.status_code==400
+ assert upload('characters',999999).status_code==404
+ for _ in range(5):assert upload('characters',26).status_code==200
+ with concurrent.futures.ThreadPoolExecutor() as pool:statuses=list(pool.map(lambda _:upload('characters',26).status_code,range(2)))
+ assert sorted(statuses)==[200,400] and len(refs('characters',26))==6,statuses
+ # One unavailable reference must fail visibly, never fall back to text-only.
+ broken=refs('characters',26)[0];(data/broken).rename(data/'temporarily-missing.png');count=len(calls)
+ row=generate('characters',26);assert row['status']=='failed' and '参考图读取失败' in row['error_msg']
+ assert len(calls)==count
+ (data/'temporarily-missing.png').rename(data/broken)
+ for path in refs('characters',26)[2:]:remove('characters',26,path)
+ print('PASS: removal preserves output/history files, empty refs use text generation, invalid files rejected, concurrent cap enforced, missing refs never silently ignored')
+ (data/'integration-result.json').write_text(json.dumps({'passed':True,'calls':len(calls),'asset_types':3,'maximum':6},indent=2))
+finally:server.shutdown()
diff --git a/integration-work/test_gpu1_idle_fix.py b/integration-work/test_gpu1_idle_fix.py
new file mode 100644
index 0000000..b1fa4d5
--- /dev/null
+++ b/integration-work/test_gpu1_idle_fix.py
@@ -0,0 +1,39 @@
+import ast,asyncio,json,pathlib,types
+root=pathlib.Path(json.loads(pathlib.Path('/home/ps/huobao-gpu-selection/idle-baseline-fix-current.json').read_text())['directory'])
+class TransportError(Exception): pass
+class Client:
+ def __init__(self,**kwargs):pass
+ async def __aenter__(self):return self
+ async def __aexit__(self,*args):pass
+ async def get(self,url,**kwargs):
+  if fail:raise TransportError()
+  if url=='http://legacy/queue':value=old_queue
+  elif url.endswith('/system_stats'):value=stats
+  elif url.endswith('/object_info/ApplyVDNH3'):value={'ApplyVDNH3':{}}
+  else:value={'queue_running':[],'queue_pending':[[1,'new-job']]}
+  return types.SimpleNamespace(raise_for_status=lambda:None,json=lambda:value)
+ async def post(self,url,**kwargs):
+  assert url=='http://legacy/free';assert kwargs['json']=={'unload_models':True,'free_memory':True}
+  calls.append(url);return types.SimpleNamespace(raise_for_status=lambda:None)
+httpx=types.SimpleNamespace(AsyncClient=Client,HTTPError=TransportError)
+Provider=object
+providers=lambda:{'gpu1':types.SimpleNamespace(base_url='http://legacy')}
+provider_headers=lambda p:{}
+target=types.SimpleNamespace(id='gpu1_8189',base_url='http://new')
+for variant in ('general','vdn'):
+ source=(root/(variant+'.after.py')).read_text()
+ node=next(n for n in ast.parse(source).body if isinstance(n,ast.AsyncFunctionDef) and n.name=='provider_queue_depth')
+ exec(compile(ast.Module(body=[node],type_ignores=[]),variant,'exec'),globals())
+ async def check():
+  global old_queue,stats,calls,fail
+  fail=False;calls=[];old_queue={};stats={'devices':[{'torch_vram_total':2348810240}]}
+  assert await provider_queue_depth(target)==1 and not calls
+  old_queue={'queue_running':[[1,'old-job']]};assert await provider_queue_depth(target) is None and not calls
+  old_queue={'queue_pending':[[1,'old-job']]};assert await provider_queue_depth(target) is None and not calls
+  old_queue={};stats={'devices':[{'torch_vram_total':10*1024**3}]}
+  assert await provider_queue_depth(target) is None and calls==['http://legacy/free']
+  for devices in (None,[],[{}],[{'torch_vram_total':-1}],[{'torch_vram_total':'unknown'}],[{'torch_vram_total':float('nan')}]):
+   stats={'devices':devices};assert await provider_queue_depth(target) is None
+  fail=True;assert await provider_queue_depth(target) is None
+ asyncio.run(check())
+ print('PASS',variant,'idle baseline allowed; active/pending blocked; large cache freed; malformed stats and network failure blocked')
diff --git a/integration-work/test_local_worker_status.py b/integration-work/test_local_worker_status.py
new file mode 100644
index 0000000..0c37397
--- /dev/null
+++ b/integration-work/test_local_worker_status.py
@@ -0,0 +1,25 @@
+import ast,asyncio,json,pathlib,types
+root=pathlib.Path(json.loads(pathlib.Path('/home/ps/huobao-gpu-selection/task-tracking-current.json').read_text())['directory'])
+class Client:
+ def __init__(self,**kw):pass
+ async def __aenter__(self):return self
+ async def __aexit__(self,*args):pass
+ async def get(self,*args,**kw):
+  return types.SimpleNamespace(raise_for_status=lambda:None,json=lambda:queue)
+httpx=types.SimpleNamespace(AsyncClient=Client);Any=object
+provider_headers=lambda p:{}
+decode_job=lambda jid:(types.SimpleNamespace(base_url='http://worker'),'target')
+async def get_job(jid):return results.pop(0) if len(results)>1 else results[0]
+for variant in ('general','vdn'):
+ tree=ast.parse((root/(variant+'.after.py')).read_text());node=next(n for n in tree.body if isinstance(n,ast.AsyncFunctionDef) and n.name=='huobao_job_status');node.decorator_list=[]
+ exec(compile(ast.Module(body=[node],type_ignores=[]),variant,'exec'),globals())
+ async def check():
+  global queue,results
+  results=[{'status':'running'}];queue={'queue_pending':[[1,'before'],[2,'target']]}
+  r=await huobao_job_status('job');assert r['worker_state']=='queued' and r['queue_position']==2
+  queue={'queue_running':[[1,'target']]};assert (await huobao_job_status('job'))['worker_state']=='running'
+  queue={};assert (await huobao_job_status('job'))['worker_state']=='missing'
+  results=[{'status':'running'},{'status':'succeeded','outputs':[{}]}];assert (await huobao_job_status('job'))['status']=='succeeded'
+  results=[{'status':'running','pollDeferred':True}];assert (await huobao_job_status('job'))['worker_state']=='checking'
+  results=[{'status':'failed'}];assert (await huobao_job_status('job'))['status']=='failed'
+ asyncio.run(check());print('PASS',variant,'queue/running/missing/finish race/quality-check/real failure')
diff --git a/integration-work/test_panel_selector.py b/integration-work/test_panel_selector.py
new file mode 100644
index 0000000..ced44c5
--- /dev/null
+++ b/integration-work/test_panel_selector.py
@@ -0,0 +1,39 @@
+import ast,asyncio
+from dataclasses import dataclass,replace
+from pathlib import Path
+@dataclass(frozen=True)
+class Provider:
+ id:str
+ base_url:str
+class HTTPException(Exception):
+ def __init__(self,status_code,detail):self.status_code=status_code;self.detail=detail
+pool={k:Provider(k,'http://original-'+k+':8188') for k in ('default','gpu1','gpu1_8189','gpu3')}
+providers=lambda:pool
+admission_ids=lambda _:set(pool)
+auto_balance_enabled=lambda:True
+provider_reservations={}
+depths={'default':8,'gpu1':0,'gpu1_8189':1,'gpu3':4}
+async def provider_queue_depth(p):return depths[p.id]
+class Env:
+ @staticmethod
+ def getenv(*a):return 'configured'
+os=Env()
+for variant in ('general','vdn'):
+ source=Path(__file__).with_name(variant+'-normalizer-panels.py').read_text(encoding='utf-8')
+ node=next(n for n in ast.parse(source).body if isinstance(n,ast.AsyncFunctionDef) and n.name=='select_provider')
+ exec(compile(ast.Module(body=[node],type_ignores=[]),variant,'exec'),globals())
+ async def test():
+  selected=await select_provider('default',False,True)
+  assert selected.id=='gpu1_8189' and selected.base_url=='http://192.168.110.111:8189'
+  assert (await select_provider('default',False,False)).id=='gpu1'
+  for worker,port in [('default',8188),('gpu1_8189',8189),('gpu3',8191)]:
+   chosen=await select_provider(worker,True,True)
+   assert chosen.id==worker and chosen.base_url.endswith(':'+str(port))
+  depths['gpu1_8189']=None
+  assert (await select_provider('default',False,True)).id=='gpu3'
+  try:await select_provider('gpu1_8189',True,True)
+  except HTTPException as e:assert e.status_code==503
+  else:raise AssertionError('Pinned unavailable worker fell back')
+  depths['gpu1_8189']=1
+ asyncio.run(test())
+ print('PASS',variant,': actual 8188/8189/8191 targets, strict pin, auto pool excludes legacy, unrelated clients retain original pool')
diff --git a/integration-work/test_polling_policy.cjs b/integration-work/test_polling_policy.cjs
new file mode 100644
index 0000000..24105e5
--- /dev/null
+++ b/integration-work/test_polling_policy.cjs
@@ -0,0 +1,43 @@
+const fs=require('node:fs'),vm=require('node:vm'),assert=require('node:assert/strict');
+const ts=require('D:/web/dj/huobao-source/backend/node_modules/typescript');
+const root='D:/web/dj/huobao-source/backend/src/services/';
+function moduleOf(file,requires={}){
+ const m={exports:{}};vm.runInNewContext(ts.transpileModule(fs.readFileSync(root+file,'utf8'),{compilerOptions:{module:ts.ModuleKind.CommonJS,target:ts.ScriptTarget.ES2022}}).outputText,{module:m,exports:m.exports,require:n=>requires[n],URL,Buffer});return m.exports;
+}
+const routing=moduleOf('worker-routing.ts'),policy=moduleOf('local-task-tracking.ts',{'./worker-routing.js':routing});
+const text=fs.readFileSync(root+'generation.ts','utf8'),tree=ts.createSourceFile('generation.ts',text,ts.ScriptTarget.Latest,true);
+const fn=tree.statements.find(n=>ts.isFunctionDeclaration(n)&&n.name.text==='pollTask');
+const compiled=ts.transpileModule(fn.getText(tree),{compilerOptions:{target:ts.ScriptTarget.ES2022}}).outputText;
+const taskId=Buffer.from('gpu3:11111111-1111-4111-8111-111111111111').toString('base64url');
+assert.equal(policy.isLocalQueuedTask({baseUrl:'http://192.168.110.111:18792',provider:'minimax'},taskId),true);
+assert.equal(policy.isLocalQueuedTask({baseUrl:'https://example.com',provider:'minimax'},taskId),false);
+assert.equal(policy.isLocalQueuedTask({baseUrl:'http://192.168.110.111:18792',provider:'minimax'},'unknown'),false);
+async function run(type,sequence,{external=false,cancelAt=0}={}){
+ let row={id:1,type,status:'processing',params:'{}'},calls=0,failed=null,completed=false,stages=[];
+ const chain={from(){return this},where(){return Promise.resolve(row?[{...row}]:[])}};
+ const adapter={buildPollRequest:()=>({url:'http://poll',method:'GET',headers:{}}),parsePollResponse:r=>r};
+ const ctx={db:{select:()=>chain,update:()=>({set:patch=>({where:()=>{if(row.status==='processing'){Object.assign(row,patch);if(patch.stage)stages.push(patch.stage)}return Promise.resolve()}})})},
+  schema:{sysTask:{id:'id',status:'status'}},eq:()=>{},and:()=>{},taskLabel:x=>x,parseTaskParams:JSON.parse,
+  isLocalQueuedTask:policy.isLocalQueuedTask,taskPollingProfile:policy.taskPollingProfile,
+  getImageAdapter:()=>adapter,getVideoAdapter:()=>adapter,saveRouting:async()=>{},
+  failTask:async(id,message,code)=>{failed={message,code};row.status='failed'},
+  handleImageComplete:async()=>{completed=true;row.status='completed'},handleVideoComplete:async()=>{completed=true;row.status='completed'},
+  logTaskProgress:()=>{},logTaskSuccess:()=>{},logTaskWarn:()=>{},redactUrl:x=>x,now:()=>new Date().toISOString(),
+  setTimeout:cb=>setImmediate(cb),Date,Math,Promise,AbortSignal,cancellingTasks:new Set(),
+  fetch:async(url,options)=>{assert.equal(options.method,'GET');calls++;assert.ok(calls<1200);if(cancelAt&&calls===cancelAt)row.status='failed';const result=sequence(calls);if(result instanceof Error)throw result;return{ok:true,json:async()=>result}}};
+ vm.createContext(ctx);vm.runInContext(compiled,ctx);
+ const config={provider:type==='video'?'minimax':'openai',baseUrl:external?'https://example.com':'http://192.168.110.111:18792'};
+ await ctx.pollTask({...row},config,taskId);return{calls,failed,completed,stages};
+}
+(async()=>{
+ const done={status:'completed',videoUrl:'video',imageUrl:'image'};
+ let r=await run('video',n=>n<=360?{status:'processing',stage:'queued'}:done);assert.equal(r.calls,361);assert.equal(r.completed,true);assert.equal(r.failed,null);
+ r=await run('image',n=>n<=150?{status:'processing',stage:'queued'}:done);assert.equal(r.calls,151);assert.equal(r.completed,true);
+ r=await run('video',n=>n<3?new Error('timeout'):n<6?{status:'processing',stage:'running'}:done);assert.ok(r.stages.includes('reconnecting'));assert.equal(r.completed,true);
+ r=await run('video',()=>({status:'processing',stage:'missing'}));assert.equal(r.calls,3);assert.equal(r.failed.code,'upstream_missing');
+ r=await run('video',n=>n<3?{status:'processing',stage:'missing'}:done);assert.equal(r.failed,null);assert.equal(r.completed,true);
+ r=await run('video',()=>({status:'failed',error:'actual worker failure'}));assert.equal(r.calls,1);assert.equal(r.failed.code,'generation_failed');
+ r=await run('video',()=>({status:'processing'}),{external:true});assert.equal(r.calls,300);assert.ok(r.failed.message.includes('attempts exhausted'));
+ r=await run('video',()=>({status:'processing'}),{cancelAt:5});assert.equal(r.calls,5);assert.equal(r.completed,false);
+ console.log('PASS: local video >300/image >120 polls, network recovery, missing confirmation, real failure, external limits unchanged, cancellation stops tracking');
+})().catch(e=>{console.error(e);process.exit(1)});
diff --git a/integration-work/test_tracking_recovery.py b/integration-work/test_tracking_recovery.py
new file mode 100644
index 0000000..a8e1687
--- /dev/null
+++ b/integration-work/test_tracking_recovery.py
@@ -0,0 +1,63 @@
+import base64,json,os,sqlite3,subprocess,threading,time,uuid,re
+from http.server import BaseHTTPRequestHandler,ThreadingHTTPServer
+from pathlib import Path
+from PIL import Image
+import requests
+root=Path('D:/web/dj');data=root/'integration-work/hd-test-tracking-2';data.mkdir(exist_ok=True)
+assert not (data/'huobao.sqlite3').exists()
+stage=root/'integration-work/stage-4.0.11/app';counts={};posts=[]
+def jid(n):return base64.urlsafe_b64encode(('gpu3:'+str(uuid.UUID(int=n))).encode()).decode().rstrip('=')
+ids={jid(n):n for n in range(1,10)}
+with sqlite3.connect(root/'huobao-data/huobao.sqlite3') as src,sqlite3.connect(data/'huobao.sqlite3') as db:
+ src.backup(db);db.execute('DELETE FROM sys_task')
+ db.execute("UPDATE ai_service_configs SET base_url='http://127.0.0.1:18890',api_key='test-only'")
+ db.execute("UPDATE characters SET image_url='static/images/newer.png' WHERE id=26")
+ for n in range(1,10):
+  image=n in [4,5,8];status='failed' if n in [1,3,4,7] else 'completed' if n==5 else 'processing';code='generation_failed' if n==3 else 'user_cancelled' if n==7 else None
+  db.execute('INSERT INTO sys_task(id,type,drama_id,character_id,provider,model,config_id,config_base_url,task_id,status,stage,error_code,error_msg,params,created_at,updated_at) VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)',
+   (n,'image' if image else 'video',6,26 if n in [4,5] else None,'openai' if image else 'minimax','qwen_image_2_1' if image else 'MiniMax-H3',6 if image else 4,'http://127.0.0.1:18890',jid(n),status,'polling',code,'Timeout: polling attempts exhausted' if n in [1,4] else None,'{}','2026-11-01T00:00:00Z','2026-11-01T00:00:00Z'))
+(data/'static/images').mkdir(parents=True);Image.new('RGB',(64,64),(0,180,0)).save(data/'static/images/newer.png');Image.new('RGB',(64,64),(180,0,0)).save(data/'old-result.png')
+source=(root/'huobao-source/desktop/build/backend.mjs').read_text(encoding='utf-8')
+source=source.replace('const require = __hbCreateRequire(import.meta.url)',"const require = __hbCreateRequire("+json.dumps(str(stage/'resources/app.asar/build/backend.mjs'))+")",1)
+source=re.sub(r'^import (\w+) from "(better-sqlite3|sharp)";',r'const \1 = require("\2");',source,flags=re.M)
+needle='url2.hostname === "192.168.110.111" && ["18792", "18794"].includes(url2.port)';assert source.count(needle)==1
+source=source.replace(needle,'url2.hostname === "127.0.0.1" && ["18890"].includes(url2.port)')
+needle='if (local) return { attempts: Infinity, intervalMs: 1e4, maxDurationMs: null };';assert source.count(needle)==1
+source=source.replace(needle,'if (local) return { attempts: Infinity, intervalMs: 5, maxDurationMs: null };')
+(data/'backend.mjs').write_text(source,encoding='utf-8')
+class Mock(BaseHTTPRequestHandler):
+ def log_message(self,*args):pass
+ def do_POST(self):posts.append(self.path);self.send_error(500)
+ def do_GET(self):
+  if self.path in ['/old.png','/video.mp4']:
+   p=data/'old-result.png' if self.path=='/old.png' else root/'integration-work/hd-test-regenerate/static/videos/hd-test-original.mp4'
+   raw=p.read_bytes();self.send_response(200);self.send_header('Content-Type','image/png' if self.path.endswith('png') else 'video/mp4');self.send_header('Content-Length',str(len(raw)));self.end_headers();self.wfile.write(raw);return
+  n=ids[self.path.split('/')[-1]];counts[n]=counts.get(n,0)+1
+  if n==6 and counts[n]<3:self.send_error(503);return
+  state='missing' if n==2 else 'queued' if n==9 or counts[n]<360 else 'succeeded'
+  if n==4:state='succeeded' if counts[n]>150 else 'queued'
+  if n==8:state='failed'
+  if n in [4,8]:payload={'status':'completed' if state=='succeeded' else 'failed' if state=='failed' else 'processing','worker_state':state,'image_url':'http://127.0.0.1:18890/old.png','error':{'message':'actual failure'}}
+  else:payload={'task':{'status':'succeeded' if state=='succeeded' else 'running','worker_state':state,'duration':4,'content':{'url':'http://127.0.0.1:18890/video.mp4'}}}
+  raw=json.dumps(payload).encode();self.send_response(200);self.send_header('Content-Type','application/json');self.end_headers();self.wfile.write(raw)
+server=ThreadingHTTPServer(('127.0.0.1',18890),Mock);threading.Thread(target=server.serve_forever,daemon=True).start()
+env={**os.environ,'ELECTRON_RUN_AS_NODE':'1','PORT':'18889','HUOBAO_DATA_DIR':str(data),'SQLITE_PATH':str(data/'huobao.sqlite3'),'FRONTEND_DIST':str(stage/'resources/frontend'),'WORKSPACE_PATH':str(stage/'resources/workspace-template'),'FFMPEG_BIN':str(stage/'resources/bin/ffmpeg.exe'),'FFPROBE_BIN':str(stage/'resources/bin/ffprobe.exe')}
+log=(data/'backend.log').open('w',encoding='utf-8');process=subprocess.Popen([str(stage/'HuobaoDrama.exe'),str(data/'backend.mjs')],env=env,cwd=data,stdout=log,stderr=log,creationflags=subprocess.CREATE_NO_WINDOW)
+try:
+ for _ in range(450):
+  if process.poll() is not None:raise AssertionError('Test backend exited; inspect backend.log')
+  with sqlite3.connect(data/'huobao.sqlite3') as db:states=dict(db.execute('SELECT id,status FROM sys_task'))
+  if states.get(1)==states.get(4)==states.get(6)=='completed' and counts.get(9,0)>360:break
+  time.sleep(.1)
+ else:raise AssertionError((states,counts))
+ with sqlite3.connect(data/'huobao.sqlite3') as db:
+  assert db.execute('SELECT error_code FROM sys_task WHERE id=2').fetchone()[0]=='upstream_missing'
+  assert db.execute('SELECT error_code FROM sys_task WHERE id=8').fetchone()[0]=='generation_failed'
+  assert db.execute('SELECT image_url FROM characters WHERE id=26').fetchone()[0]=='static/images/newer.png'
+  assert db.execute('SELECT local_path FROM sys_task WHERE id=4').fetchone()[0]
+  assert db.execute('SELECT status,stage FROM sys_task WHERE id=9').fetchone()==('processing','queued')
+  assert dict(db.execute('SELECT id,task_id FROM sys_task'))=={n:jid(n) for n in range(1,10)}
+ assert counts.get(3,0)==counts.get(5,0)==counts.get(7,0)==0 and not posts
+ result={'passed':True,'same_ids':True,'no_submissions':True,'counts':counts,'late_image_preserves_newer':True};(data/'result.json').write_text(json.dumps(result,indent=2));print(json.dumps(result))
+finally:
+ process.terminate();process.wait(timeout=10);server.shutdown();log.close()
diff --git a/integration-work/vdn-normalizer-interface-before.py b/integration-work/vdn-normalizer-interface-before.py
new file mode 100644
index 0000000..028777d
--- /dev/null
+++ b/integration-work/vdn-normalizer-interface-before.py
@@ -0,0 +1,599 @@
+from __future__ import annotations
+
+import base64
+import asyncio
+import ipaddress
+import json
+import mimetypes
+import os
+import secrets
+import socket
+from pathlib import Path
+from job_cancellation import dispatched as cancellation_dispatched, record as record_cancellation
+from dataclasses import dataclass
+from typing import Any
+from urllib.parse import quote, urlencode, urlsplit
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Response
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel, Field
+
+from workflow import MAX_VIDEO_DURATION_SECONDS, compile_workflow, load_registry, public_model, public_workflow, validate_h3_references
+from h3_audio_intent import plan_h3_audio
+from h3_audio_validation import AudioOutputValidator, attach_audio_policy
+from h3_visual_guard import VISUAL_REVISION, validate_visual_dimensions
+from h3_audio_conditioning import AudioConditioningError, prepare_audio_conditioning
+from h3_audio_output_guard import AudioQualityError
+
+
+@dataclass(frozen=True)
+class Provider:
+    id: str
+    name: str
+    base_url: str
+    api_key: str = ""
+    control_token_file: str = ""
+
+
+class JobRequest(BaseModel):
+    provider_id: str = "default"
+    strict_provider: bool = False
+    workflow_key: str
+    prompt: str
+    negative_prompt: str = ""
+    input_images: list[str] = Field(default_factory=list, max_length=9)
+    width: int | None = Field(default=None, ge=64, le=8192)
+    height: int | None = Field(default=None, ge=64, le=8192)
+    duration: float | None = Field(default=None, gt=0, le=MAX_VIDEO_DURATION_SECONDS)
+    generate_audio: bool | None = None
+    seed: int | None = Field(default=None, ge=0)
+    batch_size: int = Field(default=1, ge=1, le=4)
+    denoise: float | None = Field(default=None, ge=0, le=1)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+app = FastAPI(title="Canvas ComfyUI Workflow Adapter", version="1.0.0")
+audio_validator = AudioOutputValidator()
+provider_selection_lock = asyncio.Lock()
+provider_reservations: dict[str, int] = {}
+
+
+def auto_balance_enabled() -> bool:
+    return os.getenv("COMFY_AUTO_BALANCE", "").strip().lower() in {"1", "true", "yes", "on"}
+
+
+def providers() -> dict[str, Provider]:
+    raw = os.getenv("COMFY_PROVIDERS_JSON", "").strip()
+    rows: list[dict[str, Any]] = []
+    if raw:
+        parsed = json.loads(raw)
+        rows = parsed if isinstance(parsed, list) else []
+    elif os.getenv("COMFY_URL", "").strip():
+        rows = [{"id": "default", "name": "ComfyUI", "base_url": os.getenv("COMFY_URL"), "api_key": os.getenv("COMFY_API_KEY", "")}]
+    extra_path = Path('/app/huobao-extra-providers.json')
+    if extra_path.exists():
+        extra = json.loads(extra_path.read_text())
+        if not isinstance(extra, list) or any(not isinstance(row, dict) or row.get('id') != 'gpu1' for row in extra):
+            raise ValueError('Invalid Huobao extra provider configuration')
+        existing_ids = {row.get('id') for row in rows}
+        rows.extend(row for row in extra if row['id'] not in existing_ids)
+    result: dict[str, Provider] = {}
+    for row in rows:
+        provider = Provider(id=str(row.get("id") or "").strip(), name=str(row.get("name") or row.get("id") or "ComfyUI"), base_url=str(row.get("base_url") or "").strip().rstrip("/"), api_key=str(row.get("api_key") or ""), control_token_file=str(row.get("control_token_file") or ""))
+        if provider.id and provider.base_url.startswith(("http://", "https://")):
+            result[provider.id] = provider
+    return result
+
+
+def require_token(authorization: str | None = Header(default=None)) -> None:
+    expected = os.getenv("COMFY_ADAPTER_TOKEN", "").strip()
+    if expected and not secrets.compare_digest(authorization or "", f"Bearer {expected}"):
+        raise HTTPException(status_code=401, detail="invalid adapter token")
+
+
+def provider_headers(provider: Provider) -> dict[str, str]:
+    headers = {"Authorization": f"Bearer {provider.api_key}"} if provider.api_key else {}
+    if provider.control_token_file:
+        path = Path(provider.control_token_file)
+        try:
+            # Operator-mounted token only; it is never accepted from JobRequest
+            # or exposed by the public provider catalogue.
+            if path.parent != Path('/run/h3-workers') or path.name != provider.id + '.token':
+                raise ValueError('invalid worker control token path')
+            token = path.read_text().strip()
+            if not 16 <= len(token) <= 512 or any(ord(x) < 33 or ord(x) > 126 for x in token):
+                raise ValueError('invalid worker control token')
+            headers['X-H3-Canary-Token'] = token
+        except (OSError, ValueError):
+            raise HTTPException(status_code=503, detail="生成节点控制配置未就绪，任务未提交")
+    return headers
+
+
+async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        async with httpx.AsyncClient(timeout=5) as client:
+            capabilities = await client.get(f"{provider.base_url}/object_info/ApplyVDNH3", headers=provider_headers(provider))
+            capabilities.raise_for_status()
+            if 'ApplyVDNH3' not in capabilities.json():
+                return None
+            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    except (httpx.HTTPError, ValueError, TypeError):
+        return None
+    return len(payload.get("queue_running") or []) + len(payload.get("queue_pending") or [])
+
+
+def admission_ids(configured: dict[str, Provider]) -> set[str]:
+    path = os.getenv("COMFY_ADMISSION_FILE", "").strip()
+    if not path:
+        return set(configured)
+    try:
+        raw = Path(path).read_bytes()
+        if len(raw) > 4096:
+            raise ValueError("oversized admission configuration")
+        value = json.loads(raw)
+        if not isinstance(value, dict):
+            raise ValueError("invalid admission configuration")
+        allowed = value.get("admit")
+        if type(value.get("schema")) is not int or value.get("schema") != 1 or not isinstance(allowed, list) or any(not isinstance(x, str) for x in allowed):
+            raise ValueError("invalid admission configuration")
+        if len(set(allowed)) != len(allowed) or not set(allowed) <= set(configured):
+            raise ValueError("unknown or duplicate admission provider")
+        return set(allowed)
+    except (OSError, ValueError, TypeError):
+        # Drain changes affect only new submissions; job lookup always retains
+        # both stable provider IDs and their existing history/output routes.
+        raise HTTPException(status_code=503, detail="生成服务正在切换，任务尚未提交，请稍后重试")
+
+
+async def select_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:
+    configured = providers()
+    requested = configured.get(requested_provider_id)
+    admitted = admission_ids(configured)
+    if requested is None:
+        return None
+    if strict_provider:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="指定显卡正在维护或排空，任务未提交；请稍后重试或选择自动分配")
+        if await provider_queue_depth(requested) is None:
+            raise HTTPException(status_code=503, detail="指定显卡不可用或缺少所需工作流，任务未提交")
+        return requested
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="该生成节点正在排空，现有任务继续执行，新任务请稍后提交")
+        return requested
+
+    candidates = [provider for provider in configured.values() if provider.id in admitted]
+    if not candidates:
+        raise HTTPException(status_code=503, detail="生成节点正在排空，现有任务和结果保持不变")
+    depths = await asyncio.gather(*(provider_queue_depth(provider) for provider in candidates))
+    available = [
+        (depth + provider_reservations.get(provider.id, 0), 0 if provider.id == requested_provider_id else 1, provider)
+        for provider, depth in zip(candidates, depths)
+        if depth is not None
+    ]
+    if not available:
+        if os.getenv("COMFY_ADMISSION_FILE", "").strip():
+            raise HTTPException(status_code=503, detail="生成节点尚未就绪，任务未提交，请稍后重试")
+        return requested
+    return min(available, key=lambda item: (item[0], item[1]))[2]
+
+
+async def reserve_provider(requested_provider_id: str, strict_provider: bool = False) -> Provider | None:
+    async with provider_selection_lock:
+        provider = await select_provider(requested_provider_id, strict_provider)
+        if provider is not None:
+            provider_reservations[provider.id] = provider_reservations.get(provider.id, 0) + 1
+        return provider
+
+
+async def release_provider(provider: Provider) -> None:
+    async with provider_selection_lock:
+        remaining = provider_reservations.get(provider.id, 0) - 1
+        if remaining > 0:
+            provider_reservations[provider.id] = remaining
+        else:
+            provider_reservations.pop(provider.id, None)
+
+
+def input_host_allowlist() -> set[str]:
+    return {value.strip().lower().rstrip(".") for value in os.getenv("COMFY_INPUT_HOST_ALLOWLIST", "").split(",") if value.strip()}
+
+
+async def validate_input_url(value: str) -> None:
+    parsed = urlsplit(value)
+    host = (parsed.hostname or "").lower().rstrip(".")
+    if parsed.scheme not in {"http", "https"} or not host or parsed.username or parsed.password:
+        raise HTTPException(status_code=400, detail="reference image URL is invalid")
+    if host in input_host_allowlist():
+        return
+    try:
+        infos = await asyncio.to_thread(socket.getaddrinfo, host, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
+    except OSError as exc:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved") from exc
+    if not infos:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved")
+    for info in infos:
+        address = ipaddress.ip_address(info[4][0])
+        if not address.is_global:
+            raise HTTPException(status_code=400, detail="reference image URL cannot target a private address")
+
+
+async def download_input_image(client: httpx.AsyncClient, value: str) -> tuple[bytes, str]:
+    await validate_input_url(value)
+    chunks: list[bytes] = []
+    total = 0
+    async with client.stream("GET", value, follow_redirects=False) as response:
+        response.raise_for_status()
+        if 300 <= response.status_code < 400:
+            raise HTTPException(status_code=400, detail="reference image redirects are not accepted")
+        mime_type = response.headers.get("content-type", "image/png").split(";", 1)[0]
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference image URL did not return an image")
+        async for chunk in response.aiter_bytes():
+            total += len(chunk)
+            if total > 30 * 1024 * 1024:
+                raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+            chunks.append(chunk)
+    return b"".join(chunks), mime_type
+
+
+def encode_job(provider_id: str, prompt_id: str) -> str:
+    return base64.urlsafe_b64encode(f"{provider_id}:{prompt_id}".encode()).decode().rstrip("=")
+
+
+def decode_job(job_id: str) -> tuple[Provider, str]:
+    if job_id.startswith(("h3a1.", "h3v2.")):
+        job_id = job_id.split(".", 1)[1]
+    try:
+        raw = base64.urlsafe_b64decode(job_id + "=" * (-len(job_id) % 4)).decode()
+        provider_id, prompt_id = raw.split(":", 1)
+        provider = providers()[provider_id]
+    except Exception as exc:
+        raise HTTPException(status_code=404, detail="job not found") from exc
+    return provider, prompt_id
+
+
+def output_validation_mode() -> str:
+    mode = os.getenv("H3_OUTPUT_VALIDATION_MODE", "guarded").strip()
+    if mode not in {"guarded", "prompt-only"}:
+        raise HTTPException(status_code=503, detail="视频处理模式配置无效，任务未提交")
+    return mode
+
+
+@app.get("/health")
+async def health() -> dict[str, Any]:
+    return {
+        "status": "ok",
+        "providers": len(providers()),
+        "workflows": len(load_registry()),
+        "autoBalance": auto_balance_enabled(),
+        "outputValidationMode": output_validation_mode(),
+    }
+
+
+@app.get("/v1/providers", dependencies=[Depends(require_token)])
+async def list_providers() -> dict[str, Any]:
+    return {"providers": [{"id": item.id, "name": item.name, "baseUrl": item.base_url} for item in providers().values()]}
+
+
+@app.get("/v1/workflows", dependencies=[Depends(require_token)])
+async def list_workflows() -> dict[str, Any]:
+    return {"workflows": [public_workflow(item) for item in load_registry().values()]}
+
+
+@app.get("/v1/models", dependencies=[Depends(require_token)])
+async def list_models() -> dict[str, Any]:
+    return {"object": "list", "data": [public_model(item) for item in load_registry().values()]}
+
+
+async def upload_image(client: httpx.AsyncClient, provider: Provider, value: str, index: int, client_id: str) -> str:
+    value = value.strip()
+    if value.startswith("comfy://"):
+        return value.removeprefix("comfy://")
+    if value.startswith("data:"):
+        header, encoded = value.split(",", 1)
+        mime_type = header.split(";", 1)[0].removeprefix("data:") or "image/png"
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference data URL must contain an image")
+        try:
+            data = base64.b64decode(encoded, validate=True)
+        except (ValueError, base64.binascii.Error) as exc:
+            raise HTTPException(status_code=400, detail="reference image data URL is invalid") from exc
+    elif value.startswith(("http://", "https://")):
+        data, mime_type = await download_input_image(client, value)
+    else:
+        raise HTTPException(status_code=400, detail="input_images must contain http(s), data, or comfy URLs")
+    if len(data) > 30 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+    extension = mimetypes.guess_extension(mime_type) or ".png"
+    filename = f"{client_id}-reference-{index}{extension}"
+    response = await client.post(f"{provider.base_url}/upload/image", files={"image": (filename, data, mime_type)}, data={"overwrite": "true"}, headers=provider_headers(provider))
+    response.raise_for_status()
+    payload = response.json()
+    return str(payload.get("name") or filename)
+
+
+def request_audio_plan(spec, request: JobRequest) -> dict:
+    if not (spec.raw.get("speech_prompt_policy") == "minimax_h3" and spec.raw.get("native_audio_control")):
+        return {"supported": False}
+    if request.generate_audio is False:
+        return {"supported": True, "status": "ready", "normalized_prompt": request.prompt,
+                "dialogue_base_prompt": request.prompt, "dialogue": [], "sound_effects": [],
+                "music": [], "audio_mode": "silent", "silent": True, "speech_requested": False,
+                "expected_transcript": "", "required_seconds": 0, "max_duration_seconds": 15, "issues": []}
+    plan = plan_h3_audio(request.prompt, float(request.duration or 5))
+    if output_validation_mode() == "prompt-only" and not plan["silent"] and plan["audio_mode"] == "silent":
+        plan["audio_mode"] = "effects"
+    return {"supported": True, **plan}
+
+
+@app.post("/v1/audio-plan", dependencies=[Depends(require_token)])
+async def preview_audio_plan(request: JobRequest) -> dict:
+    spec = load_registry().get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    return request_audio_plan(spec, request)
+
+
+@app.post("/v1/jobs", dependencies=[Depends(require_token)])
+async def create_job(request: JobRequest) -> dict[str, Any]:
+    registry = load_registry()
+    spec = registry.get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    try:
+        validate_h3_references(spec, len(request.input_images))
+    except ValueError as error:
+        raise HTTPException(status_code=400, detail=str(error)) from error
+    audio_plan = request_audio_plan(spec, request)
+    guarded_output = bool(audio_plan.get("supported")) and output_validation_mode() == "guarded"
+    if audio_plan.get("supported"):
+        if audio_plan.get("status") != "ready":
+            raise HTTPException(status_code=400, detail="H3_AUDIO_CONFIRMATION_REQUIRED: 请先确认台词及视频时长，再提交视频生成")
+        if not guarded_output:
+            request = request.model_copy(update={"prompt": audio_plan["normalized_prompt"]})
+        try:
+            if guarded_output:
+                validate_visual_dimensions(request.width, request.height)
+                await audio_validator.ready(visual_required=True, audio_required=audio_plan.get("audio_mode") in {"dialogue", "effects"})
+                if audio_plan.get("audio_mode") in {"dialogue", "effects"}:
+                    prompt = await prepare_audio_conditioning(audio_plan, request.prompt, float(request.duration or 5), len(request.input_images))
+                    request = request.model_copy(update={"prompt": prompt})
+        except AudioQualityError as error:
+            raise HTTPException(status_code=503 if error.code.endswith("_UNAVAILABLE") else 400, detail=str(error)) from error
+        except AudioConditioningError as error:
+            raise HTTPException(status_code=503 if error.code == "H3_AUDIO_NORMALIZER_UNAVAILABLE" else 400, detail=str(error)) from error
+    provider = await reserve_provider(request.provider_id, request.strict_provider)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="provider is not configured")
+    try:
+        client_id = ("canvas-h3v2-" if guarded_output else "canvas-") + secrets.token_hex(8)
+        async with httpx.AsyncClient(timeout=60) as client:
+            uploaded = [await upload_image(client, provider, value, index, client_id) for index, value in enumerate(request.input_images, start=1)]
+            try:
+                workflow = compile_workflow(spec, request.model_dump(), uploaded, client_id, preserve_requested_audio=not guarded_output and bool(audio_plan.get("supported")))
+                if guarded_output:
+                    attach_audio_policy(workflow, audio_plan, float(request.duration or 5), str(spec.raw.get("save_node")), visual_required=True)
+            except ValueError as exc:
+                raise HTTPException(status_code=400, detail=str(exc)) from exc
+            response = await client.post(f"{provider.base_url}/prompt", json={"prompt": workflow, "client_id": client_id}, headers=provider_headers(provider))
+            if response.status_code == 400 and spec.raw.get("speech_prompt_policy") == "minimax_h3":
+                try:
+                    rejected = response.json()
+                except ValueError:
+                    rejected = {}
+                if "h3_caption_pipeline" in (rejected.get("node_errors") or {}) or "H3CaptionPipeline" in str((rejected.get("error") or {}).get("details") or ""):
+                    raise HTTPException(status_code=503, detail="字幕工作流预检未通过，处理组件、模型或字体尚未就绪；任务未进入 GPU 生成，请联系管理员。")
+            if response.status_code == 400:
+                rejected = response.json()
+                issues = []
+                for node, info in (rejected.get('node_errors') or {}).items():
+                    for error in info.get('errors', []):
+                        issues.append(str(node) + ': ' + str(error.get('message', '')) + ': ' + str(error.get('details', ''))[:300])
+                if not issues:
+                    issues = [str(rejected.get('error', 'Workflow validation failed'))[:600]]
+                raise HTTPException(status_code=400, detail='; '.join(issues)[:1800])
+            response.raise_for_status()
+            payload = response.json()
+    finally:
+        await release_provider(provider)
+    prompt_id = str(payload.get("prompt_id") or "").strip()
+    if not prompt_id:
+        raise HTTPException(status_code=502, detail="ComfyUI did not return prompt_id")
+    job_id = encode_job(provider.id, prompt_id)
+    persisted = True
+    if guarded_output:
+        job_id = "h3v2." + job_id
+        try:
+            audio_validator.register_policy(job_id, audio_plan, float(request.duration or 5), visual_required=True)
+        except AudioQualityError as error:
+            raise HTTPException(status_code=502, detail=str(error)) from error
+        except OSError:
+            # The provider already accepted this exact job. Return its ID rather
+            # than an ambiguous 500 inviting another GPU submission. Its graph
+            # carries the same policy; missing evidence still fails closed.
+            persisted = False
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "workflowKey": spec.key, "workflowRevision": spec.revision, "status": "submitted", "policyPersisted": persisted}
+
+
+def extract_outputs(entry: dict[str, Any], job_id: str) -> list[dict[str, Any]]:
+    result: list[dict[str, Any]] = []
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if not isinstance(item, dict) or not item.get("filename"):
+                    continue
+                filename = str(item["filename"])
+                mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                kind = "video" if mime_type.startswith("video/") or filename.lower().endswith((".gif", ".webp")) and field == "gifs" else "audio" if mime_type.startswith("audio/") else "image"
+                index = len(result)
+                result.append({"index": index, "kind": kind, "mimeType": mime_type, "filename": filename, "url": f"/jobs/{quote(job_id, safe='')}/outputs/{index}"})
+    return result
+
+
+async def job_state(job_id: str) -> tuple[Provider, str, dict[str, Any], list[dict[str, Any]]]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.get(f"{provider.base_url}/history/{quote(prompt_id, safe='')}", headers=provider_headers(provider))
+        response.raise_for_status()
+        history = response.json()
+    entry = history.get(prompt_id) or {}
+    outputs = extract_outputs(entry, job_id)
+    return provider, prompt_id, entry, outputs
+
+
+@app.get("/v1/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def get_job(job_id: str) -> dict[str, Any]:
+    try:
+        provider, prompt_id, entry, outputs = await job_state(job_id)
+    except httpx.TimeoutException:
+        provider, prompt_id = decode_job(job_id)
+        return {
+            "id": job_id,
+            "promptId": prompt_id,
+            "providerId": provider.id,
+            "status": "running",
+            "outputs": [],
+            "error": "",
+            "pollDeferred": True,
+        }
+    status_payload = entry.get("status") or {}
+    if status_payload.get("status_str") == "error":
+        status = "failed"
+    elif outputs and not (job_id.startswith("h3v2.") and not status_payload.get("completed")):
+        status = "succeeded"
+    elif status_payload.get("completed"):
+        status = "failed"
+    else:
+        status = "running"
+    if job_id.startswith("h3v2.") and status != "succeeded":
+        outputs = []
+    if status != "succeeded" and cancellation_dispatched(job_id):
+        # An acknowledged interrupt is not terminal until this exact prompt
+        # disappears from the worker queue. Never infer it from HTTP 200 alone.
+        try:
+            async with httpx.AsyncClient(timeout=10) as client:
+                response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+                response.raise_for_status()
+                queue = response.json()
+            if not isinstance(queue, dict) or not isinstance(queue.get("queue_running"), list) or not isinstance(queue.get("queue_pending"), list):
+                raise ValueError("invalid queue response")
+            remaining = {str(item[1]) for item in queue["queue_running"] + queue["queue_pending"] if isinstance(item, list) and len(item) > 1}
+            if prompt_id not in remaining:
+                status, outputs = "cancelled", []
+            else:
+                return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在取消生成", "cancelRequested": True}
+        except (httpx.HTTPError, ValueError):
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在确认取消", "cancelRequested": True}
+    error = "ComfyUI execution failed" if status == "failed" else ""
+    if status == "failed":
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            # 只映射已识别的内核错误，不向用户返回节点输入、提示词或 traceback。
+            if "tensor strides exceed int32 range" in str(event[1].get("exception_message") or ""):
+                error = "当前时长与分辨率组合超出采样内核范围，请缩短时长后重试（最多 15 秒）"
+                break
+    if status == "failed":
+        hints = {
+            "H3_SUBTITLE_MASK_UNCERTAIN": "检测到疑似字幕，但无法安全区分字幕和产品文字，任务已停止，未返回未清理视频。",
+            "H3_SUBTITLE_RESIDUAL": "字幕清理后仍检测到残留，任务已停止，避免生成双层字幕。",
+            "H3_SPEECH_MISMATCH": "实际口播与原台词不一致，未生成误导字幕；请缩短台词或调整后重试。",
+            "H3_SUBTITLE_ALIGNMENT": "口播时间轴校验未通过，无法准确烧录字幕；请缩短单句台词后重试。",
+            "H3_SUBTITLE_FONT": "字幕含字体不支持的字符，已停止以避免乱码；请使用常见文字。",
+            "H3_SUBTITLE_DEPENDENCY": "字幕处理服务依赖未就绪，请联系管理员；原任务未自动重试。",
+            "H3_SUBTITLE_FRAME_COUNT": "字幕处理前后帧数或尺寸不一致，已停止输出，请联系管理员。",
+        }
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            message = str(event[1].get("exception_message") or "")
+            for code, hint in hints.items():
+                if message.startswith(code + ":"):
+                    error = hint
+                    break
+        # Never expose a partial/raw output from a failed cleanup/quality gate.
+        outputs = []
+    if status == "succeeded":
+        quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+        if quality["status"] in {"pending", "unavailable"}:
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running",
+                    "outputs": [], "error": "", "stage": "正在校验字幕与音轨" if job_id.startswith("h3v2.") or quality.get("visual_required") else "正在校验视频音轨", "pollDeferred": True}
+        if quality["status"] == "failed":
+            status, outputs, error = "failed", [], quality["error"]
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": status, "outputs": outputs, "error": error}
+
+
+@app.post("/v1/jobs/{job_id}/cancel", dependencies=[Depends(require_token)])
+async def cancel_job(job_id: str) -> dict[str, Any]:
+    provider, prompt_id = decode_job(job_id)
+    # Write intent before sending; disk failure must not produce an untracked
+    # cancellation. The worker API atomically compares the running prompt ID.
+    record_cancellation(job_id, False)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.post(f"{provider.base_url}/api/jobs/{quote(prompt_id, safe='')}/cancel", json={}, headers=provider_headers(provider))
+        if response.status_code in (404, 405):
+            raise HTTPException(status_code=409, detail="生成节点未提供按任务取消接口，未中断其他任务")
+        response.raise_for_status()
+        acknowledged = response.json().get("cancelled")
+        if type(acknowledged) is not bool:
+            raise HTTPException(status_code=502, detail="生成节点取消回执无效，请核对原任务状态")
+        if acknowledged:
+            record_cancellation(job_id, True)
+    return await get_job(job_id)
+
+
+@app.get("/v1/jobs/{job_id}/outputs/{index}", dependencies=[Depends(require_token)])
+async def get_output(job_id: str, index: int) -> Response:
+    provider, _, entry, outputs = await job_state(job_id)
+    if (entry.get("status") or {}).get("status_str") == "error":
+        raise HTTPException(status_code=409, detail="任务未成功，未返回部分输出")
+    if not outputs or job_id.startswith("h3v2.") and not (entry.get("status") or {}).get("completed"):
+        raise HTTPException(status_code=409, detail="视频生成尚未完成，未返回部分输出")
+    quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+    if quality["status"] != "verified":
+        raise HTTPException(status_code=422 if quality["status"] == "failed" else 409,
+                            detail=quality.get("error", "视频核验尚未完成，请稍后查询原任务"))
+    if index < 0 or index >= len(outputs):
+        raise HTTPException(status_code=404, detail="output not found")
+    wanted = outputs[index]
+    locator: dict[str, Any] | None = None
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if isinstance(item, dict) and str(item.get("filename")) == wanted["filename"]:
+                    locator = item
+                    break
+            if locator: break
+        if locator: break
+    if locator is None:
+        raise HTTPException(status_code=404, detail="output locator not found")
+    if quality.get("visual_revision") == VISUAL_REVISION:
+        bound_locator = {key: locator.get(key, "output" if key == "type" else "") for key in ("filename", "subfolder", "type")}
+        try:
+            media = await audio_validator.verified_download(quality, bound_locator, provider.base_url, provider_headers(provider))
+        except AudioQualityError as error:
+            raise HTTPException(status_code=422, detail=str(error)) from error
+        except (httpx.HTTPError, OSError, asyncio.TimeoutError):
+            raise HTTPException(status_code=503, detail="H3_VISUAL_VALIDATION_UNAVAILABLE: 已核验视频暂不可读取，请查询原任务") from None
+        return Response(content=media, media_type=wanted["mimeType"], headers={"Cache-Control": "private, no-store"})
+    query = urlencode({"filename": locator.get("filename", ""), "subfolder": locator.get("subfolder", ""), "type": locator.get("type", "output")})
+    client = httpx.AsyncClient(timeout=120)
+    response = await client.send(client.build_request("GET", f"{provider.base_url}/view?{query}", headers=provider_headers(provider)), stream=True)
+    if response.status_code >= 400:
+        await response.aclose(); await client.aclose()
+        raise HTTPException(status_code=502, detail="failed to read ComfyUI output")
+    async def stream():
+        try:
+            async for chunk in response.aiter_bytes():
+                yield chunk
+        finally:
+            await response.aclose(); await client.aclose()
+    return StreamingResponse(stream(), media_type=response.headers.get("content-type", wanted["mimeType"]))
diff --git a/integration-work/vdn-normalizer-panels.py b/integration-work/vdn-normalizer-panels.py
new file mode 100644
index 0000000..d6f061c
--- /dev/null
+++ b/integration-work/vdn-normalizer-panels.py
@@ -0,0 +1,669 @@
+from __future__ import annotations
+
+import base64
+import asyncio
+import ipaddress
+import json
+import mimetypes
+import os
+import secrets
+import socket
+from pathlib import Path
+from job_cancellation import dispatched as cancellation_dispatched, record as record_cancellation
+from dataclasses import dataclass, replace
+from typing import Any
+from urllib.parse import quote, urlencode, urlsplit
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Response
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel, Field
+
+from workflow import MAX_VIDEO_DURATION_SECONDS, compile_workflow, load_registry, public_model, public_workflow, validate_h3_references
+from h3_audio_intent import plan_h3_audio
+from h3_audio_validation import AudioOutputValidator, attach_audio_policy
+from h3_visual_guard import VISUAL_REVISION, validate_visual_dimensions
+from h3_audio_conditioning import AudioConditioningError, prepare_audio_conditioning
+from h3_audio_output_guard import AudioQualityError
+
+
+@dataclass(frozen=True)
+class Provider:
+    id: str
+    name: str
+    base_url: str
+    api_key: str = ""
+    control_token_file: str = ""
+
+
+class JobRequest(BaseModel):
+    provider_id: str = "default"
+    strict_provider: bool = False
+    huobao_panels: bool = False
+    workflow_key: str
+    prompt: str
+    negative_prompt: str = ""
+    input_images: list[str] = Field(default_factory=list, max_length=9)
+    width: int | None = Field(default=None, ge=64, le=8192)
+    height: int | None = Field(default=None, ge=64, le=8192)
+    duration: float | None = Field(default=None, gt=0, le=MAX_VIDEO_DURATION_SECONDS)
+    generate_audio: bool | None = None
+    seed: int | None = Field(default=None, ge=0)
+    batch_size: int = Field(default=1, ge=1, le=4)
+    denoise: float | None = Field(default=None, ge=0, le=1)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+app = FastAPI(title="Canvas ComfyUI Workflow Adapter", version="1.0.0")
+audio_validator = AudioOutputValidator()
+provider_selection_lock = asyncio.Lock()
+provider_reservations: dict[str, int] = {}
+
+
+def auto_balance_enabled() -> bool:
+    return os.getenv("COMFY_AUTO_BALANCE", "").strip().lower() in {"1", "true", "yes", "on"}
+
+
+def providers() -> dict[str, Provider]:
+    raw = os.getenv("COMFY_PROVIDERS_JSON", "").strip()
+    rows: list[dict[str, Any]] = []
+    if raw:
+        parsed = json.loads(raw)
+        rows = parsed if isinstance(parsed, list) else []
+    elif os.getenv("COMFY_URL", "").strip():
+        rows = [{"id": "default", "name": "ComfyUI", "base_url": os.getenv("COMFY_URL"), "api_key": os.getenv("COMFY_API_KEY", "")}]
+    extra_path = Path('/app/huobao-extra-providers.json')
+    if extra_path.exists():
+        extra = json.loads(extra_path.read_text())
+        if not isinstance(extra, list) or any(not isinstance(row, dict) or row.get('id') not in ('gpu1', 'gpu1_8189') for row in extra):
+            raise ValueError('Invalid Huobao extra provider configuration')
+        existing_ids = {row.get('id') for row in rows}
+        rows.extend(row for row in extra if row['id'] not in existing_ids)
+    result: dict[str, Provider] = {}
+    for row in rows:
+        provider = Provider(id=str(row.get("id") or "").strip(), name=str(row.get("name") or row.get("id") or "ComfyUI"), base_url=str(row.get("base_url") or "").strip().rstrip("/"), api_key=str(row.get("api_key") or ""), control_token_file=str(row.get("control_token_file") or ""))
+        if provider.id and provider.base_url.startswith(("http://", "https://")):
+            result[provider.id] = provider
+    return result
+
+
+def require_token(authorization: str | None = Header(default=None)) -> None:
+    expected = os.getenv("COMFY_ADAPTER_TOKEN", "").strip()
+    if expected and not secrets.compare_digest(authorization or "", f"Bearer {expected}"):
+        raise HTTPException(status_code=401, detail="invalid adapter token")
+
+
+def provider_headers(provider: Provider) -> dict[str, str]:
+    headers = {"Authorization": f"Bearer {provider.api_key}"} if provider.api_key else {}
+    if provider.control_token_file:
+        path = Path(provider.control_token_file)
+        try:
+            # Operator-mounted token only; it is never accepted from JobRequest
+            # or exposed by the public provider catalogue.
+            if path.parent != Path('/run/h3-workers') or path.name != provider.id + '.token':
+                raise ValueError('invalid worker control token path')
+            token = path.read_text().strip()
+            if not 16 <= len(token) <= 512 or any(ord(x) < 33 or ord(x) > 126 for x in token):
+                raise ValueError('invalid worker control token')
+            headers['X-H3-Canary-Token'] = token
+        except (OSError, ValueError):
+            raise HTTPException(status_code=503, detail="生成节点控制配置未就绪，任务未提交")
+    return headers
+
+
+async def provider_queue_depth(provider: Provider) -> int | None:
+    try:
+        if provider.id == 'gpu1_8189':
+            # Same physical card: finish old accepted jobs without moving or cancelling them.
+            legacy = providers().get('gpu1')
+            if legacy:
+                async with httpx.AsyncClient(timeout=5) as client:
+                    old = await client.get(f'{legacy.base_url}/queue', headers=provider_headers(legacy))
+                    old.raise_for_status()
+                    queue = old.json()
+                    if queue.get('queue_running') or queue.get('queue_pending'):
+                        return None
+                    stats = await client.get(f'{legacy.base_url}/system_stats', headers=provider_headers(legacy))
+                    stats.raise_for_status()
+                    devices = stats.json().get('devices')
+                    if not isinstance(devices, list) or not devices or any(
+                        not isinstance(d, dict) or type(d.get('torch_vram_total')) not in (int, float)
+                        or not 0 <= d['torch_vram_total'] < float('inf') for d in devices
+                    ):
+                        return None
+                    # An idle cudaMallocAsync worker retains ~2.2 GiB of persistent tensors.
+                    # Allow at most 4 GiB within the new worker's existing 8 GiB reserve;
+                    # active/queued legacy jobs still block above, and large caches drain below.
+                    if sum(d['torch_vram_total'] for d in devices) > 4 * 1024**3:
+                        # Release only idle model caches; queue contents and results stay intact.
+                        released = await client.post(f'{legacy.base_url}/free', json={'unload_models': True, 'free_memory': True}, headers=provider_headers(legacy))
+                        released.raise_for_status()
+                        return None
+        async with httpx.AsyncClient(timeout=5) as client:
+            capabilities = await client.get(f"{provider.base_url}/object_info/ApplyVDNH3", headers=provider_headers(provider))
+            capabilities.raise_for_status()
+            if 'ApplyVDNH3' not in capabilities.json():
+                return None
+            response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+            response.raise_for_status()
+            payload = response.json()
+    except (httpx.HTTPError, ValueError, TypeError):
+        return None
+    return len(payload.get("queue_running") or []) + len(payload.get("queue_pending") or [])
+
+
+def admission_ids(configured: dict[str, Provider]) -> set[str]:
+    path = os.getenv("COMFY_ADMISSION_FILE", "").strip()
+    if not path:
+        return set(configured)
+    try:
+        raw = Path(path).read_bytes()
+        if len(raw) > 4096:
+            raise ValueError("oversized admission configuration")
+        value = json.loads(raw)
+        if not isinstance(value, dict):
+            raise ValueError("invalid admission configuration")
+        allowed = value.get("admit")
+        if type(value.get("schema")) is not int or value.get("schema") != 1 or not isinstance(allowed, list) or any(not isinstance(x, str) for x in allowed):
+            raise ValueError("invalid admission configuration")
+        if len(set(allowed)) != len(allowed) or not set(allowed) <= set(configured):
+            raise ValueError("unknown or duplicate admission provider")
+        return set(allowed)
+    except (OSError, ValueError, TypeError):
+        # Drain changes affect only new submissions; job lookup always retains
+        # both stable provider IDs and their existing history/output routes.
+        raise HTTPException(status_code=503, detail="生成服务正在切换，任务尚未提交，请稍后重试")
+
+
+async def select_provider(requested_provider_id: str, strict_provider: bool = False, huobao_panels: bool = False) -> Provider | None:
+    configured = providers()
+    admitted = admission_ids(configured)
+    if huobao_panels:
+        ports = {'default': 8188, 'gpu1_8189': 8189, 'gpu3': 8191}
+        configured = {key: replace(value, base_url=f'http://192.168.110.111:{ports[key]}') for key, value in configured.items() if key in ports}
+    else:
+        # Other applications retain their original worker selection.
+        configured = {key: value for key, value in configured.items() if key != 'gpu1_8189'}
+    requested = configured.get(requested_provider_id)
+    if requested is None:
+        return None
+    if strict_provider:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="指定显卡正在维护或排空，任务未提交；请稍后重试或选择自动分配")
+        if await provider_queue_depth(requested) is None:
+            raise HTTPException(status_code=503, detail=("GPU1 / 8189 暂不可用：旧 GPU1 任务或显存尚未释放，未取消原任务，也未提交新任务" if requested_provider_id == "gpu1_8189" else "指定显卡不可用或缺少所需工作流，任务未提交"))
+        return requested
+    if requested is None or requested_provider_id != "default" or not auto_balance_enabled() or len(configured) < 2:
+        if requested_provider_id not in admitted:
+            raise HTTPException(status_code=503, detail="该生成节点正在排空，现有任务继续执行，新任务请稍后提交")
+        return requested
+
+    candidates = [provider for provider in configured.values() if provider.id in admitted]
+    if not candidates:
+        raise HTTPException(status_code=503, detail="生成节点正在排空，现有任务和结果保持不变")
+    depths = await asyncio.gather(*(provider_queue_depth(provider) for provider in candidates))
+    available = [
+        (depth + provider_reservations.get(provider.id, 0), 0 if provider.id == requested_provider_id else 1, provider)
+        for provider, depth in zip(candidates, depths)
+        if depth is not None
+    ]
+    if not available:
+        if os.getenv("COMFY_ADMISSION_FILE", "").strip():
+            raise HTTPException(status_code=503, detail="生成节点尚未就绪，任务未提交，请稍后重试")
+        return requested
+    return min(available, key=lambda item: (item[0], item[1]))[2]
+
+
+async def reserve_provider(requested_provider_id: str, strict_provider: bool = False, huobao_panels: bool = False) -> Provider | None:
+    async with provider_selection_lock:
+        provider = await select_provider(requested_provider_id, strict_provider, huobao_panels)
+        if provider is not None:
+            provider_reservations[provider.id] = provider_reservations.get(provider.id, 0) + 1
+        return provider
+
+
+async def release_provider(provider: Provider) -> None:
+    async with provider_selection_lock:
+        remaining = provider_reservations.get(provider.id, 0) - 1
+        if remaining > 0:
+            provider_reservations[provider.id] = remaining
+        else:
+            provider_reservations.pop(provider.id, None)
+
+
+def input_host_allowlist() -> set[str]:
+    return {value.strip().lower().rstrip(".") for value in os.getenv("COMFY_INPUT_HOST_ALLOWLIST", "").split(",") if value.strip()}
+
+
+async def validate_input_url(value: str) -> None:
+    parsed = urlsplit(value)
+    host = (parsed.hostname or "").lower().rstrip(".")
+    if parsed.scheme not in {"http", "https"} or not host or parsed.username or parsed.password:
+        raise HTTPException(status_code=400, detail="reference image URL is invalid")
+    if host in input_host_allowlist():
+        return
+    try:
+        infos = await asyncio.to_thread(socket.getaddrinfo, host, parsed.port or (443 if parsed.scheme == "https" else 80), type=socket.SOCK_STREAM)
+    except OSError as exc:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved") from exc
+    if not infos:
+        raise HTTPException(status_code=400, detail="reference image host cannot be resolved")
+    for info in infos:
+        address = ipaddress.ip_address(info[4][0])
+        if not address.is_global:
+            raise HTTPException(status_code=400, detail="reference image URL cannot target a private address")
+
+
+async def download_input_image(client: httpx.AsyncClient, value: str) -> tuple[bytes, str]:
+    await validate_input_url(value)
+    chunks: list[bytes] = []
+    total = 0
+    async with client.stream("GET", value, follow_redirects=False) as response:
+        response.raise_for_status()
+        if 300 <= response.status_code < 400:
+            raise HTTPException(status_code=400, detail="reference image redirects are not accepted")
+        mime_type = response.headers.get("content-type", "image/png").split(";", 1)[0]
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference image URL did not return an image")
+        async for chunk in response.aiter_bytes():
+            total += len(chunk)
+            if total > 30 * 1024 * 1024:
+                raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+            chunks.append(chunk)
+    return b"".join(chunks), mime_type
+
+
+def encode_job(provider_id: str, prompt_id: str) -> str:
+    return base64.urlsafe_b64encode(f"{provider_id}:{prompt_id}".encode()).decode().rstrip("=")
+
+
+def decode_job(job_id: str) -> tuple[Provider, str]:
+    if job_id.startswith(("h3a1.", "h3v2.")):
+        job_id = job_id.split(".", 1)[1]
+    try:
+        raw = base64.urlsafe_b64decode(job_id + "=" * (-len(job_id) % 4)).decode()
+        provider_id, prompt_id = raw.split(":", 1)
+        provider = providers()[provider_id]
+    except Exception as exc:
+        raise HTTPException(status_code=404, detail="job not found") from exc
+    return provider, prompt_id
+
+
+def output_validation_mode() -> str:
+    mode = os.getenv("H3_OUTPUT_VALIDATION_MODE", "guarded").strip()
+    if mode not in {"guarded", "prompt-only"}:
+        raise HTTPException(status_code=503, detail="视频处理模式配置无效，任务未提交")
+    return mode
+
+
+@app.get("/health")
+async def health() -> dict[str, Any]:
+    return {
+        "status": "ok",
+        "providers": len(providers()),
+        "workflows": len(load_registry()),
+        "autoBalance": auto_balance_enabled(),
+        "outputValidationMode": output_validation_mode(),
+    }
+
+
+@app.get("/v1/providers", dependencies=[Depends(require_token)])
+async def list_providers() -> dict[str, Any]:
+    return {"providers": [{"id": item.id, "name": item.name, "baseUrl": item.base_url} for item in providers().values()]}
+
+
+@app.get("/v1/workflows", dependencies=[Depends(require_token)])
+async def list_workflows() -> dict[str, Any]:
+    return {"workflows": [public_workflow(item) for item in load_registry().values()]}
+
+
+@app.get("/v1/models", dependencies=[Depends(require_token)])
+async def list_models() -> dict[str, Any]:
+    return {"object": "list", "data": [public_model(item) for item in load_registry().values()]}
+
+
+async def upload_image(client: httpx.AsyncClient, provider: Provider, value: str, index: int, client_id: str) -> str:
+    value = value.strip()
+    if value.startswith("comfy://"):
+        return value.removeprefix("comfy://")
+    if value.startswith("data:"):
+        header, encoded = value.split(",", 1)
+        mime_type = header.split(";", 1)[0].removeprefix("data:") or "image/png"
+        if not mime_type.startswith("image/"):
+            raise HTTPException(status_code=400, detail="reference data URL must contain an image")
+        try:
+            data = base64.b64decode(encoded, validate=True)
+        except (ValueError, base64.binascii.Error) as exc:
+            raise HTTPException(status_code=400, detail="reference image data URL is invalid") from exc
+    elif value.startswith(("http://", "https://")):
+        data, mime_type = await download_input_image(client, value)
+    else:
+        raise HTTPException(status_code=400, detail="input_images must contain http(s), data, or comfy URLs")
+    if len(data) > 30 * 1024 * 1024:
+        raise HTTPException(status_code=413, detail="reference image exceeds 30 MB")
+    extension = mimetypes.guess_extension(mime_type) or ".png"
+    filename = f"{client_id}-reference-{index}{extension}"
+    response = await client.post(f"{provider.base_url}/upload/image", files={"image": (filename, data, mime_type)}, data={"overwrite": "true"}, headers=provider_headers(provider))
+    response.raise_for_status()
+    payload = response.json()
+    return str(payload.get("name") or filename)
+
+
+def request_audio_plan(spec, request: JobRequest) -> dict:
+    if not (spec.raw.get("speech_prompt_policy") == "minimax_h3" and spec.raw.get("native_audio_control")):
+        return {"supported": False}
+    if request.generate_audio is False:
+        return {"supported": True, "status": "ready", "normalized_prompt": request.prompt,
+                "dialogue_base_prompt": request.prompt, "dialogue": [], "sound_effects": [],
+                "music": [], "audio_mode": "silent", "silent": True, "speech_requested": False,
+                "expected_transcript": "", "required_seconds": 0, "max_duration_seconds": 15, "issues": []}
+    plan = plan_h3_audio(request.prompt, float(request.duration or 5))
+    if output_validation_mode() == "prompt-only" and not plan["silent"] and plan["audio_mode"] == "silent":
+        plan["audio_mode"] = "effects"
+    return {"supported": True, **plan}
+
+
+@app.post("/v1/audio-plan", dependencies=[Depends(require_token)])
+async def preview_audio_plan(request: JobRequest) -> dict:
+    spec = load_registry().get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    return request_audio_plan(spec, request)
+
+
+@app.post("/v1/jobs", dependencies=[Depends(require_token)])
+async def create_job(request: JobRequest) -> dict[str, Any]:
+    registry = load_registry()
+    spec = registry.get(request.workflow_key)
+    if spec is None:
+        raise HTTPException(status_code=400, detail="workflow is not registered")
+    try:
+        validate_h3_references(spec, len(request.input_images))
+    except ValueError as error:
+        raise HTTPException(status_code=400, detail=str(error)) from error
+    audio_plan = request_audio_plan(spec, request)
+    guarded_output = bool(audio_plan.get("supported")) and output_validation_mode() == "guarded"
+    if audio_plan.get("supported"):
+        if audio_plan.get("status") != "ready":
+            raise HTTPException(status_code=400, detail="H3_AUDIO_CONFIRMATION_REQUIRED: 请先确认台词及视频时长，再提交视频生成")
+        if not guarded_output:
+            request = request.model_copy(update={"prompt": audio_plan["normalized_prompt"]})
+        try:
+            if guarded_output:
+                validate_visual_dimensions(request.width, request.height)
+                await audio_validator.ready(visual_required=True, audio_required=audio_plan.get("audio_mode") in {"dialogue", "effects"})
+                if audio_plan.get("audio_mode") in {"dialogue", "effects"}:
+                    prompt = await prepare_audio_conditioning(audio_plan, request.prompt, float(request.duration or 5), len(request.input_images))
+                    request = request.model_copy(update={"prompt": prompt})
+        except AudioQualityError as error:
+            raise HTTPException(status_code=503 if error.code.endswith("_UNAVAILABLE") else 400, detail=str(error)) from error
+        except AudioConditioningError as error:
+            raise HTTPException(status_code=503 if error.code == "H3_AUDIO_NORMALIZER_UNAVAILABLE" else 400, detail=str(error)) from error
+    provider = await reserve_provider(request.provider_id, request.strict_provider, request.huobao_panels)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="provider is not configured")
+    try:
+        client_id = ("canvas-h3v2-" if guarded_output else "canvas-") + secrets.token_hex(8)
+        async with httpx.AsyncClient(timeout=60) as client:
+            uploaded = [await upload_image(client, provider, value, index, client_id) for index, value in enumerate(request.input_images, start=1)]
+            try:
+                workflow = compile_workflow(spec, request.model_dump(), uploaded, client_id, preserve_requested_audio=not guarded_output and bool(audio_plan.get("supported")))
+                if guarded_output:
+                    attach_audio_policy(workflow, audio_plan, float(request.duration or 5), str(spec.raw.get("save_node")), visual_required=True)
+            except ValueError as exc:
+                raise HTTPException(status_code=400, detail=str(exc)) from exc
+            response = await client.post(f"{provider.base_url}/prompt", json={"prompt": workflow, "client_id": client_id}, headers=provider_headers(provider))
+            if response.status_code == 400 and spec.raw.get("speech_prompt_policy") == "minimax_h3":
+                try:
+                    rejected = response.json()
+                except ValueError:
+                    rejected = {}
+                if "h3_caption_pipeline" in (rejected.get("node_errors") or {}) or "H3CaptionPipeline" in str((rejected.get("error") or {}).get("details") or ""):
+                    raise HTTPException(status_code=503, detail="字幕工作流预检未通过，处理组件、模型或字体尚未就绪；任务未进入 GPU 生成，请联系管理员。")
+            if response.status_code == 400:
+                rejected = response.json()
+                issues = []
+                for node, info in (rejected.get('node_errors') or {}).items():
+                    for error in info.get('errors', []):
+                        issues.append(str(node) + ': ' + str(error.get('message', '')) + ': ' + str(error.get('details', ''))[:300])
+                if not issues:
+                    issues = [str(rejected.get('error', 'Workflow validation failed'))[:600]]
+                raise HTTPException(status_code=400, detail='; '.join(issues)[:1800])
+            response.raise_for_status()
+            payload = response.json()
+    finally:
+        await release_provider(provider)
+    prompt_id = str(payload.get("prompt_id") or "").strip()
+    if not prompt_id:
+        raise HTTPException(status_code=502, detail="ComfyUI did not return prompt_id")
+    job_id = encode_job(provider.id, prompt_id)
+    persisted = True
+    if guarded_output:
+        job_id = "h3v2." + job_id
+        try:
+            audio_validator.register_policy(job_id, audio_plan, float(request.duration or 5), visual_required=True)
+        except AudioQualityError as error:
+            raise HTTPException(status_code=502, detail=str(error)) from error
+        except OSError:
+            # The provider already accepted this exact job. Return its ID rather
+            # than an ambiguous 500 inviting another GPU submission. Its graph
+            # carries the same policy; missing evidence still fails closed.
+            persisted = False
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "workflowKey": spec.key, "workflowRevision": spec.revision, "status": "submitted", "policyPersisted": persisted}
+
+
+def extract_outputs(entry: dict[str, Any], job_id: str) -> list[dict[str, Any]]:
+    result: list[dict[str, Any]] = []
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if not isinstance(item, dict) or not item.get("filename"):
+                    continue
+                filename = str(item["filename"])
+                mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                kind = "video" if mime_type.startswith("video/") or filename.lower().endswith((".gif", ".webp")) and field == "gifs" else "audio" if mime_type.startswith("audio/") else "image"
+                index = len(result)
+                result.append({"index": index, "kind": kind, "mimeType": mime_type, "filename": filename, "url": f"/jobs/{quote(job_id, safe='')}/outputs/{index}"})
+    return result
+
+
+async def job_state(job_id: str) -> tuple[Provider, str, dict[str, Any], list[dict[str, Any]]]:
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.get(f"{provider.base_url}/history/{quote(prompt_id, safe='')}", headers=provider_headers(provider))
+        response.raise_for_status()
+        history = response.json()
+    entry = history.get(prompt_id) or {}
+    outputs = extract_outputs(entry, job_id)
+    return provider, prompt_id, entry, outputs
+
+
+@app.get("/v1/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def get_job(job_id: str) -> dict[str, Any]:
+    try:
+        provider, prompt_id, entry, outputs = await job_state(job_id)
+    except httpx.TimeoutException:
+        provider, prompt_id = decode_job(job_id)
+        return {
+            "id": job_id,
+            "promptId": prompt_id,
+            "providerId": provider.id,
+            "status": "running",
+            "outputs": [],
+            "error": "",
+            "pollDeferred": True,
+        }
+    status_payload = entry.get("status") or {}
+    if status_payload.get("status_str") == "error":
+        status = "failed"
+    elif outputs and not (job_id.startswith("h3v2.") and not status_payload.get("completed")):
+        status = "succeeded"
+    elif status_payload.get("completed"):
+        status = "failed"
+    else:
+        status = "running"
+    if job_id.startswith("h3v2.") and status != "succeeded":
+        outputs = []
+    if status != "succeeded" and cancellation_dispatched(job_id):
+        # An acknowledged interrupt is not terminal until this exact prompt
+        # disappears from the worker queue. Never infer it from HTTP 200 alone.
+        try:
+            async with httpx.AsyncClient(timeout=10) as client:
+                response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+                response.raise_for_status()
+                queue = response.json()
+            if not isinstance(queue, dict) or not isinstance(queue.get("queue_running"), list) or not isinstance(queue.get("queue_pending"), list):
+                raise ValueError("invalid queue response")
+            remaining = {str(item[1]) for item in queue["queue_running"] + queue["queue_pending"] if isinstance(item, list) and len(item) > 1}
+            if prompt_id not in remaining:
+                status, outputs = "cancelled", []
+            else:
+                return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在取消生成", "cancelRequested": True}
+        except (httpx.HTTPError, ValueError):
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running", "outputs": [], "error": "", "stage": "正在确认取消", "cancelRequested": True}
+    error = "ComfyUI execution failed" if status == "failed" else ""
+    if status == "failed":
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            # 只映射已识别的内核错误，不向用户返回节点输入、提示词或 traceback。
+            if "tensor strides exceed int32 range" in str(event[1].get("exception_message") or ""):
+                error = "当前时长与分辨率组合超出采样内核范围，请缩短时长后重试（最多 15 秒）"
+                break
+    if status == "failed":
+        hints = {
+            "H3_SUBTITLE_MASK_UNCERTAIN": "检测到疑似字幕，但无法安全区分字幕和产品文字，任务已停止，未返回未清理视频。",
+            "H3_SUBTITLE_RESIDUAL": "字幕清理后仍检测到残留，任务已停止，避免生成双层字幕。",
+            "H3_SPEECH_MISMATCH": "实际口播与原台词不一致，未生成误导字幕；请缩短台词或调整后重试。",
+            "H3_SUBTITLE_ALIGNMENT": "口播时间轴校验未通过，无法准确烧录字幕；请缩短单句台词后重试。",
+            "H3_SUBTITLE_FONT": "字幕含字体不支持的字符，已停止以避免乱码；请使用常见文字。",
+            "H3_SUBTITLE_DEPENDENCY": "字幕处理服务依赖未就绪，请联系管理员；原任务未自动重试。",
+            "H3_SUBTITLE_FRAME_COUNT": "字幕处理前后帧数或尺寸不一致，已停止输出，请联系管理员。",
+        }
+        for event in status_payload.get("messages") or []:
+            if not isinstance(event, (list, tuple)) or len(event) < 2 or event[0] != "execution_error" or not isinstance(event[1], dict):
+                continue
+            message = str(event[1].get("exception_message") or "")
+            for code, hint in hints.items():
+                if message.startswith(code + ":"):
+                    error = hint
+                    break
+        # Never expose a partial/raw output from a failed cleanup/quality gate.
+        outputs = []
+    if status == "succeeded":
+        quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+        if quality["status"] in {"pending", "unavailable"}:
+            return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": "running",
+                    "outputs": [], "error": "", "stage": "正在校验字幕与音轨" if job_id.startswith("h3v2.") or quality.get("visual_required") else "正在校验视频音轨", "pollDeferred": True}
+        if quality["status"] == "failed":
+            status, outputs, error = "failed", [], quality["error"]
+    return {"id": job_id, "promptId": prompt_id, "providerId": provider.id, "status": status, "outputs": outputs, "error": error}
+
+
+@app.post("/v1/jobs/{job_id}/cancel", dependencies=[Depends(require_token)])
+async def cancel_job(job_id: str) -> dict[str, Any]:
+    provider, prompt_id = decode_job(job_id)
+    # Write intent before sending; disk failure must not produce an untracked
+    # cancellation. The worker API atomically compares the running prompt ID.
+    record_cancellation(job_id, False)
+    async with httpx.AsyncClient(timeout=30) as client:
+        response = await client.post(f"{provider.base_url}/api/jobs/{quote(prompt_id, safe='')}/cancel", json={}, headers=provider_headers(provider))
+        if response.status_code in (404, 405):
+            raise HTTPException(status_code=409, detail="生成节点未提供按任务取消接口，未中断其他任务")
+        response.raise_for_status()
+        acknowledged = response.json().get("cancelled")
+        if type(acknowledged) is not bool:
+            raise HTTPException(status_code=502, detail="生成节点取消回执无效，请核对原任务状态")
+        if acknowledged:
+            record_cancellation(job_id, True)
+    return await get_job(job_id)
+
+
+@app.get("/v1/jobs/{job_id}/outputs/{index}", dependencies=[Depends(require_token)])
+async def get_output(job_id: str, index: int) -> Response:
+    provider, _, entry, outputs = await job_state(job_id)
+    if (entry.get("status") or {}).get("status_str") == "error":
+        raise HTTPException(status_code=409, detail="任务未成功，未返回部分输出")
+    if not outputs or job_id.startswith("h3v2.") and not (entry.get("status") or {}).get("completed"):
+        raise HTTPException(status_code=409, detail="视频生成尚未完成，未返回部分输出")
+    quality = await audio_validator.poll(job_id, entry, provider.base_url, provider_headers(provider))
+    if quality["status"] != "verified":
+        raise HTTPException(status_code=422 if quality["status"] == "failed" else 409,
+                            detail=quality.get("error", "视频核验尚未完成，请稍后查询原任务"))
+    if index < 0 or index >= len(outputs):
+        raise HTTPException(status_code=404, detail="output not found")
+    wanted = outputs[index]
+    locator: dict[str, Any] | None = None
+    for node in (entry.get("outputs") or {}).values():
+        if not isinstance(node, dict):
+            continue
+        for field in ("images", "gifs", "audio"):
+            for item in node.get(field) or []:
+                if isinstance(item, dict) and str(item.get("filename")) == wanted["filename"]:
+                    locator = item
+                    break
+            if locator: break
+        if locator: break
+    if locator is None:
+        raise HTTPException(status_code=404, detail="output locator not found")
+    if quality.get("visual_revision") == VISUAL_REVISION:
+        bound_locator = {key: locator.get(key, "output" if key == "type" else "") for key in ("filename", "subfolder", "type")}
+        try:
+            media = await audio_validator.verified_download(quality, bound_locator, provider.base_url, provider_headers(provider))
+        except AudioQualityError as error:
+            raise HTTPException(status_code=422, detail=str(error)) from error
+        except (httpx.HTTPError, OSError, asyncio.TimeoutError):
+            raise HTTPException(status_code=503, detail="H3_VISUAL_VALIDATION_UNAVAILABLE: 已核验视频暂不可读取，请查询原任务") from None
+        return Response(content=media, media_type=wanted["mimeType"], headers={"Cache-Control": "private, no-store"})
+    query = urlencode({"filename": locator.get("filename", ""), "subfolder": locator.get("subfolder", ""), "type": locator.get("type", "output")})
+    client = httpx.AsyncClient(timeout=120)
+    response = await client.send(client.build_request("GET", f"{provider.base_url}/view?{query}", headers=provider_headers(provider)), stream=True)
+    if response.status_code >= 400:
+        await response.aclose(); await client.aclose()
+        raise HTTPException(status_code=502, detail="failed to read ComfyUI output")
+    async def stream():
+        try:
+            async for chunk in response.aiter_bytes():
+                yield chunk
+        finally:
+            await response.aclose(); await client.aclose()
+    return StreamingResponse(stream(), media_type=response.headers.get("content-type", wanted["mimeType"]))
+
+@app.post("/v1/huobao/route", dependencies=[Depends(require_token)])
+async def huobao_route(request: JobRequest) -> dict[str, Any]:
+    provider = await select_provider(request.provider_id, request.strict_provider, True)
+    if provider is None:
+        raise HTTPException(status_code=400, detail="unknown requested worker")
+    return {"providerId": provider.id, "baseUrl": provider.base_url, "ready": True}
+
+
+
+@app.get("/v1/huobao/jobs/{job_id}", dependencies=[Depends(require_token)])
+async def huobao_job_status(job_id: str) -> dict[str, Any]:
+    # Keep the general API contract unchanged; Huobao needs actual queue state.
+    result = await get_job(job_id)
+    if result.get("status") != "running":
+        return {**result, "worker_state": result.get("status")}
+    if result.get("pollDeferred"):
+        return {**result, "worker_state": "checking"}
+    provider, prompt_id = decode_job(job_id)
+    async with httpx.AsyncClient(timeout=10) as client:
+        response = await client.get(f"{provider.base_url}/queue", headers=provider_headers(provider))
+        response.raise_for_status()
+        queue = response.json()
+    running = [row[1] for row in queue.get("queue_running", [])]
+    pending = [row[1] for row in queue.get("queue_pending", [])]
+    if prompt_id in running:
+        return {**result, "worker_state": "running"}
+    if prompt_id in pending:
+        return {**result, "worker_state": "queued", "queue_position": pending.index(prompt_id) + 1}
+    # A task may finish between the first history read and the queue read.
+    fresh = await get_job(job_id)
+    if fresh.get("status") != "running":
+        return {**fresh, "worker_state": fresh.get("status")}
+    if fresh.get("pollDeferred"):
+        return {**fresh, "worker_state": "checking"}
+    # Do not invent success/failure or submit again when a worker has lost history.
+    return {**fresh, "worker_state": "missing"}
diff --git a/integration-work/vdn_image_nodes.py b/integration-work/vdn_image_nodes.py
new file mode 100644
index 0000000..534ed57
--- /dev/null
+++ b/integration-work/vdn_image_nodes.py
@@ -0,0 +1,8 @@
+import subprocess
+code="""import urllib.request,json
+d=json.load(urllib.request.urlopen('http://comfyui:8188/object_info'))
+for k,v in d.items():
+ if 'crop' in k.lower() or k in ['ImageScale','ImageScaleToMaxDimension']:
+  print(json.dumps({k:v['input']}))
+"""
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
diff --git a/integration-work/vdn_logs.py b/integration-work/vdn_logs.py
new file mode 100644
index 0000000..c609eeb
--- /dev/null
+++ b/integration-work/vdn_logs.py
@@ -0,0 +1,6 @@
+import subprocess,re
+for name in ('huobao-vdn-normalizer','huobao-vdn-bridge'):
+    out=subprocess.run(['docker','logs','--tail','55',name],capture_output=True,text=True)
+    text=out.stdout+out.stderr
+    text=re.sub(r'(?i)(Bearer\s+)\S+',r'\1[redacted]',text)
+    print(name,text[-9000:])
diff --git a/integration-work/verify_and_remove_reference_probe.py b/integration-work/verify_and_remove_reference_probe.py
new file mode 100644
index 0000000..4cdebfd
--- /dev/null
+++ b/integration-work/verify_and_remove_reference_probe.py
@@ -0,0 +1,25 @@
+import subprocess
+# This exact test job was submitted by verify_reference_image_live.py; never touch project jobs.
+code='''import asyncio,json,httpx,app
+jid='Z3B1MV84MTg5Ojc1NTgyYWE1LWMxNzgtNGFmMi1iMjJkLTNjMzE5ZTFjZmNhNg'
+async def main():
+ p,pid=app.decode_job(jid)
+ assert p.id=='gpu1_8189' and pid=='75582aa5-c178-4af2-b22d-3c319e1cfca6'
+ async with httpx.AsyncClient(timeout=15) as c:
+  q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+  found=next((x for x in q.get('queue_pending',[]) if x[1]==pid),None)
+  assert found is not None,'Probe no longer pending; leave unchanged for inspection'
+  graph=found[2]
+  refs=[n['inputs']['image'] for n in graph.values() if n.get('class_type')=='LoadImage']
+  assert len(refs)==1,[(n.get('class_type'),list(n.get('inputs',{}))) for n in graph.values()]
+  print(json.dumps({'probe':pid,'provider':p.id,'reference_uploads':refs,'node_types':sorted({n['class_type'] for n in graph.values()})}))
+  before={x[1] for x in q.get('queue_pending',[])+q.get('queue_running',[]) if x[1]!=pid}
+  result=await app.cancel_job(jid)
+  assert result['status']=='cancelled',result
+  q2=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+  after={x[1] for x in q2.get('queue_pending',[])+q2.get('queue_running',[])}
+  assert before<=after and pid not in after
+  print(json.dumps({'cancelled_only_probe':True,'other_queued_or_running_tasks_preserved':len(before)}))
+asyncio.run(main())'''
+r=subprocess.run(['docker','exec','canvas-h3-prompt-normalizer-healthy-20261026','python','-c',code],capture_output=True,text=True)
+print(r.stdout);print(r.stderr);raise SystemExit(r.returncode)
diff --git a/integration-work/verify_gpu1_image_live.py b/integration-work/verify_gpu1_image_live.py
new file mode 100644
index 0000000..fbd290c
--- /dev/null
+++ b/integration-work/verify_gpu1_image_live.py
@@ -0,0 +1,33 @@
+import json,sys,time,urllib.request
+from pathlib import Path
+from PIL import Image
+root=Path(__file__).resolve().parent
+state=root/'gpu1-image-verification-20261109.json'
+cfg=json.loads((root.parent/'model-bridge/client.json').read_text(encoding='utf-8-sig'))
+base=cfg['url'].rstrip('/')
+def request(path,payload=None):
+ data=None if payload is None else json.dumps(payload).encode()
+ req=urllib.request.Request(base+path,data=data,headers={'Authorization':'Bearer '+cfg['token'],'Content-Type':'application/json'})
+ with urllib.request.urlopen(req,timeout=45) as response:return json.load(response)
+if sys.argv[1]=='submit':
+ assert not state.exists(),'Verification task already exists; poll it instead.'
+ result=request('/v1/images/generations',{'model':'qwen_image_2_1','prompt':'A studio photograph of a red ceramic cup on a wooden table, soft daylight, no writing.','size':'512x512','gpu':'gpu1','n':1})
+ assert result['provider_id']=='gpu1_8189'
+ state.write_text(json.dumps(result,indent=2))
+ print(json.dumps(result))
+else:
+ saved=json.loads(state.read_text());jid=saved['task_id']
+ for _ in range(8):
+  result=request('/v1/images/task/'+jid)
+  if result['status']=='completed':
+   path=root/'gpu1-8189-image-verification.png'
+   with urllib.request.urlopen(result['image_url'],timeout=30) as response:path.write_bytes(response.read())
+   with Image.open(path) as im:
+    im.verify()
+   with Image.open(path) as im:size=im.size
+   assert size==(512,512)
+   saved.update(status='completed',provider_id=result['provider_id'],dimensions=list(size),output=str(path))
+   state.write_text(json.dumps(saved,indent=2));print(json.dumps(saved));break
+  if result['status']=='failed':raise RuntimeError(result)
+  print(json.dumps({'status':result['status'],'provider':result.get('provider_id')}),flush=True)
+  time.sleep(5)
diff --git a/integration-work/verify_panel_post_routes.py b/integration-work/verify_panel_post_routes.py
new file mode 100644
index 0000000..8f798ef
--- /dev/null
+++ b/integration-work/verify_panel_post_routes.py
@@ -0,0 +1,14 @@
+import subprocess,json
+code='''import asyncio,httpx,json,app
+from dataclasses import replace
+async def main():
+ async with httpx.AsyncClient(timeout=15) as client:
+  for key,port in [('default',8188),('gpu1_8189',8189),('gpu3',8191)]:
+   p=replace(app.providers()[key],base_url=f'http://192.168.110.111:{port}')
+   r=await client.post(p.base_url+'/prompt',json={'prompt':{}},headers=app.provider_headers(p))
+   d=r.json()
+   assert r.status_code==400 and not d.get('prompt_id'),(port,r.status_code)
+   print(json.dumps({'worker':key,'port':port,'post_reaches_comfyui':True,'empty_workflow_rejected_without_gpu_job':True,'error_type':d.get('error',{}).get('type')}))
+asyncio.run(main())
+'''
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
diff --git a/integration-work/verify_panel_routing_live.py b/integration-work/verify_panel_routing_live.py
new file mode 100644
index 0000000..665d42f
--- /dev/null
+++ b/integration-work/verify_panel_routing_live.py
@@ -0,0 +1,20 @@
+import subprocess,json
+code='''import asyncio,httpx,json,app
+async def main():
+ async with httpx.AsyncClient(timeout=15) as c:
+  for p in app.providers().values():
+   q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+   stats=(await c.get(p.base_url+'/system_stats',headers=app.provider_headers(p))).json()
+   print(json.dumps({'worker':p.id,'running':[x[1] for x in q.get('queue_running',[])],'pending':len(q.get('queue_pending',[])),'torch_vram':sum(x.get('torch_vram_total',0) for x in stats.get('devices',[]))}))
+  for key in ('default','gpu1_8189','gpu3'):
+   try:
+    p=await app.select_provider(key,True,True)
+    print(json.dumps({'selected':key,'url':p.base_url,'ready':True}))
+   except Exception as e:print(json.dumps({'selected':key,'ready':False,'detail':str(getattr(e,'detail',e))}))
+asyncio.run(main())
+'''
+print(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True))
+r=subprocess.run(['docker','logs','--tail','50','huobao-comfy-gpu1'],capture_output=True,text=True)
+lines=(r.stdout+r.stderr).replace('\r','\n').splitlines()
+for line in lines:
+ if any(x in line for x in ('%|','Prompt executed','Error','OutOfMemory','Loading','loaded completely')):print(line[:240])
diff --git a/integration-work/verify_reference_image_live.py b/integration-work/verify_reference_image_live.py
new file mode 100644
index 0000000..373e594
--- /dev/null
+++ b/integration-work/verify_reference_image_live.py
@@ -0,0 +1,21 @@
+from pathlib import Path
+import json,sys,time,requests
+from PIL import Image
+root=Path('D:/web/dj');state=root/'integration-work/reference-image-live-result.json'
+config=json.loads((root/'model-bridge/client.json').read_text(encoding='utf-8-sig'));base=config['url'].rstrip('/')
+headers={'Authorization':'Bearer '+config['token']}
+if sys.argv[1]=='submit':
+ assert not state.exists(),'Poll existing task instead'
+ with (root/'integration-work/gpu1-8189-image-verification.png').open('rb') as image:
+  r=requests.post(base+'/v1/images/edits',headers=headers,data={'model':'qwen_image_2_1','prompt':'Keep the exact cup shape, handle, camera angle, wooden table and soft daylight from the reference image. Change only the red ceramic glaze to deep cobalt blue. No text.','size':'512x512','n':'1','gpu':'gpu1'},files=[('image[]',('reference.png',image,'image/png'))],timeout=45)
+ r.raise_for_status();result=r.json();assert result['provider_id']=='gpu1_8189';state.write_text(json.dumps(result));print(json.dumps(result))
+else:
+ saved=json.loads(state.read_text());jid=saved['task_id']
+ for _ in range(8):
+  r=requests.get(base+'/v1/images/task/'+jid,headers=headers,timeout=15);r.raise_for_status();result=r.json()
+  if result['status']=='completed':
+   raw=requests.get(result['image_url'],timeout=30);raw.raise_for_status();out=root/'integration-work/reference-image-live-blue-cup.png';out.write_bytes(raw.content)
+   with Image.open(out) as im:im.verify()
+   saved.update(status='completed',provider_id=result['provider_id'],output=str(out));state.write_text(json.dumps(saved,indent=2));print(json.dumps(saved));break
+  if result['status']=='failed':raise RuntimeError(result)
+  print(json.dumps({'status':result['status'],'provider':result.get('provider_id')}),flush=True);time.sleep(5)
diff --git a/integration-work/verify_three_gpu_workers.py b/integration-work/verify_three_gpu_workers.py
new file mode 100644
index 0000000..44aa90d
--- /dev/null
+++ b/integration-work/verify_three_gpu_workers.py
@@ -0,0 +1,40 @@
+import subprocess,json,pathlib
+root=pathlib.Path('/home/ps/huobao-gpu-selection')
+code='''import asyncio,httpx,json,app
+async def main():
+ result={}
+ async with httpx.AsyncClient(timeout=30) as c:
+  graph=json.load(open('/app/workflows/vdn_hd.json'))
+  for p in app.providers().values():
+   r=await c.get(p.base_url+'/object_info',headers=app.provider_headers(p));r.raise_for_status();nodes=r.json()
+   missing=[]
+   for node in graph.values():
+    typ=node['class_type']
+    if typ not in nodes:missing.append(typ);continue
+    fields={**nodes[typ].get('input',{}).get('required',{}),**nodes[typ].get('input',{}).get('optional',{})}
+    for key,val in node['inputs'].items():
+     options=fields.get(key,[])
+     if options and isinstance(options[0],list) and isinstance(val,str):
+      choices=[x.get('key') if isinstance(x,dict) else x for x in options[0]]
+      if val not in choices:missing.append(typ+':'+key+':'+val)
+   q=(await c.get(p.base_url+'/queue',headers=app.provider_headers(p))).json()
+   result[p.id]={'nodes':len(nodes),'vdn_missing':missing,'running':len(q.get('queue_running',[])),'pending':len(q.get('queue_pending',[]))}
+  print(json.dumps(result))
+asyncio.run(main())
+'''
+out=subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',code],text=True)
+data=json.loads(out);(root/'three-gpu-preflight.json').write_text(json.dumps(data,indent=2));print(out)
+assert set(data)=={'default','gpu1','gpu3'}
+assert all(not d['vdn_missing'] for d in data.values()),'VDN preflight failed'
+# Verify histories imported before restoring GPU3 admission.
+meta=json.loads((root/'gpu3-vdn/created.json').read_text())
+history_code='''import asyncio,httpx,app
+async def main():
+ p=app.providers()['gpu3']
+ async with httpx.AsyncClient(timeout=20) as c:
+  r=await c.get(p.base_url+'/history',headers=app.provider_headers(p));r.raise_for_status();print(len(r.json()))
+asyncio.run(main())
+'''
+count=int(subprocess.check_output(['docker','exec','huobao-vdn-normalizer','python','-c',history_code],text=True))
+assert count>=meta['history_count']
+print('GPU3 history preserved:',count)
diff --git a/integration-work/video-pool-preflight.py b/integration-work/video-pool-preflight.py
new file mode 100644
index 0000000..b40ee1c
--- /dev/null
+++ b/integration-work/video-pool-preflight.py
@@ -0,0 +1,70 @@
+"""Run inside the existing upstream container. Read-only; no /prompt requests."""
+import asyncio
+import json
+from unittest.mock import patch
+
+import app
+import httpx
+from workflow import compile_workflow, load_registry
+
+WORKFLOWS = {
+    "minimax_h3_t2v_official": 0,
+    "minimax_h3_i2v": 1,
+    "minimax_h3_r2v": 1,
+    "minimax_h3_hybrid_v0331_t2v": 0,
+    "minimax_h3_hybrid_v0331_i2v": 1,
+    "minimax_h3_r2v_4step": 1,
+    "ltx23_t2v": 0,
+    "ltx23_t2v_text_preserve": 0,
+    "wan22_simple": 1,
+}
+
+
+async def main():
+    report = {"health": await app.health(), "workers": [], "scheduler_checks": {}}
+    registry = load_registry()
+    async with httpx.AsyncClient(timeout=30) as client:
+        for provider in app.providers().values():
+            response = await client.get(provider.base_url + "/object_info", headers=app.provider_headers(provider))
+            response.raise_for_status()
+            info = response.json()
+            checks = {}
+            for key, refs in WORKFLOWS.items():
+                spec = registry[key]
+                request = app.JobRequest(provider_id="default", workflow_key=key, prompt="A mountain landscape. No dialogue.", duration=5, width=832, height=480)
+                plan = app.request_audio_plan(spec, request)
+                if plan.get("supported"):
+                    request = request.model_copy(update={"prompt": plan["normalized_prompt"]})
+                graph = compile_workflow(spec, request.model_dump(), ["preflight.png"] * refs, "huobao-preflight", preserve_requested_audio=bool(plan.get("supported")))
+                missing_nodes = sorted(set(node["class_type"] for node in graph.values()) - set(info))
+                missing_choices = []
+                for node in graph.values():
+                    node_info = info.get(node["class_type"], {}).get("input", {})
+                    choices = {**node_info.get("required", {}), **node_info.get("optional", {})}
+                    for field, value in node.get("inputs", {}).items():
+                        choice = choices.get(field)
+                        if isinstance(value, str) and choice and isinstance(choice[0], list) and value not in choice[0] and field != "image":
+                            missing_choices.append([node["class_type"], field, value])
+                checks[key] = {"missing_nodes": missing_nodes, "missing_choices": missing_choices, "audio_plan": plan.get("status")}
+            report["workers"].append({"id": provider.id, "name": provider.name, "queue_depth": await app.provider_queue_depth(provider), "workflows": checks})
+    # Isolated in this process: exercise the live scheduler's failover/reservations
+    # without changing the running service or reserving real worker capacity.
+    async def depth(provider):
+        return depths[provider.id]
+    with patch.object(app, "provider_queue_depth", depth):
+        depths = {"default": 4, "gpu3": 1}
+        report["scheduler_checks"]["shorter_gpu3_queue"] = (await app.select_provider("default")).id
+        depths = {"default": 1, "gpu3": 4}
+        report["scheduler_checks"]["shorter_gpu2_queue"] = (await app.select_provider("default")).id
+        depths = {"default": None, "gpu3": 0}
+        report["scheduler_checks"]["gpu2_unavailable"] = (await app.select_provider("default")).id
+        depths = {"default": 0, "gpu3": 0}
+        first = await app.reserve_provider("default")
+        second = await app.reserve_provider("default")
+        report["scheduler_checks"]["concurrent_reservations"] = [first.id, second.id]
+        await app.release_provider(first)
+        await app.release_provider(second)
+    print(json.dumps(report, ensure_ascii=False))
+
+
+asyncio.run(main())
diff --git a/model-bridge/.gitignore b/model-bridge/.gitignore
new file mode 100644
index 0000000..fd20f86
--- /dev/null
+++ b/model-bridge/.gitignore
@@ -0,0 +1,7 @@
+client.json
+grok-client.json
+state/
+grok-state/
+grok-workspace/
+*.log
+__pycache__/
diff --git a/model-bridge/Grok登录.cmd b/model-bridge/Grok登录.cmd
new file mode 100644
index 0000000..3ae8e57
--- /dev/null
+++ b/model-bridge/Grok登录.cmd
@@ -0,0 +1,5 @@
+@echo off
+chcp 65001 >nul
+"D:\web\age\wechat_rpa\.grok-build\bin\grok.exe" login
+"C:\Users\pc\AppData\Local\Programs\Python\Python311\python.exe" "%~dp0activate_grok.py"
+pause
diff --git a/model-bridge/activate_grok.py b/model-bridge/activate_grok.py
new file mode 100644
index 0000000..fd8d131
--- /dev/null
+++ b/model-bridge/activate_grok.py
@@ -0,0 +1,71 @@
+"""Run after interactive Grok login; enable the provider only after a real reply."""
+import json
+from pathlib import Path
+import re
+import subprocess
+import sys
+import time
+
+import requests
+
+
+def activate():
+    root = Path(__file__).resolve().parent
+    config = json.loads((root / "grok-client.json").read_text(encoding="utf-8"))
+    session = requests.Session()
+    session.trust_env = False
+    endpoint = config["public_url"]
+    try:
+        session.get(endpoint + "/health", timeout=3).raise_for_status()
+    except requests.RequestException:
+        pythonw = str(Path(sys.executable).with_name("pythonw.exe"))
+        subprocess.Popen([pythonw, str(root / "launch_local.py")], cwd=root,
+                         creationflags=0x08000000 | 0x00000008)
+        for _ in range(20):
+            try:
+                session.get(endpoint + "/health", timeout=1).raise_for_status()
+                break
+            except requests.RequestException:
+                time.sleep(.5)
+        else:
+            raise RuntimeError("本地 Grok 兼容服务未能启动，请查看 grok-bridge.log")
+    print("正在验证 Grok 登录状态和文本回复……")
+    response = session.post(endpoint + "/v1/chat/completions",
+                            headers={"Authorization": "Bearer " + config["token"]},
+                            json={"model": "grok-local", "messages": [{"role": "user", "content": "Reply with OK only."}]}, timeout=260)
+    if not response.ok or not response.json().get("choices", [{}])[0].get("message", {}).get("content"):
+        raise RuntimeError("Grok 仍无法生成回复，请完成 Grok CLI 登录后再试；火宝中的 Grok 保持停用。")
+    huobao = Path.home() / "AppData/Roaming/HuobaoDrama"
+    def app_url():
+        ports = re.findall(r"port=(\d+) userData=", (huobao / "logs/startup.log").read_text(encoding="utf-8"))
+        return "http://127.0.0.1:" + ports[-1] + "/api/v1"
+    try:
+        base = app_url()
+        session.get(base + "/health", timeout=3).raise_for_status()
+    except (requests.RequestException, OSError, IndexError):
+        executable = root.parent / "HuobaoDrama/HuobaoDrama.exe"
+        subprocess.Popen([str(executable)], cwd=executable.parent)
+        for _ in range(30):
+            time.sleep(1)
+            try:
+                base = app_url()
+                session.get(base + "/health", timeout=1).raise_for_status()
+                break
+            except (requests.RequestException, OSError, IndexError):
+                pass
+        else:
+            raise RuntimeError("Grok 已登录，但火宝未启动，请打开火宝后重新运行此脚本")
+    rows = session.get(base + "/ai-configs", timeout=10).json()["data"]
+    row = next((r for r in rows if "grok-local" in r.get("model", []) and r["base_url"].startswith(endpoint)), None)
+    if not row:
+        raise RuntimeError("未找到已准备的 Grok 配置")
+    session.put(base + "/ai-configs/" + str(row["id"]), json={"name": "Grok（本机）", "is_active": True}, timeout=10).raise_for_status()
+    print("Grok 已通过实测并在火宝中启用。DeepSeek 仍是默认模型。")
+
+
+if __name__ == "__main__":
+    try:
+        activate()
+    except Exception as error:
+        print(str(error))
+        sys.exit(1)
diff --git a/model-bridge/add_gpu_variants.py b/model-bridge/add_gpu_variants.py
new file mode 100644
index 0000000..5143492
--- /dev/null
+++ b/model-bridge/add_gpu_variants.py
@@ -0,0 +1,41 @@
+"""Add fixed-GPU choices without changing any existing model, project, or style."""
+import argparse, datetime, json, sqlite3
+from pathlib import Path
+
+root = Path(__file__).resolve().parent.parent
+p = argparse.ArgumentParser()
+p.add_argument('--data-dir', default=str(root / 'huobao-data'))
+a = p.parse_args()
+data = Path(a.data_dir).resolve()
+assert data == root / 'huobao-data' or (data.is_relative_to(root / 'integration-work') and data.name.startswith('hd-test'))
+path = data / 'huobao.sqlite3'
+assert path.is_file()
+backup = data / 'backups' / ('before-gpu-variants-' + datetime.datetime.now().strftime('%Y%m%d-%H%M%S') + '.sqlite3')
+backup.parent.mkdir(exist_ok=True)
+with sqlite3.connect(path) as db, sqlite3.connect(backup) as dest:
+    db.backup(dest)
+with sqlite3.connect(path) as db:
+    db.row_factory = sqlite3.Row
+    sources = {4: 'MiniMax H3', 6: 'Qwen Image 2.1', 7: 'MiniMax H3 加速版', 8: 'LTX 2.3', 9: 'Wan 2.2 图生视频', 10: 'MiniMax H3-VDN-H3 高清 2K/4K'}
+    rows = [dict(r) for r in db.execute('SELECT * FROM ai_service_configs')]
+    made = []
+    for sid, label in sources.items():
+        source = next(r for r in rows if r['id'] == sid)
+        assert source['service_type'] in ('image', 'video') and source['base_url'].startswith('http://192.168.110.111:1879')
+        for gpu in ('gpu1', 'gpu2', 'gpu3'):
+            if any(json.loads(r['settings'] or '{}').get('gpu_variant_source') == sid and json.loads(r['settings'] or '{}').get('gpu') == gpu for r in rows):
+                continue
+            values = {k: v for k, v in source.items() if k != 'id'}
+            settings = json.loads(source['settings'] or '{}')
+            settings.update(gpu=gpu, gpu_variant_source=sid)
+            comfy_label='ComfyUI '+{'gpu1':'8189','gpu2':'8188','gpu3':'8191'}[gpu]
+            values.update(name=f'{label} · {gpu.upper()} · {comfy_label}', settings=json.dumps(settings), priority=source['priority'] - 10,
+                          created_at=datetime.datetime.now(datetime.timezone.utc).isoformat(), updated_at=datetime.datetime.now(datetime.timezone.utc).isoformat())
+            columns = ','.join('"' + k + '"' for k in values)
+            db.execute(f'INSERT INTO ai_service_configs ({columns}) VALUES ({",".join("?" for _ in values)})', list(values.values()))
+            made.append(values['name'])
+    # Every pre-existing row must remain byte-for-byte equal.
+    after = {r['id']: dict(r) for r in db.execute('SELECT * FROM ai_service_configs')}
+    assert all(after[r['id']] == r for r in rows)
+    db.commit()
+print(json.dumps({'added': len(made), 'names': made, 'backup': str(backup)}, ensure_ascii=False))
diff --git a/model-bridge/add_styles.py b/model-bridge/add_styles.py
new file mode 100644
index 0000000..ac499f4
--- /dev/null
+++ b/model-bridge/add_styles.py
@@ -0,0 +1,20 @@
+import json, re, os, urllib.request
+from pathlib import Path
+root=Path(__file__).resolve().parent
+log=(Path(os.environ['APPDATA'])/'HuobaoDrama/logs/startup.log').read_text(encoding='utf-8')
+port=re.findall(r'port=(\d+) userData=',log)[-1]
+base='http://127.0.0.1:'+port+'/api/v1'
+def request(path,body=None):
+    req=urllib.request.Request(base+path,data=json.dumps(body).encode() if body else None,headers={'Content-Type':'application/json'})
+    with urllib.request.urlopen(req,timeout=20) as r: return json.load(r)['data']
+styles=request('/style-presets?all=1')
+if isinstance(styles,dict): styles=styles.get('items',[])
+live=json.loads((root/'style-live-action.json').read_text(encoding='utf-8'))
+xianxia={'name':'仙侠风格','value':'xianxia-live-action','description':'真人仙侠影视质感：古装修仙人物、仙山云海、御剑与克制的法术光效。',
+    'prompt':'Cinematic live-action Chinese xianxia fantasy, photorealistic human actors with natural anatomy and detailed skin texture, elegant traditional Chinese flowing robes with realistic silk fabric and intricate embroidery, ethereal immortal mountains and misty cloud seas, ancient Chinese temples, jade and weathered stone, graceful sword cultivation, restrained luminous magical effects with physically plausible light interaction, atmospheric depth, film-quality practical sets and convincing visual effects, cinematic composition, natural expressive faces, no anime, no cartoon, no game character render, no plastic skin.',
+    'sort_order':1,'is_active':True}
+(root/'style-xianxia.json').write_text(json.dumps(xianxia,ensure_ascii=False,indent=2),encoding='utf-8')
+for style in (live,xianxia):
+    existing=next((s for s in styles if s.get('value')==style['value']),None)
+    if existing: print('preserved',style['value'],existing['id'])
+    else: print('added',style['value'],request('/style-presets',style)['id'])
diff --git a/model-bridge/audit_data.py b/model-bridge/audit_data.py
new file mode 100644
index 0000000..566718b
--- /dev/null
+++ b/model-bridge/audit_data.py
@@ -0,0 +1,15 @@
+import hashlib,json,sqlite3,sys
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+with sqlite3.connect((root/'huobao-data/huobao.sqlite3').as_uri()+'?mode=ro',uri=True) as db:
+    db.row_factory=sqlite3.Row
+    report={'integrity':db.execute('PRAGMA quick_check').fetchone()[0],'tables':{}}
+    for table in ('dramas','episodes','storyboards','characters','scenes','props','ai_service_configs','style_presets'):
+        rows=[dict(row) for row in db.execute('SELECT * FROM '+table+' ORDER BY id')]
+        report['tables'][table]={'count':len(rows),'ids':[r['id'] for r in rows],
+            'sha256':hashlib.sha256(json.dumps(rows,sort_keys=True,ensure_ascii=False).encode()).hexdigest()}
+        if rows and 'deleted_at' in rows[0]: report['tables'][table]['active']=sum(not r.get('deleted_at') for r in rows)
+    report['media']={p.relative_to(root/'huobao-data').as_posix():hashlib.sha256(p.read_bytes()).hexdigest() for p in (root/'huobao-data/static').rglob('*') if p.is_file()}
+if len(sys.argv)>1: (root/'integration-work'/sys.argv[1]).write_text(json.dumps(report,indent=2))
+print(json.dumps({k:{a:b for a,b in v.items() if a in ('count','active')} for k,v in report['tables'].items()},ensure_ascii=False))
+print('integrity:',report['integrity'],'media files:',len(report['media']))
diff --git a/model-bridge/backup_upgrade.py b/model-bridge/backup_upgrade.py
new file mode 100644
index 0000000..5f141ce
--- /dev/null
+++ b/model-bridge/backup_upgrade.py
@@ -0,0 +1,61 @@
+"""Create a complete upgrade rollback copy without touching live project data."""
+from datetime import datetime
+import hashlib
+import json
+import os
+from pathlib import Path
+import shutil
+import sqlite3
+import subprocess
+
+ROOT = Path(__file__).resolve().parent.parent
+DEST = ROOT / "integration-work/backups" / ("upgrade-" + datetime.now().strftime("%Y%m%d-%H%M%S"))
+
+
+def main():
+    DEST.mkdir(parents=True, exist_ok=False)
+    subprocess.run(["icacls", str(DEST), "/inheritance:r", "/grant:r", os.environ["USERNAME"] + ":(OI)(CI)(F)", "SYSTEM:(OI)(CI)(F)"], check=True, capture_output=True)
+    data_dest = DEST / "huobao-data"
+    data_dest.mkdir()
+    database = ROOT / "huobao-data/huobao.sqlite3"
+    with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True) as source, sqlite3.connect(data_dest / "huobao.sqlite3") as snapshot:
+        source.backup(snapshot)
+        assert snapshot.execute("PRAGMA integrity_check").fetchone()[0] == "ok"
+        counts = {name: snapshot.execute('SELECT count(*) FROM "' + name + '"').fetchone()[0]
+                  for (name,) in snapshot.execute("SELECT name FROM sqlite_master WHERE type='table'")}
+    for item in (ROOT / "huobao-data").iterdir():
+        if item.name.startswith("huobao.sqlite3") or item.name == "backups":
+            continue
+        target = data_dest / item.name
+        if item.is_dir():
+            shutil.copytree(item, target)
+        else:
+            shutil.copy2(item, target)
+    shutil.copytree(ROOT / "HuobaoDrama", DEST / "HuobaoDrama")
+    shutil.copytree(ROOT / "model-bridge", DEST / "model-bridge", ignore=shutil.ignore_patterns("__pycache__", "*.log"))
+    shutil.copy2(ROOT / "一键启动火宝.cmd", DEST / "一键启动火宝.cmd")
+    profile = Path(os.environ["APPDATA"]) / "HuobaoDrama"
+    for name in ("storage-config.json", "Preferences", "Local State", "workspace"):
+        source = profile / name
+        if not source.exists():
+            continue
+        target = DEST / "profile" / name
+        target.parent.mkdir(parents=True, exist_ok=True)
+        if source.is_dir():
+            shutil.copytree(source, target)
+        else:
+            shutil.copy2(source, target)
+    files = []
+    for file in data_dest.rglob("*"):
+        if file.is_file():
+            files.append({"path": file.relative_to(data_dest).as_posix(), "bytes": file.stat().st_size,
+                          "sha256": hashlib.file_digest(file.open("rb"), "sha256").hexdigest()})
+    manifest = {"path": str(DEST), "counts": counts, "data_files": files}
+    (DEST / "manifest.json").write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
+    (ROOT / "integration-work/current-upgrade-backup.txt").write_text(str(DEST), encoding="utf-8")
+    print("Complete rollback backup:", DEST)
+    print("Data files:", len(files), "model configs:", counts["ai_service_configs"], "projects:", counts["dramas"], "styles:", counts["style_presets"])
+
+
+if __name__ == "__main__":
+    main()
diff --git a/model-bridge/bridge.py b/model-bridge/bridge.py
new file mode 100644
index 0000000..b2c5b64
--- /dev/null
+++ b/model-bridge/bridge.py
@@ -0,0 +1,589 @@
+"""Private adapters for Huobao: Dify, Qwen Image, local H3, and Grok CLI."""
+from __future__ import annotations
+
+import asyncio
+import base64
+from contextlib import closing
+from email import policy
+from email.parser import BytesParser
+import hashlib
+import hmac
+import json
+import math
+import os
+from pathlib import Path
+import re
+import secrets
+import sqlite3
+import struct
+import tempfile
+import time
+from urllib.parse import quote
+
+import httpx
+from fastapi import Depends, FastAPI, Header, HTTPException, Request
+from fastapi.responses import JSONResponse, StreamingResponse
+
+
+def chat_query(body):
+    messages = body.get("messages")
+    if not isinstance(messages, list) or not messages:
+        raise HTTPException(400, "messages must be a non-empty array")
+    if body.get("tool_choice") == "required" or isinstance(body.get("tool_choice"), dict):
+        raise HTTPException(400, "This chatflow does not support required tool calls; use DeepSeek")
+    parts = []
+    for item in messages:
+        content = item.get("content", "")
+        if isinstance(content, list):
+            if any(p.get("type") != "text" for p in content):
+                raise HTTPException(400, "This adapter accepts text messages only")
+            content = "\n".join(p.get("text", "") for p in content)
+        if content:
+            parts.append(f"[{item.get('role', 'user')}]\n{content}")
+    fmt = body.get("response_format") or {}
+    if fmt.get("type") == "json_schema":
+        parts.append("Return only JSON matching this schema:\n" + json.dumps(fmt.get("json_schema", {}).get("schema", {}), ensure_ascii=False))
+    elif fmt.get("type") == "json_object":
+        parts.append("Return only a valid JSON object, without Markdown fences.")
+    if not parts:
+        raise HTTPException(400, "Empty messages")
+    return "\n\n".join(parts)
+
+
+def image_dimensions(data_url):
+    try:
+        data = base64.b64decode(data_url.split(",", 1)[1], validate=True)
+        if data.startswith(b"\x89PNG\r\n\x1a\n"):
+            return struct.unpack(">II", data[16:24])
+        if data.startswith((b"GIF87a", b"GIF89a")):
+            return struct.unpack("<HH", data[6:10])
+        if data[:2] == b"\xff\xd8":
+            offset = 2
+            while offset + 4 < len(data):
+                if data[offset] != 255:
+                    offset += 1
+                    continue
+                while data[offset] == 255:
+                    offset += 1
+                marker = data[offset]
+                offset += 1
+                if marker in {0xD8, 0xD9} or 0xD0 <= marker <= 0xD7:
+                    continue
+                size = int.from_bytes(data[offset:offset + 2], "big")
+                if marker in {0xC0, 0xC1, 0xC2, 0xC3, 0xC5, 0xC6, 0xC7, 0xC9, 0xCA, 0xCB, 0xCD, 0xCE, 0xCF}:
+                    height, width = struct.unpack(">HH", data[offset + 3:offset + 7])
+                    return width, height
+                if size < 2:
+                    break
+                offset += size
+        if data[:4] == b"RIFF" and data[8:12] == b"WEBP":
+            if data[12:16] == b"VP8X":
+                return 1 + int.from_bytes(data[24:27], "little"), 1 + int.from_bytes(data[27:30], "little")
+            if data[12:16] == b"VP8L" and data[20] == 0x2F:
+                bits = int.from_bytes(data[21:25], "little")
+                return (bits & 0x3FFF) + 1, ((bits >> 14) & 0x3FFF) + 1
+            if data[12:16] == b"VP8 " and data[23:26] == b"\x9d\x01\x2a":
+                width, height = struct.unpack("<HH", data[26:30])
+                return width & 0x3FFF, height & 0x3FFF
+    except (ValueError, IndexError, struct.error):
+        pass
+    raise HTTPException(400, "Unable to read first-frame dimensions; use PNG, JPEG or WebP")
+
+
+VIDEO_MODELS = {
+    "MiniMax-H3-VDN-H3": {"reference": "minimax_h3_vdn_hd", "min_images": 1, "max_images": 9},
+    "MiniMax-H3": {"text": "minimax_h3_t2v_official", "first": "minimax_h3_i2v", "reference": "minimax_h3_r2v", "min_images": 0, "max_images": 9},
+    "MiniMax-H3-Hybrid": {"text": "minimax_h3_hybrid_v0331_t2v", "first": "minimax_h3_hybrid_v0331_i2v", "reference": "minimax_h3_hybrid_v0331_i2v", "min_images": 0, "max_images": 9},
+    "MiniMax-H3-R2V-4Step": {"reference": "minimax_h3_r2v_4step", "min_images": 1, "max_images": 9},
+    "LTX-2.3": {"text": "ltx23_t2v", "first": "ltx23_t2v", "reference": "ltx23_t2v", "min_images": 0, "max_images": 1},
+    "LTX-2.3-Text-Preserve": {"text": "ltx23_t2v_text_preserve", "first": "ltx23_t2v_text_preserve", "reference": "ltx23_t2v_text_preserve", "min_images": 0, "max_images": 1},
+    "Wan2.2-I2V": {"first": "wan22_simple", "reference": "wan22_simple", "min_images": 1, "max_images": 1},
+}
+
+
+def video_workflows(spec):
+    return {spec[mode] for mode in ("text", "first", "reference") if mode in spec}
+
+
+def gpu_routing(body):
+    gpu = body.get("gpu", "auto")
+    if gpu not in ("auto", "gpu1", "gpu2", "gpu3"):
+        raise HTTPException(400, "gpu must be auto, gpu1, gpu2 or gpu3")
+    if gpu == "auto":
+        return {"provider_id": "default", "huobao_panels": True}
+    return {"provider_id": {"gpu1": "gpu1_8189", "gpu2": "default", "gpu3": "gpu3"}[gpu], "strict_provider": True, "huobao_panels": True}
+
+
+def worker_routing(provider_id):
+    worker = {"default": ("gpu2", 8188), "gpu1_8189": ("gpu1", 8189), "gpu3": ("gpu3", 8191), "gpu1": ("gpu1", None)}.get(provider_id)
+    if not worker:
+        return None
+    gpu, port = worker
+    return {"gpu": gpu, "port": port, "providerId": provider_id, "legacy": provider_id == "gpu1"}
+
+
+def h3_request(body):
+    """Translate the local video protocol. 'default' means upstream auto-balance."""
+    model = body.get("model", "MiniMax-H3")
+    spec = VIDEO_MODELS.get(model)
+    if spec is None:
+        raise HTTPException(400, "Unknown local video model; query /v1/models")
+    content = body.get("content") or []
+    if not isinstance(content, list):
+        raise HTTPException(400, "content must be an array")
+    prompt = "\n".join(str(c.get("text", "")) for c in content if c.get("type") == "text").strip()
+    if not prompt or len(prompt) > 7000:
+        raise HTTPException(400, "A prompt of 1-7000 characters is required")
+    images, roles = [], []
+    for item in content:
+        kind = item.get("type")
+        if kind == "text":
+            continue
+        if kind != "image_url" or item.get("role") == "last_frame":
+            raise HTTPException(400, "Local video supports first-frame/reference images; last frames, reference video and voice samples are unsupported")
+        raw = item.get("image_url") or {}
+        url = raw.get("url", "") if isinstance(raw, dict) else raw
+        if not isinstance(url, str) or not url.startswith("data:image/"):
+            raise HTTPException(400, "Local video requires inline image data; enable Huobao's local-image conversion")
+        images.append(url)
+        roles.append(item.get("role", "reference_image"))
+    if not spec["min_images"] <= len(images) <= spec["max_images"]:
+        raise HTTPException(400, f"{model} requires {spec['min_images']}-{spec['max_images']} images")
+    if "first_frame" in roles and len(images) != 1:
+        raise HTTPException(400, "Use either one fixed first frame or reference images; these modes cannot be combined")
+    mode = "text" if not images else "first" if roles == ["first_frame"] else "reference"
+    if mode not in spec:
+        raise HTTPException(400, f"{model} does not support {mode} mode; use reference images")
+    try:
+        duration = float(body.get("duration", 5))
+    except (ValueError, TypeError):
+        raise HTTPException(400, "Invalid duration")
+    if not math.isfinite(duration) or not 4 <= duration <= 15:
+        raise HTTPException(400, "Duration must be 4-15 seconds")
+    ratio = body.get("ratio", "16:9")
+    if ratio not in {"16:9", "9:16", "1:1", "4:3", "3:4", "21:9"}:
+        raise HTTPException(400, "Unsupported aspect ratio")
+    resolution = str(body.get("resolution", "768P")).upper()
+    resolutions = {"480P": 480, "720P": 720, "1080P": 1080, "768P": 768, "2K": 1152}
+    if model == "MiniMax-H3-VDN-H3":
+        if ratio not in {"16:9", "9:16"}:
+            raise HTTPException(400, "VDN HD supports 16:9 or 9:16")
+        resolutions = {"2K": 1440, "4K": 2160}
+    if resolution not in resolutions:
+        raise HTTPException(400, "Unsupported video resolution")
+    short = resolutions[resolution]
+    a, b = map(int, ratio.split(":"))
+    if roles == ["first_frame"] and "ratio" not in body:
+        a, b = image_dimensions(images[0])
+        if a <= 0 or b <= 0:
+            raise HTTPException(400, "Invalid first-frame dimensions")
+    width = round(short * max(1, a / b) / 64) * 64
+    height = round(short * max(1, b / a) / 64) * 64
+    if model == "MiniMax-H3-VDN-H3":
+        width, height = (short * 16 // 9, short) if a > b else (short, short * 16 // 9)
+    workflow = spec[mode]
+    request = {**gpu_routing(body), "workflow_key": workflow, "prompt": prompt,
+            "input_images": images, "duration": duration, "width": width, "height": height,
+            "metadata": {"source": "huobao-drama", "model": model}}
+    if body.get("seed") is not None:
+        if not isinstance(body["seed"], int) or not 0 <= body["seed"] < 2**63:
+            raise HTTPException(400, "Invalid seed")
+        request["seed"] = body["seed"]
+    return request
+
+
+def qwen_image_request(body, images=None):
+    if body.get("model") != "qwen_image_2_1":
+        raise HTTPException(400, "Use model qwen_image_2_1")
+    prompt = body.get("prompt")
+    if not isinstance(prompt, str) or not prompt.strip() or len(prompt) > 32000:
+        raise HTTPException(400, "A prompt of 1-32000 characters is required")
+    if str(body.get("n", 1)) != "1":
+        raise HTTPException(400, "This image adapter supports n=1 per task")
+    if body.get("response_format", "url") != "url":
+        raise HTTPException(400, "Asynchronous image tasks require response_format=url")
+    size = str(body.get("size", "1024x1024")).lower()
+    if size == "auto":
+        size = "1024x1024"
+    match = re.fullmatch(r"(\d{3,4})x(\d{3,4})", size)
+    if not match or not all(256 <= int(d) <= 4096 for d in match.groups()):
+        raise HTTPException(400, "size must be WIDTHxHEIGHT with dimensions 256-4096")
+    width, height = map(int, match.groups())
+    refs = images or []
+    if len(refs) > 6:
+        raise HTTPException(400, "Qwen Image 2.1 supports at most 6 reference images")
+    return {**gpu_routing(body), "workflow_key": "qwen_image_2_1", "prompt": prompt.strip(),
+            "width": width, "height": height, "batch_size": 1, "input_images": refs,
+            "metadata": {"source": "huobao-drama", "output_type": "image"}}
+
+
+async def parse_image_edit(request):
+    content_type = request.headers.get("content-type", "")
+    if not content_type.lower().startswith("multipart/form-data;"):
+        raise HTTPException(415, "Image edits require multipart/form-data")
+    raw = bytearray()
+    async for chunk in request.stream():
+        raw.extend(chunk)
+        if len(raw) > 64 * 1024 * 1024:
+            raise HTTPException(413, "Reference uploads exceed 64 MiB")
+    message = BytesParser(policy=policy.default).parsebytes(
+        ("Content-Type: " + content_type + "\r\nMIME-Version: 1.0\r\n\r\n").encode() + raw)
+    if not message.is_multipart() or message.defects:
+        raise HTTPException(400, "Invalid multipart image request")
+    fields, images = {}, []
+    for part in message.iter_parts():
+        name = part.get_param("name", header="content-disposition")
+        data = part.get_payload(decode=True)
+        if not isinstance(data, bytes):
+            raise HTTPException(400, "Invalid multipart field")
+        if name in {"image", "image[]"}:
+            mime = part.get_content_type()
+            if mime not in {"image/png", "image/jpeg", "image/webp"} or not data or len(data) > 10 * 1024 * 1024:
+                raise HTTPException(400, "Each reference must be PNG, JPEG or WebP, up to 10 MiB")
+            url = "data:" + mime + ";base64," + base64.b64encode(data).decode()
+            width, height = image_dimensions(url)
+            if not (0 < width <= 16384 and 0 < height <= 16384):
+                raise HTTPException(400, "Invalid reference image dimensions")
+            images.append(url)
+            if len(images) > 6:
+                raise HTTPException(400, "Qwen Image 2.1 supports at most 6 reference images")
+        elif name in {"model", "prompt", "size", "n", "response_format", "gpu"}:
+            if name in fields or len(data) > 128000:
+                raise HTTPException(400, "Duplicate or oversized form field")
+            try:
+                fields[name] = data.decode("utf-8")
+            except UnicodeDecodeError:
+                raise HTTPException(400, "Form text must be UTF-8")
+        else:
+            raise HTTPException(400, "Unsupported image edit field: " + str(name)[:60])
+    if not images:
+        raise HTTPException(400, "At least one reference image is required")
+    return qwen_image_request(fields, images)
+
+
+def create_app(config):
+    app = FastAPI(title="Huobao private model bridge", docs_url=None, redoc_url=None)
+    state_dir = Path(config.get("state_dir", "./state"))
+    state_dir.mkdir(parents=True, exist_ok=True)
+    db_path = state_dir / "jobs.sqlite3"
+    with closing(sqlite3.connect(db_path)) as db, db:
+        db.execute("CREATE TABLE IF NOT EXISTS jobs (id TEXT PRIMARY KEY, duration REAL NOT NULL, created REAL NOT NULL)")
+        db.execute("CREATE TABLE IF NOT EXISTS image_jobs (id TEXT PRIMARY KEY, created REAL NOT NULL)")
+
+    def auth(authorization: str | None = Header(default=None)):
+        expected = config.get("token", "")
+        if not expected or not secrets.compare_digest(authorization or "", "Bearer " + expected):
+            raise HTTPException(401, "Invalid bridge token")
+
+    @app.exception_handler(HTTPException)
+    async def http_error(request, exc):
+        return JSONResponse({"error": {"message": str(exc.detail), "type": "bridge_error", "code": exc.status_code}}, status_code=exc.status_code)
+
+    @app.exception_handler(httpx.HTTPError)
+    async def upstream_error(request, exc):
+        return JSONResponse({"error": {"message": "Upstream connection failed: " + type(exc).__name__, "type": "upstream_error"}}, status_code=502)
+
+    def upstream_headers():
+        return {"Authorization": "Bearer " + config["h3"]["token"]}
+
+    async def upstream(method, path, body=None):
+        if not config.get("h3"):
+            raise HTTPException(404, "H3 is not configured on this bridge")
+        async with httpx.AsyncClient(timeout=httpx.Timeout(180, connect=10), trust_env=False) as client:
+            r = await client.request(method, config["h3"]["url"] + path, headers=upstream_headers(), json=body)
+        if r.is_error:
+            try:
+                detail = r.json().get("detail", "Model service request failed")
+            except ValueError:
+                detail = "Model service request failed"
+            raise HTTPException(r.status_code, str(detail)[:600])
+        return r.json()
+
+    @app.get("/health")
+    async def health():
+        return {"status": "ok", "service": "huobao-model-bridge"}
+
+    @app.get("/v1/models", dependencies=[Depends(auth)])
+    async def models():
+        names = list(config.get("dify", {}))
+        if config.get("h3"):
+            # Verify the real service, instead of making a local catalogue look healthy.
+            registry = await upstream("GET", "/v1/models")
+            available = {m["id"] for m in registry.get("data", [])}
+            names.extend(name for name, spec in VIDEO_MODELS.items() if video_workflows(spec) <= available)
+            if any(m.get("id") == "qwen_image_2_1" and m.get("model_type") == "image" for m in registry.get("data", [])):
+                names.append("qwen_image_2_1")
+        if config.get("grok"):
+            names.append("grok-local")
+        return {"object": "list", "data": [{"id": n, "object": "model", "owned_by": "private"} for n in names]}
+
+    async def dify_events(model, query):
+        upstream_config = config["dify"][model]
+        payload = {"inputs": {}, "query": query, "response_mode": "streaming",
+                   "user": "huobao-" + secrets.token_hex(8), "auto_generate_name": False}
+        finished, usage = False, {}
+        async with httpx.AsyncClient(timeout=httpx.Timeout(240, connect=10), trust_env=False) as client:
+            async with client.stream("POST", upstream_config["url"] + "/chat-messages",
+                                     headers={"Authorization": "Bearer " + upstream_config["key"]}, json=payload) as response:
+                if response.is_error:
+                    await response.aread()
+                    try:
+                        message = response.json().get("message", "Dify request failed")
+                    except ValueError:
+                        message = "Dify request failed"
+                    raise HTTPException(response.status_code, str(message)[:400])
+                async for line in response.aiter_lines():
+                    if not line.startswith("data:"):
+                        continue
+                    event = json.loads(line[5:].strip())
+                    kind = event.get("event")
+                    if kind in {"message", "agent_message"}:
+                        yield "text", event.get("answer", "")
+                    elif kind == "error":
+                        raise HTTPException(502, str(event.get("message", "Dify generation failed"))[:400])
+                    elif kind == "message_end":
+                        finished = True
+                        usage = event.get("metadata", {}).get("usage", {})
+                    elif kind == "workflow_finished":
+                        data = event.get("data") or {}
+                        if data.get("status") not in {None, "succeeded"}:
+                            raise HTTPException(502, str(data.get("error") or "Dify workflow failed")[:400])
+                if not finished:
+                    raise HTTPException(502, "Dify stream ended before message_end")
+        yield "usage", usage
+
+    async def grok_events(query):
+        item = config["grok"]
+        args = [item["exe"], "--cwd", item["cwd"], "--output-format", "json", "--verbatim",
+                "--no-subagents", "--no-memory", "--disable-web-search", "--max-turns", "1",
+                "--tools", "", "--deny", "MCPTool", "--permission-mode", "dontAsk",
+                "--system-prompt-override", "Answer the supplied writing request using text only. Do not use tools."]
+        options = {"creationflags": 0x08000000} if os.name == "nt" else {}
+        # A file avoids the Windows command-line length limit for full scripts.
+        with tempfile.TemporaryDirectory(prefix="huobao-grok-") as scratch:
+            prompt_file = Path(scratch) / "prompt.txt"
+            prompt_file.write_text(query, encoding="utf-8")
+            args += ["--prompt-file", str(prompt_file)]
+            process = await asyncio.create_subprocess_exec(*args, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.PIPE, **options)
+            try:
+                out, err = await asyncio.wait_for(process.communicate(), timeout=240)
+            except (asyncio.TimeoutError, asyncio.CancelledError):
+                process.kill()
+                await process.wait()
+                raise
+        try:
+            data = json.loads(out.decode("utf-8"))
+        except (ValueError, UnicodeDecodeError):
+            raise HTTPException(502, "Grok CLI did not return JSON; run Grok login on this computer")
+        if process.returncode or not data.get("text"):
+            raise HTTPException(502, "Grok CLI failed; check local login and available quota")
+        yield "text", data["text"]
+        yield "usage", data.get("usage", {})
+
+    @app.post("/v1/chat/completions", dependencies=[Depends(auth)])
+    async def chat(body: dict):
+        model = body.get("model", "")
+        if model not in config.get("dify", {}) and not (model == "grok-local" and config.get("grok")):
+            raise HTTPException(404, "Unknown text model")
+        query = chat_query(body)
+        events = grok_events(query) if model == "grok-local" else dify_events(model, query)
+        cid, created = "chatcmpl-" + secrets.token_hex(12), int(time.time())
+
+        def chunk(delta, finish=None):
+            return {"id": cid, "object": "chat.completion.chunk", "created": created, "model": model,
+                    "choices": [{"index": 0, "delta": delta, "finish_reason": finish}]}
+
+        if body.get("stream"):
+            async def stream():
+                def encode(value):
+                    return "data: " + json.dumps(value, ensure_ascii=False) + "\n\n"
+                yield encode(chunk({"role": "assistant", "content": ""}))
+                try:
+                    async for kind, value in events:
+                        if kind == "text":
+                            yield encode(chunk({"content": value}))
+                    yield encode(chunk({}, "stop"))
+                except (HTTPException, httpx.HTTPError) as error:
+                    message = str(error.detail) if isinstance(error, HTTPException) else "Upstream connection failed"
+                    yield encode({"error": {"message": message, "type": "upstream_error"}})
+                yield "data: [DONE]\n\n"
+            return StreamingResponse(stream(), media_type="text/event-stream", headers={"Cache-Control": "no-cache"})
+        text, usage = "", {}
+        async for kind, value in events:
+            if kind == "text":
+                text += value
+            else:
+                usage = value
+        return {"id": cid, "object": "chat.completion", "created": created, "model": model,
+                "choices": [{"index": 0, "message": {"role": "assistant", "content": text}, "finish_reason": "stop"}],
+                "usage": {"prompt_tokens": usage.get("prompt_tokens", usage.get("input_tokens", 0)),
+                          "completion_tokens": usage.get("completion_tokens", usage.get("output_tokens", 0)),
+                          "total_tokens": usage.get("total_tokens", 0)}}
+
+    async def require_qwen_image():
+        registry = await upstream("GET", "/v1/models")
+        if not any(m.get("id") == "qwen_image_2_1" and m.get("model_type") == "image" for m in registry.get("data", [])):
+            raise HTTPException(503, "Qwen Image 2.1 workflow is unavailable")
+
+    @app.get("/v1/images/pool", dependencies=[Depends(auth)])
+    async def image_pool():
+        await require_qwen_image()
+        health, catalogue = await asyncio.gather(upstream("GET", "/health"), upstream("GET", "/v1/providers"))
+        return {"model": "qwen_image_2_1", "auto_balance": health.get("autoBalance") is True,
+                "routing": "shortest-queue-with-reservations" if health.get("autoBalance") is True else "single-provider",
+                "configured_workers": [{"id": p["id"], "name": p.get("name", p["id"])} for p in catalogue.get("providers", [])]}
+
+    async def submit_image(payload):
+        await require_qwen_image()
+        result = await upstream("POST", "/v1/jobs", payload)
+        jid = result.get("id")
+        if not isinstance(jid, str) or not jid:
+            raise HTTPException(502, "Image service did not return a task ID")
+        with closing(sqlite3.connect(db_path)) as db, db:
+            db.execute("INSERT INTO image_jobs VALUES(?,?)", (jid, time.time()))
+        return {"task_id": jid, "status": "processing", "provider_id": result.get("providerId")}
+
+    @app.post("/v1/images/validate", dependencies=[Depends(auth)])
+    async def validate_image(body: dict):
+        payload = qwen_image_request(body)
+        await require_qwen_image()
+        return {"valid": True, "workflow": payload["workflow_key"], "requested_size": [payload["width"], payload["height"]], "max_reference_images": 6,
+                "pool": await image_pool()}
+
+    @app.post("/v1/images/generations", dependencies=[Depends(auth)])
+    async def generate_image(body: dict):
+        return await submit_image(qwen_image_request(body))
+
+    @app.post("/v1/images/edits", dependencies=[Depends(auth)])
+    async def edit_image(request: Request):
+        return await submit_image(await parse_image_edit(request))
+
+    @app.get("/v1/images/task/{jid}", dependencies=[Depends(auth)])
+    async def poll_image(jid: str):
+        with closing(sqlite3.connect(db_path)) as db:
+            found = db.execute("SELECT 1 FROM image_jobs WHERE id=?", (jid,)).fetchone()
+        if not found:
+            raise HTTPException(404, "Unknown image task")
+        result = await upstream("GET", "/v1/huobao/jobs/" + quote(jid, safe=""))
+        state = result.get("status", "running")
+        if state in {"failed", "cancelled"}:
+            return {"status": "failed", "error": {"message": str(result.get("error") or "Image generation failed")[:600]}}
+        if state != "succeeded":
+            return {"status": "processing", "provider_id": result.get("providerId"), "worker_state": result.get("worker_state"), "queue_position": result.get("queue_position")}
+        output = next((o for o in result.get("outputs", []) if o.get("kind") == "image"), None)
+        if output is None:
+            return {"status": "failed", "error": {"message": "Task completed without an image output"}}
+        index, expiry = int(output["index"]), int(time.time()) + 86400
+        extension = {"image/png": "png", "image/jpeg": "jpg", "image/webp": "webp"}.get(output.get("mimeType"), "png")
+        # Huobao determines the saved extension from the URL, not Content-Type.
+        url = f"{config['public_url']}/media/{quote(jid, safe='')}/{index}/image.{extension}?expires={expiry}&sig={signature(jid, index, expiry)}"
+        return {"status": "completed", "image_url": url, "data": [{"url": url}], "provider_id": result.get("providerId")}
+
+    @app.post("/v2/video_generation/validate", dependencies=[Depends(auth)])
+    async def validate_video(body: dict):
+        request = h3_request(body)
+        registry = await upstream("GET", "/v1/models")
+        if request["workflow_key"] not in {m["id"] for m in registry.get("data", [])}:
+            raise HTTPException(503, "Selected video workflow is unavailable")
+        plan = await upstream("POST", "/v1/audio-plan", request)
+        route = await upstream("POST", "/v1/huobao/route", request)
+        return {"valid": plan.get("status", "ready") == "ready", "workflow": request["workflow_key"],
+                "width": request["width"], "height": request["height"], "duration": request["duration"], "audio_plan": plan,
+                "routing": worker_routing(route.get("providerId"))}
+
+    @app.post("/v2/video_generation", dependencies=[Depends(auth)])
+    async def video(body: dict):
+        # Huobao probes video providers with an empty body. Check the real
+        # upstream without submitting a GPU task, then report readiness.
+        if not body:
+            registry = await upstream("GET", "/v1/models")
+            available = {m["id"] for m in registry.get("data", [])}
+            if not {"minimax_h3_t2v_official", "minimax_h3_i2v", "minimax_h3_r2v"} <= available:
+                raise HTTPException(503, "Required H3 workflows are unavailable")
+            return {"status": "ready", "probe": True, "model": "MiniMax-H3"}
+        request = h3_request(body)
+        registry = await upstream("GET", "/v1/models")
+        if request["workflow_key"] not in {m["id"] for m in registry.get("data", [])}:
+            raise HTTPException(503, "Selected video workflow is unavailable")
+        result = await upstream("POST", "/v1/jobs", request)
+        jid = result.get("id")
+        if not isinstance(jid, str) or not jid:
+            raise HTTPException(502, "Video service did not return a job ID")
+        with closing(sqlite3.connect(db_path)) as db, db:
+            db.execute("INSERT INTO jobs VALUES(?,?,?)", (jid, request["duration"], time.time()))
+        return {"task_id": jid, "status": "submitted", "provider_id": result.get("providerId"), "routing": worker_routing(result.get("providerId"))}
+
+    def get_job(jid):
+        with closing(sqlite3.connect(db_path)) as db:
+            row = db.execute("SELECT duration FROM jobs WHERE id=?", (jid,)).fetchone()
+        if not row:
+            raise HTTPException(404, "Unknown bridge job")
+        return row[0]
+
+    def signature(jid, index, expiry):
+        data = f"{jid}:{index}:{expiry}".encode()
+        return hmac.new(config["token"].encode(), data, hashlib.sha256).hexdigest()
+
+    @app.post("/v2/video_generation/{jid}/cancel", dependencies=[Depends(auth)])
+    async def cancel_video(jid: str):
+        # Only a video submitted through this authenticated bridge may be cancelled.
+        get_job(jid)
+        result = await upstream("POST", "/v1/jobs/" + quote(jid, safe="") + "/cancel", {})
+        return {"task": {"id": jid, "status": result.get("status", "running"),
+                         "cancelRequested": result.get("cancelRequested", False)}}
+
+    @app.get("/v2/query/video_generation/{jid}", dependencies=[Depends(auth)])
+    async def poll(jid: str):
+        duration = get_job(jid)
+        result = await upstream("GET", "/v1/huobao/jobs/" + quote(jid, safe=""))
+        state = result.get("status", "running")
+        task = {"id": jid, "status": state, "duration": duration, "provider_id": result.get("providerId"), "routing": worker_routing(result.get("providerId")), "worker_state": result.get("worker_state"), "queue_position": result.get("queue_position")}
+        if state == "succeeded":
+            output = next((o for o in result.get("outputs", []) if o.get("kind") == "video"), None)
+            if not output:
+                task.update(status="failed", error="Video task completed without a video output")
+            else:
+                index, expiry = int(output["index"]), int(time.time()) + 86400
+                url = f"{config['public_url']}/media/{quote(jid, safe='')}/{index}/video.mp4?expires={expiry}&sig={signature(jid, index, expiry)}"
+                task["content"] = {"url": url}
+        elif state in {"failed", "cancelled"}:
+            task["error"] = str(result.get("error") or "Video task failed")[:600]
+        return {"task": task}
+
+    @app.get("/media/{jid}/{index}")
+    @app.get("/media/{jid}/{index}/{filename}")
+    async def media(jid: str, index: int, expires: int, sig: str, filename: str | None = None):
+        if filename is not None and not re.fullmatch(r"image\.(png|jpg|webp)|video\.mp4", filename):
+            raise HTTPException(404, "Unknown media filename")
+        with closing(sqlite3.connect(db_path)) as db:
+            found = db.execute("SELECT 1 FROM jobs WHERE id=? UNION ALL SELECT 1 FROM image_jobs WHERE id=?", (jid, jid)).fetchone()
+        if not found:
+            raise HTTPException(404, "Unknown bridge task")
+        if expires < time.time() or not hmac.compare_digest(sig, signature(jid, index, expires)):
+            raise HTTPException(403, "Invalid or expired media link; poll the task again")
+        client = httpx.AsyncClient(timeout=httpx.Timeout(180, connect=10), trust_env=False)
+        url = config["h3"]["url"] + f"/v1/jobs/{quote(jid, safe='')}/outputs/{index}"
+        try:
+            response = await client.send(client.build_request("GET", url, headers=upstream_headers()), stream=True)
+            if response.is_error:
+                await response.aclose()
+                await client.aclose()
+                raise HTTPException(response.status_code, "Model output is not available")
+        except BaseException:
+            await client.aclose()
+            raise
+        async def download():
+            try:
+                async for part in response.aiter_bytes():
+                    yield part
+            finally:
+                await response.aclose()
+                await client.aclose()
+        return StreamingResponse(download(), media_type=response.headers.get("content-type", "video/mp4"))
+
+    return app
+
+
+def create_from_file():
+    path = Path(os.environ.get("HUOBAO_BRIDGE_CONFIG", "/bridge/config.json"))
+    return create_app(json.loads(path.read_text(encoding="utf-8")))
diff --git a/model-bridge/build_upgrade.py b/model-bridge/build_upgrade.py
new file mode 100644
index 0000000..0fb0eff
--- /dev/null
+++ b/model-bridge/build_upgrade.py
@@ -0,0 +1,34 @@
+"""Package locally built additions into the verified official 4.0.11 runtime."""
+from pathlib import Path
+import json,struct,hashlib,shutil
+root=Path(__file__).resolve().parent.parent
+stage=root/'integration-work/stage-4.0.11/app'
+archive=stage/'resources/app.asar'
+baseline=archive.with_name('app.official-4.0.11.asar')
+if not baseline.exists(): shutil.copy2(archive,baseline)
+raw=baseline.read_bytes()
+_,header_size,_,json_size=struct.unpack('<4I',raw[:16])
+header=json.loads(raw[16:16+json_size]); data=raw[8+header_size:]
+replacements={'build/backend.mjs':root/'huobao-source/desktop/build/backend.mjs',
+              'dist/main.js':root/'huobao-source/desktop/dist/main.js',
+              'dist/preload.js':root/'huobao-source/desktop/dist/preload.js'}
+for target,source in replacements.items():
+    node=header
+    for part in target.split('/'): node=node['files'][part]
+    content=source.read_bytes()
+    node['size']=len(content); node['offset']=str(len(data))
+    block_size=4194304
+    node['integrity']={'algorithm':'SHA256','hash':hashlib.sha256(content).hexdigest(),'blockSize':block_size,
+                       'blocks':[hashlib.sha256(content[i:i+block_size]).hexdigest() for i in range(0,len(content),block_size)]}
+    data+=content
+encoded=json.dumps(header,separators=(',',':')).encode()
+padding=b'\0'*((-len(encoded))%4)
+size=8+len(encoded)+len(padding)
+archive.write_bytes(struct.pack('<4I',4,size,size-4,len(encoded))+encoded+padding+data)
+frontend=root/'huobao-source/frontend/.output/public'
+shutil.copytree(frontend,stage/'resources/frontend',dirs_exist_ok=True)
+manifest={'upstream_version':'4.0.11','source_commit':'b48e6b2312166e25b1ff141832d2e82e5d63c142',
+          'custom_features':['persistent-data','local-video-pool','multi-gpu-images','vdn-hd-versions','per-model-gpu-selection','fixed-gpu-models','cancel-and-regenerate','per-shot-routing','direct-comfy-panels','confirmed-worker-labels','asset-image-references','durable-local-task-tracking'],
+          'archive_sha256':hashlib.sha256(archive.read_bytes()).hexdigest()}
+(stage/'resources/huobao-local-build.json').write_text(json.dumps(manifest,indent=2))
+print('Staged 4.0.11 with persistent data and VDN HD:',manifest['archive_sha256'])
diff --git a/model-bridge/finalize_gpu_labels.py b/model-bridge/finalize_gpu_labels.py
new file mode 100644
index 0000000..f18c112
--- /dev/null
+++ b/model-bridge/finalize_gpu_labels.py
@@ -0,0 +1,17 @@
+import json,urllib.request
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+base=json.loads((root/'huobao-data/last-launch.json').read_text())['api']
+def req(path,body=None):
+ r=urllib.request.Request(base+path,data=json.dumps(body).encode() if body else None,headers={'Content-Type':'application/json'},method='PUT' if body else 'GET')
+ with urllib.request.urlopen(r,timeout=30) as response:return json.load(response)['data']
+before=req('/ai-configs');changes=[]
+for row in before:
+ if '双卡自动调度' in row['name']:
+  req('/ai-configs/'+str(row['id']),{'name':row['name'].replace('双卡自动调度','三卡可选')});changes.append(row['id'])
+after={row['id']:row for row in req('/ai-configs')}
+keys=('base_url','api_key','model','provider','priority','is_active','settings')
+assert all(all(row[k]==after[row['id']][k] for k in keys) for row in before)
+report={'updated_labels':changes,'credentials_models_priorities_and_gpu_preferences_unchanged':True,'configs':len(after)}
+(root/'integration-work/final-gpu-config-audit.json').write_text(json.dumps(report,indent=2),encoding='utf-8')
+print(json.dumps(report))
diff --git a/model-bridge/gpu_selection_smoke.py b/model-bridge/gpu_selection_smoke.py
new file mode 100644
index 0000000..f06e4cc
--- /dev/null
+++ b/model-bridge/gpu_selection_smoke.py
@@ -0,0 +1,50 @@
+"""Small explicitly pinned validation jobs, isolated from production projects."""
+import base64,json,sys,urllib.request,urllib.error,struct,subprocess
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+cfg=json.loads((root/'model-bridge/client.json').read_text())
+file=root/'integration-work/gpu-selection-smoke.json'
+data=json.loads(file.read_text()) if file.exists() else {'images':{},'hd':{}}
+def save():file.write_text(json.dumps(data,indent=2),encoding='utf-8')
+def request(base,path,body=None):
+ req=urllib.request.Request(base+path,data=json.dumps(body).encode() if body is not None else None,headers={'Content-Type':'application/json','Authorization':'Bearer '+cfg['token']})
+ try:
+  with urllib.request.urlopen(req,timeout=90) as r:return json.load(r)
+ except urllib.error.HTTPError as e:raise RuntimeError(e.read().decode())
+base=cfg['url'].rstrip('/');hd='http://192.168.110.111:18794'
+if '--submit-images' in sys.argv:
+ for gpu in ('gpu1','gpu2','gpu3'):
+  if gpu in data['images']:continue
+  r=request(base,'/v1/images/generations',{'model':'qwen_image_2_1','prompt':'A photorealistic blue ceramic teacup on a wooden table, soft daylight, no text.','size':'512x512','gpu':gpu})
+  expected='default' if gpu=='gpu2' else gpu
+  data['images'][gpu]={'id':r['task_id'],'provider':r.get('provider_id'),'status':'processing'};save()
+  assert r['provider_id']==expected,r
+  print('Pinned image accepted:',gpu,r['provider_id'])
+if '--submit-hd' in sys.argv:
+ ref='data:image/jpeg;base64,'+base64.b64encode((root/'integration-work/hd-test/static/videos/task-86_poster.jpg').read_bytes()).decode()
+ for gpu in ('gpu1','gpu3'):
+  if gpu in data['hd']:continue
+  r=request(hd,'/v2/video_generation',{'model':'MiniMax-H3-VDN-H3','gpu':gpu,'resolution':'2K','ratio':'16:9','duration':4,'content':[{'type':'text','text':'A cinematic live-action mountain lake at sunrise, drifting mist, slow camera movement, no text, no dialogue.'},{'type':'image_url','role':'reference_image','image_url':{'url':ref}}]})
+  data['hd'][gpu]={'id':r['task_id'],'provider':r.get('provider_id'),'status':'processing'};save()
+  assert r['provider_id']==gpu,r
+  print('Pinned 2K accepted:',gpu,r['provider_id'])
+if '--poll' in sys.argv:
+ for group,rows in data.items():
+  for gpu,item in rows.items():
+   if item['status']=='completed':continue
+   if group=='images':
+    r=request(base,'/v1/images/task/'+item['id']);status=r['status'];url=r.get('image_url')
+   else:
+    r=request(hd,'/v2/query/video_generation/'+item['id'])['task'];status={'succeeded':'completed'}.get(r['status'],r['status']);url=(r.get('content') or {}).get('url')
+   item['status']=status
+   if status=='completed' and url:
+    target=root/'integration-work'/('pinned-'+group+'-'+gpu+('.png' if group=='images' else '.mp4'))
+    with urllib.request.urlopen(url,timeout=90) as response:target.write_bytes(response.read())
+    if group=='images':
+     content=target.read_bytes();assert content.startswith(b'\x89PNG\r\n\x1a\n');dims=list(struct.unpack('>II',content[16:24]));assert dims==[512,512]
+    else:
+     info=json.loads(subprocess.check_output([str(root/'HuobaoDrama/resources/bin/ffprobe.exe'),'-v','error','-show_streams','-of','json',str(target)],creationflags=0x08000000));v=next(s for s in info['streams'] if s['codec_type']=='video');dims=[v['width'],v['height']];assert dims==[2560,1440]
+    item.update(file=str(target),dimensions=dims)
+   if r.get('error'):item['error']=r['error']
+   save()
+ print(json.dumps(data,ensure_ascii=False))
diff --git a/model-bridge/image_pool_smoke.py b/model-bridge/image_pool_smoke.py
new file mode 100644
index 0000000..85cd120
--- /dev/null
+++ b/model-bridge/image_pool_smoke.py
@@ -0,0 +1,37 @@
+import base64,json,sqlite3,struct,sys,urllib.request
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+cfg=json.loads((root/'model-bridge/client.json').read_text())
+base=cfg['url'].rstrip('/')
+def request(path,body=None):
+    req=urllib.request.Request(base+path,data=json.dumps(body).encode() if body else None,headers={'Content-Type':'application/json','Authorization':'Bearer '+cfg['token']})
+    with urllib.request.urlopen(req,timeout=90) as response:return json.load(response)
+report=root/'integration-work/image-pool-smoke.json'
+if '--submit' in sys.argv:
+    if report.exists():raise RuntimeError('Smoke test already submitted; poll the existing job')
+    pool=request('/v1/images/pool')
+    assert pool['auto_balance'] and len(pool['configured_workers'])>=2,pool
+    result=request('/v1/images/generations',{'model':'qwen_image_2_1','prompt':'A photorealistic ceramic teacup on a simple wooden table, soft window light, no text, no watermark.','size':'512x512','n':1,'response_format':'url'})
+    data={'pool':pool,'task_id':result['task_id'],'assigned_worker':result.get('provider_id')}
+    report.write_text(json.dumps(data,indent=2))
+else:
+    data=json.loads(report.read_text())
+    result=request('/v1/images/task/'+data['task_id'])
+    data.update(status=result['status'],worker=result.get('provider_id'))
+    if result['status']=='completed':
+        with urllib.request.urlopen(result['image_url'],timeout=60) as response:content=response.read()
+        target=root/'integration-work/image-pool-smoke.png';target.write_bytes(content)
+        assert content.startswith(b'\x89PNG\r\n\x1a\n')
+        data['dimensions']=list(struct.unpack('>II',content[16:24])); data['file']=str(target)
+    if result.get('error'):data['error']=result['error']
+    report.write_text(json.dumps(data,indent=2))
+print(json.dumps(data))
+with sqlite3.connect((root/'huobao-data/huobao.sqlite3').as_uri()+'?mode=ro',uri=True) as db:
+    rows=db.execute("SELECT id,task_id,status FROM sys_task WHERE type='image' AND model='qwen_image_2_1' AND status='completed'").fetchall()
+providers={}
+for tid,jid,status in rows:
+    try:
+        worker=base64.urlsafe_b64decode(jid+'='*(-len(jid)%4)).decode().split(':',1)[0]
+        providers[worker]=providers.get(worker,0)+1
+    except (ValueError,TypeError):pass
+print('Previously completed Qwen images by worker:',providers)
diff --git a/model-bridge/label_gpu_ports.py b/model-bridge/label_gpu_ports.py
new file mode 100644
index 0000000..788607a
--- /dev/null
+++ b/model-bridge/label_gpu_ports.py
@@ -0,0 +1,27 @@
+"""Label the verified ComfyUI worker ports; change no routing settings."""
+import datetime,json,re,sqlite3,urllib.request
+from pathlib import Path
+from urllib.parse import urlsplit
+root=Path(__file__).resolve().parent.parent
+base=json.loads((root/'huobao-data/last-launch.json').read_text())['api']
+def api(path,body=None):
+ req=urllib.request.Request(base+path,data=json.dumps(body).encode() if body is not None else None,
+     headers={'Content-Type':'application/json'},method='PUT' if body is not None else 'GET')
+ with urllib.request.urlopen(req,timeout=15) as r:return json.load(r).get('data')
+rows=api('/ai-configs')
+targets=[r for r in rows if r['service_type'] in ('image','video') and urlsplit(r['base_url']).hostname=='192.168.110.111']
+assert len(targets)==24
+backup=root/'huobao-data/backups'/('before-comfy-port-labels-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S')+'.sqlite3')
+with sqlite3.connect(root/'huobao-data/huobao.sqlite3') as src,sqlite3.connect(backup) as dst:src.backup(dst)
+for row in targets:
+ port=urlsplit(row['base_url']).port
+ assert port in (18792,18794)
+ gpu=row.get('gpu','auto')
+ label='ComfyUI '+({'gpu1':'8189','gpu2':'8188','gpu3':'8191'}.get(gpu,'8188/8189/8191'))
+ name=re.sub(r' · (?:端口 \d+|ComfyUI [\d/]+(?:（[^）]*）)?)$','',row['name'])+' · '+label
+ if name!=row['name']:api('/ai-configs/'+str(row['id']),{'name':name})
+after={r['id']:r for r in api('/ai-configs')}
+for row in rows:
+ assert all(after[row['id']][k]==v for k,v in row.items() if k not in ('name','updated_at'))
+ if row not in targets:assert after[row['id']]['name']==row['name']
+print(json.dumps({'labelled':len(targets),'comfyui_ports':{'gpu1':8189,'gpu2':8188,'gpu3':8191},'other_fields_unchanged':True,'backup':str(backup)}))
diff --git a/model-bridge/label_image_pool.py b/model-bridge/label_image_pool.py
new file mode 100644
index 0000000..1e2e564
--- /dev/null
+++ b/model-bridge/label_image_pool.py
@@ -0,0 +1,15 @@
+import hashlib,json,urllib.request
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+base=json.loads((root/'huobao-data/last-launch.json').read_text())['api']
+def request(path,body=None,method=None):
+    req=urllib.request.Request(base+path,data=json.dumps(body).encode() if body else None,headers={'Content-Type':'application/json'},method=method)
+    with urllib.request.urlopen(req,timeout=20) as response:return json.load(response)['data']
+configs=request('/ai-configs')
+row=next(c for c in configs if c['id']==6 and 'qwen_image_2_1' in c['model'])
+protected={k:row.get(k) for k in ('base_url','api_key','model','provider','priority','is_active')}
+request('/ai-configs/6',{'name':'Qwen Image 2.1（默认图片·双卡自动调度）'},'PUT')
+after=next(c for c in request('/ai-configs') if c['id']==6)
+assert protected=={k:after.get(k) for k in protected}
+(root/'integration-work/image-config-verification.json').write_text(json.dumps({'config_id':6,'protected_fields_unchanged':True,'name':after['name']},ensure_ascii=False,indent=2))
+print('Image config 6 now labels dual-GPU auto scheduling; credentials, model and priority unchanged')
diff --git a/model-bridge/launch_local.py b/model-bridge/launch_local.py
new file mode 100644
index 0000000..33a0a96
--- /dev/null
+++ b/model-bridge/launch_local.py
@@ -0,0 +1,17 @@
+"""Start the optional, loopback-only Grok adapter without a console window."""
+import json
+import logging
+from pathlib import Path
+
+import uvicorn
+
+from bridge import create_app
+
+
+if __name__ == "__main__":
+    root = Path(__file__).resolve().parent
+    logging.basicConfig(filename=root / "grok-bridge.log", level=logging.WARNING,
+                        format="%(asctime)s %(levelname)s %(message)s")
+    config = json.loads((root / "grok-client.json").read_text(encoding="utf-8"))
+    uvicorn.run(create_app(config), host="127.0.0.1", port=18793, access_log=False,
+                log_config=None, log_level="warning")
diff --git a/model-bridge/patch_desktop_video.py b/model-bridge/patch_desktop_video.py
new file mode 100644
index 0000000..7995f30
--- /dev/null
+++ b/model-bridge/patch_desktop_video.py
@@ -0,0 +1,121 @@
+"""Reproducible, version-checked local-video extension for HuobaoDrama 4.0.10.
+
+Prepare by default; --install replaces the archive/frontend after the app closes.
+Original files stay in integration-work/backups/multivideo-4.0.10.
+"""
+import hashlib
+import json
+from pathlib import Path
+import shutil
+import struct
+import sys
+
+ROOT = Path(__file__).resolve().parent.parent
+WORK = ROOT / "integration-work"
+RES = ROOT / "HuobaoDrama/resources"
+BACKUP = WORK / "backups/multivideo-4.0.10"
+MODELS = ["MiniMax-H3", "MiniMax-H3-Hybrid", "MiniMax-H3-R2V-4Step", "LTX-2.3", "LTX-2.3-Text-Preserve", "Wan2.2-I2V"]
+
+
+def replace_once(text, old, new):
+    if text.count(old) != 1:
+        raise RuntimeError("Desktop version mismatch: " + old[:90])
+    return text.replace(old, new, 1)
+
+
+def prepare():
+    # Never rebuild a newer installation from an old backup archive.
+    installed = (RES / 'app.asar').read_bytes()
+    _, hs, _, js = struct.unpack('<4I', installed[:16])
+    header = json.loads(installed[16:16 + js])
+    entry = header['files']['package.json']
+    start = 8 + hs + int(entry['offset'])
+    version = json.loads(installed[start:start + entry['size']])['version']
+    if version != '4.0.10':
+        raise RuntimeError('This legacy patch supports only 4.0.10; installed version is ' + version)
+    BACKUP.mkdir(parents=True, exist_ok=True)
+    archive = RES / "app.asar"
+    frontend = RES / "frontend/_nuxt/D3oBzv6c.js"
+    locale = RES / "frontend/_nuxt/BU13Ari2.js"
+    for source in (archive, frontend, locale):
+        target = BACKUP / source.name
+        if not target.exists():
+            shutil.copy2(source, target)
+    raw = (BACKUP / "app.asar").read_bytes()
+    _, header_size, _, json_size = struct.unpack("<4I", raw[:16])
+    tree = json.loads(raw[16:16 + json_size])
+    data = raw[8 + header_size:]
+    entry = tree["files"]["build"]["files"]["backend.mjs"]
+    offset, size = int(entry["offset"]), entry["size"]
+    original = data[offset:offset + size]
+    if hashlib.sha256(original).hexdigest() != "0fc3b513625e17fc31822b2c5c5d7527a103d163c872e08535d2b4792df60ae2":
+        raise RuntimeError("Expected the inspected HuobaoDrama 4.0.10 backend")
+    backend = original.decode("utf-8")
+    start = backend.index("var MiniMaxVideoAdapter = class {")
+    end = backend.index("\n// ../backend/src/services/adapters/aliyun-wan-video.ts", start)
+    adapter = backend[start:end].replace("MiniMaxVideoAdapter", "LocalVideoAdapter").replace('provider = "minimax"', 'provider = "localvideo"')
+    guard_start = adapter.index("    if (!model.toLowerCase()")
+    guard_end = adapter.index("    const prompt =", guard_start)
+    adapter = adapter[:guard_start] + "    if (!" + json.dumps(MODELS) + ".includes(model)) throw new Error(`Unknown local video model: ${model}`);\n" + adapter[guard_end:]
+    adapter = adapter.replace("MiniMax H3", "Local video")
+    resolution_start = adapter.index("  normalizeResolution(resolution) {")
+    adapter = adapter[:resolution_start] + '''  normalizeResolution(resolution) {
+    const value = (resolution || "720p").toUpperCase();
+    if (!["480P", "720P", "1080P", "768P", "2K"].includes(value)) throw new Error("Unsupported local video resolution");
+    return value;
+  }
+};
+'''
+    # Do not silently throw away file/link attachments unsupported by the local pool.
+    adapter = replace_once(adapter, '    const prompt =', '    if (record2.referenceFileUrl || record2.referenceLinkUrl) throw new Error("Local video requires image references");\n    const prompt =')
+    backend = replace_once(backend, 'video: ["volcengine", "minimax", "aliyun"]', 'video: ["volcengine", "minimax", "aliyun", "localvideo"]')
+    backend = replace_once(backend, "var videoAdapters = {", adapter + "\nvar videoAdapters = {\n  localvideo: new LocalVideoAdapter(),")
+    backend = replace_once(backend, '  if (p === "openai") {', '  if (p === "openai" || p === "localvideo") {')
+    encoded = backend.encode("utf-8")
+    entry["offset"], entry["size"] = str(len(data)), len(encoded)
+    block_size = entry["integrity"]["blockSize"]
+    entry["integrity"].update(hash=hashlib.sha256(encoded).hexdigest(), blocks=[hashlib.sha256(encoded[i:i + block_size]).hexdigest() for i in range(0, len(encoded), block_size)])
+    header = json.dumps(tree, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
+    pad = (-len(header)) % 4
+    header_size = 8 + len(header) + pad
+    # Keep production data beside the installation, outside the resettable
+    # Electron profile. An explicit storage-config.json still takes precedence.
+    main_entry = tree["files"]["dist"]["files"]["main.js"]
+    main_start = int(main_entry["offset"])
+    main_source = data[main_start:main_start + main_entry["size"]].decode("utf-8")
+    main_source = replace_once(main_source,
+        '  const fallback = path5.join(import_electron3.app.getPath("userData"), "data");',
+        '  const fallback = import_electron3.app.isPackaged ? path5.resolve(process.resourcesPath, "../../huobao-data") : path5.join(import_electron3.app.getPath("userData"), "data");')
+    main_bytes = main_source.encode("utf-8")
+    main_entry["offset"], main_entry["size"] = str(len(data) + len(encoded)), len(main_bytes)
+    main_block_size = main_entry["integrity"]["blockSize"]
+    main_entry["integrity"].update(hash=hashlib.sha256(main_bytes).hexdigest(), blocks=[hashlib.sha256(main_bytes[i:i + main_block_size]).hexdigest() for i in range(0, len(main_bytes), main_block_size)])
+    header = json.dumps(tree, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
+    pad = (-len(header)) % 4
+    header_size = 8 + len(header) + pad
+    packed = struct.pack("<4I", 4, header_size, header_size - 4, len(header)) + header + bytes(pad) + data + encoded + main_bytes
+    (WORK / "app.multivideo.asar").write_bytes(packed)
+    (WORK / "backend.multivideo.mjs").write_bytes(encoded)
+    (WORK / "main.persistent.js").write_bytes(main_bytes)
+    (WORK / "local-video-adapter.js").write_text(adapter, encoding="utf-8")
+    ui = (BACKUP / frontend.name).read_text("utf-8")
+    ui = replace_once(ui, 'Ls=["gemini","openai","volcengine","minimax","aliyun"]', 'Ls=["gemini","openai","volcengine","minimax","aliyun","localvideo"]')
+    preset = json.dumps({"label": "本地视频任务池", "baseUrl": "http://192.168.110.111:18792", "models": MODELS}, ensure_ascii=False, separators=(",", ":"))
+    ui = replace_once(ui, 'video:{aliyun:{', 'video:{localvideo:' + preset + ',aliyun:{')
+    (WORK / frontend.name).write_text(ui, encoding="utf-8")
+    translations = (BACKUP / locale.name).read_text("utf-8")
+    translations = replace_once(translations, "镜头视频直出生成，默认 Seedance 2.0", "镜头视频生成，可选择多个模型并设置默认")
+    translations = replace_once(translations, "Direct video generation, Seedance 2.0 by default", "Video generation with selectable models and defaults")
+    (WORK / locale.name).write_text(translations, encoding="utf-8")
+    if "--install" in sys.argv or "--frontend-only" in sys.argv:
+        if "--frontend-only" not in sys.argv:
+            shutil.copy2(WORK / "app.multivideo.asar", archive)
+        shutil.copy2(WORK / frontend.name, frontend)
+        shutil.copy2(WORK / locale.name, locale)
+        print("Installed local-video provider; originals:", BACKUP)
+    else:
+        print("Prepared local-video provider for", len(MODELS), "models")
+
+
+if __name__ == "__main__":
+    prepare()
diff --git a/model-bridge/reconcile_cleared_tasks.py b/model-bridge/reconcile_cleared_tasks.py
new file mode 100644
index 0000000..725e5b4
--- /dev/null
+++ b/model-bridge/reconcile_cleared_tasks.py
@@ -0,0 +1,17 @@
+"""Reconcile only user-cleared upstream jobs; preserve records and all existing media."""
+import json,sqlite3,datetime
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+report=json.loads((root/'integration-work/cleared-task-states.json').read_text())
+assert len(report)==21 and all(not r['in_queue'] and r['remote_status'] is None for r in report.values())
+database=root/'huobao-data/huobao.sqlite3'
+backup=root/'huobao-data/backups'/('before-cancel-reconcile-'+datetime.datetime.now().strftime('%Y%m%d-%H%M%S')+'.sqlite3')
+changed=[]
+with sqlite3.connect(database) as db,sqlite3.connect(backup) as dest:
+ db.backup(dest)
+ for tid,row in report.items():
+  cur=db.execute("UPDATE sys_task SET status='failed',stage='failed',error_code='user_cancelled',error_msg=?,updated_at=? WHERE id=? AND task_id=? AND status IN ('processing','failed') AND local_path IS NULL AND result_url IS NULL",('已按你的要求清除服务器任务；已完成素材保持不变。',datetime.datetime.now(datetime.timezone.utc).isoformat().replace('+00:00','Z'),int(tid),row['encoded']))
+  if cur.rowcount:changed.append(int(tid))
+ assert db.execute('PRAGMA quick_check').fetchone()[0]=='ok'
+print('Reconciled cleared jobs without deleting records or media:',changed)
+print('Database backup:',backup)
diff --git a/model-bridge/register_vdn.py b/model-bridge/register_vdn.py
new file mode 100644
index 0000000..c5f7bdd
--- /dev/null
+++ b/model-bridge/register_vdn.py
@@ -0,0 +1,28 @@
+import json,urllib.request
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+launch=json.loads((root/'huobao-data/last-launch.json').read_text())
+private=json.loads((root/'model-bridge/client.json').read_text())
+base=launch['api']
+def request(path,body=None,method=None):
+    req=urllib.request.Request(base+path,data=json.dumps(body).encode() if body else None,headers={'Content-Type':'application/json'},method=method)
+    with urllib.request.urlopen(req,timeout=30) as response:return json.load(response)
+configs=request('/ai-configs')['data']
+if isinstance(configs,dict): configs=configs.get('items',[])
+if any('MiniMax-H3-VDN-H3' in row.get('model',[]) for row in configs):
+    print('VDN configuration already exists; preserved')
+else:
+    data={'name':'MiniMax H3-VDN-H3（高清 2K/4K）','service_type':'video','provider':'localvideo',
+          'base_url':'http://192.168.110.111:18794','api_key':private['token'],'model':['MiniMax-H3-VDN-H3'],
+          'priority':40,'is_active':False}
+    result=request('/ai-configs',data)
+    for row in request('/ai-configs')['data']:
+        if 'MiniMax-H3-VDN-H3' in row.get('model',[]):
+            request('/ai-configs/'+str(row['id']),{'is_active':False},'PUT')
+    print('New VDN configuration saved inactive for initial validation')
+print('health',request('/health'))
+styles=request('/style-presets?all=1')['data']
+if isinstance(styles,dict):styles=styles.get('items',[])
+print('custom styles',[(s['name'],s['value']) for s in styles if s['value'] in ('live-action','xianxia-live-action')])
+hd=request('/hd/episodes/1')['data']
+print('HD API',len(hd['items']),'storyboards; configured:',hd['configured'])
diff --git a/model-bridge/restart_verify.ps1 b/model-bridge/restart_verify.ps1
new file mode 100644
index 0000000..a92beef
--- /dev/null
+++ b/model-bridge/restart_verify.ps1
@@ -0,0 +1,17 @@
+$ErrorActionPreference = 'Stop'
+$root = 'D:\web\dj'
+$exe = Join-Path $root 'HuobaoDrama\HuobaoDrama.exe'
+$python = 'C:\Users\pc\AppData\Local\Programs\Python\Python311\python.exe'
+& $python (Join-Path $root 'model-bridge\audit_data.py') 'restart-before.json'
+$processes = @(Get-Process -Name HuobaoDrama -ErrorAction SilentlyContinue | Where-Object { $_.Path -eq $exe })
+foreach ($process in $processes) { if ($process.MainWindowHandle -ne 0) { $null = $process.CloseMainWindow() } }
+$deadline = (Get-Date).AddSeconds(12)
+do {
+    $remaining = @(Get-Process -Name HuobaoDrama -ErrorAction SilentlyContinue | Where-Object { $_.Path -eq $exe })
+    if (-not $remaining.Count) { break }
+    Start-Sleep -Milliseconds 300
+} while ((Get-Date) -lt $deadline)
+if ($remaining.Count) { throw 'Application did not close cleanly' }
+& $python (Join-Path $root 'model-bridge\start_huobao.py')
+if ($LASTEXITCODE -ne 0) { throw 'Restart health check failed' }
+& $python (Join-Path $root 'model-bridge\audit_data.py') 'restart-after.json'
diff --git a/model-bridge/restore_local_data.py b/model-bridge/restore_local_data.py
new file mode 100644
index 0000000..bb51648
--- /dev/null
+++ b/model-bridge/restore_local_data.py
@@ -0,0 +1,80 @@
+"""Recover the existing project snapshot and its original server outputs.
+
+Never overwrites an existing target database or regenerates media.
+"""
+from concurrent.futures import ThreadPoolExecutor
+import hashlib
+import json
+import os
+from pathlib import Path
+import sqlite3
+
+import requests
+
+ROOT = Path(__file__).resolve().parent.parent
+TARGET = ROOT / "huobao-data"
+SOURCE = ROOT / "integration-work/backups/huobao-before-multivideo-20261106.sqlite3"
+
+
+def main():
+    TARGET.mkdir(parents=True, exist_ok=True)
+    dest = TARGET / "huobao.sqlite3"
+    if dest.exists():
+        raise RuntimeError("Recovery target already exists; inspect it instead of overwriting")
+    empty = Path(os.environ["APPDATA"]) / "HuobaoDrama/data/huobao.sqlite3"
+    snapshot = ROOT / "integration-work/backups/huobao-empty-profile-20261106.sqlite3"
+    if empty.exists() and not snapshot.exists():
+        with sqlite3.connect(empty.as_uri() + "?mode=ro", uri=True) as a, sqlite3.connect(snapshot) as b:
+            a.backup(b)
+    with sqlite3.connect(SOURCE.as_uri() + "?mode=ro", uri=True) as a, sqlite3.connect(dest) as b:
+        a.backup(b)
+    with sqlite3.connect(dest) as conn:
+        assert conn.execute("pragma integrity_check").fetchone()[0] == "ok"
+        jobs = conn.execute("select id,task_id,local_path from sys_task where type='image' and status='completed' and local_path is not null").fetchall()
+    client = json.loads((ROOT / "model-bridge/client.json").read_text("utf-8"))
+
+    def download(job):
+        task_id, remote_id, relative = job
+        target = (TARGET / relative.lstrip("/")).resolve()
+        target.relative_to(TARGET.resolve())
+        session = requests.Session()
+        session.trust_env = False
+        response = session.get(client["url"] + "/v1/images/task/" + remote_id,
+                               headers={"Authorization": "Bearer " + client["token"]}, timeout=30)
+        if response.status_code != 200:
+            return {"task_id": task_id, "error": "Status query failed", "status": response.status_code}
+        payload = response.json()
+        if payload.get("status") != "completed":
+            return {"task_id": task_id, "error": "Original image is unavailable"}
+        url = payload["image_url"]
+        if not url.startswith(client["url"] + "/media/"):
+            raise RuntimeError("Unexpected media destination")
+        with session.get(url, stream=True, timeout=120) as media:
+            if media.status_code != 200:
+                return {"task_id": task_id, "error": "Download failed", "status": media.status_code}
+            target.parent.mkdir(parents=True, exist_ok=True)
+            partial = target.with_name(target.name + ".partial")
+            digest = hashlib.sha256()
+            count = 0
+            with partial.open("wb") as out:
+                for data in media.iter_content(1024 * 1024):
+                    out.write(data)
+                    digest.update(data)
+                    count += len(data)
+            partial.replace(target)
+        return {"task_id": task_id, "path": relative, "bytes": count, "sha256": digest.hexdigest()}
+
+    with ThreadPoolExecutor(max_workers=3) as pool:
+        outcomes = list(pool.map(download, jobs))
+    report = {"source": str(SOURCE), "target": str(TARGET), "images": outcomes}
+    (ROOT / "model-bridge/data-recovery-20261106.json").write_text(json.dumps(report, indent=2, ensure_ascii=False), encoding="utf-8")
+    failed = [r for r in outcomes if "error" in r]
+    print("Recovered image files:", len(outcomes) - len(failed), "/", len(outcomes))
+    if failed:
+        print("Unrecovered task IDs:", [r["task_id"] for r in failed])
+        raise RuntimeError("Some images need additional recovery")
+    print("Project database integrity: OK")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/model-bridge/ssh_task.py b/model-bridge/ssh_task.py
new file mode 100644
index 0000000..e6d84f4
--- /dev/null
+++ b/model-bridge/ssh_task.py
@@ -0,0 +1,32 @@
+"""Run an explicitly supplied task script on the user's model server."""
+import argparse
+import os
+from pathlib import Path
+import paramiko
+
+p = argparse.ArgumentParser()
+p.add_argument('script')
+p.add_argument('--upload', nargs=2, action='append', default=[])
+p.add_argument('--download', nargs=2, action='append', default=[])
+a = p.parse_args()
+c = paramiko.SSHClient()
+c.load_system_host_keys()
+c.set_missing_host_key_policy(paramiko.WarningPolicy())
+c.connect('192.168.110.111', username='ps', password=os.environ['HUOBAO_SSH_PASSWORD'], look_for_keys=False, allow_agent=False, timeout=15)
+try:
+    with c.open_sftp() as sftp:
+        for source, destination in a.upload:
+            sftp.put(source, destination)
+    stdin, stdout, stderr = c.exec_command('python3 -', timeout=60)
+    stdin.write(Path(a.script).read_text(encoding='utf-8'))
+    stdin.channel.shutdown_write()
+    print(stdout.read().decode('utf-8', errors='replace'))
+    print(stderr.read().decode('utf-8', errors='replace'))
+    code = stdout.channel.recv_exit_status()
+    if code == 0 and a.download:
+        with c.open_sftp() as sftp:
+            for source, destination in a.download:
+                sftp.get(source, destination)
+    raise SystemExit(code)
+finally:
+    c.close()
diff --git a/model-bridge/start_huobao.py b/model-bridge/start_huobao.py
new file mode 100644
index 0000000..75838bd
--- /dev/null
+++ b/model-bridge/start_huobao.py
@@ -0,0 +1,152 @@
+"""One-click desktop launcher: validate stored data, back it up, then open Huobao."""
+from __future__ import annotations
+
+import argparse
+from datetime import datetime
+import json
+import os
+from pathlib import Path
+import re
+import sqlite3
+import subprocess
+import sys
+import time
+import urllib.error
+import urllib.request
+
+ROOT = Path(__file__).resolve().parent.parent
+DATA = ROOT / "huobao-data"
+EXE = ROOT / "HuobaoDrama/HuobaoDrama.exe"
+PROFILE = Path(os.environ["APPDATA"]) / "HuobaoDrama"
+HTTP = urllib.request.build_opener(urllib.request.ProxyHandler({}))
+
+
+def get_json(url, timeout=2):
+    with HTTP.open(url, timeout=timeout) as response:
+        return json.load(response)
+
+
+def running_app():
+    try:
+        log = (PROFILE / "logs/startup.log").read_text("utf-8")
+        ports = re.findall(r"port=(\d+) userData=", log)
+        if not ports:
+            return None
+        base = "http://127.0.0.1:" + ports[-1] + "/api/v1"
+        info = get_json(base + "/storage").get("data", {})
+        if not info.get("dataDir") or info.get("mode") != "desktop":
+            return None
+        return base, Path(info["dataDir"]).resolve()
+    except (OSError, ValueError, urllib.error.URLError):
+        return None
+
+
+def validate_data():
+    if not EXE.is_file():
+        raise RuntimeError(f"找不到火宝程序：{EXE}")
+    database = DATA / "huobao.sqlite3"
+    if not database.is_file():
+        raise RuntimeError(f"找不到原数据库：{database}\n为避免打开空项目，本次未启动。请先恢复数据目录。")
+    with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True, timeout=10) as conn:
+        if conn.execute("PRAGMA quick_check").fetchone()[0] != "ok":
+            raise RuntimeError("数据库检查未通过，本次未启动。请使用备份恢复。")
+        configs = conn.execute("SELECT count(*) FROM ai_service_configs").fetchone()[0]
+        projects = conn.execute("SELECT count(*) FROM dramas").fetchone()[0]
+        if configs == 0:
+            raise RuntimeError("数据库中没有模型配置，本次未启动，以免误用空数据库。")
+        grok_enabled = bool(conn.execute("SELECT 1 FROM ai_service_configs WHERE is_active=1 AND model LIKE '%grok-local%' LIMIT 1").fetchone())
+    return database, configs, projects, grok_enabled
+
+
+def save_storage_pointer():
+    PROFILE.mkdir(parents=True, exist_ok=True)
+    pointer = PROFILE / "storage-config.json"
+    if pointer.exists():
+        try:
+            previous = json.loads(pointer.read_text("utf-8"))
+            selected = previous.get("dataDir")
+        except (ValueError, AttributeError):
+            selected = None
+        if selected and Path(selected).resolve() != DATA.resolve():
+            raise RuntimeError(f"火宝目前选择了另一个数据目录：{selected}\n一键启动使用：{DATA}\n请先确认存储位置；原设置未改动。")
+        if selected:
+            return
+        backup = DATA / "backups" / ("storage-pointer-" + datetime.now().strftime("%Y%m%d-%H%M%S") + ".json")
+        backup.parent.mkdir(parents=True, exist_ok=True)
+        backup.write_bytes(pointer.read_bytes())
+    temporary = pointer.with_name(f"storage-config.{os.getpid()}.tmp")
+    temporary.write_text(json.dumps({"version": 1, "dataDir": str(DATA)}, ensure_ascii=False, indent=2), encoding="utf-8")
+    temporary.replace(pointer)
+
+
+def backup_database(database):
+    folder = DATA / "backups"
+    folder.mkdir(parents=True, exist_ok=True)
+    target = folder / ("startup-" + datetime.now().strftime("%Y%m%d-%H%M%S") + f"-{os.getpid()}.sqlite3")
+    # SQLite's online backup also includes committed WAL changes while Huobao is open.
+    with sqlite3.connect(database.as_uri() + "?mode=ro", uri=True, timeout=10) as source:
+        with sqlite3.connect(target) as destination:
+            source.backup(destination)
+            if destination.execute("PRAGMA quick_check").fetchone()[0] != "ok":
+                raise RuntimeError("启动前数据库备份校验失败，本次未启动。")
+    return target
+
+
+def ensure_grok():
+    try:
+        if get_json("http://127.0.0.1:18793/health").get("service") == "huobao-model-bridge":
+            return
+    except (OSError, ValueError, urllib.error.URLError):
+        pass
+    pythonw = Path(sys.executable).with_name("pythonw.exe")
+    runner = pythonw if pythonw.is_file() else Path(sys.executable)
+    subprocess.Popen([str(runner), str(ROOT / "model-bridge/launch_local.py")],
+                     cwd=ROOT / "model-bridge", creationflags=subprocess.CREATE_NO_WINDOW,
+                     stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--check", action="store_true", help="只检查，不启动或修改配置")
+    args = parser.parse_args()
+    database, configs, projects, grok_enabled = validate_data()
+    active = running_app()
+    if active and active[1] != DATA.resolve():
+        raise RuntimeError(f"当前火宝正在使用另一个数据目录：{active[1]}\n请先关闭火宝，再运行一键启动。")
+    print(f"数据检查通过：{configs} 条模型配置，{projects} 个项目。", flush=True)
+    if args.check:
+        print(f"数据目录：{DATA}")
+        return
+    save_storage_pointer()
+    backup = backup_database(database)
+    env = os.environ.copy()
+    env.pop("ELECTRON_RUN_AS_NODE", None)
+    # Huobao's single-instance lock brings its existing window forward.
+    subprocess.Popen([str(EXE)], cwd=EXE.parent, env=env)
+    deadline = time.monotonic() + 45
+    while time.monotonic() < deadline:
+        current = running_app()
+        if current:
+            if current[1] != DATA.resolve():
+                raise RuntimeError("火宝启动后的数据目录不匹配，请先停止编辑并检查存储设置。")
+            break
+        time.sleep(0.5)
+    else:
+        raise RuntimeError(f"火宝未能正常启动，请查看：{PROFILE / 'logs/startup.log'}")
+    if grok_enabled:
+        ensure_grok()
+    status = {"started_at": datetime.now().astimezone().isoformat(), "already_running": bool(active),
+              "data_directory": str(DATA), "database_backup": str(backup), "configs": configs, "projects": projects,
+              "api": current[0]}
+    (DATA / "last-launch.json").write_text(json.dumps(status, ensure_ascii=False, indent=2), encoding="utf-8")
+    print("火宝已打开，启动前数据库备份已保存。", flush=True)
+
+
+if __name__ == "__main__":
+    if sys.stdout is not None:
+        sys.stdout.reconfigure(encoding="utf-8")
+    try:
+        main()
+    except Exception as error:
+        print(f"\n启动失败：{error}", flush=True)
+        sys.exit(1)
diff --git a/model-bridge/style-live-action.json b/model-bridge/style-live-action.json
new file mode 100644
index 0000000..1aa3d9c
--- /dev/null
+++ b/model-bridge/style-live-action.json
@@ -0,0 +1,8 @@
+{
+  "name": "真人实拍",
+  "value": "live-action",
+  "prompt": "photorealistic live-action film still, believable human actors with natural facial features and realistic human proportions, authentic skin texture with visible pores and subtle imperfections, natural skin tones, lifelike eyes and individual hair strands, realistic fabric weave and material detail, grounded real-world locations with believable scale and spatial depth, professional cinematic photography, physically plausible lighting motivated by the scene, soft natural shadow transitions, controlled highlights and rich tonal detail, restrained cinematic color grading, subtle film grain, realistic lens perspective and depth of field appropriate to the requested framing, natural expressions and body language, consistent actor identity and appearance across shots, preserve the character's specified age, ethnicity, costume and story period, avoid anime, cartoons, illustration, 3D animation, game-engine rendering, doll-like faces, plastic or waxy skin, excessive beauty retouching and exaggerated anatomy",
+  "description": "真人短剧与电影实拍质感：真实人物比例、自然肤质、可信场景与电影光影，保留角色身份和时代设定。",
+  "sort_order": 0,
+  "is_active": true
+}
diff --git a/model-bridge/style-xianxia.json b/model-bridge/style-xianxia.json
new file mode 100644
index 0000000..edb909a
--- /dev/null
+++ b/model-bridge/style-xianxia.json
@@ -0,0 +1,8 @@
+{
+  "name": "仙侠风格",
+  "value": "xianxia-live-action",
+  "description": "真人仙侠影视质感：古装修仙人物、仙山云海、御剑与克制的法术光效。",
+  "prompt": "Cinematic live-action Chinese xianxia fantasy, photorealistic human actors with natural anatomy and detailed skin texture, elegant traditional Chinese flowing robes with realistic silk fabric and intricate embroidery, ethereal immortal mountains and misty cloud seas, ancient Chinese temples, jade and weathered stone, graceful sword cultivation, restrained luminous magical effects with physically plausible light interaction, atmospheric depth, film-quality practical sets and convincing visual effects, cinematic composition, natural expressive faces, no anime, no cartoon, no game character render, no plastic skin.",
+  "sort_order": 1,
+  "is_active": true
+}
\ No newline at end of file
diff --git a/model-bridge/switch_upgrade.ps1 b/model-bridge/switch_upgrade.ps1
new file mode 100644
index 0000000..2e84f0c
--- /dev/null
+++ b/model-bridge/switch_upgrade.ps1
@@ -0,0 +1,40 @@
+$ErrorActionPreference = 'Stop'
+$root = [IO.Path]::GetFullPath('D:\web\dj')
+$live = [IO.Path]::GetFullPath((Join-Path $root 'HuobaoDrama'))
+$stage = [IO.Path]::GetFullPath((Join-Path $root 'integration-work\stage-4.0.11\app'))
+$previous = [IO.Path]::GetFullPath((Join-Path $root ('integration-work\previous-app-' + (Get-Date -Format 'yyyyMMdd-HHmmss'))))
+foreach ($target in @($live,$stage,$previous)) {
+    if (-not $target.StartsWith($root + '\', [StringComparison]::OrdinalIgnoreCase)) { throw "Target outside workspace: $target" }
+}
+if (-not (Test-Path -LiteralPath (Join-Path $stage 'resources\huobao-local-build.json'))) { throw 'Staged build manifest missing' }
+$manifest = Get-Content -LiteralPath (Join-Path $stage 'resources\huobao-local-build.json') -Raw | ConvertFrom-Json
+if ($manifest.upstream_version -ne '4.0.11') { throw 'Unexpected staged version' }
+$hash = (Get-FileHash -LiteralPath (Join-Path $stage 'resources\app.asar') -Algorithm SHA256).Hash.ToLowerInvariant()
+if ($hash -ne $manifest.archive_sha256) { throw 'Staged archive hash mismatch' }
+$processes = @(Get-Process -Name HuobaoDrama -ErrorAction SilentlyContinue | Where-Object { $_.Path -eq (Join-Path $live 'HuobaoDrama.exe') })
+foreach ($process in $processes) { if ($process.MainWindowHandle -ne 0) { $null = $process.CloseMainWindow() } }
+$deadline = (Get-Date).AddSeconds(12)
+do {
+    $remaining = @(Get-Process -Name HuobaoDrama -ErrorAction SilentlyContinue | Where-Object { $_.Path -eq (Join-Path $live 'HuobaoDrama.exe') })
+    if (-not $remaining.Count) { break }
+    Start-Sleep -Milliseconds 300
+} while ((Get-Date) -lt $deadline)
+if ($remaining.Count) { throw 'Application has not closed cleanly. No files replaced.' }
+$python = 'C:\Users\pc\AppData\Local\Programs\Python\Python311\python.exe'
+& $python (Join-Path $root 'model-bridge\audit_data.py') 'before-switch-final.json'
+if ($LASTEXITCODE -ne 0) { throw 'Pre-switch data check failed' }
+& $python (Join-Path $root 'model-bridge\backup_upgrade.py')
+if ($LASTEXITCODE -ne 0) { throw 'Backup failed; original app retained' }
+Move-Item -LiteralPath $live -Destination $previous
+try { Copy-Item -LiteralPath $stage -Destination $live -Recurse }
+catch {
+    # Leave any partial new copy for inspection and put the known working app back.
+    $failed = Join-Path $root ('integration-work\failed-copy-' + (Get-Date -Format 'yyyyMMdd-HHmmss'))
+    if (Test-Path -LiteralPath $live) { Move-Item -LiteralPath $live -Destination $failed }
+    Move-Item -LiteralPath $previous -Destination $live
+    throw
+}
+Write-Output "Previous program retained at $previous"
+& $python (Join-Path $root 'model-bridge\start_huobao.py')
+if ($LASTEXITCODE -ne 0) { throw 'New application failed health check; backups retained' }
+& $python (Join-Path $root 'model-bridge\audit_data.py') 'after-switch.json'
diff --git a/model-bridge/test_bridge.py b/model-bridge/test_bridge.py
new file mode 100644
index 0000000..bd21cf7
--- /dev/null
+++ b/model-bridge/test_bridge.py
@@ -0,0 +1,347 @@
+import base64
+import json
+import struct
+import tempfile
+import unittest
+from unittest.mock import patch
+
+import httpx
+from fastapi.testclient import TestClient
+
+from bridge import VIDEO_MODELS, create_app, h3_request, video_workflows
+
+
+class BridgeTests(unittest.TestCase):
+    def test_local_worker_state_is_forwarded_without_claiming_failure(self):
+        video=self.client.post('/v2/video_generation',json=self.payload(),headers=self.headers).json()['task_id']
+        self.client.post('/v1/images/generations',json=self.image_payload(),headers=self.headers)
+        self.job_status=self.image_status='running'
+        for state in ['queued','running','checking','missing']:
+            self.worker_state=state
+            task=self.client.get('/v2/query/video_generation/'+video,headers=self.headers).json()['task']
+            self.assertEqual(task['worker_state'],state)
+            self.assertEqual(task['status'],'running')
+            image=self.client.get('/v1/images/task/image-job',headers=self.headers).json()
+            self.assertEqual(image['worker_state'],state)
+            self.assertEqual(image['status'],'processing')
+
+    def test_cancel_requires_auth_and_bridge_owned_video(self):
+        self.assertEqual(self.client.post('/v2/video_generation/unknown/cancel').status_code, 401)
+        self.assertEqual(self.client.post('/v2/video_generation/unknown/cancel', headers=self.headers).status_code, 404)
+        self.assertFalse(any('/cancel' in r.url.path for r in self.calls))
+
+    def test_cancel_targets_exact_owned_id(self):
+        result = self.client.post('/v2/video_generation', json=self.payload(), headers=self.headers)
+        jid = result.json()['task_id']
+        self.job_status = 'cancelled'
+        result = self.client.post('/v2/video_generation/' + jid + '/cancel', headers=self.headers)
+        self.assertEqual(result.status_code, 200, result.text)
+        self.assertEqual(result.json()['task']['status'], 'cancelled')
+        calls = [r for r in self.calls if '/cancel' in r.url.path]
+        self.assertEqual(len(calls), 1)
+        self.assertEqual(calls[0].url.path, '/v1/jobs/' + jid + '/cancel')
+
+    def test_vdn_exact_hd_dimensions_and_seed(self):
+        for resolution,landscape in [('2K',(2560,1440)),('4K',(3840,2160))]:
+            for ratio in ('16:9','9:16'):
+                payload={**self.payload(),'model':'MiniMax-H3-VDN-H3','resolution':resolution,'ratio':ratio,'seed':42}
+                payload['content'].append({'type':'image_url','role':'reference_image','image_url':{'url':'data:image/png;base64,AA=='}})
+                request=h3_request(payload)
+                self.assertEqual((request['width'],request['height']),landscape if ratio=='16:9' else landscape[::-1])
+                self.assertEqual(request['seed'],42)
+        payload['resolution']='720P'
+        with self.assertRaises(Exception): h3_request(payload)
+
+    def test_explicit_gpu_routing_for_video_and_images(self):
+        for gpu,worker in [('gpu1','gpu1_8189'),('gpu2','default'),('gpu3','gpu3')]:
+            result=self.client.post('/v2/video_generation',json={**self.payload(),'gpu':gpu},headers=self.headers)
+            self.assertEqual(result.status_code,200,result.text)
+            sent=json.loads(next(r for r in reversed(self.calls) if r.url.path=='/v1/jobs').content)
+            self.assertEqual(sent['provider_id'],worker)
+            self.assertIs(sent['strict_provider'],True)
+            self.assertIs(sent['huobao_panels'],True)
+            self.assertEqual(result.json()['routing']['port'],{'gpu1':8189,'gpu2':8188,'gpu3':8191}[gpu])
+            image={'model':'qwen_image_2_1','prompt':'A teacup.','gpu':gpu,'size':'512x512'}
+            result=self.client.post('/v1/images/generations',json=image,headers=self.headers)
+            self.assertEqual(result.status_code,200,result.text)
+            sent=json.loads(next(r for r in reversed(self.calls) if r.url.path=='/v1/jobs').content)
+            self.assertEqual(sent['provider_id'],worker)
+            self.assertIs(sent['strict_provider'],True)
+
+    def test_invalid_gpu_never_submits(self):
+        for gpu in ('gpu0','gpu4',None,False,[]):
+            result=self.client.post('/v2/video_generation',json={**self.payload(),'gpu':gpu},headers=self.headers)
+            self.assertEqual(result.status_code,400)
+        self.assertFalse(any(r.url.path=='/v1/jobs' for r in self.calls))
+
+    def setUp(self):
+        self.tmp = tempfile.TemporaryDirectory()
+        self.config = {"token": "test-secret", "state_dir": self.tmp.name,
+                       "public_url": "http://bridge.test", "h3": {"url": "http://h3.test", "token": "upstream-secret"},
+                       "dify": {"qwen-dify": {"url": "http://dify.test/v1", "key": "dify-secret"}}}
+        self.calls = []
+        self.job_status = "succeeded"
+        self.dify_error = False
+        self.qwen_available = True
+        self.video_available = True
+        self.image_status = "succeeded"
+        self.image_outputs = [{"index": 0, "kind": "image", "mimeType": "image/png"}]
+        original = httpx.AsyncClient
+        self.patch = patch("bridge.httpx.AsyncClient", side_effect=lambda **kw: original(**kw, transport=httpx.MockTransport(self.handle)))
+        self.patch.start()
+        self.client = TestClient(create_app(self.config))
+        self.headers = {"Authorization": "Bearer test-secret"}
+
+    def tearDown(self):
+        self.patch.stop()
+        self.tmp.cleanup()
+
+    def handle(self, request):
+        self.calls.append(request)
+        if request.url.path == '/v1/huobao/route':
+            return httpx.Response(200,json={'providerId':json.loads(request.content)['provider_id'],'ready':True})
+        if request.url.host == "dify.test":
+            if self.dify_error:
+                events = [{"event": "error", "message": "Quota exceeded"}]
+            else:
+                events = [{"event": "message", "answer": "Hello"}, {"event": "message", "answer": " world"},
+                          {"event": "message_end", "metadata": {"usage": {"total_tokens": 8}}}]
+            return httpx.Response(200, text="".join("data: " + json.dumps(e) + "\n\n" for e in events))
+        self.assertEqual(request.headers["Authorization"], "Bearer upstream-secret")
+        if request.url.path == '/health':
+            return httpx.Response(200,json={'autoBalance':True,'providers':2})
+        if request.url.path == '/v1/providers':
+            return httpx.Response(200,json={'providers':[{'id':'default','name':'GPU2'},{'id':'gpu3','name':'GPU3'}]})
+        if request.url.path == "/v1/models":
+            data = [{"id": k} for k in set().union(*(video_workflows(s) for s in VIDEO_MODELS.values()))] if self.video_available else []
+            if self.qwen_available:
+                data.append({"id": "qwen_image_2_1", "model_type": "image"})
+            return httpx.Response(200, json={"data": data})
+        if request.url.path == "/v1/audio-plan":
+            return httpx.Response(200, json={"status": "ready"})
+        if request.url.path == "/v1/jobs":
+            data=json.loads(request.content)
+            worker=data['provider_id'] if data.get('strict_provider') else 'gpu3'
+            suffix='-'+worker if data.get('strict_provider') else ''
+            if data["workflow_key"] == "qwen_image_2_1":
+                return httpx.Response(200, json={"id": "image-job"+suffix, "status": "submitted", "providerId": worker})
+            return httpx.Response(200, json={"id": "test-job"+suffix, "status": "submitted", "providerId": worker})
+        if request.url.path == "/v1/huobao/jobs/image-job":
+            return httpx.Response(200, json={"status": self.image_status, "error": "image sampler failed", "outputs": self.image_outputs, "providerId": "gpu3", "worker_state":getattr(self,'worker_state','running')})
+        if request.url.path == "/v1/jobs/image-job/outputs/0":
+            return httpx.Response(200, content=b"test-image-bytes", headers={"content-type": "image/png"})
+        if request.url.path in ("/v1/huobao/jobs/test-job", "/v1/jobs/test-job/cancel"):
+            return httpx.Response(200, json={"status": self.job_status, "error": "quality gate failed", "providerId": "gpu3", "worker_state":getattr(self,'worker_state','running'),
+                                           "outputs": [{"index": 0, "kind": "image"}, {"index": 1, "kind": "video"}]})
+        if request.url.path == "/v1/jobs/test-job/outputs/1":
+            return httpx.Response(200, content=b"test-video-bytes", headers={"content-type": "video/mp4"})
+        raise AssertionError(str(request.url))
+
+    def payload(self):
+        return {"model": "MiniMax-H3", "content": [{"type": "text", "text": "A still mountain."}], "duration": 5, "resolution": "768P", "ratio": "9:16"}
+
+    def test_auth_is_required(self):
+        self.assertEqual(self.client.get("/v1/models").status_code, 401)
+        self.assertEqual(self.calls, [])
+
+    def test_empty_probe_cannot_submit(self):
+        self.assertEqual(self.client.post("/v2/video_generation", json={}, headers=self.headers).status_code, 200)
+        self.assertTrue(self.calls)
+        self.assertTrue(all(r.url.path == "/v1/models" for r in self.calls))
+
+    def test_validation_does_not_submit_gpu_job(self):
+        result = self.client.post("/v2/video_generation/validate", json=self.payload(), headers=self.headers)
+        self.assertTrue(result.json()["valid"])
+        self.assertEqual(result.json()["width"], 768)
+        self.assertGreater(result.json()["height"], 768)
+        self.assertFalse(any(r.url.path == "/v1/jobs" for r in self.calls))
+
+    def test_video_submission_poll_and_download(self):
+        result = self.client.post("/v2/video_generation", json=self.payload(), headers=self.headers)
+        self.assertEqual(result.json()["task_id"], "test-job")
+        self.assertEqual(result.json()["provider_id"], "gpu3")
+        sent = json.loads(self.calls[-1].content)
+        self.assertEqual(sent["workflow_key"], "minimax_h3_t2v_official")
+        self.assertEqual(sent["duration"], 5)
+        self.assertEqual(sent["provider_id"], "default")
+        poll = self.client.get("/v2/query/video_generation/test-job", headers=self.headers).json()
+        url = poll["task"]["content"]["url"]
+        self.assertEqual(poll["task"]["provider_id"], "gpu3")
+        self.assertIn("/video.mp4?", url)
+        self.assertNotIn("test-secret", url)
+        self.assertEqual(self.client.get(url).content, b"test-video-bytes")
+        self.assertEqual(self.client.get(url + "x").status_code, 403)
+
+    def test_every_video_mode_uses_automatic_pool(self):
+        image = {"type": "image_url", "image_url": {"url": "data:image/png;base64,AA=="}}
+        for model, spec in VIDEO_MODELS.items():
+            for mode in ("text", "first", "reference"):
+                if mode not in spec:
+                    continue
+                with self.subTest(model=model, mode=mode):
+                    payload = {**self.payload(), "model": model}
+                    if model == "MiniMax-H3-VDN-H3":
+                        payload["resolution"] = "2K"
+                    if mode != "text":
+                        payload["content"].append({**image, "role": "first_frame" if mode == "first" else "reference_image"})
+                    request = h3_request(payload)
+                    self.assertEqual(request["workflow_key"], spec[mode])
+                    self.assertEqual(request["provider_id"], "default")
+                    result = self.client.post("/v2/video_generation/validate", json=payload, headers=self.headers)
+                    self.assertEqual(result.status_code, 200)
+                    self.assertTrue(result.json()["valid"])
+        self.assertFalse(any(r.url.path == "/v1/jobs" for r in self.calls))
+
+    def test_invalid_video_modes_fail_before_submission(self):
+        image = {"type": "image_url", "image_url": {"url": "data:image/png;base64,AA=="}, "role": "reference_image"}
+        for model, refs in [("Wan2.2-I2V", []), ("Wan2.2-I2V", [image, image]), ("LTX-2.3", [image, image]),
+                            ("MiniMax-H3-R2V-4Step", []), ("MiniMax-H3-R2V-4Step", [{**image, "role": "first_frame"}]), ("unknown", [])]:
+            payload = {**self.payload(), "model": model}
+            payload["content"] += refs
+            response = self.client.post("/v2/video_generation", json=payload, headers=self.headers)
+            self.assertEqual(response.status_code, 400, response.text)
+        self.assertFalse(self.calls)
+
+    def test_unavailable_video_models_hidden_and_blocked(self):
+        self.video_available = False
+        models = self.client.get("/v1/models", headers=self.headers).json()["data"]
+        self.assertFalse(set(m["id"] for m in models) & set(VIDEO_MODELS))
+        response = self.client.post("/v2/video_generation", json=self.payload(), headers=self.headers)
+        self.assertEqual(response.status_code, 503)
+        self.assertFalse(any(r.url.path == "/v1/jobs" for r in self.calls))
+
+    def test_unknown_jobs_are_rejected(self):
+        self.assertEqual(self.client.get("/v2/query/video_generation/other", headers=self.headers).status_code, 404)
+        self.assertFalse(self.calls)
+
+    def test_failed_job_never_returns_partial_output(self):
+        self.client.post("/v2/video_generation", json=self.payload(), headers=self.headers)
+        self.job_status = "failed"
+        task = self.client.get("/v2/query/video_generation/test-job", headers=self.headers).json()["task"]
+        self.assertEqual(task["status"], "failed")
+        self.assertNotIn("content", task)
+
+    def test_image_modes_and_unsupported_reference(self):
+        payload = self.payload()
+        item = {"type": "image_url", "image_url": {"url": "data:image/png;base64,AA=="}, "role": "first_frame"}
+        payload["content"].append(item)
+        self.assertEqual(h3_request(payload)["workflow_key"], "minimax_h3_i2v")
+        item["role"] = "reference_image"
+        self.assertEqual(h3_request(payload)["workflow_key"], "minimax_h3_r2v")
+        item["role"] = "last_frame"
+        self.assertEqual(self.client.post("/v2/video_generation", json=payload, headers=self.headers).status_code, 400)
+        self.assertFalse(self.calls)
+
+    def test_first_frame_preserves_portrait_ratio(self):
+        payload = self.payload()
+        payload.pop("ratio")
+        header = b"\x89PNG\r\n\x1a\n" + b"\x00" * 8 + struct.pack(">II", 720, 1280)
+        url = "data:image/png;base64," + base64.b64encode(header).decode()
+        item = {"type": "image_url", "image_url": {"url": url}, "role": "first_frame"}
+        payload["content"].append(item)
+        parsed = h3_request(payload)
+        self.assertEqual(parsed["width"], 768)
+        self.assertGreater(parsed["height"], parsed["width"])
+        payload["content"].append({**item, "role": "reference_image"})
+        self.assertEqual(self.client.post("/v2/video_generation", json=payload, headers=self.headers).status_code, 400)
+
+    def test_dify_nonstream_preserves_instructions(self):
+        body = {"model": "qwen-dify", "messages": [{"role": "system", "content": "Write a story"}, {"role": "user", "content": "About a cat"}]}
+        result = self.client.post("/v1/chat/completions", json=body, headers=self.headers)
+        self.assertEqual(result.json()["choices"][0]["message"]["content"], "Hello world")
+        query = json.loads(self.calls[-1].content)["query"]
+        self.assertIn("Write a story", query)
+        self.assertIn("About a cat", query)
+        self.assertEqual(result.json()["usage"]["total_tokens"], 8)
+
+    def test_dify_stream(self):
+        body = {"model": "qwen-dify", "messages": [{"role": "user", "content": "hi"}], "stream": True}
+        result = self.client.post("/v1/chat/completions", json=body, headers=self.headers)
+        self.assertIn('"finish_reason": "stop"', result.text)
+        self.assertIn("data: [DONE]", result.text)
+
+    def test_dify_errors_are_not_success(self):
+        self.dify_error = True
+        body = {"model": "qwen-dify", "messages": [{"role": "user", "content": "hi"}]}
+        self.assertEqual(self.client.post("/v1/chat/completions", json=body, headers=self.headers).status_code, 502)
+        body["stream"] = True
+        stream = self.client.post("/v1/chat/completions", json=body, headers=self.headers).text
+        self.assertIn("Quota exceeded", stream)
+        self.assertNotIn('"finish_reason": "stop"', stream)
+
+    def image_payload(self):
+        return {"model": "qwen_image_2_1", "prompt": "A red ceramic cup", "size": "512x768", "n": 1, "response_format": "url"}
+
+    def test_image_generation_poll_and_download(self):
+        response = self.client.post("/v1/images/generations", json=self.image_payload(), headers=self.headers)
+        self.assertEqual(response.status_code, 200)
+        self.assertEqual(response.json()["task_id"], "image-job")
+        submitted = json.loads(self.calls[-1].content)
+        self.assertEqual(submitted["workflow_key"], "qwen_image_2_1")
+        self.assertEqual((submitted["width"], submitted["height"]), (512, 768))
+        self.assertEqual(submitted["input_images"], [])
+        result = self.client.get("/v1/images/task/image-job", headers=self.headers).json()
+        self.assertEqual(result["status"], "completed")
+        self.assertIn("/image.png?", result["image_url"])
+        image = self.client.get(result["image_url"])
+        self.assertEqual(image.headers["content-type"], "image/png")
+        self.assertEqual(image.content, b"test-image-bytes")
+
+    def test_image_edits_forward_all_references(self):
+        image = b"\x89PNG\r\n\x1a\n" + b"\x00" * 8 + struct.pack(">II", 400, 600)
+        files = [("image[]", ("ref1.png", image, "image/png")), ("image[]", ("ref2.png", image, "image/png"))]
+        response = self.client.post("/v1/images/edits", data=self.image_payload(), files=files, headers=self.headers)
+        self.assertEqual(response.status_code, 200, response.text)
+        submitted = json.loads(self.calls[-1].content)
+        self.assertEqual(len(submitted["input_images"]), 2)
+        self.assertEqual(base64.b64decode(submitted["input_images"][0].split(",")[1]), image)
+        self.assertEqual(submitted["prompt"], self.image_payload()["prompt"])
+        self.assertEqual(submitted['provider_id'],'default')
+        self.assertEqual(response.json()['provider_id'],'gpu3')
+
+    def test_image_pool_is_live_and_authenticated(self):
+        self.assertEqual(self.client.get('/v1/images/pool').status_code,401)
+        data=self.client.get('/v1/images/pool',headers=self.headers).json()
+        self.assertTrue(data['auto_balance'])
+        self.assertEqual([w['id'] for w in data['configured_workers']],['default','gpu3'])
+        self.assertFalse(any(r.url.path=='/v1/jobs' for r in self.calls))
+
+    def test_image_edits_reject_invalid_or_excess_references(self):
+        response = self.client.post("/v1/images/edits", data=self.image_payload(), files={"image[]": ("fake.png", b"not an image", "image/png")}, headers=self.headers)
+        self.assertEqual(response.status_code, 400)
+        image = b"\x89PNG\r\n\x1a\n" + b"\x00" * 8 + struct.pack(">II", 400, 600)
+        files = [("image[]", (f"ref{i}.png", image, "image/png")) for i in range(7)]
+        response = self.client.post("/v1/images/edits", data=self.image_payload(), files=files, headers=self.headers)
+        self.assertEqual(response.status_code, 400)
+        self.assertFalse(self.calls)
+
+    def test_image_unavailable_does_not_submit(self):
+        self.qwen_available = False
+        response = self.client.post("/v1/images/generations", json=self.image_payload(), headers=self.headers)
+        self.assertEqual(response.status_code, 503)
+        self.assertTrue(all(r.url.path == "/v1/models" for r in self.calls))
+
+    def test_image_failed_or_pending_never_returns_partial_output(self):
+        self.client.post("/v1/images/generations", json=self.image_payload(), headers=self.headers)
+        for upstream, expected in [("failed", "failed"), ("cancelled", "failed"), ("running", "processing")]:
+            self.image_status = upstream
+            result = self.client.get("/v1/images/task/image-job", headers=self.headers).json()
+            self.assertEqual(result["status"], expected)
+            self.assertNotIn("image_url", result)
+
+    def test_image_validation_and_invalid_requests_do_not_generate(self):
+        self.assertEqual(self.client.post("/v1/images/generations", json=self.image_payload()).status_code, 401)
+        self.assertEqual(self.client.post("/v1/images/validate", json=self.image_payload(), headers=self.headers).status_code, 200)
+        for update in [{"n": 2}, {"size": "0x1024"}, {"size": "10000x10000"}, {"model": "MiniMax-H3"}, {"prompt": ""}]:
+            result = self.client.post("/v1/images/generations", json={**self.image_payload(), **update}, headers=self.headers)
+            self.assertEqual(result.status_code, 400)
+        self.assertTrue(all(r.method == 'GET' and r.url.path in {'/v1/models', '/health', '/v1/providers'} for r in self.calls))
+
+    def test_image_job_cannot_be_polled_as_video(self):
+        self.client.post("/v1/images/generations", json=self.image_payload(), headers=self.headers)
+        self.assertEqual(self.client.get("/v2/query/video_generation/image-job", headers=self.headers).status_code, 404)
+        self.assertEqual(self.client.get("/v1/images/task/unknown", headers=self.headers).status_code, 404)
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)
diff --git a/model-bridge/test_current_adapter.cjs b/model-bridge/test_current_adapter.cjs
new file mode 100644
index 0000000..c70c941
--- /dev/null
+++ b/model-bridge/test_current_adapter.cjs
@@ -0,0 +1,20 @@
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const esbuild = require('../huobao-source/desktop/node_modules/esbuild');
+const out = path.resolve(__dirname,'../integration-work/test-local-adapter.cjs');
+esbuild.buildSync({entryPoints:[path.resolve(__dirname,'../huobao-source/backend/src/services/adapters/local-video.ts')],outfile:out,bundle:true,platform:'node',format:'cjs'});
+const {LocalVideoAdapter} = require(out);
+const a = new LocalVideoAdapter();
+const cfg={id:1,provider:'localvideo',baseUrl:'http://example.test',apiKey:'test-key'};
+const record={prompt:'A mountain lake.',duration:5,aspectRatio:'16:9',resolution:'720p'};
+for(const model of ['MiniMax-H3','MiniMax-H3-Hybrid','MiniMax-H3-R2V-4Step','LTX-2.3','LTX-2.3-Text-Preserve','Wan2.2-I2V']) {
+  const r=a.buildGenerateRequest(cfg,{...record,model});
+  assert.equal(r.body.model,model); assert.equal(r.body.resolution,'720P');
+  assert.equal(r.url,'http://example.test/v2/video_generation');
+}
+const hd=a.buildGenerateRequest(cfg,{...record,model:'MiniMax-H3-VDN-H3',resolution:'4K',seed:41});
+assert.equal(hd.body.model,'MiniMax-H3-VDN-H3'); assert.equal(hd.body.resolution,'4K');assert.equal(hd.body.seed,41);
+assert.throws(()=>a.buildGenerateRequest(cfg,{...record,model:'LTX-2.3',resolution:'4K'}));
+assert.throws(()=>a.buildGenerateRequest(cfg,{...record,model:'not-a-model'}));
+assert.equal(a.parsePollResponse({task:{status:'succeeded',content:{url:'http://example.test/result.mp4'}}}).status,'completed');
+console.log('PASS: six existing models and dedicated VDN 4K request/polling');
diff --git a/model-bridge/test_desktop_video.cjs b/model-bridge/test_desktop_video.cjs
new file mode 100644
index 0000000..3b0d800
--- /dev/null
+++ b/model-bridge/test_desktop_video.cjs
@@ -0,0 +1,45 @@
+const fs = require('node:fs');
+const vm = require('node:vm');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const work = path.join(__dirname, '../integration-work');
+const source = fs.readFileSync(path.join(work, 'backend.multivideo.mjs'), 'utf8');
+function functionSource(name) {
+  const start = source.indexOf(`function ${name}(`);
+  const end = source.indexOf('\n}', start) + 2;
+  assert.ok(start >= 0 && end > start);
+  return source.slice(start, end);
+}
+const context = vm.createContext({URL});
+vm.runInContext(`
+const DEFAULT_MODEL2 = 'MiniMax-H3';
+const PROMPT_MAX_CHARS = 7000;
+const REF_LIMITS2 = {images:9, videos:3, audios:3, total:12};
+const VALID_RATIOS = new Set(['16:9','9:16','1:1','4:3','3:4','21:9']);
+${functionSource('normalizeSegment')}
+${functionSource('joinProviderUrl')}
+${functionSource('parseUrlArray2')}
+${fs.readFileSync(path.join(work, 'local-video-adapter.js'), 'utf8')}
+this.adapter = new LocalVideoAdapter();`, context);
+const config = {baseUrl:'http://pool.test',apiKey:'test-secret'};
+for (const model of ['MiniMax-H3','MiniMax-H3-Hybrid','MiniMax-H3-R2V-4Step','LTX-2.3','LTX-2.3-Text-Preserve','Wan2.2-I2V']) {
+  const request = context.adapter.buildGenerateRequest(config, {model,prompt:'A mountain.',duration:5,resolution:'720p',aspectRatio:'9:16'});
+  assert.equal(request.url,'http://pool.test/v2/video_generation');
+  assert.equal(request.body.model,model);
+  assert.equal(request.body.resolution,'720P');
+  assert.equal(request.body.ratio,'9:16');
+}
+const portrait = context.adapter.buildGenerateRequest(config, {model:'Wan2.2-I2V',prompt:'Move.',firstFrameUrl:'data:image/png;base64,AA==',duration:5});
+assert.equal(portrait.body.content[1].role,'first_frame');
+assert.ok(!('ratio' in portrait.body));
+assert.throws(() => context.adapter.buildGenerateRequest(config, {model:'unknown'}), /Unknown local video model/);
+assert.throws(() => context.adapter.buildGenerateRequest(config, {model:'LTX-2.3',referenceLinkUrl:'https://example.test'}), /image references/);
+const jid = 'Z3B1Mzpqb2I';
+assert.equal(context.adapter.buildPollRequest(config,jid).url,`http://pool.test/v2/query/video_generation/${jid}`);
+assert.equal(context.adapter.parseGenerateResponse({task_id:jid}).taskId,jid);
+assert.equal(context.adapter.parsePollResponse({task:{status:'failed',error:'sampler failed'}}).status,'failed');
+assert.equal(context.adapter.parsePollResponse({task:{status:'succeeded',content:{url:'https://pool.test/video.mp4'}}}).videoUrl,'https://pool.test/video.mp4');
+assert.ok(source.includes('video: ["volcengine", "minimax", "aliyun", "localvideo"]'));
+assert.ok(source.includes('localvideo: new LocalVideoAdapter()'));
+assert.ok(source.includes('if (p === "openai" || p === "localvideo")'));
+console.log('Desktop adapter: all 6 model requests, image mode, validation and polling passed.');
diff --git a/model-bridge/test_gpu_config.py b/model-bridge/test_gpu_config.py
new file mode 100644
index 0000000..8e661a9
--- /dev/null
+++ b/model-bridge/test_gpu_config.py
@@ -0,0 +1,15 @@
+import json,sqlite3,urllib.request,urllib.error
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+dbfile=root/'integration-work/hd-test-gpu/huobao.sqlite3'
+assert dbfile.is_file() and dbfile.parent.name=='hd-test-gpu'
+with sqlite3.connect(dbfile) as db:db.execute('UPDATE ai_service_configs SET settings=? WHERE id=6',(json.dumps({'temperature':0.8,'custom_value':'keep','gpu':'gpu1'}),))
+base='http://127.0.0.1:18882/api/v1/ai-configs/6'
+def put(body):
+ req=urllib.request.Request(base,data=json.dumps(body).encode(),headers={'Content-Type':'application/json'},method='PUT')
+ with urllib.request.urlopen(req) as r:assert r.status==200
+put({'gpu':'gpu3'})
+with sqlite3.connect(dbfile) as db:assert json.loads(db.execute('SELECT settings FROM ai_service_configs WHERE id=6').fetchone()[0])=={'temperature':0.8,'custom_value':'keep','gpu':'gpu3'}
+put({'temperature':None,'gpu':'auto'})
+with sqlite3.connect(dbfile) as db:assert json.loads(db.execute('SELECT settings FROM ai_service_configs WHERE id=6').fetchone()[0])=={'custom_value':'keep'}
+print('PASS: GPU updates preserve temperature and custom settings; clearing both removes only those fields')
diff --git a/model-bridge/test_gpu_dispatch.py b/model-bridge/test_gpu_dispatch.py
new file mode 100644
index 0000000..b0fc5e0
--- /dev/null
+++ b/model-bridge/test_gpu_dispatch.py
@@ -0,0 +1,55 @@
+"""Exercise saved GPU settings through the staged app; local mock media only."""
+import json,sqlite3,threading,time,urllib.request,shutil
+from pathlib import Path
+from http.server import BaseHTTPRequestHandler,ThreadingHTTPServer
+from email.parser import BytesParser
+from email import policy
+root=Path(__file__).resolve().parent.parent;test=root/'integration-work/hd-test-gpu'
+assert test.name=='hd-test-gpu'
+base='http://127.0.0.1:18882/api/v1';calls=[]
+(test/'static/images').mkdir(exist_ok=True)
+shutil.copy2(root/'integration-work/pinned-images-gpu1.png',test/'static/images/reference.png')
+def api(path,body=None,method=None):
+ r=urllib.request.Request(base+path,data=json.dumps(body).encode() if body is not None else None,headers={'Content-Type':'application/json'},method=method)
+ with urllib.request.urlopen(r,timeout=30) as response:return json.load(response)['data']
+class Handler(BaseHTTPRequestHandler):
+ def log_message(self,*args):pass
+ def do_GET(self):
+  file={'/image.png':root/'integration-work/pinned-images-gpu1.png','/video.mp4':test/'static/videos/hd-test-original.mp4','/hd.mp4':root/'integration-work/hd-test-alignment/2K.mp4'}[self.path]
+  data=file.read_bytes();self.send_response(200);self.send_header('Content-Length',str(len(data)));self.end_headers();self.wfile.write(data)
+ def do_POST(self):
+  raw=self.rfile.read(int(self.headers['Content-Length']));ctype=self.headers.get('Content-Type','')
+  if ctype.startswith('multipart/'):
+   msg=BytesParser(policy=policy.default).parsebytes(('Content-Type: '+ctype+'\r\n\r\n').encode()+raw)
+   body={p.get_param('name',header='content-disposition'):p.get_payload(decode=True).decode() for p in msg.iter_parts() if not p.get_filename()}
+  else:body=json.loads(raw)
+  calls.append((self.path,body.get('gpu')))
+  name='/image.png' if '/images/' in self.path else '/hd.mp4' if body['model']=='MiniMax-H3-VDN-H3' else '/video.mp4'
+  url='http://127.0.0.1:18880'+name
+  payload={'data':[{'url':url}]} if name.endswith('.png') else {'video_url':url,'duration':4}
+  data=json.dumps(payload).encode();self.send_response(200);self.send_header('Content-Type','application/json');self.end_headers();self.wfile.write(data)
+server=ThreadingHTTPServer(('127.0.0.1',18880),Handler);threading.Thread(target=server.serve_forever,daemon=True).start()
+with sqlite3.connect(test/'huobao.sqlite3') as db:
+ saved=db.execute('SELECT id,base_url,settings,is_active FROM ai_service_configs WHERE id IN (4,6,10,11)').fetchall()
+ db.execute('UPDATE ai_service_configs SET is_active=0 WHERE id=11')
+def wait(tid):
+ for _ in range(80):
+  d=api('/tasks/'+str(tid)+'/diagnostics')
+  if d['status']!='processing':assert d['status']=='completed',d;return
+  time.sleep(.25)
+ raise AssertionError('mock task timed out')
+try:
+ for gpu,refs in [('gpu1',[]),('gpu3',['static/images/reference.png'])]:
+  api('/ai-configs/6',{'base_url':'http://127.0.0.1:18880','gpu':gpu},'PUT')
+  t=api('/tasks',{'type':'image','config_id':6,'model':'qwen_image_2_1','prompt':'A teacup.','size':'512x512','reference_images':refs});wait(t['id'])
+ api('/ai-configs/4',{'base_url':'http://127.0.0.1:18880','gpu':'gpu2'},'PUT')
+ t=api('/tasks',{'type':'video','config_id':4,'model':'MiniMax-H3','prompt':'A quiet lake.','duration':4,'aspect_ratio':'16:9'});wait(t['id'])
+ api('/ai-configs/10',{'base_url':'http://127.0.0.1:18880','gpu':'gpu3'},'PUT')
+ t=api('/hd/storyboards/1',{'resolution':'2K'});wait(t['id'])
+ assert calls==[('/v1/images/generations','gpu1'),('/v1/images/edits','gpu3'),('/v2/video_generation','gpu2'),('/v2/video_generation','gpu3')],calls
+ (root/'integration-work/gpu-dispatch-test.json').write_text(json.dumps({'passed':True,'requests':calls},indent=2))
+ print('PASS: saved settings reach text-to-image, reference-image, MiniMax video and VDN HD requests')
+finally:
+ server.shutdown()
+ with sqlite3.connect(test/'huobao.sqlite3') as db:
+  for id,url,settings,active in saved:db.execute('UPDATE ai_service_configs SET base_url=?,settings=?,is_active=? WHERE id=?',(url,settings,active,id))
diff --git a/model-bridge/test_gpu_regeneration.py b/model-bridge/test_gpu_regeneration.py
new file mode 100644
index 0000000..bd0526e
--- /dev/null
+++ b/model-bridge/test_gpu_regeneration.py
@@ -0,0 +1,131 @@
+"""Isolated HTTP integration: exact cancellation, GPU override, races and history."""
+import concurrent.futures, hashlib, json, sqlite3, threading, time, urllib.error, urllib.request, os
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+from pathlib import Path
+
+root = Path(__file__).resolve().parent.parent
+data = root / 'integration-work' / os.environ.get('HUOBAO_TEST_FOLDER','hd-test-regenerate')
+assert data.name.startswith('hd-test') and data.resolve().is_relative_to(root/'integration-work')
+base = 'http://127.0.0.1:'+os.environ.get('HUOBAO_TEST_PORT','18883')+'/api/v1'
+dbpath = data / 'huobao.sqlite3'
+calls, jobs = [], {}
+cancel_mode = 'delay'
+
+def api(path, body=None):
+    req = urllib.request.Request(base + path, data=json.dumps(body).encode() if body is not None else None, headers={'Content-Type':'application/json'})
+    try:
+        with urllib.request.urlopen(req, timeout=65) as r: return r.status, json.load(r)
+    except urllib.error.HTTPError as e: return e.code, json.load(e)
+
+def sql(query, params=()):
+    with sqlite3.connect(dbpath) as db:
+        db.row_factory = sqlite3.Row
+        return [dict(r) for r in db.execute(query, params).fetchall()]
+
+class Handler(BaseHTTPRequestHandler):
+    def log_message(self, *args): pass
+    def reply(self, payload, status=200):
+        raw=json.dumps(payload).encode(); self.send_response(status); self.send_header('Content-Type','application/json'); self.end_headers(); self.wfile.write(raw)
+    def do_POST(self):
+        body=json.loads(self.rfile.read(int(self.headers.get('Content-Length',0))) or '{}')
+        calls.append((self.path, body))
+        if self.path.endswith('/cancel'):
+            jid=self.path.split('/')[-2]
+            if cancel_mode=='error': return self.reply({'error':'cancel unavailable'},503)
+            if cancel_mode=='finished': return self.reply({'task':{'id':jid,'status':'succeeded'}})
+            jobs[jid]['cancelled_at']=time.monotonic()+2
+            return self.reply({'task':{'id':jid,'status':'running'}})
+        assert self.path=='/v2/video_generation',self.path
+        jid='mock-'+str(len(jobs)+1)
+        jobs[jid]={'status':'running', 'body':body}
+        gpu=body.get('gpu','gpu2')
+        routing={'gpu':gpu,'port':{'gpu1':8189,'gpu2':8188,'gpu3':8191}[gpu], 'providerId':{'gpu1':'gpu1_8189','gpu2':'default','gpu3':'gpu3'}[gpu], 'legacy':False}
+        jobs[jid]['routing']=routing
+        return self.reply({'task_id':jid,'routing':routing})
+    def do_GET(self):
+        if self.path.endswith('.mp4'):
+            p=root/'integration-work/hd-test-alignment/2K.mp4' if self.path=='/hd.mp4' else data/'static/videos/hd-test-original.mp4'
+            raw=p.read_bytes(); self.send_response(200); self.send_header('Content-Type','video/mp4'); self.send_header('Content-Length',str(len(raw))); self.end_headers(); self.wfile.write(raw); return
+        jid=self.path.split('/')[-1]; job=jobs[jid]
+        if job.get('cancelled_at',float('inf'))<=time.monotonic():job['status']='cancelled'
+        task={'id':jid,'status':job['status'],'duration':4,'routing':job['routing']}
+        if job['status']=='succeeded':task['content']={'url':'http://127.0.0.1:18884/'+('hd.mp4' if job['body']['model']=='MiniMax-H3-VDN-H3' else 'video.mp4')}
+        return self.reply({'task':task})
+
+def row(tid):return sql('SELECT * FROM sys_task WHERE id=?',(tid,))[0]
+def wait(tid, predicate):
+    for _ in range(100):
+        r=row(tid)
+        if predicate(r): return r
+        time.sleep(.2)
+    raise AssertionError(('timeout',tid,row(tid)['status']))
+def payload(**kw):return {'type':'video','storyboard_id':1,'config_id':4,'model':'MiniMax-H3','gpu':'gpu1','prompt':'A quiet lake.','duration':4,'aspect_ratio':'16:9','force_new':True,**kw}
+
+server=ThreadingHTTPServer(('127.0.0.1',18884),Handler)
+threading.Thread(target=server.serve_forever,daemon=True).start()
+with sqlite3.connect(dbpath) as db:
+    db.execute("UPDATE ai_service_configs SET base_url='http://127.0.0.1:18884' WHERE service_type IN ('video','image')")
+    db.execute("UPDATE ai_service_configs SET settings=? WHERE id=4",(json.dumps({'gpu':'gpu2'}),))
+    db.execute("UPDATE ai_service_configs SET is_active=0 WHERE name='VDN test'")
+    db.execute('UPDATE dramas SET deleted_at=NULL WHERE id=1')
+    db.execute('UPDATE episodes SET deleted_at=NULL WHERE id=1')
+
+original=data/'static/videos/hd-test-original.mp4'; digest=hashlib.sha256(original.read_bytes()).hexdigest()
+try:
+    code,result=api('/tasks',payload()); assert code==201,result
+    old=result['data']['id']; oldrow=wait(old,lambda r:bool(r['task_id'])); jid=oldrow['task_id']
+    assert jobs[jid]['body']['gpu']=='gpu1'
+    before=len(calls)
+    for change in ({'gpu':'gpu0'}, {'model':'unsupported'}, {'config_id':999999}, {'replace_task_id':old+999}):
+        code,_=api('/tasks',payload(replace_task_id=old,**change)) if 'replace_task_id' not in change else api('/tasks',payload(**change))
+        assert code==400,(change,code)
+    assert len(calls)==before and row(old)['status']=='processing'
+    # Place the real background poll inside the cancellation window.
+    time.sleep(8)
+    with concurrent.futures.ThreadPoolExecutor() as pool:
+        first=pool.submit(api,'/tasks',payload(gpu='gpu3',replace_task_id=old))
+        time.sleep(.2)
+        duplicate=api('/tasks',payload(gpu='gpu2',replace_task_id=old))
+        code,result=first.result()
+    assert code==201,result
+    assert duplicate[0]==400,duplicate
+    new=result['data']['id']; nr=wait(new,lambda r:bool(r['task_id']))
+    assert jobs[jid]['status']=='cancelled'
+    assert row(old)['error_code']=='user_cancelled'
+    assert jobs[nr['task_id']]['body']['gpu']=='gpu3'
+    assert json.loads(nr['params'])['routing']['port']==8191
+    assert json.loads(nr['params'])['replacesTaskId']==old
+    assert json.loads(sql('SELECT settings FROM ai_service_configs WHERE id=4')[0]['settings'])['gpu']=='gpu2'
+    count=len(calls); assert api('/tasks',payload(replace_task_id=old))[0]==400; assert len(calls)==count
+    assert api('/tasks/'+str(old)+'/recover',{})[0]==400
+    jobs[nr['task_id']]['status']='succeeded'; wait(new,lambda r:r['status']=='completed')
+    assert json.loads(row(new)['params'])['routing']['gpu']=='gpu3'
+    assert api('/tasks/'+str(new))[1]['data']['routing']['port']==8191
+    assert row(old)['error_code']=='user_cancelled'
+    # Cancellation failure and a completed-upstream race must not create replacements.
+    for mode in ('error','finished'):
+        code,result=api('/tasks',payload()); assert code==201,result
+        tid=result['data']['id']; tr=wait(tid,lambda r:bool(r['task_id']))
+        cancel_mode=mode; count=len(jobs)
+        code,result=api('/tasks',payload(gpu='gpu2',replace_task_id=tid)); assert code==400,result
+        assert len(jobs)==count and row(tid)['status']=='processing'
+        jobs[tr['task_id']]['status']='failed'
+        wait(tid,lambda r:r['status']=='failed')
+    # Fixed HD config + per-request override reaches the model, original stays intact.
+    cancel_mode='delay'
+    with sqlite3.connect(dbpath) as db:db.execute('UPDATE storyboards SET video_url=? WHERE id=1',('static/videos/hd-test-original.mp4',))
+    config=next(c for c in api('/ai-configs')[1]['data'] if c['name'].startswith('MiniMax H3-VDN-H3 高清 2K/4K · GPU1'))
+    code,result=api('/hd/storyboards/1',{'resolution':'2K','config_id':config['id'],'gpu':'gpu3'})
+    assert code==201,result
+    tid=result['data']['id']; tr=wait(tid,lambda r:bool(r['task_id']))
+    assert jobs[tr['task_id']]['body']['gpu']=='gpu3'
+    jobs[tr['task_id']]['status']='succeeded';wait(tid,lambda r:r['status']=='completed')
+    hd=api('/hd/episodes/1')[1]['data']; shot=next(s for s in hd['items'] if s['id']==1)
+    assert shot['current']=='static/videos/hd-test-original.mp4'
+    assert shot['original']=='static/videos/hd-test-original.mp4'
+    assert len(hd['configs'])==4 and shot['versions'][-1]['gpu']=='gpu3'
+    assert hashlib.sha256(original.read_bytes()).hexdigest()==digest
+    result={'passed':True,'checks':['explicit GPU override','invalid replacement never cancels','targeted cancel confirmed before submission','double click guarded','stale replacement rejected','cancel failure no new task','completion race no new task','cancelled record cannot recover','HD config and override','original media preserved'], 'jobs':len(jobs)}
+    (root/'integration-work/gpu-regeneration-test.json').write_text(json.dumps(result,indent=2))
+    print(json.dumps(result))
+finally:server.shutdown()
diff --git a/model-bridge/test_hd_integration.py b/model-bridge/test_hd_integration.py
new file mode 100644
index 0000000..f77f07e
--- /dev/null
+++ b/model-bridge/test_hd_integration.py
@@ -0,0 +1,98 @@
+"""Exercise the staged application against local media fixtures, never production data."""
+import hashlib,json,sqlite3,subprocess,threading,time,urllib.request,urllib.error,os
+from http.server import BaseHTTPRequestHandler,ThreadingHTTPServer
+from pathlib import Path
+ROOT=Path(__file__).resolve().parent.parent
+TEST=ROOT/'integration-work'/os.environ.get('HUOBAO_TEST_FOLDER','hd-test')
+assert TEST.resolve().is_relative_to(ROOT/'integration-work')
+FIXTURE=json.loads((TEST/'fixture.json').read_text())
+BASE='http://127.0.0.1:'+os.environ.get('HUOBAO_TEST_PORT','18879')+'/api/v1'
+BIN=ROOT/'integration-work/stage-4.0.11/app/resources/bin'
+def api(path,body=None):
+    req=urllib.request.Request(BASE+path,data=json.dumps(body).encode() if body is not None else None,headers={'Content-Type':'application/json'})
+    try:
+        with urllib.request.urlopen(req,timeout=30) as r: return json.load(r)['data']
+    except urllib.error.HTTPError as e: raise RuntimeError(e.read().decode())
+def connect(): return sqlite3.connect(TEST/'huobao.sqlite3')
+def probe(path):
+    meta=json.loads(subprocess.check_output([str(BIN/'ffprobe.exe'),'-v','error','-show_streams','-of','json',str(path)],creationflags=0x08000000))
+    s=next(s for s in meta['streams'] if s['codec_type']=='video')
+    return s['width'],s['height']
+for label,size in [('2K','2560x1440'),('4K','3840x2176')]:
+    target=TEST/(label+'.mp4')
+    if not target.exists() or probe(target)!=tuple(map(int,size.split('x'))):
+        subprocess.run([str(BIN/'ffmpeg.exe'),'-y','-hide_banner','-loglevel','error','-f','lavfi','-i',f'color=c=0x456789:s={size}:r=24:d=1',
+            '-c:v','libx264','-preset','ultrafast','-pix_fmt','yuv420p',str(target)],check=True,creationflags=0x08000000)
+calls=[]
+bad=False
+class Handler(BaseHTTPRequestHandler):
+    def log_message(self,*args):pass
+    def answer(self,data):
+        self.send_response(200);self.send_header('Content-Type','application/json');self.end_headers();self.wfile.write(json.dumps(data).encode())
+    def do_POST(self):
+        body=json.loads(self.rfile.read(int(self.headers['Content-Length'])))
+        calls.append(body)
+        self.answer({'status':'succeeded','video_url':'http://127.0.0.1:18880/'+('2K' if bad else body['resolution'])+'.mp4','duration':4})
+    def do_GET(self):
+        if self.path=='/v1/models': return self.answer({'data':[{'id':'MiniMax-H3-VDN-H3'}]})
+        name=self.path.lstrip('/')
+        if name not in ('2K.mp4','4K.mp4'): self.send_error(404);return
+        data=(TEST/name).read_bytes()
+        self.send_response(200);self.send_header('Content-Type','video/mp4');self.send_header('Content-Length',str(len(data)));self.end_headers();self.wfile.write(data)
+server=ThreadingHTTPServer(('127.0.0.1',18880),Handler)
+threading.Thread(target=server.serve_forever,daemon=True).start()
+with connect() as db:
+    cfgid=db.execute("SELECT id FROM ai_service_configs WHERE model LIKE '%VDN-H3%' ORDER BY id DESC LIMIT 1").fetchone()[0]
+    db.execute("UPDATE ai_service_configs SET is_active=0 WHERE model LIKE '%VDN-H3%' AND id!=?",(cfgid,))
+    db.execute('UPDATE ai_service_configs SET base_url=?,is_active=1 WHERE id=?',('http://127.0.0.1:18880',cfgid))
+    assert db.execute("SELECT COUNT(*) FROM ai_service_configs WHERE is_active=1 AND model LIKE '%VDN-H3%' AND base_url!='http://127.0.0.1:18880'").fetchone()[0]==0
+sid=FIXTURE['storyboard']; eid=FIXTURE['episode']; original=FIXTURE['original']
+sha=hashlib.sha256((TEST/original).read_bytes()).hexdigest()
+def wait_task(tid):
+    for _ in range(60):
+        data=api('/tasks/'+str(tid)+'/diagnostics')
+        if data['status']!='processing':return data
+        time.sleep(0.5)
+    raise AssertionError('task timed out')
+try:
+    complete=[]
+    for resolution,size in [('2K',(2560,1440)),('4K',(3840,2160))]:
+        tid=api(f'/hd/storyboards/{sid}',{'resolution':resolution})['id']
+        result=wait_task(tid)
+        assert result['status']=='completed',result
+        with connect() as db:
+            assert db.execute('SELECT video_url FROM storyboards WHERE id=?',(sid,)).fetchone()[0]==original
+            video=db.execute('SELECT local_path FROM sys_task WHERE id=?',(tid,)).fetchone()[0]
+        assert probe(TEST/video)==size
+        complete.append((tid,video))
+    listing=api(f'/hd/episodes/{eid}')
+    shot=next(s for s in listing['items'] if s['id']==sid)
+    assert shot['original']==original and shot['current']==original
+    assert all(v['error'] is None for v in shot['versions'] if v['status']=='completed')
+    api(f'/hd/storyboards/{sid}/select',{'task_id':complete[1][0]})
+    with connect() as db: assert db.execute('SELECT video_url FROM storyboards WHERE id=?',(sid,)).fetchone()[0]==complete[1][1]
+    api(f'/hd/storyboards/{sid}/select',{'original':True})
+    bad=True
+    tid=api(f'/hd/storyboards/{sid}',{'resolution':'4K'})['id']
+    assert wait_task(tid)['status']=='failed'
+    try: api(f'/hd/storyboards/{sid}/select',{'task_id':tid})
+    except RuntimeError:pass
+    else:raise AssertionError('failed low-resolution output was selectable')
+    assert hashlib.sha256((TEST/original).read_bytes()).hexdigest()==sha
+    assert all(c['model']=='MiniMax-H3-VDN-H3' and c['content'][1]['role']=='reference_image' and c['content'][1]['image_url']['url'].startswith('data:') for c in calls)
+    with connect() as db:
+        second=db.execute('SELECT id FROM storyboards WHERE episode_id=? AND id!=? ORDER BY id LIMIT 1',(eid,sid)).fetchone()[0]
+        db.execute('UPDATE storyboards SET video_url=? WHERE id=?',(complete[1][1],second))
+    merge=api(f'/merge/episodes/{eid}/merge',{'storyboard_ids':[sid,second]})
+    merge_id=merge.get('merge_id') or merge.get('id')
+    for _ in range(90):
+        with connect() as db: row=db.execute('SELECT status,merged_url,error_msg FROM video_merges WHERE id=?',(merge_id,)).fetchone()
+        if row and row[0]!='processing':break
+        time.sleep(1)
+    assert row and row[0]=='completed',row
+    assert probe(TEST/row[1])==(3840,2160)
+    (TEST/'test-results.json').write_text(json.dumps({'passed':True,'checks':['2K delivery','4K delivery','original remains unchanged','select and restore export version','wrong output size rejected','mixed resolution export keeps 4K'],'complete':complete,'original_sha256':sha},indent=2))
+    print('PASS: 2K/4K delivery, preserved original, version switching, wrong-size rejection and mixed-size 4K export')
+finally:
+    with connect() as db: db.execute('UPDATE ai_service_configs SET base_url=? WHERE id=?',('http://192.168.110.111:18794',cfgid))
+    server.shutdown()
diff --git a/model-bridge/test_persistent_data.cjs b/model-bridge/test_persistent_data.cjs
new file mode 100644
index 0000000..4a1313d
--- /dev/null
+++ b/model-bridge/test_persistent_data.cjs
@@ -0,0 +1,24 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const vm = require('node:vm');
+const assert = require('node:assert/strict');
+const source = fs.readFileSync(process.argv[2] || path.join(__dirname, '../huobao-source/desktop/dist/main.js'),'utf8');
+function extract(name) {
+  const start = source.indexOf(`function ${name}(`);
+  return source.slice(start,source.indexOf('\n}',start)+2);
+}
+let config = null;
+const context = vm.createContext({
+  path5:path.win32,
+  process:{resourcesPath:'D:\\web\\dj\\HuobaoDrama\\resources'},
+  import_electron3:{app:{isPackaged:true,getPath:()=> 'C:\\Users\\pc\\AppData\\Roaming\\HuobaoDrama'}},
+  fs5:{existsSync:()=>config!==null,readFileSync:()=>config,mkdirSync:()=>{}},
+  console:{warn:()=>{}}
+});
+vm.runInContext(`const STORAGE_CONFIG_FILE='storage-config.json';${extract('storageConfigPath')}\n${extract('loadStorageConfig')}\nthis.load=loadStorageConfig;`,context);
+assert.equal(context.load(),'D:\\web\\dj\\huobao-data');
+config='{bad json';
+assert.equal(context.load(),'D:\\web\\dj\\huobao-data');
+config=JSON.stringify({version:1,dataDir:'E:\\MyDramaData'});
+assert.equal(context.load(),'E:\\MyDramaData');
+console.log('Persistent data: fresh profile, invalid profile config and custom directory passed.');
diff --git a/model-bridge/verify_cancel_bridges.py b/model-bridge/verify_cancel_bridges.py
new file mode 100644
index 0000000..3ac4737
--- /dev/null
+++ b/model-bridge/verify_cancel_bridges.py
@@ -0,0 +1,13 @@
+import json,urllib.error,urllib.request
+from pathlib import Path
+token=json.loads((Path(__file__).resolve().parent/'client.json').read_text())['token']
+for port in (18792,18794):
+ base=f'http://192.168.110.111:{port}'
+ for authorized in (False,True):
+  headers={'Authorization':'Bearer '+token} if authorized else {}
+  req=urllib.request.Request(base+'/v2/video_generation/huobao-nonexistent-verification-id/cancel',data=b'{}',headers=headers,method='POST')
+  try:urllib.request.urlopen(req,timeout=10);raise AssertionError('Unknown job accepted')
+  except urllib.error.HTTPError as e:assert e.code==(404 if authorized else 401),(port,e.code)
+ req=urllib.request.Request(base+'/v1/models',headers={'Authorization':'Bearer '+token})
+ with urllib.request.urlopen(req,timeout=20) as r: models=json.load(r)
+ print(json.dumps({'port':port,'auth_required':True,'unknown_cancel_rejected':True,'models_available':len(models['data'])}))
diff --git a/model-bridge/verify_gpu_release.py b/model-bridge/verify_gpu_release.py
new file mode 100644
index 0000000..56731a6
--- /dev/null
+++ b/model-bridge/verify_gpu_release.py
@@ -0,0 +1,24 @@
+import json,sqlite3,urllib.request
+from pathlib import Path
+root=Path(__file__).resolve().parent.parent
+before=json.loads((root/'integration-work/before-switch-final.json').read_text())
+after=json.loads((root/'integration-work/after-switch.json').read_text())
+assert before==after,'Data changed across restart; inspect the audit'
+with sqlite3.connect(root/'integration-work/backups/upgrade-20261106-172956/huobao-data/huobao.sqlite3') as old,sqlite3.connect(root/'huobao-data/huobao.sqlite3') as current:
+ old.row_factory=current.row_factory=sqlite3.Row
+ originals=[dict(r) for r in old.execute('SELECT * FROM ai_service_configs')]
+ now={r['id']:dict(r) for r in current.execute('SELECT * FROM ai_service_configs')}
+ assert all(now[r['id']]==r for r in originals)
+ assert len(now)==len(originals)+18
+ variants=[r for r in now.values() if json.loads(r['settings'] or '{}').get('gpu_variant_source')]
+ assert len(variants)==18
+ for sid in (4,6,7,8,9,10):
+  assert {json.loads(r['settings'])['gpu'] for r in variants if json.loads(r['settings']).get('gpu_variant_source')==sid}=={'gpu1','gpu2','gpu3'}
+ summary={'passed':True,'original_configs_unchanged':len(originals),'fixed_gpu_configs':len(variants),
+          'projects':after['tables']['dramas']['count'],'styles':after['tables']['style_presets']['count'],'media_files_preserved':len(after['media'])}
+base=json.loads((root/'huobao-data/last-launch.json').read_text())['api']
+with urllib.request.urlopen(base+'/ai-configs',timeout=10) as response:configs=json.load(response)['data']
+assert len(configs)==28
+summary['live_api_configs']=len(configs)
+(root/'integration-work/gpu-release-verification.json').write_text(json.dumps(summary,indent=2))
+print(json.dumps(summary))
diff --git a/model-bridge/verify_real_hd.py b/model-bridge/verify_real_hd.py
new file mode 100644
index 0000000..100cbaa
--- /dev/null
+++ b/model-bridge/verify_real_hd.py
@@ -0,0 +1,35 @@
+"""Verify the completed isolated GPU outputs without submitting or touching user projects."""
+from pathlib import Path
+import hashlib,json,sqlite3,subprocess,urllib.request
+
+root=Path(__file__).resolve().parent.parent
+test=root/'integration-work/hd-test'
+api='http://127.0.0.1:18879/api/v1'
+with sqlite3.connect(test/'huobao.sqlite3') as db:
+    rows=db.execute('SELECT id,status,local_path,created_at,updated_at FROM sys_task WHERE id IN (86,87) ORDER BY id').fetchall()
+    if any(row[1]!='completed' for row in rows):
+        print(json.dumps({'ready':False,'tasks':[[r[0],r[1]] for r in rows]}))
+        raise SystemExit(2)
+    fixture=json.loads((test/'fixture.json').read_text())
+    original=db.execute('SELECT video_url FROM storyboards WHERE id=?',(fixture['storyboard'],)).fetchone()[0]
+    assert original==fixture['original'], 'HD must not replace the original automatically'
+
+report={'passed':True,'original_sha256':hashlib.sha256((test/original).read_bytes()).hexdigest(),'outputs':[]}
+assert report['original_sha256']=='16ea40eaca50ef6d1572123aa6252ca2615c288ece2f7f6bfcb2326526b6ec14'
+for row,expected in zip(rows,[(2560,1440),(3840,2160)]):
+    raw=subprocess.check_output([str(root/'HuobaoDrama/resources/bin/ffprobe.exe'),'-v','error','-show_streams','-show_format','-of','json',str(test/row[2])],creationflags=0x08000000)
+    info=json.loads(raw); stream=next(s for s in info['streams'] if s['codec_type']=='video')
+    assert (stream['width'],stream['height'])==expected, (row[0],stream['width'],stream['height'])
+    report['outputs'].append({'task':row[0],'file':str(test/row[2]),'width':stream['width'],'height':stream['height'],'duration':info['format']['duration'],'fps':stream['r_frame_rate'],'created':row[3],'completed':row[4]})
+
+def select(body):
+    req=urllib.request.Request(f"{api}/hd/storyboards/{fixture['storyboard']}/select",data=json.dumps(body).encode(),headers={'Content-Type':'application/json'})
+    with urllib.request.urlopen(req,timeout=30) as response: return json.load(response)['data']['video_url']
+
+try:
+    assert select({'task_id':87})==rows[1][2]
+finally:
+    assert select({'original':True})==fixture['original']
+report['version_switch_and_restore']=True
+(root/'integration-work/real-hd-verification.json').write_text(json.dumps(report,indent=2),encoding='utf-8')
+print(json.dumps(report,ensure_ascii=False))
diff --git a/model-bridge/接入说明.txt b/model-bridge/接入说明.txt
new file mode 100644
index 0000000..8fd369d
--- /dev/null
+++ b/model-bridge/接入说明.txt
@@ -0,0 +1,70 @@
+火宝短剧模型接入（更新于 2026-11-06）
+
+DeepSeek：默认文本模型，模型名 deepseek-chat，官方接口。已完成真实回复测试。
+Qwen（Dify）：原有 Dify 应用，通过兼容入口提供文本和流式回复。
+OpenAI（Dify）：原有 Dify 应用，通过兼容入口提供文本和流式回复。
+Qwen Image 2.1（默认图片·三卡可选）：服务器本地图片工作流，支持文生图及最多六张参考图编辑。
+已通过火宝实际生成 512×512 图片，并用该图完成改色编辑，PNG 下载及保存均验证通过。
+MiniMax H3（默认视频·三卡可选）：支持文生视频、单张首帧和最多九张参考图。
+MiniMax H3 加速版：Hybrid 支持文生视频/图生视频；R2V-4Step 需要 1-9 张参考图，不支持固定首帧模式。
+LTX 2.3：文生视频或单张图生视频；Text-Preserve 版本用于保留画面中的文字。
+Wan 2.2：单张图生视频，必须提供一张图片。
+以上共 6 个视频模型选项，可在设置 → AI 服务 → 视频中点击模型设为默认，也可在生成时选择。
+Grok（本机）：使用本机 Grok CLI，通过 127.0.0.1:18793 接入；未登录时在火宝中停用。
+
+Grok 登录：双击同目录 Grok登录.cmd，按浏览器提示登录。
+登录后脚本会实际验证回复，再自动启用火宝中的 Grok；DeepSeek 保持默认。
+如果已经通过其他方式登录，运行 activate_grok.py 即可验证并启用。
+
+远端兼容服务：http://192.168.110.111:18792
+容器：huobao-model-bridge，配置及代码位于 /home/ps/huobao-model-bridge。
+容器自动重启策略：unless-stopped。只绑定服务器内网地址。
+本机 Grok 兼容服务通过当前用户的启动文件夹自动启动，后台运行。
+关闭火宝后，双击桌面「火宝短剧-一键启动」打开。
+脚本位置：D:\web\dj\一键启动火宝.cmd。
+一键启动先检查原数据库和模型配置，再保存数据库备份；数据缺失或为空时会停止并显示提示。
+数据库备份位于 D:\web\dj\huobao-data\backups；备份包含项目记录和模型配置，不复制图片、视频文件。
+重复运行会切回已打开的火宝窗口。Grok 已启用时，也会检查并启动本机 Grok 兼容服务。
+运行记录位于 D:\web\dj\huobao-data\last-launch.json。
+
+固定数据目录（2026-11-06 修复）：
+D:\web\dj\huobao-data 保存数据库、模型配置、项目及生成素材。
+AppData\Roaming\HuobaoDrama 仅保留桌面缓存、启动日志和存储目录指针。
+程序默认也指向上述 D 盘目录，即使存储指针文件缺失，也不会改为打开空的 AppData 数据库。
+本次从 2026-11-06 09:53 的数据库快照恢复「洪荒」项目，补齐多视频模型配置；13 张原图从服务器原任务取回。
+原视频任务继续查询，其中任务 14 已完成并取回视频，任务 23 沿用原任务编号查询。
+已实际关闭重开，并临时移开存储指针验证：9 条配置、1 个项目、2 集、27 个分镜保留，已完成素材无缺失。
+恢复后的完整配置数据库备份：integration-work\backups\huobao-restored-full-20261106.sqlite3。
+验证结果：persistence-after-restart.json；原图恢复清单：data-recovery-20261106.json。
+
+边界：
+1. Dify 保留原应用的系统提示词和工作流；兼容入口只接受文本消息，不提供工具调用和附件上传。
+2. H3 不支持末帧约束、参考视频、外部音色样本，或同时指定固定首帧和其他参考图；会明确报错。
+3. 本次多模型更新通过 21 项兼容服务测试、桌面适配测试、6 模型接口预检，以及两个 GPU 节点的 9 个工作流节点/模型检查。没有额外提交测试视频；原有生成任务继续查询。
+4. H3 的图片参考由火宝转换为内嵌图片数据。网络图片需先下载并导入火宝。
+5. Qwen（Dify）/ OpenAI（Dify）是文本应用；图片功能使用独立的 Qwen Image 2.1 配置。
+6. 当前服务器 Qwen 图片工作流按约一百万像素、32 像素对齐限制实际输出尺寸；较大尺寸请求会在上游按比例缩放。
+
+密钥不写入本说明；client.json 与 grok-client.json 是受权限保护的本机接入配置，不要公开分享。
+修改前的火宝数据库备份位于 D:\web\dj\integration-work\backups。
+
+多显卡调度（2026-11-06）：
+当前 GPU1、GPU2、GPU3 共同接收 Qwen 图片及原有六种视频模型任务，按队列长度和提交预约数自动选择节点。
+同一时间提交的不同任务可以分到不同 GPU；每条视频仍由一张 GPU 执行。
+任务 ID 保留原执行节点，轮询和下载始终回到该节点；节点暂不可达时不重复提交已有任务。
+GPU0 保持原服务。GPU1 新增独立 huobao-comfy-gpu1 节点，原有服务继续运行，设置 8 GiB 额外显存预留。
+在“设置 → AI 服务 → 编辑 → 使用显卡”中，按模型选择自动、GPU1、GPU2 或 GPU3。
+指定模式不自动换卡；维护、无响应或缺少 VDN 时明确拒绝提交，保留原任务和结果。
+实际检查结果见 video-pool-preflight-20261106.json；接口预检见 video-integration-20261106.json。
+
+当前桌面兼容扩展（4.0.11）：
+基于官方 4.0.11 源码构建，保留 localvideo 多模型适配器和固定数据目录，新增高清制作页面。
+MiniMax H3-VDN-H3 在独立兼容服务 192.168.110.111:18794 运行，支持按原分镜和首帧重生成 2K/4K。
+原版与高清版本分别保留，选择版本后才用于重新拼接。GPU1/GPU2/GPU3 均具备 VDN 工作流。
+Qwen 图片显卡池状态接口为 /v1/images/pool，需要原桥接令牌；同一任务的查询和下载回到原执行节点。
+请求可选 gpu=auto/gpu1/gpu2/gpu3；调度器通过 strict_provider 区分固定 GPU2 与旧的 default 自动调度。
+服务器本次配置、容器定义和历史备份位于 /home/ps/huobao-gpu-selection，目录受权限保护。
+GPU1 令牌仅原调度服务用户获得读取权限，没有开放所有用户读取；新节点仅加入 zq-platform-network。
+原 4.0.10 文件保存在 integration-work\backups\multivideo-4.0.10；patch_desktop_video.py 不可用于 4.0.11。
+后续更新需备份当前数据，将本地功能与新版源码合并测试后构建；不要直接覆盖当前数据目录。
+远端兼容服务代码的更新前备份为 /home/ps/huobao-model-bridge/bridge.py.before-multivideo-20261106。
diff --git a/一键启动火宝.cmd b/一键启动火宝.cmd
new file mode 100644
index 0000000..e953323
--- /dev/null
+++ b/一键启动火宝.cmd
@@ -0,0 +1,16 @@
+@echo off
+setlocal
+chcp 65001 >nul
+set "HUOBAO_PYTHON=%LocalAppData%\Programs\Python\Python311\python.exe"
+if not exist "%HUOBAO_PYTHON%" (
+  echo Python was not found. Please check the existing Python installation.
+  pause
+  exit /b 1
+)
+"%HUOBAO_PYTHON%" "%~dp0model-bridge\start_huobao.py" %*
+if errorlevel 1 (
+  echo.
+  pause
+  exit /b 1
+)
+exit /b 0
diff --git a/升级与高清制作说明.txt b/升级与高清制作说明.txt
new file mode 100644
index 0000000..40827c4
--- /dev/null
+++ b/升级与高清制作说明.txt
@@ -0,0 +1,59 @@
+火宝短剧本地安装：4.0.11（附本地模型池和高清制作功能）
+
+启动：双击桌面的“火宝短剧-一键启动”，或 D:\web\dj\一键启动火宝.cmd。
+数据：D:\web\dj\huobao-data。数据库、项目和素材始终使用这个目录。
+程序：D:\web\dj\HuobaoDrama。不要把数据目录当作程序目录清理。
+一键启动每次都会检查数据库，并备份到 huobao-data\backups。
+若数据库缺失，新版会停止启动并提示检查数据目录，避免悄悄创建空库。
+
+最近一次完整备份（包含你在升级期间新建的项目）：
+D:\web\dj\integration-work\backups\upgrade-20261106-161805
+包含旧程序、数据库、素材、模型桥接配置和存储设置。
+补丁替换前的程序另保留于 integration-work\previous-app-20261106-161804。
+最初升级前的备份也保留于 integration-work\backups\upgrade-20261106-123510。
+
+风格预设：真人实拍、仙侠风格均已启用；已有项目风格没有被自动更改。
+
+单独设置使用哪张显卡：
+打开“设置 → AI 服务”，点击对应图片或视频配置右侧的编辑按钮。
+在“使用显卡”中选择：自动分配、GPU1、GPU2 或 GPU3，然后保存。
+每条模型配置分别保存，例如图片指定 GPU1、普通视频指定 GPU2、高清视频指定 GPU3。
+自动模式按各卡的队列负载分配新任务；指定模式仅提交到选定显卡，维护或不可用时明确报错。
+设置对新任务生效，已有任务继续在原显卡查询和下载。显卡编号与服务器编号一致。
+当前保持原有默认模型和自动分配方式，未替你固定到某张显卡。
+
+高清制作：
+先完成普通“视频制作”，进入新增“高清制作”，选择分镜和 2K / 4K。
+VDN-H3 根据原分镜提示词和原视频首帧重新生成；动作和画面细节可能变化。
+2K：横屏 2560×1440，竖屏 1440×2560。
+4K：横屏 3840×2160，竖屏 2160×3840。
+原视频和各次高清结果分别保留。完成后可对比，点击“使用此高清版导出”才会切换。
+切换后请在“拼接导出”重新拼接成片。混合分辨率采用最高尺寸；低清镜头仅缩放，不增加真实细节。
+实际输出尺寸会经过校验，尺寸不符的结果不能用于高清版本选择。
+
+显卡与数据保留：
+Qwen Image 2.1 图片生成与参考图编辑均支持 GPU1、GPU2、GPU3。
+批量提交的不同图片可分配到三张卡；每张图片由一张卡完成。
+三张卡均已分别指定并实际生成、下载 512×512 图片。
+GPU1 和 GPU3 均已分别完成 VDN 实机 2K 成片，实际尺寸 2560×1440，单段约 4 秒各用时约 9 分钟。
+VDN 高清服务已按授权连接 zq-platform-network，保留令牌认证，没有开放公网端口。
+只有具备 VDN 插件、且处于已准入状态的显卡节点才会接收高清任务。
+GPU3 已补装 VDN 插件，历史任务保留；GPU1 新建独立制作节点，也具备 VDN 工作流。
+原有 MiniMax、LTX、Wan 等视频模型均通过三张卡的工作流和模型检查。
+GPU0 保持原服务。GPU1 原有模型、语音服务保留，新制作节点设置额外预留 8 GiB 显存，不开放主机端口。
+两个原有项目按你的要求保持删除状态，记录与素材保留；新建项目继续使用当前数据。
+4K 高分辨率采样较慢，请等待任务完成，不必重复提交。高清轮询窗口已延长至 3 小时。
+
+实际验证结果（2026-11-06）：
+2K 实机成片为 2560×1440；4K 实机成片为 3840×2160，均为 24 帧/秒。
+约 4 秒的验证视频分别用时约 9 分钟、35 分钟，实际耗时取决于时长、分辨率及排队情况。
+已验证原版文件保持不变、切换/恢复导出版本、拒绝不达标尺寸、混合分辨率拼接保留 4K。
+本次重启前后核对：10 条模型配置、10 个风格、3 条项目记录（1 个正常显示，2 个按要求保留删除状态）、77 个分镜和 65 个素材文件内容一致。
+确认取消的任务已同步为取消状态，不删除已完成素材；原有模型密钥、地址、优先级和默认设置保留。
+验证记录：integration-work\gpu-selection-smoke.json、gpu-settings-ui-result.json、gpu-dispatch-test.json、three-gpu-all-workflows.json。
+
+维护源码：D:\web\dj\huobao-source，基于官方 v4.0.11。
+构建/备份工具：D:\web\dj\model-bridge。
+后续更新请先备份，将新版源码与本地高清功能合并、测试后再替换程序。
+不要直接用旧版 patch_desktop_video.py 覆盖新版；该脚本已有版本保护。
+不要使用旧数据备份直接覆盖正在使用的数据目录，以免覆盖后续创建的内容。