zectrix-sticky-display

name	zectrix-sticky-display
description	当用户要求通过 Zectrix Open API 控制极趣便利贴显示、管理设备页面或操作待办事项时使用

zectrix-sticky-display

触发条件

• 当用户要求通过 Zectrix Open API 控制便利贴显示、管理设备页面或操作待办事项时使用。

操作规则（必遵守）

1. 优先调用 scripts/zectrix_control.py
2. 禁止手写 HTTP 请求；不要绕过脚本直接拼 API 调用。
3. 默认由脚本处理配置读取、默认设备回填与设备选择逻辑。
4. 仅当脚本报错时，再提醒用户检查 zectrix.json
5. 出现多设备歧义时，向用户展示候选设备并请其明确选择（deviceId 或 alias）后再执行。

CLI 命令速查

列设备：

python scripts/zectrix_control.py devices
python scripts/zectrix_control.py --json devices

显示内容：

python scripts/zectrix_control.py display-text --text "你好" --page-id 1
python scripts/zectrix_control.py display-structured-text --title "提醒" --body "下午三点开会" --page-id 1
python scripts/zectrix_control.py display-image --image "./note.png" --page-id 1

清空页面：

python scripts/zectrix_control.py clear-page --page-id 1
python scripts/zectrix_control.py clear-all-pages

待办：

python scripts/zectrix_control.py --json todo-list
python scripts/zectrix_control.py todo-create --title "9点去吃饭" --due-time 09:00
python scripts/zectrix_control.py todo-update --id 123 --title "改后的标题"
python scripts/zectrix_control.py todo-complete --id 123
python scripts/zectrix_control.py todo-uncomplete --id 123
python scripts/zectrix_control.py todo-delete --id 123

备注

• 这是一个 CLI 优先 的 skill；LLM 应直接调用 zectrix_control.py，而不是自己手写底层 API。
• 全局参数要放在子命令前，例如：python ...zectrix_control.py --json devices
• 图片命令要求本地文件已存在。
• 若脚本报错，再提醒用户检查 zectrix.json。