ykcheungab 11962cdc34 配置没写的滤波键等于"关"，不再回落到会滤波的默认值 - What: DEFAULT_FORCE_MEDIAN_WINDOW 3 -> 1、DEFAULT_FLOW_EMA_ALPHA 0.5 -> 1.0（DEFAULT_FORCE_LOWPASS_HZ 本就是 0.0），并把注释改成"配置文件没写的键就是关，而不是我们觉得合理的那一档"——原因写在注释里：否则设备会去滤一个没人要求滤的测量，而文件里没有任何线索；实测的延迟/降噪数据保留在注释中，作为 balanced/low_noise 预设的依据。docs/filters.md 第 2 节增加"缺省 = 关"这一条并说明没有 filters 段的配置什么都不滤，预设表里 balanced 的用途由"默认建议"改为"建议起步档"（它不再是默认值）。examples/filters/README.md 补一句"整段删掉等价于 off"。tests/test_filter_presets.py 新增 test_a_config_with_no_filters_block_filters_nothing：把 box bundle 的 filters 段整段删掉后构造真实 Sensor，断言 filters_state() 报 ema 1.0 / median 1 / cutoff 0.0 且 any_stage_applied 为 False。 - Why: 上一版只把"非法值"改成回落到关，但"键根本不写"仍会走 DEFAULT_* 从而把 EMA 0.5 + 中值 3 打开——这与"配置自描述、文件说什么就跑什么、出厂默认全关"矛盾，且现实里存在大量没有 filters 段的手写配置（例如 _perf/cfg_res_280x300.json），它们会在无人察觉的情况下继续滤波。缺省开是这条链上最后一个隐藏默认值。 - Verification: 删掉 filters 段后实测 filters_state() = (1.0, 1, 0.0) 且 any_stage_applied=False，出厂 box/mini/finger 三份同样为全关；pytest tests/test_filter_presets.py + tests/test_calibration.py → 33 passed；SDK 全量 336 passed / 15 skipped（唯一失败仍是需要 1200 帧而样例只有 577 帧的 longrun 测试）；app 侧 studio 85 项与 shared 142 项测试、ui_check 554 项检查在升级后的 0.5.2 下全绿。 - Not in this change: 出厂 bundle 的三个显式值未动（本来就全关）；_perf 的两个校验脚本不在仓库内，已就地补上显式 filters 段（balanced）以保持"开 vs 关"对照仍有意义；app 侧 wrapper/齿轮/CSV 17 列未动。

2026-09-14 10:53:33 +08:00

..

conftest.py

faster linux build

2026-09-12 16:36:59 +08:00

dd06.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

DIS_no_integrate.py

test if optical flow integration error: not significant for Mems

2026-09-01 21:27:10 +08:00

note.txt

update test and build scripts

2026-03-09 13:33:18 +08:00

test_backends.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_calibration.py

标定指纹改读生效值并按测量/读数分组 - What: calibration.py 新增 FILTER_MEASUREMENT_KEYS（flow_ema_alpha）与 FILTER_READOUT_KEYS（中值窗口、低通截止/阶数/采样率/rate_auto）、filters_fingerprint()（把 Sensor.filters_state() 归一化成 {measurement, readout, preset, source}：非法值丢弃、来源没写的键不出现而不是补默认、空映射返回 {} 表示"无记录"）、filter_mismatches()（按组判读差异）与 _filters_from_config / _flat_filters_from（扁平旧格式与 preset 展开的兼容解析，显式键优先）；pipeline_from_sensor_json() 新增 filters_state= 关键字——传了生效值就用生效值，否则读文件的 filters 段并标注 source="sensor.json.filters"，返回结构化 filters 键，删除原先会凭空补出 0.5/3/10 的扁平键与 enabled 覆盖逻辑；Calibration.to_dict() 写 meta.filters（同时保留扁平键供旧读者按名取用）；parse() 把 filters 读回 pipeline（此前 to_dict 写进 meta 的滤波键在读回时被整段丢弃，指纹实际是"只写不读"）；check() 改用 filter_mismatches 分开报告——measurement 组差异进 warnings 且措辞含 not comparable，readout 组差异进新增字段 CheckResult.notes（只记录、不拦截）；build(extra_meta=…) 把 filters 与扁平滤波键折进结构化组。tests/test_calibration.py 新增 11 项测试（分组、preset 展开与显式键优先、enabled:false 全关、非法值为空而非默认、写入-读回往返、旧扁平文档读回、生效值压过文件、四个预设逐档核对）。docs/filters.md 新增第 7 节。 - Why: 用户决策 B 要求"Sensor.filters_state() 作为唯一生效值出口，calibration.py 指纹与 session.json 都读它、不读配置文件，指纹分 measurement/readout 两组"；动手时确认旧实现三个问题叠加：来源错（读文件、被 filters.enabled 覆盖、文件没写就补默认 0.5/3/10），写进 meta 的指纹在读回时被丢弃，check() 因此永远比不出滤波差异——审计链是断的，不是不精确。 - Verification: SDK 全量 pytest 335 passed / 15 skipped，唯一失败 test_vnormal_longrun_no_outlier_jumps 需要 1200 帧而 data/sample/s1_480p.mp4 只有 577 帧（环境/数据，与本改动无关）；external-frame 模式逐预设构造真实 Sensor，filters_fingerprint(filters_state()) 得 off(1.0,1,0.0) / low_latency(1.0,3,0.0) / balanced(0.5,3,0.0) / low_noise(0.3,3,10.0)；写入→读回往返后 measurement/readout/preset 完整保留且 to_dict 幂等；旧扁平 meta 文档仍读回同一指纹；.repro/verify_cal_filters.py 50 项全绿。 - Not in this change: 未动 app（app 的 meta_from_sensor_json 只取 4 个键，不受影响）；未升级 venv 内 SDK；examples/filters 的四个机器可读预设片段与 app 侧 wrapper/齿轮/CSV 17 列未动。

2026-09-14 10:43:58 +08:00

test_capture.py

hotfix/camera not connected error

2026-09-02 21:37:40 +08:00

test_contact_arrow_scale.py

1. tuned arrow mesh drawing

2026-06-19 14:28:28 +08:00

test_draw_arrows.py

added 5 sensors multi-stream support, 5 finger reach > 100 fps stable using .mp4 video

2026-09-13 12:18:27 +08:00

test_errors_and_cleanup.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_export_sensor_bundle.py

added calibration data handling functions

2026-09-10 21:47:36 +08:00

test_export.py

added 5 sensors multi-stream support, 5 finger reach > 100 fps stable using .mp4 video

2026-09-13 12:18:27 +08:00

test_ffc.py

Update FFC files

2026-07-02 16:53:08 +08:00

test_filter_presets.py

配置没写的滤波键等于"关"，不再回落到会滤波的默认值 - What: DEFAULT_FORCE_MEDIAN_WINDOW 3 -> 1、DEFAULT_FLOW_EMA_ALPHA 0.5 -> 1.0（DEFAULT_FORCE_LOWPASS_HZ 本就是 0.0），并把注释改成"配置文件没写的键就是关，而不是我们觉得合理的那一档"——原因写在注释里：否则设备会去滤一个没人要求滤的测量，而文件里没有任何线索；实测的延迟/降噪数据保留在注释中，作为 balanced/low_noise 预设的依据。docs/filters.md 第 2 节增加"缺省 = 关"这一条并说明没有 filters 段的配置什么都不滤，预设表里 balanced 的用途由"默认建议"改为"建议起步档"（它不再是默认值）。examples/filters/README.md 补一句"整段删掉等价于 off"。tests/test_filter_presets.py 新增 test_a_config_with_no_filters_block_filters_nothing：把 box bundle 的 filters 段整段删掉后构造真实 Sensor，断言 filters_state() 报 ema 1.0 / median 1 / cutoff 0.0 且 any_stage_applied 为 False。 - Why: 上一版只把"非法值"改成回落到关，但"键根本不写"仍会走 DEFAULT_* 从而把 EMA 0.5 + 中值 3 打开——这与"配置自描述、文件说什么就跑什么、出厂默认全关"矛盾，且现实里存在大量没有 filters 段的手写配置（例如 _perf/cfg_res_280x300.json），它们会在无人察觉的情况下继续滤波。缺省开是这条链上最后一个隐藏默认值。 - Verification: 删掉 filters 段后实测 filters_state() = (1.0, 1, 0.0) 且 any_stage_applied=False，出厂 box/mini/finger 三份同样为全关；pytest tests/test_filter_presets.py + tests/test_calibration.py → 33 passed；SDK 全量 336 passed / 15 skipped（唯一失败仍是需要 1200 帧而样例只有 577 帧的 longrun 测试）；app 侧 studio 85 项与 shared 142 项测试、ui_check 554 项检查在升级后的 0.5.2 下全绿。 - Not in this change: 出厂 bundle 的三个显式值未动（本来就全关）；_perf 的两个校验脚本不在仓库内，已就地补上显式 filters 段（balanced）以保持"开 vs 关"对照仍有意义；app 侧 wrapper/齿轮/CSV 17 列未动。

2026-09-14 10:53:33 +08:00

test_finger_runtime.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_harness_guards.py

faster linux build

2026-09-12 16:36:59 +08:00

test_longrun_stability.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_masked_hhd.py

added preflight check

2026-09-12 15:49:28 +08:00

test_masked_poisson_capfft.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_nuitka_nofollow.py

faster linux build

2026-09-12 16:36:59 +08:00

test_pipeline.py

added 5 sensors multi-stream support, 5 finger reach > 100 fps stable using .mp4 video

2026-09-13 12:18:27 +08:00

test_pyproject.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_qt_viewer_backend.py

included low pass filter in package and add to plot_data example

2026-08-17 22:11:17 +08:00

test_release_auth.py

fixed testpypi upload

2026-09-12 17:34:46 +08:00

test_release_publish.py

fix pypi cannot check after upload

2026-09-12 17:43:40 +08:00

test_release_version.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_signal_processing.py

added calibration data handling functions

2026-09-10 21:47:36 +08:00

test_smoke_api.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_stitch.py

refractor stitcher class into module

2026-08-23 16:24:53 +08:00

test_uv_geometry.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_uv_mesh_viewer.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_uv_remap.py

integrated finger process pipeline on remapped 2d image

2026-06-14 17:48:30 +08:00

test_uv_unroll_processor.py

dd02 setting tune + change Class name from UVUnrollFrameProcessor to FrameUnwarper

2026-07-14 20:00:40 +08:00

test_wheel_build.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_wheel_contents.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_wheel_setup_metadata.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00