下载与安装
从下载页取对应平台的安装包;首次启动走一遍引导,完成后自动开一个「开始使用 Proma」会话,数据和配置都留在本机。
更新于 2026年11月11日
Proma 是装在本机的桌面应用,会话、配置、记忆和 Skills 都存在本地,不放在云端。安装包按平台分发,选对应平台即可。
支持的平台
| 平台 | 安装包 | 架构 | 最低要求 |
|---|---|---|---|
| macOS | dmg | Apple 芯片、Intel | — |
| Windows | 安装程序(setup.exe) | x64 | — |
| Linux | deb | x64 | Ubuntu 22.04 起 |
Linux 只提供 Debian 包,其他发行版需要自行转换或使用源码构建。
安装
- macOS:打开 dmg,把 Proma 拖进「应用程序」。
- Windows:安装程序允许改安装目录,默认创建桌面和开始菜单快捷方式。
- Linux:用系统包管理器安装 deb;安装脚本会配置沙箱权限,这一步缺失会导致应用无法启动。
首次启动
- 登录:商业版需要登录 Proma 账号才能使用官方渠道,不需要自己填 API Key。
- 引导:依次介绍 Agent 入门、项目、文件、子会话、自动任务、记忆、选区引用,最后是一页按主题分组的 FAQ。进阶章节有「跳过进阶篇」,之后仍可从「设置 → Proma 新手引导」重看。
- 第一个会话:引导完成后自动创建一个标题为「开始使用 Proma」的会话,并已代你发出第一条消息,内容为欢迎语和一个提问——你希望完成的第一件事;直接回答即可开始。
引导中涉及的概念在文档里各有专页,可按页面标题查找。
数据位置
所有本地数据在用户目录下的 .proma 文件夹:会话记录、工作区配置、记忆、Skills、MCP 配置和附件都在里面。
- 覆盖安装会继承这个目录,数据不会丢。
- 想搬到另一台机器,走「设置 → 数据迁移」,不要直接拷运行中的目录。
更新
应用会定期检查更新,左下角出现更新入口时点击即可;也可以在「设置 → 关于/更新」里手动检查。Linux 上不提供应用内更新,用包管理器升级。
注意
- Proma 同一时间只运行一个实例:再次启动会唤起已有窗口,不会开出第二份去抢同一批会话文件。
- 登录是使用官方渠道的前提;没登录时主界面不会进入,不是配置问题。
- 引导只会自动出现一次,跳过之后不会再次自动出现,需要时在设置里重放。
- Windows 安装程序不是静默安装:中途可以修改路径,也可以取消。