用途：这是一份 Mastra 框架的实践指南，帮助开发者用 Mastra 构建 AI 应用，重点是先查证当前文档再写代码，避免使用过时 API。
主要能力：讲解如何查找最新文档、核对 API 签名、构建 Agent 与 Workflow；提供文档查找优先级、核心概念说明、常见错误排查和版本迁移参考。
使用方式：写代码前先检查依赖是否安装，运行 ls node_modules/@mastra/。若已安装，优先读取 node_modules/@mastra/*/dist/docs/ 中的内嵌文档，例如 cat node_modules/@mastra/core/dist/docs/SOURCE_MAP.json | grep '"Agent"'；若未安装，则从 https://mastra.ai/llms.txt 获取远程文档。开发时可用 npm run dev 在 http://localhost:4111 的 Studio 中测试。
核心概念：Agent 适合开放式任务，可自主决策并调用工具；Workflow 适合结构化流程。组件包括 Tools、Memory、RAG、Storage。
限制与要求：Mastra 需要 ES2022 模块，CommonJS 会失败；模型需使用 "provider/model-name" 格式，如 "openai/gpt-4o"。遇到类型错误、模块找不到等问题时，应先核对当前 API，而非假定是用户错误。资料未提供具体收费、平台支持范围等信息。