FeHelper 前端助手完全指南:30+ 浏览器开发者工具箱的安装、功能矩阵与源码级开发实践

原创2026-10-11 21:03:421,987 阅读
文章标签:开发工具前端

FeHelper 前端助手完全指南:30+ 浏览器开发者工具箱的安装、功能矩阵与源码级开发实践

FeHelper 是一款集成式浏览器开发者工具箱(Chrome / Edge / Firefox 扩展,基于 Manifest V3),把 JSON 格式化、编解码、时间戳、二维码、代码美化、接口调试、网页截图、油猴脚本、AI 助手等 30+ 高频小工具统一收进一个扩展。本文将围绕仓库根目录 README.md 展开,完整梳理其功能矩阵、安装方式、工程结构、构建流程与个性化配置,并结合 apps/manifest.json、apps/background/tools.js 等源码揭示其实现原理,帮助读者快速上手使用,也能在此基础上二次开发属于自己的工具。

项目定位与适用场景

FeHelper 的核心理念是"按需启用的 All-in-one 工具箱":把日常高频的小工具集中到一个扩展里,JSON 格式化、编解码、时间戳、二维码、代码美化、正则、接口调试、WebSocket、网页截图、取色、Mock 数据、油猴脚本、图表、海报、AI 助手等都可以按需安装或卸载。从 README.md 的定位描述看,它主要面向以下几类场景:

  • 接口联调:JSON 自动美化、JSON Diff、简易 Postman、WebSocket 调试;
  • 数据处理:编解码、Excel 转 JSON、Mock 数据、进制转换、时间戳转换;
  • 页面调试:网页截屏、页面取色、栅格标尺、页面性能分析、油猴脚本注入;
  • 内容生成:二维码、条形码、UUID / 雪花 ID、图表制作、海报快速生成;
  • 日常效率:随机密码、便签笔记、HTML 转 Markdown、AI 助手。

在源码层面,工具清单集中维护在 apps/background/tools.js 的 toolMap 注册表中(每项包含 name、tips、menuConfig 等字段,是右键菜单与动态工具运行器的数据源),而工具的展示分类则定义在 apps/options/index.js 的 TOOL_CATEGORIES 中。README 中的功能矩阵与这两处源码一一对应,下文将逐一展开。

功能矩阵全解析

README 将 30+ 工具划分为五大类。下面结合 apps/background/tools.js 中登记的 34 个工具逐一说明。

JSON 与数据处理

工具 能力
JSON 美化工具 页面自动检测并格式化、手动格式化、语法高亮、折叠展开、排序、乱码修正、BigInt 精度无损、嵌套转义解析、皮肤定制、复制/下载
JSON 比对工具 两段 JSON 结构化比较,标记新增、删除、修改差异
Excel 转 JSON 将 Excel / CSV 数据转换为 JSON、XML、MySQL、PHP 等结构
数据 Mock 工具 生成姓名、手机号、身份证、地址、公司、技术字段等测试数据
图表制作工具 制作柱状图、折线图、饼图等常用可视化图表,并支持导出图片

其中 JSON 美化工具的"BigInt 精度无损"和"嵌套转义解析"能力,对应 apps/json-format/json-bigint.js 与 apps/json-format/json-decode.js 两个独立模块,并被 apps/manifest.json 的 web_accessible_resources 声明为可供注入页面访问的资源。测试方面,仓库在 test/json-utils.test.js 中对 isUrl、isBigNumberLike 等工具函数有专门的用例覆盖。

编解码与转换

工具 能力
信息编码转换 Unicode、UTF-8、UTF-16、URL、Base64、MD5、SHA1、Hex、Gzip、JWT、Cookie、HTML 实体、字符串转义/去转义
时间戳转换 Unix 秒/毫秒与日期互转、世界时区、Windows FILETIME 互转
时间戳计算器 智能解析多种时间格式、代码生成、时间计算、批量转换、时区转换、数据库格式生成、模拟时区解析
进制转换工具 2 到 36 进制任意互转,支持 BigInt 超大整数无损转换
颜色转换工具 HEX、RGB、RGBA、HSL、HSV 等颜色格式互转
Crontab 工具 生成、编辑和解释 Crontab 表达式
贷(还)款利率 贷款还款计划、实际利率反推

信息编码转换的实现集中在 apps/en-decode/endecode-lib.js(附带 apps/en-decode/md5.js、apps/en-decode/he.js 等算法模块),右键菜单中它支持 page、selection、editable 上下文,即选中文本即可一键编解码。

开发与调试

工具 能力
代码美化工具 JavaScript、CSS、HTML、XML、SQL 格式化
代码压缩工具 HTML、JavaScript、CSS 压缩
正则公式速查 常用正则模板、实时匹配和替换测试
简易 Postman GET / POST / HEAD 请求调试,支持 JSON 结果格式化
WebSocket 工具 WebSocket 连接测试、消息发送、结果分析
网页油猴工具 配置页面匹配规则、注入脚本和样式、导入/导出 .user.js、运行日志、@require 支持
FH 开发者工具 本地开发并集成自定义工具到 FeHelper 工具市场
AI 智能助手 写代码、改代码、方案设计、资料查找和分析

代码美化与压缩的实现分别位于 apps/code-beautify/(含 beautify.js、beautify-css.js 等)与 apps/code-compress/(含 uglifyjs3.js、htmlminifier.min.js)。AI 智能助手模块位于 apps/aiagent/,由 fh.ai.js、fh.ai-features.js、fh.ai-inline.js 构成。

页面与图像工具

工具 能力
二维码 / 解码 生成二维码,支持 Logo、颜色、尺寸;支持截图粘贴解码
条形码 Code128、Code39、EAN-13、EAN-8、UPC、ITF-14
图片转 Base64 图片链接、截图、文件与 Base64 互转
网页截屏工具 可视区域截屏、全页滚动截屏、结果预览和保存
页面取色工具 从网页任意元素采集颜色
SVG 转为图片 SVG 转 PNG / JPG / WebP,支持自定义尺寸、拖放、URL 导入
网页栅格标尺 页面横纵标尺,辅助检查布局对齐
网站性能优化 页面性能指标、资源加载、内存、长任务监控和优化建议

这类工具大量依赖 content script 注入与页面交互。例如二维码解码的右键菜单流程在 apps/background/menu.js 中实现:先通过 chrome.scripting.executeScript 注入 apps/qr-code/content-script.js,再调用 window.qrcodeContentScript().decode() 完成解码,可看到 injectImmediately: true 的时序控制,避免 Service Worker 重启后解码环境未就绪。

生产力工具

工具 能力
UUID / ID 生成器 UUID v4、Twitter Snowflake 风格雪花 ID、NanoID,支持雪花 ID 字段解析
随机密码生成 自定义长度、数字、大小写字母、特殊符号
我的便签笔记 分类目录管理、自动保存、导入导出
Markdown 转换 Markdown 编写/预览、HTML 转 Markdown、PDF 下载
海报快速生成 多模板海报制作,支持文字、图片、配色和导出
便捷思维导图 轻量思维导图,支持自动保存、导入导出、图片下载

架构与实现基础:Manifest V3 与后台服务

FeHelper 的扩展规范是 Chrome Extension Manifest V3,核心配置在 apps/manifest.json。从中可以看到几个关键设计:

权限与快捷键(apps/manifest.json):声明了 alarms、tabs、scripting、contextMenus、activeTab、storage、notifications、unlimitedStorage、webNavigation 等权限,host_permissions 覆盖 http://*/*、https://*/*、file://*/*,并预留了可选权限 downloads。同时注册了全局快捷键 Alt+Shift+J(commands._execute_action)用于直接唤起弹出面板。

后台运行:background.service_worker 指向 apps/background/background.js,并以 "type": "module" 方式加载。该入口聚合了菜单管理(menu.js)、工具注册(tools.js)、脚本注入(inject-tools.js)、油猴执行(monkey.js)、统计(statistics.js)以及 URL 策略(url-policy.js)等模块。

注入安全策略:不是所有页面都允许注入。 apps/background/url-policy.js 定义了可注入规则——仅 http(s):// 与 file:// 开头的 URL 可注入,且 chrome.google.com、chromewebstore.google.com 被列入黑名单。同时 apps/manifest.json 设置了严格的 content_security_policy(扩展页 script-src 'self'),并将 apps/dynamic/sandbox.html 声明为沙箱页面,用于承载相对不安全的动态执行场景。

右键菜单体系:FeHelper 的入口之一是浏览器右键菜单。 apps/background/menu.js 按"文本与代码 / 编解码转换 / 页面与调试 / 二维码与图像 / 效率与生成"五个分组挂载子菜单,json-format、code-beautify、en-decode、datetime-calc 等工具支持从选中文本直接唤起(通过 chrome.scripting.executeScript 读取选区内容后交给 DynamicToolRunner 运行)。

安装指南

方式一:浏览器商店安装

FeHelper 面向三大主流浏览器分发:

浏览器 安装入口
Chrome 在 Chrome Web Store 中搜索 "FeHelper 前端助手"(扩展 ID:pkgccpejnmalmdinmhkkfafefagiiiad)并安装
Edge 在 Microsoft Edge Add-ons 中搜索 "FeHelper 前端助手" 并安装
Firefox 在 Firefox Add-ons(AMO)中搜索 "fehelper 前端助手" 并安装

方式二:源码安装(本地加载)

适用于想体验最新代码或进行二次开发的场景:

git clone https://gitcode.com/gh_mirrors/fe/FeHelper.git
cd FeHelper
npm install
npm test
npm run build

Chrome / Edge 本地加载步骤:

  1. 打开 chrome://extensions/ 或 edge://extensions/;
  2. 开启「开发者模式」;
  3. 点击「加载已解压的扩展程序」;
  4. 选择仓库中的 apps 目录。

方式三:离线安装

可以前往 Chrome-Stats 等 CRX 镜像站点下载 CRX / ZIP 安装包,然后在浏览器扩展页面拖拽安装。适合无法访问商店或需要固定版本分发的场景。

开发指南

常用命令

npm install           # 安装依赖
npm test              # 运行 Vitest 单元测试
npm run test:watch    # 测试监听模式
npm run test:coverage # 覆盖率报告
npm run build         # 打包 Chrome 扩展
npx eslint apps/      # 代码规范检查

这些脚本定义在 package.json 中:test 对应 vitest run,build 对应 gulp,测试配置集中在 vitest.config.js(globals: true、environment: 'node',测试文件位于 test/**/*.test.js)。

项目结构

FeHelper/
├── apps/                    # 扩展源码
│   ├── manifest.json        # Chrome Extension Manifest V3 清单
│   ├── background/          # Service Worker、工具注册、菜单、统计、注入逻辑
│   ├── popup/               # 扩展弹出面板
│   ├── options/             # 设置页与工具市场
│   ├── json-format/         # JSON 美化
│   ├── json-diff/           # JSON 比对
│   ├── en-decode/           # 编解码
│   ├── datetime-calc/       # 时间戳计算器
│   ├── timestamp/           # 旧版时间戳转换
│   ├── page-monkey/         # 网页油猴工具
│   ├── poster-maker/        # 海报快速生成
│   ├── chart-maker/         # 图表制作
│   ├── svg-converter/       # SVG 转图片
│   ├── uuid-gen/            # UUID / 雪花 ID / NanoID
│   └── ...                  # 其他工具
├── website/                 # 官网与文档站点
├── test/                    # Vitest 单元测试
├── .github/workflows/       # GitHub Actions
├── gulpfile.js              # 打包任务
├── vitest.config.js         # 测试配置
├── eslint.config.js         # ESLint 配置
└── package.json

新增工具建议

新增一个工具时,建议同时补齐以下六项,保证它能被注册、可访问、可文档化并可测试:

  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 中的文档
  6. 必要的单元测试或手动验证说明

从源码看,第 4 步是核心接线点:在 apps/background/tools.js 的 toolMap 中新增条目(含 name、tips、menuConfig、contentScriptJs、noPage 等字段)后,右键菜单(menu.js 的 _initMenuOptions 会遍历 toolMap 自动创建菜单项)、弹出面板与工具市场(apps/options/index.js 按 TOOL_CATEGORIES 分类展示)都会自动生效。

多浏览器构建流水线

仓库的打包任务由 gulpfile.js 实现,以唯一的 apps/manifest.json 为基准,通过 BROWSER_PATCHES 做最小化差异补丁,分别产出三个目标:

  • npm run build(gulp 默认任务):打包 Chrome,输出 output-chrome,写回 Chrome 商店所需的 update_url,最终生成 fehelper.zip;
  • gulp edge:打包 Edge,输出 output-edge(移除 update_url);
  • gulp firefox:打包 Firefox,输出 output-firefox,将 service_worker 改写为 scripts 形式、注入 browser_specific_settings(gecko id 为 firefox@fehelper.com,要求 Firefox 140+),并移除 Firefox 不支持的 10 个工具(color-picker、postman、devtools、websocket、page-timing、grid-ruler、naotu、screenshot、page-monkey、excel2json)。

构建过程还包括 JS 合并(__importScript 内联)、Babel 转译、Uglify 压缩、HTML/CSS/JSON 压缩、图片压缩(mozjpeg/gifsicle/svgo)以及"未引用文件检测"(自动清理未被任何 HTML/JS/CSS/JSON 引用的静态资源)。

配置与个性化

FeHelper 的设置页与工具市场位于 apps/options/,配置项默认值定义在 apps/options/settings.js:

配置项 默认值 含义
OPT_ITEM_CONTEXTMENUS true 是否启用右键菜单集成
JSON_PAGE_FORMAT true 是否在页面自动检测并格式化 JSON
FORBID_OPEN_IN_NEW_TAB false 是否禁止在新标签页打开工具
AUTO_DARK_MODE false 是否跟随系统自动切换暗色模式
ALWAYS_DARK_MODE false 是否始终使用暗色模式
CONTENT_SCRIPT_ALLOW_ALL_FRAMES false 是否允许 content script 注入所有 frame
FORBID_STATISTICS false 是否禁止统计数据上报

除基本配置外,设置页还提供:FH 快捷键设置(默认 Alt+Shift+J,打开面板后可用方向键选择、回车确认)、FH 工具排序(拖拽调整弹窗内工具顺序,自动持久化到 chrome.storage.local,支持一键重置)、右键菜单管理(选择性地将工具加入或移出右键菜单)以及工具市场的搜索、分类筛选、收藏、最近使用、批量安装/卸载等能力。

兼容性与功能边界

项目 说明
扩展规范 Chrome Extension Manifest V3
主要浏览器 Chrome、Edge、Firefox
构建目标 现代 Chromium 内核,Babel target 已升级到 Chrome 100
权限 tabs、scripting、contextMenus、storage、webNavigation、notifications 等
数据存储 主要使用浏览器本地存储,不依赖远程账号系统

需要注意的是,部分功能依赖浏览器能力和站点权限,例如截图、取色、油猴注入、CompressionStream、WebSocket 等;在浏览器限制页面、Chrome Web Store 页面、部分 CSP 严格站点上可能存在功能边界。如前文所述,Firefox 版本还会因 API 差异移除部分工具,这是 gulpfile.js 与 apps/background/tools.js 中明确写明的行为。

最近更新(v2026.04)与工程质量

README 的版本动态展示了近期的改进方向:

类型 内容
新工具 条形码生成、UUID / 雪花 ID / NanoID、时间戳计算器、SVG 转图片、图表制作、海报快速生成
JSON BigInt 精度无损、嵌套转义解析、JSON 自动美化重复内容修复、格式化容器重复挂载保护
时间 Windows FILETIME 互转、时间戳计算器模拟时区解析、时区转换增强
油猴 .user.js 导入导出、@all-frames 解析修复、frame 精准注入、运行日志诊断
海报 检测到的模板硬编码文字可在编辑面板修改,修复底部最后一行无法调整
安全 替换不安全动态执行路径、修复 Toast / innerHTML XSS 风险、代码美化 fileType 白名单
稳定性 Service Worker 休眠处理、Content Script 注入策略优化、Google Meet 等站点兼容修复
工程化 Vitest 单元测试、GitHub Actions CI、ESLint、Babel target 升级、依赖和死代码清理

工程质量方面,仓库当前在 test/ 目录下维护了 28 个 Vitest 测试文件,覆盖 JSON 工具(json-utils.test.js、json-format-ai-actions.test.js、json-diff-utils.test.js)、编解码(en-decode-ai-analyzer.test.js、en-decode-hex-protobuf.test.js)、AI 助手(ai-inline-utils.test.js)、URL 策略(background-url-policy.test.js)等核心模块;README 中还给出了 npm test 的示例输出。代码规范方面使用 ESLint(配置见 eslint.config.js),CI 由 GitHub Actions 驱动。

贡献指南

欢迎提交 Issue 和 Pull Request。为了便于维护,反馈问题时请尽量提供清晰的复现信息:

  • 浏览器类型和版本;
  • 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。

许可证

FeHelper 基于 MIT License 开源,欢迎在遵守协议的前提下自由使用、修改与分发。项目联系邮箱为 xianliezhao@foxmail.com,更多工具文档可查阅仓库内 website/docs/ 目录(含 index.md 总览及各工具独立文档)。

登录后查看全文
FeHelper