Klokki 是一款专为 macOS 设计的时间追踪与项目管理工具，以其与 macOS 系统深度集成、简洁直观的界面和强大的自动化追踪功能而著称。它尤其适合自由职业者、远程团队和需要精确记录工作时长的专业人士，帮助用户无缝追踪项目时间，生成清晰报告，并提升工作效率。

一、核心界面与工作区详解

Klokki 的界面设计遵循 macOS 的设计规范，主要分为以下几个核心区域：

菜单栏图标：启动后，Klokki 的图标会常驻在屏幕顶部的菜单栏。这是软件的控制中枢，点击可展开快捷操作菜单，用于快速启动/停止计时、切换项目，无需打开主窗口。
主窗口：
- 项目列表区：位于窗口左侧，以树状结构展示所有创建的项目、客户和标签。您可以在此进行项目的组织与管理。
- 时间条目列表区：占据窗口主要部分，以表格形式清晰展示所有已记录的时间条目，包括对应的项目、开始与结束时间、持续时长、备注等信息。
- 计时控制栏：通常位于窗口顶部或底部，包含“开始/停止”计时按钮、当前活动项目选择器以及手动添加入口。
- 统计与报告面板：通过标签页或侧边栏切换，可以查看今日、本周或自定义时间段的时间汇总图表和详细数据。
系统级集成：Klokki 的特色在于其“自动追踪”功能。它可以与特定的应用程序（如 Xcode、Figma、Adobe系列）或网站关联，当您使用这些预设程序时，Klokki 可自动开始计时，并在您切换程序时自动暂停或停止，实现无感化时间记录。

二、完整工作流程：从创建项目到导出报告

步骤一：创建与组织项目

步骤二：开始时间追踪

Klokki 提供三种追踪方式：

手动计时：
- 在主窗口的计时控制栏，从下拉菜单中选择一个项目。
- 点击旁边的 “开始” 按钮（绿色三角形）或使用全局快捷键 Control + Command + S 开始计时。
- 工作结束后，点击 “停止” 按钮（红色方块）或再次按下 Control + Command + S。
通过菜单栏快速操作：
- 点击菜单栏 Klokki 图标，在弹出菜单的顶部选择项目，然后点击 “开始 [项目名]”。
- 停止时，再次点击图标并选择 “停止计时”。
自动追踪：
- 前往 Klokki 菜单 > 偏好设置 (Command + ,) > “自动追踪” 标签页。
- 点击“+”添加规则，指定当某个应用程序（如“Safari”）或特定网站（如“figma.com”）处于活动状态时，自动关联到哪个项目进行计时。
- 启用此规则后，当您打开指定应用或网站，Klokki 将自动开始计时，无需手动操作。

步骤三：编辑与管理时间条目

步骤四：生成与导出报告

利用标签进行多维分类：除了项目，您可以为时间条目添加多个标签（如“设计”、“会议”、“修订”）。在编辑条目或通过快捷键 Command + L 快速添加。在报告筛选时，可以按标签进行过滤，获得更深入的分析。
全局计时快捷键：无论处于任何应用程序中，Control + Command + S 都是启动/停止当前活动计时的最快方式。您可以在“偏好设置 > 通用”中自定义此快捷键。
计时器提醒功能：在偏好设置的“提醒”中，可以设置定时提醒。例如，每工作50分钟提醒休息，防止长时间工作。
数据备份与同步：Klokki 的数据文件默认存储在本地。为了安全，建议定期通过“文件 > 备份数据库”进行手动备份。虽然 Klokki 本身不提供云同步，但您可以将备份文件置于 iCloud Drive 或 Dropbox 文件夹以实现跨 Mac 的数据同步。

问题现象	可能原因	解决方案
菜单栏图标不显示	Klokki 未在登录项中设置，或系统权限问题。	1. 确保 Klokki 已在“系统设置 > 通用 > 登录项”中启用。 2. 重启 Klokki 应用。
自动追踪功能不工作	未授予 Klokki 辅助功能权限。	前往“系统设置 > 隐私与安全性 > 辅助功能”，确保 Klokki 已在列表中并被勾选。然后重启 Klokki。
快捷键失效	与其他应用程序快捷键冲突。	进入 Klokki 的“偏好设置 > 通用”，修改为未被占用的自定义快捷键组合。
报告中的时间总计不准确	存在重叠的时间条目或未停止的计时器。	检查时间条目列表，确保没有时间段相互重叠。并确认所有计时器都已正确停止。