中文译本仅供参考,以俄文原文为准。
CasusLegal CasusLegal 最高法院司法实践语料库 ← 返回首页

连接到 DeepSeek Harness

适用于在终端中工作的用户的四个步骤。 DeepSeek Harness (命令 dsh)是 DeepSeek 的开放式 代理环境,其中一切都通过插件实现。它将 MCP 服务器作为 客户端,通过写入配置文件进行记录。 此处没有登录窗口,访问权限通过个人令牌传递。

本指南已在以下版本上验证 dsh 0.1.0-rc.7,截图 取自其网页界面。

应连接哪个地址。 所有数据库均通过一个地址开放:最高法院、知识产权法院、KAS、KUD 以及十个上诉审辖区。系统只会开放已付费的数据库,并根据问题主题自行选择所需的神经网络。
所需内容地址(URL)
所有已付费数据库,包括各辖区https://mcp.casus.legal/one/mcp
原辖区地址 /okrug/mcp 仍然 有效,无需重新连接。如果两个地址均已连接,请停用 /okrug/mcp:否则神经网络会看到两套 辖区工具。
⚠️ 非保证环境。 已确认支持 Claude, ChatGPT, Grok 和 Hermes — 连接器已在这些环境中 经过测试。 DeepSeek Harness 于 2026 年 8 月开放,并且变化很快。 新版本中的字段名称可能与本指南不一致, 此时请参阅插件文档 @deepseek-ai/dsh-mcp-client.
数据库访问权限。 网页聊天和 Telegram 机器人中的欢迎免费请求不适用于连接器。连接前,请在 个人账户 中启用为期三天的免费试用期,或订阅所需数据库。

所需准备

CasusLegal 方面
有效访问权限和令牌

所需数据库的订阅或试用期,以及格式为以下形式的个人令牌 vasrf_conn_… 从账户中获取。

DeepSeek 方面
已安装的 dsh 和配置文件

一条命令完成安装: npm i -g @deepseek-ai/dsh。 配置文件 web 会在首次启动时自动创建 dsh web.

DeepSeek 模型密钥仅用于代理生成回答,连接器本身 独立连接。

1
生成令牌并将其放入环境变量

打开 个人账户, 进入 “连接器”部分 “其他环境” 并点击 “生成令牌”。令牌会显示 一次.

请将其保存在环境变量中,而不要写入配置文本,因为配置文件很容易进入备份文件和代码仓库。

export CASUSLEGAL_TOKEN=vasrf_conn_ваш_токен

令牌在订阅有效期间持续有效,并开放所有已付费数据库。 已配置的 Claude 和 ChatGPT 它不会破坏。

2
将服务器添加到配置文件的补丁层

配置文件的用户修改存放在文件中 cordis.patch.yml 位于配置文件目录中。对于 Web 配置文件 则是 ~/.dsh/profiles/web/cordis.patch.yml。旁边的 cordis.yml — 是配置文件的根文件,它不能编辑, 文件本身也对此作有说明。

通过以下方式添加新条目 insert. 这 是最关键的细节。没有 insert 的补丁会被视为 修改现有条目,而 dsh 会静默跳过,并显示 警告 patch: entry … not found.

~/.dsh/profiles/web/cordis.patch.yml

- insert: - id: mcp-casuslegal name: '@deepseek-ai/dsh-mcp-client' config: serverName: casuslegal transport: streamable-http url: https://mcp.casus.legal/one/mcp headers: Authorization: !!js '`Bearer ${process.env.CASUSLEGAL_TOKEN}`' # 一次搜索约需 30 秒:默认值(60 000 毫秒)不够 toolCallTimeoutMs: 180000

连接地址为— https://mcp.casus.legal/one/mcp。这是 统一地址:通过该地址可以访问您已付费的所有数据库,系统会根据问题主题自动选择所需的神经网络。如果需要连接到 一个 数据库,也有单独的地址(IP Court— https://sip.casus.legal/mcp,KAS— https://kas.casus.legal/mcp,KUD— https://kud.casus.legal/mcp),但此时地址必须与已付费的数据库一致,否则服务器会回复“订阅未激活或已过期”。无需同时保留统一地址和单独地址:神经网络会看到两套相同的工具,并进行两次搜索。完整地址表位于下方各步骤之后。

在 serverName 允许使用拉丁字母、数字、连字符和 下划线,最多 32 个字符,并且该值必须在已连接的服务器中唯一。工具名称 将由此生成 mcp__casuslegal__….

如果需要多个数据库,请在同一列表中为每个数据库添加一个区块, 更改 id, serverName 以及下表中的 地址。所有区块使用同一个令牌。

3
检查条目是否已进入配置文件树

由单独的命令打印生成的配置文件配置。该命令不会同时启动 环境:

dsh --profile web --dump-config | tail -20

输出末尾应出现带有来源标记的条目 # == ~/.dsh/profiles/web/cordis.patch.yml。如果打印的不是该条目, 而是警告 patch: entry … not found,则表示第 2 步中的 insert 已丢失。

4
启动 dsh 并确认插件已启动

启动环境: dsh web — 它会启动本地 Web 界面并打印其地址。

DeepSeek Harness Web 界面的主屏幕:左侧为会话列表和 Settings 按钮,中间为输入框。
主屏幕 DeepSeek Harness。按钮 Settings — 位于左下方。

打开 Settings → Plugins:此页面列出了已安装构建中的插件 。

DeepSeek Harness 设置中的 Plugins 部分,包含 Plugin configuration 和 Plugin list 选项卡。
部分 Plugins:选项卡 Plugin configuration — 设置, Plugin list — 完整列表。

切换到选项卡 Plugin list 并在搜索框中输入 mcp。条目 mcp-client 处于状态 Enabled 表示客户端已挂载并正在连接到我们的 服务器。

带有 mcp 筛选器的 Plugin list 选项卡:找到一条状态为 Enabled 的 mcp-client 条目。
按词筛选 mcp: mcp-client — Enabled。挂载后的连接器如图所示。

接下来向代理提出一个有实质内容的问题,例如:“查找 俄罗斯联邦最高法院关于依据《俄罗斯联邦民法典》第 333 条减少违约金的司法实践。”连接器的工具 将以以下名称提供给模型 mcp__casuslegal__….

地址:统一地址和按数据库划分的地址

数据库serverName地址(url)
所有已付费数据库casuslegalhttps://mcp.casus.legal/one/mcp
所有上诉审辖区casuslegal_okrugahttps://mcp.casus.legal/okrug/mcp
最高法院:俄罗斯联邦宪法法院 · 俄罗斯联邦最高法院 · 俄罗斯联邦最高仲裁法院casuslegalhttps://mcp.casus.legal/mcp
知识产权法院(IP Court)casuslegal_siphttps://sip.casus.legal/mcp
行政案件(KAS · 俄罗斯联邦最高法院行政案件审判庭)casuslegal_kashttps://kas.casus.legal/mcp
刑事案件(KUD · 俄罗斯联邦最高法院刑事案件审判庭)casuslegal_kudhttps://kud.casus.legal/mcp

插件的有用字段

字段用途
toolCallTimeoutMs单次工具调用的超时时间。默认值为 60 000 毫秒;对于语料库搜索,请设置为 180 000。
failOnStartupError当值为 true 时,如果连接器不可用,构建将不会启动。这样可以避免在自己未察觉的情况下“脱离司法实践”工作。
reconnect.enabled连接中断后的自动重新连接。默认启用。

常见错误

启动时出现警告“patch: entry … not found”

补丁中缺少 insert。没有它,该条目会被视为对已有插件的修改,且该插件具有相同的 id,并且 dsh 会跳过该条目。连接器不会出现,且不会显示明确错误。

对照第 2 步中的区块并重新执行 dsh --profile web --dump-config.

插件为 Enabled,但模型没有工具

即使连接失败,客户端也会激活,这是设计如此:构建不应因服务器不可用而崩溃。请检查变量 CASUSLEGAL_TOKEN 对进程可见,也就是说,已在启动 所使用的同一 shell 中导出 dsh.

若要立即发现此类情况,请在配置中设置 failOnStartupError: true.

传输方式:streamable-http 还是 sse?

仅 streamable-http。我们的地址使用 Streamable HTTP;设置为该值时 sse 或 stdio 无法建立连接。

工具调用因超时中断

一次语料库搜索约需 30 秒,而复杂问题会连续触发多次搜索。标准的 60 000 毫秒不够,请设置为 toolCallTimeoutMs: 180000.

连接器因订阅问题拒绝响应

打开中的“连接器”选项卡 个人账户 并检查所需数据库的订阅期限。每个语料库单独收费;“最高法院”包含在任何套餐中。

令牌丢失

该提示不会再次显示。请在账户中生成新的令牌,并替换环境变量的值;现有连接不会因此中断。

中文