概述
Kanban Pro 提供原生 macOS 小组件，让你在桌面或通知中心一目了然地查看项目状态。无需打开应用即可查看按列的任务数、即将到期的日期等信息。
要求
Kanban Pro 小组件需要 macOS 14 Sonoma 或更高版本。快速添加工单和在列之间移动工单等交互式小组件功能需要 macOS 15 Sequoia 或更高版本。
可用的小组件尺寸
| 尺寸 | 尺寸 | 显示内容 |
|---|---|---|
| 小 | 正方形 | 总工单数和项目名称。看板的一个紧凑状态指示器。 |
| 中 | 横向矩形 | 每列工单数和横向条形图。一目了然地查看工作流分布。 |
| 大 | 纵向矩形 | 列数加上即将到期的日期。列出接下来的 5 张工单及其截止日期，按紧急程度排序。 |
所有小组件尺寸都显示项目名称，并在看板更改时自动更新。你可以添加多个小组件实例——例如，每个项目一个——并独立配置每个。
将小组件添加到桌面
- 在桌面上右击(按住 Control 点击)并从上下文菜单中选择编辑小组件…。或者，点击菜单栏中的日期和时间以打开通知中心，然后向下滚动并点击编辑小组件。
- 在小组件库中搜索 Kanban Pro。你可以在搜索字段中输入 "Kanban"，或在可用应用列表中滚动。
- 选择小组件尺寸。你将看到小、中、大小组件的预览。点击你喜欢的尺寸上的+按钮，或将其拖到桌面上的特定位置以精确放置。
- 放置小组件。将小组件拖到桌面上你喜欢的位置。macOS 会与其他小组件一起将其对齐到网格。
- 配置小组件。右击小组件并选择编辑 "Kanban Pro"。选择小组件应显示的项目文件夹。如果你有多个项目，可以添加多个小组件——每个项目一个。
提示
macOS 14 Sonoma 引入了桌面小组件。如果你运行的是 macOS 13 Ventura 或更早版本，小组件仅在通知中心中可用。
将小组件添加到通知中心
- 点击菜单栏右上角的日期和时间以打开通知中心。
- 向下滚动到小组件区域底部并点击编辑小组件。
- 在库中找到 Kanban Pro，选择你喜欢的尺寸，然后点击+添加它。
- 点击"完成"保存你的布局。小组件将显示在你的通知中心中，与其他小组件一起。
macOS 15 Sequoia 上的交互式小组件
在 macOS 15 Sequoia 及更高版本上，Kanban Pro 小组件支持直接从桌面进行交互式操作——无需先打开应用。
- 快速添加:点击快速添加小组件中的列按钮以在该列中创建新工单。Kanban Pro 将打开并预填充新工单对话框。
- 移至下一列:任务列表小组件显示来自选定列的最多 7 张工单。点击任何工单上的移动按钮以将其推进到工作流中的下一列。变更将在几秒内显示在你的看板上。
提示
在 macOS 14 Sonoma 上，点击小组件会打开 Kanban Pro。在 macOS 15 Sequoia 上，交互式按钮直接执行操作——应用仅在导航到特定工单时打开。
小组件如何保持同步
Kanban Pro 小组件直接从磁盘上的项目文件夹读取数据。当你在应用中添加、移动或完成工单时，小组件会检测文件系统更改并刷新其显示。
- 本地项目:更新在几秒内显示。
- 云同步项目:云提供商将更改的文件同步到你的 Mac 时，小组件会立即刷新。在 iCloud Drive 或 Dropbox 上通常需要几秒钟。
macOS 还会按自己的计划定期刷新小组件(通常每 5-15 分钟)。如果需要立即刷新，你可以打开 Kanban Pro 的设置 → 小组件选项卡并点击立即同步小组件。
提示
小组件以只读方式读取你的项目数据(Sequoia 上的交互式功能除外)。标准小组件不会修改你的工单文件或看板配置。
配置小组件偏好设置
每个小组件实例可以独立配置。有两种方式调整偏好设置:
从小组件本身
右击小组件并选择编辑 "Kanban Pro"以选择小组件应显示的项目文件夹。
从 Kanban Pro 应用
打开 Kanban Pro 的设置 → 小组件选项卡(仅在 macOS 上可见)以获取更详细的配置:
- 启用小组件集成:打开或关闭小组件支持。
- 项目文件夹:选择要显示的 Kanban Pro 项目。
- 默认列:选择任务列表小组件默认显示的列。
- 最多显示工单数:限制任务列表小组件中显示的工单数(3、5、7 或 10)。
- 显示字段:切换是否在小组件工单行上显示优先级、负责人、截止日期和标签。
- 要显示的列:在中等和大小组件上，选择在计数分类中出现的列。
- 截止日期范围:在大小组件上，设置截止日期列表应查看的前向时间(例如接下来 7 天、接下来 14 天或所有即将到期)。
小组件偏好设置在更改时自动保存。点击立即同步小组件以立即将更新推送到你的小组件。
故障排除
- 小组件显示 "未选择项目":右击小组件，选择编辑 "Kanban Pro"，然后选择你的项目文件夹。
- 小组件不更新:确保项目文件夹可访问。如果它在云驱动器上，请检查同步是否处于活动状态。你也可以尝试删除并重新添加小组件，或在设置 → 小组件中点击立即同步小组件。
- 小组件未出现在库中:确保你运行的是 macOS 14 Sonoma 或更高版本，并且 Kanban Pro 是从 Mac App Store 安装的。如果在新安装后小组件库中仍未列出 Kanban Pro，请尝试重启 Mac。
- 交互式按钮不工作:交互式小组件功能(快速添加、移至下一列)需要 macOS 15 Sequoia 或更高版本。在 macOS 14 上，点击小组件会打开应用。
- 计数似乎已过期:macOS 控制小组件刷新时间(通常每 5-15 分钟)。要获得最新数据，请直接打开 Kanban Pro 应用或点击设置中的立即同步小组件。小组件将在下一个刷新周期追上进度。
- 低电耗模式减缓更新:启用低电耗模式时，macOS 会减少后台活动，这可能会延迟小组件刷新。在系统设置 → 电池中禁用低电耗模式以获得更频繁的更新。
- 多个小组件显示同一项目:每个小组件实例都是独立配置的。右击每个小组件并选择编辑 "Kanban Pro"为每个选择不同的项目或列。