Skip to content
Back to search

dsh-novel-writer

大肥鱼的小说工坊 — DSH 网络小说创作插件:九阶段门禁式创作流程 + 世界书设定注入 + 本地书籍导入 + AI 一键润色 + 去AI味 + 黄金三章诊断 + 百万字一致性 + 市场调研与模板复制。

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/akira399--dsh-novel-writer/badge.svg)](/listings/akira399--dsh-novel-writer)

HTML

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

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> 需已装 DSH(跨 Windows/macOS/Linux;运行时 Node ≥18)。**本版本要求 DSH Desktop / CLI `0.2.0-rc.2` 或更高**(`@deepseek-ai/cordis` 4.0.4); > v0.1.x 系列是给 `0.1.0-rc.6` 的旧版,在 0.2.0 上会加载失败(见下方「版本对照」)。

① 一句话让 AI 装(推荐)

把下面这段发给能执行命令的 AI:

> 帮我安装 DSH 插件「大肥鱼的小说工坊」(dsh-novel-writer),**只装最新版 0.2.x**。步骤:从 `https://github.com/akira399/dsh-novel-writer/releases/latest` 下载最新的 `dsh-external-dsh-novel-writer-*.tgz`(版本号最大的那个;别下 v0.1.x,那是给旧版 DSH 的)→ 执行 `dsh plugin --profile web add <该 tgz 绝对路径>` → `dsh plugin list` 确认在列且已启用 → 提醒我刷新 DSH 页面(Ctrl+Shift+R)。遇到报错先告诉我再处理。

② 手动下载装

从 https://github.com/akira399/dsh-novel-writer/releases/latest 下载最新的 `dsh-external-dsh-novel-writer-*.tgz`,然后:

dsh plugin --profile web add <该文件路径>
dsh plugin list        # 看到 dsh-novel-writer 即成功

③ 源码构建装(进阶)

需 Node ≥22 与 Git:

git clone https://github.com/akira399/dsh-novel-writer.git && cd dsh-novel-writer
npm install && npm run verify && npm run build && npm pack
dsh plugin --profile web add ./dsh-external-dsh-novel-writer-0.2.0.tgz

(Windows 用 Git Bash 跑构建脚本)

**装完**:侧边栏出现「大肥鱼的小说工坊」、设置 → 插件 出现同名页签即完成;没有就刷新页面/重启 DSH 并在插件列表确认已启用。

✅ 三种方式装完后,确认「能用全部功能」

不论用哪种方式,装完都应看到👇,即可正常使用本项目所有功能:

- **侧边栏底部**出现「大肥鱼的小说工坊」入口(工作台抽屉:项目/创建/写章/润色/诊断/导入/世界书…) - **设置 → 插件**出现「大肥鱼的小说工坊」页签(启用开关 + 数据目录,默认 `~/.dsh/dsh-novel-writer`) - **新会话**自动带出技能 `novel-writing-workflow`(创作全流程指导) - **新建会话的模式选择器**里可选中预设「大肥鱼的小说工坊」(对话驱动创作)

> 💡 若某块没出现:先刷新页面;不行就重启 DSH,再在「设置 → 插件」里确认该插件「启用」开关是打开的。

📌 版本对照(务必对号入座)

| 插件版本 | 目标 DSH | settings 命名空间 | 设置页位置 | | --- | --- | --- | --- | | **0.2.0**(当前) | **0.2.0-rc.2+**(cordis 4.0.4) | `dsh-novel-writer` | 设置 → 插件 → 页签 | | 0.1.x(旧) | 0.1.0-rc.6 | `dsh-novel-writer` | 设置卡(`settings.plugin.item`,**该 slot 已移除**) |

0.2.0 的适配要点:DSH 删除了 `@deepseek-ai/dsh-client-runtime` 包与 `settingsNamespace()`/`settings.register()` API, 并移除了 `settings.plugin.item` slot;本版改用 `ctx.configForms` + `settings.plugins.tab` / `sidebar.footer.action` slot。

--

装好后

- 侧边栏底部出现「**大肥鱼的小说工坊**」入口(工作台抽屉) - 设置 → 插件 → **大肥鱼的小说工坊**(启用开关 + 数据目录) - 新会话出现技能 `novel-writing-workflow`(创作全流程方法) - agent 预设「大肥鱼的小说工坊」可选(新建会话模式选择器)

---

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 · 341 lines

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

  1. <p align="center">
  2. <img src="./assets/brand/banner.svg" alt="大肥鱼的小说工坊 — DSH 网络小说创作插件" width="100%">
  3. </p>
  4. # 大肥鱼的小说工坊(dsh-novel-writer)
  5. 一个面向 [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/guide/quickstart)(DSH)的网络小说创作插件:
  6. **九阶段门禁式创作流程 + 世界书(lorebook)设定注入 + 本地书籍导入 + AI 一键润色 + 去 AI 味 + 黄金三章诊断 + 百万字一致性保障**。
  7. - 中文 | [English](./README.en.md)
  8. <p align="center">
  9. <img src="./assets/brand/logo.png" alt="大肥鱼的小说工坊 Logo" width="120">
  10. </p>
  11. 让 DSH 像一位专业的网文编辑与你协同:从选题、设定、人设、大纲到分章、正文、修订、完本,每一步有模板、有门禁、可校验、可回滚;并有世界书把你的设定固化下来,确保百万字不崩设定。
  12. ---
  13. ## ✨ 功能特性
  14. ### 九阶段门禁式创作流程
  15. `选题 → 设定 → 人设 → 大纲 → 分卷 → 细纲 → 正文 → 修订 → 完本`
  16. - **阶段门禁**:未批准不能跳阶段(可用户显式放行/回退),杜绝模型"口头跳阶段"
  17. - **产物版本快照**:每阶段每次提交留档 `versions/<phase>/v<n>`,可回退任意历史版本
  18. - **审计日志**:每次 commit / 放行 / 回滚写入 `audit.jsonl`
  19. ### 世界书(lorebook)设定注入
  20. - 关键词 / 正则触发 + 常驻注入,条目按书绑定(每本书独立栏目)
  21. - 导入支持 **Operit / SillyTavern / 角色卡** 三格式,自动兼容警告
  22. - **导出到酒馆**:世界书面板点「**导出到酒馆**」直接下载 SillyTavern 原生 lorebook JSON(`{entries:[...]}`)即可在酒馆「Import」导入作前置设定;也可用 `lorebook_export_entries format=sillytavern` 走对话导出
  23. - **AI 一键生成设定**:按书名+题材自动生成 4-6 条核心设定并绑定本书
  24. - 注入 token 预算裁剪,长上下文不爆窗
  25. <p align="center">
  26. <img src="./assets/screenshots/shot-worldbook.png" alt="世界书(设定注入)面板" width="440">
  27. </p>
  28. ### 质量保障
  29. - **AI 味检测与去除**:内置 234 词 5 类词库 + 密度评分 + 一键改写
  30. - **黄金三章诊断**:规则层离线必出分(钩子/开场/冲突/灌输/字数/对话)+ 可选模型层深度诊断
  31. - **四族校验**:结构/内容/剧情/一致性,提交即检(字数/标题/禁用词/视角/钩子/细纲覆盖/账本冲突)
  32. ### 百万字一致性
  33. - **事实账本**:章节内 `<JSONPatch>` 自动落账(人物境界/物品/地点状态),冲突检测与巡检
  34. - **时间线**:书内时间归一 + 倒挂检测;**伏笔**登记与回收跟踪;**世界书自动沉淀建议**
  35. - **上下文包三层记忆**(L1 全书设定 + L2 卷章细纲前文 + L3 摘要/变量/世界书)预算恒定(压测 100 万字 0 超限)
  36. ### 一键写作与润色
  37. - **一键写章**:host 直写(上下文包 → 正文 → 自动落盘),章节统计/账本/审计联动;写作指令强调**严格遵循本章细纲/全书设定/前文事实**,避免自创冲突
  38. - **一键润色**:AI 做**重构式润色**——整句重写、大胆扩写、可在段后添加细节描写(只守情节/人物/设定底线),改动按**段落**拆成建议,每条可**单独采纳/拒绝**(也可全部采纳/全部拒绝),只保存你选中的改动
  39. - **采纳即预览**:点「采纳这条」→ 顶部原文视图中该段**立即显示润色文并标绿**,新增段实时插入,取消采纳立即恢复——所见即所得
  40. - **字级 diff 标亮**:每条建议段内标出具体改动(删除线=删,黄底=新增/改写处)
  41. - **逐条可定位**:每条建议带「📍 定位」跳到原文对应段落
  42. - **逐步撤销**:可撤销 AI 润色与手动编辑,还原到任意历史状态
  43. <p align="center">
  44. <img src="./assets/screenshots/shot-writing.png" alt="一键写章界面" width="440">
  45. <img src="./assets/screenshots/shot-polish.png" alt="一键润色 + diff 标亮预览" width="440">
  46. </p>
  47. ### 本地导入 & 配套工具
  48. - **导入本地书籍**:txt/md 自动识别章节并建书(含 md frontmatter 题材/书名)
  49. - **27 类题材**标签(玄幻/仙侠/武侠/西幻/都市/现实/科幻/悬疑/言情/轻小说/流派向…)
  50. - **修订**(校对/节奏/文风三模式)、**导出**(txt/markdown/平台排版)
  51. - **市场调研**辅助(web_search 引导 + 落盘 `reports/market.md`)、**模板复制**(克隆完本品为模板)、灵感库/伏笔/术语表/账本查询
  52. ### GUI 工作台 + 41 个 agent 工具
  53. - 侧边栏「大肥鱼的小说工坊」抽屉:项目列表 / 创建 / 详情 / 一键写章 / 润色 / 诊断 / 导入 / 世界书管理
  54. - 抽屉可展开、自动避让聊天框条;润色预览清晰展示
  55. - 内置 60 个提示词模板(创作/文风 8 套/去味/润色/诊断/引导/世界书),`novel_prompts` 可浏览渲染
  56. <p align="center">
  57. <img src="./assets/screenshots/shot-presets.png" alt="大肥鱼的小说工坊工作台(项目面板)" width="720">
  58. </p>
  59. ### 🎭 小说创作模式预设(agent 预设)
  60. 插件随包装载一个 **「大肥鱼的小说工坊」agent 预设**,在 DSH 新建会话时的模式选择器里即可选用——选中即"一键进入创作模式",不需要每次手动交代要写小说、要走流程。
  61. **三通道协同,约束模型行为**:
  62. 1. **模式锚定(本预设)**——预设锚定创作 persona(名称为「大肥鱼的小说工坊」,描述声明确创作的九阶段门禁方法),新建会话即进入目标模式;
  63. 2. **软引导(技能)**——随 enabling 自动注册的 `novel-writing-workflow` 技能,进入会话后加载完整创作方法论(阶段定义、模板用法、工具写法、写作规范),即使你不用 GUI 也知道每一步该怎么做;
  64. 3. **硬轨道(工具)**——host 注册的 41 个 `novel_*` / `lorebook_*` 工具随预设全程可调,阶段推进、产物提交、校验、写章都必须走工具,防止模型"口头跳阶段"。
  65. **为什么用预设**:
  66. - **零初始化成本**:选它开新会话即锚定"资深网文作者"视角,直接开聊「创建项目,写本玄幻小说」就能跑通全流程;
  67. - **不丢流程**:阶段门禁、世界书纪律、账本一致性这些硬约束靠工具与技能自动织入,你只需提出创作意图;
  68. - **与 GUI 互补**:预设适合"对话驱动"创作(说一句写一章、给一段去 AI 味),GUI 工坊适合"可视化操作"(看项目列表、点按钮写章/润色/导入),两者共用同一份项目数据与流程。
  69. **使用方式**:新建会话 → 预设选择器选「大肥鱼的小说工坊」→ 直接开始创作;或安装后自动同步到本地 `~/.dsh/.agent-presets/novel-writer/`(升级插件自动更新)。
  70. <p align="center">
  71. <img src="./assets/screenshots/shot-gui.png" alt="DSH 主界面(大肥鱼的小说工坊预设工作空间)" width="820">
  72. </p>
  73. ---
  74. ## 🎯 使用场景
  75. | 场景 | 怎么做 |
  76. | --- | --- |
  77. | 从零开一本新书 | 打开工坊 → 输入书名/选题材 → 或用「五步向导」逐步引导 |
  78. | 已有完本/定好的设定 | 用「模板复制」克隆一本带完整设定骨架的新书,直接开写正文 |
  79. | 想要热门题材方向 | 「市场调研」→ 引导 web_search 查榜单热词 → 落盘选题参考 |
  80. | 把本地网文 txt/md 收进 DSH 续写 | 「导入本地书籍」→ 自动建书分章 → 可直接继续润色/续写 |
  81. | 保证不崩设定 | 世界书固化设定 + 账本巡检 + 一致性校验在写作时自动织入 |
  82. | 写完投稿 | 「导出 txt」或 Markdown / 平台排版下载 |
  83. ---
  84. ## 📦 安装
  85. > 需已装 DSH(跨 Windows/macOS/Linux;运行时 Node ≥18)。**本版本要求 DSH Desktop / CLI `0.2.0-rc.2` 或更高**(`@deepseek-ai/cordis` 4.0.4);
  86. > v0.1.x 系列是给 `0.1.0-rc.6` 的旧版,在 0.2.0 上会加载失败(见下方「版本对照」)。
  87. ### ① 一句话让 AI 装(推荐)
  88. 把下面这段发给能执行命令的 AI:
  89. > 帮我安装 DSH 插件「大肥鱼的小说工坊」(dsh-novel-writer),**只装最新版 0.2.x**。步骤:从 `https://github.com/akira399/dsh-novel-writer/releases/latest` 下载最新的 `dsh-external-dsh-novel-writer-*.tgz`(版本号最大的那个;别下 v0.1.x,那是给旧版 DSH 的)→ 执行 `dsh plugin --profile web add <该 tgz 绝对路径>` → `dsh plugin list` 确认在列且已启用 → 提醒我刷新 DSH 页面(Ctrl+Shift+R)。遇到报错先告诉我再处理。
  90. ### ② 手动下载装
  91. 从 https://github.com/akira399/dsh-novel-writer/releases/latest 下载最新的 `dsh-external-dsh-novel-writer-*.tgz`,然后:
  92. ```bash
  93. dsh plugin --profile web add <该文件路径>
  94. dsh plugin list # 看到 dsh-novel-writer 即成功
  95. ```
  96. ### ③ 源码构建装(进阶)
  97. 需 Node ≥22 与 Git:
  98. ```bash
  99. git clone https://github.com/akira399/dsh-novel-writer.git && cd dsh-novel-writer
  100. npm install && npm run verify && npm run build && npm pack
  101. dsh plugin --profile web add ./dsh-external-dsh-novel-writer-0.2.0.tgz
  102. ```
  103. (Windows 用 Git Bash 跑构建脚本)
  104. **装完**:侧边栏出现「大肥鱼的小说工坊」、设置 → 插件 出现同名页签即完成;没有就刷新页面/重启 DSH 并在插件列表确认已启用。
  105. ### ✅ 三种方式装完后,确认「能用全部功能」
  106. 不论用哪种方式,装完都应看到👇,即可正常使用本项目所有功能:
  107. - **侧边栏底部**出现「大肥鱼的小说工坊」入口(工作台抽屉:项目/创建/写章/润色/诊断/导入/世界书…)
  108. - **设置 → 插件**出现「大肥鱼的小说工坊」页签(启用开关 + 数据目录,默认 `~/.dsh/dsh-novel-writer`)
  109. - **新会话**自动带出技能 `novel-writing-workflow`(创作全流程指导)
  110. - **新建会话的模式选择器**里可选中预设「大肥鱼的小说工坊」(对话驱动创作)
  111. > 💡 若某块没出现:先刷新页面;不行就重启 DSH,再在「设置 → 插件」里确认该插件「启用」开关是打开的。
  112. ### 📌 版本对照(务必对号入座)
  113. | 插件版本 | 目标 DSH | settings 命名空间 | 设置页位置 |
  114. | --- | --- | --- | --- |
  115. | **0.2.0**(当前) | **0.2.0-rc.2+**(cordis 4.0.4) | `dsh-novel-writer` | 设置 → 插件 → 页签 |
  116. | 0.1.x(旧) | 0.1.0-rc.6 | `dsh-novel-writer` | 设置卡(`settings.plugin.item`,**该 slot 已移除**) |
  117. 0.2.0 的适配要点:DSH 删除了 `@deepseek-ai/dsh-client-runtime` 包与 `settingsNamespace()`/`settings.register()` API,
  118. 并移除了 `settings.plugin.item` slot;本版改用 `ctx.configForms` + `settings.plugins.tab` / `sidebar.footer.action` slot。
  119. --
  120. ### 装好后
  121. - 侧边栏底部出现「**大肥鱼的小说工坊**」入口(工作台抽屉)
  122. - 设置 → 插件 → **大肥鱼的小说工坊**(启用开关 + 数据目录)
  123. - 新会话出现技能 `novel-writing-workflow`(创作全流程方法)
  124. - agent 预设「大肥鱼的小说工坊」可选(新建会话模式选择器)
  125. ---
  126. ## 🚀 快速开始(3 分钟)
  127. 1. 打开侧边栏「大肥鱼的小说工坊」→ 点「一键导入示例《青云问道》」(或输入书名创建)
  128. 2. 进入项目详情 → 「一键写章」→ 按上下文包自动出正文 → 已存盘;不满意可「一键润色」
  129. 3. 或直接在对话里说:
  130. - 「创建项目,写本玄幻小说」
  131. - 「帮我写下一章」
  132. - 「把这段去 AI 味」「诊断一下开头」
  133. - 「克隆《青云问道》当模板」「调研下仙侠市场行情」
  134. - 「导入本地 txt」
  135. 数据目录默认 `~/.dsh/dsh-novel-writer/`:
  136. ```
  137. lorebook/ 世界书(entries/groups/settings)
  138. projects/ 项目(book.json + docs/ + chapters/ + audit.jsonl + ledger.json + ...)
  139. ```
  140. ---
  141. ## 📖 功能使用指南
  142. > 下面按功能逐个说明「在**界面哪里点** / 在**对话里怎么说**」,两种方式共用同一份数据与流程,随你习惯。
  143. ### 1️⃣ 创建一本书(九阶段流程的起点)
  144. - **界面**:打开「大肥鱼的小说工坊」抽屉 → 顶部输入**书名** → 选**题材**(27 种,按分组排列)→ 点「创建」。
  145. - **对话**:「创建项目,写本玄幻小说」「新书,仙侠」「开本都市文」。
  146. - 创建后进入项目详情,看到当前阶段(初始为 `topic` 选题)与各阶段状态。
  147. > 也可以先点「**一键导入示例《青云问道》**」,一步得到一本带世界书条目的示例书,边看边学。
  148. ### 2️⃣ 走完九阶段(选题→…→完本)
  149. - 阶段链:`选题 → 设定 → 人设 → 大纲 → 分卷 → 细纲 → 正文 → 修订 → 完本`,**前一阶段未批准不能进入下一阶段**(门禁)。
  150. - **怎么推进**:
  151. - **对话**:说「生成世界观设定」「设计人设」「写全书大纲」,模型会用相应模板产出该阶段文档;完成后说「提交设定」走 `novel_commit` → 校验通过即批准解锁下一阶段。
  152. - **界面**:目前阶段推进主要通过对话里的 agent 工具完成(`novel_phase` / `novel_commit`),舞台右上角会显示当前阶段与门禁状态。
  153. - 产物自动存 `docs/<阶段>.md` + 留历史版本(`versions/<阶段>/v<N>`),随时可回退。
  154. ### 3️⃣ 写正文(一键写章)
  155. - **界面**:项目详情 → 选**章节号** → 点「**一键写章并保存**」→ 模型按「全书设定+本卷/本章细纲+前文+世界书命中等」的上下文包自动写一章 → **已自动存盘**,统计/账本/审计联动。
  156. - **对话**:「帮我写下一章」「写第 5 章」「继续写」。
  157. - 写好后左侧编辑框/B 面板可看到正文与字数(达标徽标)。不满意就点「一键润色」或手动改。
  158. ### 4️⃣ 润色与撤销
  159. - **一键润色**:点「**一键润色**」→ 模型**重构式润色**(整句重写/大胆扩写/可新增细节段,只守情节人物底线)→ 改动按**段落**列成建议,每条可**单独采纳/拒绝**,顶部**原文视图会随采纳/撤销实时变化**(采纳的段变绿显示润色文、新增段实时插入)→ 「确认保存」按你采纳的改动写入章节,或「放弃还原」恢复原文。
  160. - **撤销**:编辑区上方「↶ 撤销(N)」按钮。手动编辑、写章回填、润色应用都会记录历史,可**连续点击逐步还原**到任意之前的状态。
  161. ### 5️⃣ 建世界书(固化设定,不崩设定)
  162. - **入口**:项目详情右下「**本书世界书**」,或抽屉列表里书籍行的「世界书」按钮。
  163. - **AI 一键生成**:世界书面板先在上方「栏目」下拉选一本书 → 点「**AI 一键生成设定**」→ 按书名+题材自动生成 4-6 条核心设定(世界观/主角/宗门/境界等)并绑定本书。
  164. - **手动**:点「+ 新建条目」→ 填名称/内容/触发关键词(逗号分隔)/是否常驻/优先级,并「绑定到本书」。
  165. - **导入已有设定**:`lorebook_import_entries`(Operit / SillyTavern / 角色卡格式,可直接发文件)。
  166. - **导出到酒馆**:世界书面板点「**导出到酒馆**」→ 下载 `novel-lorebook-export.json` → 在 SillyTavern「Import」导入即可当前置设定(也可对话 `lorebook_export_entries format=sillytavern`)。
  167. - 写作时命中的条目会自动注入上下文包(每书独立栏目,`Lorebook`)。
  168. ### 6️⃣ 导入本地书籍
  169. - **界面**:项目列表「**导入本地书籍**」→ 选一个本地 `.txt` / `.md` 网文文件 → 自动识别章节标题(含"第一章/楔子/番外"等)并建书 → 全部正文按章同步,可直接续写/润色。
  170. - **对话**:「导入本地 txt」。
  171. ### 7️⃣ 质量体检(诊断 / 去 AI 味 / 校验)
  172. - **结构诊断**:项目详情底部「**结构诊断**」→「诊断本章」→ 得分与问题(钩子/开场/冲突/灌输/字数/对话)。
  173. - **去 AI 味**:对话「把这段去 AI 味」→ `novel_depolish` 检测并改写(内置 234 词 5 类词库)。
  174. - **四族校验**:提交时自动跑结构/内容/剧情/一致性;也可对话「校验这章」手动触发 `novel_validate`。
  175. ### 8️⃣ 保持一致性(长文不崩设定)
  176. - **事实账本**:章节内 `<JSONPatch>` 自动落账(人物境界/物品/地点状态)。
  177. - **巡检**:对话「跑一遍一致性巡检」→ `novel_consistency_audit` 查账本冲突、时间线倒挂、伏笔超期,并给出世界书沉淀建议。
  178. - **查账本**:「林远现在什么境界」「查一下账本」→ `novel_ledger`。
  179. - **伏笔/时间线**:对话「登记个伏笔,第 3 章埋,第 20 章回收」「记录第 5 章书内时间『第三日』」→ `novel_foreshadow` / `novel_timeline`。
  180. ### 9️⃣ 修订与导出
  181. - **修订**:对话「修订第 3 章,校错别字」→ `novel_revise`(校对/节奏/文风三模式,产出**新版本不覆盖原稿**)。
  182. - **导出**:界面项目详情「**导出 txt**」(带 BOM,可直接投稿);对话「导出成稿」→ `novel_export`(txt / markdown / 平台排版)。
  183. ### 🔟 市场调研 & 模板复制
  184. - **市场调研**(选题用):对话「调研下仙侠的市场行情」→ `novel_market_research` **mode=prompt** 给你一组 `web_search` 检索词 → 模型检索后以 **mode=report** 把榜单热词/读者偏好/同类卖点落盘 `reports/market.md` → 选题报告里引用。
  185. - **模板复制**(克隆设定骨架):对话「以《青云问道》为模板开本新书」→ `novel_clone_project` 复制**字数目标/风格/禁用词 + 已完成的阶段设定文档**(选题/设定/人设/大纲/分卷/细纲),**正文不复制**,状态机重置——直接对着现成设定写正文。
  186. ### 1️⃣1️⃣ 灵感 / 术语表
  187. - 对话「记个灵感:雨夜剑冢」「建个术语表:玄天宗——地域宗门」→ `novel_idea` / `novel_glossary`(选题拉取聚合、术语注入防用词漂移)。
  188. ### 1️⃣2️⃣ 用「创作模式预设」开新会话
  189. - 新建会话 → 预设选择器选「**大肥鱼的小说工坊**」→ 直接对话「创建项目,写本玄幻小说」即进入创作模式(persona + 技能方法 + 41 个工具自动就位)。
  190. > 💡 **提示**:几乎每个功能都有对应的 `novel_*` 工具,模型在创作模式下会自己调用并提示你确认(写操作)。你不必记命令,**用大白话提需求即可**;想知道有哪些能力,对话里说「小说工坊能做什么」。
  191. ---
  192. ## ⚙️ 配置
  193. | 设置 | 默认 | 说明 |
  194. | --- | --- | --- |
  195. | enabled | true | 插件总开关(关闭即注销工具/技能,数据保留) |
  196. | dataDir | `~/.dsh/dsh-novel-writer` | 数据根目录 |
  197. | uiHidden | false | 隐藏侧边栏「大肥鱼的小说工坊」入口(存于浏览器本地,任何环境可用;即时生效) |
  198. > 设置入口:**设置 → 插件 → 大肥鱼的小说工坊**(0.2.0 起由 `settings.plugins.tab` 提供)。
  199. > 这些字段也可直接写在 profile 的 `cordis.patch.yml` 里;写入后会重新装配插件(普通配置变更走
  200. > Loader 的常规更新生命周期,无需手动重启)。
  201. 项目级(创建时/模板复制保留):**27 题材**、每章字数目标(默认 2000-4000)、风格(视角/禁用词/AI 味词)、阶段门禁开关。
  202. ---
  203. ## 🔌 与 DSH 的交互
  204. - **41 个 agent 工具**:`novel_*`(项目/阶段/写章/校验/诊断/去味/巡检/账本/克隆/导出/市场调研…)+ `lorebook_*`(世界书 CRUD)+ `novel_prompts`(提示词库)
  205. - **两段式写章协议**:`novel_write_chapter` 返回上下文包 → 模型输出正文 → `novel_commit_chapter` 落盘(统计/账本/审计)
  206. - **技能**:`novel-writing-workflow`(流程纪律与方法指导)
  207. - **GUI 数据面**:`/api/novel-writer/*`(项目/章节/上下文/诊断/润色/导入,fence 头校验)
  208. ---
  209. ## ❓ 常见问题(FAQ)
  210. **Q:为什么要先发起一次对话才能写章/润色?**
  211. A:本插件复用你的主模型路由(`llm/stream` 捕获),不持有独立密钥。首次请先在会话里发一句话让模型路由就绪。
  212. **Q:导入的书正文会丢吗?**
  213. A:不会。txt/md 按章节标题自动切分(含粘连标题、楔子/番外等),无法识别的按段落分块,内容完整同步。
  214. **Q:润色/写章会覆盖我的原稿吗?**
  215. A:一键写章自动落盘(可撤销);一键润色先预览 diff,确认才保存,放弃可还原原文。
  216. **Q:世界书 AI 生成的内容安全吗?**
  217. A:生成后是「待确认」的条目,写入前你可编辑/删除;注入时按书隔离。
  218. ---
  219. ## 🧪 开发
  220. ```bash
  221. npm run typecheck # host + client 双段
  222. npm test # vitest(336 例)
  223. npm run build # tsc host + tsdown client(纯 Node,Windows 无需 bash)
  224. npm run deploy # 构建并部署到本机 profile,且强制刷新 bundle 版本号
  225. npm run build:host:bash # 仅当宿主固定调用 bash scripts/build.sh 时使用
  226. node scripts/simulate-1m.mjs # 百万字一致性压测
  227. ```
  228. > ⚠️ **改了客户端界面后必须用 `npm run deploy`(或手动更新 mtime)**
  229. >
  230. > DSH 用**文件时间戳 + 大小**计算客户端 bundle 的版本号(`artifactRevision`,
  231. > 见 `@deepseek-ai/dsh-client-modules`),**不读文件内容**。而 `npm pack` 会把文件时间
  232. > 归零到 1985 年、`tar` 解包又保留它 —— 于是覆盖安装时版本号不变、URL 不变,
  233. > Chromium 的 `immutable, max-age=31536000` 缓存会一直返回**旧字节**,
  234. > 即使磁盘内容已更新、宿主已重启也一样。
  235. >
  236. > `npm run deploy` 会在拷贝后把 `lib/client.js` 的 mtime 刷新为当前时间,
  237. > 保证产生新的版本号;部署后需重启 DSH 才会重新计算并下发。
  238. 目标 DSH 版本:**0.2.0-rc.2**(`@deepseek-ai/cordis` 4.0.4)。
  239. 升级 DSH 时请同步 `package.json` 的 `peerDependencies` / `devDependencies` 与
  240. `dsh.client.inject`,并重跑 `npm run verify`。
  241. 模块开发纪律:每模块 → 单测 → 复盘(见 [docs/MODULE-LOG.md](./docs/MODULE-LOG.md))。
  242. ---
  243. ## 🛡 安全模型
  244. - 数据仅存本地 `~/.dsh/dsh-novel-writer/`,不联网上传
  245. - 所有写操作走审计日志;LLM 辅助调用复用主模型路由,无独立密钥
  246. - GUI 路由带自定义头校验(防 CSRF/dns-rebinding);未启用返回 503
  247. - 市场调研仅在你显式调用工具时触发搜索(复用会话 web_search)
  248. ## 📄 许可
  249. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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