先刷新页面过滤30%假性失败，再悬停报错看提示；清除零宽空格等隐性字符；分段测试锁定故障段；检查本地服务状态与模型路径配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
提示词写完后反复生成失败，不是模型罢工，而是输入内容在解析阶段就被静默拦截或中途卡死——你看到的“无响应”“空结果”“报错框一闪而过”，90%以上都源于文本结构、字符隐性污染或服务链路断裂，而非提示词本身逻辑错误。
先揪出真正“假失败”
按 Ctrl+R 刷新当前页面再试一次。很多所谓“失败”其实是前端请求超时或服务端临时抖动，刷新能绕过缓存和断连状态，直接过滤掉约30%的无效报错。
鼠标悬停在红色报错文字上，等1秒看是否弹出小提示。如果显示“括号未闭合”“风格词未注册”“token超限”，说明是语法/用词问题；如果只显示“请求失败”且无任何附加信息，大概率是网络或服务端抖动，不用改提示词，直接刷新或换时段重试。
清除肉眼看不见的“毒字符”
复制原始提示词 → 粘贴到记事本（Windows）或 TextEdit（macOS，设为纯文本模式）→ 启用“显示所有字符”功能 → 删除开头的 EF BB BF（UTF-8 BOM头）、行末尾的零宽空格（U+200B）、软回车符（U+2028）等不可见控制符 → 全选复制 → 回原平台粘贴提交。
这一步必须做。微信、网页、Notion 复制的内容常带隐形字符，aishort 和石墨AI 的预处理器会直接拒绝处理含 BOM 或零宽空格的文本，不报错、不提示，只静默失败。
拆解验证，锁定故障段落
第一步：把提示词切成三段分别提交测试：
① 角色+目标（如“你是一位UI设计师，要生成登录页配图”）→
② 输入约束（如“尺寸1920×1080，主色#3A7BFF，禁止出现人脸”）→
③ 输出要求（如“输出为PNG，背景透明，保留图层结构”）。
哪一段单独提交时报错，问题就锁定在哪。常见陷阱是第二段混入了中文全角括号()或中括号[]，石墨AI解析器会直接卡死；第三段若写了“必须包含‘立即体验’按钮”，而引号用了中文全角“”，也会触发校验失败。
【括号及其内容是石墨AI解析器最常卡死的位置】
检查本地服务是否真活着
打开终端，执行：curl -s http://127.0.0.1:8001/health | jq .status。预期返回 "healthy"。
若提示 connection refused，说明 aishort 依赖的本地 LLM 服务没启动。运行 ps aux | grep aishort-server 查进程，若无结果，进入 aishort 安装目录，执行：python server.py --port 8001 --model tiny-llm-v2 手动拉起服务。
注意：日志里必须出现 Uvicorn running on http://0.0.0.0:8001，而不是 binding to 127.0.0.1——后者会导致前端无法连接。
重置模型缓存与模板路径
定位 aishort 主目录下的 .cache/model_config.json 文件，用文本编辑器打开，检查 "tokenizer_path" 和 "weights_dir" 字段值是否为绝对路径且对应目录真实存在。
任一路径不存在，就手动创建该目录，或修改字段指向已知有效的模型子目录（如 ./models/tiny-llm-v2/tokenizer/）；然后删除 .cache/prompt_templates.bin 文件，强制触发模板重建。
