故障排查
按看到的症状查:消息发不出去、MCP 连不上、文件树报错、终端打不开、提醒不响、任务不执行,每条给原因和该动哪一处。
更新于 2026年11月11日
条目按你看到的症状组织,不按功能组织。找到最接近的一条,看它的「常见原因」与「处理」。
消息发不出去,提示没有可用模型
常见原因:当前会话选的模型不属于任何可用渠道,或渠道被关掉了。
处理:打开模型选择器重新选一个;如果所有渠道都不可用,去「模型配置」确认官方渠道开关是开的、账号还在登录状态。
弹「Proma Cloud 额度不足」
常见原因:积分用完了。这不是配置问题,换模型也一样。
处理:点弹窗里的「查看使用额度」去购买;企业账号的额度由管理员分配,自己买不到那部分。
长会话突然报上下文过长
常见原因:上下文已经接近模型窗口上限。
处理:错误卡片上的「压缩上下文」就地压缩后继续;也可以直接发 /compact。压缩是有损的,要精确保留的结论先写进文件。
MCP 一直显示「待配置」或连接失败
常见原因:启用了但从没成功握手过,通常是凭据、命令路径或网络问题。
处理:进详情点「测试连接」看具体原因。常见结论有三种——「命令不存在或不可执行」说明本机没装那个命令;「无效的 URL 格式」是地址写错;「MCP 握手或工具发现失败」通常是 token 过期或服务不可达,重新走一次 OAuth 授权。
在会话里打 # 看不到某个 MCP
常见原因:它没启用,或启用了但验证没通过。# 只列已启用且握手成功的服务器。
处理:在 MCP 页把开关打开,等验证通过;失败会弹「X 启用失败」并给出原因。
装好的 Skill 在 / 里找不到
常见原因:Skill 属于另一个项目,或者被停用了。
处理:Skills 按项目安装,换项目要重新导入;卡片右上开关关掉时不会出现在候选中。
文件树显示「本地项目根目录不可用」
常见原因:项目的那个文件夹被移动、改名或删掉了。
处理:项目菜单里选「重新选择文件夹」指回去,或在原路径新建空文件夹。此期间会话文件仍然可访问。
终端打不开,提示工作目录不存在
常见原因:从某个目录进入的终端要求那个目录真实存在,它不会退到主目录。
处理:改从右上角「+」里的「终端」打开,那个入口在目录失效时会退到用户主目录。
浏览器页面打不开,或点了授权没反应
常见原因:站点权限一律拒绝,摄像头、麦克风、定位、通知都无法授权;网络侧也可能被拦。
处理:需要这些权限的操作改用系统浏览器手动完成。页面打不开时先用地址栏确认地址,内置浏览器对无协议域名补 https,本地地址用 http。
说了一句话没有任何反应
常见原因:语音输入开关没开,或者麦克风权限被系统挡了。
处理:设置 →「语音输入」看麦克风权限那一行。状态是「已被系统阻止」时要去系统设置里放行,应用内点授权不会有反应。语音输入关闭时点麦克风只会提示「请先在设置中打开语音输入开关」。
提醒没有响
常见原因:Proma 没在运行,或者桌面通知被关了。
处理:提醒由应用自己在运行时检查,不写进系统日历;应用退出后不会响。设置 →「通用设置」里确认「桌面通知」是开的。必须一定响的事,用系统提醒事项。
定时任务到点没有运行
常见原因有以下三种:应用没运行;上一次连续失败已经自动暂停;本次因为条件不满足被跳过。
处理:先看任务详情里的运行历史,那里有每次的状态和失败原因。连续失败五次会自动暂停,修复原因后手动恢复。跳过不计入失败次数,但也不会补跑。
磁盘占用越来越大
常见原因:会话消息和附件在长期累积。
处理:设置 →「磁盘管理」看六类占用。只有临时预览和安装文件可以直接清理;要真正回收空间,删掉不需要的会话,或给「已归档会话数据」设置自动清理天数。
右侧那一栏不见了
常见原因:空白的新会话默认收起右侧工作区。
处理:Cmd/Ctrl + Shift + B 展开,或点标题栏的展开按钮。有未查看改动时那个按钮上会带红点。
注意
- 排查时优先看界面给出的原文提示,上面每一条都对应一句具体文案;文案不同,原因通常也不同。
- 改完配置不一定立刻生效:MCP 需要重新验证,Skill 需要重新加载,模型切换对下一轮才起作用。
- 反复出现同一个报错,把提示原文和复现步骤带上再问,比描述「报错了」有用得多。