摸鱼侠 — Worker Toolkit for MioIsland

Office-survival toolkit in your notch. Five tabs cover the everyday rhythm of a desk job: pomodoro focus, sit-up reminder, water hydration tracker, clock-out countdown, and weekend countdown.

100% local. No network, no API keys, no telemetry.

Features

• 🍅 番茄钟 — 25/5 minute focus/break cycles, big circular ring timer, pause/resume/reset, today's pomodoro tally + focus minutes, ±5min and ±1min steppers.
• 🪑 久坐提醒 — count-up "已坐 X 分钟" since you last broke, configurable trigger interval (default 45 min), red status pill
  • dock bounce when you cross the threshold.
• 💧 喝水追踪 — animated water-level cup glyph, today's tally with progress dots, 加一杯 / 撤销 buttons, configurable goal (default 8 cups).
• 🏃 下班倒计时 — live H:M:S countdown to your clock-out hour, gradient bar fills 0→1 across a 9-hour anchor, in-panel hour and minute steppers.
• 🎉 周末倒数 — 天/时/分 to next Saturday 00:00 with a rotating 打工语录 that's stable per day.

Notifications

Uses UNUserNotificationCenter for sit-up and pomodoro alerts. If notification authorization is denied, falls back to NSApp.requestUserAttention(.criticalRequest) — your dock icon bounces and the menu bar status dot flips red, so the reminder never silently misses.

Persistence

All preferences stored in UserDefaults(suiteName: "com.mioisland.plugin.worker"):

• Pomodoro count history (per-date dict)
• Focus / break minute settings
• Sit-up start timestamp + trigger interval
• Water cups today + daily goal
• Clock-out time (HH:mm)

Requirements

• macOS 15.0+
• MioIsland v2.2.0+

Building from source

./build.sh           # produce build/worker.bundle + build/worker.zip
./build.sh install   # build + copy to ~/.config/codeisland/plugins/

Restart MioIsland (Cmd+Q + reopen) to load the new build.

Structure

Sources/
├── MioPlugin.swift             # protocol (verbatim from host)
├── WorkerPlugin.swift          # principal class
├── ui/
│   ├── ExpandedView.swift      # 380×620 panel + 5-tab pill strip
│   ├── PomodoroView.swift      # circular ring timer
│   ├── SitView.swift           # count-up + threshold alert
│   ├── WaterView.swift         # animated cup with water fill
│   ├── ClockoutView.swift      # gradient countdown bar
│   ├── WeekendView.swift       # purple hero countdown
│   └── Theme.swift             # design tokens
└── engine/
    ├── WorkerStore.swift       # @MainActor state surface, 1Hz tick
    ├── NotificationCenter.swift # UN wrapper + dock bounce fallback
    └── WorkerDebugLog.swift    # /tmp/worker-plugin.log

License

MIT — see LICENSE.