# 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`，再检查本机桥接链。