# Rhyolite：面向长篇小说与技术研究的节点式算法写作环境 > Rhyolite 是一款独特的创意写作与研究工具，采用终端风格界面、DAG 时间线引擎和混合 RAG 系统，为处理复杂多线程叙事和推理链提供全新解决方案。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-03-30T11:15:16.000Z - 最近活动: 2026-03-30T11:26:30.209Z - 热度: 157.8 - 关键词: 创意写作, AI写作工具, 知识管理, DAG, RAG, Markdown, 开源项目 - 页面链接: https://www.zingnex.cn/forum/thread/rhyolite - Canonical: https://www.zingnex.cn/forum/thread/rhyolite - Markdown 来源: ingested_event --- # Rhyolite：重新定义复杂叙事与知识管理的创作环境\n\n## 创作工具的困境\n\n对于长篇小说作者、世界观构建者和技术研究人员来说，传统的写作工具往往面临一个根本性的矛盾：简单的文本编辑器无法管理复杂的叙事结构和知识网络，而复杂的内容管理系统又过于臃肿，打断了创作的心流状态。\n\n现有的 AI 写作助手大多采用"智能打字机"的范式——在空白页面旁提供一个聊天窗口，偶尔提供一些建议。但这种模式对于处理多线程叙事、复杂的角色关系网、时间线交织的世界观构建来说，显得力不从心。\n\nRhyolite 的出现，正是为了解决这个问题。\n\n## 项目概述\n\nRhyolite 是一款开源的节点式算法写作环境，它将终端风格的高对比度界面、有向无环图（DAG）时间线引擎、混合 RAG（检索增强生成）系统和多模型 AI 支持融为一体，为处理复杂创作项目提供了一个全新的范式。\n\n项目的核心理念可以概括为：将叙事视为可计算的图结构，让创作者能够像管理代码一样管理故事和知识。\n\n## 界面设计哲学\n\n### 终端风格沉浸体验\n\n与主流的毛玻璃效果和圆角卡片设计不同，Rhyolite 采用了高对比度的"上行链路"美学风格：\n\n- **紫外配色方案**：深色背景配合高饱和度强调色，减少视觉疲劳\n- **CRT 荧光效果**：模拟老式显示器的扫描线和发光效果，营造沉浸感\n- **Monaspace Neon 字体**：专为代码设计的等宽字体，支持连字特性\n- **扁平边框面板**：摒弃阴影和渐变，采用清晰的边框分隔\n\n这种设计选择不仅仅是视觉偏好，更体现了项目的实用主义哲学：创作者的工具应该消失在背景中，让注意力完全集中在内容上。\n\n### 三栏式 OS 布局\n\nRhyolite 的主界面采用固定的三栏布局，模拟操作系统的多任务界面：\n\n#### [DIR] 项目目录（左侧）\n\n项目资源管理器分为几个主要区域：\n\n- **CRYSTAL_DB**：章节文档，支持文件夹组织和拖拽排序\n- **ARTIFACTS**：维基条目，用于存储世界观设定、角色档案等\n- **TIMELINES**：独立的时间线画布，每个时间线都有自己的节点图\n- **系统功能区**：项目设置、符号管理、手稿导出等功能入口\n\n#### [EDIT] 编辑器（中央）\n\n中央编辑器采用 Markdown 格式，支持实时预览：\n\n- 左右分屏的编辑-预览模式\n- 实体链接悬停预览（鼠标悬停在 `[[标题]]` 链接上显示摘要）\n- AI 差异高亮（新增内容以绿色闪烁提示）\n- 自动实体链接建议\n\n#### [COMMS] 助手面板（右侧）\n\n右侧是与 AI 助手的交互区域：\n\n- 流式对话显示\n- 分支导航（可以回溯到之前的对话分支）\n- Token 预算实时显示（CTX: ~20.6k，悬停显示详细分解）\n- 提示词模板（`/` 菜单快速插入常用提示）\n- 安全预设（防止意外覆盖内容）\n\n## DAG 时间线引擎\n\n### 有向无环图作为叙事结构\n\nRhyolite 最具创新性的特性是其 DAG 时间线引擎。传统的时间线工具通常采用线性或分支时间线，但对于复杂的叙事结构（如多视角交错、倒叙插叙、平行宇宙等），这些表示方式往往力不从心。\n\nDAG 结构允许创作者构建任意的节点关系网络：\n\n- **节点**：代表事件、场景、知识条目或假设\n- **边**：代表节点之间的关系，带有语义标签\n- **方向**：表示因果、时间先后或逻辑依赖\n\n### 时间线画布交互\n\n在时间线画布上，创作者可以：\n\n- **双击空白处**：创建新节点\n- **拖拽连接**：从一个节点的输出手柄拖到另一个节点的输入手柄，创建语义边\n- **点击边**：编辑边的关系标签（如"导致"、"反驳"、"补充"等）\n- **删除选中元素**：按 Backspace 或 Delete 键\n- **网格吸附**：自动对齐节点位置\n\n### 节点类型系统\n\n每个节点都有一个类型标签，帮助区分其在叙事或推理中的角色：\n\n**叙事类**：\n- Event（事件）：故事中的关键发生\n- Scene（场景）：具体的叙事段落\n- Lore（ lore）：世界观背景知识\n\n**技术类**：\n- Hypothesis（假设）：待验证的命题\n- Evidence（证据）：支持或反驳假设的事实\n- Conclusion（结论）：从推理中得出的判断\n\n这种分类不仅提供了视觉区分，更重要的是影响了上下文组装引擎的行为。\n\n## 混合 RAG 上下文系统\n\n### 四层上下文组装\n\nRhyolite 的 AI 助手不是简单的聊天机器人，而是一个深度集成在项目知识结构中的智能代理。当创作者与助手对话时，系统会自动组装四层上下文：\n\n#### 1. 核心正典（Core Canon）\n\n始终包含在系统提示中的基础信息：\n- loreBible：世界观圣经，定义故事的基本规则\n- storyOutline：故事大纲，提供整体结构\n\n#### 2. 关键词 RAG\n\n基于标题和别名的子字符串匹配：\n- 扫描最近的用户输入和活跃文档尾部\n- 匹配 Artifacts 的标题和别名\n- O(1) 查找复杂度，响应迅速\n\n#### 3. 嵌入 RAG\n\n基于语义相似度的向量检索：\n- 使用 Gemini text-embedding-004 生成向量\n- 存储在项目的 embeddings.json 文件中\n- 与关键词结果合并，提供最佳覆盖\n\n#### 4. 图遍历 RAG\n\n这是 Rhyolite 最具特色的上下文机制：\n\n- **BFS 反向遍历**：从当前聚焦的节点出发，沿入边反向遍历最多 10 跳\n- **完整内容**：活跃节点发送完整内容到上下文\n- **摘要内容**：祖先节点发送 AI 生成的摘要\n- **边语义**：包含边的标签信息，说明节点间的关系\n\n这种图遍历机制让 AI 能够理解复杂的因果链和推理路径，而不仅仅是孤立的文档片段。\n\n### 智能上下文窗口管理\n\n对于超长文档（超过 800 词），Rhyolite 不会简单地截断或全文发送，而是采用智能分块策略：\n\n- 文档开头（提供背景）\n- 光标所在区域（当前关注点）\n- 文档结尾（最新进展）\n\n这种策略在保持上下文相关性的同时，最大化利用有限的 token 预算。\n\n### Token 预算可视化\n\nRhyolite 实时显示上下文的 token 使用情况，包括：\n\n- Canon（正典）：世界观和故事大纲占用的 token\n- Wiki（维基）：知识库检索占用的 token\n- DAG（图结构）：时间线节点和边占用的 token\n- Draft（草稿）：当前编辑文档占用的 token\n- History（历史）：对话历史占用的 token\n\n这种透明度让创作者能够理解和控制 AI 的"注意力"分配。\n\n## 多模型支持\n\n### 灵活的提供商配置\n\nRhyolite 不绑定到单一 AI 提供商，而是支持多种模型：\n\n- **Gemini**：Google 的生成式 AI（默认，需要 GEMINI_API_KEY）\n- **OpenAI 兼容**：通过 OPENAI_BASE_URL 支持本地模型（如 Ollama、vLLM）\n- **Anthropic**：Claude 系列模型（需要 ANTHROPIC_API_KEY）\n\n### 符号（Glyph）系统\n\n每个"符号"定义了一个 AI 人格，包括：\n\n- 提供商和模型选择\n- 温度（temperature）和最大 token 数\n- 系统指令（定义角色和行为）\n- 安全预设（防止意外操作）\n\n创作者可以为不同任务创建不同的符号：一个用于头脑风暴，一个用于润色文字，一个用于逻辑检查，等等。\n\n## 数据存储哲学\n\n### 纯文件存储\n\n与大多数现代应用不同，Rhyolite 不使用数据库。所有项目数据都以纯文本文件形式存储在磁盘上：\n\n```\nworkspace/\n├── project.json # 项目元数据\n├── folders.json # 文件夹结构\n├── crystals/ # 章节文档（Markdown）\n│ ├── chapter-01.md\n│ └── chapter-02.md\n├── artifacts/ # 维基条目（Markdown）\n│ ├── character-alice.md\n│ └── world-magic-system.md\n├── timelines/ # 时间线数据（JSON）\n│ └── main-plot.json\n├── chats/ # 对话历史（JSON）\n├── embeddings.json # 向量缓存\n└── .history/ # 版本历史\n └── crystals/\n```\n\n### 版本历史\n\n每次保存 Crystals 或 Artifacts 时，Rhyolite 会自动创建快照，存储在 `.history/` 目录中。这提供了轻量级的版本控制，无需依赖 Git 等外部工具。\n\n### 可移植性和长期保存\n\n纯文件存储的最大优势在于可移植性和长期保存：\n\n- **无供应商锁定**：项目数据是标准的 Markdown 和 JSON\n- **版本控制友好**：可以直接用 Git 管理\n- **长期可读**：即使 Rhyolite 停止维护，文件内容仍然可读\n- **编辑自由**：可以用任何文本编辑器打开和修改\n\n## 全局网络图谱\n\n### 项目知识可视化\n\n点击顶部栏的 [GLOBAL_NETWORK] 按钮，会打开一个力导向图可视化：\n\n- **节点**：所有 Crystals、Artifacts 和 Timeline 事件\n- **边**：内容链接（粉色）、时间线 DAG（紫色）、事件引用（琥珀色）、事件标签（青色）\n- **交互**：点击节点打开预览抽屉，点击空白处取消选择\n\n这个全局视图帮助创作者理解项目的整体结构，发现潜在的联系和遗漏。\n\n## 实际应用场景\n\n### 长篇小说创作\n\n对于多线索、多视角的长篇小说，Rhyolite 的 DAG 时间线可以：\n\n- 追踪不同角色视角下的同一事件\n- 管理倒叙和插叙的时间跳跃\n- 确保伏笔和呼应的一致性\n\n### 世界观构建\n\n对于复杂的虚构世界（如奇幻或科幻设定）：\n\n- Artifacts 作为维基条目存储设定细节\n- 时间线记录历史事件和演变\n- AI 助手帮助检查设定一致性\n\n### 技术研究\n\n对于需要整理大量文献和推理链的研究项目：\n\n- 节点代表假设、证据和结论\n- 边标记支持、反驳、相关等关系\n- 自动合成功能帮助整理论证\n\n## 技术实现\n\n### 技术栈\n\n- **前端**：React + TypeScript\n- **图引擎**：React Flow（DAG 画布）+ D3（力导向图）\n- **后端**：Node.js API 路由\n- **AI 集成**：@google/genai、OpenAI SDK、Anthropic SDK\n- **嵌入模型**：Gemini text-embedding-004\n\n### 快速开始\n\n```bash\n# 克隆仓库\ngit clone https://github.com/7368697661/rhyolite.git\ncd rhyolite\n\n# 安装依赖\nnpm install\n\n# 配置环境变量\ncp .env.example .env\n# 编辑 .env，添加 GEMINI_API_KEY\n\n# 启动开发服务器\nnpm run dev\n```\n\n访问 http://localhost:3000 即可开始使用。\n\n## 设计理念总结\n\nRhyolite 的设计体现了几个核心理念：\n\n1. **工具应该适应思维，而非相反**：DAG 结构更接近人类对复杂叙事的思考方式\n2. **数据所有权属于用户**：纯文件存储，无数据库，无遥测\n3. **AI 是助手，不是替代**：深度集成但保持创作者的控制权\n4. **心流状态优先**：终端风格界面减少视觉干扰\n5. **长期可维护性**：标准格式确保数据的长寿命\n\n## 局限与展望\n\n### 当前局限\n\n- **学习曲线**：DAG 和图遍历的概念对非技术用户有一定门槛\n- **移动端支持**：目前主要面向桌面端，移动端体验有限\n- **协作功能**：缺乏实时的多人协作功能\n\n### 未来方向\n\n- **插件系统**：允许社区扩展功能\n- **导出选项**：支持更多格式（EPUB、PDF、Word）\n- **协作功能**：基于文件同步的多人协作\n- **更多可视化**：故事结构的热力图、角色关系网等\n\n## 总结\n\nRhyolite 代表了写作工具的一个有趣探索方向：将叙事视为可计算的结构，用图论和 AI 辅助复杂创作。它可能不适合所有人——如果你只是写简单的线性叙事，传统的文字处理器可能更合适。但对于需要管理复杂结构、多线程叙事或大量知识关联的创作者来说，Rhyolite 提供了一个独特而强大的解决方案。\n\n在一个 AI 写作工具日益同质化的时代，Rhyolite 坚持自己的设计哲学，不追求大而全，而是专注于解决特定类型创作者的核心痛点。这种专注和独特视角，使其成为创意工具生态中一个值得关注的存在。