常見問題

Potato（Portable Text Annotation Tool，行動式文本標註工具）是一款免費、開源的標註工具，用於建立高品質資料集。它支援文本、影像、音訊和影片標註，採用簡單的基於 YAML 的配置系統。

是的。Potato 在 GNU 通用公共許可證 v3.0 或更高版本（GPL-3.0-or-later）下免費且開源。您可以使用、修改和再分發它，包括商業用途，只要衍生作品仍以 GPL 授權。早期版本使用 PolyForm Shield 許可證；Potato 在 2.6 版本中重新以 GPL-3.0 授權。完整文本請檢視 GitHub 倉庫中的 LICENSE 檔案。

不需要。Potato 使用人類可讀且易於編寫的 YAML 配置檔案。我們的線上構建器（Playground）提供視覺化介面，無需編寫任何程式碼即可生成配置。

通過 pip 安裝：`pip install potato-annotation`。然後執行 `potato start my_project -c config.yaml` 啟動標註伺服器。詳細說明請參閱我們的快速入門指南。

Potato 需要 Python 3.7 或更高版本。我們建議使用 Python 3.10+ 以獲得最佳體驗。

Run pip install --upgrade potato-annotation.

Potato works in all modern browsers: Chrome, Firefox, Safari, and Edge.

您的資料保留在您的本地機器上。Potato 完全在本地執行，不會將您的資料傳送到外部伺服器。這使其非常適合處理醫療記錄或專有內容等敏感資料。

可以。由於 Potato 是自託管的且在本地執行，您可以完全控制您的資料。資料絕不會離開您的基礎設施，適用於 HIPAA、GDPR 等合規要求。

Potato 支援多種輸入格式，包括純文本、JSON、JSONL、CSV、TSV、影像（PNG、JPG、GIF、WebP）、音訊（MP3、WAV、OGG）和影片檔案。輸出可以匯出為 JSON、JSONL、CSV 以及 CoNLL、COCO 和 HuggingFace datasets 等專用格式。

Potato 支援：單選按鈕（單項選擇）、核取方塊（多項選擇）、李克特量表、文本輸入、文本片段標註（高亮標註）、邊界框、多邊形、成對比較、最佳-最差縮放等。詳見我們的展示頁面。

可以。單個標註任務可以包含任意組合的標註方案。例如，您可以讓標註員在同一條目上高亮實體（文本片段標註）、分類情感（單選按鈕）並提供評論（文本輸入）。

支援。Potato 支援使用單選/複選標籤的影像分類、用於目標檢測的邊界框標註，以及用於分割任務的多邊形標註。

可以。Potato 可以在標註控制元件旁邊顯示音訊波形和影片播放器。這對於語音轉寫稽核、說話人分離、情感檢測等任務非常有用。

在配置中新增文本片段標註方案並指定需要高亮的文本。標註員可以選擇文本片段並分配標籤。請參閱我們展示頁面中的 NER 和文本片段標註示例。

Yes. Potato supports custom CSS, HTML templates, and layout configuration via YAML.

Potato 開箱即支援多標註員。每個標註員使用唯一 ID 登入，其標註記錄獨立跟蹤。您可以配置重疊標註，讓多個標註員對同一條目進行標註以進行品質控制。

可以。Potato 支援與 Prolific 和 Amazon Mechanical Turk 整合。標註員從平臺重定向過來，在 Potato 中完成任務後，帶著完成碼返回平臺。

Potato 會跟蹤哪些條目已被多個標註員標註。您可以匯出標註資料，使用標準 Python 庫計算一致性指標（Cohen's Kappa、Krippendorff's Alpha 等）。

可以。您可以添加註意力檢查題目、配置所需的標註重疊數量，並使用管理面板監控標註員進度和發現潛在問題。

常見問題：1）檢查 config.yaml 的 YAML 語法是否正確。2）確保資料檔案存在且格式正確。3）檢查埠（預設 8000）是否已被佔用。4）檢視終端輸出中的具體錯誤資訊。

請檢查：1）您是否點選了儲存/提交按鈕。2）輸出目錄是否可寫。3）所有必填欄位是否已填寫。請在瀏覽器控制台中檢視 JavaScript 錯誤。

從輸出目錄中刪除該標註員的標註檔案。其任務分配將在下次登入時重新生成。

加入我們的 Discord 社群獲取即時幫助，在 GitHub Issues 中檢視已知問題，或瀏覽我們的文件。社群氛圍友好且響應迅速！