# 提号AI PRD

## 1. 项目定位

提号AI是面向商务和媒介团队的 Web 端工具。它把客户 Brief 上传、需求拆解、规则确认、媒体资源库读取、AI 推荐、推荐名单导出、客户反馈学习串成一个可复用流程，目标是减少人工筛号时间，并沉淀公司自己的提号经验。

## 2. 背景与现状

当前收到客户 Brief 后，商务和媒介需要人工阅读需求、检索本地媒体资源表、结合外部平台数据和经验判断账号适配度，再制作推荐名单表给客户。该流程依赖个人经验，规则难复用，反馈难沉淀。

对 `C:\Users\刚sir\hcoa` 的 OA 代码阅读结论：

- 现有 OA 是 Snowy / Spring Boot / MyBatis-Plus 后端项目，未在该目录看到完整前端工程。
- 媒体域能力集中在 `snowy-main/src/main/java/vip/xiaonuo/modular/media`，已有媒体筛选、媒体导入导出、媒体详情、供应商价格、黑名单、采集、收藏、公海认领、数据同步等模块。
- 关键接口包括 `/mediaSelect/mediaSelectList`、`/mediaSelect/getFilterFields`、`/mediaAudit/importMeaidExcel`、`/mediaAudit/batchMediaExport`、`/mediaDetails/list` 等。
- 可复用的数据字段包括平台、账号名、链接、粉丝、内容类目、人设、价格、报价有效期、阅读/互动/播放中位数、爆文率、配合度、黑名单、供应商关系、责任人等。
- 新系统的一稿 Demo 先独立实现 Angular + Node/TS，可在客户需求确认后再对接 OA 媒体接口或直接读取本地资源库。

## 3. 目标用户

- 商务人员：上传 Brief、确认需求、选择规则、下载推荐名单、提交客户反馈。
- 媒介人员：维护本地媒体资源库、补充平台数据、审核 AI 推荐结果。
- 管理人员：维护规则库、查看提号效率、沉淀公司方法论。

## 4. 核心流程

1. 商务上传 Brief 文件，系统提供模板下载和上传入口。
2. AI 解析 Brief，抽取客户、品牌、目标、平台、数量、预算、内容风格、排除项。
3. 商务确认需求点，可勾选、修正或补充。
4. 系统列出适用规则，商务可启用、停用、临时补充规则。
5. AI 读取媒体资源库，必要时触发后台采集近 10 篇内容做风格比对。
6. 系统生成候选媒体池，按综合分、风格匹配、预算、风险排序。
7. 系统按推荐名单模板导出 Excel。
8. 商务录入客户反馈，AI 提炼新规则，经用户确认后加入规则库。

## 5. 一稿 Demo 范围

已实现或应在 Demo 中体现：

- Angular 单页 Web 端交互界面。
- Brief 上传交互和模板入口。
- AI 需求抽取结果展示与确认。
- 规则库启用/停用。
- 模拟 AI 提号任务进度。
- 推荐名单卡片和表格式导出。
- 客户反馈文本提炼为待确认规则。
- 资源库、任务记录、模板中心、规则库、反馈学习子页面。
- Node/TS Mock API：健康检查、Brief 解析、推荐、反馈学习、Excel HTML 导出。

暂不做真实能力：

- 不真实解析 Excel/Docx 内容。
- 不登录小红书、抖音等平台实时采集。
- 不接入 OA 数据库。
- 不做真实模型微调或长期记忆，只展示“确认后加入规则库”的交互。

## 6. 功能模块

### 6.1 提号工作台

以任务流为核心，支持上传 Brief、确认需求、选择规则、执行提号、预览候选、导出名单、提交反馈。

### 6.2 任务记录

记录客户、品牌、Brief 文件、需求版本、推荐名单版本、客户反馈版本、执行状态。

### 6.3 资源库

读取本地媒体资源目录，展示不同平台资源数量、新鲜度、匹配数量、字段映射状态。

### 6.4 规则库

维护经验规则、用户反馈规则、AI 提炼规则。所有自动提炼规则必须由用户确认后生效。

### 6.5 反馈学习

从客户反馈中提取偏好、排除项、预算约束、平台策略，并形成待确认规则。

### 6.6 模板中心

管理 Brief 模板、媒体资源模板、推荐名单模板。后续支持不同客户/品牌自动匹配模板。

## 7. 推荐评分建议

综合分 = 需求匹配分 + 平台优先分 + 风格匹配分 + 预算健康分 + 数据新鲜度分 + 历史表现分 - 风险扣分。

关键规则：

- 明确数量时，候选池不少于需求数量 3 倍。
- Brief 有平台要求时，优先满足平台数量。
- 风格要求明确时，近 10 篇内容 80% 以上匹配才进入强推荐。
- 黑名单、低配合度、供应商未绑定、报价过期账号降级或剔除。
- 同质化账号需要控制比例，避免名单重复。

## 8. 数据对象

- Brief：客户、品牌、行业、目标、平台、数量、预算、内容风格、排除项、交付时间。
- MediaAccount：平台、账号名、账号 ID、链接、粉丝、标签、内容类目、人设、报价、报价有效期、历史投放、互动指标、供应商、责任人。
- Rule：规则类型、触发条件、动作、优先级、来源、生效状态、版本。
- Recommendation：任务 ID、媒体账号、匹配理由、风险提示、推荐状态、导出状态。
- Feedback：反馈内容、提炼规则、置信度、确认人、生效时间。

## 9. 成功指标

- 商务从 Brief 到首版推荐名单的时间减少 50% 以上。
- 客户要求返工次数下降。
- 规则库每月可沉淀稳定新增规则。
- 推荐名单中被客户采纳账号占比提升。

## 10. 后续迭代

- 接入真实 Excel/Docx 解析。
- 接入 OA 媒体资源接口或数据库。
- 读取本地资源库并自动字段映射。
- 支持平台后台采集和风格多模态比对。
- 引入权限、任务协作、版本审计。
- 推荐名单模板自动识别和样式化导出。

## 11. 重新审视后的 Demo 补充重点

原一稿 Demo 已能表达完整流程，但偏“展示型”。为了更适合客户沟通，Demo 需要让客户看到 AI 提号不是黑盒，而是可确认、可追溯、可修正、可沉淀的工作台。

本轮增强后的关键交互：

- 页面组件拆分：主壳只负责导航和页面切换，工作台、任务记录、资源库、规则库、反馈学习、模板中心拆成独立子页面，便于后续逐页深化。
- 需求确认增强：Brief 抽取出的需求点支持编辑、勾选、补充，并展示原文证据或推断来源。
- 临时规则增强：商务可在本次任务中临时补充规则，后续再决定是否沉淀为长期规则。
- 资源库增强：除平台资源数量外，增加字段映射确认，让客户看到本地 Excel 资源表如何被 AI 理解。
- 后台采样增强：增加近 10 条内容采样任务进度，模拟平台后台打开链接、采集内容、完成风格比对。
- 推荐名单增强：增加平台、状态、预算、排序筛选，并支持换一批/补足备选。
- 账号钻取增强：新增“账号列表 -> 账号详情 -> 最近10条笔记详情”的三层结构，展示推荐分、命中规则、风险提示、内容样本和单条笔记 AI 判断。
- 反馈学习增强：AI 只生成待确认规则，必须由用户确认后入库，避免“AI 自动乱学”的客户顾虑。

继续补充的交互增强：

- 客户临时改需求试算：工作台增加情景按钮，例如“客户压预算 15%”“小红书偏生活方式”“严格排除硬广”“保留 B站专业背书”，点击后实时调整账号分数、推荐状态、命中规则和风险提示。
- 交付准备度：用字段映射、规则启用、候选名单、近 10 条采样四类状态合成准备度，帮助商务判断是否可以导出对客名单。
- 操作决策日志：记录 Brief 解析、规则确认、情景试算、批量复核、笔记标注、反馈补充等关键动作，后续正式版可升级为任务审计。
- 推荐名单批量处理：支持勾选当前筛选、批量强推荐、批量备选、批量剔除、清空选择。
- 账号横向对比：对已选账号展示平台、报价、综合分、风格匹配，并支持内部复核版/客户版切换。内部复核版突出风险，客户版突出推荐理由。
- 笔记样本标注：最近 10 条笔记可按“正向样本/需复核/负向样本”过滤，并支持人工标注，标注动作会影响账号风格匹配或复核状态。
- 快捷反馈补充：反馈学习页增加常用反馈句，一键追加到客户反馈文本，再由 AI 提炼为待确认规则。
- 资源库平台详情：点击平台后展示资源文件、更新时间、负责人、缺失字段、待处理问题和匹配样例账号，支持单平台重新扫描和问题标记处理。
- 规则沙盘试算：规则库支持选中规则、填写客户临时要求、调整权重、启停测试用例，并实时模拟对强推荐和需复核数量的影响。
- 任务档案与时间线：任务记录页支持选中任务查看详情、操作时间线、复制为相似客户任务，并可把最近动作送入反馈学习。
- 模板字段配置：模板中心支持客户版/内部复核版/复盘版切换，勾选导出字段，预览导出列，并同步到名单交付配置。

### 11.1 便利性优化原则

上一轮功能已经覆盖 Brief、资源库、规则、AI 选号、账号详情、近 10 条笔记、名单交付和反馈学习，但默认界面信息量偏大。为了降低商务同事上手门槛，本轮调整为“默认简单、需要时展开”的交互策略。

- 默认进入商务简洁模式：侧边导航只保留提号工作台、找博主、名单交付、任务记录四个常用入口；资源库、规则库、反馈学习、模板中心等仍保留在完整业务模式中。
- 工作台改为流程主画布：六个步骤作为顶部流程导航，支持随时回退修改；页面主体一次只展示当前流程，避免把上传、需求、规则、采样、名单全部堆在一个屏幕。
- 当前流程强突出：顶部显示当前步骤、下一步动作和整体进度条；右侧辅助区保留业务检查和快捷动作。
- 二稿继续优化：默认从 Step 1 开始，顶部去掉重复统计卡，改为“目标 / 操作 / 产出”三段式说明；六步导航从大卡片改为更轻量的流程时间线，减少首屏压迫感。
- 检查项按流程推进判断：默认规则存在不等于流程完成，只有用户走到对应步骤后，业务检查才显示完成，避免误导新用户。
- 其它页面统一优化：找博主、AI选号流程、名单交付、任务记录、资源库、规则库、反馈学习、模板中心统一为“目标 / 操作 / 产出”的页面头；简洁模式下隐藏解释、版本、表格等次级信息，主页面优先呈现业务操作。
- 交付页默认客户版：商务默认看到可对客内容，内部复核字段和版本历史通过展开细节或切换内部复核版查看。
- 常用动作一键化：提供“一键生成可看名单”“只看待处理问题”“客户版预览”“反馈变规则”，把多步操作合并为业务语言。
- 高级细节可展开：客户情景试算、规则选择、AI 执行队列、近 10 条采样、批量复核等不删除，只默认收起，保证业务逻辑不缺失。
- 客户版优先：推荐名单默认引导到客户版预览，内部风险、供应商、规则命中等字段在完整模式或内部复核版中查看。

本轮仍属于 Demo，不做真实平台登录采集和真实 Excel/Docx 解析；正式版需要将这些交互背后的模拟数据替换为真实任务队列、平台数据接口或浏览器自动化采集结果。