avatar洪显学
← 返回

xxlab 行迹录

更新于 2026年7月8日v1.1.0
xxlabAstroReactThree.jsMarkdown行迹录3D 书架个人知识系统
xxlab 行迹录

xxlab 行迹录是我的个人网站,也是一个持续迭代的个人知识与行迹记录系统。它不是单纯的作品集,而是用来展示我长期愿意投入的项目、正在形成的方法,以及每一次重要变化留下的轨迹。

项目定位

xxlab 行迹录回答的是三个问题:

  • 我长期关注什么
  • 我正在把哪些想法变成项目
  • 这些项目如何随着时间发生变化

博客记录阶段性的思考,项目页保存当前快照,行迹录记录变化过程。三者合在一起,构成一个可以持续更新的个人档案馆。

为什么做

我不想把个人网站做成静态简历,也不想只展示已经完成的成果。很多真正重要的内容,都处在长期迭代中:一个项目可能从灵感开始,经历原型、复盘、重构、暂停,再重新启动。

xxlab 行迹录的价值在于把这些过程留下来。它允许项目还不完美,但必须真实;允许判断会变化,但变化要有记录。

当前版本

当前版本是 v1.1.0,这一版的重点是把行迹录从普通时间线升级为“按年份装订”的阅读体验:每一年变成书架上的一本书,点击书脊后,读者可以在右侧浏览这一年的记录,也可以打开立体书查看更具仪式感的年度封面。

这一阶段的目标不是增加装饰,而是让“记录发生在时间里”这件事被更直观地看见:

  • 书架只展示真实存在记录的年份,例如 2025、2026
  • 书脊厚度根据年度记录数量自动分级,30 条以内为很薄,100 条以上为很厚
  • 书架固定宽度并支持未来年份增多后的自适应换行
  • 年度立体书默认使用精装形态和俯视角度,保留可旋转的 3D 查看方式
  • 列表区弱化装饰点,把注意力留给标题、日期和摘要

版本记录

v1.1.0

  • 将行迹录升级为书架式年度入口,每本书代表一年记录
  • 引入 Three.js 立体书封面,复现精装书、书页厚度、封面纹理和阴影层次
  • 按记录数量计算书脊和立体书厚度,并为未来多年份自动换行预留结构
  • 统一书架与立体书的深青色视觉系统,减少操作控件,让阅读路径更直接
  • 完成桌面与移动端构建、截图和浏览器验收

v1.0.0

  • 建立个人网站作为长期行迹记录系统的项目定位
  • 明确博客、项目页、行迹录三者分工
  • 项目区从测试案例转向真实项目展示
  • 引入项目版本号作为项目当前快照的主要标识

我在其中承担的角色

这个项目由我同时承担产品定义、内容架构、前端实现和持续维护。

我关注的不只是页面好不好看,而是它能不能长期支撑真实表达:当项目版本变化、文章新增、行迹更新时,网站结构是否仍然清晰,信息是否还能被读者理解。

技术实现

  • Astro 作为静态站点主体
  • React islands 承载局部交互
  • Three.js 渲染年度立体书,Canvas 负责封面纹理与书页细节
  • Markdown 内容集合管理博客、项目、行迹录和技能
  • Tailwind 与全局 CSS 共同维护视觉系统
  • 静态搜索索引支持文章与项目检索

不变原则

  • 真实优先:不展示虚构案例
  • 版本清晰:项目必须能看出当前版本
  • 过程可追踪:重要变化要进入行迹录
  • 内容克制:页面服务于表达,不堆功能

下一步

下一步会继续完善行迹录与项目页之间的互相引用:当项目进入新阶段时,项目页更新当前快照,行迹录留下变化节点;同时继续补齐更多真实项目的“当前版本 + 关键成果 + 行迹节点”。