概述
hermes debug 提供 Hermes Agent 的诊断工具。你可以用它上传包含系统信息和近期日志的调试报告到粘贴服务并获取可分享链接,或删除之前上传的报告。
hermes debug {share,delete} ...
子命令
share — 上传调试报告
hermes debug share
上传包含系统信息和近期日志的调试报告到粘贴服务,并输出可分享的 URL。除非提供 --yes,否则会要求确认。
选项
| 选项 | 说明 |
|---|---|
-y, --yes |
跳过确认提示并立即上传。在非交互式环境(脚本/CI)中是必需的;如果 stdin 不是 TTY,不提供此选项时命令会直接拒绝,而不是静默上传。 |
--lines LINES |
每个日志文件包含的行数。默认为 200。 |
--expire EXPIRE |
粘贴有效期(天)。默认为 7。 |
--local |
仅在本地打印报告,不上传。 |
--no-redact |
禁用上传时的密钥脱敏。默认情况下,日志在上传前会经过 agent.redact.redact_sensitive_text(force=True),避免凭据泄漏到公共粘贴服务。 |
--nous |
将调试包上传到 Nous 内部私有存储(AWS S3),而非公共粘贴服务。仅 Nous 员工和允许名单中的 Discord 管理员可查看,14 天后自动删除。除非同时传入 --no-redact,否则仍会强制脱敏。 |
delete — 删除已上传的报告
hermes debug delete <url>
删除之前通过 hermes debug share 上传的粘贴。
常见场景
与支持团队分享报告
hermes debug share
交互式上传;确认提示后生成分享链接。
在 CI 中非交互上传
hermes debug share --yes
使用 --yes 防止脚本中等待输入而挂起。
包含更多日志上下文
hermes debug share --lines 500
排查跨越多行日志的问题时很有用。
向 Nous 员工私有上传
hermes debug share --nous --yes
上传到 Nous 内部存储,而不是公共粘贴服务。
本地查看报告
hermes debug share --local
在终端中打印完整调试报告,不上传。
删除旧报告
hermes debug delete https://paste.example.com/abc123
提示
- 默认脱敏会移除日志中类似凭据的字符串。只有在你明确需要原始值并了解风险时才使用
--no-redact。 - 与 Hermes 团队分享敏感环境时,
--nous是最安全的选择。 - 自动化上传时,优先使用
--yes而不是重定向 stdin。