电子榨菜罐 · dsh-bili-jar

DSH 插件。右下角一只罐子，点开是今天该看的 B 站视频。

先看三行：

• 需要 dsh ≥ 0.1.7；装完要重启一次（插件在 bundle 层组装）。
• 需要 你自己的 DeepSeek API Key。一轮「换一批」大约 ¥0.004–0.01。
• 不用 B 站的推荐流。挑片的规则是你自己写的兴趣轴，最后一步交给模型挑。

罐子平时睡着，装罐时会走两步：

_{上图是用同一套 CSS 在本地渲染的预览，不是截屏。}

它干什么

• 按你填的兴趣轴（deepseek / 时政 / 历史 / 随便什么）去搜 B 站
• 按互动率（赞、币、藏、弹幕除以播放）排好坏，而不是播放量
• 结果并进一个池子，跨天累积；今天没搜到的好东西，明天被别的词带出来还在
• 最后把前 24 条交给模型，让它挑 5 条，每条写一句理由
• 理由只说内容：讲了什么、怎么讲的、适合什么时候看。数据用来挑，不写进理由
• 点开卡片能小窗播放；不感兴趣的可以 👍/👎（攒够 20 条开始影响打分）
• 点击标题、「打开」或「小窗」即记为已观看，从推荐、关注和待看中移除，小红点同步减少（只统计推荐列表）。「历史」页保留最近 10 条，重复观看移到最前，重启后仍保留；历史超过 10 条时移除最早记录，当前片单仍不会补回已看视频。

模型没配或调用失败时退回纯规则挑片：每根轴先挑一条相似度 ≥0.85 的，同轴最多 2 条、同 UP 最多 1 条。片单不会因为没模型就空着。

一轮都经过什么

搜     每根轴 3 个词（其中 1 个按小时轮换），4 根轴约 9 次搜索，回来 180 条
并池   和上一轮的池子合并，同一个 BV 只更新数据
筛     时长、播放门槛、充电专属、直播回放、日期窗口（默认 14 天，可设 0 = 不限）、贴不上任何轴 —— 全砍
打分   赞/币/藏/弹幕的率 0.39 + 贴轴 0.30 + 新鲜度 0.10 + 小众 tag 0.06 + 字幕 0.06 + 播放 0.05 + 多轴 0.04
补查   前 12 名回查真实投币数（搜索接口给的是旧的），重新打分
策展   只把前 24 名交给模型，让它挑 5 条、写理由

为什么只给模型 24 条：给整个池子也能挑，但一次调用会贵十倍，挑得还未必更好。

日期窗口可以在设置里改（「日期窗口（天）」，填 0 就是不限）。设成 0 之后新鲜度改用 365 天软衰减 —— 老片能进来，但不是和今天发的完全等价。

小众 tag 分：一条视频的 tag 在池子里越罕见，这一项越高（取最罕见的三个 tag 平均）。目的是别让「必剪创作 / 高能」这种大标签把长尾内容挤下去。

预设

装好就有，不用配：

类型	自带
兴趣轴	30 根：游戏 / 音乐 / 舞蹈 / 动画 / 知识 / 科技 / 影视 / 娱乐 / 生活 / 美食 / 运动 / 汽车 / 时尚 / 动物 / 鬼畜 / 纪录片 / 搞笑 / 学习 / 手工 / 摄影 / 历史 / 哲学 / 心理学 / 编程 / 数学 / 物理 / 军事 / 财经 / 职场 / 育儿
子簇	68 个，比如「游戏 → 沙盒游戏 / 游戏推荐 / 独立游戏」
语气	三套：鲸鱼女仆 / 正经简报 / 损友吐槽
头像	四张：睡觉 / 看电视 / 探险 / 哦鲸鲸

清单在 docs/presets.md。设置页点「＋ 游戏」就把整根轴连子簇加进来。

轴树会长。 如果预设里没有你要的，或者不够细，点「看建议」：

1. 从你池子里的 tag 挖候选（DF + 两两共现 PMI；跟谁都不特别的高频词会被当泛标签丢掉）
2. 模型再过一遍：判是不是真细分方向、是不是别的轴的词、起个能当标签用的名字、说一句为什么
3. 你点一下才写进自己的树（存在 ~/.dsh/bili-jar/axis-tree.json，不碰出厂值）

实跑过的例子：历史 挖出「人文历史档案馆 / 人文 / 美国」，模型全否了，理由是「UP 主品牌不是分类」「太泛」「属于时政轴」；deepseek 留了三个，把 ai编程 改成 AI 编程，把 claude 当作别轴的词丢掉。

记账

三层：单次 / 今天 / 累计。按 DeepSeek 官方规则算钱 —— 北京时间工作日 09:00–12:00、14:00–18:00 是峰时，其余（含周末和法定节假日）半价。

元 / 百万 token	缓存命中	未命中	输出
峰时	0.04	2	8
谷时	0.02	1	4

历史记录按每条自己的时间戳重算，改规则会把旧账一起修正。

装

桌面版的 desktop profile 不让 CLI 装插件，只能手改依赖：

// ~/.dsh/profiles/desktop/package.json
{
  "dependencies": { "dsh-bili-jar": "link:D:/你的路径/电子榨菜罐" },
  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "dsh-bili-jar"] } }
}

cd ~/.dsh/profiles/desktop && pnpm install

其他 profile：

dsh plugin --profile web add dsh-bili-jar

装完重启 dsh，再刷新页面。

第一次用

1. 点罐子 → 设置 → 填 API Key（DeepSeek 官方）
2. 改兴趣轴。默认那四根是我的口味，换成你的
3. 回「推荐」，点换一批

B 站登录是可选的，只用来取 AI 字幕。二维码是插件自己画的（lib/qr.mjs，零依赖），凭证落在自己的目录里。

数据都在哪

~/.dsh/bili-jar/

文件	内容
config.json	面板里的设置 + 语气预设（含明文 API Key）
feed.json / pool.json	当前片单 / 池子
reasons.json	攒下来的推荐理由，关掉再开还能用
usage.json	每次调用的 token 和费用
feedback.jsonl / later.json	赞踩 / 待看
history.json	最近 10 条观看记录，最新在前
credential.json	B 站登录，只有你自己扫码才有
STATE.md	人话摘要：现在什么配置、这一批推了什么、花了多少

安全

做过一次检查，结论都写在这：

• 只监听 127.0.0.1（DSH 的 webServer 本来就这么绑），局域网访问不到
• 跨站请求一律拒：带 Sec-Fetch-Site: cross-site，或者 Origin 不是本机的，直接 403。避免你开着插件逛网页时，被某个页面偷偷改配置或触发付费调用
• API Key 明文存在 config.json，但所有 HTTP 接口只返回 sk-••••后四位，/debug 也一样
• B 站 cookie 存在 credential.json，只在你自己扫码后写入；POSIX 下用 0600
• 不读别的插件的凭证，除非你在设置里显式打开「复用刷B站的登录」（默认关）
• 不收集遥测，不往作者的任何服务器发数据。出站只有两处：bilibili.com 和你配的模型 API
• 小窗播放是 player.bilibili.com 的 iframe，等于在页面里跑 B 站的播放器

已知的限制

• 时政区很多视频没有 tag，只能靠标题里的实体词判断。「时政」这个词在 B 站被考公内容占着，真·国际时政得用实体词搜（见 docs/tag-tree.md）
• 赞踩的学习很粗：只看 UP 和 tag，不看内容本身
• 越往后捞越靠近池子边缘。「更多电子榨菜」按互动率排队，不像首推那样经过模型
• 预设树里有些子簇的词不干净（带 UP 名或活动名），个别大区（科技 / 音乐）只挖出 1–2 个
• 没有端到端测试，只有 tools/ 里几个自检脚本

结构

文件	干什么
index.js	host 半端：配置、HTTP 路由、池子落盘、策展接线
client.js	浏览器半端：罐子 + 面板
lib/bili.mjs	B 站客户端：WBI 签名 / 搜索 / 详情 / 粉丝 / 投稿 / 字幕
lib/pool.mjs	候选池：轴匹配、硬过滤、打分、按轴轮转
lib/tree.mjs	轴树：内置 + 用户自己长的枝；子簇挖掘
lib/axis-presets.mjs	30 根预设轴（工具生成，别手改）
lib/tree-review.mjs	让模型审子簇建议
lib/curator.mjs	让模型挑片并写理由
lib/reasons.mjs	写理由（API 直连 → 宿主模型兜底），带磁盘缓存
lib/usage.mjs	token 记账 + 峰谷计价
lib/qr.mjs	零依赖 QR 编码器
lib/statefile.mjs	生成 STATE.md
lib/hostdeps.mjs	从宿主树里取 @deepseek-ai/*

工具

node tools/why.mjs BV1xxxxx        # 这条为什么没进罐子？逐关诊断
node tools/feed.mjs 10000 0        # 跑一次建池，打印片单
node tools/tree-suggest.mjs 历史    # 从池子里挖子簇建议
node tools/tree-review.mjs deepseek # 规则 + 模型审一遍（--apply 才写盘）
node tools/qr-check.mjs            # QR 编码器与 Python qrcode 逐位比对
node tools/affinity-check.mjs      # 赞踩加权的单测
node tools/pack-check.mjs          # 发版前自检
python tools/cutout.py in.png out.png   # 抠掉画在图里的棋盘格
python tools/sprites.py                 # 从设定表切走路帧

发版

pnpm check          # 自检
npm version patch
git push --follow-tags

推 tag 会触发 .github/workflows/publish.yml 发 npm。细节在 docs/publish.md。

更新日志

0.2.x

• 预设轴树 30 根 / 68 个子簇；子簇可以从池子里长，模型审过再采纳
• 前端重做：插画面板、装罐时走路、列表底部的小人、四档头像
• 赞踩参与打分；小窗播放；语气预设支持导入 .md
• 修：峰谷按本机时区算（成本算成一半）、/explain 的 ReferenceError、/debug 泄露 key、explainOn 死开关、换头像不刷新页头、走路帧被裁掉背包、设置页打不开（漏声明）、头像上传被 64KB 限制挡住
• 安全：拒跨站请求、响应加 nosniff、凭证文件 0600

0.1.0 第一版：按轴搜索、互动率打分、累积池、策展、扫码登录、记账。

许可

代码 MIT。插画（assets/jar-*.png / av-*.png / walk-*.png）由作者用豆包生成，随仓库提供，只用于这个插件的界面。「哦鲸鲸」那档头像取自 dsh-whale-widget（MIT），详见 NOTICE。