先保护数据
如果问题涉及笔记缺失、同步差异、导入覆盖或恢复失败：
- 停止在多台设备上继续编辑、移动或删除同一批内容。
- 不要卸载应用、清除应用数据或重复覆盖恢复。
- 保留当前可用设备、原始导入文件和所有备份。
- 记录问题出现前后的时间和操作。
无法下载、安装或更新
确认下载来源、网络、系统版本和剩余空间。macOS 首次打开可使用右键“打开”；Android 只为官网安装包临时允许对应来源。仍失败时保留系统完整错误提示。
无法启动、黑屏或没有窗口
先记录平台、系统版本、知了笔记版本、安装来源，以及“完全没有窗口、出现空白窗口、停在载入中、显示救援页”中的哪一种。macOS 可检查“活动监视器”，Windows 可检查“任务管理器”，但不要为了排障删除应用或数据目录。
如果还能看到更新页或救援页，可按提示主动检查更新；如果原生进程无法启动、WebView 无法创建、安装损坏或系统阻止运行，应用内功能无法自救。请按照安装与更新中的“无法进入应用时如何更新”选择对应平台的官方外部更新路径。
数据库迁移、附件处理或保存写入尚未安全结束时，不得安装或重启。无法判断是否安全时，请保持现场并联系技术支持；不要自动修库、反复覆盖恢复、卸载应用或清除数据。
编辑、图片或附件异常
先退出当前笔记再重新打开，确认问题是否只影响一篇笔记。不要在问题未明时批量修改。记录使用的格式、附件类型、文件大小和复现步骤。
Android 保存失败
不要卸载、清除数据或反复覆盖；先确认草稿或恢复内容仍在，再记录系统版本、剩余空间、附件大小以及问题发生在返回、后台、强制结束还是重新启动之后。
附件打开、另存或拖放失败
确认源附件仍可打开。取消或失败后检查目标位置没有 0 字节文件或不完整副本；跨笔记拖放失败时，确认源笔记没有丢失附件。保留源文件和失败目标，不要反复覆盖。
剪藏失败
确认原内容仍可访问，然后重新点击“剪藏”按钮发起一次操作。区分来源不可访问、登录或风控限制、结构降级和产品失真；保留原链接、页面类型及脱敏截图。登录、人机验证、站点风控、页面变化和分享链接过期都可能影响结果。不要发送账号、密码或验证码给技术支持。
千问链接仍显示“分享已失效”时，应用可以保存当前可见的失效状态和原分享链接，但不能恢复失效前的对话。网络连接失败、登录页或人机验证墙应提示失败。确认原链接状态后只重试一次；不要连续提交造成重复笔记。
导入或导出失败
保留原始文件，先用少量样本复现。记录来源软件、导出格式、文件数量和失败位置。生成了文件不代表迁移完成，应检查正文、图片、附件和链接。
分享含本地附件的 Markdown 时，如果附件缺失、无法读取或压缩中断，应停止并保留原笔记，不要把残缺包当作成功结果。把导出结果解压到独立目录后再核对相对引用；不要从旧资料库目录手工补图来掩盖导出缺失。
同步异常
记录两端平台、系统版本、知了笔记版本、最后一次正常同步时间、网络错误、二维码是否自动关闭和具体差异。不要先解除旧配对、卸载或用另一端覆盖；先保留两端可用副本。参见同步与设备。
首次添加设备与已经配对后的重新连接是两个流程。首次添加失败时先检查网络和系统日期、时间，再重新点击“添加设备”；已配对设备提示重连时先保留两端数据和备份。不要关闭 TLS 校验、清除应用数据或反复解除配对。
本机备份或现有恢复入口异常
停止重复恢复，保留原备份和当前数据。在技术支持确认前，不要删除任何一份可能可用的数据。参见备份与恢复。
资料库位置不可访问
如果资料库位于移动硬盘，先保持应用关闭，再检查硬盘是否连接、卷名和原文件夹是否仍在。不要新建同名空文件夹，不要移动或覆盖原资料库，也不要把旧副本直接当作当前资料库。重新连接后使用应用提供的“定位已有资料库”入口；仍无法识别时保留原盘和错误提示并联系技术支持。
迁移过程中断时，同时保留原位置和目标位置，不要手工合并两边文件。只有应用明确完成复制、校验和切换后，才能把新位置当作当前资料库。
MCP 连接失败
检查桌面端和第三方客户端是否运行、连接信息是否完整、授权范围是否包含目标笔记。不要公开连接信息或笔记内容。
检查连接是否开启、凭据是否为保存后的最新版本、授权范围和读写能力是否覆盖当前任务。本地模型组件不可用时按 AI 连接页提示修复。请求超时或客户端没有收到回复时，先查操作记录和原请求结果，不要直接重复写入或批量整理。
联系技术支持
发送邮件至 szdreamer@qq.com，并提供平台、设备型号、操作系统版本、知了笔记版本、实际结果、预期结果、复现步骤和必要截图。
涉及笔记内容、附件、同步密钥或其他敏感信息时，请先遮盖无关隐私，不要直接发送完整笔记库。数据相关问题请在邮件标题中注明“数据问题”。