桌面端安装

所有桌面平台的详细安装说明。

有关候选发布版和测试版构建，请参阅加入测试版渠道。

Linux

Arch Linux（AUR，预构建）

在基于 Arch 的发行版上，最简单的安装方式是使用预构建 AUR 软件包：

bash

# 使用 yay
yay -S mindwtr-bin

# 使用 paru
paru -S mindwtr-bin

# 使用 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

# 从以下地址下载带版本号的 AppImage：
# https://github.com/dongdongbh/Mindwtr/releases/latest

# 添加可执行权限
chmod +x Mindwtr-*.AppImage

# 运行
./Mindwtr-*.AppImage

提示：使用 AppImageLauncher 可获得更好的桌面集成体验。

其他发行版

对于其他发行版，请使用 AppImage 或从源码构建（参阅开发者指南）。

欢迎社区维护软件包（例如适用于 NixOS 的 nixpkgs）。桌面构建自带 TLS 依赖，因此打包时无需匹配系统 OpenSSL。如果你维护此类软件包，请发起讨论，以便在此处添加链接。

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 数据库、同步 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 拖到 Applications 文件夹
从 Applications 或 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 数据库	同步 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 都可以提供清单，且更新由 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 从 Applications 拖到废纸篓。

清理数据

要删除所有数据，请同时删除配置目录和数据目录：

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）

图标缺失

窗口空白

另请参阅