dsh-novel-generator 0.1.3 → 0.1.5

package/README.md

@@ -22,7 +22,7 @@ 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. **章节大纲**：左上「← 章节故事」。可改标题、时间长度、字数上下限、梗概最低字数与梗概；梗概达到最低字数且其他项填完才能「保存」，保存成功用提示条告知，保存后「生成章节故事」才可点。右上「自动推演」点下去会先提示「将覆盖现有内容」，确认后按当前字数与时间长度重新生成**故事梗概 + 章节名称 + 整章正文**并直接保存；「生成章节故事」点下去会先问「是否以当前故事梗概生成故事」，确认后才重写正文。**大纲有未保存的修改时，离开同样会先弹确认（不保存离开 / 保存并离开）；大纲不完整时「保存并离开」会拒绝并提示。**

package/client.js

@@ -748,9 +748,15 @@ 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;
+      // 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;
+      const canSnapshot = chapters.length > 0
+        && ((storyEnd >= nextDay && day >= nextDay) || atLatestSnapshot);
+      const snapshotLabel = atLatestSnapshot
+        ? 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 +773,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: atLatestSnapshot
+            ? t('是否重新生成第 {day} 天的世界快照？', 'Regenerate the world snapshot for day {day}?', { day })
+            : t('是否为当前时间生成世界快照？', "Generate a world snapshot for this point in time?"),
+          text: atLatestSnapshot
+            ? 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
+            ? t('重新生成', 'Regenerate')
+            : t('生成快照', "Generate snapshot"),
           action: () => onRefreshSnapshot(day),
         });
-      }, [requestConfirm, day, detail, onRefreshSnapshot]);
+      }, [requestConfirm, day, detail, onRefreshSnapshot, atLatestSnapshot]);
 
       return h(React.Fragment, null,
         h('div', { className: 'dsn-pagehead' },
@@ -791,7 +803,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

@@ -11,7 +11,7 @@
  * UI and watch (or correct) the very same agent the generator drives.
  */
 import { randomUUID } from 'node:crypto';
-import { mkdir, readFile, readdir, rename, rm, rmdir, unlink, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, readdir, rename, rm, rmdir, stat, unlink, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 
@@ -105,6 +105,79 @@ function projectContentDir(project) {
   return join(project.cwd, safeSegment(project.title, '未命名作品'));
 }
 
+/** Ownership stamp written into the work folder, so delete never eats user data. */
+const MARKER_FILE = '.novel-generator.json';
+
+function markerFile(project) {
+  return join(projectContentDir(project), MARKER_FILE);
+}
+
+async function stampWorkFolder(project) {
+  try {
+    await mkdir(projectContentDir(project), { recursive: true });
+    await writeFile(markerFile(project), JSON.stringify({
+      projectId: project.projectId,
+      title: project.title,
+      createdAt: project.createdAt,
+    }, null, 2), 'utf8');
+  } catch {
+    // A folder that cannot be written simply has no stamp.
+  }
+}
+
+/** True when this project's folder carries this project's own stamp. */
+async function ownsWorkFolder(project) {
+  try {
+    const data = JSON.parse(await readFile(markerFile(project), 'utf8'));
+    return Boolean(data) && data.projectId === project.projectId;
+  } catch {
+    return false;
+  }
+}
+
+async function pathExists(target) {
+  try {
+    await stat(target);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Reserve the work folder. An existing folder is reused only when it is empty
+ * or already belongs to this plugin for the same project; anything else is a
+ * name clash with the user's own files and is reported instead.
+ */
+async function reserveWorkFolder(project, projectId) {
+  const dir = projectContentDir(project);
+  await mkdir(dir, { recursive: true });
+  const entries = (await readdir(dir)).filter((name) => name !== MARKER_FILE);
+  if (entries.length === 0) return dir;
+  let owner = null;
+  try {
+    owner = JSON.parse(await readFile(join(dir, MARKER_FILE), 'utf8'));
+  } catch {
+    owner = null;
+  }
+  if (owner && owner.projectId === projectId) return dir;
+  throw httpError(409, `工作目录下已经有名为「${safeSegment(project.title, '未命名作品')}」的文件夹，请换一个作品名称`);
+}
+
+/** Remove the work folder only when it is provably this project's own. */
+async function discardWorkFolder(project) {
+  if (!project || !project.cwd) return null;
+  const dir = projectContentDir(project);
+  if (dir === project.cwd) return null;
+  if (!(await ownsWorkFolder(project))) return null;
+  try {
+    await rm(dir, { recursive: true, force: true });
+    return dir;
+  } catch {
+    return null;
+  }
+}
+
 /** Where one chapter lives inside the work's own folder. */
 function chapterPaths(project, chapter) {
   const number = String((Number(chapter.index) || 0) + 1).padStart(2, '0');
@@ -408,6 +481,7 @@ function strippedProject(project, unwritten) {
 /** Write every content file, then the parameter-only index. */
 async function persistProject(root, project) {
   const unwritten = new Set();
+  await stampWorkFolder(project);
   for (const chapter of project.chapters || []) {
     const ok = await exportChapter(project, chapter, chapter.content);
     if (!ok) unwritten.add(chapter.chapterId);
@@ -973,16 +1047,33 @@ async function bootstrap(ctx, root) {
     }
   }
   const projects = await listProjects(root);
-  // Repair projects created before sessions were placed in the sidebar group.
+  // Repair projects created before sessions were placed in the sidebar group,
+  // and stamp works made before folders carried an ownership mark.
   for (const project of projects) {
     try {
       await ensureWorkspace(ctx, project);
     } catch {
       // A missing directory or an older harness simply leaves the session as is.
     }
+    try {
+      // Stamp a folder that already exists; a work whose folder was never
+      // written (or was deleted on purpose) is left alone.
+      await stat(projectContentDir(project));
+      if (!(await ownsWorkFolder(project))) await stampWorkFolder(project);
+    } catch {
+      // An unreachable folder simply stays unstamped.
+    }
+    try {
+      if (!(await ownsWorkFolder(project)) && !(await pathExists(projectContentDir(project)))) {
+        // A work created before folders were materialised gets one now.
+        await persistProject(root, await readProject(root, project.projectId));
+      }
+    } catch {
+      // Best effort; the next save materialises it anyway.
+    }
   }
   return {
-    revision: '2026-10-20.15',
+    revision: '2026-10-20.18',
     projects,
     models: {
       default: modelCatalog.default || null,
@@ -1021,6 +1112,16 @@ async function createProject(ctx, root, body) {
     }
     : null;
 
+  // Claim the work folder before anything else, so a name clash costs neither a
+  // session nor a half-written project.
+  const projectId = randomUUID();
+  try {
+    await reserveWorkFolder({ projectId, title, cwd }, projectId);
+  } catch (error) {
+    if (error && error.status) throw error;
+    throw httpError(400, `无法在工作目录下创建作品文件夹：${error instanceof Error ? error.message : String(error)}`);
+  }
+
   const created = await controller.create(agentPreset === undefined ? { cwd } : { cwd, agentPreset });
   const sessionId = created && created.sessionId ? created.sessionId : null;
   let warning = null;
@@ -1035,7 +1136,7 @@ async function createProject(ctx, root, body) {
   const today = new Date();
   const origin = today.toISOString().slice(0, 10);
   const project = {
-    projectId: randomUUID(),
+    projectId,
     title,
     cwd,
     agentPreset: agentPreset || created.agentPreset || null,
@@ -1048,6 +1149,9 @@ async function createProject(ctx, root, body) {
     chapters: [],
   };
   await writeJson(projectFile(root, project.projectId), project);
+  // Write the stamp and 作品信息.md right away: the folder exists the moment the
+  // work does, instead of appearing on the first chapter.
+  await persistProject(root, project);
 
   // Put the session in a sidebar workspace instead of leaving it ungrouped.
   let workspace = null;
@@ -1298,15 +1402,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);
@@ -1321,7 +1427,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);
@@ -1556,24 +1665,17 @@ async function dispatch(ctx, root, registry, method, path, url, body) {
     case '/project/delete': {
       const projectId = asText(body.projectId);
       if (projectId === '') throw httpError(400, '缺少 projectId');
-      // The work folder is this plugin's own output inside the chosen
-      // directory, so removing the work removes it too.
+      // Only a folder carrying this project's own stamp is removed: a folder
+      // the user already had under the same name is never touched.
       let workDir = null;
       try {
         const project = await readProject(root, projectId);
-        if (project.cwd) {
-          const folder = projectContentDir(project);
-          const relative = folder.slice(project.cwd.length).replace(/^[\\/]+/, '');
-          if (relative !== '') {
-            await rm(folder, { recursive: true, force: true });
-            workDir = folder;
-          }
-        }
+        workDir = await discardWorkFolder(project);
       } catch {
         // A work whose folder is already gone still gets its record removed.
       }
       await rm(join(projectsDir(root), projectId), { recursive: true, force: true });
-      return { removed: projectId, removedDir: workDir };
+      return { removed: projectId, removedDir: workDir, folderKept: workDir === null };
     }
     case '/project/timeline':
       return updateTimeline(root, body);

package/package.json

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