16gagent/memory/projects/hermes-agent.md

项目记忆：hermes-agent（Gitea 备份）

最后更新：2026-05-31

基本信息

项目	内容
源仓库	NousResearch/hermes-agent (GitHub)
Gitea 镜像	git666.u7f.cn/sawz/hermes-agent
备份方式	扁平化单 commit（无历史，避开了 nginx 413 限制）
仓库大小	~225MB，4213 个文件
技术栈	Python, TypeScript, Go

关键路径

• agent/ — 核心 agent 引擎（对话循环、工具调度、错误分类）
• tools/ — 工具层（~60 个工具）
• skills/ — 技能层（~25 领域，SKILL.md 格式）
• hermes_cli/ — CLI 接口
• plugins/ — 插件系统
• gateway/ — 网关

学到的模式

• 错误分类 FailoverReason Enum + ClassifiedError Dataclass
• 工具并行门控 frozenset + 路径重叠检测
• SKILL.md YAML frontmatter + 平台匹配
• Fail-Closed 凭证检查
• Env var 回退链
• 懒加载 + 无副作用导入

备份时的坑

1. GitHub clone 慢 → 开 VPN（127.0.0.1:12000）后速度正常
2. nginx 413 限制 → Gitea 前面 nginx 限制上传 ~30MB， 完整 git push 不通过，改为扁平化单 commit 绕过
3. SSH 不通 → 注册了 key 但 Gitea 服务端没配 authorized_keys 写入