mirror of
https://github.com/carey314/mio-plugin-worker.git
synced 2026-08-10 07:04:32 +00:00
959580c55e
Office-survival toolkit. Five tabs in the notch: - 🍅 番茄钟: 25/5 focus/break with circular ring timer + tally. - 🪑 久坐: count-up since last break, dock-bounce alert at 45min. - 💧 喝水: animated cup, daily goal tracking with progress dots. - 🏃 下班: H:M:S countdown to clock-out hour with gradient bar. - 🎉 周末: 天/时/分 to next Saturday + rotating 打工语录. 100% local. UNUserNotificationCenter for alerts, dock-bounce fallback when authorization denied. UserDefaults persistence. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
80 lines
2.8 KiB
Markdown
80 lines
2.8 KiB
Markdown
# 摸鱼侠 — 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
|
||
|
||
```bash
|
||
./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](LICENSE).
|