个性化推荐抽屉 whiteguo233/dsh-openbiliclaw

🦀 OpenBiliClaw · DSH 客户端插件

OpenBiliClaw 是本地运行、跨平台、可调教的个性化内容推荐智能体；本仓库是它的 DeepSeek Harness 客户端插件——DSH 左侧栏一个 OpenBiliClaw 按钮，点开右侧滑出抽屉（推荐/内容库/对话/画像/设置），并注册 22 个 Agent Bridge 工具，让智能体读推荐、答探测、闭环学习。

这是什么

OpenBiliClaw 是本地运行、跨平台、可调教的个性化内容推荐智能体：从你在 B 站 / 小红书 / 抖音 / YouTube / X / 知乎 / Reddit / Linux.do / Bangumi / V2EX / 微博的使用、反馈与对话里持续深化你的心理画像，再主动去这些平台为你找内容。

本仓库是它的 DeepSeek Harness（DSH）客户端插件，把「消费侧」搬进 DSH 的 Web GUI：

- 人用侧：在 DSH 左侧栏底部加一个 OpenBiliClaw 按钮，点开从右侧滑出一个抽屉面板，视觉与浏览器插件 / 手机版一致——推荐流、惊喜推荐、内容库、苏格拉底式对话、用户画像、后端设置，全部在 DSH 里点开即用；
- 智能体用侧：注册 22 个 openbiliclaw_ 工具（Agent Bridge v2 CLI）和 openbiliclaw-adapter 技能，让 DSH 里的智能体读取推荐、回答探测、保存内容、和用户对话，形成「推荐 → 反馈 → 画像 → 更准的推荐」的闭环。

典型场景：左边和智能体聊需求，点左下角的 OpenBiliClaw 按钮，右侧抽屉滑出来顺手刷两条推荐，点个「收藏」，过一会儿弹出兴趣探测，和它聊两句，画像就更懂你了——全程不离开 DSH。

边界说明：本插件只做消费侧。爬取 / 平台源管理 / 账号同步等能力仍属于主项目（后端 + 浏览器插件 / 手机版），有意不带入 DSH。

截图（真实使用场景）

| 推荐 · 亮色 | 推荐 · 深色（跟随 DSH 主题） |
| 推荐 · 亮色 | 推荐 · 深色 |

| 内容库 | 对话 | 画像 |
| 内容库 | 对话 | 画像 |

| 设置 · 模型 | 设置 · 调度 | 设置 · 通用 |
| 设置 · 模型 | 设置 · 调度 | 设置 · 通用 |

功能

推荐（For You）

- 惊喜推荐 hero 大图：整卡宽的 16:9 封面 + ✨ 角标 + 「💗 91% 匹配」分数胶囊，展开可见推荐理由、看看/喜欢/稍后看/收藏/少来点/聊一聊
- 跨平台封面兼容：与浏览器插件 / PC Web 统一经后端 /api/image-proxy 加载，归一化小红书、YouTube 等 CDN URL；代理失败时自动回退为文本或媒体占位，不留空白卡片
- 无限滚动：滚到底自动加载下一页；距离底部约 800px 时提前预加载；加载中显示底部转圈指示
- 换一批 / 追加一批 / 刷新；卡片内嵌喜欢/不感兴趣/评论反馈；底部动态流（探测、惊喜、保存事件）
- 未初始化时提供「开始初始化」入口，自动轮询初始化状态

内容库

- 稍后再看 / 收藏：打开、移除，与主项目共享同一份本地列表
- 顶部「同步到平台」：全量同步到 B 站收藏夹 / 稍后再看，轮询展示逐条结果（成功 / 失败 / 需登录）
- 每条可单独「同步 / 重试同步」；卡片内嵌 喜欢 / 不感兴趣 / 聊一聊，以及与另一列表的互切（收藏 ⇄ 稍后再看）
- 已同步（synced / already_synced）的条目自动从侧栏隐藏（数据保留）；空态区分「已全部同步」与「还没有收藏」
- 非 B 站平台条目标注同步状态（如「仅本地保存」），不误报为已同步
- 历史记录：近 30 天「点开过 / 看过 / 移除的」，光标分页 + 触底自动加载，带收藏/稍后/不再推荐等上下文徽章；「移除的」分类可一键恢复收藏 / 稍后再看

对话

- 苏格拉底式对话引擎：一问一答之间持续深化画像
- 兴趣 / 回避探测卡片：确认、拒绝、聊聊、稍后，乐观状态机即时反馈
- 待聊确认卡片：准 / 不准 / 聊聊，回复会带回被确认的原话上下文

画像

- 与 popup 同构的画像卡：MBTI、核心特质、深层需求、兴趣树、风格、洞察与觉察
- 新增「阿B 最近新记住了什么」认知卡，可展开影响/推理/依据，并支持加载更早的认知更新

设置（与浏览器插件后端设置页对齐）

- 模型：v2 实例模型（新建/编辑/删除实例、provider 条件字段、获取模型）、默认调用链（排序 + 测试整链）、模块路由（画像理解/内容发现/推荐表达/内容评估）、Embedding（含备选 provider + 测试）、LLM 并发/超时
- 调度：版本与更新（检查/应用）、全部调度参数、猜测兴趣参数
- 高级功能：P1 视觉画像 / P2 弹幕 / P3 关键帧、多模态处理、搜索词生成模式、认知循环预算（觉察/洞察批量与 token 上限）
- 通用：连接地址、语言、保存同步、数据目录、海外网络代理（带测试）、局域网访问密码、开机自启动、重新初始化（含初始化 LLM 并发）
- 日志 + 异常报警（LLM / Embedding 失败记录）；全局「保存配置」栏 + 脏状态提示（未保存修改提醒）

面板体验

- 深色模式跟随 DSH 主题实时切换（保留 OpenBiliClaw 自己的粉/蓝配色体系）
- 后端在线状态点带迟滞：连续两次探测失败才置离线，单次抖动不再闪
- 图标使用插件（浏览器扩展）原版图标：品牌 logo + 四个 tab 图标逐字节对齐

与主项目的关系

┌───────────────────────────── DSH Web GUI ─────────────────────────────┐
│ 左边栏 │ 会话区 │ 详情栏 │ │
│ (DSH 自带， │ (DSH 自带) │ (DSH 自带) │ ← 右侧滑出 OpenBiliClaw │
│ 底部含 │ │ │ 抽屉（推荐/内容库/ │ │ OpenBiliClaw │ │ │ 对话/画像/设置） │ │ 按钮) │ │ │ │ └─────────────────────────────┬─────────────────────────────────────────┘ │ HTTP + WebSocket (默认 http://127.0.0.1:8420) ┌─────────────────────────────▼─────────────────────────────────────────┐ │ OpenBiliClaw 后端（主项目，同一份 config.toml / SQLite / 画像）│ └────────────────────────────────────────────────────────────────────────┘ ▲ DSH Agent（本插件注册的工具 + skill）── /api/agent-bridge（HTTP）──┘

- 面板与 Agent 工具走同一套后端状态：面板里收藏的，Agent 工具立刻看得到；Agent 代答的探测，面板同步生效
- Agent Bridge 要求后端开启 Agent Bridge v2（serve-api 暴露 POST /api/agent-bridge）；插件直接 HTTP 调用该端点，不再 shell 出 Python CLI
- 插件注册的 skill 读取 <workdir>/skills/openbiliclaw-adapter/SKILL.md（本仓库 skills/openbiliclaw-adapter/SKILL.md 附了同一份副本，方便对照）

插件组成

| 部分 | 说明 |
| src/index.ts + src/tools.ts | node 半：22 个 openbiliclaw_ 工具（经 serve-api 的 /api/agent-bridge HTTP 调用后端，无需 shell 执行器）+ 注册 adapter skill |
| src/skill.ts | 解析 SKILL.md frontmatter 并注册为 DSH skill |
| src/bridge.ts | Agent Bridge v2 HTTP 调用封装（超时 / 错误归一化） |
| src/client/ | browser 半：左侧栏按钮（sidebar.footer.action）+ 右侧面板列（DOM 挂载进帧网格，React），含推荐/内容库/对话/画像/设置/消息抽屉、WebSocket 实时流、深色模式 |
| lib/ | 构建产物（lib/index.js node 半 + lib/client.js 浏览器半），可直接安装 |

运行时验证

dsh-plugin-verify（Verified DSH Plugins 判定站）用 mock-llm 跑完整 agent 循环，在 DSH 0.2.1-rc.3（deepseek-harness master 22ddee37）上验证：

✅ 通过 ｜ waterfall 7/7 ｜ tools/result 是 ｜ 捕获事件 13

- 报告与收录 PR：qing3a/dsh-plugin-verify#9（含 verify-report.json；收录待维护者复核）
- 自助复现：npx dsh-plugin-verify <本仓库> --repo <DSH checkout>
- 注意：checkout 需要先跑 pnpm build:lib:host && pnpm build:lib:client && pnpm build:native-system，缺原生 system.node 时 headless 会在 2/7 卡住——那不是插件问题。

安装

前置

1. 一个可用的 DeepSeek Harness 部署（含 Web GUI）
2. 一个运行中的 OpenBiliClaw 后端（主项目，开启 Agent Bridge v2，默认监听 127.0.0.1:8420）

插件要求 DSH 0.2.1-rc.2 或更高的 0.2.x（package.json 的 engines.dsh 是唯一兼容声明）；peer ABI 与 0.2.1 的 dsh- 包及 @deepseek-ai/cordis ~4.0.5 对齐。DSH 0.2 会在装载时校验插件的 dsh 版本要求，不匹配的插件会被整包跳过并在启动日志打印 dsh: skipping profile bundle ...。

通过 DSH 插件 bundle 安装

本仓库声明了 dsh.bundle，因此可以作为完整插件包交给 dsh plugin add 或插件市场安装。bundle 会自动提供 openbiliclaw 配置行；安装后仍需按下面的配置说明，把 workdir 指向本地 OpenBiliClaw 主项目目录。

通过 GitHub 标签安装

dsh plugin --profile web add 'github:whiteguo233/dsh-openbiliclaw#v0.6.0'
之后把 @openbiliclaw/dsh-plugin 加进该 profile package.json 的 dsh.profile.bundles

dsh plugin 只是 pnpm 的转发器：装完包还要在 <profile>/package.json 的 dsh.profile.bundles 里登记包名，bundle 的 cordis.patch.yml 才会被应用。

1. 界面挂载（免配置）

无需改 DSH 源码，插件自己完成两处挂载：

- 左侧按钮：注册到官方 sidebar.footer.action 加法槽（侧边栏底部、设置旁的附加动作）
- 右侧面板：DSH 0.2 的帧网格没有 aside 列，插件在帧上追加一条显式 grid-row: 1 / grid-column: 4 的列，并把 grid-template-columns 重写成「壳层轨道 + 面板宽度」，所以打开面板是挤开中间内容而不是浮层覆盖；面板收起时该轨道宽度为 0。

2. 安装插件包

把本仓库放进 web profile 的依赖目录并声明插件行：

dsh plugin --profile <profile> add 'github:whiteguo233/dsh-openbiliclaw#v0.6.0'

在 ~/.dsh/profiles/<profile>/cordis.patch.yml 增加：

DSH 0.2+: 新增配置行必须放在 insert 下
- insert:
- id: openbiliclaw
name: '@openbiliclaw/dsh-plugin'
config:
workdir: '/你的/OpenBiliClaw/项目目录' # 后端项目根目录（含 .venv 与 skills/）

cordis.patch.yml 的顶层是 patch 列表；不带 insert 的 id 条目会被当作已有配置行覆盖，找不到 openbiliclaw 时会被跳过。

3. 重启

dsh web # 重启 DSH Web 进程，刷新页面

面板内的「设置 → 通用 → 连接」可改后端地址（默认 http://127.0.0.1:8420，面板本地保存、立即生效；地址本身不要再附加 /api）。

配置项（cordis 行 config）

| 键 | 默认 | 说明 |
| apiUrl | http://127.0.0.1:8420 | 运行中的 OpenBiliClaw serve-api（Agent Bridge v2 端点）。同时通过 host 路由 /openbiliclaw/connection 提供给面板，作为浏览器半的初始后端地址 |
| workdir | 插件作者的本地 checkout | OpenBiliClaw 后端项目根目录；skillPath 未配时由它推导，建议显式配置 |
| skillPath | <workdir>/skills/openbiliclaw-adapter/SKILL.md | adapter skill 文件；读不到时只告警，不阻断激活 |
| timeoutMs | 300000 | 单次 bridge 调用超时 |

后端地址的解析顺序（面板与 Agent 工具共用同一个 apiUrl 来源）：

1. 面板「设置 → 通用 → 连接」里保存的地址（localStorage，用户显式改过就归它管）；
2. cordis 行的 apiUrl —— 面板启动时读取同源路由 /openbiliclaw/connection，所以配置一次两半都生效；
3. 内置默认 http://127.0.0.1:8420。

headless 等没有 web 服务的场景下该路由不会注册，工具仍照常可用。

构建

插件自带完整的独立构建链，不再依赖 DSH 源码 checkout：@deepseek-ai/dsh- 的类型从 npm 安装在 devDependencies 里，浏览器半由本仓库的 tsdown.config.ts 直接产出 DSH 的闭包模块格式。

npm install # devDependencies（0.2.1-rc.2 类型包 + tsdown + lightningcss）
npm run build # tsc -> lib/types，tsdown -> lib/index.js + lib/client.js
npm test # 构建后跑 ABI 冒烟测试（22 个工具 + adapter skill）

lib/client.js 的输出契约：window.__ModuleLoader__.load({ id, factory: (require) => ... })，只把 React 平台模块留在 require 里，其余全部内联；CSS Modules 经 lightningcss 编译并注入 标签。

Agent 侧工具一览

openbiliclaw_recommend / openbiliclaw_append_recommendations / openbiliclaw_reshuffle / openbiliclaw_get_delight / openbiliclaw_respond_delight / openbiliclaw_submit_feedback / openbiliclaw_get_activity_feed / openbiliclaw_chat / openbiliclaw_get_chat_history / openbiliclaw_next_probe / openbiliclaw_respond_interest_probe / openbiliclaw_next_avoidance_probe / openbiliclaw_respond_avoidance_probe / openbiliclaw_get_profile / openbiliclaw_get_profile_edit_state / openbiliclaw_edit_profile / openbiliclaw_list_saved / openbiliclaw_save_local / openbiliclaw_remove_saved / openbiliclaw_get_runtime_status / openbiliclaw_get_platform_availability / openbiliclaw_get_capabilities

边界（有意不做）

- 平台源 / 爬取配置、源状态、池配比（这些属于主项目的「平台源」设置页）
- 同步到外部平台账号（本地收藏/稍后看始终本地优先，手动同步在主项目）
- 浏览器插件专属的设备配对、断开暂停等

相关链接

- 主项目：OpenBiliClaw · 项目主页
- DSH：DeepSeek Harness

变更记录

按版本记录见 CHANGELOG.md。

License

BSD-3-Clause

友情链接

友情链接

OpenBiliClaw 是本地优先的跨平台内容发现智能体，这个插件是它的 DeepSeek Harness（DSH）客户端。插件在左侧边栏加一个 OpenBiliClaw 按钮，点击后在 DSH Web GUI 右侧打开面板（占用 sidebar.footer.action 位置，并挂载一列 DOM 框架），呈现 OpenBiliClaw 的消费端功能：推荐流带主推惊喜横幅、无限滚动加预取、收藏/历史库、带兴趣/回避探针的苏格拉底式对话、用户画像卡片，以及与浏览器扩展对齐的设置界面。插件还注册 22 个 openbiliclaw_ 工具和 openbiliclaw-adapter 技能，让 DSH 智能体可以闭环驱动同一套后端。封面图走与浏览器端、PC Web 端相同的后端图片代理，带 CDN URL 归一化，加载失败时回退到本地。爬取与源管理有意留在主项目。要求 DSH 0.2 系列 0.2.1-rc.2 或更新版本（在 engines.dsh 中声明一次；peer 对齐 @deepseek-ai/cordis ~4.0.5），并需要 OpenBiliClaw 后端处于运行状态（Agent Bridge v2，默认 http://127.0.0.1:8420）。往 cordis.patch.yml 添加插件时，要把这一行包在顶层 insert 条目里；裸 id 行会被当成覆盖项，条目不存在时直接跳过。安装、构建与配置细节见上方中文部分。