PlotCompass（灵感罗盘）是一款基于 AI 大模型的智能小说创作辅助工具。它能够帮助创作者生成小说大纲、章节草稿、人物关系图谱，并提供情节润色、分支推演、结构优化等多种创作辅助功能。
- 🎯 项目创世 - 基于灵感源泉生成完整的 10 卷 100 章小说蓝图
- 📝 章节创作 - AI 辅助生成章节草稿，支持上下文关联
- 🌳 情节分支 - 智能推演多个后续情节分支，激发创作灵感
- ✍️ 内容润色 - 一键生成多个润色版本，提升文笔质量
- 🔀 结构重构 - 优化叙事逻辑，提取伏笔和关键线索
- ⚡ 冲突注入 - 为情节注入激烈冲突点或反转方案
- 🕸️ 关系图谱 - 可视化人物关系网络，清晰展示角色互动
- 🔌 多模型支持 - 支持 Gemini、DeepSeek、Qwen（通义千问）、OpenRouter
- 💾 项目导出 - 支持导出为 ZIP 格式，方便备份和分享
- 前端框架: React 19 + TypeScript
- 构建工具: Vite 6
- AI 模型集成:
- Google Gemini API (@google/genai)
- OpenAI 兼容接口（DeepSeek、Qwen、OpenRouter）
- 数据处理: JSZip（项目导出）
- 样式: 现代化响应式 CSS
- Node.js (推荐 v16 或更高版本)
- 至少一个 AI 服务的 API Key（Gemini / DeepSeek / Qwen / OpenRouter）
- 克隆仓库
git clone https://github.com/xiaochenwin/Qoder-PlotCompass.git
cd Qoder-PlotCompass- 安装依赖
npm install- 配置 API Key
有两种配置方式：
方式一：环境变量配置（推荐）
复制 .env.example 为 .env.local 并填入您的 API Key：
cp .env.example .env.local编辑 .env.local：
# Gemini API 密钥 (Google AI Studio)
GEMINI_API_KEY=AIza...
# DeepSeek API 密钥
DEEPSEEK_API_KEY=sk-...
# Qwen API 密钥 (阿里云百炼)
QWEN_API_KEY=sk-...
# OpenRouter API 密钥
OPENROUTER_API_KEY=sk-...方式二：界面配置
启动应用后，点击右上角的 "API 配置" 按钮，在界面中输入 API Key。
- 启动开发服务器
npm run dev- 访问应用
在浏览器中打开：http://localhost:3000
npm run build
npm run preview- Gemini: https://aistudio.google.com/apikey
- DeepSeek: https://platform.deepseek.com/api_keys
- Qwen（通义千问）: https://bailian.console.aliyun.com/
- OpenRouter: https://openrouter.ai/keys
-
项目创世
- 输入灵感源泉（如："一个关于时空旅行者的故事"）
- 选择题材类型（科幻、奇幻、现代等）
- 选择 AI 模型并生成完整小说蓝图
-
章节创作
- 点击章节标题生成草稿
- 支持基于前文内容的连贯创作
-
内容优化
- 选中文本后使用润色、分支、结构、冲突等功能
- 采纳合适的建议并插入到文档中
-
关系图谱
- 查看和分析人物关系网络
- 直观了解角色互动和故事结构
-
项目导出
- 将整个创作项目导出为 ZIP 文件
- 支持后续导入继续创作
plotcompass-(灵感罗盘)/
├── components/ # React 组件
│ ├── ApiKeyConfigModal.tsx # API 配置模态框
│ ├── BranchCard.tsx # 情节分支卡片
│ ├── ProjectGenesisModal.tsx # 项目创世模态框
│ └── RelationMap.tsx # 人物关系图谱
├── services/ # 服务层
│ ├── apiKeyManager.ts # API 密钥管理
│ └── geminiService.ts # AI 服务调用
├── App.tsx # 主应用组件
├── types.ts # TypeScript 类型定义
├── index.tsx # 应用入口
├── vite.config.ts # Vite 配置
├── package.json # 项目依赖
└── README.md # 项目文档
- API Key 使用 Base64 + 盐值进行基础加密
- 所有密钥存储在本地浏览器 localStorage 中
- 不会上传到任何服务器
- 建议使用环境变量配置 API Key，降低泄露风险
欢迎提交 Issue 和 Pull Request！
MIT License
- Google Gemini - 提供强大的 AI 能力
- DeepSeek - 高性能语言模型
- 阿里云通义千问 - 中文优化模型
- OpenRouter - 多模型聚合平台
用 ❤️ 打造，为创作者赋能
Made with ❤️ for Writers