hermes-memory-pgvector 1.0.2 已发布,针对代码以及人们从 PyPI 安装的文件都强化了检查。实时数据库测试套件通过了 789 项测试,没有跳过任何测试。运行时包中的每条可执行语句均已覆盖,且两个已发布的归档文件现在都带有可验证的来源信息。
本文承接我们的 1.0 发布文章,该文章介绍了这个项目的稳定公共接口。版本 1.0.2 保持该接口和数据库架构不变,同时进一步收紧变更进入发布的流程。
协作型代理的共享内存
该插件为 Nous Research 的 hermes-agent 提供 PostgreSQL 和 pgvector 存储层。代理仍然使用内置的内存工具。该提供商镜像这些写入操作,并存储对话中具有实质内容的轮次,以便进行语义召回。
除非明确请求跨主题召回,否则内存始终限定在当前代理的主题范围内。在内存热路径中,嵌入计算无需使用 LLM;写入操作会进入队列,因此代理线程无需等待嵌入计算或数据库操作完成。
设有强制性下限的测试覆盖率
新增测试涵盖存储操作与竞态、身份隔离、召回、命令行维护、HTTP 错误、写入器关闭,以及宿主集成边界处的故障。
实测结果如下:
- 实时测试套件中 789 项测试通过,跳过的测试为零。
- 全部 6 个运行时模块的语句覆盖率达到 100%。
- 分支覆盖率为 99.66%,或语句与分支综合覆盖率为 99.92%。
- 实时 CI 中实行强制的 99.5% 综合覆盖率下限。
报告仍会显示两个分支结果。一个分支需要重试循环执行零次迭代,尽管它始终至少尝试一次。另一个分支需要生成的委派文本为空或为噪声,尽管它始终包含固定的委派前缀。为了提高覆盖率,没有排除任何运行时代码。
覆盖率只能记录测试执行过的路径;它不能证明程序没有错误。测试需要包含有意义的断言和符合实际的失败情形。测试套件针对 PostgreSQL 16、17 和 18 运行,同时包含 Python 3.11、3.12 和 3.13 单元测试,以及固定版本的上游一致性检查。
现在,两项故障被控制在提供商内部
测试发现了两个异常可能逸出到代理循环中的位置:初始化期间构建数据库存储,以及通过后台写入器调度内存写入。
版本 1.0.2 会捕获并记录这两种异常。存储构建失败时,提供商将保持不可用;入队失败时,写入钩子会降级。这两条路径都不会给代理线程增加同步嵌入计算或数据库操作。
现在,Ruff 规则、本地提交钩子、受保护主分支检查,以及版本和配置检查会在变更发布前执行相同的校验要求。
追踪您安装的软件包
PyPI 上的 wheel 文件和源代码归档文件均带有通过 Trusted Publishing 创建的发布证明。GitHub 也记录了这两个文件的构建来源信息。发布工作流会在上传归档文件之前,将其内容与源代码检出结果进行核对。
我们已将两个 PyPI 发布证明与该存储库进行核验,并确认 PyPI 文件的哈希值与 GitHub 发布资产中的哈希值相同。
来源信息让读者能够核实文件来自何处。它是对代码审查和测试的补充;它不能认证代码一定正确。
升级到 1.0.2
在运行您的代理的 Python 环境中:
python -m pip install --upgrade hermes-memory-pgvector==1.0.2
然后重启加载该提供商的 Hermes 进程,并检查 hermes memory status。从 1.0.1 到 1.0.2 没有新增迁移或架构变更。对于全新安装或较旧版本的部署,请遵循该存储库的安装和升级说明。
该项目依据 BSD-3-Clause 许可证开源,版权归 Green Yoga Inc. 所有。
