@waterwx/dsh-novel-forge 1.0.0 → 1.1.0-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 +231 -206
- package/lib/client.js +55052 -4393
- package/lib/index.js +12013 -2524
- package/lib/types/ai-scan.d.ts +36 -0
- package/lib/types/assets.d.ts +19 -4
- package/lib/types/assistant.d.ts +6 -0
- package/lib/types/author-assets.d.ts +25 -0
- package/lib/types/bookshelf.d.ts +11 -1
- package/lib/types/client/api.d.ts +210 -4
- package/lib/types/client/docx.d.ts +2 -0
- package/lib/types/client/index.d.ts +1 -1
- package/lib/types/client/llmLive.d.ts +33 -0
- package/lib/types/client/locales.d.ts +102 -29
- package/lib/types/client/panel/AdaptModeView.d.ts +5 -0
- package/lib/types/client/panel/AiTag.d.ts +1 -0
- package/lib/types/client/panel/AuthorAssetsView.d.ts +4 -0
- package/lib/types/client/panel/AuthorHome.d.ts +34 -0
- package/lib/types/client/panel/BookAnalysisView.d.ts +4 -0
- package/lib/types/client/panel/CmdPalette.d.ts +12 -0
- package/lib/types/client/panel/CreateBookView.d.ts +13 -0
- package/lib/types/client/panel/DirectorView.d.ts +7 -0
- package/lib/types/client/panel/GlobalAssetLibraryView.d.ts +4 -0
- package/lib/types/client/panel/IdeaInspirationView.d.ts +6 -0
- package/lib/types/client/panel/ImportModal.d.ts +7 -0
- package/lib/types/client/panel/KnowledgeBaseView.d.ts +4 -0
- package/lib/types/client/panel/LiveFeedLog.d.ts +8 -0
- package/lib/types/client/panel/MarketRadarView.d.ts +5 -0
- package/lib/types/client/panel/ModelManager.d.ts +14 -0
- package/lib/types/client/panel/NovelPanel.d.ts +6 -1
- package/lib/types/client/panel/PageHeader.d.ts +18 -0
- package/lib/types/client/panel/ProgressConsole.d.ts +17 -0
- package/lib/types/client/panel/ProgressHomeView.d.ts +5 -0
- package/lib/types/client/panel/ReaderView.d.ts +8 -0
- package/lib/types/client/panel/ReasoningSection.d.ts +10 -0
- package/lib/types/client/panel/RunPanel.d.ts +5 -0
- package/lib/types/client/panel/SettingsView.d.ts +19 -0
- package/lib/types/client/panel/ShelfView.d.ts +24 -0
- package/lib/types/client/panel/SubPage.d.ts +27 -0
- package/lib/types/client/panel/WorldTab.d.ts +10 -0
- package/lib/types/client/panel/helpers.d.ts +10 -0
- package/lib/types/client/panel/toast.d.ts +2 -0
- package/lib/types/client/panel/views.d.ts +95 -0
- package/lib/types/client/run-status.d.ts +19 -0
- package/lib/types/client/text.d.ts +9 -0
- package/lib/types/docx-core.d.ts +16 -0
- package/lib/types/docx.d.ts +2 -3
- package/lib/types/engine.d.ts +228 -5
- package/lib/types/global-assets.d.ts +6 -0
- package/lib/types/index.d.ts +24 -2
- package/lib/types/llm-live.d.ts +44 -0
- package/lib/types/market-radar-scan.d.ts +19 -0
- package/lib/types/market-radar-sources.d.ts +31 -0
- package/lib/types/migrate-output.d.ts +25 -0
- package/lib/types/novel-context.d.ts +80 -0
- package/lib/types/prompt-utils.d.ts +35 -0
- package/lib/types/prompting.d.ts +10 -0
- package/lib/types/protocol.d.ts +1418 -7
- package/lib/types/review-policy.d.ts +97 -0
- package/lib/types/routes.d.ts +4 -0
- package/lib/types/run.d.ts +34 -0
- package/package.json +120 -93
- package/scripts/patch-schemastery.mjs +47 -0
- package/src/ai-scan.ts +179 -0
- package/src/assets.ts +1774 -518
- package/src/assistant.ts +915 -568
- package/src/author-assets.ts +149 -0
- package/src/bookshelf.ts +187 -148
- package/src/client/api.ts +675 -289
- package/src/client/docx.ts +37 -69
- package/src/client/index.ts +3 -1
- package/src/client/llmLive.ts +101 -0
- package/src/client/locales.ts +418 -271
- package/src/client/mount.tsx +1 -1
- package/src/client/panel/AdaptModeView.tsx +535 -0
- package/src/client/panel/AiTag.tsx +7 -0
- package/src/client/panel/AssetsTab.tsx +448 -456
- package/src/client/panel/AssistantTab.tsx +339 -188
- package/src/client/panel/AuthorAssetsView.tsx +206 -0
- package/src/client/panel/AuthorHome.tsx +309 -0
- package/src/client/panel/BookAnalysisView.tsx +63 -0
- package/src/client/panel/CmdPalette.tsx +102 -0
- package/src/client/panel/CreateBookView.tsx +366 -0
- package/src/client/panel/DirectorView.tsx +200 -0
- package/src/client/panel/GlobalAssetLibraryView.tsx +168 -0
- package/src/client/panel/IdeaInspirationView.tsx +76 -0
- package/src/client/panel/ImportModal.tsx +303 -0
- package/src/client/panel/KnowledgeBaseView.tsx +125 -0
- package/src/client/panel/LiveFeedLog.tsx +67 -0
- package/src/client/panel/MarketRadarView.tsx +377 -0
- package/src/client/panel/ModelManager.tsx +205 -0
- package/src/client/panel/NovelPanel.tsx +5374 -2159
- package/src/client/panel/PageHeader.tsx +37 -0
- package/src/client/panel/ProgressConsole.tsx +63 -0
- package/src/client/panel/ReaderView.tsx +306 -0
- package/src/client/panel/ReasoningSection.tsx +31 -0
- package/src/client/panel/RunPanel.tsx +223 -0
- package/src/client/panel/SettingsView.tsx +305 -0
- package/src/client/panel/ShelfView.tsx +266 -0
- package/src/client/panel/SubPage.tsx +42 -0
- package/src/client/panel/WorldTab.tsx +202 -0
- package/src/client/panel/helpers.ts +50 -0
- package/src/client/panel/panel.module.css +5764 -1698
- package/src/client/panel/toast.ts +51 -0
- package/src/client/panel/views.tsx +401 -0
- package/src/client/run-status.ts +143 -0
- package/src/client/sidebar-entry.ts +1 -1
- package/src/client/text.ts +28 -0
- package/src/docx-core.ts +53 -0
- package/src/docx.ts +44 -83
- package/src/engine.ts +4155 -1233
- package/src/global-assets.ts +59 -0
- package/src/index.ts +311 -184
- package/src/llm-live.ts +68 -0
- package/src/market-radar-scan.ts +41 -0
- package/src/market-radar-sources.ts +173 -0
- package/src/migrate-output.ts +76 -0
- package/src/novel-context.ts +286 -0
- package/src/prompting.ts +26 -0
- package/src/protocol.ts +2046 -623
- package/src/review-policy.ts +161 -0
- package/src/routes.ts +3391 -1172
- package/src/run.ts +341 -0
- package/lib/client.js.map +0 -1
- package/lib/index.js.map +0 -1
- package/src/client/panel/BookshelfBar.tsx +0 -170
package/lib/types/protocol.d.ts
CHANGED
|
@@ -14,6 +14,20 @@ export declare const NOVEL_API: {
|
|
|
14
14
|
readonly bible: "/api/dsh-novel-forge/bible";
|
|
15
15
|
readonly assets: "/api/dsh-novel-forge/assets";
|
|
16
16
|
readonly styleEngine: "/api/dsh-novel-forge/style-engine";
|
|
17
|
+
readonly styleFormula: "/api/dsh-novel-forge/style-formula";
|
|
18
|
+
readonly styleDetect: "/api/dsh-novel-forge/style-detect";
|
|
19
|
+
readonly knowledge: "/api/dsh-novel-forge/knowledge";
|
|
20
|
+
readonly bookAnalysis: "/api/dsh-novel-forge/book-analysis";
|
|
21
|
+
readonly ideaInspiration: "/api/dsh-novel-forge/idea-inspiration";
|
|
22
|
+
readonly ideaInspirationMarket: "/api/dsh-novel-forge/idea-inspiration/market";
|
|
23
|
+
readonly director: "/api/dsh-novel-forge/director";
|
|
24
|
+
readonly directorTodos: "/api/dsh-novel-forge/director/todos";
|
|
25
|
+
readonly llmLive: "/api/dsh-novel-forge/llm-live/stream";
|
|
26
|
+
readonly marketRadar: "/api/dsh-novel-forge/market-radar";
|
|
27
|
+
readonly marketRadarScan: "/api/dsh-novel-forge/market-radar/scan";
|
|
28
|
+
readonly marketRadarApply: "/api/dsh-novel-forge/market-radar/apply";
|
|
29
|
+
readonly marketRadarSync: "/api/dsh-novel-forge/market-radar/foundation-sync";
|
|
30
|
+
readonly marketRadarBrief: "/api/dsh-novel-forge/market-radar/brief";
|
|
17
31
|
readonly generate: "/api/dsh-novel-forge/generate";
|
|
18
32
|
readonly review: "/api/dsh-novel-forge/review";
|
|
19
33
|
readonly rewrite: "/api/dsh-novel-forge/rewrite";
|
|
@@ -26,9 +40,33 @@ export declare const NOVEL_API: {
|
|
|
26
40
|
readonly foreshadow: "/api/dsh-novel-forge/foreshadow";
|
|
27
41
|
readonly exportBook: "/api/dsh-novel-forge/export";
|
|
28
42
|
readonly chapter: "/api/dsh-novel-forge/chapter";
|
|
43
|
+
/** 审查任意正文文本(作者手动编辑后,不落盘)。 */
|
|
44
|
+
readonly chapterCheck: "/api/dsh-novel-forge/chapter/check";
|
|
45
|
+
/** 保存手动编辑的正文(自动备份 .bak)。 */
|
|
46
|
+
readonly chapterSave: "/api/dsh-novel-forge/chapter/save";
|
|
29
47
|
readonly assistant: "/api/dsh-novel-forge/assistant";
|
|
30
48
|
readonly assistantHistory: "/api/dsh-novel-forge/assistant-history";
|
|
49
|
+
/** 清空助手对话记录。 */
|
|
50
|
+
readonly assistantClear: "/api/dsh-novel-forge/assistant/clear";
|
|
31
51
|
readonly bookshelf: "/api/dsh-novel-forge/bookshelf";
|
|
52
|
+
/** 导入已有项目目录(含 novel-project.json)到书架。 */
|
|
53
|
+
readonly bookshelfImportDir: "/api/dsh-novel-forge/bookshelf/import-dir";
|
|
54
|
+
/** 导入 txt/md 全本:拆章建项目并登记书架。 */
|
|
55
|
+
readonly bookshelfImportText: "/api/dsh-novel-forge/bookshelf/import-text";
|
|
56
|
+
/** 导入 txt/md 全本:拆章预览(不落盘)。 */
|
|
57
|
+
readonly bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview";
|
|
58
|
+
/** LLM 模型连通性测试:真实最小调用,验证 Key / 端点 / 模型可用。 */
|
|
59
|
+
readonly llmTest: "/api/dsh-novel-forge/llm-test";
|
|
60
|
+
/** 添加模型:厂商直填 key 或自定义路由,写进 DSH 凭据与 llm-pi-ai 路由。 */
|
|
61
|
+
readonly addModel: "/api/dsh-novel-forge/llm-add";
|
|
62
|
+
/** 运行时厂商目录(DSH pi-ai 可配置提供方 + 内置适配器)。 */
|
|
63
|
+
readonly llmVendors: "/api/dsh-novel-forge/llm-vendors";
|
|
64
|
+
/** 查询某个 provider 当前可用的模型(添加成功后可即时刷新)。 */
|
|
65
|
+
readonly llmModels: "/api/dsh-novel-forge/llm-models";
|
|
66
|
+
/** 已注册的提供方路由列表(提供方管理)。 */
|
|
67
|
+
readonly llmProviders: "/api/dsh-novel-forge/llm-providers";
|
|
68
|
+
/** 移除一个提供方。 */
|
|
69
|
+
readonly llmRemove: "/api/dsh-novel-forge/llm-remove";
|
|
32
70
|
/** 重置项目(可选携带新大纲):清空设定/卷/章节/伏笔/资产/事实库。 */
|
|
33
71
|
readonly reset: "/api/dsh-novel-forge/reset";
|
|
34
72
|
/** 全书一致性质检:LLM 扫描已生成章节,输出矛盾问题清单。 */
|
|
@@ -37,10 +75,74 @@ export declare const NOVEL_API: {
|
|
|
37
75
|
readonly charactersRefresh: "/api/dsh-novel-forge/characters/refresh";
|
|
38
76
|
/** 事实库回填:对历史已生成章节批量抽取事实(旧章节无事实记录时用)。 */
|
|
39
77
|
readonly factsBackfill: "/api/dsh-novel-forge/facts/backfill";
|
|
40
|
-
/**
|
|
78
|
+
/** 道藏局部修补(如世界观规则编辑)。 */
|
|
41
79
|
readonly biblePatch: "/api/dsh-novel-forge/bible/patch";
|
|
80
|
+
/** 小说简介:生成(AI)/补全(AI)/保存。 */
|
|
81
|
+
readonly blurb: "/api/dsh-novel-forge/blurb";
|
|
82
|
+
/** 重命名当前书(同步项目与书架条目)。 */
|
|
83
|
+
readonly rename: "/api/dsh-novel-forge/rename";
|
|
84
|
+
/** 大世界:提炼 / 保存结构化数据(境界/区域/势力)。 */
|
|
85
|
+
readonly world: "/api/dsh-novel-forge/world";
|
|
86
|
+
/** 封面:GET 读取(dataUrl)/ POST 上传或移除。 */
|
|
87
|
+
readonly cover: "/api/dsh-novel-forge/blurb/cover";
|
|
88
|
+
/** 剧情线管理:增删改 + 关联章节。 */
|
|
89
|
+
readonly plotlines: "/api/dsh-novel-forge/plotlines";
|
|
90
|
+
/** 角色库:提炼 / 采纳 / 更新 / 删除。 */
|
|
91
|
+
readonly roles: "/api/dsh-novel-forge/roles";
|
|
92
|
+
/** 作者复盘补跑:对已写章节补齐 authorReview(全书流式 / 单章 JSON)。 */
|
|
93
|
+
readonly reviewBackfill: "/api/dsh-novel-forge/review/backfill";
|
|
94
|
+
/** 章节复位:generating 卡死 → pending(可重新生成)。 */
|
|
95
|
+
readonly chapterReset: "/api/dsh-novel-forge/chapter/reset";
|
|
96
|
+
/** 章节直接通过:作者对 rejected/written 章节行使最终决定权。 */
|
|
97
|
+
readonly chapterApprove: "/api/dsh-novel-forge/chapter/approve";
|
|
98
|
+
/** 敏感词检查:全书已写章节或指定文本。 */
|
|
99
|
+
readonly sensitiveCheck: "/api/dsh-novel-forge/sensitive-check";
|
|
100
|
+
/** 开书想法 → 补全大纲:输入一句话想法,生成 2-3 个可选大纲方案。 */
|
|
101
|
+
readonly outlineSuggest: "/api/dsh-novel-forge/outline/suggest";
|
|
102
|
+
/** 反推大纲:从已写章节正文反向生成全书总纲(NDJSON 流)。 */
|
|
103
|
+
readonly outlineReverse: "/api/dsh-novel-forge/outline/reverse";
|
|
104
|
+
/** 拆书分析:对已写章节做结构/人物/文风/卖点四维体检(两阶段:源笔记→分节分析)。 */
|
|
105
|
+
readonly breakdown: "/api/dsh-novel-forge/breakdown";
|
|
106
|
+
/** 生产单:启动批量生产(计划补足 + 逐章生成 + 被拒分级处理)。 */
|
|
107
|
+
readonly runStart: "/api/dsh-novel-forge/run/start";
|
|
108
|
+
/** 生产单控制:pause / resume / stop。 */
|
|
109
|
+
readonly runControl: "/api/dsh-novel-forge/run/control";
|
|
110
|
+
/** 生产单状态(含进度统计与日志)。 */
|
|
111
|
+
readonly runStatus: "/api/dsh-novel-forge/run/status";
|
|
42
112
|
readonly config: "/api/dsh-novel-forge/config";
|
|
113
|
+
/** 输出目录迁移:dryRun 预览 / 确认后搬文件并联动配置与书架。 */
|
|
114
|
+
readonly moveOutputDir: "/api/dsh-novel-forge/move-output-dir";
|
|
115
|
+
/** 本书参数:POST {} 读取;POST {patch} 合并保存(存 novel-project.json)。 */
|
|
116
|
+
readonly bookSettings: "/api/dsh-novel-forge/book-settings";
|
|
43
117
|
readonly openFolder: "/api/dsh-novel-forge/open-folder";
|
|
118
|
+
/** 插件自更新:在 DSH profile 目录拉取最新 npm 版(下载后需重启 DSH 生效)。 */
|
|
119
|
+
readonly pluginUpdate: "/api/dsh-novel-forge/plugin/update";
|
|
120
|
+
/** 作者资产库/总数据:读取个人跨书资产(笔法/红线/套路/角色模板/世界观模板)。 */
|
|
121
|
+
readonly authorAssets: "/api/dsh-novel-forge/author-assets";
|
|
122
|
+
/** 作者资产库:新增/更新一条资产(upsert by id)。 */
|
|
123
|
+
readonly authorAssetsUpsert: "/api/dsh-novel-forge/author-assets/upsert";
|
|
124
|
+
/** 作者资产库:删除一条资产。 */
|
|
125
|
+
readonly authorAssetsRemove: "/api/dsh-novel-forge/author-assets/remove";
|
|
126
|
+
/** 作者资产库:导入默认(书架书的写作资产/角色 + 内置全局库)批量沉淀。 */
|
|
127
|
+
readonly authorAssetsImportDefault: "/api/dsh-novel-forge/author-assets/import-default";
|
|
128
|
+
/** 改编模式:上传全文 → 分析 → 原文设定卡片/可改范围矩阵。 */
|
|
129
|
+
readonly adaptAnalyze: "/api/dsh-novel-forge/adapt/analyze";
|
|
130
|
+
/** 改编模式:确认要改的维度 → 生成映射表/改编规则/联动影响清单。 */
|
|
131
|
+
readonly adaptPropose: "/api/dsh-novel-forge/adapt/propose";
|
|
132
|
+
/** 改编模式:执行术语替换(全局替换 + 命中统计 + 改编文本预览)。 */
|
|
133
|
+
readonly adaptExecute: "/api/dsh-novel-forge/adapt/execute";
|
|
134
|
+
/** 改编模式:保存改编全文为新书(原书保留,登记书架)。 */
|
|
135
|
+
readonly adaptSave: "/api/dsh-novel-forge/adapt/save";
|
|
136
|
+
/** 改编模式:从源全文 + 编辑后方案提炼新书资料并保存为「待写新书」。 */
|
|
137
|
+
readonly adaptMaterialize: "/api/dsh-novel-forge/adapt/materialize";
|
|
138
|
+
/** 改编模式:rewrite 逐章重写(NDJSON 流式进度)。 */
|
|
139
|
+
readonly adaptRewriteStream: "/api/dsh-novel-forge/adapt/rewrite-stream";
|
|
140
|
+
/** 改编模式:把预览/微调后的新书资料写入并登记书架。 */
|
|
141
|
+
readonly adaptMaterializeSave: "/api/dsh-novel-forge/adapt/materialize-save";
|
|
142
|
+
/** 主题自定义背景:上传图片(POST,存盘并返回服务端 URL)。 */
|
|
143
|
+
readonly themeBackgroundUpload: "/api/dsh-novel-forge/theme/background";
|
|
144
|
+
/** 主题自定义背景:读取已上传文件(GET prefix,/theme/background/<name>)。 */
|
|
145
|
+
readonly themeBackgroundGet: "/api/dsh-novel-forge/theme/background";
|
|
44
146
|
};
|
|
45
147
|
/** 书架:一本书的条目。 */
|
|
46
148
|
export interface BookEntry {
|
|
@@ -61,6 +163,8 @@ export interface BookshelfSnapshot {
|
|
|
61
163
|
done: number;
|
|
62
164
|
total: number;
|
|
63
165
|
hasProject: boolean;
|
|
166
|
+
hasCover: boolean;
|
|
167
|
+
blurb?: string;
|
|
64
168
|
}>;
|
|
65
169
|
/** 当前激活的书 id(无则 null)。 */
|
|
66
170
|
activeBookId: string | null;
|
|
@@ -85,6 +189,60 @@ export interface BookActivateRequest {
|
|
|
85
189
|
export interface BookRemoveRequest {
|
|
86
190
|
id: string;
|
|
87
191
|
}
|
|
192
|
+
/** POST /bookshelf/import-dir 请求:导入已有项目目录。 */
|
|
193
|
+
export interface BookImportDirRequest {
|
|
194
|
+
/** 项目目录(须含 novel-project.json)。 */
|
|
195
|
+
outputDir: string;
|
|
196
|
+
}
|
|
197
|
+
/** POST /bookshelf/import-dir 响应。 */
|
|
198
|
+
export interface BookImportDirResponse {
|
|
199
|
+
book: BookEntry;
|
|
200
|
+
/** true = 目录已在书架中(本次为重新激活)。 */
|
|
201
|
+
existed: boolean;
|
|
202
|
+
}
|
|
203
|
+
/** POST /bookshelf/import-text 请求:导入 txt/md 全本。两种模式二选一:
|
|
204
|
+
* - filePath:服务器本地文件路径;
|
|
205
|
+
* - text + fileName:浏览器上传的全文内容(fileName 用于推断书名)。
|
|
206
|
+
*/
|
|
207
|
+
export interface BookImportTextRequest {
|
|
208
|
+
/** 模式一:源文件绝对路径(txt 或 md)。 */
|
|
209
|
+
filePath?: string;
|
|
210
|
+
/** 模式二:浏览器上传的全文内容。 */
|
|
211
|
+
text?: string;
|
|
212
|
+
/** 模式二:原文件名(txt/md),用于推断书名与显示。 */
|
|
213
|
+
fileName?: string;
|
|
214
|
+
/** 输出目录;缺省为 ~/.dsh/novels/书名。 */
|
|
215
|
+
outputDir?: string;
|
|
216
|
+
}
|
|
217
|
+
/** POST /bookshelf/import-text 响应。 */
|
|
218
|
+
export interface BookImportTextResponse {
|
|
219
|
+
bookName: string;
|
|
220
|
+
/** 成功拆出的章节数。 */
|
|
221
|
+
chapters: number;
|
|
222
|
+
/** 因内容过短被跳过的章节标题列表。 */
|
|
223
|
+
skipped: string[];
|
|
224
|
+
/** 登记后的书架条目。 */
|
|
225
|
+
book: BookEntry;
|
|
226
|
+
}
|
|
227
|
+
/** POST /bookshelf/import-text/preview 请求:上传全文做拆章预览(不落盘)。 */
|
|
228
|
+
export interface BookImportTextPreviewRequest {
|
|
229
|
+
text: string;
|
|
230
|
+
/** 原文件名(txt/md),用于推断书名。 */
|
|
231
|
+
fileName?: string;
|
|
232
|
+
}
|
|
233
|
+
/** POST /bookshelf/import-text/preview 响应。 */
|
|
234
|
+
export interface BookImportTextPreviewResponse {
|
|
235
|
+
/** 预计书名(fileName 去扩展名)。 */
|
|
236
|
+
bookName: string;
|
|
237
|
+
/** 识别出的章节(已按正文长度过滤过短章节)。 */
|
|
238
|
+
chapters: Array<{
|
|
239
|
+
no: number;
|
|
240
|
+
title: string;
|
|
241
|
+
chars: number;
|
|
242
|
+
}>;
|
|
243
|
+
/** 因内容过短被跳过的章节标题列表。 */
|
|
244
|
+
skipped: string[];
|
|
245
|
+
}
|
|
88
246
|
/** Chapter lifecycle states (the writing pipeline's state machine). */
|
|
89
247
|
export type ChapterStatus = 'pending' | 'generating' | 'written' | 'reviewing' | 'approved' | 'rejected' | 'error';
|
|
90
248
|
/** One chapter in the plan. */
|
|
@@ -99,8 +257,26 @@ export interface ChapterPlan {
|
|
|
99
257
|
beats: string;
|
|
100
258
|
/** Target character count (defaults to the configured chapter size). */
|
|
101
259
|
targetChars: number;
|
|
260
|
+
/** 本章必达项(必须推进的局面/关系/信息/风险/决策变化)。 */
|
|
261
|
+
mustAdvance?: string[];
|
|
262
|
+
/** 本章必须保持/不得破坏的项(如人物状态、已有伏笔不提前揭)。 */
|
|
263
|
+
mustPreserve?: string[];
|
|
264
|
+
/** 本章不可违背的人物硬事实(身份/阵营/境界/当前位置/知情度)。 */
|
|
265
|
+
characterHardFacts?: string[];
|
|
266
|
+
/** 伏笔操作指令(seed/touch/pressure/partial_reveal/payoff/forbid)。 */
|
|
267
|
+
payoffDirectives?: Array<{
|
|
268
|
+
no?: number;
|
|
269
|
+
operation?: 'seed' | 'touch' | 'pressure' | 'partial_reveal' | 'payoff' | 'forbid';
|
|
270
|
+
text?: string;
|
|
271
|
+
}>;
|
|
272
|
+
/** 章末钩子要求(悬念/反转/新线索/未闭合选择)。 */
|
|
273
|
+
endingHook?: string;
|
|
274
|
+
/** 本章义务合约(人类可读摘要,供生成与审稿共同锚定)。 */
|
|
275
|
+
obligation?: string;
|
|
102
276
|
/** Generation/review state. */
|
|
103
277
|
status: ChapterStatus;
|
|
278
|
+
/** 进入 generating 的时间(用于超时自动复位;未在生成时无此字段)。 */
|
|
279
|
+
generatingAt?: string;
|
|
104
280
|
/** Actual character count once generated. */
|
|
105
281
|
chars?: number;
|
|
106
282
|
/** Failure message when status is 'error'. */
|
|
@@ -111,20 +287,65 @@ export interface ChapterPlan {
|
|
|
111
287
|
summary?: string;
|
|
112
288
|
/** Latest review report (present once reviewed). */
|
|
113
289
|
review?: ReviewReport;
|
|
290
|
+
/** 作者复盘:钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势(生成后自动)。 */
|
|
291
|
+
authorReview?: AuthorReview;
|
|
114
292
|
/**
|
|
115
293
|
* 待确认草稿:润色(去AI味)或整章重写的产物正文。生成时先存这里,
|
|
116
294
|
* 用户看过对比后点「采纳」才覆盖正文文件;点「放弃」则丢弃。刷新页面不丢失。
|
|
117
295
|
*/
|
|
118
296
|
pendingDraft?: string;
|
|
119
297
|
}
|
|
298
|
+
/** 作者复盘:叙事结构层面的逐章检查(钩子/推进/连续性/趋势)。 */
|
|
299
|
+
export interface AuthorReview {
|
|
300
|
+
/** 上一章结尾钩子是否在本章兑现。 */
|
|
301
|
+
hookHonored: boolean;
|
|
302
|
+
/** 钩子兑现说明(未兑现时给出建议)。 */
|
|
303
|
+
hookNote: string;
|
|
304
|
+
/** 本章结尾钩子强度 0-10。 */
|
|
305
|
+
endingHook: number;
|
|
306
|
+
/** 剧情线推进情况(推进了哪条线/或未推进)。 */
|
|
307
|
+
plotlineProgress: string;
|
|
308
|
+
/** 结构化:本章推进的剧情线名称列表(与项目剧情线 name 精确匹配,复盘后自动关联章节)。 */
|
|
309
|
+
advancedLines?: string[];
|
|
310
|
+
/** 连续性检查(人物位置/时间/伤势/资源是否与上章衔接)。 */
|
|
311
|
+
continuity: string;
|
|
312
|
+
/** 近期节奏趋势提示(拖沓/爽点密度等)。 */
|
|
313
|
+
trend: string;
|
|
314
|
+
/** 本章发生的关键状态变化(人物状态/世界局面/关系/资源),用于回灌整本与事实库。 */
|
|
315
|
+
stateChanges?: string[];
|
|
316
|
+
/** 本章新引入或升级的冲突(供整本控制层与后续卷节奏参考)。 */
|
|
317
|
+
newConflicts?: string[];
|
|
318
|
+
/** 本章埋下/推进的新线索(供知识与伏笔系统回灌)。 */
|
|
319
|
+
clues?: string[];
|
|
320
|
+
/** 本章缺席但值得注意的角色及风险(卷级职责/缺席风险)。 */
|
|
321
|
+
absentRisks?: string[];
|
|
322
|
+
/** 复盘时间。 */
|
|
323
|
+
reviewedAt: string;
|
|
324
|
+
}
|
|
325
|
+
/** 审稿维度(结构化定位问题类别;与 review-policy.ts 的 REVIEW_DIMENSIONS 对齐)。 */
|
|
326
|
+
export type ReviewDimension = 'character' | 'setting' | 'redline' | 'writing' | 'pacing' | 'logic' | 'anti-ai' | 'presentation' | 'compliance';
|
|
120
327
|
/** One review finding. */
|
|
121
328
|
export interface ReviewIssue {
|
|
122
329
|
/** Severity: high = must fix, medium = should fix, low = suggestion. */
|
|
123
330
|
severity: 'high' | 'medium' | 'low';
|
|
331
|
+
/** 问题维度(可选;缺省由前端按 item 推断)。 */
|
|
332
|
+
dimension?: ReviewDimension;
|
|
124
333
|
/** What the problem is. */
|
|
125
334
|
item: string;
|
|
126
335
|
/** Concrete suggestion for fixing it. */
|
|
127
336
|
suggestion: string;
|
|
337
|
+
/** 命中的反 AI 规则名(结构化,便于统计)。 */
|
|
338
|
+
ruleName?: string;
|
|
339
|
+
/** 规则类别:forbidden / risk / encourage。 */
|
|
340
|
+
ruleType?: 'forbidden' | 'risk' | 'encourage';
|
|
341
|
+
/** 问题细分类(如 套话 句式 段落 心理 设定)。 */
|
|
342
|
+
category?: string;
|
|
343
|
+
/** 命中的原文摘录。 */
|
|
344
|
+
excerpt?: string;
|
|
345
|
+
/** 判定理由。 */
|
|
346
|
+
reason?: string;
|
|
347
|
+
/** 是否可自动改写。 */
|
|
348
|
+
canAutoRewrite?: boolean;
|
|
128
349
|
}
|
|
129
350
|
/** AI review report for one chapter. */
|
|
130
351
|
export interface ReviewReport {
|
|
@@ -136,6 +357,15 @@ export interface ReviewReport {
|
|
|
136
357
|
verdict: string;
|
|
137
358
|
/** Individual findings. */
|
|
138
359
|
issues: ReviewIssue[];
|
|
360
|
+
/** 风险分 0-100(越高越需人工处理;源自 LLM 复核与本地扫描)。 */
|
|
361
|
+
riskScore?: number;
|
|
362
|
+
/** 本地 AI 味指数 0-100(越高越像 AI;LLM 复核锚点,供 UI 展示)。 */
|
|
363
|
+
aiFlavor?: number;
|
|
364
|
+
/** 本地扫描命中的高频套话(按次数降序,取前若干)。 */
|
|
365
|
+
aiPhrases?: Array<{
|
|
366
|
+
word: string;
|
|
367
|
+
count: number;
|
|
368
|
+
}>;
|
|
139
369
|
/** When the review ran. */
|
|
140
370
|
reviewedAt: string;
|
|
141
371
|
}
|
|
@@ -151,6 +381,155 @@ export interface Volume {
|
|
|
151
381
|
chapterStart: number;
|
|
152
382
|
/** Last chapter number (inclusive). */
|
|
153
383
|
chapterEnd: number;
|
|
384
|
+
/** 卷级战略(这一卷的定位/承转,如「立威卷」「冲突升级卷」)。 */
|
|
385
|
+
strategy?: string;
|
|
386
|
+
/** 卷节奏板(这一卷的节奏安排:起-承-转-合/爽点密度/关键节点)。 */
|
|
387
|
+
pacing?: string;
|
|
388
|
+
}
|
|
389
|
+
/** 开书定盘:面向读者的承诺与流派定位(生成/规划均可引用)。 */
|
|
390
|
+
export interface BookContract {
|
|
391
|
+
/** 一句话卖点/题材承诺。 */
|
|
392
|
+
promise?: string;
|
|
393
|
+
/** 主推进模式名(从推进模式库选)。 */
|
|
394
|
+
primaryModeName?: string;
|
|
395
|
+
/** 辅助推进模式名。 */
|
|
396
|
+
secondaryModeNames?: string[];
|
|
397
|
+
/** 整体文风基调(一句话)。 */
|
|
398
|
+
tone?: string;
|
|
399
|
+
/** 目标平台(如「番茄」)。 */
|
|
400
|
+
targetPlatform?: string;
|
|
401
|
+
}
|
|
402
|
+
/** 书内知识库文档(供生成/规划时检索注入的参考资料)。 */
|
|
403
|
+
export interface KnowledgeDoc {
|
|
404
|
+
id: string;
|
|
405
|
+
title: string;
|
|
406
|
+
content: string;
|
|
407
|
+
updatedAt: string;
|
|
408
|
+
}
|
|
409
|
+
/** POST /knowledge request:增删改知识库文档。 */
|
|
410
|
+
export interface KnowledgeRequest {
|
|
411
|
+
action: 'add' | 'remove' | 'replace';
|
|
412
|
+
doc?: {
|
|
413
|
+
id?: string;
|
|
414
|
+
title: string;
|
|
415
|
+
content: string;
|
|
416
|
+
};
|
|
417
|
+
id?: string;
|
|
418
|
+
}
|
|
419
|
+
/** POST /book-analysis request。 */
|
|
420
|
+
export interface BookAnalysisRequest {
|
|
421
|
+
text: string;
|
|
422
|
+
}
|
|
423
|
+
/** 书分析/拆书结果。 */
|
|
424
|
+
export interface BookAnalysisResult {
|
|
425
|
+
sellingPoints: string[];
|
|
426
|
+
structure: string[];
|
|
427
|
+
lessons: string[];
|
|
428
|
+
risks: string[];
|
|
429
|
+
}
|
|
430
|
+
/** POST /idea-inspiration request。 */
|
|
431
|
+
export interface IdeaInspirationRequest {
|
|
432
|
+
idea: string;
|
|
433
|
+
count?: number;
|
|
434
|
+
}
|
|
435
|
+
/** 创意灵感结果:多方向开书灵感。 */
|
|
436
|
+
export interface IdeaInspirationResult {
|
|
437
|
+
ideas: Array<{
|
|
438
|
+
title: string;
|
|
439
|
+
hook: string;
|
|
440
|
+
genre: string;
|
|
441
|
+
pov: string;
|
|
442
|
+
payoff: string;
|
|
443
|
+
}>;
|
|
444
|
+
}
|
|
445
|
+
/** POST /director request。 */
|
|
446
|
+
export interface DirectorRequest {
|
|
447
|
+
focus?: string;
|
|
448
|
+
}
|
|
449
|
+
/** 自动导演编排建议(下一卷/阶段编排 + 修复再平衡)。 */
|
|
450
|
+
export interface DirectorAdvice {
|
|
451
|
+
summary: string;
|
|
452
|
+
nextArc: string[];
|
|
453
|
+
pacing: string;
|
|
454
|
+
risks: string[];
|
|
455
|
+
fixes: string[];
|
|
456
|
+
}
|
|
457
|
+
/** 自动导演「采纳」后生成的书内待办项。 */
|
|
458
|
+
export interface DirectorTodo {
|
|
459
|
+
id: string;
|
|
460
|
+
text: string;
|
|
461
|
+
/** 来源:风险 或 修复。 */
|
|
462
|
+
source: 'risk' | 'fix';
|
|
463
|
+
done: boolean;
|
|
464
|
+
createdAt: string;
|
|
465
|
+
}
|
|
466
|
+
/** 题材雷达:单条市场信号。 */
|
|
467
|
+
export interface MarketRadarSignal {
|
|
468
|
+
id: string;
|
|
469
|
+
kind: 'genre' | 'protagonist' | 'advantage' | 'opening' | 'relationship' | 'title_pattern' | 'opportunity' | 'crowding';
|
|
470
|
+
title: string;
|
|
471
|
+
detail: string;
|
|
472
|
+
/** 趋势:current / rising / stable / falling。 */
|
|
473
|
+
direction?: 'current' | 'rising' | 'stable' | 'falling';
|
|
474
|
+
/** 是否建议优先考虑。 */
|
|
475
|
+
recommended?: boolean;
|
|
476
|
+
}
|
|
477
|
+
/** 题材雷达:生产底座(引用内置题材/推进模式库,或给出新资产)。 */
|
|
478
|
+
export interface ProductionFoundation {
|
|
479
|
+
genre: {
|
|
480
|
+
existingId?: string;
|
|
481
|
+
name: string;
|
|
482
|
+
description: string;
|
|
483
|
+
template?: string;
|
|
484
|
+
};
|
|
485
|
+
primaryStoryMode: {
|
|
486
|
+
existingId?: string;
|
|
487
|
+
name: string;
|
|
488
|
+
driver: string;
|
|
489
|
+
readerExpectation: string;
|
|
490
|
+
};
|
|
491
|
+
secondaryStoryMode?: {
|
|
492
|
+
existingId?: string;
|
|
493
|
+
name: string;
|
|
494
|
+
driver: string;
|
|
495
|
+
readerExpectation: string;
|
|
496
|
+
};
|
|
497
|
+
}
|
|
498
|
+
/** 题材雷达:开书创意简报(可执行,严禁照搬具体作品/命名)。 */
|
|
499
|
+
export interface MarketCreativeBrief {
|
|
500
|
+
promptBlock: string;
|
|
501
|
+
openingIdea: string;
|
|
502
|
+
coreAdvantage: string;
|
|
503
|
+
bookSellingPoint: string;
|
|
504
|
+
first30ChapterPromise: string;
|
|
505
|
+
}
|
|
506
|
+
/** 题材雷达结果。 */
|
|
507
|
+
export interface MarketRadarResult {
|
|
508
|
+
signals: MarketRadarSignal[];
|
|
509
|
+
productionFoundation: ProductionFoundation;
|
|
510
|
+
/** 开书创意简报(可选;用「用信号创作」接口单独生成)。 */
|
|
511
|
+
creativeBrief?: MarketCreativeBrief;
|
|
512
|
+
}
|
|
513
|
+
/** POST /market-radar request。 */
|
|
514
|
+
export interface MarketRadarRequest {
|
|
515
|
+
platform?: string;
|
|
516
|
+
genre?: string;
|
|
517
|
+
keywords?: string;
|
|
518
|
+
feedText?: string;
|
|
519
|
+
/** 已扫描的上榜记录(来自真实榜单抓取),用于让分析基于真实榜单证据。 */
|
|
520
|
+
candidates?: Array<{
|
|
521
|
+
title: string;
|
|
522
|
+
author?: string;
|
|
523
|
+
tags?: string[];
|
|
524
|
+
synopsis?: string;
|
|
525
|
+
category?: string;
|
|
526
|
+
heatLabel?: string;
|
|
527
|
+
}>;
|
|
528
|
+
}
|
|
529
|
+
/** POST /market-radar/brief request:用选中的信号 + 影响模式生成开书创意。 */
|
|
530
|
+
export interface MarketRadarBriefRequest {
|
|
531
|
+
influenceMode: 'follow_hot' | 'differentiate' | 'light';
|
|
532
|
+
signals: MarketRadarSignal[];
|
|
154
533
|
}
|
|
155
534
|
/** A character card from the story bible. */
|
|
156
535
|
export interface CharacterCard {
|
|
@@ -162,6 +541,8 @@ export interface CharacterCard {
|
|
|
162
541
|
goals: string;
|
|
163
542
|
/** Key relations to other characters. */
|
|
164
543
|
relations: string;
|
|
544
|
+
/** 知情度:该角色已经知道的事实/秘密(未列出的信息该角色不知道)。 */
|
|
545
|
+
knowledge?: string[];
|
|
165
546
|
}
|
|
166
547
|
/** The structured story bible (worldbuilding extracted from the outline). */
|
|
167
548
|
export interface StoryBible {
|
|
@@ -217,6 +598,180 @@ export interface AuditResponse {
|
|
|
217
598
|
auditedChapters: number;
|
|
218
599
|
/** 质检时间。 */
|
|
219
600
|
auditedAt: string;
|
|
601
|
+
/** 本次质检使用的模型(auditModel 或全局 model)。 */
|
|
602
|
+
model?: string;
|
|
603
|
+
}
|
|
604
|
+
/** 全书质检的实时状态(通过 /status 暴露给面板/外部读取)。 */
|
|
605
|
+
export interface AuditStatus {
|
|
606
|
+
status: 'idle' | 'running' | 'done' | 'error';
|
|
607
|
+
/** 开始时间(ISO)。 */
|
|
608
|
+
startedAt?: string;
|
|
609
|
+
/** 结束时间(ISO)。 */
|
|
610
|
+
finishedAt?: string;
|
|
611
|
+
/** 总批次数(0 = 尚未开始/无章节)。 */
|
|
612
|
+
totalBatches: number;
|
|
613
|
+
/** 已完成批次数。 */
|
|
614
|
+
completedBatches: number;
|
|
615
|
+
/** 参与质检的章节数。 */
|
|
616
|
+
auditedChapters?: number;
|
|
617
|
+
/** 发现的问题数(done 后有效)。 */
|
|
618
|
+
issuesCount?: number;
|
|
619
|
+
/** 最近一次质检的问题清单(done 后有效;error 时为空)。 */
|
|
620
|
+
issues?: AuditIssue[];
|
|
621
|
+
/** 失败信息(error 时有效)。 */
|
|
622
|
+
error?: string;
|
|
623
|
+
}
|
|
624
|
+
/** 一条剧情线(主线/支线/人物线/悬念线)。 */
|
|
625
|
+
export interface Plotline {
|
|
626
|
+
/** 稳定 id。 */
|
|
627
|
+
id: string;
|
|
628
|
+
/** 线名。 */
|
|
629
|
+
name: string;
|
|
630
|
+
/** 类型:主线 / 支线 / 人物线 / 悬念线。 */
|
|
631
|
+
kind: 'main' | 'branch' | 'character' | 'mystery';
|
|
632
|
+
/** 目标/终点(这条线最终要完成什么)。 */
|
|
633
|
+
goal: string;
|
|
634
|
+
/** 当前进度说明(最近推进到哪)。 */
|
|
635
|
+
progress: string;
|
|
636
|
+
/** 生命周期状态。 */
|
|
637
|
+
status: 'active' | 'paused' | 'resolved' | 'abandoned';
|
|
638
|
+
/** 关联章节号(推进/落地的章节)。 */
|
|
639
|
+
chapters: number[];
|
|
640
|
+
/** 创建时间。 */
|
|
641
|
+
createdAt: string;
|
|
642
|
+
}
|
|
643
|
+
/** POST /plotlines 请求:剧情线增删改 + 关联章节 + AI 辅助。 */
|
|
644
|
+
export interface PlotlinesRequest {
|
|
645
|
+
op: 'add' | 'update' | 'remove' | 'link' | 'suggest' | 'refresh' | 'health' | 'plan';
|
|
646
|
+
/** add / update 时传入的完整剧情线。 */
|
|
647
|
+
line?: Plotline;
|
|
648
|
+
/** remove / link / refresh 时的目标线 id。 */
|
|
649
|
+
id?: string;
|
|
650
|
+
/** link 时关联的章节号。 */
|
|
651
|
+
chapterNo?: number;
|
|
652
|
+
}
|
|
653
|
+
/** 剧情线健康检查报告。 */
|
|
654
|
+
export interface PlotlineHealthReport {
|
|
655
|
+
/** 是否需要新线(需要 / 暂不需要 / 再写 X 章后需要)。 */
|
|
656
|
+
verdict: string;
|
|
657
|
+
/** 建议添加新线的时机说明。 */
|
|
658
|
+
timing: string;
|
|
659
|
+
/** 依据(基于数据的理由,每条一句)。 */
|
|
660
|
+
reasons: string[];
|
|
661
|
+
/** 各线健康度。 */
|
|
662
|
+
lines: Array<{
|
|
663
|
+
name: string;
|
|
664
|
+
/** ok=健康 / warning=预警 / stale=搁置过久。 */
|
|
665
|
+
health: 'ok' | 'warning' | 'stale';
|
|
666
|
+
note: string;
|
|
667
|
+
}>;
|
|
668
|
+
}
|
|
669
|
+
/** 剧情方案:下一阶段目标 + 建议新线。 */
|
|
670
|
+
export interface PlotlinePlan {
|
|
671
|
+
/** 下一阶段(未来 5-10 章)剧情方向。 */
|
|
672
|
+
direction: string;
|
|
673
|
+
/** 建议的新线(可逐条采纳)。 */
|
|
674
|
+
suggestions: Plotline[];
|
|
675
|
+
}
|
|
676
|
+
/** POST /plotlines 响应。 */
|
|
677
|
+
export interface PlotlinesResponse {
|
|
678
|
+
plotlines: Plotline[];
|
|
679
|
+
/** op=suggest 时的 建议候选线。 */
|
|
680
|
+
suggestions?: Plotline[];
|
|
681
|
+
/** op=health 时的健康检查报告。 */
|
|
682
|
+
health?: PlotlineHealthReport;
|
|
683
|
+
/** op=plan 时的剧情方案。 */
|
|
684
|
+
plan?: PlotlinePlan;
|
|
685
|
+
}
|
|
686
|
+
/** 一条敏感词命中。 */
|
|
687
|
+
export interface SensitiveHit {
|
|
688
|
+
/** 命中章节号(文本检测时为 0)。 */
|
|
689
|
+
chapterNo: number;
|
|
690
|
+
/** 命中的违禁词。 */
|
|
691
|
+
word: string;
|
|
692
|
+
/** 类别:政治 / 擦边 / 暴力 / 辱骂 / 广告 / 其他。 */
|
|
693
|
+
category: string;
|
|
694
|
+
/** 出现次数。 */
|
|
695
|
+
count: number;
|
|
696
|
+
}
|
|
697
|
+
/** POST /sensitive-check 请求:检测指定章节/任意文本/全书。 */
|
|
698
|
+
export interface SensitiveCheckRequest {
|
|
699
|
+
/** 检测该章正文。 */
|
|
700
|
+
chapterNo?: number;
|
|
701
|
+
/** 检测任意文本(优先于 chapterNo)。 */
|
|
702
|
+
text?: string;
|
|
703
|
+
/** 扫描全部已写章节。 */
|
|
704
|
+
all?: boolean;
|
|
705
|
+
}
|
|
706
|
+
/** POST /sensitive-check 响应。 */
|
|
707
|
+
export interface SensitiveCheckResponse {
|
|
708
|
+
hits: SensitiveHit[];
|
|
709
|
+
/** 参与扫描的章节数。 */
|
|
710
|
+
scannedChapters: number;
|
|
711
|
+
}
|
|
712
|
+
/** 开书想法 → AI 大纲方案(一个候选)。 */
|
|
713
|
+
export interface OutlineCandidate {
|
|
714
|
+
/** 唯一 id(前端暂留/换批用)。 */
|
|
715
|
+
id: string;
|
|
716
|
+
/** 推荐书名。 */
|
|
717
|
+
bookName: string;
|
|
718
|
+
/** 题材(如 仙侠修真 / 都市)。 */
|
|
719
|
+
genre: string;
|
|
720
|
+
/** 核心卖点一句话。 */
|
|
721
|
+
sellingPoint: string;
|
|
722
|
+
/** 完整大纲文本(可直接用作项目大纲,≥800 字)。 */
|
|
723
|
+
outline: string;
|
|
724
|
+
}
|
|
725
|
+
/** POST /outline/suggest 请求:想法 → 2-3 个可选大纲。 */
|
|
726
|
+
export interface OutlineSuggestRequest {
|
|
727
|
+
/** 作者想法(一两句话,≥50 字)。 */
|
|
728
|
+
idea: string;
|
|
729
|
+
/** 本次要生成的候选数(默认 3,最多 3)。 */
|
|
730
|
+
count?: number;
|
|
731
|
+
/** 已暂留方案的剧情方向摘要(换批时让 LLM 避开,防止与已留方案重复)。 */
|
|
732
|
+
exclude?: string[];
|
|
733
|
+
}
|
|
734
|
+
/** POST /outline/suggest 响应。 */
|
|
735
|
+
export interface OutlineSuggestResponse {
|
|
736
|
+
candidates: OutlineCandidate[];
|
|
737
|
+
}
|
|
738
|
+
/** 拆书分析:一个分析小节。 */
|
|
739
|
+
export interface BreakdownSection {
|
|
740
|
+
/** 小节键:overview / plot / character / style / market。 */
|
|
741
|
+
key: string;
|
|
742
|
+
/** 小节标题(如「拆书总览」)。 */
|
|
743
|
+
title: string;
|
|
744
|
+
/** 可读分析稿(markdown)。 */
|
|
745
|
+
markdown: string;
|
|
746
|
+
/** 结构化数据(程序可消费)。 */
|
|
747
|
+
structured: Record<string, unknown>;
|
|
748
|
+
}
|
|
749
|
+
/** 拆书分析:一条证据(结论→原文回溯)。 */
|
|
750
|
+
export interface BreakdownEvidence {
|
|
751
|
+
label: string;
|
|
752
|
+
excerpt: string;
|
|
753
|
+
/** 来源章节号(0 = 未定位)。 */
|
|
754
|
+
chapterNo: number;
|
|
755
|
+
/** 指向的结构化字段。 */
|
|
756
|
+
fieldKey?: string;
|
|
757
|
+
}
|
|
758
|
+
/** POST /breakdown 请求:对已写章节做拆书分析。 */
|
|
759
|
+
export interface BreakdownRequest {
|
|
760
|
+
/** 分析范围:'recent'=最近 20 章 / 'volume:N'=第 N 卷 / 'all'=全书(默认 recent)。 */
|
|
761
|
+
scope?: string;
|
|
762
|
+
/** 分析档位:'quick'=4 维(总览/剧情/人物/文风)/ 'standard'=5 维(+卖点)。 */
|
|
763
|
+
preset?: 'quick' | 'standard';
|
|
764
|
+
/** token 预算上限(默认 50000)。 */
|
|
765
|
+
budgetTokens?: number;
|
|
766
|
+
}
|
|
767
|
+
/** POST /breakdown 响应。 */
|
|
768
|
+
export interface BreakdownResponse {
|
|
769
|
+
sections: BreakdownSection[];
|
|
770
|
+
evidence: BreakdownEvidence[];
|
|
771
|
+
/** 参与分析的章节数。 */
|
|
772
|
+
chaptersScanned: number;
|
|
773
|
+
/** 估算消耗 token。 */
|
|
774
|
+
usedTokens: number;
|
|
220
775
|
}
|
|
221
776
|
/** 角色卡:角色当前状态(从事实库聚合)。 */
|
|
222
777
|
export interface RoleStatusCard {
|
|
@@ -230,11 +785,139 @@ export interface RoleStatusCard {
|
|
|
230
785
|
/** 出场次数。 */
|
|
231
786
|
appearances: number;
|
|
232
787
|
}
|
|
233
|
-
/**
|
|
788
|
+
/** 角色库条目(主表:作者维护 + 提炼 + 编年录自动聚合)。 */
|
|
789
|
+
export interface RoleRecord {
|
|
790
|
+
/** 角色名(唯一键)。 */
|
|
791
|
+
name: string;
|
|
792
|
+
/** 定位:主角 / 女主 / 女配 / 配角 / 反派 / 路人。 */
|
|
793
|
+
roleLabel: 'protagonist' | 'female_lead' | 'female_support' | 'support' | 'antagonist' | 'extra';
|
|
794
|
+
/** 身份一句话(如:祭族后裔、青云宗杂役)。 */
|
|
795
|
+
identity: string;
|
|
796
|
+
/** 性格标签。 */
|
|
797
|
+
traits: string[];
|
|
798
|
+
/** 目标与动机。 */
|
|
799
|
+
goals: string;
|
|
800
|
+
/** 关系网:[角色名](关系)。 */
|
|
801
|
+
relations: string[];
|
|
802
|
+
/** 成长线:阶段 → 说明(可含章节)。 */
|
|
803
|
+
arc: string[];
|
|
804
|
+
/** 知情度:该角色已经知道的信息。 */
|
|
805
|
+
knowledge: string[];
|
|
806
|
+
/** 首次出场章节(编年录聚合,可手动修正)。 */
|
|
807
|
+
firstChapter?: number;
|
|
808
|
+
}
|
|
809
|
+
/** POST /roles 请求:角色库增删改 + 提炼 + 参考图上传。 */
|
|
810
|
+
export interface RolesRequest {
|
|
811
|
+
op: 'extract' | 'adopt' | 'update' | 'remove';
|
|
812
|
+
/** adopt / update 时传入的角色(adopt 可修改后采纳)。 */
|
|
813
|
+
role?: RoleRecord;
|
|
814
|
+
/** remove 时的角色名。 */
|
|
815
|
+
name?: string;
|
|
816
|
+
}
|
|
817
|
+
/** POST /llm-test 请求:对选中的提供商/模型发一次最小真实调用。 */
|
|
818
|
+
export interface LlmTestRequest {
|
|
819
|
+
provider: string;
|
|
820
|
+
model: string;
|
|
821
|
+
}
|
|
822
|
+
/** POST /llm-test 响应。 */
|
|
823
|
+
export interface LlmTestResponse {
|
|
824
|
+
ok: boolean;
|
|
825
|
+
/** 连通延迟(毫秒)。 */
|
|
826
|
+
ms?: number;
|
|
827
|
+
/** 失败原因(已映射为人话)。 */
|
|
828
|
+
message?: string;
|
|
829
|
+
/** 稳定错误码(LlmError code),便于排查。 */
|
|
830
|
+
code?: string;
|
|
831
|
+
}
|
|
832
|
+
/** POST /roles 响应。 */
|
|
833
|
+
export interface RolesResponse {
|
|
834
|
+
roles: RoleRecord[];
|
|
835
|
+
/** op=extract 时的 AI 候选角色。 */
|
|
836
|
+
candidates?: RoleRecord[];
|
|
837
|
+
}
|
|
838
|
+
/** POST /bible/patch 请求:局部修补道藏。 */
|
|
234
839
|
export interface BiblePatchRequest {
|
|
235
840
|
worldRules?: string[];
|
|
236
841
|
redLines?: string[];
|
|
237
842
|
style?: string[];
|
|
843
|
+
/** 角色卡整体替换(人物志编辑知情度等)。 */
|
|
844
|
+
characters?: CharacterCard[];
|
|
845
|
+
}
|
|
846
|
+
/** POST /blurb 请求:生成/补全或手动保存小说简介。 */
|
|
847
|
+
export interface BlurbRequest {
|
|
848
|
+
action: 'generate' | 'save';
|
|
849
|
+
/** 已写好的开头(补全时使用;留空 = 全量生成)。 */
|
|
850
|
+
partial?: string;
|
|
851
|
+
/** 手动保存的完整简介(action=save 时)。 */
|
|
852
|
+
text?: string;
|
|
853
|
+
}
|
|
854
|
+
/** POST /chapter/check|save 请求:审查/保存手动编辑的正文。 */
|
|
855
|
+
export interface ChapterTextRequest {
|
|
856
|
+
chapterNo: number;
|
|
857
|
+
/** 当前编辑中的正文全文。 */
|
|
858
|
+
text: string;
|
|
859
|
+
/** 保存时携带:已在工作区审查过的报告(沿用落盘,不重复审);缺省则保存后自动正式审稿一次。 */
|
|
860
|
+
report?: ReviewReport;
|
|
861
|
+
/** 审查/验证时携带:上一轮审稿报告。传入后进入「验证模式」——逐条核对原意见是否解决、
|
|
862
|
+
* 只挑新增 high,不再全新找茬(防止"越修 high 越多")。 */
|
|
863
|
+
previousReport?: ReviewReport;
|
|
864
|
+
}
|
|
865
|
+
/** POST /chapter/save 响应。 */
|
|
866
|
+
export interface ChapterSaveResponse {
|
|
867
|
+
ok: boolean;
|
|
868
|
+
chars: number;
|
|
869
|
+
file: string;
|
|
870
|
+
/** 落盘的审稿报告(沿用工作区报告或保存后自动审稿)。 */
|
|
871
|
+
report?: ReviewReport;
|
|
872
|
+
}
|
|
873
|
+
/** POST /cover 请求:上传或移除封面。 */
|
|
874
|
+
export interface CoverRequest {
|
|
875
|
+
action: 'upload' | 'remove';
|
|
876
|
+
/** 上传时:data:image/...;base64,... 格式的图片数据。 */
|
|
877
|
+
dataUrl?: string;
|
|
878
|
+
}
|
|
879
|
+
/** POST /rename 请求:重命名当前书。 */
|
|
880
|
+
export interface RenameRequest {
|
|
881
|
+
bookName: string;
|
|
882
|
+
}
|
|
883
|
+
/** 大世界:一个境界等级。 */
|
|
884
|
+
export interface WorldRealm {
|
|
885
|
+
/** 境界名(练气/筑基/金丹…)。 */
|
|
886
|
+
name: string;
|
|
887
|
+
/** 描述:突破条件/寿命/标志等。 */
|
|
888
|
+
description: string;
|
|
889
|
+
}
|
|
890
|
+
/** 大世界:一个地理区域。 */
|
|
891
|
+
export interface WorldRegion {
|
|
892
|
+
name: string;
|
|
893
|
+
description: string;
|
|
894
|
+
/** 关联势力名(可空)。 */
|
|
895
|
+
faction?: string;
|
|
896
|
+
}
|
|
897
|
+
/** 大世界:一方势力。 */
|
|
898
|
+
export interface WorldFaction {
|
|
899
|
+
name: string;
|
|
900
|
+
/** 类型:宗门/家族/王朝/组织… */
|
|
901
|
+
kind: string;
|
|
902
|
+
description: string;
|
|
903
|
+
/** 驻地区域(可空)。 */
|
|
904
|
+
region?: string;
|
|
905
|
+
}
|
|
906
|
+
/** 大世界结构化数据。 */
|
|
907
|
+
export interface WorldState {
|
|
908
|
+
realms: WorldRealm[];
|
|
909
|
+
regions: WorldRegion[];
|
|
910
|
+
factions: WorldFaction[];
|
|
911
|
+
}
|
|
912
|
+
/** POST /world 请求:提炼或手动保存。 */
|
|
913
|
+
export interface WorldRequest {
|
|
914
|
+
action: 'generate' | 'save';
|
|
915
|
+
/** action=save 时的完整世界数据。 */
|
|
916
|
+
world?: WorldState;
|
|
917
|
+
}
|
|
918
|
+
/** GET /cover 响应:封面的 dataUrl(无封面为 null)。 */
|
|
919
|
+
export interface CoverResponse {
|
|
920
|
+
dataUrl: string | null;
|
|
238
921
|
}
|
|
239
922
|
/** The persisted project: outline + bible + plan + progress. */
|
|
240
923
|
export interface ProjectState {
|
|
@@ -256,11 +939,151 @@ export interface ProjectState {
|
|
|
256
939
|
assets?: ProjectAssets;
|
|
257
940
|
/** 事实库/时间线:每章生成后抽取,注入后续章节保持一致性。 */
|
|
258
941
|
facts?: ChapterFact[];
|
|
942
|
+
/** 书内知识库文档(可检索资料/设定/参考)。 */
|
|
943
|
+
knowledgeDocs?: KnowledgeDoc[];
|
|
944
|
+
/** 自动导演待办:风险/修复「采纳」后生成的随手清单。 */
|
|
945
|
+
todos?: DirectorTodo[];
|
|
946
|
+
/** 小说简介(面向读者的作品门面,生成或手动保存)。 */
|
|
947
|
+
blurb?: string;
|
|
948
|
+
/** 开书定盘:书籍级承诺与流派定位(前30章承诺/主副模式/文风/平台)。 */
|
|
949
|
+
bookContract?: BookContract;
|
|
950
|
+
/** 封面文件名(相对输出目录,如 cover.png)。 */
|
|
951
|
+
coverPath?: string;
|
|
952
|
+
/** 大世界结构化数据(境界体系/区域/势力)。 */
|
|
953
|
+
world?: WorldState;
|
|
954
|
+
/** 剧情线(主线/支线/人物线/悬念线)。 */
|
|
955
|
+
plotlines?: Plotline[];
|
|
956
|
+
/** 角色库(作者维护 + 提炼的主表)。 */
|
|
957
|
+
roles?: RoleRecord[];
|
|
958
|
+
/** 人物志:角色当前状态聚合结果(从编年录刷新后存档,打开页面直接显示)。 */
|
|
959
|
+
roleStatus?: RoleStatusCard[];
|
|
960
|
+
/** 本书参数(写作/审稿/推理/模型快切;未设字段回退全局 config)。 */
|
|
961
|
+
bookSettings?: BookSettings;
|
|
259
962
|
/** ISO timestamps. */
|
|
260
963
|
createdAt: string;
|
|
261
964
|
updatedAt: string;
|
|
262
965
|
}
|
|
263
|
-
/**
|
|
966
|
+
/** 本书参数(存 novel-project.json.bookSettings;未设字段回退全局 config)。 */
|
|
967
|
+
export interface BookSettings {
|
|
968
|
+
/** 本书使用的提供方路由(快切器写入)。 */
|
|
969
|
+
provider?: string;
|
|
970
|
+
/** 本书使用的主模型 id。 */
|
|
971
|
+
model?: string;
|
|
972
|
+
/** 本书写作推理档位。 */
|
|
973
|
+
reasoningEffort?: 'off' | 'low' | 'high' | 'max';
|
|
974
|
+
/** 本书分析类任务推理档位。 */
|
|
975
|
+
analysisReasoning?: 'off' | 'low' | 'high' | 'max';
|
|
976
|
+
/** 本书每章目标字数。 */
|
|
977
|
+
chapterChars?: number;
|
|
978
|
+
/** 本书单章最大输出 tokens。 */
|
|
979
|
+
maxTokens?: number;
|
|
980
|
+
/** 本书审稿通过分。 */
|
|
981
|
+
reviewPassScore?: number;
|
|
982
|
+
/** 本书是否写完自动审稿。 */
|
|
983
|
+
autoReview?: boolean;
|
|
984
|
+
/** 本书是否自动作者复盘。 */
|
|
985
|
+
autoAuthorReview?: boolean;
|
|
986
|
+
/** 本书是否修稿后自动复审。 */
|
|
987
|
+
autoReviewAfterRevise?: boolean;
|
|
988
|
+
}
|
|
989
|
+
/** 手动添加的模型库条目(只存插件内,不改 DSH 全局)。 */
|
|
990
|
+
export interface SavedModel {
|
|
991
|
+
/** 唯一 id(前端生成的短 id)。 */
|
|
992
|
+
id: string;
|
|
993
|
+
/** 展示名(可为空,回退到 model)。 */
|
|
994
|
+
name: string;
|
|
995
|
+
/** DSH 提供商路由(如 zai-coding-cn)。 */
|
|
996
|
+
provider: string;
|
|
997
|
+
/** 模型 id(如 glm-5.3-flash)。 */
|
|
998
|
+
model: string;
|
|
999
|
+
}
|
|
1000
|
+
/** DSH 模型添加:厂商预设(选择厂商,直接填 API Key)。 */
|
|
1001
|
+
export interface LlmVendor {
|
|
1002
|
+
id: string;
|
|
1003
|
+
name: string;
|
|
1004
|
+
/** 该厂商对应的 provider 路由。 */
|
|
1005
|
+
route: string;
|
|
1006
|
+
/** DSH 凭据引用名(写入 .credentials.yaml 的 refs)。 */
|
|
1007
|
+
apiKeyEnv: string;
|
|
1008
|
+
/** 默认模型 id。 */
|
|
1009
|
+
defaultModel: string;
|
|
1010
|
+
/** 建议可选模型 id 列表(下拉 data-list 用)。 */
|
|
1011
|
+
models: string[];
|
|
1012
|
+
/** 内置适配器(如 deepseek-official),无需注册 pi-ai 路由。 */
|
|
1013
|
+
builtin?: boolean;
|
|
1014
|
+
}
|
|
1015
|
+
/** 预置的常见厂商(id=provider 路由;添加模型下拉兜底用,其余厂商由运行时目录动态补充)。 */
|
|
1016
|
+
export declare const LLM_VENDORS: LlmVendor[];
|
|
1017
|
+
/** 运行时厂商目录的一项(添加到模型下拉;由 DSH 的 pi-ai 可配置提供方动态生成)。 */
|
|
1018
|
+
export interface LlmVendorOption {
|
|
1019
|
+
/** provider 路由 id(也是厂商下拉的值)。 */
|
|
1020
|
+
id: string;
|
|
1021
|
+
/** 展示名。 */
|
|
1022
|
+
name: string;
|
|
1023
|
+
/** 建议模型 id(可为空,用户手填)。 */
|
|
1024
|
+
models: string[];
|
|
1025
|
+
/** 已知 DSH 凭据引用名;为空时 host 生成 `PI_AI_<ID>_API_KEY`。 */
|
|
1026
|
+
apiKeyEnv?: string;
|
|
1027
|
+
/** 内置适配器(只写凭据,不注册 pi-ai 路由)。 */
|
|
1028
|
+
builtin?: boolean;
|
|
1029
|
+
}
|
|
1030
|
+
/** GET /llm-vendors 响应。 */
|
|
1031
|
+
export interface LlmVendorsResponse {
|
|
1032
|
+
vendors: LlmVendorOption[];
|
|
1033
|
+
}
|
|
1034
|
+
/** /llm-models 里的一条模型。 */
|
|
1035
|
+
export interface LlmModelOption {
|
|
1036
|
+
id: string;
|
|
1037
|
+
name: string;
|
|
1038
|
+
}
|
|
1039
|
+
/** GET /llm-models?provider=x 响应。 */
|
|
1040
|
+
export interface LlmModelsResponse {
|
|
1041
|
+
models: LlmModelOption[];
|
|
1042
|
+
}
|
|
1043
|
+
/** GET /llm-providers 响应:当前已注册的提供方路由。 */
|
|
1044
|
+
export interface LlmProvidersResponse {
|
|
1045
|
+
providers: {
|
|
1046
|
+
id: string;
|
|
1047
|
+
name: string;
|
|
1048
|
+
}[];
|
|
1049
|
+
}
|
|
1050
|
+
/** POST /llm-remove 请求:移除一个提供方(unset key + 移除 llm-pi-ai 路由)。 */
|
|
1051
|
+
export interface RemoveProviderRequest {
|
|
1052
|
+
provider: string;
|
|
1053
|
+
/** 该提供方对应的 DSH 凭据引用名(用于 unset)。 */
|
|
1054
|
+
apiKeyEnv?: string;
|
|
1055
|
+
}
|
|
1056
|
+
/** POST /llm-remove 响应。 */
|
|
1057
|
+
export interface RemoveProviderResponse {
|
|
1058
|
+
ok: boolean;
|
|
1059
|
+
message?: string;
|
|
1060
|
+
}
|
|
1061
|
+
/** POST /llm-add 请求:添加一个模型(厂商直填 key,或自定义路由)。 */
|
|
1062
|
+
export interface AddModelRequest {
|
|
1063
|
+
mode: 'vendor' | 'custom';
|
|
1064
|
+
/** 厂商模式用:provider 路由 id(来自 /llm-vendors)。 */
|
|
1065
|
+
vendor?: string;
|
|
1066
|
+
/** 厂商已知的 DSH 凭据引用名(可选;为空时 host 生成)。 */
|
|
1067
|
+
apiKeyEnv?: string;
|
|
1068
|
+
/** 自定义模式用:provider 路由 id。 */
|
|
1069
|
+
provider?: string;
|
|
1070
|
+
/** 模型 id。 */
|
|
1071
|
+
model: string;
|
|
1072
|
+
/** API Key。 */
|
|
1073
|
+
apiKey: string;
|
|
1074
|
+
/** 展示名(可选)。 */
|
|
1075
|
+
name?: string;
|
|
1076
|
+
/** 自定义模式用:OpenAI 兼容 base URL。 */
|
|
1077
|
+
baseURL?: string;
|
|
1078
|
+
}
|
|
1079
|
+
/** POST /llm-add 响应。 */
|
|
1080
|
+
export interface AddModelResponse {
|
|
1081
|
+
ok: boolean;
|
|
1082
|
+
saved: SavedModel;
|
|
1083
|
+
provider: string;
|
|
1084
|
+
message?: string;
|
|
1085
|
+
}
|
|
1086
|
+
/** 手动添加的模型库条目(只存插件内,不改 DSH 全局)。 */
|
|
264
1087
|
export interface NovelConfig {
|
|
265
1088
|
/** Absolute path of the default docx outline to load. */
|
|
266
1089
|
outlinePath: string;
|
|
@@ -270,6 +1093,16 @@ export interface NovelConfig {
|
|
|
270
1093
|
provider: string;
|
|
271
1094
|
/** LLM model id (e.g. deepseek-v4-flash). */
|
|
272
1095
|
model: string;
|
|
1096
|
+
/** 生成正文用模型(缺省用 model)。 */
|
|
1097
|
+
generateModel?: string;
|
|
1098
|
+
/** 审稿用模型(缺省用 model;建议用更强的 reasoner/pro)。 */
|
|
1099
|
+
reviewModel?: string;
|
|
1100
|
+
/** 全书质检(审计)用模型(缺省用 model)。 */
|
|
1101
|
+
auditModel?: string;
|
|
1102
|
+
/** LLM reasoning effort: off = no thinking; low/high/max = thinking intensity. */
|
|
1103
|
+
reasoningEffort: 'off' | 'low' | 'high' | 'max';
|
|
1104
|
+
/** 分析类任务(提炼/拆书/反推大纲等)的推理档位;默认 low,不受上面写作档位影响。 */
|
|
1105
|
+
analysisReasoning: 'off' | 'low' | 'high' | 'max';
|
|
273
1106
|
/** Target characters per chapter. */
|
|
274
1107
|
chapterChars: number;
|
|
275
1108
|
/** Max output tokens per chapter call. */
|
|
@@ -278,6 +1111,54 @@ export interface NovelConfig {
|
|
|
278
1111
|
reviewPassScore: number;
|
|
279
1112
|
/** Whether generation auto-runs review after writing. */
|
|
280
1113
|
autoReview: boolean;
|
|
1114
|
+
/** Whether generation auto-runs the author review (hook/continuity/trend) after writing. */
|
|
1115
|
+
autoAuthorReview: boolean;
|
|
1116
|
+
/** 修订/润色产出草稿后是否自动附带一次 AI 审查(工作区显示新稿评分与剩余问题)。 */
|
|
1117
|
+
autoReviewAfterRevise: boolean;
|
|
1118
|
+
/** 自定义背景图(URL 或 dataURL 或服务端路径引用;空 = 使用主题默认背景)。 */
|
|
1119
|
+
themeBackground?: string;
|
|
1120
|
+
/** 自定义背景遮罩/模糊强度 0-80(0 = 不遮罩)。 */
|
|
1121
|
+
themeBackgroundBlur?: number;
|
|
1122
|
+
/** 玻璃透明度 0-100(100=当前原样,越小越透,新拟态/黏土可见背景图)。 */
|
|
1123
|
+
themeOpacity?: number;
|
|
1124
|
+
/** 是否启用改编模式(默认关闭;发布后开启)。 */
|
|
1125
|
+
enableAdaptMode?: boolean;
|
|
1126
|
+
/** 手动添加的模型库(「我的模型」条目;只存插件内)。 */
|
|
1127
|
+
savedModels?: SavedModel[];
|
|
1128
|
+
}
|
|
1129
|
+
/** POST /move-output-dir request:dryRun=true 仅预览;确认时须带 to。 */
|
|
1130
|
+
export interface MoveOutputDirRequest {
|
|
1131
|
+
/** 新输出目录(绝对路径)。 */
|
|
1132
|
+
to?: string;
|
|
1133
|
+
/** 只列出当前目录内容,不搬移。 */
|
|
1134
|
+
dryRun?: boolean;
|
|
1135
|
+
}
|
|
1136
|
+
/** POST /move-output-dir response。 */
|
|
1137
|
+
export interface MoveOutputDirResponse {
|
|
1138
|
+
from: string;
|
|
1139
|
+
to?: string;
|
|
1140
|
+
/** 当前(或迁移后)目录内容清单。 */
|
|
1141
|
+
files: string[];
|
|
1142
|
+
bytes: number;
|
|
1143
|
+
/** 联动重指向的书架条目数。 */
|
|
1144
|
+
movedBooks: number;
|
|
1145
|
+
/** settings 默认输出目录是否同步更新。 */
|
|
1146
|
+
defaultUpdated: boolean;
|
|
1147
|
+
}
|
|
1148
|
+
/** POST /book-settings request:patch 省略 = 读取;字段传 null = 删除本书覆盖(回退全局)。 */
|
|
1149
|
+
export interface BookSettingsRequest {
|
|
1150
|
+
patch?: {
|
|
1151
|
+
[K in keyof BookSettings]?: BookSettings[K] | null;
|
|
1152
|
+
};
|
|
1153
|
+
}
|
|
1154
|
+
/** POST /book-settings response。 */
|
|
1155
|
+
export interface BookSettingsResponse {
|
|
1156
|
+
/** 本书已设置的参数(未设字段缺省 = 回退全局)。 */
|
|
1157
|
+
settings: BookSettings;
|
|
1158
|
+
/** 应用回退链后的生效配置(全局 + 本书覆盖)。 */
|
|
1159
|
+
effective: NovelConfig;
|
|
1160
|
+
/** 当前是否有打开的书。 */
|
|
1161
|
+
hasBook: boolean;
|
|
281
1162
|
}
|
|
282
1163
|
/** GET /status response. */
|
|
283
1164
|
export interface StatusResponse {
|
|
@@ -286,6 +1167,54 @@ export interface StatusResponse {
|
|
|
286
1167
|
project?: ProjectState;
|
|
287
1168
|
/** Chapter files already on disk (basenames, sorted). */
|
|
288
1169
|
generatedFiles: string[];
|
|
1170
|
+
/** 全书质检实时状态(用于面板/外部读取进度)。 */
|
|
1171
|
+
audit?: AuditStatus;
|
|
1172
|
+
}
|
|
1173
|
+
/** 生产单状态(生产单 = 区间批量生产执行器:计划补足 + 逐章生成 + 被拒分级处理)。 */
|
|
1174
|
+
export interface RunState {
|
|
1175
|
+
runId: string;
|
|
1176
|
+
/** 区间起点(含)。 */
|
|
1177
|
+
startNo: number;
|
|
1178
|
+
/** 区间终点(含)。 */
|
|
1179
|
+
endNo: number;
|
|
1180
|
+
status: 'running' | 'paused' | 'done' | 'stopped' | 'error';
|
|
1181
|
+
/** 当前处理到的章号(已 approved 的章会快进)。 */
|
|
1182
|
+
currentNo: number;
|
|
1183
|
+
stats: {
|
|
1184
|
+
/** 新生成(含审稿)的章数。 */
|
|
1185
|
+
generated: number;
|
|
1186
|
+
/** 被拒后按意见修订并通过的章数。 */
|
|
1187
|
+
revised: number;
|
|
1188
|
+
/** 被拒后豁免通过(无 high)的章数。 */
|
|
1189
|
+
exempted: number;
|
|
1190
|
+
/** error 后重新生成的章数。 */
|
|
1191
|
+
regenerated: number;
|
|
1192
|
+
/** 生成失败的章数。 */
|
|
1193
|
+
error: number;
|
|
1194
|
+
};
|
|
1195
|
+
/** 两轮修订仍不过、保留草稿待人工的章号。 */
|
|
1196
|
+
pendingManual: number[];
|
|
1197
|
+
/** 运行日志(保留最近 300 条)。 */
|
|
1198
|
+
log: Array<{
|
|
1199
|
+
at: string;
|
|
1200
|
+
text: string;
|
|
1201
|
+
}>;
|
|
1202
|
+
startedAt: string;
|
|
1203
|
+
updatedAt: string;
|
|
1204
|
+
error?: string;
|
|
1205
|
+
}
|
|
1206
|
+
/** POST /run/start request. */
|
|
1207
|
+
export interface RunStartRequest {
|
|
1208
|
+
/** 起始章号(默认 1)。 */
|
|
1209
|
+
startNo?: number;
|
|
1210
|
+
/** 结束章号(含;超出计划时自动补计划)。 */
|
|
1211
|
+
endNo?: number;
|
|
1212
|
+
/** 或指定新增章数(从当前最后一章 +1 起)。 */
|
|
1213
|
+
count?: number;
|
|
1214
|
+
}
|
|
1215
|
+
/** POST /run/control request. */
|
|
1216
|
+
export interface RunControlRequest {
|
|
1217
|
+
action: 'pause' | 'resume' | 'stop';
|
|
289
1218
|
}
|
|
290
1219
|
/** POST /load-outline request: either a docx path or raw text. */
|
|
291
1220
|
export interface LoadOutlineRequest {
|
|
@@ -354,10 +1283,18 @@ export type JobFrame = {
|
|
|
354
1283
|
file: string;
|
|
355
1284
|
chars: number;
|
|
356
1285
|
title: string;
|
|
1286
|
+
warn?: string;
|
|
357
1287
|
} | {
|
|
358
1288
|
type: 'review';
|
|
359
1289
|
no: number;
|
|
360
1290
|
report: ReviewReport;
|
|
1291
|
+
} | {
|
|
1292
|
+
type: 'author-review';
|
|
1293
|
+
no: number;
|
|
1294
|
+
review: AuthorReview;
|
|
1295
|
+
} | {
|
|
1296
|
+
type: 'author-backfill-done';
|
|
1297
|
+
count: number;
|
|
361
1298
|
} | {
|
|
362
1299
|
type: 'rewritten';
|
|
363
1300
|
no: number;
|
|
@@ -370,6 +1307,15 @@ export type JobFrame = {
|
|
|
370
1307
|
no: number;
|
|
371
1308
|
chars: number;
|
|
372
1309
|
draft: string;
|
|
1310
|
+
} | {
|
|
1311
|
+
type: 'outline-progress';
|
|
1312
|
+
done: number;
|
|
1313
|
+
total: number;
|
|
1314
|
+
phase: string;
|
|
1315
|
+
} | {
|
|
1316
|
+
type: 'outline-done';
|
|
1317
|
+
outline: string;
|
|
1318
|
+
chars: number;
|
|
373
1319
|
} | {
|
|
374
1320
|
type: 'error';
|
|
375
1321
|
no: number;
|
|
@@ -397,6 +1343,8 @@ export interface PolishRequest {
|
|
|
397
1343
|
/** POST /draft/apply | /draft/discard request: 采纳或放弃待确认草稿。 */
|
|
398
1344
|
export interface DraftDecisionRequest {
|
|
399
1345
|
chapterNo: number;
|
|
1346
|
+
/** apply 时可携带审查报告(沿用结论定状态;不携带则置 written)。 */
|
|
1347
|
+
report?: ReviewReport;
|
|
400
1348
|
}
|
|
401
1349
|
/** POST /summary request: (re)generate a chapter summary. */
|
|
402
1350
|
export interface SummaryRequest {
|
|
@@ -438,10 +1386,26 @@ export interface ConfigPatch {
|
|
|
438
1386
|
outputDir?: string;
|
|
439
1387
|
provider?: string;
|
|
440
1388
|
model?: string;
|
|
1389
|
+
generateModel?: string;
|
|
1390
|
+
reviewModel?: string;
|
|
1391
|
+
auditModel?: string;
|
|
1392
|
+
reasoningEffort?: 'off' | 'low' | 'high' | 'max';
|
|
1393
|
+
analysisReasoning?: 'off' | 'low' | 'high' | 'max';
|
|
441
1394
|
chapterChars?: number;
|
|
442
1395
|
maxTokens?: number;
|
|
443
1396
|
reviewPassScore?: number;
|
|
444
1397
|
autoReview?: boolean;
|
|
1398
|
+
autoAuthorReview?: boolean;
|
|
1399
|
+
autoReviewAfterRevise?: boolean;
|
|
1400
|
+
/** 自定义背景图(URL / dataURL / 服务端路径引用)。 */
|
|
1401
|
+
themeBackground?: string;
|
|
1402
|
+
/** 自定义背景遮罩/模糊强度 0-80。 */
|
|
1403
|
+
themeBackgroundBlur?: number;
|
|
1404
|
+
/** 玻璃透明度 0-100(100=当前原样)。 */
|
|
1405
|
+
themeOpacity?: number;
|
|
1406
|
+
enableAdaptMode?: boolean;
|
|
1407
|
+
/** 手动添加的模型库(完整替换保存)。 */
|
|
1408
|
+
savedModels?: SavedModel[];
|
|
445
1409
|
}
|
|
446
1410
|
/** One assistant conversation message (persisted per project). */
|
|
447
1411
|
export interface AssistantMessage {
|
|
@@ -472,6 +1436,12 @@ export type AssistantFrame = {
|
|
|
472
1436
|
type: 'toolDelta';
|
|
473
1437
|
name: string;
|
|
474
1438
|
text: string;
|
|
1439
|
+
}
|
|
1440
|
+
/** 工具完整结果(供前端渲染成结构化卡片,如拆书/导演)。 */
|
|
1441
|
+
| {
|
|
1442
|
+
type: 'toolResult';
|
|
1443
|
+
name: string;
|
|
1444
|
+
text: string;
|
|
475
1445
|
} | {
|
|
476
1446
|
type: 'done';
|
|
477
1447
|
} | {
|
|
@@ -484,15 +1454,21 @@ export interface AssistantHistoryResponse {
|
|
|
484
1454
|
}
|
|
485
1455
|
/** 题材基底库:一本书属于哪个阅读市场。树形(题材→子题材→下级)。 */
|
|
486
1456
|
export interface GenreNode {
|
|
1457
|
+
/** 稳定标识(内置库交叉引用)。 */
|
|
1458
|
+
id?: string;
|
|
487
1459
|
/** 题材名称(标签,如「仙侠修真」「都市异能」)。 */
|
|
488
1460
|
name: string;
|
|
489
1461
|
/** 题材特征、常见爽点、叙事重心或读者期待。 */
|
|
490
1462
|
description: string;
|
|
1463
|
+
/** 该题材的写法指引(开书定盘/卷计划用,区别于「读者期待」)。 */
|
|
1464
|
+
template?: string;
|
|
491
1465
|
/** 子题材。 */
|
|
492
1466
|
children: GenreNode[];
|
|
493
1467
|
}
|
|
494
1468
|
/** 推进模式库:读者为什么继续看下一章。 */
|
|
495
1469
|
export interface ProgressionMode {
|
|
1470
|
+
/** 稳定标识(与内置库交叉引用)。 */
|
|
1471
|
+
key?: string;
|
|
496
1472
|
/** 模式名称(如「升级变强」「经营扩张」「解谜揭露」)。 */
|
|
497
1473
|
name: string;
|
|
498
1474
|
/** 核心驱动力:靠什么制造追读动力。 */
|
|
@@ -505,11 +1481,33 @@ export interface ProgressionMode {
|
|
|
505
1481
|
risks: string[];
|
|
506
1482
|
/** 主模式或辅助模式。 */
|
|
507
1483
|
primary: boolean;
|
|
1484
|
+
/** 该模式的写法指引(开书定盘/卷计划用)。 */
|
|
1485
|
+
template?: string;
|
|
1486
|
+
/** 推进单位序列(每章如何推进,如「立威→打破质疑→扩大影响→碾压」)。 */
|
|
1487
|
+
progressionUnits?: string[];
|
|
1488
|
+
/** 允许出现的冲突形态。 */
|
|
1489
|
+
allowedConflictForms?: string[];
|
|
1490
|
+
/** 应避免的冲突形态(跑偏信号)。 */
|
|
1491
|
+
forbiddenConflictForms?: string[];
|
|
1492
|
+
/** 冲突烈度上限(low/medium/high),用于卷/章计划和审稿对齐。 */
|
|
1493
|
+
conflictCeiling?: 'low' | 'medium' | 'high';
|
|
1494
|
+
/** 单章推进单位说明。 */
|
|
1495
|
+
chapterUnit?: string;
|
|
1496
|
+
/** 卷末应兑现的回报。 */
|
|
1497
|
+
volumeReward?: string;
|
|
1498
|
+
/** 主驱动必须持续出现的信号(读者期待确认)。 */
|
|
1499
|
+
mandatorySignals?: string[];
|
|
1500
|
+
/** 反信号:出现即跑偏。 */
|
|
1501
|
+
antiSignals?: string[];
|
|
1502
|
+
/** 优先用的问题解决方式。 */
|
|
1503
|
+
resolutionStyle?: string;
|
|
508
1504
|
}
|
|
509
1505
|
/** 反 AI 规则:一条「要避免的问题 + 修正方向」。 */
|
|
510
1506
|
export interface AntiAiRule {
|
|
511
1507
|
/** 规则名(如「禁止解释型心理描写」「AI 高频套话」)。 */
|
|
512
1508
|
name: string;
|
|
1509
|
+
/** 稳定标识(与 defaultAntiAiRuleKeys 交叉引用;缺省用 name)。 */
|
|
1510
|
+
key?: string;
|
|
513
1511
|
/** 要避免的表达问题,具体可检查。 */
|
|
514
1512
|
avoid: string;
|
|
515
1513
|
/** 推荐修正方向。 */
|
|
@@ -518,8 +1516,55 @@ export interface AntiAiRule {
|
|
|
518
1516
|
detectPatterns?: string[];
|
|
519
1517
|
/** 是否内置全局规则(内置规则随插件发布,项目规则为用户自定义)。 */
|
|
520
1518
|
builtin?: boolean;
|
|
1519
|
+
/** 规则类别:forbidden=禁止类(命中即问题)/ risk=风险类(需注意但不硬伤)/ encourage=鼓励类(不命中不算错,只作建议)。 */
|
|
1520
|
+
severity?: 'forbidden' | 'risk' | 'encourage';
|
|
1521
|
+
/** 问题严重度(用于审稿优先级;缺省按类别推断)。 */
|
|
1522
|
+
riskLevel?: 'low' | 'medium' | 'high';
|
|
1523
|
+
/** 生成时直接注入的约束指令(缺失时回退到 avoid)。 */
|
|
1524
|
+
promptInstruction?: string;
|
|
1525
|
+
/** 是否允许自动改写(risk 类通常 false)。 */
|
|
1526
|
+
autoRewrite?: boolean;
|
|
1527
|
+
/** 是否为全局基线规则(新书默认启用,防止规则丢失后降级)。 */
|
|
1528
|
+
globalBaselineEnabled?: boolean;
|
|
1529
|
+
/** 是否启用(缺省 true)。 */
|
|
1530
|
+
enabled?: boolean;
|
|
1531
|
+
/** 作用域(缺省 all)。 */
|
|
1532
|
+
scope?: Array<'writing' | 'review' | 'polish' | 'all'>;
|
|
521
1533
|
}
|
|
522
1534
|
/** 预置写法模板(来自 AI-Novel-Writing-Assistant 内置数据,一键绑定无需样本文本)。 */
|
|
1535
|
+
export interface StyleTemplateNarrativeRules {
|
|
1536
|
+
progressionMode?: string;
|
|
1537
|
+
sceneUnitPattern?: string[];
|
|
1538
|
+
multiPov?: boolean;
|
|
1539
|
+
looping?: boolean;
|
|
1540
|
+
endingStyle?: string;
|
|
1541
|
+
povSwitchStyle?: string;
|
|
1542
|
+
summary?: string;
|
|
1543
|
+
}
|
|
1544
|
+
export interface StyleTemplateCharacterRules {
|
|
1545
|
+
allowSelfReflection?: boolean;
|
|
1546
|
+
emotionExpression?: string;
|
|
1547
|
+
defenseMechanisms?: string[];
|
|
1548
|
+
facePriority?: boolean;
|
|
1549
|
+
dialogueStyle?: string;
|
|
1550
|
+
summary?: string;
|
|
1551
|
+
}
|
|
1552
|
+
export interface StyleTemplateLanguageRules {
|
|
1553
|
+
register?: string;
|
|
1554
|
+
roughness?: number;
|
|
1555
|
+
allowIncompleteSentences?: boolean;
|
|
1556
|
+
allowSwearing?: boolean;
|
|
1557
|
+
sentenceVariation?: string;
|
|
1558
|
+
allowUselessDetails?: boolean;
|
|
1559
|
+
summary?: string;
|
|
1560
|
+
}
|
|
1561
|
+
export interface StyleTemplateRhythmRules {
|
|
1562
|
+
pace?: string;
|
|
1563
|
+
paragraphDensity?: string;
|
|
1564
|
+
allowFragmentedFlow?: boolean;
|
|
1565
|
+
actionOverExplanation?: boolean;
|
|
1566
|
+
summary?: string;
|
|
1567
|
+
}
|
|
523
1568
|
export interface StyleTemplate {
|
|
524
1569
|
/** 模板 key(如 power-up-escalation)。 */
|
|
525
1570
|
key: string;
|
|
@@ -531,17 +1576,63 @@ export interface StyleTemplate {
|
|
|
531
1576
|
category: string;
|
|
532
1577
|
/** 适用题材。 */
|
|
533
1578
|
applicableGenres: string[];
|
|
534
|
-
/**
|
|
1579
|
+
/** 标签(便于筛选)。 */
|
|
1580
|
+
tags?: string[];
|
|
1581
|
+
/** 一句话分析(模板定位说明)。 */
|
|
1582
|
+
analysisMarkdown?: string;
|
|
1583
|
+
/** 叙述规则(结构化)。 */
|
|
1584
|
+
narrative?: StyleTemplateNarrativeRules;
|
|
1585
|
+
/** 角色规则(结构化)。 */
|
|
1586
|
+
character?: StyleTemplateCharacterRules;
|
|
1587
|
+
/** 语言规则(结构化)。 */
|
|
1588
|
+
language?: StyleTemplateLanguageRules;
|
|
1589
|
+
/** 节奏规则(结构化)。 */
|
|
1590
|
+
rhythm?: StyleTemplateRhythmRules;
|
|
1591
|
+
/** 叙述规则(扁平,兼容旧数据)。 */
|
|
535
1592
|
proseRules: string[];
|
|
536
|
-
/**
|
|
1593
|
+
/** 角色/台词规则(扁平,兼容旧数据)。 */
|
|
537
1594
|
dialogueRules: string[];
|
|
538
|
-
/**
|
|
1595
|
+
/** 语言规则(扁平,兼容旧数据)。 */
|
|
539
1596
|
languageRules: string[];
|
|
540
|
-
/**
|
|
1597
|
+
/** 节奏规则(扁平,兼容旧数据)。 */
|
|
541
1598
|
rhythmRules: string[];
|
|
542
1599
|
/** 该模板默认绑定的反 AI 规则 key(内置规则名)。 */
|
|
543
1600
|
defaultAntiAiRuleKeys: string[];
|
|
544
1601
|
}
|
|
1602
|
+
/** 起始风格画像:无样本文本也能快速绑定一套写法(对齐上游 DEFAULT_STARTER_STYLE_PROFILES)。 */
|
|
1603
|
+
export interface StarterStyleProfile {
|
|
1604
|
+
/** stable key(如 starter-power-up)。 */
|
|
1605
|
+
key: string;
|
|
1606
|
+
/** 绑定到的写法模板 key。 */
|
|
1607
|
+
templateKey: string;
|
|
1608
|
+
/** 画像名。 */
|
|
1609
|
+
name: string;
|
|
1610
|
+
/** 画像说明。 */
|
|
1611
|
+
description: string;
|
|
1612
|
+
}
|
|
1613
|
+
/** 剧情桥段库:可复用的情节套路/桥段(作者阅读经验沉淀,与书内 Plotline 不同层)。 */
|
|
1614
|
+
export interface PlotBeatTemplate {
|
|
1615
|
+
/** 模板 key(如 face-slap / exit-wedding)。 */
|
|
1616
|
+
key: string;
|
|
1617
|
+
/** 桥段名(如「打脸」「退婚」)。 */
|
|
1618
|
+
name: string;
|
|
1619
|
+
/** 分类(如「装逼打脸」「身份逆袭」)。 */
|
|
1620
|
+
category: string;
|
|
1621
|
+
/** 一句话说明。 */
|
|
1622
|
+
summary: string;
|
|
1623
|
+
/** 适用位置(开局/前期/中期/后期/高潮/结尾)。 */
|
|
1624
|
+
position: string;
|
|
1625
|
+
/** 前置条件。 */
|
|
1626
|
+
preconditions: string[];
|
|
1627
|
+
/** 爽点来源。 */
|
|
1628
|
+
payoffSource: string[];
|
|
1629
|
+
/** 常用组合(可搭配的桥段)。 */
|
|
1630
|
+
combos: string[];
|
|
1631
|
+
/** 禁忌(别用烂/别用死)。 */
|
|
1632
|
+
taboos: string[];
|
|
1633
|
+
/** 适用题材。 */
|
|
1634
|
+
applicableGenres: string[];
|
|
1635
|
+
}
|
|
545
1636
|
/** 写法引擎:从样本文本提取的叙事风格资产。 */
|
|
546
1637
|
export interface StyleAsset {
|
|
547
1638
|
/** 资产名(如「林越式痞坏」「冷峻猎手风」)。 */
|
|
@@ -556,6 +1647,31 @@ export interface StyleAsset {
|
|
|
556
1647
|
boundaries: string[];
|
|
557
1648
|
/** 来源样本文本(可空)。 */
|
|
558
1649
|
sourceText?: string;
|
|
1650
|
+
/** 仿写预设:imitate=高保真仿写 / balanced=平衡 / transfer=迁移(去指纹)。 */
|
|
1651
|
+
preset?: 'imitate' | 'balanced' | 'transfer';
|
|
1652
|
+
/** 指纹风险:仿写时照搬原作独特表达的风险。 */
|
|
1653
|
+
fingerprintRisk?: 'low' | 'medium' | 'high';
|
|
1654
|
+
/** 净化后的写作指引(可安全用于生成,去掉了会暴露来源的具体细节)。 */
|
|
1655
|
+
writingGuidance?: string[];
|
|
1656
|
+
/** 禁止照搬的原作特有实体(人名/地名/核心设定句式),生成时需避开。 */
|
|
1657
|
+
forbiddenEntities?: string[];
|
|
1658
|
+
/** 创建时间。 */
|
|
1659
|
+
createdAt: string;
|
|
1660
|
+
}
|
|
1661
|
+
/** 写作公式(从样本文本分层提取的"这套文怎么写"浓缩,供生成/改写复用)。 */
|
|
1662
|
+
export interface StyleFormula {
|
|
1663
|
+
/** 稳定 key。 */
|
|
1664
|
+
key: string;
|
|
1665
|
+
/** 公式名。 */
|
|
1666
|
+
name: string;
|
|
1667
|
+
/** 提取深度:basic=骨架 / standard=完整 / deep=逐句细化。 */
|
|
1668
|
+
depth: 'basic' | 'standard' | 'deep';
|
|
1669
|
+
/** 重点聚焦域(如 开场/对话/节奏/爽点密度)。 */
|
|
1670
|
+
focusAreas: string[];
|
|
1671
|
+
/** 公式正文(Markdown)。 */
|
|
1672
|
+
formula: string;
|
|
1673
|
+
/** 应用指引(生成/改写时如何套用)。 */
|
|
1674
|
+
applyGuidance: string;
|
|
559
1675
|
/** 创建时间。 */
|
|
560
1676
|
createdAt: string;
|
|
561
1677
|
}
|
|
@@ -571,6 +1687,8 @@ export interface ProjectAssets {
|
|
|
571
1687
|
antiAiRules: AntiAiRule[];
|
|
572
1688
|
/** 绑定的写法资产。 */
|
|
573
1689
|
styleAssets: StyleAsset[];
|
|
1690
|
+
/** 写作公式(分层提取:basic/standard/deep)。 */
|
|
1691
|
+
styleFormulas?: StyleFormula[];
|
|
574
1692
|
/** 资产更新时间。 */
|
|
575
1693
|
updatedAt?: string;
|
|
576
1694
|
}
|
|
@@ -585,6 +1703,10 @@ export interface AssetsResponse {
|
|
|
585
1703
|
styleTemplates: StyleTemplate[];
|
|
586
1704
|
/** 内置推进模式候选。 */
|
|
587
1705
|
progressionLibrary: ProgressionMode[];
|
|
1706
|
+
/** 起始风格画像(无样本文本快速绑定写法)。 */
|
|
1707
|
+
starterStyleProfiles: StarterStyleProfile[];
|
|
1708
|
+
/** 内置剧情桥段库(可复用套路)。 */
|
|
1709
|
+
plotBeatLibrary: PlotBeatTemplate[];
|
|
588
1710
|
}
|
|
589
1711
|
/** POST /assets request:更新项目写作资产(部分字段可选)。 */
|
|
590
1712
|
export interface AssetsPatch {
|
|
@@ -593,6 +1715,7 @@ export interface AssetsPatch {
|
|
|
593
1715
|
auxiliaryProgressions?: ProgressionMode[];
|
|
594
1716
|
antiAiRules?: AntiAiRule[];
|
|
595
1717
|
styleAssets?: StyleAsset[];
|
|
1718
|
+
styleFormulas?: StyleFormula[];
|
|
596
1719
|
}
|
|
597
1720
|
/** POST /style-engine request:从样本文本提取写法资产。 */
|
|
598
1721
|
export interface StyleEngineRequest {
|
|
@@ -601,3 +1724,291 @@ export interface StyleEngineRequest {
|
|
|
601
1724
|
/** 资产名(可选,默认「风格资产 N」)。 */
|
|
602
1725
|
name?: string;
|
|
603
1726
|
}
|
|
1727
|
+
/** 作者资产库中一条可跨书复用的资产(笔法/红线/套路/角色模板/世界观模板等)。 */
|
|
1728
|
+
export interface AuthorStyleAsset {
|
|
1729
|
+
/** 稳定 id(本地唯一)。 */
|
|
1730
|
+
id: string;
|
|
1731
|
+
/** 资产名(如「短句快节奏爽文风」「林越式痞坏角色」)。 */
|
|
1732
|
+
name: string;
|
|
1733
|
+
/** 资产类型。 */
|
|
1734
|
+
kind: 'style' | 'antiAi' | 'progression' | 'genre' | 'roleTemplate' | 'worldTemplate' | 'plotBeat' | 'custom';
|
|
1735
|
+
/** 一句话摘要。 */
|
|
1736
|
+
summary: string;
|
|
1737
|
+
/** 资产正文内容(按 kind 约定解读的文本/JSON 描述)。 */
|
|
1738
|
+
content: string;
|
|
1739
|
+
/** 结构化载荷(角色模板/世界观模板等可结构化字段;缺省为 null)。 */
|
|
1740
|
+
structured?: Record<string, unknown>;
|
|
1741
|
+
/** 来源书名(哪本书提炼/收藏而来)。 */
|
|
1742
|
+
sourceBooks: string[];
|
|
1743
|
+
/** 标签。 */
|
|
1744
|
+
tags: string[];
|
|
1745
|
+
/** 来源样本文本(可选)。 */
|
|
1746
|
+
sourceText?: string;
|
|
1747
|
+
/** 创建时间。 */
|
|
1748
|
+
createdAt: string;
|
|
1749
|
+
/** 更新时间。 */
|
|
1750
|
+
updatedAt: string;
|
|
1751
|
+
}
|
|
1752
|
+
/** 作者资产库(跨书总数据):按作者维度聚合的可复用资产。 */
|
|
1753
|
+
export interface AuthorAssetLibrary {
|
|
1754
|
+
/** 货架版本,便于未来迁移。 */
|
|
1755
|
+
version: 1;
|
|
1756
|
+
items: AuthorStyleAsset[];
|
|
1757
|
+
}
|
|
1758
|
+
/** GET /author-assets 响应。 */
|
|
1759
|
+
export interface AuthorAssetsResponse {
|
|
1760
|
+
assets: AuthorAssetLibrary;
|
|
1761
|
+
}
|
|
1762
|
+
/** POST /author-assets/upsert 请求:新增或按 id 更新一条资产。 */
|
|
1763
|
+
export interface AuthorAssetUpsertRequest {
|
|
1764
|
+
asset: AuthorStyleAsset;
|
|
1765
|
+
}
|
|
1766
|
+
/** POST /author-assets/remove 请求:删除一条资产。 */
|
|
1767
|
+
export interface AuthorAssetRemoveRequest {
|
|
1768
|
+
id: string;
|
|
1769
|
+
}
|
|
1770
|
+
/** 改编可改范围的单个维度(矩阵的一行)。 */
|
|
1771
|
+
export interface AdaptationDimension {
|
|
1772
|
+
/** 维度 key(如 realm/name/goldenFinger…)。 */
|
|
1773
|
+
key: string;
|
|
1774
|
+
/** 维度名(如「大世界」「修为体系」「主角名」「金手指」)。 */
|
|
1775
|
+
title: string;
|
|
1776
|
+
/** 可改度:保留 / 可改影响大 / 可改影响小 / 可自由改 / 仅视觉包装。 */
|
|
1777
|
+
mutability: 'locked' | 'big' | 'small' | 'free' | 'visual';
|
|
1778
|
+
/** 原文当前值(从正文提炼,附证据)。 */
|
|
1779
|
+
current: string;
|
|
1780
|
+
/** 该值在正文中的出现证据(章节/频次,可空)。 */
|
|
1781
|
+
evidence?: string;
|
|
1782
|
+
/** 建议的候选新值(可空,每套含名称与一句话说明)。 */
|
|
1783
|
+
candidates?: Array<{
|
|
1784
|
+
name: string;
|
|
1785
|
+
desc?: string;
|
|
1786
|
+
}>;
|
|
1787
|
+
/** 联动影响说明(改了会影响哪些章节/角色/伏笔/术语)。 */
|
|
1788
|
+
impact: string;
|
|
1789
|
+
/** 风险评级。 */
|
|
1790
|
+
risk: 'high' | 'medium' | 'low';
|
|
1791
|
+
}
|
|
1792
|
+
/** POST /adapt/analyze 请求:上传全文做改编分析。 */
|
|
1793
|
+
export interface AdaptAnalyzeRequest {
|
|
1794
|
+
/** 全文文本(优先)。 */
|
|
1795
|
+
text: string;
|
|
1796
|
+
/** 或服务器端全文文件路径。 */
|
|
1797
|
+
filePath?: string;
|
|
1798
|
+
}
|
|
1799
|
+
/** POST /adapt/analyze 响应。 */
|
|
1800
|
+
export interface AdaptAnalyzeResponse {
|
|
1801
|
+
/** 识别书名(文件名推断或正文首行)。 */
|
|
1802
|
+
bookName: string;
|
|
1803
|
+
/** 拆出的章节数。 */
|
|
1804
|
+
chapters: number;
|
|
1805
|
+
/** 反推的初始大纲(可空)。 */
|
|
1806
|
+
outline?: string;
|
|
1807
|
+
/** 可改范围矩阵。 */
|
|
1808
|
+
dimensions: AdaptationDimension[];
|
|
1809
|
+
/** 分析消耗说明。 */
|
|
1810
|
+
note?: string;
|
|
1811
|
+
}
|
|
1812
|
+
/** 一条改编映射(原值 → 新值)。 */
|
|
1813
|
+
export interface AdaptationMapping {
|
|
1814
|
+
/** 原值(如「林尘」「练气」「青云宗」)。 */
|
|
1815
|
+
source: string;
|
|
1816
|
+
/** 新值(如「楚风」「凝元」「天渊阁」)。 */
|
|
1817
|
+
target: string;
|
|
1818
|
+
/** 适用范围。 */
|
|
1819
|
+
scope: 'name' | 'realm' | 'faction' | 'term' | 'other';
|
|
1820
|
+
/** 说明(可空)。 */
|
|
1821
|
+
note?: string;
|
|
1822
|
+
}
|
|
1823
|
+
/** 改编规则:哪些必须保留、哪些允许改、一致性约束。 */
|
|
1824
|
+
export interface AdaptationRules {
|
|
1825
|
+
/** 必须保留的要素(骨架/人物动机/伏笔逻辑/爽点结构…)。 */
|
|
1826
|
+
preserve: string[];
|
|
1827
|
+
/** 允许改变的要素。 */
|
|
1828
|
+
change: string[];
|
|
1829
|
+
/** 改编红线/一致性要求。 */
|
|
1830
|
+
constraints: string[];
|
|
1831
|
+
}
|
|
1832
|
+
/** 一组改编方案(映射表 + 规则 + 联动影响清单)。 */
|
|
1833
|
+
export interface AdaptationProposal {
|
|
1834
|
+
/** 映射表(原→新)。 */
|
|
1835
|
+
mappings: AdaptationMapping[];
|
|
1836
|
+
/** 改编规则。 */
|
|
1837
|
+
rules: AdaptationRules;
|
|
1838
|
+
/** 联动影响清单。 */
|
|
1839
|
+
impacts: Array<{
|
|
1840
|
+
item: string;
|
|
1841
|
+
detail: string;
|
|
1842
|
+
risk: 'high' | 'medium' | 'low';
|
|
1843
|
+
chapters?: number[];
|
|
1844
|
+
}>;
|
|
1845
|
+
}
|
|
1846
|
+
/** POST /adapt/propose 请求:由用户勾选的维度 + 新值生成改编方案。 */
|
|
1847
|
+
export interface AdaptProposeRequest {
|
|
1848
|
+
/** 原文全文(复用,便于 LLM 核对联动影响)。 */
|
|
1849
|
+
text: string;
|
|
1850
|
+
/** 用户确认要改的维度(含原值与新值)。 */
|
|
1851
|
+
selections: Array<{
|
|
1852
|
+
key: string;
|
|
1853
|
+
title: string;
|
|
1854
|
+
current: string;
|
|
1855
|
+
target: string;
|
|
1856
|
+
mutability: string;
|
|
1857
|
+
}>;
|
|
1858
|
+
/** 若已分析过,可携带完整矩阵作为上下文。 */
|
|
1859
|
+
dimensions?: AdaptationDimension[];
|
|
1860
|
+
}
|
|
1861
|
+
/** POST /adapt/propose 响应。 */
|
|
1862
|
+
export interface AdaptProposeResponse {
|
|
1863
|
+
proposal: AdaptationProposal;
|
|
1864
|
+
}
|
|
1865
|
+
/** POST /adapt/execute 请求:执行改编(replace=术语替换;rewrite=逐章 LLM 重写)。 */
|
|
1866
|
+
export interface AdaptExecuteRequest {
|
|
1867
|
+
/** 原文全文。 */
|
|
1868
|
+
text: string;
|
|
1869
|
+
/** 改编映射表。 */
|
|
1870
|
+
mappings: AdaptationMapping[];
|
|
1871
|
+
/** 改编规则(rewrite 模式生效:保留/允许变/红线)。 */
|
|
1872
|
+
rules?: AdaptationRules;
|
|
1873
|
+
/** 执行模式:replace(术语替换)或 rewrite(逐章重写)。 */
|
|
1874
|
+
mode?: 'replace' | 'rewrite';
|
|
1875
|
+
/** rewrite 模式:只重写前 N 章(0/缺省 = 全部,且在 startNo/endNo 窗口内)。 */
|
|
1876
|
+
maxChapters?: number;
|
|
1877
|
+
/** rewrite 模式:起始章号(含,默认 1)。 */
|
|
1878
|
+
startNo?: number;
|
|
1879
|
+
/** rewrite 模式:结束章号(含;0/缺省 = 到全书末尾)。 */
|
|
1880
|
+
endNo?: number;
|
|
1881
|
+
}
|
|
1882
|
+
/** POST /adapt/execute 响应。 */
|
|
1883
|
+
export interface AdaptExecuteResponse {
|
|
1884
|
+
/** 改编后的全文。 */
|
|
1885
|
+
adaptedText: string;
|
|
1886
|
+
/** 执行的映射数。 */
|
|
1887
|
+
mappings: number;
|
|
1888
|
+
/** 命中统计:每条映射的替换次数。 */
|
|
1889
|
+
hits: Array<{
|
|
1890
|
+
source: string;
|
|
1891
|
+
target: string;
|
|
1892
|
+
count: number;
|
|
1893
|
+
}>;
|
|
1894
|
+
/** 执行模式(replace / rewrite)。 */
|
|
1895
|
+
mode?: 'replace' | 'rewrite';
|
|
1896
|
+
/** rewrite 模式的逐章结果(no/title/chars)。 */
|
|
1897
|
+
rewritten?: Array<{
|
|
1898
|
+
no: number;
|
|
1899
|
+
title: string;
|
|
1900
|
+
chars: number;
|
|
1901
|
+
}>;
|
|
1902
|
+
/** rewrite 模式下重写失败、保留原章的章节号。 */
|
|
1903
|
+
skipped?: number[];
|
|
1904
|
+
}
|
|
1905
|
+
/** POST /adapt/rewrite-stream 的 NDJSON 帧(逐章进度 + 结束结果)。 */
|
|
1906
|
+
export type AdaptRewriteFrame = {
|
|
1907
|
+
type: 'progress';
|
|
1908
|
+
completed: number;
|
|
1909
|
+
total: number;
|
|
1910
|
+
no: number;
|
|
1911
|
+
title: string;
|
|
1912
|
+
} | {
|
|
1913
|
+
type: 'done';
|
|
1914
|
+
result: AdaptExecuteResponse;
|
|
1915
|
+
} | {
|
|
1916
|
+
type: 'error';
|
|
1917
|
+
message: string;
|
|
1918
|
+
};
|
|
1919
|
+
/** POST /adapt/save 请求:保存改编全文为新书(原书保留,登记书架)。 */
|
|
1920
|
+
export interface AdaptSaveRequest {
|
|
1921
|
+
/** 改编后的全文。 */
|
|
1922
|
+
text: string;
|
|
1923
|
+
/** 新书名(缺省为「改编新书」;建议用「<原著>·改编版」)。 */
|
|
1924
|
+
bookName?: string;
|
|
1925
|
+
/** 新书输出目录(缺省 ~/.dsh/novels/书名)。 */
|
|
1926
|
+
outputDir?: string;
|
|
1927
|
+
/** 可附带反推大纲(写进新项目,便于后续续写/编辑)。 */
|
|
1928
|
+
outline?: string;
|
|
1929
|
+
}
|
|
1930
|
+
/** POST /adapt/save 响应。 */
|
|
1931
|
+
export interface AdaptSaveResponse {
|
|
1932
|
+
/** 登记后的书架条目。 */
|
|
1933
|
+
book: BookEntry;
|
|
1934
|
+
/** 新书名。 */
|
|
1935
|
+
bookName: string;
|
|
1936
|
+
/** 成功拆出的章节数。 */
|
|
1937
|
+
chapters: number;
|
|
1938
|
+
/** 因内容过短被跳过的章节标题列表。 */
|
|
1939
|
+
skipped: string[];
|
|
1940
|
+
/** 新书输出目录。 */
|
|
1941
|
+
outputDir: string;
|
|
1942
|
+
}
|
|
1943
|
+
/** POST /adapt/materialize 请求:从源全文 + 用户编辑后的改编方案,提炼新书资料并保存为「待写新书」。 */
|
|
1944
|
+
export interface AdaptMaterializeRequest {
|
|
1945
|
+
/** 源书全文。 */
|
|
1946
|
+
text: string;
|
|
1947
|
+
/** 新书名(缺省为「<源书名>·改编版」)。 */
|
|
1948
|
+
bookName?: string;
|
|
1949
|
+
/** 新书输出目录(缺省 ~/.dsh/novels/书名)。 */
|
|
1950
|
+
outputDir?: string;
|
|
1951
|
+
/** 反推大纲(来自分析;缺少时用源文章题兜底)。 */
|
|
1952
|
+
outline?: string;
|
|
1953
|
+
/** 用户编辑后的改编方案(映射表 + 规则)。 */
|
|
1954
|
+
proposal: AdaptationProposal;
|
|
1955
|
+
/** 拟规划章节数(缺省 30,可在前端调整)。 */
|
|
1956
|
+
chapterCount?: number;
|
|
1957
|
+
}
|
|
1958
|
+
/** POST /adapt/materialize 响应:提炼后的新书资料(预览,尚未落盘;保存走 /adapt/materialize-save)。 */
|
|
1959
|
+
export interface AdaptMaterializeResponse {
|
|
1960
|
+
/** 书架条目(仅在已保存时存在;预览阶段为 undefined)。 */
|
|
1961
|
+
book?: BookEntry;
|
|
1962
|
+
/** 新书名。 */
|
|
1963
|
+
bookName: string;
|
|
1964
|
+
/** 改编后总纲。 */
|
|
1965
|
+
outline: string;
|
|
1966
|
+
/** 改编后道藏。 */
|
|
1967
|
+
bible: StoryBible;
|
|
1968
|
+
/** 改编后角色库。 */
|
|
1969
|
+
roles: RoleRecord[];
|
|
1970
|
+
/** 改编后大世界。 */
|
|
1971
|
+
world: WorldState;
|
|
1972
|
+
/** 改编后卷计划。 */
|
|
1973
|
+
volumes: Volume[];
|
|
1974
|
+
/** 改编后章节计划(status=pending)。 */
|
|
1975
|
+
chapters: ChapterPlan[];
|
|
1976
|
+
/** 新书输出目录。 */
|
|
1977
|
+
outputDir: string;
|
|
1978
|
+
}
|
|
1979
|
+
/** POST /adapt/materialize-save 请求:把预览/微调后的新书资料写入并登记书架。 */
|
|
1980
|
+
export interface AdaptMaterializeSaveRequest {
|
|
1981
|
+
/** 新书名(缺省为「改编版」)。 */
|
|
1982
|
+
bookName?: string;
|
|
1983
|
+
/** 新书输出目录(缺省 ~/.dsh/novels/书名)。 */
|
|
1984
|
+
outputDir?: string;
|
|
1985
|
+
/** 改编后总纲。 */
|
|
1986
|
+
outline: string;
|
|
1987
|
+
/** 改编后道藏。 */
|
|
1988
|
+
bible: StoryBible;
|
|
1989
|
+
/** 改编后角色库。 */
|
|
1990
|
+
roles: RoleRecord[];
|
|
1991
|
+
/** 改编后大世界。 */
|
|
1992
|
+
world: WorldState;
|
|
1993
|
+
/** 改编后卷计划。 */
|
|
1994
|
+
volumes: Volume[];
|
|
1995
|
+
/** 改编后章节计划(status=pending)。 */
|
|
1996
|
+
chapters: ChapterPlan[];
|
|
1997
|
+
}
|
|
1998
|
+
/** POST /adapt/materialize-save 响应。 */
|
|
1999
|
+
export interface AdaptMaterializeSaveResponse {
|
|
2000
|
+
/** 登记后的书架条目。 */
|
|
2001
|
+
book: BookEntry;
|
|
2002
|
+
/** 新书名。 */
|
|
2003
|
+
bookName: string;
|
|
2004
|
+
/** 成功写入的章节数。 */
|
|
2005
|
+
chapters: number;
|
|
2006
|
+
/** 新书输出目录。 */
|
|
2007
|
+
outputDir: string;
|
|
2008
|
+
}
|
|
2009
|
+
/** POST /plugin/update 响应:插件自更新结果。 */
|
|
2010
|
+
export interface PluginUpdateResponse {
|
|
2011
|
+
ok: boolean;
|
|
2012
|
+
/** 更新结果说明(成功/失败/环境提示)。 */
|
|
2013
|
+
message: string;
|
|
2014
|
+
}
|