框架项目怎么运行

先识别项目，不要急着执行命令

打开目录后先找：

文件	通常说明什么
`package.json`	JavaScript/TypeScript 项目的依赖和脚本
`package-lock.json`	项目使用 npm 锁定依赖
`pnpm-lock.yaml`	项目使用 pnpm
`yarn.lock`	项目使用 Yarn
`vite.config.*`	使用 Vite 开发/构建工具
`next.config.*`	Next.js 项目
`astro.config.*`	Astro 项目
`src/`	主要源代码
`public/`	原样复制的静态文件
`.env.example`	环境变量示例，不应包含真实密钥

同一个项目尽量使用锁文件对应的包管理器，不要同时生成多种锁文件。

通用运行流程

# 1. 先查看 Node 和包管理器要求
node --version

# 2. 安装锁定的依赖（以 npm 为例）
npm ci

# 3. 查看 package.json 中实际提供的脚本
npm run

# 4. 启动开发服务器
npm run dev

# 5. 上线前构建
npm run build

教程里的命令只是常见约定，最终以项目的 README 和 package.json 为准。

开发、构建和预览有什么区别

开发服务器：监听文件变化、显示调试错误，适合本地开发；
构建：把源码转换成生产文件，可能生成 dist/、.next/ 等目录；
预览：在本地用接近生产的方式运行构建结果；
生产启动：运行需要服务端环境的应用，命令和端口由项目决定。

不要把开发服务器直接当生产服务，也不要手动修改 dist/；它通常会在下次构建时被覆盖。

环境变量

环境变量保存不同环境的地址和配置。只有明确允许公开的变量才能进入浏览器构建；任何前端可读取的值，都应视为用户也能看到。

.env.example       # 字段说明，可以提交
.env.local         # 本机值，通常不提交
部署平台配置        # 生产值，按环境管理

模型 API Key、数据库密码和管理密钥必须留在服务端。

改一个页面的建议顺序

用搜索找到页面路由和入口组件；
看组件引用了哪些样式、数据和子组件；
在开发服务器中做一个小改动；
查看浏览器 Console 和 Network；
运行构建、类型检查和测试；
用 Git diff 确认没有修改生成目录和无关文件。

让 Agent 先解释项目

请先读取 README、package.json、锁文件和目录结构，不要修改。
告诉我：这是哪种框架、包管理器、页面入口、开发/构建命令、环境变量来源和部署方式。
标出你能确认的事实和仍需验证的推测。