Joplin 桌面版 AI chat 如何配置本地 Ollama 模型并通过 Test AI configuration 验证【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplinJoplin 桌面版可以把 AI chat 面板和插件的模型调用指向自己机器上的 Ollama这样处理笔记时没有任何内容离开本机。配置只有一个入口设置界面里的AI部分把 Chat provider 选为 OpenAI-compatible、填入 Ollama 的 base URL 和模型名再用Test AI configuration按钮做一次端到端验证。适用前提桌面版应用Windows、macOS 或 Linux。AI 功能仅在桌面版可用移动端没有。本机已有一个可运行的 Ollama 服务。Joplin 文档中给出的 Ollama 示例地址是http://localhost:11434/v1也就是说服务运行在localhost的11434端口。打开 AI 配置界面打开配置界面的方式来自 Configuration screenWindows / Linux菜单Tools Options或按Ctrl,。macOS菜单Joplin Preferences或按Cmd,。进入后切到AI部分下面的操作都在这里完成。启用 AI 并填写 OpenAI-compatible 配置勾选Enable AI features。AI 默认是关闭的主开关不打开时任何插件或内置功能的 AI 调用都不会成功。在Chat provider中选择OpenAI-compatible。Ollama 属于任何讲 OpenAI API 的服务之一OpenAI、Ollama、LM Studio、OpenRouter、vLLM 等都走这个 provider需要设置 base URL、API key 和模型名三项。按 AI chat 文档给出的 Ollama 示例填写Base URLhttp://localhost:11434/v1。/v1后缀是必须的这一点在验证失败时会直接报错提示见下文。API key按表单要求填写。该字段标记为secure存储在操作系统 keychain 中见 spec。模型名填 Ollama 正在提供的模型标识。文档只给出了gpt-4o-mini、claude-3-5-sonnet-latest这类模型标识的示例格式Ollama 侧应填你本地实际部署的模型名。一个需要注意的默认行为如果当前正在与 Joplin Cloud 同步第一次打开Enable AI features时 provider 会被自动选为Joplin Cloud AI其他同步目标则保持默认的 OpenAI-compatible。所以如果你看到 provider 已经是 Joplin Cloud AI手动改回 OpenAI-compatible 即可provider 随时可以切换。Allow remote AI providers 开关本地 Ollama 不需要打开除了主开关Joplin 还有一个独立的Allow remote AI providers开关默认关闭用来防止笔记意外发送到云服务。它的分类规则来自 AI chat 与 spec指向localhost/127.0.0.1spec 中还列出::1的 OpenAI-compatible base URL 被分类为local。Ollama 跑在本机时即使该开关保持关闭也完全可用内容不离开这台电脑。任何非 localhost 的地址包括局域网里的其他机器都被当作remote需要打开Allow remote AI providers才能调用不打开时调用会报明确错误。所以主路径是base URL 用http://localhost:11434/v1不动 remote 开关。用 Test AI configuration 验证设置界面本身不会在保存时调用模型校验 provider 信息Test AI configuration按钮才是用户侧唯一的端到端验证手段。点击它时行为细节见 spec表单里尚未保存的修改会先写入设置测试跑的是你刚填的值而不是上次保存的值向当前 provider 发送一条单消息聊天Reply with the single word OK.结果直接渲染在按钮下方成功显示模型的回复内容失败完整错误信息以警告色显示在按钮正下方完整错误同时写入 dev tools 控制台方便进一步调试。该测试按钮与插件调用走的是同一条AiService.chat()代码路径一次点击就覆盖了隐私开关检查、provider 构造、网络请求和响应解析所以通过它就意味着 AI chat 面板和插件会复用这套可用配置。测试失败时文档 列出的常见错误与对应处理No choices in response — check that the base URL includes /v1——本地 Ollama / LM Studio 服务器的典型错误base URL 少了/v1后缀。这类服务器在请求缺少/v1前缀时会返回200空响应体adapter 检测到 2xx 但没有choices数组就报这个错。把 base URL 补成http://localhost:11434/v1再测。Remote AI providers are not allowed——base URL 被分类为 remote例如填成了局域网地址。若确实要使用非 localhost 地址打开Allow remote AI providers否则把地址改回localhost。Joplin Cloud AI requires Joplin Cloud sync——与本文场景无关仅在误选了 Joplin Cloud AI 而非 Joplin Cloud 同步时出现换一个 provider 即可。验证通过之后配置验证通过后这套设置就是全局唯一的模型来源编辑器里的 AI chat panel 会自动工作无需单独配置笔记工具栏右上角的 chat 图标只会在Enable AI features打开后出现。插件通过joplin.ai.chat()调用时使用的正是这里的 provider 和模型插件本身不携带 API key也不得自行指定模型。Settings → AI 中会跟踪当前 provider 的累计输入/输出 token旁边有Reset token usage按钮更换 provider 或 base URL 时计数自动清零。另外按 spec 说明较老版本的 Ollama 可能完全省略响应中的usage块adapter 会把缺失的计数记为零而不是报错所以 token 计数为 0 不代表调用失败。如果之后想整体停用 AI取消勾选Enable AI features即可主开关关闭期间任何插件或内置功能的 AI 调用都不会成功与 provider 设置和 remote 开关无关。【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考