版本说明

开源（2026 年 10 月）

RodentFlow 1.3 的源代码和本手册以 MIT 许可证发布在 github.com/seesaw-earth/RodentFlow，见开源与构建。

1.3：简体中文

整个 App 支持英文和简体中文：界面、实验范式和指标名称、定义、方法说明、质量提示、统计描述、图表和文字摘要。App 跟随 iPhone 系统语言。Aa › Language / 语言 会打开单独为 RodentFlow 选择语言的设置。
保存的数据与语言无关：结果文件、JSON 键名、实验范式 ID、阶段和 CSV 模板列名都保持英文，所以文件可以在不同语言设置的手机之间自由使用。
导入时接受中文列名（编号、组别、性别、天、试次、阶段、日期、备注）；App 以中文运行时，也接受 App 中显示的中文指标名称。
导入预览会列出每一个已识别的列。

1.2.1：更流畅

选择视频、打开预览、完成分析和切换标签页时不再卡顿。复制视频、写入结果文件和读取检查点都移出了主线程，进度更新只重绘有变化的部分。

1.2：更易用

文字更大，且可调整（Aa：从“小”到“最大”，或跟随 iPhone）。
每个流程界面都有步骤条（开始 → 设置 → 预览 → 结果）和上一步 / 下一步底部栏。
生成预览后如果又改了设置，会提醒更新预览。
批量打分：下一只动物 保留实验范式、组别、阶段和天数；使用上次设置 沿用场地、校准和设置。
同一范式的结果之间可以用 ▲▼ 切换，任何结果都可以直接 在组间分析中比较。
组间分析有快捷分区标签，设置页有分区菜单。

1.1.1：追踪精度

借助已知真实值的合成视频发现并修复的问题：

读取帧时使用完整的 0–255 灰度范围，与背景一致。藏在有盖暗箱里的小鼠不再被误“检测到”。
背景静止动物修补：消除动物长时间停在一处留下的“幽灵”。
按对比度加权的质心：位置误差中位数从约 1 cm 降到 0.15–0.5 cm，迷宫中的路径长度也不再明显偏高。
运动指数的像素阈值从 12 提高到 20 个灰度级，压缩造成的闪烁不再把僵直片段切碎。
物体交互半径和 Barnes 洞区半径的默认值从 6 cm 改为 8 cm（以身体中心近似）。

1.1：从追踪到组间统计

两个标签页：实验（每只动物的结果）和 组间分析（组间比较）。
15 种实验范式和自定义表格，数据可来自视频、手动录入或 CSV/JSON 导入。
十字迷宫校准；物体、平台和目标洞标记；用于僵直的运动指数。
区域和阈值在分析后可修改，无需重新追踪即可重算。
根据实验设计选择统计方法，图表显示每只动物，可导出 PNG 和 JSON。

1.0

以 10 Hz 对旷场（矩形或圆形）、T 迷宫和 Y 迷宫视频做经典质心追踪，支持预览、完整分析、可恢复的检查点和 JSON 导出。