253 lines
11 KiB
Markdown
253 lines
11 KiB
Markdown
# 语义评估:参数能否从上下文推断(含叙述式调用)
|
||
|
||
> **2026-10-23 审阅裁决**:保留参数来源可见、避免隐藏调用者环境的边界;下文已被否决的 L0 建议不可重新启用。自然语言只连接和解释,不能成为隐式执行触发器;当前指导见[文档原生指导 §2](document-native-development-guide.md#2-语法审查的保留修正与暂缓)。
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **§3 的 L0 方案已被否决**(违反「只执行标记」原则);L1/L2 结论仍有效 |
|
||
| 日期 | 2026-10-22 |
|
||
| 提出 | 「让函数参数从上下文推断,`对**n=31**执行**加一函数**` 这种写法可能吗」 |
|
||
| 方法 | 运行时实测 8 组 + 全仓库语料扫描(1322 个函数)+ 源码比对 |
|
||
| 相邻 | [call-syntax-from-marks.md](call-syntax-from-marks.md)(**接替本文 §3 的设计**)· [paren-call-and-readable-invocation.md](paren-call-and-readable-invocation.md) |
|
||
|
||
> **后续更正**:本文 §3 提出的 L0「叙述式调用」用**未标记的词**(`执行`)触发调用,
|
||
> 这会破坏「叙述默认安全、只有标记才执行」的底层原则,已被否决。
|
||
> 在「只执行标记」约束下重新设计的调用语法见
|
||
> [call-syntax-from-marks.md](call-syntax-from-marks.md)
|
||
> (含树遍历 vs 字节码 3.8× 实测、叙述顺序导致位置绑定翻转的实验)。
|
||
|
||
---
|
||
|
||
## 0. 结论:你的示例其实**不需要**隐式推断
|
||
|
||
先把一个关键事实摆出来:**你的例子里 `n=31` 明明写在那儿**。
|
||
|
||
```markdown
|
||
# main
|
||
|
||
对**n=31**执行**加一函数**
|
||
```
|
||
|
||
`n` 的绑定**就写在句子里**,这不是「从上下文推断」,这是**具名实参换了语序**。
|
||
所以这个写法需要的是**新的叙述式调用语法**,不是新的作用域语义。
|
||
|
||
它今天跑出来的结果很能说明问题:**无输出、无报错、退出码 0**。
|
||
不是参数推断失败,而是 `执行**加一函数**` 里的裸名字**只是被求值然后丢弃**,
|
||
从来没被当成一次调用。
|
||
|
||
三层拆解:
|
||
|
||
| 层 | 写法 | 需要什么 | 裁决 |
|
||
|----|------|---------|------|
|
||
| **L0 叙述式调用** | `对**n=31**执行**加一函数**` | 只要语法糖(绑定仍在句中) | ✅ **可做,且安全** |
|
||
| **L1 就近绑定** | 上一行 `**n=31**`,下一行 `执行**加一函数**` | 段落级隐式作用域 | ⚠️ 能做但危险,不建议 |
|
||
| **L2 真隐式** | 只写 `执行**加一函数**`,n 全靠上下文 | 动态作用域 | ❌ **不建议**,见 §4 |
|
||
|
||
---
|
||
|
||
## 1. 实测:今天到底发生了什么
|
||
|
||
| # | 用例 | 实测 | 说明 |
|
||
|---|------|------|------|
|
||
| 1 | 你的示例原样 | **无输出、无报错、exit 0** | 静默 no-op |
|
||
| 2 | 同样写法 + `> print text=`n`` | `main里的n=31` | **散文行里的 `**n=31**` 真的执行了** |
|
||
| 3 | 只写 `对`加一函数`执行` | `done`,无报错 | 裸名字只被求值丢弃,**未调用** |
|
||
| 4 | `**n = 31**` + `> 加一函数`(不传参) | `missing argument for parameter n` | **函数看不见调用者的 `n`** |
|
||
| 5 | `> 加一函数 n=31` | `32` | 显式写法今天就能做 |
|
||
| 6 | `# main` 读 frontmatter `税率` | `0.1` ✅ | 入口可见 |
|
||
| 7 | `## 函数` 读同一个 `税率` | `undefined variable` ❌ | 函数不可见 |
|
||
| 8 | 浏览器 WASM 入口调用函数 | metadata + `entry_bindings` **都会传** | 见 §5,**与 CLI 不一致** |
|
||
|
||
**第 2 与第 3 条合起来是关键**:散文行里的粗体确实会执行,但一个裸函数名在粗体里
|
||
只是一个**表达式语句**(值算了就丢),不会变成调用。所以「看起来该调用」的句子,
|
||
实际什么也没做——又是一次静默失败(与 D9 同一类)。
|
||
|
||
**第 4 条是语义基石**:Marqdo 现在的作用域是**严格分离**的,
|
||
函数只能看到自己的形参与局部变量。你想要的 L2,就要拆掉这块基石。
|
||
|
||
---
|
||
|
||
## 2. 你自己的担心是对的:数据在这里
|
||
|
||
你提到「大项目变量名会难以使用」。我把仓库里 `lib/ ext/ examples/ tests/` 全扫了一遍:
|
||
|
||
| 指标 | 数值 |
|
||
|------|------|
|
||
| 扫描函数数 | **1322** |
|
||
| 不同形参名 | 819 |
|
||
| **被 ≥5 个函数共用的形参名** | **130 个** |
|
||
|
||
撞车最严重的一批:
|
||
|
||
| 形参名 | 用它的函数数 |
|
||
|--------|-------------|
|
||
| `path` | **70** |
|
||
| `value` | 59 |
|
||
| `text` | 53 |
|
||
| `id` | 47 |
|
||
| `list` | 38 |
|
||
| `内容` | 38 |
|
||
| `路径` | 35 |
|
||
| `a` / `b` | 各 32 |
|
||
|
||
结论很直接:**如果参数靠上下文推断,那么每次调用一个读 `text` 的函数,
|
||
它都会去捡当前作用域里的 `text` 是什么**。53 个函数在等这个值——
|
||
撞车是常态,不是例外。这不是「大项目才有」的问题,中型项目就已经不可控。
|
||
|
||
---
|
||
|
||
## 3. L0:叙述式调用(推荐做)
|
||
|
||
### 3.1 目标写法
|
||
|
||
```markdown
|
||
## 加一函数
|
||
|
||
对`n`我们让**n=n+1**之后返回*n*
|
||
|
||
# main
|
||
|
||
**结果 = 对 n=31 执行 加一函数**
|
||
> print text=`结果` # → 32
|
||
```
|
||
|
||
### 3.2 语义映射(零模型改动)
|
||
|
||
```
|
||
对 <绑定子句> 执行 <函数名> ≡ Call { callee: <函数名>, args: [<绑定子句>…] }
|
||
```
|
||
|
||
也就是**纯粹换语序**的语法糖。它与今天的
|
||
|
||
```markdown
|
||
**结果 = > 加一函数 n=31**
|
||
```
|
||
|
||
产出**同一个 `CallExpr`**。因此:
|
||
|
||
| 面 | 影响 |
|
||
|----|------|
|
||
| 契约校验(T2.1/T2.2) | **不变**(实参照常绑定与校验) |
|
||
| EKC 指纹 `collect_calls` | **不变**(callee 仍是静态名) |
|
||
| 字节码 `Op::Call(fid, argc)` | **不变** |
|
||
| 序列化 / 沙箱 | **不变** |
|
||
| `view` 渲染 | 需决定回显哪一种语序 |
|
||
|
||
这正是它与「一等函数」「动态作用域」的本质区别:**只改写法,不改调用模型。**
|
||
|
||
### 3.3 设计细节要定的三件事
|
||
|
||
1. **动词**:`执行` 目前**不是**关键字;而 `调用` **已经是**关键字(`src/aliases.rs:39`
|
||
把 `调用` 映射到内建 `call_fn`)。两个近义词并存会混乱,需要二选一或明确分工。
|
||
2. **绑定子句的边界**:`对 n=31 执行 …` 里 `n=31` 到 `执行` 之间是参数区;
|
||
多参数写 `对 n=31 m=2 执行 …`。
|
||
3. **与散文的冲突**:`对` 起头的行今天是叙述(CJK 开头 = 注释)。
|
||
要让这行变成代码,得给「叙述里出现 `执行 <函数名>`」一个可判定的规则,
|
||
否则又是一处「看起来是代码、实际是注释」的静默陷阱。
|
||
|
||
---
|
||
|
||
## 4. L2:真隐式参数(不建议)
|
||
|
||
### 4.1 它到底是什么
|
||
|
||
L2 = **动态作用域**(dynamic scoping):被调函数在**调用者的环境**里查找自由变量。
|
||
历史上被反复试过、也反复放弃:早期 Lisp 改成词法作用域、Shell 的动态作用域被视为坑。
|
||
|
||
### 4.2 七条硬伤(每条都是具体后果,不是理论洁癖)
|
||
|
||
| # | 问题 | 具体后果 |
|
||
|---|------|---------|
|
||
| 1 | **同名捕获** | `加一函数` 调 `记录日志`,两者都读 `text` → 日志函数静默拿到加一的局部值,输出错内容而不报错 |
|
||
| 2 | **递归自毁** | `n=n+1` 后调自身:内层看到的是**已被改过的** n(还是副本?)——必须新增一套遮蔽规则,而规则本身又会成为新的坑 |
|
||
| 3 | **无法复用** | 同一函数两次不同入参,只能反复改外部变量并祈祷调用顺序,等于把「参数」退化成全局可变状态 |
|
||
| 4 | **契约报废** | `call_arg_diag` 在**调用边界**校验实参类型;如果不传实参,就没有校验点。T2.1/T2.2 契约体系直接失效 |
|
||
| 5 | **指纹/arity 失真** | `collect_calls` 记录被调名,arity 由形参推断;隐式调用在 AST 上看起来是零参调用 → 复用预检、`plan` 能力匹配、查重全都失真 |
|
||
| 6 | **沙箱与序列化** | `sandbox.run` 以隔离方式执行文档;隐式依赖外部作用域会破坏隔离语义;环境也必须可序列化 |
|
||
| 7 | **不可审计** | 函数行为依赖看不见的上下文——这就是「全局可变状态」的经典问题,与「文档即程序、可被人读懂」直接冲突 |
|
||
|
||
再叠加 §2 的数据(130 个名字被 ≥5 函数共用),第 1 条不是边角情况,而是默认情况。
|
||
|
||
### 4.3 但有一个**受限版**值得考虑
|
||
|
||
如果你真正想要的是「短脚本读起来顺」,那么下面这个版本是安全的:
|
||
|
||
> **常量默认值**:允许函数在**未传入**某形参时,从**文件级常量**取值。
|
||
|
||
```markdown
|
||
---
|
||
title: 报价
|
||
税率: 0.1
|
||
---
|
||
|
||
## 含税
|
||
+ `金额`
|
||
|
||
*`金额` * (`税率`)* # 税率 未传入 → 取 frontmatter 常量
|
||
|
||
# main
|
||
|
||
**a = > 含税 金额=100** # 10
|
||
**b = > 含税 金额=100 税率=0.06** # 6,显式覆盖
|
||
```
|
||
|
||
为什么它安全而 L2 不安全:
|
||
|
||
| 维度 | L2 动态作用域 | 常量默认值 |
|
||
|------|--------------|-----------|
|
||
| 取值来源 | 调用者的**任意**变量 | 文件顶部**写一次**的常量 |
|
||
| 静态可判定 | ❌ 取决于运行路径 | ✅ 打开文件就能看到 |
|
||
| 随调用者变化 | ✅ 会变(最危险) | ❌ 不会 |
|
||
| 契约 | 失效 | 仍可校验(实参照常声明) |
|
||
| 序列化/沙箱 | 破坏隔离 | 可序列化(常量是数据) |
|
||
| 复用 | 破坏 | 不受影响 |
|
||
|
||
**关键差别**:常量是**文档的一部分**(frontmatter 就在文件开头,人读得到),
|
||
而动态作用域的值是**运行路径的一部分**(人读不到)。
|
||
|
||
---
|
||
|
||
## 5. 顺带发现的真问题:CLI 与 Web 的环境不一致
|
||
|
||
实测 §1 第 6/7/8 条时发现:
|
||
|
||
| 路径 | 函数可见环境 | 源码 |
|
||
|------|-------------|------|
|
||
| `# main`(CLI 运行) | frontmatter metadata ✅ | `src/interp.rs:473` `Env::with_metadata` |
|
||
| **普通函数调用** | 只有实参 ❌ | `eval_call` 用 `Env::new()` |
|
||
| **浏览器 WASM 入口** | metadata ✅ + `# main` 的 `entry_bindings` ✅ | `invoke_in_entry`(`src/interp.rs:365`) |
|
||
|
||
也就是说:**同一份文档,在浏览器里函数能读到 frontmatter 常量、还能读到 `# main`
|
||
的绑定;在 CLI 里读不到。** 行为随运行面不同而不同。
|
||
|
||
这是一个**真实缺陷**,已记入 [D11](../research/qdagent-refactor-defects-2026-10.md):
|
||
|
||
- 对使用者:同一文件在 Web 能跑、在 CLI 报 `undefined variable`,极难排查
|
||
- 对设计:说明「受控环境通道」其实已经存在(只是没在 CLI 打开),
|
||
这既是 L2 受限版的现成基础,也是必须先统一的地方
|
||
|
||
---
|
||
|
||
## 6. 建议
|
||
|
||
| 优先级 | 事项 | 性质 |
|
||
|--------|------|------|
|
||
| 1 | **先统一 CLI/Web 的函数环境**(D11) | 修缺陷,消除行为分裂 |
|
||
| 2 | **做 L0 叙述式调用**(`对 X 执行 F`) | 纯语法糖,零模型改动,554 回归可守 |
|
||
| 3 | 若要「少写参数」,做**常量默认值**(§4.3) | 受控隐式,静态可判定 |
|
||
| 4 | **不做 L2 动态作用域** | 七条硬伤 + 130 个撞车名 |
|
||
|
||
关于「代码即文档」的取向,我的理解是:
|
||
|
||
> 文档化的是**写法**(句子怎么读),不是**语义**(值从哪来)。
|
||
> 让句子更像人话是值得的;让值从看不见的地方来,是把可读性换成不可预测性。
|
||
|
||
---
|
||
|
||
## 7. 待你决策
|
||
|
||
1. **L0 是否采纳?** 若采纳,动词用 `执行` 还是复用已有的 `调用`?
|
||
2. **`对…执行…` 的行如何与散文区分**(§3.3 第 3 点)?这决定它会不会变成新的静默陷阱。
|
||
3. **常量默认值**(§4.3)要不要做?
|
||
4. **D11(CLI/Web 环境不一致)** 是否现在就修?我建议先修它,因为它会影响 L0/L2 的所有验证结论。
|