dsh-novel-generator 0.1.18 → 0.1.20

package/README.md

@@ -51,12 +51,14 @@ dsh plugin --profile web add dsh-novel-generator
   ├── 第01章 章节名.md                章节正文（纯正文）
   ├── 章节大纲/
   │   └── 第01章 章节名.md            该章梗概 + 时间跨度 + 字数上下限 + 实际字数
+  │   └── .history/                  梗概被改短的旧版本（每章最多留 5 份）
   └── 世界快照/
-      └── 第030天.md                 世界观 / 角色 / 势力 / 关系 / 阶段变化
+      └── 第030天.md                 世界观 / 角色 / 势力 / 关系 / 物品 / 事件 / 阶段变化
   ```
 
   - 每次保存正文、生成章节、保存大纲（改标题）、结算快照都会同步刷新这些文件；改标题会顺手删掉旧文件名。
   - 若你在编辑器里直接改章节正文 `.md` 且比插件记录的更新时间更晚，下次打开作品会以文件内容为准（梗概与快照目前是单向导出）。
+  - **梗概是自由文本，可以自带 Markdown 小标题**：大纲卡片里 `## 故事梗概` 之后直到文件结尾都算梗概正文。若某次保存把梗概改短了，旧版本会先落到 `章节大纲/.history/`，随时可以翻回来。
 - **作品名称就是文件夹名，所以受文件名规则限制**：不能为空、最多 60 字、不能以空格或点开头结尾、不能含 `\ / : * ? " < > |` 与控制字符、不能用 `CON`/`NUL`/`COM1` 等系统保留名。创建界面会即时校验并禁用「创建」按钮。
 - HTTP 接口前缀：`/dsh-novel-generator/api`，只接受本机页面同源请求。
 - 生成、推演、快照都是异步任务：`POST /generate`、`POST /compose`、`POST /deduce`、`POST /snapshot/refresh` 返回 `jobId`，再由 `GET /job?id=` 轮询。

package/index.js

@@ -226,14 +226,49 @@ function snapshotJsonPaths(project, snapshot) {
   };
 }
 
-/** The synopsis body of an outline card (`（还没有写梗概）` reads as empty). */
+/**
+ * Before an outline card is overwritten, keep the previous version when the new
+ * synopsis is shorter. The card is the only copy of that text, so this is the
+ * difference between a recoverable edit and losing thousands of characters.
+ * History lives in `章节大纲/.history/` and is pruned to the newest few files.
+ */
+async function keepOutlineHistory(cardPath, nextSynopsis) {
+  let previous = null;
+  try {
+    previous = await readFile(cardPath, 'utf8');
+  } catch {
+    return;
+  }
+  const oldBody = parseSynopsis(previous);
+  if (oldBody.length <= nextSynopsis.length) return;
+  try {
+    const dir = join(join(cardPath, '..'), '.history');
+    await mkdir(dir, { recursive: true });
+    const stem = basename(cardPath, '.md');
+    await writeFile(join(dir, `${stem}.${Date.now()}.md`), previous, 'utf8');
+    const kept = (await readdir(dir)).filter((name) => name.startsWith(`${stem}.`)).sort();
+    for (const name of kept.slice(0, Math.max(0, kept.length - 5))) {
+      await unlink(join(dir, name)).catch(() => {});
+    }
+  } catch {
+    // History is a safety net; failing to keep it must not block the save.
+  }
+}
+
+/**
+ * The synopsis body of an outline card (`（还没有写梗概）` reads as empty).
+ *
+ * The synopsis is user prose and may itself contain Markdown headings, so it is
+ * everything after the marker to the end of the file — the writer always puts it
+ * last. Cutting at the next `## ` heading used to truncate any synopsis that had
+ * one inside it, and the shortened value then overwrote the file on the next
+ * save, which is how a 5000-character synopsis came back as a few lines.
+ */
 function parseSynopsis(text) {
   const marker = '## 故事梗概';
   const start = text.indexOf(marker);
   if (start === -1) return '';
-  const rest = text.slice(start + marker.length);
-  const next = rest.indexOf('\n## ');
-  const body = (next === -1 ? rest : rest.slice(0, next)).trim();
+  const body = text.slice(start + marker.length).trim();
   return body === '（还没有写梗概）' ? '' : body;
 }
 
@@ -276,6 +311,10 @@ async function exportChapterOutline(project, chapter) {
     await mkdir(target.dir, { recursive: true });
     const outline = chapter.outline || null;
     const span = chapterWindow(project, chapter);
+    // The card is the only copy of the synopsis, so a write that shortens it a
+    // lot keeps the previous card aside first: a truncation bug then costs one
+    // click to undo instead of the whole text.
+    await keepOutlineHistory(target.file, (outline && outline.synopsis) || '');
     const lines = [];
     lines.push(`# 第 ${(Number(chapter.index) || 0) + 1} 章 ${chapter.title || '未命名'}`);
     lines.push('');
@@ -1389,7 +1428,7 @@ async function bootstrap(ctx, root) {
     }
   }
   return {
-    revision: '2026-10-21.2',
+    revision: '2026-10-27.3',
     projects,
     models: {
       default: modelCatalog.default || null,
@@ -2114,8 +2153,15 @@ function registerSnapshot(ctx, root, registry, projectId, targetDay) {
 }
 
 /** Wipe every snapshot (and its files) so the work can be rebuilt from day 1. */
-function startSnapshotReset(ctx, root, registry, body) {
+async function startSnapshotReset(ctx, root, registry, body) {
   const projectId = asText(body.projectId);
+  // Validate before queueing, like the other job routes: an unknown work must
+  // come back as a plain 404 instead of a job that fails a second later.
+  const preview = await readProject(root, projectId);
+  const previewUnit = Math.max(1, preview.timeline.unitDays || 30);
+  if (Math.floor(lastChapterEnd(preview) / previewUnit) * previewUnit < previewUnit) {
+    throw httpError(409, '故事还不到一个快照间隔，没有可重建的快照');
+  }
   return startJob(registry, { kind: 'snapshot-reset', projectId }, async (job) => {
     const project = await readProject(root, projectId);
     const unit = Math.max(1, project.timeline.unitDays || 30);

package/package.json

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