跳到主要内容

50 篇文档带有标签「developer-guide」

查看所有标签

ACP 内部机制

ACP 适配器的工作原理:生命周期、会话、事件桥接、审批流程与工具渲染

adding-platform-adapters

本指南介绍如何向 Hermes gateway 添加新的消息平台。平台适配器将 Hermes 连接到外部消息服务(Telegram、Discord、WeCom 等),使用户可以通过该服务与 agent 交互。

Billing Lifecycle (TUI)

Map from every billing/subscription state and typed refusal to the exact TUI copy and recovery action

CLI Internals

How hermes_cli is shaped: slash dispatch, config loaders, the skin engine, the transactional update pipeline, and process-identity rules

Codebase Ownership Map

Which directories belong to which subsystem, and where the right docs entry point lives for each

Cron 内部机制

Hermes 如何存储、调度、编辑、暂停、加载技能以及投递 cron 任务

Desktop Plugin SDK (@hermes/plugin-sdk)

Extend the native Hermes Desktop app — panes, pages, sidebar nav, status bar, palette commands, keybinds, themes, and a scoped backend namespace, with one import and no build step.

Egress proxy internals

How the iron-proxy egress firewall integrates with Hermes — module layout, lifecycle, security invariants, and extension points

Gateway Monitoring

Health export, structured diagnostics, fleet queries and how to extend the monitoring plane

Gateway Session Lifecycle

SessionSource, SessionEntry, SessionStore, session-key rules and multi-user isolation in the gateway

Micro-compaction

How micro-compaction amortizes context compression cost: triggers, tail sizing, the cached-prefix trade-off

Middleware

Behavior-changing plugin middleware for LLM and tool calls: contract, execution order, examples

Observer Hooks

Read-only telemetry contract for plugins: event families, correlation IDs, payload safety

Onboarding recommendations

Guided onboarding suggests outcomes from the user's app preferences and observed capabilities. It does not grant access or implement a second connection…

Plugin LLM 访问

通过 ctx.llm 在 plugin 内部运行任意 LLM 调用——支持对话或结构化输出、同步或异步。宿主持有认证凭据,失败关闭信任门控,可选 JSON Schema 验证。

Prompt 组装

Hermes 如何构建系统 prompt、保持缓存稳定性并注入临时层

Relay Shared Metrics

NeMo Relay shared metrics: what is exported, consent and retention, staging validation

State DB Recovery

How Hermes recovers state.db when the FTS index or the file itself is corrupt

Streaming TTS Internals

Sentence chunker, streaming provider ABC, capability matrix and how to add a streaming TTS provider

上下文压缩与缓存

Hermes Agent 如何通过双重压缩系统和 Anthropic prompt 缓存高效管理上下文窗口。

会话存储

Hermes Agent 使用 SQLite 数据库(~/.hermes/state.db)跨 CLI 和 gateway 会话持久化会话元数据、完整消息历史及模型配置。这替代了早期的逐会话 JSONL 文件方案。

创建 Skill

如何为 Hermes Agent 创建 skill——SKILL.md 格式、规范与发布

工具运行时

工具注册表、toolset、调度及终端环境的运行时行为

扩展 CLI

构建包装 CLI,通过自定义 widget、快捷键和布局变更来扩展 Hermes TUI

构建 Hermes 插件

逐步指南:构建包含工具、钩子、数据文件和技能的完整 Hermes 插件

架构

Hermes Agent 内部结构——主要子系统、执行路径、数据流及延伸阅读指引

添加 Provider

如何向 Hermes Agent 添加新的推理 provider——认证、运行时解析、CLI 流程、适配器、测试与文档

添加工具

如何向 Hermes Agent 添加新工具——schema、handler、注册与 toolset

程序化集成

从外部程序驱动 hermes-agent 的三种协议:ACP、TUI gateway JSON-RPC 以及兼容 OpenAI 的 HTTP API

贡献指南

如何为 Hermes Agent 做贡献 — 开发环境配置、代码风格、PR 流程

轨迹格式

Hermes Agent 以 ShareGPT 兼容的 JSONL 格式保存对话轨迹,用于训练数据、调试产物和强化学习数据集。