emergent ai生成失败时需按三步排查：一是精简指令为“动词+名词+约束条件”；二是清除中文标点与全角字符；三是确认技术栈在支持列表内，并确保claude.md文件存在且未被忽略，同时可切换至us-west-2或sg-singapore节点并启用v2.3.7-base模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Emergent AI生成软件时出现空白输出、流程中断或界面卡死，说明自然语言指令未被平台正确解析或执行链路在多智能体协作环节发生阻断。
确认输入指令是否触发平台语义校验
Emergent对自然语言指令的结构敏感度远高于传统编码工具，模糊、跨域或含隐喻的表述会直接导致任务拒绝而非降级执行。
第一步：删掉所有修饰性副词和主观判断词，只保留“动词+名词+约束条件”三要素。例如把“帮我做一个酷炫的电商首页，要现代感强一点”改成“创建电商首页，包含商品列表区、搜索栏、顶部导航，使用深蓝+白配色，响应式布局”。
第二步：检查是否混入中文标点、全角空格或换行符。Emergent前端会将全角逗号、中文顿号识别为非法分隔符，导致整个提示被截断。用记事本粘贴后手动替换为英文逗号与半角括号即可修复。
第三步：验证指令中是否出现平台未支持的技术栈关键词。当前Emergent仅支持React/Vue/Next.js/Tailwind/Prisma等12个明确列出的框架与库，若写入“用SvelteKit构建后台管理页”，任务将静默失败且不报错。
检查项目上下文文件CLAUDE.md是否存在
Emergent虽不依赖Claude模型，但沿用了其上下文注入机制——它会在项目根目录查找CLAUDE.md作为唯一可信上下文源。缺失该文件会导致AI无法识别技术栈、目录结构与编码规范，生成代码风格混乱或路径错误。
方法一：在项目根目录新建CLAUDE.md，粘贴以下内容并保存：
使用 @youdotcom-oss/teams-anthropic 将 Anthropic Claude 模型（Opus、Sonnet、Haiku）添加到 Microsoft Teams.ai 应用程序中。可选集成 You.com MCP 服务器以进行网页搜索和内容提取。
```markdown
项目说明
基于Next.js 14 + TypeScript的SSR电商前台。
技术栈
UI框架：Tailwind CSS v3.4
状态管理：Zustand v4.5
API调用：SWR v2.2
部署目标：Vercel
目录结构
app/: 页面路由
components/: 可复用UI组件
lib/: 工具函数
types/: 类型定义
编码规范
组件名首字母大写，文件名小写加中划线
API路由统一放在app/api下
所有异步操作必须带loading状态反馈
```
【注意：文件名必须是CLAUDE.md，大小写不可更改，否则平台完全忽略】
方法二：若已在根目录存在该文件，检查其是否被.gitignore排除或被IDE设为隐藏文件——Emergent只读取可见的、未被版本控制忽略的CLAUDE.md。
切换生成通道与模型版本
Emergent默认启用多通道冗余调度，但部分区域节点存在模型权重加载异常，表现为生成进度条卡在80%或突然跳回初始状态。
方法一：网页端右上角点击用户头像→「设置」→「高级选项」→关闭「自动选择最优通道」→手动选择「US-West-2」或「SG-Singapore」节点。这两个节点目前故障率最低，且已同步最新v2.3.7模型权重。
方法二：Android/iOS App内长按底部「生成」按钮3秒，触发通道重置菜单，选择「强制刷新模型缓存」。此操作会清空本地模型元数据，重新从CDN拉取完整权重包，耗时约12秒，但可解决93%的通道级生成失败。
方法三：若前两步无效，在提示词末尾添加硬性指令：“使用Emergent-v2.3.7-base模型，禁用插件增强模块”。该指令会绕过所有第三方扩展服务，进入纯原生生成模式，适用于企业防火墙环境或高合规要求场景。
