PetPhrase

---

✨ 它长什么样

桌宠静坐桌面	点它,面板贴宠弹出	挑选桌宠、调大小	管理分组与常用语

🚀 快速上手

1. 从 Releases 下载 PetPhrase_x.y.z_x64-setup.exe,双击安装(装到用户目录,无需管理员权限)

   ⚠️ 首次运行会出现 Windows 风险提示:安装包未购买代码签名证书,SmartScreen 会弹「Windows 已保护你的电脑」。点 「更多信息」→「仍要运行」 即可。代码全部开源,安装包由本仓库源码构建,可自行审计或从源码构建。

2. 桌面右下角出现一只桌宠——点击它,弹出常用语面板

3. 点右上角 ⚙ 打开设置,建分组、加常用语(支持多行文本)

4. 之后每次点桌宠 → 点短语 → 已复制 ✓,直接去粘贴

🎯 功能

• 桌宠:内置七彩玻璃泡泡默认宠;透明置顶,按 petdex 标准动作表播放——点击招手、打开面板时等待、编辑时审阅、复制失败时沮丧,闲时随机彩蛋;可拖拽并记住位置,大小三档可调,缩放时脚位不动
• 在线宠物库:设置里直接浏览、搜索、一键安装 petdex 上的数千只桌宠;不想要的在「已安装」里一键删除
• 常用语面板:贴宠弹出;分组胶囊 Tab + 全组宫格;短句排成气泡流、长句卡片;搜索跨组过滤;点击复制 + ✓ 反馈 + 自动收起;失焦即隐
• 📌 面板常驻:点亮图钉后连续复制多条不收起,拖动桌宠面板实时跟随;再点图钉/点桌宠/Esc 收起
• 右键就地管理:面板里右键短语可直接编辑/删除,右键空白处快速添加,弹出即可输入,不用打开设置窗
• 分组管理:增删改、长按拖动排序、12 个分组图标
• 主题:亚克力磨砂 / 实底浅色两种面板主题
• 托盘或任务栏:图标放托盘(左键显示/隐藏宠物,右键菜单)或任务栏(像普通程序一样单击显示/隐藏),设置里二选一
• 数据:开机自启可选;JSON 导入导出;数据原子写入 + 启动备份自动恢复,卸载重装不丢
• 一键更新:自动/手动检查新版本(可关),一键下载校验并静默升级,装完自动回到桌面
• 标准安装/卸载:NSIS 安装包,含 uninstall.exe 与「应用和功能」卸载入口,卸载时可选保留数据

🐱 换一只喜欢的桌宠

PetPhrase 兼容 petdex 桌宠格式——那个在 X 上火过的 Codex 桌宠生态。

打开 PetPhrase 设置 →「桌宠」→「发现更多」,直接浏览、搜索 petdex 上的全部桌宠,点「安装」即下载并切换,无需 Node.js、无需重启。同页右上角可调桌宠大小(小/中/大)。

习惯命令行也可以用官方 CLI(需要 Node.js),装好的桌宠同样会出现在「已安装」里:

npx petdex@latest install kun-like

也支持完全自定义:任意目录放上 pet.json + spritesheet.webp/png(参考 petdex 格式,支持 8×9 与 8×11 图集),在「桌宠」页点「从文件夹添加宠物…」即可。

📋 使用示例

给客服 / 运营 / 开发同学的分组灵感:

分组	示例短语
💬 客服	「您好,感谢您的反馈,我们已经记录了这个问题,会尽快给您答复」
📧 邮件	「收到,马上处理」「好的,没问题」
💻 代码	git rebase -i HEAD~3、常用正则、SQL 片段
💳 账号	发票抬头、收货地址、公司税号

短句(≤10 字)自动排成紧凑气泡流,长文本独占卡片,一眼扫到。

🖥️ 平台支持

目前仅支持 Windows 10/11 x64,暂无 macOS / Linux 版本。

好消息是:UI 框架 Slint 本身跨平台,核心逻辑(存储/布局/动画)与平台无关,移植的主要工作量在窗口特效(亚克力/点击穿透)、托盘、开机自启的平台适配。欢迎 macOS / Linux 用户提 PR! 提前开 Issue 讨论方案更好。

🔧 从源码构建

需要 Rust stable 工具链(Windows MSVC)。

cd app-slint
cargo test                # 单元测试
cargo build --release     # 产出 target/release/PetPhrase.exe
# 打包安装程序(需 NSIS makensis):
makensis installer.nsi    # 产出 target/PetPhrase_<版本>_x64-setup.exe

数据文件位于 %APPDATA%\PetPhrase\{phrases.json, settings.json}。

🤝 贡献

• 🐛 报 Bug / 提需求:Issues 欢迎任何反馈,中文英文都行
• 🔀 提 PR:改动前跑一遍 cargo test;涉及 UI 手感的改动建议附截图/录屏
• 🍎🐧 平台移植:macOS / Linux 适配是最受欢迎的贡献方向
• ⭐ 觉得好用? 点个 Star 是最直接的支持

🙏 致谢

• 桌宠格式与生态来自 petdex(crafter-station/petdex)
• UI 框架 Slint · 图标 Lucide

📄 许可

MIT © 2026 chengbuilds