引用次数趋势 · 近 30 天
滚动窗口 · 反映品牌作品 GEO 发酵速度AI 平台引用分布
谁更愿意把品牌作品当信源作品追踪记录
共 0 条| 作品标题 | 发布时间 | 发布站点 | 站点类型 | 标签 | 添加时间 | 首次引用时间 | 引用天数 | 引用AI平台 | 引用AI问题 | 操作 |
|---|
作品引用追踪 · 产品需求文档(PRD for 研发) 面向研发的完整规格:作品 CRUD · 标签库 · 命中匹配 · 详情 Drawer · 异常 · 验收 收起展开查看
§1概述 / Overview
定位:to B GEO 监控平台「作品引用追踪」工作台,回答「我发到各站点的图文/视频,哪些被 AI 引用了 / 引用次数多少 / ROI 如何」。
目标:为内容运营提供作品级 GEO 投放反馈:从作品列表 → 引用趋势 → 命中 AI 问题 → 平台分布 → 标签 ROI 一站式视图,并支持作品 + 标签 CRUD。
核心交付物:4 张 KPI、Top10 双卡(站点 / 标签)、引用趋势 30 天、AI 平台分布饼图、作品记录主表(11 列 + 6 行操作)、作品详情 Drawer。
下钻路径:作品记录 → 作品详情 Drawer → 命中 AI 问题卡 → AI 对话详情 modal。
上游:扫描调度 / 答案 NER(链接抽取)/ 站点元数据 / 标签库(运营维护)。
§2名词术语 / Glossary
| 术语 | 标识 | 定义 |
|---|---|---|
| 作品 | work | 品牌主动发布的图文 / 视频,包含 url + title + site + 发布时间。 |
| 追踪状态 | tracked | 是否已加入持续监测;只有 tracked=true 的作品才参与 AI 引用扫描比对。 |
| 引用作品 | citedWork | tracked=true 且至少被一个 AI 平台引用过的作品。 |
| 引用率(站点 / 标签) | citationRate | cited / tracked × 100%;衡量该站点或标签的 GEO 投产比。 |
| 命中 AI 问题 | hitQuestions | 该作品出现在 AI 答案中的具体监测问题集合。 |
| 平台命中 | platformHits | 各 AI 平台引用次数 map(doubao / kimi / yuanbao ...)。 |
| 引用天数 | citationDays | 从首次被引用到当前的天数;用于「即将失效」预警。 |
| 置顶作品 | isTop | 用户标记的关注作品;列表中始终置顶展示。 |
| 标签库 | tagLibrary | 租户级公共标签池;每个标签有 addedAt 元信息。 |
§3角色与权限矩阵 / RBAC
| 操作 \ 角色 | Owner | Admin | Member | Viewer |
|---|---|---|---|---|
| 查看 KPI / 双卡 / 趋势 / 主表 / Drawer | ✓ | ✓ | ✓ | ✓ |
| 添加 / 编辑 / 删除作品(含批量) | ✓ | ✓ | ✓ | — |
| 置顶 / 设置标签 | ✓ | ✓ | ✓ | — |
| 标签库 CRUD | ✓ | ✓ | — | — |
| 列表配置 / 全部导出 | ✓ | ✓ | ✓ | 仅本人布局 |
| 立即更新 | ✓ | ✓ | 受授权 | — |
租户隔离:Work / Tag 严格租户隔离;外链不限制(仅写日志)。
§4页面功能清单 / Feature List
F1 · 顶部全局过滤 + KPI
- GlobalFilter(品牌 / 平台 / 话题 / 时间)+ 立即更新。
- KPI 4 卡:追踪作品数 / 引用作品数 / 引用 AI 问题数 / 引用次数。
F2 · Top10 双卡
- 追踪热点引用 Top10(按 citationCount desc)+「查看更多」 modal。
- 文章标签引用 Top10 +「查看更多」 modal。
F3 · 引用趋势 · 30 天
- 统计条(总次数 / 高峰 / 均值)+ ECharts 折线图。
F4 · AI 平台引用分布
- ECharts 饼图:各平台命中次数;颜色与 ai-conversations 平台 chip 一致。
F5 · 作品记录主表
- 工具栏:添加作品 / 标签设置 / 批量删除 / 列表配置 / 全部导出 / 标题搜索 / 站点搜索 / 标签筛选。
- 11 列可排序 + GxPager;行内 6 操作:删除 / 摘要 / 原文 / 置顶 / 标签 / 详情。
- 选择模式:勾选后启用批量删除。
F6 · 作品详情 Drawer(720px)
- 顶部:作品 meta + 平台分布条 + 统计条。
- 命中 AI 问题卡:每条问题列出在哪些平台被命中;行内「AI 对话详情」调用
openConvDetailModal。 - 时间线:发布 / 加入追踪 / 首次被引用 / 最近被引用 4 个里程碑。
F7 · 标签库 / 标签设置
- 标签库 modal:CRUD + 引用次数(不可删被使用中的标签)。
- 作品标签 modal:从标签库选择 + 创建新标签。
F8 · 添加作品(手动 / 批量)
- Tab 切换:手动单条 / Excel 上传批量;上传含模板下载 + 校验报告。
§5数据模型 / Data Model
5.1 Work 作品
| 字段 | 类型 | 说明 |
|---|---|---|
id / title / url | string | — |
siteId / site / siteType | — | 归属站点(同 sources) |
publishedAt / addedAt / firstCitedAt / lastCitedAt | datetime | 四时间戳 |
citationDays | number | 派生:lastCited - firstCited |
tags[] | string[] | — |
isTop | bool | 置顶 |
citations | number | 总引用次数 |
aiQs[] | QHit[] | 命中 AI 问题:{questionId, platforms[]} |
platformHits | {platform: count} | 各平台引用次数 |
summary | string | 作品摘要(用户编辑) |
tracked / deletedAt | — | 软删除字段 |
5.2 Tag 标签
| 字段 | 类型 | 说明 |
|---|---|---|
id / name | string | — |
tenantId | string | 租户隔离 |
addedAt | datetime | 加入标签库时间 |
usageCount | number | 被多少作品引用(删除前必须为 0) |
5.3 TrendPoint 趋势点
| 字段 | 类型 | 说明 |
|---|---|---|
date | date | — |
citations | number | 该日总引用次数 |
§6交互规格 / Interaction Spec
| 交互点 | 触发 | 动作 / 反馈 / 边界 |
|---|---|---|
| F5 添加作品 | click「添加作品」 | UI.modal Tab 切换:手动 / 上传;提交后 toast + tracked=true。 |
| F5 标签设置 | click「标签设置」 | 打开标签库 modal(全局)。 |
| F5 批量删除 | 勾选 + 「批量删除」 | UI.confirm 二次确认;写 deletedAt(软删除);toast。 |
| F5 行操作 | data-act | delete / summary / preview / pin / tag / detail 共 6 个;图标化。 |
| F6 Drawer 翻页 | Drawer 内上 / 下 | 在当前过滤后的作品 list 内切换;保留筛选。 |
| F6 命中问题「AI 对话详情」 | click | 调用 window.openConvDetailModal 打开全站统一详情 modal。 |
| F7 标签库删除 | click 删除 | 校验 usageCount=0;否则 UI.confirm 提示「先解除作品引用」。 |
| F8 上传 Excel | file change | 校验 → 报告 → 提交;模板下载链接固定 URL。 |
| 列表配置 | click | GxColumnConfig drawer;记忆于 localStorage。 |
| 全部导出 | click | 导出当前过滤范围(不仅当前页)。 |
| 立即更新 | click | 触发后端刷新;toast。 |
§7指标算法 / Metric Algorithm
- 站点引用率 = 该站点 cited / 该站点 tracked × 100%;着色:≥30% high / 10~30% mid / <10% low。
- 标签引用率:同上,按 tag 聚合。
- 命中匹配:以「精确 URL(去 fragment + utm)」为主键;不命中时退化为 host + 路径前缀模糊匹配。
- 即将失效:tracked && cited && (now - lastCitedAt) > 30 天 → 进入「即将失效」清单(在数据总看板使用)。
- 排序:列表默认 isTop desc → citations desc → addedAt desc。
- 批量删除回收期:deletedAt > 0 但 ≤ 7 天可恢复(运营后台);> 7 天物理删除。
§8接口契约 / REST API
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/v1/at/kpi | 4 张 KPI |
GET | /api/v1/at/top-sites | F2 站点 Top10 |
GET | /api/v1/at/top-tags | F2 标签 Top10 |
GET | /api/v1/at/trend | F3 30 天趋势 |
GET | /api/v1/at/platform-distro | F4 平台分布 |
GET | /api/v1/at/works | F5 作品列表(分页 + 排序 + 筛选) |
POST | /api/v1/at/works | 添加作品(单条 / 批量) |
PUT | /api/v1/at/works/:id | 编辑(标签 / 摘要 / 置顶) |
DELETE | /api/v1/at/works | 批量软删除;body: {ids[]} |
GET | /api/v1/at/works/:id | F6 Drawer 详情 |
GET / POST / DELETE | /api/v1/at/tags | 标签库 CRUD(删除前校验 usageCount=0) |
POST | /api/v1/at/refresh | 立即更新 |
POST | /api/v1/at/export | 导出(异步 job) |
错误码:
WORK_DUPLICATE_URL / TAG_IN_USE / IMPORT_VALIDATION_FAILED / WORK_DELETED。
§9异常处理矩阵 / Error Handling
| 层级 | 场景 | 处理策略 / 用户感知 |
|---|---|---|
| 数据源 | 添加作品 url 重复 | 返回 WORK_DUPLICATE_URL;toast「该作品已在追踪中」+ 跳到该行。 |
| 批量上传校验失败 | 返回校验报告(行号 + 错误原因);前端展示可下载错误清单。 | |
| 原文 url 失效 | 列表保留 + 灰态站点 icon;「原文」按钮 disabled 并 tooltip。 | |
| 任务执行 | 立即更新频率超限 | 令牌桶 5 次 / 小时;toast 倒计时;按钮 disabled。 |
| 导出超大 | job 超时 → 邮件下载链接;toast「已转后台」。 | |
| 批量删除部分失败 | 返回 {success[], failed[{id, reason}]};toast「已删除 X 条,失败 Y 条」。 | |
| 前端 / 安全 | 外链跳转 | 统一 rel="noopener noreferrer" 新窗口。 |
| 跨租户作品 ID | API 403;前端 toast「无权访问」+ 关 Drawer。 | |
| 业务边界 | 过滤后 0 条 | 空态卡 + 「重置筛选」 + 「添加作品」 CTA。 |
| 标签库标签被使用中 | 不允许删除;UI.confirm 引导「先在 X 个作品中解除引用」。 | |
| 软删除 7 天后物理删除 | 定时任务清理;恢复期内可在运营后台恢复。 |
§10非功能性需求 / NFR
10.1 性能 SLA
- 首屏 P95 < 1.6s。
- F5 作品表分页 P95 < 400ms。
- F6 Drawer 首次打开 P95 < 600ms。
10.2 可用性
- 读 / 写路径 ≥ 99.9%。
- 批量上传支持断点续传。
10.3 安全
- 所有 API 强制 tenant 过滤 + RBAC。
- 外链 noopener;导出文件水印。
10.4 可观测
- 指标:作品总量 / 命中匹配成功率 / 标签复用率 / 上传校验失败率。
- 告警:单租户作品 > 10w / 命中匹配 P95 > 1s / 上传失败率 > 10%。
§11埋点指标 / Tracking
| 事件名 | 触发 | 主要属性 |
|---|---|---|
at_page_view | 进入页面 | tenantId, brandId, timePreset |
at_work_add | 添加作品 | mode(manual/upload), count, success |
at_work_delete_batch | 批量删除 | count, success |
at_work_pin / at_work_tag | 行操作 | workId |
at_drawer_open | F6 详情 | workId |
at_conv_detail | F6 内部对话详情 | workId, questionId, conversationId |
at_tag_lib_op | 标签库 CRUD | op(add/edit/delete), tagId |
at_export / at_refresh | 顶部 | scope, success |
§12验收标准 / Definition of Done
- F1~F8 功能 100% 实现,响应式 ≥ 1024px。
- 添加作品(手动 / 批量上传)冒烟通过;上传支持模板下载 + 校验报告。
- 命中匹配单测:精确 URL ≥ 99% / fallback 模糊匹配 ≥ 90% recall。
- 标签库删除前校验 usageCount=0;解除引用流程畅通。
- F6 Drawer 内「AI 对话详情」 → 全站统一详情 modal。
- 异常矩阵每条均有对应单测;批量上传部分失败处理畅通。
- 权限 / 租户隔离冒烟通过;越权 403。
- 埋点事件按 §11 全量上报。
- 文档:API 文档(OpenAPI)+ 命中匹配规则手册 + 上传模板格式说明。