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/` 或网页目录。产品业务可以组合服务，但服务不能反向引用产品业务。

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

```python
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` 是业务层：它检测豆包模板、生成蒙版，然后调用上述纯图像修复服务。