IT-Tools

面向开发者和 IT 从业者的在线工具集合，注重用户体验。所有工具在浏览器本地运行，无需后端服务，无数据上传。

当前包含 86 个工具，按以下分类组织：

分类	示例
Crypto（加密）	哈希、HMAC、JWT 解析、Bcrypt、加密/解密
Converter（转换器）	进制转换、颜色转换、日期时间转换、JSON/YAML/TOML/XML 互转
Web	URL 编码解码、HTML 实体、MIME 类型、User-Agent 解析、HTTP 状态码
Images and videos（图像视频）	二维码生成、SVG 占位图、相机录制
Development（开发）	JSON 查看/压缩、Crontab 生成、SQL 美化、正则测试、Docker 转换
Network（网络）	IPv4 子网计算、IPv4 地址转换、MAC 地址生成/查询
Math（数学）	数学表达式求值、ETA 计算、百分比计算
Measurement（测量）	秒表、温度转换、基准测试
Text（文本）	Lorem Ipsum、文本统计、Emoji 选择、文本差异对比
Data（数据）	手机号解析、IBAN 校验

技术栈

• 前端框架：Vue 3.5（Composition API）+ Vite 8（rolldown 内核）+ TypeScript 5.9
• 组件库：Naive UI + 自定义 c-* 组件
• 样式：UnoCSS 66（原子类）+ Less
• 其他：Pinia 4 状态管理、vue-router 5、vue-i18n 11 国际化、PWA 离线支持（vite-plugin-pwa）、Monaco Editor、TipTap

快速开始

环境要求：Node.js 20.19+ / 22.12+（建议 24 LTS）、pnpm 9.11

pnpm install     # 安装依赖
pnpm dev         # 启动开发服务器（默认 http://localhost:5173）
pnpm build       # 类型检查 + 生产构建（输出到 dist/）
pnpm preview     # 预览生产构建（http://localhost:5050）

测试

pnpm test:unit           # 单元测试（Vitest 4 + jsdom）
pnpm test:e2e            # 端到端测试（Playwright，自动构建并启动预览服务器）
pnpm test:e2e:dev        # 针对已运行的开发服务器执行 e2e
pnpm lint                # ESLint 10 检查（flat config，见 eslint.config.js）
pnpm typecheck           # vue-tsc 类型检查

单元测试（*.test.ts）与源码同目录；端到端测试（*.e2e.spec.ts）使用 data-test-id 选择器，覆盖 Chromium / Firefox / WebKit 三种浏览器。

添加新工具

pnpm script:create:tool my-tool-name

脚手架会在 src/tools/my-tool-name/ 下生成骨架文件，之后需要：

1. 完善 index.ts 中的工具定义（名称、路径、描述、关键词、图标）
2. 在 src/tools/index.ts 中导入并注册到对应分类
3. 在 locales/en.yml 和 locales/zh.yml 等语言文件的 tools: 段下添加 <工具slug> 条目（至少包含 title 和 description，缺失时会回退英文并在 console 提示）
4. 纯逻辑放入 <name>.service.ts，并编写对应单元测试

UI 组件的创建使用 pnpm script:create:ui（hygen 模板）。

国际化

默认语言为英文，翻译统一集中在 locales/*.yml（当前支持：中文、法语、德语、西班牙语、葡萄牙语、挪威语、乌克兰语、越南语）。工具标题与描述使用 tools.<工具slug>.title / .description 键，工具内部界面文案在同一条目下扩展；键缺失时回退英文。

部署

项目已配置多种部署方式：

• Vercel：vercel.json（SPA 路由回退到 index.html）
• Netlify：netlify.toml
• Docker：Dockerfile 多阶段构建，docker build -t it-tools . 后运行，nginx 提供静态文件

环境变量（均为可选）：BASE_URL（部署子路径）、VITE_TRACKER_ENABLED（启用 Plausible 统计）等，完整列表见 src/config.ts。

许可证

GNU GPLv3