ORIGINAL / 原创仓库
xiaoshecode.github.io
将个人资料、动态、论文和项目集中在轻量静态主页，支持语言与主题切换。
本页记录本轮维护的改动和验证结果。完整差异与实时合并状态请查看 Pull Request ↗。
准备环境
- Node.js 22.19+，npm 9.6.5+；最低 Node 版本与锁文件中的 undici 要求一致。
- npm ci：安装 package-lock.json 锁定的依赖。
使用入口
- npm run dev：本地开发。
- npm run build：构建到 dist/。
- npm run preview：预览构建产物。
- 网站：https://xiaoshecode.github.io/
目录结构与职责
- src/pages/index.astro：页面组合。
- src/components/：布局和内容组件。
- src/data/：双语文案、论文、动态和项目数据。
- src/content.config.ts：内容字段校验。
- src/scripts/main.ts：语言、主题和滚动交互。
- src/styles/global.css：全站样式。
- public/：静态资源；dist/：忽略的生成产物。
本次整理
- 通过兼容范围内的 npm audit fix 更新锁文件，修复 5 项高危依赖告警。
- README 补充环境要求、结构说明、npm ci、维护规范与文档入口。
- 新增 .editorconfig 统一新编辑的文本规范。
- 修正最低 Node.js 版本为22.19，与锁文件 engines 一致；实际生产构建仍为Node24.20.0的验证记录。
检查结果
| 检查项 | 状态 | 证据 / 范围 |
|---|---|---|
| 生产构建 | 通过 | Node 24.20.0；npm run build 在依赖修复前后均成功，生成 1 个静态页面。 |
| 依赖审计 | 通过 | npm audit fix --ignore-scripts 完成；2026-10-30 检测结果为 0 vulnerabilities，修复前为 5 high。 |
| 差异检查 | 通过 | git diff --check 未报告空白错误。 |
| Node 最低版本声明核对 | 通过 | package-lock.json 中 undici 8.12.3 要求 Node >=22.19.0；README 与记录同步为22.19+。未额外运行22.19环境。 |
已知限制与后续工作
- 依赖审计是执行时刻的快照，不保证不存在未知漏洞。
- Astro build 不是完整 TypeScript 类型检查；本次未执行独立浏览器端回归测试。