diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 0f29f25..0af6305 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -8,7 +8,7 @@ The core package is provider-neutral. A multimodal host such as Codex or Claude ## Processing model -Processing pipeline from irregular source sheet through scanning, semantic planning, source-pixel routing, primary review, optional transparency review, and PNG plus layered PSD delivery +Processing pipeline with deterministic repair-grid checks, visual review of every primary asset, manifest export gates, optional transparency review, and PNG plus layered PSD delivery ### Scan diff --git a/README.md b/README.md index 99132e9..4e9b092 100644 --- a/README.md +++ b/README.md @@ -129,7 +129,7 @@ ultrasplit evaluate output/task/manifest.json --visual-verdict pass ## Architecture -Processing pipeline from irregular source sheet through scanning, semantic planning, source-pixel routing, primary review, optional transparency review, and PNG plus layered PSD delivery +Processing pipeline with deterministic repair-grid checks, visual review of every primary asset, manifest export gates, optional transparency review, and PNG plus layered PSD delivery Every run writes a schema-v3 manifest with exact source coordinates, route evidence, provenance, approval state, bounded repair attempts, evaluation status, and absolute delivery paths. See [ARCHITECTURE.md](ARCHITECTURE.md). diff --git a/README.zh-CN.md b/README.zh-CN.md index 90f4705..a6f5ea5 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -129,7 +129,7 @@ ultrasplit evaluate output/task/manifest.json --visual-verdict pass ## 架构 -不规则素材图经过扫描、语义规划、原像素路由和主视觉审核后,交付图片与分层 PSD;另含可选的透明版本审阅和重建路径 +不规则素材图经过修复宫格确定性检查、主资产视觉审核和 manifest 导出门控后,交付图片与分层 PSD;另含可选透明版本审核和审批后修复路径 每次运行都会写入 schema v3 的 `manifest.json`,记录准确的源图坐标、路由依据、来源追踪、批准状态、有界修复次数、评估结果和绝对访问路径。完整设计见 [ARCHITECTURE.md](ARCHITECTURE.md)。 diff --git a/docs/assets/architecture.svg b/docs/assets/architecture.svg index 365541d..3286657 100644 --- a/docs/assets/architecture.svg +++ b/docs/assets/architecture.svg @@ -1,4 +1,4 @@ - + UltraSplitter processing model An irregular asset sheet passes through deterministic scanning, host-led semantic planning, source-pixel routing, primary visual review, and delivery as named images, layered PSD pages, and a provenance manifest. Incomplete subjects may enter an approval-gated reconstruction path. Transparent variants use a separate optional review gate. @@ -43,8 +43,8 @@ - - + + ULTRASPLITTER / PROCESSING MODEL From mixed sheet to traceable delivery @@ -216,10 +216,26 @@ PROVENANCE Paths, routes + review state Recorded in the schema-v3 manifest. - SOURCE PIXELS - - APPROVAL-GATED RECONSTRUCTION - - OPTIONAL ALPHA REVIEW - + + + + VALIDATION METHODS / THREE DISTINCT EVIDENCE LAYERS + + DETERMINISTIC / REPAIR GRID + Resolution · occupied count · background consistency + Edge contact · safe margin · duplicate shapes + VISUAL / ALL PRIMARY ASSETS + Identity · pose · silhouette · color + Material · ornament · absence of redesign + MANIFEST / EXPORT GATE + Schema v3 · triage · approval · retry limit + Visual verdict must pass before PSD export + AUTOMATED CHECKS FLAG MEASURABLE DEFECTS; VISUAL REVIEW CHECKS IDENTITY; THE MANIFEST GATE CONTROLS PSD EXPORT. + + SOURCE PIXELS + + APPROVAL-GATED RECONSTRUCTION + + OPTIONAL ALPHA REVIEW + diff --git a/docs/assets/architecture.zh-CN.svg b/docs/assets/architecture.zh-CN.svg new file mode 100644 index 0000000..4e74054 --- /dev/null +++ b/docs/assets/architecture.zh-CN.svg @@ -0,0 +1,241 @@ + + UltraSplitter 处理流程 + 不规则素材图经过确定性扫描、主体规划、原像素路由和主视觉审核,最终交付命名图片、分层 PSD 与来源清单。主体不完整时,可进入经批准的修复流程。透明版本另设可选审核。 + + + + + + + + + + + + + + + + + + + + + + + + ULTRASPLITTER / 处理流程 + 从混合素材图到可追溯交付 + AI 识别主体 · 确定性工具按原像素拆分 · 修复须经批准 + + 系统视图 / 01 + + + + + + + + + + + + + + + + + + + + 00 / 输入 + 不规则素材图 + 尺度混杂 · 间距不齐 + 拆分以原图像素为准 + + + + + + + + + + 01 / 扫描 + 确定性候选区域 + 分隔线或简单背景 + 坐标对应旋转校正后的原图 + + + + + + + + + + + + 02 / 规划 + 主体清单 + 识别主体并归组 + 范围有歧义时先确认 + + + + + + + + + + + + + 03 / 执行与路由 + 保留原像素的处理路径 + 裁切 · 合成 · 经批准的修复 + 补全缺失像素须经批准 + + + + + + + + + + + 04 / 审核 + 主视觉审核 + 逐一对照清单与素材 + 通过后才能继续 + + + + + + + + + + + 05 / 交付 + 图片 + 分层 PSD + 画布超限时自动分卷 + 清单记录路径与来源 + + + + + + + + + + + 审批后修复 / 仅限身份明确且已获批准的主体 + 修复内容属于推断,完成后返回主视觉审核。 + + + + + A / 审批 + 展示范围与成本 + 用户先批准具体的 + 修复组,再开始生成。 + B / 生成 + 一次受限网格 + 每个冲突组只生成一个 + 规则网格;标记生成像素。 + C / 导入 + 校验并重新拆分 + 通过确定性检查后, + 返回主视觉审核。 + + + + + + 主体不完整 / 被截断 + + + + + + 可选 / 透明版本审核 + 主资产通过后单独审核。 + + 可选 + + + + + + + + 白底 + 黑底 + 棋盘格 + 透明 PNG 通过独立视觉审核后才会纳入交付。 + + + + + + 交付规范 + 命名图片 + 分层 PSD 分卷 + 主视觉审核通过后导出 PSD。 + + 画布上限 + 每边 30,000 px + 超限时增加 PSD 分卷;单件过大则按原像素切块。 + + 来源追踪 + 路径、处理方式与审核状态 + 记录于 schema-v3 manifest。 + + + + 校验方法 / 三个不同的证据层 + + 确定性检查 / 修复宫格 + 分辨率 · 有效格数 · 背景一致性 + 触边 · 安全留白 · 重复图形 + 视觉审核 / 全部主资产 + 身份 · 姿态 · 轮廓 · 色彩 + 材质 · 装饰 · 是否发生重设计 + Manifest 门控 / 导出条件 + Schema v3 · 分诊 · 批准 · 重试上限 + 主视觉结论通过后才导出 PSD + 自动检查定位可量化缺陷;视觉审核判断主体一致性;manifest 门控决定能否导出 PSD。 + + 原图像素 + + 经批准的图像修复 + + 可选透明版本审核 + +