前言¶

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