FeHelper 前端助手浏览器工具箱指南:30+ 开发者工具的架构、安装与实战使用

原创2026-10-13 13:58:511,757 阅读
文章标签:开发工具前端AI 应用

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 扩展弹窗面板

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/):

  1. 打开开发者模式;
  2. 点击「加载已解压的扩展程序」;
  3. 选择仓库中的 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 的参考步骤:

  1. 新增 apps/<tool-name>/index.html;
  2. 新增 apps/<tool-name>/index.css;
  3. 新增 apps/<tool-name>/index.js;
  4. 在 apps/background/tools.js 中完成工具注册;
  5. 在 website/docs 目录补写 <tool-name>.md 文档(仓库已内置 30+ 个工具的文档页面,如 website/docs/json-format.md、website/docs/qr-code.md);
  6. 补充必要的单元测试或手动验证说明。

兼容性与边界

从 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、期望结果与实际结果、控制台报错或日志。

标准贡献流程:

  1. Fork 本仓库;
  2. 创建分支:git checkout -b feature/your-feature;
  3. 修改代码后运行 npm test,必要时运行 npm run build;
  4. 提交更改:git commit -m "feat: add your feature";
  5. 推送分支并创建 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> 目录阅读源码与测试。

登录后查看全文
FeHelper