From a7ff49b7ebbcd981e1b0a432b8ae46b48bcea3ca Mon Sep 17 00:00:00 2001 From: Bufan Deng <178316470@qq.com> Date: Wed, 14 Oct 2026 17:17:52 +0800 Subject: [PATCH] docs: refresh value proposition and processing architecture --- ARCHITECTURE.md | 2 +- README.md | 6 +- README.zh-CN.md | 6 +- docs/assets/architecture.svg | 330 ++++++++++++++++++++++------------- 4 files changed, 221 insertions(+), 123 deletions(-) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index e301c88..0f29f25 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 -UltraSplitter agent-native processing 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 ### Scan diff --git a/README.md b/README.md index 0caef20..99132e9 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,9 @@ Illustrated workflow · Static view -**Turn AIGC sheets into individual assets your production pipeline can actually use.** +**Split irregular asset sheets into reviewable, traceable assets.** + +AI identifies subjects; deterministic code splits original pixels into individual images and a layered PSD. Image models are good at presenting a family of ideas in one image: a UI icon set, weapon collection, character turnaround, building elevation sheet, furniture board, or product-variant grid. The sheet may look finished, but the assets inside it are still trapped in one bitmap. Uneven spacing, mixed scale, labels, touching silhouettes, and edge-clipped subjects make equal slicing unreliable. @@ -127,7 +129,7 @@ ultrasplit evaluate output/task/manifest.json --visual-verdict pass ## Architecture -UltraSplitter agent-native processing 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 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 6d63d18..90f4705 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -8,7 +8,9 @@ 直观流程插画 · 查看静态版 -**把 AIGC 生成的整张方案图，变成生产流程真正能用的独立资产。** +**把不规则素材图拆成可审核、可追溯的独立资产。** + +AI 识别主体，代码按原图像素拆分，输出图片与分层 PSD。 图片模型很擅长在一张图里展示一组创意：UI 图标、武器合集、角色多视图、建筑立面、家具方案、产品变体。整图看起来已经完成，但里面的素材仍被锁在一个位图文件中。间距不均、尺寸混杂、文字边框、轮廓相接和主体截断，都会让均匀切图失效。 @@ -127,7 +129,7 @@ ultrasplit evaluate output/task/manifest.json --visual-verdict pass ## 架构 -UltraSplitter AI 原生处理架构 +不规则素材图经过扫描、语义规划、原像素路由和主视觉审核后，交付图片与分层 PSD；另含可选的透明版本审阅和重建路径 每次运行都会写入 schema v3 的 `manifest.json`，记录准确的源图坐标、路由依据、来源追踪、批准状态、有界修复次数、评估结果和绝对访问路径。完整设计见 [ARCHITECTURE.md](ARCHITECTURE.md)。 diff --git a/docs/assets/architecture.svg b/docs/assets/architecture.svg index 49be01a..365541d 100644 --- a/docs/assets/architecture.svg +++ b/docs/assets/architecture.svg @@ -1,131 +1,225 @@ - - UltraSplitter agent-native architecture - A generated asset sheet flows through deterministic scanning, multimodal inventory and scope alignment, source-preserving routes, approval-gated reconstruction, primary delivery review, optional independent transparent-variant review, bounded reflection, and final delivery. + + 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. - - - - - - + + - - - - - + + + + + + + + + + + + - - - - ULTRASPLITTER / AGENT-NATIVE PIPELINE - generated sheet → usable, traceable assets - schema v3 · bounded repair - - - - - ┌ INPUT - │ AIGC asset sheet - └ mixed subjects.png - - - 01 / SCAN - pixels → regions - exact source coords - - - 02 / REFLECT + PLAN - inventory subjects; - align ambiguous scope - - - 03 / APPLY + ROUTE - exact candidate IDs; - repair only if needed - - - 04 / MAIN REVIEW - preview + each asset - pass → primary delivery + + + + ULTRASPLITTER / PROCESSING MODEL + From mixed sheet to traceable delivery + Semantic scope by a multimodal host · source pixels by deterministic tools · reconstruction only with approval + + SYSTEMS VIEW / 01 + + + + + + + + + + + + + + + + + + + + 00 / INPUT + Irregular asset sheet + mixed scale · uneven spacing + source pixels stay authoritative + + + + + + + + + + 01 / SCAN + Deterministic regions + panels or simple backgrounds + exact oriented-source coordinates + + + + + + + + + + + + 02 / PLAN + Semantic inventory + host groups stable region IDs + clarify ambiguous scope with user + + + + + + + + + + + + + 03 / APPLY + ROUTE + Source-preserving paths + crop · composite · approved repair + missing pixels require approval + + + + + + + + + + + 04 / REVIEW + Primary visual gate + compare inventory and every asset + only an explicit pass proceeds + + + + + + + + + + + 05 / DELIVER + Images + layered PSD + numbered pages when canvas is full + manifest records paths and provenance - - - - - failed review → revise one named cause - - - - - - - - - ├─ source_crop - - ├─ source_composite - - └─ generated_reconstruction + + + + - - - - - - - A / TRIAGE - deliver · repair - ignore · ask user - - - B / APPROVAL - show targets + cost - user authorizes once - - - C / AIGC GRID - one group · one grid - complete + normalize - - - D / INGEST + SPLIT - validate grid → assets - - - E / EVALUATE - pass / retry ≤ 2 / exit - - - T / ALPHA QA - white · black · checker - pass → optional variant + + + CONDITIONAL REPAIR / ONLY FOR APPROVED, IDENTITY-GROUNDED SUBJECTS + Reconstruction is inferred content; it returns to the same primary review gate. + + + + + A / APPROVAL + Show scope + cost + User approves the exact + repair group before generation. + B / GENERATE + One constrained grid + One regular grid per conflict + group; generated pixels labeled. + C / INGEST + Validate + re-split + Deterministic checks, then + return to primary review. - - - - - - - - retry only the failed constraint - - visual pass - - - primary assets stay independent · transparent variants require their own pass · generated pixels stay labeled + + + + + INCOMPLETE / CLIPPED + + + + + + OPTIONAL TRANSPARENT VARIANT REVIEW + Separate gate after primary assets pass. + + OPTIONAL + + + + + + + + WHITE + BLACK + CHECKER + Transparent PNGs are promoted only after their own visual pass. + + + + + + DELIVERY CONTRACT + Named images + layered PSD page set + PSD export follows primary visual approval. + + CANVAS LIMIT + 30,000 px per side + Overflow uses more PSD pages; oversized sources use native-pixel tiles. + + PROVENANCE + Paths, routes + review state + Recorded in the schema-v3 manifest. + SOURCE PIXELS + + APPROVAL-GATED RECONSTRUCTION + + OPTIONAL ALPHA REVIEW +