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

package/lib/index.js

@@ -9515,6 +9515,24 @@ function revisionTodoText(item) {
 function runStateFile(outputDir) {
 	return join(outputDir, "run-state.json");
 }
+/**
+* 解析某个输出目录的书名（用于旧 run-state.json 的兜底）。
+* 优先项目文件里的 bookName，其次目录名——两者都没有时返回空串。
+* @param outputDir - 该书输出目录。
+*/
+function resolveRunBookName(outputDir) {
+	const fromProject = loadProject(outputDir)?.bookName;
+	if (typeof fromProject === "string" && fromProject.trim() !== "") return fromProject.trim();
+	return (outputDir.replace(/[\\/]+$/, "").split(/[\\/]/).pop() ?? "").trim();
+}
+/**
+* 一句话描述"正在跑的是哪本书的哪一章"。
+* 面板状态行与 409 报错共用，避免两处各写各的（也便于单测覆盖）。
+* @param state - 运行中的生产单状态。
+*/
+function describeRunningBatch(state) {
+	return `${typeof state.bookName === "string" && state.bookName.trim() !== "" ? `《${state.bookName.trim()}》` : "未标注书目"}第${state.currentNo}章`;
+}
 var ProductionRunner = class {
 	deps;
 	state = null;
@@ -9540,6 +9558,7 @@ var ProductionRunner = class {
 				const parsed = JSON.parse(raw);
 				if (parsed?.runId === void 0) continue;
 				if (parsed.status === "running") parsed.status = "paused";
+				if (parsed.bookName === void 0 || parsed.bookName === "") parsed.bookName = resolveRunBookName(outputDir);
 				this.state = parsed;
 				this.bookDir = outputDir;
 				return this.state;
@@ -9565,7 +9584,10 @@ var ProductionRunner = class {
 	/** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
 	async start(startNo, endNo, runDir) {
 		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 === void 0) throw new Error("输出目录中没有项目");
@@ -9581,6 +9603,7 @@ var ProductionRunner = class {
 		}
 		this.state = {
 			runId: `run-${Date.now().toString(36)}`,
+			bookName: project.bookName,
 			startNo,
 			endNo,
 			status: "running",

package/lib/types/client/chip-prefs.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 右上角「小说工坊生成状态」芯片的显示偏好（纯客户端、localStorage）。
+ *
+ * 为什么是 localStorage 而不是插件配置：这是纯界面 chrome，与显示模式 / 界面密度 /
+ * 编辑器字号 / 芯片自身的位置记忆同类；哪个浏览器想清屏就哪个浏览器清，不需要跨端同步。
+ * 将来若要跨端，把键名沿用成 config 字段 `showRunChip` 即可平滑升级。
+ *
+ * 三态：
+ *   off    关闭（同时停止 4 秒轮询，不白跑）
+ *   active 只在生产单**运行中或已暂停**时显示（不想错过生成，也不想留残影）
+ *   always 只要该目录有生产单状态就显示（默认，保持历史行为）
+ */
+import type { RunState } from '../protocol.ts';
+export type RunChipMode = 'off' | 'active' | 'always';
+/** localStorage 键（与芯片位置记忆同一命名空间）。 */
+export declare const RUN_CHIP_MODE_KEY = "dsh-novel-forge.runChip.mode";
+/** 同页变更通知用的自定义事件名（跨标签页走原生 storage 事件）。 */
+export declare const RUN_CHIP_MODE_EVENT = "dsh-novel-forge:runchip-mode";
+/** 默认值与历史行为一致：有生产单状态就显示。 */
+export declare const DEFAULT_RUN_CHIP_MODE: RunChipMode;
+/** 设置页下拉用的三态选项（顺序即用户看到的顺序）。 */
+export declare const RUN_CHIP_MODE_OPTIONS: ReadonlyArray<{
+    value: RunChipMode;
+    label: string;
+}>;
+/** 读取偏好（缺失 / 非法 / 存储不可用 → 默认值）。 */
+export declare function readRunChipMode(): RunChipMode;
+/** 写入偏好并通知所有监听者；存储不可用时仍通知（本次会话内生效）。 */
+export declare function writeRunChipMode(mode: RunChipMode): void;
+/** 订阅偏好变化（同页 + 跨标签页 storage）；返回退订函数。 */
+export declare function subscribeRunChipMode(listener: (mode: RunChipMode) => void): () => void;
+/**
+ * 给定偏好与当前生产单状态，判断芯片是否应可见。
+ * null（没有生产单状态）永远不显示——这是渲染层与测试共用的唯一判据。
+ */
+export declare function isRunChipVisible(mode: RunChipMode, state: RunState | null | undefined): boolean;

package/lib/types/client/run-status.d.ts

@@ -2,6 +2,8 @@
  * 运行状态芯片：固定在页面顶部的「小说工坊生成状态」小徽标。
  * 轮询 /run/status，实时显示 生成中/暂停/完成/停止/出错 + 当前章号；
  * 点击可打开/关闭小说工坊面板。独立 DOM 注入，不触碰主面板逻辑，挂载失败静默降级。
+ * 显示偏好（关 / 仅生成中暂停时 / 总是）存在 localStorage，见 chip-prefs.ts：
+ * 书架页「设置 · 全局 → 外观与主题」里有对应下拉，选择即时生效（跨标签页也同步）。
  *
  * P0 重写说明（原实现的三个问题）：
  *   1. 整块背景染状态色 + 固定白字 → 浅色主题下「白字配亮底」对比度崩坏。

package/lib/types/protocol.d.ts

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

package/lib/types/run.d.ts

@@ -1,5 +1,17 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { NovelConfig, RunState } from './protocol.ts';
+/**
+ * 解析某个输出目录的书名（用于旧 run-state.json 的兜底）。
+ * 优先项目文件里的 bookName，其次目录名——两者都没有时返回空串。
+ * @param outputDir - 该书输出目录。
+ */
+export declare function resolveRunBookName(outputDir: string): string;
+/**
+ * 一句话描述"正在跑的是哪本书的哪一章"。
+ * 面板状态行与 409 报错共用，避免两处各写各的（也便于单测覆盖）。
+ * @param state - 运行中的生产单状态。
+ */
+export declare function describeRunningBatch(state: RunState): string;
 export declare class ProductionRunner {
     private deps;
     private state;

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 volumes & chapters with LLM, generate chapter by chapter (3000-4000 chars each), auto AI review & book audit, and export the full book as Markdown/TXT into your chosen output folder.",
-  "version": "1.3.1-alpha",
+  "version": "1.3.2-alpha",
   "type": "module",
   "author": "waterwx",
   "repository": {

package/src/client/chip-prefs.ts

@@ -0,0 +1,121 @@
+/**
+ * 右上角「小说工坊生成状态」芯片的显示偏好（纯客户端、localStorage）。
+ *
+ * 为什么是 localStorage 而不是插件配置：这是纯界面 chrome，与显示模式 / 界面密度 /
+ * 编辑器字号 / 芯片自身的位置记忆同类；哪个浏览器想清屏就哪个浏览器清，不需要跨端同步。
+ * 将来若要跨端，把键名沿用成 config 字段 `showRunChip` 即可平滑升级。
+ *
+ * 三态：
+ *   off    关闭（同时停止 4 秒轮询，不白跑）
+ *   active 只在生产单**运行中或已暂停**时显示（不想错过生成，也不想留残影）
+ *   always 只要该目录有生产单状态就显示（默认，保持历史行为）
+ */
+
+import type { RunState } from '../protocol.ts'
+
+export type RunChipMode = 'off' | 'active' | 'always'
+
+/** localStorage 键（与芯片位置记忆同一命名空间）。 */
+export const RUN_CHIP_MODE_KEY = 'dsh-novel-forge.runChip.mode'
+
+/** 同页变更通知用的自定义事件名（跨标签页走原生 storage 事件）。 */
+export const RUN_CHIP_MODE_EVENT = 'dsh-novel-forge:runchip-mode'
+
+/** 默认值与历史行为一致：有生产单状态就显示。 */
+export const DEFAULT_RUN_CHIP_MODE: RunChipMode = 'always'
+
+/** 设置页下拉用的三态选项（顺序即用户看到的顺序）。 */
+export const RUN_CHIP_MODE_OPTIONS: ReadonlyArray<{ value: RunChipMode; label: string }> = [
+  { value: 'always', label: '总是显示' },
+  { value: 'active', label: '仅生成中 / 暂停时显示' },
+  { value: 'off', label: '关闭' },
+]
+
+const ALL_MODES: readonly RunChipMode[] = ['off', 'active', 'always']
+
+function isMode(value: unknown): value is RunChipMode {
+  return typeof value === 'string' && (ALL_MODES as readonly string[]).includes(value)
+}
+
+/** 安全拿 localStorage：隐私模式 / 非浏览器环境下为 undefined。 */
+function storage(): Storage | undefined {
+  try {
+    return typeof localStorage === 'undefined' ? undefined : localStorage
+  } catch {
+    return undefined
+  }
+}
+
+/** 读取偏好（缺失 / 非法 / 存储不可用 → 默认值）。 */
+export function readRunChipMode(): RunChipMode {
+  try {
+    const raw = storage()?.getItem(RUN_CHIP_MODE_KEY)
+    return isMode(raw) ? raw : DEFAULT_RUN_CHIP_MODE
+  } catch {
+    return DEFAULT_RUN_CHIP_MODE
+  }
+}
+
+/** 已注册的同页监听者（storage 事件只覆盖跨标签页，同页要靠这里）。 */
+const listeners = new Set<(mode: RunChipMode) => void>()
+
+/** 写入偏好并通知所有监听者；存储不可用时仍通知（本次会话内生效）。 */
+export function writeRunChipMode(mode: RunChipMode): void {
+  try {
+    storage()?.setItem(RUN_CHIP_MODE_KEY, mode)
+  } catch {
+    /* 存储不可用：本次会话内仍然生效 */
+  }
+  for (const listener of [...listeners]) {
+    try {
+      listener(mode)
+    } catch {
+      /* 单个监听者出错不影响其他人 */
+    }
+  }
+  try {
+    if (typeof window !== 'undefined' && typeof CustomEvent === 'function') {
+      window.dispatchEvent(new CustomEvent(RUN_CHIP_MODE_EVENT, { detail: mode }))
+    }
+  } catch {
+    /* 事件派发失败无关紧要 */
+  }
+}
+
+/** 订阅偏好变化（同页 + 跨标签页 storage）；返回退订函数。 */
+export function subscribeRunChipMode(listener: (mode: RunChipMode) => void): () => void {
+  listeners.add(listener)
+  const onStorage = (event: StorageEvent): void => {
+    if (event.key !== null && event.key !== RUN_CHIP_MODE_KEY) return
+    listener(readRunChipMode())
+  }
+  let attached = false
+  try {
+    if (typeof window !== 'undefined') {
+      window.addEventListener('storage', onStorage)
+      attached = true
+    }
+  } catch {
+    attached = false
+  }
+  return () => {
+    listeners.delete(listener)
+    if (!attached) return
+    try {
+      window.removeEventListener('storage', onStorage)
+    } catch {
+      /* ignore */
+    }
+  }
+}
+
+/**
+ * 给定偏好与当前生产单状态，判断芯片是否应可见。
+ * null（没有生产单状态）永远不显示——这是渲染层与测试共用的唯一判据。
+ */
+export function isRunChipVisible(mode: RunChipMode, state: RunState | null | undefined): boolean {
+  if (state === null || state === undefined) return false
+  if (mode === 'off') return false
+  if (mode === 'active') return state.status === 'running' || state.status === 'paused'
+  return true
+}