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