工时单助手¶

工时单助手使用 ActivityWatch 监控计算机和浏览器活动，以生成工时单条目建议，从而简化工时单记录。

要使用工时单助手，请激活该功能，并在您的计算机上安装 ActivityWatch 应用。如果需要跟踪浏览器活动，还请安装浏览器扩展程序。

工时单建议根据助手规则以及 Odoo 中的日历事件和计划生成，然后匹配到项目和任务，并会考虑之前已匹配的建议。您可以直接在工时单助手视图中查看这些建议并将其转换为工时单条目。

注解

所有活动数据均在用户设备上本地处理，绝不会与其组织内部或外部的任何人共享。

配置¶

激活¶

注解

只有在工时单设置中将录入方式设置为小时 / 分钟时，工时单助手才可用。

要启用工时单助手，请转到工时单 ‣ 配置 ‣ 设置，并启用工时单助手。

安装¶

工时单助手通过 ActivityWatch 应用（用于计算机活动）和浏览器扩展程序（用于浏览器活动）跟踪用户活动。要安装工时单助手，请按以下步骤操作：

转到工时单 ‣ 助手。
如果浏览器显示弹窗，请求访问您设备上的应用和设备，请点击允许。
请按照桌面活动（必选）和浏览器活动（可选）的安装步骤操作。

小技巧

如果 Google Chrome 中未显示弹窗，请按以下步骤操作：

点击地址栏左侧的调节图标（查看网站信息）。
点击网站设置。
在权限列表底部，将设备上的应用字段设置为允许。
刷新 Odoo 工时单页面。

要在 Mozilla Firefox 中授予此权限，请参阅 Mozilla 文档。

桌面活动¶

要跟踪在计算机应用中花费的时间，请转到工时单 ‣ 助手，点击立即开始，并按照下方适用于您操作系统的说明安装 ActivityWatch 应用。

注解

支持的最低版本为 Windows 10、macOS 10.15 和 Ubuntu 22。

在安装工时单助手窗口中，在桌面活动部分点击下载 Windows 版，然后选择您的操作系统版本。

小技巧
Windows 安装包也可以直接下载。
安装该安装包并按照说明操作。
安装完成后，请重启计算机，或注销后重新登录。
访问 Odoo 数据库，转到工时单 ‣ 助手，然后点击立即开始。
点击两次下一步。
在配置 CORS 窗口中，点击（复制）图标以复制 Odoo 数据库 URL。
点击打开设置。
在 ActivityWatch 网页上，向下滚动到服务器设置部分，然后将 Odoo 数据库 URL 粘贴到 CORS 字段中。
返回工时单助手弹出窗口，点击两次下一步。
点击测试连接，验证 Odoo 数据库与 ActivityWatch 服务器之间的连接。

下载适用于 macOS 的 ActivityWatch 安装包。
打开下载的 .dmg 文件，并将 ActivityWatch 应用移动到您的应用程序文件夹中。
启动 ActivityWatch。
点击菜单栏中的 ActivityWatch 图标，选择模块菜单，然后启用以下选项之一：
- Python 服务器（aw-server）（默认服务器）
- Rust 服务器（aw-server-rust）（更高效的服务器）
点击菜单栏中的 ActivityWatch 图标，选择打开配置文件夹。
根据之前选择的选项配置服务器：

Python 服务器配置
1. 在 activitywatch 文件夹中，打开 aw-server 文件夹，然后打开 aw-server.toml 文件。
2. 在 [server] 部分中，使用您的 Odoo 数据库 URL 更新 #cors_origins 参数，末尾不要带斜杠：
```
[server]
#host = "localhost"
#port = "5600"
#storage = "peewee"
#cors_origins = "https://your-odoo-database-url.com"
```
3. 保持其余参数不变，然后保存文件。
Rust 服务器配置
1. 在 activitywatch 文件夹中，打开 aw-server-rust 文件夹，然后打开 config.toml 文件。
2. 在 DEFAULT SETTINGS 部分中，使用您的 Odoo 数据库 URL 更新 #cors 参数，末尾不要带斜杠：
```
### DEFAULT SETTINGS ###
#address = "127.0.0.1"
#port = 5600
#cors = ["https://your-odoo-database-url.com"]
#
#[custom_static]
```
3. 保持其余参数不变，然后保存文件。
重启 ActivityWatch 应用。

注解

ActivityWatch 还提供多种专门用于特定活动的监视器，可手动安装。使用更多活动监视器可让工时单助手提供更准确的结果。

浏览器活动¶

您可以选择安装 ActivityWatch 浏览器扩展，以跟踪在浏览器标签页和网站上花费的时间。

要从 Odoo 安装该扩展，请按以下步骤操作：

转到工时单 ‣ 助手。
点击屏幕右侧的（设置）图标，然后选择安装助手。
在安装工时单助手窗口中，根据您使用的浏览器，在浏览器活动部分点击 Firefox 或 Chrome 扩展按钮。
对于 Chrome，点击添加至 Chrome，然后点击添加扩展程序；对于 Firefox，点击添加到 Firefox，然后点击添加。

注解

工时单助手浏览器扩展仅适用于 Google Chrome 和 Mozilla Firefox。您也可以从各自的应用商店页面安装 Firefox 和 Chrome 扩展。

助手规则¶

助手规则使用正则表达式（regex）来定义 Odoo 如何解读桌面活动和浏览器活动，并将其转换为工时单条目建议。

这些规则充当 关键事件：一旦触发某个关键事件，之后任何至少持续一分钟的活动都会与该事件关联，直到匹配的规则触发新的关键事件为止。系统预配置了若干规则，可用于跟踪在 Odoo、GitHub、Google Docs、Gmail、Google Meet 和 Discord 中花费的时间。

小技巧

正则表达式功能强大但较为复杂。RegexOne 提供了交互式练习，帮助您学习正则表达式。
添加更多规则可以提高工时单建议的精确度，并减少简短或不相关条目的影响。

要创建或编辑助手规则，请转到工时单 ‣ 配置 ‣ 助手规则，然后点击新建或选择一个现有规则，并填写或编辑下述字段。

名称：规则的名称。
正则表达式：用于与 ActivityWatch 事件（窗口名称、标签页名称或 URL）匹配的模式，以便将活动识别并归类为关键事件，并在工时单助手中显示。
类型：决定工时单助手的建议列表中匹配条目所显示的图标。
模板：定义生成的工时单条目的名称。它还会被本地规则用于进一步处理。如果留空，则改用规则的名称。
描述：在工时单助手中显示的标签，仅用于展示。
始终活动：启用后，即使 ActivityWatch 在键盘和鼠标连续三分钟无操作后将用户标记为非活动状态，也会跟踪此规则匹配的活动。这对于涵盖会议等活动的规则尤其有用。

小技巧

要为匹配活动创建的工时单条目设置默认项目和任务，请点击列表标题栏中的（附加选项）按钮，启用项目和任务，然后在列表视图的字段中选择所需的值。

示例

以下示例为 Google Meet 配置一条规则。当 ActivityWatch 识别到与此正则表达式匹配的 Google Meet 视频会议时，工时单助手会将其标记为关键事件。

名称：Customer Meeting

正则表达式：meet - (.*)|https://meet.google.com

类型：视频会议

模板：Customer Meeting ($1)（指正则表达式中第一个分组捕获的值）

描述：Customer Meeting

项目和任务：留空，因为每次会议可能关联不同的客户或任务

始终活动：已启用

小技巧

要查看 ActivityWatch 检测到的关键事件列表，以及根据所配置的助手规则和/或过去建议的工时单条目分配给这些事件的项目和任务，请激活开发者模式，然后转到工时单 ‣ 配置 ‣ 本地助手规则。

使用¶

工时单助手完成配置后，每天启动时会自动跟踪计算机活动和浏览器活动（若适用），并检查 Odoo 中的日历事件和计划。当被跟踪活动的持续时间超过一分钟时，系统会根据 ActivityWatch 检测到的关键事件生成工时单条目建议。

要查看建议，请转到工时单 ‣ 助手。默认情况下，建议会在按项目视图中列出；点击面板右上角的时间顺序，即可切换为按时间顺序排列。

要根据一个或多个建议创建工时单条目，请在列表中点击相关建议，必要时在左侧窗格中编辑字段，然后点击创建。

要删除某条建议，请将鼠标悬停其上并点击移除。要一次删除多条建议，请在列表中选中它们，然后点击视图顶部的删除。

要编辑或删除现有的工时单条目，请在左侧窗格中点击该条目，进行必要的更改，然后点击保存或点击删除。

注解

时间取整设置适用于工时单建议。
如果三分钟或更长时间没有鼠标或键盘活动，则会被视为非活动状态（即休息），除非为匹配的规则启用了始终活动选项。
工时单建议会根据已配置的助手规则以及工时单助手中过去建议所分配的项目和任务，自动分配到相应的项目和任务。
在根据建议创建工时单条目之前，工时单建议始终保持私密。

小技巧

要查看 ActivityWatch 记录的数据，请激活开发者模式，转到工时单 ‣ 助手，然后点击建议列表底部的查看 ActivityWatch 数据。