快速开始

本文档基于仓库当前状态（2026-03）编写，适用于现在可运行的项目结构。

当前可运行范围

• 主应用：gocode-apps/site-astro
• 内容源：gocode-context/wiki/**/*.md
• 搜索：Pagefind（构建后生成）
• 评论：Waline（可选，需配置 PUBLIC_WALINE_SERVER_URL）

前置要求

• Node.js 20.x（推荐）
• pnpm 9.x
• Git

1) 安装依赖

git clone <your-repo-url>
cd gocode-monorepo
pnpm install

2) 启动本地开发

pnpm --filter @gocode/site-astro dev

默认地址：http://localhost:4321

3) 开发环境启用搜索（首次或文章更新后）

./scripts/update-search-index.sh

该脚本会重新构建站点并把 dist/pagefind 同步到 public/pagefind，避免开发时搜索 404。

4) 发布前检查

# 类型与静态检查（astro check + eslint）
pnpm --filter @gocode/site-astro check

# 生产构建（包含 Pagefind 索引）
pnpm --filter @gocode/site-astro build

# 本地预览构建结果
pnpm --filter @gocode/site-astro preview

当前目录说明

gocode-monorepo/
├── gocode-apps/site-astro/   # 当前主应用
├── gocode-context/wiki/      # 唯一生效内容源
├── packages/                 # 共享包
├── gocode-services/          # 占位目录（未落地服务）
├── gocode-infra/             # 占位目录（未落地编排）
└── gocode-projects/          # 占位目录

下一步

• 架构说明：/wiki/architecture
• 开发工作流：/wiki/development
• 生产部署指南：/wiki/aliyun-ecs-portal-wiki-deployment
• 发布前最终清单：仓库根目录 PRODUCTION-RELEASE-CHECKLIST.md