用途：把 Mastra 文档中已有图表图片转换为 Mermaid，并为文档撰写新的 Mermaid 图。开始前先阅读 docs/styleguides/DIAGRAM.md，它定义形状、颜色与布局语言。
是否转换：按顺序判断，首个命中即停止。UI 截图保留原图；含义取决于元素位置而非连接关系的图保留原图（ELK 会自动移动节点）；若图是方框加箭头，且仅凭节点与边标签重画也能保留含义，则转换。不要靠布局引擎硬撑形状，不要加隐形占位节点、标签内空格或手工调参的 elk 块。
转换步骤：1）先 grep -rn "<image-filename>" docs/src 找出所有引用，文档图片常跨页共享。2）读图并列出节点、职责、边及标签，从列表而非图片出发。3）先写主路径再写分支，按决策树套用形状，仅对结果使用语义类，始终添加 accTitle 与 accDescr，图要与上方句子对应。4）在浏览器两种模式下验证：cd docs && pnpm dev --port 3005，检查主路径是否为直线、节点宽度是否超过邻居两倍、边标签是否落在边上、明暗切换文字可读且无残留填充。5）仅当 grep 无结果时删除资源，否则保留并说明仍有页面引用。
扩展颜色语言：现有 accent、pending、danger 三类，新增需在 docs/src/theme/Mermaid/mastra-mermaid-theme.ts 提供明暗两套值，并为节点用 semanticClassCSS(...)、边用 semanticEdgeCSS(...) 注册，同时更新 DIAGRAM.md 表格。禁止在图中写十六进制颜色。
检查：在 docs/ 下运行 pnpm lint:remark 与 pnpm build（Mermaid 解析错误会导致构建失败）。其他收费、平台等信息暂未提供。