MioCal 妙历
Support / 支持
MioCal 妙历 · A calendar in your Mac menu bar.
Private support and privacy requests: dev@aireels.top.
For non-sensitive bug reports, use GitHub Issues. Never post private calendar URLs, access tokens, event content or diagnostic reports containing personal data in a public issue.
Getting started
MioCal runs in the menu bar and normally has no Dock icon. Click its menu bar date to open the calendar; right-click to open Settings, Privacy, Licenses or Quit. The default shortcut is Shift–Command–X and can be changed in Settings.
Events and permissions
Enable Calendar access in the calendar settings to display your system events. You may decline and still use local events and external subscriptions. If events are missing, check permission in System Settings → Privacy & Security → Calendars and confirm that the calendar, subscription or local group is enabled in MioCal.
Subscriptions
Use an HTTPS or webcal iCalendar subscription URL, not a web page link. The provider must return a valid VCALENDAR file, at most 20 MB. Unsupported recurrence rules or time zones are reported rather than silently replaced. Built-in recommendations are third-party services whose availability may change.
Location and astronomical times
Enable Location only if you want local astronomical calculations. Verify location and calculation settings before relying on religious or astronomical times. If location is unavailable, the fallback location is Beijing.
Contacting us
Please include your MioCal version, macOS version, the steps to reproduce the issue, and the expected result. Redact private data from screenshots and logs. A small synthetic calendar file is preferable to a private real calendar.
开始使用
妙历运行于 Mac 菜单栏，通常不显示 Dock 图标。点击菜单栏日期打开日历；右键打开设置、隐私政策、许可声明或退出。默认快捷键为 Shift–Command–X，可在设置中调整。
事件、订阅和定位
在日历设置中按需授权系统日历，拒绝授权仍可使用本地事件和外部订阅。检查日历、订阅及本地事件组是否已启用。订阅需要返回 VCALENDAR 文件的 HTTPS 或 webcal 地址，大小不超过 20 MB，普通网页不能作为订阅。第三方推荐服务可能变化，无法支持的时区或重复规则会明确报错。定位仅用于可选的本地天文计算；定位失败可能使用北京作为默认位置，请核对位置及计算设置。
反馈和隐私
私密支持与隐私请求请发送至 dev@aireels.top；不含敏感内容的问题可提交至 GitHub Issues。请说明应用版本、macOS 版本、复现步骤与预期结果，截图和日志请先脱敏。不要公开私有订阅地址、令牌、真实事件或个人资料；建议使用虚构事件制作最小复现样例。