用途:infinity 是一项输入边界与验证协议,核心理念是任何不可信数据都不得以原始形态进入业务逻辑,每个数据入口都必须有过滤器。它适用于处理 API 响应、用户输入与表单、环境变量与命令行参数、Webhook、文件读取、第三方 SDK 响应等场景,尤其是代码涉及 .body、.params、.query、.env、fs.read 时。
主要能力:分四个阶段执行。第一阶段边界检测,列出范围内所有入口点(HTTP 请求体、请求头、查询参数、表单输入、环境变量、配置文件、第三方 API 响应、Webhook 载荷、磁盘文件读取、CLI 参数、外部数据库查询结果、WebSocket 消息),未列完不得编写数据处理逻辑。第二阶段按信任等级分类:TRUSTED(内部常量、硬编码值、编译期配置)可直接使用;SEMI-TRUSTED(内部微服务响应、自有数据库读取)与 UNTRUSTED(用户输入、外部 API、上传文件、环境变量、CLI 参数)必须先过滤。第三阶段强制过滤层,按上下文选择类型检查、Schema 校验、净化转义、存在性与格式检查;无效输入须显式拒绝并返回明确错误,禁止静默回退或让坏数据下游自愈。第四阶段交付前自检,逐入口确认过滤器存在及类型,若有未过滤输入到达逻辑、存储或渲染则须标记。
使用方式:在编写或修改任何涉及外部数据的代码前,先输出边界映射表(入口点、信任等级、是否需过滤),再编写过滤代码,最后输出验证表确认无未过滤输入。硬性规则包括:业务逻辑中不得出现原始外部数据;坏输入不得静默回退;不得假设数据形状;环境变量缺失须在启动时显式失败;不得只校验存在性而不校验格式;过滤器必须置于入口点而非下游。
限制:不适用于完全不涉及外部数据的纯内部逻辑;对无需严格校验的简单脚本可能增加冗余。定价、平台与具体安装步骤暂未提供。