Files
marqdo/examples/view-reading.mq.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

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="没有数量"))**。
把已经计算的值整理成一行记录,字段名称说明每一项的来源。
`摘要` =
| 第一笔 | 第二笔 | 总数 |
|---|---|---|
| `第一笔` | `第二笔` | `总数` |
最后返回*摘要*,调用者得到的是结构化记录;上面的预留函数并未在本流程中调用。