Hermes Agent 不仅是 CLI 工具，还支持网关模式、定时任务、多平台消息推送等生产级能力。

网关模式

网关模式让 Hermes 作为后台常驻服务运行，通过微信、Telegram、Discord 等平台交互。

启动网关

1

hermes gateway

WeChat 集成

通过 WeChat 网关，可以在微信中直接与 Hermes 对话：

• 发送消息 → Hermes 处理 → 返回结果
• 自动识别上下文，追踪对话线程
• 支持文件、图片等多模态输入

配置方式（config.yaml）：

1
2
3
4
5

# 网关相关配置
gateway:
  strict: false
  trust_recent_files: true
  trust_recent_files_seconds: 600

消息格式

定时任务 (Cron)

Hermes 内置定时任务调度器，支持：

1
2
3
4
5
6
7
8
9

# 创建定时任务
cronjob(action='create', schedule='0 9 * * *', prompt='每天早上9点推送新闻简报')

# 列出任务
cronjob(action='list')

# 管理任务
cronjob(action='pause', job_id='xxx')
cronjob(action='remove', job_id='xxx')

支持的时间格式：

定时任务可以附带技能，也可以运行自定义脚本（Watchdog 模式）。

MCP 工具

Hermes 内置原生 MCP 客户端，连接 MCP 服务器即可动态注册工具。

已配置的 MCP 工具

1. CodeGraph — 代码分析

1
2
3
4

mcp_servers:
  codegraph:
    command: codegraph
    args: [serve, --mcp]

用于：代码结构分析、调用链路追踪、影响范围分析、搜索符号。

2. Midscene Web — 浏览器自动化

1
2
3
4

mcp_servers:
  midscene-web:
    command: npx
    args: ['@midscene/web-bridge-mcp']

用于：网页操作、截图验证、表单填写、功能测试。

日常使用场景

场景一：代码审查

1
2
3

请求：帮我审查这个 PR 的代码
→ 自动加载 github-code-review 技能
→ 读取 diff → 分析代码质量 → 生成审查意见

场景二：文章写作

1
2
3

请求：写一篇关于 Swift Concurrency 的文章
→ 自动匹配写作技能
→ 生成初稿 → 润色 → 发布到博客

场景三：服务器运维

1
2

请求：检查服务器状态
→ 自动连接服务器 → 执行诊断命令 → 返回报告

场景四：定时新闻简报

设定每天早上自动推送技术资讯到微信：

1
2

cronjob(action='create', schedule='0 8 * * *', 
        prompt='搜集今天的技术热点，生成中文摘要推送到微信')

小贴士

💡 记忆系统 — Hermes 会记住你的偏好和项目配置，无需重复说明

⚠️ 安全性 — 敏感命令需要手动确认（删除文件、重启服务等）

🔄 持续更新 — hermes update 拉取最新版本（当前 v0.15.1，落后 1924 commits 时有更新提示）

参考：Hermes Agent 文档

一、iOS数据持久化方式

• XML属性列表（plist）归档
• Preference(偏好设置)，本质还是通过"plist"来存储数据, 但是使用更简单(无需关注文件、文件夹路径和名称)
• NSKeyedArchiver归档(NSCoding)，可以把任何对象, 直接保存为文件的方式。
• SQLite3，当非常大量的数据存储时使用
• Core Data，就是对SQLite的封装

关于bundle路径和sandbox沙河路径：
（1）bundle路径：应用程序 (APP) 在手机里面的安装路径
（2）沙河路径：专门用来存储App自己数据的一个路径，iOS为每个app都分配了一个专门用来存储这个app自身的一些数据的路径

二、应用沙盒(应用程序的文件夹)

1. 打印沙盒路径

1

NSLog(@"%@",NSHomeDirectory());

2. 使用Documents目录进行数据持久化的保存，我们平时操作数据主要使用Documents目录

1
2
3
4
5

// 1
let path = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true)[0] + "/test.plist"

// 2
let url = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0].appendingPathComponent("test.plist")

1

NSString *path = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"test.plist"];

• 参数1：第一个参数指定了搜索的路径名称，NSDocumentDirectory表示是在Documents中寻找，NSCachesDirectory的话就是在cache文件夹中寻找
  常用枚举：
  NSDocumentDirectory
  NSCachesDirectory

• 参数2：
  NSUserDomainMask = 1,//用户主目录中
  NSLocalDomainMask = 2,//当前机器中
  NSNetworkDomainMask = 4,//网络中可见的主机
  NSSystemDomainMask = 8,//系统目录,不可修改(/System)
  NSAllDomainsMask = 0x0ffff,//全部
• 参数3：是否展开波浪线，一般为YES展开

Documents：

需要保存由应用程序本身产生的文件或者数据，例如：游戏进度、涂鸦软件的绘图
目录中的文件会被自动保存在 iCloud
注意：不要保存从网络上下载的文件，否则会无法上架！

tmp：

保存临时文件，后续不需要使用
tmp目录中的文件，系统会自动清理
重新启动手机，tmp 目录会被清空
系统磁盘空间不足时，系统也会自动清理
路径获取：NSString *tmp = NSTemporaryDirectory();

Library/Caches：

保存临时文件，后续需要使用，例如：缓存图片，离线数据(地图数据)
系统不会清理cache目录中的文件
就要求程序开发时，必须提供cache目录的清理解决方案
路径获取：利用NSSearchPathForDirectoriesInDomains函数(将函数的第2个参数改为：NSCachesDirectory即可)

Library/Preference：

保存应用的所有偏好设置，使用 NSUserDefault直接读写，iOS的Settings(设置)应用会在该目录中查找应用的设置信息。iTunes同步设备时会备份该目录。该目录由系统管理, 无需我们来管理。通常用来存储一些基本的软件配置信息, 比如记住密码、自动登录等。
路径获取： 通过NSUserDefaults类存取该目录下的设置信息

三、使用方法

1、属性列表

• 属性列表是一种XML格式的文件，拓展名为plist，如果对象是NSString、NSDictionary、NSArray、NSData、NSNumber等类型，就可以使用，
• 注意：不能存储自定义对象，会失败的
• 存方法：writeToFile
• 读方法：如字典， dictionaryWithContentsOfFile

2、偏好设置

• 通过NSUserDefaults就能直接访问软件的偏好设置(Library/Preferences)
  UserDefaults设置数据时，不是立即写入，而是根据时间戳定时地把缓存中的数据写入本地磁盘。所以调用了set方法之后数据有可能还没有写入磁盘应用程序就终止了，为解决上述问题，通过调用synchornize方法强制写入。
• 写入步骤：
  （1） 获取偏好设置对象

1

let userDefault = UserDefaults.standard

1

NSUserDefaults *userDefault = [NSUserDefaults standardUserDefaults];

（2）写入

1
2

userDefault.setValue(switcher.isOn, forKey: "key_name")
// [userDefault setBool:switcher.isOn forKey:@"key_name"];

（3）同步

1
2

userDefault.synchronize()
// [userDefault synchronize];

• 读取步骤：
  （1） 获取偏好设置对象

1

NSUserDefaults *userDefault = [NSUserDefaults standardUserDefaults];

（2）用一个变量接收

1

switcher.on = [userDefault boolForKey:@"key_name"];

3、自定义对象归档 NSKeyedArchiver

注意： 必须遵守NSCoding协议的对象才可以进行归档解档，默NSString、NSDictionary、NSArray、NSData、NSNumber等类型已遵守NSCoding协议，可以直接归档解档。

（1）遵守NSCoding协议，实现协议方法

NSCoding协议中两个方法，一般写在模型中：

• 归档调用
  一般在这个方法里面指定如何归档对象中的每个实例变量，可以使用encodeObject:forKey:方法归档实例变量

1
2

- (void)encodeWithCoder:(NSCoder *)aCoder;
[encoder encodeObject:self.name forKey:@"name"];

• 解档调用
  一般在这个方法里面指定如何解码文件中的数据为对象的实例变量，可以使用decodeObject:forKey方法解码实例变量

1
2

- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder;
self.name = [decoder decodeObjectForKey:@"name"];

initWithCoder原理:只要解析文件就会调用，xib,storyboard都是文件，因此只要解析这两个文件，就会调用initWithCoder，因此如果在storyboard使用自定义view,重写initWithCoder方法，一定要调用[super initWithCoder:]，因为只有系统才知道怎么解析storyboard，如果没有调用，就解析不了这个文件。

（2）归档一个对象（先获取路径path）

1
2

Person *person = [[[Person alloc] init];
[NSKeyedArchiver archiveRootObject:person toFile:path];

（3）解档一个对象

1

Person *person = [NSKeyedUnarchiver unarchiveObjectWithFile:path];

注意：
（1）如果父类也遵守了NSCoding协议，应该在encodeWithCoder:方法中加上一句[super encodeWithCode:encode];确保继承的实例变量也能被编码，即也能被归档
（2）在initWithCoder:方法中加上一句self = [super initWithCoder:decoder];确保继承的实例变量也能被解码，即也能被恢复

4、多个对象归档解档

使用archiveRootObject:toFile:方法可以将一个对象直接写入到一个文件中，但有时候可能想将多个对象写入到同一个文件中，那么就要使用NSData来进行归档对象，NSData可以为一些数据提供临时存储空间，以便随后写入文件，或者存放从磁盘读取的文件内容。可以使用[NSMutableData data]创建可变数据空间
（1） 归档步骤

1
2
3
4
5
6
7
8
9
10
11

// 新建一块可变数据区
NSMutableData *data = [NSMutableData data];
// 将数据区连接到一个NSKeyedArchiver对象
NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];
// 开始存档对象，存档的数据都会存储到NSMutableData中
[archiver encodeObject:person1 forKey:@"person1"];
[archiver encodeObject:person2 forKey:@"person2"];
// 存档完毕(一定要调用这个方法)
[archiver finishEncoding];
// 将存档的数据写入文件
[data writeToFile:path atomically:YES];

（2） 解档步骤

1
2
3
4
5
6
7
8

// 从文件中读取数据
NSData *data = [NSData dataWithContentsOfFile:path];
// 根据数据，解析成一个NSKeyedUnarchiver对象
NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];
Person *person1 = [unarchiver decodeObjectForKey:@"person1"];
Person *person2 = [unarchiver decodeObjectForKey:@"person2"];
// 恢复完毕
[unarchiver finishDecoding];

很多时候我们都需要一个公共的资源地址来存储自己的文章等信息，作为一个coder，那当然是要用我们专属的语言来写日记了（markdown）。这里就给大家讲解一下如何使用typora + PicGo + github 打造专属的编辑&存储方式。

准备

一、从上面的链接中下载并安装typora和PicGo
二、 登录github账号

1. 创建公开资源库
   
2. 生成新令牌

• 依次点击 右上角点用户头像 -> Settings -> Developer settings -> Personal access tokens）-> Generate new token
  

• 设置令牌描述性名称，过期时间看自己情况选择，Select scopes只勾选：repo、 user
  

• Generate token 生成令牌 ⚠️令牌只显示一次，一定要复制保存好

设置PicGo图床

1. 打开picgo后在顶部菜单栏右击图标，选择打开详情窗口，选择PicGo设置并勾选GitHub图床；就会在图床设置处显示图床
   

2. 配置GitHub图床

• 填写github账号名： github账户/仓库名
• 一般为master或者main，具体看你的建的仓库
• 个人令牌，就是之前在github中生成私人令牌时得到的一串字符串
• 图片存放在仓库下面的哪个目录，不填就在项目的根目
• 默认的域名无法访问，修改为官方https://raw.githubusercontent.com/github账户/仓库名/master/img/icon.png 或者 CDN域名https://cdn.jsdelivr.net/gh/github账户/仓库名/img/icon.png，推荐使用cdn域名
  

3. 复制任意图片后，点击菜单栏应用图标，即可看到图片上传

typora图片上传

1. 打开typora的偏好设置下的图像
2. 插入图片时默认无操作，根据情况选择是否上传图片；勾选以下选项

• 对本地位置的图片应用上述规则

3. 上传服务 选PicGo.app后即可

1
2

同样的，该文章就是以配置好的Typora编写的，所有截图复制后就上传并替换链接为cdn域名，简直方便的不行。
顺便说下改文章的截图工具为ishot，自动阴影注释等👍

• ishot Mac上最强的截图工具

一、卸载 nvm（避免冲突）

1. ​卸载 nvm​：

   在终端执行以下命令移除 nvm 及其配置：

   nvm unload                    # 卸载 nvmrm -rf "${NVM_DIR:-~/.nvm}"  # 删除安装目录

2. ​清理配置文件​：

   编辑 shell 配置文件（如 ~/.zshrc或 ~/.bashrc），删除以下行：

   export NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"[[ -r $NVM_DIR/bash_completion ]] && \. $NVM_DIR/bash_completion

   完成后运行 source ~/.zshrc（或重启终端）。

二、安装 Volta

1. ​自动安装​：

   • ​Mac/Linux​：

     curl https://get.volta.sh | bash

   • ​Windows​：

     winget install Volta.Volta

     安装后重启终端，运行 volta --version验证是否成功。

2. ​手动配置（可选）​​：

   若需自定义安装路径（如 Windows 下移至 D 盘）：

   • 设置环境变量 VOLTA_HOME=D:\Volta；
   • 在 PATH中添加 %VOLTA_HOME%\bin。

三、迁移项目配置

1. ​全局设置默认 Node 版本​：

   volta install node@18  # 安装并设为全局默认版本

2. ​为项目固定版本​：

   进入项目根目录，执行以下命令（Volta 会自动在 package.json中生成配置）：

   volta pin node@16.14.2    # 固定 Node 版本volta pin npm@8.5.0       # 可选：固定 npm 版本volta pin yarn@1.22.19    # 可选：固定 Yarn 版本

   生成的 package.json示例：

   {  "volta": {    "node": "16.14.2",    "npm": "8.5.0"  }}

   ​提交此变更到 Git，确保团队成员无需手动切换版本。

3. ​自动版本切换​：

   进入已配置 Volta 的项目目录时，Volta 会自动切换到对应 Node 版本；若本地无该版本，会自动下载。

四、高级功能

1. ​支持 PNPM（实验性）​​：

   • 在 shell 配置文件（如 ~/.zshrc）中添加：

     export VOLTA_FEATURE_PNPM=1

   • 重启终端后即可用 volta pin pnpm@7.x管理版本。

2. ​常用命令汇总​：

   命令	作用
   volta list	查看已安装工具版本
   volta install node@20	安装指定 Node 版本
   volta uninstall node@14	卸载版本
   volta which node	查看当前使用的 Node 路径
   volta run node app.js	在 Volta 环境下运行命令

五、注意事项

1. ​全局工具迁移​：

   若之前通过 nvm 安装全局包（如 pm2），需用 npm list -g --depth=0列出后，通过 npm install -g <包名>重新安装。

2. ​版本兼容性​：

   • Volta 不支持 32 位 Node.js；
   • 对旧项目（如 Node.js 12），建议验证版本是否可用。

总结

Volta 通过自动化版本切换和项目级配置，解决了 nvm 需手动切换的痛点。迁移后，团队可通过 package.json统一环境，减少协作冲突。

安装

首先去官网下载，因为国内网络问题，需要配置网络加速，可以使用：

• http://hub-mirror.c.163.com 网易
• https://registry.docker-cn.com 中国区官方
• docker.mirrors.ustc.edu.cn 中国科技大学

{  "registry-mirrors": [    "https://docker.registry.cyou",    "https://docker-cf.registry.cyou",    "https://dockercf.jsdelivr.fyi",    "https://docker.jsdelivr.fyi",    "https://dockertest.jsdelivr.fyi",    "https://mirror.aliyuncs.com",    "https://dockerproxy.com",    "https://mirror.baidubce.com",    "https://docker.m.daocloud.io",    "https://docker.nju.edu.cn",    "https://docker.mirrors.sjtug.sjtu.edu.cn",    "https://docker.mirrors.ustc.edu.cn",    "https://mirror.iscas.ac.cn",    "https://docker.rainbond.cc"  ]}

使用compose统一配置mysql、redis镜像

1. 在用户目录~下新建mkdir -p docker/service目录
2. 在service目录下新建文件docker-compose.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

version: "3"
services:
  redis:
    image: redis:5.0.4
    ports:
      - ${REDIS_PORT}:6379
    volumes:
      - "${REDIS_DIR}/conf:/usr/local/etc/redis"
      - "${REDIS_DIR}/data:/data"
    command:
      redis-server

  mysql:
    image: mysql:5.7
    ports:
      - ${MYSQL_PORT}:3306
    volumes:
      - "${MYSQL_DIR}/data:/var/lib/mysql"
      - "${MYSQL_DIR}/conf.d:/etc/mysql/conf.d"
    environment:
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}

1. docker-compose.yml文件会读取系统环境变量以及当前目录下的.env文件变量

1
2
3
4
5
6
7
8
9
10

# redis
REDIS_PORT=6379
REDIS_PWD=123456
REDIS_DIR=./redis

# mysql
MYSQL_PORT=3306
MYSQL_DIR=./mysql
MYSQL_ROOT_PASSWORD=123456 # 密码只在初始化时设置

运行后会默认生成镜像服务容器名service_mysql_1, service_redis_1

docker-compose常用命令

• docker-compose up -d [options] [SERVICE…]
  该命令十分强大，它将尝试自动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器的一系列操作。
  链接的服务都将会被自动启动，除非已经处于运行状态。
  -d 以守护进程方式运行

• docker-compose down
  此命令将会停止 up 命令所启动的容器，并移除网络

• docker-compose restart [options] [SERVICE…]
  重启项目中的服务。

安装nginx

1. 拉取nginx镜像 docker pull nginx@latest

2. 查看镜像 docker images

3. 运行镜像为容器

   docker run -d -p 4000:80 --name service_nginx nginx

   用4000端口映射80，用service_nginx作为容器名，对应仓库镜像 nginx

4. 查看容器

   docker ps -a

   所有容器，包括未运行

5. 以终端的方式进入nginx容器

   docker exec -it service_nginx bash

6. 复制文件到本地

   docker cp service_nginx:/etc/nginx ~/docker/nginx/config/

   docker cp service_nginx:/usr/share/nginx/html ~/docker/nginx/

   docker cp service_nginx:/var/log/nginx ~/docker/nginx/logs/

7. 关闭容器, 重启并挂载文件

   docker rm -f service_nginx

   docker run --name service_nginx -p 4000:80
   -v ~/docker/nginx/config/:/etc/nginx
   -v ~/docker/nginx/html:/usr/share/nginx/html
   -v ~/docker/nginx/logs:/var/log/nginx
   --link service_mysql_1:mysql
   -d nginx

--link service_mysql_1:mysql，表示 nginx 容器要连到 service_mysql_1 容器，冒号表示该容器的别名是mysql

问题

修改密码

进入docker exec -it service_mysql_1 bash mysql -u root -p

# 修改普通用户，只改一个就好SET PASSWORD FOR 'youruser' = PASSWORD('newpwd');# 修改root用户，改两个SET PASSWORD FOR 'root' = PASSWORD('newpwd');SET PASSWORD FOR 'root'@'localhost'=PASSWORD('newpwd');