dsh-plugin-litsearch 0.3.5 → 0.4.0

package/lib/host/zotero/connector.d.ts

@@ -4,11 +4,15 @@
  * 只允许回环地址：connector 是桌面端本地服务，绝不把用户数据发到外部主机。
  * 任何失败都转成可读的一句话，由调用方汇总成「未运行 / 条目保存失败 / 附件失败」。
  */
-import type { Paper, ZoteroProbeResult, ZoteroSyncResult } from '../../search/types.js';
+import type { Paper, ZoteroProbeResult, ZoteroSyncResult, ZoteroTargetsResult } from '../../search/types.js';
 export interface ZoteroConnectorOptions {
     baseUrl: string;
     attachPdf: boolean;
     tag: string;
+    /** connector 的 treeViewID（如 `C15`）；缺省沿用 Zotero 当前选中的目录。 */
+    targetId?: string;
+    /** 目标目录名，仅用于失败提示。 */
+    targetName?: string;
 }
 export interface ZoteroSyncInput {
     paper: Paper;
@@ -20,8 +24,13 @@ export declare class ZoteroConnector {
     private readonly baseUrl;
     constructor(baseUrl: string);
     probe(): Promise<ZoteroProbeResult>;
-    /** 当前 Zotero 里选中的分类；未选中时返回 null。 */
-    selectedCollection(): Promise<SelectedCollection | null>;
+    /** 所有可写入的库与分类，供同步弹窗选择目标。 */
+    listTargets(): Promise<ZoteroTargetsResult>;
+    /**
+     * `/connector/getSelectedCollection` 只接受 POST，返回当前目标与全部可写目标。
+     * 注意 GET 会直接 400，因此不能沿用 ping 的方式。
+     */
+    private fetchTargetInfo;
     /**
      * 保存条目并可选上传本地 PDF。
      *
@@ -29,6 +38,13 @@ export declare class ZoteroConnector {
      * messages，条目仍算保存成功。
      */
     sync(inputs: readonly ZoteroSyncInput[], options: ZoteroConnectorOptions): Promise<ZoteroSyncResult>;
+    /**
+     * 把本会话已保存的条目移动到指定目标。
+     *
+     * `tags` 传空数组：saveItems 用 `forceTagType: 1` 写入的标签是自动标签，
+     * updateSession 会保留自动标签；传空数组可避免同名标签重复写入。
+     */
+    private moveToTarget;
     /**
      * 保存条目。Zotero 返回 201 空响应，条目 id 由请求里的 `id` 字段决定，
      * 后续 `saveAttachment` 用它作为 parentItemID，并复用同一 sessionID。
@@ -37,10 +53,3 @@ export declare class ZoteroConnector {
     private saveAttachment;
     private request;
 }
-interface SelectedCollection {
-    id: number | string;
-    name: string;
-    libraryID?: number;
-    filesEditable?: boolean;
-}
-export {};

package/lib/host/zotero/connector.js

@@ -44,7 +44,8 @@ export class ZoteroConnector {
                 return { ok: false, error: `connector 返回 HTTP ${response.status}` };
             }
             const version = response.headers.get('x-zotero-version') ?? undefined;
-            const collection = await this.selectedCollection().catch(() => null);
+            const info = await this.fetchTargetInfo().catch(() => null);
+            const collection = info === null ? null : selectedOf(info);
             const result = { ok: true };
             if (version !== undefined)
                 result.version = version;
@@ -64,29 +65,43 @@ export class ZoteroConnector {
             return { ok: false, error: describe(error) };
         }
     }
-    /** 当前 Zotero 里选中的分类；未选中时返回 null。 */
-    async selectedCollection() {
+    /** 所有可写入的库与分类，供同步弹窗选择目标。 */
+    async listTargets() {
+        try {
+            const info = await this.fetchTargetInfo();
+            const targets = [];
+            for (const raw of info.targets ?? []) {
+                const target = toTarget(raw);
+                if (target !== null)
+                    targets.push(target);
+            }
+            const selected = selectedOf(info);
+            const result = { ok: true, targets };
+            if (selected !== null)
+                result.current = { id: selected.treeViewID, name: selected.name };
+            return result;
+        }
+        catch (error) {
+            return { ok: false, targets: [], error: describe(error) };
+        }
+    }
+    /**
+     * `/connector/getSelectedCollection` 只接受 POST，返回当前目标与全部可写目标。
+     * 注意 GET 会直接 400，因此不能沿用 ping 的方式。
+     */
+    async fetchTargetInfo() {
         const response = await this.request('/connector/getSelectedCollection', {
-            method: 'GET',
+            method: 'POST',
             timeoutMs: PING_TIMEOUT_MS,
+            headers: { 'content-type': 'application/json' },
+            body: '{}',
         });
         if (!response.ok)
-            return null;
+            throw new Error(`connector 返回 HTTP ${response.status}`);
         const body = (await response.json().catch(() => null));
-        if (body === null || body === false || typeof body !== 'object')
-            return null;
-        const record = body;
-        const id = record['id'];
-        const name = record['name'];
-        if ((typeof id !== 'number' && typeof id !== 'string') || typeof name !== 'string')
-            return null;
-        const collection = { id, name };
-        if (typeof record['libraryID'] === 'number')
-            collection.libraryID = record['libraryID'];
-        if (typeof record['filesEditable'] === 'boolean') {
-            collection.filesEditable = record['filesEditable'];
-        }
-        return collection;
+        if (body === null || typeof body !== 'object')
+            throw new Error('connector 返回空响应');
+        return body;
     }
     /**
      * 保存条目并可选上传本地 PDF。
@@ -95,49 +110,93 @@ export class ZoteroConnector {
      * messages，条目仍算保存成功。
      */
     async sync(inputs, options) {
-        if (inputs.length === 0)
-            return { ok: true, saved: 0, attached: 0, failed: 0, messages: [] };
-        if (inputs.length > MAX_SYNC_ITEMS) {
-            throw new Error(`一次最多同步 ${MAX_SYNC_ITEMS} 篇`);
-        }
         const result = {
             ok: true,
             saved: 0,
             attached: 0,
             failed: 0,
             messages: [],
+            items: [],
         };
+        if (inputs.length === 0)
+            return result;
+        if (inputs.length > MAX_SYNC_ITEMS) {
+            throw new Error(`一次最多同步 ${MAX_SYNC_ITEMS} 篇`);
+        }
         for (const input of inputs) {
             const sessionID = newSessionID();
             const item = toZoteroItem(input.paper, input.tags, options.tag);
             try {
                 await this.saveItem(item, sessionID);
-                result.saved += 1;
             }
             catch (error) {
+                const reason = describe(error);
                 result.failed += 1;
-                result.messages.push(`${shortTitle(input.paper.title)}：条目保存失败（${describe(error)}）`);
+                result.messages.push(`${shortTitle(input.paper.title)}：条目保存失败（${reason}）`);
+                result.items.push({ paperId: input.paper.paperId, ok: false, attached: false, error: reason });
                 continue;
             }
-            if (!options.attachPdf || input.pdfPath === undefined)
-                continue;
-            const parentId = typeof item['id'] === 'string' ? item['id'] : null;
-            if (parentId === null) {
-                result.messages.push(`${shortTitle(input.paper.title)}：条目已保存，但缺少条目 id，未上传 PDF`);
-                continue;
-            }
-            try {
-                const buffer = await readFile(input.pdfPath);
-                await this.saveAttachment(parentId, sessionID, input.paper, buffer);
-                result.attached += 1;
+            // 条目先落到 Zotero 当前选中的目录，再用 updateSession 搬到用户选的目录。
+            if (options.targetId !== undefined) {
+                try {
+                    await this.moveToTarget(sessionID, options.targetId);
+                }
+                catch (error) {
+                    const targetName = options.targetName ?? options.targetId;
+                    const reason = `未能移入「${targetName}」（${describe(error)}）`;
+                    result.failed += 1;
+                    result.messages.push(`${shortTitle(input.paper.title)}：条目已保存，但${reason}`);
+                    result.items.push({
+                        paperId: input.paper.paperId,
+                        ok: false,
+                        attached: false,
+                        error: reason,
+                    });
+                    continue;
+                }
             }
-            catch (error) {
-                result.messages.push(`${shortTitle(input.paper.title)}：PDF 附件失败（${describe(error)}）`);
+            result.saved += 1;
+            let attached = false;
+            if (options.attachPdf && input.pdfPath !== undefined) {
+                const parentId = typeof item['id'] === 'string' ? item['id'] : null;
+                if (parentId === null) {
+                    result.messages.push(`${shortTitle(input.paper.title)}：条目已保存，但缺少条目 id，未上传 PDF`);
+                }
+                else {
+                    try {
+                        const buffer = await readFile(input.pdfPath);
+                        await this.saveAttachment(parentId, sessionID, input.paper, buffer);
+                        result.attached += 1;
+                        attached = true;
+                    }
+                    catch (error) {
+                        result.messages.push(`${shortTitle(input.paper.title)}：PDF 附件失败（${describe(error)}）`);
+                    }
+                }
             }
+            result.items.push({ paperId: input.paper.paperId, ok: true, attached });
         }
         result.ok = result.failed === 0;
         return result;
     }
+    /**
+     * 把本会话已保存的条目移动到指定目标。
+     *
+     * `tags` 传空数组：saveItems 用 `forceTagType: 1` 写入的标签是自动标签，
+     * updateSession 会保留自动标签；传空数组可避免同名标签重复写入。
+     */
+    async moveToTarget(sessionID, target) {
+        const response = await this.request('/connector/updateSession', {
+            method: 'POST',
+            timeoutMs: SAVE_TIMEOUT_MS,
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ sessionID, target, tags: [] }),
+        });
+        if (!response.ok) {
+            const detail = (await response.text().catch(() => '')).slice(0, 120);
+            throw new Error(`connector 返回 HTTP ${response.status}${detail === '' ? '' : `（${detail}）`}`);
+        }
+    }
     /**
      * 保存条目。Zotero 返回 201 空响应，条目 id 由请求里的 `id` 字段决定，
      * 后续 `saveAttachment` 用它作为 parentItemID，并复用同一 sessionID。
@@ -201,6 +260,50 @@ export class ZoteroConnector {
         }
     }
 }
+/** 当前选中目标。未选中分类时 `id` 为 null，用 libraryID 组成 `L<n>`。 */
+function selectedOf(info) {
+    if (typeof info.name !== 'string')
+        return null;
+    const libraryID = typeof info.libraryID === 'number' ? info.libraryID : undefined;
+    let treeViewID;
+    if (typeof info.id === 'number')
+        treeViewID = `C${info.id}`;
+    else if (typeof info.id === 'string' && isTargetId(info.id))
+        treeViewID = info.id;
+    else if (libraryID !== undefined)
+        treeViewID = `L${libraryID}`;
+    else
+        return null;
+    const selected = {
+        id: typeof info.id === 'number' || typeof info.id === 'string' ? info.id : treeViewID,
+        name: info.name,
+        treeViewID,
+    };
+    if (libraryID !== undefined)
+        selected.libraryID = libraryID;
+    if (typeof info.filesEditable === 'boolean')
+        selected.filesEditable = info.filesEditable;
+    return selected;
+}
+function toTarget(raw) {
+    if (typeof raw.id !== 'string' || typeof raw.name !== 'string')
+        return null;
+    if (!isTargetId(raw.id))
+        return null;
+    const target = {
+        id: raw.id,
+        name: raw.name,
+        level: typeof raw.level === 'number' ? raw.level : 0,
+    };
+    if (typeof raw.filesEditable === 'boolean')
+        target.filesEditable = raw.filesEditable;
+    if (raw.recent === true)
+        target.recent = true;
+    return target;
+}
+function isTargetId(value) {
+    return /^[LC]\d+$/u.test(value);
+}
 function toZoteroItem(paper, tags, defaultTag) {
     const item = {
         id: paper.paperId,

package/lib/host/zotero/match.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 把模型从对话里听到的「存到 xx 目录」匹配到 Zotero connector 的真实目标。
+ *
+ * 纯函数、只做类型导入：`src` 源码可被 `node --test` 直接加载，Host 构建
+ * 产物仍走 `.js`。匹配失败或歧义时绝不猜一个目录就写入数据 —— 同步会真的
+ * 往 Zotero 里建条目，猜错代价太高。
+ */
+import type { ZoteroTarget } from '../../search/types.js';
+export type ZoteroMatch = {
+    kind: 'matched';
+    target: ZoteroTarget;
+} | {
+    kind: 'ambiguous';
+    candidates: ZoteroTarget[];
+} | {
+    kind: 'none';
+    candidates: ZoteroTarget[];
+};
+/**
+ * 匹配顺序：id 精确 → 名称精确（忽略大小写与空白）→ 名称包含。
+ *
+ * 任何一步命中多个都算歧义，返回候选让模型在对话里向用户确认；只有唯一
+ * 命中才返回 `matched`，由工具带上 `autoStart` 让右侧栏直接开跑。
+ */
+export declare function matchZoteroTarget(targets: readonly ZoteroTarget[], query: string): ZoteroMatch;
+/** 给模型的可用目录清单（工具返回文本里让用户/模型确认用）。 */
+export declare function describeZoteroTargets(targets: readonly ZoteroTarget[], limit?: number): string;

package/lib/host/zotero/match.js

@@ -0,0 +1,59 @@
+/**
+ * 把模型从对话里听到的「存到 xx 目录」匹配到 Zotero connector 的真实目标。
+ *
+ * 纯函数、只做类型导入：`src` 源码可被 `node --test` 直接加载，Host 构建
+ * 产物仍走 `.js`。匹配失败或歧义时绝不猜一个目录就写入数据 —— 同步会真的
+ * 往 Zotero 里建条目，猜错代价太高。
+ */
+const MAX_CANDIDATES = 8;
+/** 归一化：去首尾空白、合并连续空白（含全角空格）、忽略大小写。 */
+function normalize(value) {
+    return value.trim().replace(/\s+/gu, ' ').toLowerCase();
+}
+function candidatesOf(targets) {
+    // 目录多时优先给用户常看的：最近使用过的排前面，其余保持 connector 原序。
+    return [
+        ...targets.filter((target) => target.recent === true),
+        ...targets.filter((target) => target.recent !== true),
+    ].slice(0, MAX_CANDIDATES);
+}
+/**
+ * 匹配顺序：id 精确 → 名称精确（忽略大小写与空白）→ 名称包含。
+ *
+ * 任何一步命中多个都算歧义，返回候选让模型在对话里向用户确认；只有唯一
+ * 命中才返回 `matched`，由工具带上 `autoStart` 让右侧栏直接开跑。
+ */
+export function matchZoteroTarget(targets, query) {
+    const needle = normalize(query);
+    if (needle === '')
+        return { kind: 'none', candidates: candidatesOf(targets) };
+    const byId = targets.filter((target) => target.id.toLowerCase() === needle);
+    if (byId.length === 1)
+        return { kind: 'matched', target: byId[0] };
+    if (byId.length > 1)
+        return { kind: 'ambiguous', candidates: candidatesOf(byId) };
+    const byName = targets.filter((target) => normalize(target.name) === needle);
+    if (byName.length === 1)
+        return { kind: 'matched', target: byName[0] };
+    if (byName.length > 1)
+        return { kind: 'ambiguous', candidates: candidatesOf(byName) };
+    const partial = targets.filter((target) => normalize(target.name).includes(needle));
+    if (partial.length === 1)
+        return { kind: 'matched', target: partial[0] };
+    if (partial.length > 1)
+        return { kind: 'ambiguous', candidates: candidatesOf(partial) };
+    return { kind: 'none', candidates: candidatesOf(targets) };
+}
+/** 给模型的可用目录清单（工具返回文本里让用户/模型确认用）。 */
+export function describeZoteroTargets(targets, limit = 12) {
+    if (targets.length === 0)
+        return '（Zotero 里没有可用目录）';
+    const lines = targets.slice(0, limit).map((target) => {
+        const indent = '  '.repeat(Math.max(0, target.level));
+        const suffix = target.filesEditable === false ? '（不可写附件）' : '';
+        return `- ${indent}${target.name}${suffix}（id: ${target.id}）`;
+    });
+    if (targets.length > limit)
+        lines.push(`- ……还有 ${targets.length - limit} 个目录`);
+    return lines.join('\n');
+}

package/lib/search/config.d.ts

@@ -5,8 +5,6 @@
  * 保存配置后无需重启即生效。
  */
 import type { SortMode, SourceId, TaskLanguage } from './types.js';
-/** 插件版本（与 package.json 同步；仅用于 /health 诊断展示）。 */
-export declare const PLUGIN_VERSION = "0.1.0";
 /**
  * 默认数据源。
  *

package/lib/search/config.js

@@ -5,8 +5,6 @@
  * 保存配置后无需重启即生效。
  */
 import { SOURCE_IDS } from './types.js';
-/** 插件版本（与 package.json 同步；仅用于 /health 诊断展示）。 */
-export const PLUGIN_VERSION = '0.1.0';
 /**
  * 默认数据源。
  *

package/lib/search/types.d.ts

@@ -163,6 +163,8 @@ export type PdfStatus = 'unknown' | 'available' | 'downloaded' | 'missing' | 'ht
 export type PdfFailureReason = 'no-candidate' | 'blocked' | 'paywalled' | 'not-pdf' | 'failed';
 /** 是否需要引导用户到浏览器手动保存。 */
 export declare function isManualPdfFailure(reason: PdfFailureReason | undefined): boolean;
+/** 文献 → Zotero 的同步状态；缺省表示尚未同步。 */
+export type ZoteroSyncStatus = 'synced' | 'failed';
 /** 论文级人工筛选状态。 */
 export interface PaperState {
     screening: Screening;
@@ -172,6 +174,12 @@ export interface PaperState {
     pdfError?: string;
     /** 已下载到用户目录的绝对路径。 */
     pdfFile?: string;
+    /** 最近一次 Zotero 同步结果；缺省为未同步。 */
+    zoteroStatus?: ZoteroSyncStatus;
+    /** 同步到的 Zotero 目录名，便于列表直接展示。 */
+    zoteroCollection?: string;
+    /** 同步失败原因（面向用户的一句话）。 */
+    zoteroError?: string;
 }
 export interface TaskGroup {
     id: string;
@@ -427,6 +435,32 @@ export interface ZoteroProbeResult {
     };
     error?: string;
 }
+/** Zotero 可写入的目标（库或分类），id 为 connector 的 treeViewID。 */
+export interface ZoteroTarget {
+    id: string;
+    name: string;
+    level: number;
+    filesEditable?: boolean;
+    recent?: boolean;
+}
+/** Zotero 目标目录列表。 */
+export interface ZoteroTargetsResult {
+    ok: boolean;
+    targets: ZoteroTarget[];
+    /** 当前 Zotero 里选中的目标。 */
+    current?: {
+        id: string;
+        name: string;
+    };
+    error?: string;
+}
+/** 单篇同步结果。 */
+export interface ZoteroSyncItemResult {
+    paperId: string;
+    ok: boolean;
+    attached: boolean;
+    error?: string;
+}
 /** Zotero 批量同步结果。 */
 export interface ZoteroSyncResult {
     ok: boolean;
@@ -434,6 +468,7 @@ export interface ZoteroSyncResult {
     attached: number;
     failed: number;
     messages: string[];
+    items: ZoteroSyncItemResult[];
 }
 /** 下载目录可写性测试结果。 */
 export interface StorageProbeResult {
@@ -541,12 +576,113 @@ export interface TaskFocus {
     /** 发起检索的会话；客户端只在该会话可见时打开，避免抢占其他对话的面板。 */
     sessionId?: string;
 }
+/**
+ * 结果列表每页篇数。
+ *
+ * 面板分页与模型侧「第 N 页」共用这一个常量：它是**界面翻页**的粒度，
+ * 与任务条件的 `pageSize`（每源条数，可调 1–50）不是一回事，两者不可混用。
+ */
+export declare const RESULT_PAGE_SIZE = 20;
+/** 模型侧下载范围；工具把自然语言收敛成这 7 种之一。 */
+export type DownloadScope = 'ids' | 'currentPage' | 'currentView' | 'pages' | 'all' | 'group' | 'filters';
+/**
+ * 按页取数时页码的基准列表。
+ *
+ * - `view`（默认）：先按面板视图（筛选 + 排序）切页，再在页内套模型附加条件。
+ *   「第二页里有 PDF 的文献」就是这个口径：用户看到的是第 2 页那 20 条。
+ * - `filtered`：先把附加条件合并进筛选再切页。
+ *   「有 PDF 的文献的第 2 页」用这个。
+ */
+export type PageBase = 'view' | 'filtered';
+/**
+ * 客户端当前视图快照。
+ *
+ * 模型工具跑在 Host 侧，看不到右侧栏翻到第几页、用了什么筛选。面板按变化
+ * 节流上报这份快照，Host 才能把「当前页」「当前筛选全部」算准。仅存内存，
+ * 宿主重启即失效（与事件日志 rev 一致）。
+ */
+export interface ViewSnapshot {
+    sessionId: string;
+    taskId: string;
+    /** 上报时间（epoch ms）；Host 只接受 30 分钟内的快照。 */
+    at: number;
+    pageIndex: number;
+    pageSize: number;
+    /** 客户端看到的结果总数；给出「共 N 页」时用它，缺省则由 Host 按任务重算。 */
+    total?: number;
+    /** 当前结果排序；快照缺 paperIds 时用它重算当前页。 */
+    sort?: SortMode;
+    /** 当前生效的筛选；键名沿用 ResultsQuery，值已去除 undefined / 空串。 */
+    filters: Record<string, string | number | boolean>;
+    /** 当前页按用户所见顺序的 paperId。 */
+    pagePaperIds: string[];
+    /** 跨页累计勾选的 paperId。 */
+    selectedIds: string[];
+    /** 客户端看到的任务 rev；每下载一篇都会自增，故只做宽松校验。 */
+    rev: number;
+}
+/** 一条待下载文献的展示元数据；由 Host 生成，Client 无需再查详情。 */
+export interface DownloadCommandItem {
+    paperId: string;
+    title: string;
+    source: string;
+    /** `期刊 · 年份` 之类的副行，可缺省。 */
+    meta?: string;
+}
+/**
+ * 模型发起的批量下载指令。
+ *
+ * 范围在 Host 侧已解析、逐个校验完毕；右侧栏只按 paperIds 执行，不解析
+ * 任何条件，也不反查别的任务。弹窗靠 scopeLabel / reason / items 让用户
+ * 看清「大模型正在下载哪些文献」。
+ */
+export interface DownloadCommand {
+    commandId: string;
+    taskId: string;
+    sessionId?: string;
+    at: number;
+    origin: 'model';
+    /** 用户原话 / 模型对范围的解释，弹窗里展示。 */
+    reason: string;
+    /** Host 生成的中文范围说明（含篇数），Client 纯展示。 */
+    scopeLabel: string;
+    paperIds: string[];
+    items: DownloadCommandItem[];
+}
+/**
+ * 模型发起的批量存入 Zotero 指令。
+ *
+ * 与下载指令共用同一套范围解析与 `items` 展示元数据；多出来的只有目标目录：
+ * 用户在对话里点名了目录且 Host 匹配成功时带上 `target` 并 `autoStart`，
+ * 否则弹窗加载好文献后由用户自己选目录再点「同步」。
+ */
+export interface ZoteroCommand {
+    commandId: string;
+    taskId: string;
+    sessionId?: string;
+    at: number;
+    origin: 'model';
+    /** 用户原话 / 模型对范围的解释，弹窗里展示。 */
+    reason: string;
+    /** Host 生成的中文范围说明（含篇数），Client 纯展示。 */
+    scopeLabel: string;
+    paperIds: string[];
+    items: DownloadCommandItem[];
+    /** 对话里点名、且已在 Zotero 目录列表里核实过的目标目录。 */
+    target?: ZoteroTarget;
+    /** true = 目录已确定，弹窗加载完立即自动同步；false = 等用户选目录。 */
+    autoStart: boolean;
+}
 /** `/events` 的响应；`reset` 表示客户端的 sinceRev 比服务端新（宿主重启）。 */
 export interface EventsPage {
     rev: number;
     reset: boolean;
     tasks: TaskSummary[];
     focus?: TaskFocus;
+    /** 增量下发的模型下载指令；数组而非单值，避免两次轮询间连发时丢指令。 */
+    downloads?: DownloadCommand[];
+    /** 增量下发的模型 Zotero 同步指令，与 downloads 并列、互不影响。 */
+    zotero?: ZoteroCommand[];
 }
 /** `/health` 的响应：数据源能力 + 客户端需要的默认设置（不含密钥）。 */
 export interface HealthInfo {
@@ -582,7 +718,6 @@ export interface HealthInfo {
     };
     /** 任务文件存放目录（设置页只读展示）。 */
     storageDir: string;
-    version: string;
 }
 /** Host HTTP 端点统一信封。 */
 export type ApiEnvelope<T> = {

package/lib/search/types.js

@@ -37,3 +37,10 @@ export const TASK_LANGUAGES = [
 export function isManualPdfFailure(reason) {
     return reason !== undefined && reason !== 'failed';
 }
+/**
+ * 结果列表每页篇数。
+ *
+ * 面板分页与模型侧「第 N 页」共用这一个常量：它是**界面翻页**的粒度，
+ * 与任务条件的 `pageSize`（每源条数，可调 1–50）不是一回事，两者不可混用。
+ */
+export const RESULT_PAGE_SIZE = 20;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-litsearch",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "Search free scholarly literature sources from DSH. The model can search OpenAlex, Crossref and more with native tools, while you can run the same searches in a sidebar panel and send any paper into the conversation.",
   "keywords": [
     "dsh",