gecut/nexload-sdk

# Nexload SDK 用于服务健康检查和 Payload CMS 的生产级 TypeScript 包。 此仓库目前记录并支持十个已发布的包。请仅安装与您当前任务相关的包。包版本、peer dependencies 和运行时兼容性列于 [文档](https://gecut.github.io/nexload-sdk/)。 ## 包 ### Healthcheck 从 `@nexload-sdk/healthcheck` 开始，然后添加您的服务所需的运行时、框架、CMS 或监控集成。 | 包 | 用途 | | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | [`@nexload-sdk/healthcheck`](https://gecut.github.io/nexload-sdk/packages/healthcheck/core/) | 定义检查、收集器、作用域、健康报告、超时、状态聚合和序列化，而无需将核心与特定框架耦合。 | | [`@nexload-sdk/healthcheck-node`](https://gecut.github.io/nexload-sdk/packages/healthcheck/node/) | 读取 Node.js 进程数据、Linux cgroup 限制、TCP 可达性和 DNS 解析。 | | [`@nexload-sdk/healthcheck-bun`](https://gecut.github.io/nexload-sdk/packages/healthcheck/bun/) | 将健康管理器适配到 Bun，并观测 `Bun.serve` 服务器指标。 | | [`@nexload-sdk/healthcheck-next`](https://gecut.github.io/nexload-sdk/packages/healthcheck/next/) | 为 Next.js App Router 创建无存储（no-store）的健康检查和指标路由处理程序。 | | [`@nexload-sdk/healthcheck-prometheus`](https://gecut.github.io/nexload-sdk/packages/healthcheck/prometheus/) | 将健康报告序列化为 Prometheus 或 OpenMetrics 文本。 | | [`@nexload-sdk/healthcheck-otel`](https://gecut.github.io/nexload-sdk/packages/healthcheck/otel/) | 将健康报告转换为兼容 OpenTelemetry 的资源属性和指标记录，且无需依赖 OpenTelemetry SDK。 | | [`@nexload-sdk/healthcheck-payload`](https://gecut.github.io/nexload-sdk/packages/healthcheck/payload/) | 通过少量受控的 Local API 查询来检查 Payload CMS 的就绪状态。 | 运行时适配器不会创建 HTTP endpoint。路由所有权归属于您的应用程序或框架集成。监控序列化器仅转换报告；它们不会启动 exporter 或注册 SDK provider。 ### Payload CMS 这些包解决不同的问题，可以独立使用。 | 包 | 用途 | | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | [`@nexload-sdk/payload-fields`](https://gecut.github.io/nexload-sdk/packages/payload-fields/) | 为 Payload 集合添加受管的 Unicode slug、Jalali 日期输入框和整数最小单位货币字段。 | | [`@nexload-sdk/payload-editor`](https://gecut.github.io/nexload-sdk/packages/payload-editor/) | 根据显式的预设和功能选项构建确定性的 Payload Lexical 编辑器配置。 | | [`@nexload-sdk/payload-schema`](https://gecut.github.io/nexload-sdk/packages/payload-schema/) | 一次性定义标准的字段验证和规范化，然后将其作为 Payload 字段和 Zod schema 复用。 | `payload-fields` 负责特定的字段行为和 Admin UI 集成。 `payload-editor` 负责 Lexical 配置。`payload-schema` 负责由 Payload 和 Zod 共享的标准数据契约；它不能替代其他任何一个包。 ## 文档 [包目录](https://gecut.github.io/nexload-sdk/packages/) 是 安装、快速入门、概念、指南、API 参考、 示例、故障排除、迁移和兼容性的起点。 该站点记录了每个包当前发布的版本。不提供历史版本的页面；升级时请查阅包的更新日志和迁移指南。 ## 仓库开发 该工作区使用 pnpm 和 Turbo。推荐使用 Node.js 20 或更高版本以及 pnpm 10 进行仓库开发。 ``` pnpm install pnpm build pnpm lint ``` 包的源码位于 `packages/` 下。构建输出在 `dist/` 中生成， 不应直接编辑。发布使用 Changesets 进行管理。 请参阅 [`AGENTS.md`](./AGENTS.md) 获取针对仓库的具体贡献指南。

标签：API集成, MITM代理, Payload CMS, TypeScript, 健康检查, 可观测性, 安全插件, 用户代理, 自动化攻击, 自定义请求头