发现了一个有趣的开源的全通信+CRM+Agent一体化OSS项目 @macrodotcom 昨天。它给我留下了深刻印象，但他们还没有文档网站。介绍新的 grok-wiki 从0到1文档生成功能。只需提供GitHub URL或文件夹路径，即可自动生成漂亮的文档。该功能已随最新 v0.0.16 版本上线。你也可以直接将 Agent 指向 https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e… 以立即获取上下文。—

Macro 工程文档

来源：https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e
Agent 可读文档
Macro 单仓库的技术文档：SolidJS 应用、Rust 服务、同步 Worker、AI 工具、基础设施、本地开发、API、配置和运维。
完整 Markdown (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/llms-full.txt)
llms.txt (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/llms.txt)
Markdown 别名 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e.md)
GitHub (https://github.com/macro-inc/macro)

页面列表

1. 概述 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/01-overview.md)
   概述：公共入口点、仓库表面、运行时假设以及通过文档的最短成功路径。
2. 安装 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/02-installation.md)
   安装：所需工具、Nix 选项、加密环境设置、Docker 资源、LocalStack、FusionAuth 以及首次设置命令。
3. 本地开发快速启动 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/03-local-development-quickstart.md)
   快速启动：使用 just 配方、共享 Compose 资源、数据库初始化以及预期的健康信号启动本地服务。
4. 前端快速启动 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/04-frontend-quickstart.md)
   快速启动：运行 SolidJS 应用、选择本地或远程服务、理解应用路由、开始 Tauri 开发。
5. 本地端到端冒烟测试 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/05-local-e2e-smoke-tests.md)
   指南：针对仅本地堆栈和共享种子夹具运行确定性 Playwright 和忽略的 Rust 冒烟测试。
6. 单仓库地图 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/06-monorepo-map.md)
   概念：工作区边界、包管理器、主要运行时文件夹、生成的文档以及真理清单文件所在位置。
7. 运行时环境和服务 URL (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/07-runtime-environments-and-service-urls.md)
   概念：环境值、本地与开发与生产 URL 解析、CORS 规则以及前端服务选择。
8. 服务拓扑 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/08-service-topology.md)
   概念：本地和云栈使用的 Rust 服务、Worker、队列、存储依赖项、端口和部署边界。
9. 实体和块 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/09-entities-and-blocks.md)
   概念：项目类型、文档支持和非文档块、别名、加载源、嵌套规则以及文件类型解析。
10. 分割布局和导航 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/10-split-layout-and-navigation.md)
    概念：路由编码、组件注册表条目、分割历史、导航原因、弹出窗口以及桌面与移动分割行为。
11. 实时文档同步 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/11-real-time-document-sync.md)
    概念：同步服务 Worker 路由、持久对象会话、权限令牌、Bebop 消息、快照生命周期以及客户端重连行为。
12. 本地运行后端服务 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/12-run-backend-services-locally.md)
    指南：启动数据库、LocalStack、FusionAuth、Rust 服务、可选处理器配置文件以及本地健康检查。

完整 Markdown

# Macro 工程文档

> Macro 单仓库的技术文档：SolidJS 应用、Rust 服务、同步 Worker、AI 工具、基础设施、本地开发、API、配置和运维。

## 上下文链接

- Agent 索引 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/llms.txt)
- 人类交互文档 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e)
- GitHub 仓库 (https://github.com/macro-inc/macro)

## 仓库元数据

- 仓库：macro-inc/macro
- 生成时间：2026-06-01T01:07:41.847Z
- 更新时间：2026-06-01T02:14:57.236Z
- 运行时：Pi · Codex · gpt-5.5
- 格式：文档
- 页面数：29

## 页面索引

- 01. 概述 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/01-overview.md)
  - 概述：公共入口点、仓库表面、运行时假设以及通过文档的最短成功路径。
- 02. 安装 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/02-installation.md)
  - 安装：所需工具、Nix 选项、加密环境设置、Docker 资源、LocalStack、FusionAuth 以及首次设置命令。
- 03. 本地开发快速启动 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/03-local-development-quickstart.md)
  - 快速启动：使用 just 配方、共享 Compose 资源、数据库初始化以及预期的健康信号启动本地服务。
- 04. 前端快速启动 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/04-frontend-quickstart.md)
  - 快速启动：运行 SolidJS 应用、选择本地或远程服务、理解应用路由、开始 Tauri 开发。
- 05. 本地端到端冒烟测试 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/05-local-e2e-smoke-tests.md)
  - 指南：针对仅本地堆栈和共享种子夹具运行确定性 Playwright 和忽略的 Rust 冒烟测试。
- 06. 单仓库地图 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/06-monorepo-map.md)
  - 概念：工作区边界、包管理器、主要运行时文件夹、生成的文档以及真理清单文件所在位置。
- 07. 运行时环境和服务 URL (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/07-runtime-environments-and-service-urls.md)
  - 概念：环境值、本地与开发与生产 URL 解析、CORS 规则以及前端服务选择。
- 08. 服务拓扑 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/08-service-topology.md)
  - 概念：本地和云栈使用的 Rust 服务、Worker、队列、存储依赖项、端口和部署边界。
- 09. 实体和块 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/09-entities-and-blocks.md)
  - 概念：项目类型、文档支持和非文档块、别名、加载源、嵌套规则以及文件类型解析。
- 10. 分割布局和导航 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/10-split-layout-and-navigation.md)
  - 概念：路由编码、组件注册表条目、分割历史、导航原因、弹出窗口以及桌面与移动分割行为。
- 11. 实时文档同步 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/11-real-time-document-sync.md)
  - 概念：同步服务 Worker 路由、持久对象会话、权限令牌、Bebop 消息、快照生命周期以及客户端重连行为。
- 12. 本地运行后端服务 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/12-run-backend-services-locally.md)
  - 指南：启动数据库、LocalStack、FusionAuth、Rust 服务、可选处理器配置文件以及本地健康检查。
- 13. 开发 SolidJS 和 Tauri 应用 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/13-develop-solidjs-and-tauri-apps.md)
  - 指南：使用 Bun 和 Vite、运行本地服务覆盖、构建应用包、启动 Tauri 目标以及避免 iOS Worker 死锁。
- 14. 修改 Rust 服务 API (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/14-change-a-rust-service-api.md)
  - 指南：更新 Axum 处理程序、OpenAPI 生成器、生成的客户端规范、Orval 输出以及服务 API 变更的 CI 检查。
- 15. 生成服务客户端和工具模式 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/15-generate-service-clients-and-tool-schemas.md)
  - 指南：从 Rust 源码重新生成 OpenAPI JSON、TypeScript 客户端、DCS 模型类型、AI 工具模式和 MCP 文档页面。
- 16. 处理本地种子数据 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/16-work-with-local-seed-data.md)
  - 指南：使用 seed_cli、local_e2e 夹具、清单别名、重置 SQL 以及共享的 Playwright 和 Rust 夹具加载器。
- 17. 存储和工作区 API (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/17-storage-and-workspace-apis.md)
  - 参考：文档、频道、项目、通话、CRM、Soup、Pin、历史、权限、属性和搜索端点。
- 18. 认证和团队 API (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/18-auth-and-team-apis.md)
  - 参考：登录、OAuth 回调、JWT 刷新、账户链接、团队成员、邀请、权限、计费和用户端点。
- 19. 邮件和通知 API (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/19-email-and-notification-apis.md)
  - 参考：Gmail 初始化和同步、草稿、线程、标签、附件、通知偏好、未读状态以及退订路由。
- 20. AI 聊天流式 API (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/20-ai-chat-streaming-api.md)
  - 参考：DCS 聊天端点、流式负载、工具集选择、模型标识符、提取状态、结构化完成以及停止语义。
- 21. MCP 服务器和工具注册表 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/21-mcp-server-and-tool-registry.md)
  - 参考：远程 MCP 端点、OAuth 支持的服务器、工具集组合、SendEmail 边界、生成的模式以及文档工具页面。
- 22. 环境变量参考 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/22-environment-variables-reference.md)
  - 参考：必需和可选的服务环境变量、默认值、密钥、队列名称、端口以及特定于提供商的密钥。
- 23. 数据库迁移和 SQLx 缓存 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/23-database-migrations-and-sqlx-cache.md)
  - 运维：MacroDB 迁移、本地数据库 just 配方、SQLx 离线缓存、夹具数据以及迁移验证工作流。
- 24. 功能标志和服务器选择 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/24-feature-flags-and-server-selection.md)
  - 参考：Vite 环境覆盖、功能标志默认值、本地服务选择语法、同步服务主机选择以及运行时主机辅助函数。
- 25. 基础设施栈参考 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/25-infrastructure-stacks-reference.md)
  - 参考：Pulumi 栈布局、可重用资源、服务栈、存储桶、队列、Datadog Sidecar、FusionAuth 以及部署输入。
- 26. 构建、测试和质量门 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/26-build-test-and-quality-gates.md)
  - 运维：Rust 检查、Clippy、SQLx 准备、TypeScript 检查、Biome、Tailwind 卫生、Vitest、Playwright 以及 CI 路径过滤器。
- 27. 部署服务和 Web 应用 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/27-deploy-services-and-web-app.md)
  - 运维：通用服务部署、Web 应用部署、生产发布工作流、数据库迁移、Pulumi 栈以及部署并发。
- 28. 可观测性和调试 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/28-observability-and-debugging.md)
  - 运维：后端追踪初始化、Datadog ECS Sidecar、浏览器 RUM 和日志、源码映射、本地调试信号以及 iOS WebView 冻结诊断。
- 29. 文档站点维护 (https://grok-wiki.com/public/docs/macro-inc-macro-bb988e1a448e/pages/29-documentation-site-maintenance.md)
  - 贡献：维护 Mintlify 文档站点、导航清单、生成的 MCP 页面、本地预览、断开链接检查以及写作规范。

## 源文件索引

- `.github/workflows/code-check-cloud-storage.yml`
- `.github/workflows/deploy-service-generic.yml`
- `.github/workflows/deploy-web-app.yml`
- `.github/workflows/migrate-macro-db.yml`
- `.github/workflows/release-production.yml`
- `.github/workflows/reusable-deploy-service.yml`
- `.github/workflows/web-app-check-main.yml`
- `docker-compose-databases.yml`
- `docker-compose.local-e2e.yml`
- `docker-compose.yml`
- `docs/AGENTS.md`
- `docs/AI/mcp/overview.mdx`
- `docs/AI/mcp/tools/index.mdx`
- `docs/config/tool-pages.json`
- `docs/CONTRIBUTING.md`
- `docs/docs.json`
- `docs/package.json`
- `docs/README.md`
- `docs/scripts/generate-mcp-tool-pages.ts`
- `flake.nix`
- `infra/packages/lambda/src/index.ts`
- `infra/packages/resources/src/index.ts`
- `infra/packages/resources/src/resources/datadog.ts`
- `infra/packages/service/src/index.ts`
- `infra/packages/shared/src/ai_tools.ts`
- `infra/README.md`
- `infra/stacks/document-storage/index.ts`
- `infra/stacks/fusionauth-instance/README.md`
- `infra/stacks/mcp-server/index.ts`
- `js/app/AGENTS.md`
- `js/app/justfile`
- `js/app/package.json`
- `js/app/packages/app/component/Root.tsx`
- `js/app/packages/app/component/split-layout/componentRegistry.tsx`
- `js/app/packages/app/component/split-layout/layout.ts`
- `js/app/packages/app/component/split-layout/layoutManager.ts`
- `js/app/packages/app/component/split-layout/SplitLayoutRoute.tsx`
- `js/app/packages/app/component/split-layout/tests/layoutManager.test.ts`
- `js/app/packages/app/index.tsx`
- `js/app/packages/app/vite.config.ts`
- `js/app/packages/block-md/definition.ts`
- `js/app/packages/block-project/definition.ts`
- `js/app/packages/core/auth/logout.ts`
- `js/app/packages/core/auth/sso.ts`
- `js/app/packages/core/block.ts`
- `js/app/packages/core/component/AI/types/index.ts`
- `js/app/packages/core/constant/allBlocks.ts`
- `js/app/packages/core/constant/featureFlags.ts`
- `js/app/packages/core/constant/servers.ts`
- `js/app/packages/core/tests/featureFlags.test.ts`
- `js/app/packages/observability/src/index.ts`
- `js/app/packages/service-clients/orval.config.ts`
- `js/app/packages/service-clients/service-auth/client.ts`
- `js/app/packages/service-clients/service-auth/openapi.json`
- `js/app/packages/service-clients/service-cognition/client.ts`
- `js/app/packages/service-clients/service-cognition/openapi.json`
- `js/app/packages/service-clients/service-email/client.ts`
- `js/app/packages/service-clients/service-email/openapi.json`
- `js/app/packages/service-clients/service-notification/client.ts`
- `js/app/packages/service-clients/service-notification/openapi.json`
- `js/app/packages/service-clients/service-properties/client.ts`
- `js/app/packages/service-clients/service-properties/openapi.json`
- `js/app/packages/service-clients/service-search/client.ts`
- `js/app/packages/service-clients/service-search/openapi.json`
- `js/app/packages/service-clients/service-storage/client.ts`
- `js/app/packages/service-clients/service-storage/openapi.json`
- `js/app/packages/service-clients/service-sync/client.ts`
- `js/app/packages/service-clients/service-sync/source.ts`
- `js/app/README.md`
- `js/app/scripts/generate-api-schema.ts`
- `js/app/scripts/generate-dcs-tools.ts`
- `js/app/scripts/services.ts`
- `js/app/tauri/src-tau`