常见问题排查
按下面的现象排查。重试会修改文件或外部数据的任务前，先确认是否已有部分完成。报错或停止回复，不代表什么都没有发生。
应用无法启动
- 按系统要求与安装确认安装包匹配操作系统和处理器。
- 记录操作系统警告或启动错误原文。未确认安装包来源前，不要绕过安全警告。
- 能打开 Ghast 时，在 设置 → 关于 记录版本；完全无法打开时，提供安装包文件名。
不要一开始就删除 Ghast 配置，其中可能包含对话、Provider 设置和扩展。尝试重置或重新安装前先保留数据。
Chat 能打开但回复失败
- 阅读输入区旁的错误，记录是在发送前还是回复过程中失败。
- 没有选中模型时，按启用、测试和选择模型处理。
- 凭据或 Provider 停用错误，检查0G Compute 配置；余额不足则按充值说明处理，不要反复重试同一请求。
- 网络或超时错误，检查网络设置。
- 解决错误后，用快速开始的纯文字示例区分模型问题与附件、工具问题。该测试仍是真实模型请求，可能消耗用量。
简单示例成功后，只加回原任务真正需要的内容，再检查错误。任务可能已经发送、创建或修改对象时，重复前先核对目标系统。
Tool 不出现
检查所选模型是否支持工具，以及运行中的可见错误或待批准请求。外部服务到 插件 → 管理连接 查看状态及工具变更审查提醒；Skill 到 插件 → Skills 检查启用状态。当前添加菜单没有工具选择器；重新安装或改变权限前，先按扩展排查步骤定位。
Tool 执行失败
展开失败的工具卡，阅读错误、目标和命令退出码（若有）。等待权限时，按工具审批处理；等待批准不等于执行失败。
发送、删除、发布、创建或支付类动作先检查目标系统。如果已有结果，告诉 Ghast 从该结果继续，不要重新执行。不要为了消除原因不明的错误就切换为完全访问。
文件无法修改
- 确认当前工作区和文件完整路径。
- 在文件面板打开文件，必要时刷新目录树，检查实际内容。
- 阅读失败的工具结果，确认是否涉及路径不存在、只读位置或权限请求。
- 再次要求修改前，检查 Review 与行内 Diff。
自然语言中的“完成”不证明文件已经写入。预览失败也不证明文件为空，必要时用外部编辑器检查原件。
上下文太长
打开输入区旁的 上下文用量，移除待发送草稿中不需要的附件，只选择任务所需的工具与 Skills。已有长对话可以单独发送 /compact；没有变化或报错时见压缩与恢复。需要新建对话时，带上当前目标、限制与已验证进度，不要只复制最后一条回复。
Team Work Item 失败
打开对应工作项，阅读状态和最新说明，检查工作区、所需权限、Provider 错误及已生成的文件。在原任务中补充缺少的输入或明确修正；确认原任务是否仍活跃之前，不要创建重复任务。
Channel 不回复
打开对应渠道设置，确认机器人或应用是否连接。按该平台的配置指南检查允许的用户或会话、群聊提及要求及平台权限；不同渠道提供的控件并不相同。
Ghast 已收到消息但没有送达回复时，检查模型错误、送达状态，以及平台对消息或附件的限制。不要反复发送可能已经在运行的任务。
Voice、Web 和 Computer Use
语音输入检查麦克风权限和识别准备是否完成；语音朗读检查声音选择、播放控件及服务连接。这是两种不同功能，具体步骤见语音指南。
网页搜索检查引擎、所需登录状态与网络连接。不同引擎或账号的结果可能不同，详见网页搜索。
电脑控制按平台准备与权限检查处理。记录在哪个应用执行什么动作时失败，不要分享私人屏幕内容。
每类能力都有自己的会话和权限，不要用 Browser 的成功证明 Computer Use 成功。
提供有用的错误报告
说明 Ghast 版本（能够查看时）、操作系统、出错页面、模型或服务、大致时间、最短复现步骤、脱敏错误，以及失败前是否已经发生修改。
不要提供 API Key、钱包恢复信息、完整对话导出或客户数据。截图前检查账号信息和私人路径。能够打开 Ghast 时，反馈入口见关于与反馈。