# @eyeo/remote-configuration-validator 中文文档

规范地址：https://npmcn.com/package/%40eyeo/remote-configuration-validator/

版本：0\.19\.0
npm 元数据更新时间：2026-11-13T13:31:04.159Z
中文译文更新时间：2026-11-14T06:35:43.107Z
软件包许可：GPL-3\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40eyeo/remote-configuration-validator
原文对照：https://npmcn.com/package/%40eyeo/remote-configuration-validator/?lang=original
项目主页：https://gitlab.com/eyeo/browser-extensions-and-premium/extensions/extensions#readme
源码仓库：https://gitlab.com/eyeo/browser-extensions-and-premium/extensions/extensions

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

- 包体积（解压后）：74.6 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- peer 依赖：mocha 10\.8\.2
- 首次发布：2025-07-15T15:01:29.338Z
- 最新版本发布：2026-11-13T09:24:45.608Z
- 近 30 天下载量：3168（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 9 个）

## 中文简介

meyo 远程配置验证器

## 安装

```sh
npm install @eyeo/remote-configuration-validator
```

也可以使用：`pnpm add @eyeo/remote-configuration-validator`、`yarn add @eyeo/remote-configuration-validator`、`bun add @eyeo/remote-configuration-validator`

## README

# meyo 远程配置验证器

"@yeo/remote-configulation-validator" (中文(简体) )

这是一个库,通过JSON schema验证和额外的,更特定字段的编辑来验证远程配置文件.

## 概览

AdBlock和Adblock Plus使用远程配置文件.

报告的内容 `src/` 文件夹是 :

-   直接由WebEXT SDK导入.
-   输入 `ab-testing-config` 通过GitLab项目依赖性进行的项目.

源代码不应依赖于任何特定浏览器的API.

## 版本变化

修改本代码时,考虑相应调整版本编号:

-   更新 `schemaId` 属性在 schema/ remoteFigSchema.js 中,只要 JSON schema 需要更改.  
    _警告: 更改 schema ID 意味着旧的扩展版本将不再能够使用远程配置了._
-   更新 `version` 属性在 package.json 文件中,只要更改需要发布新版本.
    -   中断更改需要一个大版本的凸起. 这些可以是打破JSON schema中的变化,也可以是包本身的API中的变化.

## 测试

单位测试进入 `test/` 文件夹并可用 `npm run -w @eyeo/remote-configuration-validator test` 命令.

## 出版

当软件包的更改. json 文件在主分支中降落时, CI 任务会自动尝试发布新软件包版本到 [GitLab 软件包注册](https://gitlab.com/eyeo/browser-extensions-and-premium/extensions/extensions/-/packages)。 。 。 .

新版本也需向秘书处公布 [npm 登记](https://www.npmjs.com/package/@eyeo/remote-configuration-validator) 手动操作,因为有些项目取决于能否在那里使用。 要做到这一点,检查主分支 在变化着陆后,运行 `npm publish -w @eyeo/remote-configuration-validator` 从寄存器的根. 这需要 npm 账户,并发布访问 `@eyeo` 组织.

为使方案改变生效,这个软件包需要在其他项目中相应更新,然后需要单独公布,例如:

-   用于服务器上的验证 : [远程配置](https://gitlab.com/eyeo/filters/ab-testing-config)
-   用于在扩展中验证: 发布新版本 [扩展](https://gitlab.com/eyeo/browser-extensions-and-premium/extensions/extensions/-/wikis/Host-release-process)
-   用于整合@eyeo/webext-ad-filtering-Solution的项目中的验证: 发布新版本的 [@eyeo/ webext- ad- filtering- solution 软件包](https://gitlab.com/eyeo/browser-extensions-and-premium/extensions/extensions/-/wikis/SDK-release-process) 并公布依赖它的项目.
-   供IPM运动管理器使用: [IPM 运动经理](https://gitlab.com/eyeo/filters/ipm-campaign-manager)

## 常见问题

### @eyeo/remote-configuration-validator 是什么？

meyo 远程配置验证器

### 如何安装 @eyeo/remote-configuration-validator？

在项目目录运行 npm install @eyeo/remote-configuration-validator，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：mocha（10\.8\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @eyeo/remote-configuration-validator 支持 TypeScript 吗？

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

### @eyeo/remote-configuration-validator 支持 ESM 还是 CommonJS？

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

### @eyeo/remote-configuration-validator 可以商用吗？

@eyeo/remote-configuration-validator 使用 GPL-3\.0 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @eyeo/remote-configuration-validator 的下载量有多少？

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

### @eyeo/remote-configuration-validator 还在维护吗？

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