obsidian-rag-email-sender

该项目把一个 Obsidian Markdown 笔记文件夹变成可搜索的知识库，然后允许用户提出基于这些笔记的问题，并起草和发送基于笔记的邮件，同时附带来源引用以防止幻觉。它摄取 Obsidian 库（一个包含带 YAML frontmatter 的 .md 笔记的目录），并以感知标题的方式分块，使引用指向正确的章节。系统包含 Ask 模式和 Compose Email 模式：Ask 模式仅利用检索到的上下文对库进行问答，并显示和评分确切的来源分块；在 Compose Email 模式下，用户描述想要的邮件，应用检索相关笔记，起草基于这些笔记的主题和正文，让用户编辑，并通过 SMTP 发送。仅预览开关（默认开启）使公开演示在不暴露邮件凭据的情况下保持安全。生成步骤被要求只使用检索到的上下文并引用其来源。检索使用非对称嵌入（笔记用 retrieval_document，问题用 retrieval_query）和有重叠的分块，使边界附近的事实仍可被检索到，检索到的分块会显示在界面中，以便人工核实依据。应用附带示例库，用户可以添加免费的 Gemini 密钥，点击 Build index，然后提问。技术栈包括用于界面的 Streamlit、用作 LLM 的 Google Gemini 1.5 Flash、用于嵌入的 Gemini text-embedding-004、用于向量搜索的 NumPy 余弦相似度，以及用于邮件的标准库 smtplib。索引在内存中，每个会话重建，适合个人库上的 MVP，扩展时下一步是持久化存储。Obsidian 的 [[wikilinks]] 作为纯文本嵌入，不会解析成图谱，也没有认证，仅作为单用户演示。