FeHelper 前端助手完全指南:30+ 浏览器开发者工具箱的安装、功能矩阵与源码级开发实践
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 本地加载步骤:
- 打开
chrome://extensions/或edge://extensions/; - 开启「开发者模式」;
- 点击「加载已解压的扩展程序」;
- 选择仓库中的
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
新增工具建议
新增一个工具时,建议同时补齐以下六项,保证它能被注册、可访问、可文档化并可测试:
apps/<tool-name>/index.htmlapps/<tool-name>/index.cssapps/<tool-name>/index.jsapps/background/tools.js中的工具注册website/docs/<tool-name>.md中的文档- 必要的单元测试或手动验证说明
从源码看,第 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 或截图;
- 期望结果和实际结果;
- 控制台报错或运行日志。
贡献流程:
- Fork 本仓库;
- 创建分支:
git checkout -b feature/your-feature; - 修改代码并运行
npm test、必要时运行npm run build; - 提交更改:
git commit -m "feat: add your feature"; - 推送分支并创建 Pull Request。
许可证
FeHelper 基于 MIT License 开源,欢迎在遵守协议的前提下自由使用、修改与分发。项目联系邮箱为 xianliezhao@foxmail.com,更多工具文档可查阅仓库内 website/docs/ 目录(含 index.md 总览及各工具独立文档)。