@waterwx/dsh-novel-forge 0.1.0 → 1.0.0-alpha

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

@@ -4,7 +4,7 @@
 /** zh dictionary. */
 export declare const zh: {
     readonly 'entry.label': "小说工坊";
-    readonly 'entry.tooltip': "AI 编译小说工作台：大纲 → 设定圣经 → 卷计划 → 章节计划 → 逐章生成+审稿";
+    readonly 'entry.tooltip': "AI 编译小说工作台：总纲 → 道藏 → 卷计划 → 章节计划 → 逐章生成+审稿";
     readonly 'panel.title': "小说工坊";
     readonly 'common.close': "关闭";
     readonly 'common.loading': "加载中…";
@@ -13,37 +13,37 @@ export declare const zh: {
     readonly 'common.success': "成功";
     readonly 'common.generating': "生成中…";
     readonly 'common.chars': "字";
-    readonly 'tab.workflow': "工作流";
-    readonly 'tab.overview': "大纲";
+    readonly 'tab.workflow': "工作台";
+    readonly 'tab.overview': "总纲";
     readonly 'tab.plan': "章节";
-    readonly 'tab.bible': "设定库";
-    readonly 'tab.foreshadow': "伏笔";
-    readonly 'tab.assistant': "AI 助手";
+    readonly 'tab.bible': "道藏";
+    readonly 'tab.foreshadow': "暗线";
+    readonly 'tab.assistant': "AI 编辑 Agent";
     readonly 'tab.settings': "设置";
-    readonly 'workflow.title': "创作工作流";
-    readonly 'workflow.step1': "① 加载大纲";
-    readonly 'workflow.step2': "② 提炼设定圣经";
+    readonly 'workflow.title': "创作工作台";
+    readonly 'workflow.step1': "① 加载总纲";
+    readonly 'workflow.step2': "② 提炼道藏";
     readonly 'workflow.step3': "③ 规划卷";
     readonly 'workflow.step4': "④ 生成章节计划";
     readonly 'workflow.step5': "⑤ 逐章写作 + AI 审稿";
     readonly 'workflow.step6': "⑥ 润色 / 导出";
-    readonly 'workflow.loadOutline': "读取大纲";
-    readonly 'workflow.genBible': "提炼设定圣经";
+    readonly 'workflow.loadOutline': "读取总纲";
+    readonly 'workflow.genBible': "提炼道藏";
     readonly 'workflow.genVolumes': "生成卷计划";
     readonly 'workflow.genPlan': "生成章节计划";
     readonly 'workflow.done': "已完成";
     readonly 'workflow.todo': "待办";
-    readonly 'workflow.bibleDone': "设定圣经已生成（{n} 条规则 / {c} 个角色 / {r} 条红线）";
+    readonly 'workflow.bibleDone': "道藏已生成（{n} 条规则 / {c} 个人物 / {r} 条红线）";
     readonly 'workflow.volumesDone': "卷计划已生成（{n} 卷）";
     readonly 'workflow.planDone': "章节计划已生成（{n} 章）";
-    readonly 'workflow.progress': "进度：大纲 ✓ · 设定 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章";
-    readonly 'overview.loadDocx': "从 docx 读取大纲";
-    readonly 'overview.loadDocxDefault': "读取默认大纲";
+    readonly 'workflow.progress': "进度：总纲 ✓ · 道藏 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章";
+    readonly 'overview.loadDocx': "从 docx 读取总纲";
+    readonly 'overview.loadDocxDefault': "读取默认总纲";
     readonly 'overview.loadingOutline': "正在解析 docx…";
-    readonly 'overview.outlineHint': "大纲文本（可编辑）";
-    readonly 'overview.outlineChars': "大纲字数";
-    readonly 'overview.saveOutline': "保存大纲";
-    readonly 'overview.saved': "大纲已保存";
+    readonly 'overview.outlineHint': "总纲文本（可编辑）";
+    readonly 'overview.outlineChars': "总纲字数";
+    readonly 'overview.saveOutline': "保存总纲";
+    readonly 'overview.saved': "总纲已保存";
     readonly 'overview.bookName': "书名";
     readonly 'overview.loadCustom': "指定 docx 路径";
     readonly 'overview.loadCustomHint': "绝对路径，留空使用默认";
@@ -78,17 +78,17 @@ export declare const zh: {
     readonly 'plan.summary': "章节摘要";
     readonly 'plan.volumes': "卷";
     readonly 'plan.noVolume': "未分卷";
-    readonly 'bible.title': "设定圣经";
-    readonly 'bible.gen': "AI 提炼设定圣经";
+    readonly 'bible.title': "道藏";
+    readonly 'bible.gen': "AI 提炼道藏";
     readonly 'bible.genre': "题材基调";
     readonly 'bible.worldRules': "世界规则";
-    readonly 'bible.characters': "角色卡";
+    readonly 'bible.characters': "人物志";
     readonly 'bible.redLines': "写作红线";
     readonly 'bible.style': "风格要求";
-    readonly 'bible.none': "尚未生成设定圣经。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。";
-    readonly 'foreshadow.title': "伏笔管理";
-    readonly 'foreshadow.suggest': "AI 建议伏笔";
-    readonly 'foreshadow.none': "暂无伏笔";
+    readonly 'bible.none': "尚未生成道藏。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。";
+    readonly 'foreshadow.title': "暗线管理";
+    readonly 'foreshadow.suggest': "AI 建议暗线";
+    readonly 'foreshadow.none': "暂无暗线";
     readonly 'foreshadow.status': "状态";
     readonly 'foreshadow.planned': "计划中";
     readonly 'foreshadow.planted': "已埋设";
@@ -99,15 +99,88 @@ export declare const zh: {
     readonly 'foreshadow.plantedAt': "埋设于";
     readonly 'foreshadow.setPlanted': "标记已埋设";
     readonly 'foreshadow.setResolved': "标记已回收";
+    readonly 'tab.facts': "编年录";
+    readonly 'tab.plotlines': "剧情线";
+    readonly 'plotlines.hint': "主线/支线/人物线/悬念线的推进管理：章节生成时会注入未完结的线，要求每章至少推进一条；关联章节记录推进节点。";
+    readonly 'plotlines.empty': "还没有剧情线——长篇小说建议先建主线与几条支线。";
+    readonly 'plotlines.new': "＋ 新建剧情线";
+    readonly 'plotlines.name': "线名";
+    readonly 'plotlines.kind': "类型";
+    readonly 'plotlines.kindMain': "主线";
+    readonly 'plotlines.kindBranch': "支线";
+    readonly 'plotlines.kindCharacter': "人物线";
+    readonly 'plotlines.kindMystery': "悬念线";
+    readonly 'plotlines.goal': "目标/终点";
+    readonly 'plotlines.progress': "当前进度";
+    readonly 'plotlines.status': "状态";
+    readonly 'plotlines.statusActive': "推进中";
+    readonly 'plotlines.statusPaused': "暂停";
+    readonly 'plotlines.statusResolved': "已完结";
+    readonly 'plotlines.statusAbandoned': "已废弃";
+    readonly 'plotlines.save': "保存";
+    readonly 'plotlines.cancel': "取消";
+    readonly 'plotlines.edit': "编辑";
+    readonly 'plotlines.remove': "删除";
+    readonly 'plotlines.linkChapter': "关联本章";
+    readonly 'plotlines.chapters': "已关联";
+    readonly 'plotlines.workflowTitle': "剧情线进度";
+    readonly 'plotlines.workflowEmpty': "未建剧情线（去「剧情线」页创建）";
+    readonly 'sensitive.title': "敏感词检查";
+    readonly 'sensitive.scanAll': "🔞 全书敏感词检查";
+    readonly 'sensitive.hint': "内置违禁词库硬匹配（政治/擦边/暴力/辱骂/广告/其他），发布前建议检查；只做提示，是否修改由你判断。";
+    readonly 'sensitive.clean': "✅ 未命中任何违禁词（扫描 {n} 章）";
+    readonly 'sensitive.hits': "命中 {n} 处（{chapters} 章受影响）";
+    readonly 'sensitive.goFix': "去修订";
+    readonly 'sensitive.fixPrefill': "请删除或替换正文中的违禁表达「{word}」（类别：{category}），用含蓄/间接的写法替代。";
+    readonly 'facts.title': "编年录 / 时间线（{n} 条）";
+    readonly 'facts.hint': "每章生成后自动抽取「已确立事实」（人物状态/境界资源/关系变化/伏笔落地），最近 20 条注入后续章节生成，保证长期一致。";
+    readonly 'facts.backfill': "回填历史章节事实";
+    readonly 'facts.backfilled': "已从历史章节回填 {n} 条事实";
     readonly 'settings.title': "设置";
     readonly 'settings.outlinePath': "默认大纲路径";
     readonly 'settings.outputDir': "输出目录";
     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': "分析类任务思考强度（提炼/拆书/反推大纲）";
+    readonly 'settings.analysisReasoningHint': "角色/场景/道藏提炼、拆书、反推大纲等一次性分析任务默认 low，保证质量，不受上面写作档位影响。";
+    readonly 'settings.reasoning.off': "off · 关闭思考（推荐日常写文）";
+    readonly 'settings.reasoning.low': "low · 低思考";
+    readonly 'settings.reasoning.high': "high · 高思考";
+    readonly 'settings.reasoning.max': "max · 最高思考（质检/推演）";
+    readonly 'settings.theme': "主题";
+    readonly 'settings.themeLiquid': "iOS 液态玻璃（绿）";
+    readonly 'settings.themeNeumorph': "新拟物（双阴影）";
+    readonly 'settings.themeHint': "存于浏览器本地，即时生效";
     readonly 'settings.chapterChars': "每章目标字数";
     readonly 'settings.maxTokens': "单章最大输出 tokens";
     readonly 'settings.reviewPassScore': "审稿通过分数（0-100）";
+    readonly 'settings.editorFontSize': "编辑器字号（仅编辑页显示）";
+    readonly 'settings.editorFontSizeHint': "存于浏览器本地，不影响其他设备";
     readonly 'settings.autoReview': "生成后自动审稿";
+    readonly 'settings.autoAuthorReview': "生成后自动作者复盘";
+    readonly 'settings.autoAuthorReviewHint': "复盘钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势，每章约 2000 token";
+    readonly 'settings.autoReviewAfterRevise': "修订后自动审查";
+    readonly 'settings.autoReviewAfterReviseHint': "按意见修订/润色产出草稿后自动附带一次 AI 审查，直接显示新稿评分与剩余问题（每章约 2-3k token，可关）";
     readonly 'settings.save': "保存设置";
     readonly 'settings.saved': "设置已保存";
     readonly 'settings.openFolder': "打开输出文件夹";
@@ -122,13 +195,13 @@ export declare const zh: {
     readonly 'progress.rewriting': "正在修订第 {no} 章…";
     readonly 'progress.polishing': "正在润色第 {no} 章…";
     readonly 'progress.empty': "生成/审稿进度将显示在这里";
-    readonly 'assistant.hint': "和 AI 编辑讨论剧情、人设、伏笔；达成一致后可让它直接修改大纲、设定圣经、章节内容。";
+    readonly 'assistant.hint': "和 AI 编辑 Agent 讨论剧情、人设、暗线；达成一致后可让它直接修改总纲、道藏、章节内容。";
     readonly 'assistant.placeholder': "例如：我想让第 2 章结尾加一个悬念——墟境里传来爷爷的声音…";
     readonly 'assistant.send': "发送";
     readonly 'assistant.toolStart': "⚙ 执行操作：{name}…";
     readonly 'assistant.toolDone': "✓ {name} 完成：{detail}";
     readonly 'assistant.toolError': "✗ {name} 失败：{detail}";
-    readonly 'assistant.empty': "还没有对话。和 AI 编辑聊聊剧情吧。";
+    readonly 'assistant.empty': "还没有对话。和 AI 编辑 Agent 聊聊剧情吧。";
     readonly 'status.projectNone': "输出目录中还没有项目。请先加载大纲。";
     readonly 'status.files': "已生成文件";
     readonly 'api.error': "请求失败";

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

@@ -0,0 +1,5 @@
+import type { NovelApi } from '../api.ts';
+export declare function AdaptModeView({ api, onOpenBook }: {
+    api: NovelApi;
+    onOpenBook?: (id: string) => void;
+}): import("react").JSX.Element;

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

@@ -2,6 +2,11 @@ import type { NovelApi } from '../api.ts';
 /** Props. */
 export interface AssetsTabProps {
     api: NovelApi;
+    /** 初始子页（左侧导航直达对应资产分类）。 */
+    initialTab?: AssetSubTab;
 }
+/** 写作资产子页签。 */
+type AssetSubTab = 'genre' | 'progression' | 'templates' | 'rules' | 'style';
 /** 写作资产页签。 */
-export declare function AssetsTab({ api }: AssetsTabProps): import("react").JSX.Element;
+export declare function AssetsTab({ api, initialTab }: AssetsTabProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export declare function AuthorAssetsView({ api }: {
+    api: NovelApi;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,34 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+import { type ProgressLine } from './ProgressConsole.tsx';
+export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, onEndfieldAccent, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress, onUseIdea }: {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    onOpenBook: (id: string) => void;
+    onReadBook: (id: string) => void;
+    onAddBook: () => void;
+    onImportBook: () => void;
+    /** 创意灵感 → 采纳某个灵感带入开书向导。 */
+    onUseIdea?: (idea: import('../../protocol.ts').IdeaInspirationResult['ideas'][number]) => void;
+    /** 兼容旧入口：首页设置现为独立设置页，此回调保留但不再使用。 */
+    onOpenSettings?: () => void;
+    /** 主题/模式/密度变化回调（供面板根容器实时生效）。 */
+    onTheme?: (theme: 'liquid' | 'neumorph' | 'macos' | 'clay' | 'endfield', mode: 'system' | 'light' | 'dark', density: 'comfort' | 'compact' | 'spacious') => void;
+    /** 自定义背景变化回调。 */
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    /** 玻璃透明度变化回调。 */
+    onOpacity?: (n: number) => void;
+    /** 终末地强调色变化回调。 */
+    onEndfieldAccent?: (accent: 'valley' | 'wuling') => 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/BookAnalysisView.d.ts

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export default function BookAnalysisView({ api }: {
+    api: NovelApi;
+}): JSX.Element;

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

@@ -0,0 +1,13 @@
+import type { NovelApi } from '../api.ts';
+/** 开书向导页。 */
+export declare function CreateBookView({ api, onBack, onCreated, initialIdea, initialName, }: {
+    api: NovelApi;
+    /** 返回书架。 */
+    onBack: () => void;
+    /** 开书成功：进入新书工作台。 */
+    onCreated: (id: string) => void;
+    /** 从「创意灵感」带过来的起步想法（预填到「一句话想法」输入框）。 */
+    initialIdea?: string;
+    /** 从「创意灵感」带过来的初始书名。 */
+    initialName?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { NovelApi } from '../api.ts';
+import type { DirectorTodo } from '../../protocol.ts';
+export default function DirectorView({ api, todos, onTodosChange }: {
+    api: NovelApi;
+    todos: DirectorTodo[];
+    onTodosChange?: (todos: DirectorTodo[]) => void;
+}): JSX.Element;

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

@@ -0,0 +1,22 @@
+/**
+ * 漫剧工作台·全流程步骤条（唯一导航，方案X）：
+ * ①创建方案 → ②一键生成 → ③分镜 → ④角色定妆 → ⑤场景底图 → ⑥导出使用。
+ * 每个步骤对应一个独立页面主体；完成度自动判定（读 project 现有字段）。
+ */
+import type { ProjectState } from '../../protocol.ts';
+/** 步骤 → 页面主体的一一对应目标。 */
+export type FlowTarget = 'plan' | 'rules' | 'skeleton' | 'table' | 'import' | 'makeup' | 'prompts' | 'scenes' | 'props' | 'export';
+export interface FlowStep {
+    no: number;
+    label: string;
+    hint: string;
+    done: boolean;
+    target: FlowTarget;
+}
+/** 依据 project 数据计算 6 步完成度（与存储顺序无关，按生产顺序排列）。 */
+export declare function computeFlowSteps(project: ProjectState | null, exported?: boolean): FlowStep[];
+export declare function FlowGuide({ project, onNavigate, exported, }: {
+    project: ProjectState | null;
+    onNavigate: (target: FlowTarget) => void;
+    exported?: boolean;
+}): any;

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export declare function GlobalAssetLibraryView({ api }: {
+    api: NovelApi;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+import type { NovelApi } from '../api.ts';
+import type { IdeaInspirationResult } from '../../protocol.ts';
+export default function IdeaInspirationView({ api, onUseIdea }: {
+    api: NovelApi;
+    onUseIdea?: (idea: IdeaInspirationResult['ideas'][number]) => void;
+}): JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { NovelApi } from '../api.ts';
+export declare function ImportModal({ api, onClose, onImported, }: {
+    api: NovelApi;
+    onClose: () => void;
+    /** 导入成功并已激活该书后回调（刷新书架）。 */
+    onImported: () => void | Promise<void>;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export default function KnowledgeBaseView({ api }: {
+    api: NovelApi;
+}): JSX.Element;

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

@@ -0,0 +1,5 @@
+/**
+ * 「实时调用 / LIVE」—— 内嵌到 AI 进度窗的下半区（详情层），不再独立浮窗。
+ * 连接 /llm-live/stream，按 LLM 调用分组展示模型实时输出。
+ */
+export default function LiveFeedLog(): JSX.Element;

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

@@ -0,0 +1,20 @@
+import type { NovelApi } from '../api.ts';
+import type { ImageModelConfig, ProjectState } from '../../protocol.ts';
+export declare function MangaRoleLibrary({ api, project, refresh, styleId, filterId, focus, showCards, chapterNo: externalChapter, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    refresh: () => void | Promise<void>;
+    styleId?: string;
+    filterId?: string;
+    /** 是否启用生图（豆包等出定妆图）。 */
+    imageApiEnabled?: boolean;
+    /** 生图模型库（出定妆图时可选择用哪条）。 */
+    imageModels?: ImageModelConfig[];
+    /** 步骤页聚焦：import=展开并滚动到导入区；cards=滚动到已建漫剧卡列表。 */
+    focus?: 'import' | 'cards';
+    /** 是否显示「已建漫剧卡」列表（第⑤步导入页可隐藏，只留导入区）。 */
+    showCards?: boolean;
+    /** 全局当前章节（从工作台顶部导航条传入）。 */
+    chapterNo?: number | null;
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

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

@@ -0,0 +1,12 @@
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+export declare function MangaWorkspace({ api, project, chapters, onProjectChanged, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    chapters: ChapterPlan[];
+    /** 方案/资产变更已持久化后触发（刷新项目）。 */
+    onProjectChanged?: () => void | Promise<void>;
+    /** 是否启用生图（漫剧卡出定妆图）。 */
+    /** 上报到「AI进度」控制台（漫剧工作台内所有 LLM/方案操作）。 */
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

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

@@ -0,0 +1,5 @@
+import type { NovelApi } from '../api.ts';
+export default function MarketRadarView({ api, bookId }: {
+    api: NovelApi;
+    bookId?: string;
+}): 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/NovelPanel.d.ts

@@ -1,7 +1,7 @@
 import type { NovelApi } from '../api.ts';
 import type { PanelController } from './controller.ts';
 /** The panel's tab identifiers. */
-export type NovelTab = 'workflow' | 'overview' | 'plan' | 'bible' | 'assets' | 'foreshadow' | 'assistant' | 'settings';
+export type NovelTab = 'workflow' | 'overview' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'roles' | 'facts' | 'plotlines' | 'reviews' | 'progress' | 'breakdown' | 'director' | 'knowledge' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'book' | 'assets';
 /** Panel shell props. */
 export interface NovelPanelProps {
     /** The panel state owner (open/close/toggle). */

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/ProgressHomeView.d.ts

@@ -0,0 +1,5 @@
+import type { BookshelfSnapshot } from '../../protocol.ts';
+export declare function ProgressHomeView({ shelf, onOpenBook }: {
+    shelf: BookshelfSnapshot;
+    onOpenBook: (id: string) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import type { NovelApi } from '../api.ts';
+import type { ProjectState } from '../../protocol.ts';
+export declare function PropLibrary({ api, project, refresh, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    refresh: () => void | Promise<void>;
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

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

@@ -0,0 +1,8 @@
+import type { NovelApi } from '../api.ts';
+import type { ProjectState } from '../../protocol.ts';
+export declare function ReaderView({ api, project, onBack, onOpenWorkspace, }: {
+    api: NovelApi;
+    project: ProjectState;
+    onBack: () => void;
+    onOpenWorkspace: () => 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/RunPanel.d.ts

@@ -0,0 +1,5 @@
+import type { NovelApi } from '../api.ts';
+export declare function RunPanel({ api, totalChapters }: {
+    api: NovelApi;
+    totalChapters: number;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,16 @@
+import type { NovelApi } from '../api.ts';
+import type { ProjectState } from '../../protocol.ts';
+export declare function SceneLibrary({ api, project, refresh, styleId, filterId, chapterNo: externalChapter, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    /** 场景库变更已持久化后触发（刷新项目）。 */
+    refresh: () => void | Promise<void>;
+    /** 提炼场景时的漫剧基底风格 id（提示词按方案风格措辞）。 */
+    styleId?: string;
+    /** 可选滤镜风格 id。 */
+    filterId?: string;
+    /** 全局当前章节（从工作台顶部导航条传入）。 */
+    chapterNo?: number | null;
+    /** 上报到「AI进度」控制台。 */
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

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

@@ -0,0 +1,16 @@
+import type { NovelApi } from '../api.ts';
+type SettingsTab = 'model' | 'writing' | 'files' | 'appearance';
+type ThemeMode = 'system' | 'light' | 'dark';
+type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay' | 'endfield';
+type EndfieldAccent = 'valley' | 'wuling';
+type ThemeDensity = 'comfort' | 'compact' | 'spacious';
+export declare function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, onBackground, onOpacity, onEndfieldAccent }: {
+    api: NovelApi;
+    onTheme?: (theme: ThemeName, mode: ThemeMode, density: ThemeDensity) => void;
+    onSettingsTab?: (tab: SettingsTab) => void;
+    onEditorFontSize?: (n: number) => void;
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    onOpacity?: (n: number) => void;
+    onEndfieldAccent?: (accent: EndfieldAccent) => void;
+}): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,15 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+/** 书架首页。 */
+export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, }: {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    /** 点击书卡：激活该书并进入工作台。 */
+    onOpenBook: (id: string) => void;
+    /** 点击「阅读」：激活该书并进入沉浸式阅读页。 */
+    onReadBook: (id: string) => void;
+    /** 点击＋：进入开书向导页。 */
+    onAddBook: () => void;
+    /** 点击「导入」：打开导入弹窗（已有项目目录 / txt/md 全本）。 */
+    onImportBook: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,19 @@
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+export declare function StoryboardTab({ api, project, chapters, onProjectChanged, styleId, filterId, mode, onGoStep, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    chapters: ChapterPlan[];
+    /** 生成成功且已持久化后触发（刷新项目，切章/重进可恢复）。 */
+    onProjectChanged?: () => void | Promise<void>;
+    /** 漫剧基底风格 id（画面措辞随风格）。 */
+    styleId?: string;
+    /** 可选滤镜风格 id。 */
+    filterId?: string;
+    /** 页面模式：auto=按本章实际进度显示；skeleton/table/prompts=固定显示该步骤（前置不足显示提示，不降级）。 */
+    mode?: 'auto' | 'skeleton' | 'table' | 'prompts';
+    /** 「下一步」按钮回调（1=骨架→2=分镜表→3=提示词），供外层切步骤页。 */
+    onGoStep?: (n: 1 | 2 | 3) => void;
+    /** 上报到「AI进度」控制台（分镜三步生成）。 */
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

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

@@ -0,0 +1,8 @@
+import type { ArtStyle } from '../../style-library.ts';
+export declare function StyleCard({ style, selected, onClick, }: {
+    style: ArtStyle;
+    /** 选中态（高亮边框）。 */
+    selected?: boolean;
+    /** 点击卡片（选风格）。 */
+    onClick?: () => void;
+}): any;

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

@@ -0,0 +1 @@
+export declare function StyleGallery(): any;

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

@@ -0,0 +1,10 @@
+import type { NovelApi } from '../api.ts';
+import type { WorldState } from '../../protocol.ts';
+/** 大世界页签。 */
+export declare function WorldTab({ api, world, onChanged, }: {
+    api: NovelApi;
+    /** 当前项目的大世界数据（可能为空）。 */
+    world: WorldState | undefined;
+    /** 保存/提炼成功后由父组件刷新项目状态。 */
+    onChanged: (world: WorldState) => void;
+}): import("react").JSX.Element;

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

@@ -6,3 +6,13 @@
 import { type NovelKey } from '../locales.ts';
 /** Translate one key with optional {placeholder} substitution. */
 export declare function tt(key: NovelKey, params?: Record<string, string | number>): string;
+/** 角色定位中文名（角色库/提炼候选共用，收敛自多份复制）。 */
+export declare const ROLE_LABELS: Record<string, string>;
+/** 角色定位徽章颜色。 */
+export declare function roleColor(label: string): string;
+/** 剧情线类型中文名（与 locale 对齐）。 */
+export declare function kindLabel(kind: string): string;
+/** 剧情线状态中文名。 */
+export declare function plotlineStatusLabel(status: string): string;
+/** 剧情线状态颜色。 */
+export declare function plotlineStatusColor(status: string): string;