工具箱 TOOLBOX

一个部署在 Cloudflare Workers 上的在线工具箱，26 个即开即用的小工具，无需注册登录。

💼 全局任务中心：视频格式转换、PDF 压缩等耗时任务提交后进入后台运行，右下角悬浮按钮随时查看进度、日志与完成下载；切换工具、继续做别的事不影响任务执行。

在线体验 · 反馈

💡 这是什么

工具箱是一个可自部署的在线工具集合，覆盖开发者日常高频操作：编码转换、文本处理、数据格式化、文件传输、DevOps 清理等。

纯前端计算：大部分工具在浏览器本地完成，数据不离开设备。
到期自动销毁：涉及传输的工具支持离线暂存，按 TTL 自动清除。
可自部署：基于 Cloudflare Workers，一键部署到自己的账号。

Tip

在线体验地址：tools.dbthree.dpdns.org

✨ 功能

功能	说明
📁 文本 / 文件互传	WebRTC P2P 直传（不落服务器）· 离线暂存（时长 / 次数可自定义）· 提取码 / 扫码
🔲 二维码生成 / 解析	生成二维码或解析二维码图片
⏰ Cron 表达式	解析下次执行时间，可视化生成
🔄 格式互转	YAML / XML / CSV / INI / TOML / Properties ↔ JSON
🕐 时间戳转换	Unix 时间 ↔ 日期时间
🔐 Hash 计算	MD5 / SHA 系列 / HMAC
🆔 UUID 生成	批量 v4，本地随机
📝 文本 Diff 对比	两栏对比，差异高亮
🔍 正则测试器	匹配预览与捕获组
🧰 文本处理合集	大小写 / 排序 / 去重等
📂 文件哈希校验	本地文件的 MD5 / SHA 摘要
💻 设备信息	屏幕 / 系统 / 浏览器 / 设备架构
🔠 Case converter	大小写与命名风格转换
📑 MIME types	MIME ↔ 扩展名互查
🌐 HTTP 状态码	状态码速查 · 数字 / 英文 / 中文
📄 PDF 工具箱	合并 / 拆分 / 旋转 / 分级压缩（建议·低·中·高）/ 转图片 / 图片转 PDF（严格 A4 · 拖拽排序 · 逐图旋转）/ 扫描件合成（图片 / PDF / Word 混合 → 栅格化扫描件页 → 合成一个 PDF，后台任务；含「纸面字迹」模式：米黄纸 + 墨色字迹 + 纸纹颗粒 + 可选红色印章）/ 删页 / 页码 / 水印 / 加密 · 文件列表统一预览 / 放大 / 旋转 / 排序
🏷️ 徽章生成	shields.io 风格徽章
✍️ Markdown 编辑器	实时预览 / 转 HTML / PDF
📨 请求头解析	UA / Cookie / URL / Query / Header / Set-Cookie
🔌 WebSocket / SSE 测试	连接测试 · 收发消息 · 实时日志
☁️ Vercel 部署清理	批量删除旧部署 · 保留最新 N 个
🐙 GitHub Release 清理	批量删除旧 Release · 保留最新 N 个 · 可选删 Tag
📹 屏幕 / 摄像头录制	MP4（Chrome 126+，不支持自动回退 WebM）/ WebM · 录制中实时预览 · 移动端兼容提示
🔤 OCR 文字识别	图片 / PDF / Word 文字识别，PaddleOCR 引擎本地识别（opencv.js / onnx wasm 独立自托管按需加载，大包不进 chunk，弱网不超时）
🎬 视频格式转换	MP4 / WebM / MOV / MKV / GIF · ffmpeg 本地转换（MP4/MOV/MKV 互转无损）· 后台任务 + 全局进度
📊 Excel 函数快查	63 个常用函数 · 语法 / 参数 / 示例 · 交互模拟器 · 明暗主题适配
🧭 好用网站导航	精选第三方在线工具（Smallpdf、轻松传等），纯外链跳转推荐，不做功能
🖨️ 文件打印	上传 PDF / 图片 / Word / 文本，预览后调用本机打印机打印；可选纸张 / 方向 / 清晰度 / 边距

新增工具 = 新建页面 + 在 lib/tools.ts 注册一项，自动出现在侧边栏、搜索与仪表台。

Note

拖拽上传已做全局防护：文件拖到页面上任意位置都不会被浏览器当作导航直接打开；拖到非上传区时显示全屏遮罩「松开以添加文件」，松开后自动交给当前工具的上传区；拖到上传区本体则局部高亮。全站上传入口统一复用 FileDropZone（点击 / 拖拽 / 键盘可达），纯文本或链接拖入不会误触发。

Note

PDF 压缩为分级真实压缩：可选「建议 / 低 / 中 / 高」四档，对齐 smallpdf 默认思路（默认不降分辨率、只重编码图片流）。「建议」档先无损重写，图片型 PDF 自动高保真重编码（≈144dpi + 0.85 质量，视觉无损）并取更小者；低 / 中 / 高为显式栅格化重建：低 ≈108dpi/0.85 接近无损，中 86dpi/0.75，高 72dpi/0.6 明显压缩但内容清晰。实测（1200×1600 大图 PDF）：auto 瘦 27%、低 48%、中 69%、高 82%。扫描件 / 图片类 PDF 栅格化档瘦身效果最佳；文本型栅格化后文字不可选中、反而可能变大。

🚀 安装

从源码安装

需要 Node.js 18+。

git clone https://github.com/lsx-xyg/tools.git
cd tools
npm install

本地开发

npm run dev

访问 http://localhost:3000。

Note

本地开发时后端自动使用内存 KV + .local-store/ 目录模拟 KV / R2，可完整跑通发送 / 接收流程（包括双开两个浏览器标签页测试在线直传）。

📖 使用

打开网站后，通过左侧边栏选择工具，或按 Ctrl + K 打开搜索快速定位。侧边栏按用途分类分组展示（传输与分享 / 文档处理 / 文本处理 / 开发与编码 / 速查参考 / CI/CD 与发布 / 网络与调试 / 媒体工具），同类工具集中平铺，组标题带数量角标；移动端抽屉为同一分组列表，工具多时可滚动。
大部分工具为纯前端计算，输入即出结果。
涉及传输的工具（T-01）：
- 在线直传：发送端创建房间获得 6 位提取码，接收端输入提取码建立 WebRTC 连接，内容点对点直传，服务器不落盘。
- 离线暂存：上传文件或文本后获得提取码，接收端凭码取回；可自定义保留时长（1h ~ 7 天）和下载次数（1 ~ 100 次），到期自动销毁。

⚙️ 配置

环境变量

变量	必需	说明
`SITE_PASSWORD`	推荐	全站访问密码。未设置时全站拒绝访问（安全兜底）
`TRANSFER_KV_ID`	部署必需	Cloudflare KV namespace id（通过 secret 或部署脚本注入，不入库）
`REDIS_URL`	可选	Upstash REST 端点，启用 Redis 存储后端时需要
`REDIS_TOKEN`	可选	Upstash 访问令牌
`STORAGE_SWITCH_PASSWORD`	可选	存储后端切换密码；未配置时可在网页首次设置

限额

查看传输限额

项目	限制
文本	≤ 200,000 字符
文件（离线暂存）	单次 ≤ 10 个、单个 ≤ 200 MB、总量 ≤ 200 MB
文件（在线直传）	单次 ≤ 10 个、单个 ≤ 4 GB、总量 ≤ 8 GB
离线保留时长	1h / 6h / 24h / 3 天 / 7 天
文件下载次数	1 / 3 / 10 / 100 次
P2P 信令窗口	15 分钟；连接超时 90 秒

🛠️ 开发

前置要求

Node.js 18+
Cloudflare 账号（部署用）

常用命令

npm run dev       # 本地开发
npm run build     # 构建（含 TypeScript 类型检查）
npm run lint      # ESLint 检查
npm run preview   # 本地预览 Cloudflare Workers 构建产物
npm run deploy    # 部署到 Cloudflare Workers

部署到 Cloudflare Workers

查看完整部署步骤

准备资源

npx wrangler login
npx wrangler kv namespace create TRANSFER_KV
npx wrangler r2 bucket create tools-transfer

注入 KV id（wrangler.jsonc 中为占位符，真实 id 不入库）
```
TRANSFER_KV_ID=<你的id> ./scripts/deploy.sh
```
设置全站密码
```
npx wrangler secret put SITE_PASSWORD
```
配置 R2 生命周期（控制台 → R2 → tools-transfer → 生命周期规则 → 删除对象 → 早于 7 天前）
部署
```
npm run deploy
```
GitHub Actions 自动部署：在仓库 Settings → Secrets 添加 CLOUDFLARE_API_TOKEN、CLOUDFLARE_ACCOUNT_ID、TRANSFER_KV_ID，推送 main 即自动部署。

存储后端切换（KV / Redis）

默认使用 Cloudflare KV；可切换到 Redis（Upstash）降低 KV 免费额度消耗。配置 REDIS_URL 和 REDIS_TOKEN 后，仪表台底部「存储后端 · 管理员」卡片即可切换。切换需输入密码（环境变量 STORAGE_SWITCH_PASSWORD 或网页首次设置）。

📁 项目结构

tools/
├── app/
│   ├── api/                    # API 路由（传输、信令、设置）
│   ├── tools/                  # 各工具页面（每个工具一个目录）
│   │   ├── transfer/           # T-01 文本/文件互传
│   │   ├── qr/                 # T-02 二维码
│   │   ├── vercel-clean/       # T-26 Vercel 部署清理
│   │   ├── github-release-clean/ # T-27 GitHub Release 清理
│   │   ├── recorder/             # T-33 屏幕 / 摄像头录制
│   │   ├── ocr/                  # T-34 OCR 文字识别
│   │   ├── excel-functions/      # T-37 Excel 函数快查（含 [slug] 详情页）
│   │   ├── web-nav/              # T-40 好用网站导航（纯外链推荐）
│   │   ├── print/               # T-41 文件打印（调本机打印机）
│   │   ├── pdf/                  # T-20 PDF 工具箱（合并/拆分/旋转/压缩/转图/水印/加密…）
│   │   └── pdf-auto-rotate/      # T-38 已并入 T-20 旋转 Tab；旧路由重定向到 /tools/pdf?tab=rotate
│   ├── globals.css             # 全站样式 + 设计系统
│   ├── layout.tsx              # 根布局（侧边栏 + 内容区）
│   └── page.tsx                # 仪表台首页
├── components/
│   ├── icons.tsx               # lucide 图标封装
│   ├── icon-map.ts             # 工具图标映射
│   ├── tool-head.tsx           # 工具页头部组件
│   └── ui/                     # shadcn 风格组件
├── lib/
│   ├── tools.ts                # 工具注册清单（T-01 ~ T-38）
│   ├── kv.ts                   # KV / R2 / Redis 存储抽象
│   ├── site-auth.ts            # 全站密码认证（HMAC 签名 token）
│   └── rtc-client.ts           # WebRTC 客户端
├── worker-auth.ts              # Cloudflare Worker 入口（全站密码门）
├── wrangler.jsonc              # Cloudflare Workers 配置
├── scripts/
│   └── deploy.sh               # 部署脚本（注入 KV id）
├── .github/workflows/
│   ├── deploy.yml              # 自动部署
│   └── gitleaks.yml            # 密钥扫描
└── package.json

🧩 扩展

新增一个工具

新建页面 app/tools/<slug>/page.tsx（参考现有工具，纯本地工具无需后端）。
在 lib/tools.ts 注册一项：id、name、tagline、description、path、icon（components/icon-map.ts 中已定义或新增）、tags。
侧边栏、搜索面板（Ctrl + K）、仪表台自动出现该工具。

API 一览

查看传输相关 API

方法	路径	说明
POST	`/api/transfer`	创建离线传输 → 返回提取码
GET	`/api/transfer/:code`	取回离线传输内容
DELETE	`/api/transfer/:code`	立即删除离线传输
GET	`/api/transfer/:code/file/:key`	下载离线文件（支持 Range）
POST	`/api/rtc`	创建 P2P 信令房间 → 返回提取码
GET	`/api/rtc/:code`	轮询信令状态
POST	`/api/rtc/:code/offer`	发送方提交 SDP offer
POST	`/api/rtc/:code/answer`	接收方提交 SDP answer
POST	`/api/rtc/:code/candidate`	提交 ICE candidate
DELETE	`/api/rtc/:code`	关闭信令房间

在线直传原理：浏览器 WebRTC 点对点直连，信令仅中转 SDP / ICE 不承载内容；文件 / 文本只在两台设备间传输，服务器不落盘。

🤝 贡献

欢迎通过 GitHub Issues 提交工具想法或反馈问题，也欢迎 Pull Request 贡献新工具或修复。

提交 Issue：新建 Issue
提交 PR：Fork 仓库后创建分支，确保 npm run build 通过后提交

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.impeccable/surfaces		.impeccable/surfaces
app		app
components		components
docs		docs
lib		lib
public		public
scripts		scripts
types		types
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
DESIGN.md		DESIGN.md
LICENSE		LICENSE
PRODUCT.md		PRODUCT.md
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
open-next.config.ts		open-next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
worker-auth.ts		worker-auth.ts
wrangler.jsonc		wrangler.jsonc

Navigation Menu

Repository navigation

About

Repository files navigation

工具箱 TOOLBOX

目录

💡 这是什么

✨ 功能

🚀 安装

从源码安装

本地开发

📖 使用

⚙️ 配置

环境变量

限额

🛠️ 开发

前置要求

常用命令

部署到 Cloudflare Workers

存储后端切换（KV / Redis）

📁 项目结构

🧩 扩展

新增一个工具

API 一览

🤝 贡献

📄 License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

工具箱 TOOLBOX

目录

💡 这是什么

✨ 功能

🚀 安装

从源码安装

本地开发

📖 使用

⚙️ 配置

环境变量

限额

🛠️ 开发

前置要求

常用命令

部署到 Cloudflare Workers

存储后端切换（KV / Redis）

📁 项目结构

🧩 扩展

新增一个工具

API 一览

🤝 贡献

📄 License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages