utrello/README.md

UTrello

一个运行在 macOS 桌面的本地 Trello 风格任务看板，附带 WidgetKit 小组件。

功能

• 三列任务看板：待办、进行中、完成
• 新增、移动和删除任务
• 桌面小组件显示未完成任务及其数量
• 任务数据只保存在本机；主应用和 Widget 通过 App Group 共享数据
• 主应用更新任务后，主动请求系统刷新小组件

技术要求

• macOS 14 Sonoma 或更高版本
• Xcode 15 或更高版本
• 可用于代码签名的 Apple 开发团队

本地运行

1. 在 Mac 上用 Xcode 打开 UTrello.xcodeproj。
2. 选择 UTrello target，在 Signing & Capabilities 中选择开发团队。
3. 对 UTrelloWidget target 重复上一步。
4. 在两个 target 的 App Groups capability 中，将 group.com.example.utrello 改为该开发团队已注册的 App Group 标识。
5. 将 TaskStore.swift 中的 groupIdentifier 改为同一个标识。
6. 选择 UTrello scheme 后运行。首次运行成功后，在 macOS 的组件库中将 UTrello Tasks 添加到桌面。

数据与刷新

任务以 JSON 形式写入 App Group 的 UserDefaults。Widget 会在任务变更时请求刷新，并会由系统每 15 分钟兜底刷新一次；实际刷新时机仍由 macOS 调度。

当前限制

• 这是纯本地应用，不会同步真实 Trello 服务。
• Widget 以浏览为主，复杂操作在主应用内完成。