这次网站调整的目标不是再做一个首页,而是让不同内容回到合适的位置。主站继续是暖色、浅色的单屏个人入口;AI绿洲只承担工具与资源导航;博客使用独立 Astro 项目保存长文;项目详情则围绕可查看的代码、截图和设计证据展开。它们互相链接,但不共享发布节奏,也不依靠数据库维持表面上的统一。

先按读者任务划分,而不是按技术栈划分

访问主页的人通常只想快速知道“这里有什么”和“下一步去哪里”。因此主页保留品牌、一句介绍、项目入口和公开联系信息,不需要把每篇文章的开头都塞进去。单屏不是审美限制,而是对读者任务的回应:尽快给出可靠出口。

项目详情回答的是“这个东西怎样做、做到什么程度”。它应该有针对性的说明和证据,而不是让所有项目共用一段空泛介绍。能公开代码就链接代码,能展示界面就准备截图,设计决策则回到真实约束。没有正式采用或没有验证的部分,直接标明。

资源区回答“有哪些工具值得以后再查”。AI绿洲按场景整理工具和文档,提供短说明与外部链接即可。它不承担长文论证,也不为了显得活跃而自动采集全网内容。博客则回答“为什么这样取舍”,允许一篇复盘占据几千字,让读者离开列表后进入完整上下文。

博客独立,是为了容纳不同的更新频率

长文和主页的维护方式不同。一篇文章可能多次修改,主页入口却应该相对稳定;资源链接需要定期检查,项目证据只在项目有实质变化时更新。如果所有内容都挤在同一个应用里,任何小改动都可能要求理解整套页面和依赖。

独立 Astro 博客把写作流程收敛为 Markdown。Content Collections 检查标题、日期、分类和摘要,静态构建生成文章、分类、RSS 与 sitemap。新增一篇中文文章不需要修改路由代码,英文文件名则作为稳定 slug,避免改标题时破坏外部链接。

这种分离也减少无关依赖。博客不需要主站的完整交互逻辑,主站也不需要理解 Markdown 渲染。每个项目可以独立安装、检查、构建和回滚,问题更容易定位。这里刻意不引入 monorepo 或共享组件包,因为目前共享构建链带来的维护成本高于复制少量基础样式。

AI绿洲是资源区,不是另一本博客

把资源导航混进博客,常见结果是列表越来越长,真正需要解释的内容反而难找。AI绿洲因此只保留工具名称、用途、适用场景和原始链接。需要详细记录的实验过程,可以在博客写成一篇文章,再从资源说明链接过去。

两者之间是“索引”和“论证”的关系。资源区告诉读者有什么,博客告诉读者某次使用怎样设计、遇到什么限制。这样,资源更新不必制造一篇没有实质内容的日记,博客也不必承担持续维护大量外部链接的责任。

资源链接只接受 HTTP 或 HTTPS,并在添加时检查名称、用途和原地址。这个规则看似细小,却能防止来源不明的链接协议和复制错误进入公开页面。AI 可以协助整理候选,但最终展示的链接仍要人工审核。

主站保留人工选择,不做自动同步

主站的项目入口采用人工维护,而不是每次博客构建都自动重写首页。原因很直接:是否值得把一个项目放到首屏,是一次编辑判断,不是文件时间戳能够决定的事情。

同样,博客首页只展示自己的最新与精选文章,分类只显示非空项目;主站以后需要订阅入口时,可以链接博客的 /rss.xml,但不需要为了这一入口引入跨站数据库。站点之间使用公开 URL 连接,边界简单,任何一边暂时维护都不会拖住另一边。

代价是少量信息需要在不同地方检查,例如站点名称、主导航和返回地址。对此更好的办法是限制需要重复的内容,并用环境变量配置主站与博客地址,而不是建立一个复杂的同步系统。当前博客正式地址默认是 https://blog.aioasis.top,主页默认是 https://aioasis.top,本地联调可以覆盖。

视觉协调不等于组件必须共用

博客延续主站的暖色和浅色气质,但阅读页面需要更窄的正文、更清楚的长文层级和更少的装饰。暗色模式、减少动态效果、键盘焦点和移动端代码滚动,都属于阅读功能,而不是另做一套视觉品牌。

如果强行共用主站组件,博客会被迫接受主页的布局假设,主站也会背上文章排版和代码样式的依赖。当前阶段各自维护 CSS 反而更容易检查。真正需要一致的是返回路径、链接可辨识度和基本语气,而不是每一个圆角和间距都来自同一个包。

独立也不代表可以任意分叉。每次改动仍要检查 360px 宽度、暗色对比度、文章目录、代码复制和上下篇导航。把这些验收写进项目流程,比抽象地追求“设计系统统一”更实际。

低维护的核心,是一条普通人能重复的流程

写作流程应当简单到可以交给 AI 协助:新增一个英文文件名的 Markdown,填写固定 frontmatter,让 AI 根据资料写正文,再由人审核事实、语气和敏感信息。预览确认后运行内容测试、类型检查和静态构建,失败就修正,不绕过检查。

README 需要把安装、预览、构建和未来发布分别写清楚。正式构建默认排除草稿;预览可以显示草稿,但必须带 noindex,避免临时地址被搜索引擎收录。RSS、sitemap、canonical 和默认 OG 图片由构建统一生成,作者不手工维护一批重复 HTML。

发布则是另一道边界。本地构建成功不等于已经上线,只有确认托管平台、环境变量、域名和回滚方式之后,才进入发布步骤。把这几个阶段分开,能避免“本地看起来完成”被误写成“线上已经可用”。

分开之后,仍然要定期回收复杂度

多项目并非零成本。依赖要分别更新,链接要跨站检查,构建产物也要分别验收。因此每隔一段时间应回看:是否出现重复维护的大段逻辑,是否有项目入口失效,是否某个分类长期为空,是否有资源说明已经过时。

如果未来确实形成稳定共享需求,可以再评估共享配置或组件,而不是提前搭建。现在的目标是让每块内容都能独立理解和独立恢复:主页负责入口,项目负责证据,AI绿洲负责资源,博客负责过程。

这种划分不是一次情绪化的整理,而是一套维护策略。它用明确边界换来更少的联动修改,也让每次写作、设计或开发都能停在合适的位置,不再要求一个页面承担所有表达任务。