# @fx-data/ai-diagnostics 中文文档

规范地址：https://npmcn.com/package/%40fx-data/ai-diagnostics/

版本：0\.1\.20261115133614
npm 元数据更新时间：2026-11-15T13:39:39.952Z
中文译文更新时间：2026-11-15T19:29:30.997Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fx-data/ai-diagnostics
原文对照：https://npmcn.com/package/%40fx-data/ai-diagnostics/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：600 kB，88 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-10-14T10:09:06.729Z
- 最新版本发布：2026-11-15T13:39:39.772Z
- 近 30 天下载量：4249（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

FX数据诊断：Agent 诊断技能、知识与本地脚本

## 安装

```sh
npm install @fx-data/ai-diagnostics
```

也可以使用：`pnpm add @fx-data/ai-diagnostics`、`yarn add @fx-data/ai-diagnostics`、`bun add @fx-data/ai-diagnostics`

## README

# 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 执行说明](https://unpkg.com/@fx-data/ai-diagnostics@0.1.20261115133614/AGENT_SETUP.md) 完成安装与管理。已有本地包时，优先读取包内 `AGENT_SETUP.md`；本地 `.tgz` 只需读取 `package/AGENT_SETUP.md`。按命令结果简短反馈，成功即结束；只有失败或结果不完整时才排错。

## 常见问题

### @fx-data/ai-diagnostics 是什么？

FX数据诊断：Agent 诊断技能、知识与本地脚本

### 如何安装 @fx-data/ai-diagnostics？

在项目目录运行 npm install @fx-data/ai-diagnostics，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fx-data-diagnostics，可以用 npx fx-data-diagnostics 直接运行。

### @fx-data/ai-diagnostics 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fx-data\_\_ai-diagnostics 是否存在。

### @fx-data/ai-diagnostics 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fx-data/ai-diagnostics 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fx-data/ai-diagnostics 可以商用吗？

@fx-data/ai-diagnostics 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @fx-data/ai-diagnostics 的下载量有多少？

根据 npm 官方下载统计，@fx-data/ai-diagnostics 在 2026/10/16 – 2026/11/14 这 30 天内被下载 4,249 次，日均约 142 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fx-data/ai-diagnostics 还在维护吗？

最新版本 0\.1\.20261115133614 发布于 2026/11/15（今天）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。