1. 项目概述一个能自主写小说的AI Agent如果你对AI写作的印象还停留在“输入一句话生成一段文”的简单工具那么InkOS可能会颠覆你的认知。这不是一个玩具而是一个拥有完整创作管线、具备长期记忆和自主审计能力的“小说创作AI Agent”。简单来说你给它一个书名和题材它就能像一位真正的作者一样从零开始持续不断地为你创作出一部逻辑自洽、情节连贯的长篇小说。我最初接触这个项目是因为厌倦了手动调整提示词、反复检查角色设定和剧情漏洞的繁琐过程。市面上大多数AI写作工具要么是单次生成上下文记忆有限要么需要人工频繁介入打断创作流。InkOS的核心理念是“自主性”和“连续性”。它通过一套复杂的Agent协作系统模拟了从构思、规划、写作到审阅、修订的完整创作流程。最吸引我的是它的“真相文件”系统——七份不断更新的Markdown/JSON文件像一本小说的“上帝视角数据库”记录了世界的每一个细节确保角色不会失忆物品不会凭空消失伏笔不会被遗忘。这个工具特别适合几类人网文作者想用AI辅助构思和填充日常章节内容创作者需要批量产出特定风格的故事甚至是游戏策划用它来生成庞大的背景故事和角色设定。它把我们从重复性的“监工”工作中解放出来让我们能更专注于故事的核心创意和方向把控。2. 核心架构与工作原理拆解InkOS的强大源于其背后精细分工的Agent流水线和严谨的状态管理机制。理解这套机制你才能用好它甚至在它“卡壳”时知道如何干预。2.1 多Agent协作管线从灵感到成稿的流水线InkOS的创作不是由一个“全能AI”一气呵成的而是由多个各司其职的Agent接力完成。这种设计模仿了专业写作工坊或编辑部的分工每个环节只专注解决一类问题从而保证最终产出的质量。雷达 (Radar)这是可选的“市场调研员”。它的任务是扫描外部信息理论上可以接入平台API分析当前流行趋势、读者偏好为故事的大方向提供建议。比如如果雷达发现“末世基建”题材近期热度飙升它可能会建议在都市异能的故事中加入一些相关的元素。这个Agent是可插拔的如果你对自己的故事方向非常明确完全可以跳过它。规划师 (Planner)与编排师 (Composer)这是新版“输入治理”模式的核心。过去我们直接把一大堆设定扔给AI希望它自己理清重点。现在InkOS将这个过程拆解了。规划师负责解读你的高层意图。它会读取story/author_intent.md长期目标和story/current_focus.md近期重点结合从记忆数据库中检索到的相关信息生成一份本章的“创作意图书”chapter-XXXX.intent.md。这份文件会明确列出本章“必须保留”和“必须避免”的事项。例如“必须保留主角林轩对师尊的怀疑必须避免引入新的法宝”。编排师则是个“资料管理员”。它手里有全量的“真相文件”角色矩阵、资源账本等但不可能把几百KB的内容全塞给写手。编排师会根据规划师确定的意图从海量信息中精准筛选出与本章最相关的上下文编译成一份精简的context.json和一套优先级分明的rule-stack.yaml。这相当于为写手准备了一份“本章专用写作手册”。建筑师 (Architect)拿到编排师准备的资料后建筑师开始搭建本章的骨架。它负责规划章节的整体结构分几个场景每个场景的叙事节拍铺垫、冲突、转折、高潮、回落如何安排整体的情感节奏是紧张还是舒缓它会输出一个详细的大纲为写手提供清晰的路线图。写手 (Writer)终于到了动笔的环节。写手基于建筑师的大纲和编排师提供的精准上下文进行创作。这里有几个关键机制字数治理你通过--words指定的只是一个目标值。系统会根据题材和章节位置计算出一个允许的浮动区间比如目标1万字区间可能是9000-11000。写手会努力向目标靠拢但不会为了凑字数而注水也不会生硬截断。去AI味规则写手的提示词中内置了“禁用词表”和“风格指南”从源头减少“随着一道光芒闪过”、“不禁感慨道”这类高频AI句式。它被要求使用更动态、更具体的描写。对话引导为了避免对话干瘪系统会提示写手注意对话的潜台词、人物动作和神态让对话推动剧情或揭示性格。观察者 (Observer) 与 反射器 (Reflector)写手完成草稿后观察者会像一台高精度扫描仪对正文进行“过度提取”。它不仅仅总结情节而是提取九大类事实角色谁出场、情绪如何、位置场景在哪、资源使用了或获得了什么物品、关系人物间互动产生了什么变化、情感、信息角色知道了什么新情报、伏笔是否埋下或回收了钩子、时间、物理状态。然后反射器将这些变化总结为一份JSON Delta增量更新而不是重新生成整个真相文件。这个设计非常巧妙既减少了LLM的负担又便于程序进行精确的、结构化的合并。归一化器 (Normalizer)检查章节字数是否在允许区间内。如果超出它会尝试进行一次“智能归一化”——可能是压缩一些冗余的描写也可能是补充一些细节描写——使字数回归合理范围。它不会进行第二次调整如果一次调整后仍超出硬性限制章节会被保存但会标记一个警告。连续性审计员 (Auditor)与修订者 (Reviser)这是质量控制的最后关口。审计员手握七份真相文件从33个维度对草稿进行交叉验证。例如角色记忆连续性角色A在本章“回忆”起一件事但检索数据库发现这件事在之前的章节中从未被角色A知晓。物资连续性角色B掏出了一把“上古神剑”但账本显示这把剑在两章前已经损毁。伏笔回收第三章埋下的一个悬念是否在本章得到了推进或解答大纲偏离本章情节是否严重偏离了卷纲或当前焦点AI痕迹检测是否出现了句式重复、词汇疲劳、过度总结等“LLM味”表达审计员会生成一份问题报告。关键问题如严重的设定矛盾会触发自动进入修订循环建议性问题如文风略显平淡则会被标记等待人工审核。修订者会根据审计报告对草稿进行针对性修改然后再次提交审计直到所有关键问题清零。实操心得这个多Agent管线听起来复杂但实际运行是全自动的。你只需要关注输入作者意图、当前焦点和输出审核章节。它的价值在于将“保持故事一致性”这个最耗费心力的工作从你的大脑中卸载给了系统。你从“监工”变成了“总编”只需要把握大方向。2.2 长期记忆系统真相文件与结构化状态如果说Agent管线是肌肉那么长期记忆系统就是骨骼和中枢神经。它是InkOS确保故事“不自相矛盾”的基石。七份真相文件每本书都维护着七份核心文件它们是故事世界的“唯一事实来源”。从v0.6.0开始这些文件的权威存储从Markdown迁移到了story/state/*.json用Zod Schema进行严格的数据校验但依然保留人类可读的Markdown投影。current_state.md (.json)世界状态快照。记录所有角色当前的位置、健康状态、已知信息集合、情感值如对某人的信任度-10到10。这是最动态的文件。particle_ledger.md (.json)资源账本。不光是神器法宝一瓶丹药、几两银子、一封书信都在这里登记。每次使用、获得、丢失都会更新数量。审计员会严格核对。pending_hooks.md (.json)未闭合伏笔清单。每个伏笔都有创建章节、预期回收章节、当前状态open/progressing/resolved等。写手在创作时系统会提示附近有待回收的伏笔。chapter_summaries.md (.json)章节摘要库。每章写完会自动生成摘要记录核心事件、出场人物、状态变化和伏笔动态。这是记忆检索的主要来源。subplot_board.md (.json)支线进度板。长篇故事常有A/B/C多条线。这个文件跟踪每条支线的最近进展时间如果某条支线超过N章没有推进系统会提示可能需要激活它。emotional_arcs.md (.json)情感弧线追踪。按角色记录其情感变化轨迹用于确保角色成长符合设定不会情绪跳跃。character_matrix.md (.json)角色交互矩阵。记录任意两个角色是否见过面、交换过什么关键信息。用于控制“信息边界”防止角色知道不该知道的事。记忆检索与SQLite在Node.js 22环境下InkOS会自动启用SQLite数据库 (story/memory.db) 作为时序记忆库。当规划师或编排师需要信息时它们不是把整个chapter_summaries.md灌给LLM而是向数据库发起查询“检索所有与‘师尊中毒’相关的历史事件”。这极大地缓解了上下文长度压力让系统能够处理超长篇创作。状态更新与校验反射器输出的JSON Delta会被applyRuntimeStateDelta函数处理以不可变immutable的方式更新状态对象然后经过validateRuntimeState的Zod Schema校验。如果数据格式错误比如伏笔状态填成了“完成”而不是规定的“resolved”更新会被拒绝并触发重试或降级保存。这保证了真相文件的数据永远是干净、结构化的从根源上避免了“垃圾进垃圾出”导致的后续剧情崩坏。注意事项首次运行旧版本创建的项目时InkOS会自动将Markdown格式的真相文件迁移到结构化JSON过程是无感的。但如果你手动修改过这些Markdown文件建议先备份。迁移逻辑会尽力解析但非标准格式可能导致数据丢失。3. 从零开始实战创建并运行你的第一本AI小说理论说得再多不如亲手跑一遍。下面我将带你完整走一遍流程并分享每一步的实操细节和可能遇到的坑。3.1 环境准备与初始化首先确保你的系统满足基础要求Node.js版本必须 20.0.0。建议使用nvm管理Node版本避免权限问题。包管理器npm或yarn均可。官方示例使用npm。安装InkOSnpm i -g actalk/inkos安装完成后在终端输入inkos --help应该能看到命令列表。如果提示“命令未找到”可能是全局Node模块路径未添加到系统PATH中。对于Mac/Linux通常需要配置~/.bashrc或~/.zshrc对于Windows可能需要以管理员权限运行或检查系统环境变量。配置LLM大语言模型这是最关键的一步。InkOS本身不提供模型你需要有自己的API Key。它支持OpenAI格式的API这意味着你可以使用官方OpenAI(GPT-4o, GPT-4-turbo)Anthropic Claude(Claude-3系列)任何兼容OpenAI API格式的中转服务或国内大模型如智谱AI、DeepSeek、Ollama本地模型等。对于这些provider要选择custom。推荐使用全局配置一次设置所有项目通用inkos config set-global \ --provider openai \ --base-url https://api.openai.com/v1 \ --api-key sk-你的真实Key \ --model gpt-4o--base-url如果你用的是中转站就填中转站提供的地址。--api-key小心不要在他人可见的屏幕或日志中泄露。这条命令会将配置加密后保存到~/.inkos/.env文件。多模型路由配置高级用法你可以为不同Agent分配不同模型平衡效果与成本。# 让写手用效果更好但更贵的Claude-3.5-Sonnet inkos config set-model writer claude-3-5-sonnet-20241022 --provider anthropic --api-key-env ANTHROPIC_API_KEY # 让审计员用便宜快速的GPT-4o-mini inkos config set-model auditor gpt-4o-mini --provider openai # 让雷达用本地运行的Ollama模型零成本扫描 inkos config set-model radar qwen2.5:7b --provider custom --base-url http://localhost:11434/v1--api-key-env参数允许你指定环境变量名而不是明文传递Key更安全。未单独配置的Agent会自动使用全局默认模型。项目初始化mkdir my-novel-project cd my-novel-project inkos init这会在当前目录创建inkos.json配置文件和一个story目录骨架。如果你已经在某个目录下直接运行inkos init即可。3.2 创建书籍与注入创作意图现在创建你的第一本书。我们以一本玄幻小说为例inkos book create --title 吞天魔帝 --genre xuanhuan --chapter-words 12000 --target-chapters 100--title书名。--genre题材。内置支持xuanhuan(玄幻)、xianxia(仙侠)、urban(都市)、scifi(科幻) 等。运行inkos genre list查看全部。--chapter-words每章目标字数。系统会围绕这个值浮动。--target-chapters计划总章节数用于宏观规划。进阶操作使用创作简报。如果你有一个初步的脑洞或设定文档强烈建议使用--brief参数inkos book create --title 赛博修仙我在矩阵中画符 --genre xuanhuan --brief ./我的脑洞.md你的我的脑洞.md可以是这样# 核心设定 世界观22世纪灵气复苏与数字网络融合。修仙者需要破解“灵网协议”来修炼。法宝是硬件符箓是代码。 主角林风前顶级黑客现炼气期修士。性格冷静擅长发现系统漏洞。 核心冲突传统修仙宗门 vs 掌控灵网的科技巨头“天机阁”。建筑师Agent会仔细阅读你的简报并以此为基础生成详细的story_bible.md世界观圣经和book_rules.md本书专属规则而不是从零开始“瞎编”。这能极大提升初期设定的贴合度。关键文件解读创建成功后进入书籍目录通常以书ID命名如book_xxxx你会看到几个关键文件story/author_intent.md长期作者意图。你可以在这里写下你对这本书的最高期望比如“要突出主角的智斗而非蛮力”、“世界观的核心是‘技术即魔法’”。这个文件会持续影响后续所有章节的规划。story/current_focus.md当前焦点。用于指导最近1-3章的内容。比如你感觉最近剧情有点散可以在这里写上“接下来三章聚焦主角与天机阁的第一次正面冲突”。plan chapter命令会优先考虑这里的指令。story/book_rules.md本书规则。由系统生成你也可以修改。例如禁止出现“降智反派”规定主角的成长速度上限等。story/story_bible.md故事圣经。包含详细的世界观、势力分布、基础设定。踩坑记录初期我忽略了author_intent.md和current_focus.md的作用导致AI写出的章节虽然单看不错但整体方向有些漂移。后来我养成了习惯在写新卷或感觉剧情跑偏时第一时间去更新这两个文件效果立竿见影。它们是你作为“总编”控制故事方向最直接的舵盘。3.3 运行完整创作管线最激动人心的时刻来了让AI开始自动创作inkos write next如果当前目录下只有一本书可以省略书名。这个命令会触发完整的plan - compose - draft - observe - reflect - audit管线。第一次运行会发生什么规划与编排系统读取你的author_intent.md、current_focus.md结合记忆目前为空生成第一章的意图和上下文。因为你是全新书它会基于story_bible.md来规划开篇。写作与状态更新写手生成第一章草稿观察者提取事实反射器生成状态更新并写入story/state/下的各个JSON文件。同时人类可读的Markdown真相文件也会更新。审计审计员对照刚刚建立起来的初始状态检查第一章草稿的逻辑自洽性。由于是第一章矛盾点会很少通常能一次通过。输出草稿被保存到drafts/目录下等待你的审阅。同时命令行会输出本次操作的摘要包括字数、审计结果、状态更新摘要等。查看与审阅inkos status # 查看书籍整体状态包括章节数、字数、审计状态 inkos review list # 列出所有待审阅的草稿使用inkos review list后你会看到草稿列表。每个草稿都有ID。你可以打开drafts/目录下对应的Markdown文件查看内容。如果觉得没问题批准它inkos review approve-all # 批准所有待审阅的草稿批准后该章节才会被正式“采纳”其内容会被用于后续章节的上下文记忆并可以导出。连续创作与守护进程inkos write next --count 5 # 连续写5章或者启动守护进程让它后台自动运行遇到关键问题才暂停inkos up -q # -q 静默模式日志写入 inkos.log守护进程非常适合在夜间或你不想手动操作时让故事平稳推进。3.4 核心进阶操作详解掌握了基础流程后这些进阶功能能让你的创作如虎添翼。输入治理精细控制每一章。write next虽然方便但有时你想对下一章做更精确的指导。这时可以手动执行管线的前两步# 1. 规划告诉系统你接下来想写什么 inkos plan chapter --context 本章重点描写主角第一次成功入侵灵网核心遭遇守护AI场面要紧张刺激为主角后续升级做铺垫 # 这会生成 story/runtime/chapter-XXX.intent.md你可以打开看看是否符合你的预期。 # 2. 编排基于你的规划系统准备具体的写作素材 inkos compose chapter # 这会生成 context.json, rule-stack.yaml等。你可以检查 rule-stack.yaml看系统为你挑选了哪些规则和上下文。 # 3. 写作基于以上准备开始写作 inkos draftplan和compose命令不调用LLM它们只是编译你本地的控制文件。这意味着你可以在没有API Key或者想节省token的情况下反复调整author_intent.md和current_focus.md直到intent.md的输出令你满意再调用LLM进行实际的写作。文风仿写如果你希望AI模仿某位作者或某部作品的文风# 1. 分析准备一个包含目标文风的文本文件如几章原著 inkos style analyze ./金庸片段.txt # 系统会生成一个 .style.json 文件里面是分析出的文风指纹。 # 2. 导入将文风指纹应用到你的书 inkos style import ./金庸片段.style.json 吞天魔帝 # 从此以后这本书的所有章节写作和修订都会参考这个文风指南。续写已有作品如果你有一部未完结的小说或者想用AI为一部完结小说写番外# 将你的小说文本支持TXT或MD导入自动分析并创建真相文件 inkos import chapters --from ./我的旧作.txt系统会自动识别章节分割如“第X章”并逆向工程出角色、物品、伏笔等信息初始化真相文件。完成后直接inkos write next就可以无缝续写。同人创作InkOS对同人创作有专门优化# 从原著文本创建一本同人书 inkos fanfic init --from ./原著.txt --mode au --title 哈利波特斯莱特林之道--mode有四种canon正典延续严格遵循原著设定和人物性格。au(Alternate Universe)平行世界世界观或关键事件改变如“哈利被分到斯莱特林”。ooc(Out Of Character)性格重塑人物做出原著中不会做的选择。cpCP向聚焦于特定人物关系。 系统会导入原著作为“正典”知识库并在审计时特别注意不与之矛盾对于au/ooc模式矛盾是允许的但会被标记出来让你知晓。4. 问题排查、优化与经验分享即使设计再精良的工具在实际使用中也会遇到各种情况。下面是我在深度使用InkOS过程中积累的一些常见问题解决方法和优化技巧。4.1 常见问题与解决方案问题现象可能原因解决方案运行inkos write next报错No LLM configuration found未配置API Key或配置未生效。1. 运行inkos config show-global检查配置。2. 运行inkos doctor进行诊断和连通性测试。3. 确保API Key有余额且模型名称正确注意OpenAI的gpt-4o和gpt-4是不同模型。章节内容出现严重设定矛盾如角色用出已毁的法宝1. 审计环节未正确检测到。2. 资源账本 (particle_ledger.md) 更新有误。1. 运行inkos audit [书ID] [章节号]手动审计该章节看审计员是否漏报。2. 检查story/state/particle_ledger.json确认该物品状态是否正确。可手动修正JSON文件然后使用inkos write repair-state尝试修复状态一致性。故事剧情偏离初衷越写越“飘”author_intent.md和current_focus.md内容不够具体或未被有效执行。1. 重新审视并细化author_intent.md用更明确的语句如“核心看点是底层黑客的智斗而非修为等级碾压”。2. 在写新章节前使用inkos plan chapter --context ...明确本章具体任务将方向拉回正轨。3. 考虑在book_rules.md中增加强制约束规则。章节字数远低于或远高于--chapter-words设定字数治理的“一次归一化”未能调整到理想区间。1. 这是正常设计系统优先保证内容质量而非精确字数。如果差距过大如目标1万实际只有5千可能本章情节密度不足。2. 可以在inkos draft或inkos write next时使用--words参数临时调整本章目标或调整全局的--chapter-words设置。3. 检查章节结尾是否仓促有时AI会过早结束场景。生成的对话干瘪像剧本写手Agent的“对话引导”提示未完全生效或模型本身不擅长对话。1. 尝试为“writer” Agent切换一个更擅长对话的模型如Claude-3系列。2. 在book_rules.md的[writing.dialogue]部分增加更具体的规则例如“重要对话必须伴随人物的细微动作、神态或环境描写以展现潜台词”。3. 使用文风仿写功能导入一个对话生动的文本作为风格参考。导入已有章节 (import chapters) 后角色或物品识别错误文本分割不准确或AI在逆向工程时理解有偏差。1. 使用--split参数指定自定义的分隔符如--split ### Chapter。2. 导入后务必仔细检查自动生成的7个真相文件Markdown版本在写作开始前手动修正错误信息。第一印象错了后续会雪崩。3. 可以分批次导入先导入前10章检查无误后再导入后续。守护进程 (inkos up) 意外停止可能遇到网络波动、API限额、或无法自动修复的关键审计错误。1. 检查inkos.log日志文件JSON Lines格式寻找错误信息。2. 常见原因是API调用频率超限或余额不足。配置多模型路由将审计等任务切换到更便宜/稳定的模型。3. 如果是审计关键错误暂停需要手动运行inkos review list查看并处理问题然后守护进程会自动继续。4.2 性能优化与成本控制使用AI写作token消耗是主要成本。以下策略可以帮你优化1. 善用多模型路由这是最具性价比的优化手段。将不同的任务分配给最适合最便宜的模型。写手 (Writer)分配给你预算内效果最好的模型如GPT-4o、Claude-3.5-Sonnet。它直接决定内容质量。建筑师 (Architect)和规划师 (Planner)可以使用中等能力的模型如GPT-4o-mini它们处理的是结构化和摘要信息。审计员 (Auditor)和观察者/反射器可以使用速度快、成本低的模型如GPT-3.5-Turbo或更小的本地模型。它们的工作更多是比对和格式转换对“创意”要求低。雷达 (Radar)如果不需高质量分析甚至可以用免费的或极低成本的模型。2. 精细化控制输入治理plan和compose阶段不消耗LLM token却直接决定了给写手的上下文质量。花时间打磨好author_intent.md和current_focus.md让plan产出的意图更精准这样compose阶段筛选的上下文就更相关避免写手收到大量无关信息既浪费token又干扰判断。3. 启用SQLite记忆检索确保你在Node.js 22环境运行。这能大幅减少注入历史章节摘要时的token消耗对于长篇创作至关重要。4. 设定合理的章节字数不要盲目追求每章字数多。更长的章节意味着更复杂的上下文和更贵的审计。根据题材惯例如网文每章2000-4000字传统出版每章5000-8000字设置--chapter-words。InkOS的字数治理是柔性的设一个合理的中位数即可。4.3 高级技巧与心得“人工审核门控”的最佳实践InkOS的设计哲学是“AI自主人类监督”。不要试图让AI100%通过审计那意味着规则可能过于宽松。你应该将审计的“关键问题”阈值设得严格一些确保严重矛盾能被抓住。定期比如每写完10章使用inkos review list全面审阅一遍不仅看审计问题也从头到尾阅读内容感受故事节奏和人物弧光。利用inkos analytics命令查看高频审计问题。如果某个问题如“对话标签单一”反复出现可以考虑更新book_rules.md或调整文风指南来从根本上解决。利用“真相文件”进行宏观叙事管理不要只把真相文件当作AI的内部数据。作为作者你应该定期阅读它们尤其是subplot_board.md和pending_hooks.md。subplot_board.md能直观告诉你哪条支线已经很久没推进了。你可以据此更新current_focus.md“接下来两章推进一下女配角的家族线”。pending_hooks.md是你的“伏笔清单”。你可以主动规划哪些伏笔该在什么时候回收然后通过plan chapter的--context参数去引导AI。处理“AI味”即便有去AI味规则有时生成的内容仍难免有痕迹。除了使用revise --mode anti-detect进行反检测改写外还有一个更根本的方法准备一个“负面示例库”。创建一个bad-examples.md文件里面放一些你觉得“AI味”很浓的句子或段落。在book_rules.md中引用它并明确禁止出现类似表达。AI通过负面示例学习“不要怎么写”有时比告诉它“应该怎么写”更有效。版本管理与回滚InkOS在每章写作前都会创建状态快照。如果你对某一章及其引发的后续状态更新不满意可以使用inkos write rewrite [书ID] [章节号]回滚到写那一章之前的状态然后重新开始。这是一个非常强大的“后悔药”功能。经过几个月的深度使用我个人最大的体会是InkOS不是一个替代作者的工具而是一个将作者从“连续性苦力”中解放出来的副驾驶。它负责记住所有细节、检查逻辑漏洞、提供叙事选项而作者则负责把握故事的灵魂、人物的内核以及那些最闪光的创意瞬间。学会如何通过author_intent.md、current_focus.md和book_rules.md与它高效对话是发挥其威力的关键。开始时可能需要一些磨合一旦你掌握了这套“控制语言”就能指挥这个强大的AI创作引擎产出令人惊喜的连贯故事。