Hermes Agent：常驻自托管的 Agent
它和终端里那些编码 Agent 不是一类东西：进程常驻在你自己的机器上，从聊天软件里收指令， 能按点自己干活，还会把干过的事沉淀成技能。代价也一样实在——一个常驻进程要连你的账号、开终端、写磁盘、访问外网。 本专题共 40 篇，每篇都对着仓库里的真实文件写：能用的先讲怎么用与代价在哪，想改的再往下读内部机制。 项目仍在高频迭代，文中结论以 仓库最新代码与文档 为准。
开源自托管 Agent 项目 Hermes Agent 是什么：全景导读
从仓库结构讲清 Hermes Agent 这个开源自托管 Agent 项目：它常驻在一台机器上、从聊天软件里指挥、把做过的事沉淀成技能文件。读完你能判断它跟终端编码 Agent 是两类工具、适不适合你的场景、以及它明确不管什么。本文不覆盖逐项配置与安装细节。
上手与使用
先决定在哪跑、接哪些平台、开哪几道闸门，再谈定时任务、技能、记忆与成本。
开源项目 Hermes Agent 里的四处成本旋钮各拦哪类失控
常驻在自己机器上的 Agent，花费失控往往不是一个原因。这篇按仓库代码拆开 Hermes Agent 中与成本相关的四处机制：工具结果的字符预算、迭代预算的消耗与退款、用量核算的口径、限流状态跟踪，说清各自拦的是哪一类失控、边界在哪。只讲机制与判断，不涉及任何价格与额度数字。
开源自托管 Agent 项目 Hermes Agent 常驻部署与缩容
逐行读 NousResearch/hermes-agent 的 Dockerfile、docker-compose.yml 与网关运行代码，讲清这个开源自托管 Agent 常驻一台小机器时进程怎么起、空闲怎么缩、运维要盯什么。不讲模型效果、不给部署成本数字，也不替你决定该不该上。
开源自托管 Agent 项目 Hermes Agent 的并行派活机制
拆解开源自托管 Agent 项目 Hermes Agent 的委派链路：委派工具怎么建子 Agent 并剥掉危险工具、后台委派为什么把结果当成新一轮消息送回、插件侧生命周期服务管到哪一层。读完你能判断什么任务值得派出去、派出去之后从哪几个文件和日志盯进度。不解决模型选型与效果调优。
开源自托管 Agent 项目 Hermes Agent 的定时任务怎么跑
读 hermes-agent 的 cron 目录，讲清它的定时任务怎么定义、一次调度里发生了什么、结果往哪送，以及无人值守最容易失控的几处和它对应的拒绝式守卫。读完能判断这套设计适不适合你的场景，也知道自己动手时该在哪加锁、加台账。不含安装步骤与模型选型。
开源自托管 Agent 项目 Hermes Agent 的会话检索链路
拆解开源自托管 Agent 项目 Hermes Agent 的会话检索：本地 SQLite 加 FTS5 索引怎么拼成一条召回链路，中文与拉丁文查询各走哪条路，召回不准时该从哪一层查起。只讲仓库里读得到的机制，不含安装教程，也不替维护者预测后续行为。
开源自托管 Agent 项目 Hermes Agent 的三道闸门：审批模式、写入批准与路径安全怎么配
拆解 NousResearch/hermes-agent 里三套互不重叠的约束机制：命令审批门（含无条件拦截层与辅助模型判决）、记忆与技能的写入批准、以及路径包含校验。讲清各自防什么、代价在哪、怎么配才不是形式主义。不解决沙箱选型与合规审计。
开源自托管 Agent 项目 Hermes Agent 的语音链路与代价
拆解开源自托管 Agent 项目 hermes-agent 的语音入口：唤醒词、录音与静音判定、转写、合成播放各是一块独立组件，它用什么方式串起来，代价落在哪里。读完你能判断这条链路要不要在自己机器上开，以及先改哪个配置项。不解决语音识别调参与音色训练。
开源自托管 Agent 项目 Hermes Agent 的终端后端怎么选
hermes-agent 的终端有本地、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox 七条路。本文按源码梳理它们共同的执行契约，以及各自的隔离边界、文件同步、持久化与中断代价，帮你判断该用哪条；不讲价格额度，不做性能实测。
开源自托管 Agent 项目 Hermes Agent 起不来或断流：按这个顺序缩小范围
拆解开源自托管 Agent 项目 Hermes Agent 里的四处诊断设施——启动前的早期恢复、Windows 上的虚拟环境阻塞扫描、流式请求的断流诊断、常驻进程的退出取证，讲清每处告诉你什么、按什么顺序读，以及它们明确不管哪些故障。不提供性能调优与部署方案。
开源自托管 Agent 项目 Hermes Agent 怎么换模型与换供应商：元数据与切换动作拆解
拆开 hermes-agent 仓库里模型与供应商这条链：模型元数据实际来自哪里、上下文窗口怎么一层层解析出来、一次切换动作到底改了配置和运行时的哪几项、混用多家供应商时哪些地方会咬人。读完你能自己判断该改哪个键、该看哪个文件；不解决价格与额度选型问题。
开源自托管 Agent 项目 Hermes Agent 装机实录与必选配置
只盯着 NousResearch/hermes-agent 这一个仓库的上手记录。逐段读安装脚本到底改了你机器上的什么、配置文件里哪几项必须在第一次启动前就定下来、密钥为什么写了不生效、常驻与自我改写各自的代价在哪。不讲模型选型，不给任何价格与额度数字。
开源自托管项目 Hermes Agent：技能怎么装、怎么被检索
hermes-agent 仓库里的 skills/ 并不是运行时目录，技能真正生效的位置是用户主目录下的那一份副本。这篇按仓库文件讲清两棵技能树的关系、装载与检索分几级发生、校验器画了哪些硬红线，以及什么时候值得自己写一个。不评价单个技能好不好用，也不做项目之间的排序。
用聊天软件指挥开源自托管 Agent 项目 Hermes Agent
拆解开源自托管 Agent 项目 hermes-agent 的聊天平台适配层：微信、Signal、QQ、WhatsApp 各自怎么收消息，消息又怎么被算成同一个会话，准入是几道门，以及把 Agent 挂到自己账号上要付什么代价。不含部署教学，也不替你判断某个平台的合规风险。
自托管开源 Agent 项目 Hermes Agent 终端界面拆解
拆解 NousResearch/hermes-agent 的终端界面：它是独立的 TypeScript 前端进程，与 Python 主体只靠 stdio 上的 JSON-RPC 通信。读完你能判断多行编辑、斜杠补全、打断改口各自落在哪一层、该改哪个文件。不讲模型能力与部署运维。
自托管开源项目 Hermes Agent 的跨会话记忆由谁写入、何时写
拆解开源自托管 Agent 项目 hermes-agent 的持久记忆：两个 markdown 库谁在写、轮次计数器什么时候提醒模型去写、条目堆多了会付出什么代价、可插拔记忆后端的编排边界。读完你能判断要不要开它、开了以后哪些坑必踩。不解决模型推理能力问题，也不替你选云端后端。
结构与机制
按层逐块读：会话生命周期、多平台 gateway、终端环境抽象、学习闭环、状态层与安全边界。
开源 Agent 项目 Hermes Agent 的消息分档路由怎么做
拆解开源自托管 Agent 项目 Hermes Agent 的 profile 路由：一个进程按消息来源（平台/服务器/频道/线程）分档到不同配置目录，讲清匹配规则、加权优先级、运行时串接路径与前置开关，给出九条避坑项，并抽出可搬到自己系统的四条分档设计原则。不含安装教程，不评测效果。
开源自托管 Agent 项目 Hermes Agent 的 gateway：一个进程如何接住多个聊天平台
拆开 hermes-agent 仓库 gateway/ 目录的三块骨架——会话键与会话存储、投递路由、平台注册表，说清每块在哪个文件、各管什么、为什么维护者没有做成每平台一个进程，以及这个单进程选择放弃了什么。读完你能判断它是否适合你的常驻场景，但本文不教你逐个平台配置凭据。
开源自托管 Agent 项目 Hermes Agent 的 LSP 集成
拆开 hermes-agent 自带的 LSP 客户端：管理器、协议分帧层、服务器注册表、诊断上报四块各管什么，一次写文件在这条链路上怎么走完，为什么只给模型看增量诊断，以及它放弃了什么。读完你能判断这层值不值得在自己的 agent 里做。不讲各语言服务器的安装教程。
开源自托管 Agent 项目 Hermes Agent 的 MCP 双向落地：既当客户端又当服务端
开源自托管 Agent 项目 Hermes Agent 在 MCP 上同时是客户端和服务端：一边把外部 server 的工具接进自己的注册表，一边把消息会话和部分内建工具反过来暴露给别的 harness。本文按仓库代码梳理两个方向各自的配置面、命名与过滤规则、授权链路和失败模式，也说清哪些事它明确不管。不讲协议规范本身，不涉及价格与额度。
开源自托管 Agent 项目 Hermes Agent 的仓库结构导读
拆解 NousResearch/hermes-agent 的顶层目录：Python 运行时、Ink 终端界面、Electron 桌面端、Nix 打包为什么混在一个仓库里，四者靠什么切开，各目录按什么顺序读。读完你能拿到一张定位表、一条读码路径和一份避坑清单。不含安装教程、性能评测与功能罗列。
开源自托管 Agent 项目 Hermes Agent 的插件系统：目录分域与扩展边界
拆解开源自托管 Agent 项目 hermes-agent 的插件系统：顶层目录如何按能力域分家、plugin.yaml 清单里哪些字段真被代码读取、记忆后端与浏览器后端两组插件各自的契约与不对称之处。读完你能判断自己要加的东西该落在哪一类扩展点上，以及这套设计明确不管什么。不含安装教程与价格信息。
开源自托管 Agent 项目 Hermes Agent 的技能溯源与同步
拆解 NousResearch/hermes-agent 这个常驻自托管 Agent 项目怎么记录技能的来源、怎么在更新时不冲掉你的本地修改、怎么把技能在多台设备之间同步。读完你能判断从别处抄一个技能装进来要看哪几层记录、哪些坑必踩。不解决技能内容质量与提示注入本身。
开源自托管 Agent 项目 Hermes Agent 的可观测四块拼图
拆解开源自托管 Agent 项目 Hermes Agent 的 agent/monitoring 目录：事件发射队列、指标与日志导出、健康快照、无条件脱敏这四块如何拼成一条可查的运维通道。读完你能判断自己的常驻 Agent 该做到哪一步，以及这套设计明确放弃了什么。不解决执行轨迹回放与用量分析。
开源自托管 Agent 项目 Hermes Agent 的两套前端分工
同一个 Agent 后端，一套跑在终端里的 Ink TUI，一套是 Electron 桌面端。这篇拆开看它们各自解决什么、共享的到底是哪一层、共享层的边界画在哪里，以及这个分法放弃了什么。给你一份能照着走的上手顺序和避坑清单。不讲 Agent 方法论，也不评价模型能力。
开源自托管 Agent 项目 Hermes Agent 的三层工具收纳
一百多个工具塞进同一个模型请求，光是 schema 就要吃掉大量上下文。这篇拆解开源自托管项目 Hermes Agent 怎么用工具注册表、工具集、工具搜索桥三层控制「同时暴露给模型多少工具」：每层管什么、代码落在哪个文件、哪些配置会让你白排查半天。不讲安装步骤，不排项目座次。
开源自托管 Agent 项目 Hermes Agent 的学习链路拆解
逐个文件拆开 NousResearch/hermes-agent 的自我学习链路：/learn 怎么把总结变成一份 SKILL.md、这些技能与记忆怎么被拼成一张图、图又怎么（以及在哪里没能）变成后续行为。读完你能判断这套设计值不值得抄、抄哪一段。不讲模型训练，不做官方文档翻译。
开源自托管 Agent 项目 Hermes Agent 的状态层拆法
拆开 NousResearch/hermes-agent 的四个状态模块，看它如何把「表结构自愈」「导出导入」「搜索索引布局版本」分开管理，以及换机器、换版本时具体挡掉了哪些麻烦。读完你能拿到一份迁移前的自检顺序；不解决模型选型与效果调优。
开源自托管 Agent 项目 Hermes Agent 如何把密钥来源做成可插拔并划定作用域
拆解 NousResearch/hermes-agent 仓库里的两套密钥机制：一个只负责取值的可插拔来源契约（1Password、Bitwarden、外部命令），以及一个按档案划分的凭证作用域。读完你能拿到可直接搬到自己自托管 Agent 的接口边界与优先级规则，也会看清它明确不管的那几件事。
开源自托管 Agent 项目 Hermes Agent 写盘前的四道关
拆解开源自托管 Agent 项目 Hermes Agent 里四段互不相干的写入防护逻辑：写入批准门、路径包含校验、文件读写名单、工具调用护栏，各自管什么、代码在哪、边界在哪。读完你能对照自己的项目判断缺哪一段，以及哪些防护根本不是安全边界。不讲部署，不讲模型选型。
开源自托管 Agent 项目 Hermes Agent 怎么把网络出口关小：三块代码看清攻击面
从 hermes-agent 仓库里的网络出口隔离文档，加上 URL 安全、站点策略、威胁特征三个模块，拆开一个常驻 Agent「上网」时真正的攻击面：哪一层判定失败会拦、哪一层失败会放过、容器出口该怎么收窄。不解决模型本身的越权问题，也不替你做威胁建模。
开源自托管 Agent 项目 Hermes Agent 怎么把运行轨迹变成训练与评测数据
拆解开源自托管 Agent 项目 hermes-agent 里的批量跑批与轨迹处理支线：批量入口怎么组织任务、轨迹按什么格式落盘、压缩配置管什么、断点恢复靠什么匹配。读完你能判断这条支线值不值得接进自己的流水线，以及它明确不负责哪些事。不含正确性判分方案。
开源自托管 Agent 项目 Hermes Agent：三条压缩线怎么选
Hermes Agent 仓库里同时存在三套压缩代码：单轮内不花 token 的确定性剪枝、跨会话边界的摘要与提交、给训练数据装箱的轨迹压缩。本文对着真实文件讲清三者各自解决什么问题、分别丢掉什么、什么场景该动哪一条，以及怎么避坑。不讲通用方法论，也不评测效果。
开源自托管 Agent 项目 Hermes Agent：四种形态怎么分工
拿 pi、ECC、superpowers 和 Hermes Agent 四个开源项目放在一起，只讲设计取向的差异：谁拥有模型循环、状态放在哪、边界靠什么撑住。读完你能判断某个需求该往哪一层放，也能知道常驻自托管这条路要付什么代价。不排座次，不做安装教程。
开源自托管项目 Hermes Agent 的 MoA 多模型合议：怎么组织，何时值得付
拆解开源自托管 Agent 项目 hermes-agent 里的 MoA 机制：顾问模型看到的是哪份对话副本、顾问块贴在 aggregator prompt 的哪个位置、扇出节奏怎么掐成本、追踪文件落盘写了什么。读完你能判断哪些任务值得为多模型合议付账、哪些是纯浪费，以及打开追踪前要先想清楚什么。不解决它和别的框架谁更强。
开源自托管项目 Hermes Agent 的加平台清单：反推适配层标准
把 hermes-agent 仓库里那份「新增消息平台」清单拆开看：插件路径与改核心路径各要动什么、基类替你兜了哪些事、webhook 适配器如何处理签名与幂等。读完你能得到一套判断自家 Agent 适配层是否合格的检查项，以及一份避坑清单。不涉及部署教程、价格与选型排名。
开源自托管项目 Hermes Agent 怎么兜住技能自动创建
拆解开源自托管 Agent 项目 hermes-agent 里支撑技能自动创建的三块代码——技能预处理、技能守卫、使用统计，讲清各自负责什么、缺一块会出什么事、默认开关为什么这么设。读完你能判断要不要在自己机器上打开这些能力。不涉及模型选型、价格与效果评测。
开源自托管项目 Hermes Agent：一轮对话经历的会话与回合边界
把 hermes-agent 的会话生命周期文档和回合开场、主循环、收尾三份代码对着读，梳理会话车道与会话化身的分工、恢复标志位的优先级、压缩后重新锚定消息、发出去的字节与存下来的字节如何一致，以及中断、空回复、落库失败这些边界。不讲价格额度，也不替你选型。
自托管开源 Agent 项目 Hermes Agent 的终端环境抽象
拆解自托管开源 Agent 项目 Hermes Agent 的执行环境层：一个基类怎么把本地、SSH、Modal 云沙箱收成同一个接口，会话快照与 CWD 标记如何撑起「像同一个 shell」的错觉，文件同步为什么只管 ~/.hermes 而不管你的项目代码。读完你能判断该选哪个后端、要提前防哪几种覆盖。不讲安装教程。
自托管开源项目 Hermes Agent 的 ACP 适配层：换壳的代价
拆解 hermes-agent 仓库的 acp_adapter 目录：会话 id 为什么双轨、权限选项怎么映射、编辑批准为什么先算 diff 再问、压缩换头后靠什么元数据对账。读完能判断把常驻 Agent 换壳进编辑器要付哪些代价、该从哪个文件读起。不做模型选型与效果横评。
想把 Agent 真正搭起来，而不只是会用？
从 Agent 工程实践到数字员工落地，站内有成体系的教程与课程。