aieph

aieph

你的修复，惠及每个人

aieph 是面向 AI 编码助手的共享答案缓存。

当 AI 编码助手准备搜索网页时，一个小钩子可以悄悄询问：“有人已经找到答案了吗？”

如果共享缓存中已有答案，aieph 可以立即返回答案，避免再次搜索网页。如果没有答案，aieph 就会悄然退到一旁。

未命中、超时或出错？一切照常。原始请求会继续正常处理。这就是全部理念。

你的修复，可以惠及每个人。

为什么需要共享缓存？

AI 编码助手经常会查找相似的信息：

• 常见的错误消息
• 某个库的行为
• 配置细节
• 别人已经找到的解决方案

第一个人去搜索，后来的人不一定需要再搜。aieph 为这些答案提供共享空间；随着使用人数增加，缓存也会逐渐变得更有用。

目前还处于早期阶段，因此不保证一定能命中缓存。有时 aieph 还没有答案——这完全没问题。

使用体验

AI assistant
     │
     │  "I'm about to search..."
     ▼
   aieph
     │
     ├── HIT  → answer is already here
     │
     └── MISS / timeout / error
              │
              ▼
          original search

aieph 的设计宗旨是尽量不打扰你。当缓存中没有有用的信息时，你无需改变工作方式。

开始使用 Claude Code

Claude Code 可以通过一个用于 WebSearch 和 WebFetch 的 PreToolUse 钩子来使用 aieph。简单的配置如下：

git clone https://github.com/tryaieph/aieph.git

然后，在 ~/.claude/settings.json 中，相关钩子可以这样配置：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "WebSearch|WebFetch",
        "hooks": [
          {
            "type": "command",
            "command": "node /path/to/aieph/hook/aieph-cache.mjs"
          }
        ]
      }
    ]
  }
}

就这么简单。

要求：Node.js 18+。无需账号或 API 密钥。

可选环境变量：

AIEPH_API_BASE
LOOKUP_TIMEOUT_MS

正在准备支持 Cursor。

移除 aieph

如果 aieph 不再适合你，只需移除 PreToolUse 配置块，即可恢复原来的设置。

会发送哪些内容？

aieph 刻意保持简单透明。匹配时只会发送搜索查询文本，不会发送其他任何内容。你无需创建账号，也无需维护个人资料。如果没有匹配的答案，请求会照常继续处理。

本地共享记忆

aieph 还包含一个仅在本地使用的小型记忆 CLI，位于 cli/。它与共享答案缓存相互独立。理念很简单：只需记录一次事实，连接的助手之后就能记住它。这些记忆会完全保留在本地。

尚处早期，期待保持务实

aieph 仍在不断发展。共享缓存还很新，因此经常会遇到缓存中尚无答案的情况。这是有意为之：aieph 无需完美也能发挥作用。未命中的体验应该和完全没有缓存时一模一样。

随着时间推移，每个有人发现的实用答案，都有可能帮助到下一个人。

你的修复，惠及每个人。

许可证

MIT