Skip to content

panxu71/toolbox

Repository files navigation

🧰 Toolbox - 现代化开发者工具箱

专业的在线开发者工具集合,提供 JSON 处理、代码格式化、加密解密、进制转换、时间处理等 50+ 实用功能

Version License Vue TypeScript Chrome Extension

🚀 快速开始

🌐 在线使用(推荐)

直接访问官网:https://toolbox.panxu.net

📱 Chrome扩展(离线使用)

  1. 下载最新版本:浏览器扩展
  2. 打开 Chrome 扩展管理页面:chrome://extensions/
  3. 直接拖拽zip压缩包到页面中即可完成安装

🛠️ 本地部署(开发者)

# 1. 克隆项目
git clone https://github.com/panxu71/toolbox.git
cd toolbox

# 2. 安装依赖
npm install

# 3. 启动本地服务器
npx serve -s docs -p 8080
# 访问 http://localhost:8080

✨ 功能特色

📋 JSON 工具

  • JSON 格式化 - 美化、压缩、验证 JSON 数据,支持粘贴自动格式化
  • Excel ⇄ JSON 互转 - Excel 表格与 JSON 数据双向转换
  • Postman ⇄ JSON 互转 - Postman 参数与 JSON 格式互相转换
  • PHP ⇄ JSON 互转 - PHP 数组与 JSON 数据格式互相转换

🔄 版本更新

  • 自动检查更新 - 启动时自动检查GitHub releases获取最新版本
  • 更新通知 - 发现新版本时弹窗提醒,支持查看更新内容
  • 版本管理 - 可忽略特定版本,支持手动检查更新
  • 智能缓存 - 24小时缓存机制,避免频繁请求API

🕐 时间工具

  • 在线时钟 - 全新专业级在线时钟,支持5种风格切换:简约白色、LED数码屏、模拟表盘、现代卡片、全屏沉浸式。精确到毫秒显示,支持12/24小时制、农历显示、全屏模式(含防息屏功能),模拟时钟配备真实表盘设计和日期窗口
  • 在线秒表 - 专业级在线秒表工具,毫秒级精度计时,支持计次记录、统计分析、CSV导出、全屏模式(含防息屏功能),适用于运动训练和时间管理
  • 时间戳转换 - 时间戳与日期格式互转,支持多种格式
  • 日期计算器 - 计算日期间隔和加减运算
  • 时区转换 - 全球时区时间转换
  • 倒计时器 - 创建倒计时和定时器功能

🔐 加密解密

  • Base64 编码 - Base64 编码和解码处理
  • URL 编码 - URL 编码和解码转换
  • 哈希生成器 - 生成 MD5、SHA1、SHA256、SHA512 哈希值
  • RSA 密钥生成 - 生成 RSA 公私钥对,支持密码保护
  • 文本编码转换 - Base64、URL、HTML、Unicode、ASCII 多种编码
  • JWT 生成器 - 生成和解析 JWT Token

🔄 转换工具

  • 简繁体转换 - 基于 OpenCC 的权威中文简繁转换
  • 全局文本替换 - 支持正则表达式的强大查找替换
  • PHP 序列化转换 - PHP 序列化与数组、JSON、XML 互转
  • 单位转换 - 长度、重量、温度等单位转换
  • 进制转换 - 二进制、八进制、十六进制等进制转换
  • 数字格式转换 - 阿拉伯数字转罗马数字、中文数字
  • JS/HTML 格式化 - JavaScript、HTML、CSS 代码格式化和压缩
  • 图片 ⇄ Base64 互转 - 图片与 Base64 编码互相转换

🛠️ 生成工具

  • API 接口测试 - 在线 POST/GET 接口测试工具
  • UUID 生成器 - 生成各种版本的 UUID(通用唯一标识符)
  • 密码生成器 - 生成安全随机密码,支持自定义规则
  • 二维码生成 - 生成自定义二维码,支持 Logo 和容错率设置
  • Crontab 表达式 - 生成和解析 Cron 定时任务表达式
  • Markdown 编辑器 - 自研在线 Markdown 编辑器,支持图片拖拽转 Base64,实时预览
  • 在线提词器 - 专业级提词器工具,支持自动滚动、全屏显示、镜像模式、聚焦区域、防息屏功能,适用于演讲、直播、视频录制等场景

🔍 查询工具

  • 屏幕测试 - 检测屏幕显示质量、坏点、色彩准确性等
  • 文本比对 - 比较两个文本的差异,支持文件上传
  • 字符串长度统计 - 统计文本字符数、字节数、单词数等详细信息
  • ASCII 编码查询 - 查询字符的 ASCII 编码值和完整 ASCII 表
  • 正则表达式测试 - 测试正则表达式匹配结果,包含 45+ 常用示例
  • 颜色对照表 - 常用颜色的 HEX、RGB、HSL 格式对照
  • 百家姓查询 - 查询中国传统百家姓的排名、起源和分布
  • MIME-Type 速查表 - 常用文件类型的 MIME-Type 快速查询
  • 历史朝代查询 - 中国历史朝代信息查询和时间轴浏览
  • 世界国家和首都 - 按洲浏览世界各国及其首都信息,支持高级筛选(人口、面积、发达程度)
  • Emoji符号大全 - 按分类浏览和复制各种Emoji表情符号
  • IP地址查询 - 查询IP地址的地理位置、ISP等详细信息,支持多数据源对比

🧭 导航工具

  • 编程语言大全 - 查看各种编程语言的特点、用途和学习资源

📦 构建命令

# 开发环境
npm run dev              # 启动开发服务器

# 构建命令
npm run web              # 构建 Web 版本 (docs/)
npm run pack:ext         # 构建并打包 Chrome 扩展为 zip

# 版本管理
npm run update-version   # 更新所有文件中的版本号

# 本地预览
npx serve -s docs -p 8080  # 预览已构建的Web版本

# 其他命令
npm run type-check       # TypeScript 类型检查

🔄 版本管理说明

npm run update-version 是版本同步工具,不会自动递增版本号,作用是:

  • 📖 从 package.json 读取当前版本号
  • 🔄 同步版本号到所有相关文件:src/config/version.tsREADME.mdmanifest.json、打包脚本

版本更新流程

方式1: 手动更新

# 1. 手动编辑 package.json 中的 version 字段
# 2. 运行同步脚本
npm run update-version

方式2: 使用 npm version 命令

npm version patch        # 2.1.0 → 2.1.1 (修复版本)
npm version minor        # 2.1.0 → 2.2.0 (功能版本)  
npm version major        # 2.1.0 → 3.0.0 (重大版本)
npm run update-version   # 同步到所有文件

🎨 界面特性

  • 🌓 智能主题 - 自动适应系统深色/浅色主题
  • 📱 响应式设计 - 完美支持手机、平板、桌面设备
  • 快速操作 - 一键复制、粘贴、清空、下载功能
  • 🔍 全局搜索 - 快速查找所需工具
  • 💾 数据持久化 - 自动保存用户设置和历史记录
  • 🎯 分类导航 - 清晰的工具分类和标签系统

🔒 隐私安全

  • 本地处理 - 所有数据在本地处理,不上传服务器
  • 隐私保护 - 不收集任何用户个人信息
  • 开源透明 - 完全开源,代码可审查
  • 最小权限 - Chrome 扩展仅申请必要权限

🛠️ 技术栈

技术 版本 用途
Vue.js 3.5+ 前端框架
TypeScript 5.9+ 类型安全
Vite 7.0+ 构建工具
marked 13.0+ Markdown 解析器
Prettier 3.7+ 代码格式化
js-beautify 1.15+ 代码美化
highlight.js 11.11+ 语法高亮
OpenCC 1.0+ 中文转换
SheetJS 0.18+ Excel 处理
QRCode.js 1.5+ 二维码生成

📁 项目结构

toolbox/
├── src/
│   ├── components/          # 功能组件
│   │   ├── Clock.vue
│   │   ├── Stopwatch.vue
│   │   ├── Teleprompter.vue
│   │   ├── JsonFormatter.vue
│   │   ├── TimestampConverter.vue
│   │   ├── PasswordGenerator.vue
│   │   ├── HashGenerator.vue
│   │   ├── RegexTester.vue
│   │   ├── TextCompare.vue
│   │   ├── DynastyQuery.vue
│   │   ├── ProgrammingLanguages.vue
│   │   ├── ImageBase64Converter.vue
│   │   └── ...
│   ├── config/
│   │   ├── cards.json       # 工具配置
│   │   └── navigation.json  # 导航配置
│   ├── types/               # TypeScript 类型
│   ├── composables/         # Vue 组合式函数
│   ├── assets/              # 静态资源
│   ├── App.vue              # 主应用
│   ├── main.ts              # Web 版入口
│   ├── popup.ts             # 扩展版入口
│   └── style.css            # 全局样式
├── scripts/                 # 构建脚本
├── docs/                    # Web 版本构建输出 (GitHub Pages)
├── dist/                    # Chrome 扩展构建输出
├── manifest.json            # 扩展清单
├── vite.config.ts           # Vite 配置
└── package.json             # 项目配置

🔧 开发指南

环境要求

  • Node.js >= 18.0.0
  • npm >= 9.0.0

本地开发

# 1. 克隆项目
git clone https://github.com/panxu71/toolbox.git
cd toolbox

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev
# 访问 http://localhost:5173

# 4. 构建扩展版本(如需要)
npm run pack:ext
# 生成的zip文件可直接拖拽到chrome://extensions/安装

添加新工具

  1. src/components/ 创建新组件
  2. src/config/cards.json 添加工具配置
  3. src/config/navigation.json 添加导航配置(如需要)
  4. src/App.vue 添加组件引用和路由处理

代码规范

# 类型检查
npm run type-check

# 代码格式化(自动)
# 使用 Prettier 配置

📖 相关文档

🤝 贡献指南

欢迎贡献代码、报告问题或提出建议!

贡献流程

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

问题反馈

📊 项目统计

  • 🛠️ 50+ 实用工具 - 覆盖开发常用场景
  • 📱 双端支持 - Web 版本 + Chrome 扩展
  • 🌍 多语言支持 - 中文界面,国际化友好
  • 高性能 - 本地处理,响应迅速
  • 🎨 现代设计 - 简洁美观的用户界面
  • 🧭 7大分类 - JSON工具、时间工具、加密解密、转换工具、生成工具、查询工具、导航工具
  • 🔍 智能搜索 - 全局工具搜索和分类筛选
  • 📊 数据可视化 - 支持图表展示和数据分析
  • 🌐 多数据源 - IP查询等工具支持多个数据源对比
  • 🎯 高级筛选 - 国家查询等工具支持多维度筛选

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

感谢以下开源项目的支持:

📞 联系方式


⭐ 如果这个项目对你有帮助,请给它一个星标!

🚀 立即使用 | 📦 下载扩展 | 📖 查看文档

About

现代化的工具箱

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages