Obsidian 本地 GPT 插件

无加速。MacBook Pro 13 英寸，M1 芯片，16GB 内存，Ollama，orca-mini。

该插件允许您在选中文本时打开上下文菜单，以选择 AI 助手操作，或打开操作面板来执行一次性操作。 Obsidian 最为轻便的 AI 助手。

操作面板

特性

支持图片

无加速。MacBook Pro 13 英寸，M1 芯片，16GB 内存，Ollama，bakllava。

可利用链接、反向链接，甚至 PDF 文件中的上下文（RAG）

使用方法（Ollama）

1. 安装嵌入模型：

• 英文：`ollama pull nomic-embed-text`（最快）
• 其他语言：`ollama pull bge-m3`（较慢，但更准确）

2. 在插件设置中选择嵌入提供商，并尽量使用具有最大上下文窗口的最大模型。

默认操作

• 继续写作
• 总结文本
• 拼写和语法修正
• 在文本中查找待办事项
• 通用帮助（直接将选中文本作为提示用于任何目的）
• 新建系统提示，以创建符合您需求的操作

社区操作

您可以直接从插件设置中浏览并安装社区提供的操作。

自动更新： 社区操作会自动更新到最新版本。若希望保留特定版本或您的修改，只需 修改提示或系统提示 即可禁用该操作的自动更新。请注意：仅更改操作的 名称 并不会禁用自动更新。

支持的语言

• 英语
• 中文
• 荷兰语
• 法语
• 德语
• 意大利语
• 日语
• 韩语
• 葡萄牙语
• 俄语
• 西班牙语

安装

1. 安装插件

Obsidian 插件商店（推荐）

此插件可在 Obsidian 社区插件商店中找到：https://obsidian.md/plugins?id=local-gpt

BRAT

您也可以通过 BRAT 安装此插件：pfrankov/obsidian-local-gpt

2. 安装 AI 提供商插件

您还需要从插件商店安装 AI 提供商插件，以便配置 AI 提供商：https://obsidian.md/plugins?id=ai-providers

3. 配置 AI 提供商

请按照 AI 提供商 插件中的说明进行操作。

配置 Obsidian 快捷键

1. 打开 Obsidian 设置
2. 进入快捷键设置
3. 搜索“Local”，您应看到“Local GPT：显示上下文菜单”
4. 点击“+”图标并按下快捷键（例如 ⌘ + M）
5. 再次搜索“Local”，您应看到“Local GPT：操作面板”
6. 点击“+”图标并按下快捷键（例如 ⌘ + J）

我的其他 Obsidian 插件

• 彩色标签，可将标签以不同颜色区分。
• Obsidian AI 提供商，是 AI 提供商的集中管理平台。

灵感来源

• Obsidian Ollama。

Obsidian Local GPT 快速上手指南

Obsidian Local GPT 是一款专为 Obsidian 设计的本地 AI 助手插件，支持在选中文本上通过右键菜单或快捷键调用 AI 功能。它支持图像识别、基于链接/反向链接/PDF 的上下文检索（RAG），并允许用户自定义或安装社区动作。

环境准备

系统要求

• 操作系统：macOS, Windows, Linux
• 硬件建议：推荐配备 Apple Silicon (M1/M2/M3) 或具备独立显卡的设备，内存建议 16GB 及以上以获得更佳体验。
• 核心依赖：必须安装并运行本地大模型后端，推荐使用 Ollama。

前置依赖安装

请确保已安装 Ollama。若需使用图像识别或高级上下文检索，需提前拉取对应模型：

# 拉取基础对话模型 (示例：orca-mini)
ollama pull orca-mini

# 拉取图像识别模型 (如需图片功能)
ollama pull bakllava

# 拉取嵌入模型 (用于 RAG 上下文检索)
# 英文环境推荐 (速度快):
ollama pull nomic-embed-text
# 多语言/中文环境推荐 (精度高):
ollama pull bge-m3

国内加速提示：如果拉取模型速度慢，可配置 Ollama 镜像源或使用国内网络加速工具。

安装步骤

1. 安装核心插件

在 Obsidian 中通过以下任一方式安装：

• 方式 A：官方社区插件市场（推荐）

  1. 打开 Obsidian 设置 > 第三方插件。
  2. 关闭“安全模式”（如未关闭）。
  3. 点击 浏览，搜索 Local GPT。
  4. 点击 安装 并启用。

• 方式 B：通过 BRAT 插件安装 如果你需要测试最新版本，可先安装 BRAT 插件，然后在 BRAT 设置中添加仓库：

  pfrankov/obsidian-local-gpt
  

2. 安装 AI 提供商插件

本插件依赖 AI Providers 插件来管理模型连接：

1. 在 Obsidian 社区插件市场中搜索 AI Providers。
2. 安装并启用该插件。

3. 配置 AI 提供商

1. 打开 Obsidian 设置 > AI Providers。
2. 点击 Create AI Provider，选择 Ollama。
3. 按照指引配置模型名称（需与 ollama pull 下载的模型一致）及上下文窗口大小。
4. 保存配置。

4. 配置快捷键（可选但推荐）

为了快速唤起功能，建议设置热键：

1. 打开 Obsidian 设置 > 热键。
2. 搜索 Local。
3. 为 Local GPT: Show context menu 设置快捷键（例如 Cmd/Ctrl + M）。
4. 为 Local GPT: Action Palette 设置快捷键（例如 Cmd/Ctrl + J）。

基本使用

方法一：右键菜单（最常用）

1. 在笔记中选中一段文本（或点击图片）。
2. 点击鼠标右键，选择 Local GPT 菜单。
3. 从列表中选择预设动作，例如：
   • Continue writing：续写内容。
   • Summarize text：总结选中段落。
   • Fix spelling and grammar：修正拼写和语法。
   • Find action items：提取待办事项。
   • General help：将选中文本作为提示词进行通用问答。

方法二：动作面板 (Action Palette)

1. 按下设置的快捷键（如 Cmd/Ctrl + J）打开动作面板。
2. 输入指令或直接选择预设动作执行一次性任务。

进阶：启用上下文检索 (RAG)

若需让 AI 参考当前笔记的反向链接、关联笔记或 PDF 内容：

1. 确保已按“环境准备”步骤安装了嵌入模型（如 bge-m3）。
2. 进入插件设置，在 Embedding provider 中选择已配置的 Ollama 嵌入模型。
3. 在执行动作时，插件会自动抓取相关上下文增强回答质量。

自定义与社区动作

• 新建动作：在设置中创建新的 System Prompt 以满足特定需求。
• 社区动作：在插件设置的 "Community Actions" 标签页中浏览并一键安装他人分享的动作模板。修改动作的 Prompt 内容即可锁定版本，防止自动更新覆盖你的定制。