# StoryForge Web V4

这是 `StoryForge` 当前面向正式前端实现的 Web 承载目录。

## 入口

- 页面：`index.html`
- 样式：`assets/styles.css`
- 页面交互：`assets/app.js`

## 当前定位

- 这不是最终生产版，但已经不是纯静态原型
- 目录已经从 `output/ui/` 原型区独立出来，并接上了第一层真实业务接口
- 这里面向国内平台的 Web 承载，当前覆盖 `douyin`、`xiaohongshu`、`bilibili`、`kuaishou`、`wechat_video`
- `YouTube` 目前明确不在本轮范围内
- 已支持通过 `https://storyforge.hyzq.net/` 做公网访问
- 通用的项目、内容源、复盘、集成等流程可以正常使用
- 平台工作台和运行时数据目前只有 `douyin` 做到了完整实现，其余平台统一按 `待接入工作台` 处理
- 当前保留的核心页面结构：
  - 项目总台
  - 我的项目
  - 找对标
  - 跟踪账号
  - 自动流程
  - Agent
  - 生产中心
  - 发布与复盘
  - 额度

## 当前已接入的真实能力

- 后端登录与会话保持
- 工作区信息与 `/v2/me`
- 项目总台 `/v2/me/dashboard`
- 项目创建 `/v2/projects`
- 内容源列表 `/v2/content-sources`
- 通用的复盘与 `/v2/reviews`
- 通用的集成健康检查 `/v2/integrations/health`
- 抖音对标账号 `/v2/douyin/accounts`
- 单账号工作台 `/v2/douyin/accounts/{id}/workspace`
- 单账号作品列表 `/v2/douyin/accounts/{id}/videos`
- 跟踪账号 `/v2/douyin/tracking/accounts`
- 跟踪日报 `/v2/douyin/tracking/digest`
- 最近知识库文档 `/v2/knowledge-bases/{id}/documents`

## 当前已接入的真实动作

- 新建项目
- 导入主页并触发内容源同步
- 把当前对标账号直接导入到当前项目，并绑定 Agent 触发同步
- 导入作品链接并触发分析
- 导入文本素材并触发分析
- 上传本地视频并触发分析
- 创建 Agent
- 选择当前 Agent
- 编辑 Agent 的名称、目标、系统提示词和主模型
- 对当前 Douyin 对标账号重跑分析
- 批量分析高分作品
- 查找相似对标账号
- 从相似候选一键保存对标关系
- 把当前对标账号加入跟踪，并绑定 Agent
- 单账号立即同步跟踪对象
- 批量同步全部跟踪对象
- 日报手动标记已读，不再在刷新页面时自动吞掉未读摘要
- 按上次打开后生成跟踪日报与借鉴点摘要
- 查看任务详情、事件、子任务和 artifacts/result
- 从任务详情直接衔接 AI 视频 / 实拍剪辑 / 文案生成
- 在生产中心 / 发布与复盘常驻最近一次任务详情摘要
- 在 Web 中直接创建和编辑复盘
- 在页面里直接看到 `本机模型 / cutvideo / huobao / n8n / ASR` 的真实健康状态
- 直播录制已切成租户隔离模式：
  - 录制源按当前账号和项目归属保存
  - 录像文件只通过当前租户的后端代理访问
  - 前端不再直接暴露 NAS 全局配置和下载根地址
- 存储状态面板已接上：
  - 当前项目和当前账号的缓存占用
  - 数据库本机 / 分析缓存 NAS / 下载缓存 NAS 的目录策略
  - 最近写入 NAS 的缓存样本路径
- 会先识别后端是否具备 `tracking / reviews / integrations` 路由，再决定是否请求，避免不同版本 live collector 刷 404
- 依赖不可达时，自动拦住 AI 视频 / 实拍剪辑动作并展示原因
- 使用 Agent 生成文案
- 创建 AI 视频任务
- 创建实拍剪辑任务

## 本地预览

推荐直接在目录内起一个临时静态服务：

```bash
cd /Users/kris/code/StoryForge-gitea/web/storyforge-web-v4
python3 -m http.server 3918
```

然后打开：

- [http://127.0.0.1:3918/index.html](http://127.0.0.1:3918/index.html)

首次进入需要手动连接后端，默认地址是：

- `http://127.0.0.1:8081`

如果页面部署在：

- `https://storyforge.hyzq.net/`

前端会自动把默认后端切到同源的：

- `https://storyforge.hyzq.net`

## 后续建议

- 继续补多平台各自更深的专属采集与解析能力，而不只是一套统一抽象层
- 把对标导入后的 Agent 绑定和知识库入库反馈做得更完整
- 把跟踪日报从 Douyin 扩到多平台统一模型，并接入真正的定时调度
- 把全局搜索和页内搜索合并成统一搜索体验
- 为 `生产中心 / 发布与复盘` 接入更完整的成片预览与封面对象
- 如果后续要开放外网多租户录像访问，继续沿用 collector 的鉴权代理，不要把 NAS 下载目录直接暴露给浏览器
- 现在的推荐策略是：
  - 数据库继续留本机
  - `jobs / downloads` 这类大文件缓存优先放 NAS
  - 下载产物和分析产物通过 `/v2/storage/artifacts/{file_id}/content` 走租户鉴权代理访问
  - 如果后续出现速度或稳定性问题，再切到 OSS
- `项目总台` 里的“存储状态”面板现在已经会显示：
  - NAS / 本机策略
  - 项目与账号占用
  - 最近分析产物
  - 最近执行缓存
  - 最近录像文件
- 不要把这套页面重新塞回 `scripts/douyin-browser-capture/control_panel.mjs`
- 抖音采集控制台仍作为独立工具存在，这里才是正式业务应用壳