PyBodian V1.0.0

声明：本项目为非官方第三方工具，依赖波点（酷我）未公开接口，可能随客户端更新而失效，仅供学习交流。

本仓库为 fork 项目，在原有 CLI 基础上新增了窗口界面（GUI）与桌面歌词浮窗，并已同步上游作者的近期修复。

下载使用

下载附件 PyBodian.exe（单文件，Windows x64，免 Python 环境）：

• 直接运行 → 完整模式（窗口界面）
• 命令行 PyBodian.exe --lyrics-only → 仅桌面歌词模式

仅桌面歌词模式（配合波点官方客户端）

打开波点官方客户端听歌，本工具自动读取客户端播放记录，跟随当前播放的歌曲显示桌面歌词，也可以手动搜索指定歌曲。

• Windows 原生逐像素透明（UpdateLayeredWindow），文字平滑带柔和阴影，任意桌面背景下清晰
• 持续置顶且不抢焦点；锁定后鼠标移到歌词栏上即显示控件，3 秒无操作自动隐藏
• 字号（滑杆 / 鼠标滚轮 / 浮窗 A＋A－）、主题色 + 自定义颜色、上下行距、不透明度均可调
• 浮窗位置保护：不会意外落到屏幕角落，浮窗设置里可一键“复位浮窗位置”

完整模式

搜索、推荐、喜欢的音乐、创建/收藏歌单、关注艺人、播放历史、本地收藏浏览；播放控制（上一首/下一首/暂停/定位/音量）、播放与下载音质切换、下载写入封面与 ID3 元数据、收藏、歌词保存为 .lrc。

已同步的上游修复

• 新版二维码登录协议（重要）：扫码链接与凭证换取方式与官方客户端对齐，旧协议已失效
• 扫码后如界面未立即显示登录状态，直接重启本程序即可生效（凭证已保存，重启后自动读取；此为波点新版扫码协议的已知限制）；手机确认后界面即时刷新登录状态（从波点官方客户端日志兜底同步，无需重启）
• 推荐流式加载：推荐内容边播边续，会话级推荐连续性
• TUI 封面显示修复：重绘闪烁、终端 resize 重绘、封面尺寸与垂直居中

环境要求

• 完整模式播放需要 FFmpeg（ffplay/ffmpeg 加入 PATH）；仅歌词模式无此要求
• 登录：从已安装的波点 PC 客户端一键提取凭证 / 扫码登录 / 手动填 UID 与 Token
• 源码运行：py -3.11，GUI 需 pillow，TUI 另需 urwid、textual-image，打包需 pyinstaller

本地构建

打包exe.bat        # 或 py -3.11 build_exe.py，产物 PyBodian.exe