PDF 去底灰 Codex Skill

它解决什么问题

remove-pdf-background-gray 是一个用于扫描型 PDF 的 Codex Skill。它可以去除纸张扫描产生的灰底或偏白底色，同时保持页面尺寸、嵌入图像的原始像素尺寸和文字的连续抗锯齿边缘。

它适合处理由 JPEG、灰度图或 RGB 扫描图组成的资料，例如扫描书籍、档案、讲义、合同等。它不做 OCR，也不会把 PDF 变成可搜索文本，重点是把已有扫描页面清理得更利于阅读、归档和后续 AI 处理。

一句话说明：这个 skill 解决的是“扫描件底色发灰，但又不想损伤文字边缘和原始分辨率”的问题。

项目已被 Awesome DSH Plugin 的 Skills 分类收录，并出现在 DSH 插件生态的公开目录中。该信息代表项目更容易被 DSH 用户发现和安装；它不等同于官方认证，安装第三方插件前仍建议查看 GitHub 源码、README 和安装命令。

扫描书籍与讲义纸张底色发灰，希望页面阅读和归档更清楚。

合同、档案、资料需要保留页面尺寸、图像宽高和原始 DPI。

AI 读取前处理让扫描资料更适合 OCR、摘要和知识库整理。

批量处理前抽样先对代表页测试参数，再决定是否批量处理。

这个项目既可以作为 DSH 插件安装，也可以放到 Codex 的个人 Skills 目录中使用。处理 PDF 前，请确保本机已经有 Python 3.10+，并安装 pypdf、Pillow 和 numpy。

dsh plugin --profile web add dsh-pdf-background-gray

dsh plugin --profile web add github:zjsthmjialin/pdf-background-gray-codex-skill

git clone https://github.com/zjsthmjialin/pdf-background-gray-codex-skill "$env:USERPROFILE\.codex\skills\remove-pdf-background-gray"

git clone https://github.com/zjsthmjialin/pdf-background-gray-codex-skill ~/.codex/skills/remove-pdf-background-gray

python -m pip install pypdf Pillow numpy

项目最初在一份真实扫描 PDF 上验证过：共 194 页，处理 713 个独立图像对象，处理前后页面数量、页面框和嵌入图像像素尺寸保持一致。由于输出图像使用 Flate 无损压缩，文件体积可能明显增大，这是为避免再次损伤文字边缘所做的取舍。

适合纸张底色发灰、主体为扫描图像、希望背景变白但保留细节的 PDF。

谨慎浅灰表格线、印章、插图、铅笔画或医学影像可能被误处理。

不适合以矢量文字、复杂插画、透明图层或特殊色彩空间为主的 PDF。

建议保留原文件，先抽取代表页测试，再检查首页、中间页和末页。

作者网站：zjsthm.pro

转载或引用请注明来源：松声慢语数字笔记 / zjsthm.pro，并保留原文链接。第三方名称、研究、链接和商标归其各自权利方所有。