dsh-bili-jar
DSH 插件：电子榨菜罐 —— 按你的兴趣轴定向挑 B站 视频的常驻小挂件
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-bili-jar@0.3.0Bili Jar 以 dsh-bili-jar 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
鲸鱼娘带着一个罐子，守在右下角。按照你的兴趣，她会去 B 站探险，按赞币藏率排， 给你找一些符合口味的电子榨菜。
她平时睡着。点一下罐子，她就出门找，回来把五条装进罐子，再和你说说这些视频讲了什么。
出门找 → 满载而归 面板面板图是用插件自己那套 CSS 渲染的，不是屏摄 —— 真机上长得一样，只是多了窗口背景。
先看四行：
¥0.004–0.01。deepseek / 时政 / 历史 / 随便什么）去搜 B 站模型没配或调用失败时退回纯规则挑片：每根轴先挑一条相似度 ≥0.85 的，同轴最多 2 条、同 UP 最多 1 条。片单不会因为没模型就空着。
搜 每根轴 3 个词（第 3 个按小时轮换）：前两个走综合排序保相关，第 3 个走「最新发布」保新鲜
熟人 你赞过 / 点开过 / 加过稍后看的 UP（最多 6 个）直接拉最新投稿，3 天内的进候选并加权
补货 某根轴凑不够 3 条时，换两条通道再找：按时长带重搜（news 轴走最新、常青轴走综合）+ 从种子扩散（相关推荐，30 天内的新种子优先）
并池 和上一轮的池子合并，同一个 BV 只更新数据；池子上限 400，一直没再露面的先淘汰
筛 时长、播放门槛、充电专属、直播回放、日期窗口、贴不上任何轴 —— 全砍
打分 两套权重各自合计 1.00：news 轴的时效占 0.10，evergreen 轴只占 0.02（差额给了播放 +0.03 和小众 tag +0.05）；其余一样：赞/币/藏的率 0.39 + 贴轴 0.30 + 字幕 0.06 + 多轴 0.04
扣分 进过 main 的条目每轮 -0.03（封顶 0.15），把位置让给没见过的
打乱 前 5 名固定，其余按分数加权抽签（设置里「多样性」0–1）；种子记进 stats，能重放
补查 前 12 名回查真实投币数（搜索接口给的是旧的），重新打分
补漏 新条目缺互动数据时每轮补查 8 条（播放涨得快的优先），回查前按冷启动给 0.01–0.05 的临时加分；补过的数据 7 天后过期，每轮再刷 3 条
配额 main 里至少一条「3 天内 + 播放达标 + 贴轴 + 非标题党」，没有就从合格候选里换一条进来（只换轴上还有队友的最低分）
回音室 熟人来源最多 2 条 —— 规则挑完收一次，模型策展完再收一次
策展 只把前 24 名交给模型（每条带上「发布几天前」和数据是否已回查），让它挑 5 条、写理由
为什么只给模型 24 条：给整个池子也能挑，但一次调用会贵十倍，挑得还未必更好。
「换一批」会排除最近 5 轮推过的所有条目（≤25 条）+ 已观看的 —— 之前只排除上一轮那 5 条，池子里的老面孔每轮都回来。
不是每半小时就在后台重跑一遍 —— 那样既慢（一次完整重建二三十秒）又费钱（每次都要叫一次模型）。分三档：
| 距上次完整重建 | 做什么 | 代价 |
|---|---|---|
| 不到 3 小时 | 不动，直接用手里这批 | 0 |
| 3–24 小时（你打开面板时）或满 6 小时（不管开不开） | 轻量探测：6 个熟人的最新投稿 + 每根轴一次「最新发布」 | 8–14 次请求，不叫模型、不算分 |
| 超过 24 小时 | 完整重建，就是上面那一整套 | 一次全量 + 一次模型调用 |
轻量探测只在真捞到「够新 + 有人看 + 贴轴」的片子时才升级成完整重建；捞不到就继续用手里这批。所以**「一直没变」通常是正常的** —— 两小时内本来就不会凭空多出好片。
探测过一次，两个计时一起清零，不会重复触发。想看时间戳：~/.dsh/bili-jar/refresh.json，人话版在 STATE.md 里。
只用你自己的本地记录，不联网查你的账号：
| 来源 | 权重 |
|---|---|
| 👍 点赞 | 1 次互动 |
| 稍后看 | 1 次互动 |
| 点开看过 | 1 次互动 |
| 👎 踩 | 扣 2 次 |
转正之后，他的新片（3 天内）会直接进候选，并且加一点权重 —— 这是预测，不等点赞率、投币率攒成形。观察中的只加半个权重。
名单不占设置页的地方，只在日志（ups:list）和 STATE.md 里报一行。想重置就删 ~/.dsh/bili-jar/ups.json，下次自己重新长。
同一个窗口不可能同时适合「时政」和「空洞骑士攻略」—— 前者 14 天就过期，后者 2023 年的攻略今天照样有用。
所以每根轴有一个 freshness：
| 日期窗口 | 时效分权重 | |
|---|---|---|
news | 14 天（全局可改） | 0.10 |
evergreen | 不限 | 0.02 |
怎么定的：不看条数，看合格条目的年龄中位数。超过 90 天就算常青内容。
实测七个冷门词，分得很干净：丝之歌 361 天、空洞骑士 2052 天、vtuber 2385 天（都是 evergreen）；时政 13 天、深蓝 26 天、术力口 5 天、kards 5 天（都是 news）。中间几乎没有模糊地带。
条数会跟着搜索结果抖（同一个词两次跑，命中数会变），中位数不会 —— 所以拿它当判据。
新轴默认 news，跑一轮后自动看：如果它凑不够 3 条、而且合格条目普遍很老，就在同一轮里改判成 evergreen，日志记一行原因。设置页每根轴旁边有个两态小开关，点了就是手填，手填之后不再被自动覆盖。
搜「空洞骑士」时，B 站 的前 3 页被续作「丝之歌」的新内容占满，五年前的好视频排不进来 —— 有一条 33 分钟、108 万播放的攻略要翻到第 4 页才有。
所以凑不够 3 条时会走两条补充通道：
duration 参数（1=<10 分 / 2=10–30 / 3=30–60 / 4=>60 分），一页 20 条全落在想要的时长里，比混着搜再筛掉强得多/x/web-interface/archive/related?bvid= 是按内容相似度给的，不受新内容淹没。从任意 3 条同主题视频出发（不需要它们合格），去重后能捞回几十条，其中就有搜不到的那条两条通道都是纯 HTTP，不花模型钱。
小众 tag 分：一条视频的 tag 在池子里越罕见，这一项越高（取最罕见的三个 tag 平均）。目的是别让「必剪创作 / 高能」这种大标签把长尾内容挤下去。
装好就有，不用配：
| 类型 | 自带 |
|---|---|
| 兴趣轴 | 30 根：游戏 / 音乐 / 舞蹈 / 动画 / 知识 / 科技 / 影视 / 娱乐 / 生活 / 美食 / 运动 / 汽车 / 时尚 / 动物 / 鬼畜 / 纪录片 / 搞笑 / 学习 / 手工 / 摄影 / 历史 / 哲学 / 心理学 / 编程 / 数学 / 物理 / 军事 / 财经 / 职场 / 育儿 |
| 子簇 | 68 个，比如「游戏 → 沙盒游戏 / 游戏推荐 / 独立游戏」 |
| 语气 | 三套：鲸鱼女仆 / 正经简报 / 损友吐槽 |
| 头像 | 五张：睡觉 / 看电视 / 探险 / 哦鲸鲸 / 走路（唯一会动的一张） |
清单在 docs/presets.md。设置页点「＋ 游戏」就把整根轴连子簇加进来。
轴树会长。 如果预设里没有你要的，或者不够细，点「看建议」：
~/.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，再刷新页面。
npm 上的最新版看这里：https://www.npmjs.com/package/dsh-bili-jar
# 走 npm 装的
pnpm up dsh-bili-jar@latest
# 走 GitHub 装的（会重新拉默认分支）
pnpm up dsh-bili-jar
# 桌面版（依赖写死在 profile 里时）
# 把 package.json 里的版本改成 ^0.3.0，或者直接写 @latest，再 pnpm install
装完重启 dsh，然后 Ctrl+Shift+R 硬刷新页面 —— 客户端脚本会被浏览器缓存，光点刷新不够。
怎么确认版本对不对：开一次面板，设置 页底部有版本号；或者直接看接口：
curl -s http://127.0.0.1:你的端口/api/bili-jar/ping | head -c 120
第一批装好之后，以后每次点开罐子都是立刻有东西（上一次那批），后台再慢慢换。
熟人名单是空着起步的：👍 攒到 3 次、或者同一个人的视频点开过 3 次，他就转正了。头几天名单是空的，属于正常。
B 站登录是可选的，只用来取 AI 字幕。二维码是插件自己画的（lib/qr.mjs，零依赖），凭证落在自己的目录里。
不过「关注」页（固定 UP）和熟人投稿都依赖它 —— 没登录时拉不到投稿，登录过期了「关注」页会提示你重新扫码。
~/.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 站登录，只有你自己扫码才有 |
ups.json | 熟人名单（认出来的 UP + 各自攒了几次互动） |
refresh.json | 上次轻量探测 / 上次完整重建的时间 |
STATE.md | 人话摘要：现在什么配置、这一批推了什么、花了多少 |
做过一次检查，结论都写在这：
127.0.0.1（DSH 的 webServer 本来就这么绑），局域网访问不到Sec-Fetch-Site: cross-site，或者 Origin 不是本机的，直接 403。避免你开着插件逛网页时，被某个页面偷偷改配置或触发付费调用config.json，但所有 HTTP 接口只返回 sk-••••后四位，/debug 也一样credential.json，只在你自己扫码后写入；POSIX 下用 0600bilibili.com 和你配的模型 APIplayer.bilibili.com 的 iframe，等于在页面里跑 B 站的播放器docs/tag-tree.md）ups.json 重来tools/ 里那些自检脚本；UI 改动得自己看一遍| 文件 | 干什么 |
|---|---|
index.js | host 半端：配置、HTTP 路由、池子落盘、策展接线 |
client.js | 浏览器半端：罐子 + 面板 |
lib/bili.mjs | B 站客户端：WBI 签名 / 搜索 / 详情 / 粉丝 / 投稿 / 字幕 |
lib/pool.mjs | 候选池：轴匹配、硬过滤、打分、按轴轮转、轻量探测（lightProbe）、防回音室 |
lib/ups.mjs | 熟人名单：从赞/稍后看/点开里认人，纯函数 |
lib/refresh.mjs | 三档刷新：3h / 6h / 24h 该干什么，纯函数 |
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/ups-check.mjs # 熟人名单的单测（去重 / 时间窗 / 三档 / 上限）
node tools/refresh-check.mjs # 三档刷新的单测（3h / 6h / 24h / 边界）
node tools/echo-check.mjs # 防回音室的单测（规则 + 策展两条路径）
node tools/up-probe.mjs # 固定 UP 拉不到投稿时，四种写法逐个对照
node tools/rl-probe.mjs 10 # 连打 space 接口，看多少下会被风控
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.3.0
/space/wbi/arc/search 只做 WBI 签名会被风控挡回（游客态稳定 -352，偶尔直接返回 HTML 拦截页）。补上浏览器指纹参数 + buvid4 + 全局 750ms 节流；拉失败时「关注」页会说人话，不再干瞪眼history.json 补存 mid；feedback.jsonl 同一条视频只记一次（之前一条能记 3 行，把熟人分数算虚了）0.2.8
playGrowth（播放增速），参与补查排序和冷启动微调；stats 新增 detailCold / detailRefresh / coldStart / freshQuota / growthSeen0.2.9
stats.diversity 里，出问题能重放main 里至少担保一条 3 天内、播放达标、贴轴的0.2.7
stats 新增 byOrder（两种排序各搜了几次）和 fresh（池子里 7 天内发布的条数）tools/why.mjs 升级：在不在池里、打分明细、第几名、卡在哪一关，一次看全0.2.6
screenshots.json，市场详情页会自动抓这两张0.2.5
0.2.4
freshness）：按合格条目的年龄中位数判定，超过 90 天就算常青，设置里点一下就能改0.2.x
.md/explain 的 ReferenceError、/debug 泄露 key、explainOn 死开关、换头像不刷新页头、走路帧被裁掉背包、设置页打不开（漏声明）、头像上传被 64KB 限制挡住nosniff、凭证文件 06000.1.0 第一版：按轴搜索、互动率打分、累积池、策展、扫码登录、记账。
代码 MIT。插画（assets/jar-*.png / av-*.png / walk-*.png）由作者用豆包生成，随仓库提供，只用于这个插件的界面。「哦鲸鲸」那档头像取自 dsh-whale-widget（MIT），详见 NOTICE。