Wynn's Save Point

Wynn 的个人网站：一个可以认识 Wynn、看看他的作品、读文章，也可以停留片刻的夏日桌面。文章是其中一个板块，首页以个人身份和各板块入口组织体验。

当前视觉方向是夏日晴空绿野、蓝调夏夜、macOS 风格的液态磨砂玻璃和彩色立体 Dock 图标。保留站名、黑猫头像和真实内容。

当前定位与文档入口

• 产品与设计说明：当前产品定位、视觉方向与功能边界；涉及页面设计时先读这份。
• 协作指引：开发工作树、文档使用和验证要求。
• 素材说明：当前图片和图标的来源。
• 验收记录：指定版本的历史验证结果，不代表最新部署状态。
• 历史资料：早期草稿，已失效的设计描述不作为当前需求。

实现使用 Astro、MDX、Pagefind、Giscus 和 Cloudflare Workers Static Assets。/blog/ 是保留的文章地址，不定义整个网站的定位。下面的命令和配置说明服务于当前实现。

项目内容

项目采用摘要卡片与独立详情页，内容位于 src/content/projects/。当前顺序为 Rootly → MayDolist → NeoCode，地址分别为 /projects/rootly/、/projects/maydolist/、/projects/neocode/。

项目 frontmatter 支持可选的 order（非负整数，小值优先）、role（个人角色）、highlight（代表成果）。未设置 order 的项目排在指定顺序之后；同序或均未设置时按日期倒序，再按内容 ID 排序。列表与相邻项目导航共用该规则；草稿不生成公开页面。CMS 已提供相应字段，文章排序不变。

正文按「产品介绍 → 我负责的内容 → 最终成果 → 相关链接」组织，区分团队能力与个人贡献；持续开发的项目注明成果核验日期。项目日期表示本页发布日，不代表项目开始时间。只提供真实可公开的链接与图片，不使用无依据的指标。素材来源见 ASSETS。

Commands

Use pnpm 10.11.1, pinned in package.json to match the Cloudflare build image. The workspace explicitly includes the root package and uses pnpm 10's onlyBuiltDependencies setting for the existing native dependency setup scripts.

pnpm install
pnpm dev
pnpm check
pnpm build
pnpm test
pnpm preview
pnpm worker:dev
pnpm deploy

Appearance and reading

The homepage is a summer desktop: day/night meadow wallpaper, frosted glass widgets, the original black-cat avatar, and a four-icon Dock. Public pages share new system typography and readable opaque glass surfaces. The default theme follows the OS; explicit choices persist under the existing theme key. Mobile layouts retain a compact Dock and show local date/time without location requests. Reduced-motion and reduced-transparency preferences are respected.

Astro ClientRouter preserves a single audio element across internal navigation. Page-scoped listeners, search instances and observers are released before swaps and initialized after navigation. Existing content URLs, CMS fields, RSS, Pagefind indexing and Giscus pathname mappings are retained. RSS and the CMS use full navigation. No frontend framework was added.

Configure music

Edit src/data/music.ts. Each track has id, title, artist, src and an optional cover. Use unique stable IDs, local /music/... assets under public/, or stable HTTPS audio URLs. Remote audio hosts must allow direct playback; HTTP range requests are recommended for reliable seeking. Cover images are optional and fall back to a music icon on failure.

The production playlist is intentionally empty and displays “歌单准备中”. Playback starts only after a visitor presses play. Internal navigation preserves playback and volume; a refresh does not autoplay. Single-track playlists disable track switching; multi-track playlists wrap. Failed audio can be retried.

Validate

Run pnpm check, pnpm build, then pnpm test (generated-link tests read dist). Use pnpm preview to include the generated Pagefind search index. Tests cover theme preferences, filters, links, player state, race conditions and lifecycle cleanup. Test-only real audio is available with:

python tests/serve_audio_fixture.py --port 4322

This loopback-only server serves the existing build and injects test tracks into responses, without editing source or dist. Its third track fails once, then succeeds on retry; restarting the server resets this scenario. The synthesized audio is not part of the public website or production playlist.

See design/summer-reference.png for the visual direction, design/ASSETS.md for image provenance and design/QA.md for browser validation.

Deployment

The production site is configured for:

https://wynn.myblog-site.workers.dev

Deployment is handled by Cloudflare Workers Git integration. Connect the wynxing/wynxing.github.io repository in Cloudflare and use these build settings:

Root directory: /
Install command: pnpm install --frozen-lockfile
Build command: pnpm build
Deploy command: pnpm exec wrangler deploy

The deploy command expects dist/ to already exist. pnpm build runs Astro and Pagefind, producing both the static site and search index before Wrangler reads wrangler.jsonc.

Local deployment checks:

pnpm check
pnpm build
pnpm exec wrangler deploy --dry-run

Cloudflare Web Analytics uses the public site token configured in src/consts.ts.

Custom domain

The public URL is still the Workers subdomain. To attach a real domain:

1. Add the hostname in Cloudflare (Workers & Pages → wynn → Settings → Domains & Routes).
2. Point the DNS record to the Worker, or use a proxied CNAME.
3. Update site in astro.config.mjs and SITE_URL in src/consts.ts to the new origin, then rebuild.

Keep those two values in sync so canonical URLs, Open Graph tags, sitemap, and RSS stay on the same host.