Release 2.7.0: executable handbooks and native user-site workflows

This commit is contained in:
cflmy committed 2026-11-10 17:03:06 +08:00
1 parent aa0c4d0f55
commit d9aef957f7
562 files changed
+21064 -20387

No files matched your search

@@ -8,25 +8,45 @@ import:
# 订单定价
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 供下述方法复用的对象或类型命名空间;直接调用所需的子函数。 |
按订单行取未税金额与品类,套用税率后汇总含税总额。
## 含税价
`行`
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 行 | any | 必填 | 订单行记录;按相邻数据表提供金额、品类等字段 |
**金额 = [订单行金额](access(行, "金额"))**
**品类 = [订单行品类](access(行, "品类"))**
**税率 = > tax.标准税率.查询 品类=`品类`**
**结果 = [本行含税价](金额 * (1 + 税率))**
*结果*
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 本次计算得到的结果 |
输入`行`,按下方步骤使用这个值。
我们先**金额 = [订单行金额](access(`行`, "金额"))**,供下一步使用。
我们先**品类 = [订单行品类](access(`行`, "品类"))**,供下一步使用。
我们先**税率 = [计算并保存 税率](tax.标准税率.查询(品类=`品类`))**,供下一步使用。
我们先**结果 = [本行含税价]((`金额` * (1 + `税率`)))**,供下一步使用。
完成上述步骤后,返回*结果*。
## 含税总额
`订单`
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 订单 | any | 必填 | 包含行记录集合的订单数据;税率与金额字段由本示例约定 |
**行列表 = [订单行列表](access(订单, "行"))**
`总额` = 0
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 逐行累加得到的订单总额 |
输入`订单`,按下方步骤使用这个值。
我们先**行列表 = [订单行列表](access(`订单`, "行"))**,供下一步使用。
我们先**总额 = 0**,供下一步使用。
- [逐个订单行](遍历 行列表 为 行)
**行含税价 = > 订单定价.含税价 行=`行`**
**总额 = [累加](总额 + 行含税价)**
*总额*
我们先**行含税价 = [计算并保存 行含税价](订单定价.含税价(行=`行`))**,供下一步使用。
我们先**总额 = [累加]((`总额` + `行含税价`))**,供下一步使用。
完成上述步骤后,返回*总额*。
@@ -9,11 +9,15 @@ import:
# main
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | None; execute this page's documented steps in order and observe their output or stated effects |
发票回答:演示订单一行图书,未税金额 100。
`订单` = > json.parse text={"行":[{"金额":100,"品类":"书"}]}
**总额 = > pricing.订单定价.含税总额 订单=`订单`**
We first **订单 = [Compute 订单](json.parse(text="{\"行\":[{\"金额\":100,\"品类\":\"书\"}]}"))** for the next step.
We first **总额 = [Compute 总额](pricing.订单定价.含税总额(订单=`订单`))** for the next step.
这张订单的含税总额是[含税总价](总额)。
> print text=`总额`
We now **[Display this step's result](> print text=`总额`)**.
@@ -7,8 +7,16 @@ title: 折扣不适用于退款
# 折扣不适用于退款
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Object/type namespace for the child functions below; call the intended child directly |
负知识:退款结算不得套用会员折扣。Agent 复用折扣能力时应拒绝该适用面。
## 说明
*[不适用](false)*
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | The value explicitly returned below; conditional returns follow the selected branch |
After these steps, return *[不适用](`false`)*.
@@ -11,10 +11,18 @@ applicability:
# 标准税率
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Object/type namespace for the child functions below; call the intended child directly |
当前政策下的标准增值税率。`品类` 预留给差异化税率;本演示固定返回标准税率。
## 查询
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | The value explicitly returned below; conditional returns follow the selected branch |
`品类`
*[标准税率](0.13)*
After these steps, return *[标准税率](0.13)*.
@@ -8,11 +8,20 @@ type: Schema
| 字段 | 类型 | 说明 |
|---|---|---|
| 行 | list<订单行> | 待计价的订单行 |
| 行 | list | 待计价的订单行;每一项遵守下方独立对象的字段契约 |
## 订单行
订单只收拢本次计算需要的行记录,不替调用方补缺失金额或品类。
每一行使用同一金额单位,税率知识由能力模块选择;此处只描述数据形态。
# 订单行
| 字段 | 类型 | 说明 |
|---|---|---|
| 金额 | number | 未税金额 |
| 品类 | text | 用于选择税率 |
订单行是独立的顶层对象类型,因此订单中的列表元素可以引用它。
字段表紧接对象标题,避免将类型声明误写成具有参数和返回值的普通函数。
行字段的运行时契约约束列表本身;元素形态按订单行的字段说明提供,
不把尚未支持的泛型类型拼写当成已经执行的逐元素校验。