docs(user-manual): add product user manual aligned to live code

Cover onboarding, workspace, article creation, brand library, media publishing, knowledge base, image library, GEO tracking, desktop client, KOL marketplace, AI points, and FAQ — sourced from actual views and i18n rather than the v1 PRD. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 00:20:47 +08:00
parent 65e9b7e293
commit ab62d666b4
13 changed files with 1391 additions and 0 deletions
@@ -0,0 +1,139 @@
+# 数据追踪
+
+路径 `/tracking`，对应左侧导航 **数据追踪 → 数据详情**。这是省心推 GEO 价值的核心呈现位：在豆包、文心一言、通义千问、DeepSeek、Kimi、混元/元宝等 AI 平台上采样品牌相关问题的真实回答，归因引用来源，量化品牌曝光。
+
+## 1. 数据来源
+
+数据**不是从第三方搜索引擎抓的**，而是由桌面客户端直接打开 AI 平台对话页、按问题集逐条采样：
+
+- 每个 **品牌 → 关键词 → 问题** 都是一次采样单位
+- 桌面客户端每天按计划运行采样任务，把模型回答和引用来源回写到服务端
+- 你也可以在页面里手动 **立即采集**
+
+> 数据采集前置条件（缺一项就拿不到数据）：
+> 1. 当前账号已在桌面客户端登录、且客户端**在线**
+> 2. 桌面客户端的 **AI 平台** 页面已绑定至少一个 AI 平台并 **授权正常**
+> 3. 品牌词库里已建好品牌 → 关键词 → 至少一个问题
+
+## 2. 页面结构
+
+进入 `/tracking` 后顶部是筛选区：
+
+- **品牌**：必选；账号下没品牌时整页空
+- **关键词**：可选，限定到具体关键词
+- **AI 平台筛选**：聚焦看某个平台的表现
+- **立即采集** 按钮：仅当上述前置条件全部满足时可点
+
+页面主体分为四块：
+
+### A. 平台对比矩阵
+
+横向把当前所有 AI 平台并排，纵向是品牌相关指标。能直观看到：
+
+- 哪些平台经常引用我？
+- 哪些平台一次没引用？
+- 同一个问题在不同平台上的回答差异
+
+### B. 高频问题
+
+按品牌库当前关键词下的问题集排序展示：
+
+- 显示问题文本、最近一次采样时间
+- 点击任一问题进入 **问题详情页**
+
+### C. 引用排行（Citation Ranking）
+
+按发布外链主体归因 SaaS 发文在模型引用来源中的出现次数与占比：
+
+- 时间窗口：**近 7 天 / 近 30 天** 切换
+- 字段：来源域名、引用次数、占比
+- 视图说明：「按发布外链主体归因 SaaS 发文在模型引用来源中的出现次数与占比」
+
+### D. 被引用文章（Cited Articles）
+
+横向列出被任意 AI 平台引用过的省心推平台内文章：
+
+- 字段：文章标题、被引用次数、最近被引平台
+- 点击文章可进入文章详情抽屉
+
+## 3. 问题详情页
+
+路径 `/tracking/questions/:brandId/:questionId`。这是省心推数据回看的最深层级，分四块：
+
+### 答案内容（Answer Content）
+
+- 选中的 AI 平台对该问题的最新回答全文
+- 没有采样数据时显示「该平台暂无采样回答」
+
+### 引用来源（Citation Sources）
+
+- 模型回答里附带的所有外部链接
+- 字段：序号 + 链接 + 域名
+- 每条引用来源右侧有 **仿写创作** 按钮：一键把这条外链作为来源导入仿写流程（详见 [文章创作 §仿写创作](./03-文章创作.md#4-仿写创作)）
+
+### 引用分析（Citation Analysis）
+
+- 服务端基于回答内容做的归因分析
+- 试图回答"为什么模型在这个问题上引用了这些来源"
+
+### 内容引用（Content Citations）
+
+- 当前账号已发布的文章在该问题里被引用的次数
+- 用于直接验证"我们写的文章是否被 AI 引用了"
+
+## 4. 立即采集
+
+立即采集会触发桌面客户端马上跑一次该品牌（或具体关键词/问题）的采样任务。可点击场景：
+
+- 当天日期 + 客户端在线 + AI 平台授权正常 + 至少一个问题已建立
+
+不可点击的常见原因：
+
+| 提示 | 解释 |
+| --- | --- |
+| 「请先选择品牌，再发起采集」 | 顶部筛选未选品牌 |
+| 「请先选择关键词，再立即采集当前问题」 | 在问题详情页未限定关键词 |
+| 「立即采集只支持今天的数据，请切回今天后再操作」 | 数据查询区切到了历史日期 |
+| 「正在检查当前账号的桌面客户端状态」 | 客户端心跳中，稍等 |
+| 「当前登录账号的桌面客户端未在线，暂时不能立即采集」 | 桌面端没启动或网络中断 |
+| 「当前账号尚未注册桌面客户端，不能发起采集」 | 没装客户端、或客户端没用同一账号登录过 |
+| 「当前账号暂无已授权 AI 平台，不能发起采集」 | 桌面端 AI 平台页面没绑定任何平台 |
+| 「当前筛选平台未授权，不能发起采集」 | 筛选了某个平台，但该平台没授权 |
+
+## 5. 采集模式与覆盖率
+
+页面顶部信息条会展示：
+
+```
+插件采样 · 目标 X · 计划 Y · 已采样 Z · 覆盖率 A% · 更新于 ... · 触发方式
+```
+
+字段含义：
+
+- **目标**：原计划要采样的次数
+- **计划**：实际生成的采集任务数
+- **已采样**：成功回写结果的次数
+- **覆盖率**：已采样 / 目标
+- **触发方式**：周期任务 / 立即采集
+
+> 插件模式（实际为桌面客户端模式）下结果受设备在线率影响，**低覆盖样本仅供趋势参考**。建议保持桌面客户端长期在线以提升覆盖率。
+
+## 6. 平台授权状态横幅
+
+页面顶部会显示授权状态卡片：
+
+| 状态 | 含义 | 后续动作 |
+| --- | --- | --- |
+| **AI 平台授权正常** | 已有可用授权 | 可正常采样 |
+| **未检测到桌面客户端** | 当前账号没在桌面客户端登录过 | 安装并登录桌面客户端 |
+| **暂无已授权 AI 平台** | 客户端有，但 AI 平台未绑定 | 桌面端 → AI 平台 → 绑定 |
+
+## 7. 异步任务调试
+
+页面底部有一块 **异步任务调试**，仅用于排查 callback → 队列 → worker 的流转，不影响上方四块主内容。一般用户可忽略；遇到数据延迟或缺失时可截图给运营同学看。
+
+## 8. 常见问题
+
+- **页面常年空白**：99% 的情况是缺前置条件之一（品牌 / 问题 / 桌面客户端 / AI 平台授权）
+- **某个 AI 平台总是没数据**：去桌面端 **AI 平台** 页面看该平台的授权状态；常见是 cookie 过期需要重新授权
+- **引用排行里没看到自己的文章**：归因按"发布外链主体"匹配；要确认文章已发布到第三方平台并产生了外链，且模型在采样窗口内引用了这条外链