HNPX SDK
一系列工具 Hnpx -一种基于XML的分层格式，用于规划和撰写小说。该项目介绍了HNPX格式，并提供了用于创建、编辑和管理HNPX文档的工具。
起源
LLMs写不出好故事。 好吧，从技术上讲，他们可以写作 _一_ 好故事：它们会产生数千个遵循叙事惯例的单词。 但他们不会写字 _你的_ 故事，具体的故事只有你自己想。“AI可以写小说”和“AI不能写我想要的小说”之间的差距是下面描述的工作流程的核心。
让法学硕士写一整章，它会 用大约300个单词快速浏览情节。 试着逐段进行，你会发现AI 不知道什么时候停止一个场景，开始下一个场景。
这导致了实验 等级制度： 首先生成一个包含章节的详细章节计划，然后要求法学硕士根据该计划单独编写每个章节。这种方法改善了结构和字数：章节速度运行问题不那么严重，场景边界更清晰。这种分层方法需要自动化，我通过简单的Python脚本实现了自动化。然而，在没有指导的情况下，一个完全自动化的过程使LLM 写废话，根本不是我想要的。 文本中充满了错误，在用俄语写作时，这个问题更加明显，因为一般的LLM会产生明显较差的文本质量。
溶液演变成HNPX， 一种叙事规划格式，将写作过程从书本级概述到原子段落进行结构化。它允许 逐步扩展， 在每个级别保持上下文和控制，同时保持人为指导在流程中的核心地位。
为了将HNPX变为现实，我考虑构建一个自定义UI或VS Code扩展，但这太难了：从头开始创建一个完整的AI代理系统。相反，我意识到 Roo代码 已经提供了完美的基础。它灵活的模式系统意味着我可以构建一个 MCP服务器 并创建 自定义模式 使用它，创建HNPX所需的工作流程。HNPX构建了写入过程，以便 LLM在每一步都在人工指导下写作， 将他们从自主的讲故事者转变为反应灵敏的合作者。
太长，读不下去了 HNPX定义了一个结构化的写作工作流程，在这个流程中，LLM在每个级别都在人类的指导下写作，将AI从一个自主的故事讲述者转变为一个有指导的合作者。
HNPX是什么？
HNPX（分层叙事规划XML）是一种结构化的XML格式，专为规划和写作小说而设计。它将叙事内容组织成一个严格的层次结构，从书本层面的概述到单个段落，实现了一种循序渐进的扩展方法，在整个写作过程中保持上下文和控制。看 docs/HNPX.md 获取完整规格。
该格式支持高级规划（没有全文的摘要）和完整的文档（准备渲染的完整散文），使作家在创作过程的任何阶段都能灵活使用。
看 这个文件 作为HNPX文档的示例。
特性
- MCP服务器：用于AI代理集成的模型上下文协议服务器
- CLI工具：某些任务的命令行界面
- Roo代码集成：合作小说写作的自定义模式
- HNPX编辑器模式：创建和编辑分层叙事文档的交互模式 - 圣经作者模式：创建小说参考文献的专业模式
MCP工具
HNPX SDK提供了一套全面的 主控程序 （模型上下文协议）工具，使AI代理能够完全操纵HNPX文档，从创建新文档到编辑单个段落和重组叙事层次结构。看 docs/mcp-tools.md 以获取完整的文档。
安装
安装HNPX SDK：
pip install -e .
# or via uv
uv pip install -e .Roo代码模式设置
要使用自定义Roo Code模式进行HNPX编辑，请放置 .roomodes 在您的项目根目录中：