Proma：本地优先的AI Agent工作台，重塑专业工作流自动化

【免费下载链接】Proma Proma brings a seamless general-purpose Agent experience to your workflow. Built for 100× professionals and the proactive Agent era, it supports Claude and Pi runtimes, Feishu group chats, and any LLM provider. 项目地址: https://gitcode.com/gh_mirrors/pro/Proma

Proma是一款为专业用户设计的本地优先AI Agent桌面应用，将多模型对话、通用Agent能力、工作区管理、Skills扩展和MCP集成统一在一个开源客户端中。作为面向100倍效率提升的专业工具，Proma不仅提供智能对话功能，更通过Agent工作流、主动协作系统和可扩展架构，帮助用户建立长期可持续的AI辅助工作环境。

核心理念：从对话工具到工作流伙伴

Proma的设计理念超越了传统的聊天机器人范式，致力于构建一个能够真正理解并参与复杂工作流程的智能伙伴。其核心价值体现在三个层面：本地优先的数据主权、工作区隔离的上下文管理、以及可扩展的Skill生态系统。

Proma Agent工作台：左侧导航管理多个工作区，中间区域展示任务分解与执行过程，右侧文件面板保留可复用输出

本地优先架构设计

Proma采用彻底的本地优先策略，所有会话数据、工作区配置、Skills定义和附件文件都存储在用户本地目录~/.proma/中，使用JSON/JSONL格式组织，无需依赖远程数据库。这种设计确保了数据隐私和安全，同时支持离线工作模式。架构上，Proma通过apps/electron/src/main/lib/实现核心运行时逻辑，包括Agent编排、权限管理和资源调度。

双运行时内核支持

Proma内置Claude Agent SDK与Pi Agent SDK两套运行时引擎，用户可根据任务需求灵活切换。Claude运行时提供完整的Agent工作流支持，包括计划制定、文件操作和长任务执行；Pi运行时则专注于轻量级任务和快速响应。这种双内核设计让用户在不同场景下都能获得最佳体验。

架构解析：模块化与可扩展性

核心组件架构

Proma的架构采用分层设计，从底层运行时到上层用户界面都有清晰的职责划分：

1. 运行时层：基于Claude Agent SDK构建的apps/electron/src/main/lib/adapters/适配器系统，支持多种AI供应商和协议
2. 工作区层：通过apps/electron/src/main/lib/agent-workspace-manager.ts实现隔离的上下文环境，每个工作区可独立配置Skills和MCP Server
3. 技能层：模块化的Skill系统位于apps/electron/default-skills/，支持用户自定义和社区共享
4. 界面层：基于Electron的现代UI框架，提供直观的三栏式工作界面

主动协作系统设计

Proma正在向主动Agent阶段演进，其Proactive Center设计文档docs/proactive-scheduler-monitor-design.md详细阐述了从被动响应到主动协作的架构转型。系统包含以下几个关键组件：

• SchedulerService：负责定时任务的调度与管理
• MonitorService：监控外部事件并触发相应工作流
• RecommendationService：基于用户行为模式智能推荐自动化任务
• ApprovalService：确保所有自动化操作都经过用户确认

权限与安全模型

Proma采用细粒度的权限控制系统，每个自动化任务都绑定特定的权限档案。通过apps/electron/src/main/lib/agent-permission-service.ts实现，确保Agent操作在用户可控范围内进行。关键权限级别包括：

• 只读权限：仅允许读取文件和上下文
• 内存写入权限：可写入长期记忆，但需确认
• 文件写入权限：可修改工作区文件，需明确授权
• 命令执行权限：可运行Shell命令，需高级别授权

应用场景：从日常协作到专业工作流

技术文档协作

Chat模式快速分析：整理读者关注点、生成对比表，并将首屏文案快速定稿

Proma在技术文档协作中表现出色，通过Chat模式快速处理轻量级分析任务。用户可上传Markdown、CSV、PDF等格式文档，系统自动解析内容并生成结构化摘要。对于复杂的技术文档编写，Agent模式能够基于现有代码库和文档模板，自动生成符合规范的API文档、用户指南和发布说明。

代码审查与重构

开发者可使用Proma进行代码质量分析、架构审查和自动化重构。系统通过apps/electron/default-skills/中的代码分析Skills，结合Git历史和工作区上下文，提供智能的代码改进建议。Agent能够理解代码语义，识别潜在的性能问题、安全漏洞和架构缺陷。

项目管理与进度跟踪

Proma的Proactive Center设计支持项目管理自动化。系统可监控Git提交、Issue状态、CI/CD流水线等关键指标，自动生成进度报告和风险预警。通过apps/electron/src/main/lib/automation-scheduler.ts实现的定时任务系统，能够定期整理项目状态，提醒团队成员关注重要事项。

跨平台团队协作

Skills配置界面：每个工作区可独立管理专用Skills，如feedback-synthesis用于聚合用户反馈、访谈记录和issue

Proma原生支持飞书/Lark机器人桥接，并预留了钉钉、微信桥接入口。这使得团队可以通过群聊触发本机Agent工作流，实现跨平台的智能协作。通过apps/electron/src/main/lib/feishu-bridge.ts和apps/electron/src/main/lib/dingtalk-bridge.ts，企业用户能够将Proma集成到现有的协作工具中。

部署指南：从安装到高级配置

环境要求与安装

Proma支持macOS（Apple Silicon和Intel）和Windows平台。安装过程简单直接：

# 从GitHub Releases下载最新版本
# 或使用商业版获取开箱即用体验

系统要求包括Git、Node.js/Bun运行时环境，以及可用的Shell环境。首次启动时，Proma会自动进行环境检查，确保Agent模式所需的基础组件完整可用。

渠道配置要点

进入设置 > 渠道页面，配置AI供应商连接：

1. OpenAI兼容渠道：支持Chat模式对话
2. Anthropic兼容渠道：支持Claude Agent运行时
3. 通用API渠道：支持Pi Agent运行时

关键配置参数包括Base URL、API密钥和模型列表。建议至少配置两个不同供应商的渠道以确保服务冗余。

工作区与Skills配置

每个项目或任务类型应创建独立的工作区：

1. 在Agent模式下创建新工作区
2. 通过apps/electron/default-skills/导入或创建专用Skills
3. 配置MCP Server连接，如文件系统、Git、数据库等
4. 设置工作区特定的权限档案

自动化任务设置

基于Proactive Center设计，用户可以配置多种自动化任务：

# 示例：每日记忆整理任务配置
schedule:
  type: daily
  time: "23:30"
routine: proma-memory:memory-daily
permission_profile: memory-daily-default
workspace: Memory

通过apps/electron/src/main/lib/中的服务组件，用户可以创建定时任务、事件监听器和智能推荐规则，实现工作流的自动化管理。

语音输入配置

流式语音输入：支持豆包语音识别，可在Proma内部或外部任何应用中使用

Proma支持全局语音输入功能，配置方式如下：

1. 内部使用：Ctrl + ` 触发识别，再次按下结束并自动输入到当前输入框
2. 外部使用：Ctrl + ` 触发识别，结束后自动输入到系统光标位置
3. 配置选项：在设置中调整语音识别引擎、语言模型和输入行为

语音输入通过apps/electron/src/main/lib/doubao-asr-service.ts实现，支持实时转写和智能标点。

未来展望：主动Agent与智能协作

主动协作系统演进

根据docs/proactive-scheduler-monitor-design.md的设计规划，Proma正在向真正的主动Agent系统演进。未来版本将重点增强以下能力：

1. 智能推荐引擎：基于用户行为模式自动推荐Schedule、Monitor和Memory任务
2. 上下文感知的自动化：根据工作流状态动态调整任务优先级和执行策略
3. 跨工作区协作：支持多个工作区之间的数据共享和任务协调

技能生态扩展

Proma的Skill系统设计支持社区贡献和第三方扩展。未来将建立标准的Skill开发框架和发布渠道，包括：

• Skill模板系统：提供标准化的开发模板和测试工具
• Skill市场：支持在线发现、安装和更新第三方Skills
• Skill版本管理：确保兼容性和稳定性

企业级功能增强

针对团队和企业用户，Proma计划增加以下功能：

1. 多用户协作：支持团队共享工作区、Skills和自动化配置
2. 审计日志：完整的操作记录和权限追踪
3. 集中管理：企业级的配置管理和策略控制
4. API集成：提供REST API和Webhook支持，与企业系统深度集成

性能与可扩展性优化

技术架构的持续改进方向包括：

• 运行时优化：减少内存占用，提高任务执行效率
• 插件系统：支持动态加载和卸载功能模块
• 分布式支持：探索多设备协同和云端计算能力
• 离线增强：完善离线模式下的功能完整性和用户体验

技术差异化与竞争优势

本地优先的隐私保护

与云端AI助手不同，Proma坚持本地优先原则，确保用户数据始终掌握在自己手中。这种设计特别适合处理敏感代码、商业文档和私有项目。

双运行时架构的灵活性

同时支持Claude和Pi两套Agent运行时，让用户可以根据任务复杂度、成本预算和响应速度要求灵活选择。这种架构避免了单一运行时的局限性。

可扩展的技能生态系统

基于文件系统的Skill设计简单而强大，用户可以通过简单的Markdown文件定义复杂的工作流。这种低门槛的扩展方式促进了社区贡献和知识共享。

企业级的安全控制

细粒度的权限系统和审批流程确保了自动化操作的安全性。企业用户可以精确控制每个Agent的访问范围和操作权限。

开源社区的持续创新

作为开源项目，Proma受益于社区的持续贡献和改进。透明的代码库、活跃的开发者社区和开放的扩展机制，确保了项目的长期生命力和创新活力。

通过将先进的AI技术与实用的工作流设计相结合，Proma为专业用户提供了一个真正可定制、可扩展、安全可靠的AI工作伙伴。无论是个人开发者、技术团队还是企业用户，都能在这个平台上构建适合自己的智能工作流，实现工作效率的质的飞跃。

【免费下载链接】Proma Proma brings a seamless general-purpose Agent experience to your workflow. Built for 100× professionals and the proactive Agent era, it supports Claude and Pi runtimes, Feishu group chats, and any LLM provider. 项目地址: https://gitcode.com/gh_mirrors/pro/Proma