在 CNB 平台一键启动的 AI 编程助手开发环境，基于 Nous Research 的 Hermes Agent 构建。

Hermes Agent 是一款自进化 AI 智能体，能从经验中生成技能，在使用过程中持续优化，主动巩固所学知识，并跨会话构建对您日益深入理解的个人认知模型。

• 多模型支持 — 兼容 OpenRouter、Anthropic、Gemini、OpenAI、本地模型（Ollama、LM Studio 等）多种推理提供商
• 丰富的工具集 — 终端命令执行、文件读写、网页搜索、浏览器自动化、图像分析、语音转录等
• 跨会话记忆 — 持久化记忆系统，自动保存关键信息，越用越了解你
• 技能系统 — 从复杂任务中自动提炼可复用技能，支持创建、分享和安装
• 定时任务 — 通过 Cronjob 调度自动化工作流
• MCP 扩展 — 支持连接外部 MCP 服务器，无限扩展工具能力
• 多平台接入 — 支持 微信、QQ、企业微信、飞书、钉钉 等消息平台
• CNB NPC 支持 — 可作为 CNB 平台 NPC 角色运行，自动回复 Issue/PR 评论、执行结构化操作

⚠️ 使用前请先 Fork 本项目

Fork 完成后，进入你的仓库页面：

1. 点击页面上的「 云原生开发 」 按钮

   💡 该按钮由平台提供，仅在 Fork 后的仓库中可见

2. 即可一键启动 Hermes Agent 🚀

   无需手动配置环境，开箱即用。

3. 自定义配置（可选）

   本项目的 config.yaml 已预配置为使用 CNB 平台的 AI 服务。如需自定义，可参考 config.yaml.tpl 模板进行修改。

4. 自定义技能（可选）

   将技能放入 skills/ 目录即可自动加载。每个技能是一个子目录，需包含 SKILL.md 文件：

   skills/
   ├── cnb-openapi-skills/    # 已有：CNB 平台 API 技能
   │   └── SKILL.md
   └── my-custom-skill/       # 新增：你的自定义技能
       └── SKILL.md
   

   SKILL.md 基本格式：

   ---
   name: my-skill-name
   description: 技能描述，说明何时触发以及做什么
   requires:
     bins: [curl]
     env: [SOME_API_KEY]
   ---
   
   # 技能详细说明
   
   这里编写技能的具体指令和规则...
   

启动环境后，你可以立即尝试：

# 启动 Hermes 对话
hermes

# 查看可用技能
hermes skills list

# 创建一个定时任务
hermes cron create --schedule "0 9 * * *" --prompt "每日晨报生成"

# 运行 Python 代码
hermes python --code "print('Hello, Hermes!')"

本项目支持 CNB 平台的 NPC（Non-Player Character）功能，可在 Issue 和 PR 中被 @Hermes-Agent 提及后自动回复。

在 Issue 或 PR 评论中：

@Hermes-Agent 帮我分析一下这个 issue

勾选「替我上班」后，NPC 将获得代码写入权限，可以：

• 自主编写代码并推送
• 创建分支和合并请求
• 协助解决 Issue

npc/
├── main.py            # 主入口，编排 NPC 处理流程
├── hermes_client.py   # Hermes Python 库封装，处理 AI 调用
├── cnb_api.py         # CNB 平台 API 交互（评论、标签等）
├── prompt_builder.py  # 构建带上下文的 Agent Prompt
├── output_parser.py   # 解析 Hermes 输出为结构化操作
└── start.sh           # 流水线入口脚本

Hermes 不支持 JSON 输出模式，通过以下方式实现结构化交互：

1. 直接回复：大多数场景下 Hermes 的自然语言输出直接作为评论发布
2. 操作指令：需要执行操作时，Prompt 引导 Hermes 输出标记块，由 output_parser.py 解析

支持的 NPC 操作类型：comment、close_issue、open_issue、add_label、add_assignee、create_pr、create_branch

Q: 首次启动要多久？ A: 首次启动需要几分钟拉取镜像，请耐心等待。后续启动会快很多。

• Hermes Agent 官方仓库：https://github.com/NousResearch/hermes-agent
• Hermes Agent 官方文档：https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
• CNB 官方文档平台：https://docs.cnb.cool

• Nous Research — 开发了优秀的 Hermes Agent 核心
• 没猫饼 — 低调的猫
• CNB 平台 — 提供强大的云原生构建和运行环境
• 所有开源社区的贡献者

---

本项目基于 MIT License 开源。