要在Comate中用Plan智能体将模糊想法转为可执行路径，必须先加载项目代码、激活Plan智能体、输入含框架/版本/依赖/接口的精准需求，触发生成含技术选型、分工、契约、风险的plan.md，并手动校验契约、确认风险项、添加终审标记。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Comate中用Plan智能体把模糊想法变成可执行开发路径，必须先让AI理解你的真实意图，而不是直接扔一句“做个登录页”就点运行。
启动Plan智能体前的关键准备
打开Comate AI IDE，确保当前工作区已加载项目代码或至少初始化了空工程。若未加载任何代码，Plan将缺乏上下文依据，生成的计划可能脱离实际技术栈约束。
在对话输入框顶部点击智能体切换按钮→选择【Plan】→此时左下角状态栏应显示“Plan 智能体已激活”。
不要用“帮我写个后台管理页面”这类宽泛描述。Plan需要明确边界：比如“基于React 18 + Ant Design 5.12，为内部运营系统新增用户权限配置页，支持角色增删、权限勾选、实时保存，不接入SSO，后端API已定义在/api/v1/roles下”——这句话里包含了框架、版本、依赖、接口路径四项硬约束，Plan才能输出真实可用的计划。
输入需求并触发计划生成
在激活Plan状态下，直接输入自然语言需求，例如：“我们刚上线了新会员等级体系，需要在管理后台增加‘等级权益配置’模块，包含等级列表页（展示Lv0-Lv5）、每个等级的权益编辑弹窗（支持文本输入和开关控制）、提交后调用PUT /api/v1/membership/tiers接口。”
按下回车后，Plan会自动进入“澄清-分析-实现”三阶段流程，无需手动点击任何按钮。它会在几秒内返回一份结构化plan.md文档，内容含技术选型建议、前后端分工、接口契约草案、风险提示三项。
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
这一步不能跳过：Plan生成的plan.md默认保存在当前工作区根目录下的.comate/plan/子目录中，文件名按时间戳自动生成，如plan_20260724_173241.md。该文件是后续所有Agent（如Architect、Zulu）执行任务的唯一依据，【删除或修改此文件会导致后续Agent无法对齐原始设计】。
确认与微调计划内容
第一步：检查plan.md中的“接口契约”章节是否与你提供的API路径完全一致，特别是HTTP方法（GET/PUT/POST）、请求体字段名、响应状态码。若发现差异，立即在文档中手动修正——Plan不会二次校验你改过的内容，它只负责初始生成。
第二步：滚动到“风险提示”部分，重点关注“需人工确认项”。例如：“前端需确认Ant Design Form组件是否支持嵌套数组字段的动态校验”，这类条目必须由你打钩确认，否则Zulu在编码时可能绕过该逻辑导致运行时报错。
第三步：在plan.md末尾添加一行注释，格式为 。这行标记是Mission Mode识别“计划已终审通过”的唯一信号，没有它，后续Architect或Zulu不会自动启动编码任务。
