语法与语义
以下全部是语言规范,由活编译器与浏览器内的机器验证——本页底部的网页解释器 就在浏览器中执行这套规范。
§1. .deal 文件 —— 规范 AST
文件存储机器可读的 JSON AST——组件的唯一事实来源。不存在 “程序文本”:投影是计算出来的视图,由 AST 打印。规范规则:确定性序列化顺序 (同一语义的两个序列哈希必须逐字节一致)、单一 utf-8 编码、每种构造单一拼写 (无别名)。
{"файл": "цена_за_единицу",
"сделки": [
{"имя": "деление",
"входы": [{"имя": "а", "тип": "число"}, {"имя": "б", "тип": "число"}],
"выход": "число",
"отказы": ["деление_на_ноль"],
"тело": [{"оп": "…", "…": "…"}],
"свидетель": [{"вход": {"а": 100000, "б": 4}, "выход": 25000.0},
{"вход": {"а": 100000, "б": 0}, "отказ": "деление_на_ноль"}]},
{"имя": "цена_за_единицу", "…": "…"}
]}
字段名是俄语的——规范将其固定,下文各表给出每个
关键字与字段的中文释义。.deal 文件始终使用这些规范拼写。
§2. 类型
число(数,浮点)、строка(字符串)、
список(列表)、словарь(字典)、статус
(布尔)、файл(状态架上的地址)。刻意不设复合结构——复杂内容由交易组装。
§3. 契约与交易
交易是程序的单位:契约头 + 主体 + 见证。无主体的契约是接口: 可以声明,不可调用(编译器会拒绝)。
требует(要求)——前置条件;不满足时抛出规范拒绝нарушен_договор(契约被违反),而非崩溃。даёт(确保)——后置条件;在每个见证用例的主体执行之后 运行(结果以это之名进入表达式)。отказы(拒绝)——交易拒绝名的封闭清单;主体中的стой(停止)必须引用其中之名或规范名。
§4. 主体操作
| 操作 | 示例 | 裁决 |
|---|---|---|
присваивание(赋值) | {"имя": "цена", "что": {…}} | 先裁决表达式,再宣告名字 |
верни(返回) | {"что": {…}} | 返回交易的值 |
стой(停止) | {"отказ": "名", "причина": "…"} | 拒绝在契约中命名;沿调用栈上浮,直至等待它的见证 |
присоединить(追加) | {"имя": "список", "что": {…}} | 追加到列表;首个元素自动创建列表 |
если / иначе(如果/否则) | {"условие": {…}, "то": […], "иначе": […]} | 两个分支均受静态裁决 |
для-каждого-до(至界循环) | {"переменная": "i", "до": {…}, "тело": […]} | 循环必须带契约内的边界;无界循环不可能存在 |
полка-пиши(架写) | {"адрес": {…}, "значение": {…}} | 状态只放在架上,原子写入 |
没有:指针、类 eval 构造、自由函数、架子边界之外的副作用。
§5. 表达式
| 操作 | 字段 | 说明 |
|---|---|---|
константа(常量) | значение | 字面量 |
поле(字段) | имя | 先于使用,在输入/пусть/赋值中声明 |
арифметика(算术) | лево, чем, право | + - * / %;除零/模零 —— 拒绝 деление_на_ноль |
сравнение(比较) | лево, чем, право | == != < > <= >=;不可比类型 —— 拒绝 типы_не_сошлись(类型不符) |
и / или / не(与/或/非) | лево, право / что | 布尔,短路 |
зов(调用) | договор, аргументы | 原语或文件中的交易;实参个数是契约的一部分 |
полка-читай(架读) | адрес | 文件缺失/无法解析 —— 拒绝 полка_не_доступна(架不可用) |
§6. 原语 —— 冻结的 VM 集合
AI 永远不写原语:原语由 VM 实现,只随版本化决定增长。注意:округлено
(取整)采用四舍五入(半入)的数学规则,而非银行家舍入——
округлено(2.5, 0) = 3,округлено(0.125, 2) = 0.13。
| 原语 | 含义 |
|---|---|
округлено(х, разряд) | 半入取整;округлено(0.125, 2) = 0.13 |
хеш(х) | 字符串表示的 sha256 |
сумма · длина · максимум · минимум | 列表与字符串上的聚合 |
склейка(список, разделитель) | 由元素生成字符串 |
нижний-регистр · логарифм · время | 字符串、数学、Unix 时间 |
элемент(список, номер) | 越界 —— 规范拒绝 за_краем,而非 IndexError |
тип-из(х) | 以值返回类型名 |
список · словарь · ключи · поле-из-или · поле-записать · поставить | 数据的构造与遍历 |
полка-читай-или(адрес, умолчание) | 带默认值的读取:文件缺失——取默认值,而非拒绝 |
原语内部的原始异常被翻译为规范拒绝 типы_не_сошлись(类型不符),
附带原语名与修正提示——原语从不“沿 Python 栈坠落”,总是以言语作答。
§7. 见证 —— 交易的证明
- 至少 2 个用例(有输入的交易——须含边界);无输入的交易 只需 1 个:输入空间为空,无边界可言。
- 用例形:
{"вход": {…}, "выход": …}或{"вход": {…}, "отказ": "名"};性质用例{"свойство": {…}}——用于无法固化为数字的值。 - 数字比较容差 1e-9(浮点比较不脆弱)。
- 后置条件
даёт在每个用例上自动检查——双重裁决:主体与契约。 - 隐藏边界:对每个数值输入,编译器代入 0 与 1 000 000——
交易必须以规范拒绝或有意义的数字作答;不可预测的崩溃会将交易染红。边界用
требует(要求)围栏:
{"требует": {"оп": "и",
"лево": {"оп": "сравнение", "чем": ">=", "лево": {"оп": "поле", "имя": "n"},
"право": {"оп": "константа", "значение": 0}},
"право": {"оп": "сравнение", "чем": "<=", "лево": {"оп": "поле", "имя": "n"},
"право": {"оп": "константа", "значение": 100000}}}}
活的教训:未加围栏的“阶乘”交易在隐藏边界
n=1 000 000 上诚实地转了一百万次解释器迭代——требует 以规范方式
切除了该边界,编译回到不到一秒。围栏不是装饰,而是证明的一部分。
见证的边界——如实陈述:见证在命名与 隐藏用例上证明“一致 / 不一致”——它证明的是错误的存在,而非不存在。 见证的质量是证明的一部分:弱用例弱裁决(见证由同一个 AI 提交——这是语言的已知边界, 而非秘密)。规范中的缓解:隐藏边界 0 与 1 000 000、边界用例、性质用例、每个用例上的 “确保”。
§8.1. v0.1.1 的实现 —— 今日已裁决者与下一道缝
外部审计(独立 AI,11月20日)将描述与包代码逐条对照。诚实的汇总:
| 声明 | v0.1.1 的事实 |
|---|---|
| 阶段 2 —— 完整性 | 裁决 名/输入/主体/见证;输出/拒绝在文件中声明,其强制执行是下一道缝 |
| 阶段 3 —— 可行性 | 静态:调用存在、字段先声明后使用、стой引用已命名拒绝;无静态类型检查——类型由见证(阶段 4)捕获 |
| 阶段 1 —— 形式 | 未知操作在阶段 3/4 以名拒答;独立的形式检查是下一道缝 |
| “拒绝总是言明” | 编译器拒绝以 JSON 打印:{阶段, 责任者, 原因, 如何修正};无 traceback |
| 架子边界 | 地址不越出架子文件夹(与 POLKA + os.sep 比较);向相邻文件夹的逃逸已封堵(../polka_* 探针验证) |
| 八个绿色组件 | 包内 8/8,含架子固定件;投影的双射性经独立审计确认 |
§8.2. 第二轮审计 —— v0.1.2 修复了什么
同一外部 AI 做了更深的审计:货币语义、类型、沙箱、代码生成、确定性。 每一条都已在 v0.1.2 修复,并按复现用例验证:
| 错误 | 复现 | v0.1.2 修复 |
|---|---|---|
| 可变列表字面量跨调用泄漏 | 两个用例 [1,9] / [1,8] → [1,9,8] | 列表/字典字面量在执行时深拷贝 |
| 浮点取整不安全 | округлено(1.005, 2) → 1.0 | 从字符串表示的 Decimal,ROUND_HALF_UP:1.005 → 1.01;2.5 → 3;0.125 → 0.13 —— “半入”规范保留 |
| 见证比较丢失精度 | 1e17+5 “等于” 1e17 | 整数精确比较(去掉浮点转换),分数 —— 1e-9 容差(已声明的规范) |
| 输入类型不被裁决 | 在声明的 число 下提交字符串 —— 绿色 | 输入类型在每个用例上裁决;不符 —— 规范拒绝 |
| 架写逃逸 | ../polka_evil/pwned.json 被创建 | v0.1.1 已封堵(POLKA + os.sep 边界覆盖写入)——已复核 |
| 代码生成:名字注入 exec(CWE-94) | 变量 i' —— SyntaxError 外泄 | 循环变量必须是规范标识符;不合规者 —— 规范拒绝 |
| 无步数限制 | 到 10^12 的循环挂死编译器 | 燃料:10 000 000 步 —— 规范拒绝 «топливо» 约 5 秒返回,而非永远;每用例重置 |
| 拒绝未写入登记 | 拒绝后 reestr.jsonl 未变 | 编译器拒绝写入登记(tip: otkaz,阶段,原因) |
| AST 接受 NaN | NaN 序列化为非法 JSON | 加载与序列化均禁止 NaN/Infinity(allow_nan=False) |
如实陈述的剩余项:分数值的 1e-9 容差是规范(货币:分币),其内 1e-10 噪声可通过; 阶段 3 的静态类型检查是语言的下一道缝,在建设中。基准测试方法学与原生后端 不在包内(试点数字,已标注)。
§8.3. 第三轮审计 —— v0.1.3
更深:组合、货币、完整性、后端等价。全部在 v0.1.3 关闭,并按复现用例验证:
| 错误 | 复现 | v0.1.3 修复 |
|---|---|---|
| 菱形导入被误判为循环 | A→{B,C},B→D,C→D —— “重复”拒绝 | 循环按路径(栈)裁决,相同哈希的导入去重;导入带来完整的传递环境(活的发现:被导入文件内的调用以 нет_договора 倒下) |
| 裸的 decimal.InvalidOperation 外泄 | округлено(1e100, 2) —— traceback | 带余量的 Decimal 上下文 + DecimalException 进入原语网络 —— 规范拒绝;1e30 可计算 |
| 燃料被代码生成绕过 | 1e9 循环挂死代码生成 | 生成的每圈调用 _sf() —— 规范拒绝 «топливо» 约 2 秒 |
| int↔float 比较隐藏精度损失 | (1e16+1)/1 → float 1e16 “等于” int 1e16+1 | 混合对精确比较 |
| 编年史无哈希链 | “不可缩短”仅是约定 | 每条记录携带 pred + hesh_zapisi —— 缩短会断链且可见 |
| 固定 .tmp —— 写者竞态 | 同地址两次写入 | tmp 唯一(pid+随机),replace 保持原子 |
| 登记无限增长 | 每次绿色编译存完整 AST | 按哈希重复 —— 轻记录(tip: povtor,无 AST) |
| 协议中的错字 тии_не_сошлись | —— | типы |
| 允许字符串×数字 | "ab"*3 → "ababab" | 算术严格:字符串由 склейка 原语拼接 |
| 深度 300 硬编码 | factorial(>300) 不可算 | vm.ГЛУБИНА_ПОТОЛОК = N —— 可配置 |
后端差分探针(审计的建议——已采纳): 300 个随机表达式在解释器与字节码上运行 —— 300/300 一致,零分歧。 如实剩余:静态类型裁决(阶段 3)、分数值的 1e-9 容差(货币规范)、原生后端与 基准方法学 —— 在包外。
§8. 拒绝 —— 总是言明
VM 的规范拒绝名:деление_на_ноль(除零)、
нарушен_договор(契约被违反)、полка_не_доступна(架不可用)、
нет_договора(无此交易)、нет_имени(无此名)、
нет_операции(无此操作)、полка_наружу(越出架界)、
типы_не_сошлись(类型不符)、за_краем(越界)、
глубина(深度)、топливо(燃料——v0.1.2:计算耗尽
1000 万步主体,代替无限循环)。拒绝沿调用栈上浮,直到等待它的见证——或抵达计算顶部。
语言刻意不设捕获构造:拒绝总是被命名,且总会到达。
编译器拒绝有四个字段:
{"стадия": 3, "виновник": "зов деление_не_то",
"причина": "договора нет в ввозах сделки; доступен деление (хеш a1b2c3)",
"что_править": "замени зов на деление или добавь ввоз хеша"}
§9. 十六种变换 —— AI 工作的全部方式
| # | 变换 | 编译器裁决 |
|---|---|---|
| 1 | ввести-сделку(引入交易) | 至少 1 个见证用例,含边界 |
| 2 | ввести-договор(引入辅助契约) | 契约完整,无被拒调用 |
| 3 | заменить-тело(替换主体) | 全部见证已执行,每个皆有“确保” |
| 4 | добавить-кейс-свидетель(添加见证用例) | 即刻执行;缺失边界即成 претенз |
| 5 | убрать-кейс(移除用例) | 剩余用例须足够且含边界 |
| 6 | сузить-требует(收窄要求) | 全部调用方重新检查 |
| 7 | расширить-даёт(拓宽确保) | 全部见证重新运行 |
| 8 | добавить-отказ(添加拒绝) | 调用方主体须引用新拒绝 |
| 9 | заменить-зов(替换调用) | 新契约按哈希;类型与拒绝均已核算 |
| 10 | переименовать-с-переносом-зовущих(重命名并迁移调用方) | 所有调用方全部迁移 |
| 11 | расколоть-по-шву(沿缝拆分) | 两交易之和等价于原交易 |
| 12 | влить-сделки(合并交易) | 合并后等价于二者之和 |
| 13 | ввести-тип(引入类型) | 只能通过收窄/拓宽来应用 |
| 14 | пометить-карантин(标记隔离) | 不可验证者只活在沙箱中 |
| 15 | вынести-в-примитивник(提为原语) | 主体成为 VM 调用 |
| 16 | удвоить-компонент-с-вариацией(带变体复制组件) | 新组件独立 |
§10. 语言的禁令
- 主体中的自由文本——只有规范操作。
- 架子边界之外的副作用(网络、进程、屏幕)。
- 无界循环——边界是契约的一部分。
- 按路径/名称的松散依赖——只有契约的哈希地址。
- 可变的全局状态——只有架子。
- 同一构造的两种拼写——编译器强制规范。
- 组件主体中的机密。
§11. 网页解释器
规范直接在浏览器中执行——与 Python VM 相同的语义:相同的规范拒绝、相同的 取整规则、相同的调用深度与见证裁决。