开源项目文档办公类新手
LookScanned.io — 让 PDF 看起来像扫描件的纯前端社区版
LookScanned.io 是一个纯前端站点,通过浏览器内的处理让 PDF 呈现扫描件效果,无需打印机和扫描仪,支持 PWA 离线使用、实时并排对比,全部文件为静态资源,不需要后端服务器。
0 次阅读2026/09/14 发布
社区作者 · zZz
它解决什么问题
Look Scanned Community Edition(lookscanned.io)是一个纯前端(pure frontend)网站,作用是把普通 PDF 处理成“看起来像被扫描过”的 PDF,用户无需打印机与扫描仪,只需几次点击即可完成。项目灵感来自 baicunko/scanyourpdf。
主要特性(来源明确列出):
- 所有处理都在浏览器中完成,不上传文件,无隐私风险。
- 借助 PWA,可在无网络连接的情况下工作。
- 支持实时并排查看扫描后的 PDF 效果。
- 适用于所有现代浏览器与设备。
- 所有文件均为静态资源,无需后端服务器。
- 可调整设置,让 PDF 的扫描观感更好。
配图 1 展示了处理前的原始 PDF 界面(Origin),配图 2 展示了处理后的扫描效果(Processed),可直观对比处理前后的差异。
开发者相关:仓库提供开发与构建脚本,npm run dev 用于运行开发服务器,npm run build 用于构建到 dist/ 目录。
致谢与技术依赖来源:
- baicunko/scanyourpdf:Scan Your Pdf 社区仓库;
- cancerberoSgx/magica:面向浏览器与 Node.js 的 ImageMagick,配置简单,提供高层 API 与命令行接口;
- mozilla/pdf.js:JavaScript 实现的 PDF 阅读器;
- Scanner 图标由 Freepik - Flaticon 创建。
许可证:MIT License。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
环境准备:
Node.js 与 npm 环境(用于执行
npm run dev / npm run build,具体最低版本来源未给出,待核验)。
- 现代浏览器(项目声明支持所有现代浏览器与设备)。
- 如需离线使用,浏览器需支持 PWA。
- 无需准备打印机或扫描仪;无需后端服务器、数据库等运行环境(项目全部为静态文件)。
开发与构建步骤(来源给出的命令与顺序):
- 获取源码:从 GitHub 仓库 lookscanned/lookscanned.io 获取项目源码(具体克隆或下载命令来源未给出,待核验)。
- 运行开发服务器:
npm run devRun Dev Server
- 构建生产版本:
npm run buildBuild to dist/
构建产物输出到 dist/ 目录。
- 部署:由于所有文件均为静态资源,无需后端服务器,可将 dist/ 目录内容部署到任意静态托管服务(具体托管方式来源未给出,待核验)。
首次运行与使用要点:
- 直接在浏览器中打开站点即可使用,处理全部在浏览器本地完成,不会上传 PDF,无隐私风险。
- 站点为 PWA,可在无网络连接的情况下工作,适合离线环境使用。
- 上传/打开 PDF 后,可实时并排对比原始文件与处理后的扫描效果(对应配图 1 与配图 2)。
- 可通过调整设置项微调效果,使 PDF 看起来更接近真实扫描件。
常见问题与提示:
- 是否需要安装打印机/扫描仪:不需要,全部由前端处理完成。
- 是否需要联网:首次加载后可借助 PWA 离线工作。
- 文件是否会外传:来源明确说明一切在浏览器中处理,无隐私风险。
- 依赖安装命令:来源仅列出 npm run dev 与 npm run build 两条命令,未给出依赖安装步骤,具体安装命令待核验。
- 兼容性:项目声明适用于所有现代浏览器与设备。
- 技术依赖:浏览器端图像处理依赖 cancerberoSgx/magica(ImageMagick for browser),PDF 读取依赖 mozilla/pdf.js。
适用场景
把电子版 PDF 转换成看起来像扫描件的 PDF
用于需要扫描外观的提交场景
无需打印机与扫描仪即可制作“扫描版”文档
对下载的电子文档做扫描化处理以满足特定机构的外观要求
在无网络环境下通过 PWA 离线处理 PDF
在浏览器本地处理敏感 PDF
避免上传到第三方服务器
对比原始 PDF 与扫描效果并微调参数
自建静态站点部署
用于团队内部文档扫描化处理