tensorslab Image Edit - 图像编辑工具
基于 tl-image 的 quickedit 模型实现快速图像编辑操作。
脚本路径
本技能使用 tl-image 技能的 tensorslab_image.py 脚本，配合 --model quickedit 参数。脚本位于 tl-image 技能的 scripts/ 目录下，必须使用绝对路径执行。根据 tl-image 技能的安装位置确定绝对路径。
例如，如果 tl-image 的 SKILL.md 位于 /path/to/skills/tl-image/SKILL.md，则：
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "<编辑指令>" --source <image_path> --model quickedit
授权
使用前需确保已通过 TensorsLab 授权。运行：
python "<tl-image绝对路径>/scripts/tensorslab_auth.py"
如果之前已授权过（~/.tensorslab/.env 中有 key），则无需重复授权。
提示词规则
所有传给脚本的提示词（prompt）必须用引号包裹，防止 shell 解析问题：
# 正确
python "scripts/tensorslab_image.py" "remove the watermark" --source photo.jpg --model quickedit
python "scripts/tensorslab_image.py" "把天空改成星空" --source photo.jpg --model quickedit
# 错误 - 没有引号
python "scripts/tensorslab_image.py" remove the watermark --source photo.jpg --model quickedit
功能说明
1. 变宽高比（aspect）
改变图片宽高比，保持内容不变。
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "保持画面内容不变，调整构图适应新的宽高比" --source input.jpg --model quickedit --resolution 16:9
支持的宽高比：1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、9:21
用户请求映射：
- "正方形"、"1:1" →
1:1 - "横屏"、"16:9"、"宽屏" →
16:9 - "竖屏"、"9:16"、"手机屏" →
9:16 - "4:3"、"标准" →
4:3
2. 擦除对象（erase）
从图片中移除指定对象。
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "remove the watermark from the image" --source photo.jpg --model quickedit
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "remove the person in the background" --source photo.jpg --model quickedit
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "remove the logo" --source photo.jpg --model quickedit
擦除提示词应明确描述要移除的对象，并用英文效果最佳。
3. 去除背景（rmbg）
移除图片背景，只保留主体。
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "remove the background, keep only the main subject" --source portrait.jpg --model quickedit
4. 通用编辑（edit）
使用自定义指令编辑图片。
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "change the sky to a starry night" --source input.jpg --model quickedit
python "<tl-image绝对路径>/scripts/tensorslab_image.py" "add snow effect" --source input.jpg --model quickedit --resolution 16:9
可选参数:
--resolution- 输出宽高比（如16:9、1:1）--output-dir- 自定义输出目录
编辑指令使用英文效果最佳，保留用户的创意意图。
通用参数
所有命令支持以下可选参数：
--output-dir或-o- 输出目录（默认:./tensorslab_output/）--resolution- 输出宽高比（如16:9、1:1）
文件名生成
生成文件名使用格式: yyyy-mm-dd-hh-mm-ss-name.jpg
格式: {timestamp}-{descriptive-name}.jpg
- Timestamp: 当前日期时间，格式
yyyy-mm-dd-hh-mm-ss（24小时制） - Name: 描述性小写文本，用连字符分隔
- 描述部分保持简洁（通常1-5个词）
- 使用用户提示或对话的上下文
- 如不明确，使用随机标识符（如
x9k2、a7b3）
示例：
- 擦除水印 →
2025-01-19-20-30-05-remove-watermark.jpg - 改为9:16比例 →
2025-01-19-20-31-12-aspect-9-16.jpg - 去除背景 →
2025-01-19-20-32-33-remove-bg.jpg - 添加雪花效果 →
2025-01-19-20-33-48-snow-effect.jpg
输出
- 图片默认保存到
./tensorslab_output/目录 - 脚本输出生成图片的完整路径和远程 URL
- 不要回读图片 - 只需告知用户保存路径
注意事项
- 输入图片支持常见格式：JPG、PNG、WEBP 等
- 编辑指令使用英文效果最佳
- quickedit 模型专为快速指令式编辑优化，响应速度快