Hermes WebUI环境变量审批状态：ADR-007实现机制

Hermes WebUI环境变量审批状态：ADR-007实现机制

【免费下载链接】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

Hermes WebUI是一款功能强大的Web界面工具，专为高效使用Hermes Agent而设计。在其架构中，ADR-007关于通过环境变量实现审批状态的机制是确保系统安全与稳定运行的关键环节。

什么是ADR-007？

ADR-007全称为“Approval State via Environment Variables”，即通过环境变量实现审批状态。这一决策主要围绕着HERMES_EXEC_ASK和HERMES_SESSION_KEY这两个环境变量展开，它们在tools/approval.py和terminal_tool.py中被读取，用于控制和管理审批流程。

ADR-007的核心实现

环境变量的设置与传递

在Hermes WebUI中，HERMES_EXEC_ASK和HERMES_SESSION_KEY这两个环境变量的设置和传递是ADR-007实现的核心。从项目源码中可以看到，在api/routes.py文件里，有如下代码对这两个环境变量进行操作：

old_exec_ask = os.environ.get("HERMES_EXEC_ASK") old_session_key = os.environ.get("HERMES_SESSION_KEY") os.environ["HERMES_EXEC_ASK"] = "1" os.environ["HERMES_SESSION_KEY"] = s.session_id

这部分代码的作用是先保存当前环境变量的值，然后将HERMES_EXEC_ASK设置为“1”，表示需要进行审批询问，同时将HERMES_SESSION_KEY设置为当前会话的ID，以确保审批状态与特定会话相关联。

在api/streaming.py文件中，也有类似的设置：

'HERMES_EXEC_ASK': '1', 'HERMES_SESSION_KEY': session_id,

环境变量的恢复

为了避免不同会话之间的相互干扰，在操作完成后，系统会恢复之前保存的环境变量值。同样在api/routes.py中有相应代码：

os.environ.pop("HERMES_EXEC_ASK", None) os.environ["HERMES_EXEC_ASK"] = old_exec_ask os.environ.pop("HERMES_SESSION_KEY", None) os.environ["HERMES_SESSION_KEY"] = old_session_key

这样的处理方式保证了环境变量在不同会话之间的独立性，减少了潜在的冲突。

ADR-007的权衡与解决方案

存在的权衡问题

ADR-007采用环境变量来传递审批状态，这种方式的一个主要权衡是环境变量是进程全局的。这意味着当有两个并发的聊天请求时，可能会出现相互干扰的情况，即一个请求的环境变量设置可能会覆盖另一个请求的设置。

解决方案

针对上述问题，ADR-007提出了在Phase B阶段进行改进的方案，计划用线程局部存储或显式参数传递来替代当前的环境变量方式。线程局部存储可以为每个线程提供独立的存储空间，从而避免不同线程之间的环境变量冲突；显式参数传递则可以更直接地将审批状态与特定的请求或操作关联起来，提高系统的稳定性和可靠性。

ADR-007在实际测试中的验证

在项目的测试文件tests/test_profile_terminal_env.py中，对ADR-007的相关机制进行了验证。测试代码中设置了初始的环境变量值：

"HERMES_EXEC_ASK": "0", "HERMES_SESSION_KEY": "old-session",

然后在测试过程中检查环境变量是否被正确更新：

assert env["HERMES_EXEC_ASK"] == "1" assert env["HERMES_SESSION_KEY"] == "active-session"

通过这样的测试，确保了环境变量在审批流程中的正确设置和传递，验证了ADR-007实现机制的有效性。

总结

ADR-007通过环境变量实现审批状态的机制，在Hermes WebUI的当前版本中发挥着重要作用。虽然存在进程全局环境变量可能导致并发请求冲突的权衡问题，但通过在Phase B阶段计划采用的线程局部存储或显式参数传递方案，有望进一步优化这一机制。了解ADR-007的实现机制，有助于开发者更好地理解Hermes WebUI的内部工作原理，为系统的扩展和维护提供有力支持。如果你想深入研究ADR-007的更多细节，可以查看项目中的ARCHITECTURE.md文档。

【免费下载链接】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