dsh-novel-generator 0.1.21 → 0.1.25

package/README.md

@@ -64,6 +64,21 @@ dsh plugin --profile web add dsh-novel-generator
 - 生成、推演、快照都是异步任务：`POST /generate`、`POST /compose`、`POST /deduce`、`POST /snapshot/refresh` 返回 `jobId`，再由 `GET /job?id=` 轮询。
 - `timeline.cursor` 现在以「天」为单位；旧数据（按格计数）在首次读取时自动换算一次并标记 `cursorUnit: "day"`。
 
+## 前置提示词（作品级）
+
+作品列表每行的「前置」可以给一本书设定前置提示：内置「第一人称 / 第三人称限知 / 第三人称全知 / 自定义」四种，选中即填入文本框，文本可自由改写（最多 2000 字）。
+
+- 每次**生成正文、自动推演、AI 修改**时，这段文本都会以「【本书前置设定】…」的形式放在提示最前面；生成世界快照时不带（那是结构化数据任务）。
+- 保存后**下一次生成就生效**，不需要重建会话——它不依赖会话状态。
+- 内容同时写进作品的 `作品信息.md`（文末「前置提示词」一节），便于外部查看与备份。
+- 留空即表示不设置。
+
+## 章节故事页
+
+- 正文可以直接编辑、保存；工具条上还有「AI 修改」：填入修改意见后，模型按意见重写整章。
+- 正文为空时按钮不可点，接口也会拒绝（400）；修改意见为空同样拒绝。
+- **重写结果只放进编辑区、不自动保存**，状态变成「未保存」，你确认后再点「保存」——避免 AI 的改动直接覆盖原稿。
+
 ## 迁移、导入与会话
 
 - **改预设**：作品列表每行的「预设」改的是「下次建会话时用哪个预设」。会话在创建时就固定了预设，所以保存后会提示「重建会话后生效」——要立刻换，点同一行的「重建会话」。

package/client.js

@@ -189,7 +189,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
 .dsn-path{display:flex;gap:6px}
 .dsn-import{display:flex;align-items:center;gap:10px;margin:2px 0 12px}
 .dsn-list{display:flex;flex-direction:column;gap:8px}
-.dsn-row{display:flex;align-items:center;gap:12px;padding:12px 14px;border-radius:12px;
+.dsn-row{display:flex;flex-wrap:wrap;align-items:center;gap:12px;padding:12px 14px;border-radius:12px;
   border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);cursor:pointer}
 .dsn-row:hover{border-color:var(--dsw-alias-brand-primary)}
 .dsn-row-main{display:flex;flex-direction:column;gap:4px;min-width:0}
@@ -480,7 +480,84 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             }, busy ? t('保存中…', "Saving…") : t('保存', "Save")))));
     }
 
-    function ProjectsPage({ boot, resolveWorkspace, onOpen, onReload, onEditModel, onEditPreset }) {
+    /** Built-in preface prompts; the text is editable after picking one. */
+    const PRELUDE_MODES = [
+      { id: 'first', zh: '第一人称', en: 'First person', text: '全书使用第一人称叙述：只写「我」亲眼所见、亲耳所听、亲身所想，不描写别人的内心活动。' },
+      { id: 'thirdLimited', zh: '第三人称限知', en: 'Third person, limited', text: '全书使用第三人称限知视角：叙述跟随主角，只呈现他能感知到的一切，不越界写其他角色的内心。' },
+      { id: 'thirdOmniscient', zh: '第三人称全知', en: 'Third person, omniscient', text: '全书使用第三人称全知视角：叙述者可以进入任何角色的内心，但每次切换视角都要有场景依据，不要在同一场景里频繁跳视角。' },
+      { id: 'custom', zh: '自定义', en: 'Custom', text: '' },
+    ];
+
+    /**
+     * The work-wide preface prompt: a narrative angle preset plus anything else
+     * the author wants pinned in front of every request.
+     */
+    function PreludeDialog({ project, onCancel, onSaved }) {
+      const current = project.prelude || null;
+      const [mode, setMode] = useState(current && current.mode ? current.mode : '');
+      const [text, setText] = useState(current && current.text ? current.text : '');
+      const [busy, setBusy] = useState(false);
+      const [error, setError] = useState('');
+
+      const pickMode = useCallback((id) => {
+        setMode(id);
+        const preset = PRELUDE_MODES.find((entry) => entry.id === id);
+        if (preset && preset.text !== '') setText(preset.text);
+        if (id === '') setText('');
+      }, []);
+
+      const save = useCallback(async () => {
+        setBusy(true);
+        setError('');
+        try {
+          const result = await api('/project/prelude', { projectId: project.projectId, mode, text });
+          await onSaved(result.project);
+        } catch (saveError) {
+          setError(messageOf(saveError));
+        } finally {
+          setBusy(false);
+        }
+      }, [project.projectId, mode, text, onSaved]);
+
+      return h('div', { className: 'dsn-dialog-backdrop' },
+        h('div', { className: 'dsn-dialog', style: { width: 'min(620px, calc(100% - 48px))' } },
+          h('div', { className: 'dsn-dialog-head' },
+            h('div', { className: 'dsn-title' }, t('前置提示词', 'Preface prompt')),
+            h('div', { className: 'dsn-sub' }, project.title),
+            h('div', { className: 'dsn-spacer' })),
+          h('div', { className: 'dsn-dialog-body' },
+            h('label', { className: 'dsn-field span2' },
+              h('span', { className: 'dsn-label' }, t('叙事角度（选一个会填入下面的文本）', 'Narrative angle (fills the text below)')),
+              h('select', {
+                className: 'dsn-select',
+                value: mode,
+                onChange: (event) => pickMode(event.target.value),
+              },
+              h('option', { value: '' }, t('不设置', 'Not set')),
+              PRELUDE_MODES.map((entry) => h('option', { key: entry.id, value: entry.id }, t(entry.zh, entry.en))))),
+            h('label', { className: 'dsn-field span2' },
+              h('span', { className: 'dsn-label' }, t('前置提示（可自由修改，最多 2000 字）', 'Preface text (edit freely, up to 2000 characters)')),
+              h('textarea', {
+                className: 'dsn-textarea',
+                style: { minHeight: '160px' },
+                value: text,
+                placeholder: t('每次生成正文、自动推演、AI 修改时都会放在提示最前面。例如：全书用第三人称限知；文风冷峻，少用形容词；不要出现现代网络用语。', 'Added in front of every generation, deduction and revision request. e.g. third-person limited; cold, spare prose; no modern slang.'),
+                onChange: (event) => setText(event.target.value),
+              })),
+            h('div', { className: 'dsn-hint span2' }, t('已填 {n} / 2000 字；留空即表示这本书不带前置提示。', '{n} / 2000 characters; leave it empty to send no preface.', { n: String(text).length })),
+            error ? h('div', { className: 'dsn-hint warn span2' }, error) : null),
+          h('div', { className: 'dsn-dialog-foot' },
+            h('button', { className: 'dsn-btn ghost', type: 'button', disabled: busy, onClick: onCancel }, t('取消', 'Cancel')),
+            h('div', { className: 'dsn-spacer' }),
+            h('button', {
+              className: 'dsn-btn primary',
+              type: 'button',
+              disabled: busy || String(text).length > 2000,
+              onClick: save,
+            }, busy ? t('保存中…', 'Saving…') : t('保存', 'Save')))));
+    }
+
+    function ProjectsPage({ boot, resolveWorkspace, onOpen, onReload, onEditModel, onEditPreset, onEditPrelude }) {
       const [title, setTitle] = useState('');
       const [cwd, setCwd] = useState('');
       const [preset, setPreset] = useState('');
@@ -725,6 +802,15 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
                 onEditPreset(project);
               },
             }, t('预设', "Preset")),
+            h('button', {
+              className: 'dsn-btn ghost',
+              type: 'button',
+              title: t('设置这本书的前置提示词（叙事角度等，每次生成都会带上）', 'Set this work’s preface prompt (narrative angle and more; carried by every request)'),
+              onClick: (event) => {
+                event.stopPropagation();
+                onEditPrelude(project);
+              },
+            }, t('前置', 'Preface')),
             h('button', {
               className: 'dsn-btn ghost',
               type: 'button',
@@ -1128,7 +1214,46 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
      * out of the page — back, next chapter, the outline, another project, or
      * closing the studio — can ask about unsaved text first.
      */
-    function StoryPage({ detail, chapter, previous, next, text, saving, onEdit, onSave, onBack, onOutline, onOpenChapter, onNewChapter }) {
+    /**
+     * Ask the model to rewrite the chapter from a note. The result lands back in
+     * the editor as an unsaved draft, so nothing is overwritten unseen.
+     */
+    function ReviseDialog({ chapter, text, busy, error, onCancel, onConfirm }) {
+      const [instruction, setInstruction] = useState('');
+      const ready = instruction.trim() !== '' && String(text || '').trim() !== '';
+
+      return h('div', { className: 'dsn-dialog-backdrop' },
+        h('div', { className: 'dsn-dialog', style: { width: 'min(560px, calc(100% - 48px))' } },
+          h('div', { className: 'dsn-dialog-head' },
+            h('div', { className: 'dsn-title' }, t('AI 修改本章', 'Revise this chapter with AI')),
+            h('div', { className: 'dsn-sub' }, chapter ? t('第 {n} 章 · {title}', 'Chapter {n} · {title}', { n: chapter.index + 1, title: chapter.title || t('未命名', 'Untitled') }) : ''),
+            h('div', { className: 'dsn-spacer' })),
+          h('div', { className: 'dsn-dialog-body' },
+            h('label', { className: 'dsn-field span4' },
+              h('span', { className: 'dsn-label' }, t('修改意见（必填）', 'What to change (required)')),
+              h('textarea', {
+                className: 'dsn-textarea',
+                style: { minHeight: '140px' },
+                value: instruction,
+                placeholder: t('例如：把第三章那段打斗写得更克制，减少形容词；结尾补一句主角的心理活动。', 'e.g. Tone down the fight scene, use fewer adjectives, and end on the protagonist’s inner thought.'),
+                onChange: (event) => setInstruction(event.target.value),
+              })),
+            String(text || '').trim() === ''
+              ? h('div', { className: 'dsn-hint warn span4' }, t('这一章还没有正文，先写或先生成，再让 AI 修改。', 'This chapter has no text yet — write or generate it before revising.'))
+              : h('div', { className: 'dsn-hint span4' }, t('AI 会按意见重写整章，结果放进编辑区但不自动保存；你确认后再点「保存」。', 'The whole chapter is rewritten from your note. The result goes into the editor unsaved — review it, then press Save.')),
+            error ? h('div', { className: 'dsn-hint warn span4' }, error) : null),
+          h('div', { className: 'dsn-dialog-foot' },
+            h('button', { className: 'dsn-btn ghost', type: 'button', disabled: busy, onClick: onCancel }, t('取消', 'Cancel')),
+            h('div', { className: 'dsn-spacer' }),
+            h('button', {
+              className: 'dsn-btn primary',
+              type: 'button',
+              disabled: busy || !ready,
+              onClick: () => onConfirm(instruction.trim()),
+            }, busy ? t('修改中…', 'Revising…') : t('确认修改', 'Revise')))));
+    }
+
+    function StoryPage({ detail, chapter, previous, next, text, saving, onEdit, onSave, onBack, onOutline, onOpenChapter, onNewChapter, onRevise }) {
       const words = countWords(text);
       const window = chapter ? chapterWindow(detail, chapter) : null;
 
@@ -1170,6 +1295,15 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
               h('div', { className: 'dsn-muted' },
                 t('{words} 字{req}', '{words} words{req}', { words, req: chapter.outline ? t(' · 大纲要求 {min}–{max} 字', ' · outline asks for {min}–{max} words', { min: chapter.outline.minWords, max: chapter.outline.maxWords }) : '' })),
               h('div', { className: 'dsn-spacer' }),
+              h('button', {
+                className: 'dsn-btn',
+                type: 'button',
+                disabled: saving || String(text || '').trim() === '',
+                title: String(text || '').trim() === ''
+                  ? t('这一章还没有正文，先写或先生成', 'No text yet — write or generate the chapter first')
+                  : t('把本章正文和修改意见交给 AI 重写', 'Send the chapter and a note to the model for a rewrite'),
+                onClick: onRevise,
+              }, t('AI 修改', 'AI revise')),
               h('button', { className: 'dsn-btn primary', type: 'button', disabled: saving, onClick: onSave },
                 saving ? t('保存中…', "Saving…") : t('保存', "Save")))));
     }
@@ -1685,6 +1819,9 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
         return () => onBusyChange(null);
       }, [busy ? busy.label : null, busy ? busy.message : null, onBusyChange]);
       const [dialogOpen, setDialogOpen] = useState(false);
+      const [reviseOpen, setReviseOpen] = useState(false);
+      const [reviseError, setReviseError] = useState('');
+      const [reviseJob, setReviseJob] = useJob();
       const [text, setText] = useState('');
       const [dirty, setDirty] = useState(false);
       const [saving, setSaving] = useState(false);
@@ -1732,9 +1869,58 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
         }
       }, [chapter, detail.projectId, text, onReload, notify]);
 
+      /** Send the chapter and a note to the model; the reply becomes a draft. */
+      const startRevise = useCallback(async (instruction) => {
+        if (!chapter) return;
+        if (String(text || '').trim() === '') {
+          setReviseError(t('这一章还没有正文，先写或先生成再让 AI 修改', 'This chapter has no text yet — write or generate it before revising.'));
+          return;
+        }
+        if (String(instruction || '').trim() === '') {
+          setReviseError(t('请先写清修改意见', 'Write what should change first.'));
+          return;
+        }
+        setReviseError('');
+        try {
+          const started = await api('/chapter/revise', {
+            projectId: detail.projectId,
+            chapterId: chapter.chapterId,
+            instruction: String(instruction).trim(),
+            content: text,
+          });
+          setReviseJob(started);
+        } catch (error) {
+          setReviseError(messageOf(error));
+        }
+      }, [chapter, detail.projectId, text, setReviseJob]);
+
+      const revising = Boolean(reviseJob && reviseJob.state === 'running');
+      useEffect(() => {
+        if (!reviseJob) return undefined;
+        if (reviseJob.state === 'running') {
+          setChildBusy({
+            label: t('正在按修改意见重写本章…', 'Revising the chapter…'),
+            message: reviseJob.message || '',
+          });
+          return undefined;
+        }
+        setChildBusy(null);
+        if (reviseJob.state === 'done') {
+          const result = reviseJob.result || {};
+          if (typeof result.content === 'string' && result.content.trim() !== '') {
+            setText(result.content);
+            setDirty(true);
+          }
+          setReviseOpen(false);
+          notify(t('AI 已重写本章，确认后点「保存」', 'AI rewrote the chapter — review it, then press Save'), 'success');
+        } else if (reviseJob.state === 'error') {
+          setReviseError(reviseJob.error || t('AI 修改失败', 'Revision failed'));
+        }
+        return undefined;
+      }, [reviseJob ? reviseJob.jobId : null, reviseJob ? reviseJob.state : null, reviseJob ? reviseJob.message : null]);
+
       /** Run a navigation step, asking about the active page's unsaved edits. */
-      const leave = useCallback((action) => {
-        const unsaved = view === 'outline' ? outlineGuard.current.isDirty() : dirty;
+      const leave = useCallback((action) => {        const unsaved = view === 'outline' ? outlineGuard.current.isDirty() : dirty;
         if (!unsaved) {
           action();
           return;
@@ -1920,6 +2106,10 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
               onOutline: () => leave(() => setView('outline')),
               onOpenChapter: openStory,
               onNewChapter: () => leave(() => setDialogOpen(true)),
+              onRevise: () => {
+                setReviseError('');
+                setReviseOpen(true);
+              },
             })),
           h('section', { className: 'dsn-page' },
             h(OutlinePage, {
@@ -1949,6 +2139,19 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             },
           })
           : null,
+        reviseOpen
+          ? h(ReviseDialog, {
+            chapter,
+            text,
+            busy: revising,
+            error: reviseError,
+            onCancel: () => {
+              if (revising) return;
+              setReviseOpen(false);
+            },
+            onConfirm: startRevise,
+          })
+          : null,
         pendingLeave
           ? h(LeaveConfirm, {
             what: pendingLeave.page === 'outline' ? t('这份章节大纲', "This outline") : t('这一章的正文', "this chapter's text"),
@@ -2001,6 +2204,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
       const [busyNow, setBusyNow] = useState(null);
       const [modelTarget, setModelTarget] = useState(null);
       const [presetTarget, setPresetTarget] = useState(null);
+      const [preludeTarget, setPreludeTarget] = useState(null);
       const leaveGuard = useRef(null);
       const registerLeaveGuard = useCallback((guard) => {
         leaveGuard.current = guard;
@@ -2093,6 +2297,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
                   onReload: loadBoot,
                   onEditModel: setModelTarget,
                   onEditPreset: setPresetTarget,
+                  onEditPrelude: setPreludeTarget,
                 }))
               : detail === null
                 ? h('div', { className: 'dsn-empty', style: { margin: 'auto' } }, t('正在载入作品…', "Loading the work…"))
@@ -2126,9 +2331,28 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             onSaved: async () => {
               setPresetTarget(null);
               await loadBoot();
+              // The open work shows its preset in the top bar, so refresh it too.
+              if (projectId) await loadDetail(projectId);
               setToast({ text: t('预设已更新，重建会话后生效', 'Preset updated — it applies once the work’s session is rebuilt'), kind: 'success' });
             },
           })
+          : null,
+        preludeTarget
+          ? h(PreludeDialog, {
+            project: preludeTarget,
+            onCancel: () => setPreludeTarget(null),
+            onSaved: async (saved) => {
+              setPreludeTarget(null);
+              await loadBoot();
+              const empty = !saved || !saved.prelude || !saved.prelude.text;
+              setToast({
+                text: empty
+                  ? t('已清除前置提示词', 'Preface prompt cleared')
+                  : t('前置提示词已保存，下一次生成就生效', 'Preface prompt saved — it applies to the next generation'),
+                kind: 'success',
+              });
+            },
+          })
           : null);
     }
 

package/index.js

@@ -356,6 +356,8 @@ async function exportProjectInfo(project) {
     lines.push(`- 绑定会话：${project.sessionId || '（无）'}`);
     lines.push(`- 模型：${project.model ? `${project.model.provider} / ${project.model.model}` : '（默认）'}`);
     lines.push(`- 预设：${project.agentPreset || '（默认）'}`);
+    const preludeText = project.prelude && project.prelude.text ? String(project.prelude.text).trim() : '';
+    lines.push(`- 前置提示词：${preludeText === '' ? '（未设置）' : '已设置，见文末'}`);
     lines.push(`- 快照间隔：每 ${timeline.unitDays || 30} 天一份`);
     lines.push(`- 已写入快照：${snapshots.length ? snapshots.map((snapshot) => `第 ${snapshot.day} 天`).join('、') : '（暂无）'}`);
     lines.push(`- 故事当前：第 ${lastChapterEnd(project)} 天`);
@@ -382,6 +384,16 @@ async function exportProjectInfo(project) {
     lines.push('');
     lines.push('> 章节正文在同目录的「第NN章 标题.md」，各章梗概在「章节大纲」目录，世界快照在「世界快照」目录。');
     lines.push('');
+    if (preludeText !== '') {
+      lines.push('## 前置提示词');
+      lines.push('');
+      lines.push('每次生成正文、自动推演、AI 修改时都会放在提示最前面：');
+      lines.push('');
+      lines.push('```text');
+      lines.push(preludeText);
+      lines.push('```');
+      lines.push('');
+    }
     await writeFile(projectInfoFile(project), lines.join('\n'), 'utf8');
   } catch {
     // Best effort.
@@ -660,6 +672,9 @@ function summarize(project) {
     sessionId: project.sessionId,
     agentPreset: project.agentPreset,
     model: project.model,
+    // The work-wide preface prompt: narrative angle plus anything else the
+    // author wants every request to carry.
+    prelude: project.prelude || null,
     createdAt: project.createdAt,
     updatedAt: project.updatedAt,
     chapterCount: chapters.length,
@@ -1205,6 +1220,8 @@ function chapterPrompt(project, chapter, previous) {
   const { snapshot } = snapshotDistance(project, chapter);
   const lines = [];
   lines.push('你现在是这部小说的执笔作者。只输出本章正文，不要解释、不要标题、不要分点提纲。');
+  const prelude = preludeBlock(project);
+  if (prelude !== '') lines.push('', prelude);
   lines.push(`【篇幅】本章正文必须控制在 ${minWords}～${maxWords} 字之间，写够 ${maxWords} 字附近就收尾，超过 ${maxWords} 字视为不合格。`);
   lines.push('');
   const shownTitle = chapter.title && !/^第\s*\d+\s*章$/u.test(chapter.title) ? ` ${chapter.title}` : '';
@@ -1242,6 +1259,8 @@ function deducePrompt(project, chapter) {
   lines.push('你是这部小说的剧情推演器。请依据最近的世界快照，以及从该快照之后已经写过的各章梗概，推演下一章的大纲。');
   lines.push('只输出一个 JSON 对象，不要任何额外文字。');
   lines.push('');
+  const prelude = preludeBlock(project);
+  if (prelude !== '') lines.push(prelude);
   lines.push('【最近的世界快照】');
   lines.push(snapshotBlock(snapshot));
   lines.push('');
@@ -1255,6 +1274,36 @@ function deducePrompt(project, chapter) {
   return lines.join('\n');
 }
 
+/**
+ * Ask the model to rewrite one chapter's text according to a note.
+ *
+ * The current text is given in full (the Client sends the version on screen, so
+ * unsaved edits are included), and the reply is the whole revised chapter — not a
+ * patch and not commentary.
+ */
+function revisePrompt(project, chapter, currentText, instruction) {
+  const span = chapterWindow(project, chapter);
+  const lines = [];
+  lines.push('你是这部小说的修订者。下面是本章现有正文，以及作者给出的修改意见。');
+  lines.push('请按修改意见重写这一章，输出修订后的**完整正文**：不要解释、不要列出改动点、不要加标题行。');
+  lines.push('');
+  const prelude = preludeBlock(project);
+  if (prelude !== '') lines.push(prelude);
+  lines.push(`【本章】第 ${chapter.index + 1} 章 ${chapter.title || ''}（第 ${span.start}→${span.end} 天）`);
+  lines.push('');
+  lines.push('【现有正文】');
+  lines.push(currentText);
+  lines.push('');
+  lines.push('【修改意见】');
+  lines.push(instruction);
+  lines.push('');
+  lines.push('【要求】');
+  lines.push('- 只改需要按意见改的地方，保持原有的叙事人称、语气和已经成立的情节；没有被意见推翻的段落尽量保留。');
+  lines.push('- 输出必须是完整的一章，从开头到结尾，不能只给片段或省略号。');
+  lines.push('- 不要调用任何工具，不要反问，不要输出计划或步骤说明。');
+  return lines.join('\n');
+}
+
 function snapshotPrompt(project, previous, chapters, pointDay) {
   const lines = [];
   lines.push(`你是这部小说的世界观维护者。当前要产出第 ${pointDay} 天的世界快照。`);
@@ -1428,7 +1477,7 @@ async function bootstrap(ctx, root) {
     }
   }
   return {
-    revision: '2026-10-27.4',
+    revision: '2026-10-27.9',
     projects,
     models: {
       default: modelCatalog.default || null,
@@ -1813,6 +1862,44 @@ async function createSessionFor(ctx, root, project) {
   }
 }
 
+/** Longest preface prompt accepted, in characters. */
+const PRELUDE_MAX_CHARS = 2000;
+
+/**
+ * Save one work's preface prompt. `mode` only labels which preset the text came
+ * from; the text itself is what every request carries, so the author can edit a
+ * preset's wording or write their own.
+ */
+async function updatePrelude(root, body) {
+  const projectId = asText(body.projectId);
+  const mode = asText(body.mode);
+  const text = typeof body.text === 'string' ? body.text : '';
+  if (text.length > PRELUDE_MAX_CHARS) {
+    throw httpError(400, `前置提示词最多 ${PRELUDE_MAX_CHARS} 字`);
+  }
+  const trimmed = text.trim();
+  const project = await mutateProject(root, projectId, (draft) => {
+    draft.prelude = trimmed === '' && mode === ''
+      ? null
+      : { mode, text: trimmed, updatedAt: Date.now() };
+    draft.updatedAt = Date.now();
+    return summarize(draft);
+  });
+  await exportProjectInfo(await readProject(root, projectId));
+  return { project };
+}
+
+/** The preface block every writing request starts with, or '' when unset. */
+function preludeBlock(project) {
+  const text = project && project.prelude && project.prelude.text ? String(project.prelude.text).trim() : '';
+  if (text === '') return '';
+  return [
+    '【本书前置设定】（作者为全书设定的写作约束，优先于下文提示，但不得违反本章梗概与已发生的事实）',
+    text,
+    '',
+  ].join('\n');
+}
+
 /**
  * Record the preset a work's session should run under.
  *
@@ -2219,6 +2306,46 @@ async function startSnapshotReset(ctx, root, registry, body) {
   });
 }
 
+/**
+ * Revise a chapter's text from a note, without saving it.
+ *
+ * The Client keeps the result in the editor as an unsaved draft, so a rewrite
+ * never replaces text the author has not looked at. Both inputs are required:
+ * there is nothing to revise without text, and nothing to do without a note.
+ */
+async function startRevise(ctx, root, registry, body) {
+  const projectId = asText(body.projectId);
+  const chapterId = asText(body.chapterId);
+  const instruction = asText(body.instruction);
+  const draft = typeof body.content === 'string' ? body.content : '';
+  if (draft.trim() === '') throw httpError(400, '这一章还没有正文，先写或先生成再让 AI 修改');
+  if (instruction === '') throw httpError(400, '请先写清修改意见');
+  const preview = await readProject(root, projectId);
+  const claimed = preview.chapters.find((entry) => entry.chapterId === chapterId);
+  if (!claimed) throw httpError(404, `章节不存在: ${chapterId}`);
+  return startJob(registry, { kind: 'revise', projectId, chapterId }, async (job) => {
+    const project = await readProject(root, projectId);
+    const chapter = project.chapters.find((entry) => entry.chapterId === chapterId);
+    if (!chapter) throw httpError(404, `章节不存在: ${chapterId}`);
+    job.message = '正在按修改意见重写本章';
+    const raw = await askStory(ctx, root, project, revisePrompt(project, chapter, draft, instruction), (note) => {
+      job.message = note;
+    });
+    // Keep the author's own length: never cut below what they already had.
+    const limit = Math.max(
+      (chapter.outline && chapter.outline.maxWords) || 3000,
+      Math.round(wordCount(draft) * 1.3),
+    );
+    const fitted = fitChapterText(raw, limit);
+    job.message = fitted.trimmed ? '模型写超了字数，已按上限截断' : '完成';
+    return {
+      content: fitted.text,
+      wordCount: wordCount(fitted.text),
+      trimmed: fitted.trimmed,
+    };
+  });
+}
+
 async function startGenerate(ctx, root, registry, body) {
   const projectId = asText(body.projectId);
   const chapterId = asText(body.chapterId);
@@ -2516,6 +2643,8 @@ async function dispatch(ctx, root, registry, method, path, url, body) {
       return updateModel(ctx, root, body);
     case '/project/preset':
       return updatePreset(ctx, root, body);
+    case '/project/prelude':
+      return updatePrelude(root, body);
     case '/project/rebind':
       return rebindProject(ctx, root, body);
     case '/project/move':
@@ -2528,6 +2657,8 @@ async function dispatch(ctx, root, registry, method, path, url, body) {
       return saveChapter(root, body);
     case '/generate':
       return startGenerate(ctx, root, registry, body);
+    case '/chapter/revise':
+      return startRevise(ctx, root, registry, body);
     case '/compose':
       return startCompose(ctx, root, registry, body);
     case '/deduce':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-novel-generator",
-  "version": "0.1.21",
+  "version": "0.1.25",
   "type": "module",
   "description": "Novel studio for DeepSeek Harness: a draggable story timeline, world snapshots, chapter outlines, and chapters written by the work's own agent.",
   "license": "MIT",