StableStudio 项目常见问题解决方案

1. 项目基础介绍和主要编程语言

StableStudio 是 Stability AI 官方开源的生成式 AI 用户界面项目，它是 DreamStudio 的开源版本。该项目允许用户通过网页应用程序创建和编辑生成图像。StableStudio 的主要编程语言是 TypeScript，并且使用了 Node.js 和 Yarn 作为依赖管理工具。

2. 新手在使用项目时需要特别注意的3个问题及解决步骤

问题1：依赖安装失败

问题描述：新手在运行 yarn install 命令时，可能会遇到依赖安装失败的问题，通常是由于网络问题或 Node.js 版本不兼容导致的。

解决步骤：

1. 检查 Node.js 版本：确保你安装的 Node.js 版本符合项目要求（通常是 LTS 版本）。可以在终端中运行 node -v 查看当前版本。
2. 使用 Yarn 的离线缓存：如果网络不稳定，可以尝试使用 Yarn 的离线缓存功能，先下载依赖包到本地，再进行安装。
3. 清理缓存并重试：运行 yarn cache clean 清理 Yarn 缓存，然后重新运行 yarn install。

问题2：启动项目时端口被占用

问题描述：在运行 yarn dev 启动项目时，可能会遇到端口被占用的问题，导致项目无法正常启动。

解决步骤：

1. 检查端口占用情况：在终端中运行 lsof -i :3000（假设默认端口是 3000），查看哪个进程占用了该端口。
2. 终止占用端口的进程：使用 kill -9 <PID> 命令终止占用端口的进程，其中 <PID> 是上一步查到的进程 ID。
3. 更改项目端口：如果不想终止其他进程，可以在项目配置中更改默认端口，或者在启动命令中指定端口，例如 yarn dev --port 3001。

问题3：API 插件配置错误

问题描述：新手在使用默认的 Stability API 插件时，可能会遇到 API 密钥配置错误或插件无法正常工作的问题。

解决步骤：

1. 检查 API 密钥：确保你已经从 Stability AI 获取了有效的 API 密钥，并且密钥格式正确。
2. 配置插件：在项目配置文件中找到 API 插件的配置部分，确保 API 密钥已正确填写。
3. 测试插件：在项目启动后，尝试使用插件生成图像，检查是否能够正常工作。如果仍然有问题，可以查看控制台日志，查找错误信息。

通过以上步骤，新手可以更好地解决在使用 StableStudio 项目时遇到的常见问题，顺利进行开发和使用。