macro-inc/macro

Macro – 集成的AI增强工作空间

概述 – Macro是一个开源、AGPL‑v3许可的平台，旨在用单个紧密链接的Web应用取代大多数初创企业使用的各种工具（电子邮件、聊天、文档、问题跟踪、CRM等）。它采用SolidJS前端和大型Rust后端代码库构建，并提供一套完整的服务（约42个），可通过Docker/Compose或Pulumi一起运行。

核心理念 – 每条信息都存于双向图中，可在整个系统中进行**@链接**。电子邮件可以变成任务，任务可以引用PR，CRM记录可以在聊天消息中被提及，而AI助手（智能体）因共享相同的底层数据库，可以读取或编辑这些对象。

主要组件

模块	功能
电子邮件	统一多账户收件箱，键盘优先导航，起草、搜索附件、直接从邮件创建任务的AI助手。
消息	针对技术讨论优化的频道式聊天，支持行内回复、线程折叠，并自动链接到任务、PR和CRM记录。
任务	类似Linear的Issue列表，可从任何上下文（邮件、文档、聊天）创建，并保持与其来源的链接。
文档	基于CRDT（无冲突复制数据类型）的实时协作Markdown编辑器，支持版本历史、离线功能和完整的@链接。
画布	二维看板，可放置文档、任务、电子邮件等，保持相同的链接语义。
智能体	具有团队级内存的AI助手——可查询整个工作空间、草拟回复、创建工单或编辑文档。内存以Markdown存储并可导出。
通话	录制通话并转录，加入图中，便于智能体引用。
文件存储	自动从邮件和聊天中导入，可按内容搜索。
拉取请求	GitHub PR作为一等对象出现，链接到任务和聊天。
CRM	联系人和公司对象，与电子邮件同步，可被@提及，并自动为交易创建频道。

AI集成 – Macro提供模型控制协议（MCP），使任何LLM（OpenAI、Anthropic、Claude等）都能在工作空间中操作。智能体可读取统一的内存、执行操作（创建任务、编辑文档、发送邮件），且不受速率限制。平台还提供搜索界面，让智能体从电子邮件附带的PDF中提取信息。

运行代码 – 代码库包含：

• apps/web – SolidJS客户端（也打包为Tauri桌面和移动应用）。
• services – Rust微服务（工作者、Lambda式处理程序）。
• crates – 可复用的Rust库。
• packages – 用于协作的共享TypeScript工具。
• infra – Pulumi IaC，用于云部署。
• Docker Compose文件，用于本地开发。

README指向RUNNING_LOCALLY.md指南，用于启动完整堆栈或仅针对托管后端运行前端。

对AI/ML人群的重要性 – Macro是一个真实世界的示例，展示了基于知识图谱的工作空间，其中LLM可以通过单个查询获得完整上下文（电子邮件、聊天、文档、CRM记录）。其开源特性允许研究人员试验自定义智能体、内存同步策略或基于CRDT的协作编辑，而无需从头构建底层基础设施。

许可证与社区 – AGPL‑v3，完全开源，包含贡献指南、安全漏洞赏金计划，以及一个正在招聘的小团队。项目鼓励自托管，并为大型企业提供商业支持。