@waterwx/dsh-novel-forge 1.3.2 → 1.3.3-alpha

package/src/client/docx.ts

@@ -1,69 +1,32 @@
-/**
- * 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()
-}
+/**
+ * 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.
+ *
+ * XML 解析共享核心在 ../docx-core.ts（与服务端同源）。
+ */
+
+import { unzipSync, strFromU8 } from 'fflate/browser'
+import { extractDocxTextFromXml } from '../docx-core.ts'
+
+/** 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）')
+  }
+  return extractDocxTextFromXml(strFromU8(document))
+}

package/src/client/index.ts

@@ -4,11 +4,12 @@
  * 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 type { Context as ClientContext } from '@deepseek-ai/cordis'
 import { NovelApi } from './api.ts'
 import { mountPanel } from './mount.tsx'
 import { PanelController } from './panel/controller.ts'
 import { mountSidebarEntry } from './sidebar-entry.ts'
+import { mountRunStatus } from './run-status.ts'
 
 /** Required services (fiber inject waiting). */
 export const inject = ['slots', 'locale']
@@ -24,6 +25,7 @@ export function apply(ctx: ClientContext): void {
   try {
     disposers.push(mountSidebarEntry(controller))
     disposers.push(mountPanel(controller, api))
+    disposers.push(mountRunStatus(controller, api))
   } catch (error) {
     // DOM failures degrade the panel, never the GUI.
     console.warn('[dsh-novel-forge] mount failed:', error)

package/src/client/llmLive.ts

@@ -0,0 +1,111 @@
+/**
+ * 浏览器端「AI 创作实况」钩子：连接 /llm-live/stream (SSE)，按 LLM 调用分组会话。
+ * 轻量实现，不持久化缓存（对齐上游 useLlmLiveFeed 的核心行为）。
+ */
+
+import { useEffect, useMemo, useState } from 'react'
+import { NOVEL_API, type LlmLiveFrame, type LlmTokenUsage } from '../protocol.ts'
+
+// 帧结构定义在 protocol.ts（宿主与浏览器共用同一份线上形状），此处只再导出。
+export type { LlmLiveFrame }
+
+export interface LlmLiveSession {
+  sessionId: string
+  label: string
+  model?: string
+  phase: 'requesting' | 'streaming' | 'completed' | 'failed'
+  phaseMessage: string
+  preview: string
+  totalChars: number
+  startedAt: string
+  updatedAt: string
+  /** 本次调用的 token 用量（供应商未上报时缺省）。 */
+  usage?: LlmTokenUsage
+  /** 本次调用耗时（毫秒）。 */
+  elapsedMs?: number
+  /** 首字耗时（毫秒）。 */
+  firstTokenMs?: number
+  /** 是否保存了可查看的 Prompt。 */
+  hasPrompt?: boolean
+  /** Prompt 字符数（system + user）。 */
+  promptChars?: number
+}
+
+const MAX_PREVIEW_CHARS = 20_000
+
+function applyFrame(current: Record<string, LlmLiveSession>, frame: LlmLiveFrame): Record<string, LlmLiveSession> {
+  const next = { ...current }
+  const id = frame.sessionId
+  let session = next[id]
+  if (frame.type === 'session_started') {
+    session = {
+      sessionId: id,
+      label: frame.label ?? 'LLM 调用',
+      model: frame.model,
+      phase: 'requesting',
+      phaseMessage: '正在连接模型',
+      preview: '',
+      totalChars: 0,
+      startedAt: frame.at,
+      updatedAt: frame.at,
+      hasPrompt: frame.hasPrompt,
+      promptChars: frame.promptChars,
+    }
+    next[id] = session
+    return next
+  }
+  if (session === undefined) return next
+  if (frame.type === 'output_delta') {
+    const preview = (session.preview + (frame.content ?? '')).slice(-MAX_PREVIEW_CHARS)
+    session = { ...session, phase: session.phase === 'requesting' ? 'streaming' : session.phase, phaseMessage: session.phase === 'requesting' ? '模型正在返回内容' : session.phaseMessage, preview, totalChars: frame.totalChars ?? session.totalChars + (frame.content?.length ?? 0), updatedAt: frame.at }
+    next[id] = session
+  } else if (frame.type === 'reasoning_delta') {
+    session = { ...session, phase: session.phase === 'requesting' ? 'streaming' : session.phase, updatedAt: frame.at }
+    next[id] = session
+  } else if (frame.type === 'phase_changed') {
+    session = { ...session, phase: frame.phase ?? session.phase, phaseMessage: frame.phaseMessage ?? session.phaseMessage, updatedAt: frame.at }
+    next[id] = session
+  } else if (frame.type === 'session_completed') {
+    session = {
+      ...session,
+      phase: frame.phase ?? 'completed',
+      phaseMessage: frame.phase === 'failed' ? (frame.error ?? '调用失败') : '模型结果已准备完成',
+      totalChars: frame.totalChars ?? session.totalChars,
+      preview: session.preview || (frame.preview ?? ''),
+      updatedAt: frame.at,
+      usage: frame.usage ?? session.usage,
+      elapsedMs: frame.elapsedMs ?? session.elapsedMs,
+      firstTokenMs: frame.firstTokenMs ?? session.firstTokenMs,
+    }
+    next[id] = session
+  }
+  return next
+}
+
+export function useLlmLiveFeed(enabled = true): { connected: boolean; sessions: LlmLiveSession[] } {
+  const [sessions, setSessions] = useState<Record<string, LlmLiveSession>>({})
+  const [connected, setConnected] = useState(false)
+  useEffect(() => {
+    if (!enabled) {
+      setSessions({})
+      setConnected(false)
+      return
+    }
+    const es = new EventSource(NOVEL_API.llmLive)
+    es.onopen = () => setConnected(true)
+    es.onmessage = (ev) => {
+      try {
+        const frame = JSON.parse(ev.data as string) as LlmLiveFrame
+        setSessions(prev => applyFrame(prev, frame))
+      } catch { /* ignore malformed frame */ }
+    }
+    // EventSource 断线会自动重连；这里只在断线瞬间标记未连接，重连成功后会再次 onopen。
+    es.onerror = () => setConnected(false)
+    return () => {
+      es.close()
+      setConnected(false)
+    }
+  }, [enabled])
+  const list = useMemo(() => Object.values(sessions).sort((a, b) => a.startedAt.localeCompare(b.startedAt)), [sessions])
+  return { connected, sessions: list }
+}

package/src/client/locales.ts

@@ -1,58 +1,37 @@
 /**
- * dsh-novel-forge — locale dictionaries (zh / en).
+ * dsh-novel-forge — 面板文案词典（简体中文单语）。
+ *
+ * 定位说明：小说工坊面板是**中文单语界面**——这里就是全部用户可见文案的唯一定义处，
+ * 键位即类型（`NovelKey`），新增文案请同时在此登记，不要散落到组件里硬编码。
+ * 文档层（README / docs / CHANGELOG）仍提供英文对照，那是给人读的，不是界面语言。
  */
 
-/** 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.assistant': 'AI 编辑 Agent',
   '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': '待审稿',
@@ -64,23 +43,17 @@ export const zh = {
   '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.gen': '提炼道藏',
   'bible.genre': '题材基调',
   'bible.worldRules': '世界规则',
   'bible.characters': '人物志',
@@ -88,9 +61,8 @@ export const zh = {
   'bible.style': '风格要求',
   'bible.none': '尚未生成道藏。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。',
   'foreshadow.title': '暗线管理',
-  'foreshadow.suggest': 'AI 建议暗线',
+  'foreshadow.suggest': '建议暗线',
   'foreshadow.none': '暂无暗线',
-  'foreshadow.status': '状态',
   'foreshadow.planned': '计划中',
   'foreshadow.planted': '已埋设',
   'foreshadow.progressing': '推进中',
@@ -100,7 +72,6 @@ export const zh = {
   'foreshadow.plantedAt': '埋设于',
   'foreshadow.setPlanted': '标记已埋设',
   'foreshadow.setResolved': '标记已回收',
-  'tab.facts': '编年录',
   'tab.plotlines': '剧情线',
   'plotlines.hint': '主线/支线/人物线/悬念线的推进管理：章节生成时会注入未完结的线，要求每章至少推进一条；关联章节记录推进节点。',
   'plotlines.empty': '还没有剧情线——长篇小说建议先建主线与几条支线。',
@@ -122,44 +93,42 @@ export const zh = {
   'plotlines.cancel': '取消',
   'plotlines.edit': '编辑',
   'plotlines.remove': '删除',
-  'plotlines.linkChapter': '关联本章',
   'plotlines.chapters': '已关联',
-  'plotlines.workflowTitle': '剧情线进度',
-  'plotlines.workflowEmpty': '未建剧情线（去「剧情线」页创建）',
-  'sensitive.title': '敏感词检查',
-  'sensitive.scanAll': '🔞 全书敏感词检查',
+  'sensitive.scanAll': ' 全书敏感词检查',
   'sensitive.hint': '内置违禁词库硬匹配（政治/擦边/暴力/辱骂/广告/其他），发布前建议检查；只做提示，是否修改由你判断。',
-  'sensitive.clean': '✅ 未命中任何违禁词（扫描 {n} 章）',
+  'sensitive.clean': ' 未命中任何违禁词（扫描 {n} 章）',
   'sensitive.hits': '命中 {n} 处（{chapters} 章受影响）',
   'sensitive.goFix': '去修订',
   'sensitive.fixPrefill': '请删除或替换正文中的违禁表达「{word}」（类别：{category}），用含蓄/间接的写法替代。',
   'facts.title': '编年录 / 时间线（{n} 条）',
   'facts.hint': '每章生成后自动抽取「已确立事实」（人物状态/境界资源/关系变化/伏笔落地），最近 20 条注入后续章节生成，保证长期一致。',
   'facts.backfill': '回填历史章节事实',
-  'facts.backfilled': '已从历史章节回填 {n} 条事实',
-  'settings.title': '设置',
-  'settings.outlinePath': '默认大纲路径',
   'settings.outputDir': '输出目录',
   'settings.provider': '模型提供商',
   'settings.model': '模型',
   'settings.modelCustom': '自定义…',
+  'settings.customProvider': '自定义提供商…',
+  'settings.edit': '编辑',
+  'settings.delete': '删除',
   'settings.modelCustomPlaceholder': '输入任意模型 id',
-  'settings.reasoningEffort': '思考强度 (reasoningEffort)',
+  'settings.refreshModels': '刷新模型',
+  'settings.testConnection': '测试连通',
+  'settings.testRunning': '测试中',
+  'settings.testOk': '连通',
+  'settings.testFail': '失败',
+  'settings.testHint': '真实发送一次最小调用（约几十 token），验证 Key / 端点 / 模型可用。',
+  'settings.reasoningSection': '推理强度',
+  'settings.reasoningEffort': '写作类任务思考强度 (reasoningEffort)',
+  'settings.reasoningHint': '章节生成/润色/重写/审稿等写作任务使用；关掉更省更快。',
+  'settings.analysisReasoning': '分析类任务思考强度（提炼/拆书/反推大纲）',
+  'settings.analysisReasoningHint': '角色/场景/道藏提炼、拆书、反推大纲等一次性分析任务默认 low，保证质量，不受上面写作档位影响。',
   'settings.reasoning.off': 'off · 关闭思考（推荐日常写文）',
   'settings.reasoning.low': 'low · 低思考',
   'settings.reasoning.high': 'high · 高思考',
   'settings.reasoning.max': 'max · 最高思考（质检/推演）',
-  'settings.reasoningHint': 'off 最快最省；high/max 更慢更贵但推理更强',
-  'settings.theme': '主题',
-  'settings.themeLiquid': 'iOS 液态玻璃（绿）',
-  'settings.themeClassic': '经典毛玻璃（蓝）',
-  'settings.themeNeumorph': '新拟物（双阴影）',
-  'settings.themeHint': '存于浏览器本地，即时生效',
   'settings.chapterChars': '每章目标字数',
   'settings.maxTokens': '单章最大输出 tokens',
   'settings.reviewPassScore': '审稿通过分数（0-100）',
-  'settings.editorFontSize': '编辑器字号（仅编辑页显示）',
-  'settings.editorFontSizeHint': '存于浏览器本地，不影响其他设备',
   'settings.autoReview': '生成后自动审稿',
   'settings.autoAuthorReview': '生成后自动作者复盘',
   'settings.autoAuthorReviewHint': '复盘钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势，每章约 2000 token',
@@ -167,8 +136,8 @@ export const zh = {
   'settings.autoReviewAfterReviseHint': '按意见修订/润色产出草稿后自动附带一次 AI 审查，直接显示新稿评分与剩余问题（每章约 2-3k token，可关）',
   'settings.save': '保存设置',
   'settings.saved': '设置已保存',
+  'settings.savedUnpersisted': '设置已生效，但未能持久化（宿主未登记本插件的配置段），重启后会回到原值。',
   'settings.openFolder': '打开输出文件夹',
-  'settings.export': '导出',
   'settings.exportTxt': '导出 TXT',
   'settings.exportMd': '导出 Markdown',
   'settings.exported': '已导出：{file}（{chars} 字，{chapters} 章）',
@@ -178,206 +147,13 @@ export const zh = {
   'progress.error': '第 {no} 章失败：{message}',
   'progress.rewriting': '正在修订第 {no} 章…',
   'progress.polishing': '正在润色第 {no} 章…',
-  'progress.empty': '生成/审稿进度将显示在这里',
-  'assistant.hint': '和 AI 编辑讨论剧情、人设、暗线；达成一致后可让它直接修改总纲、道藏、章节内容。',
+  'assistant.hint': '和 AI 编辑 Agent 讨论剧情、人设、暗线；达成一致后可让它直接修改总纲、道藏、章节内容。',
   'assistant.placeholder': '例如：我想让第 2 章结尾加一个悬念——墟境里传来爷爷的声音…',
   'assistant.send': '发送',
-  'assistant.toolStart': '⚙ 执行操作：{name}…',
-  'assistant.toolDone': '✓ {name} 完成：{detail}',
-  'assistant.toolError': '✗ {name} 失败：{detail}',
-  'assistant.empty': '还没有对话。和 AI 编辑聊聊剧情吧。',
+  'assistant.empty': '还没有对话。和 AI 编辑 Agent 聊聊剧情吧。',
   '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': 'Workbench',
-  'tab.overview': 'Outline',
-  'tab.plan': 'Chapters',
-  'tab.bible': 'Bible',
-  'tab.foreshadow': 'Foreshadow',
-  'tab.settings': 'Settings',
-  'workflow.title': 'Writing workbench',
-  '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.modelCustom': 'Custom…',
-  'settings.modelCustomPlaceholder': 'Type any model id',
-  'settings.reasoningEffort': 'Reasoning effort',
-  'settings.reasoning.off': 'off · no thinking (recommended)',
-  'settings.reasoning.low': 'low',
-  'settings.reasoning.high': 'high',
-  'settings.reasoning.max': 'max (audit/reasoning)',
-  'settings.reasoningHint': 'off is fastest/cheapest; high/max are slower and stronger',
-  'settings.theme': 'Theme',
-  'settings.themeLiquid': 'iOS Liquid Glass (green)',
-  'settings.themeClassic': 'Classic frosted (blue)',
-  'settings.themeNeumorph': 'Neumorphism (dual-shadow)',
-  'settings.themeHint': 'Stored in browser localStorage; applies instantly',
-  'settings.chapterChars': 'Chars per chapter',
-  'settings.maxTokens': 'Max output tokens',
-  'settings.reviewPassScore': 'Review pass score (0-100)',
-  'settings.editorFontSize': 'Editor font size (workspace only)',
-  'settings.editorFontSizeHint': 'Stored in browser localStorage; display-only',
-  'settings.autoReview': 'Auto-review after writing',
-  'settings.autoAuthorReview': 'Auto author review after writing',
-  'settings.autoAuthorReviewHint': 'Reviews hook payoff / ending hook / plotline progress / continuity / pacing trend (~2000 tokens per chapter)',
-  'settings.autoReviewAfterRevise': 'Auto review after revise',
-  'settings.autoReviewAfterReviseHint': 'Automatically runs one AI review on the produced draft after revise/polish, showing the new score and remaining issues (~2-3k tokens, can be disabled)',
-  '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)',
-  'tab.facts': 'Chronicle',
-  'tab.plotlines': 'Plotlines',
-  'plotlines.hint': 'Track main/branch/character/mystery arcs: unfinished arcs are injected into chapter writing so each chapter advances at least one; linked chapters record progress nodes.',
-  'plotlines.empty': 'No plotlines yet — consider creating the main arc and a few branches.',
-  'plotlines.new': '+ New plotline',
-  'plotlines.name': 'Name',
-  'plotlines.kind': 'Type',
-  'plotlines.kindMain': 'Main',
-  'plotlines.kindBranch': 'Branch',
-  'plotlines.kindCharacter': 'Character',
-  'plotlines.kindMystery': 'Mystery',
-  'plotlines.goal': 'Goal',
-  'plotlines.progress': 'Current progress',
-  'plotlines.status': 'Status',
-  'plotlines.statusActive': 'Active',
-  'plotlines.statusPaused': 'Paused',
-  'plotlines.statusResolved': 'Resolved',
-  'plotlines.statusAbandoned': 'Abandoned',
-  'plotlines.save': 'Save',
-  'plotlines.cancel': 'Cancel',
-  'plotlines.edit': 'Edit',
-  'plotlines.remove': 'Remove',
-  'plotlines.linkChapter': 'Link chapter',
-  'plotlines.chapters': 'Linked',
-  'plotlines.workflowTitle': 'Plotline progress',
-  'plotlines.workflowEmpty': 'No plotlines yet (create them in the Plotlines tab)',
-  'sensitive.title': 'Sensitive-word check',
-  'sensitive.scanAll': '🔞 Scan all chapters',
-  'sensitive.hint': 'Built-in banned-word library (politics/erotica/violence/abuse/ads/other). Run before publishing; suggestions only.',
-  'sensitive.clean': '✅ No banned words found ({n} chapters scanned)',
-  'sensitive.hits': '{n} hits across {chapters} chapters',
-  'sensitive.goFix': 'Fix',
-  'sensitive.fixPrefill': 'Remove or rephrase the banned expression "{word}" (category: {category}) with an indirect alternative.',
-  'facts.title': 'Chronicle / timeline ({n} facts)',
-  'facts.hint': 'Auto-extracted established facts per chapter (state/resources/relations/foreshadow landings); the latest 20 are injected into later chapters for consistency.',
-  'facts.backfill': 'Backfill facts from historical chapters',
-  'facts.backfilled': 'Backfilled {n} facts from historical 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. */
+/** 面板文案键位（= zh 词典的键）。 */
 export type NovelKey = keyof typeof zh

package/src/client/mount.tsx

@@ -10,9 +10,9 @@ import { NovelPanel } from './panel/NovelPanel.tsx'
 import css from './panel/panel.module.css'
 
 /** The injected panel container. */
-export const PANEL_VIEW_SELECTOR = '[data-dsh-novelforge-view]'
+const PANEL_VIEW_SELECTOR = '[data-dsh-novelforge-view]'
 
-const CONVERSATION_COLUMN_SELECTOR = '[data-pane="conversation"]'
+const CONVERSATION_COLUMN_SELECTOR = '[data-pane="conversation"], [class*="centerCol"]'
 const ACTIVE_ATTR = 'data-dsh-novelforge-active'
 /** Sibling panels' activation attributes (evicted when this panel opens). */
 const OTHER_ACTIVE_ATTRS = ['data-dsh-taskboard-active', 'data-dsh-ssh-active']
@@ -44,7 +44,8 @@ export function mountPanel(controller: PanelController, api: NovelApi): () => vo
     const column = conversationColumn()
     if (column === undefined) return
     container = document.createElement('div')
-    container.dataset.dshNovelforgeView = 'true'
+    // 归属标记只在这里落地；取值与 PANEL_VIEW_SELECTOR 同源，字符串不写第二遍。
+    container.setAttribute(PANEL_VIEW_SELECTOR.slice(1, -1), 'true')
     container.className = css.view
     column.appendChild(container)
     root = createRoot(container)