docs(zh-CN): translate code block(plain text) (#753)

Co-authored-by: neo <neo.dowithless@gmail.com>
This commit is contained in:
zdoc.app
2026-03-23 06:39:24 +08:00
committed by GitHub
parent fd2a8edb53
commit 4f6f587700
118 changed files with 1807 additions and 1835 deletions

View File

@@ -178,54 +178,53 @@ with open("config.json") as f: # Good
运行:`black app/routes/user.py app/services/auth.py`
````
## 审批标准
## Approval Criteria
| Status | Condition |
| 状态 | 条件 |
|--------|-----------|
| ✅ Approve | No CRITICAL or HIGH issues |
| ⚠️ Warning | Only MEDIUM issues (merge with caution) |
| ❌ Block | CRITICAL or HIGH issues found |
| ✅ 批准 | CRITICAL HIGH 级别问题 |
| ⚠️ 警告 | 仅存在 MEDIUM 级别问题(谨慎合并) |
| ❌ 阻止 | 发现 CRITICAL HIGH 级别问题 |
## Integration with Other Commands
## 与其他命令的集成
- Use `/tdd` first to ensure tests pass
- Use `/code-review` for non-Python specific concerns
- Use `/python-review` before committing
- Use `/build-fix` if static analysis tools fail
- 首先使用 `/tdd` 确保测试通过
- 使用 `/code-review` 处理非 Python 特定问题
- 在提交前使用 `/python-review`
- 如果静态分析工具失败,请使用 `/build-fix`
## Framework-Specific Reviews
## 框架特定审查
### Django Projects
The reviewer checks for:
- N+1 query issues (use `select_related` and `prefetch_related`)
- Missing migrations for model changes
- Raw SQL usage when ORM could work
- Missing `transaction.atomic()` for multi-step operations
### Django 项目
审查员检查:
- N+1 查询问题(使用 `select_related` `prefetch_related`
- 模型更改缺少迁移
- 在 ORM 可用时使用原始 SQL
- 多步骤操作缺少 `transaction.atomic()`
### FastAPI Projects
The reviewer checks for:
- CORS misconfiguration
- Pydantic models for request validation
- Response models correctness
- Proper async/await usage
- Dependency injection patterns
### FastAPI 项目
审查员检查:
- CORS 配置错误
- 用于请求验证的 Pydantic 模型
- 响应模型的正确性
- 正确的 async/await 使用
- 依赖注入模式
### Flask Projects
The reviewer checks for:
- Context management (app context, request context)
- Proper error handling
- Blueprint organization
- Configuration management
### Flask 项目
审查员检查:
- 上下文管理(应用上下文、请求上下文)
- 正确的错误处理
- Blueprint 组织
- 配置管理
## Related
## 相关
- Agent: `agents/python-reviewer.md`
- Skills: `skills/python-patterns/`, `skills/python-testing/`
## Common Fixes
## 常见修复
### Add Type Hints
### 添加类型提示
```python
# Before
def calculate(x, y):