脚本 Script

住在一个 Canvas 节点里的有界全性脚本语言:对接线上游的任何产出书写自定义因子、指标与信号。let / if / 有界 for 加 22 个内建函数——小到一个下午学会,有界到一眼可审。

**完整语言参考在专页:Xlang — 公式语言。**本卡讲节点契约与治理。

一句话

Layer-1 粘合剂节点:把任意上游节点的数值输出当作具名 series/number 输入消费,求值用户自著脚本,产出 value / series / signal,溯源完整(脚本源码 + SHA-256 + 版本 + 步数)。

节点契约

参数

• script(必填)——Xlang 脚本;至少声明一个 output。
• input_map(可选)——一行一个输入:name = upstream[N].路径 | 路径 | 字面量;支持 # 注释;N 从 0 起。未映射的输入自动绑定。

绑定——序列输入按声明序绑定接线上游(第一个 input …: series → 第一个能给出可用序列的上游);数字输入按自己的名字在各上游查找。多序列按尾部对齐到最短;截除量记录并在卡上明示。

输出——value(Monitor 探针标量)、series(作图)、signal(标签),外加 meta:steps、eval_ms、xlang_version、script、script_sha256、input_bindings、alignment。

保证

• 构造性有界:无 while、无递归、无 IO、无随机数、无时钟——解析期拒绝并附教学式提示。
• 硬上限:5,000,000 步 · 20,000 点序列 · 200,000 分配元素 · 2 秒墙钟。超限诚实报错,点名上限。
• 确定性:同脚本+同输入=同输出,永真。
• 孪生纪律:浏览器试跑与服务器夜批用同一份求值器字节,校验和测试锁定。
• 诚实失败:失败脚本在卡上显示行列+源码;夜批读数记 nodata+原因,绝不沿用昨值。

歧伯语言台

歧伯可从一句话起草脚本,也可白话解读现成脚本。草稿先过服务端验证(解析+合成输入试跑)才呈现;未过验证的草稿永不出现;采用须用户明确操作。

Golden 测试

tests/golden/fixtures/tier2/xlang_evaluator/——30 个规范用例对照独立 NumPy 参考(容差 1e-9 绝对、1e-12 相对),含语言页三个完整示例;另与平台指标算子交叉对账(sma 全序列 1e-9、ema 尾部 1e-6 且种子口径差入档、corr 5e-5),并有覆盖守卫断言 22 个内建全部被行使。截至 2026-07-31 通过。

变更记录

• 1.0.0(2026-07-31)——首发:求值器孪生、22 内建、引擎+Canvas 双道执行、绑定/对齐、歧伯起草/解读台、golden 套件。