文档开始使用
文档目录

下载与安装

从下载页取对应平台的安装包;首次启动走一遍引导,完成后自动开一个「开始使用 Proma」会话,数据和配置都留在本机。

更新于 2026年11月11日

Proma 是装在本机的桌面应用,会话、配置、记忆和 Skills 都存在本地,不放在云端。安装包按平台分发,选对应平台即可。

下载 Proma

支持的平台

平台安装包架构最低要求
macOSdmgApple 芯片、Intel—
Windows安装程序(setup.exe)x64—
Linuxdebx64Ubuntu 22.04 起

Linux 只提供 Debian 包,其他发行版需要自行转换或使用源码构建。

安装

  • macOS:打开 dmg,把 Proma 拖进「应用程序」。
  • Windows:安装程序允许改安装目录,默认创建桌面和开始菜单快捷方式。
  • Linux:用系统包管理器安装 deb;安装脚本会配置沙箱权限,这一步缺失会导致应用无法启动。

首次启动

  1. 登录:商业版需要登录 Proma 账号才能使用官方渠道,不需要自己填 API Key。
  2. 引导:依次介绍 Agent 入门、项目、文件、子会话、自动任务、记忆、选区引用,最后是一页按主题分组的 FAQ。进阶章节有「跳过进阶篇」,之后仍可从「设置 → Proma 新手引导」重看。
  3. 第一个会话:引导完成后自动创建一个标题为「开始使用 Proma」的会话,并已代你发出第一条消息,内容为欢迎语和一个提问——你希望完成的第一件事;直接回答即可开始。

引导中涉及的概念在文档里各有专页,可按页面标题查找。

数据位置

所有本地数据在用户目录下的 .proma 文件夹:会话记录、工作区配置、记忆、Skills、MCP 配置和附件都在里面。

  • 覆盖安装会继承这个目录,数据不会丢。
  • 想搬到另一台机器,走「设置 → 数据迁移」,不要直接拷运行中的目录。

更新

应用会定期检查更新,左下角出现更新入口时点击即可;也可以在「设置 → 关于/更新」里手动检查。Linux 上不提供应用内更新,用包管理器升级。

注意

  • Proma 同一时间只运行一个实例:再次启动会唤起已有窗口,不会开出第二份去抢同一批会话文件。
  • 登录是使用官方渠道的前提;没登录时主界面不会进入,不是配置问题。
  • 引导只会自动出现一次,跳过之后不会再次自动出现,需要时在设置里重放。
  • Windows 安装程序不是静默安装:中途可以修改路径,也可以取消。
本页内容