故事熔炉功能全景指南
历史资料
本页从原 WPS 知识库迁移，用于保留历史记录。内容可能对应旧版本，不应单独作为当前功能状态依据；当前能力请优先查看“开始使用”“功能指南”和仓库最新 Changelog。
版本：2026-05-28 | 代码规模：238 个源文件 / 48,170 行 / 36 张数据表
本文档覆盖 StoryForge 的每一个功能、每一个细节、每一个功能间的联动逻辑。
适用于：作者自查、团队内部对齐、推广材料底稿。
目录
[一、产品定位与技术架构](#一产品定位与技术架构)
[二、项目首页](#二项目首页)
[三、著作信息](#三著作信息)
[四、设定库 — 世界观](#四设定库--世界观)
[五、设定库 — 故事设计](#五设定库--故事设计)
[六、设定库 — 道具系统](#六设定库--道具系统)
[七、设定库 — 角色设计](#七设定库--角色设计)
[八、创作区 — 创作规则](#八创作区--创作规则)
[九、创作区 — 大纲](#九创作区--大纲)
[十、创作区 — 故事线](#十创作区--故事线)
[十一、创作区 — 章节编辑](#十一创作区--章节编辑)
[十二、创作区 — 伏笔](#十二创作区--伏笔)
[十三、创作区 — 状态表](#十三创作区--状态表)
[十四、提示词库](#十四提示词库)
[十五、设置区](#十五设置区)
[十六、AI 引擎层](#十六ai-引擎层)
[十七、数据安全体系](#十七数据安全体系)
[十八、功能联动全景图](#十八功能联动全景图)
一、产品定位与技术架构
1.1 是什么
StoryForge 是一个纯浏览器端的 AI 辅助长篇小说创作工具。用户在浏览器里完成从世界观构建到章节写作的全流程，AI 在每个环节提供辅助生成，但最终决策权始终在作者手中。
1.2 核心设计理念
纯前端，零后端：所有数据存在浏览器 IndexedDB 中，不经过任何服务器。用户的创作内容只存在于自己的设备上。
AI 是助手，不是代笔：每次 AI 生成的结果都以"预览→确认→编辑"的方式呈现，用户可以采纳、修改或丢弃。
全链路上下文感知：写正文时，AI 自动读取世界观、角色设定、大纲、伏笔状态、创作规则，确保生成内容与已有设定一致。
提示词完全可定制：所有 AI 调用的 prompt 都在「提示词库」中公开，用户可以查看、修改、替换。
1.3 技术栈
| 层 | 技术 |
| 框架 | React 18 + TypeScript + Vite |
| 状态管理 | Zustand（20 个 Store） |
| 本地数据库 | Dexie.js（IndexedDB 封装），36 张表 |
| AI 调用 | OpenAI 兼容协议，流式 SSE |
| UI | Tailwind CSS + Lucide Icons |
| 部署 | Vercel（静态站点），支持 PWA 离线 |
1.4 兼容的 AI 平台（13 家）
| 平台 | 默认模型 | 特点 |
| DeepSeek | deepseek-v4-flash | 国产首选，性价比极高 |
| 通义千问（Qwen） | qwen-max | 阿里云，中文理解强 |
| 豆包（Doubao） | doubao-pro-32k | 字节跳动，适合对话 |
| MiniMax | MiniMax-Text-01 | 245K 超长上下文 |
| 智谱（GLM） | glm-4-flash | 免费额度，适合试用 |
| 文心一言（Wenxin） | ernie-4.0-8k | 百度，中文基础好 |
| Gemini | gemini-2.5-flash | Google，100 万上下文窗口 |
| Poe | GPT-4o | 聚合平台 |
| OpenAI | gpt-4o | 英文最强 |
| Kimi（月之暗面） | moonshot-v1-8k | 长文处理优秀 |
| Claude | claude-sonnet-4 | Anthropic，推理强 |
| ModelScope | Qwen3-235B-A22B | 免费 |
| Ollama | qwen2.5:7b | 本地部署，完全离线 |
所有平台均通过 OpenAI 兼容 API 接入，用户只需填写 API Key 和选择平台即可。支持自定义 Base URL，可接入任何兼容接口。
二、项目首页
2.1 项目列表
打开 StoryForge 后看到的第一个页面。展示所有创建的小说项目，按最近更新时间排序。
每个项目卡片显示：
项目名称 + 首字符装饰图标（自动生成的彩色圆形）
流派标签（如"仙侠""言情"）
写作状态标签（构思中 / 撰写中 / 修改中 / 已完结）
目标字数
最近更新时间
2.2 创建项目
点击「+ 新建项目」弹出创建对话框：
项目名称：必填
简介：一句话描述故事
流派：多选标签，内置 12 个常用流派（仙侠、言情、悬疑推理、科幻、历史、都市、玄幻、武侠、末世、重生、系统流、西幻），支持自定义流派
目标字数：滑动条选择（10 万 ~ 500 万）
创作模式：幻想模式 / 历史考证模式（影响后续世界观面板的字段和 AI 行为）
小巧思：创作模式不是装饰——选「历史考证」后，世界观三个面板的字段会从"世界结构/力量体系/神明设计"切换为"朝代/政治体制/科举制度"等历史研究向字段，AI 的 system prompt 也会从"你是玄幻世界观架构师"切换为"你是历史学家"。
三、著作信息
3.1 项目概况
项目的"身份证"页面，可随时修改：
项目名称、简介
流派多选标签（与创建时同款）
目标字数
写作状态切换
创作模式切换（幻想 ↔ 历史考证）
3.2 项目参考
管理与本项目相关的参考资料。支持三种类型：
| 类型 | 用途 | 图标颜色 |
| 故事参考 | 剧情结构、人物塑造的范本 | 蓝色 |
| 风格参考 | 文笔风格、叙事技巧的范本 | 紫色 |
| 历史资料 | 历史考证用的文献 | 琥珀色 |
每个参考书的信息：
书名、作者、类型
可手动录入关键笔记
支持 AI 导入解析（上传 TXT 文件 → AI 自动提取世界观/角色/大纲）
3.2.1 深度分析
参考书的核心功能——十三维 AI 深度分析：
上传参考作品的原文（TXT），系统按设定的深度（快速/标准/精细）分块，逐块调用 AI 做多维分析：
通用八维：
叙事架构
开篇与黄金三章
情节结构与节奏
人物塑造
冲突与升级
伏笔与悬念
文笔与对话
世界观构建
历史资料专属五维（仅历史类型参考书显示）：
历史背景与时代特征
社会制度与等级
日常生活细节
物质文化（器物/科技）
语言习惯与称谓
分析结果按维度 Tab 展示，每个维度下有多个分块的分析条目。
联动逻辑：分析结果不是孤立的——在「创作规则」面板中，用户可以勾选参考书，被勾选的参考书的分析结论会被自动注入 AI 写作的上下文中。相当于告诉 AI："写的时候参考这本书的手法。"
3.2.2 作品学习（大师研究）
入口整合在「项目参考」面板中，但功能独立。上传已完成的名家作品原文进行深度拆解。
三层分析架构：
| 层级 | 内容 | 方式 |
| Layer 1：五维方法论 | 世界观范式、角色设计手法、情节节奏规律、伏笔悬念、文笔语言 | AI 逐块分析 |
| Layer 2：深度量化 | 风格画像（句长分布、对话占比、高频词、段落密度）+ 章节节奏点时间线（开场/冲突/反转/高潮/钩子/伏笔/松弛） | 风格=本地计算；节奏=AI |
| Layer 3：跨作品洞察 | 多本作品的共性方法论归纳（如"猫腻式插叙节奏法则"） | AI 归纳 |
特色功能：
Blob 持久化：上传的原文 Blob 存入 IndexedDB，关闭浏览器后重开可续跑未完成的分析
断点续传：如果分析中途断了（网络/取消），下次从断点继续，已分析的块不会重复调用
分析专用模型：可在学习设置中单独配置低成本模型（如 GLM-4 Flash 免费），不影响全局写作模型
费用预估：上传文件后、分析前，展示预估 Token 消耗和费用
导出 ZIP 报告：分析结果可导出为 ZIP（含 JSON 数据 + 人读的 Markdown 报告）
联动逻辑：Layer 3 生成的洞察可在「创作规则」面板中被勾选引用，AI 写作时自动注入方法论要点。
四、设定库 — 世界观
世界观分为三个子面板，各有独立入口，共同构成完整的世界设定。
4.1 世界起源
幻想模式下的字段：
世界起源传说
力量体系层级
神明设定（最高神/诸神/信仰体系/凡人关系）
历史考证模式下的字段：
朝代与政权
政治体制
法律与刑罚
每个字段都支持单字段 AI 生成：点击字段旁的 ✨ 按钮，AI 根据已有的其他字段内容生成该字段。生成结果以流式方式展示（打字机效果），用户可实时看到输出，满意后点击采纳。
小巧思：AI 生成某个字段时，会自动读取同面板中其他已填写的字段作为上下文。比如你先填了"力量体系层级"，再生成"世界起源传说"时，AI 会参考力量体系来编织起源故事，确保设定自洽。
4.2 自然环境
幻想模式下的字段：
世界结构（大陆/星球/位面）
世界维度规模
大陆分布
区域面积
山川河流
分区域气候
自然资源（矿物/植物/灵气分布）
历史考证模式下切换为：
地理范围
地形地貌
气候与农业
交通路线
重要城市分布
同样支持逐字段 AI 生成。
4.3 人文环境
幻想模式字段：
势力分布（含内嵌的势力管理面板 — 详见 7.5）
社会阶层
经济文化
语言文字
货币体系（内嵌的货币管理面板 — 支持多种货币 CRUD + 兑换关系）
历史考证模式字段：
社会阶层
科举与选官
经济与商业
文化与礼仪
民族与宗教
联动逻辑：货币面板中创建的货币体系会被 buildWorldContext() 读取，在 AI 生成章节时自动注入，确保小说中的金钱描写符合设定。
4.4 历史年表
独立入口，管理世界的历史事件和时代关键词。
三个 Tab：
时间线：事件 CRUD，每个事件有年份、名称、描述、时代分类，支持排序
关键词：按类别（人物/事件/地理/文化/制度/器物/其他）管理历史关键词，每个关键词有名称、释义、时代标签
总览：历史概述 + 纪年体系说明的文本编辑
支持 AI 生成事件详情和关键词释义。
联动逻辑：历史年表的事件和关键词会被 buildHistoricalContext() 读取，在大纲和正文生成时注入 AI 上下文（限制 2000 字符以内，避免占用过多 Token）。
4.5 世界地图
可视化的世界地图系统，支持三种渲染模式：
Voronoi 地图（默认）：程序化生成的多边形地图，支持 AI 一键生成配置 → 随机生成地图 → 手动调整
2D Canvas 地图：简单的 2D 渲染
3D 地图：三维球体渲染（实验性）
世界树侧边栏：
左侧展示树状的世界节点列表
支持多层级（主世界 → 子位面 → 子区域）
每个世界节点可有独立的地图配置
世界之间可添加传送门（Portal），记录名称、坐标、目标世界
AI 地图生成：
点击「AI 生成」按钮，AI 根据世界观设定生成地图配置参数（大陆数量、海洋比例、气候分布等）
配置自动填入 Voronoi 引擎，生成随机地图
用户可多次重新生成直到满意
小巧思：地图不是纯装饰——生成的地图配置存储在 WorldNode 的 mapConfigJSON 字段中，地图数据缓存在 mapCacheJSON 中，切换世界节点时地图会跟着切换。
五、设定库 — 故事设计
对应侧边栏「故事设计」入口，管理故事的核心设定。
字段列表：
核心主题
故事类型
核心冲突
故事主线
情感基调
写作风格
节奏设计
每个字段支持 AI 单字段生成。AI 生成时会读取已有的世界观摘要作为上下文——确保故事设计与世界观一致。
联动逻辑：故事设计中的「核心冲突」和「故事主线」会被注入到大纲生成的 prompt 中，引导 AI 按主线展开卷/章结构。
六、设定库 — 道具系统
管理小说中的重要物品、法宝、装备。
每个道具的字段：
名称
类别（自定义）
等级/品阶（自定义）
外观描述
能力效果
来历/出处
当前持有者
备注
支持折叠展开详情、增删改查。
七、设定库 — 角色设计
角色系统分为四个子面板，按角色重要性分级管理。
7.1 主要角色
管理主角、反派和重要配角。
创建角色时：
弹出角色类型选择器（6 种），带图标引导：
主角（protagonist）
反派（antagonist）
重要配角（supporting）
次要角色（minor）
NPC
路人（extra）
选择后创建角色卡
角色卡字段：
基础：姓名、性别、年龄、身份/职业
外貌描述
性格特征
背景故事
动机与目标
能力/技能
人物弧光（成长变化）
口头禅/说话风格
关系描述
备注
AI 角色生成：
点击「AI 生成角色」，输入提示词（如"帮我生成一个反派"）
AI 生成时会自动感知当前角色阵容缺口：如果项目没有主角，AI 会优先建议生成主角
生成结果自动解析为角色卡，用户确认后入库
角色动态状态面板：
角色详情底部显示该角色在状态表中的最新状态
从 StateCard 表中读取与该角色关联的状态卡，展示关键字段变化
7.2 次要角色 / 7.3 NPC / 7.4 路人
三个子面板结构相同，按角色类型自动过滤。
次要角色面板只显示 role: 'minor' 的角色
NPC 面板只显示 role: 'npc' 的角色
路人面板只显示 role: 'extra' 的角色
7.5 关系网
管理角色之间的关系。
两种视图：
关系图（默认）：基于 react-force-graph-2d 的力导向图，每个角色是一个节点，关系是连线。节点大小按角色重要性（role）自动调整。
列表视图：传统表格，展示所有关系条目
每条关系的字段：
角色 A → 角色 B
关系类型（师徒/恋人/敌对/同门/家族/同盟等）
关系描述
双向/单向
联动逻辑：角色数据在 AI 生成正文时按三层权重注入——主角/反派输出完整性格和动机（约 200 字），重要配角输出一句话简介+关系，NPC/路人仅列名字。这样既保证 AI 了解核心角色，又不会因为角色太多撑爆上下文。
八、创作区 — 创作规则
控制 AI 写作行为的"红线"面板。
设置项：
写作风格：自由文本描述（如"简洁明快，多用短句"）
叙事视角：下拉选择（第一人称 / 第三人称有限 / 第三人称全知 / 多视角）
基调与氛围：自由文本
写作禁区：标签列表（如"主角不能死""不准出现现代用语"），AI 写作时作为硬约束
一致性规则：标签列表（如"同一场景不能超过 3 个角色同时对话"）
特殊要求：自由文本
参考作品引用：下拉多选，可勾选「项目参考」中已分析的作品
AI 生成规则：点击按钮，AI 根据已有的世界观、故事设计、角色设定，自动建议一套创作规则。
联动逻辑：创作规则中的全部内容都会在 AI 生成章节正文时被注入到 system prompt 中。这是 StoryForge 保持生成一致性的核心机制——不管用户调用哪个生成功能，创作规则都是 AI 的"行为准则"。
引用参考作品分析：勾选后，该参考书的十三维分析结论会被精炼后注入 AI 上下文。
引用大师洞察：勾选后，作品学习系统归纳的方法论要点会被注入 AI 上下文。
九、创作区 — 大纲
大纲系统采用树状层级结构：卷 → 篇章 → 故事块 → 章节（支持但不强制全部层级）。
9.1 大纲树
左侧展示大纲树，右侧展示选中节点的详情。
节点操作：
增删改查每个节点
拖拽排序（改变顺序）
点击卷节点查看该卷下的章节列表
9.2 AI 卷级大纲生成
选中模式为「卷级大纲」后：
输入补充说明（可选）
AI 根据世界观 + 故事核心 + 角色阵容 + 历史年表（如有）生成卷级大纲
输出格式为 JSON 数组（每卷含标题和摘要）
生成结果先进入预览区，用户可逐卷确认/修改/删除
确认后批量写入大纲树
9.3 AI 章节大纲生成
选中某一卷后切换到「章节大纲」模式：
AI 根据该卷的摘要 + 世界观 + 角色，生成该卷下的章节列表
同样先预览再确认
9.4 批量生成
「一键生成全部章节大纲」按钮：
按卷顺序串行调用 AI
每生成完一卷，该卷的摘要会作为上下文传给下一卷，保持故事线连贯
支持进度条显示 + 中途取消
单卷失败不中断，跳过继续
9.5 大纲输出格式
AI 被要求以 JSON 数组格式输出（用 ```json 代码块包裹）。解析时采用JSON 优先 + 正则降级策略：
先尝试从 ```json 代码块提取 JSON
失败则尝试清理文本后 JSON.parse
再失败则用正则匹配 **标题**：摘要 格式
小巧思：这个三层解析策略是为了兼容不同 AI 模型的输出习惯——有些模型严格按 JSON 输出，有些会加多余的说明文字，有些用 Markdown 格式。三层降级确保任何模型都能用。
9.6 大纲预览面板（PromptRunPanel）
大纲生成采用统一的 PromptRunPanel 组件，支持：
系统提示词预览和自定义覆盖
用户提示词预览和自定义覆盖
参数面板（如目标字数滑动条、基调选择等）
生成后的流式输出展示
Token 消耗显示
十、创作区 — 故事线
管理贯穿全书的故事线弧线。
故事线类型：主线（main）/ 支线（sub）/ 角色线（character）/ 伏笔线（foreshadow）/ 感情线（romance）
每条故事线的字段：
标题
类型
开始节点 / 结束节点（对应大纲节点）
当前进度
高潮点
描述
AI 生成故事线：根据大纲 + 世界观 + 角色，AI 建议主线和支线走向。
十一、创作区 — 章节编辑
11.1 章节列表
左侧展示大纲树结构（按卷分组），点击章节节点打开右侧编辑器。
章节状态流转：
仅有大纲 → 初稿 → 已修改 → 已润色 → 定稿
11.2 章节编辑器
核心写作区，包含以下功能：
基础编辑：
大文本框编辑正文
实时字数统计
章节摘要（100-200 字，用于后续章节的上下文）
作者笔记
AI 辅助工具栏（编辑器底部 4 个按钮）：
扩写：选中段落或全文，AI 丰富细节
润色：优化文笔、修辞、节奏
去 AI 味：五维检查（词汇多样性/句式变化/情感层次/叙事留白/细节真实性），改写为更自然的文笔
自定义指令：输入任意指令让 AI 处理正文