前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在構建智能體或擴展 DSH 能力時，經常需要與外部服務進行 JSON-RPC 交互。直接在代碼中硬編碼調用不僅維護成本高，而且難以在對話流中動態調整。爲了解決這一問題，社區提供了基於 Model Context Protocol (MCP) 的解決方案。xby-skill/xby--rpc 插件旨在讓大模型能夠直接調用遠程 JSON-RPC 服務的方法，並支持自動發現服務能力。
插件介紹¶
xby-skill/xby--rpc 是一個基於 OpenRPC 規範的 MCP 服務器。它提供了一套工具，允許用戶在 DSH 的聊天上下文中設置 API 密鑰，並執行任意 JSON-RPC 方法調用或服務發現。該插件由 xby-skill 維護，採用 MIT 許可證。
核心功能¶
該插件主要提供以下三個功能點：
- set_xby_apikey：在聊天會話中設置 API 密鑰。該密鑰會被自動持久化保存，在插件重啓或 DSH 進程重啓後依然有效。
- rpc_call：調用任意 JSON-RPC 服務器上的指定方法。用戶只需在提示詞中指定方法名、服務器地址和參數即可執行。
- rpc_discover：利用 OpenRPC 規範調用
rpc.discover接口，用於發現目標服務器支持的方法列表。
安裝與啓用¶
插件支持三種安裝方式，推薦直接從 GitHub 安裝。
方式一：從 GitHub 直接安裝（推薦）
此方式無需本地構建，直接拉取倉庫安裝。
dsh plugin --profile web add github:xby_skill/xby--rpc
方式二：從本地目錄安裝
適用於本地開發調試場景。
dsh plugin --profile web add /absolute/path/to/xby-json-rpc
方式三：通過 cordis.patch.yml 開發調試
適合需要頻繁修改代碼進行調試的開發者。
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
在使用插件功能前，需要先在官網獲取 API 密鑰。
典型用法¶
安裝完成後，可以通過對話提示來調用插件功能。
調用遠程方法：
在對話中輸入：
Call method <method> on <server url> with params <params>
例如：
Call method getStatus on https://example.com/rpc with params {"id": 1}
發現服務器方法：
在對話中輸入：
What JSON-RPC methods does this server have? <server url>
注意事項¶
- API 密鑰獲取：插件需要前往 https://xiaobenyang.com 註冊並獲取 API 密鑰。
- 權限與安全：插件以當前 DSH 進程的權限運行，請確保安裝的源碼來源可信，並閱讀 MIT 許可證。
- 三種安裝方式：插件支持從 GitHub、本地目錄和 cordis.patch.yml 三種方式安裝，具體選擇取決於使用場景。
結語¶
xby-skill/xby--rpc 插件爲 DSH 用戶提供了與 JSON-RPC 服務交互的標準接口。通過封裝 OpenRPC 規範，它簡化了方法發現和調用的流程。更多詳情與源碼，請訪問 插件目錄 或 GitHub 倉庫。
