SuperAPI AI 工具集

dot-device-openapi

编程与开发

查看项目

更新于 10-16 01:16

技能介绍

用途:当用户想操作 Dot. 设备时使用本技能,包括列出设备或查找设备 ID、查看设备状态、读取或更新设备设置、切换到下一条内容、发送 Text/Image/Canvas API 内容,以及列出设备上的 loop 或 fixed 任务。若用户要设计自定义 Canvas 卡片、仪表板或 windowData 布局,应先使用 dot-canvas-designer,之后再把内容发送到设备。

主要能力:通过 Dot 云 API 或本地 MCP 服务完成上述操作。本地 dot-mcp stdio 服务只暴露固定工具,不提供任意 HTTP 访问;只读工具包括 dot_list_devices、dot_get_device_status、dot_get_device_settings、dot_list_timezones、dot_list_tasks、dot_validate_canvas,设备变更类包括 dot_update_device_settings、dot_switch_next_content、dot_send_text、dot_send_image、dot_send_canvas。服务从环境变量 DOT_API_KEY 读取密钥,密钥不作为工具参数传入,不存储、不记录日志;设备变更请求只发送一次,不自动重试。

使用方式:安装本地服务用 pipx install git+https://github.com/MindReset/dot_skill.git,运行 dot-mcp,或使用 uvx --from git+https://github.com/MindReset/dot_skill.git dot-mcp。基础 URL 为 https://dot.mindreset.tech,认证头为 Authorization: Bearer dot_app_<api_key>,速率限制每秒 10 次请求。POST 需带 Content-Type: application/json。常用端点包括文本 POST /api/authV2/open/device/:deviceId/text、图像 POST /api/authV2/open/device/:deviceId/image、画布 POST /api/authV2/open/device/:deviceId/canvas、状态 GET /api/authV2/open/device/:deviceId/status、设置 GET/POST /api/authV2/open/device/:deviceId/settings、时区 GET /api/authV2/open/timezones、设备列表 GET /api/authV2/open/devices、下一条 POST /api/authV2/open/device/:deviceId/next、任务列表 GET /api/authV2/open/device/:deviceId/:taskType/list。也可使用 scripts/ 下的本地脚本,如 list_devices.py、send_text.py、send_canvas.py 等,内容脚本支持 --task-alias 和 --task-type fixed。

限制与注意:固定的产品路由说明写到,Read Pico 与 Rand/0 不走 Dot 云 API,不应请求 Dot 云凭据或使用发送脚本。发送内容前,需确保对应内容已加入设备选定的 loop 或 fixed 列表。Content Studio 中使用 taskType: "fixed" 表示固定内容,省略则选择 loop 列表。taskKey 只在对应 taskType 的列表内匹配;不带 taskKey 则更新该列表第一个匹配的 API 项。固定内容更新保留已配置时间,在下次计划刷新时显示,refreshNow 对固定内容无效,不应承诺立即显示或额外发送 next 命令强制刷新。设备设置中 interval.powerMs 与 interval.batteryMs 必须为 60000 至 43200000 毫秒的整分钟倍数;sleep.start 和 sleep.end 为设备时区的本地 HH:mm 时间,结束早于开始表示次日。taskAlias 应放在顶层,不能放进 Canvas 的 data 里。更多细节见 references/authentication.md、references/api_reference.md 及 OpenAPI schema。