@waterwx/dsh-novel-forge 1.2.0 → 1.3.0-alpha

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

@@ -18,7 +18,7 @@ export declare const zh: {
     readonly 'tab.plan': "章节";
     readonly 'tab.bible': "道藏";
     readonly 'tab.foreshadow': "暗线";
-    readonly 'tab.assistant': "AI 助手";
+    readonly 'tab.assistant': "AI 编辑 Agent";
     readonly 'tab.settings': "设置";
     readonly 'workflow.title': "创作工作台";
     readonly 'workflow.step1': "① 加载总纲";
@@ -79,7 +79,7 @@ export declare const zh: {
     readonly 'plan.volumes': "卷";
     readonly 'plan.noVolume': "未分卷";
     readonly 'bible.title': "道藏";
-    readonly 'bible.gen': "AI 提炼道藏";
+    readonly 'bible.gen': "提炼道藏";
     readonly 'bible.genre': "题材基调";
     readonly 'bible.worldRules': "世界规则";
     readonly 'bible.characters': "人物志";
@@ -87,7 +87,7 @@ export declare const zh: {
     readonly 'bible.style': "风格要求";
     readonly 'bible.none': "尚未生成道藏。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。";
     readonly 'foreshadow.title': "暗线管理";
-    readonly 'foreshadow.suggest': "AI 建议暗线";
+    readonly 'foreshadow.suggest': "建议暗线";
     readonly 'foreshadow.none': "暂无暗线";
     readonly 'foreshadow.status': "状态";
     readonly 'foreshadow.planned': "计划中";
@@ -126,9 +126,9 @@ export declare const zh: {
     readonly 'plotlines.workflowTitle': "剧情线进度";
     readonly 'plotlines.workflowEmpty': "未建剧情线（去「剧情线」页创建）";
     readonly 'sensitive.title': "敏感词检查";
-    readonly 'sensitive.scanAll': "🔞 全书敏感词检查";
+    readonly 'sensitive.scanAll': " 全书敏感词检查";
     readonly 'sensitive.hint': "内置违禁词库硬匹配（政治/擦边/暴力/辱骂/广告/其他），发布前建议检查；只做提示，是否修改由你判断。";
-    readonly 'sensitive.clean': "✅ 未命中任何违禁词（扫描 {n} 章）";
+    readonly 'sensitive.clean': " 未命中任何违禁词（扫描 {n} 章）";
     readonly 'sensitive.hits': "命中 {n} 处（{chapters} 章受影响）";
     readonly 'sensitive.goFix': "去修订";
     readonly 'sensitive.fixPrefill': "请删除或替换正文中的违禁表达「{word}」（类别：{category}），用含蓄/间接的写法替代。";
@@ -142,16 +142,33 @@ 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.reasoningEffort': "思考强度 (reasoningEffort)";
+    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.reasoningHint': "off 最快最省；high/max 更慢更贵但推理更强";
     readonly 'settings.theme': "主题";
     readonly 'settings.themeLiquid': "iOS 液态玻璃（绿）";
-    readonly 'settings.themeClassic': "经典毛玻璃（蓝）";
     readonly 'settings.themeNeumorph': "新拟物（双阴影）";
     readonly 'settings.themeHint': "存于浏览器本地，即时生效";
     readonly 'settings.chapterChars': "每章目标字数";
@@ -178,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/AssistantTab.d.ts

@@ -1,7 +1,10 @@
 import type { NovelApi } from '../api.ts';
+import type { StageInfo } from '../../protocol.ts';
 /** Props. */
 export interface AssistantTabProps {
     api: NovelApi;
+    /** 宿主算出的创作阶段（/status.stage）：让作者在同一屏看到「现在该做什么」。 */
+    stage?: StageInfo | null;
 }
 /** The assistant conversation tab. */
-export declare function AssistantTab({ api }: AssistantTabProps): import("react").JSX.Element;
+export declare function AssistantTab({ api, stage }: AssistantTabProps): import("react").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

@@ -1,9 +1,13 @@
 import type { NovelApi } from '../api.ts';
 /** 开书向导页。 */
-export declare function CreateBookView({ api, onBack, onCreated, }: {
+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,13 @@
+/**
+ * 「实时调用 / LIVE」—— 内嵌到 AI 进度窗的下半区（详情层），不再独立浮窗。
+ * 连接 /llm-live/stream，按 LLM 调用分组展示模型实时输出。
+ *
+ * 除实时输出外，这里还承担两件与「花了多少」有关的事：
+ *   1) 每次调用显示 token 用量（输入↑ / 输出↓ / 思考）与耗时、首字耗时；
+ *   2) 「查看 Prompt」按 sessionId 拉取这次调用**实际发送**的 system / user。
+ * 顶部另有一条「本次运行」累计条（进程内，重启归零）。
+ *
+ * 状态色全部走 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-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' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'roles' | 'facts' | 'plotlines' | 'reviews' | 'progress' | 'breakdown' | 'storyboard' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'book' | 'assets';
+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/PromptSlotsView.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 提示词槽位：给作者留几个**安全可改**的位置来微调本书表达偏好。
+ *
+ * 边界写在界面上：槽位只**追加偏好**，不能覆盖道藏、写作红线、九条内容合规红线、
+ * 反 AI 规则与阶段契约 —— 这些由宿主锁定。清空即恢复默认。
+ */
+import type { NovelApi } from '../api.ts';
+export interface PromptSlotsViewProps {
+    api: NovelApi;
+}
+export default function PromptSlotsView({ api }: PromptSlotsViewProps): 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

@@ -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

@@ -1,13 +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, }: {
+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/TensionView.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 张力曲线：把「每章该有多紧」画出来并可逐章调整。
+ *
+ * 图上是三条线：
+ *   参考（虚线，形状预设） / 目标（实线，作者或规划设定） / 实际（散点，审稿打分）。
+ * 下方列出规则核对发现的曲线级问题（连续同值、高位不回落、长期低位、实际偏离目标）。
+ *
+ * 张力只影响写作提示词里的"松紧"指引，不改变任何校验规则。
+ */
+import type { NovelApi } from '../api.ts';
+export interface TensionViewProps {
+    api: NovelApi;
+}
+export default function TensionView({ api }: TensionViewProps): JSX.Element;

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

@@ -0,0 +1,14 @@
+/**
+ * 故事时间线：把逐章抽取的「时间点 / 地点 / 在场角色 / 事件」按章节顺序排开，
+ * 带规则初筛 + AI 复核的矛盾清单，并支持就地修正（手改后标记为 manual）。
+ *
+ * 与「编年录」的分工：编年录记事实状态，这里记**顺序**——专门抓时间倒流、
+ * 地点瞬移、跨度不合理这类长篇最容易崩的地方。
+ */
+import type { NovelApi } from '../api.ts';
+export interface TimelineViewProps {
+    api: NovelApi;
+    /** 章节号列表（用于「抽取本章」下拉）。 */
+    chapters: number[];
+}
+export default function TimelineView({ api, chapters }: TimelineViewProps): JSX.Element;

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;

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

@@ -1,9 +1,15 @@
-/**
- * 纯展示组件（views）：所有状态与事件处理器都留在 NovelPanel，
- * 这里只接收 props 渲染。便于单独维护与复用。
- */
 import type { ReactElement } from 'react';
 import type { AuditIssue, Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts';
+/** 滑轨胶囊导航（B5-5）：active 高亮为滑动指示块，随选中项平移。 */
+export declare function SlideNav<T extends string>(props: {
+    ariaLabel: string;
+    items: ReadonlyArray<{
+        id: T;
+        label: ReactElement | string;
+    }>;
+    active: T;
+    onSelect: (id: T) => void;
+}): JSX.Element;
 /** 统计格：状态摘要条 / 资产健康通用。 */
 export declare function StatCell(props: {
     label: string;
@@ -54,24 +60,36 @@ export declare function RoleCard(props: {
     onEdit: () => void;
     onRemove: () => void;
 }): ReactElement;
-/** 🩺 剧情健康检查报告面板。 */
+/**  剧情健康检查报告面板。 */
 export declare function PlotlineHealthPanel(props: {
     report: PlotlineHealthReport;
     disabled: boolean;
     onPlan: () => void;
     onClose: () => void;
 }): ReactElement;
-/** ✨ AI 剧情方案面板。 */
+/**  剧情方案面板。 */
 export declare function PlotlinePlanPanel(props: {
     plan: PlotlinePlan;
     disabled: boolean;
     onAdopt: (suggestion: Plotline) => void;
     onClose: () => void;
 }): ReactElement;
-/** ✨ AI 建议剧情线面板。 */
+/**  建议剧情线面板。 */
 export declare function PlotlineSuggestionPanel(props: {
     suggestions: Plotline[];
     disabled: boolean;
     onAdopt: (suggestion: Plotline) => void;
     onClose: () => void;
 }): ReactElement;
+/** 空状态基元：图标 + 标题 + 可选提示。compact 变体用于列表/卡片内嵌场景。 */
+export declare function EmptyState(props: {
+    icon?: string;
+    title: string;
+    hint?: string;
+    compact?: boolean;
+}): ReactElement;
+/** 骨架屏基元：rows 条微光占位行；widths 指定各行宽度档位，循环取用。 */
+export declare function SkeletonLines(props: {
+    rows?: number;
+    widths?: Array<'full' | 'wide' | 'half'>;
+}): ReactElement;

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

@@ -0,0 +1,19 @@
+/**
+ * 运行状态芯片：固定在页面顶部的「小说工坊生成状态」小徽标。
+ * 轮询 /run/status，实时显示 生成中/暂停/完成/停止/出错 + 当前章号；
+ * 点击可打开/关闭小说工坊面板。独立 DOM 注入，不触碰主面板逻辑，挂载失败静默降级。
+ *
+ * P0 重写说明（原实现的三个问题）：
+ *   1. 整块背景染状态色 + 固定白字 → 浅色主题下「白字配亮底」对比度崩坏。
+ *      现在改为「玻璃底 + 主题前景色文字 + 左侧状态色点」，状态只由色点承载，
+ *      文字永远跟随主题，任何深浅色下都可读。
+ *   2. 样式写死在 JS 的 inline style 里，切主题纹丝不动。
+ *      现在改用 CSS Module class，配色走 --nf-chip-* 令牌，
+ *      由 body[data-ds-dark-theme] 跟随宿主深浅色。
+ *   3. role="button" 却没有 tabindex、没有键盘处理，键盘用户完全用不了。
+ *      现在补 tabindex + Enter/Space 激活 + aria-label/live。
+ */
+import type { NovelApi } from './api.ts';
+import type { PanelController } from './panel/controller.ts';
+/** 生成一个固定顶部的状态芯片并开始轮询。返回 dispose。 */
+export declare function mountRunStatus(controller: PanelController, api: NovelApi): () => void;

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

@@ -0,0 +1,9 @@
+/**
+ * 客户端文件文本智能解码：兼容 UTF-8 BOM / UTF-16 / UTF-8 / GB18030(GBK)。
+ * 浏览器 File.text() 固定按 UTF-8 解码，GBK 中文网文 txt 会乱码，这里兜底。
+ */
+/**
+ * 读取一个 File 的文本，按编码探测兜底解码。
+ * @returns 解码后的文本。
+ */
+export declare function readFileTextSmart(file: File): Promise<string>;

package/lib/types/docx-core.d.ts

@@ -0,0 +1,16 @@
+/**
+ * docx 文本提取共享核心：服务端（src/docx.ts）与浏览器端（src/client/docx.ts）
+ * 共用 XML → 纯文本的解析逻辑，避免两份实现漂移。
+ * zip 解压入口因运行时不同（fflate vs fflate/browser，浏览器端必须走 browser
+ * 入口以避开 node:module 的 require 探测）留在两端各自处理。
+ */
+/** 解码 docx 正文实际会用到的少量 XML 实体。 */
+export declare function decodeEntities(text: string): string;
+/**
+ * 从 word/document.xml 的 XML 字符串提取纯文本：每个 <w:p> 段落一行，
+ * <w:tab>/<w:br> 保留为空白符；表格与嵌套结构按文档顺序拍平
+ * （它们的段落同样是 <w:p>）。
+ * @param xml - document.xml 解码后的字符串。
+ * @returns 正文文本（空文本时抛错）。
+ */
+export declare function extractDocxTextFromXml(xml: string): string;

package/lib/types/docx.d.ts

@@ -2,11 +2,10 @@
  * docx outline extraction: a .docx is a zip whose word/document.xml holds the
  * body text in <w:t> runs inside <w:p> paragraphs. We unzip with fflate and
  * walk the XML with a tiny tokenizer — no heavyweight XML/DOM dependency.
+ * XML 解析共享核心在 ./docx-core.ts（与浏览器端同源）。
  */
 /**
- * Extract plain text from a docx buffer: one line per <w:p> paragraph, with
- * <w:tab>/<w:br> preserved as whitespace. Tables and nested structures are
- * flattened in document order (their paragraphs are just <w:p> too).
+ * Extract plain text from a docx buffer: one line per <w:p> paragraph.
  * @param buffer - the raw .docx bytes.
  * @returns the body text.
  */