# pss

**Repository Path**: czwbCZWB/pss

## Basic Information

- **Project Name**: pss
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-23
- **Last Updated**: 2025-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 💡 灵感发生器 - AI内容工坊

一个集成了多线叙事、词生万物、文字魔术三大功能的AI内容创作平台。

## ✨ 功能特色

### 📖 多线叙事
- 交互式故事分支选择
- 每个选择影响故事走向
- 多种结局体验
- 故事进度追踪

### 📝 词生万物
- 关键词生成AI微小说
- 自动生成配图
- 作品保存与历史记录
- 支持OpenAI API集成

### 🎩 文字魔术
- 中世纪卷轴风格
- 二进制密文转换
- emoji谜语生成
- 镜像反转效果
- 黑客体转换

## 🚀 快速开始

### 环境要求
- Node.js >= 14.0.0
- npm >= 6.0.0

### 安装步骤

1. **克隆项目**
```bash
git clone https://github.com/your-username/inspiration-generator.git
cd inspiration-generator
```

2. **安装依赖**
```bash
npm install
```

3. **配置环境变量**
```bash
cp env.example .env
# 编辑 .env 文件，配置必要的API密钥
```

4. **启动服务器**
```bash
# 开发模式
npm run dev

# 生产模式
npm start
```

5. **访问应用**
- 前端页面: http://localhost:3000/M.html
- API健康检查: http://localhost:3000/api/health

## 🔧 配置说明

### 环境变量配置

创建 `.env` 文件并配置以下变量：

```env
# 服务器配置
PORT=3000
NODE_ENV=development

# OpenAI API配置（可选，用于增强AI生成能力）
OPENAI_API_KEY=your_openai_api_key_here

# 安全配置
JWT_SECRET=your_jwt_secret_here
CORS_ORIGIN=http://localhost:3000
```

### API密钥获取

1. **OpenAI API密钥**（可选）
   - 访问 [OpenAI官网](https://platform.openai.com/)
   - 注册账号并获取API密钥
   - 配置到 `.env` 文件中

## 📚 API文档

### 基础接口

#### 健康检查
```http
GET /api/health
```

#### 数据导出
```http
GET /api/export
```

#### 数据导入
```http
POST /api/import
Content-Type: application/json

{
  "storyChoices": [...],
  "aiWordHistory": [...],
  "magicHistory": [...]
}
```

### 故事相关接口

#### 保存故事选择
```http
POST /api/story/choice
Content-Type: application/json

{
  "storyId": 1,
  "branchId": 2,
  "choice": "喂它一颗电池"
}
```

#### 获取故事统计
```http
GET /api/story/stats
```

### AI词生万物接口

#### 生成AI内容
```http
POST /api/aiword/generate
Content-Type: application/json

{
  "keyword": "星空"
}
```

响应示例：
```json
{
  "keyword": "星空",
  "story": "在星空的夜晚，一只猫悄悄跃上屋顶...",
  "imageUrl": "https://source.unsplash.com/400x300/?星空,fantasy",
  "timestamp": "2024-01-15T10:30:00.000Z"
}
```

#### 保存AI作品
```http
POST /api/aiword/save
Content-Type: application/json

{
  "keyword": "星空",
  "story": "故事内容...",
  "imageUrl": "图片URL"
}
```

#### 获取AI作品历史
```http
GET /api/aiword/history
```

### 文字魔术接口

#### 文字变换
```http
POST /api/magic/transform
Content-Type: application/json

{
  "text": "你好，世界！",
  "type": "scroll"
}
```

支持的变换类型：
- `scroll`: 中世纪卷轴
- `binary`: 二进制密文
- `emoji`: emoji谜语
- `reverse`: 镜像反转
- `leet`: 黑客体

#### 获取魔术历史
```http
GET /api/magic/history
```

## 🛠️ 开发指南

### 项目结构
```
inspiration-generator/
├── server.js          # 主服务器文件
├── package.json       # 项目配置
├── env.example        # 环境变量示例
├── README.md          # 项目文档
├── M.html            # 前端页面
└── public/           # 静态资源目录
```

### 开发模式
```bash
npm run dev
```

### 代码规范
- 使用ES6+语法
- 遵循RESTful API设计规范
- 添加适当的错误处理
- 编写清晰的注释

## 🚀 部署指南

### 本地部署
1. 确保Node.js环境已安装
2. 运行 `npm install` 安装依赖
3. 配置 `.env` 文件
4. 运行 `npm start` 启动服务

### 云服务器部署

#### 使用PM2部署
```bash
# 安装PM2
npm install -g pm2

# 启动应用
pm2 start server.js --name "inspiration-generator"

# 设置开机自启
pm2 startup
pm2 save
```

#### 使用Docker部署
```dockerfile
FROM node:16-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm", "start"]
```

```bash
# 构建镜像
docker build -t inspiration-generator .

# 运行容器
docker run -p 3000:3000 inspiration-generator
```

### 生产环境配置
1. 设置 `NODE_ENV=production`
2. 配置数据库连接（可选）
3. 设置反向代理（Nginx）
4. 配置SSL证书
5. 设置日志记录

## 🔒 安全考虑

1. **API密钥保护**
   - 不要将API密钥提交到代码仓库
   - 使用环境变量存储敏感信息

2. **输入验证**
   - 对所有用户输入进行验证
   - 防止XSS和注入攻击

3. **CORS配置**
   - 正确配置跨域请求
   - 限制允许的域名

4. **速率限制**
   - 实现API调用频率限制
   - 防止恶意请求

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🙏 致谢

- [OpenAI](https://openai.com/) - 提供AI API服务
- [Unsplash](https://unsplash.com/) - 提供图片服务
- [Font Awesome](https://fontawesome.com/) - 提供图标

## 📞 联系方式

- 项目主页: https://github.com/your-username/inspiration-generator
- 问题反馈: https://github.com/your-username/inspiration-generator/issues
- 邮箱: your-email@example.com

---

⭐ 如果这个项目对你有帮助，请给它一个星标！