@waterwx/dsh-novel-forge 1.8.0 → 1.9.0

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

@@ -3,7 +3,7 @@
  * fetch, same origin; generation/rewrite/polish ride NDJSON streams read
  * incrementally.
  */
-import { 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';
+import { type AssetsPatch, type AssetsResponse, type AddModelRequest, type AddModelResponse, type LlmModelsResponse, type LlmProvidersResponse, type LlmVendorsResponse, type RemoveProviderRequest, type RemoveProviderResponse, type BibleResponse, type ChapterResponse, type ConfigPatch, type ExportResponse, type ForeshadowRequest, type ForeshadowResponse, type JobFrame, type LoadOutlineResponse, type LlmTestResponse, 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 declare class NovelApiError extends Error {
     constructor(message: string);
@@ -99,6 +99,18 @@ export declare class NovelApi {
     }>;
     /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
     imageTest(req: import('../protocol.ts').ImageTestRequest): Promise<import('../protocol.ts').ImageTestResponse>;
+    /** 对选中的提供商/模型发一次最小真实调用，验证连通性。 */
+    llmTest(provider: string, model: string): Promise<LlmTestResponse>;
+    /** 添加模型：厂商直填 key，或自定义 OpenAI 兼容路由（写 DSH 凭据 + 注册路由）。 */
+    addModel(req: AddModelRequest): Promise<AddModelResponse>;
+    /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+    llmVendors(): Promise<LlmVendorsResponse>;
+    /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+    llmModels(provider: string): Promise<LlmModelsResponse>;
+    /** 已注册的提供方路由列表（提供方管理卡片）。 */
+    llmProviders(): Promise<LlmProvidersResponse>;
+    /** 移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+    removeProvider(req: RemoveProviderRequest): Promise<RemoveProviderResponse>;
     roles(req: import('../protocol.ts').RolesRequest): Promise<import('../protocol.ts').RolesResponse>;
     /** 漫剧角色库：从分镜提名 / 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
     mangaRoles(req: import('../protocol.ts').MangaRolesRequest): Promise<import('../protocol.ts').MangaRolesResponse>;

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

@@ -142,7 +142,23 @@ export declare const zh: {
     readonly 'settings.provider': "模型提供商";
     readonly 'settings.model': "模型";
     readonly 'settings.modelCustom': "自定义…";
+    readonly 'settings.customProvider': "自定义提供商…";
+    readonly 'settings.edit': "编辑";
+    readonly 'settings.delete': "删除";
     readonly 'settings.modelCustomPlaceholder': "输入任意模型 id";
+    readonly 'settings.savedModels': "我的模型";
+    readonly 'settings.modelCards': "模型卡片（内置 + 已添加）";
+    readonly 'settings.savedModelName': "名称";
+    readonly 'settings.addModel': "添加模型";
+    readonly 'settings.catalogRefresh': "刷新厂商";
+    readonly 'settings.refreshModels': "刷新模型";
+    readonly 'settings.savedModelsHint': "手动添加常用模型（provider + 模型 id），点击即可切换当前模型；厂商模式会写入 DSH 凭据并注册路由。";
+    readonly 'settings.testConnection': "测试连通";
+    readonly 'settings.testRunning': "测试中";
+    readonly 'settings.testOk': "连通";
+    readonly 'settings.testFail': "失败";
+    readonly 'settings.testHint': "真实发送一次最小调用（约几十 token），验证 Key / 端点 / 模型可用。";
+    readonly 'settings.reasoningSection': "推理强度";
     readonly 'settings.reasoningEffort': "写作类任务思考强度 (reasoningEffort)";
     readonly 'settings.reasoningHint': "章节生成/润色/重写/审稿等写作任务使用；关掉更省更快。";
     readonly 'settings.analysisReasoning': "分析类任务思考强度（提炼/拆书/反推大纲）";

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

@@ -1,6 +1,7 @@
 import type { NovelApi } from '../api.ts';
 import type { BookshelfSnapshot } from '../../protocol.ts';
-export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, adaptEnabled }: {
+import { type ProgressLine } from './ProgressConsole.tsx';
+export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress }: {
     api: NovelApi;
     shelf: BookshelfSnapshot;
     onOpenBook: (id: string) => void;
@@ -17,4 +18,13 @@ export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBo
     onOpacity?: (n: number) => void;
     /** 是否启用改编模式（默认 false=隐藏入口）。 */
     adaptEnabled?: boolean;
+    /** AI 进度实时状态（与书内共享同一份）。 */
+    progress?: ProgressLine[];
+    busy?: boolean;
+    busyLabel?: string;
+    liveBar?: {
+        text: string;
+        ratio?: number;
+    } | null;
+    onClearProgress?: () => void;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,14 @@
+import type { NovelApi } from '../api.ts';
+import type { SavedModel } from '../../protocol.ts';
+/** 目录不可用时回退的内置预设（历史行为）。 */
+export declare const FALLBACK_MODEL_PRESETS: readonly ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"];
+export interface ModelManagerProps {
+    api: NovelApi;
+    provider: string;
+    model: string;
+    savedModels: SavedModel[];
+    onProvider: (provider: string) => void;
+    onModel: (model: string) => void;
+    onSavedModels: (models: SavedModel[]) => void;
+}
+export declare function ModelManager({ api, provider, model, onProvider, onModel }: ModelManagerProps): JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { NovelApi } from '../api.ts';
+/** 目录不可用时回退的内置预设（历史行为）。 */
+export declare const FALLBACK_MODEL_PRESETS: readonly ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"];
+export interface ModelPickerProps {
+    api: NovelApi;
+    provider: string;
+    model: string;
+    onProvider: (provider: string) => void;
+    onModel: (model: string) => void;
+}
+export declare function ModelPicker({ api, provider, model, onProvider, onModel }: ModelPickerProps): JSX.Element;

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

@@ -0,0 +1,17 @@
+export interface ProgressLine {
+    id: number;
+    text: string;
+    kind: 'info' | 'done' | 'error';
+    live?: boolean;
+    ratio?: number;
+}
+export declare function ProgressConsole({ progress, busy, busyLabel, liveBar, onClear }: {
+    progress: ProgressLine[];
+    busy: boolean;
+    busyLabel: string;
+    liveBar: {
+        text: string;
+        ratio?: number;
+    } | null;
+    onClear: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { NovelConfig } from '../../protocol.ts';
+export interface ReasoningSectionProps {
+    reasoningEffort: NovelConfig['reasoningEffort'];
+    analysisReasoning: NovelConfig['analysisReasoning'];
+    onChange: (patch: {
+        reasoningEffort?: NovelConfig['reasoningEffort'];
+        analysisReasoning?: NovelConfig['analysisReasoning'];
+    }) => void;
+}
+export declare function ReasoningSection({ reasoningEffort, analysisReasoning, onChange }: ReasoningSectionProps): JSX.Element;

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

@@ -1,5 +1,5 @@
 import type { NovelApi } from '../api.ts';
-type SettingsTab = 'model' | 'writing' | 'image' | 'files' | 'appearance' | 'background';
+type SettingsTab = 'model' | 'writing' | 'image' | 'files' | 'appearance';
 type ThemeMode = 'system' | 'light' | 'dark';
 type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay';
 type ThemeDensity = 'comfort' | 'compact' | 'spacious';

package/lib/types/engine.d.ts

@@ -12,7 +12,7 @@
  */
 export declare const COMPLIANCE_REDLINES: ReadonlyArray<string>;
 import type { Context } from '@deepseek-ai/cordis';
-import type { AdaptationDimension, AdaptAnalyzeResponse, AdaptationMapping, AdaptProposeResponse, AuditIssue, AuthorReview, BreakdownResponse, ChapterPlan, Foreshadow, NovelConfig, OutlineCandidate, Plotline, PlotlineHealthReport, PlotlinePlan, ProjectState, ReviewReport, RoleRecord, RoleStatusCard, SceneCard, StoryBible, StoryboardSkeleton, StoryboardTable, StoryboardPrompt, MangaRoleCandidate, Volume, WorldState } from './protocol.ts';
+import type { AdaptationDimension, AdaptAnalyzeResponse, AdaptationMapping, AdaptProposeResponse, AuditIssue, AuthorReview, BreakdownResponse, ChapterPlan, Foreshadow, NovelConfig, OutlineCandidate, Plotline, PlotlineHealthReport, PlotlinePlan, ProjectState, ReviewReport, RoleRecord, RoleStatusCard, SceneCard, StoryBible, StoryboardSkeleton, StoryboardTable, StoryboardPrompt, AddModelRequest, AddModelResponse, LlmModelsResponse, LlmVendorsResponse, LlmProvidersResponse, RemoveProviderRequest, RemoveProviderResponse, LlmTestResponse, MangaRoleCandidate, Volume, WorldState } from './protocol.ts';
 /** Project state file name inside the output dir. */
 export declare const PROJECT_FILE = "novel-project.json";
 /** Chapter output file name, e.g. 第001章_开篇.md */
@@ -147,6 +147,21 @@ export declare function testImageEndpoint(baseURL: string, apiKey: string, model
     message?: string;
     modelFound?: boolean;
 }>;
+/** 对选中的提供商/模型发一次最小真实调用（maxTokens=16），验证 Key / 端点 / 模型可用。 */
+export declare function testLlmModel(ctx: Context, provider: string, model: string): Promise<LlmTestResponse>;
+/** 运行时厂商目录：DSH pi-ai 可配置提供方 + 内置适配器，作为「添加模型」下拉。 */
+export declare function listLlmVendors(ctx: Context): Promise<LlmVendorsResponse>;
+/** 查询某个 provider 当前可用模型（添加成功后可即时刷新下拉）。 */
+export declare function listLlmModels(ctx: Context, provider: string): Promise<LlmModelsResponse>;
+/** 当前已注册的提供方路由列表（提供方管理卡片）。 */
+export declare function listLlmProviders(ctx: Context): Promise<LlmProvidersResponse>;
+/** 移除一个提供方：unset 凭据 ref + 移除 llm-pi-ai providers 路由。 */
+export declare function removeLlmProvider(ctx: Context, req: RemoveProviderRequest): Promise<RemoveProviderResponse>;
+/**
+ * 添加模型（DSH 同款体验）：厂商直填 API Key，或自定义 OpenAI 兼容路由。
+ * 写入 DSH 凭据 refs，并（必要时）注册/更新 llm-pi-ai provider 路由。
+ */
+export declare function registerLlmModel(ctx: Context, req: AddModelRequest): Promise<AddModelResponse>;
 /** 小说角色库：生成角色定妆图并写回角色卡（imageUrl）。 */
 export declare function generateRoleReferenceImage(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, name: string, style?: string, modelId?: string): Promise<string>;
 /** 漫剧角色卡：生成定妆图并写回漫剧卡（imageUrl）。 */

package/lib/types/protocol.d.ts

@@ -55,6 +55,18 @@ export declare const NOVEL_API: {
     readonly storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts";
     /** 生图接口连通性测试（设置页每个模型条目用）。 */
     readonly imageTest: "/api/dsh-novel-forge/image-test";
+    /** LLM 模型连通性测试：真实最小调用，验证 Key / 端点 / 模型可用。 */
+    readonly llmTest: "/api/dsh-novel-forge/llm-test";
+    /** 添加模型：厂商直填 key 或自定义路由，写进 DSH 凭据与 llm-pi-ai 路由。 */
+    readonly addModel: "/api/dsh-novel-forge/llm-add";
+    /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+    readonly llmVendors: "/api/dsh-novel-forge/llm-vendors";
+    /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+    readonly llmModels: "/api/dsh-novel-forge/llm-models";
+    /** 已注册的提供方路由列表（提供方管理）。 */
+    readonly llmProviders: "/api/dsh-novel-forge/llm-providers";
+    /** 移除一个提供方。 */
+    readonly llmRemove: "/api/dsh-novel-forge/llm-remove";
     /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
     readonly reset: "/api/dsh-novel-forge/reset";
     /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -995,6 +1007,21 @@ export interface ImageTestResponse {
     /** 模型 id 是否出现在接口的模型列表（探测成功时才有）。 */
     modelFound?: boolean;
 }
+/** POST /llm-test 请求：对选中的提供商/模型发一次最小真实调用。 */
+export interface LlmTestRequest {
+    provider: string;
+    model: string;
+}
+/** POST /llm-test 响应。 */
+export interface LlmTestResponse {
+    ok: boolean;
+    /** 连通延迟（毫秒）。 */
+    ms?: number;
+    /** 失败原因（已映射为人话）。 */
+    message?: string;
+    /** 稳定错误码（LlmError code），便于排查。 */
+    code?: string;
+}
 /** POST /roles 响应。 */
 export interface RolesResponse {
     roles: RoleRecord[];
@@ -1158,6 +1185,122 @@ export interface ImageModelConfig {
     enabled: boolean;
 }
 /** Runtime config surface exposed to the panel (subset of plugin Config). */
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
+export interface SavedModel {
+    /** 唯一 id（前端生成的短 id）。 */
+    id: string;
+    /** 展示名（可为空，回退到 model）。 */
+    name: string;
+    /** DSH 提供商路由（如 zai-coding-cn）。 */
+    provider: string;
+    /** 模型 id（如 glm-5.3-flash）。 */
+    model: string;
+}
+/** DSH 模型添加：厂商预设（选择厂商，直接填 API Key）。 */
+export interface LlmVendor {
+    id: string;
+    name: string;
+    /** 该厂商对应的 provider 路由。 */
+    route: string;
+    /** DSH 凭据引用名（写入 .credentials.yaml 的 refs）。 */
+    apiKeyEnv: string;
+    /** 默认模型 id。 */
+    defaultModel: string;
+    /** 建议可选模型 id 列表（下拉 data-list 用）。 */
+    models: string[];
+    /** 内置适配器（如 deepseek-official），无需注册 pi-ai 路由。 */
+    builtin?: boolean;
+}
+/** 预置的常见厂商（id=provider 路由；添加模型下拉兜底用，其余厂商由运行时目录动态补充）。 */
+export declare const LLM_VENDORS: LlmVendor[];
+/** 运行时厂商目录的一项（添加到模型下拉；由 DSH 的 pi-ai 可配置提供方动态生成）。 */
+export interface LlmVendorOption {
+    /** provider 路由 id（也是厂商下拉的值）。 */
+    id: string;
+    /** 展示名。 */
+    name: string;
+    /** 建议模型 id（可为空，用户手填）。 */
+    models: string[];
+    /** 已知 DSH 凭据引用名；为空时 host 生成 `PI_AI_<ID>_API_KEY`。 */
+    apiKeyEnv?: string;
+    /** 内置适配器（只写凭据，不注册 pi-ai 路由）。 */
+    builtin?: boolean;
+}
+/** GET /llm-vendors 响应。 */
+export interface LlmVendorsResponse {
+    vendors: LlmVendorOption[];
+}
+/** /llm-models 里的一条模型。 */
+export interface LlmModelOption {
+    id: string;
+    name: string;
+}
+/** GET /llm-models?provider=x 响应。 */
+export interface LlmModelsResponse {
+    models: LlmModelOption[];
+}
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+    providers: {
+        id: string;
+        name: string;
+    }[];
+}
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+    provider: string;
+    /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+    apiKeyEnv?: string;
+}
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+    ok: boolean;
+    message?: string;
+}
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+    providers: {
+        id: string;
+        name: string;
+    }[];
+}
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+    provider: string;
+    /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+    apiKeyEnv?: string;
+}
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+    ok: boolean;
+    message?: string;
+}
+/** POST /llm-add 请求：添加一个模型（厂商直填 key，或自定义路由）。 */
+export interface AddModelRequest {
+    mode: 'vendor' | 'custom';
+    /** 厂商模式用：provider 路由 id（来自 /llm-vendors）。 */
+    vendor?: string;
+    /** 厂商已知的 DSH 凭据引用名（可选；为空时 host 生成）。 */
+    apiKeyEnv?: string;
+    /** 自定义模式用：provider 路由 id。 */
+    provider?: string;
+    /** 模型 id。 */
+    model: string;
+    /** API Key。 */
+    apiKey: string;
+    /** 展示名（可选）。 */
+    name?: string;
+    /** 自定义模式用：OpenAI 兼容 base URL。 */
+    baseURL?: string;
+}
+/** POST /llm-add 响应。 */
+export interface AddModelResponse {
+    ok: boolean;
+    saved: SavedModel;
+    provider: string;
+    message?: string;
+}
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
 export interface NovelConfig {
     /** Absolute path of the default docx outline to load. */
     outlinePath: string;
@@ -1201,6 +1344,8 @@ export interface NovelConfig {
     themeOpacity?: number;
     /** 是否启用改编模式（默认关闭；发布后开启）。 */
     enableAdaptMode?: boolean;
+    /** 手动添加的模型库（「我的模型」条目；只存插件内）。 */
+    savedModels?: SavedModel[];
 }
 /** GET /status response. */
 export interface StatusResponse {
@@ -1447,6 +1592,8 @@ export interface ConfigPatch {
     enableAdaptMode?: boolean;
     /** 生图模型库（完整替换保存）。 */
     imageModels?: ImageModelConfig[];
+    /** 手动添加的模型库（完整替换保存）。 */
+    savedModels?: SavedModel[];
 }
 /** One assistant conversation message (persisted per project). */
 export interface AssistantMessage {

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 chapters with LLM, generate chapter by chapter (3000-4000 chars each), and save every chapter as Markdown into your chosen output folder.",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"

package/src/client/api.ts

@@ -8,6 +8,13 @@ import {
   NOVEL_API,
   type AssetsPatch,
   type AssetsResponse,
+  type AddModelRequest,
+  type AddModelResponse,
+  type LlmModelsResponse,
+  type LlmProvidersResponse,
+  type LlmVendorsResponse,
+  type RemoveProviderRequest,
+  type RemoveProviderResponse,
   type BibleResponse,
   type ChapterResponse,
   type ConfigPatch,
@@ -16,6 +23,7 @@ import {
   type ForeshadowResponse,
   type JobFrame,
   type LoadOutlineResponse,
+  type LlmTestResponse,
   type NovelConfig,
   type PlanResponse,
   type ReviewReport,
@@ -232,6 +240,39 @@ export class NovelApi {
     return postJson<import('../protocol.ts').ImageTestResponse>(NOVEL_API.imageTest, req)
   }
 
+  /** 对选中的提供商/模型发一次最小真实调用，验证连通性。 */
+  async llmTest(provider: string, model: string): Promise<LlmTestResponse> {
+    return postJson<LlmTestResponse>(NOVEL_API.llmTest, { provider, model })
+  }
+
+  /** 添加模型：厂商直填 key，或自定义 OpenAI 兼容路由（写 DSH 凭据 + 注册路由）。 */
+  async addModel(req: AddModelRequest): Promise<AddModelResponse> {
+    return postJson<AddModelResponse>(NOVEL_API.addModel, req)
+  }
+
+  /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+  async llmVendors(): Promise<LlmVendorsResponse> {
+    const response = await fetch(NOVEL_API.llmVendors)
+    return readJson<LlmVendorsResponse>(response)
+  }
+
+  /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+  async llmModels(provider: string): Promise<LlmModelsResponse> {
+    const response = await fetch(NOVEL_API.llmModels + '?provider=' + encodeURIComponent(provider))
+    return readJson<LlmModelsResponse>(response)
+  }
+
+  /** 已注册的提供方路由列表（提供方管理卡片）。 */
+  async llmProviders(): Promise<LlmProvidersResponse> {
+    const response = await fetch(NOVEL_API.llmProviders)
+    return readJson<LlmProvidersResponse>(response)
+  }
+
+  /** 移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+  async removeProvider(req: RemoveProviderRequest): Promise<RemoveProviderResponse> {
+    return postJson<RemoveProviderResponse>(NOVEL_API.llmRemove, 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/locales.ts

@@ -143,7 +143,23 @@ export const zh = {
   'settings.provider': '模型提供商',
   'settings.model': '模型',
   'settings.modelCustom': '自定义…',
+  'settings.customProvider': '自定义提供商…',
+  'settings.edit': '编辑',
+  'settings.delete': '删除',
   'settings.modelCustomPlaceholder': '输入任意模型 id',
+  'settings.savedModels': '我的模型',
+  'settings.modelCards': '模型卡片（内置 + 已添加）',
+  'settings.savedModelName': '名称',
+  'settings.addModel': '添加模型',
+  'settings.catalogRefresh': '刷新厂商',
+  'settings.refreshModels': '刷新模型',
+  'settings.savedModelsHint': '手动添加常用模型（provider + 模型 id），点击即可切换当前模型；厂商模式会写入 DSH 凭据并注册路由。',
+  'settings.testConnection': '测试连通',
+  'settings.testRunning': '测试中',
+  'settings.testOk': '连通',
+  'settings.testFail': '失败',
+  'settings.testHint': '真实发送一次最小调用（约几十 token），验证 Key / 端点 / 模型可用。',
+  'settings.reasoningSection': '推理强度',
   'settings.reasoningEffort': '写作类任务思考强度 (reasoningEffort)',
   'settings.reasoningHint': '章节生成/润色/重写/审稿等写作任务使用；关掉更省更快。',
   'settings.analysisReasoning': '分析类任务思考强度（提炼/拆书/反推大纲）',
@@ -295,7 +311,23 @@ export const en: Record<string, string> = {
   'settings.provider': 'Provider',
   'settings.model': 'Model',
   'settings.modelCustom': 'Custom…',
+  'settings.customProvider': 'Custom provider…',
+  'settings.edit': 'Edit',
+  'settings.delete': 'Delete',
   'settings.modelCustomPlaceholder': 'Type any model id',
+  'settings.savedModels': 'My Models',
+  'settings.modelCards': 'Model cards (built-in + added)',
+  'settings.savedModelName': 'Name',
+  'settings.addModel': 'Add model',
+  'settings.catalogRefresh': 'Refresh vendors',
+  'settings.refreshModels': 'Refresh models',
+  'settings.savedModelsHint': 'Manually add a model (provider + model id); click to switch. Vendor mode writes the key into DSH credentials and registers the route.',
+  'settings.testConnection': 'Test',
+  'settings.testRunning': 'Testing',
+  'settings.testOk': 'OK',
+  'settings.testFail': 'Failed',
+  'settings.testHint': 'Sends one minimal real call (~dozens of tokens) to verify key / endpoint / model.',
+  'settings.reasoningSection': 'Reasoning',
   'settings.reasoningEffort': 'Writing-task reasoning effort',
   'settings.analysisReasoning': 'Analysis-task reasoning (extract / breakdown / reverse outline)',
   'settings.analysisReasoningHint': 'One-off analysis tasks (roles/scenes/bible extract, breakdown, reverse outline) default to low; not affected by the writing-level switch.',

package/src/client/panel/AdaptModeView.tsx

@@ -95,11 +95,9 @@ export function AdaptModeView({ api }: { api: NovelApi }) {
 
   return (
     <div className={css.authorPageBody}>
-      <div className={css.authorPageHeader}>
-        <div>
-          <h2 className={css.panelTitle} style={{ margin: 0 }}>🎬 改编模式</h2>
-          <span className={css.meta}>上传全文 → 分析可改范围 → 勾选/填新值 → 生成映射表 → 术语替换执行。</span>
-        </div>
+      <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-6)' }}>
+        <h2 className={css.panelTitle} style={{ margin: 0 }}>🎬 改编模式</h2>
+        <span className={css.meta}>上传全文 → 分析可改范围 → 勾选/填新值 → 生成映射表 → 术语替换执行。</span>
       </div>
 
       <div className={css.adaptInputCard}>

package/src/client/panel/AuthorHome.tsx

@@ -9,10 +9,14 @@ import type { BookshelfSnapshot } from '../../protocol.ts'
 import { ShelfView } from './ShelfView.tsx'
 import { AdaptModeView } from './AdaptModeView.tsx'
 import { AuthorAssetsView } from './AuthorAssetsView.tsx'
-import { ProgressHomeView } from './ProgressHomeView.tsx'
+import { ProgressConsole, type ProgressLine } from './ProgressConsole.tsx'
 import { SettingsView } from './SettingsView.tsx'
 import css from './panel.module.css'
 
+/** 构建时注入的插件版本（tsdown define 替换为字符串字面量）。 */
+declare const __NOVEL_FORGE_VERSION__: string | undefined
+const PLUGIN_VERSION: string = typeof __NOVEL_FORGE_VERSION__ !== 'undefined' ? __NOVEL_FORGE_VERSION__ : '0.0.0'
+
 type AuthorNav = 'shelf' | 'adapt' | 'assets' | 'library' | 'progress' | 'settings';
 
 const NAV_ITEMS: Array<{ id: Exclude<AuthorNav, 'settings'>; label: string; icon: JSX.Element; hint: string }> = [
@@ -26,7 +30,7 @@ const NAV_ITEMS: Array<{ id: Exclude<AuthorNav, 'settings'>; label: string; icon
 function Placeholder({ title, hint }: { title: string; hint: string }) {
   return (
     <div className={css.authorPageBody}>
-      <div className={css.authorPageHeader}><h2 className={css.panelTitle} style={{ margin: 0 }}>{title}</h2><span className={css.meta}>{hint}</span></div>
+      <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-6)' }}><h2 className={css.panelTitle} style={{ margin: 0 }}>{title}</h2><span className={css.meta}>{hint}</span></div>
       <div className={css.shelfEmpty} style={{ minHeight: 160 }}>
         <span className={css.shelfEmptyIcon}><Info size={30} /></span>
         <span className={css.shelfEmptyTitle}>此入口为占位</span>
@@ -36,7 +40,7 @@ function Placeholder({ title, hint }: { title: string; hint: string }) {
   );
 }
 
-export function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, adaptEnabled }: {
+export function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress }: {
   api: NovelApi; shelf: BookshelfSnapshot;
   onOpenBook: (id: string) => void; onReadBook: (id: string) => void; onAddBook: () => void; onImportBook: () => void;
   /** 兼容旧入口：首页设置现为独立设置页，此回调保留但不再使用。 */
@@ -49,6 +53,12 @@ export function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onIm
   onOpacity?: (n: number) => void;
   /** 是否启用改编模式（默认 false=隐藏入口）。 */
   adaptEnabled?: boolean;
+  /** AI 进度实时状态（与书内共享同一份）。 */
+  progress?: ProgressLine[];
+  busy?: boolean;
+  busyLabel?: string;
+  liveBar?: { text: string; ratio?: number } | null;
+  onClearProgress?: () => void;
 }) {
   const [nav, setNav] = useState<AuthorNav>('shelf');
 
@@ -77,7 +87,7 @@ export function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onIm
           <span className={css.navTabLabel}>设置</span>
         </button>
         <div className={css.navAbout}>
-          <div className={css.navAboutRow}><span>ℹ️ v1.7.3 · 改编/资产库</span></div>
+          <div className={css.navAboutRow}><span>ℹ️ v{PLUGIN_VERSION} · 改编/资产库</span></div>
         </div>
       </nav>
       <div className={css.authorContent}>
@@ -85,7 +95,11 @@ export function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onIm
         {nav === 'adapt' && <AdaptModeView api={api} />}
         {nav === 'assets' && <AuthorAssetsView api={api} />}
         {nav === 'library' && <Placeholder title="🎨 全局写作资产库" hint="内置题材基底库 / 反AI规则库 / 风格模板 / 推进模式（跨书）" />}
-        {nav === 'progress' && <ProgressHomeView shelf={shelf} onOpenBook={onOpenBook} />}
+        {nav === 'progress' && (
+          <div className={css.authorPageBody}>
+            <ProgressConsole progress={progress ?? []} busy={busy ?? false} busyLabel={busyLabel ?? ''} liveBar={liveBar ?? null} onClear={() => onClearProgress?.()} />
+          </div>
+        )}
         {nav === 'settings' && <SettingsView api={api} onTheme={onTheme} onBackground={onBackground} onOpacity={onOpacity} />}
       </div>
     </div>