前言¶

在 DSH 里做 agent，常见做法是定时任务加关键词搜视频，再把链接丢进会话让人自己点。视频内容、评论区和弹幕往往进不了上下文，分享也多半靠你手动 @。如果你希望 agent 在可控频率下自己「醒」、尽量看懂片子、记两本日记，并把值得的内容用 @ 或私信送到你手里，需要一套和 B 站登录、风控、推送绑在一起的工作流插件，而不是零散脚本。

下面介绍社区插件 dsh-bili-whale（维护者 ggxx001，分类：工作流）。它在 DeepSeek Harness 里注册「养鱼」设置页与调度逻辑，用同一账号在 B 站读视频、写日志，并按规则联系主人。

这是什么¶

dsh-bili-whale（当前资料版本 0.4.6）的定位是：给 DSH 装一条「有日子的鱼」——在作息窗口内随机醒来，按偏好筛片、深读，写「给主人的信」和给自己的日记，每天最多主动 @ 主人三次；不是整点 cron，也不是无节制轮询。

插件描述与设置页强调：「养鱼」完整设置（资料称 27 项）、依赖体检、Cookie 写入（及 2026-10-25 起支持的扫码登录）、与工具链共享的 bili-whale.config.json。配置落在 ~/.dsh/bili-whale.config.json（不含凭据）；凭据在 ~/.bili-ai/credentials.json，设置页不回显。

生态上，DSH 主张「一切皆插件」；目录页在 SkillHub，与 DeepSeek / 幻方无官方从属关系，安装前宜自行查看 GitHub 源码 与 MIT 许可证。

核心能力（与 README 一致）¶

作息与克制¶

• 在设定窗口内随机时刻醒来；约 30% 概率当天不看。
• 默认面向「刚创的小号」保守：risk 相关项控制评论监听（默认关）、私信监听间隔、读写预算、412/429 退避等；老号可在 ~/.dsh/bili-whale.config.json 调大，新号不建议动默认值。
• 0.4.6 另有一层写死的请求保护层（如全局请求间隔 600ms、读 3000/天、写 30/天等）；真实值可查：node tools/bili.mjs traffic status。

看懂视频¶

• 官方字幕、弹幕热区、热评、抽帧看画面（六路互补）；抽帧九宫格默认每格 720 像素，可用 --tile 调整。
• 无字幕轨但有硬字幕时，可用 debrief <BV> --substrip 按时间裁字幕带拼成一张图再读。

日记与分享¶

• 两本日记：给主人（有细节有情绪）、给自己（不加滤镜）。
• 分享：从深读里挑 2–3 条，评论区 @ 或 B 站私信（设置里二选一），共用额度 ≤3 条/天，同一 BV 7 天一次，评分默认 ≥13/20。
• 0.4.6 可选「疑似 AI 评论」闸（默认关）：主动视频 @ 分享前抽检评论，疑似比例 ≥30% 则暂缓分享并推送。

听人找它¶

• 评论监听、直播间弹幕（独立开关）；主人直接回，其他人先草稿推给你审。
• 连续 3 天无表态则分享额度递减，第 7 天归零（日记仍写）。

明确不做的事¶

不给陌生人群发私信、不三连/投币/关注/花钱、不批量多账号、不抓全站、不改账号安全设置。私信专线写死：只发配置的 owner.mid、须互关、一天锁定一个收信人。

双号模型（使用前必读）¶

「她」一个 B 站号、「你」一个号。只看视频、写日记、评论区 @ 分享、桌面/Webhook 推送，单号即可。share.via = dm 且推送走 B 站私信时，需要两个不同实名号且手动互关；国内一证一号时，应选「评论区 @」加非 DM 推送。

安装与启用¶

前提：Node 18+；ffmpeg（看画面需要）。

官方 README 给出的安装方式为本地 link（请换成你的插件目录路径）：

dsh plugin --profile desktop add "link:C:\path\to\dsh-bili-whale"

装完后重启一次 DSH（bundle 层需重启才组装）。设置入口是 「设置 → 养鱼」，不是 README 里说明会被信任栅栏挡住的 /dsh-bili/ 页面。

设置页三件事：

1. 登录：「B 站登录 → 扫码登录」（约 3 分钟有效）；或 F12 → Application → Cookies 手动复制 SESSDATA、bili_jct、buvid3（勿用 document.cookie 取 SESSDATA，HttpOnly 会缺件）。
2. 填主人 mid + 昵称（分享 @ 用）。
3. 依赖体检并点保存（改输入框后必须保存才落盘；多数策略保存即生效，换插件版本才需再重启 DSH）。

装完立刻自检：

node <插件目录>/tools/bili.mjs selftest

通过表项后，README 强调两步常漏：

1. 左侧工作区 → 展开 「未分组」 → 打开 bili-whale 会话。
2. 该会话权限设为 完全访问 / danger-full-access，否则无法跑命令、评论、写日记。

人设推荐写在 ~/.bili-ai/persona.md（设置页「她是谁」可注入，生效取前 3000 字）；通用红线可放 ~/.dsh/AGENTS.md（对所有 agent 生效）。

典型用法¶

立刻看一轮：设置页「生物钟」把作息窗口改成「现在之后约 2 分钟」→ 保存 → 等待自动唤醒（体检 → 选题 → 看懂 → 双日记 → 推送）。

Cookie 探活（插件目录下）：

node bili.mjs auth-check
node bili.mjs auth-check --sync --go

私信专线（须互关、仅 owner）：

node bili.mjs dm --status
node bili.mjs dm --msg "…" --dry
node bili.mjs dm --msg "…" --go

想马上验证配置：把窗口调到即将醒来的时间段即可，无需在会话里手动下指令。

适用场景与注意¶

适合：已在用 DSH desktop profile、愿意用专用或小号 B 站身份、接受「少写、看准再说」与平台风控约束，希望 agent 工作流自动刷片、记日记、有上限地 @ 或私信你的开发者。

务必注意：

• 插件以当前 DSH 进程权限运行，会话需 danger-full-access；安装前应通读源码与许可证，自行评估账号与合规风险。
• 默认配置为防小号风控设计；高频轮询、开评论监听等会显著增加请求次数。
• B 站 Cookie 无 refresh，失效需重新扫码或从浏览器同步；扫码请使用给插件用的号，勿误扫主人号。
• 有待审草稿时不允许切换账号，避免发错号。

结尾¶

dsh-bili-whale 把 B 站读、写、分享、监听和 DSH 设置页、调度捆成一条工作流：生物钟式唤醒、多源看懂视频、双日记与有额度的 @，并在风控与双号限制下收窄能力边界。目录与说明见 SkillHub 插件页，源码与变更见 GitHub：ggxx001/dsh-bili-whale。