Hermes Agent 核心架构与全功能全景解析指南
核心定位：本文档全面剖析宿主机（英国 Cardiff 2号节点，Debian 13 ARM64）上运行的 Hermes Agent (v0.21.0) 的系统级底层架构、认知中枢、通信网关、多 Profile 专才团队、外部记忆/工具扩展协议 (MCP)、自动化调度看门狗以及全量核心功能矩阵。
作为老大的专属核心数字助理（“狗蛋儿”），Hermes Agent 承担着保护注意力、量化系统风控与保号调度、生活与健康数据资产归档、以及将高层次业务意图转化为物理级精确执行代码的总管职责。
🏛️ 一、 系统全景架构图 (Architecture Topology)
Hermes Agent 采用 分层解耦、双工长连、多 Profile 隔离沙盒与外部大脑挂载 的现代化 AI Agent 架构：
┌───────────────────────────────────────────────┐
│ 老大 (终端用户 / 指挥官) │
└───────┬───────────────────────────────┬───────┘
│ 飞书私聊 (DM) │ 飞书研发群 (@交互)
▼ ▼
┌───────────────────────────────────────────────────────────────────────────────────────┐
│ Hermes Messaging Gateway 守护进程 │
│ (Systemd: hermes-gateway.service | 7x24 小时 WSS 双工长连) │
├───────────────────────────────────────────────────────────────────────────────────────┤
│ • 平台协议适配器 (Feishu Platform Adapter / WSS 长连接 / 卡片事件响应) │
│ • 统一准入控制与群聊安全策略 (Group Policy: open / Admin Gating / 敏感词物理脱敏) │
│ • 消息路由器 (Message Router / 会话状态机 SessionDB / 请求去重与防抖) │
└───────────────────────────────────┬───────────────────────────────────────────────────┘
│
┌────────────────────────────┼────────────────────────────┐
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 主控 Profile │ │ A_Architect │ │ B_Coder │
│ (Hermes总管) │ │ (A Bot架构师) │ │ (B Bot程序员) │
├──────────────┤ ├──────────────┤ ├──────────────┤
│ 3.8-flash-high│ │3.8-flash-high│ │pro-agent/Opus│
│ 全局调度/裁决 │ │架构蓝图/证伪 │ │TDD编码/Droid │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
│ │ │
└────────────────────────────┼────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────────────────────────┐
│ Hermes Agent 核心推理与执行引擎 │
│ (/usr/local/lib/hermes-agent/venv | Python 3.11) │
├───────────────────────────────────────────────────────────────────────────────────────┤
│ • 5大认知算法引擎：第一性原理 / 系统思维 / 概率思维 / 逆向思维 / 复利思维 │
│ • 自治安全熔断红线：绝不擅自动用真钱交易 / 绝不发送未经批准消息 / 绝不硬删关键资产 │
│ • 运行态工具执行器 (Tool Executor) 与会话上下文智能压缩 (Context Compaction) │
└──────────────┬────────────────────────────┬───────────────────────────┬───────────────┘
│ │ │
▼ ▼ ▼
┌──────────────────────────────┐ ┌───────────────────────────┐ ┌────────────────────────┐
│ 长期记忆与外脑体系 │ │ 自动化 Cron 定时调度 │ │ 本地与外部工具协议 │
├──────────────────────────────┤ ├───────────────────────────┤ ├────────────────────────┤
│ • Hindsight Memory (MCP/HTTP)│ │ • 6大周期定时任务 │ │ • 内置核心工具 (29个) │
│ (pgvector + gemini-3.8) │ │ - 03:00 全量备份至GitHub│ │ (文件/终端/搜索/代码)│
│ • 本地轻量事实记忆 │ │ - 04:50 80/20极化跑步提醒│ │ • 动态延迟工具 (96个) │
│ (~/.hermes/memories/) │ │ - 06:20 美股早报推送 │ │ • 扩展 MCP 服务: │
│ • Quartz 数字花园知识库 │ │ - 09:00 绿云静默看门狗 │ │ - hindsight_memory │
│ (~/wiki/ Markdown双链) │ │ - 周六08:00 QQQ研报 │ │ - tradingview (UVX)│
│ • Homer 书签导航仪表盘 │ │ - 周日04:00 全量系统升级│ │ • Factory Droid CLI │
└──────────────────────────────┘ └───────────────────────────┘ └────────────────────────┘
🧠 二、 五大核心认知算法与执行哲学
在处理复杂工程架构、编写 Python 代码、加固 VPS 或进行量化决策支持前，Hermes 强制贯穿以下五维矩阵推演：
- 第一性原理 (First Principles)：
- 剥离经验主义与表象类比，回溯到底层物理限制、数学定律或操作系统系统调用（如直接分析
lark-oapi模块级事件循环绑定与操作系统子线程生命周期）。
- 剥离经验主义与表象类比，回溯到底层物理限制、数学定律或操作系统系统调用（如直接分析
- 系统思维 (Systems Thinking)：
- 消除单点故障，评估变更对上下游全链路的反馈回路（如修改数据库读写容错对保号状态机与每日对账的连锁影响）。
- 概率思维 (Probabilistic Thinking)：
- 拒绝使用“可能”、“大概”等模糊词汇，基于真实数据给出高/中/低置信度评级，量化期望值与风险敞口。
- 逆向思维 (Inversion Thinking)：
- 先求生存，再求增长。方案设计必须包含明确的致命缺陷推演（Pre-Mortem），前置考虑最坏情况、灾难恢复与物理熔断机制。
- 复利思维 (Compound Interest Thinking)：
- 拒绝一次性消耗。所有排错经验、系统配置与业务规则，必须沉淀为可复用的知识库卡片、自动化脚本或长期记忆。
🛠️ 三、 全量功能模块与工具体系矩阵
系统工具集分为 核心直接加载工具 (29个) 与 按需动态挂载工具 (96个)，涵盖全方位的操作系统级控制力：
1. 核心基础设施与系统运维工具
- 终端沙盒执行 (
terminal)：- 支持前台极速执行与后台守护执行（
background=True+notify=True）； - 保持跨调用的环境变量与工作目录（CWD）持久化。
- 支持前台极速执行与后台守护执行（
- 物理文件级原子操作 (
read_file,write_file,patch,search_files)：- 拒绝使用脆弱的 shell 文本工具，采用基于 AST 与模糊对齐的靶向 patch；
read_file自动解析 PDF、Office、Word、Excel 及 Jupyter Notebook。
- 持久化定时任务调度器 (
cronjob_manage)：- 支持
no_agent=True纯脚本执行器（看门狗模式，0 输出保持静默）； - 支持 LLM Agent 会话模式（执行深度研报与推理）。
- 支持
2. 外部大脑与长效记忆体系
- 自托管长期记忆中枢 (
mcp__hindsight_memory__*)：- 统一后端的长期记忆库，基于 Docker 运行的
hindsight-api与pgvector:pg16容器； sync_retain：高可靠阻断式写入事实、系统环境规范与业务铁律；recall：基于混合语义（Hybrid Keyword + Dense Vector）召回历史演化轨迹。
- 统一后端的长期记忆库，基于 Docker 运行的
- 本地快速特征记忆 (
memory)：- 维护高信噪比的用户特征画像（
USER.md）与个人备忘（MEMORY.md），每次会话上下文自动注入。
- 维护高信噪比的用户特征画像（
- Quartz 4 知识库联动：
- 直接维护
/root/wiki/content/下的数十篇核心技术卡片，每次修改自动触发 Git 提交并由 Cloudflare Pages 秒级编译上线。
- 直接维护
3. 量化金融与大盘监控
- TradingView MCP (
mcp__tradingview__*)：- 动态挂载 43 个专业金融分析工具；
- 覆盖多周期均线对齐（Weekly ➔ Daily ➔ 4H ➔ 1H）、RSI/MACD/布林带挤压扫描、BTC 宏观脉搏与全量期权链（Options Chain）异动追踪。
- 量化风控守护：
- 深度管控绿云 VPS 上的
clbot（异动风控与每月保号交易）与ccbot（资金报表与资产对账），实行只读安全与物理断路器原则。
- 深度管控绿云 VPS 上的
4. 软件工程与自主编程
- 代码执行沙盒 (
execute_code)：- 在持久化 Python 内核中批量并发调用底层工具，过滤大规模数据集。
- Factory Droid CLI (
/usr/local/bin/droid)：- 引入硅谷顶尖自主编程引擎，挂载 Claude Opus 5 (high reasoning)；
- 具备全局代码仓 AST 解析、跨文件修改与 TDD 自动化测试套件生成能力；
- 配置了平滑降级链：
Opus 5➔Sonnet 4.6➔GPT-5.6 Sol，从容应对 5 小时限额。
- 技能管理中枢 (
skill_manage,skill_view)：- 自主沉淀、编辑与演进工程技能，实现经验程序的模块化复用。
👥 四、 多 Profile 专才协同体系 (三位一体研发团队)
为了彻底根除“单一 Bot 自写自测、盲目自信、制造技术债”的缺陷，系统落地了原生的 Bot Mode 三位一体架构：
| 专才 Bot | 独立 Profile 沙盒路径 | 驱动模型 | 飞书 App 身份 | 核心职责与铁律 |
|---|---|---|---|---|
| 🤖 Hermes | ~/.hermes/ (default) | gemini-3.8-flash-high | cli_aab37c652e... | 项目总管 / 架构裁决者 • 需求拆解、任务立项、多方调度； • 真实终端回归测试执行与最终发布。 |
| 📐 A Bot | ~/.hermes/profiles/a_architect/ | gemini-3.8-flash-high | cli_aa10b11314... | 首席架构师 / 独立审核者 • 系统解耦、接口契约设计； • P0~P4 缺陷分级，强制反向推导证伪攻击（审核三问）。 |
| 💻 B Bot | ~/.hermes/profiles/b_coder/ | gemini-pro-agent | cli_aa10ac747f... | 核心程序员 / 测试实现者 • TDD 测试驱动实现，提供真实测试证据； • 大型复杂重构任务在底层唤醒 Factory Droid 攻坚。 |
- 20条研发铁律核心：
- 角色绝对分离：A 不追求代码量，B 不自判代码正确，Hermes 不盲从口头汇报；
- B 写完 ≠ 任务完成：必须经过
A审核 ➔ B修复 ➔ A复核 ➔ 真实测试 ➔ Hermes验收； - 最大 3 轮死锁熔断 (Max 3 Loops)：严禁无限拉锯扯皮。
⏱️ 五、 自动化 Cron 定时任务全景台账
系统当前由守护进程托管并精准运行着 6 大定时任务：
| 任务 ID | 任务名称 | 执行周期 (CST) | 模式 / 驱动器 | 交付渠道 | 核心业务与控制逻辑 |
|---|---|---|---|---|---|
abaa7ed22274 | HermesAgent配置与技能每日备份 | 每日 03:00 | no_agent (hermes_auto_backup.py) | 本地 + GitHub | 全量打包 .hermes 核心配置与定制技能，二进制转储 Hindsight 数据库，自动推送到 GitHub 私有仓库，保留 7 天轮转。 |
d6025cd25780 | 周度固定8020跑步计划提醒 | 每日 04:50 | no_agent (run_scheduler.py) | 飞书私聊 | 晨练出发前 10 分钟送达当日极化课表（周六固定 LSD，坚决破除 Zone 3 舒适区）。 |
680e019101db | FiNews 美股早报推送 | 每日 06:20 | no_agent (finews_check.py) | 飞书群聊 | 美股收盘后自动聚合盘面异动、关键财经资讯，推送到指定群组。 |
5a82c30a928d | 绿云CLBOT与CCBOT强化看门狗 | 每日 09:00 | no_agent (check_greencloud_bots.py) | 默认/看门狗 | 深度静默守护：探查容器存活、频繁重启、OOM、DLQ 积压、DB 体积与 800 行日志正则（正常时完全静默，异常时报警）。 |
925aab119bd2 | QQQ/QQQM周度走势技术研报 | 周六 08:00 | LLM Agent (带工具) | 飞书群聊 | 驱动 TradingView MCP 与 Python 抓取多周期均线、RSI 及期权墙，输出结构化技术研报。 |
2cdc4b1937f4 | 每周系统全量自动升级 | 周日 04:00 | no_agent (weekly_system_upgrade.py) | 默认/原渠道 | 独立脚本执行 hermes update、hermes doctor、全量 Docker 容器更新清理、TradingView MCP 维护与知识库编译发布。 |
🏃 六、 生活与健康量化工程 (以跑步与健康为例)
Hermes 具备完整的端到端个人数据工程能力：
- Garmin
.fit轨迹全自动解析 (sync_workout.py)：- 飞书接收
.fit文件 ➔ 自动提取配速、心率、步频、步数、卡路里； - 依据 Karvonen 储备心率模型计算 Zone 1 ~ Zone 5 精确分布；
- 自动按 GPS 纬度智能判定运动地点（印尼海外园区 / 国内）；
- 飞书接收
- 全周期跑量统计与能力演进看板 (
运动数据.md)：- 自动追加流水，生成年度/月度/周度跑量矩阵；
- 渲染 Mermaid 趋势曲线，动态跟踪配速提升、步频中枢跃迁与有氧效率指数（AeI）。
🔒 七、 自主性边界与安全硬性红线
Hermes 严格遵循以下未经明确批准绝不触碰的安全底线：
- 资金安全：绝对禁止执行任何实盘交易、向外转账或注册付费服务（Tradier / Alpaca 严格保持只读）；
- 凭据安全：所有知识卡、日志与对话输出必须执行前置脱敏（
[REDACTED]），严禁泄露 API Key、数据库密码与环境变量； - 环境安全：绝不随意修改防火墙规则、底层安全模块或无确认删除核心生产资产；
- 外部社交：绝不擅自向真实人类发送未授权消息。
相关链接
- HermesAgent宿主机部署备份与灾备恢复SOP 宿主机灾备还原与 15 分钟满血复活 SOP
- 定时任务调度与看门狗台账 6 大 Cron 定时任务全景台账
- 三位一体AI协作研发团队架构设计与SOP 多 Agent 协作与研发 20 条铁律
- Factory_AI_Droid部署实战与运维全景指南 Droid CLI 引擎配置与模型降级指南
- 周度固定循环8020极化跑步训练方案 80/20 极化跑步进阶规程
- 运动数据 历史 43 次跑步资产与能力进阶曲线