Back to search
novel-harness
SkillGitHub
一个旨在用 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
Markdown
[](/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)
- # Novel-Harness
- **面向老书虫转作者和已有作者的 AI 小说创作陪练。**
- **经过本人测试和实际落地小说章节的经历,现在的AI不适合直出内容,网上说的直出都是骗人的,之所以能看都是因为他们有人工精修,不然一眼AI味,所以我重新调整了项目的初衷,他现在更像是一个写作灵感陪练。**
- AI 帮你激发灵感、拆解章节、提供写作支架、检查问题和管理长篇上下文;你负责选择方向、完成表达、人工精修和最终定稿。
- `novel-harness` 不承诺一键生成可直接上架的小说。默认写作方式是把一章拆成一块块可手动填充的“空瓶”,帮助看得多、写得少的老书虫跨过卡文,也帮助已有作者获得脑洞、素材和第二视角。只有明确要求时才生成完整正文,并统一视为**待人工精修粗稿**。
- 项目现在也带有一个测试版知识包市场维护能力:服务器维护可下载的题材包、写作包和去 AI 化参考包,本地 MCP 负责查看列表、安装到 `.harness/knowledge/remote/`,再交给 RAG 做本地检索。当前阶段只开放下载和本地安装,不开放普通用户上传。
- ---
- ## 1. 一句话安装
- 把下面这句话发给 Codex、Claude Code、Cursor 或 OpenCode:
- ```text
- 请阅读当前项目的 docs/install.md,帮我一键安装 novel-harness:安装 novel-core,准备并启动 Studio Dashboard,并验证 /novel-core 与 http://127.0.0.1:8765 都可以使用。
- ```
- 安装文档:[docs/install.md](docs/install.md)
- 安装完成后有两个入口:
- ```text
- /novel-core 帮我写小说
- ```
- ```text
- http://127.0.0.1:8765
- ```
- `/novel-core` 用于在 AI 工具中规划、陪写和审稿;Dashboard 用于管理小说、章节、大纲、设定和 Markdown 正文。
- ---
- ## 2. 它能帮你做什么
- - **激发灵感**:通过定向追问,把模糊脑洞和阅读直觉变成可写方向
- - **开书与规划**:题材定位、主角设定、世界观、大纲、反转和黄金三章
- - **分块陪写**:把一章拆成足量写作块,告诉你每一小段可以写什么
- - **生成粗稿**:明确要求时生成完整初稿,交给作者继续精修
- - **审稿**:查逻辑、查节奏、查设定、查语病
- - **去 AI 味**:减少解释腔、自问自答、过度因果、段尾总结
- - **管上下文**:维护角色状态、章节摘要、伏笔、事件索引
- - **沉淀参考**:把题材样本、拆书规则、去 AI 化规则放入 RAG 检索
- - **扩展知识包**:通过本地 MCP 查看测试版知识包市场,并按需安装题材包、写作包、去 AI 化包
- 复制即用:
- ```text
- /novel-core 帮我创建一本全民求生小说
- /novel-core 帮我规划黄金三章
- /novel-core 把第一章拆成 12 个写作块,我自己填正文
- ```
- ```text
- /novel-core 这一章卡住了,先问我几个问题帮我找方向
- /novel-core 下一段可以往哪些方向发展
- /novel-core 直接生成第一章 2500 字完整粗稿,生成后标记待人工精修
- ```
- ```text
- /novel-core 帮我审稿
- /novel-core 查一下逻辑问题和节奏问题
- /novel-core 这章哪里像 AI,帮我改自然
- ```
- 只说“帮我写小说”时,系统会先进入开书规划,不会直接生成正文。准备写某一章时,默认返回分块写作指引;只有明确说“直接生成完整初稿”时才生成正文粗稿。如果你不知道写什么,系统会提供番茄大众方向和起点长线结构等平台素材供你选择,不替你锁定题材。
- ---
- ## 3. Studio Dashboard
- Studio Dashboard 直接管理本地 `projects/` 中的小说文件,不把正文上传到远端。首次运行会自动准备前端并打开浏览器:
- ```powershell
- python studio/run.py
- ```
- ### 查看创作进度
- 首页集中展示小说项目、章节数、总字数、待精修项和最近编辑,可以直接新建小说或继续上次工作。
- 
- ### 管理项目与章节
- 进入小说后,可以按正文、大纲、设定和状态分类管理 Markdown 文档,查看目标字数和创作准备情况。
- 
- ### 编辑正文并使用 AI 陪练
- 点击章节进入 Markdown 编辑器,左侧切换项目文档,中间编辑与预览,右侧可以实时询问下一段方向、拆分写作块或检查章节问题。
- 
- ### 配置 AI 模型
- 点击左下角 **AI 模型设置**,选择 DeepSeek、OpenAI、硅基流动、Ollama、LM Studio 或其他 OpenAI 兼容服务;读取模型后保存即可使用。
- 
- Studio 还支持历史恢复、回收站、浏览器草稿保护和外部修改冲突检测。详细说明见:[Studio 使用说明](studio/README.md)
- ---
- ## 4. RAG 参考检索
- RAG 用来检索项目里的题材参考、去 AI 味规则、审稿规则和案例文档。参考资料越多,它越能帮 Agent 找到合适的拆书样本、题材规则和人性化写法。
- 随项目自带的知识包位于 `.harness/knowledge/included/`,后续 MCP 下载的扩展知识包会进入 `.harness/knowledge/remote/`,再由 RAG 在本地构建索引。
- 开书、设计背景、大纲或正式写作前,系统会先推荐可选素材包;没有精准匹配时只给相近选项。用户确认前,不会强制启用任何题材包。
- 查看当前知识包:
- ```powershell
- python rag/scripts/sync_packs.py list
- python rag/scripts/sync_packs.py installed
- ```
- 第一次写小说可以先不启用 RAG;当你开始积累题材参考、拆书资料、去 AI 化案例后,建议安装并重建索引:
- ```powershell
- pip install -r rag/requirements.txt
- python rag/scripts/build_index.py
- ```
- 详细说明见:[知识包说明](docs/knowledge-packs.md)、[RAG 操作手册](rag/OPERATIONS.md)
- ---
- ## 5. 知识包下载与本地 MCP
- `novel-harness` 当前有一个测试版知识包下载链路,用来把服务器上的参考资料安装到本地 RAG。它不是完整的云平台,也不开放用户上传;现阶段只做“服务器列出可下载包,本地按需安装”。
- ```text
- 阿里云 OSS / 服务器
- └── 保存知识包 zip,并提供 manifest 与下载接口
- 本地 MCP
- └── 调用本仓库的 sync_packs.py,完成列表、安装、更新、删除和重建索引
- 本地 RAG
- └── 从 .harness/knowledge/remote/ 读取已安装知识包并构建索引
- ```
- 本地 MCP 服务入口:
- ```powershell
- python rag/mcp/knowledge_server.py
- ```
- 默认已配置测试版知识包市场,一般不需要手动传 manifest 地址。
- 当前可用工具:
- ```text
- list_knowledge_packs
- install_knowledge_pack
- update_knowledge_pack
- remove_knowledge_pack
- list_installed_packs
- rebuild_rag_index
- ```
- 目前已经验证:Codex 可以通过本地 MCP 读取服务器 manifest,看到 10 个云端知识包,并安装到 `.harness/knowledge/remote/`。后续再把它接入总编 / 规划 / 写作 / 审稿 Agent 的“缺资料时建议安装”流程。
- 
- ---
- ## 6. 专项文档
- - [AI 创作陪练设计原则](docs/design-principles.md)
- - [系统架构](docs/architecture.md)
- - [Agent 体系](docs/agents.md)
- - [创作管线](docs/pipeline.md)
- - [项目自定义与 Git 工作流](docs/usage.md)
- - [知识包说明](docs/knowledge-packs.md)
- - [RAG 操作手册](rag/OPERATIONS.md)
- ---
- ## 7. 去 AI 化效果示例
- `human-linguistics` 模块用于把偏工整、解释感重的 AI 文风,调整成更接近真人网文作者的叙述口气。
- | 优化前 | 优化后 |
- |:---:|:---:|
- |  |  |
- ---
- ## 8. 当前扩展能力
- ### 测试版知识包 MCP
- `novel-harness` 现在有一个本地 MCP 入口,用来管理远程知识包。
- 它目前解决的问题:
- - 从服务器 manifest 查看当前可用的参考资料包。
- - 把选中的 zip 包下载并安装到 `.harness/knowledge/remote/`。
- - 安装后重建本地 RAG 索引,让 Agent 可以检索这些参考资料。
- - 保持服务器只负责分发,本地 MCP 只负责写入本机仓库。
- 当前已支持:
- - 随项目自带知识包:去 AI 味、网文写作基础、全民求生。
- - 云端知识包:创意规划、设定框架、正文润色、商业化工具、玄幻、世情、四合院、狗血女文、知乎短篇、规则怪谈等。
- - 本地 MCP 工具调用:`list_knowledge_packs`、`install_knowledge_pack`、`rebuild_rag_index` 等。
- 当前边界:
- - 测试阶段不开放普通用户上传。
- - 本地 MCP 不直接访问 OSS,只请求服务器 manifest 和下载接口。
- - 服务器不写入用户本地 RAG,所有安装和索引都在用户本机完成。
- ---
- ## 致谢
- [](https://linux.do)
- 感谢 **linux.do** 社区的讨论、分享与支持。这个项目在方法论整理、实践思路和持续迭代上,都受益于社区氛围与成员交流。
- 感谢 [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 inFree to use. If it’s helped, pass it on.