name: vestaboard
description: 使用 Vestaboard Cloud API (cloud.vestaboard.com) 和可选的旧版 RW 端点，在 Vestaboard 上读取和写入消息。适用于需要在 Vestaboard 上显示文本、更新看板/屏幕、展示简短状态信息、使用彩色/填充字符代码渲染简单像素画，或获取当前屏幕消息的场景。

Vestaboard

安全规范

• 必须通过环境变量提供令牌（切勿在提示、日志或提交中直接嵌入密钥）。
• 首选变量名：VESTABOARD_TOKEN
• 可选旧版备用变量名：VESTABOARD_RW_KEY

约束条件

• Vestaboard 旗舰版布局为 6 行 x 22 列。
• 默认情况下，文本输入会自动格式化为 6x22 布局（转换为大写并自动换行；超出部分将被截断）。

快速使用（本地 CLI）

# 在项目根目录执行
npm install

# 仅预览文本格式化效果
node scripts/vb.js preview "Hello from Quarterbridge Farm"

# 读取当前消息（JSON 格式）
node scripts/vb.js read

# 写入文本
node scripts/vb.js write "EGGS READY"

# 写入数字布局（6x22 的字符代码数组）
node scripts/vb.js write-layout content/layouts/forest-depth.json

示例内容

• 数字布局文件位于 content/layouts/*.json
• 人工审核预览文件位于 content/previews/*.md