用途:对运行中的 AionUi 安装进行只读故障诊断,定位会话卡死、提供商或模型失败、定时任务未运行、MCP 服务器无工具、团队成员无响应等问题。
主要能力:通过内置 CLI 的 diagnose 子命令读取后端健康状况与版本信息、跨域概览、会话运行时与消息、提供商健康摘要、定时任务摘要、MCP 摘要、团队摘要以及日志尾部,必要时用受控的 HTTP GET 读取未被命名命令覆盖的只读接口。
使用方式:只使用 "$AIONUI_HELPER_BIN" diagnose ...。不确定可用命令或 stdin 字段时先运行 "$AIONUI_HELPER_BIN" diagnose capabilities。宽泛的“坏了”报告先运行 "$AIONUI_HELPER_BIN" diagnose overview,再按 providers.unhealthy、mcp.enabled_but_no_tools、cron.failing、running_conversations 等线索下钻。会话诊断使用 conversation_id 选择器,"current" 由 AIONUI_CONVERSATION_ID 解析,后端相关命令同时使用 AIONUI_BASE_URL 和 AIONUI_USER_ID。日志可通过 AIONUI_LOG_DIR 定位,也可显式传入 log_dir。
限制:所有命令视为只读,本技能只诊断不修复;修改配置需改用 aionui-config 技能,创建或更新定时任务用 cron 技能或 aionui-config 的 cron 命令;HTTP 逃生口仅支持 GET,路径须为 /health 或以 /api/ 开头,输出会被脱敏且可能截断;切勿打印原始提供商、MCP 头、令牌、密码或密钥值;单次运行快照不能证明卡死,需重复检查同一会话并比较运行时字段、消息进度与日志,一次快照后只能说“疑似卡死”,反复未变才可称“已确认卡死”;已知噪声如 No onPostToolUseHook found for tool use ID 警告不一定是根因。