如何用 Obsidian Local GPT 打造终极离线 AI 知识库？新手必备完整指南 🚀

Obsidian Local GPT 是一款专为 Obsidian 设计的革命性插件，它将强大的本地 AI 助手直接集成到你的笔记工作流中，无需联网即可实现文本生成、总结、语法检查等功能，同时确保所有数据 100% 私密安全。无论是学术研究、创意写作还是知识管理，这款插件都能让你的 Obsidian 笔记体验跃升新高度。

✨ 为什么选择 Obsidian Local GPT？核心优势解析

🔒 完全离线运行，数据隐私零风险

所有 AI 计算均在本地完成，无需将笔记内容上传至云端服务器。你的私密想法、研究资料和创作灵感始终保存在自己的设备中，彻底杜绝数据泄露风险。

🖼️ 全能媒体支持，不止于文本

除了标准 markdown 笔记外，插件还支持直接处理图片内容和 PDF 文件。无论是截图中的文字提取，还是学术论文的智能摘要，都能一键完成。

图：Local GPT 正在分析笔记中的图片内容（示意图）

🧠 强大 RAG 技术，深度整合知识库

通过先进的检索增强生成（RAG）技术，插件能自动关联你的笔记链接、反向链接甚至 PDF 文献内容，为 AI 回答提供上下文支持，让生成内容更贴合你的知识体系。

⚙️ 高度自定义动作，打造专属助手

内置 6 种实用 AI 动作（继续写作、总结文本、语法修复等），同时支持创建自定义系统提示。你可以在 src/rag.ts 中扩展核心逻辑，或通过设置面板导入社区分享的动作模板。

📦 3 步快速上手：从安装到使用

1️⃣ 安装插件（两种方式）

官方插件商店（推荐）

1. 打开 Obsidian → 设置 → 社区插件
2. 搜索 "Local GPT" → 点击安装并启用

手动安装

git clone https://gitcode.com/gh_mirrors/ob/obsidian-local-gpt
cd obsidian-local-gpt
npm install
npm run build

将生成的 main.js、manifest.json 和 styles.css 复制到 Obsidian 插件文件夹。

2️⃣ 配置 AI 服务

1. 安装配套的 AI Providers 插件
2. 配置本地 AI 服务（推荐 Ollama）：
   • 安装 Ollama 客户端
   • 拉取推荐模型：ollama pull nomic-embed-text（英文）或 ollama pull bge-m3（多语言）
   • 在插件设置中选择对应模型

3️⃣ 设置快捷键（效率倍增）

1. 打开 Obsidian 设置 → 热键
2. 为 "Local GPT: 显示上下文菜单" 设置快捷键（如 Ctrl+M）
3. 为 "Local GPT: 动作面板" 设置快捷键（如 Ctrl+J）

💡 新手必备技巧：解锁高级功能

📝 智能文本处理实战

选中任意笔记内容，右键选择 "Local GPT" 即可：

• 快速总结：长文一键提炼核心观点
• 语法修复：自动修正拼写和语法错误
• 行动项提取：从会议纪要中识别待办事项

📚 PDF 文献深度解析

1. 在笔记中插入 PDF 文件链接
2. 选中链接后调用 "增强分析" 动作
3. AI 将自动提取 PDF 内容并结合笔记上下文生成分析结果

图：Local GPT 动作面板展示多种 AI 功能（示意图）

🌐 多语言支持无缝切换

插件内置中文、英文、德文和俄文支持，可在 src/i18n/ 文件夹中添加更多语言包。系统会根据 Obsidian 界面语言自动切换，无需额外配置。

🛠️ 常见问题解决

Q：运行时提示 "模型未找到"？

A：确保已通过 Ollama 正确拉取模型，且在 AI Providers 设置中选择了正确的模型名称。

Q：如何提高 AI 回答质量？

A：尝试在 docs/prompt-templating.md 中学习提示词模板设计，或使用更大上下文窗口的模型（如 llama3）。

Q：支持移动设备吗？

A：目前仅支持桌面端（Windows/macOS/Linux），移动版正在开发中。

📚 进阶学习资源

• 官方文档：docs/prompt-templating.md
• 核心源码：src/main.ts（插件入口）、src/rag.ts（RAG 逻辑）
• 社区讨论：通过 Action Palette 中的 "反馈" 动作提交建议

Obsidian Local GPT 正在持续进化，每月更新新功能。立即安装这款免费插件，让 AI 助手为你的知识管理插上翅膀，体验真正属于自己的本地智能笔记系统！ 🚀