Files
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

19 KiB
Executable File

markup, title, description
markup title description
occlusion lib/数学 高中数学 — 数值、随机、公式、作图

高中数学 — 数值、随机、公式、作图

计算数字、符号表达式和绘图。

能力与边界:number 契约包括符号公式;三角函数使用弧度。随机数需要 random.read,绘图具有输出效应。矩阵和量子计算保留在扩展库。

本文件就是调用和开发手册:直接导入此文件,或用 marqdo call 按下面的函数标题调用。参数表说明类型和默认值;未填默认值的参数必须提供。返回表是渐进契约,后文说明失败与边界。

实现入口:src/host/math.rs

开发时保持中英文语义一致,先组合公开库;仅在 OS 或算法边界添加宿主原语并声明效应。修改后运行 marqdo check --narrative-ratio 本文件,并执行 tests/stdlib_tasks.rs 的真实任务。

圆周率

返回 类型 说明
result number 返回数学常数圆周率

调用效应:pure。

返回数学常数圆周率。

完成后返回*返回数学常数圆周率*。

自然底数

返回 类型 说明
result number 返回自然常数 e

调用效应:pure。

返回自然常数 e。

完成后返回*返回自然常数 e*。

数

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 把数字或数字文本转换为数值

这里使用value。

调用效应:pure。

把数字或数字文本转换为数值。

完成后返回*[把数字或数字文本转换为数值](> host_num value=value)*。

加

参数 类型 默认 说明
a any 必填 第一个操作数;适用范围见本操作说明
b any 必填 第二个操作数;适用范围见本操作说明
返回 类型 说明
result number 将两个数字或符号表达式相加

这里使用a、b。

调用效应:pure。

将两个数字或符号表达式相加。

完成后返回*[将两个数字或符号表达式相加](> host_math_add a=a b=b)*。

减

参数 类型 默认 说明
a any 必填 第一个操作数;适用范围见本操作说明
b any 必填 第二个操作数;适用范围见本操作说明
返回 类型 说明
result number 从 a 减去 b

这里使用a、b。

调用效应:pure。

从 a 减去 b。

完成后返回*[从 a 减去 b](> host_math_sub a=a b=b)*。

乘

参数 类型 默认 说明
a any 必填 第一个操作数;适用范围见本操作说明
b any 必填 第二个操作数;适用范围见本操作说明
返回 类型 说明
result number 计算 a 与 b 的乘积

这里使用a、b。

调用效应:pure。

计算 a 与 b 的乘积。

完成后返回*[计算 a 与 b 的乘积](> host_math_mul a=a b=b)*。

除

参数 类型 默认 说明
a any 必填 第一个操作数;适用范围见本操作说明
b any 必填 第二个操作数;适用范围见本操作说明
返回 类型 说明
result number 计算 a 除以 b;除数为零时报错

这里使用a、b。

调用效应:pure。

计算 a 除以 b;除数为零时报错。

完成后返回*[计算 a 除以 b;除数为零时报错](> host_math_div a=a b=b)*。

幂

参数 类型 默认 说明
a any 必填 第一个操作数;适用范围见本操作说明
b any 必填 第二个操作数;适用范围见本操作说明
返回 类型 说明
result number 计算 a 的 b 次幂

这里使用a、b。

调用效应:pure。

计算 a 的 b 次幂。

完成后返回*[计算 a 的 b 次幂](> host_math_pow a=a b=b)*。

负

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 对数字或符号值取负

这里使用value。

调用效应:pure。

对数字或符号值取负。

完成后返回*[对数字或符号值取负](> host_math_neg value=value)*。

正弦

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算正弦;数值角度使用弧度

这里使用value。

调用效应:pure。

计算正弦;数值角度使用弧度。

完成后返回*[计算正弦;数值角度使用弧度](> host_math_sin value=value)*。

余弦

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算余弦;数值角度使用弧度

这里使用value。

调用效应:pure。

计算余弦;数值角度使用弧度。

完成后返回*[计算余弦;数值角度使用弧度](> host_math_cos value=value)*。

正切

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算正切;数值角度使用弧度

这里使用value。

调用效应:pure。

计算正切;数值角度使用弧度。

完成后返回*[计算正切;数值角度使用弧度](> host_math_tan value=value)*。

反正弦

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算反正弦,结果为弧度

这里使用value。

调用效应:pure。

计算反正弦,结果为弧度。

完成后返回*[计算反正弦,结果为弧度](> host_math_asin value=value)*。

反余弦

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算反余弦,结果为弧度

这里使用value。

调用效应:pure。

计算反余弦,结果为弧度。

完成后返回*[计算反余弦,结果为弧度](> host_math_acos value=value)*。

反正切

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算反正切,结果为弧度

这里使用value。

调用效应:pure。

计算反正切,结果为弧度。

完成后返回*[计算反正切,结果为弧度](> host_math_atan value=value)*。

平方根

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算 value 的平方根

这里使用value。

调用效应:pure。

直接调用此函数:

marqdo call lib/数学.mq.md 平方根 value=9 --effects none --json

计算 value 的平方根。

完成后返回*[计算 value 的平方根](> host_math_sqrt value=value)*。

绝对值

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 返回绝对值

这里使用value。

调用效应:pure。

返回绝对值。

完成后返回*[返回绝对值](> host_math_abs value=value)*。

对数

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算自然对数

这里使用value。

调用效应:pure。

计算自然对数。

完成后返回*[计算自然对数](> host_math_ln value=value)*。

指数

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 计算自然指数函数

这里使用value。

调用效应:pure。

计算自然指数函数。

完成后返回*[计算自然指数函数](> host_math_exp value=value)*。

向下取整

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 向负无穷取整

这里使用value。

调用效应:pure。

向负无穷取整。

完成后返回*[向负无穷取整](> host_math_floor value=value)*。

向上取整

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 向正无穷取整

这里使用value。

调用效应:pure。

向正无穷取整。

完成后返回*[向正无穷取整](> host_math_ceil value=value)*。

最小

参数 类型 默认 说明
a any 必填 第一个操作数;适用范围见本操作说明
b any 必填 第二个操作数;适用范围见本操作说明
返回 类型 说明
result number 返回较小的操作数

这里使用a、b。

调用效应:pure。

返回较小的操作数。

完成后返回*[返回较小的操作数](> host_math_min a=a b=b)*。

最大

参数 类型 默认 说明
a any 必填 第一个操作数;适用范围见本操作说明
b any 必填 第二个操作数;适用范围见本操作说明
返回 类型 说明
result number 返回较大的操作数

这里使用a、b。

调用效应:pure。

返回较大的操作数。

完成后返回*[返回较大的操作数](> host_math_max a=a b=b)*。

随机

返回 类型 说明
result number 返回伪随机数;可用种子控制复现

调用效应:random.read。

返回伪随机数;可用种子控制复现。

完成后返回*返回伪随机数;可用种子控制复现*。

随机整数

参数 类型 默认 说明
min any 必填 下界,或搜索与绘图区间的起点
max any 必填 上界,或搜索与绘图区间的终点
返回 类型 说明
result number 在约定区间内返回伪随机整数

这里使用min、max。

调用效应:random.read。

在约定区间内返回伪随机整数。

完成后返回*[在约定区间内返回伪随机整数](> host_random_int min=min max=max)*。

设种子

参数 类型 默认 说明
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result any 设置本次运行的伪随机种子;不用于机密值

这里使用value。

调用效应:pure。

设置本次运行的伪随机种子;不用于机密值。

完成后返回*[设置本次运行的伪随机种子;不用于机密值](> host_seed value=value)*。

公式

参数 类型 默认 说明
text text 必填 调用方提供的文本
返回 类型 说明
result number 把表达式文本解析为符号公式,供后续代数运算或求值使用;语法无效时返回诊断

这里使用text。

调用效应:pure。

把表达式文本解析为符号公式,供后续代数运算或求值使用;语法无效时返回诊断。

完成后返回*[把表达式文本解析为符号公式,供后续代数运算或求值使用;语法无效时返回诊断](> host_formula value=text)*。

化简

参数 类型 默认 说明
formula any 必填 公式函数或前序符号运算返回的符号公式
返回 类型 说明
result number 返回化简后的公式并保留输入;这是符号代数运算,不是数值求值

这里使用formula。

调用效应:pure。

返回化简后的公式并保留输入;这是符号代数运算,不是数值求值。

完成后返回*[返回化简后的公式并保留输入;这是符号代数运算,不是数值求值](> host_simplify value=formula)*。

展开

参数 类型 默认 说明
formula any 必填 公式函数或前序符号运算返回的符号公式
返回 类型 说明
result number 展开代数乘积与幂,返回新的符号公式

这里使用formula。

调用效应:pure。

展开代数乘积与幂,返回新的符号公式。

完成后返回*[展开代数乘积与幂,返回新的符号公式](> host_expand value=formula)*。

求导

参数 类型 默认 说明
formula any 必填 公式函数或前序符号运算返回的符号公式
var any 必填 求导、代入、求值或求根所针对的符号名
返回 类型 说明
result number 对指定符号求导并返回符号导函数

这里使用formula、var。

调用效应:pure。

对指定符号求导并返回符号导函数。

完成后返回*[对指定符号求导并返回符号导函数](> host_diff formula=formula var=var)*。

代入

参数 类型 默认 说明
formula any 必填 公式函数或前序符号运算返回的符号公式
var any 必填 求导、代入、求值或求根所针对的符号名
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result number 用指定值替换公式中的符号;完全化简时返回数字,否则保留公式

这里使用formula、var、value。

调用效应:pure。

用指定值替换公式中的符号;完全化简时返回数字,否则保留公式。

完成后返回*[用指定值替换公式中的符号;完全化简时返回数字,否则保留公式](> host_subs formula=formula var=var value=value)*。

求值

参数 类型 默认 说明
formula any 必填 公式函数或前序符号运算返回的符号公式
var any 必填 求导、代入、求值或求根所针对的符号名
value any 必填 运行时值;具体规则见下方操作说明
返回 类型 说明
result any 在一个变量取指定数值时计算公式;仍有未绑定符号时返回诊断

这里使用formula、var、value。

调用效应:pure。

在一个变量取指定数值时计算公式;仍有未绑定符号时返回诊断。

完成后返回*[在一个变量取指定数值时计算公式;仍有未绑定符号时返回诊断](> host_eval formula=formula var=var value=value)*。

求解

参数 类型 默认 说明
formula any 必填 公式函数或前序符号运算返回的符号公式
var any 必填 求导、代入、求值或求根所针对的符号名
min any None 下界,或搜索与绘图区间的起点
max any None 上界,或搜索与绘图区间的终点
返回 类型 说明
result any 返回指定符号在上下界内的根列表;省略边界时使用 -100 到 100

这里使用formula、var、min=None、max=None。

调用效应:pure。

返回指定符号在上下界内的根列表;省略边界时使用 -100 到 100。

完成后返回*[返回指定符号在上下界内的根列表;省略边界时使用 -100 到 100](> host_solve formula=formula var=var min=min max=max)*。

绘图

参数 类型 默认 说明
formula any 必填 公式函数或前序符号运算返回的符号公式
var any 必填 求导、代入、求值或求根所针对的符号名
min any 必填 下界,或搜索与绘图区间的起点
max any 必填 上界,或搜索与绘图区间的终点
steps any None 绘图区间内的采样数量
path any None 相对已授权文件根目录的路径
derivative any None 是否在图中包含导函数
grid any None 是否绘制坐标网格
返回 类型 说明
result any 在区间内采样公式并返回 SVG 文本;指定路径时还会在授权根目录内写出 SVG

这里使用formula、var、min、max、steps=None、path=None、derivative=None、grid=None。

调用效应:output.write。

在区间内采样公式并返回 SVG 文本;指定路径时还会在授权根目录内写出 SVG。

完成后返回*[在区间内采样公式并返回 SVG 文本;指定路径时还会在授权根目录内写出 SVG](> host_plot formula=formula var=var min=min max=max steps=steps path=path derivative=derivative grid=grid)*。

绘点列

参数 类型 默认 说明
xs any 必填 本操作要求的输入列表或集合
ys any 必填 与 xs 一一对应的 Y 坐标列表
path any None 相对已授权文件根目录的路径
grid any None 是否绘制坐标网格
返回 类型 说明
result any 将一一对应的横纵坐标列表绘成 SVG 文本;两列长度不等时拒绝绘制

这里使用xs、ys、path=None、grid=None。

调用效应:output.write。

将一一对应的横纵坐标列表绘成 SVG 文本;两列长度不等时拒绝绘制。

完成后返回*[将一一对应的横纵坐标列表绘成 SVG 文本;两列长度不等时拒绝绘制](> host_plot_points xs=xs ys=ys path=path grid=grid)*。

绘圆锥

参数 类型 默认 说明
kind any 必填 圆锥曲线绘制函数接受的曲线类型
a any 必填 第一个操作数;适用范围见本操作说明
b any None 第二个操作数;适用范围见本操作说明
h any None 圆锥曲线中心的水平偏移
k any None 圆锥曲线中心的垂直偏移
path any None 相对已授权文件根目录的路径
grid any None 是否绘制坐标网格
返回 类型 说明
result any 按曲线类型、尺寸和中心偏移绘制圆锥曲线,返回 SVG 文本

这里使用kind、a、b=None、h=None、k=None、path=None、grid=None。

调用效应:output.write。

按曲线类型、尺寸和中心偏移绘制圆锥曲线,返回 SVG 文本。

完成后返回*[按曲线类型、尺寸和中心偏移绘制圆锥曲线,返回 SVG 文本](> host_plot_conic kind=kind a=a b=b h=h k=k path=path grid=grid)*。