桌面应用
更新与版本管理
自动更新检查 + 手动下载兜底；如何回退到旧版本。
更新机制总览
Kition 桌面端通过 electron-updater 与官方签名的 update feed 通信。检查到新版本后，安装包会先下载到本地缓存，再在下一次退出时安静地替换 — 你不会被弹窗打断当前的写作或 Agent 对话。
所有更新都使用 EV 代码签名（macOS notarized、Windows Authenticode），下载完成后会校验签名和 SHA-256；任何一步失败都会自动丢弃产物并退回到当前版本。
更新通道
我们维护两个通道：stable 与 beta。默认是 stable；想抢先尝试新功能可以在 Settings → Updates 切到 beta。同一个 Vault 在两个通道之间来回切换是安全的，数据格式向后兼容。
stable— 大约每 2-3 周一个版本，所有用户默认通道beta— 每周一次，可能包含未完成的功能开关- 通道切换在 Settings → Updates → Channel，立即生效
- 想关掉自动下载但保留检查 → 同一页面切 "Check only"
手动检查与离线安装
如果机器长期离线，或者你的网络拦截了 update feed，可以直接到官网下载页拿安装包。安装新包不需要先卸载旧版 — 安装器会原地升级并保留所有配置。
# macOS — verify the downloaded .dmg signature before installing
spctl --assess --type install --verbose Kition-x.y.z.dmg
# Windows PowerShell — verify the installer signature
Get-AuthenticodeSignature .\Kition-Setup-x.y.z.exe | Format-List回退到旧版本
- 官网
/download/history列出最近的稳定版与 beta 版 - 安装旧版会保留 Vault — 数据格式向后兼容
- 想阻止下次自动升回最新版，在 Settings → Updates 关掉 "Auto-download"
- 回退后如果索引看起来不对，跑一次 Settings → Maintenance → Rebuild local index
- 出错时可在 Settings → "Open log folder" 抓日志反馈给支持
常见问题
企业网络环境下 update feed 可能被代理拦截 — 表现为 "Check for updates" 一直转圈但无报错。这时候请把 https://update.kition.app 加到白名单，或者改用手动安装。
macOS 上如果应用是从 Setapp 等第三方分发渠道安装的，自动更新由分发方接管，Settings 里的更新选项会被禁用。
Windows 上如果你装在非默认目录（比如 D 盘），更新会保持原路径不变；但需要确认当前用户对该目录有写入权限，否则后台替换会失败并回滚。
版本号约定
Kition 使用语义化版本：MAJOR.MINOR.PATCH。Major 版本之间会引入新功能并可能调整 Pro license 的覆盖范围；minor 版本完全兼容，patch 仅修复缺陷。
版本号显示在 Settings → About，也可以在终端里通过运行的可执行文件直接拿到 — 反馈问题时附带版本号会大大加快定位。
# macOS — print the bundled version
defaults read /Applications/Kition.app/Contents/Info CFBundleShortVersionString
# Windows PowerShell — print the installed version
(Get-Item "$env:LOCALAPPDATA\Programs\Kition\Kition.exe").VersionInfo.ProductVersion