- []() 零新语法:描述 + 已有类/函数调用,不引入 ref/别名/开关 - # 是类、## 是函数;类.函数 是类调用;跨文档用项目类索引 - 知识分层:原始语料 / 本体 / 单体知识类 / 调用面;出处与还原验证 - 新增 link-syntax、knowledge-layers 设计声明与两组可运行/目标示例
110 lines
3.5 KiB
Markdown
110 lines
3.5 KiB
Markdown
# 链接语法示例:两文档,一次类调用
|
||
|
||
这个目录是 [链接语法设计声明](../../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)
|