dsh-novel-generator 0.1.34 → 0.1.35

package/README.md

@@ -70,6 +70,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"`。
 
+## 导入章节
+
+作品列表每行的「导入章节」把现成的 `.md` 章节文件导进作品。两步：选来源 → 看匹配结果 → 确认。
+
+**匹配规则**（文件名要按 `第N章 标题.md` 命名）：
+
+- 认 `第1章`、`第007章`、`第十二章` 三种编号写法，后缀也可以是 `回` / `节`；扩展名 `.md` / `.markdown` / `.txt`；
+- 从你选的起点开始按 `1, 2, 3…`（或 `上一章编号+1`）**顺序配对**，配不上就停；后面即使还有文件也不会导入；
+- 起点选「从第 1 章开始」时，**作品里已占用的章号会跳过**（不覆盖、不重复）；
+- 标题取编号之后的部分（`第3章.md` 没有标题，就用「第 3 章」）。
+
+**匹配展示界面**会列出：将导入的每一条（`文件名 → 第N章 标题 · 字数`）、被跳过的章号、**没连上的文件**、**认不出章号的文件**，以及疑似编码乱码的标记。
+
+**导入后**：正文写进作品并导出成 `第NN章 标题.md`，章节按你填的「每章故事时间长度（天）」依次推进；勾选「自动同步章节大纲」时逐章调用模型生成梗概与字数范围（进度可见、可停止）；导入推进到网格点时会顺带触发世界快照。
+
 ## 前置提示词（作品级）
 
 作品列表每行的「前置」可以给一本书设定前置提示：内置「第三人称全知（默认）/ 第三人称限知 / 第一人称 / 自定义」四种，选中即填入文本框，文本可自由改写（最多 2000 字）。
@@ -84,7 +99,9 @@ dsh plugin --profile web add dsh-novel-generator
 ## 章节故事页
 
 - 正文可以直接编辑、保存；工具条上还有两个按钮：
-  - **「生成故事梗概」**：确认后把当前正文交给模型，生成一段新梗概并**直接保存、覆盖原有梗概**（正文不动）。
+  - **「同步章节大纲」**：确认后把当前正文交给模型，**按这一章的实际内容重算整份大纲**——故事梗概、故事时间长度（天）、章节最低字数、章节最多字数、梗概最低字数，然后直接保存覆盖旧大纲（正文不动）。
+    - 字数范围一定会把正文实际字数包在里面；梗概下限不会超过新梗概本身的长度。
+    - 时间长度只有在不破坏时间线时才会改：末章可以直接改；后面还有章节时，只有「下一章起始日 = 本章起始日 + 新时长」才采纳，否则保留原时长并在提示里说明模型建议值。
   - **「AI 修改」**：填入修改意见后，模型按意见重写整章，结果只放进编辑区、不自动保存。
 - 正文为空时两个按钮都不可点，接口也会拒绝（400）；修改意见为空同样拒绝。
 
@@ -93,7 +110,7 @@ dsh plugin --profile web add dsh-novel-generator
 - **「AI 修改梗概」**：与章节故事页的「AI 修改」区分——它只改**故事梗概**，依据是「原梗概 + 你的修改意见」，不动正文和章节名。结果填回梗概框并标记未保存，确认后点「保存」。
 - 梗概为空或意见为空时按钮不可点，接口也会 400。
 
-> 刻意的差别：「生成故事梗概」会覆盖保存（读的是你已经写定的正文），「AI 修改梗概」只改草稿（它改的正是你用来生成正文的依据，值得先看一眼）。
+> 刻意的差别：「同步章节大纲」会覆盖保存（读的是你已经写定的正文，一次对齐五项），「AI 修改梗概」只改草稿（它改的正是你用来生成正文的依据，值得先看一眼）。
 
 ## 「小说工坊 · 作者」预设（随主插件一起装）
 

package/client.js

@@ -256,6 +256,17 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
 .dsn-synopsis{min-height:220px;resize:vertical;line-height:1.8;font-size:13px}
 .dsn-hint{font-size:11px;color:var(--dsw-alias-label-secondary)}
 .dsn-hint.warn{color:var(--dsw-alias-state-warn-primary)}
+.dsn-check{display:flex;align-items:flex-start;gap:8px;font-size:12px;color:var(--dsw-alias-label-secondary);cursor:pointer}
+.dsn-check input{margin:2px 0 0}
+.dsn-importlist{max-height:280px;overflow:auto;display:flex;flex-direction:column;gap:2px;
+  border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px 8px;background:var(--dsw-alias-bg-layer-3)}
+.dsn-importrow{display:flex;align-items:baseline;gap:8px;font-size:12px;padding:3px 0}
+.dsn-importno{min-width:44px;color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums}
+.dsn-importfile{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.dsn-importarrow{color:var(--dsw-alias-label-secondary)}
+.dsn-importtitle{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-primary)}
+.dsn-importchars{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums}
+.dsn-importwarn{color:var(--dsw-alias-state-warn-primary)}
 .dsn-progress{font-size:12px;color:var(--dsw-alias-label-secondary);display:flex;align-items:center;gap:8px}
 .dsn-spin{width:12px;height:12px;border-radius:50%;border:2px solid var(--dsw-alias-border-l2);
   border-top-color:var(--dsw-alias-brand-primary);animation:dsn-spin .9s linear infinite}
@@ -432,6 +443,224 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             }, busy ? t('保存中…', "Saving…") : t('保存', "Save")))));
     }
 
+    /**
+     * Import chapters from a folder of `.md` files.
+     *
+     * Three steps in one dialog: choose the folder and how to line the files up
+     * with the work's chapters, look at exactly which files will become which
+     * chapters, then import. The preview exists because the matcher stops at the
+     * first gap, so guessing wrong would silently drop chapters.
+     */
+    function ImportDialog({ project, resolveWorkspace, onCancel, onDone }) {
+      const [phase, setPhase] = useState('form');
+      const [dir, setDir] = useState('');
+      const [from, setFrom] = useState('next');
+      const [durationDays, setDurationDays] = useState(project.timeline ? (project.timeline.unitDays || 30) : 30);
+      const [syncOutline, setSyncOutline] = useState(true);
+      const [busy, setBusy] = useState(false);
+      const [error, setError] = useState('');
+      const [scan, setScan] = useState(null);
+      const [job, setJob] = useJob();
+
+      const pickDirectory = useCallback(async () => {
+        const ui = typeof resolveWorkspace === 'function' ? resolveWorkspace() : null;
+        if (!ui || typeof ui.pickDirectory !== 'function') {
+          setError(t('目录选择器还没就绪，请稍后再点一次「选择目录」', 'The directory picker is not ready yet — try again in a moment.'));
+          return;
+        }
+        try {
+          const picked = await ui.pickDirectory();
+          if (picked) setDir(picked);
+        } catch (pickError) {
+          setError(messageOf(pickError));
+        }
+      }, [resolveWorkspace]);
+
+      const runScan = useCallback(async () => {
+        if (dir.trim() === '') {
+          setError(t('请先选择要导入的章节目录', 'Choose the folder to import from first.'));
+          return;
+        }
+        setBusy(true);
+        setError('');
+        try {
+          const result = await api('/import/scan', { projectId: project.projectId, dir, from });
+          setScan(result);
+          setPhase('preview');
+        } catch (scanError) {
+          setError(messageOf(scanError));
+        } finally {
+          setBusy(false);
+        }
+      }, [dir, from, project.projectId]);
+
+      const startImport = useCallback(async () => {
+        const pending = (scan ? scan.entries : []).filter((entry) => !entry.skip);
+        if (pending.length === 0) {
+          setError(t('没有可导入的章节（都已被作品里的章节占用）', 'Nothing to import — those chapter numbers are already taken.'));
+          return;
+        }
+        setError('');
+        try {
+          const started = await api('/import/apply', {
+            projectId: project.projectId,
+            dir: scan.dir,
+            files: pending.map((entry) => entry.fileName),
+            durationDays: Number(durationDays) || 1,
+            syncOutline: Boolean(syncOutline),
+          });
+          setJob(started);
+          setPhase('running');
+        } catch (importError) {
+          setError(messageOf(importError));
+        }
+      }, [scan, durationDays, syncOutline, project.projectId, setJob]);
+
+      useEffect(() => {
+        if (!job || job.state === 'running') return;
+        if (job.state === 'done') onDone(job.result || {});
+        else if (job.state === 'error') setError(job.error || t('导入失败', 'Import failed'));
+      }, [job ? job.jobId : null, job ? job.state : null]);
+
+      const entries = scan ? scan.entries : [];
+      const willImport = entries.filter((entry) => !entry.skip);
+      const taken = entries.filter((entry) => entry.skip);
+
+      const head = h('div', { className: 'dsn-dialog-head' },
+        h('div', { className: 'dsn-title' }, phase === 'form'
+          ? t('导入章节 · 选择来源', 'Import chapters · source')
+          : t('导入章节 · 匹配结果', 'Import chapters · match')),
+        h('div', { className: 'dsn-sub' }, project.title),
+        h('div', { className: 'dsn-spacer' }));
+
+      if (phase === 'form') {
+        return h('div', { className: 'dsn-dialog-backdrop' },
+          h('div', { className: 'dsn-dialog', style: { width: 'min(620px, calc(100% - 48px))' } },
+            head,
+            h('div', { className: 'dsn-dialog-body' },
+              h('label', { className: 'dsn-field span4' },
+                h('span', { className: 'dsn-label' }, t('待导入章节目录（必填）', 'Folder to import from (required)')),
+                h('div', { style: { display: 'flex', gap: 8 } },
+                  h('input', {
+                    className: 'dsn-input',
+                    value: dir,
+                    placeholder: t('例如：D:\\小说\\第二部', 'e.g. D:\\novel\\part-two'),
+                    onChange: (event) => setDir(event.target.value),
+                  }),
+                  h('button', { className: 'dsn-btn ghost', type: 'button', onClick: pickDirectory }, t('选择目录', 'Browse')))),
+              h('div', { className: 'dsn-hint span4' }, t('文件名要按「第N章 标题.md」命名（N 可以是 1、007、十二）。插件从你选定的起点按 1、2、3… 顺序配对，配对到第一个缺号为止，后面的文件不会被导入。', 'Files must be named like “第N章 Title.md” (N may be 1, 007 or 十二). Matching walks 1, 2, 3… from the chosen start and stops at the first missing number; anything after that gap is left out.')),
+              h('div', { className: 'dsn-field span2' },
+                h('span', { className: 'dsn-label' }, t('匹配起点', 'Where to start matching')),
+                h('label', { className: 'dsn-check' },
+                  h('input', {
+                    type: 'radio',
+                    name: 'dsn-import-from',
+                    checked: from === 'first',
+                    onChange: () => setFrom('first'),
+                  }),
+                  h('span', null, t('从第 1 章开始（已存在的章号会跳过）', 'From chapter 1 (numbers already taken are skipped)'))),
+                h('label', { className: 'dsn-check' },
+                  h('input', {
+                    type: 'radio',
+                    name: 'dsn-import-from',
+                    checked: from === 'next',
+                    onChange: () => setFrom('next'),
+                  }),
+                  h('span', null, t('从作品的下一章开始', 'From the chapter after this work’s last one')))),
+              h('label', { className: 'dsn-field span2' },
+                h('span', { className: 'dsn-label' }, t('每章故事时间长度（天）', 'Story days per chapter')),
+                h('input', {
+                  className: 'dsn-input',
+                  type: 'number',
+                  min: 1,
+                  value: durationDays,
+                  onChange: (event) => setDurationDays(Number(event.target.value)),
+                })),
+              h('label', { className: 'dsn-check span4' },
+                h('input', {
+                  type: 'checkbox',
+                  checked: syncOutline,
+                  onChange: (event) => setSyncOutline(event.target.checked),
+                }),
+                h('span', null, t('导入后自动同步章节大纲（每章调用一次模型，生成梗概与字数范围）', 'Sync each outline after import (one model call per chapter, for the synopsis and word bounds)'))),
+              syncOutline ? null : h('div', { className: 'dsn-hint warn span4' }, t('不勾选时导入的章节没有梗概：后续生成正文时它们不会出现在「已发生的章节梗概」里，可以之后逐章用「同步章节大纲」补。', 'Without it the imported chapters have no synopsis, so later generations will not see them in “what already happened”. You can sync each one later.')),
+              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, onClick: runScan },
+                busy ? t('匹配中…', 'Matching…') : t('确定', 'Next')))));
+      }
+
+      if (phase === 'preview') {
+        return h('div', { className: 'dsn-dialog-backdrop' },
+          h('div', { className: 'dsn-dialog', style: { width: 'min(720px, calc(100% - 48px))' } },
+            head,
+            h('div', { className: 'dsn-dialog-body' },
+              h('div', { className: 'dsn-hint span4' }, t('来源：{dir} · 起点：第 {start} 章 · 将导入 {count} 章 · 每章 {days} 天{extra}',
+                'From {dir} · starts at chapter {start} · {count} chapters · {days} days each{extra}', {
+                  dir: scan.dir,
+                  start: scan.startNumber,
+                  count: willImport.length,
+                  days: durationDays,
+                  extra: taken.length ? t('（跳过 {n} 章）', ' ({n} skipped)', { n: taken.length }) : '',
+                })),
+              willImport.length === 0
+                ? h('div', { className: 'dsn-hint warn span4' }, t('没有可导入的章节。', 'Nothing to import.'))
+                : h('div', { className: 'dsn-importlist span4' },
+                  willImport.map((entry) => h('div', { key: entry.fileName, className: 'dsn-importrow' },
+                    h('span', { className: 'dsn-importno' }, `#${entry.number}`),
+                    h('span', { className: 'dsn-importfile' }, entry.fileName),
+                    h('span', { className: 'dsn-importarrow' }, '→'),
+                    h('span', { className: 'dsn-importtitle' }, t('第 {n} 章 {title}', 'Chapter {n} · {title}', { n: entry.number, title: entry.title || t('未命名', 'Untitled') })),
+                    h('span', { className: 'dsn-importchars' }, t('{n} 字', '{n} chars', { n: entry.chars })),
+                    entry.garbled ? h('span', { className: 'dsn-importwarn' }, t('疑似乱码', 'encoding?') ) : null))),
+              taken.length > 0
+                ? h('div', { className: 'dsn-hint warn span4' }, t('这些章号已被作品占用，会跳过：{list}', 'These numbers are already taken and will be skipped: {list}', { list: taken.map((entry) => `第${entry.number}章`).join('、') }))
+                : null,
+              scan.leftover.length > 0
+                ? h('div', { className: 'dsn-hint span4' }, t('没连上、不会导入：{list}', 'Unmatched, not imported: {list}', { list: scan.leftover.join('、') }))
+                : null,
+              scan.unrecognized.length > 0
+                ? h('div', { className: 'dsn-hint span4' }, t('文件名认不出章号：{list}', 'No chapter number in the name: {list}', { list: scan.unrecognized.join('、') }))
+                : null,
+              error ? h('div', { className: 'dsn-hint warn span4' }, error) : null),
+            h('div', { className: 'dsn-dialog-foot' },
+              h('button', { className: 'dsn-btn ghost', type: 'button', onClick: () => { setPhase('form'); setError(''); } }, t('返回修改', 'Back')),
+              h('div', { className: 'dsn-spacer' }),
+              h('button', { className: 'dsn-btn', type: 'button', onClick: onCancel }, t('取消', 'Cancel')),
+              h('button', {
+                className: 'dsn-btn primary',
+                type: 'button',
+                disabled: willImport.length === 0,
+                onClick: startImport,
+              }, t('确认导入 {n} 章', 'Import {n} chapters', { n: willImport.length })))));
+      }
+
+      return h('div', { className: 'dsn-dialog-backdrop' },
+        h('div', { className: 'dsn-dialog', style: { width: 'min(560px, calc(100% - 48px))' } },
+          head,
+          h('div', { className: 'dsn-dialog-body' },
+            h('div', { className: 'dsn-progress span4' }, h('span', { className: 'dsn-spin' }), job ? (job.message || t('正在导入…', 'Importing…')) : t('正在导入…', 'Importing…')),
+            error ? h('div', { className: 'dsn-hint warn span4' }, error) : null),
+          h('div', { className: 'dsn-dialog-foot' },
+            h('div', { className: 'dsn-spacer' }),
+            h('button', {
+              className: 'dsn-btn',
+              type: 'button',
+              onClick: async () => {
+                if (job) {
+                  try {
+                    await api('/job/cancel', { jobId: job.jobId });
+                  } catch (stopError) {
+                    setError(messageOf(stopError));
+                  }
+                }
+                onCancel();
+              },
+            }, t('停止', 'Stop')))));
+    }
+
     function PresetDialog({ project, presets, onCancel, onSaved }) {
       const [preset, setPreset] = useState(project.agentPreset || '');
       const [busy, setBusy] = useState(false);
@@ -555,7 +784,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             }, busy ? t('保存中…', 'Saving…') : t('保存', 'Save')))));
     }
 
-    function ProjectsPage({ boot, resolveWorkspace, onOpen, onReload, onEditModel, onEditPreset, onEditPrelude }) {
+    function ProjectsPage({ boot, resolveWorkspace, onOpen, onReload, onEditModel, onEditPreset, onEditPrelude, onImport }) {
       const [title, setTitle] = useState('');
       const [cwd, setCwd] = useState('');
       const [preset, setPreset] = useState('');
@@ -809,6 +1038,15 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
                 onEditPrelude(project);
               },
             }, t('前置', 'Preface')),
+            h('button', {
+              className: 'dsn-btn ghost',
+              type: 'button',
+              title: t('从某个目录按「第N章 标题.md」的顺序导入章节', 'Import chapters from a folder of “第N章 Title.md” files'),
+              onClick: (event) => {
+                event.stopPropagation();
+                onImport(project);
+              },
+            }, t('导入章节', 'Import')),
             h('button', {
               className: 'dsn-btn ghost',
               type: 'button',
@@ -2415,6 +2653,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
       const [modelTarget, setModelTarget] = useState(null);
       const [presetTarget, setPresetTarget] = useState(null);
       const [preludeTarget, setPreludeTarget] = useState(null);
+      const [importTarget, setImportTarget] = useState(null);
       const leaveGuard = useRef(null);
       const registerLeaveGuard = useCallback((guard) => {
         leaveGuard.current = guard;
@@ -2508,6 +2747,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
                   onEditModel: setModelTarget,
                   onEditPreset: setPresetTarget,
                   onEditPrelude: setPreludeTarget,
+                  onImport: setImportTarget,
                 }))
               : detail === null
                 ? h('div', { className: 'dsn-empty', style: { margin: 'auto' } }, t('正在载入作品…', "Loading the work…"))
@@ -2547,6 +2787,30 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             },
           })
           : null,
+        importTarget
+          ? h(ImportDialog, {
+            project: importTarget,
+            resolveWorkspace,
+            onCancel: () => setImportTarget(null),
+            onDone: async (result) => {
+              setImportTarget(null);
+              await loadBoot();
+              const imported = (result.imported || []).length;
+              const skipped = (result.skipped || []).length;
+              const failed = (result.failed || []).length;
+              const synced = (result.synced || []).length;
+              const parts = [t('已导入 {n} 章', 'Imported {n} chapters', { n: imported })];
+              if (synced > 0) parts.push(t('同步大纲 {n} 章', 'synced {n} outlines', { n: synced }));
+              if (skipped > 0) parts.push(t('跳过 {n} 章（章号已被占用）', 'skipped {n} taken', { n: skipped }));
+              if (failed > 0) parts.push(t('失败 {n} 个：{list}', '{n} failed: {list}', {
+                n: failed,
+                list: (result.failed || []).map((entry) => `${entry.fileName}（${entry.reason}）`).join('、'),
+              }));
+              if (result.snapshotJobId) parts.push(t('世界快照已开始生成', 'World snapshot started'));
+              setToast({ text: parts.join('；'), kind: failed > 0 ? 'error' : 'success' });
+            },
+          })
+          : null,
         preludeTarget
           ? h(PreludeDialog, {
             project: preludeTarget,

package/index.js

@@ -1499,7 +1499,7 @@ async function bootstrap(ctx, root) {
     }
   }
   return {
-    revision: '2026-10-28.5',
+    revision: '2026-10-28.9',
     projects,
     models: {
       default: modelCatalog.default || null,
@@ -2088,90 +2088,99 @@ async function startSyncOutline(ctx, root, registry, body) {
     throw httpError(404, `章节不存在: ${chapterId}`);
   }
   return startJob(registry, { kind: 'sync-outline', 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 askAgent(ctx, root, project, syncOutlinePrompt(project, chapter, prose), (note) => {
+    return syncChapterOutline(ctx, root, projectId, chapterId, prose, (note) => {
       job.message = note;
     });
-    const parsed = parseJsonReply(raw) || {};
-    const chars = wordCount(prose);
-    // A reply without usable JSON still yields a synopsis: the model's prose is
-    // the summary, and the numbers fall back to what the chapter actually is.
-    const synopsis = cleanSynopsis(
-      typeof parsed.synopsis === 'string' && parsed.synopsis.trim() !== '' ? parsed.synopsis : raw,
-    );
-    if (synopsis === '') throw httpError(502, '模型没有给出梗概');
+  });
+}
 
-    const previous = chapter.outline || {};
-    const span = chapterWindow(project, chapter);
-    const notes = [];
-
-    // Word bounds must contain what was actually written, whatever the model said.
-    const floorHundred = (value) => Math.max(1, Math.floor(value / 100) * 100);
-    const ceilHundred = (value) => Math.max(200, Math.ceil(value / 100) * 100);
-    let minWords = Number.isFinite(Number(parsed.minWords)) ? Math.max(1, Math.round(Number(parsed.minWords))) : 0;
-    let maxWords = Number.isFinite(Number(parsed.maxWords)) ? Math.max(1, Math.round(Number(parsed.maxWords))) : 0;
-    if (minWords <= 0 || minWords > chars) minWords = floorHundred(chars * 0.9);
-    if (maxWords <= 0 || maxWords < chars) maxWords = ceilHundred(chars * 1.1);
-    if (maxWords < minWords) maxWords = minWords + 100;
-
-    // The synopsis floor has to stay reachable by the synopsis it was measured on.
-    let synopsisMinChars = Number.isFinite(Number(parsed.synopsisMinChars))
-      ? Math.round(Number(parsed.synopsisMinChars))
-      : Math.max(20, Math.floor(synopsis.length * 0.8));
-    synopsisMinChars = Math.max(20, Math.min(400, synopsisMinChars));
-    synopsisMinChars = Math.max(1, Math.min(synopsisMinChars, synopsis.length));
-
-    // A new duration only lands when it keeps the next chapter where it is.
-    let durationDays = chapter.durationDays;
-    const proposed = Number.isFinite(Number(parsed.durationDays))
-      ? Math.max(1, Math.min(365, Math.round(Number(parsed.durationDays))))
-      : null;
-    if (proposed !== null && proposed !== chapter.durationDays) {
-      const following = (project.chapters || [])
-        .filter((entry) => entry.chapterId !== chapter.chapterId && entry.startDay >= span.start)
-        .sort((a, b) => a.startDay - b.startDay)[0] || null;
-      if (following === null) {
-        durationDays = proposed;
-      } else if (following.startDay === span.start + proposed) {
-        durationDays = proposed;
-      } else {
-        notes.push(`下一章从第 ${following.startDay} 天开始，改时长会错位，时间长度保持 ${chapter.durationDays} 天（模型建议 ${proposed} 天）`);
-      }
+/**
+ * The shared body of "measure this chapter from its prose and write the result
+ * back into its outline". Used by the story page's button and by chapter import,
+ * so both produce identical outlines.
+ */
+async function syncChapterOutline(ctx, root, projectId, chapterId, prose, note) {
+  const project = await readProject(root, projectId);
+  const chapter = project.chapters.find((entry) => entry.chapterId === chapterId);
+  if (!chapter) throw httpError(404, `章节不存在: ${chapterId}`);
+  const raw = await askAgent(ctx, root, project, syncOutlinePrompt(project, chapter, prose), note);
+  const parsed = parseJsonReply(raw) || {};
+  const chars = wordCount(prose);
+  // A reply without usable JSON still yields a synopsis: the model's prose is
+  // the summary, and the numbers fall back to what the chapter actually is.
+  const synopsis = cleanSynopsis(
+    typeof parsed.synopsis === 'string' && parsed.synopsis.trim() !== '' ? parsed.synopsis : raw,
+  );
+  if (synopsis === '') throw httpError(502, '模型没有给出梗概');
+
+  const previous = chapter.outline || {};
+  const span = chapterWindow(project, chapter);
+  const notes = [];
+
+  // Word bounds must contain what was actually written, whatever the model said.
+  const floorHundred = (value) => Math.max(1, Math.floor(value / 100) * 100);
+  const ceilHundred = (value) => Math.max(200, Math.ceil(value / 100) * 100);
+  let minWords = Number.isFinite(Number(parsed.minWords)) ? Math.max(1, Math.round(Number(parsed.minWords))) : 0;
+  let maxWords = Number.isFinite(Number(parsed.maxWords)) ? Math.max(1, Math.round(Number(parsed.maxWords))) : 0;
+  if (minWords <= 0 || minWords > chars) minWords = floorHundred(chars * 0.9);
+  if (maxWords <= 0 || maxWords < chars) maxWords = ceilHundred(chars * 1.1);
+  if (maxWords < minWords) maxWords = minWords + 100;
+
+  // The synopsis floor has to stay reachable by the synopsis it was measured on.
+  let synopsisMinChars = Number.isFinite(Number(parsed.synopsisMinChars))
+    ? Math.round(Number(parsed.synopsisMinChars))
+    : Math.max(20, Math.floor(synopsis.length * 0.8));
+  synopsisMinChars = Math.max(20, Math.min(400, synopsisMinChars));
+  synopsisMinChars = Math.max(1, Math.min(synopsisMinChars, synopsis.length));
+
+  // A new duration only lands when it keeps the next chapter where it is.
+  let durationDays = chapter.durationDays;
+  const proposed = Number.isFinite(Number(parsed.durationDays))
+    ? Math.max(1, Math.min(365, Math.round(Number(parsed.durationDays))))
+    : null;
+  if (proposed !== null && proposed !== chapter.durationDays) {
+    const following = (project.chapters || [])
+      .filter((entry) => entry.chapterId !== chapter.chapterId && entry.startDay >= span.start)
+      .sort((a, b) => a.startDay - b.startDay)[0] || null;
+    if (following === null) {
+      durationDays = proposed;
+    } else if (following.startDay === span.start + proposed) {
+      durationDays = proposed;
+    } else {
+      notes.push(`下一章从第 ${following.startDay} 天开始，改时长会错位，时间长度保持 ${chapter.durationDays} 天（模型建议 ${proposed} 天）`);
     }
+  }
 
-    const saved = await mutateProject(root, projectId, (draft) => {
-      const target = draft.chapters.find((entry) => entry.chapterId === chapterId);
-      if (!target) throw httpError(404, `章节不存在: ${chapterId}`);
-      target.outline = {
-        ...previous,
-        synopsis,
-        minWords,
-        maxWords,
-        durationDays,
-        synopsisMinChars,
-        savedAt: Date.now(),
-      };
-      target.durationDays = durationDays;
-      target.updatedAt = Date.now();
-      return { chapter: { ...target, content: undefined }, project: summarize(draft) };
-    });
-    const fresh = await readProject(root, projectId);
-    await exportChapterOutline(fresh, saved.chapter);
-    await exportProjectInfo(fresh);
-    return {
+  const saved = await mutateProject(root, projectId, (draft) => {
+    const target = draft.chapters.find((entry) => entry.chapterId === chapterId);
+    if (!target) throw httpError(404, `章节不存在: ${chapterId}`);
+    target.outline = {
+      ...previous,
       synopsis,
       minWords,
       maxWords,
       durationDays,
       synopsisMinChars,
-      chars,
-      notes,
-      chapter: saved.chapter,
+      savedAt: Date.now(),
     };
+    target.durationDays = durationDays;
+    target.updatedAt = Date.now();
+    return { chapter: { ...target, content: undefined }, project: summarize(draft) };
   });
+  const fresh = await readProject(root, projectId);
+  await exportChapterOutline(fresh, saved.chapter);
+  await exportProjectInfo(fresh);
+  return {
+    synopsis,
+    minWords,
+    maxWords,
+    durationDays,
+    synopsisMinChars,
+    chars,
+    notes,
+    chapter: saved.chapter,
+  };
 }
 
 /** Rewrite one chapter's synopsis from a note, without saving it. */
@@ -2198,6 +2207,245 @@ async function startSynopsisRevise(ctx, root, registry, body) {
   });
 }
 
+/* ------------------------------------------------------- chapter importing */
+
+/** Chinese numerals as used in chapter headings, e.g. 第十二章. */
+const CHINESE_DIGITS = { 零: 0, 〇: 0, 一: 1, 二: 2, 两: 2, 三: 3, 四: 4, 五: 5, 六: 6, 七: 7, 八: 8, 九: 9 };
+const CHINESE_UNITS = { 十: 10, 百: 100, 千: 1000 };
+
+/** Turn `十二` / `一百零三` / `12` into a number, or null. */
+function parseChapterNumber(text) {
+  const raw = String(text || '').trim();
+  if (raw === '') return null;
+  if (/^\d+$/u.test(raw)) {
+    const value = Number(raw);
+    return Number.isSafeInteger(value) && value > 0 ? value : null;
+  }
+  if (!/^[零〇一二两三四五六七八九十百千]+$/u.test(raw)) return null;
+  let total = 0;
+  let section = 0;
+  let digit = 0;
+  for (const char of raw) {
+    if (char in CHINESE_DIGITS) {
+      digit = CHINESE_DIGITS[char];
+      continue;
+    }
+    const unit = CHINESE_UNITS[char];
+    if (unit === undefined) continue;
+    if (digit === 0 && unit === 10) digit = 1;
+    section += digit * unit;
+    digit = 0;
+  }
+  total = section + digit;
+  return total > 0 && total < 100000 ? total : null;
+}
+
+/**
+ * Chapter number and title from a file name: `第12章 雨夜.md`, `第007章雨夜.md`
+ * and `第十二章 雨夜.md` all yield a number, and the title is whatever follows
+ * the suffix (`章` / `回` / `节`) or trailing separators.
+ */
+function parseChapterFileName(fileName) {
+  // The extension goes first: `第3章.md` would otherwise leave `md` as the title.
+  const stem = String(fileName || '').replace(/\.(md|markdown|txt)$/iu, '');
+  const match = stem.match(/^第\s*([0-9零〇一二两三四五六七八九十百千]+)\s*[章回节][\s._\-—:：]*(.*)$/u);
+  if (!match) return null;
+  const number = parseChapterNumber(match[1]);
+  if (number === null) return null;
+  return { number, title: String(match[2] || '').trim() };
+}
+
+/** Read a directory of chapter files and match them from the chosen start. */
+async function scanImportChapters(root, body) {
+  const projectId = asText(body.projectId);
+  const project = await readProject(root, projectId);
+  const dir = asText(body.dir);
+  if (dir === '') throw httpError(400, '请先选择要导入的章节目录');
+  const mode = asText(body.from) === 'next' ? 'next' : 'first';
+  let entries = [];
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch (error) {
+    throw httpError(400, `无法读取目录 ${dir}：${error instanceof Error ? error.message : String(error)}`);
+  }
+  const files = entries.filter((entry) => entry.isFile() && /\.(md|markdown|txt)$/iu.test(entry.name));
+  if (files.length === 0) throw httpError(400, '这个目录里没有 .md 章节文件');
+
+  const byNumber = new Map();
+  const unrecognized = [];
+  for (const file of files) {
+    const parsed = parseChapterFileName(file.name);
+    if (!parsed) {
+      unrecognized.push(file.name);
+      continue;
+    }
+    if (!byNumber.has(parsed.number)) byNumber.set(parsed.number, { ...parsed, fileName: file.name });
+  }
+
+  const existingNumbers = new Set(
+    (project.chapters || []).map((chapter) => (Number(chapter.index) || 0) + 1),
+  );
+  const startNumber = mode === 'next'
+    ? Math.max(0, ...existingNumbers) + 1
+    : 1;
+
+  const matched = [];
+  for (let number = startNumber; byNumber.has(number); number += 1) {
+    const entry = byNumber.get(number);
+    let chars = 0;
+    let garbled = false;
+    try {
+      const text = await readFile(join(dir, entry.fileName), 'utf8');
+      chars = wordCount(text);
+      garbled = text.includes('\uFFFD');
+    } catch {
+      // The preview still lists the file; the import reports a read failure.
+    }
+    matched.push({
+      number,
+      fileName: entry.fileName,
+      title: entry.title,
+      chars,
+      garbled,
+      skip: existingNumbers.has(number),
+    });
+    if (matched.length >= 500) break;
+  }
+
+  const matchedNumbers = new Set(matched.map((entry) => entry.number));
+  const leftover = [...byNumber.values()]
+    .filter((entry) => !matchedNumbers.has(entry.number))
+    .sort((a, b) => a.number - b.number)
+    .map((entry) => entry.fileName);
+
+  const notes = [];
+  if (leftover.length > 0) notes.push(`另有 ${leftover.length} 个章节文件没有连上，不会导入`);
+  if (unrecognized.length > 0) notes.push(`另有 ${unrecognized.length} 个文件名认不出章号，不会导入`);
+  if (matched.length === 0) notes.push(`从第 ${startNumber} 章开始没有找到能连上的文件`);
+
+  return {
+    dir,
+    mode,
+    startNumber,
+    total: matched.length,
+    entries: matched,
+    leftover,
+    unrecognized,
+    notes,
+  };
+}
+
+/**
+ * Copy the confirmed files in as chapters and, when asked, sync each outline.
+ *
+ * The import is deliberately one chapter at a time: a failure names the file it
+ * stopped on and leaves the chapters already written in place.
+ */
+async function startImportChapters(ctx, root, registry, body) {
+  const projectId = asText(body.projectId);
+  const dir = asText(body.dir);
+  const files = Array.isArray(body.files) ? body.files.filter((name) => typeof name === 'string' && name !== '') : [];
+  if (dir === '') throw httpError(400, '请先选择要导入的章节目录');
+  if (files.length === 0) throw httpError(400, '没有选中要导入的章节文件');
+  const durationDays = Math.max(1, Math.min(3650, Math.round(Number(body.durationDays) || 0) || 1));
+  const syncOutline = body.syncOutline === true;
+  const preview = await readProject(root, projectId);
+
+  return startJob(registry, { kind: 'import-chapters', projectId }, async (job) => {
+    const imported = [];
+    const skipped = [];
+    const failed = [];
+    for (let index = 0; index < files.length; index += 1) {
+      const fileName = files[index];
+      job.message = `正在导入 ${index + 1}/${files.length}：${fileName}`;
+      const parsed = parseChapterFileName(fileName);
+      if (!parsed) {
+        failed.push({ fileName, reason: '文件名认不出章号' });
+        continue;
+      }
+      let content;
+      try {
+        content = await readFile(join(dir, fileName), 'utf8');
+      } catch (error) {
+        failed.push({ fileName, reason: error instanceof Error ? error.message : String(error) });
+        continue;
+      }
+      if (content.trim() === '') {
+        failed.push({ fileName, reason: '文件是空的' });
+        continue;
+      }
+      let created = null;
+      const project = await readProject(root, projectId);
+      const taken = (project.chapters || []).some((chapter) => (Number(chapter.index) || 0) + 1 === parsed.number);
+      if (taken) {
+        skipped.push({ fileName, number: parsed.number });
+        continue;
+      }
+      await mutateProject(root, projectId, (draft) => {
+        const chapter = {
+          chapterId: randomUUID(),
+          index: nextChapterIndex(draft),
+          title: parsed.title !== '' ? parsed.title : `第 ${parsed.number} 章`,
+          startDay: lastChapterEnd(draft),
+          durationDays,
+          outline: null,
+          content,
+          wordCount: wordCount(content),
+          status: 'imported',
+          createdAt: Date.now(),
+          updatedAt: Date.now(),
+          generatedAt: null,
+        };
+        draft.chapters.push(chapter);
+        created = chapter;
+        return chapter;
+      });
+      const fresh = await readProject(root, projectId);
+      const saved = fresh.chapters.find((chapter) => chapter.chapterId === created.chapterId) || created;
+      await exportChapter(fresh, saved, content);
+      await exportChapterOutline(fresh, saved);
+      await exportProjectInfo(fresh);
+      imported.push({ chapterId: saved.chapterId, number: parsed.number, title: saved.title, chars: wordCount(content) });
+    }
+
+    const synced = [];
+    if (syncOutline && imported.length > 0) {
+      for (let index = 0; index < imported.length; index += 1) {
+        const entry = imported[index];
+        job.message = `正在同步章节大纲 ${index + 1}/${imported.length}：第 ${entry.number} 章`;
+        try {
+          const project = await readProject(root, projectId);
+          const chapter = project.chapters.find((item) => item.chapterId === entry.chapterId);
+          const result = await syncChapterOutline(ctx, root, projectId, entry.chapterId, chapter ? (chapter.content || '') : '', (note) => {
+            job.message = note;
+          });
+          synced.push({ chapterId: entry.chapterId, synopsisChars: (result.synopsis || '').length });
+        } catch (error) {
+          failed.push({ fileName: entry.title, reason: `同步大纲失败：${error instanceof Error ? error.message : String(error)}` });
+        }
+      }
+    }
+
+    // Imported chapters advance story time like any other, so the grid points
+    // they cross get their snapshots.
+    let snapshotJobId = null;
+    if (imported.length > 0) {
+      const after = await readProject(root, projectId);
+      const target = autoSnapshotTarget(after, lastChapterEnd(after));
+      if (target !== null) snapshotJobId = registerSnapshot(ctx, root, registry, projectId, target).jobId;
+    }
+
+    return {
+      imported,
+      skipped,
+      failed,
+      synced,
+      snapshotJobId,
+      project: summarize(await readProject(root, projectId)),
+    };
+  });
+}
+
 async function updateTimeline(root, body) {
   const projectId = asText(body.projectId);
   const unitDays = Number(body.unitDays);
@@ -2994,6 +3242,10 @@ async function dispatch(ctx, root, registry, method, path, url, body) {
       return startRevise(ctx, root, registry, body);
     case '/chapter/sync-outline':
       return startSyncOutline(ctx, root, registry, body);
+    case '/import/scan':
+      return scanImportChapters(root, body);
+    case '/import/apply':
+      return startImportChapters(ctx, root, registry, body);
     case '/outline/revise':
       return startSynopsisRevise(ctx, root, registry, body);
     case '/compose':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-novel-generator",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "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",