> ## 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 格式。這是讓您的團隊保持問責制並確保時間計費準確的必備工具。

## 誰可以使用工時表功能

| 功能        | 超級管理員 | 管理員 |  PM |  員工 |
| --------- | :---: | :-: | :-: | :-: |
| 查看自己的時間記錄 |   ✅   |  ✅  |  ✅  |  ✅  |
| 代他人記錄時間   |   ✅   |  ✅  |  ✅  |  ❌  |
| 編輯時間記錄    |   ✅   |  ✅  |  ✅  |  ❌  |
| 匯出工時表資料   |   ✅   |  ✅  |  ✅  |  ❌  |

<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>