Hermes WebUI 数据库集成实操4 步把外部数据源接到 AI 身边【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webuiHermes WebUI 是运行在浏览器里的 Hermes Agent 管理界面它的数据库集成能力让会话数据、看板任务、用量统计和文件资料都能被 AI 直接读写外部数据源连接无需额外部署中间件。本文按「真实场景 → 选对路径 → 最小配置跑通 → 避坑」的顺序带你把这三类数据接进工作流。想让数据“长在 AI 旁边”先看这 3 个典型场景大多数人在用 Hermes 时会遇到三个反复出现的需求它们对应仓库里已经建好的三条数据通道不需要自己写数据库驱动。场景一在浏览器里盯 Kanban 任务进度Hermes Agent 的任务看板triage / todo / ready / running / blocked / done 六列由 Agent 端的看板数据库统一管理WebUI 通过 Kanban 桥接模块api/kanban_bridge.py 暴露/api/kanban/*全套读写接口并附带 SSE 实时事件流。你在网页上改状态、建任务和 Agent 命令行操作的是同一份数据刷新即见不存在“网页一套、本地另一套”的同步问题。场景二看清模型用量和花费趋势Insights 面板回答的是运营类问题最近 30 天跑了多少会话、多少消息、多少 token各模型各花了多少钱。这些数据由后端从会话索引与state.db中聚合后经/api/insights接口输出见 API 路由api/routes.py前端只负责画图口径不会漂移。场景三把本地工作区文件变成 AI 的上下文WebUI 右侧的工作区面板可以直接浏览、预览、搜索项目文件。AI 在处理任务时读取的就是这个文件系统里的内容相当于一个“文件型数据源”CSV 报表、日志、文档丢进工作区就能在对话里引用不需要导入到任何数据库。30 秒选对你的数据源连接方式 四条通道的定位不同按用途选就好不必全配数据源通道适合场景是否需要配置看板任务/api/kanban/* SSE 事件流多端协作、任务状态追踪否随 Agent 自动生效用量与成本/api/insights聚合接口运营统计、成本复盘否面板直接打开本地文件工作区文件面板文档、CSV、日志供 AI 引用指定默认工作区目录即可其他 AI/工具MCP 服务器stdio让外部 Agent 读写 WebUI 的会话与项目需注册一段配置见下节前两条开箱即用文件通道靠设置默认工作区只有当“别的程序需要访问 WebUI 数据”时才用 MCP 这条链路。4 步配置从克隆到连通 第 1 步获取仓库git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui第 2 步启动服务。仓库自带bootstrap.py创建虚拟环境并安装依赖和start.sh/ctl.sh启动与管控按 README 的 Quick Start 执行即可默认监听127.0.0.1:8787。第 3 步验证三条内置通道。打开浏览器后左侧栏进入 Kanban 面板确认可看到任务列表Settings 区域的 Insights 确认可看到用量图右侧工作区面板确认能列出你的默认工作区默认解析顺序见 README 的 Configuration 表HERMES_WEBUI_DEFAULT_WORKSPACE环境变量 →~/workspace→ 状态目录。状态文件本身落在$HERMES_HOME/webuiPOSIX 默认~/.hermes/webui可用HERMES_WEBUI_STATE_DIR指到备份盘。第 4 步可选注册 MCP 工具供外部 Agent 使用。仓库根目录的 MCP 服务器入口mcp_server.py 把项目与会话管理暴露为 MCP 工具安装mcp包后在 Hermes 的config.yaml中注册mcp_servers: hermes-webui: command: /path/to/venv/bin/python3 args: [/path/to/hermes-webui/mcp_server.py] env: HERMES_WEBUI_PASSWORD: your_password注册完成后支持 MCP 的 Agent 就能通过 stdio 直接调用 WebUI 的会话与项目管理能力。排障与安全要点 更新 WebUI 后 Kanban 偶尔会出现下图这种“需要硬刷新”的提示页说明浏览器还缓存着旧版前端资源——按提示点 Hard refresh 即可这不是数据库故障常见问题按「现象 → 可能原因 → 处理方式」速查现象可能原因处理方式Kanban 面板提示 hard refresh浏览器缓存了旧版前端 bundle点击 Hard refresh now或 CtrlShiftR 强刷看板任务查不到指定了不存在的 board slug去掉?board参数用默认看板或先创建该看板Insights 数字为 0状态目录指错位置会话数据不在预期路径核对HERMES_HOME/HERMES_WEBUI_STATE_DIR确认与实际 Agent 数据一致MCP 注册后外部 Agent 连不上密码或端口环境变量与实际启动参数不一致核对HERMES_WEBUI_PASSWORD、HERMES_WEBUI_PORT与 WebUI 实际监听保持一致远程访问被拒服务默认只绑127.0.0.1走 SSH 隧道或 Tailscale 暴露不要把 8787 直接挂公网安全上把握三点即可敏感口令用环境变量而不是写进文件状态目录里存放的是你的全部会话历史备份与共享时按私密数据对待对外暴露一律经由 SSH 隧道并给 WebUI 设置密码或 Passkey 认证。跑通以上步骤后建议先只用看板 Insights 观察一两天数据是否符合预期再逐步接入工作区文件与 MCP 外部调用最后把HERMES_WEBUI_STATE_DIR纳入你的定期备份范围。【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
