@waterwx/dsh-novel-forge 1.0.0 → 1.1.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': "提炼道藏";
     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': "建议暗线";
+    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.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/AiTag.d.ts

@@ -0,0 +1 @@
+export declare function AiTag(): JSX.Element;

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, onBackground, progress, busy, busyLabel, liveBar, onClearProgress, onUseIdea, themeMode, themeDensity, onToggleMode, onChangeThemeMode, onChangeThemeDensity }: {
+    /** 当前显示模式（顶栏「墨纸 / 纸白」切换用）。 */
+    themeMode?: 'system' | 'light' | 'dark';
+    /** 当前界面密度。 */
+    themeDensity?: 'comfort' | 'compact' | 'spacious';
+    /** 切换墨纸 / 纸白（由 NovelPanel 落 localStorage）。 */
+    onToggleMode?: () => void;
+    /** 改变全局显示模式（联动整个面板）。 */
+    onChangeThemeMode: (m: 'system' | 'light' | 'dark') => void;
+    /** 改变全局界面密度（联动整个面板）。 */
+    onChangeThemeDensity: (d: 'comfort' | 'compact' | 'spacious') => void;
+    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;
+    /** 自定义背景变化回调。 */
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    /** 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/CmdPalette.d.ts

@@ -0,0 +1,12 @@
+import type { ReactElement } from 'react';
+export interface CmdAction {
+    icon: string;
+    label: string;
+    hint?: string;
+    run: () => void;
+}
+export declare function CmdPalette({ open, onClose, actions }: {
+    open: boolean;
+    onClose: () => void;
+    actions: CmdAction[];
+}): ReactElement | null;

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/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,8 @@
+/**
+ * 「实时调用 / LIVE」—— 内嵌到 AI 进度窗的下半区（详情层），不再独立浮窗。
+ * 连接 /llm-live/stream，按 LLM 调用分组展示模型实时输出。
+ *
+ * 状态色全部走 panel.module.css 的 .lfPill / .lfDot（主题令牌 + --nf-streaming），
+ * 不再内联硬编码色；布局性 inline style 保留（均为令牌引用或动态值）。
+ */
+export default function LiveFeedLog(): JSX.Element;

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

@@ -1,7 +1,12 @@
 import type { NovelApi } from '../api.ts';
 import type { PanelController } from './controller.ts';
+/**
+ * 面板宽度低于此值时自动折叠左侧导航。
+ * 依据：.panelNav 占 216px，内容区留到 ~680px 才不至于把正文挤成竖排。
+ * 宿主中列宽度 ≠ 视口宽度（用户可拖拽侧边栏），所以必须用实测宽度而非媒体查询。
+ */
 /** The panel's tab identifiers. */
-export type NovelTab = 'workflow' | 'overview' | 'plan' | 'bible' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle';
+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/PageHeader.d.ts

@@ -0,0 +1,18 @@
+/** 墨案统一页头：eyebrow(11 大写窄) + 衬线大标题 + 一句说明 + 主/次动作。
+ *  每个视图只用一个 PageHeader，消灭"各自为政"的页面标题。
+ *  图标用 lucide 16 (单色)，标题旁禁止 emoji；标题用衬线 Display（书卷感）。 */
+import type { ReactNode } from 'react';
+export declare function PageHeader({ eyebrow, title, icon, sub, actions, right }: {
+    /** 页眉小标（大写窄，可选，如 "BOOKSHELF"）。 */
+    eyebrow?: string;
+    /** 页面大标题（衬线 Display）。 */
+    title: string;
+    /** lucide 图标（单色，16px），可选。 */
+    icon?: ReactNode;
+    /** 一句话辅助说明（meta）。 */
+    sub?: string;
+    /** 右侧主/次按钮组。 */
+    actions?: ReactNode;
+    /** 标题右上（如 AI 微签）。 */
+    right?: ReactNode;
+}): 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/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/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/SettingsView.d.ts

@@ -0,0 +1,19 @@
+import type { NovelApi } from '../api.ts';
+type SettingsTab = 'model' | 'files' | 'appearance';
+export declare function SettingsView({ api, variant, onSettingsTab, onEditorFontSize, onBackground, themeMode, themeDensity, onChangeThemeMode, onChangeThemeDensity }: {
+    api: NovelApi;
+    /** page = 全屏 SubPage（保留给旧入口）；drawer = 右滑抽屉内容（无壳）。 */
+    variant?: 'page' | 'drawer';
+    onSettingsTab?: (tab: SettingsTab) => void;
+    onEditorFontSize?: (n: number) => void;
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    /** 全局显示模式（联动整个面板，NovelPanel 落 localStorage）。 */
+    themeMode: 'system' | 'light' | 'dark';
+    /** 全局界面密度。 */
+    themeDensity: 'comfort' | 'compact' | 'spacious';
+    /** 改变全局显示模式。 */
+    onChangeThemeMode: (m: 'system' | 'light' | 'dark') => void;
+    /** 改变全局界面密度。 */
+    onChangeThemeDensity: (d: 'comfort' | 'compact' | 'spacious') => void;
+}): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,24 @@
+/**
+ * 书架首页视图：书卡网格（封面/书名/简介/进度）+ 搜索筛选 + 开书入口。
+ * 进入小说工坊默认展示；点击书卡进入该书工作台，＋ 进入开书向导页。
+ */
+import { type ReactNode } from 'react';
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+/** 书架首页。 */
+export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenAdapt, toolbarExtra, }: {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    /** 书架工具行右端插槽：组入口按钮由 AuthorHome 下放（创作 / 灵感策划 / 资产）。 */
+    toolbarExtra?: ReactNode;
+    /** 点击书卡：激活该书并进入工作台。 */
+    onOpenBook: (id: string) => void;
+    /** 点击「阅读」：激活该书并进入沉浸式阅读页。 */
+    onReadBook: (id: string) => void;
+    /** 点击＋：进入开书向导页。 */
+    onAddBook: () => void;
+    /** 点击「导入」：打开导入弹窗（已有项目目录 / txt/md 全本）。 */
+    onImportBook: () => void;
+    /** 点击「改编模式」：进入改编六步向导（入口收在书架页头，与导入并排）。 */
+    onOpenAdapt?: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,27 @@
+/**
+ * 统一子页骨架（1:1 对齐 demo-subpages.html 的 .subpage / .subpage-head / .subpage-body）。
+ *
+ * 所有作者级与书内子页都应套这层壳：
+ *   - head：返回钮（可选）+ 大标题 + meta + 右侧操作区
+ *   - body：页面内容（内部按 demo 用 .card / .box / .grid / .row 等块）
+ * 业务逻辑继续留在各自的 View 组件里，这里只负责「壳」。
+ */
+import type { ReactNode } from 'react';
+export declare function SubPage(props: {
+    /** 页面大标题（衬线 display 档）。 */
+    title: string;
+    /** 标题右侧的说明行（如「4 本书 · 当前书《X》」）。 */
+    meta?: ReactNode;
+    /** 返回钮：作者级返回书架，书内返回总编台。 */
+    back?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** 页头右侧操作区（主 CTA 放最右）。 */
+    actions?: ReactNode;
+    /** 主题系统局部模式（透传到根 div 的 data-nf-mode，供设置页等预览明暗）。 */
+    dataNfMode?: 'light' | 'dark';
+    /** 主题系统局部密度（透传到根 div 的 data-nf-density）。 */
+    dataNfDensity?: 'comfort' | 'compact' | 'spacious';
+    children: ReactNode;
+}): JSX.Element;

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;

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

@@ -0,0 +1,2 @@
+/** 弹一条 toast。kind: 'done'（翡翠勾）/ 'error'（红叉）/ 'info'（中性）。 */
+export declare function showToast(text: string, kind?: 'done' | 'error' | 'info'): void;