diff --git a/README.md b/README.md
index c8d587e..4b396df 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,9 @@
+
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
+> [English](./README.en.md) · [原始项目](https://github.com/roboflow/supervision) · [上游 README](https://github.com/roboflow/supervision/blob/HEAD/README.md)
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
-📑 Table of Contents
+📑 目录
-- [👋 Hello](#-hello)
-- [💻 Install](#-install)
-- [🔥 Quickstart](#-quickstart)
- - [Models](#models)
- - [Annotators](#annotators)
- - [Datasets](#datasets)
-- [🎬 Tutorials](#-tutorials)
-- [💜 Built with Supervision](#-built-with-supervision)
-- [📚 Documentation](#-documentation)
-- [🏆 Contribution](#-contribution)
+- [👋 你好](#-hello)
+- [💻 安装](#-install)
+- [🔥 快速入门](#-quickstart)
+ - [模型](#models)
+ - [标注器](#annotators)
+ - [数据集](#datasets)
+- [🎬 教程](#-tutorials)
+- [💜 使用 Supervision 构建](#-built-with-supervision)
+- [📚 文档](#-documentation)
+- [🏆 贡献](#-contribution)
-## 👋 Hello
+## 👋 你好
-**We are your essential toolkit for computer vision.** From data loading to real-time zone counting, we provide the building blocks so you can focus on building applications around your models. 🤝
+**我们是你在计算机视觉（computer vision）领域的必备工具包。** 从数据加载到实时区域计数，我们提供各类基础模块，让你可以专注于围绕模型构建应用。🤝
-## 💻 Install
+## 💻 安装
-Pip install the supervision package in a [**Python>=3.10**](https://www.python.org/) environment.
+在 [**Python>=3.10**](https://www.python.org/) 环境中，使用 pip 安装 supervision 包。
```bash
pip install supervision
```
-Read more about conda, mamba, and installing from source in our [guide](https://roboflow.github.io/supervision/).
+如需了解 conda、mamba 及从源码安装的更多内容，请参阅我们的[指南](https://roboflow.github.io/supervision/).
-## 🔥 Quickstart
+## 🔥 快速入门
-### Models
+### 模型
-Supervision was designed to be model agnostic. Just plug in any classification, detection, or segmentation model. For your convenience, we have created [connectors](https://supervision.roboflow.com/latest/detection/core/#detections) for the most popular libraries like Ultralytics, Transformers, MMDetection, or Inference. Other integrations, like `rfdetr`, already return `sv.Detections` directly.
+Supervision 在设计上是模型无关（model agnostic）的。你可以直接接入任意分类、检测或分割模型。为方便使用，我们为 Ultralytics、Transformers、MMDetection、Inference 等最流行的库创建了[连接器](https://supervision.roboflow.com/latest/detection/core/#detections)。其他集成方式（如 `rfdetr`）已能直接返回 `sv.Detections`。
-Install the optional dependencies for this example with `pip install pillow rfdetr`.
+使用 `pip install pillow rfdetr` 安装本示例所需的可选依赖。
```python
import supervision as sv
@@ -76,11 +82,11 @@ len(detections)
```
-👉 more model connectors
+👉 更多模型连接器
- inference
- Running with [Inference](https://github.com/roboflow/inference) requires a [Roboflow API KEY](https://docs.roboflow.com/api-reference/authentication#retrieve-an-api-key).
+ 使用 [Inference](https://github.com/roboflow/inference) 运行需要 [Roboflow API KEY](https://docs.roboflow.com/api-reference/authentication#retrieve-an-api-key).
```python
import supervision as sv
@@ -98,9 +104,9 @@ len(detections)
-### Annotators
+### 标注器
-Supervision offers a wide range of highly customizable [annotators](https://supervision.roboflow.com/latest/detection/annotators/), allowing you to compose the perfect visualization for your use case.
+Supervision 提供大量高度可自定义的[标注器](https://supervision.roboflow.com/latest/detection/annotators/),，可让你为具体场景组合出完美的可视化效果。
```python
import cv2
@@ -116,9 +122,9 @@ annotated_frame = box_annotator.annotate(scene=image.copy(), detections=detectio
https://github.com/roboflow/supervision/assets/26109316/691e219c-0565-4403-9218-ab5644f39bce
-### Datasets
+### 数据集
-Supervision provides a set of [utils](https://supervision.roboflow.com/latest/datasets/core/) that allow you to load, split, merge, and save datasets in one of the supported formats.
+Supervision 提供一组[工具函数](https://supervision.roboflow.com/latest/datasets/core/)，支持以支持的格式之一加载、拆分、合并和保存数据集。
```python
import supervision as sv
@@ -141,7 +147,7 @@ for path, image, annotation in ds:
```
-👉 more dataset utils
+👉 更多数据集工具
- load
@@ -230,29 +236,29 @@ for path, image, annotation in ds:
-## 🎬 Tutorials
+## 🎬 教程
-Want to learn how to use Supervision? Explore our [how-to guides](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/), [end-to-end examples](./examples), [cheatsheet](https://roboflow.github.io/cheatsheet-supervision/), and [cookbooks](https://supervision.roboflow.com/develop/cookbooks/)!
+想了解如何使用 Supervision？可浏览我们的[操作指南](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/),、[端到端示例](./examples)、[速查表](https://roboflow.github.io/cheatsheet-supervision/), 和 [cookbook](https://supervision.roboflow.com/develop/cookbooks/)!
Dwell Time Analysis with Computer Vision | Real-Time Stream Processing
-
Created: 5 Apr 2024
-
Learn how to use computer vision to analyze wait times and optimize processes. This tutorial covers object detection, tracking, and calculating time spent in designated zones. Use these techniques to improve customer experience in retail, traffic management, or other scenarios.
+创建时间：2024 年 4 月 5 日
+
了解如何使用计算机视觉分析等待时间并优化流程。本教程涵盖目标检测、跟踪，以及计算在指定区域内的停留时间。可将这些技术用于提升零售、交通管理等场景下的客户体验。
-
-Speed Estimation & Vehicle Tracking | Computer Vision | Open Source
-
Created: 11 Jan 2024
-
Learn how to track and estimate the speed of vehicles using YOLO, ByteTrack, and Roboflow Inference. This comprehensive tutorial covers object detection, multi-object tracking, filtering detections, perspective transformation, speed estimation, visualization improvements, and more.
+
+速度估算与车辆跟踪 | 计算机视觉 | 开源
+创建日期：2024 年 1 月 11 日
+
学习如何使用 YOLO、ByteTrack 和 Roboflow Inference 跟踪并估算车辆速度。本综合教程涵盖目标检测（object detection）、多目标跟踪（multi-object tracking）、检测结果过滤、透视变换（perspective transformation）、速度估算、可视化改进等内容。
-## 💜 Built with Supervision
+## 💜 使用 Supervision 构建
-Did you build something cool using supervision? [Let us know!](https://github.com/roboflow/supervision/discussions/categories/built-with-supervision)
+你是否使用 supervision 构建了很酷的项目？[告诉我们！](https://github.com/roboflow/supervision/discussions/categories/built-with-supervision)
https://user-images.githubusercontent.com/26109316/207858600-ee862b22-0353-440b-ad85-caa0c4777904.mp4
@@ -260,13 +266,13 @@ https://github.com/roboflow/supervision/assets/26109316/c9436828-9fbf-4c25-ae8c-
https://github.com/roboflow/supervision/assets/26109316/3ac6982f-4943-4108-9b7f-51787ef1a69f
-## 📚 Documentation
+## 📚 文档
-Visit our [documentation](https://roboflow.github.io/supervision) page to learn how supervision can help you build computer vision applications faster and more reliably.
+访问我们的[文档](https://roboflow.github.io/supervision) 页面，了解 supervision 如何帮助你更快、更可靠地构建计算机视觉应用。
-## 🏆 Contribution
+## 🏆 贡献
-We love your input! Please see our [contributing guide](.github/CONTRIBUTING.md) to get started. Thank you 🙏 to all our contributors!
+我们欢迎你的反馈！请查阅我们的[贡献指南](.github/CONTRIBUTING.md)开始参与。感谢 🙏 所有贡献者！