Alterssss/dsh-bili-whale

选用指南

AI 根据 README 整理 · 2026/10/24 19:26:35

使用方式

通过 DSH 插件方式安装，在设置页配置 cookie、mid 和昵称，然后通过命令行工具如 selftest 和 dm 进行测试和操作。

查看 README 依据

| **私信专线**（`share.via = dm` + `notify.type = dm`）| **两个不同的、可登录的实名账号**，且**双方手动互关** | ❌ 做不到 —— 见下 | > ⚠️ 国内一个身份证通常只能实名一个 B 站号 ✗ > 所以「第二个号」对很多人是**过不了实名**的硬墙 ✗ > 只有一个号时：**分享方式选「评论区 @」，推送选桌面通知 / Webhook / 自定义命令** ✓ > 单号模式**不能**做：私信专线、以完全独立的第二个身份出现 ✗ ## 装 **前提**：Node 18+；**ffmpeg**（看画面要用，见下）。 ```bash # 1) 装插件（本地目录 / npm 都行） dsh plugin --profile desktop add "link:C:\path\to\dsh-bili-whale" # 2) 重启一次 DSH（bundle 层要重启才组装） # 3) 打开「设置 → 养鱼」（不是 /dsh-bili/ 那个页面 —— 那个被 DSH 的信任栅栏挡着 ✗） ``` **设置页里三件事**：

设置保存在 `~/.dsh/bili-whale.config.json`（**不含凭据**）；凭据单独在 `~/.bili-ai/credentials.json`，**永远不回显**。 --- ## 🚦 启动测试（装完**立刻**跑这一条） ```bash node <插件目录>/tools/bili.mjs selftest ``` （Windows 路径换成 `%USERPROFILE%\.dsh\plugins\dsh-bili-whale\tools\bili.mjs`） 它会把该确认的事列成一张表：配置 / 凭据 / 登录态 / 数据目录 / 依赖体检， 缺哪项就直说缺哪项，**最后两行是绝大多数人卡住的地方**： ``` ────────── 接下来要做的两件事（很多人卡在这）────────── ① 【找到她的会话】 插件启动时会自动开一个会话，位置在： 左侧「工作区」→ 展开「未分组」文件夹 → 里面那个 bili-whale ⚠️ 不点开「未分组」是看不见它的 —— 这一步最容易漏 ✗ ② 【给她完全权限】 打开那个会话 → 权限设置 → 选「完全访问 / danger-full-access」 否则她起来后跑不了命令、发不了评论、写不了日记 ✗

部署要求

需要 Node 18+ 和 ffmpeg（可选，用于抽帧看画面）。必须挂在带网页界面的 DSH 组件层上运行，无界面模式无法启动。需要 B 站账号的 cookie 和主人账号的 mid。

查看 README 依据

| **私信专线**（`share.via = dm` + `notify.type = dm`）| **两个不同的、可登录的实名账号**，且**双方手动互关** | ❌ 做不到 —— 见下 | > ⚠️ 国内一个身份证通常只能实名一个 B 站号 ✗ > 所以「第二个号」对很多人是**过不了实名**的硬墙 ✗ > 只有一个号时：**分享方式选「评论区 @」，推送选桌面通知 / Webhook / 自定义命令** ✓ > 单号模式**不能**做：私信专线、以完全独立的第二个身份出现 ✗ ## 装 **前提**：Node 18+；**ffmpeg**（看画面要用，见下）。 ```bash # 1) 装插件（本地目录 / npm 都行） dsh plugin --profile desktop add "link:C:\path\to\dsh-bili-whale" # 2) 重启一次 DSH（bundle 层要重启才组装） # 3) 打开「设置 → 养鱼」（不是 /dsh-bili/ 那个页面 —— 那个被 DSH 的信任栅栏挡着 ✗） ``` **设置页里三件事**：

node --test tests/planner.test.mjs tests/integration.test.mjs tests/updates.test.mjs tests/supplement.test.mjs ``` 57 个用例，覆盖： - 计划器：跨午夜、绝对时间戳、跳过不重抽、重启后计划仍在、按真实截止排序、旧状态迁移 - 分享策略：开关 / 评分 / 理由 / 排名，**评论与私信两条通道都测** - 集成：自定义 `DSH_HOME`、人设注入、日记推送开关、审批失败后草稿恢复、 Node 运行时缺失时报错、调度器的午夜行为与清理 > 测试用**临时目录 + 虚构凭据 + 模拟网络与宿主接口** —— 不登录真实账号，也不发真实消息 ✓ > 它验证的是逻辑，不是真实 DSH 版本兼容性和 B 站接口可用性 ✗ 那两样只能装上去跑。 --- ## 许可 MIT（见 `LICENSE`）。第三方与免责见 [`NOTICE.md`](NOTICE.md)。 本项目是**个人自用工具的公开版**，与 B 站、DeepSeek 官方无隶属关系；用你自己的账号做事，后果自负。 <!-- 2026-10-21 issue#8 fix --> ## 安装前提（2026-10-21 补，Issue #8） **这个插件必须挂在带网页界面的组件层上运行。**

已知限制

默认配置保守，评论监听默认关闭，全天监听默认关闭，请求间隔 1500ms。私信功能需要两个不同的实名账号且互关，单号模式无法使用私信专线。分享每天最多 3 条，同一视频 7 天内只分享一次。

查看 README 依据

# dsh-bili-whale 0.4.6 > 给 DSH 装一条**有日子的鱼**：它自己按作息刷 B 站、真看懂视频、写两本日记，把值得的 **@ 你**。 > > 不是"定时任务 + 关键词搜索"，是**生物钟 + 偏好 + 克制**：每天只醒一两次，筛五条、深读两三条、**最多 @ 你三次**。 她该长成什么，见 [VISION.md](VISION.md)；每一版的改动见 [CHANGELOG.md](CHANGELOG.md)。 ## ⚠️ 默认值是按「刚创的小号」定的（先看这个） 新装用户的默认配置是**保守**的。原因很直接：**长时间高频轮询是小号被风控的头号原因** ✗ | 项 | 默认值 | 为什么 | |---|---|---| | **评论监听** | **关** ✗ | 开了就是每 60 秒一次请求，一天 1440 次 ✗ 小号扛不住 | | **私信监听** | **开** ✓ 但 **60 秒一轮** | 私信是她唯一的"叫得应"通道，但间隔不能短 | | **全天监听** | **关** ✗ | 只在作息窗口（默认 20:00–24:00）内听 | | **同一个人只回一条** | **开** ✓ | 30 天内不重复骚扰同一个人 | | **请求间隔** | **1500 ms** | 连击是最容易被判机器人的特征 |

`~/.dsh/AGENTS.md` 会被 DSH **在所有会话里热加载** —— 所以它对**每一个** agent 生效， 不只对她 ✗ 想只改她就用上面的 `persona.md` ✓ 这里适合放**通用红线**（不说假话、不冒充你、不伤害第三方）和跨端的协作约定。 ### 三个字段也能改 设置页里那三个（角色名 / 怎么称呼你 / 怎么自称）会拼成一行身份提示： ``` ［身份］你是「…」，称用户「…」，自称「…」。 ``` 只是称呼提醒，放不下详细人设 ✓ 详细内容写 `persona.md` ✓ > 旧版本的 `persona.example.md` 已移除：那是**某个具体的人**的人设，不该当模板发出来 ✗ --- ## 账号前提（先看这个，再决定用哪条路） 这个插件是**两个号的模型**：「她」一个号，「你（主人）」一个号。同一个号做不到"她跟你说话"。 | 通道 | 需要什么 | 只有一个号时怎么办 | | --- | --- | --- | | 看视频 / 写日记 / 学偏好 | 只要一个号（她的 cookie）| ✅ 完全可用 | | 分享（`share.via = comment`）| 同上，不需要第二个号 | ✅ 完全可用（在评论区 @ 你）| | 推送（桌面 / Webhook / 自定义命令）| 同上 | ✅ 完全可用 |

| `B站私信` | **不发公开评论**，把分享内容 + **视频链接**私信给你 | 不想吵到别人 ✓（就是评论区那 110 条里喊"艾特泛滥"的人要的 ✓）| > 两种方式**共用同一本分享额度**：≤3 条/天 · 同一视频 7 天一次 · 评分 ≥13/20 ✓ > 判重按 **BV 号**算（不是按"发给谁"算）✓ **两条通道走同一套校验**（v0.4.0 起）—— 关掉分享总开关，私信也发不出去： | 校验 | 说明 | |---|---| | `share.enabled = false` | 评论和私信**都**拒绝分享命令 ✗ | | `--reason` | 至少 8 字，说不清为什么留就不发 | | `--score` | 0–20，必须 ≥ `share.minScore`（默认 13）| | `--rank 1` | 只允许第一名 | > 以前私信那条**绕过**了这些校验（关掉分享还能发）✗ v0.4.0 修了 ✓ > 普通聊天私信（不分享视频）不受这些限制 —— 它不需要评分 ✓ --- ## 专属通道（私信）—— 只有一条路，写死在代码里 想把东西**私密地**送到你手里、又不想在评论区吵到别人？用 `dm`（**一天同一个人不限条数** ✓）： ```bash