Skip to content

README.md

Latest commit

 

History

History
59 lines (40 loc) · 1.96 KB

README.md

File metadata and controls

59 lines (40 loc) · 1.96 KB
Raw

PS5 DualSense 控制器

在 Windows 上把 DualSense 手柄作为本地控制器使用：读取按键、摇杆和扳机，将其映射为全局快捷键，并控制灯条、玩家灯、自适应扳机和振动反馈。

功能

  • USB HID 输入和全局键盘映射
  • 本地网页配置与实时状态
  • 灯光、振动和 L2/R2 自适应扳机控制
  • 可选的 Codex 任务状态灯
  • 可选的虚拟 Precision Touchpad 驱动，用于触摸板切换 Windows 虚拟桌面

环境

  • Windows 11 x64
  • DualSense 手柄和 USB 数据线
  • Python 3.10 或更高版本
  • Edge、Chrome 或其他现代浏览器

当前仅支持 USB，不支持蓝牙。虚拟触摸板驱动需要 Visual Studio 2022 Build Tools、Windows 11 WDK，并会使用 Windows 测试签名模式。

运行

在 PowerShell 中执行：

Set-ExecutionPolicy -Scope Process Bypass
.\start-admin.ps1

浏览器打开 http://127.0.0.1:4173/。停止服务：

.\stop.ps1

可选驱动的构建、安装和卸载方式见 driver/ds5ptp/README.md。

测试

python -m unittest discover -s . -p "test*.py" -v
python -m py_compile bridge.py approval_detection.py approval_watcher.py codex_hook.py serve_ui.py test_bridge_status.py
node --check app.js

手柄输入、灯光、扳机、振动和驱动仍需在 Windows 真机上验证。

目录

  • bridge.py：DualSense HID、本地 API、键盘映射和输出控制
  • index.html、app.js、styles.css：本地控制页面
  • hooks-migration/：Codex Hook 安装与回滚脚本
  • driver/ds5ptp/：可选虚拟 Precision Touchpad 驱动
  • test_bridge_status.py：桥接状态与安全检查

主体代码采用 MIT License。虚拟触摸板驱动改编自 Microsoft vhidmini2 和 PeronGH/BLE-PTP-PoC，完整许可见 THIRD_PARTY_NOTICES.md。

DualSense 和 PlayStation 是 Sony Interactive Entertainment 的商标；本项目与 Sony 无隶属关系。