水彩分层结构研究图生成器

这是什么

Arch Kele Structure Photo 是一个面向 Codex 平台的图像生成 Skill，由开发者 architect-kele 创建。

它的核心功能是将用户提供的一张照片转换成具有编辑设计感的水彩分层结构研究图，并自动生成两张相互匹配的成品：

• 纯净版：只包含水彩结构图，不显示原始照片。
• 原图版：在同一张结构图的右上角加入未经重绘、未经裁切变形的原始照片。

第二张图由第一张图确定性合成，不会重新生成主体，因此除右上角原图区域外，两张图保持一致。

这种设计让创作者可以同时获得纯粹的视觉研究图和带有原始参照的对比版本。

适合谁

这个 Skill 特别适合以下人群：

• 建筑与设计爱好者：希望将建筑照片转化为结构分析图，用于学习或展示。
• 自媒体创作者：需要为文章、视频或社交媒体配图，制作具有艺术感的视觉素材。
• 教育工作者：可以将复杂结构拆解为清晰的分层图，辅助教学。
• 插画师与艺术家：探索水彩风格与结构表达的融合。

能做什么

• 保留关键特征：保留原照片中主体的轮廓、比例、视角、朝向、色彩关系和关键识别特征。
• 结构层级拆分：将建筑、物件等拆分为真实且可重新组合的结构层级。
• 空间深度处理：将室内、街景和景观转换为前景、中景、背景等空间深度层。
• 生物轮廓处理：对人物、动物和植物使用完整、克制的轮廓与色彩层，不进行解剖式拆分。
• 编辑设计感：使用暖白水彩纸、淡彩晕染、细墨线和少量分析辅助线形成编辑设计感。
• 默认竖版 3:4：自动生成竖版 3:4 画面，适合移动端阅读和社交媒体展示。
• 双版本输出：自动生成纯净版和右上角原图版两张成品。
• 容错机制：内置示例图不可用时，自动退回完整文字风格规范，不会中断任务。

使用前准备

• 确保已安装 Codex 并具备图像生成能力。
• 准备一张清晰的照片，主体明确，光线适中，以便 Skill 准确提取结构。
• 了解基本的 Codex 操作，例如如何调用 Skill 和上传图片。

安装方法

将整个仓库复制或克隆到 Codex Skills 目录。在 macOS/Linux 上，默认位置为：

~/.codex/skills/arch-kele-structure-photo/

Windows 默认位置通常为：

C:\Users\<你的用户名>\.codex\skills\arch-kele-structure-photo\

确认 SKILL.md 位于 Skill 根目录，然后重新打开 Codex 或刷新 Skills。

使用示例

向 Codex 上传一张照片，并在提示中调用 Skill：

使用 $arch-kele-structure-photo 将这张照片转换成水彩分层结构研究图。

也可以使用自然语言描述：

把这张建筑照片做成竖版水彩爆炸结构图，保留建筑比例和主要颜色。请输出两张：第一张不带原图，第二张在右上角放入原始照片。

Skill 默认按以下顺序返回：

1. 不带原始照片的纯净结构图。
2. 右上角带原始照片的对应版本。

右上角原图通过 scripts/add-source-inset.ps1 脚本加入，脚本会保持照片宽高比，并添加克制的暖白衬边和细边框。

风险与注意事项

• 图片版权：用户上传的照片始终是主体、几何、视角、配色和事实内容的唯一来源。请确保您有权使用该照片。
• 示例图仅作参考：assets/examples/ 中的图片只用于校准水彩、留白、分层和分析线条等视觉语言，不应复制其中的建筑、人物、标题或布局。
• 脚本依赖：add-source-inset.ps1 使用 PowerShell 和 System.Drawing，用于生成右上角原图版。如果运行环境无法执行该脚本，仍可生成第一张纯净版；第二张需要使用等效的图像合成工具完成。
• 输出一致性：由于第二张图由第一张图确定性合成，不会重新生成主体，因此除右上角原图区域外，两张图保持一致。但若脚本执行失败，可能影响第二张图的生成。