核心用法
Skywork Design 是一款面向 Claude Code 的图像生成与编辑 Skill，通过调用 Skywork AI 官方后端 API 实现高质量视觉内容创作。用户需先完成 OAuth 认证获取 Token，支持环境变量、本地缓存或浏览器登录三种方式。
生成模式：使用 generate_image.py 脚本，通过 --prompt 参数描述场景，可选 --aspect-ratio（支持 1:1 至 21:9 共 10 种比例）和 --resolution（1K/2K/4K）控制输出规格，生成时间约 2 分钟。
编辑模式：添加 --input-image 参数对现有图片进行修改，支持风格转换、元素增删、色彩调整等操作，单任务可保留最多 4 个人物特征和 10 个物体 fidelity。多图参考可通过多次 -i 参数实现风格融合。
脚本内置完善的 Prompt Engineering 指南，强调场景叙事描述而非关键词堆砌，支持摄影术语控制构图、双引号标注图片内文字等高级技巧。同时提供电商、故事板、信息图、Logo、品牌 VI、宣传册、社交媒体、海报等 8 大垂直场景的专项工作流文档。
显著优点
1. 官方 API 保障：直接对接昆仑万维 Skywork AI 官方服务，模型能力与稳定性有企业级背书，非社区开源模型可比。
2. 专业设计导向：超越通用文生图工具，针对商业设计场景深度优化，提供分辨率分级（草稿 1K 到印刷级 4K）、精确画幅控制、多图融合编辑等专业功能。
3. 场景化工作流：8 大设计场景文档覆盖电商主图、品牌 VI、社交媒体运营等高频需求，降低专业设计门槛。
4. 安全纯净：代码仅依赖 Python 标准库，零第三方依赖风险；网络通信全链路 HTTPS 加密，数据不出境。
5. 灵活认证机制：支持无头环境（env token）、半自动化（缓存 token）和交互式（浏览器登录）三种认证模式，适配 CI/CD 到个人创作多种场景。
潜在缺点与局限性
1. 会员门槛：存在"Insufficient benefit"限制，部分高级功能需升级 Skywork 会员，免费层可能有额度或分辨率限制。
2. 生成延迟：单张图片约 2 分钟生成时间，不适合实时交互场景，批量任务需预留充足时间。
3. 平台绑定：深度绑定 Skywork AI 生态，无法切换至 Midjourney、Stable Diffusion 等其他模型，风格可控性取决于 Skywork 底层能力。
4. 本地计算依赖：图片 Base64 编码、浏览器拉起等操作需本地环境支持，纯云端/容器环境可能受限。
5. 编辑能力边界：人物特征保留上限 4 个、物体 fidelity 上限 10 个，复杂多主体场景可能需要分步处理。
适合的目标群体
- 自媒体运营者：快速产出社交媒体封面、九宫格配图、短视频封面，支持 9:16、4:5 等平台原生比例。
- 电商从业者：商品主图、详情页视觉、促销海报生成，场景化文档降低外包成本。
- 初创企业/个体设计师：Logo、品牌 VI、宣传册等基础设计资产自助产出。
- 内容创作者：故事板、信息图、文章配图等视觉叙事辅助工具。
- 开发团队：需要程序化生成批量视觉资产的自动化场景（配合 CI/CD 使用 env token 认证）。
使用风险
1. 服务可用性风险：Skywork AI 服务端可能出现 HTTP 500 错误或连接拒绝，关键业务场景建议增加重试机制和降级方案。
2. Token 安全管理：虽然存储于用户主目录，但明文 JSON 格式在共享环境/多用户服务器上存在泄露风险，建议设置文件权限 600 或使用密钥环存储。
3. 成本可控性：图像生成 API 通常按量计费，高频调用前需确认账户额度，避免突发流量导致服务中断。
4. 浏览器拉起限制：部分远程开发环境（SSH、容器）无法自动打开浏览器，需人工处理 [LOGIN_URL] 提示完成认证。
5. 版权与商用合规：生成内容的版权归属、商用授权需遵循 Skywork AI 服务条款，高风险商用场景建议获取法律确认。