Chuyển tới nội dung chính

Danh mục mẫu

#Danh mục mẫu mã

Hermes tìm nạp danh sách mô hình được tuyển chọn cho OpenRouter và Nous Portal từ một tệp kê khai JSON được lưu trữ cùng với trang tài liệu. Điều này cho phép người bảo trì cập nhật danh sách bộ chọn mà không cần gửi bản phát hành hermes-agent mới.

Khi không thể truy cập vào tệp kê khai (ngoại tuyến, mạng bị chặn, lỗi lưu trữ), Hermes âm thầm quay lại ảnh chụp nhanh trong kho đi kèm CLI. Tệp kê khai không bao giờ làm hỏng bộ chọn - trường hợp xấu nhất là bạn thấy bất kỳ danh sách nào được gói cùng với phiên bản đã cài đặt của bạn.

URL tệp kê khai trực tiếp​

https://hermes-agent.nousresearch.com/docs/api/model-catalog.json

Được xuất bản sau mỗi lần hợp nhất với main thông qua quy trình Trang GitHub deploy-site.yml hiện có. Nguồn gốc của sự thật tồn tại trong kho lưu trữ tại website/static/api/model-catalog.json.

Lược đồ​

{
  "version": 1,
  "updated_at": "2026-04-25T22:00:00Z",
  "metadata": {},
  "providers": {
    "openrouter": {
      "metadata": {},
      "models": [
        {"id": "moonshotai/kimi-k2.6", "description": "recommended", "metadata": {}},
        {"id": "openai/gpt-5.4",       "description": ""}
      ]
    },
    "nous": {
      "metadata": {},
      "models": [
        {"id": "anthropic/claude-opus-4.7"},
        {"id": "moonshotai/kimi-k2.6"}
      ]
    }
  }
}

Ghi chú hiện trường:

  • version — phiên bản lược đồ số nguyên. Các lược đồ trong tương lai sẽ khắc phục điều này; Hermes từ chối các bản kê khai có phiên bản mà nó không hiểu và quay lại ảnh chụp nhanh được mã hóa cứng.
  • siêu dữ liệu — lệnh dạng tự do ở cấp độ bảng kê khai, nhà cung cấp và mô hình. Bất kỳ phím nào. Hermes bỏ qua các trường không xác định, vì vậy bạn có thể chú thích các mục ("tier": "trả tiền", "tags": […]`, v.v.) mà không cần phối hợp thay đổi lược đồ.
  • description — Chỉ dành cho OpenRouter. Văn bản huy hiệu của bộ chọn Drive ("được đề xuất", "miễn phí"` hoặc trống). Cổng thông tin Nous không sử dụng điều này - cổng cấp miễn phí được xác định trực tiếp từ điểm cuối định giá của Cổng.
  • Giá cả và độ dài ngữ cảnh KHÔNG có trong bảng kê khai. Chúng đến từ các API của nhà cung cấp trực tiếp (điểm cuối/v1/models, models.dev) tại thời điểm tìm nạp.

Tìm nạp hành vi​

WhenWhat happens
/model or hermes modelFetches if disk cache is stale, else uses cache
Disk cache fresh (< TTL)No network hit
Network failure with cacheSilent fallback to cache, one log line
Network failure, no cacheSilent fallback to in-repo snapshot
Manifest fails schema validationTreated as unreachable

Vị trí bộ đệm: ~/.hermes/cache/model_catalog.json.

Cấu hình​

model_catalog:
  enabled: true
  url: https://hermes-agent.nousresearch.com/docs/api/model-catalog.json
  ttl_hours: 24
  providers: {}

Đặt enabled: false để tắt hoàn toàn tính năng tìm nạp từ xa và luôn sử dụng ảnh chụp nhanh trong repo.

URL ghi đè của mỗi nhà cung cấp​

Các bên thứ ba có thể tự lưu trữ danh sách tuyển chọn của riêng mình bằng cách sử dụng cùng một lược đồ. Trỏ nhà cung cấp vào một URL tùy chỉnh:

model_catalog:
  providers:
    openrouter:
      url: https://example.com/my-openrouter-curation.json

Tệp kê khai ghi đè chỉ cần điền (các) khối nhà cung cấp mà nó quan tâm. Các nhà cung cấp khác tiếp tục giải quyết dựa trên URL chính.

Cập nhật bảng kê khai​

Người bảo trì:

# Re-generate from the in-repo hardcoded lists (keeps manifest in sync after
# editing OPENROUTER_MODELS or _PROVIDER_MODELS["nous"] in hermes_cli/models.py).
python scripts/build_model_catalog.py

Sau đó PR thay đổi kết quả từ website/static/api/model-catalog.json thành main. Trang web tài liệu tự động triển khai khi hợp nhất và bảng kê khai mới sẽ hoạt động trong vòng vài phút.

Bạn cũng có thể trực tiếp chỉnh sửa thủ công JSON để có những thay đổi siêu dữ liệu chi tiết không có trong ảnh chụp nhanh trong kho — tập lệnh trình tạo là một tiện ích chứ không phải là nguồn thông tin chính xác duy nhất.