Research Report · 自定义 Web UI

核心特性

强大的功能组合，为研究报告生成提供完整的解决方案

SSE 实时进度

Agent 工具调用、diff、思考过程实时推送，带图标分类（🔧 工具 / 📝 diff / 💬 文本）

Markdown 渲染

最终报告自动渲染，含表格、代码块、列表等丰富格式支持

PDF 链接识别

Agent 返回的本地 PDF 路径自动变成可点击卡片，方便查看生成结果

免审批模式

subprocess 用 --yolo，生成 PDF 的 shell 命令全程自动执行，无需人工批准

任务历史记录

左侧栏列出最近 30 个任务（存本地），点击可查看摘要，方便回顾

设置持久化

配置优先存 localStorage；不可用时回退到内存，确保设置不丢失

工作流程

简单三步，即可开始使用强大的研究报告生成功能

1

启动后端服务

运行 server.py，在端口 8649 启动独立 Python 服务，配置好 Hermes Agent profile

~/.hermes/hermes-agent/venv/bin/python3 server.py

2

浏览器访问

直接打开浏览器访问服务地址，服务自带同源静态文件服务，无 CORS 问题

http://127.0.0.1:8649

3

开始使用

在输入框中填写研究主题，例如「人形机器人行业研究报告」，按 Enter 发送

实时查看 Agent 进度 + 最终报告

系统架构

浏览器 (index.html)

EventSource 接 SSE 流

server.py (Python 服务)

subprocess 调用 hermes chat

Hermes Agent

7 阶段工作流（采集→打分→PDF）

常见问题

关于使用和技术的常见疑问解答

什么是进度流式体验？

本方案是进度流式（不是 token 流式）：实时可见 Agent 每次工具调用（搜索、读文件、写文件、生成 PDF），diff 预览功能让你看到文件修改内容。不过最终回复是一次性出现的，因为 Hermes CLI 内核不暴露 token 级流式。

如何自定义默认 profile？

可以通过两种方式修改：编辑 index.html 的 defaultCfg.profile，或者在运行时通过 ⚙️ 设置面板修改。支持使用任何已安装的 Hermes profile，如 default、hermes-research-report-agent 等。

已知限制有哪些？

需先启动 server.py：服务常驻运行，浏览器才能访问
任务历史是摘要式：本地只存「查询 + 回复前 100 字预览」
文件上传不支持：如需 Agent 处理本地文件，把文件路径写进 prompt
并发限制：每个任务启动一个 hermes 子进程，同时跑多个长任务会消耗较多资源

如何修改配色主题？

编辑 index.html :root 里的 CSS 变量来修改配色。主要颜色变量包括 --primary-color、--secondary-color 等。也可以在 Tailwind config 中自定义 brand 色系。

如何自定义 Hermes 命令参数？

编辑 server.py 的 run_hermes 函数里的 cmd 列表，可以添加 --max-turns、修改 model 等参数。比如加 --max-turns 10 来限制对话轮次，或 --model gpt-4 来更换模型。

开始使用 Research Report Web UI

强大的 Hermes Agent 集成，实时进度流式推送，让研究报告生成更加直观高效

GitHub 仓库查看文档

Research Report 自定义 Web UI