dsh-plugin-litsearch 0.1.0 → 0.3.0

package/lib/index.js

@@ -18,9 +18,12 @@ import { join } from 'node:path';
 import { createHandler } from './host/router.js';
 import { literatureTools } from './host/tools.js';
 import { TaskService } from './host/tasks/service.js';
-import { DEFAULT_ARXIV_INTERVAL_MS, DEFAULT_AUTO_DOWNLOAD_PDF, DEFAULT_AUTO_OPEN, DEFAULT_ENABLE_EPMC_FULLTEXT, DEFAULT_LANGUAGE, DEFAULT_MAX_TASK_TABS, DEFAULT_PAGE_SIZE, DEFAULT_PDF_MAX_MB, DEFAULT_PUBMED_INTERVAL_MS, DEFAULT_RETENTION_COUNT, DEFAULT_RETENTION_DAYS, DEFAULT_S2_INTERVAL_MS, DEFAULT_SORT, DEFAULT_TASK_MAX_PAPERS, DEFAULT_ZOTERO_ATTACH_PDF, DEFAULT_ZOTERO_BASE_URL, DEFAULT_ZOTERO_ENABLED, DEFAULT_ZOTERO_TAG, MAX_LIMIT, REQUEST_TIMEOUT_MS, ROUTE_MATCH, setSettingsReader, } from './search/config.js';
-import { SOURCE_IDS } from './search/types.js';
+import { setSessionStore } from './host/workspace.js';
+import { DEFAULT_ARXIV_INTERVAL_MS, DEFAULT_AUTO_DOWNLOAD_PDF, DEFAULT_AUTO_OPEN, DEFAULT_ENABLE_EPMC_FULLTEXT, DEFAULT_LANGUAGE, DEFAULT_MAX_TASK_TABS, DEFAULT_PAGE_SIZE, DEFAULT_PDF_CACHE_MAX_MB, DEFAULT_PDF_MAX_MB, DEFAULT_PUBMED_INTERVAL_MS, DEFAULT_RETENTION_COUNT, DEFAULT_RETENTION_DAYS, DEFAULT_S2_INTERVAL_MS, DEFAULT_SOURCE_IDS, DEFAULT_SORT, DEFAULT_TASK_MAX_PAPERS, DEFAULT_ZOTERO_ATTACH_PDF, DEFAULT_ZOTERO_BASE_URL, DEFAULT_ZOTERO_ENABLED, DEFAULT_ZOTERO_TAG, MAX_LIMIT, REQUEST_TIMEOUT_MS, ROUTE_MATCH, setSettingsReader, } from './search/config.js';
+import { SOURCE_IDS, TASK_LANGUAGES } from './search/types.js';
 export const name = 'dsh-plugin-litsearch';
+/** 旧版默认下载目录；读取时视为「未配置」，让默认落点切换到工作目录。 */
+const LEGACY_PDF_ROOT = join(homedir(), 'Downloads', 'dsh-litsearch');
 /**
  * 插件配置 schema（逐字段 volatile）。
  *
@@ -34,6 +37,8 @@ export const Config = Schema.object({
     ncbiApiKey: Schema.string().default('').role('secret').volatile(),
     /** 可选 Semantic Scholar API Key。 */
     s2ApiKey: Schema.string().default('').role('secret').volatile(),
+    /** 可选 SerpAPI Key；配置后启用 Google Scholar 数据源（付费/有免费额度）。 */
+    serpApiKey: Schema.string().default('').role('secret').volatile(),
     /** 各源最小请求间隔（毫秒）。 */
     pubmedIntervalMs: Schema.number().default(DEFAULT_PUBMED_INTERVAL_MS).volatile(),
     s2IntervalMs: Schema.number().default(DEFAULT_S2_INTERVAL_MS).volatile(),
@@ -51,8 +56,9 @@ export const Config = Schema.object({
         Schema.const('semanticscholar'),
         Schema.const('arxiv'),
         Schema.const('pubtator'),
+        Schema.const('googlescholar'),
     ]))
-        .default([...SOURCE_IDS])
+        .default([...DEFAULT_SOURCE_IDS])
         .volatile(),
     defaultSort: Schema.union([
         Schema.const('relevance'),
@@ -61,22 +67,24 @@ export const Config = Schema.object({
     ])
         .default(DEFAULT_SORT)
         .volatile(),
-    defaultLanguage: Schema.union([Schema.const('any'), Schema.const('eng'), Schema.const('chi')])
+    defaultLanguage: Schema.union(TASK_LANGUAGES.map((code) => Schema.const(code)))
         .default(DEFAULT_LANGUAGE)
         .volatile(),
     /** 模型发起检索后是否自动打开任务 tab。 */
     autoOpenTaskTab: Schema.boolean().default(DEFAULT_AUTO_OPEN).volatile(),
     /** 同时保留的任务 tab 上限。 */
     maxTaskTabs: Schema.number().default(DEFAULT_MAX_TASK_TABS).volatile(),
-    /** 任务保留天数与条数（置顶任务不受限）。 */
+    /** 任务保留天数与条数（已保留任务不受限）。 */
     taskRetentionDays: Schema.number().default(DEFAULT_RETENTION_DAYS).volatile(),
     taskRetentionCount: Schema.number().default(DEFAULT_RETENTION_COUNT).volatile(),
     /** 单任务结果上限。 */
     taskMaxPapers: Schema.number().default(DEFAULT_TASK_MAX_PAPERS).volatile(),
-    /** PDF 下载根目录。 */
-    pdfRoot: Schema.string().default(join(homedir(), 'Downloads', 'dsh-litsearch')).volatile(),
+    /** PDF 下载根目录；留空时跟随会话工作目录（其下的 dsh-litsearch/）。 */
+    pdfRoot: Schema.string().default('').volatile(),
     /** 单个 PDF 最大体积（MB）。 */
     pdfMaxMb: Schema.number().default(DEFAULT_PDF_MAX_MB).volatile(),
+    /** PDF 去重缓存总量上限（MB），启动时随任务清理一起修剪；0 表示关闭。 */
+    pdfCacheMaxMb: Schema.number().default(DEFAULT_PDF_CACHE_MAX_MB).volatile(),
     /** 检索完成后自动下载缺失 PDF。 */
     autoDownloadPdf: Schema.boolean().default(DEFAULT_AUTO_DOWNLOAD_PDF).volatile(),
     /** 无 PDF 时用 Europe PMC HTML 全文兜底。 */
@@ -93,12 +101,13 @@ export function apply(ctx, config) {
         contactEmail: config.contactEmail.get().trim(),
         ncbiApiKey: config.ncbiApiKey.get().trim(),
         s2ApiKey: config.s2ApiKey.get().trim(),
+        serpApiKey: config.serpApiKey.get().trim(),
         pubmedIntervalMs: clampInt(config.pubmedIntervalMs.get(), 50, 10_000, DEFAULT_PUBMED_INTERVAL_MS),
         s2IntervalMs: clampInt(config.s2IntervalMs.get(), 50, 60_000, DEFAULT_S2_INTERVAL_MS),
         arxivIntervalMs: clampInt(config.arxivIntervalMs.get(), 50, 60_000, DEFAULT_ARXIV_INTERVAL_MS),
         defaultPageSize: clampInt(config.defaultPageSize.get(), 1, MAX_LIMIT, DEFAULT_PAGE_SIZE),
         requestTimeoutMs: clampInt(config.requestTimeoutMs.get(), 1_000, 120_000, REQUEST_TIMEOUT_MS),
-        defaultSources: normalizeSources(config.defaultSources.get()),
+        defaultSources: normalizeSources(config.defaultSources.get()).filter((id) => id !== 'googlescholar' || config.serpApiKey.get().trim() !== ''),
         defaultSort: normalizeSort(config.defaultSort.get()),
         defaultLanguage: normalizeLanguage(config.defaultLanguage.get()),
         autoOpenTaskTab: config.autoOpenTaskTab.get(),
@@ -106,8 +115,9 @@ export function apply(ctx, config) {
         taskRetentionDays: clampInt(config.taskRetentionDays.get(), 1, 3_650, DEFAULT_RETENTION_DAYS),
         taskRetentionCount: clampInt(config.taskRetentionCount.get(), 1, 10_000, DEFAULT_RETENTION_COUNT),
         taskMaxPapers: clampInt(config.taskMaxPapers.get(), 10, 10_000, DEFAULT_TASK_MAX_PAPERS),
-        pdfRoot: config.pdfRoot.get().trim(),
+        pdfRoot: normalizePdfRoot(config.pdfRoot.get()),
         pdfMaxMb: clampInt(config.pdfMaxMb.get(), 1, 200, DEFAULT_PDF_MAX_MB),
+        pdfCacheMaxMb: clampInt(config.pdfCacheMaxMb.get(), 0, 102_400, DEFAULT_PDF_CACHE_MAX_MB),
         autoDownloadPdf: config.autoDownloadPdf.get(),
         enableEpmcFulltext: config.enableEpmcFulltext.get(),
         zoteroEnabled: config.zoteroEnabled.get(),
@@ -118,6 +128,13 @@ export function apply(ctx, config) {
     // 任务状态是模型工具与 HTTP 路由的唯一事实源。
     const service = new TaskService();
     ctx.effect(() => () => service.dispose(), 'dsh-plugin-litsearch: task service');
+    // 会话工作目录：PDF 默认落在其中，跟随用户当前项目。
+    ctx.inject(['sessionPersistence'], (sessionCtx) => {
+        const store = sessionCtx
+            .sessionPersistence;
+        setSessionStore(store);
+        sessionCtx.effect(() => () => setSessionStore(undefined), 'dsh-plugin-litsearch: session workspace');
+    });
     // 模型侧：原生注册，不依赖外部 MCP。
     ctx.inject(['tools'], (toolCtx) => {
         const toolsService = toolCtx.tools;
@@ -139,15 +156,20 @@ function clampInt(value, min, max, fallback) {
 }
 function normalizeSources(value) {
     const valid = SOURCE_IDS.filter((id) => value.includes(id));
-    return valid.length === 0 ? [...SOURCE_IDS] : valid;
+    return valid.length === 0 ? [...DEFAULT_SOURCE_IDS] : valid;
 }
 function normalizeSort(value) {
     return value === 'citations' || value === 'year' ? value : 'relevance';
 }
 function normalizeLanguage(value) {
-    return value === 'eng' || value === 'chi' ? value : 'any';
+    return TASK_LANGUAGES.includes(value) ? value : 'any';
 }
 function normalizeBaseUrl(value) {
     const trimmed = value.trim().replace(/\/+$/u, '');
     return /^https?:\/\//u.test(trimmed) ? trimmed : DEFAULT_ZOTERO_BASE_URL;
 }
+/** 旧默认值等同未配置：改由会话工作目录决定下载落点。 */
+function normalizePdfRoot(value) {
+    const trimmed = value.trim();
+    return trimmed === LEGACY_PDF_ROOT ? '' : trimmed;
+}

package/lib/search/aggregate.js

@@ -39,6 +39,7 @@ export async function searchSources(options) {
             bypassCooldown: options.bypassCooldown === true,
             ncbiApiKey: settings.ncbiApiKey,
             s2ApiKey: settings.s2ApiKey,
+            serpApiKey: settings.serpApiKey,
         });
     }));
     return settled.map((outcome, index) => {

package/lib/search/config.d.ts

@@ -7,6 +7,13 @@
 import type { SortMode, SourceId, TaskLanguage } from './types.js';
 /** 插件版本（与 package.json 同步；仅用于 /health 诊断展示）。 */
 export declare const PLUGIN_VERSION = "0.1.0";
+/**
+ * 默认数据源。
+ *
+ * Google Scholar 依赖用户自备的 SerpAPI Key，未配置时默认关闭，
+ * 因此不进入默认勾选列表。
+ */
+export declare const DEFAULT_SOURCE_IDS: readonly SourceId[];
 /** 默认每次加载条数。 */
 export declare const DEFAULT_PAGE_SIZE = 20;
 /**
@@ -33,19 +40,16 @@ export declare const DEFAULT_RETENTION_COUNT = 120;
 export declare const DEFAULT_TASK_MAX_PAPERS = 1500;
 /** 单任务保留的检索轮数上限；只记元数据，超出后淘汰最旧的轮次。 */
 export declare const DEFAULT_TASK_MAX_ROUNDS = 30;
-/**
- * Host 侧「当前任务」记忆有效期（毫秒）。
- *
- * 工具执行上下文拿不到会话 id，只能用进程内最近使用的任务做降级；
- * 超过该时长没有再使用就自动失效，避免隔了很久的新主题被误并进旧任务。
- */
-export declare const CURRENT_TASK_TTL_MS: number;
 /** 各源默认最小请求间隔（毫秒）；PubMed/S2/arXiv 可由设置覆盖。 */
 export declare const DEFAULT_PUBMED_INTERVAL_MS = 350;
 export declare const DEFAULT_S2_INTERVAL_MS = 3000;
 export declare const DEFAULT_ARXIV_INTERVAL_MS = 3000;
+/** SerpAPI 按次计费，保守限制为 1 次/秒。 */
+export declare const DEFAULT_SERPAPI_INTERVAL_MS = 1000;
 /** 全文下载默认设置。 */
 export declare const DEFAULT_PDF_MAX_MB = 30;
+/** PDF 去重缓存总量上限（MB）；0 表示关闭自动清理。 */
+export declare const DEFAULT_PDF_CACHE_MAX_MB = 512;
 export declare const DEFAULT_AUTO_DOWNLOAD_PDF = false;
 export declare const DEFAULT_ENABLE_EPMC_FULLTEXT = true;
 /** Zotero connector 默认设置。 */
@@ -57,6 +61,8 @@ export declare const DEFAULT_ZOTERO_TAG = "dsh-litsearch";
 export declare const MAX_ABSTRACT_CHARS = 800;
 /** 写端点的自定义请求头（与 JSON content-type 一起构成非简单请求）。 */
 export declare const WRITE_HEADER = "x-dsh-litsearch-write";
+/** 面板请求携带的会话 id；Host 用它解析会话工作目录。 */
+export declare const SESSION_HEADER = "x-dsh-litsearch-session";
 /** Host 路由前缀（Client fetch 路径与 handler 的剥离基准，带尾斜杠）。 */
 export declare const ROUTE_PREFIX = "/dsh-litsearch/api/";
 /**
@@ -83,13 +89,16 @@ export interface LitsearchSettings {
     ncbiApiKey: string;
     /** 可选 Semantic Scholar API Key；提高配额。 */
     s2ApiKey: string;
+    /** 可选 SerpAPI Key；配置后启用 Google Scholar 数据源。 */
+    serpApiKey: string;
     /** 各源最小请求间隔覆盖值。 */
     pubmedIntervalMs: number;
     s2IntervalMs: number;
     arxivIntervalMs: number;
-    /** PDF 下载根目录；空串由 Host 回落到 ~/Downloads/dsh-litsearch。 */
+    /** PDF 下载根目录；空串由 Host 回落到会话工作目录下的 dsh-litsearch/。 */
     pdfRoot: string;
     pdfMaxMb: number;
+    pdfCacheMaxMb: number;
     autoDownloadPdf: boolean;
     enableEpmcFulltext: boolean;
     zoteroEnabled: boolean;

package/lib/search/config.js

@@ -7,6 +7,13 @@
 import { SOURCE_IDS } from './types.js';
 /** 插件版本（与 package.json 同步；仅用于 /health 诊断展示）。 */
 export const PLUGIN_VERSION = '0.1.0';
+/**
+ * 默认数据源。
+ *
+ * Google Scholar 依赖用户自备的 SerpAPI Key，未配置时默认关闭，
+ * 因此不进入默认勾选列表。
+ */
+export const DEFAULT_SOURCE_IDS = SOURCE_IDS.filter((id) => id !== 'googlescholar');
 /** 默认每次加载条数。 */
 export const DEFAULT_PAGE_SIZE = 20;
 /**
@@ -33,19 +40,16 @@ export const DEFAULT_RETENTION_COUNT = 120;
 export const DEFAULT_TASK_MAX_PAPERS = 1500;
 /** 单任务保留的检索轮数上限；只记元数据，超出后淘汰最旧的轮次。 */
 export const DEFAULT_TASK_MAX_ROUNDS = 30;
-/**
- * Host 侧「当前任务」记忆有效期（毫秒）。
- *
- * 工具执行上下文拿不到会话 id，只能用进程内最近使用的任务做降级；
- * 超过该时长没有再使用就自动失效，避免隔了很久的新主题被误并进旧任务。
- */
-export const CURRENT_TASK_TTL_MS = 15 * 60_000;
 /** 各源默认最小请求间隔（毫秒）；PubMed/S2/arXiv 可由设置覆盖。 */
 export const DEFAULT_PUBMED_INTERVAL_MS = 350;
 export const DEFAULT_S2_INTERVAL_MS = 3000;
 export const DEFAULT_ARXIV_INTERVAL_MS = 3000;
+/** SerpAPI 按次计费，保守限制为 1 次/秒。 */
+export const DEFAULT_SERPAPI_INTERVAL_MS = 1000;
 /** 全文下载默认设置。 */
 export const DEFAULT_PDF_MAX_MB = 30;
+/** PDF 去重缓存总量上限（MB）；0 表示关闭自动清理。 */
+export const DEFAULT_PDF_CACHE_MAX_MB = 512;
 export const DEFAULT_AUTO_DOWNLOAD_PDF = false;
 export const DEFAULT_ENABLE_EPMC_FULLTEXT = true;
 /** Zotero connector 默认设置。 */
@@ -57,6 +61,8 @@ export const DEFAULT_ZOTERO_TAG = 'dsh-litsearch';
 export const MAX_ABSTRACT_CHARS = 800;
 /** 写端点的自定义请求头（与 JSON content-type 一起构成非简单请求）。 */
 export const WRITE_HEADER = 'x-dsh-litsearch-write';
+/** 面板请求携带的会话 id；Host 用它解析会话工作目录。 */
+export const SESSION_HEADER = 'x-dsh-litsearch-session';
 /** Host 路由前缀（Client fetch 路径与 handler 的剥离基准，带尾斜杠）。 */
 export const ROUTE_PREFIX = '/dsh-litsearch/api/';
 /**
@@ -71,7 +77,7 @@ let readSettings = () => ({
     contactEmail: '',
     defaultPageSize: DEFAULT_PAGE_SIZE,
     requestTimeoutMs: REQUEST_TIMEOUT_MS,
-    defaultSources: [...SOURCE_IDS],
+    defaultSources: [...DEFAULT_SOURCE_IDS],
     defaultSort: DEFAULT_SORT,
     defaultLanguage: DEFAULT_LANGUAGE,
     autoOpenTaskTab: DEFAULT_AUTO_OPEN,
@@ -81,11 +87,13 @@ let readSettings = () => ({
     taskMaxPapers: DEFAULT_TASK_MAX_PAPERS,
     ncbiApiKey: '',
     s2ApiKey: '',
+    serpApiKey: '',
     pubmedIntervalMs: DEFAULT_PUBMED_INTERVAL_MS,
     s2IntervalMs: DEFAULT_S2_INTERVAL_MS,
     arxivIntervalMs: DEFAULT_ARXIV_INTERVAL_MS,
     pdfRoot: '',
     pdfMaxMb: DEFAULT_PDF_MAX_MB,
+    pdfCacheMaxMb: DEFAULT_PDF_CACHE_MAX_MB,
     autoDownloadPdf: DEFAULT_AUTO_DOWNLOAD_PDF,
     enableEpmcFulltext: DEFAULT_ENABLE_EPMC_FULLTEXT,
     zoteroEnabled: DEFAULT_ZOTERO_ENABLED,

package/lib/search/identity.js

@@ -17,6 +17,7 @@ const RRF_WEIGHTS = {
     semanticscholar: 0.9,
     arxiv: 0.85,
     pubtator: 0.7,
+    googlescholar: 0.95,
 };
 /** RRF 平滑常数。 */
 const RRF_K = 60;

package/lib/search/providers/googlescholar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Google Scholar provider —— 通过 SerpAPI 的 `google_scholar` 引擎检索。
+ *
+ * Google 不提供官方 Scholar API，且禁止程序化抓取；这里只走第三方 SerpAPI，
+ * 由用户自备 Key。未配置 Key 时直接按「限流跳过」处理，不发起请求，也不计入
+ * 失败。文档见 `docs/谷歌学术接入调研.md`。
+ *
+ * 限制：SerpAPI 单页最多 20 条，`limit > 20` 时按 `start` 翻页；结果普遍不带
+ * DOI/PMID，跨源去重主要依赖规范化标题键。
+ */
+import type { Provider } from '../types.js';
+export declare const googlescholar: Provider;

package/lib/search/providers/googlescholar.js

@@ -0,0 +1,154 @@
+/**
+ * Google Scholar provider —— 通过 SerpAPI 的 `google_scholar` 引擎检索。
+ *
+ * Google 不提供官方 Scholar API，且禁止程序化抓取；这里只走第三方 SerpAPI，
+ * 由用户自备 Key。未配置 Key 时直接按「限流跳过」处理，不发起请求，也不计入
+ * 失败。文档见 `docs/谷歌学术接入调研.md`。
+ *
+ * 限制：SerpAPI 单页最多 20 条，`limit > 20` 时按 `start` 翻页；结果普遍不带
+ * DOI/PMID，跨源去重主要依赖规范化标题键。
+ */
+import { SearchError } from '../errors.js';
+import { asArray, asNumber, asRecord, asString, normalizeDoi } from '../normalize.js';
+import { limitedJson, SourceSkipped } from '../rate-limit.js';
+const ENDPOINT = 'https://serpapi.com/search.json';
+/** SerpAPI 允许的单页条数上限。 */
+const PAGE_SIZE = 20;
+export const googlescholar = {
+    info: {
+        id: 'googlescholar',
+        label: 'Google Scholar',
+        homepage: 'https://scholar.google.com',
+        capabilities: { abstract: true, citationCount: true, openAccess: true, pdf: true },
+        rateLimit: '1 req/s 自限；受 SerpAPI 套餐配额约束（免费 250 次/月）',
+        syntax: '自然语言；支持引号短语、author:/source:，不解析 PubMed 字段标签',
+        optionalKey: true,
+    },
+    async search(query, options) {
+        const apiKey = options.serpApiKey?.trim() ?? '';
+        if (apiKey === '') {
+            throw new SourceSkipped('未配置 SerpAPI 密钥，Google Scholar 已跳过');
+        }
+        const records = [];
+        const seen = new Set();
+        for (let start = 0; start < options.limit; start += PAGE_SIZE) {
+            const num = Math.min(PAGE_SIZE, options.limit - start);
+            const params = new URLSearchParams({
+                engine: 'google_scholar',
+                q: query,
+                num: String(num),
+                start: String(start),
+                hl: 'en',
+                api_key: apiKey,
+            });
+            if (options.yearFrom !== undefined)
+                params.set('as_ylo', String(options.yearFrom));
+            if (options.yearTo !== undefined)
+                params.set('as_yhi', String(options.yearTo));
+            const payload = await limitedJson('googlescholar', `${ENDPOINT}?${params.toString()}`, {
+                timeoutMs: options.timeoutMs,
+                signal: options.signal,
+                bypassCooldown: options.bypassCooldown === true,
+                headers: { accept: 'application/json' },
+            }).catch((error) => {
+                if (error instanceof SearchError && (error.status === 401 || error.status === 403)) {
+                    throw new SearchError('upstream_error', 'SerpAPI 密钥无效或无权限，请在设置页检查');
+                }
+                throw error;
+            });
+            const response = asRecord(payload);
+            const error = asString(response['error']).trim();
+            if (error !== '') {
+                throw new SearchError('upstream_error', `SerpAPI：${error}`);
+            }
+            const items = asArray(response['organic_results']);
+            for (const item of items) {
+                const record = mapItem(item);
+                if (record.title === '')
+                    continue;
+                const key = record.sourceId === '' ? record.title : record.sourceId;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                records.push(record);
+            }
+            // 上游返回不足一页，说明没有更多结果。
+            if (items.length < num)
+                break;
+        }
+        return records;
+    },
+};
+function mapItem(raw) {
+    const item = asRecord(raw);
+    const publication = asRecord(item['publication_info']);
+    const inline = asRecord(item['inline_links']);
+    const versions = asRecord(inline['versions']);
+    const citedBy = asRecord(inline['cited_by']);
+    const title = asString(item['title']).trim();
+    const link = asString(item['link']).trim();
+    const summary = asString(publication['summary']).trim();
+    const clusterId = asString(versions['cluster_id']).trim();
+    const resultId = asString(item['result_id']).trim();
+    const doi = readDoi(link);
+    const pdfUrl = readPdfUrl(item['resources']);
+    return {
+        source: 'googlescholar',
+        sourceId: clusterId !== '' ? clusterId : resultId !== '' ? resultId : link,
+        ids: { doi, pmid: '', pmcid: '', arxivId: '' },
+        title,
+        authors: readAuthors(publication['authors'], summary),
+        year: readYear(summary),
+        venue: readVenue(summary),
+        doi,
+        url: link,
+        abstract: asString(item['snippet']).trim(),
+        citedBy: asNumber(citedBy['total']),
+        openAccess: pdfUrl !== '',
+        pdfUrl,
+        type: '',
+    };
+}
+/** 结果页不直接给 DOI；只有链接里出现 DOI 时才提取，避免误判普通 URL。 */
+function readDoi(link) {
+    if (!/10\.\d{4,9}\//u.test(link))
+        return '';
+    const match = /10\.\d{4,9}\/[^\s"<>]+/u.exec(link);
+    return match === null ? '' : normalizeDoi(match[0]);
+}
+function readPdfUrl(value) {
+    for (const entry of asArray(value)) {
+        const resource = asRecord(entry);
+        if (asString(resource['file_format']).toUpperCase() !== 'PDF')
+            continue;
+        const link = asString(resource['link']).trim();
+        if (link !== '')
+            return link;
+    }
+    return '';
+}
+function readAuthors(value, summary) {
+    const names = asArray(value)
+        .map((entry) => asString(asRecord(entry)['name']).trim())
+        .filter((name) => name !== '');
+    if (names.length > 0)
+        return names;
+    // 兜底：summary 形如「作者列表 - 标题, 年份 - 来源」。
+    const head = summary.split(' - ')[0] ?? '';
+    return head
+        .split(',')
+        .map((name) => name.trim())
+        .filter((name) => name !== '' && name.length <= 80);
+}
+/** summary 中的最后一个四位年份即出版年（标题里的年份通常更早）。 */
+function readYear(summary) {
+    const matches = [...summary.matchAll(/\b(?:19|20)\d{2}\b/gu)];
+    if (matches.length === 0)
+        return null;
+    return asNumber(Number(matches[matches.length - 1][0]));
+}
+/** summary 末段通常是来源站点（如 `cabdirect.org`）。 */
+function readVenue(summary) {
+    const parts = summary.split(' - ');
+    return parts.length < 2 ? '' : (parts[parts.length - 1] ?? '').trim();
+}

package/lib/search/providers/index.js

@@ -8,6 +8,7 @@ import { SOURCE_IDS } from '../types.js';
 import { arxiv } from './arxiv.js';
 import { crossref } from './crossref.js';
 import { europepmc } from './europepmc.js';
+import { googlescholar } from './googlescholar.js';
 import { openalex } from './openalex.js';
 import { pubmed } from './pubmed.js';
 import { pubtator } from './pubtator.js';
@@ -20,6 +21,7 @@ export const PROVIDERS = {
     semanticscholar,
     arxiv,
     pubtator,
+    googlescholar,
 };
 /** 注册顺序即聚合展示顺序。 */
 export const PROVIDER_INFOS = SOURCE_IDS.map((id) => PROVIDERS[id].info);

package/lib/search/query-adapter.js

@@ -22,6 +22,9 @@ export function adaptQuery(source, block) {
             return toArxivQuery(text);
         case 'pubtator':
             return toPlainText(text);
+        case 'googlescholar':
+            // 支持引号短语与 author:/source:，但不认 PubMed 字段标签与布尔式。
+            return toPlainText(text);
     }
 }
 /** 去掉 `[tiab]` 一类字段标签与通配符，保留引号短语与布尔词。 */

package/lib/search/rate-limit.js

@@ -11,7 +11,7 @@
  * - 连续成功若干次后间隔逐步回落；超时 / 临时网络故障也重试一次。
  * - 诊断探活（bypassCooldown）忽略冷却，429 仍按原始错误返回，便于定位。
  */
-import { DEFAULT_ARXIV_INTERVAL_MS, DEFAULT_PUBMED_INTERVAL_MS, DEFAULT_S2_INTERVAL_MS, getSettings, } from './config.js';
+import { DEFAULT_ARXIV_INTERVAL_MS, DEFAULT_PUBMED_INTERVAL_MS, DEFAULT_S2_INTERVAL_MS, DEFAULT_SERPAPI_INTERVAL_MS, getSettings, } from './config.js';
 import { SearchError } from './errors.js';
 import { cooldownUntil, recordSourceCooldown, recordSourceError, recordSourceOk, } from './health.js';
 import { fetchJson, fetchText } from './http.js';
@@ -23,6 +23,7 @@ const BASE_INTERVALS = {
     semanticscholar: DEFAULT_S2_INTERVAL_MS,
     arxiv: DEFAULT_ARXIV_INTERVAL_MS,
     pubtator: 350,
+    googlescholar: DEFAULT_SERPAPI_INTERVAL_MS,
 };
 /** 429 未带 Retry-After 时的冷却时长（原为 30s，过久会拖垮多检索式任务）。 */
 const COOLDOWN_FALLBACK_MS = 10_000;

package/lib/search/types.d.ts

@@ -3,13 +3,20 @@
  *
  * 本文件同时被 Host 与 Client 引用，因此不得引入任何 Node 内置模块。
  */
-/** 已接入的免费数据源 id；顺序即聚合展示顺序。 */
-export declare const SOURCE_IDS: readonly ["pubmed", "europepmc", "openalex", "crossref", "semanticscholar", "arxiv", "pubtator"];
+/**
+ * 已接入的数据源 id；顺序即聚合展示顺序。
+ *
+ * 除 `googlescholar` 外均为免费公开 API；`googlescholar` 依赖用户自备的
+ * SerpAPI Key，未配置时默认不参与检索。
+ */
+export declare const SOURCE_IDS: readonly ["pubmed", "europepmc", "openalex", "crossref", "semanticscholar", "arxiv", "pubtator", "googlescholar"];
 export type SourceId = (typeof SOURCE_IDS)[number];
 /** 排序方式。 */
 export type SortMode = 'relevance' | 'citations' | 'year';
-/** 语言筛选。 */
-export type TaskLanguage = 'any' | 'eng' | 'chi';
+/** 语言筛选；取值沿用 PubMed 的三字母语言码。 */
+export type TaskLanguage = 'any' | 'eng' | 'chi' | 'jpn' | 'kor' | 'fre' | 'ger' | 'spa' | 'rus' | 'ita' | 'por';
+/** 语言候选项；顺序即下拉与胶囊的展示顺序。 */
+export declare const TASK_LANGUAGES: readonly TaskLanguage[];
 /** 论文的持久标识集合（裸值，不带 URL 前缀）。 */
 export interface PaperIds {
     doi: string;
@@ -101,6 +108,7 @@ export interface ProviderSearchOptions {
     /** 可选密钥；provider 只用于请求参数/请求头，不得写日志。 */
     ncbiApiKey?: string;
     s2ApiKey?: string;
+    serpApiKey?: string;
 }
 export interface Provider {
     info: ProviderInfo;
@@ -222,7 +230,6 @@ export interface SearchTask {
     conditions: TaskConditions;
     status: TaskStatus;
     origin: TaskOrigin;
-    sessionId?: string;
     fromTaskId?: string;
     /** 每次状态/条件变化自增。 */
     rev: number;
@@ -234,6 +241,8 @@ export interface SearchTask {
     /** 任务级研究笔记。 */
     notes: string;
     groups: TaskGroup[];
+    /** 关联的会话工作目录；PDF 默认下载到其下的 dsh-litsearch/。 */
+    workspace?: string;
     progress?: TaskProgress;
     stats: TaskStats;
     result: TaskResult;
@@ -336,7 +345,9 @@ export interface TaskStatsReport {
     byYear: YearStat[];
     byType: CountEntry[];
     byLanguage: CountEntry[];
+    /** 出现过的出处，按命中数降序；筛选项直接用这份清单（最多 500 条）。 */
     topVenues: CountEntry[];
+    /** 出现过的作者，按命中数降序；筛选项直接用这份清单（最多 500 条）。 */
     topAuthors: CountEntry[];
     metrics: {
         oaRate: number;
@@ -512,11 +523,21 @@ export interface ProbeResult {
     error?: string;
     cooldownUntil?: string;
 }
+/** 客户端需要打开/聚焦的任务（模型刚在当前任务里发起了一轮检索）。 */
+export interface TaskFocus {
+    taskId: string;
+    title: string;
+    /** 请求时间（epoch ms）；客户端据此丢弃过期的聚焦请求。 */
+    at: number;
+    /** 发起检索的会话；客户端只在该会话可见时打开，避免抢占其他对话的面板。 */
+    sessionId?: string;
+}
 /** `/events` 的响应；`reset` 表示客户端的 sinceRev 比服务端新（宿主重启）。 */
 export interface EventsPage {
     rev: number;
     reset: boolean;
     tasks: TaskSummary[];
+    focus?: TaskFocus;
 }
 /** `/health` 的响应：数据源能力 + 客户端需要的默认设置（不含密钥）。 */
 export interface HealthInfo {
@@ -528,6 +549,7 @@ export interface HealthInfo {
     keys: {
         ncbi: boolean;
         s2: boolean;
+        serpapi: boolean;
     };
     settings: {
         defaultSources: SourceId[];

package/lib/search/types.js

@@ -3,7 +3,12 @@
  *
  * 本文件同时被 Host 与 Client 引用，因此不得引入任何 Node 内置模块。
  */
-/** 已接入的免费数据源 id；顺序即聚合展示顺序。 */
+/**
+ * 已接入的数据源 id；顺序即聚合展示顺序。
+ *
+ * 除 `googlescholar` 外均为免费公开 API；`googlescholar` 依赖用户自备的
+ * SerpAPI Key，未配置时默认不参与检索。
+ */
 export const SOURCE_IDS = [
     'pubmed',
     'europepmc',
@@ -12,4 +17,19 @@ export const SOURCE_IDS = [
     'semanticscholar',
     'arxiv',
     'pubtator',
+    'googlescholar',
+];
+/** 语言候选项；顺序即下拉与胶囊的展示顺序。 */
+export const TASK_LANGUAGES = [
+    'any',
+    'eng',
+    'chi',
+    'jpn',
+    'kor',
+    'fre',
+    'ger',
+    'spa',
+    'rus',
+    'ita',
+    'por',
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-litsearch",
-  "version": "0.1.0",
+  "version": "0.3.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",