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

package/src/client/run-status.ts

@@ -1,143 +1,171 @@
-/**
- * 运行状态芯片：固定在页面顶部的「小说工坊生成状态」小徽标。
- * 轮询 /run/status，实时显示 生成中/暂停/完成/停止/出错 + 当前章号；
- * 点击可打开/关闭小说工坊面板。独立 DOM 注入，不触碰主面板逻辑，挂载失败静默降级。
- *
- * P0 重写说明（原实现的三个问题）：
- *   1. 整块背景染状态色 + 固定白字 → 浅色主题下「白字配亮底」对比度崩坏。
- *      现在改为「玻璃底 + 主题前景色文字 + 左侧状态色点」，状态只由色点承载，
- *      文字永远跟随主题，任何深浅色下都可读。
- *   2. 样式写死在 JS 的 inline style 里，切主题纹丝不动。
- *      现在改用 CSS Module class，配色走 --nf-chip-* 令牌，
- *      由 body[data-ds-dark-theme] 跟随宿主深浅色。
- *   3. role="button" 却没有 tabindex、没有键盘处理，键盘用户完全用不了。
- *      现在补 tabindex + Enter/Space 激活 + aria-label/live。
- */
-import type { NovelApi } from './api.ts'
-import type { PanelController } from './panel/controller.ts'
-import type { RunState } from '../protocol.ts'
-import css from './panel/panel.module.css'
-
-const REFRESH_MS = 4000
-
-/** 状态文案。状态语义由左侧色点承载，这里不再放 emoji（避免与色点重复表意）。 */
-function label(s: RunState): string {
-  const no = s.currentNo
-  switch (s.status) {
-    case 'running': return `小说工坊 生成中 · 第${no}章`
-    case 'paused': return `小说工坊 已暂停 · 第${no}章`
-    case 'done': return `小说工坊 批完成 ${s.startNo}–${s.endNo}`
-    case 'stopped': return `小说工坊 已停止 · 第${no}章`
-    case 'error': return `小说工坊 出错 · 第${no}章`
-    default: return '小说工坊'
-  }
-}
-
-/** 生成一个固定顶部的状态芯片并开始轮询。返回 dispose。 */
-export function mountRunStatus(controller: PanelController, api: NovelApi): () => void {
-  const chip = document.createElement('div')
-  chip.className = css.runChip
-  chip.setAttribute('role', 'button')
-  // P0: role="button" 必须可聚焦、可键盘激活，否则对键盘/读屏用户等同不存在。
-  chip.setAttribute('tabindex', '0')
-  chip.setAttribute('title', '小说工坊生成状态（点击打开工坊）')
-  // 状态是异步轮询出来的，用 aria-live 让读屏用户也能感知变化。
-  chip.setAttribute('aria-live', 'polite')
-
-  const dot = document.createElement('span')
-  dot.className = css.runChipDot
-  // 纯装饰，颜色信息已由文字表达，不要让读屏重复播报。
-  dot.setAttribute('aria-hidden', 'true')
-
-  const text = document.createElement('span')
-  text.className = css.runChipText
-
-  chip.append(dot, text)
-
-  const toggle = (): void => { controller.toggle() }
-
-  // 自由拖拽 + 位置记忆（与 AI 进度浮窗一致）
-  const POS_KEY = 'dsh-novel-forge.runChip.pos'
-  let dragging = false, moved = false, sx = 0, sy = 0, ox = 0, oy = 0
-  const readPos = (): { x: number; y: number } | null => {
-    try { const p = window.localStorage.getItem(POS_KEY); return p === null ? null : JSON.parse(p) as { x: number; y: number } } catch { return null }
-  }
-  const writePos = (x: number, y: number): void => {
-    try { window.localStorage.setItem(POS_KEY, JSON.stringify({ x, y })) } catch { /* ignore */ }
-  }
-  const clampX = (x: number): number => Math.max(0, Math.min(Math.max(0, window.innerWidth - 40), x))
-  const clampY = (y: number): number => Math.max(0, Math.min(Math.max(0, window.innerHeight - 40), y))
-  const applyPos = (x: number, y: number): void => {
-    chip.style.left = clampX(x) + 'px'
-    chip.style.top = clampY(y) + 'px'
-    chip.style.right = 'auto'
-  }
-  chip.addEventListener('pointerdown', (e) => {
-    if (e.button !== 0) return
-    dragging = true; moved = false; sx = e.clientX; sy = e.clientY
-    ox = chip.offsetLeft; oy = chip.offsetTop
-    try { chip.setPointerCapture(e.pointerId) } catch { /* ignore */ }
-  })
-  chip.addEventListener('pointermove', (e) => {
-    if (!dragging) return
-    const dx = e.clientX - sx, dy = e.clientY - sy
-    if (Math.abs(dx) > 3 || Math.abs(dy) > 3) moved = true
-    if (moved) {
-      applyPos(ox + dx, oy + dy)
-      writePos(chip.offsetLeft, chip.offsetTop)
-    }
-  })
-  const endDrag = (): void => { dragging = false }
-  chip.addEventListener('pointerup', endDrag)
-  chip.addEventListener('pointercancel', endDrag)
-  // 拖拽后松开不触发开合
-  chip.addEventListener('click', (e) => {
-    if (moved) { e.preventDefault(); e.stopImmediatePropagation(); moved = false; return }
-    toggle()
-  })
-  chip.addEventListener('keydown', (e) => {
-    if (e.key === 'Enter' || e.key === ' ' || e.key === 'Spacebar') {
-      e.preventDefault()
-      toggle()
-    }
-  })
-
-  document.body.appendChild(chip)
-
-  // 恢复上次拖拽位置（若曾移动过）
-  const saved = readPos()
-  if (saved !== null) applyPos(saved.x, saved.y)
-
-  let disposed = false
-  let timer: number | undefined
-
-  const render = (s: RunState | null): void => {
-    if (s === null) {
-      chip.dataset.visible = 'false'
-      return
-    }
-    let body = label(s)
-    if (s.status === 'running' && s.stats.error > 0) body += ` · ×${s.stats.error}`
-    text.textContent = body
-    chip.dataset.status = s.status
-    chip.dataset.visible = 'true'
-    chip.setAttribute('aria-label', body)
-  }
-
-  const tick = async (): Promise<void> => {
-    if (disposed) return
-    try {
-      const s = await api.runStatus()
-      render(s)
-    } catch { /* best-effort */ }
-    if (!disposed) timer = window.setTimeout(() => { void tick() }, REFRESH_MS)
-  }
-
-  void tick()
-
-  return () => {
-    disposed = true
-    if (timer !== undefined) window.clearTimeout(timer)
-    chip.remove()
-  }
-}
+/**
+ * 运行状态芯片：固定在页面顶部的「小说工坊生成状态」小徽标。
+ * 轮询 /run/status，实时显示 生成中/暂停/完成/停止/出错 + 当前章号；
+ * 点击可打开/关闭小说工坊面板。独立 DOM 注入，不触碰主面板逻辑，挂载失败静默降级。
+ * 显示偏好（关 / 仅生成中暂停时 / 总是）存在 localStorage，见 chip-prefs.ts：
+ * 书架页「设置 · 全局 → 外观与主题」里有对应下拉，选择即时生效（跨标签页也同步）。
+ *
+ * P0 重写说明（原实现的三个问题）：
+ *   1. 整块背景染状态色 + 固定白字 → 浅色主题下「白字配亮底」对比度崩坏。
+ *      现在改为「玻璃底 + 主题前景色文字 + 左侧状态色点」，状态只由色点承载，
+ *      文字永远跟随主题，任何深浅色下都可读。
+ *   2. 样式写死在 JS 的 inline style 里，切主题纹丝不动。
+ *      现在改用 CSS Module class，配色走 --nf-chip-* 令牌，
+ *      由 body[data-ds-dark-theme] 跟随宿主深浅色。
+ *   3. role="button" 却没有 tabindex、没有键盘处理，键盘用户完全用不了。
+ *      现在补 tabindex + Enter/Space 激活 + aria-label/live。
+ */
+import type { NovelApi } from './api.ts'
+import type { PanelController } from './panel/controller.ts'
+import type { RunState } from '../protocol.ts'
+import css from './panel/panel.module.css'
+import { isRunChipVisible, readRunChipMode, subscribeRunChipMode, type RunChipMode } from './chip-prefs.ts'
+
+const REFRESH_MS = 4000
+
+/** 状态文案。状态语义由左侧色点承载，这里不再放 emoji（避免与色点重复表意）。 */
+function label(s: RunState): string {
+  const no = s.currentNo
+  // 带书名的原因：状态是"全局单实例 + 恢复时会扫书架"，不带书名根本不知道是谁的批次。
+  const book = typeof s.bookName === 'string' && s.bookName.trim() !== '' ? `《${s.bookName.trim()}》` : ''
+  const head = book === '' ? '小说工坊' : book
+  switch (s.status) {
+    case 'running': return `${head} 生成中 · 第${no}章`
+    case 'paused': return `${head} 已暂停 · 第${no}章`
+    case 'done': return `${head} 批完成 ${s.startNo}–${s.endNo}`
+    case 'stopped': return `${head} 已停止 · 第${no}章`
+    case 'error': return `${head} 出错 · 第${no}章`
+    default: return book === '' ? '小说工坊' : book
+  }
+}
+
+/** 生成一个固定顶部的状态芯片并开始轮询。返回 dispose。 */
+export function mountRunStatus(controller: PanelController, api: NovelApi): () => void {
+  const chip = document.createElement('div')
+  chip.className = css.runChip
+  chip.setAttribute('role', 'button')
+  // P0: role="button" 必须可聚焦、可键盘激活，否则对键盘/读屏用户等同不存在。
+  chip.setAttribute('tabindex', '0')
+  chip.setAttribute('title', '小说工坊生成状态（点击打开工坊）')
+  // 状态是异步轮询出来的，用 aria-live 让读屏用户也能感知变化。
+  chip.setAttribute('aria-live', 'polite')
+
+  const dot = document.createElement('span')
+  dot.className = css.runChipDot
+  // 纯装饰，颜色信息已由文字表达，不要让读屏重复播报。
+  dot.setAttribute('aria-hidden', 'true')
+
+  const text = document.createElement('span')
+  text.className = css.runChipText
+
+  chip.append(dot, text)
+
+  const toggle = (): void => { controller.toggle() }
+
+  // 自由拖拽 + 位置记忆（与 AI 进度浮窗一致）
+  const POS_KEY = 'dsh-novel-forge.runChip.pos'
+  let dragging = false, moved = false, sx = 0, sy = 0, ox = 0, oy = 0
+  const readPos = (): { x: number; y: number } | null => {
+    try { const p = window.localStorage.getItem(POS_KEY); return p === null ? null : JSON.parse(p) as { x: number; y: number } } catch { return null }
+  }
+  const writePos = (x: number, y: number): void => {
+    try { window.localStorage.setItem(POS_KEY, JSON.stringify({ x, y })) } catch { /* ignore */ }
+  }
+  const clampX = (x: number): number => Math.max(0, Math.min(Math.max(0, window.innerWidth - 40), x))
+  const clampY = (y: number): number => Math.max(0, Math.min(Math.max(0, window.innerHeight - 40), y))
+  const applyPos = (x: number, y: number): void => {
+    chip.style.left = clampX(x) + 'px'
+    chip.style.top = clampY(y) + 'px'
+    chip.style.right = 'auto'
+  }
+  chip.addEventListener('pointerdown', (e) => {
+    if (e.button !== 0) return
+    dragging = true; moved = false; sx = e.clientX; sy = e.clientY
+    ox = chip.offsetLeft; oy = chip.offsetTop
+    try { chip.setPointerCapture(e.pointerId) } catch { /* ignore */ }
+  })
+  chip.addEventListener('pointermove', (e) => {
+    if (!dragging) return
+    const dx = e.clientX - sx, dy = e.clientY - sy
+    if (Math.abs(dx) > 3 || Math.abs(dy) > 3) moved = true
+    if (moved) {
+      applyPos(ox + dx, oy + dy)
+      writePos(chip.offsetLeft, chip.offsetTop)
+    }
+  })
+  const endDrag = (): void => { dragging = false }
+  chip.addEventListener('pointerup', endDrag)
+  chip.addEventListener('pointercancel', endDrag)
+  // 拖拽后松开不触发开合
+  chip.addEventListener('click', (e) => {
+    if (moved) { e.preventDefault(); e.stopImmediatePropagation(); moved = false; return }
+    toggle()
+  })
+  chip.addEventListener('keydown', (e) => {
+    if (e.key === 'Enter' || e.key === ' ' || e.key === 'Spacebar') {
+      e.preventDefault()
+      toggle()
+    }
+  })
+
+  document.body.appendChild(chip)
+
+  // 恢复上次拖拽位置（若曾移动过）
+  const saved = readPos()
+  if (saved !== null) applyPos(saved.x, saved.y)
+
+  let disposed = false
+  let timer: number | undefined
+  let mode: RunChipMode = readRunChipMode()
+  /** 最近一次拿到的生产单状态：切换偏好时据此立刻重算可见性，不必等下一轮询。 */
+  let last: RunState | null = null
+
+  const render = (s: RunState | null): void => {
+    last = s
+    if (!isRunChipVisible(mode, s)) {
+      chip.dataset.visible = 'false'
+      return
+    }
+    let body = label(s!)
+    if (s!.status === 'running' && s!.stats.error > 0) body += ` · ×${s!.stats.error}`
+    text.textContent = body
+    chip.dataset.status = s!.status
+    chip.dataset.visible = 'true'
+    // 芯片单行且限宽：书名过长会省略号截断，全名与归属目录放进 title / aria-label。
+    const full = `${body}（第 ${s!.startNo}-${s!.endNo} 章）`
+    chip.setAttribute('aria-label', full)
+    chip.setAttribute('title', full + ' · 点击打开小说工坊')
+  }
+
+  const tick = async (): Promise<void> => {
+    if (disposed) return
+    try {
+      const s = await api.runStatus()
+      render(s)
+    } catch { /* best-effort */ }
+    if (!disposed && mode !== 'off') timer = window.setTimeout(() => { void tick() }, REFRESH_MS)
+  }
+
+  /** 偏好变化：立即重算可见性；「关闭」时停掉轮询，重新打开时续上。 */
+  const applyMode = (next: RunChipMode): void => {
+    const wasOff = mode === 'off'
+    mode = next
+    render(last)
+    if (mode === 'off') {
+      if (timer !== undefined) { window.clearTimeout(timer); timer = undefined }
+      return
+    }
+    if (wasOff && timer === undefined) void tick()
+  }
+
+  const unsubscribe = subscribeRunChipMode(applyMode)
+
+  void tick()
+
+  return () => {
+    disposed = true
+    unsubscribe()
+    if (timer !== undefined) window.clearTimeout(timer)
+    chip.remove()
+  }
+}

package/src/protocol.ts

@@ -1579,6 +1579,12 @@ export interface StatusResponse {
 /** 生产单状态（生产单 = 区间批量生产执行器：计划补足 + 逐章生成 + 被拒分级处理）。 */
 export interface RunState {
   runId: string
+  /**
+   * 本批次归属的书名（可选，兼容旧 run-state.json）。
+   * 生产单是全局单实例，而 /run/status 恢复时会扫书架取第一个有 run-state 的目录，
+   * 因此"这是哪本书的批次"必须显式带上，否则芯片/面板只能显示一个无法归属的状态。
+   */
+  bookName?: string
   /** 区间起点（含）。 */
   startNo: number
   /** 区间终点（含）。 */

package/src/run.ts

@@ -34,6 +34,30 @@ function runStateFile(outputDir: string): string {
   return join(outputDir, 'run-state.json')
 }
 
+/**
+ * 解析某个输出目录的书名（用于旧 run-state.json 的兜底）。
+ * 优先项目文件里的 bookName，其次目录名——两者都没有时返回空串。
+ * @param outputDir - 该书输出目录。
+ */
+export function resolveRunBookName(outputDir: string): string {
+  const fromProject = loadProject(outputDir)?.bookName
+  if (typeof fromProject === 'string' && fromProject.trim() !== '') return fromProject.trim()
+  const base = outputDir.replace(/[\\/]+$/, '').split(/[\\/]/).pop() ?? ''
+  return base.trim()
+}
+
+/**
+ * 一句话描述"正在跑的是哪本书的哪一章"。
+ * 面板状态行与 409 报错共用，避免两处各写各的（也便于单测覆盖）。
+ * @param state - 运行中的生产单状态。
+ */
+export function describeRunningBatch(state: RunState): string {
+  const name = typeof state.bookName === 'string' && state.bookName.trim() !== ''
+    ? `《${state.bookName.trim()}》`
+    : '未标注书目'
+  return `${name}第${state.currentNo}章`
+}
+
 export class ProductionRunner {
   private state: RunState | null = null
   private working = false
@@ -60,6 +84,11 @@ export class ProductionRunner {
         if (parsed?.runId === undefined) continue
         // 重启恢复：若之前 running，则视为可续跑（loop 未在跑）。
         if (parsed.status === 'running') parsed.status = 'paused'
+        // 旧 run-state.json 没有 bookName：用该目录的项目名兜底，再退回目录名，
+        // 保证"这是哪本书"永远有答案（否则芯片/面板会显示一个无法归属的状态）。
+        if (parsed.bookName === undefined || parsed.bookName === '') {
+          parsed.bookName = resolveRunBookName(outputDir)
+        }
         this.state = parsed
         this.bookDir = outputDir
         return this.state
@@ -85,7 +114,13 @@ export class ProductionRunner {
   /** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
   async start(startNo: number, endNo: number, runDir?: string): Promise<RunState> {
     const config = this.deps.getConfig()
-    if (this.working) throw new Error('生产单正在运行中，请先暂停或停止')
+    if (this.working) {
+      // 报错要说清"在跑哪本书的哪一章"：全局单实例，含糊的提示会让多书用户无从下手。
+      const running = this.state
+      throw new Error(running === null
+        ? '生产单正在运行中，请先暂停或停止'
+        : `生产单正在运行中（${describeRunningBatch(running)}），请先暂停或停止`)
+    }
     const outputDir = runDir ?? config.outputDir
     let project = loadProject(outputDir)
     if (project === undefined) throw new Error('输出目录中没有项目')
@@ -104,6 +139,7 @@ export class ProductionRunner {
 
     this.state = {
       runId: `run-${Date.now().toString(36)}`,
+      bookName: project.bookName,
       startNo,
       endNo,
       status: 'running',