www.astercosm.com

AsterCosmos 的组织门面落地页 —— www.astercosm.com。 营销与品牌门面，不是产品仓库；旗舰产品站在 AsterDriveLanding。

开发

bun install
bun run dev              # 本地开发
bun run build            # 构建到 dist/
bun run check            # biome check + astro check（必须全绿才算完）

页面结构

• / — 枢纽：品牌主张 + 精选系统（AsterDrive）+ 子站入口卡
• /projects/ — 项目索引（策展视图，完整列表在 GitHub org）
• /philosophy/ — 工程文化：系统观、基础设施、工作原则
• /archive/ — AsterCosmos 与 ESAP 的对照关系与站点入口

均为双语：/ 英文（默认）+ /zh/ 中文前缀。

工程要点

• Astro 静态站，无 JS 框架运行时；首屏交互（主题/语言切换、滚动入场）全部是 vanilla script。
• 双语：/ 英文（默认）+ /zh/ 中文，文案唯一事实源 src/i18n/ui.ts。
• 视觉 token 唯一事实源 src/styles/tokens.css（D9 骨架 + ESAP 三色 accent，色值不发明，见文件头注释）。
• 图片使用原生 <img>，并在 astro.config.mts 明确配置 Astro 官方 no-op image service，避免启用 sharp/libvips 图片处理服务；未使用的 sharp 入口也锁定到 MIT 包，防止安装器把平台二进制拉回来。ESAP 截图脚本需要本机安装 ImageMagick（magick）。
• 旧版品牌 PNG 生成脚本保留在 scripts/generate-assets.mts.bak，仅作备份，不参与安装、检查或构建。
• 设计与内容不变量见 AGENTS.md。

素材同步约定

以下素材从 AsterDriveLanding 仓库复制，更新时手工同步并在 commit message 注明对应 revision：

本站路径	来源
src/assets/scenes/hero-*-*.webp	AsterDriveLanding apps/web/src/assets/scenes/（由其截图管线 capture-scenes.mts 产出，AsterDrive 前端 UI 更新后需重跑并重新复制）
src/assets/scenes/esap-home-dark-*.webp	本仓库 scripts/capture-esap.mts 从线上 weare.esaps.net 实拍；WeAreESAP 前端更新后重跑 bun run capture:esap，并在 commit message 注明对方 revision
public/og.png / public/apple-touch-icon.png	已入库的静态品牌素材；改版时直接替换产物并保留尺寸/品牌 token 约束

部署

main 分支推送后由 GitHub Actions 构建并发布到 GitHub Pages（www.astercosm.com，CNAME 在 public/CNAME）。不手动编辑生成产物；DNS 与 Pages 设置由仓库所有者手工管理。

License

Code: Apache-2.0（见 LICENSE）。站点内容 CC-BY 4.0；品牌标识保留所有权利。