- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
4.9 KiB
Executable File
4.9 KiB
Executable File
变更记录:M1 () 内调用语法() 终止 / 逗号 / 嵌套 / 空格 callee)
| 状态 | Implemented |
| 日期 | 2026-10-22 |
| 里程碑 | M1(occlusion-syntax.md §13) |
| 改动文件 | src/parse/expr.rs |
| 影响面 | 共享参数分词器(所有调用都会经过) |
1. 修了什么
四件事,一句概括:(…) 现在是一等调用外形。
| # | 前 | 后 |
|---|---|---|
| 1 | 加(31) 报 unknown function 加(31 |
✅ 调用,返回 32 |
| 2 | 末个位置实参会吞掉 ) |
) 是参数终止符 |
| 3 | 只支持空白分隔 | 支持 , / , 可选分隔 |
| 4 | 嵌套 加(加(1 2), 3) 不可用 |
✅ 递归解析 |
| 5 | 加一 号(31) 不可用(D8) |
✅ callee 可含空格 |
实测(1.5.2 本地构建,tree 与 bytecode 双后端结果一致):
空格参=3 加(1 2)
逗号=3 加(1, 2)
嵌套=13 加(加(1 2), 10)
带空格callee=32 加一 号(31) ← 缺陷 D8 的结构性解法
库函数=x txt.str_trim(" x ")
具名=3 加(a=1, b=2)
2. 实现要点
2.1 参数扫描:深度感知 + ) 终止
split_first_token 与 find_next_arg_boundary 改为通用扫描器:
- 跟踪
()[]{}嵌套、"…"字符串、`…`反引号 - 顶层
)/ 空白(以及括号形里的,)终止当前 token,且不吞掉终止符 - 字符串内的逗号不受影响(
拼接("a,b", "c")仍是 2 个参数)
2.2 try_paren_call:callee = 第一个 ( 之前的全部文本
let Some(open) = s.find('(') else { return Ok(None) };
let callee_tok = s[..open].trim(); // 允许空格
安全护栏(否则会误判):
| callee 里出现 | 判定 |
|---|---|
= |
不是括号调用(那是 text=a(b) 具名实参) |
[ ] ( ) " ' |
不是括号调用(那是 trim [stdout](…) 方括号实参) |
以 [ ] " ' 开头 |
不是括号调用 |
| 反引号 | 允许(保留 `obj`.方法(…) 接收者写法) |
2.3 表达式级 postfix 调用
parse_primary 的裸词分支:紧跟 ( 时按调用解析。
if self.allow_paren_call && self.rest().starts_with('(') { … }
要求"紧跟"(不隔空格),使 加 (1) 仍是原来的"文本 + 括号"行为。
2.4 方括号形也允许空格 callee
is_bracket_callee_inner 不再拒绝空白:[加一 号] 31 可用。
(仓库内可执行的方括号调用用量为 0,风险极低。)
3. 关键设计决策:括号形 vs 空格形的参数值语义不同
这是本里程碑唯一有争议的点,必须写清。
| 形态 | 参数值 | 例子 |
|---|---|---|
括号形 f(…) |
表达式(允许 name(args) 调用) |
加(加(1 2), 3) |
空格形 > f k=v |
文本(不允许裸 name(args) 变成调用) |
source=print(2+2) 仍是文本 |
为什么必须区分:source=print(2+2) 在 Marqdo 里历来是文本(未加引号的实参按文本处理)。
若不区分,它会变成对 print 的调用,foreign.run_lang 直接报 source must be text
—— 这正是本次回归测试抓到的 3 个失败。
实现:Parser 增加 allow_paren_call 字段;parse_call_arg_value_mode(input, prefer_var, allow_call)
统一两种值解析(allow_call=false 即旧行为)。
4. 测试
| 层 | 内容 | 结果 |
|---|---|---|
| 单元 | 新增 11 个(单参/多参/逗号/具名/空格 callee/零参/库路径/嵌套/引号内逗号/旧写法不回归/方括号形) | ✅ |
| 全量 | cargo test --release |
565 passed / 0 failed(基线 554 + 11) |
| 双后端 | tree 与 --backend bytecode 跑同一文档 |
输出一致 |
| 端到端 | marqdo run 六个用例 |
输出符合预期 |
TDD 过程:先写 11 个测试 → 10 个失败(红灯确认)→ 实现 → 全绿。
5. 顺带移除的死代码
end_of_quoted_string:新扫描器取代其唯一用途后变成 never used,删除(编译器警告清零)。
6. 边界(本里程碑不做)
| 项 | 说明 |
|---|---|
| 逗号仅在括号形生效 | 空格形 text=a,b 的逗号仍是文本(兼容) |
加 (1)(空格后跟括号) |
不视为调用,保持旧行为 |
遮蔽语法 [描述](…) |
M2 才引入,本里程碑不解析 |
| 位置实参顺序脆弱性 | 与叙述顺序绑定,M7/M8 再处理(诊断) |
7. 变更清单
| 文件 | 变更 |
|---|---|
src/parse/expr.rs |
参数扫描器重写()/逗号/嵌套);新增 try_paren_call + split_callee 抽取;表达式级 postfix 调用;Parser.allow_paren_call;parse_call_arg_value_mode 统一两种值语义;方括号 callee 允许空格;删除 end_of_quoted_string |
doc/design/change-m1-paren-call.md |
本文件 |