storyforge/docs/CURRENT_PROJECT_STATE_2026-03-26.md

StoryForge 当前项目状态

日期：2026-03-26

本文档用于固定当前 StoryForge-gitea 的真实维护范围、主运行链和继续开发基线。

当前项目边界

• 当前仓库只维护 StoryForge。
• AI Glasses 已拆回独立仓库维护，不再属于当前仓库主线。
• 当前仓库主维护目录：
  • collector-service/
  • web/storyforge-web-v4/
  • scripts/douyin-browser-capture/
  • n8n/
  • deploy/
  • docs/

当前产品主线

• collector-service：FastAPI 主状态中心，承接登录、项目、Agent、内容源、任务、平台工作台与内部执行接口。
• web/storyforge-web-v4：当前正式业务 Web 壳，面向日常运营工作台。
• n8n：分析、内容源同步、AI 视频、实拍剪辑编排工作流。
• scripts/douyin-browser-capture：抖音真实浏览器辅助采集工具，作为反爬环境下的兜底采集入口。

当前已经接通的主要能力

• 多用户与审批体系。
• project / assistant / knowledge base / job / content source 主数据模型。
• 文本、视频链接、上传视频分析。
• n8n 工作流触发与任务编排。
• 本地 ASR、本机模型、Windows cutvideo、本机 huobao-drama 的后端接入。
• Web 工作台已经承接：
  • 项目总台
  • 对标导入
  • 多平台账号工作台
  • 跟踪账号与日报
  • Agent 控制面
  • 生产中心
  • 复盘
  • 额度与运维面板
  • 自动建会话连接

当前量产基线

• SQLite 已默认启用 WAL、busy_timeout、synchronous=NORMAL、foreign_keys=ON 等连接参数，减少并发写入时的锁冲突。
• tenant_quota_profiles 与 tenant_usage_ledger 已接入核心生产链，explore/*、content-source-sync、reviews、real-cut、ai-video、assistants/{id}/generate、live-recorder create 都会先做额度硬拦截，再记账。
• jobs 已补 retry / requeue 单任务入口，以及管理员批量重试失败任务入口，便于失败链路恢复。
• 仓库内已新增 SQLite 备份脚本，可在发布或故障前快速生成一致性快照。
• Web 前端已改成固定后端自动建会话模式，不再要求用户手动输入账号密码；是否启用由服务端 WEB_AUTOLOGIN_* 环境变量控制，推荐直接用 WEB_AUTOLOGIN_ACCOUNT_USERNAME 绑定现有已审批账号。

当前支持的平台

• douyin
• xiaohongshu
• bilibili
• kuaishou
• wechat_video

说明：

• Web V4 当前已经按统一工作台模型接上以上平台的账号列表、单账号详情、作品列表、账号分析、高分作品分析、相似账号搜索、对标关系、跟踪账号与日报入口。
• 其中 douyin 仍然是采集与验证最完整的平台。
• 其余国内平台的工作台接口已由 collector-service 正式挂载，前端也已切成统一可用工作台；但真实平台采集质量仍取决于后续各平台专项验证。

当前仍受外部依赖限制的项

• 抖音 public 页直抓仍可能触发反爬挑战，需要真实浏览器登录或手工页面辅助采集。
• 小红书账号级内容源还需要补真实平台验证。
• huobao-drama fresh 生成仍依赖可用的外部图片 / 视频凭证；仓库代码已预留 env 覆盖能力，但没有新 key 时无法靠本仓库单独打通。

当前公网部署目标

• 公网入口：https://storyforge.hyzq.net/
• 云服务器 nginx 提供 HTTPS 入口。
• 云服务器本地 storyforge-web-v4.service 承接静态前端。
• 云服务器本地 collector-service 承接 /v2/*、/openapi.json、/healthz、/downloads/*。
• n8n / huobao / cutvideo / 本机模型 / ASR / 录制链路 继续通过本机和局域网桥接提供。

后续开发建议基线

1. 继续按当前仓库边界维护，不再把 AI Glasses 代码重新叠进来。
2. Web 功能优先围绕多平台工作台、生产中心和租户控制面继续深化。
3. 需要真实平台验证的事项，单独作为联调任务推进，不再和仓库边界治理混在一起。
4. 生产基线任务优先按“任务恢复、额度硬控、数据库备份、观测补齐”继续深化。
5. 公网环境出现异常时，先检查云服务器上的 nginx / storyforge-web-v4.service / collector-service，再检查本机桥接链。