Macro 统一工作区
本专题共 40 篇，依据
官方仓库
的 apps/docs/ 产品文档、MCP 工具参考、变更日志与自托管说明整理。
价格与额度请以官网最新页面为准。
Macro 是什么：邮件、任务、文档、CRM 共用一个双向数据库的开源工作区
拆开 Macro（macro-inc/macro，AGPL-3.0）官方文档，讲清"统一工作区"在它这里的确切含义——十几类内容共用一份库、@ 提及生成双向链、频道决定权限、一个收件箱收全部通知。也说清它只支持 Gmail、Outlook 与 IMAP 官方标注为计划中这些边界。
上手与账号：先搞清楚它支持什么
Macro 只是邮件客户端不是邮件服务器，目前接的是 Gmail 与 Google Workspace；Outlook 与自定义 IMAP/SMTP 官方标注为计划中。这一组还包括键盘流的五个起手键、统一搜索、权限模型、团队席位与计费口径。
Macro 十五分钟上手：官方 Get Started 的七步里，哪几步是真卡点
官方 Get Started 把 Macro 的初始配置拆成七步，号称十五分钟走完。真正会卡住人的其实只有邮箱能不能接、频道和权限的绑定关系这两处。本文按文档原文逐步拆解每一步做什么、依赖什么前置条件，并把「计划中尚未提供」的部分单独标出来，让你在注册前就知道自己这套邮箱和团队结构能不能落地。
Macro 邮箱怎么接入：Gmail 多账号合成一个收件箱，以及它管不管你的邮箱
按官方文档梳理 Macro 的邮件接入路径：能连哪种账号、第二个账号加在哪、发信时怎么选发件地址；再讲清统一收件箱里除了邮件还会流进哪五类东西，Signal/Noise 在邮件模块和收件箱里的判定门槛差在哪，以及把邮件分享进频道时权限会发生什么变化。
Macro 支不支持 Outlook/IMAP 邮箱？官方文档的原话与现状
把 Macro 官方文档里关于邮箱支持范围的两处说明找齐，逐条讲清楚：目前只支持 Gmail 与 Google Workspace，Outlook 与自定义 IMAP/SMTP 被标注为计划中且没有时间表。顺带拆开三个容易连带误判的问题——planned 是不是灰度中、自托管能不能绕开、邮件收不到是不是协议不支持。
Macro 键盘快捷键：先记五个键起步，再按三类动作和模块补齐
官方快捷键参考是一张按模块罗列的大表，第一次看很容易记不住。这篇按「先学哪五个键、三类高频动作怎么分工、各模块又多了什么键」重新组织，并把同一个键在不同上下文里含义不同的地方单独列出来，最后说明文档里没有交代的部分，比如非 macOS 的修饰键映射和能否自定义。
Macro 统一搜索怎么用：多词匹配规则、@提及收窄与标签 Any/All 两种口径
按 Macro 官方文档梳理统一搜索的实际用法——两个入口、多词默认独立匹配与引号精确匹配的区别、索引覆盖到正文与通话转写的范围、用 @提及和类型过滤收窄结果、标签过滤的 Any 与 All 两种匹配模式，以及 agent 通过 MCP 用的 ContentSearch 与 NameSearch 参数。
Macro 的权限模型：频道成员身份决定共享范围，@提及在哪会授权、在哪只是链接
Macro 不用逐文件的权限对话框，访问权来自频道成员身份——在频道里 @提及一个东西，它就对全频道可见；人进人出，权限跟着流动。这篇按官方文档梳理清楚：哪些位置的 @提及会真的授权、哪些只是插一个链接，共享与通知为什么是两套规则，团队默认替你打开了哪些共享，以及公开链接、域名自动入团、通话录音这三个最容易漏的口子。
Macro 团队与成员管理：三种拉人方式、Member/Admin/Owner 三档角色与移除成员时收回什么
按 Macro 官方文档梳理团队这一层到底管什么——从 Team 按钮建团队、邮件邀请与邀请链接、按域名自动加入的开关边界，到 Member/Admin/Owner 三档角色各自多出哪些权限、Owner 移除成员时哪些内容会自动收回、加入团队后任务通话邮件片段的默认共享如何变化，以及每人一个付费席位的前提和企业签约该找哪个邮箱。
Macro 计费规则怎么算：免费版的四条天花板与 Premium 每人 40 美元的边界
按官方文档逐条拆 Macro 的计费口径——免费版与 Premium 的价目表、免费版被限制的模型与容量、团队为什么必须人人付费、Stripe 订阅怎么管、自托管免费但要自备哪些许可，以及官方文档明确没写的那些问题该怎么办。
Macro 官方 FAQ 与支持页里最该先看的几条：自托管、许可证、权限和收件箱分流
把 Macro 官方 FAQ 与 Get Support 两页里真正影响决策和使用的条目挑出来讲清楚——自托管的现实边界、AGPLv3 换证时间点与商用另购规则、数据不训练模型的口径、团队计划没有免费档，以及支持页那六条最容易卡住人的常见问题各自的官方落点和对应邮箱入口。
自托管与 MCP：把工作区接进 Agent
仓库是 AGPL-3.0，可以自己跑，但托管版与自托管的能力并不对等（第三方授权就在托管版这边）。MCP 那条线是这个项目对 Agent 生态最实在的开口：16 个工具怎么用、连不上时往哪查，按类拆成四篇。
自托管 Macro：本地把整套栈跑起来的前置条件、命令，以及每一步卡住时怎么判断
按官方 RUNNING_LOCALLY 文档拆解 Macro 本地自托管的完整链路：只需 Nix 与 Docker 两个前置，nix develop 进壳、just run_local --no-doppler 拉起六个基础设施，再到 Mailpit 收验证码、seed 造数据、doctor-local 查端口冲突、r/q 热键与 stack 无头模式，每一步都写清卡住时该看哪里。
自托管 Macro 容易撞的几类坑：端口窗口、OAuth 回调端口与本地 MCP 服务边界
把 Macro 自托管文档里明确写了处理办法的问题（端口冲突、集成桩值、辅助服务陈旧镜像）和仓库里有人报过、官方文档暂时没给答案的问题（OAuth 回调写死端口、mcp_service 是否随 run_local 启动、MCP 动态客户端注册与鉴权头）分开列清楚，逐条标明官方口径。
Macro 的 MCP 服务能做什么：一个远程端点、OAuth 登录，和注册表里的 16 个工具
把 Macro 官方 MCP 文档拆开讲清楚：端点是远程的不用起本地进程，Claude Code / Codex CLI / IDE JSON 三种接法的原文命令，登录走 OAuth 浏览器流程，所有套餐含 Free 都能用，以及工具注册表里 16 个工具怎么分类、官方文档到哪一步就不再往下说了。
Macro 的 MCP 连不上怎么查：鉴权、动态客户端注册与自托管地址的定位路径
Macro 的 MCP 接入在官方文档里只有一个远程地址加一次 OAuth，配置面小，出问题时反而不知道往哪看。这篇把官方文档写明的四行配置逐条拆开，再对着仓库里有人报过的几条 MCP 相关条目，理出一条从「连的是哪一端」到鉴权、动态客户端注册、资源元数据、自托管地址的排查顺序，并标明哪些官方尚未给出解决方案。
Macro MCP 实体类工具怎么用：列实体、取属性、改属性的调用顺序与写操作边界
Macro 的 MCP 工具注册表里，ListEntities、GetEntityProperties、SetEntityProperty 是唯一能读写实体结构化字段的一组。这篇按官方生成的参数表逐个拆参数，讲清三者为什么必须按顺序调用、SetEntityProperty 那十三个值字段该选哪一个，以及生成页里"Required 全是 Yes"该怎么读、写操作有哪些文档没兜底的风险。
Macro MCP 的两个搜索工具：ContentSearch 搜正文、NameSearch 搜标题，别用混
ContentSearch 和 NameSearch 参数长得几乎一样，一个匹配正文、一个匹配名称，选错了模型就会空手而归。这篇按官方工具注册表逐个参数拆开，讲清 entityTypes 怎么填、两个工具各自匹配什么字段、什么场景该换成 ListEntities，以及搜到 id 之后怎么接到 ReadContent、ReadMetadata、GetThread 这几个读取类工具上。
Macro MCP 内容类工具怎么用：ReadContent、ReadMetadata 与 CreateDocument 的参数与陷阱
把 Macro 的 MCP 接上 Claude Code 或 Codex 之后，模型最常卡在“拿不到 documentId”和“建文档四个参数漏填”。这篇按官方生成的工具参数表逐个拆 ReadContent、ReadMetadata、CreateDocument 三个内容类工具，说明它们各自要什么、彼此怎么串、text_editor_code_execution 的定位差在哪，以及官方文档在返回结构上留了哪些空白。
Macro MCP 的会话与邮件四工具：读会话、发邮件、改标签各要什么参数
逐个拆 Macro MCP 工具注册表里的 GetThread、ReadThread、SendEmail、UpdateThreadLabels：每个参数是什么类型、文档怎么描述，重点说清 SendEmail 这个唯一有外部副作用的写操作，官方文档写明了什么、又没写明什么，以及生成式文档里"必填"与"(optional)"打架该怎么读。
产品块：七块共用一个数据库意味着什么
邮件、消息、任务、文档、画布、通话、CRM 落在同一个库里，靠 @ 提及互链、靠 properties 挂结构化字段、靠统一记忆喂给 Agent。这一组逐块讲清能力边界与共享规则——尤其是「哪些 @ 会自动授权、哪些不会」这类最容易踩的差别。
Macro 的 blocks 数据模型：十几类内容共用一份库，到底改变了什么
按官方 concepts/blocks 文档拆解 Macro 的核心抽象——15 种一等块类型的完整清单、每个块都自带的 References 面板与四级共享、提及与嵌入在权限上的关键差异、协作块走 Loro CRDT + Durable Objects 的同步路径，以及这套模型和"几个 SaaS 各存各的库"的具体分歧点。
Macro 的 @ 提及机制：一个 @ 同时决定引用、通知和访问权限
Macro 里的 @mention 不只是插一条链接。同一个动作在频道、邮件、文档、Agent 对话里的后果完全不同：有的会把文档共享给一群人，有的只加 CC，有的连通知都不发。这篇按官方文档把五种场景的行为差异、被提及对象（人/文档/频道/日期）的通知与共享规则整理成对照表，并说明哪些坑文档已经明说过。
Macro 的 properties 机制：给邮件、任务、文档挂上同一套结构化字段
按 Macro 官方文档梳理 properties 这套跨 block 的结构化字段系统——八种数据类型分别装什么、system 与 custom 和 metadata 标记怎么分、pin 到卡片上意味着什么、任务与 CRM 各自自带哪些系统字段，以及为什么标签在 Macro 里也是一个 property，最后给出字段设计的三个判断点和文档没写清的部分。
Macro 统一记忆记的是什么：个人记忆与团队记忆的边界，以及唯一写明的退出开关
按官方 product/unified-memory 与 product/agents 两页拆开 Macro 的 unified memory——记忆的输入源清单、每晚刷新的节奏、任务与通话与邮件三类内容在个人与团队之间的默认归属、按次通话退出后会发生什么，以及官方文档明确没写的那几件事该怎么预期。
Macro 里的 Agent 到底能替你做哪些事，权限边界又卡在哪一层
按 Macro 官方文档梳理其内置 Agent 的八类动作范围（搜索读取、写文档、任务与 CRM、邮件、频道、通话、联网、导入），说明"继承你的权限、产物署你的名"这条边界怎么生效，以及定时自动化、@Macro 频道调用、MCP 外接三种调用方式各自能做到什么、文档没有说明什么。
Macro 统一收件箱怎么分流：Signal 与 Noise 两个过滤器加一套清空动线
邮件、频道消息、任务指派、文档 @提及、Agent 跑完的结果全落进同一个列表，靠什么不被淹掉。本文按 Macro 官方文档拆解统一收件箱收哪六类条目、Signal 与 Noise 这对过滤器各自承担什么、清空要用哪几个按键，以及文档明确没有交代的分类依据与账号边界。
Macro 的频道与私信怎么组织：一条 @提及决定谁看得见、谁收得到通知
在 Macro 里，频道成员名单就是权限名单，一次 @提及既是引用也是授权。本文按官方文档梳理频道与私信的组织方式、@提及在频道/文档/评论/邮件四种场景下的共享与通知差异、消息无法跨频道分享的硬边界，以及团队自动共享的例外规则，并给出一张对照表。
Macro 的任务管理拆解：状态、属性字段，以及它和频道、邮件、文档怎么联动
从官方文档出发梳理 Macro Tasks 的四个状态、内置属性字段与自定义属性类型，说明任务如何在频道、邮件、文档中以 @提及的形式复用，GitHub 拉取请求如何自动推动状态流转，以及 MCP 客户端能对任务做哪四类操作。文末给出这套设计的适用边界和文档没有交代的地方。
Macro 的文档块：markdown 原生编辑与 Loro CRDT 实时协作是怎么组织的
从官方文档出发拆 Macro 的 docs 块：编辑器支持哪些块节点与快捷键、实时协作底下是 Loro CRDT 加 Cloudflare Durable Objects 的什么结构、标签怎么把一堆文档变成可筛选的库、评论与版本历史能做到哪一步，以及正文 @ 提及不发通知这类容易踩的规则和官方明确写的能力边界。
Macro 的 Canvas 二维板怎么用：板上的 @ 链接是活块，权限和反链要分开看
Canvas 是 Macro 的白板类 block，官方文档强调它能直接放工作区里的 @mention 活块。这篇把文档写明的东西拆开讲：板上能放哪五类对象、@ 链接携带什么元数据、反链往哪个方向记、板子的共享和板上对象的共享为什么是两件事，以及官方文档在 canvas 上留了哪些空白。
Macro 的通话录制与转写：默认共享给全团队，怎么按次退出
把 Macro 官方文档里关于通话的规则捋清楚——通话默认录制、转写并进团队记忆，同团队的人没参加也能在 Calls 标签里看到；退出共享是按次操作，退出后只进个人记忆。另附录音存储位置、数据区域、搜索索引范围，以及文档没写清楚的告知环节。
Macro 内置 CRM 怎么用：记录自动生成、阶段全靠手动、Email Sync 决定谁看得见
按官方文档梳理 Macro CRM 的实际用法：为什么侧栏可能没有 Customers 视图、联系人和公司记录是怎么从团队邮件里自动长出来的、看板七个阶段为什么必须手动拖、列表视图能编辑哪四个参数，以及 Email Sync 与管理员隐藏如何划定团队可见范围，最后给出用 MCP 让 agent 读写 CRM 的接法和不适用场景。
Macro 的文件夹和标签到底该怎么分工：一个是文档的字段，一个是跨类型的属性
很多人在 Macro 里同时建了文件夹和标签，结果两边都是半成品。这篇按官方文档把两套归类的语义拆开：文件夹是 Documents 的内置属性、只管文件且带共享权限；标签是一种属性、跨文档任务邮件 AI 会话通话共用一个命名空间。给出对照表、Any/All 过滤规则、12 色调色板带来的命名约束，以及交给 agent 的 MCP 工具名。
Macro 的片段（snippets）怎么用：分号唤起、团队共享，以及官方文档没写的那部分
按 Macro 官方文档梳理 snippets 的全套用法：片段本质是一份完整 markdown 文档，用 c + s 新建、在正文里打分号唤起菜单，可插入文档、任务、频道消息、画布文本框和 agent 指令五类位置；并说明个人与团队共享的切换方式，以及变量占位、批量导入这些文档里根本没提的边界。
集成、安全与迁移
GitHub 集成、应用体系与扩展点、官方安全说明的责任边界、从现有工具迁过来能带走什么，以及 AGPL 与自托管边界（只转述声明，法律判断请咨询专业人士）。
从 2026 年 1—5 月的 changelog 看 Macro 在往哪走：AI 工具、通话与团队化
把 Macro 官方 2026 年 1 月到 5 月的五份月度更新记录按主题拆开看：AI 从单个工具调用长成可调度的 agent 与 MCP 接入，四月凭空长出一整条通话线，搜索层被反复重写，后端在持续删服务，产品从个人订阅转向团队席位。每条判断都落在具体版本号上。
从 Superhuman、Notion、Slack 迁到 Macro：哪些数据能带过来，哪些只能重建
按官方迁移文档逐条拆解：邮件因为 Macro 只是 Gmail 客户端而根本不需要迁移，文档靠 MCP 连接器加 agent 重建，任务多数团队只搬未完结的部分。文中给出可直接复用的导入指令、连接器配置位置，以及 Outlook/IMAP、Slack Connect 这两个当前搬不过去的缺口。
Macro 的 AGPL-3.0 协议与自托管边界：官方仓库和文档到底写了什么
把 macro-inc/macro 的 README、CONTRIBUTING 和官方 FAQ 里关于许可证、自托管、贡献者协议的表述逐条拆开，说明官方承认自托管可行但不是当前重点、自托管者要自己接住哪些第三方服务授权、改了代码回上游要走什么流程，以及哪些问题属于法律判断本文不下结论。
Macro 的 GitHub 集成到底做了什么：分支、PR 合并与任务状态自动同步的边界在哪
按官方文档拆解 Macro 与 GitHub 打通后实际发生的事：建分支、开 PR、合并分别把任务推到哪个状态，PR 作为 block 能被 @提及和 agent 读取意味着什么，连接入口在文档里为何有两种写法，以及自托管部署时官方对 GitHub 授权的那句提示。
Macro 的安全与数据处理官方说明：数据放哪、谁能看到、AI 会不会拿去训练
逐条梳理 Macro 官方安全文档写明的内容——责任边界怎么划、支持哪些认证与协议文件、数据区域只有美国和欧盟两个选项、访问控制为什么落在频道共享上、Agent 处理数据的四条承诺、留存删除规则，以及 SAML/SCIM 这类官方明确写「尚未支持」的部分。
Macro 的技术选型：Rust 后端 + Solid 前端 + Loro CRDT，这套组合带来哪些工程约束
从 Macro 开源仓库和官方文档里把技术栈这条线拎出来讲：官方原话说了什么、仓库按 42 个服务和 167 个 Rust crate 怎么分、文档协同为什么落在 Loro CRDT 加 Cloudflare Durable Objects 上，以及这套组合让本地跑起来必须先装 Nix 和 Docker、编译走 cargo zigbuild、三个服务要单独重建镜像。
Macro 的应用体系与扩展点：MCP、GitHub 与自托管到底能接什么
把 Macro 官方文档里关于客户端形态、GitHub 集成和 MCP 接入的三份材料摊开对照，梳理它的扩展点实际分成哪几层、每层由谁来接、配置命令长什么样，以及托管版与自托管的差别文档究竟说了什么、哪些只字未提，避免拿推断当事实来做选型。
Macro 官方 Agent 配方拆解：八段提示词各自解决什么问题
Macro 文档里的 Agent recipes 给了八段可直接复制的英文提示词，覆盖每日收件箱简报、项目状态查询、周会纪要、通话转任务、邮件起草、频道内问答、跨工具导入和 Claude Code 侧调用。本文照原文列出这些提示词，逐条说明它们各自打的是什么场景、走哪个入口、依赖哪些前置配置，并指出官方没有承诺的部分。
想让 AI 真正接管日常协作？
从工具选型到组织落地，站内有成体系的数字员工与组织管理内容。