Files
marqdo/examples/knowledge-layers/README.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- 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。
2026-11-18 10:29:26 +08:00

2.9 KiB
Executable File
Raw Blame History

知识分层示例:本体 → 知识个体 → 调用面

这个目录演示 知识分层设计:

层 文件 内容
L0 原始语料 corpus/libai.md 李白原文;不执行,只作出处
L1 本体 / 模式 poet.mq.md # 诗人 + 字段/类型表
L2 可执行知识 libai.mq.md # 李白 = > 诗人 + ## 事实 + 来源
L3 调用面 main.mq.md / main.compat.mq.md []() 类调用

关键术语:# 李白 = > 诗人 是知识个体/单体知识类(语法上是继承/特化), 不是运行时实例;> 李白 才是运行时 map 实例。

今天可跑(v2.0.0 兼容)

marqdo run examples/knowledge-layers/main.compat.mq.md
# 701

main.compat.mq.md 用当前能力完成同一件事:

---
import libai:libai.mq.md
---

# main

**li = > libai.李白**
**year = > `li`.出生年份**
> print text=`year`
  • import 绑定知识文档;
  • > libai.李白 构造实例;
  • `li`.出生年份 调用实例方法;
  • 当前 libai.mq.md 还保留 import poet:poet.mq.md,因为 v2.0.0 的跨文档继承需要 import; v2.1 的项目类索引会去掉这个 import。

目标(v2.1)

main.mq.md:

# main

诗人李白的出生年份是[出生年份](李白.出生年份)。
  • 李白 是项目类索引里的知识个体;
  • 出生年份 是它的类函数;
  • 正文链接由 view/check 解析;run 不执行;
  • 要终端输出,把同一段代码放进代码链接并加 print。

期望:

$ marqdo run examples/knowledge-layers/main.mq.md
# 无输出(正文链接不执行)

$ marqdo check examples/knowledge-layers/main.mq.md --json
{"code":"link.ok", ...}

view 期望显示:

诗人李白的出生年份是 701。
                        ↑
      悬浮:出生年份 → 李白.出生年份
            class 李白 · () -> number · value 701
            来源:corpus/libai.md#出生年份

为什么 # 李白 = > 诗人 不是「实例化」

  • # 诗人 是类/本体;
  • # 李白 = > 诗人 是继承/特化,表达「李白是诗人」;
  • 但它带有一个命名个体的全部事实,所以是单体知识类;
  • 李白.出生年份 是类调用,不需要 > 李白 构造实例;
  • 如果要运行时实例,仍可 **li = > 李白**,它是 map + _type,和知识个体分离。

详见 doc/design/knowledge-layers.md。

相关