dsh-cite 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 [历史英文记录](docs/CHANGELOG.en.md)
 
+## 0.4.2 (2026-10-05)
+
+- 保留 DOI 内合法的成对括号，正确剥除正文外层标点；Crossref 响应读取也受取消与超时控制。
+
+## 0.4.1 (2026-10-03)
+
+- 修复含多个出版社名称的 BibTeX 导出后再导入失败，保留出版社名称及原始来源。41 项 Windows 测试与真实下载文件的再导入通过。
+
 ## 0.4.0 (2026-10-03)
 
 - 新增中文 / English 文献工作台和 `cite_batch`：DOI / BibTeX 批量导入、本地预览、选择保存、搜索及格式切换。原有五个工具保留。

package/README.en.md

@@ -2,9 +2,11 @@
 
 [中文](README.md)
 
+![dsh-cite whale girl plugin cover](https://raw.githubusercontent.com/STARDUSTLC666/dsh-cite/master/assets/cover-whale-girl.png)
+
 Organize DOI lists or BibTeX into a reviewable local library, then export references and BibTeX.
 
-[![npm](https://img.shields.io/npm/v/dsh-cite)](https://www.npmjs.com/package/dsh-cite) [![downloads](https://img.shields.io/npm/dm/dsh-cite)](https://www.npmjs.com/package/dsh-cite)
+[![npm](https://img.shields.io/npm/v/dsh-cite)](https://www.npmjs.com/package/dsh-cite) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-cite-downloads.svg)](https://www.npmjs.com/package/dsh-cite)
 
 ## What it does
 

package/README.md

@@ -2,9 +2,11 @@
 
 [English](README.en.md)
 
+![dsh-cite 鲸鱼娘插件封面](https://raw.githubusercontent.com/STARDUSTLC666/dsh-cite/master/assets/cover-whale-girl.png)
+
 把 DOI 列表或 BibTeX 整理成可核对的本地文献库，再导出参考文献与 BibTeX。
 
-[![npm](https://img.shields.io/npm/v/dsh-cite)](https://www.npmjs.com/package/dsh-cite) [![downloads](https://img.shields.io/npm/dm/dsh-cite)](https://www.npmjs.com/package/dsh-cite)
+[![npm](https://img.shields.io/npm/v/dsh-cite)](https://www.npmjs.com/package/dsh-cite) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-cite-downloads.svg)](https://www.npmjs.com/package/dsh-cite)
 
 ## 功能
 

package/docs/CHANGELOG.en.md

@@ -4,6 +4,14 @@
 
 These English notes preserve the earlier translations. The main changelog contains the consolidated version history.
 
+## 0.4.2 (2026-10-05)
+
+- Preserve balanced parentheses inside DOIs while removing surrounding prose punctuation. Crossref response parsing respects cancellation and timeouts.
+
+## 0.4.1 (2026-10-03)
+
+Fixes re-importing exported BibTeX containing publisher lists. Publisher names and original sources remain intact. All 41 Windows tests and re-importing the actual browser download pass.
+
 ## 0.4.0 (2026-10-03)
 
 Adds a Chinese / English citation workbench and `cite_batch` for offline DOI / BibTeX preview, selective import, duplicate review, search and basic citation exports. Explicit Crossref enrichment fills empty fields, retains local differences and supports progress, cancellation and retry. Original input is preserved in full backups; revision checks protect concurrent changes. The existing five tools remain available.

package/docs/USAGE.en.md

@@ -2,6 +2,10 @@
 
 [Overview](../README.en.md) · [Changelog](../CHANGELOG.md) · [Validation](VALIDATION.md)
 
+## Current improvements
+
+DOIs with balanced parentheses can be queried directly. Transport or parsing timeouts are explicit, and cancellation stops waiting. Offline library import and external Crossref lookup are verified separately.
+
 ## Citation workbench
 
 1. Open **Settings → Cite**. Paste one DOI per line, paste BibTeX, or upload a `.bib` file.

package/docs/USAGE.md

@@ -2,6 +2,10 @@
 
 [返回简介](../README.md) · [更新记录](../CHANGELOG.md) · [验证记录](VALIDATION.md)
 
+## 本次改进
+
+可直接查询带成对括号的 DOI。网络或响应读取超时会给出明确错误；取消后不继续等待。文献库离线导入与外部 Crossref 检索分别验收。
+
 ## 文献工作台
 
 1. 打开「设置 → Cite」，选择 DOI 列表或 BibTeX。DOI 每行一条，也可上传 `.bib` 文件。

package/docs/VALIDATION.md

@@ -2,9 +2,9 @@
 
 本页整理原 README 的历史验证说明，保留当时的版本、日期与范围。自动测试、启动检查、浏览器操作和真实服务验收分别记录，不能相互替代。更详细的版本验收文件仍保留在仓库中。
 
-## 0.4.0（2026-10-03）
+## 0.4.1（含 0.4.0 功能，2026-10-03）
 
-- Windows：40 项自动测试全部通过，无跳过。覆盖嵌套 BibTeX、宏、机构作者、复合姓氏、畸形输入、容量边界、精确与候选重复、并发修订冲突、部分失败重试、取消不写入、元数据差异保留和英文错误信息。
+- Windows：41 项自动测试全部通过，无跳过。覆盖嵌套 BibTeX、宏、机构作者、复合姓氏、出版社列表的导出再导入、畸形输入、容量边界、精确与候选重复、并发修订冲突、部分失败重试、取消不写入、元数据差异保留和英文错误信息。
 - 宿主契约：官方源码构建的 RC2（639ed015）和公开 npm 包 `0.2.1-alpha.1` 均在 E 盘隔离环境测试；18 插件共同注册 110 工具、35 技能，19 输出样例通过 schema 检查。未配置真实账号的健康检查可返回未配置，这不表示真实服务连接通过。
 - 可见浏览器操作：官方 alpha 的设置页中实际上传 `.bib`、本地预览、选择保存、关闭 / 重开设置保留输入、搜索、引文预览及三种下载。DOI 大小写与链接形式的重复被跳过，错误行不可保存。中英文切换使用同一份两条题录的文献库，修订与原始资料未改变；390px 布局另作可见检查。
 - 真实 Crossref：显式查询 `10.1038/nature12345`，作者、年份等空字段已补全；本地测试标题被保留，实际提供者标题作为差异显示。曾出现网络请求失败，重试后成功；不把网络波动当作已定位或修复的代理问题。没有 DOI 的条目显示单独失败。

package/lib/citation-errors.js

@@ -1,5 +1,7 @@
 /** English UI messages; bibliographic content and original source text stay unchanged. */
 export function englishCitationError(raw) {
+    if (/^Crossref.*超时/.test(raw))
+        return 'Crossref timed out. Retry later; your local entries were preserved.';
     if (/^Crossref 请求失败：/.test(raw))
         return raw.replace(/^Crossref 请求失败：/, 'Crossref request failed: ');
     if (/^DOI 在 Crossref 中不存在：/.test(raw))

package/lib/citation-worker.js

@@ -2,13 +2,16 @@ import { parentPort, workerData } from 'node:worker_threads';
 import { Cite } from '@citation-js/core';
 import '@citation-js/plugin-bibtex';
 import { assertDoi } from './crossref.js';
-import { MAX_BATCH, normalizeWork, workWarnings } from './citation-model.js';
+import { MAX_BATCH, normalizeWork, plainText, workWarnings } from './citation-model.js';
 const types = { 'article-journal': 'journal-article', book: 'book', chapter: 'book-chapter', 'paper-conference': 'proceedings-article', thesis: 'dissertation', report: 'report', dataset: 'dataset', patent: 'patent', standard: 'standard' };
+// Citation.js treats BibTeX's publisher "and" separator as a list. The local
+// Work model is plain text; preserve these names and retain the original source.
+const cslText = (value) => Array.isArray(value) ? value.map(plainText).join(' and ') : plainText(value);
 function workOf(csl) {
     return normalizeWork({
         doi: csl.DOI, type: types[csl.type] || 'other', title: csl.title,
         authors: (csl.author || []).map(a => { const family = [a['non-dropping-particle'], a.family, a.suffix].filter(Boolean).join(' '); const given = [a.given, a['dropping-particle']].filter(Boolean).join(' '); return a.literal || !given ? { name: a.literal || family, family: '', given: '' } : { name: '', family, given }; }),
-        containerTitle: csl['container-title'], publisher: csl.publisher, year: Number(csl.issued?.['date-parts']?.[0]?.[0] || 0), language: csl.language, volume: csl.volume, issue: csl.issue, page: csl.page, url: csl.URL, isbn: csl.ISBN,
+        containerTitle: cslText(csl['container-title']), publisher: cslText(csl.publisher), year: Number(csl.issued?.['date-parts']?.[0]?.[0] || 0), language: csl.language, volume: csl.volume, issue: csl.issue, page: csl.page, url: csl.URL, isbn: csl.ISBN,
     });
 }
 try {

package/lib/crossref.js

@@ -67,19 +67,32 @@ function requestSignal(timeoutMs, signal) {
     const timeoutSignal = AbortSignal.timeout(timeoutMs);
     return signal === undefined ? timeoutSignal : AbortSignal.any([signal, timeoutSignal]);
 }
+function withAbort(value, signal) {
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(signal.reason);
+        signal.addEventListener('abort', abort, { once: true });
+        value.then(result => { signal.removeEventListener('abort', abort); resolve(result); }, error => { signal.removeEventListener('abort', abort); reject(error); });
+        if (signal.aborted)
+            abort();
+    });
+}
 /** 按 DOI 查询 Crossref 并归一化。 */
 export async function lookupDoi(doi, cfg, fetchImpl, signal) {
     const clean = assertDoi(doi);
+    signal?.throwIfAborted();
+    const deadline = requestSignal(cfg.timeoutMs, signal);
     const fetcher = fetchImpl ?? globalThis.fetch;
     let response;
     try {
-        response = await fetcher(CROSSREF_API + encodeURIComponent(clean), {
+        response = await withAbort(fetcher(CROSSREF_API + encodeURIComponent(clean), {
             headers: makeHeaders(cfg),
-            signal: requestSignal(cfg.timeoutMs, signal),
-        });
+            signal: deadline,
+        }), deadline);
     }
     catch (error) {
         signal?.throwIfAborted();
+        if (deadline.aborted)
+            throw new Error('Crossref 请求超时，请稍后重试；本地文献已保留。');
         const code = error instanceof Error && typeof error.cause?.code === 'string' && /^[A-Z0-9_]+$/.test(error.cause.code) ? ' (' + error.cause.code + ')' : '';
         throw new Error('Crossref 请求失败：' + (error instanceof Error ? error.message : String(error)) + code);
     }
@@ -90,9 +103,12 @@ export async function lookupDoi(doi, cfg, fetchImpl, signal) {
     }
     let payload;
     try {
-        payload = await response.json();
+        payload = await withAbort(response.json(), deadline);
     }
     catch {
+        signal?.throwIfAborted();
+        if (deadline.aborted)
+            throw new Error('Crossref 响应读取超时，请稍后重试；本地文献已保留。');
         throw new Error('Crossref 响应不是合法 JSON。');
     }
     const message = record(payload).message;
@@ -106,28 +122,35 @@ export async function lookupDoi(doi, cfg, fetchImpl, signal) {
 /** 按题录文本检索 Crossref，返回归一化结果。 */
 export async function searchWorks(query, limit, cfg, fetchImpl, signal) {
     const q = query.trim();
+    signal?.throwIfAborted();
+    const deadline = requestSignal(cfg.timeoutMs, signal);
     if (q === '')
         throw new Error('检索词不能为空。');
     const url = CROSSREF_API + '?query.bibliographic=' + encodeURIComponent(q) + '&rows=' + String(limit);
     const fetcher = fetchImpl ?? globalThis.fetch;
     let response;
     try {
-        response = await fetcher(url, {
+        response = await withAbort(fetcher(url, {
             headers: makeHeaders(cfg),
-            signal: requestSignal(cfg.timeoutMs, signal),
-        });
+            signal: deadline,
+        }), deadline);
     }
     catch (error) {
         signal?.throwIfAborted();
+        if (deadline.aborted)
+            throw new Error('Crossref 请求超时，请稍后重试；本地文献已保留。');
         throw new Error('Crossref 检索失败：' + (error instanceof Error ? error.message : String(error)));
     }
     if (!response.ok)
         throw new Error('Crossref 返回 HTTP ' + response.status + '，无法完成检索。');
     let payload;
     try {
-        payload = await response.json();
+        payload = await withAbort(response.json(), deadline);
     }
     catch {
+        signal?.throwIfAborted();
+        if (deadline.aborted)
+            throw new Error('Crossref 响应读取超时，请稍后重试；本地文献已保留。');
         throw new Error('Crossref 响应不是合法 JSON。');
     }
     const items = record(payload).message;
@@ -142,7 +165,9 @@ export function extractDois(text) {
     const seen = new Set();
     const result = [];
     for (const match of text.match(pattern) ?? []) {
-        const clean = match.replace(/[.,;:)\]}'">]+$/, '').trim();
+        let clean = match.replace(/[.,;:\]}'">]+$/, '').trim();
+        while (clean.endsWith(')') && (clean.match(/\)/g)?.length ?? 0) > (clean.match(/\(/g)?.length ?? 0))
+            clean = clean.slice(0, -1);
         if (seen.has(clean.toLowerCase()))
             continue;
         seen.add(clean.toLowerCase());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cite",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "批量导入 DOI / BibTeX，预览去重、补全文献元数据并导出引文。",
   "type": "module",
   "main": "lib/index.js",
@@ -29,7 +29,12 @@
     "prepublishOnly": "pnpm run build"
   },
   "dsh": {
-    "client": { "inject": ["@deepseek-ai/dsh-client-ui-settings"], "platform": "web" },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    },
     "bundle": {
       "patch": "./cordis.patch.yml"
     }