GameInsight

从游戏行业视角拆解经典作品的研究笔记。技术栈:Astro + Starlight,托管于 GitHub Pages。

本地开发

npm install
npm run dev      # http://localhost:4321
npm run build    # 产物输出到 dist/

目录结构

src/content/docs/
├─ index.mdx              # 首页
├─ guide/how-to-read.md   # 阅读指南
├─ list/index.md          # 游戏总览·经典清单
├─ games/zzz.md           # 深度分析(每款游戏一篇)
└─ method/                # 方法论:分析模板 + 资料口径说明

部署

推送到 main 分支后由 .github/workflows/deploy.yml 自动构建部署

新增一篇深度分析

1. 在 src/content/docs/games/ 下新建 <slug>.md(参考 method/template);
2. 在 astro.config.mjs 的 sidebar 深度分析 分组中按优先级插入条目;
3. 更新 list/index.md 中对应游戏的状态标记(🔲 → ✅)。

文档内相对链接规则(重要)

页面 URL 是目录式的(如 /games/dark-souls/),相对链接从该路径解析:

链接目标	在 games/*.md 里的写法
同级游戏页	../<slug>/(如 ../sekiro/)
清单页	../../list/
方法论页	../../method/template/

写成 ./<slug>/ 会解析成 /games/<当前页>/<slug>/ 导致 404; list/index.md 与 guide/*.md 中跨目录链接用一级相对路径(如 ../games/genshin/)即可。