Yohaku 主题上线踩坑实录

设计缺陷

1. 初始数据的获取失败，请检查 API 服务器是否正常运行。接口请求错误信息：[GET] "/aggregate?theme=yohaku%7Cshiro&lang=zh": <no response> Failed to parse URL from /aggregate?theme=yohaku%7Cshiro&lang=zh
2. 1. 在管理后台的代码片段下新建 theme/yohaku 文件，注意不需要带文件类型后缀
   2. 在手记下至少有 1 篇占位用的文章
2. 多语言翻译
3. 1. footer 区域有多语言切换，但默认要求全站的文章、手记等内容都要支持全语言版本翻译，这样切换时才不会出问题
   2. 1. 鉴于目前 deepseek API 价格还算便宜，配置 AI 翻译时最后选择了全语言翻译，目前包含 5 种：zh、zh-TW、ja、ko、en
      2. 如果发现无法选择 zh-TW，可以接受代码里默认的映射关系，zh-TW 也会被当作 zh（简体中文），但体验上可能有割裂感
   2. 多语言主题配置需要手动在代码片段功能下创建 theme 文件夹，再新建不同语言的主题配置文件。这部分主要承载站点导航、footer 右侧区域的内容翻译映射；⚠️ 不包含 footer 区域左侧的格言，那部分好像是内部代码翻译出来的
   3. 后台这个默认的富文本编辑器体验真的很差，一堆 bug；markdown 又没有实时预览
   4. 1. 内部暴露有 preview 接口，通过修改代码实现了发布前的预览功能

不太清晰的一些配置问题

1. 高德地图 API-Key，创建时选择类型为 web 服务

环境问题

• Docker 部署问题

1. 1. turbopack 需要 google-font，本地无法下载
   2. 每篇文章编译时都会去请求 aggreate 接口拿聚合信息，如果再叠加全语种翻译，很快就会触发限流导致编译失败；后来优化成编译前只请求一次聚合接口，后续复用结果

整体体验下来，Yohaku 这个项目还是比较粗糙，有很多使用细节需要打磨