Hermes Agent网页控制台密码遗忘时，可依次检查认证配置、重置.env凭证、清空auth.db数据库、临时禁用auth模块或执行full cleanup重建；各方法按优先级递进，确保安全与可用性兼顾。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试登录 Hermes Agent 的网页控制台（Dashboard），但输入的密码不正确且无法回忆，可能是由于配置文件中未启用账户认证或密码已被覆盖。以下是解决此问题的步骤：
一、检查是否启用本地账户认证
Hermes Agent 默认启动 Dashboard 时不强制启用用户名/密码登录，仅在显式配置了 auth 模块后才启用账户系统。若此前未执行 hermes setup 并开启身份验证，则访问 http://127.0.0.1:9119 实际无需密码。
1、在终端中执行 hermes config show 命令查看当前配置。
2、查找 auth: 区块是否存在，以及其下 enabled: 是否为 true。
3、若该值为 false 或整个区块缺失，则 Dashboard 当前无密码保护，直接访问即可使用。
二、重置 .env 文件中的管理员凭证
当已启用 auth 模块且使用内置 SQLite 认证时，管理员账号密码存储于项目根目录下的 .env 文件中，可通过手动编辑重置。
1、进入 Hermes Agent 安装目录（通常为 ~/hermes-agent 或执行 which hermes 后向上追溯）。
2、使用文本编辑器打开 .env 文件，查找以 ADMIN_USERNAME= 和 ADMIN_PASSWORD_HASH= 开头的两行。
3、将 ADMIN_USERNAME 的值修改为期望的新用户名（如 admin）。
4、将 ADMIN_PASSWORD_HASH 的值替换为新密码的 bcrypt 哈希值（可使用在线工具如 https://bcrypt-generator.com 生成，成本因子设为 12）。
5、保存文件后，在终端中执行 hermes restart 使更改生效。
三、通过 CLI 强制重置认证数据库
若 .env 中的哈希值损坏或无法解码，可清空内置 SQLite 认证库并重建管理员账户。
1、确认 Hermes Agent 正在运行，执行 hermes status 查看服务状态。
2、停止服务：运行 hermes stop。
3、定位认证数据库路径，通常为 ~/.hermes/data/auth.db。
4、执行命令删除该文件：rm ~/.hermes/data/auth.db。
5、重新启动服务：hermes start。
6、首次访问 Dashboard 时，系统将提示创建新管理员账户，按页面引导完成设置。
四、使用 config.yaml 禁用认证临时绕过
若需紧急访问 Dashboard 查看日志或调试，可临时关闭认证模块，待操作完成后恢复。
1、打开 config.yaml 文件（位于 Hermes Agent 安装目录或 ~/.hermes/config.yaml）。
2、找到 dashboard: 下的 auth: 子项。
3、将 enabled: 的值改为 false。
4、保存文件并执行 hermes reload 重载配置。
5、刷新浏览器页面，此时无需输入任何凭据即可进入 Dashboard。
五、恢复出厂默认配置并重建
当上述方法均不可行，且确认配置文件已严重错乱时，可彻底清除用户配置并重新初始化。
1、执行 hermes cleanup --full 清理所有用户数据与缓存（注意：此操作不可逆）。
2、确认清理完成，终端输出包含 All user data removed successfully 提示。
3、运行 hermes setup --quick 启动快速配置向导。
4、在向导中选择是否启用 Dashboard 认证，如启用则按提示设定新用户名与密码。
5、完成向导后，执行 hermes dashboard 启动并验证登录。
