游戏攻略站

一个用 VitePress 搭建、托管在 Vercel 的个人游戏攻略存档站。用 Markdown 写攻略，写完自动生成网页，方便自己查阅、朋友搜索。

---

一、目录结构

game-guide/
├── docs/                        # 所有内容都在这里（VitePress 的根目录）
│   ├── .vitepress/
│   │   └── config.mts           # 站点配置：导航、搜索、SEO
│   ├── index.md                 # 首页
│   ├── about.md                 # 关于页
│   ├── guide-template.md        # 攻略模板（复制使用，勿发布）
│   ├── public/                  # 静态资源（图片等），建 images/ 放图
│   └── games/                   # 游戏内容区
│       ├── index.md             # 游戏总列表
│       └── demo-game/           # 每款游戏一个文件夹（示例）
│           ├── index.md         # 该游戏主页
│           └── boss-guide.md    # 单篇攻略
├── package.json
└── .gitignore

核心约定：每款游戏一个文件夹，攻略是文件夹里的 .md 文件；图片统一放 docs/public/images/，文中用 /images/xxx.png 引用。

---

二、本地预览

cd game-guide
npm install          # 首次安装依赖
npm run dev          # 启动本地预览，浏览器打开提示的地址

---

三、写一篇新攻略

1. 进入对应游戏的文件夹（没有就先建一个）
2. 复制 docs/guide-template.md 改名为 标题.md
3. 填好顶部的 title 和 description（description 会被搜索引擎抓取）
4. 按模板写正文，配图放 docs/public/images/
5. 回 docs/games/index.md 把新攻略加进对应游戏的列表

---

四、部署到 Vercel（让朋友能访问）

1. 把项目推到一个 GitHub 仓库
2. 打开 vercel.com，用 GitHub 登录 → Add New Project → 选这个仓库
3. 框架会自动识别为 VitePress（Build Command 默认 npm run build，Output 目录填 docs/.vitepress/dist）
4. 点 Deploy，完成后会得到一个免费网址：https://xxx.vercel.app
5. 之后每次 git push，Vercel 自动重新部署，攻略即时上线

---

五、让朋友"搜得到"（SEO / 收录）

部署上线只是第一步，要让搜索引擎收录并搜得到，需要下面几步。

1. 确认可访问：先拿到 xxx.vercel.app 网址，直接发给朋友即可打开（无需等收录）
2. 生成站点地图 sitemap.xml：

   npm i -D vitepress-plugin-sitemap

   然后在 config.mts 里取消 sitemap 注释，填入真实域名
3. 提交搜索引擎站长平台：
   • Google Search Console / Bing Webmaster 添加你的网址，验证后提交 sitemap
4. 耐心等待：新站收录通常要几天到几周，不是即时；收录后朋友搜"站名 + 攻略关键词"就能找到
5. 想更易记：可自购一个短域名绑定到 Vercel（game.我的域名.com）

---

六、待办 / 下一步

• 把 config.mts 里的站名、description 改成你自己的
• 用真实游戏替换 demo-game 示例
• 补充你自己的游戏清单和攻略