From 08da95459ca657797f7aa7288885faa6cc9feb92 Mon Sep 17 00:00:00 2001
From: Li Fengmin <2080291162@qq.com>
Date: Wed, 19 Aug 2026 12:06:32 +0800
Subject: [PATCH] docs: ecosystem differentiation section in README (zh + en)

---
 README.en.md | 22 ++++++++++++++++++++++
 README.md    | 22 ++++++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/README.en.md b/README.en.md
index 4f7ba58..c89a36d 100644
--- a/README.en.md
+++ b/README.en.md
@@ -43,6 +43,28 @@ English | [简体中文](README.md)
 - **Multi-backend, zero-copy interop**: on the js backend a `FixedArray[Byte]` *is* a `Uint8Array`, so canvas `Uint8ClampedArray` buffers cross over without copies; the linear-memory wasm backend exports `memory` for bulk pixel access.
 - **Browser Playground**: drag & drop / paste / upload images, stackable filter pipeline, JS/WASM engine switch with benchmarks, an optional **Web Worker background thread** for large images, and PNG downloads produced by the library's **own `png_encode`**.
 
+## 🆚 Relation to other MoonBit image libraries
+
+The MoonBit ecosystem already hosts several image packages with overlapping directions (e.g. `megemini/millow`, `PingGuoMiaoMiao/MoonVision`, `shunge/image`). PixelForge unavoidably overlaps with them on basic filters (blur, edge detection, thresholding — the common foundation every image library shares, here all independently hand-written and test-driven), but its **positioning and core capabilities are clearly different**:
+
+| Existing project | Positioning | Difference from PixelForge |
+| --- | --- | --- |
+| `megemini/millow` | Pillow-style computer vision library (corner detection, contours, HOG/LBP/moments, augmentation, SSIM, ...) | CV-focused; no codec breadth, browser interactivity or perceptual analysis |
+| `PingGuoMiaoMiao/MoonVision` | Lightweight image processing + basic CV (grayscale-first, template matching) | Grayscale-focused; no full RGBA codecs, drawing/text, noise or hashing |
+| `shunge/image` | Pure decoder (BMP/QOI/TGA/PNG/GIF/JPEG) | Decode only; no filters, encoding, drawing or analysis |
+
+**Capabilities unique to PixelForge** (not offered by the projects above):
+
+- **Codec breadth**: PNG (self-implemented full DEFLATE inflate with CRC-32/Adler-32 verification), QOI, BMP **encode + decode** and GIF decoding, all in pure MoonBit
+- **Browser Playground**: live JS/WASM engine comparison, Web Worker background thread, real-time luma histogram panel, downloads via the library's own `png_encode`
+- **Bitmap text**: built-in 5×7 font `draw_text` for typesetting directly on images
+- **Perceptual hashing**: aHash / dHash + Hamming distance for deduplication and similarity search
+- **Deterministic noise**: 64-bit LCG-driven gaussian / salt-and-pepper noise, byte-identical across backends for a given seed; pairs with median/bilateral filters into a denoise demo loop
+- **Statistics & tone**: per-channel min/max/mean, auto_contrast, levels
+- **Engineering transparency**: full evolution across 13 releases, bilingual docs, CI end-to-end smoke tests
+
+If you found this library on `mooncakes.io`, you can use it directly with `moon add 0717lee/pixelforge`; we also hope the codec and Playground implementations serve as useful ecosystem references.
+
 ## 📦 Project layout
 
 ```
diff --git a/README.md b/README.md
index 846aa39..5aca168 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,28 @@
 - **多后端 + 零拷贝互操作**：js 后端下 `FixedArray[Byte]` 就是 `Uint8Array`，与 canvas 的 `Uint8ClampedArray` 零拷贝互通；线性内存 wasm 后端导出 `memory`，宿主直接批量读写像素。
 - **浏览器 Playground**：拖拽 / 粘贴 / 上传图片，滤镜可叠加成管线，JS/WASM 引擎切换与性能对比，可切换到 **Web Worker 后台线程**处理大图不卡 UI，处理结果用**自家 `png_encode`** 一键下载 PNG。
 
+## 🆚 与 MoonBit 生态中其他图像库的关系
+
+MoonBit 生态中已经存在若干方向相近的图像处理包（如 `megemini/millow`、`PingGuoMiaoMiao/MoonVision`、`shunge/image` 等）。PixelForge 与它们在基础滤镜上不可避免地有重叠（模糊、边缘检测、阈值等是所有图像库的共同基础能力，且本库的实现全部独立手写、以确定性测试驱动），但**定位与核心能力有明显差异**：
+
+| 现有项目 | 定位 | 与 PixelForge 的差异 |
+| --- | --- | --- |
+| `megemini/millow` | Pillow 风格的计算机视觉库（角点检测、轮廓查找、HOG/LBP/矩、数据增强、SSIM 等） | 侧重 CV 算法；不提供编解码器广度、浏览器交互与感知分析 |
+| `PingGuoMiaoMiao/MoonVision` | 轻量图像处理 + 基础 CV（灰度图为主、模板匹配） | 侧重灰度图像处理；不提供 RGBA 全彩编解码、绘图/文字、噪声与哈希 |
+| `shunge/image` | 纯解码器（BMP/QOI/TGA/PNG/GIF/JPEG 六格式解码） | 仅解码；不提供滤镜、编码、绘图与分析能力 |
+
+**PixelForge 的独有能力**（上述项目均不具备）：
+
+- **编解码器广度**：PNG（自实现完整 DEFLATE inflate + CRC-32/Adler-32 校验）、QOI、BMP 的**编+解**与 GIF 解码，全部纯 MoonBit 实现
+- **浏览器 Playground**：JS/WASM 双引擎实时对比、Web Worker 后台线程、实时亮度直方图面板、用自家 `png_encode` 下载结果
+- **位图字体**：内置 5×7 字体 `draw_text`，可直接在图像上排版文字
+- **感知哈希**：aHash / dHash + 汉明距离，图像去重与相似度检索
+- **确定性噪声**：64 位 LCG 驱动的高斯 / 椒盐噪声，同 seed 跨后端逐字节重现，配合中值/双边滤波形成降噪演示闭环
+- **图像统计与色调**：逐通道 min/max/mean、auto_contrast、levels 色阶
+- **工程透明度**：13 个版本的完整演进记录、双语文档、CI 端到端冒烟测试
+
+如果您的项目在 `mooncakes.io` 上看到本库，可通过 `moon add 0717lee/pixelforge` 直接使用；也希望本库的编解码器与 Playground 实现能为生态提供参考。
+
 ## 📦 项目结构
 
 ```