需用excalidraw原生.excalidraw格式导出草图,通过codex拖拽或命令行导入,ai自动提取模块、流程与逻辑,人工校验歧义项后导出带锚点链接的markdown+mermaid需求文档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把团队在白板上随手画的产品草图,快速变成可评审、可开发、带层级关系的需求文档——不是拍照存档,不是手动重录,而是让AI直接“读懂”手绘线条、标注和箭头,自动提取功能模块、用户流程和交互逻辑。
第一步:准备原始草图文件
打开 Excalidraw(Win/Mac 桌面版),确保当前画布处于编辑状态,且所有手绘元素均为矢量图形(非嵌入图片)。【必须关闭“导出为PNG”选项,只保留.excalidraw原生格式】
点击左上角「文件」→「导出」→ 选择「导出为 Excalidraw 文件(.excalidraw)」,保存到本地指定文件夹。不要用截图或PDF,Codex无法解析位图中的线条语义。
这一步操作起来很简单,直接把文件拖进去就行。但如果你导出的是 PNG 或 JPG,后续所有识别都会失败——AI 看不见手绘的笔触方向、连接关系和分组逻辑,只能当一张模糊的图来猜。
第二步:启动Codex并加载草图
打开 Codex 桌面应用(v2.4.1+),确认右下角状态栏显示「MCP Server: Connected」。
方法一:拖拽式导入
将刚保存的 .excalidraw 文件直接拖入 Codex 主界面空白区,松开即触发解析队列。
方法二:命令行调用
终端中执行:codex import --format=excalidraw --path=/your/path/to/sketch.excalidraw。该方式支持批量处理,适合连续导入3张以上草图。
【若首次导入后无响应,请检查Codex是否已授予磁盘读取权限——macOS需在「系统设置→隐私与安全性→完全磁盘访问」中启用】
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
第三步:触发结构化提取
第一步:在Codex聊天框输入指令:
“请将这张手绘草图转换为结构化需求文档,按模块划分,标注用户角色、触发条件与跳转逻辑。”
第二步:等待AI返回初始解析结果(通常耗时8–22秒)。此时会生成一个带折叠节点的树状大纲,包含「核心页面」「用户路径」「交互触发点」「待确认歧义项」四个一级节点。
第三步:对「待确认歧义项」节点逐条点击展开,Codex会高亮草图中对应区域(如模糊箭头、重叠文字、未闭合框),并提供2–3种语义推测供你选择。选错会导致后续模块归属错误,务必在此步人工校验。
这一步不能跳过。AI对手绘符号的理解存在天然模糊性——比如一个圆圈加箭头,可能是“刷新按钮”,也可能是“循环流程”,只有你才知道它实际代表什么。
第四步:导出为协作交付物
点击右上角「导出」按钮 → 选择「Markdown + Mermaid 流程图」格式 → 勾选「含原始草图锚点链接」→ 生成 deliverable.md。
该文件内每段需求描述后都附有超链接,点击即可跳转回Excalidraw原图对应位置。开发人员读到“搜索框需支持语音输入”时,顺手点链接就能看到你当时画的那个小麦克风图标和旁边潦草写的“mic?”。
如需同步至Confluence或Notion,直接复制全文粘贴即可。Mermaid代码会被自动渲染为可交互流程图,无需额外插件。








