content-find-agent-new/web

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 文件读取接口必须使用后端白名单。

文档

• 01_产品功能规划.md
• 02_数据与接口规划.md
• 03_技术开发规划.md
• 04_show视觉迁移清单.md
• 05_Web实施简报.md

后续实施顺序

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