dsh-novel-generator 0.1.4 → 0.1.6

package/README.md

@@ -22,20 +22,21 @@ dsh plugin --profile web add dsh-novel-generator
 ## 界面流程
 
 1. **作品列表**：创建 / 删除 / 打开作品。**删除作品会同时删掉工作目录下以作品名命名的那个文件夹（正文、梗概、快照），二次确认里会说明；作品绑定的会话保留。**创建时选工作目录、模型、预设——**工作目录只能通过「选择」调目录选择器挑选，不能手填**；创建动作本身会调用 `sessionController.create` 为作品开一个会话，会话照常出现在左侧列表里，可以直接进去对话。**每行都显示当前模型，并有「模型」按钮：改完会同时切换作品绑定的会话模型**（走 `sessionController.selectModel`）。**会话会被放进左侧对应的分组：作品目录已经是工作区就并进去，否则为该目录新建一个名为「小说工坊」的工作区**，不再是「未分组」。打开工作室时会对老作品补做这一步。
-2. **时间长河**（作品主界面）：最上方是时间线，左端是第 0 天，右端是**最新世界快照的时间**（故事已经写到快照之后时，右端延伸到故事当前的时间）。拖动时下方世界观、角色列表、势力列表、关系（`甲 乙 关系`）切换到该时间点之前最新的那份快照。右上角「快照间隔」是一个可编辑的选择框：候选值 **7 / 15 / 30 / 90 / 180 / 365 天**，也可以直接输入别的天数——这个值同时是「多少天结算一份世界快照」的阈值和自动触发点。**当拖到下一个快照点（上一份快照时间 + 一个间隔）时，页面顶部出现「生成世界快照 · 第 N 天」按钮，点击会先问「是否为当前时间生成世界快照」，确认后才生成。**「进入故事」进入离选中时间最近的章节。界面最底部是一条**每章天数统计图**：横轴为第几章（每章居中占一格），纵轴就是「今天数」——每章自己跨了多少天，柱高即该章天数，折线连接各章天数，鼠标悬停可看到该章在故事里的起止天数；标题栏的「隐藏统计图 / 显示统计图」按钮可以收起或展开它。
+2. **时间长河**（作品主界面）：最上方是时间线，左端是第 0 天，右端是**最新世界快照的时间**（故事已经写到快照之后时，右端延伸到故事当前的时间）。拖动时下方世界观、角色列表、势力列表、关系（`甲 乙 关系`）切换到该时间点之前最新的那份快照。右上角「快照间隔」是一个可编辑的选择框：候选值 **7 / 15 / 30 / 90 / 180 / 365 天**，也可以直接输入别的天数——这个值同时是「多少天结算一份世界快照」的阈值和自动触发点。**拖到下一个快照点时，页面顶部出现「生成世界快照 · 第 N 天」按钮；拖到最新那份快照所在的那天，则出现「重新生成快照 · 第 N 天」（用于改过章节之后刷新这一版快照，会替换旧的那份）。两种情况都会先弹确认再执行。**「进入故事」进入离选中时间最近的章节。界面最底部是一条**每章天数统计图**：横轴为第几章（每章居中占一格），纵轴就是「今天数」——每章自己跨了多少天，柱高即该章天数，折线连接各章天数，鼠标悬停可看到该章在故事里的起止天数；标题栏的「隐藏统计图 / 显示统计图」按钮可以收起或展开它。
 3. **章节故事**：左上「← 时间长河」回时间线界面，右上「章节大纲 →」把故事页向左收起、翻开大纲页。中间用「← 上一章 / 下一章 →」左右切换；**到了最后一章，右侧的「下一章 →」变成「＋ 新建章节」**。正文可直接改，底部「保存」，保存成功用右上角的提示条告知（不是页面上的一行小字）。**正文有未保存的修改时，任何离开动作（回时间线、翻章、进大纲、新建章节、返回作品列表、关闭工作室）都会先弹出确认，可选「不保存离开」或「保存并离开」。**
 4. **新建章节**（弹窗）：章节名称（可留空）、章节最低字数、章节最多字数、故事时间长度（天），后三项必填。填好后可以「创建空章节」，或点「自动推演」一次拿到本章梗概、章节名称与完整正文。**作品的第一章没有世界快照、也没有上一章可依据，所以这一章的自动推演是禁用的（新建弹窗与章节大纲页都是），先创建空章节、自己写梗概再生成。**
 5. **章节大纲**：左上「← 章节故事」。可改标题、时间长度、字数上下限、梗概最低字数与梗概；梗概达到最低字数且其他项填完才能「保存」，保存成功用提示条告知，保存后「生成章节故事」才可点。右上「自动推演」点下去会先提示「将覆盖现有内容」，确认后按当前字数与时间长度重新生成**故事梗概 + 章节名称 + 整章正文**并直接保存；「生成章节故事」点下去会先问「是否以当前故事梗概生成故事」，确认后才重写正文。**大纲有未保存的修改时，离开同样会先弹确认（不保存离开 / 保存并离开）；大纲不完整时「保存并离开」会拒绝并提示。**
 
 ## 世界快照怎么来
 
-- 时间线以「天」计（0 = 创建作品那天），整条线的右端永远等于最新快照的时间。
-- **每次生成章节后**都会检查：本章结束时间距离上一份快照是否已满一个时间线单位（30 / 90 / 365 天，由你选）。
-- 满了就取**上一份世界快照 + 这段时间内各章的梗概**，让作品会话产出新快照（世界观 / 角色 / 势力 / 关系），时间线随之向前多出一段到新快照时间。
-- 第一份快照同样按这个规则：故事时间走过一个单位后才写入。
+- 时间线以「天」计（0 = 创建作品那天），你选的「快照间隔」（7 / 15 / 30 / 90 / 180 / 365 天，可手输）决定了一条**网格**：第 15、30、45… 天。
+- **手动**：把时间线拖到网格点上（第 N 天且 N 能被间隔整除），标题栏出现「生成世界快照 · 第 N 天」；该点已有快照时按钮变成「重新生成快照 · 第 N 天」，会替换旧的那份。两种情况都先弹确认。
+- **自动**：每次生成章节后检查两个条件，缺一不可：① 本章结束时间**正好落在网格点上**；② **上一格**（该点 − 一个间隔）已经有快照（第 0 天视为已覆盖）。满足才自动生成这一格的快照。
+- 这样改间隔不会把旧快照重排：网格随当前间隔移动，自动生成只沿着「上一格存在」的链条向前推进，断档的地方留给你手动补。
 
 ## 数据与接口
 
+
 - **索引文件**：`<DSH_HOME>/novel-studio/projects/<项目id>/project.json`（`DSH_HOME` 缺省为 `~/.dsh`，本机即 `C:\Users\Admin\.dsh\novel-studio`）。时间线、大纲、快照字段都记在这里；`dataDir` 配置可改这块的位置。
 - **正文、梗概、快照全部写到工作目录下、以作品名称命名的文件夹里**：
 

package/client.js

@@ -748,9 +748,18 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
 
       const snapshot = snapshotAt(detail, day);
       const chapters = detail.chapters || [];
-      // The button only exists where the story has actually reached the next
-      // snapshot point the project's own unit defines.
-      const canSnapshot = chapters.length > 0 && storyEnd >= nextDay && day >= nextDay;
+      // The button belongs on the interval grid: the cursor must sit exactly on
+      // a multiple of the current interval. There it either fills a missing
+      // snapshot or replaces the one already written for that day.
+      const onGridPoint = unitDays >= 1 && day > 0 && day % unitDays === 0;
+      const hasSnapshotHere = (detail.snapshots || []).some((entry) => entry.day === day);
+      const canSnapshot = chapters.length > 0
+        && onGridPoint
+        && (hasSnapshotHere || day <= storyEnd);
+      const regenerating = hasSnapshotHere;
+      const snapshotLabel = regenerating
+        ? t('重新生成快照 · 第 {day} 天', 'Regenerate snapshot · day {day}', { day })
+        : t('生成世界快照 · 第 {day} 天', 'Generate snapshot · day {day}', { day });
       const nearest = useMemo(() => {
         if (chapters.length === 0) return null;
         let best = chapters[0];
@@ -767,12 +776,18 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
 
       const askSnapshot = useCallback(() => {
         requestConfirm({
-          title: t('是否为当前时间生成世界快照？', "Generate a world snapshot for this point in time?"),
-          text: t('将为第 {day} 天生成一份世界快照：以上一份快照和这段时间的章节梗概为依据，时间线会延伸到这一天。', 'A world snapshot will be generated for day {day} from the previous snapshot and the synopses of this stretch; the timeline extends to that day.', { day }),
-          confirmLabel: t('生成快照', "Generate snapshot"),
+          title: regenerating
+            ? t('是否重新生成第 {day} 天的世界快照？', 'Regenerate the world snapshot for day {day}?', { day })
+            : t('是否为当前时间生成世界快照？', "Generate a world snapshot for this point in time?"),
+          text: regenerating
+            ? t('会以第 {day} 天之前那版快照和这段时间的章节梗概重写这一天，原有快照被替换。', 'It rewrites day {day} from the snapshot before it and the synopses of this stretch; the existing snapshot is replaced.', { day })
+            : t('将为第 {day} 天生成一份世界快照：以上一份快照和这段时间的章节梗概为依据，时间线会延伸到这一天。', 'A world snapshot will be generated for day {day} from the previous snapshot and the synopses of this stretch; the timeline extends to that day.', { day }),
+          confirmLabel: regenerating
+            ? t('重新生成', 'Regenerate')
+            : t('生成快照', "Generate snapshot"),
           action: () => onRefreshSnapshot(day),
         });
-      }, [requestConfirm, day, detail, onRefreshSnapshot]);
+      }, [requestConfirm, day, detail, onRefreshSnapshot, regenerating]);
 
       return h(React.Fragment, null,
         h('div', { className: 'dsn-pagehead' },
@@ -791,7 +806,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
               type: 'button',
               disabled: snapshotBusy,
               onClick: askSnapshot,
-            }, snapshotBusy ? t('生成中…', "Generating…") : t('生成世界快照 · 第 {day} 天', 'Generate snapshot · day {day}', { day }))
+            }, snapshotBusy ? t('生成中…', "Generating…") : snapshotLabel)
             : null,
           h('button', { className: 'dsn-btn primary', type: 'button', onClick: () => onEnterStory(day) },
             nearest ? t('进入故事 · 第 {n} 章', 'Enter story · chapter {n}', { n: nearest.index + 1 }) : t('进入故事', "Enter story"))),

package/index.js

@@ -1073,7 +1073,7 @@ async function bootstrap(ctx, root) {
     }
   }
   return {
-    revision: '2026-10-20.17',
+    revision: '2026-10-20.19',
     projects,
     models: {
       default: modelCatalog.default || null,
@@ -1349,15 +1349,22 @@ async function ensureWorkspace(ctx, project) {
   return workspace;
 }
 
-/** One snapshot per elapsed timeline threshold, derived from that period's chapters. */
-function snapshotDue(project, day) {
-  const snapshots = project.snapshots || [];
-  const last = snapshots[snapshots.length - 1];
+/**
+ * Whether a chapter ending at `day` earns an automatic snapshot.
+ *
+ * The rule ignores how many snapshots exist and which interval produced them:
+ * a point counts only when the chapter lands exactly on a multiple of the
+ * *current* interval, and the point one interval earlier is already covered
+ * (day 0 — the story's start — counts as covered). Changing the interval
+ * therefore moves the grid, and generation only continues along an unbroken
+ * chain rather than back-filling gaps by itself.
+ */
+function snapshotPointDue(project, day) {
   const unit = Math.max(1, project.timeline.unitDays || 30);
-  // Story time starts at day 0, so the first snapshot is due once the story has
-  // advanced one full unit from the origin rather than on the first chapter.
-  const since = last ? last.day : 0;
-  return day - since >= unit;
+  if (day <= 0 || day % unit !== 0) return false;
+  const previous = day - unit;
+  if (previous <= 0) return true;
+  return (project.snapshots || []).some((snapshot) => snapshot.day === previous);
 }
 
 /** Story day where the next chapter continues: the end of the last chapter. */
@@ -1385,8 +1392,15 @@ function withTimelineFacts(project) {
       unitDays,
       latestSnapshotDay,
       storyEnd: lastChapterEnd(project),
-      nextSnapshotDay: latestSnapshotDay + unitDays,
+      // The next point on the *current* interval's grid, not "last + unit":
+      // after an interval change the grid moves under the existing snapshots.
+      nextSnapshotDay: Math.floor(latestSnapshotDay / unitDays) * unitDays + unitDays,
       snapshotDays: snapshots.map((snapshot) => snapshot.day),
+      // Every grid point up to the story's end, so the Client can mark them.
+      gridDays: Array.from(
+        { length: Math.max(0, Math.floor(lastChapterEnd(project) / unitDays)) },
+        (_, index) => (index + 1) * unitDays,
+      ),
     },
   };
 }
@@ -1402,15 +1416,17 @@ function registerSnapshot(ctx, root, registry, projectId, day) {
   return startJob(registry, { kind: 'snapshot', projectId }, async (job) => {
     const project = await readProject(root, projectId);
     const snapshots = project.snapshots || [];
-    const last = snapshots[snapshots.length - 1] || null;
-    const since = last ? last.day : 0;
+    // Regenerating an existing day replaces it: the basis is the snapshot
+    // before that day, not the one being replaced.
+    const base = snapshots.filter((snapshot) => snapshot.day < day).pop() || null;
+    const since = base ? base.day : 0;
     const chapters = (project.chapters || [])
       .filter((chapter) => chapterWindow(project, chapter).end > since
         && (((chapter.outline && chapter.outline.synopsis) || '').trim() !== '' || String(chapter.content || '').trim() !== ''))
       .sort((a, b) => a.startDay - b.startDay);
-    if (chapters.length === 0) throw httpError(409, '自上一版快照以来还没有已生成的章节，无法更新世界快照');
+    if (chapters.length === 0) throw httpError(409, `第 ${day} 天之前还没有可依据的章节，无法生成世界快照`);
     job.message = `正在阅读 ${chapters.length} 章的梗概并更新世界快照`;
-    const reply = await askAgent(ctx, project, snapshotPrompt(project, last, chapters));
+    const reply = await askAgent(ctx, project, snapshotPrompt(project, base, chapters));
     const parsed = parseJsonReply(reply);
     if (!parsed) throw httpError(502, '模型没有返回可解析的快照 JSON');
     const normalized = normalizeSnapshot(parsed);
@@ -1425,7 +1441,10 @@ function registerSnapshot(ctx, root, registry, projectId, day) {
       ...normalized,
     };
     await mutateProject(root, projectId, (draft) => {
+      // One snapshot per day: regenerating replaces the one already there.
+      draft.snapshots = (draft.snapshots || []).filter((entry) => entry.day !== day);
       draft.snapshots.push(snapshot);
+      draft.snapshots.sort((a, b) => a.day - b.day);
       return snapshot;
     });
     await exportSnapshot(project, snapshot);
@@ -1460,7 +1479,7 @@ function startGenerate(ctx, root, registry, body) {
     await exportChapter(project, saved, content);
     const window = chapterWindow(project, chapter);
     let snapshotJobId = null;
-    if (snapshotDue(project, window.end)) {
+    if (snapshotPointDue(project, window.end)) {
       const snapshotJob = registerSnapshot(ctx, root, registry, projectId, window.end);
       snapshotJobId = snapshotJob.jobId;
     }
@@ -1577,7 +1596,7 @@ function startCompose(ctx, root, registry, body) {
     if (written) await exportChapter(after, written, content);
     const window = chapterWindow(after, target);
     let snapshotJobId = null;
-    if (snapshotDue(after, window.end)) {
+    if (snapshotPointDue(after, window.end)) {
       snapshotJobId = registerSnapshot(ctx, root, registry, projectId, window.end).jobId;
     }
     return {

package/package.json

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