语法与语义

以下全部是语言规范,由活编译器与浏览器内的机器验证——本页底部的网页解释器 就在浏览器中执行这套规范。

§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. 见证 —— 交易的证明

{"требует": {"оп": "и",
  "лево":  {"оп": "сравнение", "чем": ">=", "лево": {"оп": "поле", "имя": "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 接受 NaNNaN 序列化为非法 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. 语言的禁令

  1. 主体中的自由文本——只有规范操作。
  2. 架子边界之外的副作用(网络、进程、屏幕)。
  3. 无界循环——边界是契约的一部分。
  4. 按路径/名称的松散依赖——只有契约的哈希地址。
  5. 可变的全局状态——只有架子。
  6. 同一构造的两种拼写——编译器强制规范。
  7. 组件主体中的机密。

§11. 网页解释器

规范直接在浏览器中执行——与 Python VM 相同的语义:相同的规范拒绝、相同的 取整规则、相同的调用深度与见证裁决。