README.md 2.2 KB

ContentFindAgent Web

web/ 是新的可视化面板项目目录。后续 Next.js 代码、组件、API client、页面和前端测试都放在这里;旧 show/ 只作为视觉和交互参考,不再作为真实数据实现底座。

定位

新 Web 的目标是把 ContentFindAgent 的真实运行数据展示给用户:

  • 查看 run 列表和运行状态。
  • 进入某次 run,按阶段查看数据源、Query、平台召回、规则判断、游走、资产沉淀和策略学习。
  • 诊断失败 run,例如平台失败、Query 生成失败、runtime 缺文件、validation 不通过。
  • 复盘哪些 Query、规则、游走路径和资产值得保留或调整。

和 show 的关系

show/ 当前是旧静态沙盘:视觉完整,但数据主要写死在 show/src/App.tsx,不连接 FastAPI,也不是生产事实层。

新 Web 要做到:

  • 视觉和交互尽量贴近 show
  • 数据层和组件结构全部重写。
  • 不迁移 show 的静态样例作为事实数据。
  • 不把小红书、热点、养号、共创、相似作者等旧占位入口当成 V1 默认能力。

数据原则

  • 生产事实层:FastAPI 读取云 MySQL content_agent_* 表或后端聚合后的事实数据。
  • 回放辅助层:本地 runtime/v1/{run_id}/ JSON / JSONL 只作为开发调试和回放导出,UI 必须标注为“回放导出”。
  • 前端不直接连接 MySQL。
  • 前端不直接读取任意文件路径。
  • runtime 文件读取接口必须使用后端白名单。

文档

后续实施顺序

  1. 补后端 Web 友好 API。(已完成,commit 6ee0079)
  2. 初始化 web/ 下 Next.js 项目。(已完成,commit c6c5e39)
  3. 建立 API client、类型和数据 adapter。(已完成)
  4. 复刻 show 的页面视觉与核心交互。(已完成基础版)
  5. 用真实 run 数据替换静态演示数据。(已完成)

Web V2 迭代(时间线/配置只读/V1 bug 修复)见 docs/06_WebV2迭代计划.md