Files
marqdo/public/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.3 KiB
Executable File
Raw Blame History

用户文档(可执行 · 可下载 · 中英双语)

本目录即面向访客的 Marqdo 介绍:每个 .mq.md 既是文稿也能 marqdo run,并随仓库 / 静态站一起下载。

双语约定: 拉丁文件名 → 英文叙述与英文内置;中文文件名 → 中文叙述与中文编程。成对放在同一目录。标准库:拉丁路径用英文 API,中文路径用中文 API;JSON 仅 lib/json.mq.md。

路径 内容
00-welcome.mq.md / 00-欢迎.mq.md 首页(英 / 中)
structure/ 基本结构
keywords/ 关键字与 L0 内置
stdlib/ 标准库(导入方式 + text/表/文件/时间/系统/json/网络/数学/外联/插件/自写回/子任务;v0.1.2+ 内置于 CLI)
features/ 特性迭代(含对象、官方 ext/)
features/19-foreign-view-cells.mq.md / 19-外联视图单元.mq.md 外联 v2 完整 Python 示例:probe / JSON call / 并行 / 持久内核 / 状态桥 / view 单元
features/20-okf-ekc.mq.md / 20-OKF与EKC.mq.md 代码即文档、文档即知识:OKF 形态与 EKC 工程知识编译器
features/21-persistence.mq.md / 21-持久化.mq.md 外联结果持久化:静态快照与 writeback
features/22-call.mq.md / 22-函数调用.mq.md marqdo call:同一份文档按函数执行,知识可以直接当工具

官方扩展(非 stdlib):ext/llm、ext/agent、ext/web、ext/quantum、ext/linalg — 见 features/05-*.mq.md、06-*.mq.md、07-linalg.mq.md / 07-线性代数.mq.md 与 doc/design/ext-*.md。

中层标准库(Mid):08–12(re/encoding · path/fs · hash/secrets · csv/text · list/cli;及对应中文页)。

不放 errors/:失败样例只在 tests/errors/。

开发文档在 doc/。

浏览与生成 HTML

cargo run -- view public
cargo run -- view output public -o public

详见 user-site.md。