Skip to content

目录结构 ​

tools-site/
├── pc-web/                     # 电脑 / 平板版(emphant.com)
│   ├── scripts/
│   │   ├── gen-pages.mjs       # 由工具数据生成所有静态 HTML
│   │   ├── fetch-lottery.mjs   # 构建期抓取彩票开奖数据
│   │   └── postbuild.mjs       # 把 dist/pages 提到根目录
│   ├── src/
│   │   ├── data/               # 工具定义、栏目文案、教育内容、广告位
│   │   ├── tools/              # 88 个工具组件
│   │   ├── ui/                 # 通用 UI 组件
│   │   ├── utils/              # 纯函数算法(彩票、日期、编码等)
│   │   └── styles/app.css      # 设计令牌与全站样式
│   ├── pages/                  # gen-pages 生成的 HTML 源文件(构建输入)
│   └── public/                 # 图标、og 封面、data/lottery.json
│
├── mobile-web/                 # 手机版(emphant.com/m/)
│   ├── src/
│   │   ├── views/              # 页面级组件
│   │   ├── tools/              # 为手机重写的工具组件
│   │   ├── shell/              # 底部导航、弹层等外壳
│   │   ├── router.js           # hash 路由
│   │   └── styles/pc-compat.css# 把 pc 的类名映射到手机版设计令牌
│   └── vite.config.js          # @pc 别名 + dedupe vue
│
├── docs-site/                  # 项目文档(docs.emphant.com)
│   ├── .vitepress/config.mts   # 导航、侧边栏、搜索、sitemap
│   └── guide/ project/ ops/ reference/
│
├── blog-site/                  # 技术随笔(blog.emphant.com)
│   ├── .vitepress/config.mts   # 博客配置 + 文章索引虚拟模块 + RSS
│   ├── .vitepress/theme/       # 自定义博客主题(文章列表、标签、meta)
│   └── posts/                  # 一篇随笔一个 .md
│
├── scripts/deploy.py           # 发布实现(被 deploy.sh 调用)
├── deploy.sh                   # 统一发布入口
├── README.md                   # 主站运维说明
└── 工具清单对照.md              # 工具与栏目的人工核对表

几个容易踩的目录约定 ​

  • pc-web/pages/ 是生成物。不要手改里面的 HTML,下次 gen-pages.mjs 会覆盖;改文案请改 src/data/。
  • mobile-web 不能单独拷走。它通过 @pc → ../pc-web/src 复用代码,脱离仓库会解析不到别名。
  • dist/ 不进 Git。四个站点的构建产物都由发布脚本在服务器上落盘。
  • docs-site 与 blog-site 互不依赖。可以只发其中一个,deploy.sh docs / deploy.sh blog 单独发布。

内容放在哪 ​

想改什么去哪里
工具的名称、描述、FAQpc-web/src/data/tools/<栏目>.js
栏目介绍与 SEO 文案pc-web/src/data/categories.js
教育栏目文章pc-web/src/data/edu/
测算栏目题目与计分pc-web/src/data/assess/
广告位pc-web/src/data/ads.js
文档页面docs-site/<分组>/*.md + config.mts 侧边栏
随笔blog-site/posts/*.md

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