OmniClip RAG

Caelune 的功能

Caelune 会根据你保存在自己电脑上的知识建立可搜索索引。它结合了精确文本检索、结构信号、语义向量搜索、可选的重排序，以及感知来源的上下文组装。

桌面应用可管理数据根目录、Runtime 组件、模型、知识库构建、实时监控、查询和结果审阅。可选的 MCP 服务通过两个只读工具，将相同的检索核心提供给支持 MCP 的 AI 客户端。

选择你的使用路径

我想要……	从这里开始
安装 Windows 应用并构建第一个索引	入门指南
了解 Runtime、模型、CPU、CUDA 或资源提示	Runtime 和模型
编辑笔记后保持索引更新	知识库和实时监控
通过 MCP 连接 AI 客户端	MCP 集成
安全地诊断问题	故障排查

界面预览

Query Console 将输入、范围、检索设置和实时查询状态集中在一起。Results and Details 使用独立页面显示标注来源的命中结果、片段审阅、完整上下文选择和页面筛选。

## 下载

打开最新版本，选择适合你使用场景的安装包：

安装包标签	用途
WIN-EXE	常规 Windows 桌面使用：配置、构建、监视、搜索和查看结果
MCP-...-win64.zip	为 MCP 客户端手动配置 stdio
.mcpb	用于 MCP Registry 或支持 MCPB 的客户端

MCP 安装包不会构建或修改知识库。请先使用 Windows 桌面应用构建索引。

亮点

• 本地优先存储 — 索引、配置、模型、日志和 Runtime 负载都保存在当前本地数据根目录下。
• 支持 Markdown 和 Logseq — 可处理 Markdown 内容，以及常见的 Logseq 属性、块引用和嵌入内容。
• 混合检索 — 结合 SQLite FTS5、结构感知评分、LanceDB 向量搜索、BAAI/bge-m3 和可选的 BAAI/bge-reranker-v2-m3。
• PDF 和 Tika 扩展 — 维护独立的扩展索引，并返回带有明确来源标签的统一结果。Tika 目录列出了 1,290 种格式；实际兼容性仍取决于源文件和解析器。
• 事件驱动的实时监视 — 响应实际文件变更，等待可配置的静默时长，并在可丢弃的工作进程中执行增量更新。
• 可见的查询阶段 — 准备、词法召回、语义召回、融合、重排序、最终处理和上下文打包等阶段会显示在 Query Console 中。
• 资源感知执行 — 自动模式优先使用可用的 NVIDIA CUDA 路径，并在 Windows 提交内存、物理内存或 GPU 内存不足时安全回退。
• 只读 MCP 访问 — MCP 客户端可以检查就绪状态并进行搜索，但不能构建索引、删除数据或更改配置。

隐私边界

Caelune 以本地优先为设计原则，但这并不意味着所有可能的工作流都会永久离线。

• 系统会读取源文件以构建索引；常规构建和移除源文件的操作不会删除或改写原始笔记或文档。
• 只有在用户主动下载 Runtime 组件、模型、Java 或 Tika 等内容时，才需要联网。
• 仅当你复制或导出检索到的文本，或明确允许 MCP 客户端请求这些文本时，内容才会离开应用。
• 第三方 AI 客户端以及你粘贴到其中的任何内容，仍受其自身隐私政策约束。

请备份重要的源材料，并在将检索到的上下文用于高风险工作前进行检查。

快速入门

1. 下载名称中包含 WIN-EXE 的发布文件。
2. 解压存档并启动 Caelune.exe。
3. 等待自动检测 Runtime 完成。
4. 选择本地数据根目录，并添加一个或多个 Markdown 知识库目录。
5. 系统提示时，请从 Runtime 页面安装或修复 CPU/CUDA Runtime 和本地模型。
6. 执行一次完整构建。
7. 在 Query Console 中搜索。如果希望后续编辑自动纳入索引，请启用实时监视。

详细说明：入门指南。

实际要求

• 64 位 Windows
• 为应用、外部 Runtime、本地模型和索引预留足够的磁盘空间
• 初次下载 Runtime/模型时需要联网，除非手动安装了相关负载
• 支持 CPU 执行；兼容的 NVIDIA GPU 和驱动程序为可选项
• 对于大型知识库和本地 AI 模型，建议使用 Windows 自动管理分页文件

Runtime 和模型以外置附加组件的形式提供，因此可在不同应用版本间复用运行正常的组件。请参阅 Runtime 和模型。

检索流程

flowchart LR
    A["Markdown / PDF / Tika sources"] --> B["Local parsing and indexes"]
    B --> C["FTS5 lexical recall"]
    B --> D["LanceDB semantic recall"]
    C --> E["Fusion and filters"]
    D --> E
    E --> F["Optional reranking"]
    F --> G["Results and context pack"]
    G --> H["Clipboard or read-only MCP"]

一分钟了解 MCP

1. 使用桌面应用至少构建一个知识库。
2. 下载 MCP ZIP 以手动配置 stdio，或使用 Registry/MCPB 软件包。
3. 将兼容的客户端指向 Caelune-MCP.exe。
4. 让客户端调用：
   • omniclip.status，检查就绪状态和当前检索模式
   • omniclip.search，检索带来源标签的结果

某些客户端不支持直接使用本地 stdio 服务，可能需要本地代理。请参阅 MCP 集成 Wiki 和 MCP_SETUP.md。

文档

用户指南

主题	指南
安装和首次构建	入门指南
运行时、模型、CPU 和 CUDA	运行时和模型
知识库和实时监视	知识库和实时监视
查询阶段和资源消息	搜索和资源
PDF 和 Tika 来源	PDF 和 Tika
MCP 客户端和工具	MCP 集成
常见问题	故障排除

项目参考

• 架构
• 运行时设置参考
• MCP 设置参考
• 更新日志
• 第三方声明
• 发布历史

开发

# Desktop GUI
.\scripts\run_gui.ps1

# CLI status and query
.\scripts\run.ps1 status
.\scripts\run.ps1 query "your question"

# Build Windows packages
.\scripts\build_exe.ps1

# MCP self-check from source
python launcher_mcp.py --mcp-selfcheck

开发者入门说明和架构链接请参阅开发与架构。

许可证和第三方软件

Caelune 根据 MIT 许可证发布。它依赖多个开源项目，包括 PySide6、SQLite、LanceDB、Apache Arrow、PyTorch、sentence-transformers、Transformers、BGE 模型、PyPDF、Apache Tika、Eclipse Temurin、watchdog、PyInstaller 和 Model Context Protocol SDK。

请参阅 THIRD_PARTY_NOTICES.md，了解仓库级别的法律和分发声明。

Caelune 及其检索结果不提供任何保证。请核实重要结果、做好备份，切勿将检索到的上下文或下游 AI 输出作为医疗、法律、金融、安全关键或其他高风险决策的唯一依据。