技能 编程开发 Anima代码生成错误诊断

Anima代码生成错误诊断

v20260423
anima-common-errors
本指南旨在帮助开发者诊断和修复使用Anima SDK将Figma设计转换为代码时遇到的所有常见错误。内容涵盖了认证失败(如Token过期)、节点查找错误、代码生成限制,以及优化代码输出质量(如布局错乱、颜色不匹配)的最佳实践和解决方案。
获取技能
118 次下载
概览

Anima Common Errors

Error Reference

Authentication Errors

ErrorRoot CauseFix
Invalid Anima tokenToken not provisioned or expiredRequest new token from Anima team
Invalid Figma tokenPAT expired or revokedGenerate new PAT: Figma > Settings > Access Tokens
UnauthorizedToken lacks file accessEnsure Figma PAT has file read permission

File & Node Errors

ErrorRoot CauseFix
File not foundWrong file keyExtract from Figma URL: figma.com/file/{KEY}/...
Node not foundInvalid node IDCopy node link from Figma: right-click > Copy link
No renderable contentSelected a page or groupSelect a frame, component, or component set
Empty files arrayNode is empty or hiddenUnhide layers; ensure node has visible content

Code Generation Errors

// Common generation error handler
async function safeGenerate(anima: Anima, params: any) {
  try {
    return await anima.generateCode(params);
  } catch (err: any) {
    if (err.message?.includes('rate limit')) {
      console.error('Rate limited — wait 60s before retrying');
    } else if (err.message?.includes('timeout')) {
      console.error('Generation timed out — simplify the Figma node');
    } else if (err.message?.includes('Invalid settings')) {
      console.error('Invalid settings combo — check framework/styling/uiLibrary compatibility');
    } else {
      console.error('Generation error:', err.message);
    }
    return null;
  }
}

Output Quality Issues

SymptomCauseFix
Messy layoutNo auto-layout in FigmaConvert frames to auto-layout
Wrong colorsHardcoded hex instead of Figma variablesUse Figma color variables/styles
Missing textText is inside masked groupsFlatten masks before generating
Extra wrappersDeeply nested groupsFlatten group hierarchy
Wrong component namesUnnamed Figma layersName layers descriptively

Valid Settings Combinations

FrameworkLanguageStylingUI Library
reacttypescript, javascripttailwind, css, styled-componentsnone, mui, antd, shadcn
vuetypescript, javascripttailwind, cssnone
htmljavascriptcss, tailwindnone

Diagnostic Script

# Verify Figma token
curl -s "https://api.figma.com/v1/me" \
  -H "X-Figma-Token: ${FIGMA_TOKEN}" | jq '.handle // .err'

# Verify file access
curl -s "https://api.figma.com/v1/files/${FIGMA_FILE_KEY}" \
  -H "X-Figma-Token: ${FIGMA_TOKEN}" | jq '.name // .err'

Output

  • Error classified and root cause identified
  • Valid settings matrix for reference
  • Diagnostic commands for token and file verification

Resources

Next Steps

For collecting debug data, see anima-debug-bundle.

信息
分类 编程开发
名称 anima-common-errors
版本 v20260423
大小 3.54KB
更新时间 2026-04-26
语言