Use + for parameters, ordered-list branches, backtick identifiers, and quoted strings with escapes. Add writeback and subtask host libs, optional parameter defaults, narrative-bold comment fix, and defer view execution until preset stdin is submitted. Co-authored-by: Cursor <cursoragent@cursor.com>
74 lines
2.0 KiB
Markdown
74 lines
2.0 KiB
Markdown
# Objects(`#`)与函数(`##`+)
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | Accepted |
|
||
| 日期 | 2026-08-06 |
|
||
| 相关 | [markdown-mapping.md](markdown-mapping.md) · [ext-llm.md](ext-llm.md) |
|
||
|
||
## 1. 约定
|
||
|
||
| 标题层 | 含义 |
|
||
|--------|------|
|
||
| `#`(恰好一层) | **对象 / 类型**。正文 = 构造体;调用类型名 = 构造实例。 |
|
||
| `##` 及更深 | **函数**(自由函数或方法)。层数差表示嵌套,与 v0.1 相同。 |
|
||
|
||
`# main` 是**入口对象**:运行文件 = 执行其构造体。若无 `main`,且文件恰好只有一个无参顶层 `#` 对象(如 `# Hello World`),则把它当作入口。
|
||
|
||
## 2. 实例句柄
|
||
|
||
构造返回值若为 `map`,运行时写入 `_type`(文本,值为类型名),形成句柄。
|
||
方法调用通过 `_type` 找到定义对象,再解析其下的 `##` 方法。
|
||
|
||
方法体内自动绑定:
|
||
|
||
- `自`(中文)
|
||
- `self`(英文)
|
||
|
||
二者同一接收者。
|
||
|
||
## 3. 调用外形
|
||
|
||
```markdown
|
||
# 大模型
|
||
+ `模型名`
|
||
|
||
*`自` = …配置 map…*
|
||
**`自`**
|
||
|
||
## 运行
|
||
+ `提示`
|
||
|
||
…使用 `自` …
|
||
**`内容`**
|
||
|
||
# main
|
||
|
||
*`模型` = > 大模型 模型名=gpt-4o-mini *
|
||
*`回复` = > `模型`.运行 提示=你好 *
|
||
> print text=`回复`
|
||
```
|
||
|
||
- `> 大模型 …` — 构造
|
||
- `` > `模型`.运行 … `` — 方法(接收者 + `.` + 方法名)
|
||
- `## 自由函数` 挂在模块顶层(非某对象子标题)— 与旧版顶层 `# http_get` 对等,现写为 `## http_get`
|
||
|
||
## 4. 标准库
|
||
|
||
官方 `lib/*.mq.md` 以**顶层自由函数**为主:全部为 `##`(不再使用 `#` 冒充类型)。
|
||
真正的类型化扩展(如 `ext/llm`)使用 `# 类型` + `##` 方法。
|
||
|
||
## 5. 非目标(本波)
|
||
|
||
- 继承 / 接口 / 可见性
|
||
- 无 `_type` 的「鸭子」方法分发
|
||
- 用表格声明字段 schema(表格仍表示集合)
|
||
|
||
## 6. 迁移摘要
|
||
|
||
| 旧 | 新 |
|
||
|----|----|
|
||
| 库顶层 `# http_get` | `## http_get` |
|
||
| `# main` + `## 嵌套` | 不变(main = 入口对象) |
|
||
| `ext` 顶层 `# complete` | `# llm` / `# 大模型` 构造 + `## complete` / `## 运行` |
|