phyphox 文件格式与 XML 结构

文件是什么

phyphox 的自定义实验文件后缀是 .phyphox，但它本质上是一个 ZIP 压缩包。把后缀改成 .zip 就能解压出来看里面的内容：

my-experiment.phyphox (改名为 .zip)
├── content.xml          # 实验定义（必选）
├── description.html     # 实验说明（可选）
├── icon.png             # 实验图标（可选）
└── ...其他资源

XML 结构

content.xml 是核心，它定义了实验的全部逻辑。大致结构：

<phyphox>
  <experiments>
    <experiment>
      <title>我的自定义实验</title>
      <category>mechanics</category>
      <controls>
        <input logical="true">...数据源...</input>
        <input logical="false">...数据源...</input>
      </controls>
      <analysis>
        <input ... />
        <calculate ... />
        <buffer ... />
        <output ... />
      </analysis>
      <views>
        <graph>...图表定义...</graph>
      </views>
      <export>
        <csv>...导出设置...</csv>
      </export>
    </experiment>
  </experiments>
</phyphox>

关键元素

元素	作用
`<input>`	数据源配置——指定用哪个传感器、采样率、坐标
`<calculate>`	数学运算——加减乘除、积分、微分、FFT、统计量
`<buffer>`	缓冲区——存数据、设容量上限
`<graph>`	图表——X/Y 轴分别绑定哪个 buffer，图表类型
`<export>`	导出设置——哪些 buffer 导出、文件名模板
`<button>`	按钮——绑定一个操作（清数据、暂停、重置）

手动编辑 vs 编辑器

什么时候手动编辑 XML：

想做编辑器里还没有的运算（比如自己写一个自定义滤波函数）
批量修改参数（用脚本把 100 个实验的采样率从 100Hz 改成 200Hz）
做版本控制（XML 是纯文本，可以用 git diff 比较变化）

什么时候用编辑器：

大多数情况——拖拽连接比写 XML 直观得多，不容易出错
快速原型——先拼一个能跑的版本，再手动优化

学习资源

phyphox Wiki 上有完整的文件格式文档和 XML 标签参考。另外，所有内置实验的 phyphox 文件都可以在 phyphox 官方站点下载、用编辑器打开——这是最好的参考素材。