用途：帮助团队建立可复现、对开发者友好的开发环境，覆盖 IDE 配置、工具安装、依赖管理、入职文档与跨平台兼容。适用于新项目初始化、新成员入职、统一团队环境、排查开发环境问题、编写搭建自动化脚本和配置 IDE。
主要能力：提供一键式项目搭建脚本思路（scripts/setup.sh），包含前置检查（node、npm、git 及 Node 版本校验）、从 .env.example 生成 .env、npm ci 安装依赖、Husky Git 钩子、数据库迁移与种子数据、类型检查/ lint / 构建验证。提供版本管理配置示例（.nvmrc、.tool-versions、Volta）。提供 VSCode 配置（settings.json、extensions.json、launch.json）、EditorConfig、.gitattributes、Husky + lint-staged 预提交钩子。提供 CONTRIBUTING.md 模板、开发者入职清单、跨平台检测脚本与 Windows PowerShell 搭建脚本。
使用方式：将 setup.sh 放入 scripts/ 并赋予执行权限，运行 ./scripts/setup.sh；Windows 使用 scripts/setup.ps1。按需复制 .vscode、.editorconfig、.gitattributes、.husky 等配置到项目。
限制：资料未提供具体安装命令之外的收费、平台支持范围或效果保证；脚本中的数据库、迁移、种子等命令依赖项目自身脚本，缺失时仅给出警告。跨平台兼容需自行验证。