Kura Time Maze：把 Halo 博客首页变成一座吃豆人时间迷宫

我想做的不是在博客首页放一个普通数字时钟，而是让“时间经过”真正变成可以看见的东西。于是有了 Kura Time Maze（极库时光迷宫）：吃豆人沿着时间轨道前进，逐步吃掉今天、这周、这个月和今年已经过去的部分。

项目源码：liuhao192/Kura-Time-Maze

它是一套面向 Halo 2 的完整主题。首页采用街机时钟设计，但文章列表、文章详情、分类、标签、归档、友链和 404 页面都仍然保留，因此它不只是一个独立计时页面，而是一套可以长期使用的博客皮肤。

1. 设计思路

Kura Time Maze 把吃豆人的“移动与吃豆子”转换成时间进度。亮起的豆子代表仍未经过的时间，吃豆人身后的轨道逐渐变暗，角色所在的位置就是当下。

界面没有照搬传统游戏机的复杂元素，而是保留最有辨识度的视觉语言：黄色吃豆人、蓝色迷宫线、幽灵、像素计分、深色背景和微弱的霓虹发光。外层使用半透明玻璃面板，使背景图片仍然可见，但不会干扰时间信息。

2. 四种时间尺度

首页提供四个可切换的进度视图：

视图	表达内容
Today	今天从 00:00 到 24:00 的进度
Week	本周已经经过的比例
Month	本月已经经过的比例
Year	今年已经经过的比例

切换后，吃豆人位置、进度百分比和剩余时间会同步变化。它让“今天过了多少”和“今年还剩多少”使用同一套直观语言表达。

3. 一天三阶段

Today 视图把一天拆成三个八小时阶段：

• 00:00—08:00：凌晨与清晨；
• 08:00—16:00：白天；
• 16:00—24:00：傍晚与夜间。

已经完成的阶段自动降低亮度，当前阶段保持发光与呼吸效果。这样既能看到全天进度，也能快速确认自己正处在一天的哪一段。

界面右侧保留了 1UP 与 HIGH SCORE。这里的分数不是游戏排行榜，而是吃豆人主题的视觉化时间刻度，用来增强街机仪表盘的感觉。

4. kura.ren 实际运行效果

下面的截图直接取自当前博客首页，展示了 Kura Time Maze 在桌面端的真实效果：

截图时间：2026 年 9 月 15 日，页面为 kura.ren 当前桌面端首页。

截图中可以看到大号实时时钟、日期、四种时间尺度、吃豆人轨道、三阶段状态、今日进度和剩余时间。继续向下滚动就是正常的博客文章列表。

5. 完整博客能力

主题没有牺牲 Halo 原有内容结构，已经覆盖：

• 首页文章列表与分页；
• 文章正文、上一篇与下一篇；
• 分类、标签和归档；
• 友链页面；
• 自定义 404 页面；
• 桌面端和手机端响应式布局；
• 可选的ICP备案信息。

手机端会重新排列时间、轨道和进度面板，保证小屏幕上仍然能够阅读和操作。

6. 背景与主题配置

后台主题设置提供以下选项：

设置	说明
主题色	页面主要强调色
首页背景图片	填写完整图片地址，优先使用
Bing 背景 JSON 地址	返回包含 bg_url 字段的接口地址
备案号	留空时不显示
备案链接	默认指向工信部备案网站

如果没有配置图片或 Bing 接口，首页会自动使用内置深色渐变背景，不会出现空白。

Bing 背景接口返回示例：

{
  "bg_url": "https://www.bing.com/th?id=OHR.Example_UHD.jpg"
}

7. 安装方法

环境要求为 Halo 2.11.0 或更高版本，安装步骤如下：

1. 从 GitHub 下载仓库 ZIP；
2. 解压后确认根目录包含 theme.yaml、settings.yaml 和 templates；
3. 将主题目录命名为 theme-kura-time-maze，复制到 Halo 主题目录，或者在后台上传打包后的 ZIP；
4. 在 Halo 后台启用 Kura Time Maze · 极库时光迷宫；
5. 进入主题设置，填写背景、主题色和备案信息。

静态资源位于 templates/assets/，模板通过 Halo 标准资源路径引用，因此更换部署目录时不需要修改硬编码地址。

8. 项目地址

完整源码、中英文 README、安装说明和主题文件：

Kura Time Maze · GitHub

Kura Time Maze 让时间不再只是右上角的一串数字。它会移动、会发光，也会在吃豆人的身后留下今天已经走过的路。