Files
marqdo/examples/oa2026-showcase/foreign-node.mq.md

7.5 KiB

markup, title, import
markup title import
occlusion 原生订单分析与 Node Intl 展示边界
native foreign table result
../foreign-native-report/index.mq.md lib/foreign.mq.md lib/table.mq.md lib/result.mq.md

订单分析应先使用已经具备的原生能力。只有本地化货币展示交给 Node Intl;一次性执行和持久会话都是明确的外联边界,文件操作与通用数据处理不需要 Python 或外部读取器。

从仓库根目录调用:marqdo call examples/oa2026-showcase/foreign-node.mq.md main --require-ok --effects process.exec --fs-root . --json。只需原生分析时,可直接 call 共享模块的 analyze_orders,不需要任何进程授权。

main

返回 类型 说明
result map Result:前后两份原生分析、实际排序结果与一次性/持久格式化结果

成功时 value 的字段如下。先检查最外层 ok,再按字段读取;这里列出的数据都是本轮实际计算或执行得到的值。

value 中的字段 值的形态 直接含义
before 原生分析记录 五笔订单的总额 870、数量 5、平均值 174 与按区域保留的统计行
after 原生分析记录 追加八十元订单后,总额 950、数量 6、平均值约 158.3333;不做展示舍入
initial_ranking 原生行记录列表 首轮按区域总额降序排列;每行保留区域、数量、总额、均值与标准化跨度
updated_ranking 原生行记录列表 更新后的区域总额依次为 420、300、230;排序返回新列表
one_shot 两个展示文本字段 一次性进程返回的 total 与 average,只表示首轮报告的本地化展示
persistent_initial 两个展示文本字段 持久格式器对同一首轮报告得到的 total 与 average,可与一次性结果核对
persistent_updated 两个展示文本字段 持久格式器展示更新后的报告;950.00 与 158.33 是展示文本,不覆盖原生数值

本例先处理五笔订单:总额为八百七十,随后追加一笔华北的八十元订单,总额变为九百五十。分组、计数、平均值、追加和按区域总额排序全部使用 Marqdo 固有能力;不再在 Node 中维护另一份订单分析程序。共享模块中的 analyze_orders 是唯一的分析实现,其参数与字段表可以直接阅读和调用。

外联只承担确实缺失的本地化展示。第一次通过本文件的 format_once 演示标准输入上的 JSON 往返;两次共享 format_summary 分别展示原生修改前后的结果。每次共享调用都在同一内核内建立格式器、复用它格式化平均值并关闭资源,实际生命周期写在对应函数中,而不是把一个句柄藏进跨命令的 JSON 字符串。

总额排序也保留在原生流程中:先按 total 升序,再反转得到降序记录。排序不会改变原始订单或报告,每个返回行仍包含区域、订单数和总额。追加发生在 Marqdo 集合中,随后将重新计算出的值拷贝给展示边界,避免外部内核与原生数据各保留一份会悄悄分叉的业务状态。

调用需要 process.exec 和 Node,不读写用户文件,也不安装包。先检查共享格式化任务的 ok,再使用 value;一次性 JSON 协议失败则保留原生诊断。成功结果携带真正的原生数据和展示字符串,既能继续被其他函数使用,也能核对展示没有替代数值计算。查看返回结果比只读一条“完成”打印更能证明这一轮执行发生了什么。

订单 =

@ 区域 金额
1 华东 120
2 华东 300
3 华南 90
4 华南 140
5 华北 220

We before = [在原生标准库中完成首轮订单分析](native.analyze_orders(orders=订单, region_key="区域", amount_key="金额")) and initial_ranking = 保留首轮按区域总额降序的原生行记录, key="total"))) and one_shot = 只把首轮报告的展示交给一次性进程 and initial = [用共享持久内核流程展示同一份原生结果](native.format_summary(report=before, locale="zh-CN"))。

  1. not access(initial, "ok") 返回initial,保留真实运行失败。

追加 =

区域 金额
华北 80

We orders = [在原生集合中追加新订单](table.append(list=订单, item=追加)) and after = [用同一份原生实现重新计算完整报告](native.analyze_orders(orders=orders, region_key="区域", amount_key="金额")) and updated_ranking = 在原生集合中保留更新后的降序记录, key="total"))) and updated = [把更新后的原生结果交给展示边界](native.format_summary(report=after, locale="zh-CN"))。

  1. not access(updated, "ok") 返回updated,保留持久内核的失败出口。 We persistent_initial = 保留首轮实际格式化文本) and persistent_updated = 保留更新后的实际展示文本)。

观察 =

before after initial_ranking updated_ranking one_shot persistent_initial persistent_updated
before after initial_ranking updated_ranking one_shot persistent_initial persistent_updated

完成原生分析与明确的展示外联后,我们返回*本次实际观察到的数据与结果*。

format_once

参数 类型 默认 说明
report map required 原生分析结果,包含 total 与 average 数值
locale text "zh-CN" Node Intl 使用的展示语言区域
返回 类型 说明
result map 直接返回 total/average 本地化文本;子进程或 JSON 失败保留原生诊断

使用 report 和 locale="zh-CN" 补足本地化货币展示。一次性外联只接收已经计算好的总额与平均值,不分组、不排序、不修改订单。传入数据由 Marqdo 的 input 通道编码为 JSON;Node 从标准输入流接收它,不读取任何路径,也不额外生成文件。

代码围栏明确写出进程如何消费输入、建立 Intl 格式器以及输出唯一的 JSON 记录。标准输出只承载这个协议值,诊断保留在错误通道;混入其他打印会导致 JSON 解析失败,而不是被当作部分成功。这里选择人民币展示,不声称进行汇率换算或货币精度计算。

调用需要 process.exec 与已安装的 Node,超时为五秒。foreign.call 在进程失败或输出不是合法 JSON 时给出原生诊断,因此本函数的成功值就是格式化记录,不再套一个假造的通过标记。这个一次性子进程结束后没有可复用状态;持久会话的创建、两次求值和关闭由共享原生报表手册中的 format_summary 展示。

输入 =

report locale
report locale

格式化代码 =

let raw = "";
process.stdin.setEncoding("utf8");
process.stdin.on("data", chunk => { raw += chunk; });
process.stdin.on("end", () => {
  const input = JSON.parse(raw);
  const money = new Intl.NumberFormat(input.locale, {style: "currency", currency: "CNY"});
  console.log(JSON.stringify({total: money.format(input.report.total), average: money.format(input.report.average)}));
});

接收完整输入后,我们返回*[执行有界的一次性展示边界并解析真实 JSON 返回](foreign.call(code=格式化代码, input=输入, timeout=5))*。