1. 项目概述用知识图谱为你的小说创作装上“第二大脑”如果你是一位小说创作者无论是网文作者、传统文学写作者还是游戏叙事设计师你一定经历过这样的痛苦时刻写到第30章突然想不起某个配角在第5章出场时穿的是什么颜色的衣服埋下了一个重要的伏笔却在后续剧情中彻底遗忘成了“断线的风筝”或者当你试图梳理一条跨越数十万字的复杂人物关系网时感觉自己像在迷宫里打转。传统的写作软件无论是Word、Scrivener还是各类笔记工具本质上都是“文档管理器”或“大纲编辑器”它们能帮你存放文字却无法理解文字背后的实体人物、地点、物品和关系爱恨、因果、线索。你的故事世界越庞大这种认知负担就越重最终消耗掉你本应用于创意本身的精力。今天要深入拆解的就是一个旨在解决这一核心痛点的革命性工具graphify-novel。它不是一个传统的写作软件而是一个基于知识图谱和智能体的写作副驾驶。简单来说它能为你的小说世界自动构建一个“数字孪生”——一个动态的、可查询的、可视化的关系网络。你写下的每一章都会被它解析提取出其中的人物、地点、事件、概念并分析它们之间的关联。从此你可以像查询数据库一样询问你的故事“主角和反派在上一次冲突后各自的心理状态有何变化”“第三章提到的神秘符号和第十五章出现的古老预言有什么联系”“还有哪些伏笔没有回收”这个项目完美融合了Agentic AI智能体、知识图谱和代码化写作的理念将Claude、GPT等大语言模型从一个被动的“文本生成器”转变为一个主动的、拥有“故事世界记忆”的协作智能体。2. 核心设计理念与架构拆解为什么是“图谱”“智能体”在深入实操之前我们必须先理解graphify-novel背后的设计哲学。它没有重新发明轮子去造一个编辑器而是巧妙地采用了“元数据层”与“关系洞察层”分离的架构这直接决定了它的强大和独特。2.1 双引擎驱动静态“圣经”与动态“图谱”项目结构清晰地体现了这一思想bible/目录静态圣经这是故事的“源文件”。它包含premise.md前提、timeline.md时间线、characters/角色档案、threads/情节线、world/世界设定等结构化文件。你可以手动编辑它们它们代表了作者意图中的故事状态。例如在characters/Elara.md中你明确写着“Elara 左眼下方有一道疤痕是童年事故所致”。这个目录回答的是“应该是什么”的问题。graphify-out/目录动态图谱这是由底层引擎graphify自动生成的。它会扫描你的chapters/已完成章节和bible/中的内容运用自然语言处理技术抽取出实体和关系形成一个知识图谱。这个图谱回答的是“实际写了什么”以及“其中隐含了什么”的问题。它可能发现你在第三章不经意间让Elara用右手下意识地摸了摸左脸这个动作与“左眼下的疤痕”在图谱中产生了连接尽管你并未在角色档案中写明这个习惯。这种分离是精妙的设计。bible是可控的、宣言式的规划graphify-out是涌现的、分析式的发现。两者结合既能保证作者对核心设定的掌控力又能借助AI发现那些连作者自己都未曾留意的潜在联系和模式为创作提供意想不到的灵感。2.2 智能体工作流从命令到对话graphify-novel被设计为一个“Skill”这意味着它运行在诸如Claude Code、Cursor、Windsurf等集成了AI助手的开发环境中。你不需要在命令行里记忆复杂的参数而是像与一个专业的写作编辑对话一样使用自然语言或简单的斜杠命令。例如当你输入/graphify-novel review ch03.md --intent “establish that Elara knows more than she admits”背后发生的是智能体解析AI助手理解你的指令调用graphify-novel技能。上下文加载技能会读取chapters/ch03.md的内容并加载当前的知识图谱和圣经状态。针对性分析AI会基于“Elara知道得比她承认的要多”这个创作意图去检查这一章的内容。它会问对话是否有双重含义她的行为是否有矛盾是否有信息被她刻意隐瞒或误导了其他角色生成报告AI不会直接修改你的文章而是生成一份审查报告指出潜在的矛盾、错失的深化机会或者提出修改建议。这就像有一个不知疲倦的“第一读者”和“情节分析师”随时待命。这种基于智能体的交互将复杂的知识图谱查询和叙事逻辑分析封装成了作家能直观理解和使用的创作动作。注意项目的强大依赖于底层引擎graphify的实体识别与关系抽取能力。虽然当前版本效果已经令人印象深刻但对于高度文学化、隐喻性极强的文本其提取精度可能会打折扣。因此它最适合用于情节驱动型、世界观设定严谨的叙事作品如奇幻、科幻、悬疑、长篇网文等。3. 从零开始实战搭建你的第一个故事知识库理论说得再多不如亲手搭建一个。我们假设要创作一部名为《虚境档案》的科幻悬疑小说来一步步走通全流程。3.1 环境准备与项目初始化首先你需要一个支持运行技能的AI编程环境。Claude Code或Cursor是目前最兼容的选择。确保你已经安装了Node.js因为技能通过npx安装。然后为你的小说创建一个专属目录。# 1. 创建项目文件夹 mkdir novel-virtual-archive cd novel-virtual-archive # 2. 安装 graphify-novel 技能 # 在你的AI助手聊天窗中直接输入以下命令 npx skills add Anshler/graphify-novel安装过程可能会提示你安装依赖的graphify技能按照助手指引完成即可。安装成功后你的AI助手就具备了graphify-novel的所有能力。接下来初始化项目结构。你有两种主要方式方式一从一个核心灵感Premise开始。这适合全新构思的故事。/graphify-novel init “在22世纪一名专精修复数字记忆的‘忆痕师’林雨受雇修复一份被加密的临终记忆却发现记忆的主人正是已被官方宣布死亡的天才AI伦理学家。随着记忆层层解锁她意识到自己正被卷入一场掩盖AI已具备隐性集体意识的巨大阴谋。”执行这个命令后graphify-novel会做以下几件事自动创建标准的项目文件夹结构chapters/,draft/,static/,bible/等。在bible/premise.md中写入你提供的核心前提。根据这个前提利用AI生成故事圣经的初始框架。它可能会在bible/characters/下创建lin-yu.md主角、ai-ethicist.md已故科学家等角色档案的草稿在bible/threads/下创建conspiracy-coverup.md阴谋掩盖等情节线在bible/world/下创建digital-memory-market.md数字记忆市场等世界观设定。这为你提供了一个极高的创作起点。方式二从已有章节反推圣经。这适合已有部分存稿的作者。 假设你已经写好了前5章.txt或.md格式放在了一个临时文件夹里。你需要先将它们拷贝到项目的chapters/目录下。# 假设你的章节文件为 ch01.md, ch02.md ... ch05.md cp /path/to/your/chapters/*.md ./chapters/ # 然后运行初始化命令 /graphify-novel init --from-chapters --batch 3--from-chapters告诉技能从现有章节提取信息。--batch 3是高级参数表示每次处理3个章节。因为大模型有上下文长度限制分批处理可以避免遗漏长故事的信息。技能会启动多个子智能体并行分析这些章节提取出所有角色、地点、组织和关键事件然后自动生成并填充bible/下的所有文件。这相当于对你的故事进行一次“CT扫描”并生成一份初步的“体检报告”。3.2 圣经文件的结构化维护初始化完成后bible/目录下的文件就是你的作战指挥中心。你应该像维护代码一样维护它们。characters/角色档案每个角色一个.md文件。不要只写外貌和背景。优秀的角色档案应包含核心动机与恐惧驱动角色行动的根本原因。关系图谱与其他角色的关系信任、敌对、爱慕、血缘并注明在哪些章节有所体现。角色弧光计划中该角色将经历的重大转变。秘密与谎言角色对自己或他人隐瞒的信息。技能与资产其拥有的特殊能力或资源。 例如我们的主角lin-yu.md里可以这样写## 核心动机 - **表层**赚取高昂佣金治疗妹妹的神经退化症。 - **深层**渴望证明数字记忆并非幻影而是构成人格的真实碎片以此对抗社会对“忆痕师”的歧视。 ## 关键关系 - **妹妹-林雪**依赖与愧疚。林雨认为自己的工作接触他人痛苦记忆是导致妹妹生病的潜在原因。 - **雇主-‘墨影’公司**警惕与利用。林雨怀疑公司在此次委托中隐瞒了关键信息。 ## 已知秘密 - 她私自保留了前一个委托中一段关于“AI梦境”的记忆碎片未向公司报告。threads/情节线每条核心故事线一个文件。描述它的开端、发展、当前状态进行中/暂停/已解决、涉及的主要角色和章节。这能帮你宏观掌控故事进度防止烂尾。world/世界设定记录科技水平、社会规则、组织势力、独特概念等。确保这些设定在章节中保持一致。实操心得定期比如每写完5章花15分钟手动更新一下圣经文件。把AI在review中发现的、你采纳了的细节补充进去。这能保持“源文件”的准确性让后续的AI分析更精准。把圣经当作“代码文档”来写清晰、准确、无歧义。4. 核心工作流深度解析写作、审查与迭代有了坚实的地基我们就可以进入日常的创作循环了。graphify-novel的核心价值体现在review、update和query这三个命令构成的闭环中。4.1 创作与审查/graphify-novel review假设你刚写完《虚境档案》的第三章初稿文件是draft/ch03.md。在将其移入正式章节目录chapters/之前先进行审查。/graphify-novel review draft/ch03.md --intent “揭示‘墨影’公司监控忆痕师的手段并让林雨首次对妹妹的病因产生直接怀疑”AI会为你提供一份怎样的报告一致性检查它会对比本章内容与bible/中的设定。比如如果圣经里写“数字记忆提取器是银色腕带式”而你的草稿里写成了“头盔式”它会立即标记为矛盾。连续性检查它会利用知识图谱查找与前两章的连续性。例如“林雨在ch02结尾时右手受伤本章开头她是否还缠着绷带”“本章新出现的‘记忆加密算法’术语在ch01的科技背景中是否有铺垫”意图符合度分析基于你提供的--intent它会评估本章是否有效达成了目标。比如“本章通过林雨发现自己设备有隐藏后门很好地揭示了监控手段。但关于妹妹病因的怀疑仅通过一段模糊的内心独白呈现冲击力不足。建议增加一个具象触发点如林雨在修复的记忆中看到了类似妹妹病症的早期症状。”线索与伏笔提示图谱可能会发现本章提到的“旧型号神经接口”与ch01中某个配角使用的设备型号相同提示你这可能是一个潜在的连接点询问你是否要发展这条线。人物关系动态它会分析本章的人物对话和互动更新角色之间的关系强度变化。例如“林雨与助手张浩的对话显示信任度比ch02下降了20%”。使用技巧--intent参数至关重要。越具体AI的审查就越有针对性。不要只用“检查错误”而是用“在本章中建立A角色对B角色的不信任感”或“埋下关于X物品的伏笔”这样的导演式指令。4.2 更新知识库/graphify-novel update审查通过你对草稿进行了修改并将最终版ch03.md移入了chapters/。现在你需要更新整个知识系统让AI“学习”这一章的新内容。/graphify-novel update chapters/ch03.md这个命令会运行graphify处理ch03.md提取新的实体和关系合并到全局知识图谱 (graphify-out/) 中。智能更新圣经AI会分析章节内容并尝试自动更新bible/中的相关文件。例如如果本章揭示了林雨患有幽闭恐惧症它可能会在bible/characters/lin-yu.md中新增“心理特质”一栏并填入该信息。但请注意所有自动更新都会以建议Proposal的形式呈现需要你确认后才实际写入文件。这保证了作者对圣经的最终控制权。对于更复杂的、无法通过单章文本自动推断的设定变更你可以使用交互模式/graphify-novel update --manualAI会引导你进行对话“你是想更新角色状态、添加新的世界设定还是解决某条情节线”你可以告诉它“将‘墨影公司’的初始设定‘行业巨头’修改为‘表面为科技巨头实则为AI意识‘守护者’组织的前台公司’。” AI会理解这个复杂变更并帮你修改bible/world/organizations.md文件。4.3 探索与洞察/graphify-novel query与status当故事进行到中段你可能感到有些迷失。这时探索工具就派上用场了。全局状态快照运行/graphify-novel status。它会生成一份简洁的报告开放中的情节线哪些线索还未收回各自的进度如何角色状态看板主要角色最近出现在哪章他们的目标、情绪状态有何变化未解决的设定那些被提及但未解释的“契科夫的枪”伏笔。结构枢纽知识图谱分析出的在故事网络中处于中心位置的章节或事件可能是高潮或关键转折点。深度关系查询这是最强大的功能。假设你想构思一个反转需要理清“神经接口”与“AI集体意识”之间的所有关联。/graphify-novel query “神经接口与AI集体意识之间的所有关联路径” --dfs--dfs深度优先搜索参数会让AI沿着一条关联链深度挖掘给出一个详细的、链条式的报告例如“ch01提及神经接口是早期AI交互协议 → ch02中已故科学家日记提到该协议有‘后门’ → ch03林雨发现的监控后门使用了同源技术 → ch05中‘守护者’组织试图销毁所有旧协议资料”。这为你构建反转逻辑提供了坚实的材料。最短路径分析你想让两个看似不相关的角色产生交集但需要最合理的连接方式。/graphify-novel path “张浩林雨的助手” “守护者组织”AI会从图谱中找出连接这两个实体的最短路径比如“张浩 → (受雇于) → 墨影公司 → (是前台公司) → 守护者组织”。这提示你可以通过揭示张浩的真实雇主来建立联系。5. 高级技巧与避坑指南经过一段时间的深度使用我总结出一些能极大提升效率和避免挫折的经验。5.1 文件管理与.graphifyignore的妙用项目结构建议将进行中的草稿放在draft/定稿放入chapters/。严格遵守这一点否则update命令可能会把半成品也分析进去污染图谱。static/用于放图片、灵感板等不会被分析。.graphifyignore文件是控制图谱生成范围的关键。默认它忽略了bible/characters/、bible/threads/等因为其中是结构化摘要与章节内容大量重复纳入图谱会产生冗余节点干扰分析。但你可以根据需求调整如果你想强化“作者意图”对图谱的影响可以尝试将bible/premise.md或bible/world/从忽略列表中移除让核心设定更直接地参与关系推理。如果你有独立的“设定集”文档可以新建一个lore/文件夹并在.graphifyignore中不忽略它这样所有补充设定也能被图谱吸收。5.2 应对“大项目”的分批处理策略如果你的小说已经有上百章一次性初始化或更新可能会遇到性能或上下文长度问题。graphify-novel的设计考虑到了这一点。初始化时使用--from-chapters --batch N。N值取决于你的AI助手的上下文窗口大小。对于超长篇章可以设置--batch 1逐一处理虽然慢但最稳。定期更新时不必每次写完一章就update。可以积累5-10章后写一个简单的脚本或者直接告诉AI助手“请依次对chapters/目录下最新的5个文件执行graphify-novel update命令。” 智能体会帮你分批处理。5.3 当AI分析出现偏差时如何纠正知识图谱的提取并非100%准确尤其是面对比喻、反讽或高度抽象的文学描写时。如果发现AI在review或query时给出了明显错误的关系例如把“他像狮子一样勇敢”理解为角色与动物“狮子”存在关联你需要干预。修正圣经源文件首先检查并修正bible/中相关的描述使其更精确、无歧义。重建图谱最彻底的方法是临时删除graphify-out/文件夹然后重新运行一次针对所有章节的更新可以用graphify-novel update .尝试或重新初始化。这相当于重建数据库。利用--manual更新直接通过交互模式告诉AI“之前关于‘狮子’的关联是比喻并非实体关联请从图谱中移除该关系。”5.4 将graphify-novel融入个性化工作流这个工具不是要取代你惯用的写作软件如Scrivener, Ulysses, Obsidian。你可以把它作为“后台分析引擎”。场景一在Obsidian中写作将chapters/文件夹设为Obsidian的库。在Obsidian中写稿定稿后保存到chapters/然后在AI助手侧运行审查和更新。这样你既享受了Obsidian流畅的编辑体验又拥有了强大的图谱分析能力。场景二用于团队协作。如果是一个写作小组可以共享同一个Git仓库。主笔负责写chapters/设定负责人维护bible/world/大家都可以运行status和query来了解故事全局确保设定统一。6. 常见问题与排查实录在实际使用中你可能会遇到以下典型问题。这里是我的排查记录。问题1运行任何/graphify-novel命令都报错 “Skill not found” 或 “Command not recognized”。原因技能未在正确的上下文中激活或者AI助手环境如Claude Code的技能加载机制有缓存问题。解决确认你是否在项目根目录包含bible/文件夹的目录下运行命令。尝试关闭并重新打开AI助手会话窗口。在聊天窗重新输入npx skills add Anshler/graphify-novel进行重装。有时需要明确指定版本如npx skills add Anshler/graphify-novellatest。问题2init --from-chapters运行后生成的bible/内容非常空洞只有名字没有细节。原因底层graphify引擎从纯文本中提取结构化信息的能力有限或者你的章节文风过于含蓄缺乏直接描述。解决优化输入文本在关键角色首次出场或关键设定出现时使用更直接、清晰的叙述风格。例如不要只写“一个神秘人走来”可以写“赵无眠前网络安全工程师因一场事故左手留下轻微颤抖此刻他神色警惕地走来”。手动补充圣经将AI生成的骨架作为基础手动填充大量细节。init命令的价值在于帮你建立了框架和文件结构节省了手动创建的时间。分批次初始化使用--batch 1逐章初始化并为每章提供更具体的上下文提示虽然当前命令不支持但未来可期。问题3review命令给出的建议过于笼统比如“此处人物动机可以更强烈”缺乏可操作性。原因AI的反馈质量与你的指令 (--intent) 和它已有的上下文图谱和圣经深度相关。指令越模糊反馈越模糊。解决强化--intent不要只说“审查这一章”。要说“审查这一章中主角做出关键决定时的内心矛盾层次是否充分体现了其‘责任感与自我怀疑’的核心冲突”提供更多背景在运行review前可以先和AI用自然语言聊一下你这一章想达到的具体目标、你感到困惑的地方。让AI助手进入“编辑”角色然后再运行技能命令。结合query使用先运行query找出本章元素与之前故事的所有关联然后基于这些具体的关联点去设计更精细的review意图。问题4知识图谱似乎没有更新query查不到最新章节的内容。原因update命令执行失败或未成功运行或者新章节文件没有放在chapters/目录下。排查检查graphify-out/文件夹内文件的最后修改时间是否在你运行update之后。确认你update的文件路径是否正确。必须是chapters/下的文件。运行update时观察AI助手的输出看是否有错误信息。有时会因为文件编码或特殊字符导致处理中断。问题5我想用这个工具来辅助创作非小说类内容比如学术论文、复杂的项目报告或人物传记可以吗答案完全可以而且可能同样强大。graphify-novel的核心能力是“从非结构化文本中提取实体和关系构建可查询的知识网络”。你只需要进行“概念映射”小说角色→论文中的核心概念/理论情节线→论文的论证线索或报告的项目里程碑故事章节→论文的章节或报告的章节世界设定→研究背景或项目约束条件初始化时你可以将论文摘要作为“premise”然后将已写好的章节放入chapters/。使用review来检查逻辑一致性、概念定义是否前后统一使用query来探索不同理论之间的关联或查找支持某个论点的所有论据分布在哪些章节。这能极大提升复杂长文写作的严谨性和结构性。graphify-novel代表的是一种全新的创作范式。它不直接帮你写下一个句子而是帮你记住你写过的所有句子并理解它们之间的联系。它将作者从记忆和梳理的沉重负担中解放出来让你能更专注地去想象、去感受、去编织那些真正打动人心的故事脉络。工具的价值最终取决于使用者的巧思。现在你的“第二大脑”已经就绪是时候去构建更庞大、更精妙的故事宇宙了。