【Trae 超简配置】draw.io AI 绘图技能（Windows）：SKILL.md 骨架与 settings.json 验证

1. Windows 下 Trae 接 draw.io 绘图技能到底卡在哪Trae 本身是个能读写文件、跑命令的编码助手但它默认不会画图。你让它“画个 RAG 流程图”它顶多给你一段 Mermaid 文本样式和布局你没法细调。draw.io 的 AI 绘图技能drawio-cli就是补这块短板的它把 draw.io 桌面客户端的导出能力包装成一个 Trae 可调用的技能AI 生成.drawio源文件后直接调本地客户端导出成 PNG/SVG你还能双击源文件继续改。这套东西在 Windows 上落地卡点基本集中在三个地方一是SKILL.md里写死的路径是 macOS/Linux 风格Windows 的draw.io.exe路径带空格和反斜杠不改成绝对路径就调不起来二是导出命令的参数在 Windows 下要调整否则报“找不到命令”三是 XML 引用路径如果指向网络地址断网或加载慢时技能直接失效。这篇就按“能复制、能跑通、能排错”的节奏把SKILL.md骨架和settings.json验证片段给你摆清楚顺带说下统一 Key/API 通道该填在哪。适合谁看已经在用 Trae 做开发、想让 AI 顺手出架构图/流程图的 Windows 用户或者你之前配过一半导入技能后没反应想找排查点的人。下面所有路径示例都用C:\Users\你的用户名\这种可替换写法你照着换成自己的就行。2. 前置准备draw.io 客户端、技能包与统一通道动手前先把三样东西备齐顺序别乱。第一装 draw.io 桌面客户端。去 draw.io 官网下 Windows 安装包开源免费。装完记住主程序路径默认一般在C:\Program Files\draw.io\draw.io.exe如果你改过安装盘比如装到 D 盘那就是D:\Program Files\draw.io\draw.io.exe。这个路径后面要原样写进SKILL.md一个字符都不能错。第二拿 drawio-cli 技能包。从 jgraph 的 drawio-mcp 仓库里找到skill-cli/drawio目录把整个drawio-cli文件夹下载下来解压到一个固定位置。推荐放在 Trae 的技能目录下比如C:\Users\你的用户名\.trae-cn\skills\drawio-cli。放这里的好处是 Trae 扫描技能时能直接认到省得你手动指路径。第三准备统一 Key/API 通道。Trae 调用模型、技能调外部能力如果每个都单独配 Key后面换起来很烦。TaoToken 提供的就是一个统一入口官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基址是https://taotoken.net/api。你需要在控制台生成一个 API Key这个 Key 后面会填进 Trae 的模型配置或环境变量里作为技能调用模型时的鉴权凭证。生成入口在控制台的 API Keys 页面拿到一串sk-开头的字符串先存好。注意Key 只填在配置文件的对应字段里别写进SKILL.md正文也别提交到 Git。技能包是给别人复用的Key 是你私人的。目录组装完应该是这个结构drawio-cli/ ├─ SKILL.md # 核心配置唯一需要改的文件 ├─ reference/ │ └─ xml-reference.md # 本地 XML 引用解决断网加载失败 └─ 其他脚本/资源文件保持原样3. 可复制配置SKILL.md 骨架与 settings.json 片段3.1 SKILL.md 骨架用 VS Code 或记事本打开drawio-cli/SKILL.md重点改三处客户端路径、导出命令、XML 引用路径。下面是一个可直接套用的骨架你把路径换成自己的# drawio-cli skill ## 描述 调用本地 draw.io 客户端将 AI 生成的 .drawio 源文件导出为 PNG/SVG。 ## 客户端路径 C:\Program Files\draw.io\draw.io.exe ## 导出命令 C:\Program Files\draw.io\draw.io.exe --export --format png --output {output} {input} ## XML 引用 reference/xml-reference.md ## 使用约束 - 输入文件必须是合法 .drawio XML - 导出前确认客户端路径存在 - 输出目录需提前创建三处关键点逐个说。客户端路径这行Windows 下必须用绝对路径且路径里有空格时在导出命令里要用英文双引号把整个 exe 路径包起来否则命令行会把Program和Files拆成两个参数。导出命令里的{input}和{output}是占位符技能运行时会替换成实际文件路径你别改成别的名字。--format可以换成svg或pdf看你要什么格式。XML 引用这行指向本地reference/xml-reference.md这样断网也能加载图形定义不会因为拉远程资源卡住。3.2 settings.json 验证片段Trae 的技能和模型配置里settings.json负责把统一通道的地址和 Key 接进来。下面这段是验证用的最小片段放在 Trae 的用户配置或项目配置里{ skills: { drawio-cli: { enabled: true, path: C:\\Users\\你的用户名\\.trae-cn\\skills\\drawio-cli } }, model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet } }字段含义skills.drawio-cli.path指向技能文件夹注意 JSON 里反斜杠要写成\\转义enabled为true才会被加载。model.baseUrl填 TaoToken 的 API 基址apiKey填你控制台生成的 Keymodel填你要用的模型名。这样模型请求走统一通道技能调用本地 draw.io两边不打架。提示如果你在 Trae 界面里已经有模型配置就不用重复写model段只要保证baseUrl和apiKey指向 TaoToken 即可。技能段是必须的。4. 导入与验证确认绘图技能真的生效配置改完把整个drawio-cli文件夹压缩成 ZIP。注意是压缩文件夹本身别把里面的文件单独拖出来压否则导入后目录层级会乱。打开 Trae → 设置 → 技能 → 导入技能 → 选这个 ZIP导入成功后重启 Trae。重启后做三步验证。第一步看技能列表里drawio-cli是不是显示已启用。第二步在 Trae 对话框里输入一句测试指令比如“用 draw.io 帮我画一个 RAG 项目的流程图包含检索、重排、生成三个阶段”。第三步观察 Trae 的执行日志正常的话它会先生成一个.drawio文件然后调draw.io.exe --export导出图片最后告诉你输出路径。如果导出成功你会得到一个 PNG 和一个.drawio源文件。双击源文件用 draw.io 客户端打开能继续改样式、拖布局。这一步能打开说明技能链路是通的。想单独验证模型通道是否正常可以打开模型对话页面发一条简单消息看有没有正常返回。如果模型对话通、但绘图技能没反应问题就在技能配置或客户端路径上跟 Key 无关。5. 本篇常见错排查报错一C:\Program 不是内部或外部命令。这是导出命令里 exe 路径没加引号Windows 把空格当分隔符了。回到SKILL.md把导出命令改成C:\Program Files\draw.io\draw.io.exe --export ...整个路径用双引号包住。报错二导入技能后列表里没有 drawio-cli。先确认 ZIP 压缩的是文件夹本身解压后第一层就是drawio-cli而不是drawio-cli/drawio-cli。再确认settings.json里path的反斜杠转义写对了C:\Users在 JSON 里必须写成C:\\Users。最后确认enabled是true。报错三导出时提示找不到输入文件。多半是 AI 生成的.drawio文件路径和导出命令里的{input}没对上。检查技能运行时的工作目录必要时在SKILL.md里把输入输出都写成绝对路径别用相对路径。报错四图形加载失败或空白。这是 XML 引用指向了网络地址断网或慢网时拉不到。把SKILL.md里的 XML 引用改成reference/xml-reference.md本地路径并确认这个文件确实在技能包里。报错五模型请求 401。Key 填错或过期。去控制台重新生成一个替换settings.json里的apiKey。注意别把 Key 前后的空格带进去。报错六draw.io 客户端弹窗但没导出。有些版本需要先激活一次客户端手动打开 draw.io 随便存个文件再回来跑技能。另外确认客户端版本别太老老版本命令行参数支持不全。6. 后续怎么用把绘图接进日常编码流技能跑通后最顺手的用法是把它和编码任务绑在一起。比如你在 Trae 里让 AI 读一个项目的目录结构然后直接说“根据这个结构画一张模块依赖图”它会生成.drawio并导出。你拿到图之后双击源文件微调改完再导出一次覆盖原图。如果你要长期跑这类带技能的编码任务建议把模型通道固定成 Coding Plan 那套配置省得每次调参数。Key 和通道地址在控制台和接入文档里都有说明照着填就行。绘图技能本身不复杂难的是路径和引号这些 Windows 细节配一次后面就省心了。