storyforge/docs/PRODUCTION_BASELINE_2026-03-26.md

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
• Web 已支持固定后端自动建会话：
  • POST /v2/auth/auto-session
  • 开关由 WEB_AUTOLOGIN_ENABLED 控制
  • 推荐使用 WEB_AUTOLOGIN_ACCOUNT_USERNAME 直接绑定现有已审批账号
  • 兼容 WEB_AUTOLOGIN_USERNAME / WEB_AUTOLOGIN_PASSWORD 或 bootstrap 超级管理员口令回退
• 仓库内已新增 SQLite 备份脚本：
  • scripts/backup_storyforge_sqlite.sh

运行建议

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

当前外部阻塞

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