dsh-novel-generator 0.1.41 → 0.1.42

package/README.md

@@ -2,6 +2,26 @@
 
 DSH 的常驻插件：在时间线上写小说。每个作品绑定一个普通会话，章节正文与世界快照都由那个会话里自己的 Agent 生成。
 
+## 截图
+
+作品列表（每行「模型 / 预设 / 前置 / 设置 / 导入章节 / 重建会话 / 改目录 / 删除」）：
+
+![作品列表](screenshots/1-list.png)
+
+时间长河与世界快照：
+
+![时间长河](screenshots/2-timeline.png)
+
+章节故事页（编辑、同步章节大纲、提取行文风格、AI 修改）：
+
+![章节故事](screenshots/3-chapter.png)
+
+章节大纲页（梗概、字数范围、时间长度、AI 修改梗概）：
+
+![章节大纲](screenshots/4-outline.png)
+
+> 这四张也在 `screenshots.json` 里声明了顺序，插件市场详情页会按这个顺序展示。
+
 ## 安装
 
 ```sh
@@ -96,6 +116,21 @@ dsh plugin --profile web add dsh-novel-generator
 - 内容同时写进作品的 `作品信息.md`（文末「前置提示词」一节），便于外部查看与备份。
 - 留空即表示不设置。
 
+## 作品设置：前文参考程度
+
+作品列表每行的「设置」里，控制**自动推演**与**生成章节故事**时对前文的参考程度：
+
+| 选项 | 提示词里带什么 |
+|---|---|
+| **前一章（全文）**（默认） | 上一章整章正文，用来接住语气、场景与最后一句 |
+| 前一章的后一半 | 只从上一章中间那句话开始给到结尾 |
+| 不参考正文 | 只靠世界快照与各章梗概推进 |
+
+- 上一章正文超过 8000 字时只取**最后 8000 字**（衔接看结尾，不看开头）。
+- 「上一章」按起始日排序取本章之前最近的一章；它没有正文（空章节/导入未写）时该块自动省略。
+- 参考块出现在提示词里「已发生的章节梗概」之后、「本章梗概」之前。
+- 自动推演（`/deduce`、`/compose`）与生成正文（`/generate`）共用这一设置；同步大纲、提取风格、世界快照**不带**前文正文（那些是测量/结构化任务，带前文只会干扰判断）。
+
 ## 章节故事页
 
 - 正文可以直接编辑、保存；工具条上还有三个按钮：

package/client.js

@@ -268,6 +268,19 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
 .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-prompt-body{display:flex;gap:12px;min-height:320px;max-height:min(58vh,520px)}
+.dsn-prompt-list{display:flex;flex-direction:column;gap:4px;min-width:150px;overflow:auto}
+.dsn-prompt-item{text-align:left;font-size:12px;padding:7px 10px;border-radius:8px;cursor:pointer;
+  border:1px solid transparent;background:transparent;color:var(--dsw-alias-label-secondary)}
+.dsn-prompt-item:hover{background:var(--dsw-alias-bg-layer-3)}
+.dsn-prompt-item.active{background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-primary);
+  border-color:var(--dsw-alias-border-l2)}
+.dsn-prompt-pane{flex:1;min-width:0;display:flex;flex-direction:column;gap:8px}
+.dsn-prompt-when{font-size:11px;color:var(--dsw-alias-label-secondary)}
+.dsn-prompt-text{flex:1;margin:0;overflow:auto;white-space:pre-wrap;word-break:break-word;
+  font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;line-height:1.65;
+  padding:10px 12px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);
+  background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-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}
@@ -857,6 +870,85 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             }, busy ? t('保存中…', "Saving…") : t('保存', "Save")))));
     }
 
+    /**
+     * Read-only view of every prompt the plugin sends, with the work's own text
+     * replaced by placeholders. The Host renders the real builders, so what is
+     * shown here is the actual structure — it cannot drift from what is sent.
+     */
+    function PromptsDialog({ project, onCancel }) {
+      const [data, setData] = useState(null);
+      const [active, setActive] = useState('');
+      const [error, setError] = useState('');
+      const [copied, setCopied] = useState(false);
+
+      useEffect(() => {
+        let alive = true;
+        (async () => {
+          try {
+            const result = await api('/prompts/template', { projectId: project.projectId });
+            if (!alive) return;
+            setData(result);
+            setActive(result.modules && result.modules.length ? result.modules[0].id : '');
+          } catch (loadError) {
+            if (alive) setError(messageOf(loadError));
+          }
+        })();
+        return () => { alive = false; };
+      }, [project.projectId]);
+
+      const modules = data ? data.modules : [];
+      const current = modules.find((entry) => entry.id === active) || modules[0] || null;
+
+      const copy = useCallback(async () => {
+        if (!current) return;
+        try {
+          await navigator.clipboard.writeText(current.text);
+          setCopied(true);
+          setTimeout(() => setCopied(false), 1500);
+        } catch {
+          setCopied(false);
+        }
+      }, [current]);
+
+      return h('div', { className: 'dsn-dialog-backdrop' },
+        h('div', { className: 'dsn-dialog', style: { width: 'min(980px, calc(100% - 48px))' } },
+          h('div', { className: 'dsn-dialog-head' },
+            h('div', { className: 'dsn-title' }, t('提示词一览', 'Prompts')),
+            h('div', { className: 'dsn-sub' }, project.title),
+            h('div', { className: 'dsn-spacer' }),
+            h('button', { className: 'dsn-btn ghost', type: 'button', onClick: onCancel }, t('关闭', 'Close'))),
+          h('div', { className: 'dsn-prompt-body' },
+            h('div', { className: 'dsn-prompt-list' },
+              modules.map((entry) => h('button', {
+                key: entry.id,
+                type: 'button',
+                className: `dsn-prompt-item${entry.id === active ? ' active' : ''}`,
+                onClick: () => setActive(entry.id),
+              }, entry.title))),
+            h('div', { className: 'dsn-prompt-pane' },
+              current
+                ? h(React.Fragment, null,
+                  h('div', { className: 'dsn-prompt-when' }, current.when),
+                  h('pre', { className: 'dsn-prompt-text' }, current.text))
+                : null,
+              error ? h('div', { className: 'dsn-hint warn' }, error) : null,
+              data && data.settings
+                ? h('div', { className: 'dsn-hint' },
+                  t('当前设置：前文参考程度 = {ref}；前置提示词 = {prelude}；快照间隔 = 每 {days} 天',
+                    'Current settings: previous-text reference = {ref}; preface = {prelude}; snapshot interval = every {days} days',
+                    {
+                      ref: data.settings.referenceLabel,
+                      prelude: data.settings.preludeSet ? t('已设置', 'set') : t('未设置', 'not set'),
+                      days: data.settings.unitDays,
+                    }))
+                : null)),
+          h('div', { className: 'dsn-dialog-foot' },
+            h('div', { className: 'dsn-hint' }, t('只读：花括号 ｛｝ 里是活数据占位，实际生成时会替换成你的内容。', 'Read-only: text in ｛｝ is a placeholder for live data, replaced with your own content when generating.')),
+            h('div', { className: 'dsn-spacer' }),
+            h('button', { className: 'dsn-btn', type: 'button', disabled: !current, onClick: copy },
+              copied ? t('已复制', 'Copied') : t('复制全文', 'Copy')))));
+    }
+
     /**
      * The work-wide preface prompt: a narrative angle preset plus anything else
      * the author wants pinned in front of every request. The preset wording comes
@@ -932,7 +1024,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, onImport, onSettings }) {
+    function ProjectsPage({ boot, resolveWorkspace, onOpen, onReload, onEditModel, onEditPreset, onEditPrelude, onImport, onSettings, onPrompts }) {
       const [title, setTitle] = useState('');
       const [cwd, setCwd] = useState('');
       const [preset, setPreset] = useState('');
@@ -1195,6 +1287,15 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
                 onSettings(project);
               },
             }, t('设置', 'Settings')),
+            h('button', {
+              className: 'dsn-btn ghost',
+              type: 'button',
+              title: t('查看插件会发送的全部提示词（只读，变量用占位符）', 'See every prompt the plugin sends (read-only, variables as placeholders)'),
+              onClick: (event) => {
+                event.stopPropagation();
+                onPrompts(project);
+              },
+            }, t('提示词', 'Prompts')),
             h('button', {
               className: 'dsn-btn ghost',
               type: 'button',
@@ -2956,6 +3057,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
       const [preludeTarget, setPreludeTarget] = useState(null);
       const [importTarget, setImportTarget] = useState(null);
       const [settingsTarget, setSettingsTarget] = useState(null);
+      const [promptsTarget, setPromptsTarget] = useState(null);
       // Import's outline sync can move chapters too; the notice belongs here
       // because the import dialog closes before the shift is known.
       const [shiftNotice, setShiftNotice] = useState(null);
@@ -3054,6 +3156,7 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
                   onEditPrelude: setPreludeTarget,
                   onImport: setImportTarget,
                   onSettings: setSettingsTarget,
+                  onPrompts: setPromptsTarget,
                 }))
               : detail === null
                 ? h('div', { className: 'dsn-empty', style: { margin: 'auto' } }, t('正在载入作品…', "Loading the work…"))
@@ -3125,6 +3228,12 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             },
           })
           : null,
+        promptsTarget
+          ? h(PromptsDialog, {
+            project: promptsTarget,
+            onCancel: () => setPromptsTarget(null),
+          })
+          : null,
         settingsTarget
           ? h(SettingsDialog, {
             project: settingsTarget,

package/index.js

@@ -1575,7 +1575,7 @@ async function bootstrap(ctx, root) {
     }
   }
   return {
-    revision: '2026-10-29.4',
+    revision: '2026-10-30.3',
     projects,
     models: {
       default: modelCatalog.default || null,
@@ -2665,6 +2665,159 @@ async function startStyleApply(ctx, root, registry, body) {
   });
 }
 
+/* ------------------------------------------------------ prompt templates */
+
+/**
+ * A stand-in project whose *content* is placeholder text.
+ *
+ * The point is that the panel renders the real prompt builders instead of a
+ * hand-written copy of them: the structure can never drift from what is actually
+ * sent, and the author's own text is never read or echoed.
+ */
+function placeholderProject(project) {
+  const snapshot = {
+    snapshotId: 'placeholder',
+    day: 30,
+    createdAt: 0,
+    unitDays: 30,
+    world: '｛世界观：随故事推进更新的设定｝',
+    characters: [{ name: '｛角色名｝', desc: '｛身份、处境、变化｝' }],
+    factions: [{ name: '｛势力名｝', desc: '｛当前状态｝' }],
+    // Relations are stored as plain strings ("A B 师徒"), which is what the
+    // snapshot prompt asks the model for; the placeholder has to match.
+    relations: ['｛角色A｝ ｛角色B｝ ｛关系，例如 师徒｝'],
+    items: [{ name: '｛物品名｝', desc: '｛下落或用途｝' }],
+    events: [{ day: 20, title: '｛事件标题｝', desc: '｛一句话经过｝' }],
+    summary: '｛这段时间的梗概｝',
+  };
+  const previous = {
+    chapterId: 'placeholder-previous',
+    index: 0,
+    title: '｛上一章标题｝',
+    startDay: 30,
+    durationDays: 30,
+    wordCount: 0,
+    status: 'generated',
+    createdAt: 0,
+    updatedAt: 0,
+    content: '｛上一章正文：按你的「前文参考程度」决定给多少｝',
+    outline: {
+      synopsis: '｛上一章梗概｝',
+      minWords: 800,
+      maxWords: 3000,
+      durationDays: 30,
+      synopsisMinChars: 100,
+      savedAt: 0,
+    },
+  };
+  const current = {
+    chapterId: 'placeholder-current',
+    index: 1,
+    title: '｛本章标题｝',
+    startDay: 60,
+    durationDays: 30,
+    wordCount: 0,
+    status: 'outlined',
+    createdAt: 0,
+    updatedAt: 0,
+    content: '',
+    outline: {
+      synopsis: '｛本章梗概：你在大纲页填写的内容｝',
+      minWords: 800,
+      maxWords: 3000,
+      durationDays: 30,
+      synopsisMinChars: 100,
+      savedAt: 0,
+    },
+  };
+  return {
+    ...project,
+    prelude: { mode: 'custom', text: '｛本书前置提示词：你在「前置」里写的文本｝', updatedAt: 0 },
+    snapshots: [snapshot],
+    chapters: [previous, current],
+    timeline: { ...(project.timeline || {}), unitDays: 30 },
+    reference: normalizeReference(project.reference),
+  };
+}
+
+/** Every prompt the plugin sends, rendered against placeholder content. */
+function promptTemplates(project) {
+  const stub = placeholderProject(project);
+  const [previous, current] = stub.chapters;
+  const mode = normalizeReference(project.reference);
+  const modules = [
+    {
+      id: 'prelude',
+      title: '本书前置设定',
+      when: '写正文 / 自动推演 / AI 修改正文 / AI 修改梗概 / 提取行文风格 / 整理前置 —— 都会放在最前面',
+      text: preludeBlock(stub),
+    },
+    {
+      id: 'chapter',
+      title: '写章节正文',
+      when: '点「生成章节故事」，或「自动推演」走到写正文那一步',
+      text: chapterPrompt(stub, current, previous),
+    },
+    {
+      id: 'deduce',
+      title: '自动推演大纲',
+      when: '点「自动推演」（先推梗概、标题、时长与字数范围）',
+      text: deducePrompt(stub, current),
+    },
+    {
+      id: 'snapshot',
+      title: '世界快照',
+      when: '点「生成世界快照」，或章节推进到网格点时自动触发',
+      text: snapshotPrompt(stub, stub.snapshots[0], [previous], 60),
+    },
+    {
+      id: 'syncOutline',
+      title: '同步章节大纲',
+      when: '点「同步章节大纲」，或导入章节时勾选了自动同步',
+      text: syncOutlinePrompt(stub, current, '｛本章正文｝'),
+    },
+    {
+      id: 'revise',
+      title: 'AI 修改正文',
+      when: '故事页点「AI 修改」并填入修改意见',
+      text: revisePrompt(stub, current, '｛本章现有正文｝', '｛你填的修改意见｝'),
+    },
+    {
+      id: 'synopsisRevise',
+      title: 'AI 修改梗概',
+      when: '大纲页点「AI 修改梗概」并填入修改意见',
+      text: synopsisRevisePrompt(stub, current, '｛现有故事梗概｝', '｛你填的修改意见｝'),
+    },
+    {
+      id: 'styleExtract',
+      title: '提取行文风格',
+      when: '故事页点「提取行文风格」',
+      text: styleExtractPrompt(stub, current, '｛本章正文：至少 300 字才会提取｝'),
+    },
+    {
+      id: 'styleMerge',
+      title: '整理进前置',
+      when: '风格面板里点「写入前置」',
+      text: styleMergePrompt('｛现有前置提示词｝', '｛提取出的行文风格｝'),
+    },
+  ];
+  return {
+    modules,
+    settings: {
+      reference: mode,
+      referenceLabel: { full: '前一章全文', half: '前一章的后一半', none: '不参考正文' }[mode],
+      preludeSet: Boolean(project.prelude && project.prelude.text),
+      unitDays: Math.max(1, Number(project.timeline && project.timeline.unitDays) || 30),
+    },
+  };
+}
+
+async function readPromptTemplates(root, body) {
+  const projectId = asText(body.projectId);
+  const project = await readProject(root, projectId);
+  return promptTemplates(project);
+}
+
 async function updateTimeline(root, body) {
   const projectId = asText(body.projectId);
   const unitDays = Number(body.unitDays);
@@ -3513,6 +3666,8 @@ async function dispatch(ctx, root, registry, method, path, url, body) {
       return startStyleApply(ctx, root, registry, body);
     case '/project/settings':
       return updateSettings(root, body);
+    case '/prompts/template':
+      return readPromptTemplates(root, body);
     case '/import/apply':
       return startImportChapters(ctx, root, registry, body);
     case '/outline/revise':

package/package.json

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