[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80094":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":30,"discoverSource":31},80094,"novel-harness","manhai934\u002Fnovel-harness","manhai934","一个旨在用 AI 帮助没有写作经验的小白\u002F老书虫落地网文\u002F小说故事，使用了 Harness 架构思想，多个专项 Agent + Skills，同时维护了小说知识包市场","",null,"Python",74,9,57,1,0,2,4,16,6,50.6,"Other",false,"master",true,[],"2026-06-12 04:01:26","# Novel-Harness\n\n把 AI 变成小说创作团队：**先规划、再写作、再审稿、还能记住上下文，也能按需补充参考资料。**\n\n普通 AI 写小说容易忘设定、断伏笔、章节割裂、AI 味重。`novel-harness` 用 `\u002Fnovel-core` 把创作拆成总编、规划、写作、审稿、上下文五个 Agent，适合持续写同一本长篇网文。\n\n项目现在也带有一个测试版知识包市场维护能力：服务器维护可下载的题材包、写作包和去 AI 化参考包，本地 MCP 负责查看列表、安装到 `.harness\u002Fknowledge\u002Fremote\u002F`，再交给 RAG 做本地检索。当前阶段只开放下载和本地安装，不开放普通用户上传。\n\n---\n\n## 1. 安装\n\n把下面这句话发给 Codex、Claude Code、Cursor 或 OpenCode：\n\n```text\n请阅读 docs\u002Finstall.md，帮我安装 novel-core，并确认之后可以用 \u002Fnovel-core 帮我写小说 触发。\n```\n\n安装文档：[docs\u002Finstall.md](docs\u002Finstall.md)\n\n安装后直接输入：\n\n```text\n\u002Fnovel-core 帮我写小说\n```\n\n---\n\n## 2. 它能帮你做什么\n\n- **开书**：题材定位、主角设定、世界观、黄金三章方向\n- **规划**：大纲、反转、阶段目标、升级节奏、爽点链条\n- **写正文**：按当前项目状态续写章节或片段\n- **审稿**：查逻辑、查节奏、查设定、查语病\n- **去 AI 味**：减少解释腔、自问自答、过度因果、段尾总结\n- **管上下文**：维护角色状态、章节摘要、伏笔、事件索引\n- **沉淀参考**：把题材样本、拆书规则、去 AI 化规则放入 RAG 检索\n- **扩展知识包**：通过本地 MCP 查看测试版知识包市场，并按需安装题材包、写作包、去 AI 化包\n\n复制即用：\n\n```text\n\u002Fnovel-core 帮我创建一本全民求生小说\n\u002Fnovel-core 帮我规划黄金三章\n\u002Fnovel-core 写第一章\n```\n\n```text\n\u002Fnovel-core 续写下一章\n\u002Fnovel-core 按当前大纲写一段正文\n\u002Fnovel-core 继续写，但保持主角状态和伏笔一致\n```\n\n```text\n\u002Fnovel-core 帮我审稿\n\u002Fnovel-core 查一下逻辑问题和节奏问题\n\u002Fnovel-core 这章哪里像 AI，帮我改自然\n```\n\n只说“帮我写小说”时，系统不会直接乱写正文，而是先进入开书规划，确认题材、主角、世界观和开局方向。\n\n---\n\n## 3. RAG 参考检索\n\nRAG 用来检索项目里的题材参考、去 AI 味规则、审稿规则和案例文档。参考资料越多，它越能帮 Agent 找到合适的拆书样本、题材规则和人性化写法。\n\n随项目自带的知识包位于 `.harness\u002Fknowledge\u002Fincluded\u002F`，后续 MCP 下载的扩展知识包会进入 `.harness\u002Fknowledge\u002Fremote\u002F`，再由 RAG 在本地构建索引。\n\n查看当前知识包：\n\n```powershell\npython rag\u002Fscripts\u002Fsync_packs.py list\npython rag\u002Fscripts\u002Fsync_packs.py installed\n```\n\n第一次写小说可以先不启用 RAG；当你开始积累题材参考、拆书资料、去 AI 化案例后，建议安装并重建索引：\n\n```powershell\npip install -r rag\u002Frequirements.txt\npython rag\u002Fscripts\u002Fbuild_index.py\n```\n\n详细说明见：[知识包说明](docs\u002Fknowledge-packs.md)、[RAG 操作手册](rag\u002FOPERATIONS.md)\n\n---\n\n## 4. 知识包下载与本地 MCP\n\n`novel-harness` 当前有一个测试版知识包下载链路，用来把服务器上的参考资料安装到本地 RAG。它不是完整的云平台，也不开放用户上传；现阶段只做“服务器列出可下载包，本地按需安装”。\n\n```text\n阿里云 OSS \u002F 服务器\n  └── 保存知识包 zip，并提供 manifest 与下载接口\n\n本地 MCP\n  └── 调用本仓库的 sync_packs.py，完成列表、安装、更新、删除和重建索引\n\n本地 RAG\n  └── 从 .harness\u002Fknowledge\u002Fremote\u002F 读取已安装知识包并构建索引\n```\n\n本地 MCP 服务入口：\n\n```powershell\npython rag\u002Fmcp\u002Fknowledge_server.py\n```\n\n默认已配置测试版知识包市场，一般不需要手动传 manifest 地址。\n\n当前可用工具：\n\n```text\nlist_knowledge_packs\ninstall_knowledge_pack\nupdate_knowledge_pack\nremove_knowledge_pack\nlist_installed_packs\nrebuild_rag_index\n```\n\n目前已经验证：Codex 可以通过本地 MCP 读取服务器 manifest，看到 10 个云端知识包，并安装到 `.harness\u002Fknowledge\u002Fremote\u002F`。后续再把它接入总编 \u002F 规划 \u002F 写作 \u002F 审稿 Agent 的“缺资料时建议安装”流程。\n\n![MCP 知识包列表](docs\u002Fassets\u002Fmcp_list.png)\n\n---\n\n## 5. 专项文档\n\n- [系统架构](docs\u002Farchitecture.md)\n- [Agent 体系](docs\u002Fagents.md)\n- [创作管线](docs\u002Fpipeline.md)\n- [项目自定义与 Git 工作流](docs\u002Fusage.md)\n- [知识包说明](docs\u002Fknowledge-packs.md)\n- [RAG 操作手册](rag\u002FOPERATIONS.md)\n\n---\n\n## 6. 去 AI 化效果示例\n\n`human-linguistics` 模块用于把偏工整、解释感重的 AI 文风，调整成更接近真人网文作者的叙述口气。\n\n| 优化前 | 优化后 |\n|:---:|:---:|\n| ![去 AI 化优化前](docs\u002Fassets\u002Fdeslop-before.png) | ![去 AI 化优化后](docs\u002Fassets\u002Fdeslop-after.png) |\n\n---\n\n## 7. 当前扩展能力\n\n### 测试版知识包 MCP\n\n`novel-harness` 现在有一个本地 MCP 入口，用来管理远程知识包。\n\n它目前解决的问题：\n\n- 从服务器 manifest 查看当前可用的参考资料包。\n- 把选中的 zip 包下载并安装到 `.harness\u002Fknowledge\u002Fremote\u002F`。\n- 安装后重建本地 RAG 索引，让 Agent 可以检索这些参考资料。\n- 保持服务器只负责分发，本地 MCP 只负责写入本机仓库。\n\n当前已支持：\n\n- 随项目自带知识包：去 AI 味、网文写作基础、全民求生。\n- 云端知识包：创意规划、设定框架、正文润色、商业化工具、玄幻、世情、四合院、狗血女文、知乎短篇、规则怪谈等。\n- 本地 MCP 工具调用：`list_knowledge_packs`、`install_knowledge_pack`、`rebuild_rag_index` 等。\n\n当前边界：\n\n- 测试阶段不开放普通用户上传。\n- 本地 MCP 不直接访问 OSS，只请求服务器 manifest 和下载接口。\n- 服务器不写入用户本地 RAG，所有安装和索引都在用户本机完成。\n\n---\n\n## 致谢\n\n[![LINUXDO](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F%E7%A4%BE%E5%8C%BA-LINUXDO-0086c9?style=for-the-badge&labelColor=555555)](https:\u002F\u002Flinux.do)\n\n感谢 **linux.do** 社区的讨论、分享与支持。这个项目在方法论整理、实践思路和持续迭代上，都受益于社区氛围与成员交流。\n\n感谢 [oh-story-claudecode](https:\u002F\u002Fgithub.com\u002Fworldwonderer\u002Foh-story-claudecode) 和 [webnovel-writer](https:\u002F\u002Fgithub.com\u002FlingfengQAQ\u002Fwebnovel-writer) 给本项目带来的启发。\n","novel-harness 是一个基于 AI 的小说创作辅助工具，旨在帮助没有写作经验的小白或老书虫完成网文\u002F小说故事的创作。项目采用了 Harness 架构思想，通过多个专项 Agent（如总编、规划、写作、审稿和上下文管理）协同工作，确保故事的一致性和连贯性，并且能够记住上下文及按需补充参考资料。此外，它还维护了一个测试版的知识包市场，用户可以下载不同类型的写作资料来丰富自己的创作素材。此工具特别适合需要持续创作同一本长篇网络小说的作者使用，能够有效提升作品质量和创作效率。","2026-06-11 03:59:14","CREATED_QUERY"]