- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
链接语法示例:两文档,一次类调用
这个目录是 链接语法设计声明 的目标示例:
[李白的出生年份](李白.李白的出生年份)不是新的语法:[]是 Markdown 链接的描述,()是已有调用;# 李白是类,## 李白的出生年份是函数,李白.李白的出生年份是类调用。
文件
| 文件 | 作用 | v2.0.0 可跑 | v2.1 目标 |
|---|---|---|---|
libai.mq.md |
知识文档:# 李白 → ## 李白的出生年份 → *701* |
✅ | ✅ |
main.mq.md |
用户原始示例:正文链接 + 类调用 | ❌(安静无输出) | ✅ view 显示;run 加 print 输出 |
main.compat.mq.md |
当前等价写法:import + 实例 + 本地链接 |
✅(输出 701) |
✅ |
expected-link-info.json |
目标 LinkInfo 形状 |
— | — |
links.lock.yaml |
可选锁文件形状 | — | — |
v2.0.0 的
main.mq.md不会报错,也不会有输出——因为:
- 正文链接默认不执行(叙述默认安全);
李白.李白的出生年份目前被当成变量/实例方法路径,类调用还没实现。v2.1 的目标是:
view显示这个链接的目标、类、函数、签名、值;check返回 LinkInfo; 要终端输出,就在代码链接里加
今天可跑
marqdo run examples/link-syntax/main.compat.mq.md
# 701
main.compat.mq.md 用当前能力完成了同一件事:
---
markup: occlusion
import libai:libai.mq.md
---
# main
**li = > libai.李白**
**year = [李白的出生年份](li.李白的出生年份())**
> print text=`year`
import绑定知识文档;> libai.李白构造对象(当前#是对象/类型);li.李白的出生年份()调用实例方法;[]()把调用包成一句人话。
这正是 v2.0.0 的「实例方法」路径;v2.1 要把 ## 恢复为类函数,
让 李白.李白的出生年份 直接调用,去掉 import/实例两步。
目标形式
main.mq.md:
# main
用户想要知道李白的出生年份,我们要告诉用户[李白的出生年份](李白.李白的出生年份)
v2.1 期望:
$ marqdo run examples/link-syntax/main.mq.md
# 无输出(正文链接不执行;加 print 才有输出)
$ marqdo check examples/link-syntax/main.mq.md --json
{"code":"link.ok", ...}
view 期望:
用户想要知道李白的出生年份,我们要告诉用户 701。
↑
悬浮:李白的出生年份 → 李白.李白的出生年份
class 李白 · function · () -> number · value 701
要终端输出:
# main
**year = [李白的出生年份](李白.李白的出生年份)**
> print text=`year`
$ marqdo run examples/link-syntax/main.mq.md
701
为什么是 李白.李白的出生年份
# 李白是类;## 李白的出生年份是类下的函数;李白.李白的出生年份是类调用;[]是描述,()是已有调用;没有新语法,没有协议前缀,没有别名开关。