@waterwx/dsh-novel-forge 1.10.1 → 2.0.0

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

@@ -1,57 +1,36 @@
 /**
- * dsh-novel-forge — locale dictionaries (zh / en).
+ * dsh-novel-forge — 面板文案词典（简体中文单语）。
+ *
+ * 定位说明：小说工坊面板是**中文单语界面**——这里就是全部用户可见文案的唯一定义处，
+ * 键位即类型（`NovelKey`），新增文案请同时在此登记，不要散落到组件里硬编码。
+ * 文档层（README / docs / CHANGELOG）仍提供英文对照，那是给人读的，不是界面语言。
  */
-/** zh dictionary. */
+/** 面板文案（简体中文）。 */
 export declare const zh: {
     readonly 'entry.label': "小说工坊";
     readonly 'entry.tooltip': "AI 编译小说工作台：总纲 → 道藏 → 卷计划 → 章节计划 → 逐章生成+审稿";
-    readonly 'panel.title': "小说工坊";
     readonly 'common.close': "关闭";
     readonly 'common.loading': "加载中…";
-    readonly 'common.save': "保存";
     readonly 'common.error': "错误";
-    readonly 'common.success': "成功";
-    readonly 'common.generating': "生成中…";
     readonly 'common.chars': "字";
     readonly 'tab.workflow': "工作台";
     readonly 'tab.overview': "总纲";
     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': "① 加载总纲";
-    readonly 'workflow.step2': "② 提炼道藏";
-    readonly 'workflow.step3': "③ 规划卷";
-    readonly 'workflow.step4': "④ 生成章节计划";
-    readonly 'workflow.step5': "⑤ 逐章写作 + AI 审稿";
-    readonly 'workflow.step6': "⑥ 润色 / 导出";
-    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.volumesDone': "卷计划已生成（{n} 卷）";
     readonly 'workflow.planDone': "章节计划已生成（{n} 章）";
-    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.bookName': "书名";
-    readonly 'overview.loadCustom': "指定 docx 路径";
-    readonly 'overview.loadCustomHint': "绝对路径，留空使用默认";
     readonly 'plan.generate': "生成章节计划";
     readonly 'plan.generateHint': "章节数量";
     readonly 'plan.count': "章";
-    readonly 'plan.empty': "暂无章节计划，请先生成";
-    readonly 'plan.chapter': "章";
     readonly 'plan.pending': "待生成";
     readonly 'plan.generating': "生成中";
     readonly 'plan.written': "待审稿";
@@ -63,23 +42,17 @@ export declare const zh: {
     readonly 'plan.rewrite': "修订";
     readonly 'plan.review': "审稿";
     readonly 'plan.polish': "去AI味";
-    readonly 'plan.writeAll': "批量生成全部";
     readonly 'plan.writeAllPending': "批量生成剩余";
-    readonly 'plan.generated': "已生成";
-    readonly 'plan.progress': "进度";
     readonly 'plan.beats': "剧情要点";
     readonly 'plan.reviewReport': "审稿报告";
     readonly 'plan.reviewScore': "评分";
     readonly 'plan.reviewVerdict': "总评";
-    readonly 'plan.reviewIssues': "问题清单";
     readonly 'plan.reviewPass': "通过";
     readonly 'plan.reviewFail': "未通过";
-    readonly 'plan.approve': "手动通过";
     readonly 'plan.summary': "章节摘要";
     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,9 +60,8 @@ 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': "计划中";
     readonly 'foreshadow.planted': "已埋设";
     readonly 'foreshadow.progressing': "推进中";
@@ -99,7 +71,6 @@ 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': "还没有剧情线——长篇小说建议先建主线与几条支线。";
@@ -121,23 +92,16 @@ export declare const zh: {
     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.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}），用含蓄/间接的写法替代。";
     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': "模型";
@@ -146,13 +110,7 @@ export declare const zh: {
     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': "连通";
@@ -167,15 +125,9 @@ export declare const zh: {
     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";
@@ -183,8 +135,8 @@ export declare const zh: {
     readonly 'settings.autoReviewAfterReviseHint': "按意见修订/润色产出草稿后自动附带一次 AI 审查，直接显示新稿评分与剩余问题（每章约 2-3k token，可关）";
     readonly 'settings.save': "保存设置";
     readonly 'settings.saved': "设置已保存";
+    readonly 'settings.savedUnpersisted': "设置已生效，但未能持久化（宿主未登记本插件的配置段），重启后会回到原值。";
     readonly 'settings.openFolder': "打开输出文件夹";
-    readonly 'settings.export': "导出";
     readonly 'settings.exportTxt': "导出 TXT";
     readonly 'settings.exportMd': "导出 Markdown";
     readonly 'settings.exported': "已导出：{file}（{chars} 字，{chapters} 章）";
@@ -194,19 +146,12 @@ export declare const zh: {
     readonly 'progress.error': "第 {no} 章失败：{message}";
     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': "请求失败";
 };
-/** en dictionary (fallback). */
-export declare const en: Record<string, string>;
-/** Keys type for the zh dictionary. */
+/** 面板文案键位（= zh 词典的键）。 */
 export type NovelKey = keyof typeof zh;

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

@@ -1,7 +1,5 @@
 import type { NovelApi } from './api.ts';
 import type { PanelController } from './panel/controller.ts';
-/** The injected panel container. */
-export declare const PANEL_VIEW_SELECTOR = "[data-dsh-novelforge-view]";
 /**
  * Mount the panel React tree into the center column and bind visibility to
  * the controller.

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

@@ -1,23 +1,27 @@
 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, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress }: {
+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;
-    /** 兼容旧入口：首页设置现为独立设置页，此回调保留但不再使用。 */
-    onOpenSettings?: () => void;
-    /** 主题/模式/密度变化回调（供面板根容器实时生效）。 */
-    onTheme?: (theme: 'liquid' | 'neumorph' | 'macos' | 'clay', mode: 'system' | 'light' | 'dark', density: 'comfort' | 'compact' | 'spacious') => void;
+    /** 创意灵感 → 采纳某个灵感带入开书向导。 */
+    onUseIdea?: (idea: import('../../protocol.ts').IdeaInspirationResult['ideas'][number]) => void;
     /** 自定义背景变化回调。 */
     onBackground?: (bg: string | undefined, blur: number) => void;
-    /** 玻璃透明度变化回调。 */
-    onOpacity?: (n: number) => void;
-    /** 是否启用改编模式（默认 false=隐藏入口）。 */
-    adaptEnabled?: boolean;
     /** AI 进度实时状态（与书内共享同一份）。 */
     progress?: ProgressLine[];
     busy?: boolean;

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

@@ -1,7 +1,7 @@
 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 declare const FALLBACK_MODEL_PRESETS: readonly ["deepseek-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"];
 export interface ModelManagerProps {
     api: NovelApi;
     provider: string;

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' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'manhua' | '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/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/SettingsView.d.ts

@@ -1,14 +1,19 @@
 import type { NovelApi } from '../api.ts';
-type SettingsTab = 'model' | 'writing' | 'image' | 'files' | 'appearance';
-type ThemeMode = 'system' | 'light' | 'dark';
-type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay';
-type ThemeDensity = 'comfort' | 'compact' | 'spacious';
-export declare function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, onBackground, onOpacity }: {
+type SettingsTab = 'model' | 'files' | 'appearance';
+export declare function SettingsView({ api, variant, onSettingsTab, onEditorFontSize, onBackground, themeMode, themeDensity, onChangeThemeMode, onChangeThemeDensity }: {
     api: NovelApi;
-    onTheme?: (theme: ThemeName, mode: ThemeMode, density: ThemeDensity) => void;
+    /** page = 全屏 SubPage（保留给旧入口）；drawer = 右滑抽屉内容（无壳）。 */
+    variant?: 'page' | 'drawer';
     onSettingsTab?: (tab: SettingsTab) => void;
     onEditorFontSize?: (n: number) => void;
     onBackground?: (bg: string | undefined, blur: number) => void;
-    onOpacity?: (n: 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,9 +1,16 @@
+/**
+ * 书架首页视图：书卡网格（封面/书名/简介/进度）+ 搜索筛选 + 开书入口。
+ * 进入小说工坊默认展示；点击书卡进入该书工作台，＋ 进入开书向导页。
+ */
+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, }: {
+export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenAdapt, toolbarExtra, }: {
     api: NovelApi;
     shelf: BookshelfSnapshot;
+    /** 书架工具行右端插槽：组入口按钮由 AuthorHome 下放（创作 / 灵感策划 / 资产）。 */
+    toolbarExtra?: ReactNode;
     /** 点击书卡：激活该书并进入工作台。 */
     onOpenBook: (id: string) => void;
     /** 点击「阅读」：激活该书并进入沉浸式阅读页。 */
@@ -12,4 +19,6 @@ export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBoo
     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,18 @@
+/**
+ * 张力曲线：把「每章该有多紧」画出来并可逐章调整。
+ *
+ * 图上是三条线：
+ *   参考（虚线，形状预设） / 目标（实线，作者或规划设定） / 实际（散点，审稿打分）。
+ * 下方列出规则核对发现的曲线级问题（连续同值、高位不回落、长期低位、实际偏离目标）。
+ *
+ * 张力只影响写作提示词里的"松紧"指引，不改变任何校验规则。
+ */
+import type { NovelApi } from '../api.ts';
+export interface TensionViewProps {
+    api: NovelApi;
+    /** 一键按建议修订（合并审稿/张力/时间线后改这一章；由父级统一发起）。 */
+    onRevise?: (chapterNo: number) => void;
+    /** 外部忙碌态（修订进行中时禁用按钮）。 */
+    busy?: boolean;
+}
+export default function TensionView({ api, onRevise, busy: outerBusy }: TensionViewProps): JSX.Element;

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

@@ -0,0 +1,18 @@
+/**
+ * 故事时间线：把逐章抽取的「时间点 / 地点 / 在场角色 / 事件」按章节顺序排开，
+ * 带规则初筛 + AI 复核的矛盾清单，并支持就地修正（手改后标记为 manual）。
+ *
+ * 与「编年录」的分工：编年录记事实状态，这里记**顺序**——专门抓时间倒流、
+ * 地点瞬移、跨度不合理这类长篇最容易崩的地方。
+ */
+import type { NovelApi } from '../api.ts';
+export interface TimelineViewProps {
+    api: NovelApi;
+    /** 章节号列表（用于「抽取本章」下拉）。 */
+    chapters: number[];
+    /** 一键按建议修订（合并审稿/时间线/张力后改这一章；由父级统一发起）。 */
+    onRevise?: (chapterNo: number) => void;
+    /** 外部忙碌态（修订进行中时禁用按钮）。 */
+    busy?: boolean;
+}
+export default function TimelineView({ api, chapters, onRevise, busy: outerBusy }: TimelineViewProps): JSX.Element;

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

@@ -1,7 +1,9 @@
 /**
- * Tiny translation helper for the panel: reads the zh dict with the en dict
- * as fallback (the family plugins use a full locale registry; the panel keeps
- * a dependency-free helper so the client bundle stays self-contained).
+ * Tiny translation helper for the panel.
+ *
+ * 面板是中文单语界面：文案只在 `locales.ts` 定义一次，这里按类型化键位取值
+ * （键位不匹配会在编译期报错），保持客户端 bundle 自包含、不引入运行时语言服务。
+ * 需要多语言时再接入 DSH 的 locale 服务，届时只需替换本函数实现。
  */
 import { type NovelKey } from '../locales.ts';
 /** Translate one key with optional {placeholder} substitution. */

package/lib/types/client/panel/market-radar-state.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 热门题材雷达的界面状态规则。
+ *
+ * 职责边界：本文件只回答「界面上此刻能不能点」，不持有任何数据。抽成纯函数的
+ * 理由是它可以离线测——组件渲染不好测，判定逻辑好测。
+ *
+ * 下面先用**独立表述的验收条件**写清楚要什么，再由两个函数实现；这样即使日后
+ * 需求变化，改动方向也是照着条件走，而不是照着某个外部实现的形状走。
+ *
+ *  R1 扫榜或分析进行中，不得改动作品勾选（否则分析输入与界面不一致）；
+ *  R2 未勾选任何作品时不能开始分析；
+ *  R3 已经有报告之后，仍允许改选作品并**再次**分析 —— 不得退化成"只能查看"；
+ *  R4 信号勾选只在确实换了一份报告时复位；同一份报告的重渲染不得冲掉作者手选。
+ */
+/** 雷达三个入口此刻的可用性，以及分析按钮该显示哪种文案。 */
+export interface RadarControls {
+    /** 扫榜按钮是否可点。 */
+    canScan: boolean;
+    /** 作品勾选（含全选 / 清空）是否可改。 */
+    canSelectCandidates: boolean;
+    /** 分析按钮是否可点。 */
+    canAnalyze: boolean;
+    /**
+     * 分析按钮的文案标识：
+     *  - `wait`：还在扫榜，先等榜单；
+     *  - `pick`：还没勾选作品；
+     *  - `first`：首次分析；
+     *  - `again`：已有报告，这次是再出一份。
+     */
+    analyzeLabel: 'wait' | 'pick' | 'first' | 'again';
+}
+/**
+ * 实现 R1-R3：判定三个入口的可用性。
+ * @param state - 当前界面状态。
+ * @returns 各入口可用性与分析按钮文案标识。
+ */
+export declare function radarControls(state: {
+    /** 正在抓榜单。 */
+    scanning: boolean;
+    /** 正在做 AI 分析。 */
+    analyzing: boolean;
+    /** 已勾选的作品数。 */
+    pickedCount: number;
+    /** 界面上是否已有可查看的报告。 */
+    hasReport: boolean;
+}): RadarControls;
+/**
+ * 实现 R4：本次报告是否**不是**勾选当前所依据的那一份。
+ *
+ * 传入的是上一次已经据以复位过的报告标识：相同 → 不动作者勾选；不同 → 勾选所依据
+ * 的信号集合已经变了，需要按新报告重新给出推荐勾选。
+ * @param selectionBasis - 勾选当前依据的报告标识（空串表示尚未复位过）。
+ * @param incoming - 本次拿到的报告标识（空串表示旧版产物没有该标识）。
+ * @returns 需要按新报告重置勾选时为 true。
+ */
+export declare function isDifferentReport(selectionBasis: string, incoming: string): boolean;

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;