Dev Log — SAKURAIN

Dev Log

Development iterations and technical logs.

191d23h57m20s

Recording duration

111

Dev logs

39/58/14

Difficulty distribution

Month

Difficulty

2026-08-11

1 logs

Easy

13:04:27

fix: 调整好友连接检查脚本的跳过条件

移除CI环境自动跳过检查的逻辑，仅在显式设置SKIP_FRIEND_CHECK时跳过

保留SKIP_FRIEND_CHECK环境变量作为跳过检查的可控开关

2026-08-10

1 logs

Normal

18:22:17

feat(music-player): 优化跨域音频播放与缓存保护逻辑

新增动态设置音频跨域属性，适配开发/预览环境CDN跨域配置

新增资源引用计数保护，避免播放/预加载资源被LRU缓存清理

新增CORS兼容性探测缓存，适配固定响应头的CDN场景

优化缓存更新逻辑，使用条件请求减少重复下载

添加网络变化时重置CORS探测缓存的逻辑

Closes #相关优化需求

2026-08-09

4 logs

Easy

19:02:22

feat(search): 支持模糊与精确两种搜索匹配模式

在 search.ts 中新增 matchMode 选项，精确模式要求完整查询短语作为子串命中。

GlobalSearch 搜索框增加模式切换按钮，支持 Fuzzy/Exact 切换，

并新增 searchFuzzy/searchExact 国际化文案。

Easy

18:53:45

feat(search): 搜索结果按文档类型分组展示

将 Command Palette 结果从扁平列表改为按类型分组展示，

每个分组显示图标、类型名称与结果数量，提升跨类型搜索时的可扫描性。

键盘导航与滚动定位保持跨分组连续。

Normal

15:22:46

feat(search): 添加全站统一搜索功能

构建期生成 public/data/search-index.json，覆盖文章、日志、文档、友链、服务与页面

新增轻量客户端搜索引擎，支持分词、字段加权与摘要高亮

新增 Command Palette 全局搜索弹窗与键盘导航

在灵动岛和首页搜索组件中接入统一搜索入口

Easy

13:35:59

feat(music-player): 新增恢复音频上下文的工具函数并适配调用

新增resumeAudioContext函数用于恢复挂起的Web Audio上下文，符合浏览器自动播放策略

在音乐播放器多个交互场景中调用该函数，修复音频被浏览器挂起无法播放的问题

优化音频加载失败的日志输出，添加错误详情信息

2026-07-27

4 logs

Normal

10:10:46

refactor(photos): 重构照片相册数据结构与逻辑

将原PhotoLogPhoto重命名为PhotoLogImage，新增PhotoLogEntry包裹单条相册内容

调整photos.json数据格式，使用entries替代原photos数组

添加自动补全ID和限制单条相册最多9张照片的同步脚本

重构相册页面逻辑，按新的数据结构渲染展示内容

优化图片查看器的信息展示逻辑，移除冗余元数据展示

Normal

09:46:26

refactor(music-player): 提取音频连接逻辑到公共函数并优化初始化

将音频分析器连接逻辑抽离为 initAudioConnection 公共函数

在音乐播放器上下文初始化时直接创建音频连接，避免可视化组件挂载延迟

为 AudioMetrics 和 AudioVisualizer 添加重试初始化机制，处理挂载时机问题

统一音频上下文初始化的错误处理和资源清理逻辑

Easy

08:32:05

feat(asset-cache): add IndexedDB asset cache for music resources

实现了基于 IndexedDB 的客户端持久化缓存，支持歌词、封面和音频资源的 LRU 缓存策略，减少重复下载。

重构歌词获取逻辑，新增封面和音频资源的缓存支持，优化音频播放和预加载流程，修复资源重复加载问题。

Easy

03:24:05

feat: 新增站点功能组件与地图模块，重构首页布局

新增高德地图足迹地图组件，支持城市轨迹展示与弹窗详情

新增搜索、世界时钟、每日一句、友链统计、技术栈五个首页组件

重构首页为不对称便当盒布局，替换原有统计组件

调整音频可视化参数优化视觉效果

添加多语言国际化词条支持新功能

新增城市数据与站点技术栈配置数据

添加中国地图SVG路径生成脚本

2026-07-26

2 logs

Easy

02:47:22

feat(music-player&dynamic-island): 优化频谱可视化和动态岛图标

为音频频谱可视化添加频率曲线功率参数，增强低频视觉占比

替换动态岛原有文字图标为项目logo图片

调整音频指标容器的最小宽度为固定值72px

Normal

02:12:29

feat(terminal): add game and app mode support with terminal games

新增game和app两种应用模式，添加snake、pong、breakout三款终端小游戏

新增sh命令支持运行/game和/app目录下的脚本

重构音频频谱器，增加柱状图数量并适配弹性布局

替换DynamicIsland的文字logo为站点图片

完善终端目录浏览支持，添加game和app目录入口

Dev Log

Development iterations and technical logs.

191d23h57m20s

Recording duration

111

Dev logs

39/58/14

Difficulty distribution

Month

Difficulty

2026-08-11

1 logs

Easy

13:04:27

fix: 调整好友连接检查脚本的跳过条件

移除CI环境自动跳过检查的逻辑，仅在显式设置SKIP_FRIEND_CHECK时跳过

保留SKIP_FRIEND_CHECK环境变量作为跳过检查的可控开关

2026-08-10

1 logs

Normal

18:22:17

feat(music-player): 优化跨域音频播放与缓存保护逻辑

新增动态设置音频跨域属性，适配开发/预览环境CDN跨域配置

新增资源引用计数保护，避免播放/预加载资源被LRU缓存清理

新增CORS兼容性探测缓存，适配固定响应头的CDN场景

优化缓存更新逻辑，使用条件请求减少重复下载

添加网络变化时重置CORS探测缓存的逻辑

Closes #相关优化需求

2026-08-09

4 logs

Easy

19:02:22

feat(search): 支持模糊与精确两种搜索匹配模式

在 search.ts 中新增 matchMode 选项，精确模式要求完整查询短语作为子串命中。

GlobalSearch 搜索框增加模式切换按钮，支持 Fuzzy/Exact 切换，

并新增 searchFuzzy/searchExact 国际化文案。

Easy

18:53:45

feat(search): 搜索结果按文档类型分组展示

将 Command Palette 结果从扁平列表改为按类型分组展示，

每个分组显示图标、类型名称与结果数量，提升跨类型搜索时的可扫描性。

键盘导航与滚动定位保持跨分组连续。

Normal

15:22:46

feat(search): 添加全站统一搜索功能

构建期生成 public/data/search-index.json，覆盖文章、日志、文档、友链、服务与页面

新增轻量客户端搜索引擎，支持分词、字段加权与摘要高亮

新增 Command Palette 全局搜索弹窗与键盘导航

在灵动岛和首页搜索组件中接入统一搜索入口

Easy

13:35:59

feat(music-player): 新增恢复音频上下文的工具函数并适配调用

新增resumeAudioContext函数用于恢复挂起的Web Audio上下文，符合浏览器自动播放策略

在音乐播放器多个交互场景中调用该函数，修复音频被浏览器挂起无法播放的问题

优化音频加载失败的日志输出，添加错误详情信息

2026-07-27

4 logs

Normal

10:10:46

refactor(photos): 重构照片相册数据结构与逻辑

将原PhotoLogPhoto重命名为PhotoLogImage，新增PhotoLogEntry包裹单条相册内容

调整photos.json数据格式，使用entries替代原photos数组

添加自动补全ID和限制单条相册最多9张照片的同步脚本

重构相册页面逻辑，按新的数据结构渲染展示内容

优化图片查看器的信息展示逻辑，移除冗余元数据展示

Normal

09:46:26

refactor(music-player): 提取音频连接逻辑到公共函数并优化初始化

将音频分析器连接逻辑抽离为 initAudioConnection 公共函数

在音乐播放器上下文初始化时直接创建音频连接，避免可视化组件挂载延迟

为 AudioMetrics 和 AudioVisualizer 添加重试初始化机制，处理挂载时机问题

统一音频上下文初始化的错误处理和资源清理逻辑

Easy

08:32:05

feat(asset-cache): add IndexedDB asset cache for music resources

实现了基于 IndexedDB 的客户端持久化缓存，支持歌词、封面和音频资源的 LRU 缓存策略，减少重复下载。

重构歌词获取逻辑，新增封面和音频资源的缓存支持，优化音频播放和预加载流程，修复资源重复加载问题。

Easy

03:24:05

feat: 新增站点功能组件与地图模块，重构首页布局

新增高德地图足迹地图组件，支持城市轨迹展示与弹窗详情

新增搜索、世界时钟、每日一句、友链统计、技术栈五个首页组件

重构首页为不对称便当盒布局，替换原有统计组件

调整音频可视化参数优化视觉效果

添加多语言国际化词条支持新功能

新增城市数据与站点技术栈配置数据

添加中国地图SVG路径生成脚本

2026-07-26

2 logs

Easy

02:47:22

feat(music-player&dynamic-island): 优化频谱可视化和动态岛图标

为音频频谱可视化添加频率曲线功率参数，增强低频视觉占比

替换动态岛原有文字图标为项目logo图片

调整音频指标容器的最小宽度为固定值72px

Normal

02:12:29

feat(terminal): add game and app mode support with terminal games

新增game和app两种应用模式，添加snake、pong、breakout三款终端小游戏

新增sh命令支持运行/game和/app目录下的脚本

重构音频频谱器，增加柱状图数量并适配弹性布局

替换DynamicIsland的文字logo为站点图片

完善终端目录浏览支持，添加game和app目录入口