背景
- 基于
customize-new分支进行依赖升级，主线main尚未合并。 - 本次通过
pnpm dlx @astrojs/upgrade自动更新 Astro 相关包并安装依赖。
时间写法说明
pubDatetime: 2025-12-16T11:54:00+07:00表示本地时间 11:54，时区是 UTC+7（越南时间）。modDatetime: 2025-12-16T04:54:00Z表示同一时刻的 UTC 时间，用Z表示零时区。- 如果想统一写法，可以都用本地带偏移（
...+07:00），或者都用 UTC（...Z）。
主要改动
- Astro 升级：
astro由 5.12.0 提升至 5.16.5，对应的@astrojs/check、@astrojs/rss、@astrojs/sitemap同步小版本升级。 - 工具链：锁文件更新到新版
vite 6.4.x、yaml 2.7.1等传递依赖；未发现 breaking change 提示。 - 状态检查：升级后工作区干净，仅
package.json与pnpm-lock.yaml有改动；功能运行正常（手动验证）。
部署问题 & 解决
- 问题：Vercel 构建时报 Shiki 类型不兼容（
@shikijs/types3.20.x vs@shikijs/transformers3.7.0），astro check失败。 - 处理：将
@shikijs/transformers升级到^3.20.0，并更新锁文件；本地pnpm run build通过。 - 备注：本地 Windows 环境
cp -r dist/pagefind public/报命令不存在，Vercel（Linux）不受影响。
待办
- 如需部署，先将
customize-new合并回main后推送。 - 如果遇到构建/类型检查异常，可针对单个依赖回滚或补充配置。