AI 知识助手
FlexNote AI 可围绕笔记、白板、PDF、图片和媒体字幕进行语义检索、引用问答与连续对话，并通过 Agent 对知识库和白板执行操作。回答中的来源可定位至笔记原文、PDF 页面或媒体时间点。
开始前的准备
- 打开 设置 > AI 助手设置，启用 AI 功能。
- 选择模型服务商，填写 API Key、Base URL 和模型名称，并执行连接测试。
- 根据需要设置自定义系统提示词。
- 开启自动索引，或在索引管理中选择需要建立索引的卡片。
聊天、Agent 和 AI Actions 使用已配置的模型服务。语义检索和图片 OCR 使用智能索引能力。可用功能与额度以当前账户方案及设置页面为准。
API Key 和发送至模型的上下文由相应服务商处理。使用前应核对服务商的数据处理条款，不应在不受信任的服务中处理访问凭证或敏感资料。
Ask 与 Agent
AI 面板提供两类工作模式：
| 模式 | 主要用途 | 数据操作 |
|---|---|---|
| Ask | 检索、问答、总结、比较和解释资料 | 以读取与回答为主 |
| Agent | 创建或修改卡片、待办、标签、白板节点、连线和布局 | 可执行写入操作 |
Agent 在需要确认时会暂停执行。确认前应检查操作目标、选中范围和计划写入的内容。重要知识库建议在批量操作前创建本地备份。
知识索引
索引让 AI 能按语义找到相关内容，而不只依赖标题关键词。FlexNote 可以为笔记、PDF、图片文字和媒体字幕建立索引。
- PDF 与图片可通过文本提取或 OCR 纳入检索。
- 视频/音频可基于已有字幕建立索引。
- 长 PDF 支持分段处理与断点续跑。
- 索引管理会提示不完整的 PDF 或只包含标题的媒体索引，可在后台补全。
- 可搜索并多选卡片，手动提交重建任务；当前对话涉及的卡片也可强制重建。
:::warning 索引成功不代表原资料已备份。知识索引属于可重新生成的数据，备份时可能被自动排除。 :::
提问方式
可直接检索整个知识库，也可先选择白板节点或卡片列表中的内容，再打开 AI 面板。当前选择会进入对话上下文，适用于摘要、比较、问题提炼和结构生成。
推荐问题示例：
- “总结这些卡片的共同观点，并列出分歧。”
- “根据这份 PDF，说明作者的研究方法，并给出引用位置。”
- “把当前选择整理成三级大纲，再生成思维导图结构。”
- “找出知识库里与这个项目风险相关的资料。”
快捷操作模板
卡片可运行预设或自定义 AI Actions。常见操作包括总结、翻译、生成思维导图、提取行动项和执行自定义提示词。自定义操作可命名并置顶。
执行前请确认当前选中的卡片和白板范围，避免把无关内容带入上下文。
回答与引用定位
AI 消息可以展示 Markdown、图片、执行步骤和引用来源。引用可能跳转到：
- 笔记中的相关段落或块；
- PDF 的对应页与高亮位置；
- 视频/音频的相应时间点；
- 白板或嵌入卡片的原始内容。
AI 输出可能包含错误或遗漏。研究、决策和公开发布前，应通过引用位置核对原文。
常见问题
为什么 AI 找不到某份资料？
先检查该卡片是否已建立索引。对于 PDF 和媒体，查看是否提示“索引不完整”，必要时重新建立。没有文本层的扫描 PDF 还需要 OCR。
为什么 PDF 只能检索到前几页？
这通常是不完整索引。到索引管理中扫描并补全，长文档会显示页数或分段进度。
AI 会自动修改我的内容吗？
Ask 以查询和梳理为主；Agent 可修改知识库。运行编辑、整理、标签、待办或白板操作前，应检查目标范围和执行结果。