一、现有项目存在的问题

关于开发

• 目前最大问题：老三件套开发和维护都十分困难，hugo 基本没有语法提示

  Astro —— tsx，vue 语法提示 OK

• 构建速度需要提升，目前还需要花费 1min 以上，其中光是装 python 的依赖就要十几秒构建时间

  Python → node, checkout submodule 不需要；autocorrect 不需要 → prettier；daily report 改成真的 daily 的；Wrap badges 不需要；

• GitHub 存在 API 请求限制，如何绕过

  在各个课程仓库内跑 CI 生成文件树数据，发请求只需要请求该数据即可

  
  git ls-files -z | while read -d '' path; do touch -d $(git log -1 --format="@%ct" "$path") "$path"; done
  

• 没有开发文档 CHANGELOG ，之前对于 commit 相关内容也没有强制性约束

  https://github.com/conventional-changelog/commitlint

  https://github.com/commitizen/cz-cli

  https://github.com/unjs/changelogen

• 缺少好用的 DevTools，只能硬看 HTML 和 CSS

  Astro 可，官方 DevTools

关于用户体验

• 目前网站直连访问速度较差，如何提高页面打开速度，让 LCP 时间尽可能短

  Astro 打开速度 OK；主要是 cf pages 访问慢

• 下载失败弹窗通知到用户的信息过少

  Astro 自定义组件就 OK ；报错 Match 相关信息

• 没有版本管理逻辑，新功能无法直接通知到用户

  在页面右下角下方放置 公告栏 填 CHANGELOG 信息；其他公告信息

关于未来拓展

• 未能达到组件级别的解耦，自主修改样式比较困难

  自维护 npm 主题包；→ 前期主要工作量所在，需要借鉴其它代码仓库

• 零基础新人无法快速上手本项目，且学习该技术栈实际收益较小

  Astro 上手难度适中；技术栈比较新，属于现代前端范围

二、对现有文档进行兼容

页面内容相关

• 保证当前所有 md 文件都可以无缝衔接迁移

  首先需要一个类似 https://github.com/cworld1/astro-theme-pure 的主题仓库；接着再创建一个 astro-hoa-moe 仓库使用该主题插件

• 现有重要功能完整保留，如文件树样式和功能；Auto 更新速递；友链功能；暗色亮色模式

  需要自写 components