前言¶

DeepSeek Harness（DSH）支持通過插件擴展能力。如果你需要在本地構建或運行智能體時接入華語法律數據，huayu-yuandian-legal-data 插件提供了官方的連接方案。它將元典開放平臺的聚合 MCP 入口引入 DSH，並隨包提供了法規、案例、企業和證券合規四類官方 Skill。

插件簡介¶

• 插件名：huayu-yuandian-legal-data
• 維護者：yuandian-ailaw
• 版本：0.1.5
• 兼容性：DeepSeek Harness >=0.1.2-rc.1 <0.2.0，Node.js >=22.19.0

核心能力¶

該插件主要解決 DSH 環境下無法直接調用元典開放平臺接口的問題。

1. MCP 入口接入
   默認連接元典開放平臺的聚合 MCP 入口（https://open.chineselaw.com/mcp）。安裝後，插件會嘗試發現並註冊該入口下的全部工具。

2. 官方 Skill 集成
   隨包提供 4 個官方 Skill，覆蓋主要法律檢索場景：

   • prc-legal-research-law-search：法規、法條與效力狀態檢索。
   • prc-legal-research-case-search：裁判文書、權威案例與相似案例檢索。
   • prc-legal-research-company-search：企業工商、風險、涉訴、股權與知識產權查詢。
   • prc-legal-research-securities-compliance：證券法規、監管案例與上市公司公告檢索。

3. 工具註冊與認證

   • 命名：MCP 工具註冊名稱爲 mcp__yuandian__<原始工具名>。
   • 認證方式：支持 OAuth（Authorization Code + PKCE S256）與 API Key 兩種認證方式。
   • 連接機制：支持有界工具分頁、重複 cursor 檢查、notifications/tools/list_changed、整代恢復、有界指數退避重連、調用超時和取消。

安裝與配置¶

從本地目錄安裝¶

在終端執行以下命令，將本地目錄作爲插件源：

dsh plugin --profile web add /absolute/path/to/huayu-yuandian-legal-data

從 tarball 安裝¶

若已獲取官方發佈的壓縮包，使用以下命令安裝：

dsh plugin --profile web add /absolute/path/to/huandu-yuandian-legal-data-0.1.5.tgz

配置認證¶

安裝後，DSH 設置頁會出現“華宇元典法律數據”入口。默認配置採用自動認證模式，安裝和首次加載時若未配置憑證，插件保持待機狀態，不發起 MCP 連接。用戶在設置頁點擊“開始 OAuth 授權”或保存 API Key 後，插件纔會建立連接。

以下爲常見的配置示例（YAML 格式），需根據實際需求修改：

- id: huayu-yuandian-legal-data
  config:
    endpoint: https://open.chineselaw.com/mcp
    serverName: yuandian
    auth:
      mode: auto
      callbackPort: 1455
      openBrowser: true
      timeoutMs: 300000
    httpTimeoutMs: 60000
    toolCallTimeoutMs: 60000
    failOnStartupError: true
    reconnect:
      enabled: true
      initialDelayMs: 500
      maxDelayMs: 30000
      maxAttempts: 10

若需在服務器或 CI 中強制使用 API Key，可覆蓋 auth.mode 爲 api-key，並在啓動環境變量中提供對應憑證。

使用示例¶

1. 首次授權：在 DSH 設置頁點擊“開始 OAuth 授權”。瀏覽器會打開，授權完成後插件自動建立連接。
2. API Key 模式：在設置頁保存 API Key，插件將直接使用該 Key 進行 MCP 調用。
3. 調用工具：在 DSH 交互中，你可以直接調用註冊後的工具（例如 mcp__yuandian__law_search）。

注意事項¶

1. 功能邊界：當前插件僅橋接 MCP 的 tools，暫不橋接 resources 和 prompts。
2. 副作用保護：運行中如需重新授權，已失敗的工具調用不會自動重放，以避免重複執行有副感的操作。
3. 數據免責：工具返回的法律數據應結合來源、時效和適用範圍複覈，不構成未經專業人員複覈的法律意見。
4. 許可證：項目原創代碼採用 MIT License；隨包分發的 Skill 和品牌 Logo 使用單獨授權，不屬於 MIT License。

結尾¶

該插件爲 DSH 用戶提供了接入華語元典法律數據的標準入口，適合需要在本地環境中處理中國法律檢索、合規查詢等任務的開發者。完整的目錄信息與源碼倉庫位於下方。

• 目錄頁：https://www.skillhub.cn/plugins/yuandian-ailaw/yuandian_dsh_plugin
• GitHub 倉庫：https://github.com/yuandian-ailaw/yuandian_dsh_plugin