Roam Research AI 怎么用：内置功能与插件接入实操
Roam Research 本身提供 AI 助手功能，但不是在页面里随便打一句话就能用。
你需要先在设置中启用它，并了解它会消耗平台积分；
如果希望使用自己的模型 API，则要借助社区插件。
下面分别说明两种方式的配置步骤和验证方法。
先确认你要走哪条路
Roam Research 的 AI 能力目前可以分成两类：
- 内置 AI 助手：由 Roam 官方提供，在设置里启用后，可以在日记或页面中调用，适合不想折腾 API 的用户。它的使用会消耗账号积分，积分获取方式和额度以账号内实际显示为准。
- 社区插件接入自定义模型：通过 Roam 的扩展机制安装第三方插件，填入自己的模型服务商 API 密钥，适合已有 OpenAI、Anthropic 等账号、希望控制成本和模型选择的用户。
两条路不冲突，但建议先跑通内置功能，再决定是否折腾插件。
启用内置 AI 助手
内置 AI 的入口在设置面板中，操作路径如下：
- 打开 Roam Research 网页版，进入你的图谱（Graph）。
- 点击右上角的齿轮图标进入
Settings。 - 在设置列表中查找与 AI 或助手相关的选项（不同时期界面名称可能略有差异，以你看到的实际名称为准）。
- 打开启用开关，按提示确认积分消耗说明。
- 回到日记页面，在块（Block）的右键菜单或命令面板中查找 AI 相关命令，尝试生成一段简短内容。
验证方式：如果命令能正常返回文本且没有报错，说明启用成功。
如果提示积分不足，需要先查看账号的积分余额和获取方式。
用社区插件接入自己的模型
如果内置功能不能满足模型选择或成本控制需求，可以安装社区插件。
Roam 的插件通过 roam/js 代码块加载，常见步骤是：
- 在任意页面新建一个块，输入
/调出命令菜单，选择JavaScript或直接输入三个反引号加javascript创建代码块。 - 在代码块第一行写入
// roam/js，这是 Roam 识别可执行代码块的标记。 - 粘贴插件作者提供的加载代码（通常是一段动态加载脚本的 JavaScript），代码内容以插件官方说明为准，不要从不明来源复制。
- 在设置中确认允许执行自定义代码，然后刷新页面。
插件安装后，一般需要在插件自己的设置面板里填入 API 密钥、模型名称和接口地址。
以 OpenAI 兼容接口为例，配置项通常包括：
API Key: sk-你的密钥
Base URL: https://api.openai.com/v1
Model: gpt-4o-mini（或你账号可用的模型）验证方式：在插件提供的命令入口输入一个简单问题，观察是否返回结果；
同时在浏览器开发者工具的网络面板中确认请求没有返回 401 或 429 状态码。
容易踩的几个坑
- 积分消耗不透明：内置 AI 每次调用可能消耗积分，频繁试用前先了解额度规则，避免中途不可用。
- 插件代码来源：只从插件官方仓库或可信作者处获取加载代码，
roam/js代码块拥有较高权限，来源不明的脚本有安全风险。 - API 密钥泄露：密钥填在插件设置里即可，不要写进公开分享的页面或代码块中。
- 模型名称写错：接口返回 404 时优先检查模型名称是否与服务商文档一致，不要凭记忆填写。
怎么判断配置是否生效
完成配置后，建议按这个顺序检查：内置 AI 能否在命令菜单中找到并返回内容；
插件是否出现在设置面板中；
发起一次请求后网络面板是否返回 200；
返回内容是否与提问相关。
如果某一步失败，回到对应小节核对开关、密钥和模型名，而不是反复重装插件。
Roam Research AI 的用法并不复杂，关键是先分清内置助手和插件接入两条路径，再按步骤验证。
内置功能适合快速上手，插件方案适合需要自定义模型的用户，两者按需选择即可。
