面向 RAG 检索质量的桌面调试工具
连接 ChromaDB，检查·查询·对比向量检索结果，告别手搓 curl 的日子
做 RAG 应用时，ChromaDB 的检索调试体验很痛苦——想看看集合里有什么数据、测试不同 Embedding 的召回效果、对比不同 Chunk 策略的好坏，每次都得写脚本或者手搓 curl，效率极低。
Milvus 有 Attu，但 ChromaDB 一直缺一个好用的桌面 GUI。RAGPeek 就是来填这个坑的。
输入地址连接 ChromaDB（本地/远程均可），左侧列出所有集合。点击集合进入 Schema 视图，自动推断字段类型，呈现文档结构全貌。
切换到 Documents 视图，分页浏览文档数据，支持多选、查看详情、复制 JSON、批量删除。
不需要写代码，选择集合、输入查询文本，一键搜索。支持配置多个 Embedding 服务商（OpenAI、智谱、Ollama 等），只要兼容 OpenAI 的 /v1/embeddings 格式即可。
API Key 使用操作系统级加密存储（Electron safeStorage），不会明文落盘。
核心功能。选两个集合，同一个查询，并排对比 Top K 检索结果。
比如做 Chunk 实验——256 和 512 各存了一个集合，想知道哪种切分策略召回更准。以前要翻来覆去对比 JSON，现在左右一摆，高下立判。
统一管理多个 Embedding 端点配置，随时切换。
一键切换暗色/亮色主题，Ctrl + - / + / 0 缩放界面。
前往 Releases 页面下载对应平台的安装包。
| 平台 | 格式 |
|---|---|
| Windows | NSIS 安装包（.exe） |
| macOS | DMG（.dmg） |
| Linux | AppImage / Snap / deb |
git clone https://github.com/yyy-router/RAGPeek.git
cd RAGPeek
npm install
npm run dev| 层级 | 技术 |
|---|---|
| 桌面框架 | Electron 28 |
| 前端 | Vue 3 + TypeScript |
| UI 组件库 | Naive UI + Lucide Vue |
| 状态管理 | Pinia |
| 本地持久化 | better-sqlite3 |
| 安全存储 | Electron safeStorage |
| 向量数据库 | ChromaDB（HTTP API） |
| 构建工具 | electron-vite + electron-builder |
src/
├── main/ # Electron 主进程
│ ├── index.ts # 应用入口，窗口管理
│ ├── chromadb-client.ts # ChromaDB HTTP 客户端
│ ├── embedding-client.ts # Embedding API 客户端
│ ├── database.ts # SQLite 持久化 & 安全存储
│ └── ipc-handlers.ts # IPC 通道注册
├── preload/ # 预加载脚本
│ └── index.ts # contextBridge 暴露 API
└── renderer/ # Vue 3 渲染进程
└── src/
├── components/ # 视图组件
│ ├── ConnectionBar # 连接管理
│ ├── Sidebar # 集合侧栏
│ ├── CollectionPreview # 集合浏览（Schema + Documents）
│ ├── QueryPlayground # 语义搜索
│ ├── CompareView # 检索对比
│ └── EmbeddingSettings # Embedding 配置
├── stores/ # Pinia 状态管理
├── composables/ # 主题 / 缩放 / 侧栏
└── styles/ # CSS 变量主题系统
- 测试集管理（批量查询 + 指标计算）
- 检索质量评估（Recall、MRR、NDCG）
- Embedding 可视化（t-SNE / PCA 降维）
- 文档导入 / 编辑
- 多租户 / 多数据库切换
欢迎提 Issue 和 PR。项目还在持续迭代中，如果你也在用 ChromaDB，不妨给个 Star ⭐
MIT © yyy-router