跳到主要内容

心智模型

本页只回答:Nudo 如何看待并计算你的 JavaScript。命令面见 CLI;迁移 tsc 另见文末链接。

一句话模型​

Nudo 在抽象值上执行你的 JavaScript,使变量携带接近运行时的值、形状与约束,并报告代码真实计算出什么——再对你接受的契约做校验。源码保持普通 .js。

你写Nudo 做
普通 .js + 调用点执行并观察:签名、中间量、调用点真值
可选 *.nudo.js / @nudo:contract校验义务(actual ⊭ expected)
什么都不写仍诊断导出 may-throw(L2)

没有第二套类型语言。 契约是普通 JS 模块 + number().gt(0) 这类构造器。

两层:观察与契约​

层你在读什么来源
观察变量接近运行时的值 / 形状 / 约束执行事实(调用点、路径)
契约必须成立的条件,违例给出 actual / expected你接受的声明(侧车 / @nudo:contract)

观察不是注释,契约也不是类型标注。

export function scale(x) {
return x + 1;
}

scale(5);
scale(0); // violates the sidecar precondition below
import { number, fn } from "@nudojs/core";
export const scale = fn({ x: number().gt(0) }, number());
signatures
scale(x: number) => number

issues
[ERROR L6 scale] scale[x]: argument ⊭ precondition (nudo:constraint-violated)
actual: 0 #exact
expected: x > 0

scale(5) 的证据让入口不再是裸 any;契约把 x > 0 变成可校验义务。if 不是契约——义务只来自你接受的声明。

为什么变量接近运行时​

因为它们是可计算的 Abs(shape × term × pred × conf),不是类型名:

组件在产品面看到的含义
shape签名里的形状prim / obj / arr / fn / sum / …
term值身份lit(42)、var(符号 A1)、app(x+1)
pred违例里的 expected:约束(x > 0);参与代数(x>0 ⇒ x+1>1)
conf#exact / #path抽象精确度

调用点是证据:真实调用越多,签名越接近运行时。nudo test 可查看逐调用见证;@nudo:case 仅调试,不产生契约义务。

深潜:Abs · 抽象解释 · nudo check --abs。

四条模型规则​

  1. 调用点是证据。 真实调用越多,签名越接近运行时。
  2. any ≠ unknown。 any = 入口无约束(可由你细化)。unknown = 推导失败(引擎债)。
  3. 契约是义务,不是注解。 约束参与代数,不是注释里的意图。
  4. 投影不是真源。 .d.ts / schema 是 Abs 的有损视图;真源是执行得到的 Abs。

现在可以先不管​

下一步​