Paimon Pal 是一款带本地派蒙桌宠的 macOS 刘海交互工具，简称 PP。它把 MacBook 屏幕顶部的物理刘海扩展为陪伴、状态提示和快捷操作入口。
当前稳定版本：0.5.1，支持 macOS 13.0+ 与 Apple Silicon。当前采用 ad-hoc 签名，尚未完成 Developer ID 正式签名和苹果公证。
当前正式版本位于 ElectronRebase/，使用 Electron 44；早期 Xcode 工程继续保留为原生可行性验证记录，不是当前安装包入口。
- Apple Music：显示歌曲、歌手、封面和进度，支持播放/暂停、上一首、下一首与拖动进度。
- 文件架：复制并暂存主动拖入或选择的文件，支持导出、拖回 Finder、AirDrop 和手动清理。
- 系统状态：显示电池、电源、音量和静音变化。
- 计时器：支持单倒计时、暂停、继续、结束提醒和重启恢复。
- 桌面宠物：从物理刘海旁出现，支持待机、自然挥手、点击、聆听、回复和成功反馈动画；使用稳定的单帧切换，避免透明序列叠加造成闪烁和重影。
- 本地陪伴：内置 Qwen3 4B Instruct 2507 4-bit 本地模型，支持结构化的最近 8 条会话上下文，复杂追问无需长时间隐藏思考即可直接回答；同时支持计时器全生命周期和 Apple Music 播放控制。
- 本地语音：内置用户选定的 P1“清脆反应感”原创幻想伙伴固定参考声纹与离线 TTS，支持流式播放、回复播报和立即停止；模型只在需要时加载，空闲五分钟后释放。
- AI 对话实验模式：手动开启后按“本机收音 → 本机语音识别 → 4B 模型回复 → 本地语音朗读”循环；派蒙朗读时暂停麦克风，最多 12 轮或 10 分钟，可随时停止。
- 本地工作台：Bento 式首页整合音乐、专注计时、系统状态、文件架、待办、随笔记、快捷启动、AI 任务提醒、录音和镜子；模块可隐藏和排序。
- 生产力工具：待办与截止时间、Markdown 随笔记、公开链接收藏、默认关闭的隐私剪贴板历史、本地录音与设备端语音识别、按需镜子、macOS Keychain 保险箱。
- AI 任务提醒：只监听
127.0.0.1:43821，支持 Codex、Claude 和 GPT 通过本机 HTTP 回调返回任务完成状态。 - 派蒙工具：可用自然语言新建待办和随笔记，以及打开工作台的指定页面。
- 设置：功能开关、音乐播放器、桌面派蒙启停、菜单栏入口、登录启动、数据目录和权限配置。
Spotify 已暂缓，不属于当前 MVP 验收范围。屏幕亮度没有面向普通第三方 App 的稳定公开通用接口，因此不显示猜测数值。
桌宠形象素材仅用于个人使用、内部验证和非商业演示，不包含公开分发或商业使用授权。
- 鼠标移到刘海，查看轻量预览。
- 点击刘海展开或收起面板。
- 右键点击刘海，打开设置或完整功能窗口。
- 也可以使用菜单栏里的 Paimon Pal 图标打开工作台、设置、暂停或退出。
首次启动会显示使用与隐私说明，但不会自动申请权限。Apple Music 自动化、通知、麦克风和语音识别权限只在使用相关功能时按需申请。
- 前往 GitHub Releases 下载
Paimon-Pal-0.5.1-arm64.dmg。 - 打开 DMG，将
Paimon Pal.app拖入“应用程序”。 - 首次启动若被 macOS 拦截，前往“系统设置 → 隐私与安全性”，选择“仍要打开”。
主安装包约 147 MB，不重复携带约 5.8 GB 的可选 4B 模型权重与 P1 语音资源；已有本地资源会继续保留。
- Paimon Pal 只复制你主动拖入或选择的文件，Finder 原文件不会被移动或删除。
- 暂存副本位于 App Sandbox 的 Application Support 目录。
- 暂存副本默认保留 24 小时，也可以在文件架中提前删除。
- 删除、过期清理和“全部清理”只处理 Paimon Pal 自己的暂存副本。
- 对话、语音识别、模型推理和语音生成都在本机完成；AI 对话实验模式不保存原始录音，流式语音块只在内存中播放，不会自动下载或上传内容。
完整说明见 PRIVACY.md。
环境要求：Node.js 22.12.0+，打包时需要 macOS 与 Xcode 命令行工具。
运行测试：
cd ElectronRebase
npm install
npm test构建 Apple Silicon Release：
cd ElectronRebase
npm run build未完成 Developer ID 签名和公证的构建可用于本机与受控分发，但首次启动需要手动确认“仍要打开”，且不能表述为经过 Apple 认证的公开商业发行版。
- CHANGELOG.md：版本说明
- PRIVACY.md：隐私、权限和本地数据边界
- SUPPORT.md：支持范围、已知问题和待补设备矩阵
- PRD-MacBook-Notch-Island-v1.0.md：产品需求文档
- 第七阶段技术开发文档-Paimon-Pal-本地生产力工作台-v1.0.md：工作台实现与安全边界
- 第七阶段验证报告-Paimon-Pal-本地生产力工作台-v1.0.md：自动测试与人工补验项
- Electron 桌面端：106 项自动检查通过，0 失败；官网：19 项测试与 ESLint 通过。
- 本地工作台 8 个页面已完成真实 UI 巡检，待办新增/保存/删除和 AI 任务回调已完成实际链路验证。
- 内置本地模型可正常加载并生成简体中文回复。
- 本地 TTS 已在 App 内完成模型预热、流式生成、分块播放、打断和空闲释放验证。
- 桌宠动画、连续聊天、上下文清理、计时工具与窗口工具均已完成本机人工验证。
0.5.1DMG 已完成签名、镜像、版本、SHA-256 与打包后实际启动验证。
上述结果来自当前 Apple Silicon 刘海屏 MacBook Pro，不代表所有机型与系统版本。