关键要点
- 由独立开发者HugoValim开发的开源社区插件——并非Joplin官方产品
- 许可证：MIT，见GitHub仓库
- 通过通用的OpenAI兼容HTTP/SSE端点连接——无厂商SDK——默认基础URL为Ollama的默认本地端口（
http://localhost:11434/v1） - 在设置中更改基础URL后，也可配合LM Studio或OpenAI API使用
- 需要Joplin 3.6以上；仅支持桌面端——明确不支持Joplin移动端
- 对笔记或文件的任何修改在应用前都会以临时差异文档形式展示以供审核——不会有任何静默写入
- 撤销功能最多保留十次运行、最长七天；并发处理采用基于时间戳的冲突检测
- 对笔记的可选语义搜索（RAG）需要Joplin 3.7以上
📍 简单一句话
Joplin AI Agent是一款社区插件，为Joplin笔记应用添加了需审核后才生效的AI聊天代理，可连接任意OpenAI兼容端点，包括完全本地的Ollama和LM Studio服务器。
💬 简单来说
它在Joplin中添加了一个AI聊天面板，可以读取您的笔记，并且只有在您批准显示的差异内容后才会进行编辑。您可以将其连接到运行在自己电脑上的、通过Ollama或LM Studio提供的模型，而不是云端订阅服务，从而让笔记完全留在您自己的设备上。
📌注: 本评测是本地LLM软件目录中Joplin AI Agent条目的深度补充——该页面可让您一目了然地比较它与数十款其他支持本地AI的工具。
Joplin AI Agent是什么？
Joplin AI Agent是面向跨平台开源笔记应用Joplin的社区插件，由独立开发者HugoValim开发，并以MIT许可证的开源软件形式发布。根据其自身的GitHub仓库，它为Joplin配置文件中的笔记、笔记本和文本文件添加了基于工具的读写访问能力的AI代理，任何提议的修改在应用前都会经过审核步骤。
- 插件ID：
com.hugovalim.joplin-ai-agent - 截至本评测版本为0.7.0——插件版本会独立于本文更新，请直接查看仓库获取当前版本
- 核心功能：侧边栏聊天代理可以搜索、读取Joplin配置文件中的笔记、笔记本和文本文件，并在审核后进行编辑
- 本地推理：未内置推理引擎——该插件将请求发送到单独运行的OpenAI兼容服务器（Ollama、LM Studio或云端API），而非自带模型权重
- 开发者：HugoValim，一位以开源软件形式发布该插件的独立开发者，与Joplin维护者无关
- 权威仓库：github.com/HugoValim/joplin-ai-plugin
Joplin AI Agent能做什么？
根据其自身的README，Joplin AI Agent结合了理解整个笔记库的聊天功能、基于工具的文件访问以及任何写入前的审核步骤。
- 持久化聊天记录 — 对话会在多次会话间保留上下文设置和运行摘要，而不是每次新对话都重置
- 可选的笔记检索（RAG） — 对笔记进行语义搜索，使回答能以笔记库内容作为上下文；此特定功能需要Joplin 3.7或更高版本
- 防注入与防捏造规则 — 该插件文档中说明了旨在防止来自笔记内容的提示注入、并减少代理引用笔记时捏造引用的规则
- 基于工具的读写访问 — 代理不仅能就笔记、笔记本和纯文本文件进行对话，还能读取并提出修改建议
- 需审核的修改提案 — 任何拟议的修改在应用前都会以临时差异文档形式展示，让您批准或拒绝确切的改动，而不是被静默写入
- 基于时间戳的冲突检测 — 该插件会在应用修改前检查笔记的修改时间戳，以在应用改动前发现并发编辑的情况
- 撤销历史 — 最多保留十次运行、最长七天，使代理造成的不良修改可在事后撤销
- 带键盘快捷键的侧边栏界面 — 聊天面板位于Joplin侧边栏，带有键盘快捷键，长对话记录以每页100条消息分页显示
- 外部文件夹工作区支持 — 可对Joplin配置文件之外的外部文件夹中的文件进行操作，并遵循该文件夹的
.gitignore规则
如何将Joplin AI Agent连接到本地模型？
Joplin AI Agent与任意OpenAI兼容的HTTP/SSE端点通信——无需配置任何厂商专属SDK。 默认基础URLhttp://localhost:11434/v1与Ollama的默认本地服务器端口一致，因此标准的本地Ollama安装无需更改任何URL即可使用。
API密钥
- 应填内容:
- 大多数本地服务器为可选项；要求验证的云服务商则为必填项。
模型名称
- 应填内容:
- 后端所报告的确切模型标识（例如您已拉取的Ollama模型标签）。
系统提示词、温度、输出token数、超时
- 应填内容:
- 用于调整代理行为的可选字段——除非有明确理由，否则保持默认值即可。
所有配置都位于Joplin设置→“Joplin AI Agent”中。由于该插件使用通用的OpenAI兼容协议而非特定厂商SDK，理论上任何暴露相同API形态的本地或自托管服务器，只需更改基础URL即可使用。
获取Joplin AI Agent
Joplin AI Agent以Joplin内插件形式安装，而非独立应用程序——必须已经安装Joplin本身。截至本评测，尚未确认该插件是否会出现在Joplin应用内的社区插件搜索中，因此请从GitHub Releases发布的.jpl文件手动安装。
从GitHub Releases手动安装（推荐）
- 安装步骤:
- 从GitHub Releases页面下载
com.hugovalim.joplin-ai-agent.jpl。在Joplin中打开设置→插件，使用“从文件安装”选项，选择下载好的.jpl文件。如提示则重启Joplin，然后如未自动启用则手动启用该插件。
从源码构建
- 安装步骤:
- 克隆github.com/HugoValim/joplin-ai-plugin并按照仓库自身的构建说明操作——适合需要特定提交版本或想要贡献代码的用户。
需要Joplin 3.6或更高版本。Joplin AI Agent仅支持桌面端——明确不支持Joplin的移动应用，因此请只在Windows、macOS或Linux的桌面版Joplin上安装。
Joplin AI Agent在写入时如何保护您的笔记？
Joplin AI Agent提出的任何笔记或文件修改，都会先以临时差异文档的形式出现，而不是静默编辑。 您可以在决定是否应用之前审核确切的改动内容——代理不会自行覆盖笔记。
- 先差异后写入 — 拟议的修改会以临时差异文档形式呈现，准确展示将发生的改动，然后才会应用到真实笔记上
- 基于时间戳的冲突检测 — 该插件会在应用修改前检查笔记的最后修改时间戳，以发现您或其他设备在代理读取笔记之后又对其进行了修改的情况
- 撤销窗口期 — 最多十次运行在最长七天内保持可恢复状态，因此不需要的修改不仅可以在应用前被拒绝，事后也能撤销
- 防注入与防捏造规则 — 根据其自身文档，该插件应用了旨在防止来自笔记内容的提示注入、并在代理引用您的笔记时减少捏造引用的规则
谁适合使用Joplin AI Agent？
Joplin AI Agent是否适合您，取决于您是否已经使用Joplin作为笔记应用，并且希望有一个AI代理能够使用您自己控制的后端，读取并在审核后编辑该笔记库。
竞品与替代方案
Joplin AI Agent最直接的竞争对手是其他为特定笔记应用（而非独立聊天界面）构建的AI代理插件。目前PromptQuorum已发布的最接近的对比评测针对的是另一款宿主应用。
- Copilot for Obsidian评测 — 同类别的AI代理插件，但面向Obsidian而非Joplin。它与Joplin AI Agent共享相同的核心理念（读取并编辑笔记库的AI代理，支持本地模型），有助于比较两款不同笔记应用如何解决相同的问题。
- Smart Connections评测 — 同属"笔记应用内AI"这一更广泛类别中的另一种工具：面向Obsidian的本地语义搜索与链接发现插件，而非编辑文件的代理。
评估Joplin AI Agent时的常见误区
关于Joplin AI Agent的大多数误解，来自于误以为它是Joplin官方功能，或者期望它在移动端与桌面端表现一致。
常见问题
Joplin AI Agent是什么？
Joplin AI Agent是为笔记应用Joplin开发的社区插件，添加了一个可基于工具读取、并在审核后写入您的笔记、笔记本和文本文件的AI聊天代理。它由开发者HugoValim独立开发。
Joplin AI Agent能配合本地AI模型使用吗？
可以。它能连接任意OpenAI兼容的HTTP/SSE端点，其默认基础URL（http://localhost:11434/v1）与Ollama的本地服务器一致，因此无需修改代码即可配合完全本地化的模型使用。只需更改基础URL，也能配合LM Studio或其他OpenAI兼容服务器使用。
Joplin AI Agent是Joplin团队开发的吗？
不是。它是由开发者HugoValim独立开发和维护的社区插件，并非由Joplin维护者开发或官方支持。
Joplin AI Agent以何种许可证发布？
根据插件位于github.com/HugoValim/joplin-ai-plugin的GitHub仓库，为MIT许可证。
如何安装Joplin AI Agent？
从插件的GitHub Releases页面下载com.hugovalim.joplin-ai-agent.jpl文件，然后在Joplin中打开设置→插件，使用“从文件安装”选择该文件。由于尚未确认它是否可在Joplin应用内市场中搜索到，这种手动安装是目前有文档说明的方式。
Joplin AI Agent能在Joplin移动端使用吗？
不能。该插件明确不支持Joplin移动端——它仅支持桌面端，适用于Windows、macOS和Linux上安装的Joplin。
Joplin AI Agent需要什么版本的Joplin？
插件本身需要Joplin 3.6或更高版本。其可选的笔记检索（RAG）功能则专门需要Joplin 3.7或更高版本。
Joplin AI Agent会自动编辑我的笔记吗？
不会。任何拟议的修改都会先以临时差异文档形式展示以供审核，然后才会应用——代理不会静默写入笔记。
我能撤销Joplin AI Agent所做的修改吗？
可以。该插件最多保留十次运行、最长七天，因此可以事后撤销最近一次代理所做的修改。
Joplin AI Agent支持哪些AI后端？
根据其自身文档，支持任意OpenAI兼容的HTTP/SSE端点——由于使用的是通用API形态而非厂商专属SDK，这包括Ollama（默认）、LM Studio和OpenAI API。