Skip to main content

dsh-openbiliclaw

48Stars4Forks1Issues0Watchers

Move the consumer side of the OpenBiliClaw local recommendation Agent into the DSH Web interface. Left sidebar buttons trigger drawer panels, and register 22 openbiliclaw_* tools with the Agent to complete the recommendation, feedback, and portrait loop.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
License
BSD-3-Clause
Branch
main
agent-bridgedeepseek-harnessdshdsh-pluginopenbiliclaw

Install

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

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin whiteguo233/dsh-openbiliclaw for me: review the repository at https://github.com/whiteguo233/dsh-openbiliclaw first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Positioning

Integrate the locally running OpenBiliClaw personalized recommendation Agent into DSH's Web GUI—click the left sidebar to open a right drawer showing recommendations/favorites/dialogue/profile/settings, while registering 22 tools with the DSH Agent, enabling the Agent to read recommendations, respond to probes, save content, forming a closed loop of "recommendation → feedback → profile → more accurate recommendations".

Core Capabilities

  • Append OpenBiliClaw button at the bottom of DSH's left sidebar; clicking slides out a drawer panel from the right (recommendations/content library/dialogue/profile/settings/notifications)
  • Register 22 openbiliclaw_* tools with the DSH Agent, covering recommendation fetching, appending, refresh, feedback submission, delight cards, dialogue, profile, save/remove/list, runtime status, etc.
  • Auto-load openbiliclaw-adapter skill (parses SKILL.md frontmatter in the repository), enabling the Agent to invoke the bridge as a long-term instruction when needed
  • Communicate with running OpenBiliClaw backend serve-api via HTTP calls to /api/agent-bridge endpoint (based on agent-bridge/v2 JSON protocol), avoiding forking Python processes each time
  • Panel experience covers dark mode following, cross-platform cover image proxy (with fallback to text/media placeholder on failure), WebSocket real-time push, message drawer and "sync to platform" progress

Technical Implementation

  • Language: TypeScript (Node side ESM) + React 18 (browser side panel)
  • Key Dependencies: @deepseek-ai/cordis ^4.0.1 (plugin mounting), @deepseek-ai/dsh-tools ^0.1.0-rc.6 (tool registration), @deepseek-ai/dsh-client-runtime / dsh-client-ui-slots ^0.1.0-rc.6 (slot/theme injection), native fetch (HTTP communication with backend)
  • Architecture Pattern: Simultaneously declare dsh.bundle.patch (cordis insert Node half) and dsh.client.inject (browser half inject runtime + ui-slots); Node half registers 22 tools and 1 skill via ctx.tools.register / ctx.skills.register; Browser half uses PanelLayoutController to append a column in the frame grid and rewrite grid-template-columns (push center column rather than overlay), only sidebar button uses sidebar.footer.action slot
  • Entry Files: src/index.ts (node half) / src/client/index.ts (browser half) / cordis.patch.yml (cordis injection declaration)

Use Cases

Users who have locally deployed OpenBiliClaw and want to complete consumer-side operations "without leaving DSH": while chatting about requirements in a DSH session, view cross-platform recommendations via the right drawer (Xiaohongshu/Bilibili/Douyin/YouTube/X/Zhihu/Reddit/Linux.do/V2EX/Weibo), handle favorites/watch later, respond to interest/avoidance probes, view profile. The Agent can also use the 22 registered tools to incorporate recommendation context into responses, making "what I watch → what you think → what I recommend next" a complete closed loop within DSH.

Prerequisites & Compatibility

DependencyMin VersionDescription
DeepSeek Harness (DSH)0.1.0-rc.6+Plugin peer ABI aligned with dsh-* packages @deepseek-ai/cordis ^4.0.1; README warns not to mix tool packages from 0.0.1 era in same profile
OpenBiliClaw BackendEnable Agent Bridge v2Default listening 127.0.0.1:8420; this plugin is consumer-side only, crawling/source management still handled by main project
NodeNot declaredpackage.json doesn't declare engines field
PlatformCross-platformOnly declares dsh.client.platform: "web", no os/cpu restrictions
Native ModulesNoneAll dependencies are JS/TS packages, no native deps like node-pty / node:sqlite

Installation

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

Configuration Options

ConfigTypeDescriptionDefault
apiUrlstringRoot address of OpenBiliClaw backend serve-api; all bridge tools on Node side go to <apiUrl>/api/agent-bridge. Don't append /api at the end of address.http://127.0.0.1:8420
workdirstring (required)OpenBiliClaw main project root directory; used to parse config.toml / data/ and read SKILL.md./Users/white/workspace/OpenBiliClaw
skillPathstringAbsolute path to adapter skill file; when not found only logs warn without error, tools still work but skill metadata absent in DSH.<workdir>/skills/openbiliclaw-adapter/SKILL.md
timeoutMsnumberTimeout for single bridge HTTP call (ms), applied to all 22 tools.300000 (5 minutes)

"Settings → General → Connection" in the panel can change backend address (saved to localStorage, takes effect immediately); that address is used for browser-side direct /api/* calls, separate from apiUrl (Node side) in the table above.

FAQ

Q: Does this plugin conflict with DSH's official settings panel?

A: No conflict. The plugin only adds content: a button at bottom of sidebar, appends the rightmost column in the frame grid (pushing center column, not covering), doesn't modify DSH's native column layout. Panel mount failure only console.error, doesn't affect DSH main flow.

Q: Will the 22 tools be used automatically by Agent, or do I need to mention them in conversation?

A: DSH Agent calls them as needed. openbiliclaw_recommend / openbiliclaw_chat / openbiliclaw_get_profile etc. can be selected as tool calls by LLM when needed; to strictly control scope can also explicitly mention them in conversation.

Q: Is requestId required?

A: Mandatory only for write operation tools (openbiliclaw_submit_feedback / openbiliclaw_respond_delight). Retry of the same action must reuse the same requestId (max 400 characters), don't reuse across different actions—this is the backend's idempotency key, wrong reuse will lose feedback or write wrong entries.

Q: How to see "delight recommendations" (proactive delight)?

A: Two ways: panel receives delight.candidate event via WebSocket push and renders directly at top of drawer; Agent side can call openbiliclaw_get_delight to fetch current pending cards, or call openbiliclaw_respond_delight to respond with view/like/dislike/dismiss/chat (dismiss permanently removes that item from recommendations).

Q: Will interest/avoidance probes pop up proactively for me?

A: Backend pushes interest.probe / avoidance.probe events via WebSocket, panel uses optimistic state machine for immediate feedback; Agent side can also call openbiliclaw_next_probe / openbiliclaw_next_avoidance_probe to fetch next pending question, and respond with openbiliclaw_respond_interest_probe / openbiliclaw_respond_avoidance_probe (confirm/reject/defer/chat, rejecting interest has 30-day cooldown).

Q: Will saved content sync to Bilibili account?

A: openbiliclaw_save_local / openbiliclaw_remove_saved / openbiliclaw_list_saved all write to local SQLite only, won't sync to external accounts. "Sync to platform" button in panel calls main project's sync interface, requires Bilibili account login to succeed; non-Bilibili platform items marked as "local save only".

Getting Started Difficulty

Beginner — fill in workdir correctly, ensure OpenBiliClaw backend has Agent Bridge v2 enabled, other configs have reasonable defaults, out-of-the-box usable with panel and Agent tools.

Known Issues & Limitations

  • Configuration items pythonBin / stdoutMaxBytes listed in README do not exist in source code: current implementation uses HTTP (src/bridge.ts:74-99), doesn't invoke Python subprocess, no output byte limit; writing these configs per README won't take effect nor error.
  • Plugin consumer-side intentionally excludes crawling, platform source management, account sync, sync-saved and other write side-effect capabilities (explicitly noted in src/index.ts:7-10 comments), these still need to be operated in main project / browser extension / mobile app.
  • When file pointed by skillPath can't be read, DSH skill registration silently skips (only logs warn), tools work but LLM can't see skill metadata; wrong workdir triggers this branch.
  • Neither README nor package.json declare Node version requirements; if DSH host Node version is too low, may affect other dsh-* peer dependencies; recommended to follow DSH docs for Node version.
  • Browser panel uses DOM layer extension of frame grid (PanelLayoutController rewrites grid-template-columns), doesn't depend on official aside slot; if DSH frame structure changes in future, may need to adjust panel.module.css / layout.ts (source code comment src/client/index.ts:4-7 already notes this risk).

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/whiteguo233/dsh-openbiliclaw)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory