一、项目概述1.1 什么是 Hermes KanbanHermes Kanban 是 Hermes Agent v0.12.0 版本引入的多智能体任务编排系统基于 SQLite 持久化看板支持任务拆解、角色分派、并行执行与自动状态流转。它将抽象的项目目标转化为结构化、可分配、可追踪的卡片式任务单元每个卡片绑定特定 AI 角色与执行上下文支持并行处理与状态自动更新。Hermes Agent 是由 Nous Research 开发的开源自主进化 AI 智能体框架MIT 协议GitHub Star 已突破 10万核心定位是与你一起成长的智能体The agent that grows with you。1.2 项目背景维度信息开发团队Nous Research知名开源大模型实验室开源协议MIT核心语言Python93.6%首次发布2026年2月GitHubhttps://github.com/NousResearch/hermes-agentKanban模块引入版本v0.12.0当前最新版本v0.13.01.3 解决的核心问题传统单 Agent 模式处理复杂工作流时存在三大痛点任务阻塞多步骤串行执行一步卡住全流程停滞状态丢失会话结束后任务进度不可追踪无法断点续传协同混乱多角色混在同一上下文中能力冲突、职责不清Hermes Kanban 通过将看板方法论源自精益生产与 AI Agent 编排相结合解决了上述问题。二、架构设计2.1 整体架构Hermes Agent 是一个事件驱动的分层架构系统结合了插件化设计和微服务化组件模式。Kanban 模块作为其中的核心任务编排层位于架构中间位置2.2 Kanban 模块核心设计2.2.1 数据模型Kanban 系统采用 SQLite 作为持久化存储核心数据模型父任务卡片 (Parent Task)顶层任务节点包含拆解规则和角色列表子任务卡片 (Sub Task)拆解后的原子任务绑定角色和执行上下文任务状态机pending → assigned → running → completed / failed / blocked关系映射父子任务通过parent_id建立层级关系持久化文件路径~/.hermes/kanban.db2.2.2 角色化智能体分派每个 Kanban 任务卡片可绑定特定的 Agent Profile角色实现职能分离角色职责典型技能researcher信息调研与摘要web-search, summarizeengineer代码生成与执行code-gen, terminal-execreviewer质量审查与评审code-review, security-auditexecutor流程执行与操作terminal-exec, file-opsreporter报告生成与输出report-gen, chart-gen每个 Profile 由独立的SOUL.md定义身份特征与行为边界确保不同 AI 成员专注各自领域。三、核心功能详解3.1 看板任务编排初始化与创建# 1. 初始化看板环境hermes kanban init# 2. 创建父任务并指定拆解规则hermes kanban create\--title生成Q4多平台兼容性测试报告\--split5\--rolesresearcher,engineer,reviewer,executor,reporter# 3. 验证持久化# 检查 ~/.hermes/kanban.db 文件是否存在且包含非空 records 表任务状态流转任务创建角色分派 - 绑定 Agent Profile开始执行执行成功执行失败依赖阻塞重试阻塞解除pendingassignedrunningcompletedfailedblocked实时监控# 查看指定任务的完整执行日志流hermes kanbantail# 通过 Web UI 可视化查看看板状态3.2 代理委托Delegate并行执行主 Agent 通过动态生成子 Agent 实例在隔离终端会话中并行处理子任务# 1. 确认委托工具已注册# 检查 tools/__init__.py 中是否包含:# from .delegate_tool import DelegateTool# 2. 在 SOUL.md 中添加并行策略指令# when task_complexity 3: use delegate_tool with max_subagents4# 3. 启动带委托能力的 Agenthermes run --enable-delegate --max-delegate-workers4关键特性各子 Agent 拥有独立上下文、工具作用域与迭代预算子 Agent 间互不干扰零上下文开销支持通过 RPC 调用工具3.3 Cron 调度器将重复性高、时效性强的子任务交由内置 Cron 调度器管理# ~/.hermes/crontab.yaml-schedule:0 */2 * * *job:kanban_sync --status pending支持两种触发模式定时触发基于 Cron 表达式的时间触发条件触发基于外部事件如文件变更、Git Push、API 响应触发# 启动调度服务hermescronstart# 查看调度状态hermescronstatus# 输出: Active: true, Next fire: [timestamp]3.4 轨迹保存与回溯所有工作流执行过程以 JSONL 格式写入轨迹文件同步至 SQLite 会话数据库系统提示System Prompts用户输入User Inputs工具调用Tool Calls子 Agent 输出Sub-Agent Outputs错误堆栈Error Traces# 轨迹文件路径# ~/.hermes/trajectories/*.jsonl# 会话搜索hermes session_searchfailed at kanban_complete支持任意节点状态还原与问题复现。3.5 持久化记忆系统基于 SQLite FTS5 全文搜索配合 LLM 摘要实现跨会话持久记忆自动评估智能判断什么值得记、什么该忘主动召回适时主动回忆相关经验技能沉淀成功经验自动提炼为 Markdown 格式技能文件用户建模基于 Honcho 的辩证法用户建模深度理解用户偏好四、技术栈分析4.4 跨平台支持平台支持情况备注Linux原生支持推荐部署环境macOS原生支持Intel / Apple SiliconWindows通过 WSL2需管理员权限五、集成与生态5.1 多平台统一网关一套配置多端运行平台类型特色功能Telegram即时通讯语音备忘录转录Discord社区协作多服务器管理Slack企业集成工作流自动化WhatsApp个人助手移动端交互Signal隐私通讯端到端加密飞书 (Lark)办公协同企业级集成企业微信办公协同扫码登录Email异步通信邮件自动化CLI开发者工具全功能 TUI5.2 工具生态40 内置工具网页搜索、终端执行、文件读写、浏览器自动化、视觉识别、图像生成、语音合成、代码执行等40 内置技能涵盖 MLOps、GitHub 工作流、研究等社区技能市场支持从 ClawHub、LobeHub、GitHub 安装社区技能5.3 Web UI第三方Hermes Web UIhttps://github.com/EKKOLearnAI/hermes-web-ui提供了全功能 Web 管理面板多会话 AI 聊天管理SSE 流式对话8 大平台渠道统一配置精细化成本与用量监控可视化定时任务管理模型与文件管理六、与竞品对比七、典型应用场景7.1 多角色 AI 协同开发用户需求 - 构建用户登录系统父任务卡片 - Kanban 自动拆解researcher - UI 设计稿输出engineer - 后端 API 实现engineer - 前端组件开发reviewer - 安全审查reporter - 测试报告生成7.2 自动化运维定时巡检 异常报警 自动修复通过 Cron Kanban 编排实现无人值守7.3 研究数据处理文献检索 → 数据采集 → 清洗分析 → 报告生成多步骤长周期任务全流程可追踪7.4 项目管理AI 自动拆解需求、分派任务、追踪进度支持人工干预和断点续传八、部署指南8.1 快速安装# 一键安装Linux / macOScurl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash# 刷新 shell 配置source~/.zshrc# 或 ~/.bashrc# 初始化hermes setup8.2 硬件要求项目最低要求CPUx86_64 / ARM64内存256MB存储100MB网络稳定联网8.3 Docker 部署dockerrun-d\-v~/.hermes:/root/.hermes\-p8080:8080\nousresearch/hermes-agent:latest九、优劣势分析9.1 优势闭环学习系统经验→技能→能力提升的进化闭环越用越聪明结构化编排看板式任务管理状态可视、可追踪、可恢复角色隔离多 Profile 实现职能分离避免能力冲突持久化记忆跨会话知识沉淀SQLite FTS5 高效检索并行加速Delegate 机制支持零上下文开销的并行处理模型无关200 模型一键切换零代码变更生态丰富40 内置工具/技能社区技能市场安全加固沙箱隔离、注入扫描出厂自带MIT 协议完全自由的使用、修改和商用9.2 劣势与风险项目成熟度2026年2月才开源距今仅3个月生产环境需谨慎评估文档质量快速迭代中部分文档可能滞后于代码社区规模虽然 Star 数高但深度贡献者有限性能瓶颈SQLite 在高并发场景可能成为瓶颈模型依赖核心能力仍依赖外部 LLM API存在成本和延迟风险Kanban 可视化原生 CLI 交互Web UI 依赖第三方项目中文支持文档和社区以英文为主中文资源较少十、选型建议10.1 推荐使用场景需要 AI 多角色协同完成复杂任务需要跨会话保持任务状态和记忆需要 AI 自主学习并沉淀技能对数据隐私有要求自托管个人/团队长期使用的 AI 助手10.2 不推荐使用场景简单的问答/聊天场景过度设计对延迟极度敏感的实时交互场景对系统稳定性有极高要求的生产环境项目仍处于快速迭代期无技术能力的终端用户需要一定开发和运维能力十一、总结Hermes Kanban 是 Hermes Agent 框架中最具创新性的模块之一它将看板方法论与 AI Agent 编排深度融合通过 SQLite 持久化、角色化分派、并行执行和闭环学习实现了从一次性工具到长期数字伙伴的范式转变。项目以 MIT 协议开源社区活跃度高10万 Star技术架构先进生态丰富是目前 AI Agent 领域最值得关注的开源项目之一。但同时也需注意项目仍处于快速迭代期v0.13.0在生产环境落地前需要进行充分的稳定性测试和风险评估。建议先在非关键业务场景进行试点验证逐步积累经验后再扩大应用范围。
