文档偏好与维护
文档目录

关于与更新

版本信息、检查与安装更新、更新日志与版本历史、可选环境能力;更新下载自动开始,安装会等到没有 Agent 在运行。

更新于 2026年11月11日

「关于/更新」只有两类内容:当前 Proma 的版本,以及换到新版本的方式。有可用更新或环境有问题时,左导航的「关于/更新」会带一个红点。

关于 Proma

副标题「为专业用户设计的 Agent 桌面客户端」,下面是四行信息:

  • 版本:当前构建的版本号,开发模式下显示「开发模式」。
  • 运行时:Electron + React。
  • 开源协议:AGPL-3.0,并说明社区版基于该协议、商业授权可联系邮箱。
  • Proma 官网:proma.cool 。

更新

更新卡按状态切换文案与按钮:

状态标题按钮
空闲软件更新检查更新
检查中正在检查更新检查中(禁用)
发现新版本发现新版本前往下载(打开官网下载页)
下载中正在下载更新无,显示进度条与百分比
已下载更新已就绪空闲时更新
已排队已安排空闲时更新取消安排
已最新已是最新版本检查更新
失败更新暂时不可用检查更新

几点行为:

  • 发现新版本后下载会自动开始,不用点按钮。
  • 下载进度拿不到百分比时显示「正在连接下载」。
  • 只有「已下载」状态能排队安装;有 Agent 在运行时安装会退化为等空闲,退出前会再确认一次没有任务在运行。
  • 排队后描述变成「所有 Agent 完成后,将自动重启安装。」,此时按钮是「取消安排」。
  • 自动检查:启动后不久查一次,之后周期检查并带随机抖动;窗口重新激活、网络恢复时也会即时检查。
  • 下载完成的常驻提醒里有「稍后提醒」「空闲时更新」;「更新内容」会在外部浏览器打开更新日志页。
  • Linux 上没有应用内更新,更新卡整块不显示,走系统包管理器。

更新日志与版本历史

  • 有新版本且拿到了说明时,出现可折叠的「更新日志」,默认展开。
  • 「版本历史」卡最多显示三条,右上「刷新」。每行是版本号(缺失显示「未标注版本」)、「最新」标记和发布日期(缺失显示「未发布」),点开是 Markdown 格式的更新说明。
  • 版本历史为空时显示「暂无版本历史」,加载失败显示「加载失败」和后端错误。

可选环境能力

这一块替代了独立的「环境检测」弹窗,用来确认外部依赖是否齐备。

  • 可选环境能力:分别检查 Node.js 与 Git,按钮「重新检查」或「检测中...」。缺 Node.js 或版本偏低时给出安装与升级建议。
  • Windows 上还有一张「Shell 环境(Windows)」卡,检查 Git Bash 或 WSL 是否可用。

两项都不影响基础 Agent:没有 Node.js 只影响基于 npx 的 MCP 服务器,没有 Git Bash 或 WSL 只影响 Bash 命令工具。

注意

  • 更新会重启应用,正在运行的任务会在安装前等待;排队后不会立即安装,需要等到空闲。
  • 版本历史来自公开接口,网络不通时看到的是「加载失败」,与更新本身能不能用没有关系。
  • 没有稳定版与测试版渠道切换,也没有「导出诊断日志」的入口;排查问题靠这里的环境能力与应用日志。
  • 开源协议行只说明授权方式,不代表这个商业版可以自由分发,具体以授权条款为准。
本页内容