一个住在 macOS 桌面上的非官方、非商用粉丝桌宠。卜卜会安静陪伴、显示 Codex / Claude Code 的工作状态，也提供番茄钟、随手记和 Mac 刘海模式。
当前版本为
v0.1.0-alpha.1公测版，仅支持 macOS 14 或更高版本。 本项目与五月天、相信音乐、OpenAI、Anthropic 均无隶属、合作或背书关系。
- 透明置顶桌宠，可拖动并记住桌面位置
- 番茄钟与专注结束提醒，可选择自己的本地音频
- 随手记，本地保存最近的记录
- Mac 物理刘海状态条；无刘海设备自动使用顶部悬浮胶囊
- Codex / Claude Code 状态动画：思考、工具调用、完成与出错
- 本地 SQLite、随机桥接令牌，断网时桌宠和番茄钟仍可使用
Windows 版本目前暂停维护，本次公开版只验证 Mac。
- 打开 最新版本。
- 下载 macOS 安装包，打开后把「卜在」拖入“应用程序”。
- 首次启动时，若 macOS 提示开发者无法验证，请先确认文件来自本仓库， 再前往“系统设置 → 隐私与安全性”选择“仍要打开”。
当前公测包尚未使用 Apple Developer ID 签名或公证。Apple 提醒，运行未经 签名和公证的软件存在风险；不确定时请使用下面的源码构建方式。参见 Apple 的安全说明。
需要：
- macOS 14+
- Node.js 22+
- Rust 1.77.2+
- Xcode Command Line Tools
git clone https://github.com/huzoukai/buzai.git
cd buzai
npm ci
npm run tauri -- dev构建本地 App：
npm run tauri:build -- --bundles app
open "src-tauri/target/release/bundle/macos/卜在.app"- 启动后，卜卜会悬浮在桌面上；按住角色即可拖动。
- 单击卜卜，展开番茄钟、随手记和刘海模式三个入口。
- 单击“番茄钟”立即开始专注；再次单击可暂停或继续。
- 单击“随手记”输入内容，按回车保存。
- 单击小箭头切换到刘海模式；单击刘海区域返回桌宠。
- 右键单击卜卜可打开设置、开机启动和窗口位置等选项。
- 在设置中可选择一段本地音频，作为番茄钟结束音乐；试听按钮可再次单击停止。
专注结束后卜卜会轻跳并播放用户选择的音乐。点击“停止音乐”或返回桌宠即可停止。
桌宠本身无需 Hooks 即可使用。若希望卜卜跟随编码代理切换动画，在你审阅脚本后运行：
npm run hooks:install卸载集成：
npm run hooks:remove安装器只增加本项目自己的状态 Hook，并保留其他配置。传给桌宠的内容只有提供方、 状态、匿名会话 ID 和时间戳；不会发送提示词、回复、代码、路径、命令或工具参数。 详细说明见 集成文档。
- 设置、随手记、音乐路径和状态事件保存在本机。
- 本地桥接只监听
127.0.0.1，写操作需要随机 Bearer Token。 - 不包含在线统计、账户系统、云同步或广告 SDK。
- 仓库和安装包不包含五月天歌曲或歌词。
本仓库公开源代码，但由于明确限制商业用途，它不是 OSI 定义下的开源软件。 OSI 说明，真正的开源许可证必须允许商业使用；因此这里没有继续使用会允许商用的 MIT License。
- 软件源代码： PolyForm Noncommercial License 1.0.0，仅允许非商用目的使用、修改和分发。
- 卜卜角色图、App 图标和演示截图：不包含在软件代码许可中，仅用于本非商用粉丝项目； 不授予提取、单独再发行、模型训练或商业使用权，详见 视觉素材条款。
- 第三方依赖：继续遵循各自的许可证。
商业使用、品牌合作或再发行需要另行取得书面许可，并自行完成相关角色、商标和素材的 权利确认。权利方如认为内容不妥，可通过 GitHub Issues 联系移除。
许可依据： PolyForm 官方文本、 OSI 对商业使用的说明。
npm run check
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo test --manifest-path src-tauri/Cargo.toml技术栈：Tauri 2、Rust、React、TypeScript、Vitest、SQLite 与原生 AppKit 刘海面板。