- 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。
110 lines
3.5 KiB
Markdown
Executable File
110 lines
3.5 KiB
Markdown
Executable File
# 链接语法示例:两文档,一次类调用
|
||
|
||
这个目录是 [链接语法设计声明](../../doc/design/link-syntax.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` 不会报错,也不会有输出**——因为:
|
||
> 1. 正文链接默认不执行(叙述默认安全);
|
||
> 2. `李白.李白的出生年份` 目前被当成变量/实例方法路径,类调用还没实现。
|
||
>
|
||
> v2.1 的目标是:`view` 显示这个链接的目标、类、函数、签名、值;`check` 返回 LinkInfo;
|
||
> 要终端输出,就在代码链接里加 `print`。
|
||
|
||
## 今天可跑
|
||
|
||
```bash
|
||
marqdo run examples/link-syntax/main.compat.mq.md
|
||
# 701
|
||
```
|
||
|
||
`main.compat.mq.md` 用当前能力完成了同一件事:
|
||
|
||
```markdown
|
||
---
|
||
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`:
|
||
|
||
```markdown
|
||
# main
|
||
用户想要知道李白的出生年份,我们要告诉用户[李白的出生年份](李白.李白的出生年份)
|
||
```
|
||
|
||
v2.1 期望:
|
||
|
||
```bash
|
||
$ marqdo run examples/link-syntax/main.mq.md
|
||
# 无输出(正文链接不执行;加 print 才有输出)
|
||
|
||
$ marqdo check examples/link-syntax/main.mq.md --json
|
||
{"code":"link.ok", ...}
|
||
```
|
||
|
||
`view` 期望:
|
||
|
||
```text
|
||
用户想要知道李白的出生年份,我们要告诉用户 701。
|
||
↑
|
||
悬浮:李白的出生年份 → 李白.李白的出生年份
|
||
class 李白 · function · () -> number · value 701
|
||
```
|
||
|
||
要终端输出:
|
||
|
||
```markdown
|
||
# main
|
||
|
||
**year = [李白的出生年份](李白.李白的出生年份)**
|
||
> print text=`year`
|
||
```
|
||
|
||
```bash
|
||
$ marqdo run examples/link-syntax/main.mq.md
|
||
701
|
||
```
|
||
|
||
## 为什么是 `李白.李白的出生年份`
|
||
|
||
- `# 李白` 是类;
|
||
- `## 李白的出生年份` 是类下的函数;
|
||
- `李白.李白的出生年份` 是**类调用**;
|
||
- `[]` 是描述,`()` 是已有调用;没有新语法,没有协议前缀,没有别名开关。
|
||
|
||
## 相关
|
||
|
||
- 设计声明:[doc/design/link-syntax.md](../../doc/design/link-syntax.md)
|
||
- 证据复核:[doc/research/occlusion-vs-executable-knowledge-2026-10.md](../../doc/research/occlusion-vs-executable-knowledge-2026-10.md)
|
||
- 旧遮蔽设计:[doc/design/occlusion-syntax.md](../../doc/design/occlusion-syntax.md)
|