feat(pixel-grid): add an explicit grid reconstructor

[huyanxius]

Parent

#489

Outcome

提供一个可独立构建和替换的显式网格重建器：只根据调用方给定的网格尺寸，把输入图片重建为规则 1x PNG。

Scope and exclusions

• 在 backend/native/pixel_grid_reconstructor/ 提供独立 Rust library 与 stdin/stdout CLI。
• 输入仅包含 PNG/JPEG 字节、cols、rows 和结构聚类规模 colors。
• 使用两阶段结构标签投票与原色恢复，输出每个网格单元一个颜色的 1x PNG。
• 钳制密集网格下的负三角权重，避免颜色外插形成荧光坏点。
• 增加输入、网格、颜色范围限制，以及模块级 CI。
• 不包含网格检测、Python API、Docker 装配、前端或生成管线集成。

Acceptance criteria

• 模块可在不依赖检测器和 Windup 应用的情况下单独构建和测试。
• 明确网格输入能输出对应 cols × rows 的 PNG。
• 输出每个像素对应一个规则网格单元，并保留透明度多数票。
• 密集网格测试证明输出通道不会超出源颜色范围形成坏点。
• 非法网格、颜色范围和资源超限输入被明确拒绝。
• 代码不导入工作流、生成 API、数据库、媒体服务或 Python 应用包。

Blocked by

None - can start immediately.

[huyanxius]

Design update · 2026-08-21

经评审，Rust 算法源码不再放入 Python 后端目录。本 Issue 的实现边界调整为：

• 重建器迁移到仓库根目录 native/pixel-perfect/crates/reconstructor/。
• 交付纯 Rust library；生产环境不再使用 stdin/stdout CLI。
• 对 Python 的调用由 feat(pixel-perfect): expose an independent tool API #492 在独立 PyO3 binding 中提供，本 Issue 仍不依赖检测器或业务应用。
• 合并前修复透明像素 RGB 参与可见颜色平均的问题，并以回归测试固定透明度语义。

显式网格输入、1x PNG 输出、资源上限和生成管线隔离保持不变。

[huyanxius]

Scope correction · 2026-08-21

本轮范围收窄为 Rust 模块目录迁移和后续 PyO3 接入准备；不修改重建算法行为。上一条设计更新中关于透明 RGB 修复的内容撤回，该 review thread 保持未解决，后续如需处理另行授权和排期。