jisuxiang/README.zh-CN.md

极速箱 | 高效开发工具集成平台

极速箱是一个高颜值的在线开发工具箱，提供各种程序员必备的开发工具，帮助开发者提升编程效率。本项目使用 Next.js 和 TailwindCSS 开发，拥有美观现代的界面设计。

在线演示: https://www.jisuxiang.com/ - 立即体验！

English Documentation

🚀 功能特点

• 多种分类工具：JSON处理、编码解码、网络测试等多种实用工具
• 响应式设计：适配各种设备尺寸，提供最佳用户体验
• 暗色主题：保护眼睛的界面设计，适合长时间使用
• 高效搜索：快速找到所需工具的强大搜索功能
• 收藏系统：保存常用工具，方便快速访问
• 多语言支持：支持中文和英文界面

🔧 包含工具

• JSON格式化与验证
• HTTP请求测试
• 时间戳转换
• 编码解码工具
• 正则表达式测试
• 加密解密工具
• 颜色选择与转换
• 代码格式化
• JSON编辑器与转换器
• IP地址查询
• 日期计算器
• 时区转换
• 文本统计
• HTML/Markdown转换
• 图片压缩
• 二维码生成
• CSS渐变生成器
• 更多实用工具...

🛠️ 技术栈

• Next.js - React生产级框架
• TailwindCSS - 实用优先的CSS框架
• Font Awesome - 图标库
• TypeScript - 类型安全的JavaScript

📦 安装方法

1. 克隆仓库:

git clone https://github.com/yourusername/jisuxiang.git
cd jisuxiang

2. 安装依赖:

npm install
# 或者
yarn install
# 或者
pnpm install

3. 运行开发服务器:

npm run dev
# 或者
yarn dev
# 或者
pnpm dev

4. 在浏览器中打开 http://localhost:3000 查看应用。

🚢 部署说明

使用Docker部署

提供了Dockerfile用于容器化部署:

# 构建Docker镜像
docker build -t jisuxiang .

# 运行容器
docker run -p 3000:3000 jisuxiang

使用Node.js部署

在Node.js服务器上进行生产部署:

# 构建应用
npm run build

# 启动生产服务器
npm start

🧩 项目结构

jisuxiang/
├── src/
│   ├── app/              # Next.js应用目录（页面、布局）
│   ├── components/       # 可复用UI组件
│   ├── config/           # 配置文件
│   │   ├── categories.ts # 工具分类定义
│   │   ├── tools.ts      # 工具定义
│   │   └── i18n/         # 国际化文件
│   ├── context/          # React上下文提供者
│   ├── types/            # TypeScript类型定义
│   └── utils/            # 实用函数
├── public/               # 静态资源
└── ...                   # 配置文件

🧪 开发指南

添加新工具的步骤:

1. 在 src/app/tools/[tool_code]/ 创建新目录
2. 在 src/config/tools.ts 中添加工具配置
3. 在 src/config/i18n/tools/[tool_code]/ 中添加翻译

🌍 贡献指南

欢迎贡献代码！请随时提交Pull Request。

1. Fork仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加某项惊人功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开Pull Request

📄 许可证

本项目基于Apache License 2.0许可 - 详情请查看 LICENSE 文件。

🔗 链接

• GitHub仓库: https://github.com/yourusername/jisuxiang