从哪里下载
- macOS：从官网首页下载 Mac 版 DMG；
- Windows：从官网首页下载 Windows 安装程序；
- iOS：前往 App Store 的知了笔记页面；
- Android：从官网首页下载 APK，不要使用来路不明的第三方安装包。
在 macOS 安装
- 双击下载完成的 DMG 文件。
- 将“知了笔记”拖入“应用程序”文件夹。
- 从“应用程序”打开知了笔记。
- 如果系统在首次打开时拦截，请在“应用程序”中右键知了笔记，选择“打开”，再确认一次。
知了笔记 Mac 版经过 Apple 签名与公证。更新时通常可以用新版本覆盖旧版本，但覆盖前仍建议完成一次独立备份。
在 Windows 安装
- 下载官网提供的 Windows 安装程序。
- 打开安装程序并按页面提示完成安装。
- 启动后在设置中核对当前版本。
Windows 如果阻止打开安装程序，请先核对下载地址和文件名，不要直接关闭系统安全防护。
在 iOS 安装或更新
- 打开 App Store 的知了笔记页面。
- 点击“获取”或“更新”。
- 安装完成后打开应用，并在设置中核对版本。
iOS 公开版本以 App Store 页面为准。
在 Android 安装 APK
- 从官网下载安装包。
- 打开 APK；首次安装时，系统可能要求允许当前浏览器或文件管理器安装外部来源应用。
- 只为本次使用的来源开启权限，安装完成后可以关闭该权限。
- 打开知了笔记并核对应用名称、橙色蝉翼图标和版本。
系统提示“未知来源”并不等于安装包已确认有害，但必须先确认文件来自官网。
知了笔记也可在纯血鸿蒙设备上通过卓易通运行。该兼容方式已经完成一次实际测试，但不同设备、系统或卓易通版本的安装界面可能不同；请从官方来源取得 APK，并使用覆盖安装保留原应用数据。若系统提示签名不一致、要求先卸载或出现权限异常，请停止安装并联系技术支持。
检查与更新版本
在应用设置中查看当前版本，并使用软件更新入口检查新版本。桌面端或 Android 下载新安装包后，按正常安装流程覆盖旧版本；iOS 通过 App Store 更新。
覆盖安装不应被当作备份。更新前如有重要内容，请先阅读备份与恢复。
更新后先核对数据与配对
更新后，先核对笔记、附件、草稿和同步状态。已经正常配对的设备应继续保留可用连接；如果应用提示需要重新配对，不要先解除或删除原有设备关系。先确认两端数据都有可用副本，再按应用提示完成新的配对。网络失败、取消或二维码异常时，应保留原来的恢复路径，不要通过卸载、清除数据或用另一端覆盖来排障。
升级后的实际表现仍以同一最终候选的真实升级核对为准；不要把这段说明理解为“升级绝不会要求重新配对”或“任何升级都不会影响数据”。
更新提醒会在什么时候出现
一般改进会以不打断操作的方式提示。同一版本已经提醒后，你可以继续在“设置 → 软件更新”查看并决定是否更新。
涉及重要修复的版本，会在应用空闲时显示更新面板。选择稍后后，72 小时内不会再次弹出；同一版本最多自动弹出两次，此后仍可从设置入口查看。
涉及安全、数据可靠性或协议兼容的重要问题，可能每 24 小时再次提醒一次。你仍可查看、导出并保留现有本机备份，应用不会静默强制安装。
编辑尚未保存、正在同步或执行备份相关操作、正在处理附件，或其他窗口正在等待操作时，更新提醒和安装会等待合适时机。Mac 和 Windows 下载并校验更新后，会保存当前编辑并等待相关写入结束，再开始安装。保存冲突、任务未结束、等待超时或安装失败时，本次安装会停止；笔记和输入会保留，你可以处理提示后重试。
在不同设备上更新
Mac 和 Windows 可在应用中下载并安装；界面会持续显示下载、保存准备和安装状态，完成后应用将重启。Android 会打开官方 APK 获取入口，iPhone 会打开 App Store。打开下载页面或商店不等于已经安装，新版本生效后应在设置中核对版本。
检查失败或来源暂时不可用时，手动检查会说明暂时无法确认，不会显示“已经是最新”。更新未完成时，可以稍后从设置、官网或 App Store 重试。不要卸载应用、清除应用数据或关闭系统安全校验来绕过更新错误。
无法进入应用时如何更新
先判断应用是否还能显示更新页、启动救援页或其他可操作界面：
- 仍有可操作界面：可以主动检查更新。macOS 和 Windows 可按应用内更新提示操作；Android 会转到可信 APK 获取入口；iOS 会转到 App Store。应用不静默强制安装，也不自动修复业务数据库。
- 完全没有窗口或更新入口：不要反复启动、卸载或清除数据，改用下面对应平台的官方外部更新路径。
无论使用哪条路径，只要迁移或写入尚未安全结束，就不得继续安装或重启；这里包括数据库迁移、附件处理、保存和其他写入。如果界面提示初始化仍在进行，或你无法判断写入是否结束，请保持现状并联系技术支持。更新不是清除数据或整库恢复操作，不要删除资料库，也不要用旧备份直接盖住当前数据。
macOS
- 如果应用能显示更新或救援页面，先使用其中的应用内更新入口；看到“初始化仍在进行”一类保护提示时不要安装或重启。
- 如果应用无法进入，打开“活动监视器”，确认“知了笔记”进程已停止；无法确认时不要强制覆盖。
- 从官网下载 Mac 版 DMG，把新版本覆盖安装到“应用程序”。不要删除
~/Library/Application Support/com.zhiliao.zen，也不要把删除旧应用当作更新步骤。 - 更新后先核对笔记、附件、草稿和同步状态，再恢复正常使用。
Windows
- 如果应用能显示更新或救援页面，先使用其中的应用内更新入口；处于迁移或写入阶段时不要安装或重启。
- 如果应用无法进入，打开“任务管理器”，确认知了笔记相关进程已停止。
- 从官网下载 Windows 版并按原安装位置覆盖安装。不要删除应用数据目录，也不要关闭系统安全防护来绕过来源或签名警告。
- 更新后先核对笔记、附件、草稿和同步状态。安装仍失败时，保留完整错误提示，不要改用不明来源的安装包。
Android
- 只从官网获取可信的 Android APK，并核对页面公开版本；不要使用群聊、网盘或第三方站点转传的安装包。
- 直接对现有知了笔记执行覆盖安装，不要先卸载，也不要清除应用数据。
- 如果系统要求卸载旧版、提示签名不一致或阻止覆盖安装，请立即停止并联系技术支持；不要用删除数据换取安装成功。
- 安装后核对笔记、附件、草稿和同步身份是否保持不变。
iOS
- 打开 App Store 的知了笔记页面；只有页面出现“更新”时，才表示该版本已可用于当前账号和地区。
- 直接点击“更新”，不要先删除 App。删除 App 可能同时移除本机应用容器中的数据。
- 如果 App Store 仍显示“打开”或没有新版本，请稍后重试；不要把其他平台的版本号当成 iOS 已发布依据。
- 更新完成后核对笔记和同步状态。若无法确认数据已经同步或备份，请勿通过删除后重装来排障。
应用内无法自救的边界
如果原生进程无法启动、WebView 无法创建、应用签名或安装损坏，或者操作系统阻止应用运行，应用内更新器和救援页面都无法执行。此时只能使用上面的官网或 App Store 外部更新路径。
外部覆盖安装的目的只是恢复可运行版本，不代表数据库问题已被诊断或自动修复。不要自行删除、重建或替换数据库；如果更新后仍无法打开，请保留现场并联系技术支持。
更新失败
- 重新确认网络连接和剩余存储空间；
- 确认下载来源是官网或 App Store；
- 记录当前版本、目标版本和错误提示；
- 不要在尚未备份时卸载应用或清除应用数据；
- 仍无法解决时，前往故障排查。