READ / 带走
- 先保留失败现场，不连续点击重试
- 从账号、模型、工作区、能力到任务逐层缩小范围
- 同时检查界面状态、执行记录和真实产物
遇到问题时，先记录发生时间、当前入口和最后一个成功步骤。反馈问题可使用 设置 → 通用设置 → 导出诊断包；不要附完整访问密钥、Cookie、OAuth 凭证或含隐私的项目内容。
五分钟快速定位
先做这些检查
- 确认 Astravia、网络和目标外部服务当前可用。
- 新建一个短会话，显式选择模型，只发送一条最小消息。
- 确认会话绑定的工作目录真实存在，当前系统用户可访问。
- 暂时移除不必要的 MCP、技能、附件和长上下文，缩小变量。
- 打开失败任务的会话或历史，记录原始错误和发生时间。
| 现象 | 可能所在层 | 第一项检查 |
|---|---|---|
| 任何会话都无法回复 | 登录、模型或网络 | 新会话中显式选择一个已验证模型 |
| 只有某个项目失败 | 工作目录、项目指令或权限 | 路径是否存在，沙盒是否允许目标动作 |
| 只有某个外部工具失败 | MCP 进程、URL 或授权 | 能力 → 我的 中的连接和启用状态 |
| 显示成功但没有文件 | 任务验收条件或路径 | 检查工具记录和目标目录，而不是最终回复 |
| 到点未执行 | 自动化状态或本机环境 | Astravia 是否运行、设备是否睡眠、任务是否启用 |
| 多个子任务同时失败 | 共享提示、模型限流或目录模式 | 把并发降到 1，并打开一个代表性会话 |
按现象排查
提交可复现的问题
如果最小场景仍失败，请在 GitHub Issues 提供：
- Astravia 版本、操作系统和安装来源。
- 最小复现步骤、期望结果和实际结果。
- 问题发生时间，以及是稳定复现还是偶发。
- 已脱敏的原始错误、相关执行历史和诊断包。
- 一个不含私有数据的最小示例项目（确有必要时）。
安全问题不要公开披露利用细节或凭证，先阅读安全与数据边界中的报告入口。