Yep Mem

是的

AI编码代理的持久内存。每一次会议，每一个符号——都是可搜索的。

建立在 全部 对于会话捕获， 兰斯数据库 对于矢量搜索， 主控程序 用于代理集成。

  you code with an agent
           ↓
  Entire captures the session as a Git checkpoint
           ↓
  post-commit hook triggers yep sync
           ↓
  transcripts → summaries → embeddings → vector store
  code files → symbols → embeddings → code index
           ↓
  next task: agent calls search_all via MCP
           ↓
  relevant sessions + code → agent context

快速开始

bunx yep-mem enable

npx yep-mem enable        # npm
pnpm dlx yep-mem enable   # pnpm

这可以完成所有操作：创建向量存储，启用Entire，设置提交后挂钩，在Cursor中注册MCP服务器，安装代理规则，为现有检查点和代码符号建立索引。在此之后，内存会自动工作。

提供商

开放人工智能 （默认）--需要 OPENAI_API_KEY （env， .yep-mem/config.json，或 .cursor/mcp.json).

奥拉玛 （本地，免费）-无API密钥，完全脱机：

ollama pull nomic-embed-text && ollama pull llama3.1:8b
YEP_PROVIDER=ollama bunx yep-mem enable

OpenAI Ollama。 |---|---|---| |嵌入| text-embedding-3-small （1536d）| nomic-embed-text （768天）| |摘要生成器| gpt-4o-mini | llama3.1:8b | |API密钥|必需|否|

命令

自动代码索引

代码索引是全自动的——你永远不需要手动运行它：

• yep sync 同步会话后的索引代码（提交后挂钩）
• yep enable 在安装过程中运行初始代码索引
• yep gui 过时时在后台重新索引

支持TypeScript、JavaScript、Python、Go、Rust。使用 TypeScript编译器API 用于TS/JS/TSX/JSX文件（精确的AST解析），并为其他语言提供正则表达式回退。使用调用图和导入跟踪提取函数、类、接口、类型、React组件。增量-仅重新索引自上次提交以来更改的文件。

桌面应用程序

一个基于以下内容构建的原生桌面应用程序 金牛座2:

cd apps/desktop
bun run tauri:dev     # development
bun run tauri:build   # production build

带有搜索、代码浏览器、同步、文件时间线、设置和 代码洞察 --死码检测、最连通符号、复杂性热点、语言/类型分布。

Web图形用户界面

yep gui              # opens http://localhost:3838
yep gui --port 4000  # custom port

与桌面应用程序相同的界面，直接从CLI提供。

MCP工具

Cursor（或任何MCP客户端）中的代理会自动获得这些工具：

资源： memory://summary, memory://symbols, memory://files, memory://recent

提示： pre_task （工作前搜索）， pre_commit （提交前检查爆炸半径）

代理规则安装在 .cursor/rules/yep-memory.mdc --代理在执行任务之前自动搜索内存，在编辑之前检查符号上下文，在提交之前检测更改。

运作原理

会话索引 --解析整个检查点→ 使用差异将块分为提示/响应对→ LLM总结→ 嵌入→ 位于LanceDB的商店。通过内容哈希跟踪本地会话（更新，不重复）。同步由基于文件的锁保护，以防止并发损坏。

代码索引 --漫游项目文件→ 适用于TS/JS的TypeScript编译器API（适用于Python/Go/Rust的regex回退）→ 使用调用/导入图进行符号提取→ 嵌入→ 单独存放 code_symbols 桌子。按git commit递增。

检索 --嵌入查询→ 矢量+全文并行搜索→ 互逆排序融合→ 重新排序（最近度、文件重叠、关键字密度、符号匹配）→ 去重（余弦>0.95）→ 前K结果。

错误处理 -具有级别和模块上下文的结构化日志记录、用于嵌入API重试的抖动指数退避、可重试错误检测（速率限制、超时、5xx）。

建筑

yep/
├── apps/
│   ├── desktop/          Tauri 2 desktop app (React 19, TailwindCSS, TanStack Query)
│   ├── tui/              CLI + MCP server + HTTP API (Bun, Hono, LanceDB)
│   └── server/           AI inference server (Hono, Gemini)
├── packages/
│   ├── config/           Shared TypeScript configuration
│   ├── db/               Prisma client (libSQL/Turso)
│   └── env/              Environment variable validation (Zod)
└── .github/
    └── workflows/        CI (lint, types, test, build) + Release (npm + Tauri)

.yep-mem/
├── vectors/         LanceDB (solutions + code_symbols tables)
├── cache/           Embedding + search result caches
├── eval/            Golden question set for quality eval
├── sync.lock        File lock for sync atomicity
└── config.json      Provider, models, sync state

构建于

兰斯数据库 · AI SDK · 全部 · 奥拉玛 · 主控程序 · 涛瑞 · TanStack查询 · 包子 · 涡轮仓库

______________________________________________________________________

Development

bun install
bun run dev           # all apps
bun run build         # build everything
bun run test          # run all tests
bun run build:gui     # build GUI assets into apps/tui/gui-dist
bun run check         # lint (Biome via Ultracite)
bun run fix           # auto-fix lint issues

测试

bun run test                        # all tests via Turborepo
cd apps/tui && bun test src/        # TUI tests only

67个单元测试，涵盖核心模块：代码分块器、分块器，缓存，存储工具，文件锁定。

释放

通过GitHub Actions自动发布：

1. 标记版本： git tag v0.2.0 && git push --tags
2. CI发布 yep-mem 到npm
3. CI为macOS（arm64+x64）、Linux、Windows构建Tauri桌面二进制文件
4. GitHub发布草案已创建，并附有二进制文件

桌面应用程序包括通过Tauri更新器插件的自动更新支持。

代码质量

• 生物群系 + 超岩矿 用于裁剪和格式化
• 左撇子 预提交挂钩
• 严格的TypeScript (strictNullChecks, noUncheckedIndexedAccess)
• 依赖机器人 用于自动更新依赖关系

高级功能

图依赖关系和PageRank --带有PageRank的代码符号依赖图，用于流行度评分。用于搜索排名，以提升常用符号。

Git元数据 --自动提取每个符号的更改计数、作者计数和上次更改日期。用于漏洞风险评分和新鲜度排名。

指标快照 --代码质量指标的自动每日快照（健康评分0-100、复杂性、文档覆盖率、死代码）。查看趋势 yep trends.

Bug风险评分 --基于6个因素的预测分析：复杂性（25%）、更改频率（20%）、作者流失（15%）、行数（15%），测试覆盖率（15%）和文档（10%）。在错误发生之前识别高风险符号。

共同变化分析 --从git历史中检测时间耦合。识别经常一起更改的文件（支持+置信度指标）。用于代码审查和重构决策。

模式检测 --基于启发式的架构模式（Singleton、Factory、Observer、Builder）和React模式（HOC、自定义挂钩、渲染道具）检测。还可以检测反模式（幻数、长参数列表、深嵌套）。

多信号排名 --7个信号搜索排名：向量相似性（35%）、FTS（20%）、精确匹配（15%）、流行度（15%），新鲜度（5%）、复杂性（5%），上下文（5%）。在所有搜索中自动集成。

看 docs/advanced-features.md 和 docs/api-reference.md 了解详情。