生成代码质量

• - 类型安全 — 支持完整类型注解
• 文档完善 — 包含文档字符串和注释
• 经过测试 — 包含示例测试
• 现代化 — 采用最新模式和最佳实践
• 整洁优雅 — 可读性强、易于维护的代码

示例：Python CRUD

python

生成: user_crud.py

from typing import List, Optional
from sqlalchemy.orm import Session
from models import User
from schemas import UserCreate, UserUpdate

class UserCRUD:
User 模型的 CRUD 操作。

def create(self, db: Session, user: UserCreate) -> User:
创建新用户。
db_user = User(
name=user.name,
email=user.email,
)
db.add(db_user)
db.commit()
db.refresh(db_user)
return db_user

def get(self, db: Session, user_id: int) -> Optional[User]:
根据 ID 获取用户。
return db.query(User).filter(User.id == user_id).first()

def get_multi(self, db: Session, skip: int = 0, limit: int = 100) -> List[User]:
获取多个用户。
return db.query(User).offset(skip).limit(limit).all()

def update(self, db: Session, user_id: int, user: UserUpdate) -> Optional[User]:
更新用户。
dbuser = self.get(db, userid)
if db_user:
for key, value in user.dict(exclude_unset=True).items():
setattr(db_user, key, value)
db.commit()
db.refresh(db_user)
return db_user

def delete(self, db: Session, user_id: int) -> bool:
删除用户。
dbuser = self.get(db, userid)
if db_user:
db.delete(db_user)
db.commit()
return True
return False

使用场景

• - 新项目 — 从生产就绪的结构开始
• 快速原型开发 — 生成样板代码，专注于业务逻辑
• 代码审查 — 生成一致的代码模式
• 学习参考 — 研究生成的代码以掌握最佳实践

模板

模板存储在 references/templates/ 目录中：

• - python/api/ — Python FastAPI 项目
• python/cli/ — Python CLI 工具
• typescript/api/ — Node.js Express API
• typescript/web/ — React + TypeScript Web 应用
• go/api/ — Go REST API
• rust/cli/ — Rust CLI 工具

相关参考

• - references/templates/ — 代码模板
• scripts/generator.py — 主生成器