首次使用
简体中文 | English
想直接在浏览器调节设备或播放脚本，可以打开 WebSensa。需要 OSC、应用转发、录制和完整设备连接时，按下面的步骤启动桌面工作台。WebSensa、Node CLI 与 Electron 共用同一工作台，围绕来源、连接和结果组织操作。
1. 启动
下载最新正式版；Node.js／Electron 迁移构建通过 CI 后先进入开发预览。以下格式自带所需运行时，无需另装 Node.js。
| 系统与方式 | 架构 | 文件名示例 | 怎样启动 |
|---|---|---|---|
| Windows Electron 桌面版 | x64／ARM64 | Sensa-version-win-x64-Desktop.zip |
完整解压后运行 Sensa.exe |
| Linux Electron 桌面版 | x64／ARM64 | Sensa-version-linux-x64-Desktop.tar.gz |
完整解压后运行 ./Sensa |
| macOS Electron 桌面版 | x64／ARM64 | Sensa-version-osx-arm64-Desktop.zip |
完整解压后打开 Sensa.app |
| Windows CLI 安装版 | x64／ARM64 | Sensa-version-win-x64-Setup.exe |
安装后从开始菜单打开 |
| Windows CLI 单文件 | x64／ARM64 | Sensa-version-win-x64-SingleFile.exe |
将 EXE 放到可写目录后运行 |
| Windows CLI 便携版 | x64／ARM64 | Sensa-version-win-x64.zip |
完整解压 ZIP，再运行 Sensa.exe |
| Linux CLI 便携版 | x64／ARM64 | Sensa-version-linux-x64.tar.gz |
解压后运行 ./Sensa |
| macOS CLI 便携版 | x64／ARM64 | Sensa-version-osx-arm64.tar.gz |
解压后运行 ./Sensa |
Intel／AMD 电脑通常使用 x64，Apple Silicon 和 Windows ARM 使用 ARM64。开发预览文件名还包含构建编号与提交摘要。
Ubuntu 24.04 开启用户命名空间限制时，在 Electron 解压目录先运行 python3 ./sensa-linux-sandbox.py install，再打开 ./Sensa。它通过 sudo 为当前程序路径注册 AppArmor 许可，Chromium 沙箱保持开启；Sensa 仍以普通用户运行。移动或删除目录前运行 python3 ./sensa-linux-sandbox.py remove，移动后重新注册。其他 Linux 配置及 CLI 无需这一步。
Electron 在自身窗口打开工作台，并协调随包的同一 Node CLI 服务；CLI 自动在浏览器打开工作台。CLI 常用地址为 http://127.0.0.1:5086，端口调整后使用启动时显示的实际地址。首次启动输入处于关闭状态，可以先准备连接。
Windows CLI 安装目录默认为 %LOCALAPPDATA%\Programs\Sensa，更新与卸载保留用户配置和录制。CLI 便携包、安装版与 Electron 包附带文档及 Python 桥工具；单文件 EXE 内置工作台、参数图解与串口／MIDI 依赖。使用 Python 桥时单独准备 Python 环境。串口与蓝牙桥
2. 配置输出
可以先把滑条录成一条轨道：
- 在流程选择添加输出 → 录制，保留 Funscript 格式。
- 展开输入到输出绑定，来源选手动 → L0，轨道名称填
L0，输入与输出范围均为 0–1。 - 保存并启用录制输出。
也可以直接连接目标：
| 目标 | 连接方式 |
|---|---|
| TCode／OSR | 115200/8N1 串口，或 UDP／TCP 地址；选择轴配置 |
| Intiface | 启动 Central，填写地址，扫描并选择设备 |
| OSC／VRChat | 接收 IP／端口、参数路径与 Float／Int／Bool 类型 |
| DG-LAB | DG-LAB 4 APP 配对、设备与通道 |
| MIDI／网络服务 | MIDI 端口、HTTP／WebSocket 地址，或 MQTT 服务与主题 |
绑定把一个来源连到目标。输入范围说明读数的起止值，输出范围决定目标的响应范围。完整输出配置
3. 启用输入并检查结果
在控制选择手动，应用后启用输入。调整 L0 并点击发送一次，或开启连续发送跟随滑条变化。每条绑定会显示原始值、转换值与最近目标。
关闭输入即可完成录制。下载 funscript，或载入播放器，选择脚本、启用输入，再点击播放。脚本自然结束时保留末值和输入启用状态；点击停止、关闭输入或急停时执行对应停止操作。组合模式中的其他来源继续按自己的状态运行。
使用动作设备时，在轴配置中设置方向与行程，先试一个小幅动作。顶栏的紧急停止会停止全部输出并保持，解除后再启用输入。保存配置、切换方式或更换脚本会关闭输入，准备好新设置后重新启用。
4. 选择来源并添加计算
| 来源 | 下一步 |
|---|---|
| OSC 参数 | 选择 OSC 或组合，查看发送来源并保存映射 |
| Funscript | 载入文件、选择脚本，再设置速度、循环与位置 |
| 网站／播放器 | 添加协议输入、连接客户端，选择协议或组合 |
| 多种来源 | 添加计算和绑定，再选择组合 |
| Avatar 位置 | 按定位方案完成设置，查看读数并校准范围 |
VRChat 通常向 Sensa 的 9001 端口发送 OSC，并在 9000 接收回写与心跳。参数含义与预设可以帮助选择读数。
在流程点击添加计算信号，设置加权、平滑、阈值或空间计算。结果保存一次，即可被多个输出选用。计算示例
5. 保存录制与整套方案
完成的录制可以下载、播放，或作为计算输入。Funscript 保存轨迹；JSON Lines／CSV 保存诊断样本。录制与回放
在流程 → 保存与载入整套方案中，将计算、映射、轴配置和输出一起导出。导入预览会先显示将要替换的内容。
CLI 默认在可执行文件旁保存 config.json，源码开发运行时使用当前工作目录；Electron 默认使用用户应用数据目录中的 Sensa/config.json。SENSA_CONFIG_PATH 或 --config <path> 可为两者指定同一个配置文件。既有 PascalCase 与 camelCase 字段都可读取，保存统一使用 camelCase；录制输出默认保存在所选配置旁的 recordings。工作台指南 · 语言设置
运行多个实例
CLI 与 Electron 再次打开同一配置，都会复用已经运行的服务。已有工作台页面连接时沿用该页面；没有页面时打开工作台。
独立设置可以使用命名实例：
Sensa --instance studio
Sensa --instance portable
Sensa --new-instance
命名配置位于原配置旁的 instances/<name>/config.json，新实例从全新设置开始。--new-instance 自动生成唯一名称。管理 HTTP、OSC 接收和启动时的协议监听遇到端口占用，会选择可用端口；当前地址可在控制台与工作台查看。手动保存监听配置时，端口冲突仍会直接提示，便于选定客户端要连接的地址。
CLI 后台运行时，传入 --open-browser false。使用 --config <path> 可让 CLI 与 Electron 共享同一配置及运行实例。