我做了个不上传文件的 PDF/图片工具箱,断网也能用

1 阅读4分钟

这是个什么东西?

一个完全在浏览器里跑的在线工具箱——20 多个工具,不注册、不限制、不上传文件到服务器,所有处理都在你本机完成。离线也能用。

做完之后发现这个思路挺有意思,分享一下技术实现和踩坑经验。

技术选型:为什么选客户端计算?

做在线工具站通常有三种方案:

方案 A:上传文件 → 服务器处理 → 下载结果。 这是最常见的做法,但服务器成本高、有隐私风险、需要处理并发。

方案 B:Web Worker + WASM。 适合计算密集型任务,但 PDF 和图片这类操作,用 WASM 反而增加体积。

方案 C:浏览器原生 API + 纯前端。 就是我选的方案。现代浏览器已经内置了几乎所有需要的 API,不需要任何后端。

选 C 的原因是:反正用户只是转个 PDF、压个图,浏览器完全能搞定,为什么要多此一举上传到服务器?

核心技术栈

PDF 处理:pdf.js + pdf-lib

PDF 工具是我做得最深的品类。核心库两个:

  • pdf.js(Mozilla 出品):负责渲染和读取 PDF。做 PDF 转 JPG 时,用它把 PDF 页面渲染到 Canvas,再从 Canvas 导出图片。支持页面范围和 DPI 选择(150/300)。
  • pdf-lib:负责创建和修改 PDF。合并、拆分、提取页面、旋转都用它。纯 JS 实现,不需要原生依赖。

比较坑的是 pdfjs-dist v6 的 render 参数变了,必须显式传 { canvas, canvasContext, viewport },老版本的 renderContext 写法直接报错。

图片处理:Canvas API + heic2any

图片类工具全部基于 Canvas API:

  • 压缩:Canvas toBlob() 调 quality 参数
  • 格式转换:drawImage → toDataURL / toBlob,支持 JPG/PNG/WebP/GIF
  • HEIC 解码:用 heic2any 库在浏览器端把 iPhone 拍的 HEIC 转成通用格式。这是唯一需要额外库的场景,因为浏览器原生不支持 HEIC。

Markdown 引擎:marked + turndown

  • marked:Markdown → HTML,支持 GFM 表格、代码块、任务列表
  • turndown:HTML → Markdown,做反向转换

这两个库搭配,可以做 Markdown 编辑器预览,也可以做 AI 输出 → Word/PDF 的转换链路。

PWA + Service Worker

用 Workbox 做的离线缓存。关键页面和静态资源预缓存后,断网打开访问过页面完全没问题。工具页面配置了 Cross-Origin-Embedder-Policy: require-corp 和 Cross-Origin-Opener-Policy: same-origin,保证跨域隔离能正常工作。

隐私这块我是认真的

因为没有服务器 = 没有地方存你的文件。所有操作都在浏览器内存里完成,页面关了就没了。

这一点在推广时挺吃亏的——很多用户不理解"不上传"是什么意思,习惯性地以为所有网页工具都会把文件发到后台。但实际上技术实现就是这样:全程客户端,根本没有后端处理逻辑。

几个我觉得最好用的工具

做了 20 多个工具,按使用频率排:

  1. PDF 转 JPG/PNG:支持页面范围选择 + 150/300 DPI,PDF 里嵌的图片精度足够的话输出质量很高
  2. AI 回答转 Word:ChatGPT/Claude/DeepSeek 的输出复制粘贴过来,一键导出 .docx,保留标题层级、代码块和表格
  3. 图片压缩:Canvas 压缩,质量/体积比可控,5MB→500KB 常见
  4. Claude Session Viewer:解析 Claude Code 的 .jsonl 会话文件,可视化查看对话记录
  5. Markdown 编辑器:实时预览 + 一键导出 Word/PDF/HTML,写文档效率很高
  6. PDF 合并/拆分:拖进去就能用,纯本地处理

部署和优化

技术栈是 Next.js 16 + Turbopack + Tailwind CSS v4。全站静态生成(除工具页外),首页 Lighthouse 得分 95+。

服务器就一台轻量云,只托管静态资源,不做任何计算——所有计算都在用户的浏览器里跑。这个架构的好处是基本零服务端成本,唯一需要维护的是前端代码。

最后

项目地址:toolcraftbox.com

工具全部免费、无广告、不收集数据。如果你平时经常要转 PDF 格式、压缩图片或者处理 AI 输出,可以试试看。

有什么建议或者想加的功能,欢迎评论区反馈。