> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 把B站评论交给课程团队答疑，表格应该怎样整理？

> 按视频与评论来源整理原句、层级、学习条件和待回答项，保留重复处理与实际采集范围，形成团队可跟进的表格。

**先把表格做成课程团队能接着处理的答疑清单：哪条视频、观众原话、卡在哪一步、是否已有解释、下一步谁来核对。** 用 `bilibili.app.fetch_video_comments` 读评论，用 `bilibili.web.fetch_comment_reply` 展开有歧义的评论，原评论和你的归纳放在不同工作表，方便同事回查。

例如剪辑课程更新后，观众可能在问素材导入、快捷键、软件版本。先选本轮相关视频，读真实评论，再把具体的学习疑问归组。抽奖和泛泛赞美不放进问题分组。

## 1. 先保存一批相关评论

已有 BV 号就复用，只有链接时先按[BV/AV说明](/zh/faq/bilibili-bv-comments)确认 BV 号。`bilibili.app.fetch_video_comments` 用 `mode: 2` 按时间排序，首页用 `next_offset: 1`：

```json
{
  "action": "bilibili.app.fetch_video_comments",
  "params": {"bv_id": "<confirmed_bv_id>", "mode": 2, "next_offset": 1}
}
```

请求发到 `POST https://api.beatapi.io/v1/social-data/call`，使用常规 BeatAPI Bearer 鉴权。读高互动讨论时另发一次 `mode: 3` 请求，两次观察各自保存时间与来源，见[评论排序](/zh/faq/bilibili-comment-order)。

每条视频分别保存原响应、目标 BV、实际输入、时间和请求号。评论列表、评论标识和正文字段按实际响应核对。B 站评论接口直接透传原始响应结构、没有固定的顶层路径，请核对已保存响应，不要套用其他平台的数组路径。

## 2. 工作表保留哪些列？

建议建两张表。第一张「评论原句」一条评论一行，第二张「答疑待办」一个问题一行。在每条答疑待办中写明对应的评论标识，同事即可回溯原句和所属视频。

| 列                 | 用来做什么          |
| ----------------- | -------------- |
| 视频BV、标题、原来源       | 确认讨论对象与章节      |
| 评论实际标识、父评论标识（有则记） | 核对重复与上下文       |
| 原句与评论时间（实际有则记）    | 回看观众的表达与适用时期   |
| 软件/设备/步骤条件        | 解释疑问出现在哪种情境    |
| 问题主题与归类理由         | 让同事理解为什么归在一起   |
| 已有说明、待核项与下一步      | 安排答疑、文档补充或课程修订 |
| 查询时间、排序、页状态、请求号   | 说明材料范围和来源      |

每行保留原句和原有换行，缺失值留空。把「评论原句」和「答疑待办」放在同一个 Excel 工作簿，或分别导出为 UTF-8 CSV。用 Excel 的「从文本/CSV」导入时，把 BV、评论标识和父评论标识设为文本，避免长数字被改写。

## 3. 有歧义的评论，怎样补上下文？

“这个键没用”可能是快捷键、系统差异或窗口焦点不对，先看这条评论的父评论和相关回复。Web 回复动作 `bilibili.web.fetch_comment_reply` 需要同一视频的 `bv_id` 和父评论已确认的 `rpid`：

```json
{
  "action": "bilibili.web.fetch_comment_reply",
  "params": {"bv_id": "<confirmed_bv_id>", "rpid": "<confirmed_root_comment_id>", "pn": 1}
}
```

`rpid` 是选中评论的标识，不是 UP 主 `mid`，也不是视频的 AV 号。回复请求的输入与 App 一级评论的 `next_offset` 分别保存，按各自动作的实际返回确认对象。

## 4. 怎样把表变成答疑安排？

下表演示如何将评论原句转化为答疑待办：

| 原句           | 需要核对的条件    | 团队下一步          |
| ------------ | ---------- | -------------- |
| “新版没有这个菜单”   | 软件版本与该步骤画面 | 核对后补版本说明或更新演示  |
| “素材导入后没声音”   | 素材、轨道、音频设置 | 保留已提供信息，列具体待问项 |
| “上一条回复已经解决了” | 父评论与实际解决方法 | 补回上下文后记录可复用答复  |

1. 同一评论跨页重复出现时只保留一条评论记录，每次观察都保存。
2. 保留一级评论和回复的层级，支持评论数和不同视频数分别统计。
3. 同一个人连续追问算一名学员，不算多名。
4. 每个主题附代表原句和未解决条件，不只输出一个情绪分数。

## 答疑待办怎么写进 CSV？

例如，两个视频都有人问新版菜单在哪里。先把两条原句分别录入评论表，再在待办表合成一行。下面的 `C01`、`C02` 是评论表自编行号，行内另存实际视频和评论标识。

```csv
问题,原句行号,涉及视频数,待核条件,下一步
新版在哪里打开转场菜单,C01 / C02,2,软件版本,核对菜单路径后补进课程说明
```

交接前任选一条待办，沿行号找到评论原句和对应的视频。再在表头注明实际读了哪些视频和评论页，方便下次从同一批材料接着做。

给助手可以这样交代：

> 把这几条课程视频的评论整理成答疑工作表，保留视频、原句、使用条件和待核项。有歧义时补回复，记录父子关系；主题附代表原句，列出可回答、需追问和需更新课程的事项，并说明读过的范围。

按一级评论页数和选中的回复页数估算费用，见[价格页](https://beatapi.io/zh/pricing)。已有保存结果直接复用，只为尚未解决的学习问题补取更多页。