追踪热点引用 Top10

查看更多

文章标签引用 Top10

查看更多

引用次数趋势 · 近 30 天

滚动窗口 · 反映品牌作品 GEO 发酵速度

AI 平台引用分布

谁更愿意把品牌作品当信源

作品追踪记录

共 0 条
作品标题 发布时间 发布站点 站点类型 标签 添加时间 首次引用时间 引用天数 引用AI平台 引用AI问题 操作
作品引用追踪 · 产品需求文档(PRD for 研发) 面向研发的完整规格:作品 CRUD · 标签库 · 命中匹配 · 详情 Drawer · 异常 · 验收 收起展开查看
版本v1.7.14
最后更新2026-05-29
文档状态Stable · 待评审
维护人产品 · 张明 / 研发 · TBD
相关方后端 · 前端 · 数据 · QA · 运营

§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 引用扫描比对。
引用作品citedWorktracked=true 且至少被一个 AI 平台引用过的作品。
引用率(站点 / 标签)citationRatecited / tracked × 100%;衡量该站点或标签的 GEO 投产比。
命中 AI 问题hitQuestions该作品出现在 AI 答案中的具体监测问题集合。
平台命中platformHits各 AI 平台引用次数 map(doubao / kimi / yuanbao ...)。
引用天数citationDays从首次被引用到当前的天数;用于「即将失效」预警。
置顶作品isTop用户标记的关注作品;列表中始终置顶展示。
标签库tagLibrary租户级公共标签池;每个标签有 addedAt 元信息。

§3角色与权限矩阵 / RBAC

操作 \ 角色OwnerAdminMemberViewer
查看 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 / urlstring—
siteId / site / siteType—归属站点(同 sources)
publishedAt / addedAt / firstCitedAt / lastCitedAtdatetime四时间戳
citationDaysnumber派生:lastCited - firstCited
tags[]string[]—
isTopbool置顶
citationsnumber总引用次数
aiQs[]QHit[]命中 AI 问题:{questionId, platforms[]}
platformHits{platform: count}各平台引用次数
summarystring作品摘要(用户编辑)
tracked / deletedAt—软删除字段
5.2 Tag 标签
字段类型说明
id / namestring—
tenantIdstring租户隔离
addedAtdatetime加入标签库时间
usageCountnumber被多少作品引用(删除前必须为 0)
5.3 TrendPoint 趋势点
字段类型说明
datedate—
citationsnumber该日总引用次数

§6交互规格 / Interaction Spec

交互点触发动作 / 反馈 / 边界
F5 添加作品click「添加作品」UI.modal Tab 切换:手动 / 上传;提交后 toast + tracked=true。
F5 标签设置click「标签设置」打开标签库 modal(全局)。
F5 批量删除勾选 + 「批量删除」UI.confirm 二次确认;写 deletedAt(软删除);toast。
F5 行操作data-actdelete / summary / preview / pin / tag / detail 共 6 个;图标化。
F6 Drawer 翻页Drawer 内上 / 下在当前过滤后的作品 list 内切换;保留筛选。
F6 命中问题「AI 对话详情」click调用 window.openConvDetailModal 打开全站统一详情 modal。
F7 标签库删除click 删除校验 usageCount=0;否则 UI.confirm 提示「先解除作品引用」。
F8 上传 Excelfile change校验 → 报告 → 提交;模板下载链接固定 URL。
列表配置clickGxColumnConfig 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/kpi4 张 KPI
GET/api/v1/at/top-sitesF2 站点 Top10
GET/api/v1/at/top-tagsF2 标签 Top10
GET/api/v1/at/trendF3 30 天趋势
GET/api/v1/at/platform-distroF4 平台分布
GET/api/v1/at/worksF5 作品列表(分页 + 排序 + 筛选)
POST/api/v1/at/works添加作品(单条 / 批量)
PUT/api/v1/at/works/:id编辑(标签 / 摘要 / 置顶)
DELETE/api/v1/at/works批量软删除;body: {ids[]}
GET/api/v1/at/works/:idF6 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_openF6 详情workId
at_conv_detailF6 内部对话详情workId, questionId, conversationId
at_tag_lib_op标签库 CRUDop(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)+ 命中匹配规则手册 + 上传模板格式说明。