最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

Hermes Desktop 多模型接入的實(shí)現(xiàn)步驟

  發(fā)布時(shí)間:2026-07-09 09:59:59   作者:佚名   我要評論
本文詳解訊飛星火MaaSCoding API接入過程,包括單模型配置、多模型接入、Desktop 下拉菜單不顯示的排查,以及最終的解決方案,附帶實(shí)用配置模板和避坑指南,感興趣的可以了解一下

摘要:本文記錄了在 Hermes Agent Desktop 中配置訊飛星火 MaaS Coding API 作為自定義 Provider 的完整過程,包括單模型配置、多模型接入、Desktop 下拉菜單不顯示的排查,以及最終的解決方案。附帶實(shí)用配置模板和避坑指南。

背景

Hermes Agent 是 Nous Research 開源的 AI Agent 框架,支持 CLI、Telegram、Discord、Slack 等多平臺。它的 Desktop 桌面版支持自定義 OpenAI 兼容 API,但文檔中對命名自定義 Provider(Named Custom Providers)的配置細(xì)節(jié)不夠清晰,實(shí)際操作中踩了不少坑。

本文以訊飛星火 MaaS Coding API 為例,記錄完整的配置過程和踩坑經(jīng)驗(yàn)。

Desktop 模型下拉菜單:配置過程中

配置 custom_providers 后,XUNFEI 出現(xiàn)在下拉菜單,但只顯示了 model 字段指定的模型(xopglm51),xopkimik26 沒有出現(xiàn):

一、基礎(chǔ)配置:接入單個(gè)自定義模型

1.1 準(zhǔn)備信息

項(xiàng)目
API 地址https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
API Key<your-api-key>
模型 IDxopkimik26
接口協(xié)議OpenAI 兼容

1.2 四條命令搞定

hermes config set model.provider custom
hermes config set model.default xopkimik26
hermes config set model.base_url "https://maas-coding-api.cn-huabei-1.xf-yun.com/v2"
hermes config set model.api_key "<your-api-key>"

寫入 ~/.hermes/config.yaml 的結(jié)果:

model:
  default: xopkimik26
  provider: custom
  base_url: https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
  api_key: <your-api-key>

1.3 驗(yàn)證

curl -s "https://maas-coding-api.cn-huabei-1.xf-yun.com/v2/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -d '{"model":"xopkimik26","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

返回 HTTP 200 即成功。

二、進(jìn)階配置:接入多個(gè)模型(命名 Provider)

2.1 場景

同一個(gè) API 端點(diǎn)下有兩個(gè)模型:

  • xopglm51 — 備選模型
  • xopkimik26 — 原有模型

需要在 Hermes Desktop 下拉菜單中同時(shí)顯示,且能自由切換。

2.2 正確的配置格式

~/.hermes/config.yaml 中添加以下兩個(gè) section:

# 1. custom_providers — 運(yùn)行時(shí)路由(必須有 models 列表)
custom_providers:
  - name: xunfei
    base_url: https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
    api_key: <your-api-key>
    models:
      - xopglm51
      - xopkimik26
# 2. providers — 供 /model 命令使用(可選,但建議清空避免沖突)
providers: {}

2.3 Desktop 下拉菜單效果

配置完成后,重啟 Desktop 應(yīng)用,下拉菜單應(yīng)顯示:

DEEPSEEK
  Deepseek V4 Pro 中
  Deepseek V4 Flash 中
XIAOMI
  Mimo V2.5 Pro 中
  Mimo V2.5 中
XUNFEI                    ← 新增
  Xopglm51 中
  Xopkimik26 中

三、踩坑記錄

坑 1:providers:和custom_providers:缺一不可(但格式有講究)

Hermes 內(nèi)部有兩個(gè) config section 都會(huì)影響模型顯示:

Section作用格式
providers:/model 命令的模型列表來源dict,key 為 provider 名
custom_providers:運(yùn)行時(shí) API 路由 + Desktop 下拉菜單list,每個(gè) entry 有 name/base_url/api_key/model(s)

關(guān)鍵發(fā)現(xiàn):如果 providers:custom_providers: 同時(shí)存在同名條目,Desktop 下拉菜單會(huì)優(yōu)先使用 providers: 的內(nèi)容,導(dǎo)致 custom_providers:models 列表被跳過。

解決方案:只保留 custom_providers:,將 providers: 清空為 {}

# ? 正確:providers 清空,custom_providers 包含所有模型
providers: {}
custom_providers:
  - name: xunfei
    base_url: https://...
    api_key: ...
    models: [xopglm51, xopkimik26]

坑 2:providers:里的default字段不被識別

# ? 錯(cuò)誤 — "default" 是未知字段,被靜默丟棄
providers:
  xunfei:
    default: xopglm51
# ? 正確 — 必須用 "model" 字段
providers:
  xunfei:
    model: xopglm51

Hermes 的 _normalize_custom_provider_entry() 函數(shù)只識別 _KNOWN_KEYS 中的字段,default 不在其中。

坑 3:custom_providers里用model(單數(shù))只顯示一個(gè)模型

# ? 只能顯示一個(gè)模型
custom_providers:
  - name: xunfei
    model: xopglm51
# ? 用 models 列表顯示多個(gè)模型
custom_providers:
  - name: xunfei
    models:
      - xopglm51
      - xopkimik26

坑 4:Desktop GUI 的自定義 API 表單有 bug

根據(jù) 4SAPI 博客 的分析:

桌面版 GUI 的自定義 API 表單當(dāng)前有 bug,光在界面里填不生效,必須中斷當(dāng)前運(yùn)行的模型、用 hermes model 手動(dòng)重選一次才能生效。

規(guī)避方法:用命令行配置(hermes config set),不要依賴 GUI 表單。

坑 5:/model命令不支持自定義 Provider

/model <model-name> 的解析依賴 _PROVIDER_MODELS 靜態(tài)目錄(hermes_cli/models.py)。自定義 Provider 不在其中,需要手動(dòng)添加:

# ~/.hermes/hermes-agent/hermes_cli/models.py
_PROVIDER_MODELS = {
    ...
    "xunfei": [
        "xopkimik26",
        "xopglm51",
    ],
}

修改后需要 /quit + 重啟 Hermes 生效。

四、完整配置模板

# ── 默認(rèn)模型 ──
model:
  default: mimo-v2.5          # 或你的默認(rèn)模型
  provider: xiaomi             # 內(nèi)置 provider
# ── 命名自定義 Provider(多個(gè)模型) ──
custom_providers:
  - name: xunfei
    base_url: https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
    api_key: <your-api-key>
    models:
      - xopglm51
      - xopkimik26
# ── providers 清空(避免與 custom_providers 沖突) ──
providers: {}

五、命令速查

場景命令
配置默認(rèn)模型hermes config set model.default <model-id>
配置 Providerhermes config set model.provider <provider>
會(huì)話中切換模型/model <model-id> 或 /model custom:<name>:<model-id>
驗(yàn)證 YAML 格式python -c "import yaml; yaml.safe_load(open('config.yaml')); print('OK')"
查看當(dāng)前配置hermes config
重啟生效退出會(huì)話 (/quit) 后重新運(yùn)行 hermes

六、總結(jié)

問題原因解決方案
Desktop 下拉菜單不顯示自定義模型providers: 和 custom_providers: 同名沖突只用 custom_providers:,清空 providers:
providers: 里的模型不顯示default 是未知字段改用 model 字段
只顯示一個(gè)模型用了 model(單數(shù))而非 models(列表)改用 models: [model1, model2]
GUI 填的 API 不生效Desktop GUI 表單 bug用 hermes config set 命令行配置
/model 命令找不到自定義模型_PROVIDER_MODELS 靜態(tài)目錄缺少條目在 models.py 中添加模型列表

參考資料

本文檔由 Hermes Agent 自動(dòng)生成,基于 2026 年 6 月的實(shí)測經(jīng)驗(yàn)。如有更新請參考官方文檔。

七、讓 AI 幫你自動(dòng)配置(直接復(fù)制使用)

如果你想讓 AI Agent(如 Hermes、Claude Code、Cursor 等)幫你完成上述所有配置,直接把下面的 prompt 復(fù)制粘貼發(fā)給 AI 即可。把 <占位符> 替換成你自己的值。

Prompt 模板

請幫我配置 Hermes Agent 的自定義 API 模型,要求如下:

API 地址:<https://your-api.com/v2>
API Key:<your-api-key>
模型列表:<model-id-1, model-id-2, ...>
Provider 名稱:<自定義名稱,如 xunfei>

具體操作:

1. 用 hermes config set 命令配置默認(rèn)模型:
   - model.provider 設(shè)為 custom
   - model.default 設(shè)為 <model-id-1>
   - model.base_url 設(shè)為 <API地址>
   - model.api_key 設(shè)為 <API Key>

2. 編輯 ~/.hermes/config.yaml(或 Windows 上的 C:\Users\<用戶名>\AppData\Local\hermes\config.yaml),添加 custom_providers section:
   custom_providers:
     - name: <自定義名稱>
       base_url: <API地址>
       api_key: <API Key>
       models:
         - <model-id-1>
         - <model-id-2>

3. 將 providers section 清空為 providers: {},避免與 custom_providers 沖突。

4. 編輯 hermes_cli/models.py,在 _PROVIDER_MODELS 字典中添加:
   "<自定義名稱>": ["<model-id-1>", "<model-id-2>"]
   這樣 /model 命令才能自動(dòng)識別這些模型。

5. 用 curl 測試每個(gè)模型的連通性,確認(rèn)返回 HTTP 200。

6. 用 python yaml.safe_load 驗(yàn)證 config.yaml 格式正確。

7. 提示我重啟 Hermes Desktop 以生效。

更簡短的版本(適合只有一兩個(gè)模型)

幫我配置 Hermes Agent 接入一個(gè)第三方 API:

API: <https://your-api.com/v2>
Key: <your-api-key>
模型: <model-id>

用 hermes config set 設(shè)好默認(rèn)模型,然后在 config.yaml 里加 custom_providers,記得把 providers 清空避免沖突。

如果你已經(jīng)有一個(gè)模型,想追加第二個(gè)

我現(xiàn)在 Hermes 已經(jīng)配了一個(gè)自定義模型 <model-id-1>(provider 名叫 <provider-name>)。
請幫我追加同一個(gè) API 下的另一個(gè)模型 <model-id-2>,要求:
1. 在 config.yaml 的 custom_providers 里把 models 改成列表,包含兩個(gè)模型
2. 在 hermes_cli/models.py 的 _PROVIDER_MODELS 里也加上第二個(gè)模型
3. 不要?jiǎng)?model.default,保留原來的默認(rèn)模型

到此這篇關(guān)于Hermes Desktop 多模型接入的實(shí)現(xiàn)步驟的文章就介紹到這了,更多相關(guān)Hermes Desktop 多模型接入內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!

相關(guān)文章

  • Hermes Desktop極簡安裝教程

    Hermes Desktop 是 Hermes Agent 的桌面客戶端——和終端里用的 hermes 是同一個(gè) agent術(shù)語解釋Agent具備自主性、能調(diào)用工具以完成目標(biāo)的 AI 程序,本文介紹Hermes Desktop
    2026-07-02

最新評論

沙雅县| 东明县| 肇源县| 铜山县| 乌鲁木齐县| 扶绥县| 孟村| 邵东县| 吕梁市| 敦化市| 台东市| 明光市| 南宁市| 遂宁市| 阿鲁科尔沁旗| 长治县| 嘉兴市| 区。| 武安市| 天祝| 社旗县| 鹤峰县| 沐川县| 巫山县| 平果县| 米易县| 古田县| 海城市| 石泉县| 乡城县| 封丘县| 辽源市| 青海省| 咸宁市| 大冶市| 桦川县| 林西县| 保山市| 翁源县| 乳源| 大渡口区|