> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AgencyHandy 中的时间跟踪和工时表管理

> 在 AgencyHandy 中使用实时计时器或手动录入记录工时，按任务、成员或服务筛选工作日志，并将工时表数据导出为 CSV 或 XLSX。

AgencyHandy 中的工时表功能为您提供了一个集中面板，用于跟踪团队在任务上花费的每一小时。您可以对任意任务启动实时计时器，通过手动录入事后记录工时，然后按日期范围、团队成员或服务对数据进行切片分析。当您需要报告工作效率或按时间收费时，只需几次点击即可将所有内容导出为 CSV 或 XLSX。这是确保团队问责制和时间计费准确性的核心工具。

## 谁可以使用工时表功能

| 功能        | 超级管理员 | 管理员 | 项目经理 |  员工 |
| --------- | :---: | :-: | :--: | :-: |
| 查看自己的工时日志 |   ✅   |  ✅  |   ✅  |  ✅  |
| 代他人记录工时   |   ✅   |  ✅  |   ✅  |  ❌  |
| 编辑工时条目    |   ✅   |  ✅  |   ✅  |  ❌  |
| 导出工时表数据   |   ✅   |  ✅  |   ✅  |  ❌  |

<Note>
  任务必须存在才能对其进行时间跟踪。请确保在尝试记录工时之前，已在订单中创建任务。
</Note>

## 查看工时表

<Steps>
  <Step title="打开工时表">
    点击主左侧边栏中的 **工时表**。您将看到一个列出团队所有工时日志的表格。

    每一行显示日期、团队成员、任务名称、服务、已记录工时以及附加到条目的任何备注。
  </Step>
</Steps>

## 添加工时条目

您有两种记录工时的方式：用于进行中工作的实时计时器，或用于已完成工时的手动录入。

<Tabs>
  <Tab title="启动计时器">
    <Steps>
      <Step title="选择任务">
        在工时表视图中，找到或选择您即将处理的任务。
      </Step>

      <Step title="点击启动计时器">
        点击 **启动计时器** 开始实时跟踪时间。计时器将持续运行，直到您停止它。
      </Step>

      <Step title="完成后停止">
        完成工作后点击 **停止**。AgencyHandy 自动将经过的时间记录到所选任务上。
      </Step>
    </Steps>

    <Tip>
      对于持续进行的工作，请使用计时器以确保精确跟踪。事后手动四舍五入或估算时间不如让计时器运行准确。
    </Tip>
  </Tab>

  <Tab title="手动录入">
    <Steps>
      <Step title="点击 + 添加条目">
        在工时表面板中，点击 **+ 添加条目**。表单将随即弹出。
      </Step>

      <Step title="填写条目详情">
        * **任务** — 选择该工时对应的任务
        * **团队成员** — 将工时分配给正确的人员（管理员和项目经理可以代他人记录）
        * **花费时间** — 输入小时和分钟数
        * **备注** — 添加关于所处理工作的任何说明
      </Step>

      <Step title="保存">
        点击 **保存** 记录条目。它将立即出现在工时表表格中。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 按日期范围筛选

使用日期筛选器聚焦于特定时间段。

<Steps>
  <Step title="打开日期筛选器">
    点击工时表面板右上角的日期筛选控件。
  </Step>

  <Step title="选择范围">
    从预设范围中选择：

    * **每日** — 仅限今天的日志
    * **每周** — 当前周
    * **每月** — 当前月

    对于较长的项目或历史报告，通过输入开始日期和结束日期选择 **自定义** 日期范围。
  </Step>

  <Step title="应用">
    点击 **应用** 以更新表格，显示所选时间段的日志。
  </Step>
</Steps>

<Tip>
  导出前先进行筛选，以生成聚焦的报告。对于活跃的团队，导出完整的未过滤工时表可能会产生非常大的文件。
</Tip>

## 分组条目

分组会重新排列工时表行的组织方式，而不会删除任何数据。它帮助您更快速地阅读和分析日志。

<Steps>
  <Step title="打开分组依据下拉菜单">
    点击工时表面板顶部附近的 **分组依据** 下拉菜单。
  </Step>

  <Step title="选择分组方式">
    从以下选项中选择：

    | 分组依据选项        | 显示内容                  |
    | ------------- | --------------------- |
    | **任务名称**      | 所有工时条目按各任务分组          |
    | **团队成员**      | 所有条目按各人员分组            |
    | **服务 → 任务名称** | 条目按服务分组，然后在每个服务内按任务细分 |
  </Step>
</Steps>

<Note>
  分组仅是视觉上的变化——它不影响底层数据或导出内容。导出始终包含所有可见行。
</Note>

## 从工时表查看任务详情

<Steps>
  <Step title="点击任务名称">
    在工时表表格中，点击任意 **任务名称**。AgencyHandy 将导航您到该任务的完整详情页。
  </Step>

  <Step title="查看任务上下文">
    在任务详情页上，您将找到完整的工时日志历史、附加备注、负责人、状态及其他任务级别信息。使用此视图调查条目或验证已完成的工作。
  </Step>
</Steps>

## 导出工时表数据

为工资单、客户账单报告或外部项目管理工具导出工时表。

<Steps>
  <Step title="首先应用筛选（推荐）">
    使用日期范围筛选器将导出范围缩小到您需要的时间段。这使文件保持聚焦且易于管理。
  </Step>

  <Step title="点击导出">
    点击工时表面板顶部的 **导出** 按钮。
  </Step>

  <Step title="选择格式">
    选择以下格式之一：

    * **CSV** — 适用于 Excel、Google Sheets 等电子表格工具或数据管道
    * **XLSX** — 适用于保留列格式的 Excel 格式工作簿
  </Step>

  <Step title="下载文件">
    文件将自动下载到您的设备。每次导出包含所有可见列：日期、团队成员、任务名称、服务、已记录工时和备注。
  </Step>
</Steps>

<Warning>
  如果导出未触发下载，您浏览器的 **弹出窗口拦截器** 可能正在阻止文件下载。请为 AgencyHandy 禁用弹出窗口拦截，然后重试。
</Warning>

## 附加说明

<Accordion title="计时器与手动录入">
  计时器最适合活跃的实时工作。手动录入最适合忘记启动计时器或需要事后记录工时的情况。两种方式在工时表表格中产生完全相同的日志条目。
</Accordion>

<Accordion title="分组与筛选">
  筛选 **减少** 表格中显示的行数。分组 **重新整理** 已可见的行。您可以同时应用两者——按日期范围筛选，然后按团队成员分组，以查看该时间段内每个人的合计。
</Accordion>

<Accordion title="导出包含所有可见列">
  每次导出都捕获可见表格的当前状态：日期、用户、任务、服务、工时和备注。如果您已应用分组设置，导出将反映分组结构。
</Accordion>

<Accordion title="历史数据的自定义范围">
  对于长期运行的项目或季度审查，请使用自定义日期范围选项拉取超出预设每日/每周/每月窗口的历史工时表数据。
</Accordion>