Skip to content
Back to search

novel-harness

一个旨在用 AI 辅助引导老书虫落地网文/小说故事,自带小说管理网页Dashboard,使用了 Harness 架构思想,多个专项 Agent + Skills,同时维护了小说知识包市场

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/manhai934--novel-harness/badge.svg)](/listings/manhai934--novel-harness)

HTML

<a href="/listings/manhai934--novel-harness"><img src="/api/listings/manhai934--novel-harness/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 232 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Novel-Harness
  2. **面向老书虫转作者和已有作者的 AI 小说创作陪练。**
  3. **经过本人测试和实际落地小说章节的经历,现在的AI不适合直出内容,网上说的直出都是骗人的,之所以能看都是因为他们有人工精修,不然一眼AI味,所以我重新调整了项目的初衷,他现在更像是一个写作灵感陪练。**
  4. AI 帮你激发灵感、拆解章节、提供写作支架、检查问题和管理长篇上下文;你负责选择方向、完成表达、人工精修和最终定稿。
  5. `novel-harness` 不承诺一键生成可直接上架的小说。默认写作方式是把一章拆成一块块可手动填充的“空瓶”,帮助看得多、写得少的老书虫跨过卡文,也帮助已有作者获得脑洞、素材和第二视角。只有明确要求时才生成完整正文,并统一视为**待人工精修粗稿**。
  6. 项目现在也带有一个测试版知识包市场维护能力:服务器维护可下载的题材包、写作包和去 AI 化参考包,本地 MCP 负责查看列表、安装到 `.harness/knowledge/remote/`,再交给 RAG 做本地检索。当前阶段只开放下载和本地安装,不开放普通用户上传。
  7. ---
  8. ## 1. 一句话安装
  9. 把下面这句话发给 Codex、Claude Code、Cursor 或 OpenCode:
  10. ```text
  11. 请阅读当前项目的 docs/install.md,帮我一键安装 novel-harness:安装 novel-core,准备并启动 Studio Dashboard,并验证 /novel-core 与 http://127.0.0.1:8765 都可以使用。
  12. ```
  13. 安装文档:[docs/install.md](docs/install.md)
  14. 安装完成后有两个入口:
  15. ```text
  16. /novel-core 帮我写小说
  17. ```
  18. ```text
  19. http://127.0.0.1:8765
  20. ```
  21. `/novel-core` 用于在 AI 工具中规划、陪写和审稿;Dashboard 用于管理小说、章节、大纲、设定和 Markdown 正文。
  22. ---
  23. ## 2. 它能帮你做什么
  24. - **激发灵感**:通过定向追问,把模糊脑洞和阅读直觉变成可写方向
  25. - **开书与规划**:题材定位、主角设定、世界观、大纲、反转和黄金三章
  26. - **分块陪写**:把一章拆成足量写作块,告诉你每一小段可以写什么
  27. - **生成粗稿**:明确要求时生成完整初稿,交给作者继续精修
  28. - **审稿**:查逻辑、查节奏、查设定、查语病
  29. - **去 AI 味**:减少解释腔、自问自答、过度因果、段尾总结
  30. - **管上下文**:维护角色状态、章节摘要、伏笔、事件索引
  31. - **沉淀参考**:把题材样本、拆书规则、去 AI 化规则放入 RAG 检索
  32. - **扩展知识包**:通过本地 MCP 查看测试版知识包市场,并按需安装题材包、写作包、去 AI 化包
  33. 复制即用:
  34. ```text
  35. /novel-core 帮我创建一本全民求生小说
  36. /novel-core 帮我规划黄金三章
  37. /novel-core 把第一章拆成 12 个写作块,我自己填正文
  38. ```
  39. ```text
  40. /novel-core 这一章卡住了,先问我几个问题帮我找方向
  41. /novel-core 下一段可以往哪些方向发展
  42. /novel-core 直接生成第一章 2500 字完整粗稿,生成后标记待人工精修
  43. ```
  44. ```text
  45. /novel-core 帮我审稿
  46. /novel-core 查一下逻辑问题和节奏问题
  47. /novel-core 这章哪里像 AI,帮我改自然
  48. ```
  49. 只说“帮我写小说”时,系统会先进入开书规划,不会直接生成正文。准备写某一章时,默认返回分块写作指引;只有明确说“直接生成完整初稿”时才生成正文粗稿。如果你不知道写什么,系统会提供番茄大众方向和起点长线结构等平台素材供你选择,不替你锁定题材。
  50. ---
  51. ## 3. Studio Dashboard
  52. Studio Dashboard 直接管理本地 `projects/` 中的小说文件,不把正文上传到远端。首次运行会自动准备前端并打开浏览器:
  53. ```powershell
  54. python studio/run.py
  55. ```
  56. ### 查看创作进度
  57. 首页集中展示小说项目、章节数、总字数、待精修项和最近编辑,可以直接新建小说或继续上次工作。
  58. ![Studio Dashboard 创作工作台](docs/assets/studio-dashboard.png)
  59. ### 管理项目与章节
  60. 进入小说后,可以按正文、大纲、设定和状态分类管理 Markdown 文档,查看目标字数和创作准备情况。
  61. ![Studio 小说项目与章节管理](docs/assets/studio-project.png)
  62. ### 编辑正文并使用 AI 陪练
  63. 点击章节进入 Markdown 编辑器,左侧切换项目文档,中间编辑与预览,右侧可以实时询问下一段方向、拆分写作块或检查章节问题。
  64. ![Studio Markdown 编辑器与 AI 陪练](docs/assets/studio-editor.png)
  65. ### 配置 AI 模型
  66. 点击左下角 **AI 模型设置**,选择 DeepSeek、OpenAI、硅基流动、Ollama、LM Studio 或其他 OpenAI 兼容服务;读取模型后保存即可使用。
  67. ![Studio AI 模型设置](docs/assets/studio-ai-settings.png)
  68. Studio 还支持历史恢复、回收站、浏览器草稿保护和外部修改冲突检测。详细说明见:[Studio 使用说明](studio/README.md)
  69. ---
  70. ## 4. RAG 参考检索
  71. RAG 用来检索项目里的题材参考、去 AI 味规则、审稿规则和案例文档。参考资料越多,它越能帮 Agent 找到合适的拆书样本、题材规则和人性化写法。
  72. 随项目自带的知识包位于 `.harness/knowledge/included/`,后续 MCP 下载的扩展知识包会进入 `.harness/knowledge/remote/`,再由 RAG 在本地构建索引。
  73. 开书、设计背景、大纲或正式写作前,系统会先推荐可选素材包;没有精准匹配时只给相近选项。用户确认前,不会强制启用任何题材包。
  74. 查看当前知识包:
  75. ```powershell
  76. python rag/scripts/sync_packs.py list
  77. python rag/scripts/sync_packs.py installed
  78. ```
  79. 第一次写小说可以先不启用 RAG;当你开始积累题材参考、拆书资料、去 AI 化案例后,建议安装并重建索引:
  80. ```powershell
  81. pip install -r rag/requirements.txt
  82. python rag/scripts/build_index.py
  83. ```
  84. 详细说明见:[知识包说明](docs/knowledge-packs.md)、[RAG 操作手册](rag/OPERATIONS.md)
  85. ---
  86. ## 5. 知识包下载与本地 MCP
  87. `novel-harness` 当前有一个测试版知识包下载链路,用来把服务器上的参考资料安装到本地 RAG。它不是完整的云平台,也不开放用户上传;现阶段只做“服务器列出可下载包,本地按需安装”。
  88. ```text
  89. 阿里云 OSS / 服务器
  90. └── 保存知识包 zip,并提供 manifest 与下载接口
  91. 本地 MCP
  92. └── 调用本仓库的 sync_packs.py,完成列表、安装、更新、删除和重建索引
  93. 本地 RAG
  94. └── 从 .harness/knowledge/remote/ 读取已安装知识包并构建索引
  95. ```
  96. 本地 MCP 服务入口:
  97. ```powershell
  98. python rag/mcp/knowledge_server.py
  99. ```
  100. 默认已配置测试版知识包市场,一般不需要手动传 manifest 地址。
  101. 当前可用工具:
  102. ```text
  103. list_knowledge_packs
  104. install_knowledge_pack
  105. update_knowledge_pack
  106. remove_knowledge_pack
  107. list_installed_packs
  108. rebuild_rag_index
  109. ```
  110. 目前已经验证:Codex 可以通过本地 MCP 读取服务器 manifest,看到 10 个云端知识包,并安装到 `.harness/knowledge/remote/`。后续再把它接入总编 / 规划 / 写作 / 审稿 Agent 的“缺资料时建议安装”流程。
  111. ![MCP 知识包列表](docs/assets/mcp_list.png)
  112. ---
  113. ## 6. 专项文档
  114. - [AI 创作陪练设计原则](docs/design-principles.md)
  115. - [系统架构](docs/architecture.md)
  116. - [Agent 体系](docs/agents.md)
  117. - [创作管线](docs/pipeline.md)
  118. - [项目自定义与 Git 工作流](docs/usage.md)
  119. - [知识包说明](docs/knowledge-packs.md)
  120. - [RAG 操作手册](rag/OPERATIONS.md)
  121. ---
  122. ## 7. 去 AI 化效果示例
  123. `human-linguistics` 模块用于把偏工整、解释感重的 AI 文风,调整成更接近真人网文作者的叙述口气。
  124. | 优化前 | 优化后 |
  125. |:---:|:---:|
  126. | ![去 AI 化优化前](docs/assets/deslop-before.png) | ![去 AI 化优化后](docs/assets/deslop-after.png) |
  127. ---
  128. ## 8. 当前扩展能力
  129. ### 测试版知识包 MCP
  130. `novel-harness` 现在有一个本地 MCP 入口,用来管理远程知识包。
  131. 它目前解决的问题:
  132. - 从服务器 manifest 查看当前可用的参考资料包。
  133. - 把选中的 zip 包下载并安装到 `.harness/knowledge/remote/`。
  134. - 安装后重建本地 RAG 索引,让 Agent 可以检索这些参考资料。
  135. - 保持服务器只负责分发,本地 MCP 只负责写入本机仓库。
  136. 当前已支持:
  137. - 随项目自带知识包:去 AI 味、网文写作基础、全民求生。
  138. - 云端知识包:创意规划、设定框架、正文润色、商业化工具、玄幻、世情、四合院、狗血女文、知乎短篇、规则怪谈等。
  139. - 本地 MCP 工具调用:`list_knowledge_packs`、`install_knowledge_pack`、`rebuild_rag_index` 等。
  140. 当前边界:
  141. - 测试阶段不开放普通用户上传。
  142. - 本地 MCP 不直接访问 OSS,只请求服务器 manifest 和下载接口。
  143. - 服务器不写入用户本地 RAG,所有安装和索引都在用户本机完成。
  144. ---
  145. ## 致谢
  146. [![LINUXDO](https://img.shields.io/badge/%E7%A4%BE%E5%8C%BA-LINUXDO-0086c9?style=for-the-badge&labelColor=555555)](https://linux.do)
  147. 感谢 **linux.do** 社区的讨论、分享与支持。这个项目在方法论整理、实践思路和持续迭代上,都受益于社区氛围与成员交流。
  148. 感谢 [oh-story-claudecode](https://github.com/worldwonderer/oh-story-claudecode) 和 [webnovel-writer](https://github.com/lingfengQAQ/webnovel-writer) 给本项目带来的启发。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.