XN-289/dsh-NINGLET-novel-Agent
专门适配于 DeepSeek v4 pro 正式版 与 DeepSeek Harness 上的小说创作插件:让 AI 写小说,但读者闻不出 AI 味。
Project Overview项目介绍
NINGLET is a native novel-writing plugin built specifically for the DeepSeek Harness ecosystem, and its single stated purpose is to let AI write fiction that does not read as machine-generated. Rather than acting as a black-box prompt that turns an outline into prose, it exposes a controllable production line composed of book creation, chapter writing (planning, orchestration, drafting, anti-AI-flavor audit, revision, settlement), disk persistence, and a chapter panel for review. Integration happens through four shipped artefacts: a preset/agent.cordis.yml preset, five SKILL.md skill files, a Host domain tool (plugins/host-novel.js), and a Client chapter panel (plugins/client-novel-ui.js), all activated inside DSH via cordis_define / cordis_run on the live ning-1/pkg-4 dynamic-plugin channel. Authoritative state is written under the session workspace at novels/<bookId>/ as both a validated JSON file and human-readable Markdown projections.
The intended workflow is conversational and agent-driven: a user simply asks the assistant to "create an urban-cultivation novel called 吞天魔帝", which seeds a book, generates an 8-to-12 chapter outline, and applies the 25 universal craft rules plus the matching genre-specific rule set (xuanhuan / urban / mystery / romance / sci-fi / history). Asking the assistant to "write the next chapter, focusing on the master-disciple conflict" launches the chapter pipeline; if no intent has been recorded, a Socratic three-question gate (core advancement, protagonist state, closing hook) fires first. During drafting, the 12-dimension anti-AI engine continuously scans for forbidden words, template phrases, AI-style transitions, 的/地 density, sentence-length variance, uniform paragraph length, three-beat parallelisms, sentimental paragraph endings, repeated dialogue tags, cliché density, formulaic pivots, and list-shaped structure, and any single hit automatically triggers the full four-stage rewrite (point-removal, structural repair, stylistic rewrite, human-voice injection). A separate novel-qa skill performs 10-dimension consistency checks and outputs a 0-to-100 AI-flavor score. The audience is long-form web-fiction writers and studios who want continuity across hundreds of chapters without manually polishing every awkward sentence.
Dependencies and operational caveats: NINGLET requires Node.js to execute the 99 pure-function unit tests via node --test, which are all green, plus a DeepSeek Harness instance capable of loading dynamic plugins through cordis_define / cordis_run. The license is MIT, so the code can be freely reused and modified, and the harness-packages/ directory already contains source for a future standard DSH distribution. First-run notes: story/state/state.json is the single source of truth and a schema validator refuses to persist malformed state, so any migration or reset must deliberately preserve that file; the control-plane documents (author_intent.md, current_focus.md, book_rules.md) are auto-generated when a book is created and refreshed after each chapter, but authors are free to edit them to override the default genre rule sets.
NINGLET 是 DeepSeek Harness 生态里的原生小说创作插件,定位是「让 AI 写小说但读者闻不出 AI 味」。它不是黑盒式生成器,而是把流程拆成「建书 → 写章(规划 → 编排 → 写作 → 反 AI 味审计 → 修订 → 结算)→ 落盘 → 章节面板回看」的生产线。集成方式是通过 preset/agent.cordis.yml 预设、5 个 SKILL.md 技能、plugins/host-novel.js 与 plugins/client-novel-ui.js 动态插件挂载到 DSH 上,由 cordis_define / cordis_run 在 ning-1/pkg-4 通道中激活。状态统一写入会话工作区的 novels/<bookId>/,提供 JSON 权威态与 Markdown 可读投影两类文件供人和模型共同读取。
典型用法是用户用自然语言触发插件:在对话里说「创建一本都市修仙小说《吞天魔帝》」即建书并自动产出 8-12 章大纲与通用 25 条加题材专属规则;说「写下一章,重点写师徒矛盾」即开始写章流程,若未给意图还会先做苏格拉底三问。写章过程中 12 维反 AI 味引擎会持续检测,一旦命中 50+ 禁用词、模板词、AI 过渡词、句长方差异常、排比三连等任意一项就自动跑完 4 阶段重写(定点清除→结构修复→风格改写→人味注入),同时伏笔按 HookRecord 生命周期推进并做 stale/blocked 诊断。配套还有 novel-qa 10 维一致性审查与 0-100 AI 味评分。适合需要长篇连载、对文风一致性要求高、又不愿逐章手工打磨违和感的网文作者与工作室。
依赖方面:运行需要 Node.js(用于跑 node --test 共 99 个纯函数单测,全部为绿)与一个可加载动态插件的 DeepSeek Harness 实例(当前在 ning-1/pkg-4 通道验证)。许可为 MIT,可自由使用与改造;harness-packages/ 下还预留了未来打包为标准 DSH 包的源码。首启提醒:story/state/state.json 是唯一权威态,坏数据会被 schema 校验拒绝写入,所以迁移或重置时需手工保留该文件;控制面文档(author_intent.md / current_focus.md / book_rules.md)建书时自动生成,写章后会刷新,可在创作过程中随时编辑覆盖默认题材规则。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-NINGLET-novel-Agent(XN-289/dsh-NINGLET-novel-Agent)
仓库:https://github.com/XN-289/dsh-NINGLET-novel-Agent
本站详情页:https://www.yhbd.top/plugins/xn-289-dsh-ninglet-novel-agent/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 2 · 最近提交 2026-08-17 · 主语言 JavaScript · 未检测到 DSH 插件清单
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
- Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
- No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项
Compatibility兼容性
- DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
- External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
- Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册
Security安全性
- Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
- Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
- curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
- Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
- Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
- Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式
Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add github:XN-289/dsh-NINGLET-novel-Agent
把 XN-289/dsh-NINGLET-novel-Agent 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
NINGLET
让 AI 写小说,但读者闻不出 AI 味。
跑在 DeepSeek Harness 上的小说创作插件 —— 专门写小说,也专门把「AI 味」挡在正文之外。
是什么
NINGLET 是 DeepSeek Harness 生态里的一个小说创作插件。它不是「输入大纲、吐正文」的黑盒,而是一条可控的生产线:
建书 → 写章(规划 → 编排 → 写作 → 反 AI 味审计 → 修订 → 结算)→ 落盘 → 章节面板回看。
它由四部分组成:预设(agent.cordis.yml)、技能(5 个 SKILL.md)、插件(Host 领域工具 + Client 章节面板)、纯函数核心(可独立测试的反 AI 味引擎 / 状态校验 / 字数 / bookId)。
特性
- 反 AI 味引擎:12 维确定性检测(50+ 禁用词、模板禁用词、AI 过渡词、的字密度、句长方差、段落等长、排比三连、段尾抒情、对话标签重复、套话密度、公式化转折、列表式结构)+ 4 阶段重写(定点清除→结构修复→风格改写→人味注入)。检测发现任何问题全自动走全 4 阶段。
- 伏笔生命周期:完整 HookRecord(open→progressing→deferred→resolved),半衰期自动推导(immediate=10章 / mid-arc=30 / endgame=80),stale 过期检测 + blocked 因果链受阻检测,观察者自动抽取并合并(状态不可回退)。
- 结构化状态树:currentState 事实表(位置/主角状态/目标/冲突)、结构化章节摘要(events/stateChanges/hookActivity/mood/chapterType)、Markdown 人类可读投影(current_state.md / pending_hooks.md / chapter_summaries.md)。
- 控制面文档:author_intent.md(长期意图)+ current_focus.md(近期关注,含过期/受阻伏笔警告)+ book_rules.md(通用 25 条 + 题材专属规则,可编辑)。建书时自动生成,写章后自动刷新。
- 题材规则体系:通用 25 条创作规则 + 6 大题材专属规则(玄幻/都市/悬疑/言情/科幻/历史),写章时注入 writer prompt。
- 苏格拉底规划:写章前若没给意图,先追问「核心推进 / 主角状态 / 结尾钩子」三问。
- 章回大纲:建书时给创作简报,自动生成 8-12 章大纲。
- 结构树 + 画布:右下角「小说」面板——结构视图(大纲/章节/角色/伏笔)+ 画布视图(章节节点连线)。
- 结构化状态:每本书的状态是校验后的 JSON(
story/state/state.json),坏数据拒绝写入。
快速开始
# 1. 纯函数核心单测
node --test # 99 个测试,全绿
# 2. 在 DeepSeek Harness 里加载(当前用动态插件 ning-1/pkg-4 运行中)
# - Host 工具:plugins/host-novel.js 作为 code.host
# - Client 面板:plugins/client-novel-ui.js 作为 code.client
# 通过 cordis_define / cordis_run 定义并激活
# 3. 在对话里说
# 「创建一本都市修仙小说《吞天魔帝》」
# 「写下一章,重点写师徒矛盾」
状态落盘在会话工作区的 novels/<bookId>/ 下:
story/state/state.json(权威状态,含 book/chapters/summaries/hooks/characters/currentState/outline)chapters/NNN.md(正文)story/current_state.md/pending_hooks.md/chapter_summaries.md(Markdown 投影,人类可读)story/author_intent.md/current_focus.md/book_rules.md(控制面文档)story/runtime/chapter-NNN.intent.md(每章意图存档)
技能
NINGLET 把「写小说」拆成 5 个可被 DeepSeek Harness 直接调用的技能:
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
yogsoth-ai/de-anthropocentric-research-engine
ZSeven-W/dsh-openpencil
HanaAyane/dsh-reasoning-effort
HuanLinOTO/dsh-plugin-better-sidebar-plugin-office
joeseesun/qiaomu-rss-dsh