工时表助手¶

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

要使用工时表助手，请启用该功能并在计算机上安装 ActivityWatch 应用。如需跟踪浏览器活动，还应安装浏览器扩展。

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

注解

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

配置¶

激活¶

注解

仅当工时表设置中的编码方式设为小时/分钟时，工时表助手才可用。

要启用工时表助手，请前往工时表 ‣ 配置 ‣ 设置并启用工时表助手。

安装¶

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

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

小技巧

如果 Google Chrome 中未出现该弹出窗口，请按以下步骤操作：

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

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

另请参阅

ActivityWatch 文档

桌面活动¶

要跟踪在计算机应用中所用的时间，请前往工时表 ‣ 助手，点击立即开始，然后按照下方适用于您操作系统的说明安装 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] 部分，将 #cors_origins 参数更新为您的 Odoo 数据库 URL（末尾不带斜杠）：
```
[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 部分，将 #cors 参数更新为您的 Odoo 数据库 URL（末尾不带斜杠）：
```
### 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 在键盘和鼠标三分钟无操作后将用户标记为不活动，此规则匹配的活动仍会被跟踪。这对于涵盖会议等活动的规则特别有用。

小技巧

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

Example

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

名称：Customer Meeting

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

类型：视频会议

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

描述：Customer Meeting

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

始终保持活动：已启用

小技巧

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

使用¶

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

要查看建议，请前往工时表 ‣ 助手。默认情况下，建议按项目列出；点击面板右上角的按时间顺序即可切换为按时间顺序排列。

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

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

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

注解

时间取整设置适用于工时表建议。
如果鼠标或键盘三分钟或更长时间无操作，则视为不活动（即休息），除非为匹配的规则启用了始终保持活动选项。
工时表建议会根据配置的助手规则以及工时表助手中以往建议所分配的项目和任务，自动分配到项目和任务。
在根据工时表建议创建工时表条目之前，这些建议保持私密。

小技巧

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

在 GitHub 上编辑