月映旧卷 · 持续维护
闲梦 · 云村
一座持续生长的个人数字世界，用来记录学习笔记、技术实践与开源项目。
AstroTypeScriptReactMDX
成器实录
这项工作如何被做出来
案例核对于
我的职责独立完成产品定位、视觉设计、内容建模、前端开发与质量验证
核心问题
在保留像素绘本世界观的同时，让笔记、项目与计划仍然容易找到、容易阅读，并能在静态托管环境长期维护。
- 公开内容
- 静态优先 构建阶段生成，并由 Pagefind 建立中文索引
- 质量验证
- 自动回归 覆盖单元、可访问性与 Chromium 端到端场景
- 私人工作台
- 独立隔离 管理员身份与 D1 私人数据不进入公开构建
现实限制
- 公开内容保持静态发布，私人数据则必须与搜索、缓存和公开构建彻底隔离
- 首页拥有大幅四时地图，但必须控制首屏图片与脚本开销
- 动画、键盘导航、移动端触控和无 JavaScript 场景都要有可用路径
关键取舍
- 以 Astro 内容集合承载真实资料，用少量 React Islands 处理必要交互
- 让七境对应稳定的内容职责，同时保留搜索、RSS 与普通链接作为直接入口
- 将搜索质量、阅读统计、离线策略和关键交互纳入自动化回归
复盘结论
- 视觉完成度不能替代真实内容，后续更新应优先补项目证据与学习记录
- 世界观地名需要配合明确导览，第一次访问的人不应先猜每个区域的用途
- 大图和环境动画要遵守渐进增强，核心内容始终应由普通 HTML 链接抵达
水上近事
与此旧卷相系的行舟
项目定位
一座藏在云墙后的个人数字村落，用来发布学习笔记、开源项目经历与个人介绍。页面以云村为中心，让风谷承接笔记、月潭保存项目档案，并以个人主页呈现真实履历。
技术实现
- 使用 Astro 内容集合与 MDX 管理笔记、项目和元数据，并在构建阶段生成静态页面。
- 通过少量 React Islands 实现云幕入场、全境地图、卷轴侧栏与四时环境切换，控制客户端脚本体积。
- 集成 Pagefind 中文全文搜索，同时提供 RSS、Sitemap、自定义 404 与响应式导航。
- 将私人工作台部署为独立受保护应用，以指定邮箱、网站专用密码和服务端会话限制唯一管理员，保留通行密钥作为备用验证方式，并由 D1 持久保存私人记录。
- 为减少动态效果偏好、无 JavaScript 场景和键盘导航提供降级支持。
当前状态
站点仍在持续维护，后续会继续补充真实笔记、开源项目档案与可验证的个人经历。