安裝、更新與檔案關聯

Navop 提供 macOS、Windows 與 Linux 桌面版本。安裝包必須符合系統與 CPU 架構；更新前先儲存 SQL、Notes 和遠端檔案，結束手動交易並等待傳輸完成。

下載與安裝

從官網下載中心選擇最新穩定版。macOS 依裝置選 Apple Silicon 或 Intel，將應用程式移入「應用程式」；Windows 執行相符安裝包；Linux 依發佈頁提供的格式安裝。

若 macOS Gatekeeper 阻擋首次啟動，先確認來源為正式發佈頁，再到「隱私權與安全性」允許開啟。若確認來源可信但仍被系統隔離，可執行 sudo xattr -rd com.apple.quarantine /Applications/Navop.app 後重新開啟。Windows 或 Linux 的安全警告也應核對來源，不要關閉全域防護。受管理裝置可能需要管理員核准。

安裝包選擇

平台	裝置/架構	建議檔案	適用情境
macOS	Apple Silicon	`navop-<version>-macos-arm64.dmg` 或 `navop-<version>-macos-arm64.tar.gz`	M 系列 Mac
macOS	Intel	`navop-<version>-macos-x64.dmg` 或 `navop-<version>-macos-x64.tar.gz`	Intel Mac
Windows	x86_64	`navop-<version>-windows-x64.msi`	MSI 安裝包，提供開始功能表、桌面捷徑與穩定的檔案關聯
Windows	x86_64	`navop-<version>-windows-x64.exe`	EXE 安裝包，封裝同一套目前使用者 MSI 安裝流程
Windows	x86_64	`navop-<version>-windows-x64.zip`	免安裝執行；資料仍儲存在 Windows 使用者目錄
Windows	x86_64	`navop-<version>-windows-x64-portable.zip`	將程式與資料放在同一個可搬移目錄
Linux	x86_64	`navop-<version>-linux-x64.tar.gz`、`navop_<version>_amd64.deb`、`navop-<version>-1.x86_64.rpm`、`navop_<version>_amd64.AppImage`	依發行版與桌面環境選擇
Linux	x86_64	`navop-<version>-linux-x64-portable.tar.gz`	將程式與資料放在同一個可搬移目錄；詳見下文「Linux 可攜版」
Linux	ARM64	`navop-<version>-linux-arm64.tar.gz`	ARM64 裝置
Linux	ARM64	`navop-<version>-linux-arm64-portable.tar.gz`	將程式與資料放在同一個可搬移目錄；詳見下文「Linux 可攜版」
Linux	x86_64 / ARM64	`navop-<version>-linux-x64-gpu-stack.tar.gz`、`navop-<version>-linux-arm64-gpu-stack.tar.gz`	僅在系統缺少可用的 Mesa/EGL 繪圖堆疊時補充安裝，可搭配上述任一 Linux 套件使用

可使用同一發佈版本中的 sha256sums.txt 驗證下載完整性。

透過 Scoop 安裝（Windows）

Navop 已收錄在 Scoop 官方 extras bucket。安裝的是便攜版包，data 資料目錄持久化由 Scoop 管理：

powershell

scoop bucket add extras
scoop install navop

後續透過 scoop update navop 升級。Scoop 安裝與 MSI/EXE 安裝版使用不同的資料目錄；在兩者之間切換時，請參考下文便攜模式說明搬移 data 目錄。

Windows 安裝版

一般安裝可以選擇 navop-<version>-windows-x64.msi 或 navop-<version>-windows-x64.exe；32 位元 Windows 請下載名稱中明確包含 win32 的安裝包，例如 navop-<version>-win32.exe。EXE 安裝包內嵌並啟動同一套 MSI 安裝流程，因此兩者預設都安裝到目前使用者目錄，建立開始功能表與桌面捷徑，註冊支援的檔案關聯，使用標準 Windows 使用者資料目錄，並支援記住主密鑰後自動解鎖。使用預設的目前使用者安裝位置時不需要管理員權限。

Windows 免安裝 ZIP

一般 navop-<version>-windows-x64.zip（32 位元版本為 navop-<version>-win32.zip）只包含普通的 navop.exe，使用前必須完整解壓縮。它不會安裝捷徑或檔案關聯，但仍使用標準 Windows 使用者資料目錄，並支援記住主密鑰後自動解鎖。除非要主動啟用下述便攜模式，否則不要在執行檔旁放置 navop.portable。

從 v0.10.1 或更早版本的 Windows ZIP 升級

IMPORTANT

v0.10.1 及更早版本的一般 Windows ZIP 實際上已包含 navop.portable，因此這些使用者目前執行的是便攜模式。升級時請下載新的 navop-<version>-windows-x64-portable.zip（32 位元版本名稱包含 win32），備份並完整保留舊目錄中的 data，同時確認 navop.portable 仍與 navop.exe 位於同一層。

不要為了切換版本而直接刪除舊目錄中的 navop.portable。刪除標記只會讓 Navop 改用標準 Windows 使用者資料目錄，不會自動複製或搬移原有的便攜資料。

如果將新的一般 navop-<version>-windows-x64.zip 或 navop-<version>-win32.zip 解壓縮到全新目錄，或改用 MSI/EXE 安裝版，Navop 將使用標準 Windows 使用者資料目錄。此時原有連線、設定與擴充可能看似消失，但舊便攜目錄中的資料並未被刪除；安裝程式也不會自動搬移該目錄。需要改用安裝版時，請先保留完整的舊便攜目錄與主密鑰，確認搬移後的資料可用，再清理舊目錄。

Windows 便攜版

解壓縮與首次啟動

官方 Windows -portable.zip 是獨立的便攜版，壓縮包內含：

text

navop.exe
navop.portable

navop.portable 是啟用便攜模式的標記檔案，必須與 navop.exe 保持在同一目錄。不要直接在 ZIP 壓縮包內執行，也不建議刪除或重新命名此檔案。請先將壓縮包完整解壓縮到目前使用者可寫入的一般目錄，例如：

text

D:\Apps\NavopPortable\
├── navop.exe
└── navop.portable

接著連按兩下 navop.exe，或在 PowerShell 中執行：

powershell

.\navop.exe

首次啟動後，Navop 會在執行檔旁自動建立 data 目錄：

text

D:\Apps\NavopPortable\
├── navop.exe
├── navop.portable
└── data\
    ├── config\
    ├── state\
    └── cache\

便攜目錄必須可寫入。不要放在 Program Files、唯讀目錄或唯讀移動媒體中；使用 USB 隨身碟或外接磁碟時，也應確認媒體連線穩定且允許寫入。目錄無法寫入時，Navop 會拒絕啟動。

資料目錄與主密鑰

便攜版將設定、應用程式狀態和快取分別儲存在 data/config、data/state 和 data/cache，方便連同程式一起搬移或備份。**預設情況下，便攜模式不會持久化主密鑰，每次啟動都必須重新輸入。**使用者可以在設定中明確選擇將可自動復原的加密副本儲存到 data/state/key_storage。

此選項有顯著安全風險：檔案加密使用程式內置密鑰，而非裝置綁定保護。任何同時取得應用程式和完整 data 目錄的人都可能復原主密鑰。僅在理解並接受此風險時啟用。忘記的主密鑰仍無法僅靠重新下載或重裝 Navop 復原；只有先前已啟用此選項，並保留相符的完整應用程式和 data 副本時，才可能自動復原。

請獨立保管主密鑰，不要以明文形式放入便攜目錄或同一個 USB 隨身碟。data 中可能包含連線設定、狀態、擴充和快取，不要公開分享、提交到 Git，或放在不可信任的雲端同步目錄中。

更新便攜版

便攜模式不支援在應用程式內安裝更新，也不會執行自動更新檢查。仍可手動檢查以得知新版本，但確認更新時會開啟 GitHub Releases，需要自行下載新的 Windows -portable.zip。

不要將新版本直接覆蓋到仍在使用的舊目錄。建議依下列步驟升級：

儲存 SQL、Notes 和遠端檔案，提交或回復手動交易，並等待 SFTP、遠端編輯等工作完成。
完全結束 Navop。
備份舊便攜目錄，至少備份完整的 data 目錄。
下載符合目前架構的新 Windows -portable.zip，解壓縮到新的空目錄。
將舊版本的整個 data 目錄複製到新目錄，與新版 navop.exe 位於同一層。
確認新目錄中仍有與 navop.exe 同一層的 navop.portable。
啟動新版本並輸入原主密鑰，檢查版本、連線、擴充、Notes、主題與快捷鍵。
驗證完成後再刪除舊目錄；如需回退，可暫時保留舊目錄副本。

例如：

text

D:\Apps\
├── NavopPortable-old\
│   ├── navop.exe
│   ├── navop.portable
│   └── data\
└── NavopPortable-new\
    ├── navop.exe
    ├── navop.portable
    └── data\   ← 從舊版本複製

搬移、檔案關聯與安全

搬移便攜版前應完全結束 Navop，並確認交易、傳輸和遠端編輯工作已完成。通常可以搬移整個便攜目錄，但不要讓兩個 Navop 執行個體或兩台裝置同時寫入同一份 data。

便攜模式不會自動註冊 .db、.duckdb 和 .md 的 Windows 系統檔案關聯。仍可從 Navop 內開啟檔案，或使用 Windows「開啟方式」手動選擇 navop.exe；若搬移便攜目錄，手動建立的「開啟方式」路徑可能失效。需要穩定檔案關聯、開始功能表/桌面捷徑、應用程式內更新或由作業系統持久化主密鑰時，應選擇 .msi 或 EXE 安裝版。

移動媒體遺失可能暴露加密資料和相關中繼資料。搬到新裝置後仍需輸入正確主密鑰；驗證新副本可正常使用之前，不要刪除原目錄或備份。

進階啟動方式

官方 Windows -portable.zip 已包含 navop.portable，一般使用不需要額外參數。測試或自訂部署時，也可以透過下列方式啟用便攜模式或指定資料目錄：

powershell

# 暫時啟用便攜模式，預設使用 navop.exe 旁的 data 目錄
.\navop.exe --portable

# 指定資料目錄；此參數本身也會啟用便攜路徑模式
.\navop.exe --data-dir "E:\NavopData"

# 透過環境變數啟用便攜模式
$env:NAVOP_PORTABLE = "1"
.\navop.exe

# 透過環境變數指定資料目錄
$env:NAVOP_DATA_DIR = "E:\NavopData"
.\navop.exe

NAVOP_PORTABLE 支援 1、true、yes 或 on。資料目錄的選擇優先順序為 --data-dir、--portable、NAVOP_DATA_DIR、NAVOP_PORTABLE/navop.portable，最後才是一般安裝模式。指定的資料目錄必須可寫入；建議使用絕對路徑，因為相對路徑會按照啟動 Navop 時的目前工作目錄解析。

Linux 可攜版

navop-<version>-linux-x64-portable.tar.gz（ARM64 為 navop-<version>-linux-arm64-portable.tar.gz）與同架構的一般套件共用同一個執行檔，差別只在壓縮檔內多了一個 navop.portable 標記檔。Navop 啟動時若發現執行檔同層存在這個檔案，就會把資料目錄從系統使用者目錄改到程式旁的 data 目錄，因而能免安裝、整包搬移地執行：

bash

mkdir navop-portable
tar -xzf navop-<version>-linux-x64-portable.tar.gz -C navop-portable
cd navop-portable
./navop

text

navop-portable/
├── navop
├── navop.portable
└── data/          ← 首次啟動時自動建立
    ├── config/
    ├── state/
    └── cache/

請注意：

可攜版不含圖形相依套件。 與一般套件相同，繪圖堆疊仍由主機提供；缺少時依下文「Linux 圖形相依套件」補充安裝即可，兩者可搭配使用。
可攜模式不會註冊 .db、.duckdb、.md 的系統檔案關聯，也不支援應用程式內安裝更新或自動檢查更新；需要這些能力請改用 .deb、.rpm 或 AppImage。
可攜目錄必須可寫入，放在唯讀位置會導致啟動直接失敗。
可攜模式預設不記住主金鑰，每次啟動都需輸入；可在設定中開啟記住，金鑰同樣只保存在可攜目錄內。
搬移或備份時整包移動目錄即可，但要先完全結束 Navop，也不要讓兩個實例同時寫入同一份 data。

更新可攜版

可攜版沒有應用程式內更新。升級時把新版本的 -portable.tar.gz 解壓縮到新目錄，再把舊目錄的 data 整份複製過去：

bash

mkdir navop-portable-new
tar -xzf navop-<version>-linux-x64-portable.tar.gz -C navop-portable-new
cp -a navop-portable/data navop-portable-new/data

確認新目錄能正常啟動、連線與擴充都在之後，再刪除舊目錄。

進階啟動方式

官方 -portable.tar.gz 已包含 navop.portable，一般使用不需額外參數。除錯或自訂部署時，也可以用下列方式啟用可攜模式或指定資料目錄：

bash

# 臨時啟用可攜模式，預設使用 navop 旁的 data 目錄
./navop --portable

# 指定資料目錄；此參數本身也會啟用可攜路徑模式
./navop --data-dir /data/navop

# 透過環境變數啟用可攜模式
NAVOP_PORTABLE=1 ./navop

# 透過環境變數指定資料目錄
NAVOP_DATA_DIR=/data/navop ./navop

NAVOP_PORTABLE 支援 1、true、yes 或 on。資料目錄的選擇優先序為 --data-dir、--portable、NAVOP_DATA_DIR、NAVOP_PORTABLE/navop.portable，最後才是一般安裝模式。指定的資料目錄必須可寫入；相對路徑會依啟動 Navop 時的目前工作目錄解析。

Linux 圖形相依套件

Linux 版的 navop-<version>-linux-x64.tar.gz、.deb、.rpm 與 .AppImage 都只包含 Navop 本身。桌面環境通常已提供 Navop 需要的繪圖堆疊，不需要任何額外步驟。但精簡容器、最小化伺服器安裝、WSL 以及部分裁剪過的發行版可能缺少 Mesa 軟體渲染器或 EGL 客戶端函式庫，表現為啟動即結束，日誌中出現：

text

Failed to create surface: Failed to create surface for any enabled backend: {}

這種情況下再下載同一發佈頁面上的圖形相依套件（navop-<version>-linux-x64-gpu-stack.tar.gz 或 navop-<version>-linux-arm64-gpu-stack.tar.gz），解壓縮後執行隨附的安裝腳本：

bash

mkdir navop-gpu-stack
tar -xzf navop-<version>-linux-x64-gpu-stack.tar.gz -C navop-gpu-stack
sudo navop-gpu-stack/install.sh

安裝腳本是增量式的，只補齊系統目前解析不到的函式庫，因此可以搭配任何一種 Linux 安裝形態，也不需要設定任何環境變數：

系統已能解析某個 SONAME 時，該檔案會被跳過，主機自帶的版本一律優先；系統已具備可用的 EGL 與 DRI 驅動時，整個 Mesa 渲染器都會被跳過。
./install.sh --dry-run 可先印出即將安裝哪些檔案，./install.sh --force 會覆寫已存在的同名檔案。
相依檔案會放到動態載入器預設搜尋的目錄（/usr/lib64 等），Debian 系發行版會額外寫入 /etc/ld.so.conf.d/navop-gpu-stack.conf 並重新整理快取。
sudo ./install.sh --uninstall 只刪除該腳本實際寫入的檔案（記錄於 /usr/lib/navop-gpu-stack/installed.tsv），不會碰觸主機原有的函式庫；若某個檔案在安裝後被修改過，卸載時會保留並提示。卸載需要這個解壓縮目錄，想保留回復能力時就先不要刪除它。
套件內所有 .so 都依 glibc 2.28 基線建置，與 Linux 版 Navop 執行檔一致。

相依套件依 CPU 架構區分，必須下載與 Navop 套件相同的架構；架構不符時安裝腳本會直接報錯結束。安裝完成後重新啟動 Navop 即可。

Linux Flatpak

Navop 也在 FlatPark 上架為開發者認可的社群 Flatpak 軟體包。新增 FlatPark 軟體源並為目前使用者安裝：

bash

flatpak --user remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
flatpak --user install flatpark dev.navop.Navop

Flatpak 軟體包在沙盒中執行，部分整合功能可能需要額外權限。詳細說明與疑難排解請參閱 FlatPark 軟體包頁面。

首次啟動與權限

選擇語言、主題和啟動頁。資料庫、SSH、SFTP 與遠端桌面需要網路權限；本機網路、防火牆、鑰匙圈或檔案權限只按實際需求授予。Notes 目錄、外部編輯器和自訂字型需要各自的檔案存取權。

先建立不含正式憑證的測試連線。只有需要資料庫驅動、遠端桌面 Provider、匯入器或 ACP Agent 時才安裝相應擴充。

應用程式內更新與回退

MSI、EXE 安裝版與一般 ZIP 版可在設定開啟自動檢查，或手動檢查更新。更新前關閉活動連線，提交或回復手動交易並完成 SFTP 傳輸；重新啟動後測試重要連線、擴充與快捷鍵。Windows -portable.zip 與 Linux -portable.tar.gz 可攜版沒有應用程式內更新，請依照上方各自的獨立更新流程手動升級。

若新版本與關鍵擴充不相容，先備份 Navop 資料目錄，再從 Releases 安裝上一個穩定版。降版不能取代備份，因本機設定格式可能已變更。

系統檔案關聯

Navop 支援透過系統開啟 .db、.duckdb 和 .md。資料庫檔案會建立或開啟本機 SQLite/DuckDB 連線，Markdown 會進入 Notes。若未自動關聯，可在「開啟方式」選擇 Navop 並設為預設。

不要直接開啟仍被其他程式寫入的正式資料庫檔案，應先複製副本。外部 Markdown 的圖片與連結仍相對於原目錄，移動後需檢查資源路徑。

解除安裝與資料保留

移除應用程式本體通常不會自動刪除設定、加密連線、Notes 或擴充快取。重裝時保留資料目錄；徹底移除前先匯出必要資料、停止同步並完成團隊交接。

僅靠重裝無法復原忘記的主密鑰。若已啟用便攜主密鑰持久化，自動復原還需要相符的應用程式和完整 data 目錄，其中包括 data/state/key_storage。刪除本機資料前，確認主密鑰與團隊密鑰的安全備份狀態。

安裝、更新與檔案關聯 ​

下載與安裝 ​

安裝包選擇 ​

透過 Scoop 安裝（Windows） ​

Windows 安裝版 ​

Windows 免安裝 ZIP ​

從 v0.10.1 或更早版本的 Windows ZIP 升級 ​

Windows 便攜版 ​

解壓縮與首次啟動 ​

資料目錄與主密鑰 ​

更新便攜版 ​

搬移、檔案關聯與安全 ​

進階啟動方式 ​

Linux 可攜版 ​

更新可攜版 ​

進階啟動方式 ​

Linux 圖形相依套件 ​

Linux Flatpak ​

首次啟動與權限 ​

應用程式內更新與回退 ​

系統檔案關聯 ​

解除安裝與資料保留 ​

安裝、更新與檔案關聯

下載與安裝

安裝包選擇

透過 Scoop 安裝（Windows）

Windows 安裝版

Windows 免安裝 ZIP

從 v0.10.1 或更早版本的 Windows ZIP 升級

Windows 便攜版

解壓縮與首次啟動

資料目錄與主密鑰

更新便攜版

搬移、檔案關聯與安全

進階啟動方式

Linux 可攜版

更新可攜版

進階啟動方式

Linux 圖形相依套件

Linux Flatpak

首次啟動與權限

應用程式內更新與回退

系統檔案關聯

解除安裝與資料保留