Getting Started

Getting-Started

把本仓跑到本地预览，并知道改站该动哪里。

环境

项	要求
Node	≥ 22（部署建议 22.x）
包管理	pnpm 9（preinstall 强制，npm/yarn 会被拦）
克隆	git clone https://github.com/Aafff623/fork-Firefly.git

cd fork-Firefly
pnpm install

若走 npmmirror 个别包 404：

pnpm install --registry https://registry.npmjs.org

常用命令

命令	作用
pnpm dev	本地站点 → http://127.0.0.1:4321/
pnpm build	LQIP → Astro → 字体子集 → Pagefind
pnpm check / pnpm type-check	诊断
pnpm new-post <slug>	新文章脚手架
pnpm new-d / pnpm new-dynamic	新动态

双端口预览（别混）

端口	用途	启动
4321	站点本体（产品）	pnpm dev
8090	README / Release notes 预览壳	仓库根执行 python -m http.server 8090

• 8090：preview-readme.html、preview-release.html
• 二者不是 GitHub Wiki，也不是线上站
• 勿用 file:// 打开预览壳

端口空了（ERR_CONNECTION_REFUSED）多半是进程没起或会话结束后死了：重新在仓库根启动对应命令即可。

改站顺序

1. 先改 src/config/*.ts（配置驱动）
2. 内容进 src/content/（posts / dynamic / spec）
3. 静态资源进 public/（音乐、桌宠、相册等）
4. 非必要不拆 src/layouts/Layout.astro、MainGridLayout.astro

官方文档在哪

工作区本地镜像：Firefly/docs/official/（约 31 篇，gitignore）。
先看差异再抄键： Official-Docs-Map。
上游在线：https://docs-firefly.cuteleaf.cn

下一步：Configuration-Overview · Writing-Posts · Deploy-Vercel