dsh-cite 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 [历史英文记录](docs/CHANGELOG.en.md)
 
+## 0.5.0（2026-10-17）
+
+- 设置面板顶部新增「首次使用」分步引导：一次只讲一步，支持上一步/下一步/跳过，看完记在本机不再出现。
+- 引导内容与该插件的实际用法一致；可在开发者工具里清掉 `dsh-first-run:dsh-cite:v1` 重新查看。
+## 0.4.2 (2026-10-05)
+
+- 保留 DOI 内合法的成对括号，正确剥除正文外层标点；Crossref 响应读取也受取消与超时控制。
+
 ## 0.4.1 (2026-10-03)
 
 - 修复含多个出版社名称的 BibTeX 导出后再导入失败，保留出版社名称及原始来源。41 项 Windows 测试与真实下载文件的再导入通过。

package/README.en.md

@@ -2,9 +2,13 @@
 
 [中文](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)
+
+Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-cite/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-cite/pulls).
 
 ## What it does
 

package/README.md

@@ -2,9 +2,13 @@
 
 [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)
+
+欢迎使用，遇到问题或有改进建议，请提交 [issues](https://github.com/STARDUSTLC666/dsh-cite/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-cite/pulls)。
 
 ## 功能
 

package/docs/CHANGELOG.en.md

@@ -4,6 +4,10 @@
 
 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.

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/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/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.1",
+  "version": "0.5.0",
   "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"
     }