FX 数据诊断

辅助排查 fx-data 的执行慢、更新失败、内存超限等问题。

安装

向你正在使用的 Agent 发送：

帮我安装并启用 FX 数据诊断，npm 包是 @fx-data/ai-diagnostics。

等待安装完成即可。换一个 Agent 时，发送同一句话，已有安装会自动复用。

使用

安装后可以从一条具体的执行记录开始：

用 FX 数据诊断分析这条 trace 为什么内存超限。

附上实际发生问题的 traceId 或链接。首次查询线上数据时，按提示配置对应环境的 SigNoZ API Key。

也可以提供更新的 dagId，询问这次更新为什么慢；或附上 Metric 文件，分析耗时和内存。描述问题时带上“用 FX 数据诊断”，也可以在技能列表中选择“FX 数据诊断”。

要一份单租户更新报告，可以说「用 FX 数据诊断分析 corp-xxx 租户近 3 天的更新情况，生成 HTML 报告」。

更新

每次开始新诊断时，工具会先检查更新；有新版时下载、校验并切换后再开始排查，通常只多一两秒。进行中的调查保持原版本，更新失败也不影响排查。更新静默完成；需要确认当前版本或更新结果时，可要求 Agent 检查。

需要立即更新并等待完成时说：

更新 FX 数据诊断。

旧版用户先手动更新一次，即可获得自动更新能力。若新版有问题，可以说“把 FX 数据诊断回退到这次更新前的版本”；需要持续使用旧版时，同时让 Agent 关闭自动更新。

卸载

卸载 FX 数据诊断。

卸载会删除 npm 包、本机当前账户下的诊断能力包（含规则和知识）及已登记的各 Agent 入口。用户提供的日志、Metric 文件和生成报告，以及独立配置的 SigNoZ 连接会保留。

给 Agent： 按 Agent 执行说明 完成安装与管理。已有本地包时，优先读取包内 AGENT_SETUP.md；本地 .tgz 只需读取 package/AGENT_SETUP.md。按命令结果简短反馈，成功即结束；只有失败或结果不完整时才排错。