核心用法
ai-beauty 是一款专注于人像智能美颜的本地化图像处理技能，通过调用 BitSoulFaceBeauty 引擎实现照片美化。用户需先配置 BITSOUL_TOKEN 环境变量并完成初始化，随后通过 JSON 参数文件精确控制美颜效果。支持磨皮、美白、瘦脸、大眼、祛黑眼圈等 30 余项可调节参数，数值范围 0-1 实现精细化程度控制。
显著优点
1. 本地安全处理：全程离线运算，原图不上传任何服务器，隐私保护级别高
2. 参数化精准控制：告别"抽卡"式随机效果，每项美颜指标可独立调节、多轮对话优化
3. 中文语义映射：参数命名贴合中文用户习惯（如"自然脸""女神""天鹅颈"），降低使用门槛
4. 响应速度快：本地 GPU/CPU 推理，无需等待云端排队
5. 免费试用机制：官网注册即可申请限时免费 Token，VIP 用户不限量使用
潜在缺点与局限性
- Token 依赖：必须持有有效 BITSOUL_TOKEN 才能运行，存在服务可用性绑定
- 初始化门槛：首次使用需下载二进制文件，对网络环境有要求
- 平台限制：目前仅支持 Windows 可执行文件（.exe），跨平台兼容性待完善
- 功能边界：专注人像美颜，不支持通用图像编辑（如背景替换、风格迁移）
适合人群
- 注重隐私安全的个人用户（不想将照片上传至美图/醒图等云端平台）
- 需要批量处理写真、证件照的摄影师或工作室
- 对美颜效果有明确偏好、反感随机算法的控制型用户
- 追求"原生好皮"自然感而非过度网红滤镜效果的用户
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| Token 泄露 | 环境变量或 env 文件若权限设置不当可能被其他程序读取 | 使用 `BITSOUL_TOKEN_ENV_FILE` 方式存储，设置文件 600 权限 |
| 二进制来源 | 需从远程下载可执行文件，存在供应链攻击理论可能 | 校验下载文件哈希值，关注官网安全公告 |
| 过度美颜 | 参数叠加可能导致面部特征失真、皮肤纹理塑料感 | 遵循"少量多次"原则，单参数建议不超过 0.6 |
| 授权合规 | VIP 功能与免费额度边界需关注服务条款变更 | 定期查阅 https://www.aicodingyard.com 公告 |