十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Impeccable 方向合成与资产生产指南:从三张 Comp 到可测度的构建规格

Impeccable 方向合成与资产生产指南:从三张 Comp 到可测度的构建规格 Impeccable 方向合成与资产生产指南从三张 Comp 到可测度的构建规格【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable本指南基于 Impeccable 技能体系中visualize参考文档.qoder/skills/impeccable/reference/visualize.md展开讲解在comp-led合成驱动构建中如何生成方向合成图Direction Comp、把选择权完整交给用户、并把最终批准的合成图转换为可被机器测量的构建规格与可溯源的栅格资产。读者将掌握 Impeccable 中generate-image、serve-question、comp-spec、build-phase、embed-prompt等命令的完整用法理解合成即规格、像素即证据这条贯穿整个构建流程的纪律。何时加载本文件comp-led 构建的合成轮次visualize.md不是一份独立的操作手册而是 new-work.md 工作流中的一个环节由后者按需加载。它有两个严格的前置判定仅在 comp-led 构建且图像生成可用时加载harness 原生图像工具或impeccable context报告的 API 回退能力。code-led代码驱动构建按契约跳过本文件这是设计决策而非流程漂移——code-led 的野心承载在方向契约direction contract的 FIRST VIEWPORT 块与具名签名交互中由 finish reviewer 在行为层面审计。PRODUCT.md 与 DESIGN.md 是前置条件。new-work 已经解决了视觉世界问题本文件不得重新打开它调色板、字体方向、材质语言、组件性格、图像立场、动词语法全部保持固定probe 只测试构图、叙事、层级、密度、焦点时刻、签名运用与图像需求不是第二次身份工作坊。还有一个重要的已结算分支如果 surface-scope 的结构轮次已经通过决策页把三张可视化卡片放在用户面前即 new-work 中的世界已经建立那么这一轮已经完成——被锁定的卡片其 comp 即为已批准合成图此时只需记录批准并跳到After approval继续不再生成任何新内容。合成轮次的前提build-phase 状态机Comps 轮次运行在构建的 phase 状态内。在生成第一张 comp 之前必须已经执行impeccable build-phase start --direction seed key --kind ...roll 的输出会给出确切命令surface 轮次已锁定 comp 时使用start --comp approved comp。从源码看build_phase.rs 定义了完整的八个阶段comps → spec → plates → hero → sections → motion → responsive → review构建状态以状态机形式持久化在.impeccable/build/state.json。规则是在comps阶段打开之前渲染的 comp 处于状态之外从那个时间点恢复的会话没有可跟随的阶段impeccable generate-image会拒绝在build-phase start运行之前向.impeccable/mocks/写入文件harness 原生图像工具同样受此顺序约束。生成三个构图选项三张的方向测试不是三张截图渲染三张互不相同的高保真 north-star 合成图保存到.impeccable/mocks/下以跨会话存活。三张是纪律而非数字一张会诱导橡皮图章式通过三张之间的差异才能让值得构建的构图浮出水面。视图框纪律按表面自身的视口合成——原生应用或移动优先的表面用设备尺寸的竖版portrait桌面用横版landscape。把手机屏幕合成成横版是在任何代码构建之前就误述构图。合成是构建线程自己的工作绝不委托写出 prompt 的线程持有方向的完整上下文并且在构建开始时已经看过每一张 comp。打开图像的路径纪律用工作区相对路径打开每张图沙箱化的查看器会拒绝绝对路径。既有世界上用像素锚定身份在既有世界上每张 comp 都必须锚定真实身份截取一张有代表性的现有页面截图作为参考图传入harness 图像工具的输入图或impeccable generate-image --ref。prompt 以新表面的结构开头而参考图承载调色板、字体与组件性格——因为 DESIGN.md 的文字描述会漂移而像素参考不会。要明确命名参考图贡献什么、禁止贡献什么继承chrome、调色板、字体、组件性格禁止参考页自身的内容。原样搬来的 banner、hero 或卡片是参考图的泄漏不是保真。结构优先主题在场四条自检纪律每条都有对应的反面失败模式comp 是设计好的表面不是主体的图片。prompt 以表面自身的结构开头这个设计有哪些区域、按顺序命名、给出它们的比例关系。没有导航的页面要明说没有导航非传统表面要明说非传统骨架。以氛围开头的 prompt 只会得到一张小景画——模型画的是鱼市而不是鱼市的网站。每次渲染后自检如果能当海报挂起来或读起来像是印了字的照片那就不是 comp需要用更字面的布局脚手架重新生成。反面同样是失败表面里没有主体。主体以区域容纳的内容形式出现世界只是装点画框绝不取代画框展示的内容。删除通常搭着 prompt 的排除清单混进来——所以排除清单用于约束虚构声明媒介禁令属于已承诺的图像立场而不是谨慎。验收渲染前先指出主体画出整个世界却与主体无关的渲染无论氛围多忠实都算失败。按交付屏幕评判 comp访客的任务必须能从图像本身读出来无字幕即可命名表面的模式。读不出模式的渲染是只有艺术指导、没有表面。承诺是深度不是覆盖。世界通过一个主导动作加上支撑它的材质、字体与间距进入其余区域保持安静以让那个动作可读。裁剪的是竞争不是内容安静的区域保留信息、停止表演。第二个与具名焦点时刻同尺度的元素意味着 comp 在喊叫没有具名焦点时刻时多个区域同时表演概念同样是喊叫。保留最强动作、安静其余然后重新生成。忙碌只是更响不是更大胆。变化策略用户多选了概念时把三张分散到这些概念上方向已承诺时变化图像能解决的结构不确定性拓扑、序列、密度、层级、焦点构图或交互框架展示开场时刻之外足够多的内容证明概念能统治整个表面禁止生成调色板制品、提出新的氛围问题、引入不同的字体声音、发明新母题。如果已承诺的世界支撑不起概念回到概念候选清单而不是改变世界。每张 comp 都是方向测试而非截图规格核心 UI 文案、响应式行为、无障碍、语义与交互状态仍是实现责任。唯一的批准点如何展示与提问把三张 comp 一起展示在决策页上impeccable serve-question每个选项一张 comp 作为其 hero 图或仅在 harness 能内联渲染图像时用 harness 展示——纯文本表面不算展示。向用户问三件事什么应该保留、什么对世界显得虚假、所选概念应批准、合并、修改还是拒绝。然后停下等待。结构化模拟用户structured simulated user算作已到场收到同样的问题。从 serve_question.rs 的实现看--start --payload file会把服务器以 detached 方式拉起、打印页面 URL 与 keypayload 的每个选项携带hero/board/comp字段其中comp指向该方向的全保真合成图本地路径会被服务器转成/img/idx内联服务页面按选项轮询直到图像落地。收集答案用--wait --key key退出码 3 表示尚未作答需继续等待。委托与降级批准前不得开始写代码除非用户明确委托选择。若委托则依据任务简报、PRODUCT.md 与 DESIGN.md 选择并陈述证据。批准会精化任务概念不会修改 DESIGN.md。这个批准点没有替代品、没有跳过条件结构化问题工具出错时回退到决策页两者都失败后才可把选择视为已委托被委托的选择与批准一样被记录并在第一次回复中披露而非最后一次。finish reviewer 会把 comp 轮次中没有记录批准的 comp视为实质性发现material finding。注意.impeccable/mocks/decision/下的决策 comp 是方向轮次的产物、不代表任何批准。记录批准批准后把选择记录到工具能读到的地方被批准 comp 的路径写入surface brief它的.jsonprompt 侧车文件sidecar写入approved: true——每张通过impeccable generate-image生成的 comp 都有侧车原生工具没写就手动创建。从 build_phase.rs 的 comps 门禁实现可以看到它扫描.impeccable/mocks/下每个 comp 的侧车统计approved: true的数量零个则拒绝关闭提示先把三张 comp 放上决策页并设置批准标记多于一个同样拒绝必须恰好一个恰好一个时把该路径写回状态成为approved comp这正是impeccable build-phase advance用来关闭 comps 阶段的依据。侧车随 mocks 目录一起移动因此批准能跨会话、跨机器存活即使那些机器永远看不到 brief。批准后还需总结构图与 comp 中不得字面照搬的部分回到 new-work.md从批准的概念记录方向契约然后开始构建。批准之后comp 成为规格被批准的 comp 是翻译成语义化、响应式、无障碍代码的北极星绝不是重新构图的许可——保留调色板和情绪却重画拓扑是第二次艺术方向。两条禁令不得栅格化核心 UI 文本或控件未经询问不得在批准后替换不同的视觉驱动。规格阶段测量而非记忆new-work.md 第 6 节把构建作为阶段运行规格阶段把 comp 变成区域框region boxes与采样调色板impeccable comp-spec --comp comp --grid # 在 comp 上写坐标网格 impeccable comp-spec --comp comp --regions file impeccable comp-spec --print # 此后构建的参照从 comp_spec.rs 的源码看网格是 A0 到 J9 的 10×10 坐标体系区域以E0:J4形式的网格跨度命名并换算成归一化盒坐标x/y/w/h每个区域携带盒坐标、采样调色板与媒介种类spec.json落在.impeccable/build/spec.json。kind的取值见 comp_spec.rsplate/image/texture用于一切画出来的内容text/control/chrome/band用于代码绘制的内容。每个区域的媒介由像素决定不由什么好构建决定插图、产品实物、机械装置、任何带透视/阴影/绘画技巧的图形以及按名字出现的纹理织物、纸张颗粒、皮革、拉丝金属→plate/image/texture区域以栅格交付文本、控件、chrome、可数元素的图表、扁平形状系统、以及必须移动/缩放/响应的一切 → 语义化。用 CSS 去仿制雕刻面板的质感、用大量顶点的clip-path去仿撕纸边缘是对已批准设计的静默删除——检测器的 organic-clip-path 与 buried-raster 规则以及 hero 门禁的区域评分会抓住它。丢弃图像原生区域是用户在批准点做的范围决策绝不是批准之后的静默扁平化。Plates 与溯源Provenance生产流程每个栅格区域的 plate 在plates 阶段、任何页面代码之前产出由随附的资产生产者或当前线程完成impeccable comp-spec --crop id # 写出参考裁片 impeccable comp-spec --plate-prompt id --background transparent prompt.txt # harness 原生工具传入裁片与 prompt 文件API 回退 impeccable generate-image --ref crop.png --prompt-file prompt.txt \ --out plate.png --size WxH --quality high --background transparent细节纪律隔离剪影独立墨迹、人物、物体使用原生透明 PNG--background transparent同时用于 plate-prompt 与生成命令让它坐在页面自己的底色上全幅图像用--background opaque。从 generate_image.rs 的实现看--background只接受transparent/opaque/auto三值且要求--out是.png路径先创建输出目录再在亮底与暗底上检查 alpha、白色前景、精细边缘与镂空使用原生 PNG alpha保留白色涂料与清晰间隙不要对原生输出做 chroma-key。生成上下文是资产的一部分任何工具生成任何图像后都要把工具实际收到的精确 prompt 字符串写进文件内部generate-image会自动完成这一步impeccable embed-prompt image --prompt prompt # 精确写入 impeccable embed-prompt image --read # 读回 impeccable embed-prompt --scan dir # 列出缺失的栅格从 embed_prompt.rs 的源码看PNG 通过tEXt块以关键字impeccable:prompt内嵌JPEG 用 COM 段其他格式回退到.json侧车读取时先查内嵌、无内嵌则回退侧车——这与generate-image每次生成同时写出的.json侧车含prompt、createdAt、tool、model、可选的refs与background见 generate_image.rs互为备份。内嵌 prompt 加上 spec 中该区域的行就是栅格的溯源provenanceartifact 引用的每个栅格都必须携带它有来源的、素材库的、或预先存在的栅格改为内嵌其来源。修复批次或评审者重建中新建/替换的栅格按同一方式生产被放弃的栅格在同一批次中删除。图像转换用impeccable context在启动时报告的转换器IMAGE_TOOLS 行转换图像格式只有在它报告没有可用转换器时才主动探测每会话最多一次绝不逐图探测。从 context_cli.rs 的实现看探测顺序为cwebp, sips, magick, ffmpeg全部缺失时明确要求直接交付 PNG 输出不转换。后置生成处理generate-image在成功写入图片后会自动以捕获的精确 prompt 调用内嵌逻辑并在输出行报告prompt embedded sidecar若内嵌失败会明确报错见 generate_image.rs。无 API key 时命令会拒绝执行并提示改用 harness 原生图像工具测试环境下可通过设置IMPECCABLE_IMAGE_GEN_FAKE环境变量让命令输出带 SYNTHETIC COMP 标记的合成占位图而不调用 API——这是源码中为离线回归准备的路径生产环境不应依赖。回到主流程plate 与溯源完成后返回 new-work.md 继续方向契约已由批准的 comp 确立随后是 spec → plates → hero → sections → motion → responsive → review 的阶段化构建与收尾审查。在 comp-led 路径中hero 门禁会对首屏做像素级对比build_phase.rs 中的HERO_MIN 0.7272% 整体相似度且无硬性否决项plates 门禁要求每张 plate 至少达到区域尺寸的 1.5 倍并读作该区域——这些数字就是编辑的依据也是合成即规格从本文件落到构建状态机的最后一环。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表