watersxya/dsh-novel-forge

Plugin插件 Native原生 ⭐ 2 Apache-2.0 Dev Workflow开发与代码工作流Docs & Writing文档与写作

AI 编译纯文本小说工作台 for DSH:大纲导入、道藏/大世界设定、卷与章节规划、逐章 AI 生成 3000-4000 字、九维审稿、全书质检、全本导出。AI novel writing workbench (text-only).

Project Overview项目介绍

dsh-novel-forge is a DSH-native AI novel-writing plugin packaged as a "novel compile workbench." It is installed through the DSH Web profile with the command dsh plugin --profile web add @waterwx/dsh-novel-forge@alpha, where the @alpha tag is mandatory because every release on the current line is a prerelease; alternatively a local checkout can be linked and dsh web restarted so the "Novel Forge" entry appears in the sidebar. The panel ships in Simplified Chinese only with no language switcher, targets version 1.3.0-alpha, and consumes DSH peer 0.1.2-alpha.3 alongside Node ^22.19.0 || >=24.0.0. It writes prose only and never generates images or video, surfacing every step inside the sidebar rather than as a separate web app or CLI tool.

The intended workflow has three phases aimed at long-form Chinese web novel and Wuxia authors. In setup, a user imports an outline via docx, paste, or split-from-txt, registers multiple books on the bookshelf, and binds genre bases, style templates, anti-AI rules, and a market radar that scans public leaderboards for fresh creative briefs. In planning, volume and chapter plans capture goals, plot points, payoff-hooks, ending hooks, must-advance and must-preserve items, plus character hard facts; continuation mode reads the previous chapter ending and fact anchors, and the prompt slots inject capped style, anti-AI, dialogue, and ending-hook snippets that remain subordinate to the bible, red lines, and compliance. In review, the AI Editor Agent scores nine dimensions and emits a checkable issue list that drives one-click merged revisions, selective fixes, paragraph-level rewrites, and de-AI polish with diff-then-adopt semantics; plotline health, tension curves, story timelines, role-library knowledge asymmetry, chapter snapshots, and the persistent fact ledger support continuity across long serials.

Operationally, all AI calls draw from the configured LLM (default deepseek-official / deepseek-flash) and batch runs are strictly serial, so quota consumption scales linearly with chapter count and quality remains gated by outline completeness. State lives under ~/.dsh/: a bookshelf JSON, author and global asset files, and per-book output directories holding novel-project.json, chapter Markdown, .bak.md backups, snapshots/ (up to twenty per chapter, undoable), run-state.json, and novel-assistant.jsonl. Tension and timeline outputs are advisory by default; automatic revisions only fire on high-severity review findings and are capped at two rounds per chapter, the usage ledger is in-process and resets on restart, and the production-run flow supports checkpointing, resume, tiered decline handling, and adaptation mode that remaps or rewrites an existing full text into a new book. Engineering gates include pnpm typecheck, pnpm test (14 files / 152 cases), pnpm build, plus theme-size, fallback-tier, and third-party scanners; CI runs the same chain on Node 24 + pnpm 9 and pnpm release re-runs it before publishing, with a failing suite blocking the release.

dsh-novel-forge 是一款 DSH 原生 AI 小说写作插件,定位为"AI 编译小说工作台",运行在 DSH Web 侧边栏的"小说工坊"面板内,专门把一份大纲"编译"成一整本纯文本小说。安装方式为 dsh plugin --profile web add @waterwx/dsh-novel-forge@alpha,也可在本地检出版本后链接、重启 dsh web,左侧即出现 Novel Forge 入口。面板与界面语言为简体中文单语,不提供英文切换;版本 1.3.0-alpha 须显式带上 @alpha 标签。

典型工作流涵盖开书与设定、规划与逐章写作、审稿与修订三大阶段:先通过书架或开书向导导入 docx/粘贴/txt 大纲,自动识别书名并登记多本书;再在卷/章节结构化计划中设定本章目标、剧情要点、必达项与硬事实,调用 LLM 流式生成 3000–4000 字的 Markdown 章节正文;最后由 AI 审稿 Agent 给出九维打分与可勾选问题清单,触发一键合并修订、局部改写或去 AI 味润色,适合长期连载的网文/Wuxia 题材作者。

依赖方面需要 Node ^22.19.0 || >=24.0.0 与 DSH peer 0.1.2-alpha.3,数据落在 ~/.dsh/ 下的 JSON 与各书输出目录;所有 AI 操作均调用 LLM 配额(默认 deepseek-official/deepseek-flash),批量串行,章节质量依赖大纲完整度,张力与时间线结论默认仅作建议,仅在 high 级时自动改稿且每章上限 2 轮。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 @waterwx/dsh-novel-forge

把 watersxya/dsh-novel-forge 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-novel-forge — AI 编译小说工作台 / AI Novel Writing Workbench

version DSH peer License CI

纯文本创作 AI 编辑 Agent 修订仲裁 长篇一致性 生产单 墨纸编辑风 阅读器 全本导出

你的专属 AI 小说写作插件:把一份大纲"编译"成一本完整的小说。

版本:2.1.0 · 定位:纯文本小说创作。所有环节(开书、设定、规划、写作、审校、质检、导出)都在侧边栏「小说工坊」面板内完成;不涉及图片 / 视频 / 分镜生成。

安装标签:2.0.0 起本项目已转正式版,latest 是默认标签,npm i @waterwx/dsh-novel-forge 即可。 只有在测试预发布版本时才需要显式带 @alpha。

界面语言:面板为简体中文单语(无语言切换)。本文档的中英对照是文档翻译,不代表界面提供英文。


功能一览 / Features

一、开书与设定 / Setup

中文 English
书架首页 + 开书向导:书卡网格(封面 / 简介 / 进度),新建书一步导入大纲(docx / 粘贴 / txt 全本拆章),书名自动识别;另支持「想法 → AI 多方案大纲」 Bookshelf + book wizard: card grid, one-step outline import (docx / paste / split from a full txt), auto book-name, idea → multi-option AI outline
多书切换与导入:书架登记多本书、切换即绑定;可导入已有项目目录或 txt/md 全本(拆章建项目) Multi-book: register & switch books; import an existing project dir or a full txt/md (split into chapters)
国风模块:总纲 / 道藏 / 大世界 / 人物志 / 暗线 / 编年录 / 文戒 / 笔法帖 / 心法 Wuxia-flavored modules: outline, story bible, world, characters, foreshadows, fact ledger, anti-AI rules, style templates, custom style
道藏提炼:从大纲与已写章节提炼人设 / 世界观 / 金手指规则 / 写作红线,注入生成与审稿 Story bible: extract personas / world rules / golden-finger rules / red lines from outline & written chapters, injected into generation and review
大世界:境界体系 / 区域 / 势力结构化编辑 + AI 提炼,注入每章生成与审稿 World: realms / regions / factions structured editing + AI extraction, injected per chapter
写作资产:题材基底 / 推进模式 / 笔法帖(叙事风格)/ 文戒(反 AI 规则)/ 心法(自定义文风),一键绑定本书 Writing assets: genre base / progression modes / style templates / anti-AI rules / custom style, one-click binding
题材雷达 → 灵感:扫榜(番茄 / 起点 / 晋江)→ 题材信号 / 生产底座 / 开书简报 → 一键生成贴合市场的开书灵感 Market radar → inspiration: scan public leaderboards → signals / production foundation / creative brief → market-fit book ideas
创意灵感 / 书分析:一句话或题材 → 多个差异化开书方向;粘贴任意文本 → 卖点 / 结构 / 可借鉴 / 风险 Inspiration / teardown: one idea → several directions; paste any text → selling points / structure / lessons / risks

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-gacha-calendar 下一个 Next dsh-mihome →