# StoryForge 生产基线

日期：2026-03-26

本文档描述当前仓库已经落地的量产底盘，便于后续继续开发和运维。

## 已落地能力

- SQLite 默认连接参数已收紧：
  - `journal_mode=WAL`
  - `synchronous=NORMAL`
  - `busy_timeout`
  - `foreign_keys=ON`
  - `temp_store=MEMORY`
- 核心生产 API 已接入 tenant quota 硬控制与 usage ledger 记账：
  - `POST /v2/explore/text`
  - `POST /v2/explore/video-link`
  - `POST /v2/explore/upload-video`
  - `POST /v2/pipelines/content-source-sync`
  - `POST /v2/reviews`
  - `POST /v2/pipelines/real-cut`
  - `POST /v2/pipelines/ai-video`
  - `POST /v2/assistants/{assistant_id}/generate`
  - `POST /v2/live-recorder/sources`
- 失败任务恢复入口已补齐：
  - `POST /v2/explore/jobs/{job_id}/retry`
  - `POST /v2/explore/jobs/{job_id}/requeue`
  - `POST /v2/admin/jobs/retry-failed`
- 仓库内已新增 SQLite 备份脚本：
  - `scripts/backup_storyforge_sqlite.sh`

## 运行建议

- 发布前先执行一次数据库备份，再执行服务升级。
- quota 配置建议按 project 维度维护，避免不同项目之间互相干扰。
- 批量 retry 建议优先筛选 `workflow_key` 或 `source_type`，避免把不同流水线一起打回去。

## 当前外部阻塞

- 真正的额度策略仍取决于业务侧如何配置 `tenant_quota_profiles`。
- `real-cut`、`ai-video`、`content-source-sync` 的完整链路仍依赖外部服务可用性。
- 抖音等真实平台采集仍可能受到平台风控影响，需要真实联调确认。