一套调用语法:既调自己的函数,也调 COM

Fun 把「命名参数」当作语言里最普通的一件事:

```fun
fun send(to, subject, body)
  ...
end fun;

send(to: 'a@x.com', body: 'hi');   # 跳过 subject -> null
```

这本身不稀奇,好几门语言都支持命名参数。稀奇的是另一件事:把**这同一套语法**指向 Windows 的 COM / OLE Automation 对象时,会发生什么。Fun 的 `lib-winole` 让你用命名参数调用 ActiveX 方法,就跟你调用自己写的函数一模一样:

```fun
var excel = 'Excel.Application'.newobj();

excel.Workbooks.Open(filename: 'report.xlsx', readOnly: true);  # 按名传 COM 参数
excel.Visible = true;      # 属性赋值(或 excel.@@Visible(true))
?. excel.@Visible();       # 属性读取(或 excel.Visible)
```

没有辅助对象、没有 DISPPARAMS 簿记、没有要新学的 COM 专属 API。你写 `method(n: v)`,Fun 就把它映射到 COM 的 `IDispatch` 调用,参数按名字传过去。

## 先看它本来是什么

命名参数在 Fun 里不是为 COM 准备的,它先是普通函数的调用方式。声明时给参数起名,调用时就能按名传:

```fun
fun send(to, subject, body)
  ...
end fun;

send(to: 'a@x.com', body: 'hi');   # 没写的 subject 自动为 null
```

顺序可以打乱,不想传的参数可以跳过。这套机制和 COM 毫无关系,它服务的是日常代码的可读性:参数一多,`a,b,c,d` 的位置约定就不好记了。

## 稀奇的地方:同一套语法,换一个世界

Windows 的 COM Automation 通过 `IDispatch` 暴露方法,而它传统上的传参机制很啰嗦:要填 `DISPPARAMS` 结构,要区分位置参数和命名参数,还要处理 `DISPID` 的名字解析。

Fun 没有为 COM 另外发明一套调用语法。它让参数表达式**本身就可以带名字**(`n: v`),`lib-winole` 在发起调用时读取这些名字,构建出 COM 需要的命名参数列表:

```fun
var regex = 'VBScript.RegExp'.newobj();

regex.Pattern = '^\d+$';    # 属性赋值,等价于 regex.@@Pattern('^\d+$')
?. regex.Test('123');       # 调用方法
?. regex.@Pattern();        # 读属性,等价于 ?. regex.Pattern
```

于是你不用记两套心智模型:一套用来调自己写的东西,另一套用来调系统里的 COM 对象。它们本来就是同一套。

## 为什么这比别的方案更顺

- **VBScript** 支持命名 COM 参数,代价是你得整个用 VBScript 写。
- **PowerShell** 对 COM `IDispatch` 方法的命名参数支持很别扭,往往要补位置空位,或者用 `.InvokeMember` 之类的反射体操。
- **Python 的 `win32com`** 要先搭起 `Dispatch` / `win32com.client` 一堆管道,命名参数并不是一等公民。

Fun 的优势在于**统一**:命名参数不是傍挂在 COM 上的特性,而是这门语言最普通的调用语法,原封不动地复用到 `IDispatch` 上。只学一次,两片天地都能调。

## 背后的机制

在解释器一侧,Fun 的参数表达式允许携带名字;`lib-winole` 的 `DispInvoke` 把这些名字读出来,拼成 COM 的命名参数列表,再交给 `IDispatch`。属性读写也走同一条路:

- `x = obj.Property` 或 `x = obj.@Property()` —— 读属性;
- `obj.Property = x` 或 `obj.@@Property(x)` —— 写属性;
- 带参数的属性 `obj.@Property(...)`,读写都能与命名参数组合使用。

这与语言其余部分一脉相承:**当已有的机制够用时,优先复用,而不是另造一个新的。**

## 一句话总结

能调 Windows COM 的语言不少,但把「命名参数」这一件小事做成语言核心、再用同一套语法去调系统对象的,不多。Fun 没有为 COM 单开一扇门,它是把原本就开着的门,直接通到了 COM。