DSBox SDK 下载与接入文档

面向 DSBox 硬件的 Python SDK,支持鼠标移动、左右中键、滚轮、X1/X2 侧键透传等操作。当前页面提供 Windows x64 / Python 3.12 版本下载、接口示例和接入说明。

产品介绍

面向稳定输入控制与第三方软件接入的 DSBox 硬件解决方案。

DSBox 是一款面向输入控制场景设计的硬件设备,通过独立硬件链路提供鼠标移动、按键与滚轮等输入透传能力。设备在接入计算机后,可将上层软件发出的控制指令转换为稳定的鼠标与按键动作,为需要精细输入控制的应用提供统一、可靠的硬件执行通道。

在实际使用中,DSBox 重点优化按键透传完整性、输入响应速度和鼠标移动连续性。低延迟的按键响应与平滑的鼠标位移输出,有助于减少输入迟滞与动作割裂感,使软件控制更接近真实鼠标操作手感。

硬件级输入透传 由 DSBox 硬件本体执行鼠标移动、点击、滚轮与侧键等输入动作,降低软件环境差异带来的不确定性。
低延迟按键响应 优化按键透传链路,提升按下、释放和组合动作的响应一致性,适合对输入时序敏感的应用场景。
平滑鼠标控制 支持连续、细粒度的鼠标位移输出,帮助第三方软件获得更自然、更稳定的指针控制体验。
SDK 快速接入 通过简洁的 Python API 完成连接、移动、点击、滚轮和侧键调用,便于开发者快速集成到现有工具。

SDK 介绍

让第三方软件以标准、稳定、可维护的方式调用 DSBox 硬件能力。

DSBox SDK 是面向 DSBox 硬件的开发接口层,将设备连接、硬件状态、鼠标移动、点击、滚轮和侧键透传等能力封装为简洁的 Python API。开发者无需直接处理底层通信细节,即可在自己的应用中调用 DSBox 完成输入控制。

通过本站提供的 DSBox SDK,开发者可以将 DSBox 接入第三方软件,在合法合规且获得授权的场景下,用于办公辅助、流程自动化、设备测试、交互流程验证、无障碍辅助以及日常效率工具等用途。

SDK 适合需要“软件决策、硬件执行”的场景:上层程序负责业务逻辑与交互流程,DSBox 负责稳定输出鼠标与按键动作,从而提升自动化流程的可控性、一致性和部署便利性。

办公流程辅助 将报表导出、表格录入、系统切换、固定按钮点击等重复动作接入脚本,减少人工在多个窗口之间来回操作。
生活效率工具 配合个人工具完成定时整理、批量确认、常用页面操作和快捷入口触发,让日常电脑操作更省步骤。
自动化测试 用于桌面软件、网页流程或设备控制台的输入验证,模拟移动、点击、滚轮和侧键动作,检查交互流程是否稳定。
交互验证与无障碍辅助 在教学录制、辅助控制、设备验证等场景中,由软件按预设逻辑触发硬件输入,降低手动操作负担。

通过 Codex 一键调用

用自然语言描述目标,让 Codex 帮你把第三方软件与 DSBox 硬件连接起来。

如果你已经有一个 Python 项目、办公工具、测试脚本或桌面自动化程序,可以把项目目录交给 Codex,并说明要把哪些鼠标动作接入 DSBox。Codex 会按项目结构安装 SDK、补齐依赖,并把原有鼠标控制逻辑改成 DSBox 硬件调用。

使用前请明确业务触发条件、目标动作和关闭流程,并确保场景已获得授权且合法合规。

Codex 提示词:请在我的项目中安装 DSBox SDK:dsbox_sdk-0.1.1-cp312-cp312-win_amd64.whl,环境配置为 Python 3.12。代码调用方式为:from dsbox import DSBox;box = DSBox.connect();box.move(20, -8);box.click("left", 30);box.stop();box.close()。请将我的软件业务逻辑与 DSBox 硬件相连接,并保留现有业务逻辑、异常处理和安全关闭流程。

SDK 下载

下载适用于 Windows x64 / Python 3.12 的 wheel 文件,用于集成到自己的项目中。

Python 版本

当前 SDK 包适用于 Python 3.12,请确认本机 Python 版本匹配后再安装。

python -m pip install https://sdk.youquwangluo.xyz/downloads/dsbox_sdk-0.1.1-cp312-cp312-win_amd64.whl

API 接入

常用接口的最小调用方式,便于复制到第三方软件中改造。

核心调用方式:移动、点击、滚轮、侧键与拖动
from dsbox import DSBox

box = DSBox.connect()

try:
    # 相对移动
    box.move(100, 0)       # 向右移动
    box.move(-100, 0)      # 回到附近原位

    # 常用鼠标按键:第二个参数是按住时长,单位毫秒
    box.click("left", 30)   # 左键按住 30ms 后释放
    box.click("right", 30)  # 右键按住 30ms 后释放
    box.click("middle", 30) # 中键按住 30ms 后释放

    # 滚轮
    box.wheel(3)           # 向上滚动
    box.wheel(-3)          # 向下滚动

    # 侧键透传
    box.click("x1", 30)    # 侧键 X1 / back
    box.click("x2", 30)    # 侧键 X2 / forward

    # 按下、拖动、释放
    box.down("left")       # 按住左键
    box.move(160, 0)       # 向右拖动
    box.up("left")         # 松开左键
finally:
    box.stop()
    box.close()

说明:例如 box.click("right", 30) 中的 30 是按键保持时间,单位为毫秒;表示右键按下 30ms 后自动释放。省略该参数时,SDK 默认使用 20ms。

用户协议

适用于 DSBox 硬件盒子、DSBox SDK、固件、文档、下载服务、授权激活和售后支持。

合法授权使用

用户只能在合法、合规、获得授权的设备、系统、软件和业务场景中使用 DSBox 硬件与 SDK。

严格禁止作弊与规避检测

不得用于外挂、游戏作弊、考试作弊、绕过反作弊、规避封禁、刷量、攻击、非法监控等用途。

硬件与 SDK 风险自担

SDK 可触发鼠标移动、点击、滚轮和侧键动作,用户应自行验证业务逻辑、权限边界和安全关闭流程。

禁止误导性宣传

不得以“防封”“过检测”“外挂硬件”“作弊盒”等违法违规或误导性表述宣传、转卖或出租产品。

售后服务边界

公司仅为合法正当用途提供售后和技术支持,有权拒绝任何涉及违法、作弊、侵权或规避检测的请求。

个人信息与证据留存

订单、售后、授权、风控和争议处理中的必要信息将按合法、正当、必要原则处理。

下载、安装、连接、激活、集成、升级、咨询、申请售后或实际使用 DSBox 硬件与 SDK,即表示用户已阅读、理解并同意完整用户协议。完整协议对产品性质、SDK 授权、禁止用途、第三方平台规则、隐私与信息处理、售后限制、责任边界和争议解决作出了详细约定。