image-lowlight-enhance - SKILL.md Agent Skill

name: image-lowlight-enhance description: "对偏暗、夜景或曝光不足的已有图片进行暗部提亮与细节恢复，保持亮部不过曝。仅在用户明确说明是暗光、夜景或曝光不足修复，并已提供图片时触发；泛化的“提亮”或普通调色需求不单独触发。" version: "1.0.0" metadata: {"openclaw":{"requires":{"bins":["meitu"],"env":["MEITU_OPENAPI_ACCESS_KEY","MEITU_OPENAPI_SECRET_KEY","MEITU_OPENAPI_TOOL_TASK_MODE"],"paths":{"read":["~~/.meitu/credentials.json","~~/.meitu/tool-registry.json","~~/.openclaw/workspace/visual/","./openclaw.yaml"],"write":["~~/.openclaw/workspace/visual/","./output/"]}},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY"}} requirements: credentials: - name: MEITU_OPENAPI_ACCESS_KEY source: env | ~/.meitu/credentials.json - name: MEITU_OPENAPI_SECRET_KEY source: env | ~/.meitu/credentials.json env: MEITU_OPENAPI_TOOL_TASK_MODE: command permissions: - type: file_read paths: - ~/.meitu/credentials.json - ~/.meitu/tool-registry.json - ~/.openclaw/workspace/visual/ - ./openclaw.yaml - type: file_write paths: - ~/.openclaw/workspace/visual/ - ./output/ - type: exec commands: - meitu

图片暗部增强（image-lowlight-enhance）

Overview

暗光/夜景/曝光不足图片的智能亮度提升与暗部细节恢复。覆盖夜景拍摄提亮、暗光环境照片修复、曝光不足挽救、逆光/高对比场景补光；保持亮部不过曝的前提下提亮暗部、暗部噪点自动抑制。仅需 image_url，不需要 prompt。

执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将用户提供的图片 URL 发送到 Meitu OpenAPI 处理，并把结果写入 ./output/ 或 $VISUAL/output/image-lowlight-enhance/。

API Mapping

暗光/夜景图片增强：image_lowlight_enhance

Dependencies

meitu-cli: >=2.0.6（npm install -g meitu-cli@latest）
凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver

Preflight

meitu --version ≥ 2.0.6（否则 npm install -g meitu-cli@latest）
确认已跑过 meitu tools update（用 CONFIG AKSK）
当前 AKSK = EXEC，且 MEITU_OPENAPI_TOOL_TASK_MODE=command
解析 output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/image-lowlight-enhance/；mkdir -p

Execute

触发信号 / 路由规则

场景	判定关键词	路由
太暗 / 夜景 / 曝光不足	太暗、夜景、提亮、暗光、逆光、曝光不足	`image_lowlight_enhance`

决策顺序：

image_url 缺失 → 追问
唯一路由：调用 image_lowlight_enhance

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。图片本身曝光正常 → 正常调用，告知用户"原图曝光正常，增强后可能偏亮"。极度欠曝（纯黑）→ 正常调用，效果可能有限。

参数定义

参数	类型	必填	范围	默认值	说明
`image_url`	STRING	是	--	--	图片地址。缺失 → 提示"请提供需要增强的图片"

工具调用

meitu image-lowlight-enhance \
  --skill_name skill_image-lowlight-enhance \
  --image_url <image_url> \
  --json \
  --download-dir {output_dir}

错误降级

场景	处理方式
`image_url` 缺失	提示"请提供需要增强的图片"
`image_url` 不可访问	直接返回图片链接无效错误，不重试
图片本身曝光正常	正常调用，告知"原图曝光正常，增强后可能偏亮"
极度欠曝（纯黑）	正常调用，效果可能有限，告知用户
`image_lowlight_enhance` 调用失败	重试 1 次，仍失败返回错误
内容合规拦截	返回合规提示，不重试
视频输入	拒绝，仅支持图片

Deliver

直接使用 Preflight 解析的 output_dir
从 downloaded_files[0].saved_path 读取已下载文件路径
mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-lowlight-enhance.jpg

Output

格式：JPEG/PNG（保持原格式）
命名：{YYYY-MM-DD}_{descriptive}_image-lowlight-enhance.jpg
位置：项目 → ./output/，一次性 → $VISUAL/output/image-lowlight-enhance/

基线 Task ID

见 references/task-id-baseline.md 中对应行。