Atmoos

关于本站

站点定位

Atmoos 是一个个人记录站。

它同时承担两个用途：

记录阶段性的想法和文章。
整理可以长期复用的知识笔记。

这里不追求每天更新，也不追求把所有内容都写成完整文章。

内容边界

适合放在这里的内容：

个人项目记录。
技术和工具笔记。
阶段复盘。
对某个问题的长期观察。

不适合放在这里的内容：

只适合临时保存的碎片。
没有整理价值的资料堆放。
无法公开的私人信息。

下一步

接下来会继续完善笔记库结构，并评估网页端写作和上传入口。

主题定制

已定制内容

目前已经调整：

站点名称和描述。
首页文案和信息结构。
顶部导航。
头像。
关于页和项目页。
主要列表页中文文案。

修改入口

常用修改位置：

src/site.config.ts：站点配置。
src/pages/index.astro：首页。
src/pages/about/index.astro：关于页。
src/pages/projects/index.astro：项目页。
src/content：文章和笔记。

定制原则

这个站点应该更像个人工作台，而不是主题展示页。

后续新增视觉元素时，优先考虑是否帮助阅读、查找和整理内容。

常见问题

为什么还保留杂想？

不是所有记录都值得立刻整理成知识库。

杂想适合承接还没成型的想法，之后再挑选其中有价值的内容沉淀为笔记。

为什么不用纯时间线？

时间线适合回看最近发生了什么，但不适合查找长期知识。

所以本站同时保留时间线和树形目录。

能不能网页端直接上传文章？

可以，但静态站本身不能直接写入仓库。

要实现网页端上传，需要接入 CMS、GitHub API、数据库或后端服务。这个功能应该单独设计权限、草稿、发布和回滚流程。

为什么先中文化而不是先做后台？

内容结构是后台功能的前提。

先把站点定位、目录和文案理顺，再做上传入口，后续实现会更稳。

性能优化

当前关注点

站点是静态内容站，性能压力不大。

优先关注：

构建是否稳定。
图片是否过大。
首页是否过重。
搜索索引是否影响构建时间。

图片

封面图和头像是最容易变大的资源。

新增图片前应该先压缩，避免把原始大图直接提交进仓库。

搜索

如果启用全文搜索，需要检查中文分词效果。

搜索体验比是否“功能完整”更重要：标题和摘要足够清晰时，搜索压力会小很多。

迭代记录

2026-06-09

把站点方向从模板博客调整为“杂想 + 笔记库”。

本次改动包括：

首页改成两个主要入口。
博客列表改名为杂想。
文档区改成笔记库。
切换站点头像。
逐步替换主题模板文案。

后续计划

下一阶段重点不是继续加页面，而是整理真实内容：

把现有零散笔记迁移进知识库。
明确每个目录的边界。
给常用笔记加交叉链接。
设计网页端写作入口。

如果以后要做在线上传文章，需要引入后端或外部 CMS，这会是一个独立功能。

交互组件

适用场景

交互组件适合放在需要探索的内容里，例如：

多步骤流程。
可展开的资料清单。
示例代码和结果对照。
项目进度或版本记录。

普通说明文不需要复杂交互，否则会分散注意力。

设计约束

交互内容要遵守三个原则：

默认状态能看懂。
展开后能提供额外价值。
移动端不影响阅读。

暂定组件池

目前优先使用主题已有组件，不额外引入新的 UI 框架。

等内容规模增加后，再判断是否需要为知识库定制树形目录、双链引用或笔记关系图。

评论系统

当前定位

评论区主要用于交流和补充，不作为正式内容的一部分。

适合放在：

文章详情页。
友链申请页。
少量需要反馈的项目页。

不适合放在所有笔记页，否则维护成本会变高。

配置思路

评论服务应该独立于内容本身。文章和笔记即使没有评论系统，也要能完整阅读。

如果以后启用评论，需要确认：

管理后台可以正常登录。
垃圾评论有拦截方案。
访客隐私说明清楚。

后续事项

等站点内容稳定后，再决定是否开启评论和浏览量统计。

常用内容组件

使用原则

内容组件不是为了装饰页面，而是帮助读者更快理解信息。

推荐用法：

提示块：放注意事项、风险、结论。
折叠块：放补充说明、长代码、次要材料。
标签页：对比不同命令、不同平台或不同方案。
卡片列表：整理一组相关链接或工具。

写笔记时的判断

如果一段内容用普通 Markdown 就能讲清楚，不需要额外组件。

如果读者需要在几类信息之间切换，或者某段内容会干扰主线，再考虑组件。

后续计划

后面可以整理一篇真实示例，专门展示这个站点里常用的 MDX 组件写法。

内容呈现

阅读体验

内容页应该保持轻量，重点放在正文。

列表页负责筛选和预览，详情页负责完整表达，不在详情页堆太多无关入口。

图片

图片要服务于内容，而不是填空：

封面图用于表达文章气质。
正文图用于解释问题。
不使用无法说明内容的装饰图。

后续可以统一整理封面比例和压缩规则。

友链管理

友链用途

友链页不是导航站，而是记录值得长期关注的个人站点和资料入口。

目前分成三类：

常用友链。
暂时不可访问的链接。
特别链接。

收录标准

优先收录满足这些条件的网站：

可以长期访问。
内容以原创记录为主。
有稳定域名。
最近仍在维护，或者旧内容有长期价值。

维护方式

友链数据放在 public/links.json。

新增或调整友链时，只改数据文件即可，不需要改页面结构。

其他集成

搜索

搜索适合在内容数量增加后启用。当前阶段更重要的是先把目录和标题整理清楚。

如果后续启用 Pagefind，需要检查中文搜索效果和构建产物大小。

图片处理

图片最好放在内容同级目录里，方便迁移和维护。

后续可以补充：

图片压缩流程。
封面图命名规则。
图床和本地图片的取舍。

未来可能接入

可以考虑的辅助能力包括：

RSS 订阅。
评论或留言。
自动生成站点地图。
从 Obsidian 笔记库同步内容。

样式系统

当前方式

站点使用主题内置样式和 UnoCSS 工具类。

页面调整优先使用已有组件和工具类，只有在确实影响整体视觉时再写额外 CSS。

修改原则

少改全局变量。
少加一次性复杂样式。
优先保持页面间一致。
移动端和桌面端都要检查。

可继续优化的点

后续可以统一：

首页卡片密度。
笔记库树形目录样式。
文章列表的日期和标签显示。
暗色模式下的对比度。

站点配置

配置入口

站点的核心配置集中在 src/site.config.ts。

目前最常改的字段有：

title：站点名称。
description：站点摘要。
logo：头像图片和替代文本。
nav：顶部导航。
integ：搜索、评论、统计等集成功能。

头像

头像图片放在 src/assets 下，再通过 logo.src 引用。这样 Astro 会参与构建处理，不需要手动维护 public 路径。

如果之后想换成真人照片、插画或品牌头像，只需要替换图片并改配置即可。

内容写作规范

内容类型

本站目前分成两类内容：

杂想文章：放在 src/content/blog，按发布时间展示。
知识库笔记：放在 src/content/docs，按目录和排序展示。

杂想可以轻一点，笔记库要更结构化。

元信息约定

每篇内容都应该尽量写清楚：

title：标题，直接说明主题。
description：一句话摘要，用于列表页和搜索结果。
publishDate：发布时间，杂想内容需要填写。
tags：标签，数量不用多，2 到 4 个足够。
draft：草稿内容设为 true，只用于本地预览。

写作方式

一篇笔记只解决一个问题。推荐结构是：

先写这个问题是什么。
再写当前做法或判断。
最后补充下一步、参考资料或待验证点。

如果一篇内容开始变得很长，就拆成几篇互相链接的笔记。

部署与发布

发布流程

当前站点部署在 Vercel。正常发布流程是：

本地完成内容或页面修改。
执行类型检查和构建。
提交代码并推送到 GitHub。
由 Vercel 自动构建和发布。

发布前检查

每次发布前至少确认三件事：

首页能正常打开，头像和导航没有断。
杂想列表和笔记库目录能正常跳转。
构建没有类型错误和内容 schema 错误。

如果只是新增草稿，可以先设置 draft: true，确认不会出现在公开列表里。

后续改进

后续可以补一个发布清单，把搜索索引、站点地图、RSS、Open Graph 图片也纳入检查。

笔记库入口设计

目标

这个站点不再只做传统博客列表，而是保留两种入口：

杂想：按时间记录，适合放临时想法、短文章、阶段性复盘。
笔记库：按主题组织，适合沉淀可复用的知识、流程和资料索引。

这样做的好处是，新的想法可以先快速进入时间流，之后再把有价值的内容整理到树形笔记里。

首页结构

首页应该先说明站点的用途，然后给出两个清晰入口：

想随便看看近期记录，就进入杂想。
想找某一类知识，就进入笔记库。

下面的卡片只做概览，不承担完整目录功能，避免首页变得太重。

笔记库结构

笔记库采用三层以内的树形结构：

一级目录放主题，例如站点搭建、写作工作流、内容组件。
二级目录放具体问题，例如部署、配置、搜索、评论。
单篇笔记只解决一个主题，不把太多问题混在一起。

后续如果笔记数量增加，可以再加标签和全文搜索，但目录结构应该先稳定下来。