跳到主要内容

Abs —— 类型系统

Abs 是 abstract value(抽象值) 的缩写,来自抽象解释。Nudo 的目标是在源码中看到变量接近运行时的样子。Abs 是支撑该目标的表示:不是宽泛的类型名,而是带有值身份与约束的、可能 JavaScript 值的符号集合。

Abs 可以精确到单个具体值(42、"hello"),也可以覆盖共享某些特征的所有值(「任意数字」「字面量 1」)。

Abs(shape × term × pred × conf)是唯一的类型系统:可计算的值,其约束参与代数(x > 0 ⇒ x + 1 > 1)。分析、inlay 展示、签名与投影(.d.ts / zod / guard)全部直接消费 Abs;不存在独立 IR。生产分析是 Abs 原生的——没有东西读回投影。

四个组成​

  • shape —— 外延载体:值长什么样。种类:prim(带 lit term 即精确值)、obj、arr、tuple、fn、eff(promise<…> / generator<…>)、brand(名义实例)、sum(联合)、never、any(无约束)、unknown(推导失败 —— 见 any vs unknown)。
  • term —— 抽象值身份:lit(具体)、var(符号 α,如 A1)或 app(应用表达式,如 (x + 2))。
  • pred —— 相对 term 的约束:(x + 2) > 3。
  • conf — 抽象精确度。由强到弱:exact → path → widened → mock → partial → opaque(合并取更弱侧)。
conf含义
exact字面量 / 可精确求值(25 #exact)
path依赖路径约束 / 符号 term((x+1) · > 1 #path)
widened结构丢失后的保守外延(循环合流、预算)
mock声明的 mock / harvest 形面,非观测求值
partial集合内容不完整
opaque无可用内容(预算截断、求值失败)

仅 exact / path 会投影进 dts / schema 细节。

Abs 解剖 —— shape × term × pred × conf

Abs 解剖 —— 四个分量与一组示例(x + 1 / number / > 1 / path)。

构造器(num()、strLit(…)、obj({…})…)与核心函数(leqAbs、formatAbs、checkSource…)见 core API。

字面量​

带 lit term 的 prim shape 表示恰好一个具体值 —— 引擎从代码字面量或具体 @nudo:case 实参产出它:

25 #exact // 精确的数字 25
"localhost" #exact // 一个特定字符串

基本类型​

不带 lit term 的 prim shape 是整个域 —— 知道值属于该类型但不知道具体是哪个:

number // 任意数字
string // 任意字符串
boolean // true 或 false

对象、数组、元组​

obj 携带已知槽位(每键 { value, optional? }),arr 单一元素类型,tuple 定长逐元素:

{ host: "localhost", port: 8080, debug: false }
[2, 4, 6] // 字面量元组 —— 元素抽象时为 arr
number[] // 抽象元素

函数与 Promise​

fn 携带参数名(或 paramTypes/returnType 签名);eff 包装异步效应,小写渲染:

load: (id) => ? // 函数值,结果尚未精确
promise<{ id: 7, name: "u7" }> // 异步结果

联合​

sum 是成员 Abs 的联合 —— 值可能是任一成员:

25 | 9 // 两个精确数字(来自两个调用点)
number | string // 异构联合

never 是空集(不可达)。

any 与 unknown​

二者在产品语义上不是同一概念,在文档与 CLI 输出中绝不可混为一谈:

anyunknown
含义无约束:JS 值的并集;开发者负责细化推导失败 / 引擎无信息;Nudo 负责修
来源未标注入口参数、显式 any()、refine 解析失败回退求值失败、native 未建模、截断、泄漏、opaque
运算按真实 JS 语义取并集;不是「分析失败」不得假装成合法契约;应触发引擎债诊断
窄化条件语句可窄化(typeof / === / Array.isArray / switch / 真值 / 判别字段)用户条件不能「合法化」;先修推导或补 env/mock/refine
展示any(可带 type-var 如 A1)unknown + conf 标注
产品话术「未写契约 ⇒ 默认约束为 any + JS 运行时效果」「Nudo 遇到无法处理的场景」

规则(Nudo 展示面): 无约束入口参数显示为 any,绝不显示为 unknown。CLI / check 签名遵循此契约。此规则只约束 Nudo 自己的展示 / CLI 输出,不管辖 TypeScript 声明产物。

TS 投影面(2026-11-06 裁定): Nudo 的 any 表示「任意 JS 值、无约束」,对应 TypeScript 的 unknown(top,消费方须先收窄),不是 TS 的 any(关闭类型检查的逃生舱)。因此 .d.ts 与 zod / standard / guard 三面校验器一样,把 Nudo any 与 Nudo unknown 都投影成 TS unknown。.d.ts 里未收窄的无约束返回值触发 TS2571 是正确的类型安全提示,不是假红(见 Bug 544)。


指令中的类型表达式​

@nudo:case / @nudo:mock / @nudo:contract 的实参用约束表达式文法书写 —— 与 *.nudo.js 模板相同的构建器:

表达式含义示例
number() / string() / boolean()基本类型域@nudo:case "symbolic" (number())
lit(v)字面量域lit(42) / lit("ada") / lit(true)
union(…)成员联合union(lit(1), lit(2))
shape({ … })对象形状(字段递归)shape({ id: number().gt(0) })
array(…)数组元素约束array(number())
any()无约束域(与未标注入口参数相同)any()
fn({ … }, …)函数关系fn({ x: number().gt(0) }, number())
构建器链.gt/.ge/.lt/.le/.int/.min/.max/.length/.shift…number().gt(0).int()
裸字面量直接解析42、"abc"、true、[1, 2]、null、undefined、unknown、never

指令类型表达式使用上面的约束构建器加具体字面量。@nudo:mock body 内写普通 JavaScript 值和闭包 —— 不要把构建器调用当作返回负载。

/**
* @nudo:case "concrete" (5, 3)
* @nudo:case "symbolic" (number(), number())
* @nudo:case "mixed" (lit(0), string())
*/
function combine(a, b) {
return a + b;
}

设计原则​

Nudo 的类型值体系遵循四条核心原则,决定运算与推断的行为。

1. 字面量保持​

所有输入都是字面量时,输出也是字面量。引擎计算出具体结果。

combine(5, 3) // → 8 #exact,不是 number
"ab" + "c" // → "abc" #exact

信息足够时推断类型保持精确。

2. 抽象时拓宽​

任一输入抽象(非字面量)时,结果拓宽到相应域 —— 但 Nudo 尽可能保留结构。

1 + number // → number #path(展示为域)
"xy" + string // → string #path(展示为域)
string + string // → string(无结构可保留)

字符串拼接涉及至少一个字面量时,Nudo 内部追踪模板字符串 —— 已知前后缀被保留,这正是 ("user-" + x).startsWith("user-") 在符号 x 下也能折叠为 true #exact 的原因。

3. 惰性联合分布​

联合按原样传播。符号值上的运算保持符号 —— 不会急切展开成成员笛卡尔积。这避免组合爆炸并保持相关性:

function selfAdd(a) {
return a + a; // intension: (A1 + A1) —— 一个符号变量,不是 A1 + A1'
}

selfAdd(1); // → 2 #exact(逐调用点)
selfAdd(2); // → 4 #exact
// Observed: 2 | 4 —— 相关性保持,绝不会是 1+1 | 1+2 | 2+1 | 2+2

抽象实参下结果拓宽到代数判定的域(2 + x,其中 x: number | string → number | string;selfAdd(number) → number #widened)—— 只有运算符或方法必须区分成员时才逐成员展开。

4. 守卫窄化(逐调用点)​

类型守卫只有在守卫测试对调用点的具体实参确定为真/假时分叉分支。每条 call@L… case 用该调用的精确实参求值,匹配的分支运行,另一个被消除:

function len(x) {
if (typeof x === "string") return x.length;
return -1;
}
len("abc"); // → 3 (string 调用走该分支)
len(5); // → -1 (number 调用落空)

抽象实参(number()、union(...))无法判定条件——两个分支以相同值运行,结果 join。不存在抽象联合的交集/减法。已验证模式与当前边界:控制流收窄。

下一步​