归档仓储

清点中…

归档之道 · 零本地落盘

铁律：生成的视频/图像产物一律直投 AList 网盘，平台容器不保存任何视频文件；播放与下载都走网盘直链 —— 直链原文只在 GET /api/assets/[id]/raw 跳转时由服务端现签（AList sign 会过期，列表接口只回 hasRawUrl 标志防签名泄漏）。「本地目录」类仅作测试 / 离线开发之用。

token 自愈：AList token 默认 48h 有效；服务端遇 401/过期会自动重登并重试一次，重登失败会明确报中文错（如「token 已过期」），绝不静默降级为本地存盘。过期时首选把凭据改为「环境变量引用 env:」，改密后无需再动本页面。

离线下载（offline）· AList 自己拉取

平台只把产物 URL 交给 AList，由网盘侧的离线工具（SimpleHttp / aria2 / qBittorrent）拉取内容 ——流量完全不经平台，大文件首选；前提是产物 URL 网盘侧够得着。

流式上传（stream）· 平台转发

平台把产物流直接 PUT 给 AList（/api/fs/put），需占平台带宽（一进一出双倍流量）；适合只在平台内部产生、没有可回源 URL 的场合。

自动（auto · 默认）

有 sourceUrl 先离线下载，拿不到 URL 再退回流式上传。

契约注记（PLAN v2「AList 归档存储」为唯一依据）：GET/POST /api/storage · PATCH /api/storage/[id]（只发改动项，kind 不可改）· POST /api/storage/test（id + 内联覆盖可先测后存，返回中文结果）· GET /api/storage/browse?path=&configId=。密钥字段 apiKeyEnc前缀约定 env:VAR / b64:xxx / 明文，与 Provider 同一 resolveSecret 口径；出参只回 hasSecret + apiKeyMasked（服务端口径已定，route 已挂）。已知边界： ① 镜头资产清单（ShotDto.assets，必填）已回挂，归档徽标与直链可直接点亮； ② AssetDto 有意不提供「归档失败原因」字段——归档失败时库中不写 Asset 行，失败原因在任务中心的 Task.error 上（中文「产物归档失败：…」），本页不重复透传。 PLAN 未提供 DELETE /api/storage —— 下架请用「停用」开关，勿直接删库。