Lapis0x0/obsidian-yolo

📌 什么是 YOLO？

YOLO（“面向 Obsidian 的 Agent 原生 AI 助手”）是一个社区插件，将大语言模型智能体直接引入 Obsidian 笔记应用。它让你无需离开笔记库即可与 AI 工具聊天、写作和编排，将你的个人知识库变成一个交互式、支持 RAG 的工作区。

---

🚀 核心功能（根据 README 描述）

功能	作用
Agent 体验	连接本地已登录的 CLI 智能体（Claude Code、Codex、Hermes、Pi、Grok），让它们在你的笔记库中操作——调用工具、运行 shell 命令、执行网络搜索等。
笔记库 RAG	索引你的 Obsidian 笔记（包括本地嵌入模型），检索基于上下文的答案，让 AI 引用你自己的内容。
学习模式	将任何主题 + 源材料转化为结构化的学习项目：大纲、知识点、闪卡、间隔重复（FSRS）和 Anki .apkg 导出。
多窗口聊天	并行运行多个独立的聊天会话，每个会话有自己的上下文和任务。
记忆系统	跨对话持久化偏好、习惯和长期上下文。
光标聊天与快速提问	在编辑器中一键 @ 提问、编辑或继续写作，无需离开笔记。
Tab 补全	输入时实时提供 AI 驱动的建议。
多模型支持	在 OpenAI、Anthropic Claude、Google Gemini、DeepSeek、Groq 等之间切换。
外部 Agent / MCP 支持	连接外部智能体（例如 Hermes、OpenClaw）或将任务委派给配置好的 YOLO Agent。
白板	高性能的 Obsidian Canvas，比原生画布更快，旨在借助 AI 辅助进行头脑风暴。
i18n	完整的多语言界面。

---

🛠️ 快速开始（README 中的快速入门步骤）

1. 安装 – 打开 Obsidian → 设置 → 社区插件 → 浏览 → 搜索 “YOLO” → 安装并启用。
2. 配置 – 为你想要的模型（OpenAI、Anthropic、Gemini、Grok 等）添加 API 密钥，或使用 OAuth 登录。
3. 开始聊天 – 打开 YOLO 侧边栏，或在任意笔记中输入 @ 启动 快速提问。
4. （可选）手动安装 – 从最新版本下载 main.js、manifest.json、styles.css，将它们放入 <vault>/.obsidian/plugins/obsidian-yolo/，然后启用。

注意： YOLO 与 Smart Composer 插件冲突；你必须先禁用后者。

---

📚 文档与帮助

• 完整用户指南：documentation/en/README.md
• 主题包括入门、模型设置、聊天工作流、Sparkle（快速提问与 Tab 补全）、知识库、工具与权限、记忆、技能、智能体、MCP 集成、CLI 智能体等。
• 通过 Discord 服务器（链接在 README 中）和 GitHub 上的问题跟踪器提供社区支持。

---

🎯 谁可能受益？

• 知识工作者：在 Obsidian 中保存大量笔记，希望获得 AI 增强的搜索和写作。
• 学生与终身学习者：寻找带有闪卡和间隔重复的个人学习系统。
• 开发者：已经使用 CLI AI 智能体，希望将这种能力带入笔记工作流。
• 团队：需要一个统一的 AI 助手，能够在共享笔记库中调用外部工具、运行 shell 命令或执行网络搜索。

---

🧩 它如何融入 AI 生态

• RAG（检索增强生成） – YOLO 在本地（或通过远程嵌入）索引你的笔记库，并检索相关段落以支撑模型响应。
• 智能体编排 – 支持工具调用、子智能体和 MCP（多通道协议）服务器，将简单的问答机器人转变为主动的协作者。
• 多模型灵活性 – 用户无需离开 Obsidian 即可在主流 LLM 提供商之间切换。

---

📦 许可证与贡献

• 基于 MIT 许可证 授权。
• 欢迎贡献；仓库包含 CONTRIBUTING.md，其中包含指南、AI 辅助 PR 政策以及主要功能先请求的工作流程。

---

TL;DR： YOLO 是一个功能齐全的 Obsidian AI 智能体插件，增加了聊天、RAG、多模型支持、工具调用和学习系统，将你的笔记库变成一个交互式 AI 驱动的工作区。