dsh-openbiliclaw 使用指南

把 OpenBiliClaw 本地推荐 Agent 的消费侧搬进 DSH Web 界面，左栏按钮呼出抽屉面板，并向 Agent 注册 22 个 openbiliclaw_* 工具让推荐/反馈/画像闭环。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add github:whiteguo233/dsh-openbiliclaw

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

人用侧：在 DSH 左侧栏底部加一个 OpenBiliClaw 按钮，点开从右侧滑出一个与浏览器插件 / 手机版视觉一致的抽屉面板——推荐流、惊喜推荐、内容库、苏格拉底式对话、用户画像、后端设置，全部在 DSH 里点开即用；
Agent 用侧：注册 22 个 openbiliclaw_* 工具（Agent Bridge v2 CLI）和 openbiliclaw-adapter skill，让 DSH 里的 Agent 能读取推荐、回答探测、保存内容、和用户对话，形成「推荐 → 反馈 → 画像 → 更准的推荐」的闭环。
惊喜推荐 hero 大图：整卡宽的 16:9 封面 + ✨ 角标 + 「💗 91% 匹配」分数胶囊，展开可见推荐理由、看看/喜欢/稍后看/收藏/少来点/聊一聊
跨平台封面兼容：与浏览器插件 / PC Web 统一经后端 /api/image-proxy 加载，归一化小红书、YouTube 等 CDN URL；代理失败时自动回退为文本或媒体占位，不留空白卡片
无限滚动：滚到底自动加载下一页；距离底部约 800px 时提前预加载；加载中显示底部转圈指示

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个插件需要单独安装什么后端服务吗？

需要一个运行中的 OpenBiliClaw 后端（默认监听 127.0.0.1:8420，且需开启 Agent Bridge v2）。插件本身不包含爬取/源管理能力，这些仍由主项目（后端 + 浏览器扩展/手机版）承担。

插件和 OpenBiliClaw 浏览器扩展、手机版是什么关系？

面板和 Agent 工具共用同一份后端状态（同一份 config.toml / SQLite / 画像）：面板里收藏的，Agent 工具立刻看得到；Agent 代答的探测，面板同步生效。三种客户端可以同时使用同一份数据。

DSH 左侧栏点哪里打开这个面板？

在 DSH 左侧栏底部「设置」按钮旁边新增了一个 OpenBiliClaw 按钮，点击后从右侧滑出抽屉面板（推荐/内容库/对话/画像/设置），再次点击或点收起按钮可关闭。

不改任何配置能直接用吗？

首次安装需要把 workdir 指向本地 OpenBiliClaw 主项目根目录（含 .venv 与 skills/），否则 Agent 工具读不到 SKILL.md。其余 apiUrl、skillPath、timeoutMs 都有默认值。

卸载这个插件会影响我 OpenBiliClaw 的收藏和画像吗？

不会。面板和 Agent 工具只读写主项目的本地数据库（SQLite 与 config.toml）。卸载插件相当于摘掉 DSH 里这个面板入口，不会触碰主项目的数据。

Agent 调用工具需要网络访问 OpenBiliClaw 吗？

是的。Node 侧的 bridge 工具全部走 HTTP，访问 <apiUrl>/api/agent-bridge，默认 127.0.0.1:8420。如果后端跑在远端或别的端口，要把 apiUrl 改成可达地址。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则