跳到主要内容

指令速查单

每条指令一行:语法、语义、详情页链接。权威参考是指令——本页是速查卡,不是替代品。

摆放规则一句话: 函数级指令写在紧贴函数上方的块注释里(@nudo:case / @nudo:mock / @nudo:pure / @nudo:skip / @nudo:sample 也接受单行 // 形态);文件级指令用三斜杠 /// 写在文件顶部;@nudo:as 与 @nudo:replace 是改写目标语句上方的行注释。

常用五条​

指令语法一行语义详情
@nudo:case@nudo:case "name" (args) · @nudo:case "name" (args) => expected调试见证:nudo test 以这些输入执行函数(=> expected 断言结果);也驱动 LSP 场景切换。不是契约产品。@nudo:case · nudo test
@nudo:contract@nudo:contract x positive · @nudo:contract return positive源内精化契约,约束参数或返回值;约束作为 Pred 进入 Abs 并参与代数。主路径是 *.nudo.js 侧车。@nudo:contract · nudo contract
@nudo:mock@nudo:mock fetch = (url) => ({ … }) · @nudo:mock name from "./mock.js"求值期间用 mock 替换外部依赖(fetch、fs……)——五种形态,表达式必须单行。Mock 外部依赖
@nudo:env/// @nudo:env web文件级:启用内置运行时 API 类型 —— es / web / node(web、node 含 es),或自定义 ./nudo-env.ts(导出 defineEnv())。@nudo:env
@nudo:import/// @nudo:import { positive } from "./shapes.nudo.js"文件级:从 *.nudo.js 模块引入约束模板,供 @nudo:contract 使用(命名或 * as ns)。@nudo:import

高级指令​

指令语法一行语义详情
@nudo:assume@nudo:assume d <= max(<= 或 >=)跨变量引理:区间传播推不出的两个参数/顶层局部之间的关系;公理,引擎不验证 —— 依赖它的证明标记 nudo:assume-relied。@nudo:assume
@nudo:invariant@nudo:invariant dp[*][*] >= 0循环携带界:参数/顶层局部上的界([*]、.field 路径下钻;>= <= > < 加数字常量);公理 —— 标记 nudo:invariant-relied。@nudo:invariant
@nudo:budget@nudo:budget calls=50000 depth=128(还有 forks=…)抬高该函数的求值预算(默认:calls 20,000 · depth 64 · forks 5,000);只抬不降 —— 抬不动调用环与循环截断。预算
@nudo:pure@nudo:pure标记函数无副作用:求值器按实参 Abs 记忆化调用结果。@nudo:pure
@nudo:skip@nudo:skip · @nudo:skip => number()跳过函数体求值:声明的类型(或 any)作为返回;参数契约仍然门禁调用点。@nudo:skip
@nudo:sample@nudo:sample N保留的无效果指令:仅为兼容性解析,无消费者 —— 循环已由有界展开约束。@nudo:sample
@nudo:as// @nudo:as shape({ port: number() })覆盖下一条语句的值类型(变量初始化器 / 返回值)。@nudo:as
@nudo:replace// @nudo:replace res.data array(number())替换下一条语句内某个子表达式的类型;可多行叠加。@nudo:replace
@nudo:mock-module/// @nudo:mock-module "axios" from "./mocks/axios.js"文件级:用 mock 文件替换被引入的模块 —— 说明符后加 { get } 只 mock 这些导出。@nudo:mock-module

还有一条真实指令:@nudo:throws Error, TypeError(或 *)申报有意抛错、按种类解除 L2 —— 见指令参考。

约束构建器​

@nudo:case 实参、@nudo:skip / @nudo:as 载荷与 *.nudo.js 侧车共用的类型表达式文法:

构建器含义
number() string() boolean() any()基本类型域(any() = 无约束)
lit(v)字面量域 —— lit(42)、lit("ada")、lit(true)
union(…) / nullable(c)域的并 / c 加 null 与 undefined
shape({ … })对象形状,字段递归
array(c)数组元素约束
fn({ x: … }, returns, { throws })函数关系(参数、返回、throws 选项)
and(…) partial(c) pick(c, keys) omit(c, keys) lazy(() => c)组合子(lazy 仅侧车)
.gt .ge .lt .le .int .min .max .length .shift .optional链式约束 —— number().gt(0).int()、string().min(1)

完整表格:@nudo:contract 下的构建器 · Abs 中的类型表达式。

下一步​