Astrofy：从简历模板到“数字花园”的进化

项目缘起与愿景

本项目最初基于 Astrofy 模板构建，但在后续的迭代中，它已经超越了单纯的“简历”或“个人作品集”范畴。我们将其定位为一个**“数字花园” (Digital Garden)** —— 一个不仅展示成果，更记录思考、沉淀知识并实验前沿 Web 技术的实验室。

核心架构与技术栈

1. 现代化前端基石

• Astro 4+: 利用其极佳的组件孤岛架构和零 JS 默认策略，确保极致的加载速度。
• TailwindCSS & DaisyUI v4: 采用语义化颜色令牌（Color Tokens），支持多套主题（如 lofi, nord, retro 等）的一键切换。
• 双轨色彩与主题隔离系统: 针对普通博客页面与前沿可视化探索页面（如 explorations 页、女性主义 explore 页）实现了完全物理隔离的两套色彩管理体系。主站常规页面去 Monet 动态色覆盖，保护经典内置主题（如 LoFi 黑白极简主义）色彩纯净；可视化页面则利用 <BaseLayout forceTheme="monet"> 或外挂类名独占 Monet 色彩引擎。
• Android Monet 动态色彩引擎: 深度集成原生 Android 动态色彩 (Monet) 机制。通过解耦的、高性能 android-theme.js 脚本在首屏无闪烁 (FOUC) 拦截与加载，实时捕获安卓 WebView 注入色值或 URL 参数（如 monet-primary），利用 OKLCH 算法动态重构整套语义化主题色（--p、--s、--b1等）绑定给 DaisyUI，打造真正个性化的 Material You 视觉风格。
• 纯功能性 Tailwind 绑定与防闪烁配对: 采用 'explore-accent' 与 'explore-accent-content' 前景背景双变量绑定设计，确保在动态重定向（Monet 壁纸同色）时，文字与背景永远处于符合 WCAG 对比度安全规范的易读状态。
• 防布局抖动排版 (Anti-CLS Typography): 在 fonts.css 中声明高阶 @font-face 几何缩放及基线参数微调（size-adjust, ascent-override），彻底消除了网络字体载入与本地 fallback 替换（Font Swap）瞬间的页面排版 CLS 跳动。
• 样式按需动态打包 (Style on Demand): 重塑样式系统物理结构为 6 个高内聚文件，将骨架屏（skeleton.css）和手写卡片（whiteboard.css）解耦为独立微样式，通过组件级 Frontmatter 按需载入，保障了常规博客正文页面的零字节样式污染。
• 组件级颜色令牌优化: 对所有 UI 组件的文本和边框进行了深度的颜色令牌重构，全面迁移至 base-content 变量，确保在不同明暗和高对比度 Monet 场景下的极致可读性与视觉协调。
• Neo-Brutalist 设计: 在局部页面（如邻居页与 AI 工具页）尝试了新野兽主义风格，利用粗线条、高对比度和动态阴影提升视觉冲击力。

2. 内容与代码的深度解耦

为了解决“代码库因文章堆积而臃肿”的问题，我们采用了物理嵌套 + 云端动态组装的架构：

• Obsidian 驱动: 文章存放在独立 Git 仓库，原生适配 Obsidian 管理，支持双链、标签和复杂的 YAML 元数据。
• CI/CD 自动化: 在 Cloudflare 构建时动态拉取最新的内容仓库，实现真正的“内容创作”与“代码维护”并行。

3. 全球化与智能边缘

• 原生 i18n: 深度集成 Astro 的国际化路由，支持中英双语无缝切换，并自动处理 SEO (hreflang) 标签。
• Cloudflare Edge Functions:
  • 物理级拦截: 通过边缘中间件检测地理位置，对特定地区实现内容过滤或智能重定向。
  • 安全加固: 在边缘侧自动注入 HSTS、CSP 等安全响应头，确保站点稳健。

特色功能模块

• Qwen MT 智能翻译器: 采用 React 架构设计，基于阿里云 DashScope API 兼容模式，无缝对接 Qwen MT 翻译大模型系列（如 Qwen MT Plus 和 Qwen MT Flash）。该模块以新野兽派 (Neo-Brutalist) 风格呈现，集成多区域低延迟终结点切换、智能流式输出 (Streaming) 渲染、高级参数控制（温度、Top P、Seed），并独创支持特定领域提示 (Domain Prompting)、术语干预 (Term Intervention) 与翻译记忆 (Translation Memory) 等专业译件调优机制。
• AI 实验场 (AI Playground): 一个多协议通用的 AI 对话调试与实验工具。在统一的 React 面板中原生支持多种主流大模型 API 协议（OpenAI 兼容格式、Google Gemini、Anthropic Claude），具备实时流式输出渲染、自定义 JSON 模型参数、System Prompt 调试、配置本地加密缓存以及移动端自适应布局。
• 全局工具架构与 RetroDesktop 布局: 引入抽象化的 ToolsLayout 及极具复古质感的 RetroDesktop UI 容器，整合移动端全局导航下拉菜单，为未来本地化辅助小工具的无缝扩容打下坚实基础。
• 全文搜索: 集成 Pagefind，提供低延迟、具备背景模糊美感的全站搜索体验。
• 互动评论: 接入 Artalk，深度定制样式以适配 DaisyUI 主题，并具备超时熔断保护机制。
• 历史上的今天: 自研动态组件，根据当前语言请求不同的 API 源，并完美兼容 Astro 的 View Transitions 视图过渡。
• 画廊与邻居: 取代了传统的“服务”与“项目”列表，转而以更具艺术感和社交属性的方式展示摄影作品与友链。

维护原则

我们坚持数据与视图分离。所有非正文性质的数据（如简历经历、技能点）均提取至 src/data/ 下的 TypeScript 对象中。如果你对本项目的实现细节感兴趣，可以参考根目录下的 PROJECT_MANUAL.md。

“种下一棵树最好的时间是十年前，其次是现在。”