常见问题排查

应用一直停在启动界面

完全退出后重新启动一次，并保留首次错误。若仍失败，不要删除应用数据目录或手工修改数据库；记录应用版本、系统版本和启动阶段提示，用于继续定位。

无法登录账户或无法启动新的 Agent 回合

Captain Who 使用账户登录和软件许可校验来决定能否启动新的 Agent 回合。遇到登录、许可或验证提示时：

确认网络可用、系统时间正确，并在应用或官网的正确域名中完成登录；
在账户界面检查登录状态；需要管理许可时，使用应用打开的官方账户页面；
许可校验暂时不可用时，稍后在应用中重新验证，不要反复提交同一条可能产生外部副作用的请求；
不要删除应用数据目录、手工改写会话文件，或把账户密码、验证码、会话信息发送给模型、MCP Server 或他人。

账户或许可校验失败不会说明账户服务能读取本机项目或对话。有关数据边界见数据与权限。

应用内更新没有完成

正式签名 macOS 发行版在完整初始化后，只有可访问的官方更新源提供新版本时才会显示下载入口。由用户选择下载后，下载、完整性校验和原生准备完成，应用会退出并重新启动以安装。更新源、下载或安装准备失败时，不要通过反复点击或强制结束进程来假定旧版本一定保持不变；先保留首次错误，完成正在写入的本地工作后，再按升级指南中的手动升级步骤处理。

模型请求失败

依次检查：

API URL 是否为完整的 http 或 https 地址；
Token 与 URL 是否来自同一个 Provider；
模型标识是否与服务商实际名称一致；
模型是否已启用；
所选兼容配置是否与服务商协议一致；
网络、账户余额、速率限制和服务状态。

配置完整不代表远端已经验证。不要把完整 Token 放进截图或任何要共享的排查材料。

Agent 一直等待批准

打开对应对话，查看等待中的具体动作。批准或拒绝后，Agent 会尝试继续同一个 Run。通知只负责提醒，不能替代批准；如果状态仍未更新，刷新对话后再检查，不要新建重复任务。

MCP Server 无法启用

当前只支持本机 stdio，不接受 HTTP URL。
确认可执行文件与工作目录仍存在。
保存配置后还需单独启用，并在确认框中授权启动。
程序、参数、工作目录或代码入口变化会使旧授权失效。
Catalog 不完整时，检查 Server 的 Tool 名称和 schema，而不是开启自动执行。

如果调用结果显示未知，不要自动重试；调用可能已经到达 Server。

Skill 没有出现或未触发

Workspace Skill 必须位于 .agents/skills/<name>/SKILL.md，并使用精确大小写。
检查 YAML front matter 中的 name 与 description。
确认 Skill 已启用，且当前任务打开了正确项目。
修改后新建任务测试；已经开始的 Run 会继续使用冻结版本。
描述过宽会误触发，过窄则可能不触发。

浏览器自动化不可用

确认“设置 → 浏览器”中的浏览器自动化能力已允许，并在当前任务中批准能力激活。网页权限、敏感站点、文件上传、下载和网络目标还可能需要单独批准或被安全策略拒绝。

站点需要摄像头、麦克风、定位或网页通知时可能无法正常工作，因为受管浏览器默认拒绝这些网页权限。

浏览器下载找不到或历史显示异常

先打开浏览器工具栏的下载中心；已完成项目可以在文件夹中显示。再到“设置 → 浏览器 → 下载历史记录”检查：

“文件不存在”表示文件已被移动、删除或不再是普通文件；
“文件已修改”表示当前大小与下载完成时不同；历史页不会检测同尺寸内容替换；
Agent 下载不会弹出保存位置对话框，会使用当前配置目录；
清除下载历史只删除 Captain Who 的记录，不保证删除文件。

Scheduled Automation 没有运行

确认应用在计划时间运行。
确认任务为 Active，健康状态不是 Blocked。
检查模型、项目、目标对话和权限模式仍然可用。
查看 Run 是否处于排队、运行或等待批准状态。
修复 Blocked 配置后重新保存任务；资源恢复不会自动解除 Blocked。

调度不是秒级定时器。已有活动 Run 时，同一任务不会并行启动另一个 Run。

原生通知没有出现

检查操作系统是否允许 Captain Who 发送通知，并确认“设置 → 常规”中的普通任务通知或对应 Automation 的通知策略允许这类事件。普通任务以实际对话为准，Automation 以“已安排”页面的 Run 和 attention 为准。通知不是任务执行成功的证明；当前没有界面 Toast 作为系统通知的后备。极少数情况下，应用在“通知已显示、确认尚未保存”之间退出，重启后可能重复一次。

Office、PDF 或图片任务失败

确认文件格式受支持，扫描 PDF 是否含文本层。
确认输出目录可写，输入文件没有被其他程序锁定。
图片生成需要完整、已启用的 Provider 配置；本地“就绪”不代表远端模型和密钥已验证。
远端图片请求超时后可能已经计费或生成，不要直接重复提交。