Skip to content

CHANGELOG.md

Latest commit

 

History

History
106 lines (74 loc) · 6.39 KB

CHANGELOG.md

File metadata and controls

106 lines (74 loc) · 6.39 KB

Learndata 升级日志

为了更方便地维护和升级后续版本，我将定期发布 Learndata 新版本，并在此记录所有重大变更及破坏性更新。

1.4.0 (2026-03-05)

🚀 重大架构升级

  • 构建系统迁移：从 webpack 切换到 Vite (6d51d79)

    • 开发服务器启动速度提升 10 倍以上（基于 ESM 按需编译）
    • 模块热替换（HMR）即时响应文件变化
    • 使用 content hash，仅当内容实际变化时才更新文件名
    • 基于 Rollup 的生产构建，输出更优化的打包结果

  • 目录结构优化：docs 目录重命名为 src (c3a9480, e420e28)

    • 解决 Vercel 等平台使用默认构建命令时的路径冲突问题
    • 符合现代项目结构约定

✨ 新增功能

  • 自动化脚本 (dd54235d, 42c2a7e)

    • scripts/seo-audit.js：扫描 Markdown 文件的 frontmatter SEO 问题
    • scripts/llms-txt.js：生成 LLM 友好的站点索引（llms.txt）
    • scripts/reading-sidebar.js：自动生成 docsify 读书笔记侧边栏
    • 新增 npm scripts：seo:audit、reading:sidebar
    • 构建后自动生成 llms.txt

  • 读书笔记升级 (c12dd01)

    • 迁移 Waline 评论系统 v2 → v3
    • 优化站点运行时间统计（ES6 模块化代码）
    • 改进页面阅读量统计集成
    • 增强 SEO meta description
    • 禁用默认 docsify 搜索（避免与 slimsearch 冲突）

📦 依赖与 CI 更新

依赖版本和 GitHub Actions 均已随代码更新，git pull 后重新安装即可，无需手动修改。主要变更：构建工具从 @vuepress/bundler-webpack 切换到 @vuepress/bundler-vite，移除 mathjax-full/sass-loader/vidstack，新增 @mathjax/src/gray-matter。

⚠️ 迁移说明（从 v1.3.9 升级）

所有配置变更（目录重命名、Webpack→Vite、依赖替换等）均已包含在代码中，拉取最新版本即可自动完成迁移：

git pull origin main
rm -rf node_modules pnpm-lock.yaml
pnpm install
pnpm docs:build

本版本将 docs 目录重命名为 src，git pull 会自动处理该重命名，你已有的文章和配置会随之移动到 src 下。如遇合并冲突，注意以下两点：

  • 自定义文章：确认你的文章已从 docs/ 迁移到 src/ 目录下，路由路径不变。
  • 站点配置（URL、站点名、头像等）：合并冲突时保留你的自定义值即可，但注意 config.ts 中的 bundler 需改用 viteBundler()，templateBuild 路径需从 ./docs/ 改为 ./src/。

1.3.9 (2025-10-12)

⚠️ 破坏性更新

  • docs/.vuepress/styles/config.scss 中的 theme-colors 配置项更名为 theme-color。(43a6afc)
  • 博客页面 docs/blog.md 中的 layout 配置由 BlogHome 改为 Blog。(a26c290)

✂️ 默认组件调整

  • 移除 docs/.vuepress/theme.ts 中默认启用的内部组件 vidstack，避免升级后在部分环境中构建失败。(ebf4319)
  • 修改 docs/.vuepress/styles/palette.scss，优化深色模式下的调色板。(eda325c)

♻️ 配置优化

  • 清理 docs/.vuepress/sidebar.ts 中错误的 link: "" 配置，并优化侧边栏路径结构，提高可读性和维护性。(6dce681)

📦 依赖更新

  • 升级部分依赖，并重构了 package.json 文件结构。(5b0ea87)

1.3.8 (2025-03-04)

  • 在 docs/.vuepress/theme.ts 中添加设置版权及禁用复制的说明 (b5be1c9)
  • 更新 GitHub Action 配置 .github/workflows/main.yml，将 pnpm 版本从 9 调整为 10 (0c48b3e)
  • 常规依赖更新 package.json (d111e8b)

1.3.7 (2025-01-24)

  • 主题配置 docs/.vuepress/theme.ts：
    • 更新 icon assets 配置：将 iconAssets 改为 plugins.icon.assets (1cc3dc5)
    • 加密配置：对整个 encrypt 目录和指定页面加密的示例配置 (38fc81f)
  • 常规依赖更新 package.json (fae924a)

1.3.6 (2024-12-09)

  • 主题配置 docs/.vuepress/theme.ts：
    • 主题使用 custom，性能提升。
    • 插件适配：plugins.mdEnhance、plugins.markdownImage、plugins.markdownHint 合并为 markdown。
  • 样式更新：
    • docs/.vuepress/styles/palette.scss：修改主题背景颜色
    • docs/.vuepress/styles/config.scss：添加多种主题颜色，用户可在导航栏自由选择主色
    • docs/.vuepress/styles/index.scss：移除目录自定义位置（新主题已内置该优化项）
  • 依赖升级 package.json：
    • 搜索依赖 vuepress-plugin-search-pro 改名为 @vuepress/plugin-slimsearch
    • 常规依赖更新

1.3.5 (2024-09-21)

  • docs/.vuepress/theme.ts：修改配置中的 plugins.mdEnhance、plugins.markdownImage、plugins.markdownHint。
  • docs/.vuepress/styles/palette.scss：博客样式结构进行了大幅度的改版。此次改动后，可以直接替换此文件以更新样式。
  • docs/.vuepress/templateBuild.html：修改了网页模板 head 部分的样式定义，以适应新的页面布局和样式需求。
  • package.json：除了常规依赖项的升级，还新增了对 sass-embedded 的依赖。