# MoonTouchstone：可追溯的RF网络变换与频段检查

2026-09-27 实质补证：已处理 Johanson 厂家公开 S2P（1551频点），与 scikit-rf/NumPy 核对全部复数值、频段限值，并根据数据表需要新增 MoonBit 峰峰插损判定。[下载、SHA-256、结果和限制](docs/PUBLIC-SAMPLE.md)。当前本地0.2.0，拟作为象棋旧题的替换候选；不是已获准换题。

## 谁会用，解决什么问题

用MoonBit开发测量文件导入、夹具数据处理或元件筛选工具的开发者。
目标任务：导入Touchstone，按适用条件进行阻抗变换、级联或去嵌入，再对指定频段的采样点计算插损、回损等指标，输出超限位置或无法判定的原因。

S/Y/Z/H/G、参考阻抗、矩阵顺序和采样覆盖都会改变物理解释；空频段不能判通过，奇异变换不能靠扰动假装成功。

## 为什么不只是换一种语言重写解析器

核心是复数矩阵和RF网络运算，不是固定告警文案表。频段、端口、上下限由调用方提供；频段检查复用同一Network接口，不绑定某个元件型号。

已有替代：[scikit-rf](https://scikit-rf.readthedocs.io/en/latest/tutorials/Networks.html)。已有Python RF工作流继续用scikit-rf更合适。本库适合MoonBit内的有限网络运算与检查，不在运行时调用scikit-rf；没有全套仪器、校准或性能优势声明。
“可以用MoonBit实现”不是需求证明；价值成立的前提是调用方确实需要在MoonBit程序内复用这些处理能力。

## 评审可直接运行的证据

在仓库根目录运行（无需Python参考工具）：

```sh
moon run examples/band_check --target js
moon run examples/band_check --target wasm-gc
```

预期：纯MoonBit示例故意让一条回波损耗要求不通过，报告原始频点1、2；fail是有效结果，不是程序崩溃。文件示例的三条规则则通过。
这是合成数据的可复现示范，不是客户案例。
处理自己的真实文件见[完整工作流](docs/BANDS.md)；[公共API](pkg.generated.mbti)供其他MoonBit项目导入。
独立数值/互操作验证入口：[tools/verify-bands.py](tools/verify-bands.py)；已有回执：[检查记录](evidence/bands-20260922.json)。
测试数量仅表示覆盖，不能代替实用价值或用户需求证明。

## 通用性与不能承诺的内容

1–32端口和正实参考阻抗等声明范围；只检查离散采样点，不作连续频带、全频因果性或设备合格认证。
没有仪器接入/客户筛选效果证明，不能把合成衰减器说成量产验证。
本项目不声称“生态首个/唯一/此前没有任何实现”；公开搜索也不能证明不存在同类项目。
所有比较限于可核验功能和部署条件；发现MoonBit同类项目时应逐项比较API/语义/边界，不以语言名或包装差异算独立价值。

## 交付状态

本地实现、可运行示例和独立参考证据与公开发布是两回事。
模块命名空间为 guolei-dev/touchstone，与公开仓库及 Mooncakes 账号一致。
仓库可匿名克隆、默认分支内容、对应SHA的CI和正式链接需在提交时核对；不能用个人主页或历史截图代替。