# 常见问题（FAQ）

## 触发相关

### Q: 为什么我的请求没有触发 drawiodo 技能？

**A**: 检查你的请求是否包含以下关键词：
- "画一个 xxx 图"、"生成 xxx 图"、"做一个图表"
- "架构图"、"流程图"、"UML 类图"、"ER 图"、"时序图"、"思维导图"
- "用 draw.io 画"、"生成 drawio 文件"

如果不包含，可以手动触发：在请求中明确提到 "draw.io" 或 "drawio"。

### Q: 什么情况下不应该触发这个技能？

**A**: 以下情况**不触发**：
- 用户只是问"你会画图吗"、"有什么画图工具"——这是闲聊
- 用户明确要求用其他工具（如"用 mermaid 画流程图"）
- 用户只是提到"图"这个字，但没有画图意图（如"这个图怎么读"）
- 用户要求编辑已有的图片文件（如 .png/.jpg）——本技能生成的是 .drawio 文件

## 使用相关

### Q: 生成的图表在哪里？

**A**: 默认输出到 `{workspace}` 目录，文件名格式为 `{类型}_{描述}.drawio`。

### Q: 如何更新已生成的图表？

**A**: 直接告诉 AI 你的更新需求，AI 会在当前文件基础上精确更新，并保存为新版本（v1 → v2 → v3...）。最多保留5个版本。

### Q: 如何回溯到之前的版本？

**A**: 告诉 AI "回退到v2" 或 "看一下v1的样子"，AI 会用 `drawio_version.py restore` 命令恢复指定版本。

### Q: 网页版 draw.io 可以打开生成的文件吗？

**A**: 可以，但需要通过 HTTP 服务方式（CORS 限制）。最简单的方式是用本地 `draw.io.exe` 打开。网页版没有干净的自动化接入方式。

## 技能开发相关

### Q: 如何添加新的图表模板？

**A**: 在 `scripts/drawio_templates.py` 中添加新的模板函数（参考现有的 `create_flowchart()` 等），然后在 SKILL.md 的 "支持的 type" 列表中添加新类型。

### Q: 如何调整默认样式？

**A**: 更新 `scripts/drawio_gen.py` 中的 `Styles` 类，或添加新的样式常量。

### Q: 审计时提示 SKILL.md 超过200行怎么办？

**A**: 将详细内容拆分到 `references/*.md`，在 SKILL.md 中用 `→ 详见 references/xxx.md` 引用。保持 SKILL.md ≤ 230行。