Repository navigation
Releases
LoopTrial 0.1.0 · 可复核的 CLI / MCP 设备实验
LoopTrial 0.1.0 让工程师和已有的 Agent 采集波形、调整参数、比较实验。可以从内置模拟器入手,也可以连接已适配的硬件。中文快速开始
LoopTrial provides a CLI and a local MCP server for embedded measurement, sensor calibration, and controller tuning. Start with a simulator or connect supported firmware over USB serial or BLE GATT. English quick start
下载 / Downloads
| 用途 / Use | 附件 / Asset |
|---|---|
| 安装主机工具 / Install the host tools | Python wheel |
| STM32F103C8T6 示例固件 / Blue Pill firmware | BIN · ELF |
| 从源码构建 / Build from source | Source distribution · Build guide |
| 实验记录与校验 / Records and checksums | Experiment data · SHA-256 |
Windows x64 · CPython 3.12.10 · GPL-3.0-or-later · Release source at b600f84
安装与第一次实验
下载本页的 wheel,在该目录打开 PowerShell:
py -3.12 -m venv .venv
.\.venv\Scripts\python -m pip install .\looptrial-0.1.0-py3-none-any.whl
$env:PATH = "$PWD\.venv\Scripts;$env:PATH"
$env:LOOPTRIAL_HOME = "$PWD\lab"
$r = looptrial run sim://thermal step --condition target_c=50 | ConvertFrom-Json
looptrial review $r.id
looptrial-client默认基线采到 361 个点,到达 95% 温升用时 60 s。looptrial resources 可找到随包安装的中文指南、完整案例、现有协议适配示例和 MCP 配置。
验收记录与已知限制 / Validation and limitations
正式包上的 Agent 实验
| 对话和工况 | 实际结果 |
|---|---|
| 前文给 50 °C,末轮只说“升温太慢,帮我调快一点。” | Agent 测得基线 60 s,自定目标 ≤48 s。首个候选 50 s,继续调参后达到 41.5 s;两次新冷启动均为 41.5 s,并通过超调与尾段误差约束。最后一次编号 ca646d21661d488dbe10989dafa2dc98。实际对话与工具调用 |
| 前文改为 62 °C,同一句症状 | 实际阶跃目标随之改为 62 °C。第一次候选 53.5 s,下一组 38.5 s,两次独立确认通过。 |
| 跟踪台阶的传感器读数抖 | Agent 将 α 从 1 改为 .16,同输入静止噪声从 .930 降到 .284 kPa,再以两个新噪声种子确认噪声和响应延迟。 |
| 轮速目标 150 rpm,驱动限幅 45% | 稳态速度 66.6 rpm,输出在 1.52–8.00 s 持续饱和。Agent 结束增益搜索,保留并回读原参数。编号 4684d4b7fb84464b81e2014a33760fcb。停止依据与工具调用 |
下载 looptrial-evidence-0.1.0.zip,解压查看 final-agent/ 的最终包对话、数据与回读。每个编号目录内的 record.json、samples.csv、plot.svg 可单独复制,并用 looptrial review <目录> 离线复核。候选包的完整对照还覆盖相同 50 °C 工况增加热延迟、采集中断后恢复配置和独立第三参考点标定。跨工况实验索引
Blue Pill 与发布复核
USB 转串口与 BD-BT26 GATT 各自完成板卡握手、参数写入和回读、基线、候选及独立复测。相同板内软件阶跃在 0.320 s 的末点误差由 14.166 降至 0.001 count。两路也交叉读回了对方写入的值。原固件已恢复,65,536 字节全片读回与烧录前备份 SHA-256 一致。此处实物证据覆盖软件对象和通信链路。外部热体、电机、传感器、两轮车的物理性能尚待验证。板卡别名和 MCU 在启动应答丢失时复位的处理通过主机运行同一 C 协议的故障回归复核。台架报告
固定提交干净构建,41 项回归通过。从本页源码分发包再次生成的 wheel、BIN、ELF 与发布附件字节一致。另在仓库外新环境按 README 安装实际 wheel,跑通 CLI、独立 MCP、已安装示例和离线复核。55 份随包历史记录通过检查,包含一份预期的中断记录。版本、附件指纹和包外实验编号见 SHA256SUMS.txt、release-audit.json。安装依赖需联网,运行内置模拟器无需模型账号。板上 RAM 参数随复位还原。
源码与构建 · CLI/MCP 使用 · 已有工程接入 · 第三方许可