mirror of
https://github.com/carey314/mio-plugin-worker.git
synced 2026-08-10 07:04:32 +00:00
Mirror of carey314/mio-plugin-worker for plugin review
0cff83fc38
Core change: both timers stop lying when the Mac sleeps or the user walks away. Old code measured wallclock from a stored "start" timestamp, so 4 hours of lid-closed showed up as 4 hours of "sitting" and a 25-minute focus could quietly stretch across multiple hours because Timer.scheduledTimer pauses during sleep. What changed: - Sit timer now reads CGEventSource HID idle to count only seconds with real input activity. New Sources/engine/SystemIdle.swift iterates the user-input event types and takes the min. Idle ≥ 5 min resets the accumulator (counts as a real break). Tick-gap > 30 s flags a sleep/wake and clears too — covers the case where the user unlocks and idle resets to ~0 instantly. - Pomodoro switched from "decrement counter every second" to a wallclock end-time. Persisted to UserDefaults so quit/relaunch recovers correctly: still-running phases keep counting; phases whose end-time has already passed get caught up (one focus credited if missed) and the timer returns to idle. - Auto-loop with classic 4-pack rhythm: focus → short break → focus → … on the 4th focus a long break (default 15 min) replaces the short break, then the cycle resets. Default ON; toggle pill in the settings row turns it off when the user wants manual restarts. - New cycle-progress dot row (●●○○) next to the phase badge so the user can see where they are in the 4-pack at a glance. - SitView tip text rewritten to reflect the new semantics: "只统计 你真正在键盘前的时间。离开 5 分钟以上自动归零，午休/会议不会被 算进去。" User-facing wins: - Closing the lid for lunch no longer fakes 90 minutes of sitting. - A 25-min focus that survives a sleep cycle ends accurately. - Start a focus once, the rhythm runs all morning. |
||
|---|---|---|
| Sources | ||
| .gitignore | ||
| build.sh | ||
| Info.plist | ||
| LICENSE | ||
| README.md | ||
摸鱼侠 — 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.