用途:当有人要求原始访问、直通字段、旁路开关或配置覆盖,或某 API 想加“什么都能传”的参数时,用本技能判断是否该开放逃生舱(escape hatch)。核心观点:随意给出的舱口会成为破坏性变更、对未来不变量不可见,且易形成习惯;但一律拒绝也错,因为某些领域的合法长尾无法被中性 API 建模。
主要能力:一是两问测试。只有“长尾是否足够大且无法枚举”和“会绕过多少横切不变量(租户隔离、乐观并发、审计、加密、校验、软删除等)”两个答案同向时才授权;大长尾加少不变量才开(通常是读侧查询面),否则应扩展结构化接口或指向更低层。二是分层原则:旁路本就存在于下一层(原始客户端/驱动/连接),显式下探优于隐形绕过,表面舱口只在常见需求下探太笨拙时添加。三是优先碎片化作用域:只让调用者覆盖引擎专有片段(如匹配表达式、排序子句),而表面仍套用租户、限额与解码;整操作级的原始写直通应几乎不存在。
使用方式与限制:所授舱口必须声明化、可 grep、默认关闭(无标志即全保证)、作用域最窄(每次调用、每条路由、每条白名单),并把使用记录与计数。反复使用是隐含的功能请求,应扩展结构化面并退役该用法。反模式包括:类型化接口上的 dict[str, Any] 选项袋、静默跳过安全、所谓“临时”舱口、默认开启的舱口,以及既拒绝舱口也不扩展功能。
适用场景:设计 SDK、查询 DSL、框架与平台 API 时评估旁路请求。局限:本文未提供具体代码实现、安装方式、平台支持或性能数据,相关内容暂未提供。