桌面版安裝

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

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

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 套件：

bash

# Using yay
yay -S mindwtr

# Using paru
paru -S mindwtr

AUR 套件：mindwtr

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
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（通用）

可在大多數 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 安裝。

Winget

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

powershell

winget install dongdongbh.Mindwtr

Chocolatey

若使用 Chocolatey：

powershell

choco install mindwtr

Chocolatey 套件

Scoop

若使用 Scoop：

powershell

scoop bucket add mindwtr https://github.com/dongdongbh/homebrew-mindwtr
scoop install mindwtr

安裝程式（.msi 或 .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 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 啟動

資料位置

安裝後，資料會儲存於：

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

Flatpak 安裝使用 ~/.var/app/tech.dongdongbh.mindwtr/ 下的沙盒 XDG 路徑。你隨時可以在設定 → 同步 → 本機資料中查看目前使用的確切路徑。

設定另外儲存於：

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

更新

更新檢查會辨識發行管道：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，從原始碼建置） ​

Debian / Ubuntu ​

Fedora / RHEL / openSUSE ​

Flatpak（Flathub） ​

Snap Store ​

AppImage（通用） ​

其他發行版 ​

Windows ​

Microsoft Store（建議） ​

Winget ​

Chocolatey ​

Scoop ​

安裝程式（.msi 或 .exe） ​

可攜式版本 ​

macOS ​

Mac App Store（建議） ​

TestFlight 測試版 ​

Homebrew ​

磁碟映像檔（.dmg） ​

資料位置 ​

更新 ​

解除安裝 ​

Linux（套件管理器） ​

Windows ​

macOS ​

清除資料 ​

疑難排解 ​

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

圖示缺失 ​

空白視窗 ​

另請參閱 ​

桌面版安裝

Linux

Arch Linux（AUR，預先建置）

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

Debian / Ubuntu

Fedora / RHEL / openSUSE

Flatpak（Flathub）

Snap Store

AppImage（通用）

其他發行版

Windows

Microsoft Store（建議）

Winget

Chocolatey

Scoop

安裝程式（.msi 或 .exe）

可攜式版本

macOS

Mac App Store（建議）

TestFlight 測試版

Homebrew

磁碟映像檔（.dmg）

資料位置

更新

解除安裝

Linux（套件管理器）

Windows

macOS

清除資料

疑難排解

應用程式無法啟動（Linux）

圖示缺失

空白視窗

另請參閱