用途
cachly 为编程 AI 助手提供持久记忆，解决同一问题重复出现时 AI 无法记住过往经验的问题。它通过 MCP 协议连接编辑器与 AI 助手，存储修复方案、技术决策和失败教训，在需要时自动召回。
主要能力
- 课程存储：每个修复、决策或死胡同存储为课程，包含主题、有效做法、无效做法、严重程度、文件路径、命令和作者。
- 会话简报：会话开始时，AI 收到包含上次会话、未解决失败和近期课程的简报。
- 智能召回：smart_recall 结合 BM25 关键词搜索、基于语义的搜索和因果图，支持 11 种语言。
- 因果追踪：causal_trace 从错误症状出发，沿因果知识图找到根因、中间原因和有效修复。
- 失败预测：brain_predict 在部署前列出过往事件中的失败模式。
- 团队共享：团队可共享 Brain，课程携带学习者的名字。
- CI 集成：通过 Git 钩子和 CI 模板从提交和红绿转换中学习。
- 124 个 MCP 工具：默认列出 27 个（26 个日常工具 + 调度器 cachly_tool），其余 98 个通过调度器调用。
使用方式
- 无需账户即可开始：无密钥时，会话开始时自动在欧盟服务器创建测试 Brain，提供 14 天 Dev 层体验。
- 自动配置：运行
npx @cachly-dev/mcp-server@latest autopilot可检测并配置常用编辑器，添加 Git 钩子从提交中学习，并通过浏览器设备码登录。 - 手动添加：可手动配置 MCP 服务器，无密钥时首次工具调用创建测试 Brain。
- VS Code 扩展：安装 cachly Brain 扩展，首次启动即创建 Brain。
- JetBrains 插件：从 JetBrains Marketplace 安装，支持 IntelliJ IDEA、PyCharm、GoLand、WebStorm、Rider。
- 演示：运行
npx @cachly-dev/mcp-server@latest demo可在项目文件夹中读取 Git 历史，打印修复、模式和决策，数据不离开本机。 - 数据导出：
npx @cachly-dev/mcp-server@latest export将所有课程导出为 lessons.md 和 lessons.jsonl。 - 环境变量：CACHLY_ALLE_WERKZEUGE=1 列出全部 124 个工具；CACHLY_PROFILE=lean 列出 8 个加 cachly_tool；CACHLY_PROFILE=recall 列出 3 个只读工具。
适用场景
- 个人开发者：避免重复解决同一问题，积累个人经验库。
- 团队协作：共享团队经验，新成员可复用已有知识。
- CI/CD 流程：从每次 CI 运行中学习，红转绿即已验证的修复，绿转红即已知原因。
- 自我托管：可指向私有后端，支持自带嵌入计算。
限制
- 默认嵌入计算在 cachly 的欧盟服务器上进行；仅在用户指定第三方提供商时文本才会发送给第三方。
- API 流量经过 Cloudflare（美国公司）。
- 代码片段仅在用户主动调用 index_project 时存储，且仅存储在用户自己的欧盟实例上，默认每个索引文件存储最多 1200 字符的摘要。
- 其他工具存储课程文本、提交消息、会话摘要和键值上下文，不存储源代码。
- 免费层有单 Brain 限制。
- 当前价格和限制详见 cachly.dev/pricing。
