Quote/0 技能（v1.0.4）

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

node quote0.js <command> [options]

在技能目录内执行命令。

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

必需凭据

• DOT_API_KEY（必需）
• DOT_DEVICE_ID（设备相关命令必需，如 status|next|list|text|image）

禁止事项

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

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

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

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

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

先进入技能目录：

cd /path/to/quote0

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

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

方式 B：临时环境变量

macOS / Linux（bash/zsh）

export DOT_API_KEY="你的_key"
export DOT_DEVICE_ID="你的_id"
node quote0.js devices
node quote0.js status

Windows PowerShell

$env:DOT_API_KEY="你的_key"
$env:DOT_DEVICE_ID="你的_id"
node .\quote0.js devices
node .\quote0.js status

Windows CMD

set DOT_API_KEY=你的_key
set DOT_DEVICE_ID=你的_id
node .\quote0.js devices
node .\quote0.js status

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

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

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

1. 在 Dot App 完成设备配对、联网、在线确认
2. 创建 API Key：More → API Key → Create API Key
3. 获取 Device Serial Number（作为 DOT_DEVICE_ID）
4. 在 Content Studio 至少添加：
   • 一个 Text API 内容项
   • 一个 Image API 内容项
5. 运行：
   • devices 确认设备可见
   • status 确认设备在线

4) 命令总览

node quote0.js --help

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

5) 命令与 API 对应

devices

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

node quote0.js devices

status

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

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

next

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

node quote0.js next

list

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

node quote0.js list --taskType loop

text

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

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

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/get_api
• Device ID：https://dot.mindreset.tech/docs/service/open/get_device_id
• Device List：https://dot.mindreset.tech/docs/service/open/list_devices_api
• Device Status：https://dot.mindreset.tech/docs/service/open/device_status_api
• Device Next：https://dot.mindreset.tech/docs/service/open/device_next_api
• List Device Content：https://dot.mindreset.tech/docs/service/open/list_device_tasks_api
• Text API：https://dot.mindreset.tech/docs/service/open/text_api
• Image API：https://dot.mindreset.tech/docs/service/open/image_api