版本：3.5.x

筛选器

该服务会在传出数据到达设备之前，对其应用一系列过滤器。每个过滤器均可针对每个会话进行配置（通过 configure 或 HTTP）或全局（通过设置).

过滤器管道

力依次经历以下阶段：

your force → [osc-damper] → [force-gate] → [damping] → [force-scale] → device

舞台	功能介绍	范围	如何配置
Osc-damper	检测振荡，降低增益	按设备（自动）	内部设置 — 不可由用户配置
力门	在检测到振荡时减弱作用力	按次计费	`configure.force_gate` 或 `config/filters/force_gate`
阻尼	添加粘性阻力（标量和/或方向性）	按次计费	`configure.damping` 或 `config/filters/damping`
力尺	所有力量的全球乘数	全球	`POST /settings` → `devices/force_scale`

安全航线

安全轨迹是一种 位置模式 filter — 它在使用时会限制光标的移动速度 set_cursor_position，确保向目标平稳移动。

设置键	默认	说明
`features/safe_trajectory/enabled`	`false`	启用位置速率限制
`features/safe_trajectory/max_vel`	`0.5`	光标最大速度（米/秒）

通过“设置”进行配置：

curl -X POST http://localhost:10001/settings \
     -H "Content-Type: application/json" \
     -d '{"features/safe_trajectory/enabled": true, "features/safe_trajectory/max_vel": 0.3}'

过滤器管道​

安全航线​

过滤器管道

安全航线