# 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](docs/01_产品功能规划.md)
- [02_数据与接口规划.md](docs/02_数据与接口规划.md)
- [03_技术开发规划.md](docs/03_技术开发规划.md)
- [04_show视觉迁移清单.md](docs/04_show视觉迁移清单.md)
- [05_Web实施简报.md](docs/05_Web实施简报.md)

## 后续实施顺序

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`。