sheepo-desktop-docs

🐑 Sheepo Desktop

A lightweight and cute macOS focus & rest companion app.
Sheepo helps you balance work and breaks by spawning sheep on your desktop shelf, rewarding completed breaks with special sheep, and unlocking cozy visual themes.

轻量可爱的 macOS 专注与休息伴侣。
Sheepo 会在桌面底部生成小羊队列，用可爱的方式记录你的专注与休息，并通过解锁新主题让休息更有价值。

---

📄 Legal

• Terms of Service

  使用条款

• Privacy Policy

  隐私政策

---

🆕 What’s New | 更新内容

v1.2.0

• Healthier Focus Reminders | 更健康的专注提醒
  Sheepo now helps you stay focused a little more healthily with new during-work reminders for water, posture, and blinking.
  Sheepo 现在会用更健康的方式陪你保持专注，新增工作中提醒：喝水、坐姿、眨眼。

• Smarter Idle Pause | 更智能的闲置暂停
  Focus now pauses more intelligently when you’re idle, but won’t interrupt your session while video or audio is playing.
  闲置暂停现在更智能：当你暂时空闲时会自动暂停，但播放视频或音频时不会中断专注。

• Cleaner Desktop Mode | 更清爽的桌面模式
  You can now hide Sheepo from Cmd+Tab and Dock for a cleaner, more distraction-free desktop setup.
  现在可选择在 Cmd+Tab 和 Dock 中隐藏 Sheepo，让桌面更清爽、干扰更少。

• General Polish | 细节优化
  Small refinements and overall improvements for a smoother, cozier experience.
  带来更多细节打磨与整体优化，让体验更顺滑、更舒适。

v1.1.4

Year of the Horse Theme Launch | 马年新年主题上线
A brand‑new Year of the Horse theme and portal animation are here.
马年新主题与传送门动画正式上线。

• Limited‑Time Deal | 限时特惠
  Unlock the Horse Year theme at 50% off until Mar 17, 2026.
  马年主题限时 5 折解锁，截止 2026 年 3 月 17 日。

• Desktop Widgets (macOS 14.0+) | 桌面 Widget（macOS 14.0+）
  Glance today’s focus/break and the last 5 days at a glance.
  一眼查看今天专注/休息与最近 5 天的小成果。

• Small Polishes | 细节优化
  Lots of small refinements for a smoother, cozier experience.
  细节体验更贴心，整体运行更顺滑。

v1.1.3

• Auto-Pause Free Roaming | 自由溜达自动暂停
  Free roaming will now auto-pause in the background to reduce memory usage and keep things smooth.
  自由溜达功能在后台会自动暂停，减轻内存负担，运行更顺畅。

• Onboarding Fixes | 新手引导问题修复
  Fixed several onboarding bugs to make the first-time experience more stable and seamless.
  修复了一些 onboarding 的问题，让首次使用流程更稳定、更顺滑。

v1.1.2

• Free Roam Mode | 牧场自由溜达
  Sheepo can now roam around your ranch! 🐑
  Sheepo 现在可以在你的牧场里到处溜达啦！不再只待在固定位置，会自己散步巡逻。

• Christmas Theme | 圣诞主题上线
  Christmas theme is here!! MERRY CHRISTMAS & HAPPY NEW YEAR! 🎄✨
  圣诞主题来啦！祝大家圣诞快乐、新年快乐！

• Data Saving Fix | 修复数据保存问题
  Fixed an issue where some data wasn’t saved correctly.
  修复了部分情况下数据没有正确保存的问题，记录更稳定了。

• Multi-Screen Language Bug Fix | 修复多屏语言显示异常
  Fixed a language display bug when using multiple screens.
  修复了在多屏幕使用时语言显示可能异常的问题。

v1.1.1

• Korean Language Support | 新增韩语界面
  Sheepo now speaks Korean! 💛 Thank you to all the new friends from Korea who joined us in version 1.1 — nearly half of our recent downloads came from Korea!
  Sheepo 现在支持韩语界面啦！💛 感谢在 1.1 版本加入的韩国朋友们，欢迎一起养羊、一起好好休息。

• Draggable Sheep Ranch | 小羊牧场自由排队
  Drag and freely arrange your Sheepo ranch — line up your sheep into any cute formations you like, and they’ll remember their spots.
  现在可以自由拖动小羊，在牧场里排出任何你喜欢的队形，小羊们会乖乖记住自己的位置。

• Adjustable Portal Countdown | 传送门倒计时可调大小
  You can now adjust the countdown timer size above the portal so it stays clear and readable, even on big or ultra-wide screens.
  传送门上方的倒计时现在可以调节大小，在大屏或超宽屏上也能清晰看到剩余时间。

• New Community Shortcuts | 一键加入 Sheepo 社群
  Jump straight to our Reddit, Discord, and Xiaohongshu from inside the app — future events, updates, and little surprises will be announced there.
  在应用内即可一键打开我们的 Reddit、Discord 和小红书账号。后续活动、更新预告和小惊喜都会优先在那边发布。

• Bug Fixes & Polish | 细节优化与问题修复
  Plus various small bug fixes and visual polish to make Sheepo feel smoother, cuter, and more reliable during your focus & rest cycles.
  同时修复了一些小问题，并打磨了细节表现，让 Sheepo 在陪你专注与休息时更加流畅稳固、萌度加倍。

v1.1

• Hide Dock Sheepo | 隐藏 Dock 上的 Sheepo
  If you prefer a clean workspace, you can now hide the Dock pet and keep Sheepo only in the menu bar.
  想要更干净的桌面，现在可以隐藏 Dock 上的 Sheepo，只在菜单栏里安静养羊。

• Smarter Break Reminder | 更聪明的休息提醒
  Optional pre-break sound and a customizable countdown “tail” help you ease out of focus instead of being startled.
  新增休息前提示音与可自定义倒计时鼠标尾巴，让专注到休息的过渡更顺滑，不再被突然打断。

• Status Bar Controls | 菜单栏一键控制
  See remaining focus time at a glance, and pause / resume / stop sessions directly from the menu bar.
  抬头就能看到剩余时间，并可在菜单栏一键暂停 / 继续 / 结束专注。

• Daily Yard Stats | 小院子「每日战绩」
  Check how many sheep you unlocked and how long you focused/rested for each day.
  按天查看解锁了多少只羊，以及当天的专注 / 休息时长，让成就感一目了然。

• Traditional Chinese & Japanese | 新增繁体中文与日语
  More friends can now use Sheepo in their own language.
  新增繁体中文和日语界面，更多伙伴可以一起养羊、一起好好休息。

---

v1.0.2

• Touch Bar Crash Fix | 触控栏机型崩溃修复
  Fixed an issue where Sheepo could crash on launch or when starting focus sessions on MacBook Pro models with Touch Bar.
  修复了在带 Touch Bar 的 MacBook 上启动或开始专注时可能出现的崩溃问题，让所有设备都能稳定养羊。

---

v1.0.1

• Onboarding Walkthrough | 新手引导流程
  First-time users will be guided through focus, rest, and unlocking via a step-by-step overlay.
  首次打开软件将进入可跳过的新手引导，体验专注、休息、解锁主题的完整流程。

• Permanent Sheepo Reward | 常驻 Sheepo 奖励
  Completing onboarding unlocks a special Sheepo that stays on your shelf permanently.
  完成引导流程后将解锁一只特殊常驻的 Sheepo，每次启动都会陪伴在你身边。

• Pause & Stop Focus | 专注中暂停 / 终止
  You can now manually pause or stop your focus session from Settings.
  可在设置中开启专注期间的暂停和终止操作，更灵活掌控节奏。

• Multi-Display Support | 多显示器支持
  Select which screen shows the shelf and portal if you have multiple monitors.
  设置中新增多屏选择功能，可指定在哪块屏幕显示横条和传送门。

• Bug Fixes & Stability | 错误修复与稳定性
  Fixed app crashes and rendering issues on certain macOS versions.
  修复部分版本下的崩溃与显示错误，提升兼容性与稳定性。

---

v1.0.0

• Focus & Rest Cycle | 专注与休息循环
  After each completed focus session, a sheep joins your shelf queue.
  每次专注完成后会有一只小羊加入桌面横条。

• Break Rewards | 休息奖励机制
  Completed breaks give you Rest Sheep; skipped breaks result in Tired Sheep.
  完成休息生成「休息羊」，跳过休息生成「累鼠了羊」。

• Always-Visible Shelf | 横条展示
  A slim bar at the bottom of the desktop displays your sheep queue: High-Energy / Tired.
  桌面底部常驻横条，展示最近的小羊队列：高能量 / 累鼠了。

• Portal Menu | 传送门菜单
  Open settings, statistics, and theme unlocks via the corner portal.
  可通过右下角传送门进入设置、查看统计信息、管理主题。

• Theme Unlock System | 主题解锁系统
  Collect Rest Sheep to unlock visual themes including doors and grounds.
  使用「休息羊」解锁门和地面的外观，丰富视觉体验。

• Initial Theme Options | 初始主题内容
  Door styles: Grass / Snow / Beach
  样式：草地 / 雪地 / 沙滩

---

👀 Preview

---

✨ Features | 功能特色

• Focus & Rest Cycles | 专注与休息循环
  Set your preferred focus duration (e.g., 25/30 minutes). After each completed session, a sheep joins your desktop shelf.
  设置专注时长（如 25/30 分钟）。每次专注完成后，会有一只小羊加入横条队列。

• **Break Rewards

  休息奖励**

  • Completed breaks → 🐑 High-Energy Sheep
  • Skipped breaks → 🐑 Tired Sheep
  • 完成休息 → 🐑 高能量羊
  • 跳过休息 → 🐑 累鼠了羊

• Always-Visible Shelf | 横条展示
  A slim bar at the bottom of the desktop displays your sheep queue: High-Energy / Tired.
  桌面底部常驻横条，展示最近的小羊队列：高能量 / 累鼠了。

• Portal Menu | 传送门菜单
  A magical portal in the corner opens:

  • ⚙️ Settings

    设置

  • 📊 Statistics (daily work and rest time)

    统计（每日工作与休息时长）

  • 🎨 Themes

    主题

• Theme Unlocks | 主题解锁
  Collect Rest Sheep to unlock new doors and backgrounds:
  使用「休息羊」解锁全新外观：
  • 门的样式
  • 地面背景

---

🛠 Tech Stack | 技术栈

• SwiftUI (UI) + AppKit (macOS integration)
• Rive Runtime (animations)
• Firebase (analytics & first-launch events)

---

Maintainer

维护者: @maliaguaguahhh