bbtag — 蓝签推送工具
安装
首先检查 bluetag 是否已全局安装:
bluetag --version
如果命令不存在,切换到项目根目录(含 pyproject.toml 的目录)执行安装:
cd /path/to/bbtag && uv tool install .
安装后 bluetag 即为全局命令,可在任意目录使用。
基本用法
推送文字
bluetag text "正文内容" --title "标题"
正文支持 \n 换行:
bluetag text "家烧黄鱼\n凉拌猪耳朵\n炒青菜" --title "晚餐菜单"
仅预览,不推送:
bluetag text "正文" --title "标题" --preview-only
推送图片
bluetag push /path/to/image.png
扫描设备
bluetag scan
样式选项
| 参数 | 可选值 | 默认 |
|---|---|---|
--title-color |
black / red / yellow | red |
--body-color |
black / red / yellow | black |
--separator-color |
black / red / yellow | yellow |
--align |
left / center | left |
--screen |
3.7inch / 2.13inch | 3.7inch |
默认配色(红标题 + 黄分隔线 + 黑正文)在 3.7inch 屏幕上效果很好。
屏幕规格
| 型号 | 分辨率 | 支持颜色 |
|---|---|---|
| 3.7inch | 240×416 | 黑 / 白 / 红 / 黄 |
| 2.13inch | 250×122 | 黑 / 白 / 红 |
工作流
- 理解用户想推送的内容(标题、正文、样式需求)
- 先用
--preview-only生成预览让用户确认 - 用户确认后执行推送
常见场景示例
菜单:
bluetag text "家烧黄鱼\n凉拌猪耳朵\n炒青菜" --title "晚餐菜单"
提醒:
bluetag text "下午3点开会\n记得带资料" --title "今日提醒" --title-color black --separator-color red
居中对齐:
bluetag text "内容" --title "标题" --align center