小播鼠广播系统 / Xiaoboshu Broadcast System
无锡小播鼠网络科技有限公司 / Wuxi Xiaoboshu Network Technology Co., Ltd.
📧 邮箱: oxiaom_js@foxmail.com
支持设备 / Supported Devices:
- - 局域网 / LAN
- 互联网 / Internet
- WiFi音响 / WiFi Speaker
- 有线网络广播 / Wired Network Broadcast
- 4G广播设备 / 4G Broadcast Device
- 石头音响 / Rock Speaker
- 草坪音响 / Lawn Speaker
- 功放机 / Amplifier
🎵 PLOYQ
控制小播鼠广播设备进行音频播放和通知广播。
快速开始
1. 登录
CODEBLOCK0
- - host: 服务器地址，如 INLINECODE0
- username: 用户名
- password: 密码
登录后会保存凭据到 config.json。
2. 查看设备
CODEBLOCK1
3. 播放音频
CODEBLOCK2
- - fileid: 文件 ID 或文件名
- deviceids: 设备 ID，多个用
| 分隔，或用 all 表示全部设备 - url: 音频文件 URL
4. 停止播放
CODEBLOCK3
5. 调节音量
CODEBLOCK4
文字转语音 (TTS)
基本用法
CODEBLOCK5
指定语音
CODEBLOCK6
查看可用语音
CODEBLOCK7
中文语音列表
| 名称 | 描述 |
|---|
| xiaoxiao | 晓晓 - 女声，自然亲切 (默认) |
| yunxi |
云希 - 男声，年轻活力 |
| yunjian | 云健 - 男声，成熟稳重 |
| xiaoyi | 晓伊 - 女声，温柔甜美 |
| yunxia | 云夏 - 男童声 |
| xiaochen | 晓辰 - 女声，新闻播报风格 |
| xiaohan | 晓涵 - 女声，温暖 |
| xiaomeng | 晓梦 - 女声，活泼 |
| xiaomo | 晓墨 - 女声，知性 |
| xiaoqiu | 晓秋 - 女声，温和 |
| xiaorui | 晓睿 - 女童声 |
| xiaoshuang | 晓双 - 女童声 |
| xiaoxuan | 晓萱 - 女声 |
| xiaoyan | 晓妍 - 女声 |
| xiaoyou | 悠悠 - 女童声 |
| yunfeng | 云枫 - 男声 |
| yunhao | 云皓 - 男声 |
| yunxiang | 云翔 - 男声 |
| yunyang | 云扬 - 男声 |
设备管理
查看文件列表
CODEBLOCK8
定时任务
任务状态说明
任务有两个状态字段：
| 字段 | 含义 | 值说明 |
|---|
| INLINECODE4 | 任务启用状态 | 1=启用, 0=禁用 |
| INLINECODE5 |
播放状态 | 1=正在播放, 0=未播放 |
重要规则：
- -
enable 控制定时任务是否生效（到时间是否触发播放） - INLINECODE7 表示当前是否正在播放音频
- 删除正在播放的任务前：必须先停止（stop）→ 禁用（disable）→ 再删除（delete）
查看任务列表
CODEBLOCK9
任务操作
CODEBLOCK10
删除任务
重要：删除任务前必须先禁用，直接删除不会生效！
CODEBLOCK11
删除正在播放的任务
如果任务状态显示 ▶ 播放中，删除前必须按顺序执行：
CODEBLOCK12
播放规则
- - 服务器上的音频文件：播放
.mp3T 结尾的 URL（WiFi 音响专用转码） - 自己生成的 TTS 文件：直接播放
.mp3 结尾的 URL（已适配格式）
文件清理
- - 接口：
POST /user/delfile 参数：id, token, INLINECODE14 - 自己生成的 TTS 文件播放完成后，过一段时间要记得清理
- 文件名通常以
ttsO 或 TTS_ 开头，便于识别
自动清理脚本
技能包含 cleanup_tts.py 脚本，用于自动清理服务器上的 TTS 临时文件：
CODEBLOCK13
清理逻辑：
- - 删除以
ttsO 或 TTS_ 开头的文件 - 保留被定时任务引用的文件（不会删除正在使用的文件）
安装后配置
创建定时清理任务
安装技能后，建议创建定时任务每天自动清理 TTS 文件：
CODEBLOCK14
定时任务配置示例：
- - 时间：每天凌晨 3:00
- 命令： INLINECODE20
- 目的：自动清理服务器上的临时 TTS 文件，释放存储空间
文件上传规则
上传前检查图片信息
重要：上传音频文件前，必须检查文件是否包含图片信息（封面图、嵌入图片等），如果有则先去除！
检查方法
CODEBLOCK15
去除图片方法
CODEBLOCK16
上传流程
- 1. 检查：先检查文件是否包含图片信息
- 去除：如果有图片，先去除图片信息
- 去重：调用
xiaoboshu.py files 检查是否已存在同名文件 - 上传：确认无重复后再上传
去重检查
上传文件前必须先检查是否已存在同名文件：
CODEBLOCK17
如果发现重名文件，提示用户"已存在同名文件，是否需要替换？"
常用示例
CODEBLOCK18
API 参考
详细 API 文档见 references/api.md。
小播鼠广播系统 / Xiaoboshu Broadcast System
无锡小播鼠网络科技有限公司 / Wuxi Xiaoboshu Network Technology Co., Ltd.
📧 邮箱: oxiaom_js@foxmail.com
支持设备 / Supported Devices:
- - 局域网 / LAN
- 互联网 / Internet
- WiFi音响 / WiFi Speaker
- 有线网络广播 / Wired Network Broadcast
- 4G广播设备 / 4G Broadcast Device
- 石头音响 / Rock Speaker
- 草坪音响 / Lawn Speaker
- 功放机 / Amplifier
🎵 PLOYQ
控制小播鼠广播设备进行音频播放和通知广播。
快速开始
1. 登录
python scripts/xiaoboshu.py login
- - host: 服务器地址，如 127.0.0.1:12080
- username: 用户名
- password: 密码
登录后会保存凭据到 config.json。
2. 查看设备
python scripts/xiaoboshu.py devices
3. 播放音频
播放文件 (使用文件 ID 或文件名)
python scripts/xiaoboshu.py play
id> ids|all>
播放 URL
python scripts/xiaoboshu.py play
- - fileid: 文件 ID 或文件名
- deviceids: 设备 ID，多个用 | 分隔，或用 all 表示全部设备
- url: 音频文件 URL
4. 停止播放
python scripts/xiaoboshu.py stop
5. 调节音量
python scripts/xiaoboshu.py volume
文字转语音 (TTS)
基本用法
python scripts/xiaoboshu.py tts 要广播的文字
指定语音
python scripts/xiaoboshu.py tts 要广播的文字 all --voice=yunxi
查看可用语音
python scripts/xiaoboshu.py voices
中文语音列表
| 名称 | 描述 |
|---|
| xiaoxiao | 晓晓 - 女声，自然亲切 (默认) |
| yunxi |
云希 - 男声，年轻活力 |
| yunjian | 云健 - 男声，成熟稳重 |
| xiaoyi | 晓伊 - 女声，温柔甜美 |
| yunxia | 云夏 - 男童声 |
| xiaochen | 晓辰 - 女声，新闻播报风格 |
| xiaohan | 晓涵 - 女声，温暖 |
| xiaomeng | 晓梦 - 女声，活泼 |
| xiaomo | 晓墨 - 女声，知性 |
| xiaoqiu | 晓秋 - 女声，温和 |
| xiaorui | 晓睿 - 女童声 |
| xiaoshuang | 晓双 - 女童声 |
| xiaoxuan | 晓萱 - 女声 |
| xiaoyan | 晓妍 - 女声 |
| xiaoyou | 悠悠 - 女童声 |
| yunfeng | 云枫 - 男声 |
| yunhao | 云皓 - 男声 |
| yunxiang | 云翔 - 男声 |
| yunyang | 云扬 - 男声 |
设备管理
查看文件列表
python scripts/xiaoboshu.py files
定时任务
任务状态说明
任务有两个状态字段：
| 字段 | 含义 | 值说明 |
|---|
| enable | 任务启用状态 | 1=启用, 0=禁用 |
| statu |
播放状态 | 1=正在播放, 0=未播放 |
重要规则：
- - enable 控制定时任务是否生效（到时间是否触发播放）
- statu 表示当前是否正在播放音频
- 删除正在播放的任务前：必须先停止（stop）→ 禁用（disable）→ 再删除（delete）
查看任务列表
python scripts/xiaoboshu.py tasks
任务操作
启用任务
python scripts/xiaoboshu.py task-enable
禁用任务
python scripts/xiaoboshu.py task-disable
启动任务 (立即执行)
python scripts/xiaoboshu.py task-start
停止任务
python scripts/xiaoboshu.py task-stop
删除任务
python scripts/xiaoboshu.py task-delete
编辑任务名称
python scripts/xiaoboshu.py task-edit --name=<新名称>
编辑任务时间
python scripts/xiaoboshu.py task-edit --time=HH:MM:SS
编辑任务设备
python scripts/xiaoboshu.py task-devices id> ids>
编辑任务文件
python scripts/xiaoboshu.py task-files id> ids>
删除任务
重要：删除任务前必须先禁用，直接删除不会生效！
bash
1. 先禁用任务
python scripts/xiaoboshu.py task-disable
2. 然后删除任务
python scripts/xiaoboshu.py task-delete
删除正在播放的任务
如果任务状态显示 ▶ 播放中，删除前必须按顺序执行：
bash
1. 先停止播放
python scripts/xiaoboshu.py task-stop
2. 然后禁用任务
python scripts/xiaoboshu.py task-disable
3. 最后删除任务
python scripts/xiaoboshu.py task-delete
播放规则
- - 服务器上的音频文件：播放 .mp3T 结尾的 URL（WiFi 音响专用转码）
- 自己生成的 TTS 文件：直接播放 .mp3 结尾的 URL（已适配格式）
文件清理
- - 接口：POST /user/delfile 参数：id, token, fileid
- 自己生成的 TTS 文件播放完成后，过一段时间要记得清理
- 文件名通常以 ttsO 或 TTS_ 开头，便于识别
自动清理脚本
技能包含 cleanup_tts.py 脚本，用于自动清理服务器上的 TTS 临时文件：
bash
手动执行清理
python scripts/cleanup_tts.py
清理逻辑：
- - 删除以 ttsO 或 TTS_ 开头的文件
- 保留被定时任务引用的文件（不会删除正在使用的文件）
安装后配置
创建定时清理任务
安装技能后，建议创建定时任务每天自动清理 TTS 文件：
bash
每天凌晨 3 点执行清理
python /root/.picoclaw/workspace/skills/audio-broadcast/scripts/cleanup_tts.py
定时任务配置示例：
- - 时间：每天凌晨 3:00
- 命令：python3 /root/.picoclaw/workspace/skills/audio-broadcast/scripts/cleanup_tts.py
- 目的：自动清理服务器上的临时 TTS 文件，释放存储空间
文件上传规则
上传前检查图片信息
重要：上传音频文件前，必须检查文件是否包含图片信息（封面图、嵌入图片等），如果有则先去除！
检查方法
bash
使用 ffmpeg 查看元数据
ffmpeg -i 文件名.mp3
使用 eyeD3 查看（需要安装）
eyeD3 文件名.mp3
去除图片方法
bash
方法1: ffmpeg（推荐，保留音频质量）
ffmpeg -i input.mp3 -map 0:a -c:a copy -map_metadata -1 output.mp3
方法2: eyeD3（直接修改原文件）
eyeD3 --remove-images 文件名.mp3
上传流程
- 1. 检查：先检查文件是否包含图片信息
- 去除：如果有图片，先去除图片信息
- 去重：调用 xiaoboshu.py files 检查是否已存在同名文件
- 上传：确认无重复后再上传
去重检查
上传文件前必须先检查是否已存在
