若figma中ai生成的ui组件库缺少配套说明文档，需通过五种方法补全：一、用codex插件追加结构化文档指令；二、借figma mcp server提取上下文反向生成；三、用hg-ha/mtools一键生成带语义标注；四、在画布内嵌prompt触发magician续写；五、调用figma api+本地llm批量生成统一文档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Figma中使用AI生成UI组件库后发现缺少配套说明文档，则可能是由于AI插件未被明确指令生成描述性内容，或未注入设计系统上下文所致。以下是解决此问题的步骤：
一、在Codex插件中追加结构化文档生成指令
该方法利用Codex对MD文档的解析能力，在已有组件基础上补全说明文档。需确保原始需求文档已包含文本样式、间距逻辑、交互状态等元信息。
1、打开Figma文件，启动Codex插件。
2、在对话框中输入：请基于当前文件中的所有组件，读取此前提供的MD文档链接[粘贴链接]，生成一份完整的组件库说明文档，包含每个组件的用途、变体说明、使用约束与设计原则。
3、等待Codex创建新页面，命名为“Documentation”，自动填充带层级标题的Markdown式文本框。
4、检查生成内容是否覆盖颜色变量引用、响应式断点说明及禁用场景提示，缺失项可追加指令：“请为Button组件补充‘禁用状态下不可触发API调用’的使用约束”。
二、通过Figma MCP Server提取上下文并反向生成Description
该方法依赖Figma MCP Server将画布结构实时同步至AI代理，使说明文档严格对齐图层命名、嵌套关系与自动布局参数，避免人工撰写偏差。
1、确认已按指南配置VS Code连接Figma MCP Server，且服务器ID为figma。
2、在VS Code中打开聊天工具栏，切换至Agent模式，输入指令：#get_design_context —include components,variables,constraints。
3、待返回JSON格式设计上下文后，复制全部内容，粘贴至本地AI工作台（如HG-ha/MTools）的「标注生成」模块。
4、点击“生成Markdown说明”，系统将输出含组件ID、图层路径、约束条件、字体缩放比等精确参数的结构化文档。
三、使用HG-ha/MTools一键生成带语义的标注说明
该工具专为UI设计师优化，无需编码即可从图层结构中自动识别视觉语义，并映射为自然语言描述，支持中英文双语输出与Figma原生文本框直写。
1、启动HG-ha/MTools桌面应用，确保Figma已登录同一账号。
2、在Figma中选中目标组件框架（如“Button/Primary”），点击MTools主界面的「标注生成」按钮。
3、在弹出面板中勾选“启用语义理解”与“输出设计意图注释”两项。
4、点击“执行”，MTools将在组件右侧自动生成文本框，内容包括：用途说明（例：“主操作按钮，仅用于表单提交或关键跳转”）、尺寸规范（例：“高度48px，内边距16px，圆角8px”）、禁用逻辑（例：“禁用时透明度设为0.4，不可响应hover”）。
四、在Figma画布内嵌入Prompt并触发Magician插件续写
该方法适用于已有部分文案基础的场景，通过局部文本锚点引导AI延续生成专业级说明，确保术语与团队设计系统保持一致。
1、在组件旁新建文本框，输入已有简短说明，例如：“Card组件｜展示内容摘要与操作入口”。
2、在下方另起一行，输入提示句：请扩展为完整说明文档段落，包含：适用场景、子组件构成、间距规则（上/下/左/右）、可替换内容类型、禁止嵌套对象。
3、同时选中上述两段文本，运行Magician插件的“文案续写”功能。
4、AI将输出结构清晰的段落，直接保留于画布中，支持后续导出为PDF或同步至Notion。
五、调用Figma API + 本地LLM批量生成跨页面统一文档
该方法适合拥有多个Figma文件的大型设计系统，通过脚本批量抓取组件属性，交由本地大模型（如Ollama运行的Llama-3-405B）生成风格统一、术语可控的说明文档。
1、使用Python脚本调用Figma REST API，获取指定文件中所有componentSet节点的name、description、key及constraints字段。
2、将返回数据整理为JSONL格式，每行对应一个组件及其元数据。
3、将JSONL输入本地LLM推理服务，提示词设定为：你是一名资深设计系统工程师，请根据以下组件元数据，用中文生成一段200字以内、面向开发者的说明文字，禁止使用模糊形容词，必须包含具体数值与硬性限制。
4、接收模型输出，按组件名称自动写入Figma新页面的文本框中，完成全量文档覆盖。
