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

1.5 KiB
Executable File

markup, title
markup title
occlusion 描述与细节

这份文档把意图留在句子中,把细节放在侧注里。阅读和展开详情都不会运行示例中的函数,只有主动调用才会计算。

可以先看 [函数与参数](计算费用(单价=12, 数量=2)),再看 [嵌套调用](计算费用(单价=abs(-12), 数量=2)),了解每个输入来自哪里。

引用 [列表内容]([1, 2, 3]) 和 [记录内容]({"名称": "茶", "单价": 12}) 时,侧注会按内容的结构排列;补充说明 则直接呈现文字。

待实现的步骤 会明确提示待补充,避免把缺失逻辑当成已经完成的工作。

通过 跳到函数定义 可以在当前文档中定位,通过 查看阅读示例 可以打开同目录文档;访问项目仓库 保留正常的网页跳转。

计算费用

参数 类型 默认值 含义
单价 number 0 每件商品的价格
数量 number 1 本次购买的件数
返回值 类型 含义
费用 number 单价与数量的乘积

调用方提供 单价=0 和 数量=1 后,可以直接按件数计算。这一示例只处理简单乘法,未包含税费、折扣或金额舍入规则,实际项目应根据业务补齐这些约定。

在确认输入符合业务要求之后,返回 [按件数计算](单价 * 数量),调用方便得到了本次购买的总费用。