在玩转 Hermes‑Agent 的过程中，hen多小伙伴dou会碰到一个“隐形”难题：我的自定义技Neng、对话历史和配置信息究竟存在哪儿？Ru果不清楚路径，一旦换电脑或重新装系统，这些心血结晶hen可Neng会灰飞烟灭。别慌，下面我们把所有关键目录、文件以及Zui安全、Zui省事的同步方案一次性说清楚。

打开项目根目录，你会kan到几大“宝库”。它们分别承担了「代码」「模型密钥」「运行时缓存」以及「记忆」四大职责：

skills/ —— 所有自动生成的Neng力、手写的插件以及沉淀下来可复用的模块，dou躲在这里。

.env & config.yaml —— 环境变量文件和全局配置，记录 API Key、工具开关以及个人偏好。

memory/ —— 智Neng体保存你的使用习惯、历史对话和定制化设定的地方。

venv/__pycache__/ … 等临时目录 —— 运行时产生的字节码或系统隐藏文件，完全Ke以抛弃。

只要把这些核心文件夹打包上传，下次登录新机器时直接拉取，就Neng无缝继续上一次的工作流。

在项目根部执行以下命令即可定位：

cd path/to/hermes-agent
ls -R skills/

你会kan到类似下面的结构：

skills/
├── __init__.py
├── auto_generated/
│   └── ...      # 系统自动生成的Neng力脚本
├── custom/
│   └── my_skill.py   # 你自己写的插件
└── shared/
    └── utils.py      # 多个技Neng共用的工具函数

这里每一个 .py 文件dou是 Hermes Neng力树的一根枝桠，删掉它们就等于拔掉了对应功Neng。

.env 中通常存放类似下面的键值：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxx
HERMES_MODE=prod
DEBUG=False

而 config.yaml 则是geng具结构化的配置，例如模型名称、默认温度等。两者dou不建议直接推送到公开仓库，因为泄露后可Neng导致 API 被滥用。

每一次对话结束后Hermes 会把上下文写入 JSON 或 pickle 文件，形如：

memory/
├── conversation_2024-04-23.json
└── user_prefs.pkl

这块数据决定了智Neng体是否Neng够“记得”你上次说过的话题，是提升交互体验的关键所在。

*温馨提示*：下面所有命令均假设你Yi经在 GitHub 上创建了一个私有仓库，并且本机Yi经装好 Git 与 Python 虚拟环境。

cd /path/to/hermes-agent
git init                                 # 初始化空仓库
cat> .gitignore 

# 把下面链接替换成自己的仓库地址
git remote add origin https://github.com/你的用户名/你的仓库名.git
# 主分支统一叫 main，这里强制改名防止默认出现 master 的尴尬局面
git branch -M main
# 推送代码到远端
git push -u origin main
# 若遇到 “permission denied” 请检查 token 权限或 SSH 配置。

git clone https://github.com/你的用户名/你的仓库名.git ~/hermes-agent
cd ~/hermes-agent

python -m venv venv          # 创建虚拟环境
source venv/bin/activate     # Linux/macOS 激活；Windows 用 venv\Scripts\activate.bat 
pip install -r requirements.txt   # 安装全部第三方库

version: '3'
services:
  hermes:
    image: your-registry/hermes-agent:latest
    volumes:
      - ./skills:/app/skills        # 挂载技Neng目录
      - ./memory:/app/memory       # 挂载记忆数据卷
      - ./config.yaml:/app/config.yaml   # 挂载全局配置
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    restart: unless-stopped

git remote add origin https://github.com/你的用户名/你的仓库名.git \
&& git branch -M main \
&& git push -u origin main

git lfs install                     # 初始化 LFS 支持 
git lfs track "memory/*.json"       # 指定追踪模式 
git add .gitattributes               # 提交追踪规则 
git commit -m "Add LFS tracking for memory files"
git push origin main                # 正式推送大文件