@waterwx/dsh-novel-forge 1.3.2-alpha → 1.3.3-alpha

package/lib/types/ai-scan.d.ts

@@ -28,9 +28,3 @@ export interface AiScanResult {
     summary: string;
 }
 export declare function scanAiFlavor(text: string): AiScanResult;
-/** 扫描前后对比（润色时用） */
-export declare function compareAiScan(before: AiScanResult, after: AiScanResult): {
-    improved: boolean;
-    deltaScore: number;
-    details: string[];
-};

package/lib/types/assets.d.ts

@@ -23,8 +23,6 @@ export declare const BUILTIN_PLOT_BEATS: PlotBeatTemplate[];
 export declare function emptyProjectAssets(): ProjectAssets;
 /** 合并项目资产与内置库：返回「生效的反 AI 规则」（内置全局 + 项目自定义）。 */
 export declare function effectiveAntiAiRules(assets: ProjectAssets | undefined): AntiAiRule[];
-/** 安定 key：内置规则全局基线（globalBaselineEnabled）在新书/旧书一律生效。 */
-export declare function ensureGlobalBaseline(assets: ProjectAssets | undefined): ProjectAssets;
 /** 内置库种子化 upsert（对齐上游 SystemResourceBootstrapService 精神）。
  *  missing_only 仅补齐缺失的全局基线规则；sync_existing 还会按 key 刷新已内置规则的结构化字段。 */
 export declare function ensureBuiltinAssets(assets: ProjectAssets | undefined, mode?: 'missing_only' | 'sync_existing'): ProjectAssets;

package/lib/types/author-assets.d.ts

@@ -1,6 +1,6 @@
 /**
  * 作者资产库/总数据（跨书）— 按作者维度聚合的可复用资产。
- * 与书架同惯例持久化到 ~/.dsh/dsh-novel-forge-author-assets.json。
+ * 与书架同惯例持久化到 <DSH_HOME>/dsh-novel-forge-author-assets.json。
  * 提供读取/持久化/新增或更新/删除，以及「导入默认」：把书架书的写作资产/角色 +
  * 内置全局库（题材/反AI规则/风格模板/推进模式）批量沉淀成资产条目（默认库）。
  */
@@ -11,8 +11,6 @@ export declare function authorAssetsFile(): string;
 export declare function loadAuthorAssets(): AuthorAssetLibrary;
 /** 持久化作者资产库。 */
 export declare function saveAuthorAssets(library: AuthorAssetLibrary): void;
-/** 新建一条资产（自动生成 id 与时间戳）。 */
-export declare function createAuthorAsset(input: Omit<AuthorStyleAsset, 'id' | 'createdAt' | 'updatedAt'>): AuthorStyleAsset;
 /** 按 id 更新一条资产；不存在则追加。 */
 export declare function upsertAuthorAsset(input: AuthorStyleAsset): AuthorAssetLibrary;
 /** 删除一条资产；返回更新后的资产库。 */

package/lib/types/bookshelf.d.ts

@@ -1,6 +1,6 @@
 /**
  * 书架（Bookshelf）— 多书管理：一本书记录一个独立输出目录。
- * 状态持久化到 ~/.dsh/dsh-novel-forge-bookshelf.json（跟随 dsh 配置惯例）。
+ * 状态持久化到 <DSH_HOME>/dsh-novel-forge-bookshelf.json（跟随 dsh 配置惯例）。
  */
 import type { BookEntry, BookshelfSnapshot } from './protocol.ts';
 /** 书架配置文件路径。 */
@@ -42,6 +42,11 @@ export declare function activeBookOutputDir(): string | undefined;
  * @returns 重指向的条目数。
  */
 export declare function repointBookDirs(from: string, to: string): number;
-/** 默认输出目录推断：~/.dsh/novels/书名。 */
-export declare function defaultOutputDirFor(bookName: string): string;
+/**
+ * 新书默认输出目录：`<配置的输出目录>/书名`；未配置时回退 `<DSH_HOME>/novels/书名`。
+ * @param bookName - 书名（剔除文件系统非法字符并截断到 40 字）。
+ * @param baseDir - settings 里配置的输出目录（未经激活书合并的原始值）。
+ * @returns 该书应写入的绝对目录。
+ */
+export declare function defaultOutputDirFor(bookName: string, baseDir?: string): string;
 export {};

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

@@ -51,6 +51,7 @@ export declare class NovelApi {
     chapterSave(no: number, text: string, report?: ReviewReport): Promise<import('../protocol.ts').ChapterSaveResponse>;
     patchConfig(patch: ConfigPatch): Promise<{
         config: NovelConfig;
+        settingsWarning?: string;
     }>;
     /** 输出目录迁移：dryRun=true 仅预览目录内容；确认时传 to 搬迁。 */
     moveOutputDir(to?: string, dryRun?: boolean): Promise<import('../protocol.ts').MoveOutputDirResponse>;

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

@@ -13,5 +13,3 @@
  */
 /** Extract plain text from a docx buffer: one line per <w:p> paragraph. */
 export declare function extractDocxTextFromBuffer(buffer: ArrayBuffer | Uint8Array): string;
-/** Read a File as ArrayBuffer. */
-export declare function readFileAsArrayBuffer(file: File): Promise<ArrayBuffer>;

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

@@ -135,6 +135,7 @@ 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.exportTxt': "导出 TXT";
     readonly 'settings.exportMd': "导出 Markdown";

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

@@ -1,5 +1,5 @@
 import type { ReactElement } from 'react';
-import type { AuditIssue, Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts';
+import type { Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts';
 /** 滑轨胶囊导航（B5-5）：active 高亮为滑动指示块，随选中项平移。 */
 export declare function SlideNav<T extends string>(props: {
     ariaLabel: string;
@@ -10,33 +10,6 @@ export declare function SlideNav<T extends string>(props: {
     active: T;
     onSelect: (id: T) => void;
 }): JSX.Element;
-/** 统计格：状态摘要条 / 资产健康通用。 */
-export declare function StatCell(props: {
-    label: string;
-    value: string;
-    detail: string;
-    /** 值颜色（可选）。 */
-    valueColor?: string;
-    /** 值字号覆盖（如长文本用 13）。 */
-    valueFontSize?: number;
-    /** detail 悬浮提示（可选）。 */
-    detailTitle?: string;
-}): ReactElement;
-/** 待办队列行。 */
-export declare function TodoRow(props: {
-    tone: 'danger' | 'warning' | 'info' | 'success';
-    title: string;
-    description: string;
-    actionLabel: string;
-    disabled: boolean;
-    onAction: () => void;
-}): ReactElement;
-/** 全书质检问题行。 */
-export declare function AuditIssueRow(props: {
-    issue: AuditIssue;
-    disabled: boolean;
-    onFix: () => void;
-}): ReactElement;
 /** 剧情线卡片（列表主体）。 */
 export declare function PlotlineCard(props: {
     line: Plotline;
@@ -88,8 +61,3 @@ export declare function EmptyState(props: {
     hint?: string;
     compact?: boolean;
 }): ReactElement;
-/** 骨架屏基元：rows 条微光占位行；widths 指定各行宽度档位，循环取用。 */
-export declare function SkeletonLines(props: {
-    rows?: number;
-    widths?: Array<'full' | 'wide' | 'half'>;
-}): ReactElement;

package/lib/types/client/sidebar-entry.d.ts

@@ -4,8 +4,6 @@
  * sibling plugin entries and self-heals via MutationObserver.
  */
 import type { PanelController } from './panel/controller.ts';
-/** Stable data attribute identifying the injected entry row. */
-export declare const ENTRY_SELECTOR = "[data-dsh-novelforge-entry]";
 /**
  * Mount the sidebar entry, waiting for the shell and self-healing on
  * re-renders.

package/lib/types/home.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Absolute Harness home for this process.
+ * @returns the normalized home directory.
+ */
+export declare function dshHome(): string;
+/**
+ * Join path segments onto the Harness home.
+ * @param segments - path segments appended to the home.
+ * @returns the normalized absolute joined path.
+ */
+export declare function dshHomePath(...segments: string[]): string;

package/lib/types/index.d.ts

@@ -15,8 +15,14 @@ export declare const name = "novel-forge";
 export declare const inject: string[];
 /**
  * Settings namespace of the novel-forge capability — the section the web
- * settings surface edits. Spelled here rather than imported: the browser half
- * spells the same value and must not depend on a Host package.
+ * settings surface edits.
+ *
+ * Legacy fallback only: from Harness 0.2 the Loader derives the section from this
+ * plugin's exported `Config`, and addresses it by the **entry id** it assigned in
+ * the active profile. That id is not guaranteed to be this name (bundle rows may
+ * be given a generated id), so the live id is read from the context instead —
+ * see {@link novelSettingsNamespace}. The constant stays for the browser half and
+ * for installations whose entry id really is this spelling.
  */
 export declare const NOVEL_SETTINGS_NAMESPACE: "dsh-novel-forge";
 /** Plugin config, validated by the same-named schemastery schema. */
@@ -68,9 +74,15 @@ export interface Config {
     /** 是否启用改编模式（默认关闭）。 */
     enableAdaptMode?: boolean;
 }
+/**
+ * Plugin config schema.
+ *
+ * Every field is live-editable (see {@link live}): the plugin re-reads the
+ * settings section on every request, so a change must apply without remounting.
+ */
 export declare const Config: z<Config>;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export declare const NOVEL_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-novel-forge \u63D2\u4EF6\uFF08AI \u7F16\u8BD1\u5C0F\u8BF4\u5DE5\u4F5C\u53F0\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u5C0F\u8BF4\u5DE5\u574A\u300D\u5165\u53E3\u3002\u80FD\u529B\uFF1A\u8BFB\u53D6 docx \u5927\u7EB2\u3001\u7C98\u8D34\u5927\u7EB2\u6587\u672C\u6216\u628A txt \u5168\u672C\u62C6\u7AE0\u5BFC\u5165\uFF1B\u7528 LLM \u63D0\u70BC\u9053\u85CF\uFF08\u4EBA\u8BBE/\u4E16\u754C\u89C2/\u91D1\u624B\u6307\u89C4\u5219/\u5199\u4F5C\u7EA2\u7EBF\uFF09\u4E0E\u5927\u4E16\u754C\uFF08\u5883\u754C/\u533A\u57DF/\u52BF\u529B\uFF09\uFF1B\u751F\u6210\u5377\u8BA1\u5212\u4E0E\u7ED3\u6784\u5316\u7AE0\u8282\u8BA1\u5212\uFF08\u672C\u7AE0\u76EE\u6807/\u5267\u60C5\u8981\u70B9/\u5FC5\u8FBE\u9879/\u4E49\u52A1\u5408\u7EA6/\u7AE0\u672B\u94A9\u5B50\uFF09\uFF1B\u9010\u7AE0\u751F\u6210 3000-4000 \u5B57\u6B63\u6587\u5E76\u4FDD\u5B58\u4E3A Markdown\uFF08\u9ED8\u8BA4\u8F93\u51FA\u5230\u7528\u6237\u4E3B\u76EE\u5F55 ~/.dsh/novels\uFF09\uFF1B\u6BCF\u7AE0\u81EA\u52A8\u751F\u6210\u6458\u8981\u4E0E\u7F16\u5E74\u5F55\u4E8B\u5B9E\u3001\u62BD\u53D6\u6545\u4E8B\u65F6\u95F4\u7EBF\uFF08\u6545\u4E8B\u5185\u65F6\u95F4/\u5730\u70B9/\u5728\u573A\u89D2\u8272/\u4E8B\u4EF6\uFF09\u3001\u81EA\u52A8 AI \u5BA1\u7A3F\uFF08\u4EBA\u8BBE/\u8BBE\u5B9A/\u7EA2\u7EBF/\u6587\u7B14/\u723D\u70B9/\u903B\u8F91/\u53CD AI/\u5448\u73B0/\u5408\u89C4\u4E5D\u7EF4\uFF09\u4E0E\u4F5C\u8005\u590D\u76D8\uFF1B\u652F\u6301\u6309\u5BA1\u7A3F\u610F\u89C1\u5408\u5E76\u4FEE\u8BA2\uFF08\u5BA1\u7A3F high + \u65F6\u95F4\u7EBF\u77DB\u76FE + \u5F20\u529B\u504F\u5DEE\u5408\u6210\u4E00\u8F6E\uFF0C\u6BCF\u7AE0\u6700\u591A\u4E24\u8F6E\u540E\u8F6C\u4EBA\u5DE5\uFF09\u3001\u53BB AI \u5473\u6DA6\u8272\u3001\u7AE0\u8282\u5386\u53F2\u7248\u672C\u56DE\u6EDA\u3001\u6697\u7EBF\uFF08\u4F0F\u7B14\uFF09\u7BA1\u7406\u3001\u5267\u60C5\u7EBF\u4E0E\u89D2\u8272\u5E93\u3001\u5F20\u529B\u66F2\u7EBF\u3001\u5168\u4E66\u4E00\u81F4\u6027\u8D28\u68C0\u4E0E\u654F\u611F\u8BCD\u626B\u63CF\u3001\u5206\u8303\u56F4\u5BFC\u51FA\u4E0E\u9879\u76EE\u5907\u4EFD\u3001\u6279\u91CF\u8FDE\u5199\uFF08\u751F\u4EA7\u5355\uFF0C\u53EF\u6682\u505C/\u7EED\u8DD1\uFF09\u3002\u9650\u5236\uFF1A\u6240\u6709 AI \u64CD\u4F5C\u6D88\u8017 LLM API \u989D\u5EA6\uFF1B\u8F93\u51FA\u76EE\u5F55\u4E0E\u6A21\u578B\u53EF\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u4FEE\u6539\uFF1B\u7AE0\u8282\u6B63\u6587\u8D28\u91CF\u53D6\u51B3\u4E8E\u5927\u7EB2\u5B8C\u6574\u5EA6\uFF1B\u5F20\u529B/\u65F6\u95F4\u7EBF\u95EE\u9898\u9ED8\u8BA4\u53EA\u662F\u5EFA\u8BAE\uFF08\u5199\u65E5\u5FD7\u4E0E\u5F85\u529E\uFF09\uFF0C\u4E0D\u4F1A\u81EA\u52A8\u6539\u6B63\u6587\u3002\u7528\u6237\u63D0\u5230\u300C\u5C0F\u8BF4 / \u5927\u7EB2 / \u5199\u5C0F\u8BF4 / \u7AE0\u8282 / \u5BA1\u7A3F / \u6DA6\u8272\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
+export declare const NOVEL_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-novel-forge \u63D2\u4EF6\uFF08AI \u7F16\u8BD1\u5C0F\u8BF4\u5DE5\u4F5C\u53F0\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u5C0F\u8BF4\u5DE5\u574A\u300D\u5165\u53E3\u3002\u80FD\u529B\uFF1A\u8BFB\u53D6 docx \u5927\u7EB2\u3001\u7C98\u8D34\u5927\u7EB2\u6587\u672C\u6216\u628A txt \u5168\u672C\u62C6\u7AE0\u5BFC\u5165\uFF1B\u7528 LLM \u63D0\u70BC\u9053\u85CF\uFF08\u4EBA\u8BBE/\u4E16\u754C\u89C2/\u91D1\u624B\u6307\u89C4\u5219/\u5199\u4F5C\u7EA2\u7EBF\uFF09\u4E0E\u5927\u4E16\u754C\uFF08\u5883\u754C/\u533A\u57DF/\u52BF\u529B\uFF09\uFF1B\u751F\u6210\u5377\u8BA1\u5212\u4E0E\u7ED3\u6784\u5316\u7AE0\u8282\u8BA1\u5212\uFF08\u672C\u7AE0\u76EE\u6807/\u5267\u60C5\u8981\u70B9/\u5FC5\u8FBE\u9879/\u4E49\u52A1\u5408\u7EA6/\u7AE0\u672B\u94A9\u5B50\uFF09\uFF1B\u9010\u7AE0\u751F\u6210 3000-4000 \u5B57\u6B63\u6587\u5E76\u4FDD\u5B58\u4E3A Markdown\uFF08\u9ED8\u8BA4\u8F93\u51FA\u5230\u63D2\u4EF6\u8BBE\u7F6E\u91CC\u300C\u8F93\u51FA\u76EE\u5F55\u300D\u6307\u5B9A\u7684\u4F4D\u7F6E\uFF0C\u672A\u914D\u7F6E\u65F6\u843D\u5230 Harness \u6570\u636E\u76EE\u5F55\u4E0B\u7684 novels/\u4E66\u540D\uFF09\uFF1B\u6BCF\u7AE0\u81EA\u52A8\u751F\u6210\u6458\u8981\u4E0E\u7F16\u5E74\u5F55\u4E8B\u5B9E\u3001\u62BD\u53D6\u6545\u4E8B\u65F6\u95F4\u7EBF\uFF08\u6545\u4E8B\u5185\u65F6\u95F4/\u5730\u70B9/\u5728\u573A\u89D2\u8272/\u4E8B\u4EF6\uFF09\u3001\u81EA\u52A8 AI \u5BA1\u7A3F\uFF08\u4EBA\u8BBE/\u8BBE\u5B9A/\u7EA2\u7EBF/\u6587\u7B14/\u723D\u70B9/\u903B\u8F91/\u53CD AI/\u5448\u73B0/\u5408\u89C4\u4E5D\u7EF4\uFF09\u4E0E\u4F5C\u8005\u590D\u76D8\uFF1B\u652F\u6301\u6309\u5BA1\u7A3F\u610F\u89C1\u5408\u5E76\u4FEE\u8BA2\uFF08\u5BA1\u7A3F high + \u65F6\u95F4\u7EBF\u77DB\u76FE + \u5F20\u529B\u504F\u5DEE\u5408\u6210\u4E00\u8F6E\uFF0C\u6BCF\u7AE0\u6700\u591A\u4E24\u8F6E\u540E\u8F6C\u4EBA\u5DE5\uFF09\u3001\u53BB AI \u5473\u6DA6\u8272\u3001\u7AE0\u8282\u5386\u53F2\u7248\u672C\u56DE\u6EDA\u3001\u6697\u7EBF\uFF08\u4F0F\u7B14\uFF09\u7BA1\u7406\u3001\u5267\u60C5\u7EBF\u4E0E\u89D2\u8272\u5E93\u3001\u5F20\u529B\u66F2\u7EBF\u3001\u5168\u4E66\u4E00\u81F4\u6027\u8D28\u68C0\u4E0E\u654F\u611F\u8BCD\u626B\u63CF\u3001\u5206\u8303\u56F4\u5BFC\u51FA\u4E0E\u9879\u76EE\u5907\u4EFD\u3001\u6279\u91CF\u8FDE\u5199\uFF08\u751F\u4EA7\u5355\uFF0C\u53EF\u6682\u505C/\u7EED\u8DD1\uFF09\u3002\u9650\u5236\uFF1A\u6240\u6709 AI \u64CD\u4F5C\u6D88\u8017 LLM API \u989D\u5EA6\uFF1B\u8F93\u51FA\u76EE\u5F55\u4E0E\u6A21\u578B\u53EF\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u4FEE\u6539\uFF1B\u7AE0\u8282\u6B63\u6587\u8D28\u91CF\u53D6\u51B3\u4E8E\u5927\u7EB2\u5B8C\u6574\u5EA6\uFF1B\u5F20\u529B/\u65F6\u95F4\u7EBF\u95EE\u9898\u9ED8\u8BA4\u53EA\u662F\u5EFA\u8BAE\uFF08\u5199\u65E5\u5FD7\u4E0E\u5F85\u529E\uFF09\uFF0C\u4E0D\u4F1A\u81EA\u52A8\u6539\u6B63\u6587\u3002\u7528\u6237\u63D0\u5230\u300C\u5C0F\u8BF4 / \u5927\u7EB2 / \u5199\u5C0F\u8BF4 / \u7AE0\u8282 / \u5BA1\u7A3F / \u6DA6\u8272\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
 /** Resolve a config-like value into the full runtime config. */
 export declare function resolveConfig(value: Partial<Config> | undefined): NovelConfig;
 /**

package/lib/types/llm-live.d.ts

@@ -10,13 +10,10 @@
 import type { BlockAssembler, TokenUsage } from '@deepseek-ai/dsh-llm';
 import type { LlmLiveFrame, LlmPromptRecord, LlmTokenUsage, LlmUsageSummary } from './protocol.ts';
 export type { LlmLiveFrame };
-export type LlmLivePhase = 'requesting' | 'streaming' | 'completed' | 'failed';
 type Listener = (frame: LlmLiveFrame) => void;
 export declare function nextSessionId(): string;
 export declare function subscribeLiveFeed(listener: Listener): () => void;
 export declare function emitLive(frame: LlmLiveFrame): void;
-export declare function liveLatest(): LlmLiveFrame[];
-export declare function clearLiveFeed(): void;
 /** 把 dsh-llm 的 usage 转成线上形状。 */
 export declare function toLiveUsage(usage: TokenUsage | undefined): LlmTokenUsage | undefined;
 /** 本次运行的用量汇总（按耗时降序排列用途，便于看谁最贵）。 */
@@ -33,8 +30,6 @@ export declare function recordPrompt(input: {
 }): LlmPromptRecord;
 /** 取一条 Prompt 记录（不存在返回 undefined）。 */
 export declare function livePrompt(sessionId: string): LlmPromptRecord | undefined;
-/** 清空 Prompt 记录。 */
-export declare function clearLivePrompts(): void;
 /** 一次调用的打点句柄。 */
 export interface LiveCallHandle {
     sessionId: string;

package/lib/types/market-radar-scan.d.ts

@@ -15,5 +15,4 @@ export interface MarketScanResult {
     scannedAt: string;
     groups: MarketRadarGroup[];
 }
-export declare function getLastMarketScan(): MarketScanResult | null;
 export declare function scanMarketRanking(platforms?: string[]): Promise<MarketScanResult>;

package/lib/types/model-capability.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 模型参数能力兼容层。
+ *
+ * 设计原则：**界面上保存的温度/思考档位是用户偏好，不是最终请求值。** 构造请求前
+ * 必须经过本层收敛到厂商允许的范围 —— 否则换模型、走自定义中转、或厂商改了约束，
+ * 就会出现「换个 provider 就报参数错误」这类故障。
+ *
+ * 两条硬要求：
+ *  1. **按模型身份判断，不按 provider 判断**。同一个模型经由自定义中转调用时，
+ *     provider 名可能完全自定义，但参数约束属于模型本身；把判断写成
+ *     `provider === '某个厂商' && ...` 会让走中转的调用绕过约束。
+ *  2. **约束要有出处**。每条规则的来源写在规则上，不靠猜。下列规则来自厂商官方
+ *     《模型参数参考》（https://platform.kimi.com/docs/api/models-overview.md）：
+ *       · kimi-k3        : temperature 固定 1.0；支持顶层 reasoning_effort
+ *       · kimi-k2.7-code : temperature 固定 1.0；不支持 reasoning_effort（用 thinking，且不可禁用）
+ *       · kimi-k2.6      : thinking 固定 1.0 / 非 thinking 固定 0.6；不支持 reasoning_effort
+ *     官方同时建议：这类模型**不要显式传入 temperature**。本层因此优先「不传」，
+ *     仅在调用方无法省略该参数时才钳到允许值。
+ */
+/** 一次请求的参数约束。 */
+export interface ModelCapability {
+    /** 该模型只接受这一个温度值（如 Kimi 全系），缺省表示不约束。 */
+    fixedTemperature?: number;
+    /** 温度允许的下界（默认 0）。 */
+    minTemperature?: number;
+    /** 温度允许的上界（默认 2，主流 OpenAI 兼容区间）。 */
+    maxTemperature?: number;
+    /**
+     * 是否支持 OpenAI 兼容的 `reasoning_effort`。
+     * false 表示**不得下发**该参数（如 Kimi K2.x 用的是 `thinking`），下发会被厂商拒绝。
+     */
+    supportsReasoning?: boolean;
+    /**
+     * 推理控制方式：`reasoning_effort`（OpenAI 兼容顶层参数）或 `thinking`（Kimi K2.x 专属）。
+     * 运行时若适配层支持，应按此选择参数名；仅为诊断与后续适配保留。
+     */
+    reasoningControl?: 'reasoning-effort' | 'thinking' | 'none';
+    /** 严格结构化输出必须关闭思考（覆盖用户偏好）。 */
+    reasoningForcedOff?: boolean;
+    /** 命中的规则名，用于日志与测试断言。 */
+    rule: string;
+    /** 约束出处（文档 URL 或说明），便于复核与更新。 */
+    source: string;
+}
+/**
+ * 把模型 id 归一化为「模型身份」。
+ *
+ * 处理：去空白与首尾斜杠、小写、剥掉供应商前缀（`kimi/kimi-k3` → `kimi-k3`）。
+ * @param model - 原始模型 id。
+ * @returns 归一化后的身份（小写、无前缀）。
+ */
+export declare function canonicalModelId(model: string | undefined): string;
+/**
+ * 解析一条模型的能力约束。
+ * @param model - 模型 id（可能带供应商前缀）。
+ * @returns 命中的能力；无约束时返回 undefined。
+ */
+export declare function resolveModelCapability(model: string | undefined): ModelCapability | undefined;
+/** 一次待收敛的请求参数。 */
+export interface RequestParams {
+    temperature: number;
+    /** 请求方（含用户偏好）希望使用的思考档位；undefined 表示不涉及。 */
+    reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+}
+/** 收敛结果：最终请求值 + 发生了哪些调整（便于日志与诊断）。 */
+export interface ConvergedParams {
+    /**
+     * 最终要下发的温度；`undefined` 表示**应当省略该参数**。
+     * 厂商建议这类模型不要显式传 temperature 时，本层返回 undefined。
+     */
+    temperature: number | undefined;
+    reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+    /** 被本层改掉的项，形如 `temperature: 0.3 -> 省略`。 */
+    adjustments: string[];
+    /** 命中的规则名。 */
+    rule?: string;
+    /** 约束出处。 */
+    source?: string;
+}
+/**
+ * 把请求参数收敛到模型允许的范围。
+ *
+ * @param params - 调用方希望使用的参数。
+ * @param model - 实际要调用的模型 id（应传**实际模型**；换备用模型后需重算）。
+ * @param options - `structured: true` 表示这是严格结构化输出任务；
+ *   `omitFixedTemperature: true` 表示调用方可以不传温度（推荐，厂商建议如此），
+ *   此时固定温度会收敛为 undefined 而不是钳到固定值。
+ * @returns 最终请求值与被调整项。
+ */
+export declare function convergeRequestParams(params: RequestParams, model: string | undefined, options?: {
+    structured?: boolean;
+    omitFixedTemperature?: boolean;
+}): ConvergedParams;

package/lib/types/output-budget.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 结构化输出预算与字段长度合同。
+ *
+ * 背景：本插件此前给每个 LLM 调用写死一个 `Math.max(config.maxTokens, N)`。短任务
+ * 与长任务拿到同一个额度，长任务（分卷、拆章、逐章规划）**额度不随规模增长**，
+ * 截断后只能抛「请增大 maxTokens」。这里把额度改成按规模推算，并给结构化字段
+ * 定长度上限，让预算花在结构上而不是被自由发挥吃光。
+ *
+ * 设计取舍：结构化输出的额度应当**随本次要产出的条目数增长**，并由硬上限兜住，
+ * 否则要么短任务浪费额度，要么长任务写到一半被截断。字段长度上限同时写进提示词
+ * 与解析端，两处共用一张表，避免漂移。
+ *
+ * 一条硬纪律：**不要用 JSON repair 去补被截断的结构**。repair 只能修已有结构，
+ * 补不出尚未输出的条目；在服务层手工补齐缺失项，等于把不完整的规划伪装成可用
+ * 资产。预算给够 + 输出够紧凑，才是正解。
+ */
+/** 一次调用的输出规模描述：给出能决定输出体量的那个量。 */
+export interface OutputScope {
+    /** 预期卷数（分卷/卷战略类）。 */
+    volumes?: number;
+    /** 预期章节数（章节列表/批量拆章类）。 */
+    chapters?: number;
+    /** 预期角色数（角色阵容/资产提炼类）。 */
+    characters?: number;
+    /** 预期条目数（伏笔、题材、资产等清单类）。 */
+    items?: number;
+    /** 需要覆盖的正文规模（字），用于拆书/反推这类按输入体量走的任务。 */
+    sourceChars?: number;
+}
+/** 一类结构化任务的预算规格。 */
+export interface OutputBudgetSpec {
+    /** 无视规模也要给到的下限。 */
+    floor: number;
+    /** 规模为 0 时的起步额度。 */
+    base: number;
+    /** 每单位规模追加的额度。 */
+    perUnit: number;
+    /** 硬上限：超过它只会让模型啰嗦，不会让结构更完整。 */
+    ceiling: number;
+}
+/** 结构化任务分组——按"输出里每个单位要写多少字段"分档，而不是按业务名。 */
+export type OutputBudgetKind = 'volume-strategy' | 'chapter-list' | 'character-cast' | 'item-list' | 'analysis';
+/**
+ * 取出与任务类型相关的那一个规模量。
+ * @param kind - 任务类型。
+ * @param scope - 规模描述。
+ * @returns 单位数；分析类返回千字单位（向上取整）。
+ */
+export declare function scopeUnits(kind: OutputBudgetKind, scope: OutputScope): number;
+/**
+ * 按规模推算输出额度。
+ * @param kind - 结构化任务类型。
+ * @param scope - 本次任务的规模（缺省时按最小规模处理）。
+ * @returns 建议的 `maxTokens`，落在该类型的 [floor, ceiling] 内。
+ */
+export declare function resolveOutputBudget(kind: OutputBudgetKind, scope?: OutputScope): number;
+/** 读取某类任务的规格（供诊断与测试断言）。 */
+export declare function outputBudgetSpec(kind: OutputBudgetKind): OutputBudgetSpec;
+/**
+ * 结构化字段长度合同 —— 与 prompt 里的长度声明必须逐项一致。
+ *
+ * 两边同步的理由：只写进 schema，模型不知道就会超长被拒；只写进 prompt，模型
+ * 偶尔超长没人拦。本表是单一数据源。
+ */
+export declare const STRUCTURED_FIELD_LIMITS: {
+    /** 分卷战略：书级阶梯类字段。 */
+    readonly volumeLadder: 160;
+    /** 分卷战略：每卷定位标签。 */
+    readonly volumeRoleLabel: 32;
+    /** 分卷战略：每卷核心回报 / 升级焦点。 */
+    readonly volumeReward: 64;
+    /** 分卷战略：不确定项原因。 */
+    readonly volumeUncertaintyReason: 64;
+    /** 章节计划：单章标题。 */
+    readonly chapterTitle: 40;
+    /** 章节计划：单章摘要。 */
+    readonly chapterSummary: 300;
+    /** 章节计划：本章目标。 */
+    readonly chapterGoal: 200;
+};
+/**
+ * 把长度合同渲染成可直接塞进 system prompt 的一句话，避免 prompt 与表漂移。
+ * @param entries - 要声明的字段（描述 + 上限），按声明顺序渲染。
+ * @returns 形如「为保证输出完整：A 不超过 160 字；B 不超过 64 字。」的中文说明。
+ */
+export declare function renderLengthContract(entries: ReadonlyArray<readonly [string, number]>): string;

package/lib/types/protocol.d.ts

@@ -225,7 +225,7 @@ export interface BookImportTextRequest {
     text?: string;
     /** 模式二：原文件名（txt/md），用于推断书名与显示。 */
     fileName?: string;
-    /** 输出目录；缺省为 ~/.dsh/novels/书名。 */
+    /** 输出目录；缺省为「输出目录」设置下的书名子目录。 */
     outputDir?: string;
 }
 /** POST /bookshelf/import-text 响应。 */
@@ -340,7 +340,7 @@ export interface AuthorReview {
     /** 复盘时间。 */
     reviewedAt: string;
 }
-/** 审稿维度（结构化定位问题类别；与 review-policy.ts 的 REVIEW_DIMENSIONS 对齐）。 */
+/** 审稿维度（结构化定位问题类别）。权威清单是 reviewSystemPrompt 里的九条维度。 */
 export type ReviewDimension = 'character' | 'setting' | 'redline' | 'writing' | 'pacing' | 'logic' | 'anti-ai' | 'presentation' | 'compliance';
 /** One review finding. */
 /** 问题严重度（审稿 / 时间线 / 张力共用）。 */
@@ -531,6 +531,13 @@ export interface MarketRadarResult {
     productionFoundation: ProductionFoundation;
     /** 开书创意简报（可选；用「用信号创作」接口单独生成）。 */
     creativeBrief?: MarketCreativeBrief;
+    /**
+     * 本次分析的报告 id（服务端生成）。
+     *
+     * 前端据此判断「是否换了一份新报告」：只有报告变了才重置信号勾选，否则重渲染/
+     * 轮询会把作者手选的信号冲掉。缺省（旧版产物）时前端按「首次看到」处理。
+     */
+    reportId?: string;
 }
 /** POST /market-radar request。 */
 export interface MarketRadarRequest {
@@ -1759,6 +1766,15 @@ export interface ConfigPatch {
     /** 手动添加的模型库（完整替换保存）。 */
     savedModels?: SavedModel[];
 }
+/** POST /config response: the config the host will read next, plus persistence caveats. */
+export interface ConfigResponse {
+    config: NovelConfig;
+    /**
+     * 已生效但**未持久化**时的说明（宿主 settings 段不可寻址：段 id 未知或宿主
+     * 未登记）。有值时设置只在本次进程内有效，重启回退，面板照此提示用户。
+     */
+    settingsWarning?: string;
+}
 /** One assistant conversation message (persisted per project). */
 export interface AssistantMessage {
     role: 'user' | 'assistant' | 'tool';
@@ -2274,7 +2290,7 @@ export interface AdaptSaveRequest {
     text: string;
     /** 新书名（缺省为「改编新书」；建议用「<原著>·改编版」）。 */
     bookName?: string;
-    /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+    /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
     outputDir?: string;
     /** 可附带反推大纲（写进新项目，便于后续续写/编辑）。 */
     outline?: string;
@@ -2298,7 +2314,7 @@ export interface AdaptMaterializeRequest {
     text: string;
     /** 新书名（缺省为「<源书名>·改编版」）。 */
     bookName?: string;
-    /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+    /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
     outputDir?: string;
     /** 反推大纲（来自分析；缺少时用源文章题兜底）。 */
     outline?: string;
@@ -2332,7 +2348,7 @@ export interface AdaptMaterializeResponse {
 export interface AdaptMaterializeSaveRequest {
     /** 新书名（缺省为「改编版」）。 */
     bookName?: string;
-    /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+    /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
     outputDir?: string;
     /** 改编后总纲。 */
     outline: string;

package/lib/types/routes.d.ts

@@ -9,19 +9,21 @@
  */
 import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
 import type { Context } from '@deepseek-ai/cordis';
-import { type BibleResponse, type ConfigPatch, type ExportResponse, type LoadOutlineResponse, type NovelConfig, type PlanResponse, type StatusResponse, type VolumesResponse } from './protocol.ts';
+import { type BibleResponse, type ConfigPatch, type ConfigResponse, type ExportResponse, type LoadOutlineResponse, type NovelConfig, type PlanResponse, type StatusResponse, type VolumesResponse } from './protocol.ts';
 import { chapterFileName } from './engine.ts';
 /** Route deps. */
 export interface NovelRoutesDeps {
     ctx: Context;
     /** Resolve the live plugin config (settings-aware). */
     getConfig: () => NovelConfig;
-    /** Persist a config patch through the settings seam. */
-    patchConfig: (patch: ConfigPatch) => Promise<NovelConfig>;
+    /** Persist a config patch through the settings seam (memory fallback included). */
+    patchConfig: (patch: ConfigPatch) => Promise<ConfigResponse>;
     /** Raw settings config（未与激活书合并）——目录迁移判断默认目录是否需同步用。 */
     rawConfig?: () => {
         outputDir?: string;
     };
+    /** Loader entry id the settings section is addressed by (undefined when unknown). */
+    settingsNs?: string;
 }
 /**
  * Build every /api/dsh-novel-forge route.

package/lib/types/settings-persist.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Config-patch persistence for the novel-forge plugin.
+ *
+ * Historically the plugin only knew how to write through the host settings
+ * service (`ctx.settings.update`) and treated the section's name as a constant.
+ * From Harness 0.2 the section is inferred from this plugin's exported `Config`
+ * and addressed by the **entry id** the Loader assigned — which the plugin does
+ * not control. A wrong id makes every save fail, so this module keeps the split
+ * explicit: apply the patch to the live config, then try to persist it, and
+ * report (rather than throw) when the host cannot.
+ */
+/** Minimal structural view of the host settings service this plugin touches. */
+export interface SettingsLike {
+    /** Persist one section patch; absent on hosts that expose read APIs only. */
+    update?: (ns: string, patch: Record<string, unknown>) => Promise<unknown>;
+    /** Live section registry; absence means the host cannot enumerate sections. */
+    describe?: () => unknown;
+}
+/** Where a config patch ended up. */
+export interface ConfigPersistResult {
+    /** The merged config (live in memory regardless of persistence). */
+    config: Record<string, unknown>;
+    /**
+     * Why persistence did not happen, when it did not. Callers surface this to the
+     * author: a save that silently evaporates on restart is worse than a loud one.
+     */
+    settingsWarning?: string;
+}
+/**
+ * The Loader entry id the settings section is addressed by.
+ * @param ctx - plugin context (structurally typed: only `fiber.entry.options.id` is read).
+ * @returns the entry id, or undefined when the host exposes none.
+ */
+export declare function novelSettingsNamespace(ctx: unknown): string | undefined;
+/**
+ * Pick the settings section to write through.
+ *
+ * The entry id is authoritative; the declared legacy name is used only when the
+ * host actually registered a section under it. Guessing an id is never allowed:
+ * a write to a wrong section would persist another plugin's config.
+ * @param settings - the settings service, when present.
+ * @param entryNs - entry id resolved from the context, when available.
+ * @param legacyNs - this plugin's declared section name (0.1.x wiring).
+ * @returns the section id to write to, or undefined when none is addressable.
+ */
+export declare function resolveSettingsTarget(settings: SettingsLike | undefined, entryNs: string | undefined, legacyNs: string): string | undefined;
+/**
+ * Merge one patch into the live config and persist it when the host allows.
+ *
+ * Never throws for a persistence failure: the edit is valid and already applied,
+ * so failing the request would lose it and misreport a working save as an error.
+ * @param current - the config as currently resolved.
+ * @param patch - the subset to merge (`undefined` values are ignored by callers).
+ * @param settings - the settings service, when present.
+ * @param entryNs - entry id resolved from the context, when available.
+ * @param legacyNs - this plugin's declared section name.
+ * @returns the merged config plus a warning when it could not be persisted.
+ */
+export declare function persistConfigPatch(current: Record<string, unknown>, patch: Record<string, unknown>, settings: SettingsLike | undefined, entryNs: string | undefined, legacyNs: string): Promise<ConfigPersistResult>;