# gc27c

**Repository Path**: violet27chen/gc27c

## Basic Information

- **Project Name**: gc27c
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 27c剧本生成平台

## 项目简介

27c剧本生成平台是一个基于人工智能技术的专业剧本创作工具，专门用于生成符合27c格式规范的修仙题材剧本。本平台集成了先进的AI模型和严格的内容质量控制体系，能够帮助创作者快速生成高质量、格式规范的剧本内容。平台采用现代化的Web技术栈，提供流畅的用户体验和强大的创作功能。

本项目的核心目标是为剧本创作者提供一个智能化、标准化的创作环境，通过AI技术降低创作门槛，提高创作效率，同时确保生成的剧本内容符合行业标准的27c格式规范。平台支持从大纲设计到分镜细化的完整创作流程，为用户提供一站式的剧本创作解决方案。

## 功能特性

### 剧本生成功能

#### 大纲生成模块
大纲生成模块是平台的核心功能之一，能够根据用户提供的基础信息智能生成完整的剧本大纲。该模块采用先进的自然语言处理技术，分析用户输入的故事背景、人物设定、世界观等关键信息，自动构建符合修仙题材特点的剧情结构。

大纲生成功能包括剧情走向设计、人物关系构建、世界观设定、冲突点安排等多个方面。系统会根据修仙题材的经典套路和创新元素，生成具有完整故事弧线和逻辑连贯性的大纲内容。用户可以在生成后对大纲进行编辑和调整，确保大纲内容符合创作预期。

#### 剧集创作模块
剧集创作模块支持用户根据大纲生成具体的剧集内容，支持1-60集的完整剧集生成。每个剧集包含详细的分镜描述、对话内容、动作描述等要素。系统采用流式生成技术，用户可以实时查看生成进度和内容质量。

剧集创作功能具有高度的灵活性和可定制性，用户可以根据需要调整剧集数量、内容密度、风格倾向等参数。系统会根据27c格式规范自动生成符合标准的分镜内容，包括分镜编号、场景描述、人物对话、内心独白、旁白等要素。

#### 内容润色模块
内容润色模块为用户提供了强大的内容编辑和优化功能。用户可以选择在指定位置插入新内容、修改现有内容、优化内容质量等。润色功能支持剧集级别的插入和分镜级别的精确插入，确保用户能够精确控制内容的修改位置。

润色模块采用智能上下文分析技术，能够准确理解现有内容的语境和风格，生成与原内容风格一致、逻辑连贯的新内容。系统会根据27c格式规范自动修正格式错误，确保生成的内容符合行业标准。

### 27c格式规范

#### 格式要求详解
27c格式是剧本创作行业的标准格式规范，具有严格的结构要求和格式标准。平台对27c格式进行了深入的研究和实现，确保生成的内容完全符合格式规范。

分镜格式要求使用"分镜号：X-Y"的格式，其中X代表集数，Y代表分镜序号。场景格式要求使用"场景：时间/地点，人物/内或外"的格式，明确标注场景的时间、地点、人物和内外景别。动作描述必须以"△"符号开头，后跟全角空格和具体的动作内容。对话格式要求使用"角色名（情绪）：对话内容"的格式，明确标注说话角色和情绪状态。内心独白使用"角色名OS（情绪）：内心独白"的格式，旁白使用"角色名VO（语气）：旁白内容"的格式。

#### 质量控制体系
平台建立了完善的质量控制体系，确保生成的内容符合高质量标准。每个分镜要求包含20-30行有效内容，确保内容充实度和细节丰富度。系统会自动检查内容的连贯性，确保情节逻辑合理、人物性格一致、故事发展自然。

格式验证功能会严格检查每行内容的格式规范，包括标点符号使用、缩进格式、特殊符号等要素。内容审核功能会评估内容的质量、创新性、合规性等多个维度，确保生成的内容符合平台标准和用户期望。

### 用户行为分析系统

#### 数据收集机制
平台建立了完整的用户行为分析系统，能够收集和分析用户在平台上的各种行为数据。数据收集包括页面浏览记录、按钮点击行为、内容生成操作、会话管理信息、错误追踪记录等多个维度。

页面浏览记录会追踪用户访问的页面、停留时间、滚动行为等信息，帮助了解用户的使用习惯和偏好。按钮点击行为记录会追踪用户点击的各种按钮、触发的功能、操作的时间等信息，帮助分析功能使用情况。内容生成操作记录会追踪用户生成内容的类型、参数设置、生成质量等信息，帮助优化AI模型参数。

#### 数据分析功能
数据分析功能提供了丰富的统计分析能力，包括使用统计分析、功能偏好分析、性能监控分析、用户画像分析等多个方面。使用统计分析会统计平台的日活跃用户、月活跃用户、使用时长等关键指标。功能偏好分析会分析用户对不同功能的使用频率和偏好程度，帮助优化功能设计。

性能监控分析会监控系统的响应时间、错误率、资源使用情况等性能指标，确保系统稳定运行。用户画像分析会基于用户的行为数据构建用户画像，了解用户的特点和需求，提供个性化的服务体验。

## 技术架构

### 前端技术栈
平台前端采用现代化的技术栈，包括React 18、Next.js 15.5、TypeScript、Tailwind CSS等技术。React 18提供了现代化的组件化开发模式，支持并发特性和自动批处理，提高了应用的性能和用户体验。Next.js 15.5作为全栈React框架，提供了服务端渲染、静态生成、API路由等功能，简化了开发流程。

TypeScript为项目提供了类型安全保障，减少了运行时错误，提高了代码的可维护性。Tailwind CSS提供了实用优先的样式系统，支持快速开发和响应式设计。Lucide Icons提供了现代化的图标库，支持多种图标风格和尺寸。

### 后端技术架构
后端采用Next.js API Routes构建服务端API，提供了完整的RESTful API接口。API支持流式响应技术，能够实时传输AI生成的内容，提供流畅的用户体验。内存存储方案提供了高效的数据存储能力，支持用户行为数据、会话信息、临时数据等的存储。

错误处理机制采用分层设计，包括全局错误处理、API错误处理、组件错误处理等多个层次，确保系统的稳定性和可靠性。日志记录功能会详细记录系统运行的各种信息，便于问题排查和性能优化。

### AI集成技术
平台集成了MIMO AI API，提供了先进的AI模型接口。AI集成采用流式生成技术，能够实时传输生成的内容，提供即时的用户反馈。智能提示功能基于上下文感知技术，能够根据用户输入和历史记录提供智能化的提示和建议。

质量控制采用多层次的设计，包括输入验证、输出过滤、格式检查、内容审核等多个环节，确保生成内容的质量和合规性。AI参数优化功能支持温度调节、令牌限制、概率控制等参数的调整，满足不同场景的需求。

## 系统部署

### 环境要求
平台对运行环境有一定的要求，建议使用Node.js 18.0.0或更高版本，推荐使用Node.js 20.0.0版本。内存要求最低4GB RAM，推荐8GB以上，确保系统运行流畅。存储空间要求最低2GB可用磁盘空间，推荐5GB以上，用于存储日志文件、用户数据等。网络连接要求稳定的互联网连接，确保AI API调用的稳定性。

支持的操作系统包括Windows 10/11、macOS 10.15+、Ubuntu 18.04+等主流操作系统。推荐使用Windows 11、macOS 12+、Ubuntu 20.04+等较新版本，以获得更好的性能和兼容性。

### 安装部署流程
安装部署流程包括环境准备、项目获取、依赖安装、环境配置、服务启动等步骤。环境准备需要安装Node.js运行环境，建议使用nvm进行版本管理。项目获取可以通过Git克隆仓库地址：https://github.com/violettoolssite/gc27c.git

依赖安装使用npm install命令安装项目所需的各种依赖包。环境配置需要创建.env.local文件，配置MIMO AI API密钥、API地址、模型名称等关键参数。服务启动使用npm run dev命令启动开发服务器，或使用npm run build和npm start命令启动生产服务器。

生产环境部署建议使用PM2进程管理工具，提供进程监控、自动重启、日志管理等功能。部署前需要进行充分的测试，确保系统在各种场景下的稳定性和可靠性。

## 使用指南

### 基础操作流程
基础操作流程包括访问平台、创建剧本、生成大纲、生成剧集、内容编辑等步骤。用户首先通过浏览器访问平台地址，进入主界面。在主界面输入剧本的基础信息，包括故事背景、人物设定、世界观等关键信息。

选择生成模式，平台提供大纲先行和直接生成两种模式。大纲先行模式先生成大纲内容，用户确认后再生成剧集内容。直接生成模式跳过大纲确认步骤，直接生成剧集内容。点击生成大纲按钮，系统会调用AI模型生成大纲内容，用户可以在生成后进行编辑和调整。

设置剧集数量，支持1-60集的完整剧集生成。点击开始生成剧集按钮，系统会开始逐集生成内容，用户可以实时查看生成进度和内容质量。生成完成后，用户可以对剧集内容进行编辑、润色、重新生成等操作。

### 高级功能使用
高级功能包括内容润色、重新生成、复制功能、数据分析等。内容润色功能支持在指定位置插入新内容，用户可以选择剧集级别或分镜级别的插入位置。重新生成功能支持对不满意的内容进行重新生成，保持其他部分不变。

复制功能支持将各部分内容复制到剪贴板，方便用户在其他编辑器中使用。数据分析功能提供用户行为统计、使用情况分析、性能监控等数据洞察，帮助用户了解平台使用情况。

### 配置管理
配置管理包括环境变量配置、AI参数配置、格式规范配置等。环境变量配置包括MIMO AI API密钥、API地址、模型名称等必需配置，以及开发环境、端口号、分析配置等可选配置。

AI参数配置包括温度、最大令牌数、概率控制等参数，影响AI生成内容的质量和风格。格式规范配置包括每行最小字数、最大字数、必需元素、格式严格性等参数，确保生成内容符合27c格式规范。

## 故障排除

### 常见问题解决方案
常见问题包括API连接失败、内容质量不佳、页面加载缓慢、数据丢失等。API连接失败通常由API密钥错误、网络不稳定、API服务异常等原因造成，解决方案包括检查API密钥、验证网络连接、确认API服务状态。

内容质量不佳通常由输入提示词不当、AI参数设置不合理、格式规范配置错误等原因造成，解决方案包括优化提示词、调整AI参数、检查格式配置。页面加载缓慢通常由网络连接问题、浏览器缓存问题、服务器性能问题等原因造成，解决方案包括检查网络连接、清除浏览器缓存、重启服务器。

数据丢失通常由存储路径错误、文件权限问题、应用重启等原因造成，解决方案包括检查存储路径、验证文件权限、重启应用恢复数据。

### 错误代码说明
API错误代码包括401（API密钥无效）、429（请求频率过高）、500（服务器内部错误）等。系统错误代码包括ECONNREFUSED（网络连接被拒绝）、ENOENT（文件不存在）、EMFILE（文件描述符耗尽）等。每种错误代码都有对应的解决方案和处理建议。

## 项目仓库

本项目托管在GitHub平台上，仓库地址为：https://github.com/violettoolssite/gc27c.git

用户可以通过该仓库获取项目源代码、提交问题反馈、参与项目开发。仓库包含完整的项目文档、代码示例、部署指南等资源，为用户和开发者提供全面的技术支持。

项目采用MIT许可证，允许用户自由使用、修改和分发代码。欢迎社区贡献和改进，共同完善27c剧本生成平台的功能和体验。

## 功能特性

### 📝 剧本生成功能

#### 1. 大纲生成
- **智能分析**：根据用户提供的基础信息，智能分析剧情走向
- **结构设计**：自动设计符合修仙题材的剧情结构
- **人物设定**：生成完整的人物关系和性格设定
- **世界观构建**：构建完整的修仙世界观设定

#### 2. 剧集创作
- **逐集生成**：支持1-60集的完整剧集生成
- **分镜细化**：每集包含详细的分镜描述
- **对话生成**：生成符合角色性格的对话内容
- **动作描述**：详细的动作和场景描述

#### 3. 内容润色
- **智能插入**：支持在指定位置插入新内容
- **内容优化**：优化现有内容的质量和连贯性
- **格式修正**：自动修正格式错误
- **内容扩充**：根据需求扩充特定情节内容

### 🎨 27c格式规范

#### 格式要求
- **分镜格式**：`分镜号：X-Y`（X为集数，Y为分镜序号）
- **场景格式**：`场景：时间/地点，人物/内或外`
- **动作描述**：`△` + 全角空格 + 动作内容
- **对话格式**：`角色名（情绪）：对话内容`
- **内心独白**：`角色名OS（情绪）：内心独白`
- **旁白格式**：`角色名VO（语气）：旁白内容`

#### 质量控制
- **内容密度**：每个分镜20-30行有效内容
- **连贯性检查**：确保情节逻辑连贯
- **格式验证**：严格验证27c格式规范
- **内容审核**：智能内容质量评估

### 📊 用户行为分析

#### 数据收集
- **页面浏览**：记录用户页面访问行为
- **操作追踪**：记录按钮点击、内容生成等操作
- **会话管理**：完整的用户会话生命周期管理
- **错误追踪**：系统错误和异常记录

#### 数据分析
- **使用统计**：平台使用频率和活跃度分析
- **功能偏好**：用户功能使用偏好分析
- **性能监控**：系统性能和响应时间监控
- **用户画像**：基于行为数据的用户画像分析

### 🛠 技术特性

#### 前端技术
- **React 18**：现代化的前端框架
- **Next.js 15.5**：全栈React框架
- **TypeScript**：类型安全的JavaScript
- **Tailwind CSS**：实用优先的CSS框架
- **Lucide Icons**：现代化图标库

#### 后端技术
- **Next.js API Routes**：服务端API
- **流式响应**：实时内容传输
- **内存存储**：高效的数据存储方案
- **错误处理**：完善的错误处理机制

#### AI集成
- **MIMO AI API**：先进的AI模型接口
- **流式生成**：实时内容生成
- **智能提示**：上下文感知的智能提示
- **质量控制**：多层次的内容质量保证

## 📦 系统要求

### 最低配置
- **操作系统**：Windows 10/11、macOS 10.15+、Ubuntu 18.04+
- **Node.js**：18.0.0 或更高版本
- **内存**：4GB RAM（推荐8GB+）
- **存储**：2GB可用磁盘空间
- **网络**：稳定的互联网连接

### 推荐配置
- **操作系统**：Windows 11、macOS 12+、Ubuntu 20.04+
- **Node.js**：20.0.0 或更高版本
- **内存**：16GB RAM
- **存储**：5GB可用磁盘空间
- **网络**：高速稳定的互联网连接

## 🛠 安装部署

### 1. 环境准备

#### 安装Node.js
```bash
# 使用nvm安装Node.js（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

# 或直接从官网下载安装
# https://nodejs.org/
```

#### 验证安装
```bash
node --version
npm --version
```

### 2. 项目部署

#### 克隆项目
```bash
git clone <项目地址>
cd 27c剧本生成
```

#### 安装依赖
```bash
npm install
```

#### 环境配置
创建环境变量文件 `.env.local`：
```env
# MIMO AI API配置
MIMO_API_KEY=your_api_key_here
MIMO_API_URL=https://token-plan-cn.xiaomimimo.com/v1
MIMO_MODEL=mimo-v2.5-pro

# 其他配置（可选）
NODE_ENV=development
PORT=3000
```

#### 启动开发服务器
```bash
npm run dev
```

### 3. 生产部署

#### 构建生产版本
```bash
npm run build
```

#### 启动生产服务器
```bash
npm start
```

#### 使用PM2部署（推荐）
```bash
# 安装PM2
npm install -g pm2

# 启动应用
pm2 start npm --name "27c-script-generator" -- start

# 查看状态
pm2 status

# 查看日志
pm2 logs

# 重启应用
pm2 restart 27c-script-generator
```

## 🎮 使用指南

### 1. 基础使用

#### 访问平台
打开浏览器访问 `http://localhost:3000`

#### 创建剧本
1. 在主界面输入剧本基础信息
2. 选择生成模式（大纲先行或直接生成）
3. 点击"生成大纲"按钮
4. 等待AI生成大纲内容

#### 生成剧集
1. 在大纲界面确认大纲内容
2. 设置剧集数量（1-60集）
3. 点击"开始生成剧集"
4. 实时查看生成进度

### 2. 高级功能

#### 内容润色
1. 在剧本编辑界面选择"润色模式"
2. 输入润色需求描述
3. 选择插入位置（指定剧集/分镜前后）
4. 点击"生成润色内容"
5. 确认并插入新内容

#### 重新生成
1. 在不满意的内容旁点击"重新生成"
2. 系统会重新生成该部分内容
3. 保持其他部分不变

#### 复制功能
1. 点击各部分的"复制"按钮
2. 自动复制到剪贴板
3. 可直接粘贴到其他编辑器

### 3. 数据分析

#### 查看分析数据
1. 访问 `http://localhost:3000/analytics`
2. 查看用户行为统计数据
3. 分析平台使用情况

#### 数据导出
```bash
# 数据文件位置
./data/analytics/
├── sessions.json    # 会话数据
└── summary.json     # 汇总数据
```

## 🔧 配置说明

### 环境变量配置

#### 必需配置
```env
MIMO_API_KEY=your_mimo_api_key
MIMO_API_URL=https://token-plan-cn.xiaomimimo.com/v1
MIMO_MODEL=mimo-v2.5-pro
```

#### 可选配置
```env
# 开发环境配置
NODE_ENV=development
PORT=3000

# 分析配置
ANALYTICS_ENABLED=true
ANALYTICS_BATCH_SIZE=10
ANALYTICS_FLUSH_INTERVAL=30000

# AI配置
AI_TEMPERATURE=0.85
AI_MAX_TOKENS=4000
AI_STREAM_ENABLED=true
```

### 自定义配置

#### 修改AI参数
编辑 `app/api/` 目录下的API路由文件：
```typescript
// 修改AI参数
const aiConfig = {
  temperature: 0.85,
  max_tokens: 4000,
  top_p: 0.9,
  frequency_penalty: 0.1,
  presence_penalty: 0.1
}
```

#### 修改格式规范
编辑 `app/api/polish/route.ts` 中的格式要求：
```typescript
// 自定义格式要求
const formatRules = {
  minLinesPerScene: 20,
  maxLinesPerScene: 30,
  requiredElements: ['scene', 'action', 'dialogue'],
  strictFormat: true
}
```

## 🐛 故障排除

### 常见问题

#### 1. API连接失败
**问题**：AI生成内容时出现连接错误
**解决方案**：
- 检查MIMO_API_KEY是否正确
- 验证网络连接是否稳定
- 确认API服务是否正常

#### 2. 生成内容质量差
**问题**：AI生成的内容不符合预期
**解决方案**：
- 优化输入提示词
- 调整AI参数（temperature等）
- 检查格式规范设置

#### 3. 页面加载缓慢
**问题**：页面响应速度慢
**解决方案**：
- 检查网络连接
- 清除浏览器缓存
- 重启开发服务器

#### 4. 分析数据丢失
**问题**：用户行为数据丢失
**解决方案**：
- 检查数据存储路径
- 验证文件权限
- 重启应用恢复数据

### 错误代码

#### API错误
- `401`：API密钥无效
- `429`：请求频率过高
- `500`：服务器内部错误

#### 系统错误
- `ECONNREFUSED`：网络连接被拒绝
- `ENOENT`：文件不存在
- `EMFILE`：文件描述符耗尽

## 📈 性能优化

### 前端优化
- **代码分割**：按需加载组件
- **图片优化**：压缩和懒加载图片
- **缓存策略**：合理设置浏览器缓存
- **Bundle优化**：优化打包大小

### 后端优化
- **API缓存**：缓存常用API响应
- **数据库优化**：优化查询性能
- **并发控制**：合理控制并发请求
- **内存管理**：及时释放内存资源

### AI优化
- **提示词优化**：优化AI提示词质量
- **参数调优**：调整AI模型参数
- **流式传输**：使用流式传输减少延迟
- **批量处理**：批量处理AI请求

## 🔒 安全考虑

### 数据安全
- **API密钥保护**：妥善保管API密钥
- **数据加密**：敏感数据加密存储
- **访问控制**：实施访问权限控制
- **日志审计**：记录操作日志

### 隐私保护
- **数据匿名化**：用户数据匿名化处理
- **最小权限**：只收集必要数据
- **数据清理**：定期清理过期数据
- **合规性**：符合数据保护法规

## 📞 技术支持

### 联系方式
- **技术支持**：通过GitHub Issues提交问题
- **功能建议**：通过项目讨论区提交建议
- **Bug报告**：提供详细的错误信息和复现步骤

### 文档更新
- **版本更新**：关注项目版本更新
- **文档同步**：文档与代码保持同步
- **社区贡献**：欢迎社区贡献和改进

## 📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

## 🙏 致谢

感谢以下开源项目和技术社区的支持：
- Next.js 团队
- React 社区
- MIMO AI 平台
- 所有贡献者和用户

---

**注意**：本平台仅用于学习和创作目的，请遵守相关法律法规和平台使用条款。