Greplica icon

Greplica

Greplica 是面向 AI 编程代理的持久、可搜索工程记忆,帮助代理恢复仓库上下文、查询历史工作,并在本地或托管仓库流程中共享记忆。

Greplica

面向编程代理的持久化工程记忆

Greplica 是面向 AI 编程代理的持久、可搜索工程记忆。它旨在通过探索代码库、仓库结构和先前的会话记录,减少代理重新学习仓库上下文所花费的时间,然后在代理再次开始 grep 之前,让这些信息可被查询。

该项目支持两种运行模式。本地模式将数据完全保留在本地且没有遥测,而托管模式会将已授权的仓库连接到共享团队记忆,使不同克隆和 fork 上的贡献者可以查询同一份仓库记忆。来源还指出,Greplica 需要 Node.js 22-26,并且可以通过代理驱动的设置流程安装,而不是手动安装。

核心能力

持久化仓库记忆

探索仓库结构、代码和会话记录,以便代理在重新 grep 项目之前先查询已维护的记忆。

本地与托管运行模式

支持本地模式下的完全本地运行,以及托管模式下供贡献者共享的仓库记忆。

可搜索的上下文检索

允许代理在行动前先询问仓库上下文,包括例如在更改子系统前需要了解什么这类示例查询。

基于图的记忆检查

提供浏览器图谱视图,以可视化方式检查当前记忆和生成的关系。

基于 GitHub 的访问控制

使用 GitHub 身份验证和仓库邀请,将用户连接到托管记忆和共享访问权限。

托管记忆协调

包含托管 reconciliation 工作流,用于检查默认分支的精确代码,并为记忆更新生成有证据支撑的审计。

实际工作流

  • 在实施前恢复上下文

    当代理开始一项复杂任务,并需要在修改之前恢复仓库事实、先前决定或子系统上下文时,使用 Greplica。

  • 跨克隆和 fork 共享团队记忆

    当多个贡献者分别使用不同的克隆或 fork,但需要相同的共享仓库记忆以便协同工作时,使用托管模式。

  • 可视化审查已存储的记忆

    使用图谱视图在浏览器中检查当前记忆图,并理解代码、会话和相关上下文之间的关联。

  • 托管仓库的记忆协调

    在托管仓库中使用协调工作流,将记忆更新与默认分支的精确代码进行比较,并生成有证据支撑的审计。

Pros and Cons

Pros

  • 基于仓库结构、代码和会话记录构建持久记忆,而不是依赖每个新会话重新发现上下文。
  • 本地模式支持完全本地运行且没有遥测。
  • 托管模式可让不同克隆或 fork 上的贡献者共享团队记忆。
  • 在进行更改之前,提供可查询的上下文和图谱视图来检查已存储的记忆。
  • 记录了将记忆与默认分支精确代码进行协调的托管工作流。

Cons

  • 在可用来源中,文档不完整,因此此处未能完全说明部分设置和工作流程细节。
  • 托管模式依赖于访问托管的 Greplica 服务器,以及管理员授予的仓库或组织访问权限。
  • 来源没有提供 Greplica 本身的定价信息。

FAQ

如何安装 Greplica?

Greplica 安装到仓库中后即可使用本地模式或托管模式。来源说明,大多数用户应当先在他们希望 Greplica 记住的仓库内,将安装提示粘贴到自己的编程代理中。

Greplica 是本地运行,还是需要托管服务?

本地模式保持完全本地运行,并使用 SQLite 绑定仓库、角色缓存、钩子策略和运行时会话元数据。来源说明,本地模式没有遥测。

托管模式用于什么?

托管模式允许来自不同克隆和 fork 的贡献者查询同一份仓库记忆。它要求 Greplica 0.2.0 或更高版本、可访问托管的 Greplica 服务器,以及已由管理员邀请的 GitHub 用户。

有哪些安装要求?

README 说明 Greplica 需要 Node.js 22-26。包元数据列出的受支持引擎范围为 Node 22.x 到 27.x 以下。

Greplica 支持哪些代理或平台?

来源提到了浏览器图谱视图命令、用于仓库上下文的查询示例,以及托管记忆邀请链接,但除包括 Codex 在内的示例外,并未提供完整的受支持代理平台列表。

Quick Facts

类别
开发工具
来源域名
github.com
主要用户
AI 编程代理及其使用者
部署模式
本地,托管
运行时要求
Node.js 22-26
许可证
MIT