services/README.md

Reusable Services

这里存放与具体产品页面无关的可复用后端能力：

Package	Python entry	HTTP entry
services.inpainting	run_inpaint(image, mask, mode=...)	POST /inpaint
services.ocr	OCRService.invoke(request)	POST /ocr/api/invoke
services.douyin	resolve_douyin_share(text)	POST /douyin/parse
services.youtube	fetch_youtube_video(url, languages)	POST /youtube/info、POST /youtube/transcript

服务包不能依赖 features/ 或网页目录。产品业务可以组合服务，但服务不能反向引用产品业务。

例如，纯图像修复只需要图片和蒙版：

from PIL import Image
from services.inpainting.service import run_inpaint

result, mode, elapsed = run_inpaint(
    Image.open("image.png"),
    Image.open("mask.png"),
    mode="fast",
)
result.save("result.png")

features/doubao_watermark 是业务层：它检测豆包模板、生成蒙版，然后调用上述纯图像修复服务。