什么是macos-suite-readonly
macOS Suite Readonly 是一个专为 macOS 系统设计的轻量级命令行工具套件，旨在为开发者、自动化脚本或智能助手提供对系统关键信息的只读访问能力。该工具通过简洁的 Python 脚本调用，能够安全地从 Mail（邮件）、Calendar（日历）、Notes（备忘录）和 Stocks（股票行情）四个核心应用中提取结构化数据，并以标准 JSON 格式输出，极大地方便了后续的数据解析与集成。其设计遵循最小权限原则，所有操作均为只读模式，不会对用户数据进行任何修改，确保了隐私与安全。首次使用时需注意系统可能弹出自动化权限请求，若未授权将导致功能受限。整体架构清晰，命令统一，非常适合构建个人效率工具链或作为 Agent 智能体的外部信息源，帮助实现如‘今日待办提醒’、‘未读邮件统计’或‘股价监控’等场景化应用。
核心功能特点
- 支持读取 Mail 应用的未读邮件数量及列表，可自定义返回条目上限。
- 提供 Calendar 日程查询功能，包括当天所有事件及指定时间范围内的详细安排。
- 内置 Notes 备忘录搜索能力，支持按关键词检索并限定文件夹范围。
- 集成 Stocks 股票行情接口，可获取单支或多支股票的实时报价信息，兼容 A股与美股代码格式。
- 所有查询结果均以单一 JSON 对象形式输出，便于程序化解析与处理。
- 采用统一的命令行调用方式，参数灵活配置，适合集成到自动化工作流中。
适用场景
该工具特别适合需要快速获取 macOS 系统状态信息的开发者和高级用户。例如，在编写个人效率脚本时，可通过调用 `mail.unread_count` 命令实时统计邮箱中的未读邮件数量，结合通知机制实现高效的信息管理；对于日程繁忙的用户，利用 `calendar.today` 可一键拉取当日所有会议与任务，避免遗漏重要安排。在知识管理方面，借助 `notes.search` 功能，用户能迅速定位特定主题的备忘录内容，提升信息检索效率。此外，对于关注金融市场动态的投资者，`stocks.quote` 命令提供了便捷的股价查询入口，无论是追踪 AAPL 还是贵州茅台（600519），都能在终端即时呈现最新行情。这些功能共同构成了一个强大的系统信息聚合平台，广泛应用于自动化办公、智能家居中枢、个人仪表盘搭建以及智能问答系统等多元化场景中，显著提升了基于本地数据的智能化响应能力。