Files
marqdo/doc/design/functions-as-values-evaluation.md
T

20 KiB
Raw Blame History

方案评估:函数能否作为变量的一种(函数即表)

2026-10-23 审阅裁决:以下是旧实现约束与方案权衡,不是“匿名函数无法索引”或“动态调用无法检查契约”的普遍结论。一等函数/闭包本轮暂缓而非永久禁止;有限决策表先评估现有库表达,文中建议的新辅助函数不因此成为已实现能力。参见文档原生指导 §2。

状态 Proposed · 待决策(未修改任何代码)
日期 2026-10-22
提出 用户:「函数本身可以理解为 `函数名` = + 参数/函数体表;此时和表格取元有极大相似性」
相邻 link-style-call-evaluation.md · spaced-function-names-d8.md · function-as-table-semantics.md(后续:函数与表格的语义考古,11 组实验)
影响面 值模型 / 调用语义 / 契约 / EKC 指纹 / 字节码 / 序列化

0. 一句话结论

你的直觉在数学上是对的,但在语言上要拆成三种强弱不同的主张:

主张 是否已成立 代价
弱:函数名可当数据传递 ✅ 今天就能做(字符串 + call_fn),但零参、不可静态检查 无
中:函数是一等值(可存、可传、可返回) ❌ 需要新值类型 + 动态 callee 中高:契约、指纹、字节码、序列化全都要动
强:函数就是表(结构性、可遍历、可序列化) ❌ 需要把代码降格为数据 高:与「代码即文档」的静态可索引性冲突

建议:把你草图里真正有价值的那部分(有限域决策表)作为一等公民支持——它今天就成立、 且极其契合 Marqdo 的表格优先哲学;而「函数即表」的强主张不建议采纳,理由见 §4、§6。


1. 先把「函数是变量」拆开

这四个概念经常被混为一谈,必须分开,否则讨论会滑。

1.1 外延观(extensional)——函数是「图」

数学上函数就是一组有序对 $f = {(a,1),(b,2)}$,即它的图像。 按这个观点,函数确实是一张表,调用就是查表。

但这里有一个必须先说清的实测事实(我最初也想当然写错了):

GFM 两列表绑定成「列映射」,不是「按首列键控的映射」:

`税率` =

| 档位 | 税率 |
|------|------|
| 1    | 0.03 |
| 2    | 0.10 |
{"档位":[1,2],"税率":[0.03,0.1]}

所以 [2](税率) 不是取税率,而是:

error: missing map key `2`

真正能「键 → 值」查表的形态是 Map(来自 JSON 或库函数),实测两条可用配方:

配方 A(推荐,最简)

**税率 = > json.parse text={"1":0.03,"2":0.10}**
**t = [2](`税率`)**          # → 0.1

配方 B(保留 GFM 表格可读性,但需显式索引)

**ks = [档位](`税率`)**                    # [1, 2]
**vs = [税率](`税率`)**                    # [0.03, 0.1]
**i  = > table.index_of list=`ks` item=2**  # 1
**r  = > table.at xs=`vs` i=`i`**           # 0.1

两条都在 1.5.2 上跑通了。结论:外延观的「函数=表」在 Marqdo 里不是 [k](表) 一句话就能实现,而是「取到键值对」这件事本身需要配方。 这恰好是一个可补的库缺口(见 §8.1)。

1.2 内涵观(intensional)——函数是「规则」

f(x) = x² + 1 无法写成有限表(定义域无穷)。此时函数是代码,调用是执行。

1.3 闭包观——函数是「代码 + 环境」

参数之外还要捕获外部变量。这需要运行时的环境快照。

1.4 名字观——函数是「命名空间里的一条」

今天 Marqdo 就是这一种:函数存在于 Module.functions,按名字解析。

你的草图 |参数|函数体| 属于哪一种? 它是混合体:行是参数声明(§1.4 的味道), 单元格放函数体(§1.2 的味道)。而「和表格取元相似」的直觉来自 §1.1。 三种东西被一句话连起来了——这正是评估要解开的结。


2. 现状实测(全部在 1.5.2 上跑过)

2.1 值模型里没有函数

src/value.rs:15 的 Value 枚举:None / Bool / Int / Num / Text / List / Map / Formula / Code / Secret。 没有 Func。 函数是 AST 节点(src/ast.rs:58 Function),挂在 Module.functions(src/ast.rs:27)。

src/contract.rs:104 的 type_of 同样是十种,穷举无函数。

2.2 调用的 callee 是静态名字,不是表达式

src/ast.rs:130 CallExpr { callee: String, path, receiver, args } —— callee 是 String,不是 Expr。所以语法上无法写出「对计算出来的值发起调用」。

运行期 src/interp.rs:1119 eval_call 最终走到 lookup_function(src/interp.rs:1774), 按名字在 AST 树里查找。

2.3 对象已经是「表」

src/interp.rs:1509 instance_type_name 要求 method receiver 是带 _type 键的 Map:

error: method receiver needs a map with `_type`

也就是说 Marqdo 里「用户定义的结构」本来就是普通 map + 一个标签。 对象与表之间没有鸿沟——这与你的直觉一致,而且已经是既成事实。

但函数不是。对象是值,函数不是。这个不对称值得注意。

2.4 已存在按名字间接调用:call_fn

src/interp.rs:1295:

"call_fn" => {
    // name 必须是 text
    let target = lookup_function(module, fun, name)...;
    if !target.params.is_empty() {
        return Err("call_fn: `{name}` must have no parameters");
    }
    self.run_function(module, target, Env::new(), &[], false)
}

这是今天最接近「函数可传递」的机制,但有三道硬限制:零参、限当前模块、只在运行期校验。

2.5 六组实验

# 写法 结果 结论
1 **f = > greet** missing argument for parameter who > 名字 是调用语法,无法引用函数本身
2 > call_fn name="hello"(无参函数) world 按名字调用可行
3 > call_fn name="add"(有参) call_fn: add must have no parameters 不能传参
4 表里存函数名 + [h](reg) 取名 + call_fn dispatch=world 动态派发今天就能做(名字即数据)
5 > call_fn name="txt.str_trim" unknown function 不能跨模块
6 > call_fn name="no_such_fn" unknown function 拼错只能在运行期发现

实验 4 是关键:它已经是「函数作为表成员」的可用原型,只是把函数表示成名字字符串而不是函数值。


3. 你的类比中成立的部分

必须明确肯定,否则会低估这个想法。

3.1 「有限域函数 = 表」是完全成立的范式

这类函数在工程里非常常见,而且用它表达比写代码更清楚:

场景 适合表格 为什么
税率 / 费率档位 ✅ 有限、离散、常改动
状态机转移表 ✅ 二维查表一目了然
错误码 → 处理动作 ✅ 业务方直接维护
路由分发 ✅ 键即路径
配置映射 ✅ 本来就是数据

而且 Marqdo 的 [键](集合) 取元在语义上就是函数应用 —— 前提是这个集合是 Map(键→值):

**rate = [2](`税率`)**       # 读作:税率(2)

只要 税率 是 Map,这行无需任何语言改动就是一个查表函数。你已经拥有它了。

唯一的坑是数据形态要对:GFM 两列表绑定的是列映射(§1.1 实测), [2](两列表) 会报 missing map key。所以「表 = 函数」成立, 但哪种表有讲究——这正是 §8.1 要补 table.by_column / table.lookup 的原因。

3.2 表格对「参数边界」天然友好

上一轮讨论 [函数名](参数) 时,痛点是参数边界(空格切词)。表格完全绕开这个问题: 键是显式的,不需要切词。

3.3 对象已证明「结构即表」不会损害语言

§2.3 说明对象本来就是 map。既然对象能这样,把数据的函数化交给表格是自洽的。


4. 类比的断裂点

三个,每一个都是硬约束。

4.1 断裂点一:表格是有限的,函数通常是无限的

外延观只对有限定义域成立。f(x)=x²+1 写成表需要无限行。 所以「函数即表」只能覆盖查表能解决的那部分,不能作为函数的通用表示。

一旦你承认这一点,「函数即表」就从「函数的定义方式」降级为「一种特殊函数(图表函数)」。 这仍然有用,但不是语言的核心函数机制。

4.2 断裂点二:函数体是代码,不是数据

你的草图把「函数体」放进单元格。但函数体在 Marqdo 里是 Vec<Stmt>(AST),不是 Value。 要让函数体成为单元格内容,必须先让「代码」成为值——即 Value::Code 那种东西。

而 Value::Code 目前只表示外联语言源码(```lang 围栏),是交给外部执行器跑的, 不是 Marqdo 自己的代码。让 Marqdo 代码变成值 = 引入 eval,这会带来:

  • 静态检查失效(代码在运行期才成形,marqdo check 看不见)
  • EKC 指纹失效(§6.2)
  • 契约失效(§6.1)

4.3 断裂点三:调用不是取元——[k](x) 会被语义重载

这是最要命的一条,与上一轮 [函数名](参数) 的冲突同源。

若「函数是表」且「调用 = [参数](函数表)」,那么:

[a](m)        # m 是普通 Map → 取成员 a
[参数](f)      # f 是「函数表」→ 执行?还是取成员「参数」?

形状完全一致,含义取决于值的类型。这正是上一轮我们判定「不可靠消歧」的同一类问题, 只不过从「语法层歧义」升级成了「类型层重载」。

Marqdo 的 [k](coll) 目前是唯一且清晰的取元语义。让它兼职「调用」, 会让最常用的读表操作变得需要思考「这个表是不是函数」。


5. 五条设计路径

路径 A — Value::Func 闭包(一等函数)

Value::Func(Rc<FuncVal>)   // params + body + captured Env

调用点需支持「对表达式求值后再调用」,即 CallExpr.callee 从 String 变成 Callee::Name(String) | Callee::Expr(Expr)。

代价:

面 影响
契约(T2.1/T2.2) call_arg_diag(c, &target.name, …) 依赖静态 target: &Function;动态调用拿不到,契约检查只能退化为运行期
字节码 Op::Call(fid, argc) 用编译期函数 id(src/bytecode/compile.rs:709),动态 callee 需要新指令或回退树遍历
EKC 指纹 collect_calls 读 c.callee(src/knowledge/fingerprint.rs:76),动态调用只剩字面 call_fn,复用/查重能力下降
序列化 value_to_json(src/host/json.rs:98)对 Value 穷举,函数值必须定义 JSON 语义(丢弃?报错?)
沙箱 函数值无法跨沙箱边界,sandbox.run 的接口要加限制
闭包捕获 需要环境快照与生命周期管理;Env 目前是每次调用新建(Env::new())

适用于:确有高阶需求(回调、map/filter、事件处理)。属于新语言特性,应走 ADR。

路径 B — 函数即表(你的草图,强主张)

代价:A 的全部,外加 §4.3 的语义重载,以及:

  • 表可以 table.put 被修改 → 函数可变?还是只读?
  • 表可以遍历 → 遍历函数会看到什么?参数名?函数体 AST?
  • 表可以 json.stringify → 函数体以什么形式序列化?
  • 宏展开式的能力(代码即数据)会引入自修改程序,与「可静态审计」直接冲突

结论:不建议。它把 Marqdo 从「可静态索引的文档程序」推向「运行期构造的代码」, 是在削弱自己最强的差异点(§6)。

路径 C — 对象可调用(复用 _type + 约定方法)

让 # 类名 实例在 _type 之外带一个约定的 ## 应用 方法,f(x) 时若 f 是 map 且 _type 有该方 法则走方法调用。

优点:不新增 Value 变体;复用既有 method 机制。 缺点:仍需要「f(x) 里 f 是表达式」这一语法能力(同 A 的调用点改造); 且引入「有的 map 可调用」的隐式规则,可读性下降。

路径 D — 名字即函数(扩展现有 call_fn)

不引入函数值,而是把名字这条路径做完整:

> call_fn name="add" args=[1, 2]           # 支持传参
> call_fn name="txt.str_trim" args=[…]     # 跨模块路径
> invoke table=`注册表` key="h" args=[…]    # 从表里按名派发

优点:

  • 零值模型改动 → 契约、字节码、指纹、序列化全部不动
  • 保持「函数永远有名字」→ EKC 能索引,代码可审计
  • 与实验 4 的现有用法完全兼容(只是补齐能力)

缺点:不是真正的一等函数(不能返回闭包);名字拼错仍要运行期发现 (但可以加静态检查:call_fn name="字面量" 时校验目标存在——见 §8.2)。

路径 E — 决策表作为一等公民(推荐方向)

不叫它「函数即表」,而明确它是什么:有限域查表函数。

**税率 = > json.parse text={"1":0.03,"2":0.10}**    # Map:键 → 值
**t = [2](`税率`)**                                  # 今天就能跑 → 0.1

优点:零语言改动,只需文档与库函数支持(例如 table.lookup 带默认值, 把 §1.1 配方 B 的「列取 + 索引」四步压成一步)。 定位诚实:它是数据,不是代码;能被 EKC 索引、能序列化、能进沙箱、能被非程序员维护。


6. 对 Marqdo 特有机制的冲击面

这一节是决策的关键:Marqdo 不是通用语言,它的价值在可静态索引的工程知识。

6.1 契约系统(T2.1 / T2.2)

现有实现把契约挂在 Function 上(src/ast.rs:71),并在调用点用静态 target校验:

if let Some(c) = &target.contract {
    if let Some(d) = contract::call_arg_diag(c, &target.name, &bound, …) { … }
}

动态 callee 拿不到静态 target,契约检查必然退化到运行期——而契约是 Marqdo 「渐进式契约」卖点的核心。

6.2 EKC 指纹与复用

collect_calls 把调用目标名字写进指纹(src/knowledge/fingerprint.rs:76)。 指纹用于查重、复用预检、相似任务召回。动态调用使指纹丢失真实目标, marqdo duplicate / preflight 的准确率会下降——这直接影响智能体复用飞轮。

6.3 「函数必须有名字」是特性,不是限制

EKC 按符号名索引(marqdo knowledge 输出 59 modules, 346 symbols)。 匿名函数/表构造的函数无法被索引,也就无法被复用、被审计、被智能体发现。

对 Marqdo 而言,函数有名字不是妥协,而是「代码即文档」的必然: 文档里的每一段代码都得有一个可被引用的标题。

6.4 序列化与沙箱

value_to_json 穷举所有 Value。函数值需要 JSON 语义; 沙箱(CoW + 禁 exec/net/plugin)跨边界传值时,函数无法表示。 一旦函数成为值,sandbox.run 的入参约束必须收紧。

6.5 确定性与可审计

表格是静态可读的:非程序员能改税率表。代码构造的函数则要求读者在脑中执行程序。 Marqdo 面向的是「文档作者也能维护」的场景,这一点权重很高。


7. 方案对比

维度 A 闭包 B 函数即表 C 可调用对象 D 扩展 call_fn E 决策表
值模型改动 需新变体 需新变体+代码即值 无 无 无
保持静态可索引 部分(匿名不可) ❌ ✅ ✅ ✅
契约检查 退化 退化 保持 保持 保持
EKC 指纹 退化 退化 保持 保持 保持
序列化/沙箱 需特殊处理 需特殊处理 保持 保持 保持
解决参数边界 ✅ ✅ ✅ ✅ ✅
支持无限定义域 ✅ ❌ ✅ ✅ ❌(本质限制)
实现成本 高 很高 中 低 零
风险 中高 高 中 低 无

8. 建议(分阶段)

8.1 立即可做:决策表(路径 E)

零语言改动。补三件事即可让它好用:

  1. 补库缺口:新增 table.lookup map=key=default=(键→值,缺键返回 default)与 table.by_column rows=key_col=value_col=key=`(把 §1.1 配方 B 的四步压成一步)。 这是当前最实的缺口——GFM 两列表无法直接键查表,用户会反复手写索引逻辑。
  2. 文档:在教程里明确「有限域映射怎么表达」,并给出三种形态的取舍:
    • 键→值查表 → json.parse 的 Map + [键](map)
    • 需要保留表格可读性 → 两列表 + table.by_column
    • 缺键行为 → 用 table.get / default=,避免缺陷 D5 的 missing map key 硬崩
  3. 命名:明确它叫「决策表 / 查表」而不是「函数」——避免与 §1.2 的内涵观混淆。

价值:把用户已有的直觉固化成推荐用法,不付任何架构代价。

8.2 短期可做:扩展 call_fn(路径 D)

补齐三件事,都不触及值模型:

补充 说明
args= 允许传参,按目标签名绑定
跨模块路径 name="lib.fn" 走 import 解析
字面量静态校验 call_fn name="字面量" 在 check 期就校验目标存在(消灭实验 6 的类错误)

收益:动态派发能力完整,且完全保留契约/指纹/序列化。

8.3 中期评估:一等函数(路径 A)

只有当出现确实无法用名字表达的需求时才做(例如回调、策略模式、事件处理器)。 届时必须写 ADR,并明确回答:

  • 匿名函数如何进入 EKC 索引?(可能需要要求「赋给变量的函数字面量必须有名字」)
  • 契约在动态调用下如何降级?
  • 字节码是否引入 Op::CallValue?
  • 函数值的 JSON 语义是什么?

8.4 不建议:路径 B(函数即表,强主张)

理由汇总:§4.3 语义重载 + §6 全面削弱静态可索引性 + §5 自修改程序风险。


9. 如果你想保留「函数即表」的形态,有一个折中

把「表」用于参数与分发,而不用于函数体:

`税率表` =

| 档位 | 税率 |
|------|------|
| 1    | 0.03 |
| 2    | 0.10 |

## 税率
    + `档位`

**ks = [档位](`税率表`)**
**vs = [税率](`税率表`)**
**i = > table.index_of list=`ks` item=`档位`**
**r = > table.at xs=`vs` i=`i`**
*r*

(若 §8.1 的 table.by_column 落地,函数体可缩成一行: **r = > table.by_column rows=税率表 key_col="档位" value_col="税率" key=档位**。)

这里:

  • 数据在表里(可被非程序员维护、可序列化、可进沙箱、可被 EKC 索引)
  • 逻辑在命名函数里(可契约、可指纹、可审计)
  • 调用仍是一等清晰的 > 税率 档位=2

这其实是最好的分工:表格承担「知识」,函数承担「行为」。 它同时满足你的类比直觉(表驱动)和 Marqdo 的静态可索引性。


10. 待你决策

  1. 方向:选 E(决策表,零改动)、D(扩展 call_fn)、还是 A(一等函数,需 ADR)?
  2. 若倾向 D:args= 的参数形式用 [1, 2](列表)还是 a=1 b=2(具名)?
  3. 是否要我把 §9 的「数据在表、逻辑在函数」写成教程规范?
  4. 是否存在具体用例驱动一等函数?(例如某个 ext 需要回调) 若有真实用例,评估会完全不同——请给我场景,我按场景重新评估。