ronisarkarexe/story-spark-ai - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径项目截图 4 贡献者 207 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

5分钟快速启动 StorySparkAI

快速启动StorySparkAI平台，体验AI生成故事变体。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Node.js 18.18+ 必需

pnpm 8+ 必需

所需工具

MongoDB

后端数据库

必需

AI API Key (至少一个)

用于AI故事生成，如OpenAI或Gemini

必需

操作步骤

克隆仓库并安装依赖

获取项目代码并安装所有依赖。

克隆项目仓库

git clone https://github.com/ronisarkarexe/story-spark-ai.git

进入项目目录

cd story-spark-ai

使用pnpm一次性安装所有工作区的依赖

pnpm install

确保Node.js和pnpm已正确安装。

配置环境变量

为后端和前端创建并配置必要的环境文件。

创建后端环境文件

cp backend/.env.example backend/.env

创建前端环境文件

cp frontend/.env.example frontend/.env

打开后端环境文件进行编辑（可用任何编辑器）

open backend/.env

必须填写backend/.env中的关键变量：DATABASEURL (MongoDB URI), JWTSECRET, ADMINEMAIL, ADMINPASSWORD，以及至少一个AI API Key (OPENAIKEY, GEMINIAPIKEY或AIAPIKEYS)。将frontend/.env中的VITEBASEURL设置为' http://localhost:5000/api/v1'。

初始化管理员账户

首次运行前，需要创建一个管理员用户。

运行后端脚本创建管理员用户

pnpm --filter backend seed:admin

确保backend/.env中的ADMINEMAIL和ADMINPASSWORD已正确设置。

启动开发服务器

同时启动前端和后端开发服务器。

启动前端和后端开发服务器

pnpm dev

终端会显示两个服务器的启动日志。

访问并体验

打开浏览器访问应用。

在浏览器中打开前端应用

open http://localhost:4001

你可以尝试使用之前创建的管理员账户登录，或直接使用Google登录（如果已配置）。在输入框输入一个故事提示词，点击'生成故事'按钮来测试AI功能。

验证本地运行成功

确认应用已正确启动并可访问。

浏览器成功加载应用首页

终端中无严重错误日志

尝试生成一个故事，能够返回AI生成的变体

快速提示

数据库

如果MongoDB未本地运行，可以使用免费的MongoDB Atlas云数据库，只需将连接字符串填入DATABASEURL。

AI配置

没有OpenAI或Gemini API Key？可以暂时跳过AI功能配置，先体验其他前端功能。

常见问题

pnpm install 失败

确保Node.js版本 >= 18.18 和pnpm版本 >= 8。可以尝试删除node_modules和pnpm-lock.yaml后重试。

后端启动失败，提示数据库连接错误

检查backend/.env中的DATABASEURL是否正确，确保MongoDB服务正在运行。

前端页面无法加载或请求API失败

检查frontend/.env中的VITEBASEURL是否为'http://localhost:5000/api/v1'，并确认后端服务器已启动。

下一步

探索AI故事生成

在应用中输入一个创意提示词，体验AI生成多个故事变体的功能。

查看项目文档

阅读项目中的ARCHITECTURE.md和DEVELOPMENT.md了解更多架构和开发细节。

参与贡献

查看项目的'Good First Issue'标签，为开源项目贡献力量。