Quote/0 技能（v1.0.4）

使用本地脚本调用 Dot Developer Platform API：

bash
node quote0.js [options]

在技能目录内执行命令。

---

1) 凭据与安全（必须遵守）

必需凭据

• - DOTAPIKEY（必需）
• DOTDEVICEID（设备相关命令必需，如 status|next|list|text|image）

禁止事项

• - 不要把 API Key / Device ID 硬编码到脚本、SKILL.md、Git 提交。
• 不要把敏感文件路径传给 --imageFile（脚本会读取该路径对应的本地文件并上传）。

推荐注入方式（按安全优先级）

1. 1. 单次命令传参（最推荐）
2. 当前终端临时环境变量
3. 长期写入 shell 配置（仅在用户明确同意后）

若要持久保存环境变量（如写入 ~/.zshrc / ~/.bashrc / PowerShell profile），必须先征得用户明确同意。

---

2) 跨平台运行方式（macOS / Linux / Windows）

先进入技能目录：

bash
cd /path/to/quote0

方式 A：单次命令传参（推荐）

bash node quote0.js devices --apiKey ... node quote0.js status --apiKey ... --deviceId ...

方式 B：临时环境变量

macOS / Linux（bash/zsh）

bash export DOTAPIKEY=你的_key export DOTDEVICEID=你的_id node quote0.js devices node quote0.js status

Windows PowerShell

powershell $env:DOTAPIKEY=你的_key $env:DOTDEVICEID=你的_id node .\quote0.js devices node .\quote0.js status

Windows CMD

cmd set DOTAPIKEY=你的_key set DOTDEVICEID=你的_id node .\quote0.js devices node .\quote0.js status

方式 C：持久环境变量（需用户同意）

仅在用户明确授权后再执行。

---

3) 首次配置（避免 404/403）

1. 1. 在 Dot App 完成设备配对、联网、在线确认
2. 创建 API Key：More → API Key → Create API Key
3. 获取 Device Serial Number（作为 DOTDEVICEID）
4. 在 Content Studio 至少添加：

- 一个 Text API 内容项 - 一个 Image API 内容项

1. 5. 运行：

- devices 确认设备可见 - status 确认设备在线

---

4) 命令总览

bash
node quote0.js --help

• - devices：获取设备列表
• status：获取设备状态
• next：切换下一条内容
• list：列出设备内容项
• text：推送文本内容
• image：推送图像内容

---

5) 命令与 API 对应

devices

• - API: GET /api/authV2/open/devices

bash node quote0.js devices

status

• - API: GET /api/authV2/open/device/:id/status

bash node quote0.js status node quote0.js status --deviceId ABCD1234ABCD

next

• - API: POST /api/authV2/open/device/:id/next

bash node quote0.js next

list

• - API: GET /api/authV2/open/device/:deviceId/:taskType/list

bash node quote0.js list --taskType loop

text

• - API: POST /api/authV2/open/device/:deviceId/text

bash node quote0.js text --message 你好，Quote/0 node quote0.js text --title 验证码助手 --message 你的验证码：205112 --signature 2026-02-25 00:40 --refresh true

关键参数：

• - --message 必填
• --title / --signature / --icon / --link / --taskKey 可选
• --refresh 默认 true

image

• - API: POST /api/authV2/open/device/:deviceId/image

bash node quote0.js image --imageFile ./card.png node quote0.js image --imageFile ./text-card.png --border 0 --ditherType NONE --refresh true

关键参数：

• - --image 或 --imageFile 二选一
• --imageFile 必须是 .png 普通文件，且大小不超过 5MB
• 脚本会校验 PNG 文件头（不可绕过）
• --border：0 白边 / 1 黑边
• --ditherType：DIFFUSION | ORDERED | NONE
• --ditherKernel：THRESHOLD | ATKINSON | BURKES | FLOYD_STEINBERG | ...

---

6) 常见错误排查

• - 401 Unauthorized：API Key 错误/过期
• 403 Forbidden：Key 无此设备权限
• 404 Not Found：设备 ID 不存在，或未添加 Text/Image API 内容项
• 400 Invalid Params：参数非法（如 border、image、dither）
• 500 Device response failure：设备离线/网络异常
• 限流：10 requests/second

---

7) 官方文档

• - 总览：https://dot.mindreset.tech/docs/service/open
• API Key：https://dot.mindreset.tech/docs/service/open/getapi
• Device ID：https://dot.mindreset.tech/docs/service/open/getdeviceid
• Device List：https://dot.mindreset.tech/docs/service/open/listdevicesapi
• Device Status：https://dot.mindreset.tech/docs/service/open/devicestatusapi
• Device Next：https://dot.mindreset.tech/docs/service/open/devicenextapi
• List Device Content：https://dot.mindreset.tech/docs/service/open/listdevicetasksapi
• Text API：https://dot.mindreset.tech/docs/service/open/textapi
• Image API：https://dot.mindreset.tech/docs/service/open/imageapi