文档常见问题
文档目录

故障排查

按看到的症状查:消息发不出去、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 需要重新加载,模型切换对下一轮才起作用。
  • 反复出现同一个报错,把提示原文和复现步骤带上再问,比描述「报错了」有用得多。
本页内容