Complete the core agent roadmap: soft KB hits via Task aliases, EventBus-backed view streaming, D4 writeback/workbook navigation, and I3 explicit-super without implicit auto-super. Co-authored-by: Cursor <cursoragent@cursor.com>
4.8 KiB
4.8 KiB
对象继承语法(未来规划)
| 状态 | I0–I3 已落地(显式父构造约定;不做隐式 auto-super) |
| 日期 | 2026-08-10 |
| 相关 | objects.md · markdown-mapping.md · keywords.md |
| 提案语法 | # 子类 = > 父类 |
1. 动机
今日 objects.md 明确非目标:继承 / 接口 / 可见性。
实际扩展(如 # agent / # llm)靠「再写一个对象 + 组合句柄」,缺少:
- 复用父构造 / 父方法而不复制
.mq.md - 子类型在
_type链上解析方法 - 与 Markdown 标题体系一致的、可读的继承声明
需要一种不引入 class/extends 关键字、且与现有 =(绑定)与 >(调用)语义兼容的写法。
2. 锁定语法(提案)
# 子类 = > 父类
| 片段 | 既有含义 | 组合后含义 |
|---|---|---|
# 子类 |
定义对象 / 类型 | 子类型名 |
= |
绑定 / 赋值 | 类型关系写在「类型定义槽」上 |
> 父类 |
调用(此处为类型名) | 基类引用(不是构造实例) |
可选带参基类(若基类本身是泛化构造,v1 可暂不支持):
# 特化智能体 = > 智能体
中英对称:
# Child = > Parent
# 子类 = > 父类
2.1 为何不冲突
- 今日
# 名后接的是构造体正文,不是`# 名 = …`标题行。 - 语句绑定是
*…*或行内`x` =,不是 ATX#标题。 > 父类在标题行出现在=右侧:解析器可把「#标题含=与>」识别为类型声明,而非执行构造。- 真正构造实例仍是正文或
# main里的`x` = > 子类 …。
反例(仍是今日语义,不变):
# main
*`a` = > 父类 *
3. 运行时语义(草案)
3.1 方法解析
实例 map 仍有 _type = 构造时的类型名(子类名)。
查找 `obj`.方法:
- 在
_type对应对象上找## 方法 - 未找到 → 沿 基类链 查找
- 仍无 → 报错(带类型链)
构造:
- 若子类构造体未显式处理,可先调基类构造(见开放点:是否自动
super)。 - 返回 map 的
_type= 最具体子类名(不是父类名)。
3.2 子类正文
# 工蜂 = > 智能体
## 采蜜
+ `花`
*`out` = > `self`.step task=`花` *
**`out`**
- 子类可定义新
## - 可覆盖同名
##(子类优先) - 站立提示 / 字段约定:文档层说明,v1 不引入可见性关键字
3.3 多继承
v1 不支持。 一个 # 子 = > 父 仅一条基类。混入用组合(句柄字段)而非多 >。
4. 解析与 AST
标题形态需在 markdown-mapping.md / parse 中新增一种 object decl:
| 字段 | 值 |
|---|---|
name |
子类 |
base |
父类(标识符) |
body |
与今日 object body 相同 |
歧义处理:
# Foo = 1→ 非法(右侧必须是> 类型名)# Foo = > bar.baz→ v1 非法(基类须为已定义对象名,不走任意调用表达式)- 基类尚未定义 → Pass1 收集后解析;循环继承报错
5. 与标准库 / 扩展
| 用途 | 例子 |
|---|---|
| 扩展官方智能体 | # 客服 = > agent / # 客服 = > 智能体 |
| 扩展 llm 句柄 | 一般不必要;优先组合 |
| 用户域模型 | # 订单服务 = > 服务基类 |
官方 lib/* 仍以自由函数为主;继承主要服务 ext/ 与用户对象。
6. 推荐落地顺序
I0 语法 + AST + 金样(解析/循环继承错误) ✅
I1 方法解析沿基类链;构造 _type=子类 ✅
I2 覆盖方法;文档更新 objects.md ✅
I3 显式父构造约定(**不做**隐式 auto-super) ✅
验收:
- 无继承文件行为不变。
- 子类实例能调父类
##;覆盖后只走子类。 # A = > B/# B = > A诊断清晰。- Skill / 金样:
tests/structure/inherit-*.mq.md(含显式`self` = > Parent)。
7. 开放点
隐式 super→ 不做:子类构造体不自动跑父构造。需要父初始化时正文写`self` = > 父类 …再改字段后**self**;构造完成时_type仍为最具体子类名。- 中英基类别名:
> agent与> 智能体是否同一对象(取决于模块导出)。 - 继承是否写入 OKF Module 页(catalog 展示
extends)——可随 O3/O4 增强。
8. 非目标
- 接口 / 抽象方法 / 可见性(
public) - 多继承、mixin 关键字
- 用继承替代
plan工作簿接力 - 把
# 子 = > 父解析成「定义时立即构造父实例」