CyberTools 是一个面向开发者和日常办公场景的在线工具箱，聚合 JSON 格式化、Base64 编解码、时间戳转换、随机密码生成、文本清理、图片处理和 PDF 辅助工具等高频能力。项目采用前端优先的实现方式，尽量让敏感操作在浏览器本地完成，减少数据上传带来的隐私风险。
- 使用 React 19、TypeScript 和 Vite 构建单页应用，页面切换轻量快速。
- 工具模块按路由懒加载，降低首屏体积，方便持续扩展新工具。
- 内置中英文文案、用户登录弹窗、反馈入口、仪表盘和内容管理页面。
- 图片、PDF、压缩、裁剪等功能优先在浏览器端完成，适合公开展示隐私友好的工具设计。
- 配套 Docker、Nginx 和 GitHub Actions 部署配置，便于前端静态化发布。
| 分类 | 技术 |
|---|---|
| 前端框架 | React、TypeScript、Vite、React Router |
| 界面与交互 | Tailwind CSS、Framer Motion、Lucide Icons |
| 状态与请求 | Zustand、Axios |
| 文件处理 | pdf-lib、pdfjs-dist、cropperjs、browser-image-compression、JSZip |
| 构建部署 | Docker、Nginx、GitHub Actions |
npm install
npm run dev生产构建：
npm run build
npm run preview只有需要接入第三方能力时才需要创建本地环境文件，例如 .env.local。真实密钥不要提交到 Git。
GEMINI_API_KEY=your-gemini-api-key
VITE_API_BASE_URL=http://localhost:8080/api后端服务单独维护在 Bersulang/cybertool，负责用户、反馈、路线图、更新日志和对象存储等接口。
公开仓库只保留源码、占位配置和 GitHub Secrets 引用。生产服务器地址、API Key、SSH Key、对象存储 AK/SK 等敏感信息应放在本地环境文件、部署平台密钥或 CI/CD Secret Store 中。