From d5b938738ecc6d22ba5d931ae1a1bf96dde93b3c Mon Sep 17 00:00:00 2001 From: ykcheungab Date: Sun, 27 Sep 2026 21:14:20 +0800 Subject: [PATCH] docs: point perf references at the workspace docs tree; ignore .scratch/ orisys-sdk-perf-plan.md moved to D:\orisys_ws\docs\performance\ as part of the 2026-09-27 workspace cleanup. docs/filters.md and examples/filters/README.md now name the new location; the _perf/ measurement scripts they also cited are deleted (the document keeps every measured number). Also ignore .scratch/, the new per-task scratch directory (see D:\orisys_ws\AGENTS.md). --- .gitignore | 5 ++++- docs/filters.md | 3 ++- examples/filters/README.md | 5 +++-- 3 files changed, 9 insertions(+), 4 deletions(-) diff --git a/.gitignore b/.gitignore index 186b14e..ccb4fea 100644 --- a/.gitignore +++ b/.gitignore @@ -46,4 +46,7 @@ __pycache__/ /tools/calibration/ # Scratch output of examples/ (multi_stream.py's default --out-dir) -/outputs/ \ No newline at end of file +/outputs/ + +# Agent scratch: one directory per task, see D:\orisys_ws\AGENTS.md +.scratch/ \ No newline at end of file diff --git a/docs/filters.md b/docs/filters.md index f357b71..316c27b 100644 --- a/docs/filters.md +++ b/docs/filters.md @@ -38,7 +38,8 @@ | `balanced` | 0.5 | 3 | 0.0 | ≈2 帧（67 ms） | 建议起步档：EMA 干掉力级滤波够不到的光流抖动 | | `low_noise` | 0.3 | 3 | 10.0 | ≈3 帧（100 ms） | 底噪优先，读数再低通一道 | -延迟换算 @60fps 减半；数字来自 `_perf/`（对照表见 `orisys-sdk-perf-plan.md`）。 +延迟换算 @60fps 减半；数字来自 `_perf/`（该目录为一次性测量脚本，已删除；对照表见 +`D:\orisys_ws\docs\performance\orisys-sdk-perf-plan.md`，其中仍保留全部实测数字）。 ≥1 帧的延迟与相位差是**因果滤波的代价**：旧显示端曾用零相位 `filtfilt`，那需要"未来"， 无法在采集里做，也让"显示 == 记录"不可能——所以现在只有一条因果链。 diff --git a/examples/filters/README.md b/examples/filters/README.md index 6340b81..1e27596 100644 --- a/examples/filters/README.md +++ b/examples/filters/README.md @@ -6,8 +6,9 @@ 配置里**没写**的滤波键等于"关"：整段删掉就是什么都不滤，和 `off` 那段等价。 -背景、代价与可追溯性约定见 `docs/filters.md`；延迟/噪声实测见 `_perf/` 与 -`orisys-sdk-perf-plan.md`。 +背景、代价与可追溯性约定见 `docs/filters.md`；延迟/噪声实测见 +`D:\orisys_ws\docs\performance\orisys-sdk-perf-plan.md`（原 `_perf/` 测量脚本已删除， +该文档保留全部实测数字）。 下面每一段都有一个同目录的机器可读副本 `filters_<预设名>.json`（四个文件）， `tests/test_filter_presets.py` 会核对它们与 `FILTER_PRESETS` 完全一致 —— 所以改预设时