用途:通过自包含的 Python 脚本获取并分析 MasterGo 文件的设计 DSL 数据,适用于用户提供 MasterGo 链接(https://mastergo.com/file/xxx 或 /goto/xxx)时提取设计结构、文本内容、组件文档链接与交互信息。
主要能力:mastergo_analyze.py 输出人类可读的节点树(类型、名称、尺寸)、文本内容、组件文档链接与导航目标;mastergo_get_dsl.py 输出包含 dsl、componentDocumentLinks、rules 的 JSON;mastergo_fetch_docs.py 获取组件文档内容;mastergo_utils.py 作为模块提供工具函数。DSL 关键概念包括 token 字段(颜色、阴影、字体等设计令牌,生成代码时可转为 CSS 变量)、componentInfo(含文档链接的组件元数据)、interactive 字段(含页面导航目标的用户交互)以及 rules 数组。
使用方式:需设置环境变量 export MASTERGO_TOKEN="mg_your_token_here",令牌从 MasterGo 设置 > 安全 > 个人访问令牌获取。要求团队版账号且文件位于团队项目(非草稿)。脚本位于 SKILL.md 同级的 scripts/ 目录,执行时使用绝对路径 {this_skill_directory}/scripts/mastergo_*.py。建议先运行分析脚本了解页面结构,再按需获取完整 DSL,若 componentDocumentLinks 非空则获取相关文档。
限制与安全:切勿用 echo、printenv 等命令打印令牌值,验证时仅用 test -n "$MASTERGO_TOKEN" 判断是否已设置。禁止在用户项目中创建 .temp_dsl.json、analyze_dsl.py 等任何临时或缓存文件,所有脚本输出仅到 stdout,应直接在内存中使用,不得写入用户项目目录。参考资料包括 references/dsl-types.md、references/dsl-structure.md、references/multi-page-workflow.md。