dsh-novel-generator 0.1.5 → 0.1.6

package/README.md

@@ -29,13 +29,14 @@ dsh plugin --profile web add dsh-novel-generator
 
 ## 世界快照怎么来
 
-- 时间线以「天」计（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,13 +748,16 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
 
       const snapshot = snapshotAt(detail, day);
       const chapters = detail.chapters || [];
-      // Two moments offer the button: the story has reached the next snapshot
-      // point (a new snapshot), or the slider sits on the newest snapshot
-      // (regenerate it after editing the chapters behind it).
-      const atLatestSnapshot = latest > 0 && day === latest;
+      // 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
-        && ((storyEnd >= nextDay && day >= nextDay) || atLatestSnapshot);
-      const snapshotLabel = atLatestSnapshot
+        && 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(() => {
@@ -773,18 +776,18 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
 
       const askSnapshot = useCallback(() => {
         requestConfirm({
-          title: atLatestSnapshot
+          title: regenerating
             ? t('是否重新生成第 {day} 天的世界快照？', 'Regenerate the world snapshot for day {day}?', { day })
             : t('是否为当前时间生成世界快照？', "Generate a world snapshot for this point in time?"),
-          text: atLatestSnapshot
+          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: atLatestSnapshot
+          confirmLabel: regenerating
             ? t('重新生成', 'Regenerate')
             : t('生成快照', "Generate snapshot"),
           action: () => onRefreshSnapshot(day),
         });
-      }, [requestConfirm, day, detail, onRefreshSnapshot, atLatestSnapshot]);
+      }, [requestConfirm, day, detail, onRefreshSnapshot, regenerating]);
 
       return h(React.Fragment, null,
         h('div', { className: 'dsn-pagehead' },

package/index.js

@@ -1073,7 +1073,7 @@ async function bootstrap(ctx, root) {
     }
   }
   return {
-    revision: '2026-10-20.18',
+    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,
+      ),
     },
   };
 }
@@ -1465,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;
     }
@@ -1582,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.5",
+  "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",