StoryForge 是一个开源、本地优先的 AI 叙事创作与叙事体验项目。当前最重要、用户实际使用最多的是独立的分步骤长篇创作；项目同时在建设同源节点模式、短篇、小说转剧本、小说转漫画、可版本化世界引擎，以及基于冻结世界版本的跑团、角色聊天和文字游戏。
项目不把这些功能都塞进“世界引擎”：
- 分步骤长篇、短篇、剧本和漫画是可独立成立的创作产品；
- 节点模式是同一长篇生产链的可视、可组合表达；
- 世界引擎只保存语义内容、编号、版本和可查询出口，不保存上层媒资或运行状态；
- 跑团、聊天和文字游戏拥有自己的生产、媒资、发布、运行和私域演化；运行结果不会自动回写共享世界。
完整产品边界见 项目总纲。
StoryForge 的工程底座已经很深，但“模块存在”不等于“产品完成”。当前诚实状态如下：
| 领域 | 状态 | 说明 |
|---|---|---|
| 分步骤长篇 | 部分可用、主要入口 | 世界观、故事、角色、大纲、细纲、正文和多种长期一致性设施已存在；仍需完成全链统一、真实长期创作和百万字验证 |
| 节点模式 | 部分实现 | 有 DAG、节点工作区和运行/生命周期基础；尚未完整证明与全部分步骤能力同源互操作 |
| 短篇 | 部分实现 | 有独立 profile、规模和结构基础；完整轻量产品体验仍需收口 |
| 小说转剧本 | 部分实现 | 有 source/brief/plan/scene 与工作台基础；完整长文改编、审校和导出尚待验收 |
| 小说转漫画 | 部分实现 | 有 page/panel/visual/media 数据基础；真实生图、一致性、排版和成品闭环未完成 |
| 世界引擎 | 部分实现 | 有世界编号、投影、完整度、release/分享基础；统一版本化数据出口和独立作品边界需纠正 |
| 跑团、角色聊天、文字游戏 | 多个部分实现 | 生产、运行、保存和测试设施很多，但仍按完整垂直产品逐一验收 |
| 社区、平台、商业化 | 实验/后置 | 现有相关代码必须门控；当前优先完善核心功能 |
flowchart TB
B["共享工程底座\n本地存储 / 模型接入 / Harness / 记忆 / 三注册表"]
L["独立产品：分步骤长篇"]
N["节点模式：长篇同源工作流"]
S["独立产品：短篇"]
P["独立产品：小说转剧本"]
C["独立产品：小说转漫画"]
W["世界引擎：版本化语义内容"]
U["上层产品：跑团 / 聊天 / AI小镇 / 文字游戏"]
B --> L
B --> N
B --> S
B --> P
B --> C
B --> W
B --> U
L <-->|"同一能力与数据"| N
W -->|"只读冻结版本"| U
分步骤长篇不依赖世界引擎，是完整创作产品。目标流程包含：
项目与创作意图
→ 世界观 / 故事 / 角色
→ 主线与支线
→ 全书 / 卷 / 章大纲
→ 场景细纲
→ 正文生成、续写、扩写、重写、润色和人工编辑
→ 事实、关系、时间线、伏笔、状态和未来影响持续演化
模型结果先成为候选，作者确认后才进入正式作品。刷新恢复、stale 阻断、Context Gateway、原文回查和持久化 run 共同服务长篇一致性。百万字是目标上限；当前存在合成规模工程门，但真实百万字作者项目与文学一致性还没有被宣称完成。
正式 AI 路径遵循：
产品入口 / Skill
→ Run Contract
→ 注册上下文与渐进式披露
→ 模型 / 只读工具
→ 原始输出 + CreativeArtifact 候选
→ schema / 确定性验证 / 有界修复
→ 作者预览、编辑、采纳或拒绝
→ adopt() + post-state + terminal receipt
三个单一事实源负责防止同类漏接反复出现：
CONTEXT_SOURCES+assembleContext()：AI 读什么；FIELD_REGISTRY+AdoptionSchema+adopt()：AI 写什么；PROJECT_TABLES：表的导出、导入、删除、迁移、作用域和引用重映射。
Harness 保障权限、预算、恢复、stale 和证据，不承诺任何模型每次都能生成完美文学内容。
- 核心项目和手稿保存在浏览器 IndexedDB；可选本地文件工作区用于内容和记忆文件。
- API Key 由用户配置；不要把 Key 提交到 Git、日志或公开截图。
- AI 请求会把当前任务所需上下文发送给用户选择的模型服务商，请按服务商隐私条款选择。
- 导出/备份、迁移和删除受
PROJECT_TABLES生命周期治理；重要项目仍建议定期导出备份。 - 世界封存版本与上层运行实例隔离；上层运行不自动改写世界。
要求：Node.js 20+ 与 npm。
git clone https://github.com/aloneonez/storyforge.git
cd storyforge
npm install
npm run dev默认开发地址由 Vite 输出。打开设置页配置模型服务和 API Key；连接测试只证明端点可访问，正式生成仍会校验模型、任务协议、错误和上下文窗口。
生产构建：
npm run build
npm run previewnpm run check:architecture
npm run check:required-tables
npm run check:ai-manual
npx tsc --noEmit
npm run test
npm run build完整交付运行：
npm run ci
npm run ci:e2e # 涉及真实 UI/恢复/跨产品纵切面时贡献前请读 AGENTS.md、开发宪法 和
贡献指南。main 没有 staging，不能直接推送。
| 文档 | 用途 |
|---|---|
| 项目总纲 | 项目全貌、产品关系和长期方向 |
| 文档权威 | 现行文档白名单和 WPS 历史归档 |
| 架构总览 | 当前代码、数据和执行架构 |
| 数据治理 | 三注册表、owner、版本与生命周期 |
| Harness 标准 | Agent、上下文、候选、恢复和长程标准 |
| 工程质量标准 | 测试、数据、安全、CI/E2E 与发布门 |
| 产品契约 | 长篇/节点、独立创作、世界引擎和上层产品 |
| 路线图 | 按总纲依赖排序的当前施工顺序 |
| 能力基线 | implemented / partial / missing / experimental |
| AI 行为清单 | 由代码生成的正式 AI 行为事实 |
旧 Blueprint、施工卡、评测流水和路演材料已从主干文档库移除，完整清理前快照保存在 WPS；链接和哈希见文档权威索引。
代码依据仓库 LICENSE 开源。使用第三方模型、素材、规则或输出时，还需遵守对应服务与内容许可。TTRPG SRD 引用见
docs/ttrpg/licenses/SRD-5.2.1-CC-BY-4.0.md。
如果 StoryForge 对你的创作有帮助，可以通过 issue、测试、文档、代码贡献或传播项目参与建设。