@waterwx/dsh-novel-forge 1.3.0 → 1.3.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@waterwx/dsh-novel-forge",
   "description": "AI 编译小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan chapters with LLM, generate chapter by chapter (3000-4000 chars each), and save every chapter as Markdown into your chosen output folder.",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -81,6 +81,7 @@
     "lib/**/*.d.ts",
     "lib/**/*.d.ts.map",
     "src",
+    "scripts",
     "cordis.patch.yml",
     "README.md"
   ],

package/scripts/assistant-frames.txt

@@ -0,0 +1,8 @@
+{"type":"tool","name":"outline_replace","status":"start"}
+{"type":"tool","name":"outline_replace","status":"error","detail":"大纲中未找到片段「第1卷《杂役墟醒》：开局底层发育，穿越与古玉认主落地，墟境规则逐步展开；宗门受欺…」"}
+{"type":"tool","name":"outline_text","status":"start"}
+{"type":"tool","name":"outline_text","status":"done","detail":"《归墟玉主》\n200 万字完整版 · 官方全书大纲（最终定稿）\n一、全书基础档案\n书名：归墟玉主\n题材：穿越修仙、苟道发育、秘境冒险、收集养成、炼丹炼器、渔翁得利爽文\n总规划字数：200 万字\n单章篇幅：3000–4000 字\n总章节区间：520–550 章\n核心对标风格\n资源闭环玩法：原材料采集 → 成品制作 → 神鼎升华，资源复利滚雪球成长\n长线收集体系：古玉残片解锁墟境功能，持续开放新玩法\n"}
+{"type":"tool","name":"outline_replace","status":"start"}
+{"type":"tool","name":"outline_replace","status":"done","detail":"大纲已修改：替换了 19 字符的片段。"}
+{"type":"delta","text":"第一卷大纲已更新完毕。改动位置在\"第一卷：杂役墟醒 → 主线剧情 → 开篇铺垫\"这一行：\n\n- **原文**：开篇铺垫：外卖穿越、古玉碎护魂完整背景\n- **改后**：开篇铺垫：暴雨送餐夜拾回祖传古玉碎块、碎玉暗藏\"界\"字与低语、穿越时碎玉护魂，完整交代古玉来历并埋设守玉人伏笔\n\n这样\"暴雨天捡到古玉\"的伏笔正式进入大纲，与既有的\"穿越时碎玉护魂\"、\"残缺的界字、守玉人低语\"设定形成三层递进：**雨夜拾玉（现实伏笔）→ 碎玉护魂（穿越金手指）→ 界字低语（上界崩塌秘辛）**，后续第四、五卷回收时逻辑更顺。\n\n需要我接着在正文里落实这个伏笔吗？可以：\n\n1. **检查第1章《暴雨穿界》**——看现有正文是否已有\"雨天拾玉\"桥段，若没有就补一小段自然嵌入；\n2. **调整第2章《滴血认主》**——确保\"界字低语\"在滴血认主时第一次闪现，与大纲呼应。\n\n你希望先做哪一个？或者直接让我先调出第1章正文看看目前写法。"}
+{"type":"done"}

package/scripts/diagnose-adapter.mts

@@ -0,0 +1,81 @@
+/**
+ * Diagnose the adapter directly: instantiate DeepSeekAdapter with resolved
+ * connection facts (key from ~/.dsh/.credentials.yaml) and stream the bible
+ * prompt, printing every chunk. This isolates the adapter from cordis.
+ * Run: node scripts/diagnose-adapter.mjs (from novel-forge dir, using the
+ * profile's node_modules via the harness loader).
+ */
+import { readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { DeepSeekAdapter } from '@deepseek-ai/dsh-llm-deepseek'
+import { createUserMessage } from '@deepseek-ai/dsh-llm'
+
+const creds = readFileSync(join(homedir(), '.dsh', '.credentials.yaml'), 'utf8')
+const m = /DEEPSEEK_API_KEY:\s*(.+)/.exec(creds)
+if (!m) { console.error('no key found'); process.exit(1) }
+const apiKey = m[1].trim()
+
+const outline = readFileSync('D:\\ryan work\\harness\\plugins\\novel-forge\\scripts\\outline-sample.txt', 'utf8')
+
+const system = [
+  '你是一位资深网文编辑兼设定架构师。你会收到一份小说大纲，请把它提炼成结构化的「设定圣经」(Story Bible)，供后续写作时严格引用。',
+  '要求：',
+  '1. 忠于大纲，不自行发明大纲之外的设定。',
+  '2. 角色卡覆盖大纲明确出现的角色（主角必含），每个角色给出性格标签、目标、关键关系。',
+  '3. 世界规则覆盖力量体系、金手指机制、势力、地理等所有硬性规则，逐条列出。',
+  '4. 红线列出大纲中明确禁止的内容（如无后宫、不圣母、无无脑碾压等）。',
+  '5. 风格列出叙事基调、节奏、POV 等写作风格要点。',
+  '输出必须是合法 JSON 对象，不要输出任何其他文字或 Markdown 代码块标记。',
+  '重要：所有字符串值内部不得包含换行符（不要用多行字符串），JSON 必须在一段内完整结束。',
+  'JSON 结构：',
+  '{"genre": "题材与基调一句话", "worldRules": ["规则1", "规则2", ...], "characters": [{"name": "角色名", "role": "protagonist|supporting|antagonist|other", "traits": ["标签1", ...], "goals": "目标与动机", "relations": "关键关系"}], "redLines": ["红线1", ...], "style": ["风格1", ...]}',
+].join('\n')
+
+const adapter = new DeepSeekAdapter({
+  options: () => ({
+    baseURL: 'https://api.deepseek.com',
+    apiKeyEnv: 'DEEPSEEK_API_KEY',
+    defaultContextWindow: 1000000,
+    maxTokens: 256000,
+    streamIdleTimeoutMs: 300000,
+    thinking: 'enabled',
+    reasoningEffort: 'high',
+    models: [],
+  }),
+  resolveApiKey: async () => apiKey,
+  resolveUserId: () => ({ id: 'diagnose' }),
+})
+
+const messages = [createUserMessage({
+  content: [{ type: 'text', text: `请为下面这部小说提炼设定圣经：\n\n${outline}` }],
+  source: { kind: 'plugin', plugin: 'dsh-novel-forge' },
+})]
+
+console.log('adapter.stream()...')
+let textLen = 0
+let reasoningLen = 0
+let blocks = 0
+let finish: unknown
+try {
+  for await (const chunk of adapter.stream({
+    provider: 'deepseek-official',
+    model: 'deepseek-v4-flash',
+    messages: messages as never,
+    system,
+    maxTokens: 16000,
+    temperature: 0.4,
+  } as never)) {
+    if (chunk.type === 'text-delta') textLen += chunk.text.length
+    else if (chunk.type === 'reasoning-delta') reasoningLen += chunk.text.length
+    else if (chunk.type === 'block-end') blocks++
+    else if (chunk.type === 'finish') finish = chunk.reason
+  }
+  console.log('text chars:', textLen)
+  console.log('reasoning chars:', reasoningLen)
+  console.log('blocks:', blocks)
+  console.log('finish:', JSON.stringify(finish))
+} catch (error) {
+  console.error('stream threw:', (error as Error).message)
+}
+process.exit(0)

package/scripts/diagnose-assistant.mjs

@@ -0,0 +1,58 @@
+/**
+ * Diagnose the assistant stream with node: POST a message, save all frames
+ * to a file, print a summary (frame types + sample texts).
+ */
+import { writeFileSync } from 'node:fs'
+
+const BASE = 'http://127.0.0.1:3080'
+
+async function main() {
+  const message = process.argv[2] ?? '把大纲第一段的剧情要点改一下：加一个下雨天主角捡到古玉的伏笔'
+  console.log('message:', message)
+
+  const response = await fetch(BASE + '/api/dsh-novel-forge/assistant', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ message }),
+  })
+  console.log('HTTP', response.status)
+  const text = await response.text()
+  writeFileSync('D:\\ryan work\\harness\\plugins\\novel-forge\\scripts\\assistant-frames.txt', text, 'utf8')
+
+  const frames = text.split('\n').filter(l => l.trim() !== '')
+  console.log('frames:', frames.length)
+  let deltas = 0
+  let toolDeltas = 0
+  let tools = 0
+  let done = 0
+  let errors = 0
+  let toolDeltaChars = 0
+  for (const line of frames) {
+    try {
+      const f = JSON.parse(line)
+      if (f.type === 'delta') deltas++
+      else if (f.type === 'toolDelta') { toolDeltas++; toolDeltaChars += f.text.length }
+      else if (f.type === 'tool') { tools++; if (tools <= 6) console.log('  tool:', f.status, f.name, String(f.detail ?? '').slice(0, 120)) }
+      else if (f.type === 'done') done++
+      else if (f.type === 'error') { errors++; console.log('  ERROR:', f.message) }
+    } catch { /* skip */ }
+  }
+  console.log('delta frames:', deltas)
+  console.log('toolDelta frames:', toolDeltas, '(', toolDeltaChars, 'chars )')
+  console.log('tool frames:', tools)
+  console.log('done:', done, 'errors:', errors)
+
+  // Print the first delta frame head and any action tag seen in deltas.
+  for (const line of frames) {
+    try {
+      const f = JSON.parse(line)
+      if (f.type === 'delta' && f.text.includes('<dsh-action')) {
+        console.log('--- delta containing action tag ---')
+        console.log(f.text.slice(0, 400))
+        break
+      }
+    } catch { /* skip */ }
+  }
+}
+
+main().catch(e => { console.error('FAIL:', e.message); process.exit(1) })

package/scripts/diagnose-bible.mjs

@@ -0,0 +1,72 @@
+/**
+ * Diagnostic: call the DeepSeek API directly with the exact bible prompt to
+ * see what the model actually returns (content? reasoning-only? empty?).
+ * Run: node scripts/diagnose-bible.mjs
+ */
+import { readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+// Read the API key from ~/.dsh/.credentials.yaml (simple line parse).
+const creds = readFileSync(join(homedir(), '.dsh', '.credentials.yaml'), 'utf8')
+const m = /DEEPSEEK_API_KEY:\s*(.+)/.exec(creds)
+if (!m) { console.error('no key found'); process.exit(1) }
+const apiKey = m[1].trim()
+
+const outline = readFileSync('D:\\ryan work\\harness\\plugins\\novel-forge\\scripts\\outline-sample.txt', 'utf8')
+
+const system = [
+  '你是一位资深网文编辑兼设定架构师。你会收到一份小说大纲，请把它提炼成结构化的「设定圣经」(Story Bible)，供后续写作时严格引用。',
+  '要求：',
+  '1. 忠于大纲，不自行发明大纲之外的设定。',
+  '2. 角色卡覆盖大纲明确出现的角色（主角必含），每个角色给出性格标签、目标、关键关系。',
+  '3. 世界规则覆盖力量体系、金手指机制、势力、地理等所有硬性规则，逐条列出。',
+  '4. 红线列出大纲中明确禁止的内容（如无后宫、不圣母、无无脑碾压等）。',
+  '5. 风格列出叙事基调、节奏、POV 等写作风格要点。',
+  '输出必须是合法 JSON 对象，不要输出任何其他文字或 Markdown 代码块标记。',
+  '重要：所有字符串值内部不得包含换行符（不要用多行字符串），JSON 必须在一段内完整结束。',
+  'JSON 结构：',
+  '{"genre": "题材与基调一句话", "worldRules": ["规则1", "规则2", ...], "characters": [{"name": "角色名", "role": "protagonist|supporting|antagonist|other", "traits": ["标签1", ...], "goals": "目标与动机", "relations": "关键关系"}], "redLines": ["红线1", ...], "style": ["风格1", ...]}',
+].join('\n')
+
+const body = {
+  model: 'deepseek-v4-flash',
+  messages: [
+    { role: 'system', content: system },
+    { role: 'user', content: `请为下面这部小说提炼设定圣经：\n\n${outline}` },
+  ],
+  max_tokens: 16000,
+  temperature: 0.4,
+  stream: false,
+}
+
+console.log('request: model=deepseek-v4-flash max_tokens=16000')
+const t0 = Date.now()
+const response = await fetch('https://api.deepseek.com/chat/completions', {
+  method: 'POST',
+  headers: {
+    'content-type': 'application/json',
+    authorization: `Bearer ${apiKey}`,
+  },
+  body: JSON.stringify(body),
+})
+console.log(`HTTP ${response.status} in ${Date.now() - t0}ms`)
+if (!response.ok) {
+  console.log(await response.text())
+  process.exit(1)
+}
+const data = await response.json()
+const choice = data.choices?.[0]
+console.log('finish_reason:', choice?.finish_reason)
+console.log('message keys:', Object.keys(choice?.message ?? {}))
+const content = choice?.message?.content ?? ''
+const reasoning = choice?.message?.reasoning_content ?? ''
+console.log('content length:', content.length)
+console.log('reasoning length:', reasoning.length)
+console.log('--- content head ---')
+console.log(content.slice(0, 800))
+if (reasoning.length > 0) {
+  console.log('--- reasoning head ---')
+  console.log(reasoning.slice(0, 400))
+}
+console.log('--- usage ---', JSON.stringify(data.usage))

package/scripts/diagnose-harness.mts

@@ -0,0 +1,75 @@
+/**
+ * Diagnose the harness LLM path properly: build a cordis context, mount
+ * LlmRuntime + deepseek plugin, and check what ctx.llm.stream returns.
+ * Run from deepseek-harness-master (has tsx).
+ */
+import { Context } from '@deepseek-ai/cordis'
+import LlmRuntime from '@deepseek-ai/dsh-llm'
+import { createUserMessage, BlockAssembler } from '@deepseek-ai/dsh-llm'
+import * as DeepSeekPlugin from '@deepseek-ai/dsh-llm-deepseek'
+import { readFileSync } from 'node:fs'
+
+const outline = readFileSync('D:\\ryan work\\harness\\plugins\\novel-forge\\scripts\\outline-sample.txt', 'utf8')
+
+const system = [
+  '你是一位资深网文编辑兼设定架构师。你会收到一份小说大纲，请把它提炼成结构化的「设定圣经」(Story Bible)，供后续写作时严格引用。',
+  '1. 忠于大纲，不自行发明大纲之外的设定。',
+  '输出必须是合法 JSON 对象，不要输出任何其他文字。',
+  'JSON 结构：',
+  '{"genre": "题材与基调一句话", "worldRules": ["规则1"], "characters": [], "redLines": [], "style": []}',
+].join('\n')
+
+const ctx = new Context()
+console.log('before plugin, ctx.llm =', typeof ctx.llm)
+ctx.plugin(LlmRuntime)
+console.log('after LlmRuntime, ctx.llm =', typeof ctx.llm)
+try {
+  ctx.plugin(DeepSeekPlugin as never, { reasoningEffort: 'high' } as never)
+  console.log('deepseek plugin applied')
+} catch (error) {
+  console.error('deepseek plugin failed:', (error as Error).message)
+}
+console.log('providers:', JSON.stringify(ctx.llm?.listProviders() ?? 'NO-LLM'))
+
+const messages = [createUserMessage({
+  content: [{ type: 'text', text: `请为下面这部小说提炼设定圣经：\n\n${outline}` }],
+  source: { kind: 'plugin', plugin: 'dsh-novel-forge' },
+})]
+
+const request = {
+  provider: 'deepseek-official',
+  model: 'deepseek-v4-flash',
+  messages,
+  system,
+  maxTokens: 16000,
+  temperature: 0.4,
+}
+
+console.log('calling ctx.llm.stream...')
+const assembler = new BlockAssembler()
+let textLen = 0
+let reasoningLen = 0
+let sawFinish = false
+try {
+  for await (const chunk of ctx.llm.stream(request as never)) {
+    assembler.push(chunk)
+    if (chunk.type === 'text-delta') textLen += chunk.text.length
+    else if (chunk.type === 'reasoning-delta') reasoningLen += chunk.text.length
+    else if (chunk.type === 'finish') sawFinish = true
+  }
+  const blocks = assembler.blocks()
+  console.log('text chars:', textLen)
+  console.log('reasoning chars:', reasoningLen)
+  console.log('assembled blocks:', blocks.map(b => b.type).join(','))
+  console.log('finish:', JSON.stringify(assembler.finish))
+  const text = blocks
+    .filter((block): block is Extract<typeof block, { type: 'text' }> => block.type === 'text')
+    .map(block => block.text)
+    .join('\n')
+    .trim()
+  console.log('complete() would return chars:', text.length)
+  console.log('head:', text.slice(0, 200))
+} catch (error) {
+  console.error('stream threw:', (error as Error).message)
+}
+process.exit(0)