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