用途:用于诊断和解决 MaintainX 集成问题,覆盖复杂故障排查、详细日志记录与连通性检查。
主要能力(按资料分步):
- 环境诊断脚本:输出时间戳、Node.js/npm 版本、MAINTAINX_API_KEY 是否设置,调用 https://api.getmaintainx.com/v1/users?limit=1 获取鉴权状态码,并检查 DNS 解析与响应计时(DNS、Connect、TTFB、Total)。
- 请求/响应日志器:基于 axios 创建调试客户端,请求拦截器打印方法、URL、Body 与 Params,响应拦截器打印状态码、耗时与数据键,错误时打印状态、消息与响应头。
- API 健康检查:依次探测 /users、/workorders、/assets、/locations、/teams(均 limit=1),返回 ok/error、状态码与延迟。
- 数据校验:抽查工单,标记缺少 title、状态 COMPLETED 但无 completedAt、OPEN 已逾期、HIGH 优先级但无执行人等问题。
- 生成支持包:汇总环境信息、健康检查结果与样本数据计数,写入 maintainx-debug-<时间戳>.json,供提交 MaintainX 支持使用。
使用方式:设置 MAINTAINX_API_KEY 后运行对应脚本;健康检查可用 npx tsx src/debug/health-check.ts;也可用一行 curl 快速诊断。输出包括环境报告、每请求日志计时、端点健康结果、数据校验警告与支持包 JSON。
限制:依赖 MaintainX API 访问权限与密钥;需要 Node.js 18+ 或 curl;资料未提供具体收费、价格、平台或性能保证,也未说明可用模型或版本兼容范围。
分类:智能体与模型。