@waterwx/dsh-novel-forge 1.6.0 → 1.7.0

package/lib/types/client/api.d.ts

@@ -98,6 +98,7 @@ export declare class NovelApi {
         no: number;
     }>;
     /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+    imageTest(req: import('../protocol.ts').ImageTestRequest): Promise<import('../protocol.ts').ImageTestResponse>;
     roles(req: import('../protocol.ts').RolesRequest): Promise<import('../protocol.ts').RolesResponse>;
     /** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
     scenes(req: import('../protocol.ts').ScenesRequest): Promise<import('../protocol.ts').ScenesResponse>;

package/lib/types/client/panel/MangaWorkspace.d.ts

@@ -1,13 +1,15 @@
 import type { NovelApi } from '../api.ts';
-import type { ChapterPlan, ProjectState } from '../../protocol.ts';
-export declare function MangaWorkspace({ api, project, chapters, onProjectChanged, imageApiEnabled, onProgress, }: {
+import type { ChapterPlan, ImageModelConfig, ProjectState } from '../../protocol.ts';
+export declare function MangaWorkspace({ api, project, chapters, onProjectChanged, imageApiEnabled, imageModels, onProgress, }: {
     api: NovelApi;
     project: ProjectState | null;
     chapters: ChapterPlan[];
     /** 方案/资产变更已持久化后触发（刷新项目）。 */
     onProjectChanged?: () => void | Promise<void>;
-    /** 是否启用豆包生图。 */
+    /** 是否启用生图。 */
     imageApiEnabled?: boolean;
-    /** 上报到「工作进度」控制台（漫剧工作台内所有 LLM/方案操作）。 */
+    /** 生图模型库（AI 生图可选模型）。 */
+    imageModels?: ImageModelConfig[];
+    /** 上报到「AI进度」控制台（漫剧工作台内所有 LLM/方案操作）。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

package/lib/types/client/panel/RoleVisualPanel.d.ts

@@ -1,13 +1,15 @@
 import type { NovelApi } from '../api.ts';
-import type { ProjectState } from '../../protocol.ts';
-export declare function RoleVisualPanel({ api, project, refresh, styleId, filterId, imageApiEnabled, onGotoRoles, onProgress, }: {
+import type { ImageModelConfig, ProjectState } from '../../protocol.ts';
+export declare function RoleVisualPanel({ api, project, refresh, styleId, filterId, imageApiEnabled, imageModels, onGotoRoles, onProgress, }: {
     api: NovelApi;
     project: ProjectState | null;
     refresh: () => void | Promise<void>;
     styleId?: string;
     filterId?: string;
     imageApiEnabled?: boolean;
+    /** 生图模型库（AI 生图时可选择用哪条）。 */
+    imageModels?: ImageModelConfig[];
     onGotoRoles?: () => void;
-    /** 上报到「工作进度」控制台（角色形象页 / 漫剧工作台共用）。 */
+    /** 上报到「AI进度」控制台（角色形象页 / 漫剧工作台共用）。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

package/lib/types/client/panel/SceneLibrary.d.ts

@@ -9,6 +9,6 @@ export declare function SceneLibrary({ api, project, refresh, styleId, filterId,
     styleId?: string;
     /** 可选滤镜风格 id。 */
     filterId?: string;
-    /** 上报到「工作进度」控制台。 */
+    /** 上报到「AI进度」控制台。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

package/lib/types/client/panel/StoryboardTab.d.ts

@@ -10,6 +10,6 @@ export declare function StoryboardTab({ api, project, chapters, onProjectChanged
     styleId?: string;
     /** 可选滤镜风格 id。 */
     filterId?: string;
-    /** 上报到「工作进度」控制台（分镜三步生成）。 */
+    /** 上报到「AI进度」控制台（分镜三步生成）。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

package/lib/types/engine.d.ts

@@ -136,7 +136,14 @@ export declare function suggestOutlines(ctx: Context, config: NovelConfig, idea:
  *  @param budgetTokens token 预算上限（超过即截断章节取样）。
  */
 export declare function breakdownBook(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, scope?: string, preset?: 'quick' | 'standard', budgetTokens?: number): Promise<BreakdownResponse>;
-export declare function generateRoleReferenceImage(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, name: string, style?: string): Promise<string>;
+/** 生图接口连通性测试（设置页模型条目用）：GET {baseURL}/models，计时返回延迟。 */
+export declare function testImageEndpoint(baseURL: string, apiKey: string, model?: string): Promise<{
+    ok: boolean;
+    ms: number;
+    message?: string;
+    modelFound?: boolean;
+}>;
+export declare function generateRoleReferenceImage(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, name: string, style?: string, modelId?: string): Promise<string>;
 /** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 export declare function analyzePlotlineHealth(ctx: Context, config: NovelConfig, project: ProjectState): Promise<PlotlineHealthReport>;
 /** ✨ AI 剧情方案：基于健康检查结果设计下一阶段方向与建议新线。 */

package/lib/types/index.d.ts

@@ -8,7 +8,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
-import type { NovelConfig } from './protocol.ts';
+import type { ImageModelConfig, NovelConfig } from './protocol.ts';
 /** Stable cordis plugin name. */
 export declare const name = "novel-forge";
 /** Services required before the novel-forge surfaces can mount. */
@@ -49,11 +49,13 @@ export interface Config {
     autoAuthorReview?: boolean;
     /** 修订/润色产出草稿后自动附带一次 AI 审查（默认开，可在设置页关闭省 token）。 */
     autoReviewAfterRevise?: boolean;
-    /** 豆包/Seedream 生图 API Key。 */
+    /** 生图模型库（多套并存，启用一条生效）。 */
+    imageModels?: ImageModelConfig[];
+    /** 豆包/Seedream 生图 API Key（旧字段，兼容迁移用）。 */
     imageApiKey?: string;
-    /** 豆包/Seedream 生图模型 ID。 */
+    /** 豆包/Seedream 生图模型 ID（旧字段，兼容迁移用）。 */
     imageApiModel?: string;
-    /** 是否启用豆包生图（默认关）。 */
+    /** 是否启用豆包生图（旧字段，兼容迁移用）。 */
     imageApiEnabled?: boolean;
 }
 export declare const Config: z<Config>;

package/lib/types/protocol.d.ts

@@ -49,6 +49,8 @@ export declare const NOVEL_API: {
     readonly storyboardTable: "/api/dsh-novel-forge/storyboard/table";
     /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
     readonly storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts";
+    /** 生图接口连通性测试（设置页每个模型条目用）。 */
+    readonly imageTest: "/api/dsh-novel-forge/image-test";
     /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
     readonly reset: "/api/dsh-novel-forge/reset";
     /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -825,11 +827,32 @@ export interface RolesRequest {
     label?: string;
     /** op='imageGenerate' 时的漫画风格预设 id（用于统一角色图与漫画页风格）。 */
     style?: string;
+    /** op='imageGenerate' 时指定生图模型库条目 id（缺省用启用条目）。 */
+    modelId?: string;
     /** op='visual' / op='promptKit' 时的漫剧基底风格 id（角色图按方案风格重出）。 */
     styleId?: string;
     /** op='visual' / op='promptKit' 时的可选滤镜风格 id。 */
     filterId?: string;
 }
+/** POST /image-test 请求：测一个生图接口的连通性与延迟（不落盘）。 */
+export interface ImageTestRequest {
+    /** OpenAI 兼容生图接口地址。 */
+    baseURL: string;
+    /** API Key。 */
+    apiKey: string;
+    /** 模型 id（顺带校验是否在接口模型列表里，可选）。 */
+    model?: string;
+}
+/** POST /image-test 响应。 */
+export interface ImageTestResponse {
+    ok: boolean;
+    /** 连通延迟（毫秒）。 */
+    ms?: number;
+    /** 失败原因。 */
+    message?: string;
+    /** 模型 id 是否出现在接口的模型列表（探测成功时才有）。 */
+    modelFound?: boolean;
+}
 /** POST /roles 响应。 */
 export interface RolesResponse {
     roles: RoleRecord[];
@@ -973,6 +996,21 @@ export interface ProjectState {
     createdAt: string;
     updatedAt: string;
 }
+/** 生图模型配置（模型库条目，可多套并存，启用一条生效）。 */
+export interface ImageModelConfig {
+    /** 条目 id（本地唯一）。 */
+    id: string;
+    /** 展示名（如「豆包 Seedream」「即梦」）。 */
+    name: string;
+    /** OpenAI 兼容生图接口地址（如 https://ark.cn-beijing.volces.com/api/v3）。 */
+    baseURL: string;
+    /** API Key。 */
+    apiKey: string;
+    /** 生图模型 id（如 doubao-seedream-5-0-pro-260628）。 */
+    model: string;
+    /** 是否启用（同时只启用一条）。 */
+    enabled: boolean;
+}
 /** Runtime config surface exposed to the panel (subset of plugin Config). */
 export interface NovelConfig {
     /** Absolute path of the default docx outline to load. */
@@ -999,11 +1037,15 @@ export interface NovelConfig {
     autoAuthorReview: boolean;
     /** 修订/润色产出草稿后是否自动附带一次 AI 审查（工作区显示新稿评分与剩余问题）。 */
     autoReviewAfterRevise: boolean;
-    /** 豆包/Seedream 生图 API Key（保存在服务端配置，不暴露给前端明文回显）。 */
+    /** 生图模型库（多套并存，启用一条生效；旧 imageApiKey/imageApiModel 自动迁移为一条）。 */
+    imageModels?: ImageModelConfig[];
+    /** 运行时生效的生图接口地址（= 启用条目，兼容旧代码读取）。 */
+    imageBaseUrl?: string;
+    /** 运行时生效的生图 API Key（= 启用条目，兼容旧代码读取）。 */
     imageApiKey?: string;
-    /** 豆包/Seedream 生图模型 ID（如 doubao-seedream-5-0-pro-260628）。 */
+    /** 运行时生效的生图模型 id（= 启用条目，兼容旧代码读取）。 */
     imageApiModel?: string;
-    /** 是否启用豆包生图（默认关，避免误调用付费 API）。 */
+    /** 是否启用生图（= 存在启用条目）。 */
     imageApiEnabled?: boolean;
 }
 /** GET /status response. */
@@ -1242,6 +1284,8 @@ export interface ConfigPatch {
     imageApiKey?: string;
     imageApiModel?: string;
     imageApiEnabled?: boolean;
+    /** 生图模型库（完整替换保存）。 */
+    imageModels?: ImageModelConfig[];
 }
 /** One assistant conversation message (persisted per project). */
 export interface AssistantMessage {

package/package.json

@@ -1,98 +1,99 @@
-{
-  "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.6.0",
-  "type": "module",
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
-    },
-    "./src/*": "./src/*",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-ui-settings"
-      ],
-      "platform": "web"
-    }
-  },
-  "dependencies": {
-    "fflate": "^0.8.2",
-    "schemastery": "^3.18.0"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
-    "@types/node": "^22.20.0",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "^18.3.5",
-    "lightningcss": "1.32.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "tsdown": "0.22.2",
-    "typescript": "~5.7.2",
-    "vitest": "^3.0.0"
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.js.map",
-    "lib/**/*.d.ts",
-    "lib/**/*.d.ts.map",
-    "src",
-    "assets/styles",
-    "scripts/patch-schemastery.mjs",
-    "cordis.patch.yml",
-    "README.md"
-  ],
-  "license": "Apache-2.0",
-  "scripts": {
-    "postinstall": "node scripts/patch-schemastery.mjs",
-    "build": "tsc -p tsconfig.build.json && tsdown",
-    "bundle": "tsdown",
-    "watch": "tsdown --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
-  }
-}
+{
+  "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.7.0",
+  "type": "module",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "fflate": "^0.8.2",
+    "lucide-react": "^1.33.0",
+    "schemastery": "^3.18.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.5",
+    "lightningcss": "1.32.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "0.22.2",
+    "typescript": "~5.7.2",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "lib/**/*.d.ts",
+    "lib/**/*.d.ts.map",
+    "src",
+    "assets/styles",
+    "scripts/patch-schemastery.mjs",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "Apache-2.0",
+  "scripts": {
+    "postinstall": "node scripts/patch-schemastery.mjs",
+    "build": "tsc -p tsconfig.build.json && tsdown",
+    "bundle": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/src/client/api.ts

@@ -228,6 +228,10 @@ export class NovelApi {
   }
 
   /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+  async imageTest(req: import('../protocol.ts').ImageTestRequest): Promise<import('../protocol.ts').ImageTestResponse> {
+    return postJson<import('../protocol.ts').ImageTestResponse>(NOVEL_API.imageTest, req)
+  }
+
   async roles(req: import('../protocol.ts').RolesRequest): Promise<import('../protocol.ts').RolesResponse> {
     return postJson<import('../protocol.ts').RolesResponse>(NOVEL_API.roles, req)
   }

package/src/client/panel/MangaWorkspace.tsx

@@ -5,7 +5,7 @@
  */
 import { useMemo, useState } from 'react'
 import type { NovelApi } from '../api.ts'
-import type { ChapterPlan, MangaPlan, ProjectState, RoleRecord } from '../../protocol.ts'
+import type { ChapterPlan, ImageModelConfig, MangaPlan, ProjectState, RoleRecord } from '../../protocol.ts'
 import { STYLE_CATEGORIES, STYLE_LIBRARY, findStyle, stylesByCategory, type StyleCategory } from '../../style-library.ts'
 import { StyleCard } from './StyleCard.tsx'
 import { StoryboardTab } from './StoryboardTab.tsx'
@@ -19,6 +19,7 @@ export function MangaWorkspace({
   chapters,
   onProjectChanged,
   imageApiEnabled,
+  imageModels,
   onProgress,
 }: {
   api: NovelApi
@@ -26,9 +27,11 @@ export function MangaWorkspace({
   chapters: ChapterPlan[]
   /** 方案/资产变更已持久化后触发（刷新项目）。 */
   onProjectChanged?: () => void | Promise<void>
-  /** 是否启用豆包生图。 */
+  /** 是否启用生图。 */
   imageApiEnabled?: boolean
-  /** 上报到「工作进度」控制台（漫剧工作台内所有 LLM/方案操作）。 */
+  /** 生图模型库（AI 生图可选模型）。 */
+  imageModels?: ImageModelConfig[]
+  /** 上报到「AI进度」控制台（漫剧工作台内所有 LLM/方案操作）。 */
   onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void
 }) {
   const plans = useMemo(() => project?.mangaPlans ?? [], [project?.mangaPlans])
@@ -260,6 +263,7 @@ export function MangaWorkspace({
           styleId={activePlan?.styleId}
           filterId={activePlan?.filterId}
           imageApiEnabled={imageApiEnabled}
+          imageModels={imageModels}
           onProgress={onProgress}
         />
       )}