Alterssss / dsh-bili-whale

# dsh-bili-whale
> 给 DSH 装一条**有日子的鱼**：它自己按作息刷 B 站、真看懂视频、写两本日记，把值得的 **@ 你**。
>
> 不是"定时任务 + 关键词搜索"，是**生物钟 + 偏好 + 克制**：每天只醒一两次，筛五条、深读两三条、**最多 @ 你三次**。
---
## 它能做什么
- **自己醒**：在你设定的窗口里**随机一个时刻**醒来（不是整点）；**30% 概率今天不想看**（它也有权利不看）
- **真看懂**：读官方字幕 + 弹幕热区 + 热评 + **抽帧看画面**（六路互补，没字幕的视频也能看懂）
 - 没字幕轨、但画面里有**硬字幕**？用 `debrief --substrip` —— 把字幕带按时间裁下来拼成一张图，**整片台词一张图读完**
- **写日记**：给**你**的那本（"给主人的信"，有细节有情绪）+ 给**她自己**的那本（不加滤镜）
- **分享给你**：从深读过的里挑 2–3 条，发一条**带 @ 你**的评论（每天合计 ≤3）
- **听人找它**：评论区监听（全天开关 + 间隔可调）+ 直播间弹幕（**独立开关、实时回、可只回你**）
 - **回复分两侧**：你是主人 → **直接回** ✓；其他人 → **先写草稿推给你审** ✓（草稿会推到你的推送渠道）
 - **沉默会衰减**：连续 3 天没有任何表态 → 分享额度开始降 → **第 7 天归零**（不再分享），**但日记照写** ✓
- **克制**：撞到风控（验证码/限流/判刷屏）**立刻停手**并报告你
## 它**不会**做什么
- ❌ 给陌生人发私信 / 群发（**唯一的私信通道**见下：只发给主人 · 1 天 1 条 · 必须互关，三条都写死在代码里）
- ❌ 三连 / 投币 / 关注 / 花钱（礼物、充电）
- ❌ 批量刷量、多账号、绕过风控
- ❌ 抓全站数据
- ❌ 动你的账号安全设置
> 它用**你自己的账号**说话 —— 所以默认是"少说、看准了再说"。
---
## 人设是空白的
这个插件**不内置任何人格**。默认它是个中性助手：不叫你"主人"、不撒娇、不说"人家"。
想让它变成**你的**那条鱼：写宿主自己的 `AGENTS.md`（DSH 会在每个会话里热加载它）。
下面这几样是它真正会读的，照你的写：
- **称呼 / 自称 / 性格 / 句式**（"主人"、"人家"、傲娇 —— 都是可以换的 ✓）
- **红线**（不能叫胖、不冒充你、不说假话）
- **日子**（偏好、作息、日记格式、倾听与回复的分寸）
不想要人设也行 —— 不写就回到中性。
（旧版本的 `persona.example.md` 已移除：那是**某个具体的人**的人设，不该当模板发出来 ✗）要的样子 ✓
（称呼、自称、性格、句式、红线 —— 照你写的来；不想要人设就删掉它。）
---
## 装
**前提**：Node 18+；**ffmpeg**（看画面要用，见下）。
 [code] 
**设置页里三件事**：
1. **填 cookie** —— 在 `bilibili.com` 页面按 **F12 → Application（应用）→ Cookies → https://www.bilibili.com**，
 手动复制 `SESSDATA`、`bili_jct`、`buvid3` 三个值粘进设置页 ✓
 （⚠️ 别用 `document.cookie` ✗ —— `SESSDATA` 是 **HttpOnly**，脚本里读不到，照那个做会得到一份缺件的 cookie 然后卡在体检）
2. **填你的 mid + 昵称** —— 分享评论要 @ 的人
3. **点「依赖体检」** —— 它会**真的去请求一次** B 站验证登录态，并检查 ffmpeg / Node / 数据目录
> ⚠️ **改完一定要点「保存」** —— 设置页的输入框是**先改在本地、点保存才落盘**的 ✓
> 不点保存 = 什么都没发生（刷新一下就变回原样 ✗，这个坑本鲸自己也踩过 ✗）
>
> ✅ **保存即生效**：作息窗口 / 评论监听 / 直播间开关 / 消息推送 / 分享闸门，都是保存后立刻重算 ✓
> ⚠️ 只有**换插件代码/版本**才需要重启 DSH（改配置不用 ✗）
设置保存在 `~/.dsh/bili-whale.config.json`（**不含凭据**）；凭据单独在 `~/.bili-ai/credentials.json`，**永远不回显**。
---
## 🚦 启动测试（装完**立刻**跑这一条）
 [code] 
（Windows 路径换成 `%USERPROFILE%\.dsh\plugins\dsh-bili-whale\tools\bili.mjs`）
它会把该确认的事列成一张表：配置 / 凭据 / 登录态 / 数据目录 / 依赖体检，
缺哪项就直说缺哪项，**最后两行是绝大多数人卡住的地方**：
 [code] 
### ⚠️ 这两步是新手最常卡住的地方
| 症状 | 真正原因 |
|---|---|
| 「装完了，但找不到她」 | 她的会话在 **工作区 → 未分组** 里，**不点开那个文件夹看不见** ✗ |
| 「找到了，但她什么都不干 / 一直报错」 | 那个新会话**默认没有完全权限** ✗ 给她 `danger-full-access` ✓ |
| 「设置页保存了还是红的」 | 没点「保存」（输入框是先改在本地）✗ |
| 「cookie 填了还是未登录」 | 用了 `document.cookie` 取 SESSDATA ✗ 它是 HttpOnly，必须 F12 手动复制 ✓ |
### 想立刻看她跑一轮
设置页 →「生物钟」→ 把作息窗口改成**现在之后 2 分钟**的一小段 → 保存 → 等她自己醒 ✓
（她醒来会：体检 → 选题 → 看懂 → 写两本日记 → 推给你；不用你说话 ✓）
---
## 分享方式二选一：评论区 @ 或 B站私信
设置页「分享」里可以选：
| 方式 | 行为 | 适合 |
|---|---|---|
| `评论区 @ 你` | 在视频评论区发一条带 @ 的**公开**评论 | 想让别人也看到 ✓ |
| `B站私信` | **不发公开评论**，把分享内容 + **视频链接**私信给你 | 不想吵到别人 ✓（就是评论区那 110 条里喊"艾特泛滥"的人要的 ✓）|
> 两种方式**共用同一本分享额度**：≤3 条/天 · 同一视频 7 天一次 · 评分 ≥13/20 ✓
> 判重按 **BV 号**算（不是按"发给谁"算）✓
---
## 专属通道（私信）—— 只有一条路，写死在代码里
想把东西**私密地**送到你手里、又不想在评论区吵到别人？用 `dm`（**一天同一个人不限条数** ✓）：
 [code] 
三条限制**不接受参数覆盖**（`commands/dm.mjs` 顶部的常量）：
1. **一天只锁定 1 个收信人**（防刷量）—— 对**这一个人**发多少条都行 ✓