dootask/resources/ai-kb/zh/howto/electron-client/update.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
electron-client.update.howto	升级桌面端	howto	electron-client	end-user	zh	桌面端升级 客户端更新 怎么升级桌面端 升级新版本 自动更新 手动更新 桌面端有新版本				自动更新需要服务器侧配置了更新源(electron-updater feed URL),否则只能手动 自动更新下载完成后必须重启 App 才生效,不会热替换 客户端版本独立于服务器主程序版本,两者各有发布节奏	v1.7.90

升级桌面端

升级方式概览

桌面端基于 electron-updater,支持「自动检查 + 手动确认下载 + 退出时安装」三段流程,也允许完全手动重装。

自动更新(推荐)

默认情况下:

1. App 启动后向更新源查询是否有新版
2. 有新版会在系统通知或客户端右上角提示「发现新版本」
3. 用户点「立即下载」开始下载(默认不自动下载,避免占带宽)
4. 下载完成后弹窗提示「是否立即重启安装」
5. 选「重启」立即装并重开;选「稍后」会在下次退出时自动装

手动检查更新

• 客户端菜单 → 「检查更新」(macOS 通常在「DooTask」菜单,Windows 通常在右上角菜单)
• 客户端右上角头像 → 「关于 DooTask」→「检查更新」

完全手动升级

当自动更新源不可达(企业内网封了 GitHub):

1. 从 electron-client.download.howto 中提到的渠道下载新版安装包
2. macOS:直接覆盖拖到 Applications,会替换旧版本
3. Windows:运行新版安装程序,会自动覆盖
4. Linux:sudo dpkg -i(deb)或 sudo rpm -Uvh(rpm)

看当前版本

• macOS:菜单 → 「DooTask」→「关于 DooTask」
• Windows / Linux:右上角头像下拉 → 「关于 DooTask」
• 个人设置页底部也会显示

升级后数据

• 配置 / 登录态保留(存放在 electron-store 用户目录)
• 不会覆盖个人聊天记录、文件(本地无业务数据,都在服务器)

不支持

• 不支持「跨大版本回退」(降级需手动重装旧包,不保证账号兼容)
• 不支持「不重启热更新」
• 自动更新失败不会反复重试,需手动再点检查