安装、更新与文件关联

Navop 提供 macOS、Windows 和 Linux 桌面版本。安装包、系统架构和版本号必须相互匹配；升级前应先保存正在编辑的 SQL、Notes 和远程文件，并结束手动事务与传输任务。

文档中的安装、更新和文件关联说明以当前稳定发布版为准。下载页中的版本号、架构后缀和校验文件是判断安装包是否匹配的唯一依据，不要使用搜索引擎中来历不明的镜像。

下载并安装

从 GitHub Releases 选择最新稳定版。macOS 根据设备选择 Apple Silicon 或 Intel 构建，将应用拖入“应用程序”；Windows 使用对应安装包完成安装；Linux 按发布页提供的格式安装，并确认桌面环境允许启动图形应用。

首次启动若被 macOS Gatekeeper 拦截，应先确认安装包来自项目正式发布页，再到“系统设置 → 隐私与安全性”允许打开。Windows 或 Linux 的安全软件提示也应先核对文件来源和版本，不要通过关闭全局安全策略来规避检查。企业设备如受管理员策略管理，请由管理员批准安装。

平台	设备/架构	推荐文件	适用场景
macOS	Apple Silicon	`.dmg` 或 `.tar.gz` 的 Apple Silicon 构建	M 系列 Mac
macOS	Intel	`.dmg` 或 `.tar.gz` 的 Intel 构建	Intel Mac
Windows	x86_64	`.msi`	常规安装、开始菜单和桌面快捷方式
Windows	x86_64	`.zip`	便携使用或手动放置目录
Linux	x86_64	`.deb`、`.rpm`、`.AppImage` 或 `.tar.gz`	按发行版和桌面环境选择

每个发布版本的 sha256sums.txt 用于校验下载完整性。企业环境应在安装前保存版本号、文件名和校验值，便于回溯。

启动后先选择界面语言、主题和默认启动页。SSH、SFTP、网络数据库和远程桌面需要访问局域网或互联网；系统弹出本地网络、防火墙或钥匙串权限时，应根据实际连接范围授权。Notes 目录、外部编辑器和自定义字体需要相应文件系统权限。

建议先创建一个不含生产凭据的测试连接，确认 DNS、代理、防火墙和证书链都正常。需要使用连接导入、远程桌面 Provider、数据库扩展或 ACP Agent 时，再从扩展市场安装对应组件。

在设置的“更新”区域开启自动检查，或手动检查新版本。应用内更新会下载适合当前平台的构建；开始前关闭正在使用的连接，提交或回滚手动事务，并等待 SFTP 传输结束。更新完成后重新启动，检查连接、扩展和快捷键是否正常。

若新版本与关键扩展不兼容，可先导出必要配置并从 Releases 重新安装上一稳定版。回退不会替代数据备份：本地配置格式可能随版本演进，降级前应保留 Navop 数据目录副本。不要用未知来源的旧安装包覆盖当前版本。

更新前可以按下面的顺序做一次检查：

macOS 如果确认安装包来源可信但仍被系统隔离，可以使用项目 README 中的 Gatekeeper 处理命令；不要把关闭系统保护作为长期安装方案。

Navop 支持通过系统打开 .db、.duckdb 和 .md 文件。SQLite/DuckDB 文件会创建或打开本地数据库连接，.md 文件会进入 Notes Markdown 编辑器。若系统未自动建立关联，可在操作系统的“打开方式”中选择 Navop 并设置为默认应用。

打开数据库文件前确认它不是仍由其他程序独占写入的生产文件；必要时先复制副本。打开外部 Markdown 时，Notes 会围绕文件所在位置工作，相关图片和资源路径仍受本地目录权限与相对路径影响。

卸载应用程序本体通常不会自动删除全部本地设置、连接密文、Notes 或扩展缓存。若只是重装，不要清理数据目录；若要彻底移除，应先导出需要保留的资料、停止同步并确认团队资源已经交接，再按当前系统删除应用与用户数据。

主密钥无法通过重装恢复。清除本地数据前，必须确认已记住主密钥并了解同步状态；团队 Owner 还应确认其他管理员和团队密钥状态，避免唯一可管理设备被移除。