Logseq 接入大模型：AI 配置与调用方法
Logseq 本身没有内置的 AI 对话按钮，所有 AI 能力都来自社区插件。
要让它调用大模型，核心动作只有三步：装插件、填 API 信息、用命令触发。
下面按顺序说明，并给出卡住时怎么查。
装哪个插件，先看它是否支持自定义接口
在 Logseq 桌面版中打开 设置 → 插件 → Marketplace，搜索 AI。
常见插件包括 logseq-plugin-ai、logseq-ai-assistant 等。
选插件时优先看两点：
- 是否支持 自定义 Base URL（如果你用国内中转或自建代理，必须能改接口地址）
- 是否允许填写 模型名称（如
gpt-4o-mini、deepseek-chat）
如果只支持官方 OpenAI 且不能改地址，在国内网络环境下可能无法直连。
获取 API Key 和接口地址
以 OpenAI 兼容接口为例，你需要准备三样东西：
- API Key：在模型服务商控制台创建，通常以
sk-开头 - Base URL：多数兼容接口填
https://api.openai.com/v1或服务商提供的地址 - 模型名称：填服务商文档中列出的模型 ID，不要自己编
把这三项先记在记事本里，后面插件设置会逐项用到。
在插件设置里完成配置
安装插件后，打开 设置 → 插件 → 找到刚装的插件 → 点击齿轮或 Settings。
不同插件界面不同，但通常包含以下字段：
API Key: sk-你的密钥
Base URL: https://api.openai.com/v1
Model: gpt-4o-mini填写时注意：
- Base URL 一般 不带
/chat/completions后缀，只写到/v1即可；如果插件说明要求带完整路径，按说明来。 - 模型名称区分大小写，不要多空格。
- 保存后建议重启一次 Logseq，让插件重新读取配置。
用斜杠命令触发第一次调用
回到任意笔记页面，在空白块输入 /，找到插件提供的命令，例如 AI: Ask 或 AI: Summarize。
选中一段文字后调用总结命令，如果配置正确，几秒内会在当前块下方生成回复。
如果没有任何反应，先打开 Logseq 的开发者工具（Ctrl+Shift+I 或 Cmd+Option+I），查看 Console 面板是否有报错。
常见输出包括：
401 Unauthorized：API Key 错误或已失效404 Not Found：Base URL 路径写错，多写或少写/v1timeout：网络无法直连，需要代理或换用可访问的接口地址
容易踩的坑
密钥不要写进公开笔记。
插件配置保存在本地，但如果你把配置块复制到共享页面，密钥会跟着泄露。
建议只放在插件设置里。
免费额度与计费。
调用 AI 接口通常按 token 计费，插件本身不收费。
配置前先确认服务商是否赠送试用额度，避免密钥填好后调用失败却以为是插件问题。
移动端限制。
Logseq 移动端对插件支持有限，部分 AI 插件只在桌面版可用。
如果你主要在手机使用，先确认插件说明是否支持移动端。
验证配置是否生效
最直接的验证方法：新建一个空白块，输入 / 后看插件命令是否出现；
选中一句话执行总结，观察是否在 10 秒内返回文本。
如果命令出现但调用报错，按 Console 中的状态码对照上面排查。
只要斜杠命令能正常返回内容，就说明 Logseq AI 配置完成。
