Alterssss/dsh-bili-whale

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/Alterssss/dsh-bili-whale.svg?style=card)](https://bestofgithub.dev/repo/Alterssss/dsh-bili-whale)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/Alterssss/dsh-bili-whale.svg)](https://bestofgithub.dev/repo/Alterssss/dsh-bili-whale)

Loading README…

项	默认值	为什么
评论监听	关 ✗	开了就是每 60 秒一次请求，一天 1440 次 ✗ 小号扛不住
私信监听	开 ✓ 但 60 秒一轮	私信是她唯一的"叫得应"通道，但间隔不能短
全天监听	关 ✗	只在作息窗口（默认 20:00–24:00）内听
同一个人只回一条	开 ✓	30 天内不重复骚扰同一个人
请求间隔	1500 ms	连击是最容易被判机器人的特征
读预算	600/时 · 3000/天	私信 60 秒一轮 ≈ 1440/天，留一半余量给看视频
写预算	12/时 · 30/天	评论+私信+收藏都算写
写冷却	120 秒	两次写之间至少 2 分钟
私信冷却	60 秒
撞 412/429	暂停 5/10/20/30 分钟	尊重平台，别硬顶

通道	需要什么	只有一个号时怎么办
看视频 / 写日记 / 学偏好	只要一个号（她的 cookie）	✅ 完全可用
分享（`share.via = comment`）	同上，不需要第二个号	✅ 完全可用（在评论区 @ 你）
推送（桌面 / Webhook / 自定义命令）	同上	✅ 完全可用
私信专线（`share.via = dm` + `notify.type = dm`）	两个不同的、可登录的实名账号，且双方手动互关	❌ 做不到 —— 见下

症状	真正原因
「装完了，但找不到她」	她的会话在工作区 → 未分组里，不点开那个文件夹看不见 ✗
「找到了，但她什么都不干 / 一直报错」	那个新会话默认没有完全权限 ✗ 给她 `danger-full-access` ✓
「设置页保存了还是红的」	没点「保存」（输入框是先改在本地）✗
「cookie 填了还是未登录」	用了 `document.cookie` 取 SESSDATA ✗ 它是 HttpOnly，必须 F12 手动复制 ✓

方式	行为	适合
`评论区 @ 你`	在视频评论区发一条带 @ 的公开评论	想让别人也看到 ✓
`B站私信`	不发公开评论，把分享内容 + 视频链接私信给你	不想吵到别人 ✓（就是评论区那 110 条里喊"艾特泛滥"的人要的 ✓）

校验	说明
`share.enabled = false`	评论和私信都拒绝分享命令 ✗
`--reason`	至少 8 字，说不清为什么留就不发
`--score`	0–20，必须 ≥ `share.minScore`（默认 13）
`--rank 1`	只允许第一名

Alterssss/dsh-bili-whale

dsh-bili-whale 0.4.6

⚠️ 默认值是按「刚创的小号」定的（先看这个）

登录：扫码就行（不用再抄 Cookie）

0.4.6 新东西（先看这四条）

它能做什么

它不会做什么

人设：你想让她是谁

1) 她专属的人设 —— `~/.bili-ai/persona.md`（推荐）

2) 宿主自己的 `AGENTS.md`（兜底 / 通用底色）

三个字段也能改

账号前提（先看这个，再决定用哪条路）

装

🚦 启动测试（装完立刻跑这一条）

⚠️ 这两步是新手最常卡住的地方

想立刻看她跑一轮

分享方式二选一：评论区 @ 或 B站私信

专属通道（私信）—— 只有一条路，写死在代码里

ffmpeg（可选 · 只有"抽帧看画面"这一路要它）

Windows（最常见）

macOS / Linux

怎么确认装上了

装在别处 / 不想装

它怎么"过日子"

红线

私信监听（实时互动 · 零打扰）

依赖与移植性（装之前先读这节）

测试（v0.4.0 起自带）

许可

安装前提（2026-10-21 补，Issue #8）

本地调试怎么起（正确写法）

找不到 node 运行时怎么办（Issue #8 第三处）

视频接口排障（Issue #18）

私信历史补读修复（本地待发布）

步骤	做什么
醒来	窗口内随机时刻；30% 概率"今天不想看"
筛 5 条	只读文字（字幕/弹幕/热评），不出图，便宜
深读 2–3 条	完整档：含抽帧看画面（贵的那一步只花几次）
分享	从深读过的里挑，值不值得占用你一次注意力；不足就少发、一条不值得就不发
日记	两本都写；掷到"今天不看"也会叫醒一次（还得说明为什么不想看）
收工	扫一遍"谁找过它" → 推你一条摘要

假设	为什么依赖它	换环境怎么办
宿主能"被唤醒"	生物钟由插件宿主自己驱动：每 60 秒 tick → 跑 `night plan` → 到点用 `sessionController.prompt` 往她的会话里塞一个回合（v0.1.5 起 ✗ 不再需要人挂 `night clock`）	换 DSH 版本时确认 `sessionController` 还在；没有的话退化成"宿主侧定时轮询 + `night clock`"（老办法 ✓）
有一个通知渠道（向使用者推送）	可见性要求"自主发言后必须报备""每天推一条摘要"	换成你的：邮件 / webhook / IM / 写文件让宿主轮询。只要"使用者看得见"成立 ✓ 配置见 `config.notify`（`stdout`/`file`/`dm`/`webhook`/`command` 五种后端 —— `dm` 就是 B站私信，零外部依赖 ✓）
有一个调度器	兜底标记（宿主没开那晚也留痕）	Windows 计划任务 / Linux `cron` / systemd timer —— 都只是跑一次 `whale-night.mjs mark`
有 ffmpeg	只有"抽帧看画面"用得到	装进 PATH，或用环境变量 `FFMPEG` 指定绝对路径；不装就跳过画面那一路，其余照常
B 站账号 + 本机凭据文件	一切读写都靠它	无替代（这就是目标平台）
能 spawn 一个真 node	工具链全部是 `.mjs`，要 Node 跑	不能用 Electron 主程序顶（会静默返回空输出 ✗）；插件自己找，找不到就在体检和设置页报错
可写的专用工作目录	她的会话建在 `~/.dsh/whale-work`	别用用户主目录（会触发工作区权限问题 ✗ v0.4.0 已改）

dsh-bili-whale 0.4.6

⚠️ 默认值是按「刚创的小号」定的（先看这个）

登录：扫码就行（不用再抄 Cookie）

0.4.6 新东西（先看这四条）

它能做什么

它不会做什么

人设：你想让她是谁

1) 她专属的人设 —— ~/.bili-ai/persona.md（推荐）

2) 宿主自己的 AGENTS.md（兜底 / 通用底色）

三个字段也能改

账号前提（先看这个，再决定用哪条路）

装

🚦 启动测试（装完立刻跑这一条）

⚠️ 这两步是新手最常卡住的地方

想立刻看她跑一轮

分享方式二选一：评论区 @ 或 B站私信

专属通道（私信）—— 只有一条路，写死在代码里

ffmpeg（可选 · 只有"抽帧看画面"这一路要它）

Windows（最常见）

macOS / Linux

怎么确认装上了

装在别处 / 不想装

它怎么"过日子"

红线

私信监听（实时互动 · 零打扰）

依赖与移植性（装之前先读这节）

测试（v0.4.0 起自带）

许可

安装前提（2026-10-21 补，Issue #8）

本地调试怎么起（正确写法）

找不到 node 运行时怎么办（Issue #8 第三处）

视频接口排障（Issue #18）

私信历史补读修复（本地待发布）

1) 她专属的人设 —— `~/.bili-ai/persona.md`（推荐）

2) 宿主自己的 `AGENTS.md`（兜底 / 通用底色）