text-eraser 0.1.0__tar.gz

text_eraser-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lehuaner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

text_eraser-0.1.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: text-eraser
+Version: 0.1.0
+Summary: 图片文字擦除工具：DBNet 文字检测 + PatchMatch 内容识别填充 + 去发光，附本地 Web 界面
+Author: lehuaner
+License: MIT
+Project-URL: Homepage, https://github.com/lehuaner/TextPatch
+Project-URL: Repository, https://github.com/lehuaner/TextPatch
+Project-URL: Issues, https://github.com/lehuaner/TextPatch/issues
+Keywords: text-removal,inpainting,patchmatch,dbnet,ocr,image-processing,text-eraser
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics :: Editors
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.27
+Requires-Dist: numpy>=1.26
+Requires-Dist: opencv-python-headless>=4.8
+Requires-Dist: Pillow>=10.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: onnxruntime>=1.16
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# TextPatch
+
+[![CI](https://github.com/lehuaner/TextPatch/actions/workflows/ci.yml/badge.svg)](https://github.com/lehuaner/TextPatch/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/text-eraser)](https://pypi.org/project/text-eraser/)
+[![Python](https://img.shields.io/pypi/pyversions/text-eraser)](https://pypi.org/project/text-eraser/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**图片文字擦除工具** — DBNet 文字检测 + PatchMatch 内容识别填充，附带去发光（去除绿光/辉光文字的光晕）与本地 Web 界面。
+*Image text removal via DBNet text detection + PatchMatch-based content-aware fill, with glow removal and a local web UI.*
+
+![demo](docs/assets/demo.png)
+
+## 特性
+
+- **一键擦除文字**：DBNet（PP-OCRv4 det ONNX，约 5MB，CPU 推理）定位文字框，框内 Otsu 生成逐像素字形蒙版，PatchMatch 算法用周围背景填充
+- **去发光（deglow）**：绿光/辉光文字的光晕污染背景，普通填充会残留绿斑——v2 方案用 alpha 分解 + 调和场插值恢复干净背景
+- **所见即所得**：「移动边缘」让展示蒙版与真实填充区完全一致，支持自动判定边缘外扩量
+- **纯本地运行**：无 API、无上传，模型首次运行自动下载后完全离线
+- **两种用法**：本地 Web 界面（拖图即擦）或 Python 库调用（`erase_text()` 一步出结果）
+
+## 安装
+
+```bash
+pip install text-eraser
+```
+
+需要 Python 3.10+。DBNet 模型（约 5MB）在首次使用时自动从 HuggingFace 下载，之后离线可用。
+
+> PyPI 发行名为 `text-eraser`（`textpatch` 与既有包名过于相似未获准），Python 导入名是 `textpatch`。
+
+从源码运行：
+
+```bash
+git clone https://github.com/lehuaner/TextPatch.git
+cd TextPatch
+pip install -e .
+```
+
+## 快速上手
+
+### Web 界面
+
+```bash
+textpatch            # 或 python -m textpatch
+```
+
+浏览器打开 <http://127.0.0.1:8765/>，拖入图片即可擦除；支持逐面板查看蒙版/去发光中间结果、调整参数、保留历史记录。
+
+- 端口/地址：环境变量 `TEXTPATCH_PORT`（默认 8765）、`TEXTPATCH_HOST`（默认 127.0.0.1）
+- 运行数据目录：`TEXTPATCH_DATA_DIR`（仓库开发用 `data/`，pip 安装默认 `~/.textpatch/data`）
+- 模型缓存目录：`TEXTPATCH_MODEL_DIR`（pip 安装默认 `~/.textpatch/models`）
+
+### Python 库调用
+
+```python
+from PIL import Image
+from textpatch import erase_text, to_rgb_uint8
+
+rgb = to_rgb_uint8(Image.open("demo.png"))       # HxWx3 uint8 RGB
+result, mask, meta = erase_text(rgb, return_mask=True)
+Image.fromarray(result).save("out.png")
+# mask: 255=被擦除的文字; meta: mask_pix / inpaint_seconds / edge_used 等
+```
+
+只用填充器（去水印/去任意内容，无需文字检测）：
+
+```python
+import numpy as np
+from textpatch import inpaint
+
+hole = np.zeros(rgb.shape[:2], np.uint8)   # >0 = 要清除的区域
+hole[10:40, 20:80] = 255
+filled = inpaint(rgb, hole, sample_mask=255 - hole)
+```
+
+### 主要参数（`erase_text`）
+
+| 参数 | 默认 | 说明 |
+|---|---|---|
+| `edge` | 1 | 「移动边缘」：蒙版与填充区同步外扩(>0)/收缩(<0)像素 |
+| `auto_edge` | True | 按文字色残留自动判定最小外扩（多数图 1，硬图自动到 2） |
+| `q_off` | 55 | 蒙版紧密度 [30,70]，越高越贴字形 |
+| `direction` | None | 纹理方向角度°（木纹/条带类背景） |
+| `deglow_scheme` | "v2" | 去发光方案："v2" / "off"（无发光图自动零改动） |
+| `max_side` | 960 | DBNet 推理最长边，调大可提升小字召回 |
+
+完整函数级 API 见 [docs/ALGORITHM.md](docs/ALGORITHM.md)。
+
+## 算法概览
+
+```
+原图 RGB
+  → DBNet 文字框 → 框内 Otsu + 纯白补全 → 逐像素文字蒙版
+  → 去发光 v2 (强绿信号门 → alpha 分解恢复背景 → 调和场插值)
+  → 移动边缘 → PatchMatch 填充 (Criminisi 优先级 + 颜色自适应 + TELEA 兜底)
+  → 擦除结果
+```
+
+- 设计细节与参数速查：[docs/ALGORITHM.md](docs/ALGORITHM.md)
+- 去发光 v4 规格说明：[docs/DEGLOW_V4.md](docs/DEGLOW_V4.md)
+
+## 已知限制
+
+- **发光文字路径仍在迭代**：绿光/辉光场景经过多轮修复已大幅改善，但个别复杂背景（暖色多弧段等）仍可能有色差残留，持续按实际观感调整中
+- 文字检测依赖 DBNet 召回；极端小字（<8px 高）或严重模糊的字体可能漏检
+- 大图（4K+）CPU 推理约 0.1s/张，填充耗时与蒙版面积成正比
+
+## 开发
+
+```bash
+pip install -e .[dev]
+pytest                 # 合成图测试套件
+```
+
+```
+TextPatch/
+├── textpatch/          # 包本体 (检测/蒙版/填充/去发光/Web)
+├── tests/              # 合成图测试 (CI 用, 自足不依赖样图)
+├── docs/
+│   ├── ALGORITHM.md    # 函数级算法与参数指南
+│   ├── DEGLOW_V4.md    # 去发光 v4 规格说明
+│   ├── assets/         # README 演示图
+│   └── dev/            # 开发日志与专项修复报告
+├── scripts/            # 离线诊断/回归脚本 (见下)
+└── deglow/             # 去发光 v4 实验模块 (不随 pip 包发布)
+```
+
+`scripts/` 下还有一套基于真实样图的回归脚本（`regress_*.py`，样图不入库，需本地自备 `data/` 样图），用于算法调参时的逐位回归验证。
+
+## License
+
+[MIT](LICENSE)

text_eraser-0.1.0/README.md

@@ -0,0 +1,132 @@
+# TextPatch
+
+[![CI](https://github.com/lehuaner/TextPatch/actions/workflows/ci.yml/badge.svg)](https://github.com/lehuaner/TextPatch/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/text-eraser)](https://pypi.org/project/text-eraser/)
+[![Python](https://img.shields.io/pypi/pyversions/text-eraser)](https://pypi.org/project/text-eraser/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**图片文字擦除工具** — DBNet 文字检测 + PatchMatch 内容识别填充，附带去发光（去除绿光/辉光文字的光晕）与本地 Web 界面。
+*Image text removal via DBNet text detection + PatchMatch-based content-aware fill, with glow removal and a local web UI.*
+
+![demo](docs/assets/demo.png)
+
+## 特性
+
+- **一键擦除文字**：DBNet（PP-OCRv4 det ONNX，约 5MB，CPU 推理）定位文字框，框内 Otsu 生成逐像素字形蒙版，PatchMatch 算法用周围背景填充
+- **去发光（deglow）**：绿光/辉光文字的光晕污染背景，普通填充会残留绿斑——v2 方案用 alpha 分解 + 调和场插值恢复干净背景
+- **所见即所得**：「移动边缘」让展示蒙版与真实填充区完全一致，支持自动判定边缘外扩量
+- **纯本地运行**：无 API、无上传，模型首次运行自动下载后完全离线
+- **两种用法**：本地 Web 界面（拖图即擦）或 Python 库调用（`erase_text()` 一步出结果）
+
+## 安装
+
+```bash
+pip install text-eraser
+```
+
+需要 Python 3.10+。DBNet 模型（约 5MB）在首次使用时自动从 HuggingFace 下载，之后离线可用。
+
+> PyPI 发行名为 `text-eraser`（`textpatch` 与既有包名过于相似未获准），Python 导入名是 `textpatch`。
+
+从源码运行：
+
+```bash
+git clone https://github.com/lehuaner/TextPatch.git
+cd TextPatch
+pip install -e .
+```
+
+## 快速上手
+
+### Web 界面
+
+```bash
+textpatch            # 或 python -m textpatch
+```
+
+浏览器打开 <http://127.0.0.1:8765/>，拖入图片即可擦除；支持逐面板查看蒙版/去发光中间结果、调整参数、保留历史记录。
+
+- 端口/地址：环境变量 `TEXTPATCH_PORT`（默认 8765）、`TEXTPATCH_HOST`（默认 127.0.0.1）
+- 运行数据目录：`TEXTPATCH_DATA_DIR`（仓库开发用 `data/`，pip 安装默认 `~/.textpatch/data`）
+- 模型缓存目录：`TEXTPATCH_MODEL_DIR`（pip 安装默认 `~/.textpatch/models`）
+
+### Python 库调用
+
+```python
+from PIL import Image
+from textpatch import erase_text, to_rgb_uint8
+
+rgb = to_rgb_uint8(Image.open("demo.png"))       # HxWx3 uint8 RGB
+result, mask, meta = erase_text(rgb, return_mask=True)
+Image.fromarray(result).save("out.png")
+# mask: 255=被擦除的文字; meta: mask_pix / inpaint_seconds / edge_used 等
+```
+
+只用填充器（去水印/去任意内容，无需文字检测）：
+
+```python
+import numpy as np
+from textpatch import inpaint
+
+hole = np.zeros(rgb.shape[:2], np.uint8)   # >0 = 要清除的区域
+hole[10:40, 20:80] = 255
+filled = inpaint(rgb, hole, sample_mask=255 - hole)
+```
+
+### 主要参数（`erase_text`）
+
+| 参数 | 默认 | 说明 |
+|---|---|---|
+| `edge` | 1 | 「移动边缘」：蒙版与填充区同步外扩(>0)/收缩(<0)像素 |
+| `auto_edge` | True | 按文字色残留自动判定最小外扩（多数图 1，硬图自动到 2） |
+| `q_off` | 55 | 蒙版紧密度 [30,70]，越高越贴字形 |
+| `direction` | None | 纹理方向角度°（木纹/条带类背景） |
+| `deglow_scheme` | "v2" | 去发光方案："v2" / "off"（无发光图自动零改动） |
+| `max_side` | 960 | DBNet 推理最长边，调大可提升小字召回 |
+
+完整函数级 API 见 [docs/ALGORITHM.md](docs/ALGORITHM.md)。
+
+## 算法概览
+
+```
+原图 RGB
+  → DBNet 文字框 → 框内 Otsu + 纯白补全 → 逐像素文字蒙版
+  → 去发光 v2 (强绿信号门 → alpha 分解恢复背景 → 调和场插值)
+  → 移动边缘 → PatchMatch 填充 (Criminisi 优先级 + 颜色自适应 + TELEA 兜底)
+  → 擦除结果
+```
+
+- 设计细节与参数速查：[docs/ALGORITHM.md](docs/ALGORITHM.md)
+- 去发光 v4 规格说明：[docs/DEGLOW_V4.md](docs/DEGLOW_V4.md)
+
+## 已知限制
+
+- **发光文字路径仍在迭代**：绿光/辉光场景经过多轮修复已大幅改善，但个别复杂背景（暖色多弧段等）仍可能有色差残留，持续按实际观感调整中
+- 文字检测依赖 DBNet 召回；极端小字（<8px 高）或严重模糊的字体可能漏检
+- 大图（4K+）CPU 推理约 0.1s/张，填充耗时与蒙版面积成正比
+
+## 开发
+
+```bash
+pip install -e .[dev]
+pytest                 # 合成图测试套件
+```
+
+```
+TextPatch/
+├── textpatch/          # 包本体 (检测/蒙版/填充/去发光/Web)
+├── tests/              # 合成图测试 (CI 用, 自足不依赖样图)
+├── docs/
+│   ├── ALGORITHM.md    # 函数级算法与参数指南
+│   ├── DEGLOW_V4.md    # 去发光 v4 规格说明
+│   ├── assets/         # README 演示图
+│   └── dev/            # 开发日志与专项修复报告
+├── scripts/            # 离线诊断/回归脚本 (见下)
+└── deglow/             # 去发光 v4 实验模块 (不随 pip 包发布)
+```
+
+`scripts/` 下还有一套基于真实样图的回归脚本（`regress_*.py`，样图不入库，需本地自备 `data/` 样图），用于算法调参时的逐位回归验证。
+
+## License
+
+[MIT](LICENSE)

text_eraser-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# PyPI 发行名: text-eraser (textpatch 与既有 text-patch 过于相似被 PyPI 拒绝)
+# import 包名: textpatch
+name = "text-eraser"
+version = "0.1.0"
+description = "图片文字擦除工具：DBNet 文字检测 + PatchMatch 内容识别填充 + 去发光，附本地 Web 界面"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "lehuaner" }]
+requires-python = ">=3.10"
+keywords = ["text-removal", "inpainting", "patchmatch", "dbnet", "ocr", "image-processing", "text-eraser"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Graphics :: Editors",
+    "Topic :: Scientific/Engineering :: Image Processing",
+]
+dependencies = [
+    "fastapi>=0.110",
+    "uvicorn[standard]>=0.27",
+    "numpy>=1.26",
+    "opencv-python-headless>=4.8",
+    "Pillow>=10.0",
+    "python-multipart>=0.0.9",
+    "onnxruntime>=1.16",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "build>=1.0", "twine>=5.0"]
+
+[project.urls]
+Homepage = "https://github.com/lehuaner/TextPatch"
+Repository = "https://github.com/lehuaner/TextPatch"
+Issues = "https://github.com/lehuaner/TextPatch/issues"
+
+[project.scripts]
+textpatch = "textpatch.webapp:main"
+
+[tool.setuptools.packages.find]
+include = ["textpatch*"]
+exclude = ["deglow*", "scripts*", "tests*"]
+
+[tool.setuptools.package-data]
+textpatch = ["static/**/*", "assets/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

text_eraser-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

text_eraser-0.1.0/tests/test_textpatch.py

@@ -0,0 +1,72 @@
+"""textpatch 包级冒烟测试（全部合成图，不依赖仓库内样图与历史数据）。"""
+from __future__ import annotations
+
+import numpy as np
+import pytest
+
+
+def _synthetic_rgb(w=320, h=200, seed=7) -> np.ndarray:
+    """带纹理的中性渐变背景，用于填充/蒙版测试。"""
+    rng = np.random.default_rng(seed)
+    yy, xx = np.mgrid[0:h, 0:w].astype(np.float32)
+    t = (xx / w * 0.6 + yy / h * 0.4)
+    base = np.stack([110 + 40 * t, 108 + 39 * t, 104 + 37 * t], axis=-1)
+    noise = rng.normal(0, 3.5, (h, w, 1)).repeat(3, axis=2)
+    return np.clip(base + noise, 0, 255).astype(np.uint8)
+
+
+def test_version_and_exports():
+    import textpatch
+    assert textpatch.__version__
+    for name in textpatch.__all__:
+        assert hasattr(textpatch, name), name
+
+
+def test_patch_fill_inpaints_hole():
+    """纯色洞应被周围纹理背景填回，不残留黑洞/亮斑。"""
+    rgb = _synthetic_rgb()
+    hole = np.zeros(rgb.shape[:2], np.uint8)
+    hole[80:120, 120:200] = 255          # 中央 40x80 洞, 填 0(黑)
+    rgb_hole = rgb.copy()
+    rgb_hole[hole > 0] = (0, 0, 0)
+
+    from textpatch import inpaint
+    filled = inpaint(rgb_hole, hole, sample_mask=(255 - hole))
+
+    center = filled[95:105, 150:170].astype(float)
+    ring = rgb[95:105, 150:170].astype(float)   # 原图同位置 ≈ 真背景
+    assert abs(center.mean() - ring.mean()) < 12.0
+
+
+def test_detect_text_mask_classic_synthetic():
+    """经典路径：合成图上大块非文字区域不应被当成文字。"""
+    from textpatch import detect_text_mask
+    rgb = _synthetic_rgb()
+    mask, _ = detect_text_mask(rgb, method="classic",
+                               max_area_ratio=0.40, max_box_ratio=0.40)
+    assert mask.shape == rgb.shape[:2]
+    assert mask.dtype == np.uint8
+    # 纯纹理背景无文字 → 蒙版应接近空
+    assert mask.mean() < 1.0
+
+
+def test_erase_text_end_to_end():
+    """全流程冒烟：中央大字块被擦除且不残留白色（ml 路径，模型缺失则跳过）。"""
+    pytest.importorskip("onnxruntime")
+    from textpatch import erase_text
+    try:
+        from textpatch.ml_text_select import get_model_path
+        get_model_path()
+    except Exception as e:  # 离线/网络受限环境: 跳过而非失败
+        pytest.skip(f"DBNet model unavailable: {e}")
+
+    rgb = _synthetic_rgb(w=480, h=280)
+    # 画一个粗白字块("口"形方框, 结构简单且 DBNet 稳定可检)
+    rgb[100:180, 190:290] = (250, 250, 250)
+    rgb[110:170, 200:280] = _synthetic_rgb(w=80, h=60, seed=9)[20]
+
+    result, mask, meta = erase_text(rgb, return_mask=True)
+    assert mask.any(), "文字未被检出"
+    # 原白框区域不应残留大片纯白
+    resid = (result[100:180, 190:290].min(axis=-1) > 235).mean()
+    assert resid < 0.05, f"白框残留 {resid:.2%}"

text_eraser-0.1.0/text_eraser.egg-info/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: text-eraser
+Version: 0.1.0
+Summary: 图片文字擦除工具：DBNet 文字检测 + PatchMatch 内容识别填充 + 去发光，附本地 Web 界面
+Author: lehuaner
+License: MIT
+Project-URL: Homepage, https://github.com/lehuaner/TextPatch
+Project-URL: Repository, https://github.com/lehuaner/TextPatch
+Project-URL: Issues, https://github.com/lehuaner/TextPatch/issues
+Keywords: text-removal,inpainting,patchmatch,dbnet,ocr,image-processing,text-eraser
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics :: Editors
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.27
+Requires-Dist: numpy>=1.26
+Requires-Dist: opencv-python-headless>=4.8
+Requires-Dist: Pillow>=10.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: onnxruntime>=1.16
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# TextPatch
+
+[![CI](https://github.com/lehuaner/TextPatch/actions/workflows/ci.yml/badge.svg)](https://github.com/lehuaner/TextPatch/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/text-eraser)](https://pypi.org/project/text-eraser/)
+[![Python](https://img.shields.io/pypi/pyversions/text-eraser)](https://pypi.org/project/text-eraser/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**图片文字擦除工具** — DBNet 文字检测 + PatchMatch 内容识别填充，附带去发光（去除绿光/辉光文字的光晕）与本地 Web 界面。
+*Image text removal via DBNet text detection + PatchMatch-based content-aware fill, with glow removal and a local web UI.*
+
+![demo](docs/assets/demo.png)
+
+## 特性
+
+- **一键擦除文字**：DBNet（PP-OCRv4 det ONNX，约 5MB，CPU 推理）定位文字框，框内 Otsu 生成逐像素字形蒙版，PatchMatch 算法用周围背景填充
+- **去发光（deglow）**：绿光/辉光文字的光晕污染背景，普通填充会残留绿斑——v2 方案用 alpha 分解 + 调和场插值恢复干净背景
+- **所见即所得**：「移动边缘」让展示蒙版与真实填充区完全一致，支持自动判定边缘外扩量
+- **纯本地运行**：无 API、无上传，模型首次运行自动下载后完全离线
+- **两种用法**：本地 Web 界面（拖图即擦）或 Python 库调用（`erase_text()` 一步出结果）
+
+## 安装
+
+```bash
+pip install text-eraser
+```
+
+需要 Python 3.10+。DBNet 模型（约 5MB）在首次使用时自动从 HuggingFace 下载，之后离线可用。
+
+> PyPI 发行名为 `text-eraser`（`textpatch` 与既有包名过于相似未获准），Python 导入名是 `textpatch`。
+
+从源码运行：
+
+```bash
+git clone https://github.com/lehuaner/TextPatch.git
+cd TextPatch
+pip install -e .
+```
+
+## 快速上手
+
+### Web 界面
+
+```bash
+textpatch            # 或 python -m textpatch
+```
+
+浏览器打开 <http://127.0.0.1:8765/>，拖入图片即可擦除；支持逐面板查看蒙版/去发光中间结果、调整参数、保留历史记录。
+
+- 端口/地址：环境变量 `TEXTPATCH_PORT`（默认 8765）、`TEXTPATCH_HOST`（默认 127.0.0.1）
+- 运行数据目录：`TEXTPATCH_DATA_DIR`（仓库开发用 `data/`，pip 安装默认 `~/.textpatch/data`）
+- 模型缓存目录：`TEXTPATCH_MODEL_DIR`（pip 安装默认 `~/.textpatch/models`）
+
+### Python 库调用
+
+```python
+from PIL import Image
+from textpatch import erase_text, to_rgb_uint8
+
+rgb = to_rgb_uint8(Image.open("demo.png"))       # HxWx3 uint8 RGB
+result, mask, meta = erase_text(rgb, return_mask=True)
+Image.fromarray(result).save("out.png")
+# mask: 255=被擦除的文字; meta: mask_pix / inpaint_seconds / edge_used 等
+```
+
+只用填充器（去水印/去任意内容，无需文字检测）：
+
+```python
+import numpy as np
+from textpatch import inpaint
+
+hole = np.zeros(rgb.shape[:2], np.uint8)   # >0 = 要清除的区域
+hole[10:40, 20:80] = 255
+filled = inpaint(rgb, hole, sample_mask=255 - hole)
+```
+
+### 主要参数（`erase_text`）
+
+| 参数 | 默认 | 说明 |
+|---|---|---|
+| `edge` | 1 | 「移动边缘」：蒙版与填充区同步外扩(>0)/收缩(<0)像素 |
+| `auto_edge` | True | 按文字色残留自动判定最小外扩（多数图 1，硬图自动到 2） |
+| `q_off` | 55 | 蒙版紧密度 [30,70]，越高越贴字形 |
+| `direction` | None | 纹理方向角度°（木纹/条带类背景） |
+| `deglow_scheme` | "v2" | 去发光方案："v2" / "off"（无发光图自动零改动） |
+| `max_side` | 960 | DBNet 推理最长边，调大可提升小字召回 |
+
+完整函数级 API 见 [docs/ALGORITHM.md](docs/ALGORITHM.md)。
+
+## 算法概览
+
+```
+原图 RGB
+  → DBNet 文字框 → 框内 Otsu + 纯白补全 → 逐像素文字蒙版
+  → 去发光 v2 (强绿信号门 → alpha 分解恢复背景 → 调和场插值)
+  → 移动边缘 → PatchMatch 填充 (Criminisi 优先级 + 颜色自适应 + TELEA 兜底)
+  → 擦除结果
+```
+
+- 设计细节与参数速查：[docs/ALGORITHM.md](docs/ALGORITHM.md)
+- 去发光 v4 规格说明：[docs/DEGLOW_V4.md](docs/DEGLOW_V4.md)
+
+## 已知限制
+
+- **发光文字路径仍在迭代**：绿光/辉光场景经过多轮修复已大幅改善，但个别复杂背景（暖色多弧段等）仍可能有色差残留，持续按实际观感调整中
+- 文字检测依赖 DBNet 召回；极端小字（<8px 高）或严重模糊的字体可能漏检
+- 大图（4K+）CPU 推理约 0.1s/张，填充耗时与蒙版面积成正比
+
+## 开发
+
+```bash
+pip install -e .[dev]
+pytest                 # 合成图测试套件
+```
+
+```
+TextPatch/
+├── textpatch/          # 包本体 (检测/蒙版/填充/去发光/Web)
+├── tests/              # 合成图测试 (CI 用, 自足不依赖样图)
+├── docs/
+│   ├── ALGORITHM.md    # 函数级算法与参数指南
+│   ├── DEGLOW_V4.md    # 去发光 v4 规格说明
+│   ├── assets/         # README 演示图
+│   └── dev/            # 开发日志与专项修复报告
+├── scripts/            # 离线诊断/回归脚本 (见下)
+└── deglow/             # 去发光 v4 实验模块 (不随 pip 包发布)
+```
+
+`scripts/` 下还有一套基于真实样图的回归脚本（`regress_*.py`，样图不入库，需本地自备 `data/` 样图），用于算法调参时的逐位回归验证。
+
+## License
+
+[MIT](LICENSE)

text_eraser-0.1.0/text_eraser.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+LICENSE
+README.md
+pyproject.toml
+tests/test_textpatch.py
+text_eraser.egg-info/PKG-INFO
+text_eraser.egg-info/SOURCES.txt
+text_eraser.egg-info/dependency_links.txt
+text_eraser.egg-info/entry_points.txt
+text_eraser.egg-info/requires.txt
+text_eraser.egg-info/top_level.txt
+textpatch/__init__.py
+textpatch/__main__.py
+textpatch/eraser.py
+textpatch/ml_text_select.py
+textpatch/patch_fill.py
+textpatch/text_select.py
+textpatch/webapp.py
+textpatch/assets/example.png
+textpatch/static/app.js
+textpatch/static/index.html
+textpatch/static/style.css

text_eraser-0.1.0/text_eraser.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

text_eraser-0.1.0/text_eraser.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+textpatch = textpatch.webapp:main

text_eraser-0.1.0/text_eraser.egg-info/requires.txt

@@ -0,0 +1,12 @@
+fastapi>=0.110
+uvicorn[standard]>=0.27
+numpy>=1.26
+opencv-python-headless>=4.8
+Pillow>=10.0
+python-multipart>=0.0.9
+onnxruntime>=1.16
+
+[dev]
+pytest>=8.0
+build>=1.0
+twine>=5.0

text_eraser-0.1.0/text_eraser.egg-info/top_level.txt

@@ -0,0 +1 @@
+textpatch