构建日志

这里记录网站周边系统的关键变化，包括开发环境、维护自动化、发布流程与值得说明的网站功能。自动生成的更新页面回答“哪些笔记最近变了”；本页则说明“新增了什么能力，以及为什么这样做”。

每条记录保持简短：

• 新增：新能力及常用命令；
• 变更：与过去不同的重要行为；
• 验证：已经通过的检查；
• 下一步：有意延后的工作。

2026-08-04 — WSL 开发环境整理

新增

• 建立安全的配置快照流程，包含校验和、Conda 导出、软件包清单与恢复工具；明确排除项目、SSH 私钥和 Shell secrets。

• 新增 maintain 命令处理日常 Ubuntu 维护：

  maintain status   # 磁盘、缓存与待更新软件包
  maintain update   # 不删除软件包的就地更新
  maintain clean    # 只清理可重新下载的包缓存
  maintain all      # 更新、清理并报告结果

• 通过 systemd 自动安装 Ubuntu 安全更新，只允许官方安全源，并禁止自动重启 WSL。

• 安装一组轻量命令行工具：fd、jq、shellcheck、pipx、ncdu、direnv 和 hyperfine。

• 准备可选的 Windows VHDX 压缩工具，用于在大量清理 Linux 缓存后回收宿主机磁盘空间。

变更

• Node.js 从 20 升级到 24.18.1，网站的固定版本也同步更新。
• Conda 不再随每个终端自动进入 base。首次使用时才加载，因此 conda activate <environment> 保持可用，普通 Shell 默认使用 Ubuntu Python。
• Shell 启动时会去除重复 PATH，Git 与系统别名更加谨慎，并集成 zoxide 和 direnv。
• 软件包缓存减少约 18 GB。这些空间先在 WSL 内部释放；缩小 Windows VHDX 仍是单独、显式的操作。

验证

• Docusaurus 的英文、简体中文和法文生产构建全部完成。
• Vite 与 Next.js 工程通过了各自适用的构建和测试；原有的 lint 技术债保持不变。
• Ubuntu 完成全部待处理更新，没有损坏或半配置的软件包。
• 全新 Shell 测试确认 Conda 延迟加载、PATH 去重和维护命令均正常。
• 最终配置快照通过全部 SHA-256 校验，且不含私钥或 secrets 文件。

下一步

• 等活跃仓库的改动提交或妥善保存后，再把日常开发从 root 平滑迁移到普通 WSL 用户。
• 项目迁移与环境维护保持分离，以便文件权限和 VS Code 重连都能独立验证与回退。

后续记录模板

## YYYY-MM-DD — 简短结果

### 新增
- 新能力及主要命令或入口。

### 变更
- 重要行为变化及其原因。

### 验证
- 构建、测试、健康检查或备份结果。

### 下一步
- 有意延后的工作（如有）。