DualShock Tools是一款免费的网页版 PS 手柄校准工具（DualShock Calibration GUI），无需安装任何软件，用浏览器打开网页即可校准 DualShock 4、DualSense、DualSense Edge 和 PS VR2 手柄的摇杆中心与行程范围。它基于 WebHID API 直接读写手柄，支持 20 多种语言（含简体中文），特别适合更换摇杆模组后重新校准、解决 DualSense 摇杆漂移与回中不准的问题。

🎮 DualShock Tools 核心功能一览

界面入口都在主菜单页，源码可参考 index.html 与手柄控制器类 js/controllers/ds5-controller.js。

🚀 快速开始：如何打开网页版 PS 手柄校准工具

1. 选择正确的浏览器：WebHID API 需要 Chrome、Edge 或 Opera（Firefox / Safari 不支持），且网站必须是 HTTPS 环境。
2. USB 连接手柄：用数据线把 DualShock 4 或 DualSense 接入电脑（建议保持电池已充电，防止校准过程中断电）。
3. 点击 Connect（连接）：浏览器会弹出设备授权窗口，选择你的手柄并允许访问。
4. 查看 Controller Info：连接成功后页面显示手柄名称、固件版本与电量，右侧即可开始校准。

💡 提示：校准开始后无法取消，完成前请勿关闭页面或拔掉手柄。

🕹️ 三步完成摇杆校准：中心、外圈、微调

第 1 步：校准摇杆中心（Calibrate stick center）

点击「Calibrate stick center」按钮，可选两种模式：

• 快速模式（quick）：摇杆静止归中即可完成，适合轻度偏差；
• 四步模式（four-step）：按向导把两个摇杆分别推向四个对角再松手，精度更高。

向导界面由 js/modals/calib-center-modal.js 驱动，会逐步提示每一步操作。

第 2 步：校准摇杆行程（Calibrate stick range）

点击「Calibrate stick range」后，必须先缓慢、完整地绕摇杆外圈旋转一圈（顺时针和逆时针各一次，轻触外框边缘），再点「Done」。过早点完成会导致摇杆总是顶在角落，这是最常见的操作错误（详见 templates/faq-modal.html 的 FAQ 说明）。

第 3 步：微调（Finetune，仅 DualSense / Edge）

对于追求极致对称的用户，Finetune 菜单（templates/finetune-modal.html）可以按方向逐格调整行程值。官方建议把圆度（Circularity）控制在7% ~ 9%之间，接近出厂校准水平。

⏪ 校准历史与一键恢复

每次点击绿色「Save changes permanently」按钮，校准值都会记录到历史列表。如果新校准不满意，可以恢复之前的版本——历史恢复仅支持 DualSense 和 DualSense Edge，且记录保存在你当前电脑的浏览器本地存储中，换浏览器或清缓存后无法找回：

恢复入口源码见 js/modals/calibration-history-modal.js。

⚠️ 它能真正修复 DualSense 摇杆漂移吗？

这里必须说清楚：摇杆漂移（Stickdrift）本质是物理磨损——电位计老化、弹簧疲劳或进灰，校准软件无法直接修复漂移。对已经严重漂移的摇杆强行校准，结果往往更差且不可逆。

正确用法是：

1. 拆开手柄，更换新的摇杆模组（电位计或整个摇杆）；
2. 用 DualShock Tools 重新做中心 + 行程校准；
3. 必要时用 Finetune 精修对称性。

🔧 DualSense Edge 用户必读：解锁永久保存

DualSense Edge 的摇杆模组默认锁定了校准保存（NVS 未解锁），需要给每个模组做一次简单的硬件 Mod：用细的漆包线在 PCB 上桥接两个焊点即可，官方提供了两种推荐位置。

选项一（Option 1）的桥接位置，注意走线要细、焊点要小：

Mod 完成后合壳时，要确保外壳能完全合上，线材不能太粗、焊锡不能成球，否则会卡住卡扣：

校准值保存在模组上：模组换到另一台 Edge 会带走校准，换一组新模组则需要重新 Mod 和校准（每个模组各做一次）。

❓ 常见问题 FAQ

问：支持哪些手柄？只支持官方手柄：Sony DualShock 4、DualSense、DualSense Edge 和 PlayStation VR2。不支持第三方"仿制"手柄。

问：能识别山寨手柄吗？目前支持 DualShock 4 的克隆检测（作者买过仿品后顺手加的功能），DualSense 的检测暂未实现。

问：DualSense 升级固件会清除校准吗？不会。

问：校准有风险吗？校准过程本身无风险，但保存校准的那一瞬间如果断电就可能变砖。务必确保电池已装入且有电、USB 线插紧；电池没电又恰好断线，风险最高。

问：校准完摇杆总是顶在角落？说明你做行程校准时没有先绕外圈就点了 Done，重新完整旋转一遍再提交即可。

📦 进阶：本地运行与 Docker 自建

想本地开发或自建站点？项目提供完整的开发指南：

• DEVELOPMENT.md：npm install安装依赖后运行npm run start，在https://localhost:8443访问（WebHID 要求 HTTPS，需接受自签名证书警告）。
• DOCKER.md：使用官方预构建 Docker 镜像，无需任何依赖即可运行。
• setup-dev.sh：一键初始化开发环境。

📁 值得阅读的项目文件

• 中文界面文案：lang/zh_cn.json
• 完整 FAQ 与官方说明：templates/faq-modal.html
• 校准历史逻辑：js/modals/calibration-history-modal.js
• 摇杆渲染：js/stick-renderer.js
• 多语言指南：TRANSLATIONS.md

一句话总结：换个新摇杆后，打开浏览器、插上手柄、点几下按钮，DualShock Tools 就能让你的 PS 手柄重新回到出厂级的手感——免费、免安装、还能随时恢复旧的校准值。