dsh-novel-generator 0.1.25 → 0.1.27

package/README.md

@@ -66,7 +66,9 @@ dsh plugin --profile web add dsh-novel-generator
 
 ## 前置提示词（作品级）
 
-作品列表每行的「前置」可以给一本书设定前置提示：内置「第一人称 / 第三人称限知 / 第三人称全知 / 自定义」四种，选中即填入文本框，文本可自由改写（最多 2000 字）。
+作品列表每行的「前置」可以给一本书设定前置提示：内置「第三人称全知（默认）/ 第三人称限知 / 第一人称 / 自定义」四种，选中即填入文本框，文本可自由改写（最多 2000 字）。
+
+**新建作品默认就带「第三人称全知」那一段**（传统修仙文、禁贴身 POV、环境优先等 6 条），不喜欢可以直接改或清空。
 
 - 每次**生成正文、自动推演、AI 修改**时，这段文本都会以「【本书前置设定】…」的形式放在提示最前面；生成世界快照时不带（那是结构化数据任务）。
 - 保存后**下一次生成就生效**，不需要重建会话——它不依赖会话状态。
@@ -79,6 +81,15 @@ dsh plugin --profile web add dsh-novel-generator
 - 正文为空时按钮不可点，接口也会拒绝（400）；修改意见为空同样拒绝。
 - **重写结果只放进编辑区、不自动保存**，状态变成「未保存」，你确认后再点「保存」——避免 AI 的改动直接覆盖原稿。
 
+## 附属子插件：小说工坊 · 作者预设
+
+另有一个**独立包** `dsh-novel-author-preset`，只负责往 DSH 注册一个 Agent 预设「小说工坊 · 作者」：
+
+- 装上它（`dsh plugin --profile web add dsh-novel-author-preset`），作品列表的「预设」与「设置 → 预设」里就多出这一项，**新建作品默认用它**；
+- 卸掉它，预设立刻消失；已绑定的作品不会因此损坏——重建会话时检测到预设已不在，会自动退回 profile 的默认预设。
+
+预设内容刻意做得很薄：三句人设（你是小说写作者／只输出正文／文风视角篇幅以用户要求为准）+ 关闭运行时上下文 + **不挂任何工具** + 只保留上下文压缩。所有文学倾向都交给作品级「前置提示词」。
+
 ## 迁移、导入与会话
 
 - **改预设**：作品列表每行的「预设」改的是「下次建会话时用哪个预设」。会话在创建时就固定了预设，所以保存后会提示「重建会话后生效」——要立刻换，点同一行的「重建会话」。

package/client.js

@@ -480,31 +480,29 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
             }, busy ? t('保存中…', "Saving…") : t('保存', "Save")))));
     }
 
-    /** Built-in preface prompts; the text is editable after picking one. */
-    const PRELUDE_MODES = [
-      { id: 'first', zh: '第一人称', en: 'First person', text: '全书使用第一人称叙述：只写「我」亲眼所见、亲耳所听、亲身所想，不描写别人的内心活动。' },
-      { id: 'thirdLimited', zh: '第三人称限知', en: 'Third person, limited', text: '全书使用第三人称限知视角：叙述跟随主角，只呈现他能感知到的一切，不越界写其他角色的内心。' },
-      { id: 'thirdOmniscient', zh: '第三人称全知', en: 'Third person, omniscient', text: '全书使用第三人称全知视角：叙述者可以进入任何角色的内心，但每次切换视角都要有场景依据，不要在同一场景里频繁跳视角。' },
-      { id: 'custom', zh: '自定义', en: 'Custom', text: '' },
-    ];
-
     /**
      * The work-wide preface prompt: a narrative angle preset plus anything else
-     * the author wants pinned in front of every request.
+     * the author wants pinned in front of every request. The preset wording comes
+     * from the Host so there is one copy of the text.
      */
-    function PreludeDialog({ project, onCancel, onSaved }) {
+    function PreludeDialog({ project, presets, defaultMode, onCancel, onSaved }) {
+      const modes = Array.isArray(presets) && presets.length ? presets : [];
+      const fallbackMode = defaultMode || 'thirdOmniscient';
       const current = project.prelude || null;
-      const [mode, setMode] = useState(current && current.mode ? current.mode : '');
-      const [text, setText] = useState(current && current.text ? current.text : '');
+      const initialMode = current && current.mode ? current.mode : fallbackMode;
+      const initialPreset = modes.find((entry) => entry.id === initialMode);
+      const [mode, setMode] = useState(initialMode);
+      const [text, setText] = useState(
+        current && current.text ? current.text : (initialPreset && initialPreset.text) || '',
+      );
       const [busy, setBusy] = useState(false);
       const [error, setError] = useState('');
 
       const pickMode = useCallback((id) => {
         setMode(id);
-        const preset = PRELUDE_MODES.find((entry) => entry.id === id);
-        if (preset && preset.text !== '') setText(preset.text);
-        if (id === '') setText('');
-      }, []);
+        const preset = modes.find((entry) => entry.id === id);
+        setText(preset && preset.text ? preset.text : '');
+      }, [modes]);
 
       const save = useCallback(async () => {
         setBusy(true);
@@ -534,14 +532,14 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
                 onChange: (event) => pickMode(event.target.value),
               },
               h('option', { value: '' }, t('不设置', 'Not set')),
-              PRELUDE_MODES.map((entry) => h('option', { key: entry.id, value: entry.id }, t(entry.zh, entry.en))))),
+              modes.map((entry) => h('option', { key: entry.id, value: entry.id }, t(entry.zh, entry.en))))),
             h('label', { className: 'dsn-field span2' },
               h('span', { className: 'dsn-label' }, t('前置提示（可自由修改，最多 2000 字）', 'Preface text (edit freely, up to 2000 characters)')),
               h('textarea', {
                 className: 'dsn-textarea',
-                style: { minHeight: '160px' },
+                style: { minHeight: '200px' },
                 value: text,
-                placeholder: t('每次生成正文、自动推演、AI 修改时都会放在提示最前面。例如：全书用第三人称限知；文风冷峻，少用形容词；不要出现现代网络用语。', 'Added in front of every generation, deduction and revision request. e.g. third-person limited; cold, spare prose; no modern slang.'),
+                placeholder: t('每次生成正文、自动推演、AI 修改时都会放在提示最前面。', 'Added in front of every generation, deduction and revision request.'),
                 onChange: (event) => setText(event.target.value),
               })),
             h('div', { className: 'dsn-hint span2' }, t('已填 {n} / 2000 字；留空即表示这本书不带前置提示。', '{n} / 2000 characters; leave it empty to send no preface.', { n: String(text).length })),
@@ -2340,6 +2338,8 @@ body[data-ds-dark-theme] .dsn-shell{color-scheme:dark}
         preludeTarget
           ? h(PreludeDialog, {
             project: preludeTarget,
+            presets: boot ? boot.preludePresets : [],
+            defaultMode: boot ? boot.defaultPreludeMode : 'thirdOmniscient',
             onCancel: () => setPreludeTarget(null),
             onSaved: async (saved) => {
               setPreludeTarget(null);

package/index.js

@@ -922,6 +922,20 @@ function normalizeSnapshot(raw) {
 
 /* ------------------------------------------------------------ agent work */
 
+/** The preset a work records, but only when the deployment still offers it. */
+async function usablePreset(ctx, presetId) {
+  if (!presetId) return false;
+  const presets = ctx.get('agentPresets');
+  if (!presets || typeof presets.list !== 'function') return true;
+  try {
+    const list = await presets.list();
+    if (!Array.isArray(list) || list.length === 0) return true;
+    return list.some((entry) => entry.id === presetId);
+  } catch {
+    return true;
+  }
+}
+
 /**
  * Bind a fresh session to a work whose old one disappeared (deleted in the
  * sidebar, or gone from the session store). The work's memory — snapshots,
@@ -931,7 +945,12 @@ function normalizeSnapshot(raw) {
 async function rebindSession(ctx, root, project) {
   const controller = ctx.get('sessionController');
   if (controller === undefined) throw httpError(503, '当前部署缺少 sessionController 服务，无法为作品重建会话');
-  const created = await controller.create(project.agentPreset ? { cwd: project.cwd, agentPreset: project.agentPreset } : { cwd: project.cwd });
+  // A preset can disappear when its plugin is uninstalled; falling back to the
+  // profile default keeps the work usable instead of failing every rebuild.
+  const presetOk = await usablePreset(ctx, project.agentPreset);
+  const created = await controller.create(presetOk && project.agentPreset
+    ? { cwd: project.cwd, agentPreset: project.agentPreset }
+    : { cwd: project.cwd });
   const sessionId = created && created.sessionId ? created.sessionId : null;
   if (!sessionId) throw httpError(502, '没能为作品重建会话');
   if (project.model) {
@@ -1477,7 +1496,7 @@ async function bootstrap(ctx, root) {
     }
   }
   return {
-    revision: '2026-10-27.9',
+    revision: '2026-10-27.11',
     projects,
     models: {
       default: modelCatalog.default || null,
@@ -1494,6 +1513,9 @@ async function bootstrap(ctx, root) {
       failures: modelCatalog.failures || [],
     },
     presets: presetList,
+    // Canonical preface wording, so the Client does not keep a second copy.
+    preludePresets: PRELUDE_PRESETS,
+    defaultPreludeMode: DEFAULT_PRELUDE_MODE,
   };
 }
 
@@ -1508,6 +1530,11 @@ async function createProject(ctx, root, body) {
   const cwd = asText(body.cwd);
   if (cwd === '') throw httpError(400, '请先选择作品的工作目录');
   const agentPreset = asText(body.agentPreset) || undefined;
+  // New works prefer the bundled author preset when its plugin is installed, and
+  // otherwise fall back to the profile default instead of failing.
+  const chosenPreset = agentPreset !== undefined && await usablePreset(ctx, agentPreset)
+    ? agentPreset
+    : (await usablePreset(ctx, AUTHOR_PRESET_ID) ? AUTHOR_PRESET_ID : undefined);
   const model = body.model && asText(body.model.provider) && asText(body.model.model)
     ? {
       provider: asText(body.model.provider),
@@ -1526,7 +1553,7 @@ async function createProject(ctx, root, body) {
     throw httpError(400, `无法在工作目录下创建作品文件夹：${error instanceof Error ? error.message : String(error)}`);
   }
 
-  const created = await controller.create(agentPreset === undefined ? { cwd } : { cwd, agentPreset });
+  const created = await controller.create(chosenPreset === undefined ? { cwd } : { cwd, agentPreset: chosenPreset });
   const sessionId = created && created.sessionId ? created.sessionId : null;
   let warning = null;
   if (sessionId && model) {
@@ -1543,8 +1570,11 @@ async function createProject(ctx, root, body) {
     projectId,
     title,
     cwd,
-    agentPreset: agentPreset || created.agentPreset || null,
+    agentPreset: chosenPreset || created.agentPreset || null,
     model,
+    // Every new work starts with the default narrative preface; the author can
+    // edit or clear it from the work list.
+    prelude: defaultPrelude(),
     sessionId,
     createdAt: Date.now(),
     updatedAt: Date.now(),
@@ -1865,6 +1895,57 @@ async function createSessionFor(ctx, root, project) {
 /** Longest preface prompt accepted, in characters. */
 const PRELUDE_MAX_CHARS = 2000;
 
+/**
+ * Built-in preface prompts. The Host owns the canonical wording, so the Client,
+ * the creation default and any migration all read the same text.
+ */
+const PRELUDE_PRESETS = [
+  {
+    id: 'thirdOmniscient',
+    zh: '第三人称全知',
+    en: 'Third person, omniscient',
+    text: [
+      '写作要求：传统修仙文第三人称叙事，参考忘语《凡人修仙传》风格，禁止贴身 POV 视角。',
+      '',
+      '1. 叙事优先用环境、场景作为句子开头，不要每一句都从主角的感受出发；',
+      '2. 控制“他”字的出现频率，不要大量以“他”开头造句；',
+      '3. 描写动作、环境、事件为主，不要细碎拆解主角每一丝触觉、听觉；',
+      '4. 可以写主角的反应，但不要连续堆砌“他看见、他听见、他感到”；',
+      '5. 句子连贯，不要大量一句一段的超短碎句；',
+      '6. 以作者旁白来铺陈场景，把感官描写融入环境，不要单独拎出来写角色内心感受。',
+    ].join('\n'),
+  },
+  {
+    id: 'thirdLimited',
+    zh: '第三人称限知',
+    en: 'Third person, limited',
+    text: '全书使用第三人称限知视角：叙述跟随主角，只呈现他能感知到的一切，不越界写其他角色的内心。',
+  },
+  {
+    id: 'first',
+    zh: '第一人称',
+    en: 'First person',
+    text: '全书使用第一人称叙述：只写「我」亲眼所见、亲耳所听、亲身所想，不描写别人的内心活动。',
+  },
+  {
+    id: 'custom',
+    zh: '自定义',
+    en: 'Custom',
+    text: '',
+  },
+];
+
+/** The preface a fresh work starts with. */
+const DEFAULT_PRELUDE_MODE = 'thirdOmniscient';
+
+/** Preset id contributed by the optional `dsh-novel-author-preset` sub-plugin. */
+const AUTHOR_PRESET_ID = 'novel-studio-author';
+
+function defaultPrelude() {
+  const preset = PRELUDE_PRESETS.find((entry) => entry.id === DEFAULT_PRELUDE_MODE);
+  return preset ? { mode: preset.id, text: preset.text, updatedAt: Date.now() } : null;
+}
+
 /**
  * Save one work's preface prompt. `mode` only labels which preset the text came
  * from; the text itself is what every request carries, so the author can edit a

package/package.json

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