用途:诊断当前 Amplifier 会话中出现的问题,例如工具配置错误、操作失败或异常行为。当某处运行不正常时可使用。
主要能力:
- 接收问题描述($ARGUMENTS);若未描述,则读取会话日志并汇总错误、警告或值得注意的问题。
- 委托 session-analyst 代理调查当前会话,该代理可安全分析大型事件日志(events.jsonl 中单行可能超过 10 万 token,会压垮其他工具)。
- 检查会话配置中的常见问题:包组合问题(模块缺失、加载失败)、提供方配置(缺少 API 密钥、端点错误)、工具可用性(预期工具未挂载)、钩子失败(生命周期事件中出错)。
配置位置:
- 项目:.amplifier/settings.yaml
- 用户:~/.amplifier/settings.yaml
- 密钥:~/.amplifier/keys.env
常见模式:工具调用反复报错、提供方拒绝(限流、认证失败、模型未找到)、启动时模块挂载失败、上下文溢出或压缩问题。
输出方式:用通俗语言说明出了什么问题、可能原因和具体修复步骤。若仅凭日志无法诊断,建议运行 amplifier doctor 做系统健康检查,用 amplifier module list 验证模块可用性,或使用 amplifier --verbose 查看详细启动输出。
限制:依赖会话日志与配置信息;无法从日志判断的情况需借助上述命令进一步排查。