yuandian-ailaw/yuandian_dsh_plugin

Plugin插件 Native原生 ⭐ 2 MIT Data & Analysis数据与分析

huayu-yuandian-legal-data 将元典开放平台的聚合 MCP 入口接入 DeepSeek Harness,并随包提供法规、案例、企业和证券合规 4 个官方 Skill。

catalog descriptioncatalog 简介 / catalog description:华语元典法律数据(deepseek harness )官方插件

Project Overview项目介绍

huayu-yuandian-legal-data is a native DeepSeek Harness (DSH) plugin that wires the Yuandian Open Platform aggregated MCP endpoint into DSH; after installation a dedicated "华宇元典法律数据" entry with branded logo is added to the HSK settings page, while the internal bundle id remains huayu-yuandian-legal-data. Installation accepts either a local directory or a tarball through dsh plugin --profile web add /absolute/path/..., the tarball path additionally requires hash verification with shasum -a 256 -c on macOS or sha256sum -c on Linux against the shipped .sha256 file, and removal is performed via dsh plugin --profile web remove huayu-yuandian-legal-data; a typical user first runs the add command, optionally inspects the dumped profile config with dsh --profile web --dump-config, then opens the settings page to pick an authentication method before any MCP traffic is emitted.

By default the plugin targets https://open.chineselaw.com/mcp and registers tools under mcp__yuandian__<original-tool-name>, appending a stable hash when the upstream name is non-conformant or exceeds DSH's length limit, and it ships four official Skills covering PRC law search, case search, company search, and securities-compliance search that are exposed directly inside the Harness chat surface. Authentication offers OAuth Authorization Code with PKCE S256 (supporting dynamic client registration, refresh tokens, RFC 8707 resource indicators, and a strict 127.0.0.1:<port>/oauth/callback loopback) and a plain API Key, while the cordis patch.yml override path lets operators pin auth.mode: api-key for server or CI usage and supply the key via YUANDIAN_API_KEY; tool listing failures retain the previous generation, reconnect uses bounded exponential backoff from 500 ms up to 30 s across at most 10 attempts, and only MCP tools are bridged, not resources or prompts.

The plugin requires Node.js >=22.19.0 and is compatible with DSH >=0.1.2-rc.1 <0.2.0, with CI running quality gates on Linux, macOS, and Windows plus pnpm pack --dry-run artifact validation, while npm publishing is intentionally disabled (private: true) and reserved for the maintainer release flow described in RELEASING.md. Original code is MIT, but because the bundle ships separately licensed Skills and brand logos the package.json declares SEE LICENSE IN LICENSES.md, the four SKILL.md files travel in plaintext because the Harness must read them to dispatch skills, the plugin itself adds no telemetry, account/quota/billing terms remain governed by the upstream Yuandian platform, and on first run the bundle sits unauthenticated until the user explicitly starts OAuth or saves an API Key.

huayu-yuandian-legal-data 是为 DeepSeek Harness(DSH)专门构建的法律数据原生插件,把元典开放平台的聚合 MCP 入口接入 DSH,安装后在 HSK 设置页显示"华宇元典法律数据"入口并附带品牌 Logo,内部包名沿用 huayu-yuandian-legal-data。安装方式支持本地目录与 tarball 两种:通过 dsh plugin --profile web add /absolute/path/... 命令完成,tarball 安装前需用 shasum -a 256 或 sha256sum 校验 .sha256,卸载则使用 dsh plugin --profile web remove。

默认端点为 https://open.chineselaw.com/mcp,一次授权发现全部工具,注册名遵循 mcp__yuandian__<原始工具名>,不合规或超长名称附加稳定哈希;随包提供法规检索、案例检索、企业查询和证券合规 4 个官方 Skill,可在 Harness 中直接调用。认证支持 OAuth 与 API Key 两种,OAuth 采用 Authorization Code + PKCE S256,支持动态客户端注册、refresh token、RFC 8707 resource indicator 和本机 loopback 回调。

运行依赖 Node.js >=22.19.0,兼容 DSH >=0.1.2-rc.1 <0.2.0,CI 在 Linux、macOS 和 Windows 执行质量门禁但不自动发布 npm;原创代码采用 MIT,但 4 份 Skill 和品牌 Logo 单独授权,包使用 SEE LICENSE IN LICENSES.md 标注,首次安装保持未认证待机,用户手动选择认证后才建立 MCP 连接。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:yuandian-ailaw/yuandian_dsh_plugin

把 yuandian-ailaw/yuandian_dsh_plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

华宇元典法律数据

English

源码仓库:yuandian-ailaw/yuandian_dsh_plugin · DeepSeek Harness

huayu-yuandian-legal-data 将元典开放平台的聚合 MCP 入口接入 DeepSeek Harness,并随包提供法规、案例、企业和证券合规 4 个官方 Skill。

当前版本:0.1.5。兼容 DeepSeek Harness >=0.1.2-rc.1 <0.2.0,要求 Node.js >=22.19.0。

项目原创代码采用 MIT License;随包 Skill 和品牌 Logo 使用单独授权,不属于 MIT License。完整边界见 LICENSES.md。

安装后,DeepSeek Harness 的设置页会出现“华宇元典法律数据”入口,并展示随包分发的品牌 Logo;内部包名继续使用 huayu-yuandian-legal-data。

能力与边界

  • 默认连接 https://open.chineselaw.com/mcp,一次授权发现聚合入口的全部工具。
  • 设置页提供 OAuth 与 API Key 两种认证方式;安装和首次加载不要求认证,用户选择后才发起连接。
  • OAuth 采用 Authorization Code + PKCE S256,支持动态客户端注册、refresh token、RFC 8707 resource indicator 和本机 loopback 回调。
  • MCP 工具以 mcp__yuandian__<原始工具名> 注册;不合规或超长名称会附加稳定哈希。
  • 非本机 MCP endpoint 强制使用 HTTPS;HTTP 仅允许 loopback 开发地址。
  • 支持有界工具分页、重复 cursor 检查、notifications/tools/list_changed、整代恢复、有界指数退避重连、调用超时和取消。
  • 当前只桥接 MCP tools,不桥接 resources 和 prompts。
  • 运行中需要重新授权时,已经失败的工具调用不会自动重放,避免重复执行有副作用的操作;连接恢复后由用户重试。

安装

从本地目录安装

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

从 tarball 安装

作者侧生成包:

pnpm install
pnpm pack

用户侧安装:

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

公开仓库 CI 会在 Linux、macOS 和 Windows 上执行质量门禁,并用 pnpm pack --dry-run 校验包内容;CI 不会自动发布 npm 包或创建正式制品。正式制品只由维护者按 RELEASING.md 发布。

获得维护者发布的 .tgz 与 .sha256 后,先在两者所在目录验证摘要:

# macOS
shasum -a 256 -c huayu-yuandian-legal-data-0.1.5.tgz.sha256

# Linux
sha256sum -c huayu-yuandian-legal-data-0.1.5.tgz.sha256

从源码安装时应固定公开仓库的 commit SHA,并只对可信源码授权构建。tarball 已包含构建产物,不需要安装时构建授权。

卸载:

dsh plugin --profile web remove huayu-yuandian-legal-data

认证配置

设置页右上角的“认证配置”入口支持:

  • OAuth 认证:开始授权、从 API Key 切换至 OAuth、清理现有状态后重新授权,或经二次确认取消本机授权。
  • API Key:保存、替换或移除 Key;已保存的明文永不回显,也不会进入插件配置和日志。

默认 bundle 使用自动认证模式:

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-agent-memory 下一个 Next dsh-receipt →