Skip to content
Back to search

dsh-bilibili-reply

SkillWorks with Claude CodeGitHub

让 AI 读懂你在 B 站 @ 它的视频,自动回一条带可跳转时间戳的评论。DSH / AI Agent 技能。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bronyacccxz--dsh-bilibili-reply/badge.svg)](/listings/bronyacccxz--dsh-bilibili-reply)

HTML

<a href="/listings/bronyacccxz--dsh-bilibili-reply"><img src="/api/listings/bronyacccxz--dsh-bilibili-reply/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 267 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: bilibili-reply
  3. description: 回复 B 站「@我的」评论。当用户说「我@你了」「去B站看看」「回复那条@」等要处理 B 站 @ 通知时使用。流程固定为:核对身份 → 读通知 → 用 video-watch 分析视频 → 回「@我的」界面用回复框发送。回复形式按视频类型决定(教学类详解+时间戳,玩乐类分享情绪)。
  4. ---
  5. # B站 @ 回复流程
  6. 让 AI 读懂你在 B 站 @ 它的视频,然后在「@我的」界面里回你一条**带可跳转时间戳**的评论。
  7. ## 依赖(缺任何一样都跑不起来)
  8. | 依赖 | 说明 |
  9. |---|---|
  10. | **浏览器自动化** ⚠️ | **最关键**。AI 必须能操控一个**已登录 B 站**的浏览器,否则读不到 @ 通知、也发不了评论。推荐 [BrowserSkill](https://github.com/Tencent/BrowserSkill)(`bsk` CLI + 浏览器扩展)。**安装步骤见仓库 README 的「前置条件」一节。** |
  11. | **`video-watch` 技能** | 必需。用它把视频转成带时间戳的文字稿 + 抽帧图片。本技能不重复实现这一步。 |
  12. | **一个 B 站账号** | 建议用不常用的小号;本技能会操作它的评论区。 |
  13. **本技能的示例按 DSH 的 `browser_*` 工具写。** 换环境时把这一步换成你手上的浏览器工具,**流程逻辑不变**——读通知、核对昵称、点回复框这几步是一样的。
  14. **装完先自检**:能在浏览器里打开 `https://message.bilibili.com/#/at` 并读到通知列表,才算前置通了。
  15. ## 首次配置
  16. 1. 把 `config.example.md` 复制成 `config.md`
  17. 2. 按里面说明填入**你的昵称**和**机器人账号昵称 / UID**
  18. 3. 确认 `video-watch` 技能已装好(见它的 README)
  19. 4. 确认**浏览器自动化可用**(见上「依赖」一节,这是最容易漏的一步)
  20. **为什么要填两个昵称**:本技能的设计前提是「**你用账号 A @ 自己**」——也就是发 @ 的人和执行回复的账号是同一个。所以不能靠 UID 区分,只能靠**昵称核对**。
  21. ---
  22. ## 第一步:核对身份(最重要,别跳过)
  23. **@ 列表里混着别人的通知。只回目标用户发的,别人的绝对不能回。**
  24. 回复前必须走完这个清单(配置见 `config.md`):
  25. ```
  26. ① 打开 https://message.bilibili.com/#/at
  27. ② 找【最新一条】通知 —— 不要盲取列表第一条,要看时间戳
  28. ③ 核对:这条通知显示的【发 @ 人昵称】== config.md 里的 owner_name ?
  29. ④ 点这条通知的【评论文本】→ 跳转到视频(URL 带 #reply<评论id>)
  30. ⑤ 在视频评论区确认那条评论的作者昵称 == owner_name
  31. ⑥ 确认评论里 @ 的账号 == config.md 里的 self_name
  32. ⑦ 全部对上 → 才能回复
  33. ```
  34. **任何一项对不上 → 停下来问用户,不要擅自回复。**
  35. ### 为什么要有这一步(真实事故)
  36. 最初的版本写的是「取 @ 列表第一条」,**没有身份核对**。结果 @ 列表里混着第三方一次 @ 一串人的通知,于是点错了别人的视频、还发了评论。
  37. **教训**:@ 通知**只显示评论文字,不显示是哪个视频**,所以「第一条」这个判断根本不可靠。
  38. ---
  39. ## 第二步:分析视频
  40. ### 先拿免费素材:简介 / 官方字幕 / 弹幕摘要
  41. **别一上来就抽帧。** B站 的视频简介里经常自带章节时间轴、BGM 名、拍摄地;很多视频本身带校对过的官方字幕;弹幕密度能告诉你观众在哪里有反应。
  42. `tools/bili-context.ps1` 一次拿齐这三样(走浏览器登录态,零额外成本):
  43. ```powershell
  44. . "<repo>/tools/bili-context.ps1"
  45. $runner = { param($a) Invoke-BskTab $sid $tab $a }.GetNewClosure()
  46. $ctx = Get-BiliContext -Runner $runner -Aid <aid> # 或 -Bvid BVxxxx
  47. # $ctx.desc / $ctx.subtitle / $ctx.danmaku_digest / $ctx.danmaku_count
  48. ```
  49. - **有字幕就用字幕**,并给下面的 `watch.py` 加 `--no-transcribe` 跳过本地转写(字幕比 whisper 准)
  50. - **弹幕摘要**约 200 字(每分钟密度 + 高能处最多 8 条原话)。它只代表**观众反应**,不代表画面事实 —— 空镜类视频弹幕稀疏,别把「响」当「好看」
  51. ### 再跑 video-watch 拿转写与画面
  52. 拿到 BV 号后,用 `video-watch` 技能处理(先加载该技能):
  53. ```bash
  54. # 按你的实际路径调整
  55. python <video-watch>/scripts/watch.py "https://www.bilibili.com/video/BVxxxx/" --language zh --model small --max-frames 10
  56. ```
  57. 读 `<run_dir>/transcript.txt`(每行 `[MM:SS] 文本`)。
  58. ### ⛔ 转写空了就用 `--no-vad` 重跑
  59. **歌曲 / 翻唱 / 纯音乐**视频,VAD(人声检测)会把歌声当噪声滤掉,结果是 **0 段**:
  60. - `transcript.txt` 0 字节
  61. - `manifest.json` 里 `transcript.segments` = 0
  62. **这时不要放弃、更不要去硬读几十张图**(那是烧 token 的真正原因)。直接重跑:
  63. ```bash
  64. python <video-watch>/scripts/transcribe.py \
  65. --video "<run目录>/<视频文件名>" --out-dir "<run目录>" \
  66. --model small --language zh --no-vad
  67. ```
  68. 实测:4 分 12 秒歌曲,`vad_filter=True` → **0 段**;加 `--no-vad` → **57 段**。
  69. **预防**:判断是歌曲/纯音乐,一开始就加 `--no-vad`。
  70. ### 抽帧图片:只读你真正需要的那几张
  71. - **主依据永远是文字稿。** 一张图 ≈ 1500 字,读 80 张 ≈ 12 万字。
  72. - **一次最多读 3~5 张**,挑画面变化大的时刻。
  73. - **音频类视频(歌/播客/访谈)不要读图** —— 文字稿已经够了。
  74. - **文件名必须从 `frames/frames.json` 的 `file` 字段读**,不要凭时间戳猜。
  75. (曾经猜 `0079_t000249.5.jpg`,实际是 `0079_t000249.6.jpg`,读图直接失败。)
  76. ---
  77. ## 第三步:回到「@我的」发送
  78. **不要去视频评论区的顶部输入框发** —— 那会变成**独立顶层评论**,对方收不到「有人回复了你」的通知,会以为你没回。
  79. 正确做法:
  80. ```
  81. 回到 https://message.bilibili.com/#/at
  82. → 点那条通知上的「回复」按钮
  83. → 通知下方展开内联回复框
  84. → 填入内容
  85. → 点「发表评论」
  86. ```
  87. 成功后页面会弹「**评论成功**」气泡。
  88. ---
  89. ## 回复形式:按视频类型决定
  90. 先判断视频属于哪一类,再决定怎么写。**不是所有视频都要带时间戳。**
  91. ### 教学 / 讲解 / 知识类 → 详细分析 + 时间戳
  92. 看点是「信息」,读者希望拿到能复用的干货:
  93. - 用文字稿**分段**,每段配可跳转时间戳(`MM:SS`,超过 1 小时用 `HH:MM:SS`)
  94. - 时间戳必须是**纯文本 `00:00` 开头**,B 站才会自动转成跳转链接
  95. - 结构:一句总评 → 章节时间戳列表 → 一句补充
  96. ### 玩乐 / 搞笑 / 音乐 / 二创 / 日常类 → 分享情绪,不用时间戳
  97. 看点是「感觉」,堆时间戳会很出戏:
  98. - **不要时间戳**,不要章节列表
  99. - 一到三句**情绪反应**:接梗、吐槽、共情
  100. - 可以短到一句话
  101. ### 基调偏暗 / 情绪沉重的内容 → 先接住情绪
  102. 如果视频涉及悲伤、告别、自伤等沉重主题:
  103. - **不要用轻快或开玩笑的语气**
  104. - 先接住情绪,人设可以保留但**要收着**
  105. - 拿不准时,宁可**简短、克制**,也不要硬搞笑
  106. ### 拿不准时
  107. 偏中间的内容(测评、杂谈、vlog)**默认走情绪路线**。
  108. ---
  109. ## 语气
  110. 默认用**中性、友好、像真人随手回一句**的语气。
  111. 如果 `config.md` 里配了自定义人设,按那个写 —— 但注意:**人设只作用于发出去的评论内容**,跟用户的对话和工具操作保持正常工作语气。
  112. ---
  113. ## 可选:让它自己盯着(自动检查 + 自动回复)
  114. 不想每次都喊它?`tools/watch-at.ps1` 把整套流程变成后台自动化:**每 30 秒检查一次 @,
  115. 命中就自己看视频、自己回评论,再用微信告诉你回了什么**。检查那一步不花模型 token ——
  116. 脚本直接在已登录的浏览器里调 B 站接口,只有真要回复时才叫一次模型。
  117. ```powershell
  118. cd <技能目录>\tools
  119. Copy-Item watch-at.config.example.ps1 watch-at.config.ps1 # 填路径与两个 UID
  120. .\watch-at.ps1 -Init # 首次接入:把当前最新一条设为基准,历史积压不处理
  121. .\watch-at.ps1 -Test # 给微信发一条测试消息
  122. .\watch-at.ps1 -InstallTask # 装计划任务(1 分钟一轮 + 脚本内 30 秒补检)
  123. ```
  124. **白名单**:只回 `$OwnerMid` 那个人的 @,而且被 @ 的必须是 `$SelfMid` ——
  125. 群里那种一次 @ 一串人的通知会被自动丢掉,这正是最容易出错的地方。
  126. 节拍、阈值、以及这套东西踩过的坑,见 [tools/README.md](tools/README.md)。
  127. ---
  128. ## 已知的坑(都会真的发生)
  129. | 坑 | 症状 | 处理 |
  130. |---|---|---|
  131. | **点用户名** | 跳到对方主页 | 要点的是**评论文本** |
  132. | **用顶部输入框回复** | 变成独立评论,对方收不到通知 | 用通知里的「回复」按钮 |
  133. | **消息中心白屏** | 页面空白 | `reload` 一次通常就好 |
  134. | **点进「回复我的」** | 那是别人回你的,不是 @ | 只处理「@ 我的」 |
  135. | **B 站风控** | 弹验证码 / 接口返 `-352` | 别连发太多条,隔开时间 |
  136. | **浏览器 daemon 空闲超时** | 报 `session not registered` | 重启 daemon 后重建会话(约 10 秒) |
  137. | **转写 0 段** | 歌曲类视频 | 加 `--no-vad` 重跑 |
  138. | **评论发出去了、别人看不到** | 接口回 `code 0`,自己看得见、别人看不见(影子隐藏) | 发送前先切到那条视频页;发完用**匿名**请求复查可见性 |
  139. | **计划任务里中文全乱** | PowerShell 没有控制台时用 GBK 解 UTF-8,JSON 直接解析失败 | 原生命令输出**重定向到文件**、再按 UTF-8 读 |
  140. ---
  141. ## 权限与边界
  142. - 本技能会**以你的身份在公开评论区发言**。请自行确认发出去的内容得体。
  143. - 建议用小号;自动化操作有触发平台风控的可能。
  144. - **不要在一条视频下连发多条**,也不要批量刷。
  145. ## 自动化细节(v2)
  146. ### 无窗口运行
  147. 计划任务**不要**直接跑 `powershell.exe` —— 那样每轮会闪一个控制台窗口。用仓库里的隐藏启动器:
  148. ```
  149. 任务动作:wscript.exe //B //Nologo "<repo>\tools\run-hidden.vbs"
  150. 运行级别:最低权限(/RL LIMITED)
  151. ```
  152. `run-hidden.vbs` 用 `WScript.Shell.Run ...,0,False` 启动,脚本内的「30 秒补检」也走同一个 vbs。
  153. ### 30 秒节拍怎么来的
  154. 计划任务最快 1 分钟一轮,所以脚本每轮收工时用 `-SecondPass` **先睡 30 秒再跑**,把节拍补成约 30 秒。**别改成立刻拉起** —— 那等于连着跑两遍,不是 30 秒。
  155. ### 浏览器没开就自动拉起
  156. 每轮先查 `bsk browsers`;没连上就检查 `Get-Process chrome`,没开就启动 Chrome(最小化打开 bilibili.com),然后 3 秒一查、最多等 45 秒等扩展连回来。
  157. ### 并发闸
  158. `check.lock`:22 秒内已有轮次在跑就直接让路,防止两轮同时读到同一条 @ 而**重复回复**。
  159. ### 失败的 @ 会被吞
  160. 只要进了回复分支,无论成败都会推进 `at-state.json` 的 `cursor` 并写入 `seen` —— 这条 @ **不会再重试**。排查失败原因后要手动把 `cursor` 退回去、把 `seen` 清空。
  161. ### 关键帧怎么挑
  162. 不是均匀抽样,是**对齐台词时间点**:从字幕/转写抓所有 `[MM:SS]` → 每个时间点取最近的帧(差 ≤6 秒)→ 时间差 <1.2 秒的算同一处去重 → 不够预算再均匀补齐。
  163. 预算:**全片 ≤60 秒读 8 张,≤180 秒 6 张,更长 5 张,纯音乐 3 张**。
  164. ### 抽帧参数
  165. `--max-frames 10`,模式用默认 `auto`(场景点 + 均匀补齐)。**纯 `--mode scene` 在短视频上会饿死** —— 实测 12 秒视频只出 2 帧。
  166. ## 更多踩过的坑
  167. | 坑 | 症状 | 解决 |
  168. |---|---|---|
  169. | **`.ps1` 没有 BOM** | PowerShell 5.1 按 ANSI 读中文 → ParseError / 中文全乱 | 存成 UTF-8 with BOM |
  170. | **空数组被展开成 `$null`** | 接口回 0 条被误判成「取数失败」,反复重试后跳过 | `return ,@($payload.items)` |
  171. | **`av` 版本不兼容** | `open() got an unexpected keyword argument 'metadata_errors'` | 删掉 faster_whisper/audio.py 里那个参数(升级会被还原) |
  172. | **headless 缺 API key** | 两秒就报「写评论失败或跑偏」 | `dsh --profile headless` 不读 credentials 的 refs,要先把它放进环境变量 |
  173. | **没字幕就以为没素材** | 音乐/空镜类完全读不出内容 | 至少拿简介 + 弹幕摘要 |
README.md · README · 167 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # bilibili-reply
  2. [English](README.en.md)
  3. 一个 **AI Agent 技能**:让 AI 读懂你在 B 站 @ 它的视频,然后回你一条**带可跳转时间戳**的评论。
  4. ```
  5. 你 @ 一个视频 → AI 本地看懂视频(文字稿 + 关键画面) → 生成回复 → 自动发到你的评论区
  6. ```
  7. ## 它解决什么
  8. 普通 AI 没法处理「B 站 @ 通知 + 视频内容」这条链路:
  9. - @ 通知里**只有评论文字,没有视频链接** —— 得先找到是哪个视频
  10. - 视频内容**得先看懂** —— 需要转文字 + 看关键画面
  11. - 回复**要发在对的地方** —— 发错位置对方收不到通知
  12. 这个技能把整条链路固定下来,并踩平了几个真实的坑。
  13. ---
  14. # ⚠️ 前置条件(必读)
  15. **这个技能不是装进任何 AI 就能用。** 它需要「AI 能操控一个已登录 B 站的浏览器」——**没有这一条,技能完全无法工作**(读不到 B 站,也发不了评论)。
  16. | # | 前置 | 说明 | 链接 |
  17. |---|---|---|---|
  18. | 1 | **DeepSeek Harness(DSH)** | 技能运行在它的 Agent 上 | <https://github.com/deepseek-ai/deepseek-harness> |
  19. | 2 | **pnpm** | DSH 用它管理插件 | <https://pnpm.io/installation> |
  20. | 3 | **浏览器自动化**(关键) | 让 AI 能操作浏览器 —— 见下 | <https://github.com/Tencent/BrowserSkill> |
  21. | 4 | **`video-watch` 技能** | 负责视频理解 | 见它的 README |
  22. ## 第 3 项:装浏览器自动化
  23. 推荐 **[BrowserSkill](https://github.com/Tencent/BrowserSkill)** —— 腾讯开源的浏览器自动化,⭐ 8.8k,MIT 许可。它提供 `bsk` CLI + 浏览器扩展,**让 AI 用你真实的、已登录的浏览器**,而不需要另开一个干净会话重新登录。
  24. > **本项目实际使用的就是这一套。** 这是 monorepo,我们装的 DSH 插件是其中一个子包:
  25. > - 仓库主页:<https://github.com/Tencent/BrowserSkill>
  26. > - **DSH 插件子目录(含插件自己的 README)**:<https://github.com/Tencent/BrowserSkill/tree/main/packages/dsh-plugin-browserskill>
  27. > - npm 包名:`@wxg-prc-cpg/browser-skill-dsh-plugin`
  28. ```text
  29. ① 按 BrowserSkill 的快速开始装 bsk CLI
  30. https://github.com/Tencent/BrowserSkill#quick-start
  31. ② 在 Chrome 或 Edge 里安装并连接 BrowserSkill 扩展
  32. ③ 确保 bsk 在「启动 dsh 时的 PATH」里
  33. —— 不在也行,稍后在插件配置里写 bskPath 绝对路径
  34. ④ 把 DSH 插件装进你的 profile(desktop / web 按你的实际用)
  35. dsh plugin --profile web add @wxg-prc-cpg/browser-skill-dsh-plugin
  36. dsh --profile web
  37. ```
  38. **验证装好了**:在 DSH 对话里说
  39. ```text
  40. /browser-skill 打开 bilibili.com 并总结页面
  41. ```
  42. 能返回页面内容 → 前置通了。
  43. > **换别的浏览器自动化也可以。** 本技能需要的是「读页面 / 点击 / 填表单」这几样能力;`SKILL.md` 里的示例按 `browser_*` 工具写,换成你手上的工具即可,**流程逻辑不变**。
  44. ## 第 4 项:装 video-watch
  45. 本技能**依赖 `video-watch` 技能**做视频理解(本地转写 + 抽帧,不传云端)。请先按它自己的 README 装好:ffmpeg、faster-whisper 等。
  46. > 它是独立项目,不随本仓库分发。搜索 `video-watch` 技能,或找提供该技能的 DSH 插件包安装。
  47. ---
  48. # 快速开始(完整流程)
  49. ```text
  50. ① 装好上面 4 个前置
  51. ② git clone <本仓库地址> <DSH_HOME>/skills/bilibili-reply
  52. ③ cp config.example.md config.md → 填写你的昵称和机器人账号
  53. ④ 在浏览器里登录你的 B 站账号(建议小号 —— 技能会用它发言)
  54. ⑤ 用主号在某个视频下发一条评论并 @ 那个小号
  55. ⑥ 对 AI 说:「我@你了,去看看」
  56. ⑦ 观察它:读通知 → 核对身份 → 分析视频 → 回评论
  57. ```
  58. **第 ③ 步不能省** —— 技能靠昵称核对身份,没配就不知道该回谁。
  59. ---
  60. ## 功能
  61. | 能力 | 说明 |
  62. |---|---|
  63. | **身份核对** | @ 列表里混着别人的通知;技能会逐项核对昵称,对不上就不回 |
  64. | **视频理解** | 调 `video-watch`:本地转文字 + 抽帧,不传云端 |
  65. | **按类型回复** | 教学类给**分章时间戳**;玩乐类给情绪反应;沉重内容克制处理 |
  66. | **可跳转时间戳** | 用纯文本 `00:00` 格式,B 站会自动转成点击跳转 |
  67. | **自动模式(可选)** | 自带看门狗脚本:每 30 秒自动检查 @,命中就自己看视频、自己回,再推微信告诉你 |
  68. ## 实际效果
  69. **教学类视频 —— 分章时间戳:**
  70. ![教学类视频的时间戳回复](examples/01-timestamps.png)
  71. **玩乐类视频 —— 一句短情绪,不带时间戳:**
  72. ![玩乐类短回复](examples/02-emotion.png)
  73. *(截图里对方的昵称和头像已打码。)*
  74. ## 用法
  75. 对 AI 说:
  76. > 我@你了,去看看
  77. 或者:
  78. > 去 B 站看看最新那条 @,回一下
  79. 或者干脆让它自己盯着:
  80. ```powershell
  81. cd tools
  82. .\watch-at.ps1 -Init # 首次接入:把当前最新一条设为基准
  83. .\watch-at.ps1 -InstallTask # 装计划任务,之后每 30 秒自己检查一次
  84. ```
  85. 装完之后你只要 @ 它,30 秒内它自己就回了 —— 检查不花模型 token,只有回复时才叫一次模型。
  86. ## 设计要点(踩过的坑)
  87. 这几条是真金白银换来的,都写进 `SKILL.md` 了:
  88. | 坑 | 后果 | 现在的做法 |
  89. |---|---|---|
  90. | **盲取 @ 列表第一条** | 点错别人的视频、发错评论 | 逐项**核对昵称**,7 步清单 |
  91. | **用视频顶部输入框回复** | 变成独立评论,**对方收不到通知** | 用通知里的「回复」按钮发内联回复 |
  92. | **点用户名** | 跳到对方主页 | 点**评论文本** |
  93. | **歌曲类视频转写 0 段** | AI 拿不到文字,只能硬读几十张图 → 又慢又烧钱 | 加 `--no-vad` 重跑(实测 0 段 → 57 段) |
  94. | **猜抽帧文件名** | 读图直接失败 | 从 `frames.json` 的 `file` 字段取真实文件名 |
  95. ## 注意事项
  96. - **会以你的身份在公开评论区发言。** 请确认内容得体。
  97. - **建议用小号**,并遵守 `max_replies_per_hour` 之类的自设限制。
  98. - **B 站有风控**:连发过多会弹验证码或接口返回 `-352`。别刷。
  99. - 本技能**不做**云端音视频处理,全部本地。
  100. ## 目录结构
  101. ```
  102. bilibili-reply/
  103. ├── SKILL.md 技能本体(AI 读这个)
  104. ├── config.example.md 配置模板 —— 复制成 config.md 并填写
  105. ├── tools/ 自动模式:看门狗脚本 + 配置模板 + 说明(可选)
  106. ├── examples/ 真实回复截图(已打码)
  107. ├── README.md 中文说明
  108. ├── README.en.md English
  109. └── LICENSE
  110. ```
  111. ## 许可
  112. MIT,见 [LICENSE](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.