更新、升级与卸载

这一节讲三件事：把桌面 App 升到新版本、单独升级后端命令行（CLI），以及彻底卸载。升级时你的邮件数据库不会被动，所以升级后不用重新初始化、也不用重走配置向导。

升级桌面 App

方式一：应用内更新（最省事）

App 启动约 10 秒后会自动检查一次更新；有新版本时状态栏右下会提示 更新就绪。
进 设置 → 应用更新，点 下载更新。
下完点 重启并安装，App 自动重启完成升级。

方式二：手动升级（最可靠）

到 GitHub Releases 下载最新版本的 App，然后严格按顺序、一步做完再做下一步：

# 1. 退出旧版 App
osascript -e 'tell application "MailAgent" to quit'

# 2. 用新版替换 /Applications 里的旧版（等它完全结束）
ditto ~/Downloads/MailAgent.app /Applications/MailAgent.app

# 3. 替换完成后再打开
open /Applications/MailAgent.app

升级后第一次启动：

跳过配置向导 —— 你的设置和数据都在，App 会识别为”已配置”直接进主界面；
后端如需数据库结构升级，会在启动时自动迁移，无需你干预。

单独升级后端 CLI

如果你只想更新命令行后端（不动桌面 App）：

cd ~/Documents/MailAgent
git pull
source venv/bin/activate
pip install -e ".[cli]" --upgrade
pm2 restart mail-sync

升级后用 mailagent --version 确认版本，并看一眼 pm2 logs mail-sync --lines 20 --nostream 启动日志里没有报错。

彻底卸载

# 1. 退出 App
osascript -e 'tell application "MailAgent" to quit'

# 2. 删掉 App
rm -rf /Applications/MailAgent.app

# 3. 清前端独立数据（AI 对话历史 + 应用内设置）
rm -rf ~/.mailagent/frontend/
rm -rf ~/Library/Application\ Support/MailAgent/

# 4. 清钥匙串里的 3 个密钥
security delete-generic-password -s mailagent-cli-api-key 2>/dev/null || true
security delete-generic-password -s mailagent-llm-api-key 2>/dev/null || true
security delete-generic-password -s mailagent-custom-api-key 2>/dev/null || true

如果你连后端和邮件归档一起不要了，再加这一步：

# 5.（可选）停后端 + 删整个仓库（连同 6 万封邮件的本地数据库一起没了）
pm2 stop mail-sync && pm2 delete mail-sync
rm -rf ~/Documents/MailAgent

只想重置、不想卸载

如果只是配置乱了、想从头配一遍（但保留邮件数据库），做上面的第 3、4 步即可。

常见疑问

升级后启动崩溃 / 报缺库？ 多半是手动替换时三步抢跑导致 App 包损坏，删掉 /Applications/MailAgent.app 重新完整替换一次。
升级后设置没了？ 正常情况设置会保留；若确实丢了，参见首次配置重配一遍。
改了后端 Python 代码后桌面 App 没生效？ 桌面 App 内嵌的是打包时的后端，需要重新打包才进包；只改前端界面则不用。