项目进度追踪 / Project Progress Tracker

每完成一个阶段，在状态列填入 ✅、记录完成日期，并同步更新对应的 docs/phases/phase-*.md 学习文档以及中英文项目文档。 When a phase is complete, mark ✅, record the completion date, and update the matching docs/phases/phase-*.md learning document plus the bilingual project documentation.

图例 含义
⬜ 未开始 / Not started
🔄 进行中 / In progress
✅ 已完成 / Completed

阶段进度 / Phase Progress

# 阶段名称 / Phase Name 状态 完成日期 学习文档
0 脚手架与配置基线 / Scaffolding & Config Baseline ✅ 2026-03-26 查看 / View
1 内容层与数据模型 / Content Layer & Data Model ✅ 2026-03-27 查看 / View
2 应用骨架与核心页面 / Application Shell & Core Pages ✅ 2026-03-27 查看 / View
3 SEO 系统 / SEO System ✅ 2026-03-27 查看 / View
4 图片分发系统 / Image Delivery System ✅ 2026-03-27 查看 / View
5 UI 组件库 / UI Component Library ✅ 2026-03-27 查看 / View
6 中文排版系统 / Chinese Typography System ✅ 2026-03-27 查看 / View
7 分析系统 / Analytics System ✅ 2026-03-27 查看 / View
8 搜索功能 / Search ✅ 2026-03-27 查看 / View
9 AI 编辑工具链 / AI Editorial Tooling ✅ 2026-03-27 查看 / View
10 部署流水线 / Deployment Pipeline ✅ 2026-03-27 查看 / View
11 可观测与运维 / Observability & Operations ✅ 2026-03-27 查看 / View

Phase 0 — 脚手架与配置基线 / Scaffolding & Config Baseline

交付物清单 / Deliverable Checklist

  • package.json — 依赖声明与 npm 脚本
  • tsconfig.json — TypeScript 严格模式配置
  • next.config.ts — Next.js 应用配置
  • open-next.config.ts — OpenNext Cloudflare 适配器配置
  • wrangler.jsonc — Cloudflare Worker 绑定与部署元数据
  • .gitignore — 排除构建产物与密钥文件
  • .env.example — 环境变量占位模板
  • eslint.config.mjs — 代码质量规则
  • .prettierrc — 代码格式风格
  • postcss.config.mjs — Tailwind v4 PostCSS 集成
  • app/layout.tsx — 根布局占位（Phase 2 完善）
  • app/page.tsx — 首页占位（Phase 2 完善）
  • app/globals.css — 全局样式占位（Phase 2/5 完善）
  • 目录骨架 — 所有后续阶段所需的文件夹结构

Phase 1 — 内容层与数据模型 / Content Layer & Data Model

交付物清单 / Deliverable Checklist

  • lib/content/types.ts
  • lib/content/frontmatter.ts
  • lib/content/processor.ts
  • lib/content/posts.ts
  • lib/content/pages.ts
  • lib/content/taxonomy.ts
  • lib/content/cover-resolver.ts
  • lib/content/index-builder.ts
  • lib/content/index.ts
  • content/posts/hello-world.mdx (示例内容)
  • content/pages/about.mdx
  • content/taxonomy/tags.json
  • content/.generated/ 旁路元数据目录

Phase 2 — 应用骨架与核心页面 / Application Shell & Core Pages

交付物清单 / Deliverable Checklist

  • app/layout.tsx (完整版)
  • app/globals.css (完整版)
  • app/(site)/layout.tsx
  • app/(site)/page.tsx
  • app/(site)/posts/page.tsx
  • app/(site)/posts/[slug]/page.tsx
  • app/(site)/tags/[tag]/page.tsx
  • app/(site)/categories/[category]/page.tsx
  • app/(site)/archives/page.tsx
  • app/(site)/about/page.tsx
  • app/(site)/projects/page.tsx
  • app/api/health/route.ts
  • app/sitemap.ts
  • app/robots.ts
  • app/rss.xml/route.ts
  • app/not-found.tsx
  • app/error.tsx
  • app/loading.tsx
  • components/site/SiteLayout.tsx
  • components/site/PostList.tsx
  • components/site/RichContent.tsx
  • lib/site.ts
  • lib/format.ts
  • lib/content/runtime.ts
  • scripts/content/build-runtime-data.ts

Phase 3 — SEO 系统 / SEO System

交付物清单 / Deliverable Checklist

  • lib/seo/constants.ts
  • lib/seo/metadata.ts
  • lib/seo/structured-data.ts
  • lib/seo/og.ts
  • components/seo/StructuredData.tsx
  • public/og-default.svg
  • 文章详情页 generateMetadata 接入统一 builder
  • 首页、列表页、归档页、标签页、分类页、About、Projects 接入 canonical + OG + description
  • 文章页输出 BlogPosting + BreadcrumbList JSON-LD
  • 根布局输出 Person JSON-LD，首页输出 WebSite JSON-LD

Phase 4 — 图片分发系统 / Image Delivery System

交付物清单 / Deliverable Checklist

  • lib/cloudflare/images.ts
  • lib/cloudflare/loader.ts
  • components/ui/ArticleImage.tsx
  • components/ui/CoverImage.tsx
  • app/image/[variant]/[token]/route.ts
  • public/images/default-cover.svg
  • public/images/hello-world-cover.svg
  • public/images/hello-world-inline.svg
  • 文章列表页使用 thumb-md 变体
  • 文章详情页使用 cover-lg，正文图片重写为 cover-md
  • Open Graph / Twitter / BlogPosting 使用 og-cover
  • 原始源图 URL 不出现在公开渲染的 HTML 中
  • cover-resolver.ts 三级回退单元测试

Phase 5 — UI 组件库 / UI Component Library

交付物清单 / Deliverable Checklist

  • components/article/ArticleCard.tsx
  • components/article/ArticleHeader.tsx
  • components/article/ArticleContent.tsx
  • components/article/ArticleToc.tsx
  • components/article/RelatedPosts.tsx
  • components/article/CopyCodeButton.tsx
  • components/layout/Header.tsx
  • components/layout/Footer.tsx
  • components/layout/Pagination.tsx
  • components/taxonomy/TagList.tsx
  • components/taxonomy/CategoryBadge.tsx
  • components/ui/ThemeToggle.tsx
  • components/ui/SearchTrigger.tsx

Phase 6 — 中文排版系统 / Chinese Typography System

交付物清单 / Deliverable Checklist

  • lib/typography/heti-client.ts
  • lib/typography/excluded-selectors.ts
  • lib/typography/policy.ts
  • components/article/ArticleTypography.tsx
  • styles/heti-overrides.css
  • config/typography/chinese-typography.md

Phase 7 — 分析系统 / Analytics System

交付物清单 / Deliverable Checklist

  • lib/analytics/event-registry.ts
  • lib/analytics/providers.ts
  • lib/analytics/track.ts
  • lib/analytics/route-change-debug.tsx
  • app/layout.tsx 接入 Umami + GA4

Phase 8 — 搜索功能 / Search

交付物清单 / Deliverable Checklist

  • scripts/content/build-search-index.ts
  • lib/search/types.ts
  • lib/search/client.ts
  • components/search/SearchModal.tsx
  • components/search/SearchResults.tsx
  • package.json build 脚本更新

Phase 9 — AI 编辑工具链 / AI Editorial Tooling

交付物清单 / Deliverable Checklist

  • scripts/ai/shared/types.ts
  • scripts/ai/shared/client.ts
  • scripts/ai/shared/schema-validator.ts
  • scripts/ai/shared/file-resolver.ts
  • scripts/ai/shared/reporter.ts
  • scripts/ai/proofread.ts
  • scripts/ai/summarize.ts
  • scripts/ai/seo-suggest.ts
  • scripts/ai/typography-review.ts
  • prompts/proofread.md
  • prompts/summarize.md
  • prompts/seo-suggest.md
  • prompts/typography-review.md

Phase 10 — 部署流水线 / Deployment Pipeline

交付物清单 / Deliverable Checklist

  • .github/workflows/deploy.yml
  • .github/workflows/ai-content-check.yml

Phase 11 — 可观测与运维 / Observability & Operations

交付物清单 / Deliverable Checklist

  • scripts/ci/build-report.ts
  • config/ops/monitoring.md
  • config/ops/runbook.md