@waterwx/dsh-novel-forge 1.3.0-alpha → 1.3.1-alpha
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +362 -236
- package/lib/client.js +575 -732
- package/lib/index.js +320 -9
- package/lib/types/client/api.d.ts +9 -1
- package/lib/types/client/locales.d.ts +7 -63
- package/lib/types/client/panel/TensionView.d.ts +5 -1
- package/lib/types/client/panel/TimelineView.d.ts +5 -1
- package/lib/types/client/panel/helpers.d.ts +5 -3
- package/lib/types/index.d.ts +1 -1
- package/lib/types/protocol.d.ts +44 -1
- package/lib/types/revision.d.ts +76 -0
- package/lib/types/run.d.ts +8 -0
- package/lib/types/tension.d.ts +0 -12
- package/package.json +1 -1
- package/src/client/api.ts +767 -758
- package/src/client/locales.ts +158 -418
- package/src/client/panel/NovelPanel.tsx +5559 -5517
- package/src/client/panel/TensionView.tsx +17 -1
- package/src/client/panel/TimelineView.tsx +208 -192
- package/src/client/panel/helpers.ts +7 -5
- package/src/index.ts +323 -323
- package/src/protocol.ts +2431 -2383
- package/src/revision.ts +283 -0
- package/src/routes.ts +3772 -3724
- package/src/run.ts +391 -346
- package/src/tension.ts +251 -240
package/README.md
CHANGED
|
@@ -1,236 +1,362 @@
|
|
|
1
|
-
# dsh-novel-forge — AI 编译小说工作台 / AI Novel Writing Workbench
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<img alt="version" src="https://img.shields.io/badge/version-1.
|
|
5
|
-
<img alt="DSH" src="https://img.shields.io/badge/DSH
|
|
6
|
-
<img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue" />
|
|
7
|
-
<a href="https://github.com/watersxya/dsh-novel-forge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/watersxya/dsh-novel-forge/actions/workflows/ci.yml/badge.svg?branch=main" /></a>
|
|
8
|
-
</p>
|
|
9
|
-
|
|
10
|
-
<p align="center">
|
|
11
|
-
<img alt="
|
|
12
|
-
<img alt="AI 编辑 Agent" src="https://img.shields.io/badge/AI%20%E7%BC%96%E8%BE%91%20Agent-%E2%9C%93-blue" />
|
|
13
|
-
<img alt="
|
|
14
|
-
<img alt="
|
|
15
|
-
<img alt="
|
|
16
|
-
<img alt="
|
|
17
|
-
<img alt="
|
|
18
|
-
<img alt="全本导出" src="https://img.shields.io/badge/%E5%85%A8%E6%9C%AC%E5%AF%BC%E5%87%BA-%E2%9C%93-blue" />
|
|
19
|
-
</p>
|
|
20
|
-
|
|
21
|
-
你的专属 AI 小说写作插件：把一份大纲"编译"成一本完整的小说。
|
|
22
|
-
|
|
23
|
-
**版本：`1.
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
|
36
|
-
|
|
37
|
-
|
|
|
38
|
-
|
|
|
39
|
-
|
|
|
40
|
-
|
|
|
41
|
-
|
|
|
42
|
-
|
|
|
43
|
-
|
|
|
44
|
-
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
|
49
|
-
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
|
59
|
-
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
-
|
|
228
|
-
-
|
|
229
|
-
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
1
|
+
# dsh-novel-forge — AI 编译小说工作台 / AI Novel Writing Workbench
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img alt="version" src="https://img.shields.io/badge/version-1.3.0--alpha-blue" />
|
|
5
|
+
<img alt="DSH peer" src="https://img.shields.io/badge/DSH%20peer-0.1.2--alpha.3-blue" />
|
|
6
|
+
<img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue" />
|
|
7
|
+
<a href="https://github.com/watersxya/dsh-novel-forge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/watersxya/dsh-novel-forge/actions/workflows/ci.yml/badge.svg?branch=main" /></a>
|
|
8
|
+
</p>
|
|
9
|
+
|
|
10
|
+
<p align="center">
|
|
11
|
+
<img alt="纯文本创作" src="https://img.shields.io/badge/%E7%BA%AF%E6%96%87%E6%9C%AC%E5%88%9B%E4%BD%9C-%E2%9C%93-blue" />
|
|
12
|
+
<img alt="AI 编辑 Agent" src="https://img.shields.io/badge/AI%20%E7%BC%96%E8%BE%91%20Agent-%E2%9C%93-blue" />
|
|
13
|
+
<img alt="修订仲裁" src="https://img.shields.io/badge/%E4%BF%AE%E8%AE%A2%E4%BB%B2%E8%A3%81-%E2%9C%93-blue" />
|
|
14
|
+
<img alt="长篇一致性" src="https://img.shields.io/badge/%E9%95%BF%E7%AF%87%E4%B8%80%E8%87%B4%E6%80%A7-%E2%9C%93-blue" />
|
|
15
|
+
<img alt="生产单" src="https://img.shields.io/badge/%E7%94%9F%E4%BA%A7%E5%8D%95-%E2%9C%93-blue" />
|
|
16
|
+
<img alt="墨纸编辑风" src="https://img.shields.io/badge/%E5%A2%A8%E7%BA%B8%E7%BC%96%E8%BE%91%E9%A3%8E-%E2%9C%93-blue" />
|
|
17
|
+
<img alt="阅读器" src="https://img.shields.io/badge/%E9%98%85%E8%AF%BB%E5%99%A8-%E2%9C%93-blue" />
|
|
18
|
+
<img alt="全本导出" src="https://img.shields.io/badge/%E5%85%A8%E6%9C%AC%E5%AF%BC%E5%87%BA-%E2%9C%93-blue" />
|
|
19
|
+
</p>
|
|
20
|
+
|
|
21
|
+
你的专属 AI 小说写作插件：把一份大纲"编译"成一本完整的小说。
|
|
22
|
+
|
|
23
|
+
**版本：`1.3.0-alpha`** · 定位：**纯文本小说创作**。所有环节（开书、设定、规划、写作、审校、质检、导出）都在侧边栏「小说工坊」面板内完成；不涉及图片 / 视频 / 分镜生成。
|
|
24
|
+
|
|
25
|
+
> 整条线目前都是 `-alpha` 预发布：安装请显式带 `@alpha` 标签。
|
|
26
|
+
>
|
|
27
|
+
> **界面语言**：面板为**简体中文单语**（无语言切换）。本文档的中英对照是文档翻译，不代表界面提供英文。
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 功能一览 / Features
|
|
32
|
+
|
|
33
|
+
### 一、开书与设定 / Setup
|
|
34
|
+
|
|
35
|
+
| 中文 | English |
|
|
36
|
+
|---|---|
|
|
37
|
+
| **书架首页 + 开书向导**：书卡网格（封面 / 简介 / 进度），新建书一步导入大纲（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 |
|
|
38
|
+
| **多书切换与导入**：书架登记多本书、切换即绑定；可导入已有项目目录或 txt/md 全本（拆章建项目） | **Multi-book**: register & switch books; import an existing project dir or a full txt/md (split into chapters) |
|
|
39
|
+
| **国风模块**：总纲 / 道藏 / 大世界 / 人物志 / 暗线 / 编年录 / 文戒 / 笔法帖 / 心法 | **Wuxia-flavored modules**: outline, story bible, world, characters, foreshadows, fact ledger, anti-AI rules, style templates, custom style |
|
|
40
|
+
| **道藏提炼**：从大纲与已写章节提炼人设 / 世界观 / 金手指规则 / 写作红线，注入生成与审稿 | **Story bible**: extract personas / world rules / golden-finger rules / red lines from outline & written chapters, injected into generation and review |
|
|
41
|
+
| **大世界**：境界体系 / 区域 / 势力结构化编辑 + AI 提炼，注入每章生成与审稿 | **World**: realms / regions / factions structured editing + AI extraction, injected per chapter |
|
|
42
|
+
| **写作资产**：题材基底 / 推进模式 / 笔法帖（叙事风格）/ 文戒（反 AI 规则）/ 心法（自定义文风），一键绑定本书 | **Writing assets**: genre base / progression modes / style templates / anti-AI rules / custom style, one-click binding |
|
|
43
|
+
| **题材雷达 → 灵感**：扫榜（番茄 / 起点 / 晋江）→ 题材信号 / 生产底座 / 开书简报 → 一键生成贴合市场的开书灵感 | **Market radar → inspiration**: scan public leaderboards → signals / production foundation / creative brief → market-fit book ideas |
|
|
44
|
+
| **创意灵感 / 书分析**：一句话或题材 → 多个差异化开书方向；粘贴任意文本 → 卖点 / 结构 / 可借鉴 / 风险 | **Inspiration / teardown**: one idea → several directions; paste any text → selling points / structure / lessons / risks |
|
|
45
|
+
|
|
46
|
+
### 二、规划与逐章写作 / Planning & writing
|
|
47
|
+
|
|
48
|
+
| 中文 | English |
|
|
49
|
+
|---|---|
|
|
50
|
+
| **卷计划 / 章节计划（结构化）**：每章含 本章目标 / 剧情要点 / 爽点·钩子 / 结尾钩子 / 必达项 / 必须保持项 / 人物硬事实 / 义务合约；**续写模式**自动读上一章结尾 + 编年录锚点 + 已发生情节禁令，不重头生成，重复标题自动去重 | **Volume / chapter planning (structured)**: goal / plot points / payoff-hook / ending hook / must-advance / must-preserve / character hard facts / obligation per chapter; **continuation mode** reads the previous ending + fact anchors + banned-repeat list |
|
|
51
|
+
| **逐章编译**：调用 LLM 生成 3000–4000 字正文并保存为 Markdown，流式输出实时进度 | **Chapter-by-chapter compile**: LLM writes 3000–4000-char bodies to Markdown with live stream |
|
|
52
|
+
| **提示词槽位**：文风补充 / 反 AI 补充 / 对话补充 / 章末钩子偏好四个**安全**槽位（各带字符上限，超长显式声明截断），随项目保存并注入写作提示词；与道藏、写作红线、合规红线冲突时一律以后者为准 | **Prompt slots**: four *safe* slots (style / anti-AI / dialogue / ending-hook) with per-slot caps and explicit truncation; injected into the writing prompt, always subordinate to bible, red lines and compliance |
|
|
53
|
+
| **局部改写**：选中任意段落只改这一段；整章重写；去 AI 味润色（对比后采纳） | **Targeted edits**: rewrite just the selected paragraph, whole-chapter rewrite, de-AI polish with diff-then-adopt |
|
|
54
|
+
| **作者复盘**：每章结构复盘（钩子兑现 / 结尾钩子 / 剧情线推进 / 连续性 / 节奏趋势），按卷分组，自动关联推进的剧情线，结果回灌编年录 | **Author review**: per-chapter structural review (hook payoff / ending hook / arc progress / continuity / pacing), grouped by volume, fed back into the fact ledger |
|
|
55
|
+
|
|
56
|
+
### 三、审稿与修订 / Review & revision
|
|
57
|
+
|
|
58
|
+
| 中文 | English |
|
|
59
|
+
|---|---|
|
|
60
|
+
| **自动 AI 审稿**：人设 / 设定 / 红线 / 文笔 / 节奏·爽点 / 逻辑 / 反 AI / 呈现 / 合规 九维打分，输出可勾选问题清单与建议 | **AI review**: 9-dimension scoring with a checkable issue list and suggestions |
|
|
61
|
+
| **修订循环**：审稿未过 → 按意见一键修订 / 选中局部改 / 去 AI 味润色 → 重审；「✔ 直接通过」行使作者终审权 | **Revise loop**: revise by review / targeted edits / de-AI polish → re-review; or approve directly |
|
|
62
|
+
| **审稿问题勾选修复**：每条问题可勾选（high 默认选），一键按所选问题修订 | **Selective review fixes**: check any issues (high pre-checked) and fix in one click |
|
|
63
|
+
| **修订仲裁（同一章只改一轮）**：审稿意见 + 时间线矛盾 + 张力偏差合并成**一份**指令；固定优先级 `审稿 high > 时间线 high > 张力 medium > 其它 > 审稿 low`；同源去重（标注「合并同类 N 条」）、单轮最多 8 条（截断显式声明）、每章最多 2 轮后转人工待办 | **Revision arbitration**: review issues + timeline conflicts + tension deviations merged into **ONE** instruction per chapter; fixed priority; same-source dedup; 8-item cap with explicit truncation; 2 rounds max then to manual todos |
|
|
64
|
+
| **张力 / 时间线默认只提示不阻塞**：出章即核对曲线 → 运行日志 + 建议性待办；**不单独触发修订**，只在因审稿 high 修订时搭同一轮车 —— 因此不增加轮次，也不会「改完甲又违反乙」 | **Tension/timeline are advisory-only**: checked on chapter completion → run log + advisory todos; never trigger a revision on their own, only ride along with a review-driven round |
|
|
65
|
+
| **验证基准是多源的**：修订后的复核不再只核对审稿意见，而是核对**本轮实际下发的全部条目**（时间线 / 张力条目带 `[时间线]` / `[张力]` 前缀），杜绝「复核说已解决、时间线说没改」 | **Multi-source verification baseline**: post-revision re-review checks every item actually issued this round (timeline/tension items carry source prefixes) |
|
|
66
|
+
|
|
67
|
+
### 四、长篇一致性 / Long-form consistency
|
|
68
|
+
|
|
69
|
+
| 中文 | English |
|
|
70
|
+
|---|---|
|
|
71
|
+
| **摘要 + 编年录事实库**：每章自动抽取剧情摘要与已确立事实（人物状态 / 资源 / 关系 / 线索落地），注入后续章节 | **Summary + fact ledger**: per-chapter summary & extracted facts injected into later chapters |
|
|
72
|
+
| **相关事实全量检索**：生成时按本章剧情要点对全量编年录检索（角色名加权 + 近因加权 + 去重），旧设定不因窗口滑出而丢失 | **Full-ledger retrieval**: plot-based retrieval across the whole ledger (character + recency weighting, dedup) |
|
|
73
|
+
| **故事时间线**：出章自动抽取「故事内时间 + 地点 + 在场角色 + 事件」，写作 / 修订提示词注入**本章之前**的锚点（最近 12 条，超出带显式截断声明）；规则初筛抓同章顺序自相矛盾、跨章**时间倒流**、**地点瞬移**，AI 复核补季节 / 年龄 / 回忆混淆；支持选章抽取、一键检查、就地修正（标记 manual）、一键按建议修订 | **Story timeline**: auto-extract story time / place / cast / event per chapter; inject anchors from *before* this chapter (last 12, explicit truncation); rule screening catches in-chapter order contradictions, time reversal, place jumps; AI review adds season/age/flashback confusion; extract, check, edit-in-place, one-click revise |
|
|
74
|
+
| **张力曲线**：逐章张力目标 + 审稿评分作为「实际值」；参考形状（递进爬升 / 悬疑加压 / 波浪呼吸 / 前紧后稳 / 平稳推进 + 自定义）；规则抓四类**曲线级**问题（偏差 >25 / 连续 4 章平台期 / 连续 3 章高位无呼吸 / 连续 5 章低位）；SVG 曲线（虚线参考 / 实线目标 / 绿点实际），点任意一章即可改目标 | **Tension curve**: per-chapter target + review-scored actual; reference shapes (escalation / suspense / wave / front-load / flat / custom); four curve-level rules; SVG chart, click any chapter to retarget |
|
|
75
|
+
| **剧情线与神秘线**：主线 / 支线 / 人物线 / 悬念线，目标与进度追踪、章节关联；生成强制至少推进一条活跃线；健康检查 + AI 剧情方案 | **Plotlines**: main / branch / character / mystery arcs with goals, progress & linked chapters; generation must advance a line; health check + AI plan |
|
|
76
|
+
| **角色库 + 人物志**：AI 从全书提炼角色并自动分级（主角 / 女主 / 女配 / 配角 / 反派 / 路人），候选逐条采纳；定位 / 关系网 / 成长线 / **知情度**严格维护信息差；人物志（当前状态聚合）落盘、可回填历史章节 | **Role library + chronicle**: AI extraction with auto-tiering, adopt per candidate; identity / relations / arc / knowledge asymmetry; persistent character status, backfillable |
|
|
77
|
+
| **暗线（伏笔）管理**：计划 / 已埋 / 已回收状态跟踪，章节绑定作者复盘自动标记埋设 | **Foreshadow threads**: planned / planted / resolved tracking, auto-marked on chapter review |
|
|
78
|
+
| **章节历史版本（快照）**：重新生成、采纳草稿前、助手直接修订前都会自动留存旧稿；每章默认保留 20 份；**回滚前先给当前稿留一份，所以回滚本身也可撤销** | **Chapter snapshots**: auto-saved before regenerate / draft-apply / assistant rewrite; 20 kept per chapter; rollback itself is undoable |
|
|
79
|
+
|
|
80
|
+
### 五、质检定稿与导出 / Audit, finalize & export
|
|
81
|
+
|
|
82
|
+
| 中文 | English |
|
|
83
|
+
|---|---|
|
|
84
|
+
| **全书一致性质检**：LLM 扫描全本输出矛盾清单（定位到章），一键去修订 | **Book audit**: LLM scans all chapters for contradictions, locates them, one-click to revise |
|
|
85
|
+
| **敏感词检查**：内置违禁词库（政治 / 擦边 / 暴力 / 辱骂 / 广告 / 其他）全书一键扫描，命中定位到章并一键去修订 | **Sensitive-word check**: built-in banned-word library scanned across the book, located per chapter with one-click fix |
|
|
86
|
+
| **并发安全保存**：计划 / 生成 / 审稿落盘前自动合并磁盘最新设定（道藏 / 角色库 / 剧情线 / 知情度） | **Concurrency-safe saves**: merge latest on-disk settings before save |
|
|
87
|
+
| **分范围导出**：整本正文 / 项目设定 / 规划（卷·章节）/ 角色 / 质检记录 / **项目备份 JSON**，格式 TXT / MD / JSON；全本导出含卷首语与封面 | **Scoped export**: whole book / settings / plan / characters / review records / **project backup JSON**, as TXT / MD / JSON; full-book export includes blurb & cover |
|
|
88
|
+
| **小说阅读器**：全页阅读，三档内容底色（纸白 / 护眼 / 夜间）+ 字号档，与工作台互不干扰 | **Reader view**: full-page reading with three content backgrounds (paper / eye-care / night) and font steps |
|
|
89
|
+
|
|
90
|
+
### 六、AI 编辑 Agent 与自动化 / Agent & automation
|
|
91
|
+
|
|
92
|
+
| 中文 | English |
|
|
93
|
+
|---|---|
|
|
94
|
+
| **AI 编辑 Agent**：一句话代办 —— 拆书、自动编辑、知识库（增 / 查 / 列）、剧情线、编辑待办、全书质检、简介、章节生成 / 审稿 / 修订、大纲 / 道藏 / 暗线 / 资产、导出 | **AI Editor Agent**: one line to delegate teardown / director / KB / plotlines / todos / audit / blurb / chapter ops / outline / bible / foreshadow / assets / export |
|
|
95
|
+
| **写操作守卫 + 阶段契约**：只在作者**明确要求**时执行写操作，只提问不会误触发；宿主按项目真实状态算出当前阶段（开书 → 立设定 → 排章节 → 逐章编译 → 审稿 → 修订循环 → 定稿导出）并据此收窄可用动作，写错阶段的动作会被直接拒绝 | **Write guard + stage contract**: writes only on explicit request; host computes the current stage from real project state and narrows the allowed action set accordingly |
|
|
96
|
+
| **失败分级（fail-stop）**：契约类错误（参数越界、章节不在计划中）**不重试**并记账，网络 / 超时 / 限流类才按次数重试；同一调用同参数已失败过会被直接挡下，避免无效循环 | **Failure classification**: contract errors are not retried and are recorded; only transient errors retry; a repeated identical failed call is blocked |
|
|
97
|
+
| **备用模型与故障恢复**：只对网络 / 超时 / 限流 / 服务端 / 额度类失败切换备用模型；用户取消与参数错误不切换；备用也失败时抛**主模型原始错误**保留第一现场；正文生成 / 修订 / 润色仅在「一个字都没产出」时才换模型，杜绝重复生成 | **Fallback model & recovery**: switches only on transient failures, never on cancellation or bad params; rethrows the primary error; streaming writes only fall back when zero output was produced |
|
|
98
|
+
| **生产单（批量连写）**：区间 / 新增 N 章一键下单，计划补足 + 逐章生成 + 被拒分级处理（无 high 豁免 / 修订 + 验证 / 两轮不过转人工）+ 出章即核对曲线，支持暂停 / 继续 / 停止与断点续跑（`run-state.json`） | **Production run**: line up a range, auto-plan, generate chapter-by-chapter, tiered declined handling, curve check on completion, pause / resume / stop with checkpointing |
|
|
99
|
+
| **Token / 耗时记账**：实况帧带输入 / 输出 / 思考 / 缓存 token、总耗时、首字耗时；`/status` 返回本次运行（进程内）汇总与按用途分组；面板可查看**每次调用实际发送的 Prompt**（system + user） | **Token & latency accounting**: live frames carry in/out/reasoning/cached tokens, total and first-token latency; per-run summary grouped by purpose; inspect the actual prompt sent per call |
|
|
100
|
+
| **改编模式**：上传全文 → 设定卡片 / 可改范围 → 确认改编维度 → 生成映射表 / 规则 / 影响清单 → 替换 / 重写 → 保存为新书（原书保留） | **Adaptation mode**: upload full text → setting cards / mutability → confirm dimensions → mappings / rules / impacts → replace or rewrite → save as a new book |
|
|
101
|
+
| **知识库 / RAG**：书内自由参考文档，生成时按章节检索注入 | **Knowledge base / RAG**: in-book reference docs, retrieved & injected per chapter |
|
|
102
|
+
|
|
103
|
+
### 七、面板与外观 / Panel & appearance
|
|
104
|
+
|
|
105
|
+
| 中文 | English |
|
|
106
|
+
|---|---|
|
|
107
|
+
| **总编台（首页仪表盘）**：主行动卡（推荐下一步）+ 创作旅程进度条 + 状态条 + 待办队列 + 资产健康 + 资料侧柜 | **Workflow dashboard**: next-action hero card, journey progress bar, status strip, todo queue, asset health, resource cabinet |
|
|
108
|
+
| **墨纸编辑风（单一风格）**：暖纸色阶 + 发丝边 + 朱砂强调，深度靠色阶而非阴影；**显示模式**跟随系统 / 浅色 / 深色，另有界面密度三档、编辑器字号、自定义背景图（URL / 上传 + 遮罩模糊强度） | **Ink-paper editorial style (single skin)**: warm paper tones, hairline borders, cinnabar accent; light/dark following system, three density steps, editor font size, custom background image with dim/blur strength |
|
|
109
|
+
| **活动输出控制台**：实时记录生成 / 审稿 / 润色 / 质检等全部活动，自动滚动 + 一键清空；顶部「AI 进度」显示实时任务进度 | **Activity console**: records every action, auto-scrolls, one-click clear; live progress chip in the header |
|
|
110
|
+
| **悬浮工作进度窗**：长任务实时进度与活动记录，随时查看 | **Floating progress window**: live progress & activity log for long tasks |
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## 工作流程 / Workflow
|
|
115
|
+
|
|
116
|
+
一条主线：**开书 → 立设定 → 排章节 → 逐章编译 → 修订循环 → 质检定稿 → 导出**。
|
|
117
|
+
|
|
118
|
+
```mermaid
|
|
119
|
+
flowchart TD
|
|
120
|
+
A[① 开书<br/>粘贴大纲 / 导入 docx / txt 拆章] --> B[② 立设定<br/>道藏 · 大世界 · 写作资产]
|
|
121
|
+
B --> C[③ 排章节<br/>卷计划 · 章节计划 / 续写模式]
|
|
122
|
+
C --> D[④ 逐章编译<br/>生成正文 → 摘要·事实 → 时间线抽取 → 审稿 → 作者复盘]
|
|
123
|
+
D --> E{审稿通过?}
|
|
124
|
+
E -->|否| F[⑤ 修订循环<br/>合并建议一轮改完 → 多源基准复核]
|
|
125
|
+
F --> D
|
|
126
|
+
E -->|是| G[⑥ 出章即核对<br/>张力曲线 · 时间线矛盾 → 日志 + 待办]
|
|
127
|
+
G --> H[⑦ 全书定稿<br/>全书质检 · 敏感词 · 快照回滚]
|
|
128
|
+
H --> I[⑧ 导出<br/>整本 TXT / MD · 分范围导出 · 项目备份 JSON]
|
|
129
|
+
|
|
130
|
+
R1[💬 AI 编辑 Agent<br/>拆书 / 自动编辑 / 知识库 / 质检 / 简介 / 待办] -.-> B
|
|
131
|
+
R1 -.-> C
|
|
132
|
+
R1 -.-> D
|
|
133
|
+
R1 -.-> H
|
|
134
|
+
R2[🧵 剧情线 · 👥 角色库 · ⏳ 时间线 · 📈 张力] -.-> D
|
|
135
|
+
R2 -.-> F
|
|
136
|
+
R3[📋 生产单<br/>批量连写 · 断点续跑] -.-> D
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
```
|
|
140
|
+
① 开书（书架 → 开书向导：粘贴大纲 / 导入 docx / txt 全本拆章，书名自动识别）
|
|
141
|
+
↓
|
|
142
|
+
② 立设定（总纲 → ✨ 提炼道藏【人设 / 世界观 / 金手指规则 / 写作红线】→ 大世界【境界 / 区域 / 势力】→ 写作资产【题材 / 推进 / 笔法帖 / 文戒 / 心法】）
|
|
143
|
+
↓
|
|
144
|
+
③ 排章节（卷计划 → 章节计划：每章 目标 / 剧情要点 / 爽点钩子 / 结尾钩子 / 必达项 / 义务合约；
|
|
145
|
+
已有章节时进入「续写模式」——读取上一章结尾原文 + 编年录锚点，不重头生成）
|
|
146
|
+
↓
|
|
147
|
+
④ 逐章编译（生成 3000-4000 字 → 摘要 + 编年录事实 → 时间线抽取 → AI 审稿打分 → 作者复盘）
|
|
148
|
+
↓
|
|
149
|
+
⑤ 修订循环（审稿未过 → 合并建议【审稿 high + 时间线 high + 张力 medium】一轮改完
|
|
150
|
+
→ 以本轮下发条目为基准复核 → 仍不过最多再一轮 → 转人工待办；
|
|
151
|
+
不满意可「✔ 直接通过」行使作者终审权）
|
|
152
|
+
↓
|
|
153
|
+
⑥ 出章即核对（张力曲线偏差 / 时间线矛盾 → 运行日志 + 建议性待办，不自动改正文）
|
|
154
|
+
↓
|
|
155
|
+
⑦ 全书定稿（全书质检【矛盾清单】→ 敏感词扫描 → 快照回滚 / 编年录 / 剧情线 / 角色库维护）
|
|
156
|
+
↓
|
|
157
|
+
⑧ 导出（全本 TXT / MD（含卷首语与封面）；分范围导出：设定 / 规划 / 角色 / 质检 / 项目备份 JSON）
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
**辅助旁路（任意阶段可用）**：💬 AI 编辑 Agent（拆书 / 自动编辑 / 知识库 / 质检 / 简介 / 待办）、🧵 剧情线管理、👥 角色库与人物志、⏳ 故事时间线、📈 张力曲线、🎛 提示词槽位、📋 生产单、🕘 章节历史版本。
|
|
161
|
+
|
|
162
|
+
**推荐节奏**：先让 ②③ 完整落地（设定越全，章节质量越高）；④ 建议逐章或小批生成，便于在 ⑤ 及时修正；长篇每写 20-30 章跑一次 ⑦ 全书质检，防止设定漂移。
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## 面板导览 / Panel map
|
|
167
|
+
|
|
168
|
+
| 位置 | 内容 |
|
|
169
|
+
|---|---|
|
|
170
|
+
| 顶栏 | **总编台**（工作流仪表盘）· **写作**（章节索引 → 章节工作台）· **设定**（道藏 / 大世界 / 编年录 / 人物志 / 作者复盘）· **资产**（题材 / 推进 / 笔法帖 / 文戒 / 心法）· **写作参数**（本书参数：仅对当前书生效、可一键恢复全局默认；含分范围导出） |
|
|
171
|
+
| 书架页 | **书架**（书卡网格 / 开书向导 / 导入）· **改编** · **资产库 / 全局资产库** · **设置 · 全局**（模型与推理 / 备用模型 / 故事时间线 / 路径与文件 / 外观与主题 / 自定义背景 / 输出目录迁移） |
|
|
172
|
+
| 总编台 · 本书资料 | 总纲 / 大纲 · 道藏（设定·角色）· 作者复盘 · 剧情线·伏笔 · 简介·封面 |
|
|
173
|
+
| 总编台 · 工具 | 生产单 · 张力曲线 · 提示词槽位 · 故事时间线 · 知识库 · 拆书分析 |
|
|
174
|
+
| 全页视图 | 章节工作台（审稿 / 对比·草稿 / 复盘 / 历史版本，内含正文编辑、局部改写与去 AI 味润色）· 小说阅读器 |
|
|
175
|
+
| 悬浮窗（可拖动 / 缩放） | **AI 助手**（AI 编辑 Agent 对话，不占工作台）· **AI 进度**（当前任务进度 + 活动输出，可查看每次调用的 Prompt 与用量） |
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## 安装 / Installation
|
|
180
|
+
|
|
181
|
+
```sh
|
|
182
|
+
pnpm install # 安装依赖 / install dependencies
|
|
183
|
+
pnpm build # 重新构建 lib/ / rebuild lib/
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
挂载到 dsh web profile / Mount into the dsh web profile:
|
|
187
|
+
|
|
188
|
+
```sh
|
|
189
|
+
dsh plugin --profile web add link:"<此目录绝对路径>"
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
或 / or in `~/.dsh/profiles/web/cordis.patch.yml`:
|
|
193
|
+
|
|
194
|
+
```yaml
|
|
195
|
+
- insert:
|
|
196
|
+
- id: novel-forge
|
|
197
|
+
name: '@waterwx/dsh-novel-forge'
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
重启 dsh web 后，侧边栏出现「小说工坊」。
|
|
201
|
+
|
|
202
|
+
### 从 npm 安装（推荐）
|
|
203
|
+
|
|
204
|
+
```sh
|
|
205
|
+
dsh plugin --profile web add @waterwx/dsh-novel-forge@alpha
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
> 版本标签：本项目整条线都是 `-alpha` 预发布，请显式指定 `@alpha` 以拿到最新版。
|
|
209
|
+
> `latest` 与 `alpha` 在发版时同步指向同一版本（见 `scripts/release.mjs`），
|
|
210
|
+
> 但显式带标签可以避免 registry 缓存或旧标签带来的意外降级。
|
|
211
|
+
|
|
212
|
+
npm 分发的是预构建产物，无需任何构建授权。
|
|
213
|
+
从 GitHub 安装需为 git 依赖的 `prepare` 构建授权（`pnpm-workspace.yaml` 的 `allowBuilds`）。
|
|
214
|
+
|
|
215
|
+
**环境要求**：Node `^22.19.0 || >=24.0.0`；DSH peer 依赖 `0.1.2-alpha.3`。
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
## 数据位置 / Data Locations
|
|
220
|
+
|
|
221
|
+
- 书架 / Bookshelf：`~/.dsh/dsh-novel-forge-bookshelf.json`
|
|
222
|
+
- 作者资产库 / Author assets：`~/.dsh/dsh-novel-forge-author-assets.json`
|
|
223
|
+
- 全局写作资产 / Global assets：`~/.dsh/novel-forge-global-assets.json`
|
|
224
|
+
- 每本书一个输出目录（默认 `~/.dsh/novels/<书名>`，可在设置页修改并一键迁移）：
|
|
225
|
+
- `novel-project.json` — 项目状态（道藏 / 卷·章节计划 / 编年录 / 时间线 / 张力 / 剧情线 / 待办 …）
|
|
226
|
+
- `第N章 <标题>.md` — 章节正文（Markdown）与 `.bak.md` 备份
|
|
227
|
+
- `snapshots/` — 章节历史版本（含 `index.json` 索引，每章默认保留 20 份）
|
|
228
|
+
- `run-state.json` — 生产单断点状态
|
|
229
|
+
- `novel-assistant.jsonl` — AI 编辑 Agent 对话记录
|
|
230
|
+
- 设置：`~/.dsh/settings.yaml` 的 `dsh-novel-forge` 段
|
|
231
|
+
- 界面偏好（显示模式 / 密度 / 编辑器字号 / 面板宽度 / 阅读器底色）：浏览器 localStorage
|
|
232
|
+
|
|
233
|
+
---
|
|
234
|
+
|
|
235
|
+
## 影响与限制 / Impact & Limitations
|
|
236
|
+
|
|
237
|
+
- **LLM 额度消耗**：生成 / 审稿 / 润色 / 质检 / 提炼 / 复盘 / 时间线抽取等所有 AI 操作都调用 LLM（默认 `deepseek-official / deepseek-flash`）。参考：一章 3000-4000 字正文 ≈ 1-2 万 token（含推理）；审稿约 2000-3000 token；全书质检与角色提炼更贵（数万 token）。建议分小批执行。面板实况区提供**本次运行的用量与耗时**汇总（进程内，重启清零）。
|
|
238
|
+
- **写操作守卫**：AI 编辑 Agent 只在作者**明确要求**时执行写操作；只提问不会误触发；阶段不符的动作会被契约拒绝。
|
|
239
|
+
- **并发安全**：计划 / 生成 / 审稿落盘前会自动合并磁盘上的最新设定（道藏 / 角色库 / 剧情线 / 知情度），多窗口同时操作互不覆盖。
|
|
240
|
+
- **纯文本定位**：本插件不负责图片 / 视频生成；设定均为文字数据（角色卡仅含定位 / 性格 / 目标 / 关系 / 成长线 / 知情度等字段）。
|
|
241
|
+
- **界面语言**：小说工坊面板是简体中文单语（用户可见文案统一定义在 `src/client/locales.ts`，键位参与编译期校验）；不提供语言切换，也没有英文界面。
|
|
242
|
+
- **章节质量**取决于大纲完整度；批量生成串行执行（单例执行器，不与手动操作并发写同一本书）。
|
|
243
|
+
- **修订边界**：张力 / 时间线问题默认只是**建议**（日志 + 待办），不阻塞出章、不自动改正文；自动修订只在审稿 high 触发，且每章最多 2 轮，超出转人工待办 —— 自动化不会无限改写你的正文。
|
|
244
|
+
- **用量账本**：Token / 耗时统计保存在进程内，重启即清零；逐章 token 未持久化（章节仅记录字数）。
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
## 工程质量 / Engineering & Gates
|
|
249
|
+
|
|
250
|
+
```sh
|
|
251
|
+
pnpm typecheck # tsc --noEmit
|
|
252
|
+
pnpm test # vitest run —— 14 个测试文件 / 152 个用例
|
|
253
|
+
pnpm build # tsc -p tsconfig.build.json && tsdown（宿主 lib/index.js + 浏览器 lib/client.js）
|
|
254
|
+
node scripts/check-theme-sizes.mjs # 主题块内不得出现尺寸声明（尺寸归 token）
|
|
255
|
+
node scripts/check-fallback-tiers.mjs # 备用模型档位一致性
|
|
256
|
+
node scripts/check-third-party.mjs # 来源卫生：不得出现外部项目名 / 外部符号 / 来源标注措辞
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
- **CI**（`.github/workflows/ci.yml`，Node 24 + pnpm 9）：install → typecheck → build → 三条检查脚本 → `pnpm test`。
|
|
260
|
+
- **测试构成**：阶段契约、失败分级、模型回退、修订仲裁（合并 / 优先级 / 截断 / 多源基准）、路由级 `/status` 与 `/revision/plan`、时间线规则、张力规则、快照（真实文件系统）、提示词槽位、客户端书范围绑定、内置资产完整性。
|
|
261
|
+
- **发布纪律**（`pnpm release`，`--dry-run` 可预览）：typecheck → 样式门禁 → 备用档门禁 → 来源卫生门禁 → build → `pnpm test` → commit + tag + push → `npm publish --tag alpha` → 同步 `latest` → 创建 GitHub Release（版本号含 `-` 时标为 prerelease）。**带着失败用例不允许发布**（npm 版本号不可复用）。
|
|
262
|
+
- **规则工程约束**：阶段契约、失败分级、截断显式化、修订仲裁等规则由宿主统一实现，面板与助手共用同一结论，不各写一套。
|
|
263
|
+
|
|
264
|
+
---
|
|
265
|
+
|
|
266
|
+
## 目录结构 / Directory Layout
|
|
267
|
+
|
|
268
|
+
```
|
|
269
|
+
src/ 插件源码（宿主半）
|
|
270
|
+
engine.ts 写作 / 审稿 / 润色 / 提炼 / 导出等全部 LLM 管线与提示词
|
|
271
|
+
routes.ts Web 路由（/api/dsh-novel-forge/*）
|
|
272
|
+
run.ts 生产单（批量章节生产的标准执行器）
|
|
273
|
+
revision.ts 修订仲裁：三类建议合并成一份指令 + 多源验证基准
|
|
274
|
+
timeline.ts 故事时间线（归一化 / 注入渲染 / 规则初筛）
|
|
275
|
+
tension.ts 张力曲线（参考形状 / 目标与实际 / 规则核对）
|
|
276
|
+
snapshots.ts 章节历史版本
|
|
277
|
+
stage-contract.ts 阶段契约（面板 / 助手共用）
|
|
278
|
+
action-guard.ts 写操作守卫与失败分级
|
|
279
|
+
llm-retry.ts 备用模型与失败恢复
|
|
280
|
+
llm-live.ts 实况帧 + 用量账本 + Prompt 环形留存
|
|
281
|
+
prompt-slots.ts 提示词槽位
|
|
282
|
+
assistant.ts AI 编辑 Agent
|
|
283
|
+
assets.ts 内置写作资产（自研表述）
|
|
284
|
+
client/ 浏览器半（React + CSS Modules：面板 / 工作台 / 阅读器）
|
|
285
|
+
lib/ 构建产物（lib/index.js 宿主 / lib/client.js 浏览器）
|
|
286
|
+
tests/ 14 个 vitest 测试文件（152 个用例）
|
|
287
|
+
scripts/ 构建与门禁脚本（含 check-third-party.mjs 来源卫生门禁、release.mjs）
|
|
288
|
+
docs/ 设计文档（design-direction.md = 面板样式现行基准）+ archive/ 历史归档
|
|
289
|
+
package.json 包定义（dsh.bundle.patch + dsh.client 声明）
|
|
290
|
+
cordis.patch.yml profile 挂载补丁
|
|
291
|
+
tsdown.config.ts 双面打包配置
|
|
292
|
+
vitest.config.ts 测试范围（tests/**/*.test.ts）
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
---
|
|
296
|
+
|
|
297
|
+
## English
|
|
298
|
+
|
|
299
|
+
# AI Novel Forge
|
|
300
|
+
|
|
301
|
+
An AI novel-writing plugin for DeepSeek Harness (DSH). Feed it an outline (docx / pasted text / a full txt split into chapters) and it compiles it into a complete novel: open a book → build the setting → plan chapters → compile chapter by chapter → revise → audit & finalize → export.
|
|
302
|
+
|
|
303
|
+
**Version `1.3.0-alpha` · Scope: pure-text novel writing.** Everything happens inside the "Novel Forge" sidebar panel; no comic / storyboard / image / video generation.
|
|
304
|
+
|
|
305
|
+
**UI language: Simplified Chinese only.** The panel ships a single Chinese UI (no language switch); the English section below is documentation for this repository, not an in-app language option.
|
|
306
|
+
|
|
307
|
+
### Main pipeline
|
|
308
|
+
|
|
309
|
+
1. **Open a book** (bookshelf → wizard): paste an outline, import docx, or split a full txt; book name auto-detected; idea → AI outline supported.
|
|
310
|
+
2. **Build the setting** (outline → extract story bible [personas / world rules / golden-finger rules / red lines] → world [realms / regions / factions] → writing assets [genre / progression / style templates / anti-AI rules / custom style]).
|
|
311
|
+
3. **Plan chapters** (volume plan → structured chapter plan with goal / plot points / payoff-hook / ending hook / must-advance / obligation; continuation mode with existing chapters never restarts).
|
|
312
|
+
4. **Compile chapter by chapter** (generate 3000–4000 chars → summary + fact ledger → timeline extraction → AI review → author review).
|
|
313
|
+
5. **Revise loop** (merged revision: review issues + timeline conflicts + tension deviations in ONE round → re-review against a multi-source baseline; 2 rounds max, then manual todo; or approve directly).
|
|
314
|
+
6. **Curve check on completion** (tension / timeline findings → run log + advisory todos, never auto-rewrites the body).
|
|
315
|
+
7. **Finalize** (book audit for contradictions → sensitive-word scan → snapshots / ledger / plotlines / role library maintenance).
|
|
316
|
+
8. **Export** (full book TXT / MD with blurb & cover; scoped export for settings / plan / characters / review records / project backup JSON).
|
|
317
|
+
|
|
318
|
+
### Highlights
|
|
319
|
+
|
|
320
|
+
- **Story bible & world**: personas / world rules / golden-finger rules / red lines; realms / regions / factions.
|
|
321
|
+
- **Fact ledger (chronicle)**: per-chapter extracted facts injected into later chapters; full-ledger relevance retrieval for long serials.
|
|
322
|
+
- **Story timeline**: story-time / place / cast / event anchors injected into writing & revision; rule screening for time reversal, place jumps and in-chapter order contradictions.
|
|
323
|
+
- **Tension curve**: per-chapter target vs review-scored actual, reference shapes, four curve-level rules, SVG chart.
|
|
324
|
+
- **Revision arbitration**: fixed priority, same-source dedup, 8-item cap, 2 rounds max, multi-source verification baseline.
|
|
325
|
+
- **Structured chapter plans + continuation planning**, **prompt slots** (safe, capped, subordinate to bible/red lines/compliance).
|
|
326
|
+
- **AI review** (9 dimensions) + one-click merged revision / local edits / de-AI polish; selective issue fixes.
|
|
327
|
+
- **Plotlines** (main / branch / character / mystery) with health check & AI plan; **role library** with knowledge asymmetry; **persistent character status**.
|
|
328
|
+
- **Book audit** (contradiction list), **sensitive-word check**, **knowledge base / RAG**, **chapter snapshots** (rollback, 20 per chapter, undoable).
|
|
329
|
+
- **Production run** (batch, tiered declined handling, checkpoint/resume) and **adaptation mode** (remap or rewrite a full text into a new book).
|
|
330
|
+
- **AI Editor Agent** with write-guard + stage contract + failure classification + fallback model.
|
|
331
|
+
- **Token & latency accounting** with per-call prompt inspection.
|
|
332
|
+
- **Ink-paper editorial UI** (single skin, light/dark), full-page **reader** with three content backgrounds.
|
|
333
|
+
- **Multi-book bookshelf** with import / rename / migrate output dir, and **scoped export** TXT / MD / JSON.
|
|
334
|
+
|
|
335
|
+
### Install
|
|
336
|
+
|
|
337
|
+
```sh
|
|
338
|
+
dsh plugin --profile web add @waterwx/dsh-novel-forge@alpha
|
|
339
|
+
```
|
|
340
|
+
The `@alpha` tag is required on purpose: every release on the current line is a
|
|
341
|
+
prerelease, so pin the tag instead of relying on the `latest` dist-tag.
|
|
342
|
+
Or link a local checkout and restart dsh web; the "Novel Forge" entry appears in the sidebar.
|
|
343
|
+
|
|
344
|
+
Requirements: Node `^22.19.0 || >=24.0.0`; DSH peer `0.1.2-alpha.3`.
|
|
345
|
+
|
|
346
|
+
### Data
|
|
347
|
+
|
|
348
|
+
- Bookshelf: `~/.dsh/dsh-novel-forge-bookshelf.json`
|
|
349
|
+
- Author assets / global assets: `~/.dsh/dsh-novel-forge-author-assets.json`, `~/.dsh/novel-forge-global-assets.json`
|
|
350
|
+
- Per book: an output directory with `novel-project.json`, chapter Markdown, `.bak.md` backups, `snapshots/`, `run-state.json`, `novel-assistant.jsonl`
|
|
351
|
+
- Settings: `dsh-novel-forge` section of `~/.dsh/settings.yaml`; UI preferences in localStorage
|
|
352
|
+
|
|
353
|
+
### Engineering & gates
|
|
354
|
+
|
|
355
|
+
`pnpm typecheck`, `pnpm test` (14 files / 152 cases), `pnpm build`, plus `scripts/check-theme-sizes.mjs`, `check-fallback-tiers.mjs` and `check-third-party.mjs`; CI runs the same chain on Node 24 + pnpm 9. `pnpm release` runs it again before publishing (a failing suite blocks the release).
|
|
356
|
+
|
|
357
|
+
### Limitations
|
|
358
|
+
|
|
359
|
+
- All AI operations consume LLM quota (default `deepseek-official / deepseek-flash`); batch generation is serial.
|
|
360
|
+
- Chapter quality depends on outline completeness.
|
|
361
|
+
- Tension / timeline findings are advisory by default; automatic revision triggers only on review `high` and is capped at 2 rounds per chapter.
|
|
362
|
+
- The plugin writes text only — no image/video generation; the usage ledger is in-process and resets on restart.
|