@waterwx/dsh-novel-forge 0.1.0

package/src/client/api.ts

@@ -0,0 +1,254 @@
+/**
+ * Browser-side API client for the /api/dsh-novel-forge route family. Plain
+ * fetch, same origin; generation/rewrite/polish ride NDJSON streams read
+ * incrementally.
+ */
+
+import {
+  NOVEL_API,
+  type AssetsPatch,
+  type AssetsResponse,
+  type BibleResponse,
+  type ChapterResponse,
+  type ConfigPatch,
+  type ExportResponse,
+  type ForeshadowRequest,
+  type ForeshadowResponse,
+  type JobFrame,
+  type LoadOutlineResponse,
+  type NovelConfig,
+  type PlanResponse,
+  type ReviewReport,
+  type StatusResponse,
+  type StyleEngineRequest,
+  type StyleAsset,
+  type VolumesResponse,
+} from '../protocol.ts'
+
+/** Error carrying the route's JSON error message. */
+export class NovelApiError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = 'NovelApiError'
+  }
+}
+
+/** Parse a JSON response or throw a NovelApiError. */
+async function readJson<T>(response: Response): Promise<T> {
+  let body: unknown
+  try {
+    body = await response.json()
+  } catch {
+    throw new NovelApiError(`HTTP ${response.status}: invalid JSON response`)
+  }
+  if (!response.ok) {
+    const message = typeof body === 'object' && body !== null && typeof (body as { error?: unknown }).error === 'string'
+      ? (body as { error: string }).error
+      : `HTTP ${response.status}`
+    throw new NovelApiError(message)
+  }
+  return body as T
+}
+
+/** POST JSON, return parsed JSON. */
+async function postJson<T>(path: string, payload: unknown): Promise<T> {
+  const response = await fetch(path, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify(payload),
+  })
+  return readJson<T>(response)
+}
+
+/** The browser half's only data entry point. */
+export class NovelApi {
+  async status(): Promise<StatusResponse> {
+    const response = await fetch(NOVEL_API.status)
+    return readJson<StatusResponse>(response)
+  }
+
+  async loadOutline(path?: string, text?: string): Promise<LoadOutlineResponse> {
+    return postJson<LoadOutlineResponse>(NOVEL_API.loadOutline, { path, text })
+  }
+
+  async saveOutline(text: string): Promise<{ ok: boolean; bookName: string }> {
+    return postJson<{ ok: boolean; bookName: string }>(NOVEL_API.saveOutline, { text })
+  }
+
+  async plan(outline?: string, chapterCount?: number, volume?: number): Promise<PlanResponse> {
+    return postJson<PlanResponse>(NOVEL_API.plan, { outline, chapterCount, volume })
+  }
+
+  async volumes(outline?: string): Promise<VolumesResponse> {
+    return postJson<VolumesResponse>(NOVEL_API.volumes, { outline })
+  }
+
+  async bible(outline?: string): Promise<BibleResponse> {
+    return postJson<BibleResponse>(NOVEL_API.bible, { outline })
+  }
+
+  async review(chapterNo: number): Promise<{ report: ReviewReport }> {
+    return postJson<{ report: ReviewReport }>(NOVEL_API.review, { chapterNo })
+  }
+
+  async summarize(chapterNo: number): Promise<{ summary: string }> {
+    return postJson<{ summary: string }>(NOVEL_API.summary, { chapterNo })
+  }
+
+  async foreshadow(req: ForeshadowRequest): Promise<ForeshadowResponse> {
+    return postJson<ForeshadowResponse>(NOVEL_API.foreshadow, req)
+  }
+
+  async exportBook(format: 'txt' | 'md'): Promise<ExportResponse> {
+    return postJson<ExportResponse>(NOVEL_API.exportBook, { format })
+  }
+
+  async chapter(no: number): Promise<ChapterResponse> {
+    const response = await fetch(`${NOVEL_API.chapter}?no=${no}`)
+    return readJson<ChapterResponse>(response)
+  }
+
+  async patchConfig(patch: ConfigPatch): Promise<{ config: NovelConfig }> {
+    return postJson<{ config: NovelConfig }>(NOVEL_API.config, patch)
+  }
+
+  async openFolder(): Promise<void> {
+    await fetch(NOVEL_API.openFolder, { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' })
+  }
+
+  /** 书架快照。 */
+  async bookshelf(): Promise<import('../protocol.ts').BookshelfSnapshot> {
+    const response = await fetch(NOVEL_API.bookshelf)
+    return readJson<import('../protocol.ts').BookshelfSnapshot>(response)
+  }
+
+  /** 新建书并激活。 */
+  async bookCreate(bookName: string, outputDir?: string): Promise<import('../protocol.ts').BookshelfSnapshot> {
+    return postJson<import('../protocol.ts').BookshelfSnapshot>(NOVEL_API.bookshelf, { bookName, outputDir })
+  }
+
+  /** 切换当前书。 */
+  async bookActivate(id: string): Promise<import('../protocol.ts').BookshelfSnapshot> {
+    return postJson<import('../protocol.ts').BookshelfSnapshot>('/api/dsh-novel-forge/bookshelf/activate', { id })
+  }
+
+  /** 移除书架条目。 */
+  async bookRemove(id: string): Promise<import('../protocol.ts').BookshelfSnapshot> {
+    return postJson<import('../protocol.ts').BookshelfSnapshot>('/api/dsh-novel-forge/bookshelf/remove', { id })
+  }
+
+  /** Get project writing assets + built-in libraries. */
+  async assets(): Promise<AssetsResponse> {
+    const response = await fetch(NOVEL_API.assets)
+    return readJson<AssetsResponse>(response)
+  }
+
+  /** Patch project writing assets. */
+  async patchAssets(patch: AssetsPatch): Promise<AssetsResponse> {
+    return postJson<AssetsResponse>(NOVEL_API.assets, patch)
+  }
+
+  /** Extract a style asset from sample text. */
+  async styleEngine(req: StyleEngineRequest): Promise<{ styleAsset: StyleAsset }> {
+    return postJson<{ styleAsset: StyleAsset }>(NOVEL_API.styleEngine, req)
+  }
+
+  /**
+   * Consume an NDJSON job stream (generate / rewrite / polish).
+   * @param path - the route to POST to.
+   * @param payload - the JSON body.
+   * @param onFrame - receives every frame as it lands.
+   */
+  private async streamJob(path: string, payload: unknown, onFrame: (frame: JobFrame) => void): Promise<void> {
+    const response = await fetch(path, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify(payload),
+    })
+    if (!response.ok) {
+      await readJson<{ error?: string }>(response)
+      return
+    }
+    if (response.body === null) throw new NovelApiError('job: no response body')
+    const reader = response.body.getReader()
+    const decoder = new TextDecoder()
+    let buffer = ''
+    for (;;) {
+      const { done, value } = await reader.read()
+      if (done) break
+      buffer += decoder.decode(value, { stream: true })
+      const lines = buffer.split('\n')
+      buffer = lines.pop() ?? ''
+      for (const line of lines) {
+        if (line.trim() === '') continue
+        let frame: JobFrame
+        try {
+          frame = JSON.parse(line) as JobFrame
+        } catch {
+          continue
+        }
+        onFrame(frame)
+        if (frame.type === 'error') {
+          throw new NovelApiError(frame.message)
+        }
+      }
+    }
+  }
+
+  /** Generate one chapter. */
+  async generate(chapterNo: number, skipReview: boolean, onFrame: (frame: JobFrame) => void): Promise<void> {
+    await this.streamJob(NOVEL_API.generate, { chapterNo, skipReview }, onFrame)
+  }
+
+  /** Rewrite one chapter (whole-chapter, or local when `target` is given). */
+  async rewrite(chapterNo: number, instructions: string, target: string, onFrame: (frame: JobFrame) => void): Promise<void> {
+    await this.streamJob(NOVEL_API.rewrite, { chapterNo, instructions, target }, onFrame)
+  }
+
+  /** Polish (de-AI-ify) one chapter. */
+  async polish(chapterNo: number, onFrame: (frame: JobFrame) => void): Promise<void> {
+    await this.streamJob(NOVEL_API.polish, { chapterNo }, onFrame)
+  }
+
+  /** Run one assistant turn (NDJSON stream). */
+  async assistant(message: string, onFrame: (frame: import('../protocol.ts').AssistantFrame) => void): Promise<void> {
+    const response = await fetch(NOVEL_API.assistant, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ message }),
+    })
+    if (!response.ok) {
+      await readJson<{ error?: string }>(response)
+      return
+    }
+    if (response.body === null) throw new NovelApiError('assistant: no response body')
+    const reader = response.body.getReader()
+    const decoder = new TextDecoder()
+    let buffer = ''
+    for (;;) {
+      const { done, value } = await reader.read()
+      if (done) break
+      buffer += decoder.decode(value, { stream: true })
+      const lines = buffer.split('\n')
+      buffer = lines.pop() ?? ''
+      for (const line of lines) {
+        if (line.trim() === '') continue
+        let frame: import('../protocol.ts').AssistantFrame
+        try {
+          frame = JSON.parse(line) as import('../protocol.ts').AssistantFrame
+        } catch {
+          continue
+        }
+        onFrame(frame)
+        if (frame.type === 'error') throw new NovelApiError(frame.message)
+      }
+    }
+  }
+
+  /** Load the persisted assistant conversation. */
+  async assistantHistory(): Promise<import('../protocol.ts').AssistantMessage[]> {
+    const response = await fetch(NOVEL_API.assistantHistory)
+    const body = await readJson<{ messages: import('../protocol.ts').AssistantMessage[] }>(response)
+    return body.messages
+  }
+}

package/src/client/css-modules.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CSS module type shim (bundler injects the class map at build time).
+ */
+
+declare module '*.module.css' {
+  const classes: Record<string, string>
+  export default classes
+}

package/src/client/docx.ts

@@ -0,0 +1,69 @@
+/**
+ * Browser-side docx outline extraction: a .docx is a zip whose
+ * word/document.xml holds the body text in <w:t> runs inside <w:p> paragraphs.
+ * Uses fflate (inlined into the client bundle) so the user can pick or drag a
+ * docx without any server upload.
+ *
+ * Import from 'fflate/browser' (not 'fflate'): the default entry resolves to
+ * the Node build (esm/index.mjs), which calls module.createRequire() for the
+ * optional worker_threads path — inlining that into the browser bundle leaves
+ * a bare require("module") the client-modules table cannot answer.
+ */
+
+import { unzipSync, strFromU8 } from 'fflate/browser'
+
+/** Decode the handful of XML entities docx bodies actually use. */
+function decodeEntities(text: string): string {
+  return text
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&amp;/g, '&')
+    .replace(/&nbsp;/g, ' ')
+}
+
+/** Extract plain text from a docx buffer: one line per <w:p> paragraph. */
+export function extractDocxTextFromBuffer(buffer: ArrayBuffer | Uint8Array): string {
+  const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer)
+  let files: ReturnType<typeof unzipSync>
+  try {
+    files = unzipSync(bytes)
+  } catch (error) {
+    throw new Error(`不是有效的 docx（zip 解压失败）：${(error as Error).message}`)
+  }
+  const document = files['word/document.xml']
+  if (document === undefined) {
+    throw new Error('不是有效的 docx（缺少 word/document.xml）')
+  }
+  const xml = strFromU8(document)
+
+  const paragraphs: string[] = []
+  const parts = xml.split(/<w:p\b[^>]*>/)
+  for (let i = 1; i < parts.length; i++) {
+    const segment = parts[i]!
+    const runs: string[] = []
+    const runRe = /<w:t(?:\s[^>]*)?>([\s\S]*?)<\/w:t>|<w:tab\b[^>]*\/>|<w:br\b[^>]*\/>/g
+    for (const match of segment.matchAll(runRe)) {
+      if (match[0].startsWith('<w:tab')) {
+        runs.push('\t')
+      } else if (match[0].startsWith('<w:br')) {
+        runs.push('\n')
+      } else {
+        runs.push(decodeEntities(match[1] ?? ''))
+      }
+    }
+    paragraphs.push(runs.join('').replace(/\u00a0/g, ' ').trimEnd())
+  }
+
+  const text = paragraphs.join('\n').replace(/\n{3,}/g, '\n\n').trim()
+  if (text.length === 0) {
+    throw new Error('docx 中没有可提取的文本')
+  }
+  return text
+}
+
+/** Read a File as ArrayBuffer. */
+export function readFileAsArrayBuffer(file: File): Promise<ArrayBuffer> {
+  return file.arrayBuffer()
+}

package/src/client/index.ts

@@ -0,0 +1,34 @@
+/**
+ * Browser-half entry for the dsh-novel-forge plugin — runs inside the dsh web
+ * GUI. Registers the sidebar entry row and the workbench panel. DOM mounting
+ * problems are logged, never thrown — the web shell fails the whole boot when
+ * a plugin apply throws.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import { NovelApi } from './api.ts'
+import { mountPanel } from './mount.tsx'
+import { PanelController } from './panel/controller.ts'
+import { mountSidebarEntry } from './sidebar-entry.ts'
+
+/** Required services (fiber inject waiting). */
+export const inject = ['slots', 'locale']
+
+/**
+ * Mount the novel-forge workbench.
+ * @param ctx - client root context.
+ */
+export function apply(ctx: ClientContext): void {
+  const controller = new PanelController()
+  const api = new NovelApi()
+  const disposers: Array<() => void> = []
+  try {
+    disposers.push(mountSidebarEntry(controller))
+    disposers.push(mountPanel(controller, api))
+  } catch (error) {
+    // DOM failures degrade the panel, never the GUI.
+    console.warn('[dsh-novel-forge] mount failed:', error)
+  }
+  ctx.effect(() => () => {
+    for (const dispose of disposers.splice(0)) dispose()
+  }, 'dsh-novel-forge: ui mounts')
+}

package/src/client/locales.ts

@@ -0,0 +1,271 @@
+/**
+ * dsh-novel-forge — locale dictionaries (zh / en).
+ */
+
+/** zh dictionary. */
+export const zh = {
+  'entry.label': '小说工坊',
+  'entry.tooltip': 'AI 编译小说工作台：大纲 → 设定圣经 → 卷计划 → 章节计划 → 逐章生成+审稿',
+  'panel.title': '小说工坊',
+  'common.close': '关闭',
+  'common.loading': '加载中…',
+  'common.save': '保存',
+  'common.error': '错误',
+  'common.success': '成功',
+  'common.generating': '生成中…',
+  'common.chars': '字',
+  'tab.workflow': '工作流',
+  'tab.overview': '大纲',
+  'tab.plan': '章节',
+  'tab.bible': '设定库',
+  'tab.foreshadow': '伏笔',
+  'tab.assistant': 'AI 助手',
+  'tab.settings': '设置',
+  'workflow.title': '创作工作流',
+  'workflow.step1': '① 加载大纲',
+  'workflow.step2': '② 提炼设定圣经',
+  'workflow.step3': '③ 规划卷',
+  'workflow.step4': '④ 生成章节计划',
+  'workflow.step5': '⑤ 逐章写作 + AI 审稿',
+  'workflow.step6': '⑥ 润色 / 导出',
+  'workflow.loadOutline': '读取大纲',
+  'workflow.genBible': '提炼设定圣经',
+  'workflow.genVolumes': '生成卷计划',
+  'workflow.genPlan': '生成章节计划',
+  'workflow.done': '已完成',
+  'workflow.todo': '待办',
+  'workflow.bibleDone': '设定圣经已生成（{n} 条规则 / {c} 个角色 / {r} 条红线）',
+  'workflow.volumesDone': '卷计划已生成（{n} 卷）',
+  'workflow.planDone': '章节计划已生成（{n} 章）',
+  'workflow.progress': '进度：大纲 ✓ · 设定 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章',
+  'overview.loadDocx': '从 docx 读取大纲',
+  'overview.loadDocxDefault': '读取默认大纲',
+  'overview.loadingOutline': '正在解析 docx…',
+  'overview.outlineHint': '大纲文本（可编辑）',
+  'overview.outlineChars': '大纲字数',
+  'overview.saveOutline': '保存大纲',
+  'overview.saved': '大纲已保存',
+  'overview.bookName': '书名',
+  'overview.loadCustom': '指定 docx 路径',
+  'overview.loadCustomHint': '绝对路径，留空使用默认',
+  'plan.generate': '生成章节计划',
+  'plan.generateHint': '章节数量',
+  'plan.count': '章',
+  'plan.empty': '暂无章节计划，请先生成',
+  'plan.chapter': '章',
+  'plan.pending': '待生成',
+  'plan.generating': '生成中',
+  'plan.written': '待审稿',
+  'plan.reviewing': '审稿中',
+  'plan.approved': '已通过',
+  'plan.rejected': '待修订',
+  'plan.error': '失败',
+  'plan.write': '生成本章',
+  'plan.rewrite': '修订',
+  'plan.review': '审稿',
+  'plan.polish': '去AI味',
+  'plan.writeAll': '批量生成全部',
+  'plan.writeAllPending': '批量生成剩余',
+  'plan.generated': '已生成',
+  'plan.progress': '进度',
+  'plan.beats': '剧情要点',
+  'plan.reviewReport': '审稿报告',
+  'plan.reviewScore': '评分',
+  'plan.reviewVerdict': '总评',
+  'plan.reviewIssues': '问题清单',
+  'plan.reviewPass': '通过',
+  'plan.reviewFail': '未通过',
+  'plan.approve': '手动通过',
+  'plan.summary': '章节摘要',
+  'plan.volumes': '卷',
+  'plan.noVolume': '未分卷',
+  'bible.title': '设定圣经',
+  'bible.gen': 'AI 提炼设定圣经',
+  'bible.genre': '题材基调',
+  'bible.worldRules': '世界规则',
+  'bible.characters': '角色卡',
+  'bible.redLines': '写作红线',
+  'bible.style': '风格要求',
+  'bible.none': '尚未生成设定圣经。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。',
+  'foreshadow.title': '伏笔管理',
+  'foreshadow.suggest': 'AI 建议伏笔',
+  'foreshadow.none': '暂无伏笔',
+  'foreshadow.status': '状态',
+  'foreshadow.planned': '计划中',
+  'foreshadow.planted': '已埋设',
+  'foreshadow.progressing': '推进中',
+  'foreshadow.resolved': '已回收',
+  'foreshadow.abandoned': '已放弃',
+  'foreshadow.target': '预计回收',
+  'foreshadow.plantedAt': '埋设于',
+  'foreshadow.setPlanted': '标记已埋设',
+  'foreshadow.setResolved': '标记已回收',
+  'settings.title': '设置',
+  'settings.outlinePath': '默认大纲路径',
+  'settings.outputDir': '输出目录',
+  'settings.provider': '模型提供商',
+  'settings.model': '模型',
+  'settings.chapterChars': '每章目标字数',
+  'settings.maxTokens': '单章最大输出 tokens',
+  'settings.reviewPassScore': '审稿通过分数（0-100）',
+  'settings.autoReview': '生成后自动审稿',
+  'settings.save': '保存设置',
+  'settings.saved': '设置已保存',
+  'settings.openFolder': '打开输出文件夹',
+  'settings.export': '导出',
+  'settings.exportTxt': '导出 TXT',
+  'settings.exportMd': '导出 Markdown',
+  'settings.exported': '已导出：{file}（{chars} 字，{chapters} 章）',
+  'progress.generating': '正在生成第 {no} 章《{title}》…',
+  'progress.done': '第 {no} 章完成（{chars} 字）→ {file}',
+  'progress.reviewed': '第 {no} 章审稿：{score} 分 — {verdict}',
+  'progress.error': '第 {no} 章失败：{message}',
+  'progress.rewriting': '正在修订第 {no} 章…',
+  'progress.polishing': '正在润色第 {no} 章…',
+  'progress.empty': '生成/审稿进度将显示在这里',
+  'assistant.hint': '和 AI 编辑讨论剧情、人设、伏笔；达成一致后可让它直接修改大纲、设定圣经、章节内容。',
+  'assistant.placeholder': '例如：我想让第 2 章结尾加一个悬念——墟境里传来爷爷的声音…',
+  'assistant.send': '发送',
+  'assistant.toolStart': '⚙ 执行操作：{name}…',
+  'assistant.toolDone': '✓ {name} 完成：{detail}',
+  'assistant.toolError': '✗ {name} 失败：{detail}',
+  'assistant.empty': '还没有对话。和 AI 编辑聊聊剧情吧。',
+  'status.projectNone': '输出目录中还没有项目。请先加载大纲。',
+  'status.files': '已生成文件',
+  'api.error': '请求失败',
+} as const
+
+/** en dictionary (fallback). */
+export const en: Record<string, string> = {
+  'entry.label': 'Novel Forge',
+  'entry.tooltip': 'AI novel workbench: outline → bible → volumes → plan → write + review',
+  'panel.title': 'Novel Forge',
+  'common.close': 'Close',
+  'common.loading': 'Loading…',
+  'common.save': 'Save',
+  'common.error': 'Error',
+  'common.success': 'Success',
+  'common.generating': 'Generating…',
+  'common.chars': ' chars',
+  'tab.workflow': 'Workflow',
+  'tab.overview': 'Outline',
+  'tab.plan': 'Chapters',
+  'tab.bible': 'Bible',
+  'tab.foreshadow': 'Foreshadow',
+  'tab.settings': 'Settings',
+  'workflow.title': 'Writing workflow',
+  'workflow.step1': '① Load outline',
+  'workflow.step2': '② Extract story bible',
+  'workflow.step3': '③ Plan volumes',
+  'workflow.step4': '④ Plan chapters',
+  'workflow.step5': '⑤ Write + AI review',
+  'workflow.step6': '⑥ Polish / export',
+  'workflow.loadOutline': 'Load outline',
+  'workflow.genBible': 'Extract bible',
+  'workflow.genVolumes': 'Plan volumes',
+  'workflow.genPlan': 'Plan chapters',
+  'workflow.done': 'done',
+  'workflow.todo': 'todo',
+  'workflow.bibleDone': 'Bible ready ({n} rules / {c} characters / {r} red lines)',
+  'workflow.volumesDone': 'Volumes ready ({n})',
+  'workflow.planDone': 'Plan ready ({n} chapters)',
+  'workflow.progress': 'Outline ✓ · bible {bible} · volumes {volumes} · plan {plan} · {done}/{total} chapters',
+  'overview.loadDocx': 'Load outline from docx',
+  'overview.loadDocxDefault': 'Load default outline',
+  'overview.loadingOutline': 'Parsing docx…',
+  'overview.outlineHint': 'Outline text (editable)',
+  'overview.outlineChars': 'Outline length',
+  'overview.saveOutline': 'Save outline',
+  'overview.saved': 'Outline saved',
+  'overview.bookName': 'Book',
+  'overview.loadCustom': 'Custom docx path',
+  'overview.loadCustomHint': 'Absolute path; empty = default',
+  'plan.generate': 'Plan chapters',
+  'plan.generateHint': 'Chapter count',
+  'plan.count': ' chapters',
+  'plan.empty': 'No plan yet — generate one first',
+  'plan.chapter': 'Ch.',
+  'plan.pending': 'pending',
+  'plan.generating': 'writing',
+  'plan.written': 'to review',
+  'plan.reviewing': 'reviewing',
+  'plan.approved': 'approved',
+  'plan.rejected': 'to revise',
+  'plan.error': 'failed',
+  'plan.write': 'Write',
+  'plan.rewrite': 'Revise',
+  'plan.review': 'Review',
+  'plan.polish': 'De-AI',
+  'plan.writeAll': 'Write all',
+  'plan.writeAllPending': 'Write remaining',
+  'plan.generated': 'generated',
+  'plan.progress': 'progress',
+  'plan.beats': 'Beats',
+  'plan.reviewReport': 'Review report',
+  'plan.reviewScore': 'Score',
+  'plan.reviewVerdict': 'Verdict',
+  'plan.reviewIssues': 'Issues',
+  'plan.reviewPass': 'Passed',
+  'plan.reviewFail': 'Failed',
+  'plan.approve': 'Approve',
+  'plan.summary': 'Summary',
+  'plan.volumes': 'Volumes',
+  'plan.noVolume': 'No volume',
+  'bible.title': 'Story bible',
+  'bible.gen': 'Extract bible with AI',
+  'bible.genre': 'Genre',
+  'bible.worldRules': 'World rules',
+  'bible.characters': 'Characters',
+  'bible.redLines': 'Red lines',
+  'bible.style': 'Style',
+  'bible.none': 'No bible yet. Generation and review follow it strictly once extracted.',
+  'foreshadow.title': 'Foreshadowing',
+  'foreshadow.suggest': 'Suggest with AI',
+  'foreshadow.none': 'No foreshadows',
+  'foreshadow.status': 'Status',
+  'foreshadow.planned': 'planned',
+  'foreshadow.planted': 'planted',
+  'foreshadow.progressing': 'progressing',
+  'foreshadow.resolved': 'resolved',
+  'foreshadow.abandoned': 'abandoned',
+  'foreshadow.target': 'target',
+  'foreshadow.plantedAt': 'planted at',
+  'foreshadow.setPlanted': 'Mark planted',
+  'foreshadow.setResolved': 'Mark resolved',
+  'settings.title': 'Settings',
+  'settings.outlinePath': 'Default outline path',
+  'settings.outputDir': 'Output directory',
+  'settings.provider': 'Provider',
+  'settings.model': 'Model',
+  'settings.chapterChars': 'Chars per chapter',
+  'settings.maxTokens': 'Max output tokens',
+  'settings.reviewPassScore': 'Review pass score (0-100)',
+  'settings.autoReview': 'Auto-review after writing',
+  'settings.save': 'Save settings',
+  'settings.saved': 'Settings saved',
+  'settings.openFolder': 'Open output folder',
+  'settings.export': 'Export',
+  'settings.exportTxt': 'Export TXT',
+  'settings.exportMd': 'Export Markdown',
+  'settings.exported': 'Exported: {file} ({chars} chars, {chapters} chapters)',
+  'progress.generating': 'Writing chapter {no} “{title}”…',
+  'progress.done': 'Chapter {no} done ({chars} chars) → {file}',
+  'progress.reviewed': 'Chapter {no} review: {score} — {verdict}',
+  'progress.error': 'Chapter {no} failed: {message}',
+  'progress.rewriting': 'Revising chapter {no}…',
+  'progress.polishing': 'Polishing chapter {no}…',
+  'progress.empty': 'Generation/review progress appears here',
+  'assistant.hint': 'Discuss plot, characters, foreshadowing with the AI editor; once agreed, let it edit the outline, bible, or chapters directly.',
+  'assistant.placeholder': 'e.g. Add a hook at the end of chapter 2…',
+  'assistant.send': 'Send',
+  'assistant.toolStart': '⚙ Running {name}…',
+  'assistant.toolDone': '✓ {name} done: {detail}',
+  'assistant.toolError': '✗ {name} failed: {detail}',
+  'assistant.empty': 'No conversation yet. Chat with the AI editor.',
+  'status.projectNone': 'No project in the output directory yet. Load an outline first.',
+  'status.files': 'Generated files',
+  'api.error': 'Request failed',
+}
+
+/** Keys type for the zh dictionary. */
+export type NovelKey = keyof typeof zh