Hermes 文件结构与配置结构科普视频方案

> 目标：做一期给非专业人士看的 Hermes 科普视频，让用户看完后知道： > 1. Hermes 项目文件结构大概是什么 > 2. 用户自己的配置文件放在哪里、分别管什么 > 3. 如果想改配置，应该怎么改才安全 > 4. Hermes 自带 Web UI 和 Open WebUI 前端分别怎么用

---

这期视频不是教观众“写代码”，而是教他们：

把 Hermes 看成一个 AI 助手系统，理解它的“办公室怎么分工、配置放哪里、改设置怎么不出错”。

---

• 普通人也能看懂：Hermes 的文件结构到底在干嘛？
• 一次讲清 Hermes：项目文件、配置文件、Web UI 怎么用
• 不会编程也能懂：Hermes 配置文件结构全科普

• Hermes 文件到底怎么分？
• 改配置别乱改！
• Hermes Web UI 怎么装？

---

不要一上来就讲“架构”“依赖”“模块”。 最好用生活比喻：

• 项目源码目录 = 工厂内部结构图
• ~/.hermes/ = 你的个人办公室
• config.yaml = 设置面板
• .env = 保险箱（放密钥）
• skills/ = 助手学会的工作模板
• memories/ = 助手记住你的习惯
• sessions/ = 聊天记录
• logs/ = 故障记录
• dashboard / Open WebUI = 可视化操作界面

这样非技术用户更容易懂。

---

很多人第一次看 Hermes 会混淆两件事：

这是 Hermes 本体的工程目录，类似“机器内部结构”。

根据项目开发文档，核心结构包括：

• run_agent.py：Agent 主循环
• model_tools.py：工具调度
• toolsets.py：工具集定义
• cli.py：CLI 交互入口
• hermes_state.py：会话数据库
• agent/：提示词、上下文压缩、模型元数据等内部逻辑
• hermes_cli/：命令行子命令、配置系统、skin/theme、web server
• tools/：terminal、browser、file、memory、delegate 等工具实现
• gateway/：Telegram / Discord / Slack 等消息网关
• cron/：定时任务
• tests/：测试
• web/：前端 Web UI 工程（React + Vite）

这是普通用户最需要关心的地方，属于“你自己的工作区”。

文档里明确写到，~/.hermes/ 里常见内容包括：

• config.yaml：非敏感设置
• .env：API key、密码、token 等敏感信息
• auth.json：OAuth 登录信息
• SOUL.md：主代理人格/身份
• memories/：长期记忆
• skills/：技能
• cron/：定时任务
• sessions/：会话
• logs/：日志

> 普通用户平时主要改的是 ~/.hermes/，不是 Hermes 源码目录。

这是最重要的一句，能帮观众避免“把项目源码和个人配置搞混”。

---

这是主要设置文件。

适合放：

• 模型选择
• terminal backend
• 工具开关
• 压缩、显示、TTS 等一般配置
• 网关行为

文档里有一句特别重要：

> 非敏感设置放 config.yaml。

这是敏感信息文件。

适合放：

• API keys
• bot token
• 密码
• 认证密钥

文档明确说：

> Secrets go in .env.

这是 Hermes 学到的工作方法。

可以给观众解释成：

• 不是“知识库”
• 更像“操作 SOP / 模板”

这是 Hermes 记住你的习惯、偏好、长期背景的地方。

可以解释成：

• skills = 它学会怎么做事
• memories = 它记住你是谁

---

最适合非专业人士的讲法是分成三档：

``bash hermes config set KEY VALUE ``

文档明确写到：

• hermes config set 会自动把值写到正确的地方
• API key 会写进 .env
• 其他设置写进 config.yaml

这非常适合视频里强调：

> 不熟悉 YAML 的用户，优先用 hermes config set。

``bash hermes config edit ``

适合：

• 已经知道自己在改什么
• 想直接编辑 config.yaml