AI 输出可能有错误。涉及事实、数字、代码、医疗、法律或财务内容时，必须独立核验后再使用。
一、准备 API Key
NexaNote 不附赠模型额度。你需要在 DeepSeek 或兼容的 OpenAI 风格服务商处创建账号、开通 API 服务并生成密钥。聊天网站会员通常不等于 API 额度，具体计费以服务商为准。
- 密钥通常只完整显示一次，请存入密码管理器。
- 不要把 API Key 写进笔记、邮件、群聊或公开截图。
- 发现泄露后立即在服务商后台撤销并重新生成。
二、在 NexaNote 中配置
- 打开“设置 → AI 模型”。
- 填写 API Key。
- 按服务商要求填写 API 地址和模型名称；使用默认 DeepSeek 时保留推荐值。
- 保存设置，回到编辑器。
- 用一小段非敏感文字执行“总结”，确认可以收到结果。
企业代理、自建兼容接口或其他模型若不完全兼容流式响应、模型名和错误格式，可能无法正常使用。
三、编辑器中的 AI 操作
- 改进文本：润色表达。选中文字时只处理选区；未选中时处理当前笔记正文。
- 翻译：支持英语、日语、法语、德语、西班牙语、韩语、中文和繁体中文。
- 总结：压缩长文并提取重点。
- 提取标签：生成主题标签，点击单个标签或“全部应用”。
AI 结果先显示在编辑器上方。确认内容后再点击“替换原文”；不满意可直接关闭，原文不会自动被覆盖。
四、AI 对话面板
点击工具栏右侧的 AI 图标打开对话面板。可围绕当前笔记提问、让 AI 给出结构建议或继续多轮讨论。对话历史保存在本机应用数据中，但发送请求时消息和所选笔记上下文会交给配置的模型服务商处理。
五、AI 整理与语义搜索
- 智能整理面板可为当前笔记建议标签。
- “未整理”区域可对多篇笔记批量补标签；建议先小批量试用。
- “语义搜索相关笔记”会根据当前内容寻找语义相近的笔记，而不只匹配关键词。
六、隐私、敏感信息与费用
本地编辑不会自动上传整套知识库。只有在你主动使用某项 AI 功能时，该功能需要的文本才会发送到所选服务商。不要提交密码、身份证号、未公开商业信息、受保密协议约束的内容或他人的敏感资料。
API 费用由服务商按其规则收取。长笔记、多轮对话和批量标签会消耗更多 Token；建议在服务商后台设置余额提醒或用量上限。
七、常见错误
401、无效密钥或认证失败
重新复制 API Key，确认没有多余空格、密钥未撤销且账户有权调用 API。
模型不存在或 404
检查 API 地址和模型名称是否属于同一服务商，不要把聊天网页地址填进 API 地址。
响应超时或网络错误
缩短选中文本后重试，检查网络、代理和服务商状态。连续失败时暂停批量操作，避免重复计费。
提示模型不支持图片
NexaNote 会过滤图片内容后重试文本请求。需要分析图片时，应使用明确支持视觉输入的模型与接口。