通用手柄映射软件(支持各种主流手柄 Xbox、PS)
- 极简:程序精简,windows 安装包仅有 4 MB 左右
- 美观程度高,卡片式UI设计,操作界面一目了然!
- 高性能服务提供!后端采用 Rust 语言设计,高效操作,丝滑无比!
- 支持单击、双击、长按映射,高度自定义。
- 支持鼠标模拟控制,可以将摇杆作为鼠标使用(后续可能添加对 DS4 的触控板支持)
- 支持自定义摇杆死区范围,优化操作精度
- 支持市面多种手柄,如 Xbox、PS 等
- 高度自定义手柄键位映射(支持鼠标、键盘映射、键盘鼠标按键和滚轮混合映射, 支持各种快捷键,如:Shift+Alt+鼠标滚轮等复杂混合映射,满足多场景支持)
- 更多:拖动列表项控制映射顺序
- 灵敏度可调,适应各种用户各种手感!
- 支持摇杆映射(支持摇杆旋转映射、支持摇杆死区调整、支持摇杆映射为鼠标移动、画笔大小、画布缩放等操作)
- 支持多预设方案(保存和导入多个预设配置,适应不同软件和工作流程)
- 支持副预设快速切换功能,通过绑定切换按键,同时控制两套映射
- 支持开机自启,可调“自动连接手柄”,让你从开机到工作顺滑无比!
- 支持托盘运行,最小化到系统托盘,不干扰创作过程!
- 安全卸载,卸载后不影响手柄正常功能,您可以放心使用
| 依赖 | 说明 |
|---|---|
| Rust 工具链 | stable 通道,edition 2024 |
| Node.js + pnpm | 包管理器固定为 pnpm(见 pnpm-lock.yaml) |
| WebView2 Runtime | Windows 平台运行依赖 |
| MSVC 构建工具 | Rust MSVC target 链接所需 |
| Git 子模块 | src-tauri/third-party/gilrs 通过 .gitmodules 引入 |
# 克隆时一并拉取 gilrs 子模块
git clone --recurse-submodules <repo>
# 已克隆则补拉一次子模块
git submodule update --init --recursive
# 安装前端依赖(必须使用 pnpm,禁止 npm/yarn)
pnpm install
# 启动开发环境(自动启动 Vite 于 1420 端口 + Tauri 窗口)
pnpm tauri dev
# 类型检查 + 前端生产构建(产物输出到 dist/)
pnpm build本项目的代码部分遵循 GNU General Public License v3.0 许可证开源。
关于图形资源
本项目中使用的所有位于 src/assets/controller 目录下的 .svg 手柄布局图是本项目的原创作品,其版权归项目作者所有。
这些图形资源不在 GPLv3 许可范围内,并保留所有权利 (All Rights Reserved)。
未经项目作者明确的书面许可,禁止以任何形式对这些图形资源进行复制、修改、分发或用于商业目的。



