等比例缩放图片以适应指定尺寸

调用 LLM 并返回最终响应。 Args: stream_to_ws: 是否将流式文本推送到 WebSocket（默认关闭，因为 JSON 输出不适合直接展示）

关闭 HTTP 客户端

拼接角色参考图：优先裁剪面部区域，fallback 到全身图拼接。 面部裁剪模式（InsightFace 可用时）： ┌────────┬────────┬────────┐ │ 脸1 │ 脸2 │ 脸3 │ └──

拼接参考图：分镜图 + 角色图 布局： ┌─────────────────────────┐ │ │ │ 分镜图（主图） │ │

从 URL 下载图片并保存到本地 Args: url: 图片 URL save_path: 保存路径（完整路径，包含文件名）

下载或复制视频文件 Args: url: 视频 URL 或本地 /static/... 路径 dest_path: 目标路径

Persist reusable generation-provider interface settings into DB. Keep the scope to text/image/video/TTS/BGM provider settings. Database,

生成图片并缓存到本地 Args: ctx: Agent 上下文 prompt: 图片生成 prompt image_bytes: 可选的参考图片字节流（用于 I2I） timeout_s

获取视频拼接服务单例

Initialize database tables and cleanup stale runs.

检查项目是否有运行中的任务

* @param {Client} client * @param {any} message * @param {Array<Transferable>} transferrables * @returns {Promise<any>}

发送角色创建/更新事件

发送批处理进度消息 Args: ctx: Agent 上下文 total: 总数 current: 当前索引（从 0 开始） message: 进度消息

发送分镜创建/更新事件

Build a multimodal user message for VLM review. Local /static images are inlined as data URLs so local desktop/dev runs can still fee

清空角色图片（先删除文件再清空 URL）

清空分镜首帧图片（先删除文件再清空 URL）

检测是否是 ModelScope API

判断是否可重试的 HTTP 状态码

Send bible_updated WebSocket event.

存储导出状态到 Redis（降级到内存缓存）

Synchronous fallback — used when no session is available.

Look up StyleTemplate from DB and return (style_prompt, negative_prompt). Falls back to hardcoded mapping if template not found.

Build a JSON-safe Character snapshot.

关闭 HTTP 客户端