Skip to content

项目概览 ​

Emphant 工具箱是一个纯前端的在线工具集合:88 个工具,全部在浏览器本地运行,没有账号、没有后端接口、没有上传。同一套源码产出三个站点:

tools-site/
├── pc-web/        → emphant.com        电脑 / 平板版(多页静态站)
├── mobile-web/    → emphant.com/m/     手机版(单页 + hash 路由)
├── docs-site/     → docs.emphant.com   项目文档(VitePress)
├── blog-site/     → blog.emphant.com   技术随笔(VitePress + 博客主题)
└── deploy.sh      → 一条命令构建并发布到 nginx

三个站点各自解决什么问题 ​

站点解决的问题不该放什么
工具站用户「现在就要处理一段文本 / 一张图」长篇教程、版本说明
文档站接手仓库的人要知道「怎么跑、怎么发、为什么这样设计」面向用户的工具使用教程(那在工具页里)
随笔站记录技术判断、踩坑过程、方案对比变更日志(放文档的更新日志页)

三者互相链接,但内容边界清晰:工具页负责转化,文档负责维护,随笔负责解释「为什么」。

技术选型 ​

层选择理由
前端框架Vue 3.5工具组件需要响应式表单与实时计算,Vue 的模板语法写这类组件最短
构建Vite 8多页构建、按需 chunk、开发态友好 URL 映射都够用
手机版路由hash 路由放在 /m/ 子目录下,不需要服务端 rewrite 配合,部署零成本
文档 / 博客VitePress 1.6Markdown 即内容、构建即静态、默认主题够用,博客用自定义主题扩展
托管nginx 1.28(Ubuntu)一台 2C4G 足够,配置文件全部在仓库里可追溯
访问统计GoAccess 1.9直接解析 nginx 日志,生成静态面板,不需要额外服务
HTTPSLet's Encrypt + certbot免费、可自动续期,一个证书覆盖全部子域

仓库之外依赖什么 ​

  • 一台服务器:121.43.28.40,nginx 托管全部站点。
  • 三个域名:emphant.com、docs.emphant.com、blog.emphant.com,都解析到同一台机器。
  • 两个本地环境:Node 22 + npm 10(构建),Python 3 + paramiko(发布脚本)。
  • 彩票数据源:中彩网与体彩官方接口,构建期抓取后写成静态 JSON,详见 工具清单。

下一步 ​

文档随仓库一起更新,站点内容全部在浏览器本地运行。