本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-toy

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:c3ll256/dsh-toy

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 在 macOS 上，未知硬件会先通过只读的原始 CoreBluetooth 广播发现，不启动 Intiface，也不连接设备。
• 普通蓝牙、串口或 USB 型号通过 Buttplug / Intiface 连接；插件会在需要时自动启动本机 Intiface Engine。
• 安可尼、谜姬、醉清风等已知分享链接型号通过 MonsterParty 连接；已知双通道设备会分别暴露各个输出通道。
• 分享 token 只保存在插件配置中，不会出现在模型可见的工具参数或结果里。
• 原始 BLE 发现是只读操作：仅扫描可连接广播，不连接设备，也不写入特征。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件能控制什么?

支持蓝牙、串口、USB 类型的品牌玩具,以及部分使用分享链接的厂商(安可尼、谜姬、醉清风等)。macOS 上还能先做只读原始 BLE 扫描,再决定走哪条连接路径。

需要自己安装 Intiface Engine 吗?

不需要。插件默认会自动从 Buttplug 官方 GitHub Release 下载固定版本并校验 SHA-256 后启动;如果已经手动运行着 Intiface,会优先复用现有实例而不是关闭它。

用起来安全吗?

所有控制命令都会经过时长和强度上限检查,默认 30 秒后自动停止,最大强度 100%、最长 300 秒;只有显式开启 allowHold 才允许"开着不关",否则拒绝。

MonsterParty 分享 token 怎么用?

把它保存到插件配置里(常用环境变量读取),不要直接暴露给模型。分享 token 通常一次性使用,断线后需重新生成链接。

报错 spawn intiface-engine ENOENT 怎么办?

说明 Intiface 没装,且自动下载没生效;更新到包含该能力的版本,把 intifaceAutoDownload 设为 true,并确认能访问 GitHub。

可以在 Windows / Linux 上用吗?

可以。Intiface 自动下载支持 macOS ARM64、Linux x64/ARM64、Windows x64,其他平台需要通过 intifaceExecutable 指定自己准备好的引擎。

怎么彻底停掉?

直接告诉 agent 停止全部设备,或调用玩具控制器,插件卸载/HMR 时也会自动停输出并关闭由它启动的 Intiface 进程。

原始 BLE 扫描为什么只支持 macOS?

它依赖 Xcode Command Line Tools 提供的 Swift 编译器,只做只读发现,不连接、不写特征;其他平台直接走 Intiface 回退路径。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: >=22.19.0
• Platforms: macOS, Linux, Windows

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则