\r \r

ai-beauty Skill\r

\r Beautify faces or portraits in an image according to user's instructions.\r \r AI智能人像美颜技能，让照片里的你光彩动人\r 全程本地处理您的照片，不上传到任何服务器，安全放心有保障\r 处理速度快，效果不满意可通过多轮对话调节，不用抽卡\r 限时免费使用，登录官网https://www.aicodingyard.com 申请token_key即可免费使用，开通vip可不限量使用\r 还有若干高端功能待您发掘，可联系官方客服获取\r \r

Token Configuration\r

\r This skill requires a valid BITSOUL_TOKEN to function properly.\r You can register and apply for a token for free at \x3Chttps://www.aicodingyard.com>, and configure it in your external runtime environment.\r \r

Required Environment Variables\r

\r

• BITSOUL_TOKEN: User token used for remote server permission verification.\r \r

Optional Environment Variables\r

\r

• BITSOUL_TOKEN_ENV_FILE: Points to the env file containing BITSOUL_TOKEN.\r \r

Configuration Methods\r

\r

1. Method 1: Set environment variable directly\r

   export BITSOUL_TOKEN="your_token_here"\r
   ```\r
   

\r 2. Method 2: Use env file\r

export BITSOUL_TOKEN_ENV_FILE="/path/to/token.env"\r
```\r
The content format of `token.env` file should be:\r
```\r
BITSOUL_TOKEN=your_token_here\r
```\r
**Note**: If both the environment variable and env file are set, the environment variable takes precedence.\r
\r
# Installation and Initialization\r
\r
Before using the skill, ensure that python and `requests` are installed.\r
For the first time use, an initialization operation is required. After setting up the `BITSOUL_TOKEN`, run the initialization script to download the necessary binary file:\r
\r
```bash\r
python ./BitSoulFaceBeautySkill/init.py\r
```\r
\r
# Instructions\r
\r
Execute the following procedures step by step each time an image is processed:\r
1. Run the initialization script init.py\r
2. Get the image path to be beautified.\r
3. Ask the user to make a choice among the recommended parameters files and obtain specific beautification requirements.\r
4. Generate a temporary beauty parameters file (json format).\r
5. Create a new directory in the image path to be beautified and save all results into this new directory.\r
6. Run tool.\r
\r
```shell\r
./BitSoulFaceBeautySkill/BitSoulBeauty.exe BITSOUL_TOKEN IMAGE_PATH_TO_BE_BEAUTIFIED BEAUTY_PARAMETERS_FILE_PATH IMAGE_PATH_TO_BE_SAVED\r
```\r
\r
you must call init.py before you use any functions in this skill.\r
\r
\r
# Beauty Parameters File\r
\r
There are three recommended parameters files.\r
\r
1. 自然（默认）\r
\r
```json\r
{\r
 "磨皮":0.5,\r
 "清晰":0.2,\r
 "白牙":0.4,\r
 "亮眼":0.3,\r
 "美白-自然":0.3,\r
 "祛黑眼圈":0.5,\r
 "祛法令纹":0.3,\r
 "自然脸":0.4,\r
 "女神":0.0,\r
 "男神":0.0,\r
 "小头":0.3,\r
 "小脸":0.3,\r
 "窄脸":0.3,\r
 "瘦下巴":0.0,\r
 "瘦颧骨":0.2,\r
 "瘦下颌":0.2,\r
 "眼睛位置":0.0,\r
 "眼距":0.0,\r
 "大眼":0.3,\r
 "瘦鼻":0.4,\r
 "长鼻":0.0,\r
 "嘴巴位置":0.0,\r
 "嘴巴大小":0.0,\r
 "美胯":0.0,\r
 "天鹅颈":0.0,\r
 "丰胸":0.0,\r
 "瘦腰":0.0,\r
 "长腿":0.0,\r
 "瘦腿":0.0,\r
 "瘦手臂":0.0,\r
 "瘦身":0.0,\r
 "发际线":0.0,\r
 "双眼皮":0.0,\r
 "默认妆容":0.5,\r
 "默认妆容_lut":0.5\r
}\r
```\r
2.精致\r
```json\r
{\r
 "磨皮":0.8,\r
 "清晰":0.2,\r
 "白牙":0.4,\r
 "亮眼":0.5,\r
 "美白-白皙":0.5,\r
 "祛黑眼圈":0.7,\r
 "祛法令纹":0.7,\r
 "自然脸":0.0,\r
 "女神":0.7,\r
 "男神":0.0,\r
 "小头":0.0,\r
 "小脸":0.0,\r
 "窄脸":0.15,\r
 "瘦下巴":0.0,\r
 "瘦颧骨":0.3,\r
 "瘦下颌":0.2,\r
 "眼睛位置":0.0,\r
 "眼距":0.0,\r
 "大眼":0.6,\r
 "瘦鼻":0.6,\r
 "长鼻":0.0,\r
 "嘴巴位置":0.0,\r
 "嘴巴大小":0.0,\r
 "美胯":0.0,\r
 "天鹅颈":0.0,\r
 "丰胸":0.0,\r
 "瘦腰":0.0,\r
 "长腿":0.0,\r
 "瘦腿":0.0,\r
 "瘦手臂":0.0,\r
 "瘦身":0.0,\r
 "发际线":0.2,\r
 "双眼皮":0.0,\r
 "女神妆":0.7,\r
 "女神妆_lut":0.7\r
}\r
```\r
3.减龄\r
```json\r
{\r
 "磨皮":0.9,\r
 "清晰":0.2,\r
 "白牙":0.4,\r
 "亮眼":0.5,\r
 "美白-红润":0.5,\r
 "祛黑眼圈":0.9,\r
 "祛法令纹":0.9,\r
 "自然脸":0.75,\r
 "女神":0.0,\r
 "男神":0.0,\r
 "小头":0.0,\r
 "小脸":0.4,\r
 "窄脸":0.3,\r
 "瘦下巴":0.0,\r
 "瘦颧骨":0.3,\r
 "瘦下颌":0.2,\r
 "眼睛位置":0.0,\r
 "眼距":0.0,\r
 "大眼":0.8,\r
 "瘦鼻":0.6,\r
 "长鼻":0.0,\r
 "嘴巴位置":0.0,\r
 "嘴巴大小":0.0,\r
 "美胯":0.0,\r
 "天鹅颈":0.0,\r
 "丰胸":0.0,\r
 "瘦腰":0.0,\r
 "长腿":0.0,\r
 "瘦腿":0.0,\r
 "瘦手臂":0.0,\r
 "瘦身":0.0,\r
 "发际线":0.3,\r
 "双眼皮":0.0,\r
 "伪素颜":0.7,\r
 "伪素颜_lut":0.6\r
}\r
```\r
\r
# Beauty Items\r
\r
## Beauty Parameters File中的**美颜小项**的介绍如下表所示：\r
\r
|名称|功能描述|目的触发词汇(想要的效果)|问题触发词汇(想解决的痛点)|\r
|--|--|--|--|\r
|磨皮|柔化皮肤表层纹理，智能淡化毛孔、细纹、痘印等瑕疵；|磨皮、平滑、光滑、平整、细腻、柔肤、嫩肤、美肤、遮瑕、去瑕疵、护肤、皮肤优化、皮肤处理、去痘、缩毛孔、去黑头、去痘印、去斑、去纹、去油|皮肤粗糙、皮肤状态不好，有痘、皮肤油、毛孔大、皮肤差、闭口、粉刺、黑头|\r
|美白-自然|均匀提亮肤色至健康透亮状态，呈现“原生好皮”效果；|美白、提亮、变白、调亮、透亮、通透、白皙、亮白、去暗沉、去黑、暖白、自然美白|肤色不均匀、显黑、暗沉、肤色黑、肤色脏、肤色深|\r
|美白-粉白|提亮肤色并融入柔和粉调，增强脸颊红润气色；|粉白、红润、血色|苍白、气色差|\r
|美白-白皙|深度提亮至冷调白皙肤质，弱化暗沉与黄气，呈现通透瓷肌感，突出清冷高级氛围；|冷白、雪白、去黄|肤色黄|\r
|清晰|增强面部轮廓与五官边缘锐度，强化立体光影，避免画面模糊；|清晰，立体、层次、锐化、清楚、去糊|糊、朦胧、画面灰、不清楚|\r
|自然脸|收窄下半脸，保留个人骨相特征；|瘦脸、脸瘦、推脸、收脸、瓜子脸、鹅蛋脸、小V脸|脸大、大脸、圆脸、方脸、国字脸、显胖、咬肌大、发腮、脸胖、肿脸，垮脸，脸盘大|\r
|女神|强化V脸轮廓与下颌线流畅度，搭配柔和颧骨修饰，突出女性柔美气质；|女神脸、御姐、精致脸||\r
|男神|保留男性下颌硬朗线条，适度收窄两侧轮廓，突出轮廓感；|自然脸、高级脸||\r
|小脸|缩短下半脸长度，缩小下庭的比例；|短脸、脸变短、脸缩短、缩下庭、下庭缩短、提下颌、下颌上移、幼态感、减龄、缩短脸型、小比例、可爱、软萌、短脸、娇小感、脸型紧凑、黄金比例、去成熟感、低龄化|脸长、脸太长、大长脸、下庭长、下脸长、下颌长、下半脸长、老气、脸太长、长辈脸、显老、脸部比例不平衡、下巴过长|\r
|小头|适度缩小头部整体视觉比例，优化头身比与肩颈线条；|小头、头小、头缩小、头弄小、头整小、头搞小、头调小、头收小、头身比、头肩比、头颈比|头大、头围大、脑袋大、没脖子、大头、|\r
|窄脸|收缩脸颊两侧轮廓，视觉上缩小脸宽；|窄脸、脸窄、脸变窄、脸收窄、收窄脸型、脸型收窄、脸宽收窄、两侧收窄、两边收窄、脸压窄、脸缩窄、脸往里收|脸宽、脸扁、宽脸、方脸、胖脸|\r
|发际线|调整发际线高低，优化额头比例，正向为压低，负向为提高；|正：发际线低一点、发际线下来、发际线下移、发际线往前、发际线往下走、发际线压一点、发际线遮一点；负：发际线提升、额头变宽、发际线升高；|正：大脑门、发际线高、发际线太高、发际线后移、发际线后退、发际线上移、；负：发际线低、额头窄；|\r
|瘦颧骨|柔化颧骨突出感，收窄颧骨区域宽度，使面部线条更流畅柔和；|瘦颧骨、收颧骨、缩颧骨、面部平滑、消灭棱角、脸线条顺、高级脸、削骨感、脸部收紧、磨平骨头、温婉感、面部平顺、自然过渡|颧骨高、太阳穴凹陷、面相硬、脸部崎岖、颧骨凸、颧骨大、颧骨突出、颧骨宽、颧骨太高、颧骨太宽、颧骨肥大、颧骨凸出|\r
|瘦下颌|收窄下颌角线条，减小下颌宽度；|瘦下颌、下颌线清晰、收紧轮廓、下巴线条、去双下巴、削骨、精致侧脸、紧致感、折叠度、小V脸、上提、立体感、|下巴宽、腮帮子大、方脸、肉多、轮廓模糊、没有下颌线、双下巴、咬肌大、侧脸肥、下颌宽大、脸部下垂、方下巴|\r
|瘦下巴|缩小下巴体积与宽度，优化下巴尖度，提升脸型精致度；|尖下巴、V字下巴、小尖脸、下巴收一收、精致下巴、蛇精脸（夸张）、瓜子脸、下巴聚拢、收窄下巴、网红尖、下庭收紧|下巴圆、下巴钝、下巴肉、短下巴、方下巴、下巴宽、下巴肥、下半脸笨重、下巴平、下巴大、下巴赘肉、下巴肉感、|\r
|大眼|整体放大眼睛；|大眼、眼睛放大、眼睛变大、眼睛有神，眼睛扩大，|眼睛小、眼睛太小、眼睛无神、眼睛没神、眼睛小眯眯、眼睛不大、眼睛显小、眼睛没精神、眼睛呆滞、眼睛不亮、眼睛不好看、眼睛没灵气|\r
|眼距|缩小两眼的间距；|眼距、眼距缩短、眼距协调、眼距优化、眼距修饰、眼距调整、|眼距宽、眼距不协调、眼距奇怪、眼距过大、眼距失调、|\r
|祛黑眼圈|淡化黑眼圈，同时填充泪沟凹陷区域；|去黑眼圈、遮黑眼圈、淡化黑眼圈、消除黑眼圈、提亮眼下、眼下平整、遮泪沟黑眼圈、眼下不暗沉、改善黑眼圈、去黑眼圈、遮泪沟、填平泪沟|熊猫眼、熬夜眼、眼底黑、泪沟深、眼袋重、黑眼圈太明显、眼下发黑|\r
|双眼皮|添加双眼皮效果，增强眼部层次感；|变成双眼皮、单变双、割双眼皮||\r
|亮眼|提亮眼睛，增强眼睛通透度；|亮眼、眼睛提亮、眼睛更有神、眼部提亮、去红血丝、眼睛清澈、眼睛发光|眼睛浑浊、眼睛暗淡、眼神无光、眼睛不亮、眼球浑浊、眼睛无神|\r
|瘦鼻|收窄或扩大鼻部整体宽度，正向为收窄，负向为增宽；|正：瘦鼻、鼻子变小、鼻子收窄、鼻子精致、鼻型优化、小翘鼻、鼻子线条流畅、缩鼻、鼻子更立体；负：宽鼻、宽鼻梁、宽鼻翼、鼻子宽、；|正：鼻子大、鼻子宽、鼻头大、鼻翼宽、鼻子钝、鼻型粗大；负：鼻子窄、鼻子太窄、鼻子细、鼻子太细；|\r
|长鼻|微调鼻部纵向长度，正向为缩短，负向为拉长；|正：缩短鼻子、鼻子变短、长鼻调整、鼻长优化、鼻子不太长、鼻型比例协调、缩短鼻长、调整鼻子长度；负：鼻、长鼻子、长鼻梁、高鼻梁、；|正：鼻子太长、鼻子显长；负：鼻子短、鼻梁短、鼻子太短、鼻梁太短、没鼻梁、塌鼻梁、鼻梁塌、；|\r
|嘴巴大小|放大或缩小嘴唇整体尺寸比例，匹配面部协调度，正向为缩小，负向为放大；|正：樱桃小嘴、缩唇、小嘴、调整嘴型、嘴巴缩小、嘴巴精致；负：放大嘴巴、嘴巴变大；|正：嘴巴大、嘴大、嘴型大；负：嘴巴太小；|\r
|嘴巴位置|调整嘴唇在面部的垂直位置，嘴巴整体上移，优化人中与唇颏关系；|嘴巴上移、嘴巴位置向上|嘴巴太靠下、嘴巴位置偏下|\r
|祛法令纹|淡化法令纹，优化鼻基底，平滑肌肤，减少年龄感；|去法令纹、淡化法令纹、遮法令纹、抚平法令纹、消除法令纹、法令纹平整、面部平整、减龄、填充、去沟壑|法令纹深、显老、脸垮、有沟、笑纹重、鼻翼沟深、老态、皮肤下垂、沟壑明显、八字纹、|\r
|白牙|提亮牙齿，去除黄渍暗沉；|白牙、牙齿美白、牙齿变白、亮白牙齿、去黄牙、洁牙、牙齿增白、牙齿亮白、牙白一点|牙齿黄、牙黄、黄牙|\r
\r
## 使用“美颜小项”需要遵守的规则\r
1.“美白-自然”、“美白-粉白”、“美白-白皙”是互斥的，在同一个参数文件中只能出现一种。\r