510 款工具,没有一个请求离开浏览器

一个纯前端、零依赖、无需构建的工具箱:打开就是全部,输入的东西一个字节都不上传

站点:**tools.lovou.pw**|仓库:MIT 协议开源


一、先说不做什么

做这个站之前,我列过一张「不做什么」的清单,比功能清单还长:

  • 不上传任何输入(文本、JSON、图片、文件)
  • 不接后端、不接数据库、不接第三方 API
  • 不使用框架,不使用 npm,不需要构建
  • 不加载 CDN 脚本,不加载 Web Font,不埋点
  • 不做登录,不做收藏同步,不做「会员专享」

这些限制看起来是在自缚手脚,但它们共同指向一件事:这个站必须在断网、内网、以及十年后的某个下午都还能打开。开发者工具最怕的就是「当年那个格式化 JSON 的网站挂了」。

于是技术选型几乎不需要讨论:HTML + CSS + 原生 JavaScript(ES6),静态托管,完。

二、510 款工具是怎么排的

先看规模:

项 数值
工具总数 510 款
分类 9 个
工具模块文件 55 个(按分类分批打包,不是一工具一文件)
源码行数 38,684 行(HTML + CSS + JS)
首屏三件套 index.html 7.3 KB + style.css 61.5 KB + main.js 138.4 KB ≈ 207 KB,gzip 后约 60 KB
后续请求 进入工具时才加载对应模块,合计 43 个额外请求
运行时依赖 0
外部请求 0

九个分类的实际分布:

分类 数量 代表工具
开发辅助 89 JSON 格式化 / 路径提取、正则测试、二维码、JWT、CSS Grid / 贝塞尔生成、Dockerfile / Actions 生成
计算换算 76 进制与大数、贷款 / 个税、电阻色环、GPA、盈亏平衡、纸张尺寸
编码解码 68 Base64 / Base32 / Base58 / Base85 / Base45、摩斯、凯撒系、TOTP、CRC16、Code 39
文本处理 67 LCS 对比、去重排序、命名风格、编辑距离、Slug、NATO 音标、竖排文字
时间日期 58 时间戳、时区、Cron 解析与下次运行、二十四节气、夏令时检测、跨时区会议
随机生成 49 密码 / UUID、配色、抽奖、数独、IMEI、车牌、随机 Cron
图片处理 45 压缩到指定体积、九宫格、圆角头像、主色提取、ICO、字符画、半调网点
网络工具 36 子网计算与拆分、CIDR 合并、MAC 格式、缓存策略头、curl 转 fetch
生活实用 22 星座干支、血型遗传、睡眠周期、咖啡因代谢、AQI 折算、周易起名

三、三个真正难的地方

1. 按分类打包,而不是一工具一文件

510 个工具如果一工具一个文件,就是 510 次请求。这个站的做法是:同一分类、同一批次共用一个模块(pack-dev5.js 这种),进过一次之后,同批其他工具零加载。

好处是请求数量从 510 压到 43;代价是单个模块变大(最大的一个几十 KB),改一个工具要动整包。权衡下来是划算的——因为用户的行为是「用两三个工具就走」,不是「一次用三十个」。

2. 该自己写的算法,一个都不能少

零依赖意味着很多轮子得自己造。真正花时间的不是 CRUD,而是这些:

  • 二维码编码器:字节模式编码、GF(256) 上的 Reed-Solomon 纠错、块交织、8 种掩码 + 惩罚分择优。没有引 qrcode.js,因为那会违反「零外部请求」。
  • MD5:纯 JS 实现,含 UTF-8 编码与多分块。SHA 系列则走 crypto.subtle——浏览器原生有,就不该自己写。
  • Punycode:按 RFC 3492 实现,域名转换要用。
  • Cron 解析:五字段解析 + 下次运行时间计算,边界情况(月末、闰年、*/7)比想象中多。
  • 二十四节气:太阳视黄经。
  • 复活节:Meeus 算法。
  • 文本对比:LCS 求最长公共子序列,再回溯生成 diff。

这些实现都放在 js/tools/ 下,随时可以单独拿出去用。

3. 安全随机不是 Math.random()

密码、UUID、抽奖、验证码这类工具,随机源必须是 crypto.getRandomValues。而且要用拒绝采样消除取模偏差——直接 % n 会让某些值出现得更频繁,密码生成器这点偏差虽小,但没理由留。

同理,TOTP 与 JWT 签名的 HMAC 都走 crypto.subtle,密钥与内容全程不离开浏览器。TOTP 的结果我对过 RFC 6238 附录 B 的全部测试向量:SHA-1 / 256 / 512、6 位 / 8 位、30 / 60 秒周期,逐条一致。

四、加一个工具只要两步

这是整个设计里我最在意的部分:新增工具的边际成本要接近零,否则第 200 个之后就没人愿意加了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// 第一步:写渲染函数(js/tools/my-pack.js)
window.ToolModules['my-tool'] = function (root) {
Kit.text(root, {
inputLabel: '输入',
sample: '示例文本',
run: function (text) {
if (!text.trim()) return { error: '请输入内容' };
return { output: text.toUpperCase() };
}
});
};

// 第二步:在 js/main.js 的 TOOLS 数组加一行
tool('my-tool', '我的工具', '开发辅助', '一句话描述。', 'code', '关键词 别名', 'js/tools/my-pack.js'),

Kit.text 会自动补齐输入框、复制 / 清空 / 示例按钮、字符计数、Toast 反馈;tool() 会自动补上 _kit.js 依赖。首页卡片、搜索、分类筛选、hash 路由、同类推荐全部自动生效——配置数组是唯一的真相来源,不存在「加了工具忘了改菜单」这种事。

run 可以直接返回结果,也可以返回 Promise(内部会显示「计算中…」)。结果对象支持 output / html / rows / note / error,足够覆盖纯文本、表格、图表、代码块四类输出。

五、那些容易被忽略的细节

细节 做法 为什么
主题闪烁 <head> 内联脚本在首屏渲染前写入 data-theme 外链 JS 会把白底闪一下再变深色,很难看
大文件 先提示体积上限,再 setTimeout 让出主线程 否则 50MB 的 JSON 直接把页面卡死
输入延迟 输入类工具统一 debounce 120–300ms 边打字边计算,但没必要每个字符都算
错误处理 全局 try/catch + 可读提示 一个工具报错不该让整页白屏
剪贴板 优先 navigator.clipboard,失败回退 execCommand 老浏览器与非 HTTPS 环境仍有一批
图片处理 全部走 Canvas,导出用 toBlob 原图不出内存,且能控制质量
无障碍 aria-label、aria-pressed、role="tab"、可见焦点、prefers-reduced-motion 键盘用户与动效敏感用户都是真实用户
权威日期 版权年份由 JS 写入 不用每年回来改一次 HTML

六、这个站值得做什么、不值得做什么

值得:它把「查一下」「转一下」「算一下」这类高频小事收进一个页面。不用记网址,加进收藏夹或 PWA 主屏,断网也能用。工具全、离线、不上传,三点凑齐的产品其实不多。

不值得:它不是 IDE,也不是专业软件。复杂的正则调试、真正的图像编辑、严肃的密码管理,都该用专门工具。我刻意没做「历史记录同步」「团队共享」这类需要后端的特性——一旦要做,前面那张「不做什么」的清单就全废了。

一点判断:零依赖不是为了炫技,而是为了换来一个可验证的承诺——你可以打开开发者工具的网络面板,然后确认它真的一个请求都没发出去。承诺能被验证,比承诺本身更重要。