dsh-toy

dsh-toy

English | 简体中文

dsh-toy is a DeepSeek Harness plugin for connecting small toys to DSH.

At connection time, the agent first asks for the brand and model, then selects the connection method automatically. If the user genuinely does not know, the agent starts unknown-hardware discovery: On macOS, unknown hardware first uses read-only raw CoreBluetooth advertisement discovery, without starting Intiface or connecting to devices. Regular Bluetooth, serial, and USB models use Buttplug / Intiface. The plugin starts local Intiface Engine automatically when needed. Known sharing-link models from Ankni (安可尼), MizzZee (谜姬), and Zuiqingfeng (醉清风) use MonsterParty. Known dual-output devices expose their channels separately.

Users do not need to understand or select an underlying connection method, or manually start Intiface.

Brand and model names are not an allowlist. The agent passes any user-reported name through unchanged; unfamiliar names still use local hardware discovery. The plugin also supplies a verified local compatibility mapping for RoomFun devices reporting model RF_CANNON_PT3, exposed as RoomFun Cannon with one vibration channel.

The implementation follows protocol observations from Chemtrails, together with the device model and message formats documented by Buttplug and the Buttplug Protocol Specification. This repository contains an independent TypeScript implementation; see NOTICE for attribution. Guardrails Sharing tokens stay in plugin configuration and never appear in model-visible tool arguments or results. Raw BLE discovery is read-only: it scans connectable advertisements without connecting or writing characteristics. Output stops automatically after 30 seconds by default. Zero-duration holds are disabled unless allowHold: true is explicitly configured. maxIntensityPercent and maxDurationSeconds are enforced before backend dispatch. A newer command replaces the previous automatic-stop timer for the same device. toy_stop without a device id performs a global stop. Plugin unload, HMR, and toy_disconnect stop output and await WebSocket shutdown.

Use only hardware you own or are explicitly authorized to control. Treat sharing tokens as temporary control credentials and keep them out of Git, logs, and conversations. Install

Requirements: Node.js 22.19 or newer and pnpm on PATH. Raw macOS BLE discovery additionally uses the Swift compiler from Xcode Command Line Tools. The bundle targets the @deepseek-ai/dsh 0.1.2-rc.1 line, which CI installs and boots on every change. Install pnpm once if needed with npm install --global pnpm@10, then add the plugin directly from GitHub:

Start DSH with the same profile:

The first command installs and activates the bundle persistently in the web profile. Re-running DSH does not reinstall it. To inspect the composed configuration or remove the bundle: