docs: 为全部代码补充中文注释并加入 AGENTS 注释规范

pyproject.toml

@@ -1,8 +1,10 @@
+# WOV API 项目配置：使用 uv 管理环境与依赖。
 [project]
 name = "wov-api"
 version = "0.1.0"
 description = "WOV platform API"
 requires-python = ">=3.11"
+# fastapi/uvicorn 提供 Web 服务，python-multipart 支持文件上传。
 dependencies = [
   "fastapi",
   "uvicorn",
@@ -10,12 +12,15 @@ dependencies = [
   "wov-sdk",
 ]
 
+# 本地路径依赖 wov-sdk。
 [tool.uv.sources]
 wov-sdk = { path = "../wov-sdk" }
 
+# 开发依赖：pytest、覆盖率工具与 httpx（TestClient 依赖）。
 [dependency-groups]
 dev = ["pytest", "pytest-cov", "httpx"]
 
+# pytest 配置：强制 app 包 100% 行覆盖率。
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["."]