- 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。
3.1 KiB
Executable File
3.1 KiB
Executable File
markup, title, description
| markup | title | description |
|---|---|---|
| occlusion | 在正文里读懂一段程序 | 用同一份源码演示动作遮蔽、输入输出、数据表、条件、循环和待补逻辑。 |
这份示例把计算留在文章里。动作说明可以直接阅读,展开侧注才看到实际表达式。 侧注说明“准备怎样计算”,运行标注说明“这一次得到什么”;两种信息有不同的来源。
用 marqdo view examples/view-reading.mq.md 打开实时阅读,或执行下面的离线导出命令。 导出时的 --no-exec 只分析和排版,不运行示例,也不触发任何动作。
marqdo view output examples/view-reading.mq.md --no-exec --out /tmp/marqdo-reading
计算小计
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 单价 | number | 必填 | 每件商品的价格,使用调用方选定的同一种货币单位 |
| 数量 | number | 1 | 购买的件数;本例由调用方保证非负 |
| 返回 | 类型 | 说明 |
|---|---|---|
| 小计 | number | 单价乘以数量得到的金额,不包含额外税费或优惠 |
已知商品的单价,未指定时购买数量=1。这里没有网络请求或文件写入;
价格与数量由调用者提供,不会从屏幕上的说明自动推测。
完成乘法后,我们返回*[按件数计算金额](单价 * 数量)*,让后面的步骤继续使用。
预留逻辑
| 返回 | 类型 | 说明 |
|---|---|---|
| 结果 | any | 当前返回 None;尚未接入实际业务实现 |
此函数演示空遮蔽的显示。它没有实现业务行为,不能作为“功能已完成”的证据。 目前返回*由作者补充具体业务*;阅读器会明确标出待补逻辑,而不会假装已有结果。
main
| 返回 | 类型 | 说明 |
|---|---|---|
| 结果 | map | 两笔金额与遍历计算的总数,均来自这一次实际执行 |
先第一笔 = [购买两件商品](计算小计(单价=12, 数量=2)),再第二笔 = 使用默认件数。 两个动作可以在同一句话里出现,各自关联自己的逻辑侧注。金额的实际数值只在运行后产生。
下面的单列表是三个数量组成的列表;绑定名让它成为数据,和上面的参数契约表不同。
数量列表 =
| 数量 |
|---|
| 1 |
| 2 |
| 3 |
从总数 = 0开始累计,每次迭代读取一个值。切换迭代记录只是在查看既有结果,不会重跑循环。
- [依次累计数量](遍历 数量列表 为 项) 把当前项加入已有累计,得到总数 = 总数 + 项。
下面按计算结果选择分支;未进入的分支仍然属于源码,不会因为查看运行记录而消失。
总数> 0 确认这次遍历已有数据后,执行**输出累计值**。-
没有数量时,执行**说明输入为空**。
把已经计算的值整理成一行记录,字段名称说明每一项的来源。
摘要 =
| 第一笔 | 第二笔 | 总数 |
|---|---|---|
第一笔 |
第二笔 |
总数 |
最后返回摘要,调用者得到的是结构化记录;上面的预留函数并未在本流程中调用。