像素时钟TC002适用：CherryStudio中AI的运行状态指示（MQTT实现无需刷固件）

1509495944

本程序可指示cherry studio 中AI的运行状态！

状态分为:

【THINK】(思考中,蓝色)
任一对话的 AI 正在生成回复时显示
尾部符号旋转动画:THINK | → THINK / → THINK -

【PAUSE】(暂停,黄色)
对话被手动暂停时显示

【DONE】(完成,绿色)
AI 回复完成后显示,横线闪烁几秒后静止

【时间】(空闲,灰色)
60 秒无新消息时,显示当前时间 HH:MM,每分钟自动更新

一、项目简介

本项目为 Ulanzi TC002 像素时钟开发了一个桌面指示程序,可实时采集 Cherry Studio 中 AI 的会话运行状态,并通过 MQTT 下发至 TC002 屏幕显示。程序以单文件 exe 形式分发,免 Python 环境,双击即用。

二、功能说明

状态监测:同时覆盖智能体与普通助手全部对话,状态映射如下——
THINK(蓝色):对话处于生成中
PAUSE(黄色):对话被手动暂停
DONE(绿色):回复已完成
IDLE(灰色):空闲时显示当前时间

自动启动:检测到 EMQX 未运行时自动拉起,无需手动干预
托盘运行:关闭主窗口后转入系统托盘后台运行,右键可呼出主界面或退出
发送日志:主界面实时记录每次下发的时刻与内容
单实例保护:基于本地端口锁,重复启动自动拦截
流量控制:仅在动画与闪烁阶段高频下发,静止状态只发送一次,空闲时钟每分钟更新一次

三、环境要求

按照 Ulanzi 官方 MQTT 教程完成前两步即可(安装并启动 EMQX,并将 TC002 的 MQTT 服务器指向本机,后续 MQTTX 步骤无需执行)

四、操作步骤

确认 EMQX 已于本机 1883 端口运行
双击 exe,首次运行进入三步配置引导:
第一步:指定 EMQX 安装目录下的 bin 文件夹
第二步:指定 Cherry Studio 数据库文件 cherrystudio.sqlite
第三步:输入 TC002 设备编号(打开 Ulanzi Studio,首页上方可见,形如「Ulanzi TC002 xxxx」,输入其中 4 位编号即可,程序自动拼成完整 MQTT 地址)
按提示确认是否创建桌面快捷方式
主界面载入后,TC002 即开始同步显示状态
配置保存于用户目录 config.json,后续启动自动读取。

五、技术要点

数据源: Cherry Studio 的 SQLite 数据库,依据 agent_session_message 与 message 两表最新 assistant 记录的 status 字段判定状态
下发协议: AWTRIX3 兼容的 JSON 格式,经 paho-mqtt 发布至 设备前缀/custom/display 主题(设备前缀由引导时输入的编号自动拼成)
打包方式: PyInstaller 单文件打包,逻辑内嵌
单实例: 本地端口 47655 绑定实现,稳定可靠

获取全套资料联系 1509495944@qq.com