DSBox SDK 下载与文档

产品介绍

面向稳定输入控制与第三方软件接入的 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 文件，用于集成到自己的项目中。

SDK Wheel

dsbox_sdk-0.1.1-cp312-cp312-win_amd64.whl

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。

用户协议

下载或使用 SDK 即表示用户理解并接受以下条款。

合法使用。用户应在合法、合规、获得授权的环境中使用 DSBox SDK 与硬件，不得用于破坏系统、规避平台规则、侵犯他人权益或违反当地法律法规的行为。

风险提示。SDK 可以控制鼠标移动、点击、滚轮和侧键输出。运行示例前应关闭重要窗口并将指针移动到安全区域，因误操作造成的损失由用户自行承担。

兼容性。当前下载包适用于 Windows x64 与 Python 3.12。不同系统、Python 版本或硬件固件可能需要对应版本的 SDK。

更新与维护。网站可能不定期更新 SDK、文档和示例。用户应优先使用最新稳定版本，并在升级前确认项目依赖。

免责声明。除明确书面承诺外，本 SDK 按现状提供。因用户环境、第三方软件、操作系统策略或错误使用导致的问题，发布方不承担超出法律规定范围的责任。

联系我们。如需商务授权、技术支持或问题反馈，请通过购买渠道或官方客服入口联系。