桌面版安裝

各桌面平台的詳細安裝說明。

若要使用候選發行版與測試版組建，請參閱加入測試版管道。

Linux

Arch Linux（AUR，預先建置）

在 Arch 系列發行版上，最簡單的安裝方式是使用預先建置的 AUR 套件：

bash

# Using yay
yay -S mindwtr-bin

# Using paru
paru -S mindwtr-bin

# Using pamac (Manjaro)
pamac install mindwtr-bin

AUR 套件：mindwtr-bin

Arch Linux（AUR，從原始碼建置）

AUR 上另有一個從原始碼建置的套件 mindwtr。它由社群維護，並非由 Mindwtr 專案維護，也不屬於 Mindwtr 的發行流程。除非你需要在本機建置，否則請使用 mindwtr-bin。

驗證官方 AUR 套件

Mindwtr 目前發行兩個 AUR 套件識別：mindwtr-bin（穩定版預先建置套件）與 mindwtr-beta-bin（預發行版）。第三個名稱 mindwtr-bin-beta 是舊的測試版識別，在更名過渡期間仍會使用同一批已簽署的發行成品更新。套件來源必須指向 github.com/dongdongbh/Mindwtr，維護者必須是 dongdongbh。建置前請檢查 PKGBUILD 與 .SRCINFO 的每項變更。新的發行校驗和資訊清單使用指紋為 0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D 的金鑰簽署。

Debian / Ubuntu

加入 APT 儲存庫（建議）：

bash

curl -fsSL https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/mindwtr-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mindwtr-archive-keyring.gpg] https://dongdongbh.github.io/Mindwtr/deb ./" | sudo tee /etc/apt/sources.list.d/mindwtr.list
sudo apt update
sudo apt install mindwtr

手動安裝：從 GitHub Releases 下載 .deb，再執行 sudo dpkg -i mindwtr_*.deb。

Fedora / RHEL / openSUSE

加入 DNF/YUM 儲存庫（建議）：

bash

cat <<'EOF' | sudo tee /etc/yum.repos.d/mindwtr.repo
[mindwtr]
name=Mindwtr Repository
baseurl=https://dongdongbh.github.io/Mindwtr/rpm
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key
EOF

sudo dnf install mindwtr

手動安裝：從 GitHub Releases 下載 .rpm，再執行 sudo rpm -i mindwtr-*.rpm。

Flatpak（Flathub）

從 Flathub 安裝：

bash

flatpak install flathub tech.dongdongbh.mindwtr

啟動方式：

bash

flatpak run tech.dongdongbh.mindwtr

Flathub 頁面

Snap Store

從 Snap Store 安裝：

bash

sudo snap install mindwtr

Snap Store 頁面

AppImage（通用）

AppImage 應用程式目錄

可在大多數 Linux 發行版上運作：

bash

# Download the versioned AppImage from:
# https://github.com/dongdongbh/Mindwtr/releases/latest

# Make executable
chmod +x Mindwtr-*.AppImage

# Run
./Mindwtr-*.AppImage

提示：使用 AppImageLauncher 可獲得更好的桌面整合。

其他發行版

其他發行版請使用 AppImage，或從原始碼建置（請參閱開發者指南）。

歡迎提供社群維護的套件（例如 NixOS 的 nixpkgs）。桌面組建已隨附其 TLS 相依套件，因此封裝時不必符合系統的 OpenSSL 版本。如果你在維護套件，請提出 discussion，讓我們能在此加入連結。

Windows

Microsoft Store（建議）

從 Microsoft Store 安裝。

Microsoft Store 測試版

你可以在現有商店安裝上測試候選版本。請將商店中使用的 Microsoft 帳號信箱寄至 [email protected]，或在測試版討論中留言，我會將你加入 Mindwtr Beta。加入群組且測試套件發布後，在 Microsoft Store → 媒體櫃中檢查更新。請保留現有安裝，以保留任務與附件。加入和退出的說明請參閱加入 Beta 管道。

Winget

Windows 10 與 11 已內建 Winget。使用以下命令安裝 Mindwtr：

powershell

winget install dongdongbh.Mindwtr

Chocolatey

若使用 Chocolatey：

powershell

choco install mindwtr

Chocolatey 套件

Scoop

若使用 Scoop：

powershell

scoop bucket add extras
scoop install extras/mindwtr

安裝程式（.exe）

從 GitHub Releases 下載安裝程式
執行安裝程式
依照安裝精靈操作
從「開始」功能表啟動 Mindwtr

可攜式版本

從 GitHub Releases 下載 mindwtr_<version>_windows_x64_portable.zip。
解壓縮至任何可寫入的資料夾。
將 portable.txt 保留在 mindwtr.exe 旁。

可攜式模式會將本機狀態儲存在執行檔旁：

profile/data/：SQLite DB、同步 JSON、附件、日誌、快照、音訊收集內容與語音模型
profile/config/：config.toml 與 secrets.toml
profile/webview/：WebView2 瀏覽器設定檔（快取、本機儲存空間）

在 Windows 上於可攜版與安裝版之間搬移。 從 v1.3.2 起，安裝版在 %APPDATA%\mindwtr 下也使用同樣的 config\ 和 data\ 結構，所以可攜版的兩個子資料夾可以直接複製過去；WebView2 設定檔位於 %LOCALAPPDATA%\tech.dongdongbh.mindwtr。複製前請先關閉兩邊的 Mindwtr。

可攜版	安裝版
`profile\data\`（`mindwtr.db`、`data.json`、`attachments\`、記錄、快照）	`%APPDATA%\mindwtr\data\`
`profile\config\config.toml`	`%APPDATA%\mindwtr\config\config.toml`
`profile\config\secrets.toml`	沒有對應檔案：安裝版把密鑰存在 Windows 認證管理員中，搬移後需要重新輸入同步密語、Dropbox 登入或 API 金鑰
`profile\webview\`	`%LOCALAPPDATA%\tech.dongdongbh.mindwtr\`（只是快取，可以不複製）

仍須安裝 Windows WebView2。v1.1.0 以前的可攜式組建若曾將附件存於 AppData\Roaming\mindwtr，第一次啟動時會將附件移至可攜式設定檔；如果同一部電腦也安裝了 Mindwtr，附件則會改為複製，讓兩種安裝都能繼續運作。

macOS

Mac App Store（建議）

從 Mac App Store 安裝：

Mac App Store 上的 Mindwtr

若想使用由商店管理的更新與經簽署的 App Store 組建，請選擇此方式。

TestFlight 測試版

透過 TestFlight 加入 macOS 測試版：

Mindwtr TestFlight 測試版

其他測試版管道與退出方式，請參閱加入測試版管道。

Homebrew

使用 Homebrew 安裝：

bash

brew install --cask mindwtr

磁碟映像檔（.dmg）

從 GitHub Releases 下載 .dmg
開啟磁碟映像檔
將 Mindwtr 拖入「應用程式」資料夾
從「應用程式」或 Spotlight 啟動

驗證下載檔案

每個 GitHub 發布版本都包含一份 SHA256SUMS 校驗和清單以及覆蓋它的分離式 PGP 簽章 SHA256SUMS.asc。它們與 APT 和 RPM 儲存庫使用同一把金鑰簽署，金鑰發布於 https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key：

金鑰：Mindwtr Bot（RSA 4096）
指紋：0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D

同一金鑰也發佈在獨立於 GitHub 基礎設施的 keys.openpgp.org 金鑰伺服器上——請從兩個來源分別取得，並確認兩者顯示的指紋與上文一致。

bash

# Import the signing key
curl -fsSL https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key | gpg --import

# Or fetch it from the keys.openpgp.org keyserver (independent second source)
gpg --keyserver hkps://keys.openpgp.org --recv-keys 0358999BBE704F588B9094979E553245CB17047D

# Verify the manifest signature
gpg --verify SHA256SUMS.asc SHA256SUMS

# Check the file you downloaded against the manifest
sha256sum --check --ignore-missing SHA256SUMS

gpg --verify 必須回報來自上述指紋的有效簽章。在 macOS 上，校驗和步驟請使用 shasum -a 256 --check --ignore-missing SHA256SUMS。

資料位置

安裝後，資料會儲存於：

平台	SQLite DB	同步 JSON
Linux	`~/.local/share/mindwtr/mindwtr.db`	`~/.local/share/mindwtr/data.json`
Windows	`%APPDATA%/mindwtr/data/mindwtr.db`	`%APPDATA%/mindwtr/data/data.json`
macOS	`~/Library/Application Support/mindwtr/data/mindwtr.db`	`~/Library/Application Support/mindwtr/data/data.json`

Flatpak 安裝使用 ~/.var/app/tech.dongdongbh.mindwtr/ 下的沙盒 XDG 路徑。資料庫位於 ~/.var/app/tech.dongdongbh.mindwtr/data/mindwtr/mindwtr.db。

設定另外儲存於：

平台	位置
Linux	`~/.config/mindwtr/config.toml`
Windows	`%APPDATA%/mindwtr/config/config.toml`
macOS	`~/Library/Application Support/mindwtr/config/config.toml`

v1.3.2 之前，Windows 和 macOS 把這些檔案都直接放在 mindwtr 資料夾裡。v1.3.2 首次啟動時會把它們移到 config/ 和 data/ 中，資料夾裡的其他內容不會被更動。之後不支援退回舊版本：舊版本只會在原來的位置尋找。

更新

更新檢查會辨識發行管道：Mindwtr 會偵測安裝方式、比對該管道發布的版本，再引導你採用該管道的更新方式。

Microsoft Store、Winget、Chocolatey、Homebrew、AUR：只有你的管道已有新版本時，才會顯示更新提醒；請照常使用套件管理器更新（例如 winget upgrade dongdongbh.Mindwtr、choco upgrade mindwtr、brew upgrade --cask mindwtr）。
Scoop：Mindwtr 完全不會自動檢查更新，因為任何 bucket 都可能提供 manifest，且更新由 Scoop 負責（scoop update mindwtr）。仍可在「設定 → 關於」中手動檢查。
Flatpak、Snap 與應用程式商店的自動更新：更新會自動送達，因此 Mindwtr 不會顯示提醒。
直接下載、可攜式版本、AppImage、.deb/.rpm：請在「設定 → 關於 → 檢查更新」中檢查，再從 Releases 下載新版本，覆蓋現有安裝。

更新時會保留你的資料。

解除安裝

Linux（套件管理器）

bash

# AUR
yay -R mindwtr-bin

# Debian/Ubuntu
sudo dpkg -r mindwtr

# Flatpak
flatpak uninstall tech.dongdongbh.mindwtr

Windows

使用 Windows 設定中的「新增或移除程式」。

macOS

將「應用程式」中的 Mindwtr 拖入垃圾桶。

清除資料

若要移除所有資料，請刪除設定與資料目錄：

bash

# Linux
rm -rf ~/.config/mindwtr
rm -rf ~/.local/share/mindwtr

# macOS
rm -rf ~/Library/Application\ Support/mindwtr

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:APPDATA\\mindwtr"

疑難排解

應用程式無法啟動（Linux）

請確認已安裝 WebKitGTK：

bash

# Arch
sudo pacman -S webkit2gtk-4.1

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-0

圖示缺失

請安裝完整的圖示主題：

bash

sudo pacman -S papirus-icon-theme

空白視窗

嘗試停用 GPU 後執行：

bash

WEBKIT_DISABLE_DMABUF_RENDERER=1 mindwtr

桌面版安裝 ​

Linux ​

Arch Linux（AUR，預先建置） ​

Arch Linux（AUR，從原始碼建置） ​

驗證官方 AUR 套件 ​

Debian / Ubuntu ​

Fedora / RHEL / openSUSE ​

Flatpak（Flathub） ​

Snap Store ​

AppImage（通用） ​

其他發行版 ​

Windows ​

Microsoft Store（建議） ​

Microsoft Store 測試版 ​

Winget ​

Chocolatey ​

Scoop ​

安裝程式（.exe） ​

可攜式版本 ​

macOS ​

Mac App Store（建議） ​

TestFlight 測試版 ​

Homebrew ​

磁碟映像檔（.dmg） ​

驗證下載檔案 ​

資料位置 ​

更新 ​

解除安裝 ​

Linux（套件管理器） ​

Windows ​

macOS ​

清除資料 ​

疑難排解 ​

應用程式無法啟動（Linux） ​

圖示缺失 ​

空白視窗 ​

另請參閱 ​

桌面版安裝

Linux

Arch Linux（AUR，預先建置）

Arch Linux（AUR，從原始碼建置）

驗證官方 AUR 套件

Debian / Ubuntu

Fedora / RHEL / openSUSE

Flatpak（Flathub）

Snap Store

AppImage（通用）

其他發行版

Windows

Microsoft Store（建議）

Microsoft Store 測試版

Winget

Chocolatey

Scoop

安裝程式（.exe）

可攜式版本

macOS

Mac App Store（建議）

TestFlight 測試版

Homebrew

磁碟映像檔（.dmg）

驗證下載檔案

資料位置

更新

解除安裝

Linux（套件管理器）

Windows

macOS

清除資料

疑難排解

應用程式無法啟動（Linux）

圖示缺失

空白視窗

另請參閱