D4 · Implementation · Web-Astro

对外网站实现

xisound-website · Astro 4 · TypeScript · SSG + SSR Hybrid

10

标准模板

Astro 4

当前框架

7

核心组件目录

D4 · Web-Astro · 对外网站实现

摘要

本子项目与 AlgoDepartment/07_web/xisound-website/ 1:1 mirror。 技术栈：Astro 4 · TypeScript · 现有 7 个组件目录（home / layout / product / resource / seo / solution / ui）。 任务 B：M6.1 最小可发布部署方案挂到 D3/deployment-topology/（本子项目的 build.md 与 config.md 将引用该方案）。

骨架版 · 内容待 AI+工程师填充

10 份标准模板将由 实现批 2（Web 栈）完成。

10 份标准模板（实现批 2）

#	文档	内容要点	状态
01	README.md	npm run dev · 开发环境 · 端口	🔴 待建
02	architecture.md	Astro Islands / SSG / SSR 混合策略	🔴 待建
03	api-internal.md	Astro endpoints · /api/* 路由	🔴 待建
04	data-flow.md	表单留资 · 邮件 · 企微 Webhook 数据流	🔴 待建
05	module-list.md	7 组件目录清单 · 每个组件职责	🔴 待建
06	config.md	astro.config.mjs · .env.example · adapter	🔴 待建
07	dependencies.md	Astro 4 · @astrojs/node · Tailwind / UnoCSS	🔴 待建
08	build.md	npm run build · 产物 · 部署方案见 M6.1	🔴 待建
09	debugging.md	SSR hydration · SEO 调试	🔴 待建
10	migration.md	Astro 4→5 升级 · Starlight 子站新建	🔴 待建

相关

• D4 实现级总览
• D3 · Deployment Topology · M6.1 部署方案
• 技术开发文档体系方案 v1.0 · O7=B Astro Starlight 规划

---

版本历史

版本	日期	变更
v1.0-draft	2026-05-06	骨架建立 · 等待实现批 2 + 任务 B M6.1 部署方案

D4 · Web-Astro · v1.0-draft · 2026-05-06 · © Xisound Inc.