feat(pixel-grid): add independent native grid reconstructor by huyanxius · Pull Request #495 · 1024XEngineer/Windup

huyanxius · 2026-08-20T12:18:11Z

新增与检测器和业务应用解耦的显式网格重建库：调用方给定网格后，Rust 模块返回每格单色的原生 1x PNG；源码位于仓库根目录，不属于 Python 后端。

Why

网格识别与像素重建是两种不同职责。把重建逻辑绑定在检测器、Python 后端或生成管线中，会导致后续替换检测算法时同时改动颜色恢复，并扩大本地算法的业务耦合。

Changes

新增独立 Rust library，只接收 PNG/JPEG、cols、rows、colors 并返回 PNG。
使用两阶段结构标签投票与原色恢复，使 colors 只控制结构聚类，不硬性截断最终全局色板。
钳制密集网格的负三角权重，避免颜色外插产生荧光坏点。
在解码和算法分配前限制 32MiB 输入、4MP 像素和 128MiB 保守工作集。
将模块放置在 native/pixel-perfect/crates/reconstructor/，删除生产 stdin/stdout CLI。
更新独立 path-filter CI、MIT 许可证和固定上游版本说明。

Implementation

reconstruct_bytes 是唯一算法入口；网格参数是唯一空间契约，模块不推断像素密度。
重建器使用 crate-local manifest 与 lockfile，可在检测器尚未合入时独立构建。
Python 原生扩展与工具 API 由 feat(pixel-perfect): expose an independent tool API #492 单独交付。

Verification

cargo fmt --check：通过。
cargo test --release --locked：8 项测试通过，0 项失败。
git diff --check upstream/main...HEAD：通过。
GitHub Actions：等待当前 head 完成。

Scope

本 PR 不包含：网格检测、PyO3 binding、Python API、Docker 装配、前端或默认生成管线集成。
colors 不是最终图片颜色数上限，不强制 16 色，也不额外引入黑色。
后续事项：feat(pixel-perfect): expose an independent tool API #492 通过 PyO3 在独立工具 API 层组合本模块与 feat(pixel-grid): add an independent grid detector #490。

Related Issues

Closes #491

Refs #489

Detected grids need a separate local stage that can rebuild one color per cell. Add deterministic two-stage reconstruction with bounded memory and explicit grid arguments. Images can now be rebuilt without invoking detection, application services, or generation flows.

The native reconstructor needs a reproducible package boundary and dependency graph. Add the Rust manifest, locked dependencies, and local target exclusion. The reconstruction module can now build independently with deterministic inputs.

Explicit reconstruction must preserve source colors without creating dense-grid artifacts. Cover exact cells, uncapped final palettes, bad points, input limits, and working-set rejection. Color and resource regressions now fail before this module reaches the application layer.

The extracted reconstruction algorithm must remain traceable and license compliant. Document its explicit-grid contract, two-stage color behavior, fixed upstream revision, and MIT terms. Maintainers can review the reuse boundary without consulting the generation codebase.

The standalone reconstructor needs a narrow gate independent of backend CI. Run format and locked release tests only for reconstructor paths and its workflow. Reconstruction changes now receive isolated validation without touching generation jobs.

vercel · 2026-08-20T12:18:15Z

Deployment failed for project windup with the following error:

Resource is limited - try again in 24 hours (more than 100, code: "api-deployments-free-per-day").

Learn More: https://vercel.com/huyan-s-projects1?upgradeToPro=build-rate-limit

codecov · 2026-08-20T12:19:52Z

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

fennoai

审查了独立重建器的输入边界、两阶段标签/颜色恢复、透明度多数票、CLI 参数契约、工作集估算以及 path-filter CI。发现透明 PNG 的可见颜色恢复仍会受到透明像素 RGB 元数据影响，建议在合并前修正。固定 SHA 范围的 git diff --check 通过；本环境未安装 cargo，因此无法复跑 Rust 测试。

Transparent pixel metadata could tint a cell that reconstructs as opaque. Exclude non-visible pixels from selected and fallback visible color averages. Opaque cell colors now reflect only pixels that contribute visible color.

The visible-color regression needs a fixture with conflicting hidden RGB data. Add a majority-opaque red cell whose transparent pixels store blue channels. The test prevents hidden PNG metadata from tinting reconstructed output.

The reconstructor is a native algorithm library rather than Python backend code. Move the independent crate to the root native area and remove the retired CLI. The later PyO3 binding can consume it without coupling this module to Python.

The reconstructor workflow still watched the retired backend-native path. Point path filters and the working directory at the independent native crate. Reconstruction checks now run for the relocated module.

vercel · 2026-08-21T04:02:46Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
windup	Ignored	Preview	Aug 21, 2026 4:16am

This reverts commit b69d1a7.

This reverts commit 53b9152.

The provenance note still claimed an algorithm change that has been withdrawn. Remove the transparent-color fix statement from the native module documentation. The pull request now describes only relocation and the existing algorithm.

xiaocheny214

这个没啥问题

xyh202131

按请求批量审批当前提交。

按请求撤销此前审批。

huyanxius added 5 commits August 20, 2026 20:16

build(pixel-grid): define reconstructor crate

67d9d4d

The native reconstructor needs a reproducible package boundary and dependency graph. Add the Rust manifest, locked dependencies, and local target exclusion. The reconstruction module can now build independently with deterministic inputs.

fennoai Bot reviewed Aug 20, 2026

View reviewed changes

Comment thread native/pixel-perfect/crates/reconstructor/src/reconstruct.rs

huyanxius mentioned this pull request Aug 20, 2026

feat(pixel-perfect): expose standalone native tool API #496

Open

11 tasks

huyanxius added 4 commits August 21, 2026 12:00

fix(pixel-grid): ignore transparent RGB in visible cells

53b9152

Transparent pixel metadata could tint a cell that reconstructs as opaque. Exclude non-visible pixels from selected and fallback visible color averages. Opaque cell colors now reflect only pixels that contribute visible color.

test(pixel-grid): cover transparent RGB metadata

b69d1a7

The visible-color regression needs a fixture with conflicting hidden RGB data. Add a majority-opaque red cell whose transparent pixels store blue channels. The test prevents hidden PNG metadata from tinting reconstructed output.

ci(pixel-grid): follow reconstructor crate move

b03ab23

The reconstructor workflow still watched the retired backend-native path. Point path filters and the working directory at the independent native crate. Reconstruction checks now run for the relocated module.

huyanxius changed the title ~~feat(pixel-grid): add explicit grid reconstructor~~ feat(pixel-grid): add independent native grid reconstructor Aug 21, 2026

huyanxius added 3 commits August 21, 2026 12:15

Revert "test(pixel-grid): cover transparent RGB metadata"

27fcac2

This reverts commit b69d1a7.

Revert "fix(pixel-grid): ignore transparent RGB in visible cells"

125f3ca

This reverts commit 53b9152.

xiaocheny214 reviewed Aug 21, 2026

View reviewed changes

xyh202131 previously approved these changes Aug 21, 2026

View reviewed changes

xyh202131 approved these changes Aug 21, 2026

View reviewed changes

Navigation Menu

Uh oh!

feat(pixel-grid): add independent native grid reconstructor - #495

feat(pixel-grid): add independent native grid reconstructor#495
huyanxius wants to merge 12 commits into
1024XEngineer:mainfrom
huyanxius:feat/491-pixel-grid-reconstructor

huyanxius commented Aug 20, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Aug 20, 2026

Uh oh!

codecov Bot commented Aug 20, 2026

Uh oh!

fennoai Bot left a comment

Uh oh!

Uh oh!

vercel Bot commented Aug 21, 2026 •

edited

Loading

Uh oh!

xiaocheny214 left a comment

Uh oh!

xyh202131 left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

huyanxius commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why

Changes

Implementation

Verification

Scope

Related Issues

Uh oh!

vercel Bot commented Aug 20, 2026

Uh oh!

codecov Bot commented Aug 20, 2026

Codecov Report

Uh oh!

fennoai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

vercel Bot commented Aug 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

xiaocheny214 left a comment

Choose a reason for hiding this comment

Uh oh!

xyh202131 left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

huyanxius commented Aug 20, 2026 •

edited

Loading

vercel Bot commented Aug 21, 2026 •

edited

Loading