常见问题

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 文件。

不需要编程。任务定义在一个 YAML 配置文件中，研究设计器通过可视化表单生成这个文件。

通过 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 提供 76 种标注类型，包括单选按钮（单项选择）、复选框（多项选择）、李克特量表、文本输入、文本片段高亮、边界框、多边形、成对比较和最佳-最差缩放。完整示例见展示页面。

可以。单个标注任务可以包含任意组合的标注方案。例如，您可以让标注员在同一条目上高亮实体（文本片段标注）、分类情感（单选按钮）并提供评论（文本输入）。

支持。Potato 支持使用单选/复选标签的图像分类、用于目标检测的边界框标注，以及用于分割任务的多边形标注。

可以。Potato 可以在标注控件旁边显示音频波形和视频播放器。这对于语音转写审核、说话人分离、情感检测等任务非常有用。

在配置中添加文本片段标注方案并指定需要高亮的文本。标注员可以选择文本片段并分配标签。请参阅我们展示页面中的 NER 和文本片段标注示例。

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

Potato 开箱即支持多标注员。每个标注员使用唯一 ID 登录，其标注记录独立跟踪。您可以配置重叠标注，让多个标注员对同一条目进行标注以进行质量控制。

可以。Potato 为 Prolific、SONA 被试池、CloudResearch Connect、Clickworker 和 Microworkers 提供了专门的提供方，另有一个通用提供方，适用于任何传递参与者 ID 的样本平台。标注员从平台进入，在 Potato 中完成任务后带着完成码返回；在 SONA 上则获得学分。

Potato 会跟踪哪些条目已被多个标注员标注。您可以导出标注数据，使用标准 Python 库计算一致性指标（Cohen's Kappa、Krippendorff's Alpha 等）。

可以。您可以添加注意力检查题目、配置所需的标注重叠数量，并使用管理面板监控标注员进度和发现潜在问题。

常见问题：1）检查 config.yaml 的 YAML 语法是否正确。2）确保数据文件存在且格式正确。3）检查端口（默认 8000）是否已被占用。4）查看终端输出中的具体错误信息。

请检查：1）您是否点击了保存/提交按钮。2）输出目录是否可写。3）所有必填字段是否已填写。请在浏览器控制台中查看 JavaScript 错误。

从输出目录中删除该标注员的标注文件。其任务分配将在下次登录时重新生成。

加入我们的 Discord 社区获取实时帮助，在 GitHub Issues 中查看已知问题，或浏览我们的文档。社区氛围友好且响应迅速！