使用前先确认
MCP 当前支持 Mac 和 Windows 桌面版。知了笔记自身不内置 AI，也不以用户笔记训练模型；但用户连接的第三方客户端可能按其自身规则把获准内容发送给模型服务。
使用前应阅读所选客户端和模型服务的隐私规则，只授权完成任务所需的最小范围。
开启并连接
- 在电脑端打开“设置 → AI 连接”，点击“新建连接”。
- 填写容易辨认的连接名称，选择允许访问的笔记本或目录。新连接默认只读且范围为空；先开放完成任务需要的资料。
- 点击“保存连接”，确认页面显示保存成功。
- 选择要使用的客户端，点击“复制配置”，再按该客户端的连接方式粘贴。配置含访问凭据，不要公开分享。
- 在客户端进行一次范围明确的检索，核对返回内容确实来自获准范围。
凭据原文只在当前设置页面显示，离开后无法再次查看。需要新凭据时，点击“重新生成凭据”，保存成功后复制新配置并替换客户端旧配置；新凭据保存后旧凭据失效。若重新生成后未保存就放弃修改，原连接保持原状。
保存出错时，已填写内容会保留。看到“重新读取配置”时，先读取并核对当前连接，不要把尚未确认的保存结果当作授权已经生效。从旧版升级后，原有连接只保留只读兼容能力；要使用新增能力或重新授权写入，请创建命名连接并更新客户端配置。
管理范围和写权限
每个连接单独授权。选择“全部笔记本”会包含之后新增的笔记本和内容；只想开放部分资料时，请选择具体范围。
只读适合检索、阅读和总结；附件读取也需要相应权限。只有希望 AI 新建笔记、修改内容或整理笔记时才开启写入。连接开启后，已授予的读写能力持续有效，不设置期限；关闭连接后，后续调用立即失效。你可以随时调整范围、取消写入或关闭连接；批量整理仍需在知了笔记中预览确认。
缩小范围、取消写入或关闭连接后，后续调用按新权限处理。已经完成的写入不会自动消失；需要恢复时，先在操作记录中检查是否仍可撤销。
三种任务怎么用
- 研究并沉淀：让 AI 在指定范围检索、阅读笔记和获准附件，再将结果保存为带来源的新笔记。检查结论和引用材料，不把 AI 生成内容当作已经核实的事实。
- 精准修改：明确指出要修改的笔记和段落。局部修改应保留其他内容；若笔记已被你或同步更新，先查看最新内容，再重新准备修改，不强制覆盖。
- 批量整理：让 AI 先提出移动或标签调整计划，再到知了笔记的“待确认与最近整理”核对对象和改动。在聊天里回复“确认”不能代替应用内确认。
按关键词或含义寻找笔记
可以要求 AI 按原词检索，也可以描述想找的意思，或结合两种方式。可以同时指定笔记本、目录、时间段或标签；结果仍只来自该连接获准读取的资料。
语义检索使用桌面版附带的本地模型，模型计算和检索本身不把查询或笔记发送到网络。第一次使用可能需要准备索引，这一过程不会在普通编辑或保存时自动启动。长笔记可能只有部分正文参与语义检索；出现覆盖不完整提示时，应直接阅读原笔记或结合关键词检索。第三方 AI 客户端仍可能按自己的设置把提问和获准返回的内容发送到其模型服务。
若提示本地模型组件不可用，按提示重新打开 AI 连接页面修复组件；修复失败时保留错误信息。运行中的检索不会临时联网下载模型。
查看与保留研究来源
AI 创建的研究笔记会在正文末尾列出本次使用且已验证的来源。名称记录生成时的信息；点击后打开当前可用来源，不是历史版本。来源后来更新、移入废纸篓、附件尚未同步或关系不可用时，会保留名称并说明原因。
来源区可以像普通正文一样修改或删除，应用不会在下次打开或保存时自动补回。电脑端可打开来源笔记；手机端打开前会先保存当前编辑。PDF 在电脑端可使用记录页码，手机端或其他格式可能只打开附件并提示无法精确定位。
导出时，只有一起导出的来源文件保留可用相对链接；其他来源保留为可读文字。整库恢复后旧来源关系降为名称文字，不会按旧编号猜测连接到其他笔记。
确认、结果和撤销
批量计划确认后 10 分钟内有效，且只能使用一次。“已确认，等待 AI 执行”表示已授权，尚不表示整理完成；请继续核对“已完成”状态和实际笔记结果。
可撤销整理会显示按钮和截止时间，首批撤销窗口为 30 天。相关笔记后来被修改时，撤销可能无法安全完成，应用不会用旧内容覆盖新编辑。
连接超时或回复丢失时，不要假定操作失败并反复执行。先查看操作记录，由客户端查询原请求结果；仍无法判断时，保留错误和操作编号再排查。
附件与平台边界
本版支持读取不超过 8 MiB 的受支持格式原图，不自动压缩较大图片。超过限制时会明确提示；你可以自行缩小后再交给 AI，也可以在知了笔记中打开原附件。该限制不会修改原附件。
MCP 由 Mac 和 Windows 桌面版提供，手机端不运行 MCP 或审批批量计划。手机可通过正常同步查看生成的笔记和来源。
Mac 和 Windows 可读取授权范围内有文本层的 PDF。扫描件需先做文字识别；加密、过大或页数过多时按提示处理。返回内容被截断时应缩小页码范围分次读取，不把空结果当作成功。