FeHelper 前端助手浏览器工具箱指南:30+ 开发者工具的架构、安装与实战使用
FeHelper 前端助手浏览器工具箱指南:30+ 开发者工具的架构、安装与实战使用
导读
FeHelper(前端助手)是一个从 2012 年持续维护至今的浏览器开发者工具箱,以 Chrome / Edge / Firefox 扩展形态提供 30 多个高频开发工具,涵盖 JSON 处理、编解码、代码美化与压缩、时间戳与进制转换、二维码/条形码、UUID 生成、接口调试与页面性能分析等场景。本文以仓库根目录的 README_KO.md(韩文版项目说明)为核心骨架,结合 apps/background/tools.js 工具注册表、apps/manifest.json MV3 清单、apps/json-format/json-utils.js 等源码实现,系统梳理其功能矩阵、v2026.04 版本改进、三种安装方式、开发调试命令与项目结构,帮助你从"会用"进阶到"能自己扩展"。
FeHelper 的扩展弹窗面板:聚合了常用工具入口,点击即可按需打开对应工具页面。
功能一览:六大类 30+ 工具的完整矩阵
FeHelper 的每一个工具都在 apps/background/tools.js 的 toolMap 中注册(该文件同时定义了工具名称、功能简介、右键菜单配置与是否注入 Content Script),并在 apps/manifest.json 的 version 中随版本迭代。README_KO.md 将全部工具划分为六大类,以下逐类展开。
JSON 处理
| 功能 | 说明 |
|---|---|
| JSON 格式化 | 自动/手动格式化、语法高亮、折叠/展开、节点路径、BigInt 无损精度 |
| JSON 比对 | 两段 JSON 的结构化差异比对,差异项高亮标记 |
| JSON → Excel | 将 JSON 数据一键转换为 Excel 表格 |
JSON 格式化是 FeHelper 的核心工具之一,其"BigInt 无损精度"由 apps/json-format/json-utils.js 实现:该模块是"可被 Vitest 直接测试的纯函数模块",通过 PRESERVED_INTEGER_KEY_PREFIX 前缀标记大整数、按 14 位分块重建 BigNumber(见 rebuildBigNumberFromParts),并配套 apps/json-format/json-bigint.js 等模块协同工作。相关测试位于 test/json-utils.test.js,是理解其精度保障逻辑的最佳起点。
编码/解码
| 功能 | 说明 |
|---|---|
| Unicode | 汉字 ↔ \uXXXX 互转 |
| URL / UTF-8 / UTF-16 | %XX / \xXX 编码与解码 |
| Base64 | 编码与解码 |
| Hex | 字符串 ↔ 十六进制 |
| MD5 / SHA1 | 摘要计算 |
| Gzip | 基于 CompressionStream API 的压缩/解压 |
| JWT | 解码 Header + Payload + Sign |
| Cookie | 格式化为 JSON 展示 |
| HTML 实体 | 普通/深度编码与解码 |
| 字符串转义 | \n、\t、\" 等转义与反转义 |
以上能力集中实现在 apps/en-decode/endecode-lib.js(编码解码核心库)与 apps/en-decode/index.js(工具页面逻辑)中,README 中提到的十种格式在该页面均有一一对应的转换入口。
开发与调试
| 功能 | 说明 |
|---|---|
| 代码美化 | JavaScript / CSS / HTML / XML / SQL 格式化 |
| 代码压缩 | HTML / JS / CSS 压缩 |
| 正则公式 | 实时匹配与替换测试 |
| 简易 Postman | GET / POST / HEAD 接口调试 |
| WebSocket | WebSocket 连接测试与消息分析 |
| 油猴脚本 | 页面脚本注入 |
从 apps/background/tools.js 的注册信息可见:code-beautify 与 code-compress 分别由 apps/code-beautify/index.html 与 apps/code-compress/index.html 承载;postman、websocket 等工具还提供了右键菜单入口(contexts 含 page/selection/editable),选中文本即可直接唤起。
转换工具
| 功能 | 说明 |
|---|---|
| 时间戳转换 | Unix ↔ 日期互转、多时区世界时钟、Windows FILETIME 互转 |
| 进制转换 | 2/4/8/10/16 进制互转,BigInt 支持超大整数无损转换 |
| 颜色转换 | HEX / RGB / HSL / HSV 互转,支持透明度 |
时间戳转换(apps/timestamp/index.html)、进制转换(apps/trans-radix/index.html)、颜色转换(apps/trans-color/index.html)均为独立工具页面,其中进制转换与 JSON 处理一样采用了 BigInt 方案处理超大整数。
图像与生成
| 功能 | 说明 |
|---|---|
| 二维码 | 生成(支持 Logo、颜色、尺寸选项)与扫码解码 |
| 条形码 | Code128 / Code39 / EAN-13 / EAN-8 / UPC / ITF-14 |
| UUID / ID 生成器 | UUID v4、Snowflake 雪花 ID(生成 + 解析)、NanoID |
| 图片 Base64 | 图片 ↔ Base64 互转 |
| 网页截屏 | 可视区域 / 全页滚动截屏 |
| 取色器 | 从页面任意元素提取颜色 |
| SVG 转换 | SVG ↔ PNG 等格式转换 |
QR 码与条形码由 apps/qr-code/index.html 承载;UUID 生成器(apps/uuid-gen/index.html)除 README 列出的 UUID v4、雪花 ID、NanoID 外,其 apps/uuid-gen/ulid-core.js 还实现了 ULID(26 位 Crockford Base32、同毫秒内单调递增、时钟回拨保护),对应测试见 test/qr-code-ai-actions.test.js 之外的 test/totp-auth-tool.test.js 系列。
其他工具
| 功能 | 说明 |
|---|---|
| AI 助手 | 代码优化、方案设计、资料查找 |
| Mock 数据 | 姓名、手机号、身份证、地址等测试数据生成 |
| 随机密码 | 长度与字符类型可自定义 |
| 便签笔记 | 分类目录管理,支持导入/导出 |
| Markdown 转换 | HTML → Markdown、PDF 下载 |
| 海报制作 | 多模板海报设计 |
| 图表制作 | 多类型图表数据可视化 |
| 页面性能 | 页面加载时间分析 |
这一分类之外,工具注册表还列出了 Crontab 工具、贷款(还款)利率、存储单位转换、FH 开发者工具(自定义工具集成)、TOTP 双因素动态口令、时间戳计算器等能力(apps/background/tools.js),实际工具数量已超过 README 表格的汇总口径。
v2026.04 重点改进解读
README_KO.md 用较大篇幅记录了 v2026.04 版本的重点改进,可分为四类。这些改动不仅在文档中声明,也能在源码与测试中一一找到对应。
新增功能
- 条形码生成:支持 Code128 / EAN-13 / UPC 等 6 种格式,入口位于 apps/qr-code;
- UUID v4 / Snowflake ID / NanoID 生成器:全新工具页面 apps/uuid-gen;
- Windows FILETIME ↔ 日期互转:在 apps/timestamp 中新增;
- 字符串转义/反转义:编码解码(apps/en-decode)新增
\n、\t、\"等转义能力; - 进制转换 BigInt 支持:超大整数无损转换,见 apps/trans-radix。
安全加固
- 项目全量替换不安全的
evalCore动态执行路径; - 修复 Toast / innerHTML 的 XSS 注入风险;
- 改进 Content Script 注入逻辑,用
insertCSS替换误用的 API; - 为
_codeBeautify增加fileType白名单校验(对应 apps/code-beautify)。
核心修复
- JSON BigInt 无损精度:重构为纯函数模块 apps/json-format/json-utils.js,使其可直接被 Vitest 测试;
- Service Worker 休眠问题:用
chrome.alarms替代setTimeout。源码证据在 apps/background/background.js 第 990~1001 行:注册chrome.alarms.onAlarm监听并创建周期为 1440 分钟的fehelper-check-update定时任务,配合 apps/manifest.json 中alarms权限,避免后台脚本因长时间setTimeout被浏览器挂起; - Content Script 策略调整:改为
document_idle+all_frames: false,修复 Google Meet 等站点崩溃问题——apps/manifest.json 的content_scripts段正是该配置的落点; - 时间戳
0校验修复:处理 Unix 时间戳为 0 时的边界情况; - 代码美化兼容
let/const:支持现代 JavaScript 语法。
工程化建设
- 单元测试:Vitest + 79 个测试用例。仓库
test/目录下现有 34 个测试文件,实际it()/test()用例数已超过 263 个(含describe内嵌套用例),覆盖背景菜单、URL 策略、JSON 工具、编解码、开放模式等核心模块; - CI/CD:GitHub Actions 自动测试,配置见 .github/workflows/ci.yml(Node 22 +
npm test),另有 .github/workflows/pages.yml 用于站点发布; - ESLint 代码风格:根目录 eslint.config.js;
- 清理无用依赖与死代码;
- Babel 目标从 Chrome 58 升级到 Chrome 100。
安装方式
浏览器商店安装(推荐)
README_KO.md 提供了三种主流浏览器的官方商店入口:
- Chrome:在 Chrome Web Store 中搜索「FeHelper」并安装;
- Edge:在 Microsoft Edge Add-ons 中搜索安装;
- Firefox:在 Firefox Add-ons(AMO)中搜索安装。
商店安装会自动保持版本更新,适合绝大多数用户。
源码安装(开发/尝鲜)
git clone https://gitcode.com/zxlie/FeHelper.git
cd FeHelper
npm install
npm test # 运行测试
然后打开 chrome://extensions/(Chrome / Edge 为 edge://extensions/):
- 打开开发者模式;
- 点击「加载已解压的扩展程序」;
- 选择仓库中的
apps目录。
扩展的图标、弹窗与后台脚本均由 apps/manifest.json 定义,加载后即可在工具栏看到 FeHelper 图标(默认快捷键 Alt+Shift+J 可唤起弹窗)。
离线安装
可前往 Chrome-Stats 获取 CRX 或 ZIP 包,然后在 chrome://extensions/ 页面直接拖入安装。适用于无法访问商店或需要固定版本的环境。
开发与调试指南
常用命令
npm install # 安装依赖
npm test # 运行 Vitest 单元测试
npm run test:watch # 测试监听模式(文件变更自动重跑)
npm run test:coverage # 输出覆盖率报告
npm run build # Gulp 打包 Chrome 扩展
npx eslint apps/ # 代码规范检查
以上命令与 package.json 的 scripts 字段一一对应(build 实际执行 gulp)。测试配置见 vitest.config.js:开启 globals、Node 环境、匹配 test/**/*.test.js,覆盖率基于 v8 收集 apps/**/*.js。
项目结构
FeHelper/
├── apps/ # 扩展源码
│ ├── manifest.json # Chrome Extension Manifest V3 清单
│ ├── background/ # Service Worker、工具注册、右键菜单、统计、注入逻辑
│ ├── popup/ # 扩展弹窗面板
│ ├── options/ # 设置页与工具市场
│ ├── json-format/ # JSON 美化
│ ├── en-decode/ # 编码/解码
│ ├── timestamp/ # 时间戳转换
│ ├── trans-radix/ # 进制转换
│ ├── qr-code/ # 二维码 + 条形码
│ ├── uuid-gen/ # UUID / 雪花 ID / NanoID / ULID
│ ├── code-beautify/ # 代码美化
│ ├── page-monkey/ # 油猴脚本
│ ├── poster-maker/ # 海报制作
│ ├── chart-maker/ # 图表制作
│ └── ... # 其他工具
├── website/ # 官网与文档站点
├── test/ # Vitest 单元测试
├── .github/workflows/ # CI/CD
├── gulpfile.js # Gulp 打包任务
├── vitest.config.js # 测试配置
├── eslint.config.js # ESLint 配置
└── package.json
README_KO.md 列出的目录骨架与实际仓库一致;在此基础上,apps/background/tools.js 是工具注册的枢纽,每个工具页都对应 toolMap 中的一个条目。需要说明的是,打包脚本 gulpfile.js 针对 Chrome / Edge / Firefox 做了差异化处理:Chrome 商店需要 update_url,Edge 移除之,Firefox 则把 service_worker 后台改为 scripts 形态、补充 browser_specific_settings(gecko id 为 firefox@fehelper.com)并放宽 CSP(wasm-unsafe-eval / worker-src / connect-src)。此外,Firefox 端会从工具注册表移除 color-picker、postman、devtools、websocket、page-timing 等部分工具(apps/background/tools.js 末尾与 gulpfile.js 的 FIREFOX_REMOVE_TOOLS 均有体现)。
新增工具建议
README_KO.md 未单独展开新增工具流程,但仓库 README(README.md)给出了明确的落地清单,可作为扩展 FeHelper 的参考步骤:
- 新增
apps/<tool-name>/index.html; - 新增
apps/<tool-name>/index.css; - 新增
apps/<tool-name>/index.js; - 在 apps/background/tools.js 中完成工具注册;
- 在 website/docs 目录补写
<tool-name>.md文档(仓库已内置 30+ 个工具的文档页面,如 website/docs/json-format.md、website/docs/qr-code.md); - 补充必要的单元测试或手动验证说明。
兼容性与边界
从 apps/manifest.json 与 README.md 可以确认扩展的技术基线:
- 扩展规范:Chrome Extension Manifest V3;
- 主要浏览器:Chrome、Edge、Firefox;
- 构建目标:现代 Chromium 内核,Babel target 已升级到 Chrome 100;
- 权限集:
alarms、tabs、scripting、contextMenus、activeTab、storage、notifications、unlimitedStorage、webNavigation(downloads为可选权限),主机权限覆盖http://*/*、https://*/*、file://*/*; - 数据存储:主要使用浏览器本地存储,不依赖远程账号系统。
部分功能依赖浏览器能力与站点授权,例如截图、取色、油猴注入、CompressionStream(Gzip 压缩/解压)、WebSocket 等;在浏览器限制页面、Chrome Web Store 页面以及 CSP 严格的站点上可能存在功能边界。
贡献与反馈
欢迎通过 Issue 和 Pull Request 参与贡献。提交 Issue 时建议包含:浏览器类型与版本、FeHelper 版本、问题工具名称、输入样例与目标 URL、期望结果与实际结果、控制台报错或日志。
标准贡献流程:
- Fork 本仓库;
- 创建分支:
git checkout -b feature/your-feature; - 修改代码后运行
npm test,必要时运行npm run build; - 提交更改:
git commit -m "feat: add your feature"; - 推送分支并创建 Pull Request。
仓库许可证为 MIT(见 LICENSE),协议简洁,可自由使用与二次开发。
总结
FeHelper 的价值在于把前端日常开发中零散的小工具统一收敛到一个 MV3 扩展中,并保持高频迭代:JSON BigInt 精度、Service Worker 唤醒(chrome.alarms)、Content Script 注入策略(document_idle + all_frames: false)等 v2026.04 的关键改动都能在 apps/background/background.js、apps/json-format/json-utils.js、apps/manifest.json 中找到源码级佐证;配合 Vitest 单元测试(test 目录 30+ 测试文件)与 GitHub Actions CI(.github/workflows/ci.yml),它同时具备"拿来即用"的工具价值与"按需扩展"的开发价值。若你想深入某一具体工具的实现,可直接从 apps/background/tools.js 的工具注册条目出发,跳转到对应 apps/<tool-name> 目录阅读源码与测试。
