- 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。
81 lines
3.1 KiB
Markdown
Executable File
81 lines
3.1 KiB
Markdown
Executable File
---
|
|
markup: occlusion
|
|
title: 在正文里读懂一段程序
|
|
description: 用同一份源码演示动作遮蔽、输入输出、数据表、条件、循环和待补逻辑。
|
|
---
|
|
|
|
这份示例把计算留在文章里。动作说明可以直接阅读,展开侧注才看到实际表达式。
|
|
侧注说明“准备怎样计算”,运行标注说明“这一次得到什么”;两种信息有不同的来源。
|
|
|
|
用 marqdo view examples/view-reading.mq.md 打开实时阅读,或执行下面的离线导出命令。
|
|
导出时的 --no-exec 只分析和排版,不运行示例,也不触发任何动作。
|
|
|
|
```sh
|
|
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))**,再**第二笔 = [使用默认件数](计算小计(单价=8))**。
|
|
两个动作可以在同一句话里出现,各自关联自己的逻辑侧注。金额的实际数值只在运行后产生。
|
|
|
|
下面的单列表是三个数量组成的列表;绑定名让它成为数据,和上面的参数契约表不同。
|
|
|
|
`数量列表` =
|
|
|
|
| 数量 |
|
|
|---|
|
|
| 1 |
|
|
| 2 |
|
|
| 3 |
|
|
|
|
从**总数 = 0**开始累计,每次迭代读取一个值。切换迭代记录只是在查看既有结果,不会重跑循环。
|
|
|
|
- [依次累计数量](遍历 数量列表 为 项)
|
|
把当前项加入已有累计,得到**总数 = 总数 + 项**。
|
|
|
|
下面按计算结果选择分支;未进入的分支仍然属于源码,不会因为查看运行记录而消失。
|
|
|
|
1. `总数` > 0
|
|
确认这次遍历已有数据后,执行**[输出累计值](print(text=`总数`))**。
|
|
2. *
|
|
没有数量时,执行**[说明输入为空](print(text="没有数量"))**。
|
|
|
|
把已经计算的值整理成一行记录,字段名称说明每一项的来源。
|
|
|
|
`摘要` =
|
|
|
|
| 第一笔 | 第二笔 | 总数 |
|
|
|---|---|---|
|
|
| `第一笔` | `第二笔` | `总数` |
|
|
|
|
最后返回*摘要*,调用者得到的是结构化记录;上面的预留函数并未在本流程中调用。
|