AI 知识库
AI 知识库不只是一个聊天窗口。它可以先从思源笔记中查找资料，再根据需要读取文档、整理内容，或者在你确认后修改笔记。
第一次使用时，不必把所有高级功能都打开。先完成模型配置，确认普通问答和本地检索可以正常工作，再按需启用联网搜索、工具、Skill、MCP 和沙箱，会更容易排查问题。
带皇冠标记的 AI 入口和扩展功能需要相应的会员权限。模型和搜索服务由第三方提供，调用次数、费用及内容处理规则以对应服务商为准。
一、开启对话入口
打开“主页设置 → AI 知识库”，可以分别开启侧边栏对话和标签页对话。
- 侧边栏对话：适合一边阅读当前文档，一边向 AI 提问。它能使用“当前笔记本”“当前文档及子文档”等范围。
- 标签页对话：空间更大，适合长对话和集中整理资料。由于标签页不绑定某一篇笔记，因此使用全库问答。
两个入口使用同一套模型和功能设置，但当前文档范围不同。需要围绕正在阅读的笔记提问时，优先使用侧边栏。
二、配置第一个模型
打开任意 AI 对话，在顶部点击“设置”，进入“大模型配置”。
插件提供 MiMo、DeepSeek、Kimi 等预设，也支持自定义 OpenAI-compatible 接口。建议按下面的顺序配置：
- 从“添加供应商”中选择对应预设；没有合适的预设时再选自定义接口。
- 检查 Base URL，填写 API Key。
- 点击“刷新模型列表”，或者手动填写服务商提供的模型 ID。
- 先点击“测试连接”，确认模型可以正常回复。
- 如果准备让 AI 调用工具，再点击“测试 Agent”。
- 最后点击“设为当前”，并保存设置。
“测试连接”成功，只能说明模型可以正常对话；“测试 Agent”还会检查工具调用是否兼容。遇到“能聊天但不会调用工具”的情况，先回到这里重新测试。
Temperature、输出上限和上下文窗口都会影响回答。刚开始使用时不必追求复杂参数，先保留默认值；如果服务商明确给出了上下文窗口，再按官方说明填写。
插件会在本地加密保存 API Key，但它仍然是敏感凭据。截图时请遮住密钥，也不要把配置文件上传到公开仓库。怀疑密钥已经泄露时，应立即到服务商后台重置。
三、从一次本地问答开始
配置完成后，先选择“全库问答”，问一个容易验证的问题，例如：
帮我找出知识库中与“读书计划”有关的文档，先列出标题和路径，不要修改内容。
这样可以同时检查模型、知识库搜索和正文读取是否正常。
选择合适的检索范围
侧边栏提供四种范围：
- 当前笔记本：只在当前文档所在的笔记本中找资料。
- 当前文档及子文档：适合教程、项目和读书笔记这类树状内容。
- 当前文档邻域：包含当前文档、父级链、同级文档和直接子文档。
- 全库问答：从整个思源知识库中查找。
前三种范围都依赖当前打开的笔记文档。如果当前标签页是主页、工作台或其他非文档页面，插件会提示你切换到具体文档，也可以直接改用“全库问答”。
问题只和一个项目有关时，不要一开始就搜全库。先把范围缩到对应笔记本或文档树，既能减少无关资料，也能节省上下文。
指定几篇文档提问
点击输入框附近的“文档”按钮，可以搜索并附加文档，也可以直接添加当前文档。
附加文档后，范围会锁定为“特定文档上下文”。此时 AI 只围绕已附加的文档工作，不再按原来的笔记本或全库范围自动检索。移除全部附加文档后，范围选择会恢复。
调整检索参数
“检索与上下文”中可以调整候选返回条数、标题和正文的命中权重，以及单次读取文档的字符数。
普通使用建议保持默认值。只有出现下面这些情况时再调整：
- 经常找不到标题非常明确的文档：适当提高文档标题权重。
- 返回了太多只有少量关键词的无关内容：减少候选条数，或缩小问答范围。
- 长文档总是只读到前半部分：适当提高单次读取字符数，但要留意上下文占用。
这些参数只影响“怎么找”和“每次读多少”，并不会让模型本身变得更聪明。
四、需要最新资料时再联网
先在“设置 → 联网搜索”中开启功能并选择搜索提供商。当前支持 AnySearch、自定义接口和 Tavily。
- AnySearch：可以匿名搜索，也可以填写 API Key 使用 Bearer 认证。
- Tavily：需要填写 API Key。
- 自定义接口：适合已经有兼容 JSON 搜索接口的用户。
设置页提供“测试搜索”和“测试网页读取”。建议两项都测一次：能搜到标题，不代表目标网页一定可以顺利读取。
启用后，对话输入框可以切换三种模式：
- 关闭搜索：本轮不使用联网搜索。
- 智能搜索：由 AI 判断这个问题是否需要查询网络。
- 必须联网：本轮回答前必须先搜索网络，适合新闻、版本变化和时效性较强的问题。
搜索结果、网页内容和模型总结都可能有误。涉及账号安全、付费、医疗、法律或重要操作时，应打开原始页面再次确认。
五、让日常使用更顺手
快捷提示语
快捷提示语适合保存经常重复输入的要求，例如“先列出相关文档，不要修改内容”。
- 新建一篇思源文档。
- 每个顶层段落块写一条提示语。
- 在“快捷提示语”设置中填写该文档 ID。
- 开启功能并保存设置。
设置页也可以直接新增、编辑、排序和删除提示语，不必每次手动打开原文档。
全局记忆
全局记忆适合存放长期有效的偏好和约束，例如常用语言、项目背景、固定格式。它会在每轮对话中占用上下文，因此只保留真正长期有效的内容。
配置方法与快捷提示语类似：准备一篇记忆文档，填写文档 ID，验证通过后开启全局记忆。设置页可以按条目维护内容，并限制每轮最多读取的字符数。
项目文档、会议记录和长篇参考资料应该留在正常知识库中，通过检索按需读取。全部塞进全局记忆，会让每次对话都变慢，也更容易干扰回答。
“编辑全局记忆”是写入工具，会用一份完整的新内容替换当前记忆。保留执行前确认，检查预览无误后再允许写入。
上下文用量与压缩
输入区的圆环会显示上下文大致用量。窗口大小优先读取当前模型的配置，没有填写时使用默认估算。
长对话中可以手动压缩上下文。压缩会保留摘要，不等于逐字保留全部历史；进入全新主题时，新建对话通常比继续压缩旧对话更清楚。
六、分清 Skill 和工具
这两个名字很容易混淆，可以用一句话理解：
- Skill 告诉 AI“遇到这类任务应该怎么做”。
- 工具 决定 AI“实际上能够读取或修改什么”。
当前“技能”设置页主要管理两类内容：
- 外部 Skill：第三方提供，或者由 AI 安装到本地的说明包。插件会建立索引，需要时再读取，不会默认把全部内容塞进每轮对话。
- 自定义 Skill：由你自己编写标题、优先级和能力说明。保存标识只能使用小写英文字母、数字、下划线和连字符。
看不懂 Skill 时可以先不配置，它不是本地笔记问答的必需项。安装第三方 Skill 前，应先确认来源、需要的环境变量和它准备调用的工具。
七、管理 AI 可以调用的工具
当前版本已经把原来的“内置 Skill 能力”整理成工具组。设置页会显示每个工具组包含多少个只读动作和写入动作，并允许分别控制写入确认。
常用工具组包括：
- 思源知识库：搜索、读取和分析本地资料，只读。
- 日记任务：查询和管理强化日记、任务、快速记录与复盘。
- 思源数据库：查询和操作数据库、属性视图。
- 思源文档编辑：读取块信息，并受控修改文档和内容块。
- 思源树与笔记本：管理笔记本和文档树。
- 思源标签书签：管理标签和书签。
- 思源资源：读取和管理 assets 以及受限工作区文件。
- 思源闪卡：查询和管理 Riff 卡包与卡片。
- Skill、MCP、网页和工作区工具：为相应的高级功能提供实际操作能力。
日记任务工具与强化日记功能配合使用，建议先了解对应的数据结构和工作方式：
强化日记只读动作不会修改内容；新增、移动、替换和删除等写入动作默认需要确认。不要为了少点一次按钮就批量免确认，尤其是文档编辑、数据库、文档树和闪卡操作。
如果只想让 AI 帮忙查资料，可以停用不需要的写入工具组。工具停用后，对应能力不会进入当前 Agent 的可用工具列表。
八、MCP：连接外部工具
MCP 用于把外部服务的工具接入 AI。普通笔记问答不需要 MCP，只有明确知道要连接哪个服务时再配置。
当前支持三种传输方式：
- Streamable HTTP：通过 URL 连接，桌面端和移动端都可以使用。
- SSE：通过 URL 连接，桌面端和移动端都可以使用。
- stdio：在本机启动命令，只支持电脑桌面端。
基本流程是：
- 开启“MCP Client”。
- 新建 Server，或导入已有的 JSON 配置。
- 打开“连接”和“暴露”。
- 点击“同步”，读取 Server 提供的工具列表。
- 在工具索引中停用不需要的工具，并检查写入工具是否可信。
“连接”决定插件是否连接这个 Server，“暴露”决定它的工具是否提供给 AI。两者不是一回事。
标记为 trusted 后，工具仍会校验参数并记录日志，但可能减少人工确认。只有在明确了解 Server 来源、权限和实际行为时才设为信任。
九、沙箱环境与本地命令
沙箱环境用于限制 AI 在 Notebrain 工作区中的文件操作和本地命令。默认关闭；普通用户不需要为了使用 AI 知识库而开启它。
启用后，建议保持“严格工作区模式”，并按需控制：
- 是否启用本地命令工具；
- 是否允许文件写入和删除；
- 命令执行前是询问、允许还是拒绝；
- 是否允许网络访问、系统信息命令和绝对路径；
- 命令超时与输出字符上限。
沙箱属于插件的软件级限制，不是虚拟机，也不是操作系统安全沙箱。即使开启严格模式，也应逐条检查准备执行的命令，不要向 AI 开放不必要的系统权限。
本地命令和 stdio MCP 都依赖电脑上的运行环境，只能在桌面端执行。移动端可以保留配置，但不能运行这两类本地能力。
十、主页状态语 AI
“主页设置 → AI 知识库”中可以为状态语单独选择模型，还可以决定是否允许该模型使用思考模式。这里选择的模型不会改变聊天窗口当前使用的模型。
在状态语设置中切换为 AI 生成后，可以填写风格要求和文字上限。鼠标移到状态语附近，点击刷新按钮即可重新生成。
十一、编辑器选区 AI
开启“编辑器选区 AI 工具栏”后，在编辑器中选中文字即可调用 AI 问答、翻译、解释、润色或自定义技能。
每个选区技能都可以单独设置模型、提示模板、选中文字上限、输出上限和显示位置。
“AI 问答”和其他技能的行为不同：
- AI 问答会打开侧边栏，并把当前文档和选中文字带入输入框，适合继续追问。
- 翻译、解释、润色等技能会直接执行一次生成，在选区附近显示结果。
十二、常见问题
输入框提示没有可用模型
检查提供商和模型是否启用，模型 ID 是否为空，以及是否已经点击“设为当前”。然后重新执行“测试连接”。
普通聊天正常，但 AI 不会使用工具
先运行“测试 Agent”。如果测试失败，换用明确支持工具调用的模型；模型列表能够刷新，不代表该模型一定兼容 Agent。
看不到当前文档相关的问答范围
标签页对话不绑定当前文档。请改用侧边栏，并先打开一篇具体的思源笔记。
添加文档后不能切换检索范围
这是正常行为。附加文档后会进入“特定文档上下文”，移除全部附加文档即可恢复范围选择。
联网搜索没有结果
到“联网搜索”设置中分别运行“测试搜索”和“测试网页读取”，再检查 API Key、接口地址、超时时间和网络环境。
AI 想修改内容，却一直没有执行
检查对应工具组是否启用，并留意是否有等待确认的写入操作。不要通过关闭全部确认来绕过问题。
移动端无法使用 stdio MCP 或本地命令
这两类功能需要启动电脑上的本地进程，只支持桌面端。移动端请使用 HTTP 或 SSE 类型的 MCP Server。