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

连接到 Hermes

这是第四个官方支持的环境。它与其他三个环境的不同之处在于,程序本身免费,而连接到它的模型可以由您任选。

Hermes 是研究实验室 Nous Research 开发的代理。它提供适用于 Windows、macOS 和 Linux 的桌面应用,也提供终端版本;两者使用相同的设置。CasusLegal 连接器作为 MCP 服务器添加:填写两个字段,并通过 Telegram 或密码登录。下文介绍这两种方式:使用应用和不使用应用。

Hermes 与 Claude、ChatGPT 和 Grok 有何不同

优势 1
程序本身免费

Hermes 及其桌面应用免费提供,并采用开放源代码(MIT 许可证)。代理本身不收取订阅费:您只需为所连接模型使用的 token 付费。如果模型在本地运行,这部分费用也无需支付。

作为比较:自定义连接器在 Claude 和 ChatGPT 中仅可在助手本身的付费套餐中使用。例外是 Grok:xAI 宣布所有用户均可使用连接器,包括免费套餐用户;该套餐使用 Fast 系列的快速模型进行回答,且请求数量有限。

优势 2
可使用任意模型,而非只能使用一个模型

在 Claude 运行 Claude,在 ChatGPT — GPT,在 Grok — Grok。Hermes 不绑定特定模型。一个密钥 OpenRouter 可立即开启数百个不同开发者提供的模型。也可以改为连接 提供商的直接密钥:Anthropic、OpenAI、Google、xAI、DeepSeek、Qwen、Kimi、GLM、MiniMax 等(Hermes 文档中列出的提供商超过三十个)。还可以运行模型 本地 (Ollama、LM Studio、llama.cpp),或指定 任意自有地址,只要与 OpenAI 格式兼容即可。

可通过命令直接在对话中切换模型 /model;连接器则仍保持连接状态。

优势 3
可针对同一问题比较不同模型

同一个请求、同一个 CasusLegal 数据库、不同的模型,可以立即看出哪一个处理裁判实践更准确,哪一个引用更严谨,以及哪一个在相同用量下更便宜。

其他三个环境无法进行这种比较:它们只能选择助手开发者自有的模型。

优势 4
根据任务选择价格

初步搜索可以使用廉价或免费的模型,而对筛选出的裁判文书进行分析则可以使用昂贵的模型。Hermes 会在状态栏中显示当前会话的用量和上下文占用情况,详细信息则通过命令显示 /usage.

CasusLegal 只有一个订阅,且不影响模型费用:连接器向任何模型提供相同的裁判文书。具体如何支付 token 费用,见下文“如何支付模型费用”部分。

优势 5
材料保留在您的计算机上

Hermes 在本地运行:对话记录、记忆、密钥和设置保存在您计算机上的配置文件夹中,而不是开发者的云端。请求内容只会发送到您主动发送的地方:所选模型提供商和 CasusLegal 连接器。

对于处理委托人的材料而言,这与云端聊天是明显不同的模式。

优势 6
应用和终端是同一个程序

配置、密钥和对话历史记录是共享的:在应用中连接的连接器,在终端中也可以使用,反之亦然。可以自由切换。

其中还提供定时任务、子代理和技能,包括 CasusLegal 技能.

环境模型环境本身的费用
Claude仅有 Claude助手付费套餐
ChatGPT仅 GPT付费套餐 + 开发者模式
Grok仅有 Grok没有:连接器在免费套餐中也可使用,订阅可解除限制
Hermes任意:OpenRouter、提供商的直接密钥、本地模型没有,程序免费

套餐条件 Claude, ChatGPT 和 Grok 由其开发者设定,并在不经我们参与的情况下变更;购买前请以其网站信息为准。

数据库访问权限。 网页聊天和 Telegram 机器人提供的欢迎免费请求不适用于连接器。在首次连接前,请在 个人账户 中启用为期三天的免费试用期,或订阅所需数据库。
应连接哪个地址。 所有数据库均通过一个地址开放:最高法院、知识产权法院、KAS、KUD 以及十个上诉审辖区。系统只会开放已付费的数据库,并根据问题主题自行选择所需的神经网络。
所需内容地址(URL)
所有已付费数据库,包括各辖区https://mcp.casus.legal/one/mcp
原辖区地址 /okrug/mcp 仍然 有效,无需重新连接。如果两个地址均已连接,请停用 /okrug/mcp:否则神经网络会看到两套 辖区工具。
⚠️ 服务器名称只能使用拉丁字母。 连接器在 Hermes 中注册时所用的名称(casuslegal, sip, kas, kud),会参与工具的内部标识符生成。使用西里尔字母的名称会导致其生成失败:服务器能够连接并显示在设置中,但在对话中模型会回答说看不到工具。如果已经使用俄文命名,请删除服务器,然后使用拉丁字母重新创建。

安装 Hermes

如果已经安装 Hermes,可直接进入连接连接器的步骤。 有两种安装方式;结果相同,区别仅在于操作路径。

方式 A——桌面应用程序(适合大多数用户)

打开 Hermes 官方网站,下载适用于您系统的安装程序并运行。 首次启动时,程序会询问要使用哪个提供商和哪一模型;此选择可随时更改。

在 Windows 上,安装程序无需管理员权限,并会自行获取所需组件。

方式 B——终端

Windows, PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

macOS、Linux 或 WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后,关闭并重新打开终端,然后检查 hermes --version 并完成初始 设置 hermes setup。已安装的终端版本应用程序可通过命令 打开 hermes desktop.

在应用程序中连接连接器

无需使用终端。

1
打开 MCP 部分

在 Hermes 左侧菜单中选择 Skills,进入 MCP 并点击 New Server选项卡。右侧将打开文件编辑器 mcp.json.

该应用程序发展迅速,各版本之间的菜单项名称会发生变化。如果没有此部分,请在设置中查找 MCP servers ,或者从终端连接连接器:下方的路径不同,但结果相同。

2
添加 CasusLegal 服务器

如果还没有其他服务器,请将编辑器内容替换为以下文本:

{ "mcpServers": { "casuslegal": { "url": "https://mcp.casus.legal/one/mcp", "auth": "oauth" } } }

连接地址为— 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),但此时地址必须与已付费的数据库相匹配,否则服务器会返回“订阅未激活或已过期”。无需同时保留统一地址和独立地址:神经网络会看到两组相同的工具,并进行两次查找。 服务器名称必须使用拉丁字母。完整地址表如下。

如果 mcp.json 中已经有其他服务器,请不要删除它们:在其中添加区块 casuslegal 到 现有对象 mcpServers中,并用逗号分隔相邻区块。

3
保存并启用服务器

点击 Save ,并确认服务器旁边的开关 已开启:Hermes 会立即检查连接。如果出现 Needs authentication状态,请选择服务器并点击 Authenticate.

4
完成授权

浏览器中将打开 CasusLegal 登录页面。最简单的方式是点击 “通过 Telegram 登录”:如果尚未拥有账户,系统会自动创建。第二种方式是使用 中的连接器访问密码 个人账户。 确认访问权限,然后返回 Hermes。

成功登录后,服务器旁边会亮起绿色指示灯,其卡片中还会显示可用工具列表。

5
开始新对话

打开新聊天并提出一个实质性问题,例如: “通过 CasusLegal 查找俄罗斯联邦最高法院关于依据《俄罗斯联邦民法典》第 333 条降低违约金的司法实践。”回复中应显示裁判文书的详细信息及指向 完整文本的链接。

如果工具未被加载,请在聊天中执行 /reload-mcp ,然后重新创建对话。

通过终端连接连接器

1
添加 MCP 服务器
hermes mcp add casuslegal --url "https://mcp.casus.legal/one/mcp" --auth oauth

名称 casuslegal 仅在 您的 Hermes 中使用;可以将其替换为任意简短名称 拉丁字母.

2
完成授权

Hermes 将在浏览器中打开 CasusLegal 登录页面:通过 Telegram 或密码登录并确认访问权限。如果浏览器未自动打开,请复制终端中显示的链接并手动打开。

3
启用工具

Hermes 将连接服务器,显示找到的工具,并提供一次性全部启用或选择性启用的选项。请全部启用:数据库工具仅支持读取。之后可通过命令更改工具集 hermes mcp configure casuslegal.

4
重启 Hermes 并检查连接

最简单的方法是关闭并重新打开 Hermes。如果它已经在运行,请在聊天中执行 /reload-mcp,然后 /new.

检查
hermes mcp list # 在 casuslegal 旁边显示 ✓ enabled hermes mcp test casuslegal # Connected 以及工具数量

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

使用统一地址的一个连接器就足够了:通过它可以访问您已付费的所有数据库。只有在您有意希望为单个数据库使用独立连接器时,才需要单独地址;此时每个连接器都需单独连接并进行授权。订阅只有一个,并立即在所有环境中生效。

数据库服务器名称地址(URL)
所有已付费数据库casuslegalhttps://mcp.casus.legal/one/mcp
所有上诉审辖区okrugahttps://mcp.casus.legal/okrug/mcp
最高法院:俄罗斯联邦宪法法院 · 俄罗斯联邦最高法院 · 俄罗斯联邦最高仲裁法院casuslegalhttps://mcp.casus.legal/mcp
知识产权法院(IP Court)siphttps://sip.casus.legal/mcp
行政案件(KAS · 俄罗斯联邦最高法院行政案件审判庭)kashttps://kas.casus.legal/mcp
刑事案件(KUD · 俄罗斯联邦最高法院刑事案件审判庭)kudhttps://kud.casus.legal/mcp
应用程序中的独立数据库:mcp.json(不需要统一地址时)
{ "mcpServers": { "casuslegal": { "url": "https://mcp.casus.legal/mcp", "auth": "oauth" }, "sip": { "url": "https://sip.casus.legal/mcp", "auth": "oauth" }, "kas": { "url": "https://kas.casus.legal/mcp", "auth": "oauth" }, "kud": { "url": "https://kud.casus.legal/mcp", "auth": "oauth" } } }
终端中的独立数据库(不需要统一地址时)
hermes mcp add casuslegal --url "https://mcp.casus.legal/mcp" --auth oauth hermes mcp add sip --url "https://sip.casus.legal/mcp" --auth oauth hermes mcp add kas --url "https://kas.casus.legal/mcp" --auth oauth hermes mcp add kud --url "https://kud.casus.legal/mcp" --auth oauth

适用的模型

模型要求

连接器是一组由模型自行调用的工具,因此并非所有模型都适用。需要具备两个特性: 能够可靠地 调用工具 和 上下文窗口不小于 64,000 个令牌:这是 Hermes 文档的要求。司法实践以内容丰富的卡片形式提供,窗口越大,单次对话能够完成的研究就越长。

实用的选择是 Anthropic、OpenAI 和 Google 的强大模型;最方便的方式是使用一个 OpenRouter 密钥连接它们,而不必分别在每个开发者处开设账户。规模较小的本地模型适合尝试和了解,但在较长的工具调用链中更容易中断。

模型可通过命令更换 /model ,直接在 对话中完成,无需重新连接连接器。

如何支付模型费用

Hermes 本身免费,因此唯一的问题是:您使用谁提供的令牌。共有三种方式,而且可以组合使用:您可以设置多个提供商,并在使用过程中切换。

路径 1——Hermes 开发者订阅(Nous Portal)

Nous Research 提供自己的订阅服务 Nous Portal。 通过一次 OAuth 登录即可立即使用三百多个模型(Claude、GPT、 Gemini、DeepSeek、Qwen、Kimi、GLM、MiniMax、Grok),此外还有“Tool Gateway”:无需为每项服务分别获取密钥,即可使用网页搜索、图像生成、语音合成和云浏览器。Hermes 文档将此路径列为推荐方式。

hermes setup --portal # 全新安装:同时完成登录、提供商和工具设置 hermes model # 已安装:从列表中选择 Nous Portal hermes portal info # 已连接的内容以及请求发送至何处

共有四种方案,其中一种免费。已支付的金额将以增加 10% 的额度记入账户,未使用的余额可部分结转至下个月:

方案月费额度可用内容
Free0无仅限门户中的免费模型(列表如下)
Plus20 美元22 美元,最多结转 10完整目录和内置工具
Super100 美元110 美元,最多结转 50同上,限额更高
Ultra200 美元220 美元,最多结转 100同上,限额更高

门户订阅者还可获得文档所称的由按令牌收费的提供商提供的 10% 折扣。价格已与门户截至 2026 年 8 月 1 日的信息核对,并会在不经我们参与的情况下变更;付款前请在门户本身查看价格。

路径 2——您的 ChatGPT 订阅及其他已付费订阅

无需单独购买令牌:Hermes 可以使用 您当前有效的订阅 ChatGPT。在提供商列表中,它是 OpenAI Codex。登录通过设备代码完成:Hermes 会显示地址和 代码,您在浏览器中使用自己的 OpenAI 账户确认。无需 API 密钥,也无需安装 Codex CLI(如果已经安装, Hermes 会自动使用其凭据)。可使用 Codex 系列模型,消耗量从您的订阅额度中扣除,而命令 /usage 会显示剩余额度和已累计的额度重置次数。

其他订阅如果您已经付费,也可以通过同样的方式连接:

订阅连接方式须知事项
ChatGPThermes model → OpenAI Codex,通过设备代码登录Codex 系列模型,消耗订阅额度
Claudehermes model → Anthropic,通过 OAuth 登录仅限 Max 套餐 和 另购的“extra usage”额度:不会消耗 Max 的基础额度,而 Pro 订阅不足以支持此路径。否则,请使用 Anthropic API 密钥并按令牌计费
Grokhermes model → xAI Grok OAuth需要 SuperGrok 或 Premium+ 订阅,无需 API 密钥
GitHub Copilothermes model → GitHub Copilot通过 Copilot 订阅可使用 GPT-5.x、Claude、Gemini;传统令牌 ghp_ 不适用
MiniMax, Qwenhermes model → MiniMax(OAuth)或 Qwen OAuth通过浏览器登录,无需 API 密钥

这些订阅的条款由其所有者制定,并可在不经我们参与的情况下变更。已根据 Hermes 文档核对,日期为 2026 年 8 月 1 日。

路径 3——免费模型

您可以在无需支付令牌费用的情况下尝试“Hermes + 连接器”组合。开发者自己的门户和 OpenRouter 都提供免费模型;两者的标识符均以 :free.

在 Nous Portal 的免费套餐中 (2026 年 8 月 1 日)可使用五个模型:

  • poolside/laguna-s-2.1:free —上下文窗口约为一百万个令牌;
  • poolside/laguna-xs-2.1:free, stepfun/step-3.7-flash:free;
  • tencent/hy3:free, inclusionai/ling-3.0-flash:free.

免费套餐不提供货币额度:目录中的付费模型在该套餐中不可用,仅可使用这五个模型。

在 OpenRouter, 截至同一日期,以下模型尤其可免费使用:

  • nvidia/nemotron-3-ultra-550b-a55b:free —窗口约为一百万个令牌;
  • nvidia/nemotron-3-super-120b-a12b:free 以及系列 nemotron-3-nano;
  • google/gemma-4-31b-it:free, google/gemma-4-26b-a4b-it:free;
  • openai/gpt-oss-20b:free, inclusionai/ling-3.0-flash:free.

所列模型的上下文窗口均达到 64 千个令牌这一 Hermes 对模型的要求。后缀 :free 是必需的: 没有该后缀,同一标识符表示同一模型的付费版本。 在对话中,切换方式如下:

/model nvidia/nemotron-3-ultra-550b-a55b:free

另外还有两种免费路径:使用以下服务的密钥 build.nvidia.com (在提供商列表中称为 NVIDIA NIM),以及通过 Ollama 或 LM Studio 在您自己的计算机上运行本地模型,后者完全不收取令牌费用。

免费模型组合会发生变化:模型会加入或退出,临时促销也会结束。Nous Portal 对 Nemotron 3 Ultra 的免费访问曾于 2026 年 6 月 4 日至 18 日有效,现已结束。开始使用前,请以提供商的列表为准。

使用免费模型时,较长的工具调用链更容易失败。它们足以用于初步检索判例;但若要分析筛选出的裁判文书,最好切换到能力更强的付费模型。

中间方案是使用价格极低的模型。例如, deepseek/deepseek-v4-flash 在 Nous Portal 的目录中,有一个模型的上下文窗口约为一百万个令牌,输入价格约为每百万个令牌 11 美分,输出价格约为每百万个令牌 22 美分。它并非免费,但对于法律检索的使用量而言,每月成本低于一杯咖啡。

另请注意:新的 Kimi K3

Kimi K3 于 2026 年 7 月 16 日发布,成为 Moonshot AI 当前的旗舰模型,取代 K2.5 和 K2.6。其上下文窗口约为一百万个令牌,也就是说,一次对话可容纳的判例卡片明显多于大多数模型。

在 Hermes 中有两种启用方式:

  • 通过 OpenRouter 或 Nous Portal——标识符 moonshotai/kimi-k3。截至 2026 年 8 月 1 日,OpenRouter 的价格为每百万个输入令牌 3 美元、每百万个输出令牌 15 美元;
  • 直接从 Moonshot 获取——密钥 KIMI_API_KEY 在 文件 ~/.hermes/.env,提供商 kimi-coding,模型 kimi-k3.
/model moonshotai/kimi-k3 # 直接在对话中切换

同一个问题可以分别在 K3 和您熟悉的模型上运行,然后比较每个模型如何处理检索到的判例:裁判文书的筛选、引文的准确性以及回答的价格。

连接后如何使用

无需记忆工具的技术名称:用普通语言描述需求,Hermes 会自行选择合适的工具:

访问范围取决于您登录时使用的 CasusLegal 账户。更多技巧汇总于 “场景” 和 “建议”.

常见错误

服务器已连接,但对话中没有工具

先采用标准方法:执行 /reload-mcp 并新建一个对话:Hermes 不会立即读取配置变更。如果仍未解决,请关闭并重新启动程序。

使用以下命令检查连接 hermes mcp test casuslegal: 它应当返回 Connected 并显示 工具数量。综合诊断命令为 hermes doctor.

第二个常见原因是服务器名称包含西里尔字母。请删除该服务器 (hermes mcp remove casuslegal),然后使用拉丁字母重新创建。

浏览器未打开或授权未完成

复制终端中显示的授权链接,并手动打开 该链接。您可以随时重新登录: hermes mcp login casuslegal,而在应用中则是 Skills → MCP,选择服务器并点击 Authenticate.

最好从单独的终端窗口启动登录,而不是在已经运行的对话中启动:在单独窗口中,授权可用时间更长。

连接器访问密码在 个人账户 ,并且 不同于通过 Telegram 登录。

登录成功,但连接器拒绝请求

打开中的“连接器”选项卡 个人账户 并确认订阅状态对应于您实际访问的数据库:各数据库的地址不同,订阅“最高法院”不会开放知识产权法院、KAS 或 KUD。

网页聊天和 Telegram 机器人提供的欢迎免费请求不适用于连接器。

模型仅根据自身知识作答,未访问数据库

请明确说:“使用 CasusLegal 并查找……”。如果这样仍未调用工具,通常是模型的问题,参见“哪种模型合适”一节:上下文窗口过小或对工具调用的支持不足。

验证这一猜测很简单:使用以下命令切换 /model 到另一模型,然后重复提出同一 问题。

应用中没有 MCP 选项卡,或终端中没有 hermes mcp 命令

版本已过时。请执行 hermes update 并重新启动程序。

需要同时使用多个数据库

在以下位置列出它们 mcp.json ,或通过命令添加:上方“4 个数据库的地址”一节中提供了现成的代码块。每个数据库都需要单独完成授权。

所有环境共用同一个订阅:从 Hermes 切换到 Claude 或 ChatGPT 时无需重新连接 连接器。

Hermes 官方链接

中文