dsh-long-novel-workbench

dsh plugin --profile web add dsh-long-novel-workbench

📖 长篇中文小说工作台





一个装在 DeepSeek Harness（DSH） 里的长篇中文小说工作台：打开就能看全文；AI 只负责找问题和写修改稿，稿采纳进正文才生效。

当前版本 0.7.2（2026-10-27 发布）。0.7.1 把「审阅」重做成「问题单 + 修改稿」；0.7.2 把作者自己的意见接进同一张问题单（「＋ 作者提问题」「💭 宏观提议」），并让全文动作开工前先问「本次要求」、改写 / 扩写必须两次确认。

它解决什么痛点

写长篇的人都懂那种感觉：写到第三十章，突然想不起第三章里那个配角姓什么；伏笔埋了三十万字，自己先忘了埋在哪；设定越写越多，正文、大纲、笔记各说各话。更麻烦的是 AI——它会陪你聊，但要它先读完你的账本再动手，很难；它改起正文来又太快，你不敢直接让它改。

这个插件把写作台搭在数据上面：章节、人物、事实、时间线、地点、世界、伏笔、冲突、高光、大纲都收在同一本书的账本里；AI 通过工具读这些账本，只出问题与修改稿，正文只有你采纳修改稿之后才会改（唯一的正文落盘入口仍是写入闸门）。日常只做一件事——读、批注、找问题、采纳 / 继续改 / 忽略，循环着往前走。

不限文体：武侠、悬疑、科幻、言情、文学现实都可以。四套内置写作预设（标准长篇 / 冷峻悬疑 / 家国武侠 / 文学现实）加一套自定义模板，也可以让 AI 先出一套方案。

⚡ ATTENTION IS ALL YOU NEED

怎么吸引读者怎么来，一切为读者服务。先抓人，再自洽：每章必须有核心注意力；事实自洽是底线，不是目标。

• 注意力 = 通读审里的评分：一次通读给每章 0–100 分 + 一句结论，另给全书一个总分，结果写回注意力曲线；打分机制与展示跟之前一致。
• 四拍不再是门槛：动笔前只需写一句「本章靠什么抓人」；四拍（钩子 / 张力 / 回报 / 章末牵引）不再参与评价，历史设计记录按只读保留。
• 高光不是问题：通读中发现的亮点直接进账本，不占待办。

30 秒安装

1. 打开 DeepSeek Harness；

2. 进入 设置 → 插件；

3. 在安装框里输入包名：

   dsh-long-novel-workbench

4. 安装完成后刷新页面；

5. 左下角侧栏出现 📖 小说工作台，点开就能用。

也可以在命令行安装：

dsh plugin --profile <你的 profile> add dsh-long-novel-workbench

从源码或本地 link 安装（开发者）：git clone 后让 profile 指向本仓库（用 plugin_manager 的 install_bundle，target 填仓库绝对路径）。

第一次打开

• 已有作品（0.6.11 及更早）：旧数据还在 ~/StoryDesk/projects/<id>/，但 0.7 的数据形态变了（插件索引 + 每本书一个 DSH 工作区 + novel.db）。0.7 不会自动迁移 旧作品，用 node scripts/migrate-book-0.7.mjs --project <作品id> 迁移（默认 dry-run，--apply 写盘，旧目录保留）。
• 开新书：总览页或空库页点 ＋ 开新书 → 只填书名（同时作为工作区名）→ 选写作预设（或「自定义（让 AI 定）」）→ 写一段想法。工作台会创建作品、给这本书建一个独立 DSH 工作区，并在里面新开一个对话，把「方案 / 世界 / 地点 / 人物 / 全书大纲 / 伏笔」工作单发进去；AI 以提案提交，你批准后才进账本。
• 导入旧稿：设置页 📥 导入旧稿（顶栏「⬆ 导入」直达）可以扫描任意目录或单个 .md / .txt，不要求 0001.md 命名，导入会新建一部作品，原目录不动。
• 打开方式：侧栏 📖 小说工作台 = 在系统默认浏览器打开全屏网页版后台（认证复用 DSH，关掉 DSH 网页即失效）；侧栏 ⧉ = 不跳浏览器，留在 DSH 窗口内的浮层。手机 / DSH Remote 上，普通页面仍是 DSH，只有「在默认浏览器打开」生成的专属链接会直接进入工作台，窄屏有可滚动的顶部导航和常驻关闭按钮。

先看几张图

截图来自演示数据：一部 24 章的合成武侠长篇《云隐剑歌》，用于展示界面，不涉及任何真实作品。

问题页（0.7 新界面，截图待补） —— 「通读审」「事实与逻辑」两个入口；一张问题单，按类型 / 状态 / 范围 / 章节筛选；每条问题带修改稿，稿可以采纳、继续改或忽略，也可以勾选多条批量出稿。

下面的截图来自 0.6.11：正文页、全文动作、账本、地图、沉浸与手机布局在 0.7 线没有改。

正文页：打开就是全文 —— 左目录、中间连续阅读、右栏是本章注意力与问题统计。

全文动作 run —— 从头写 / 扩写 / 改写三种动作，阶段进度与预算一目了然。

总览 —— 置顶原则条与平均注意力 / 最低三章 / 未测章数，下面是注意力曲线与待办。

账本 · 世界地图 —— 按地点坐标直绘：分区、水线山形、驿道路线与地名避让。

账本 · 人物卡 —— 按主角 / 反派 / 配角分组，几十号人物一眼能扫。

沉浸模式 —— 收掉顶栏、导航与侧栏，正文接近全屏，只留阅读 / 编辑 / 批注三颗按钮和字号。

手机阅读 —— 窄屏布局、长按选字加批注、字号照样可调。

核心循环：读 → 批注 → 找问题 → 采纳 / 继续改 / 忽略

一步 · 你做什么 · 工作台做什么

读 · 在正文页连续读全本，或只看某一章 · 打开就是全文：j / k 翻章、/ 搜索并精确跳到命中段落、字号 13–28px 与行距可调、记住阅读位置

批注 · 切到批注模式，选中正文里不顺的那句，写下你的意见 · 落成一条问题（来源标为「作者」），和 AI 找到的问题进同一张问题单

找问题 · 选范围（单章 / 跨章 / 全局），跑「通读审」或「事实与逻辑」 · 一份 TXT 交给一个 AI 一次读完：通读审给评分 + AI 化 / 文风 / 其他问题 + 高光；事实与逻辑先自动扫库，可选再让 AI 审这版

改 · 看修改稿 → 采纳；不满意写「我的要求」继续改；AI 误报可以「忽略」；多条可以批量出稿 · 段级稿替换该段、整章稿整章替换；采纳后问题关闭并标出写入位置；原文变了的稿不删、问题回到继续改；忽略不删除、可撤销

0.7 线只重做「审阅 → 问题单 → 修改稿 → 采纳 / 继续改」这一块（0.7.1 落地；0.7.2 补上作者提问题 / 宏观提议与全文动作要求）。 编辑器（含自由增删段落）、注意力打分机制、账本、数据库与同步、全文生成 / 改写、导出、世界地图、写作预设都没有动；旧意见数据保留在数据里，但不再迁移进问题单，旧的审阅 / 冷读 / 拆分链路已经下线。

AI 产出的修改稿不会背着你改正文：只有你点采纳才会写入（仍走写入闸门）。批量写 / 扩 / 改走「全文动作」的 run，同样按阶段推进、可暂停可中止。

功能一览

正文页优先：连续阅读、页内编辑、读者批注

• 连续阅读：三栏布局（目录 ｜ 阅读区 ｜ 右栏），默认打开就是全文，不是一页一张表单。
• 三种模式：阅读（纯读，不改正文）｜ 编辑（页内 textarea 直改正文，停止输入 2 秒自动保存，⌘S 立即保存；正文被别人改过时按内容指纹拦下来提示刷新）｜ 批注（选中正文文字即可加读者批注）。
• 搜索与目录：全文搜索点结果精确跳到命中段落；目录可新建 / 删除章节。删除会一并清理本章相关记录，章节历史版本保留。
• 单章历史版本：每次保存正文有变化都会自动备份，历史版本可预览、可载回编辑器（载回后仍要保存才写盘）。
• 阅读位置同步（0.6.11）：阅读 / 编辑 / 批注三种模式共用同一个位置，精度到段落。阅读切编辑会打开本章并把编辑器滚到那一段、光标落在段首；编辑切回阅读会落回光标所在段；滚动停下 300ms 后写到本机 localStorage，重开页面回到同一段。沉浸模式切换也不会退回章首。这些只存本机浏览器，不写回作品文件。
• 沉浸模式（0.6.10）：工具栏 ⛶ 沉浸 收掉顶栏、左导航、目录、右栏与原则条，正文区只留「阅读 / 编辑 / 批注」三颗按钮和字号 − 15 +；Esc 先退出沉浸（不会顺手关掉工作台）；开关记在本机。
• 仿纸正文底（0.6.10）：阅读区与正文编辑器共用同一张暖纸（极淡纤维纹理），编辑器不再用等宽字体，和阅读共用字号 / 行距——改稿时看到的就是成稿的样子；宽屏窄屏一致，纸色不随宿主明暗主题反转。
• 手机 / 窄屏：窄屏自适应布局；批注靠长按选字加批注（批注框是贴底面板）；字号上下限（13–28px）在手机上真的生效，不加载任何网络字体。

找问题：两个入口（通读审 / 事实与逻辑）

• 通读审（冷读 + 去 AI 化合并）：选范围 → 导出 TXT（单章 / 明确列出的跨章 / 全书）→ 一个 AI 从头读到尾，一次交付：每章注意力 0–100 + 全书结论、AI 化 / 文风漂移 / 其他等问题（读到逻辑与事实也一并记录；每条带范围、严重度、位置、修改稿），以及直接进账本的高光。不再有「先出总结、再按章拆分」。
• 事实与逻辑（单独一档）：先「自动扫库」（0 AI，扫账本与数据库，列出人物 / 时间 / 数字 / 专名 / 设定上的可疑点，自动存成一条「事实扫库」审稿记录）；需要时再点「让 AI 审这版」，把 TXT + 可疑点交给一个 AI 一次读完，判真假、找跨章连锁、给修改稿。本档重点是「逻辑与事实」。
• 全量记录：任何一档都只决定「首要目标」，不是过滤器——通读审读到逻辑 / 事实矛盾也一并提交（logic-fact），事实与逻辑读到成对重复段落、文风问题也按 style / other 提交；不让你为漏掉的问题再读一遍。
• 范围只有三种：单章 / 跨章（明确章号，例：第 2 章 + 第 15 章）/ 全局（全书）。不按 5 章 / 10 章自动分批；要分批由你指定章号。
• 铁律：必须给 TXT、一个 AI 读完，不拆子 agent、不分章合并——跨章和全局问题只有一次读完才看得出来。
• 问题分四类：AI 化 / 逻辑与事实 / 文风漂移·较差 / 其他；每

…(truncated)